Run the full no-manual sequence: consolidate tool folders into canonical paths, repair broken references caused by rename drift, ignore legacy SpriteEditor, and produce the vector asset contract planning bundle.

Author: ToolboxAid

docs/dev/CODEX_COMMANDS.md

@@ -2,29 +2,13 @@ MODEL: GPT-5.4
 REASONING: high
 
 TASK:
-Create BUILD_PR_TOOLS_FOLDER_CONSOLIDATION under the HTML-JavaScript-Gaming repo.
+Execute all three tasks in one continuous Codex pass with no manual intervention.
 
-GOAL:
-Consolidate duplicate active tool folders into the approved canonical studio paths under `tools/`, repair active references, and remove duplicate folder drift.
+SEQUENCE:
+1. Execute BUILD_PR_TOOLS_FOLDER_CONSOLIDATION
+2. Validate and repair any broken paths/imports/references caused by the consolidation
+3. Create PLAN_PR_VECTOR_ASSET_CONTRACT as a docs-only planning bundle
 
-DELIVERABLES:
-- `docs/pr/BUILD_PR_TOOLS_FOLDER_CONSOLIDATION.md`
-- `docs/dev/CODEX_COMMANDS.md`
-- `docs/dev/COMMIT_COMMENT.txt`
-- `docs/dev/reports/file_tree.txt`
-- `docs/dev/reports/change_summary.txt`
-- `docs/dev/reports/validation_checklist.txt`
+ZIP TARGETS:
 - `tmp/BUILD_PR_TOOLS_FOLDER_CONSOLIDATION.zip`
-
-NEXT COMMAND:
-MODEL: GPT-5.4
-REASONING: high
-
-TASK:
-Create PLAN_PR_TOOLS_CANONICAL_NAMING_AUDIT
-
-GOAL:
-Document and lock the final approved canonical naming/path convention for active tool folders and related internal references after consolidation.
-
-ZIP:
-`tmp/PLAN_PR_TOOLS_CANONICAL_NAMING_AUDIT.zip`
+- `tmp/PLAN_PR_VECTOR_ASSET_CONTRACT.zip`

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-build(tools): consolidate duplicate tool folders into canonical studio paths
+build(tools): finalize tool consolidation and plan vector asset contract

docs/dev/reports/change_summary.txt

@@ -1,36 +1,25 @@
 Change Summary
 ==============
 
-Canonical folders kept
-----------------------
-- `tools/Sprite Editor V3/`
-- `tools/Tilemap Studio/`
-- `tools/Parallax Scene Studio/`
-- `tools/Vector Asset Studio/`
+Phase 1 and 2
+-------------
+- finalized the active sprite tool at `tools/Sprite Editor V3/`
+- removed duplicate `tools/Pixel Asset Studio/`
+- kept `tools/SpriteEditor_old_keep/` parked as legacy and out of the active platform
+- retained `tools/Tilemap Studio/`, `tools/Parallax Scene Studio/`, and `tools/Vector Asset Studio/` as canonical active tool folders
+- renamed `tools/VectorMapEditor/` to `tools/Vector Map Editor/`
+- updated the tools launcher to point at the final canonical folders and added a `Vector Map Editor` card
+- repaired docs/report/path references caused by the consolidation and rename pass
 
-Duplicate folders removed
--------------------------
-- `tools/Sprite Editor/`
-- `tools/Tile Map Editor/`
-- `tools/Parallax Editor/`
-- `tools/SVG Background Editor/`
+Validation and repair highlights
+--------------------------------
+- canonical launcher links verified
+- canonical sample-manifest paths verified
+- canonical sprite/vector/tilemap/parallax entry files syntax-checked with `node --check`
+- active-surface scans confirm no required refs remain to deprecated duplicate folders
+- active-surface scans confirm no required platform refs remain to legacy `tools/SpriteEditor_old_keep/`
 
-Files moved or merged
----------------------
-- Pixel tool implementation files moved into `tools/Sprite Editor V3/`
-- Tilemap tool implementation files and samples moved into `tools/Tilemap Studio/`
-- Parallax tool implementation files and samples moved into `tools/Parallax Scene Studio/`
-- Vector tool implementation files and samples moved into `tools/Vector Asset Studio/`
-- Canonical `index.html` and `README.md` files rewritten to remove transition text
-
-References updated
-------------------
-- `tools/index.html`
-- canonical tool entrypoints
-- canonical tool READMEs
-- docs and validation reports referencing deprecated duplicate active tool folders
-
-Explicit exclusion
-------------------
-- `tools/SpriteEditor_old_keep/` was intentionally ignored as legacy and out of scope
-- `tools/Sprite Editor V3/` was not part of the duplicate-folder consolidation set
+Phase 3
+-------
+- added `docs/pr/PLAN_PR_VECTOR_ASSET_CONTRACT.md`
+- updated the command, commit, file-tree, change-summary, and validation-checklist docs for the full three-phase run

docs/dev/reports/file_tree.txt

@@ -24,6 +24,12 @@ tools/
     README.md
     samples/
   Vector Map Editor/
+    index.html
+    main.js
+    vectorMapEditor.css
+    README.md
+    how_to_use.html
+    assets/
+    editor/
   shared/
-  SpriteEditor/
-  Sprite Editor V3/
+  SpriteEditor_old_keep/

docs/dev/reports/validation_checklist.txt

@@ -1,39 +1,34 @@
 Validation Checklist
 ====================
 
-Inventory and selection
------------------------
-[x] Inventory all folders directly under `tools/`
-[x] Identify duplicate active tool folders created by rename drift
-[x] Select canonical current folders based on approved studio naming
-[x] Confirm legacy `tools/SpriteEditor_old_keep/` is intentionally out of scope
-
-Consolidation
+Phase 1 and 2
 -------------
-[x] Move active implementation files into canonical tool folders
-[x] Move sample folders into canonical tool folders where applicable
-[x] Replace wrapper `index.html` files with real canonical tool entrypoints
-[x] Replace wrapper `README.md` files with canonical tool documentation
-[x] Remove obsolete duplicate active tool folders
-
-Reference cleanup
------------------
-[x] Update launcher/index links and descriptions to canonical tool folders
-[x] Update canonical tool READMEs to canonical paths
-[x] Update active docs and validation reports that referenced duplicate active tool folders
-[x] Remove remaining repo references to `tools/Sprite Editor/`
-[x] Remove remaining repo references to `tools/Tile Map Editor/`
-[x] Remove remaining repo references to `tools/Parallax Editor/`
-[x] Remove remaining repo references to `tools/SVG Background Editor/`
-[x] Confirm no required tool-loading paths depend on legacy `tools/SpriteEditor_old_keep/`
+[x] Inventory folders directly under `tools/`
+[x] Identify duplicate and rename-drift tool folders
+[x] Select canonical current tool folders
+[x] Remove obsolete duplicate tool folders
+[x] Keep legacy `tools/SpriteEditor_old_keep/` out of the active platform
+[x] Repair launcher/index links
+[x] Repair broken path/reference drift after renames
+[x] Confirm `tools/Tilemap Studio/samples/sample-manifest.json` exists
+[x] Confirm `tools/Parallax Scene Studio/samples/sample-manifest.json` exists
+[x] Confirm `tools/Vector Asset Studio/samples/sample-manifest.json` exists
+[x] Confirm vector/svg tool paths remain present where referenced
+[x] `node --check tools/Sprite Editor V3/main.js`
+[x] `node --check tools/Sprite Editor V3/modules/spriteEditorApp.js`
+[x] `node --check tools/Sprite Editor V3/modules/projectModel.js`
+[x] `node --check tools/Sprite Editor V3/modules/constants.js`
+[x] `node --check tools/Tilemap Studio/main.js`
+[x] `node --check tools/Parallax Scene Studio/main.js`
+[x] `node --check tools/Vector Asset Studio/main.js`
+[x] `node --check tools/Vector Map Editor/main.js`
+[x] `node --check tools/Vector Map Editor/editor/VectorMapEditorApp.js`
+[x] No required refs to deprecated duplicate folders in `tools/`, `games/`, `tests/`, or `scripts/`
+[x] No required refs to legacy `tools/SpriteEditor_old_keep/` in `tools/`, `games/`, `tests/`, or `scripts/`
 
-Tool path validation
---------------------
-[x] `tools/index.html` links target canonical tool folders
-[x] `tools/Sprite Editor V3/index.html` exists with matching JS and CSS
-[x] `tools/Tilemap Studio/index.html` exists with matching JS and CSS
-[x] `tools/Parallax Scene Studio/index.html` exists with matching JS and CSS
-[x] `tools/Vector Asset Studio/index.html` exists with matching JS and CSS
-[x] Tilemap sample manifest remains present
-[x] Parallax sample manifest remains present
-[x] Vector/SVG sample manifest remains present
+Phase 3
+-------
+[x] `docs/pr/PLAN_PR_VECTOR_ASSET_CONTRACT.md` created
+[x] `docs/dev/CODEX_COMMANDS.md` updated
+[x] `docs/dev/COMMIT_COMMENT.txt` updated
+[x] reports refreshed for the final canonical tool layout

docs/pr/BUILD_PR_CODEX_AUTORUN_TOOLS_AND_VECTOR_CONTRACT.md

@@ -0,0 +1,111 @@
+# BUILD_PR_CODEX_AUTORUN_TOOLS_AND_VECTOR_CONTRACT
+
+## Purpose
+Execute the full sequence with **no manual intervention**:
+
+1. Consolidate renamed/duplicate tool folders under `tools/`
+2. Validate the repo after consolidation and repair any broken paths/imports/references caused by that consolidation
+3. Produce the docs-first planning bundle for `PLAN_PR_VECTOR_ASSET_CONTRACT`
+
+This PR bundle is intended for Codex execution only. The goal is to let Codex perform the implementation, validation, repair, and follow-on planning in one continuous pass.
+
+## Scope
+### In scope
+- Tool-folder consolidation under `tools/`
+- Canonical path selection for current tool folders
+- File movement/merging into canonical tool folders
+- Reference/path/import updates caused by consolidation
+- Validation of launcher/index/tool/sample/asset/vector paths
+- Repair of any broken paths caused by consolidation
+- Creation of a docs-only `PLAN_PR_VECTOR_ASSET_CONTRACT` bundle
+- Repo-structured ZIP outputs
+
+### Explicit exclusions
+- Legacy `old SpriteEditor` consolidation work
+- Unrelated engine refactors
+- Unrelated gameplay work
+- New feature work outside path repair required by consolidation
+
+## Required execution order
+### Phase 1 — Consolidate tools folders
+Codex must:
+- inventory folders directly under `tools/`
+- identify duplicate/renamed folders created by rename drift
+- choose the canonical current folder for each tool based on newer approved naming
+- merge/move files into canonical folders
+- update repo references to canonical locations
+- remove obsolete duplicate folders after validation
+- ignore old SpriteEditor except for active path cleanup if absolutely necessary to keep the repo working
+
+### Phase 2 — Validate and repair
+Codex must perform validation and fix issues without requiring manual follow-up.
+
+Validation must cover:
+- launcher/index links
+- Tile Map Editor
+- Parallax Editor
+- SVG Editor
+- sample loading
+- asset loading
+- vector/SVG loading if referenced
+- tile-map and parallax config/json path resolution
+- no remaining required references to deprecated duplicate folders
+- no remaining required references to old SpriteEditor
+
+If broken references are found, Codex must fix them in the same pass.
+
+### Phase 3 — Create docs-only vector asset contract plan
+After Phase 1 and Phase 2 are complete, Codex must create:
+
+- `docs/pr/PLAN_PR_VECTOR_ASSET_CONTRACT.md`
+- `docs/dev/codex_commands.md` (updated for the vector asset contract plan output)
+- `docs/dev/commit_comment.txt`
+- `docs/dev/reports/file_tree.txt`
+- `docs/dev/reports/change_summary.txt`
+- `docs/dev/reports/validation_checklist.txt`
+
+The vector asset contract plan must define the future planning/documentation needed to lock:
+- vector asset file contract
+- coordinate system
+- origin rules
+- scaling rules
+- stroke/fill rules
+- palette/color binding rules
+- layering/z-order rules
+- metadata/extensibility rules
+- tool/runtime ownership boundaries
+- validation examples
+
+## Deliverables for this combined Codex run
+### Build/consolidation docs
+- `docs/pr/BUILD_PR_TOOLS_FOLDER_CONSOLIDATION.md`
+- `docs/dev/reports/file_tree.txt`
+- `docs/dev/reports/change_summary.txt`
+- `docs/dev/reports/validation_checklist.txt`
+
+### Follow-on plan docs
+- `docs/pr/PLAN_PR_VECTOR_ASSET_CONTRACT.md`
+- refreshed `docs/dev/codex_commands.md`
+- refreshed `docs/dev/commit_comment.txt`
+
+## Success criteria
+- One canonical folder per active tool under `tools/`
+- Duplicate rename-created folders removed after consolidation
+- Old SpriteEditor ignored as legacy/out-of-scope except required path cleanup
+- Active tool paths work from canonical names
+- Samples/assets/configs load from canonical paths
+- No manual cleanup step remains
+- Vector asset contract planning bundle exists and is ready for the next Codex pass
+
+## Output ZIP requirement
+Codex should package outputs as repo-structured ZIPs at:
+
+- `<project folder>/tmp/BUILD_PR_TOOLS_FOLDER_CONSOLIDATION.zip`
+- `<project folder>/tmp/PLAN_PR_VECTOR_ASSET_CONTRACT.zip`
+
+## Notes
+This is a **no-manual** execution request.
+Codex should complete all three parts in sequence:
+1. build/consolidate
+2. validate/repair
+3. generate vector asset contract plan