wave-8 decomposition — the release-readiness pass: eleven tasks (seven independent entries: frontmatter cleanup — 11 docs with invalid YAML frontmatter, the renumber sweep, crate docs, the class-1 window's last dispositions, N-1, Findings 2-3, the fired-trigger flake investigation; then deployment matrix -> README -> publish prep -> review-wave-8 gate); plan wave-8 row + task set + review-rounds entry

tasks/review-wave-8.md

@@ -0,0 +1,94 @@
+---
+id: review-wave-8
+name: Review gate — wave 8 (release readiness)
+status: pending
+depends_on: [docs-frontmatter-cleanup, release-renumber-sweep, release-crate-docs, release-contract-window-close, release-n1-growth-posture, release-findings-2-3-disposition, release-flake-investigation, release-deployment-matrix, release-readme, release-publish-prep]
+scope: broad
+risk: low
+impact: project
+level: review
+tags: [wave-8, review-gate]
+---
+
+## Description
+
+The wave-8 review gate (the plan's §Review gates pattern; the
+pre-release gate). Audit the release-readiness pass as landed:
+
+1. **Docs honesty audit**: the README's claims traced to specs (the
+   readme task's trace list re-verified by spot-read); the deployment
+   matrix's rows read true as implemented across the three engines;
+   the crate docs' posture claims consistent with the matrix; the
+   env-boundary sentence present and the grep result current.
+2. **Contract-window closure audit**: every wave-6 recorded
+   observation disposed (wake-ordering decision landed per the
+   user's call; the ADR-023 §2 classifications; the `try_recv` shape;
+   the `get_job` prose; the mem-arithmetic disposition); every landed
+   amendment dated + cited; **the class-1 window's termination
+   recorded** — ADR-017 §2's "terminates permanently at the core
+   crate's first release" becomes a fact at this gate: the record
+   states the window closes with the first publish, and no
+   undisposed class-1 candidate remains.
+3. **N-1 + Findings 2–3 dispositions audited**: the growth-posture
+   acceptance is a decision of record (not a shrug); the findings'
+   landed-vs-parked dispositions recorded so the inventory is closed.
+4. **Flake-watch outcome audited**: the investigation's conditions
+   matrix + disposition read; if a follow-up fix task was created, its
+   status is visible (a live engine bug blocks the release blessing —
+   the gate says so explicitly rather than publishing over it).
+5. **Publish-prep audit**: `cargo package` evidence per crate; the
+   exclusion verification re-run this session (file lists of the
+   built `.crate`s — no fuzz/sidecar/suite leakage); the publish
+   checklist of record complete and mechanical.
+6. **Frontmatter + records hygiene**: the parse sweep re-run (zero
+   invalid frontmatters under `docs/`); the renumber sweep's
+   disposition list spot-checked (stale wave-7 references gone or
+   annotated; genuine fuzz-wave references intact).
+7. **All gates re-run green this session**: `cargo build`, `cargo
+   test`, `cargo clippy --all-targets -- -D warnings`, `cargo fmt
+   --check`, the fuzz corpus-replay gate, the wasm32 check, and the
+   doc gate (`cargo doc --no-deps` warning-free).
+8. **Spec flips + records**: the remaining `draft` architecture docs
+   (core-contract.md, overview.md, queues.md, deployment.md, the
+   architecture README) flip to `stable` with dated gate annotations —
+   the release-facing spec set is stable at the gate, mirroring the
+   wave-5/6 engine-spec flips; `docs/architecture/README.md`'s Current
+   State refreshed (waves 6–8); `implementation.md`'s wave-8 row
+   updated + a review-rounds entry; task files audited (all wave-8
+   dependencies completed, Notes/Summary filled).
+
+## Acceptance Criteria
+
+- [ ] Docs honesty audit recorded (README traces, matrix rows, crate
+      docs, env boundary)
+- [ ] Contract-window closure audited; the class-1 termination record
+      landed; no undisposed class-1 candidate remains
+- [ ] N-1 + Findings 2–3 dispositions audited as decisions of record
+- [ ] Flake-watch outcome audited; any follow-up task's blocking
+      status stated explicitly
+- [ ] Publish-prep audit recorded (package evidence + exclusion
+      re-run + checklist complete)
+- [ ] Frontmatter parse sweep + renumber-sweep spot-check green
+- [ ] All gates re-run green this session (incl. fuzz replay + wasm +
+      doc gates)
+- [ ] Spec flips + records landed; `implementation.md` updated; task
+      files audited
+
+## References
+
+- docs/plans/implementation.md §Wave 8, §Review gates
+- docs/architecture/decisions/017-contract-versioning.md §2 (the
+  window termination this gate records)
+- tasks/review-wave-5.md §Notes 6 (the flake ledger)
+- tasks/review-wave-6.md §Recorded findings (the dispositions this
+  gate audits)
+- tasks/review-wave-7.md (the parked exclusion verification)
+- tasks/review-wave-5.md / tasks/review-wave-6.md (the gate pattern)
+
+## Notes
+
+> To be filled by implementation agent
+
+## Summary
+
+> To be filled on completion