════════════════════════════════════════════════════════════════════════
  TEST NOTES
  Gnomad Desktop Assistant · docs/TEST_NOTES.md
════════════════════════════════════════════════════════════════════════

TEST NOTES — GNOMAD DESKTOP ASSISTANT
=====================================

Run date: 2026-05-31  
Version: 0.2.0-beta.1  
Environment: macOS (darwin), project path with spaces

AUTOMATED RUNS
--------------

  Command                  |  Result         |  Notes                                                                             
  npm run build            |  PASS           |  tsc + Vite 7                                                                      
  npm run test             |  PASS (16)      |  Vitest — errors, models, agent loop                                               
  cargo test (src-tauri)   |  PASS (18)      |  error, env_config, hitl_token, path_token, privilege, shell_session, shell_sandbox
  cargo build (src-tauri)  |  PASS           |  Debug profile; default features (no embedded-llm)                                 
  npm run docs:export      |  PASS           |  35+ documents → HTML + TXT                                                        
  CI (build.yml)           |  Expected PASS  |  macOS, Linux x86_64, Linux ARM64, Windows on push to main                         

Embedded LLM (optional)

  [bash]
    npm run tauri:dev:embedded
    # or: cd src-tauri && cargo test --features embedded-llm

Not run in default CI to keep matrix fast.

VITEST COVERAGE (FRONTEND)
--------------------------

  File               |  What it tests                                             
  errors.test.ts     |  parseInvokeError, formatting helpers                      
  models.test.ts     |  normalizeCloudModel, cloud API presets                    
  agentLoop.test.ts  |  Mocked cloud turn → shell_run → completion; HITL deny path

NOT RUN IN THIS SESSION (GUI / OS)
----------------------------------

These require an interactive session and are manual:

  Test                    |  How                                                      
  App launch              |  npm run tauri dev                                        
  Overlay toggle          |  ⌘⇧Space / Ctrl+Shift+Space                               
  Voice dictation         |  Settings → Privacy → enable mic; composer mic button     
  Tray menu               |  Show Gnomad / Settings / Quit                            
  Wayland tray (Linux)    |  Left-click tray icon → menu                              
  Sudo Gate + HITL token  |  Approve risky cmd → signed token path                    
  Path Gate + path token  |  fs_read outside workspace → Allow once                   
  xterm replay            |  Expand command card → Terminal view                      
  Updates                 |  Settings → Updates → Check for updates                   
  YOLO sandbox            |  YOLO + experimental sandbox; verify blocked network reads
  Linux ARM64 install     |  Install CI .deb on ARM board                             
  Skip link               |  Windowed mode → Tab to skip link                         

MANUAL CHECKLIST (COPY FOR QA)
------------------------------

  [code]
    [ ] tauri dev starts without panic
    [ ] Overlay hidden on launch; shortcut shows it
    [ ] Cloud agent: tool loop runs shell + fs tools
    [ ] Sudo Gate: unsigned bypass rejected; approve mints token
    [ ] Path Gate: unsigned bypass rejected; approve mints token
    [ ] Standard mode: workspace fs works; outside path gated
    [ ] Settings → Updates: check returns message (even if no new release)
    [ ] Voice input: mic button appends transcript when enabled
    [ ] npm run test && cargo test pass locally

────────────────────────────────────────

Built with ❤️ by Gnomad Studio 🦙

════════════════════════════════════════════════════════════════════════
Built with ❤️ by Gnomad Studio 🦙
https://gnomadstudio.org
════════════════════════════════════════════════════════════════════════