AOT: Project build mode (entry file + dependency graph)

[PurHur]

Status (2026-05-24, batch 65 — narrowed)

Static project build is shipped on master. This issue is closed for phase 1; track remaining work elsewhere.

Capability	Issue	Status
phpc build --project CLI	this issue	✅
lib/AOT/ProjectGraph.php BFS	#504	✅
Manifest includes[]	#452	✅
Multi-.o link	#752	✅
003-MiniWebApp AOT link + execute	#764	✅
Deploy bundle	#609	✅
Static multi-TU umbrella	#154	✅ phase 1
Dynamic includes / PSR-4	#1762	📋 phase 2

Original problem

bin/compile.php / phpc build originally emitted one .o per entry file. Multi-file apps need explicit graph discovery.

Canonical follow-ups (do not reopen #59)

• AOT: Link multiple translation units into one binary #154 — multi-TU link umbrella (phase 1 ✅, phase 2 → AOT: Dynamic require/include discovery for project build (phase 2 of #154) #1762)
• AOT: Dynamic require/include discovery for project build (phase 2 of #154) #1762 — dynamic require / PSR-4 discovery
• 🌐 North Star 1: Web-capable PHP application (living tracker) #1044 / CI: North Star 1 gate-flip bundle — #1530 done; #1523 + #1752 remain before #1044 close #1760 — North Star 1 gate flips + docs

Verification (local / Docker)

./phpc build --project examples/003-MiniWebApp
MINIWEBAPP_AOT_EXECUTE_GATE=1 ./script/ci-local.sh --filter MiniWebAppAotExecuteTest
docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  ./script/ci-local.sh --filter MiniWebAppAotExecuteTest

No GitHub Actions.

Action

Close #59 as shipped; use #154 / #1762 for new work. ROADMAP #78 links here for history only.

[PurHur]

De-duplication (batch 46 — backlog architect)

#59 remains the umbrella for phpc build --project.

Implementation slices:

• Multi-TU link → AOT: Link multiple translation units into one binary #154
• User-class native ABI → AOT: Native user-class object model for phpc build --project #568
• Actionable stderr → DevEx: Actionable phpc build --project errors when user-class AOT is blocked (#568) #643 ✅
• Include graph debug → DevEx: phpc build --project --print-includes (multi-file AOT debug) #729 --print-includes
• Unskip order → Testing: MiniWebApp AOT unskip matrix after #568 (orchestrate #454 #485 #478 #610) #676

Do not duplicate acceptance criteria across #154 and #59 — link child issues in PRs.

[PurHur]

Status sync (batch 64, ROADMAP #78): Static project build is shipped on master:

• phpc build --project + ProjectGraph + manifest includes[] ✅ (AOT: MiniWebApp phpc build --project native link fails on master (post-#568/#734) #752)
• 003-MiniWebApp AOT link + execute ✅ (AOT: MiniWebApp native binary CLI execute emits empty stdout (post-link) #764, Testing: MiniWebApp AOT GET api/status JSON route in MiniWebAppAotExecuteTest #1529)
• Deploy path ✅ (AOT: phpc deploy bundles binary, public/, assets/, and phpc.json into dist/ #609, Testing: make deploy-smoke — phpc deploy + PHPC_DEPLOY_ROOT shell gate #718)

Recommend: Close this umbrella or retitle to "phase 2 only" — remaining work is dynamic include/PSR-4 discovery tracked in #1762 (child of #154 phase 2). Acceptance criteria for 003 north star are met.

Verify: docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev ./phpc build --project examples/003-MiniWebApp --dry-run

[PurHur]

PM triage (batch 65, 2026-05-24)

Static project build is shipped on master:

• phpc build --project + lib/AOT/ProjectGraph.php + manifest includes[]
• 003-MiniWebApp link + execute green (AOT: MiniWebApp phpc build --project native link fails on master (post-#568/#734) #752, AOT: MiniWebApp native binary CLI execute emits empty stdout (post-link) #764, Testing: MiniWebApp AOT GET api/status JSON route in MiniWebAppAotExecuteTest #1529)

Recommend narrowing this issue:

• Retitle to phase 2 only: dynamic require / PSR-4 discovery at build time
• Point implementation tracking to AOT: Dynamic require/include discovery for project build (phase 2 of #154) #1762 (opened batch 64)
• Close checklist items for static multi-TU / manifest graph

Do not duplicate: ROADMAP #78 batch 64 already notes #59 static path done → follow #1762.

Remaining user-class / OOP gaps for 003 are tracked under language/JIT issues (#58, #145), not project-graph scaffolding.

[PurHur]

Narrowed in batch 65: static phpc build --project shipped (#504, #752, #764). Dynamic discovery → #1762; multi-TU umbrella → #154. Closing to reduce duplicate with #154/#1762.