From e5a99c3d78ca5b9cd008d236e98d3d96b4b09936 Mon Sep 17 00:00:00 2001 From: "Mr. Q" <97194984+ToolboxAid@users.noreply.github.com> Date: Sun, 21 Jun 2026 13:30:20 -0400 Subject: [PATCH] PR_26172_MASTER_003 backlog master governance --- .../addendums/backlog_governance.md | 38 +++++ .../backlog/BACKLOG_MASTER.md | 143 +++++++++++++++++ ...rnance-instruction-compliance-checklist.md | 12 ++ ...ster-governance-manual-validation-notes.md | 11 ++ ...72_MASTER_003-backlog-master-governance.md | 25 +++ .../dev/reports/codex_changed_files.txt | 9 +- docs_build/dev/reports/codex_review.diff | 146 ++---------------- 7 files changed, 246 insertions(+), 138 deletions(-) create mode 100644 docs_build/dev/ProjectInstructions/addendums/backlog_governance.md create mode 100644 docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md create mode 100644 docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-instruction-compliance-checklist.md create mode 100644 docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-manual-validation-notes.md create mode 100644 docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance.md diff --git a/docs_build/dev/ProjectInstructions/addendums/backlog_governance.md b/docs_build/dev/ProjectInstructions/addendums/backlog_governance.md new file mode 100644 index 000000000..a41e1af6b --- /dev/null +++ b/docs_build/dev/ProjectInstructions/addendums/backlog_governance.md @@ -0,0 +1,38 @@ +# Backlog Governance + +## Purpose + +`BACKLOG_MASTER.md` is the master planning record for Project Instructions operating-system work and Game Journey MVP tool status. + +## Status Legend + +- `[ ]` Planned +- `[?]` Wireframe +- `[.]` Building +- `[x]` Complete +- `[!]` Blocked +- `[-]` Deprecated + +## Immutable Item Text + +Backlog item text is immutable after creation. + +Allowed: +- add new backlog items +- change status +- add notes +- add references + +Prohibited without owner approval: +- delete backlog items +- rename backlog items +- rewrite backlog item text +- reclassify backlog items + +## Notes And References + +Notes and references must be appended under the relevant item or phase. Do not hide prior decision context. + +## Folded Scope + +`PR_26172_MASTER_006-game-journey-mvp-backlog` was folded into `PR_26172_MASTER_003-backlog-master-governance` by owner decision. There is no separate PR006 in this queue. diff --git a/docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md b/docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md new file mode 100644 index 000000000..1e9b17a2e --- /dev/null +++ b/docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md @@ -0,0 +1,143 @@ +# Backlog Master + +## Status Legend + +- `[ ]` Planned +- `[?]` Wireframe +- `[.]` Building +- `[x]` Complete +- `[!]` Blocked +- `[-]` Deprecated + +## Governance + +Backlog item text is immutable after creation. + +Allowed changes: +- add new items +- change status +- add notes +- add references + +Prohibited without owner approval: +- delete items +- rename items +- rewrite item text +- reclassify items + +## Game Journey MVP Backlog + +Source reference: `toolbox/tools-page-accordions.js` Game Journey Build Path grouping and `toolbox/toolRegistry.js` display labels. + +### Idea + +0% Complete — Dream, brainstorm, and explore + +- [ ] ALPHA - Idea Board +- [ ] ALPHA - Creator Learning + +### Design + +0% Complete — Shape your game's story and systems + +- [ ] ALPHA - AI Command Center +- [ ] ALPHA - Game Configuration +- [ ] ALPHA - Game Crew +- [ ] ALPHA - Game Design +- [ ] ALPHA - Game Hub +- [ ] ALPHA - Tags +- [ ] ALPHA - Game Crew (users) +- [ ] BETA - Message Studio + +### Graphics + +0% Complete — Create the visual look of your game + +- [ ] BETA - Animations +- [ ] BETA - Assets +- [ ] BETA - Colors +- [ ] BETA - Particles +- [ ] BETA - Sprites +- [ ] BETA - Videos + +### Audio + +0% Complete — Build sounds, music, and voices + +- [ ] BETA - Audio +- [ ] BETA - Audio Effects +- [ ] BETA - MIDI +- [ ] BETA - Music +- [ ] BETA - Voice Capture +- [ ] BETA - Text To Speech +- [ ] BETA - Voices + +### Objects + +0% Complete — Create the things players interact with + +- [ ] ALPHA - Characters +- [ ] ALPHA - Objects + +### Worlds + +0% Complete — Build levels, maps, and places to explore + +- [ ] ALPHA - Worlds + +### Interface + +0% Complete — Design menus, HUDs, and player screens + +- [ ] ALPHA - Fonts +- [ ] ALPHA - Languages + +### Controls + +0% Complete — Define how players interact with your game + +- [ ] ALPHA - Controls +- [ ] ALPHA - Hitboxes +- [ ] ALPHA - Input Mapping V2 + +### Rules + +0% Complete — Create gameplay behavior and events + +- [ ] ALPHA - Custom Extensions +- [ ] ALPHA - Events + +### Progression + +0% Complete — Build rewards, unlocks, and advancement + +- [ ] ALPHA - Achievements +- [ ] ALPHA - Game Journey +- [ ] ALPHA - Saved Data + +### Play Test + +0% Complete — Test, debug, and improve your game + +- [ ] ALPHA - Debug +- [ ] ALPHA - Game Testing +- [ ] ALPHA - Performance + +### Publish + +0% Complete — Prepare and release your game + +- [ ] BETA - Build Game +- [ ] BETA - Environments +- [ ] BETA - Game Migration +- [ ] BETA - Platform Settings +- [ ] BETA - Publish + +### Share + +0% Complete — Grow your audience and community + +- [ ] BETA - Cloud +- [ ] BETA - Community +- [ ] BETA - Marketplace +- [ ] BETA - Ratings diff --git a/docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-instruction-compliance-checklist.md b/docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-instruction-compliance-checklist.md new file mode 100644 index 000000000..abe6d51b3 --- /dev/null +++ b/docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-instruction-compliance-checklist.md @@ -0,0 +1,12 @@ +# PR_26172_MASTER_003 Instruction Compliance Checklist + +- PASS: Read `docs_build/dev/PROJECT_INSTRUCTIONS.md`. +- PASS: Read `docs_build/dev/PROJECT_MULTI_PC.txt`. +- PASS: Explicit MASTER override accepted Team MASTER for this operating-system bootstrap. +- PASS: Owner decision folded PR006 content into PR003. +- PASS: Branch name mirrors PR ownership: `pr/26172-MASTER-003-backlog-master-governance`. +- PASS: Implementation path is `docs_build/dev/ProjectInstructions/`. +- PASS: Existing Project Instructions were preserved. +- PASS: No direct commit to `main`. +- PASS: Required review artifacts are produced. +- PASS: Required ZIP path is `tmp/PR_26172_MASTER_003-backlog-master-governance_delta.zip`. diff --git a/docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-manual-validation-notes.md b/docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-manual-validation-notes.md new file mode 100644 index 000000000..f6789c77e --- /dev/null +++ b/docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-manual-validation-notes.md @@ -0,0 +1,11 @@ +# PR_26172_MASTER_003 Manual Validation Notes + +- Confirmed branch was created from latest `main`. +- Confirmed only new files were added. +- Confirmed existing Project Instructions files were not deleted or rewritten. +- Confirmed status legend includes Planned, Wireframe, Building, Complete, Blocked, and Deprecated. +- Confirmed each requested Game Journey phase is present. +- Confirmed each phase uses `0% Complete — ` format. +- Confirmed phase tools come from the active Build Path grouping and tool registry labels. +- Did not run Playwright because this is documentation-only. +- Did not run samples. diff --git a/docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance.md b/docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance.md new file mode 100644 index 000000000..c3c37aa41 --- /dev/null +++ b/docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance.md @@ -0,0 +1,25 @@ +# PR_26172_MASTER_003-backlog-master-governance + +## Scope + +Create backlog master governance and fold in the Game Journey MVP backlog population that was originally scoped as PR006. + +## Changes + +- Added `backlog/BACKLOG_MASTER.md`. +- Added `addendums/backlog_governance.md`. +- Added the requested status legend. +- Added immutable backlog text rules. +- Populated Game Journey MVP phases with actual tools from the active Build Path grouping. +- Documented that PR006 was folded into PR003 by owner decision. + +## Validation + +- `git diff --check` +- Markdown/text review for status legend, immutability rules, phase format, and phase tool entries. +- Playwright skipped: no runtime UI files changed. +- Samples skipped: not requested. + +## ZIP + +`tmp/PR_26172_MASTER_003-backlog-master-governance_delta.zip` diff --git a/docs_build/dev/reports/codex_changed_files.txt b/docs_build/dev/reports/codex_changed_files.txt index 5ebd4f6a7..3a2b1772c 100644 --- a/docs_build/dev/reports/codex_changed_files.txt +++ b/docs_build/dev/reports/codex_changed_files.txt @@ -1,6 +1,7 @@ -docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md -docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md -docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md +docs_build/dev/ProjectInstructions/addendums/backlog_governance.md +docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md docs_build/dev/reports/codex_changed_files.txt docs_build/dev/reports/codex_review.diff -src/dev-runtime/persistence/mock-db-store.js +docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance.md +docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-instruction-compliance-checklist.md +docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-manual-validation-notes.md diff --git a/docs_build/dev/reports/codex_review.diff b/docs_build/dev/reports/codex_review.diff index 88d1a78eb..2f090f890 100644 --- a/docs_build/dev/reports/codex_review.diff +++ b/docs_build/dev/reports/codex_review.diff @@ -1,138 +1,16 @@ -diff --git a/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md -new file mode 100644 -index 000000000..a07705200 ---- /dev/null -+++ b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md -@@ -0,0 +1,28 @@ -+# PR_26171_GAMMA_027 Instruction Compliance Checklist -+ -+## Start Gate -+ -+- PASS: Read `docs_build/dev/PROJECT_INSTRUCTIONS.md`. -+- PASS: Read `docs_build/dev/PROJECT_MULTI_PC.txt`. -+- PASS: PR name includes TEAM token `GAMMA`. -+- PASS: Branch name mirrors TEAM token: `pr/26171-GAMMA-027-sqlite-doc-reference-cleanup`. -+- PASS: Scope is diagnostics/cleanup and belongs to Team Gamma. -+- PASS: Started from fresh `main` after PR 026 merged. -+- PASS: Repository was clean before branch creation. -+ -+## Scope Guard -+ -+- PASS: One PR purpose only. -+- PASS: Cleaned active docs/seed wording only. -+- PASS: Preserved `PROJECT_INSTRUCTIONS.md` SQLite deprecation rules. -+- PASS: Did not rewrite historical PR/report archives. -+- PASS: Did not run samples. -+ -+## Completion Gate -+ -+- PASS: PR-specific report exists. -+- PASS: Manual validation notes exist. -+- PASS: Instruction compliance checklist exists. -+- PASS: `docs_build/dev/reports/codex_review.diff` exists. -+- PASS: `docs_build/dev/reports/codex_changed_files.txt` exists. -+- PASS: Repo-structured ZIP path is documented: `tmp/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup_delta.zip`. -diff --git a/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md -new file mode 100644 -index 000000000..415d83d27 ---- /dev/null -+++ b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md -@@ -0,0 +1,17 @@ -+# PR_26171_GAMMA_027 Manual Validation Notes -+ -+Manual validation focused on active docs/seed wording. -+ -+## Notes -+ -+- Confirmed PR 027 branch was created from fresh `main` after PR 026 merged. -+- Confirmed `PROJECT_INSTRUCTIONS.md` deprecation rules were preserved. -+- Confirmed historical report and PR docs were not modified. -+- Confirmed the only active seed wording change was the Local DB session-mode description. -+- Confirmed remaining SQLite references in active paths are governance, validation guards, negative tests, or legacy data-preservation guard text. -+ -+## Skipped -+ -+- Playwright was skipped because no UI behavior changed. -+- Samples were skipped by request. -+- Broad tests were skipped because this is a wording-only cleanup. -diff --git a/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md -new file mode 100644 -index 000000000..ecb1a233d ---- /dev/null -+++ b/docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md -@@ -0,0 +1,43 @@ -+# PR_26171_GAMMA_027-sqlite-doc-reference-cleanup -+ -+TEAM ownership: GAMMA. -+ -+## Scope -+ -+Clean active docs/seed wording that implied SQLite is still an active persistence target. -+ -+## Changes -+ -+- Updated `src/dev-runtime/persistence/mock-db-store.js` session-mode description from SQLite-backed wording to neutral Local DB adapter wording. -+- Preserved `PROJECT_INSTRUCTIONS.md` SQLite deprecation rules. -+- Did not rewrite historical PR/report archives. -+- Did not remove governance, validation guard, negative test, or legacy data-preservation references. -+ -+## Validation -+ -+Passed: -+- `git diff --check` -+- `node --check src/dev-runtime/persistence/mock-db-store.js` -+- Targeted text check confirmed no active docs/seed wording still says `SQLite-backed`, `SQLite persistence`, `SQLite service`, or `backed by server SQLite storage`. -+- Scoped active-source search confirmed remaining non-archive SQLite references are limited to: -+ - governance rules in `PROJECT_INSTRUCTIONS.md` -+ - validation guard patterns in `scripts/validate-browser-env-agnostic.mjs` -+ - negative test assertions that SQLite is not exposed -+ - Game Journey legacy SQLite data-preservation guard -+ -+Skipped: -+- Playwright: no UI/runtime behavior changed. -+- Samples: skipped by request. -+- Historical reports and PR docs: explicitly out of scope. -+ -+## Reports -+ -+- `docs_build/dev/reports/codex_review.diff` -+- `docs_build/dev/reports/codex_changed_files.txt` -+- `docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md` -+- `docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md` -+- `docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md` -+ -+## ZIP -+ -+`tmp/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup_delta.zip` -diff --git a/docs_build/dev/reports/codex_changed_files.txt b/docs_build/dev/reports/codex_changed_files.txt -index 4e23ae82e..5ebd4f6a7 100644 +diff --git a/docs_build/dev/reports/codex_changed_files.txt b/docs_build/dev/reports/codex_changed_files.txt +index 5ebd4f6a7..3a2b1772c 100644 --- a/docs_build/dev/reports/codex_changed_files.txt +++ b/docs_build/dev/reports/codex_changed_files.txt -@@ -1,10 +1,6 @@ --docs_build/dev/reports/PR_26171_GAMMA_026-sqlite-test-reference-cleanup-instruction-compliance-checklist.md --docs_build/dev/reports/PR_26171_GAMMA_026-sqlite-test-reference-cleanup-manual-validation-notes.md --docs_build/dev/reports/PR_26171_GAMMA_026-sqlite-test-reference-cleanup.md -+docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md -+docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md -+docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md +@@ -1,6 +1,7 @@ +-docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-instruction-compliance-checklist.md +-docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup-manual-validation-notes.md +-docs_build/dev/reports/PR_26171_GAMMA_027-sqlite-doc-reference-cleanup.md ++docs_build/dev/ProjectInstructions/addendums/backlog_governance.md ++docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md docs_build/dev/reports/codex_changed_files.txt docs_build/dev/reports/codex_review.diff --tests/dev-runtime/DbSeedIntegrity.test.mjs --tests/playwright/tools/AdminDbViewer.spec.mjs --tests/playwright/tools/BrowserApiUrlConfig.spec.mjs --tests/playwright/tools/GameJourneyTool.spec.mjs --tests/playwright/tools/LoginSessionMode.spec.mjs -+src/dev-runtime/persistence/mock-db-store.js -diff --git a/src/dev-runtime/persistence/mock-db-store.js b/src/dev-runtime/persistence/mock-db-store.js -index 2305910bc..c98c915b5 100644 ---- a/src/dev-runtime/persistence/mock-db-store.js -+++ b/src/dev-runtime/persistence/mock-db-store.js -@@ -23,7 +23,7 @@ export const MOCK_DB_SESSION_MODES = Object.freeze([ - adapterId: "local-db", - adapterName: "LocalDbAdapter", - configured: true, -- description: "Uses LocalDbAdapter backed by server SQLite storage.", -+ description: "Uses the Local DB adapter behind the server API boundary.", - environment: "Local DB", - id: "local-db", - label: "Local DB", +-src/dev-runtime/persistence/mock-db-store.js ++docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance.md ++docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-instruction-compliance-checklist.md ++docs_build/dev/reports/PR_26172_MASTER_003-backlog-master-governance-manual-validation-notes.md