feat: remove 300-entry cap and add architecture docs

Clipboard history is now unlimited — removed the hard 300-entry prune-on-insert
limit. Users can manage history size via the existing auto-prune setting.

Added docs/architecture.html: interactive visual explainer covering the full
system architecture, search pipeline, paste flow, image processing, data layer,
window system, and key design decisions.

Author: lolwierd

CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project are documented in this file.
 
 ## [Unreleased]
 
+### Changed
+
+- Clipboard history is now unlimited (removed the hard 300-entry cap). Entries accumulate indefinitely; use the auto-prune setting to manage size by age.
+
+### Added
+
+- Architecture documentation: `docs/architecture.html` — interactive visual explainer covering the full system.
+
 ## [0.2.0] - 2026-02-20
 
 ### Added

Sources/CBManager/ClipboardDatabase.swift

@@ -22,20 +22,17 @@ final class ClipboardDatabase {
         sqlite3_close(db)
     }
 
-    func loadEntries(limit: Int) -> [ClipboardEntry] {
+    func loadEntries() -> [ClipboardEntry] {
         let sql = """
         SELECT id, created_at, source_app, kind, content, image_path, ocr_text, ocr_pending,
                ai_title, ai_title_pending
         FROM clipboard_entries
-        ORDER BY created_at DESC
-        LIMIT ?;
+        ORDER BY created_at DESC;
         """
 
         guard let statement = prepare(sql) else { return [] }
         defer { sqlite3_finalize(statement) }
 
-        sqlite3_bind_int(statement, 1, Int32(limit))
-
         var result: [ClipboardEntry] = []
         while sqlite3_step(statement) == SQLITE_ROW {
             let id = string(at: 0, from: statement) ?? UUID().uuidString
@@ -180,22 +177,6 @@ final class ClipboardDatabase {
         return removed
     }
 
-    func prune(limit: Int) {
-        let sql = """
-        DELETE FROM clipboard_entries
-        WHERE id NOT IN (
-            SELECT id FROM clipboard_entries
-            ORDER BY created_at DESC
-            LIMIT ?
-        );
-        """
-
-        guard let statement = prepare(sql) else { return }
-        defer { sqlite3_finalize(statement) }
-
-        sqlite3_bind_int(statement, 1, Int32(limit))
-        sqlite3_step(statement)
-    }
 
     private func openDatabase() {
         guard sqlite3_open(dbPath, &db) == SQLITE_OK else {

Sources/CBManager/ClipboardStore.swift

@@ -134,7 +134,6 @@ final class ClipboardStore: ObservableObject {
     private var pendingImageDeletions: [String: Date] = [:]
     private let undoWindow: TimeInterval = 20
 
-    private let limit = 300
     private let database = ClipboardDatabase()
     private let imageDirectory: URL
     private let qmdSearch: QMDSearchEngine
@@ -149,7 +148,7 @@ final class ClipboardStore: ObservableObject {
         self.imageDirectory = imageDirectory
         self.qmdSearch = QMDSearchEngine(baseDirectory: base)
 
-        entries = database.loadEntries(limit: limit)
+        entries = database.loadEntries()
 
         let qmdSearch = self.qmdSearch
         Task { [weak self, qmdSearch] in
@@ -282,7 +281,6 @@ final class ClipboardStore: ObservableObject {
             generateTitleForImageEntry(newEntry)
         }
 
-        pruneIfNeeded()
         scheduleQMDSearch()
     }
 
@@ -409,24 +407,6 @@ final class ClipboardStore: ObservableObject {
         return false
     }
 
-    private func pruneIfNeeded() {
-        guard entries.count > limit else { return }
-
-        let removed = entries.suffix(from: limit)
-        entries.removeLast(entries.count - limit)
-        database.prune(limit: limit)
-
-        for entry in removed {
-            if let path = entry.imagePath {
-                try? FileManager.default.removeItem(atPath: path)
-                pendingImageDeletions.removeValue(forKey: path)
-            }
-            if isQMDAvailable {
-                Task { await qmdSearch.remove(id: entry.id) }
-            }
-        }
-    }
-
     private func captureClipboardEntry(from pasteboard: NSPasteboard) -> ClipboardEntry? {
         let sourceApp = NSWorkspace.shared.frontmostApplication?.localizedName