docs(sl): translate wiki batch 1 — 7 core pages
- mother-hive (matični hive): forced-command SSH, single home,
peer auth, key-on-seed, daemon user
- task-board (tabla opravil): capability scoring, cron/interval/once,
intake drain, SQLite backing
- operator-attention (operaterska pozornost): attention bar,
jump/filter keys, edge-triggered alerts, NO_COLOR pitfall
- contracts (JSON pogodbe): stable schemas, golden tests,
evolution rules
- cost-model (model stroškov): cache-hit metering, fast/smart/max,
T14 compaction, DeepSeek probe
- layered-soul (plastovita duša): import path, deferred stores,
one-way direction
- index (wiki kazalo): conventions, lint workflow, full page table
Commands/JSON/code paths kept in English; prose + frontmatter
translated.
2026-06-26 10:52:57 +02:00
---
title: Colibri Wiki
2026-06-26 12:04:37 +02:00
description: "Zbirka znanja o odločitvah in arhitekturi Colibri — utemeljitve, ki jih koda ne more izraziti."
docs(sl): translate wiki batch 1 — 7 core pages
- mother-hive (matični hive): forced-command SSH, single home,
peer auth, key-on-seed, daemon user
- task-board (tabla opravil): capability scoring, cron/interval/once,
intake drain, SQLite backing
- operator-attention (operaterska pozornost): attention bar,
jump/filter keys, edge-triggered alerts, NO_COLOR pitfall
- contracts (JSON pogodbe): stable schemas, golden tests,
evolution rules
- cost-model (model stroškov): cache-hit metering, fast/smart/max,
T14 compaction, DeepSeek probe
- layered-soul (plastovita duša): import path, deferred stores,
one-way direction
- index (wiki kazalo): conventions, lint workflow, full page table
Commands/JSON/code paths kept in English; prose + frontmatter
translated.
2026-06-26 10:52:57 +02:00
---
Zbirka znanja o Colibrijevih **odločitvah in arhitekturi** — po vzoru
[vzorca LLM Wiki ](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f )
Andreja Karpathyja.
Vsak večji podsistem ima stran, ki beleži **zakaj** je bil zgrajen tako, kot
je — utemeljitve, ki jih koda ne more izraziti. Izvedbena dokumentacija v
`docs/` pokriva _kako_ ; te strani pokrivajo _zakaj_ .
## Zakaj to obstaja
Zastarele odločitve se kopičijo hitreje, kot jih kdorkoli ročno pregleda:
preimenovanje, ki je bilo samo napol uporabljeno, dokument, ki še vedno
opisuje staro zasnovo, privzetek, ki je ostal od presežene izbire. Več
nedavnih prehodov je bilo porabljenih prav za iskanje tega (`pi → zot` ,
`usb_nodes → hive_nodes` , podedovano preimenovanje v `sample` ). Ta wiki naredi
knjigovodstvo skoraj brezstroškovno: eno mesto, ki beleži _kaj je bilo
odločeno_, povezuje na _kje v kodi živi_ in ga je mogoče **lintati** za odmik.
## Konvencije (shema)
Ta pravila ohranjajo wiki kot vzdržljiv artefakt, ne kot drugi vir resnice:
1. **Koda je vir resnice.** Strani opisujejo _odločitve_ in _kje_ živijo;
povezujejo na kodo/dokumentacijo, namesto da bi ponovno razlagale izvedbo.
Ko je odločitev dostavljena, skrči stran na "kako deluje + povezava."
2. **Povezuj, ne podvajaj.** Sklicevanje na kodo kot `pot/do/datoteke.rs:vrstica`
in druge wiki strani z relativnimi povezavami (`[oznaka](./stran.md)` ) —
klikljivo v Forgeju, ustreznik Obsidianovih `[[wikipovezav]]` , prilagojen
repozitoriju.
3. **Ena odločitev na stran** , kjer je to izvedljivo; obilno navzkrižno
povezuj.
4. **Označi, ne tiho prepiši.** Ko nova koda nasprotuje strani, zabeleži
nasprotje (in ga razreši), namesto da bi tiho urejal zgodovino.
5. **Lintaj, ne zaupaj.** Stran je trditev, ki jo je treba preveriti proti
kodi, ne jamstvo.
## Potek dela za lint
Skripta [`wiki-lint` ](../../scripts/wiki-lint ) preveri vsako stran proti
trenutni kodi: viseče reference, obujena stara imena (iz imenika poimenovanj)
in osirotele strani. Teče kot del `ci-checks.sh --strict` in je zapahnjena s
kljuko pred potiskom — napaka odmika blokira potisk, enako kot opozorilo
clippy.
## Strani
| Stran | Kaj pokriva |
| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
refactor: kill→stop across API surface, CLI, TUI, and docs
Clean sweep — no kill on the Colibri wire protocol, CLI surface,
TUI keybinding, or documentation. Backward-compat aliases removed;
daemon and client deploy together so no transitional period needed.
Wire: KillAgent→StopAgent, "kill-agent"→"stop-agent" (no alias)
CLI: colibri kill→stop, Command::KillAgent→StopAgent
Lib: client.kill_agent()→stop_agent()
TUI: kill_selected()→stop_selected(), "kill"→"stop" label
Docs: spawn/kill→spawn/stop, kill-agent→stop-agent (40+ instances)
Retained kill only where it belongs:
- child.kill() / handle.kill() (OS SIGKILL)
- Unix kill(1) in sigterm tests
- OOM kill, process-group kill comments (kernel mechanism)
2026-06-26 14:38:53 +02:00
| [agent-harness ](./agent-harness.md ) | Razcep zot (agent) + Colibri (krmilna ravnina); vprega, samodejni zagon + gonilnik RPC |
docs(sl): translate wiki batch 1 — 7 core pages
- mother-hive (matični hive): forced-command SSH, single home,
peer auth, key-on-seed, daemon user
- task-board (tabla opravil): capability scoring, cron/interval/once,
intake drain, SQLite backing
- operator-attention (operaterska pozornost): attention bar,
jump/filter keys, edge-triggered alerts, NO_COLOR pitfall
- contracts (JSON pogodbe): stable schemas, golden tests,
evolution rules
- cost-model (model stroškov): cache-hit metering, fast/smart/max,
T14 compaction, DeepSeek probe
- layered-soul (plastovita duša): import path, deferred stores,
one-way direction
- index (wiki kazalo): conventions, lint workflow, full page table
Commands/JSON/code paths kept in English; prose + frontmatter
translated.
2026-06-26 10:52:57 +02:00
| [agent-events-reference ](./agent-events-reference.md ) | Referenca dogodkov zot po opremi, preslikave Glasspane in preverjena polja prepisa |
| [cost-model ](./cost-model.md ) | Bajtno stabilne predpone, merjenje zadetkov predpomnilnika, samodejno stopnjevanje, stiskanje T14 |
| [glasspane ](./glasspane.md ) | Avtomat stanj agenta, pretakanje JSONL, taksonomija AgentRuntime, API posnetkov |
| [operator-attention ](./operator-attention.md ) | Izpeljan pogled "potrebuje operaterja": predikat pozornosti, vrstica/skok/filter TUI, robno sprožena terminalska opozorila |
| [headroom-sidecar ](./headroom-sidecar.md ) | Neobvezni stranski vagon za stiskanje rezultatov orodij in njegov protokol Unix vtičnice |
| [jail-confinement ](./jail-confinement.md ) | Trajne proti prehodnim ječam, pravilnik načina priv, ponovna uporaba omejitve zaganjalnika za strežnike MCP |
| [mother-hive ](./mother-hive.md ) | Arhitektura matičnega MCP — SSH s prisiljenim ukazom, enojni-dom-v-colibri, peer avtentikacija, ključ-na-semenu |
| [naming-decisions ](./naming-decisions.md ) | Imenik preimenovanj, nevtralnih glede na opremo / arhitekturnih — dostavljenih in v teku |
2026-06-26 15:18:14 +02:00
| [daemon-not-demon ](./daemon-not-demon.md ) | Zakaj rečemo daemon (duh pomočnik) in ne demon (hudič) — angleško + slovensko |
docs(sl): translate wiki batch 1 — 7 core pages
- mother-hive (matični hive): forced-command SSH, single home,
peer auth, key-on-seed, daemon user
- task-board (tabla opravil): capability scoring, cron/interval/once,
intake drain, SQLite backing
- operator-attention (operaterska pozornost): attention bar,
jump/filter keys, edge-triggered alerts, NO_COLOR pitfall
- contracts (JSON pogodbe): stable schemas, golden tests,
evolution rules
- cost-model (model stroškov): cache-hit metering, fast/smart/max,
T14 compaction, DeepSeek probe
- layered-soul (plastovita duša): import path, deferred stores,
one-way direction
- index (wiki kazalo): conventions, lint workflow, full page table
Commands/JSON/code paths kept in English; prose + frontmatter
translated.
2026-06-26 10:52:57 +02:00
| [layered-soul ](./layered-soul.md ) | Kako Colibri danes uporablja repozitorij pregledanega konteksta layered-soul proti načrtovanemu |
| [task-board ](./task-board.md ) | Točkovanje po zmožnostih, cron razporejanje, praznjenje vnosne vrste, podlaga SQLite |
refactor: kill→stop across API surface, CLI, TUI, and docs
Clean sweep — no kill on the Colibri wire protocol, CLI surface,
TUI keybinding, or documentation. Backward-compat aliases removed;
daemon and client deploy together so no transitional period needed.
Wire: KillAgent→StopAgent, "kill-agent"→"stop-agent" (no alias)
CLI: colibri kill→stop, Command::KillAgent→StopAgent
Lib: client.kill_agent()→stop_agent()
TUI: kill_selected()→stop_selected(), "kill"→"stop" label
Docs: spawn/kill→spawn/stop, kill-agent→stop-agent (40+ instances)
Retained kill only where it belongs:
- child.kill() / handle.kill() (OS SIGKILL)
- Unix kill(1) in sigterm tests
- OOM kill, process-group kill comments (kernel mechanism)
2026-06-26 14:38:53 +02:00
| [quality-gates ](./quality-gates.md ) | `ci-checks.sh` kot preverjanje pred združitvijo; zakaj je odmik prej dosegel `main` |
docs(sl): translate wiki batch 1 — 7 core pages
- mother-hive (matični hive): forced-command SSH, single home,
peer auth, key-on-seed, daemon user
- task-board (tabla opravil): capability scoring, cron/interval/once,
intake drain, SQLite backing
- operator-attention (operaterska pozornost): attention bar,
jump/filter keys, edge-triggered alerts, NO_COLOR pitfall
- contracts (JSON pogodbe): stable schemas, golden tests,
evolution rules
- cost-model (model stroškov): cache-hit metering, fast/smart/max,
T14 compaction, DeepSeek probe
- layered-soul (plastovita duša): import path, deferred stores,
one-way direction
- index (wiki kazalo): conventions, lint workflow, full page table
Commands/JSON/code paths kept in English; prose + frontmatter
translated.
2026-06-26 10:52:57 +02:00
| [contracts ](./contracts.md ) | Stabilne JSON sheme (run-manifest, runtime-inventory, provider-smoke), zlati testi |
| [store-schema ](./store-schema.md ) | Usklajevalna shema SQLite in disciplina migracij |
refactor: kill→stop across API surface, CLI, TUI, and docs
Clean sweep — no kill on the Colibri wire protocol, CLI surface,
TUI keybinding, or documentation. Backward-compat aliases removed;
daemon and client deploy together so no transitional period needed.
Wire: KillAgent→StopAgent, "kill-agent"→"stop-agent" (no alias)
CLI: colibri kill→stop, Command::KillAgent→StopAgent
Lib: client.kill_agent()→stop_agent()
TUI: kill_selected()→stop_selected(), "kill"→"stop" label
Docs: spawn/kill→spawn/stop, kill-agent→stop-agent (40+ instances)
Retained kill only where it belongs:
- child.kill() / handle.kill() (OS SIGKILL)
- Unix kill(1) in sigterm tests
- OOM kill, process-group kill comments (kernel mechanism)
2026-06-26 14:38:53 +02:00
| [external-mcp ](./external-mcp.md ) | Most MCP za urejevalnike + zunanji gostitelj stdio MCP; dovoljenja za branje/pisanje/zunanji-klic |
2026-06-26 17:32:03 +02:00
| [operator-cli ](./operator-cli.md ) | CLI `colibri` kot tanek tipiziran odjemalec Unix vtičnice prek API procesa v ozadju |
docs(sl): translate wiki batch 1 — 7 core pages
- mother-hive (matični hive): forced-command SSH, single home,
peer auth, key-on-seed, daemon user
- task-board (tabla opravil): capability scoring, cron/interval/once,
intake drain, SQLite backing
- operator-attention (operaterska pozornost): attention bar,
jump/filter keys, edge-triggered alerts, NO_COLOR pitfall
- contracts (JSON pogodbe): stable schemas, golden tests,
evolution rules
- cost-model (model stroškov): cache-hit metering, fast/smart/max,
T14 compaction, DeepSeek probe
- layered-soul (plastovita duša): import path, deferred stores,
one-way direction
- index (wiki kazalo): conventions, lint workflow, full page table
Commands/JSON/code paths kept in English; prose + frontmatter
translated.
2026-06-26 10:52:57 +02:00
| [tui ](./tui.md ) | Odjemalec terminalske nadzorne plošče (colibri-tui) proti avtomatu stanj colibri-glasspane |
| [terminal ](./terminal.md ) | Odločitev o terminalski zmožnosti (Kitty, razširjeno poročanje tipk, prehod tmux, SSH terminfo) |
| [runtime-inventory ](./runtime-inventory.md ) | Popis izvajalnega okolja gostitelja + bralnik statusa čuvaja; aditivne, bralne integracije |
| [skills-catalog ](./skills-catalog.md ) | Bralni izvajalni porabnik za pregledane artefakte veščin Clawdie-AI |
| [vault-provision ](./vault-provision.md ) | Oskrba datotek env, gnana z Vaultwarden, v ječe po zagonu agenta |
| [deployment ](./deployment.md ) | Nameščevalnik gostitelja (clawdie): postavitev ZFS, storitev rc.d/systemd, varnost suhega teka |
