docs(08-01): complete theme foundation plan 01

- SUMMARY with MD3 token system, ThemeToggle, FOUC prevention
- STATE updated: decisions, session, 97% progress
- ROADMAP phase 8 marked In Progress (1/2 plans)
- REQUIREMENTS THEME-01, THEME-02 marked complete

.planning/STATE.md

@@ -3,14 +3,14 @@ gsd_state_version: 1.0
 milestone: v1.2
 milestone_name: UI Polish & Clarity
 status: planning
-stopped_at: Phase 8 context gathered
-last_updated: "2026-03-31T15:53:28.623Z"
+stopped_at: Completed 08-01-PLAN.md — MD3 token system, ThemeToggle, dark mode
+last_updated: "2026-04-01T02:51:28.872Z"
 last_activity: 2026-03-31 — Roadmap created for v1.2
 progress:
   total_phases: 4
   completed_phases: 0
-  total_plans: 0
-  completed_plans: 0
+  total_plans: 2
+  completed_plans: 1
   percent: 0
 ---
 
@@ -42,6 +42,8 @@ Recent decisions affecting current work:
 - v1.2 roadmap: Zero new runtime dependencies — Tailwind v4 @theme + CSS custom properties only
 - v1.2 roadmap: Bottom-up migration order (tokens -> primitives -> migration -> content -> polish)
 - v1.2 roadmap: ThemeToggle via DOM class toggle, not React Context (avoids re-render cascade)
+- [Phase 08-01]: Two-layer CSS token pattern: @theme var() references + @layer base :root/.dark raw values — required for .dark cascade in Tailwind v4
+- [Phase 08-01]: vi.stubGlobal for localStorage/matchMedia in tests — Node v25 experimental WebStorage breaks standard Storage API in jsdom environment
 
 ### Pending Todos
 
@@ -54,6 +56,6 @@ None yet.
 
 ## Session Continuity
 
-Last session: 2026-03-31T15:53:28.621Z
-Stopped at: Phase 8 context gathered
-Resume file: .planning/phases/08-theme-foundation/08-CONTEXT.md
+Last session: 2026-04-01T02:51:28.870Z
+Stopped at: Completed 08-01-PLAN.md — MD3 token system, ThemeToggle, dark mode
+Resume file: None