From 1445f0e53526b92154a9fb4a1c8256fe77acce63 Mon Sep 17 00:00:00 2001
From: Kyle <suda@sudacode.com>
Date: Fri, 3 Apr 2026 14:09:30 -0700
Subject: [PATCH] Release prep v0.11.0

Bump version to 0.11.0, build changelog from 15 fragments,
update docs-site changelog, and regenerate config example.
---
 CHANGELOG.md                                  | 44 +++++++++++++++++--
 changes/251-docs-site-sidebar.md              |  6 ---
 changes/252-youtube-playback-socket-path.md   |  5 ---
 changes/253-aur-release-best-effort.md        |  5 ---
 changes/259-texthooker-integrated-startup.md  |  5 ---
 changes/260-playlist-browser.md               |  5 ---
 changes/261-macos-overlay-passthrough.md      |  5 ---
 changes/262-anilist-post-watch-dedupe.md      |  5 ---
 changes/267-yomitan-kiku-popup.md             |  6 ---
 changes/268-windows-mpv-shortcut-defaults.md  |  6 ---
 .../269-windows-mpv-shortcut-idle-overlay.md  |  5 ---
 ...270-first-run-setup-requires-mpv-plugin.md |  5 ---
 ...btitle-auto-selection-and-pause-release.md |  5 ---
 changes/272-windows-mpv-executable-path.md    |  5 ---
 ...-launcher-windows-backend-and-ytdlp-bin.md |  5 ---
 changes/274-launcher-runtime-fixes.md         |  5 ---
 docs-site/changelog.md                        | 16 +++++++
 package.json                                  |  2 +-
 18 files changed, 58 insertions(+), 82 deletions(-)
 delete mode 100644 changes/251-docs-site-sidebar.md
 delete mode 100644 changes/252-youtube-playback-socket-path.md
 delete mode 100644 changes/253-aur-release-best-effort.md
 delete mode 100644 changes/259-texthooker-integrated-startup.md
 delete mode 100644 changes/260-playlist-browser.md
 delete mode 100644 changes/261-macos-overlay-passthrough.md
 delete mode 100644 changes/262-anilist-post-watch-dedupe.md
 delete mode 100644 changes/267-yomitan-kiku-popup.md
 delete mode 100644 changes/268-windows-mpv-shortcut-defaults.md
 delete mode 100644 changes/269-windows-mpv-shortcut-idle-overlay.md
 delete mode 100644 changes/270-first-run-setup-requires-mpv-plugin.md
 delete mode 100644 changes/271-local-subtitle-auto-selection-and-pause-release.md
 delete mode 100644 changes/272-windows-mpv-executable-path.md
 delete mode 100644 changes/273-launcher-windows-backend-and-ytdlp-bin.md
 delete mode 100644 changes/274-launcher-runtime-fixes.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d1a4e737..b0924d68 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,14 +1,52 @@
 # Changelog
 
-## Unreleased
+## v0.11.0 (2026-04-03)
+
+### Added
+- Overlay: Added a playlist browser overlay modal for browsing sibling video files and the live mpv queue during playback.
+- Overlay: Added the default `Ctrl+Alt+P` keybinding to open the playlist browser and manage queue order without leaving playback.
+
+### Changed
+- Setup: Made mpv plugin installation mandatory in the first-run setup flow, removed the skip path, and kept Finish disabled until the plugin is installed.
+- Setup: Clarified that the mpv plugin requirement applies to setup on every platform, while the optional `SubMiner mpv` shortcut remains the recommended Windows playback entry point.
 
 ### Fixed
-- AniList: Stopped post-watch tracking from sending a second progress update when the current episode was already satisfied by a ready retry item in the same watch-completion pass.
+- Main: Resolve the YouTube playback socket path lazily so startup honors CLI and config overrides.
+- Main: Add regression coverage for the lazy socket-path lookup during Windows mpv startup.
+- Main: Keep integrated `--start --texthooker` launches on the full app-ready startup path so the texthooker page and websocket servers start together during normal playback startup.
+- Main: Stop the mpv/plugin auto-start flow from spawning a separate standalone texthooker helper during normal `subminer <video>` launches.
+- Overlay: Keep tracked macOS visible overlays click-through by default so subtitle sidebar passthrough works immediately without requiring a subtitle hover cycle first.
+- Overlay: Add regression coverage for the macOS visible-overlay passthrough default.
+- Anilist: Stop AniList post-watch from sending a second progress update when the current episode was already satisfied by a ready retry item in the same watch-completion pass.
+- Anilist: Add regression coverage for the retry-queue plus live-update duplicate path.
+- Overlay: Fixed Kiku duplicate grouping to reuse duplicate note IDs from both generic sentence-card creation and Yomitan popup mining instead of running extra duplicate scans after add.
+- Overlay: Fixed the Yomitan popup mining flow to add cards in the background while keeping the stock popup progress feedback, then pause playback and close the lookup popup before the Kiku merge modal opens.
+- Overlay: Fixed configured subtitle-jump keybindings so backward and forward subtitle seeks keep playback paused when invoked from a paused state.
+- Launcher: Fixed the Windows `SubMiner mpv` shortcut and `SubMiner.exe --launch-mpv` flow to launch mpv with SubMiner's required default args directly instead of requiring an `mpv.conf` profile named `subminer`.
+- Launcher: Clarified the Windows install and usage docs so the shortcut path is documented as self-contained, while the optional `subminer` mpv profile remains available for manual mpv launches.
+- Launcher: Hardened the first-run setup blocker copy and stale custom-scheme handling so setup messages stay aligned with config, plugin, and dictionary readiness.
+- Launcher: Fixed the Windows `SubMiner mpv` shortcut idle launch so loading a video after opening the shortcut keeps mpv in the expected SubMiner-managed session, auto-starts the overlay, and re-arms subtitle auto-selection for the newly opened file.
+- Launcher: Removed the redundant `.` subtitle search path from the Windows shortcut launch args and deduped repeated subtitle source tracks in the manual sync picker so duplicate external subtitle entries no longer appear from the shortcut path.
 - Playback: Fixed managed local playback so duplicate startup-ready retries no longer unpause media after a later manual pause on the same file.
-- Playback: Fixed managed local subtitle auto-selection so local files reuse configured primary/secondary subtitle language priorities instead of staying on mpv's initial `sid=auto` guess.
+- Playback: Fixed managed local subtitle auto-selection so local files reuse configured primary and secondary subtitle language priorities instead of staying on mpv's initial `sid=auto` guess.
+- Launcher: Added a blank-by-default `mpv.executablePath` override for Windows playback so users can point SubMiner at `mpv.exe` when it is not on `PATH`.
+- Launcher: Kept the Windows shortcut and `--launch-mpv` flow simple by preserving PATH auto-discovery as the default and exposing the override in first-run setup.
+- Launcher: Added `windows` as a recognized launcher backend option and auto-detection target on Windows.
+- Launcher: Honored `SUBMINER_YTDLP_BIN` consistently across YouTube playback URL resolution, track probing, subtitle downloads, and metadata probing.
+- Launcher: Kept the first-run setup window from navigating away on unexpected URLs.
+- Launcher: Made Windows mpv honor an explicitly configured executable path instead of silently falling back to PATH.
 - Launcher: Hardened `--launch-mpv` parsing and Windows binary resolution so valueless flags do not swallow media targets and symlinked launcher installs do not short-circuit PATH lookup.
 - Playback: Prevented stale async playlist-browser subtitle rearm callbacks from overriding newer subtitle selections during rapid file changes.
 
+### Docs
+- Docs Site: Added a dedicated Subtitle Sidebar guide and linked it from the homepage and configuration docs.
+- Docs Site: Linked Jimaku integration from the homepage to its dedicated docs page.
+- Docs Site: Refreshed docs-site theme tokens and hover/selection styling for the updated pages.
+
+### Internal
+- Release: Retried AUR clone and push operations in the tagged release workflow.
+- Release: Kept GitHub Releases green when AUR publish flakes and needs manual follow-up.
+
 ## v0.10.0 (2026-03-29)
 
 ### Changed
diff --git a/changes/251-docs-site-sidebar.md b/changes/251-docs-site-sidebar.md
deleted file mode 100644
index ef617827..00000000
--- a/changes/251-docs-site-sidebar.md
+++ /dev/null
@@ -1,6 +0,0 @@
-type: docs
-area: docs-site
-
-- Added a dedicated Subtitle Sidebar guide and linked it from the homepage and configuration docs.
-- Linked Jimaku integration from the homepage to its dedicated docs page.
-- Refreshed docs-site theme tokens and hover/selection styling for the updated pages.
diff --git a/changes/252-youtube-playback-socket-path.md b/changes/252-youtube-playback-socket-path.md
deleted file mode 100644
index 71e099b8..00000000
--- a/changes/252-youtube-playback-socket-path.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: fixed
-area: main
-
-- Resolve the YouTube playback socket path lazily so startup honors CLI and config overrides.
-- Add regression coverage for the lazy socket-path lookup during Windows mpv startup.
diff --git a/changes/253-aur-release-best-effort.md b/changes/253-aur-release-best-effort.md
deleted file mode 100644
index c9f37683..00000000
--- a/changes/253-aur-release-best-effort.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: internal
-area: release
-
-- Retried AUR clone and push operations in the tagged release workflow.
-- Kept GitHub Releases green when AUR publish flakes and needs manual follow-up.
diff --git a/changes/259-texthooker-integrated-startup.md b/changes/259-texthooker-integrated-startup.md
deleted file mode 100644
index 4765235a..00000000
--- a/changes/259-texthooker-integrated-startup.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: fixed
-area: main
-
-- Keep integrated `--start --texthooker` launches on the full app-ready startup path so the texthooker page and websocket servers start together during normal playback startup.
-- Stop the mpv/plugin auto-start flow from spawning a separate standalone texthooker helper during normal `subminer <video>` launches.
diff --git a/changes/260-playlist-browser.md b/changes/260-playlist-browser.md
deleted file mode 100644
index 1c443a29..00000000
--- a/changes/260-playlist-browser.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: added
-area: overlay
-
-- Added a playlist browser overlay modal for browsing sibling video files and the live mpv queue during playback.
-- Added the default `Ctrl+Alt+P` keybinding to open the playlist browser and manage queue order without leaving playback.
diff --git a/changes/261-macos-overlay-passthrough.md b/changes/261-macos-overlay-passthrough.md
deleted file mode 100644
index 0ecdcfe9..00000000
--- a/changes/261-macos-overlay-passthrough.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: fixed
-area: overlay
-
-- Keep tracked macOS visible overlays click-through by default so subtitle sidebar passthrough works immediately without requiring a subtitle hover cycle first.
-- Add regression coverage for the macOS visible-overlay passthrough default.
diff --git a/changes/262-anilist-post-watch-dedupe.md b/changes/262-anilist-post-watch-dedupe.md
deleted file mode 100644
index 5dc2477f..00000000
--- a/changes/262-anilist-post-watch-dedupe.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: fixed
-area: anilist
-
-- Stop AniList post-watch from sending a second progress update when the current episode was already satisfied by a ready retry item in the same watch-completion pass.
-- Add regression coverage for the retry-queue plus live-update duplicate path.
diff --git a/changes/267-yomitan-kiku-popup.md b/changes/267-yomitan-kiku-popup.md
deleted file mode 100644
index c41f8bd7..00000000
--- a/changes/267-yomitan-kiku-popup.md
+++ /dev/null
@@ -1,6 +0,0 @@
-type: fixed
-area: overlay
-
-- Fixed Kiku duplicate grouping to reuse duplicate note IDs from both generic sentence-card creation and Yomitan popup mining instead of running extra duplicate scans after add.
-- Fixed the Yomitan popup mining flow to add cards in the background while keeping the stock popup progress feedback, then pause playback and close the lookup popup before the Kiku merge modal opens.
-- Fixed configured subtitle-jump keybindings so backward and forward subtitle seeks keep playback paused when invoked from a paused state.
diff --git a/changes/268-windows-mpv-shortcut-defaults.md b/changes/268-windows-mpv-shortcut-defaults.md
deleted file mode 100644
index 85a5f657..00000000
--- a/changes/268-windows-mpv-shortcut-defaults.md
+++ /dev/null
@@ -1,6 +0,0 @@
-type: fixed
-area: launcher
-
-- Fixed the Windows `SubMiner mpv` shortcut and `SubMiner.exe --launch-mpv` flow to launch mpv with SubMiner's required default args directly instead of requiring an `mpv.conf` profile named `subminer`.
-- Clarified the Windows install and usage docs so the shortcut path is documented as self-contained, while the optional `subminer` mpv profile remains available for manual mpv launches.
-- Hardened the first-run setup blocker copy and stale custom-scheme handling so setup messages stay aligned with config, plugin, and dictionary readiness.
diff --git a/changes/269-windows-mpv-shortcut-idle-overlay.md b/changes/269-windows-mpv-shortcut-idle-overlay.md
deleted file mode 100644
index ce4d2b54..00000000
--- a/changes/269-windows-mpv-shortcut-idle-overlay.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: fixed
-area: launcher
-
-- Fixed the Windows `SubMiner mpv` shortcut idle launch so loading a video after opening the shortcut keeps mpv in the expected SubMiner-managed session, auto-starts the overlay, and re-arms subtitle auto-selection for the newly opened file.
-- Removed the redundant `.` subtitle search path from the Windows shortcut launch args and deduped repeated subtitle source tracks in the manual sync picker so duplicate external subtitle entries no longer appear from the shortcut path.
diff --git a/changes/270-first-run-setup-requires-mpv-plugin.md b/changes/270-first-run-setup-requires-mpv-plugin.md
deleted file mode 100644
index 22bbe57d..00000000
--- a/changes/270-first-run-setup-requires-mpv-plugin.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: changed
-area: setup
-
-- Made mpv plugin installation mandatory in the first-run setup flow, removed the skip path, and kept Finish disabled until the plugin is installed.
-- Clarified that the mpv plugin requirement applies to setup on every platform, while the optional `SubMiner mpv` shortcut remains the recommended Windows playback entry point.
diff --git a/changes/271-local-subtitle-auto-selection-and-pause-release.md b/changes/271-local-subtitle-auto-selection-and-pause-release.md
deleted file mode 100644
index bebbb306..00000000
--- a/changes/271-local-subtitle-auto-selection-and-pause-release.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: fixed
-area: playback
-
-- Fixed managed local playback so duplicate startup-ready retries no longer unpause media after a later manual pause on the same file.
-- Fixed managed local subtitle auto-selection so local files reuse configured primary and secondary subtitle language priorities instead of staying on mpv's initial `sid=auto` guess.
diff --git a/changes/272-windows-mpv-executable-path.md b/changes/272-windows-mpv-executable-path.md
deleted file mode 100644
index bc73fd00..00000000
--- a/changes/272-windows-mpv-executable-path.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: fixed
-area: launcher
-
-- Added a blank-by-default `mpv.executablePath` override for Windows playback so users can point SubMiner at `mpv.exe` when it is not on `PATH`.
-- Kept the Windows shortcut and `--launch-mpv` flow simple by preserving PATH auto-discovery as the default and exposing the override in first-run setup.
diff --git a/changes/273-launcher-windows-backend-and-ytdlp-bin.md b/changes/273-launcher-windows-backend-and-ytdlp-bin.md
deleted file mode 100644
index feea5692..00000000
--- a/changes/273-launcher-windows-backend-and-ytdlp-bin.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: fixed
-area: launcher
-
-- Added `windows` as a recognized launcher backend option and auto-detection target on Windows.
-- Honored `SUBMINER_YTDLP_BIN` consistently across YouTube playback URL resolution, track probing, subtitle downloads, and metadata probing.
diff --git a/changes/274-launcher-runtime-fixes.md b/changes/274-launcher-runtime-fixes.md
deleted file mode 100644
index ebe9bfc1..00000000
--- a/changes/274-launcher-runtime-fixes.md
+++ /dev/null
@@ -1,5 +0,0 @@
-type: fixed
-area: launcher
-
-- Kept the first-run setup window from navigating away on unexpected URLs.
-- Made Windows mpv honor an explicitly configured executable path instead of silently falling back to PATH.
diff --git a/docs-site/changelog.md b/docs-site/changelog.md
index 750d53fc..9a01e3d6 100644
--- a/docs-site/changelog.md
+++ b/docs-site/changelog.md
@@ -1,5 +1,21 @@
 # Changelog
 
+## v0.11.0 (2026-04-03)
+- Added a playlist browser overlay modal for browsing sibling video files and the live mpv queue during playback, with a default `Ctrl+Alt+P` keybinding.
+- Made mpv plugin installation mandatory in first-run setup (removed skip path); Finish stays disabled until the plugin is installed.
+- Fixed the Windows `SubMiner mpv` shortcut to launch mpv with required default args directly instead of requiring an `mpv.conf` profile named `subminer`.
+- Fixed the Windows mpv idle launch so loading a video after opening the shortcut keeps mpv in the SubMiner-managed session and auto-starts the overlay.
+- Added a blank-by-default `mpv.executablePath` config override for Windows playback when mpv is not on `PATH`, exposed in first-run setup.
+- Fixed Kiku duplicate grouping to reuse duplicate note IDs from both sentence-card creation and Yomitan popup mining, with background card addition and proper merge-modal sequencing.
+- Fixed configured subtitle-jump keybindings to keep playback paused when invoked from a paused state.
+- Fixed managed local subtitle auto-selection to reuse configured language priorities instead of staying on mpv's initial `sid=auto` guess.
+- Kept tracked macOS visible overlays click-through by default so subtitle sidebar passthrough works immediately.
+- Stopped AniList post-watch from sending duplicate progress updates when already satisfied by a retry item.
+- Kept integrated `--start --texthooker` launches on the full app-ready startup path.
+- Honored `SUBMINER_YTDLP_BIN` consistently across all YouTube flows (playback URL resolution, track probing, subtitle downloads, metadata probing).
+- Added `windows` as a recognized launcher backend option and auto-detection target.
+- Added a dedicated Subtitle Sidebar guide to the docs site with links from homepage and configuration docs.
+
 ## v0.10.0 (2026-03-29)
 - Fixed stats startup so the immersion tracker can run when `Bun.serve` is unavailable.
 - Added a Node `http` fallback for Electron/runtime paths that do not expose Bun, so stats keeps working there too.
diff --git a/package.json b/package.json
index d9751a9e..0f7623e8 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "subminer",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "All-in-one sentence mining overlay with AnkiConnect and dictionary integration",
   "packageManager": "bun@1.3.5",
   "main": "dist/main-entry.js",