git:20260903.910585f to git:20260909.2de0a59

+ description: Migrate an existing harness/espalier install to the current Espalier version — auto-detects which of v0.1→v0.2, v0.3→v0.4, v0.4→v0.5, the v0.5.3 coder-agent patch, v0.5→v0.6 (Stage 1 grill), v0.6→v0.7 (read-only /espalier-ask lane), v0.7→v0.8 (requirements approval gate), the v0.8.1 impact-analysis agent patch, the v0.8.2 re-review fixpoint loop, the v0.9.0 security audit, the v0.9.1 configurable escalation caps, the v0.9.2 correctness patch, the v0.9.3 skill-clarity patch, the v0.9.4 security-skill patch, the v0.9.6→v0.10.0 push-gate reshape, the v0.10.0→v0.11.0 hook exit-code release, the v0.11.0→v0.12.0 grill blind-spot pass (Stage 1 rules/wiki cross-check), the v0.12.0→v0.13.0 minimalism release (coder Solution Selection Ladder + reviewer advisory Minimalism Review), the v0.13.0→v0.13.1 polish patch (stage-conditional coding guidance + reviewer step-7 abuse-test duty + code-review gate line), the v0.13.1→v0.13.2 readability release (coder clarity-then-brevity tie-break + comment-convention discovery + reviewer advisory Readability Review with the cryptic-public-name P1), the v0.13.2→v0.14.0 Codex platform release (platform-neutral hook wrappers + optional .agents/skills + AGENTS.md + .codex wiring), the v0.14.0→v0.15.0 Copilot platform release (camelCase hook adapter + optional .github/skills + copilot-instructions + .github/agents + .github/hooks wiring), the v0.15.0→v0.16.0 multi-dev maintenance floor (conv_fold conventions reader + maintenance lanes + canonical-ref keys + .gitattributes union entry + optional CODEOWNERS), the v0.16.0→v0.17.0 B-team release (weekly gardener rota + tracked single-line .doctor-stamp with clean/dirty semantics + conventions file-per-key), the v0.17.0→v0.18.0 map-lane release (/espalier-map multi-session planning + map-guard plan-don't-do hook + grill decision mode + greenfield decide-then-bind init), the v0.18.0→v0.19.0 run-lane release (/espalier-maprun map executor — interactive master + headless stage-1–6 workers in push-blocked worktrees + the maprun state engine), the v0.19.0→v0.20.0 slice-PR release (opt-in maprun-pr.sh forge surface — one reviewable slice PR per ticket + final assembly PR + the worktree-scoped push-block fix), and the v0.20.0→v0.21.0 pipeline-speed release (per-change context pack reused by every spawn + delta-scoped re-review rounds + parallel disjoint sub-tasks + push-target pre-authorization + light-tier grill batching — same gates, fewer redundant reads and waits), the v0.21.1 comment-brevity patch (coder/reviewer/coding-standards gain a short-comments default — one plain line, project conventions still outrank it), and the v0.21.1→v0.22.0 pipeline-speed release (speculative Stage 5 — the test-coder rides the round-1 panel, quarantine-on-FAIL keeps every later gate tree clean — + Stage 6 delta re-review rounds + stage-duration stats + the non-critical pre-flight fold + Stage 9 deploy pre-authorization + the Stage 8 CI wait protocol + opt-in parallel push-gate sections and a dependency-audit cache — same gates, fewer waits), and the v0.22.0→v0.22.1 comment-diet patch (coder/reviewer/coding-standards move to a default-NO-comment stance — one plain line only for what the code cannot show; project conventions still outrank it), and the v0.22.1→v0.23.0 round-economy release (the Stage 3/5 fold — tests ride the coder under `test-mode: folded`, the Stage 3 exit gate runs build+lint+scoped tests, the 2-agent panel reviews code+tests in one verdict, Stages 5/6 become the security-contract phase or SKIPPED rows with stage numbers intact; contract-FAIL code fixes route back to a full panel; findings digest + map crispness gate + grill tier verdicts; the speculative dispatch is retired and `test-mode: serial` keeps the pre-v0.22 flow), and the v0.23.0→v0.23.1 class-sweep patch (fix rounds fix the defect CLASS — the coder enumerates and fixes every in-scope sibling of each P0/P1 and reports a `### Class Sweep` block that both panel agents re-verify; `FIX ROUND {n}:` header on every Stage 4 re-spawn), and the v0.23.1→v0.24.0 simplify-lane release (/espalier-simplify — a read-only, evidence-first simplification survey of the existing code that files proven cuts as refactor skeletons the pipeline runs; the coder retires the whole boundary, the reviewer re-proves every retired name, and Completion flags the docs that described it for /espalier-prune), and the v0.24.0→v0.25.0 quality-first context release (every agent works with its instructions at full strength on current inputs, no budget anywhere — coders hand off at clean points with a cited `## Handoff`, the orchestrator archives prior reports to `coding-log/`, offers a fresh session at the Stage 2 / Stage 4 boundaries, runs the exit gate as one `exit_gate` call, extracts the security contract, and names Grep-only files and scoped docs in the pack; the grill's code reads are unlimited; rules get a Writing Contract, a Removed-rules ledger at the prune gate, a doctor contract-drift line, and a `## Not Precedent` anchor; `espalier-stats.sh` reports spawn shape) you need and applies them in order.

+ version. Up to THIRTY-FIVE migrations may apply, always in this order:

+ 35. **v0.24.0 → v0.25.0** — quality-first context release. Every gate,

+ rubric, sentinel, round cap, and escalation path is contract-equal to

+ v0.24.0; NOTHING sets a budget or refuses on size. The coder gains the

+ Handoff protocol (finish bounded work at a clean point — build green,

+ report written fresh with a `## Handoff` block whose Facts carry

+ `path:line`, sentinel `- HANDOFF: true`; the orchestrator archives the

+ report and re-spawns a fresh coder with a `CONTINUATION:` line — the

+ panel still reviews the combined diff once), the Docs clause (edit the

+ false claim in place, one line), read-once / Grep-only / Scoped-docs

+ reading lines, the `- Spec applied:` report line (the reviewer opens the

+ cited section; `[spec-unread]` is an advisory row), report hygiene under

+ overwrite semantics, and the rules reword lines (auto-loaded on Claude

+ Code). The reviewer gains the same reading lines, the spec-citation

+ check, one-row advisory findings (no count), the `docs:` tag; the

+ security agent the reading lines + Read-tool evidence. The orchestrator

+ (espalier + fix SKILLs, pure-copy): sentinel → archive (`report_archive`

+ into `coding-log/`, so `coding-report.md` is always the CURRENT spawn's

+ report) → `exit_gate` (build + lint concurrent, scoped tests, from the

+ installed pre-push gate's own `run_*` bodies; exit 2 / 3 = by hand as

+ before) → continuation; the context pack gains `- Facts established:`,

+ `- Grep-only:` (`grep_only_files`, from the new `grep-only-paths:`

+ config key) and `- Scoped docs:` (`scoped_docs`); `contract_extract`

+ writes `security-contract.md` for the Stage 5/6 spawns; a stage-boundary

+ offer after Stage 2 approval and after the Stage 4 PASS (`Continue here`

+ / `Continue in a fresh session`, never unattended) and a `RESUMED` row on

+ resumption; `req_shape_check` prints requirement headings outside the

+ contract set (information only). Requirements are contract + notes

+ (`requirements-notes.md`; the `≤ 5 files` rule becomes a sizing

+ paragraph); the grill's code reads are unlimited (map lane too). Rules:

+ Writing Contract in `.scout-prompts.md`, Removed-rules ledger

+ (`rule_bullets` + `comm`) at the prune gate, doctor `contract drift`

+ line (`contract_drift_lines`), `## Not Precedent` anchor in

+ `engineering-structure.md` refreshed from scout 1.2's `not_precedent`

+ array. `espalier-stats.sh` gains spawn shape + workspace docs;

+ `maprun.py` parses stage names by a literal `### N. ` (the `8.5` heading

+ no longer overwrites stage 8) with fallback labels. Refreshes 15 pure

+ copies (backups `.pre-v0.25.bak`, gitignored as `*.pre-v0.*.bak` from

+ now on); anchored edits EXTRACTED from the templates for the three agent

+ bodies, the testing SKILL, `agent.md`, `engineering-structure.md`

+ (customised files skip-with-record; already-reworded lines no-op);

+ appends `grep-only-paths:`; prints report-only lines (requirement shape

+ per IN_PROGRESS change, rules contract drift) and edits no rule or

+ requirement. The `/espalier` skill becomes a ROUTER: each stage's

+ procedure is a pure-copy file under `espalier/skills/espalier/stages/`

+ (`1-2-requirements`, `3-coding`, `4-panel`, `5-6-contract`,

+ `7-10-delivery`) read at stage entry; `pipeline.md` becomes the stage

+ CONTRACT (trigger / load / gate / output / limit + a Procedure line per

+ stage, eleven headings frozen; the maintenance conflict recipes move to

+ `/espalier-prune`); the agents' mode-only sections (coder Fix Rounds +

+ Simplification Changes; reviewer Re-review Rounds + Simplification Review

+ + Security Abuse-Test Coverage; security Re-review Rounds + Repo-Audit

+ Mode) become heading + one-line pointer in the body and live verbatim in

+ `espalier/agents/modes/{fix-round, simplification, re-review, repo-audit,

+ stage6-abuse-coverage}.md`, named first on the mode prompt lines (`FIX

+ ROUND {n}: read espalier/agents/modes/fix-round.md first …`). Commit

+ Discipline: the coder commits one bounded unit per commit at a clean

+ point (message per `development-process.md` → Commit Conventions,

+ staged by path, never under PARALLEL DISPATCH — the orchestrator commits

+ each part after the wave), lists them under `- Commits:`; Stage 7 commits

+ only what is left, by path, never squashes, and records every commit in

+ `Base-Ref..HEAD`; the reviewer's advisory `commits:` tag; the fix lane's

+ late-escalation revert covers the range; `development-process.md` gains

+ the atomic-commits bullet in its managed block. Validation

+ checks 64 `context-helpers`, 65 `spawn-protocols`, 66 `stage-procedures`;

+ totals 56 / 61 / 66 by platform set.

+ Mechanical: `scripts/migrate-v0.24.0-to-v0.25.0.sh`.

+ confirmation, apply in order. A v0.1.x install needs ALL THIRTY-FIVE; a v0.3.x

+ install needs the last thirty-four; a v0.4.x install needs the last thirty-three; a

+ v0.5.0–v0.5.2 install needs the v0.5.3 patch then v0.6 … v0.25.0; a

+ v0.5.3–v0.5.x install needs v0.6 … v0.25.0; a v0.6.x install needs

+ v0.7 … v0.24.0; a v0.7.x install needs v0.8 … v0.25.0; a v0.8.0 install needs

+ v0.8.1 … v0.24.0; a v0.8.1 install needs v0.8.2 … v0.25.0; a v0.8.2 install

+ needs v0.9.0 … v0.24.0; a v0.9.0 install needs v0.9.1 … v0.25.0; a v0.9.1

+ install needs v0.9.2 … v0.25.0; a v0.9.2 install needs v0.9.3, v0.9.4,

+ v0.10.0, v0.11.0, v0.12.0, v0.13.0, v0.13.1, v0.13.2, v0.14.0, v0.15.0, v0.16.0, v0.17.0, v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.9.3 install

+ needs v0.9.4, v0.10.0, v0.11.0, v0.12.0, v0.13.0, v0.13.1, v0.13.2, v0.14.0, v0.15.0, v0.16.0, v0.17.0, v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a

+ v0.13.1, v0.13.2, v0.14.0, v0.15.0, v0.16.0, v0.17.0, v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.10.0 install needs v0.11.0, v0.12.0, v0.13.0,

+ v0.13.1, v0.13.2, v0.14.0, v0.15.0, v0.16.0, v0.17.0, v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.11.0 install needs v0.12.0, v0.13.0, v0.13.1,

+ v0.13.2, v0.14.0, v0.15.0, v0.16.0, v0.17.0, v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.12.0 install needs v0.13.0, v0.13.1, v0.13.2, v0.14.0, v0.15.0,

+ v0.16.0, v0.17.0, v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.13.0 install needs v0.13.1, v0.13.2, v0.14.0, v0.15.0, v0.16.0, v0.17.0, v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.13.1

+ install needs v0.13.2, v0.14.0, v0.15.0, v0.16.0, v0.17.0, v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.13.2 install needs v0.14.0,

+ v0.15.0, v0.16.0, v0.17.0, v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.14.0 install needs v0.15.0,

+ v0.16.0, v0.17.0, v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.15.0 install needs v0.16.0, v0.17.0, v0.18.0,

+ v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.16.0 install needs v0.17.0, v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a

+ v0.17.0 install needs v0.18.0, v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.18.0 install needs

+ v0.19.0, v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.19.0 install needs v0.20.0, v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.20.0 install needs v0.21.0, v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.21.0 install needs v0.21.1, v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.21.1 install needs v0.22.0, v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.22.0 install needs v0.22.1, v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.22.1 install needs v0.23.0, v0.23.1, v0.24.0, then v0.25.0; a v0.23.0 install needs v0.23.1, v0.24.0, then v0.25.0; a v0.23.1 install needs v0.24.0 then v0.25.0; a v0.24.0 install needs only v0.25.0.

+ NEEDS_V0250_PATCH=no

+ NEEDS_V0250_PATCH=yes # ...then the v0.25.0 quality-first context release

+ || grep -qsF "$1" espalier/agents/modes/*.md 2>/dev/null \

+ || grep -qF "v0.21.0-$3" espalier/.migrations-skipped 2>/dev/null; } # v0.25+: mode text lives in espalier/agents/modes/

+ || ! { grep -qF 'Stage 4 → Stage 5 handoff' espalier/skills/espalier/SKILL.md 2>/dev/null \

+ || grep -qF 'Stage 5/6 (folded)' espalier/skills/espalier/SKILL.md 2>/dev/null; } \

+ || grep -qsF "$1" espalier/agents/modes/*.md 2>/dev/null \

+ || grep -qF "v0.23.1-$3" espalier/.migrations-skipped 2>/dev/null; } # v0.25+: mode text lives in espalier/agents/modes/

+ # v0.25.0: quality-first context. Probe = the grep-only-paths key AND the

+ # scoped_docs helper (the two surfaces every install gains) plus the coder

+ # Handoff section; keep in sync with migrate-v0.24.0-to-v0.25.0.sh's own

+ # idempotency check (labels are v0.25.0-*; skip records count as handled).

+ ok250() { grep -qF "$1" "$2" 2>/dev/null \

+ || grep -qF "v0.25.0-$3" espalier/.migrations-skipped 2>/dev/null; }

+ if ! grep -q '^grep-only-paths:' espalier/.espalier-config 2>/dev/null \

+ || ! grep -qF 'scoped_docs()' espalier/hooks/drift-helpers.sh 2>/dev/null \

+ || ! grep -qF 'HANDOFF: true' espalier/skills/espalier/SKILL.md 2>/dev/null \

+ || ! grep -qF 'stages/3-coding.md' espalier/skills/espalier/SKILL.md 2>/dev/null \

+ || [ ! -f espalier/skills/espalier/stages/3-coding.md ] \

+ || [ ! -f espalier/agents/modes/fix-round.md ] \

+ || ! grep -qF 'HANDOFF: true' espalier/skills/espalier-fix/SKILL.md 2>/dev/null \

+ || ! grep -qF 'Spawn shape (per change)' espalier/hooks/espalier-stats.sh 2>/dev/null \

+ || ! ok250 '## Handoff: Finish Bounded, Hand Off Clean' espalier/agents/harness-coder.md coder-handoff \

+ || ! ok250 '[spec-unread]' espalier/agents/harness-reviewer.md reviewer-spec \

+ || ! ok250 '7. Scoped docs named in the pack' espalier/agents/harness-security.md security-before; then

+ NEEDS_V0250_PATCH=yes

+ fi

+ && [ "$NEEDS_V0240_PATCH" = no ] && [ "$NEEDS_V0250_PATCH" = no ]; then

+ && [ -f "${CLAUDE_SKILL_DIR}/../../scripts/migrate-v0.24.0-to-v0.25.0.sh" ]; then

+ if [ -f "$candidate/scripts/migrate-v0.24.0-to-v0.25.0.sh" ]; then

+ is likely stale (no `migrate-v0.24.0-to-v0.25.0.sh`) — tell the user to

+ [ "$NEEDS_V0250_PATCH" = yes ] && bash "$PLUGIN_DIR/scripts/migrate-v0.24.0-to-v0.25.0.sh" --dry-run --plugin-dir="$PLUGIN_DIR"

+ [ "$NEEDS_V0250_PATCH" = yes ] && bash "$PLUGIN_DIR/scripts/migrate-v0.24.0-to-v0.25.0.sh" --yes --plugin-dir="$PLUGIN_DIR"