Repository navigation
Self-host M4: promote lib/AOT/Linker.php in spine smoke (deferred native-link, #2134 post-link) #2514
Description
Milestone
M2/M5 — honest native execute for lib/AOT/Linker.php (parent #1492; implementation #2779)
Problem (updated May 2026)
Stale: Linker is not excluded from spine — it is require_once in compiler_lib_spine_smoke and M2 link is 717/717 ✅.
Remaining gap: honest lowering of shell_exec / link driver methods (inventory lint: 14 class methods). Spine link succeeds via PHP_COMPILER_SELFHOST_AOT stubs; M5 needs real execute or documented external-clang floor.
Scope
| Path | Work |
|---|---|
lib/AOT/Linker.php |
shell_exec, command -v, verbose link |
lib/JIT/SelfHostBuiltinPolicy.php, lib/JIT/Call/ExternalMethod.php |
Policy / runtime resolve |
| #2779 | Primary implementation issue |
Repro
./script/docker-exec.sh -- bash -lc 'php script/bootstrap-inventory.php --check'
# lib/AOT/Linker.php in Phase A inventory (717 files)
grep Linker.php test/selfhost/compiler_lib_spine_smoke/main.php
# require_once present
./script/docker-exec.sh -- bash -lc 'php bin/compile.php -l lib/AOT/Linker.php'
# warnings: class methods not lowered
BOOTSTRAP_LIB_SPINE_SMOKE=1 make bootstrap-selfhost-lib-spine-smoke
# OK via stubsGate: M2 spine smoke ✅; M5 honest link — #2779
Done when
#2779 closes (lowering or documented external floor); this tracker closed as duplicate/superseded.
Dependencies
- Self-host M2/M5: shell_exec lowering for lib/AOT/Linker.php honest native link #2779 — shell_exec lowering
- Self-host M2: BootstrapVmDriver native execute smoke (post-#2134 bin/vm.php link) #2201 — VM driver execute (orthogonal)
Epic #1492
Activity
PurHur commentedon May 27, 2026
Backlog architect update (2026-05-27 harness):
BOOTSTRAP_LIB_SPINE_SMOKE=1 make bootstrap-selfhost-lib-spine-smokeOK).lib/AOT/Linker.phpremains deferred inscript/bootstrap-spine-deferred-lib.php; spine 661/717 with 51 missing units (Self-host M2: add 51 missing Phase A units to compiler_lib_spine_smoke (coverage sync red) #2632).Revised repro:
Issue stays M4/M5 floor — document external
clang/shell_execpolicy vs promote with honest stub (#2514 scope unchanged; unblocked for evaluation).PurHur commentedon May 27, 2026
Ground truth update (2026-05-27, master, Docker): M2 spine/link is green now.
Repro evidence:
So this ticket no longer needs to wait on “M2 spine link RED due to #2573” (at least on this environment). If Linker.php is still the last deferred path, we can now scope the actual blocker by running:
./script/docker-exec.sh -- bash -lc 'php bin/compile.php -l lib/AOT/Linker.php'…and capturing the first lint/lowering error (or confirming it’s only deferred for policy reasons).