DevEx: MiniWebApp CI gate ladder (lint → serve → AOT → web-smoke)

[PurHur]

Problem

examples/003-MiniWebApp/ is lint-first today: make web-smoke logs lint failures but continues unless MINIWEBAPP_LINT_GATE=1 (#455). Contributors lack a single checklist for flipping gates as #67 closes blockers (#58, #54, #115, …).

Goal

Document and wire a progressive gate ladder in examples/003-MiniWebApp/README.md, root examples/README.md, and script/web-smoke.sh:

Stage	Env / target	Fails CI when
0 Skeleton	(default)	never on 003 lint exit 1
1 Lint green	MINIWEBAPP_LINT_GATE=1	phpc lint --all regresses (#67 done)
2 Serve PHPUnit	MINIWEBAPP_SERVE_GATE=1	#464 ServeTest fails
3 Shell web-smoke	make examples-web-smoke includes 003 (#461)	curl routes fail
4 AOT	ExamplesCompileTest @group miniwebapp unskipped (#454)	build/link fails

Scope

• README tables with env vars and tracking issues per stage
• script/web-smoke.sh honors MINIWEBAPP_SERVE_GATE (optional: invoke Fix AOT ?? compile lowering for superglobals (partial #148) #464 filter or skip message)
• Makefile target make miniwebapp-gates prints current stage from env
• Link from 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 ROADMAP Phase 4

Acceptance criteria

MINIWEBAPP_LINT_GATE=1 make web-smoke   # documented failure modes
grep -r MINIWEBAPP_ examples/003-MiniWebApp/README.md

No GitHub Actions — verify with host or:

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev make web-smoke

Dependencies

• Reference app: examples/003-MiniWebApp (router, templates, forms) #67, DevEx: make web-smoke runs phpc lint --all on 003-MiniWebApp when tree exists #455 ✅ lint in web-smoke
• Fix AOT ?? compile lowering for superglobals (partial #148) #464 ServeTest
• Web: Extend script/examples-web-smoke.sh for 003-MiniWebApp routes #461 examples-web-smoke 003 block
• Testing: ExamplesCompileTest @group miniwebapp for 003-MiniWebApp (skipped until green) #454 ExamplesCompileTest

Links

• 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 ROADMAP

[PurHur]

Doc fix (batch 27): Gate ladder stage 2 Serve PHPUnit should reference #470 (VM ServeMiniWebAppTest), not #464 (unrelated AOT ?? lowering).

Stage 4 AOT serve gate: #478 (ServeAotTest MiniWebApp routes).