.planning/HANDOFF.json

@@ -0,0 +1,112 @@
+{
+  "version": "1.0",
+  "timestamp": "2026-05-21T08:22:59.958Z",
+  "phase": "04",
+  "phase_name": "Harden + clean up (optional)",
+  "phase_dir": ".planning/phases/04-harden-clean-up-optional",
+  "wave": "pre-execution",
+  "status": "paused",
+  "plan_count": 7,
+  "next_plan": "04-01",
+  "completed_this_session": [
+    {"id": "resume-from-a440c7d", "name": "Resume from prior /gsd-pause-work checkpoint", "status": "done"},
+    {"id": "phase-2-execute", "name": "Phase 2 execution (4 plans + closure)", "status": "done", "notes": "UAT 24→29 GREEN; vitest 153→171 GREEN; D-P2-01 closes audit P0-6; D-P2-02/03 close P1 #10; verifier PASSED 5/5 with T5 override"},
+    {"id": "phase-3-discuss", "name": "Phase 3 discuss-phase complete", "status": "done", "commit": "dba51ea", "notes": "5 plans + 4 D-P3-* locked decisions; spirit interpretation clarification"},
+    {"id": "phase-3-ui", "name": "Phase 3 UI-SPEC (null-spec)", "status": "done", "commit": "03d4b33", "notes": "Verification-only phase; 6/6 dimensions PASS"},
+    {"id": "phase-3-plan", "name": "Phase 3 plan-phase (5 plans, plan-checker iter-1 PASSED + 1 cosmetic warning fixed)", "status": "done", "commits": ["b3bfbf4", "de3f147"]},
+    {"id": "phase-3-execute", "name": "Phase 3 execution (5 plans + closure)", "status": "done", "notes": "UAT 29→33 GREEN (A29 A30 A31 A32); vitest 171/171 preserved; cs-injection-world pattern introduced; src/content/index.ts untouched per D-P3-02"},
+    {"id": "phase-3-verify", "name": "Phase 3 verifier audit PASSED + §10 #9 user ack", "status": "done", "notes": "5/5 ROADMAP + 9/9 SPEC §10 with 4 overrides incl. §10 #9 RAM ceiling user-acked on harness scaffolding + alpha distribution coverage"},
+    {"id": "phase-4-discuss", "name": "Phase 4 discuss-phase complete", "status": "done", "notes": "5 D-P4-* locked decisions; user chose Full Phase 4 (recommended for v1 quality)"},
+    {"id": "phase-4-ui", "name": "Phase 4 UI-SPEC (thin-design-surface dark-logo)", "status": "done", "commits": ["55cefba", "266aa95"], "notes": "5/6 dimensions PASS + 1 FLAG non-blocking on inherited type scale; Option A currentColor SVG strategy locked"},
+    {"id": "phase-4-research", "name": "Phase 4 light research (~10-20 min scope-limited)", "status": "done", "commit": "d1f6767", "notes": "5 findings: setimmediate Option a; SW persistence spike-first; A29 cs-injection-world verbatim port; cursor:'always' ALREADY shipped at recorder.ts:285; 6 anticipated Wave 0 test files"},
+    {"id": "phase-4-pattern", "name": "Phase 4 pattern map", "status": "done", "commit": "f012c8c", "notes": "~30 anticipated files mapped (21 exact + 8 role-match + 1 NEW pattern stopServiceWorker CDP helper)"},
+    {"id": "phase-4-plan", "name": "Phase 4 plan-phase (7 plans across 6 waves)", "status": "done", "commits": ["526ac78", "76fffb3", "3c1280e", "55369b8"], "notes": "Plan-checker iter-1: 2 BLOCKERS + 4 WARNINGS → iter-2 revision applied → iter-2: VERIFICATION PASSED + 3 cosmetic advisories all fixed"}
+  ],
+  "remaining_tasks": [
+    {
+      "id": "04-execute",
+      "name": "Execute Phase 4 (7 plans across 6 waves; ~6-8h foreground)",
+      "status": "ready",
+      "plans": [
+        {"id": "04-01", "wave": 1, "type": "tdd", "name": "Audit P1 polish #11+#14+#15 (RED→GREEN 3 unit tests in src/content/index.ts)", "deps": []},
+        {"id": "04-02", "wave": 1, "type": "tdd", "name": "Build/CSP hygiene — setimmediate polyfill Option a + dead-code grep SC#4 + generate-icons.cjs SC#3", "deps": []},
+        {"id": "04-03", "wave": 2, "type": "auto", "name": "A29 cs-injection-world rewrite (closes ~1/3 flake; strict-sentinel filter for IncrementalSource.Mutation)", "deps": ["01", "02"]},
+        {"id": "04-04", "wave": 3, "type": "spike→auto", "name": "A33 SW state persistence — Wave 0 SPIKE FIRST per RESEARCH finding 2; uses chrome.runtime.sendMessage Option B (no dispatchSaveArchive helper)", "deps": ["01", "02", "03"]},
+        {"id": "04-05", "wave": 4, "type": "auto", "name": "A34 fetch+XHR network_error empirical (ROADMAP SC #2; validates Plan 04-01 P1#11 end-to-end)", "deps": ["01", "02", "03", "04"]},
+        {"id": "04-06", "wave": 5, "type": "auto+human-verify", "name": "Visual polish — dark-logo currentColor (5 UI-SPEC file edits) + cursor verification (already shipped) + 01-07-SUMMARY back-patch + operator empirical", "deps": ["01", "02", "03", "04", "05"]},
+        {"id": "04-07", "wave": 6, "type": "auto", "name": "Phase 4 closure — VERIFICATION.md aggregator + ROADMAP backfill (D-P4-05) + REQUIREMENTS marker flips + milestone v1 close prep", "deps": ["01", "02", "03", "04", "05", "06"]}
+      ],
+      "resume_with": "/gsd-execute-phase 4 (canonical Skill; ~6-8h foreground) OR /gsd-execute-phase 4 --wave 1 (Wave 1: 04-01+04-02 parallel; ~30-60 min)"
+    },
+    {
+      "id": "milestone-v1-close",
+      "name": "Milestone v1 close (post-Phase-4)",
+      "status": "pending_phase_4",
+      "details": "After Phase 4 closes: re-package fresh build for testers (npm run build && zip dist + INSTALL.md → dist-archives/mokosh-build-2026-05-21-<HEAD>.zip); tag v1.0; write release notes. Per D-P4-04: user routes alpha findings out-of-band; Phase 4 closure is independent of alpha tester confirmation."
+    }
+  ],
+  "blockers": [],
+  "human_actions_pending": [
+    {
+      "action": "Plan 04-06 Task 4 — operator empirical UAT (dark-logo aesthetic judgment in OS dark mode)",
+      "context": "UI-SPEC AC #6 reserves WCAG contrast judgment for operator empirical; A32-pattern visual judgment is the canonical Phase 4 human-verify case. Operator should verify dark-mode rendering of mokosh-mark with currentColor strategy is acceptable.",
+      "blocking": false
+    }
+  ],
+  "decisions_this_session": [
+    {"decision": "Phase 4 = Full scope (D-P4-01)", "rationale": "User chose 'Full Phase 4 (Recommended for v1 quality)' — most rigorous. All 4 ROADMAP SC + ~10 of 12 deferred items. Excludes rrweb v2 upgrade + programmatic SW-RAM (defer to v2)."},
+    {"decision": "Audit P1 all three (#11+#14+#15) (D-P4-02)", "rationale": "All three are correctness fixes in src/content/index.ts; cohesive content-script polish."},
+    {"decision": "Visual polish both items (cursor + dark-logo) (D-P4-03)", "rationale": "Both operator-perceptible; small surgical fixes."},
+    {"decision": "Alpha tester integration user-handled out-of-band (D-P4-04)", "rationale": "User: 'no no, if something i'll tell you' — Phase 4 executes independently; faster to v1 close."},
+    {"decision": "ROADMAP backfill in scope (D-P4-05)", "rationale": "Docs hygiene; ~15 min; keeps canonical reference document accurate."},
+    {"decision": "UI-SPEC Option A — currentColor SVG + ?raw import + DOMParser inline", "rationale": "5 file edits; preserves @crxjs auto-WAR; CSS color cascade resolves stroke; forward-compat for future surfaces without colored wrappers."},
+    {"decision": "Plan 04-04 Option B (chrome.runtime.sendMessage inline) for SAVE_ARCHIVE dispatch", "rationale": "BLOCKER 2 iter-1 fix: dispatchSaveArchive does NOT exist on __mokoshHarness (verified); use existing pattern from 9 assertA* methods; no new helper to maintain."},
+    {"decision": "Plan 04-06 Task 4 SW chunk glob = `dist/assets/index.ts-*.js`", "rationale": "BLOCKER 1 iter-1 fix: `index*-bg.js` matched nothing; verified `index.ts-8LkXuqac.js` on disk; added glob-existence pre-gate."},
+    {"decision": "§10 #9 RAM closed on harness scaffolding + alpha coverage 2026-05-20", "rationale": "User explicit ack; A32 best-effort + chrome://memory-internals operator path + alpha distribution = acceptable for v1; programmatic chrome.devtools Memory API deferred to v2."}
+  ],
+  "session_anti_patterns": [
+    {
+      "name": "state.record-session CLI bug — recurring",
+      "severity": "advisory",
+      "details": "gsd-sdk query state.record-session flips STATE.md `status` to `completed` when total_plans/completed_plans ratio triggers it (e.g., 23/23 or 23/30 with mixed-progress phases). Recurred at every state.record-session call this session (Phase 2 closure + Phase 3 discuss + Phase 3 UI + Phase 3 plan + Phase 3 execute closure + Phase 4 discuss + Phase 4 UI + Phase 4 plan closure). NEXT-SESSION: manually fix status field after every state.record-session call. Upstream GSD framework concern; not Mokosh-side."
+    },
+    {
+      "name": "/gsd-plan-phase UI gate auto-exits on manual invocation",
+      "severity": "advisory",
+      "details": "Manual /gsd-plan-phase invocation cannot nested-Skill-spawn /gsd-ui-phase due to AskUserQuestion-in-subcontext issue #1009. Workflow correctly exits + tells user to run /gsd-ui-phase separately, then re-run /gsd-plan-phase. Pattern used twice this session (Phase 3 + Phase 4). Each time required preserving gate answers in .plan-phase-preferences.md (auto-deleted on next plan-phase consumption). NEXT-SESSION: standard pattern; not a defect."
+    },
+    {
+      "name": "Plan-checker line-range disjointness check missing",
+      "severity": "advisory",
+      "details": "Plan 02-04 + Plan 04-06 both demonstrated that Wave 2+ plans modifying the SAME file but DIFFERENT line ranges can theoretically parallelize but planner conservatively sequentializes. Plan-checker doesn't validate line-range disjointness — only file-level overlap. This led to Phase 2 Wave 2 sequential + Phase 3 5-sequential-waves + Phase 4 Wave 1 parallel (no file overlap). NEXT-SESSION: when reviewing wave structure, manually check line-range disjointness for potential parallelization wins."
+    }
+  ],
+  "uncommitted_files": [],
+  "context_notes": "Phase 4 plan-phase fully closed. 7 plans validated by plan-checker iter-2 (after iter-1 fixed 2 BLOCKERS: SW chunk glob misquote + non-existent dispatchSaveArchive). 3 cosmetic advisories also fixed (RESEARCH heading suffix + PATTERNS stale example + VALIDATION count typo). Test baselines preserved: vitest 171/171 · UAT harness 33/33 · Tier-1 FORBIDDEN_HOOK_STRINGS 12 · pre-checkpoint bundle gates 6/6 PASS standard inventory. Branch: gsd/phase-03-spec-10-smoke-verification-dom-event-log-verification at HEAD 55369b8 (Phase 4 branch NOT yet created — happens in /gsd-execute-phase 4 per branching_strategy=phase). Working tree clean.\n\nPhase 4 is the final v1 milestone phase. After execution closes (~6-8h foreground), milestone v1 ready for: fresh alpha re-distribution (per D-P4-04: user routes findings out-of-band), v1.0 tag + release notes.\n\nMassive session arc: Phase 2 execution + closure → Phase 3 discuss+UI+plan+execute+closure → Phase 4 discuss+UI+research+pattern+plan+revision. Three phases closed end-to-end + Phase 4 fully planned. Test baseline growth: vitest 153→171 GREEN (+18); UAT 24→33 GREEN (+9 incl. A24-A32). 4 saved memories cited throughout: feedback-no-unilateral-scope-reduction + feedback-gsd-ceremony-for-fixes + feedback-pre-checkpoint-bundle-gates + feedback-trust-harness-over-manual-uat.",
+  "next_action": "After /clear: run /gsd-resume-work to load this HANDOFF.json + .continue-here.md. Recommended first step: /gsd-execute-phase 4 (canonical Skill; ~6-8h foreground) OR /gsd-execute-phase 4 --wave 1 (Wave 1 only: 04-01 + 04-02 parallel; ~30-60 min). Phase 4 execution will need user input ONLY at Plan 04-06 Task 4 operator empirical checkpoint (dark-logo aesthetic judgment in OS dark mode).",
+  "ceremony_state": {
+    "discuss_phase_complete": true,
+    "ui_phase_complete": true,
+    "research_complete": true,
+    "pattern_mapper_complete": true,
+    "plan_phase_complete": true,
+    "plan_checker_passes": 2,
+    "blockers_resolved": ["B1-sw-chunk-glob", "B2-non-existent-dispatchSaveArchive"],
+    "warnings_resolved": ["W1-uat-harness-in-verify", "W4-operator-ack-grep"],
+    "warnings_advisory_only": ["W2-04-06-scope-sanity", "W3-04-03-conservative-dep"],
+    "cosmetic_advisories_resolved": ["Dim11-research-heading-suffix", "Dim12-patterns-stale-example", "validation-md-revision-count-typo"]
+  },
+  "test_baselines": {
+    "vitest_green": 171,
+    "uat_green": 33,
+    "forbidden_hook_strings_count": 12,
+    "production_bundle_hook_free": true,
+    "pre_checkpoint_bundle_gates": "6/6 PASS standard inventory",
+    "phase_4_expected_targets": {
+      "vitest": "171 + ~8-10 (Wave 0 unit tests: P1 #11/#14/#15 + 2 build gates + welcome inline-svg) = ~180 GREEN",
+      "uat": "33 → 35 GREEN (+A33 SW persistence + A34 fetch/XHR network_error)",
+      "tier1_forbidden_hook_strings": "12 unchanged (A33+A34 ride production surfaces; no __MOKOSH_UAT__ symbols)",
+      "bundle_gates": "6/6 PASS — Gate 2 (SW CSP-safety `new Function`) flips from 1 documented exception to 0 hits after Plan 04-02 setimmediate polyfill replacement"
+    }
+  }
+}

.planning/phases/04-harden-clean-up-optional/.continue-here.md

@@ -0,0 +1,124 @@
+---
+context: phase
+phase: 04-harden-clean-up-optional
+plan_count: 7
+status: paused
+last_updated: 2026-05-21T08:22:59.958Z
+---
+
+# BLOCKING CONSTRAINTS — None
+
+> No blocking constraints introduced this session. Three **advisory** anti-patterns logged below (do not gate resumption).
+
+## Critical Anti-Patterns
+
+| Pattern | Description | Severity | Prevention Mechanism |
+|---------|-------------|----------|---------------------|
+| state.record-session CLI bug — recurring | gsd-sdk query state.record-session flips STATE.md `status` to `completed` when total_plans/completed_plans ratio triggers it. Recurred at 8+ state.record-session calls this session. | advisory | NEXT-SESSION: manually fix STATE.md `status` field after every state.record-session call. Upstream GSD framework concern; not Mokosh-side. |
+| /gsd-plan-phase UI gate auto-exits on manual invocation | Manual /gsd-plan-phase cannot nested-Skill-spawn /gsd-ui-phase due to AskUserQuestion-in-subcontext issue #1009. Workflow correctly exits + tells user to run /gsd-ui-phase separately. | advisory | Pattern used twice this session (Phase 3 + Phase 4); preserve gate answers in .plan-phase-preferences.md (auto-deleted on next plan-phase consumption). Standard pattern; not a defect. |
+| Plan-checker line-range disjointness check missing | Plan-checker only validates file-level overlap; doesn't check line-range disjointness for potential parallelization wins. | advisory | NEXT-SESSION: when reviewing wave structure, manually check line-range disjointness if files_modified overlap is present. |
+
+---
+
+## Current State
+
+**Phase 4 (Harden + clean up — optional) PLANNING COMPLETE.** Ready for execution. This is the final v1 milestone phase.
+
+- Branch: `gsd/phase-03-spec-10-smoke-verification-dom-event-log-verification` at HEAD `55369b8` (Phase 4 branch NOT yet created — happens in `/gsd-execute-phase 4` per branching_strategy=phase)
+- 7 plans validated + plan-checker iter-2 PASSED + 3 cosmetic advisories fixed
+- Test baselines: vitest 171/171 GREEN · UAT 33/33 GREEN · Tier-1 FORBIDDEN_HOOK_STRINGS 12 · pre-checkpoint bundle gates 6/6 PASS
+- Working tree: clean
+
+## Plans Ready for Execution
+
+| Plan | Wave | Type | Scope | Closes |
+|---|---|---|---|---|
+| **04-01** | 1 | tdd | Audit P1 polish (RED→GREEN 3 unit tests in src/content/index.ts:147 + 99-109 + 36-42) | Audit P1 #11/#14/#15 |
+| **04-02** | 1 (parallel) | tdd | Build/CSP hygiene — setimmediate polyfill Option a + dead-code grep + generate-icons.cjs | ROADMAP SC #3 + #4 |
+| **04-03** | 2 | auto | A29 cs-injection-world rewrite (strict-sentinel filter for IncrementalSource.Mutation) | ~1/3 flake from Phase 3 |
+| **04-04** | 3 | spike→auto | A33 SW state persistence — **Wave 0 SPIKE FIRST**; chrome.runtime.sendMessage Option B | ROADMAP SC #1 |
+| **04-05** | 4 | auto | A34 fetch+XHR network_error empirical (validates 04-01 P1#11 end-to-end) | ROADMAP SC #2 |
+| **04-06** | 5 | auto + human-verify | Visual polish — dark-logo currentColor (5 UI-SPEC edits) + cursor verification + operator empirical | D-P4-03 |
+| **04-07** | 6 | auto | VERIFICATION.md aggregator + ROADMAP backfill + REQ marker flips + milestone v1 close prep | D-P4-05 + Phase 4 closure |
+
+**Wave 1 parallelization:** 04-01 + 04-02 are file-disjoint (04-01 src/content/* + 04-02 vite/SW/build-tests) — safe parallel.
+**Waves 2-6 sequential:** file-overlap on tests/uat/* harness files.
+
+## Recent commit chain (most recent first)
+
+- `55369b8` docs(state): record phase 4 plan-phase closure — iter-2 PASSED + 3 cosmetic advisories fixed
+- `3c1280e` docs(04): plan-phase closure — 3 cosmetic advisories from checker iter-2 resolved
+- `76fffb3` fix(04): revise plans per checker iter-1 — 2 BLOCKERS + 2 WARNINGS fixed
+- `526ac78` docs(04): create phase plan — 7 plans for Phase 4 hardening
+- `f012c8c` docs(04): pattern map — ~30 anticipated files mapped
+- `7178d14` docs(phase-04): add validation strategy
+- `d1f6767` docs(04): research phase domain — 5 findings incl. cursor:'always' ALREADY shipped
+- `61caf04` docs(state): record phase 4 UI-SPEC session — APPROVED 5/6 + 1 FLAG
+- `266aa95` docs(04): UI-SPEC.md status approved (5/6 PASS + 1 FLAG non-blocking)
+- `55cefba` docs(04): UI design contract — thin scope (dark-logo currentColor strategy)
+- (… Phase 3 closure + Phase 2 closure earlier)
+
+## Required Reading (in order)
+
+1. `.planning/HANDOFF.json` — machine-readable handoff (sibling)
+2. `.planning/STATE.md` — current progress (Phase 3 CLOSED; Phase 4 ready)
+3. `.planning/ROADMAP.md` — 4-phase milestone structure; Phase 4 optional
+4. `.planning/REQUIREMENTS.md` — all v1 REQs verified (Phase 4 has no new REQs)
+5. `.planning/PROJECT.md` — Validated section split by phase
+6. `.planning/phases/04-harden-clean-up-optional/04-CONTEXT.md` — 5 D-P4-* locked decisions
+7. `.planning/phases/04-harden-clean-up-optional/04-UI-SPEC.md` — thin-design-surface dark-logo (Option A currentColor; 5 prescribed file edits)
+8. `.planning/phases/04-harden-clean-up-optional/04-RESEARCH.md` — 5 findings; **CRITICAL finding 4: cursor:'always' ALREADY SHIPPED at src/offscreen/recorder.ts:285** (Plan 04-06 cursor task = verification only)
+9. `.planning/phases/04-harden-clean-up-optional/04-PATTERNS.md` — ~30 files mapped + DEPRECATED banner at line 886 (citing Plan 04-04 Option B)
+10. `.planning/phases/04-harden-clean-up-optional/04-VALIDATION.md` — 16-row per-task verification map; iter-2 revised
+11. `.planning/phases/04-harden-clean-up-optional/04-0{1..7}-PLAN.md` — 7 plans ready
+12. Auto-memory at `/home/parf/.claude/projects/-home-parf-projects-work-repremium/memory/MEMORY.md` — 4 feedback constraints from prior sessions
+
+## Decisions Locked This Session (Phase 4)
+
+- **D-P4-01:** Full Phase 4 scope (all 4 ROADMAP SC + ~10 of 12 deferred items)
+- **D-P4-02:** Audit P1 all three (#11 fetch + #14 nav URL + #15 rrweb timestamps)
+- **D-P4-03:** Both visual polish items (cursor + dark-logo)
+- **D-P4-04:** Alpha tester integration user-handled out-of-band
+- **D-P4-05:** ROADMAP backfill in scope (docs hygiene)
+- **UI-SPEC Option A:** currentColor SVG + ?raw import + DOMParser inline (5 file edits)
+- **Plan 04-04 Option B:** chrome.runtime.sendMessage inline for SAVE_ARCHIVE dispatch (BLOCKER 2 fix — no dispatchSaveArchive helper)
+- **Plan 04-06 Task 4 glob:** `dist/assets/index.ts-*.js` (BLOCKER 1 fix + glob-existence pre-gate)
+- **§10 #9 RAM closure:** user explicit ack 2026-05-20 on harness scaffolding + alpha distribution coverage path
+
+## Next-Session Order of Operations
+
+1. **`/gsd-resume-work`** to load this `.continue-here.md` + `.planning/HANDOFF.json`
+2. **Acknowledge any blocking constraints** (none this session; 3 advisory anti-patterns above)
+3. **`/gsd-execute-phase 4`** to start Phase 4 execution (~6-8h foreground; canonical Skill)
+   - Alternative: `/gsd-execute-phase 4 --wave 1` lands Wave 1 (04-01 + 04-02 parallel) only (~30-60 min)
+4. After Phase 4 closes: milestone v1 close prep (fresh alpha re-distribution + v1.0 tag + release notes per D-P4-04)
+
+## Infrastructure State
+
+- Branch: `gsd/phase-03-spec-10-smoke-verification-dom-event-log-verification` at HEAD `55369b8` — Phase 4 branch NOT yet created (happens in /gsd-execute-phase 4)
+- Working tree clean
+- Test baselines preserved: vitest 171/171 GREEN · UAT 33/33 GREEN · Tier-1 12 · bundle gates 6/6 PASS
+- Saved memories applied throughout: feedback-no-unilateral-scope-reduction + feedback-gsd-ceremony-for-fixes + feedback-pre-checkpoint-bundle-gates + feedback-trust-harness-over-manual-uat
+
+## Phase 4 Expected Outcomes
+
+- vitest: 171 → ~180 GREEN (+~10 Wave 0 unit tests: P1 #11/#14/#15 + 2 build gates + welcome inline-svg)
+- UAT harness: 33 → 35 GREEN (+A33 SW persistence + A34 fetch/XHR network_error)
+- Tier-1 FORBIDDEN_HOOK_STRINGS: 12 unchanged (A33+A34 ride production surfaces)
+- Bundle gates 6/6 PASS — Gate 2 (SW CSP-safety `new Function`) flips from 1 documented exception to **0 hits** after Plan 04-02 setimmediate polyfill replacement
+- ROADMAP success criteria #1-#4 all verified
+- Plan 04-06 Task 4 operator empirical UAT (dark-logo aesthetic judgment in OS dark mode)
+- Milestone v1 ready for tag + release notes after Phase 4 closure
+
+## Pending Human Action (non-blocking, deferred to Phase 4 execution)
+
+- **Plan 04-06 Task 4 operator empirical UAT** — dark-logo aesthetic judgment in OS dark mode (UI-SPEC AC #6; canonical Phase 4 human-verify case)
+- All other Phase 4 surfaces are harness-covered or grep-verifiable
+
+## Context
+
+Massive session arc: 2026-05-20 → 2026-05-21 spanning Phase 2 execution + closure, Phase 3 full lifecycle (discuss + UI + plan + execute + closure), Phase 4 full pre-execution lifecycle (discuss + UI + research + pattern + plan + 2-iteration plan-checker revision). Three phases closed end-to-end; Phase 4 fully planned + validated; ready for execution. User explicitly chose canonical GSD ceremony throughout (consistent pattern across all phases). Test baseline growth this session: vitest 153→171 GREEN (+18); UAT 24→33 GREEN (+9 incl. A24-A32). 4 saved memories cited throughout. Phase 4 is the final v1 milestone phase; after closure, milestone v1 is ready for release.
+
+## Next action
+
+Start with: `/gsd-resume-work` to load this handoff, then `/gsd-execute-phase 4` to start Phase 4 execution.