diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index 33350c79..6406cf4e 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -8,26 +8,25 @@ Transform Node Banana from a Gemini-only image generator into a multi-provider p None +## Milestones + +- ✅ **v1.0 Multi-Provider Support** - Phases 1-6 (shipped 2026-01-11) +- 🚧 **v1.1 Improvements** - Phases 7-12 (in progress) + ## Phases **Phase Numbering:** - Integer phases (1, 2, 3): Planned milestone work - Decimal phases (2.1, 2.2): Urgent insertions (marked with INSERTED) -- [x] **Phase 1: Provider Infrastructure** - API key storage and provider settings UI ✓ -- [x] **Phase 2: Model Discovery** - Dynamic model fetching from Replicate/fal.ai APIs ✓ -- [x] **Phase 3: Generate Node Refactor** - Rename NanoBanana to generic Generate with multi-model support ✓ -- [x] **Phase 4: Model Search Dialog** - Floating action bar icons and searchable model browser ✓ -- [x] **Phase 5: Image URL Server** - Local endpoint serving images as URLs for providers ✓ -- [x] **Phase 6: Video & Polish** - Video playback, parameter customization, edge cases ✓ - -## Phase Details +
+✅ v1.0 Multi-Provider Support (Phases 1-6) - SHIPPED 2026-01-11 ### Phase 1: Provider Infrastructure **Goal**: Users can configure Replicate and fal.ai API keys in settings, with keys securely stored **Depends on**: Nothing (first phase) **Research**: Unlikely (internal UI patterns, Zustand state management) -**Plans**: TBD +**Plans**: 2 plans Plans: - [x] 01-01: Provider settings UI in ProjectSetupModal @@ -38,7 +37,7 @@ Plans: **Depends on**: Phase 1 **Research**: Likely (external APIs) **Research topics**: Replicate model listing API endpoints, fal.ai model discovery endpoints, response schemas and pagination -**Plans**: TBD +**Plans**: 3 plans Plans: - [x] 02-01: Replicate model fetching API route @@ -50,6 +49,7 @@ Plans: **Depends on**: Phase 2 **Research**: Unlikely (internal refactoring using existing patterns) **Design decision**: Separate nodes for image vs video generation (GenerateVideo added in Phase 6) +**Plans**: 3 plans Plans: - [x] 03-01: Rename NanoBanana to GenerateImage, add model selector (image models only) @@ -60,7 +60,7 @@ Plans: **Goal**: Users can browse models via floating action bar icons and searchable dialog **Depends on**: Phase 3 **Research**: Unlikely (internal UI using React patterns) -**Plans**: TBD +**Plans**: 2 plans Plans: - [x] 04-01: Floating action bar with provider icons @@ -70,7 +70,7 @@ Plans: **Goal**: Local API endpoint serves workflow images as URLs for providers requiring URL inputs **Depends on**: Phase 3 **Research**: Unlikely (Next.js API routes, existing patterns) -**Plans**: TBD +**Plans**: 2 plans Plans: - [x] 05-01: Image serving endpoint and URL generation @@ -82,6 +82,7 @@ Plans: **Research**: Likely (video handling) **Research topics**: HTML5 video element for base64/blob URLs, provider response formats for video content **Design decision**: GenerateVideo as separate node type (not combined with GenerateImage) +**Plans**: 4 plans Plans: - [x] 06-01: GenerateVideo node with video-capable model selector @@ -89,16 +90,89 @@ Plans: - [x] 06-03: Custom model parameters from provider schemas - [x] 06-04: Edge case handling and final polish +
+ +### 🚧 v1.1 Improvements (In Progress) + +**Milestone Goal:** Fix connection issues, improve error visibility, add video history, auto-size nodes, and polish UI + +#### Phase 7: Video Connections + +**Goal**: Fix video handle connections to only allow valid targets (generateVideo, output) +**Depends on**: Phase 6 +**Research**: Unlikely (internal connection validation patterns) +**Plans**: TBD + +Plans: +- [ ] 07-01: TBD (run /gsd:plan-phase 7 to break down) + +#### Phase 8: Error Display + +**Goal**: Better error visibility with overlay display, not hidden by previous output +**Depends on**: Phase 7 +**Research**: Unlikely (internal UI patterns) +**Plans**: TBD + +Plans: +- [ ] 08-01: TBD (run /gsd:plan-phase 8 to break down) + +#### Phase 9: Video History + +**Goal**: Add history carousel for generated videos matching image history pattern +**Depends on**: Phase 8 +**Research**: Unlikely (existing image history pattern) +**Plans**: TBD + +Plans: +- [ ] 09-01: TBD (run /gsd:plan-phase 9 to break down) + +#### Phase 10: Node Autosizing + +**Goal**: Auto-size nodes to output dimensions and aspect ratio +**Depends on**: Phase 9 +**Research**: Unlikely (React Flow node sizing) +**Plans**: TBD + +Plans: +- [ ] 10-01: TBD (run /gsd:plan-phase 10 to break down) + +#### Phase 11: UI Polish + +**Goal**: Flora UI alignment, header UI improvements, project settings, provider logos on nodes +**Depends on**: Phase 10 +**Research**: Unlikely (internal UI work) +**Plans**: TBD + +Plans: +- [ ] 11-01: TBD (run /gsd:plan-phase 11 to break down) + +#### Phase 12: Model Improvements + +**Goal**: Verify Replicate image models work, extend model cache TTL +**Depends on**: Phase 11 +**Research**: Likely (Replicate API behavior verification) +**Research topics**: Replicate image model endpoints, cache invalidation strategies +**Plans**: TBD + +Plans: +- [ ] 12-01: TBD (run /gsd:plan-phase 12 to break down) + ## Progress **Execution Order:** -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 | 3/3 | Complete | 2026-01-09 | -| 3. Generate Node Refactor | 3/3 | Complete | 2026-01-09 | -| 4. Model Search Dialog | 2/2 | Complete | 2026-01-09 | -| 5. Image URL Server | 2/2 | Complete | 2026-01-09 | -| 6. Video & Polish | 4/4 | Complete | 2026-01-11 | +Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6 → 7 → 8 → 9 → 10 → 11 → 12 + +| Phase | Milestone | Plans Complete | Status | Completed | +|-------|-----------|----------------|--------|-----------| +| 1. Provider Infrastructure | v1.0 | 2/2 | Complete | 2026-01-09 | +| 2. Model Discovery | v1.0 | 3/3 | Complete | 2026-01-09 | +| 3. Generate Node Refactor | v1.0 | 3/3 | Complete | 2026-01-09 | +| 4. Model Search Dialog | v1.0 | 2/2 | Complete | 2026-01-09 | +| 5. Image URL Server | v1.0 | 2/2 | Complete | 2026-01-09 | +| 6. Video & Polish | v1.0 | 4/4 | Complete | 2026-01-11 | +| 7. Video Connections | v1.1 | 0/? | Not started | - | +| 8. Error Display | v1.1 | 0/? | Not started | - | +| 9. Video History | v1.1 | 0/? | Not started | - | +| 10. Node Autosizing | v1.1 | 0/? | Not started | - | +| 11. UI Polish | v1.1 | 0/? | Not started | - | +| 12. Model Improvements | v1.1 | 0/? | Not started | - | diff --git a/.planning/STATE.md b/.planning/STATE.md index dac6f2e6..265f9e6a 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -5,16 +5,16 @@ 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 6 - Video & Polish +**Current focus:** Phase 7 - Video Connections ## Current Position -Phase: 6 of 6 (Video & Polish) -Plan: 3 of 4 in current phase -Status: In progress -Last activity: 2026-01-10 - Completed 06-03-PLAN.md (Custom model parameters) +Phase: 7 of 12 (Video Connections) +Plan: Not started +Status: Ready to plan +Last activity: 2026-01-12 - Milestone v1.1 Improvements created -Progress: [======================================================================================] 100% (15/15 plans) +Progress: ░░░░░░░░░░ 0% ## Performance Metrics @@ -32,7 +32,7 @@ Progress: [===================================================================== | 3. Generate Node Refactor | 3/3 | 13 min | 4.3 min | | 4. Model Search Dialog | 2/2 | 17 min | 8.5 min | | 5. Image URL Server | 2/2 | 5 min | 2.5 min | -| 6. Video & Polish | 3/4 | 43 min | 14.3 min | +| 6. Video & Polish | 4/4 | 43 min | 14.3 min | **Recent Trend:** - Last 5 plans: 3 min, 2 min, 10 min, 28 min, 5 min @@ -86,9 +86,14 @@ Recent decisions affecting current work: - Pre-existing lint configuration issue (ESLint not configured). Not blocking development. +### Roadmap Evolution + +- v1.0 Multi-Provider Support shipped: 6 phases (Phase 1-6), 15 plans +- Milestone v1.1 Improvements created: 6 phases (Phase 7-12), improvements and polish + ## Session Continuity -Last session: 2026-01-10 -Stopped at: Completed 06-03-PLAN.md (Custom model parameters) +Last session: 2026-01-12 +Stopped at: Milestone v1.1 Improvements initialization Resume file: None -Next action: Execute 06-04-PLAN.md (Final polish and cleanup) +Next action: Plan Phase 7 (Video Connections)