docs(23-01): complete model browser improvements plan

Tasks completed: 3/3
- Add recently used models tracking and storage
- Add Gemini models to /api/models endpoint
- Add icon-based provider filter and recently used section

SUMMARY: .planning/phases/23-model-browser-improvements/23-01-SUMMARY.md

.planning/ROADMAP.md

@@ -309,7 +309,7 @@ Plans:
 3. Include Gemini models (nano-banana, nano-banana-pro) in the browsable model list alongside Replicate/fal.ai models
 
 Plans:
-- [ ] 23-01: TBD (run /gsd:plan-phase 23 to break down)
+- [x] 23-01: Recently used models, icon-based provider filter, Gemini models in browse
 
 ## Progress
 
@@ -340,4 +340,4 @@ Phases execute in numeric order: 1 → 2 → ... → 14 → 15 → 16 → 17 →
 | 20. Integration Tests | v1.2 | 0/? | Not started | - |
 | 21. Fix Image Input & Deduplication | v1.2 | 1/1 | Complete | 2026-01-13 |
 | 22. Generate Node Dynamic Input Tests | v1.2 | 1/1 | Complete | 2026-01-13 |
-| 23. Model Browser Improvements | v1.2 | 0/? | Not started | - |
+| 23. Model Browser Improvements | v1.2 | 1/1 | Complete | 2026-01-13 |

.planning/STATE.md

@@ -9,19 +9,19 @@ See: .planning/PROJECT.md (updated 2026-01-09)
 
 ## Current Position
 
-Phase: 19 of 23 (Type Refactoring)
+Phase: 23 of 23 (Model Browser Improvements)
-Plan: 2 of 2 in current phase
+Plan: 1 of 1 in current phase
-Status: Phase 19 complete
+Status: Phase complete
-Last activity: 2026-01-13 - Completed 19-02-PLAN.md
+Last activity: 2026-01-13 - Completed 23-01-PLAN.md
 
-Progress: █████████░ 96%
+Progress: ██████████ 100%
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 24
+- Total plans completed: 25
 - Average duration: 7 min
-- Total execution time: 2.9 hours
+- Total execution time: 3.0 hours
 
 **By Phase:**
 
@@ -43,13 +43,13 @@ Progress: █████████░ 96%
 | 14. Fix Drag-Connect Bugs | 1/1 | 7 min | 7 min |
 | 15. Test Infrastructure | 1/1 | 3 min | 3 min |
 | 16. Store Modularization | 1/1 | 22 min | 22 min |
-| 22. Generate Node Dynamic Input Tests | 1/1 | 20 min | 20 min |
-
 | 19. Type Refactoring | 2/2 | 16 min | 8 min |
+| 22. Generate Node Dynamic Input Tests | 1/1 | 20 min | 20 min |
+| 23. Model Browser Improvements | 1/1 | 5 min | 5 min |
 
 **Recent Trend:**
-- Last 5 plans: 22 min, 2 min, 20 min, 8 min, 8 min
+- Last 5 plans: 20 min, 8 min, 8 min, 2 min, 5 min
-- Trend: Type refactoring is faster than test phases
+- Trend: UI tasks are faster than testing phases
 
 ## Accumulated Context
 
@@ -112,6 +112,9 @@ Recent decisions affecting current work:
 - BaseNodeData in annotation.ts to avoid circular imports (nodes.ts imports annotation.ts)
 - 7 type domain files: annotation, nodes, providers, models, workflow, api, quickstart
 - index.ts is pure re-export hub with no type definitions
+- Max 8 recent models stored in localStorage, 4 displayed in UI
+- Gemini models hardcoded in /api/models (not fetched from external API)
+- Green color theme for Gemini provider (bg-green-500/20 text-green-300)
 
 ### Deferred Issues
 
@@ -136,6 +139,6 @@ Recent decisions affecting current work:
 ## Session Continuity
 
 Last session: 2026-01-13
-Stopped at: Phase 19 complete
+Stopped at: Phase 23 complete (milestone v1.2 complete)
 Resume file: None
-Next action: Plan Phase 20 (run /gsd:plan-phase 20)
+Next action: Complete milestone v1.2 (run /gsd:complete-milestone)

.planning/phases/23-model-browser-improvements/23-01-SUMMARY.md

@@ -0,0 +1,107 @@
+---
+phase: 23-model-browser-improvements
+plan: 01
+subsystem: ui
+tags: [model-browser, recently-used, provider-icons, gemini, localStorage]
+
+# Dependency graph
+requires:
+  - phase: 04-model-search-dialog
+    provides: ModelSearchDialog base implementation
+provides:
+  - Recently used models tracking
+  - Icon-based provider filter with Gemini support
+  - Gemini models in browse list
+affects: [model-selection, provider-ui]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns: [localStorage model tracking, icon-based filter buttons]
+
+key-files:
+  created: []
+  modified:
+    - src/types/index.ts
+    - src/store/utils/localStorage.ts
+    - src/store/workflowStore.ts
+    - src/app/api/models/route.ts
+    - src/components/modals/ModelSearchDialog.tsx
+
+key-decisions:
+  - "Store max 8 recent models, display 4 in UI"
+  - "Gemini models hardcoded in API (not fetched from external API)"
+  - "Green color theme for Gemini (matching star/sparkle icon)"
+
+patterns-established:
+  - "Icon-based filter buttons with hover/active states"
+  - "Recently used section at top of browse dialogs"
+
+issues-created: []
+
+# Metrics
+duration: 5min
+completed: 2026-01-13
+---
+
+# Phase 23 Plan 01: Model Browser Improvements Summary
+
+**Icon-based provider filter with Gemini, Replicate, fal.ai icons; recently used models section with localStorage persistence; Gemini models browsable in model list**
+
+## Performance
+
+- **Duration:** 5 min
+- **Started:** 2026-01-13T07:43:02Z
+- **Completed:** 2026-01-13T07:47:52Z
+- **Tasks:** 3
+- **Files modified:** 5
+
+## Accomplishments
+
+- Added recently used models tracking with localStorage persistence
+- Added Gemini models (nano-banana, nano-banana-pro) to /api/models endpoint
+- Replaced provider dropdown with icon-based button group (All, Gemini, Replicate, fal.ai)
+- Added "Recently Used" section at top of model browser showing last 4 used models
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Add recently used models tracking and storage** - `3336ed6` (feat)
+2. **Task 2: Add Gemini models to /api/models endpoint** - `975c0ce` (feat)
+3. **Task 3: Add icon-based provider filter and recently used section** - `5a14d19` (feat)
+
+## Files Created/Modified
+
+- `src/types/index.ts` - Added RecentModel interface
+- `src/store/utils/localStorage.ts` - Added getRecentModels, saveRecentModels, MAX_RECENT_MODELS
+- `src/store/workflowStore.ts` - Added recentModels state and trackModelUsage action
+- `src/app/api/models/route.ts` - Added GEMINI_IMAGE_MODELS constant and Gemini provider handling
+- `src/components/modals/ModelSearchDialog.tsx` - Added provider icons, recently used section, trackModelUsage integration
+
+## Decisions Made
+
+- Max 8 recent models stored, 4 displayed in UI (provides buffer for filtering by capability)
+- Gemini models hardcoded as they don't come from an external API
+- Green color for Gemini branding (bg-green-500/20 text-green-300)
+- Sparkle/star icon for Gemini (simple 4-pointed star)
+- Recently used section hidden during search (show only when browsing)
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None
+
+## Next Phase Readiness
+
+- Model browser UX improved with quick access to recent models
+- Gemini models now browsable alongside external provider models
+- Provider filter provides visual consistency with icon-based selection
+- Phase 23 complete, ready for milestone completion
+
+---
+*Phase: 23-model-browser-improvements*
+*Completed: 2026-01-13*