docs(20-02): complete workflow execution tests plan

Tasks completed: 3/3
- Add workflow execution data flow tests
- Add error handling and edge case tests
- Add connection validation integration tests

SUMMARY: .planning/phases/20-integration-tests/20-02-SUMMARY.md

.planning/ROADMAP.md

@@ -12,7 +12,7 @@ None
 
 - ✅ **v1.0 Multi-Provider Support** - Phases 1-6 (shipped 2026-01-11)
 - ✅ **v1.1 Improvements** - Phases 7-14 (shipped 2026-01-12)
-- 🚧 **v1.2 Improvements** - Phases 15-23 (in progress)
+- 🚧 **v1.2 Improvements** - Phases 15-24 (in progress)
 
 ## Phases
 
@@ -185,7 +185,7 @@ Plans:
 
 ### 🚧 v1.2 Improvements (In Progress)
 
-**Milestone Goal:** Add automated testing across the application and modularize large monolithic files for better maintainability
+**Milestone Goal:** Add automated testing across the application, modularize large monolithic files for better maintainability, and improve cost tracking for multi-provider support
 
 #### Phase 15: Test Infrastructure
 
@@ -261,8 +261,8 @@ Plans:
 **Plans**: 2 plans
 
 Plans:
-- [ ] 20-01: Store integration tests (getConnectedInputs, validateWorkflow, topological sort)
-- [ ] 20-02: Workflow execution tests (data flow, error handling, connection validation)
+- [x] 20-01: Store integration tests (getConnectedInputs, validateWorkflow, topological sort)
+- [x] 20-02: Workflow execution tests (data flow, error handling, connection validation)
 
 #### Phase 21: Fix Image Input & Deduplication Issues
 
@@ -312,10 +312,43 @@ Plans:
 Plans:
 - [x] 23-01: Recently used models, icon-based provider filter, Gemini models in browse
 
+#### Phase 24: Improved Cost Summary
+
+**Goal**: Expand cost tracking to include fal.ai models (via their pricing API), video generation nodes, and graceful handling for Replicate (no pricing API available)
+**Depends on**: Phase 23
+**Research**: Complete (see research notes below)
+**Plans**: 3 plans
+
+**Research Notes:**
+- fal.ai has a pricing API: `GET /v1/models/pricing?endpoint_id=model1,model2` returns `{ prices: [{ endpoint_id, unit_price, unit, currency }] }`
+- Replicate does NOT expose pricing via API (open GitHub issue, unresolved). Prediction response has `metrics.predict_time` but no hardware/cost info.
+- `ProviderModel` type already has `pricing?: { type, amount, currency }` field at `src/lib/providers/types.ts:69-74`
+
+**UX Decision: Provider-Grouped with Uncertainty Section**
+- Two sections: "Known Costs" (Gemini + fal.ai) and "Pricing Unavailable" (Replicate)
+- Known costs show total at section header, breakdown by provider with icons
+- fal.ai items show billing unit from API (e.g., "per image", "per 5s video")
+- Replicate section includes help text: "Pricing varies by hardware and runtime. Check replicate.com"
+- Incurred cost only tracks Gemini & fal.ai (Replicate excluded with note)
+- Empty provider sections hidden
+
+**Features:**
+1. Fetch fal.ai model pricing via their pricing API and populate `ProviderModel.pricing`
+2. Track generateVideo nodes in cost predictions (currently ignored)
+3. For Replicate models: display "pricing unavailable" gracefully in dedicated section
+4. Update CostDialog with two-section layout: Known Costs (Gemini, fal.ai) and Pricing Unavailable (Replicate)
+5. Show billing units for fal.ai models (per image, per second of video, etc.)
+6. Incurred cost excludes Replicate with explanatory note
+
+Plans:
+- [ ] 24-01: fal.ai pricing API integration and ProviderModel.pricing population
+- [ ] 24-02: Expand costCalculator to handle video nodes and external providers
+- [ ] 24-03: Update CostDialog UI for multi-provider breakdown
+
 ## Progress
 
 **Execution Order:**
-Phases execute in numeric order: 1 → 2 → ... → 14 → 15 → 16 → 17 → 18 → 19 → 20 → 21 → 22 → 23
+Phases execute in numeric order: 1 → 2 → ... → 14 → 15 → 16 → 17 → 18 → 19 → 20 → 21 → 22 → 23 → 24
 
 | Phase | Milestone | Plans Complete | Status | Completed |
 |-------|-----------|----------------|--------|-----------|
@@ -338,7 +371,8 @@ Phases execute in numeric order: 1 → 2 → ... → 14 → 15 → 16 → 17 →
 | 17. Component Tests | v1.2 | 11/11 | Complete | 2026-01-13 |
 | 18. API Route Tests | v1.2 | 5/5 | Complete | 2026-01-13 |
 | 19. Type Refactoring | v1.2 | 2/2 | Complete | 2026-01-13 |
-| 20. Integration Tests | v1.2 | 1/2 | In progress | - |
+| 20. Integration Tests | v1.2 | 2/2 | Complete | 2026-01-13 |
 | 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 | 1/1 | Complete | 2026-01-13 |
+| 24. Improved Cost Summary | v1.2 | 0/3 | Not started | - |

.planning/STATE.md

@@ -9,10 +9,10 @@ See: .planning/PROJECT.md (updated 2026-01-09)
 
 ## Current Position
 
-Phase: 20 of 23 (Integration Tests)
-Plan: 1 of 2 in current phase
-Status: In progress
-Last activity: 2026-01-13 - Completed 20-01-PLAN.md
+Phase: 20 of 24 (Integration Tests)
+Plan: 2 of 2 in current phase
+Status: Phase complete
+Last activity: 2026-01-13 - Completed 20-02-PLAN.md
 
 Progress: █████████░ 96%
 
@@ -46,7 +46,7 @@ Progress: █████████░ 96%
 | 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 |
-| 20. Integration Tests | 1/2 | 9 min | 9 min |
+| 20. Integration Tests | 2/2 | 11 min | 5.5 min |
 
 **Recent Trend:**
 - Last 5 plans: 8 min, 8 min, 2 min, 5 min, 9 min
@@ -116,6 +116,9 @@ Recent decisions affecting current work:
 - 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)
+- Cost dialog: two-section layout (Known Costs vs Pricing Unavailable) grouping by provider
+- fal.ai pricing via API, Replicate excluded from cost tracking (no API available)
+- Incurred cost only tracks providers with known pricing (Gemini, fal.ai)
 
 ### Deferred Issues
 
@@ -136,10 +139,11 @@ Recent decisions affecting current work:
 - Phase 21 added: Fix Gemini Pro image input handling and image deduplication issues
 - Phase 22 added: Generate node dynamic input validation and API call tests
 - Phase 23 added: Model browser improvements (recently used, icon dropdown, Gemini models in list)
+- Phase 24 added: Improved cost summary (fal.ai pricing API, video node tracking, multi-provider support)
 
 ## Session Continuity
 
 Last session: 2026-01-13
-Stopped at: Completed 20-01-PLAN.md (store integration tests)
+Stopped at: Completed 20-02-PLAN.md (workflow execution tests)
 Resume file: None
-Next action: Execute 20-02-PLAN.md (workflow execution tests)
+Next action: Plan Phase 24 (Improved Cost Summary)

.planning/phases/20-integration-tests/20-02-SUMMARY.md

@@ -0,0 +1,100 @@
+---
+phase: 20-integration-tests
+plan: 02
+subsystem: testing
+tags: [vitest, integration-tests, workflow, zustand, data-flow]
+
+# Dependency graph
+requires:
+  - phase: 20
+    provides: Store integration test infrastructure (getConnectedInputs, validateWorkflow, topological sort)
+provides:
+  - Workflow execution data flow tests
+  - Error handling and edge case coverage
+  - Connection validation integration tests
+affects: [future workflow changes, executeWorkflow modifications]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns: [workflow execution testing, mock fetch patterns, state verification]
+
+key-files:
+  created: []
+  modified:
+    - src/store/__tests__/workflowStore.integration.test.ts
+
+key-decisions:
+  - "Consolidated all three tasks into single comprehensive test file update"
+  - "Tests focus on data extraction via getConnectedInputs rather than API transformation"
+
+patterns-established:
+  - "Mock fetch with controlled responses for execution testing"
+  - "State verification after async workflow execution"
+  - "Testing dynamic input mapping from schema to handle IDs"
+
+issues-created: []
+
+# Metrics
+duration: 2min
+completed: 2026-01-13
+---
+
+# Phase 20 Plan 02: Workflow Execution Tests Summary
+
+**Added 30+ integration tests for workflow execution data flow, error handling, and connection validation**
+
+## Performance
+
+- **Duration:** 2 min
+- **Started:** 2026-01-13T09:19:43Z
+- **Completed:** 2026-01-13T09:22:11Z
+- **Tasks:** 3 (consolidated into single implementation)
+- **Files modified:** 1
+- **Total tests in file:** 75 (added ~30 new tests)
+
+## Accomplishments
+
+- Added comprehensive data flow tests verifying images and text correctly pass through node chains
+- Added error handling tests covering missing inputs, API errors, and network failures
+- Added connection validation tests for handle type identification and edge cases
+- Tests verify state updates during execution (status, outputImage, isRunning, currentNodeId)
+- Tests cover dynamic input mapping from inputSchema to handle IDs
+
+## Task Commits
+
+1. **Task 1-3: Add data flow, error handling, and connection validation tests** - `071a03e` (test)
+
+All three tasks were implemented together since they belong to the same test file and share setup/teardown logic.
+
+## Files Created/Modified
+
+- `src/store/__tests__/workflowStore.integration.test.ts` - Extended with 3 new describe blocks:
+  - "Workflow execution data flow" - Image/text flow, dynamic inputs, state updates
+  - "Error handling and edge cases" - Missing inputs, API errors, state management, resume
+  - "Connection validation integration" - Handle identification, edge cases
+
+## Decisions Made
+
+- Consolidated all tasks into single comprehensive update since they share test infrastructure
+- Focused on data extraction verification via getConnectedInputs rather than full API round-trips
+- Used mock fetch to control execution flow and verify state updates
+
+## Deviations from Plan
+
+None - plan executed exactly as written, with tasks naturally consolidated.
+
+## Issues Encountered
+
+None - all tests pass, build succeeds.
+
+## Next Phase Readiness
+
+- Phase 20 Integration Tests complete (2/2 plans)
+- All 75 integration tests pass
+- Provides confidence in workflow execution correctness
+- Ready for Phase 24 (Improved Cost Summary) or other remaining phases
+
+---
+*Phase: 20-integration-tests*
+*Completed: 2026-01-13*