PR_07_02_NETWORK_SIMULATION_BASELINE

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,37 +1,21 @@
-PR Naming Rule:
-ALL PRs MUST follow:
-PR_<SECTION>_<STEP>_<SHORT_NAME>
-
-Reject any PR name that does not follow this format.
-
 MODEL: GPT-5.4
-REASONING: high
+REASONING: medium
 
 COMMAND:
-Implement PR_06_06_SAMPLE_ENGINE_DEPENDENCY_CLEANUP.
+Implement PR_07_02_NETWORK_SIMULATION_BASELINE.
 
 Goal:
-Remove sample dependencies on non-public engine internals by standardizing samples onto approved public/shared surfaces only.
+Establish deterministic simulation baseline.
 
-Required steps:
-1. Produce docs/dev/reports/sample_dependency_scan.txt for non-public engine dependencies used by samples in scope.
-2. Produce docs/dev/reports/dependency_cleanup_map.txt with exact source -> approved target mapping.
-3. Update sample consumers in scope to approved public/shared surfaces only.
-4. Remove only the direct dependency violations resolved by this PR.
-5. Keep changes surgical.
+Steps:
+1. Define simulation tick model.
+2. Ensure deterministic update loop.
+3. Validate consistency.
 
 Rules:
-- samples dependency cleanup only
-- no engine logic refactors
-- no API redesign
+- no networking
+- no latency modeling
 - no behavior changes
-- no broad cleanup
-
-Validation:
-- impacted imports resolve
-- non-public engine dependency violations in scope removed
-- runtime/sample navigation not regressed
-- impacted tests/smoke pass
 
 Return ZIP:
-<project folder>/tmp/PR_06_06_SAMPLE_ENGINE_DEPENDENCY_CLEANUP.zip
+<project folder>/tmp/PR_07_02_NETWORK_SIMULATION_BASELINE.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-PR_06_06_SAMPLE_ENGINE_DEPENDENCY_CLEANUP
+PR_07_02_NETWORK_SIMULATION_BASELINE

docs/dev/reports/phase13_structure_validation.txt

@@ -0,0 +1,29 @@
+PR_07_01_NETWORK_PHASE_STRUCTURE_VALIDATION
+
+Scope
+- samples/phase-13
+- samples/index.html phase-13 entries
+
+Checks performed
+1. Folder structure scan:
+- Found canonical directories 1301..1318 (18 total), no gaps.
+
+2. Required entry files:
+- Every phase-13 sample directory contains index.html and main.js.
+
+3. Naming validation:
+- For every sample 1301..1318, <title> and <h1> start with "Sample <id>".
+- No ID/title/header mismatches detected.
+
+4. Navigation references:
+- samples/index.html contains links for 1301..1318 under Phase 13.
+- Link path format is canonical ./phase-13/<id>/index.html.
+
+Inconsistencies found
+- None.
+
+Fixes applied
+- No code or sample content changes required.
+
+Validation
+- node tests/runtime/LaunchSmokeAllEntries.test.mjs (pass)

docs/dev/reports/validation_checklist.txt

@@ -1,6 +1,3 @@
-[ ] sample_dependency_scan.txt generated
-[ ] dependency_cleanup_map.txt generated
-[ ] non-public engine dependencies removed in scope
-[ ] no behavior changes
-[ ] imports resolve
-[ ] impacted tests/smoke pass
+[ ] simulation tick model defined
+[ ] deterministic loop confirmed
+[ ] consistency validated

docs/pr/PR_07_01_NETWORK_PHASE_STRUCTURE_VALIDATION.md

@@ -0,0 +1,27 @@
+# PR_07_01_NETWORK_PHASE_STRUCTURE_VALIDATION
+
+## Purpose
+Validate and stabilize Phase 13 (Network Concepts / Latency / Simulation) structure.
+
+## Scope
+- structure validation only
+- no behavior changes
+- no network logic implementation
+
+## Tasks
+1. Verify all phase-13 samples follow canonical structure.
+2. Validate naming, numbering, and placement.
+3. Ensure index references are correct.
+4. Identify structural inconsistencies.
+
+## Deliverables
+- docs/dev/reports/network_phase_scan.txt
+- docs/dev/reports/validation_checklist.txt
+
+## Validation
+- all phase-13 samples resolve correctly
+- no broken links
+- structure consistent with other phases
+
+## Output
+<project folder>/tmp/PR_07_01_NETWORK_PHASE_STRUCTURE_VALIDATION.zip

docs/pr/PR_07_02_NETWORK_SIMULATION_BASELINE.md

@@ -0,0 +1,28 @@
+# PR_07_02_NETWORK_SIMULATION_BASELINE
+
+## Purpose
+Establish deterministic simulation baseline for Phase 13.
+
+## Scope
+- simulation timing only
+- no networking
+- no latency modeling
+- no behavior changes
+
+## Tasks
+1. Define simulation tick model.
+2. Ensure deterministic update loop.
+3. Validate consistent state progression.
+4. Identify timing inconsistencies.
+
+## Deliverables
+- docs/dev/reports/simulation_tick_model.txt
+- docs/dev/reports/validation_checklist.txt
+
+## Validation
+- deterministic update loop confirmed
+- consistent state progression across runs
+- no regressions
+
+## Output
+<project folder>/tmp/PR_07_02_NETWORK_SIMULATION_BASELINE.zip

samples/phase-13/1303/main.js

@@ -7,10 +7,11 @@ main.js
 import Engine from '/src/engine/core/Engine.js';
 import { Theme, ThemeTokens } from '/src/engine/theme/index.js';
 import AsteroidsWorldSystemsScene from './AsteroidsWorldSystemsScene.js';
+import { SIMULATION_FIXED_STEP_MS } from '/samples/phase-13/_shared/simulationBaseline.js';
 
 const theme = new Theme(ThemeTokens);
 theme.applyDocumentTheme();
 const canvas = document.getElementById('game');
-const engine = new Engine({ canvas, width: 960, height: 540, fixedStepMs: 1000 / 60 });
+const engine = new Engine({ canvas, width: 960, height: 540, fixedStepMs: SIMULATION_FIXED_STEP_MS });
 engine.setScene(new AsteroidsWorldSystemsScene());
 engine.start();

samples/phase-13/1309/main.js

@@ -7,10 +7,11 @@ main.js
 import Engine from '/src/engine/core/Engine.js';
 import { Theme, ThemeTokens } from '/src/engine/theme/index.js';
 import SpaceInvadersWorldSystemsScene from './SpaceInvadersWorldSystemsScene.js';
+import { SIMULATION_FIXED_STEP_MS } from '/samples/phase-13/_shared/simulationBaseline.js';
 
 const theme = new Theme(ThemeTokens);
 theme.applyDocumentTheme();
 const canvas = document.getElementById('game');
-const engine = new Engine({ canvas, width: 960, height: 540, fixedStepMs: 1000 / 60 });
+const engine = new Engine({ canvas, width: 960, height: 540, fixedStepMs: SIMULATION_FIXED_STEP_MS });
 engine.setScene(new SpaceInvadersWorldSystemsScene());
 engine.start();

samples/phase-13/1313/main.js

@@ -7,10 +7,11 @@ main.js
 import Engine from '/src/engine/core/Engine.js';
 import { Theme, ThemeTokens } from '/src/engine/theme/index.js';
 import PacmanLiteWorldSystemsScene from './PacmanLiteWorldSystemsScene.js';
+import { SIMULATION_FIXED_STEP_MS } from '/samples/phase-13/_shared/simulationBaseline.js';
 
 const theme = new Theme(ThemeTokens);
 theme.applyDocumentTheme();
 const canvas = document.getElementById('game');
-const engine = new Engine({ canvas, width: 960, height: 540, fixedStepMs: 1000 / 60 });
+const engine = new Engine({ canvas, width: 960, height: 540, fixedStepMs: SIMULATION_FIXED_STEP_MS });
 engine.setScene(new PacmanLiteWorldSystemsScene());
 engine.start();

samples/phase-13/1316/main.js

@@ -11,6 +11,7 @@ import { resolveDebugConfig } from "../../_shared/debugConfigUtils.js";
 import { createSampleGameDevConsoleIntegration } from "../../../tools/dev/devConsoleIntegration.js";
 import { createNetworkSampleADebugPlugin } from "./debug/networkSampleADebug.js";
 import NetworkSampleAScene from "./game/NetworkSampleAScene.js";
+import { SIMULATION_FIXED_STEP_MS } from "/samples/phase-13/_shared/simulationBaseline.js";
 
 const theme = new Theme(ThemeTokens);
 
@@ -63,7 +64,7 @@ export function bootNetworkSampleA({
     canvas,
     width: 960,
     height: 720,
-    fixedStepMs: 1000 / 60,
+    fixedStepMs: SIMULATION_FIXED_STEP_MS,
     input
   });