|
1 | | -# PR_26177_006-shared-time-foundation |
| 1 | +# PR_26177_OWNER_007-project-instructions-single-source-eod-lock |
2 | 2 |
|
3 | 3 | ## Purpose |
4 | 4 |
|
5 | | -Add a small shared time foundation. |
| 5 | +Make `docs_build/dev/ProjectInstructions/` the only active Project Instructions source and add EOD main lock plus next-day reset governance. |
6 | 6 |
|
7 | 7 | ## Source Of Truth |
8 | 8 |
|
9 | | -This `BUILD_PR.md`, `PLAN_PR.md`, and the user request are the source of truth for `PR_26177_006-shared-time-foundation`. |
10 | | - |
11 | | -## Stack |
12 | | - |
13 | | -- Base branch: `PR_26177_005-shared-text-foundation` |
| 9 | +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`. |
14 | 10 |
|
15 | 11 | ## Exact Scope |
16 | 12 |
|
17 | | -- Add `src/shared/time/` foundation. |
18 | | -- Include duration formatting, timestamp helpers, debounce/throttle/sleep helpers where safe for shared runtime. |
19 | | -- Add targeted tests for the shared time area. |
20 | | -- No scheduler/runtime behavior changes. |
21 | | -- Create required Codex reports under `docs_build/dev/reports/`. |
22 | | -- Create repo-structured delta ZIP under `tmp/`. |
| 13 | +- Audit repo for ProjectInstructions / project instructions duplicates. |
| 14 | +- Establish `docs_build/dev/ProjectInstructions/` as the only active source. |
| 15 | +- Mark all other ProjectInstructions-style sources changed by this PR as deprecated references. |
| 16 | +- Update active team start/governance docs to reference only `docs_build/dev/ProjectInstructions/`. |
| 17 | +- Add EOD main lock and next-day reset governance. |
| 18 | +- Add required reports under `docs_build/dev/reports/`. |
23 | 19 |
|
24 | 20 | ## Exact Targets |
25 | 21 |
|
26 | 22 | - `docs_build/dev/PLAN_PR.md` |
27 | 23 | - `docs_build/dev/BUILD_PR.md` |
28 | | -- `src/shared/time/time.js` |
29 | | -- `tests/shared/TimeFoundation.test.mjs` |
30 | | -- `docs_build/dev/reports/PR_26177_006-shared-time-foundation.md` |
31 | | -- `docs_build/dev/reports/PR_26177_006-shared-time-foundation_branch-validation.md` |
32 | | -- `docs_build/dev/reports/PR_26177_006-shared-time-foundation_requirement-checklist.md` |
33 | | -- `docs_build/dev/reports/PR_26177_006-shared-time-foundation_validation-lane.md` |
34 | | -- `docs_build/dev/reports/PR_26177_006-shared-time-foundation_manual-validation-notes.md` |
| 24 | +- `docs_build/dev/PROJECT_INSTRUCTIONS.md` |
| 25 | +- `docs_build/dev/ProjectInstructions/README.txt` |
| 26 | +- `docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md` |
| 27 | +- `docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md` |
| 28 | +- `docs_build/dev/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md` |
| 29 | +- `docs_build/dev/ProjectInstructions/addendums/*.md` |
| 30 | +- `project-instructions/README.md` |
| 31 | +- `project-instructions/addendums/*.md` |
| 32 | +- `docs_build/dev/reports/PR_26177_OWNER_007-project-instructions-single-source-eod-lock*.md` |
35 | 33 | - `docs_build/dev/reports/codex_review.diff` |
36 | 34 | - `docs_build/dev/reports/codex_changed_files.txt` |
37 | 35 |
|
38 | 36 | ## Out Of Scope |
39 | 37 |
|
40 | | -- No scheduler/runtime behavior changes. |
41 | | -- No browser-owned product data. |
42 | | -- No runtime UI changes. |
43 | | -- No browser storage changes. |
44 | | -- No API/database changes. |
45 | | -- No `start_of_day` folder changes. |
46 | | -- No unrelated cleanup. |
47 | | -- No full samples smoke by default. |
| 38 | +- No product/runtime changes. |
| 39 | +- No feature work. |
| 40 | +- No `start_of_day` changes. |
| 41 | +- No legacy SQLite file changes. |
48 | 42 |
|
49 | 43 | ## Validation |
50 | 44 |
|
51 | | -Run exactly: |
| 45 | +Run: |
52 | 46 |
|
53 | 47 | ```powershell |
54 | | -node ./scripts/run-node-test-files.mjs tests/shared/TimeFoundation.test.mjs |
55 | | -node --check src/shared/time/time.js |
56 | | -node --check tests/shared/TimeFoundation.test.mjs |
| 48 | +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 |
| 49 | +rg -n "End of Day:|Next Day Start:|HEAD.*published EOD SHA|only active Project Instructions source" docs_build/dev/ProjectInstructions |
| 50 | +git diff --name-only -- src assets toolbox games api serverside package.json package-lock.json docs_build/dev/start_of_day |
57 | 51 | git diff --check |
58 | 52 | ``` |
59 | | - |
60 | | -## Artifact |
61 | | - |
62 | | -Create repo-structured delta ZIP: |
63 | | - |
64 | | -```text |
65 | | -tmp/PR_26177_006-shared-time-foundation_delta.zip |
66 | | -``` |
0 commit comments