rename runtime execution directory from tests to launch — BUILD_PR_LEVEL_12_14_RUNTIME_LAUNCH_DIRECTORY_RENAME & return 1319 runtime entry points to sample server folder — BUILD_PR_LEVEL_12_15_SAMPLE_1319_RUNTIME_RETURN_TO_SERVER

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,28 +1,26 @@
 MODEL: GPT-5.4
 REASONING: high
 COMMAND:
-Implement BUILD_PR_LEVEL_12_13_SAMPLE_1319_ROOT_TESTS_AND_PS_RUNBOOK exactly as defined.
+Implement BUILD_PR_LEVEL_12_15_SAMPLE_1319_RUNTIME_RETURN_TO_SERVER exactly as defined.
 
 Required changes:
-1. move executable runtime files:
-   - tests/network-sample-1319/realNetworkServer.mjs
-   - tests/network-sample-1319/realNetworkDashboard.mjs
-   into:
-   - tests/network-sample-1319/realNetworkServer.mjs
-   - tests/network-sample-1319/realNetworkDashboard.mjs
+1. move:
+   - samples/phase-13/1319/server/realNetworkServer.mjs
+   - samples/phase-13/1319/server/realNetworkDashboard.mjs
+   to:
+   - samples/phase-13/1319/server/realNetworkServer.mjs
+   - samples/phase-13/1319/server/realNetworkDashboard.mjs
 
-2. keep samples/phase-13/1319/server/ for config/docs only
-3. update all references from sample-local tests path to repo-level tests path
-4. add a step-by-step PowerShell runbook for launching and validating sample 1319 from terminal
-5. keep docker-compose under samples/phase-13/1319/server/docker-compose.yml
-6. do not expand scope beyond relocation + runbook
+2. update all references to the corrected sample-local server paths
+3. remove samples/phase-13/1319/server/ if empty after the move
+4. do not change logic or behavior
 
 Validation required:
-- no remaining references to sample-local runtime .mjs paths
-- node tests/network-sample-1319/realNetworkServer.mjs boots
-- sample 1319 launches from samples/index.html
-- dashboard loads and updates
-- no regressions to launcher/sample pathing
+- no remaining references to samples/phase-13/1319/server/
+- node samples/phase-13/1319/server/realNetworkServer.mjs boots
+- dashboard endpoint loads
+- node tmp/validate_1319.mjs passes
+- samples/index.html still launches 1319
 
 Update docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md by changing status markers only.
 Do not modify roadmap wording, structure, add content, or delete content.

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-relocate 1319 runtime mjs files to repo-level tests and add PowerShell runbook — BUILD_PR_LEVEL_12_13_SAMPLE_1319_ROOT_TESTS_AND_PS_RUNBOOK
+return 1319 runtime entry points to sample server folder — BUILD_PR_LEVEL_12_15_SAMPLE_1319_RUNTIME_RETURN_TO_SERVER

docs/dev/reports/validation_checklist.txt

@@ -1,5 +1,4 @@
-- confirmed current 1319 layout
-- executable runtime mjs files targeted for repo-level tests relocation
-- all old sample-local test references must be removed
-- PowerShell runbook required
-- launcher and dashboard validation required
+- incorrect launch/ location corrected
+- 1319 runtime restored to sample-local server folder
+- references must be updated to server-local paths
+- validation remains execution-backed and testable

docs/pr/BUILD_PR_LEVEL_12_10_REAL_NETWORK_SAMPLE_AND_DASHBOARD.md

@@ -27,8 +27,8 @@ This BUILD fixes that properly by requiring:
 - `samples/phase-13/1319/game/RealNetworkLaunchScene.js`
 
 ### Real Server + Dashboard
-- `tests/network-sample-1319/realNetworkServer.mjs`
-- `tests/network-sample-1319/realNetworkDashboard.mjs`
+- `samples/phase-13/1319/server/realNetworkServer.mjs`
+- `samples/phase-13/1319/server/realNetworkDashboard.mjs`
 - `samples/phase-13/1319/server/README.md`
 - `samples/phase-13/1319/server/docker-compose.yml`
 

docs/pr/BUILD_PR_LEVEL_12_12_SAMPLE_1319_SERVER_TEST_RELOCATION.md

@@ -20,7 +20,7 @@ From:
 - samples/phase-13/1319/server/*.mjs
 
 To:
-- tests/network-sample-1319/*.mjs
+- samples/phase-13/1319/server/*.mjs
 
 ### Update References
 - Update ALL references to new paths

docs/pr/BUILD_PR_LEVEL_12_13_SAMPLE_1319_ROOT_TESTS_AND_PS_RUNBOOK.md

@@ -25,12 +25,12 @@ samples/phase-13/1319/
 
 ### A. Move Executable Runtime Files To Repo-Level tests/
 Move:
-- `tests/network-sample-1319/realNetworkServer.mjs`
-- `tests/network-sample-1319/realNetworkDashboard.mjs`
+- `samples/phase-13/1319/server/realNetworkServer.mjs`
+- `samples/phase-13/1319/server/realNetworkDashboard.mjs`
 
 To repo-level tests home:
-- `tests/network-sample-1319/realNetworkServer.mjs`
-- `tests/network-sample-1319/realNetworkDashboard.mjs`
+- `samples/phase-13/1319/server/realNetworkServer.mjs`
+- `samples/phase-13/1319/server/realNetworkDashboard.mjs`
 
 ### B. Keep Sample Folder Clean
 After relocation:
@@ -62,7 +62,7 @@ The PowerShell runbook must include:
 ### 1. Start the real server from repo root
 Use repo-level test path, not sample-local tests path.
 Example target command shape:
-- `node tests/network-sample-1319/realNetworkServer.mjs`
+- `node samples/phase-13/1319/server/realNetworkServer.mjs`
 
 ### 2. Start a local static file host for samples
 From repo root using PowerShell-friendly steps.
@@ -101,7 +101,7 @@ Document terminal commands from repo root for validation checks using the correc
 
 ## Important Path Correction
 The old command:
-- `node tests/network-sample-1319/realNetworkServer.mjs`
+- `node samples/phase-13/1319/server/realNetworkServer.mjs`
 
 must be replaced with the new repo-level path.
 
@@ -119,7 +119,7 @@ must be replaced with the new repo-level path.
 - repo-level test paths resolve correctly
 
 ### Runtime Validation
-- `node tests/network-sample-1319/realNetworkServer.mjs` starts successfully
+- `node samples/phase-13/1319/server/realNetworkServer.mjs` starts successfully
 - sample 1319 still connects correctly
 - dashboard still loads and updates
 

docs/pr/BUILD_PR_LEVEL_12_14_RUNTIME_LAUNCH_DIRECTORY_RENAME.md

@@ -0,0 +1,42 @@
+# BUILD_PR_LEVEL_12_14_RUNTIME_LAUNCH_DIRECTORY_RENAME
+
+## Purpose
+Rename misleading `tests/` runtime execution folder to a clearer `launch/` directory for real server execution.
+
+## Problem
+`tests/` implies validation-only usage, but these `.mjs` files are actual runtime entry points.
+
+## Solution
+Rename:
+- samples/phase-13/1319/server/
+
+To:
+- samples/phase-13/1319/server/
+
+## File Moves
+- samples/phase-13/1319/server/realNetworkServer.mjs → samples/phase-13/1319/server/realNetworkServer.mjs
+- samples/phase-13/1319/server/realNetworkDashboard.mjs → samples/phase-13/1319/server/realNetworkDashboard.mjs
+
+## Update References
+- all docs
+- runbook
+- commands
+- scripts
+
+## New Canonical Command
+node samples/phase-13/1319/server/realNetworkServer.mjs
+
+## Rules
+- no logic changes
+- no behavior changes
+- rename + path updates only
+
+## Validation
+- server starts from new path
+- sample 1319 connects
+- dashboard works
+- no references to old tests path
+
+## Acceptance
+- launch/ used instead of tests/
+- commands intuitive and clear

docs/pr/BUILD_PR_LEVEL_12_15_SAMPLE_1319_RUNTIME_RETURN_TO_SERVER.md

@@ -0,0 +1,97 @@
+# BUILD_PR_LEVEL_12_15_SAMPLE_1319_RUNTIME_RETURN_TO_SERVER
+
+## Purpose
+Return sample 1319 runtime entry points to the correct sample-local server home:
+- `samples/phase-13/1319/server/`
+
+## One PR Purpose Only
+Path correction for sample 1319 runtime files only.
+
+## Problem
+The prior rename moved executable runtime files to:
+- `samples/phase-13/1319/server/`
+
+That is the wrong location for this sample.
+Sample 1319 should remain self-contained, with its runtime entry points under:
+- `samples/phase-13/1319/server/`
+
+## Required Fix
+
+### Move Files
+From:
+- `samples/phase-13/1319/server/realNetworkServer.mjs`
+- `samples/phase-13/1319/server/realNetworkDashboard.mjs`
+
+To:
+- `samples/phase-13/1319/server/realNetworkServer.mjs`
+- `samples/phase-13/1319/server/realNetworkDashboard.mjs`
+
+### Remove Wrong Location
+After validating the new paths, remove:
+- `samples/phase-13/1319/server/`
+
+if it is empty and no longer needed.
+
+## Update References
+Update all references to the corrected server-local paths, including:
+- `samples/phase-13/1319/server/README.md`
+- `samples/phase-13/1319/server/docker-compose.yml`
+- `samples/phase-13/1319/index.html`
+- `tmp/validate_1319.mjs`
+- `docs/pr/NETWORK_SAMPLE_1319_POWERSHELL_RUNBOOK.md`
+- any current docs/dev command files or related PR docs that mention `samples/phase-13/1319/server/`
+
+## New Canonical Runtime Commands
+From repo root:
+- `node samples/phase-13/1319/server/realNetworkServer.mjs`
+
+Dashboard runtime path:
+- `samples/phase-13/1319/server/realNetworkDashboard.mjs`
+
+## Rules
+- no logic changes
+- no behavior changes
+- path correction only
+- keep sample 1319 self-contained
+- keep this PR testable, not commit-only
+
+## Validation
+
+### Path Validation
+- no remaining references to `samples/phase-13/1319/server/`
+- server-local runtime paths resolve correctly
+
+### Runtime Validation
+- `node samples/phase-13/1319/server/realNetworkServer.mjs` starts successfully
+- dashboard endpoint still loads
+- sample 1319 still connects correctly
+- second client can still join
+- validate_1319 still passes
+
+### Launcher Validation
+- `samples/index.html` still launches sample 1319
+- `samples/phase-13/1319/index.html` still loads correctly
+
+### Regression
+- no breakage to other sample launcher entries
+- no breakage to focused phase-13 networking samples
+
+## Roadmap Rule
+Update:
+`docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md`
+
+Allowed:
+- status markers only: `[ ]` `[.]` `[x]`
+
+Forbidden:
+- wording edits
+- structure edits
+- additions
+- deletions
+
+## Acceptance Criteria
+- runtime `.mjs` files live under `samples/phase-13/1319/server/`
+- all references updated
+- `samples/phase-13/1319/server/` removed if no longer needed
+- runtime and dashboard still function
+- sample 1319 still launches from `samples/index.html`

docs/pr/NETWORK_SAMPLE_1319_POWERSHELL_RUNBOOK.md

@@ -10,7 +10,7 @@ Launch and validate sample 1319 real-network runtime from PowerShell using repo-
 ## 1) Start Real Server (Terminal A)
 ```powershell
 cd c:\Users\davidq\Documents\GitHub\HTML-JavaScript-Gaming
-node tests/network-sample-1319/realNetworkServer.mjs
+node samples/phase-13/1319/server/realNetworkServer.mjs
 ```
 
 Expected startup output includes:

samples/phase-13/1319/index.html

@@ -70,7 +70,7 @@ <h1>Sample 1319 - Real Network + Live Dashboard</h1>
 
     <p class="server-links">
       For this to work, you need to have the server running locally. You can start the server with<br>
-      <code>node tests/network-sample-1319/realNetworkServer.mjs</code><br>
+      <code>node samples/phase-13/1319/server/realNetworkServer.mjs</code><br>
       from the root of the repository.<br />
     </p>
     <p class="network-links">