Move dev local runtime entrypoints

Author: ToolboxAid

dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md

@@ -117,7 +117,7 @@ Rules:
 
 ## Current Version/Date
 
-- Project Instructions Version: 2026.06.28.009
+- Project Instructions Version: 2026.06.28.010
 - 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.009
+Current Project Instructions Version: 2026.06.28.010
 
 Last Updated: 2026-06-28
 
@@ -16,7 +16,8 @@ Last Updated: 2026-06-28
 - Added `www/` migration map for safe browser-served application movement planning.
 - Added local route-root compatibility toggle documentation for future `www/` activation.
 - Moved browser-served application files under `www/` and made local static serving prefer `www/` by default.
-- Moved server/API application runtime under `api/`; browser API clients remain outside `api/` and developer-only bootstrap remains in `dev/` until the local-runtime migration PR.
+- 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.
 - 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.009"
+project_state_version: "2026.06.28.010"
 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.009"
-repository_structure_version: "2026.06.28.009"
-canonical_layout_version: "2026.06.28.009"
+project_instructions_version: "2026.06.28.010"
+repository_structure_version: "2026.06.28.010"
+canonical_layout_version: "2026.06.28.010"
 active_teams:
   - "Owner"
   - "Alfa"
   - "Bravo"
   - "Charlie"
   - "Delta"
   - "Golf"
-latest_owner_pr: "PR_26180_OWNER_009-move-api-application"
-latest_structure_pr: "PR_26180_OWNER_009-move-api-application"
+latest_owner_pr: "PR_26180_OWNER_010-move-dev-local-runtime"
+latest_structure_pr: "PR_26180_OWNER_010-move-dev-local-runtime"
 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: 40%
-- Active PR: PR_26180_OWNER_009-move-api-application
-- Next Milestone: Move developer-only local runtime into `dev/local-runtime/`
+- Percent Complete: 50%
+- Active PR: PR_26180_OWNER_010-move-dev-local-runtime
+- Next Milestone: Move tests and validation path references for the new layout
 - Source / Reference: `dev/build/ProjectInstructions/repository/repository_layout_architecture_plan.md`; `dev/build/ProjectInstructions/repository/www_migration_map.md`
 
 ## Game Journey MVP
@@ -214,8 +214,8 @@ The backlog is the authoritative source for determining the next logical PRs.
   - `npm run dev:local-api` remains as the legacy API alias.
   - `npm run dev:api` supports API-only startup.
   - `npm run dev:web` supports web-only startup.
-  - `dev/bootstrap/start-dev.mjs` owns bootstrap orchestration.
-  - `dev/bootstrap/team-port-config.mjs` owns team port resolution.
+  - `dev/local-runtime/start-dev.mjs` owns bootstrap orchestration.
+  - `dev/local-runtime/team-port-config.mjs` owns team port resolution.
   - Team-aware `--team` runtime support is implemented.
   - Bootstrap orchestration, browser launch reporting, and port resolution are implemented.
   - Verified command: `npm run dev:bootstrap -- --team bravo`.

dev/build/ProjectInstructions/repository/canonical_repository_structure.md

@@ -52,7 +52,7 @@ Dev workspace ownership:
 - dev/archive/ owns historical reference material only.
 - dev/build/ owns active Project Instructions, architecture, database DDL/DML/seed docs, standards, backlog, PR planning, and governance.
 - dev/config/ owns development-only runner and tooling configuration.
-- dev/local-runtime/ owns developer-only local runtime bootstrap, team port resolution, local diagnostics, and browser launch orchestration after the migration step that moves those files.
+- dev/local-runtime/ owns developer-only local runtime bootstrap, team port resolution, local diagnostics, and browser launch orchestration.
 - dev/reports/ owns authoritative Codex reports for the repository. Reports committed to `main` are the official record.
 - dev/scripts/ owns development-only scripts and runners.
 - dev/templates/ owns reusable development templates.

dev/build/ProjectInstructions/repository/repository_layout_architecture_plan.md

@@ -26,7 +26,9 @@ No browser, API, server, test, script, or runtime files move in the scaffold or
 
 `PR_26180_OWNER_008-move-www-application` moved browser-served application files under `www/` and made local static serving prefer `www/` while preserving public URLs.
 
-`PR_26180_OWNER_009-move-api-application` moves server/API application runtime under `api/` while preserving `/api/*` route behavior. Browser API client modules remain outside `api/`, and developer-only local startup orchestration remains under `dev/` until the local-runtime migration PR.
+`PR_26180_OWNER_009-move-api-application` moves server/API application runtime under `api/` while preserving `/api/*` route behavior. Browser API client modules remain outside `api/`.
+
+`PR_26180_OWNER_010-move-dev-local-runtime` moves developer-only local runtime/bootstrap entrypoints under `dev/local-runtime/` while preserving `npm run dev:bootstrap`, `npm run dev:api`, `npm run dev:web`, and `npm run dev:local-api`.
 
 ## Proposed Future Layout
 
@@ -95,7 +97,7 @@ Local development may use the team-aware developer bootstrap and local runtime s
 Developer command -> dev bootstrap -> local www server + local api server -> Postgres/R2 or approved local provider
 ```
 
-Current local bootstrap commands remain unchanged by this plan. This PR does not modify `package.json` commands.
+Current local bootstrap command names remain stable. `PR_26180_OWNER_010-move-dev-local-runtime` updates the command targets to `dev/local-runtime/` without changing the user-facing command names.
 
 The local developer workflow must continue to prove the same browser/API/database contract that deployed environments use.
 

dev/build/ProjectInstructions/repository/www_migration_map.md

@@ -111,7 +111,7 @@ Three active server/helper surfaces currently resolve static browser paths throu
 
 | File | Current behavior |
 | --- | --- |
-| `dev/scripts/start-dev.mjs` | Team-aware bootstrap static server resolves requests with `resolveStaticRouteTarget()`, preferring `www/` while preserving public route URLs and compatibility routes. |
+| `dev/local-runtime/start-dev.mjs` | Team-aware bootstrap static server resolves requests with `resolveStaticRouteTarget()`, preferring `www/` while preserving public route URLs and compatibility routes. |
 | `api/server/local-api-server.mjs` | Legacy local API alias serves API routes and falls back to `resolveStaticRouteTarget()`, preferring `www/` while preserving public route URLs and compatibility routes. |
 | `dev/tests/helpers/playwrightRepoServer.mjs` | Playwright test server mirrors the shared static route resolver and compatibility routes. |
 
@@ -151,7 +151,6 @@ The `www/` move PR updated test helpers and route expectations for the filesyste
 
 ### Defer
 
-- Moving developer bootstrap into `dev/local-runtime/`.
 - Removing legacy root compatibility routes.
 - Changing package commands.
 - Renaming public URLs.