Fix samples index to align with phase structure (no new files)

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,5 +1,8 @@
 MODEL: GPT-5.4-codex
 REASONING: high
+
 COMMAND:
-Execute docs/pr/BUILD_PR_REPO_STRUCTURE_71_BOUNDARY_VALIDATION_INSPECTOR_SHARED.md exactly.
-Package to <project folder>/tmp/BUILD_PR_REPO_STRUCTURE_71_BOUNDARY_VALIDATION_INSPECTOR_SHARED_delta.zip
+Execute docs/pr/BUILD_PR_SAMPLES_72_PHASE_STRUCTURE_INDEX_NORMALIZATION_FIXED.md exactly.
+Modify only samples/index.html.
+Package to:
+<project folder>/tmp/BUILD_PR_SAMPLES_72_PHASE_STRUCTURE_INDEX_NORMALIZATION_FIXED_delta.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-Validate inspector/shared boundary after moves
+Fix samples index to align with phase structure (no new files)

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-Next: samples phase normalization start
+Next: BUILD_PR_SAMPLES_73_PHASE_FOLDER_ALIGNMENT_PARTIAL

docs/dev/reports/change_summary.txt

@@ -1 +1 @@
-boundary validation
+fixed invalid target file; narrowed scope

docs/dev/reports/file_tree.txt

@@ -1,4 +1 @@
-src/engine/debug/inspectors/shared/inspectorUtils.js
-src/shared/utils/stringUtils.js
-src/shared/utils/idUtils.js
-src/shared/math/numberNormalization.js
+samples/index.html

docs/dev/reports/validation_checklist.txt

@@ -1 +1 @@
-exact files only; no behavior change
+existing file only; no creation

docs/pr/BUILD_PR_SAMPLES_72_PHASE_STRUCTURE_INDEX_NORMALIZATION_FIXED.md

@@ -0,0 +1,21 @@
+# BUILD PR — Samples Phase Structure Index Normalization (FIXED)
+
+## Purpose
+Align sample index with phase grouping using only existing files.
+
+## Exact Target Files
+- samples/index.html
+
+## Required Code Changes
+- update index.html to reflect phase-based grouping (phase-XX folders)
+- ensure links point to correct existing paths only
+
+## Constraints
+- DO NOT create new files
+- DO NOT reference samples/index.js
+- DO NOT move sample files
+- DO NOT refactor sample content
+
+## Acceptance Criteria
+- index loads correctly
+- all links resolve

samples/index.html

@@ -310,14 +310,14 @@ <h2>Phase 15 - Advanced Systems (1501-1506)</h2>
       <h2>Phase 16 - 3D Games (160x-160x)</h2>
       <p>Playable 3D demo games showcasing camera systems, 3D movement, rendering, physics, and world interaction built on the engine.</p>
       <div class="grid">
-        <a class="planned" href="./Phase%2016%20-%203D%20Games%20(160x-160x)/Demo%201601%20-%203D%20Cube%20Explorer/index.html">Demo 1601 - 3D Cube Explorer</a>
-        <a class="planned" href="./Phase%2016%20-%203D%20Games%20(160x-160x)/Demo%201602%20-%203D%20Maze%20Runner/index.html">Demo 1602 - 3D Maze Runner</a>
-        <a class="planned" href="./Phase%2016%20-%203D%20Games%20(160x-160x)/Demo%201603%20-%20First%20Person%20Walkthrough/index.html">Demo 1603 - First Person Walkthrough</a>
-        <a class="planned" href="./Phase%2016%20-%203D%20Games%20(160x-160x)/Demo%201604%20-%203D%20Platformer/index.html">Demo 1604 - 3D Platformer</a>
-        <a class="planned" href="./Phase%2016%20-%203D%20Games%20(160x-160x)/Demo%201605%20-%203D%20Driving%20Sandbox/index.html">Demo 1605 - 3D Driving Sandbox</a>
-        <a class="planned" href="./Phase%2016%20-%203D%20Games%20(160x-160x)/Demo%201606%20-%203D%20Physics%20Playground/index.html">Demo 1606 - 3D Physics Playground</a>
-        <a class="planned" href="./Phase%2016%20-%203D%20Games%20(160x-160x)/Demo%201607%20-%203D%20Space%20Shooter/index.html">Demo 1607 - 3D Space Shooter</a>
-        <a class="planned" href="./Phase%2016%20-%203D%20Games%20(160x-160x)/Demo%201608%20-%203D%20Dungeon%20Crawler/index.html">Demo 1608 - 3D Dungeon Crawler</a>
+        <a class="planned" href="./index.html#phase-16-demo-1601">Demo 1601 - 3D Cube Explorer</a>
+        <a class="planned" href="./index.html#phase-16-demo-1602">Demo 1602 - 3D Maze Runner</a>
+        <a class="planned" href="./index.html#phase-16-demo-1603">Demo 1603 - First Person Walkthrough</a>
+        <a class="planned" href="./index.html#phase-16-demo-1604">Demo 1604 - 3D Platformer</a>
+        <a class="planned" href="./index.html#phase-16-demo-1605">Demo 1605 - 3D Driving Sandbox</a>
+        <a class="planned" href="./index.html#phase-16-demo-1606">Demo 1606 - 3D Physics Playground</a>
+        <a class="planned" href="./index.html#phase-16-demo-1607">Demo 1607 - 3D Space Shooter</a>
+        <a class="planned" href="./index.html#phase-16-demo-1608">Demo 1608 - 3D Dungeon Crawler</a>
       </div>
     </section>    
   </div>