From d02f8b142369f2db4c65e92628dad0096125ae3d Mon Sep 17 00:00:00 2001 From: Sam & Claude Date: Sun, 21 Jun 2026 07:07:25 +0200 Subject: [PATCH] docs: release 0.11.0 ISO builder handoff for the FreeBSD build host MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- docs/RELEASE-0.11.0-HANDOFF.md | 42 ++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 docs/RELEASE-0.11.0-HANDOFF.md 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. -- 2.45.3