docs: create milestone v1.1 roadmap (3 phases)

.planning/REQUIREMENTS.md

@@ -1,7 +1,7 @@
 # Requirements: GearBox
 
 **Defined:** 2026-03-15
-**Core Value:** Make it effortless to manage gear and plan new purchases — see how a potential buy affects your total setup weight and cost before committing.
+**Core Value:** Make it effortless to manage gear and plan new purchases -- see how a potential buy affects your total setup weight and cost before committing.
 
 ## v1.1 Requirements
 
@@ -40,7 +40,7 @@ Deferred from v1.0 Active list. Not in current roadmap.
 ### Thread Enhancements
 
 - **THRD-01**: User can compare candidates side-by-side on weight and price
-- **THRD-02**: User can track candidate status (researching → ordered → arrived)
+- **THRD-02**: User can track candidate status (researching -> ordered -> arrived)
 - **THRD-03**: User can rank/prioritize candidates within threads
 - **THRD-04**: User can preview how a candidate affects setup weight/cost
 
@@ -74,22 +74,22 @@ Which phases cover which requirements. Updated during roadmap creation.
 
 | Requirement | Phase | Status |
 |-------------|-------|--------|
-| DB-01 | — | Pending |
+| DB-01 | Phase 4 | Pending |
-| IMG-01 | — | Pending |
+| IMG-01 | Phase 5 | Pending |
-| IMG-02 | — | Pending |
+| IMG-02 | Phase 5 | Pending |
-| IMG-03 | — | Pending |
+| IMG-03 | Phase 5 | Pending |
-| IMG-04 | — | Pending |
+| IMG-04 | Phase 5 | Pending |
-| PLAN-01 | — | Pending |
+| PLAN-01 | Phase 4 | Pending |
-| PLAN-02 | — | Pending |
+| PLAN-02 | Phase 4 | Pending |
-| CAT-01 | — | Pending |
+| CAT-01 | Phase 6 | Pending |
-| CAT-02 | — | Pending |
+| CAT-02 | Phase 6 | Pending |
-| CAT-03 | — | Pending |
+| CAT-03 | Phase 6 | Pending |
 
 **Coverage:**
 - v1.1 requirements: 10 total
-- Mapped to phases: 0
+- Mapped to phases: 10
-- Unmapped: 10 ⚠️
+- Unmapped: 0
 
 ---
 *Requirements defined: 2026-03-15*
-*Last updated: 2026-03-15 after initial definition*
+*Last updated: 2026-03-15 after roadmap creation*

.planning/ROADMAP.md

@@ -2,23 +2,80 @@
 
 ## Milestones
 
-- ✅ **v1.0 MVP** — Phases 1-3 (shipped 2026-03-15)
+- ✅ **v1.0 MVP** -- Phases 1-3 (shipped 2026-03-15)
+- **v1.1 Fixes & Polish** -- Phases 4-6 (in progress)
 
 ## Phases
 
 <details>
-<summary>✅ v1.0 MVP (Phases 1-3) — SHIPPED 2026-03-15</summary>
+<summary>v1.0 MVP (Phases 1-3) -- SHIPPED 2026-03-15</summary>
 
-- [x] Phase 1: Foundation and Collection (4/4 plans) — completed 2026-03-14
+- [x] Phase 1: Foundation and Collection (4/4 plans) -- completed 2026-03-14
-- [x] Phase 2: Planning Threads (3/3 plans) — completed 2026-03-15
+- [x] Phase 2: Planning Threads (3/3 plans) -- completed 2026-03-15
-- [x] Phase 3: Setups and Dashboard (3/3 plans) — completed 2026-03-15
+- [x] Phase 3: Setups and Dashboard (3/3 plans) -- completed 2026-03-15
 
 </details>
 
+### v1.1 Fixes & Polish (In Progress)
+
+**Milestone Goal:** Fix broken functionality, improve image handling UX, and replace emoji categories with Lucide icon picker.
+
+- [ ] **Phase 4: Database & Planning Fixes** - Fix threads table and planning thread creation, polish empty states
+- [ ] **Phase 5: Image Handling** - Fix image display and redesign upload UX with previews
+- [ ] **Phase 6: Category Icons** - Replace emoji categories with Lucide icon picker
+
+## Phase Details
+
+### Phase 4: Database & Planning Fixes
+**Goal**: Users can create and manage planning threads without errors
+**Depends on**: Phase 3 (v1.0 complete)
+**Requirements**: DB-01, PLAN-01, PLAN-02
+**Success Criteria** (what must be TRUE):
+  1. Running database schema push creates the threads table (and any other missing tables) without errors
+  2. User can create a new planning thread from the planning tab and it appears in the thread list
+  3. User sees a clear, polished empty state with a call-to-action when no planning threads exist
+**Plans**: TBD
+
+Plans:
+- [ ] 04-01: TBD
+
+### Phase 5: Image Handling
+**Goal**: Users can see and manage gear images throughout the app
+**Depends on**: Phase 4
+**Requirements**: IMG-01, IMG-02, IMG-03, IMG-04
+**Success Criteria** (what must be TRUE):
+  1. User can see previously uploaded images displayed correctly on item detail views
+  2. Gear collection cards show item images (or a placeholder when no image exists)
+  3. Item form displays an image preview area at the top with a placeholder icon when no image is set
+  4. User can upload an image by clicking the placeholder area, and the preview updates immediately
+**Plans**: TBD
+
+Plans:
+- [ ] 05-01: TBD
+
+### Phase 6: Category Icons
+**Goal**: Categories use clean Lucide icons instead of emoji
+**Depends on**: Phase 4
+**Requirements**: CAT-01, CAT-02, CAT-03
+**Success Criteria** (what must be TRUE):
+  1. User can browse and select a Lucide icon from a picker when creating or editing a category
+  2. Category icons render as Lucide icons everywhere they appear (cards, headers, lists, dashboard)
+  3. Existing emoji-based categories display as equivalent Lucide icons without manual user intervention
+**Plans**: TBD
+
+Plans:
+- [ ] 06-01: TBD
+
 ## Progress
 
+**Execution Order:**
+Phases execute in numeric order: 4 -> 5 -> 6
+
 | Phase | Milestone | Plans Complete | Status | Completed |
 |-------|-----------|----------------|--------|-----------|
 | 1. Foundation and Collection | v1.0 | 4/4 | Complete | 2026-03-14 |
 | 2. Planning Threads | v1.0 | 3/3 | Complete | 2026-03-15 |
 | 3. Setups and Dashboard | v1.0 | 3/3 | Complete | 2026-03-15 |
+| 4. Database & Planning Fixes | v1.1 | 0/? | Not started | - |
+| 5. Image Handling | v1.1 | 0/? | Not started | - |
+| 6. Category Icons | v1.1 | 0/? | Not started | - |

.planning/STATE.md

@@ -2,12 +2,12 @@
 gsd_state_version: 1.0
 milestone: v1.1
 milestone_name: Fixes & Polish
-status: defining_requirements
+status: ready_to_plan
 stopped_at: null
 last_updated: "2026-03-15"
-last_activity: 2026-03-15 — Milestone v1.1 started
+last_activity: 2026-03-15 — v1.1 roadmap created
 progress:
-  total_phases: 0
+  total_phases: 3
   completed_phases: 0
   total_plans: 0
   completed_plans: 0
@@ -20,22 +20,24 @@ progress:
 
 See: .planning/PROJECT.md (updated 2026-03-15)
 
-**Core value:** Make it effortless to manage gear and plan new purchases — see how a potential buy affects your total setup weight and cost before committing.
+**Core value:** Make it effortless to manage gear and plan new purchases -- see how a potential buy affects your total setup weight and cost before committing.
-**Current focus:** Defining requirements for v1.1
+**Current focus:** Phase 4 - Database & Planning Fixes
 
 ## Current Position
 
-Phase: Not started (defining requirements)
+Phase: 4 of 6 (Database & Planning Fixes)
-Plan: —
+Plan: 0 of ? in current phase
-Status: Defining requirements
+Status: Ready to plan
-Last activity: 2026-03-15 — Milestone v1.1 started
+Last activity: 2026-03-15 -- v1.1 roadmap created
+
+Progress: [░░░░░░░░░░] 0% (v1.1 phases)
 
 ## Accumulated Context
 
 ### Decisions
 
-- Stay with SQLite — single-user app, Postgres adds unnecessary complexity
+- Stay with SQLite -- single-user app, Postgres adds unnecessary complexity
-- Lucide Icons for category icons — best outdoor/gear coverage
+- Lucide Icons for category icons -- best outdoor/gear coverage
 
 ### Pending Todos
 
@@ -43,12 +45,12 @@ None.
 
 ### Blockers/Concerns
 
-- `threads` table missing from database (schema exists, never pushed)
+- `threads` table missing from database (schema exists, never pushed) -- Phase 4
-- Images upload but don't display in UI
+- Images upload but don't display in UI -- Phase 5
-- Category emoji system being replaced with Lucide icons
+- Category emoji system being replaced with Lucide icons -- Phase 6
 
 ## Session Continuity
 
 Last session: 2026-03-15
-Stopped at: Defining v1.1 requirements
+Stopped at: v1.1 roadmap created, ready to plan Phase 4
 Resume file: N/A