colibri/docs
Sam & Claude 9947da9edc
Some checks failed
CI / rust (pull_request) Has been cancelled
CI / markdown (pull_request) Has been cancelled
CI / port (pull_request) Has been cancelled
CI / agent-jail-pkgs (pull_request) Has been cancelled
fix(wiki-lint): make check 2 actually work + parse ledger
The 'resurrected old names' check was non-functional: it ran in a pipeline
subshell (fail/pass counts and --strict exit were lost), accumulated hit files
with literal \\n (so the per-file filter never matched), and hardcoded the old
names — already stale (missing usb_nodes, the rename that motivated this).
Planting hermes-agent + usb_nodes + COLIBRI_AUTOSPAWN_PI in a source file
passed clean under --strict.

Rewrite:
- Parse old names from the Shipped table of naming-decisions.md (self-updating;
  no hardcoded list to rot).
- Loop in the main shell (read from a file) so counters and --strict propagate.
- xargs grep -nHF across the file list; filter legit contexts case-insensitively
  (migration/rename/back-compat/alias/changelog) so the serde alias and the
  setup-mother migration code don't false-positive.
- Move usb_nodes → hive_nodes from In-flight to Shipped (colibri #161 merged) so
  it is now enforced.

Verified: clean run exits 0 (PASS 37); planting hermes-agent/usb_nodes/
COLIBRI_AUTOSPAWN_PI now FAILs and --strict exits 1. Fixed a serde-alias
false-positive (multi-line attribute). sh -n + markdown gate green.
2026-06-24 10:35:39 +02:00
..
wiki fix(wiki-lint): make check 2 actually work + parse ledger 2026-06-24 10:35:39 +02:00
CLAWDIE-INSTALLER-HANDOFF.md fix(spawner): avoid async closure in retry path (Sam & Pi) 2026-06-21 16:00:11 +02:00
CLAWDIE-STUDIO-PROPOSAL.md docs: repair formatting + content from positive-language rewrite (#124) 2026-06-21 13:19:26 +02:00
COLIBRI-EXTERNAL-MCP-PROTOTYPE.md feat(rc): rename test agent and load provider env (Sam & Codex) 2026-06-15 07:35:44 +02:00
COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md fix(spawner): stage jail spawn files under daemon-owned home, not /var/run 2026-06-21 17:37:32 +02:00
COLIBRI-SKILLS-PLAN.md docs: proof runbook → clean CLI + sweep #126 markdown corruption 2026-06-21 14:46:19 +02:00
COLIBRI-TOKENOMICS-TRIFECTA.md docs: rewrite negative patterns as positive actionable instructions 2026-06-21 13:09:19 +02:00
FREEBSD-BUILD-LANE-HANDOFF.md docs: rewrite negative patterns as positive actionable instructions 2026-06-21 13:09:19 +02:00
HEADROOM-SIDECAR.md docs: repair formatting + content from positive-language rewrite (#124) 2026-06-21 13:19:26 +02:00
INTEGRATION-LAYERED-SOUL.md docs: rewrite negative patterns as positive actionable instructions 2026-06-21 13:09:19 +02:00
ISO-ACCEPTANCE-RUNBOOK.md test: rename 'fake' test agent → 'sample' (lighter, less loaded) 2026-06-23 18:19:49 +02:00
ISO-SERVICE-LAYOUT.md test: rename 'fake' test agent → 'sample' (lighter, less loaded) 2026-06-23 18:19:49 +02:00
MULTI-AGENT-HOST-PLAN.md docs: prettier-format MULTI-AGENT-HOST-PLAN table padding 2026-06-21 18:46:55 +02:00
PLAN-MOTHER-MCP-VAULT-KEYS.md docs: prettier-format PLAN-MOTHER-MCP-VAULT-KEYS table alignment 2026-06-21 22:47:45 +02:00
PRIORITY-HANDOFF-ISO-SPAWN-COST.md test: rename 'fake' test agent → 'sample' (lighter, less loaded) 2026-06-23 18:19:49 +02:00
README.md Merge pull request 'fix(packaging): make agent-jail pkg drift check local-friendly (Sam & Pi)' (#142) from fix/post-pull-format-and-mother-sync-review into main 2026-06-21 20:41:00 +02:00
TRUSS-SPAWN-ANALYSIS.md fix(spawner): stage jail spawn files under daemon-owned home, not /var/run 2026-06-21 17:37:32 +02:00
VAULT-PROVISION-FIRST-PROOF.md docs: proof runbook → clean CLI + sweep #126 markdown corruption 2026-06-21 14:46:19 +02:00
ZOT-RPC-TRANSCRIPT.md fix(glasspane): skip duplicate zot tool_call events (Sam & Pi) 2026-06-22 06:01:48 +02:00

Colibri Docs Index

A quick-reference guide to every document in this folder.

Document One-liner Audience
CLAWDIE-INSTALLER-HANDOFF.md FreeBSD validation handoff for the clawdie installer Codex (FreeBSD)
CLAWDIE-STUDIO-PROPOSAL.md Zed/Claude Code + control plane integration (bare-metal deployment option) Sam & agents
COLIBRI-EXTERNAL-MCP-PROTOTYPE.md Colibri as MCP host for external stdio servers (jailed, 3-tier trust) Agents
COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md FreeBSD jail confinement for spawned agents — accepted & implemented Rust agents
COLIBRI-SKILLS-PLAN.md Skills catalog roadmap: read-only Phase 1, write-gated Phase 2+ Agents
COLIBRI-TOKENOMICS-TRIFECTA.md Strategic vision: useful tokens, cost-per-intelligence, measurement All
HEADROOM-SIDECAR.md Optional headroom-ai tool-result compression sidecar Agents
INTEGRATION-LAYERED-SOUL.md How Colibri consumes layered-soul reviewed context today vs planned Agents
ISO-ACCEPTANCE-RUNBOOK.md Post-boot acceptance commands after staging Colibri into an ISO Codex (FreeBSD)
ISO-SERVICE-LAYOUT.md rc.conf service layout for the ISO image All
MULTI-AGENT-HOST-PLAN.md Current sprint: multi-agent task-board tests + CLI surface gaps All agents
PLAN-MOTHER-MCP-VAULT-KEYS.md Vaultwarden pubkey exchange for mother MCP link (direction B) Sam & Hermes
PRIORITY-HANDOFF-ISO-SPAWN-COST.md ISO boot validation, Pi spawn path, cost mode enforcement (P2/P3 done) All agents
TRUSS-SPAWN-ANALYSIS.md truss trace of jail-spawn Permission Denied — root cause + fix Debugging
VAULT-PROVISION-FIRST-PROOF.md First-proof runbook: vault → jail → .env chain (clean CLI) Agents, Sam