colibri/docs/guide/sl/reference/okrajsave.md

title	description
Slovarček okrajšav	Razlaga tehničnih okrajšav in žargona, ki se pojavljajo v dokumentaciji Clawdie.

Če naletite na neznano okrajšavo, je verjetno razložena tukaj. Seznam raste sproti — vsaka okrajšava, uporabljena v dokumentaciji, dobi svoj vnos.

ACL

Access Control List — seznam pravil, kdo sme dostopati do česa. V Tailscale ACL določa, kateri gostitelji smejo govoriti med sabo.

API

Application Programming Interface — programski vmesnik, nabor pravil, kako lahko dva programa komunicirata. Primer: Telegram Bot API.

BCP

Best Current Practice — najboljša trenutna praksa. BCP-47 je standard za jezikovne oznake (npr. sl za slovenščino, en za angleščino).

HTTPS

Hypertext Transfer Protocol Secure — varen spletni prenos, šifrirana različica HTTP. Vsa komunikacija z zunanjimi ponudniki teče prek HTTPS.

ISO

(disk image) — slika diska, datoteka, ki vsebuje celoten datotečni sistem, pripravljen za zapis na USB ali pogon. Clawdie ISO je zagonska slika FreeBSD.

JSON

JavaScript Object Notation — lahko berljiv zapis podatkov v obliki {"ključ": "vrednost"}. Krmilna ravnina Colibri uporablja JSON za vse ukaze.

JSONL

JSON Lines — ena vrstica = en JSON zapis. Uporablja se za dnevnike dogodkov — vsak dogodek je svoja vrstica, ni treba brati cele datoteke naenkrat.

LLM

Large Language Model — veliki jezikovni model, umetna inteligenca, ki razume in tvori besedilo. Primeri: DeepSeek, Claude, GPT. Clawdie uporablja LLM za vse agentske odločitve.

NAT

Network Address Translation — prevajanje omrežnih naslovov; omogoča, da več naprav deli en javni IP. PF na FreeBSD samodejno nastavi NAT za ječe.

PF

Packet Filter — požarni zid operacijskega sistema FreeBSD. Filtrira omrežni promet po pravilih v /etc/pf.conf.

SHA

Secure Hash Algorithm — varen zgoščevalni algoritem; iz poljubnega besedila naredi kratek "prstni odtis" (zgostitev). SHA-256 pomeni 256-bitni izhod. Glasspane ga uporablja za primerjavo zaslonov.

TCP

Transmission Control Protocol — protokol za nadzor prenosa; zagotavlja zanesljiv prenos podatkov med gostitelji. Most krmilne ravnine posluša na vratih TCP.

UI

User Interface — uporabniški vmesnik, kar operater vidi na zaslonu. Glasspane TUI je terminalski vmesnik za nadzor agentov. Glej tudi: glasspane.

VPS

Virtual Private Server — navidezni zasebni strežnik, najeta navidezna naprava pri ponudniku oblaka. Slika "cloud" je namenjena postavitvam v slogu VPS.

ZFS

Zettabyte File System — napredni datotečni sistem, ki ga uporablja FreeBSD. Omogoča posnetke (snapshots), stiskanje in preverjanje celovitosti podatkov. Clawdie zahteva ZFS za ječe Bastille. Glej tudi:

Izrazoslovje — angleško-slovenski preslikovalnik

Tehnično izrazoslovje v kodi ostaja v angleščini (ukazi, poti, imena spremenljivk). Slovenski prevodi so mišljeni za branje in razumevanje dokumentacije, ne za pisanje kode.

Bastille

Orodje za upravljanje ječ na FreeBSD. Ime izhaja iz trdnjave Bastilja.

board (task board)

Tabla nalog — seznam nalog, ki čakajo na dodelitev agentom. Vsaka naloga ima zahtevane zmožnosti (capabilities) in jih razporejevalnik (scheduler) dodeli najprimernejšemu agentu.

bridge

Most — omrežni most, ki povezuje ječe z zunanjim svetom. warden0 je most, ki ga Bastille uporablja za omrežje ječ.

cell

Celica — posamezna enota znotraj ječe. Tanke (thin) celice si delijo predlogo, debele (thick) so samostojne.

confinement

Zaprtost — stopnja izolacije procesa. Ječa (jail) je najmočnejša oblika zaprtosti na FreeBSD: proces ne vidi gostitelja, nima dostopa do omrežja (glede na nastavitve) in ne more pobegniti.

daemon

Proces v ozadju — program, ki teče v ozadju, brez neposrednega upravljanja. Na FreeBSD jih upravlja rc.d. colibri-daemon je proces v ozadju, ki nadzoruje agente.

glasspane

Steklena plošča / nadzorna plošča — Colibrijeva opazovalna plast. Spremlja agente prek JSONL in jih preslika v pet stanj: Idle → Working → Blocked → Done / Error.

harvest

Žetev — zajem podatkov o strojni opremi (clawdie-hw-probe). Pobrano (harvested) se pošlje matičnemu vozlišču (mother) prek MCP.

hive

Panj — vsa vozlišča, povezana z matičnim vozliščem. hive_nodes je tabela v PostgreSQL na matičnem vozlišču, ki beleži vsako vozlišče, njegovo strojno opremo in zmožnosti.

jail

Ječa — varnostni mehanizem FreeBSD za izolacijo procesov. Proces v ječi vidi le svoj datotečni sistem in omejeno omrežje. Clawdie uporablja ječe Bastille za izolacijo agentov in zunanjih MCP strežnikov. Glej tudi: confinement, warden, prisoner.

jailed

Zaprt v ječi — stanje procesa, ki teče znotraj ječe. Proces, ki je zaprt v ječi, nima dostopa do gostitelja. Nasprotje je na prostosti (teče na gostitelju brez izolacije).

mother (mother node)

Matično vozlišče — osrednji strežnik, ki vodi register vseh vozlišč (hive_nodes). USB-vozlišča se mu javijo prek MCP prek SSH. Matično vozlišče hrani PostgreSQL in dodeljuje naloge.

node

Vozlišče — katerikoli gostitelj, ki je del panja: USB-ključek, nameščen disk, VPS ali matično vozlišče samo. Vsako vozlišče ima node_type in se registrira prek node_register.

prisoner (prisoner process)

Zapornik / zaprt proces — proces, ki teče v ječi. Nima dostopa do gostiteljevega datotečnega sistema in omrežja (razen če mu je izrecno dovoljeno).

rollback

Povratek — vrnitev na prejšnje stanje. ZFS snapshots omogočajo povratek celotnega datotečnega sistema. bectl activate omogoča povratek na prejšnji zagonski posnetek.

scheduler

Razporejevalnik — del krmilne ravnine, ki vsakih ~30s preveri, katere naloge so na vrsti, in jih dodeli najprimernejšemu prostemu agentu.

seed (CLAWDIESEED)

Seme / semenski del — tretja rezina (slice) na USB-ključku, formatirana kot FAT32. Vsebuje skrivnosti (ključe, API žetone, gesla), ki jih uvoznik (clawdie-live-seed) ob zagonu namesti. Seme je ločeno od slike ISO — operater ga ureja po zapisu slike, pred zagonom.

skill

Veščina — paket zmožnosti, ki ga agent lahko naloži, da opravi določeno nalogo. Primer: jail-status (preveri stanje ječ), db-vacuum (počisti bazo). Veščine so v katalogu in jih uvaža import-colibri-skills.sh.

snapshot

Posnetek — trenutno stanje datotečnega sistema, shranjeno kot ZFS snapshot. Posnetki so osnova za povratek (rollback) in jih samodejno upravlja sanoid.

spawn (autospawn)

(Samodejni) zagon agenta — krmilna ravnina ob zagonu požene agenta (zot), če je omogočeno COLIBRI_AUTOSPAWN=YES. Agent dobi RPC poziv in začne z delom.

tenant

Najemnik — večnajemniška enota. Vsak najemnik ima svoje okolje, skrivnosti in naloge. Krmilna ravnina podpira več najemnikov na enem vozlišču.

vault

Trezor / sef — varno hranjenje skrivnosti (gesla, API ključi, žetoni). Clawdie uporablja Vaultwarden (Bitwarden API) za upravljanje skrivnosti najemnikov.

warden

Paznik — upravljalec ječ. Na FreeBSD je to jail(8) ali warden0 (omrežni most ječ Bastille). Na matičnem vozlišču je to colibri-mcp-ssh, ki nadzoruje, kateri ukazi so dovoljeni čez SSH. Paznik je slovenski izraz za paznika v zaporu — čuva ječo in njene zapornike.