Update CI and developer scripts for layout

Author: ToolboxAid

.github/workflows/platform-validation.yml

@@ -20,4 +20,4 @@ jobs:
           node-version: "20"
 
       - name: Run Platform Validation Suite
-        run: node ./dev/scripts/run-platform-validation-suite.mjs
+        run: npm run validate:platform

dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md

@@ -117,7 +117,7 @@ Rules:
 
 ## Current Version/Date
 
-- Project Instructions Version: 2026.06.28.011
+- Project Instructions Version: 2026.06.28.012
 - Date: 2026-06-28
 - Owner: OWNER
 

dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS_VERSION.md

@@ -1,6 +1,6 @@
 # Project Instructions Version
 
-Current Project Instructions Version: 2026.06.28.011
+Current Project Instructions Version: 2026.06.28.012
 
 Last Updated: 2026-06-28
 
@@ -19,6 +19,7 @@ Last Updated: 2026-06-28
 - Moved server/API application runtime under `api/`; browser API clients remain outside `api/`.
 - Moved developer-only local runtime/bootstrap entrypoints under `dev/local-runtime/` and preserved the public npm command surface.
 - Finalized moved test and validation path assumptions for the `www/`, `api/`, and `dev/local-runtime/` layout.
+- Updated CI, package scripts, and developer utilities for the `www/`, `api/`, and `dev/` layout.
 - Codex must read this version file and the latest repository copy of `PROJECT_INSTRUCTIONS.md` before performing work.
 - Codex must discard previously remembered Project Instructions and treat the repository copy as authoritative.
 - Codex must validate canonical report and ZIP paths, branching model, and legacy path avoidance before work proceeds.

dev/build/ProjectInstructions/PROJECT_STATE.md

@@ -1,7 +1,7 @@
 # Project State
 
 ```yaml
-project_state_version: "2026.06.28.011"
+project_state_version: "2026.06.28.012"
 last_updated: "2026-06-28"
 current_main_commit: "40de767476d70cadfd1292c916844c2f31b6f185"
 repository_status:
@@ -10,18 +10,18 @@ repository_status:
   runtime_database: "Postgres"
   creator_metadata: "API to Postgres"
   creator_assets: "API to R2"
-project_instructions_version: "2026.06.28.011"
-repository_structure_version: "2026.06.28.011"
-canonical_layout_version: "2026.06.28.011"
+project_instructions_version: "2026.06.28.012"
+repository_structure_version: "2026.06.28.012"
+canonical_layout_version: "2026.06.28.012"
 active_teams:
   - "Owner"
   - "Alfa"
   - "Bravo"
   - "Charlie"
   - "Delta"
   - "Golf"
-latest_owner_pr: "PR_26180_OWNER_011-move-tests-and-validation"
-latest_structure_pr: "PR_26180_OWNER_011-move-tests-and-validation"
+latest_owner_pr: "PR_26180_OWNER_012-update-ci-and-scripts"
+latest_structure_pr: "PR_26180_OWNER_012-update-ci-and-scripts"
 valid_top_level_folders:
   - "api/"
   - "deploy/"

dev/build/ProjectInstructions/backlog/BACKLOG_MASTER.md

@@ -39,9 +39,9 @@ The backlog is the authoritative source for determining the next logical PRs.
 - Team: Owner
 - Product Area: Repository Architecture Simplification
 - Status: Active
-- Percent Complete: 60%
-- Active PR: PR_26180_OWNER_011-move-tests-and-validation
-- Next Milestone: Update CI, package scripts, validation scripts, and developer utilities for the new layout
+- Percent Complete: 70%
+- Active PR: PR_26180_OWNER_012-update-ci-and-scripts
+- Next Milestone: Remove or retire obsolete legacy paths after all references are updated
 - Source / Reference: `dev/build/ProjectInstructions/repository/repository_layout_architecture_plan.md`; `dev/build/ProjectInstructions/repository/www_migration_map.md`
 
 ## Game Journey MVP

dev/build/ProjectInstructions/repository/repository_layout_architecture_plan.md

@@ -32,6 +32,8 @@ No browser, API, server, test, script, or runtime files move in the scaffold or
 
 `PR_26180_OWNER_011-move-tests-and-validation` finalizes moved test and validation path assumptions for the `www/`, `api/`, and `dev/local-runtime/` layout while keeping product behavior unchanged.
 
+`PR_26180_OWNER_012-update-ci-and-scripts` updates CI, package scripts, and developer utilities for the `www/`, `api/`, and `dev/` layout while preserving the public developer command surface.
+
 ## Proposed Future Layout
 
 ```text

dev/reports/PR_26180_OWNER_012-update-ci-and-scripts_branch-validation.md

@@ -0,0 +1,22 @@
+# PR_26180_OWNER_012 Branch Validation
+
+## Result
+
+PASS
+
+## Details
+
+- Current branch: `PR_26180_OWNER_012-update-ci-and-scripts`
+- Expected branch: `PR_26180_OWNER_012-update-ci-and-scripts`
+- Base branch: `PR_26180_OWNER_011-move-tests-and-validation`
+- PR model: Owner stacked PR
+- Previous dependency: `PR_26180_OWNER_011-move-tests-and-validation`
+- Worktree before report generation: contained only scoped PR012 changes
+
+## Hard Stop Review
+
+- Wrong branch: PASS
+- Dirty unrelated worktree: PASS
+- Missing Project Instructions: PASS
+- Missing branching policy: PASS
+- Runtime/product behavior change required: PASS

dev/reports/PR_26180_OWNER_012-update-ci-and-scripts_manual-validation-notes.md

@@ -0,0 +1,17 @@
+# PR_26180_OWNER_012 Manual Validation Notes
+
+## Manual Review
+
+- Confirmed `package.json` still exposes:
+  - `npm run dev:bootstrap`
+  - `npm run dev:api`
+  - `npm run dev:web`
+  - `npm run dev:local-api`
+- Confirmed GitHub Actions platform validation now calls a package script instead of hardcoding the runner path.
+- Confirmed developer scripts use current `www/games/` and `www/toolbox/` assumptions where they route or report moved browser-served paths.
+- Confirmed no `www/` or `api/` files were moved.
+- Confirmed no production page, API route, database, or product runtime behavior was modified.
+
+## Notes For Reviewer
+
+This PR is infrastructure-path maintenance for the layout migration stack. It should be reviewed after PR011 and before the legacy-layout retirement PR.

dev/reports/PR_26180_OWNER_012-update-ci-and-scripts_report.md

@@ -0,0 +1,35 @@
+# PR_26180_OWNER_012-update-ci-and-scripts Report
+
+## Executive Summary
+
+PR_26180_OWNER_012 updates CI, package scripts, and developer utilities for the current `www/`, `api/`, and `dev/` repository layout.
+
+This PR is stacked on `PR_26180_OWNER_011-move-tests-and-validation`.
+
+## Scope Decision
+
+- Scope: CI, package scripts, and developer utilities only.
+- No `www/` files moved.
+- No `api/` files moved.
+- No runtime product behavior changed.
+- No production UI files changed.
+
+## Changes
+
+- Added `npm run validate:platform` as a package script for the platform validation suite.
+- Updated the GitHub platform validation workflow to call the package script.
+- Updated Node test runner absolute import aliases so `/assets/` and `/toolbox/` resolve through `www/` while `/src/` remains rooted at `src/`.
+- Updated developer validation scripts to recognize `www/games/` and `www/toolbox/` paths.
+- Updated tool registry validation messages to report current `www/toolbox/` locations.
+- Updated Project Instructions version/status and repository architecture backlog status for PR_26180_OWNER_012.
+
+## Dependency Order
+
+- Previous PR: `PR_26180_OWNER_011-move-tests-and-validation`
+- Current PR: `PR_26180_OWNER_012-update-ci-and-scripts`
+- Next PR: `PR_26180_OWNER_013-remove-legacy-layout`
+- Merge order: PR011, then PR012, then PR013.
+
+## Owner Recommendation
+
+Ready for review after validation passes and the draft PR is opened against `PR_26180_OWNER_011-move-tests-and-validation`.

dev/reports/PR_26180_OWNER_012-update-ci-and-scripts_requirement-checklist.md

@@ -0,0 +1,16 @@
+# PR_26180_OWNER_012 Requirement Checklist
+
+| Requirement | Status | Notes |
+| --- | --- | --- |
+| Update CI/path references for `www/`, `api/`, `dev/` | PASS | Platform workflow now uses `npm run validate:platform`; developer scripts recognize `www/` paths. |
+| Update package scripts only where needed | PASS | Added `validate:platform`; preserved existing command surface. |
+| Preserve `npm run dev:bootstrap` | PASS | Script remains present. |
+| Preserve `npm run dev:api` | PASS | Script remains present. |
+| Preserve `npm run dev:web` | PASS | Script remains present. |
+| Preserve `npm run dev:local-api` | PASS | Legacy alias remains present. |
+| Update developer scripts after moved paths | PASS | Node test runners, Playwright location audit, targeted lane routing, duplicate audit, and tool registry validator updated. |
+| Do not move `www` files | PASS | No `www/` files moved. |
+| Do not move `api` files | PASS | No `api/` files moved. |
+| Do not change product behavior | PASS | Changes are CI/script/path-governance only. |
+| Produce reports under `dev/reports/` | PASS | Required reports created. |
+| Produce ZIP under `dev/workspace/zips/` | PASS | ZIP created during closeout. |