feat(ai): per-card re-analyze menu with provider override

Lets users re-run LLM analysis on a single card using any configured
provider (primary/secondary/tertiary), independent of the app's default.
Used as an escape hatch when the primary output is wrong or the user
wants to compare providers on the same source batch.

Changes:
- LLMService gets a new processBatch overload that accepts
  providerOverride + chatToolOverride. When an override is set, the
  configured-backup chain is skipped (caller's choice wins).
- AnalysisManager gets a reanalyzeCard(_:providerOverride:...) method
  that looks up the card's batch, validates screenshots still exist,
  resets observations + batch status, then re-runs processBatch with
  the chosen provider.
- New ActivityCardReanalyzeMenu + ReanalyzePickerOverlay SwiftUI views
  provide the UI: a sparkles button on each card opens an overlay
  listing the user's configured primary/secondary/tertiary providers
  (each with appropriate subtitle — local model ID, CLI tool, etc.)
- StorageManager gets batchIdForTimelineCard(_:) helper.
- LLMProviderRoutingPreferences extended with tertiary preferences.

Based on feat/apfel-provider so the .apfel option works out of the box.

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

Author: joceqo

Dayflow/Dayflow/Core/AI/LLMService.swift

@@ -23,6 +23,14 @@ protocol LLMServicing {
   func processBatch(
     _ batchId: Int64, progressHandler: ((LLMProcessingStep) -> Void)?,
     completion: @escaping (Result<ProcessedBatchResult, Error>) -> Void)
+  /// Process a batch with an explicit provider override (bypasses user's configured primary/backup).
+  /// Used by per-card retry so the user can pick "re-analyze with X".
+  func processBatch(
+    _ batchId: Int64,
+    providerOverride: LLMProviderID?,
+    chatToolOverride: ChatCLITool?,
+    progressHandler: ((LLMProcessingStep) -> Void)?,
+    completion: @escaping (Result<ProcessedBatchResult, Error>) -> Void)
   func generateText(prompt: String) async throws -> String
   func generateTextStreaming(prompt: String) -> AsyncThrowingStream<String, Error>
   /// Rich chat streaming with thinking, tool calls, and text events.
@@ -591,6 +599,22 @@ final class LLMService: LLMServicing {
   func processBatch(
     _ batchId: Int64, progressHandler: ((LLMProcessingStep) -> Void)? = nil,
     completion: @escaping (Result<ProcessedBatchResult, Error>) -> Void
+  ) {
+    processBatch(
+      batchId,
+      providerOverride: nil,
+      chatToolOverride: nil,
+      progressHandler: progressHandler,
+      completion: completion
+    )
+  }
+
+  func processBatch(
+    _ batchId: Int64,
+    providerOverride: LLMProviderID?,
+    chatToolOverride: ChatCLITool?,
+    progressHandler: ((LLMProcessingStep) -> Void)?,
+    completion: @escaping (Result<ProcessedBatchResult, Error>) -> Void
   ) {
     Task {
       // Get batch info first (outside do-catch so it's available in catch block)
@@ -606,9 +630,16 @@ final class LLMService: LLMServicing {
 
       let (_, batchStartTs, batchEndTs, _) = batchInfo
       let processingStartTime = Date()
-      let primaryProviderID = LLMProviderID.from(providerType)
-      let primaryProviderLabel = providerLabel(for: primaryProviderID)
-      let configuredBackup = configuredBackupProvider(primaryProviderID: primaryProviderID)
+      let primaryProviderID = providerOverride ?? LLMProviderID.from(providerType)
+      let primaryChatToolOverride = providerOverride != nil ? chatToolOverride : nil
+      let primaryProviderLabel = providerLabel(
+        for: primaryProviderID, chatToolOverride: primaryChatToolOverride)
+      // When an override is used, skip the configured-backup chain: the caller
+      // explicitly chose this provider and fallback to a different one would be surprising.
+      let configuredBackup =
+        providerOverride == nil
+        ? configuredBackupProvider(primaryProviderID: primaryProviderID)
+        : nil
       let configuredBackupProviderName = configuredBackup?.id.analyticsName
       let configuredBackupProviderLabel = configuredBackup.map {
         providerLabel(for: $0.id, chatToolOverride: $0.chatToolOverride)
@@ -632,7 +663,8 @@ final class LLMService: LLMServicing {
             "llm_provider_label": primaryProviderLabel,
           ])
 
-        let primaryContext = try makeTimelineProviderContext(for: primaryProviderID)
+        let primaryContext = try makeTimelineProviderContext(
+          for: primaryProviderID, chatToolOverride: primaryChatToolOverride)
         let backupContext: TimelineProviderContext? = {
           guard let configuredBackup else { return nil }
           return try? makeTimelineProviderContext(

Dayflow/Dayflow/Core/AI/LLMTypes.swift

@@ -240,6 +240,8 @@ enum LLMProviderID: String, Codable, CaseIterable {
 enum LLMProviderRoutingPreferences {
   static let backupProviderDefaultsKey = "llmBackupProviderId"
   static let backupChatCLIToolDefaultsKey = "llmBackupChatCLITool"
+  static let tertiaryProviderDefaultsKey = "llmTertiaryProviderId"
+  static let tertiaryChatCLIToolDefaultsKey = "llmTertiaryChatCLITool"
 
   static func loadBackupProvider(from defaults: UserDefaults = .standard) -> LLMProviderID? {
     guard let rawValue = defaults.string(forKey: backupProviderDefaultsKey) else {
@@ -248,6 +250,20 @@ enum LLMProviderRoutingPreferences {
     return LLMProviderID(rawValue: rawValue)
   }
 
+  static func loadTertiaryProvider(from defaults: UserDefaults = .standard) -> LLMProviderID? {
+    guard let rawValue = defaults.string(forKey: tertiaryProviderDefaultsKey) else {
+      return nil
+    }
+    return LLMProviderID(rawValue: rawValue)
+  }
+
+  static func loadTertiaryChatCLITool(from defaults: UserDefaults = .standard) -> ChatCLITool? {
+    guard let rawValue = defaults.string(forKey: tertiaryChatCLIToolDefaultsKey) else {
+      return nil
+    }
+    return ChatCLITool(rawValue: rawValue)
+  }
+
   static func saveBackupProvider(_ provider: LLMProviderID?, to defaults: UserDefaults = .standard)
   {
     if let provider {

Dayflow/Dayflow/Core/Analysis/AnalysisManager.swift

@@ -24,6 +24,13 @@ protocol AnalysisManaging {
   func reprocessBatch(
     _ batchId: Int64, stepHandler: @escaping (LLMProcessingStep) -> Void,
     completion: @escaping (Result<Void, Error>) -> Void)
+  /// Re-run LLM analysis for a single card's source batch with an explicit provider override.
+  func reanalyzeCard(
+    _ cardId: Int64,
+    providerOverride: LLMProviderID,
+    chatToolOverride: ChatCLITool?,
+    stepHandler: @escaping (LLMProcessingStep) -> Void,
+    completion: @escaping (Result<Void, Error>) -> Void)
 }
 
 final class AnalysisManager: AnalysisManaging {
@@ -381,6 +388,68 @@ final class AnalysisManager: AnalysisManaging {
     }
   }
 
+  func reanalyzeCard(
+    _ cardId: Int64,
+    providerOverride: LLMProviderID,
+    chatToolOverride: ChatCLITool?,
+    stepHandler: @escaping (LLMProcessingStep) -> Void,
+    completion: @escaping (Result<Void, Error>) -> Void
+  ) {
+    queue.async { [weak self] in
+      guard let self else {
+        DispatchQueue.main.async {
+          completion(
+            .failure(
+              NSError(
+                domain: "AnalysisManager", code: 1,
+                userInfo: [NSLocalizedDescriptionKey: "Manager deallocated"])))
+        }
+        return
+      }
+
+      guard let batchId = self.store.batchIdForTimelineCard(cardId) else {
+        DispatchQueue.main.async {
+          completion(
+            .failure(
+              NSError(
+                domain: "AnalysisManager", code: 5,
+                userInfo: [
+                  NSLocalizedDescriptionKey:
+                    "Can't re-analyze: this card has no source batch on disk."
+                ])))
+        }
+        return
+      }
+
+      guard !self.store.screenshotsForBatch(batchId).isEmpty else {
+        DispatchQueue.main.async {
+          completion(
+            .failure(
+              NSError(
+                domain: "AnalysisManager", code: 6,
+                userInfo: [
+                  NSLocalizedDescriptionKey:
+                    "Can't re-analyze: screenshots for this card have been purged."
+                ])))
+        }
+        return
+      }
+
+      self.store.deleteObservations(forBatchIds: [batchId])
+      _ = self.store.resetBatchStatuses(forBatchIds: [batchId])
+
+      self.queueLLMRequest(
+        batchId: batchId,
+        providerOverride: providerOverride,
+        chatToolOverride: chatToolOverride,
+        progressHandler: stepHandler,
+        completion: { result in
+          DispatchQueue.main.async { completion(result) }
+        }
+      )
+    }
+  }
+
   @objc private func timerFired() { triggerAnalysisNow() }
 
   private func processRecordings() {
@@ -400,6 +469,8 @@ final class AnalysisManager: AnalysisManaging {
 
   private func queueLLMRequest(
     batchId: Int64,
+    providerOverride: LLMProviderID? = nil,
+    chatToolOverride: ChatCLITool? = nil,
     progressHandler: ((LLMProcessingStep) -> Void)? = nil,
     completion: ((Result<Void, Error>) -> Void)? = nil
   ) {
@@ -473,7 +544,12 @@ final class AnalysisManager: AnalysisManaging {
 
     updateBatchStatus(batchId: batchId, status: "processing")
 
-    llmService.processBatch(batchId, progressHandler: progressHandler) {
+    llmService.processBatch(
+      batchId,
+      providerOverride: providerOverride,
+      chatToolOverride: chatToolOverride,
+      progressHandler: progressHandler
+    ) {
       [weak self] (result: Result<ProcessedBatchResult, Error>) in
       guard let self else { return }
 

Dayflow/Dayflow/Core/Recording/StorageManager.swift

@@ -70,6 +70,7 @@ protocol StorageManaging: Sendable {
   func deleteTimelineCard(recordId: Int64) -> String?
   func fetchTimelineCards(forBatch batchId: Int64) -> [TimelineCard]
   func fetchTimelineCard(byId id: Int64) -> TimelineCardWithTimestamps?
+  func batchIdForTimelineCard(_ cardId: Int64) -> Int64?
   func fetchLastTimelineCard(endingBefore: Date) -> TimelineCardWithTimestamps?
 
   // Timeline Queries
@@ -1523,6 +1524,16 @@ final class StorageManager: StorageManaging, @unchecked Sendable {
     }
   }
 
+  func batchIdForTimelineCard(_ cardId: Int64) -> Int64? {
+    try? timedRead("batchIdForTimelineCard") { db in
+      try Int64.fetchOne(
+        db,
+        sql: "SELECT batch_id FROM timeline_cards WHERE id = ? AND is_deleted = 0",
+        arguments: [cardId]
+      )
+    } ?? nil
+  }
+
   func deleteTimelineCard(recordId: Int64) -> String? {
     var videoPath: String? = nil
 

Dayflow/Dayflow/Views/UI/MainView/ActivityCard.swift

@@ -19,6 +19,8 @@ struct ActivityCard: View {
     false
 
   @State private var showCategoryPicker = false
+  @State private var showReanalyzePicker = false
+  @State private var isReanalyzing = false
   @State private var isPreparingSlideshow = false
   @State private var slideshowError: String?
   @State private var slideshowRequestID = 0
@@ -66,12 +68,30 @@ struct ActivityCard: View {
           .transition(.move(edge: .top).combined(with: .opacity))
           .zIndex(1)
         }
+
+        if showReanalyzePicker && !isFailedCard(activity) {
+          ReanalyzePickerOverlay(
+            recordId: activity.recordId,
+            onClose: {
+              withAnimation(.spring(response: 0.25, dampingFraction: 0.85)) {
+                showReanalyzePicker = false
+              }
+            },
+            onRunStart: { isReanalyzing = true },
+            onRunEnd: { _ in isReanalyzing = false },
+            onCompleted: onRetryBatchCompleted
+          )
+          .transition(.move(edge: .top).combined(with: .opacity))
+          .zIndex(2)
+        }
       }
       .if(maxHeight != nil) { view in
         view.frame(maxHeight: maxHeight!)
       }
       .onChange(of: activity.id) {
         showCategoryPicker = false
+        showReanalyzePicker = false
+        isReanalyzing = false
         isPreparingSlideshow = false
         slideshowError = nil
         slideshowRequestID &+= 1
@@ -219,6 +239,11 @@ struct ActivityCard: View {
                 .hoverScaleEffect(scale: 1.02)
                 .pointingHandCursorOnHover(reassertOnPressEnd: true)
                 .accessibilityLabel(Text("Change category"))
+
+                ActivityCardReanalyzeMenu(
+                  isPresented: $showReanalyzePicker,
+                  isRunning: isReanalyzing
+                )
               }
             }
           }