docs(02-01): complete Replicate provider plan

Tasks completed: 2/2
- Create Replicate provider implementation
- Create Replicate models API route

SUMMARY: .planning/phases/02-model-discovery/02-01-SUMMARY.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.planning/ROADMAP.md

@@ -41,7 +41,7 @@ Plans:
 **Plans**: TBD
 
 Plans:
-- [ ] 02-01: Replicate model fetching API route
+- [x] 02-01: Replicate model fetching API route
 - [ ] 02-02: fal.ai model fetching API route
 - [ ] 02-03: Model caching and unified model interface
 
@@ -96,7 +96,7 @@ Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6
 | Phase | Plans Complete | Status | Completed |
 |-------|----------------|--------|-----------|
 | 1. Provider Infrastructure | 2/2 | Complete | 2026-01-09 |
-| 2. Model Discovery | 0/3 | Not started | - |
+| 2. Model Discovery | 1/3 | In progress | - |
 | 3. Generate Node Refactor | 0/3 | Not started | - |
 | 4. Model Search Dialog | 0/2 | Not started | - |
 | 5. Image URL Server | 0/2 | Not started | - |

.planning/STATE.md

@@ -5,32 +5,33 @@
 See: .planning/PROJECT.md (updated 2026-01-09)
 
 **Core value:** Provider infrastructure that dynamically discovers models from external APIs, enabling users to access hundreds of image/video generation models without hardcoding schemas.
-**Current focus:** Phase 1 - Provider Infrastructure
+**Current focus:** Phase 2 - Model Discovery
 
 ## Current Position
 
-Phase: 1 of 6 (Provider Infrastructure)
-Plan: 2 of 2 in current phase
-Status: Phase complete
-Last activity: 2026-01-09 - Completed provider abstraction plan (01-02)
+Phase: 2 of 6 (Model Discovery)
+Plan: 1 of 3 in current phase
+Status: In progress
+Last activity: 2026-01-09 - Completed 02-01-PLAN.md (Replicate provider)
 
-Progress: [=================---] 13% (2/15 plans)
+Progress: [====================] 20% (3/15 plans)
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 2
-- Average duration: 7 min
-- Total execution time: 0.2 hours
+- Total plans completed: 3
+- Average duration: 6 min
+- Total execution time: 0.3 hours
 
 **By Phase:**
 
 | Phase | Plans | Total | Avg/Plan |
 |-------|-------|-------|----------|
 | 1. Provider Infrastructure | 2/2 | 14 min | 7 min |
+| 2. Model Discovery | 1/3 | 4 min | 4 min |
 
 **Recent Trend:**
-- Last 5 plans: 12 min, 2 min
+- Last 5 plans: 12 min, 2 min, 4 min
 - Trend: improving
 
 ## Accumulated Context
@@ -46,6 +47,7 @@ Recent decisions affecting current work:
 - Provider config pattern: {id, name, enabled, apiKey, apiKeyEnvVar?}
 - Provider registry uses self-registration pattern via registerProvider()
 - Gemini remains special-cased in /api/generate for now, not yet migrated
+- Capability inference from model name/description keywords
 
 ### Deferred Issues
 
@@ -58,6 +60,6 @@ None.
 ## Session Continuity
 
 Last session: 2026-01-09
-Stopped at: Phase 1 complete
+Stopped at: Completed 02-01-PLAN.md
 Resume file: None
-Next action: Plan phase 02 (Model Discovery)
+Next action: Execute 02-02-PLAN.md (fal.ai provider)

.planning/phases/02-model-discovery/02-01-SUMMARY.md

@@ -0,0 +1,94 @@
+---
+phase: 02-model-discovery
+plan: 01
+subsystem: api
+tags: [replicate, provider, model-discovery, api-route]
+
+# Dependency graph
+requires:
+  - phase: 01-02
+    provides: ProviderInterface, ProviderModel, registerProvider
+provides:
+  - Replicate provider implementing ProviderInterface
+  - API route for fetching Replicate models server-side
+  - Model capability inference from name/description
+affects: [02-02, 02-03, model-browser, generate-node-refactor]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns: [provider self-registration, API route for server-side fetching]
+
+key-files:
+  created:
+    - src/lib/providers/replicate.ts
+    - src/app/api/providers/replicate/models/route.ts
+  modified: []
+
+key-decisions:
+  - "API key from localStorage via provider settings pattern"
+  - "Capabilities inferred from model name/description keywords"
+  - "First page only (no pagination traversal for initial release)"
+
+patterns-established:
+  - "Provider implementation pattern in src/lib/providers/{provider}.ts"
+  - "API route pattern at /api/providers/{provider}/models"
+
+issues-created: []
+
+# Metrics
+duration: 4min
+completed: 2026-01-09
+---
+
+# Phase 02-01: Replicate Provider Summary
+
+**Replicate provider with model discovery via REST API, normalized to ProviderModel interface with self-registration**
+
+## Performance
+
+- **Duration:** 4 min
+- **Started:** 2026-01-09T23:49:00Z
+- **Completed:** 2026-01-09T23:53:00Z
+- **Tasks:** 2
+- **Files created:** 2
+
+## Accomplishments
+- Created Replicate provider implementing full ProviderInterface contract
+- Built API route for server-side model fetching with API key authentication
+- Implemented capability inference from model name/description
+- Provider self-registers in registry when module is imported
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Create Replicate provider implementation** - `ac10daf` (feat)
+2. **Task 2: Create Replicate models API route** - `70d4c53` (feat)
+
+## Files Created/Modified
+- `src/lib/providers/replicate.ts` - Replicate provider with listModels, searchModels, getModel, isConfigured, getApiKey
+- `src/app/api/providers/replicate/models/route.ts` - GET endpoint for model fetching with X-API-Key auth
+
+## Decisions Made
+- API key read from localStorage using existing provider settings pattern (node-banana-provider-settings key)
+- Capability inference uses keyword matching (img2img, inpaint, controlnet → image-to-image; video, animate → video)
+- generate() returns stub error - implementation deferred to Phase 3
+- First page of results only - no pagination traversal for initial release
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None.
+
+## Next Phase Readiness
+- Replicate provider complete and ready for use
+- Same pattern ready for fal.ai provider (02-02)
+- Model caching to be added in 02-03
+
+---
+*Phase: 02-model-discovery*
+*Completed: 2026-01-09*