Repair sample sequence 1707-1712 using provided folders as source of truth, enforcing correct structure and index alignment.

PR: BUILD_PR_LEVEL_17_44_SAMPLE_SEQUENCE_REPAIR_1707_1712

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,3 +1,3 @@
 MODEL: GPT-5.3-codex
 REASONING: high
-COMMAND: Add gameplay metrics and telemetry overlay using existing debug systems and package to <project folder>/tmp/BUILD_PR_LEVEL_17_42_SAMPLE_1712_GAMEPLAY_METRICS_AND_TELEMETRY.zip
+COMMAND: Use provided 1707-1712.zip as source. Separate and map folders into correct sample structure (1707-1712), fix numbering, update samples/index.html, and package to <project folder>/tmp/BUILD_PR_LEVEL_17_44_SAMPLE_SEQUENCE_REPAIR_1707_1712.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1,3 +1,3 @@
-Add gameplay metrics and telemetry overlay to validate runtime behavior and performance.
+Repair sample sequence 1707-1712 using provided folders as source of truth, enforcing correct structure and index alignment.
 
-PR: BUILD_PR_LEVEL_17_42_SAMPLE_1712_GAMEPLAY_METRICS_AND_TELEMETRY
+PR: BUILD_PR_LEVEL_17_44_SAMPLE_SEQUENCE_REPAIR_1707_1712

docs/dev/reports/validation_checklist.txt

@@ -1,4 +1,4 @@
-- [ ] metrics visible
-- [ ] values update live
-- [ ] no performance issues
+- [ ] all samples present (1707–1712)
+- [ ] index updated
+- [ ] samples run independently
 - [ ] no console errors

docs/pr/BUILD_PR_LEVEL_17_44_SAMPLE_SEQUENCE_REPAIR_1707_1712.md

@@ -0,0 +1,36 @@
+# BUILD_PR_LEVEL_17_44_SAMPLE_SEQUENCE_REPAIR_1707_1712
+
+## Instructions for Codex
+
+1. Unpack 1707-1712.zip
+2. Inspect each folder
+3. Map each folder to correct sample:
+   - 1707
+   - 1708
+   - 1709
+   - 1710
+   - 1711
+   - 1712
+
+4. For each sample:
+   - move to samples/phase-17/<sample-folder>
+   - ensure standalone execution
+   - remove cross-sample coupling
+
+5. Shared logic:
+   - move reusable logic to samples/shared ONLY if reused
+   - do not promote to engine
+
+6. Update:
+   - samples/index.html
+   - correct ordering (1707–1712)
+
+## Constraints
+- DO NOT delete user work
+- DO NOT create new engine systems
+- DO NOT renumber incorrectly
+
+## Validation
+- all samples load
+- sequence is continuous
+- no console errors

docs/pr/PLAN_PR_LEVEL_17_44_SAMPLE_SEQUENCE_REPAIR_1707_1712.md

@@ -0,0 +1,16 @@
+# PLAN_PR_LEVEL_17_44_SAMPLE_SEQUENCE_REPAIR_1707_1712
+
+## Purpose
+Repair sample sequence using provided 1707-1712 bundle as source of truth.
+
+## Goals
+- separate folders into correct samples
+- enforce numbering continuity
+- update samples/index.html
+- preserve all existing work
+
+## Input
+- 1707-1712.zip (user provided)
+
+## Output
+- clean samples 1707–1712 properly structured

samples/index.html

@@ -510,6 +510,8 @@ <h2>Phase 17 - Rendering Technique Expansion</h2>
         <a class="live" href="./phase-17/1707/index.html" title="Minecraft-style voxel chunk-window streaming around a movable camera anchor." data-tags="camera3d, minecraft-style, voxel, chunk-streaming, filled-render, scene, themetokens" data-primary="minecraft-chunk-streaming">Sample 1707 - Minecraft Chunk Streaming</a>
         <a class="live" href="./phase-17/1708/index.html" title="Real 3D mini-game loop with movement, hazard interaction, objective scoring, camera follow, and standard 3D debug panels." data-tags="camera3d, gameplay, objective, hazards, debug-panels, scene, themetokens" data-primary="real-gameplay-mini-game">Sample 1708 - Real Gameplay Mini-Game</a>
         <a class="live" href="./phase-17/1709/index.html" title="Compares direct axis movement, tank rotation controls, and weighted movement with follow-camera framing." data-tags="camera3d, movement-models, direct-controls, tank-controls, weighted-motion, scene, themetokens" data-primary="movement-models-lab">Sample 1709 - Movement Models Lab</a>
+        <a class="live" href="./phase-17/1710/index.html" title="Polished gameplay loop variant with mission-state feedback, objective progression, and standard 3D debug panels." data-tags="camera3d, gameplay, polished-loop, objective, hazards, debug-panels, scene, themetokens" data-primary="real-gameplay-mini-game-polished">Sample 1710 - Real Gameplay Mini-Game</a>
+        <a class="live" href="./phase-17/1711/index.html" title="Movement-models lab variant for sequence alignment with direct, tank, and weighted controls plus follow camera." data-tags="camera3d, movement-models, direct-controls, tank-controls, weighted-motion, scene, themetokens" data-primary="movement-models-lab-sequence">Sample 1711 - Movement Models Lab</a>
         <a class="live" href="./phase-17/1712/index.html" title="Gameplay telemetry overlay for mini-game state, speed, collisions, actions, and live FPS trend." data-tags="camera3d, gameplay, telemetry, metrics, debug-overlay, scene, themetokens" data-primary="gameplay-metrics-telemetry">Sample 1712 - Gameplay Metrics & Telemetry</a>
       </div>
     </section>