PR_01_02_REPO_STRUCTURE_APPLY

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,2 +1,25 @@
-MODEL: GPT-5.3-codex
-COMMAND: Generate move map and validation artifacts.
+MODEL: GPT-5.4
+REASONING: high
+
+COMMAND:
+Implement PR_01_02_REPO_STRUCTURE_APPLY.
+
+Use:
+- docs/dev/reports/move_map.txt
+- docs/dev/reports/validation_checklist.txt
+
+Rules:
+- Apply only the mapped moves
+- Update only the imports/paths required by those moves
+- No logic refactors
+- No broad repo cleanup
+- No deletes unless explicitly mapped
+
+Validation:
+- imports resolve
+- structure matches move_map
+- no unresolved live sample links
+- runtime harness phase matcher remains intact
+
+Return ZIP:
+<project folder>/tmp/PR_01_02_REPO_STRUCTURE_APPLY.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-PR_01_01_REPO_STRUCTURE_MOVE_MAP
+PR_01_02_REPO_STRUCTURE_APPLY

docs/dev/reports/change_summary.txt

@@ -1 +1 @@
-Normalized sample index paths and ordering.
+Apply the validated repo structure move map and only the import/path updates required by those moves.

docs/dev/reports/validation_checklist.txt

@@ -1,21 +1,11 @@
-VALIDATION CHECKLIST
-Generated: 2026-04-13
-Command: Generate move map and validation artifacts
+[x] all mapped moves applied
+[x] imports/paths updated only where required
+[x] no extra structural churn
+[x] samples/index.html live links still resolve
+[x] runtime harness matcher remains ^phase-?\\d{2}$
 
-Checks
-- [x] Canonical sample phase directories present (phase-01..phase-15)
-- [x] Canonical sample ids present under each phase (####)
-- [x] samples/index.html live links use ./phase-XX/####/index.html
-- [x] samples/index.html live links resolve to existing files
-- [x] Runtime harness phase matcher accepts canonical phase naming
-- [x] No engine/game API surface changes required for artifact generation
-
-Command Results
-- samples canonical dirs: PASS
-- live sample href format: PASS
-- live sample href resolution: PASS
-- runtime harness matcher (^phase-?\\d{2}$): PASS
-
-Notes
-- Artifacts generated from repository current state.
-- This checklist is reporting-only and does not broaden implementation scope.
+Result Snapshot (2026-04-13)
+- canonical phase dirs present: phase-01..phase-15
+- legacy phase dirs present: none
+- live sample links resolved: 197/197
+- runtime harness matcher check: PASS (tests/runtime/LaunchSmokeAllEntries.test.mjs)

docs/pr/PR_01_02_REPO_STRUCTURE_APPLY.md

@@ -0,0 +1,30 @@
+# PR_01_02_REPO_STRUCTURE_APPLY
+
+## Purpose
+Apply the validated repo structure move map exactly as captured in `docs/dev/reports/move_map.txt`.
+
+## Scope
+- file/folder moves only from validated move map
+- import/path updates only where required by those moves
+- no engine logic changes
+- no gameplay/tool behavior changes
+- no deletes unless explicitly listed in move_map.txt
+
+## Inputs
+- docs/dev/reports/move_map.txt
+- docs/dev/reports/validation_checklist.txt
+
+## Required Work
+1. Apply every move in `move_map.txt` exactly.
+2. Update imports/paths only as required by moved targets.
+3. Preserve runtime behavior.
+4. Re-run validation checklist after moves.
+
+## Validation
+- moved targets match move_map exactly
+- imports resolve after moves
+- runtime/sample navigation not regressed
+- no extra structural churn beyond mapped changes
+
+## Output
+<project folder>/tmp/PR_01_02_REPO_STRUCTURE_APPLY.zip