From 4edf01de25f45fb263a07c512e87d38cdbbceda6 Mon Sep 17 00:00:00 2001 From: Sam & Claude Date: Fri, 26 Jun 2026 11:19:00 +0200 Subject: [PATCH] docs(sl): add 23 Slovenian terminology mappings to glossary MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit New Izrazoslovje section — English concept → Slovenian name mapping: jail/ječa, warden/paznik, confinement/zaprtost, prisoner/zapornik, cell/celica, hive/panj, mother/matično vozlišče, node/vozlišče, glasspane/steklena plošča, spawn/(samodejni) zagon, seed/seme, vault/trezor, tenant/najemnik, skill/veščina, snapshot/posnetek, rollback/povratek, harvest/žetev, bridge/most, daemon/ozadnji proces, board/tabla nalog, scheduler/razporejevalnik, Bastille (trdnjava), jailed/zaprt v ječi. Cross-links added from existing ZFS, PF, and UI entries. Total anchors: 38 (15 abbreviations + 23 terminology). --- docs/guide/sl/reference/okrajsave.md | 148 ++++++++++++++++++++++++++- 1 file changed, 145 insertions(+), 3 deletions(-) diff --git a/docs/guide/sl/reference/okrajsave.md b/docs/guide/sl/reference/okrajsave.md index b0424e2..6afe7aa 100644 --- a/docs/guide/sl/reference/okrajsave.md +++ b/docs/guide/sl/reference/okrajsave.md @@ -50,7 +50,7 @@ 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. +naprav deli en javni IP. PF na FreeBSD samodejno nastavi NAT za [ječe](#jail). ## PF @@ -72,7 +72,8 @@ vratih TCP. ## UI **User Interface** — uporabniški vmesnik, kar operater vidi na zaslonu. -Glasspane TUI je terminalski vmesnik za nadzor agentov. +Glasspane TUI je terminalski vmesnik za nadzor agentov. Glej tudi: +[glasspane](#glasspane). ## VPS @@ -84,4 +85,145 @@ VPS. **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. +podatkov. Clawdie zahteva ZFS za [ječe](#jail) 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 + +**Ozadnji proces** — program, ki teče v ozadju, brez neposrednega upravljanja. +Na FreeBSD jih upravlja `rc.d`. `colibri-daemon` je ozadnji proces, 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](#confinement), [warden](#warden), [prisoner](#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.