MODEL: GPT-5.4-codex

REASONING: medium

COMMAND:
Execute PLAN + BUILD + APPLY for NETWORK_SAMPLE_A_INDEX_FIX

OUTPUT:
<project folder>/tmp/PR_NETWORK_SAMPLE_A_INDEX_FIX_FULL_bundle.zip

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,8 +1,8 @@
-MODEL: GPT-5.4-codex
+MODEL: GPT-5.4-codex
 REASONING: medium
 
 COMMAND:
 Execute PLAN + BUILD + APPLY for NETWORK_SAMPLE_A_INDEX_FIX
 
 OUTPUT:
-<project folder>/tmp/PR_NETWORK_SAMPLE_A_INDEX_FIX_FULL_bundle.zip
+<project folder>/tmp/PR_NETWORK_SAMPLE_A_INDEX_FIX_FULL_bundle.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-build(games-index): finalize Network Sample A index integration and visibility fix
+Fix Network Sample A integration in games/index.html, update NETWORK_SAMPLES_PLAN.md, and apply bracket-only BIG_PICTURE_ROADMAP.md updates.

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,7 +1 @@
-Executed PLAN + BUILD + APPLY for NETWORK_SAMPLE_A_INDEX_FIX.
-
-Result:
-- Network Sample A index integration was finalized in games/index.html.
-- Level 11 network placement and debug-showcase labeling are present.
-- Sample A route references are preserved.
-- No engine/runtime files changed.
+Safely patches games/index.html using the rolled-back current code base, places Network Sample A in Level 11 - Network Games, adds docs links, and updates network tracking docs.

docs/dev/reports/file_tree.txt

@@ -1,11 +1,12 @@
-docs/pr/PLAN_PR_NETWORK_SAMPLE_A_INDEX_FIX.md
+docs/pr/PLAN_PR_NETWORK_SAMPLE_A_INDEX_FIX.md
 docs/pr/BUILD_PR_NETWORK_SAMPLE_A_INDEX_FIX.md
 docs/pr/APPLY_PR_NETWORK_SAMPLE_A_INDEX_FIX.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/file_tree.txt
 docs/dev/reports/validation_checklist.txt
-games/index.html
-games/network_sample_a/assets/preview.svg
+docs/dev/reports/file_tree.txt
+games/index.html

docs/dev/reports/validation_checklist.txt

@@ -1,16 +1,7 @@
-Workflow
-- [x] PLAN created
-- [x] BUILD created
-- [x] APPLY created
-
-Index Fix
-- [x] games/index.html patched from current code base
-- [x] no top showcase section added
-- [x] Level 11 - Network Games set
-- [x] Network Sample A card visible
-- [x] docs links included on card
-
-Safety
-- [x] no engine changes
-- [x] no unrelated roadmap edits
-- [x] existing card order preserved
+[ ] games/index.html patched from current code base
+[ ] no top showcase section added
+[ ] Level 11 - Network Games set
+[ ] Network Sample A card added
+[ ] docs links added
+[ ] NETWORK_SAMPLES_PLAN updated
+[ ] BIG_PICTURE_ROADMAP bracket-only edits only

docs/pr/APPLY_PR_NETWORK_SAMPLE_A_INDEX_FIX.md

@@ -1,31 +1,8 @@
-Toolbox Aid
-David Quesenberry
-04/06/2026
-APPLY_PR_NETWORK_SAMPLE_A_INDEX_FIX.md
-
 # APPLY_PR_NETWORK_SAMPLE_A_INDEX_FIX
 
 ## Apply Scope
-Apply only the approved Network Sample A index fix bundle.
-
-## Files In Scope
-- `docs/pr/PLAN_PR_NETWORK_SAMPLE_A_INDEX_FIX.md`
-- `docs/pr/BUILD_PR_NETWORK_SAMPLE_A_INDEX_FIX.md`
-- `docs/pr/APPLY_PR_NETWORK_SAMPLE_A_INDEX_FIX.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`
-- `games/index.html`
-- `games/network_sample_a/assets/preview.svg`
-
-## Validation Targets
-- Sample A card visible in hub.
-- Sample A route works.
-- Existing layout/order preserved.
-- No engine changes.
+Apply the current-code-base patch exactly as defined.
 
 ## Output
-`<project folder>/tmp/PR_NETWORK_SAMPLE_A_INDEX_FIX_FULL_bundle.zip`
+Create:
+<project folder>/tmp/PR_NETWORK_SAMPLE_A_INDEX_FIX_FULL_bundle.zip

docs/pr/BUILD_PR_NETWORK_SAMPLE_A_INDEX_FIX.md

@@ -1,22 +1,21 @@
-Toolbox Aid
-David Quesenberry
-04/06/2026
-BUILD_PR_NETWORK_SAMPLE_A_INDEX_FIX.md
-
 # BUILD_PR_NETWORK_SAMPLE_A_INDEX_FIX
 
-## Build Summary
-Applied a surgical index integration fix for Network Sample A in `games/index.html`.
-
-## Implemented
-1. Ensured a dedicated `Level 11 - Network Games` playable section is present.
-2. Ensured `Network Sample A - Local Loopback / Fake Network` is visible as a card entry.
-3. Preserved `Debug Showcase` labeling on the Sample A entry.
-4. Kept card-level path references for Play/Debug and docs links as currently patterned.
-5. Preserved existing section and card ordering outside this scope.
+## Build Tasks
+- patch the current `games/index.html` instead of replacing it
+- keep existing legend/header structure intact
+- add a `Level 11 - Network Games` playable section
+- add `Network Sample A - Local Loopback / Fake Network` card
+- add card-level docs links for:
+  - Debug Tour
+  - Getting Started
+- update planned progression:
+  - `Level xx - Network Games` -> `Level 11 - Network Games`
+  - add `Network Sample A (Debug Showcase)` to the list
+- update `NETWORK_SAMPLES_PLAN.md` for Sample A progress
+- update `BIG_PICTURE_ROADMAP.md` with bracket-only edits only
 
 ## Validation
-- `games/index.html` contains `/games/network_sample_a/index.html`.
-- Sample A card title is present.
-- Level label is `Level 11 - Network Games`.
-- No engine/runtime files were modified.
+- no broad page deletion
+- no top showcase section added
+- Network Sample A belongs in `games/index.html`
+- roadmap edits limited to brackets

docs/pr/PLAN_PR_NETWORK_SAMPLE_A_INDEX_FIX.md

@@ -1,36 +1,27 @@
-Toolbox Aid
-David Quesenberry
-04/06/2026
-PLAN_PR_NETWORK_SAMPLE_A_INDEX_FIX.md
-
 # PLAN_PR_NETWORK_SAMPLE_A_INDEX_FIX
 
-## Goal
-Repair and finalize Network Sample A visibility in the launcher index while preserving the current page structure and ordering.
-
-## Workflow
-PLAN_PR -> BUILD_PR -> APPLY_PR
-
-## In Scope
-- `games/index.html` update/fix for Network Sample A integration.
-- Keep card structure aligned with existing index conventions.
-- Keep `Debug Showcase` labeling on Sample A entry.
-- Ensure navigation to `/games/network_sample_a/index.html`.
-- Update docs/dev control and report artifacts for this PR bundle.
+## Objective
+Finish the Network Sample A index integration safely using the current code base as source of truth.
 
-## Out Of Scope
-- Server dashboard/containerization tracks.
-- Engine/runtime changes.
-- Broad layout redesign of index pages.
+## Scope
+- update `games/index.html`
+- keep the current page structure intact
+- add Network Sample A card data directly to the game card area
+- place Network Sample A under `Level 11 - Network Games`
+- add documentation links on the card
+- update `docs/dev/NETWORK_SAMPLES_PLAN.md`
+- apply bracket-only updates to `docs/dev/BIG_PICTURE_ROADMAP.md`
 
 ## Constraints
-- Preserve existing order of existing cards/sections.
-- No top-level showcase block insertion.
-- No destructive edits.
-- No unrelated file changes.
+- do not add a top showcase section
+- do not delete or rewrite most of the page
+- preserve existing card/layout patterns
+- use `games/index.html` as the location
+- consider Phase 13 - Network Concepts, Latency & Simulation (1301-1315)
 
-## Acceptance Criteria
-- Sample A is visible in `games/index.html`.
-- Sample A navigation path is reachable.
-- Existing index structure/order is preserved.
-- Bundle packages only PR-relevant files.
+## Acceptance
+- page structure preserved
+- Level xx changed to Level 11
+- Network Sample A visible in playable and planned network locations
+- docs links included on the card
+- tracking docs updated