From 4b7bb4e5c4a8af4b9201f5a08f6f6c427ebd4956 Mon Sep 17 00:00:00 2001
From: Rob Sanheim <rsanheim@gmail.com>
Date: Fri, 24 Apr 2026 04:51:40 -0500
Subject: [PATCH] docs(audio): clarify what the mic-init timing log actually
 measures (#1330)

---
 src-tauri/src/managers/audio.rs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src-tauri/src/managers/audio.rs b/src-tauri/src/managers/audio.rs
index 24dd04f..d0c92ba 100644
--- a/src-tauri/src/managers/audio.rs
+++ b/src-tauri/src/managers/audio.rs
@@ -321,6 +321,11 @@ impl AudioRecordingManager {
         }
 
         *open_flag = true;
+        // This timing covers through cpal's stream.play() returning — i.e. the
+        // point cpal surfaces as "stream running." It does NOT guarantee the
+        // host audio device is producing samples yet; the first input callback
+        // fires asynchronously one buffer period later (hardware dependent,
+        // typically ~10–200ms on macOS, longer on Bluetooth/USB).
         info!(
             "Microphone stream initialized in {:?}",
             start_time.elapsed()