fix: require transcription readiness before recording

.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+      - 'fix/**'
+      - 'feat/**'
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: macos-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.23'
+          cache: true
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install macOS dependencies
+        run: brew install portaudio
+
+      - name: Install frontend dependencies
+        run: npm ci
+        working-directory: frontend
+
+      - name: Build frontend
+        run: npm run build
+        working-directory: frontend
+
+      - name: Test Go packages
+        run: go test ./...

README.md

@@ -125,6 +125,14 @@ The app requires the following permissions:
 - **Microphone** — For audio recording
 - **Accessibility** — For global hotkey and auto-paste functionality
 
+### Debug Logs
+
+Yap writes debug logs to help investigate unexpected user behavior. Logs are kept for 7 days.
+
+- macOS: `~/Library/Application Support/yap/logs/yap-YYYY-MM-DD.log`
+- Windows: `%APPDATA%\yap\logs\yap-YYYY-MM-DD.log`
+- Linux: `~/.config/yap/logs/yap-YYYY-MM-DD.log`
+
 ## Documentation
 
 For comprehensive documentation, visit **[applauselab.ai/docs/yap](https://applauselab.ai/docs/yap/)**.