CI: FILE_UPLOAD_WEB_SMOKE_GATE opt-in in ci-local after #1999

[PurHur]

Problem

#1999 will add examples/006-FileUploadWeb/ with multipart curls, but full ci-local.sh has no opt-in gate for the sixth example ladder (pattern: #1887/#1894 for 005, #1967/#1974 for deploy).

Without a gate issue, contributors may wire smoke ad-hoc or duplicate 005 gate naming.

Goal

1. Add FILE_UPLOAD_WEB_SMOKE_GATE=0 default in script/ci-defaults.env
2. When =1, script/ci-local.sh runs multipart curl smoke for 006 (after Examples: 006-FileUploadWeb — multipart $_FILES reference + AOT execute smoke #1999 tree exists)
3. Follow-up issue (not here): default-on in ci-local after green — mirror CI: Default SESSIONS_WEB_DEPLOY_SMOKE_GATE=1 in ci-local after #1967 green #1974 naming

Implementation hints

Piece	Path	Notes
Env default	script/ci-defaults.env	FILE_UPLOAD_WEB_SMOKE_GATE="${FILE_UPLOAD_WEB_SMOKE_GATE:-0}"
Hook	script/ci-common.sh or script/examples-web-smoke.sh	--fileupload-only slice
Doctor	lib/Doctor.php	List gate under examples ladder (#1903 pattern)
Docs	docs/local-ci-matrix.md	Row + verify commands
Test	test/unit/CiScriptsTest.php	Assert env string present

Acceptance criteria

FILE_UPLOAD_WEB_SMOKE_GATE=1 ./script/ci-local.sh
# runs 006 multipart curl; exits 0 when #1999 green

FILE_UPLOAD_WEB_SMOKE_GATE=0 ./script/ci-fast.sh
# skips 006 (fast path unchanged)

Verification (local / Docker only)

./script/docker-ci-local.sh

Do not require GitHub Actions (#394 ✅).

Dependencies

• Examples: 006-FileUploadWeb — multipart $_FILES reference + AOT execute smoke #1999 — example tree + examples-web-smoke.sh slice
• Testing: 005-SessionsWeb in examples-web-smoke + ExamplesCompileTest #1887 — sessionsweb smoke pattern (sibling)

Links

• ROADMAP 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 Phase 4
• Default-on follow-up: open after smoke green (mirror CI: Default SESSIONS_WEB_AOT_SMOKE_GATE=1 in ci-local after #1921 green #1923 / CI: Default SESSIONS_WEB_DEPLOY_SMOKE_GATE=1 in ci-local after #1967 green #1974)

[PurHur]

Closed — delivered in #2008

Opt-in 006-FileUploadWeb gates landed on master via PR #2008 (closes #1999):

Gate	Default	Wired in
FILE_UPLOAD_WEB_SMOKE_GATE	0	script/ci-defaults.env, ci_run_file_upload_web_smoke() in script/ci-common.sh, hook in script/ci-local.sh
FILE_UPLOAD_WEB_AOT_LINK_GATE	0	ExamplesCompileTest + ci-local filter path
FILE_UPLOAD_WEB_AOT_SMOKE_GATE	0	ci_run_file_upload_web_aot_execute(), FileUploadWebAotExecuteTest

Verify:

FILE_UPLOAD_WEB_SMOKE_GATE=1 ./script/ci-local.sh --filter examples-web-smoke
FILE_UPLOAD_WEB_AOT_LINK_GATE=1 ./script/ci-local.sh --filter test006FileUploadWebAotLink

Follow-up (not this issue): default-on in ci-local.sh after green in Docker — mirror #1974 / #1923 pattern; will open as sibling issue.

ROADMAP #78 batch 102 updated.

[PurHur]

Superseded (batch 106)

VM multipart gate is default-on on master via #2009 ✅ (FILE_UPLOAD_WEB_SMOKE_GATE=1 in script/ci-defaults.env).

Follow-ups: #2012 (AOT execute default), #2013 (examples-aot-smoke 006 slice), #2028 (deploy-smoke).