- ```
-
-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
deleted file mode 100644
index f2f86e5..0000000
--- a/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-04-SUMMARY.md
+++ /dev/null
@@ -1,121 +0,0 @@
----
-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
deleted file mode 100644
index e8238cf..0000000
--- a/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-05-PLAN.md
+++ /dev/null
@@ -1,164 +0,0 @@
----
-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
deleted file mode 100644
index 855bec0..0000000
--- a/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-05-SUMMARY.md
+++ /dev/null
@@ -1,110 +0,0 @@
----
-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
deleted file mode 100644
index 91a3d0f..0000000
--- a/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-CONTEXT.md
+++ /dev/null
@@ -1,75 +0,0 @@
-# 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
deleted file mode 100644
index bf995ef..0000000
--- a/.planning/milestones/v1.1-phases/09-scan-cancellation-keyboard-shortcuts/09-RESEARCH.md
+++ /dev/null
@@ -1,555 +0,0 @@
-# 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 ``, `