@hasna/recordings 0.2.11 → 0.2.13

package/src/native/Recordings/RecordingsLib/RecordingStartControlPresentation.swift

@@ -0,0 +1,29 @@
+/// Shared presentation contract for every control that starts a new recording. Keeping the
+/// labels and enabled state together prevents a ready or error surface from offering an action
+/// that `RecordingEngine` would reject while clipboard delivery is still settling.
+public struct RecordingStartControlPresentation: Equatable, Sendable {
+    public enum Kind: CaseIterable, Sendable {
+        case record
+        case recordAgain
+        case tryAgain
+    }
+
+    public let title: String
+    public let accessibilityLabel: String
+    public let isEnabled: Bool
+
+    public init(kind: Kind, canStartRecording: Bool) {
+        switch kind {
+        case .record:
+            title = "Record"
+            accessibilityLabel = "Start recording"
+        case .recordAgain:
+            title = "Record Again"
+            accessibilityLabel = "Start a new recording"
+        case .tryAgain:
+            title = "Try Again"
+            accessibilityLabel = "Try recording again"
+        }
+        isEnabled = canStartRecording
+    }
+}

package/src/native/Recordings/RecordingsLib/RecordingsCLI.entitlements

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>com.apple.security.cs.allow-jit</key>
+    <true/>
+    <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
+    <true/>
+</dict>
+</plist>

package/src/native/Recordings/RecordingsLib/RecordingsCLI.swift

@@ -0,0 +1,222 @@
+import Foundation
+
+/// Swift bridge over the `recordings` CLI. The macOS app uses this for the library,
+/// search, stats, and active Store — reusing the exact same local/HTTP
+/// store the CLI and MCP server write, instead of re-implementing persistence in Swift.
+public enum RecordingsCLI {
+    public struct Failure: Error, CustomStringConvertible {
+        public let message: String
+        public var description: String { message }
+    }
+
+    public static var defaultHome: String {
+        FileManager.default.homeDirectoryForCurrentUser.path
+    }
+
+    public struct PackagedCompanionProbe: Sendable, Equatable {
+        public let executablePath: String
+        public let version: String
+
+        public init(executablePath: String, version: String) {
+            self.executablePath = executablePath
+            self.version = version
+        }
+    }
+
+    /// Exercise the resolver and the read/write capabilities the installed app depends on.
+    /// A packaged app must resolve only its embedded helper; PATH fallbacks are rejected.
+    public static func probePackagedCompanion(home: String) throws -> PackagedCompanionProbe {
+        let command = CLIRunner.resolveCommand(home: home)
+        let expected = Bundle.main.bundleURL.appendingPathComponent("Contents/Helpers/recordings").path
+        guard Bundle.main.bundleURL.pathExtension.caseInsensitiveCompare("app") == .orderedSame,
+              command.executable == expected,
+              command.argumentsPrefix.isEmpty else {
+            throw Failure(message: "Packaged companion resolver did not select the embedded helper")
+        }
+        let versionOutput = CLIRunner.run(["--version"], home: home)
+            .trimmingCharacters(in: .whitespacesAndNewlines)
+        if let error = CLIRunner.parseError(versionOutput) { throw Failure(message: error) }
+        let expectedVersion = Bundle.main.object(forInfoDictionaryKey: "CFBundleShortVersionString") as? String
+        guard !versionOutput.isEmpty, versionOutput == expectedVersion else {
+            throw Failure(message: "Packaged companion version does not match the app")
+        }
+        let project = try registerProject(
+            name: "Activated Helper Contract",
+            path: "recordings-app://install/activated-helper-contract",
+            description: "Installed app resolver verification",
+            home: home
+        )
+        guard project.name == "Activated Helper Contract" else {
+            throw Failure(message: "Packaged companion project capability failed")
+        }
+        let saved = CLIRunner.run(
+            ["--json", "save-text", "Activated helper contract", "--source", "native_install_contract", "--post-processing", "off"],
+            home: home
+        )
+        struct SavedRecording: Decodable { let raw_text: String }
+        let recording = try decode(SavedRecording.self, from: saved)
+        guard recording.raw_text == "Activated helper contract" else {
+            throw Failure(message: "Packaged companion recording capability failed")
+        }
+        return PackagedCompanionProbe(executablePath: command.executable, version: versionOutput)
+    }
+
+    // MARK: - Library
+
+    public static func list(limit: Int = 100, offset: Int = 0, projectId: String? = nil, home: String = defaultHome) throws -> [Recording] {
+        var args = ["--json"]
+        if let projectId, !projectId.isEmpty { args += ["--project", projectId] }
+        args += ["list", "-n", String(limit), "--offset", String(offset)]
+        return try runDecoding([Recording].self, args, home: home)
+    }
+
+    /// Load the complete library in pages. The HTTP store caps each request at 500,
+    /// while the local SQLite store accepts the same offset/limit contract.
+    public static func listAll(pageSize: Int = 500, home: String = defaultHome) throws -> [Recording] {
+        try collectAllPages(pageSize: pageSize) { limit, offset in
+            try list(limit: limit, offset: offset, home: home)
+        }
+    }
+
+    static func collectAllPages(
+        pageSize: Int = 500,
+        loadPage: (_ limit: Int, _ offset: Int) throws -> [Recording]
+    ) rethrows -> [Recording] {
+        let size = max(1, min(pageSize, 500))
+        var recordings: [Recording] = []
+        var seen = Set<String>()
+        var offset = 0
+
+        while true {
+            let page = try loadPage(size, offset)
+            let unseen = page.filter { seen.insert($0.id).inserted }
+            recordings.append(contentsOf: unseen)
+
+            guard page.count == size, !unseen.isEmpty else { break }
+            offset += page.count
+        }
+
+        return recordings
+    }
+
+    public static func show(id: String, home: String = defaultHome) throws -> Recording {
+        try runDecoding(Recording.self, ["--json", "show", id], home: home)
+    }
+
+    public static func search(_ query: String, limit: Int = 100, home: String = defaultHome) throws -> [Recording] {
+        let trimmed = query.trimmingCharacters(in: .whitespacesAndNewlines)
+        guard !trimmed.isEmpty else { return try list(limit: limit, home: home) }
+        return try runDecoding([Recording].self, ["--json", "search", trimmed, "-n", String(limit)], home: home)
+    }
+
+    public static func stats(home: String = defaultHome) throws -> RecordingStats {
+        try runDecoding(RecordingStats.self, ["--json", "stats"], home: home)
+    }
+
+    public static func delete(id: String, home: String = defaultHome) throws {
+        let output = CLIRunner.run(["delete", id], home: home)
+        if let err = CLIRunner.parseError(output) { throw Failure(message: err) }
+    }
+
+    public struct CanonicalProject: Codable, Sendable {
+        public let id: String
+        public let name: String
+        public let path: String
+    }
+
+    public static func registerProject(
+        name: String,
+        path: String,
+        description: String = "Recordings macOS project",
+        home: String = defaultHome
+    ) throws -> CanonicalProject {
+        try runDecoding(
+            CanonicalProject.self,
+            ["--json", "project", "register", "--name", name, "--path", path, "--description", description],
+            home: home
+        )
+    }
+
+    // MARK: - Internals
+
+    private static func runDecoding<T: Decodable>(_ type: T.Type, _ args: [String], home: String) throws -> T {
+        let output = CLIRunner.run(args, home: home)
+        if let err = CLIRunner.parseError(output) { throw Failure(message: err) }
+        return try decode(type, from: output)
+    }
+
+    static func decode<T: Decodable>(_ type: T.Type, from output: String) throws -> T {
+        let candidates = Self.jsonCandidates(from: output)
+        guard !candidates.isEmpty else {
+            throw Failure(message: "No JSON in CLI output")
+        }
+        var lastError: Error?
+        for json in candidates.reversed() {
+            guard let data = json.data(using: .utf8) else { continue }
+            do {
+                return try JSONDecoder().decode(T.self, from: data)
+            } catch {
+                lastError = error
+            }
+        }
+        throw Failure(message: "Failed to decode \(T.self): \(lastError?.localizedDescription ?? "invalid JSON")")
+    }
+
+    /// Find a balanced, valid top-level JSON array or object while ignoring bracketed logs.
+    static func extractJSON(from output: String) -> String? {
+        jsonCandidates(from: output).last
+    }
+
+    static func jsonCandidates(from output: String) -> [String] {
+        let trimmed = output.trimmingCharacters(in: .whitespacesAndNewlines)
+        guard !trimmed.isEmpty else { return [] }
+        var candidates: [String] = []
+        var cursor = trimmed.startIndex
+
+        while cursor < trimmed.endIndex {
+            guard let start = trimmed[cursor...].firstIndex(where: { $0 == "[" || $0 == "{" }) else { break }
+            var stack: [Character] = []
+            var inString = false
+            var escaped = false
+            var index = start
+            var candidateEnd: String.Index?
+
+            scan: while index < trimmed.endIndex {
+                let character = trimmed[index]
+                if inString {
+                    if escaped { escaped = false }
+                    else if character == "\\" { escaped = true }
+                    else if character == "\"" { inString = false }
+                } else {
+                    switch character {
+                    case "\"": inString = true
+                    case "[": stack.append("]")
+                    case "{": stack.append("}")
+                    case "]", "}":
+                        guard stack.last == character else { break scan }
+                        stack.removeLast()
+                        if stack.isEmpty {
+                            candidateEnd = index
+                            break scan
+                        }
+                    default: break
+                    }
+                }
+                index = trimmed.index(after: index)
+            }
+
+            if let end = candidateEnd {
+                let candidate = String(trimmed[start...end])
+                if let data = candidate.data(using: .utf8),
+                   let value = try? JSONSerialization.jsonObject(with: data),
+                   value is [Any] || value is [String: Any] {
+                    candidates.append(candidate)
+                }
+                cursor = trimmed.index(after: end)
+            } else {
+                cursor = trimmed.index(after: start)
+            }
+        }
+        return candidates
+    }
+}

package/src/native/Recordings/RecordingsLib/SettingsView.swift

@@ -19,7 +19,15 @@ public struct SettingsView: View {
             projectsTab.tabItem { Label("Projects", systemImage: "folder") }
             shortcutsTab.tabItem { Label("Voice Shortcuts", systemImage: "text.badge.star") }
         }
-        .frame(width: 520, height: 440)
+        .frame(width: 520, height: 500)
+        .alert("Project Settings Error", isPresented: Binding(
+            get: { projectStore.persistenceError != nil },
+            set: { if !$0 { projectStore.clearPersistenceError() } }
+        )) {
+            Button("OK", role: .cancel) {}
+        } message: {
+            Text(projectStore.persistenceError ?? "The project settings could not be saved.")
+        }
     }
 
     // MARK: - General
@@ -41,6 +49,12 @@ public struct SettingsView: View {
                     .foregroundStyle(.secondary)
             }
 
+            Section("Intent") {
+                Toggle("Detect questions and edit commands", isOn: $engine.intentDetectionEnabled)
+                Text("When on, Recordings infers whether you dictated, asked a question, or asked it to edit the selected text. Anything uncertain is typed out literally. When off, every recording is typed out.")
+                    .foregroundStyle(.secondary)
+            }
+
             Section("Recording Shortcut") {
                 HStack {
                     Text("Shortcut")
@@ -84,15 +98,25 @@ public struct SettingsView: View {
                 }
             }
 
-            Section("System Prompt") {
+            Section("Transcription Cleanup") {
+                Picker("Mode", selection: $projectStore.settings.postProcessingMode) {
+                    ForEach(PostProcessingMode.allCases) { mode in
+                        Text(mode.label).tag(mode.rawValue)
+                    }
+                }
+                .pickerStyle(.segmented)
+                .onChange(of: projectStore.settings.postProcessingMode) {
+                    try? projectStore.save()
+                }
                 TextEditor(text: $projectStore.settings.globalSystemPrompt)
                     .frame(height: 80)
                     .onChange(of: projectStore.settings.globalSystemPrompt) {
-                        projectStore.save()
+                        try? projectStore.save()
                     }
-                Text("Applied to all transcription enhancements.")
+                Text("Instructions for post-transcription cleanup and formatting.")
                     .foregroundStyle(.secondary)
             }
+            .disabled(!projectStore.canMutateProjects)
         }
         .formStyle(.grouped).padding()
     }
@@ -109,8 +133,13 @@ public struct SettingsView: View {
                     .textFieldStyle(.roundedBorder)
                 Button("Add") {
                     guard !newProjectName.isEmpty else { return }
-                    projectStore.addProject(name: newProjectName)
-                    newProjectName = ""
+                    let name = newProjectName
+                    Task {
+                        do {
+                            try await projectStore.addProject(name: name)
+                            newProjectName = ""
+                        } catch {}
+                    }
                 }
                 .disabled(newProjectName.isEmpty)
             }
@@ -134,12 +163,13 @@ public struct SettingsView: View {
                     }
                     .onDelete { indexSet in
                         for i in indexSet {
-                            projectStore.removeProject(id: projectStore.settings.projects[i].id)
+                            try? projectStore.removeProject(id: projectStore.settings.projects[i].id)
                         }
                     }
                 }
             }
         }
+        .disabled(!projectStore.canMutateProjects)
         .sheet(item: $editingProject) { project in
             ProjectEditView(project: project, store: projectStore) {
                 editingProject = nil
@@ -230,25 +260,29 @@ struct ProjectEditView: View {
                     .textFieldStyle(.roundedBorder)
                 }
 
-                Section("System Prompt") {
+                Section("Transcriber Instructions") {
                     TextEditor(text: Binding(
                         get: { project.systemPrompt ?? "" },
                         set: { project.systemPrompt = $0.isEmpty ? nil : $0 }
                     ))
                     .frame(height: 100)
-                    Text("Additional context for transcription enhancement in this project.")
+                    Text("Project-specific cleanup and formatting instructions.")
                         .foregroundStyle(.secondary)
                 }
             }
             .formStyle(.grouped)
+            .disabled(!store.canMutateProjects)
 
             HStack {
                 Spacer()
                 Button("Cancel") { onDismiss() }
                 Button("Save") {
-                    store.updateProject(project)
-                    onDismiss()
+                    do {
+                        try store.updateProject(project)
+                        onDismiss()
+                    } catch {}
                 }
+                .disabled(!store.canMutateProjects)
             }
             .padding()
         }