PR_DEBUG_SURFACES_NETWORK_SUPPORT_FULL

Defines the docs-first network / multiplayer debug support path with staged network samples.

Includes:
- PLAN / BUILD / APPLY PR docs
- NETWORK_SAMPLES_PLAN.md
- bracket-only BIG_PICTURE_ROADMAP updates

No engine-core changes.

Author: DavidQ

docs/dev/BIG_PICTURE_ROADMAP.md

@@ -1,11 +1,11 @@
-⚠️ RULE:
+⚠️ RULE:
 This file is a status tracker only.
 ONLY modify bracket states [ ] [.] [x].
 Do NOT change structure or wording.
 
 ---
 
-# 🧭 Debug Platform & Ecosystem Roadmap
+# 🧭 Debug Platform & Ecosystem Roadmap
 
 ## Status Legend
 - [ ] Todo
@@ -14,51 +14,51 @@ Do NOT change structure or wording.
 
 ---
 
-# 🧱 TRACK A — DEBUG FOUNDATION (COMPLETE)
+# 🧱 TRACK A — DEBUG FOUNDATION (COMPLETE)
 
 - [x] Dev Console (input + command execution)
 - [x] Debug Overlay (visual panels)
-- [x] Console ↔ Overlay Boundary
+- [x] Console ↔ Overlay Boundary
 - [x] Panel Registry
 - [x] Data Providers (read-only model)
 - [x] Operator Commands (control surface)
 - [x] Panel Persistence
 
 ---
 
-# 🚀 TRACK B — PROMOTION TO ENGINE LAYER
+# 🚀 TRACK B — PROMOTION TO ENGINE LAYER
 
 - [x] PLAN_PR_DEBUG_SURFACES_PROMOTION
 - [x] BUILD_PR_DEBUG_SURFACES_PROMOTION
 - [x] APPLY_PR_DEBUG_SURFACES_PROMOTION
 
 ---
 
-# 📦 TRACK C — STANDARD DEBUG LIBRARY
+# 📦 TRACK C — STANDARD DEBUG LIBRARY
 
 - [x] PLAN_PR_DEBUG_SURFACES_STANDARD_LIBRARY
 - [x] BUILD_PR_DEBUG_SURFACES_STANDARD_LIBRARY
 - [x] APPLY_PR_DEBUG_SURFACES_STANDARD_LIBRARY
 
 ---
 
-# 🎛️ TRACK D — DEBUG PRESETS
+# 🎛️ TRACK D — DEBUG PRESETS
 
 - [x] PLAN_PR_DEBUG_SURFACES_PRESETS
 - [x] BUILD_PR_DEBUG_SURFACES_PRESETS
 - [x] APPLY_PR_DEBUG_SURFACES_PRESETS
 
 ---
 
-# 🧰 TRACK E — ADVANCED DEBUG UX
+# 🧰 TRACK E — ADVANCED DEBUG UX
 
 - [x] PLAN_PR_DEBUG_SURFACES_ADVANCED_UX
 - [x] BUILD_PR_DEBUG_SURFACES_ADVANCED_UX
 - [x] APPLY_PR_DEBUG_SURFACES_ADVANCED_UX
 
 ---
 
-# 🎮 TRACK F — GAME INTEGRATION
+# 🎮 TRACK F — GAME INTEGRATION
 
 - [x] PLAN_PR_DEBUG_SURFACES_GAME_INTEGRATION
 - [x] BUILD_PR_DEBUG_SURFACES_GAME_INTEGRATION
@@ -70,20 +70,20 @@ Do NOT change structure or wording.
 
 ---
 
-# 🌐 TRACK G — NETWORK / MULTIPLAYER DEBUG
+# 🌐 TRACK G — NETWORK / MULTIPLAYER DEBUG
 
 - [.] Connection status panel
 - [ ] Latency / RTT panel
 - [ ] Replication state viewer
 - [ ] Client/server divergence inspector
 - [ ] Event tracing
-- [.] PLAN_PR_DEBUG_SURFACES_NETWORK_SUPPORT
-- [ ] BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT
+- [x] PLAN_PR_DEBUG_SURFACES_NETWORK_SUPPORT
+- [x] BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT
 - [x] APPLY_PR_DEBUG_SURFACES_NETWORK_SUPPORT
 
 ---
 
-# 🧊 TRACK H — 3D DEBUG SUPPORT
+# 🧊 TRACK H — 3D DEBUG SUPPORT
 
 - [.] Transform inspector
 - [x] BUILD_PR_DEBUG_SURFACES_3D_SUPPORT
@@ -95,7 +95,7 @@ Do NOT change structure or wording.
 
 ---
 
-# 🔬 TRACK I — INSPECTORS & TOOLING
+# 🔬 TRACK I — INSPECTORS & TOOLING
 
 - [x] Entity inspector
 - [x] Component inspector
@@ -105,7 +105,7 @@ Do NOT change structure or wording.
 
 ---
 
-# 🧠 TRACK J — ENGINE MATURITY
+# 🧠 TRACK J — ENGINE MATURITY
 
 - [x] Stable debug API
 - [x] Plugin system
@@ -115,12 +115,12 @@ Do NOT change structure or wording.
 
 ---
 
-# 🏁 END STATE
+# 🏁 END STATE
 
 A complete system:
 
-- Engine Core → minimal contracts
-- Engine Debug → reusable platform
-- Standard Library → shared baseline
-- Presets → usability layer
-- Extensions → 3D, network, inspectors
+- Engine Core → minimal contracts
+- Engine Debug → reusable platform
+- Standard Library → shared baseline
+- Presets → usability layer
+- Extensions → 3D, network, inspectors

docs/dev/CODEX_COMMANDS.md

@@ -1,23 +1,26 @@
-MODEL: GPT-5.3-codex
-REASONING: low
+MODEL: GPT-5.4-codex
+REASONING: high
 
 COMMAND:
-Create PR_PRODUCTIZATION_ROADMAP_CLOSEOUT_FULL
+Create PR_DEBUG_SURFACES_NETWORK_SUPPORT_FULL
 
 PURPOSE:
-Perform a bracket-only closeout pass on docs/dev/PRODUCTIZATION_ROADMAP.md after the showcase, UX polish, distribution starter, documentation/adoption, and safe game-card finish work.
+Define the full network / multiplayer debug support path, including staged samples, using PLAN_PR + BUILD_PR + APPLY_PR in one bundle.
 
 IN SCOPE:
-- bracket-only updates in PRODUCTIZATION_ROADMAP.md
-- mark completed items based on finished productization work
-- update docs/pr, docs/dev control files, and reports for the closeout bundle
+- PLAN_PR_DEBUG_SURFACES_NETWORK_SUPPORT
+- BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT
+- APPLY_PR_DEBUG_SURFACES_NETWORK_SUPPORT
+- docs/dev/NETWORK_SAMPLES_PLAN.md
+- bracket-only updates to docs/dev/BIG_PICTURE_ROADMAP.md
 
 RULES:
-- plan + build + apply in one bundle
-- PRODUCTIZATION_ROADMAP.md bracket-only edits only
-- do not modify BIG_PICTURE_ROADMAP.md
-- no engine changes
-- no UI changes
+- docs-first
+- one PR per purpose
+- no engine-core pollution
+- keep network support sample-backed
+- BIG_PICTURE_ROADMAP.md bracket-only edits only
+- do not change wording or structure outside brackets
 
 OUTPUT:
-<project folder>/tmp/PR_PRODUCTIZATION_ROADMAP_CLOSEOUT_FULL_bundle.zip
+<project folder>/tmp/PR_DEBUG_SURFACES_NETWORK_SUPPORT_FULL_bundle.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1,2 +1,2 @@
-PR_PRODUCTIZATION_ROADMAP_CLOSEOUT_FULL
-docs: close out productization roadmap tracks via bracket-only completion updates
+PR_DEBUG_SURFACES_NETWORK_SUPPORT_FULL
+docs: define complete sample-backed network debug support path and staged execution plan

docs/dev/NETWORK_SAMPLES_PLAN.md

@@ -0,0 +1,87 @@
+Toolbox Aid
+David Quesenberry
+04/06/2026
+NETWORK_SAMPLES_PLAN.md
+
+# NETWORK_SAMPLES_PLAN
+
+## Purpose
+Track staged network sample progress used to validate multiplayer debug support before any promotion beyond sample-backed scope.
+
+## Status Legend
+- [ ] Todo
+- [.] In Progress
+- [x] Complete
+
+---
+
+# TRACK N - NETWORK SAMPLE FOUNDATION
+
+- [ ] Sample A - Local Loopback / Fake Network
+- [ ] Synthetic connection lifecycle
+- [ ] Synthetic RTT feed
+- [ ] Synthetic replication feed
+- [ ] Trace event feed
+
+---
+
+# TRACK O - HOST / CLIENT SAMPLE
+
+- [ ] Sample B - Host / Client Diagnostics
+- [ ] Host status panel data
+- [ ] Client status panel data
+- [ ] Authority / ownership visibility
+- [ ] Replication snapshot visibility
+- [ ] Divergence warning surface
+
+---
+
+# TRACK P - DIVERGENCE / TRACE SAMPLE
+
+- [ ] Sample C - Divergence / Trace Validation
+- [ ] Deterministic mismatch scenario
+- [ ] Event sequencing timeline
+- [ ] Divergence explanation notes
+- [ ] Reproduction guide
+- [ ] Validation checklist
+
+---
+
+# TRACK Q - NETWORK DEBUG PANELS
+
+- [ ] Connection status panel
+- [ ] Latency / RTT panel
+- [ ] Replication state viewer
+- [ ] Client/server divergence inspector
+- [ ] Event tracing panel
+
+---
+
+# TRACK R - NETWORK DEBUG COMMANDS
+
+- [ ] network.help
+- [ ] network.status
+- [ ] network.connections
+- [ ] network.latency
+- [ ] network.replication
+- [ ] network.divergence
+- [ ] network.trace
+- [ ] network.sample.*
+
+---
+
+# TRACK S - READINESS TO PROMOTE
+
+- [ ] Sample-backed provider validation
+- [ ] Sample-backed panel validation
+- [ ] Operator command validation
+- [ ] Debug-only gating validation
+- [ ] Promotion recommendation
+
+## Recommended Execution Order
+1. Sample A
+2. Connection and RTT and tracing basics
+3. Sample B
+4. Replication and authority and divergence
+5. Sample C
+6. Promotion review

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-PLAN_PR_PRODUCTIZATION_ROADMAP_MAINTENANCE_GUARDRAILS
+PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_FULL

docs/dev/RULES_OF_ENGAGEMENT.md

@@ -9,7 +9,7 @@ RULES_OF_ENGAGEMENT.md
 This file is the canonical workflow and rules document for active repo operations.
 
 ## Required Workflow
-`PLAN_PR -> BUILD_PR -> APPLY_PR`
+`PLAN_PR + BUILD_PR + APPLY_PR`
 
 ## Core Rules
 - Docs-first before implementation.

docs/dev/reports/change_summary.txt

@@ -3,19 +3,20 @@ David Quesenberry
 04/06/2026
 change_summary.txt
 
-Executed PLAN + BUILD + APPLY for PRODUCTIZATION_ROADMAP_CLOSEOUT.
+Executed PR_DEBUG_SURFACES_NETWORK_SUPPORT_FULL as a docs-first PLAN/BUILD/APPLY bundle.
 
-Closeout updates in `docs/dev/PRODUCTIZATION_ROADMAP.md` (bracket-only):
-- Track R
-  - Showcase landing page -> [x]
-  - Build packaging strategy -> [x]
-  - Asset bundling rules -> [x]
-- Track S
-  - Debug tour -> [x]
-  - Getting started guide -> [x]
-  - Example-driven docs -> [x]
+Included:
+- PLAN_PR_DEBUG_SURFACES_NETWORK_SUPPORT
+- BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT
+- APPLY_PR_DEBUG_SURFACES_NETWORK_SUPPORT
+- docs/dev/NETWORK_SAMPLES_PLAN.md
+- bracket-only update in docs/dev/BIG_PICTURE_ROADMAP.md
+
+Roadmap state update (Track G):
+- BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT: [.] -> [x]
 
 Scope guard:
-- No BIG_PICTURE roadmap changes.
-- No engine/runtime/UI changes.
-- Docs-only closeout bundle.
+- No engine-core changes
+- No runtime/UI changes
+- No non-bracket edits in BIG_PICTURE roadmap
+- Network support remains sample-backed

docs/dev/reports/file_tree.txt

@@ -3,10 +3,11 @@ David Quesenberry
 04/06/2026
 file_tree.txt
 
-docs/pr/PLAN_PR_PRODUCTIZATION_ROADMAP_CLOSEOUT.md
-docs/pr/BUILD_PR_PRODUCTIZATION_ROADMAP_CLOSEOUT.md
-docs/pr/APPLY_PR_PRODUCTIZATION_ROADMAP_CLOSEOUT.md
-docs/dev/PRODUCTIZATION_ROADMAP.md
+docs/pr/PLAN_PR_DEBUG_SURFACES_NETWORK_SUPPORT.md
+docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT.md
+docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SUPPORT.md
+docs/dev/NETWORK_SAMPLES_PLAN.md
+docs/dev/BIG_PICTURE_ROADMAP.md
 docs/dev/CODEX_COMMANDS.md
 docs/dev/COMMIT_COMMENT.txt
 docs/dev/NEXT_COMMAND.txt

docs/dev/reports/validation_checklist.txt

@@ -3,22 +3,18 @@ David Quesenberry
 04/06/2026
 validation_checklist.txt
 
-[x] PLAN closeout doc created
-[x] BUILD closeout doc created
-[x] APPLY closeout doc created
-[x] PRODUCTIZATION_ROADMAP updated via bracket-only edits
-[x] Track P targets complete
-[x] Track Q targets complete
-[x] Track R targets complete
-[x] Track S targets complete
-[x] No BIG_PICTURE_ROADMAP edits
-[x] No engine changes
-[x] No UI changes
-[x] Docs/dev control files updated
-[x] Reports updated
-[x] Repo-structured closeout ZIP created
+[x] PLAN_PR doc updated
+[x] BUILD_PR doc updated
+[x] APPLY_PR doc updated
+[x] NETWORK_SAMPLES_PLAN.md updated
+[x] BIG_PICTURE_ROADMAP updated using bracket-only edits
+[x] No wording/structure changes outside brackets in BIG_PICTURE roadmap
+[x] No engine-core changes
+[x] No UI/runtime changes
+[x] Network support remains sample-backed
+[x] Repo-structured bundle zip created
 
 Validation checks:
-- `git diff -- docs/dev/PRODUCTIZATION_ROADMAP.md`
+- `git diff -- docs/dev/BIG_PICTURE_ROADMAP.md`
 - `git diff --name-only`
-- `tar -tf tmp/PR_PRODUCTIZATION_ROADMAP_CLOSEOUT_FULL_bundle.zip`
+- `tar -tf tmp/PR_DEBUG_SURFACES_NETWORK_SUPPORT_FULL_bundle.zip`