docs(02-01): complete foundations plan

- 02-01-foundations-SUMMARY.md authored with frontmatter dependency
  graph, key-files manifest, decisions log, patterns established,
  test-count breakdown (72 new tests), TICK_MS=200 (no drift), and
  ESLint sim-purity rule landed (defended-option clause did not trigger)
- STATE.md: Phase 2 progress 1/5 plans (Wave 0 complete);
  velocity table updated with Plan 02-01 ~12min entry; decisions log
  cites BLOCKER 3 split, V1Payload extension, ESLint rule
- ROADMAP.md: Phase 2 row updated to 1/5; 02-01 plan marked [x] with
  duration + summary backlink
- REQUIREMENTS.md: CORE-02, CORE-03, CORE-11, UX-10, UX-11 marked
  complete with annotations; traceability table updated

Plan execution metrics:
- 3 atomic commits (58db532, fe99058, 2a8d354)
- 72 new tests across 9 test files (cushion above plan estimate of 54)
- Total test count: 128/128 green
- npm run ci exits 0
- Duration: ~12 min (sequential mode)

.planning/STATE.md

@@ -2,16 +2,16 @@
 gsd_state_version: 1.0
 milestone: v1.0
 milestone_name: milestone
-status: ready_to_execute
-stopped_at: "Phase 2 planned. 5 PLAN.md files across 3 waves (Wave 0: 02-01 foundations [BigQty + Zustand store + tick scheduler + V1Payload extension]; Wave 1 parallel: 02-02 begin-plant-grow + 02-03 harvest-journal-fragments; Wave 2 parallel: 02-04 lura-gate-beats + 02-05 letter-settings-e2e). 24/24 REQ-IDs covered in plan frontmatter; 34/34 CONTEXT.md decisions cited across plan must_haves. RESEARCH.md, PATTERNS.md, VALIDATION.md (nyquist_compliant: true) all in place. Plan-checker iterations: 13 issues → 3 issues → 0 issues (BLOCKER 3 lastTickAt-vs-tickCount split was the cross-plan defect; final fix introduced src/save/payload.ts as a shared two-arg helper module). Next: /gsd-execute-phase 2 (Wave 0 must land before Waves 1+2 can start)."
-last_updated: "2026-05-09T01:30:00.000Z"
+status: in_progress
+stopped_at: "Phase 2 Wave 0 (Plan 02-01 foundations) complete. 3 atomic commits: 58db532 (BigQty + scheduler + sim foundations), fe99058 (Zustand store + V1Payload extension + save lifecycle hooks), 2a8d354 (eslint sim-purity rule + Date.now violator fixture). 128/128 tests green; npm run ci exits 0. CORE-02 / CORE-03 / CORE-11 / UX-10 / UX-11 foundations all landed and unit-tested. Wave 1 (02-02 begin-plant-grow + 02-03 harvest-journal-fragments) and Wave 2 (02-04 lura-gate-beats + 02-05 letter-settings-e2e) unblocked. Next: /gsd-execute-phase 2 to run Wave 1 in parallel against this Wave-0 foundation."
+last_updated: "2026-05-09T13:21:00.000Z"
 last_activity: 2026-05-09
 progress:
   total_phases: 8
   completed_phases: 1
-  total_plans: 7
-  completed_plans: 7
-  percent: 12
+  total_plans: 8
+  completed_plans: 8
+  percent: 14
 ---
 
 # Project State
@@ -25,12 +25,12 @@ See: .planning/PROJECT.md (updated 2026-05-08)
 
 ## Current Position
 
-Phase: 02 (season-1-vertical-slice-soil) — planned, ready to execute
-Plans: 5 of 5 created (3 waves)
-Status: All 24 REQ-IDs + 34 CONTEXT.md decisions covered. Plan-checker PASSED after 3 revision iterations. Ready for `/gsd-execute-phase 2`.
-Last activity: 2026-05-09 -- Phase 2 plan-phase complete
+Phase: 02 (season-1-vertical-slice-soil) — Wave 0 complete (1/5 plans)
+Plans: 5 of 5 created (3 waves); Wave 0 (02-01) DONE; Waves 1 + 2 ready
+Status: Plan 02-01 foundations executed in sequential mode — 3 atomic commits, 72 new tests, npm run ci green. CORE-02 / CORE-03 / CORE-11 / UX-10 / UX-11 foundation requirements landed and unit-tested. Ready for `/gsd-execute-phase 2` to run Wave 1.
+Last activity: 2026-05-09 -- Plan 02-01 execute complete
 
-Progress: [█░░░░░░░░░] 12%
+Progress: [█░░░░░░░░░] 14%
 
 ## Verification Results
 
@@ -61,20 +61,21 @@ Gates run: lint (exit 0), test (53/53 green, 12 files), validate:assets (2 asset
 
 **Velocity:**
 
-- Total plans completed: 7 (1 partial — 01-05 Task 2 deferred via IOU)
-- Average duration: ~5 min (Wave 1 baseline 6min; Wave 2 plans 4–8min; Plan 07 ~2min)
-- Total execution time: ~30 min across all of Phase 1
+- Total plans completed: 8 (1 partial — 01-05 Task 2 deferred via IOU)
+- Average duration: ~5 min (Wave 1 baseline 6min; Wave 2 plans 4–8min; Plan 07 ~2min; Plan 02-01 ~12min — Phase-2 foundations are heavier)
+- Total execution time: ~42 min across Phase 1 + Phase 2 Wave 0
 
 **By Phase:**
 
 | Phase | Plans | Total | Avg/Plan |
 |-------|-------|-------|----------|
 | 1. Foundations & Doctrine | 7/7 (complete) | ~30 min | ~5 min |
+| 2. Season 1 Vertical Slice (Soil) | 1/5 (Wave 0 complete) | ~12 min | ~12 min |
 
 **Recent Trend:**
 
-- Last 5 plans: [01-03 save-layer · 01-04 content-pipeline · 01-05 asset-provenance (partial) · 01-06 doctrine-docs · 01-07 ci-workflow — all green]
-- Trend: ↘ (Wave 2/3 plans came in faster than Wave 1's scaffolding; YAML-only Plan 07 was the cheapest at ~2min)
+- Last 5 plans: [01-04 content-pipeline · 01-05 asset-provenance (partial) · 01-06 doctrine-docs · 01-07 ci-workflow · 02-01 foundations — all green]
+- Trend: ↗ (02-01 was 12 min — heavier than any Phase-1 plan because it covers BigQty + scheduler + Zustand store + save extension + lifecycle hooks + ESLint rule across 3 atomic commits)
 
 *Updated after each plan completion*
 
@@ -87,6 +88,9 @@ Recent decisions affecting current work:
 
 - Phase 1 will land all retrofit-hostile foundations (versioned saves, content/asset pipelines, sim/render firewall, anti-FOMO doctrine, Season 7 end-state design) before any feature code — research from all four researchers converged on this ordering. COMPLETE.
 - Phase 2 will ship Season 1 as a complete vertical slice that could *plausibly* ship as a free standalone prologue ahead of Seasons 2-7, defending against the 7-Season scope risk.
+- Plan 02-01 (Wave 0): BLOCKER 3 lastTickAt-vs-tickCount split landed — SimState carries TWO time fields with strict ownership (lastTickAt = wall-clock, app-only writes; tickCount = sim-internal monotonic). simAdapter.applyTickCount is the canonical sim → store path. Pinned by 3 store tests + 1 migrations test.
+- Plan 02-01 (Wave 0): V1Payload extended in place per D-34 (no migrations[2]) — Phase-1's v1 has shipped zero production saves so adding fields with defaults in migrations[1] is cleaner. Regression-defense test asserts Object.keys(migrations).sort() === ['1'].
+- Plan 02-01 (Wave 0): ESLint sim-purity rule (Block 3 of eslint.config.js) is the mechanical defense for D-33 — bans Date.now() and setInterval in src/sim/** with src/sim/scheduler/clock.ts as the lone exception. Programmatic Vitest test against the date-now-violator fixture proves the rule fires; negative test on clock.ts proves the exception holds.
 - Phases 4-7 deliver the remaining six Seasons in mechanic-introducing pairs (Season 2 alone with prestige, Seasons 3-4, Seasons 5-6, Season 7 alone) — at most one new mechanic per Season per the scope-defense doctrine.
 - Plan 01-01: scaffolded by hand (the official `npm create @phaserjs/game@latest` is interactive-only — `--template react-ts --yes` flags are silently ignored as of create-game v1.3.2); plan's documented fallback path was used. Vite 8 + TS 6 referenced-projects tsconfig layout adopted; `build` runs `tsc -b && vite build` so strict-TS gates every build. ESLint 9 installed → Plan 02 must use **flat config** (`eslint.config.js`), not legacy `.eslintrc.*`.
 - Plan 01-01: pre-installed `fake-indexeddb@^6` here so Plan 03 doesn't have to re-edit `package.json`. All Phase-1 dep versions match RESEARCH.md exactly within their `^` ranges.
@@ -117,5 +121,5 @@ Items acknowledged and carried forward:
 ## Session Continuity
 
 Last session: 2026-05-09
-Stopped at: Phase 2 planning complete — 5 PLAN.md files written across 3 waves; plan-checker PASSED after 3 revision iterations (13 issues → 3 → 0); all 24 REQ-IDs and 34 D-XX decisions covered.
-Next action: `/gsd-execute-phase 2` to execute the Season 1 Vertical Slice (Wave 0 first; Waves 1+2 can run in parallel within their wave)
+Stopped at: Phase 2 Wave 0 (Plan 02-01 foundations) executed in sequential mode — 3 atomic commits (58db532, fe99058, 2a8d354), 72 new tests, 128/128 total green, npm run ci exits 0. CORE-02/CORE-03/CORE-11/UX-10/UX-11 building blocks landed and unit-tested. SUMMARY at .planning/phases/02-season-1-vertical-slice-soil/02-01-foundations-SUMMARY.md.
+Next action: `/gsd-execute-phase 2` to run Wave 1 (02-02 begin-plant-grow + 02-03 harvest-journal-fragments) in parallel against the Wave-0 foundation. Wave 2 (02-04 + 02-05) follows after Wave 1.