clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 48
colibri/docs
History
Sam & Claude a7565c49ad
Some checks failed
CI / markdown (pull_request) Has been cancelled
Details
CI / port (pull_request) Has been cancelled
Details
CI / agent-jail-pkgs (pull_request) Has been cancelled
Details
CI / rust (pull_request) Has been cancelled
Details
fix(spawner): stage jail spawn files under daemon-owned home, not /var/run 
Closes #135. The daemon stages per-spawn launch.sh/env.sh under the jail root;
the previous location /var/run/colibri-stage is root-owned, so the daemon
(running as clawdie) could not create per-spawn subdirs there — the second
jail-spawn EACCES, worked around in #134 by pre-creating the dir in
agent-jail-bootstrap.sh.

Move the default staging root to the daemon user's home,
/home/clawdie/.cache/colibri/stage, which clawdie owns by construction of the
jail account. create_dir_all now succeeds with no privileged pre-creation step,
and /home is persistent (unlike a tmpfs /var/run). The path is overridable via
COLIBRI_JAIL_STAGE_DIR, matching the daemon's other env-configurable paths.

- spawner.rs: const → staged_jail_run_dir() resolver; updated unit test.
- agent-jail-bootstrap.sh: drop the now-unnecessary install -d staging block
  and DAEMON_USER var (the #134 workaround).
- docs: update jailed-spawn design + truss analysis to the new location.

clippy clean; spawner suite green (21 tests); sh -n clean; touched docs pass
the markdown gate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 17:37:32 +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 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(daemon): fail closed when socket ownership is unsafe (Sam & Codex) 2026-06-15 09:08:56 +02:00
MULTI-AGENT-HOST-PLAN.md docs: repair formatting + content from positive-language rewrite (#124) 2026-06-21 13:19:26 +02:00
PRIORITY-HANDOFF-ISO-SPAWN-COST.md docs: rewrite negative patterns as positive actionable instructions 2026-06-21 13:09:19 +02:00
README.md docs: truss analysis of jail-spawn Permission Denied + debugging reference 2026-06-21 17:22:30 +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

README.md

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
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