Self-host M2: Spine coverage gap — inventory 606→611 (regen drift)

[PurHur]

Problem

php script/bootstrap-inventory.php now reports 611 vm.php-path files on master (May 2026 regen), while compiler_lib_spine_smoke still bundles 606 require_once units and public docs footnote 606/606. check-wave3-roadmap-sync.php fails until spine footnotes match inventory (#1802).

#2050 tracked 603→606; that batch largely landed — the remaining gap is +5 inventory files after inventory regen, not the old 603 count.

Without a focused tracker, M2 work scatters across #1492 / #1768 instead of a finish-line checklist.

Goal

php script/bootstrap-inventory.php --check          # 611 files, 0 blockers
php script/check-selfhost-spine-coverage-sync.php   # exit 0 (deferred table documented)
BOOTSTRAP_LIB_SPINE_SMOKE=1 make bootstrap-selfhost-lib-spine-smoke
php script/check-wave3-roadmap-sync.php             # spine footnotes 606/611

Scope

1. Run php script/check-selfhost-spine-coverage-sync.php --verbose — list missing paths vs deferred (bin/vm.php, lib/AOT/Linker.php, …)
2. Add require_once to test/selfhost/compiler_lib_spine_smoke/main.php via script/bootstrap-selfhost-next-includes.php (or extend spineSubstitutes / spineNativeLinkDeferred with issue links)
3. Regenerate docs/bootstrap-inventory.md, docs/roadmap-wave3.md, docs/self-host-target.md, docs/pages/development-status.md footnotes
4. Fix any native link/JIT stubs uncovered (Self-host M3: compile-driver real lowering symbol batch tracker #1768 symbol batches)

Acceptance criteria

./script/ci-fast.sh   # wave3 + spine coverage sync green
BOOTSTRAP_LIB_SPINE_SMOKE=1 ./script/bootstrap-selfhost-lib-spine-smoke.sh

Docker:

./script/docker-ci-local.sh -- php script/check-selfhost-spine-coverage-sync.php

No GitHub Actions (#394 ✅).

Dependencies

• Self-host M2: Close spine coverage gap (603→606 inventory units) #2050 — prior 603→606 batch (comment/link, do not duplicate work)
• Self-host: Single source of truth for M2 spine unit counts (584/585/586/588 drift) #1872 ✅ — bootstrap-spine-count.php SSOT
• CI: Default SELFHOST_SPINE_COVERAGE_SYNC_GATE=1 in ci-fast after #1922 spine gap closed #1955 ✅ — SELFHOST_SPINE_COVERAGE_SYNC_GATE=1 default-on
• CI: Wave 3 roadmap drift guard (docs/roadmap-wave3.md vs #1380) #1802 — wave3 roadmap sync footnotes

Links

• docs/bootstrap-inventory.md · script/check-selfhost-spine-coverage-sync.php
• Epic Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492 · ROADMAP 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 Phase 5 Self-host

[PurHur]

Audit (batch 114) — master on harness

php script/bootstrap-spine-count.php     → 606/606
php script/bootstrap-inventory.php       → 611 files, 0 blockers
php script/check-selfhost-spine-coverage-sync.php → OK
  (spine covers all 611 inventory files, 5 deferred #1960 #1922)
docs/bootstrap-inventory.md            → stale until regen (committed doc still 606-era)

Interpretation: The +5 gap is inventory growth vs 606 require_once lines in compiler_lib_spine_smoke — coverage sync already accounts for deferred paths. Finish line for this issue:

1. Regen + commit docs/bootstrap-inventory.md (611) and wave3/development-status footnotes (CI: Wave 3 roadmap drift guard (docs/roadmap-wave3.md vs #1380) #1802, Docs: development-status.md — sync 006 FileUploadWeb + NS2 M3 strict emit #2039).
2. Either add 5 spine require_once rows or extend spineNativeLinkDeferred with linked issues (preferred only if link still fails).
3. BOOTSTRAP_LIB_SPINE_SMOKE=1 native link after includes land.

Not blocked on: #2054 / #2055 (orthogonal NS2 spine work).