diff --git a/AGENTS.md b/AGENTS.md index e29901feb..5ed3c84ec 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -222,8 +222,18 @@ Compacted, restarted, or new? Nothing that matters is lost: this file + `git log --oneline -10` + the suites reconstruct the full state. **Never guess** — verify with the suites; the run records and logs hold the receipts. -## Version pin +## Harness versions -`@earendil-works/pi-coding-agent` is pinned exactly (see `package.json` / -`RELEASE`); never install unversioned. Release identity: `RELEASE` file -(0.0.X until declared stable); image tags derive from it. +Harness binaries are not pinned (Jason, 2026-11-19). pi runs from +`MOSAIC_PI_BIN`, else the first `pi` on PATH, else the repository's +`node_modules`. `package.json` holds a floor range, and `package-lock.json` +records the version `npm ci` installs and the worker image carries. Nothing +refuses a pi for its version. Before a session or conversation starts, a +fit check proves the flags and behaviours Mosaic needs and refuses with a +plain line when one is missing. The bus host repeats the check on a timer +and when a binary changes. The version and a digest of the files that +ran are recorded in the claim and the run record. A change under a live +claim still refuses. Never install unversioned: a lock change is a +reviewed commit that passes the fit check and the suites. Release +identity: `RELEASE` file (0.0.X until declared stable). Image tags derive +from it and the lock's resolved pi version.