+ ```
+
+5. **Add cancel confirmation dialog** — render it conditionally when `showCancelDialog` is true. Place the dialog render at the end of the library section's render method (after the metrics tree, before the closing `` tag):
+
+ ```typescript
+ ${this.showCancelDialog ? html`
+
+
e.stopPropagation()}>
+
Cancel Scan
+
+ ${this.cancelMetrics?.added
+ ? `Keep ${this.cancelMetrics.added} tracks found so far, or discard?`
+ : 'Cancel the current scan?'}
+
+
+
+
+
+
+
+
+ ` : ''}
+ ```
+
+6. **Update the status bar** to show paused state:
+ In the existing status bar rendering, update to show "Paused" when paused:
+ ```typescript
+
+
+ ${this.shortcutConflict.newKey} is already bound to
+ ${ConfigPage.SHORTCUT_META[this.shortcutConflict.existingAction]?.label ?? this.shortcutConflict.existingAction}.
+
+
+
+
+
+
+ ` : ''}
+
+ `;
+ }
+ ```
+
+7. **Call `renderShortcutsSection()`** from the main render method. Insert `${this.renderShortcutsSection()}` in the template — place it between "Track List Columns" and "Library" sections, or after Library. Look at the current render layout to find the best spot.
+
+8. **Add CSS styles** for the shortcuts section:
+ ```css
+ .shortcut-category {
+ margin-bottom: 16px;
+ }
+ .shortcut-category-header {
+ font-size: var(--yj-text-sm, 13px);
+ font-weight: 600;
+ color: var(--yj-text-secondary, #aaa);
+ text-transform: uppercase;
+ letter-spacing: 0.5px;
+ margin-bottom: 8px;
+ padding-bottom: 4px;
+ border-bottom: 1px solid var(--yj-border, #444);
+ }
+ .shortcut-row {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 6px 0;
+ gap: 16px;
+ }
+ .shortcut-label {
+ font-size: var(--yj-text-sm, 13px);
+ color: var(--yj-text-primary, #eee);
+ }
+ .shortcut-scope {
+ font-size: var(--yj-text-xs, 11px);
+ color: var(--yj-text-tertiary, #888);
+ margin-left: 4px;
+ }
+ .shortcut-actions {
+ margin-top: 16px;
+ display: flex;
+ justify-content: flex-end;
+ }
+ .conflict-banner {
+ margin-top: 12px;
+ padding: 12px;
+ background: rgba(255, 165, 0, 0.1);
+ border: 1px solid rgba(255, 165, 0, 0.4);
+ border-radius: 6px;
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ gap: 12px;
+ }
+ .conflict-text {
+ font-size: var(--yj-text-sm, 13px);
+ }
+ .conflict-actions {
+ display: flex;
+ gap: 8px;
+ flex-shrink: 0;
+ }
+ ```
+
+
+ cd frontend && npx tsc --noEmit 2>&1 | head -20
+
+ Keyboard Shortcuts section renders in the config page with shortcuts grouped by category (Player, Navigation, App). Each row shows label + shortcut-capture widget. Conflict detection warns before overwriting. "Reset All to Defaults" and per-shortcut reset work. Panel-specific shortcuts show their scope label.
+
+
+
+
+
+```bash
+cd frontend && npx tsc --noEmit
+```
+TypeScript compiles. shortcut-capture component and shortcuts section are properly wired.
+
+
+
+- `shortcut-capture` component exists and handles recording, Escape cancel, blur cancel, reset
+- Config page has a "Keyboard Shortcuts" section with category headers
+- All 16 default shortcuts are listed with their labels
+- Clicking a capture widget enters recording mode, pressing a key updates the binding
+- Conflicts are detected and shown in a warning banner with Overwrite/Cancel options
+- "Reset All to Defaults" button calls store.resetAll()
+- Per-shortcut reset icon appears on hover when binding differs from default
+- Panel-specific shortcuts show their scope (e.g., "track-list") next to the label
+
+
+
diff --git a/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-04-SUMMARY.md b/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-04-SUMMARY.md
new file mode 100644
index 0000000..f2f86e5
--- /dev/null
+++ b/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-04-SUMMARY.md
@@ -0,0 +1,121 @@
+---
+phase: 09-scan-cancellation-keyboard-shortcuts
+plan: 04
+subsystem: ui
+tags: [keyboard-shortcuts, lit, web-components, config-ui]
+
+# Dependency graph
+requires:
+ - phase: 09-scan-cancellation-keyboard-shortcuts
+ provides: ShortcutsStore, ShortcutsController, buildKeyString utility (from 09-02)
+provides:
+ - shortcut-capture record-style key capture web component
+ - Keyboard Shortcuts settings section in config page with category grouping
+ - Conflict detection and resolution UI for shortcut rebinding
+ - Per-shortcut and global reset functionality
+affects: [09-05-shortcuts-integration]
+
+# Tech tracking
+tech-stack:
+ added: []
+ patterns:
+ - "Record-style key capture pattern: click to record, keydown to capture, Escape/blur to cancel"
+ - "Conflict detection banner with overwrite/cancel resolution"
+ - "Static SHORTCUT_META metadata map for UI labels, categories, scopes, and defaults"
+
+key-files:
+ created:
+ - frontend/src/components/config-page/shortcut-capture.ts
+ modified:
+ - frontend/src/components/config-page/config-page.ts
+
+key-decisions:
+ - "Place Keyboard Shortcuts as a config-section between Track List Columns and Library sections"
+ - "Use static SHORTCUT_META record on ConfigPage class for action metadata rather than importing from backend"
+ - "Conflict detection shows banner inline rather than dialog — simpler interaction pattern"
+
+patterns-established:
+ - "shortcut-capture component: reusable record-style key binding widget"
+
+requirements-completed: [KEY-02, KEY-03]
+
+# Metrics
+duration: 5min
+completed: 2026-03-07
+---
+
+# Phase 9 Plan 4: Keyboard Shortcuts Settings UI Summary
+
+**Record-style shortcut capture component with categorized settings section, inline conflict detection banner, and per-shortcut/global reset controls**
+
+## Performance
+
+- **Duration:** 5 min
+- **Started:** 2026-03-07T02:52:35Z
+- **Completed:** 2026-03-07T02:58:26Z
+- **Tasks:** 2
+- **Files modified:** 2
+
+## Accomplishments
+- shortcut-capture web component with recording mode, Escape cancel, blur cancel, and per-shortcut reset
+- Keyboard Shortcuts section in config page with Player, Navigation, App category grouping
+- All 16 default shortcuts listed with human-readable labels and scope indicators
+- Conflict detection warns before overwriting with Overwrite/Cancel resolution
+- Reset All to Defaults button for global shortcut reset
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Create shortcut-capture web component** - `3914369` (feat — bundled into 09-03 commit by concurrent agent)
+2. **Task 2: Add Keyboard Shortcuts section to config page with conflict detection** - `0451fb3` (feat)
+
+## Files Created/Modified
+- `frontend/src/components/config-page/shortcut-capture.ts` - Record-style key capture widget with buildKeyString integration
+- `frontend/src/components/config-page/config-page.ts` - Added Keyboard Shortcuts section with category grouping, conflict detection, reset controls
+
+## Decisions Made
+- Placed Keyboard Shortcuts section between Track List Columns and Library (natural position before infrastructure settings)
+- Used static `SHORTCUT_META` map on ConfigPage for label/category/scope/default metadata — keeps UI concerns local rather than pulling from backend
+- Conflict detection uses an inline banner below the shortcuts list rather than a modal dialog — simpler and less disruptive
+
+## Deviations from Plan
+
+### Auto-fixed Issues
+
+**1. [Rule 3 - Blocking] shortcut-capture.ts already committed by concurrent Plan 03 agent**
+- **Found during:** Task 1 (commit attempt)
+- **Issue:** The shortcut-capture.ts file was already in the working tree when Plan 03's agent ran `git add`, so it was bundled into commit `3914369` (feat(09-03))
+- **Fix:** Verified the file content matches the plan specification exactly — no re-creation needed. Proceeded to Task 2.
+- **Files modified:** None (file already correct)
+- **Verification:** `npx tsc --noEmit` passes, file content verified
+- **Committed in:** 3914369 (09-03 commit)
+
+---
+
+**Total deviations:** 1 auto-fixed (1 blocking)
+**Impact on plan:** Task 1's file was pre-committed by a concurrent agent. Content is correct; only the commit attribution differs. No scope creep.
+
+## Issues Encountered
+None
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+- Shortcuts settings UI complete — users can view, rebind, and reset all keyboard shortcuts
+- Ready for Plan 05 (shortcuts integration testing) or other remaining plans
+- shortcut-capture component is reusable for any future key-binding UI needs
+
+## Self-Check: PASSED
+
+- [x] shortcut-capture.ts exists
+- [x] config-page.ts exists
+- [x] 09-04-SUMMARY.md exists
+- [x] Commit 3914369 exists (Task 1 — bundled in 09-03)
+- [x] Commit 0451fb3 exists (Task 2)
+
+---
+*Phase: 09-scan-cancellation-keyboard-shortcuts*
+*Completed: 2026-03-07*
diff --git a/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-05-PLAN.md b/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-05-PLAN.md
new file mode 100644
index 0000000..e8238cf
--- /dev/null
+++ b/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-05-PLAN.md
@@ -0,0 +1,164 @@
+---
+phase: 09-scan-cancellation-keyboard-shortcuts
+plan: 05
+type: execute
+wave: 3
+depends_on:
+ - 09-01
+ - 09-02
+ - 09-03
+ - 09-04
+files_modified: []
+autonomous: false
+requirements:
+ - SCAN-01
+ - SCAN-02
+ - SCAN-03
+ - KEY-01
+ - KEY-02
+ - KEY-03
+ - KEY-04
+ - KEY-05
+
+must_haves:
+ truths:
+ - "User can start a scan, pause it, resume it, and cancel it — all via buttons in the settings page"
+ - "Cancelled scan does not corrupt the database or delete unvisited files"
+ - "Default keyboard shortcuts work immediately — Space, arrows, S, R, Q, M, N, P, /, Ctrl+F"
+ - "Shortcuts are suppressed when typing in search box (except Escape)"
+ - "User can rebind any shortcut via record-style capture in settings"
+ - "Shortcut conflicts are detected and warned about"
+ - "Shortcut bindings persist across app restart"
+ artifacts: []
+ key_links: []
+---
+
+
+Verify all Phase 9 features work together end-to-end — scan control and keyboard shortcuts.
+
+Purpose: Catch integration issues before marking the phase complete.
+Output: Verification results and any integration fixes needed.
+
+
+
+@/home/caleb/.config/opencode/get-shit-done/workflows/execute-plan.md
+@/home/caleb/.config/opencode/get-shit-done/templates/summary.md
+
+
+
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/09-scan-cancellation-keyboard-shortcuts/09-01-SUMMARY.md
+@.planning/phases/09-scan-cancellation-keyboard-shortcuts/09-02-SUMMARY.md
+@.planning/phases/09-scan-cancellation-keyboard-shortcuts/09-03-SUMMARY.md
+@.planning/phases/09-scan-cancellation-keyboard-shortcuts/09-04-SUMMARY.md
+
+
+
+
+
+ Task 1: Build verification and automated checks
+
+
+1. Run the full build to verify everything compiles:
+ ```bash
+ cd backend && go build ./...
+ cd ../frontend && npx tsc --noEmit
+ ```
+
+2. Run existing tests to verify no regressions:
+ ```bash
+ cd backend && go test ./... -count=1 -timeout 120s
+ ```
+
+3. Run go vet on all packages:
+ ```bash
+ cd backend && go vet ./...
+ ```
+
+4. Verify event sync is up to date:
+ ```bash
+ cd backend && go generate ./events/...
+ git diff --exit-code frontend/src/events.ts
+ ```
+
+5. Verify the new scan control methods are Wails-bindable (exported, on a bound struct):
+ ```bash
+ grep -n "func (l \*Library) CancelScan\|func (l \*Library) PauseScan\|func (l \*Library) ResumeScan\|func (l \*Library) IsScanActive\|func (l \*Library) IsScanPaused" backend/library/scan_control.go
+ ```
+
+6. Verify shortcuts config is accessible:
+ ```bash
+ grep -n "func (c \*Config) GetShortcuts\|func (c \*Config) SetShortcut" backend/config/config.go
+ ```
+
+7. Fix any issues found.
+
+
+ cd backend && go build ./... && go vet ./... && go test ./... -count=1 -timeout 120s 2>&1 | tail -20
+
+ Full backend + frontend build passes, all existing tests pass, no regressions.
+
+
+
+ Task 2: Human verification of all Phase 9 features
+ Verify all scan control and keyboard shortcut features work end-to-end.
+ Human confirms all 23 verification steps pass.
+ All Phase 9 requirements verified: SCAN-01/02/03 and KEY-01/02/03/04/05.
+
+Complete scan cancellation and keyboard shortcuts features:
+1. Backend: CancelScan/PauseScan/ResumeScan methods with per-scan context and channel-based pause
+2. Frontend scan UI: Pause/Resume/Cancel buttons during scan, cancel confirmation dialog
+3. Keyboard shortcuts: 16 default bindings (Space, arrows, S/R/Q/M/N/P, /, Ctrl+F, Ctrl+A, Enter, Delete)
+4. Keyboard shortcut settings: Record-style key capture, conflict detection, grouped by category, reset to defaults
+5. Config persistence: Shortcuts saved to TOML config file
+
+
+**Scan Control (Settings > Library):**
+1. Open Settings, configure a library directory with many audio files
+2. Click "Soft Scan" — verify Pause and Cancel buttons appear, progress shows
+3. Click "Pause" — verify status says "Scan paused.", button changes to "Resume"
+4. Click "Resume" — verify scan continues from where it left off
+5. Start another scan, click "Cancel Scan" — verify confirmation dialog appears showing track count
+6. Click "Keep X tracks" — verify scan stops, tracks remain in library
+7. Start another scan, cancel, click "Discard" — verify scan stops with discard message
+
+**Keyboard Shortcuts:**
+8. Without any text input focused, press Space — verify play/pause toggles
+9. Press Up/Down arrows — verify volume changes
+10. Press Left/Right arrows — verify seeking (if a track is playing)
+11. Press S — verify shuffle toggles
+12. Press R — verify repeat mode cycles
+13. Press Q — verify queue panel toggles
+14. Press / or Ctrl+F — verify search box gets focus
+15. Click inside the search box, type — verify shortcuts do NOT fire while typing
+16. Press Escape while in search box — verify search box blurs and shortcuts resume
+
+**Shortcut Settings (Settings > Keyboard Shortcuts):**
+17. Scroll to Keyboard Shortcuts section — verify shortcuts grouped by Player, Navigation, App
+18. Click on a shortcut's key badge (e.g., Space for Play/Pause) — verify it enters "Press a key combo..." mode
+19. Press a new key — verify the binding updates
+20. Try binding a key that's already used — verify conflict warning appears
+21. Click "Overwrite" — verify old binding is cleared and new one is set
+22. Click "Reset All to Defaults" — verify all shortcuts return to defaults
+23. Restart the app — verify custom bindings persist
+
+ Type "approved" or describe any issues found
+
+
+
+
+
+Full build passes. All existing tests pass. Human verification covers all 8 requirement IDs.
+
+
+
+- `go build ./...` and `npx tsc --noEmit` pass
+- `go test ./...` passes with no regressions
+- All 23 manual verification steps confirmed by user
+
+
+
diff --git a/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-05-SUMMARY.md b/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-05-SUMMARY.md
new file mode 100644
index 0000000..855bec0
--- /dev/null
+++ b/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-05-SUMMARY.md
@@ -0,0 +1,110 @@
+---
+phase: 09-scan-cancellation-keyboard-shortcuts
+plan: 05
+subsystem: integration
+tags: [integration-testing, verification, scan-control, keyboard-shortcuts, volume-fix]
+
+# Dependency graph
+requires:
+ - phase: 09-scan-cancellation-keyboard-shortcuts
+ provides: All Phase 9 features — scan control backend (09-01), keyboard shortcuts service (09-02), scan control UI (09-03), shortcuts settings UI (09-04)
+provides:
+ - End-to-end verified scan cancellation with pause/resume
+ - End-to-end verified keyboard shortcuts with rebinding and persistence
+ - Volume data flow fix (ChangeVolume/MuteToggle emit events and persist state)
+affects: []
+
+# Tech tracking
+tech-stack:
+ added: []
+ patterns: []
+
+key-files:
+ created: []
+ modified:
+ - backend/player/player.go
+
+key-decisions:
+ - "ChangeVolume and MuteToggle must emit VolumeChanged event and call saveState for UI sync"
+
+patterns-established: []
+
+requirements-completed: [SCAN-01, SCAN-02, SCAN-03, KEY-01, KEY-02, KEY-03, KEY-04, KEY-05]
+
+# Metrics
+duration: 3min
+completed: 2026-03-07
+---
+
+# Phase 9 Plan 05: Integration Testing & Verification Summary
+
+**End-to-end verification of scan control and keyboard shortcuts with volume data flow bug fix found and resolved during human testing**
+
+## Performance
+
+- **Duration:** ~3 min (continuation — tasks 1-2 completed across checkpoint)
+- **Started:** 2026-03-07T02:58:00Z
+- **Completed:** 2026-03-07T15:06:00Z
+- **Tasks:** 2
+- **Files modified:** 1 (bug fix during verification)
+
+## Accomplishments
+- Full build verification passed: `go build`, `npx tsc --noEmit`, `go vet`, `go test` all clean
+- Event codegen sync verified (frontend/src/events.ts matches backend)
+- All 5 scan control methods confirmed Wails-bindable (exported on Library struct)
+- All 4 shortcuts config methods confirmed Wails-bindable (exported on Config struct)
+- Human verification of all 23 test scenarios approved
+- Found and fixed volume data flow bug: ChangeVolume/MuteToggle were missing emitVolumeChanged and saveState calls
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Build verification and automated checks** - No commit (verification only, no code changes)
+2. **Task 2: Human verification of all Phase 9 features** - Approved after bug fix
+
+**Bug fix during verification:** `bb3fd20` (fix: emit VolumeChanged event and persist state in ChangeVolume and MuteToggle)
+
+## Files Created/Modified
+- `backend/player/player.go` - Added emitVolumeChanged() and saveState() calls to ChangeVolume() and MuteToggle() methods
+
+## Decisions Made
+- ChangeVolume and MuteToggle must emit VolumeChanged event and call saveState — without this, the frontend volume slider and mute icon don't update when keyboard shortcuts change volume
+
+## Deviations from Plan
+
+### Auto-fixed Issues
+
+**1. [Rule 1 - Bug] ChangeVolume and MuteToggle missing event emission and state persistence**
+- **Found during:** Task 2 (human verification — volume shortcuts didn't update UI)
+- **Issue:** `ChangeVolume()` and `MuteToggle()` in `backend/player/player.go` modified volume/mute state but didn't call `emitVolumeChanged()` or `saveState()`, so the frontend volume slider and mute icon never reflected keyboard-shortcut-driven changes
+- **Fix:** Added `p.emitVolumeChanged()` and `p.saveState()` calls to both methods, matching the pattern used by `SetVolume()` and `SetMuted()`
+- **Files modified:** backend/player/player.go
+- **Verification:** Volume up/down shortcuts now update the slider; mute toggle shortcut now updates the mute icon
+- **Committed in:** bb3fd20
+
+---
+
+**Total deviations:** 1 auto-fixed (1 bug)
+**Impact on plan:** Essential fix for keyboard shortcut → volume UI feedback loop. Without this, volume shortcuts worked but the UI didn't reflect changes.
+
+## Issues Encountered
+None beyond the volume data flow bug documented above.
+
+## User Setup Required
+None - no external service configuration required.
+
+## Next Phase Readiness
+- Phase 9 complete — all 8 requirements verified (SCAN-01/02/03, KEY-01/02/03/04/05)
+- Ready for Phase 10 (Tag Editing) or other v1.1 phases
+- Scan control and keyboard shortcuts patterns established for reuse
+
+## Self-Check: PASSED
+
+- [x] backend/player/player.go exists (modified file)
+- [x] Commit bb3fd20 exists (bug fix)
+- [x] All 4 prior plan summaries exist (09-01 through 09-04)
+
+---
+*Phase: 09-scan-cancellation-keyboard-shortcuts*
+*Completed: 2026-03-07*
diff --git a/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-CONTEXT.md b/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-CONTEXT.md
new file mode 100644
index 0000000..91a3d0f
--- /dev/null
+++ b/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-CONTEXT.md
@@ -0,0 +1,75 @@
+# Phase 9: Scan Cancellation & Keyboard Shortcuts - Context
+
+**Gathered:** 2026-03-06
+**Status:** Ready for planning
+
+
+## Phase Boundary
+
+Users can control library scans (cancel/pause/resume) and operate the entire app via configurable keyboard shortcuts. Scans stop gracefully without database corruption, paused scans resume without re-processing. Keyboard shortcuts work out of the box with sensible defaults, are fully customizable via a settings UI, context-aware across three scopes, and suppressed during text input.
+
+
+
+
+## Implementation Decisions
+
+### Default key bindings
+- Hybrid style: Space/arrows for player controls (no modifier), Ctrl+key for app actions
+- Up/Down arrows adjust volume, Left/Right seek within track
+- Both `/` and `Ctrl+F` focus the search box
+- `Q` toggles the queue panel
+- `S` for shuffle, `R` for repeat (single-key player controls)
+- `Ctrl+A` for select-all in any multi-select context (track lists, etc.)
+- All bindings are configurable — the above are defaults
+- Claude fills in remaining defaults (mute, etc.) using common media player conventions
+
+### Shortcut settings UI
+- Record-style key capture: click a shortcut row, press the new key combo, it captures live
+- Conflicts show a warning with the conflicting action — user chooses to overwrite (old becomes unbound) or cancel
+- Shortcuts grouped by category (Player, Navigation, App) in the settings view
+- "Reset to defaults" button resets all shortcuts; individual per-shortcut reset also available
+- Lives as a "Keyboard Shortcuts" tab within the existing settings dialog
+
+### Context scoping
+- Three scopes: Global (always active), Panel-specific (when a panel has focus), Text Input (shortcuts suppressed)
+- Global scope: player controls (Space, arrows, S, R, Q, etc.) fire regardless of which panel is focused
+- Panel-specific scope: track list gets Enter-to-play and Delete-to-remove when focused
+- Text Input scope: only Escape works (blurs the text input) — all other shortcuts suppressed
+- No visual scope indicator — relies on natural browser focus behavior; users learn through use
+
+### Scan control UX
+- Pause and Cancel buttons placed next to the existing status label, above the existing progress bar in the scanner UI
+- On cancel: prompt the user — "Keep X tracks found so far, or discard?" — gives user control over partial results
+- On resume after pause: skip already-processed files and continue with remaining — no duplicate work
+- Scan control is buttons-only — no keyboard shortcuts for cancel/pause (scans are infrequent)
+
+### Claude's Discretion
+- Remaining default key assignments not explicitly discussed (mute, volume step size, etc.)
+- Scan progress detail level and error handling during scan
+- Loading/disabled states for scan control buttons
+- Visual design of the shortcut settings UI (spacing, grouping headers, etc.)
+- How the cancel confirmation dialog looks and behaves
+
+
+
+
+## Specific Ideas
+
+- Hybrid key style inspired by media players (Foobar2000/Winamp feel for player controls, standard app conventions for Ctrl+key actions)
+- Both `/` and `Ctrl+F` for search — power users get slash, everyone knows Ctrl+F
+- Record-style key capture like VS Code's keybinding editor
+- Cancel prompt on scan gives user control without losing work
+
+
+
+
+## Deferred Ideas
+
+None — discussion stayed within phase scope
+
+
+
+---
+
+*Phase: 09-scan-cancellation-keyboard-shortcuts*
+*Context gathered: 2026-03-06*
diff --git a/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-RESEARCH.md b/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-RESEARCH.md
new file mode 100644
index 0000000..bf995ef
--- /dev/null
+++ b/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-RESEARCH.md
@@ -0,0 +1,555 @@
+# Phase 9: Scan Cancellation & Keyboard Shortcuts - Research
+
+**Researched:** 2026-03-06
+**Domain:** Go context cancellation, frontend keyboard event management, Lit web component architecture
+**Confidence:** HIGH
+
+## Summary
+
+This phase adds two independent feature sets to YellowJacket: scan control (cancel/pause/resume) on the Go backend with frontend buttons, and a full keyboard shortcut system on the Lit frontend with configurable bindings persisted via the existing TOML config.
+
+**Scan cancellation** requires threading a cancellable `context.Context` through the existing scan pipeline. The current `Scan()` method already checks `l.ctx.Done()` in several `select` blocks within the directory walker and worker pool. The implementation adds a dedicated `scanCancel context.CancelFunc` field on `Library`, Pause/Resume via a sync-based mechanism (channel or mutex), and new Wails-bound methods (`CancelScan`, `PauseScan`, `ResumeScan`). The cancel confirmation dialog ("Keep X tracks found so far, or discard?") is a frontend concern — the backend simply stops and reports partial results vs rolls back.
+
+**Keyboard shortcuts** are a pure frontend feature. No external libraries are needed — the browser's `KeyboardEvent` API is sufficient for a Wails desktop app. A central `KeyboardShortcutService` singleton listens on `document.keydown`, resolves the active scope (Global, Panel-specific, Text Input), looks up the action, and dispatches it. Bindings are stored in the Go config (new `Shortcuts` TOML section) and exposed via Wails bindings. The settings UI adds a "Keyboard Shortcuts" tab to the existing `config-page` component with record-style key capture.
+
+**Primary recommendation:** Implement scan cancellation via `context.WithCancel` + a pause channel on the backend, and keyboard shortcuts as a frontend-only `KeyboardShortcutService` with Go config persistence. Both are zero-dependency — no new libraries needed on either side.
+
+
+## User Constraints (from CONTEXT.md)
+
+### Locked Decisions
+- Hybrid style: Space/arrows for player controls (no modifier), Ctrl+key for app actions
+- Up/Down arrows adjust volume, Left/Right seek within track
+- Both `/` and `Ctrl+F` focus the search box
+- `Q` toggles the queue panel
+- `S` for shuffle, `R` for repeat (single-key player controls)
+- `Ctrl+A` for select-all in any multi-select context (track lists, etc.)
+- All bindings are configurable — the above are defaults
+- Claude fills in remaining defaults (mute, etc.) using common media player conventions
+- Record-style key capture: click a shortcut row, press the new key combo, it captures live
+- Conflicts show a warning with the conflicting action — user chooses to overwrite (old becomes unbound) or cancel
+- Shortcuts grouped by category (Player, Navigation, App) in the settings view
+- "Reset to defaults" button resets all shortcuts; individual per-shortcut reset also available
+- Lives as a "Keyboard Shortcuts" tab within the existing settings dialog
+- Three scopes: Global (always active), Panel-specific (when a panel has focus), Text Input (shortcuts suppressed)
+- Global scope: player controls (Space, arrows, S, R, Q, etc.) fire regardless of which panel is focused
+- Panel-specific scope: track list gets Enter-to-play and Delete-to-remove when focused
+- Text Input scope: only Escape works (blurs the text input) — all other shortcuts suppressed
+- No visual scope indicator — relies on natural browser focus behavior; users learn through use
+- Pause and Cancel buttons placed next to the existing status label, above the existing progress bar in the scanner UI
+- On cancel: prompt the user — "Keep X tracks found so far, or discard?" — gives user control over partial results
+- On resume after pause: skip already-processed files and continue with remaining — no duplicate work
+- Scan control is buttons-only — no keyboard shortcuts for cancel/pause (scans are infrequent)
+
+### Claude's Discretion
+- Remaining default key assignments not explicitly discussed (mute, volume step size, etc.)
+- Scan progress detail level and error handling during scan
+- Loading/disabled states for scan control buttons
+- Visual design of the shortcut settings UI (spacing, grouping headers, etc.)
+- How the cancel confirmation dialog looks and behaves
+
+### Deferred Ideas (OUT OF SCOPE)
+None — discussion stayed within phase scope
+
+
+
+## Phase Requirements
+
+| ID | Description | Research Support |
+|----|-------------|-----------------|
+| SCAN-01 | User can cancel an in-progress library scan via a cancel button | Go context cancellation pattern; new `CancelScan()` Wails binding; frontend cancel button in config-page scan section |
+| SCAN-02 | Cancelled scan stops gracefully without corrupting the database | Batch-transactional writes already atomic; cancel skips orphan cleanup (STATE.md warning); partial results either kept or discarded per user choice |
+| SCAN-03 | User can pause a library scan and resume it without re-scanning processed files | Pause channel blocks worker pool goroutines; resume unblocks; existingPaths sync.Map already tracks processed files |
+| KEY-01 | Default keybindings work out of box | Frontend `KeyboardShortcutService` with hardcoded default map; Go config stores overrides |
+| KEY-02 | User can customize all keyboard shortcuts via a visual settings UI | "Keyboard Shortcuts" tab in config-page; record-style key capture component; Wails config bindings for persistence |
+| KEY-03 | Shortcut conflicts are detected and warned about when rebinding | Frontend conflict detection during key capture — compare against all bindings in same scope |
+| KEY-04 | Shortcuts are scoped — different bindings apply based on focused component | Three-scope system (Global, Panel, TextInput); scope resolved by checking `document.activeElement` shadow DOM chain |
+| KEY-05 | Shortcuts are disabled when text input has focus (except Escape to blur) | TextInput scope check: if active element is ``, `