Relocate active vector-native template surface to tools/templates and update known blocker references

Author: DavidQ

2.txt

@@ -1,29 +1,42 @@
-MODEL: GPT-5.3-codex
-REASONING: high
+MODEL: GPT-5.3-codex
+REASONING: medium
 
 COMMAND:
-Execute BUILD_PR_TARGETED_REPO_CLEANUP_PASS_8_REMOVE_CLASSES_OLD_KEEP_REFERENCES.
+Execute BUILD_PR_TEMPLATES_VECTOR_NATIVE_ACTIVE_RELOCATION.
 
-Inputs:
-- Decision = REMOVE (from PASS_7)
-- References exist only in docs/planning files
+Do the work in this PR. Do not ask for clarification.
 
-Steps:
-1) Find all occurrences of "legacy class-retention policy marker" in docs (*.md, *.txt)
-2) For each occurrence:
-   - Remove the reference OR
-   - Rewrite to a neutral phrase (no placeholder mention)
-3) Ensure no semantic break in docs
-4) Generate:
-   - docs/dev/reports/legacy class-retention policy marker_removal_change_log.md
-   - docs/dev/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_8_REMOVE_CLASSES_OLD_KEEP_REFERENCES_report.md
-   - docs/dev/reports/validation_checklist.txt
+Required actions:
+1. Move:
+   templates/vector-native-arcade/
+   ->
+   tools/templates/vector-native-arcade/
+2. Update only these files:
+   - tools/shared/vectorNativeTemplate.js
+   - tools/shared/vectorTemplateSampleGame.js
+   - tests/tools/VectorNativeTemplate.test.mjs
+   - games/vector-arcade-sample/README.md
+3. Change path references from:
+   templates/vector-native-arcade/
+   to:
+   tools/templates/vector-native-arcade/
+4. Do NOT touch:
+   - templates/starter-project-template/
+   - docs/dev/start_of_day/chatGPT/
+   - docs/dev/start_of_day/codex/
+   - docs/archive/
 
-Constraints:
-- Do NOT create/delete/move any directories
-- Do NOT modify templates/ or docs/archive/ or start_of_day/*
-- Do NOT touch runtime code
+Create:
+- docs/dev/reports/templates_vector_native_active_relocation_report.md
+- docs/dev/reports/validation_checklist.txt
 
-Package to:
-<project folder>/tmp/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_8_REMOVE_CLASSES_OLD_KEEP_REFERENCES.zip
+Validation required:
+- old vector-native template path no longer referenced in the four target files
+- new tools/templates path is referenced in the four target files
+- templates/starter-project-template remains untouched
+- tools/templates/vector-native-arcade exists
+- templates/vector-native-arcade no longer exists
+- protected start_of_day directories untouched
 
+Package output to:
+<project folder>/tmp/BUILD_PR_TEMPLATES_VECTOR_NATIVE_ACTIVE_RELOCATION.zip

docs/dev/CODEX_COMMANDS.md

@@ -1 +1 @@
-Update roadmap: mark templates evaluation complete and append deferred tools/templates relocation note
+Relocate active vector-native template surface to tools/templates and update known blocker references

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1,2 @@
-Next: APPLY_PR_TARGETED_REPO_CLEANUP_PASS_8_REMOVE_CLASSES_OLD_KEEP_REFERENCES
+After Codex completes and validation passes:
+APPLY_PR_TEMPLATES_VECTOR_NATIVE_ACTIVE_RELOCATION

docs/dev/NEXT_COMMAND.txt

@@ -1,3 +1,5 @@
-- updated roadmap item: `templates/` folder evaluated for keep vs move vs future-delete -> complete
-- appended deferred future roadmap note for relocating `templates/vector-native-arcade` to `tools/templates/`
-- no code/runtime changes
+- codex-only execution lane
+- move active vector-native template surface to tools/templates
+- update the four exact blocker files
+- leave starter-project-template untouched
+- no archive move

docs/dev/reports/change_summary.txt

@@ -1,34 +1,43 @@
 # Templates Vector-Native Active Relocation Report
 
-Generated: 2026-04-12  
-Lane: narrow decouple-only
+Generated: 2026-04-12
+Lane: BUILD_PR_TEMPLATES_VECTOR_NATIVE_ACTIVE_RELOCATION
 
-## Purpose
-Decouple active vector-native template references from `templates/vector-native-arcade/` and standardize on the canonical active path:
+## Scope Executed
+1. Moved template directory:
+   - `templates/vector-native-arcade/`
+   - -> `tools/templates/vector-native-arcade/`
+2. Updated only the required four files:
+   - `tools/shared/vectorNativeTemplate.js`
+   - `tools/shared/vectorTemplateSampleGame.js`
+   - `tests/tools/VectorNativeTemplate.test.mjs`
+   - `games/vector-arcade-sample/README.md`
+3. Wrote required validation artifacts:
+   - `docs/dev/reports/templates_vector_native_active_relocation_report.md`
+   - `docs/dev/reports/validation_checklist.txt`
 
+## Path Normalization Applied
+All required path references were normalized from:
+- `templates/vector-native-arcade/`
+to:
 - `tools/templates/vector-native-arcade/`
 
-## Scope Applied
-Modified only:
-- `tools/shared/vectorNativeTemplate.js`
-- `tools/shared/vectorTemplateSampleGame.js`
-- `tests/tools/VectorNativeTemplate.test.mjs`
-- `games/vector-arcade-sample/README.md`
+## Move Result
+- Destination exists: `tools/templates/vector-native-arcade/`
+- Source removed: `templates/vector-native-arcade/`
+- Files moved under destination: `15`
 
-## Changes Made
-1. Updated vector-native template asset/config/docs/runtime path strings to use `tools/templates/vector-native-arcade/`.
-2. Updated sample-game remap logic to map from `tools/templates/vector-native-arcade/` to `games/vector-arcade-sample/`.
-3. Updated test assertion for `definition.templatePath` to the canonical active path.
-4. Updated sample-game README template source path to the canonical active path.
-
-## Move Decision
-- No physical move performed in this lane.
-- `templates/vector-native-arcade/` remains in place.
-- Rationale: this lane is decouple-only and path normalization was completed in the four blocker files without requiring filesystem relocation for correctness in this PR.
-
-## Validation Notes
-- No bare legacy path references remain in the four target files (`templates/vector-native-arcade/` not preceded by `tools/`).
+## Guard Results
+- `templates/starter-project-template/` untouched.
 - No changes under:
   - `docs/dev/start_of_day/chatGPT/`
   - `docs/dev/start_of_day/codex/`
-- `templates/starter-project-template/` untouched.
+  - `docs/archive/`
+
+## Validation Summary
+- Legacy path references in the four target files (bare, non-`tools/`): `0`
+- Canonical active path references in the four target files: `28`
+
+## Notes
+- No archive actions were performed.
+- No additional non-required source files were edited.

docs/dev/reports/templates_vector_native_active_relocation_report.md

@@ -2,30 +2,26 @@ BUILD_PR_TEMPLATES_VECTOR_NATIVE_ACTIVE_RELOCATION
 Validation Checklist
 Generated: 2026-04-12
 
-[PASS] no bare legacy path references remain in the four target files
+[PASS] old vector-native template path no longer referenced in four target files
 Evidence:
-- `rg --pcre2 -n "(?<!tools/)templates/vector-native-arcade/|(?<!tools/)templates/vector-native-arcade\\b" tools/shared/vectorNativeTemplate.js tools/shared/vectorTemplateSampleGame.js tests/tools/VectorNativeTemplate.test.mjs games/vector-arcade-sample/README.md` -> no matches
+- `rg --pcre2 -n "(?<!tools/)templates/vector-native-arcade/|(?<!tools/)templates/vector-native-arcade\b" tools/shared/vectorNativeTemplate.js tools/shared/vectorTemplateSampleGame.js tests/tools/VectorNativeTemplate.test.mjs games/vector-arcade-sample/README.md` -> no matches
 
-[PASS] canonical active path is used in all four target files
+[PASS] new tools/templates path referenced in four target files
 Evidence:
-- `tools/templates/vector-native-arcade/` present in:
-  - `tools/shared/vectorNativeTemplate.js`
-  - `tools/shared/vectorTemplateSampleGame.js`
-  - `tests/tools/VectorNativeTemplate.test.mjs`
-  - `games/vector-arcade-sample/README.md`
+- `rg -n "tools/templates/vector-native-arcade/|tools/templates/vector-native-arcade" tools/shared/vectorNativeTemplate.js tools/shared/vectorTemplateSampleGame.js tests/tools/VectorNativeTemplate.test.mjs games/vector-arcade-sample/README.md` -> matches found
 
-[PASS] no changes under protected start_of_day directories
+[PASS] templates/starter-project-template remains untouched
 Evidence:
-- `git diff --name-only -- docs/dev/start_of_day/chatGPT docs/dev/start_of_day/codex` -> no entries
+- `git diff --name-only -- templates/starter-project-template` -> no entries
 
-[PASS] starter-project-template remains untouched
+[PASS] tools/templates/vector-native-arcade exists
 Evidence:
-- `git diff --name-only -- templates/starter-project-template` -> no entries
+- `Test-Path tools/templates/vector-native-arcade` -> `True`
 
-[PASS] no directory move/archive executed in this lane
+[PASS] templates/vector-native-arcade no longer exists
 Evidence:
-- `git diff --name-status` filter for `D|R|C` -> no entries related to this lane
+- `Test-Path templates/vector-native-arcade` -> `False`
 
-[INFO] targeted test execution note
+[PASS] protected start_of_day directories untouched
 Evidence:
-- direct isolated test invocation could not run in this local Node 20.8.1 environment because `node:module` `registerHooks` is unavailable; this repository's full test harness expects newer runtime hook support.
+- `git diff --name-only -- docs/dev/start_of_day/chatGPT docs/dev/start_of_day/codex` -> no entries

docs/dev/reports/validation_checklist.txt

@@ -0,0 +1,49 @@
+# BUILD_PR_TEMPLATES_VECTOR_NATIVE_ACTIVE_RELOCATION
+
+## PR Purpose
+Execute one narrow active-relocation lane for `vector-native-arcade` template references.
+
+## Scope
+This PR is single-purpose:
+- relocate the active `vector-native-arcade` template surface from `templates/vector-native-arcade/`
+- to `tools/templates/vector-native-arcade/`
+- update only the exact known blocker files
+- do not archive anything
+- do not touch `starter-project-template`
+
+## Exact Target Files
+### Must modify
+- `tools/shared/vectorNativeTemplate.js`
+- `tools/shared/vectorTemplateSampleGame.js`
+- `tests/tools/VectorNativeTemplate.test.mjs`
+- `games/vector-arcade-sample/README.md`
+
+### Must move if source exists
+- `templates/vector-native-arcade/`
+- to `tools/templates/vector-native-arcade/`
+
+### Must create or overwrite
+- `docs/dev/reports/templates_vector_native_active_relocation_report.md`
+- `docs/dev/reports/validation_checklist.txt`
+
+## Required Work
+1. Move `templates/vector-native-arcade/` to `tools/templates/vector-native-arcade/`.
+2. Update the four exact blocker files to use `tools/templates/vector-native-arcade/`.
+3. Leave `templates/starter-project-template/` untouched.
+4. Do not move `templates/` to archive.
+5. Do not touch unrelated cleanup targets.
+6. Do not change anything under:
+   - `docs/dev/start_of_day/chatGPT/`
+   - `docs/dev/start_of_day/codex/`
+
+## Validation
+- no references remain to `templates/vector-native-arcade/` in the four target files
+- references now point to `tools/templates/vector-native-arcade/`
+- `templates/starter-project-template/` still exists and is unchanged
+- `tools/templates/vector-native-arcade/` exists
+- `templates/vector-native-arcade/` no longer exists
+- protected start_of_day directories untouched
+
+## Expected Output
+Package output to:
+- `<project folder>/tmp/BUILD_PR_TEMPLATES_VECTOR_NATIVE_ACTIVE_RELOCATION.zip`