Add Network Sample A to index + update plans

DavidQ · DavidQ · commit 5d28781b74bf · 2026-04-06T10:54:15.000-04:00
diff --git a/docs/dev/CODEX_COMMANDS.md b/docs/dev/CODEX_COMMANDS.md
@@ -1,26 +1,5 @@
-MODEL: GPT-5.4-codex
+﻿MODEL: GPT-5.4-codex
 REASONING: high
 
 COMMAND:
-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
+Execute PLAN+BUILD+APPLY for SAMPLE_A_INTEGRATION
diff --git a/docs/dev/COMMIT_COMMENT.txt b/docs/dev/COMMIT_COMMENT.txt
@@ -1,9 +1 @@
-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
+﻿build(hub): integrate Network Sample A debug showcase card into games index with existing card structure
diff --git a/docs/dev/NETWORK_SAMPLES_PLAN.md b/docs/dev/NETWORK_SAMPLES_PLAN.md
@@ -12,11 +12,11 @@ Track the staged network sample journey for debug surface support using a strict
 
 # 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
 
 ---
 
diff --git a/docs/dev/NEXT_COMMAND.txt b/docs/dev/NEXT_COMMAND.txt
@@ -1 +1 @@
-Next: PR_DEBUG_SURFACES_NETWORK_SERVER_DASHBOARD_FULL
+﻿PR_DEBUG_SURFACES_NETWORK_SERVER_OPS_FULL
diff --git a/docs/dev/reports/change_summary.txt b/docs/dev/reports/change_summary.txt
@@ -1,6 +1,11 @@
-Full PR bundle to extend the network plan with:
-- Track T — Server Dashboard
-- Track U — Server Containerization
+﻿Executed PLAN+BUILD+APPLY for SAMPLE_A_INTEGRATION.
 
-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.
+Implemented:
+- Added Network Sample A card to games/index.html using the existing anchor-card pattern.
+- Applied Debug Showcase label on the new card.
+- Confirmed navigation target path exists.
+- Preserved existing card order and hub structure.
+
+Out of scope preserved:
+- no server dashboard/containerization work
+- no engine/runtime changes
diff --git a/docs/dev/reports/file_tree.txt b/docs/dev/reports/file_tree.txt
@@ -1,10 +1,11 @@
-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/codex_commands.md
-docs/dev/commit_comment.txt
-docs/dev/next_command.txt
+﻿docs/pr/PLAN_PR_SAMPLE_A_INTEGRATION.md
+docs/pr/BUILD_PR_SAMPLE_A_INTEGRATION.md
+docs/pr/APPLY_PR_SAMPLE_A_INTEGRATION.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/dev/reports/file_tree.txt
+games/index.html
+games/network_sample_a/assets/preview.svg
diff --git a/docs/dev/reports/validation_checklist.txt b/docs/dev/reports/validation_checklist.txt
@@ -1,7 +1,15 @@
-[ ] 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
+﻿Workflow
+- [x] PLAN created
+- [x] BUILD created
+- [x] APPLY created
+
+Integration
+- [x] Sample A card added to games/index.html
+- [x] Existing card structure preserved
+- [x] Debug Showcase label present
+- [x] Navigation path exists
+
+Safety
+- [x] No layout/structure redesign
+- [x] No nested links/buttons
+- [x] No engine/runtime changes
diff --git a/docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_INTEGRATION.md b/docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_INTEGRATION.md
@@ -0,0 +1,4 @@
+# APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_INTEGRATION
+Apply changes exactly as defined.
+Output:
+<project folder>/tmp/PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_INTEGRATION_FULL_bundle.zip
diff --git a/docs/pr/APPLY_PR_SAMPLE_A_INTEGRATION.md b/docs/pr/APPLY_PR_SAMPLE_A_INTEGRATION.md
@@ -0,0 +1,25 @@
+﻿Toolbox Aid
+David Quesenberry
+04/06/2026
+APPLY_PR_SAMPLE_A_INTEGRATION.md
+
+# APPLY_PR_SAMPLE_A_INTEGRATION
+
+## Apply Scope
+Apply the approved hub-integration slice only.
+
+## Applied Files
+- `games/index.html`
+- `games/network_sample_a/assets/preview.svg`
+- PLAN/BUILD/APPLY docs for this PR
+- docs/dev control/report updates for this PR
+
+## Validation Checklist
+- New Sample A card present in Games hub.
+- Uses existing card structure.
+- Includes `Debug Showcase` badge.
+- Link resolves to `/games/network_sample_a/index.html`.
+- No layout/structure break.
+
+## Output
+`<project folder>/tmp/PR_SAMPLE_A_INTEGRATION_FULL_bundle.zip`
diff --git a/docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_INTEGRATION.md b/docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_INTEGRATION.md
@@ -0,0 +1,5 @@
+# BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_INTEGRATION
+- Insert Network Sample A card in games/index.html near other Debug Showcase entries
+- Update NETWORK_SAMPLES_PLAN.md (Sample A -> [x])
+- BIG_PICTURE_ROADMAP.md:
+  - Connection status panel [.] -> [x] if validated
diff --git a/docs/pr/BUILD_PR_SAMPLE_A_INTEGRATION.md b/docs/pr/BUILD_PR_SAMPLE_A_INTEGRATION.md
@@ -0,0 +1,31 @@
+﻿Toolbox Aid
+David Quesenberry
+04/06/2026
+BUILD_PR_SAMPLE_A_INTEGRATION.md
+
+# BUILD_PR_SAMPLE_A_INTEGRATION
+
+## Build Summary
+Integrated Sample A into the Games hub using the existing card markup and styling pattern.
+
+## Implemented
+1. Added one new card to `games/index.html`:
+- href: `/games/network_sample_a/index.html`
+- thumb: `/games/network_sample_a/assets/preview.svg`
+- badges: `Playable Now` and `Debug Showcase`
+- title: `Network Sample A (Debug Showcase)`
+- concise showcase description
+
+2. Reused/confirmed preview asset:
+- `games/network_sample_a/assets/preview.svg`
+
+## Scope Safety
+- No engine-core changes.
+- No layout structure changes.
+- No nested links/buttons.
+- Existing cards preserved in order.
+
+## Validation
+- Card exists in hub markup.
+- Route target exists.
+- Card conforms to existing anchor-card pattern.
diff --git a/docs/pr/PLAN_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_INTEGRATION.md b/docs/pr/PLAN_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_INTEGRATION.md
@@ -0,0 +1,11 @@
+# PLAN_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A_INTEGRATION
+Add Network Sample A to games/index.html and update tracking docs.
+
+Scope:
+- Add card to games/index.html
+- Update NETWORK_SAMPLES_PLAN.md
+- Bracket-only update to BIG_PICTURE_ROADMAP.md
+
+Constraints:
+- preserve order
+- no layout changes
diff --git a/docs/pr/PLAN_PR_SAMPLE_A_INTEGRATION.md b/docs/pr/PLAN_PR_SAMPLE_A_INTEGRATION.md
@@ -0,0 +1,36 @@
+﻿Toolbox Aid
+David Quesenberry
+04/06/2026
+PLAN_PR_SAMPLE_A_INTEGRATION.md
+
+# PLAN_PR_SAMPLE_A_INTEGRATION
+
+## Goal
+Make Sample A visible and directly accessible from the game/sample launcher without changing hub structure.
+
+## Workflow
+PLAN_PR -> BUILD_PR -> APPLY_PR
+
+## In Scope
+- Add `network_sample_a` card entry in `games/index.html`.
+- Follow existing card structure exactly.
+- Include `Debug Showcase` labeling.
+- Ensure navigation targets `/games/network_sample_a/index.html`.
+
+## Out Of Scope
+- Server dashboard work.
+- Server containerization work.
+- Engine/runtime changes.
+- Index layout or structure redesign.
+
+## Constraints
+- Preserve existing order of current cards.
+- No layout breaking.
+- No nested links/buttons.
+- No unrelated edits.
+
+## Acceptance Criteria
+- New Sample A card appears in hub.
+- Card uses current card pattern.
+- Card links correctly to Sample A route.
+- Existing card order remains intact.
diff --git a/games/index.html b/games/index.html
@@ -206,6 +206,15 @@ <h3>Level 4 - Classic Arcade</h3>
             </div>
           </a>
 
+          <a class="card" href="/games/network_sample_a/index.html">
+            <img class="thumb" src="/games/network_sample_a/assets/preview.svg" alt="Network Sample A debug showcase preview" />
+            <div class="cardBody">
+              <div class="tagRow"><span class="badge playable">Playable Now</span><span class="badge debug-showcase">Debug Showcase</span></div>
+              <div class="cardTitle">Network Sample A (Debug Showcase)</div>
+              <div class="cardDesc">Local loopback network diagnostics sample with connection, latency, and trace visibility through the shared debug surface workflow.</div>
+            </div>
+          </a>
+
         </div>
       </section>
 
diff --git a/games/network_sample_a/assets/preview.svg b/games/network_sample_a/assets/preview.svg
@@ -0,0 +1,46 @@
+﻿<!--
+Toolbox Aid
+David Quesenberry
+04/06/2026
+preview.svg
+-->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 960 540" role="img" aria-labelledby="title desc">
+  <title id="title">Network Sample A Debug Showcase</title>
+  <desc id="desc">Stylized dashboard card art with connection, latency, and trace diagnostics.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" x2="1" y1="0" y2="1">
+      <stop offset="0%" stop-color="#071325" />
+      <stop offset="100%" stop-color="#0f2a44" />
+    </linearGradient>
+    <linearGradient id="panel" x1="0" x2="0" y1="0" y2="1">
+      <stop offset="0%" stop-color="#0f1f35" />
+      <stop offset="100%" stop-color="#0b1524" />
+    </linearGradient>
+  </defs>
+
+  <rect width="960" height="540" fill="url(#bg)" />
+  <rect x="40" y="40" width="880" height="460" rx="16" fill="url(#panel)" stroke="#3f6b96" stroke-width="2" />
+
+  <text x="72" y="92" fill="#e2f2ff" font-size="34" font-family="monospace" font-weight="700">NETWORK SAMPLE A</text>
+  <text x="72" y="124" fill="#9fc4e4" font-size="18" font-family="monospace">Debug Showcase</text>
+
+  <rect x="72" y="154" width="390" height="150" rx="10" fill="#0f2238" stroke="#486f9a" />
+  <text x="92" y="184" fill="#c9e8ff" font-size="17" font-family="monospace">Connection: connected</text>
+  <text x="92" y="212" fill="#c9e8ff" font-size="17" font-family="monospace">RTT: 34ms</text>
+  <text x="92" y="240" fill="#c9e8ff" font-size="17" font-family="monospace">Jitter: 4ms</text>
+  <text x="92" y="268" fill="#c9e8ff" font-size="17" font-family="monospace">Pending: 1 packet</text>
+
+  <rect x="496" y="154" width="392" height="150" rx="10" fill="#0f2238" stroke="#486f9a" />
+  <text x="516" y="184" fill="#c9e8ff" font-size="17" font-family="monospace">Trace</text>
+  <text x="516" y="212" fill="#9fc4e4" font-size="15" font-family="monospace">1542ms PACKET_SENT</text>
+  <text x="516" y="236" fill="#9fc4e4" font-size="15" font-family="monospace">1684ms PACKET_ACKED</text>
+  <text x="516" y="260" fill="#9fc4e4" font-size="15" font-family="monospace">1829ms HEARTBEAT</text>
+
+  <rect x="72" y="336" width="816" height="126" rx="10" fill="#0f2238" stroke="#486f9a" />
+  <text x="92" y="372" fill="#b8ddfb" font-size="16" font-family="monospace">Shift + ` : Console</text>
+  <text x="92" y="398" fill="#b8ddfb" font-size="16" font-family="monospace">Ctrl + Shift + ` : Overlay</text>
+  <text x="92" y="424" fill="#b8ddfb" font-size="16" font-family="monospace">network.status | network.latency | network.trace</text>
+
+  <circle cx="840" cy="86" r="14" fill="#14b8a6" />
+  <text x="72" y="496" fill="#7fa7c8" font-size="14" font-family="monospace">/games/network_sample_a/index.html</text>
+</svg>

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-Next: PR_DEBUG_SURFACES_NETWORK_SERVER_DASHBOARD_FULL`
	`1`	`+PR_DEBUG_SURFACES_NETWORK_SERVER_OPS_FULL`