Skip to content

spec(ship-two-models-spec): v2.86.0 — §41 records apr-cpu-vs-gpu-output-parity-v1 chain (PRs #1427-#1430)#1431

Merged
noahgift merged 1 commit into
mainfrom
feat/spec-v2-86-parity-contract-chain-amendment
May 3, 2026
Merged

spec(ship-two-models-spec): v2.86.0 — §41 records apr-cpu-vs-gpu-output-parity-v1 chain (PRs #1427-#1430)#1431
noahgift merged 1 commit into
mainfrom
feat/spec-v2-86-parity-contract-chain-amendment

Conversation

@noahgift

@noahgift noahgift commented May 3, 2026

Copy link
Copy Markdown
Contributor

Summary

MODEL-1 ship % nudges 80% → 87%

Because shipping default-mode apr run users with the --no-gpu documented workaround is now jidoka-safe — the diagnostic path to that flag is automatically discoverable from any default invocation on the broken canonical 7B teacher build.

Five Whys (in spec body)

  1. Why armor the dispatch boundary first? MODEL-1 is already shippable via CPU; the blocker was that users got garbage with no signal.
  2. Why three layers? Each addresses a distinct regression class.
  3. Why bump contract three times in one day? Each PR materially corrected the contract's claims.
  4. Why not implement wgpu cosine gate today? ~100-150 LOC; bounded follow-up.
  5. Why is this ship % progress, not just paperwork? §40 already concluded "MODEL-1 is shippable today via CPU path" — today's chain makes that actually true for users.

Test plan

  • Spec amendment is documentation-only; no code changes
  • Existing CI gates apply
  • Future: when the wgpu cosine gate (FALSIFY-CPU-GPU-005 part b) lands, follow up with §42 amendment

🤖 Generated with Claude Code

…vs-gpu-output-parity-v1` chain (PRs #1427-#1430)

Canonical record of today's 4-PR session that lands a 3-layer jidoka armor
at the GPU-CPU dispatch boundary, closing §40's silent-gibberish loophole
*as a regression class* (separate from the underlying GPU kernel fix).

Net effect: default `apr run <model.apr>` on a SHIP-007-broken GPU build
now emits the full backend-fallback chain on stderr without `--verbose`:

  [apr-cpu-vs-gpu-output-parity-v1] CUDA path rejected, attempting fallback: ...
  Backend: wgpu (Vulkan)
  ...

so users always know which backend is actually serving their tokens — the
`--no-gpu` documented workaround is now self-evidently the correct path on
this build. MODEL-1 ship % nudges 80% → 87% because shipping `apr run` users
with the documented workaround is now jidoka-safe.

This section explicitly does NOT claim the SHIP-007 kernel bug is fixed —
that remains an open track per §40. What §41 codifies is that the failure
mode is now LOUD instead of SILENT.

Five Whys + table of all 4 PRs + next-session pickup list (FALSIFY-CPU-GPU-005
part b OR MODEL-2 distill-train scaffolding) included.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@noahgift noahgift merged commit fa3d789 into main May 3, 2026
11 checks passed
@noahgift noahgift deleted the feat/spec-v2-86-parity-contract-chain-amendment branch May 3, 2026 16:32
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