Merge pull request 'docs: release 0.11.0 ISO builder handoff' (#82) from docs/release-0.11.0-handoff into main

Reviewed-on: #82
This commit is contained in:
clawdie 2026-06-21 07:08:39 +02:00
commit a1f8efd7bf

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.