feat: add system-wide logging framework with rotation and export (closes #36) (#54)

Author: jatinkrmalik

Sources/VocaMac/Models/AppState.swift

@@ -107,6 +107,7 @@ final class AppState: ObservableObject {
     @AppStorage("vocamac.soundEffectsEnabled") var soundEffectsEnabled: Bool = true
     @AppStorage("vocamac.showCursorIndicator") var showCursorIndicator: Bool = true
     @AppStorage("vocamac.translationEnabled") var translationEnabled: Bool = false
+    @AppStorage("vocamac.logLevel") var logLevel: String = "info"
 
     // MARK: - Services
 
@@ -125,7 +126,7 @@ final class AppState: ObservableObject {
     // MARK: - Initialization
 
     init() {
-        NSLog("[AppState] Initializing...")
+        VocaLogger.info(.appState, "Initializing...")
         setupServices()
         // Trigger startup automatically
         Task {
@@ -480,46 +481,43 @@ final class AppState: ObservableObject {
     // MARK: - Startup
 
     func performStartup() async {
-        NSLog("[AppState] performStartup beginning...")
+        VocaLogger.info(.appState, "performStartup beginning...")
 
         // 1. Detect hardware
         systemCapabilities = SystemInfo.detect()
-        NSLog("[AppState] System: %@ | %d GB RAM | %d cores",
-              systemCapabilities?.processorName ?? "unknown",
-              systemCapabilities?.physicalMemoryGB ?? 0,
-              systemCapabilities?.coreCount ?? 0)
+        let sysInfo = systemCapabilities
+        VocaLogger.info(.appState, "System: \(sysInfo?.processorName ?? "unknown") | \(sysInfo?.physicalMemoryGB ?? 0) GB RAM | \(sysInfo?.coreCount ?? 0) cores")
 
         // 2. Check/request permissions
         checkPermissions()
-        NSLog("[AppState] Mic permission: %@ | Accessibility: %@ | Input Monitoring: %@",
-              micPermission.rawValue, accessibilityPermission.rawValue, inputMonitoringPermission.rawValue)
+        VocaLogger.info(.appState, "Mic permission: \(micPermission.rawValue) | Accessibility: \(accessibilityPermission.rawValue) | Input Monitoring: \(inputMonitoringPermission.rawValue)")
 
         // Auto-prompt for microphone permission on first launch
         if micPermission == .notDetermined {
-            NSLog("[AppState] Mic permission not determined — requesting...")
+            VocaLogger.info(.appState, "Mic permission not determined — requesting...")
             requestMicrophonePermission()
         }
 
         // 3. Load model — let WhisperKit auto-select and download the best model
-        NSLog("[AppState] Loading WhisperKit model (auto-select)...")
+        VocaLogger.info(.appState, "Loading WhisperKit model (auto-select)...")
         await loadModel()
         NSLog("[AppState] Model loaded: %@", whisperService.loadedModelName ?? "none")
 
         // 4. Always attempt to start hotkey listener
         // The event tap creation itself will fail if permissions aren't granted,
         // and we handle that gracefully in HotKeyManager.
-        NSLog("[AppState] Attempting to start hotkey listener...")
+        VocaLogger.info(.appState, "Attempting to start hotkey listener...")
         hotKeyManager.startListening(
             keyCode: hotKeyCode,
             mode: activationMode,
             doubleTapThreshold: doubleTapThreshold
         )
         if hotKeyManager.isListening {
-            NSLog("[AppState] Hotkey listener active (keyCode=%d, mode=%@)", hotKeyCode, activationMode.rawValue)
+            VocaLogger.info(.appState, "Hotkey listener active (keyCode=\(hotKeyCode), mode=\(activationMode.rawValue))")
         } else {
-            NSLog("[AppState] WARNING: Hotkey listener failed to start. Check Accessibility & Input Monitoring permissions.")
+            VocaLogger.warning(.appState, "Hotkey listener failed to start. Check Accessibility & Input Monitoring permissions.")
         }
 
-        NSLog("[AppState] Startup complete!")
+        VocaLogger.info(.appState, "Startup complete!")
     }
 }

Sources/VocaMac/Services/AudioEngine.swift

@@ -108,7 +108,7 @@ final class AudioEngine {
         do {
             try engine.start()
         } catch {
-            print("[AudioEngine] Failed to start audio engine: \(error)")
+            VocaLogger.error(.audioEngine, "Failed to start audio engine: \(error)")
             isCurrentlyRecording = false
         }
     }
@@ -200,7 +200,7 @@ final class AudioEngine {
 
         // Create a converter
         guard let converter = AVAudioConverter(from: inputFormat, to: whisperFormat) else {
-            print("[AudioEngine] Failed to create audio format converter")
+            VocaLogger.error(.audioEngine, "Failed to create audio format converter")
             return nil
         }
 
@@ -224,7 +224,7 @@ final class AudioEngine {
         converter.convert(to: outputBuffer, error: &error, withInputFrom: inputBlock)
 
         if let error = error {
-            print("[AudioEngine] Conversion error: \(error)")
+            VocaLogger.error(.audioEngine, "Conversion error: \(error)")
             return nil
         }
 

Sources/VocaMac/Services/CursorOverlayManager.swift

@@ -73,14 +73,14 @@ final class CursorOverlayManager {
         }
 
         viewModel.isActive = true
-        NSLog("[CursorOverlay] Indicator shown (recording)")
+        VocaLogger.debug(.cursorOverlay, "Indicator shown (recording)")
     }
 
     /// Transition the indicator from recording (red) to processing (purple)
     /// Keeps the overlay visible so the user knows text is on its way.
     func transitionToProcessing() {
         viewModel.phase = .processing
-        NSLog("[CursorOverlay] Transitioned to processing")
+        VocaLogger.debug(.cursorOverlay, "Transitioned to processing")
     }
 
     /// Hide the recording indicator
@@ -92,7 +92,7 @@ final class CursorOverlayManager {
         overlayPanel?.orderOut(nil)
         overlayPanel = nil
         hostingView = nil
-        NSLog("[CursorOverlay] Indicator hidden")
+        VocaLogger.debug(.cursorOverlay, "Indicator hidden")
     }
 
     /// Update the audio level (kept for future use)

Sources/VocaMac/Services/HotKeyManager.swift

@@ -72,7 +72,7 @@ final class HotKeyManager {
         doubleTapThreshold: Double = 0.4
     ) {
         guard !isListening else {
-            print("[HotKeyManager] Already listening")
+            VocaLogger.debug(.hotKeyManager, "Already listening")
             return
         }
 
@@ -101,7 +101,7 @@ final class HotKeyManager {
             callback: HotKeyManager.eventTapCallback,
             userInfo: userInfo
         ) else {
-            NSLog("[HotKeyManager] FAILED to create event tap! Check Accessibility & Input Monitoring permissions.")
+            VocaLogger.error(.hotKeyManager, "FAILED to create event tap! Check Accessibility & Input Monitoring permissions.")
             return
         }
 
@@ -114,7 +114,7 @@ final class HotKeyManager {
         CGEvent.tapEnable(tap: tap, enable: true)
 
         isListening = true
-        NSLog("[HotKeyManager] Event tap created successfully. Listening for keyCode %d in %@ mode", keyCode, mode.rawValue)
+        VocaLogger.info(.hotKeyManager, "Event tap created successfully. Listening for keyCode \(keyCode) in \(mode.rawValue) mode")
     }
 
     /// Stop listening for global hotkey events
@@ -135,7 +135,7 @@ final class HotKeyManager {
         isKeyHeld = false
         isToggled = false
 
-        print("[HotKeyManager] Stopped listening")
+        VocaLogger.info(.hotKeyManager, "Stopped listening")
     }
 
     /// Update the configuration while listening
@@ -180,7 +180,7 @@ final class HotKeyManager {
         // For regular keys, we use keyDown/keyUp events
         if type == .flagsChanged {
             if keyCode == targetKeyCode {
-                NSLog("[HotKeyManager] flagsChanged event for target keyCode %d", keyCode)
+                VocaLogger.debug(.hotKeyManager, "flagsChanged event for target keyCode \(keyCode)")
             }
             handleModifierKeyEvent(keyCode: keyCode, event: event)
         } else if type == .keyDown || type == .keyUp {
@@ -234,14 +234,14 @@ final class HotKeyManager {
     /// Process a key-down event for the target hotkey
     private func handleKeyDown() {
         let currentTime = CFAbsoluteTimeGetCurrent()
-        NSLog("[HotKeyManager] Key DOWN detected (mode=%@)", mode.rawValue)
+        VocaLogger.debug(.hotKeyManager, "Key DOWN detected (mode=\(mode.rawValue))")
 
         switch mode {
         case .pushToTalk:
             // Push-to-talk: start recording on key down (if not already held)
             if !isKeyHeld {
                 isKeyHeld = true
-                NSLog("[HotKeyManager] Push-to-talk: START recording")
+                VocaLogger.debug(.hotKeyManager, "Push-to-talk: START recording")
                 DispatchQueue.main.async { [weak self] in
                     self?.onRecordingStart?()
                 }
@@ -272,14 +272,14 @@ final class HotKeyManager {
 
     /// Process a key-up event for the target hotkey
     private func handleKeyUp() {
-        NSLog("[HotKeyManager] Key UP detected (mode=%@)", mode.rawValue)
+        VocaLogger.debug(.hotKeyManager, "Key UP detected (mode=\(mode.rawValue))")
 
         switch mode {
         case .pushToTalk:
             // Push-to-talk: stop recording on key release
             if isKeyHeld {
                 isKeyHeld = false
-                NSLog("[HotKeyManager] Push-to-talk: STOP recording")
+                VocaLogger.debug(.hotKeyManager, "Push-to-talk: STOP recording")
                 DispatchQueue.main.async { [weak self] in
                     self?.onRecordingStop?()
                 }