docs: release 0.11.0 ISO builder handoff for the FreeBSD build host

Concise, release-specific handoff for codex/osa: repo state at unified 0.11.0
(commits + tags), the release-channel build command, the release-gate clean-tree
requirement (iso/colibri/clawdie-ai/zot), and the two caveats for this build —
colibri ships as raw FreeBSD binaries (poudriere/Phase 4 deferred until
mother-build) and CI is dormant (validate via local gates, not forge checks).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Sam & Claude 2026-06-21 07:07:25 +02:00
parent 7f55770746
commit d02f8b1423

View file

@ -0,0 +1,42 @@
# Release 0.11.0 — ISO Builder Handoff
**Date:** 21.jun.2026
**For:** the FreeBSD build host (codex / osa). `build.sh` runs on FreeBSD, and the
ISO needs FreeBSD `colibri` binaries — a Linux host cannot cross-build them, so
this build happens on FreeBSD.
## Source state (unified version 0.11.0)
| Repo | main | tag | notes |
| ----------- | --------- | ------- | ------------------------------------------- |
| clawdie-iso | `7f55770` | v0.11.0 | `ISO_VERSION=0.11.0` |
| colibri | `b626082` | v0.11.0 | MIT; 230 tests green; fmt + clippy clean |
| clawdie-ai | `393b0c7` | — | clean on forge main |
| zot | `1a24a20` | — | agent (front door); pinned by `ZOT_VERSION` |
Locally-runnable gates pass on colibri + clawdie-iso (fmt, `CARGO_CRATES` and
agent-jail drift checks, markdown). CI Actions are **dormant** (no runner) — gates
are validated by hand, not by the forge.
## Build
On the FreeBSD build host, with a **clean** checkout of every repo the release
gate asserts (clawdie-iso, colibri, clawdie-ai, and zot when
`COLIBRI_STAGE_AGENT=YES`):
```sh
# pull latest main on each repo first; `git status` must be clean on all of them
cd <clawdie-iso>
BUILD_CHANNEL=release ./build.sh # ISO_VERSION=0.11.0 from build.cfg
```
`check_release_gate()` aborts the release build if any of those trees is dirty.
## Caveats for this build
- **colibri ships as raw FreeBSD binaries** (the build host's `cargo build
--release`). The poudriere path (`pkg install colibri` from `pkg.clawdie.si`,
Phase 4) stays **deferred** until the `mother-build` host exists — unchanged
from prior builds.
- **No CI runner** — do not wait on forge checks; they sit `pending`. Validate
with the local gates above.