Self-host M2: Close compiler_lib_spine_smoke gap (589→593 inventory units)

[PurHur]

Problem

M2 spine smoke links 595 of 603 bin/vm.php inventory files (#1872 SSOT via php script/bootstrap-spine-count.php and grep -c '^require_once' test/selfhost/compiler_lib_spine_smoke/main.php). Phase A reports 0 source blockers — the remaining 8 files are a coordination gap, not unknown syntax.

Without a focused tracker, contributors grep #1419 (closed umbrella) or #1492 epic instead of a finish-line checklist.

Note (batch 92): Older comments cited 589/593; inventory grew to 603 files — always trust bootstrap-spine-count.php on master.

Goal

test/selfhost/compiler_lib_spine_smoke/main.php includes all 603 inventory units; these gates stay green:

php script/bootstrap-inventory.php --check          # 603 files, 0 blockers
php script/bootstrap-spine-count.php                # 603/603
php bin/compile.php -l test/selfhost/compiler_lib_spine_smoke/main.php
make bootstrap-selfhost-lib-spine-smoke             # native link
BOOTSTRAP_LIB_SPINE_VM_SMOKE=1 make bootstrap-selfhost-lib-spine-vm-smoke

Implementation hints

Step	Command / file	Notes
Diff	php script/bootstrap-inventory.php vs spine require_once list	Identify 8 missing paths
Batch PRs	One file or small group per PR	Label m2-spine-unit; close on merge
Blockers	lib/VM/HashTable.php, JIT builtins	May need #1514-class runtime fixes before link
Count SSOT	script/bootstrap-spine-count.php + script/check-selfhost-spine-count-sync.php	Must read 603/603 after merge
Docs	docs/self-host-target.md, docs/bootstrap-selfhost.md	M2 table row 595/603

Inventory diff (run on master — refresh each batch)

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  bash -lc 'php script/bootstrap-spine-count.php; php script/bootstrap-inventory.php --check'

Do not hard-code the 8 paths in this issue body — paste diff output into PR descriptions.

Acceptance criteria

• php script/bootstrap-spine-count.php prints 603/603
• make bootstrap-selfhost-lib-spine-smoke exits 0 in Docker (php-compiler:22.04-dev)
• check-selfhost-spine-count-sync.php green when SELFHOST_SPINE_COUNT_SYNC_GATE=1
• Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492 epic comment + ROADMAP 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 M2 row updated

Verification (local / Docker only)

make docker-build-22
docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  bash -lc 'php script/bootstrap-inventory.php --check && make bootstrap-selfhost-lib-spine-smoke'

No GitHub Actions.

Dependencies

• Self-host M2: land final 3 ext/standard Vm* units in compiler_lib_spine_smoke (578→586) #1821 ✅ — Vm* trio landed
• JIT: Self-host spine link — Struct::getElementType on __string__ pointer params #1880 ✅ — spine link JIT (JIT: session_start + String_ spine fix (#1880, #1882) #1890)
• Self-host: Single source of truth for M2 spine unit counts (584/585/586/588 drift) #1872 ✅ — count SSOT
• Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492 — parent epic
• Unblocks M3: BOOTSTRAP_M3_HELLOWORLD_STRICT — native HelloWorld emit (no Zend fallback) #1493 M3 emit (larger honest bundle)

Links

• ROADMAP #78 Phase 5
• Closed umbrella: M2 spine growth: batch tracker (compiler_lib_spine_smoke → full inventory) #1419
• Count SSOT: Self-host: Single source of truth for M2 spine unit counts (584/585/586/588 drift) #1872 ✅