Testing: MiniWebApp AOT unskip matrix after #568 (orchestrate #454 #485 #478 #610)

[PurHur]

Problem

MiniWebApp AOT work is split across four skipped tests/issues. When #568 lands, implementers need a single ordered checklist so we do not flip ExamplesCompileTest execute before ServeAotTest or examples-aot-smoke 003.

Unskip order (do not reorder)

Step	Issue / test	Gate
1	#624 ExamplesCompileTest::test003MiniWebAppProjectAotLint	phpc build --project --dry-run exit 0 (hard fail in @group aot-lint, not skip)
2	#454 ExamplesCompileTest::test003MiniWebAppEventuallyRuns	phpc build --project link + CLI execute (PATH_INFO=/home env)
3	#485 / script/examples-aot-smoke.sh 003 block	Remove skip stanza; EXAMPLES_AOT_SMOKE_ONLY=003 probe (#683 ✅)
4	#478 ServeAotTest MiniWebApp via phpc serve --aot	HTTP PATH_INFO routes
5	#610 ServeAotTest + /assets/style.css	Static assets from deploy docroot
6	#612 PHPC_DEPLOY_ROOT dist E2E	phpc deploy + PHPUnit or #718 deploy-smoke
7	#682 CgiDriverTest AOT cgi-wrapper 003	bin/cgi-aot.php + deploy root
8	#587 PhpcBuildProjectTest JIT project smoke	Optional; JIT may lag AOT

PHPUnit methods to unskip (grep #568)

File	Method	@group
test/unit/ExamplesCompileTest.php	test003MiniWebAppEventuallyRuns	miniwebapp
test/unit/ExamplesCompileTest.php	testAotLintMiniWebAppPublicIndex	aot-lint
test/real/ServeAotTest.php	testServes003MiniWebApp*	serve, llvm
test/real/CgiDriverTest.php	AOT MiniWebApp PATH_INFO cases	llvm

Remove markTestSkipped(... #568 ...) only after step 2 passes locally:

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

Scope

• Checklist in this issue body (update as steps land)
• script/miniwebapp-gates.sh stage 4b–4c → 4d (CI: Default EXAMPLES_AOT_SMOKE_GATE=1 in ci-local.sh (promote #667) #674, Testing: make deploy-smoke — phpc deploy + PHPC_DEPLOY_ROOT shell gate #718)
• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 Phase 4 row → ✅ when step 4+ green
• Close DevEx: MiniWebApp CI gate ladder (lint → serve → AOT → web-smoke) #472 when all stages default-on in ci-local.sh
• Stdlib: is_executable() VM + LLVM JIT/AOT via access X_OK #714 benchmark AOT columns after step 2

Acceptance criteria

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  ./script/ci-local.sh --filter 'ExamplesCompileTest::test003MiniWebApp|ServeAotTest'

No @group miniwebapp AOT tests skipped for “#568” when LLVM ready.

Dependencies

• AOT: Native user-class object model for phpc build --project #568 — native user-class object model (blocker)
• AOT: Runtime include() of deploy-root PHP via phpc_deploy_path() #623 ✅ — runtime deploy includes
• AOT: phpc deploy bundles binary, public/, assets/, and phpc.json into dist/ #609 ✅ — phpc deploy
• Web: AOT CGI wrapper for phpc-built binaries (production nginx spawn) #665 ✅ — AOT CGI wrapper

Verification

Local/Docker only — not GitHub Actions.

Links

• test/unit/ExamplesCompileTest.php, test/real/ServeAotTest.php, test/real/CgiDriverTest.php
• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78, parent Reference app: MiniWebApp runtime green (lint 0, VM serve, routes) #539

[PurHur]

Backlog batch 42: added #682 (CgiDriverTest MiniWebApp AOT cgi-wrapper) as step 6 in the unskip matrix — after #485 CLI execute, before or alongside #478 HTTP serve.

Suggested order update:

Step	Gate
1	#624 ✅ dry-run hard-fail
2	#454 link + execute
3	#485 / examples-aot-smoke.sh 003
4	#682 deploy cgi-wrapper + PATH_INFO
5	#478 phpc serve --aot
6	#610 + static /assets/style.css

#683 tracks miniwebapp-gates stage 4c probe for step 3.