BUILD PR: normalize createPromotionStateSnapshot imports in promotion/state modules only.

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,10 +1,13 @@
 MODEL: GPT-5.3-codex
 REASONING: high
 COMMAND:
-Execute docs/pr/BUILD_PR_SHARED_EXTRACTION_05_GETSTATE_PROMOTION_STATE_ONLY.md exactly.
-Edit only these files:
-- src/shared/state/createPromotionStateSnapshot.js
+Execute docs/pr/BUILD_PR_SHARED_EXTRACTION_06_PROMOTION_SNAPSHOT_IMPORT_NORMALIZATION.md exactly.
+
+Edit ONLY:
 - src/advanced/promotion/createPromotionGate.js
 - src/advanced/state/createWorldGameStateSystem.js
+
 Do not expand scope.
-Package the delta output to <project folder>/tmp/BUILD_PR_SHARED_EXTRACTION_05_GETSTATE_PROMOTION_STATE_ONLY_delta.zip
+
+Package output to:
+<project folder>/tmp/BUILD_PR_SHARED_EXTRACTION_06_PROMOTION_SNAPSHOT_IMPORT_NORMALIZATION_delta.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-BUILD PR: extract duplicated promotion-state getState snapshot into shared helper only.
+BUILD PR: normalize createPromotionStateSnapshot imports in promotion/state modules only.

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-Next: if clean, commit result and continue to the next executable BUILD. If blocked, capture the exact blocker and narrow further without changing PR purpose.
+Next: continue with next executable BUILD (no APPLY).

docs/dev/reports/change_summary.txt

@@ -1,2 +1 @@
-Built an execution-grade BUILD for the remaining getState-related work by narrowing to the only exact duplicated getState snapshot pattern identifiable without guessing.
-This BUILD centralizes the duplicated promotion-state snapshot logic only.
+Normalized import paths for shared promotion snapshot helper to prevent path drift.

docs/dev/reports/file_tree.txt

@@ -1,11 +1 @@
-docs/
-  pr/
-    BUILD_PR_SHARED_EXTRACTION_05_GETSTATE_PROMOTION_STATE_ONLY.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

docs/dev/reports/validation_checklist.txt

@@ -1,16 +1,5 @@
 SESSION VALIDATION GATE
-- Bundle type: BUILD
-- One PR purpose only: yes
-- Exact target files listed: yes
-- Exact new file listed: yes
-- Exact source edits listed: yes
-- Vague repo-wide scan/refactor language avoided: yes
-- Scope minimized: yes
-- Start-of-day directories untouched: yes
-- Fake code claims avoided: yes
-- ZIP repo-structured and execution-ready: yes
-
-BUILD-SPECIFIC CHECKS
-- Codex can execute without guessing: yes
-- Broad getState normalization intentionally excluded: yes
-- Validation steps explicit: yes
+- BUILD executable: yes
+- Exact files listed: yes
+- No guessing: yes
+- Scope minimal: yes

docs/pr/BUILD_PR_SHARED_EXTRACTION_06_PROMOTION_SNAPSHOT_IMPORT_NORMALIZATION.md

@@ -0,0 +1,84 @@
+# BUILD_PR_SHARED_EXTRACTION_06_PROMOTION_SNAPSHOT_IMPORT_NORMALIZATION
+
+## Purpose
+Normalize imports for the newly introduced shared helper:
+createPromotionStateSnapshot
+
+## Single PR Purpose
+Fix import paths ONLY for:
+- src/advanced/promotion/createPromotionGate.js
+- src/advanced/state/createWorldGameStateSystem.js
+
+Ensure both use correct, stable relative paths.
+
+## Exact Files Allowed
+Edit ONLY:
+
+1. src/advanced/promotion/createPromotionGate.js
+2. src/advanced/state/createWorldGameStateSystem.js
+
+## Exact Import Targets
+
+### 1) createPromotionGate.js
+
+Ensure EXACT import:
+
+```js
+import { createPromotionStateSnapshot } from '../shared/state/createPromotionStateSnapshot.js';
+```
+
+If incorrect:
+- replace existing import
+- do not duplicate import
+
+---
+
+### 2) createWorldGameStateSystem.js
+
+Ensure EXACT import:
+
+```js
+import { createPromotionStateSnapshot } from '../../shared/state/createPromotionStateSnapshot.js';
+```
+
+If incorrect:
+- replace existing import
+- do not duplicate import
+
+---
+
+## Required Actions
+- remove any incorrect relative path
+- ensure only ONE import exists per file
+- do not modify any other imports
+
+---
+
+## Hard Constraints
+- DO NOT scan repo
+- DO NOT modify logic
+- DO NOT change function bodies
+- DO NOT modify other helpers
+- DO NOT normalize other imports
+- DO NOT touch getState behavior
+- DO NOT modify shared helper file
+
+---
+
+## Validation Checklist
+
+1. Only 2 files changed
+2. Each file has exactly ONE import for:
+   createPromotionStateSnapshot
+3. Import paths match EXACTLY:
+   - '../shared/state/...'
+   - '../../shared/state/...'
+4. No duplicate imports exist
+5. No logic changes made
+
+---
+
+## Non-Goals
+- no global import normalization
+- no absolute path migration
+- no helper changes

src/advanced/promotion/createPromotionGate.js

@@ -7,7 +7,7 @@ createPromotionGate.js
 
 import { asFiniteNumber } from '../../shared/utils/numberUtils.js';
 import { isPlainObject } from '../../shared/utils/objectUtils.js';
-import { createPromotionStateSnapshot } from '../../shared/state/createPromotionStateSnapshot.js';
+import { createPromotionStateSnapshot } from '../shared/state/createPromotionStateSnapshot.js';
 
 function asPositiveInteger(value, fallback = 1) {
   const numeric = Math.floor(asFiniteNumber(value, fallback));