════════════════════════════════════════════════════════════════════════
  ACCESSIBILITY
  Gnomad Desktop Assistant · docs/ACCESSIBILITY.md
════════════════════════════════════════════════════════════════════════

ACCESSIBILITY — GNOMAD DESKTOP ASSISTANT
========================================

Status: Alpha improvements (June 2026) — not a full WCAG 2.2 audit  
Target: v1.0 general availability pass

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

KEYBOARD SHORTCUTS
------------------

  Shortcut                    |  Action                                                                        
  ⌘⇧Space / Ctrl+Shift+Space  |  Show/hide Gnomad (global, OS-level)                                           
  Escape                      |  Close topmost overlay (gate modal → about → onboarding → settings → knowledge)
  ⌘K / Ctrl+K or ⌘L / Ctrl+L  |  Focus message composer                                                        
  ⌘, / Ctrl+,                 |  Open Settings                                                                 
  ⌘N / Ctrl+N                 |  New chat                                                                      

Shortcuts are disabled while typing in inputs unless combined with ⌘/Ctrl. Gate modals (Sudo / Path) only handle Escape.

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

IMPLEMENTED (ALPHA)
-------------------

  • Focus visible — :focus-visible ring on interactive controls
  • Composer — aria-label="Message Gnomad", stable #gnomad-composer-input id
  • Modals — role="dialog", aria-modal="true", focus trap on Sudo Gate, Path Gate, About, Onboarding
  • Skip link — windowed/fullscreen: “Skip to main content” jumps to #gnomad-main-content
  • Terminal — debounced aria-live summaries for xterm output (full stream not read line-by-line)
  • Knowledge tabs — role="tablist" / role="tab" / aria-selected
  • Existing labels — provider/model selects, send button, tray actions (see component aria-label attributes)

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

KNOWN GAPS (V1.0)
-----------------

  • Full WCAG 2.2 AA contrast audit not complete
  • Screen reader testing limited (VoiceOver / NVDA / Orca)
  • Live terminal: debounced summaries only (not full stream narration)

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

TESTING CHECKLIST
-----------------

  [code]
    [ ] Tab through Settings without mouse
    [ ] Escape closes settings and knowledge overlay
    [ ] ⌘K focuses composer from chat view
    [ ] Sudo Gate: Tab cycles Deny / Approve; Escape denies
    [ ] Focus ring visible on buttons and tabs (keyboard only)
    [ ] Onboarding: Tab through provider cards and form fields
    [ ] Windowed mode: Tab to “Skip to main content” → main chat

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

RELATED
-------

  • USER_GUIDE.md
  • ROADMAP.md — v1.0 WCAG pass
  • CROSS_PLATFORM_CHECKLIST.md

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

Built with ❤️ by Gnomad Studio 🦙

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