Skip to content

🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78

Open
Open
🗺️ ROADMAP: Self-host + web-capable PHP subset (living)#78
Labels
area:toolingTooling / CI / docsenhancementNew feature or requestimplementation-readySpec complete: repro, php-src ref, done-when — safe for workers to claimphase-0:FoundationPhase 0 – foundation & DevEx

Description

@PurHur
PurHur
opened on May 18, 2026

Living ROADMAP (high-signal, phased)

Merge gates are local/Docker only — no GitHub Actions (#394 ✅).
Harness-safe: make test-harness, ./script/docker-ci-local.sh, ./script/docker-exec.sh.

North star: #1492 (M3→M5 self-host)

Development focus (Jul 2026): optimize for fast M5 feedback — not north-star5-verify --strict on every PR (~1h). Daily gates: make north-star5-verify-fast (~1–2 min), make bootstrap-selfhost-vm-driver-execute-probe (~20ms). Reserve --strict for pre-merge bootstrap/gen-0/vendor-prelink PRs. Doc: docs/bootstrap-m5-fast-path.md · Cursor rule: .cursor/rules/m5-fast-development.mdc.

User release roadmap (next: v1.1.0)

Meta: #8739 (reopen on tag day) · Latest tag: v1.0.0 (2026-05-29) · Pre-release: v1.1.0-dev.1 (2026-07-04)

Field Value
Target version v1.1.0
Target window Aug 2026 (blocked on #29001 examples AOT; --full otherwise green)
Theme M5 fast-path stability for users; stdlib/JIT parity batch since v1.0.0 (enum, property hooks, DOM ext, preg_match JIT, spl_autoload, php-in-php helpers, stream/getenv JIT, docs sync)

Must-ship checklist

Pillar 1 (Trust) — #10533 (closed; status on #78): 🟢 quick user_release_ready: yes @ d0b2bc4585 (2026-08-08). Inventory OK 7248/7248; helper-runtime 369 fresh / 0 stale; cold-build ✅ (~4s); spine / root-readme / north-star5-fast / vm-driver / gen0-functional ✅. gen0_provenance stale (driver cc281e13c, 23 lowering commits, unverified-restamp — warning only). Pillar 2 (Ship): --full red on examples-aot-smoke → #29001.

Gate checklist

Out of scope (v1.1.0)

  • Bootstrap honesty tag / v2 self-host release
  • north-star5-verify --strict (~1h)
  • Full Zend parity, MCJIT execute (#98)

Bootstrap release roadmap (future v2 / self-host honesty)

Not a tag candidate until north-star5-verify --strict is green on demand. Track progress only.

Blocker / gap Gate Status Tracker
Honest spine PHP main() runtime full-spine smoke without native shortcut 🚧 partial #8559
Compile-spine stub retirement shrink PHP_COMPILER_SELFHOST_AOT on compile spine 🚧 in progress #1402
M3 JIT unit strict inventory compile_driver 🚧 partial #3038
Bootstrap include_path spine include resolution open #3223
php-cfg asymmetric visibility overlay apply-patches.sh anchor 🔴 regression #9729
Strict M5 presenter north-star5-verify.sh --strict (~1h) ✅ green (pre-merge only) #1492

Must-ship before bootstrap tag: spine N/N honest runtime, stub retirement on compile path, no Zend in cold-boot loop — see #1492.

Milestone status (Aug 2026 — release review 2026-08-08)

Milestone Gate Status Tracker
M0 minimal link make bootstrap-selfhost-link ✅ GREEN (partial honesty) OK /compiler/build/selfhost via Zend gen-0 fallback; stale native driver (#21855)
M2 spine / inventory bootstrap-inventory.php --check ✅ GREEN release-readiness 7248/7248
M2 spine coverage check-selfhost-spine-coverage-sync.php ✅ GREEN 7248 + 2 deferred (#1960/#1922)
M2 VM driver execute make bootstrap-selfhost-vm-driver-execute-probe ✅ GREEN via release-readiness quick
M3 HelloWorld strict make bootstrap-selfhost-helloworld ✅ GREEN emit_path=native; stdout Hello World
M3 JIT unit strict inventory compile_driver 🚧 partial #3038
M4 full-revision make bootstrap-selfhost-full-revision-probe ✅ GREEN #2880
M4 full ladder make bootstrap-loop-probe ✅ GREEN #1498
M5 vendor (committed) prelinked/bootstrap-vendor/*.o manifest ✅ GREEN 3/3 object_ok
M5 spine w/o vendor/ north-star5 step 4c ✅ GREEN #3052 closed
M5 gen-0 no Zend BOOTSTRAP_M5_NO_ZEND=1 empty build/ ✅ GREEN #3053 closed
M5 vendor native rebuild rm prelinked/*.o, no Zend fallback ✅ GREEN #3054 closed
M5 presenter (daily) make north-star5-verify-fast ✅ GREEN via release-readiness @ d0b2bc4585
M5 presenter (pre-merge) north-star5-verify.sh --strict ✅ GREEN ~1h — bootstrap PRs only
M5 honest runtime full-spine PHP main() at runtime 🚧 partial #8559
User release --full release-readiness.sh --full 🔴 RED #29001 001-SimpleWeb exit 139; capability-matrix + web smoke green

Daily verify (fast — use during development):

make bootstrap-selfhost-vm-driver-execute-probe   # ~20ms
make north-star5-verify-fast                      # ~1–2 min
./script/ci-fast.sh                               # NORTH_STAR5_VERIFY_FAST_GATE=1 default

Pre-merge bootstrap verify (strict — sparingly):

./script/docker-exec.sh -- bash -lc './script/north-star5-verify.sh --strict'

Next 5 worker priorities (parallel-safe)

  1. Examples AOT smoke (Pillar 2) — #29001 (release-blocker — 001-SimpleWeb exit 139 after c:main_after_init; no smoke-skip)
  2. Re-probe --full — after Release v1.1.0: fix examples 001-SimpleWeb AOT smoke (exit 139 segfault after c:main_after_init; re-#18832) #29001 → confirm user_release_ready: yes (capability-matrix + web smoke already green 2026-08-08)
  3. Gen-0 argv / provenance — honest refresh for 23 lowering commits since cc281e13c (do not restamp; unverified-restamp debt)
  4. Keep helper-runtime green — tip churn often reintroduces STALE units after stdlib landings (Pillar 1 watch)
  5. CHANGELOG expand — refresh v1.1.0 stub themes before tag (bootstrap honesty #1402/#8559 not tag-blocking)

Parity backlog themes (Jul 2026)

Theme Examples
Language (PHP 8.3–8.4) property hooks (#6424–#6427), enum case invoke #9846, lazy proxy #7387
Stdlib gaps ext/dom batch (#14418–#14469), is_callable #3132, ext/zip #3337
php-in-php / shrink C #7389 linker audit, superglobals_refresh.c #5330, phpc_stream.c #5343
php-src-strict enum operands #5906 / #5907 / #7390, hash #5780

Repro (roadmap health check)

docker info >/dev/null
./script/docker-exec.sh -- bash -lc './script/release-readiness.sh --json'
./script/docker-exec.sh -- bash -lc './script/release-readiness.sh --full --json'

Done when (living doc)

Verification (local / Docker only)

./script/docker-exec.sh -- bash -lc 'make north-star5-verify-fast'
./script/docker-exec.sh -- bash -lc 'php script/bootstrap-inventory.php --check'
./script/docker-exec.sh -- bash -lc 'make bootstrap-loop-probe'

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:toolingTooling / CI / docsenhancementNew feature or requestimplementation-readySpec complete: repro, php-src ref, done-when — safe for workers to claimphase-0:FoundationPhase 0 – foundation & DevEx

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions