PR_DEBUG_SURFACES_NETWORK_SERVER_OPS_FULL

Adds Track T (Server Dashboard) and Track U (Server Containerization)
to the network samples plan.

Includes:
- PLAN / BUILD / APPLY PR docs
- NETWORK_SAMPLES_PLAN.md updates
- reports and active dev controls

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,5 +1,26 @@
-MODEL: GPT-5.4-codex
+MODEL: GPT-5.4-codex
 REASONING: high
 
 COMMAND:
-Create PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_FULL
+Create PR_DEBUG_SURFACES_NETWORK_SERVER_OPS_FULL
+
+PURPOSE:
+Extend the network support plan with:
+- Track T — Server Dashboard
+- Track U — Server Containerization
+
+IN SCOPE:
+- PLAN_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS
+- BUILD_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS
+- APPLY_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS
+- docs/dev/NETWORK_SAMPLES_PLAN.md updates for Track T and Track U
+
+RULES:
+- docs-first
+- one PR per purpose
+- preserve checklist style [ ] [.] [x]
+- no engine-core changes
+- no unrelated roadmap edits
+
+OUTPUT:
+<project folder>/tmp/PR_DEBUG_SURFACES_NETWORK_SERVER_OPS_FULL_bundle.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1,2 +1,9 @@
-PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_FULL
-build(sample-network): deliver Sample A loopback diagnostics with network panels and commands
+PR_DEBUG_SURFACES_NETWORK_SERVER_OPS_FULL
+
+Adds Track T (Server Dashboard) and Track U (Server Containerization)
+to the network samples plan.
+
+Includes:
+- PLAN / BUILD / APPLY PR docs
+- NETWORK_SAMPLES_PLAN.md updates
+- reports and active dev controls

docs/dev/NETWORK_SAMPLES_PLAN.md

@@ -1,12 +1,7 @@
-Toolbox Aid
-David Quesenberry
-04/06/2026
-NETWORK_SAMPLES_PLAN.md
-
-# NETWORK_SAMPLES_PLAN
+# NETWORK_SAMPLES_PLAN
 
 ## Purpose
-Track staged network sample progress used to validate multiplayer debug support before any promotion beyond sample-backed scope.
+Track the staged network sample journey for debug surface support using a strict checklist process.
 
 ## Status Legend
 - [ ] Todo
@@ -15,19 +10,19 @@ Track staged network sample progress used to validate multiplayer debug support
 
 ---
 
-# TRACK N - NETWORK SAMPLE FOUNDATION
+# TRACK N — NETWORK SAMPLE FOUNDATION
 
-- [x] Sample A - Local Loopback / Fake Network
-- [x] Synthetic connection lifecycle
-- [x] Synthetic RTT feed
-- [x] Synthetic replication feed
-- [x] Trace event feed
+- [ ] Sample A — Local Loopback / Fake Network
+- [ ] Synthetic connection lifecycle
+- [ ] Synthetic RTT feed
+- [ ] Synthetic replication feed
+- [ ] Trace event feed
 
 ---
 
-# TRACK O - HOST / CLIENT SAMPLE
+# TRACK O — HOST / CLIENT SAMPLE
 
-- [ ] Sample B - Host / Client Diagnostics
+- [ ] Sample B — Host / Client Diagnostics
 - [ ] Host status panel data
 - [ ] Client status panel data
 - [ ] Authority / ownership visibility
@@ -36,9 +31,9 @@ Track staged network sample progress used to validate multiplayer debug support
 
 ---
 
-# TRACK P - DIVERGENCE / TRACE SAMPLE
+# TRACK P — DIVERGENCE / TRACE SAMPLE
 
-- [ ] Sample C - Divergence / Trace Validation
+- [ ] Sample C — Divergence / Trace Validation
 - [ ] Deterministic mismatch scenario
 - [ ] Event sequencing timeline
 - [ ] Divergence explanation notes
@@ -47,41 +42,71 @@ Track staged network sample progress used to validate multiplayer debug support
 
 ---
 
-# TRACK Q - NETWORK DEBUG PANELS
+# TRACK Q — NETWORK DEBUG PANELS
 
-- [x] Connection status panel
-- [x] Latency / RTT panel
+- [ ] Connection status panel
+- [ ] Latency / RTT panel
 - [ ] Replication state viewer
 - [ ] Client/server divergence inspector
-- [x] Event tracing panel
+- [ ] Event tracing panel
 
 ---
 
-# TRACK R - NETWORK DEBUG COMMANDS
+# TRACK R — NETWORK DEBUG COMMANDS
 
-- [x] network.help
-- [x] network.status
+- [ ] network.help
+- [ ] network.status
 - [ ] network.connections
-- [x] network.latency
+- [ ] network.latency
 - [ ] network.replication
 - [ ] network.divergence
-- [x] network.trace
+- [ ] network.trace
 - [ ] network.sample.*
 
 ---
 
-# TRACK S - READINESS TO PROMOTE
+# TRACK S — READINESS TO PROMOTE
 
-- [.] Sample-backed provider validation
-- [.] Sample-backed panel validation
-- [.] Operator command validation
-- [x] Debug-only gating validation
+- [ ] Sample-backed provider validation
+- [ ] Sample-backed panel validation
+- [ ] Operator command validation
+- [ ] Debug-only gating validation
 - [ ] Promotion recommendation
 
+---
+
+# TRACK T — SERVER DASHBOARD
+
+- [ ] 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
+
+- [ ] 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
-2. Connection and RTT and tracing basics
+2. Connection + RTT + tracing basics
 3. Sample B
-4. Replication and authority and divergence
+4. Replication + authority + divergence
 5. Sample C
-6. Promotion review
+6. Server dashboard
+7. Server containerization
+8. Promotion review

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-PR_DEBUG_SURFACES_NETWORK_SAMPLE_B_FULL
+Next: PR_DEBUG_SURFACES_NETWORK_SERVER_DASHBOARD_FULL

docs/dev/reports/change_summary.txt

@@ -1,13 +1,6 @@
-Implemented PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_FULL as a sample-level network debug diagnostics slice.
+Full PR bundle to extend the network plan with:
+- Track T — Server Dashboard
+- Track U — Server Containerization
 
-Scope delivered:
-- PLAN/BUILD/APPLY docs for Sample A.
-- New sample at games/network_sample_a.
-- Fake loopback model for connection lifecycle, RTT/jitter, replication backlog, and trace events.
-- Sample-owned debug plugin panels/providers/commands.
-- Dev control files and reports refreshed for this PR.
-- Track G bracket-only roadmap updates for Connection status, Latency/RTT, and Event tracing.
-
-Safety:
-- No engine core API modifications.
-- No transport/protocol implementation.
+The dashboard track covers player statistics, latency, RX/TX bytes, and connection counts.
+The container track covers Docker packaging and runtime guidance for the server.

docs/dev/reports/file_tree.txt

@@ -1,16 +1,10 @@
-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/pr/PLAN_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS.md
+docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS.md
+docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS.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/change_summary.txt
 docs/dev/reports/validation_checklist.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/file_tree.txt

docs/dev/reports/validation_checklist.txt

@@ -1,25 +1,7 @@
-Workflow
-- [x] PLAN created
-- [x] BUILD created
-- [x] APPLY created
-
-Sample A Runtime
-- [x] Sample opens from games/network_sample_a/index.html
-- [x] Synthetic telemetry updates continuously
-- [x] Disconnect/reconnect controls work
-
-Debug Surfaces
-- [x] Connection status panel renders
-- [x] Latency / RTT panel renders
-- [x] Event tracing panel renders
-
-Commands
-- [x] network.help
-- [x] network.status
-- [x] network.latency
-- [x] network.trace
-
-Scope Safety
-- [x] No engine core files changed
-- [x] Sample-level integration only
-- [x] Roadmap edits are bracket-only
+[ ] PLAN_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS created
+[ ] BUILD_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS created
+[ ] APPLY_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS created
+[ ] NETWORK_SAMPLES_PLAN Track T added
+[ ] NETWORK_SAMPLES_PLAN Track U added
+[ ] Checklist format preserved
+[ ] No unrelated roadmap edits

docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS.md

@@ -0,0 +1,27 @@
+Toolbox Aid
+David Quesenberry
+04/06/2026
+APPLY_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS.md
+
+# APPLY_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS
+
+## Apply Scope
+Apply the approved docs-first Server Ops extension only:
+- `PLAN_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS`
+- `BUILD_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS`
+- `APPLY_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS`
+- `docs/dev/NETWORK_SAMPLES_PLAN.md` updates for Track T and Track U
+
+## Apply Rules
+- no engine-core changes
+- no unrelated roadmap edits
+- preserve checklist style `[ ]`, `[.]`, `[x]`
+- keep scope limited to this PR purpose
+
+## Validation
+- Track T section exists and is checklist-based
+- Track U section exists and is checklist-based
+- No runtime or engine files included
+
+## Output
+`<project folder>/tmp/PR_DEBUG_SURFACES_NETWORK_SERVER_OPS_FULL_bundle.zip`

docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS.md

@@ -0,0 +1,44 @@
+Toolbox Aid
+David Quesenberry
+04/06/2026
+BUILD_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS.md
+
+# BUILD_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS
+
+## Build Summary
+Built the docs-only Server Ops expansion for network debug support by formalizing Track T and Track U in the network samples planning checklist.
+
+## Implemented Scope
+1. Track T - Server Dashboard checklist contract
+- 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
+
+2. Track U - Server Containerization checklist contract
+- Dockerfile
+- .dockerignore
+- environment variable contract
+- local run command
+- compose-ready service definition
+- port mapping rules
+- health/readiness check
+- logging/output expectations
+- container debug notes
+
+## Rules Applied
+- docs-first only
+- one PR purpose only
+- no engine-core changes
+- no unrelated roadmap edits
+- checklist style preserved (`[ ]`, `[.]`, `[x]`)
+
+## Validation Targets
+- Track T present in `docs/dev/NETWORK_SAMPLES_PLAN.md`
+- Track U present in `docs/dev/NETWORK_SAMPLES_PLAN.md`
+- Checklist style preserved for both tracks

docs/pr/PLAN_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS.md

@@ -0,0 +1,54 @@
+Toolbox Aid
+David Quesenberry
+04/06/2026
+PLAN_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS.md
+
+# PLAN_PR_DEBUG_SURFACES_NETWORK_SERVER_OPS
+
+## Goal
+Extend network support planning with two new tracks:
+- Track T - Server Dashboard
+- Track U - Server Containerization
+
+## Workflow
+PLAN_PR -> BUILD_PR -> APPLY_PR
+
+## In Scope
+- Define the planning contract for server operations inside the network debug support stream.
+- Add Track T and Track U checklist sections in `docs/dev/NETWORK_SAMPLES_PLAN.md`.
+- Keep all work docs-first and checklist-driven.
+
+## Out Of Scope
+- Engine-core code changes.
+- Runtime multiplayer implementation.
+- Protocol-specific transport implementation.
+- Unrelated roadmap edits.
+
+## Track T - Server Dashboard (Planning Contract)
+Define a dashboard track that includes:
+- server dashboard shell
+- player statistics view
+- latency view
+- RX/TX byte visibility
+- connection and session counts
+- per-player status rows
+- refresh/update strategy
+- debug-only access rules
+
+## Track U - Server Containerization (Planning Contract)
+Define a containerization track that includes:
+- Dockerfile
+- .dockerignore
+- environment variable contract
+- local run command
+- compose-ready service definition
+- port mapping rules
+- health/readiness check
+- logging/output expectations
+- container debug notes
+
+## Acceptance Criteria
+- Track T exists in NETWORK_SAMPLES_PLAN with checklist states.
+- Track U exists in NETWORK_SAMPLES_PLAN with checklist states.
+- Checklist style remains `[ ]`, `[.]`, `[x]`.
+- No engine-core or unrelated roadmap changes.