AOT: MiniWebApp native binary CLI execute emits empty stdout (post-link)

[PurHur]

Problem

#752 closed and harness verify (batch 50, 2026-05-23) confirms phpc build --project examples/003-MiniWebApp exits 0 and writes .phpc/bin/app when vendor patches are applied.

Runtime parity is not there yet: executing the binary with the same CGI env as MiniWebAppVmCliTest / examples-web-smoke.sh returns exit 0 but empty stdout for home and hello routes.

# After build (Docker, patches applied):
cd examples/003-MiniWebApp
export QUERY_STRING=route=home REQUEST_METHOD=GET
./.phpc/bin/app   # exit 0, len=0

export PATH_INFO=/hello QUERY_STRING=name=Dev REQUEST_METHOD=GET
./.phpc/bin/app   # exit 0, no greeting

VM path (phpc serve / bin/vm.php) prints HTML — this is an AOT execute gap, not a link failure.

Goal

Native binary output matches VM for:

• QUERY_STRING=route=home → HTML contains app_name from config.php
• PATH_INFO=/hello + name=Dev → greeting string
• POST /contact → thank-you template body

Scope

• Debug AOT entry (public/index.php graph), Router::dispatch, template include at runtime (AOT: Runtime include() of deploy-root PHP via phpc_deploy_path() #623), CGI env reads in compiled code
• Land MiniWebAppAotExecuteTest acceptance from Testing: MiniWebAppAotExecuteTest CLI smoke (#485, #676 step 2) #747 / Testing: MiniWebApp AOT binary CLI execute smoke (tracked in #747, blocked #764) #485
• Update Testing: MiniWebApp AOT unskip matrix after #568 (orchestrate #454 #485 #478 #610) #676 step 2 checklist when green

Implementation hints

Area	Files	Notes
Entry	examples/003-MiniWebApp/public/index.php	PATH_INFO + ?route= fallback
Router	src/Router.php	: void methods, include templates
AOT runtime	lib/AOT/, lib/VM.php superglobal refresh	Compare with #49 / #665 001 green
Includes	deploy tree / compile-time graph	#452 includes[] order
Test	test/unit/MiniWebAppAotExecuteTest.php (#747)	runBinaryWithCgiEnv() helper

Reproduce (local / Docker)

make docker-build-22
docker run --rm -i -w /compiler php-compiler:22.04-dev bash -lc '
  tar -xf - && composer install -q && ./script/apply-patches.sh
  php bin/phpc.php build --project examples/003-MiniWebApp
  cd examples/003-MiniWebApp
  QUERY_STRING=route=home REQUEST_METHOD=GET ./.phpc/bin/app | wc -c
'

Expect non-zero byte count; currently 0.

Acceptance criteria

• MiniWebAppAotExecuteTest passes in ./script/ci-local.sh @group llvm
• Manual curl not required for close — PHPUnit env contract from Docs: Add 003-MiniWebApp row to examples benchmark table when VM green #491
• Testing: Enable examples-aot-smoke.sh 003-MiniWebApp slice (#676 step 3) #738 examples-aot-smoke.sh 003 slice can enable after this + Testing: MiniWebAppAotExecuteTest CLI smoke (#485, #676 step 2) #747

Dependencies

• AOT: MiniWebApp phpc build --project native link fails on master (post-#568/#734) #752 ✅ / AOT: Native user-class object model for phpc build --project #568 ✅ — link
• Testing: MiniWebAppAotExecuteTest CLI smoke (#485, #676 step 2) #747, Testing: MiniWebApp AOT binary CLI execute smoke (tracked in #747, blocked #764) #485 — test tracking
• Testing: MiniWebApp AOT unskip matrix after #568 (orchestrate #454 #485 #478 #610) #676 step 2 orchestration
• AOT: Runtime include() of deploy-root PHP via phpc_deploy_path() #623 runtime includes (if templates missing at runtime)

Verification

Local/Docker only — ./script/docker-ci-local.sh --filter MiniWebAppAotExecuteTest (once added). No GitHub Actions.

Links

• Testing: MiniWebAppAotExecuteTest CLI smoke (#485, #676 step 2) #747, Testing: MiniWebApp AOT binary CLI execute smoke (tracked in #747, blocked #764) #485, Testing: Enable examples-aot-smoke.sh 003-MiniWebApp slice (#676 step 3) #738, Testing: ServeAotTest MiniWebApp routes via phpc serve --aot (blocked #764 execute) #478
• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78