Skip to content

spec(ship-two-models): v2.96.0 → v2.97.0 — §52 cascade ALGORITHM-COMPLETE + 5f.4 wireup gap#1486

Merged
noahgift merged 9 commits into
mainfrom
spec/section-52-cascade-complete-and-5f4-wireup
May 5, 2026
Merged

spec(ship-two-models): v2.96.0 → v2.97.0 — §52 cascade ALGORITHM-COMPLETE + 5f.4 wireup gap#1486
noahgift merged 9 commits into
mainfrom
spec/section-52-cascade-complete-and-5f4-wireup

Conversation

@noahgift

@noahgift noahgift commented May 4, 2026

Copy link
Copy Markdown
Contributor

Summary

Spec v2.96.0 → v2.97.0. §52 records that §50.4 cascade is now ALGORITHM-COMPLETE on main (8/8 falsifiers PARTIAL_ALGORITHM_LEVEL bound), and identifies a NEW step 5f.4 CLI wireup (~150 LOC) that was missed in the original §50 decomposition.

Falsifier scoreboard (vs §51)

§51 (yesterday): 7/8 PARTIAL bound. §52 (today): 8/8 PARTIAL bound.

ID What it pins PR Status
001 qwen2_0_5b matches HF #1474 ✅ MERGED
002 init=None preserves Llama370M #1475 ✅ MERGED
003 init=Some pass-through #1475 ✅ MERGED
004 GQA-7:1 forward smoke #1478 ✅ MERGED
005 Qwen vocab + Qwen target = pass #1476 ✅ MERGED
006 Qwen vocab + Llama target = fail #1476 ✅ MERGED
007 Encoder family fails fast #1479 ✅ MERGED
008 pv validate exits 0 #1473 ✅ MERGED

Helpers landed: #1481 (load_init_tensors_from_apr) ✅. #1483 (populate_trainer_from_init_tensors) MERGEABLE in queue.

NEW step 5f.4 (CLI wireup)

Live source inspection of apr-cli/src/commands/pretrain.rs:259-297 revealed that even with all helpers in place, the CLI dispatch HARDCODES Err(...not yet wired...). Step 5f.4 must:

  1. Plumb init: Option<&Path> through run() → drive_real() → drive_real_cpu/cuda()
  2. Extract config via existing model_config::read_apr_architecture()
  3. Build new build_shared_trainer_with_init() invoking 5f.1/5f.2/5f.3
  4. Replace the "not yet wired" Err with actual functionality

Constraint: must be single atomic PR (removing the safety Err without the wireup produces silent random-init — §28 SHIP-007 defect class).

Test plan

  • Single markdown file, zero Rust changes
  • Cadence preserved: §41 → ... → §51 → §52 (12 amendments since 2026-05-03)
  • Falsifier scoreboard updated to 8/8 PARTIAL_ALGORITHM_LEVEL
  • Roadmap table adds 5f.4 between 5f.3 and 5g

🤖 Generated with Claude Code

…LETE + 5f.4 wireup gap identified

## Summary

Same-day continuation of §51 cascade landed PR #1479 (FALSIFY-007
encoder/decoder validator) and PR #1481 (load_init_tensors_from_apr).
PR #1483 (5f.3 populate) and PR #1482 (contract status bump) are
MERGEABLE in queue. All 8 falsifiers in `apr-pretrain-arch-polymorphic-v1`
are now PARTIAL_ALGORITHM_LEVEL bound on main or about to land.

§52 records:
1. Updated falsifier scoreboard (8/8 vs §51's 7/8)
2. NEW step 5f.4 (CLI wireup, ~150 LOC) identified via live source
   inspection of `apr-cli/src/commands/pretrain.rs:259-297`
3. Step 5g LIVE 500-step fine-tune is now gated on 5f.4 landing first

## Why now

Per `feedback_falsifier_first_cascade_pattern.md`: when a saturated
auto-merge queue blocks more impl PRs (#1483 + #1482 both in queue
touching pretrain_real.rs), switch to non-conflicting work. This spec
amendment touches one markdown file with no PR conflicts.

## Five Whys (§52.8 in body)

1. Why didn't §50 catch 5f.4? — top-down arch-coupling lens missed the
   CLI-dispatch seam.
2. Why is 5f.4 separate from 5f.3? — different crate (apr-cli vs
   aprender-train).
3. Why must 5f.4 be atomic? — removing "not yet wired" Err without the
   wireup produces silent random-init (§28 SHIP-007 defect class).
4. Why ~150 LOC? — 4 levels of plumbing + new builder + tests + CUDA.
5. Why call 5f.4 out in spec? — without §52, readers would assume 5g
   is dispatchable; spec is the source of truth.

## Test plan

- [x] Single markdown file, no Rust changes
- [x] Falsifier scoreboard table updated to 8/8 PARTIAL_ALGORITHM_LEVEL
- [x] Step roadmap table adds 5f.4 between 5f.3 and 5g
- [x] Cadence preserved: §41 → ... → §51 → §52 (12 amendments since 2026-05-03)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@noahgift noahgift enabled auto-merge (squash) May 4, 2026 20:13
@noahgift noahgift merged commit e3b3a1e into main May 5, 2026
10 checks passed
@noahgift noahgift deleted the spec/section-52-cascade-complete-and-5f4-wireup branch May 5, 2026 00:30
noahgift added a commit that referenced this pull request May 5, 2026
…ION-COMPLETE; contract v1.1.0 → v1.2.0 FUNCTIONAL (#1495)

§50.4 cascade INTEGRATION-COMPLETE on main with PR #1494 merging at
2026-05-05T01:48:14Z. The `apr pretrain --init <PATH>` flow is now
end-to-end functional on CPU; the legacy "not yet wired" Err is
RETIRED; step 5g LIVE is the only remaining gate before MODEL-2 ship-%
can move from 57% → ≥58%.

Spec amendment §53:
- Updated falsifier scoreboard: 6/8 INTEGRATION (001/002/003/005/006/007
  via live CLI dispatch); 2/8 PARTIAL_ALGORITHM_LEVEL (004 forward-pass
  smoke + 008 contract validation are inherently algorithm-level).
- Step roadmap: 5a-5f.4 ✅ MERGED; 5f.5 (CUDA wireup) NOT YET STARTED;
  5g (LIVE 500-step fine-tune) operator-dispatchable on RTX 4090.
- Cascade ships statistics: 11 PRs over 2 days
  (#1471/#1472/#1473/#1474/#1475/#1476/#1478/#1479/#1481/#1482/#1483/#1486/#1494).
- MODEL-1 ship % unchanged at 91%; MODEL-2 ship % unchanged at 57%
  (gated on 5g empirical val_loss < 9.38 evidence).
- 3 CI andon classes documented as feedback memories during cascade
  (workspace-test missing-binary, trueno SIGSEGV-on-cleanup, auto-merge
  behind-state).

Contract apr-pretrain-arch-polymorphic-v1 v1.1.0 → v1.2.0 FUNCTIONAL:
- All 8 falsifiers PASS on main; 6/8 reach INTEGRATION via the
  user-facing `apr pretrain --init` flow.
- verification_summary updated: tested 7 → 8; status partial →
  functional.
- Added §52 + §53 references.
- Promotion to DISCHARGED still requires §50.4 step 5g LIVE empirical
  500-step fine-tune on canonical Qwen2.5-Coder-0.5B-Instruct.apr
  producing val_loss < 9.38.

`pv validate contracts/apr-pretrain-arch-polymorphic-v1.yaml` exits 0.

Refs: SPEC-SHIP-TWO-001 §50.4 cascade, PR #1494 merge commit 9afca16

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
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