core/docs/plans
Shay f9e9cc0c6a fix(evals): the deduction lane hashes the prose it serves
The pinned artifact carried verdict counts only. The runner's docstring
justified that: prose is "presentation, not decision", so the pinned bytes
"stay stable against wording-only changes; wording is covered by
tests/test_deduction_surface.py."

Measured, that justification was false. With render._display_noun sabotaged
so every clause reads "all SABOTAGE_dogs are SABOTAGE_animals":

  11 lane SHA pins                     -> 11/11 byte-identical, blind
  test_deduction_serve_lane + _license -> 20 passed, blind
  tests/test_deduction_surface.py      -> 41 passed, blind
                                          (the named wording guard)
  evals/grammar_roundtrip              -> RED, the only witness

So CORE's user-visible output was unguarded by its own hash pins, which is
how the ratified v1b band served "all dog are mammal" for the entire arc
with wrong=0 intact.

build_report now emits surface_sha256 + per-case surfaces from the real
deduction_grounded_surface — the same call chat serving makes, so what is
hashed is what a user reads. Note build_combined_report re-projects five
named fields per split, so a field added to build_report alone never reaches
the pinned bytes; both had to change. The payload is not the report.

Surfaces are recorded, not just digested, so a moved pin shows the exact
sentence that changed in review instead of an opaque hash to go re-derive.
2,766 -> 37,280 bytes.

  deduction_serve_v1 under sabotage: BEFORE byte-identical (blind)
                                     AFTER  52370b73 vs c855d55c (RED)

Re-pinned surgically, one line, old hash recorded beside it, never --update.
Verdicts untouched: 166/166 correct, wrong=0. The hash moved because the
payload grew.

test_surface_hash_moves_when_the_renderer_is_sabotaged makes it permanent:
it corrupts the renderer, requires a digest to move, AND asserts the
aggregate counts are unchanged — proving the digest tracks PROSE rather than
smuggling in a decision change. A pin that cannot fail guards nothing.

Accepted cost: wording-only changes now move this pin. That is the intent —
a wording change IS a user-visible change and should require a deliberate
re-pin. The other 10 lanes are untouched; deduction_serve was fixed because
it is the one demonstrably serving prose to users.

[Verification]: in-worktree on CPython 3.12.13, uv sync --locked —
smoke 621 unchanged; deductive 405 (403 + 2 new);
scripts/verify_lane_shas.py 11/11 with the new pin, and 10/11 (RED on
deduction_serve_v1) under the sabotage it previously could not see.
2026-07-26 19:45:48 -07:00
..
adr-0241-0242-mastery-close-status.md docs(adr-0243): commit ADR-0243 + implementation plan, pin sketch defects 2026-07-16 21:53:20 -07:00
adr-0241-0242-session-completion-summary-2026-07-15.md docs(governance): RATIFY — ADR-0241 and ADR-0242 → Accepted (Joshua Shay, 2026-07-15) 2026-07-15 15:25:47 -07:00
adr-0241-cohesion-mastery-plan-p0-p12.md docs(plans): archive Plan A/B + session completion summary (W2) 2026-07-15 12:49:00 -07:00
adr-0242-drive-complete-plan-d0-d10.md docs(plans): archive Plan A/B + session completion summary (W2) 2026-07-15 12:49:00 -07:00
adr-0243-implementation-plan.md docs(adr-0243): Phase 3 lane brief pack (A/B/C) + correct stale readback-rules claim 2026-07-17 06:48:33 -07:00
audio-compiler-eval-plan.md
audio-compiler-spec.md
capability_roadmap.md
core-general-advancement-plan.md
curriculum-license-loop-2026-07-25.md docs(arc): reconcile the arc's records with what the units measured 2026-07-26 12:33:30 -07:00
DEMO-PACKAGING-CHECKLIST.md
formation_pipeline_plan.md
generalization-arc-2026-07-24.md docs(arc): reconcile the arc's records with what the units measured 2026-07-26 12:33:30 -07:00
grammar-unification-2026-07-26.md fix(evals): the deduction lane hashes the prose it serves 2026-07-26 19:45:48 -07:00
PUBLIC-DEMO-ROADMAP.md
vision-compiler-eval-plan.md
vision-compiler-spec.md