PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_FULL - Adds fake network sample and debug surfaces

Author: DavidQ

docs/dev/BIG_PICTURE_ROADMAP.md

@@ -72,11 +72,11 @@ Do NOT change structure or wording.
 
 # 🌐 TRACK G — NETWORK / MULTIPLAYER DEBUG
 
-- [.] Connection status panel
-- [ ] Latency / RTT panel
+- [x] Connection status panel
+- [x] Latency / RTT panel
 - [ ] Replication state viewer
 - [ ] Client/server divergence inspector
-- [ ] Event tracing
+- [x] Event tracing
 - [x] PLAN_PR_DEBUG_SURFACES_NETWORK_SUPPORT
 - [x] BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT
 - [x] APPLY_PR_DEBUG_SURFACES_NETWORK_SUPPORT
@@ -124,3 +124,4 @@ A complete system:
 - Standard Library → shared baseline
 - Presets → usability layer
 - Extensions → 3D, network, inspectors
+

docs/dev/CODEX_COMMANDS.md

@@ -1,26 +1,7 @@
-MODEL: GPT-5.4-codex
+MODEL: GPT-5.4-codex
 REASONING: high
 
 COMMAND:
-Create PR_DEBUG_SURFACES_NETWORK_SUPPORT_FULL
+Create PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_FULL
 
-PURPOSE:
-Define the full network / multiplayer debug support path, including staged samples, using PLAN_PR + BUILD_PR + APPLY_PR in one bundle.
-
-IN SCOPE:
-- 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:
-- 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_DEBUG_SURFACES_NETWORK_SUPPORT_FULL_bundle.zip
+(See PLAN/BUILD/APPLY docs for scope)

docs/dev/COMMIT_COMMENT.txt

@@ -1,2 +1,2 @@
-PR_DEBUG_SURFACES_NETWORK_SUPPORT_FULL
-docs: define complete sample-backed network debug support path and staged execution plan
+PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_FULL
+build(sample-network): add Sample A loopback network debug sample with provider/panel/command integration

docs/dev/NETWORK_SAMPLES_PLAN.md

@@ -1,4 +1,4 @@
-Toolbox Aid
+Toolbox Aid
 David Quesenberry
 04/06/2026
 NETWORK_SAMPLES_PLAN.md
@@ -17,11 +17,11 @@ Track staged network sample progress used to validate multiplayer debug support
 
 # TRACK N - NETWORK SAMPLE FOUNDATION
 
-- [ ] Sample A - Local Loopback / Fake Network
-- [ ] Synthetic connection lifecycle
-- [ ] Synthetic RTT feed
-- [ ] Synthetic replication feed
-- [ ] Trace event feed
+- [x] Sample A - Local Loopback / Fake Network
+- [x] Synthetic connection lifecycle
+- [x] Synthetic RTT feed
+- [x] Synthetic replication feed
+- [x] Trace event feed
 
 ---
 
@@ -49,33 +49,33 @@ Track staged network sample progress used to validate multiplayer debug support
 
 # TRACK Q - NETWORK DEBUG PANELS
 
-- [ ] Connection status panel
-- [ ] Latency / RTT panel
+- [x] Connection status panel
+- [x] Latency / RTT panel
 - [ ] Replication state viewer
 - [ ] Client/server divergence inspector
-- [ ] Event tracing panel
+- [x] Event tracing panel
 
 ---
 
 # TRACK R - NETWORK DEBUG COMMANDS
 
-- [ ] network.help
-- [ ] network.status
+- [x] network.help
+- [x] network.status
 - [ ] network.connections
-- [ ] network.latency
+- [x] network.latency
 - [ ] network.replication
 - [ ] network.divergence
-- [ ] network.trace
+- [x] network.trace
 - [ ] network.sample.*
 
 ---
 
 # TRACK S - READINESS TO PROMOTE
 
-- [ ] Sample-backed provider validation
-- [ ] Sample-backed panel validation
-- [ ] Operator command validation
-- [ ] Debug-only gating validation
+- [.] Sample-backed provider validation
+- [.] Sample-backed panel validation
+- [.] Operator command validation
+- [x] Debug-only gating validation
 - [ ] Promotion recommendation
 
 ## Recommended Execution Order
@@ -84,4 +84,4 @@ Track staged network sample progress used to validate multiplayer debug support
 3. Sample B
 4. Replication and authority and divergence
 5. Sample C
-6. Promotion review
+6. Promotion review

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_FULL
+PR_DEBUG_SURFACES_NETWORK_SAMPLE_B_FULL

docs/dev/reports/change_summary.txt

@@ -1,22 +1,11 @@
-Toolbox Aid
-David Quesenberry
-04/06/2026
-change_summary.txt
-
-Executed PR_DEBUG_SURFACES_NETWORK_SUPPORT_FULL as a docs-first PLAN/BUILD/APPLY bundle.
-
-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 engine-core changes
-- No runtime/UI changes
-- No non-bracket edits in BIG_PICTURE roadmap
-- Network support remains sample-backed
+Implemented Sample A network debug surfaces as a sample-level integration with no engine-core changes.
+
+What was built:
+- New game sample at games/network_sample_a with fake loopback telemetry.
+- Synthetic connection lifecycle, latency, replication backlog, and trace events.
+- Sample debug plugin with read-only provider descriptors.
+- Overlay panels for connection status, latency/RTT, and trace events.
+- Console commands: network.help, network.status, network.latency, network.trace [count].
+- Overlay and console remain hidden by default until explicit user action.
+- Sample A PLAN/BUILD/APPLY docs finalized.
+- Network sample plan and roadmap states updated for completed Sample A slice.

docs/dev/reports/file_tree.txt

@@ -1,16 +1,16 @@
-Toolbox Aid
-David Quesenberry
-04/06/2026
-file_tree.txt
-
-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/pr/PLAN_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A.md
+docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A.md
+docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A.md
 docs/dev/CODEX_COMMANDS.md
 docs/dev/COMMIT_COMMENT.txt
 docs/dev/NEXT_COMMAND.txt
+docs/dev/NETWORK_SAMPLES_PLAN.md
+docs/dev/BIG_PICTURE_ROADMAP.md
 docs/dev/reports/change_summary.txt
 docs/dev/reports/validation_checklist.txt
-docs/dev/reports/file_tree.txt
+docs/dev/reports/file_tree.txt
+games/network_sample_a/index.html
+games/network_sample_a/main.js
+games/network_sample_a/debug/networkSampleADebug.js
+games/network_sample_a/game/FakeLoopbackNetworkModel.js
+games/network_sample_a/game/NetworkSampleAScene.js

docs/dev/reports/validation_checklist.txt

@@ -1,20 +1,27 @@
-Toolbox Aid
-David Quesenberry
-04/06/2026
-validation_checklist.txt
+Workflow
+- [x] PLAN created
+- [x] BUILD created
+- [x] APPLY 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
+Sample A Runtime
+- [x] Sample opens from games/network_sample_a/index.html
+- [x] Fake loopback telemetry updates
+- [x] Connection lifecycle controls (disconnect/reconnect)
+- [x] Synthetic RTT and replication values update
 
-Validation checks:
-- `git diff -- docs/dev/BIG_PICTURE_ROADMAP.md`
-- `git diff --name-only`
-- `tar -tf tmp/PR_DEBUG_SURFACES_NETWORK_SUPPORT_FULL_bundle.zip`
+Debug Surfaces
+- [x] Connection status panel renders
+- [x] Latency panel renders
+- [x] Event trace panel renders
+- [x] Overlay hidden by default until explicit open
+
+Commands
+- [x] network.help
+- [x] network.status
+- [x] network.latency
+- [x] network.trace
+
+Scope Safety
+- [x] No engine core files modified
+- [x] Sample-level integration only
+- [x] Roadmap edits are bracket-only

docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A.md

@@ -0,0 +1,29 @@
+Toolbox Aid
+David Quesenberry
+04/06/2026
+APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A.md
+
+# APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A
+
+## Apply Scope
+Apply the approved Sample A implementation exactly:
+- add `games/network_sample_a/` sample files
+- wire fake telemetry into diagnostics context
+- register Sample A debug plugin panels/providers/commands
+- update docs and reports for Sample A status
+
+## Validation Targets
+- Sample opens from `games/network_sample_a/index.html`.
+- Fake telemetry updates continuously.
+- Overlay panels show connection, latency, and trace data.
+- `network.status`, `network.latency`, and `network.trace` execute successfully.
+- No engine core files are modified.
+
+## Roadmap State Updates
+Bracket-only status updates in `docs/dev/BIG_PICTURE_ROADMAP.md`:
+- Connection status panel -> `[x]`
+- Latency / RTT panel -> `[x]`
+- Event tracing -> `[x]`
+
+## Output
+`<project folder>/tmp/PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_FULL_bundle.zip`

docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A.md

@@ -0,0 +1,38 @@
+Toolbox Aid
+David Quesenberry
+04/06/2026
+BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A.md
+
+# BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A
+
+## Build Summary
+Built a new sample-owned network diagnostics slice at `games/network_sample_a/` using fake loopback telemetry and existing public debug integration APIs.
+
+## Implemented Scope
+1. Fake network model
+- synthetic phases (`disconnected`, `connecting`, `synchronizing`, `connected`)
+- synthetic RTT and jitter feed
+- synthetic replication counters and backlog
+- bounded trace event feed
+
+2. Sample integration
+- new sample entry HTML and boot path
+- debug integration wired with overlay hidden by default
+- sample controls for packet inject/disconnect/reconnect
+
+3. Debug plugin
+- read-only provider descriptors for connection/latency/trace
+- passive overlay panels:
+  - connection status
+  - latency / RTT
+  - event trace
+- operator commands:
+  - `network.help`
+  - `network.status`
+  - `network.latency`
+  - `network.trace [count]`
+
+## Scope Safety
+- no engine core API changes
+- no runtime transport/protocol work
+- sample-level integration only