docs(sl): add 23 Slovenian terminology mappings to glossary
Some checks are pending
CI / rust (pull_request) Waiting to run
CI / markdown (pull_request) Waiting to run
CI / port (pull_request) Waiting to run
CI / agent-jail-pkgs (pull_request) Waiting to run

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).
This commit is contained in:
Sam & Claude 2026-06-26 11:19:00 +02:00
parent 49c69537ae
commit 4edf01de25

View file

@ -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.