Sam & Claude
968534d528
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)
6.6 KiB
| title | description |
|---|---|
| Colibri Wiki | Zbirka znanja o odločitvah in arhitekturi Colibri — utemeljitve, ki jih koda ne more izraziti. |
Zbirka znanja o Colibrijevih odločitvah in arhitekturi — po vzoru vzorca LLM Wiki 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:
- 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."
- Povezuj, ne podvajaj. Sklicevanje na kodo kot
pot/do/datoteke.rs:vrsticain druge wiki strani z relativnimi povezavami ([oznaka](./stran.md)) — klikljivo v Forgeju, ustreznik Obsidianovih[[wikipovezav]], prilagojen repozitoriju. - Ena odločitev na stran, kjer je to izvedljivo; obilno navzkrižno povezuj.
- Označi, ne tiho prepiši. Ko nova koda nasprotuje strani, zabeleži nasprotje (in ga razreši), namesto da bi tiho urejal zgodovino.
- Lintaj, ne zaupaj. Stran je trditev, ki jo je treba preveriti proti kodi, ne jamstvo.
Potek dela za lint
Skripta 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 |
|---|---|
| agent-harness | Razcep zot (agent) + Colibri (krmilna ravnina); vprega, samodejni zagon + gonilnik RPC |
| agent-events-reference | Referenca dogodkov zot po opremi, preslikave Glasspane in preverjena polja prepisa |
| cost-model | Bajtno stabilne predpone, merjenje zadetkov predpomnilnika, samodejno stopnjevanje, stiskanje T14 |
| glasspane | Avtomat stanj agenta, pretakanje JSONL, taksonomija AgentRuntime, API posnetkov |
| operator-attention | Izpeljan pogled "potrebuje operaterja": predikat pozornosti, vrstica/skok/filter TUI, robno sprožena terminalska opozorila |
| headroom-sidecar | Neobvezni stranski vagon za stiskanje rezultatov orodij in njegov protokol Unix vtičnice |
| jail-confinement | Trajne proti prehodnim ječam, pravilnik načina priv, ponovna uporaba omejitve zaganjalnika za strežnike MCP |
| mother-hive | Arhitektura matičnega MCP — SSH s prisiljenim ukazom, enojni-dom-v-colibri, peer avtentikacija, ključ-na-semenu |
| naming-decisions | Imenik preimenovanj, nevtralnih glede na opremo / arhitekturnih — dostavljenih in v teku |
| layered-soul | Kako Colibri danes uporablja repozitorij pregledanega konteksta layered-soul proti načrtovanemu |
| task-board | Točkovanje po zmožnostih, cron razporejanje, praznjenje vnosne vrste, podlaga SQLite |
| quality-gates | ci-checks.sh kot preverjanje pred združitvijo; zakaj je odmik prej dosegel main |
| contracts | Stabilne JSON sheme (run-manifest, runtime-inventory, provider-smoke), zlati testi |
| store-schema | Usklajevalna shema SQLite in disciplina migracij |
| external-mcp | Most MCP za urejevalnike + zunanji gostitelj stdio MCP; dovoljenja za branje/pisanje/zunanji-klic |
| operator-cli | CLI colibri kot tanek tipiziran odjemalec Unix vtičnice prek API ozadnjega procesa |
| tui | Odjemalec terminalske nadzorne plošče (colibri-tui) proti avtomatu stanj colibri-glasspane |
| terminal | Odločitev o terminalski zmožnosti (Kitty, razširjeno poročanje tipk, prehod tmux, SSH terminfo) |
| runtime-inventory | Popis izvajalnega okolja gostitelja + bralnik statusa čuvaja; aditivne, bralne integracije |
| skills-catalog | Bralni izvajalni porabnik za pregledane artefakte veščin Clawdie-AI |
| vault-provision | Oskrba datotek env, gnana z Vaultwarden, v ječe po zagonu agenta |
| deployment | Nameščevalnik gostitelja (clawdie): postavitev ZFS, storitev rc.d/systemd, varnost suhega teka |