Docs: wave3 umbrella #1380 close-out — 12/12 language + 13/13 stdlib on master

[PurHur]

Problem

Wave 3 is complete on master (#1354 ✅ via #1925, #1751 ✅), but:

• Umbrella Roadmap wave 3: full PHP language + stdlib gaps tracker (#1354–#1379) #1380 remains open with stale “open language” rows
• docs/roadmap-wave3.md summary says 12 language done (correct: JIT/AOT: dynamic superglobal keys from boxed foreach variables (#86) #1355 unused) while ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 sometimes says “13/13”
• php script/check-wave3-roadmap-sync.php passes only when doc tables match — contributors may still file duplicate language issues

Goal

1. Close Roadmap wave 3: full PHP language + stdlib gaps tracker (#1354–#1379) #1380 with final summary comment + link to docs/roadmap-wave3.md
2. Add a one-line “Wave 3 complete” banner at top of docs/roadmap-wave3.md (deferrals → Language features wave 2: JIT/syntax gaps tracker (#1222–#1235) #1238, JIT: spl_autoload_register compile-time lowering (#1369 phase 2) #1776, Language: PHP 8 attributes — JIT/AOT reflection (phase 2 of #1354) #1936 attributes reflection)
3. Ensure docs/capabilities-syntax.md attributes row says “VM yes; reflection deferred Language: PHP 8 attributes — JIT/AOT reflection (phase 2 of #1354) #1936”
4. Optional: script/audit-wave3-issues.sh (local gh + grep) — not GHA

Implementation hints (file checklist)

File	Action
docs/roadmap-wave3.md	Banner + close all language/stdlib rows; link deferrals
docs/capabilities-syntax.md	Regenerate via php script/capability-syntax.php; attributes → #1936
docs/capabilities.md	Regenerate via php script/capability-matrix.php (optional same PR)
script/check-wave3-roadmap-sync.php	Already default-on via #1814 — run before close
test/unit/Wave3RoadmapSyncTest.php	Assert checker passes on committed docs
ROADMAP #78	Phase 1 language row: point to wave3 doc, not open children
#1380 body	Comment “closed as umbrella; tracking continues in wave 2 #1238 + JIT audits”

Close #1380 comment template

Wave 3 language 12/12 + stdlib 13/13 on master (#1751). Remaining work is phase-2 / JIT-only — see #1936, #1776, #1238. Doc SSOT: docs/roadmap-wave3.md.

Acceptance criteria

• Roadmap wave 3: full PHP language + stdlib gaps tracker (#1354–#1379) #1380 closed; Wave 3 close-out: land remaining language + debug_backtrace (#1380 finish line) #1751 referenced as finish-line parent
• php script/check-wave3-roadmap-sync.php exits 0
• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 Phase 1 language row points to wave3 doc, not open children
• No new issues filed for closed Language: PHP 8 attributes (#[Attr] on classes, methods, properties) #1354–Stdlib: set_error_handler() — VM + LLVM JIT/AOT #1379 items without “phase 2” label

Verification (local / Docker only)

docker run --rm -v "$(pwd):/compiler" -w /compiler php-compiler:22.04-dev \
  php script/check-wave3-roadmap-sync.php
WAVE3_ROADMAP_SYNC_GATE=1 ./script/ci-fast.sh --filter Wave3RoadmapSync

No GitHub Actions.

Dependencies

• CI: Default WAVE3_ROADMAP_SYNC_GATE=1 in ci-fast after #1811 doc sync #1814 ✅ — default-on wave3 sync gate
• Language: PHP 8 attributes (#[Attr] on classes, methods, properties) #1354 ✅, Wave 3 close-out: land remaining language + debug_backtrace (#1380 finish line) #1751 ✅
• Deferrals: Language: PHP 8 attributes — JIT/AOT reflection (phase 2 of #1354) #1936 (attributes reflection), stdlib JIT audit (JIT: spl_autoload_register compile-time lowering (#1369 phase 2) #1776)

Links

• docs/roadmap-wave3.md, ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78
• Umbrella to close: Roadmap wave 3: full PHP language + stdlib gaps tracker (#1354–#1379) #1380

[PurHur]

PM sync — batch 93

Prerequisite already met: umbrella #1380 is closed on master. This issue is doc/SSOT hygiene only.

Correction: deferral for attributes JIT/AOT reflection is #1936 (open), not #1934 (#1934 was init-sessionsweb parity — merged).

Suggested order: after #1904 (ATTRIBUTES_COMPLIANCE_GATE default-on), then:

1. Wave 3 banner in docs/roadmap-wave3.md
2. Align 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 language row to “12/12 + 13/13” (not “13/13 language”)
3. Close this issue + final comment on Roadmap wave 3: full PHP language + stdlib gaps tracker (#1354–#1379) #1380 (if not already)

No implementation required for wave3 language/stdlib — track #1936 separately.

[PurHur]

Implementation hints (batch 94)

Files to touch

File	Action
docs/roadmap-wave3.md	Banner: “Wave 3 complete (May 2026)” + link #1751 ✅; deferrals → #1936, #1776, #1238
docs/capabilities-syntax.md	Regenerate via php script/capability-syntax.php — attributes row: VM ✅, reflection 📋 #1936
script/check-wave3-roadmap-sync.php	Ensure closed PR table matches roadmap-wave3.md (already in ci-fast via WAVE3_ROADMAP_SYNC_GATE=1)
GitHub #1380	Close with comment listing 12/12 language + 13/13 stdlib; point to #1936 for phase 2

Close #1380 checklist

• No open rows in docs/roadmap-wave3.md for Language: PHP 8 attributes (#[Attr] on classes, methods, properties) #1354–Stdlib: set_error_handler() — VM + LLVM JIT/AOT #1379 batch (except explicit “deferred” footnotes)
• php script/check-wave3-roadmap-sync.php exit 0
• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 Phase 1 language: wave 3 ✅, long tail Language: Closures and anonymous functions #72 / Language: Arrow functions (fn() => expr) #142 / Language: throw expressions and Exception object propagation #195 only
• Flip CI: Default ATTRIBUTES_COMPLIANCE_GATE=1 in ci-fast after #1354 lands #1904 ATTRIBUTES_COMPLIANCE_GATE=1 before or with this close-out (canonical tracker; CI: ATTRIBUTES_COMPLIANCE_GATE default-on in ci-fast (flip #1904) #1948 was dup)

Optional local audit (no GHA)

gh issue list --state open --label "wave-3" --limit 50  # should be empty or deferrals only
php script/check-wave3-roadmap-sync.php
WAVE3_ROADMAP_SYNC_GATE=1 ./script/ci-fast.sh --filter Wave3RoadmapSync

Depends: #1354 ✅ (#1925), #1751 ✅.

[PurHur]

PM sync — batch 103 (doc hygiene only)

Status unchanged: implementation not required for wave3 language/stdlib — track deferrals #1936 (attributes reflection), #1776 (spl_autoload JIT).

Already true on master:

• Umbrella Roadmap wave 3: full PHP language + stdlib gaps tracker (#1354–#1379) #1380 closed
• docs/roadmap-wave3.md tables show 12/12 language + 13/13 stdlib

Remaining acceptance (doc/SSOT):

• Wave 3 “complete” banner at top of docs/roadmap-wave3.md (links Wave 3 close-out: land remaining language + debug_backtrace (#1380 finish line) #1751, deferrals Language: PHP 8 attributes — JIT/AOT reflection (phase 2 of #1354) #1936 / JIT: spl_autoload_register compile-time lowering (#1369 phase 2) #1776 / Language features wave 2: JIT/syntax gaps tracker (#1222–#1235) #1238)
• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 Phase 1 language row: “12/12 + 13/13” wording (batch 103 touched index; phase table may still say “13/13 language”)
• php script/check-wave3-roadmap-sync.php exit 0 in Docker
• development-status.md public page still shows stale “10/13 · 12/13” at a glance — align or note repo-only SSOT is roadmap-wave3.md

Optional: ATTRIBUTES_COMPLIANCE_GATE default-on (#1904) before closing this issue.

No open PRs; safe to pick as a docs-only PR when an implementer is available.

[PurHur]

PM status (batch 105): Umbrella #1380 already closed (2026-05-25). Remaining acceptance for this issue:

• Wave 3 complete banner at top of docs/roadmap-wave3.md (deferrals → Language: PHP 8 attributes — JIT/AOT reflection (phase 2 of #1354) #1936, JIT: spl_autoload_register compile-time lowering (#1369 phase 2) #1776, Language features wave 2: JIT/syntax gaps tracker (#1222–#1235) #1238)
• ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 Phase 1 language row points to docs/roadmap-wave3.md (not stale open children)
• php script/check-wave3-roadmap-sync.php green in Docker dev image

No open PRs blocking doc-only close-out.

[PurHur]

PM status — batch 106

• Umbrella Roadmap wave 3: full PHP language + stdlib gaps tracker (#1354–#1379) #1380 ✅ closed
• docs/roadmap-wave3.md on master shows 12/12 language + 13/13 stdlib complete
• Remaining checklist items here still open: wave-3 complete banner, capabilities-syntax.md attributes row → Language: PHP 8 attributes — JIT/AOT reflection (phase 2 of #1354) #1936, ROADMAP 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 phase-1 language row pointer

No open PRs blocking doc-only close-out.

[PurHur]

Batch 108 reminder

Wave 3 complete on master since #1354 ✅ (#1925). Remaining work here is documentation hygiene only:

1. Close Roadmap wave 3: full PHP language + stdlib gaps tracker (#1354–#1379) #1380 with final comment + pointer to docs/roadmap-wave3.md
2. Fix 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 / development-status.md stale "10/13" language counts (overlaps Docs: development-status.md — sync 006 FileUploadWeb + NS2 M3 strict emit #2039)
3. Attributes reflection deferral stays Language: PHP 8 attributes — JIT/AOT reflection (phase 2 of #1354) #1936 — do not reopen Language: PHP 8 attributes (#[Attr] on classes, methods, properties) #1354

No implementation required for close-out. Suggested order: merge doc PR for #1939 → close #1380 → optional script/audit-wave3-issues.sh (local gh only).

Parent timeline: #78 batch 108.

[PurHur]

Batch 109 — ready to close after doc PR

Umbrella #1380 is already closed; docs/roadmap-wave3.md shows 12/12 language + 13/13 stdlib on master.

Remaining work (docs-only):

• Add explicit “wave 3 complete” note to docs/pages/development-status.md (may overlap Docs: development-status.md — sync 006 FileUploadWeb + NS2 M3 strict emit #2039)
• Run php script/check-wave3-roadmap-sync.php in Docker CI
• Link this issue from 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 when closed

No compiler implementation required — small doc PR can close this.