Release v26.04.05.1 — Voice I/O

record_linux 0.7.2 doesn't implement startStream from record_platform_interface 1.5.0

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.forgejo/workflows/ci.yml

@@ -0,0 +1,130 @@
+# CI runs only on release tags.
+#
+# Tag v*:  analyze + test → build APK → attach to Forgejo Release
+#
+# To cut a release:
+#   Create a release via the Forgejo UI on main with a v* tag name.
+#   The tag push triggers this workflow; the build job attaches the APK.
+#
+# Note: JavaScript actions (actions/checkout, actions/upload-artifact) cannot run
+# inside the Flutter container because it has no Node.js. All steps use shell
+# commands directly instead.
+#
+# Required secrets (repo → Settings → Secrets → Actions):
+#   RELEASE_TOKEN  — Forgejo PAT with write:repository scope
+name: CI & Build
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  analyze:
+    name: Analyze & test
+    runs-on: py3.12-node22
+    container:
+      image: ghcr.io/cirruslabs/flutter:stable
+    steps:
+      - name: Checkout
+        run: |
+          git clone "$GITHUB_SERVER_URL/$GITHUB_REPOSITORY" .
+          git checkout "$GITHUB_SHA"
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Analyze
+        run: flutter analyze
+
+      - name: Test
+        run: flutter test
+
+  build:
+    name: Build release APK
+    needs: [analyze]
+    runs-on: py3.12-node22
+    container:
+      image: ghcr.io/cirruslabs/flutter:stable
+    steps:
+      - name: Checkout
+        run: |
+          git clone "$GITHUB_SERVER_URL/$GITHUB_REPOSITORY" .
+          git checkout "$GITHUB_SHA"
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Set up release signing
+        env:
+          KEYSTORE_B64: ${{ secrets.RELEASE_KEYSTORE_BASE64 }}
+          STORE_PASSWORD: ${{ secrets.RELEASE_KEYSTORE_PASSWORD }}
+          KEY_ALIAS: ${{ secrets.RELEASE_KEY_ALIAS }}
+        run: |
+          echo "$KEYSTORE_B64" | base64 -d > android/app/release.jks
+          printf 'storePassword=%s\nkeyPassword=%s\nkeyAlias=%s\nstoreFile=release.jks\n' \
+            "$STORE_PASSWORD" "$STORE_PASSWORD" "$KEY_ALIAS" > android/key.properties
+
+      - name: Build release APK
+        run: |
+          # Derive version from the tag (e.g. v26.03.12 → name=26.03.12 number=260312)
+          TAG="${{ github.ref_name }}"
+          BUILD_NAME="${TAG#v}"
+          BUILD_NUMBER=$(echo "$BUILD_NAME" | tr -d '.')
+          flutter build apk --release \
+            --build-name="$BUILD_NAME" \
+            --build-number="$BUILD_NUMBER"
+
+      - name: Set artifact name
+        id: artifact
+        run: |
+          echo "name=fabledapp-${{ github.ref_name }}-${{ github.sha }}" >> $GITHUB_OUTPUT
+
+      - name: Upload artifact to Forgejo
+        env:
+          RELEASE_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+          APK: build/app/outputs/flutter-apk/app-release.apk
+          API: https://git.fabledsword.com/api/v1/repos/bvandeusen/FabledApp
+          ARTIFACT_NAME: ${{ steps.artifact.outputs.name }}
+        run: |
+          # Upload the APK as a workflow artifact via the Forgejo API.
+          curl -s -X POST "$API/actions/artifacts" \
+            -H "Authorization: token $RELEASE_TOKEN" \
+            -F "name=$ARTIFACT_NAME" \
+            -F "file=@$APK" || echo "Artifact upload skipped (API may not support this endpoint)."
+
+      - name: Publish Forgejo release
+        env:
+          RELEASE_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+          TAG: ${{ github.ref_name }}
+          API: https://git.fabledsword.com/api/v1/repos/bvandeusen/FabledApp
+        run: |
+          # Look for an existing release (created via the UI or a prior run).
+          EXISTING=$(curl -s \
+            "$API/releases/tags/$TAG" \
+            -H "Authorization: token $RELEASE_TOKEN")
+
+          RELEASE_ID=$(echo "$EXISTING" | grep -oE '"id":[[:space:]]*[0-9]+' | head -1 | grep -oE '[0-9]+')
+
+          if [ -n "$RELEASE_ID" ]; then
+            echo "Found existing release $TAG (id $RELEASE_ID), attaching APK..."
+          else
+            echo "No existing release found, creating $TAG..."
+            RESPONSE=$(curl -s -X POST "$API/releases" \
+              -H "Authorization: token $RELEASE_TOKEN" \
+              -H "Content-Type: application/json" \
+              -d "{\"tag_name\": \"$TAG\", \"name\": \"$TAG\", \"body\": \"\"}")
+            RELEASE_ID=$(echo "$RESPONSE" | grep -oE '"id":[[:space:]]*[0-9]+' | head -1 | grep -oE '[0-9]+')
+            if [ -z "$RELEASE_ID" ]; then
+              echo "Failed to create release. API response:"
+              echo "$RESPONSE"
+              exit 1
+            fi
+            echo "Release created with id $RELEASE_ID."
+          fi
+
+          curl -s -X POST "$API/releases/$RELEASE_ID/assets" \
+            -H "Authorization: token $RELEASE_TOKEN" \
+            -F "attachment=@build/app/outputs/flutter-apk/app-release.apk"
+
+          echo "Done — $TAG is live at:"
+          echo "https://git.fabledsword.com/bvandeusen/FabledApp/releases/tag/$TAG"

.gitignore

@@ -49,3 +49,4 @@ app.*.map.json
 /android/app/debug
 /android/app/profile
 /android/app/release
+.superpowers/

README.md

@@ -1,20 +1,21 @@
 # Fabled — Android App
 
-Native Android client for [FabledAssistant](https://github.com/yourusername/fabledassistant), a self-hosted AI productivity assistant.
+Native Android client for FabledAssistant, a self-hosted AI second-brain and productivity assistant.
 
 ## Features
 
-- **Notes** — create, edit, and browse markdown notes
-- **Tasks** — manage tasks with status (To Do / In Progress / Done) and priority
-- **Chat** — streaming AI conversations with real-time SSE response display
-- **Quick Capture** — FAB shortcut to create a note or task from anywhere
-- **OAuth / SSO** — authenticates via your server's configured OIDC provider; local username/password login also supported if enabled on the server
-- **Session persistence** — stays logged in across app restarts via a persistent cookie jar
-- **Home screen widget** — tap to open the chat screen directly from the Android launcher
+- **Daily Briefing** — the primary screen; opens on launch. Shows your AI-compiled morning digest (tasks, calendar, weather, RSS) with a full conversation you can reply to inline. Refresh manually or browse past briefings from the overflow menu.
+- **Quick Capture** — always-visible input bar above all tabs. Type a note or task and submit; multiple captures queue sequentially so the input is never blocked. Falls back to offline persistence when the server is unreachable.
+- **Library** — unified browsable list of notes, tasks, and projects with filter pills (All · Notes · Tasks · Projects). Tasks have a secondary status sub-filter and a tappable status icon to cycle todo → in progress → done without opening the editor. Inline search filters results live.
+- **Chat** — streaming AI conversations with real-time SSE display. Tap + to start a new conversation or open an existing one.
+- **Note & task editing** — full Markdown editor for notes, task editor with due date, priority, project, and milestone assignment.
+- **OAuth / SSO** — authenticates via your server's OIDC provider; local username/password login also supported if enabled server-side.
+- **Session persistence** — stays logged in across restarts via a persistent cookie jar.
+- **Auto-update** — checks your Forgejo releases on launch and prompts to download and install new APKs in-app.
 
 ## Requirements
 
-- A running [FabledAssistant](https://github.com/yourusername/fabledassistant) server (self-hosted)
+- A running FabledAssistant server (self-hosted)
 - Android 5.0+ (API 21)
 
 ## Getting Started
@@ -38,20 +39,33 @@ On first launch, enter your FabledAssistant server URL (e.g. `https://fabled.exa
 
 ```
 lib/
-├── main.dart                  # Entry point; resolves async deps before runApp
-├── app.dart                   # GoRouter + auth redirect guards + shell nav
+├── main.dart                      # Entry point; resolves async deps before runApp
+├── app.dart                       # GoRouter + auth redirect guards + 3-tab shell
 ├── core/
-│   ├── constants.dart         # Route name constants
-│   └── exceptions.dart        # AppException hierarchy
+│   ├── constants.dart             # Route name constants
+│   ├── exceptions.dart            # AppException hierarchy
+│   └── theme.dart                 # Custom slate-indigo ColorScheme + Fraunces typography
 ├── data/
-│   ├── api/                   # Dio HTTP layer (one class per resource)
-│   ├── models/                # Plain Dart models with fromJson/toJson
-│   └── repositories/          # Thin wrappers over API classes
-└── providers/                 # Riverpod providers (state + dependency wiring)
-    screens/                   # Flutter UI screens
+│   ├── api/                       # Dio HTTP layer (one class per resource)
+│   ├── models/                    # Plain Dart models with fromJson/toJson
+│   └── repositories/              # Thin wrappers over API classes
+├── providers/                     # Riverpod providers (state + dependency wiring)
+│   ├── briefing_provider.dart     # Today's briefing — optimistic UI, SSE, polling
+│   └── capture_work_queue_provider.dart  # Sequential in-memory capture queue
+├── screens/
+│   ├── briefing/                  # BriefingScreen + BriefingHistoryScreen
+│   ├── library/                   # LibraryScreen (unified notes/tasks/projects)
+│   ├── chat/                      # ConversationsTabScreen + ChatScreen
+│   ├── notes/                     # NoteDetailScreen + NoteEditScreen
+│   ├── tasks/                     # TaskEditScreen
+│   └── settings/ auth/ setup/ splash/
+└── widgets/
+    ├── chat_message_bubble.dart   # Shared bubble (used by Chat + Briefing)
+    ├── briefing_digest_card.dart  # Expandable first-message card
+    └── library_item_card.dart     # Note / task / project row widgets
 ```
 
-**Key packages:** `flutter_riverpod`, `go_router`, `dio` + `cookie_jar`, `flutter_inappwebview`, `flutter_markdown`
+**Key packages:** `flutter_riverpod`, `go_router`, `dio` + `cookie_jar`, `google_fonts`, `flutter_markdown_plus`
 
 ## Building a Release APK
 
@@ -59,4 +73,25 @@ lib/
 flutter build apk --release
 ```
 
-The signed APK will be at `build/app/outputs/flutter-apk/app-release.apk`.
+The APK will be at `build/app/outputs/flutter-apk/app-release.apk`.
+
+## CI / CD
+
+CI and build are defined in a single workflow (`.forgejo/workflows/ci.yml`) running on the shared `py3.12-node22` act runner with the `ghcr.io/cirruslabs/flutter:stable` container.
+
+| Trigger | Analyze + Test | Build APK | Release |
+|---------|---------------|-----------|---------|
+| PR | ✓ | — | — |
+| Push `dev` | ✓ | ✓ (artifact `fabledapp-dev-<sha>`) | — |
+| Push `main` | ✓ | — | — |
+| Tag `v*` | ✓ | ✓ (artifact `fabledapp-<sha>`) | ✓ Forgejo Release + APK attached |
+
+The build job has `needs: [analyze]` — a failed analyze or test blocks the APK build.
+
+To cut a release:
+
+```bash
+git tag v26.03.11 && git push origin v26.03.11
+```
+
+Requires a `RELEASE_TOKEN` secret (Forgejo PAT with `write:repository` scope) set in repo Settings → Secrets → Actions.

analysis_options.yaml

@@ -23,6 +23,9 @@ linter:
   rules:
     # avoid_print: false  # Uncomment to disable the `avoid_print` rule
     # prefer_single_quotes: true  # Uncomment to enable the `prefer_single_quotes` rule
+    # ?'key': value applies ? to the key (never null for string literals);
+    # the if (x != null) form is correct for nullable-value map entries.
+    use_null_aware_elements: false
 
 # Additional information about this file can be found at
 # https://dart.dev/guides/language/analysis-options

android/.gitignore

@@ -10,3 +10,4 @@ GeneratedPluginRegistrant.java
 # Signing secrets — never commit these
 key.properties
 fabled-release-key.jks
+app/release.jks

android/app/build.gradle.kts

@@ -37,11 +37,13 @@ android {
     }
 
     signingConfigs {
-        create("release") {
-            keyAlias = keystoreProperties["keyAlias"] as String
-            keyPassword = keystoreProperties["keyPassword"] as String
-            storeFile = file(keystoreProperties["storeFile"] as String)
-            storePassword = keystoreProperties["storePassword"] as String
+        if (keystorePropertiesFile.exists()) {
+            create("release") {
+                keyAlias = keystoreProperties["keyAlias"] as String
+                keyPassword = keystoreProperties["keyPassword"] as String
+                storeFile = file(keystoreProperties["storeFile"] as String)
+                storePassword = keystoreProperties["storePassword"] as String
+            }
         }
     }
 
@@ -59,7 +61,7 @@ android {
         val variant = this
         outputs.all {
             val output = this as? com.android.build.gradle.internal.api.BaseVariantOutputImpl
-            output?.outputFileName = "Fabled-${variant.versionName}.${variant.versionCode}.apk"
+            output?.outputFileName = "Fabled-${variant.versionCode}.apk"
         }
     }
 }

android/app/src/main/AndroidManifest.xml

@@ -1,6 +1,7 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
     <uses-permission android:name="android.permission.INTERNET"/>
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
+    <uses-permission android:name="android.permission.RECORD_AUDIO"/>
     <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
 
     <application
@@ -70,5 +71,14 @@
             <action android:name="android.intent.action.PROCESS_TEXT"/>
             <data android:mimeType="text/plain"/>
         </intent>
+        <!-- url_launcher: open http/https links in browser -->
+        <intent>
+            <action android:name="android.intent.action.VIEW"/>
+            <data android:scheme="https"/>
+        </intent>
+        <intent>
+            <action android:name="android.intent.action.VIEW"/>
+            <data android:scheme="http"/>
+        </intent>
     </queries>
 </manifest>

docs/superpowers/plans/2026-03-11-app-overhaul-p1-foundation.md

@@ -0,0 +1,720 @@
+# Fabled App Overhaul — Plan 1: Foundation (Theme + Capture Queue)
+
+> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Apply the main app's slate-indigo palette and Fraunces typography to the Flutter app, and replace the blocking quick-capture input with a multi-item sequential work queue.
+
+**Architecture:** A new `lib/core/theme.dart` defines both light and dark `ThemeData` with custom `ColorScheme` and Fraunces headings via `google_fonts`. The capture bar in `app.dart` delegates to a new `CaptureWorkQueueNotifier` (in-memory queue, drains sequentially) instead of blocking on each request. A `_captureResultProvider` carries per-item outcomes to the bar for snackbar display.
+
+**Tech Stack:** Flutter/Dart, Riverpod, google_fonts package.
+
+---
+
+## File Map
+
+**Create:**
+- `lib/core/theme.dart` — light + dark `ThemeData`, `GradientButton` widget
+- `lib/providers/capture_work_queue_provider.dart` — in-memory work queue notifier + result provider
+
+**Modify:**
+- `pubspec.yaml` — add `google_fonts: ^6.2.1`
+- `lib/main.dart` — import and use `fabledTheme` / `fabledDarkTheme`
+- `lib/app.dart` — update `_QuickCaptureBar` to use work queue
+
+---
+
+## Chunk 1: Theme
+
+### Task 1: Add google_fonts dependency
+
+**Files:**
+- Modify: `pubspec.yaml`
+
+- [ ] **Step 1: Add dependency**
+
+In the `dependencies:` section, after `flutter_markdown_plus`, add:
+```yaml
+  google_fonts: ^6.2.1
+```
+
+- [ ] **Step 2: Verify it resolves**
+
+```bash
+cd /home/bvandeusen/Nextcloud/Projects/fabled_app
+flutter pub get
+```
+
+Expected: exits 0, no version conflicts.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add pubspec.yaml pubspec.lock
+git commit -m "feat: add google_fonts dependency"
+```
+
+---
+
+### Task 2: Create theme.dart
+
+**Files:**
+- Create: `lib/core/theme.dart`
+
+- [ ] **Step 1: Create `lib/core/theme.dart`**
+
+```dart
+import 'package:flutter/material.dart';
+import 'package:google_fonts/google_fonts.dart';
+
+// ── Colour constants ──────────────────────────────────────────────────────────
+
+const _darkBackground    = Color(0xFF111113);
+const _darkSurface       = Color(0xFF18181C);
+const _darkSurfaceVar    = Color(0xFF1E1E24);
+const _darkPrimary       = Color(0xFF6366F1);
+const _darkOnSurface     = Color(0xFFE8E8F0);
+const _darkOnSurfaceVar  = Color(0xFF8888A8);
+const _darkOutline       = Color(0xFF2E2E3A);
+
+const _lightBackground   = Color(0xFFF4F4F8);
+const _lightSurface      = Color(0xFFFFFFFF);
+const _lightSurfaceVar   = Color(0xFFF0F0F5);
+const _lightPrimary      = Color(0xFF4F46E5);
+const _lightOnSurface    = Color(0xFF18181C);
+const _lightOnSurfaceVar = Color(0xFF6B6B88);
+const _lightOutline      = Color(0xFFD4D4E4);
+
+// ── Typography ─────────────────────────────────────────────────────────────────
+
+TextTheme _buildTextTheme(TextTheme base) {
+  final fraunces = GoogleFonts.frauncesTextTheme(base);
+  return base.copyWith(
+    // Headings / titles use Fraunces
+    headlineLarge:  fraunces.headlineLarge,
+    headlineMedium: fraunces.headlineMedium,
+    headlineSmall:  fraunces.headlineSmall,
+    titleLarge:     fraunces.titleLarge,
+    titleMedium:    fraunces.titleMedium,
+    // Body / labels remain system default
+  );
+}
+
+// ── Themes ─────────────────────────────────────────────────────────────────────
+
+ThemeData fabledDarkTheme() {
+  final cs = ColorScheme(
+    brightness:          Brightness.dark,
+    primary:             _darkPrimary,
+    onPrimary:           Colors.white,
+    primaryContainer:    const Color(0xFF3730A3),
+    onPrimaryContainer:  _darkOnSurface,
+    secondary:           _darkPrimary,
+    onSecondary:         Colors.white,
+    secondaryContainer:  _darkSurfaceVar,
+    onSecondaryContainer: _darkOnSurface,
+    tertiary:            _darkPrimary,
+    onTertiary:          Colors.white,
+    tertiaryContainer:   _darkSurfaceVar,
+    onTertiaryContainer: _darkOnSurface,
+    error:               const Color(0xFFEF4444),
+    onError:             Colors.white,
+    errorContainer:      const Color(0xFF7F1D1D),
+    onErrorContainer:    const Color(0xFFFEE2E2),
+    surface:             _darkSurface,
+    onSurface:           _darkOnSurface,
+    surfaceContainerHighest: _darkSurfaceVar,
+    onSurfaceVariant:    _darkOnSurfaceVar,
+    outline:             _darkOutline,
+    outlineVariant:      _darkOutline,
+    shadow:              Colors.black,
+    scrim:               Colors.black,
+    inverseSurface:      _darkOnSurface,
+    onInverseSurface:    _darkSurface,
+    inversePrimary:      _lightPrimary,
+  );
+
+  return ThemeData(
+    useMaterial3:   true,
+    colorScheme:    cs,
+    scaffoldBackgroundColor: _darkBackground,
+    textTheme: _buildTextTheme(ThemeData.dark().textTheme),
+    cardTheme: CardTheme(
+      color:         _darkSurface,
+      elevation:     2,
+      shadowColor:   Colors.black.withValues(alpha: 0.4),
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(14)),
+    ),
+    navigationBarTheme: NavigationBarThemeData(
+      backgroundColor: _darkSurface,
+      indicatorColor:  _darkPrimary.withValues(alpha: 0.2),
+    ),
+    navigationRailTheme: NavigationRailThemeData(
+      backgroundColor: _darkSurface,
+      indicatorColor:  _darkPrimary.withValues(alpha: 0.2),
+    ),
+    inputDecorationTheme: InputDecorationTheme(
+      filled:      true,
+      fillColor:   _darkSurfaceVar,
+      border: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _darkOutline),
+      ),
+      enabledBorder: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _darkOutline),
+      ),
+      focusedBorder: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _darkPrimary, width: 2),
+      ),
+    ),
+    dividerTheme: DividerThemeData(color: _darkOutline, thickness: 1),
+    chipTheme: ChipThemeData(
+      backgroundColor: _darkSurfaceVar,
+      labelStyle: TextStyle(color: _darkOnSurfaceVar, fontSize: 12),
+      side: BorderSide(color: _darkOutline),
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(8)),
+    ),
+  );
+}
+
+ThemeData fabledLightTheme() {
+  final cs = ColorScheme(
+    brightness:          Brightness.light,
+    primary:             _lightPrimary,
+    onPrimary:           Colors.white,
+    primaryContainer:    const Color(0xFFE0E0FF),
+    onPrimaryContainer:  _lightOnSurface,
+    secondary:           _lightPrimary,
+    onSecondary:         Colors.white,
+    secondaryContainer:  _lightSurfaceVar,
+    onSecondaryContainer: _lightOnSurface,
+    tertiary:            _lightPrimary,
+    onTertiary:          Colors.white,
+    tertiaryContainer:   _lightSurfaceVar,
+    onTertiaryContainer: _lightOnSurface,
+    error:               const Color(0xFFDC2626),
+    onError:             Colors.white,
+    errorContainer:      const Color(0xFFFEE2E2),
+    onErrorContainer:    const Color(0xFF7F1D1D),
+    surface:             _lightSurface,
+    onSurface:           _lightOnSurface,
+    surfaceContainerHighest: _lightSurfaceVar,
+    onSurfaceVariant:    _lightOnSurfaceVar,
+    outline:             _lightOutline,
+    outlineVariant:      _lightOutline,
+    shadow:              Colors.black,
+    scrim:               Colors.black,
+    inverseSurface:      _lightOnSurface,
+    onInverseSurface:    _lightSurface,
+    inversePrimary:      _darkPrimary,
+  );
+
+  return ThemeData(
+    useMaterial3:   true,
+    colorScheme:    cs,
+    scaffoldBackgroundColor: _lightBackground,
+    textTheme: _buildTextTheme(ThemeData.light().textTheme),
+    cardTheme: CardTheme(
+      color:         _lightSurface,
+      elevation:     1,
+      shadowColor:   Colors.black.withValues(alpha: 0.08),
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(14)),
+    ),
+    navigationBarTheme: NavigationBarThemeData(
+      backgroundColor: _lightSurface,
+      indicatorColor:  _lightPrimary.withValues(alpha: 0.12),
+    ),
+    navigationRailTheme: NavigationRailThemeData(
+      backgroundColor: _lightSurface,
+      indicatorColor:  _lightPrimary.withValues(alpha: 0.12),
+    ),
+    inputDecorationTheme: InputDecorationTheme(
+      filled:      true,
+      fillColor:   _lightSurfaceVar,
+      border: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _lightOutline),
+      ),
+      enabledBorder: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _lightOutline),
+      ),
+      focusedBorder: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _lightPrimary, width: 2),
+      ),
+    ),
+    dividerTheme: DividerThemeData(color: _lightOutline, thickness: 1),
+    chipTheme: ChipThemeData(
+      backgroundColor: _lightSurfaceVar,
+      labelStyle: TextStyle(color: _lightOnSurfaceVar, fontSize: 12),
+      side: BorderSide(color: _lightOutline),
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(8)),
+    ),
+  );
+}
+
+// ── GradientButton ─────────────────────────────────────────────────────────────
+// Use wherever the web app uses the indigo gradient button (send, primary actions).
+
+class GradientButton extends StatelessWidget {
+  final VoidCallback? onPressed;
+  final Widget child;
+  final EdgeInsetsGeometry padding;
+
+  const GradientButton({
+    super.key,
+    required this.onPressed,
+    required this.child,
+    this.padding = const EdgeInsets.symmetric(horizontal: 20, vertical: 12),
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final disabled = onPressed == null;
+    return AnimatedOpacity(
+      opacity: disabled ? 0.45 : 1.0,
+      duration: const Duration(milliseconds: 150),
+      child: DecoratedBox(
+        decoration: BoxDecoration(
+          gradient: disabled
+              ? null
+              : const LinearGradient(
+                  begin: Alignment.topLeft,
+                  end: Alignment.bottomRight,
+                  colors: [Color(0xFF6366F1), Color(0xFF4F46E5)],
+                ),
+          color: disabled ? const Color(0xFF6366F1) : null,
+          borderRadius: BorderRadius.circular(12),
+          boxShadow: disabled
+              ? null
+              : [
+                  BoxShadow(
+                    color: const Color(0xFF6366F1).withValues(alpha: 0.35),
+                    blurRadius: 8,
+                    offset: const Offset(0, 3),
+                  ),
+                ],
+        ),
+        child: Material(
+          color: Colors.transparent,
+          child: InkWell(
+            onTap: onPressed,
+            borderRadius: BorderRadius.circular(12),
+            child: Padding(padding: padding, child: child),
+          ),
+        ),
+      ),
+    );
+  }
+}
+```
+
+- [ ] **Step 2: Verify it compiles**
+
+```bash
+cd /home/bvandeusen/Nextcloud/Projects/fabled_app
+flutter analyze lib/core/theme.dart
+```
+
+Expected: no errors (warnings about deprecated APIs are OK).
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add lib/core/theme.dart
+git commit -m "feat: custom slate-indigo theme with Fraunces typography"
+```
+
+---
+
+### Task 3: Wire theme into the app
+
+**Files:**
+- Modify: `lib/main.dart` (import theme)
+- Modify: `lib/app.dart` (FabledApp widget uses new themes)
+
+- [ ] **Step 1: Read `lib/app.dart` lines 498–523 (the `FabledApp` widget)**
+
+Locate the `FabledApp.build()` method. It currently has:
+```dart
+theme: ThemeData(
+  colorScheme: ColorScheme.fromSeed(seedColor: Colors.indigo),
+  useMaterial3: true,
+),
+darkTheme: ThemeData(
+  colorScheme: ColorScheme.fromSeed(
+    seedColor: Colors.indigo,
+    brightness: Brightness.dark,
+  ),
+  useMaterial3: true,
+),
+```
+
+- [ ] **Step 2: Replace with custom themes**
+
+Add import at the top of `lib/app.dart`:
+```dart
+import 'core/theme.dart';
+```
+
+Replace the `theme:` and `darkTheme:` arguments:
+```dart
+theme: fabledLightTheme(),
+darkTheme: fabledDarkTheme(),
+```
+
+Remove the now-unused `import 'package:flutter/material.dart'` reference to `Colors.indigo` (keep the `material.dart` import itself).
+
+- [ ] **Step 3: Run the app and visually verify**
+
+```bash
+flutter run --debug
+```
+
+Expected: app launches with dark slate-indigo background, indigo navigation bar, Fraunces headings visible on any screen that uses `titleLarge` or `headlineMedium`. No runtime errors.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add lib/app.dart
+git commit -m "feat: wire fabledLightTheme/fabledDarkTheme into MaterialApp"
+```
+
+---
+
+## Chunk 2: Capture Work Queue
+
+### Task 4: Create CaptureWorkQueueNotifier
+
+**Files:**
+- Create: `lib/providers/capture_work_queue_provider.dart`
+
+This provider manages an in-memory FIFO queue of capture texts. A single async drain loop processes them sequentially. On success it publishes a result via `captureResultProvider` so the UI can show a snackbar. On `NetworkException` it falls through to the offline `captureQueueProvider`.
+
+- [ ] **Step 1: Create `lib/providers/capture_work_queue_provider.dart`**
+
+```dart
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+import '../core/exceptions.dart';
+import '../data/api/quick_capture_api.dart';
+import 'api_client_provider.dart';
+import 'capture_queue_provider.dart';
+import 'notes_provider.dart';
+import 'tasks_provider.dart';
+
+/// Outcome of a single capture attempt — consumed by the UI for snackbars.
+class CaptureResult {
+  final String message;
+  final bool isError;
+  const CaptureResult(this.message, {this.isError = false});
+}
+
+/// The most recent capture result. UI watches this to show snackbars.
+/// Reset to null by the notifier before each new item so listeners always fire.
+final captureResultProvider = StateProvider<CaptureResult?>((_) => null);
+
+/// In-memory sequential work queue for quick captures.
+/// Separate from [captureQueueProvider] (which is the offline persistence queue).
+final captureWorkQueueProvider =
+    StateNotifierProvider<CaptureWorkQueueNotifier, List<String>>(
+  (ref) => CaptureWorkQueueNotifier(ref),
+);
+
+class CaptureWorkQueueNotifier extends StateNotifier<List<String>> {
+  final Ref _ref;
+  bool _running = false;
+
+  CaptureWorkQueueNotifier(this._ref) : super([]);
+
+  /// Add text to the queue and start the drain loop if not already running.
+  void enqueue(String text) {
+    state = [...state, text];
+    _drain();
+  }
+
+  Future<void> _drain() async {
+    if (_running) return;
+    _running = true;
+    try {
+      while (state.isNotEmpty) {
+        final text = state.first;
+        // Signal "no result yet" so the same result value can re-trigger watch.
+        _ref.read(captureResultProvider.notifier).state = null;
+        try {
+          final api = _ref.read(quickCaptureApiProvider);
+          final result = await api.capture(text);
+
+          // Dequeue on success.
+          state = state.length > 1 ? state.sublist(1) : [];
+
+          // Invalidate content providers so lists refresh.
+          switch (result.type) {
+            case 'note':
+              _ref.invalidate(notesProvider);
+            case 'task':
+            case 'todo':
+              _ref.invalidate(tasksProvider);
+          }
+
+          // Publish result for snackbar.
+          final msg = result.message.isNotEmpty
+              ? result.message
+              : '${_typeLabel(result.type)} created: ${result.title}';
+          _ref.read(captureResultProvider.notifier).state =
+              CaptureResult(msg);
+        } on NetworkException catch (_) {
+          // Persist to offline queue and stop draining — still offline.
+          await _ref.read(captureQueueProvider.notifier).enqueue(text);
+          state = state.length > 1 ? state.sublist(1) : [];
+          _ref.read(captureResultProvider.notifier).state = CaptureResult(
+            "You're offline — capture saved and will retry automatically.",
+            isError: false,
+          );
+          break;
+        } on AppException catch (e) {
+          state = state.length > 1 ? state.sublist(1) : [];
+          _ref.read(captureResultProvider.notifier).state =
+              CaptureResult(e.message, isError: true);
+        } catch (_) {
+          state = state.length > 1 ? state.sublist(1) : [];
+          _ref.read(captureResultProvider.notifier).state =
+              CaptureResult('Capture failed. Please try again.', isError: true);
+        }
+      }
+    } finally {
+      _running = false;
+    }
+  }
+
+  String _typeLabel(String type) => switch (type) {
+        'note' => 'Note',
+        'task' => 'Task',
+        'event' => 'Event',
+        'todo' => 'To-do',
+        _ => type,
+      };
+}
+```
+
+- [ ] **Step 2: Analyze for errors**
+
+```bash
+flutter analyze lib/providers/capture_work_queue_provider.dart
+```
+
+Expected: no errors.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add lib/providers/capture_work_queue_provider.dart
+git commit -m "feat: CaptureWorkQueueNotifier — sequential multi-item capture queue"
+```
+
+---
+
+### Task 5: Update _QuickCaptureBar to use the work queue
+
+**Files:**
+- Modify: `lib/app.dart` — `_QuickCaptureBarState`
+
+The bar currently calls `ref.read(quickCaptureApiProvider).capture(text)` directly and sets `_busy`. Replace with: enqueue to work queue, watch queue depth for badge, watch `captureResultProvider` for snackbars, show progress bar when queue is non-empty.
+
+- [ ] **Step 1: Add imports to `lib/app.dart`**
+
+Add at the top alongside existing imports:
+```dart
+import 'providers/capture_work_queue_provider.dart';
+```
+
+- [ ] **Step 2: Replace `_QuickCaptureBarState` completely**
+
+Replace the entire `_QuickCaptureBarState` class (from `class _QuickCaptureBarState` through its closing `}`) with:
+
+```dart
+class _QuickCaptureBarState extends ConsumerState<_QuickCaptureBar> {
+  final _controller = TextEditingController();
+
+  @override
+  void initState() {
+    super.initState();
+    WidgetsBinding.instance.addPostFrameCallback((_) => _drainOfflineQueue());
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
+  void _submit() {
+    final text = _controller.text.trim();
+    if (text.isEmpty) return;
+    _controller.clear();
+    setState(() {}); // clear suffix icon
+    ref.read(captureWorkQueueProvider.notifier).enqueue(text);
+  }
+
+  Future<void> _drainOfflineQueue() async {
+    if (!mounted) return;
+    final queue = ref.read(captureQueueProvider);
+    if (queue.isEmpty) return;
+    final api = ref.read(quickCaptureApiProvider);
+    for (final text in List<String>.from(queue)) {
+      if (!mounted) break;
+      try {
+        final result = await api.capture(text);
+        if (!mounted) break;
+        await ref.read(captureQueueProvider.notifier).dequeue(text);
+        switch (result.type) {
+          case 'note':
+            ref.invalidate(notesProvider);
+          case 'task':
+          case 'todo':
+            ref.invalidate(tasksProvider);
+            ref.invalidate(projectsProvider);
+            ref.invalidate(projectMilestonesProvider);
+        }
+      } on NetworkException {
+        break;
+      } catch (_) {
+        if (mounted) await ref.read(captureQueueProvider.notifier).dequeue(text);
+      }
+    }
+  }
+
+  String _hintForLocation(String location) {
+    if (location.startsWith(Routes.tasks)) return 'Add a task…';
+    if (location.startsWith(Routes.conversations)) return 'Ask Fabled…';
+    return 'Capture a note…';
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final location = GoRouterState.of(context).matchedLocation;
+    final offlineQueueCount = ref.watch(captureQueueProvider).length;
+    final workQueue = ref.watch(captureWorkQueueProvider);
+    final isWorking = workQueue.isNotEmpty;
+    final totalPending = workQueue.length + offlineQueueCount;
+
+    // Show snackbar when a result is published.
+    ref.listen(captureResultProvider, (_, result) {
+      if (result == null || !mounted) return;
+      ScaffoldMessenger.of(context).showSnackBar(
+        SnackBar(
+          content: Text(result.message),
+          behavior: SnackBarBehavior.floating,
+        ),
+      );
+    });
+
+    return SafeArea(
+      bottom: false,
+      child: Column(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          Padding(
+            padding: const EdgeInsets.fromLTRB(12, 8, 4, 4),
+            child: Row(
+              children: [
+                Expanded(
+                  child: TextField(
+                    controller: _controller,
+                    textInputAction: TextInputAction.send,
+                    onSubmitted: (_) => _submit(),
+                    onChanged: (_) => setState(() {}),
+                    decoration: InputDecoration(
+                      hintText: _hintForLocation(location),
+                      isDense: true,
+                      contentPadding: const EdgeInsets.symmetric(
+                          horizontal: 14, vertical: 10),
+                      prefixIcon: totalPending > 0
+                          ? Badge(
+                              label: Text('$totalPending'),
+                              child: const Icon(Icons.cloud_upload_outlined),
+                            )
+                          : isWorking
+                              ? const Padding(
+                                  padding: EdgeInsets.all(12),
+                                  child: SizedBox(
+                                    width: 16,
+                                    height: 16,
+                                    child: CircularProgressIndicator(
+                                        strokeWidth: 2),
+                                  ),
+                                )
+                              : const Icon(Icons.auto_awesome_outlined),
+                      suffixIcon: _controller.text.trim().isNotEmpty
+                          ? IconButton(
+                              icon: const Icon(Icons.send),
+                              onPressed: _submit,
+                              tooltip: 'Capture',
+                            )
+                          : null,
+                    ),
+                  ),
+                ),
+                IconButton(
+                  icon: const Icon(Icons.settings_outlined),
+                  tooltip: 'Settings',
+                  onPressed: () => context.push(Routes.settings),
+                ),
+              ],
+            ),
+          ),
+          // Thin progress bar while the work queue is draining.
+          if (isWorking)
+            const LinearProgressIndicator(minHeight: 2)
+          else
+            const SizedBox(height: 2),
+        ],
+      ),
+    );
+  }
+}
+```
+
+- [ ] **Step 3: Remove now-unused `_busy` field and old `_submit`/`_send` methods**
+
+They are fully replaced by the new class above. Verify there are no remaining references to `_busy` or the old `_send` method in `_QuickCaptureBarState`.
+
+- [ ] **Step 4: Analyze**
+
+```bash
+flutter analyze lib/app.dart
+```
+
+Expected: no errors. Fix any missing imports surfaced by the analyzer.
+
+- [ ] **Step 5: Run and test manually**
+
+```bash
+flutter run --debug
+```
+
+Test:
+1. Type a capture and submit — input clears immediately, progress bar appears briefly, snackbar shows on completion
+2. Type and submit 3 captures rapidly — all 3 appear in the queue badge, drain one by one, 3 snackbars appear in sequence
+3. The input field is never disabled during processing
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add lib/app.dart
+git commit -m "feat: multi-item capture work queue with sequential drain and progress indicator"
+```
+
+---
+
+## Verification Checklist
+
+- [ ] `flutter analyze` — zero errors
+- [ ] App launches with dark slate-indigo background on a device/emulator in dark mode
+- [ ] App launches with light theme when device is set to light mode
+- [ ] Fraunces font visible in screen titles (e.g. Notes AppBar title)
+- [ ] Capture bar: submit while processing → second item queues, badge shows count
+- [ ] Capture bar: submit 3 items → all drain sequentially, 3 snackbars
+- [ ] Offline: capture → "saved and will retry" snackbar, falls to offline queue

docs/superpowers/specs/2026-03-11-fabled-app-overhaul-design.md

@@ -0,0 +1,253 @@
+# Fabled App Overhaul — Design Spec
+
+**Date:** 2026-03-11
+**Project:** `/home/bvandeusen/Nextcloud/Projects/fabled_app`
+
+## Goal
+
+Reposition the Flutter Android app from a general-purpose mirror of the web app into a focused mobile companion: the Daily Briefing is the primary experience, Quick Capture is the secondary utility, and Notes/Tasks/Projects are a browsable library — secondary to both.
+
+---
+
+## Navigation & Shell
+
+Three-tab shell replacing the current four-tab (Notes · Tasks · Projects · Chat) structure.
+
+| Tab | Icon | Screen | Route |
+|-----|------|--------|-------|
+| Briefing | `Icons.wb_sunny_outlined` / `Icons.wb_sunny` | `BriefingScreen` | `/briefing` |
+| Library | `Icons.library_books_outlined` / `Icons.library_books` | `LibraryScreen` | `/library` |
+| Chat | `Icons.chat_bubble_outline` / `Icons.chat_bubble` | `ConversationsListScreen` (inline) | `/conversations` |
+
+The `_QuickCaptureBar` remains pinned above the shell on all three tabs. The settings icon stays in the capture bar row.
+
+**Briefing is the initial route** — the app opens directly to the briefing tab on every launch.
+
+**Wide layout (≥ 600dp):** `NavigationRail` on the left (as today), same 3 destinations.
+
+### Dead Code Removed
+
+**Screens deleted:**
+- `lib/screens/notes/notes_list_screen.dart`
+- `lib/screens/tasks/tasks_list_screen.dart`
+- `lib/screens/projects/project_list_screen.dart`
+- `lib/screens/chat/conversations_list_screen.dart`
+- `lib/screens/quick_capture/quick_capture_screen.dart`
+
+**Screens kept:**
+- `lib/screens/notes/note_detail_screen.dart`
+- `lib/screens/notes/note_edit_screen.dart`
+- `lib/screens/tasks/task_edit_screen.dart`
+- `lib/screens/chat/chat_screen.dart`
+- All auth, settings, setup, splash screens
+
+---
+
+## Theme
+
+Custom `ColorScheme` matching the main web app's "Illuminated Transcript" palette, in `lib/core/theme.dart`. System light/dark preference respected.
+
+### Dark theme
+| Token | Value |
+|-------|-------|
+| `background` | `#111113` |
+| `surface` | `#18181c` |
+| `primary` | `#6366f1` |
+| `onSurface` | `#e8e8f0` |
+| `onSurfaceVariant` (muted) | `#8888a8` |
+
+### Light theme
+| Token | Value |
+|-------|-------|
+| `background` | `#f4f4f8` |
+| `surface` | `#ffffff` |
+| `primary` | `#4f46e5` |
+| `onSurface` | `#18181c` |
+| `onSurfaceVariant` (muted) | `#6b6b88` |
+
+### Typography
+- Add `google_fonts` to `pubspec.yaml`
+- `headlineMedium`, `titleLarge`, `titleMedium` → `GoogleFonts.fraunces()`
+- Body styles → system default (unchanged)
+
+### Buttons & Cards
+- Primary action buttons: `BoxDecoration` with `LinearGradient(135°, #6366f1, #4f46e5)`; applied to send buttons in capture bar and briefing reply bar
+- Cards: `borderRadius: 14`, subtle elevation shadow, no explicit border
+
+---
+
+## BriefingScreen
+
+**File:** `lib/screens/briefing/briefing_screen.dart`
+
+The app's primary screen. Opens on launch.
+
+### Layout
+
+```
+AppBar:
+  title: "Briefing" (Fraunces)
+  subtitle: today's date ("Wednesday, March 11")
+  actions: [↻ refresh button]
+
+Body (scrollable column):
+  ┌─ DigestCard ──────────────────────┐
+  │  ☀ Good morning — Mar 11          │
+  │  [first assistant message,         │
+  │   truncated to 5 lines]           │
+  │                  [Show more ↓]    │
+  └───────────────────────────────────┘
+
+  ─── Conversation ───
+
+  [scrollable message list]
+  [streaming bubble while generating]
+
+Bottom pinned:
+  [  Reply to your briefing…  ] [➤]
+```
+
+### Digest Card
+- Extracted widget: `lib/widgets/briefing_digest_card.dart`
+- Shows the content of the first `assistant` message from today's conversation
+- Truncated to 5 lines by default; `[Show more]` expands with `AnimatedSize`
+- If no briefing exists yet: "No briefing yet today" placeholder + "Generate now" button
+
+### Conversation
+- Message bubbles reuse the same widget used in `ChatScreen`; extracted to `lib/widgets/chat_message_bubble.dart` (shared between both screens)
+- User messages: right-aligned, primary colour container
+- Assistant messages: left-aligned, surface container with left accent border (indigo, 2dp)
+- Streaming: a streaming bubble appears at the bottom of the list while SSE is active
+
+### Reply Bar
+- Always visible (pinned to bottom, above system nav bar)
+- Send button: indigo gradient, disabled when input is empty or streaming
+- Submitting a reply uses the existing SSE chat endpoint with today's briefing `conversation_id`
+
+### Overflow Menu (`···`)
+- "View past briefings" → pushes `BriefingHistoryScreen` (simple date list, read-only — no reply bar)
+
+### Refresh Button
+- Calls `POST /api/briefing/trigger` with `{"slot": "compilation"}`
+- Shows `CircularProgressIndicator` in the AppBar while in-flight
+- Reloads conversation on completion
+
+### New Files
+- `lib/screens/briefing/briefing_screen.dart`
+- `lib/screens/briefing/briefing_history_screen.dart`
+- `lib/widgets/briefing_digest_card.dart`
+- `lib/widgets/chat_message_bubble.dart` (extracted from ChatScreen)
+- `lib/data/api/briefing_api.dart` — `getToday()`, `getMessages(id)`, `triggerSlot(slot)`
+- `lib/data/models/briefing_conversation.dart` — `id`, `briefingDate`, `title`, `messages`
+- `lib/providers/briefing_provider.dart` — `briefingTodayProvider` (AsyncNotifier)
+
+---
+
+## LibraryScreen
+
+**File:** `lib/screens/library/library_screen.dart`
+
+Unified browsing screen for notes, tasks, and projects.
+
+### Layout
+
+```
+AppBar:
+  title: "Library"
+  actions: [🔍 search icon → expands inline search bar]
+
+Filter pills (scrollable horizontal row):
+  [All]  [Notes]  [Tasks]  [Projects]
+
+Content:
+  Unified list sorted by updated_at desc
+  Each item: LibraryItemCard
+
+FAB:
+  [+] → bottom sheet: "New note" | "New task"
+```
+
+### Filter Pills
+| Pill | Content | Extra controls |
+|------|---------|----------------|
+| All | Notes + tasks interleaved | — |
+| Notes | Notes only | — |
+| Tasks | Tasks only | Secondary status row: Todo · In Progress · Done · All |
+| Projects | Project cards | — |
+
+### Item Cards (`lib/widgets/library_item_card.dart`)
+- **Note:** title (Fraunces medium), 1-line body snippet, tag chips, relative timestamp
+- **Task:** status checkbox (tappable → cycles `todo → in_progress → done` via `PATCH /api/tasks/:id/status`), title, due date, priority dot (high = red, medium = amber)
+- **Project:** left colour strip matching project colour, title, active task count, milestone progress bar
+
+### Search
+- Tapping 🔍 slides an `AnimatedContainer` search bar into the AppBar
+- Searches title + body across notes and tasks via `GET /api/notes?q=` (respects active filter pill)
+- Dismisses with Escape / back gesture
+
+### FAB
+- Bottom sheet with two large tap targets: "New note" → `NoteEditScreen`, "New task" → `TaskEditScreen`
+
+### New Files
+- `lib/screens/library/library_screen.dart`
+- `lib/widgets/library_item_card.dart`
+
+---
+
+## Quick Capture Queue
+
+The `_QuickCaptureBar` in `app.dart` is updated to support multiple in-flight captures queued sequentially.
+
+### Behaviour
+- Input **never disables** while the worker is active (only disables on offline — existing behaviour)
+- Submitting appends text to the work queue; the worker drains it one item at a time
+- Each completion fires a snackbar (`"Note created: …"`)
+- Queue depth > 0: prefix icon shows a badge `⋯ N`
+- Worker active: a 2dp `LinearProgressIndicator` in indigo animates below the capture bar
+
+### Implementation
+- New `lib/providers/capture_work_queue_provider.dart` — `CaptureWorkQueueNotifier` (in-memory `List<String>` + async drain loop)
+- Separate from the existing `captureQueueProvider` (which handles offline persistence); the two queues are distinct:
+  - **Work queue:** in-memory, drains sequentially while online
+  - **Offline queue:** persisted to SharedPreferences, drained on reconnect
+- Network errors during work queue drain fall through to offline queue (existing logic)
+
+---
+
+## Files Created / Modified Summary
+
+**New:**
+- `lib/core/theme.dart`
+- `lib/screens/briefing/briefing_screen.dart`
+- `lib/screens/briefing/briefing_history_screen.dart`
+- `lib/screens/library/library_screen.dart`
+- `lib/widgets/briefing_digest_card.dart`
+- `lib/widgets/chat_message_bubble.dart`
+- `lib/widgets/library_item_card.dart`
+- `lib/data/api/briefing_api.dart`
+- `lib/data/models/briefing_conversation.dart`
+- `lib/providers/briefing_provider.dart`
+- `lib/providers/capture_work_queue_provider.dart`
+
+**Modified:**
+- `lib/app.dart` — new 3-tab shell, new routes, updated `_QuickCaptureBar`
+- `lib/main.dart` — import `theme.dart`
+- `lib/screens/chat/chat_screen.dart` — extract bubble widget
+- `pubspec.yaml` — add `google_fonts`
+
+**Deleted:**
+- `lib/screens/notes/notes_list_screen.dart`
+- `lib/screens/tasks/tasks_list_screen.dart`
+- `lib/screens/projects/project_list_screen.dart`
+- `lib/screens/chat/conversations_list_screen.dart`
+- `lib/screens/quick_capture/quick_capture_screen.dart`
+
+---
+
+## Out of Scope
+
+- iOS support — Android only, as today
+- Workspace view — web-only feature
+- Graph view — web-only feature
+- Note editing from Library (tap → NoteDetailScreen → edit button, as today)
+- Push notification handling in-app — handled by the OS notification tray

docs/superpowers/specs/2026-04-04-knowledge-view-design.md

@@ -0,0 +1,455 @@
+# Knowledge View — Android App Design Spec
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Replace the Library tab with a typed Knowledge view and add a dedicated Projects tab, bringing the Android app to parity with the web Knowledge view while using the existing backend `/api/knowledge` and `/api/projects` endpoints.
+
+**Architecture:** Two-tier pagination — fetch IDs cheaply (50 at a time), hydrate visible items in batches of 12. Type tabs drive server-side filtering. A new Projects tab replaces the project section formerly in Library. All data access goes through the existing Riverpod/Dio/repository pattern.
+
+**Tech Stack:** Flutter 3, Riverpod 3, GoRouter 17, Dio 5, existing backend REST API (`/api/knowledge`, `/api/projects`, `/api/notes`)
+
+---
+
+## Manifest & Configuration Checklist
+
+These must be verified before any code is written. Failures here cause silent runtime errors.
+
+- [ ] `android/app/src/main/AndroidManifest.xml` — confirm `<uses-permission android:name="android.permission.INTERNET" />` is present
+- [ ] `android/app/src/main/AndroidManifest.xml` — confirm `android:usesCleartextTraffic="true"` is set on the `<application>` tag (required for HTTP dev server connections; if already using HTTPS only, leave as-is but document the decision)
+- [ ] `pubspec.yaml` — no new dependencies required for Knowledge View
+- [ ] `android/app/build.gradle` — no changes required for Knowledge View
+
+---
+
+## File Map
+
+### New files
+| Path | Responsibility |
+|---|---|
+| `lib/data/models/knowledge_item.dart` | Unified model for all knowledge types (note, person, place, list, task) |
+| `lib/data/api/knowledge_api.dart` | Two API methods: fetch IDs, batch-hydrate items |
+| `lib/data/repositories/knowledge_repository.dart` | Thin repo wrapping KnowledgeApi |
+| `lib/providers/knowledge_provider.dart` | StateNotifier with two-tier pagination state |
+| `lib/screens/knowledge/knowledge_screen.dart` | Main Knowledge screen with type tabs, tag chips, search, infinite scroll |
+| `lib/widgets/knowledge_item_card.dart` | Type-aware card widget (different icon/subtitle per type) |
+| `lib/screens/projects/projects_screen.dart` | Project list sorted by updated_at desc |
+| `lib/screens/projects/project_edit_screen.dart` | Create/edit project (title, description, goal, status) |
+
+### Modified files
+| Path | Change |
+|---|---|
+| `lib/data/models/note.dart` | Add `noteType` field (String, default `'note'`) |
+| `lib/data/models/project.dart` | Add `status`, `goal`, `color`, `autoSummary`, `updatedAt` fields |
+| `lib/data/api/notes_api.dart` | Pass `note_type` in create and update request bodies |
+| `lib/data/api/projects_api.dart` | Add `sort=updated_at&order=desc` to list call; add `status`, `goal`, `color` to create/update |
+| `lib/screens/notes/note_edit_screen.dart` | Accept optional `noteType` parameter; show type badge in app bar; pass `note_type` to API |
+| `lib/screens/library/project_tasks_screen.dart` | Add edit button in app bar pushing to `ProjectEditScreen` |
+| `lib/app.dart` | Replace `Routes.library` with `Routes.knowledge` + `Routes.projects`; update shell to 4 tabs |
+| `lib/core/constants.dart` | Add `Routes.knowledge`, `Routes.projects`; remove `Routes.library` |
+
+### Retired files
+| Path | Replacement |
+|---|---|
+| `lib/screens/library/library_screen.dart` | `KnowledgeScreen` + `ProjectsScreen` |
+| `lib/widgets/library_item_card.dart` | `KnowledgeItemCard` |
+
+---
+
+## Section 1: Navigation
+
+Four tabs replace the existing three:
+
+```
+Briefing  |  Knowledge  |  Chat  |  Projects
+```
+
+**`lib/core/constants.dart`:**
+- Remove `static const library = '/library'`
+- Add `static const knowledge = '/knowledge'`
+- `projects` already exists as `'/projects'` — no change needed
+- Add `static const projectEdit = '/projects/:id/edit'`
+
+**`lib/app.dart` — `_ShellState`:**
+```dart
+static const _tabs = [
+  Routes.briefing,
+  Routes.knowledge,
+  Routes.conversations,
+  Routes.projects,
+];
+```
+
+Shell `NavigationBar` / `NavigationRail` entries:
+```dart
+// Bottom nav
+NavigationDestination(icon: Icon(Icons.wb_sunny_outlined), selectedIcon: Icon(Icons.wb_sunny), label: 'Briefing'),
+NavigationDestination(icon: Icon(Icons.menu_book_outlined), selectedIcon: Icon(Icons.menu_book), label: 'Knowledge'),
+NavigationDestination(icon: Icon(Icons.chat_bubble_outline), selectedIcon: Icon(Icons.chat_bubble), label: 'Chat'),
+NavigationDestination(icon: Icon(Icons.folder_outlined), selectedIcon: Icon(Icons.folder), label: 'Projects'),
+```
+
+**`_QuickCaptureBar._hintForLocation` update:**
+```dart
+String _hintForLocation(String location) {
+  if (location.startsWith(Routes.knowledge)) return 'Capture a note…';
+  if (location.startsWith(Routes.projects)) return 'Capture a note…';
+  if (location.startsWith(Routes.conversations)) return 'Ask Fabled…';
+  return 'Capture a note…';
+}
+```
+
+**GoRouter shell routes** — replace `Routes.library` route with:
+```dart
+GoRoute(path: Routes.knowledge, builder: (_, _) => const KnowledgeScreen()),
+GoRoute(path: Routes.projects, builder: (_, _) => const ProjectsScreen()),
+```
+
+---
+
+## Section 2: Data Models
+
+### `lib/data/models/knowledge_item.dart`
+```dart
+class KnowledgeItem {
+  final int id;
+  final String noteType;   // 'note' | 'person' | 'place' | 'list' | 'task'
+  final String title;
+  final String body;
+  final List<String> tags;
+  final int? projectId;
+  final int? milestoneId;
+  final int? parentId;
+  // Task-only fields (null for non-tasks)
+  final String? status;    // 'todo' | 'in_progress' | 'done' | 'cancelled'
+  final String? priority;  // 'low' | 'normal' | 'high'
+  final String? dueDate;
+  final DateTime createdAt;
+  final DateTime updatedAt;
+
+  const KnowledgeItem({...});
+
+  factory KnowledgeItem.fromJson(Map<String, dynamic> json) => KnowledgeItem(
+    id: json['id'] as int,
+    noteType: json['note_type'] as String? ?? 'note',
+    title: json['title'] as String? ?? '',
+    body: json['body'] as String? ?? '',
+    tags: (json['tags'] as List<dynamic>?)?.map((e) => e as String).toList() ?? [],
+    projectId: json['project_id'] as int?,
+    milestoneId: json['milestone_id'] as int?,
+    parentId: json['parent_id'] as int?,
+    status: json['status'] as String?,
+    priority: json['priority'] as String?,
+    dueDate: json['due_date'] as String?,
+    createdAt: DateTime.parse(json['created_at'] as String),
+    updatedAt: DateTime.parse(json['updated_at'] as String),
+  );
+}
+```
+
+### `lib/data/models/note.dart` — add `noteType`
+```dart
+final String noteType;  // new field
+
+// In constructor:
+required this.noteType,
+
+// In fromJson:
+noteType: json['note_type'] as String? ?? 'note',
+
+// In toJson:
+'note_type': noteType,
+
+// In copyWith: add noteType parameter
+```
+
+### `lib/data/models/project.dart` — add missing fields
+```dart
+final String status;       // 'active' | 'completed' | 'archived'
+final String? goal;
+final String? color;
+final String? autoSummary;
+final DateTime updatedAt;
+
+// In fromJson:
+status: json['status'] as String? ?? 'active',
+goal: json['goal'] as String?,
+color: json['color'] as String?,
+autoSummary: json['auto_summary'] as String?,
+updatedAt: DateTime.parse(json['updated_at'] as String),
+```
+
+---
+
+## Section 3: API Layer
+
+### `lib/data/api/knowledge_api.dart`
+```dart
+class KnowledgeApi {
+  final Dio _dio;
+  const KnowledgeApi(this._dio);
+
+  /// Fetch page of IDs. Returns (ids, total).
+  Future<(List<int>, int)> fetchIds({
+    String? noteType,
+    List<String> tags = const [],
+    String sort = 'modified',
+    String? q,
+    int limit = 50,
+    int offset = 0,
+  }) async {
+    final params = <String, dynamic>{
+      'limit': limit,
+      'offset': offset,
+      'sort': sort,
+      if (noteType != null) 'type': noteType,
+      if (tags.isNotEmpty) 'tags': tags.join(','),
+      if (q != null && q.isNotEmpty) 'q': q,
+    };
+    final response = await _dio.get('/api/knowledge/ids', queryParameters: params);
+    final data = response.data as Map<String, dynamic>;
+    final ids = (data['ids'] as List<dynamic>).map((e) => e as int).toList();
+    final total = data['total'] as int;
+    return (ids, total);
+  }
+
+  /// Batch-hydrate up to 100 IDs into full items.
+  Future<List<KnowledgeItem>> fetchBatch(List<int> ids) async {
+    if (ids.isEmpty) return [];
+    final response = await _dio.get(
+      '/api/knowledge/batch',
+      queryParameters: {'ids': ids.join(',')},
+    );
+    final data = response.data as Map<String, dynamic>;
+    return (data['items'] as List<dynamic>)
+        .map((e) => KnowledgeItem.fromJson(e as Map<String, dynamic>))
+        .toList();
+  }
+
+  /// Per-type counts for tab labels.
+  Future<Map<String, int>> fetchCounts({List<String> tags = const []}) async {
+    final params = <String, dynamic>{
+      if (tags.isNotEmpty) 'tags': tags.join(','),
+    };
+    final response = await _dio.get('/api/knowledge/counts', queryParameters: params);
+    return (response.data as Map<String, dynamic>).map(
+      (k, v) => MapEntry(k, (v as num).toInt()),
+    );
+  }
+
+  /// All tags for the current type filter.
+  Future<List<String>> fetchTags({String? noteType}) async {
+    final response = await _dio.get(
+      '/api/knowledge/tags',
+      queryParameters: {if (noteType != null) 'type': noteType},
+    );
+    return (response.data['tags'] as List<dynamic>).map((e) => e as String).toList();
+  }
+}
+```
+
+### `lib/data/api/projects_api.dart` — add sort params + missing fields
+Add `sort: 'updated_at'` and `order: 'desc'` to the `getProjects` query parameters.
+Add `status`, `goal`, `color` to `createProject` and `updateProject` request bodies.
+
+### `lib/data/api/notes_api.dart` — pass `note_type`
+```dart
+// In createNote and updateNote bodies:
+if (noteType != null) 'note_type': noteType,
+```
+
+---
+
+## Section 4: Provider
+
+### `lib/providers/knowledge_provider.dart`
+
+```dart
+@immutable
+class KnowledgeState {
+  final List<int> ids;                        // all fetched IDs so far
+  final Map<int, KnowledgeItem> items;        // hydrated items
+  final int totalIds;
+  final bool isLoadingIds;
+  final bool isLoadingBatch;
+  final bool hasMore;
+  final String? noteType;                     // active type filter
+  final List<String> activeTags;
+  final String? searchQuery;
+  final Map<String, int> counts;             // per-type counts
+
+  bool get canLoadMore => hasMore && !isLoadingIds;
+  // Items in ID order, only those hydrated
+  List<KnowledgeItem> get orderedItems =>
+      ids.where(items.containsKey).map((id) => items[id]!).toList();
+}
+
+class KnowledgeNotifier extends StateNotifier<KnowledgeState> {
+  // On filter change: reset state, fetch IDs from offset 0
+  void setTypeFilter(String? noteType) { ... }
+  void toggleTag(String tag) { ... }
+  void setSearch(String? q) { ... }  // debounce handled in UI
+
+  // Fetch next page of IDs (50 at a time)
+  Future<void> loadMoreIds() { ... }
+
+  // Hydrate the next 12 un-hydrated IDs from the current list
+  Future<void> hydrateNext() { ... }
+
+  Future<void> refresh() { ... }  // reset + reload
+}
+
+// Provider
+final knowledgeProvider =
+    StateNotifierProvider<KnowledgeNotifier, KnowledgeState>(...);
+```
+
+**Scroll trigger:** `KnowledgeScreen` attaches a `ScrollController` listener. When `position.pixels >= maxScrollExtent - 300`:
+1. Call `hydrateNext()` if there are un-hydrated IDs in the list
+2. Call `loadMoreIds()` if all fetched IDs are hydrated and `hasMore` is true
+
+---
+
+## Section 5: Knowledge Screen
+
+### `lib/screens/knowledge/knowledge_screen.dart`
+
+**Structure:**
+```
+Scaffold
+  AppBar
+    title: 'Knowledge'
+    actions: [search icon → expand TextField]
+  Column
+    TabBar (All | Notes | People | Places | Lists | Tasks)
+      — tab labels show counts: "Notes (12)"
+    AnimatedContainer (tag filter chip row, hidden when empty)
+      — horizontal SingleChildScrollView of FilterChip widgets
+    Expanded
+      ListView.builder
+        — items from knowledgeState.orderedItems
+        — trailing: loading indicator when isLoadingBatch
+  FAB (pen icon)
+    — Tasks tab → push TaskEditScreen
+    — all other tabs → showModalBottomSheet (type picker)
+```
+
+**Pull-to-refresh:** `RefreshIndicator` wrapping the `ListView`.
+
+**Empty state:** Centered column with type-appropriate icon and "No [type] yet" text.
+
+**Error state:** Centered text with retry button calling `ref.invalidate(knowledgeProvider)`.
+
+### `lib/widgets/knowledge_item_card.dart`
+
+`ListTile`-based card. Leading icon varies by type:
+- note → `Icons.description_outlined`
+- person → `Icons.person_outlined`
+- place → `Icons.place_outlined`
+- list → `Icons.checklist_outlined`
+- task → `Icons.task_alt_outlined` (with status colour on leading)
+
+Subtitle shows truncated body (max 2 lines) or due date for tasks.
+Trailing shows tag chips (up to 2, then "+N more").
+
+Tap → `NoteDetailScreen(noteId: item.id)` for knowledge types; `TaskEditScreen(taskId: item.id)` for tasks.
+
+---
+
+## Section 6: Type Picker Bottom Sheet
+
+Shown when FAB is tapped on any non-Tasks tab.
+
+```dart
+showModalBottomSheet(
+  context: context,
+  builder: (_) => Column(
+    mainAxisSize: MainAxisSize.min,
+    children: [
+      _TypeRow(Icons.description_outlined, 'Note', 'General note or document', 'note'),
+      _TypeRow(Icons.person_outlined, 'Person', 'Contact, colleague, or reference person', 'person'),
+      _TypeRow(Icons.place_outlined, 'Place', 'Location, venue, or place of interest', 'place'),
+      _TypeRow(Icons.checklist_outlined, 'List', 'Checklist or structured list', 'list'),
+    ],
+  ),
+);
+```
+
+Each `_TypeRow` on tap:
+1. `Navigator.pop(context)`
+2. `context.push(Routes.noteNew, extra: {'noteType': selectedType})`
+
+### `lib/screens/notes/note_edit_screen.dart` changes
+- Accept `noteType` from `GoRouterState.extra` or route parameter (default `'note'`)
+- Display a read-only type badge chip in the app bar subtitle
+- Pass `noteType` to `notes_api.createNote` / `notes_api.updateNote`
+
+---
+
+## Section 7: Projects Screen
+
+### `lib/screens/projects/projects_screen.dart`
+
+```
+Scaffold
+  AppBar: 'Projects'
+  RefreshIndicator
+    ListView.builder
+      — projects from projectsProvider (sorted updated_at desc via API param)
+      — each item: _ProjectCard
+  FAB → push ProjectEditScreen()
+```
+
+`_ProjectCard` (inline widget):
+- Title + status badge (`active` = green, `completed` = blue, `archived` = grey)
+- Description (1 line, truncated)
+- Goal text if present (italic, muted)
+- Milestone progress: `"3 / 5 milestones done"` using milestone count from project data if available, otherwise omitted
+
+Tap → `context.push('/projects/${project.id}/tasks')` — `ProjectTasksScreen` reads `projectId` from the path parameter, unchanged except for the added edit button.
+
+### `lib/screens/projects/project_edit_screen.dart`
+
+Fields: Title (required), Description, Goal, Status dropdown (`active` / `completed` / `archived`).
+Used for both create (no `projectId`) and edit (with `projectId`).
+On save: POST `/api/projects` or PATCH `/api/projects/:id` via `projectsApi`.
+On success: `ref.invalidate(projectsProvider)` then `Navigator.pop`.
+
+### `lib/screens/library/project_tasks_screen.dart` change
+Add an edit `IconButton` in the `AppBar.actions`:
+```dart
+IconButton(
+  icon: const Icon(Icons.edit_outlined),
+  onPressed: () => context.push('/projects/$projectId/edit'),
+)
+```
+
+---
+
+## Section 8: Provider & API Wiring
+
+New providers to add to `lib/providers/`:
+
+```dart
+// knowledge_api_provider.dart (or in api_client_provider.dart)
+final knowledgeApiProvider = Provider((ref) =>
+    KnowledgeApi(ref.watch(dioProvider)));
+
+final knowledgeRepositoryProvider = Provider((ref) =>
+    KnowledgeRepository(ref.watch(knowledgeApiProvider)));
+```
+
+`projectsProvider` — add query parameters to the underlying `getProjects` call:
+```dart
+await api.getProjects(sort: 'updated_at', order: 'desc');
+```
+
+---
+
+## What This Does NOT Include
+
+- Voice I/O (separate spec)
+- Backend parity pass (separate spec)
+- Editing knowledge item type after creation
+- Bulk delete / multi-select in Knowledge screen
+- Knowledge graph view
+- Milestone detail screen (projects show milestone count only)

docs/superpowers/specs/2026-04-05-android-voice-io-design.md

@@ -0,0 +1,180 @@
+# Android Voice I/O Design
+
+## Goal
+
+Add voice input (STT) and output (TTS) to the Android app. All audio processing runs server-side via existing backend endpoints — no on-device STT or TTS APIs. Voice input is available in three locations: the Chat screen, the Quick Capture bar, and the Briefing follow-up bar. TTS auto-plays when voice mode is active.
+
+---
+
+## Architecture
+
+### New files
+
+| File | Responsibility |
+|---|---|
+| `lib/data/api/voice_api.dart` | Dio wrapper: `checkStatus()`, `transcribe(Uint8List)`, `synthesise(String)` |
+| `lib/data/repositories/voice_repository.dart` | Thin wrapper around `VoiceApi` |
+| `lib/providers/voice_provider.dart` | `VoiceState` + `VoiceNotifier extends Notifier<VoiceState>` — owns full recording/TTS lifecycle |
+| `lib/widgets/voice_mic_button.dart` | Shared mic button widget used by all three screens; animates across all states |
+
+### Modified files
+
+| File | Change |
+|---|---|
+| `pubspec.yaml` | Add `record: ^6.x`, `just_audio: ^0.9.x` |
+| `android/app/src/main/AndroidManifest.xml` | Add `RECORD_AUDIO` permission |
+| `lib/providers/api_client_provider.dart` | Add `voiceApiProvider`, `voiceRepositoryProvider` |
+| `lib/screens/chat/chat_screen.dart` | Add `VoiceMicButton` to input bar; wire streaming TTS watcher |
+| `lib/app.dart` (`_QuickCaptureBar`) | Add `VoiceMicButton` next to capture send button |
+| `lib/screens/briefing/briefing_screen.dart` | Add `VoiceMicButton` to follow-up input row; wire streaming TTS watcher |
+
+### Packages
+
+- **`record` ^6.x** — records audio on Android, outputs WebM/Opus (matches what the backend Whisper STT expects)
+- **`just_audio` ^0.9.x** — queue-based audio player; plays WAV bytes returned by `/api/voice/synthesise`
+
+---
+
+## State model
+
+```dart
+enum VoiceMode { idle, recording, transcribing, playing }
+
+class VoiceState {
+  final VoiceMode mode;
+  final bool voiceModeActive;  // whether the voice loop is running
+  final bool available;        // from /api/voice/status check
+}
+```
+
+`VoiceNotifier` is a `Notifier<VoiceState>` (Riverpod 3). It owns the `AudioRecorder` and `AudioPlayer` instances.
+
+---
+
+## Backend endpoints (no changes needed)
+
+All existing, no backend work required:
+
+- `GET /api/voice/status` → `{enabled, stt, tts}` — checked before entering voice mode
+- `POST /api/voice/transcribe` — `multipart/form-data`, field `audio` (WebM/Opus bytes) → `{transcript, duration_ms}`
+- `POST /api/voice/synthesise` — `{"text": "..."}` → `audio/wav` bytes
+
+---
+
+## Data flow
+
+### Chat / Briefing — continuous voice loop
+
+1. User taps mic → `VoiceNotifier.enterVoiceMode()`
+2. Call `GET /api/voice/status`; if unavailable → show snackbar, abort
+3. Request `RECORD_AUDIO` permission (via `permission_handler`); if denied → snackbar, abort
+4. Set `voiceModeActive = true`; input field disabled, send button dimmed, red banner shown
+5. Start recording via `record` package; poll amplitude every 200ms
+6. Silence detected (amplitude < −40 dB for 1500ms) → stop recording
+7. `POST /api/voice/transcribe` with WebM bytes → transcript
+8. If transcript is empty → restart listening from step 5 silently
+9. Call `sendMessage(transcript)` on `messagesProvider` (identical path to typed text)
+10. As the SSE response streams in, `VoiceNotifier` watches the streaming content:
+    - Buffer incoming text; extract completed sentences at `.`, `!`, `?` boundaries
+    - Strip markdown (code fences, headers, bold/italic markers) before synthesising
+    - For each sentence: `POST /api/voice/synthesise` → enqueue WAV blob in `just_audio` player
+11. After all audio plays → restart listening from step 5
+12. User taps mic again → `VoiceNotifier.exitVoiceMode()` → stop recording, cancel pending TTS, reset state
+
+### Quick Capture — one-shot, no TTS loop
+
+Steps 1–8 identical. Then instead of `sendMessage`, the transcript is passed to `captureWorkQueueProvider.enqueue(transcript)` — identical to typing in the capture bar. Mic returns to idle. No TTS playback, no loop.
+
+---
+
+## Silence detection
+
+The `record` package emits `onAmplitudeChanged` events. `VoiceNotifier` tracks consecutive below-threshold samples:
+
+- Threshold: −40 dB
+- Required duration: 1500ms of continuous silence
+- Minimum recording length: 300ms (ignore silence before user has spoken)
+
+---
+
+## Streaming TTS (mirrors web app)
+
+Matches the behaviour of `useStreamingTts` in the web frontend:
+
+1. Watch `messagesProvider` for streaming assistant content
+2. Accumulate new characters into a sentence buffer
+3. On each sentence boundary → strip markdown → `POST /api/voice/synthesise` → enqueue WAV
+4. `just_audio` plays queued WAVs sequentially
+5. On new message start → cancel in-flight synthesis, clear queue, stop playback
+6. On stream end → flush remaining buffer fragment if ≥ 3 characters
+
+Markdown stripping removes: code blocks (`` ``` ``), inline code, `#` headers, `**bold**`, `*italic*`, `[link](url)` → link text only, leading list markers.
+
+---
+
+## UX
+
+### VoiceMicButton states
+
+| State | Visual |
+|---|---|
+| Idle (voice mode off) | Plain mic icon, muted background |
+| Recording | Red filled circle, pulsing shadow ring |
+| Transcribing | Indigo filled circle, spinner overlay |
+| Playing TTS | Indigo filled circle, speaker wave icon |
+
+### Voice mode banner (Chat + Briefing only)
+
+A thin red banner appears above the input row while voice mode is active:
+> "🎤 Listening… tap mic to exit voice mode"
+
+Input field shows "Listening…" hint in italic. Send button dimmed but still tappable as an override.
+
+### Quick Capture bar
+
+No banner. The capture bar's background shifts to a subtle red tint while recording. Returns to normal after capture.
+
+---
+
+## Error handling
+
+| Scenario | Behaviour |
+|---|---|
+| Voice unavailable on server | Snackbar "Voice not available on this server", mic stays idle |
+| Mic permission denied | Snackbar "Microphone permission required", mic stays idle |
+| Empty transcript | Stay in voice mode, restart listening silently |
+| Transcription API error | Stay in voice mode, restart listening; log warning |
+| TTS synthesis failure for a sentence | Skip that sentence, continue playback queue |
+| Network error during voice loop | Exit voice mode, show snackbar "Voice error — check connection" |
+| User navigates away while in voice mode | `VoiceNotifier` disposes recording + playback cleanly |
+
+---
+
+## Permissions
+
+Add to `android/app/src/main/AndroidManifest.xml`:
+
+```xml
+<uses-permission android:name="android.permission.RECORD_AUDIO"/>
+```
+
+Runtime permission requested via `permission_handler` at first mic tap. If permanently denied, open app settings.
+
+---
+
+## Testing
+
+- **Unit — `VoiceNotifier`:** Mock `VoiceRepository`; verify state transitions: idle → recording → transcribing → idle (on empty transcript), idle → recording → transcribing → playing → recording (happy path)
+- **Unit — silence detection:** Feed synthetic amplitude stream; assert stop fires after 1500ms below threshold, not before
+- **Unit — streaming TTS sentence extraction:** Feed streaming content strings; assert correct sentences extracted, markdown stripped
+- **Widget — `VoiceMicButton`:** Verify correct icon/colour/animation for each `VoiceMode` value
+- **Integration — permission flow:** Mock `permission_handler`; assert denied path shows snackbar and stays idle
+
+---
+
+## Out of scope
+
+- Wake word / always-on listening
+- On-device STT or TTS
+- Voice settings UI in the Android app (voice and TTS settings managed via the web Settings page)
+- iOS support (Android only per project constraints)

lib/app.dart

@@ -2,29 +2,35 @@ import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
 
+import 'package:flutter_timezone/flutter_timezone.dart';
+
 import 'core/constants.dart';
 import 'core/exceptions.dart';
+import 'core/theme.dart';
 import 'providers/api_client_provider.dart';
 import 'providers/auth_provider.dart';
 import 'providers/capture_queue_provider.dart';
-import 'providers/milestones_provider.dart';
+import 'providers/capture_work_queue_provider.dart';
 import 'providers/notes_provider.dart';
-import 'providers/projects_provider.dart';
 import 'providers/settings_provider.dart';
 import 'providers/update_provider.dart';
 import 'providers/tasks_provider.dart';
 import 'screens/auth/login_screen.dart';
+import 'screens/briefing/briefing_screen.dart';
+import 'screens/knowledge/knowledge_screen.dart';
+import 'screens/library/project_tasks_screen.dart';
 import 'screens/chat/chat_screen.dart';
-import 'screens/chat/conversations_list_screen.dart';
+import 'screens/chat/conversations_tab_screen.dart';
 import 'screens/notes/note_detail_screen.dart';
+import 'screens/projects/project_edit_screen.dart';
+import 'screens/projects/projects_screen.dart';
 import 'screens/notes/note_edit_screen.dart';
-import 'screens/notes/notes_list_screen.dart';
-import 'screens/projects/project_list_screen.dart';
 import 'screens/settings/settings_screen.dart';
 import 'screens/setup/setup_screen.dart';
 import 'screens/splash/splash_screen.dart';
 import 'screens/tasks/task_edit_screen.dart';
-import 'screens/tasks/tasks_list_screen.dart';
+import 'providers/voice_provider.dart';
+import 'widgets/voice_mic_button.dart';
 
 // ChangeNotifier that fires when auth or server URL changes,
 // used as GoRouter.refreshListenable so the router re-evaluates redirects
@@ -80,7 +86,10 @@ final routerProvider = Provider<GoRouter>((ref) {
       ),
       GoRoute(
         path: Routes.noteNew,
-        builder: (_, _) => const NoteEditScreen(),
+        builder: (_, state) {
+          final extra = state.extra as Map<String, dynamic>?;
+          return NoteEditScreen(noteType: extra?['noteType'] as String?);
+        },
       ),
       GoRoute(
         path: Routes.noteDetail,
@@ -108,6 +117,22 @@ final routerProvider = Provider<GoRouter>((ref) {
           taskId: int.parse(state.pathParameters['id']!),
         ),
       ),
+      GoRoute(
+        path: Routes.projectTasks,
+        builder: (_, state) => ProjectTasksScreen(
+          projectId: int.parse(state.pathParameters['id']!),
+        ),
+      ),
+      GoRoute(
+        path: '/projects/new',
+        builder: (_, _) => const ProjectEditScreen(),
+      ),
+      GoRoute(
+        path: Routes.projectEdit,
+        builder: (_, state) => ProjectEditScreen(
+          projectId: int.parse(state.pathParameters['id']!),
+        ),
+      ),
       GoRoute(
         path: Routes.chat,
         builder: (_, state) => ChatScreen(
@@ -118,20 +143,20 @@ final routerProvider = Provider<GoRouter>((ref) {
         builder: (context, state, child) => _Shell(child: child),
         routes: [
           GoRoute(
-            path: Routes.notes,
-            builder: (_, _) => const NotesListScreen(),
+            path: Routes.briefing,
+            builder: (_, _) => const BriefingScreen(),
           ),
           GoRoute(
-            path: Routes.tasks,
-            builder: (_, _) => const TasksListScreen(),
-          ),
-          GoRoute(
-            path: Routes.projects,
-            builder: (_, _) => const ProjectListScreen(),
+            path: Routes.knowledge,
+            builder: (_, _) => const KnowledgeScreen(),
           ),
           GoRoute(
             path: Routes.conversations,
-            builder: (_, _) => const ConversationsListScreen(),
+            builder: (_, _) => const ConversationsTabScreen(),
+          ),
+          GoRoute(
+            path: Routes.projects,
+            builder: (_, _) => const ProjectsScreen(),
           ),
         ],
       ),
@@ -148,20 +173,39 @@ class _Shell extends ConsumerStatefulWidget {
 }
 
 class _ShellState extends ConsumerState<_Shell> {
-  static const _tabs = [Routes.notes, Routes.tasks, Routes.projects, Routes.conversations];
+  static const _tabs = [
+    Routes.briefing,
+    Routes.knowledge,
+    Routes.conversations,
+    Routes.projects,
+  ];
 
   @override
   void initState() {
     super.initState();
-    // Silent update check on first app load.
     WidgetsBinding.instance.addPostFrameCallback((_) {
+      // Silent update check — only if we haven't already checked this session.
       final repoUrl = ref.read(forgejoRepoUrlProvider);
       if (repoUrl != null && repoUrl.isNotEmpty) {
-        ref.read(updateProvider.notifier).check(repoUrl);
+        final status = ref.read(updateProvider).status;
+        if (status == UpdateStatus.idle || status == UpdateStatus.error) {
+          ref.read(updateProvider.notifier).check(repoUrl);
+        }
       }
+      // Sync device timezone to backend so briefing and chat use local time.
+      _syncTimezone();
     });
   }
 
+  Future<void> _syncTimezone() async {
+    try {
+      final tzInfo = await FlutterTimezone.getLocalTimezone();
+      await ref.read(settingsApiProvider).syncTimezone(tzInfo.identifier);
+    } catch (_) {
+      // Best-effort — failure is non-critical.
+    }
+  }
+
   int _tabIndex(String location) {
     for (var i = 0; i < _tabs.length; i++) {
       if (location.startsWith(_tabs[i])) return i;
@@ -182,7 +226,7 @@ class _ShellState extends ConsumerState<_Shell> {
               mainAxisSize: MainAxisSize.min,
               crossAxisAlignment: CrossAxisAlignment.start,
               children: [
-                Text('Version ${state.latestVersion} is ready to install.'),
+                Text('Version ${state.latestVersion ?? '?'} is ready to install.'),
                 if (state.currentVersion != null)
                   Text(
                     'Installed: v${state.currentVersion}',
@@ -202,6 +246,16 @@ class _ShellState extends ConsumerState<_Shell> {
                     style: Theme.of(context).textTheme.bodySmall,
                   ),
                 ],
+                if (state.status == UpdateStatus.error &&
+                    state.errorMessage != null) ...[
+                  const SizedBox(height: 12),
+                  Text(
+                    state.errorMessage!,
+                    style: Theme.of(context).textTheme.bodySmall?.copyWith(
+                          color: Theme.of(context).colorScheme.error,
+                        ),
+                  ),
+                ],
               ],
             ),
             actions: [
@@ -209,7 +263,7 @@ class _ShellState extends ConsumerState<_Shell> {
                 onPressed: () => Navigator.pop(dialogContext),
                 child: const Text('Later'),
               ),
-              if (!isDownloading)
+              if (!isDownloading && state.downloadUrl != null)
                 FilledButton(
                   onPressed: () => ref
                       .read(updateProvider.notifier)
@@ -236,8 +290,6 @@ class _ShellState extends ConsumerState<_Shell> {
     final location = GoRouterState.of(context).matchedLocation;
     final index = _tabIndex(location);
     final child = widget.child;
-    // Use NavigationRail whenever the screen is wide enough — covers both
-    // phone landscape and tablets in either orientation (600 dp breakpoint).
     final isWide = MediaQuery.of(context).size.width >= 600;
 
     if (isWide) {
@@ -255,25 +307,25 @@ class _ShellState extends ConsumerState<_Shell> {
                       labelType: NavigationRailLabelType.all,
                       destinations: const [
                         NavigationRailDestination(
-                          icon: Icon(Icons.note_outlined),
-                          selectedIcon: Icon(Icons.note),
-                          label: Text('Notes'),
+                          icon: Icon(Icons.wb_sunny_outlined),
+                          selectedIcon: Icon(Icons.wb_sunny),
+                          label: Text('Briefing'),
                         ),
                         NavigationRailDestination(
-                          icon: Icon(Icons.check_box_outlined),
-                          selectedIcon: Icon(Icons.check_box),
-                          label: Text('Tasks'),
-                        ),
-                        NavigationRailDestination(
-                          icon: Icon(Icons.folder_outlined),
-                          selectedIcon: Icon(Icons.folder),
-                          label: Text('Projects'),
+                          icon: Icon(Icons.menu_book_outlined),
+                          selectedIcon: Icon(Icons.menu_book),
+                          label: Text('Knowledge'),
                         ),
                         NavigationRailDestination(
                           icon: Icon(Icons.chat_bubble_outline),
                           selectedIcon: Icon(Icons.chat_bubble),
                           label: Text('Chat'),
                         ),
+                        NavigationRailDestination(
+                          icon: Icon(Icons.folder_outlined),
+                          selectedIcon: Icon(Icons.folder),
+                          label: Text('Projects'),
+                        ),
                       ],
                     ),
                     const VerticalDivider(width: 1),
@@ -291,18 +343,39 @@ class _ShellState extends ConsumerState<_Shell> {
       body: Column(
         children: [
           const _QuickCaptureBar(),
-          Expanded(child: child),
+          Expanded(
+            child: MediaQuery.removePadding(
+              context: context,
+              removeTop: true,
+              child: child,
+            ),
+          ),
         ],
       ),
       bottomNavigationBar: NavigationBar(
         selectedIndex: index,
         onDestinationSelected: (i) => context.go(_tabs[i]),
         destinations: const [
-          NavigationDestination(icon: Icon(Icons.note), label: 'Notes'),
-          NavigationDestination(icon: Icon(Icons.check_box), label: 'Tasks'),
-          NavigationDestination(icon: Icon(Icons.folder), label: 'Projects'),
           NavigationDestination(
-              icon: Icon(Icons.chat_bubble), label: 'Chat'),
+            icon: Icon(Icons.wb_sunny_outlined),
+            selectedIcon: Icon(Icons.wb_sunny),
+            label: 'Briefing',
+          ),
+          NavigationDestination(
+            icon: Icon(Icons.menu_book_outlined),
+            selectedIcon: Icon(Icons.menu_book),
+            label: 'Knowledge',
+          ),
+          NavigationDestination(
+            icon: Icon(Icons.chat_bubble_outline),
+            selectedIcon: Icon(Icons.chat_bubble),
+            label: 'Chat',
+          ),
+          NavigationDestination(
+            icon: Icon(Icons.folder_outlined),
+            selectedIcon: Icon(Icons.folder),
+            label: 'Projects',
+          ),
         ],
       ),
     );
@@ -318,78 +391,29 @@ class _QuickCaptureBar extends ConsumerStatefulWidget {
 
 class _QuickCaptureBarState extends ConsumerState<_QuickCaptureBar> {
   final _controller = TextEditingController();
-  bool _busy = false;
 
   @override
   void initState() {
     super.initState();
-    // Retry any offline-queued captures from previous sessions.
-    WidgetsBinding.instance.addPostFrameCallback((_) => _drainQueue());
+    WidgetsBinding.instance.addPostFrameCallback((_) => _drainOfflineQueue());
   }
 
   @override
   void dispose() {
     _controller.dispose();
+    ref.read(voiceProvider.notifier).exitVoiceMode();
     super.dispose();
   }
 
-  Future<void> _submit() async {
+  void _submit() {
     final text = _controller.text.trim();
-    if (text.isEmpty || _busy) return;
-
+    if (text.isEmpty) return;
     _controller.clear();
-    setState(() => _busy = true);
-
-    // Capture the messenger before the async gap so we can show a snackbar
-    // even if the user has navigated to a deeper view by the time it resolves.
-    final messenger = ScaffoldMessenger.of(context);
-
-    try {
-      final result = await ref.read(quickCaptureApiProvider).capture(text);
-
-      switch (result.type) {
-        case 'note':
-          ref.invalidate(notesProvider);
-        case 'task':
-        case 'todo':
-          ref.invalidate(tasksProvider);
-          ref.invalidate(projectsProvider);
-          ref.invalidate(projectMilestonesProvider);
-      }
-
-      final msg = result.message.isNotEmpty
-          ? result.message
-          : '${_typeLabel(result.type)} created: ${result.title}';
-      messenger.showSnackBar(
-        SnackBar(content: Text(msg), behavior: SnackBarBehavior.floating),
-      );
-      _drainQueue(); // Silently flush any offline-queued captures.
-    } on NetworkException {
-      await ref.read(captureQueueProvider.notifier).enqueue(text);
-      messenger.showSnackBar(
-        const SnackBar(
-          content: Text(
-              "You're offline — capture saved and will retry automatically."),
-          behavior: SnackBarBehavior.floating,
-        ),
-      );
-    } on AppException catch (e) {
-      messenger.showSnackBar(
-        SnackBar(content: Text(e.message), behavior: SnackBarBehavior.floating),
-      );
-    } catch (_) {
-      messenger.showSnackBar(
-        const SnackBar(
-          content: Text('Capture failed. Please try again.'),
-          behavior: SnackBarBehavior.floating,
-        ),
-      );
-    } finally {
-      if (mounted) setState(() => _busy = false);
-    }
+    setState(() {}); // clear suffix icon
+    ref.read(captureWorkQueueProvider.notifier).enqueue(text);
   }
 
-  Future<void> _drainQueue() async {
+  Future<void> _drainOfflineQueue() async {
     if (!mounted) return;
     final queue = ref.read(captureQueueProvider);
     if (queue.isEmpty) return;
@@ -398,36 +422,49 @@ class _QuickCaptureBarState extends ConsumerState<_QuickCaptureBar> {
       if (!mounted) break;
       try {
         final result = await api.capture(text);
-        if (!mounted) break;
+        // Dequeue before the mounted check — SharedPreferences doesn't need
+        // the widget alive, and skipping this would leave a ghost item.
         await ref.read(captureQueueProvider.notifier).dequeue(text);
+        if (!mounted) break;
         switch (result.type) {
           case 'note':
             ref.invalidate(notesProvider);
           case 'task':
           case 'todo':
             ref.invalidate(tasksProvider);
-            ref.invalidate(projectsProvider);
-            ref.invalidate(projectMilestonesProvider);
         }
       } on NetworkException {
-        break; // Still offline — stop draining.
+        break;
       } catch (_) {
-        // Server/parse error — remove to avoid infinite retries.
-        if (mounted) await ref.read(captureQueueProvider.notifier).dequeue(text);
+        // Server error or unexpected failure — drop from queue to prevent
+        // ghost items that can never be cleared.
+        await ref.read(captureQueueProvider.notifier).dequeue(text);
       }
     }
   }
 
-  String _typeLabel(String type) => switch (type) {
-        'note' => 'Note',
-        'task' => 'Task',
-        'event' => 'Event',
-        'todo' => 'To-do',
-        _ => type,
-      };
+  Future<void> _toggleCaptureMic() async {
+    final voice = ref.read(voiceProvider);
+    if (voice.voiceModeActive) {
+      ref.read(voiceProvider.notifier).exitVoiceMode();
+      return;
+    }
+    await ref.read(voiceProvider.notifier).enterVoiceMode(
+      onTranscript: (transcript) async {
+        ref.read(captureWorkQueueProvider.notifier).enqueue(transcript);
+      },
+      enableTts: false,
+      onError: (msg) {
+        if (!mounted) return;
+        ScaffoldMessenger.of(context)
+            .showSnackBar(SnackBar(content: Text(msg)));
+      },
+    );
+  }
 
   String _hintForLocation(String location) {
-    if (location.startsWith(Routes.tasks)) return 'Add a task…';
+    if (location.startsWith(Routes.knowledge)) return 'Capture a note…';
+    if (location.startsWith(Routes.projects)) return 'Capture a note…';
     if (location.startsWith(Routes.conversations)) return 'Ask Fabled…';
     return 'Capture a note…';
   }
@@ -435,61 +472,89 @@ class _QuickCaptureBarState extends ConsumerState<_QuickCaptureBar> {
   @override
   Widget build(BuildContext context) {
     final location = GoRouterState.of(context).matchedLocation;
-    final queueCount = ref.watch(captureQueueProvider).length;
+    final offlineQueueCount = ref.watch(captureQueueProvider).length;
+    final workQueue = ref.watch(captureWorkQueueProvider);
+    final isWorking = workQueue.isNotEmpty;
+    final totalPending = workQueue.length + offlineQueueCount;
+
+    // Show snackbar when a result is published.
+    ref.listen(captureResultProvider, (_, result) {
+      if (result == null || !mounted) return;
+      ScaffoldMessenger.of(context).showSnackBar(
+        SnackBar(
+          content: Text(result.message),
+          behavior: SnackBarBehavior.floating,
+        ),
+      );
+    });
+
     return SafeArea(
       bottom: false,
-      child: Padding(
-        padding: const EdgeInsets.fromLTRB(12, 8, 4, 4),
-        child: Row(
-          children: [
-            Expanded(
-              child: TextField(
-                controller: _controller,
-                enabled: !_busy,
-                textInputAction: TextInputAction.send,
-                onSubmitted: (_) => _submit(),
-                onChanged: (_) => setState(() {}),
-                decoration: InputDecoration(
-                  hintText: _hintForLocation(location),
-                  isDense: true,
-                  contentPadding:
-                      const EdgeInsets.symmetric(horizontal: 14, vertical: 10),
-                  border: OutlineInputBorder(
-                    borderRadius: BorderRadius.circular(24),
-                  ),
-                  prefixIcon: _busy
-                      ? const Padding(
-                          padding: EdgeInsets.all(12),
-                          child: SizedBox(
-                            width: 16,
-                            height: 16,
-                            child: CircularProgressIndicator(strokeWidth: 2),
-                          ),
-                        )
-                      : queueCount > 0
+      child: Column(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          Padding(
+            padding: const EdgeInsets.fromLTRB(12, 8, 4, 4),
+            child: Row(
+              children: [
+                Expanded(
+                  child: TextField(
+                    controller: _controller,
+                    textInputAction: TextInputAction.send,
+                    onSubmitted: (_) => _submit(),
+                    onChanged: (_) => setState(() {}),
+                    decoration: InputDecoration(
+                      hintText: ref.watch(voiceProvider).voiceModeActive
+                          ? 'Listening…'
+                          : _hintForLocation(location),
+                      isDense: true,
+                      contentPadding: const EdgeInsets.symmetric(
+                          horizontal: 14, vertical: 10),
+                      prefixIcon: totalPending > 0
                           ? Badge(
-                              label: Text('$queueCount'),
-                              child:
-                                  const Icon(Icons.cloud_upload_outlined),
+                              label: Text('$totalPending'),
+                              child: const Icon(Icons.cloud_upload_outlined),
                             )
-                          : const Icon(Icons.auto_awesome_outlined),
-                  suffixIcon: _controller.text.trim().isNotEmpty && !_busy
-                      ? IconButton(
-                          icon: const Icon(Icons.send),
-                          onPressed: _submit,
-                          tooltip: 'Capture',
-                        )
-                      : null,
+                          : isWorking
+                              ? const Padding(
+                                  padding: EdgeInsets.all(12),
+                                  child: SizedBox(
+                                    width: 16,
+                                    height: 16,
+                                    child: CircularProgressIndicator(
+                                        strokeWidth: 2),
+                                  ),
+                                )
+                              : const Icon(Icons.auto_awesome_outlined),
+                      suffixIcon: _controller.text.trim().isNotEmpty
+                          ? IconButton(
+                              icon: const Icon(Icons.send),
+                              onPressed: _submit,
+                              tooltip: 'Capture',
+                            )
+                          : null,
+                    ),
+                  ),
                 ),
-              ),
+                VoiceMicButton(
+                  mode: ref.watch(voiceProvider).mode,
+                  voiceModeActive: ref.watch(voiceProvider).voiceModeActive,
+                  onTap: _toggleCaptureMic,
+                ),
+                IconButton(
+                  icon: const Icon(Icons.settings_outlined),
+                  tooltip: 'Settings',
+                  onPressed: () => context.push(Routes.settings),
+                ),
+              ],
             ),
-            IconButton(
-              icon: const Icon(Icons.settings_outlined),
-              tooltip: 'Settings',
-              onPressed: () => context.push(Routes.settings),
-            ),
-          ],
-        ),
+          ),
+          // Thin progress bar while the work queue is draining.
+          if (isWorking)
+            const LinearProgressIndicator(minHeight: 2)
+          else
+            const SizedBox(height: 2),
+        ],
       ),
     );
   }
@@ -506,17 +571,8 @@ class FabledApp extends ConsumerWidget {
     return MaterialApp.router(
       title: 'Fabled',
       themeMode: themeMode,
-      theme: ThemeData(
-        colorScheme: ColorScheme.fromSeed(seedColor: Colors.indigo),
-        useMaterial3: true,
-      ),
-      darkTheme: ThemeData(
-        colorScheme: ColorScheme.fromSeed(
-          seedColor: Colors.indigo,
-          brightness: Brightness.dark,
-        ),
-        useMaterial3: true,
-      ),
+      theme: fabledLightTheme(),
+      darkTheme: fabledDarkTheme(),
       routerConfig: router,
     );
   }

lib/core/constants.dart

@@ -9,9 +9,13 @@ abstract class Routes {
   static const tasks = '/tasks';
   static const taskNew = '/tasks/new';
   static const taskEdit = '/tasks/:id/edit';
+  static const knowledge = '/knowledge';
   static const projects = '/projects';
+  static const projectEdit = '/projects/:id/edit';
   static const conversations = '/chat';
   static const chat = '/chat/:id';
   static const quickCapture = '/quick-capture';
   static const settings = '/settings';
+  static const briefing = '/briefing';
+  static const projectTasks = '/projects/:id/tasks';
 }

lib/core/theme.dart

@@ -0,0 +1,246 @@
+import 'package:flutter/material.dart';
+import 'package:google_fonts/google_fonts.dart';
+
+// ── Colour constants ──────────────────────────────────────────────────────────
+
+const _darkBackground    = Color(0xFF111113);
+const _darkSurface       = Color(0xFF18181C);
+const _darkSurfaceVar    = Color(0xFF1E1E24);
+const _darkPrimary       = Color(0xFF6366F1);
+const _darkOnSurface     = Color(0xFFE8E8F0);
+const _darkOnSurfaceVar  = Color(0xFF8888A8);
+const _darkOutline       = Color(0xFF2E2E3A);
+
+const _lightBackground   = Color(0xFFF4F4F8);
+const _lightSurface      = Color(0xFFFFFFFF);
+const _lightSurfaceVar   = Color(0xFFF0F0F5);
+const _lightPrimary      = Color(0xFF4F46E5);
+const _lightOnSurface    = Color(0xFF18181C);
+const _lightOnSurfaceVar = Color(0xFF6B6B88);
+const _lightOutline      = Color(0xFFD4D4E4);
+
+// ── Typography ─────────────────────────────────────────────────────────────────
+
+TextTheme _buildTextTheme(TextTheme base) {
+  final fraunces = GoogleFonts.frauncesTextTheme(base);
+  return base.copyWith(
+    // Headings / titles use Fraunces
+    headlineLarge:  fraunces.headlineLarge,
+    headlineMedium: fraunces.headlineMedium,
+    headlineSmall:  fraunces.headlineSmall,
+    titleLarge:     fraunces.titleLarge,
+    titleMedium:    fraunces.titleMedium,
+    // Body / labels remain system default
+  );
+}
+
+// ── Themes ─────────────────────────────────────────────────────────────────────
+
+ThemeData fabledDarkTheme() {
+  final cs = ColorScheme(
+    brightness:          Brightness.dark,
+    primary:             _darkPrimary,
+    onPrimary:           Colors.white,
+    primaryContainer:    const Color(0xFF3730A3),
+    onPrimaryContainer:  _darkOnSurface,
+    secondary:           _darkPrimary,
+    onSecondary:         Colors.white,
+    secondaryContainer:  _darkSurfaceVar,
+    onSecondaryContainer: _darkOnSurface,
+    tertiary:            _darkPrimary,
+    onTertiary:          Colors.white,
+    tertiaryContainer:   _darkSurfaceVar,
+    onTertiaryContainer: _darkOnSurface,
+    error:               const Color(0xFFEF4444),
+    onError:             Colors.white,
+    errorContainer:      const Color(0xFF7F1D1D),
+    onErrorContainer:    const Color(0xFFFEE2E2),
+    surface:             _darkSurface,
+    onSurface:           _darkOnSurface,
+    surfaceContainerHighest: _darkSurfaceVar,
+    onSurfaceVariant:    _darkOnSurfaceVar,
+    outline:             _darkOutline,
+    outlineVariant:      _darkOutline,
+    shadow:              Colors.black,
+    scrim:               Colors.black,
+    inverseSurface:      _darkOnSurface,
+    onInverseSurface:    _darkSurface,
+    inversePrimary:      _lightPrimary,
+  );
+
+  return ThemeData(
+    useMaterial3:   true,
+    colorScheme:    cs,
+    scaffoldBackgroundColor: _darkBackground,
+    textTheme: _buildTextTheme(ThemeData.dark().textTheme),
+    cardTheme: CardThemeData(
+      color:         _darkSurface,
+      elevation:     2,
+      shadowColor:   Colors.black.withValues(alpha: 0.4),
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(14)),
+    ),
+    navigationBarTheme: NavigationBarThemeData(
+      backgroundColor: _darkSurface,
+      indicatorColor:  _darkPrimary.withValues(alpha: 0.2),
+    ),
+    navigationRailTheme: NavigationRailThemeData(
+      backgroundColor: _darkSurface,
+      indicatorColor:  _darkPrimary.withValues(alpha: 0.2),
+    ),
+    inputDecorationTheme: InputDecorationTheme(
+      filled:      true,
+      fillColor:   _darkSurfaceVar,
+      border: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _darkOutline),
+      ),
+      enabledBorder: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _darkOutline),
+      ),
+      focusedBorder: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _darkPrimary, width: 2),
+      ),
+    ),
+    dividerTheme: DividerThemeData(color: _darkOutline, thickness: 1),
+    chipTheme: ChipThemeData(
+      backgroundColor: _darkSurfaceVar,
+      labelStyle: TextStyle(color: _darkOnSurfaceVar, fontSize: 12),
+      side: BorderSide(color: _darkOutline),
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(8)),
+    ),
+  );
+}
+
+ThemeData fabledLightTheme() {
+  final cs = ColorScheme(
+    brightness:          Brightness.light,
+    primary:             _lightPrimary,
+    onPrimary:           Colors.white,
+    primaryContainer:    const Color(0xFFE0E0FF),
+    onPrimaryContainer:  _lightOnSurface,
+    secondary:           _lightPrimary,
+    onSecondary:         Colors.white,
+    secondaryContainer:  _lightSurfaceVar,
+    onSecondaryContainer: _lightOnSurface,
+    tertiary:            _lightPrimary,
+    onTertiary:          Colors.white,
+    tertiaryContainer:   _lightSurfaceVar,
+    onTertiaryContainer: _lightOnSurface,
+    error:               const Color(0xFFDC2626),
+    onError:             Colors.white,
+    errorContainer:      const Color(0xFFFEE2E2),
+    onErrorContainer:    const Color(0xFF7F1D1D),
+    surface:             _lightSurface,
+    onSurface:           _lightOnSurface,
+    surfaceContainerHighest: _lightSurfaceVar,
+    onSurfaceVariant:    _lightOnSurfaceVar,
+    outline:             _lightOutline,
+    outlineVariant:      _lightOutline,
+    shadow:              Colors.black,
+    scrim:               Colors.black,
+    inverseSurface:      _lightOnSurface,
+    onInverseSurface:    _lightSurface,
+    inversePrimary:      _darkPrimary,
+  );
+
+  return ThemeData(
+    useMaterial3:   true,
+    colorScheme:    cs,
+    scaffoldBackgroundColor: _lightBackground,
+    textTheme: _buildTextTheme(ThemeData.light().textTheme),
+    cardTheme: CardThemeData(
+      color:         _lightSurface,
+      elevation:     1,
+      shadowColor:   Colors.black.withValues(alpha: 0.08),
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(14)),
+    ),
+    navigationBarTheme: NavigationBarThemeData(
+      backgroundColor: _lightSurface,
+      indicatorColor:  _lightPrimary.withValues(alpha: 0.12),
+    ),
+    navigationRailTheme: NavigationRailThemeData(
+      backgroundColor: _lightSurface,
+      indicatorColor:  _lightPrimary.withValues(alpha: 0.12),
+    ),
+    inputDecorationTheme: InputDecorationTheme(
+      filled:      true,
+      fillColor:   _lightSurfaceVar,
+      border: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _lightOutline),
+      ),
+      enabledBorder: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _lightOutline),
+      ),
+      focusedBorder: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(24),
+        borderSide: BorderSide(color: _lightPrimary, width: 2),
+      ),
+    ),
+    dividerTheme: DividerThemeData(color: _lightOutline, thickness: 1),
+    chipTheme: ChipThemeData(
+      backgroundColor: _lightSurfaceVar,
+      labelStyle: TextStyle(color: _lightOnSurfaceVar, fontSize: 12),
+      side: BorderSide(color: _lightOutline),
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(8)),
+    ),
+  );
+}
+
+// ── GradientButton ─────────────────────────────────────────────────────────────
+// Use wherever the web app uses the indigo gradient button (send, primary actions).
+
+class GradientButton extends StatelessWidget {
+  final VoidCallback? onPressed;
+  final Widget child;
+  final EdgeInsetsGeometry padding;
+
+  const GradientButton({
+    super.key,
+    required this.onPressed,
+    required this.child,
+    this.padding = const EdgeInsets.symmetric(horizontal: 20, vertical: 12),
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final disabled = onPressed == null;
+    return AnimatedOpacity(
+      opacity: disabled ? 0.45 : 1.0,
+      duration: const Duration(milliseconds: 150),
+      child: DecoratedBox(
+        decoration: BoxDecoration(
+          gradient: disabled
+              ? null
+              : const LinearGradient(
+                  begin: Alignment.topLeft,
+                  end: Alignment.bottomRight,
+                  colors: [Color(0xFF6366F1), Color(0xFF4F46E5)],
+                ),
+          color: disabled ? const Color(0xFF6366F1) : null,
+          borderRadius: BorderRadius.circular(12),
+          boxShadow: disabled
+              ? null
+              : [
+                  BoxShadow(
+                    color: const Color(0xFF6366F1).withValues(alpha: 0.35),
+                    blurRadius: 8,
+                    offset: const Offset(0, 3),
+                  ),
+                ],
+        ),
+        child: Material(
+          color: Colors.transparent,
+          child: InkWell(
+            onTap: onPressed,
+            borderRadius: BorderRadius.circular(12),
+            child: Padding(padding: padding, child: child),
+          ),
+        ),
+      ),
+    );
+  }
+}

lib/data/api/api_client.dart

@@ -44,6 +44,16 @@ class _ErrorInterceptor extends Interceptor {
       ));
       return;
     }
+    if (err.type == DioExceptionType.receiveTimeout ||
+        err.type == DioExceptionType.sendTimeout) {
+      handler.reject(DioException(
+        requestOptions: err.requestOptions,
+        error: const AppException('Request timed out. The server is taking too long to respond.'),
+        type: err.type,
+        response: err.response,
+      ));
+      return;
+    }
     handler.next(err);
   }
 }

lib/data/api/briefing_api.dart

@@ -0,0 +1,81 @@
+import 'package:dio/dio.dart';
+
+import '../models/briefing_conversation.dart';
+import '../models/message.dart';
+import 'api_client.dart';
+
+class BriefingApi {
+  final Dio _dio;
+  const BriefingApi(this._dio);
+
+  /// GET /api/briefing/conversations/today
+  /// Returns (or creates) today's briefing conversation with messages embedded.
+  Future<BriefingConversation> getToday() async {
+    try {
+      final response = await _dio.get('/api/briefing/conversations/today');
+      return BriefingConversation.fromJson(
+          response.data as Map<String, dynamic>);
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+
+  /// GET /api/briefing/conversations
+  /// Returns list of past briefing conversations (no messages embedded).
+  Future<List<BriefingConversation>> getHistory() async {
+    try {
+      final response = await _dio.get('/api/briefing/conversations');
+      final data = response.data as Map<String, dynamic>;
+      final list = data['conversations'] as List<dynamic>;
+      return list
+          .map((e) => BriefingConversation.fromJson(e as Map<String, dynamic>))
+          .toList();
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+
+  /// GET /api/briefing/conversations/`<id>`/messages
+  Future<List<Message>> getMessages(int convId) async {
+    try {
+      final response =
+          await _dio.get('/api/briefing/conversations/$convId/messages');
+      final data = response.data as Map<String, dynamic>;
+      final list = data['messages'] as List<dynamic>;
+      return list
+          .map((e) => Message.fromJson(e as Map<String, dynamic>))
+          .toList();
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+
+  /// POST /api/briefing/trigger  body: {"slot": slot}
+  /// slot: "compilation" | "morning" | "midday" | "afternoon"
+  Future<void> triggerSlot(String slot) async {
+    try {
+      await _dio.post('/api/briefing/trigger', data: {'slot': slot});
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+
+  /// POST /api/briefing/rss-reactions  body: {rss_item_id, reaction: "up"|"down"}
+  Future<void> postRssReaction(int rssItemId, String reaction) async {
+    try {
+      await _dio.post('/api/briefing/rss-reactions',
+          data: {'rss_item_id': rssItemId, 'reaction': reaction});
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+
+  /// DELETE /api/briefing/rss-reactions/{rssItemId}
+  Future<void> deleteRssReaction(int rssItemId) async {
+    try {
+      await _dio.delete('/api/briefing/rss-reactions/$rssItemId');
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+}

lib/data/api/knowledge_api.dart

@@ -0,0 +1,86 @@
+import 'package:dio/dio.dart';
+
+import '../models/knowledge_item.dart';
+import 'api_client.dart';
+
+class KnowledgeApi {
+  final Dio _dio;
+  const KnowledgeApi(this._dio);
+
+  /// Fetch a page of IDs. Returns (ids, total).
+  Future<(List<int>, int)> fetchIds({
+    String? noteType,
+    List<String> tags = const [],
+    String sort = 'modified',
+    String? q,
+    int limit = 50,
+    int offset = 0,
+  }) async {
+    try {
+      final params = <String, dynamic>{
+        'limit': limit,
+        'offset': offset,
+        'sort': sort,
+        if (noteType != null) 'type': noteType,
+        if (tags.isNotEmpty) 'tags': tags.join(','),
+        if (q != null && q.isNotEmpty) 'q': q,
+      };
+      final response =
+          await _dio.get('/api/knowledge/ids', queryParameters: params);
+      final data = response.data as Map<String, dynamic>;
+      final ids =
+          (data['ids'] as List<dynamic>).map((e) => e as int).toList();
+      final total = data['total'] as int;
+      return (ids, total);
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+
+  /// Batch-hydrate up to 100 IDs into full items.
+  Future<List<KnowledgeItem>> fetchBatch(List<int> ids) async {
+    if (ids.isEmpty) return [];
+    try {
+      final response = await _dio.get(
+        '/api/knowledge/batch',
+        queryParameters: {'ids': ids.join(',')},
+      );
+      final data = response.data as Map<String, dynamic>;
+      return (data['items'] as List<dynamic>)
+          .map((e) => KnowledgeItem.fromJson(e as Map<String, dynamic>))
+          .toList();
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+
+  /// Per-type counts for tab labels.
+  Future<Map<String, int>> fetchCounts({List<String> tags = const []}) async {
+    try {
+      final params = <String, dynamic>{
+        if (tags.isNotEmpty) 'tags': tags.join(','),
+      };
+      final response = await _dio.get('/api/knowledge/counts',
+          queryParameters: params);
+      return (response.data as Map<String, dynamic>)
+          .map((k, v) => MapEntry(k, (v as num).toInt()));
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+
+  /// All tags for the current type filter.
+  Future<List<String>> fetchTags({String? noteType}) async {
+    try {
+      final response = await _dio.get(
+        '/api/knowledge/tags',
+        queryParameters: {if (noteType != null) 'type': noteType},
+      );
+      return (response.data['tags'] as List<dynamic>)
+          .map((e) => e as String)
+          .toList();
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+}

lib/data/api/notes_api.dart

@@ -32,12 +32,14 @@ class NotesApi {
     String body, {
     List<String> tags = const [],
     int? projectId,
+    String noteType = 'note',
   }) async {
     try {
       final response = await _dio.post('/api/notes', data: {
         'title': title,
         'body': body,
         'tags': tags,
+        'note_type': noteType,
         if (projectId != null) 'project_id': projectId,
       });
       return Note.fromJson(response.data as Map<String, dynamic>);
@@ -53,12 +55,14 @@ class NotesApi {
     List<String> tags = const [],
     int? projectId,
     bool clearProject = false,
+    String noteType = 'note',
   }) async {
     try {
       final response = await _dio.put('/api/notes/$id', data: {
         'title': title,
         'body': body,
         'tags': tags,
+        'note_type': noteType,
         if (clearProject) 'project_id': null else if (projectId != null) 'project_id': projectId,
       });
       return Note.fromJson(response.data as Map<String, dynamic>);

lib/data/api/projects_api.dart

@@ -7,11 +7,19 @@ class ProjectsApi {
   final Dio _dio;
   const ProjectsApi(this._dio);
 
-  Future<List<Project>> getAll({String? status}) async {
+  Future<List<Project>> getAll({
+    String? status,
+    String sort = 'updated_at',
+    String order = 'desc',
+  }) async {
     try {
       final response = await _dio.get(
         '/api/projects',
-        queryParameters: status != null ? {'status': status} : null,
+        queryParameters: {
+          'sort': sort,
+          'order': order,
+          if (status != null) 'status': status,
+        },
       );
       final data = response.data as Map<String, dynamic>;
       final list = data['projects'] as List<dynamic>;
@@ -37,10 +45,12 @@ class ProjectsApi {
     String? description,
     String? goal,
     String? color,
+    String status = 'active',
   }) async {
     try {
       final response = await _dio.post('/api/projects', data: {
         'title': title,
+        'status': status,
         if (description != null && description.isNotEmpty)
           'description': description,
         if (goal != null && goal.isNotEmpty) 'goal': goal,

lib/data/api/quick_capture_api.dart

@@ -40,6 +40,7 @@ class QuickCaptureApi {
       final response = await _dio.post(
         '/api/quick-capture',
         data: {'text': text},
+        options: Options(receiveTimeout: const Duration(seconds: 120)),
       );
       return CaptureResult.fromJson(response.data as Map<String, dynamic>);
     } on DioException catch (e) {

lib/data/api/settings_api.dart

@@ -0,0 +1,13 @@
+import 'package:dio/dio.dart';
+
+class SettingsApi {
+  const SettingsApi(this._dio);
+  final Dio _dio;
+
+  Future<void> syncTimezone(String ianaTimezone) async {
+    await _dio.put<void>(
+      '/api/settings',
+      data: {'user_timezone': ianaTimezone},
+    );
+  }
+}

lib/data/api/tasks_api.dart

@@ -52,6 +52,24 @@ class TasksApi {
     }
   }
 
+  Future<List<Task>> getByProject(int projectId) async {
+    try {
+      final response = await _dio.get(
+        '/api/notes',
+        queryParameters: {
+          'project_id': projectId,
+          'is_task': 'true',
+          'limit': 500,
+        },
+      );
+      final data = response.data as Map<String, dynamic>;
+      final list = data['notes'] as List<dynamic>;
+      return list.map((e) => Task.fromJson(e as Map<String, dynamic>)).toList();
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+
   Future<List<Task>> getSubTasks(int parentId) async {
     try {
       final response = await _dio.get(

lib/data/api/voice_api.dart

@@ -0,0 +1,81 @@
+import 'dart:typed_data';
+
+import 'package:dio/dio.dart';
+
+import 'api_client.dart';
+
+class VoiceStatus {
+  final bool enabled;
+  final bool stt;
+  final bool tts;
+
+  const VoiceStatus({
+    required this.enabled,
+    required this.stt,
+    required this.tts,
+  });
+
+  /// True only when voice is enabled AND both STT and TTS are ready.
+  bool get fullyAvailable => enabled && stt && tts;
+
+  factory VoiceStatus.fromJson(Map<String, dynamic> json) => VoiceStatus(
+        enabled: json['enabled'] as bool? ?? false,
+        stt: json['stt'] as bool? ?? false,
+        tts: json['tts'] as bool? ?? false,
+      );
+}
+
+class VoiceApi {
+  final Dio _dio;
+  const VoiceApi(this._dio);
+
+  /// Check whether voice features are available on this server.
+  Future<VoiceStatus> checkStatus() async {
+    try {
+      final response = await _dio.get('/api/voice/status');
+      return VoiceStatus.fromJson(response.data as Map<String, dynamic>);
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+
+  /// POST WebM/Opus audio bytes and return the transcript string.
+  /// Returns empty string on empty or error response.
+  Future<String> transcribe(Uint8List audioBytes) async {
+    try {
+      final formData = FormData.fromMap({
+        'audio': MultipartFile.fromBytes(
+          audioBytes,
+          filename: 'audio.webm',
+          contentType: DioMediaType('audio', 'webm'),
+        ),
+      });
+      final response = await _dio.post(
+        '/api/voice/transcribe',
+        data: formData,
+        options: Options(
+          receiveTimeout: const Duration(seconds: 60),
+          contentType: 'multipart/form-data',
+        ),
+      );
+      final data = response.data as Map<String, dynamic>;
+      return (data['transcript'] as String? ?? '').trim();
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+
+  /// POST text and return raw WAV bytes.
+  Future<Uint8List> synthesise(String text) async {
+    try {
+      final response = await _dio.post(
+        '/api/voice/synthesise',
+        data: {'text': text},
+        options: Options(responseType: ResponseType.bytes),
+      );
+      return Uint8List.fromList(response.data as List<int>);
+    } on DioException catch (e) {
+      throw dioToApp(e);
+    }
+  }
+}

lib/data/models/briefing_conversation.dart

@@ -0,0 +1,35 @@
+import 'message.dart';
+
+class BriefingConversation {
+  final int id;
+  final String title;
+  final String? briefingDate; // YYYY-MM-DD or null
+  final List<Message> messages;
+
+  const BriefingConversation({
+    required this.id,
+    required this.title,
+    this.briefingDate,
+    required this.messages,
+  });
+
+  factory BriefingConversation.fromJson(Map<String, dynamic> json) {
+    final rawMessages = json['messages'] as List<dynamic>? ?? [];
+    return BriefingConversation(
+      id: json['id'] as int,
+      title: json['title'] as String? ?? '',
+      briefingDate: json['briefing_date'] as String?,
+      messages: rawMessages
+          .map((e) => Message.fromJson(e as Map<String, dynamic>))
+          .toList(),
+    );
+  }
+
+  BriefingConversation copyWith({List<Message>? messages}) =>
+      BriefingConversation(
+        id: id,
+        title: title,
+        briefingDate: briefingDate,
+        messages: messages ?? this.messages,
+      );
+}

lib/data/models/knowledge_item.dart

@@ -0,0 +1,51 @@
+class KnowledgeItem {
+  final int id;
+  final String noteType; // 'note' | 'person' | 'place' | 'list' | 'task'
+  final String title;
+  final String body;
+  final List<String> tags;
+  final int? projectId;
+  final int? milestoneId;
+  final int? parentId;
+  // Task-only fields (null for non-tasks)
+  final String? status;   // 'todo' | 'in_progress' | 'done' | 'cancelled'
+  final String? priority; // 'low' | 'normal' | 'high'
+  final String? dueDate;
+  final DateTime createdAt;
+  final DateTime updatedAt;
+
+  const KnowledgeItem({
+    required this.id,
+    required this.noteType,
+    required this.title,
+    required this.body,
+    required this.tags,
+    this.projectId,
+    this.milestoneId,
+    this.parentId,
+    this.status,
+    this.priority,
+    this.dueDate,
+    required this.createdAt,
+    required this.updatedAt,
+  });
+
+  factory KnowledgeItem.fromJson(Map<String, dynamic> json) => KnowledgeItem(
+        id: json['id'] as int,
+        noteType: json['note_type'] as String? ?? 'note',
+        title: json['title'] as String? ?? '',
+        body: json['body'] as String? ?? '',
+        tags: (json['tags'] as List<dynamic>?)
+                ?.map((e) => e as String)
+                .toList() ??
+            [],
+        projectId: json['project_id'] as int?,
+        milestoneId: json['milestone_id'] as int?,
+        parentId: json['parent_id'] as int?,
+        status: json['status'] as String?,
+        priority: json['priority'] as String?,
+        dueDate: json['due_date'] as String?,
+        createdAt: DateTime.parse(json['created_at'] as String),
+        updatedAt: DateTime.parse(json['updated_at'] as String),
+      );
+}

lib/data/models/message.dart

@@ -7,6 +7,7 @@ class Message {
   final String content;
   final String status; // "complete" | "generating"
   final DateTime? createdAt;
+  final Map<String, dynamic>? metadata;
 
   const Message({
     this.id,
@@ -15,6 +16,7 @@ class Message {
     required this.content,
     this.status = 'complete',
     this.createdAt,
+    this.metadata,
   });
 
   factory Message.fromJson(Map<String, dynamic> json) => Message(
@@ -26,6 +28,7 @@ class Message {
         createdAt: json['created_at'] != null
             ? DateTime.parse(json['created_at'] as String)
             : null,
+        metadata: json['metadata'] as Map<String, dynamic>?,
       );
 
   Message copyWith({String? content, String? status}) => Message(
@@ -35,5 +38,6 @@ class Message {
         content: content ?? this.content,
         status: status ?? this.status,
         createdAt: createdAt,
+        metadata: metadata,
       );
 }

lib/data/models/note.dart

@@ -3,6 +3,7 @@ class Note {
   final String title;
   final String body;
   final List<String> tags;
+  final String noteType;
   final int? projectId;
   final int? milestoneId;
   final DateTime createdAt;
@@ -13,6 +14,7 @@ class Note {
     required this.title,
     required this.body,
     required this.tags,
+    this.noteType = 'note',
     this.projectId,
     this.milestoneId,
     required this.createdAt,
@@ -27,6 +29,7 @@ class Note {
                 ?.map((e) => e as String)
                 .toList() ??
             [],
+        noteType: json['note_type'] as String? ?? 'note',
         projectId: json['project_id'] as int?,
         milestoneId: json['milestone_id'] as int?,
         createdAt: DateTime.parse(json['created_at'] as String),
@@ -37,6 +40,7 @@ class Note {
         'title': title,
         'body': body,
         'tags': tags,
+        'note_type': noteType,
         'project_id': projectId,
         'milestone_id': milestoneId,
       };
@@ -45,6 +49,7 @@ class Note {
     String? title,
     String? body,
     List<String>? tags,
+    String? noteType,
     Object? projectId = _undefined,
     Object? milestoneId = _undefined,
   }) =>
@@ -53,6 +58,7 @@ class Note {
         title: title ?? this.title,
         body: body ?? this.body,
         tags: tags ?? this.tags,
+        noteType: noteType ?? this.noteType,
         projectId: identical(projectId, _undefined)
             ? this.projectId
             : projectId as int?,

lib/data/models/project.dart

@@ -5,6 +5,7 @@ class Project {
   final String? goal;
   final String status; // active | completed | archived
   final String? color;
+  final String? autoSummary;
   final DateTime createdAt;
   final DateTime updatedAt;
 
@@ -15,6 +16,7 @@ class Project {
     this.goal,
     required this.status,
     this.color,
+    this.autoSummary,
     required this.createdAt,
     required this.updatedAt,
   });
@@ -26,6 +28,7 @@ class Project {
         goal: json['goal'] as String?,
         status: json['status'] as String? ?? 'active',
         color: json['color'] as String?,
+        autoSummary: json['auto_summary'] as String?,
         createdAt: DateTime.parse(json['created_at'] as String),
         updatedAt: DateTime.parse(json['updated_at'] as String),
       );
@@ -36,5 +39,6 @@ class Project {
         'goal': goal,
         'status': status,
         'color': color,
+        'auto_summary': autoSummary,
       };
 }

lib/data/repositories/knowledge_repository.dart

@@ -0,0 +1,33 @@
+import '../api/knowledge_api.dart';
+import '../models/knowledge_item.dart';
+
+class KnowledgeRepository {
+  final KnowledgeApi _api;
+  const KnowledgeRepository(this._api);
+
+  Future<(List<int>, int)> fetchIds({
+    String? noteType,
+    List<String> tags = const [],
+    String sort = 'modified',
+    String? q,
+    int limit = 50,
+    int offset = 0,
+  }) =>
+      _api.fetchIds(
+        noteType: noteType,
+        tags: tags,
+        sort: sort,
+        q: q,
+        limit: limit,
+        offset: offset,
+      );
+
+  Future<List<KnowledgeItem>> fetchBatch(List<int> ids) =>
+      _api.fetchBatch(ids);
+
+  Future<Map<String, int>> fetchCounts({List<String> tags = const []}) =>
+      _api.fetchCounts(tags: tags);
+
+  Future<List<String>> fetchTags({String? noteType}) =>
+      _api.fetchTags(noteType: noteType);
+}

lib/data/repositories/notes_repository.dart

@@ -13,8 +13,10 @@ class NotesRepository {
     String body, {
     List<String> tags = const [],
     int? projectId,
+    String noteType = 'note',
   }) =>
-      _api.create(title, body, tags: tags, projectId: projectId);
+      _api.create(title, body,
+          tags: tags, projectId: projectId, noteType: noteType);
 
   Future<Note> update(
     int id,
@@ -23,9 +25,13 @@ class NotesRepository {
     List<String> tags = const [],
     int? projectId,
     bool clearProject = false,
+    String noteType = 'note',
   }) =>
       _api.update(id, title, body,
-          tags: tags, projectId: projectId, clearProject: clearProject);
+          tags: tags,
+          projectId: projectId,
+          clearProject: clearProject,
+          noteType: noteType);
 
   Future<void> delete(int id) => _api.delete(id);
 }

lib/data/repositories/projects_repository.dart

@@ -5,16 +5,26 @@ class ProjectsRepository {
   final ProjectsApi _api;
   const ProjectsRepository(this._api);
 
-  Future<List<Project>> getAll({String? status}) => _api.getAll(status: status);
+  Future<List<Project>> getAll({
+    String? status,
+    String sort = 'updated_at',
+    String order = 'desc',
+  }) =>
+      _api.getAll(status: status, sort: sort, order: order);
   Future<Project> getOne(int id) => _api.getOne(id);
   Future<Project> create({
     required String title,
     String? description,
     String? goal,
     String? color,
+    String status = 'active',
   }) =>
       _api.create(
-          title: title, description: description, goal: goal, color: color);
+          title: title,
+          description: description,
+          goal: goal,
+          color: color,
+          status: status);
   Future<Project> update(int id, Map<String, dynamic> fields) =>
       _api.update(id, fields);
   Future<void> delete(int id) => _api.delete(id);

lib/data/repositories/tasks_repository.dart

@@ -27,6 +27,7 @@ class TasksRepository {
         parentId: parentId,
       );
 
+  Future<List<Task>> getByProject(int projectId) => _api.getByProject(projectId);
   Future<List<Task>> getSubTasks(int parentId) => _api.getSubTasks(parentId);
 
   Future<Task> update(int id, Map<String, dynamic> fields) =>

lib/data/repositories/voice_repository.dart

@@ -0,0 +1,12 @@
+import 'dart:typed_data';
+
+import '../api/voice_api.dart';
+
+class VoiceRepository {
+  final VoiceApi _api;
+  const VoiceRepository(this._api);
+
+  Future<VoiceStatus> checkStatus() => _api.checkStatus();
+  Future<String> transcribe(Uint8List audioBytes) => _api.transcribe(audioBytes);
+  Future<Uint8List> synthesise(String text) => _api.synthesise(text);
+}

lib/providers/api_client_provider.dart

@@ -4,14 +4,20 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 
 import '../data/api/api_client.dart';
 import '../data/api/auth_api.dart';
+import '../data/api/briefing_api.dart';
 import '../data/api/chat_api.dart';
+import '../data/api/knowledge_api.dart';
+import '../data/api/voice_api.dart';
 import '../data/api/milestones_api.dart';
 import '../data/api/notes_api.dart';
 import '../data/api/projects_api.dart';
 import '../data/api/quick_capture_api.dart';
+import '../data/api/settings_api.dart';
 import '../data/api/tasks_api.dart';
 import '../data/repositories/auth_repository.dart';
 import '../data/repositories/chat_repository.dart';
+import '../data/repositories/knowledge_repository.dart';
+import '../data/repositories/voice_repository.dart';
 import '../data/repositories/milestones_repository.dart';
 import '../data/repositories/notes_repository.dart';
 import '../data/repositories/projects_repository.dart';
@@ -80,3 +86,27 @@ final milestonesApiProvider = Provider<MilestonesApi>((ref) {
 final milestonesRepositoryProvider = Provider<MilestonesRepository>((ref) {
   return MilestonesRepository(ref.watch(milestonesApiProvider));
 });
+
+final knowledgeApiProvider = Provider<KnowledgeApi>((ref) {
+  return KnowledgeApi(ref.watch(dioProvider));
+});
+
+final knowledgeRepositoryProvider = Provider<KnowledgeRepository>((ref) {
+  return KnowledgeRepository(ref.watch(knowledgeApiProvider));
+});
+
+final briefingApiProvider = Provider<BriefingApi>((ref) {
+  return BriefingApi(ref.watch(dioProvider));
+});
+
+final settingsApiProvider = Provider<SettingsApi>((ref) {
+  return SettingsApi(ref.watch(dioProvider));
+});
+
+final voiceApiProvider = Provider<VoiceApi>((ref) {
+  return VoiceApi(ref.watch(dioProvider));
+});
+
+final voiceRepositoryProvider = Provider<VoiceRepository>((ref) {
+  return VoiceRepository(ref.watch(voiceApiProvider));
+});

lib/providers/auth_provider.dart

@@ -4,18 +4,15 @@ import 'api_client_provider.dart';
 
 enum AuthStatus { unknown, authenticated, unauthenticated }
 
-final authProvider = StateNotifierProvider<AuthNotifier, AuthStatus>((ref) {
-  return AuthNotifier(ref);
-});
+final authProvider = NotifierProvider<AuthNotifier, AuthStatus>(AuthNotifier.new);
 
-class AuthNotifier extends StateNotifier<AuthStatus> {
-  final Ref _ref;
-
-  AuthNotifier(this._ref) : super(AuthStatus.unknown);
+class AuthNotifier extends Notifier<AuthStatus> {
+  @override
+  AuthStatus build() => AuthStatus.unknown;
 
   Future<void> verify() async {
     try {
-      final repo = _ref.read(authRepositoryProvider);
+      final repo = ref.read(authRepositoryProvider);
       final ok = await repo.verify();
       state = ok ? AuthStatus.authenticated : AuthStatus.unauthenticated;
     } catch (_) {
@@ -24,14 +21,14 @@ class AuthNotifier extends StateNotifier<AuthStatus> {
   }
 
   Future<void> login(String username, String password) async {
-    final repo = _ref.read(authRepositoryProvider);
+    final repo = ref.read(authRepositoryProvider);
     await repo.login(username, password);
     state = AuthStatus.authenticated;
   }
 
   Future<void> logout() async {
     try {
-      final repo = _ref.read(authRepositoryProvider);
+      final repo = ref.read(authRepositoryProvider);
       await repo.logout();
     } finally {
       state = AuthStatus.unauthenticated;

lib/providers/briefing_provider.dart

@@ -0,0 +1,137 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+import '../data/models/briefing_conversation.dart';
+import '../data/models/message.dart';
+import 'api_client_provider.dart';
+
+/// Drives the loading indicator in BriefingScreen's reply area.
+final isBriefingStreamingProvider =
+    NotifierProvider<_BoolNotifier, bool>(_BoolNotifier.new);
+
+class _BoolNotifier extends Notifier<bool> {
+  @override
+  bool build() => false;
+}
+
+final briefingProvider =
+    AsyncNotifierProvider<BriefingNotifier, BriefingConversation>(
+        BriefingNotifier.new);
+
+class BriefingNotifier extends AsyncNotifier<BriefingConversation> {
+  @override
+  Future<BriefingConversation> build() async {
+    return ref.read(briefingApiProvider).getToday();
+  }
+
+  /// Silently fetch the latest briefing and patch state without triggering
+  /// AsyncLoading — existing content stays visible while the fetch is in flight.
+  Future<void> silentRefresh() async {
+    final current = state.value;
+    if (current == null) return;
+    try {
+      final fresh = await ref.read(briefingApiProvider).getToday();
+      final curLast = current.messages.isNotEmpty ? current.messages.last : null;
+      final newLast = fresh.messages.isNotEmpty ? fresh.messages.last : null;
+      if (fresh.messages.length != current.messages.length ||
+          newLast?.content != curLast?.content) {
+        state = AsyncData(fresh);
+      }
+    } catch (_) {
+      // Network hiccup — silently ignore, keep existing content
+    }
+  }
+
+  /// Trigger a briefing slot (e.g. "compilation") then reload.
+  Future<void> refresh(String slot) async {
+    await ref.read(briefingApiProvider).triggerSlot(slot);
+    ref.invalidateSelf();
+    await future;
+  }
+
+  /// Send a reply to today's briefing conversation.
+  ///
+  /// Mirrors MessagesNotifier.sendMessage():
+  ///   1. Optimistic UI update
+  ///   2. POST message to chat endpoint
+  ///   3. SSE stream (best-effort)
+  ///   4. Poll until complete
+  Future<void> sendReply(String content) async {
+    final conv = state.value;
+    if (conv == null) return;
+    final convId = conv.id;
+    final chatApi = ref.read(chatApiProvider);
+
+    final previous = conv.messages;
+    final userMsg = Message(
+      conversationId: convId,
+      role: MessageRole.user,
+      content: content,
+    );
+    final placeholder = Message(
+      conversationId: convId,
+      role: MessageRole.assistant,
+      content: '',
+      status: 'generating',
+    );
+    state = AsyncData(conv.copyWith(messages: [...previous, userMsg, placeholder]));
+    ref.read(isBriefingStreamingProvider.notifier).state = true;
+
+    try {
+      await chatApi.sendMessage(convId, content);
+    } catch (e) {
+      state = AsyncData(conv.copyWith(messages: previous));
+      ref.read(isBriefingStreamingProvider.notifier).state = false;
+      rethrow;
+    }
+
+    // SSE stream (best-effort)
+    bool streamedContent = false;
+    try {
+      await for (final chunk in chatApi.streamGeneration(convId)) {
+        streamedContent = true;
+        final current = state.value;
+        if (current == null) break;
+        final msgs = current.messages;
+        if (msgs.isEmpty) continue;
+        final updated = msgs.last.copyWith(content: msgs.last.content + chunk);
+        state = AsyncData(current.copyWith(
+            messages: [...msgs.sublist(0, msgs.length - 1), updated]));
+      }
+    } catch (_) {
+      // Fall through to polling.
+    }
+
+    // Poll until complete (max 20 attempts, 2s apart)
+    try {
+      for (var attempt = 0; attempt < 20; attempt++) {
+        if (attempt > 0) await Future.delayed(const Duration(seconds: 2));
+        final fresh = await ref.read(briefingApiProvider).getMessages(convId);
+        final done = fresh.any(
+          (m) => m.role == MessageRole.assistant && m.status != 'generating',
+        );
+        final hasContent = fresh.any(
+          (m) => m.role == MessageRole.assistant && m.content.isNotEmpty,
+        );
+        final current = state.value;
+        if (current != null && (!streamedContent || done || hasContent)) {
+          state = AsyncData(current.copyWith(messages: fresh));
+        }
+        if (done) break;
+      }
+    } catch (_) {
+      // Clear the generating placeholder so UI doesn't spin forever.
+      final current = state.value;
+      if (current != null) {
+        final msgs = current.messages;
+        if (msgs.isNotEmpty && msgs.last.status == 'generating') {
+          state = AsyncData(current.copyWith(messages: [
+            ...msgs.sublist(0, msgs.length - 1),
+            msgs.last.copyWith(status: 'complete'),
+          ]));
+        }
+      }
+    } finally {
+      ref.read(isBriefingStreamingProvider.notifier).state = false;
+    }
+  }
+}

lib/providers/capture_queue_provider.dart

@@ -4,16 +4,20 @@ import 'package:shared_preferences/shared_preferences.dart';
 import 'settings_provider.dart';
 
 final captureQueueProvider =
-    StateNotifierProvider<CaptureQueueNotifier, List<String>>(
-  (ref) => CaptureQueueNotifier(ref.watch(sharedPreferencesProvider)),
+    NotifierProvider<CaptureQueueNotifier, List<String>>(
+  CaptureQueueNotifier.new,
 );
 
-class CaptureQueueNotifier extends StateNotifier<List<String>> {
+class CaptureQueueNotifier extends Notifier<List<String>> {
   static const _key = 'capture_queue';
-  final SharedPreferences _prefs;
 
-  CaptureQueueNotifier(this._prefs)
-      : super(_prefs.getStringList(_key) ?? []);
+  SharedPreferences get _prefs => ref.read(sharedPreferencesProvider);
+
+  @override
+  List<String> build() {
+    final prefs = ref.watch(sharedPreferencesProvider);
+    return prefs.getStringList(_key) ?? [];
+  }
 
   Future<void> enqueue(String text) async {
     final updated = [...state, text];

lib/providers/capture_work_queue_provider.dart

@@ -0,0 +1,105 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+import '../core/exceptions.dart';
+import 'api_client_provider.dart';
+import 'capture_queue_provider.dart';
+import 'notes_provider.dart';
+import 'tasks_provider.dart';
+
+/// Outcome of a single capture attempt — consumed by the UI for snackbars.
+class CaptureResult {
+  final String message;
+  final bool isError;
+  const CaptureResult(this.message, {this.isError = false});
+}
+
+/// The most recent capture result. UI watches this to show snackbars.
+/// Reset to null by the notifier before each new item so listeners always fire.
+final captureResultProvider =
+    NotifierProvider<_CaptureResultNotifier, CaptureResult?>(
+        _CaptureResultNotifier.new);
+
+class _CaptureResultNotifier extends Notifier<CaptureResult?> {
+  @override
+  CaptureResult? build() => null;
+}
+
+/// In-memory sequential work queue for quick captures.
+/// Separate from [captureQueueProvider] (which is the offline persistence queue).
+final captureWorkQueueProvider =
+    NotifierProvider<CaptureWorkQueueNotifier, List<String>>(
+  CaptureWorkQueueNotifier.new,
+);
+
+class CaptureWorkQueueNotifier extends Notifier<List<String>> {
+  bool _running = false;
+
+  @override
+  List<String> build() => [];
+
+  /// Add text to the queue and start the drain loop if not already running.
+  void enqueue(String text) {
+    state = [...state, text];
+    _drain();
+  }
+
+  Future<void> _drain() async {
+    if (_running) return;
+    _running = true;
+    try {
+      while (state.isNotEmpty) {
+        final text = state.first;
+        // Signal "no result yet" so the same result value can re-trigger watch.
+        ref.read(captureResultProvider.notifier).state = null;
+        try {
+          final api = ref.read(quickCaptureApiProvider);
+          final result = await api.capture(text);
+
+          // Dequeue on success.
+          state = state.length > 1 ? state.sublist(1) : [];
+
+          // Invalidate content providers so lists refresh.
+          switch (result.type) {
+            case 'note':
+              ref.invalidate(notesProvider);
+            case 'task':
+            case 'todo':
+              ref.invalidate(tasksProvider);
+          }
+
+          // Publish result for snackbar.
+          final msg = result.message.isNotEmpty
+              ? result.message
+              : '${_typeLabel(result.type)} created: ${result.title}';
+          ref.read(captureResultProvider.notifier).state = CaptureResult(msg);
+        } on NetworkException catch (_) {
+          // Persist to offline queue and stop draining — still offline.
+          await ref.read(captureQueueProvider.notifier).enqueue(text);
+          state = state.length > 1 ? state.sublist(1) : [];
+          ref.read(captureResultProvider.notifier).state = CaptureResult(
+            "You're offline — capture saved and will retry automatically.",
+          );
+          break;
+        } on AppException catch (e) {
+          state = state.length > 1 ? state.sublist(1) : [];
+          ref.read(captureResultProvider.notifier).state =
+              CaptureResult(e.message, isError: true);
+        } catch (_) {
+          state = state.length > 1 ? state.sublist(1) : [];
+          ref.read(captureResultProvider.notifier).state =
+              CaptureResult('Capture failed. Please try again.', isError: true);
+        }
+      }
+    } finally {
+      _running = false;
+    }
+  }
+
+  String _typeLabel(String type) => switch (type) {
+        'note' => 'Note',
+        'task' => 'Task',
+        'event' => 'Event',
+        'todo' => 'To-do',
+        _ => type,
+      };
+}

lib/providers/chat_provider.dart

@@ -4,8 +4,19 @@ import '../data/models/conversation.dart';
 import '../data/models/message.dart';
 import 'api_client_provider.dart';
 
-// Separate StateProvider so UI re-builds immediately when streaming starts/stops.
-final isStreamingProvider = StateProvider.family<bool, int>((ref, _) => false);
+// Separate NotifierProvider.family so UI re-builds immediately when streaming starts/stops.
+final isStreamingProvider =
+    NotifierProvider.family<_IsStreamingNotifier, bool, int>(
+  (convId) => _IsStreamingNotifier(convId),
+);
+
+class _IsStreamingNotifier extends Notifier<bool> {
+  // ignore: avoid_unused_constructor_parameters
+  _IsStreamingNotifier(int convId);
+
+  @override
+  bool build() => false;
+}
 
 final conversationsProvider =
     AsyncNotifierProvider<ConversationsNotifier, List<Conversation>>(
@@ -20,14 +31,14 @@ class ConversationsNotifier extends AsyncNotifier<List<Conversation>> {
   Future<Conversation> create(String title) async {
     final conv =
         await ref.read(chatRepositoryProvider).createConversation(title);
-    state = AsyncData([conv, ...state.valueOrNull ?? []]);
+    state = AsyncData([conv, ...state.value ?? []]);
     return conv;
   }
 
   Future<void> delete(int id) async {
     await ref.read(chatRepositoryProvider).deleteConversation(id);
     state = AsyncData([
-      for (final c in state.valueOrNull ?? [])
+      for (final c in state.value ?? [])
         if (c.id != id) c,
     ]);
   }
@@ -35,7 +46,7 @@ class ConversationsNotifier extends AsyncNotifier<List<Conversation>> {
   // Called after a message is sent to patch the server-generated title
   // in-place without triggering a full reload or loading state.
   void patchConversation(Conversation updated) {
-    final list = state.valueOrNull;
+    final list = state.value;
     if (list == null) return;
     state = AsyncData([
       for (final c in list)
@@ -44,21 +55,26 @@ class ConversationsNotifier extends AsyncNotifier<List<Conversation>> {
   }
 }
 
-final messagesProvider = AsyncNotifierProvider.family<MessagesNotifier,
-    List<Message>, int>(MessagesNotifier.new);
+final messagesProvider =
+    AsyncNotifierProvider.family<MessagesNotifier, List<Message>, int>(
+  (convId) => MessagesNotifier(convId),
+);
+
+class MessagesNotifier extends AsyncNotifier<List<Message>> {
+  final int _convId;
+  MessagesNotifier(this._convId);
 
-class MessagesNotifier extends FamilyAsyncNotifier<List<Message>, int> {
   @override
-  Future<List<Message>> build(int arg) async {
+  Future<List<Message>> build() async {
     final (_, messages) =
-        await ref.watch(chatRepositoryProvider).getMessages(arg);
+        await ref.watch(chatRepositoryProvider).getMessages(_convId);
     return messages;
   }
 
   Future<void> sendMessage(String content) async {
-    final convId = arg;
+    final convId = _convId;
     final repo = ref.read(chatRepositoryProvider);
-    final previousMessages = state.valueOrNull ?? [];
+    final previousMessages = state.value ?? [];
 
     // Optimistic UI: show the user message + assistant placeholder immediately.
     final userMsg = Message(
@@ -132,7 +148,7 @@ class MessagesNotifier extends FamilyAsyncNotifier<List<Message>, int> {
     } catch (_) {
       // Polling failed entirely — clear the generating placeholder so the UI
       // doesn't spin forever.
-      final msgs = state.valueOrNull;
+      final msgs = state.value;
       if (msgs != null && msgs.isNotEmpty && msgs.last.status == 'generating') {
         state = AsyncData([
           ...msgs.sublist(0, msgs.length - 1),

lib/providers/knowledge_provider.dart

@@ -0,0 +1,220 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+import '../data/models/knowledge_item.dart';
+import '../data/repositories/knowledge_repository.dart';
+import 'api_client_provider.dart';
+
+/// Immutable state for the Knowledge screen's two-tier paginated feed.
+class KnowledgeState {
+  final List<int> ids;
+  final Map<int, KnowledgeItem> items;
+  final int totalIds;
+  final bool isLoadingIds;
+  final bool isLoadingBatch;
+  final bool hasMore;
+  final String? noteType; // null = All
+  final List<String> activeTags;
+  final String? searchQuery;
+  final Map<String, int> counts;
+  final List<String> availableTags;
+  final String? error;
+
+  const KnowledgeState({
+    this.ids = const [],
+    this.items = const {},
+    this.totalIds = 0,
+    this.isLoadingIds = false,
+    this.isLoadingBatch = false,
+    this.hasMore = false,
+    this.noteType,
+    this.activeTags = const [],
+    this.searchQuery,
+    this.counts = const {},
+    this.availableTags = const [],
+    this.error,
+  });
+
+  /// Items in server-defined ID order, only those already hydrated.
+  List<KnowledgeItem> get orderedItems =>
+      ids.where(items.containsKey).map((id) => items[id]!).toList();
+
+  /// IDs that have been fetched but not yet hydrated.
+  List<int> get unhydratedIds =>
+      ids.where((id) => !items.containsKey(id)).toList();
+
+  KnowledgeState copyWith({
+    List<int>? ids,
+    Map<int, KnowledgeItem>? items,
+    int? totalIds,
+    bool? isLoadingIds,
+    bool? isLoadingBatch,
+    bool? hasMore,
+    Object? noteType = _keep,
+    List<String>? activeTags,
+    Object? searchQuery = _keep,
+    Map<String, int>? counts,
+    List<String>? availableTags,
+    Object? error = _keep,
+  }) =>
+      KnowledgeState(
+        ids: ids ?? this.ids,
+        items: items ?? this.items,
+        totalIds: totalIds ?? this.totalIds,
+        isLoadingIds: isLoadingIds ?? this.isLoadingIds,
+        isLoadingBatch: isLoadingBatch ?? this.isLoadingBatch,
+        hasMore: hasMore ?? this.hasMore,
+        noteType:
+            identical(noteType, _keep) ? this.noteType : noteType as String?,
+        activeTags: activeTags ?? this.activeTags,
+        searchQuery: identical(searchQuery, _keep)
+            ? this.searchQuery
+            : searchQuery as String?,
+        counts: counts ?? this.counts,
+        availableTags: availableTags ?? this.availableTags,
+        error: identical(error, _keep) ? this.error : error as String?,
+      );
+
+  static const _keep = Object();
+}
+
+class KnowledgeNotifier extends Notifier<KnowledgeState> {
+  @override
+  KnowledgeState build() => const KnowledgeState();
+
+  KnowledgeRepository get _repo => ref.read(knowledgeRepositoryProvider);
+
+  // ── Filter setters — each resets and re-fetches ──────────────────────────
+
+  Future<void> setTypeFilter(String? noteType) async {
+    state = KnowledgeState(noteType: noteType, activeTags: state.activeTags);
+    await _fetchFromScratch();
+  }
+
+  Future<void> toggleTag(String tag) async {
+    final tags = state.activeTags.contains(tag)
+        ? state.activeTags.where((t) => t != tag).toList()
+        : [...state.activeTags, tag];
+    state = KnowledgeState(
+      noteType: state.noteType,
+      activeTags: tags,
+      searchQuery: state.searchQuery,
+    );
+    await _fetchFromScratch();
+  }
+
+  Future<void> setSearch(String? q) async {
+    final query = (q?.trim().isEmpty ?? true) ? null : q?.trim();
+    state = KnowledgeState(
+      noteType: state.noteType,
+      activeTags: state.activeTags,
+      searchQuery: query,
+    );
+    await _fetchFromScratch();
+  }
+
+  Future<void> refresh() async {
+    state = KnowledgeState(
+      noteType: state.noteType,
+      activeTags: state.activeTags,
+      searchQuery: state.searchQuery,
+    );
+    await _fetchFromScratch();
+  }
+
+  // ── Scroll-triggered loaders ─────────────────────────────────────────────
+
+  /// Hydrate the next 12 un-hydrated IDs. Call when approaching scroll end.
+  Future<void> hydrateNext() async {
+    if (state.isLoadingBatch) return;
+    final toFetch = state.unhydratedIds.take(12).toList();
+    if (toFetch.isEmpty) {
+      // All fetched IDs are hydrated — try loading more IDs.
+      if (state.hasMore && !state.isLoadingIds) await _loadMoreIds();
+      return;
+    }
+    state = state.copyWith(isLoadingBatch: true);
+    try {
+      final fetched = await _repo.fetchBatch(toFetch);
+      final updated = Map<int, KnowledgeItem>.from(state.items);
+      for (final item in fetched) {
+        updated[item.id] = item;
+      }
+      state = state.copyWith(items: updated, isLoadingBatch: false);
+    } catch (_) {
+      state = state.copyWith(isLoadingBatch: false);
+    }
+  }
+
+  // ── Private helpers ──────────────────────────────────────────────────────
+
+  Future<void> _fetchFromScratch() async {
+    state = state.copyWith(isLoadingIds: true, error: null);
+    try {
+      final (ids, total) = await _repo.fetchIds(
+        noteType: state.noteType,
+        tags: state.activeTags,
+        q: state.searchQuery,
+        limit: 50,
+        offset: 0,
+      );
+      state = state.copyWith(
+        ids: ids,
+        items: {},
+        totalIds: total,
+        isLoadingIds: false,
+        hasMore: ids.length < total,
+      );
+      // Load counts and tags in parallel with the first batch hydration.
+      await Future.wait([
+        hydrateNext(),
+        _loadCounts(),
+        _loadTags(),
+      ]);
+    } catch (e) {
+      state = state.copyWith(
+        isLoadingIds: false,
+        error: e.toString(),
+      );
+    }
+  }
+
+  Future<void> _loadMoreIds() async {
+    if (!state.hasMore || state.isLoadingIds) return;
+    state = state.copyWith(isLoadingIds: true);
+    try {
+      final (newIds, total) = await _repo.fetchIds(
+        noteType: state.noteType,
+        tags: state.activeTags,
+        q: state.searchQuery,
+        limit: 50,
+        offset: state.ids.length,
+      );
+      final combined = [...state.ids, ...newIds];
+      state = state.copyWith(
+        ids: combined,
+        totalIds: total,
+        isLoadingIds: false,
+        hasMore: combined.length < total,
+      );
+    } catch (_) {
+      state = state.copyWith(isLoadingIds: false);
+    }
+  }
+
+  Future<void> _loadCounts() async {
+    try {
+      final counts = await _repo.fetchCounts(tags: state.activeTags);
+      state = state.copyWith(counts: counts);
+    } catch (_) {}
+  }
+
+  Future<void> _loadTags() async {
+    try {
+      final tags = await _repo.fetchTags(noteType: state.noteType);
+      state = state.copyWith(availableTags: tags);
+    } catch (_) {}
+  }
+}
+
+final knowledgeProvider =
+    NotifierProvider<KnowledgeNotifier, KnowledgeState>(KnowledgeNotifier.new);

lib/providers/notes_provider.dart

@@ -17,11 +17,15 @@ class NotesNotifier extends AsyncNotifier<List<Note>> {
     String body, {
     List<String> tags = const [],
     int? projectId,
+    String noteType = 'note',
   }) async {
-    final note = await ref
-        .read(notesRepositoryProvider)
-        .create(title, body, tags: tags, projectId: projectId);
-    state = AsyncData([...state.valueOrNull ?? [], note]);
+    final note = await ref.read(notesRepositoryProvider).create(
+          title, body,
+          tags: tags,
+          projectId: projectId,
+          noteType: noteType,
+        );
+    state = AsyncData([...state.value ?? [], note]);
     return note;
   }
 
@@ -32,6 +36,7 @@ class NotesNotifier extends AsyncNotifier<List<Note>> {
     List<String> tags = const [],
     int? projectId,
     bool clearProject = false,
+    String noteType = 'note',
   }) async {
     final updated = await ref.read(notesRepositoryProvider).update(
           id,
@@ -40,9 +45,10 @@ class NotesNotifier extends AsyncNotifier<List<Note>> {
           tags: tags,
           projectId: projectId,
           clearProject: clearProject,
+          noteType: noteType,
         );
     state = AsyncData([
-      for (final n in state.valueOrNull ?? [])
+      for (final n in state.value ?? [])
         if (n.id == id) updated else n,
     ]);
     return updated;
@@ -51,7 +57,7 @@ class NotesNotifier extends AsyncNotifier<List<Note>> {
   Future<void> delete(int id) async {
     await ref.read(notesRepositoryProvider).delete(id);
     state = AsyncData([
-      for (final n in state.valueOrNull ?? [])
+      for (final n in state.value ?? [])
         if (n.id != id) n,
     ]);
   }

lib/providers/projects_provider.dart

@@ -10,7 +10,9 @@ final projectsProvider =
 class ProjectsNotifier extends AsyncNotifier<List<Project>> {
   @override
   Future<List<Project>> build() async {
-    return ref.watch(projectsRepositoryProvider).getAll();
+    return ref
+        .watch(projectsRepositoryProvider)
+        .getAll(sort: 'updated_at', order: 'desc');
   }
 
   Future<Project> create({
@@ -25,7 +27,7 @@ class ProjectsNotifier extends AsyncNotifier<List<Project>> {
           goal: goal,
           color: color,
         );
-    state = AsyncData([...state.valueOrNull ?? [], project]);
+    state = AsyncData([...state.value ?? [], project]);
     return project;
   }
 
@@ -33,7 +35,7 @@ class ProjectsNotifier extends AsyncNotifier<List<Project>> {
     final updated =
         await ref.read(projectsRepositoryProvider).update(id, fields);
     state = AsyncData([
-      for (final p in state.valueOrNull ?? [])
+      for (final p in state.value ?? [])
         if (p.id == id) updated else p,
     ]);
     return updated;
@@ -42,7 +44,7 @@ class ProjectsNotifier extends AsyncNotifier<List<Project>> {
   Future<void> delete(int id) async {
     await ref.read(projectsRepositoryProvider).delete(id);
     state = AsyncData([
-      for (final p in state.valueOrNull ?? [])
+      for (final p in state.value ?? [])
         if (p.id != id) p,
     ]);
   }

lib/providers/settings_provider.dart

@@ -15,16 +15,14 @@ final cookiesPathProvider = Provider<String>((ref) {
 });
 
 final themeModeProvider =
-    StateNotifierProvider<ThemeModeNotifier, ThemeMode>((ref) {
-  final prefs = ref.watch(sharedPreferencesProvider);
-  return ThemeModeNotifier(prefs);
-});
+    NotifierProvider<ThemeModeNotifier, ThemeMode>(ThemeModeNotifier.new);
 
-class ThemeModeNotifier extends StateNotifier<ThemeMode> {
-  final SharedPreferences _prefs;
-
-  ThemeModeNotifier(this._prefs)
-      : super(_fromString(_prefs.getString(_kThemeMode)));
+class ThemeModeNotifier extends Notifier<ThemeMode> {
+  @override
+  ThemeMode build() {
+    final prefs = ref.watch(sharedPreferencesProvider);
+    return _fromString(prefs.getString(_kThemeMode));
+  }
 
   static ThemeMode _fromString(String? value) => switch (value) {
         'light' => ThemeMode.light,
@@ -38,48 +36,49 @@ class ThemeModeNotifier extends StateNotifier<ThemeMode> {
       ThemeMode.dark => 'dark',
       _ => 'system',
     };
-    await _prefs.setString(_kThemeMode, value);
+    await ref.read(sharedPreferencesProvider).setString(_kThemeMode, value);
     state = mode;
   }
 }
 
 final forgejoRepoUrlProvider =
-    StateNotifierProvider<ForgejoRepoUrlNotifier, String?>((ref) {
-  return ForgejoRepoUrlNotifier(ref.watch(sharedPreferencesProvider));
-});
+    NotifierProvider<ForgejoRepoUrlNotifier, String?>(
+        ForgejoRepoUrlNotifier.new);
 
-class ForgejoRepoUrlNotifier extends StateNotifier<String?> {
-  final SharedPreferences _prefs;
-  ForgejoRepoUrlNotifier(this._prefs)
-      : super(_prefs.getString(_kForgejoRepoUrl) ??
-            'https://git.fabledsword.com/bvandeusen/FabledApp');
+class ForgejoRepoUrlNotifier extends Notifier<String?> {
+  @override
+  String? build() {
+    final prefs = ref.watch(sharedPreferencesProvider);
+    return prefs.getString(_kForgejoRepoUrl) ??
+        'https://git.fabledsword.com/bvandeusen/FabledApp';
+  }
 
   Future<void> setUrl(String url) async {
     final clean = url.endsWith('/') ? url.substring(0, url.length - 1) : url;
-    await _prefs.setString(_kForgejoRepoUrl, clean);
+    await ref.read(sharedPreferencesProvider).setString(_kForgejoRepoUrl, clean);
     state = clean;
   }
 }
 
-final serverUrlProvider = StateNotifierProvider<ServerUrlNotifier, String?>((ref) {
-  final prefs = ref.watch(sharedPreferencesProvider);
-  return ServerUrlNotifier(prefs);
-});
+final serverUrlProvider =
+    NotifierProvider<ServerUrlNotifier, String?>(ServerUrlNotifier.new);
 
-class ServerUrlNotifier extends StateNotifier<String?> {
-  final SharedPreferences _prefs;
-
-  ServerUrlNotifier(this._prefs) : super(_prefs.getString(_kServerUrl));
+class ServerUrlNotifier extends Notifier<String?> {
+  @override
+  String? build() {
+    final prefs = ref.watch(sharedPreferencesProvider);
+    return prefs.getString(_kServerUrl);
+  }
 
   Future<void> setUrl(String url) async {
     // Strip trailing slash
     final clean = url.endsWith('/') ? url.substring(0, url.length - 1) : url;
-    await _prefs.setString(_kServerUrl, clean);
+    await ref.read(sharedPreferencesProvider).setString(_kServerUrl, clean);
     state = clean;
   }
 
   Future<void> clear() async {
-    await _prefs.remove(_kServerUrl);
+    await ref.read(sharedPreferencesProvider).remove(_kServerUrl);
     state = null;
   }
 }

lib/providers/tasks_provider.dart

@@ -6,6 +6,11 @@ import 'api_client_provider.dart';
 final tasksProvider =
     AsyncNotifierProvider<TasksNotifier, List<Task>>(TasksNotifier.new);
 
+final projectTasksProvider =
+    FutureProvider.family<List<Task>, int>((ref, projectId) {
+  return ref.watch(tasksRepositoryProvider).getByProject(projectId);
+});
+
 class TasksNotifier extends AsyncNotifier<List<Task>> {
   @override
   Future<List<Task>> build() async {
@@ -28,14 +33,14 @@ class TasksNotifier extends AsyncNotifier<List<Task>> {
           dueDate: dueDate,
           projectId: projectId,
         );
-    state = AsyncData([...state.valueOrNull ?? [], task]);
+    state = AsyncData([...state.value ?? [], task]);
     return task;
   }
 
   Future<Task> updateTask(int id, Map<String, dynamic> fields) async {
     final updated = await ref.read(tasksRepositoryProvider).update(id, fields);
     state = AsyncData([
-      for (final t in state.valueOrNull ?? [])
+      for (final t in state.value ?? [])
         if (t.id == id) updated else t,
     ]);
     return updated;
@@ -44,7 +49,7 @@ class TasksNotifier extends AsyncNotifier<List<Task>> {
   Future<void> delete(int id) async {
     await ref.read(tasksRepositoryProvider).delete(id);
     state = AsyncData([
-      for (final t in state.valueOrNull ?? [])
+      for (final t in state.value ?? [])
         if (t.id != id) t,
     ]);
   }

lib/providers/update_provider.dart

@@ -3,6 +3,7 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:open_file/open_file.dart';
 import 'package:package_info_plus/package_info_plus.dart';
 import 'package:path_provider/path_provider.dart';
+import 'package:permission_handler/permission_handler.dart';
 
 enum UpdateStatus { idle, checking, available, downloading, upToDate, error }
 
@@ -102,6 +103,22 @@ class UpdateNotifier extends Notifier<UpdateState> {
 
   Future<void> downloadAndInstall() async {
     if (state.downloadUrl == null) return;
+
+    // Android 8+ requires explicit per-app "Install unknown apps" approval
+    // beyond the manifest declaration. Check and redirect to Settings if needed.
+    final installPermission = await Permission.requestInstallPackages.status;
+    if (!installPermission.isGranted) {
+      final result = await Permission.requestInstallPackages.request();
+      if (!result.isGranted) {
+        state = state.copyWith(
+          status: UpdateStatus.error,
+          errorMessage:
+              'Grant "Install unknown apps" permission for Fabled in Settings, then try again.',
+        );
+        return;
+      }
+    }
+
     state = state.copyWith(status: UpdateStatus.downloading, downloadProgress: 0);
 
     try {
@@ -119,16 +136,20 @@ class UpdateNotifier extends Notifier<UpdateState> {
         },
       );
 
-      await OpenFile.open(
+      final result = await OpenFile.open(
         path,
         type: 'application/vnd.android.package-archive',
       );
 
-      // Return to available so the user can retry install if they dismissed it.
-      state = state.copyWith(
-        status: UpdateStatus.available,
-        downloadProgress: 1.0,
-      );
+      if (result.type == ResultType.done) {
+        // Installer launched — reset to idle so the dialog closes naturally.
+        state = const UpdateState();
+      } else {
+        state = state.copyWith(
+          status: UpdateStatus.error,
+          errorMessage: 'Could not open installer: ${result.message}',
+        );
+      }
     } catch (e) {
       state = state.copyWith(
         status: UpdateStatus.error,

lib/providers/voice_provider.dart

@@ -0,0 +1,371 @@
+import 'dart:async';
+import 'dart:collection';
+import 'dart:io';
+import 'dart:typed_data';
+
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:just_audio/just_audio.dart';
+import 'package:path_provider/path_provider.dart';
+import 'package:permission_handler/permission_handler.dart';
+import 'package:record/record.dart';
+
+import 'api_client_provider.dart';
+
+// ── Public helpers (also used by tests) ──────────────────────────────────────
+
+class SentenceResult {
+  final List<String> sentences;
+  final String remainder;
+  const SentenceResult({required this.sentences, required this.remainder});
+}
+
+/// Extract completed sentences from [text] at `.`, `!`, `?` boundaries.
+/// Returns the completed sentences and the unconsumed remainder.
+SentenceResult extractSentences(String text) {
+  final boundary = RegExp(r'[.!?]+(?=\s|$)');
+  final sentences = <String>[];
+  var remaining = text;
+  RegExpMatch? match;
+  while ((match = boundary.firstMatch(remaining)) != null) {
+    final end = match!.end;
+    final sentence = remaining.substring(0, end).trim();
+    if (sentence.isNotEmpty) sentences.add(sentence);
+    remaining = remaining.substring(end).trimLeft();
+  }
+  return SentenceResult(sentences: sentences, remainder: remaining);
+}
+
+/// Strip markdown formatting before sending text to TTS.
+String stripMarkdownForTts(String text) {
+  return text
+      .replaceAll(RegExp(r'```[\s\S]*?```'), '') // fenced code blocks
+      .replaceAllMapped(RegExp(r'`([^`]+)`'), (m) => m[1]!) // inline code
+      .replaceAll(RegExp(r'#{1,6}\s+'), '') // headings
+      .replaceAllMapped(RegExp(r'\*\*([^*]+)\*\*'), (m) => m[1]!) // bold
+      .replaceAllMapped(RegExp(r'\*([^*]+)\*'), (m) => m[1]!) // italic
+      .replaceAllMapped(
+          RegExp(r'\[([^\]]+)\]\([^)]+\)'), (m) => m[1]!) // links → text
+      .replaceAll(RegExp(r'^\s*[-*+]\s+', multiLine: true), '') // list markers
+      .replaceAll(RegExp(r'\n{2,}'), ' ') // multiple newlines → space
+      .replaceAll('\n', ' ')
+      .trim();
+}
+
+// ── State ─────────────────────────────────────────────────────────────────────
+
+enum VoiceMode { idle, recording, transcribing, playing }
+
+class VoiceState {
+  final VoiceMode mode;
+  final bool voiceModeActive;
+  final bool available;
+
+  const VoiceState({
+    this.mode = VoiceMode.idle,
+    this.voiceModeActive = false,
+    this.available = true,
+  });
+
+  VoiceState copyWith({
+    VoiceMode? mode,
+    bool? voiceModeActive,
+    bool? available,
+  }) =>
+      VoiceState(
+        mode: mode ?? this.mode,
+        voiceModeActive: voiceModeActive ?? this.voiceModeActive,
+        available: available ?? this.available,
+      );
+}
+
+// ── Provider ──────────────────────────────────────────────────────────────────
+
+final voiceProvider =
+    NotifierProvider<VoiceNotifier, VoiceState>(VoiceNotifier.new);
+
+// ── Notifier ──────────────────────────────────────────────────────────────────
+
+class VoiceNotifier extends Notifier<VoiceState> {
+  // Audio I/O
+  AudioRecorder? _recorder;
+  AudioPlayer? _player;
+  StreamSubscription<Amplitude>? _amplitudeSubscription;
+
+  // Recording / silence detection
+  int _recordingStartMs = 0;
+  int _silenceMs = 0;
+  static const _silenceThresholdDb = -40.0;
+  static const _silenceDurationMs = 1500;
+  static const _minRecordingMs = 300;
+
+  // Voice mode callbacks
+  Future<void> Function(String transcript)? _onTranscript;
+  bool _enableTts = false;
+
+  // Streaming TTS state
+  String _sentenceBuffer = '';
+  int _lastSeenLength = 0;
+  bool _streamComplete = false;
+
+  // TTS playback queue
+  final _ttsQueue = Queue<Uint8List>();
+  bool _ttsPlaying = false;
+  int _ttsCounter = 0;
+  Directory? _tempDir;
+
+  @override
+  VoiceState build() {
+    _recorder = AudioRecorder();
+    _player = AudioPlayer();
+    ref.onDispose(() {
+      _amplitudeSubscription?.cancel();
+      _recorder?.dispose();
+      _player?.dispose();
+    });
+    return const VoiceState();
+  }
+
+  // ── Public API ──────────────────────────────────────────────────────────────
+
+  /// Enter voice mode. Checks server availability and mic permission first.
+  /// [onTranscript] is called with the transcript when a recording completes.
+  /// [enableTts] — if true, TTS plays when [feedContent] is called.
+  /// [onError] — called with a human-readable message on failure.
+  Future<void> enterVoiceMode({
+    required Future<void> Function(String transcript) onTranscript,
+    bool enableTts = false,
+    required void Function(String message) onError,
+  }) async {
+    if (state.voiceModeActive) {
+      exitVoiceMode();
+      return;
+    }
+
+    // Check server availability
+    try {
+      final status = await ref.read(voiceRepositoryProvider).checkStatus();
+      if (!status.fullyAvailable) {
+        onError('Voice not available on this server');
+        return;
+      }
+    } catch (_) {
+      onError('Voice not available on this server');
+      return;
+    }
+
+    // Check microphone permission
+    final permStatus = await Permission.microphone.request();
+    if (permStatus == PermissionStatus.denied ||
+        permStatus == PermissionStatus.permanentlyDenied) {
+      onError('Microphone permission required');
+      if (permStatus == PermissionStatus.permanentlyDenied) {
+        await openAppSettings();
+      }
+      return;
+    }
+
+    _onTranscript = onTranscript;
+    _enableTts = enableTts;
+    _tempDir = await getTemporaryDirectory();
+
+    state = state.copyWith(voiceModeActive: true, available: true);
+    await _startListening();
+  }
+
+  /// Exit voice mode, stop all recording and TTS.
+  void exitVoiceMode() {
+    _amplitudeSubscription?.cancel();
+    _amplitudeSubscription = null;
+    _recorder?.stop();
+    _player?.stop();
+    _ttsQueue.clear();
+    _ttsPlaying = false;
+    _sentenceBuffer = '';
+    _lastSeenLength = 0;
+    _streamComplete = false;
+    _onTranscript = null;
+    state = const VoiceState();
+  }
+
+  /// Feed streaming assistant content for TTS synthesis.
+  /// Call from screens with the full [fullContent] string on each update.
+  /// Set [isComplete] to true when the stream has finished.
+  void feedContent(String fullContent, {required bool isComplete}) {
+    if (!state.voiceModeActive || !_enableTts) return;
+
+    final delta = fullContent.length > _lastSeenLength
+        ? fullContent.substring(_lastSeenLength)
+        : '';
+    _lastSeenLength = fullContent.length;
+    _sentenceBuffer += delta;
+
+    _dispatchSentences(flush: isComplete);
+
+    if (isComplete) {
+      _streamComplete = true;
+      _checkRestartListening();
+    }
+  }
+
+  // ── Internal recording ──────────────────────────────────────────────────────
+
+  Future<void> _startListening() async {
+    if (!state.voiceModeActive) return;
+
+    _silenceMs = 0;
+    _recordingStartMs = DateTime.now().millisecondsSinceEpoch;
+    state = state.copyWith(mode: VoiceMode.recording);
+
+    final dir = _tempDir ?? await getTemporaryDirectory();
+    final path =
+        '${dir.path}/voice_rec_${DateTime.now().millisecondsSinceEpoch}.webm';
+
+    await _recorder!.start(
+      const RecordConfig(encoder: AudioEncoder.opus, sampleRate: 16000),
+      path: path,
+    );
+
+    _amplitudeSubscription?.cancel();
+    _amplitudeSubscription = _recorder!
+        .onAmplitudeChanged(const Duration(milliseconds: 200))
+        .listen(_onAmplitude);
+  }
+
+  void _onAmplitude(Amplitude event) {
+    if (!state.voiceModeActive) return;
+
+    final elapsed =
+        DateTime.now().millisecondsSinceEpoch - _recordingStartMs;
+    if (elapsed < _minRecordingMs) return;
+
+    if (event.current < _silenceThresholdDb) {
+      _silenceMs += 200;
+      if (_silenceMs >= _silenceDurationMs) {
+        _amplitudeSubscription?.cancel();
+        _amplitudeSubscription = null;
+        _handleSilence();
+      }
+    } else {
+      _silenceMs = 0;
+    }
+  }
+
+  Future<void> _handleSilence() async {
+    if (!state.voiceModeActive) return;
+    state = state.copyWith(mode: VoiceMode.transcribing);
+
+    final path = await _recorder!.stop();
+    if (path == null || !state.voiceModeActive) return;
+
+    try {
+      final bytes = await File(path).readAsBytes();
+      await File(path).delete().catchError((_) => File(path));
+
+      if (!state.voiceModeActive) return;
+
+      final transcript =
+          await ref.read(voiceRepositoryProvider).transcribe(bytes);
+
+      if (!state.voiceModeActive) return;
+
+      if (transcript.isEmpty) {
+        // Empty transcript — restart silently
+        await _startListening();
+        return;
+      }
+
+      // Reset TTS state for this new turn
+      _sentenceBuffer = '';
+      _lastSeenLength = 0;
+      _streamComplete = false;
+
+      if (_enableTts) {
+        state = state.copyWith(mode: VoiceMode.playing);
+      }
+
+      await _onTranscript?.call(transcript);
+
+      // If TTS is not enabled, loop immediately
+      if (!_enableTts && state.voiceModeActive) {
+        await _startListening();
+      }
+    } catch (_) {
+      // Network/API error — exit voice mode
+      exitVoiceMode();
+    }
+  }
+
+  // ── Internal TTS ────────────────────────────────────────────────────────────
+
+  void _dispatchSentences({required bool flush}) {
+    final result = extractSentences(_sentenceBuffer);
+    _sentenceBuffer = flush ? '' : result.remainder;
+
+    for (final sentence in result.sentences) {
+      _enqueueSentence(sentence);
+    }
+    if (flush && result.remainder.trim().length >= 3) {
+      _enqueueSentence(result.remainder.trim());
+    }
+  }
+
+  void _enqueueSentence(String sentence) {
+    final stripped = stripMarkdownForTts(sentence);
+    if (stripped.length < 3) return;
+    _synthesiseSentence(stripped);
+  }
+
+  Future<void> _synthesiseSentence(String text) async {
+    try {
+      final wavBytes =
+          await ref.read(voiceRepositoryProvider).synthesise(text);
+      if (!state.voiceModeActive) return;
+      _ttsQueue.add(wavBytes);
+      if (!_ttsPlaying) _drainTtsQueue();
+    } catch (_) {
+      // Skip failed sentence — TTS errors are non-fatal
+    }
+  }
+
+  Future<void> _drainTtsQueue() async {
+    if (_ttsPlaying) return;
+    _ttsPlaying = true;
+    final dir = _tempDir ?? await getTemporaryDirectory();
+
+    try {
+      while (_ttsQueue.isNotEmpty && state.voiceModeActive) {
+        final wavBytes = _ttsQueue.removeFirst();
+        final path = '${dir.path}/tts_${_ttsCounter++}.wav';
+        final file = File(path);
+        await file.writeAsBytes(wavBytes);
+
+        try {
+          await _player!.setFilePath(path);
+          await _player!.play();
+          await _player!.processingStateStream.firstWhere(
+            (s) =>
+                s == ProcessingState.completed || s == ProcessingState.idle,
+          );
+        } finally {
+          await file.delete().catchError((_) => file);
+        }
+      }
+    } finally {
+      _ttsPlaying = false;
+    }
+
+    _checkRestartListening();
+  }
+
+  void _checkRestartListening() {
+    if (_streamComplete &&
+        _ttsQueue.isEmpty &&
+        !_ttsPlaying &&
+        state.voiceModeActive) {
+      _streamComplete = false;
+      _lastSeenLength = 0;
+      _sentenceBuffer = '';
+      _startListening();
+    }
+  }
+}

lib/screens/auth/login_screen.dart

@@ -72,7 +72,7 @@ class _LoginScreenState extends ConsumerState<LoginScreen> {
             _usernameController.text.trim(),
             _passwordController.text,
           );
-      if (mounted) context.go(Routes.notes);
+      if (mounted) context.go(Routes.briefing);
     } on AuthException catch (e) {
       setState(() => _error = e.message);
     } on AppException catch (e) {
@@ -90,7 +90,7 @@ class _LoginScreenState extends ConsumerState<LoginScreen> {
         cookieJar: ref.read(cookieJarProvider),
         onSuccess: () async {
           await ref.read(authProvider.notifier).verify();
-          if (mounted) context.go(Routes.notes);
+          if (mounted) context.go(Routes.briefing);
         },
       ),
     ));

lib/screens/briefing/briefing_history_screen.dart

@@ -0,0 +1,88 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+import '../../data/models/briefing_conversation.dart';
+import '../../data/models/message.dart';
+import '../../providers/api_client_provider.dart';
+import '../../widgets/chat_message_bubble.dart';
+
+class BriefingHistoryScreen extends ConsumerWidget {
+  const BriefingHistoryScreen({super.key});
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final historyAsync = ref.watch(_briefingHistoryProvider);
+
+    return Scaffold(
+      appBar: AppBar(title: const Text('Past Briefings')),
+      body: historyAsync.when(
+        loading: () => const Center(child: CircularProgressIndicator()),
+        error: (_, _) =>
+            const Center(child: Text('Could not load briefing history.')),
+        data: (convs) {
+          if (convs.isEmpty) {
+            return const Center(child: Text('No past briefings.'));
+          }
+          return ListView.builder(
+            itemCount: convs.length,
+            itemBuilder: (context, i) {
+              final conv = convs[i];
+              final label = conv.briefingDate ?? conv.title;
+              return ListTile(
+                leading: const Icon(Icons.wb_sunny_outlined),
+                title: Text(label),
+                trailing: const Icon(Icons.chevron_right),
+                onTap: () => Navigator.of(context).push(
+                  MaterialPageRoute(
+                    builder: (_) => _BriefingDetailScreen(conv: conv),
+                  ),
+                ),
+              );
+            },
+          );
+        },
+      ),
+    );
+  }
+}
+
+/// Lazily loads and displays all messages for a past briefing.
+class _BriefingDetailScreen extends ConsumerWidget {
+  final BriefingConversation conv;
+  const _BriefingDetailScreen({required this.conv});
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final messagesAsync = ref.watch(_briefingMessagesProvider(conv.id));
+
+    return Scaffold(
+      appBar: AppBar(title: Text(conv.briefingDate ?? conv.title)),
+      body: messagesAsync.when(
+        loading: () => const Center(child: CircularProgressIndicator()),
+        error: (_, _) => const Center(child: Text('Could not load messages.')),
+        data: (messages) {
+          if (messages.isEmpty) {
+            return const Center(child: Text('No messages.'));
+          }
+          return ListView.builder(
+            padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 12),
+            itemCount: messages.length,
+            itemBuilder: (_, i) => ChatMessageBubble(message: messages[i]),
+          );
+        },
+      ),
+    );
+  }
+}
+
+// ── Private providers (scoped to this file) ──────────────────────────────────
+
+final _briefingHistoryProvider =
+    FutureProvider<List<BriefingConversation>>((ref) async {
+  return ref.watch(briefingApiProvider).getHistory();
+});
+
+final _briefingMessagesProvider =
+    FutureProvider.family<List<Message>, int>((ref, convId) async {
+  return ref.watch(briefingApiProvider).getMessages(convId);
+});

lib/screens/briefing/briefing_screen.dart

@@ -0,0 +1,466 @@
+import 'dart:async';
+
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+import '../../core/exceptions.dart';
+import '../../data/models/message.dart';
+import '../../providers/briefing_provider.dart';
+import '../../providers/api_client_provider.dart';
+import '../../widgets/chat_message_bubble.dart';
+import '../../widgets/weather_card.dart';
+import '../../widgets/news_card.dart';
+import 'briefing_history_screen.dart';
+import '../../providers/voice_provider.dart';
+import '../../widgets/voice_mic_button.dart';
+
+class BriefingScreen extends ConsumerStatefulWidget {
+  const BriefingScreen({super.key});
+
+  @override
+  ConsumerState<BriefingScreen> createState() => _BriefingScreenState();
+}
+
+class _BriefingScreenState extends ConsumerState<BriefingScreen>
+    with WidgetsBindingObserver {
+  final _controller = TextEditingController();
+  final _scrollController = ScrollController();
+  bool _refreshing = false;
+  // rss_item_id -> 'up' | 'down' | null
+  final Map<int, String?> _reactions = {};
+
+  Timer? _pollTimer;
+  bool _appInForeground = true;
+
+  @override
+  void initState() {
+    super.initState();
+    WidgetsBinding.instance.addObserver(this);
+    _pollTimer = Timer.periodic(const Duration(seconds: 60), (_) => _pollSilently());
+  }
+
+  @override
+  void didChangeAppLifecycleState(AppLifecycleState state) {
+    _appInForeground = state == AppLifecycleState.resumed;
+  }
+
+  void _pollSilently() {
+    if (!_appInForeground || !mounted) return;
+    final isStreaming = ref.read(isBriefingStreamingProvider);
+    if (isStreaming) return;
+    ref.read(briefingProvider.notifier).silentRefresh();
+  }
+
+  @override
+  void dispose() {
+    _pollTimer?.cancel();
+    WidgetsBinding.instance.removeObserver(this);
+    _controller.dispose();
+    _scrollController.dispose();
+    ref.read(voiceProvider.notifier).exitVoiceMode();
+    super.dispose();
+  }
+
+  void _scrollToBottom() {
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      if (_scrollController.hasClients) {
+        _scrollController.animateTo(
+          _scrollController.position.maxScrollExtent,
+          duration: const Duration(milliseconds: 200),
+          curve: Curves.easeOut,
+        );
+      }
+    });
+  }
+
+  Future<void> _sendReply() async {
+    final text = _controller.text.trim();
+    if (text.isEmpty) return;
+    _controller.clear();
+    try {
+      await ref.read(briefingProvider.notifier).sendReply(text);
+    } on AppException catch (e) {
+      if (mounted) {
+        ScaffoldMessenger.of(context)
+            .showSnackBar(SnackBar(content: Text(e.message)));
+      }
+    } catch (_) {
+      if (mounted) {
+        ScaffoldMessenger.of(context).showSnackBar(
+          const SnackBar(content: Text('Failed to send reply.')),
+        );
+      }
+    }
+  }
+
+  Future<void> _handleReaction(int itemId, String reaction) async {
+    final current = _reactions[itemId];
+    final next = current == reaction ? null : reaction;
+    setState(() => _reactions[itemId] = next);
+    final api = ref.read(briefingApiProvider);
+    try {
+      if (next == null) {
+        await api.deleteRssReaction(itemId);
+      } else {
+        await api.postRssReaction(itemId, reaction);
+      }
+    } catch (_) {
+      setState(() => _reactions[itemId] = current);
+    }
+  }
+
+  Future<void> _toggleVoiceMode() async {
+    final voice = ref.read(voiceProvider);
+    if (voice.voiceModeActive) {
+      ref.read(voiceProvider.notifier).exitVoiceMode();
+      return;
+    }
+    await ref.read(voiceProvider.notifier).enterVoiceMode(
+      onTranscript: (transcript) async {
+        await ref.read(briefingProvider.notifier).sendReply(transcript);
+      },
+      enableTts: true,
+      onError: (msg) {
+        if (mounted) {
+          ScaffoldMessenger.of(context)
+              .showSnackBar(SnackBar(content: Text(msg)));
+        }
+      },
+    );
+  }
+
+  Future<void> _refresh() async {
+    setState(() => _refreshing = true);
+    try {
+      await ref.read(briefingProvider.notifier).refresh('compilation');
+    } catch (_) {
+      if (mounted) {
+        ScaffoldMessenger.of(context).showSnackBar(
+          const SnackBar(content: Text('Could not generate briefing.')),
+        );
+      }
+    } finally {
+      if (mounted) setState(() => _refreshing = false);
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final briefingAsync = ref.watch(briefingProvider);
+    final isStreaming = ref.watch(isBriefingStreamingProvider);
+    final voiceState = ref.watch(voiceProvider);
+    final scheme = Theme.of(context).colorScheme;
+
+    // Scroll to bottom when messages change
+    ref.listen(briefingProvider, (prev, next) => _scrollToBottom());
+
+    // Feed streaming assistant content to VoiceNotifier for TTS.
+    ref.listen(briefingProvider, (prev, next) {
+      if (!voiceState.voiceModeActive) return;
+      final conv = next.value;
+      if (conv == null || conv.messages.isEmpty) return;
+      final last = conv.messages.last;
+      if (last.role != MessageRole.assistant) return;
+      final isComplete = last.status != 'generating';
+      ref
+          .read(voiceProvider.notifier)
+          .feedContent(last.content, isComplete: isComplete);
+    });
+
+    return Scaffold(
+      appBar: AppBar(
+        title: Column(
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
+            Text('Briefing', style: Theme.of(context).textTheme.titleLarge),
+            Text(
+              _todayLabel(),
+              style: Theme.of(context).textTheme.labelSmall?.copyWith(
+                    color: scheme.onSurfaceVariant,
+                  ),
+            ),
+          ],
+        ),
+        actions: [
+          if (_refreshing)
+            const Padding(
+              padding: EdgeInsets.symmetric(horizontal: 12),
+              child: SizedBox(
+                width: 20,
+                height: 20,
+                child: CircularProgressIndicator(strokeWidth: 2),
+              ),
+            )
+          else
+            IconButton(
+              icon: const Icon(Icons.refresh_outlined),
+              tooltip: 'Generate briefing',
+              onPressed: _refresh,
+            ),
+          PopupMenuButton<String>(
+            onSelected: (value) {
+              if (value == 'history') {
+                Navigator.of(context).push(MaterialPageRoute(
+                  builder: (_) => const BriefingHistoryScreen(),
+                ));
+              }
+            },
+            itemBuilder: (_) => const [
+              PopupMenuItem(
+                value: 'history',
+                child: Text('View past briefings'),
+              ),
+            ],
+          ),
+        ],
+      ),
+      body: briefingAsync.when(
+        loading: () => const Center(child: CircularProgressIndicator()),
+        error: (err, stack) => Center(
+          child: Column(
+            mainAxisSize: MainAxisSize.min,
+            children: [
+              const Text("Could not load today's briefing."),
+              const SizedBox(height: 12),
+              FilledButton.tonal(
+                onPressed: () => ref.invalidate(briefingProvider),
+                child: const Text('Retry'),
+              ),
+            ],
+          ),
+        ),
+        data: (conv) {
+          return Column(
+            children: [
+              Expanded(
+                child: CustomScrollView(
+                  controller: _scrollController,
+                  slivers: [
+                    if (conv.messages.isEmpty)
+                      SliverFillRemaining(
+                        child: Center(
+                          child: Column(
+                            mainAxisSize: MainAxisSize.min,
+                            children: [
+                              Text(
+                                'No briefing yet today.',
+                                style: Theme.of(context)
+                                    .textTheme
+                                    .bodyMedium
+                                    ?.copyWith(color: scheme.onSurfaceVariant),
+                              ),
+                              const SizedBox(height: 12),
+                              FilledButton.tonal(
+                                onPressed: _refresh,
+                                child: const Text('Generate now'),
+                              ),
+                            ],
+                          ),
+                        ),
+                      )
+                    else
+                      SliverPadding(
+                        padding: const EdgeInsets.symmetric(
+                            horizontal: 8, vertical: 8),
+                        sliver: SliverList.builder(
+                          itemCount: conv.messages.length,
+                          itemBuilder: (_, i) {
+                            final msg = conv.messages[i];
+                            return _BriefingMessageItem(
+                              message: msg,
+                              reactions: _reactions,
+                              onReaction: _handleReaction,
+                            );
+                          },
+                        ),
+                      ),
+                  ],
+                ),
+              ),
+
+              // Progress bar while streaming
+              if (isStreaming)
+                LinearProgressIndicator(
+                  minHeight: 2,
+                  color: scheme.primary,
+                ),
+
+              // Voice mode banner
+              if (voiceState.voiceModeActive)
+                Container(
+                  width: double.infinity,
+                  color: const Color(0xFFEF4444).withValues(alpha: 0.12),
+                  padding: const EdgeInsets.symmetric(
+                      horizontal: 16, vertical: 6),
+                  child: const Text(
+                    '🎤 Listening… tap mic to exit voice mode',
+                    style: TextStyle(
+                      fontSize: 12,
+                      color: Color(0xFFF87171),
+                    ),
+                  ),
+                ),
+              // Reply bar
+              const Divider(height: 1),
+              SafeArea(
+                child: Padding(
+                  padding: const EdgeInsets.fromLTRB(8, 6, 8, 6),
+                  child: Row(
+                    children: [
+                      Expanded(
+                        child: TextField(
+                          controller: _controller,
+                          decoration: InputDecoration(
+                            hintText: voiceState.voiceModeActive
+                                ? 'Listening…'
+                                : 'Reply to your briefing…',
+                            hintStyle: voiceState.voiceModeActive
+                                ? const TextStyle(fontStyle: FontStyle.italic)
+                                : null,
+                            border: const OutlineInputBorder(),
+                            isDense: true,
+                            contentPadding: const EdgeInsets.symmetric(
+                                horizontal: 12, vertical: 10),
+                          ),
+                          minLines: 1,
+                          maxLines: 4,
+                          textInputAction: TextInputAction.newline,
+                          enabled: !isStreaming && !voiceState.voiceModeActive,
+                        ),
+                      ),
+                      const SizedBox(width: 8),
+                      VoiceMicButton(
+                        mode: voiceState.mode,
+                        voiceModeActive: voiceState.voiceModeActive,
+                        onTap: _toggleVoiceMode,
+                      ),
+                      const SizedBox(width: 6),
+                      _GradientSendButton(
+                        onPressed: (isStreaming || voiceState.voiceModeActive)
+                            ? null
+                            : _sendReply,
+                        isStreaming: isStreaming,
+                      ),
+                    ],
+                  ),
+                ),
+              ),
+            ],
+          );
+        },
+      ),
+    );
+  }
+
+  String _todayLabel() {
+    final now = DateTime.now();
+    const days = [
+      'Monday', 'Tuesday', 'Wednesday', 'Thursday',
+      'Friday', 'Saturday', 'Sunday'
+    ];
+    const months = [
+      'January', 'February', 'March', 'April', 'May', 'June',
+      'July', 'August', 'September', 'October', 'November', 'December'
+    ];
+    return '${days[now.weekday - 1]}, ${months[now.month - 1]} ${now.day}';
+  }
+}
+
+/// Renders a single briefing message with optional WeatherCard above it
+/// and RSS reaction buttons below it (for assistant messages with metadata).
+class _BriefingMessageItem extends StatelessWidget {
+  final Message message;
+  final Map<int, String?> reactions;
+  final void Function(int itemId, String reaction) onReaction;
+
+  const _BriefingMessageItem({
+    required this.message,
+    required this.reactions,
+    required this.onReaction,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final meta = message.metadata;
+    final isAssistant = message.role == MessageRole.assistant;
+
+    // Weather: show card above when metadata.weather key is present (even if null value)
+    final bool hasWeatherKey = isAssistant && meta != null && meta.containsKey('weather');
+    final weatherData = hasWeatherKey ? meta['weather'] as Map<String, dynamic>? : null;
+
+    // RSS news cards
+    final rssItemsRaw = isAssistant && meta != null
+        ? (meta['rss_items'] as List<dynamic>?)?.cast<Map<String, dynamic>>() ?? []
+        : <Map<String, dynamic>>[];
+    final rssItems = rssItemsRaw.map(RssItemMeta.fromJson).toList();
+
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.stretch,
+      children: [
+        if (hasWeatherKey) WeatherCard(weather: weatherData),
+        ChatMessageBubble(message: message),
+        if (rssItems.isNotEmpty)
+          Padding(
+            padding: const EdgeInsets.fromLTRB(4, 4, 4, 4),
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.stretch,
+              children: rssItems.map((item) => NewsCard(
+                item: item,
+                reaction: reactions[item.id],
+                onReaction: onReaction,
+              )).toList(),
+            ),
+          ),
+      ],
+    );
+  }
+}
+
+
+class _GradientSendButton extends StatelessWidget {
+  final VoidCallback? onPressed;
+  final bool isStreaming;
+
+  const _GradientSendButton({
+    required this.onPressed,
+    required this.isStreaming,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final scheme = Theme.of(context).colorScheme;
+    final disabled = onPressed == null;
+
+    return DecoratedBox(
+      decoration: BoxDecoration(
+        gradient: disabled
+            ? null
+            : const LinearGradient(
+                begin: Alignment.topLeft,
+                end: Alignment.bottomRight,
+                colors: [Color(0xFF6366F1), Color(0xFF4F46E5)],
+              ),
+        color: disabled ? scheme.onSurface.withValues(alpha: 0.12) : null,
+        borderRadius: BorderRadius.circular(10),
+      ),
+      child: IconButton(
+        icon: isStreaming
+            ? const SizedBox(
+                width: 20,
+                height: 20,
+                child: CircularProgressIndicator(
+                  strokeWidth: 2,
+                  color: Colors.white,
+                ),
+              )
+            : Icon(
+                Icons.send,
+                color: disabled
+                    ? scheme.onSurface.withValues(alpha: 0.38)
+                    : Colors.white,
+              ),
+        onPressed: onPressed,
+      ),
+    );
+  }
+}

lib/screens/chat/chat_screen.dart

@@ -1,12 +1,12 @@
-import 'dart:math' show min;
-
 import 'package:flutter/material.dart';
-import 'package:flutter_markdown_plus/flutter_markdown_plus.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 
 import '../../core/exceptions.dart';
 import '../../data/models/message.dart';
 import '../../providers/chat_provider.dart';
+import '../../providers/voice_provider.dart';
+import '../../widgets/chat_message_bubble.dart';
+import '../../widgets/voice_mic_button.dart';
 
 class ChatScreen extends ConsumerStatefulWidget {
   final int conversationId;
@@ -24,6 +24,8 @@ class _ChatScreenState extends ConsumerState<ChatScreen> {
   void dispose() {
     _controller.dispose();
     _scrollController.dispose();
+    // Exit voice mode if the user navigates away mid-session.
+    ref.read(voiceProvider.notifier).exitVoiceMode();
     super.dispose();
   }
 
@@ -61,19 +63,55 @@ class _ChatScreenState extends ConsumerState<ChatScreen> {
     }
   }
 
+  Future<void> _toggleVoiceMode() async {
+    final voice = ref.read(voiceProvider);
+    if (voice.voiceModeActive) {
+      ref.read(voiceProvider.notifier).exitVoiceMode();
+      return;
+    }
+    await ref.read(voiceProvider.notifier).enterVoiceMode(
+      onTranscript: (transcript) async {
+        await ref
+            .read(messagesProvider(widget.conversationId).notifier)
+            .sendMessage(transcript);
+      },
+      enableTts: true,
+      onError: (msg) {
+        if (mounted) {
+          ScaffoldMessenger.of(context)
+              .showSnackBar(SnackBar(content: Text(msg)));
+        }
+      },
+    );
+  }
+
   @override
   Widget build(BuildContext context) {
     final messagesAsync = ref.watch(messagesProvider(widget.conversationId));
     final isStreaming = ref.watch(isStreamingProvider(widget.conversationId));
+    final voiceState = ref.watch(voiceProvider);
 
-    // Scroll when messages change
-    ref.listen(messagesProvider(widget.conversationId), (_, _) {
+    // Scroll when messages change.
+    ref.listen(messagesProvider(widget.conversationId), (prev, next) {
       _scrollToBottom();
     });
 
+    // Feed streaming content to VoiceNotifier for TTS.
+    ref.listen(messagesProvider(widget.conversationId), (prev, next) {
+      if (!voiceState.voiceModeActive) return;
+      final messages = next.value;
+      if (messages == null || messages.isEmpty) return;
+      final last = messages.last;
+      if (last.role != MessageRole.assistant) return;
+      final isComplete = last.status != 'generating';
+      ref
+          .read(voiceProvider.notifier)
+          .feedContent(last.content, isComplete: isComplete);
+    });
+
     final convTitle = ref
         .watch(conversationsProvider)
-        .valueOrNull
+        .value
         ?.where((c) => c.id == widget.conversationId)
         .firstOrNull
         ?.title;
@@ -88,7 +126,7 @@ class _ChatScreenState extends ConsumerState<ChatScreen> {
             child: messagesAsync.when(
               loading: () =>
                   const Center(child: CircularProgressIndicator()),
-              error: (_, _) => const Center(
+              error: (err, stack) => const Center(
                 child: Text('Could not load messages.'),
               ),
               data: (messages) {
@@ -102,11 +140,26 @@ class _ChatScreenState extends ConsumerState<ChatScreen> {
                       horizontal: 8, vertical: 12),
                   itemCount: messages.length,
                   itemBuilder: (context, i) =>
-                      _MessageBubble(message: messages[i]),
+                      ChatMessageBubble(message: messages[i]),
                 );
               },
             ),
           ),
+          // Voice mode banner
+          if (voiceState.voiceModeActive)
+            Container(
+              width: double.infinity,
+              color: const Color(0xFFEF4444).withValues(alpha: 0.12),
+              padding:
+                  const EdgeInsets.symmetric(horizontal: 16, vertical: 6),
+              child: const Text(
+                '🎤 Listening… tap mic to exit voice mode',
+                style: TextStyle(
+                  fontSize: 12,
+                  color: Color(0xFFF87171),
+                ),
+              ),
+            ),
           const Divider(height: 1),
           SafeArea(
             child: Padding(
@@ -117,23 +170,36 @@ class _ChatScreenState extends ConsumerState<ChatScreen> {
                   Expanded(
                     child: TextField(
                       controller: _controller,
-                      decoration: const InputDecoration(
-                        hintText: 'Message...',
-                        border: OutlineInputBorder(),
+                      decoration: InputDecoration(
+                        hintText: voiceState.voiceModeActive
+                            ? 'Listening…'
+                            : 'Message…',
+                        hintStyle: voiceState.voiceModeActive
+                            ? const TextStyle(fontStyle: FontStyle.italic)
+                            : null,
+                        border: const OutlineInputBorder(),
                         isDense: true,
-                        contentPadding: EdgeInsets.symmetric(
+                        contentPadding: const EdgeInsets.symmetric(
                             horizontal: 12, vertical: 10),
                       ),
                       maxLines:
                           MediaQuery.of(context).size.width >= 600 ? 2 : 4,
                       minLines: 1,
                       textInputAction: TextInputAction.newline,
-                      enabled: !isStreaming,
+                      enabled: !isStreaming && !voiceState.voiceModeActive,
                     ),
                   ),
                   const SizedBox(width: 8),
+                  VoiceMicButton(
+                    mode: voiceState.mode,
+                    voiceModeActive: voiceState.voiceModeActive,
+                    onTap: _toggleVoiceMode,
+                  ),
+                  const SizedBox(width: 6),
                   IconButton.filled(
-                    onPressed: isStreaming ? null : _send,
+                    onPressed: (isStreaming || voiceState.voiceModeActive)
+                        ? null
+                        : _send,
                     icon: isStreaming
                         ? const SizedBox(
                             width: 20,
@@ -152,43 +218,3 @@ class _ChatScreenState extends ConsumerState<ChatScreen> {
     );
   }
 }
-
-class _MessageBubble extends StatelessWidget {
-  final Message message;
-  const _MessageBubble({required this.message});
-
-  @override
-  Widget build(BuildContext context) {
-    final isUser = message.role == MessageRole.user;
-    final scheme = Theme.of(context).colorScheme;
-
-    return Align(
-      alignment: isUser ? Alignment.centerRight : Alignment.centerLeft,
-      child: Container(
-        constraints: BoxConstraints(
-          maxWidth: min(MediaQuery.of(context).size.width * 0.8, 480),
-        ),
-        margin: const EdgeInsets.symmetric(vertical: 4),
-        padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
-        decoration: BoxDecoration(
-          color: isUser ? scheme.primary : scheme.surfaceContainerHighest,
-          borderRadius: BorderRadius.only(
-            topLeft: const Radius.circular(16),
-            topRight: const Radius.circular(16),
-            bottomLeft: Radius.circular(isUser ? 16 : 4),
-            bottomRight: Radius.circular(isUser ? 4 : 16),
-          ),
-        ),
-        child: isUser
-            ? Text(
-                message.content,
-                style: TextStyle(color: scheme.onPrimary),
-              )
-            : MarkdownBody(
-                data: message.content.isEmpty ? '...' : message.content,
-                styleSheet: MarkdownStyleSheet.fromTheme(Theme.of(context)),
-              ),
-      ),
-    );
-  }
-}

lib/screens/chat/conversations_list_screen.dart

@@ -1,185 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:go_router/go_router.dart';
-
-import '../../core/constants.dart';
-import '../../core/exceptions.dart';
-import '../../providers/chat_provider.dart';
-import 'chat_screen.dart';
-
-class ConversationsListScreen extends ConsumerStatefulWidget {
-  const ConversationsListScreen({super.key});
-
-  @override
-  ConsumerState<ConversationsListScreen> createState() =>
-      _ConversationsListScreenState();
-}
-
-class _ConversationsListScreenState
-    extends ConsumerState<ConversationsListScreen> {
-  int? _selectedConvId;
-
-  Future<void> _newConversation(bool isWide) async {
-    try {
-      final conv = await ref.read(conversationsProvider.notifier).create('');
-      if (!mounted) return;
-      if (isWide) {
-        setState(() => _selectedConvId = conv.id);
-      } else {
-        context.push(Routes.chat.replaceFirst(':id', '${conv.id}'));
-      }
-    } on AppException catch (e) {
-      if (mounted) {
-        ScaffoldMessenger.of(context)
-            .showSnackBar(SnackBar(content: Text(e.message)));
-      }
-    }
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    final convsAsync = ref.watch(conversationsProvider);
-    final isWide = MediaQuery.of(context).size.width >= 600;
-
-    // Clear stale selection when switching to narrow mode.
-    if (!isWide && _selectedConvId != null) {
-      _selectedConvId = null;
-    }
-
-    return Scaffold(
-      body: isWide
-          ? Row(
-              children: [
-                SizedBox(
-                  width: 300,
-                  child: Column(
-                    children: [
-                      Expanded(child: _buildListPane(convsAsync, isWide)),
-                      const Divider(height: 1),
-                      ListTile(
-                        leading: const Icon(Icons.add),
-                        title: const Text('New conversation'),
-                        onTap: () => _newConversation(isWide),
-                      ),
-                    ],
-                  ),
-                ),
-                const VerticalDivider(width: 1),
-                Expanded(child: _buildDetailPane()),
-              ],
-            )
-          : _buildListPane(convsAsync, isWide),
-      floatingActionButton: isWide
-          ? null
-          : FloatingActionButton(
-              heroTag: 'chat_fab',
-              onPressed: () => _newConversation(isWide),
-              child: const Icon(Icons.add),
-            ),
-    );
-  }
-
-  Widget _buildDetailPane() {
-    if (_selectedConvId == null) {
-      return const Center(child: Text('Select a conversation to open it.'));
-    }
-    return ChatScreen(
-      key: ValueKey(_selectedConvId),
-      conversationId: _selectedConvId!,
-    );
-  }
-
-  Widget _buildListPane(AsyncValue convsAsync, bool isWide) {
-    return convsAsync.when(
-      loading: () => const Center(child: CircularProgressIndicator()),
-      error: (_, _) => Center(
-        child: Column(
-          mainAxisSize: MainAxisSize.min,
-          children: [
-            const Icon(Icons.cloud_off, size: 48),
-            const SizedBox(height: 12),
-            const Text('Could not load conversations.'),
-            const SizedBox(height: 4),
-            TextButton(
-              onPressed: () => ref.invalidate(conversationsProvider),
-              child: const Text('Retry'),
-            ),
-          ],
-        ),
-      ),
-      data: (convs) {
-        if (convs.isEmpty) {
-          return const Center(
-              child: Text('No conversations yet. Tap + to start one.'));
-        }
-        return RefreshIndicator(
-          onRefresh: () => ref.refresh(conversationsProvider.future),
-          child: ListView.separated(
-            itemCount: convs.length,
-            separatorBuilder: (_, _) => const Divider(height: 1),
-            itemBuilder: (context, i) {
-              final conv = convs[i];
-              return ListTile(
-                leading: const Icon(Icons.chat_bubble_outline),
-                title: Text(
-                  conv.title.isNotEmpty ? conv.title : 'New conversation',
-                ),
-                subtitle: Text(
-                  conv.updatedAt.toLocal().toString().substring(0, 16),
-                  style: Theme.of(context).textTheme.bodySmall?.copyWith(
-                        color: Theme.of(context).colorScheme.onSurfaceVariant,
-                      ),
-                ),
-                selected: isWide && _selectedConvId == conv.id,
-                selectedTileColor:
-                    Theme.of(context).colorScheme.secondaryContainer,
-                onTap: () {
-                  if (isWide) {
-                    setState(() => _selectedConvId = conv.id);
-                  } else {
-                    context.push(
-                      Routes.chat.replaceFirst(':id', '${conv.id}'),
-                    );
-                  }
-                },
-                onLongPress: () async {
-                  final confirm = await showDialog<bool>(
-                    context: context,
-                    builder: (dialogContext) => AlertDialog(
-                      title: const Text('Delete conversation?'),
-                      content: Text(
-                        conv.title.isNotEmpty
-                            ? conv.title
-                            : 'New conversation',
-                      ),
-                      actions: [
-                        TextButton(
-                          onPressed: () =>
-                              Navigator.pop(dialogContext, false),
-                          child: const Text('Cancel'),
-                        ),
-                        TextButton(
-                          onPressed: () =>
-                              Navigator.pop(dialogContext, true),
-                          child: const Text('Delete'),
-                        ),
-                      ],
-                    ),
-                  );
-                  if (confirm == true) {
-                    await ref
-                        .read(conversationsProvider.notifier)
-                        .delete(conv.id);
-                    if (mounted && _selectedConvId == conv.id) {
-                      setState(() => _selectedConvId = null);
-                    }
-                  }
-                },
-              );
-            },
-          ),
-        );
-      },
-    );
-  }
-}

lib/screens/chat/conversations_tab_screen.dart

@@ -0,0 +1,126 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:go_router/go_router.dart';
+
+import '../../core/constants.dart';
+import '../../providers/chat_provider.dart';
+
+class ConversationsTabScreen extends ConsumerWidget {
+  const ConversationsTabScreen({super.key});
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final theme = Theme.of(context);
+    final convsAsync = ref.watch(conversationsProvider);
+
+    return Scaffold(
+      appBar: AppBar(
+        title: Text('Chat', style: theme.textTheme.titleLarge),
+        actions: [
+          IconButton(
+            icon: const Icon(Icons.add),
+            tooltip: 'New conversation',
+            onPressed: () async {
+              final conv = await ref
+                  .read(conversationsProvider.notifier)
+                  .create('New conversation');
+              if (context.mounted) {
+                context.push(Routes.chat.replaceFirst(':id', '${conv.id}'));
+              }
+            },
+          ),
+        ],
+      ),
+      body: convsAsync.when(
+        loading: () => const Center(child: CircularProgressIndicator()),
+        error: (e, _) => Center(child: Text('Error: $e')),
+        data: (convs) {
+          if (convs.isEmpty) {
+            return Center(
+              child: Column(
+                mainAxisSize: MainAxisSize.min,
+                children: [
+                  Icon(Icons.chat_bubble_outline,
+                      size: 48, color: theme.colorScheme.onSurfaceVariant),
+                  const SizedBox(height: 16),
+                  Text('No conversations yet',
+                      style: theme.textTheme.titleMedium),
+                  const SizedBox(height: 8),
+                  FilledButton.icon(
+                    icon: const Icon(Icons.add),
+                    label: const Text('Start a conversation'),
+                    onPressed: () async {
+                      final conv = await ref
+                          .read(conversationsProvider.notifier)
+                          .create('New conversation');
+                      if (context.mounted) {
+                        context.push(
+                            Routes.chat.replaceFirst(':id', '${conv.id}'));
+                      }
+                    },
+                  ),
+                ],
+              ),
+            );
+          }
+          return RefreshIndicator(
+            onRefresh: () async => ref.invalidate(conversationsProvider),
+            child: ListView.builder(
+              itemCount: convs.length,
+              itemBuilder: (ctx, i) {
+                final c = convs[i];
+                return ListTile(
+                  leading: const Icon(Icons.chat_bubble_outline),
+                  title: Text(c.title,
+                      maxLines: 1, overflow: TextOverflow.ellipsis),
+                  subtitle: Text(
+                    _relativeTime(c.updatedAt),
+                    style: theme.textTheme.labelSmall,
+                  ),
+                  trailing: IconButton(
+                    icon: const Icon(Icons.delete_outline),
+                    onPressed: () =>
+                        _confirmDelete(context, ref, c.id, c.title),
+                  ),
+                  onTap: () =>
+                      ctx.push(Routes.chat.replaceFirst(':id', '${c.id}')),
+                );
+              },
+            ),
+          );
+        },
+      ),
+    );
+  }
+
+  Future<void> _confirmDelete(
+      BuildContext context, WidgetRef ref, int id, String title) async {
+    final ok = await showDialog<bool>(
+      context: context,
+      builder: (_) => AlertDialog(
+        title: const Text('Delete conversation?'),
+        content: Text('"$title" will be permanently deleted.'),
+        actions: [
+          TextButton(
+              onPressed: () => Navigator.pop(context, false),
+              child: const Text('Cancel')),
+          FilledButton(
+              onPressed: () => Navigator.pop(context, true),
+              child: const Text('Delete')),
+        ],
+      ),
+    );
+    if (ok == true) {
+      await ref.read(conversationsProvider.notifier).delete(id);
+    }
+  }
+}
+
+String _relativeTime(DateTime dt) {
+  final diff = DateTime.now().difference(dt);
+  if (diff.inMinutes < 1) return 'just now';
+  if (diff.inHours < 1) return '${diff.inMinutes}m ago';
+  if (diff.inDays < 1) return '${diff.inHours}h ago';
+  if (diff.inDays < 7) return '${diff.inDays}d ago';
+  return '${dt.day}/${dt.month}/${dt.year}';
+}

lib/screens/knowledge/knowledge_screen.dart

@@ -0,0 +1,295 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:go_router/go_router.dart';
+
+import '../../providers/knowledge_provider.dart';
+import '../../widgets/knowledge_item_card.dart';
+
+// Type tab configuration: (label, noteType filter value)
+const _kTabs = [
+  (label: 'All', type: null),
+  (label: 'Notes', type: 'note'),
+  (label: 'People', type: 'person'),
+  (label: 'Places', type: 'place'),
+  (label: 'Lists', type: 'list'),
+  (label: 'Tasks', type: 'task'),
+];
+
+class KnowledgeScreen extends ConsumerStatefulWidget {
+  const KnowledgeScreen({super.key});
+
+  @override
+  ConsumerState<KnowledgeScreen> createState() => _KnowledgeScreenState();
+}
+
+class _KnowledgeScreenState extends ConsumerState<KnowledgeScreen>
+    with SingleTickerProviderStateMixin {
+  late final TabController _tabController;
+  late final ScrollController _scrollController;
+  bool _searchActive = false;
+  final _searchController = TextEditingController();
+  var _debounce = DateTime.now();
+
+  @override
+  void initState() {
+    super.initState();
+    _tabController = TabController(length: _kTabs.length, vsync: this);
+    _scrollController = ScrollController();
+    _scrollController.addListener(_onScroll);
+    // Trigger initial load
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      ref.read(knowledgeProvider.notifier).refresh();
+    });
+    _tabController.addListener(_onTabChanged);
+  }
+
+  @override
+  void dispose() {
+    _tabController.dispose();
+    _scrollController.dispose();
+    _searchController.dispose();
+    super.dispose();
+  }
+
+  void _onTabChanged() {
+    if (!_tabController.indexIsChanging) return;
+    final newType = _kTabs[_tabController.index].type;
+    ref.read(knowledgeProvider.notifier).setTypeFilter(newType);
+  }
+
+  void _onScroll() {
+    final pos = _scrollController.position;
+    if (pos.pixels >= pos.maxScrollExtent - 300) {
+      ref.read(knowledgeProvider.notifier).hydrateNext();
+    }
+  }
+
+  void _onSearchChanged(String q) {
+    final now = DateTime.now();
+    _debounce = now;
+    Future.delayed(const Duration(milliseconds: 400), () {
+      if (_debounce == now && mounted) {
+        ref.read(knowledgeProvider.notifier).setSearch(q);
+      }
+    });
+  }
+
+  String _tabLabel(int index, Map<String, int> counts) {
+    final tab = _kTabs[index];
+    if (tab.type == null) {
+      final total = counts.values.fold(0, (a, b) => a + b);
+      return total > 0 ? 'All ($total)' : 'All';
+    }
+    final count = counts[tab.type];
+    return count != null && count > 0 ? '${tab.label} ($count)' : tab.label;
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final state = ref.watch(knowledgeProvider);
+
+    return Scaffold(
+      appBar: AppBar(
+        title: _searchActive
+            ? TextField(
+                controller: _searchController,
+                autofocus: true,
+                decoration: const InputDecoration(
+                  hintText: 'Search knowledge…',
+                  border: InputBorder.none,
+                ),
+                onChanged: _onSearchChanged,
+              )
+            : const Text('Knowledge'),
+        actions: [
+          IconButton(
+            icon: Icon(_searchActive ? Icons.close : Icons.search),
+            onPressed: () {
+              setState(() => _searchActive = !_searchActive);
+              if (!_searchActive) {
+                _searchController.clear();
+                ref.read(knowledgeProvider.notifier).setSearch(null);
+              }
+            },
+          ),
+        ],
+        bottom: TabBar(
+          controller: _tabController,
+          isScrollable: true,
+          tabAlignment: TabAlignment.start,
+          tabs: List.generate(
+            _kTabs.length,
+            (i) => Tab(text: _tabLabel(i, state.counts)),
+          ),
+        ),
+      ),
+      body: Column(
+        children: [
+          // Tag filter chips
+          if (state.availableTags.isNotEmpty)
+            SizedBox(
+              height: 48,
+              child: ListView.separated(
+                scrollDirection: Axis.horizontal,
+                padding:
+                    const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
+                itemCount: state.availableTags.length,
+                separatorBuilder: (_, _) => const SizedBox(width: 6),
+                itemBuilder: (_, i) {
+                  final tag = state.availableTags[i];
+                  final active = state.activeTags.contains(tag);
+                  return FilterChip(
+                    label: Text(tag),
+                    selected: active,
+                    onSelected: (_) =>
+                        ref.read(knowledgeProvider.notifier).toggleTag(tag),
+                    visualDensity: VisualDensity.compact,
+                  );
+                },
+              ),
+            ),
+          // Main list
+          Expanded(
+            child: _buildList(state),
+          ),
+        ],
+      ),
+      floatingActionButton: FloatingActionButton(
+        onPressed: () => _onFabTapped(context),
+        tooltip: 'New',
+        child: const Icon(Icons.edit_outlined),
+      ),
+    );
+  }
+
+  Widget _buildList(KnowledgeState state) {
+    if (state.isLoadingIds && state.ids.isEmpty) {
+      return const Center(child: CircularProgressIndicator());
+    }
+    if (state.error != null && state.ids.isEmpty) {
+      return Center(
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            Text('Failed to load',
+                style: Theme.of(context).textTheme.bodyLarge),
+            const SizedBox(height: 8),
+            TextButton(
+              onPressed: () =>
+                  ref.read(knowledgeProvider.notifier).refresh(),
+              child: const Text('Retry'),
+            ),
+          ],
+        ),
+      );
+    }
+    final items = state.orderedItems;
+    if (items.isEmpty && !state.isLoadingIds && !state.isLoadingBatch) {
+      return Center(
+        child: Text(
+          'No ${_kTabs[_tabController.index].label.toLowerCase()} yet.',
+          style: Theme.of(context).textTheme.bodyLarge,
+        ),
+      );
+    }
+    return RefreshIndicator(
+      onRefresh: () => ref.read(knowledgeProvider.notifier).refresh(),
+      child: ListView.separated(
+        controller: _scrollController,
+        itemCount: items.length + (state.isLoadingBatch ? 1 : 0),
+        separatorBuilder: (_, _) => const Divider(height: 1),
+        itemBuilder: (_, i) {
+          if (i >= items.length) {
+            return const Padding(
+              padding: EdgeInsets.all(16),
+              child: Center(child: CircularProgressIndicator()),
+            );
+          }
+          return KnowledgeItemCard(item: items[i]);
+        },
+      ),
+    );
+  }
+
+  void _onFabTapped(BuildContext context) {
+    final currentType = _kTabs[_tabController.index].type;
+    if (currentType == 'task') {
+      context.push('/tasks/new');
+      return;
+    }
+    _showTypePicker(context);
+  }
+
+  void _showTypePicker(BuildContext context) {
+    showModalBottomSheet<void>(
+      context: context,
+      builder: (sheetContext) => SafeArea(
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            _TypePickerRow(
+              icon: Icons.description_outlined,
+              label: 'Note',
+              description: 'General note or document',
+              onTap: () {
+                Navigator.pop(sheetContext);
+                context.push('/notes/new', extra: {'noteType': 'note'});
+              },
+            ),
+            _TypePickerRow(
+              icon: Icons.person_outlined,
+              label: 'Person',
+              description: 'Contact, colleague, or reference person',
+              onTap: () {
+                Navigator.pop(sheetContext);
+                context.push('/notes/new', extra: {'noteType': 'person'});
+              },
+            ),
+            _TypePickerRow(
+              icon: Icons.place_outlined,
+              label: 'Place',
+              description: 'Location, venue, or place of interest',
+              onTap: () {
+                Navigator.pop(sheetContext);
+                context.push('/notes/new', extra: {'noteType': 'place'});
+              },
+            ),
+            _TypePickerRow(
+              icon: Icons.checklist_outlined,
+              label: 'List',
+              description: 'Checklist or structured list',
+              onTap: () {
+                Navigator.pop(sheetContext);
+                context.push('/notes/new', extra: {'noteType': 'list'});
+              },
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+class _TypePickerRow extends StatelessWidget {
+  final IconData icon;
+  final String label;
+  final String description;
+  final VoidCallback onTap;
+
+  const _TypePickerRow({
+    required this.icon,
+    required this.label,
+    required this.description,
+    required this.onTap,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return ListTile(
+      leading: Icon(icon),
+      title: Text(label),
+      subtitle: Text(description),
+      onTap: onTap,
+    );
+  }
+}

lib/screens/library/project_tasks_screen.dart

@@ -0,0 +1,389 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:go_router/go_router.dart';
+
+import '../../core/constants.dart';
+import '../../data/models/milestone.dart';
+import '../../data/models/project.dart';
+import '../../data/models/task.dart';
+import '../../providers/api_client_provider.dart';
+import '../../providers/milestones_provider.dart';
+import '../../providers/projects_provider.dart';
+import '../../providers/tasks_provider.dart';
+
+class ProjectTasksScreen extends ConsumerStatefulWidget {
+  final int projectId;
+  const ProjectTasksScreen({super.key, required this.projectId});
+
+  @override
+  ConsumerState<ProjectTasksScreen> createState() => _ProjectTasksScreenState();
+}
+
+class _ProjectTasksScreenState extends ConsumerState<ProjectTasksScreen> {
+  // Local optimistic status overrides — avoids a reload flash on every cycle tap.
+  final Map<int, TaskStatus> _pendingStatus = {};
+
+  TaskStatus _effectiveStatus(Task task) =>
+      _pendingStatus[task.id] ?? task.status;
+
+  TaskStatus _nextStatus(TaskStatus s) => switch (s) {
+        TaskStatus.todo => TaskStatus.inProgress,
+        TaskStatus.inProgress => TaskStatus.done,
+        TaskStatus.done => TaskStatus.todo,
+      };
+
+  Future<void> _cycleStatus(Task task) async {
+    final current = _effectiveStatus(task);
+    final next = _nextStatus(current);
+    setState(() => _pendingStatus[task.id] = next);
+    try {
+      await ref
+          .read(tasksRepositoryProvider)
+          .update(task.id, {'status': next.value});
+      // Sync the global tasks list so the library view stays consistent.
+      ref.invalidate(tasksProvider);
+    } catch (_) {
+      // Revert optimistic change on error.
+      setState(() => _pendingStatus.remove(task.id));
+    }
+  }
+
+  Color _parseColor(String? hex) {
+    if (hex == null || hex.isEmpty) return const Color(0xFF6366F1);
+    try {
+      return Color(int.parse(hex.replaceFirst('#', '0xFF')));
+    } catch (_) {
+      return const Color(0xFF6366F1);
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final tasksAsync = ref.watch(projectTasksProvider(widget.projectId));
+    final milestonesAsync = ref.watch(projectMilestonesProvider(widget.projectId));
+    final project = ref.watch(projectsProvider).value
+        ?.whereType<Project>()
+        .where((p) => p.id == widget.projectId)
+        .firstOrNull;
+
+    final color = _parseColor(project?.color);
+
+    return Scaffold(
+      appBar: AppBar(
+        title: Column(
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
+            Text(
+              project?.title ?? 'Project',
+              style: Theme.of(context).textTheme.titleLarge,
+            ),
+            if (project?.description?.isNotEmpty == true)
+              Text(
+                project!.description!,
+                style: Theme.of(context).textTheme.labelSmall?.copyWith(
+                      color: Theme.of(context).colorScheme.onSurfaceVariant,
+                    ),
+                maxLines: 1,
+                overflow: TextOverflow.ellipsis,
+              ),
+          ],
+        ),
+        actions: [
+          IconButton(
+            icon: const Icon(Icons.edit_outlined),
+            tooltip: 'Edit project',
+            onPressed: () =>
+                context.push('/projects/${widget.projectId}/edit'),
+          ),
+        ],
+      ),
+      body: tasksAsync.when(
+        loading: () => const Center(child: CircularProgressIndicator()),
+        error: (e, _) => Center(child: Text('Error loading tasks: $e')),
+        data: (tasks) => _buildBody(context, tasks, milestonesAsync, color),
+      ),
+    );
+  }
+
+  Widget _buildBody(
+    BuildContext context,
+    List<Task> tasks,
+    AsyncValue<List<Milestone>> milestonesAsync,
+    Color color,
+  ) {
+    final milestones = (milestonesAsync.value ?? []).toList()
+      ..sort((a, b) => a.orderIndex.compareTo(b.orderIndex));
+
+    // Group tasks by milestoneId.
+    final byMilestone = <int?, List<Task>>{};
+    for (final t in tasks) {
+      (byMilestone[t.milestoneId] ??= []).add(t);
+    }
+
+    final unassigned = byMilestone[null] ?? [];
+
+    if (tasks.isEmpty) {
+      return Center(
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            Icon(Icons.check_box_outlined,
+                size: 48,
+                color: Theme.of(context).colorScheme.onSurfaceVariant),
+            const SizedBox(height: 12),
+            Text(
+              'No tasks in this project yet.',
+              style: Theme.of(context).textTheme.bodyMedium?.copyWith(
+                    color: Theme.of(context).colorScheme.onSurfaceVariant,
+                  ),
+            ),
+          ],
+        ),
+      );
+    }
+
+    return RefreshIndicator(
+      onRefresh: () async {
+        setState(() => _pendingStatus.clear());
+        ref.invalidate(projectTasksProvider(widget.projectId));
+        ref.invalidate(projectMilestonesProvider(widget.projectId));
+      },
+      child: CustomScrollView(
+        slivers: [
+          // Top colour strip.
+          SliverToBoxAdapter(child: Container(height: 4, color: color)),
+
+          // Milestone sections.
+          for (final ms in milestones) ...[
+            SliverToBoxAdapter(
+              child: _MilestoneHeader(
+                milestone: ms,
+                tasks: byMilestone[ms.id] ?? [],
+                color: color,
+              ),
+            ),
+            if ((byMilestone[ms.id] ?? []).isNotEmpty)
+              SliverList.builder(
+                itemCount: byMilestone[ms.id]!.length,
+                itemBuilder: (_, i) {
+                  final task = byMilestone[ms.id]![i];
+                  return _TaskRow(
+                    task: task,
+                    effectiveStatus: _effectiveStatus(task),
+                    onStatusTap: () => _cycleStatus(task),
+                  );
+                },
+              ),
+          ],
+
+          // Unassigned tasks.
+          if (unassigned.isNotEmpty) ...[
+            SliverToBoxAdapter(
+              child: Padding(
+                padding: const EdgeInsets.fromLTRB(16, 20, 16, 6),
+                child: Text(
+                  'No milestone',
+                  style: Theme.of(context).textTheme.labelMedium?.copyWith(
+                        color: Theme.of(context).colorScheme.onSurfaceVariant,
+                        letterSpacing: 0.5,
+                      ),
+                ),
+              ),
+            ),
+            SliverList.builder(
+              itemCount: unassigned.length,
+              itemBuilder: (_, i) {
+                final task = unassigned[i];
+                return _TaskRow(
+                  task: task,
+                  effectiveStatus: _effectiveStatus(task),
+                  onStatusTap: () => _cycleStatus(task),
+                );
+              },
+            ),
+          ],
+
+          const SliverToBoxAdapter(child: SizedBox(height: 16)),
+        ],
+      ),
+    );
+  }
+}
+
+// ── Milestone section header ──────────────────────────────────────────────────
+
+class _MilestoneHeader extends StatelessWidget {
+  final Milestone milestone;
+  final List<Task> tasks;
+  final Color color;
+
+  const _MilestoneHeader({
+    required this.milestone,
+    required this.tasks,
+    required this.color,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final done = tasks.where((t) => t.status == TaskStatus.done).length;
+    final total = tasks.length;
+    final pct = total > 0 ? done / total : 0.0;
+
+    return Padding(
+      padding: const EdgeInsets.fromLTRB(16, 20, 16, 6),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          Row(
+            children: [
+              Container(
+                width: 10,
+                height: 10,
+                decoration: BoxDecoration(color: color, shape: BoxShape.circle),
+              ),
+              const SizedBox(width: 8),
+              Expanded(
+                child: Text(
+                  milestone.title,
+                  style: theme.textTheme.titleSmall,
+                  maxLines: 1,
+                  overflow: TextOverflow.ellipsis,
+                ),
+              ),
+              const SizedBox(width: 8),
+              Text(
+                '$done / $total',
+                style: theme.textTheme.labelSmall?.copyWith(
+                  color: theme.colorScheme.onSurfaceVariant,
+                ),
+              ),
+            ],
+          ),
+          if (total > 0) ...[
+            const SizedBox(height: 4),
+            LinearProgressIndicator(
+              value: pct,
+              minHeight: 2,
+              color: color,
+              backgroundColor: color.withValues(alpha: 0.15),
+              borderRadius: BorderRadius.circular(1),
+            ),
+          ],
+        ],
+      ),
+    );
+  }
+}
+
+// ── Task row ──────────────────────────────────────────────────────────────────
+
+class _TaskRow extends StatelessWidget {
+  final Task task;
+  final TaskStatus effectiveStatus;
+  final VoidCallback onStatusTap;
+
+  const _TaskRow({
+    required this.task,
+    required this.effectiveStatus,
+    required this.onStatusTap,
+  });
+
+  IconData get _statusIcon => switch (effectiveStatus) {
+        TaskStatus.done => Icons.check_circle,
+        TaskStatus.inProgress => Icons.timelapse,
+        TaskStatus.todo => Icons.radio_button_unchecked,
+      };
+
+  Color _statusColor(BuildContext context) {
+    final cs = Theme.of(context).colorScheme;
+    return switch (effectiveStatus) {
+      TaskStatus.done => const Color(0xFF22C55E),
+      TaskStatus.inProgress => cs.primary,
+      TaskStatus.todo => cs.onSurfaceVariant,
+    };
+  }
+
+  Color _priorityColor(BuildContext context) => switch (task.priority) {
+        TaskPriority.high => const Color(0xFFEF4444),
+        TaskPriority.medium => const Color(0xFFF59E0B),
+        _ => Colors.transparent,
+      };
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+
+    return Card(
+      margin: const EdgeInsets.symmetric(horizontal: 12, vertical: 3),
+      child: InkWell(
+        onTap: () => context
+            .push(Routes.taskEdit.replaceFirst(':id', '${task.id}')),
+        borderRadius: BorderRadius.circular(14),
+        child: Padding(
+          padding: const EdgeInsets.fromLTRB(4, 6, 14, 6),
+          child: Row(
+            children: [
+              IconButton(
+                icon: Icon(_statusIcon, color: _statusColor(context)),
+                onPressed: onStatusTap,
+                tooltip: 'Cycle status',
+                visualDensity: VisualDensity.compact,
+              ),
+              Expanded(
+                child: Column(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    Text(
+                      task.title.isNotEmpty ? task.title : 'Untitled',
+                      style: theme.textTheme.titleSmall?.copyWith(
+                        decoration: effectiveStatus == TaskStatus.done
+                            ? TextDecoration.lineThrough
+                            : null,
+                        color: effectiveStatus == TaskStatus.done
+                            ? theme.colorScheme.onSurfaceVariant
+                            : null,
+                      ),
+                      maxLines: 2,
+                      overflow: TextOverflow.ellipsis,
+                    ),
+                    if (task.dueDate != null) ...[
+                      const SizedBox(height: 2),
+                      Text(
+                        'Due ${_formatDate(task.dueDate!)}',
+                        style: theme.textTheme.labelSmall?.copyWith(
+                          color: task.dueDate!.isBefore(DateTime.now()) &&
+                                  effectiveStatus != TaskStatus.done
+                              ? const Color(0xFFEF4444)
+                              : theme.colorScheme.onSurfaceVariant,
+                        ),
+                      ),
+                    ],
+                  ],
+                ),
+              ),
+              if (task.priority == TaskPriority.high ||
+                  task.priority == TaskPriority.medium)
+                Container(
+                  width: 8,
+                  height: 8,
+                  decoration: BoxDecoration(
+                    color: _priorityColor(context),
+                    shape: BoxShape.circle,
+                  ),
+                ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+String _formatDate(DateTime dt) {
+  const months = [
+    'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
+    'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec',
+  ];
+  return '${months[dt.month - 1]} ${dt.day}';
+}

lib/screens/notes/note_detail_screen.dart

@@ -16,7 +16,7 @@ class NoteDetailScreen extends ConsumerWidget {
   @override
   Widget build(BuildContext context, WidgetRef ref) {
     final noteAsync = ref.watch(noteDetailProvider(noteId));
-    final allNotes = ref.watch(notesProvider).valueOrNull ?? [];
+    final allNotes = ref.watch(notesProvider).value ?? [];
 
     void navigateByTitle(String title) {
       final matches = allNotes.where(

lib/screens/notes/note_edit_screen.dart

@@ -11,7 +11,8 @@ import '../../widgets/project_selector.dart';
 
 class NoteEditScreen extends ConsumerStatefulWidget {
   final int? noteId;
-  const NoteEditScreen({super.key, this.noteId});
+  final String? noteType; // passed when creating a typed note from KnowledgeScreen
+  const NoteEditScreen({super.key, this.noteId, this.noteType});
 
   @override
   ConsumerState<NoteEditScreen> createState() => _NoteEditScreenState();
@@ -25,12 +26,14 @@ class _NoteEditScreenState extends ConsumerState<NoteEditScreen> {
   int? _projectId;
   bool _preview = false;
   bool _saving = false;
+  late String _noteType;
 
   late final Future<void> _initFuture;
 
   @override
   void initState() {
     super.initState();
+    _noteType = widget.noteType ?? 'note';
     _initFuture =
         widget.noteId != null ? _loadExisting() : Future.value();
   }
@@ -50,6 +53,7 @@ class _NoteEditScreenState extends ConsumerState<NoteEditScreen> {
     _contentController.text = note.body;
     _tags = List<String>.from(note.tags);
     _projectId = note.projectId;
+    _noteType = note.noteType;
   }
 
   void _addTag(String raw) {
@@ -108,6 +112,7 @@ class _NoteEditScreenState extends ConsumerState<NoteEditScreen> {
               body,
               tags: _tags,
               projectId: _projectId,
+              noteType: _noteType,
             );
         if (mounted) context.pop();
       } else {
@@ -118,6 +123,7 @@ class _NoteEditScreenState extends ConsumerState<NoteEditScreen> {
               tags: _tags,
               projectId: _projectId,
               clearProject: _projectId == null,
+              noteType: _noteType,
             );
         if (mounted) context.pop();
       }
@@ -138,7 +144,22 @@ class _NoteEditScreenState extends ConsumerState<NoteEditScreen> {
       builder: (context, snapshot) {
         return Scaffold(
           appBar: AppBar(
-            title: Text(widget.noteId == null ? 'New Note' : 'Edit Note'),
+            title: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                Text(widget.noteId == null ? 'New Note' : 'Edit Note'),
+                if (_noteType != 'note')
+                  Chip(
+                    label: Text(
+                      _noteType,
+                      style: const TextStyle(fontSize: 11),
+                    ),
+                    padding: EdgeInsets.zero,
+                    visualDensity: VisualDensity.compact,
+                    materialTapTargetSize: MaterialTapTargetSize.shrinkWrap,
+                  ),
+              ],
+            ),
             actions: [
               if (widget.noteId != null)
                 IconButton(

lib/screens/notes/notes_list_screen.dart

@@ -1,216 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:go_router/go_router.dart';
-
-import '../../core/constants.dart';
-import '../../data/models/note.dart';
-import '../../providers/notes_provider.dart';
-import 'note_detail_screen.dart';
-
-class NotesListScreen extends ConsumerStatefulWidget {
-  const NotesListScreen({super.key});
-
-  @override
-  ConsumerState<NotesListScreen> createState() => _NotesListScreenState();
-}
-
-class _NotesListScreenState extends ConsumerState<NotesListScreen> {
-  bool _showSearch = false;
-  String _search = '';
-  int? _selectedNoteId;
-
-  @override
-  Widget build(BuildContext context) {
-    final notesAsync = ref.watch(notesProvider);
-    final isWide = MediaQuery.of(context).size.width >= 600;
-
-    // Clear stale selection when switching to narrow mode.
-    if (!isWide && _selectedNoteId != null) {
-      _selectedNoteId = null;
-    }
-
-    return Scaffold(
-      body: isWide
-          ? Row(
-              children: [
-                SizedBox(
-                  width: 300,
-                  child: Column(
-                    children: [
-                      Expanded(child: _buildListPane(notesAsync, isWide)),
-                      const Divider(height: 1),
-                      ListTile(
-                        leading: const Icon(Icons.add),
-                        title: const Text('New note'),
-                        onTap: () => context.push(Routes.noteNew),
-                      ),
-                    ],
-                  ),
-                ),
-                const VerticalDivider(width: 1),
-                Expanded(child: _buildDetailPane()),
-              ],
-            )
-          : _buildListPane(notesAsync, isWide),
-      floatingActionButton: isWide
-          ? null
-          : FloatingActionButton(
-              heroTag: 'notes_fab',
-              onPressed: () => context.push(Routes.noteNew),
-              child: const Icon(Icons.add),
-            ),
-    );
-  }
-
-  Widget _buildDetailPane() {
-    if (_selectedNoteId == null) {
-      return const Center(child: Text('Select a note to read it.'));
-    }
-    return NoteDetailScreen(
-      key: ValueKey(_selectedNoteId),
-      noteId: _selectedNoteId!,
-      onDeleted: () => setState(() => _selectedNoteId = null),
-    );
-  }
-
-  Widget _buildListPane(AsyncValue<List<Note>> notesAsync, bool isWide) {
-    return Stack(
-      children: [
-        Column(
-          children: [
-            if (_showSearch)
-              Padding(
-                padding: const EdgeInsets.symmetric(horizontal: 4),
-                child: Row(
-                  children: [
-                    Expanded(
-                      child: TextField(
-                        autofocus: true,
-                        decoration: const InputDecoration(
-                          hintText: 'Search notes…',
-                          border: InputBorder.none,
-                          prefixIcon: Icon(Icons.search),
-                        ),
-                        onChanged: (v) =>
-                            setState(() => _search = v.trim().toLowerCase()),
-                      ),
-                    ),
-                    IconButton(
-                      icon: const Icon(Icons.close),
-                      tooltip: 'Close search',
-                      onPressed: () => setState(() {
-                        _showSearch = false;
-                        _search = '';
-                      }),
-                    ),
-                  ],
-                ),
-              ),
-            Expanded(
-              child: notesAsync.when(
-                loading: () =>
-                    const Center(child: CircularProgressIndicator()),
-                error: (_, _) => Center(
-                  child: Column(
-                    mainAxisSize: MainAxisSize.min,
-                    children: [
-                      const Icon(Icons.cloud_off, size: 48),
-                      const SizedBox(height: 12),
-                      const Text('Could not load notes.'),
-                      const SizedBox(height: 4),
-                      TextButton(
-                        onPressed: () => ref.invalidate(notesProvider),
-                        child: const Text('Retry'),
-                      ),
-                    ],
-                  ),
-                ),
-                data: (notes) {
-                  final filtered = _search.isEmpty
-                      ? notes
-                      : notes
-                          .where((n) =>
-                              n.title.toLowerCase().contains(_search) ||
-                              n.body.toLowerCase().contains(_search))
-                          .toList();
-
-                  if (filtered.isEmpty) {
-                    return Center(
-                      child: Text(
-                        _search.isEmpty
-                            ? 'No notes yet. Tap + to create one.'
-                            : 'No notes match "$_search".',
-                      ),
-                    );
-                  }
-
-                  return RefreshIndicator(
-                    onRefresh: () => ref.refresh(notesProvider.future),
-                    child: ListView.separated(
-                      itemCount: filtered.length,
-                      separatorBuilder: (_, _) => const Divider(height: 1),
-                      itemBuilder: (context, i) {
-                        final note = filtered[i];
-                        final preview = note.body
-                            .split('\n')
-                            .firstWhere((l) => l.trim().isNotEmpty,
-                                orElse: () => '')
-                            .trim();
-                        return ListTile(
-                          title: Text(note.title),
-                          subtitle: Text(
-                            preview.isNotEmpty
-                                ? preview
-                                : note.updatedAt
-                                    .toLocal()
-                                    .toString()
-                                    .substring(0, 16),
-                            style: Theme.of(context)
-                                .textTheme
-                                .bodySmall
-                                ?.copyWith(
-                                  color: Theme.of(context)
-                                      .colorScheme
-                                      .onSurfaceVariant,
-                                ),
-                            maxLines: 1,
-                            overflow: TextOverflow.ellipsis,
-                          ),
-                          selected: isWide && _selectedNoteId == note.id,
-                          selectedTileColor: Theme.of(context)
-                              .colorScheme
-                              .secondaryContainer,
-                          onTap: () {
-                            if (isWide) {
-                              setState(() => _selectedNoteId = note.id);
-                            } else {
-                              context.push(
-                                Routes.noteDetail
-                                    .replaceFirst(':id', '${note.id}'),
-                              );
-                            }
-                          },
-                        );
-                      },
-                    ),
-                  );
-                },
-              ),
-            ),
-          ],
-        ),
-        // Floating search button — only visible when search is closed.
-        if (!_showSearch)
-          Positioned(
-            top: 4,
-            right: 4,
-            child: IconButton(
-              icon: const Icon(Icons.search),
-              tooltip: 'Search',
-              onPressed: () => setState(() => _showSearch = true),
-            ),
-          ),
-      ],
-    );
-  }
-}

lib/screens/projects/project_edit_screen.dart

@@ -0,0 +1,164 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:go_router/go_router.dart';
+
+import '../../core/exceptions.dart';
+import '../../providers/projects_provider.dart';
+
+class ProjectEditScreen extends ConsumerStatefulWidget {
+  final int? projectId;
+  const ProjectEditScreen({super.key, this.projectId});
+
+  @override
+  ConsumerState<ProjectEditScreen> createState() => _ProjectEditScreenState();
+}
+
+class _ProjectEditScreenState extends ConsumerState<ProjectEditScreen> {
+  final _titleController = TextEditingController();
+  final _descController = TextEditingController();
+  final _goalController = TextEditingController();
+  String _status = 'active';
+  bool _saving = false;
+  late final Future<void> _initFuture;
+
+  @override
+  void initState() {
+    super.initState();
+    _initFuture =
+        widget.projectId != null ? _loadExisting() : Future.value();
+  }
+
+  @override
+  void dispose() {
+    _titleController.dispose();
+    _descController.dispose();
+    _goalController.dispose();
+    super.dispose();
+  }
+
+  Future<void> _loadExisting() async {
+    final projects = ref.read(projectsProvider).value ?? [];
+    final project =
+        projects.where((p) => p.id == widget.projectId).firstOrNull;
+    if (project != null) {
+      _titleController.text = project.title;
+      _descController.text = project.description ?? '';
+      _goalController.text = project.goal ?? '';
+      _status = project.status;
+    }
+  }
+
+  Future<void> _save() async {
+    final title = _titleController.text.trim();
+    if (title.isEmpty) {
+      ScaffoldMessenger.of(context).showSnackBar(
+          const SnackBar(content: Text('Title is required.')));
+      return;
+    }
+    setState(() => _saving = true);
+    try {
+      if (widget.projectId == null) {
+        await ref.read(projectsProvider.notifier).create(
+              title: title,
+              description: _descController.text.trim().isEmpty
+                  ? null
+                  : _descController.text.trim(),
+              goal: _goalController.text.trim().isEmpty
+                  ? null
+                  : _goalController.text.trim(),
+            );
+      } else {
+        await ref.read(projectsProvider.notifier).updateProject(
+              widget.projectId!,
+              {
+                'title': title,
+                'description': _descController.text.trim(),
+                'goal': _goalController.text.trim(),
+                'status': _status,
+              },
+            );
+      }
+      if (mounted) context.pop();
+    } on AppException catch (e) {
+      if (mounted) {
+        ScaffoldMessenger.of(context)
+            .showSnackBar(SnackBar(content: Text(e.message)));
+      }
+    } finally {
+      if (mounted) setState(() => _saving = false);
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return FutureBuilder(
+      future: _initFuture,
+      builder: (context, snapshot) => Scaffold(
+        appBar: AppBar(
+          title: Text(
+              widget.projectId == null ? 'New Project' : 'Edit Project'),
+          actions: [
+            IconButton(
+              icon: _saving
+                  ? const SizedBox(
+                      width: 20,
+                      height: 20,
+                      child: CircularProgressIndicator(strokeWidth: 2),
+                    )
+                  : const Icon(Icons.check),
+              onPressed: _saving ? null : _save,
+            ),
+          ],
+        ),
+        body: snapshot.connectionState == ConnectionState.waiting
+            ? const Center(child: CircularProgressIndicator())
+            : ListView(
+                padding: const EdgeInsets.all(16),
+                children: [
+                  TextField(
+                    controller: _titleController,
+                    decoration: const InputDecoration(
+                        labelText: 'Title *', border: OutlineInputBorder()),
+                    textInputAction: TextInputAction.next,
+                  ),
+                  const SizedBox(height: 12),
+                  TextField(
+                    controller: _descController,
+                    decoration: const InputDecoration(
+                        labelText: 'Description',
+                        border: OutlineInputBorder()),
+                    maxLines: 3,
+                    textInputAction: TextInputAction.next,
+                  ),
+                  const SizedBox(height: 12),
+                  TextField(
+                    controller: _goalController,
+                    decoration: const InputDecoration(
+                        labelText: 'Goal', border: OutlineInputBorder()),
+                    maxLines: 2,
+                    textInputAction: TextInputAction.done,
+                  ),
+                  if (widget.projectId != null) ...[
+                    const SizedBox(height: 12),
+                    DropdownButtonFormField<String>(
+                      initialValue: _status,
+                      decoration: const InputDecoration(
+                          labelText: 'Status',
+                          border: OutlineInputBorder()),
+                      items: const [
+                        DropdownMenuItem(
+                            value: 'active', child: Text('Active')),
+                        DropdownMenuItem(
+                            value: 'completed', child: Text('Completed')),
+                        DropdownMenuItem(
+                            value: 'archived', child: Text('Archived')),
+                      ],
+                      onChanged: (v) => setState(() => _status = v!),
+                    ),
+                  ],
+                ],
+              ),
+      ),
+    );
+  }
+}

lib/screens/projects/project_list_screen.dart

@@ -1,631 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:go_router/go_router.dart';
-
-import '../../core/constants.dart';
-import '../../core/exceptions.dart';
-import '../../data/models/milestone.dart';
-import '../../data/models/project.dart';
-import '../../data/models/task.dart';
-import '../../providers/milestones_provider.dart';
-import '../../providers/projects_provider.dart';
-import '../../providers/tasks_provider.dart';
-
-class ProjectListScreen extends ConsumerWidget {
-  const ProjectListScreen({super.key});
-
-  @override
-  Widget build(BuildContext context, WidgetRef ref) {
-    final projectsAsync = ref.watch(projectsProvider);
-
-    return Scaffold(
-      appBar: AppBar(title: const Text('Projects')),
-      floatingActionButton: FloatingActionButton(
-        onPressed: () => _showCreateDialog(context, ref),
-        tooltip: 'New project',
-        child: const Icon(Icons.add),
-      ),
-      body: projectsAsync.when(
-        loading: () => const Center(child: CircularProgressIndicator()),
-        error: (e, _) => Center(child: Text('Error: $e')),
-        data: (projects) {
-          if (projects.isEmpty) {
-            return const Center(
-              child: Text(
-                'No projects yet.\nTap + to create one.',
-                textAlign: TextAlign.center,
-              ),
-            );
-          }
-          final active =
-              projects.where((p) => p.status == 'active').toList();
-          final other =
-              projects.where((p) => p.status != 'active').toList();
-          return ListView(
-            padding: const EdgeInsets.only(bottom: 88),
-            children: [
-              if (active.isNotEmpty) ...[
-                _SectionHeader(title: 'Active (${active.length})'),
-                ...active.map((p) => _ProjectExpansionTile(project: p)),
-              ],
-              if (other.isNotEmpty) ...[
-                _SectionHeader(title: 'Other'),
-                ...other.map((p) => _ProjectExpansionTile(project: p)),
-              ],
-            ],
-          );
-        },
-      ),
-    );
-  }
-
-  void _showCreateDialog(BuildContext context, WidgetRef ref) {
-    showDialog<void>(
-      context: context,
-      builder: (dialogContext) => _CreateProjectDialog(
-        onCreate: (title, description, goal) async {
-          try {
-            await ref
-                .read(projectsProvider.notifier)
-                .create(title: title, description: description, goal: goal);
-          } on AppException catch (e) {
-            if (context.mounted) {
-              ScaffoldMessenger.of(context).showSnackBar(
-                SnackBar(content: Text(e.message)),
-              );
-            }
-          }
-        },
-      ),
-    );
-  }
-}
-
-// ─── Section header ────────────────────────────────────────────────────────────
-
-class _SectionHeader extends StatelessWidget {
-  final String title;
-  const _SectionHeader({required this.title});
-
-  @override
-  Widget build(BuildContext context) {
-    return Padding(
-      padding: const EdgeInsets.fromLTRB(16, 16, 16, 4),
-      child: Text(
-        title,
-        style: Theme.of(context)
-            .textTheme
-            .labelMedium
-            ?.copyWith(color: Theme.of(context).colorScheme.primary),
-      ),
-    );
-  }
-}
-
-// ─── Project expansion tile ────────────────────────────────────────────────────
-
-class _ProjectExpansionTile extends ConsumerStatefulWidget {
-  final Project project;
-  const _ProjectExpansionTile({required this.project});
-
-  @override
-  ConsumerState<_ProjectExpansionTile> createState() =>
-      _ProjectExpansionTileState();
-}
-
-class _ProjectExpansionTileState
-    extends ConsumerState<_ProjectExpansionTile> {
-  bool _expanded = false;
-
-  Color _statusColor(BuildContext context) => switch (widget.project.status) {
-        'completed' => Colors.green,
-        'archived' => Colors.grey,
-        _ => Theme.of(context).colorScheme.primary,
-      };
-
-  void _showOptions(BuildContext context) {
-    showModalBottomSheet<void>(
-      context: context,
-      builder: (_) => SafeArea(
-        child: Column(
-          mainAxisSize: MainAxisSize.min,
-          children: [
-            ListTile(
-              leading: const Icon(Icons.check_circle_outline),
-              title: const Text('Mark completed'),
-              onTap: () async {
-                Navigator.pop(context);
-                await ref.read(projectsProvider.notifier).updateProject(
-                  widget.project.id,
-                  {'status': 'completed'},
-                );
-              },
-            ),
-            ListTile(
-              leading: const Icon(Icons.archive_outlined),
-              title: const Text('Archive'),
-              onTap: () async {
-                Navigator.pop(context);
-                await ref.read(projectsProvider.notifier).updateProject(
-                  widget.project.id,
-                  {'status': 'archived'},
-                );
-              },
-            ),
-            ListTile(
-              leading: Icon(Icons.delete_outline,
-                  color: Theme.of(context).colorScheme.error),
-              title: Text('Delete',
-                  style: TextStyle(
-                      color: Theme.of(context).colorScheme.error)),
-              onTap: () async {
-                Navigator.pop(context);
-                final confirm = await showDialog<bool>(
-                  context: context,
-                  builder: (dialogContext) => AlertDialog(
-                    title: const Text('Delete project?'),
-                    content: const Text(
-                        'Notes and tasks will be unlinked, not deleted.'),
-                    actions: [
-                      TextButton(
-                        onPressed: () =>
-                            Navigator.pop(dialogContext, false),
-                        child: const Text('Cancel'),
-                      ),
-                      TextButton(
-                        onPressed: () =>
-                            Navigator.pop(dialogContext, true),
-                        child: const Text('Delete'),
-                      ),
-                    ],
-                  ),
-                );
-                if (confirm == true && context.mounted) {
-                  await ref
-                      .read(projectsProvider.notifier)
-                      .delete(widget.project.id);
-                }
-              },
-            ),
-          ],
-        ),
-      ),
-    );
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    final statusColor = _statusColor(context);
-    final tasksAsync = ref.watch(tasksProvider);
-    final unfinished = tasksAsync.valueOrNull
-            ?.where((t) =>
-                t.projectId == widget.project.id &&
-                t.status != TaskStatus.done)
-            .toList() ??
-        [];
-
-    final subtitle = unfinished.isEmpty
-        ? (widget.project.description != null &&
-                widget.project.description!.isNotEmpty
-            ? widget.project.description!
-            : null)
-        : '${unfinished.length} task${unfinished.length == 1 ? '' : 's'} in progress';
-
-    return ExpansionTile(
-      key: PageStorageKey('project-${widget.project.id}'),
-      initiallyExpanded: false,
-      onExpansionChanged: (v) => setState(() => _expanded = v),
-      leading: CircleAvatar(
-        backgroundColor: statusColor.withValues(alpha: 0.15),
-        child: Icon(Icons.folder_outlined, color: statusColor, size: 20),
-      ),
-      title: GestureDetector(
-        onLongPress: () => _showOptions(context),
-        child: Text(widget.project.title),
-      ),
-      subtitle: subtitle != null
-          ? Text(
-              subtitle,
-              maxLines: 1,
-              overflow: TextOverflow.ellipsis,
-              style: Theme.of(context).textTheme.bodySmall,
-            )
-          : null,
-      trailing: _StatusChip(status: widget.project.status),
-      children: [
-        if (_expanded)
-          _ProjectTaskList(
-            project: widget.project,
-            unfinishedTasks: unfinished,
-          ),
-      ],
-    );
-  }
-}
-
-// ─── Expanded task list grouped by milestone ───────────────────────────────────
-
-class _ProjectTaskList extends ConsumerWidget {
-  final Project project;
-  final List<Task> unfinishedTasks;
-  const _ProjectTaskList({
-    required this.project,
-    required this.unfinishedTasks,
-  });
-
-  @override
-  Widget build(BuildContext context, WidgetRef ref) {
-    final milestonesAsync =
-        ref.watch(projectMilestonesProvider(project.id));
-
-    return milestonesAsync.when(
-      loading: () => const Padding(
-        padding: EdgeInsets.all(16),
-        child: Center(child: CircularProgressIndicator(strokeWidth: 2)),
-      ),
-      error: (e, _) => Padding(
-        padding: const EdgeInsets.all(16),
-        child: Text('Error loading milestones: $e',
-            style: TextStyle(
-                color: Theme.of(context).colorScheme.error)),
-      ),
-      data: (milestones) {
-        // Only active milestones in order
-        final activeMilestones = milestones
-            .where((m) => m.status == 'active')
-            .toList()
-          ..sort((a, b) => a.orderIndex.compareTo(b.orderIndex));
-
-        if (unfinishedTasks.isEmpty) {
-          return _EmptyProjectContent(project: project);
-        }
-
-        // Build milestone → tasks map
-        final Map<int?, List<Task>> grouped = {};
-        for (final task in unfinishedTasks) {
-          grouped.putIfAbsent(task.milestoneId, () => []).add(task);
-        }
-
-        final widgets = <Widget>[];
-
-        // Milestone groups (in order)
-        for (final ms in activeMilestones) {
-          final tasks = grouped[ms.id];
-          if (tasks == null || tasks.isEmpty) continue;
-          widgets.add(_MilestoneHeader(milestone: ms));
-          for (final task in tasks) {
-            widgets.add(_TaskRow(task: task));
-          }
-        }
-
-        // No-milestone group
-        final noMilestoneTasks = grouped[null] ?? [];
-        if (noMilestoneTasks.isNotEmpty) {
-          if (activeMilestones.isNotEmpty) {
-            widgets.add(const _NoMilestoneHeader());
-          }
-          for (final task in noMilestoneTasks) {
-            widgets.add(_TaskRow(task: task));
-          }
-        }
-
-        widgets.add(_AddTaskRow(project: project));
-
-        return Column(
-          crossAxisAlignment: CrossAxisAlignment.stretch,
-          children: widgets,
-        );
-      },
-    );
-  }
-}
-
-class _EmptyProjectContent extends StatelessWidget {
-  final Project project;
-  const _EmptyProjectContent({required this.project});
-
-  @override
-  Widget build(BuildContext context) {
-    return Column(
-      children: [
-        Padding(
-          padding: const EdgeInsets.fromLTRB(16, 8, 16, 4),
-          child: Text(
-            'No open tasks.',
-            style: Theme.of(context).textTheme.bodySmall?.copyWith(
-                  color: Theme.of(context).colorScheme.outline,
-                ),
-          ),
-        ),
-        _AddTaskRow(project: project),
-      ],
-    );
-  }
-}
-
-// ─── Milestone header ──────────────────────────────────────────────────────────
-
-class _MilestoneHeader extends StatelessWidget {
-  final Milestone milestone;
-  const _MilestoneHeader({required this.milestone});
-
-  @override
-  Widget build(BuildContext context) {
-    final pct = milestone.total == 0 ? 0.0 : milestone.pct / 100.0;
-    final colorScheme = Theme.of(context).colorScheme;
-    return Padding(
-      padding: const EdgeInsets.fromLTRB(56, 12, 16, 2),
-      child: Column(
-        crossAxisAlignment: CrossAxisAlignment.start,
-        children: [
-          Row(
-            children: [
-              const Icon(Icons.flag_outlined, size: 14),
-              const SizedBox(width: 4),
-              Expanded(
-                child: Text(
-                  milestone.title,
-                  style: Theme.of(context).textTheme.labelSmall?.copyWith(
-                        color: colorScheme.secondary,
-                        fontWeight: FontWeight.w600,
-                      ),
-                ),
-              ),
-              Text(
-                '${milestone.completed}/${milestone.total}',
-                style: Theme.of(context).textTheme.labelSmall?.copyWith(
-                      color: colorScheme.outline,
-                    ),
-              ),
-            ],
-          ),
-          const SizedBox(height: 4),
-          LinearProgressIndicator(
-            value: pct,
-            minHeight: 3,
-            borderRadius: BorderRadius.circular(2),
-            backgroundColor:
-                colorScheme.secondaryContainer.withValues(alpha: 0.4),
-            valueColor:
-                AlwaysStoppedAnimation<Color>(colorScheme.secondary),
-          ),
-        ],
-      ),
-    );
-  }
-}
-
-class _NoMilestoneHeader extends StatelessWidget {
-  const _NoMilestoneHeader();
-
-  @override
-  Widget build(BuildContext context) {
-    return Padding(
-      padding: const EdgeInsets.fromLTRB(56, 12, 16, 2),
-      child: Text(
-        'No milestone',
-        style: Theme.of(context).textTheme.labelSmall?.copyWith(
-              color: Theme.of(context).colorScheme.outline,
-            ),
-      ),
-    );
-  }
-}
-
-// ─── Task row ──────────────────────────────────────────────────────────────────
-
-class _TaskRow extends StatelessWidget {
-  final Task task;
-  const _TaskRow({required this.task});
-
-  @override
-  Widget build(BuildContext context) {
-    final colorScheme = Theme.of(context).colorScheme;
-    final isInProgress = task.status == TaskStatus.inProgress;
-    final dotColor = isInProgress ? colorScheme.primary : colorScheme.outline;
-    final priorityColor = switch (task.priority) {
-      TaskPriority.high => Colors.red,
-      TaskPriority.medium => Colors.orange,
-      TaskPriority.low => Colors.blue,
-      _ => null,
-    };
-
-    return ListTile(
-      dense: true,
-      contentPadding: const EdgeInsets.fromLTRB(56, 0, 16, 0),
-      leading: Icon(
-        isInProgress ? Icons.radio_button_checked : Icons.radio_button_unchecked,
-        size: 18,
-        color: dotColor,
-      ),
-      title: Text(task.title, maxLines: 2, overflow: TextOverflow.ellipsis),
-      subtitle: task.dueDate != null
-          ? Text(
-              _formatDue(task.dueDate!),
-              style: TextStyle(
-                fontSize: 11,
-                color: _isDueOverdue(task.dueDate!)
-                    ? colorScheme.error
-                    : colorScheme.outline,
-              ),
-            )
-          : null,
-      trailing: priorityColor != null
-          ? Container(
-              width: 6,
-              height: 6,
-              decoration: BoxDecoration(
-                color: priorityColor,
-                shape: BoxShape.circle,
-              ),
-            )
-          : null,
-      onTap: () => context.push(
-        Routes.taskEdit.replaceFirst(':id', '${task.id}'),
-      ),
-    );
-  }
-
-  String _formatDue(DateTime due) {
-    final now = DateTime.now();
-    final diff = due.difference(DateTime(now.year, now.month, now.day)).inDays;
-    if (diff == 0) return 'Due today';
-    if (diff == 1) return 'Due tomorrow';
-    if (diff < 0) return 'Overdue ${(-diff)} day${(-diff) == 1 ? '' : 's'}';
-    if (diff < 7) return 'Due in $diff days';
-    return 'Due ${due.month}/${due.day}';
-  }
-
-  bool _isDueOverdue(DateTime due) {
-    final now = DateTime.now();
-    return due.isBefore(DateTime(now.year, now.month, now.day));
-  }
-}
-
-// ─── Add task row ──────────────────────────────────────────────────────────────
-
-class _AddTaskRow extends StatelessWidget {
-  final Project project;
-  const _AddTaskRow({required this.project});
-
-  @override
-  Widget build(BuildContext context) {
-    return Padding(
-      padding: const EdgeInsets.fromLTRB(48, 4, 16, 8),
-      child: TextButton.icon(
-        onPressed: () => context.push('${Routes.taskNew}?projectId=${project.id}'),
-        icon: const Icon(Icons.add, size: 16),
-        label: const Text('New task'),
-        style: TextButton.styleFrom(
-          foregroundColor: Theme.of(context).colorScheme.outline,
-          padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4),
-          textStyle: const TextStyle(fontSize: 13),
-        ),
-      ),
-    );
-  }
-}
-
-// ─── Status chip ───────────────────────────────────────────────────────────────
-
-class _StatusChip extends StatelessWidget {
-  final String status;
-  const _StatusChip({required this.status});
-
-  @override
-  Widget build(BuildContext context) {
-    final (label, color) = switch (status) {
-      'completed' => ('Done', Colors.green),
-      'archived' => ('Archived', Colors.grey),
-      _ => ('Active', Theme.of(context).colorScheme.primary),
-    };
-    return Chip(
-      label: Text(label, style: const TextStyle(fontSize: 11)),
-      padding: EdgeInsets.zero,
-      materialTapTargetSize: MaterialTapTargetSize.shrinkWrap,
-      side: BorderSide(color: color.withValues(alpha: 0.4)),
-      backgroundColor: color.withValues(alpha: 0.1),
-      labelStyle: TextStyle(color: color),
-    );
-  }
-}
-
-// ─── Create project dialog ─────────────────────────────────────────────────────
-
-class _CreateProjectDialog extends StatefulWidget {
-  final Future<void> Function(String title, String? description, String? goal)
-      onCreate;
-
-  const _CreateProjectDialog({required this.onCreate});
-
-  @override
-  State<_CreateProjectDialog> createState() => _CreateProjectDialogState();
-}
-
-class _CreateProjectDialogState extends State<_CreateProjectDialog> {
-  final _titleController = TextEditingController();
-  final _descController = TextEditingController();
-  final _goalController = TextEditingController();
-  bool _saving = false;
-
-  @override
-  void dispose() {
-    _titleController.dispose();
-    _descController.dispose();
-    _goalController.dispose();
-    super.dispose();
-  }
-
-  Future<void> _submit() async {
-    final title = _titleController.text.trim();
-    if (title.isEmpty) return;
-    setState(() => _saving = true);
-    try {
-      await widget.onCreate(
-        title,
-        _descController.text.trim().isEmpty ? null : _descController.text.trim(),
-        _goalController.text.trim().isEmpty ? null : _goalController.text.trim(),
-      );
-      if (mounted) Navigator.pop(context);
-    } finally {
-      if (mounted) setState(() => _saving = false);
-    }
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return AlertDialog(
-      title: const Text('New Project'),
-      content: Column(
-        mainAxisSize: MainAxisSize.min,
-        children: [
-          TextField(
-            controller: _titleController,
-            decoration: const InputDecoration(
-              labelText: 'Title',
-              border: OutlineInputBorder(),
-            ),
-            autofocus: true,
-            textInputAction: TextInputAction.next,
-          ),
-          const SizedBox(height: 12),
-          TextField(
-            controller: _descController,
-            decoration: const InputDecoration(
-              labelText: 'Description (optional)',
-              border: OutlineInputBorder(),
-            ),
-            maxLines: 2,
-            textInputAction: TextInputAction.next,
-          ),
-          const SizedBox(height: 12),
-          TextField(
-            controller: _goalController,
-            decoration: const InputDecoration(
-              labelText: 'Goal (optional)',
-              border: OutlineInputBorder(),
-            ),
-            textInputAction: TextInputAction.done,
-            onSubmitted: (_) => _submit(),
-          ),
-        ],
-      ),
-      actions: [
-        TextButton(
-          onPressed: () => Navigator.pop(context),
-          child: const Text('Cancel'),
-        ),
-        FilledButton(
-          onPressed: _saving ? null : _submit,
-          child: _saving
-              ? const SizedBox(
-                  width: 16,
-                  height: 16,
-                  child: CircularProgressIndicator(strokeWidth: 2),
-                )
-              : const Text('Create'),
-        ),
-      ],
-    );
-  }
-}

lib/screens/projects/projects_screen.dart

@@ -0,0 +1,89 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:go_router/go_router.dart';
+
+import '../../data/models/project.dart';
+import '../../providers/projects_provider.dart';
+
+class ProjectsScreen extends ConsumerWidget {
+  const ProjectsScreen({super.key});
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final projectsAsync = ref.watch(projectsProvider);
+    return Scaffold(
+      appBar: AppBar(title: const Text('Projects')),
+      body: projectsAsync.when(
+        loading: () => const Center(child: CircularProgressIndicator()),
+        error: (e, _) => Center(child: Text('Error: $e')),
+        data: (projects) => projects.isEmpty
+            ? const Center(child: Text('No projects yet.'))
+            : RefreshIndicator(
+                onRefresh: () async => ref.invalidate(projectsProvider),
+                child: ListView.separated(
+                  itemCount: projects.length,
+                  separatorBuilder: (_, _) => const Divider(height: 1),
+                  itemBuilder: (_, i) => _ProjectCard(project: projects[i]),
+                ),
+              ),
+      ),
+      floatingActionButton: FloatingActionButton(
+        onPressed: () => context.push('/projects/new'),
+        tooltip: 'New project',
+        child: const Icon(Icons.add),
+      ),
+    );
+  }
+}
+
+class _ProjectCard extends StatelessWidget {
+  final Project project;
+  const _ProjectCard({required this.project});
+
+  Color _statusColor(BuildContext context) => switch (project.status) {
+        'completed' => Colors.blue,
+        'archived' => Colors.grey,
+        _ => Theme.of(context).colorScheme.primary,
+      };
+
+  @override
+  Widget build(BuildContext context) {
+    return ListTile(
+      title: Text(project.title),
+      subtitle: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          if (project.description?.isNotEmpty == true)
+            Text(
+              project.description!,
+              maxLines: 1,
+              overflow: TextOverflow.ellipsis,
+            ),
+          if (project.goal?.isNotEmpty == true)
+            Text(
+              project.goal!,
+              maxLines: 1,
+              overflow: TextOverflow.ellipsis,
+              style: Theme.of(context)
+                  .textTheme
+                  .bodySmall
+                  ?.copyWith(fontStyle: FontStyle.italic),
+            ),
+        ],
+      ),
+      trailing: Chip(
+        label: Text(
+          project.status,
+          style: TextStyle(
+            fontSize: 11,
+            color: _statusColor(context),
+          ),
+        ),
+        padding: EdgeInsets.zero,
+        visualDensity: VisualDensity.compact,
+        materialTapTargetSize: MaterialTapTargetSize.shrinkWrap,
+      ),
+      onTap: () => context.push('/projects/${project.id}/tasks'),
+    );
+  }
+}

lib/screens/quick_capture/quick_capture_screen.dart

@@ -1,151 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:go_router/go_router.dart';
-
-import '../../core/exceptions.dart';
-import '../../providers/api_client_provider.dart';
-import '../../providers/notes_provider.dart';
-import '../../providers/tasks_provider.dart';
-
-class QuickCaptureScreen extends ConsumerStatefulWidget {
-  const QuickCaptureScreen({super.key});
-
-  @override
-  ConsumerState<QuickCaptureScreen> createState() =>
-      _QuickCaptureScreenState();
-}
-
-class _QuickCaptureScreenState extends ConsumerState<QuickCaptureScreen> {
-  final _controller = TextEditingController();
-  final _focusNode = FocusNode();
-  bool _loading = false;
-
-  @override
-  void dispose() {
-    _controller.dispose();
-    _focusNode.dispose();
-    super.dispose();
-  }
-
-  Future<void> _send() async {
-    final text = _controller.text.trim();
-    if (text.isEmpty) return;
-    setState(() => _loading = true);
-    try {
-      final result =
-          await ref.read(quickCaptureApiProvider).capture(text);
-      // Invalidate the relevant provider so the list screen re-fetches.
-      switch (result.type) {
-        case 'note':
-          ref.invalidate(notesProvider);
-        case 'task':
-        case 'todo':
-          ref.invalidate(tasksProvider);
-      }
-
-      if (mounted) {
-        // Use the server's human-readable message if available, else compose one.
-        final msg = result.message.isNotEmpty
-            ? result.message
-            : '${_typeLabel(result.type)} created: ${result.title}';
-        ScaffoldMessenger.of(context).showSnackBar(
-          SnackBar(
-            content: Text(msg),
-            behavior: SnackBarBehavior.floating,
-          ),
-        );
-        context.pop();
-      }
-    } on AppException catch (e) {
-      if (mounted) {
-        ScaffoldMessenger.of(context).showSnackBar(
-          SnackBar(
-            content: Text(e.message),
-            behavior: SnackBarBehavior.floating,
-          ),
-        );
-      }
-    } finally {
-      if (mounted) setState(() => _loading = false);
-    }
-  }
-
-  String _typeLabel(String type) => switch (type) {
-        'note' => 'Note',
-        'task' => 'Task',
-        'event' => 'Event',
-        'todo' => 'To-do',
-        _ => type,
-      };
-
-  @override
-  Widget build(BuildContext context) {
-    final theme = Theme.of(context);
-
-    return Scaffold(
-      appBar: AppBar(title: const Text('Quick Capture')),
-      body: Padding(
-        padding: const EdgeInsets.all(20),
-        child: Column(
-          crossAxisAlignment: CrossAxisAlignment.stretch,
-          children: [
-            Text(
-              'What\'s on your mind?',
-              style: theme.textTheme.titleMedium,
-            ),
-            const SizedBox(height: 4),
-            Text(
-              'Describe a note, task, event, or research item — Fabled will figure out the rest.',
-              style: theme.textTheme.bodySmall?.copyWith(
-                color: theme.colorScheme.onSurfaceVariant,
-              ),
-            ),
-            const SizedBox(height: 16),
-            TextField(
-              controller: _controller,
-              focusNode: _focusNode,
-              autofocus: true,
-              enabled: !_loading,
-              maxLines: 6,
-              minLines: 3,
-              keyboardType: TextInputType.multiline,
-              decoration: InputDecoration(
-                hintText:
-                    'e.g. "Remind me to call the dentist next Monday" or "Note: project meeting went well, key points were..."',
-                border: const OutlineInputBorder(),
-                alignLabelWithHint: true,
-                suffixIcon: _controller.text.isNotEmpty
-                    ? IconButton(
-                        icon: const Icon(Icons.clear),
-                        onPressed: () {
-                          _controller.clear();
-                          setState(() {});
-                        },
-                      )
-                    : null,
-              ),
-              onChanged: (_) => setState(() {}),
-            ),
-            const SizedBox(height: 16),
-            FilledButton.icon(
-              onPressed: (_loading || _controller.text.trim().isEmpty)
-                  ? null
-                  : _send,
-              icon: _loading
-                  ? const SizedBox(
-                      width: 18,
-                      height: 18,
-                      child: CircularProgressIndicator(
-                        strokeWidth: 2,
-                        color: Colors.white,
-                      ),
-                    )
-                  : const Icon(Icons.auto_awesome),
-              label: Text(_loading ? 'Processing...' : 'Capture'),
-            ),
-          ],
-        ),
-      ),
-    );
-  }
-}

lib/screens/splash/splash_screen.dart

@@ -30,7 +30,7 @@ class _SplashScreenState extends ConsumerState<SplashScreen> {
     if (!mounted) return;
     final status = ref.read(authProvider);
     if (status == AuthStatus.authenticated) {
-      context.go(Routes.notes);
+      context.go(Routes.briefing);
     } else {
       context.go(Routes.login);
     }

lib/screens/tasks/task_edit_screen.dart

@@ -4,7 +4,6 @@ import 'package:go_router/go_router.dart';
 
 import '../../core/constants.dart';
 import '../../core/exceptions.dart';
-import '../../data/api/tasks_api.dart';
 import '../../data/models/task.dart';
 import '../../providers/api_client_provider.dart';
 import '../../providers/tasks_provider.dart';
@@ -239,6 +238,7 @@ class _TaskEditScreenState extends ConsumerState<TaskEditScreen> {
                           ),
                           const SizedBox(height: 16),
                           DropdownButtonFormField<TaskStatus>(
+                            // ignore: deprecated_member_use
                             value: _status,
                             decoration: const InputDecoration(
                               labelText: 'Status',
@@ -253,6 +253,7 @@ class _TaskEditScreenState extends ConsumerState<TaskEditScreen> {
                           ),
                           const SizedBox(height: 16),
                           DropdownButtonFormField<TaskPriority>(
+                            // ignore: deprecated_member_use
                             value: _priority,
                             decoration: const InputDecoration(
                               labelText: 'Priority',

lib/screens/tasks/tasks_list_screen.dart

@@ -1,199 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:go_router/go_router.dart';
-
-import '../../core/constants.dart';
-import '../../data/models/task.dart';
-import '../../providers/tasks_provider.dart';
-
-class TasksListScreen extends ConsumerStatefulWidget {
-  const TasksListScreen({super.key});
-
-  @override
-  ConsumerState<TasksListScreen> createState() => _TasksListScreenState();
-}
-
-class _TasksListScreenState extends ConsumerState<TasksListScreen>
-    with SingleTickerProviderStateMixin {
-  late final TabController _tabs;
-  bool _showSearch = false;
-  String _search = '';
-
-  @override
-  void initState() {
-    super.initState();
-    _tabs = TabController(length: 3, vsync: this);
-  }
-
-  @override
-  void dispose() {
-    _tabs.dispose();
-    super.dispose();
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    final tasksAsync = ref.watch(tasksProvider);
-
-    return Scaffold(
-      body: Column(
-        children: [
-          // Search field — appears above the tabs when active
-          if (_showSearch)
-            Padding(
-              padding: const EdgeInsets.symmetric(horizontal: 4),
-              child: Row(
-                children: [
-                  Expanded(
-                    child: TextField(
-                      autofocus: true,
-                      decoration: const InputDecoration(
-                        hintText: 'Search tasks…',
-                        border: InputBorder.none,
-                        prefixIcon: Icon(Icons.search),
-                      ),
-                      onChanged: (v) =>
-                          setState(() => _search = v.trim().toLowerCase()),
-                    ),
-                  ),
-                  IconButton(
-                    icon: const Icon(Icons.close),
-                    tooltip: 'Close search',
-                    onPressed: () => setState(() {
-                      _showSearch = false;
-                      _search = '';
-                    }),
-                  ),
-                ],
-              ),
-            ),
-          // Tab bar row — search icon sits to the right of the tabs
-          Row(
-            children: [
-              Expanded(
-                child: TabBar(
-                  controller: _tabs,
-                  tabs: const [
-                    Tab(text: 'To Do'),
-                    Tab(text: 'In Progress'),
-                    Tab(text: 'Done'),
-                  ],
-                ),
-              ),
-              if (!_showSearch)
-                IconButton(
-                  icon: const Icon(Icons.search),
-                  tooltip: 'Search',
-                  onPressed: () => setState(() => _showSearch = true),
-                ),
-            ],
-          ),
-          // Content
-          Expanded(
-            child: tasksAsync.when(
-              loading: () => const Center(child: CircularProgressIndicator()),
-              error: (_, _) => Center(
-                child: Column(
-                  mainAxisSize: MainAxisSize.min,
-                  children: [
-                    const Icon(Icons.cloud_off, size: 48),
-                    const SizedBox(height: 12),
-                    const Text('Could not load tasks.'),
-                    const SizedBox(height: 4),
-                    TextButton(
-                      onPressed: () => ref.invalidate(tasksProvider),
-                      child: const Text('Retry'),
-                    ),
-                  ],
-                ),
-              ),
-              data: (tasks) {
-                final filtered = _search.isEmpty
-                    ? tasks
-                    : tasks
-                        .where((t) =>
-                            t.title.toLowerCase().contains(_search) ||
-                            (t.description ?? '')
-                                .toLowerCase()
-                                .contains(_search))
-                        .toList();
-
-                final todo = filtered
-                    .where((t) => t.status == TaskStatus.todo)
-                    .toList();
-                final inProgress = filtered
-                    .where((t) => t.status == TaskStatus.inProgress)
-                    .toList();
-                final done = filtered
-                    .where((t) => t.status == TaskStatus.done)
-                    .toList();
-
-                return RefreshIndicator(
-                  onRefresh: () => ref.refresh(tasksProvider.future),
-                  child: TabBarView(
-                    controller: _tabs,
-                    children: [
-                      _TaskList(tasks: todo, search: _search),
-                      _TaskList(tasks: inProgress, search: _search),
-                      _TaskList(tasks: done, search: _search),
-                    ],
-                  ),
-                );
-              },
-            ),
-          ),
-        ],
-      ),
-      floatingActionButton: FloatingActionButton(
-        heroTag: 'tasks_fab',
-        onPressed: () => context.push(Routes.taskNew),
-        child: const Icon(Icons.add),
-      ),
-    );
-  }
-}
-
-class _TaskList extends ConsumerWidget {
-  final List<Task> tasks;
-  final String search;
-  const _TaskList({required this.tasks, this.search = ''});
-
-  @override
-  Widget build(BuildContext context, WidgetRef ref) {
-    if (tasks.isEmpty) {
-      return Center(
-        child: Text(
-          search.isEmpty ? 'No tasks here.' : 'No tasks match "$search".',
-        ),
-      );
-    }
-    return ListView.separated(
-      itemCount: tasks.length,
-      separatorBuilder: (_, _) => const Divider(height: 1),
-      itemBuilder: (context, i) {
-        final task = tasks[i];
-        return ListTile(
-          leading: _priorityIcon(task.priority),
-          title: Text(task.title),
-          subtitle: task.dueDate != null
-              ? Text(
-                  'Due: ${task.dueDate!.toLocal().toString().substring(0, 10)}')
-              : null,
-          onTap: () => context.push(
-            Routes.taskEdit.replaceFirst(':id', '${task.id}'),
-          ),
-        );
-      },
-    );
-  }
-
-  Widget _priorityIcon(TaskPriority p) {
-    final color = switch (p) {
-      TaskPriority.high => Colors.red,
-      TaskPriority.medium => Colors.orange,
-      TaskPriority.low => Colors.green,
-      TaskPriority.none => Colors.grey,
-    };
-    return Icon(Icons.flag, color: color);
-  }
-}

lib/widgets/briefing_digest_card.dart

@@ -0,0 +1,133 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_markdown_plus/flutter_markdown_plus.dart';
+
+import '../data/models/message.dart';
+
+class BriefingDigestCard extends StatefulWidget {
+  /// The first assistant message from today's briefing, or null if none yet.
+  final Message? message;
+
+  /// Called when the user taps "Generate now".
+  final VoidCallback? onGenerateNow;
+
+  const BriefingDigestCard({
+    super.key,
+    required this.message,
+    this.onGenerateNow,
+  });
+
+  @override
+  State<BriefingDigestCard> createState() => _BriefingDigestCardState();
+}
+
+class _BriefingDigestCardState extends State<BriefingDigestCard> {
+  bool _expanded = false;
+
+  @override
+  Widget build(BuildContext context) {
+    final scheme = Theme.of(context).colorScheme;
+    final textTheme = Theme.of(context).textTheme;
+
+    return Card(
+      margin: const EdgeInsets.fromLTRB(12, 8, 12, 4),
+      elevation: 0,
+      shape: RoundedRectangleBorder(
+        borderRadius: BorderRadius.circular(14),
+        side: BorderSide(
+          color: scheme.outlineVariant.withValues(alpha: 0.5),
+          width: 1,
+        ),
+      ),
+      child: Padding(
+        padding: const EdgeInsets.all(16),
+        child: Column(
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
+            // Header row
+            Row(
+              children: [
+                Icon(Icons.wb_sunny_outlined, size: 18, color: scheme.primary),
+                const SizedBox(width: 8),
+                Text(
+                  _todayLabel(),
+                  style: textTheme.labelMedium?.copyWith(
+                    color: scheme.onSurfaceVariant,
+                  ),
+                ),
+              ],
+            ),
+            const SizedBox(height: 10),
+
+            // Body
+            if (widget.message == null) ...[
+              Text(
+                'No briefing yet today.',
+                style: textTheme.bodyMedium?.copyWith(
+                  color: scheme.onSurfaceVariant,
+                ),
+              ),
+              const SizedBox(height: 12),
+              if (widget.onGenerateNow != null)
+                FilledButton.tonal(
+                  onPressed: widget.onGenerateNow,
+                  child: const Text('Generate now'),
+                ),
+            ] else ...[
+              AnimatedSize(
+                duration: const Duration(milliseconds: 250),
+                curve: Curves.easeInOut,
+                alignment: Alignment.topCenter,
+                child: _expanded
+                    ? MarkdownBody(data: widget.message!.content)
+                    : _TruncatedMarkdown(
+                        data: widget.message!.content,
+                        maxLines: 5,
+                      ),
+              ),
+              const SizedBox(height: 8),
+              GestureDetector(
+                onTap: () => setState(() => _expanded = !_expanded),
+                child: Text(
+                  _expanded ? 'Show less ↑' : 'Show more ↓',
+                  style: TextStyle(
+                    color: scheme.primary,
+                    fontSize: 13,
+                    fontWeight: FontWeight.w500,
+                  ),
+                ),
+              ),
+            ],
+          ],
+        ),
+      ),
+    );
+  }
+
+  String _todayLabel() {
+    final now = DateTime.now();
+    const days = [
+      'Monday', 'Tuesday', 'Wednesday', 'Thursday',
+      'Friday', 'Saturday', 'Sunday'
+    ];
+    const months = [
+      'January', 'February', 'March', 'April', 'May', 'June',
+      'July', 'August', 'September', 'October', 'November', 'December'
+    ];
+    return '${days[now.weekday - 1]}, ${months[now.month - 1]} ${now.day}';
+  }
+}
+
+/// Renders Markdown truncated to [maxLines] visible lines.
+class _TruncatedMarkdown extends StatelessWidget {
+  final String data;
+  final int maxLines;
+  const _TruncatedMarkdown({required this.data, required this.maxLines});
+
+  @override
+  Widget build(BuildContext context) {
+    return ConstrainedBox(
+      constraints: BoxConstraints(maxHeight: maxLines * 20.0),
+      child: ClipRect(child: MarkdownBody(data: data)),
+    );
+  }
+}

lib/widgets/chat_message_bubble.dart

@@ -0,0 +1,79 @@
+import 'dart:math' show min;
+
+import 'package:flutter/material.dart';
+import 'package:flutter_markdown_plus/flutter_markdown_plus.dart';
+
+import '../data/models/message.dart';
+
+class ChatMessageBubble extends StatelessWidget {
+  final Message message;
+  const ChatMessageBubble({super.key, required this.message});
+
+  @override
+  Widget build(BuildContext context) {
+    final isUser = message.role == MessageRole.user;
+    final scheme = Theme.of(context).colorScheme;
+    final isGenerating = message.status == 'generating';
+
+    return Align(
+      alignment: isUser ? Alignment.centerRight : Alignment.centerLeft,
+      child: Container(
+        constraints: BoxConstraints(
+          maxWidth: min(MediaQuery.of(context).size.width * 0.82, 480),
+        ),
+        margin: const EdgeInsets.symmetric(vertical: 4, horizontal: 4),
+        decoration: isUser
+            ? BoxDecoration(
+                // Ghost style: transparent bg, thin border
+                color: Colors.transparent,
+                border: Border.all(
+                  color: scheme.primary.withValues(alpha: 0.35),
+                  width: 1,
+                ),
+                borderRadius: const BorderRadius.only(
+                  topLeft: Radius.circular(16),
+                  topRight: Radius.circular(16),
+                  bottomLeft: Radius.circular(16),
+                  bottomRight: Radius.circular(4),
+                ),
+              )
+            : BoxDecoration(
+                // Assistant: elevated surface + left accent border
+                color: scheme.surfaceContainerHighest,
+                border: Border(
+                  left: BorderSide(color: scheme.primary, width: 2),
+                ),
+                borderRadius: const BorderRadius.only(
+                  topLeft: Radius.circular(4),
+                  topRight: Radius.circular(16),
+                  bottomLeft: Radius.circular(4),
+                  bottomRight: Radius.circular(16),
+                ),
+              ),
+        child: Padding(
+          padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
+          child: isGenerating && message.content.isEmpty
+              ? SizedBox(
+                  width: 20,
+                  height: 20,
+                  child: CircularProgressIndicator(
+                    strokeWidth: 2,
+                    color: scheme.onSurfaceVariant,
+                  ),
+                )
+              : MarkdownBody(
+                  data: message.content.isEmpty ? '…' : message.content,
+                  styleSheet: MarkdownStyleSheet(
+                    p: TextStyle(
+                      color: isUser
+                          ? scheme.onSurface.withValues(alpha: 0.75)
+                          : scheme.onSurface,
+                      fontSize: 14,
+                    ),
+                  ),
+                ),
+        ),
+      ),
+    );
+  }
+}

lib/widgets/knowledge_item_card.dart

@@ -0,0 +1,95 @@
+import 'package:flutter/material.dart';
+import 'package:go_router/go_router.dart';
+
+import '../data/models/knowledge_item.dart';
+
+class KnowledgeItemCard extends StatelessWidget {
+  final KnowledgeItem item;
+  const KnowledgeItemCard({super.key, required this.item});
+
+  IconData get _icon => switch (item.noteType) {
+        'person' => Icons.person_outlined,
+        'place' => Icons.place_outlined,
+        'list' => Icons.checklist_outlined,
+        'task' => Icons.task_alt_outlined,
+        _ => Icons.description_outlined,
+      };
+
+  Color _statusColor(BuildContext context) {
+    if (item.noteType != 'task') return Theme.of(context).colorScheme.primary;
+    return switch (item.status) {
+      'done' => Colors.green,
+      'in_progress' => Colors.orange,
+      'cancelled' => Colors.grey,
+      _ => Theme.of(context).colorScheme.primary,
+    };
+  }
+
+  String? get _subtitle {
+    if (item.noteType == 'task') {
+      if (item.dueDate != null) return 'Due ${item.dueDate}';
+      return item.status;
+    }
+    if (item.body.trim().isEmpty) return null;
+    final preview = item.body.trim().replaceAll('\n', ' ');
+    return preview.length > 120 ? '${preview.substring(0, 120)}…' : preview;
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return ListTile(
+      leading: Icon(_icon, color: _statusColor(context)),
+      title: Text(
+        item.title.isEmpty ? '(untitled)' : item.title,
+        maxLines: 1,
+        overflow: TextOverflow.ellipsis,
+      ),
+      subtitle: _subtitle != null
+          ? Text(
+              _subtitle!,
+              maxLines: 2,
+              overflow: TextOverflow.ellipsis,
+              style: Theme.of(context).textTheme.bodySmall,
+            )
+          : null,
+      trailing: item.tags.isNotEmpty ? _TagChips(tags: item.tags) : null,
+      onTap: () {
+        if (item.noteType == 'task') {
+          context.push('/tasks/${item.id}/edit');
+        } else {
+          context.push('/notes/${item.id}');
+        }
+      },
+    );
+  }
+}
+
+class _TagChips extends StatelessWidget {
+  final List<String> tags;
+  const _TagChips({required this.tags});
+
+  @override
+  Widget build(BuildContext context) {
+    final shown = tags.take(2).toList();
+    final extra = tags.length - shown.length;
+    return Wrap(
+      spacing: 4,
+      children: [
+        for (final t in shown)
+          Chip(
+            label: Text(t, style: const TextStyle(fontSize: 10)),
+            padding: EdgeInsets.zero,
+            materialTapTargetSize: MaterialTapTargetSize.shrinkWrap,
+            visualDensity: VisualDensity.compact,
+          ),
+        if (extra > 0)
+          Chip(
+            label: Text('+$extra', style: const TextStyle(fontSize: 10)),
+            padding: EdgeInsets.zero,
+            materialTapTargetSize: MaterialTapTargetSize.shrinkWrap,
+            visualDensity: VisualDensity.compact,
+          ),
+      ],
+    );
+  }
+}

lib/widgets/news_card.dart

@@ -0,0 +1,184 @@
+import 'package:flutter/material.dart';
+import 'package:url_launcher/url_launcher.dart';
+
+class RssItemMeta {
+  final int id;
+  final String title;
+  final String url;
+  final String source;
+  final String snippet;
+  final DateTime? publishedAt;
+
+  const RssItemMeta({
+    required this.id,
+    required this.title,
+    required this.url,
+    required this.source,
+    required this.snippet,
+    this.publishedAt,
+  });
+
+  factory RssItemMeta.fromJson(Map<String, dynamic> json) => RssItemMeta(
+        id: json['id'] as int,
+        title: json['title'] as String? ?? '',
+        url: json['url'] as String? ?? '',
+        source: json['source'] as String? ?? '',
+        snippet: json['snippet'] as String? ?? '',
+        publishedAt: json['published_at'] != null
+            ? DateTime.tryParse(json['published_at'] as String)
+            : null,
+      );
+
+  String get relativeDate {
+    if (publishedAt == null) return '';
+    final diff = DateTime.now().difference(publishedAt!);
+    if (diff.inHours < 24) return '${diff.inHours}h ago';
+    if (diff.inHours < 48) return 'Yesterday';
+    return '${publishedAt!.month}/${publishedAt!.day}';
+  }
+}
+
+class NewsCard extends StatelessWidget {
+  final RssItemMeta item;
+  final String? reaction; // 'up' | 'down' | null
+  final void Function(int itemId, String reaction) onReaction;
+
+  const NewsCard({
+    super.key,
+    required this.item,
+    required this.reaction,
+    required this.onReaction,
+  });
+
+  Future<void> _openUrl() async {
+    if (item.url.isEmpty) return;
+    final uri = Uri.tryParse(item.url);
+    if (uri != null && await canLaunchUrl(uri)) {
+      await launchUrl(uri, mode: LaunchMode.externalApplication);
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final scheme = Theme.of(context).colorScheme;
+    final textTheme = Theme.of(context).textTheme;
+
+    return Card(
+      margin: const EdgeInsets.symmetric(vertical: 4),
+      elevation: 0,
+      shape: RoundedRectangleBorder(
+        borderRadius: BorderRadius.circular(10),
+        side: BorderSide(color: scheme.outlineVariant),
+      ),
+      child: Padding(
+        padding: const EdgeInsets.fromLTRB(12, 10, 12, 10),
+        child: Column(
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
+            // Source + date row
+            Row(
+              children: [
+                if (item.source.isNotEmpty)
+                  Text(
+                    item.source.toUpperCase(),
+                    style: textTheme.labelSmall?.copyWith(
+                      color: scheme.primary,
+                      fontWeight: FontWeight.w700,
+                      letterSpacing: 0.6,
+                    ),
+                  ),
+                if (item.source.isNotEmpty && item.relativeDate.isNotEmpty)
+                  Padding(
+                    padding: const EdgeInsets.only(left: 8),
+                    child: Text(
+                      item.relativeDate,
+                      style: textTheme.labelSmall?.copyWith(
+                        color: scheme.onSurfaceVariant,
+                      ),
+                    ),
+                  ),
+              ],
+            ),
+            const SizedBox(height: 4),
+            // Title — tappable if URL present
+            GestureDetector(
+              onTap: item.url.isNotEmpty ? _openUrl : null,
+              child: Text(
+                item.title,
+                style: textTheme.bodyMedium?.copyWith(
+                  fontWeight: FontWeight.w600,
+                  color: item.url.isNotEmpty ? scheme.primary : scheme.onSurface,
+                  decoration: item.url.isNotEmpty ? TextDecoration.underline : null,
+                  decorationColor: scheme.primary,
+                ),
+              ),
+            ),
+            // Snippet
+            if (item.snippet.isNotEmpty) ...[
+              const SizedBox(height: 4),
+              Text(
+                item.snippet,
+                maxLines: 2,
+                overflow: TextOverflow.ellipsis,
+                style: textTheme.bodySmall?.copyWith(
+                  color: scheme.onSurfaceVariant,
+                  height: 1.45,
+                ),
+              ),
+            ],
+            const SizedBox(height: 8),
+            // Reaction buttons
+            Row(
+              mainAxisSize: MainAxisSize.min,
+              children: [
+                _ReactionButton(
+                  emoji: '👍',
+                  active: reaction == 'up',
+                  onTap: () => onReaction(item.id, 'up'),
+                ),
+                const SizedBox(width: 6),
+                _ReactionButton(
+                  emoji: '👎',
+                  active: reaction == 'down',
+                  onTap: () => onReaction(item.id, 'down'),
+                ),
+              ],
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+class _ReactionButton extends StatelessWidget {
+  final String emoji;
+  final bool active;
+  final VoidCallback onTap;
+
+  const _ReactionButton({
+    required this.emoji,
+    required this.active,
+    required this.onTap,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final scheme = Theme.of(context).colorScheme;
+    return GestureDetector(
+      onTap: onTap,
+      child: AnimatedContainer(
+        duration: const Duration(milliseconds: 150),
+        padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 3),
+        decoration: BoxDecoration(
+          color: active ? scheme.primary.withValues(alpha: 0.12) : Colors.transparent,
+          border: Border.all(
+            color: active ? scheme.primary : scheme.outlineVariant,
+          ),
+          borderRadius: BorderRadius.circular(6),
+        ),
+        child: Text(emoji, style: const TextStyle(fontSize: 14)),
+      ),
+    );
+  }
+}

lib/widgets/project_selector.dart

@@ -23,12 +23,13 @@ class ProjectSelector extends ConsumerWidget {
 
     return projectsAsync.when(
       loading: () => const LinearProgressIndicator(),
-      error: (_, __) => const SizedBox.shrink(),
+      error: (_, _) => const SizedBox.shrink(),
       data: (projects) {
         final active =
             projects.where((p) => p.status == 'active').toList();
 
         return DropdownButtonFormField<int?>(
+          // ignore: deprecated_member_use
           value: value,
           decoration: decoration ??
               const InputDecoration(

lib/widgets/voice_mic_button.dart

@@ -0,0 +1,117 @@
+import 'package:flutter/material.dart';
+
+import '../providers/voice_provider.dart';
+
+/// Animated mic button that reflects the current [VoiceMode].
+///
+/// - idle: muted background, mic_none icon
+/// - recording: red with pulsing shadow ring
+/// - transcribing: indigo with spinner
+/// - playing: indigo with volume_up icon
+class VoiceMicButton extends StatefulWidget {
+  final VoiceMode mode;
+  final bool voiceModeActive;
+  final VoidCallback? onTap;
+
+  const VoiceMicButton({
+    super.key,
+    required this.mode,
+    required this.voiceModeActive,
+    this.onTap,
+  });
+
+  @override
+  State<VoiceMicButton> createState() => _VoiceMicButtonState();
+}
+
+class _VoiceMicButtonState extends State<VoiceMicButton>
+    with SingleTickerProviderStateMixin {
+  late AnimationController _pulseController;
+  late Animation<double> _pulseAnimation;
+
+  @override
+  void initState() {
+    super.initState();
+    _pulseController = AnimationController(
+      vsync: this,
+      duration: const Duration(milliseconds: 900),
+    )..repeat(reverse: true);
+    _pulseAnimation = Tween<double>(begin: 1.0, end: 1.25).animate(
+      CurvedAnimation(parent: _pulseController, curve: Curves.easeInOut),
+    );
+  }
+
+  @override
+  void dispose() {
+    _pulseController.dispose();
+    super.dispose();
+  }
+
+  Color _bgColor(BuildContext context) {
+    final cs = Theme.of(context).colorScheme;
+    return switch (widget.mode) {
+      VoiceMode.recording => const Color(0xFFEF4444),
+      VoiceMode.transcribing || VoiceMode.playing => cs.primary,
+      VoiceMode.idle => cs.surfaceContainerHighest,
+    };
+  }
+
+  Widget _icon(BuildContext context) {
+    final cs = Theme.of(context).colorScheme;
+    final iconColor = widget.mode == VoiceMode.idle
+        ? cs.onSurfaceVariant
+        : Colors.white;
+
+    return switch (widget.mode) {
+      VoiceMode.transcribing => SizedBox(
+          width: 18,
+          height: 18,
+          child: CircularProgressIndicator(
+            strokeWidth: 2,
+            color: iconColor,
+          ),
+        ),
+      VoiceMode.playing => Icon(Icons.volume_up, color: iconColor, size: 20),
+      _ => Icon(Icons.mic, color: iconColor, size: 20),
+    };
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final isRecording = widget.mode == VoiceMode.recording;
+
+    final button = Material(
+      color: _bgColor(context),
+      shape: const CircleBorder(),
+      child: InkWell(
+        customBorder: const CircleBorder(),
+        onTap: widget.onTap,
+        child: SizedBox(
+          width: 40,
+          height: 40,
+          child: Center(child: _icon(context)),
+        ),
+      ),
+    );
+
+    if (!isRecording) return button;
+
+    return AnimatedBuilder(
+      animation: _pulseAnimation,
+      builder: (_, child) => Container(
+        decoration: BoxDecoration(
+          shape: BoxShape.circle,
+          boxShadow: [
+            BoxShadow(
+              color: const Color(0xFFEF4444).withValues(alpha: 0.35),
+              blurRadius: 8 * _pulseAnimation.value,
+              spreadRadius: 2 * _pulseAnimation.value,
+            ),
+          ],
+        ),
+        child: child,
+      ),
+      child: button,
+    );
+  }
+}

lib/widgets/weather_card.dart

@@ -0,0 +1,185 @@
+import 'package:flutter/material.dart';
+
+class WeatherCard extends StatelessWidget {
+  final Map<String, dynamic>? weather;
+
+  const WeatherCard({super.key, required this.weather});
+
+  @override
+  Widget build(BuildContext context) {
+    final scheme = Theme.of(context).colorScheme;
+
+    if (weather == null) {
+      return Container(
+        margin: const EdgeInsets.only(bottom: 12),
+        padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 10),
+        decoration: BoxDecoration(
+          color: scheme.surfaceContainerHighest,
+          borderRadius: BorderRadius.circular(12),
+          border: Border.all(color: scheme.outlineVariant),
+        ),
+        child: Text(
+          'Weather data unavailable — will retry at next slot.',
+          style: TextStyle(
+            color: scheme.onSurfaceVariant,
+            fontStyle: FontStyle.italic,
+            fontSize: 13,
+          ),
+        ),
+      );
+    }
+
+    final w = weather!;
+    final location = w['location'] as String? ?? '';
+    final currentTemp = w['current_temp'];
+    final condition = w['condition'] as String? ?? '';
+    final todayHigh = w['today_high'];
+    final todayLow = w['today_low'];
+    final yesterdayHigh = w['yesterday_high'];
+    final fetchedAt = w['fetched_at'] as String?;
+    final forecast = (w['forecast'] as List<dynamic>? ?? [])
+        .cast<Map<String, dynamic>>();
+
+    String? tempDelta;
+    if (todayHigh != null && yesterdayHigh != null) {
+      final diff = (todayHigh as num) - (yesterdayHigh as num);
+      if (diff.abs() < 1) {
+        tempDelta = 'Same as yesterday';
+      } else {
+        final dir = diff > 0 ? 'warmer' : 'cooler';
+        tempDelta = '${diff.abs().round()}° $dir than yesterday';
+      }
+    }
+
+    String? fetchedLabel;
+    if (fetchedAt != null) {
+      try {
+        final dt = DateTime.parse(fetchedAt).toLocal();
+        final h = dt.hour % 12 == 0 ? 12 : dt.hour % 12;
+        final m = dt.minute.toString().padLeft(2, '0');
+        final period = dt.hour < 12 ? 'AM' : 'PM';
+        fetchedLabel = '$h:$m $period';
+      } catch (_) {}
+    }
+
+    return Container(
+      margin: const EdgeInsets.only(bottom: 12),
+      padding: const EdgeInsets.all(14),
+      decoration: BoxDecoration(
+        color: scheme.surfaceContainerHighest,
+        borderRadius: BorderRadius.circular(12),
+        border: Border.all(color: scheme.outlineVariant),
+      ),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          // Header: location + fetched time
+          Row(
+            mainAxisAlignment: MainAxisAlignment.spaceBetween,
+            children: [
+              Text(
+                location,
+                style: TextStyle(
+                  fontWeight: FontWeight.w600,
+                  fontSize: 14,
+                  color: scheme.onSurface,
+                ),
+              ),
+              if (fetchedLabel != null)
+                Text(
+                  'as of $fetchedLabel',
+                  style: TextStyle(
+                    fontSize: 12,
+                    color: scheme.onSurfaceVariant,
+                  ),
+                ),
+            ],
+          ),
+          const SizedBox(height: 8),
+          // Current temp + condition
+          Row(
+            crossAxisAlignment: CrossAxisAlignment.baseline,
+            textBaseline: TextBaseline.alphabetic,
+            children: [
+              Text(
+                '$currentTemp°',
+                style: TextStyle(
+                  fontSize: 36,
+                  fontWeight: FontWeight.w700,
+                  color: scheme.onSurface,
+                  height: 1,
+                ),
+              ),
+              const SizedBox(width: 10),
+              Text(
+                condition,
+                style: TextStyle(
+                  fontSize: 14,
+                  color: scheme.onSurfaceVariant,
+                ),
+              ),
+            ],
+          ),
+          // Today high/low + delta
+          if (todayHigh != null) ...[
+            const SizedBox(height: 8),
+            Text(
+              'Today: $todayHigh° / $todayLow°'
+              '${tempDelta != null ? '  ·  $tempDelta' : ''}',
+              style: TextStyle(fontSize: 13, color: scheme.onSurfaceVariant),
+            ),
+          ],
+          // Forecast strip
+          if (forecast.isNotEmpty) ...[
+            const SizedBox(height: 12),
+            const Divider(height: 1),
+            const SizedBox(height: 12),
+            SingleChildScrollView(
+              scrollDirection: Axis.horizontal,
+              child: Row(
+                spacing: 8,
+                children: forecast.map((day) {
+                  return SizedBox(
+                    width: 64,
+                    child: Column(
+                      crossAxisAlignment: CrossAxisAlignment.center,
+                      children: [
+                        Text(
+                          day['day'] as String? ?? '',
+                          style: TextStyle(
+                            fontSize: 12,
+                            fontWeight: FontWeight.w600,
+                            color: scheme.onSurface,
+                          ),
+                        ),
+                        const SizedBox(height: 3),
+                        Text(
+                          day['condition'] as String? ?? '',
+                          style: TextStyle(
+                            fontSize: 11,
+                            color: scheme.onSurfaceVariant,
+                          ),
+                          textAlign: TextAlign.center,
+                          maxLines: 2,
+                          overflow: TextOverflow.ellipsis,
+                        ),
+                        const SizedBox(height: 3),
+                        Text(
+                          '${day['high']}° / ${day['low']}°',
+                          style: TextStyle(
+                            fontSize: 12,
+                            color: scheme.onSurface,
+                          ),
+                        ),
+                      ],
+                    ),
+                  );
+                }).toList(),
+              ),
+            ),
+          ],
+        ],
+      ),
+    );
+  }
+}

linux/flutter/generated_plugin_registrant.cc

@@ -6,10 +6,18 @@
 
 #include "generated_plugin_registrant.h"
 
+#include <flutter_timezone/flutter_timezone_plugin.h>
 #include <open_file_linux/open_file_linux_plugin.h>
+#include <url_launcher_linux/url_launcher_plugin.h>
 
 void fl_register_plugins(FlPluginRegistry* registry) {
+  g_autoptr(FlPluginRegistrar) flutter_timezone_registrar =
+      fl_plugin_registry_get_registrar_for_plugin(registry, "FlutterTimezonePlugin");
+  flutter_timezone_plugin_register_with_registrar(flutter_timezone_registrar);
   g_autoptr(FlPluginRegistrar) open_file_linux_registrar =
       fl_plugin_registry_get_registrar_for_plugin(registry, "OpenFileLinuxPlugin");
   open_file_linux_plugin_register_with_registrar(open_file_linux_registrar);
+  g_autoptr(FlPluginRegistrar) url_launcher_linux_registrar =
+      fl_plugin_registry_get_registrar_for_plugin(registry, "UrlLauncherPlugin");
+  url_launcher_plugin_register_with_registrar(url_launcher_linux_registrar);
 }

linux/flutter/generated_plugins.cmake

@@ -3,7 +3,9 @@
 #
 
 list(APPEND FLUTTER_PLUGIN_LIST
+  flutter_timezone
   open_file_linux
+  url_launcher_linux
 )
 
 list(APPEND FLUTTER_FFI_PLUGIN_LIST

macos/Flutter/GeneratedPluginRegistrant.swift

@@ -6,13 +6,17 @@ import FlutterMacOS
 import Foundation
 
 import flutter_inappwebview_macos
+import flutter_timezone
 import open_file_mac
 import package_info_plus
 import shared_preferences_foundation
+import url_launcher_macos
 
 func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) {
   InAppWebViewFlutterPlugin.register(with: registry.registrar(forPlugin: "InAppWebViewFlutterPlugin"))
+  FlutterTimezonePlugin.register(with: registry.registrar(forPlugin: "FlutterTimezonePlugin"))
   OpenFilePlugin.register(with: registry.registrar(forPlugin: "OpenFilePlugin"))
   FPPPackageInfoPlusPlugin.register(with: registry.registrar(forPlugin: "FPPPackageInfoPlusPlugin"))
   SharedPreferencesPlugin.register(with: registry.registrar(forPlugin: "SharedPreferencesPlugin"))
+  UrlLauncherPlugin.register(with: registry.registrar(forPlugin: "UrlLauncherPlugin"))
 }

pubspec.lock

@@ -1,6 +1,22 @@
 # Generated by pub
 # See https://dart.dev/tools/pub/glossary#lockfile
 packages:
+  _fe_analyzer_shared:
+    dependency: transitive
+    description:
+      name: _fe_analyzer_shared
+      sha256: "8d7ff3948166b8ec5da0fbb5962000926b8e02f2ed9b3e51d1738905fbd4c98d"
+      url: "https://pub.dev"
+    source: hosted
+    version: "93.0.0"
+  analyzer:
+    dependency: transitive
+    description:
+      name: analyzer
+      sha256: de7148ed2fcec579b19f122c1800933dfa028f6d9fd38a152b04b1516cec120b
+      url: "https://pub.dev"
+    source: hosted
+    version: "10.0.1"
   archive:
     dependency: transitive
     description:
@@ -25,6 +41,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.13.0"
+  audio_session:
+    dependency: transitive
+    description:
+      name: audio_session
+      sha256: "2b7fff16a552486d078bfc09a8cde19f426dc6d6329262b684182597bec5b1ac"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.1.25"
   boolean_selector:
     dependency: transitive
     description:
@@ -49,6 +73,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.0.4"
+  cli_config:
+    dependency: transitive
+    description:
+      name: cli_config
+      sha256: ac20a183a07002b700f0c25e61b7ee46b23c309d76ab7b7640a028f18e4d99ec
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.2.0"
   cli_util:
     dependency: transitive
     description:
@@ -81,6 +113,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.19.1"
+  convert:
+    dependency: transitive
+    description:
+      name: convert
+      sha256: b30acd5944035672bc15c6b7a8b47d773e41e2f17de064350988c5d02adb1c68
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.1.2"
   cookie_jar:
     dependency: "direct main"
     description:
@@ -89,6 +129,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "4.0.9"
+  coverage:
+    dependency: transitive
+    description:
+      name: coverage
+      sha256: "5da775aa218eaf2151c721b16c01c7676fbfdd99cebba2bf64e8b807a28ff94d"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.15.0"
   crypto:
     dependency: transitive
     description:
@@ -109,26 +157,34 @@ packages:
     dependency: "direct main"
     description:
       name: dio
-      sha256: b9d46faecab38fc8cc286f80bc4d61a3bb5d4ac49e51ed877b4d6706efe57b25
+      sha256: aff32c08f92787a557dd5c0145ac91536481831a01b4648136373cddb0e64f8c
       url: "https://pub.dev"
     source: hosted
-    version: "5.9.1"
+    version: "5.9.2"
   dio_cookie_manager:
     dependency: "direct main"
     description:
       name: dio_cookie_manager
-      sha256: d39c16abcc711c871b7b29bd51c6b5f3059ef39503916c6a9df7e22c4fc595e0
+      sha256: "0db1a7b997a0455e488ac35744c68eed3f2a4280d3ab531835a65641b0a08744"
       url: "https://pub.dev"
     source: hosted
-    version: "3.3.0"
+    version: "3.4.0"
   dio_web_adapter:
     dependency: transitive
     description:
       name: dio_web_adapter
-      sha256: "7586e476d70caecaf1686d21eee7247ea43ef5c345eab9e0cc3583ff13378d78"
+      sha256: "2f9e64323a7c3c7ef69567d5c800424a11f8337b8b228bad02524c9fb3c1f340"
       url: "https://pub.dev"
     source: hosted
-    version: "2.1.1"
+    version: "2.1.2"
+  equatable:
+    dependency: transitive
+    description:
+      name: equatable
+      sha256: "3e0141505477fd8ad55d6eb4e7776d3fe8430be8e497ccb1521370c3f21a3e2b"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.0.8"
   fake_async:
     dependency: transitive
     description:
@@ -153,6 +209,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "7.0.1"
+  fixnum:
+    dependency: transitive
+    description:
+      name: fixnum
+      sha256: b6dc7065e46c974bc7c5f143080a6764ec7a4be6da1285ececdc37be96de53be
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.1.1"
   flutter:
     dependency: "direct main"
     description: flutter
@@ -250,20 +314,36 @@ packages:
     dependency: "direct main"
     description:
       name: flutter_riverpod
-      sha256: "9532ee6db4a943a1ed8383072a2e3eeda041db5657cdf6d2acecf3c21ecbe7e1"
+      sha256: "4e166be88e1dbbaa34a280bdb744aeae73b7ef25fdf8db7a3bb776760a3648e2"
       url: "https://pub.dev"
     source: hosted
-    version: "2.6.1"
+    version: "3.3.1"
   flutter_test:
     dependency: "direct dev"
     description: flutter
     source: sdk
     version: "0.0.0"
+  flutter_timezone:
+    dependency: "direct main"
+    description:
+      name: flutter_timezone
+      sha256: e8d63f50f2806a3a71a08697286a0369e1d8f0902961327810459871c0bb01c2
+      url: "https://pub.dev"
+    source: hosted
+    version: "5.0.2"
   flutter_web_plugins:
     dependency: transitive
     description: flutter
     source: sdk
     version: "0.0.0"
+  frontend_server_client:
+    dependency: transitive
+    description:
+      name: frontend_server_client
+      sha256: f64a0333a82f30b0cca061bc3d143813a486dc086b574bfb233b7c1372427694
+      url: "https://pub.dev"
+    source: hosted
+    version: "4.0.0"
   glob:
     dependency: transitive
     description:
@@ -276,18 +356,26 @@ packages:
     dependency: "direct main"
     description:
       name: go_router
-      sha256: f02fd7d2a4dc512fec615529824fdd217fecb3a3d3de68360293a551f21634b3
+      sha256: "7974313e217a7771557add6ff2238acb63f635317c35fa590d348fb238f00896"
       url: "https://pub.dev"
     source: hosted
-    version: "14.8.1"
+    version: "17.1.0"
+  google_fonts:
+    dependency: "direct main"
+    description:
+      name: google_fonts
+      sha256: db9df7a5898d894eeda4c78143f35c30a243558be439518972366880b80bf88e
+      url: "https://pub.dev"
+    source: hosted
+    version: "8.0.2"
   hooks:
     dependency: transitive
     description:
       name: hooks
-      sha256: "7a08a0d684cb3b8fb604b78455d5d352f502b68079f7b80b831c62220ab0a4f6"
+      sha256: e79ed1e8e1929bc6ecb6ec85f0cb519c887aa5b423705ded0d0f2d9226def388
       url: "https://pub.dev"
     source: hosted
-    version: "1.0.1"
+    version: "1.0.2"
   http:
     dependency: transitive
     description:
@@ -296,6 +384,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.6.0"
+  http_multi_server:
+    dependency: transitive
+    description:
+      name: http_multi_server
+      sha256: aa6199f908078bb1c5efb8d8638d4ae191aac11b311132c3ef48ce352fb52ef8
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.2.2"
   http_parser:
     dependency: transitive
     description:
@@ -312,6 +408,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "4.8.0"
+  io:
+    dependency: transitive
+    description:
+      name: io
+      sha256: dfd5a80599cf0165756e3181807ed3e77daf6dd4137caaad72d0b7931597650b
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.0.5"
   json_annotation:
     dependency: transitive
     description:
@@ -320,6 +424,30 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "4.11.0"
+  just_audio:
+    dependency: "direct main"
+    description:
+      name: just_audio
+      sha256: f978d5b4ccea08f267dae0232ec5405c1b05d3f3cd63f82097ea46c015d5c09e
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.9.46"
+  just_audio_platform_interface:
+    dependency: transitive
+    description:
+      name: just_audio_platform_interface
+      sha256: "2532c8d6702528824445921c5ff10548b518b13f808c2e34c2fd54793b999a6a"
+      url: "https://pub.dev"
+    source: hosted
+    version: "4.6.0"
+  just_audio_web:
+    dependency: transitive
+    description:
+      name: just_audio_web
+      sha256: "6ba8a2a7e87d57d32f0f7b42856ade3d6a9fbe0f1a11fabae0a4f00bb73f0663"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.4.16"
   leak_tracker:
     dependency: transitive
     description:
@@ -372,10 +500,10 @@ packages:
     dependency: transitive
     description:
       name: matcher
-      sha256: "12956d0ad8390bbcc63ca2e1469c0619946ccb52809807067a7020d57e647aa6"
+      sha256: dc0b7dc7651697ea4ff3e69ef44b0407ea32c487a39fff6a4004fa585e901861
       url: "https://pub.dev"
     source: hosted
-    version: "0.12.18"
+    version: "0.12.19"
   material_color_utilities:
     dependency: transitive
     description:
@@ -404,10 +532,18 @@ packages:
     dependency: transitive
     description:
       name: native_toolchain_c
-      sha256: "89e83885ba09da5fdf2cdacc8002a712ca238c28b7f717910b34bcd27b0d03ac"
+      sha256: "92b2ca62c8bd2b8d2f267cdfccf9bfbdb7322f778f8f91b3ce5b5cda23a3899f"
       url: "https://pub.dev"
     source: hosted
-    version: "0.17.4"
+    version: "0.17.5"
+  node_preamble:
+    dependency: transitive
+    description:
+      name: node_preamble
+      sha256: "6e7eac89047ab8a8d26cf16127b5ed26de65209847630400f9aefd7cd5c730db"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.0.2"
   objective_c:
     dependency: transitive
     description:
@@ -480,14 +616,22 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "0.0.3"
+  package_config:
+    dependency: transitive
+    description:
+      name: package_config
+      sha256: f096c55ebb7deb7e384101542bfba8c52696c1b56fca2eb62827989ef2353bbc
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.2.0"
   package_info_plus:
     dependency: "direct main"
     description:
       name: package_info_plus
-      sha256: "16eee997588c60225bda0488b6dcfac69280a6b7a3cf02c741895dd370a02968"
+      sha256: f69da0d3189a4b4ceaeb1a3defb0f329b3b352517f52bed4290f83d4f06bc08d
       url: "https://pub.dev"
     source: hosted
-    version: "8.3.1"
+    version: "9.0.0"
   package_info_plus_platform_interface:
     dependency: transitive
     description:
@@ -552,6 +696,54 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.3.0"
+  permission_handler:
+    dependency: "direct main"
+    description:
+      name: permission_handler
+      sha256: "59adad729136f01ea9e35a48f5d1395e25cba6cea552249ddbe9cf950f5d7849"
+      url: "https://pub.dev"
+    source: hosted
+    version: "11.4.0"
+  permission_handler_android:
+    dependency: transitive
+    description:
+      name: permission_handler_android
+      sha256: d3971dcdd76182a0c198c096b5db2f0884b0d4196723d21a866fc4cdea057ebc
+      url: "https://pub.dev"
+    source: hosted
+    version: "12.1.0"
+  permission_handler_apple:
+    dependency: transitive
+    description:
+      name: permission_handler_apple
+      sha256: f000131e755c54cf4d84a5d8bd6e4149e262cc31c5a8b1d698de1ac85fa41023
+      url: "https://pub.dev"
+    source: hosted
+    version: "9.4.7"
+  permission_handler_html:
+    dependency: transitive
+    description:
+      name: permission_handler_html
+      sha256: "38f000e83355abb3392140f6bc3030660cfaef189e1f87824facb76300b4ff24"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.1.3+5"
+  permission_handler_platform_interface:
+    dependency: transitive
+    description:
+      name: permission_handler_platform_interface
+      sha256: eb99b295153abce5d683cac8c02e22faab63e50679b937fa1bf67d58bb282878
+      url: "https://pub.dev"
+    source: hosted
+    version: "4.3.0"
+  permission_handler_windows:
+    dependency: transitive
+    description:
+      name: permission_handler_windows
+      sha256: "1a790728016f79a41216d88672dbc5df30e686e811ad4e698bfc51f76ad91f1e"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.2.1"
   petitparser:
     dependency: transitive
     description:
@@ -576,6 +768,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.1.8"
+  pool:
+    dependency: transitive
+    description:
+      name: pool
+      sha256: "978783255c543aa3586a1b3c21f6e9d720eb315376a915872c61ef8b5c20177d"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.5.2"
   posix:
     dependency: transitive
     description:
@@ -592,14 +792,78 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.2.0"
+  record:
+    dependency: "direct main"
+    description:
+      name: record
+      sha256: "2e3d56d196abcd69f1046339b75e5f3855b2406fc087e5991f6703f188aa03a6"
+      url: "https://pub.dev"
+    source: hosted
+    version: "5.2.1"
+  record_android:
+    dependency: transitive
+    description:
+      name: record_android
+      sha256: "94783f08403aed33ffb68797bf0715b0812eb852f3c7985644c945faea462ba1"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.5.1"
+  record_darwin:
+    dependency: transitive
+    description:
+      name: record_darwin
+      sha256: e487eccb19d82a9a39cd0126945cfc47b9986e0df211734e2788c95e3f63c82c
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.2.2"
+  record_linux:
+    dependency: "direct overridden"
+    description:
+      name: record_linux
+      sha256: c31a35cc158cd666fc6395f7f56fc054f31685571684be6b97670a27649ce5c7
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.3.0"
+  record_platform_interface:
+    dependency: transitive
+    description:
+      name: record_platform_interface
+      sha256: "8a81dbc4e14e1272a285bbfef6c9136d070a47d9b0d1f40aa6193516253ee2f6"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.5.0"
+  record_web:
+    dependency: transitive
+    description:
+      name: record_web
+      sha256: "7e9846981c1f2d111d86f0ae3309071f5bba8b624d1c977316706f08fc31d16d"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.3.0"
+  record_windows:
+    dependency: transitive
+    description:
+      name: record_windows
+      sha256: "223258060a1d25c62bae18282c16783f28581ec19401d17e56b5205b9f039d78"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.0.7"
   riverpod:
     dependency: transitive
     description:
       name: riverpod
-      sha256: "59062512288d3056b2321804332a13ffdd1bf16df70dcc8e506e411280a72959"
+      sha256: "8c22216be8ad3ef2b44af3a329693558c98eca7b8bd4ef495c92db0bba279f83"
       url: "https://pub.dev"
     source: hosted
-    version: "2.6.1"
+    version: "3.2.1"
+  rxdart:
+    dependency: transitive
+    description:
+      name: rxdart
+      sha256: "5c3004a4a8dbb94bd4bf5412a4def4acdaa12e12f269737a5751369e12d1a962"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.28.0"
   shared_preferences:
     dependency: "direct main"
     description:
@@ -656,11 +920,59 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.4.1"
+  shelf:
+    dependency: transitive
+    description:
+      name: shelf
+      sha256: e7dd780a7ffb623c57850b33f43309312fc863fb6aa3d276a754bb299839ef12
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.4.2"
+  shelf_packages_handler:
+    dependency: transitive
+    description:
+      name: shelf_packages_handler
+      sha256: "89f967eca29607c933ba9571d838be31d67f53f6e4ee15147d5dc2934fee1b1e"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.0.2"
+  shelf_static:
+    dependency: transitive
+    description:
+      name: shelf_static
+      sha256: c87c3875f91262785dade62d135760c2c69cb217ac759485334c5857ad89f6e3
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.1.3"
+  shelf_web_socket:
+    dependency: transitive
+    description:
+      name: shelf_web_socket
+      sha256: "3632775c8e90d6c9712f883e633716432a27758216dfb61bd86a8321c0580925"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.0.0"
   sky_engine:
     dependency: transitive
     description: flutter
     source: sdk
     version: "0.0.0"
+  source_map_stack_trace:
+    dependency: transitive
+    description:
+      name: source_map_stack_trace
+      sha256: c0713a43e323c3302c2abe2a1cc89aa057a387101ebd280371d6a6c9fa68516b
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.1.2"
+  source_maps:
+    dependency: transitive
+    description:
+      name: source_maps
+      sha256: "190222579a448b03896e0ca6eca5998fa810fda630c1d65e2f78b3f638f54812"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.10.13"
   source_span:
     dependency: transitive
     description:
@@ -701,6 +1013,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.4.1"
+  synchronized:
+    dependency: transitive
+    description:
+      name: synchronized
+      sha256: c254ade258ec8282947a0acbbc90b9575b4f19673533ee46f2f6e9b3aeefd7c0
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.4.0"
   term_glyph:
     dependency: transitive
     description:
@@ -709,14 +1029,30 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.2.2"
+  test:
+    dependency: transitive
+    description:
+      name: test
+      sha256: "280d6d890011ca966ad08df7e8a4ddfab0fb3aa49f96ed6de56e3521347a9ae7"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.30.0"
   test_api:
     dependency: transitive
     description:
       name: test_api
-      sha256: "93167629bfc610f71560ab9312acdda4959de4df6fac7492c89ff0d3886f6636"
+      sha256: "8161c84903fd860b26bfdefb7963b3f0b68fee7adea0f59ef805ecca346f0c7a"
       url: "https://pub.dev"
     source: hosted
-    version: "0.7.9"
+    version: "0.7.10"
+  test_core:
+    dependency: transitive
+    description:
+      name: test_core
+      sha256: "0381bd1585d1a924763c308100f2138205252fb90c9d4eeaf28489ee65ccde51"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.6.16"
   typed_data:
     dependency: transitive
     description:
@@ -733,6 +1069,78 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.3.1"
+  url_launcher:
+    dependency: "direct main"
+    description:
+      name: url_launcher
+      sha256: f6a7e5c4835bb4e3026a04793a4199ca2d14c739ec378fdfe23fc8075d0439f8
+      url: "https://pub.dev"
+    source: hosted
+    version: "6.3.2"
+  url_launcher_android:
+    dependency: transitive
+    description:
+      name: url_launcher_android
+      sha256: "3bb000251e55d4a209aa0e2e563309dc9bb2befea2295fd0cec1f51760aac572"
+      url: "https://pub.dev"
+    source: hosted
+    version: "6.3.29"
+  url_launcher_ios:
+    dependency: transitive
+    description:
+      name: url_launcher_ios
+      sha256: "580fe5dfb51671ae38191d316e027f6b76272b026370708c2d898799750a02b0"
+      url: "https://pub.dev"
+    source: hosted
+    version: "6.4.1"
+  url_launcher_linux:
+    dependency: transitive
+    description:
+      name: url_launcher_linux
+      sha256: d5e14138b3bc193a0f63c10a53c94b91d399df0512b1f29b94a043db7482384a
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.2.2"
+  url_launcher_macos:
+    dependency: transitive
+    description:
+      name: url_launcher_macos
+      sha256: "368adf46f71ad3c21b8f06614adb38346f193f3a59ba8fe9a2fd74133070ba18"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.2.5"
+  url_launcher_platform_interface:
+    dependency: transitive
+    description:
+      name: url_launcher_platform_interface
+      sha256: "552f8a1e663569be95a8190206a38187b531910283c3e982193e4f2733f01029"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.3.2"
+  url_launcher_web:
+    dependency: transitive
+    description:
+      name: url_launcher_web
+      sha256: d0412fcf4c6b31ecfdb7762359b7206ffba3bbffd396c6d9f9c4616ece476c1f
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.2"
+  url_launcher_windows:
+    dependency: transitive
+    description:
+      name: url_launcher_windows
+      sha256: "712c70ab1b99744ff066053cbe3e80c73332b38d46e5e945c98689b2e66fc15f"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.1.5"
+  uuid:
+    dependency: transitive
+    description:
+      name: uuid
+      sha256: "1fef9e8e11e2991bb773070d4656b7bd5d850967a2456cfc83cf47925ba79489"
+      url: "https://pub.dev"
+    source: hosted
+    version: "4.5.3"
   vector_math:
     dependency: transitive
     description:
@@ -749,6 +1157,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "15.0.2"
+  watcher:
+    dependency: transitive
+    description:
+      name: watcher
+      sha256: "1398c9f081a753f9226febe8900fce8f7d0a67163334e1c94a2438339d79d635"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.2.1"
   web:
     dependency: transitive
     description:
@@ -757,6 +1173,30 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.1.1"
+  web_socket:
+    dependency: transitive
+    description:
+      name: web_socket
+      sha256: "34d64019aa8e36bf9842ac014bb5d2f5586ca73df5e4d9bf5c936975cae6982c"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.0.1"
+  web_socket_channel:
+    dependency: transitive
+    description:
+      name: web_socket_channel
+      sha256: d645757fb0f4773d602444000a8131ff5d48c9e47adfe9772652dd1a4f2d45c8
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.0.3"
+  webkit_inspection_protocol:
+    dependency: transitive
+    description:
+      name: webkit_inspection_protocol
+      sha256: "87d3f2333bb240704cd3f1c6b5b7acd8a10e7f0bc28c28dcf14e782014f4a572"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.2.1"
   win32:
     dependency: transitive
     description:

pubspec.yaml

@@ -2,7 +2,7 @@ name: fabled_app
 description: "FabledAssistant mobile client for Android."
 publish_to: 'none'
 
-version: 26.03.02+1
+version: 0.0.0+0  # overridden at build time via --build-name / --build-number
 
 environment:
   sdk: ^3.11.0
@@ -12,18 +12,27 @@ dependencies:
     sdk: flutter
 
   cupertino_icons: ^1.0.8
-  flutter_riverpod: ^2.5.1
-  go_router: ^14.2.0
+  flutter_riverpod: ^3.3.1
+  go_router: ^17.1.0
   dio: ^5.6.0
   cookie_jar: ^4.0.8
   dio_cookie_manager: ^3.1.1
   path_provider: ^2.1.4
   shared_preferences: ^2.3.2
   markdown: ^7.2.2
-  package_info_plus: ^8.0.0
+  package_info_plus: ^9.0.0
   open_file: ^3.3.2
+  permission_handler: ^11.3.1
   flutter_inappwebview: ^6.1.5
   flutter_markdown_plus: ^1.0.7
+  google_fonts: ^8.0.2
+  flutter_timezone: ^5.0.2
+  url_launcher: ^6.3.1
+  record: ^5.0.0
+  just_audio: ^0.9.39
+
+dependency_overrides:
+  record_linux: ^1.3.0
 
 dev_dependencies:
   flutter_test:

test/widget_test.dart

@@ -1,8 +1,149 @@
-// Placeholder — integration tests go here once the app is running on device.
+import 'package:fabled_app/data/api/voice_api.dart';
+import 'package:fabled_app/providers/voice_provider.dart';
+import 'package:fabled_app/data/models/knowledge_item.dart';
+import 'package:fabled_app/data/models/note.dart';
 import 'package:flutter_test/flutter_test.dart';
 
 void main() {
-  test('placeholder', () {
-    expect(true, isTrue);
+  group('Note.fromJson', () {
+    test('parses noteType when present', () {
+      final json = {
+        'id': 1,
+        'title': 'Alice',
+        'body': '',
+        'tags': <dynamic>[],
+        'note_type': 'person',
+        'created_at': '2024-01-01T00:00:00',
+        'updated_at': '2024-01-01T00:00:00',
+      };
+      final note = Note.fromJson(json);
+      expect(note.noteType, equals('person'));
+    });
+
+    test('defaults noteType to note when absent', () {
+      final json = {
+        'id': 2,
+        'title': 'My note',
+        'body': '',
+        'tags': <dynamic>[],
+        'created_at': '2024-01-01T00:00:00',
+        'updated_at': '2024-01-01T00:00:00',
+      };
+      final note = Note.fromJson(json);
+      expect(note.noteType, equals('note'));
+    });
+  });
+
+  group('KnowledgeItem.fromJson', () {
+    test('parses a task item with task fields', () {
+      final json = {
+        'id': 10,
+        'note_type': 'task',
+        'title': 'Do the thing',
+        'body': '',
+        'tags': <dynamic>[],
+        'status': 'todo',
+        'priority': 'high',
+        'due_date': '2025-01-01',
+        'created_at': '2024-01-01T00:00:00',
+        'updated_at': '2024-01-01T00:00:00',
+      };
+      final item = KnowledgeItem.fromJson(json);
+      expect(item.noteType, equals('task'));
+      expect(item.status, equals('todo'));
+      expect(item.priority, equals('high'));
+    });
+
+    test('defaults noteType to note when absent', () {
+      final json = {
+        'id': 11,
+        'title': 'A note',
+        'body': '',
+        'tags': <dynamic>[],
+        'created_at': '2024-01-01T00:00:00',
+        'updated_at': '2024-01-01T00:00:00',
+      };
+      final item = KnowledgeItem.fromJson(json);
+      expect(item.noteType, equals('note'));
+      expect(item.status, isNull);
+    });
+  });
+
+  group('VoiceStatus.fromJson', () {
+    test('parses enabled with stt and tts available', () {
+      final status = VoiceStatus.fromJson({
+        'enabled': true,
+        'stt': true,
+        'tts': true,
+      });
+      expect(status.enabled, isTrue);
+      expect(status.stt, isTrue);
+      expect(status.tts, isTrue);
+    });
+
+    test('parses disabled state', () {
+      final status = VoiceStatus.fromJson({
+        'enabled': false,
+        'stt': false,
+        'tts': false,
+      });
+      expect(status.enabled, isFalse);
+    });
+
+    test('fullyAvailable is false when enabled but stt is false', () {
+      final status = VoiceStatus.fromJson({
+        'enabled': true,
+        'stt': false,
+        'tts': true,
+      });
+      expect(status.fullyAvailable, isFalse);
+    });
+  });
+
+  group('VoiceNotifier sentence extraction', () {
+    test('extracts complete sentences at full stops', () {
+      final result = extractSentences('Hello world. How are you? I am fine!');
+      expect(result.sentences,
+          equals(['Hello world.', 'How are you?', 'I am fine!']));
+      expect(result.remainder, equals(''));
+    });
+
+    test('leaves incomplete fragment in remainder', () {
+      final result = extractSentences('Hello world. Incomplete');
+      expect(result.sentences, equals(['Hello world.']));
+      expect(result.remainder, equals('Incomplete'));
+    });
+
+    test('returns empty sentences and full text when no boundary', () {
+      final result = extractSentences('No boundary here');
+      expect(result.sentences, isEmpty);
+      expect(result.remainder, equals('No boundary here'));
+    });
+  });
+
+  group('VoiceNotifier markdown stripping', () {
+    test('strips code fences', () {
+      expect(stripMarkdownForTts('Before\n```dart\ncode\n```\nAfter'),
+          equals('Before After'));
+    });
+
+    test('strips bold and italic markers', () {
+      expect(stripMarkdownForTts('**bold** and *italic*'),
+          equals('bold and italic'));
+    });
+
+    test('strips headers', () {
+      expect(stripMarkdownForTts('## Section title'), equals('Section title'));
+    });
+
+    test('keeps link text, removes URL', () {
+      expect(stripMarkdownForTts('[click here](https://example.com)'),
+          equals('click here'));
+    });
+
+    test('strips list markers', () {
+      expect(stripMarkdownForTts('- item one\n- item two'),
+          equals('item one item two'));
+    });
   });
 }

windows/flutter/generated_plugin_registrant.cc

@@ -7,8 +7,17 @@
 #include "generated_plugin_registrant.h"
 
 #include <flutter_inappwebview_windows/flutter_inappwebview_windows_plugin_c_api.h>
+#include <flutter_timezone/flutter_timezone_plugin_c_api.h>
+#include <permission_handler_windows/permission_handler_windows_plugin.h>
+#include <url_launcher_windows/url_launcher_windows.h>
 
 void RegisterPlugins(flutter::PluginRegistry* registry) {
   FlutterInappwebviewWindowsPluginCApiRegisterWithRegistrar(
       registry->GetRegistrarForPlugin("FlutterInappwebviewWindowsPluginCApi"));
+  FlutterTimezonePluginCApiRegisterWithRegistrar(
+      registry->GetRegistrarForPlugin("FlutterTimezonePluginCApi"));
+  PermissionHandlerWindowsPluginRegisterWithRegistrar(
+      registry->GetRegistrarForPlugin("PermissionHandlerWindowsPlugin"));
+  UrlLauncherWindowsRegisterWithRegistrar(
+      registry->GetRegistrarForPlugin("UrlLauncherWindows"));
 }

windows/flutter/generated_plugins.cmake

@@ -4,6 +4,9 @@
 
 list(APPEND FLUTTER_PLUGIN_LIST
   flutter_inappwebview_windows
+  flutter_timezone
+  permission_handler_windows
+  url_launcher_windows
 )
 
 list(APPEND FLUTTER_FFI_PLUGIN_LIST