Consolidate renamed tool folders into canonical paths, repair references, remove duplicate folder drift, and intentionally exclude legacy SpriteEditor from consolidation scope.

Author: ToolboxAid

docs/dev/CODEX_COMMANDS.md

@@ -1,20 +1,30 @@
 MODEL: GPT-5.4
 REASONING: high
 
-COMMAND:
-Execute this clean progression in order.
+TASK:
+Create BUILD_PR_TOOLS_FOLDER_CONSOLIDATION under the HTML-JavaScript-Gaming repo.
 
-Step 1:
-Create BUILD_PR_VECTOR_TEMPLATE_SAMPLE_GAME.
+GOAL:
+Consolidate duplicate active tool folders into the approved canonical studio paths under `tools/`, repair active references, and remove duplicate folder drift.
 
-BUILD requirements:
-- Build a standalone sample game from `templates/vector-native-arcade/`
-- Use vector assets as the only active visual runtime dependency
-- Preserve strict validation, packaging, runtime, debug, profiler, export, and publishing compatibility
-- Avoid engine core API changes
+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`
+- `tmp/BUILD_PR_TOOLS_FOLDER_CONSOLIDATION.zip`
 
-Step 2:
-Treat docs/pr/PLAN_PR_VECTOR_GEOMETRY_RUNTIME.md as the governing architecture contract for the next runtime evolution.
+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.
 
-Package:
-HTML-JavaScript-Gaming/tmp/VECTOR_TEMPLATE_SAMPLE_GAME_AND_GEOMETRY_RUNTIME_delta.zip
+ZIP:
+`tmp/PLAN_PR_TOOLS_CANONICAL_NAMING_AUDIT.zip`

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-build(vector-platform): add vector template sample game and define geometry runtime
+build(tools): consolidate duplicate tool folders into canonical studio paths

docs/dev/QC_click_by_click_test_script.md

@@ -16,7 +16,7 @@
 ## 1. Launch / Smoke Test
 
 ### 1.1 Open editor
-- [x] Open `tools/SpriteEditor/index.html`
+- [x] Open `tools/SpriteEditor_old_keep/index.html`
 - [x] Verify editor loads without visible errors
 - [x] Verify no console errors on load
 

docs/dev/reports/asset_remediation_system_validation.txt

@@ -4,19 +4,19 @@ Files:
 - tools/shared/projectAssetRemediation.js
 - tests/tools/AssetRemediationSystem.test.mjs
 - tests/run-tests.mjs
-- tools/Sprite Editor/index.html
-- tools/Sprite Editor/modules/spriteEditorApp.js
-- tools/Tile Map Editor/index.html
-- tools/Tile Map Editor/main.js
-- tools/Parallax Editor/index.html
-- tools/Parallax Editor/main.js
+- tools/SpriteEditorV3/index.html
+- tools/SpriteEditorV3/modules/spriteEditorApp.js
+- tools/Tilemap Studio/index.html
+- tools/Tilemap Studio/main.js
+- tools/Parallax Scene Studio/index.html
+- tools/Parallax Scene Studio/main.js
 
 Checks passed:
 - node --check tools/shared/projectAssetRemediation.js
 - node --check tests/tools/AssetRemediationSystem.test.mjs
-- node --check tools/Sprite Editor/modules/spriteEditorApp.js
-- node --check tools/Tile Map Editor/main.js
-- node --check tools/Parallax Editor/main.js
+- node --check tools/SpriteEditorV3/modules/spriteEditorApp.js
+- node --check tools/Tilemap Studio/main.js
+- node --check tools/Parallax Scene Studio/main.js
 - targeted AssetRemediationSystem test via node inline runner
 - node ./scripts/run-node-tests.mjs
 

docs/dev/reports/asset_validation_engine_validation.txt

@@ -3,15 +3,15 @@ BUILD_PR_ASSET_VALIDATION_ENGINE validation
 Files:
 - tools/shared/projectAssetValidation.js
 - tests/tools/AssetValidationEngine.test.mjs
-- tools/Sprite Editor/modules/spriteEditorApp.js
-- tools/Tile Map Editor/main.js
-- tools/Parallax Editor/main.js
+- tools/SpriteEditorV3/modules/spriteEditorApp.js
+- tools/Tilemap Studio/main.js
+- tools/Parallax Scene Studio/main.js
 
 Checks passed:
 - node --check tools/shared/projectAssetValidation.js
-- node --check tools/Sprite Editor/modules/spriteEditorApp.js
-- node --check tools/Tile Map Editor/main.js
-- node --check tools/Parallax Editor/main.js
+- node --check tools/SpriteEditorV3/modules/spriteEditorApp.js
+- node --check tools/Tilemap Studio/main.js
+- node --check tools/Parallax Scene Studio/main.js
 - node --check tests/tools/AssetValidationEngine.test.mjs
 - targeted AssetValidationEngine test via node inline runner
 - node ./scripts/run-node-tests.mjs

docs/dev/reports/change_summary.txt

@@ -1,6 +1,36 @@
-Completed BUILD_PR_ASSET_DEPENDENCY_GRAPH as an additive project-level asset graph slice.
+Change Summary
+==============
 
-Summary:
-- Added shared dependency graph generation in `tools/shared/projectAssetRegistry.js` using stable node IDs, deterministic edge ordering, and non-blocking validation findings.
-- Updated Sprite Editor, Tile Map Editor, and Parallax Editor save flows to persist `project.assetDependencyGraph` snapshots without changing engine core APIs.
-- Preserved legacy compatibility by keeping graph persistence additive and leaving load flows tolerant of missing graph data.
+Canonical folders kept
+----------------------
+- `tools/SpriteEditorV3/`
+- `tools/Tilemap Studio/`
+- `tools/Parallax Scene Studio/`
+- `tools/Vector Asset Studio/`
+
+Duplicate folders removed
+-------------------------
+- `tools/Sprite Editor/`
+- `tools/Tile Map Editor/`
+- `tools/Parallax Editor/`
+- `tools/SVG Background Editor/`
+
+Files moved or merged
+---------------------
+- Pixel tool implementation files moved into `tools/SpriteEditorV3/`
+- 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/SpriteEditorV3/` was not part of the duplicate-folder consolidation set

docs/dev/reports/debug_visualization_layer_validation.txt

@@ -4,19 +4,19 @@ Files:
 - tools/shared/debugVisualizationLayer.js
 - tests/tools/DebugVisualizationLayer.test.mjs
 - tests/run-tests.mjs
-- tools/Sprite Editor/index.html
-- tools/Sprite Editor/modules/spriteEditorApp.js
-- tools/Tile Map Editor/index.html
-- tools/Tile Map Editor/main.js
-- tools/Parallax Editor/index.html
-- tools/Parallax Editor/main.js
+- tools/SpriteEditorV3/index.html
+- tools/SpriteEditorV3/modules/spriteEditorApp.js
+- tools/Tilemap Studio/index.html
+- tools/Tilemap Studio/main.js
+- tools/Parallax Scene Studio/index.html
+- tools/Parallax Scene Studio/main.js
 
 Checks passed:
 - node --check tools/shared/debugVisualizationLayer.js
 - node --check tests/tools/DebugVisualizationLayer.test.mjs
-- node --check tools/Sprite Editor/modules/spriteEditorApp.js
-- node --check tools/Tile Map Editor/main.js
-- node --check tools/Parallax Editor/main.js
+- node --check tools/SpriteEditorV3/modules/spriteEditorApp.js
+- node --check tools/Tilemap Studio/main.js
+- node --check tools/Parallax Scene Studio/main.js
 - node ./scripts/run-node-tests.mjs
 
 Behavior confirmed:

docs/dev/reports/editor_experience_layer_validation.txt

@@ -4,19 +4,19 @@ Files:
 - tools/shared/editorExperienceLayer.js
 - tests/tools/EditorExperienceLayer.test.mjs
 - tests/run-tests.mjs
-- tools/Sprite Editor/index.html
-- tools/Sprite Editor/modules/spriteEditorApp.js
-- tools/Tile Map Editor/index.html
-- tools/Tile Map Editor/main.js
-- tools/Parallax Editor/index.html
-- tools/Parallax Editor/main.js
+- tools/SpriteEditorV3/index.html
+- tools/SpriteEditorV3/modules/spriteEditorApp.js
+- tools/Tilemap Studio/index.html
+- tools/Tilemap Studio/main.js
+- tools/Parallax Scene Studio/index.html
+- tools/Parallax Scene Studio/main.js
 
 Checks passed:
 - node --check tools/shared/editorExperienceLayer.js
 - node --check tests/tools/EditorExperienceLayer.test.mjs
-- node --check tools/Sprite Editor/modules/spriteEditorApp.js
-- node --check tools/Tile Map Editor/main.js
-- node --check tools/Parallax Editor/main.js
+- node --check tools/SpriteEditorV3/modules/spriteEditorApp.js
+- node --check tools/Tilemap Studio/main.js
+- node --check tools/Parallax Scene Studio/main.js
 - node ./scripts/run-node-tests.mjs
 
 Behavior confirmed:

docs/dev/reports/file_tree.txt

@@ -1,21 +1,29 @@
-LEVEL_9_ASSET_DEPENDENCY_GRAPH_ATOMIC_PACKAGE_delta/
-docs/
-docs/dev/
-docs/dev/reports/
-docs/dev/reports/change_summary.txt
-docs/dev/reports/file_tree.txt
-docs/dev/reports/validation_checklist.txt
-docs/pr/
-docs/pr/APPLY_PR_ASSET_DEPENDENCY_GRAPH.md
-docs/pr/BUILD_PR_ASSET_DEPENDENCY_GRAPH.md
-docs/pr/PLAN_PR_ASSET_DEPENDENCY_GRAPH.md
 tools/
-tools/shared/
-tools/shared/projectAssetRegistry.js
-tools/Sprite Editor/
-tools/Sprite Editor/modules/
-tools/Sprite Editor/modules/spriteEditorApp.js
-tools/Tile Map Editor/
-tools/Tile Map Editor/main.js
-tools/Parallax Editor/
-tools/Parallax Editor/main.js
+  Parallax Scene Studio/
+    index.html
+    main.js
+    parallaxEditor.css
+    README.md
+    samples/
+  Sprite Editor V3/
+    index.html
+    main.js
+    spriteEditor.css
+    README.md
+    modules/
+  Tilemap Studio/
+    index.html
+    main.js
+    tileMapEditor.css
+    README.md
+    samples/
+  Vector Asset Studio/
+    index.html
+    main.js
+    svgBackgroundEditor.css
+    README.md
+    samples/
+  VectorMapEditor/
+  shared/
+  SpriteEditor/
+  SpriteEditorV3/

docs/dev/reports/project_packaging_system_validation.txt

@@ -4,19 +4,19 @@ Files:
 - tools/shared/projectPackaging.js
 - tests/tools/ProjectPackagingSystem.test.mjs
 - tests/run-tests.mjs
-- tools/Sprite Editor/index.html
-- tools/Sprite Editor/modules/spriteEditorApp.js
-- tools/Tile Map Editor/index.html
-- tools/Tile Map Editor/main.js
-- tools/Parallax Editor/index.html
-- tools/Parallax Editor/main.js
+- tools/SpriteEditorV3/index.html
+- tools/SpriteEditorV3/modules/spriteEditorApp.js
+- tools/Tilemap Studio/index.html
+- tools/Tilemap Studio/main.js
+- tools/Parallax Scene Studio/index.html
+- tools/Parallax Scene Studio/main.js
 
 Checks passed:
 - node --check tools/shared/projectPackaging.js
 - node --check tests/tools/ProjectPackagingSystem.test.mjs
-- node --check tools/Sprite Editor/modules/spriteEditorApp.js
-- node --check tools/Tile Map Editor/main.js
-- node --check tools/Parallax Editor/main.js
+- node --check tools/SpriteEditorV3/modules/spriteEditorApp.js
+- node --check tools/Tilemap Studio/main.js
+- node --check tools/Parallax Scene Studio/main.js
 - targeted ProjectPackagingSystem test via node inline runner
 - node ./scripts/run-node-tests.mjs