Lock ProjectInstructions single source

Author: ToolboxAid

docs_build/dev/BUILD_PR.md

@@ -1,66 +1,52 @@
-# PR_26177_006-shared-time-foundation
+# PR_26177_OWNER_007-project-instructions-single-source-eod-lock
 
 ## Purpose
 
-Add a small shared time foundation.
+Make `docs_build/dev/ProjectInstructions/` the only active Project Instructions source and add EOD main lock plus next-day reset governance.
 
 ## 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`
+This `BUILD_PR.md`, `PLAN_PR.md`, and the user request are the source of truth for `PR_26177_OWNER_007-project-instructions-single-source-eod-lock`.
 
 ## 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/`.
+- Audit repo for ProjectInstructions / project instructions duplicates.
+- Establish `docs_build/dev/ProjectInstructions/` as the only active source.
+- Mark all other ProjectInstructions-style sources changed by this PR as deprecated references.
+- Update active team start/governance docs to reference only `docs_build/dev/ProjectInstructions/`.
+- Add EOD main lock and next-day reset governance.
+- Add required reports under `docs_build/dev/reports/`.
 
 ## 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/PROJECT_INSTRUCTIONS.md`
+- `docs_build/dev/ProjectInstructions/README.txt`
+- `docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md`
+- `docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md`
+- `docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md`
+- `docs_build/dev/ProjectInstructions/addendums/*.md`
+- `project-instructions/README.md`
+- `project-instructions/addendums/*.md`
+- `docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock*.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.
+- No product/runtime changes.
+- No feature work.
+- No `start_of_day` changes.
+- No legacy SQLite file changes.
 
 ## Validation
 
-Run exactly:
+Run:
 
 ```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
+rg -n 'project-instructions/addendums|docs_build/dev/PROJECT_INSTRUCTIONS.md.*source of truth|Codex must always read `docs_build/dev/PROJECT_INSTRUCTIONS.md`|Read `docs_build/dev/PROJECT_INSTRUCTIONS.md`' docs_build/dev/ProjectInstructions docs_build/dev/PROJECT_INSTRUCTIONS.md project-instructions
+rg -n "End of Day:|Next Day Start:|HEAD.*published EOD SHA|only active Project Instructions source" docs_build/dev/ProjectInstructions
+git diff --name-only -- src assets toolbox games api serverside package.json package-lock.json docs_build/dev/start_of_day
 git diff --check
 ```
-
-## Artifact
-
-Create repo-structured delta ZIP:
-
-```text
-tmp/PR_26177_006-shared-time-foundation_delta.zip
-```

docs_build/dev/PLAN_PR.md

@@ -1,22 +1,28 @@
-# PLAN_PR: PR_26177_006-shared-time-foundation
+# PLAN_PR: PR_26177_OWNER_007-project-instructions-single-source-eod-lock
 
 ## Purpose
 
-Add a small shared time foundation.
+Make `docs_build/dev/ProjectInstructions/` the only active Project Instructions source and add EOD main lock plus next-day reset governance.
 
 ## 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.
+- Audit ProjectInstructions and project instructions duplicates.
+- Mark legacy ProjectInstructions-style sources as deprecated reference material.
+- Move active legacy addendums into `docs_build/dev/ProjectInstructions/addendums/`.
+- Update active team start and governance docs to reference only `docs_build/dev/ProjectInstructions/`.
+- Add EOD main lock, next-day reset, and team PR branch creation gate.
+- Add required Codex reports under `docs_build/dev/reports/`.
 
-## Implementation Plan
+## Out Of Scope
 
-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.
+- No product/runtime changes.
+- No feature work.
+- No `start_of_day` changes.
+- No legacy SQLite file changes.
+
+## Validation Plan
+
+1. Run targeted grep/search proving no active duplicate ProjectInstructions source remains.
+2. Confirm EOD/Next Day rule appears in active governance docs.
+3. Confirm no product/runtime files changed.
+4. Run `git diff --check`.

docs_build/dev/PROJECT_INSTRUCTIONS.md

@@ -1,5 +1,7 @@
 # PROJECT INSTRUCTIONS
 
+> Deprecated active-source notice: this file is preserved as historical reference only. The only active Project Instructions source is `docs_build/dev/ProjectInstructions/`. If this file conflicts with `docs_build/dev/ProjectInstructions/`, the active folder wins unless OWNER explicitly approves a newer governance change.
+
 You are working in a docs-first repo workflow.
 
 Workflow:
@@ -864,7 +866,7 @@ Controls must remain copy-friendly and human-readable.
 
 ### ChatGPT Workflow Governance Consistency
 
-ChatGPT repo workflow responses are governed by `docs_build/dev/PROJECT_INSTRUCTIONS.md` as the source of truth.
+Deprecated note: this historical section no longer defines the active source of truth. ChatGPT repo workflow responses are governed by `docs_build/dev/ProjectInstructions/`.
 
 ChatGPT must not drift from the required response ordering.
 
@@ -1716,13 +1718,13 @@ Do not compact:
 
 Do not change JSON contracts or semantics while applying array formatting.
 
-## PROJECT INSTRUCTIONS LOCATION
+## DEPRECATED PROJECT INSTRUCTIONS LOCATION
 
-PROJECT_INSTRUCTIONS.md lives at:
+Historical PROJECT_INSTRUCTIONS.md is preserved at:
 
 `docs_build/dev/PROJECT_INSTRUCTIONS.md`
 
-Codex must always read `docs_build/dev/PROJECT_INSTRUCTIONS.md` from this path as the source of truth before executing repository workflow instructions.
+This file is not the active source of truth. Codex must read `docs_build/dev/ProjectInstructions/README.txt` first and use `docs_build/dev/ProjectInstructions/` as the active Project Instructions source before executing repository workflow instructions.
 
 ## CODEX COMMAND FORMATTING RULE
 
@@ -2384,9 +2386,9 @@ Treat these files the same as existing instruction documents for read-set, revie
 Codex must run this gate before every PR execution and before any file changes.
 
 Required instruction reads:
-- Read `docs_build/dev/PROJECT_INSTRUCTIONS.md`.
+- Read `docs_build/dev/ProjectInstructions/README.txt`.
 - Read `docs_build/dev/PROJECT_MULTI_PC.txt`.
-- Treat the newest applicable section in `PROJECT_INSTRUCTIONS.md` as authoritative when rules overlap.
+- Treat the newest applicable section in `docs_build/dev/ProjectInstructions/` as authoritative when rules overlap.
 - Treat the current team ownership section in `PROJECT_MULTI_PC.txt` as authoritative for TEAM routing.
 
 Required pre-change report:

docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md

@@ -4,6 +4,12 @@ Read `README.txt` first.
 
 This file is the root index for the append-first Project Instructions operating system under `docs_build/dev/ProjectInstructions/`.
 
+## Active Source
+
+`docs_build/dev/ProjectInstructions/` is the only active Project Instructions source.
+
+Historical Project Instructions material outside this folder is deprecated reference material only and must not be used as an active source of governance.
+
 ## Purpose
 
 The Project Instructions operating system provides additive governance for:
@@ -20,7 +26,7 @@ The Project Instructions operating system provides additive governance for:
 
 ## Preservation
 
-Existing Project Instructions remain preserved in their current locations. This operating system adds structure without deleting or rewriting existing documentation.
+Existing Project Instructions outside `docs_build/dev/ProjectInstructions/` remain preserved only as deprecated reference material. When guidance conflicts, active files under `docs_build/dev/ProjectInstructions/` win unless OWNER explicitly approves a newer governance change.
 
 ## Folders
 
@@ -41,6 +47,10 @@ Existing Project Instructions remain preserved in their current locations. This
 
 `docs_build/dev/ProjectInstructions/addendums/environment_configuration_standards.md` defines official `.env` file names, environment variable values, host/domain configuration, API URL configuration, R2 prefix configuration, and feature flag governance.
 
+## 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, EOD main lock, next-day reset, and team branch creation gate.
+
 ## Merge Control
 
 No PR in this operating system is merged without explicit owner approval.

docs_build/dev/ProjectInstructions/README.txt

@@ -1,10 +1,10 @@
 Read this file first.
 
 Folder purpose:
-This folder is the append-first Project Instructions operating system for Game Foundry Studio. It organizes active governance, backlog, team assignment, deprecation, and history material without deleting or rewriting the existing Project Instructions files elsewhere in the repository.
+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/`.
 
 Preservation rules:
-Preserve all existing documentation. Add new files or append explicit references unless the owner explicitly approves deletion or rewrite. When a conflict appears, stop, explain the conflict, and request owner approval before changing existing instruction text.
+Preserve historical Project Instructions material as deprecated reference only. Do not treat `docs_build/dev/PROJECT_INSTRUCTIONS.md`, `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.
 
 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.
@@ -29,9 +29,9 @@ Do not rewrite history snapshots after creation unless the owner explicitly appr
 
 READ THIS FIRST
 
-1. Read Project Instructions before making changes.
-2. Project Instructions are append-only.
-3. Existing approved guidance may not be removed.
+1. Read `docs_build/dev/ProjectInstructions/README.txt` before making changes.
+2. Treat `docs_build/dev/ProjectInstructions/` as the only active Project Instructions source.
+3. Historical Project Instructions files outside this folder are deprecated references only.
 4. Team ownership must be respected.
 5. BACKLOG_MASTER.md is the authoritative backlog.
 6. Build Path status derives from backlog status.
@@ -42,12 +42,13 @@ READ THIS FIRST
 11. Batch Governance Mode is the default for governance, documentation, and administrative work.
 
 Addendum index:
-- Canonical Repository Structure: project-instructions/addendums/canonical-repository-structure.md
-- Test Structure Standardization: project-instructions/addendums/test-structure-standardization.md
-- Legacy Migration Policy: project-instructions/addendums/legacy-migration-policy.md
-- Assistant Execution Modes: project-instructions/addendums/assistant-execution-modes.md
-- Codex Artifact and Reporting Standard: project-instructions/addendums/codex-artifact-and-reporting-standard.md
-- Codex Project Instructions Startup: project-instructions/addendums/codex-project-instructions-startup.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
+- Legacy Migration Policy: docs_build/dev/ProjectInstructions/addendums/legacy_migration_policy.md
+- Assistant Execution Modes: docs_build/dev/ProjectInstructions/addendums/assistant_execution_modes.md
+- Codex Artifact and Reporting Standard: docs_build/dev/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md
+- Codex Project Instructions Startup: docs_build/dev/ProjectInstructions/addendums/codex_project_instructions_startup.md
 - Project Reference Files Governance: docs_build/dev/ProjectInstructions/addendums/project_reference_files.md
 - Environment Governance Model: docs_build/dev/ProjectInstructions/addendums/environment_governance_model.md
 - Environment Configuration Standards: docs_build/dev/ProjectInstructions/addendums/environment_configuration_standards.md

docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md

@@ -1,5 +1,16 @@
 # TEAM_START_COMMANDS
 
+## Required Main Reset Gate For Every Team
+
+No team creates a PR branch until all checks pass:
+
+- Current branch: `main`
+- Worktree: clean
+- `main...origin/main`: `0 0`
+- `HEAD` SHA matches the published EOD SHA
+
+Use `docs_build/dev/ProjectInstructions/` as the only active Project Instructions source.
+
 ## Start Team Alfa
 
 Ready-to-copy command:
@@ -123,4 +134,24 @@ Merge to main is EOD-only and owner-approved, unless the owner explicitly says:
 "Merge this PR now."
 
 Do not treat sequential PR completion as merge approval.
+
+End of Day:
+git checkout main
+git fetch origin
+git pull --ff-only origin main
+git status
+git rev-list --left-right --count main...origin/main
+
+Required:
+On branch main
+nothing to commit, working tree clean
+0 0
+
+Next Day Start:
+git checkout main
+git fetch origin
+git pull --ff-only origin main
+git status
+git rev-list --left-right --count main...origin/main
+git rev-parse HEAD
 ```