Docs: capabilities-matrix multipart/ + 006-FileUploadWeb AOT status rows

[PurHur]

Problem

#1947 tracks regenerating docs/capabilities.md for session_* builtins and 005-SessionsWeb AOT columns after session persistence landed. 006-FileUploadWeb uses nested $_FILES, multipart parsing (#52 ✅), and move_uploaded_file() (#2005 ✅ / #2014) but contributor matrices may still show VM-only or missing 006 notes.

Goal

After #2012 (or manual FILE_UPLOAD_WEB_AOT_SMOKE_GATE=1 green):

1. Run php script/capability-matrix.php and commit docs/capabilities.md rows for:
   • $_FILES / nested keys (web runtime)
   • move_uploaded_file (if not already ✅)
   • Example column note: 006 AOT execute when gate on
2. Optional: php script/capability-syntax.php web/multipart rows
3. Drift guard: extend existing capabilities sync test or add CAPABILITIES_006_SYNC_GATE=1 in ci-fast (default 0)

Acceptance criteria

php script/capability-matrix.php
grep -E 'FILES|move_uploaded|006' docs/capabilities.md
./script/ci-fast.sh --filter Capabilities   # when gate wired

Verification (local / Docker only)

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  php script/capability-matrix.php

No GitHub Actions.

Dependencies

• Examples: 006-FileUploadWeb — multipart $_FILES reference + AOT execute smoke #1999 ✅, Stdlib: move_uploaded_file for VM (multipart upload reference apps) #2005 ✅
• CI: Default FILE_UPLOAD_WEB_AOT_SMOKE_GATE=1 in ci-local after #2011 green #2012 — AOT execute default-on before marking AOT columns ✅
• Related: Docs: capabilities-matrix session_* + 005-SessionsWeb AOT status rows #1947 (005 session rows — can land in same PR or follow-up)

Links

• docs/capabilities.md, script/capability-matrix.php
• ROADMAP 🗺️ ROADMAP: Self-host + web-capable PHP subset (living) #78 Phase 2 Stdlib / Phase 4 Polish

[PurHur]

Closed via #2048 — capabilities.md/syntax.md regenerated for 006 multipart + move_uploaded_file; CAPABILITIES_006_SYNC_GATE drift guard (opt-in).

[PurHur]

Implementation hints (batch 113)

Checker already exists — this issue is doc regen + gate flip, not greenfield.

Piece	Path	Notes
Checker	script/check-capabilities-fileuploadweb-sync.php	Asserts docs/capabilities.md + docs/capabilities-syntax.md rows for move_uploaded_file, $_FILES, 006 notes
Gate env	script/ci-defaults.env	CAPABILITIES_006_SYNC_GATE=0 today — flip tracked #2068
CI hook	script/ci-common.sh	ci_run_capabilities_006_sync_check() when gate =1
Regen	php script/capability-matrix.php	Commit docs/capabilities.md if checker fails
Syntax matrix	php script/capability-syntax.php	Web/multipart section in docs/capabilities-syntax.md
Test	test/unit/CapabilitiesFileuploadwebSyncTest.php (if present) or extend CiScriptsTest	Assert gate string

Acceptance (local / Docker):

php script/check-capabilities-fileuploadweb-sync.php
CAPABILITIES_006_SYNC_GATE=1 ./script/ci-fast.sh
docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  php script/check-capabilities-fileuploadweb-sync.php

Dependencies: #2012 ✅ AOT execute default-on · #2005 ✅ VM · sibling #1947 (005 sessions rows)

Follow-up: #2068 default-on ci-fast after this issue’s matrix rows are truthful on master.

ROADMAP #78 · #2045 capabilities deploy rows (after #2028).