PLAN: shared extraction (02) target map preparation

- captured required exact-target mapping before first helper move
- identified initial helper buckets
- prevented vague BUILD scope

next:
- BUILD_PR_SHARED_EXTRACTION_02_EXACT_HELPER_MOVE once exact files are named

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,19 +1 @@
-MODEL: GPT-5.3-codex
-REASONING: high
-
-CONSTRAINTS:
-- DO NOT scan repo
-- ONLY create listed directories
-- NO code changes
-- NO file moves
-
-TASK:
-Create directories:
-src/shared/utils/numbers/
-src/shared/utils/objects/
-src/shared/utils/arrays/
-src/shared/utils/strings/
-src/shared/state/
-
-OUTPUT:
-<project folder>/tmp/BUILD_PR_SHARED_EXTRACTION_01_SCAFFOLD.zip
+# No Codex command in this PLAN bundle

docs/dev/COMMIT_COMMENT.txt

@@ -1,8 +1,8 @@
-BUILD: shared extraction (01) scaffold
+PLAN: shared extraction (02) target map preparation
 
-- created src/shared structure
-- no file moves
-- no code changes
+- captured required exact-target mapping before first helper move
+- identified initial helper buckets
+- prevented vague BUILD scope
 
 next:
-- move duplicate helpers into shared
+- BUILD_PR_SHARED_EXTRACTION_02_EXACT_HELPER_MOVE once exact files are named

docs/dev/reports/change_summary.txt

@@ -1,4 +1,5 @@
 CHANGE SUMMARY
 
-- preparing shared extraction plan
-- no code changes
+- captured the exact-target-map requirement before first helper move
+- preserved small-step workflow
+- prevented vague BUILD scope

docs/dev/reports/validation_checklist.txt

@@ -1,2 +1,7 @@
-[ ] directories created
-[ ] no code changes
+VALIDATION CHECKLIST
+
+[x] docs-only plan
+[x] no code changes
+[x] no file moves
+[x] exact-target requirement captured
+[x] next BUILD blocked until exact source files are named

docs/pr/PLAN_PR_SHARED_EXTRACTION_02_TARGET_MAP.md

@@ -0,0 +1,41 @@
+# PLAN PR — Shared Extraction (02) Target Map
+
+## Purpose
+Prepare the exact target-file map required for the first real helper-move BUILD.
+
+## Why this exists
+A BUILD cannot be vague. Before moving helpers into `src/shared`, the next bundle must name:
+- exact source files
+- exact destination files
+- exact non-goals
+- exact validation
+
+## Candidate helper buckets already identified
+### Numbers
+- asFiniteNumber
+- asPositiveInteger
+
+### Objects
+- isPlainObject
+
+### State / Naming review
+- getState
+- getSimulationState
+- getReplayState
+- getEditorState
+
+## Required output of the next mapping pass
+1. Exact file list containing each duplicate helper
+2. Canonical destination under:
+   - src/shared/utils/numbers/
+   - src/shared/utils/objects/
+   - src/shared/state/
+3. Rename decisions for ambiguous helpers
+4. Keep-local decisions for sample/tool-only helpers
+5. Validation plan for the first move PR
+
+## Non-Goals
+- No code changes
+- No file moves
+- No API changes
+- No Codex execution