diff --git a/docs/RELEASE-0.11.0-HANDOFF.md b/docs/RELEASE-0.11.0-HANDOFF.md new file mode 100644 index 00000000..fc65e85e --- /dev/null +++ b/docs/RELEASE-0.11.0-HANDOFF.md @@ -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 +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.