Sam & Claude f8a0aff88d

CI / rust (pull_request) Has been cancelled

Details

CI / markdown (pull_request) Has been cancelled

Details

docs: stop hand-maintaining the workspace crate count

The count drifted repeatedly (8/10/11/12, plus README-vs-AGENTS mismatches)
because it was hardcoded in three places. Drop the number from README (status +
heading) and AGENTS; the crate table + Cargo.toml members are the source of
truth, so adding/removing a crate only touches the table.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-14 12:44:53 +02:00

3.3 KiB

Raw Blame History

Colibri

The Clawdie control plane core — a small, cross-platform (FreeBSD + Linux) Rust daemon that unifies coordination (task board, agent registry, skills catalog) with cache-first cost discipline (byte-stable prompt prefixes, cache-hit metering).

Status: workspace gates are expected to be fmt/clippy/test/release green. Avoid fixed crate/test counts here — see the crate table below and run the gate commands for the current state. Phase 3 (coordination core) is in progress.

Next ISO integration plan: docs/ISO-INTEGRATION-PLAN.md. ISO acceptance runbook: docs/ISO-ACCEPTANCE-RUNBOOK.md. Clawdie Studio/Zed proposal: docs/CLAWDIE-STUDIO-PROPOSAL.md. External MCP host prototype: docs/COLIBRI-EXTERNAL-MCP-PROTOTYPE.md. Optional Headroom compression sidecar: docs/HEADROOM-SIDECAR.md.

Workspace

Crate	Role
`colibri` (root)	Workspace root + probe binaries (colibri-probe, runtime-inventory)
`colibri-mcp`	MCP bridge for editor integration (Zed, Claude Code) via stdio JSON-RPC
`colibri-contracts`	JSON schema contracts (golden tests)
`colibri-deepseek`	DeepSeek cache-hit probe, prefix metering
`colibri-runtime`	Host status ingestion, runtime inventory
`colibri-glasspane`	Agent 5-state machine (Pi events → state)
`colibri-daemon`	Always-on Unix socket server, session lifecycle
`colibri-client`	Typed Unix-socket client + operator CLI
`colibri-glasspane-tui`	ratatui live dashboard (FreeBSD-native)
`colibri-store`	Embedded SQLite coordination (task board, agents, skills)
`colibri-skills`	Skills catalog crate
`clawdie`	Host installer/deployer: ZFS layout + `clawdie` service (FreeBSD/Linux)

Build

cargo build --release

Test

cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings

Architecture

colibri-daemon (always-on Unix socket server)
  ├── glasspane      — agent state machine (Pi JSONL → idle/working/blocked/done)
  ├── store          — SQLite coordination (tasks, agents, skills)
  ├── socket         — newline-JSON socket API
  ├── session        — append-only JSONL sessions, 3-region prompt assembly
  └── spawner        — agent subprocess management (retry/backoff, FreeBSD jail confinement)

colibri-client       — CLI tools (colibri, colibri_smoke_agent)
colibri-glasspane-tui— ratatui dashboard (no Herdr dependency)

Probe binaries

# DeepSeek cache probe (needs DEEPSEEK_API_KEY)
cargo run --release --bin colibri-probe

# Runtime inventory manifest
cargo run --release --bin colibri-runtime-inventory

FreeBSD

Target x86_64-unknown-freebsd (Rust Tier-2). TLS is rustls to avoid openssl-sys linking. Default DB path: /var/db/colibri/colibri.sqlite.

3.3 KiB Raw Blame History