MODEL: GPT-5.4-codex

REASONING: high

COMMAND:
Create PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.

PURPOSE:
Implement Network Sample C - Divergence / Trace Validation, add its Level 11 games hub card using the existing debug-showcase card format, update NETWORK_SAMPLES_PLAN.md to Track P in progress, and update BIG_PICTURE_ROADMAP.md to remove broken icons and keep plain-text Track T / Track U headings. Do not add a new top section to games/index.html. Do not include engine-core, server-dashboard, or docker implementation in this PR.

Author: DavidQ

docs/dev/BIG_PICTURE_ROADMAP.md

@@ -1,126 +1,29 @@
-⚠️ RULE:
-This file is a status tracker only.
-ONLY modify bracket states [ ] [.] [x].
-Do NOT change structure or wording.
-
----
-
-# 🧭 Debug Platform & Ecosystem Roadmap
-
-## Status Legend
-- [ ] Todo
-- [.] In Progress
-- [x] Complete
-
----
-
-# 🧱 TRACK A — DEBUG FOUNDATION (COMPLETE)
-
-- [x] Dev Console (input + command execution)
-- [x] Debug Overlay (visual panels)
-- [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
-
-- [x] PLAN_PR_DEBUG_SURFACES_PROMOTION
-- [x] BUILD_PR_DEBUG_SURFACES_PROMOTION
-- [x] APPLY_PR_DEBUG_SURFACES_PROMOTION
-
----
-
-# 📦 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
-
-- [x] PLAN_PR_DEBUG_SURFACES_PRESETS
-- [x] BUILD_PR_DEBUG_SURFACES_PRESETS
-- [x] APPLY_PR_DEBUG_SURFACES_PRESETS
-
----
-
-# 🧰 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
-
-- [x] PLAN_PR_DEBUG_SURFACES_GAME_INTEGRATION
-- [x] BUILD_PR_DEBUG_SURFACES_GAME_INTEGRATION
-- [x] APPLY_PR_DEBUG_SURFACES_GAME_INTEGRATION
-- [x] Sample game uses full debug platform
-- [x] Toggle debug in production-safe mode
-- [x] Performance-safe overlays
-- [x] Build-time debug flags
-
----
-
-# 🌐 TRACK G — NETWORK / MULTIPLAYER DEBUG
-
-- [x] 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] APPLY_PR_DEBUG_SURFACES_NETWORK_SUPPORT
-
----
-
-# 🧊 TRACK H — 3D DEBUG SUPPORT
-
-- [.] Transform inspector
-- [x] BUILD_PR_DEBUG_SURFACES_3D_SUPPORT
-- [x] APPLY_PR_DEBUG_SURFACES_3D_SUPPORT
-- [ ] Camera debug panel
-- [ ] Render pipeline stages
-- [ ] Collision overlays
-- [ ] Scene graph inspector
-
----
-
-# 🔬 TRACK I — INSPECTORS & TOOLING
-
-- [x] Entity inspector
-- [x] Component inspector
-- [x] State diff viewer
-- [x] Timeline debugger
-- [x] Event stream viewer
-
----
-
-# 🧠 TRACK J — ENGINE MATURITY
-
-- [x] Stable debug API
-- [x] Plugin system
-- [x] External documentation
-- [x] Versioned contracts
-- [x] Performance benchmarks
-
----
-
-# 🏁 END STATE
-
-A complete system:
-
-- Engine Core → minimal contracts
-- Engine Debug → reusable platform
-- Standard Library → shared baseline
-- Presets → usability layer
-- Extensions → 3D, network, inspectors
+# BIG_PICTURE_ROADMAP
+
+## Roadmap Patch Guidance For Next PR
+This bundle intentionally provides a text-only roadmap direction for the next Codex step because the prior session reported broken icon rendering in the big picture roadmap.
+
+### Required Cleanup
+- remove broken decorative icons from the affected network/debug roadmap area
+- use plain text headings only for the relevant tracks
+- preserve existing ordering and surrounding roadmap structure
+
+### Required Network/Debug Sequence
+- Track N - Network Sample Foundation
+- Track O - Host / Client Sample
+- Track P - Divergence / Trace Sample
+- Track T - Server Dashboard
+- Track U - Server Containerization
+
+### Level Mapping
+- Level 11 - Network Games
+- Phase 13 - Network Concepts, Latency & Simulation (1301-1315)
+
+### Plain-Text Upcoming Tracks
+Track T - Server Dashboard
+Track U - Server Containerization
+
+### Notes For Codex
+- apply this as a minimal cleanup/update to the existing file
+- do not introduce new icon glyphs or emoji in the repaired section
+- keep wording aligned with `docs/dev/NETWORK_SAMPLES_PLAN.md`

docs/dev/CODEX_COMMANDS.md

@@ -1,8 +1,8 @@
 MODEL: GPT-5.4-codex
-REASONING: medium
+REASONING: high
 
 COMMAND:
-Create PR_DEBUG_SURFACES_NETWORK_SAMPLE_B_INTEGRATION_FULL
+Create PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.
 
 PURPOSE:
-Add Network Sample B to games/index.html under Level 11 and update tracking docs.
+Implement Network Sample C - Divergence / Trace Validation, add its Level 11 games hub card using the existing debug-showcase card format, update NETWORK_SAMPLES_PLAN.md to Track P in progress, and update BIG_PICTURE_ROADMAP.md to remove broken icons and keep plain-text Track T / Track U headings. Do not add a new top section to games/index.html. Do not include engine-core, server-dashboard, or docker implementation in this PR.

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-docs(network-sample-b): package Level 11 integration verification and Track O tracking alignment
+docs(network-sample-c): plan Level 11 divergence/trace sample and roadmap cleanup

docs/dev/NETWORK_SAMPLES_PLAN.md

@@ -36,12 +36,12 @@ Track the staged network sample journey for debug surface support using a strict
 
 # TRACK P — DIVERGENCE / TRACE SAMPLE
 
-- [ ] Sample C — Divergence / Trace Validation
-- [ ] Deterministic mismatch scenario
-- [ ] Event sequencing timeline
-- [ ] Divergence explanation notes
-- [ ] Reproduction guide
-- [ ] Validation checklist
+- [.] Sample C — Divergence / Trace Validation
+- [x] Deterministic mismatch scenario
+- [x] Event sequencing timeline
+- [x] Divergence explanation notes
+- [x] Reproduction guide
+- [.] Validation checklist
 
 ---
 
@@ -79,29 +79,29 @@ Track the staged network sample journey for debug surface support using a strict
 
 # TRACK T — SERVER DASHBOARD
 
-- [x] Server dashboard shell
-- [x] Player statistics view
-- [x] Latency view
-- [x] RX bytes view
-- [x] TX bytes view
-- [x] Connection/session counts
-- [x] Per-player status rows
-- [x] Refresh/update strategy
-- [x] Debug-only access rules
+- [ ] Server dashboard shell
+- [ ] Player statistics view
+- [ ] Latency view
+- [ ] RX bytes view
+- [ ] TX bytes view
+- [ ] Connection/session counts
+- [ ] Per-player status rows
+- [ ] Refresh/update strategy
+- [ ] Debug-only access rules
 
 ---
 
 # TRACK U — SERVER CONTAINERIZATION
 
-- [x] Dockerfile for server
-- [x] .dockerignore
-- [x] Environment variable contract
-- [x] Local run command
-- [x] Compose-ready service definition
-- [x] Port mapping rules
-- [x] Health/readiness check
-- [x] Logging/output expectations
-- [x] Container debug notes
+- [ ] Dockerfile for server
+- [ ] .dockerignore
+- [ ] Environment variable contract
+- [ ] Local run command
+- [ ] Compose-ready service definition
+- [ ] Port mapping rules
+- [ ] Health/readiness check
+- [ ] Logging/output expectations
+- [ ] Container debug notes
 
 ## Recommended Execution Order
 1. Sample A

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL
+BUILD_PR_DEBUG_SURFACES_SERVER_DASHBOARD_FOUNDATION

docs/dev/reports/change_summary.txt

@@ -1,13 +1,9 @@
-Created PR_DEBUG_SURFACES_NETWORK_SAMPLE_B_INTEGRATION_FULL as an integration-focused bundle.
+Prepared a docs-only continuation bundle for the next repo workflow step.
 
-Delivered:
-- Added integration PR docs for PLAN/BUILD/APPLY under docs/pr.
-- Verified Sample B card presence in `games/index.html` Level 11 using the existing Debug Showcase card pattern.
-- Verified Sample B card includes Play, Debug, and docs links.
-- Verified Track O checklist remains complete (`[x]`) in `docs/dev/NETWORK_SAMPLES_PLAN.md`.
+Included:
+- PLAN/BUILD/APPLY PR docs for PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL
+- refreshed NETWORK_SAMPLES_PLAN with Sample C in progress and T/U reset to future work
+- big-picture roadmap patch guidance to remove broken icons
+- codex command, commit comment, next command, and validation/report files
 
-Scope preserved:
-- no server changes
-- no container changes
-- no engine changes
-- no top section additions or page structure changes
+No implementation code is included.

docs/dev/reports/file_tree.txt

@@ -1,11 +1,15 @@
-docs/pr/PLAN_PR_DEBUG_SURFACES_NETWORK_SAMPLE_B_INTEGRATION.md
-docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_B_INTEGRATION.md
-docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_B_INTEGRATION.md
-docs/dev/CODEX_COMMANDS.md
-docs/dev/COMMIT_COMMENT.txt
-docs/dev/NEXT_COMMAND.txt
-docs/dev/NETWORK_SAMPLES_PLAN.md
-docs/dev/reports/change_summary.txt
-docs/dev/reports/file_tree.txt
-docs/dev/reports/validation_checklist.txt
-games/index.html
+docs/
+  dev/
+    BIG_PICTURE_ROADMAP.md
+    NETWORK_SAMPLES_PLAN.md
+    codex_commands.md
+    commit_comment.txt
+    next_command.txt
+    reports/
+      change_summary.txt
+      file_tree.txt
+      validation_checklist.txt
+  pr/
+    APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md
+    BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md
+    PLAN_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md

docs/dev/reports/validation_checklist.txt

@@ -1,21 +1,9 @@
-Workflow
-- [x] PLAN created
-- [x] BUILD created
-- [x] APPLY created
-
-Integration Targets
-- [x] Network Sample B card present under Level 11 in games/index.html
-- [x] Card follows existing Debug Showcase pattern
-- [x] Play link present for Sample B
-- [x] Debug link present for Sample B
-- [x] Docs links present for Sample B
-
-Tracking
-- [x] Track O checklist verified as [x] in docs/dev/NETWORK_SAMPLES_PLAN.md
-- [x] no BIG_PICTURE_ROADMAP.md update required
-
-Safety
-- [x] no server changes
-- [x] no container changes
-- [x] no engine changes
-- [x] no top section additions
+[ ] Bundle is docs-only
+[ ] Workflow preserved as PLAN_PR -> BUILD_PR -> APPLY_PR
+[ ] Sample C named consistently as Divergence / Trace Validation
+[ ] games/index.html guidance says card-level update only
+[ ] No new top section allowed in games/index.html
+[ ] NETWORK_SAMPLES_PLAN shows Track P in progress
+[ ] Track T and Track U are present and not falsely marked complete
+[ ] BIG_PICTURE_ROADMAP guidance removes broken icons
+[ ] Codex command points to PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL

docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md

@@ -0,0 +1,31 @@
+Toolbox Aid
+David Quesenberry
+04/06/2026
+APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md
+
+# APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL
+
+## Apply Scope
+Apply the docs-first Sample C planning slice and use it as the Codex-ready instruction set for the next Level 11 network implementation PR.
+
+## In Scope Files
+- `docs/pr/PLAN_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md`
+- `docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md`
+- `docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.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
+- bundle remains docs-only
+- workflow stays `PLAN_PR -> BUILD_PR -> APPLY_PR`
+- Sample C is clearly defined as the next Level 11 card and implementation target
+- Track P is in progress
+- Track T and Track U remain visible for upcoming work
+- roadmap guidance explicitly removes broken icons instead of reintroducing them
+
+## Output
+`<project folder>/tmp/PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL_bundle.zip`

docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md

@@ -0,0 +1,43 @@
+Toolbox Aid
+David Quesenberry
+04/06/2026
+BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md
+
+# BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL
+
+## Build Summary
+Prepared the next docs-first implementation package for the Level 11 network sequence so Codex can build **Network Sample C - Divergence / Trace Validation** without skipping the repo workflow.
+
+## Deliverables In This Bundle
+1. PR planning docs for Sample C full implementation
+2. Updated `docs/dev/NETWORK_SAMPLES_PLAN.md`
+3. Roadmap guidance for `docs/dev/BIG_PICTURE_ROADMAP.md`
+4. Codex command, commit comment, next command, and validation reports
+
+## Implementation Direction
+### 1) Games Hub
+- add Sample C to `games/index.html` under **Level 11 - Network Games**
+- use the existing debug showcase card format already used by Network Sample A and Network Sample B
+- do not add a new top section and do not replace the page body structure
+
+### 2) Sample C Experience
+- deterministic divergence scenario
+- event sequencing timeline
+- divergence explanation notes
+- reproduction guide
+- validation checklist
+- safe Play-first / Debug-second onboarding language
+
+### 3) Tracking Docs
+- move Track P to in-progress for Sample C
+- keep Track T (server dashboard) and Track U (server containerization) listed as future tracks unless implementation is actually present
+
+### 4) Roadmap Hygiene
+- remove broken icon usage in the big-picture roadmap network/debug section
+- keep plain-text Track T and Track U headings
+- preserve existing roadmap ordering and wording where possible
+
+## Scope Safety
+- no code is included in this bundle
+- no engine API changes are requested here
+- no server/container code is included in this PR package