colibri/docs
Sam & Claude df5fbab051
Some checks failed
CI / rust (pull_request) Has been cancelled
CI / markdown (pull_request) Has been cancelled
fix(rc): FreeBSD rc.d deep-audit — cost mode naming, chmod cleanup, health check, docs (Sam & Hermes)
Six bugs found in deep-dive analysis of FreeBSD rc.d/rc.conf after the
live-copy-safe fix (7d23905):

1. colibri_cost_mode → colibri_daemon_cost_mode: naming broke rc.subr
   ${name}_ convention — operator setting colibri_daemon_cost_mode=fast
   in rc.conf was silently ignored. Fixed in rc.d, staging script,
   rc.conf.sample, and all docs.

2. Removed redundant chmod 660 on socket in poststart: Rust code already
   sets 0770 with documented rationale. The poststart override to 0660
   was conflicting, fragile, and had no comment.

3. Removed unnecessary chmod 644 on pidfile in poststart: pidfile lives
   in a 0750 directory — world-readable permission is pointless and
   security-negative.

4. Fixed ISO-SERVICE-LAYOUT.md: socket perms were wrong (said 750, actual
   770), colibri-daemon.pid was labeled supervisor pidfile (it's the
   child), supervisor pidfile was missing entirely, shutdown behavior
   didn't mention custom stop_cmd targeting the supervisor.

5. health_cmd now checks for non-empty daemon response instead of just
   connectvity — a hung daemon accepting connections but returning
   garbage was reported healthy.

6. rc.conf.sample hostname path: $ (hostname) → $(/bin/hostname) for
   consistency with rc.d script and early-boot PATH safety.

Checks: sh -n OK, cargo fmt --check OK, cargo clippy clean,
cargo test --workspace 207 passed.
2026-06-15 08:28:20 +02:00
..
CLAWDIE-INSTALLER-HANDOFF.md docs: tidy clawdie handoff — reflect hardening applied (PR #53) 2026-06-14 00:49:52 +02:00
CLAWDIE-STUDIO-PROPOSAL.md feat(rc): rename test agent and load provider env (Sam & Codex) 2026-06-15 07:35:44 +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 docs: document jail root_path + staged env payloads 2026-06-14 01:38:30 +02:00
COLIBRI-SKILLS-PLAN.md chore: adopt markdown formatting gate + one-shot prettier sweep (Sam & Claude) 2026-06-04 20:13:47 +02:00
COLIBRI-TOKENOMICS-TRIFECTA.md docs: remove stale Herdr hub runbook + T1.4 cache-warming design 2026-06-13 21:42:42 +02:00
FREEBSD-BUILD-LANE-HANDOFF.md feat(rc): rename test agent and load provider env (Sam & Codex) 2026-06-15 07:35:44 +02:00
HEADROOM-SIDECAR.md feat(rc): rename test agent and load provider env (Sam & Codex) 2026-06-15 07:35:44 +02:00
INTEGRATION-LAYERED-SOUL.md fix(import): treat each SKILL.md as one skill (not every .md) 2026-06-14 02:08:12 +02:00
ISO-ACCEPTANCE-RUNBOOK.md fix(rc): FreeBSD rc.d deep-audit — cost mode naming, chmod cleanup, health check, docs (Sam & Hermes) 2026-06-15 08:28:20 +02:00
ISO-SERVICE-LAYOUT.md fix(rc): FreeBSD rc.d deep-audit — cost mode naming, chmod cleanup, health check, docs (Sam & Hermes) 2026-06-15 08:28:20 +02:00
PRIORITY-HANDOFF-ISO-SPAWN-COST.md feat(rc): rename test agent and load provider env (Sam & Codex) 2026-06-15 07:35:44 +02:00
README.md docs: purge all Herdr references, consolidate into AGENTS.md + README (Sam & Hermes) 2026-06-14 14:04:49 +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
PRIORITY-HANDOFF-ISO-SPAWN-COST.md Current sprint: ISO staging wiring, Pi spawn path, cost mode enforcement All agents