Skip to content

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.swift
index 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 = aiTokensPerSecond
self.aiProcessingError = aiProcessingError
self.audio = audio
+ self.isStarred = isStarred
self.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 = aiTokensPerSecond
self.aiProcessingError = aiProcessingError
self.audio = audio
+ self.isStarred = isStarred
self.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) ?? false
self.searchRevision = try container.decodeIfPresent(UInt64.self, forKey: .searchRevision)
}
@@ -148,7 +154,7 @@ struct TranscriptionHistoryEntry: Codable, Identifiable, Equatable, Sendable {
case characterCount, wasAIProcessed, processingModel
case transcriptionDurationMilliseconds, parakeetProcessingDurationMilliseconds, aiProcessingDurationMilliseconds
case 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 entry
func 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.entries
guard !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 in
entry.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.swift
index 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 List
VStack(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) { _, _ in
self.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 = false
DispatchQueue.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 {
@ViewBuilder
private 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.swift
index 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.systemUptime
store.attachAudio(audio, to: newID)
+ store.toggleStar(id: newID)
+ store.toggleStar(id: newID)
let enqueueMs = (ProcessInfo.processInfo.systemUptime - enqueueStart) * 1000
await 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 {