colibri/docs
Sam & Claude 20b65f9577
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
docs(wiki): add terminal + operator-attention pages, fix glasspane drift
Two new decisions captured, one page corrected:

terminal.md — the terminal-capability decision. Why colibri-tui and the agents
it supervises need modified-key reporting (Tab vs Shift-Tab, n vs N, Enter),
why the choice fell on Kitty, the tmux extended-keys + csi-u passthrough for
the in-tmux workflow, raw-vs-tmux distinction, the SSH xterm-kitty terminfo
gotcha, and pi's identical requirement. The decision is about capability;
Kitty is the instance.

operator-attention.md — the shipped attention system as one decision. Attention
as a derived view over the state machine (not a sixth variant), the TUI
bar/jump/filter/row-highlight, and the #193 terminal-capture + signature-triage
+ edge-triggered alerts. Records the has_attention session-filter bug and fix.
Lists what is still open (outbound push, answer-from-dashboard).

glasspane.md — corrected drift. The real AgentState enum is {Idle, Working,
Blocked, Done, Error}; Stalled is a derived flag, not a variant (the page's
diagram omitted Blocked and listed Stalled as a variant). The "Usability
roadmap (TODO)" listed the attention half as not-yet-built; it shipped via
#191/#193, so those items move to operator-attention.md and the roadmap keeps
only the genuinely-unbuilt direction.

index.md — two table rows (also satisfies the orphan-page check).

Verified: prettier-clean on all 4 files; wiki-lint --strict clean (144 pass /
0 fail, up from 137); no dangling refs, no orphans, no resurrected names.

(Sam & Claude)
2026-06-25 22:50:19 +02:00
..
wiki docs(wiki): add terminal + operator-attention pages, fix glasspane drift 2026-06-25 22:50:19 +02:00
CLAWDIE-INSTALLER-HANDOFF.md docs: normalize prose dates to DD.mon.YYYY (AGENTS.md rule) 2026-06-24 16:43:41 +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: normalize prose dates to DD.mon.YYYY (AGENTS.md rule) 2026-06-24 16:43:41 +02:00
FREEBSD-BUILD-LANE-HANDOFF.md docs(handoff): fix artifact list, add node+npm requirement 2026-06-24 19:42:33 +02:00
GLASSPANE-TUI-ENHANCEMENTS.md docs: add concrete attention system design to TUI enhancements 2026-06-25 17:18:13 +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 fix(store): atomic+exclusive claim_task — close Gap 4 concurrency guard (#190) 2026-06-25 17:33:15 +02:00
README.md docs: move reference docs into wiki (agent-events, headroom, layered-soul) 2026-06-24 17:32:13 +02:00
VAULT-PROVISION-RUNBOOK.md docs: harness-agnostic + plainer doc names; codify naming principle 2026-06-24 16:33:40 +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
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
VAULT-PROVISION-RUNBOOK.md First-proof runbook: vault → jail → .env chain (clean CLI) Agents, Sam