Reduce active toolbox ownership, finalize archive v1-v2, and establish toolbox end-state inventory - PR_26154_045-047-cleanup-stack

Author: ToolboxAid

toolbox/configuration-admin/index.html …reference/configuration-admin/index.htmltoolbox/configuration-admin/index.html renamed to archive/v1-v2/tools/toolbox-reduction-reference/configuration-admin/index.html toolbox/configuration-admin/index.html renamed to archive/v1-v2/tools/toolbox-reduction-reference/configuration-admin/index.html

@@ -17,8 +17,6 @@
         "sound-studio": "toolbox/sound/index.html",
         "storage-inspector": "toolbox/storage/index.html",
         "world-vector-studio": "toolbox/world-vector/index.html",
-        "configuration-admin": "toolbox/configuration-admin/index.html",
-        "tool-creator": "toolbox/creator/index.html",
         cloud: "toolbox/cloud/index.html",
         games: "games/index.html",
         arcade: "games/arcade/index.html",

toolbox/creator/index.html …uction-reference/tool-creator/index.htmltoolbox/creator/index.html renamed to archive/v1-v2/tools/toolbox-reduction-reference/tool-creator/index.html toolbox/creator/index.html renamed to archive/v1-v2/tools/toolbox-reduction-reference/tool-creator/index.html

@@ -26,7 +26,6 @@
             </div>
           </div>
           <a data-nav-link data-toolbox-menu-item data-route="palette-manager" href="toolbox/palette/index.html">Palette Manager</a>
-          <a data-nav-link data-toolbox-menu-item data-route="configuration-admin" href="toolbox/configuration-admin/index.html">Configuration Admin</a>
           <a data-nav-link data-toolbox-menu-item data-route="input-studio" href="toolbox/input/index.html">Input</a>
           <div class="nav-item nav-popout-item" data-toolbox-menu-group>
             <a data-toolbox-menu-group-label data-route="toolbox" href="toolbox/index.html" aria-haspopup="true">Objects &#9656;</a>
@@ -37,7 +36,6 @@
               <a data-nav-link data-toolbox-menu-item data-route="object-vector-studio" href="toolbox/object-vector/index.html">Object Vector</a>
             </div>
           </div>
-          <a data-nav-link data-toolbox-menu-item data-route="tool-creator" href="toolbox/creator/index.html">Tool Creator</a>
           <div class="nav-item nav-popout-item" data-toolbox-menu-group>
             <a data-toolbox-menu-group-label data-route="toolbox" href="toolbox/index.html" aria-haspopup="true">Worlds &#9656;</a>
             <div class="sub-menu sub-menu--nested" data-toolbox-submenu aria-label="World tools">
@@ -73,7 +71,6 @@
           <a data-nav-link data-route="admin-moderation" href="admin/moderation.html">Moderation</a>
           <a data-nav-link data-route="admin-ratings" href="admin/ratings.html">Ratings</a>
           <a data-nav-link data-route="admin-roles" href="admin/roles.html">Roles</a>
-          <a data-nav-link data-route="configuration-admin" href="toolbox/configuration-admin/index.html">Settings and Admin</a>
           <a data-nav-link data-route="admin-site-settings" href="admin/site-settings.html">Site Settings</a>
           <a data-nav-link data-route="admin-themes" href="admin/themes.html">Themes</a>
           <a data-nav-link data-route="admin-users" href="admin/users.html">Users</a>

assets/theme-v2/images/Tools Dependency Tree.png

@@ -2,52 +2,59 @@
 
 Task:
 
-- `PR_26154_042-toolbox-route-reference-hygiene`
-- `PR_26154_043-docs-build-archive-consolidation`
-- `PR_26154_044-final-active-toolbox-template-gate`
+- `PR_26154_045-active-toolbox-reduction`
+- `PR_26154_046-archive-v1-v2-finalization`
+- `PR_26154_047-toolbox-endstate-inventory`
 
 Changes:
 
 - Read `.codex/skills/repo-build/SKILL.md`.
 - Read `docs_build/dev/PROJECT_INSTRUCTIONS.md`.
-- Used `PR_26154_039-041-builder-shared-active-closeout` as baseline.
-- Audited active route references for removed builder surfaces.
-- Confirmed `toolbox/game-design/` is the only active game design/build planning surface.
-- Moved 46 historical builder/route reports from `docs_build/dev/reports/` to `archive/v1-v2/docs_build/dev/reports/toolbox-builder-route-history/`.
-- Moved existing `docs_build/dev/archive/object-vector-studio-v2/starter-project-template/` material to `archive/v1-v2/docs_build/dev/archive/object-vector-studio-v2/starter-project-template/`.
-- Updated docs_build references to moved archive material.
-- Ran the final active Toolbox template gate across all active tool pages.
+- Used `PR_26154_042-044-toolbox-route-archive-template-gate` as baseline.
+- Audited active Toolbox folders and classified requested candidates.
+- Moved `toolbox/configuration-admin/` to `archive/v1-v2/tools/toolbox-reduction-reference/configuration-admin/`.
+- Moved `toolbox/creator/` to `archive/v1-v2/tools/toolbox-reduction-reference/tool-creator/`.
+- Removed Configuration Admin and Tool Creator from active header navigation, route aliases, and Toolbox index grouping.
+- Updated active surface validation to reject the retired Toolbox folders if they return.
+- Rewired hidden legacy registry/sample references from removed `old-tools` and `old_samples` roots to `archive/v1-v2`.
+- Updated docs_build guard scripts and selected validation utilities for archive path ownership.
+- Produced active Toolbox and archive end-state reports.
 - Did not modify `start_of_day/`.
 - Did not run tests against `archive/v1-v2/`.
 - Did not run the full samples smoke test.
 
 Validation:
 
-- Ran targeted active route scans for retired builder paths.
-- Ran targeted docs_build archive reference checks.
-- Ran final active Toolbox template consistency audit with counts.
+- Ran targeted active route scans for retired Configuration Admin and Tool Creator paths.
+- Ran targeted archive path checks for `archive/v1-v2/tools`, `archive/v1-v2/games`, and `archive/v1-v2/samples`.
+- Ran active Toolbox template consistency audit: 16 active pages, 10 markers, 0 mismatches.
 - Ran `node scripts/validate-active-tools-surface.mjs`.
-- Ran changed-file static validation for HTML, JS, CSS, JSON, and Markdown files.
+- Ran `node docs_build/dev/toolbox/checkSharedExtractionGuard.mjs`.
+- Ran changed-file JavaScript syntax checks with `node --check`.
+- Ran changed JSON parse checks.
+- Ran `python -m py_compile scripts/engine_usage_audit.py`.
+- Ran `npm run test:workspace-v2`.
 - Ran `git diff --check`.
-- Skipped `npm run test:workspace-v2` because active Toolbox navigation and template wiring were not changed.
 - Regenerated required Codex review artifacts.
 - Packaged repo-structured ZIP:
-  - `tmp/PR_26154_042-044-toolbox-route-archive-template-gate_delta.zip`
+  - `tmp/PR_26154_045-047-toolbox-reduction-archive-endstate_delta.zip`
 
 Required reports:
 
 - `docs_build/dev/reports/codex_changed_files.txt`
 - `docs_build/dev/reports/codex_review.diff`
-- `docs_build/dev/reports/toolbox_route_reference_hygiene_report.md`
-- `docs_build/dev/reports/docs_build_archive_consolidation_report.md`
-- `docs_build/dev/reports/final_active_toolbox_template_gate_report.md`
+- `docs_build/dev/reports/active_toolbox_reduction_report.md`
+- `docs_build/dev/reports/archive_v1_v2_finalization_report.md`
+- `docs_build/dev/reports/toolbox_endstate_inventory_report.md`
 
 Validation summary:
 
-- PASS: active builder route hygiene.
-- PASS: docs_build archive consolidation.
-- PASS: active Toolbox template gate, 18 of 18 pages passing.
-- PASS: static validation.
+- PASS: active Toolbox surface reduced to 16 active pages.
+- PASS: retired tool routes removed from active nav/index/route aliases.
+- PASS: active Toolbox template audit.
+- PASS: Workspace V2 lane, 2 Playwright tests passed.
+- PASS: static syntax/JSON validation for changed files.
 - PASS: `git diff --check`.
-- SKIPPED: Workspace V2 Playwright because no active nav/template behavior changed.
-- SKIPPED: archive tests and full samples smoke test.
+- INFO: optional Phase 24 guard now resolves archive paths from repo root, but its existing roadmap hash lock is stale and was not used as this PR's gate.
+- SKIPPED: tests against `archive/v1-v2/`.
+- SKIPPED: full samples smoke test.

assets/theme-v2/js/gamefoundry-partials.js

@@ -1,8 +1,8 @@
-Close toolbox route hygiene and archive stale builder reports - PR_26154_042-044
+Reduce active Toolbox surface and finalize V1/V2 archive references - PR_26154_045-047
 
-- Confirm active surfaces no longer reference retired Tool Builder or Game Builder routes.
-- Keep Game Design as the only active game design/build planning surface.
-- Move stale builder-route and legacy GameFoundryStudio report history under archive/v1-v2.
-- Move existing docs_build/dev/archive material under archive/v1-v2.
-- Verify all 18 active Toolbox pages satisfy template-critical markers, Theme V2 wiring, header/index coverage, and no local css/js folders.
-- Validate targeted route checks, active Toolbox surface, changed-file static checks, diff hygiene, review artifacts, and repo-structured delta packaging.
+- Archive Configuration Admin and Tool Creator under archive/v1-v2/tools/toolbox-reduction-reference.
+- Remove those retired pages from active Toolbox navigation, route aliases, and Toolbox index grouping.
+- Keep 16 active end-user Toolbox tools plus toolbox/_tool_template-v2 as the active template.
+- Rewire hidden legacy registry/sample references and docs_build guards from removed old roots to archive/v1-v2 paths.
+- Confirm archive/v1-v2/tools, archive/v1-v2/games, and archive/v1-v2/samples are the deprecated reference roots.
+- Validate active Toolbox surface, template markers, changed-file syntax/JSON, Workspace V2, diff hygiene, review artifacts, and repo-structured delta packaging.

assets/theme-v2/partials/header-nav.html

@@ -0,0 +1,43 @@
+# Active Toolbox Reduction Report
+
+Task: `PR_26154_045-active-toolbox-reduction`
+
+## Summary
+
+Reduced the active Toolbox surface to real end-user tools by archiving two clear non-user-facing pages:
+
+- `toolbox/configuration-admin/index.html` -> `archive/v1-v2/tools/toolbox-reduction-reference/configuration-admin/index.html`
+- `toolbox/creator/index.html` -> `archive/v1-v2/tools/toolbox-reduction-reference/tool-creator/index.html`
+
+The active Toolbox now contains 16 tool pages plus the active template source `toolbox/_tool_template-v2/`.
+
+## Requested Folder Classification
+
+| Folder | Classification | Action |
+| --- | --- | --- |
+| `toolbox/dev` | DOCS_BUILD | Already absent from active Toolbox; ownership remains under docs/build governance from prior cleanup. |
+| `toolbox/shared` | ENGINE/SRC | Already absent from active Toolbox; active shared behavior remains under `src/shared/toolbox/`. |
+| `toolbox/schemas` | ENGINE/SRC | Already absent from active Toolbox; active schemas remain under `src/shared/schemas/`. |
+| `toolbox/assets` | ACTIVE TOOL | Kept as an end-user asset creation surface. |
+| `toolbox/code` | ACTIVE TOOL / AMBIGUOUS | Kept because active contracts and shared creator-extension behavior still reference this surface. |
+| `toolbox/creator` | ARCHIVE | Moved to archive as template/tool-authoring reference material, not an end-user tool. |
+| `toolbox/configuration-admin` | ARCHIVE | Moved to archive as admin/settings reference material, not an end-user Toolbox tool. |
+
+## Active Reference Updates
+
+- Removed Configuration Admin and Tool Creator from `assets/theme-v2/partials/header-nav.html`.
+- Removed Configuration Admin and Tool Creator route aliases from `assets/theme-v2/js/gamefoundry-partials.js`.
+- Removed the `Tooling` group from `toolbox/tools-page-accordions.js`.
+- Extended `scripts/validate-active-tools-surface.mjs` so retired `toolbox/configuration-admin` and `toolbox/creator` routes fail active-surface validation if reintroduced.
+
+## Validation
+
+- PASS: `node scripts/validate-active-tools-surface.mjs`
+- PASS: targeted scans found no active references to the retired `toolbox/configuration-admin` or `toolbox/creator` routes.
+- PASS: active Toolbox template audit reports 16 active pages, 10 markers, 0 mismatches.
+- PASS: `npm run test:workspace-v2`
+
+## Notes
+
+- Marketplace remains outside Toolbox and is not listed in `toolbox/index.html`.
+- `toolbox/code` remains active for now because it is tied to active creator-extension contracts; moving it would require a dedicated registry/runtime reconciliation PR.

docs_build/dev/codex_commands.md

@@ -0,0 +1,49 @@
+# Archive V1/V2 Finalization Report
+
+Task: `PR_26154_046-archive-v1-v2-finalization`
+
+## Summary
+
+Confirmed the legacy reference material root is consolidated under `archive/v1-v2/`:
+
+- `archive/v1-v2/tools/`
+- `archive/v1-v2/games/`
+- `archive/v1-v2/samples/`
+
+The former root folders `old-tools/`, `old_games/`, and `old_samples/` are absent.
+
+## Changes
+
+- Added the newly retired Toolbox reference pages under `archive/v1-v2/tools/toolbox-reduction-reference/`.
+- Rewired hidden legacy Toolbox registry entries from `../old-tools/` and `../old_samples/` to `../archive/v1-v2/tools/` and `../archive/v1-v2/samples/`.
+- Rewired `toolbox/renderToolsIndex.js` sample metadata paths from `/old_samples/` to `/archive/v1-v2/samples/`.
+- Updated docs_build guard scripts and baselines that still encoded root `old_samples` / `old_games` paths to use `archive/v1-v2/samples` and `archive/v1-v2/games`.
+- Updated selected validation utilities so archive game/sample paths are recognized as deprecated reference ownership.
+
+## Archive State
+
+| Path | State |
+| --- | --- |
+| `archive/v1-v2/tools/` | Present; contains deprecated tool/reference material. |
+| `archive/v1-v2/games/` | Present; contains deprecated playable reference games. |
+| `archive/v1-v2/samples/` | Present; contains deprecated sample references. |
+| `old-tools/` | Absent. |
+| `old_games/` | Absent. |
+| `old_samples/` | Absent. |
+| `docs_build/archive/` | Absent. |
+| `docs_build/dev/archive/` | Absent. |
+
+## Remaining Archive Policy Items
+
+- `archive/v1-v2/docs_build/archive/tools/SpriteEditor_old_keep/` remains in its existing policy location. It is reported as an archive-placement policy candidate rather than moved in this PR.
+- Some compatibility code still accepts historical `old_games` / `old_samples` strings as legacy input. Those are retained as compatibility aliases and should be addressed in a dedicated runtime/path-convention PR.
+
+## Validation
+
+- PASS: archive root existence checks for `archive/v1-v2/tools`, `archive/v1-v2/games`, and `archive/v1-v2/samples`.
+- PASS: root absence checks for `old-tools`, `old_games`, and `old_samples`.
+- PASS: `node docs_build/dev/toolbox/checkSharedExtractionGuard.mjs`
+- PASS: changed JS syntax checks for touched archive-routing scripts.
+- INFO: `docs_build/dev/toolbox/checkPhase24CloseoutExecutionGuard.mjs` now resolves archive paths from repo root; its roadmap hash lock is stale independently of this PR and was not used as a required gate.
+
+No tests were run against `archive/v1-v2/`.