Testing: make deploy-smoke — phpc deploy + PHPC_DEPLOY_ROOT shell gate

[PurHur]

Problem

#612 tracks PHPUnit dist-layout E2E for MiniWebApp with PHPC_DEPLOY_ROOT. Operators and harness hosts need a shell gate (like examples-web-smoke.sh) that validates phpc deploy bundles without running full ci-local.sh.

Today deploy verification is manual per docs/deploy-web-aot.md (#635 ✅).

Goal

make deploy-smoke
# or: ./script/deploy-smoke.sh

Builds 002-StaticWeb (or 001-SimpleWeb) AOT binary, runs phpc deploy, sets PHPC_DEPLOY_ROOT, curls HTML via one-shot CGI or phpc cgi (#665 ✅).

Scope

• script/deploy-smoke.sh with --example 001|002 flag
• Makefile target deploy-smoke
• Skip 003 block until AOT: Native user-class object model for phpc build --project #568 with stderr pointer to AOT: MiniWebApp dist-layout smoke with PHPC_DEPLOY_ROOT (post #609 deploy) #612
• Wire optional gate in script/miniwebapp-gates.sh stage 4d (document only until 003 green)
• README / docs/deploy-web-aot.md link

Implementation hints

Step	Command	Notes
Build	phpc build --project or single-file phpc build	Requires LLVM; skip entire script if missing
Deploy	phpc deploy -o /tmp/phpc-deploy-smoke	#609 layout
CGI	PHPC_DEPLOY_ROOT=… QUERY_STRING= …/bin/app	Match CgiDriverTest env
Assert	grep expected HTML substring	002: static title; 001: name= optional

Acceptance criteria

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

Exit 0 on host/Docker with LLVM; exit 0 with skip message when LLVM absent (same UX as examples-aot-smoke.sh).

Dependencies

• 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
• AOT: MiniWebApp dist-layout smoke with PHPC_DEPLOY_ROOT (post #609 deploy) #612 — PHPUnit counterpart for 003 (post-AOT: Native user-class object model for phpc build --project #568)

Links

• Docs: deploy-web-aot.md quickstart (phpc deploy + PHPC_DEPLOY_ROOT + nginx CGI) #635, Docs: Production deployment guide (nginx + AOT binary + CGI/FastCGI) #445, Docs: nginx static assets (alias) for AOT deploy dist #696
• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 Phase 3 Web AOT