Testing: deploy-smoke.sh 007 slice + THROWSWEB_DEPLOY_SMOKE_GATE

[PurHur]

Problem

005-SessionsWeb and 006-FileUploadWeb have script/deploy-smoke.sh --example 00x + opt-in *_DEPLOY_SMOKE_GATE ladders (#1893, #2028). 007-ThrowsWeb is on master (#2076 ✅) but deploy-smoke usage/docs stop at 006 and make deploy-smoke-all (#2077) has no 007 row.

Presenters cannot verify phpc deploy + PHPC_DEPLOY_ROOT CGI for caught invalid POST without hand-rolled env.

Scope

Piece	Path	Notes
Smoke script	script/deploy-smoke.sh	--example 007; POST invalid email → HTML contains invalid
Env gate	script/ci-defaults.env, script/ci-common.sh	THROWSWEB_DEPLOY_SMOKE_GATE=0 opt-in first
Make	Makefile	Optional examples-throwsweb-deploy-smoke (mirror #2044)
Doctor	lib/Doctor.php --gates	Row after #2101 AOT execute green
Deploy-all	Extend #2085 / deploy-smoke-all	Print skip hint when gate 0

Depends on: #2101 (THROWSWEB_AOT_* link/execute) for meaningful AOT binary; VM-only deploy slice may land earlier if phpc deploy works on VM-built tree.

Acceptance criteria

# After LLVM + #2101 green:
THROWSWEB_DEPLOY_SMOKE_GATE=1 ./script/deploy-smoke.sh --example 007
docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  bash -lc 'THROWSWEB_DEPLOY_SMOKE_GATE=1 ./script/deploy-smoke.sh --example 007'

• Exit 0; output shows caught invalid POST under PHPC_DEPLOY_ROOT
• test/unit/DeploySmokeTest.php (or extend existing) asserts gate wiring
• docs/local-ci-matrix.md documents gate + opt-in ci-local follow-up issue

No GitHub Actions required — verify with ./script/ci-local.sh or Docker above.

Links

• Examples: 007-ThrowsWeb — throw/catch presenter app (post-#195/#57) #2076 · Testing: THROWSWEB_AOT_LINK_GATE + THROWSWEB_AOT_SMOKE_GATE (007-ThrowsWeb) #2101 · Testing: deploy-smoke multipart upload for 006-FileUploadWeb #2028 (006 precedent) · 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 ROADMAP Phase 4

[PurHur]

Implementation hints (batch 133 — harness verification)

Precedent: #2028 / #2038 006 deploy ladder. #2101 ✅ / #2157 ✅ — AOT binary is available for 007.

Piece	Path	Notes
Smoke	script/deploy-smoke.sh	Add --example 007; POST invalid email → body contains invalid (caught path)
Env	script/ci-defaults.env	THROWSWEB_DEPLOY_SMOKE_GATE="${THROWSWEB_DEPLOY_SMOKE_GATE:-0}"
CI	script/ci-common.sh	ci_run_throwsweb_deploy_smoke() in llvm tail when gate 1
Test	test/unit/DeploySmokeTest.php	Assert gate wiring + skip message when 0
Make	Makefile	examples-throwsweb-deploy-smoke (mirror #2044)
Deploy-all	script/deploy-smoke-all.sh / #2085	Row + skip hint when gate 0
Doctor	lib/Doctor.php --gates	Row under throwsweb after AOT execute

Verify (local / Docker only — no GHA)

THROWSWEB_DEPLOY_SMOKE_GATE=1 ./script/deploy-smoke.sh --example 007
./script/docker-exec.sh -- bash -lc 'THROWSWEB_DEPLOY_SMOKE_GATE=1 ./script/deploy-smoke.sh --example 007'

Do not use raw docker run -v "$(pwd):/compiler" on Runforge (#2184 ✅).

Follow-up

Default-on ci-local flip issue after opt-in green (mirror #2038 → #2042).

[PurHur]

Backlog architect expansion (May 2026)

CI follow-up (do not duplicate here)

Track ci-local opt-in wiring in #2264 (THROWSWEB_DEPLOY_SMOKE_GATE=1 in ./script/ci-local.sh). This issue stays scoped to the deploy-smoke script + defaults + Makefile target.

Implementation hints — copy #2028 / #2038 pattern

Step	File	Action
1	script/deploy-smoke.sh	Add --example 007 branch: build/deploy tree, PHPC_DEPLOY_ROOT, POST email=bad, grep invalid
2	script/ci-defaults.env	THROWSWEB_DEPLOY_SMOKE_GATE=0 + comment linking #2264
3	script/ci-common.sh	Skip helper when gate 0; print skip hint (mirror #2077)
4	Makefile	examples-throwsweb-deploy-smoke → script wrapper (#2044 precedent for 006)
5	lib/Doctor.php	--gates row: env name, default, ./script/deploy-smoke.sh --example 007
6	test/unit/DeploySmokeTest.php	Data provider row for 007; assert skip when gate 0
7	docs/local-ci-matrix.md	Gate table + harness command

CGI env overlay (match VM smoke #2093)

Reuse the same POST body / content-type as script/examples-web-smoke.sh --throws-only so deploy CGI matches phpc serve behavior.

Unblock order

#2101 AOT link/execute green → this issue (deploy-smoke slice) → #2264 ci-local opt-in → #2042-style default-on follow-up

Verification (harness-safe)

THROWSWEB_DEPLOY_SMOKE_GATE=1 ./script/deploy-smoke.sh --example 007
./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && THROWSWEB_DEPLOY_SMOKE_GATE=1 ./script/deploy-smoke.sh --example 007'

Dependencies: #2101, #2135, #1893 (005 precedent), #2028 (006 precedent).