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

[PurHur]

Problem

MiniWebApp AOT work is split across skipped tests and shell smokes. #568 / #752 ✅ closed link; the active blocker is #764 (native binary exit 0, empty stdout). Implementers need a single ordered checklist so we do not flip HTTP ServeAotTest before CLI execute or examples-aot-smoke 003.

Unskip order (do not reorder)

Step	Issue / test	Gate
0	#806 require_return_config.phpt	Focused require-as-expression AOT execute
0b	#807 layout_partial_chain.phpt	Layout conditional partial includes
1	#624 ExamplesCompileTest::test003MiniWebAppProjectAotLint	phpc build --project --dry-run exit 0
2	#454 / #747 test003MiniWebAppExecutesWithCgiEnv	link + CLI execute (PATH_INFO=/home)
2b	#809 examples-aot-smoke.sh 003	Accurate #764 probe (not #568 skip)
3	#738 full examples-aot-smoke 003 green	EXAMPLES_AOT_SMOKE_ONLY=003 ok
4	#478 ServeAotTest MiniWebApp phpc serve --aot	HTTP PATH_INFO routes
5	#610 + /assets/style.css	Static assets from deploy docroot
6	#612 PHPC_DEPLOY_ROOT dist E2E	phpc deploy + PHPUnit or #718 shell
7	#682 CgiDriverTest AOT cgi-wrapper 003	bin/cgi-aot.php + deploy root
8	#587 JIT project smoke	Optional; JIT may lag AOT

PHPUnit methods to unskip (grep #568 → retarget #764)

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

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

./script/docker-ci-local.sh --filter test003MiniWebAppExecutesWithCgiEnv

Scope

• Checklist in this issue (update as steps land)
• script/miniwebapp-gates.sh stages 4b–4d (CI: examples-aot-smoke 003 — probe link then execute bytes (#764, not #568 skip) #809, 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 → ✅ 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
• Testing: Regenerate examples benchmark AOT row for 003 after #568 #716 benchmark AOT columns after step 2

Acceptance criteria

./script/docker-ci-local.sh --filter 'ExamplesCompileTest::test003MiniWebApp|ServeAotTest'

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

Dependencies

• AOT: MiniWebApp phpc build --project native link fails on master (post-#568/#734) #752 ✅ — link
• AOT: MiniWebApp native binary CLI execute emits empty stdout (post-link) #764, AOT: Project entry require-as-expression bootstrap (config.php → Router) (#764) #783, AOT: Router render* void methods — template include must emit stdout (#764) #776, AOT: layout.php title-branch partial includes (second template tier, #764) #784 — execute sub-tracks
• 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

Verification

Local/Docker only — not GitHub Actions.

Links

• DevEx: Retire #568 user-class blocker copy in PhpcBuild and tests #766, CI: check-stale-issue-refs.sh — fail inventory on closed blocker strings (#568) #802, CI: examples-aot-smoke 003 — probe link then execute bytes (#764, not #568 skip) #809 — retire AOT: Native user-class object model for phpc build --project #568 messaging
• 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.