clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 48

docs: rename PLAN/PROPOSAL/HANDOFF/ENHANCEMENT → implementation names #223

Merged
clawdie merged 1 commit from chore/rename-plan-docs into main 2026-06-26 17:34:56 +02:00
Conversation 0 Commits 1 Files changed 23 +48 -48
23 changed files with 48 additions and 48 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
crates/colibri-glasspane-tui/src/main.rs
View file

@ -888,7 +888,7 @@ mod tests {
#[test]
fn all_sessions_view_is_reachable_with_sessions_present() {
// Regression for the pre-existing bug documented in
// GLASSPANE-TUI-ENHANCEMENTS.md: once any pane had a session_id,
// GLASSPANE-TUI-DESIGN.md: once any pane had a session_id,
// rebuild_session_list() forced session_filter = Some(first), making
// the aggregated "All sessions" view unreachable. It must now default
// to All and stay selectable via Tab.

0
docs/CLAWDIE-INSTALLER-HANDOFF.md → docs/CLAWDIE-INSTALLER-VALIDATION.md
View file

0
docs/CLAWDIE-STUDIO-PROPOSAL.md → docs/CLAWDIE-STUDIO.md
View file

0
docs/COLIBRI-SKILLS-PLAN.md → docs/COLIBRI-SKILLS.md
View file

2
docs/FREEBSD-BUILD-LANE-HANDOFF.md → docs/FREEBSD-BUILD-LANE.md
View file

@ -4,7 +4,7 @@
candidate and prove ISO Gate 1 (passive service) on real FreeBSD.
This is the runtime-proof step for the FreeBSD ISO validation tracked in
`MULTI-AGENT-HOST-PLAN.md`. The build-side wiring is already done on
`MULTI-AGENT-HOST.md`. The build-side wiring is already done on
Linux — `clawdie-iso build.sh` stages the Colibri binaries, installs the rc.d
script, creates the `colibri` user, and enables the service. What remains is
work only a FreeBSD host can do: build the FreeBSD binaries, run the image

0
docs/GLASSPANE-TUI-ENHANCEMENTS.md → docs/GLASSPANE-TUI-DESIGN.md
View file

0
docs/MULTI-AGENT-HOST-PLAN.md → docs/MULTI-AGENT-HOST.md
View file

8
docs/README.md
View file

@ -4,13 +4,13 @@ A quick-reference guide to every document in this folder.
| Document | One-liner | Audience |
| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------- | --------------- |
| [`CLAWDIE-INSTALLER-HANDOFF.md`](CLAWDIE-INSTALLER-HANDOFF.md) | FreeBSD validation handoff for the `clawdie` installer | Codex (FreeBSD) |
| [`CLAWDIE-STUDIO-PROPOSAL.md`](CLAWDIE-STUDIO-PROPOSAL.md) | Zed/Claude Code + control plane integration (bare-metal deployment option) | Sam & agents |
| [`CLAWDIE-INSTALLER-VALIDATION.md`](CLAWDIE-INSTALLER-VALIDATION.md) | FreeBSD validation handoff for the `clawdie` installer | Codex (FreeBSD) |
| [`CLAWDIE-STUDIO.md`](CLAWDIE-STUDIO.md) | Zed/Claude Code + control plane integration (bare-metal deployment option) | Sam & agents |
| [`COLIBRI-EXTERNAL-MCP-PROTOTYPE.md`](COLIBRI-EXTERNAL-MCP-PROTOTYPE.md) | Colibri as MCP host for external stdio servers (jailed, 3-tier trust) | Agents |
| [`COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md`](COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md) | FreeBSD jail confinement for spawned agents — accepted & implemented | Rust agents |
| [`COLIBRI-SKILLS-PLAN.md`](COLIBRI-SKILLS-PLAN.md) | Skills catalog roadmap: read-only Phase 1, write-gated Phase 2+ | Agents |
| [`COLIBRI-SKILLS.md`](COLIBRI-SKILLS.md) | Skills catalog roadmap: read-only Phase 1, write-gated Phase 2+ | Agents |
| [`COLIBRI-TOKENOMICS-TRIFECTA.md`](COLIBRI-TOKENOMICS-TRIFECTA.md) | Strategic vision: useful tokens, cost-per-intelligence, measurement | All |
| [`ISO-ACCEPTANCE-RUNBOOK.md`](ISO-ACCEPTANCE-RUNBOOK.md) | Post-boot acceptance commands after staging Colibri into an ISO | Codex (FreeBSD) |
| [`ISO-SERVICE-LAYOUT.md`](ISO-SERVICE-LAYOUT.md) | `rc.conf` service layout for the ISO image | All |
| [`MULTI-AGENT-HOST-PLAN.md`](MULTI-AGENT-HOST-PLAN.md) | **Current sprint**: multi-agent task-board tests + CLI surface gaps | All agents |
| [`MULTI-AGENT-HOST.md`](MULTI-AGENT-HOST.md) | **Current sprint**: multi-agent task-board tests + CLI surface gaps | All agents |
| [`VAULT-PROVISION-RUNBOOK.md`](VAULT-PROVISION-RUNBOOK.md) | First-proof runbook: vault → jail → `.env` chain (clean CLI) | Agents, Sam |

0
docs/PLAN-WIKI-CLAWDIE-SI.md → docs/WIKI-CLAWDIE-SI.md
View file

2
docs/guide/install/install.md
View file

@ -88,4 +88,4 @@ repo; they are being reconciled to the `clawdie` model.
The disk-touching and service-install paths are validated on real FreeBSD/Linux
hosts; discovery, plan, and disk-candidacy logic are unit-tested. See
`docs/CLAWDIE-INSTALLER-HANDOFF.md` for the FreeBSD validation runbook.
`docs/CLAWDIE-INSTALLER-VALIDATION.md` for the FreeBSD validation runbook.

22
docs/wiki/daemon-not-demon.md
View file

@ -39,22 +39,22 @@ Examples: `sshd` (SSH daemon), `cron` (scheduler daemon), `colibri-daemon`
To avoid the _demon_ (devil) connotation, Slovenian documentation translates
_daemon_ as **proces v ozadju** — literally "process in the background."
| English | Slovenian | Why |
| ---------------- | ------------------------------ | ----------------------------------------------------------------------- |
| daemon | proces v ozadju | Neutral, descriptive — no devil connotation |
| colibri-daemon | proces v ozadju Colibri | Same term, always |
| daemon process | proces v ozadju | The process IS in the background; the adjective form is less idiomatic |
| English | Slovenian | Why |
| -------------- | ----------------------- | ---------------------------------------------------------------------- |
| daemon | proces v ozadju | Neutral, descriptive — no devil connotation |
| colibri-daemon | proces v ozadju Colibri | Same term, always |
| daemon process | proces v ozadju | The process IS in the background; the adjective form is less idiomatic |
The adjective form _ozadnji_ (background, as in "background process") was
considered but _proces v ozadju_ is more natural Slovenian — the noun
inflects while the prepositional phrase stays fixed:
| Case | Slovenian |
| ----------------- | ------------------------------ |
| nominative | proces v ozadju |
| genitive | procesa v ozadju |
| dative / locative | procesu v ozadju |
| instrumental | procesom v ozadju |
| Case | Slovenian |
| ----------------- | ----------------- |
| nominative | proces v ozadju |
| genitive | procesa v ozadju |
| dative / locative | procesu v ozadju |
| instrumental | procesom v ozadju |
## In English: always _daemon_, never _demon_

2
docs/wiki/deployment.md
View file

@ -13,7 +13,7 @@ and either ZFS or plain directories.
→ `docs/ISO-SERVICE-LAYOUT.md`
→ `docs/CLAWDIE-INSTALLER-HANDOFF.md`
→ `docs/CLAWDIE-INSTALLER-VALIDATION.md`
## Decisions

2
docs/wiki/external-mcp.md
View file

@ -15,7 +15,7 @@ protocol that editors already speak. This avoids the maintenance cost and
political risk of forking or embedding an editor, keeps Colibri headless-safe,
and lets any MCP-compatible client access the same surface.
For the longer-term product framing, see ../CLAWDIE-STUDIO-PROPOSAL.md.
For the longer-term product framing, see ../CLAWDIE-STUDIO.md.
## Two roles in one binary

4
docs/wiki/layered-soul.md
View file

@ -23,7 +23,7 @@ table as `clawdie-iso/scripts/import-clawdie-skills.sh`; idempotent, safe to re-
The the Colibri adapter in layered-soul names a "Layered Memory Fabric" with
three stores — `system_skills`, `system_brain`, `system_ops`. As of 2026-06-13
only a single flat `skills` table exists; the rest is **design only**
(`docs/COLIBRI-SKILLS-PLAN.md`), so the importer intentionally does not target it.
(`docs/COLIBRI-SKILLS.md`), so the importer intentionally does not target it.
| Layered Soul source | Target (planned) | Status |
| ------------------------------- | ---------------- | ---------------------------------------------------------- |
@ -39,7 +39,7 @@ then re-import — runtime copies are ephemeral consumers.
## Closing the gap (future work)
1. Implement `system_brain` per `COLIBRI-SKILLS-PLAN.md`, then extend the importer
1. Implement `system_brain` per `COLIBRI-SKILLS.md`, then extend the importer
to load curated memories.
2. Migrate the flat `skills` table to the planned `system_skills` schema.
3. Define and import `system_ops` task/job manifests.

2
docs/wiki/mother-hive.md
View file

@ -108,4 +108,4 @@
108|- [agent-harness](./agent-harness.md) — the zot/Colibri split; autospawn
109|- [naming-decisions](./naming-decisions.md) — `usb_nodes → hive_nodes`, autospawn flag rename
110|- [quality-gates](./quality-gates.md) — the gate that should catch drift at PR time
111|
111|

6
docs/wiki/skills-catalog.md
View file

@ -9,7 +9,7 @@ the daemon, CLI, and TUI. This crate does not author skills.
→ `crates/colibri-skills/src/lib.rs`
→ `docs/COLIBRI-SKILLS-PLAN.md`
→ `docs/COLIBRI-SKILLS.md`
## Decisions
@ -33,7 +33,7 @@ The import path is target for Phase 1: scan the configured Clawdie-AI checkout,
parse manifests, verify checksums, and upsert into SQLite. The type scaffold
exists today; the importer, chunker, and FTS5 index are planned.
→ `docs/COLIBRI-SKILLS-PLAN.md` (Phases 1-7)
→ `docs/COLIBRI-SKILLS.md` (Phases 1-7)
### Manifest-driven identity
@ -108,7 +108,7 @@ pgvector; until then, SQLite keeps the control-plane self-contained.
→ [store-schema](./store-schema.md)
→ `docs/COLIBRI-SKILLS-PLAN.md` (SQLite schema target)
→ `docs/COLIBRI-SKILLS.md` (SQLite schema target)
### Status is a lifecycle marker, not a state machine

22
docs/wiki/sl/daemon-not-demon.md
View file

@ -37,22 +37,22 @@ ozadju), `colibri-daemon` (proces krmilne ravnine v ozadju).
Da se izognemo prizvoku _demona_ (hudiča), slovenska dokumentacija prevaja
_daemon_ kot **proces v ozadju**.
| Angleško | Slovensko | Zakaj |
| ---------------- | ------------------------------ | ------------------------------------------------------------------------- |
| daemon | proces v ozadju | Nevtralno, opisno — brez hudičevega prizvoka |
| colibri-daemon | proces v ozadju Colibri | Enak izraz, vedno |
| daemon process | proces v ozadju | Proces JE v ozadju; pridevniška oblika je manj idiomatična |
| Angleško | Slovensko | Zakaj |
| -------------- | ----------------------- | ---------------------------------------------------------- |
| daemon | proces v ozadju | Nevtralno, opisno — brez hudičevega prizvoka |
| colibri-daemon | proces v ozadju Colibri | Enak izraz, vedno |
| daemon process | proces v ozadju | Proces JE v ozadju; pridevniška oblika je manj idiomatična |
Oblika _ozadnji proces_ je bila v obtoku, vendar je _proces v ozadju_
naravnejša slovenščina — samostalnik se sklanja, predložna zveza pa ostaja
nespremenjena:
| Sklon | Slovensko |
| ----------------- | ------------------------------ |
| imenovalnik | proces v ozadju |
| rodilnik | procesa v ozadju |
| dajalnik / mestnik| procesu v ozadju |
| orodnik | procesom v ozadju |
| Sklon | Slovensko |
| ------------------ | ----------------- |
| imenovalnik | proces v ozadju |
| rodilnik | procesa v ozadju |
| dajalnik / mestnik | procesu v ozadju |
| orodnik | procesom v ozadju |
## V angleščini: vedno _daemon_, nikoli _demon_

2
docs/wiki/sl/deployment.md
View file

@ -11,7 +11,7 @@ rc.d, podatkovne zbirke ZFS in neprivilegiranega uporabnika. Na Linuxu lahko
uporablja systemd in bodisi ZFS bodisi navadne imenike.
→ `crates/clawdie/src/main.rs` | `crates/clawdie/src/plan.rs`
→ `docs/ISO-SERVICE-LAYOUT.md` | `docs/CLAWDIE-INSTALLER-HANDOFF.md`
→ `docs/ISO-SERVICE-LAYOUT.md` | `docs/CLAWDIE-INSTALLER-VALIDATION.md`
## Odločitve

10
docs/wiki/sl/external-mcp.md
View file

@ -24,11 +24,11 @@ podpira. Prav tako se izogne potrebi po odprtju drugega omrežnega vmesnika.
Strežnik MCP izpostavlja tri orodja:
| Orodje | Ukaz procesa v ozadju | Namen |
| ------------------ | ---------------------- | ---------------------------------------------------------- |
| `colibri_status` | `status` | Stanje procesa v ozadju (agenti, opravila, predpomnilnik) |
| `colibri_snapshot` | `glasspane-snapshot` | Trenutni posnetek podoken Glasspane |
| `colibri_spawn` | `spawn-agent` | Zaženi novega agenta |
| Orodje | Ukaz procesa v ozadju | Namen |
| ------------------ | --------------------- | --------------------------------------------------------- |
| `colibri_status` | `status` | Stanje procesa v ozadju (agenti, opravila, predpomnilnik) |
| `colibri_snapshot` | `glasspane-snapshot` | Trenutni posnetek podoken Glasspane |
| `colibri_spawn` | `spawn-agent` | Zaženi novega agenta |
Ta tri orodja pokrivajo 90 % zunanjih interakcij. Celoten API vtičnice je na
voljo neposrednim odjemalcem vtičnice; MCP je priročna podmnožica.

2
docs/wiki/sl/index.md
View file

@ -67,7 +67,7 @@ clippy.
| [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 |
| [external-mcp](./external-mcp.md) | Most MCP za urejevalnike + zunanji gostitelj stdio MCP; dovoljenja za branje/pisanje/zunanji-klic |
| [operator-cli](./operator-cli.md) | CLI `colibri` kot tanek tipiziran odjemalec Unix vtičnice prek API procesa v ozadju |
| [operator-cli](./operator-cli.md) | CLI `colibri` kot tanek tipiziran odjemalec Unix vtičnice prek API procesa v ozadju |
| [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 |

4
docs/wiki/sl/layered-soul.md
View file

@ -27,7 +27,7 @@ idempotentno, varno za ponovni zagon.
Prilagoditveni vmesnik Colibri v layered-soul poimenuje "Plastovito
pomnilniško tkanino" s tremi shrambami — `system_skills`, `system_brain`,
`system_ops`. Na dan 2026-06-13 obstaja samo ena ploščata tabela `skills`;
ostalo je **samo načrt** (`docs/COLIBRI-SKILLS-PLAN.md`), zato uvoznik
ostalo je **samo načrt** (`docs/COLIBRI-SKILLS.md`), zato uvoznik
namenoma ne cilja nanje.
| Vir v layered-soul | Cilj (načrtovan) | Stanje |
@ -44,7 +44,7 @@ nato ponovno uvozite — izvajalne kopije so prehodni porabniki.
## Zapiranje vrzeli (prihodnje delo)
1. Implementiraj `system_brain` po `COLIBRI-SKILLS-PLAN.md`, nato razširi
1. Implementiraj `system_brain` po `COLIBRI-SKILLS.md`, nato razširi
uvoznika, da naloži urejene spomine.
2. Preseli ploščato tabelo `skills` v načrtovano shemo `system_skills`.
3. Definiraj in uvozi manifeste opravil `system_ops`.

2
docs/wiki/sl/mother-hive.md
View file

@ -117,4 +117,4 @@
117|- [agent-harness](./agent-harness.md) — razcep zot/Colibri; samodejni zagon
118|- [naming-decisions](./naming-decisions.md) — `usb_nodes → hive_nodes`, preimenovanje zastavice autospawn
119|- [quality-gates](./quality-gates.md) — preverjanje, ki bi moralo ujeti odmik ob času PR
120|
120|

2
docs/wiki/tui.md
View file

@ -64,7 +64,7 @@ with layout and keybindings; all semantic decisions live in
The crate directory is `colibri-glasspane-tui` because the package implements
"a TUI for the glasspane." The installed binary is named `colibri-tui`
because that is what an operator types. `CLAWDIE-STUDIO-PROPOSAL.md` and other
because that is what an operator types. `CLAWDIE-STUDIO.md` and other
docs refer to `colibri-tui` as shorthand; there is no separate `colibri-tui`
crate.