Skip to content

ADR-0203 stage V: campaign retrospective — docs, bench record, lesson, debt reconcile#142

Merged
chaploud merged 2 commits into
mainfrom
develop/aot-campaign-v-retro
Jul 9, 2026
Merged

ADR-0203 stage V: campaign retrospective — docs, bench record, lesson, debt reconcile#142
chaploud merged 2 commits into
mainfrom
develop/aot-campaign-v-retro

Conversation

@chaploud

@chaploud chaploud commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Close-out of the AOT-full-fidelity campaign (ADR-0203, stages 1-5 = PRs #137-#141).

  • ADR-0203 Status → Implemented (aot-diff 63/63 incl. cache lanes; D-508/515(1)/516/517/518/519 closed; residual = D-515(2) spec-assert corpus under elision, tracked in debt.yaml).
  • docs/reference/cli.md: --cache / --cache-clear rows; stale claims fixed (.cwasm runs are now sandboxed through the full runtime; artifact no longer described as "v0.1"; cache/engine interaction documented). README CLI block gains the --cache lines.
  • Behavior fix: explicit .cwasm + --engine interp is a contradictory request (the artifact IS JIT code) — now a loud exit-2 refusal instead of silently running the JIT, with an aot-diff E2E probe. --engine interp --engine jit last-flag-wins preserved (DA critique SpecTec changes detected (2026-W12) #10 finding, E2E-verified exit 42).
  • bench/results/history.yaml: per-merge record on the feature branch — campaign parity vs the 2026-07-06 pre-campaign entry (worst +1.2%, median -7.9%).
  • Lesson: failure-path-tests-certified-the-defect — the stage-5 unit test asserted the D5 violation it should have caught; enumerate an invariant's failure modes red-first.
  • handover.md rewritten to the campaign-closing state (117 lines, within cap).

DA critique #10: 18/20 → both findings (handover debt-count self-contradiction, engine last-flag-wins) fixed in this commit.

Tests

zig build test green · zig build lint -- --max-warnings 0 green · test-aot-diff 63/63 (cache lanes + interp-bypass + refusal probes) — re-run after the rebase onto the #141 merge.

https://claude.ai/code/session_01F2PGseEjGFR1uqid4FaXsm

chaploud added 2 commits July 9, 2026 23:42
… lesson, debt reconcile

Campaign close-out (stages 1-5 = PRs #137-#141):

- ADR-0203 Status -> Implemented (aot-diff 63/63 incl. cache lanes;
  D-508/515(1)/516/517/518/519 closed).
- docs/reference/cli.md: --cache/--cache-clear rows; stale claims fixed
  (.cwasm now sandboxed + full-runtime, artifact no longer "v0.1",
  cache/engine interaction); README CLI block gains --cache lines.
- Explicit `.cwasm` + `--engine interp` is now a loud exit-2 refusal
  (contradictory request: the artifact IS JIT code; D-496 spirit) with
  an aot-diff E2E probe.
- bench/results/history.yaml: per-merge record on the feature branch
  (campaign parity: worst +1%, median -8% vs pre-campaign entry).
- Lesson: failure-path-tests-certified-the-defect (DA critique found the
  stage-5 unit test asserting the D5 violation it should have caught).
- handover.md rewritten to the campaign-closing state (118 lines).

Remaining campaign residual: D-515(2) spec-assert corpus under elision
(harness memory provisioning), tracked in debt.yaml.

Claude-Session: https://claude.ai/code/session_01F2PGseEjGFR1uqid4FaXsm
…ase, ADR-0156)

Release directed by the user 2026-07-09 ("campaign Vが終わったら、タグを
切ってリリースしてください"): after this PR merges, the v2.2.0 tag on the
merge commit triggers release.yml (auto-build + Release + Latest).

Claude-Session: https://claude.ai/code/session_01F2PGseEjGFR1uqid4FaXsm
@chaploud
chaploud merged commit cf5d20d into main Jul 9, 2026
5 checks passed
@chaploud
chaploud deleted the develop/aot-campaign-v-retro branch July 9, 2026 15:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant