agent-cli 0.95.8__tar.gz → 0.95.9__tar.gz

agent_cli-0.95.9/.github/scripts/update_cask.py

@@ -0,0 +1,87 @@
+"""Update the Agent CLI Homebrew cask version and checksum."""
+
+from __future__ import annotations
+
+import argparse
+import re
+from pathlib import Path
+
+VERSION_RE = re.compile(r'^(?P<indent>\s*)version "[^"]+"$')
+SHA256_RE = re.compile(r'^(?P<indent>\s*)sha256 "[0-9a-f]{64}"$')
+
+
+def _validate_sha256(value: str) -> str:
+    if not re.fullmatch(r"[0-9a-f]{64}", value):
+        msg = "sha256 must be 64 lowercase hexadecimal characters"
+        raise ValueError(msg)
+    return value
+
+
+def _validate_version(value: str) -> str:
+    value = value.removeprefix("v")
+    if not re.fullmatch(r"\d+(?:\.\d+)*(?:[-,._A-Za-z0-9]+)?", value):
+        msg = f"unsupported cask version: {value}"
+        raise ValueError(msg)
+    return value
+
+
+def update_cask_text(text: str, *, version: str, sha256: str) -> str:
+    """Replace the single version and sha256 stanzas in a cask."""
+    version = _validate_version(version)
+    sha256 = _validate_sha256(sha256)
+
+    version_count = 0
+    sha256_count = 0
+    lines: list[str] = []
+    for source_line in text.splitlines(keepends=True):
+        newline = "\n" if source_line.endswith("\n") else ""
+        content = source_line.removesuffix("\n")
+
+        if match := VERSION_RE.match(content):
+            output_line = f'{match.group("indent")}version "{version}"{newline}'
+            version_count += 1
+        elif match := SHA256_RE.match(content):
+            output_line = f'{match.group("indent")}sha256 "{sha256}"{newline}'
+            sha256_count += 1
+        else:
+            output_line = source_line
+        lines.append(output_line)
+
+    if version_count != 1:
+        msg = f"expected exactly one version stanza, found {version_count}"
+        raise ValueError(msg)
+    if sha256_count != 1:
+        msg = f"expected exactly one sha256 stanza, found {sha256_count}"
+        raise ValueError(msg)
+
+    return "".join(lines)
+
+
+def update_cask_file(path: Path, *, version: str, sha256: str) -> None:
+    """Update a cask file in place."""
+    path.write_text(
+        update_cask_text(path.read_text(), version=version, sha256=sha256),
+        encoding="utf-8",
+    )
+
+
+def main() -> None:
+    """Run the command-line cask updater."""
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
+        "--cask",
+        type=Path,
+        default=Path("Casks/agent-cli.rb"),
+        help="Path to the cask file to update.",
+    )
+    parser.add_argument(
+        "--version", required=True, help="Release version, with or without v prefix."
+    )
+    parser.add_argument("--sha256", required=True, help="SHA-256 checksum for the release DMG.")
+    args = parser.parse_args()
+
+    update_cask_file(args.cask, version=args.version, sha256=args.sha256)
+
+
+if __name__ == "__main__":
+    main()

{agent_cli-0.95.8 → agent_cli-0.95.9}/.github/workflows/release.yml

@@ -64,3 +64,28 @@ jobs:
           GH_TOKEN: ${{ github.token }}
           TAG_NAME: ${{ github.event.release.tag_name }}
         run: gh release upload "$TAG_NAME" dist/macos/AgentCLI.dmg --clobber
+      - name: Update Homebrew cask
+        env:
+          TAG_NAME: ${{ github.event.release.tag_name }}
+        run: |
+          VERSION="${TAG_NAME#v}"
+          SHA256=$(shasum -a 256 dist/macos/AgentCLI.dmg | awk '{ print $1 }')
+
+          git fetch origin main
+          git switch --force-create cask-update origin/main
+
+          python3 .github/scripts/update_cask.py \
+            --version "$VERSION" \
+            --sha256 "$SHA256"
+
+          if git diff --quiet -- Casks/agent-cli.rb; then
+            echo "Casks/agent-cli.rb is already up to date."
+            exit 0
+          fi
+
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Casks/agent-cli.rb
+          git commit -m "Update AgentCLI cask to ${TAG_NAME}"
+          git pull --rebase origin main
+          git push origin HEAD:main

{agent_cli-0.95.8 → agent_cli-0.95.9}/Casks/agent-cli.rb

@@ -1,6 +1,6 @@
 cask "agent-cli" do
-  version "0.95.7"
-  sha256 "9db4a8d9f44765e1197d687a46e4cde041ada2d5284e6a22324c706d2a40848e"
+  version "0.95.8"
+  sha256 "60273504f3c4bea181db64033790e0290bf1b53b86a1386afa3d41216a172029"
 
   url "https://github.com/basnijholt/agent-cli/releases/download/v#{version}/AgentCLI.dmg"
   name "Agent CLI"

{agent_cli-0.95.8 → agent_cli-0.95.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.95.8
+Version: 0.95.9
 Summary: A suite of AI-powered command-line tools for text correction, audio transcription, and voice assistance.
 Project-URL: Homepage, https://github.com/basnijholt/agent-cli
 Author-email: Bas Nijholt <bas@nijho.lt>

{agent_cli-0.95.8 → agent_cli-0.95.9}/macos/AgentCLI/Sources/AgentCLI/AgentCommandRunner.swift

@@ -161,7 +161,7 @@ final class AgentCommandRunner: ObservableObject {
                     self.stopBootstrapAnimationTimer()
                     return
                 }
-                self.bootstrapAnimationTick = (self.bootstrapAnimationTick + 1) % 3
+                self.bootstrapAnimationTick = (self.bootstrapAnimationTick + 1) % 4
                 if let startedAt = self.bootstrapPhaseStartedAt {
                     self.bootstrapElapsedSeconds = max(0, Int(Date().timeIntervalSince(startedAt)))
                 }

{agent_cli-0.95.8 → agent_cli-0.95.9}/macos/AgentCLI/Sources/AgentCLI/BootstrapState.swift

@@ -45,10 +45,31 @@ enum BootstrapPhase: Equatable {
 
     func statusMessage(animationTick: Int, elapsedSeconds: Int) -> String {
         switch self {
+        case .checkingRuntime, .installingRuntime, .installingVoiceService, .waitingForVoiceService, .warmingWhisperModel:
+            let spinnerFrames = ["◐", "◓", "◑", "◒"]
+            let spinner = spinnerFrames[animationTick % spinnerFrames.count]
+            let minutes = elapsedSeconds / 60
+            let seconds = elapsedSeconds % 60
+            let elapsedTime = String(format: "%02d:%02d", minutes, seconds)
+            return "\(animatedStatusMessage) \(spinner) (\(elapsedTime))"
+        case .idle, .failed:
+            return statusMessage
+        }
+    }
+
+    private var animatedStatusMessage: String {
+        switch self {
+        case .checkingRuntime:
+            return "Checking CLI runtime"
+        case .installingRuntime:
+            return "Installing CLI runtime"
+        case .installingVoiceService:
+            return "Installing voice service"
         case .waitingForVoiceService:
-            let periodCount = (animationTick % 3) + 1
-            return "Waiting for voice service\(String(repeating: ".", count: periodCount)) (\(elapsedSeconds)s)"
-        case .idle, .checkingRuntime, .installingRuntime, .installingVoiceService, .warmingWhisperModel, .failed:
+            return "Waiting for voice service"
+        case .warmingWhisperModel:
+            return "Warming Whisper model"
+        case .idle, .failed:
             return statusMessage
         }
     }

{agent_cli-0.95.8 → agent_cli-0.95.9}/macos/AgentCLI/Sources/AgentCLI/Shortcuts.swift

@@ -20,15 +20,34 @@ extension KeyboardShortcuts.Name {
     )
 }
 
-enum AppShortcutDefaults {
-    static let toggleTranscription = ShortcutStorage.shortcut(
+enum ToggleTranscriptionDefault {
+    static let shortcut = FunctionShortcutPersistence.rawShortcut(
         carbonKeyCode: kVK_Space,
         carbonModifiers: kEventKeyModifierFnMask
     )
+
+    static func set() {
+        FunctionShortcutPersistence.set(shortcut, for: .toggleTranscription)
+    }
+
+    static func seedIfNeeded() {
+        guard !userDefaultsContainsShortcut else {
+            return
+        }
+        set()
+    }
+
+    private static var userDefaultsContainsShortcut: Bool {
+        UserDefaults.standard.object(forKey: userDefaultsKey) != nil
+    }
+
+    private static var userDefaultsKey: String {
+        "KeyboardShortcuts_\(KeyboardShortcuts.Name.toggleTranscription.rawValue)"
+    }
 }
 
-enum ShortcutStorage {
-    static func shortcut(carbonKeyCode: Int, carbonModifiers: Int = 0) -> KeyboardShortcuts.Shortcut {
+enum FunctionShortcutPersistence {
+    static func rawShortcut(carbonKeyCode: Int, carbonModifiers: Int) -> KeyboardShortcuts.Shortcut {
         // KeyboardShortcuts' public initializer normalizes away Fn, but Codable preserves raw Carbon modifiers.
         let shortcutJSON = """
         {"carbonKeyCode":\(carbonKeyCode),"carbonModifiers":\(carbonModifiers)}
@@ -43,42 +62,23 @@ enum ShortcutStorage {
         return shortcut
     }
 
-    static func setShortcut(_ shortcut: KeyboardShortcuts.Shortcut?, for name: KeyboardShortcuts.Name) {
-        guard let shortcut else {
-            KeyboardShortcuts.setShortcut(nil, for: name)
-            UserDefaults.standard.set(false, forKey: userDefaultsKey(for: name))
-            postShortcutChange(for: name)
-            return
-        }
-
-        guard shortcut.carbonModifiers & kEventKeyModifierFnMask != 0 else {
-            KeyboardShortcuts.setShortcut(shortcut, for: name)
-            return
-        }
-
+    static func set(_ shortcut: KeyboardShortcuts.Shortcut, for name: KeyboardShortcuts.Name) {
         KeyboardShortcuts.setShortcut(nil, for: name)
         guard let encoded = try? JSONEncoder().encode(shortcut),
               let encodedString = String(data: encoded, encoding: .utf8) else {
             return
         }
         UserDefaults.standard.set(encodedString, forKey: userDefaultsKey(for: name))
-        postShortcutChange(for: name)
-    }
-
-    static func userDefaultsContains(name: KeyboardShortcuts.Name) -> Bool {
-        UserDefaults.standard.object(forKey: userDefaultsKey(for: name)) != nil
     }
 
     private static func userDefaultsKey(for name: KeyboardShortcuts.Name) -> String {
         "KeyboardShortcuts_\(name.rawValue)"
     }
+}
 
-    private static func postShortcutChange(for name: KeyboardShortcuts.Name) {
-        NotificationCenter.default.post(
-            name: Notification.Name("KeyboardShortcuts_shortcutByNameDidChange"),
-            object: nil,
-            userInfo: ["name": name]
-        )
+private extension KeyboardShortcuts.Shortcut {
+    var usesFunctionModifier: Bool {
+        carbonModifiers & kEventKeyModifierFnMask != 0
     }
 }
 
@@ -123,7 +123,7 @@ final class ShortcutSummaryState: ObservableObject {
     }
 
     func resetDefaults() {
-        ShortcutStorage.setShortcut(AppShortcutDefaults.toggleTranscription, for: .toggleTranscription)
+        ToggleTranscriptionDefault.set()
         KeyboardShortcuts.reset(
             .holdToTranscribe,
             .autocorrect,
@@ -174,15 +174,37 @@ private enum ShortcutDisplay {
         }
 
         var carbonModifiers = shortcut.carbonModifiers
-        if event.modifierFlags.contains(.function) {
+        if event.modifierFlags.contains(.function),
+           shouldTreatFunctionFlagAsModifier(for: shortcut.carbonKeyCode) {
             carbonModifiers |= kEventKeyModifierFnMask
         }
-        return ShortcutStorage.shortcut(
+
+        guard carbonModifiers & kEventKeyModifierFnMask != 0 else {
+            return KeyboardShortcuts.Shortcut(
+                carbonKeyCode: shortcut.carbonKeyCode,
+                carbonModifiers: carbonModifiers
+            )
+        }
+
+        return FunctionShortcutPersistence.rawShortcut(
             carbonKeyCode: shortcut.carbonKeyCode,
             carbonModifiers: carbonModifiers
         )
     }
 
+    private static func shouldTreatFunctionFlagAsModifier(for carbonKeyCode: Int) -> Bool {
+        !isFunctionRowKey(carbonKeyCode)
+    }
+
+    private static func isFunctionRowKey(_ carbonKeyCode: Int) -> Bool {
+        switch carbonKeyCode {
+        case kVK_F1...kVK_F20:
+            return true
+        default:
+            return false
+        }
+    }
+
     private static func label(for shortcut: KeyboardShortcuts.Shortcut, fallback: String) -> String {
         if shortcut.carbonKeyCode == kVK_Function, shortcut.carbonModifiers == 0 {
             return "Fn"
@@ -213,19 +235,19 @@ enum ShortcutDefaultsMigrator {
         migrateDefault(
             name: .toggleTranscription,
             from: KeyboardShortcuts.Shortcut(.r, modifiers: [.command, .shift]),
-            to: AppShortcutDefaults.toggleTranscription
+            to: ToggleTranscriptionDefault.shortcut
         )
         migrateDefault(
             name: .toggleTranscription,
             from: KeyboardShortcuts.Shortcut(.space),
-            to: AppShortcutDefaults.toggleTranscription
+            to: ToggleTranscriptionDefault.shortcut
         )
         migrateDefault(
             name: .holdToTranscribe,
             from: KeyboardShortcuts.Shortcut(.space, modifiers: [.control, .option]),
             to: KeyboardShortcuts.Shortcut(.function)
         )
-        seedDefault(name: .toggleTranscription, shortcut: AppShortcutDefaults.toggleTranscription)
+        ToggleTranscriptionDefault.seedIfNeeded()
     }
 
     private static func migrateDefault(
@@ -236,17 +258,19 @@ enum ShortcutDefaultsMigrator {
         guard KeyboardShortcuts.getShortcut(for: name) == oldShortcut else {
             return
         }
-        ShortcutStorage.setShortcut(newShortcut, for: name)
+        setShortcut(newShortcut, for: name)
     }
 
-    private static func seedDefault(
-        name: KeyboardShortcuts.Name,
-        shortcut: KeyboardShortcuts.Shortcut
+    private static func setShortcut(
+        _ shortcut: KeyboardShortcuts.Shortcut,
+        for name: KeyboardShortcuts.Name
     ) {
-        guard !ShortcutStorage.userDefaultsContains(name: name) else {
+        guard name == .toggleTranscription,
+              shortcut == ToggleTranscriptionDefault.shortcut else {
+            KeyboardShortcuts.setShortcut(shortcut, for: name)
             return
         }
-        ShortcutStorage.setShortcut(shortcut, for: name)
+        ToggleTranscriptionDefault.set()
     }
 }
 
@@ -436,7 +460,7 @@ final class ShortcutRecorderButton: NSButton {
             stopRecording()
         case kVK_Delete, kVK_ForwardDelete:
             pendingFunctionShortcut = false
-            ShortcutStorage.setShortcut(nil, for: shortcutName)
+            KeyboardShortcuts.setShortcut(nil, for: shortcutName)
             stopRecording()
         case kVK_Function:
             handleFunctionKeyChange(event)
@@ -446,7 +470,15 @@ final class ShortcutRecorderButton: NSButton {
                 NSSound.beep()
                 return
             }
-            ShortcutStorage.setShortcut(shortcut, for: shortcutName)
+            if shortcut.usesFunctionModifier {
+                guard supportsFunctionChord(shortcutName) else {
+                    NSSound.beep()
+                    return
+                }
+                FunctionShortcutPersistence.set(shortcut, for: shortcutName)
+            } else {
+                KeyboardShortcuts.setShortcut(shortcut, for: shortcutName)
+            }
             stopRecording()
         }
     }
@@ -468,10 +500,14 @@ final class ShortcutRecorderButton: NSButton {
 
     private func captureBareFunctionShortcut() {
         pendingFunctionShortcut = false
-        ShortcutStorage.setShortcut(KeyboardShortcuts.Shortcut(.function), for: shortcutName)
+        KeyboardShortcuts.setShortcut(KeyboardShortcuts.Shortcut(.function), for: shortcutName)
         stopRecording()
     }
 
+    private func supportsFunctionChord(_ name: KeyboardShortcuts.Name) -> Bool {
+        name == .toggleTranscription || name == .holdToTranscribe
+    }
+
     private func stopRecording() {
         if let eventMonitor {
             NSEvent.removeMonitor(eventMonitor)

{agent_cli-0.95.8 → agent_cli-0.95.9}/macos/AgentCLI/Tests/AgentCLITests/AgentCommandTests.swift

@@ -148,22 +148,34 @@ final class AgentCommandTests: XCTestCase {
         XCTAssertEqual(recorder.calls, [.init(requirement: .transcriptionModel, force: false)])
     }
 
-    func testWaitingForVoiceServiceStatusAnimatesEllipsis() {
+    func testPreparingStatusShowsFixedWidthSpinnerAndElapsedTime() {
+        XCTAssertEqual(
+            BootstrapPhase.checkingRuntime.statusMessage(animationTick: 0, elapsedSeconds: 0),
+            "Checking CLI runtime ◐ (00:00)"
+        )
+        XCTAssertEqual(
+            BootstrapPhase.installingRuntime.statusMessage(animationTick: 1, elapsedSeconds: 12),
+            "Installing CLI runtime ◓ (00:12)"
+        )
+        XCTAssertEqual(
+            BootstrapPhase.installingVoiceService.statusMessage(animationTick: 2, elapsedSeconds: 123),
+            "Installing voice service ◑ (02:03)"
+        )
         XCTAssertEqual(
             BootstrapPhase.waitingForVoiceService.statusMessage(animationTick: 0, elapsedSeconds: 0),
-            "Waiting for voice service. (0s)"
+            "Waiting for voice service ◐ (00:00)"
         )
         XCTAssertEqual(
             BootstrapPhase.waitingForVoiceService.statusMessage(animationTick: 1, elapsedSeconds: 12),
-            "Waiting for voice service.. (12s)"
+            "Waiting for voice service ◓ (00:12)"
         )
         XCTAssertEqual(
             BootstrapPhase.waitingForVoiceService.statusMessage(animationTick: 2, elapsedSeconds: 123),
-            "Waiting for voice service... (123s)"
+            "Waiting for voice service ◑ (02:03)"
         )
         XCTAssertEqual(
-            BootstrapPhase.waitingForVoiceService.statusMessage(animationTick: 3, elapsedSeconds: 4),
-            "Waiting for voice service. (4s)"
+            BootstrapPhase.warmingWhisperModel.statusMessage(animationTick: 3, elapsedSeconds: 4),
+            "Warming Whisper model ◒ (00:04)"
         )
     }
 }

{agent_cli-0.95.8 → agent_cli-0.95.9}/tests/test_macos_app.py

@@ -531,19 +531,22 @@ def test_macos_app_keeps_preparing_status_visible_during_command_bootstrap() ->
     assert 'statusMessage == "Preparing voice service..."' not in source
 
 
-def test_macos_app_animates_waiting_for_voice_service_status() -> None:
-    """The waiting status should visibly indicate that setup is still progressing."""
+def test_macos_app_animates_all_preparing_statuses_with_fixed_width_timer() -> None:
+    """Every setup phase should show stable-width progress without shifting the timer."""
     source = swift_source()
 
     assert "statusMessage(animationTick: Int, elapsedSeconds: Int)" in source
-    assert "let periodCount = (animationTick % 3) + 1" in source
+    assert '["◐", "◓", "◑", "◒"]' in source
+    assert 'String(format: "%02d:%02d", minutes, seconds)' in source
+    assert '"\\(animatedStatusMessage) \\(spinner) (\\(elapsedTime))"' in source
     assert (
-        '"Waiting for voice service\\(String(repeating: ".", count: periodCount)) '
-        '(\\(elapsedSeconds)s)"' in source
+        "case .checkingRuntime, .installingRuntime, .installingVoiceService, .waitingForVoiceService, .warmingWhisperModel:"
+        in source
     )
     assert "bootstrapAnimationTimer" in source
     assert "bootstrapPhaseStartedAt" in source
     assert "bootstrapElapsedSeconds" in source
+    assert "bootstrapAnimationTick = (self.bootstrapAnimationTick + 1) % 4" in source
     assert "RunLoop.main.add(timer, forMode: .common)" in source
     assert "bootstrapPhase.statusMessage(" in source
     assert "animationTick: bootstrapAnimationTick" in source
@@ -586,7 +589,8 @@ def test_macos_app_defaults_clipboard_transcription_to_fn_space() -> None:
     source = swift_source()
 
     assert "kEventKeyModifierFnMask" in source
-    assert "static let toggleTranscription = ShortcutStorage.shortcut(" in source
+    assert "enum ToggleTranscriptionDefault" in source
+    assert "static let shortcut = FunctionShortcutPersistence.rawShortcut(" in source
     assert "carbonKeyCode: kVK_Space" in source
     assert "carbonModifiers: kEventKeyModifierFnMask" in source
     assert "event.modifierFlags.contains(.function)" in source
@@ -596,15 +600,17 @@ def test_macos_app_defaults_clipboard_transcription_to_fn_space() -> None:
 
 
 def test_macos_app_persists_fn_space_without_keyboardshortcuts_normalization() -> None:
-    """KeyboardShortcuts' public Shortcut initializer drops Fn, so app storage must preserve it."""
+    """Fn shortcuts should bypass KeyboardShortcuts normalization only where the app can dispatch them."""
     source = swift_source()
 
-    assert "enum ShortcutStorage" in source
+    assert "enum ToggleTranscriptionDefault" in source
+    assert "enum ShortcutStorage" not in source
     assert "JSONEncoder().encode(shortcut)" in source
     assert "JSONDecoder().decode(KeyboardShortcuts.Shortcut.self" in source
     assert '"KeyboardShortcuts_\\(name.rawValue)"' in source
-    assert "ShortcutStorage.setShortcut(AppShortcutDefaults.toggleTranscription" in source
-    assert "static let toggleTranscription = ShortcutStorage.shortcut(" in source
+    assert "ToggleTranscriptionDefault.set()" in source
+    assert "FunctionShortcutPersistence.set(shortcut, for: shortcutName)" in source
+    assert "ShortcutStorage.setShortcut(" not in source
 
 
 def test_macos_app_uses_fn_aware_event_tap_for_transcription_shortcuts() -> None:
@@ -667,15 +673,12 @@ def test_macos_app_migrates_old_default_shortcuts_to_fn_defaults() -> None:
     assert "migrateDefault(" in source
     assert "from: KeyboardShortcuts.Shortcut(.r, modifiers: [.command, .shift])" in source
     assert "from: KeyboardShortcuts.Shortcut(.space)" in source
-    assert "to: AppShortcutDefaults.toggleTranscription" in source
-    assert (
-        "seedDefault(name: .toggleTranscription, shortcut: AppShortcutDefaults.toggleTranscription)"
-        in source
-    )
+    assert "to: ToggleTranscriptionDefault.shortcut" in source
+    assert "ToggleTranscriptionDefault.seedIfNeeded()" in source
     assert "from: KeyboardShortcuts.Shortcut(.space, modifiers: [.control, .option])" in source
     assert "to: KeyboardShortcuts.Shortcut(.function)" in source
     assert "KeyboardShortcuts.getShortcut(for: name) == oldShortcut" in source
-    assert "ShortcutStorage.setShortcut(newShortcut, for: name)" in source
+    assert "setShortcut(newShortcut, for: name)" in source
 
 
 def test_macos_app_pastes_hold_transcription_into_focused_field() -> None:
@@ -941,6 +944,20 @@ def test_macos_app_records_fn_chords_before_bare_fn() -> None:
     assert "captureBareFunctionShortcut()" in source
     assert "event.modifierFlags.contains(.function)" in source
     assert "case kVK_Function:" in source
+    assert "shortcut.usesFunctionModifier" in source
+    assert "supportsFunctionChord(shortcutName)" in source
+    assert "FunctionShortcutPersistence.set(shortcut, for: shortcutName)" in source
+    assert "KeyboardShortcuts.setShortcut(shortcut, for: shortcutName)" in source
+
+
+def test_macos_app_does_not_record_function_row_keys_as_fn_chords() -> None:
+    """F1/F2 key events can carry .function in modifierFlags but should remain plain keys."""
+    source = swift_source()
+
+    assert "shouldTreatFunctionFlagAsModifier(for: shortcut.carbonKeyCode)" in source
+    assert "isFunctionRowKey(" in source
+    assert "case kVK_F1...kVK_F20:" in source
+    assert "!isFunctionRowKey(carbonKeyCode)" in source
 
 
 def test_macos_app_shows_actual_persisted_shortcuts_and_can_reset_them() -> None:

agent_cli-0.95.9/tests/test_update_cask.py

@@ -0,0 +1,51 @@
+"""Tests for the release cask updater."""
+
+from __future__ import annotations
+
+import importlib.util
+from pathlib import Path
+
+import pytest
+
+SCRIPT_PATH = Path(__file__).parents[1] / ".github" / "scripts" / "update_cask.py"
+spec = importlib.util.spec_from_file_location("update_cask", SCRIPT_PATH)
+assert spec is not None
+assert spec.loader is not None
+update_cask = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(update_cask)
+update_cask_text = update_cask.update_cask_text
+
+
+CASK = """cask "agent-cli" do
+  version "0.95.7"
+  sha256 "9db4a8d9f44765e1197d687a46e4cde041ada2d5284e6a22324c706d2a40848e"
+
+  url "https://github.com/basnijholt/agent-cli/releases/download/v#{version}/AgentCLI.dmg"
+end
+"""
+
+
+def test_update_cask_text_replaces_version_and_sha256() -> None:
+    updated = update_cask_text(
+        CASK,
+        version="v0.95.8",
+        sha256="60273504f3c4bea181db64033790e0290bf1b53b86a1386afa3d41216a172029",
+    )
+
+    assert '  version "0.95.8"' in updated
+    assert '  sha256 "60273504f3c4bea181db64033790e0290bf1b53b86a1386afa3d41216a172029"' in updated
+    assert "v#{version}" in updated
+
+
+def test_update_cask_text_rejects_invalid_sha256() -> None:
+    with pytest.raises(ValueError, match="sha256"):
+        update_cask_text(CASK, version="0.95.8", sha256="bad")
+
+
+def test_update_cask_text_requires_one_version_stanza() -> None:
+    with pytest.raises(ValueError, match="expected exactly one version"):
+        update_cask_text(
+            CASK.replace('  version "0.95.7"\n', ""),
+            version="0.95.8",
+            sha256="60273504f3c4bea181db64033790e0290bf1b53b86a1386afa3d41216a172029",
+        )