clawdie-iso/docs/RELEASE-0.11.0-HANDOFF.md

# 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         | `821f51a` | v0.2.42 | 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.