BUILD: repo structure normalization (02) import switch

- updated imports from engine/ to src/engine/
- no API changes
- no new files
- original engine/ still present for rollback safety

next:
- validate runtime
- prepare removal PR for old engine/ directory

Author: DavidQ

.gitattributes

@@ -0,0 +1,4 @@
+* text=auto
+*.js text eol=lf
+*.md text eol=lf
+*.txt text eol=lf

docs/dev/CODEX_COMMANDS.md

@@ -3,31 +3,18 @@ REASONING: high
 
 CONSTRAINTS:
 - DO NOT scan repo
-- ONLY modify listed targets
+- ONLY modify files that explicitly import from engine/
 - NO engine API changes
-- NO new files unless explicitly listed
+- NO new files
 
 TASK:
-Staged, non-destructive engine move.
-
-1) Create directory:
-   src/engine/
-
-2) Copy ALL files and folders from:
-   engine/**
-
-   to:
-   src/engine/**
-
-3) Preserve relative structure exactly (1:1 mirror).
+Replace import paths:
+engine/... → src/engine/...
 
 RULES:
-- Do NOT delete or modify anything under engine/
-- Do NOT change any import paths
-- Do NOT edit file contents
-- Do NOT create files outside src/engine/**
-- If any ambiguity, STOP and report
+- Do not modify anything else
+- Do not change logic
+- Do not delete engine/ yet
 
 OUTPUT:
-Create ZIP at:
-<project folder>/tmp/BUILD_PR_REPO_STRUCTURE_NORMALIZATION_01_ENGINE_MOVE.zip
+<project folder>/tmp/BUILD_PR_REPO_STRUCTURE_NORMALIZATION_02_IMPORT_SWITCH.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1,15 +1,10 @@
-BUILD: repo structure normalization (01) staged engine move
+BUILD: repo structure normalization (02) import switch
 
-- created src/engine/ directory
-- copied engine/** to src/engine/** (1:1 mirror)
-- no changes to original engine/ directory
-- no import path changes
-- no engine API changes
-
-notes:
-- staged move to allow safe validation before cutover
-- follow-up PR will switch imports to src/engine/
+- updated imports from engine/ to src/engine/
+- no API changes
+- no new files
+- original engine/ still present for rollback safety
 
 next:
-- validate mirror integrity
-- proceed to import normalization PR
+- validate runtime
+- prepare removal PR for old engine/ directory

docs/dev/reports/validation_checklist.txt

@@ -1,7 +1,3 @@
-VALIDATION CHECKLIST
-
-[ ] src/engine/ exists
-[ ] all files from engine/** exist under src/engine/** (1:1)
-[ ] original engine/** remains unchanged
-[ ] no import paths changed
-[ ] application runs as before
+[ ] imports updated
+[ ] no new files
+[ ] app runs

docs/pr/BUILD_PR_REPO_STRUCTURE_NORMALIZATION_02_IMPORT_SWITCH.md

@@ -0,0 +1,16 @@
+# BUILD PR — Repo Structure Normalization (02) Import Switch
+
+## Scope
+Update imports from `engine/` → `src/engine/`
+
+## Constraints
+- DO NOT scan repo
+- ONLY modify files that contain engine imports
+- NO engine API changes
+- NO new files
+
+## Targets
+- Replace import paths referencing `engine/` with `src/engine/`
+
+## Validation
+- App runs using src/engine paths only

games/AITargetDummy/game/AITargetDummyInputController.js

@@ -4,7 +4,7 @@ David Quesenberry
 03/25/2026
 AITargetDummyInputController.js
 */
-import { GamepadInputAdapter } from '../../../engine/input/index.js';
+import { GamepadInputAdapter } from '../../../src/engine/input/index.js';
 
 function clamp(value, min, max) {
   return Math.max(min, Math.min(max, value));

games/AITargetDummy/game/AITargetDummyScene.js

@@ -4,7 +4,7 @@ David Quesenberry
 03/25/2026
 AITargetDummyScene.js
 */
-import { Scene } from '../../../engine/scenes/index.js';
+import { Scene } from '../../../src/engine/scenes/index.js';
 import AITargetDummyDebugOverlay from './AITargetDummyDebugOverlay.js';
 import AITargetDummyInputController from './AITargetDummyInputController.js';
 import AITargetDummyWorld from './AITargetDummyWorld.js';

games/AITargetDummy/main.js

@@ -4,9 +4,9 @@ David Quesenberry
 03/25/2026
 main.js
 */
-import Engine from '../../engine/core/Engine.js';
-import { InputService } from '../../engine/input/index.js';
-import { Theme, ThemeTokens } from '../../engine/theme/index.js';
+import Engine from '../../src/engine/core/Engine.js';
+import { InputService } from '../../src/engine/input/index.js';
+import { Theme, ThemeTokens } from '../../src/engine/theme/index.js';
 import AITargetDummyScene from './game/AITargetDummyScene.js';
 
 const theme = new Theme(ThemeTokens);

games/Asteroids/entities/Asteroid.js

@@ -5,7 +5,7 @@ David Quesenberry
 Asteroid.js
 */
 import { TAU, randomRange, wrap } from '../utils/math.js';
-import { transformPoints } from '../../../engine/vector/index.js';
+import { transformPoints } from '../../../src/engine/vector/index.js';
 
 const BASE_VECTOR_MAP = [
   { x: 10, y: 40 },

games/Asteroids/entities/Ship.js

@@ -5,7 +5,7 @@ David Quesenberry
 Ship.js
 */
 import { wrap } from '../utils/math.js';
-import { transformPoints } from '../../../engine/vector/index.js';
+import { transformPoints } from '../../../src/engine/vector/index.js';
 
 const SMALL_VECTOR_MAP = [
   { x: 14, y: 0 },