Add full real-network capability lane before 3D, including hosted Docker server path

BUILD_PR_ROADMAP_ADD_FULL_NETWORK_CAPABILITY_BEFORE_3D

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,25 +1,31 @@
-
 MODEL: GPT-5.4
-REASONING: low
+REASONING: medium
 
 COMMAND:
-Create FINAL_SNAPSHOT_NON_3D_COMPLETE_WITH_DEFERRED_INFRA
+Create `BUILD_PR_ROADMAP_ADD_FULL_NETWORK_CAPABILITY_BEFORE_3D`.
 
-Steps:
-1. Update roadmap:
-   - ensure all non-3D items are [x]
-2. Add Deferred Infrastructure section:
-   - asset naming normalization
-   - manifest discovery
-   - include trigger conditions
-3. Ensure no duplicate entries remain elsewhere
-4. Do NOT modify any other text
+Roadmap-only update.
 
-Rules:
-- status-only PR
-- no code changes
-- no cleanup work
-- no restructuring
+Required work:
+1. Update `docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md`.
+2. Add a new roadmap lane for full real-network capability prior to 3D execution.
+3. Include explicit items for:
+   - real transport/session layer
+   - authoritative live server runtime
+   - replication/client application
+   - playable real multiplayer validation
+   - server hosting + Docker containerization
+   - promotion/readiness gate
+   - include samples for phase 13  
+4. Update sequencing/dependency wording so real-network capability is completed before active 3D execution begins.
+5. Preserve all already-complete network/debug/container items.
+6. Do NOT delete existing roadmap content.
+7. Do NOT rewrite unrelated roadmap text.
+8. Package the updated roadmap bundle into:
+   `<project folder>/tmp/BUILD_PR_ROADMAP_ADD_FULL_NETWORK_CAPABILITY_BEFORE_3D.zip`
 
-Output:
-<project folder>/tmp/FINAL_SNAPSHOT_NON_3D_COMPLETE_WITH_DEFERRED_INFRA.zip
+Hard rules:
+- roadmap update only
+- additive preferred
+- no code changes
+- no unrelated edits

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1,2 @@
-Final snapshot: non-3D complete, deferred infra separated
+Add full real-network capability lane before 3D, including hosted Docker server path
+BUILD_PR_ROADMAP_ADD_FULL_NETWORK_CAPABILITY_BEFORE_3D

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-PLAN_PR_3D_ENTRY_POINT
+PLAN_PR_REAL_NETWORK_CAPABILITY_ENTRY

docs/dev/reports/change_summary.txt

@@ -1 +1,3 @@
-Locked non-3D completion; moved remaining infra to deferred section
+- Added roadmap-update bundle to make full real-network capability a prerequisite before 3D
+- Includes live transport, authoritative server runtime, replication, playable validation, and Docker-hosted server items
+- Preserves existing completed network/debug/container work

docs/dev/reports/validation_checklist.txt

@@ -1 +1,7 @@
-status-only changes; no 3D; no cleanup; deferred section added
+- new real-network capability lane added to roadmap
+- hosted Docker server path explicitly included
+- 3D sequencing updated to depend on real-network completion
+- existing completed network items preserved
+- roadmap updated additively
+- output ZIP created at:
+  <project folder>/tmp/BUILD_PR_ROADMAP_ADD_FULL_NETWORK_CAPABILITY_BEFORE_3D.zip

docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md

@@ -606,12 +606,24 @@
 - [x] Add scripts to prep / update / delete the repo so it can be placed on a website
 - [x] Add scripts to switch between Pay-as-you-go and Codex plan modes, and scripts to input API key material and validate it
 
+### Full Real-Network Capability Lane (Required Before 3D Execution)
+- [ ] real transport/session layer
+- [ ] authoritative live server runtime
+- [ ] replication/client application
+- [ ] playable real multiplayer validation
+- [ ] server hosting + Docker containerization
+- [ ] promotion/readiness gate
+- [ ] include samples for phase 13
+
+### 3D Execution Dependency Gate
+- [ ] begin active phase-16 / 3D execution only after the full real-network capability lane is complete
+
 ### Later Capability Lanes
 - [x] FEATURE: Fullscreen Bezel Overlay System - Render game in full screen with optional bezel artwork layer (static or animated) surrounding the active playfield, preserving aspect ratio and supporting per-game/theme bezel assets without modifying core engine rendering.
 
 ### Later Capability Lanes
 - [x] Execute 2D capability polish lanes
-- [ ] Execute phase-16 / 3D capability lanes
+- [ ] Execute phase-16 / 3D capability lanes (after full real-network capability lane completion)
 
 ### Final Cleanup Lane
 - [x] Reduce legacy footprint after replacements are proven

docs/pr/BUILD_PR_ROADMAP_ADD_FULL_NETWORK_CAPABILITY_BEFORE_3D.md

@@ -0,0 +1,80 @@
+# BUILD_PR_ROADMAP_ADD_FULL_NETWORK_CAPABILITY_BEFORE_3D
+
+## Purpose
+Update the master roadmap so full real-network capability is explicitly completed before Phase 16 / 3D execution begins.
+
+## Intent
+The repo already has strong network simulation, diagnostics, promotion-readiness work, and server containerization foundations.
+This PR adds the remaining **real multiplayer capability** as an explicit roadmap lane and makes it a prerequisite before moving on to 3D execution.
+
+## Required roadmap update
+
+### A. Add a new non-3D lane before 3D execution
+Add a new roadmap section or dependency lane for:
+
+## Real Network Capability Completion (Pre-3D Gate)
+
+This lane should cover the missing real-network runtime capability needed to move from simulated/synthetic multiplayer to real hosted multiplayer.
+
+Include the following items:
+
+### Transport + Session Layer
+- [ ] real client/server transport selected and implemented
+- [ ] connection/session lifecycle for live clients implemented
+- [ ] message serialization/deserialization contract defined
+- [ ] reconnect/disconnect handling defined
+
+### Authoritative Live Server Runtime
+- [ ] authoritative live server tick loop implemented
+- [ ] client input intake path implemented
+- [ ] server-side authoritative state mutation path implemented
+- [ ] live replication output path implemented
+
+### Replication + Client Application
+- [ ] state snapshot and/or delta replication contract finalized
+- [ ] client replication apply path implemented
+- [ ] interpolation/reconciliation strategy defined and implemented at minimum viable level
+- [ ] divergence handling validated against live transport
+
+### Playable Real Multiplayer Validation
+- [ ] one real multiplayer sample runs over actual network transport
+- [ ] real host/client session validated end-to-end
+- [ ] live latency behavior validated
+- [ ] live replication behavior validated
+- [ ] debug surfaces integrated with live transport path
+
+### Server Hosting + Containerization
+- [ ] server runtime packaged for hosted deployment
+- [ ] Docker container to host the multiplayer server finalized
+- [ ] environment/runtime configuration documented
+- [ ] health/readiness contract validated in hosted mode
+- [ ] hosted server launch/run workflow documented
+
+### Promotion / Readiness Gate
+- [ ] real multiplayer path validated as stable enough for future game use
+- [ ] roadmap explicitly marks real network capability complete before 3D execution begins
+
+### B. Add dependency ordering
+Update roadmap sequencing so:
+- full real-network capability is completed before active 3D execution starts
+- 3D remains deferred until the real-network lane is closed or explicitly waived
+
+### C. Preserve existing completed work
+Do not rewrite or disturb already-complete network/debug/container items.
+This PR is additive and sequencing-focused.
+
+## Constraints
+- roadmap update only
+- no code changes
+- no text deletion
+- additive update preferred
+- status-only elsewhere
+
+## Validation
+Codex must report:
+- where the new network-capability lane was inserted
+- how 3D sequencing was updated
+- confirmation that existing completed network items were preserved
+
+## Packaging
+`<project folder>/tmp/BUILD_PR_ROADMAP_ADD_FULL_NETWORK_CAPABILITY_BEFORE_3D.zip`