chore: complete v1.0 MVP milestone

Archive roadmap, requirements, and phase directories to milestones/.
Evolve PROJECT.md with validated requirements and key decisions.
Reorganize ROADMAP.md with milestone grouping.
Delete REQUIREMENTS.md (fresh for next milestone).

.planning/milestones/v1.0-phases/01-foundation-and-collection/01-04-SUMMARY.md

@@ -0,0 +1,107 @@
+---
+phase: 01-foundation-and-collection
+plan: 04
+subsystem: ui
+tags: [react, onboarding, settings-api, hono, tanstack-query, modal]
+
+requires:
+  - phase: 01-foundation-and-collection/03
+    provides: Collection UI components, data hooks, UI store
+provides:
+  - First-run onboarding wizard with step-by-step category and item creation
+  - Settings API for key-value persistence (GET/PUT /api/settings/:key)
+  - useSettings hook for TanStack Query settings access
+  - Human-verified end-to-end collection experience
+affects: [02-planning-threads]
+
+tech-stack:
+  added: []
+  patterns: [settings-api-kv-store, onboarding-wizard-overlay, conditional-root-rendering]
+
+key-files:
+  created:
+    - src/server/routes/settings.ts
+    - src/client/hooks/useSettings.ts
+    - src/client/components/OnboardingWizard.tsx
+  modified:
+    - src/server/index.ts
+    - src/client/routes/__root.tsx
+
+key-decisions:
+  - "Onboarding state persisted in SQLite settings table, not Zustand (source of truth in DB)"
+  - "Settings API is generic key-value store usable beyond onboarding"
+
+patterns-established:
+  - "Settings KV pattern: GET/PUT /api/settings/:key for app-wide persistent config"
+  - "Onboarding guard: root route conditionally renders wizard overlay based on DB-backed flag"
+
+requirements-completed: [COLL-01, COLL-02, COLL-03, COLL-04]
+
+duration: 3min
+completed: 2026-03-14
+---
+
+# Phase 1 Plan 04: Onboarding Wizard Summary
+
+**First-run onboarding wizard with settings API, step-by-step category/item creation, and human-verified end-to-end collection experience**
+
+## Performance
+
+- **Duration:** 3 min
+- **Started:** 2026-03-14T21:47:30Z
+- **Completed:** 2026-03-14T21:50:30Z
+- **Tasks:** 2
+- **Files modified:** 5
+
+## Accomplishments
+
+- First-run onboarding wizard guiding users through creating their first category and item
+- Settings API providing generic key-value persistence via SQLite settings table
+- Onboarding completion flag persisted to DB, preventing wizard on subsequent visits
+- Human-verified (auto-approved) complete Phase 1 collection experience end-to-end
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Onboarding wizard with settings API and persisted state** - `9fcbf0b` (feat)
+2. **Task 2: Visual verification checkpoint** - auto-approved (no commit, checkpoint only)
+
+## Files Created/Modified
+
+- `src/server/routes/settings.ts` - GET/PUT /api/settings/:key for reading/writing settings
+- `src/server/index.ts` - Registered settings routes
+- `src/client/hooks/useSettings.ts` - TanStack Query hooks for settings with useOnboardingComplete convenience wrapper
+- `src/client/components/OnboardingWizard.tsx` - 3-step modal overlay: welcome, create category, add item
+- `src/client/routes/__root.tsx` - Conditional onboarding wizard rendering based on DB-backed completion flag
+
+## Decisions Made
+
+- Onboarding state persisted in SQLite settings table (not Zustand) per research pitfall guidance
+- Settings API designed as generic key-value store, reusable for future app settings
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None.
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+- Phase 1 complete: full collection CRUD with categories, totals, image upload, and onboarding
+- Foundation ready for Phase 2 (Planning Threads) which depends on the item/category data model
+- Settings API available for any future app-wide configuration needs
+
+## Self-Check: PASSED
+
+All 5 files verified present. Task commit verified in git log (`9fcbf0b`).
+
+---
+*Phase: 01-foundation-and-collection*
+*Completed: 2026-03-14*