` from App.tsx): ```html

``` From src/game/main.ts (Phaser config — backgroundColor #1a1a1a; parent 'game-container'): ```typescript const config: Phaser.Types.Core.GameConfig = { type: Phaser.AUTO, width: 1024, height: 768, parent: 'game-container', backgroundColor: '#1a1a1a', scale: { mode: Phaser.Scale.FIT, autoCenter: Phaser.Scale.CENTER_BOTH }, scene: [Boot, Garden], }; ``` From src/store/session-slice.ts (Plan 02-01 + 02-05 — current SessionSlice): ```typescript export interface SessionSlice { beginGateDismissed: boolean; persistenceToastShown: boolean; showPersistenceToast: boolean; letterOverlayOpen: boolean; pendingLetterEventBlock: unknown | null; compostBeatTick: number; // ... actions dismissBeginGate: () => void; setPersistenceToastShown: (v: boolean) => void; setShowPersistenceToast: (v: boolean) => void; openLetter: (block: unknown) => void; dismissLetter: () => void; bumpCompostBeat: () => void; } // Default state: beginGateDismissed=false, ... ``` From src/App.tsx (Plan 02-05 — currently mounts BeginScreen, SeedPicker, FragmentRevealModal, JournalIcon, LuraDialogue, Letter, Settings, PersistenceToast, CompostToast): ```typescript return (

setSettingsOpen(false)} />

); ``` From src/ui/begin/BeginScreen.tsx (Plan 02-02 — single fixed-position dialog covering canvas; dismissed via session.beginGateDismissed; existing pattern to copy for FirstRunHint shape): ```typescript export function BeginScreen(): JSX.Element | null { const dismissed = useAppStore((s) => s.beginGateDismissed); const dismissBeginGate = useAppStore((s) => s.dismissBeginGate); if (dismissed) return null; // ... fixed-position dialog with title/subtitle/Begin button } ``` From src/render/garden/tile-renderer.ts (Plan 02-02 — current dim values that G3 fixes): ```typescript const OUTLINE_COLOR = 0x4d4d52; // ← G3: brighten to 0x5a5a60 const OUTLINE_HOVER = 0x6e6e75; // ← G3: brighten to 0x7a7a82 const OUTLINE_ALPHA = 0.6; // drawTiles creates 16 tile graphics + hit rectangles; pointerover/pointerout // swap the outline color via drawOutline(). ``` From src/render/garden/gate-renderer.ts (Plan 02-04 — current gate primitives; G4 adds a wall band): ```typescript const GATE_X = 880; const GATE_Y = 384; const GATE_COLOR = 0x6e6e75; const GATE_HIT_W = 80; const GATE_HIT_H = 120; // drawGate adds: body (rectangle), glow (rectangle, alpha 0), hit (transparent // interactive rectangle). G4 adds a 4th: wall (vertical band at GATE_X, // full canvas height 768, low alpha ~0.18). ``` From content/seasons/01-soil/ui-strings.yaml (Plan 02-02 + 02-05 current shape — G2 adds first_run_hint): ```yaml season: 1 begin: title: "The Last Garden" subtitle: "tend" cta: "Begin" seed_picker: title: "Sow" cancel: "Not yet" post_harvest_beat: - "The earth remembers." - "Something stayed." - "It rests where it grew." journal: empty_state: "Nothing yet. Plant something." back: "Close" settings: title: "Settings" export: "Save to a copy" import: "Restore from a copy" restore_snapshot: "Earlier garden" persistence_denied_toast: "The garden may forget, if your browser asks it to." plants: rosemary: "Rosemary" yarrow: "Yarrow" winter-rose: "Winter-rose" # ← G2 ADDS: # first_run_hint: "" ``` From src/content/schemas/* (Plan 01-04 — UiStringsSchema validates ui-strings.yaml at build time): The Zod schema is currently typed for the structure above. Task 2 may need to add `first_run_hint: z.string()` to the schema if strict-typed parsing rejects unknown keys. Read `src/content/schemas/index.ts` to confirm whether the schema is strict (z.object().strict()) or lenient (default — extra keys ignored). Almost certainly lenient, in which case no schema change is needed; if strict, Task 2 must extend the schema. From src/store/index.ts (Plan 02-01 + 02-05 barrel — actions exposed to React via useAppStore): useAppStore is a vanilla zustand store; subscribing to a single field (e.g. `useAppStore(s => s.beginGateDismissed)`) is the canonical pattern. The Garden scene also subscribes via `appStore.subscribe(selector, callback)` for non-React tick-driven repaints. From src/sim/garden/commands.ts (Plan 02-02/02-03/02-04 — plantSeed dispatch path): The store enqueues a command via `enqueueCommand({kind: 'plantSeed', tileIdx, plantTypeId})`. The Garden scene's update loop drains the queue once per tick. Detection of "first plant has occurred" can be done by subscribing to a derived selector — simplest reliable signal: subscribe to `harvestedFragmentIds.length OR tiles.some(t => t?.plant !== null)`. The cleanest path: subscribe to `tiles` and dismiss FirstRunHint the first time any tile has `plant !== null`. (Subscribing to plantSeed enqueues directly is brittle; the queue may apply asynchronously.) From tests/e2e/season1-loop.spec.ts (Plan 02-05 — current full-loop spec; Task 5 extends with 3 assertions): ```typescript test('load → begin → plant → fast-forward → harvest → reveal → journal → reload → persist', async ({ page }) => { await page.goto('/?devtime=fake'); await ensureFreshSave(page); await page.goto('/?devtime=fake'); // Begin button visible, click it → bootstrap audio → tiles drain. // ... existing 16-step assertion chain. }); ``` Task 5 threads: - After step 1 (initial nav): assert document.body computed background-color is `rgb(26, 26, 26)`. - After step 3 (Begin dismissed): assert the FirstRunHint element is visible. - After step 5/6 (plantSeed enqueued + applied to tile 0): assert the FirstRunHint is gone. From .planning/phases/02-season-1-vertical-slice-soil/02-VERIFICATION.md frontmatter `gaps:` block: - G1: src/main.tsx + no src/index.css; fix CSS body bg #1a1a1a + zero margin + serif color #e8e0d0. - G2: post-BeginScreen state — no instruction; fix tiny FirstRunHint with copy from ui-strings.yaml; auto-dismiss on first plant; session-state only (no migrations[2]). - G3: tile outlines too dim — brighten OUTLINE_COLOR (~0x4d4d52 → ~0x5a5a60) + add clearer hover (~0x7a7a82 + slight fill alpha bump). - G4: gate stands alone — add faint vertical band Phaser primitive (alpha 0.15-0.20 against #1a1a1a) at the gate's column connecting top-to-bottom of canvas. Task 1 (G1 — BLOCKING): Add src/index.css imported from main.tsx — close the white-halo gap - .planning/phases/02-season-1-vertical-slice-soil/02-VERIFICATION.md (frontmatter `gaps:` G1 entry — surface, evidence, fix_shape verbatim) - src/main.tsx (current 14-line entry — needs an `import './index.css';` line added after the StrictMode/createRoot imports) - src/game/main.ts (Phaser canvas backgroundColor #1a1a1a — body must match for tonal coherence) - index.html (currently no `