qa-critical-ux

Source excerpt starting at line 1.

1---2name: qa-critical-ux3description: QA Anarlog's critical Pro user journey on a signed staging candidate — onboarding, responsive launch, microphone and system-audio capture, automated summaries, and cloud sync.4---5 6# QA: Critical User Experience7 8Run this workflow only when the user explicitly asks for QA. A release request alone does not invoke it, and QA results do not approve or block a release.9 10Test only the signed staging artifact for the requested candidate:11 121. The app launches and never hangs.132. Onboarding completes from scratch: permissions, sign-in, and provider setup.143. A recording captures both microphone and system audio.154. Stopping the recording produces an automated summary.165. The note syncs to the account and comes back after a local wipe.17 18Everything else is outside this skill's scope.19 20## Out of Scope21 22Record incidental failures against the existing Linear ticket without expanding this run:23 24- AEC quality: `ANLG-98`25- Automatic speaker identification: `ANLG-222`26- Real-world capture across devices, rooms, and participants: `ANLG-284`27- Auth callback and sign-out edge cases: `ANLG-285`28- Calendar, events, and notifications: `ANLG-286`29- CloudSync activity deferral and transcript integrity: `ANLG-287`30- On-device STT/LLM provider matrix: `ANLG-288`31 32## Build the Staging Candidate33 34Trigger `desktop_cd.yaml` with `channel=staging` from the requested candidate SHA. Verify the run's head SHA, download that run's artifact by ID, and never use a latest-staging download:35 36```bash37gh workflow run desktop_cd.yaml \38  --ref <candidate-ref> \39  -f channel=staging \40  -f candidate_sha=<40-character-candidate-sha>41gh run view <run-id> --json headSha,url42gh run download <run-id> --name hyprnote-staging-macos-silicon43```44 45Record the run URL and DMG SHA-256, install the artifact, and verify the app reports the expected version. The staging artifact must be signed output from that exact workflow run; do not substitute a local build.46 47Leave the MacBook open on its built-in speakers and microphone with no external audio device attached.48 49## Start from Onboarding50 511. Fully quit Anarlog Staging.522. Reset staging permissions while the app is closed:53 54   ```bash55   .agents/skills/qa-critical-ux/scripts/reset-native-qa-permissions.sh56   ```57 583. Back up any needed staging data, then remove the staging application data:59 60   ```bash61   rm -rf ~/Library/Application\ Support/com.hyprnote.staging62   ```63 644. Launch through LaunchServices without an onboarding override:65 66   ```bash67   open -a "Anarlog Staging" --env ONBOARDING=68   ```69 70Missing app data starts onboarding normally. Do not use `ONBOARDING=1`; resetting permissions asynchronously after initialization can suppress the microphone prompt. Do not edit permission databases.71 72Complete onboarding for real: grant each permission, sign in with the Pro or trialing test account, select Anarlog cloud (`anarlog`) in Settings → AI, and turn on encrypted cloud sync in Settings → Sync. Use that account's existing recovery key when prompted. Creating a new key on an account that already has sync fails this item.73 74## Checklist75 76### 1. Launch and stay responsive77 78- The app opens to a usable window without a hang, freeze, beachball, or startup error.79- Quit and relaunch once; startup completes and the UI remains responsive.80- Logs contain no panic, deadlock, or repeated-error loop.81 82### 2. Complete onboarding as a Pro user83 84- Each permission prompt appears and the grant persists.85- Sign-in completes and the app reaches the entitled state without feature-gate prompts.86- Settings → Sync turns on with the account's existing recovery key.87- A stalled, dead, or looping onboarding step fails this item.88 89### 3. Create a note and record90 91- Create a note, type content, and verify it persists.92- Start recording, then play the bundled fixture from the terminal:93 94  ```bash95  /usr/bin/afplay -v 0.7 -t 180 "$PWD/crates/data/src/english_10/audio.mp3"96  ```97 98- The timer runs, microphone and system-audio inputs have nonzero signal, live transcript words appear, and mute/unmute does not wedge the session.99- Logs contain no `audio_sync_probe_panicked`, dropped-sample, or queue-overflow events.100- Echo leakage, duplicate phrases, and generic speaker labels are informational under the out-of-scope tickets.101 102### 4. Stop and get a summary103 104- Stopping does not hang while settling.105- An enhanced summary and title are generated automatically, reflect the fixture content, and remain attached with the transcript.106- Restart the app and verify the note, transcript, and summary persist.107 108### 5. Sync the note and restore it109 110- After the summary exists, open Settings → Sync. Status must reach **Synced**, not stay on Connecting, Syncing, Saved locally, or Sync needs attention.111- Record the note title shown in the app. Quit Anarlog Staging. Do not reset permissions again. Wipe staging data once more:112 113  ```bash114  rm -rf ~/Library/Application\ Support/com.hyprnote.staging115  ```116 117- Launch through LaunchServices, sign in with the same Pro or trialing account, and enter the same recovery key.118- The same note, transcript, and summary reappear after restore. A missing note, empty transcript, or missing summary fails this item.119- Mid-recording deferral, chat/enhance leases, and hash-stable transcript integrity stay informational under `ANLG-287`.120 121Verify results programmatically where possible through the app's supported interfaces and logs. Do not query the app database directly.122 123## Reporting124 125Report:126 127- candidate SHA and staging workflow URL128- app version and DMG SHA-256129- PASS or FAIL for each checklist item, with one line of evidence130- out-of-scope observations separately131 132A failure or SHA mismatch fails the QA run but does not automatically block a release.133