PR_26179_OWNER_003-dev-root-shell

dev/README.md

@@ -0,0 +1,16 @@
+# Development Workspace
+
+This folder is the destination shell for non-deployable development workspace material.
+
+## Ownership
+
+- Root remains reserved for production/public product sections and standard repository configuration.
+- `src/` remains deployable application code.
+- `dev/` contains non-deployable build, test, bootstrap, governance, report, and local workspace material.
+- `docs/` stays at root for production Docs & Help.
+- `games/` stays at root for public game discovery.
+- `toolbox/` stays at root for the Creator toolbox/workspace.
+
+## Data Boundary
+
+Creator data must not write to repository folders. Creator metadata must flow through the API to Postgres, and Creator assets must flow through the API to Cloudflare R2.

docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md

@@ -18,6 +18,7 @@ The Project Instructions operating system provides additive governance for:
 - team assignments
 - multi-team branch and scope rules
 - documentation ownership
+- repository directory ownership
 - Build Path status synchronization
 - tile overlay status behavior
 - deprecation workflow
@@ -64,6 +65,7 @@ When active guidance overlaps, use these canonical owner documents:
 
 - Workflow and Product Owner testable completion: `docs_build/dev/ProjectInstructions/addendums/pr_workflow.md`
 - START / WORK / END lifecycle, branch gates, mandatory hard stops, and EOD main lock: `docs_build/dev/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md`
+- Repository directory ownership and restructure boundaries: `docs_build/dev/ProjectInstructions/addendums/repository_directory_standard.md`
 - Page-level Playwright organization and completion coverage: `docs_build/dev/ProjectInstructions/addendums/test_structure_standardization.md`
 - API/environment model and `Browser -> API -> Database` rule: `docs_build/dev/ProjectInstructions/addendums/environment_governance_model.md`
 - Environment variable, URL, R2 prefix, and feature flag configuration: `docs_build/dev/ProjectInstructions/addendums/environment_configuration_standards.md`

docs_build/dev/ProjectInstructions/README.txt

@@ -47,6 +47,7 @@ READ THIS FIRST
 
 Addendum index:
 - Documentation Ownership: docs_build/dev/ProjectInstructions/addendums/documentation_ownership.md
+- Repository Directory Standard: docs_build/dev/ProjectInstructions/addendums/repository_directory_standard.md
 - Team Backlog, SOD, And EOD Standard: docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md
 - Single Source and EOD Main Lock: docs_build/dev/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md
 - Canonical Repository Structure: docs_build/dev/ProjectInstructions/addendums/canonical_repository_structure.md

docs_build/dev/ProjectInstructions/addendums/repository_directory_standard.md

@@ -0,0 +1,37 @@
+# Repository Directory Standard
+
+Status: Approved
+Owner: OWNER
+
+## Purpose
+
+Define the target repository directory ownership model before the development workspace restructure chain begins.
+
+This document is governance only. It does not move runtime, UI, API, tests, or production files by itself.
+
+## Directory Ownership
+
+- Repository root contains production/public product sections and standard repository configuration.
+- `src/` contains deployable application code.
+- `dev/` contains non-deployable build, test, bootstrap, governance, report, and local workspace items.
+- `docs/` remains at root because it is production Docs & Help.
+- `games/` remains at root because it is public game discovery.
+- `toolbox/` remains at root because it is the Creator toolbox/workspace.
+
+## Creator Data Boundary
+
+- Creator data must not write to repository folders.
+- Creator metadata must go through the API to Postgres.
+- Creator assets must go through the API to Cloudflare R2.
+- Repo folders may contain fixtures, templates, governance, and development artifacts only when they are not Creator-owned production data.
+
+## Environment And Runtime Rules
+
+- Postgres is the only active runtime database.
+- The same application code path must run across LOCAL, DEV, IST, UAT, and PROD.
+- Environment differences must come from `.env` values or environment-managed secrets.
+- Runtime source filenames must not use team names.
+
+## PR Chain Boundary
+
+The development workspace restructure must proceed through sequential scoped PRs. A PR may only move or update the paths named in its purpose.

docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell.md

@@ -0,0 +1,29 @@
+# PR_26179_OWNER_003-dev-root-shell
+
+Date: 2026-06-27 13:48:43
+Team: OWNER
+Branch: PR_26179_OWNER_003-dev-root-shell
+Base HEAD: e9edd3f2b0519256eefcb2f125abd7ab6f76f556
+Status: PASS
+
+## Summary
+
+Created the `dev/` destination shell and added active governance for repository directory ownership before any broad moves.
+
+## Changed Files
+
+- dev/README.md
+- docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md
+- docs_build/dev/ProjectInstructions/README.txt
+- docs_build/dev/ProjectInstructions/addendums/repository_directory_standard.md
+
+## Scope
+
+- Documentation/governance only.
+- No broad moves.
+- No runtime, UI, API, test, production docs, games, toolbox, account, admin, legal, assets, or src files changed.
+- Playwright not impacted.
+
+## ZIP
+
+- `tmp/PR_26179_OWNER_003-dev-root-shell_delta.zip`

docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_branch-validation.md

@@ -0,0 +1,8 @@
+# Branch Validation - PR_26179_OWNER_003-dev-root-shell
+
+Status: PASS
+
+- PASS: Started from clean synchronized `main`.
+- PASS: Current branch is `PR_26179_OWNER_003-dev-root-shell`.
+- PASS: Branch is not `main` for commit/push.
+- PASS: Sequential stack begins with this PR branch.

docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_manual-validation-notes.md

@@ -0,0 +1,8 @@
+# Manual Validation Notes - PR_26179_OWNER_003-dev-root-shell
+
+Status: PASS
+
+- Confirmed this PR only creates the `dev/` shell and active directory governance note.
+- Confirmed no broad directory moves were performed.
+- Confirmed no Creator-writeable repo folder was introduced.
+- Confirmed production/public root sections remain unmoved.

docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_requirement-checklist.md

@@ -0,0 +1,13 @@
+# Requirement Checklist - PR_26179_OWNER_003-dev-root-shell
+
+Status: PASS
+
+- PASS: Create dev/ destination shell.
+- PASS: Define root as production/public product sections.
+- PASS: Define src as deployable application code.
+- PASS: Define dev as non-deployable workspace.
+- PASS: Define docs as production Docs & Help.
+- PASS: Define games as public game discovery.
+- PASS: Define no Creator writes to repo folders.
+- PASS: No broad moves in this PR.
+- PASS: No runtime/UI/API/test files changed.

docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_validation-lane.md

@@ -0,0 +1,18 @@
+# Validation Lane Report - PR_26179_OWNER_003-dev-root-shell
+
+Status: PASS
+
+## Commands
+
+- Project Instructions read from `docs_build/dev/ProjectInstructions/`.
+- `git branch --show-current`
+- `git status --short --branch --untracked-files=all`
+- Changed-path scope scan.
+- `git diff --check`.
+
+## Results
+
+- Current branch: `PR_26179_OWNER_003-dev-root-shell`
+- Changed paths: 4
+- Out-of-scope changed paths: 0
+- Playwright: not run; no runtime/UI/API/test files changed.

docs_build/dev/reports/codex_changed_files.txt

@@ -1,12 +1,11 @@
-A	docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_branch-validation.md
-A	docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_manual-validation-notes.md
-A	docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_report.md
-A	docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_requirement-checklist.md
-A	docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_validation-lane.md
-A	docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_validation-report.md
+A	dev/README.md
+M	docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md
+M	docs_build/dev/ProjectInstructions/README.txt
+A	docs_build/dev/ProjectInstructions/addendums/repository_directory_standard.md
+A	docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell.md
+A	docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_branch-validation.md
+A	docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_manual-validation-notes.md
+A	docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_requirement-checklist.md
+A	docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_validation-lane.md
 M	docs_build/dev/reports/codex_changed_files.txt
 M	docs_build/dev/reports/codex_review.diff
-M	src/dev-runtime/server/local-api-router.mjs
-M	src/dev-runtime/toolbox-api/alfa-tool-services.mjs
-A	tests/dev-runtime/TagsApiErrorResponse.test.mjs
-A	tests/dev-runtime/TagsApiService.test.mjs