Reliability, performance, and UX overhaul: recording, model loading, downloads, updater, hotkeys

Makefile

@@ -106,20 +106,32 @@ test-ui:
 # Run SwiftLint
 lint:
 	@echo "Running SwiftLint..."
-	@which swiftlint > /dev/null && swiftlint || echo "⚠️  SwiftLint not installed"
+	@if ! command -v swiftlint > /dev/null; then \
+		echo "⚠️  SwiftLint not installed. Install with: brew install swiftlint"; \
+		exit 1; \
+	fi
+	swiftlint
 
 # Reproduce the GitHub Actions CI checks locally (build + unit tests + lint)
 ci:
 	@echo "Running CI checks locally..."
 	xcodebuild -scheme speaktype -configuration Debug build CODE_SIGNING_ALLOWED=NO
 	xcodebuild test -scheme speaktype -destination 'platform=macOS' -only-testing:speaktypeTests CODE_SIGNING_ALLOWED=NO
 	@echo "--- SwiftLint (advisory) ---"
-	@which swiftlint > /dev/null && swiftlint || echo "⚠️  SwiftLint not installed"
+	@if command -v swiftlint > /dev/null; then \
+		swiftlint || echo "⚠️  SwiftLint reported violations"; \
+	else \
+		echo "⚠️  SwiftLint not installed. Install with: brew install swiftlint"; \
+	fi
 
 # Auto-fix SwiftLint issues
 format:
 	@echo "Formatting code with SwiftLint..."
-	@which swiftlint > /dev/null && swiftlint --fix || echo "⚠️  SwiftLint not installed"
+	@if ! command -v swiftlint > /dev/null; then \
+		echo "⚠️  SwiftLint not installed. Install with: brew install swiftlint"; \
+		exit 1; \
+	fi
+	swiftlint --fix
 
 # Clean build artifacts
 clean:

README.md

@@ -84,9 +84,10 @@ make dmg            # Create DMG installer
 
 ### Current Issues
 
-⚠️ When loading a model for the first time / switching to another model, there is a startup delay of 30-60 seconds. 
-
-So the first transcription will appear ultra slow, but it will go back to instantaneous dictation right after it's warmed up. 
+⚠️ The first load of a freshly downloaded model runs a one-time CoreML/Neural Engine
+optimization pass — around 30-60 seconds for small models and up to a few minutes for
+large ones. The app shows a "First-time setup — optimizing model for your Mac" status
+while this runs; macOS caches the result, so every later load takes seconds.
 
 ### Project Structure
 
@@ -104,7 +105,6 @@ speaktype/
 
 - **Swift 5.9+** / SwiftUI + AppKit
 - **[WhisperKit](https://github.com/argmaxinc/WhisperKit)** - Local Whisper inference
-- **[KeyboardShortcuts](https://github.com/sindresorhus/KeyboardShortcuts)** - Global hotkeys
 - **AVFoundation** - Audio capture
 
 ---

RELEASE.md

@@ -110,8 +110,7 @@ Error: HTTP status code: 401. Unable to authenticate.
 ```bash
 xcrun notarytool store-credentials "AC_PASSWORD" \
   --apple-id "mail2048labs@gmail.com" \
-  --team-id "PCV4UMSRZX" \
-  --password "NEW_PASSWORD_HERE"
+  --team-id "PCV4UMSRZX"
 ```
 
 ### Notarization Rejected

scripts/lib/common.sh

@@ -67,8 +67,9 @@ resolve_version() {
   fi
 }
 
-# Ensure notarization credentials exist in the keychain, prompting once for an
-# app-specific password if the profile is missing.
+# Ensure notarization credentials exist in the keychain. When the profile is
+# missing, notarytool prompts for the app-specific password itself so the secret
+# never appears in this script's process arguments.
 ensure_notary_credentials() {
   if xcrun notarytool history --keychain-profile "$NOTARY_PROFILE" &>/dev/null; then
     return 0
@@ -81,14 +82,12 @@ ensure_notary_credentials() {
   echo "  2. Sign in with: $APPLE_ID"
   echo "  3. Security → App-Specific Passwords → Generate"
   echo ""
-  read -rp "Enter app-specific password: " -s APP_PASSWORD
+  echo "notarytool will prompt for the app-specific password securely."
   echo ""
-  [ -z "$APP_PASSWORD" ] && { echo "❌ Password required"; exit 1; }
 
   xcrun notarytool store-credentials "$NOTARY_PROFILE" \
     --apple-id "$APPLE_ID" \
-    --team-id "$APPLE_TEAM_ID" \
-    --password "$APP_PASSWORD"
+    --team-id "$APPLE_TEAM_ID"
   echo ""
   echo "✅ Credentials stored. Continuing..."
   echo ""

speaktype.xcodeproj/project.pbxproj

@@ -8,7 +8,6 @@
 
 /* Begin PBXBuildFile section */
 		1C547F2B2F0E7DC0008120A6 /* WhisperKit in Frameworks */ = {isa = PBXBuildFile; productRef = 1C547F2A2F0E7DC0008120A6 /* WhisperKit */; };
-		1CE4CB3F2F0EF6AF00C01C62 /* KeyboardShortcuts in Frameworks */ = {isa = PBXBuildFile; productRef = 1CE4CB3E2F0EF6AF00C01C62 /* KeyboardShortcuts */; };
 		1CE4CB412F0EF86B00C01C62 /* whisperkit-cli in Frameworks */ = {isa = PBXBuildFile; productRef = 1CE4CB402F0EF86B00C01C62 /* whisperkit-cli */; };
 		FA0000000000000000000003 /* FluidAudio in Frameworks */ = {isa = PBXBuildFile; productRef = FA0000000000000000000002 /* FluidAudio */; };
 /* End PBXBuildFile section */
@@ -73,7 +72,6 @@
 			buildActionMask = 2147483647;
 			files = (
 				1C547F2B2F0E7DC0008120A6 /* WhisperKit in Frameworks */,
-				1CE4CB3F2F0EF6AF00C01C62 /* KeyboardShortcuts in Frameworks */,
 				1CE4CB412F0EF86B00C01C62 /* whisperkit-cli in Frameworks */,
 				FA0000000000000000000003 /* FluidAudio in Frameworks */,
 			);
@@ -145,7 +143,6 @@
 			name = speaktype;
 			packageProductDependencies = (
 				1C547F2A2F0E7DC0008120A6 /* WhisperKit */,
-				1CE4CB3E2F0EF6AF00C01C62 /* KeyboardShortcuts */,
 				1CE4CB402F0EF86B00C01C62 /* whisperkit-cli */,
 				FA0000000000000000000002 /* FluidAudio */,
 			);
@@ -233,7 +230,6 @@
 			minimizedProjectReferenceProxies = 1;
 			packageReferences = (
 				1C547F222F0E7D07008120A6 /* XCRemoteSwiftPackageReference "WhisperKit" */,
-				1CE4CB3D2F0EF6AF00C01C62 /* XCRemoteSwiftPackageReference "KeyboardShortcuts" */,
 				FA0000000000000000000001 /* XCRemoteSwiftPackageReference "FluidAudio" */,
 			);
 			preferredProjectObjectVersion = 77;
@@ -624,14 +620,6 @@
 				version = 0.9.4;
 			};
 		};
-		1CE4CB3D2F0EF6AF00C01C62 /* XCRemoteSwiftPackageReference "KeyboardShortcuts" */ = {
-			isa = XCRemoteSwiftPackageReference;
-			repositoryURL = "https://github.com/sindresorhus/KeyboardShortcuts";
-			requirement = {
-				kind = upToNextMajorVersion;
-				minimumVersion = 2.4.0;
-			};
-		};
 		FA0000000000000000000001 /* XCRemoteSwiftPackageReference "FluidAudio" */ = {
 			isa = XCRemoteSwiftPackageReference;
 			repositoryURL = "https://github.com/FluidInference/FluidAudio.git";
@@ -648,11 +636,6 @@
 			package = 1C547F222F0E7D07008120A6 /* XCRemoteSwiftPackageReference "WhisperKit" */;
 			productName = WhisperKit;
 		};
-		1CE4CB3E2F0EF6AF00C01C62 /* KeyboardShortcuts */ = {
-			isa = XCSwiftPackageProductDependency;
-			package = 1CE4CB3D2F0EF6AF00C01C62 /* XCRemoteSwiftPackageReference "KeyboardShortcuts" */;
-			productName = KeyboardShortcuts;
-		};
 		1CE4CB402F0EF86B00C01C62 /* whisperkit-cli */ = {
 			isa = XCSwiftPackageProductDependency;
 			package = 1C547F222F0E7D07008120A6 /* XCRemoteSwiftPackageReference "WhisperKit" */;