From 896eecab591ae5a157b31fbd9a6b9db77100cf5c Mon Sep 17 00:00:00 2001 From: Alfa Team Date: Fri, 26 Jun 2026 16:01:02 -0400 Subject: [PATCH 1/2] Clean dev documentation ownership --- .../dev/ProjectInstructions/archive/README.md | 12 + .../archive/history/.gitkeep | 0 .../archive/history/20260621_144555.md | 0 .../archive/history/20260621_153126.md | 0 .../archive/history/20260621_153759.md | 0 .../archive/history/20260621_154153.md | 0 .../archive/history/20260621_154830.md | 0 .../archive/history/20260621_155907.md | 0 .../archive/history/20260621_161414.md | 0 .../archive/history/20260621_161520.md | 0 .../archive/history/20260621_161703.md | 0 .../archive/history/20260621_163009.md | 0 .../archive/history/20260621_231154.md | 0 .../archive/history/20260621_231757.md | 0 .../archive/history/20260621_233733.md | 0 .../archive/history/20260621_235757.md | 0 .../archive/history/20260621_235932.md | 0 .../archive/history/20260622_000449.md | 0 .../archive/history/20260622_002424.md | 0 .../dev/admin-notes/BusinessPlan.txt | 0 .../GFS-AI-Credits-Reseller-Strategy.pdf | Bin ...ond-Screen-Turn-Based-Design-26170-001.pdf | Bin ...ages_Tool_And_Platform_Reference_Rules.pdf | Bin .../GFS_Game_Identity_Strategy.pdf.pdf | Bin .../GFS_Game_Journey_Master_Plan.txt | 0 .../dev/admin-notes/Installs required.txt | 0 .../dev/admin-notes/PS_commands.txt | 0 .../dev/admin-notes/Table layout.txt | 0 .../dev/admin-notes/admin/index.txt | 0 .../dev/admin-notes/colors/colos.txt | 0 .../dev/admin-notes/colors/index.txt | 0 .../admin-notes/deployment-uat-prod/index.txt | 0 .../dev/admin-notes/email/index.txt | 0 .../dev/admin-notes/engine/GameLoop.txt | 0 .../admin-notes/engine/ProjectDifficulty.txt | 0 .../admin-notes/engine/ProjectLifeCycle.txt | 0 .../dev/admin-notes/engine/index.txt | 0 .../dev/admin-notes/fonts/index.txt | 0 .../docs_build}/dev/admin-notes/index.txt | 0 .../dev/admin-notes/notes/index.txt | 0 .../dev/admin-notes/other/index.txt | 0 .../dev/admin-notes/roadmap2MVP.txt | 0 .../docs_build}/dev/admin-notes/sample.txt | 0 .../tools/ObjectConfigurationRules.txt | 0 .../dev/admin-notes/tools/TestDebug.txt | 0 .../dev/admin-notes/tools/Tools.txt | 0 .../dev/admin-notes/tools/achievements.txt | 0 .../dev/admin-notes/tools/edit_input.txt | 0 .../dev/admin-notes/tools/game config.txt | 0 .../dev/admin-notes/tools/game design.txt | 0 .../dev/admin-notes/tools/game publisher.txt | 0 .../dev/admin-notes/tools/index.txt | 0 .../dev/roadmaps/MASTER_ROADMAP_FEATURES.md | 0 .../dev/roadmaps/MASTER_ROADMAP_STYLE.md | 0 .../POST_MIGRATION_PLATFORM_ROADMAP.md | 0 docs_build/dev/PR/README.md | 18 + .../examples/OWNER_007_BUILD_PR.md} | 0 .../examples/OWNER_007_PLAN_PR.md} | 0 docs_build/dev/PR/examples/README.md | 7 + ...n_pr_tool_workspace_manifest_boundaries.md | 0 .../examples}/pr_koti_layout_contract.md | 0 .../pr_tool_fix_asset_browser_1505.md | 0 .../pr_tool_fix_fullscreen_exit_state.md | 0 .../pr_tool_fix_parallax_header_metadata.md | 0 .../examples}/pr_tool_header_singleline.md | 0 .../examples}/pr_tool_interactive_uat.md | 0 .../pr_tool_layout_workflow_baseline.md | 0 .../pr_tool_remove_future_import_hints.md | 0 .../pr_tool_remove_static_header_intro.md | 0 .../examples}/pr_tool_stabilization.md | 0 .../examples}/pr_tool_uat_closeout.md | 0 ...r_tool_uat_fix_fullscreen_header_wiring.md | 0 .../pr_tool_uat_fix_header_asset_browser.md | 0 .../{pr => PR/examples}/pr_tool_uat_fixes.md | 0 docs_build/dev/PR/templates/BUILD_PR.md | 44 + docs_build/dev/PR/templates/PLAN_PR.md | 30 + .../pr_capability_bundle_checklist.md | 0 .../PROJECT_INSTRUCTIONS.md | 20 +- docs_build/dev/ProjectInstructions/README.txt | 12 +- .../codex_project_instructions_startup.md | 4 +- .../addendums/documentation_ownership.md | 54 + .../addendums/project_reference_files.md | 14 +- .../addendums/release_gate.md | 6 +- .../dev/ProjectInstructions/archive/README.md | 12 - .../standards}/AUDIT_EVENT_CONTRACT.md | 0 .../standards}/BACKUP_SNAPSHOT_CONTRACT.md | 0 .../standards}/COLLABORATION_ROLE_CONTRACT.md | 0 .../standards}/CREATOR_PROFILE_CONTRACT.md | 0 .../standards}/DOWNLOAD_GRANT_CONTRACT.md | 0 .../standards}/ENTITLEMENT_CONTRACT.md | 0 .../standards}/GAME_MANIFEST_CONTRACT.md | 0 .../IDENTITY_PERMISSIONS_CONTRACT.md | 0 .../standards}/IDENTITY_PERMISSIONS_MODEL.md | 0 .../standards}/INSTALL_RECEIPT_CONTRACT.md | 0 .../standards}/LAUNCHER_PAIRING_CONTRACT.md | 0 .../standards}/LIBRARY_ITEM_CONTRACT.md | 0 .../MARKETPLACE_LISTING_CONTRACT.md | 0 ...RKETPLACE_TRANSACTION_BOUNDARY_CONTRACT.md | 0 .../standards}/MIGRATION_PLAN_CONTRACT.md | 0 .../standards}/MODERATION_QUEUE_CONTRACT.md | 0 .../standards}/NOTIFICATION_CONTRACT.md | 0 .../standards}/ORGANIZATION_CONTRACT.md | 0 .../PLATFORM_DATA_OWNERSHIP_MODEL.md | 0 .../PROJECTWORKSPACE_VALIDATION_BOUNDARIES.md | 0 .../standards}/PROJECT_CONTRACT.md | 0 .../standards}/PROJECT_LIFECYCLE_MODEL.md | 0 .../standards}/PROJECT_TYPE_CONTRACT.md | 0 .../PROJECT_WORKSPACE_RUNTIME_CONTRACT.md | 0 .../standards}/PUBLISH_CONTRACT.md | 0 .../ProjectInstructions/standards/README.md | 10 + .../standards}/RELEASE_CONTRACT.md | 0 .../standards}/RESTORE_SNAPSHOT_CONTRACT.md | 0 .../standards}/REVIEW_RATING_CONTRACT.md | 0 .../standards/SERVER_DASHBOARD_FOUNDATION.md} | 5 - .../standards}/TOOL_LAUNCH_SSOT.md | 0 .../standards}/TOOL_STATE_CONTRACT.md | 0 .../standards}/UPDATE_CHANNEL_CONTRACT.md | 0 .../VERSION_COMPATIBILITY_CONTRACT.md | 0 ...008-dev-documentation-ownership-cleanup.md | 1 + ...ion-ownership-cleanup_branch-validation.md | 1 + ...nership-cleanup_manual-validation-notes.md | 1 + ...ownership-cleanup_requirement-checklist.md | 1 + ...ation-ownership-cleanup_validation-lane.md | 1 + .../dev/reports/codex_changed_files.txt | 241 +- docs_build/dev/reports/codex_review.diff | 9685 +++++++---------- .../reports/documentation-ownership-report.md | 147 + .../addendums/assistant-execution-modes.md | 120 - .../canonical-repository-structure.md | 39 - .../codex-artifact-and-reporting-standard.md | 66 - .../codex-project-instructions-startup.md | 63 - .../addendums/legacy-migration-policy.md | 33 - .../test-structure-standardization.md | 33 - 132 files changed, 4644 insertions(+), 6036 deletions(-) create mode 100644 archive/docs_build/dev/ProjectInstructions/archive/README.md rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/.gitkeep (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_144555.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_153126.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_153759.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_154153.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_154830.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_155907.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_161414.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_161520.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_161703.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_163009.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_231154.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_231757.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_233733.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_235757.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260621_235932.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260622_000449.md (100%) rename {docs_build => archive/docs_build}/dev/ProjectInstructions/archive/history/20260622_002424.md (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/BusinessPlan.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/GFS-AI-Credits-Reseller-Strategy.pdf (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/GFS-Connected-Play-Second-Screen-Turn-Based-Design-26170-001.pdf (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/GFS_Design_Messages_Tool_And_Platform_Reference_Rules.pdf (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/GFS_Game_Identity_Strategy.pdf.pdf (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/GFS_Game_Journey_Master_Plan.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/Installs required.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/PS_commands.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/Table layout.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/admin/index.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/colors/colos.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/colors/index.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/deployment-uat-prod/index.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/email/index.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/engine/GameLoop.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/engine/ProjectDifficulty.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/engine/ProjectLifeCycle.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/engine/index.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/fonts/index.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/index.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/notes/index.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/other/index.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/roadmap2MVP.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/sample.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/tools/ObjectConfigurationRules.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/tools/TestDebug.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/tools/Tools.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/tools/achievements.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/tools/edit_input.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/tools/game config.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/tools/game design.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/tools/game publisher.txt (100%) rename {docs_build => archive/docs_build}/dev/admin-notes/tools/index.txt (100%) rename {docs_build => archive/docs_build}/dev/roadmaps/MASTER_ROADMAP_FEATURES.md (100%) rename {docs_build => archive/docs_build}/dev/roadmaps/MASTER_ROADMAP_STYLE.md (100%) rename {docs_build => archive/docs_build}/dev/roadmaps/POST_MIGRATION_PLATFORM_ROADMAP.md (100%) create mode 100644 docs_build/dev/PR/README.md rename docs_build/dev/{pr/BUILD_PR.md => PR/examples/OWNER_007_BUILD_PR.md} (100%) rename docs_build/dev/{pr/PLAN_PR.md => PR/examples/OWNER_007_PLAN_PR.md} (100%) create mode 100644 docs_build/dev/PR/examples/README.md rename docs_build/dev/{pr => PR/examples}/plan_pr_tool_workspace_manifest_boundaries.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_koti_layout_contract.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_fix_asset_browser_1505.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_fix_fullscreen_exit_state.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_fix_parallax_header_metadata.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_header_singleline.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_interactive_uat.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_layout_workflow_baseline.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_remove_future_import_hints.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_remove_static_header_intro.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_stabilization.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_uat_closeout.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_uat_fix_fullscreen_header_wiring.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_uat_fix_header_asset_browser.md (100%) rename docs_build/dev/{pr => PR/examples}/pr_tool_uat_fixes.md (100%) create mode 100644 docs_build/dev/PR/templates/BUILD_PR.md create mode 100644 docs_build/dev/PR/templates/PLAN_PR.md rename docs_build/dev/{ => PR}/templates/pr_capability_bundle_checklist.md (100%) create mode 100644 docs_build/dev/ProjectInstructions/addendums/documentation_ownership.md delete mode 100644 docs_build/dev/ProjectInstructions/archive/README.md rename docs_build/dev/{specs => ProjectInstructions/standards}/AUDIT_EVENT_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/BACKUP_SNAPSHOT_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/COLLABORATION_ROLE_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/CREATOR_PROFILE_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/DOWNLOAD_GRANT_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/ENTITLEMENT_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/GAME_MANIFEST_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/IDENTITY_PERMISSIONS_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/IDENTITY_PERMISSIONS_MODEL.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/INSTALL_RECEIPT_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/LAUNCHER_PAIRING_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/LIBRARY_ITEM_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/MARKETPLACE_LISTING_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/MARKETPLACE_TRANSACTION_BOUNDARY_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/MIGRATION_PLAN_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/MODERATION_QUEUE_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/NOTIFICATION_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/ORGANIZATION_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/PLATFORM_DATA_OWNERSHIP_MODEL.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/PROJECTWORKSPACE_VALIDATION_BOUNDARIES.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/PROJECT_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/PROJECT_LIFECYCLE_MODEL.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/PROJECT_TYPE_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/PROJECT_WORKSPACE_RUNTIME_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/PUBLISH_CONTRACT.md (100%) create mode 100644 docs_build/dev/ProjectInstructions/standards/README.md rename docs_build/dev/{specs => ProjectInstructions/standards}/RELEASE_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/RESTORE_SNAPSHOT_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/REVIEW_RATING_CONTRACT.md (100%) rename docs_build/dev/{toolbox/server-dashboard/README.md => ProjectInstructions/standards/SERVER_DASHBOARD_FOUNDATION.md} (95%) rename docs_build/dev/{specs => ProjectInstructions/standards}/TOOL_LAUNCH_SSOT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/TOOL_STATE_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/UPDATE_CHANNEL_CONTRACT.md (100%) rename docs_build/dev/{specs => ProjectInstructions/standards}/VERSION_COMPATIBILITY_CONTRACT.md (100%) create mode 100644 docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup.md create mode 100644 docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_branch-validation.md create mode 100644 docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_manual-validation-notes.md create mode 100644 docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_requirement-checklist.md create mode 100644 docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_validation-lane.md create mode 100644 docs_build/dev/reports/documentation-ownership-report.md delete mode 100644 project-instructions/addendums/assistant-execution-modes.md delete mode 100644 project-instructions/addendums/canonical-repository-structure.md delete mode 100644 project-instructions/addendums/codex-artifact-and-reporting-standard.md delete mode 100644 project-instructions/addendums/codex-project-instructions-startup.md delete mode 100644 project-instructions/addendums/legacy-migration-policy.md delete mode 100644 project-instructions/addendums/test-structure-standardization.md diff --git a/archive/docs_build/dev/ProjectInstructions/archive/README.md b/archive/docs_build/dev/ProjectInstructions/archive/README.md new file mode 100644 index 000000000..13376c7a6 --- /dev/null +++ b/archive/docs_build/dev/ProjectInstructions/archive/README.md @@ -0,0 +1,12 @@ +# Project Instructions Archive Reference + +This root archive path retains Project Instructions reference material that is no longer active but must remain traceable. + +## Rules + +- Archive instead of delete. +- Keep archived material readable. +- Preserve original meaning and context. +- Do not rewrite archive entries unless the owner explicitly approves. +- Use `archive/docs_build/dev/ProjectInstructions/history/CCYYMMDD_HHMMSS.md` for active-governance history snapshots. +- If archive placement is unclear, stop and request owner approval. diff --git a/docs_build/dev/ProjectInstructions/archive/history/.gitkeep b/archive/docs_build/dev/ProjectInstructions/archive/history/.gitkeep similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/.gitkeep rename to archive/docs_build/dev/ProjectInstructions/archive/history/.gitkeep diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_144555.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_144555.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_144555.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_144555.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_153126.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_153126.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_153126.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_153126.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_153759.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_153759.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_153759.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_153759.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_154153.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_154153.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_154153.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_154153.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_154830.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_154830.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_154830.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_154830.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_155907.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_155907.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_155907.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_155907.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_161414.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_161414.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_161414.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_161414.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_161520.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_161520.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_161520.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_161520.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_161703.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_161703.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_161703.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_161703.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_163009.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_163009.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_163009.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_163009.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_231154.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_231154.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_231154.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_231154.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_231757.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_231757.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_231757.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_231757.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_233733.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_233733.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_233733.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_233733.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_235757.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_235757.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_235757.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_235757.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260621_235932.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260621_235932.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260621_235932.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260621_235932.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260622_000449.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260622_000449.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260622_000449.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260622_000449.md diff --git a/docs_build/dev/ProjectInstructions/archive/history/20260622_002424.md b/archive/docs_build/dev/ProjectInstructions/archive/history/20260622_002424.md similarity index 100% rename from docs_build/dev/ProjectInstructions/archive/history/20260622_002424.md rename to archive/docs_build/dev/ProjectInstructions/archive/history/20260622_002424.md diff --git a/docs_build/dev/admin-notes/BusinessPlan.txt b/archive/docs_build/dev/admin-notes/BusinessPlan.txt similarity index 100% rename from docs_build/dev/admin-notes/BusinessPlan.txt rename to archive/docs_build/dev/admin-notes/BusinessPlan.txt diff --git a/docs_build/dev/admin-notes/GFS-AI-Credits-Reseller-Strategy.pdf b/archive/docs_build/dev/admin-notes/GFS-AI-Credits-Reseller-Strategy.pdf similarity index 100% rename from docs_build/dev/admin-notes/GFS-AI-Credits-Reseller-Strategy.pdf rename to archive/docs_build/dev/admin-notes/GFS-AI-Credits-Reseller-Strategy.pdf diff --git a/docs_build/dev/admin-notes/GFS-Connected-Play-Second-Screen-Turn-Based-Design-26170-001.pdf b/archive/docs_build/dev/admin-notes/GFS-Connected-Play-Second-Screen-Turn-Based-Design-26170-001.pdf similarity index 100% rename from docs_build/dev/admin-notes/GFS-Connected-Play-Second-Screen-Turn-Based-Design-26170-001.pdf rename to archive/docs_build/dev/admin-notes/GFS-Connected-Play-Second-Screen-Turn-Based-Design-26170-001.pdf diff --git a/docs_build/dev/admin-notes/GFS_Design_Messages_Tool_And_Platform_Reference_Rules.pdf b/archive/docs_build/dev/admin-notes/GFS_Design_Messages_Tool_And_Platform_Reference_Rules.pdf similarity index 100% rename from docs_build/dev/admin-notes/GFS_Design_Messages_Tool_And_Platform_Reference_Rules.pdf rename to archive/docs_build/dev/admin-notes/GFS_Design_Messages_Tool_And_Platform_Reference_Rules.pdf diff --git a/docs_build/dev/admin-notes/GFS_Game_Identity_Strategy.pdf.pdf b/archive/docs_build/dev/admin-notes/GFS_Game_Identity_Strategy.pdf.pdf similarity index 100% rename from docs_build/dev/admin-notes/GFS_Game_Identity_Strategy.pdf.pdf rename to archive/docs_build/dev/admin-notes/GFS_Game_Identity_Strategy.pdf.pdf diff --git a/docs_build/dev/admin-notes/GFS_Game_Journey_Master_Plan.txt b/archive/docs_build/dev/admin-notes/GFS_Game_Journey_Master_Plan.txt similarity index 100% rename from docs_build/dev/admin-notes/GFS_Game_Journey_Master_Plan.txt rename to archive/docs_build/dev/admin-notes/GFS_Game_Journey_Master_Plan.txt diff --git a/docs_build/dev/admin-notes/Installs required.txt b/archive/docs_build/dev/admin-notes/Installs required.txt similarity index 100% rename from docs_build/dev/admin-notes/Installs required.txt rename to archive/docs_build/dev/admin-notes/Installs required.txt diff --git a/docs_build/dev/admin-notes/PS_commands.txt b/archive/docs_build/dev/admin-notes/PS_commands.txt similarity index 100% rename from docs_build/dev/admin-notes/PS_commands.txt rename to archive/docs_build/dev/admin-notes/PS_commands.txt diff --git a/docs_build/dev/admin-notes/Table layout.txt b/archive/docs_build/dev/admin-notes/Table layout.txt similarity index 100% rename from docs_build/dev/admin-notes/Table layout.txt rename to archive/docs_build/dev/admin-notes/Table layout.txt diff --git a/docs_build/dev/admin-notes/admin/index.txt b/archive/docs_build/dev/admin-notes/admin/index.txt similarity index 100% rename from docs_build/dev/admin-notes/admin/index.txt rename to archive/docs_build/dev/admin-notes/admin/index.txt diff --git a/docs_build/dev/admin-notes/colors/colos.txt b/archive/docs_build/dev/admin-notes/colors/colos.txt similarity index 100% rename from docs_build/dev/admin-notes/colors/colos.txt rename to archive/docs_build/dev/admin-notes/colors/colos.txt diff --git a/docs_build/dev/admin-notes/colors/index.txt b/archive/docs_build/dev/admin-notes/colors/index.txt similarity index 100% rename from docs_build/dev/admin-notes/colors/index.txt rename to archive/docs_build/dev/admin-notes/colors/index.txt diff --git a/docs_build/dev/admin-notes/deployment-uat-prod/index.txt b/archive/docs_build/dev/admin-notes/deployment-uat-prod/index.txt similarity index 100% rename from docs_build/dev/admin-notes/deployment-uat-prod/index.txt rename to archive/docs_build/dev/admin-notes/deployment-uat-prod/index.txt diff --git a/docs_build/dev/admin-notes/email/index.txt b/archive/docs_build/dev/admin-notes/email/index.txt similarity index 100% rename from docs_build/dev/admin-notes/email/index.txt rename to archive/docs_build/dev/admin-notes/email/index.txt diff --git a/docs_build/dev/admin-notes/engine/GameLoop.txt b/archive/docs_build/dev/admin-notes/engine/GameLoop.txt similarity index 100% rename from docs_build/dev/admin-notes/engine/GameLoop.txt rename to archive/docs_build/dev/admin-notes/engine/GameLoop.txt diff --git a/docs_build/dev/admin-notes/engine/ProjectDifficulty.txt b/archive/docs_build/dev/admin-notes/engine/ProjectDifficulty.txt similarity index 100% rename from docs_build/dev/admin-notes/engine/ProjectDifficulty.txt rename to archive/docs_build/dev/admin-notes/engine/ProjectDifficulty.txt diff --git a/docs_build/dev/admin-notes/engine/ProjectLifeCycle.txt b/archive/docs_build/dev/admin-notes/engine/ProjectLifeCycle.txt similarity index 100% rename from docs_build/dev/admin-notes/engine/ProjectLifeCycle.txt rename to archive/docs_build/dev/admin-notes/engine/ProjectLifeCycle.txt diff --git a/docs_build/dev/admin-notes/engine/index.txt b/archive/docs_build/dev/admin-notes/engine/index.txt similarity index 100% rename from docs_build/dev/admin-notes/engine/index.txt rename to archive/docs_build/dev/admin-notes/engine/index.txt diff --git a/docs_build/dev/admin-notes/fonts/index.txt b/archive/docs_build/dev/admin-notes/fonts/index.txt similarity index 100% rename from docs_build/dev/admin-notes/fonts/index.txt rename to archive/docs_build/dev/admin-notes/fonts/index.txt diff --git a/docs_build/dev/admin-notes/index.txt b/archive/docs_build/dev/admin-notes/index.txt similarity index 100% rename from docs_build/dev/admin-notes/index.txt rename to archive/docs_build/dev/admin-notes/index.txt diff --git a/docs_build/dev/admin-notes/notes/index.txt b/archive/docs_build/dev/admin-notes/notes/index.txt similarity index 100% rename from docs_build/dev/admin-notes/notes/index.txt rename to archive/docs_build/dev/admin-notes/notes/index.txt diff --git a/docs_build/dev/admin-notes/other/index.txt b/archive/docs_build/dev/admin-notes/other/index.txt similarity index 100% rename from docs_build/dev/admin-notes/other/index.txt rename to archive/docs_build/dev/admin-notes/other/index.txt diff --git a/docs_build/dev/admin-notes/roadmap2MVP.txt b/archive/docs_build/dev/admin-notes/roadmap2MVP.txt similarity index 100% rename from docs_build/dev/admin-notes/roadmap2MVP.txt rename to archive/docs_build/dev/admin-notes/roadmap2MVP.txt diff --git a/docs_build/dev/admin-notes/sample.txt b/archive/docs_build/dev/admin-notes/sample.txt similarity index 100% rename from docs_build/dev/admin-notes/sample.txt rename to archive/docs_build/dev/admin-notes/sample.txt diff --git a/docs_build/dev/admin-notes/tools/ObjectConfigurationRules.txt b/archive/docs_build/dev/admin-notes/tools/ObjectConfigurationRules.txt similarity index 100% rename from docs_build/dev/admin-notes/tools/ObjectConfigurationRules.txt rename to archive/docs_build/dev/admin-notes/tools/ObjectConfigurationRules.txt diff --git a/docs_build/dev/admin-notes/tools/TestDebug.txt b/archive/docs_build/dev/admin-notes/tools/TestDebug.txt similarity index 100% rename from docs_build/dev/admin-notes/tools/TestDebug.txt rename to archive/docs_build/dev/admin-notes/tools/TestDebug.txt diff --git a/docs_build/dev/admin-notes/tools/Tools.txt b/archive/docs_build/dev/admin-notes/tools/Tools.txt similarity index 100% rename from docs_build/dev/admin-notes/tools/Tools.txt rename to archive/docs_build/dev/admin-notes/tools/Tools.txt diff --git a/docs_build/dev/admin-notes/tools/achievements.txt b/archive/docs_build/dev/admin-notes/tools/achievements.txt similarity index 100% rename from docs_build/dev/admin-notes/tools/achievements.txt rename to archive/docs_build/dev/admin-notes/tools/achievements.txt diff --git a/docs_build/dev/admin-notes/tools/edit_input.txt b/archive/docs_build/dev/admin-notes/tools/edit_input.txt similarity index 100% rename from docs_build/dev/admin-notes/tools/edit_input.txt rename to archive/docs_build/dev/admin-notes/tools/edit_input.txt diff --git a/docs_build/dev/admin-notes/tools/game config.txt b/archive/docs_build/dev/admin-notes/tools/game config.txt similarity index 100% rename from docs_build/dev/admin-notes/tools/game config.txt rename to archive/docs_build/dev/admin-notes/tools/game config.txt diff --git a/docs_build/dev/admin-notes/tools/game design.txt b/archive/docs_build/dev/admin-notes/tools/game design.txt similarity index 100% rename from docs_build/dev/admin-notes/tools/game design.txt rename to archive/docs_build/dev/admin-notes/tools/game design.txt diff --git a/docs_build/dev/admin-notes/tools/game publisher.txt b/archive/docs_build/dev/admin-notes/tools/game publisher.txt similarity index 100% rename from docs_build/dev/admin-notes/tools/game publisher.txt rename to archive/docs_build/dev/admin-notes/tools/game publisher.txt diff --git a/docs_build/dev/admin-notes/tools/index.txt b/archive/docs_build/dev/admin-notes/tools/index.txt similarity index 100% rename from docs_build/dev/admin-notes/tools/index.txt rename to archive/docs_build/dev/admin-notes/tools/index.txt diff --git a/docs_build/dev/roadmaps/MASTER_ROADMAP_FEATURES.md b/archive/docs_build/dev/roadmaps/MASTER_ROADMAP_FEATURES.md similarity index 100% rename from docs_build/dev/roadmaps/MASTER_ROADMAP_FEATURES.md rename to archive/docs_build/dev/roadmaps/MASTER_ROADMAP_FEATURES.md diff --git a/docs_build/dev/roadmaps/MASTER_ROADMAP_STYLE.md b/archive/docs_build/dev/roadmaps/MASTER_ROADMAP_STYLE.md similarity index 100% rename from docs_build/dev/roadmaps/MASTER_ROADMAP_STYLE.md rename to archive/docs_build/dev/roadmaps/MASTER_ROADMAP_STYLE.md diff --git a/docs_build/dev/roadmaps/POST_MIGRATION_PLATFORM_ROADMAP.md b/archive/docs_build/dev/roadmaps/POST_MIGRATION_PLATFORM_ROADMAP.md similarity index 100% rename from docs_build/dev/roadmaps/POST_MIGRATION_PLATFORM_ROADMAP.md rename to archive/docs_build/dev/roadmaps/POST_MIGRATION_PLATFORM_ROADMAP.md diff --git a/docs_build/dev/PR/README.md b/docs_build/dev/PR/README.md new file mode 100644 index 000000000..128e7b56b --- /dev/null +++ b/docs_build/dev/PR/README.md @@ -0,0 +1,18 @@ +# PR Documentation Area + +This folder owns reusable PR workflow material and historical PR examples. + +## Ownership + +- `templates/` contains reusable PR planning and build templates. +- `examples/` contains historical or example PR documents. + +Reusable PR templates must not live outside `docs_build/dev/PR/templates/`. +Generated PR reports must live under `docs_build/dev/reports/`. +Permanent governance must live under `docs_build/dev/ProjectInstructions/`. + +## Rules + +- Do not put active Project Instructions in this folder. +- Do not put generated reports in this folder. +- Do not use lower-case `docs_build/dev/pr/`; this folder is the canonical PR documentation area. diff --git a/docs_build/dev/pr/BUILD_PR.md b/docs_build/dev/PR/examples/OWNER_007_BUILD_PR.md similarity index 100% rename from docs_build/dev/pr/BUILD_PR.md rename to docs_build/dev/PR/examples/OWNER_007_BUILD_PR.md diff --git a/docs_build/dev/pr/PLAN_PR.md b/docs_build/dev/PR/examples/OWNER_007_PLAN_PR.md similarity index 100% rename from docs_build/dev/pr/PLAN_PR.md rename to docs_build/dev/PR/examples/OWNER_007_PLAN_PR.md diff --git a/docs_build/dev/PR/examples/README.md b/docs_build/dev/PR/examples/README.md new file mode 100644 index 000000000..4766162dd --- /dev/null +++ b/docs_build/dev/PR/examples/README.md @@ -0,0 +1,7 @@ +# PR Examples + +This folder contains historical or example PR planning documents. + +Files here are examples only. They are not active Project Instructions, not reusable templates, and not generated reports. + +Use reusable templates from `docs_build/dev/PR/templates/`. diff --git a/docs_build/dev/pr/plan_pr_tool_workspace_manifest_boundaries.md b/docs_build/dev/PR/examples/plan_pr_tool_workspace_manifest_boundaries.md similarity index 100% rename from docs_build/dev/pr/plan_pr_tool_workspace_manifest_boundaries.md rename to docs_build/dev/PR/examples/plan_pr_tool_workspace_manifest_boundaries.md diff --git a/docs_build/dev/pr/pr_koti_layout_contract.md b/docs_build/dev/PR/examples/pr_koti_layout_contract.md similarity index 100% rename from docs_build/dev/pr/pr_koti_layout_contract.md rename to docs_build/dev/PR/examples/pr_koti_layout_contract.md diff --git a/docs_build/dev/pr/pr_tool_fix_asset_browser_1505.md b/docs_build/dev/PR/examples/pr_tool_fix_asset_browser_1505.md similarity index 100% rename from docs_build/dev/pr/pr_tool_fix_asset_browser_1505.md rename to docs_build/dev/PR/examples/pr_tool_fix_asset_browser_1505.md diff --git a/docs_build/dev/pr/pr_tool_fix_fullscreen_exit_state.md b/docs_build/dev/PR/examples/pr_tool_fix_fullscreen_exit_state.md similarity index 100% rename from docs_build/dev/pr/pr_tool_fix_fullscreen_exit_state.md rename to docs_build/dev/PR/examples/pr_tool_fix_fullscreen_exit_state.md diff --git a/docs_build/dev/pr/pr_tool_fix_parallax_header_metadata.md b/docs_build/dev/PR/examples/pr_tool_fix_parallax_header_metadata.md similarity index 100% rename from docs_build/dev/pr/pr_tool_fix_parallax_header_metadata.md rename to docs_build/dev/PR/examples/pr_tool_fix_parallax_header_metadata.md diff --git a/docs_build/dev/pr/pr_tool_header_singleline.md b/docs_build/dev/PR/examples/pr_tool_header_singleline.md similarity index 100% rename from docs_build/dev/pr/pr_tool_header_singleline.md rename to docs_build/dev/PR/examples/pr_tool_header_singleline.md diff --git a/docs_build/dev/pr/pr_tool_interactive_uat.md b/docs_build/dev/PR/examples/pr_tool_interactive_uat.md similarity index 100% rename from docs_build/dev/pr/pr_tool_interactive_uat.md rename to docs_build/dev/PR/examples/pr_tool_interactive_uat.md diff --git a/docs_build/dev/pr/pr_tool_layout_workflow_baseline.md b/docs_build/dev/PR/examples/pr_tool_layout_workflow_baseline.md similarity index 100% rename from docs_build/dev/pr/pr_tool_layout_workflow_baseline.md rename to docs_build/dev/PR/examples/pr_tool_layout_workflow_baseline.md diff --git a/docs_build/dev/pr/pr_tool_remove_future_import_hints.md b/docs_build/dev/PR/examples/pr_tool_remove_future_import_hints.md similarity index 100% rename from docs_build/dev/pr/pr_tool_remove_future_import_hints.md rename to docs_build/dev/PR/examples/pr_tool_remove_future_import_hints.md diff --git a/docs_build/dev/pr/pr_tool_remove_static_header_intro.md b/docs_build/dev/PR/examples/pr_tool_remove_static_header_intro.md similarity index 100% rename from docs_build/dev/pr/pr_tool_remove_static_header_intro.md rename to docs_build/dev/PR/examples/pr_tool_remove_static_header_intro.md diff --git a/docs_build/dev/pr/pr_tool_stabilization.md b/docs_build/dev/PR/examples/pr_tool_stabilization.md similarity index 100% rename from docs_build/dev/pr/pr_tool_stabilization.md rename to docs_build/dev/PR/examples/pr_tool_stabilization.md diff --git a/docs_build/dev/pr/pr_tool_uat_closeout.md b/docs_build/dev/PR/examples/pr_tool_uat_closeout.md similarity index 100% rename from docs_build/dev/pr/pr_tool_uat_closeout.md rename to docs_build/dev/PR/examples/pr_tool_uat_closeout.md diff --git a/docs_build/dev/pr/pr_tool_uat_fix_fullscreen_header_wiring.md b/docs_build/dev/PR/examples/pr_tool_uat_fix_fullscreen_header_wiring.md similarity index 100% rename from docs_build/dev/pr/pr_tool_uat_fix_fullscreen_header_wiring.md rename to docs_build/dev/PR/examples/pr_tool_uat_fix_fullscreen_header_wiring.md diff --git a/docs_build/dev/pr/pr_tool_uat_fix_header_asset_browser.md b/docs_build/dev/PR/examples/pr_tool_uat_fix_header_asset_browser.md similarity index 100% rename from docs_build/dev/pr/pr_tool_uat_fix_header_asset_browser.md rename to docs_build/dev/PR/examples/pr_tool_uat_fix_header_asset_browser.md diff --git a/docs_build/dev/pr/pr_tool_uat_fixes.md b/docs_build/dev/PR/examples/pr_tool_uat_fixes.md similarity index 100% rename from docs_build/dev/pr/pr_tool_uat_fixes.md rename to docs_build/dev/PR/examples/pr_tool_uat_fixes.md diff --git a/docs_build/dev/PR/templates/BUILD_PR.md b/docs_build/dev/PR/templates/BUILD_PR.md new file mode 100644 index 000000000..a5c2c186e --- /dev/null +++ b/docs_build/dev/PR/templates/BUILD_PR.md @@ -0,0 +1,44 @@ +# BUILD_PR: + +## Purpose + +Describe the one PR purpose. + +## Source Of Truth + +Use the current user request, this BUILD_PR, and active Project Instructions under `docs_build/dev/ProjectInstructions/`. + +## Exact Scope + +- List exact implementation tasks. +- Keep each item testable. + +## Exact Targets + +- `path/to/file` + +## Out Of Scope + +- No unrelated cleanup. +- No runtime/product/API/database changes unless explicitly scoped. + +## Validation + +Run targeted validation only: + +```powershell +git diff --check +``` + +## Reports + +Create or update: + +- `docs_build/dev/reports/codex_review.diff` +- `docs_build/dev/reports/codex_changed_files.txt` +- PR-specific report under `docs_build/dev/reports/` +- branch validation PASS/FAIL +- requirement checklist PASS/FAIL +- validation lane report +- manual validation notes +- repo-structured ZIP under `tmp/` diff --git a/docs_build/dev/PR/templates/PLAN_PR.md b/docs_build/dev/PR/templates/PLAN_PR.md new file mode 100644 index 000000000..b757ac82c --- /dev/null +++ b/docs_build/dev/PR/templates/PLAN_PR.md @@ -0,0 +1,30 @@ +# PLAN_PR: + +## Purpose + +Describe the single PR purpose in one or two sentences. + +## Scope + +- List the smallest valid scoped changes. +- Include only work required by the PR purpose. + +## Out Of Scope + +- List explicit exclusions. +- Include runtime, API, database, or UI exclusions when applicable. + +## Creator-Testable Outcome + +State what Mr. Q can test after applying the ZIP. + +## Validation Plan + +1. List targeted validation commands. +2. List manual checks. +3. State whether Playwright is impacted. + +## Dependencies + +- Previous PR: none +- Next PR: none diff --git a/docs_build/dev/templates/pr_capability_bundle_checklist.md b/docs_build/dev/PR/templates/pr_capability_bundle_checklist.md similarity index 100% rename from docs_build/dev/templates/pr_capability_bundle_checklist.md rename to docs_build/dev/PR/templates/pr_capability_bundle_checklist.md diff --git a/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md b/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md index c52753b84..d9efb1741 100644 --- a/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md +++ b/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md @@ -17,9 +17,11 @@ The Project Instructions operating system provides additive governance for: - backlog ownership - team assignments - multi-team branch and scope rules +- documentation ownership - Build Path status synchronization - tile overlay status behavior - deprecation workflow +- contract and platform standards - archive and history preservation - recognized project instruction/reference files - environment governance @@ -34,13 +36,23 @@ Existing Project Instructions outside `docs_build/dev/ProjectInstructions/` rema - `addendums/` contains additive governance rules. - `backlog/` contains the central backlog file, `BACKLOG_MASTER.md`. - `team_assignments/` contains current team assignment records. +- `standards/` contains active contract, model, and platform standards. - `deprecation/` contains deprecation workflow documentation. - Retained reference material belongs under the repository root `archive/` tree, not under `docs_build/dev/`. - History snapshots belong under `archive/docs_build/dev/ProjectInstructions/history/`. ## Recognized Project Reference Files -`docs_build/dev/ProjectInstructions/addendums/project_reference_files.md` defines additional valid project instruction/reference files that must be included in future Project Instructions reviews when present in `ProjectInstructions.zip`, the active project instruction directory, or `docs_build/dev/admin-notes/`. +`docs_build/dev/ProjectInstructions/addendums/project_reference_files.md` defines additional valid project instruction/reference files that must be included in future Project Instructions reviews when present in `ProjectInstructions.zip`, the active project instruction directory, or the root archive reference tree. + +## Documentation Ownership + +`docs_build/dev/ProjectInstructions/addendums/documentation_ownership.md` defines the active documentation ownership model: + +- `docs_build/dev/ProjectInstructions/` owns governance, team instructions, standards, and addendums. +- `docs_build/dev/PR/` owns PR workflow documents, templates, and examples. +- `docs_build/dev/reports/` owns generated reports, audits, and validation artifacts. +- root `archive/` owns historical reference material only. ## Environment Governance @@ -60,6 +72,12 @@ Existing Project Instructions outside `docs_build/dev/ProjectInstructions/` rema `docs_build/dev/ProjectInstructions/addendums/no_mock_repository_runtime_source.md` defines the Browser → API → Database product-data rule and mock repository technical debt boundary. +## Standards + +Active contract, model, and platform standards live under: + +`docs_build/dev/ProjectInstructions/standards/` + ## Single Source and Main Lock Governance `docs_build/dev/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md` defines the single active Project Instructions source, canonical START / WORK / END branch lifecycle, EOD main lock, next-day reset, team branch creation gate, daily synchronization baseline, and mandatory hard stops. diff --git a/docs_build/dev/ProjectInstructions/README.txt b/docs_build/dev/ProjectInstructions/README.txt index 9831123d3..3493bce57 100644 --- a/docs_build/dev/ProjectInstructions/README.txt +++ b/docs_build/dev/ProjectInstructions/README.txt @@ -1,10 +1,10 @@ Read this file first. Folder purpose: -This folder is the only active Project Instructions source for Game Foundry Studio. It organizes active governance, backlog, team assignment, deprecation, and history material under `docs_build/dev/ProjectInstructions/`. +This folder is the only active Project Instructions source for Game Foundry Studio. It organizes active governance, backlog, team assignment, standards, deprecation, and history material under `docs_build/dev/ProjectInstructions/`. Preservation rules: -Preserve historical Project Instructions material as deprecated reference only. Do not treat root-level copies in `docs_build/dev/`, `project-instructions/`, or archived snapshots as active instruction sources. When a conflict appears, `docs_build/dev/ProjectInstructions/` wins unless OWNER explicitly approves a newer governance change. +Preserve historical Project Instructions material as deprecated reference only. Do not treat root-level copies in `docs_build/dev/`, `project-instructions/`, `archive/`, or archived snapshots as active instruction sources. When a conflict appears, `docs_build/dev/ProjectInstructions/` wins unless OWNER explicitly approves a newer governance change. Backlog workflow: Backlog work is tracked under backlog/. BACKLOG_MASTER.md is the planned source for backlog item status, notes, and references. Backlog item text is treated as immutable once created; status and notes may change under the governance addendums. @@ -46,6 +46,7 @@ READ THIS FIRST 12. Follow the canonical START / WORK / END lifecycle. Addendum index: +- Documentation Ownership: docs_build/dev/ProjectInstructions/addendums/documentation_ownership.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 - Test Structure Standardization: docs_build/dev/ProjectInstructions/addendums/test_structure_standardization.md @@ -61,3 +62,10 @@ Addendum index: - King of the Iceberg Layout Contract: docs_build/dev/ProjectInstructions/addendums/koti_layout_contract.md - Tool MVP Stacked PR Standard: docs_build/dev/ProjectInstructions/addendums/tool_mvp_stacked_pr_standard.md - No Mock Repository Runtime Source: docs_build/dev/ProjectInstructions/addendums/no_mock_repository_runtime_source.md + +Standards index: +- Active contract, model, and platform standards: docs_build/dev/ProjectInstructions/standards/ + +PR documentation: +- Reusable PR templates: docs_build/dev/PR/templates/ +- Historical/example PR documents: docs_build/dev/PR/examples/ diff --git a/docs_build/dev/ProjectInstructions/addendums/codex_project_instructions_startup.md b/docs_build/dev/ProjectInstructions/addendums/codex_project_instructions_startup.md index ee11393b4..c6d8f192c 100644 --- a/docs_build/dev/ProjectInstructions/addendums/codex_project_instructions_startup.md +++ b/docs_build/dev/ProjectInstructions/addendums/codex_project_instructions_startup.md @@ -47,11 +47,13 @@ Deprecated Project Instructions material outside `docs_build/dev/ProjectInstruct ## Project Reference File Review -When present in `ProjectInstructions.zip`, the active project instruction directory, or `docs_build/dev/admin-notes/`, Codex must include these recognized project instruction/reference files in the Project Instructions read set: +When present in `ProjectInstructions.zip`, the active project instruction directory, or `archive/docs_build/dev/admin-notes/`, Codex must include these recognized project instruction/reference files in the Project Instructions read set: - `Installs required.txt` - `Table layout.txt` +Archived reference files are historical reference only. They must not be treated as active Project Instructions. + Chat instructions may supplement Project Instructions but must not override approved governance without explicit OWNER approval. ## Conflict Handling diff --git a/docs_build/dev/ProjectInstructions/addendums/documentation_ownership.md b/docs_build/dev/ProjectInstructions/addendums/documentation_ownership.md new file mode 100644 index 000000000..1258e917f --- /dev/null +++ b/docs_build/dev/ProjectInstructions/addendums/documentation_ownership.md @@ -0,0 +1,54 @@ +# Documentation Ownership + +Status: Approved +Owner: OWNER + +## Purpose + +Define the ownership model for documentation under `docs_build/dev/` after Project Instructions consolidation. + +## Canonical Ownership + +`docs_build/dev/ProjectInstructions/` owns: +- permanent governance +- team instructions +- standards +- addendums + +`docs_build/dev/PR/` owns: +- PR workflow documentation +- reusable PR templates +- historical or example PR documents + +`docs_build/dev/reports/` owns: +- generated reports +- generated validation artifacts +- audits + +The repository root `archive/` owns: +- historical reference material only + +## Rules + +- No active governance may exist outside `docs_build/dev/ProjectInstructions/`. +- No reusable PR template may exist outside `docs_build/dev/PR/templates/`. +- No generated report may exist outside `docs_build/dev/reports/`. +- No active document may exist outside its owning area. +- Historical reference material must not be treated as active governance. +- `docs_build/dev/start_of_day/` is a protected legacy handoff area and must not become an active Project Instructions source. + +## Folder Rules + +- `docs_build/dev/ProjectInstructions/standards/` contains active contract, model, and platform standards. +- `docs_build/dev/PR/templates/` contains reusable PR templates. +- `docs_build/dev/PR/examples/` contains historical or example PR documents. +- `docs_build/dev/reports/audits/` contains audit report outputs. + +## Validation + +Documentation ownership cleanup PRs must verify: + +- no active Project Instructions outside `docs_build/dev/ProjectInstructions/` +- no reusable PR templates outside `docs_build/dev/PR/templates/` +- no generated reports outside `docs_build/dev/reports/` +- no runtime/product/API/database files changed unless explicitly scoped diff --git a/docs_build/dev/ProjectInstructions/addendums/project_reference_files.md b/docs_build/dev/ProjectInstructions/addendums/project_reference_files.md index 5e56f01a6..3423cddc7 100644 --- a/docs_build/dev/ProjectInstructions/addendums/project_reference_files.md +++ b/docs_build/dev/ProjectInstructions/addendums/project_reference_files.md @@ -5,19 +5,19 @@ Owner: OWNER ## Purpose -Define recognized project instruction and reference documents that may live outside the active `docs_build/dev/ProjectInstructions/` addendum tree but still belong in Project Instructions reviews. +Define recognized project instruction and reference documents that may live in the active `docs_build/dev/ProjectInstructions/` tree or in root `archive/` reference material but still belong in Project Instructions reviews. ## Recognized Files -The following files are valid project instruction/reference documents when present in `ProjectInstructions.zip`, `docs_build/dev/ProjectInstructions/`, or the project instruction/admin-notes directory: +The following files are valid project instruction/reference documents when present in `ProjectInstructions.zip`, `docs_build/dev/ProjectInstructions/`, or the archived project instruction/admin-notes reference tree: - `Installs required.txt` - `Table layout.txt` -Canonical repository locations: +Canonical repository reference locations: -- `docs_build/dev/admin-notes/Installs required.txt` -- `docs_build/dev/admin-notes/Table layout.txt` +- `archive/docs_build/dev/admin-notes/Installs required.txt` +- `archive/docs_build/dev/admin-notes/Table layout.txt` ## Review Rule @@ -25,7 +25,9 @@ Future Project Instructions reviews must include these files automatically when - an extracted `ProjectInstructions.zip` bundle - the active project instruction directory -- `docs_build/dev/admin-notes/` +- `archive/docs_build/dev/admin-notes/` + +Archived reference files are not active governance. If they conflict with active Project Instructions, `docs_build/dev/ProjectInstructions/` wins unless OWNER explicitly approves a newer governance change. Treat these files the same as existing instruction documents for read-set, review, preservation, and reporting purposes. diff --git a/docs_build/dev/ProjectInstructions/addendums/release_gate.md b/docs_build/dev/ProjectInstructions/addendums/release_gate.md index 72bd75c71..eeee48767 100644 --- a/docs_build/dev/ProjectInstructions/addendums/release_gate.md +++ b/docs_build/dev/ProjectInstructions/addendums/release_gate.md @@ -20,6 +20,7 @@ Before a governance, documentation, or administrative PR is merged, validate: - Required source-of-truth files still exist. - Governance Phase 1 completion guidance remains intact. - PR workflow guidance remains intact. +- Documentation ownership guidance remains intact. - Team assignment governance remains intact. - Active team registry guidance remains compatible with temporary active teams. - Canonical START / WORK / END branch lifecycle guidance remains intact. @@ -38,6 +39,7 @@ The release gate should confirm these files when relevant to the PR: - `docs_build/dev/ProjectInstructions/addendums/governance_phase1_complete.md` - `docs_build/dev/ProjectInstructions/addendums/pr_workflow.md` - `docs_build/dev/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md` +- `docs_build/dev/ProjectInstructions/addendums/documentation_ownership.md` - `docs_build/dev/ProjectInstructions/addendums/project_reference_files.md` - `docs_build/dev/ProjectInstructions/addendums/environment_governance_model.md` - `docs_build/dev/ProjectInstructions/addendums/environment_configuration_standards.md` @@ -47,8 +49,8 @@ The release gate should confirm these files when relevant to the PR: - `docs_build/dev/ProjectInstructions/addendums/tool_mvp_stacked_pr_standard.md` - `docs_build/dev/ProjectInstructions/addendums/no_mock_repository_runtime_source.md` - `docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md` -- `docs_build/dev/admin-notes/Installs required.txt` when present -- `docs_build/dev/admin-notes/Table layout.txt` when present +- `archive/docs_build/dev/admin-notes/Installs required.txt` when present +- `archive/docs_build/dev/admin-notes/Table layout.txt` when present ## Validation Result diff --git a/docs_build/dev/ProjectInstructions/archive/README.md b/docs_build/dev/ProjectInstructions/archive/README.md deleted file mode 100644 index dbc07a1d2..000000000 --- a/docs_build/dev/ProjectInstructions/archive/README.md +++ /dev/null @@ -1,12 +0,0 @@ -# Project Instructions Archive - -This archive retains Project Instructions reference material that is no longer active but must remain traceable. - -## Rules - -- Archive instead of delete. -- Keep archived material readable. -- Preserve original meaning and context. -- Do not rewrite archive entries unless the owner explicitly approves. -- Use `history/CCYYMMDD_HHMMSS.md` for history snapshots. -- If archive placement is unclear, stop and request owner approval. diff --git a/docs_build/dev/specs/AUDIT_EVENT_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/AUDIT_EVENT_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/AUDIT_EVENT_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/AUDIT_EVENT_CONTRACT.md diff --git a/docs_build/dev/specs/BACKUP_SNAPSHOT_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/BACKUP_SNAPSHOT_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/BACKUP_SNAPSHOT_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/BACKUP_SNAPSHOT_CONTRACT.md diff --git a/docs_build/dev/specs/COLLABORATION_ROLE_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/COLLABORATION_ROLE_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/COLLABORATION_ROLE_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/COLLABORATION_ROLE_CONTRACT.md diff --git a/docs_build/dev/specs/CREATOR_PROFILE_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/CREATOR_PROFILE_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/CREATOR_PROFILE_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/CREATOR_PROFILE_CONTRACT.md diff --git a/docs_build/dev/specs/DOWNLOAD_GRANT_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/DOWNLOAD_GRANT_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/DOWNLOAD_GRANT_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/DOWNLOAD_GRANT_CONTRACT.md diff --git a/docs_build/dev/specs/ENTITLEMENT_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/ENTITLEMENT_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/ENTITLEMENT_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/ENTITLEMENT_CONTRACT.md diff --git a/docs_build/dev/specs/GAME_MANIFEST_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/GAME_MANIFEST_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/GAME_MANIFEST_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/GAME_MANIFEST_CONTRACT.md diff --git a/docs_build/dev/specs/IDENTITY_PERMISSIONS_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/IDENTITY_PERMISSIONS_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/IDENTITY_PERMISSIONS_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/IDENTITY_PERMISSIONS_CONTRACT.md diff --git a/docs_build/dev/specs/IDENTITY_PERMISSIONS_MODEL.md b/docs_build/dev/ProjectInstructions/standards/IDENTITY_PERMISSIONS_MODEL.md similarity index 100% rename from docs_build/dev/specs/IDENTITY_PERMISSIONS_MODEL.md rename to docs_build/dev/ProjectInstructions/standards/IDENTITY_PERMISSIONS_MODEL.md diff --git a/docs_build/dev/specs/INSTALL_RECEIPT_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/INSTALL_RECEIPT_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/INSTALL_RECEIPT_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/INSTALL_RECEIPT_CONTRACT.md diff --git a/docs_build/dev/specs/LAUNCHER_PAIRING_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/LAUNCHER_PAIRING_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/LAUNCHER_PAIRING_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/LAUNCHER_PAIRING_CONTRACT.md diff --git a/docs_build/dev/specs/LIBRARY_ITEM_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/LIBRARY_ITEM_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/LIBRARY_ITEM_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/LIBRARY_ITEM_CONTRACT.md diff --git a/docs_build/dev/specs/MARKETPLACE_LISTING_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/MARKETPLACE_LISTING_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/MARKETPLACE_LISTING_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/MARKETPLACE_LISTING_CONTRACT.md diff --git a/docs_build/dev/specs/MARKETPLACE_TRANSACTION_BOUNDARY_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/MARKETPLACE_TRANSACTION_BOUNDARY_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/MARKETPLACE_TRANSACTION_BOUNDARY_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/MARKETPLACE_TRANSACTION_BOUNDARY_CONTRACT.md diff --git a/docs_build/dev/specs/MIGRATION_PLAN_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/MIGRATION_PLAN_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/MIGRATION_PLAN_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/MIGRATION_PLAN_CONTRACT.md diff --git a/docs_build/dev/specs/MODERATION_QUEUE_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/MODERATION_QUEUE_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/MODERATION_QUEUE_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/MODERATION_QUEUE_CONTRACT.md diff --git a/docs_build/dev/specs/NOTIFICATION_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/NOTIFICATION_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/NOTIFICATION_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/NOTIFICATION_CONTRACT.md diff --git a/docs_build/dev/specs/ORGANIZATION_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/ORGANIZATION_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/ORGANIZATION_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/ORGANIZATION_CONTRACT.md diff --git a/docs_build/dev/specs/PLATFORM_DATA_OWNERSHIP_MODEL.md b/docs_build/dev/ProjectInstructions/standards/PLATFORM_DATA_OWNERSHIP_MODEL.md similarity index 100% rename from docs_build/dev/specs/PLATFORM_DATA_OWNERSHIP_MODEL.md rename to docs_build/dev/ProjectInstructions/standards/PLATFORM_DATA_OWNERSHIP_MODEL.md diff --git a/docs_build/dev/specs/PROJECTWORKSPACE_VALIDATION_BOUNDARIES.md b/docs_build/dev/ProjectInstructions/standards/PROJECTWORKSPACE_VALIDATION_BOUNDARIES.md similarity index 100% rename from docs_build/dev/specs/PROJECTWORKSPACE_VALIDATION_BOUNDARIES.md rename to docs_build/dev/ProjectInstructions/standards/PROJECTWORKSPACE_VALIDATION_BOUNDARIES.md diff --git a/docs_build/dev/specs/PROJECT_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/PROJECT_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/PROJECT_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/PROJECT_CONTRACT.md diff --git a/docs_build/dev/specs/PROJECT_LIFECYCLE_MODEL.md b/docs_build/dev/ProjectInstructions/standards/PROJECT_LIFECYCLE_MODEL.md similarity index 100% rename from docs_build/dev/specs/PROJECT_LIFECYCLE_MODEL.md rename to docs_build/dev/ProjectInstructions/standards/PROJECT_LIFECYCLE_MODEL.md diff --git a/docs_build/dev/specs/PROJECT_TYPE_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/PROJECT_TYPE_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/PROJECT_TYPE_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/PROJECT_TYPE_CONTRACT.md diff --git a/docs_build/dev/specs/PROJECT_WORKSPACE_RUNTIME_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/PROJECT_WORKSPACE_RUNTIME_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/PROJECT_WORKSPACE_RUNTIME_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/PROJECT_WORKSPACE_RUNTIME_CONTRACT.md diff --git a/docs_build/dev/specs/PUBLISH_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/PUBLISH_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/PUBLISH_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/PUBLISH_CONTRACT.md diff --git a/docs_build/dev/ProjectInstructions/standards/README.md b/docs_build/dev/ProjectInstructions/standards/README.md new file mode 100644 index 000000000..0d34c10ac --- /dev/null +++ b/docs_build/dev/ProjectInstructions/standards/README.md @@ -0,0 +1,10 @@ +# Project Standards + +This folder contains active contract, model, and platform standards that belong to the Project Instructions source of truth. + +Rules: + +- Standards here are active governance. +- Generated validation evidence belongs under `docs_build/dev/reports/`. +- Historical reference material belongs under the root `archive/` tree. +- Reusable PR templates belong under `docs_build/dev/PR/templates/`. diff --git a/docs_build/dev/specs/RELEASE_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/RELEASE_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/RELEASE_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/RELEASE_CONTRACT.md diff --git a/docs_build/dev/specs/RESTORE_SNAPSHOT_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/RESTORE_SNAPSHOT_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/RESTORE_SNAPSHOT_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/RESTORE_SNAPSHOT_CONTRACT.md diff --git a/docs_build/dev/specs/REVIEW_RATING_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/REVIEW_RATING_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/REVIEW_RATING_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/REVIEW_RATING_CONTRACT.md diff --git a/docs_build/dev/toolbox/server-dashboard/README.md b/docs_build/dev/ProjectInstructions/standards/SERVER_DASHBOARD_FOUNDATION.md similarity index 95% rename from docs_build/dev/toolbox/server-dashboard/README.md rename to docs_build/dev/ProjectInstructions/standards/SERVER_DASHBOARD_FOUNDATION.md index 941ccaa3d..8e9036a1f 100644 --- a/docs_build/dev/toolbox/server-dashboard/README.md +++ b/docs_build/dev/ProjectInstructions/standards/SERVER_DASHBOARD_FOUNDATION.md @@ -1,8 +1,3 @@ -Toolbox Aid -David Quesenberry -04/06/2026 -docs_build/dev/toolbox/server-dashboard/README.md - # Server Dashboard Foundation (Docs-First) ## Purpose diff --git a/docs_build/dev/specs/TOOL_LAUNCH_SSOT.md b/docs_build/dev/ProjectInstructions/standards/TOOL_LAUNCH_SSOT.md similarity index 100% rename from docs_build/dev/specs/TOOL_LAUNCH_SSOT.md rename to docs_build/dev/ProjectInstructions/standards/TOOL_LAUNCH_SSOT.md diff --git a/docs_build/dev/specs/TOOL_STATE_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/TOOL_STATE_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/TOOL_STATE_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/TOOL_STATE_CONTRACT.md diff --git a/docs_build/dev/specs/UPDATE_CHANNEL_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/UPDATE_CHANNEL_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/UPDATE_CHANNEL_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/UPDATE_CHANNEL_CONTRACT.md diff --git a/docs_build/dev/specs/VERSION_COMPATIBILITY_CONTRACT.md b/docs_build/dev/ProjectInstructions/standards/VERSION_COMPATIBILITY_CONTRACT.md similarity index 100% rename from docs_build/dev/specs/VERSION_COMPATIBILITY_CONTRACT.md rename to docs_build/dev/ProjectInstructions/standards/VERSION_COMPATIBILITY_CONTRACT.md diff --git a/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup.md b/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup.md new file mode 100644 index 000000000..b8212fe30 --- /dev/null +++ b/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup.md @@ -0,0 +1 @@ +# PR_26177_OWNER_008-dev-documentation-ownership-cleanup Date: 2026-06-26 Branch: PR_26177_OWNER_008-dev-documentation-ownership-cleanup Scope: Documentation ownership cleanup after ProjectInstructions consolidation Status: PASS ## Summary - Enforced docs_build/dev/ProjectInstructions/ as the active governance, team instruction, standards, and addendum owner. - Renamed the lower-case PR documentation area into canonical docs_build/dev/PR/. - Added docs_build/dev/PR/README.md, reusable templates/, and historical examples/. - Moved reusable PR checklist material into docs_build/dev/PR/templates/. - Moved historical/example PR documents into docs_build/dev/PR/examples/. - Moved contract/model/platform specs into docs_build/dev/ProjectInstructions/standards/. - Moved historical roadmaps, admin notes, and ProjectInstructions archive snapshots into root archive/. - Removed duplicate root project-instructions/addendums/ files; retained only the deprecated pointer README. - Added docs_build/dev/reports/documentation-ownership-report.md. - No runtime/product/API/database files changed. ## Validation - PASS: branch validation. - PASS: ownership folder checks. - PASS: no active duplicate ProjectInstructions tracked outside active source, except protected/deprecated pointers noted in reports. - PASS: no reusable PR templates outside docs_build/dev/PR/templates/. - PASS: no generated reports outside docs_build/dev/reports/. - PASS: no runtime/product/API/database files changed. - PASS: git diff --check. - PASS: Playwright not impacted. ## Artifact - tmp/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_delta.zip diff --git a/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_branch-validation.md b/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_branch-validation.md new file mode 100644 index 000000000..11471a1ae --- /dev/null +++ b/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_branch-validation.md @@ -0,0 +1 @@ +# Branch Validation - PR_26177_OWNER_008-dev-documentation-ownership-cleanup Status: PASS - PASS: Current branch is PR_26177_OWNER_008-dev-documentation-ownership-cleanup. - PASS: Branch was created from synchronized main at published EOD SHA c8c2cc2c3ab5cf4f5c9ba62efaa686d8b750eb06. - PASS: Work remained on the PR branch during implementation. - PASS: No commits were made on main. - PASS: Scope is documentation/governance ownership cleanup only. diff --git a/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_manual-validation-notes.md b/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_manual-validation-notes.md new file mode 100644 index 000000000..397d31965 --- /dev/null +++ b/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_manual-validation-notes.md @@ -0,0 +1 @@ +# Manual Validation Notes - PR_26177_OWNER_008-dev-documentation-ownership-cleanup Status: PASS - Reviewed current docs_build/dev ownership surfaces before moving files. - Confirmed docs_build/dev/pr/PLAN_PR.md and BUILD_PR.md were OWNER_007 examples, not reusable blank templates. - Created generic reusable PR templates under docs_build/dev/PR/templates/. - Moved historical PR docs into docs_build/dev/PR/examples/. - Moved specs into active ProjectInstructions standards. - Moved admin notes, roadmaps, and ProjectInstructions archive snapshots to root archive as reference material. - Left docs_build/dev/start_of_day/ untouched as protected legacy handoff material. - Confirmed no runtime/product/API/database files were changed. diff --git a/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_requirement-checklist.md b/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_requirement-checklist.md new file mode 100644 index 000000000..7e6fbea88 --- /dev/null +++ b/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_requirement-checklist.md @@ -0,0 +1 @@ +# Requirement Checklist - PR_26177_OWNER_008-dev-documentation-ownership-cleanup Status: PASS - PASS: Current branch, clean worktree, main sync, and EOD SHA were validated before branch creation. - PASS: docs_build/dev/pr/ was renamed into canonical docs_build/dev/PR/ ownership area. - PASS: docs_build/dev/PR/README.md exists. - PASS: docs_build/dev/PR/templates/PLAN_PR.md exists. - PASS: docs_build/dev/PR/templates/BUILD_PR.md exists. - PASS: docs_build/dev/PR/examples/ exists. - PASS: Reusable PR checklist moved into docs_build/dev/PR/templates/. - PASS: Historical/example PR documents moved into docs_build/dev/PR/examples/. - PASS: Active standards moved into docs_build/dev/ProjectInstructions/standards/. - PASS: Documentation ownership governance added to ProjectInstructions. - PASS: Generated reports remain under docs_build/dev/reports/. - PASS: Historical reference material moved to root archive/. - PASS: No runtime changes. - PASS: No product changes. - PASS: No API changes. - PASS: No database changes. diff --git a/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_validation-lane.md b/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_validation-lane.md new file mode 100644 index 000000000..85013591e --- /dev/null +++ b/docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_validation-lane.md @@ -0,0 +1 @@ +# Validation Lane - PR_26177_OWNER_008-dev-documentation-ownership-cleanup Status: PASS Commands run: - git branch --show-current - git status --short --branch --untracked-files=all - git rev-list --left-right --count main...origin/main - git rev-parse HEAD - rg --files docs_build/dev/PR/templates - rg --files docs_build/dev/ProjectInstructions/standards - python docs ownership path checks - git diff --name-only origin/main -- src assets toolbox games api serverside package.json package-lock.json db database supabase migrations tests scripts - git diff --check Results: - PASS: Current branch is PR_26177_OWNER_008-dev-documentation-ownership-cleanup. - PASS: docs_build/dev/PR/templates/ contains reusable PR templates. - PASS: docs_build/dev/ProjectInstructions/standards/ contains active standards. - PASS: old tracked lower-case/loose owner paths have zero tracked files. - PASS: runtime/product/API/database changed-file check returned no files. - PASS: git diff --check returned no whitespace errors. - PASS: Playwright not run because no runtime/product files changed. diff --git a/docs_build/dev/reports/codex_changed_files.txt b/docs_build/dev/reports/codex_changed_files.txt index d23a0452b..410d1372d 100644 --- a/docs_build/dev/reports/codex_changed_files.txt +++ b/docs_build/dev/reports/codex_changed_files.txt @@ -1,87 +1,164 @@ -R100 docs_build/dev/dod/tool_ui_readiness_dod.md archive/docs_build/dev/dod/tool_ui_readiness_dod.md -R100 docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE.md archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE.md -R100 docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_APPEND.md archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_APPEND.md -R100 docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE.md archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE.md -R100 docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE_8_19.md archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE_8_19.md -R100 docs_build/dev/roadmaps/MASTER_ROADMAP_RECOVERY.md archive/docs_build/dev/roadmaps/MASTER_ROADMAP_RECOVERY.md -R100 docs_build/dev/roadmaps/MASTER_ROADMAP_SAMPLES2TOOLS.md archive/docs_build/dev/roadmaps/MASTER_ROADMAP_SAMPLES2TOOLS.md -R100 docs_build/dev/roadmaps/MASTER_ROADMAP_TOOLS.md archive/docs_build/dev/roadmaps/MASTER_ROADMAP_TOOLS.md -R100 docs_build/dev/roadmaps/MIDI_STUDIO_V2_ROADMAP.md archive/docs_build/dev/roadmaps/MIDI_STUDIO_V2_ROADMAP.md -R100 docs_build/dev/roadmaps/README.md archive/docs_build/dev/roadmaps/README.md -R100 docs_build/dev/roadmaps/phases.txt archive/docs_build/dev/roadmaps/phases.txt -D docs_build/dev/BUILD_PR.md -D docs_build/dev/BUILD_PR_LEVEL_10_6B_STANDALONE_SAMPLE_GENERIC_FAILURE_CLOSEOUT.md -D docs_build/dev/NEXT_RESTART.md -D docs_build/dev/PLAN_PR.md -D docs_build/dev/PLAN_PR_LEVEL_10_6B_STANDALONE_SAMPLE_GENERIC_FAILURE_CLOSEOUT.md -D docs_build/dev/PROJECT_INSTRUCTIONS.md -D docs_build/dev/PROJECT_MULTI_PC.txt +A archive/docs_build/dev/ProjectInstructions/archive/README.md +R100 docs_build/dev/ProjectInstructions/archive/history/.gitkeep archive/docs_build/dev/ProjectInstructions/archive/history/.gitkeep +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_144555.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_144555.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_153126.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_153126.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_153759.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_153759.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_154153.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_154153.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_154830.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_154830.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_155907.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_155907.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_161414.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_161414.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_161520.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_161520.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_161703.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_161703.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_163009.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_163009.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_231154.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_231154.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_231757.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_231757.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_233733.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_233733.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_235757.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_235757.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260621_235932.md archive/docs_build/dev/ProjectInstructions/archive/history/20260621_235932.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260622_000449.md archive/docs_build/dev/ProjectInstructions/archive/history/20260622_000449.md +R100 docs_build/dev/ProjectInstructions/archive/history/20260622_002424.md archive/docs_build/dev/ProjectInstructions/archive/history/20260622_002424.md +R100 docs_build/dev/admin-notes/BusinessPlan.txt archive/docs_build/dev/admin-notes/BusinessPlan.txt +R100 docs_build/dev/admin-notes/GFS-AI-Credits-Reseller-Strategy.pdf archive/docs_build/dev/admin-notes/GFS-AI-Credits-Reseller-Strategy.pdf +R100 docs_build/dev/admin-notes/GFS-Connected-Play-Second-Screen-Turn-Based-Design-26170-001.pdf archive/docs_build/dev/admin-notes/GFS-Connected-Play-Second-Screen-Turn-Based-Design-26170-001.pdf +R100 docs_build/dev/admin-notes/GFS_Design_Messages_Tool_And_Platform_Reference_Rules.pdf archive/docs_build/dev/admin-notes/GFS_Design_Messages_Tool_And_Platform_Reference_Rules.pdf +R100 docs_build/dev/admin-notes/GFS_Game_Identity_Strategy.pdf.pdf archive/docs_build/dev/admin-notes/GFS_Game_Identity_Strategy.pdf.pdf +R100 docs_build/dev/admin-notes/GFS_Game_Journey_Master_Plan.txt archive/docs_build/dev/admin-notes/GFS_Game_Journey_Master_Plan.txt +R100 docs_build/dev/admin-notes/Installs required.txt archive/docs_build/dev/admin-notes/Installs required.txt +R100 docs_build/dev/admin-notes/PS_commands.txt archive/docs_build/dev/admin-notes/PS_commands.txt +R100 docs_build/dev/admin-notes/Table layout.txt archive/docs_build/dev/admin-notes/Table layout.txt +R100 docs_build/dev/admin-notes/admin/index.txt archive/docs_build/dev/admin-notes/admin/index.txt +R100 docs_build/dev/admin-notes/colors/colos.txt archive/docs_build/dev/admin-notes/colors/colos.txt +R100 docs_build/dev/admin-notes/colors/index.txt archive/docs_build/dev/admin-notes/colors/index.txt +R100 docs_build/dev/admin-notes/deployment-uat-prod/index.txt archive/docs_build/dev/admin-notes/deployment-uat-prod/index.txt +R100 docs_build/dev/admin-notes/email/index.txt archive/docs_build/dev/admin-notes/email/index.txt +R100 docs_build/dev/admin-notes/engine/GameLoop.txt archive/docs_build/dev/admin-notes/engine/GameLoop.txt +R100 docs_build/dev/admin-notes/engine/ProjectDifficulty.txt archive/docs_build/dev/admin-notes/engine/ProjectDifficulty.txt +R100 docs_build/dev/admin-notes/engine/ProjectLifeCycle.txt archive/docs_build/dev/admin-notes/engine/ProjectLifeCycle.txt +R100 docs_build/dev/admin-notes/engine/index.txt archive/docs_build/dev/admin-notes/engine/index.txt +R100 docs_build/dev/admin-notes/fonts/index.txt archive/docs_build/dev/admin-notes/fonts/index.txt +R100 docs_build/dev/admin-notes/index.txt archive/docs_build/dev/admin-notes/index.txt +R100 docs_build/dev/admin-notes/notes/index.txt archive/docs_build/dev/admin-notes/notes/index.txt +R100 docs_build/dev/admin-notes/other/index.txt archive/docs_build/dev/admin-notes/other/index.txt +R100 docs_build/dev/admin-notes/roadmap2MVP.txt archive/docs_build/dev/admin-notes/roadmap2MVP.txt +R100 docs_build/dev/admin-notes/sample.txt archive/docs_build/dev/admin-notes/sample.txt +R100 docs_build/dev/admin-notes/tools/ObjectConfigurationRules.txt archive/docs_build/dev/admin-notes/tools/ObjectConfigurationRules.txt +R100 docs_build/dev/admin-notes/tools/TestDebug.txt archive/docs_build/dev/admin-notes/tools/TestDebug.txt +R100 docs_build/dev/admin-notes/tools/Tools.txt archive/docs_build/dev/admin-notes/tools/Tools.txt +R100 docs_build/dev/admin-notes/tools/achievements.txt archive/docs_build/dev/admin-notes/tools/achievements.txt +R100 docs_build/dev/admin-notes/tools/edit_input.txt archive/docs_build/dev/admin-notes/tools/edit_input.txt +R100 docs_build/dev/admin-notes/tools/game config.txt archive/docs_build/dev/admin-notes/tools/game config.txt +R100 docs_build/dev/admin-notes/tools/game design.txt archive/docs_build/dev/admin-notes/tools/game design.txt +R100 docs_build/dev/admin-notes/tools/game publisher.txt archive/docs_build/dev/admin-notes/tools/game publisher.txt +R098 docs_build/dev/admin-notes/tools/index.txt archive/docs_build/dev/admin-notes/tools/index.txt +R100 docs_build/dev/roadmaps/MASTER_ROADMAP_FEATURES.md archive/docs_build/dev/roadmaps/MASTER_ROADMAP_FEATURES.md +R100 docs_build/dev/roadmaps/MASTER_ROADMAP_STYLE.md archive/docs_build/dev/roadmaps/MASTER_ROADMAP_STYLE.md +R100 docs_build/dev/roadmaps/POST_MIGRATION_PLATFORM_ROADMAP.md archive/docs_build/dev/roadmaps/POST_MIGRATION_PLATFORM_ROADMAP.md +D assets/toolbox/hitboxes/js/index.js +A docs_build/dev/PR/README.md +R100 docs_build/dev/pr/BUILD_PR.md docs_build/dev/PR/examples/OWNER_007_BUILD_PR.md +R100 docs_build/dev/pr/PLAN_PR.md docs_build/dev/PR/examples/OWNER_007_PLAN_PR.md +A docs_build/dev/PR/examples/README.md +R100 docs_build/dev/pr/plan_pr_tool_workspace_manifest_boundaries.md docs_build/dev/PR/examples/plan_pr_tool_workspace_manifest_boundaries.md +R100 docs_build/dev/pr/pr_koti_layout_contract.md docs_build/dev/PR/examples/pr_koti_layout_contract.md +R100 docs_build/dev/pr/pr_tool_fix_asset_browser_1505.md docs_build/dev/PR/examples/pr_tool_fix_asset_browser_1505.md +R100 docs_build/dev/pr/pr_tool_fix_fullscreen_exit_state.md docs_build/dev/PR/examples/pr_tool_fix_fullscreen_exit_state.md +R100 docs_build/dev/pr/pr_tool_fix_parallax_header_metadata.md docs_build/dev/PR/examples/pr_tool_fix_parallax_header_metadata.md +R100 docs_build/dev/pr/pr_tool_header_singleline.md docs_build/dev/PR/examples/pr_tool_header_singleline.md +R100 docs_build/dev/pr/pr_tool_interactive_uat.md docs_build/dev/PR/examples/pr_tool_interactive_uat.md +R100 docs_build/dev/pr/pr_tool_layout_workflow_baseline.md docs_build/dev/PR/examples/pr_tool_layout_workflow_baseline.md +R100 docs_build/dev/pr/pr_tool_remove_future_import_hints.md docs_build/dev/PR/examples/pr_tool_remove_future_import_hints.md +R100 docs_build/dev/pr/pr_tool_remove_static_header_intro.md docs_build/dev/PR/examples/pr_tool_remove_static_header_intro.md +R100 docs_build/dev/pr/pr_tool_stabilization.md docs_build/dev/PR/examples/pr_tool_stabilization.md +R100 docs_build/dev/pr/pr_tool_uat_closeout.md docs_build/dev/PR/examples/pr_tool_uat_closeout.md +R100 docs_build/dev/pr/pr_tool_uat_fix_fullscreen_header_wiring.md docs_build/dev/PR/examples/pr_tool_uat_fix_fullscreen_header_wiring.md +R100 docs_build/dev/pr/pr_tool_uat_fix_header_asset_browser.md docs_build/dev/PR/examples/pr_tool_uat_fix_header_asset_browser.md +R100 docs_build/dev/pr/pr_tool_uat_fixes.md docs_build/dev/PR/examples/pr_tool_uat_fixes.md +A docs_build/dev/PR/templates/BUILD_PR.md +A docs_build/dev/PR/templates/PLAN_PR.md +R100 docs_build/dev/templates/pr_capability_bundle_checklist.md docs_build/dev/PR/templates/pr_capability_bundle_checklist.md M docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md M docs_build/dev/ProjectInstructions/README.txt -M docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md -A docs_build/dev/ProjectInstructions/addendums/assistant_execution_modes.md -M docs_build/dev/ProjectInstructions/addendums/branch_context_governance.md -M docs_build/dev/ProjectInstructions/addendums/branch_lock_governance.md -A docs_build/dev/ProjectInstructions/addendums/canonical_repository_structure.md -A docs_build/dev/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md -A docs_build/dev/ProjectInstructions/addendums/codex_project_instructions_startup.md -R100 docs_build/dev/koti_layout_contract.md docs_build/dev/ProjectInstructions/addendums/koti_layout_contract.md -A docs_build/dev/ProjectInstructions/addendums/legacy_migration_policy.md -M docs_build/dev/ProjectInstructions/addendums/multi_team.md -A docs_build/dev/ProjectInstructions/addendums/no_mock_repository_runtime_source.md -M docs_build/dev/ProjectInstructions/addendums/pr_workflow.md -M docs_build/dev/ProjectInstructions/addendums/preservation.md -A docs_build/dev/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md +M docs_build/dev/ProjectInstructions/addendums/codex_project_instructions_startup.md +A docs_build/dev/ProjectInstructions/addendums/documentation_ownership.md +M docs_build/dev/ProjectInstructions/addendums/project_reference_files.md M docs_build/dev/ProjectInstructions/addendums/release_gate.md -R100 docs_build/dev/samples2tools_adapter_guidance.md docs_build/dev/ProjectInstructions/addendums/samples2tools_adapter_guidance.md -M docs_build/dev/ProjectInstructions/addendums/team_release_readiness.md -M docs_build/dev/ProjectInstructions/addendums/team_start_and_release.md -A docs_build/dev/ProjectInstructions/addendums/test_structure_standardization.md -A docs_build/dev/ProjectInstructions/addendums/tool_mvp_stacked_pr_standard.md -R100 docs_build/dev/workspace_v2_playwright_gate.md docs_build/dev/ProjectInstructions/addendums/workspace_v2_playwright_gate.md -M docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md -D docs_build/dev/bundle_readme.md -D docs_build/dev/codex_commands.md -D docs_build/dev/codex_rules.md -D docs_build/dev/commit_comment.txt -A docs_build/dev/pr/BUILD_PR.md -A docs_build/dev/pr/PLAN_PR.md -R100 docs_build/dev/plan_pr_tool_workspace_manifest_boundaries.md docs_build/dev/pr/plan_pr_tool_workspace_manifest_boundaries.md -R096 docs_build/dev/pr_koti_layout_contract.md docs_build/dev/pr/pr_koti_layout_contract.md -R100 docs_build/dev/pr_tool_fix_asset_browser_1505.md docs_build/dev/pr/pr_tool_fix_asset_browser_1505.md -R100 docs_build/dev/pr_tool_fix_fullscreen_exit_state.md docs_build/dev/pr/pr_tool_fix_fullscreen_exit_state.md -R100 docs_build/dev/pr_tool_fix_parallax_header_metadata.md docs_build/dev/pr/pr_tool_fix_parallax_header_metadata.md -R100 docs_build/dev/pr_tool_header_singleline.md docs_build/dev/pr/pr_tool_header_singleline.md -R100 docs_build/dev/pr_tool_interactive_uat.md docs_build/dev/pr/pr_tool_interactive_uat.md -R100 docs_build/dev/pr_tool_layout_workflow_baseline.md docs_build/dev/pr/pr_tool_layout_workflow_baseline.md -R100 docs_build/dev/pr_tool_remove_future_import_hints.md docs_build/dev/pr/pr_tool_remove_future_import_hints.md -R100 docs_build/dev/pr_tool_remove_static_header_intro.md docs_build/dev/pr/pr_tool_remove_static_header_intro.md -R100 docs_build/dev/pr_tool_stabilization.md docs_build/dev/pr/pr_tool_stabilization.md -R100 docs_build/dev/pr_tool_uat_closeout.md docs_build/dev/pr/pr_tool_uat_closeout.md -R100 docs_build/dev/pr_tool_uat_fix_fullscreen_header_wiring.md docs_build/dev/pr/pr_tool_uat_fix_fullscreen_header_wiring.md -R100 docs_build/dev/pr_tool_uat_fix_header_asset_browser.md docs_build/dev/pr/pr_tool_uat_fix_header_asset_browser.md -R100 docs_build/dev/pr_tool_uat_fixes.md docs_build/dev/pr/pr_tool_uat_fixes.md -A docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock.md -A docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock_branch-validation.md -A docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock_manual-validation-notes.md -A docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock_requirement-checklist.md -A docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock_validation-lane.md -R100 docs_build/dev/component-audit.md docs_build/dev/reports/audits/component-audit.md -R100 docs_build/dev/css-audit.md docs_build/dev/reports/audits/css-audit.md -R100 docs_build/dev/security-audit.md docs_build/dev/reports/audits/security-audit.md +D docs_build/dev/ProjectInstructions/archive/README.md +R100 docs_build/dev/specs/AUDIT_EVENT_CONTRACT.md docs_build/dev/ProjectInstructions/standards/AUDIT_EVENT_CONTRACT.md +R100 docs_build/dev/specs/BACKUP_SNAPSHOT_CONTRACT.md docs_build/dev/ProjectInstructions/standards/BACKUP_SNAPSHOT_CONTRACT.md +R100 docs_build/dev/specs/COLLABORATION_ROLE_CONTRACT.md docs_build/dev/ProjectInstructions/standards/COLLABORATION_ROLE_CONTRACT.md +R100 docs_build/dev/specs/CREATOR_PROFILE_CONTRACT.md docs_build/dev/ProjectInstructions/standards/CREATOR_PROFILE_CONTRACT.md +R100 docs_build/dev/specs/DOWNLOAD_GRANT_CONTRACT.md docs_build/dev/ProjectInstructions/standards/DOWNLOAD_GRANT_CONTRACT.md +R100 docs_build/dev/specs/ENTITLEMENT_CONTRACT.md docs_build/dev/ProjectInstructions/standards/ENTITLEMENT_CONTRACT.md +R100 docs_build/dev/specs/GAME_MANIFEST_CONTRACT.md docs_build/dev/ProjectInstructions/standards/GAME_MANIFEST_CONTRACT.md +R100 docs_build/dev/specs/IDENTITY_PERMISSIONS_CONTRACT.md docs_build/dev/ProjectInstructions/standards/IDENTITY_PERMISSIONS_CONTRACT.md +R100 docs_build/dev/specs/IDENTITY_PERMISSIONS_MODEL.md docs_build/dev/ProjectInstructions/standards/IDENTITY_PERMISSIONS_MODEL.md +R100 docs_build/dev/specs/INSTALL_RECEIPT_CONTRACT.md docs_build/dev/ProjectInstructions/standards/INSTALL_RECEIPT_CONTRACT.md +R100 docs_build/dev/specs/LAUNCHER_PAIRING_CONTRACT.md docs_build/dev/ProjectInstructions/standards/LAUNCHER_PAIRING_CONTRACT.md +R100 docs_build/dev/specs/LIBRARY_ITEM_CONTRACT.md docs_build/dev/ProjectInstructions/standards/LIBRARY_ITEM_CONTRACT.md +R100 docs_build/dev/specs/MARKETPLACE_LISTING_CONTRACT.md docs_build/dev/ProjectInstructions/standards/MARKETPLACE_LISTING_CONTRACT.md +R100 docs_build/dev/specs/MARKETPLACE_TRANSACTION_BOUNDARY_CONTRACT.md docs_build/dev/ProjectInstructions/standards/MARKETPLACE_TRANSACTION_BOUNDARY_CONTRACT.md +R100 docs_build/dev/specs/MIGRATION_PLAN_CONTRACT.md docs_build/dev/ProjectInstructions/standards/MIGRATION_PLAN_CONTRACT.md +R100 docs_build/dev/specs/MODERATION_QUEUE_CONTRACT.md docs_build/dev/ProjectInstructions/standards/MODERATION_QUEUE_CONTRACT.md +R100 docs_build/dev/specs/NOTIFICATION_CONTRACT.md docs_build/dev/ProjectInstructions/standards/NOTIFICATION_CONTRACT.md +R100 docs_build/dev/specs/ORGANIZATION_CONTRACT.md docs_build/dev/ProjectInstructions/standards/ORGANIZATION_CONTRACT.md +R100 docs_build/dev/specs/PLATFORM_DATA_OWNERSHIP_MODEL.md docs_build/dev/ProjectInstructions/standards/PLATFORM_DATA_OWNERSHIP_MODEL.md +R100 docs_build/dev/specs/PROJECTWORKSPACE_VALIDATION_BOUNDARIES.md docs_build/dev/ProjectInstructions/standards/PROJECTWORKSPACE_VALIDATION_BOUNDARIES.md +R100 docs_build/dev/specs/PROJECT_CONTRACT.md docs_build/dev/ProjectInstructions/standards/PROJECT_CONTRACT.md +R100 docs_build/dev/specs/PROJECT_LIFECYCLE_MODEL.md docs_build/dev/ProjectInstructions/standards/PROJECT_LIFECYCLE_MODEL.md +R100 docs_build/dev/specs/PROJECT_TYPE_CONTRACT.md docs_build/dev/ProjectInstructions/standards/PROJECT_TYPE_CONTRACT.md +R100 docs_build/dev/specs/PROJECT_WORKSPACE_RUNTIME_CONTRACT.md docs_build/dev/ProjectInstructions/standards/PROJECT_WORKSPACE_RUNTIME_CONTRACT.md +R100 docs_build/dev/specs/PUBLISH_CONTRACT.md docs_build/dev/ProjectInstructions/standards/PUBLISH_CONTRACT.md +A docs_build/dev/ProjectInstructions/standards/README.md +R100 docs_build/dev/specs/RELEASE_CONTRACT.md docs_build/dev/ProjectInstructions/standards/RELEASE_CONTRACT.md +R100 docs_build/dev/specs/RESTORE_SNAPSHOT_CONTRACT.md docs_build/dev/ProjectInstructions/standards/RESTORE_SNAPSHOT_CONTRACT.md +R100 docs_build/dev/specs/REVIEW_RATING_CONTRACT.md docs_build/dev/ProjectInstructions/standards/REVIEW_RATING_CONTRACT.md +R095 docs_build/dev/toolbox/server-dashboard/README.md docs_build/dev/ProjectInstructions/standards/SERVER_DASHBOARD_FOUNDATION.md +R100 docs_build/dev/specs/TOOL_LAUNCH_SSOT.md docs_build/dev/ProjectInstructions/standards/TOOL_LAUNCH_SSOT.md +R100 docs_build/dev/specs/TOOL_STATE_CONTRACT.md docs_build/dev/ProjectInstructions/standards/TOOL_STATE_CONTRACT.md +R100 docs_build/dev/specs/UPDATE_CHANNEL_CONTRACT.md docs_build/dev/ProjectInstructions/standards/UPDATE_CHANNEL_CONTRACT.md +R100 docs_build/dev/specs/VERSION_COMPATIBILITY_CONTRACT.md docs_build/dev/ProjectInstructions/standards/VERSION_COMPATIBILITY_CONTRACT.md +D docs_build/dev/reports/PR_26177_DELTA_001-hitboxes-team-ownership_manual-validation-notes.md +D docs_build/dev/reports/PR_26177_DELTA_001-hitboxes-team-ownership_requirement-checklist.md +D docs_build/dev/reports/PR_26177_DELTA_001-hitboxes-team-ownership_validation-lane.md +D docs_build/dev/reports/PR_26177_DELTA_002-hitboxes-foundation.md +D docs_build/dev/reports/PR_26177_DELTA_002-hitboxes-foundation_branch-validation.md +D docs_build/dev/reports/PR_26177_DELTA_002-hitboxes-foundation_manual-validation-notes.md +D docs_build/dev/reports/PR_26177_DELTA_002-hitboxes-foundation_requirement-checklist.md +D docs_build/dev/reports/PR_26177_DELTA_002-hitboxes-foundation_validation-lane.md +D docs_build/dev/reports/PR_26177_DELTA_003-hitboxes-engine-collision-contract.md +D docs_build/dev/reports/PR_26177_DELTA_003-hitboxes-engine-collision-contract_branch-validation.md +D docs_build/dev/reports/PR_26177_DELTA_003-hitboxes-engine-collision-contract_manual-validation-notes.md +D docs_build/dev/reports/PR_26177_DELTA_003-hitboxes-engine-collision-contract_requirement-checklist.md +D docs_build/dev/reports/PR_26177_DELTA_003-hitboxes-engine-collision-contract_validation-lane.md +D docs_build/dev/reports/PR_26177_DELTA_004-hitboxes-real-object-source.md +D docs_build/dev/reports/PR_26177_DELTA_004-hitboxes-real-object-source_branch-validation.md +D docs_build/dev/reports/PR_26177_DELTA_004-hitboxes-real-object-source_manual-validation-notes.md +D docs_build/dev/reports/PR_26177_DELTA_004-hitboxes-real-object-source_requirement-checklist.md +D docs_build/dev/reports/PR_26177_DELTA_004-hitboxes-real-object-source_validation-lane.md +D docs_build/dev/reports/PR_26177_DELTA_005-hitboxes-testable-mvp.md +D docs_build/dev/reports/PR_26177_DELTA_005-hitboxes-testable-mvp_branch_validation.md +D docs_build/dev/reports/PR_26177_DELTA_005-hitboxes-testable-mvp_manual_validation.md +D docs_build/dev/reports/PR_26177_DELTA_005-hitboxes-testable-mvp_requirements_checklist.md +D docs_build/dev/reports/PR_26177_DELTA_005-hitboxes-testable-mvp_validation_lane.md +D docs_build/dev/reports/PR_26177_DELTA_hitboxes_chain_eod_2026-06-26.md +A docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_branch-validation.md +A docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_manual-validation-notes.md +A docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_requirement-checklist.md +A docs_build/dev/reports/PR_26177_OWNER_008-dev-documentation-ownership-cleanup_validation-lane.md M docs_build/dev/reports/codex_changed_files.txt M docs_build/dev/reports/codex_review.diff -A docs_build/dev/reports/legacy-docs-archive-report.md -D docs_build/dev/restart_notes_11_105.md -D docs_build/dev/restart_notes_11_110.md -D docs_build/dev/restart_notes_11_111.md -D docs_build/dev/restart_notes_11_112.md -D docs_build/dev/restart_notes_11_116.md -D docs_build/dev/restart_notes_11_118.md -D docs_build/dev/restart_notes_11_119.md -D docs_build/dev/restart_notes_11_120.md -D docs_build/dev/restart_notes_11_121.md -D docs_build/dev/restart_notes_11_122.md -D docs_build/dev/restart_notes_11_123.md -D docs_build/dev/validation_checklist.txt -A project-instructions/README.md +A docs_build/dev/reports/documentation-ownership-report.md +D project-instructions/addendums/assistant-execution-modes.md +D project-instructions/addendums/canonical-repository-structure.md +D project-instructions/addendums/codex-artifact-and-reporting-standard.md +D project-instructions/addendums/codex-project-instructions-startup.md +D project-instructions/addendums/legacy-migration-policy.md +D project-instructions/addendums/test-structure-standardization.md +M src/dev-runtime/persistence/mock-db-store.js +D src/dev-runtime/persistence/tool-repositories/hitboxes-mock-repository.js +M src/dev-runtime/server/local-api-router.mjs +D src/engine/collision/hitboxCollision.js +M src/shared/toolbox/tool-metadata-inventory.js +D tests/engine/HitboxCollisionContract.test.mjs +D tests/playwright/tools/HitboxesTool.spec.mjs +M toolbox/hitboxes/index.html diff --git a/docs_build/dev/reports/codex_review.diff b/docs_build/dev/reports/codex_review.diff index a6d98693c..2e24ca65a 100644 --- a/docs_build/dev/reports/codex_review.diff +++ b/docs_build/dev/reports/codex_review.diff @@ -1,5725 +1,4268 @@ -diff --git a/docs_build/dev/dod/tool_ui_readiness_dod.md b/archive/docs_build/dev/dod/tool_ui_readiness_dod.md -similarity index 100% -rename from docs_build/dev/dod/tool_ui_readiness_dod.md -rename to archive/docs_build/dev/dod/tool_ui_readiness_dod.md -diff --git a/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE.md b/archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE.md -similarity index 100% -rename from docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE.md -rename to archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE.md -diff --git a/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_APPEND.md b/archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_APPEND.md -similarity index 100% -rename from docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_APPEND.md -rename to archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_APPEND.md -diff --git a/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE.md b/archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE.md -similarity index 100% -rename from docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE.md -rename to archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE.md -diff --git a/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE_8_19.md b/archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE_8_19.md -similarity index 100% -rename from docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE_8_19.md -rename to archive/docs_build/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_UPDATE_8_19.md -diff --git a/docs_build/dev/roadmaps/MASTER_ROADMAP_RECOVERY.md b/archive/docs_build/dev/roadmaps/MASTER_ROADMAP_RECOVERY.md -similarity index 100% -rename from docs_build/dev/roadmaps/MASTER_ROADMAP_RECOVERY.md -rename to archive/docs_build/dev/roadmaps/MASTER_ROADMAP_RECOVERY.md -diff --git a/docs_build/dev/roadmaps/MASTER_ROADMAP_SAMPLES2TOOLS.md b/archive/docs_build/dev/roadmaps/MASTER_ROADMAP_SAMPLES2TOOLS.md -similarity index 100% -rename from docs_build/dev/roadmaps/MASTER_ROADMAP_SAMPLES2TOOLS.md -rename to archive/docs_build/dev/roadmaps/MASTER_ROADMAP_SAMPLES2TOOLS.md -diff --git a/docs_build/dev/roadmaps/MASTER_ROADMAP_TOOLS.md b/archive/docs_build/dev/roadmaps/MASTER_ROADMAP_TOOLS.md -similarity index 100% -rename from docs_build/dev/roadmaps/MASTER_ROADMAP_TOOLS.md -rename to archive/docs_build/dev/roadmaps/MASTER_ROADMAP_TOOLS.md -diff --git a/docs_build/dev/roadmaps/MIDI_STUDIO_V2_ROADMAP.md b/archive/docs_build/dev/roadmaps/MIDI_STUDIO_V2_ROADMAP.md -similarity index 100% -rename from docs_build/dev/roadmaps/MIDI_STUDIO_V2_ROADMAP.md -rename to archive/docs_build/dev/roadmaps/MIDI_STUDIO_V2_ROADMAP.md -diff --git a/docs_build/dev/roadmaps/README.md b/archive/docs_build/dev/roadmaps/README.md -similarity index 100% -rename from docs_build/dev/roadmaps/README.md -rename to archive/docs_build/dev/roadmaps/README.md -diff --git a/docs_build/dev/roadmaps/phases.txt b/archive/docs_build/dev/roadmaps/phases.txt -similarity index 100% -rename from docs_build/dev/roadmaps/phases.txt -rename to archive/docs_build/dev/roadmaps/phases.txt -diff --git a/docs_build/dev/BUILD_PR.md b/docs_build/dev/BUILD_PR.md -deleted file mode 100644 -index 30700e9cd..000000000 ---- a/docs_build/dev/BUILD_PR.md -+++ /dev/null -@@ -1,66 +0,0 @@ --# PR_26177_006-shared-time-foundation -- --## Purpose -- --Add a small shared time foundation. -- --## Source Of Truth -- --This `BUILD_PR.md`, `PLAN_PR.md`, and the user request are the source of truth for `PR_26177_006-shared-time-foundation`. -- --## Stack -- --- Base branch: `PR_26177_005-shared-text-foundation` -- --## Exact Scope -- --- Add `src/shared/time/` foundation. --- Include duration formatting, timestamp helpers, debounce/throttle/sleep helpers where safe for shared runtime. --- Add targeted tests for the shared time area. --- No scheduler/runtime behavior changes. --- Create required Codex reports under `docs_build/dev/reports/`. --- Create repo-structured delta ZIP under `tmp/`. -- --## Exact Targets -- --- `docs_build/dev/PLAN_PR.md` --- `docs_build/dev/BUILD_PR.md` --- `src/shared/time/time.js` --- `tests/shared/TimeFoundation.test.mjs` --- `docs_build/dev/reports/PR_26177_006-shared-time-foundation.md` --- `docs_build/dev/reports/PR_26177_006-shared-time-foundation_branch-validation.md` --- `docs_build/dev/reports/PR_26177_006-shared-time-foundation_requirement-checklist.md` --- `docs_build/dev/reports/PR_26177_006-shared-time-foundation_validation-lane.md` --- `docs_build/dev/reports/PR_26177_006-shared-time-foundation_manual-validation-notes.md` --- `docs_build/dev/reports/codex_review.diff` --- `docs_build/dev/reports/codex_changed_files.txt` -- --## Out Of Scope -- --- No scheduler/runtime behavior changes. --- No browser-owned product data. --- No runtime UI changes. --- No browser storage changes. --- No API/database changes. --- No `start_of_day` folder changes. --- No unrelated cleanup. --- No full samples smoke by default. -- --## Validation -- --Run exactly: -- --```powershell --node ./scripts/run-node-test-files.mjs tests/shared/TimeFoundation.test.mjs --node --check src/shared/time/time.js --node --check tests/shared/TimeFoundation.test.mjs --git diff --check --``` -- --## Artifact -- --Create repo-structured delta ZIP: -- --```text --tmp/PR_26177_006-shared-time-foundation_delta.zip --``` -diff --git a/docs_build/dev/BUILD_PR_LEVEL_10_6B_STANDALONE_SAMPLE_GENERIC_FAILURE_CLOSEOUT.md b/docs_build/dev/BUILD_PR_LEVEL_10_6B_STANDALONE_SAMPLE_GENERIC_FAILURE_CLOSEOUT.md -deleted file mode 100644 -index 3c6e356d5..000000000 ---- a/docs_build/dev/BUILD_PR_LEVEL_10_6B_STANDALONE_SAMPLE_GENERIC_FAILURE_CLOSEOUT.md -+++ /dev/null -@@ -1,64 +0,0 @@ --# BUILD_PR: LEVEL_10_6B_STANDALONE_SAMPLE_GENERIC_FAILURE_CLOSEOUT -- --## One-pass Codex build instruction --Implement the smallest valid changes needed to close remaining generic standalone sample/tool data-flow failures. -- --Use the existing failing report as the source of truth: -- --```text --docs_build/dev/reports/level_10_6_standalone_tool_data_flow_report.md --``` -- --Focus only on failures where a sample launches but the tool does not receive or bind the payload correctly. -- --## Implementation boundaries --Codex may edit only files needed for standalone sample contract stability, typically: -- --- affected `samples/phase-*/*` sample files --- affected `toolbox/*` tool entrypoints or adapters --- affected manifest/contract files already used by these samples --- the standalone data-flow test only if it currently reports a false generic failure without weakening coverage --- docs_build/dev reports for the new result -- --Codex must not implement unrelated features. -- --## Contract checks per tool --For every changed failing area, verify: -- --1. Sample declares explicit payload/manifest input. --2. Schema or normalized contract accepts the payload shape. --3. Tool receives the payload from the standalone launch path. --4. Tool renders safe empty state only when the input is truly absent. --5. Tool does not auto-load hidden defaults, demo assets, or hardcoded paths. --6. Test report captures the corrected behavior. -- --## Required validation commands --Run these from repo root: -- --```powershell --npm run test:launch-smoke:games --npm run test:sample-standalone:data-flow --``` -- --## Required output files --Update or create: -- --```text --docs_build/dev/reports/level_10_6b_standalone_generic_failure_closeout_report.md --docs_build/dev/reports/level_10_6b_tool_contract_matrix.md --``` -- --The closeout report must include: -- --- before generic failure count --- after generic failure count --- list of tools fixed --- list of tools still failing, if any --- exact validation commands run --- whether game launch smoke still passes -- --## Done criteria --- `npm run test:launch-smoke:games` passes. --- `npm run test:sample-standalone:data-flow` passes or materially reduces generic failures with a precise remaining list. --- No silent fallback data or hardcoded asset path was added. --- Roadmap status is advanced only through real validation-backed progress. -diff --git a/docs_build/dev/NEXT_RESTART.md b/docs_build/dev/NEXT_RESTART.md -deleted file mode 100644 -index e44fe0fc4..000000000 ---- a/docs_build/dev/NEXT_RESTART.md -+++ /dev/null -@@ -1,67 +0,0 @@ --# RESTART — PR 11.188 Palette Manager Tool v2 -- --## Open repo -- --```powershell --cd C:\Users\davidq\Documents\GitHub\HTML-JavaScript-Gaming --code . --``` -- --## Sync -- --```powershell --git status --git pull --``` -- --## Active PR -- --```text --BUILD_PR_LEVEL_11_188_PALETTE_MANAGER_REVERSE_ENGINEER_AND_REBUILD --``` -- --## Locked Direction -- --```text --Tool v2 lane only --Palette Manager first --No schema changes --No sample changes --No game changes --No Workspace Manager v1 wiring --No legacy tool patching --No toolbox/shared usage for new v2 code --No fallback/default data --``` -- --## Visible Name -- --```text --Palette Manager --``` -- --Do not show: -- --```text --Palette Browser / Manager --Palette Manager v2 --Palette Browser v2 --``` -- --## Required Header Rule -- --Use the header pattern from: -- --```text --/index.html --``` -- --Include an accordion to hide/show the header/details section. -- --## Next Execution -- --Run the Codex command in: -- --```text --docs_build/dev/codex_commands.md --``` -diff --git a/docs_build/dev/PLAN_PR.md b/docs_build/dev/PLAN_PR.md -deleted file mode 100644 -index 907936aee..000000000 ---- a/docs_build/dev/PLAN_PR.md -+++ /dev/null -@@ -1,22 +0,0 @@ --# PLAN_PR: PR_26177_006-shared-time-foundation -- --## Purpose -- --Add a small shared time foundation. -- --## Scope -- --- Add `src/shared/time/` foundation. --- Include duration formatting, timestamp helpers, sleep, debounce, and throttle helpers. --- Add targeted tests. --- No scheduler/runtime behavior changes. --- No browser-owned product data. --- No runtime UI changes. --- No unrelated cleanup. -- --## Implementation Plan -- --1. Add `src/shared/time/time.js`. --2. Add `tests/shared/TimeFoundation.test.mjs`. --3. Validate duration, timestamp, sleep, debounce, and throttle helpers. --4. Produce required Codex reports and repo-structured ZIP. -diff --git a/docs_build/dev/PLAN_PR_LEVEL_10_6B_STANDALONE_SAMPLE_GENERIC_FAILURE_CLOSEOUT.md b/docs_build/dev/PLAN_PR_LEVEL_10_6B_STANDALONE_SAMPLE_GENERIC_FAILURE_CLOSEOUT.md -deleted file mode 100644 -index f4a0ebc2c..000000000 ---- a/docs_build/dev/PLAN_PR_LEVEL_10_6B_STANDALONE_SAMPLE_GENERIC_FAILURE_CLOSEOUT.md -+++ /dev/null -@@ -1,64 +0,0 @@ --# PLAN_PR: LEVEL_10_6B_STANDALONE_SAMPLE_GENERIC_FAILURE_CLOSEOUT -- --## Purpose --Close the remaining generic failure signals in the standalone sample/tool data-flow contract test without adding new tools, schemas, or features. -- --## Roadmap phase --Phase 10 = TOOL + SAMPLE CONTRACT STABILITY -- --## Scope --Fix only standalone sample contract failures reported by: -- --```powershell --npm run test:sample-standalone:data-flow --``` -- --Target failing areas from the prior report: -- --- Asset Browser / Import Hub --- Asset Pipeline Tool --- Parallax Scene Studio --- Performance Profiler --- Physics Sandbox --- Replay Visualizer --- Palette binding --- State Inspector JSON input --- Tile Model Converter --- Tilemap Studio --- Vector Asset Studio --- Vector Map Editor -- --## Required rule --Every fix must preserve this contract chain: -- --```text --sample -> schema -> normalized input -> tool -> UI/state --``` -- --## Hard constraints --- Do not add silent fallback data. --- Do not add hardcoded asset paths. --- Do not hide failures by weakening assertions. --- Do not add new schemas unless an existing documented schema is missing from the sample contract path. --- Do not make repo-wide formatting or unrelated cleanup changes. --- Do not modify `start_of_day` folders. -- --## Debug priority --For each failure, answer this first: -- --```text --Did the tool receive the payload? --``` -- --Then check: -- --- payload shape --- binding slot --- manifest path --- stale route/path --- required field mismatch --- JSON validity --- UI state update after payload ingest -- --## Expected result --The PR is complete when the standalone data-flow test report shows fewer generic failure signals than before, with all changed tools receiving explicit sample payloads through the documented contract path. -diff --git a/docs_build/dev/PROJECT_INSTRUCTIONS.md b/docs_build/dev/PROJECT_INSTRUCTIONS.md -deleted file mode 100644 -index af9e9e2db..000000000 ---- a/docs_build/dev/PROJECT_INSTRUCTIONS.md -+++ /dev/null -@@ -1,2430 +0,0 @@ --# PROJECT INSTRUCTIONS -- --You are working in a docs-first repo workflow. -- --Workflow: --PLAN_PR → BUILD_PR → APPLY_PR -- --PR lifecycle gate: --PR Open → Plan → Build → Validation → Approved → Merged → Main Verified → Closed -- --The PLAN_PR → BUILD_PR → APPLY_PR workflow remains preserved. PR Open is the first lifecycle status for active work, Plan happens after PR Open on the same PR branch, and Closed is the final repository-state gate. -- --# WORKFLOW & EXECUTION -- --## PR NAMING STANDARD -- --PR names MUST follow: -- --`PR___<###>-` -- --Where: --- `YY` = year (2 digit) --- `JJJ` = Julian day (001-365) --- `TEAM` = required team ownership token from `docs_build/dev/PROJECT_MULTI_PC.txt` --- `###` = sequence for the day (001+) -- --Example: --- `PR_26171_ALPHA_065-message-studio-parent-child-table-foundation` --- `PR_26171_BETA_069-message-tts-profile-contract-alignment` --- `PR_26171_GAMMA_071-main-merge-conflict-recovery` -- --Branch names MUST mirror PR ownership: -- --`pr/--<###>-` -- --Branch examples: --- `pr/26171-ALPHA-065-message-studio-parent-child-table-foundation` --- `pr/26171-BETA-069-message-tts-profile-contract-alignment` --- `pr/26171-GAMMA-071-main-merge-conflict-recovery` -- --Rules: --- Must be unique per day --- Must be sortable --- `TEAM` is required --- `TEAM` ownership comes from `docs_build/dev/PROJECT_MULTI_PC.txt` --- Team ownership is independent of machine, workspace, laptop, desktop, or environment --- Description must be short and hyphenated --- Do NOT reuse old `PR_11_*` format for new PRs --- Existing PC/LAPTOP, desktop/laptop, workspace, environment, or machine-parity examples are historical only --- Future PR reports, recovery reports, validation reports, and manual validation notes must include TEAM ownership -- --## PR LIFECYCLE STATE GATE -- --Required state order: -- --1. PR Open --2. Plan --3. Build --4. Validation --5. Approved --6. Merged --7. Main Verified --8. Closed -- --Definitions: --- PR Open is the first active lifecycle state. --- PR Open means the tracked PR identity and source branch have been created and named before Plan begins. --- Plan happens after PR Open on the same PR branch. --- Build, validation, reports, ZIP packaging, and closeout stay tied to that same PR identity and source branch. --- No BUILD_PR may proceed without a PR name and active branch/PR identity unless it is explicitly marked `PLAN_ONLY`. --- Build means scoped implementation, audit, report, validation, governance, or cleanup work is in progress for that PR identity. --- Validation means requested checks, required report creation, manual validation notes, and ZIP packaging are being completed. --- Approved means the owner or required reviewer has approved the PR outcome for merge. --- Merged means the PR has merged and changes have been pushed. --- Main Verified means Codex is back on `main`, `main` includes the merge commit or recorded final commit, the worktree is clean, local/origin sync is `0/0`, and no untracked files remain. --- Closed means every Closed gate below is PASS. -- --Closed is valid only when all are PASS: --- PR merged and changes pushed. --- Current branch is `main`. --- `main` includes the merge commit or recorded final commit. --- Worktree clean. --- Local/origin sync is `0/0`. --- No untracked files. --- Branch disposition recorded as `retained`. --- Required reports exist. --- Required repo-structured ZIP under `tmp/` exists. --- Backlog updated. --- Tool state updated when applicable. -- --Hard stop: --- A team must not begin another PR if its previous PR is not Closed. --- Exception is allowed only for explicitly documented stacked PR chains. -- --Required final closeout output: -- --```text --FINAL REPOSITORY STATE: --- Branch --- Worktree --- Local/origin sync --- PR number/name --- PR status --- Merge/final commit --- Branch disposition --- Backlog update status --- Tool state update status --- ZIP path --- Closeout PASS/FAIL --``` -- --## CHATGPT EXECUTION ROLE -- --ChatGPT no longer creates PLAN_PR, BUILD_PR, APPLY_PR docs, ZIP bundles, or implementation code. -- --ChatGPT repo workflow response formatting is governed by `OUTPUT RULES` and the newest explicit ChatGPT workflow sections below. -- --ChatGPT must not: --- create ZIP files --- reference ZIP delivery --- produce PLAN/BUILD/APPLY docs --- write implementation code unless explicitly requested -- --## CODEX EXECUTION ROLE -- --Codex creates: --- PLAN_PR docs --- BUILD_PR docs --- APPLY_PR docs when needed --- repo-structured ZIP bundles --- implementation changes --- Playwright/test updates when required --- review artifacts for ChatGPT code review -- --Codex must place detailed content in: --- `docs_build/pr/*` --- `docs_build/dev/codex_commands.md` --- `docs_build/dev/commit_comment.txt` --- `docs_build/dev/reports/*` -- --## USER ROLE -- --User: --- runs Codex --- validates results --- commits approved changes --- uploads deltas/reports when ChatGPT review is needed -- --## RULES -- --- One PR purpose only --- Smallest scoped valid change --- BUILD must be one-pass executable --- No vague wording --- No repo-wide scanning unless required --- Do not expand scope beyond the PR --- Do not modify `start_of_day` folders unless requested -- --## MAIN BRANCH EXECUTION GUARD -- --Before any BUILD execution, Codex must verify the current git branch. -- --Rules: --- The required execution branch is: -- - `main` --- If the current branch is not `main`: -- - HARD STOP. -- - Do not create code changes. -- - Do not create implementation PRs. -- - Do not create ZIP artifacts. -- - Do not continue execution. --- Codex must report: -- - current branch -- - expected branch (`main`) -- - local branches found --- Codex may continue only after the user explicitly returns to `main`. -- --Exception: --- Explicit branch-audit or branch-comparison PRs may inspect non-main branches but must not perform implementation work on them. -- --Required report output: --- Current branch --- Branch validation PASS/FAIL -- --## SLIDER VALUE VISIBILITY REQUIREMENT -- --All user-adjustable slider controls must display their current value while being adjusted. -- --Rules: --- Value display must update live during drag/input. --- Creators must not need to release the slider to see the value. --- Value display must remain visible at all times. --- Value display must not rely solely on browser-native tooltips. --- Sliders should prefer: -- - Label + Slider + Current Value --- Example: -- - `Contrast [------^------] 40%` -- - `Saturation [------^------] 75%` -- - `Hue Shift [------^------] +15°` --- Units should be displayed when meaningful: -- - `%` -- - degrees -- - pixels -- - milliseconds -- - volume -- - opacity --- Floating thumb tooltips are optional. --- Persistent visible values are required. --- Applies to: -- - Toolbox tools -- - Game Hub controls -- - Account/Admin pages -- - Theme V2 controls -- - Future tools and pages -- --## SLIDER RESET BEHAVIOR REQUIREMENT -- --All user-adjustable sliders must support reset-to-default behavior. -- --Rules: --- Double-clicking a slider resets it to its default value. --- Reset must occur immediately. --- Reset value must be visible through the live value display. --- Creators must not need a separate reset button for individual sliders. --- Tool-specific Reset buttons may still exist for resetting multiple controls. --- Slider tooltips/help text should identify the default value when practical. --- Applies to: -- - Toolbox tools -- - Game Hub controls -- - Account/Admin pages -- - Theme V2 controls -- - Future tools and pages -- --## RULE PRECEDENCE -- --Newer appended sections override earlier overlapping rules. -- --When rules overlap, use the most specific current section as authoritative. -- --Conflicting workflow instructions must resolve to the newest explicit section. -- --Future governance additions should extend existing sections instead of duplicating overlapping guidance. -- --## GOVERNANCE CLOSEOUT -- --Docs-only PRs should prefer bundling with related docs/workflow cleanup when safe. -- --Stabilization/recovery lane rules supersede older generalized workflow assumptions. -- --Engine/tool/integration boundaries are authoritative for validation routing. -- --Hidden validation expansion is prohibited. -- --Workflow and testing language must not assume implicit persisted workspace, toolState, `localStorage`, `sessionStorage`, sample, or runtime state. -- --Required validation lane names are: --- contract --- runtime --- integration --- engine --- samples --- recovery/UAT -- --## PROJECT INSTRUCTIONS STABILITY AND MAINTENANCE MODE -- --`PROJECT_INSTRUCTIONS.md` is now considered architecturally stabilized. -- --Future additions should prefer targeted amendments instead of broad workflow rewrites. -- --New rules should extend existing authoritative sections whenever possible. -- --Avoid introducing parallel governance systems or duplicate rule sets. -- --Anti-drift governance: --- avoid capability drift across `src/`, deprecated `archive/v1-v2/tools/`, deprecated `archive/v1-v2/games/`, deprecated `archive/v1-v2/samples/`, and `toolbox/` --- avoid workflow drift across overlapping sections --- avoid validation drift between engine, tool, and integration lanes --- avoid UI/UX drift from Workspace V2 ecosystem contracts -- --Stabilization intent: --- governance exists to reduce monolith growth, hidden coupling, and duplicated runtime behavior --- reusable/shared capability should converge into `src/` --- first-class tools should converge toward shared Workspace V2 lifecycle behavior --- targeted validation is the preferred operational mode -- --Future guidance: --- future governance PRs should remain small and execution-backed --- implementation, runtime, and tool work should now take priority over additional governance expansion unless a real gap is discovered --- governance additions should solve demonstrated operational problems rather than hypothetical future issues -- --## NAVIGATION, LIST, AND TOOLBOX MODEL GOVERNANCE -- --Navigation menus, submenus, nested submenus, and user-facing lists must be alphabetically sorted when they are presented as browseable choices. -- --Primary top-level header navigation is an explicit product IA exception and must remain: --- Games --- Toolbox --- Marketplace --- Learn --- Account --- Admin -- --Allowed intentional-order exceptions: --- primary top-level header navigation --- Toolbox groups and tiles when they are presented as creator workflow surfaces --- workflow paths --- Build Path --- dependency paths --- Game Progress --- Launch Progress --- guided creator steps -- --Every intentional-order exception must be documented in the PR report that introduces or preserves it. -- --### Workflow Ordering Governance -- --When a surface represents a creator workflow, items are ordered by the likely next action, not alphabetically. --Workflow ordering is an approved exception to alphabetical ordering. --This applies to Toolbox, Game Hub, Create, Publish, Progress, and future guided workflows. -- --Rules: --- Order follows how users naturally work: -- - Select -> Create -> Review -- - Left -> Right -- - Top -> Bottom --- The next tile should represent the most likely next creator action. --- Tile ordering should minimize navigation decisions. -- --Create group order: --1. Game Hub --2. Game Crew --3. Game Configuration --4. Tags -- --Team planning distinction: --- Studio Team is the account-level roster. --- Game Crew is the game-level assignment surface. --- Current Toolbox implementation focus is Game Crew. --- Creator functionality that previously lived in Account/Team planning should be planned through Create/Game Crew when it is game-specific. -- --Toolbox status values are: --- Ready --- Wireframe --- Under Construction --- Planned --- Hidden --- Deprecated -- --Toolbox progress foundation fields are: --- `requiredForTestable` --- `requiredForPublish` --- `requires` --- `status` --- `progressChecklist` -- --Progress and Build Path views remain wireframe-only until a later implementation PR explicitly introduces a declared registry/data source and runtime behavior. -- --Game Hub is the next first real Toolbox rebuild target. Its contract owns: --- Project Identity --- Project Status --- Project Progress --- Launch Progress -- --Do not implement Game Hub runtime behavior, persistence, database behavior, authentication, or save/load flows before the rebuild PR explicitly scopes those capabilities. -- --## TOOL STATUS GOVERNANCE -- --The authoritative tool status values are: --- `planned` --- `wireframe` --- `beta` --- `complete` --- `deprecated` -- --Status definitions: --- `planned`: Not designed yet. No meaningful UI. No ownership defined. --- `wireframe`: Tool exists. User can understand workflow. Data ownership is defined. Not functionally usable. --- `beta`: Functionally usable. Can be used in a real game. May still contain incomplete workflows, placeholder data, UI cleanup issues, unused fields, missing validation, or incomplete code review. --- `complete`: Functionally usable. Code reviewed. Dead code removed. Invalid fields removed. UI cleaned up. No known placeholder data. No known invalid controls. Ready for long-term support. --- `deprecated`: Tool remains supported but is not recommended for new workflows. Must remain deprecated before removal. -- --UAT rule: --- A tool required for the current MVP game path must be `beta` or `complete` before UAT. --- `complete` is not required for MVP UAT, but `beta` is the minimum usable state. -- --## TARGETED MSJ VALIDATION GOVERNANCE -- --Every tool, page, or `src/` change must declare its impacted MSJ/test lane. -- --Run only the affected MSJ/test lane by default. -- --Do not run the full suite for small scoped changes unless one of these shared surfaces changes: --- shared runtime behavior --- shared parser behavior --- shared DB behavior --- shared Theme V2 behavior --- cross-tool integration behavior -- --If a shared source file changes, name the affected dependent lanes and run only those targeted lanes unless the dependency impact proves broader validation is required. -- --Reports must state: --- impacted lane --- skipped lanes --- why skipped lanes were safe to skip --- when the full suite is required -- --## SHARED MOCK DB ADAPTER CONTRACT -- --All current app and tool mock data must flow through the shared DB adapter under `src/engine/persistence`. -- --Tools must not maintain isolated page-local DB snapshots for data that should be visible to the Mock DB viewer or to another current tool. -- --The active browser mock implementation is the Mock adapter. UAT and production persistence must swap through the same module-level contract by deployment configuration rather than by changing tool UI code. -- --The Mock DB viewer must render live adapter state and table schemas, including empty tables with headers. It must not render hardcoded table dumps, hardcoded row counts, or copied static JSON snapshots. -- --Audit ownership is users-only: every shared table record uses `key`, `createdAt`, `updatedAt`, `createdBy`, and `updatedBy`; the ownership fields reference `users.key`. Roles are modeled with `roles` and `user_roles`. -- --## DB-BACKED PRODUCT DATA SSOT GOVERNANCE -- --Web UI must access product data only through API or service contracts backed by DB adapters. -- --Allowed production flow: --- Web UI -> API/Service Contract -> Server DB -- --Allowed dev/UAT/test flow: --- Web UI -> API/Service Contract -> DB Adapter --- The DB Adapter may be MEM DB, Local DB, Test DB, or Server DB. -- --Prohibited product-data ownership: --- page-local product data arrays --- page-local metadata registries --- hardcoded product counts --- duplicated status, group, path, or order data --- duplicated lookup maps that compete with DB-backed metadata --- browser storage as the product source of truth --- UI-only vote, order, or status state --- direct DB-shaped product data embedded in HTML or browser JavaScript pages -- --Toolbox and Admin tool metadata must use a shared DB-backed tool metadata source for `toolKey`, `toolName`, `group`, `path`, `order`, and `status`. Browser pages may render metadata returned by the API/service contract, but they must not own a separate runtime copy of that metadata. -- --## DATABASE DIRECTION -- --Postgres is the authoritative active runtime database. -- --SQLite is deprecated/retired and is not an active runtime database for Local (VS Code), DEV, IST, UAT, or PROD. -- --Rules: --- New database work must target Postgres. --- Local (VS Code) API -> Postgres is the required direction. --- New PRs must not introduce SQLite persistence. --- Do not add new SQLite services. --- Do not add new SQLite DDL. --- Do not add new SQLite seed data. --- Do not add new SQLite runtime persistence. --- Legacy SQLite references may remain only as documented technical debt when they already exist. --- Browser code must not own product data or generate authoritative persistence keys. -- --## DEV RUNTIME BOUNDARY -- --All mock/dev-only runtime implementation must live under `src/dev-runtime/`. -- --Required dev-runtime folders: --- `src/dev-runtime/auth/` --- `src/dev-runtime/persistence/` --- `src/dev-runtime/admin/` --- `src/dev-runtime/testing/` --- `src/dev-runtime/guest-seeds/` -- --Rules: --- UAT/PROD must never import, bundle, or deploy `src/dev-runtime/`. --- Active tools must use declared runtime contracts and must not import `src/dev-runtime/` directly. --- Dev-only adapters may be exposed through existing dev/runtime contract shims only when the deployment boundary keeps `src/dev-runtime/` out of UAT/PROD bundles. --- No fallback auth, session, user, admin, or system user data is allowed. --- Local session state must resolve selected users and roles from persisted Memory DB `users`, `roles`, and `user_roles` records. --- Missing users or roles must fail visibly with actionable diagnostics. -- --## ENVIRONMENT CONFIGURATION GOVERNANCE -- --Runtime startup loads `.env` only. -- --Official environment model: --- `Local (VS Code)` --- `DEV` --- `IST` --- `UAT` --- `PROD` -- --Promotion order: --- `Local (VS Code) -> DEV -> IST -> UAT -> PROD` -- --Environment invariance rule: --- The deployable artifact is identical across every environment. --- Only `.env` values and environment-managed secret values differ between environments. --- Application code, runtime code, API/service code, database runtime scripts, migrations, and bundles must not fork by environment name. -- --Shared API/service contract: --- One shared API/service contract is required across Local (VS Code), DEV, IST, UAT, and PROD. --- Browser/UI/runtime code must consume the same contract in every environment. --- Environment-specific URLs, endpoints, keys, buckets, and prefixes are `.env` or environment-managed secret/config values only. --- Do not create environment-specific API/service contracts. --- Do not split Local API and Public API contracts. Local and shared environments use the same API/service contract; URLs may differ by `.env` only. -- --Required services in every environment: --- Supabase Auth --- Supabase Postgres --- Cloudflare R2 -- --Guest seed data rule: --- All environments receive approved guest seed data for all tools. --- Guest seed data is shared environment setup data, not an environment-specific behavior fork. --- Guest seed data must be applied through the shared data/service contract and must not require per-environment application code. -- --Required Cloudflare R2 top-level prefixes: --- Local (VS Code): `/local/` --- DEV: `/dev/` --- IST: `/ist/` --- UAT: `/uat/` --- PROD: `/prod/` -- --Derived R2 paths for projects, backups, exports, or future storage lanes must stay under the matching top-level prefix for the active environment. -- --Only `.env.example` is committed to the repository. -- --Real `.env` files are user/environment-owned and must live outside the repo clone or be injected by deployment. -- --Official external environment file names when a copy-source file is used outside the repo clone: --- `.env.local` --- `.env.dev` --- `.env.ist` --- `.env.uat` --- `.env.prod` -- --Example external layout: --- `/env/local/.env` --- `/env/dev/.env` --- `/env/ist/.env` --- `/env/uat/.env` --- `/env/prod/.env` --- `/GFS/` repo clone -- --The app/runtime reads `.env` values supplied by the target environment. It must not require real `.env` files to be committed inside the repo clone. -- --`.env.prd` is legacy technical debt only. New environment governance uses `.env.prod` for external PROD copy-source naming and the `PROD` environment name. -- --Allowed `GAMEFOUNDRY_ENVIRONMENT` values: --- `local` --- `dev` --- `ist` --- `uat` --- `prod` -- --`GAMEFOUNDRY_ENVIRONMENT_LABEL` is display-only and must not drive runtime behavior, API/service selection, database selection, storage selection, or feature behavior. -- --Valid environment stages are: --- `Local (VS Code)` --- `DEV` --- `IST` --- `UAT` --- `PROD` -- --Manual deployment-target flow: --1. Copy the selected `.env.` file to `.env`. --2. Run validation. --3. Apply DDL/DML migrations. --4. Start runtime. -- --Runtime environment parameters are prohibited. -- --Do not introduce runtime parameters such as: --- `--env` --- `--environment` --- `ENVIRONMENT=LOCAL` --- `ENVIRONMENT=DEV` --- `ENVIRONMENT=UAT` --- `ENVIRONMENT=PROD` -- --`Local (VS Code)`, `DEV`, `IST`, `UAT`, and `PROD` are environment stages, not application behaviors. -- --Application code, runtime code, API/service code, and DB runtime scripts must not branch behavior by deployment target name. -- --Host/domain configuration: --- Local (VS Code) uses `127.0.0.1` hostnames. --- DEV, IST, UAT, and PROD use configured `*.gamefoundrystudio.com` hostnames. --- Host/domain differences are configuration values only and must not create separate deployable artifacts or environment-specific code. -- --Feature flag governance: --- Feature flags must not create permanent environment-specific behavior. --- Feature flags may be used only for staged rollout, testing, or emergency mitigation. --- Feature flags must be removed, promoted to normal behavior, or documented as active temporary controls when the rollout, test, or mitigation ends. -- --## RUNTIME SCRIPT NAMING GOVERNANCE -- --Active runtime script names should describe capability rather than vendor/provider. -- --Preferred runtime naming nouns are: --- `auth` --- `database` --- `storage` --- `telemetry` --- `api` -- --Avoid provider or vendor names in future active runtime script names. -- --When an active script is renamed, a temporary compatibility wrapper may remain only when needed for command continuity. -- --Compatibility wrappers must log: -- --`Deprecated script name. Use .` -- --## ARCHIVED V1/V2 REFERENCE MATERIAL -- --Deprecated V1/V2 reference material lives under: -- --- `archive/v1-v2/tools/` --- `archive/v1-v2/games/` --- `archive/v1-v2/samples/` -- --Rules: --- Archive material is retained for reference and traceability, not active app ownership. --- Active app navigation must not point users into `archive/v1-v2/`. --- Active validation must not run tests against `archive/v1-v2/` unless a later PR explicitly reclassifies a target. --- New toolbox, game, sample, engine, and Theme V2 work must not use archived material as the implementation source of truth. --- Cleanup and governance docs should refer to archived V1/V2 reference material through `archive/v1-v2/`. -- --## GAMEFOUNDRYSTUDIO NORTH STAR -- --GameFoundryStudio should present as an open-web creator destination where players and makers can move fluidly between creator tools, playable games, marketplace assets, tutorials, cloud saves, and community discovery. -- --The product guidance phrase is: -- --`Build · Play · Share` -- --Use that phrase as a compact IA and copywriting anchor: --- Build: tools and creation flow, including asset creation, prototypes, systems, and publishing preparation. --- Play: games and discovery, including playable games, arcade browsing, testing, and saves. --- Share: public game pages, share links, creator profiles, marketplace assets, tutorials/community, ratings, and future publish/export flows. -- --## GAMEFOUNDRYSTUDIO THEME V2 GOVERNANCE -- --`assets/theme-v2` is the only approved styling surface for public/root GameFoundryStudio page work as bounded below. -- --V1/legacy CSS is deprecated and out of play. -- --### Theme Surface Boundary -- --`assets/theme-v2/css` owns public/root GameFoundryStudio page styling: --- root Home --- Company pages --- Tools index --- public/root tool pages --- marketing/content surfaces --- placeholder Admin/Account pages until DB/login implementation -- --`src/engine/theme` owns engine/runtime first-class tool shell styling: --- runtime tool shell --- engine-facing first-class tools --- reusable runtime UI foundations -- --Rules: --- Do not deprecate `src/engine/theme` at this time. --- Do not duplicate behavior between the two surfaces. --- Do not create competing `.tool-shell` implementations. --- If both public/root tools and runtime first-class tools need the same behavior, document the shared shell contract first. --- Shared behavior must be promoted intentionally rather than patched independently in both places. --- Collapse/rail behavior currently belongs only to the public/root `.tool-workspace` shell unless a later PR explicitly promotes it to shared runtime shell behavior. -- --### Theme V2 Only CSS Rule -- --- Theme V2 is the only active styling system for public/root GameFoundryStudio page work. --- V1/legacy CSS is deprecated and out of play. --- V1/legacy CSS must not be used as a source. --- V1/legacy CSS must not be copied. --- V1/legacy CSS must not be ported. --- V1/legacy CSS must not be compared as the desired target. --- V1/legacy CSS must not be extended. --- V1/legacy CSS must not be reintroduced through aliases, duplicate selectors, wrapper selectors, compatibility classes, or fallback imports. --- New CSS must be authored directly in Theme V2 only when approved as reusable Theme V2 design-system styling. --- Pages not migrated to Theme V2 may temporarily retain their existing references until their migration PR. --- Pages that have migrated to Theme V2 must not reference V1/legacy CSS. --- Migration means replacing the page with Theme V2 usage, not copying V1 styles into Theme V2. -- --If Theme V2 lacks a needed pattern: --1. Document the design-system gap. --2. Request approval. --3. Implement the reusable pattern directly in Theme V2. --4. Do not solve it by using V1. -- --Rules: --- Do not extend deprecated CSS. --- Do not create new CSS files outside `assets/theme-v2/css`. --- No page-local CSS. --- No tool-local CSS. --- No inline style attributes. --- No `