release: 0.5.3

Author: lolwierd

AGENTS.md

@@ -78,7 +78,7 @@ swift test
    - Fuzzy search must be instant.
    - QMD keyword + semantic results augment fuzzy.
    - QMD keyword threshold: 3+ chars.
-   - QMD semantic threshold: 3+ chars.
+   - QMD semantic threshold: 5+ chars.
 
 5. **Layout stability**
    - Avoid row height jitter / implicit list animation regressions.

CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project are documented in this file.
 
 ## [Unreleased]
 
+## [0.5.3] - 2026-04-09
+
+### Fixed
+
+- Fixed paste-back targeting so `Return` waits for the previously focused app to reactivate before sending `⌘V` instead of firing into nowhere.
+- Preserved real Finder/file-url clipboard payloads for path entries, so copied files paste back as files instead of plain-text paths.
+- Re-expanded the visible row window around restored selections so delete/undo keeps focus on the restored row even in large filtered result sets.
+
 ### Performance
 
 - Moved clipboard filtering/ranking off the main actor so large histories and long clipboard items no longer block typing or overlay refresh while search results are recomputed.
@@ -14,7 +22,7 @@ All notable changes to this project are documented in this file.
 - Moved overlay preview details and image thumbnails off the SwiftUI render path so search, delete, selection, and preview interactions no longer decode images or scan large text synchronously on the main thread.
 - Suspended clipboard polling while the overlay is visible, reduced delete-cleanup churn, and stopped delete/undo from clearing live QMD results just to rerun the same query.
 - Replaced full-file image duplicate reads with sampled image signatures and switched image paste-back/preview loading away from synchronous full-image decodes.
-- Disabled QMD runtime search/index integration so overlay interactions now stay on the local fuzzy-search path and no longer spawn qmd work while the app is running.
+- Restored QMD runtime search/index integration behind the async fuzzy-first pipeline so overlay typing stays responsive while keyword/semantic results merge in later.
 - Made local search/regroup work cooperatively cancellable, raised search-input coalescing, and lowered overlay rebuild priority so quick search edits stop piling up stale rescans.
 - Reduced overlay layout churn by removing animated auto-scroll on search-driven selection changes, trimming inline preview text work, and rendering the overlay list through a rolling 100-entry window that expands as you scroll.
 - Replaced the custom overlay `ScrollView`/`LazyVStack` history pane with a native `List` while keeping search scoped to the full result set, which fixes the remaining fast-scroll lag without narrowing search coverage.

README.md

@@ -127,8 +127,8 @@ You can also right-click the app and choose **Open** once to allow launch.
 
 ## Search behavior
 
-Search currently uses only the local fuzzy ranking pipeline.
-The previous QMD augmentation path has been disabled to prioritize instant overlay responsiveness on large histories.
+Search uses an instant local fuzzy ranking pipeline first, then asynchronously appends QMD results without blocking typing or list refresh.
+QMD keyword search starts at 3+ characters, and semantic search starts at 5+ characters.
 To keep the overlay responsive, the live list starts with 100 rendered matches and expands the window as you scroll while still searching across the full result set.
 
 ## Troubleshooting

Sources/CBManager/ClipboardDatabase.swift

@@ -24,7 +24,7 @@ final class ClipboardDatabase {
 
     func loadEntries() -> [ClipboardEntry] {
         let sql = """
-        SELECT id, created_at, source_app, kind, content, image_path, ocr_text, ocr_pending,
+        SELECT id, created_at, source_app, kind, content, file_urls, image_path, ocr_text, ocr_pending,
                ai_title, ai_title_pending
         FROM clipboard_entries
         ORDER BY created_at DESC;
@@ -40,11 +40,12 @@ final class ClipboardDatabase {
             let sourceApp = string(at: 2, from: statement)
             let kindString = string(at: 3, from: statement) ?? ClipboardEntry.Kind.text.rawValue
             let content = string(at: 4, from: statement) ?? ""
-            let imagePath = string(at: 5, from: statement)
-            let ocrText = string(at: 6, from: statement) ?? ""
-            let isPending = sqlite3_column_int(statement, 7) != 0
-            let aiTitle = string(at: 8, from: statement) ?? ""
-            let aiTitlePending = sqlite3_column_int(statement, 9) != 0
+            let fileURLs = decodeFileURLs(from: string(at: 5, from: statement))
+            let imagePath = string(at: 6, from: statement)
+            let ocrText = string(at: 7, from: statement) ?? ""
+            let isPending = sqlite3_column_int(statement, 8) != 0
+            let aiTitle = string(at: 9, from: statement) ?? ""
+            let aiTitlePending = sqlite3_column_int(statement, 10) != 0
 
             let kind = ClipboardEntry.Kind(rawValue: kindString) ?? .text
             result.append(
@@ -54,6 +55,7 @@ final class ClipboardDatabase {
                     date: Date(timeIntervalSince1970: createdAt),
                     sourceApp: sourceApp,
                     kind: kind,
+                    fileURLs: fileURLs,
                     imagePath: imagePath,
                     ocrText: ocrText,
                     isOCRPending: isPending,
@@ -69,8 +71,8 @@ final class ClipboardDatabase {
     func insert(_ entry: ClipboardEntry) {
         let sql = """
         INSERT OR REPLACE INTO clipboard_entries
-        (id, created_at, source_app, kind, content, image_path, ocr_text, ocr_pending, ai_title, ai_title_pending)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?);
+        (id, created_at, source_app, kind, content, file_urls, image_path, ocr_text, ocr_pending, ai_title, ai_title_pending)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?);
         """
 
         guard let statement = prepare(sql) else { return }
@@ -81,11 +83,12 @@ final class ClipboardDatabase {
         sqlite3_bind_nullable_text(statement, 3, entry.sourceApp)
         sqlite3_bind_text(statement, 4, entry.kind.rawValue, -1, SQLITE_TRANSIENT)
         sqlite3_bind_text(statement, 5, entry.content, -1, SQLITE_TRANSIENT)
-        sqlite3_bind_nullable_text(statement, 6, entry.imagePath)
-        sqlite3_bind_text(statement, 7, entry.ocrText, -1, SQLITE_TRANSIENT)
-        sqlite3_bind_int(statement, 8, entry.isOCRPending ? 1 : 0)
-        sqlite3_bind_text(statement, 9, entry.aiTitle, -1, SQLITE_TRANSIENT)
-        sqlite3_bind_int(statement, 10, entry.isAITitlePending ? 1 : 0)
+        sqlite3_bind_nullable_text(statement, 6, encodeFileURLs(entry.fileURLs))
+        sqlite3_bind_nullable_text(statement, 7, entry.imagePath)
+        sqlite3_bind_text(statement, 8, entry.ocrText, -1, SQLITE_TRANSIENT)
+        sqlite3_bind_int(statement, 9, entry.isOCRPending ? 1 : 0)
+        sqlite3_bind_text(statement, 10, entry.aiTitle, -1, SQLITE_TRANSIENT)
+        sqlite3_bind_int(statement, 11, entry.isAITitlePending ? 1 : 0)
 
         sqlite3_step(statement)
     }
@@ -127,7 +130,7 @@ final class ClipboardDatabase {
 
         // First, load the entries that will be deleted so callers can clean up image files.
         let selectSQL = """
-        SELECT id, created_at, source_app, kind, content, image_path, ocr_text, ocr_pending,
+        SELECT id, created_at, source_app, kind, content, file_urls, image_path, ocr_text, ocr_pending,
                ai_title, ai_title_pending
         FROM clipboard_entries
         WHERE created_at < ?
@@ -144,11 +147,12 @@ final class ClipboardDatabase {
                 let sourceApp = string(at: 2, from: selectStmt)
                 let kindString = string(at: 3, from: selectStmt) ?? ClipboardEntry.Kind.text.rawValue
                 let content = string(at: 4, from: selectStmt) ?? ""
-                let imagePath = string(at: 5, from: selectStmt)
-                let ocrText = string(at: 6, from: selectStmt) ?? ""
-                let isPending = sqlite3_column_int(selectStmt, 7) != 0
-                let aiTitle = string(at: 8, from: selectStmt) ?? ""
-                let aiTitlePending = sqlite3_column_int(selectStmt, 9) != 0
+                let fileURLs = decodeFileURLs(from: string(at: 5, from: selectStmt))
+                let imagePath = string(at: 6, from: selectStmt)
+                let ocrText = string(at: 7, from: selectStmt) ?? ""
+                let isPending = sqlite3_column_int(selectStmt, 8) != 0
+                let aiTitle = string(at: 9, from: selectStmt) ?? ""
+                let aiTitlePending = sqlite3_column_int(selectStmt, 10) != 0
 
                 let kind = ClipboardEntry.Kind(rawValue: kindString) ?? .text
                 removed.append(ClipboardEntry(
@@ -157,6 +161,7 @@ final class ClipboardDatabase {
                     date: Date(timeIntervalSince1970: createdAt),
                     sourceApp: sourceApp,
                     kind: kind,
+                    fileURLs: fileURLs,
                     imagePath: imagePath,
                     ocrText: ocrText,
                     isOCRPending: isPending,
@@ -193,9 +198,12 @@ final class ClipboardDatabase {
             source_app TEXT,
             kind TEXT NOT NULL,
             content TEXT,
+            file_urls TEXT,
             image_path TEXT,
             ocr_text TEXT,
-            ocr_pending INTEGER NOT NULL DEFAULT 0
+            ocr_pending INTEGER NOT NULL DEFAULT 0,
+            ai_title TEXT NOT NULL DEFAULT '',
+            ai_title_pending INTEGER NOT NULL DEFAULT 0
         );
 
         CREATE INDEX IF NOT EXISTS idx_clipboard_entries_created_at ON clipboard_entries(created_at DESC);
@@ -206,6 +214,7 @@ final class ClipboardDatabase {
 
     private func migrateIfNeeded() {
         _ = sqlite3_exec(db, "ALTER TABLE clipboard_entries ADD COLUMN ocr_pending INTEGER NOT NULL DEFAULT 0;", nil, nil, nil)
+        _ = sqlite3_exec(db, "ALTER TABLE clipboard_entries ADD COLUMN file_urls TEXT;", nil, nil, nil)
         _ = sqlite3_exec(db, "ALTER TABLE clipboard_entries ADD COLUMN ai_title TEXT NOT NULL DEFAULT '';", nil, nil, nil)
         _ = sqlite3_exec(db, "ALTER TABLE clipboard_entries ADD COLUMN ai_title_pending INTEGER NOT NULL DEFAULT 0;", nil, nil, nil)
     }
@@ -223,6 +232,24 @@ final class ClipboardDatabase {
         guard let cString = sqlite3_column_text(statement, index) else { return nil }
         return String(cString: cString)
     }
+
+    private func encodeFileURLs(_ urls: [String]) -> String? {
+        guard !urls.isEmpty,
+              let data = try? JSONEncoder().encode(urls),
+              let encoded = String(data: data, encoding: .utf8) else {
+            return nil
+        }
+        return encoded
+    }
+
+    private func decodeFileURLs(from value: String?) -> [String] {
+        guard let value,
+              let data = value.data(using: .utf8),
+              let urls = try? JSONDecoder().decode([String].self, from: data) else {
+            return []
+        }
+        return urls
+    }
 }
 
 private extension OpaquePointer {