From b1c827e4aa7362571395559eea146d3e11deb715 Mon Sep 17 00:00:00 2001
From: Kai Chappell <git@kschappell.com>
Date: Wed, 28 Jan 2026 23:38:44 +0000
Subject: [PATCH] docs: fix issues found in planning document review

Riverpod updated to 3.2+ (Dart 3.7+), deployment platform set
to TBD, riverpod_generator updated to ^4.0.2.
---
 CLAUDE.md                   |  4 ++--
 changelog.md                |  6 ++++++
 docs/implementation-plan.md | 15 ++++++++-------
 3 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 9919d05..8ab7f7d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -26,9 +26,9 @@ project with Claude API integration and a public demo mode.
 
 ### Frontend (Flutter)
 
-- **Language:** Dart 3.6+ / Flutter 3.27+
+- **Language:** Dart 3.7+ / Flutter 3.27+
 - **Architecture:** Feature-First with Riverpod
-- **State Management:** Riverpod 3.1+ (generator syntax)
+- **State Management:** Riverpod 3.2+ (generator syntax)
 - **Navigation:** GoRouter
 - **HTTP Client:** dio
 - **Charts:** fl_chart (radar/spider charts for metric scores)
diff --git a/changelog.md b/changelog.md
index 502b5a6..e680d3e 100644
--- a/changelog.md
+++ b/changelog.md
@@ -13,3 +13,9 @@ This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 - Project documentation (readme, CLAUDE.md, changelog)
 - Backend and frontend directory structure
 - Implementation plan with architecture, API design, and phased build order
+
+### Changed
+
+- Updated Riverpod to 3.2+ (flutter_riverpod ^3.2.0, riverpod_annotation ^4.0.1)
+- Updated Dart minimum to 3.7+ (required by Riverpod 3.2.0)
+- Set deployment platform to TBD (decided at deployment time)
diff --git a/docs/implementation-plan.md b/docs/implementation-plan.md
index eac8acd..7e4bc48 100644
--- a/docs/implementation-plan.md
+++ b/docs/implementation-plan.md
@@ -5,7 +5,7 @@ Detailed architecture and build plan for IdeaForge.
 ## decisions
 
 - **Backend:** Python 3.11+, FastAPI, async SQLAlchemy, Pydantic, structlog, Anthropic SDK
-- **Frontend:** Flutter 3.27+, Riverpod 3.1+ (generator syntax), GoRouter, dio, fl_chart
+- **Frontend:** Flutter 3.27+, Riverpod 3.2+ (generator syntax), GoRouter, dio, fl_chart
 - **Database:** SQLite (file-based, persistent Docker volume)
 - **Relationship to idea_manager:** Fresh codebase with core code ported (not fork, not dependency)
 - **Authentication:** None for v1 — demo mode uses middleware protection
@@ -221,9 +221,9 @@ target_audience, category, status (evaluated), tags, and 8 metric scores with re
 dependencies:
   flutter:
     sdk: flutter
-  flutter_riverpod: ^2.6.1
-  riverpod_annotation: ^2.6.1
-  hooks_riverpod: ^2.6.1
+  flutter_riverpod: ^3.2.0
+  riverpod_annotation: ^4.0.1
+  hooks_riverpod: ^3.2.0
   flutter_hooks: ^0.20.5
   go_router: ^14.8.1
   dio: ^5.7.0
@@ -240,7 +240,7 @@ dev_dependencies:
   flutter_test:
     sdk: flutter
   build_runner: ^2.4.13
-  riverpod_generator: ^2.6.3
+  riverpod_generator: ^4.0.2
   freezed: ^2.5.7
   json_serializable: ^6.9.0
   very_good_analysis: ^6.0.0
@@ -406,7 +406,7 @@ Retry interceptor: 2 retries on 502/503/504 and connection timeouts only.
             │
    ┌────────▼────────┐
    │  Docker Container │
-   │  (Fly.io/Railway) │
+   │  (platform TBD)   │
    │                    │
    │  FastAPI serves:   │
    │  - /api/* routes   │
@@ -420,7 +420,8 @@ Retry interceptor: 2 retries on 502/503/504 and connection timeouts only.
 ```
 
 Single container. FastAPI serves both the API and the Flutter Web build as static files
-via `StaticFiles` mount. No CORS issues, single deployment target.
+via `StaticFiles` mount. No CORS issues, single deployment target. Hosting platform to
+be decided at deployment time (candidates: Fly.io, Railway, self-hosted).
 
 ### build pipeline