colibri/docs
Sam & Claude b1e23f4022
Some checks failed
CI / rust (pull_request) Has been cancelled
CI / markdown (pull_request) Has been cancelled
docs: design note for colibri-spawned pi in a FreeBSD jail
Colibri already spawns pi (spawner.rs) and captures its JSONL for glasspane;
this documents adding optional jail confinement to that existing path rather
than touching zot (whose swarm is self-only + no isolation — keeps the mirror
clean).

Covers: JailConfig + jail_wrap at the Command::new site, jail-aware teardown,
and the privilege decision for the root-only jexec step —

  - live USB    → `mdo -u root` (reuses mac_do; daemon == operator trust domain)
  - deployed    → setuid/Capsicum helper (narrow root surface on exposed hosts)

mac_do rules are identity-based (gid=0>uid=0), not command-filtered, so mdo
grants the daemon full root; that's acceptable on the single-operator live USB
but not on a deployed/exposed box, hence the split. Selected via PrivMode at
daemon config time so one spawner serves both.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-13 19:06:21 +02:00
..
CLAWDIE-AGENT-WIKI.md docs: clarify Herdr as optional Linux display (Sam & Codex) 2026-06-13 12:29:11 +02:00
CLAWDIE-BUILD.md docs: clarify Herdr as optional Linux display (Sam & Codex) 2026-06-13 12:29:11 +02:00
CLAWDIE-STUDIO-PROPOSAL.md chore: adopt markdown formatting gate + one-shot prettier sweep (Sam & Claude) 2026-06-04 20:13:47 +02:00
COLIBRI-DAEMON-GLASSPANE-INTEGRATION.md docs: clarify Herdr as optional Linux display (Sam & Codex) 2026-06-13 12:29:11 +02:00
COLIBRI-GLASSPANE-DESIGN.md chore: adopt markdown formatting gate + one-shot prettier sweep (Sam & Claude) 2026-06-04 20:13:47 +02:00
COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md docs: design note for colibri-spawned pi in a FreeBSD jail 2026-06-13 19:06:21 +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: format tokenomics trifecta v2 2026-06-02 17:43:10 +02:00
HERDR-HUB-RUNBOOK.md chore: adopt markdown formatting gate + one-shot prettier sweep (Sam & Claude) 2026-06-04 20:13:47 +02:00
HERDR-VS-COLIBRI-GRAPH.md docs: clarify Herdr as optional Linux display (Sam & Codex) 2026-06-13 12:29:11 +02:00
ISO-ACCEPTANCE-RUNBOOK.md docs: add ISO acceptance tracker and staging helper 2026-05-27 22:52:59 +02:00
ISO-INTEGRATION-PLAN.md docs: clarify Herdr as optional Linux display (Sam & Codex) 2026-06-13 12:29:11 +02:00
ISO-SERVICE-LAYOUT.md chore: adopt markdown formatting gate + one-shot prettier sweep (Sam & Claude) 2026-06-04 20:13:47 +02:00
MULTIAGENT-WORKFLOW-IMPROVEMENTS.md docs: clarify Herdr as optional Linux display (Sam & Codex) 2026-06-13 12:29:11 +02:00
T1.4-CACHE-WARMING-DESIGN.md chore: adopt markdown formatting gate + one-shot prettier sweep (Sam & Claude) 2026-06-04 20:13:47 +02:00
T1.4-PROMPT-DISCIPLINE-PLAN.md chore: adopt markdown formatting gate + one-shot prettier sweep (Sam & Claude) 2026-06-04 20:13:47 +02:00