Self-host M3: inventory emit driver for unit probes (retire *_m3_emit_native_entry.php)

[PurHur]

Category

bootstrap

Milestone

M3 (emit) / M5 (honest Compiler CFG) — parent #1492. Related #3024, cleanup #3032.

Problem (updated 2026-05-30)

BOOTSTRAP_M3_USE_INVENTORY_EMIT_DRIVER=1 + strict probes:

Probe	Status	Log line
HelloWorld	✅	inventory compile_driver (no emit-helper TU, #2843)
Compiler unit strict	✅	inventory compile_driver (no emit-helper TU, #2879)
Compile smoke strict	✅	same
Runtime smoke strict	✅	same
JIT unit strict	❌	still jit_unit_probe_m3_emit_native_entry.php (#3026)

Remaining: wire JIT unit probe to inventory compile_driver.php, then delete dead *_m3_emit_native_entry.php files (#3032).

php-src reference

N/A (self-host bootstrap). Compiler spine must compile via native AOT without Zend — see docs/bootstrap-selfhost.md.

Repro (remaining failure)

./script/docker-exec.sh -- bash -lc '
  export BOOTSTRAP_M3_USE_INVENTORY_EMIT_DRIVER=1
  ./script/bootstrap-selfhost-jit-unit-probe.sh 2>&1 | tail -30
'

Expected: log contains inventory compile_driver (no jit_unit_probe_m3_emit_native_entry.php).
Actual: falls back to legacy emit-helper TU path; probe may pass via stub bridge but M5 honesty gate stays yellow.

Strict inventory check:

./script/docker-exec.sh -- bash -lc '
  export BOOTSTRAP_M3_USE_INVENTORY_EMIT_DRIVER=1
  make bootstrap-selfhost-jit-unit-probe 2>&1 | grep -E "inventory compile_driver|m3_emit_native_entry"
'

Scope (this repo)

Area	Path	Action
JIT inventory driver	lib/JIT.php	Route jit-unit probe through same inventory emit driver as helloworld
Probe script	script/bootstrap-selfhost-jit-unit-probe.sh	Stop requiring jit_unit_probe_m3_emit_native_entry.php
Inventory fixture	test/selfhost/jit_unit_probe/compile_driver.php	Emit driver entry for unit probe
Cleanup	#3032	Delete *_m3_emit_native_entry.php after all probes green

Done (verify, do not regress)

• lib/JIT.php inventory driver for helloworld + unit + smoke probes
• Probe scripts mirror bootstrap-selfhost-helloworld-probe.sh

Done when

• JIT unit strict probe uses inventory compile_driver.php (no emit-helper TU)
• make bootstrap-selfhost-jit-unit-probe green with BOOTSTRAP_M3_USE_INVENTORY_EMIT_DRIVER=1
• Self-host M3/M5: delete retired *_m3_emit_native_entry.php after inventory emit driver green #3032 unblocked — grep CI finds zero *_m3_emit_native_entry.php references in probe scripts
• ./script/ci-local.sh bootstrap M3 gates unchanged or improved

Verification

./script/docker-exec.sh -- bash -lc '
  export BOOTSTRAP_M3_USE_INVENTORY_EMIT_DRIVER=1
  make bootstrap-selfhost-jit-unit-probe
  make bootstrap-loop-probe
'

Dependencies

• Self-host M3: JIT unit probe strict — inventory compile_driver (retire jit_unit_probe_m3_emit_native_entry) #3026 — JIT unit inventory driver wiring (may be duplicate slice — coordinate)
• Self-host M3/M5: delete retired *_m3_emit_native_entry.php after inventory emit driver green #3032 — delete retired emit-helper files
• Self-host M3: wire inventory compile_driver in bootstrap-selfhost-jit-unit-probe.sh #3038 — JIT unit inventory compile_driver (related)

Links

• North star Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492 · 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 ROADMAP M3

[PurHur]

Reopened — implementation-ready spec (2026-05-28)

HelloWorld strict done (probe defaults BOOTSTRAP_M3_USE_INVENTORY_EMIT_DRIVER=1). Remaining probes still default :-0:

Script	Strict make target
bootstrap-selfhost-compile-smoke-probe.sh	make bootstrap-selfhost-compile-smoke-strict
bootstrap-selfhost-runtime-compile-smoke.sh	make bootstrap-selfhost-runtime-compile-smoke-strict
bootstrap-selfhost-compiler-unit-probe.sh	make bootstrap-selfhost-compiler-unit-probe-strict

Repro:

./script/docker-exec.sh -- bash -lc '
  source script/php-env.sh && make bootstrap-selfhost-compile-smoke-strict
' 2>&1 | grep -E "compile_smoke_m3_emit_native_entry|inventory compile_driver"

Done when: all three strict targets log inventory compile_driver only + emit_path=native.

Sibling: #2926 (Makefile/script defaults).

[PurHur]

Probe update 2026-05-28

With BOOTSTRAP_M3_USE_INVENTORY_EMIT_DRIVER=1:

Probe	Inventory compile_driver only
HelloWorld	✅
compiler-unit strict	✅
compile-smoke strict	✅
runtime-smoke strict	✅
JIT unit strict	❌ still jit_unit_probe_m3_emit_native_entry.php → tracked in #3026

Remaining work: JIT probe + #3024 default env / delete emit-helper files.

[PurHur]

claim: cursor-agent-lane-c — starting this run (JIT unit probe inventory emit driver)

[PurHur]

Verified on master (2026-05-29): make bootstrap-selfhost-jit-unit-probe-strict logs inventory compile_driver (no emit-helper TU, #2879/#3038) and emit_path=native. Remaining cleanup tracked in #3032 (open PR #3233). Releasing claim — no code change required here.

[PurHur]

claim: cursor-agent-lane-c — starting this run (JIT unit inventory emit driver)