Fastest and only macOS Dictation app with on-device STT and custom trained AI enhancement model. Windows, iOS testflight! Android, Linux waitlist open! A local Wispr Flow alternative. Follow https://x.com/fluidvoiceapp for more
feat: star transcripts in History (#1053)
Rohith Gandhi Gfe570026e90b
diff --git a/Sources/Fluid/Persistence/TranscriptionHistoryStore.swift b/Sources/Fluid/Persistence/TranscriptionHistoryStore.swiftindex c089c093..0598e151 100644--- a/Sources/Fluid/Persistence/TranscriptionHistoryStore.swift+++ b/Sources/Fluid/Persistence/TranscriptionHistoryStore.swift@@ -39,6 +39,7 @@ struct TranscriptionHistoryEntry: Codable, Identifiable, Equatable, Sendable {/// message for display / debugging.let aiProcessingError: String?let audio: DictationAudioMetadata?+ var isStarred: Bool/// Rises when a restore gives this id different text. Nil on entries written/// before the field existed, and on entries that were never restored.var searchRevision: UInt64?@@ -58,6 +59,7 @@ struct TranscriptionHistoryEntry: Codable, Identifiable, Equatable, Sendable {aiTokensPerSecond: Double? = nil,aiProcessingError: String? = nil,audio: DictationAudioMetadata? = nil,+ isStarred: Bool = false,searchRevision: UInt64? = nil) {self.id = id@@ -75,6 +77,7 @@ struct TranscriptionHistoryEntry: Codable, Identifiable, Equatable, Sendable {self.aiTokensPerSecond = aiTokensPerSecondself.aiProcessingError = aiProcessingErrorself.audio = audio+ self.isStarred = isStarredself.searchRevision = searchRevision}@@ -94,6 +97,7 @@ struct TranscriptionHistoryEntry: Codable, Identifiable, Equatable, Sendable {aiTokensPerSecond: Double?,aiProcessingError: String?,audio: DictationAudioMetadata?,+ isStarred: Bool,searchRevision: UInt64?) {self.id = id@@ -111,6 +115,7 @@ struct TranscriptionHistoryEntry: Codable, Identifiable, Equatable, Sendable {self.aiTokensPerSecond = aiTokensPerSecondself.aiProcessingError = aiProcessingErrorself.audio = audio+ self.isStarred = isStarredself.searchRevision = searchRevision}@@ -140,6 +145,7 @@ struct TranscriptionHistoryEntry: Codable, Identifiable, Equatable, Sendable {self.aiTokensPerSecond = try container.decodeIfPresent(Double.self, forKey: .aiTokensPerSecond)self.aiProcessingError = try container.decodeIfPresent(String.self, forKey: .aiProcessingError)self.audio = try container.decodeIfPresent(DictationAudioMetadata.self, forKey: .audio)+ self.isStarred = try container.decodeIfPresent(Bool.self, forKey: .isStarred) ?? falseself.searchRevision = try container.decodeIfPresent(UInt64.self, forKey: .searchRevision)}@@ -148,7 +154,7 @@ struct TranscriptionHistoryEntry: Codable, Identifiable, Equatable, Sendable {case characterCount, wasAIProcessed, processingModelcase transcriptionDurationMilliseconds, parakeetProcessingDurationMilliseconds, aiProcessingDurationMillisecondscase aiTokensPerSecond- case aiProcessingError, audio, searchRevision+ case aiProcessingError, audio, searchRevision, isStarred}/// Preview text for list display (first 80 chars)@@ -217,6 +223,7 @@ struct TranscriptionHistoryEntry: Codable, Identifiable, Equatable, Sendable {aiTokensPerSecond: self.aiTokensPerSecond,aiProcessingError: self.aiProcessingError,audio: audio,+ isStarred: self.isStarred,searchRevision: self.searchRevision)}@@ -353,6 +360,12 @@ final class TranscriptionHistoryStore: ObservableObject {DebugLogger.shared.debug("Added transcription to history (total: \(self.entries.count))", source: "TranscriptionHistoryStore")}+ func toggleStar(id: UUID) {+ guard let index = self.entries.firstIndex(where: { $0.id == id }) else { return }+ self.entries[index].isStarred.toggle()+ self.persist(upserts: [self.entries[index]])+ }+/// Delete a specific entryfunc deleteEntry(id: UUID) {self.invalidateAutomaticAudioBudgetMeasurement()@@ -408,13 +421,14 @@ final class TranscriptionHistoryStore: ObservableObject {}/// Search entries by text content- func search(query: String) -> [TranscriptionHistoryEntry] {+ func search(query: String, starredOnly: Bool = false) -> [TranscriptionHistoryEntry] {+ let entries = starredOnly ? self.entries.filter(\.isStarred) : self.entriesguard !query.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty else {- return self.entries+ return entries}let lowercased = query.lowercased()- return self.entries.filter { entry in+ return entries.filter { entry inentry.rawText.lowercased().contains(lowercased) ||entry.processedText.lowercased().contains(lowercased) ||entry.appName.lowercased().contains(lowercased) ||diff --git a/Sources/Fluid/UI/TranscriptionHistoryView.swift b/Sources/Fluid/UI/TranscriptionHistoryView.swiftindex aa2d2b3d..4bcbc970 100644--- a/Sources/Fluid/UI/TranscriptionHistoryView.swift+++ b/Sources/Fluid/UI/TranscriptionHistoryView.swift@@ -8,6 +8,7 @@ struct TranscriptionHistoryView: View {@Environment(\.theme) private var theme@State private var searchQuery: String = ""+ @State private var starredOnly = false@State private var showClearConfirmation: Bool = false@State private var showReportConfirmation: Bool = false@State private var selectedReportEntry: TranscriptionHistoryEntry?@@ -37,7 +38,7 @@ struct TranscriptionHistoryView: View {}private var filteredEntries: [TranscriptionHistoryEntry] {- self.historyStore.search(query: self.searchQuery)+ self.historyStore.search(query: self.searchQuery, starredOnly: self.starredOnly)}private var selectedEntry: TranscriptionHistoryEntry? {@@ -50,8 +51,17 @@ struct TranscriptionHistoryView: View {// MARK: - Left Panel: Entry ListVStack(spacing: 0) {- self.searchBar- .padding(12)+ VStack(spacing: 10) {+ self.searchBar++ Picker("History filter", selection: self.$starredOnly) {+ Text("All").tag(false)+ Text("Starred").tag(true)+ }+ .pickerStyle(.segmented)+ .labelsHidden()+ }+ .padding(12)if self.historyStore.isLoading {ProgressView("Loading history…")@@ -94,6 +104,10 @@ struct TranscriptionHistoryView: View {.frame(minWidth: 400)}}+ .onChange(of: self.filteredEntries.map(\.id), initial: true) { _, visibleIDs in+ if let selectedEntryID = self.selectedEntryID, visibleIDs.contains(selectedEntryID) { return }+ self.selectedEntryID = visibleIDs.first+ }.onChange(of: self.selectedEntry?.id) { _, _ inself.audioEntryID = nil}@@ -132,7 +146,7 @@ struct TranscriptionHistoryView: View {}}} message: {- Text("This will permanently delete all \(self.historyStore.entries.count) transcription entries. This action cannot be undone.")+ Text("This will permanently delete all \(self.historyStore.entries.count) transcription entries, including starred entries. This action cannot be undone.")}.alert("Report Sent", isPresented: self.$showReportConfirmation) {Button("OK", role: .cancel) {}@@ -204,6 +218,7 @@ struct TranscriptionHistoryView: View {guard let id else { return }if !self.filteredEntries.contains(where: { $0.id == id }) {self.searchQuery = ""+ self.starredOnly = falseDispatchQueue.main.async {proxy.scrollTo(id)}@@ -221,6 +236,12 @@ struct TranscriptionHistoryView: View {} label: {VStack(alignment: .leading, spacing: 7) {HStack(spacing: 8) {+ if entry.isStarred {+ Image(systemName: "star.fill")+ .font(self.theme.typography.captionStrong)+ .foregroundStyle(self.theme.palette.accent)+ .accessibilityLabel("Starred")+ }HistoryAppIcon(appName: entry.appName)Spacer(minLength: 4)Text(entry.relativeTimeString)@@ -310,6 +331,14 @@ struct TranscriptionHistoryView: View {@ViewBuilderprivate func entryActions(_ entry: TranscriptionHistoryEntry) -> some View {+ Button {+ self.historyStore.toggleStar(id: entry.id)+ } label: {+ Label(entry.isStarred ? "Unstar" : "Star", systemImage: entry.isStarred ? "star.slash" : "star")+ }++ Divider()+Button {self.copyFinalText(entry)} label: {@@ -369,22 +398,37 @@ struct TranscriptionHistoryView: View {// MARK: - Empty State+ private var emptyStateIcon: String {+ if !self.searchQuery.isEmpty { return "magnifyingglass" }+ return self.starredOnly ? "star" : "clock.arrow.circlepath"+ }++ private var emptyStateTitle: String {+ if !self.searchQuery.isEmpty { return "No Results" }+ return self.starredOnly ? "No Starred Transcriptions" : "No History Yet"+ }++ private var emptyStateMessage: String {+ if !self.searchQuery.isEmpty { return "Try a different search term" }+ return self.starredOnly+ ? "Star a transcription to find it here quickly"+ : "Your transcriptions will appear here"+ }+private var emptyStateView: some View {VStack(spacing: 16) {Spacer()- Image(systemName: self.searchQuery.isEmpty ? "clock.arrow.circlepath" : "magnifyingglass")+ Image(systemName: self.emptyStateIcon).font(.fluidSystem(size: 36, weight: .light)).foregroundStyle(.tertiary)VStack(spacing: 4) {- Text(self.searchQuery.isEmpty ? "No History Yet" : "No Results")+ Text(self.emptyStateTitle).font(.fluidSystem(size: 14, weight: .semibold)).foregroundStyle(.secondary)- Text(self.searchQuery.isEmpty- ? "Your transcriptions will appear here"- : "Try a different search term")+ Text(self.emptyStateMessage).font(.fluidSystem(size: 12)).foregroundStyle(.tertiary).multilineTextAlignment(.center)@@ -405,7 +449,7 @@ struct TranscriptionHistoryView: View {HStack {// Stats- Text("\(self.historyStore.entries.count) entries")+ Text(self.filteredEntries.count == 1 ? "1 entry" : "\(self.filteredEntries.count) entries").font(.fluidSystem(size: 11, weight: .medium)).foregroundStyle(.tertiary)@@ -445,6 +489,19 @@ struct TranscriptionHistoryView: View {self.detailActions(entry)}}+ HStack {+ Spacer()+ Button {+ self.historyStore.toggleStar(id: entry.id)+ } label: {+ Label(entry.isStarred ? "Starred" : "Star", systemImage: entry.isStarred ? "star.fill" : "star")+ }+ .buttonStyle(.bordered)+ .controlSize(.small)+ .tint(entry.isStarred ? self.theme.palette.accent : nil)+ .accessibilityLabel(entry.isStarred ? "Unstar transcription" : "Star transcription")+ .help(entry.isStarred ? "Remove from Starred" : "Save to Starred")+ }if self.audioEntryID == entry.id {HistoryInlineAudioView(entry: entry).id(entry.id)diff --git a/Tests/HistoryPersistenceBoundaryTests.swift b/Tests/HistoryPersistenceBoundaryTests.swiftindex 48529b00..09fe0b5b 100644--- a/Tests/HistoryPersistenceBoundaryTests.swift+++ b/Tests/HistoryPersistenceBoundaryTests.swift@@ -66,13 +66,21 @@ final class DebugLogger {audio: index == 0 ? audio : nil)}- try defaults.set(JSONEncoder().encode(legacy), forKey: key)+ // Simulate history written before stars existed, including legacy backups.+ guard var legacyJSON = try JSONSerialization.jsonObject(with: JSONEncoder().encode(legacy)) as? [[String: Any]] else {+ preconditionFailure("Expected legacy history to encode as an array of objects")+ }+ for index in legacyJSON.indices {+ legacyJSON[index].removeValue(forKey: "isStarred")+ }+ try defaults.set(JSONSerialization.data(withJSONObject: legacyJSON), forKey: key)let url = root.appendingPathComponent("history.sqlite3")let writer = TranscriptionHistoryWriter(defaults: defaults, url: url)let store = TranscriptionHistoryStore(writer: writer)// No actor suspension: these mutations necessarily precede startup loading.let newID = UUID()store.addEntry(id: newID, rawText: "new", processedText: "New dictation", appName: "Test", windowTitle: "Test")+ store.toggleStar(id: newID)store.attachAudio(audio, to: newID)store.deleteEntry(id: legacy[1].id)try await store.waitUntilLoaded()@@ -82,6 +90,8 @@ final class DebugLogger {precondition(defaults.data(forKey: key) == nil, "Retire legacy only after successful import")precondition(store.entries.count == 8400)precondition(store.entries.first(where: { $0.id == newID })?.audio == audio)+ precondition(store.entries.first(where: { $0.id == newID })?.isStarred == true)+ precondition(store.entries.filter(\.isStarred).count == 1, "Legacy entries must default to unstarred")precondition(!store.entries.contains(where: { $0.id == legacy[1].id }))let reloaded = try await TranscriptionHistoryWriter(defaults: defaults, url: url).load()precondition(reloaded == store.entries, "Migration, metadata and concurrent startup edits must round-trip")@@ -91,10 +101,14 @@ final class DebugLogger {try self.sql(url, "CREATE TRIGGER reject_old BEFORE INSERT ON history WHEN NEW.id != '\(newID.uuidString)' BEGIN SELECT RAISE(FAIL, 'unrelated row rewritten'); END")let enqueueStart = ProcessInfo.processInfo.systemUptimestore.attachAudio(audio, to: newID)+ store.toggleStar(id: newID)+ store.toggleStar(id: newID)let enqueueMs = (ProcessInfo.processInfo.systemUptime - enqueueStart) * 1000await store.finishPendingWrites()await Task.yield()precondition(store.persistenceError == nil, "Updating one row must not rewrite unrelated history")+ let afterStar = try await writer.load()+ precondition(afterStar == store.entries, "Rapid star toggles and audio updates must persist in order")print("PASS: single-row audio update; main actor enqueue \(enqueueMs) ms")try self.sql(url, "DROP TRIGGER reject_old")@@ -176,6 +190,60 @@ final class DebugLogger {precondition(afterRepeatedRestore == [expectedRestore], "Repeated restore changes only the persisted search revision")print("PASS: restore during loading replaces both memory and disk")try await self.testTodaySummary(root: root, defaults: defaults, audio: audio)+ try await self.testStars(root: root, defaults: defaults, audio: audio)+ }++ @MainActor static func testStars(root: URL, defaults: UserDefaults, audio: DictationAudioMetadata) async throws {+ let url = root.appendingPathComponent("stars.sqlite3")+ let writer = TranscriptionHistoryWriter(defaults: defaults, url: url)+ let store = TranscriptionHistoryStore(writer: writer)+ try await store.waitUntilLoaded()+ let older = TranscriptionHistoryEntry(+ timestamp: Date(timeIntervalSince1970: 1),+ rawText: "Original phrasing",+ processedText: "Reusable prompt",+ appName: "Editor",+ windowTitle: "Reference",+ wasAIProcessed: true,+ audio: audio,+ isStarred: true+ )+ let newer = TranscriptionHistoryEntry(+ timestamp: Date(timeIntervalSince1970: 2),+ rawText: "Another prompt",+ processedText: "Another prompt",+ appName: "Test",+ windowTitle: "Test",+ wasAIProcessed: false+ )+ store.restore(from: [older, newer])+ precondition(store.search(query: "").map(\.id) == [newer.id, older.id], "Stars must preserve chronological order")+ precondition(store.search(query: " ", starredOnly: true).map(\.id) == [older.id])+ for query in ["PROMPT", "Original", "Editor", "Reference"] {+ precondition(store.search(query: query, starredOnly: true).map(\.id) == [older.id], "Search must intersect with stars across every field")+ }+ precondition(store.search(query: "Another", starredOnly: true).isEmpty)+ precondition(older.replacingAudio(nil).isStarred, "Audio removal must preserve the star")+ let backup = try JSONDecoder().decode([TranscriptionHistoryEntry].self, from: JSONEncoder().encode(store.makeBackupPayload()))+ store.toggleStar(id: older.id)+ await store.finishPendingWrites()+ let unstarred = try await writer.load()+ precondition(!unstarred.contains(where: \.isStarred), "Removing a star must survive restart")+ store.restore(from: backup)+ await store.finishPendingWrites()+ let restored = try await TranscriptionHistoryWriter(defaults: defaults, url: url).load()+ let normalizedRestore = restored.map { entry in+ var entry = entry+ entry.searchRevision = backup.first(where: { $0.id == entry.id })?.searchRevision+ return entry+ }+ precondition(normalizedRestore == backup, "Backup restore must retain stars and metadata while refreshing search revisions")+ store.deleteEntry(id: older.id)+ store.toggleStar(id: older.id)+ await store.finishPendingWrites()+ let afterDelete = try await writer.load()+ precondition(afterDelete == restored.filter { $0.id == newer.id }, "A stale star action must not resurrect a deleted entry")+ print("PASS: star filtering/search, chronology, audio preservation, unstar/restart, backup restore and deletion")}@MainActor static func testTodaySummary(root: URL, defaults: UserDefaults, audio: DictationAudioMetadata) async throws {