Apply advanced shared server dashboard on promoted network debug layer with read-only commands, metrics, refresh modes, and roadmap tracker updates.

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,2 +1,27 @@
 MODEL: GPT-5.4-codex
-COMMAND: APPLY_PR_DEBUG_SURFACES_NETWORK_PROMOTION
+REASONING: high
+
+COMMAND:
+Follow PLAN_PR + BUILD_PR + APPLY_PR
+
+Create APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED
+
+Requirements:
+- Docs-first before implementation
+- No engine core changes
+- One PR per purpose
+- Build zip automatically to <project folder>/tmp/
+- Implement advanced shared server dashboard under engine/debug/network/dashboard
+- Keep providers read-only
+- No console coupling
+- No overlay coupling
+- No persistence
+- Add:
+  - serverDashboardViewModel.js
+  - serverDashboardMetrics.js
+  - serverDashboardRefreshModes.js
+  - registerDashboardCommands.js
+- Extend host/registry/renderer through public APIs only
+- Validate imports, snapshot normalization, refresh modes, command outputs, and sample plugin parity
+- Update roadmap trackers with bracket-only edits only
+- Roadmaps live under docs/roadmaps/

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-Apply network promotion build
+Apply advanced shared server dashboard under engine/debug/network/dashboard with read-only providers, refresh modes, view-model metrics, dashboard command pack registration, targeted validation coverage, and bracket-only NETWORK_SAMPLES_PLAN tracker updates.

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-APPLY_PR_DEBUG_SURFACES_NETWORK_PROMOTION
+PLAN_PR_DEBUG_SURFACES_NETWORK_SERVER_CONTAINER

docs/dev/reports/change_summary.txt

@@ -1 +1,25 @@
-Network promotion build bundle.
+# Change Summary
+
+## Bundle
+APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED_delta
+
+## Scope Applied
+- Docs-first PLAN/BUILD/APPLY updates for server dashboard advanced work.
+- Added advanced shared dashboard modules under `engine/debug/network/dashboard`.
+- Extended host/registry/renderer through public APIs.
+- Added read-only `dashboard.*` command registration bridge.
+- Exported advanced dashboard modules from `engine/debug/network/index.js`.
+- Updated `docs/roadmaps/NETWORK_SAMPLES_PLAN.md` using bracket-only state edits.
+
+## Validation
+- Import and syntax checks for updated dashboard modules.
+- Snapshot normalization and metrics/view-model smoke coverage.
+- Refresh mode validation (`manual`, `normal`, `fast`).
+- Command output validation for `dashboard.help/status/refresh/mode/snapshot`.
+- Sample A/B/C plugin parity and provider read-only checks.
+
+## Constraints Kept
+- No engine core API changes.
+- No console coupling.
+- No overlay coupling.
+- No persistence.

docs/dev/reports/file_tree.txt

@@ -1,2 +1,28 @@
-docs/pr
- docs/dev
+HTML-JavaScript-Gaming/
+  docs/
+    pr/
+      PLAN_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md
+      BUILD_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md
+      APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md
+    dev/
+      CODEX_COMMANDS.md
+      COMMIT_COMMENT.txt
+      NEXT_COMMAND.txt
+      reports/
+        change_summary.txt
+        validation_checklist.txt
+        file_tree.txt
+    roadmaps/
+      NETWORK_SAMPLES_PLAN.md
+  engine/
+    debug/
+      network/
+        index.js
+        dashboard/
+          serverDashboardHost.js
+          serverDashboardRegistry.js
+          serverDashboardRenderer.js
+          serverDashboardMetrics.js
+          serverDashboardViewModel.js
+          serverDashboardRefreshModes.js
+          registerDashboardCommands.js

docs/dev/reports/validation_checklist.txt

@@ -1 +1,17 @@
-Validate network promotion.
+# Validation Checklist
+
+- [x] PLAN doc present
+- [x] BUILD doc present
+- [x] APPLY doc present
+- [x] Codex command present
+- [x] Commit comment present
+- [x] Next command present
+- [x] Dashboard modules scoped to engine/debug/network/dashboard
+- [x] No engine-core changes
+- [x] Providers remain read-only
+- [x] Commands use host public APIs only
+- [x] Refresh modes validated
+- [x] Snapshot normalization validated
+- [x] Sample A/B/C plugin parity checked
+- [x] Roadmap edits bracket-only only
+- [x] Zip built under <project folder>/tmp/

docs/pr/APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md

@@ -0,0 +1,53 @@
+Toolbox Aid
+David Quesenberry
+04/06/2026
+APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md
+
+# APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED
+
+## Apply Intent
+Implement advanced shared server dashboard behavior in `engine/debug/network/dashboard` with read-only providers and command-safe host APIs.
+
+## Guardrails
+- No engine core changes.
+- No console coupling.
+- No overlay coupling.
+- No persistence.
+- Keep implementation scoped to shared dashboard modules.
+
+## Required File Work
+- `engine/debug/network/dashboard/serverDashboardHost.js`
+- `engine/debug/network/dashboard/serverDashboardRegistry.js`
+- `engine/debug/network/dashboard/serverDashboardProviders.js`
+- `engine/debug/network/dashboard/serverDashboardRenderer.js`
+- `engine/debug/network/dashboard/serverDashboardViewModel.js`
+- `engine/debug/network/dashboard/serverDashboardMetrics.js`
+- `engine/debug/network/dashboard/serverDashboardRefreshModes.js`
+- `engine/debug/network/dashboard/registerDashboardCommands.js`
+- `engine/debug/network/index.js` (exports only)
+
+## Command Contract
+- `dashboard.help` lists commands and modes
+- `dashboard.status` returns mode, refresh status, section count, and key counts
+- `dashboard.refresh` triggers one immediate read-only refresh
+- `dashboard.mode` reads/sets refresh mode through host API
+- `dashboard.snapshot` returns normalized dashboard snapshot summary
+
+## Validation Sequence
+1. Import checks for all advanced dashboard modules.
+2. Snapshot normalization smoke test with mixed input shapes.
+3. Refresh mode checks for `manual`, `normal`, and `fast`.
+4. Command output checks via `registerDashboardCommands`.
+5. Sample plugin parity checks for Sample A/B/C network debug plugins.
+6. Confirm no engine core API files changed.
+
+## Roadmap Edits
+Only bracket state edits in:
+- `docs/roadmaps/NETWORK_SAMPLES_PLAN.md`
+- `docs/roadmaps/BIG_PICTURE_ROADMAP.md`
+
+No wording, ordering, or structure edits.
+
+## Packaging
+Build zip automatically at:
+`<project folder>/tmp/APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED_delta.zip`

docs/pr/BUILD_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md

@@ -0,0 +1,77 @@
+Toolbox Aid
+David Quesenberry
+04/06/2026
+BUILD_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md
+
+# BUILD_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED
+
+## Build Intent
+Prepare an implementation-ready APPLY package for advanced shared server dashboard behavior under `engine/debug/network/dashboard` while preserving read-only and decoupled architecture rules.
+
+## Authoritative Target Structure
+```text
+engine/debug/network/dashboard/
+  serverDashboardHost.js
+  serverDashboardRegistry.js
+  serverDashboardProviders.js
+  serverDashboardRenderer.js
+  serverDashboardViewModel.js
+  serverDashboardMetrics.js
+  serverDashboardRefreshModes.js
+  registerDashboardCommands.js
+```
+
+## Build Rules
+- No engine core changes.
+- Use public APIs for host/registry/renderer integration.
+- Keep providers read-only.
+- No console coupling.
+- No overlay coupling.
+- No persistence.
+
+## Public API Targets
+### Host
+- `refreshNow()`
+- `setRefreshMode(mode)`
+- `getStatus()`
+- `getSnapshot()`
+- `destroy()`
+
+### Registry
+- deterministic section registration/listing
+- visibility and priority controls through registry APIs
+- read-only section snapshots
+
+### Renderer
+- consume normalized snapshots/view model only
+- render advanced summary, latency, throughput, player, and connection/session sections
+
+### Commands
+- `dashboard.help`
+- `dashboard.status`
+- `dashboard.refresh`
+- `dashboard.mode <manual|normal|fast>`
+- `dashboard.snapshot`
+
+## Ordered Build Steps
+1. Add refresh mode definitions and normalization helpers.
+2. Add aggregate metrics calculator.
+3. Add snapshot-to-view-model normalization.
+4. Extend host for refresh lifecycle + command-safe APIs.
+5. Extend registry for deterministic section controls.
+6. Extend renderer to consume the new view model.
+7. Add dashboard command registration bridge using host APIs only.
+8. Export advanced dashboard modules from `engine/debug/network/index.js`.
+9. Run targeted validations.
+
+## Validation Targets
+- imports
+- snapshot normalization
+- refresh mode transitions
+- command outputs
+- sample plugin parity
+- providers remain read-only
+- no engine core changes
+
+## Packaging Target
+`<project folder>/tmp/APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED_delta.zip`

docs/pr/PLAN_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md

@@ -0,0 +1,62 @@
+Toolbox Aid
+David Quesenberry
+04/06/2026
+PLAN_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md
+
+# PLAN_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED
+
+## Workflow Discipline
+PLAN_PR -> BUILD_PR -> APPLY_PR
+
+## Purpose
+Advance the shared server dashboard under `engine/debug/network/dashboard` into a stronger read-only debugging surface without changing engine core APIs.
+
+## Scope
+In scope:
+- Add advanced dashboard modules:
+  - `serverDashboardViewModel.js`
+  - `serverDashboardMetrics.js`
+  - `serverDashboardRefreshModes.js`
+  - `registerDashboardCommands.js`
+- Extend dashboard host, registry, and renderer through public APIs only.
+- Keep providers read-only.
+- Validate imports, snapshot normalization, refresh modes, command outputs, and sample plugin parity.
+- Update roadmap trackers with bracket-only edits.
+
+Out of scope:
+- Engine core changes.
+- Console coupling.
+- Overlay coupling.
+- Persistence.
+- Server-dashboard, docker, or transport work.
+
+## Boundaries
+- Shared ownership: `engine/debug/network/dashboard/*`
+- Sample ownership: sample feeds and scenario data
+- Engine core ownership: no changes in this PR
+
+## Data Flow
+Sample/runtime snapshots
+-> read-only dashboard provider normalization
+-> dashboard metrics + view model
+-> dashboard renderer output
+-> dashboard commands through host public APIs
+
+## Validation Goals
+- New and updated dashboard modules import cleanly.
+- Snapshot normalization remains deterministic and read-only.
+- Refresh modes (`manual|normal|fast`) behave as documented.
+- `dashboard.*` commands return expected read-only outputs.
+- Sample A/B/C debug plugin parity remains intact.
+- No engine core files are changed.
+
+## Deliverables
+- `docs/pr/PLAN_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md`
+- `docs/pr/BUILD_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.md`
+- `docs/pr/APPLY_PR_DEBUG_SURFACES_SERVER_DASHBOARD_ADVANCED.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/file_tree.txt`
+- `docs/dev/reports/validation_checklist.txt`

docs/roadmaps/BIG_PICTURE_ROADMAP.md

@@ -1,10 +1,3 @@
-⚠️ 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
@@ -75,10 +68,10 @@ Do NOT change structure or wording.
 - [x] Connection status panel
 - [.] Latency / RTT panel
 - [ ] Replication state viewer
-- [ ] Client/server divergence inspector
+- [x] 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
 
 ---