Skip to content

Commit 3a3d2b0

Browse files
author
DavidQ
committed
Samples: align phase structure and navigation references
- mapped samples to canonical phase-based locations - corrected misnumbered/misplaced sample paths - updated sample index/navigation references - kept scope to samples structure and direct references only
1 parent b413f99 commit 3a3d2b0

986 files changed

Lines changed: 701 additions & 609 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/dev/CODEX_COMMANDS.md‎

Lines changed: 30 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,38 @@
1-
MODEL: GPT-5.3-codex
1+
MODEL: GPT-5.4
22
REASONING: high
33

44
COMMAND:
5-
Implement BUILD_PR_LEVEL_11_1_STATE_CONTRACT_FINALIZATION.
5+
Implement BUILD_PR_LEVEL_6_1_SAMPLES_PHASE_ALIGNMENT.
66

7-
Modify ONLY:
8-
src/advanced/state/transitions.js
7+
Goal:
8+
Normalize the samples area into canonical phase-based locations and update only the references required to keep sample navigation working.
99

10-
Change:
11-
- Enforce normalized structure for worldState mutations
12-
- Reject malformed payloads early
10+
Use this captured plan exactly:
11+
1. Map every sample to a canonical `phaseXX/####` location.
12+
2. Identify outliers/misnumbered entries and define move/rename rules.
13+
3. Validate links/index metadata against the new phase structure.
14+
4. Apply in one surgical delta (structure + references + verification).
15+
16+
Scope limits:
17+
- samples/ only
18+
- `samples/index.html`
19+
- direct sample metadata or link surfaces used by `samples/index.html`
20+
- no engine/game/tool changes
21+
- no sample logic rewrites unless path references require them
22+
23+
Required steps:
24+
1. Build an exact move-map for current sample locations to canonical `samples/phase-XX/####-*` targets.
25+
2. Identify and resolve misnumbered/misplaced entries with exact rename targets.
26+
3. Apply moves/renames in one pass.
27+
4. Update `samples/index.html` and only the direct references required for navigation correctness.
28+
5. Verify there are no broken sample-navigation references after the move.
1329

1430
Validation:
15-
- No undefined state fields
16-
- Tests pass
31+
- every sample in scope has one canonical final location
32+
- no duplicate/ambiguous final placements
33+
- `samples/index.html` resolves correctly
34+
- smoke validation for sample navigation passes
1735

18-
Output:
19-
<project folder>/tmp/BUILD_PR_LEVEL_11_1_STATE_CONTRACT_FINALIZATION.zip
36+
Return:
37+
- COMPLETE repo-structured ZIP only
38+
- path: <project folder>/tmp/BUILD_PR_LEVEL_6_1_SAMPLES_PHASE_ALIGNMENT.zip

‎docs/dev/COMMIT_COMMENT.txt‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1-
Plan: Samples phase alignment
1+
Samples: align phase structure and navigation references
22

3-
- Defined structure for samples by phase
3+
- mapped samples to canonical phase-based locations
4+
- corrected misnumbered/misplaced sample paths
5+
- updated sample index/navigation references
6+
- kept scope to samples structure and direct references only

‎docs/dev/reports/change_summary.txt‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,7 @@
1-
Created plan for samples phase alignment and structure normalization.
1+
Build package for samples phase alignment.
2+
3+
Targeted outcome:
4+
- canonical phase-based sample placement
5+
- exact move/rename map
6+
- updated sample index/direct navigation references
7+
- verification of post-move sample navigation integrity

‎docs/dev/reports/validation_checklist.txt‎

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1-
[ ] Plan only
2-
[ ] No code changes
3-
[ ] Structure defined
1+
[ ] samples-only scope preserved
2+
[ ] exact move-map created
3+
[ ] misnumbered entries resolved
4+
[ ] misplaced entries resolved
5+
[ ] no ambiguous final placements
6+
[ ] samples/index.html updated
7+
[ ] direct sample navigation references updated
8+
[ ] no broken sample-navigation links after move
9+
[ ] smoke validation passes

‎docs/pr/BUILD_PR_LEVEL_6_1_SAMPLES_PHASE_ALIGNMENT.md‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# BUILD PR — Level 6.1 Samples Phase Alignment
2+
3+
## Purpose
4+
Normalize samples into a canonical phase-based structure with exact move targets and matching index/reference updates.
5+
6+
## Scope
7+
- samples/ only
8+
- sample index / sample metadata references only
9+
- no engine changes
10+
- no game changes
11+
- no tool changes
12+
- no sample content rewrites
13+
14+
## Inputs
15+
Use the captured plan:
16+
1. Map every sample to a canonical `phaseXX/####` location.
17+
2. Identify outliers/misnumbered entries and define move/rename rules.
18+
3. Validate links/index metadata against the new phase structure.
19+
4. Apply in one surgical delta (structure + references + verification).
20+
21+
## Exact Required Work
22+
1. Inventory current sample folders/files that participate in runnable sample navigation.
23+
2. Produce an exact move-map from current locations to canonical `samples/phase-XX/####-*` targets.
24+
3. Identify:
25+
- misnumbered samples
26+
- misplaced samples
27+
- duplicate/ambiguous placements
28+
4. Update only the references required to keep navigation working:
29+
- `samples/index.html`
30+
- any sample metadata or link surfaces directly used by `samples/index.html`
31+
5. Apply the moves/renames in one pass.
32+
6. Run verification for broken references after moves.
33+
34+
## Constraints
35+
- smallest valid change only
36+
- one-pass executable
37+
- no repo-wide scan beyond files required for runnable sample navigation
38+
- do not change sample internals unless path references require it
39+
- do not renumber without explicit canonical target mapping
40+
- do not introduce new samples
41+
- do not delete samples unless they are exact duplicate placeholders proven by the move-map
42+
43+
## Deliverables
44+
- exact move-map
45+
- updated `samples/index.html`
46+
- updated direct sample link/metadata references required by the new structure
47+
- verification notes
48+
49+
## Validation
50+
- every sample in scope has one canonical target
51+
- no ambiguous or duplicate final placements
52+
- `samples/index.html` paths resolve to moved targets
53+
- no broken direct references introduced by the move
54+
- smoke validation for sample navigation passes
55+
56+
## Output
57+
Return one repo-structured ZIP at:
58+
`<project folder>/tmp/BUILD_PR_LEVEL_6_1_SAMPLES_PHASE_ALIGNMENT.zip`

0 commit comments

Comments
 (0)