Skip to content

Commit c21d69b

Browse files
ToolboxAidToolboxAid
committed
Add dev root shell governance
1 parent e9edd3f commit c21d69b

11 files changed

Lines changed: 330 additions & 3292 deletions

‎dev/README.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Development Workspace
2+
3+
This folder is the destination shell for non-deployable development workspace material.
4+
5+
## Ownership
6+
7+
- Root remains reserved for production/public product sections and standard repository configuration.
8+
- `src/` remains deployable application code.
9+
- `dev/` contains non-deployable build, test, bootstrap, governance, report, and local workspace material.
10+
- `docs/` stays at root for production Docs & Help.
11+
- `games/` stays at root for public game discovery.
12+
- `toolbox/` stays at root for the Creator toolbox/workspace.
13+
14+
## Data Boundary
15+
16+
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‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ The Project Instructions operating system provides additive governance for:
1818
- team assignments
1919
- multi-team branch and scope rules
2020
- documentation ownership
21+
- repository directory ownership
2122
- Build Path status synchronization
2223
- tile overlay status behavior
2324
- deprecation workflow
@@ -64,6 +65,7 @@ When active guidance overlaps, use these canonical owner documents:
6465

6566
- Workflow and Product Owner testable completion: `docs_build/dev/ProjectInstructions/addendums/pr_workflow.md`
6667
- 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`
68+
- Repository directory ownership and restructure boundaries: `docs_build/dev/ProjectInstructions/addendums/repository_directory_standard.md`
6769
- Page-level Playwright organization and completion coverage: `docs_build/dev/ProjectInstructions/addendums/test_structure_standardization.md`
6870
- API/environment model and `Browser -> API -> Database` rule: `docs_build/dev/ProjectInstructions/addendums/environment_governance_model.md`
6971
- Environment variable, URL, R2 prefix, and feature flag configuration: `docs_build/dev/ProjectInstructions/addendums/environment_configuration_standards.md`

‎docs_build/dev/ProjectInstructions/README.txt‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,7 @@ READ THIS FIRST
4747

4848
Addendum index:
4949
- Documentation Ownership: docs_build/dev/ProjectInstructions/addendums/documentation_ownership.md
50+
- Repository Directory Standard: docs_build/dev/ProjectInstructions/addendums/repository_directory_standard.md
5051
- Team Backlog, SOD, And EOD Standard: docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md
5152
- Single Source and EOD Main Lock: docs_build/dev/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md
5253
- Canonical Repository Structure: docs_build/dev/ProjectInstructions/addendums/canonical_repository_structure.md

‎docs_build/dev/ProjectInstructions/addendums/repository_directory_standard.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# Repository Directory Standard
2+
3+
Status: Approved
4+
Owner: OWNER
5+
6+
## Purpose
7+
8+
Define the target repository directory ownership model before the development workspace restructure chain begins.
9+
10+
This document is governance only. It does not move runtime, UI, API, tests, or production files by itself.
11+
12+
## Directory Ownership
13+
14+
- Repository root contains production/public product sections and standard repository configuration.
15+
- `src/` contains deployable application code.
16+
- `dev/` contains non-deployable build, test, bootstrap, governance, report, and local workspace items.
17+
- `docs/` remains at root because it is production Docs & Help.
18+
- `games/` remains at root because it is public game discovery.
19+
- `toolbox/` remains at root because it is the Creator toolbox/workspace.
20+
21+
## Creator Data Boundary
22+
23+
- Creator data must not write to repository folders.
24+
- Creator metadata must go through the API to Postgres.
25+
- Creator assets must go through the API to Cloudflare R2.
26+
- Repo folders may contain fixtures, templates, governance, and development artifacts only when they are not Creator-owned production data.
27+
28+
## Environment And Runtime Rules
29+
30+
- Postgres is the only active runtime database.
31+
- The same application code path must run across LOCAL, DEV, IST, UAT, and PROD.
32+
- Environment differences must come from `.env` values or environment-managed secrets.
33+
- Runtime source filenames must not use team names.
34+
35+
## PR Chain Boundary
36+
37+
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‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# PR_26179_OWNER_003-dev-root-shell
2+
3+
Date: 2026-06-27 13:48:43
4+
Team: OWNER
5+
Branch: PR_26179_OWNER_003-dev-root-shell
6+
Base HEAD: e9edd3f2b0519256eefcb2f125abd7ab6f76f556
7+
Status: PASS
8+
9+
## Summary
10+
11+
Created the `dev/` destination shell and added active governance for repository directory ownership before any broad moves.
12+
13+
## Changed Files
14+
15+
- dev/README.md
16+
- docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md
17+
- docs_build/dev/ProjectInstructions/README.txt
18+
- docs_build/dev/ProjectInstructions/addendums/repository_directory_standard.md
19+
20+
## Scope
21+
22+
- Documentation/governance only.
23+
- No broad moves.
24+
- No runtime, UI, API, test, production docs, games, toolbox, account, admin, legal, assets, or src files changed.
25+
- Playwright not impacted.
26+
27+
## ZIP
28+
29+
- `tmp/PR_26179_OWNER_003-dev-root-shell_delta.zip`

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

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Branch Validation - PR_26179_OWNER_003-dev-root-shell
2+
3+
Status: PASS
4+
5+
- PASS: Started from clean synchronized `main`.
6+
- PASS: Current branch is `PR_26179_OWNER_003-dev-root-shell`.
7+
- PASS: Branch is not `main` for commit/push.
8+
- PASS: Sequential stack begins with this PR branch.

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

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Manual Validation Notes - PR_26179_OWNER_003-dev-root-shell
2+
3+
Status: PASS
4+
5+
- Confirmed this PR only creates the `dev/` shell and active directory governance note.
6+
- Confirmed no broad directory moves were performed.
7+
- Confirmed no Creator-writeable repo folder was introduced.
8+
- Confirmed production/public root sections remain unmoved.

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

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Requirement Checklist - PR_26179_OWNER_003-dev-root-shell
2+
3+
Status: PASS
4+
5+
- PASS: Create dev/ destination shell.
6+
- PASS: Define root as production/public product sections.
7+
- PASS: Define src as deployable application code.
8+
- PASS: Define dev as non-deployable workspace.
9+
- PASS: Define docs as production Docs & Help.
10+
- PASS: Define games as public game discovery.
11+
- PASS: Define no Creator writes to repo folders.
12+
- PASS: No broad moves in this PR.
13+
- PASS: No runtime/UI/API/test files changed.

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

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Validation Lane Report - PR_26179_OWNER_003-dev-root-shell
2+
3+
Status: PASS
4+
5+
## Commands
6+
7+
- Project Instructions read from `docs_build/dev/ProjectInstructions/`.
8+
- `git branch --show-current`
9+
- `git status --short --branch --untracked-files=all`
10+
- Changed-path scope scan.
11+
- `git diff --check`.
12+
13+
## Results
14+
15+
- Current branch: `PR_26179_OWNER_003-dev-root-shell`
16+
- Changed paths: 4
17+
- Out-of-scope changed paths: 0
18+
- Playwright: not run; no runtime/UI/API/test files changed.

‎docs_build/dev/reports/codex_changed_files.txt‎

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,11 @@
1-
A docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_branch-validation.md
2-
A docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_manual-validation-notes.md
3-
A docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_report.md
4-
A docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_requirement-checklist.md
5-
A docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_validation-lane.md
6-
A docs_build/dev/reports/PR_26178_ALFA_001-fix-tags-local-api-crash_validation-report.md
1+
A dev/README.md
2+
M docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md
3+
M docs_build/dev/ProjectInstructions/README.txt
4+
A docs_build/dev/ProjectInstructions/addendums/repository_directory_standard.md
5+
A docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell.md
6+
A docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_branch-validation.md
7+
A docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_manual-validation-notes.md
8+
A docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_requirement-checklist.md
9+
A docs_build/dev/reports/PR_26179_OWNER_003-dev-root-shell_validation-lane.md
710
M docs_build/dev/reports/codex_changed_files.txt
811
M docs_build/dev/reports/codex_review.diff
9-
M src/dev-runtime/server/local-api-router.mjs
10-
M src/dev-runtime/toolbox-api/alfa-tool-services.mjs
11-
A tests/dev-runtime/TagsApiErrorResponse.test.mjs
12-
A tests/dev-runtime/TagsApiService.test.mjs

0 commit comments

Comments
 (0)