PLAN PR: normalize helper imports to src/shared.

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,8 +1 @@
-# docs/dev/codex_commands.md
-
-No Codex command included.
-
-Reason:
-This is an APPLY bundle.
-Code execution was reported complete and clean.
-Do not send another BUILD for this same PR scope.
+No Codex command. PLAN only.

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-APPLY PR: accept shared helper extraction exact helper move after clean Codex execution.
+PLAN PR: normalize helper imports to src/shared.

docs/dev/NEXT_COMMAND.txt

@@ -1,3 +1 @@
-Next step:
-Select the next PLAN or BUILD in the repo workflow.
-This PR is closed at APPLY.
+Next: BUILD_PR_SHARED_EXTRACTION_03_IMPORT_NORMALIZATION

docs/dev/reports/change_summary.txt

@@ -1,4 +1 @@
-Produced APPLY/acceptance docs for the completed shared helper extraction PR.
-Accepted based on clean execution report.
-No new code requested.
-No new BUILD command included.
+Defined import normalization plan.

docs/dev/reports/file_tree.txt

@@ -1,11 +1 @@
-docs/
-  pr/
-    APPLY_PR_SHARED_EXTRACTION_02_EXACT_HELPER_MOVE.md
-  dev/
-    codex_commands.md
-    commit_comment.txt
-    next_command.txt
-    reports/
-      change_summary.txt
-      validation_checklist.txt
-      file_tree.txt
+docs/pr + docs/dev structure

docs/dev/reports/validation_checklist.txt

@@ -1,14 +1,4 @@
-SESSION VALIDATION GATE
-- Bundle type: APPLY
-- One PR purpose only: yes
-- Codex command removed: yes
-- Fake code claims avoided: yes
-- Start-of-day directories touched: no
-- Repo scan requested: no
-- ZIP repo-structured: yes
-
-APPLY-SPECIFIC CHECKS
-- Scope limited to completed BUILD: yes
-- No new runtime work requested: yes
-- No new BUILD embedded: yes
-- Commit-ready docs included: yes
+- Imports point to src/shared
+- No relative helper imports
+- No duplicates
+- Build passes

docs/pr/PLAN_PR_SHARED_EXTRACTION_03_IMPORT_NORMALIZATION.md

@@ -0,0 +1,45 @@
+# PLAN_PR_SHARED_EXTRACTION_03_IMPORT_NORMALIZATION
+
+## Purpose
+Normalize all imports to use src/shared as the single source of truth for extracted helpers.
+
+## Scope
+- Replace relative helper imports with src/shared imports
+- Remove inline helper references
+- No logic changes
+- No file moves
+- No new helpers
+
+## Rules
+- DO NOT scan entire repo blindly
+- ONLY update files that import moved helpers
+- DO NOT modify engine APIs
+- DO NOT rename helpers
+
+## Normalization Targets
+
+### Replace patterns like:
+../../utils/...
+../utils/...
+local helper definitions
+
+### With:
+src/shared/utils/numberUtils.js
+src/shared/utils/objectUtils.js
+src/shared/state/getState.js
+
+## Import Standard
+
+Always use:
+import { helper } from "src/shared/...";
+
+## Acceptance Criteria
+- All helper imports resolve to src/shared
+- No duplicate helper definitions remain
+- No relative helper imports remain
+- Build passes
+
+## Non-Goals
+- No refactoring
+- No helper renaming
+- No additional extraction