clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 31

docs: define Clawdie bare-metal service identity (USB dev → ZFS RAID1 deploy) #126

Merged
clawdie merged 1 commit from docs/clawdie-bare-metal-identity into main 2026-06-21 14:18:57 +02:00
Conversation 0 Commits 1 Files changed 2 +18 -9
2 changed files with 18 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
AGENTS.md
View file

@ -3,10 +3,10 @@
## Project Identity
Colibri is the Clawdie control plane core — a small, cross-platform (FreeBSD 15
- Linux) Rust daemon. It unifies a coordination model (agents-as-teammates, task
board, team skills) with a cache-first cost discipline (byte-stable prompt
prefixes, cache-hit metering).
+ Linux) Rust daemon. Developed and validated from an operator USB environment;
deploys as the **Clawdie service** on bare metal. It unifies a coordination
model (agents-as-teammates, task board, team skills) with a cache-first cost
discipline (byte-stable prompt prefixes, cache-hit metering).
**License:** MIT (matches `layered-soul`). **Version:** 0.11.0, unified with `clawdie-iso`.
@ -23,7 +23,11 @@ Colibri is the Clawdie control plane core — a small, cross-platform (FreeBSD 1
observes zot/pi; it does not contain them.
- **pi** — kept as a spawnable backend, not the default. Glasspane treats pi
and zot identically (`AgentRuntime { Pi, Zot }`).
- "Clawdie" = zot + Colibri together (product name, not a separate binary).
- **Clawdie** — Colibri deployed as a service on bare FreeBSD hardware. Target
spec: ZFS RAID1 mirror, PostgreSQL + pgvector, bhyve VMs, Bastille jails.
The operator USB is the development/validation surface; the Clawdie service
is the production deployment. (Product name = Colibri + zot running on a
Clawdie host, not a separate binary.)
- **clawdie-ai (TS)** — being pruned; surviving features move to zot
skills/extensions or Colibri.
@ -49,8 +53,10 @@ markdown formatting; preserve intentional prose line breaks and fenced code.
## Target Platform
**Destination runtime: FreeBSD 15.** Development happens on Linux (debby —
Debian 13, this machine) but final validation must pass on FreeBSD 15.
**Target deployment: bare-metal FreeBSD host.** Colibri runs as the `clawdie`
rc.d service on a ZFS RAID1 mirror with PostgreSQL + pgvector, bhyve VMs, and
Bastille jails. The operator USB image is the development, validation, and
recovery surface — the bare-metal install is the production target.
Target: `x86_64-unknown-freebsd` (Rust Tier-2). TLS uses `rustls` for clean
static linking on FreeBSD (no `openssl-sys` dependency).

7
README.md
View file

@ -1,8 +1,11 @@
# 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).
daemon. Developed from an operator USB environment; deploys as the **Clawdie
service** on bare FreeBSD hardware (ZFS RAID1, PostgreSQL + pgvector, bhyve
VMs, Bastille jails). Unifies coordination (task board, agent registry, skills
catalog) with cache-first cost discipline (byte-stable prompt prefixes,
cache-hit metering).
**Status:** workspace gates are fmt/clippy/test/release green. Round 2 audit is closed. Current priorities: ISO boot/runtime validation, Pi spawn end-to-end, and cost-mode enforcement (see [`docs/PRIORITY-HANDOFF-ISO-SPAWN-COST.md`](docs/PRIORITY-HANDOFF-ISO-SPAWN-COST.md)). Always query live state: see the crate table below and run the gate commands for current counts.