Deduplicate voice actor image downloads per AniList person ID

- Avoid repeated downloads when multiple characters share the same voice actor
- Add coverage for shared voice actor image download behavior

.github/workflows/ci.yml

@@ -31,8 +31,7 @@ jobs:
           path: |
             ~/.bun/install/cache
             node_modules
-            vendor/subminer-yomitan/node_modules
-          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock', 'vendor/subminer-yomitan/package-lock.json') }}
+          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock') }}
           restore-keys: |
             ${{ runner.os }}-bun-
 

.github/workflows/release.yml

@@ -31,23 +31,22 @@ jobs:
         with:
           node-version: 22.12.0
 
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
       - name: Cache dependencies
         uses: actions/cache@v4
         with:
           path: |
             ~/.bun/install/cache
             node_modules
-            vendor/subminer-yomitan/node_modules
-          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock', 'vendor/subminer-yomitan/package-lock.json') }}
+          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock') }}
           restore-keys: |
             ${{ runner.os }}-bun-
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
 
-      - name: Build (TypeScript check)
-        run: bun run typecheck
-
       - name: Test suite (source)
         run: bun run test:fast
 
@@ -85,11 +84,6 @@ jobs:
         with:
           bun-version: 1.3.5
 
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22.12.0
-
       - name: Cache dependencies
         uses: actions/cache@v4
         with:
@@ -97,8 +91,7 @@ jobs:
             ~/.bun/install/cache
             node_modules
             vendor/texthooker-ui/node_modules
-            vendor/subminer-yomitan/node_modules
-          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock', 'vendor/texthooker-ui/package.json', 'vendor/subminer-yomitan/package-lock.json') }}
+          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock', 'vendor/texthooker-ui/package.json') }}
           restore-keys: |
             ${{ runner.os }}-bun-
 
@@ -147,11 +140,6 @@ jobs:
         with:
           bun-version: 1.3.5
 
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22.12.0
-
       - name: Cache dependencies
         uses: actions/cache@v4
         with:
@@ -159,8 +147,7 @@ jobs:
             ~/.bun/install/cache
             node_modules
             vendor/texthooker-ui/node_modules
-            vendor/subminer-yomitan/node_modules
-          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock', 'vendor/texthooker-ui/package.json', 'vendor/subminer-yomitan/package-lock.json') }}
+          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock', 'vendor/texthooker-ui/package.json') }}
           restore-keys: |
             ${{ runner.os }}-bun-
 

.gitignore

@@ -5,7 +5,6 @@ node_modules/
 out/
 dist/
 release/
-build/yomitan/
 
 # Launcher build artifact (produced by make build-launcher)
 /subminer
@@ -37,4 +36,3 @@ tests/*
 .worktrees/
 .codex/*
 .agents/*
-docs/*

.gitmodules

@@ -5,6 +5,6 @@
 [submodule "vendor/yomitan-jlpt-vocab"]
 	path = vendor/yomitan-jlpt-vocab
 	url = https://github.com/stephenmk/yomitan-jlpt-vocab
-[submodule "vendor/subminer-yomitan"]
-	path = vendor/subminer-yomitan
-	url = https://github.com/ksyasuda/subminer-yomitan
+[submodule "yomitan-jlpt-vocab"]
+	path = vendor/yomitan-jlpt-vocab
+	url = https://github.com/stephenmk/yomitan-jlpt-vocab

Makefile

@@ -98,7 +98,7 @@ ensure-bun:
 	@command -v bun >/dev/null 2>&1 || { printf '%s\n' "[ERROR] bun not found"; exit 1; }
 
 pretty: ensure-bun
-	@bun run format:src
+	@bun run format
 
 build:
 	@printf '%s\n' "[INFO] Detected platform: $(PLATFORM)"

README.md

@@ -33,7 +33,6 @@ SubMiner is an Electron overlay that sits on top of mpv. It turns your video pla
 - **Subtitle tools** — Download from Jimaku, sync with alass/ffsubsync
 - **Immersion tracking** — SQLite-powered stats on your watch time and mining activity
 - **Custom texthooker page** — Built-in custom texthooker page and websocket, no extra setup
-- **Annotated websocket API** — Dedicated annotation feed can serve bundled texthooker or external clients with rendered `sentence` HTML plus structured `tokens`
 - **Jellyfin integration** — Remote playback setup, cast device mode, and direct playback launch
 - **AniList progress** — Track episode completion and push watching progress automatically
 
@@ -54,36 +53,30 @@ chmod +x ~/.local/bin/subminer
 > [!NOTE]
 > The `subminer` wrapper uses a [Bun](https://bun.sh) shebang. Make sure `bun` is on your `PATH`.
 
-**From source** or **macOS** — initialize submodules first (`git submodule update --init --recursive`). Source builds now also require Node.js 22 + npm because bundled Yomitan is built from the `vendor/subminer-yomitan` submodule into `build/yomitan` during `bun run build`. Full install guide: [docs.subminer.moe/installation#from-source](https://docs.subminer.moe/installation#from-source).
+**From source** or **macOS** — see the [installation guide](https://docs.subminer.moe/installation#from-source).
 
-### 2. Launch the app once
+### 2. Install the mpv plugin and configuration file
 
 ```bash
-SubMiner.AppImage
+wget https://github.com/ksyasuda/SubMiner/releases/latest/download/subminer-assets.tar.gz -O /tmp/subminer-assets.tar.gz
+tar -xzf /tmp/subminer-assets.tar.gz -C /tmp
+mkdir -p ~/.config/mpv/scripts/subminer
+mkdir -p ~/.config/mpv/script-opts
+cp -R /tmp/plugin/subminer/. ~/.config/mpv/scripts/subminer/
+cp /tmp/plugin/subminer.conf ~/.config/mpv/script-opts/
+mkdir -p ~/.config/SubMiner && cp /tmp/config.example.jsonc ~/.config/SubMiner/config.jsonc
 ```
 
-On first launch, SubMiner now:
+### 3. Set up Yomitan Dictionaries
 
-- starts in the tray/background
-- creates the default config directory and `config.jsonc`
-- opens a compact setup popup
-- can install the mpv plugin to the default mpv scripts location for you
-- links directly to Yomitan settings so you can install dictionaries before finishing setup
-
-Existing installs that already have a valid config plus at least one Yomitan dictionary are auto-detected as complete and will not be re-prompted.
-
-### 3. Finish setup
-
-- click `Install mpv plugin` if you want the default plugin auto-start flow
-- click `Open Yomitan Settings` and install at least one dictionary
-- click `Refresh status`
-- click `Finish setup`
-
-The mpv plugin step is optional. Yomitan must report at least one installed dictionary before setup can be completed.
+```bash
+subminer app --yomitan
+```
 
 ### 4. Mine
 
 ```bash
+subminer app --start --background
 subminer video.mkv # default plugin config auto-starts visible overlay + resumes playback when ready
 subminer --start video.mkv # optional explicit overlay start when plugin auto_start=no
 ```
@@ -92,7 +85,7 @@ subminer --start video.mkv # optional explicit overlay start when plugin auto_st
 
 | Required                                   | Optional                                           |
 | ------------------------------------------ | -------------------------------------------------- |
-| `bun`, `node` 22, `npm`                    |                                                    |
+| `bun`                                      |                                                    |
 | `mpv` with IPC socket                      | `yt-dlp`                                           |
 | `ffmpeg`                                   | `guessit` (better AniSkip title/episode detection) |
 | `mecab` + `mecab-ipadic`                   | `fzf` / `rofi`                                     |

backlog/tasks/task-100 - Add-configurable-texthooker-startup-launch.md

@@ -1,49 +0,0 @@
----
-id: TASK-100
-title: 'Add configurable texthooker startup launch'
-status: Done
-assignee: []
-created_date: '2026-03-06 23:30'
-updated_date: '2026-03-07 01:59'
-labels: []
-dependencies: []
-priority: medium
-ordinal: 10000
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-
-Add a config option under `texthooker` to launch the built-in texthooker server automatically when SubMiner starts.
-
-Scope:
-
-- Add `texthooker.launchAtStartup`.
-- Default to `true`.
-- Start the existing texthooker server during normal app startup when enabled.
-- Keep `texthooker.openBrowser` as separate behavior.
-- Add regression coverage and update generated config docs/example.
-
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-
-<!-- AC:BEGIN -->
-
-- [x] #1 Default config enables automatic texthooker startup.
-- [x] #2 Config parser accepts valid boolean values and warns on invalid values.
-- [x] #3 App-ready startup launches texthooker when enabled.
-- [x] #4 Generated config template/example documents the new option.
-
-<!-- AC:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-
-Added `texthooker.launchAtStartup` with a default of `true`, wired it through config defaults/validation/template generation, and started the existing texthooker server during app-ready startup without coupling it to browser auto-open behavior.
-
-Also added regression coverage for config parsing/template output and app-ready dependency wiring, then regenerated the checked-in config example artifacts.
-
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-101 - Index-AniList-character-alternative-names-in-the-character-dictionary.md

@@ -1,39 +0,0 @@
----
-id: TASK-101
-title: Index AniList character alternative names in the character dictionary
-status: Done
-assignee: []
-created_date: '2026-03-07 00:00'
-updated_date: '2026-03-08 00:11'
-labels:
-  - dictionary
-  - anilist
-dependencies: []
-references:
-  - src/main/character-dictionary-runtime.ts
-  - src/main/character-dictionary-runtime.test.ts
-priority: high
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-Index AniList character alternative names in generated character dictionaries so aliases like Shadow resolve during subtitle lookup instead of falling through to unrelated generic dictionary entries.
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-<!-- AC:BEGIN -->
-- [x] #1 Character fetch reads AniList alternative character names needed for lookup coverage
-- [x] #2 Generated term banks include alias-derived terms for subtitle lookups like シャドウ
-- [x] #3 Regression coverage proves alternative-name indexing works end to end
-<!-- AC:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-Character dictionary generation now requests AniList `name.alternative`, indexes those aliases as term candidates, and expands mixed aliases like `Minoru Kagenou (影野ミノル)` into usable outer/inner variants. Also extended kana alias synthesis so the AniList alias `Shadow` emits `シャドウ`, which matches the subtitle token the user hit in The Eminence in Shadow.
-
-Bumped the character-dictionary snapshot format to invalidate stale cached snapshots, and updated merged-dictionary rebuilds to refresh invalid snapshots before composing the ZIP so old cache files do not hard-fail the merge path.
-
-Verified with `bun test src/main/character-dictionary-runtime.test.ts` and `bun run tsc --noEmit`.
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-102 - Quiet-default-AppImage-startup-and-implicit-background-launch.md

@@ -1,65 +0,0 @@
----
-id: TASK-102
-title: Quiet default AppImage startup and implicit background launch
-status: Done
-assignee:
-  - codex
-created_date: '2026-03-06 21:20'
-updated_date: '2026-03-06 21:33'
-labels: []
-dependencies: []
-references:
-  - /home/sudacode/projects/japanese/SubMiner/src/main-entry-runtime.ts
-  - /home/sudacode/projects/japanese/SubMiner/src/core/services/cli-command.ts
-  - /home/sudacode/projects/japanese/SubMiner/src/main.ts
-priority: medium
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-Make the packaged Linux no-arg launch path behave like a quiet background start instead of surfacing startup-only noise.
-
-Scope:
-
-- Treat default background entry launches as implicit `--start --background`.
-- Keep the `--password-store` diagnostic out of normal startup output.
-- Suppress known startup-only `node:sqlite` and `lsfg-vk` warnings for the entry/background launch path.
-- Avoid noisy protocol-registration warnings during normal startup when registration is unsupported.
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-
-<!-- AC:BEGIN -->
-- [x] #1 Initial background launch reaches the start path without logging `No running instance. Use --start to launch the app.`
-- [x] #2 Default startup no longer emits the `Applied --password-store gnome-libsecret` line at normal log levels.
-- [x] #3 Entry/background launch sanitization suppresses the observed `ExperimentalWarning: SQLite...` and `lsfg-vk ... unsupported configuration version` startup noise.
-- [x] #4 Regression coverage documents the new startup behavior.
-<!-- AC:END -->
-
-## Implementation Notes
-
-<!-- SECTION:NOTES:BEGIN -->
-Normalized no-arg/password-store-only entry launches to append implicit `--start --background`, and upgraded `--background`-only entry launches to include `--start`.
-
-Applied shared entry env sanitization before loading the main process so default startup strips the `lsfg-vk` Vulkan layer and sets `NODE_NO_WARNINGS=1`; background children keep the same sanitized env.
-
-Downgraded startup-only protocol-registration failure logging to debug, and routed the Linux password-store diagnostic through the scoped debug logger instead of raw console output.
-
-Verification:
-
-- `bun test src/main-entry-runtime.test.ts src/main/runtime/anilist-setup-protocol.test.ts src/main/runtime/anilist-setup-protocol-main-deps.test.ts`
-- `bun run test:fast`
-
-Note: the final `node --experimental-sqlite --test dist/main/runtime/registry.test.js` step in `bun run test:fast` still prints Node's own experimental SQLite warning because that test command explicitly enables the feature flag outside the app entrypoint.
-<!-- SECTION:NOTES:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-Default packaged startup is now quiet and behaves like an implicit `--start --background` launch.
-
-- No-arg AppImage entry launches now append `--start --background`, and `--background`-only launches append the missing `--start`.
-- Entry/background startup sanitization now suppresses the observed `lsfg-vk` and `node:sqlite` warnings on the app launch path.
-- Linux password-store and unsupported protocol-registration diagnostics now stay at debug level instead of normal startup output.
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-103 - Add-dedicated-annotation-websocket-for-texthooker.md

@@ -1,38 +0,0 @@
----
-id: TASK-103
-title: Add dedicated annotation websocket for texthooker
-status: Done
-assignee:
-  - codex
-created_date: '2026-03-07 02:20'
-updated_date: '2026-03-07 02:20'
-labels:
-  - texthooker
-  - websocket
-  - subtitle
-dependencies: []
-priority: medium
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-Add a separate annotated subtitle websocket for bundled texthooker so token/JLPT/frequency markup is available on a stable dedicated port even when the regular websocket is in `auto` mode and skipped because `mpv_websocket` is installed.
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-
-<!-- AC:BEGIN -->
-- [x] #1 Regular `websocket.enabled: "auto"` behavior remains unchanged and still skips the regular websocket when `mpv_websocket` is installed.
-- [x] #2 A separate `annotationWebsocket` config controls an independent annotated websocket with default port `6678`.
-- [x] #3 Bundled texthooker is pointed at the annotation websocket when it is enabled.
-- [x] #4 Focused regression tests cover config parsing, startup wiring, and texthooker bootstrap injection.
-<!-- AC:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-Added `annotationWebsocket.enabled`/`annotationWebsocket.port` with defaults of `true`/`6678`, started that websocket independently from the regular auto-managed websocket, and injected the bundled texthooker websocket URL so it connects to the annotation feed by default.
-
-Also added focused regression coverage and regenerated the checked-in config examples.
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-104 - Mirror-overlay-annotation-hover-behavior-in-vendored-texthooker.md

@@ -1,43 +0,0 @@
----
-id: TASK-104
-title: Mirror overlay annotation hover behavior in vendored texthooker
-status: Done
-assignee:
-  - codex
-created_date: '2026-03-06 21:45'
-updated_date: '2026-03-06 21:45'
-labels:
-  - texthooker
-  - subtitle
-  - websocket
-dependencies:
-  - TASK-103
-references:
-  - /home/sudacode/projects/japanese/SubMiner/src/core/services/subtitle-ws.ts
-  - /home/sudacode/projects/japanese/SubMiner/vendor/texthooker-ui/src/components/App.svelte
-  - /home/sudacode/projects/japanese/SubMiner/vendor/texthooker-ui/src/line-markup.ts
-  - /home/sudacode/projects/japanese/SubMiner/vendor/texthooker-ui/src/app.css
-priority: medium
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-Bring bundled texthooker annotation rendering closer to the visible overlay. Keep the lightweight texthooker UX, but preserve token metadata for hover, match overlay color-precedence rules across known/N+1/name/frequency/JLPT, expose name-match highlighting as a toggle, and emit a structured annotation payload on the dedicated websocket so non-SubMiner clients can treat it as an API.
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-
-<!-- AC:BEGIN -->
-- [x] #1 Annotation websocket payload includes both rendered `sentence` HTML and structured token metadata for generic clients.
-- [x] #2 Vendored texthooker preserves annotation metadata attrs needed for hover labels and uses overlay-matching color precedence rules.
-- [x] #3 Vendored texthooker supports character-name highlighting with a user-facing toggle and standalone-web note.
-- [x] #4 Hovering annotated texthooker tokens reveals JLPT/frequency metadata without adding the full overlay popup workflow.
-- [x] #5 Focused serializer, texthooker markup, socket parsing, CSS, and build verification pass.
-<!-- AC:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-Extended the dedicated annotation websocket payload to ship `version`, plain `text`, rendered `sentence`, and structured `tokens` metadata while keeping backward-compatible `sentence` consumers working. Updated the vendored texthooker to preserve hover metadata attrs, follow overlay color precedence for known/N+1/name/frequency/JLPT annotations, add a character-name highlight toggle plus standalone-web dictionary note, and render lightweight hover labels for frequency/JLPT metadata. Added focused regression coverage and rebuilt both the vendored texthooker bundle and SubMiner.
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-105 - Stop-local-docs-artifact-writes-after-docs-repo-split.md

@@ -1,47 +0,0 @@
----
-id: TASK-105
-title: Stop local docs artifact writes after docs repo split
-status: Done
-assignee: []
-created_date: '2026-03-07 00:00'
-updated_date: '2026-03-07 00:20'
-labels: []
-dependencies: []
-priority: medium
-ordinal: 10500
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-
-Now that user-facing docs live in `../subminer-docs`, first-party scripts in this repo should not keep writing generated artifacts into the local `docs/` tree.
-
-Scope:
-
-- Audit first-party scripts/automation for writes to `docs/`.
-- Keep repo-local outputs only where they are still intentionally owned by this repo.
-- Repoint generated docs artifacts to `../subminer-docs` when that is the maintained source of truth.
-- Add regression coverage for the config-example generation path contract.
-
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-
-<!-- AC:BEGIN -->
-
-- [x] #1 The config-example generator no longer writes to `docs/public/config.example.jsonc` inside this repo.
-- [x] #2 When `../subminer-docs` exists, the generator updates `../subminer-docs/public/config.example.jsonc`.
-- [x] #3 Automated coverage guards the output-path contract so local docs writes do not regress.
-
-<!-- AC:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-
-Removed the first-party local `docs/public` config-example write path from `src/generate-config-example.ts` and replaced it with sibling-docs-repo detection that targets `../subminer-docs/public/config.example.jsonc` only when that repo exists.
-
-Added a project-local regression suite for output-path resolution and artifact writing, wired that suite into the maintained config test lane, and removed the stale generated `docs/public/config.example.jsonc` artifact from the working tree.
-
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-106 - Add-first-run-setup-gate-and-auto-install-flow.md

@@ -1,69 +0,0 @@
----
-id: TASK-106
-title: Add first-run setup gate and auto-install flow
-status: Done
-assignee:
-  - codex
-created_date: '2026-03-07 06:10'
-updated_date: '2026-03-07 06:20'
-labels: []
-dependencies: []
-references:
-  - /home/sudacode/projects/japanese/SubMiner/src/main.ts
-  - /home/sudacode/projects/japanese/SubMiner/src/shared/setup-state.ts
-  - /home/sudacode/projects/japanese/SubMiner/src/main/runtime/first-run-setup-service.ts
-  - /home/sudacode/projects/japanese/SubMiner/src/main/runtime/first-run-setup-window.ts
-  - /home/sudacode/projects/japanese/SubMiner/launcher/commands/playback-command.ts
-priority: high
-ordinal: 10600
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-Replace the current manual install flow with a first-run setup gate:
-
-- bootstrap the default config dir/config file automatically
-- detect legacy installs and mark them complete when config + Yomitan dictionaries are already present
-- open a compact Catppuccin Macchiato setup popup for incomplete installs
-- optionally install the mpv plugin into the default mpv location
-- block launcher playback until setup completes, then resume the original playback flow
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-
-<!-- AC:BEGIN -->
-- [x] #1 First app launch seeds the default config dir/config file without manual copy steps.
-- [x] #2 Existing installs with config plus at least one Yomitan dictionary are auto-detected as already complete.
-- [x] #3 Incomplete installs get a first-run setup popup with mpv plugin install, Yomitan settings, refresh, skip, and finish actions.
-- [x] #4 Launcher playback waits for setup completion and does not start mpv while setup is incomplete.
-- [x] #5 Plugin assets are packaged into the Electron bundle and regression tests cover the new flow.
-<!-- AC:END -->
-
-## Implementation Notes
-
-<!-- SECTION:NOTES:BEGIN -->
-Added shared setup-state/config/mpv path helpers so Electron and launcher read the same onboarding state file.
-
-Introduced a first-run setup service plus compact BrowserWindow popup using Catppuccin Macchiato styling. The popup supports optional mpv plugin install, opening Yomitan settings, status refresh, skip-plugin, and gated finish once at least one Yomitan dictionary is installed.
-
-Electron startup now bootstraps a default config file, auto-detects legacy-complete installs, adds `--setup` CLI support, exposes a tray `Complete Setup` action while incomplete, and avoids reopening setup once completion is recorded.
-
-Launcher playback now checks the shared setup-state file before starting mpv. If setup is incomplete, it launches the app with `--background --setup`, waits for completion, and only then proceeds.
-
-Verification:
-
-- `bun run typecheck`
-- `bun run test:fast`
-<!-- SECTION:NOTES:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-SubMiner now supports a download-and-launch install flow.
-
-- First launch auto-creates config and opens setup only when needed.
-- Existing users with working installs are silently migrated to completed setup.
-- The setup popup handles optional mpv plugin install and Yomitan dictionary readiness.
-- Launcher playback is gated on setup completion and resumes automatically afterward.
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-107 - Fix-Yomitan-scan-token-fallback-fragmentation.md

@@ -1,42 +0,0 @@
----
-id: TASK-107
-title: 'Fix Yomitan scan-token fallback fragmentation on exact-source misses'
-status: Done
-assignee: []
-created_date: '2026-03-07 01:10'
-updated_date: '2026-03-07 01:12'
-labels: []
-dependencies: []
-priority: high
-ordinal: 9007
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-
-Left-to-right Yomitan scanning can emit bogus fallback tokens when `termsFind` returns entries but none of their headwords carries an exact primary source for the consumed substring. Repro: `だが それでも届かぬ高みがあった` currently yields trailing fragments like `があ` / `た`, which blocks the real `あった` token from receiving frequency highlighting.
-
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-
-<!-- AC:BEGIN -->
-
-- [x] #1 Scanner skips `termsFind` fallback entries that are not backed by an exact primary source for the consumed substring.
-- [x] #2 Repro line no longer yields bogus trailing fragments such as `があ`.
-- [x] #3 Regression coverage added for the scan-token path.
-
-<!-- AC:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-
-Removed the scan-token helper fallback that previously emitted a token from the first returned headword even when Yomitan did not report an exact primary source for the consumed substring. Added a focused regression test covering `だが それでも届かぬ高みがあった`, ensuring bogus `があ` fragmentation is skipped so the later `あった` exact match can still be tokenized and highlighted.
-
-Verification:
-
-- `bun test src/core/services/tokenizer/yomitan-parser-runtime.test.ts src/core/services/tokenizer.test.ts --timeout 20000`
-
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-108 - Exclude-single-kana-tokens-from-frequency-highlighting.md

@@ -1,43 +0,0 @@
----
-id: TASK-108
-title: 'Exclude single kana tokens from frequency highlighting'
-status: Done
-assignee: []
-created_date: '2026-03-07 01:18'
-updated_date: '2026-03-07 01:22'
-labels: []
-dependencies: []
-priority: medium
-ordinal: 9008
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-
-Suppress frequency highlighting for single-character hiragana or katakana tokens. Scope is frequency-only: known/N+1/JLPT behavior stays unchanged.
-
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-
-<!-- AC:BEGIN -->
-
-- [x] #1 Single-character hiragana tokens do not retain `frequencyRank`.
-- [x] #2 Single-character katakana tokens do not retain `frequencyRank`.
-- [x] #3 Regression coverage exists at annotation-stage and tokenizer levels.
-
-<!-- AC:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-
-Added a frequency-only suppression rule for single-character kana tokens based on token `surface`, so bogus merged fragments like `た` and standalone one-character kana no longer keep `frequencyRank`. Regression coverage now exists both in the annotation stage and in the tokenizer path, while multi-character tokens and N+1/JLPT behavior remain unchanged.
-
-Verification:
-
-- `bun test src/core/services/tokenizer/annotation-stage.test.ts --timeout 20000`
-- `bun test src/core/services/tokenizer.test.ts --timeout 20000`
-
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-110 - Replace-vendored-Yomitan-with-submodule-built-chrome-artifact-workflow.md

@@ -1,51 +0,0 @@
----
-id: TASK-110
-title: Replace vendored Yomitan with submodule-built Chrome artifact workflow
-status: Done
-assignee: []
-created_date: '2026-03-07 11:05'
-updated_date: '2026-03-07 11:22'
-labels:
-  - yomitan
-  - build
-  - release
-dependencies: []
-priority: high
-ordinal: 9010
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-
-Replace the checked-in `vendor/yomitan` release tree with a `subminer-yomitan` git submodule. Build Yomitan from source, extract the Chromium zip artifact into a stable local build directory, and make SubMiner dev/runtime/tests/release packaging load that extracted extension instead of the source tree or vendored files.
-
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-
-<!-- AC:BEGIN -->
-
-- [x] #1 Repo tracks Yomitan as a git submodule instead of committed extension files under `vendor/yomitan`.
-- [x] #2 SubMiner has a reproducible build/extract step that produces a local Chromium extension directory from `subminer-yomitan`.
-- [x] #3 Dev/runtime/tests resolve the extracted build output as the default Yomitan extension path.
-- [x] #4 Release packaging includes the extracted Chromium extension files instead of the old vendored tree.
-- [x] #5 Docs and verification commands reflect the new workflow.
-
-<!-- AC:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-
-Replaced the checked-in `vendor/yomitan` extension tree with a `vendor/subminer-yomitan` git submodule and added a reproducible `bun run build:yomitan` workflow that builds `yomitan-chrome.zip`, extracts it into `build/yomitan`, and reuses a source-state stamp to skip redundant rebuilds. Runtime path resolution, helper CLIs, Yomitan integration tests, packaging, CI cache keys, and README source-build notes now all target that generated artifact instead of the old vendored files.
-
-Verification:
-
-- `bun run build:yomitan`
-- `bun test src/core/services/yomitan-extension-paths.test.ts src/core/services/yomitan-structured-content-generator.test.ts src/yomitan-translator-sort.test.ts`
-- `bun run typecheck`
-- `bun run build`
-- `bun run test:core:src`
-
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-111 - Fix-subtitle-cycle-OSD-labels-for-J-keybindings.md

@@ -1,71 +0,0 @@
----
-id: TASK-111
-title: Fix subtitle-cycle OSD labels for J keybindings
-status: Done
-assignee:
-  - Codex
-created_date: '2026-03-07 23:45'
-updated_date: '2026-03-08 00:06'
-labels: []
-dependencies: []
-references:
-  - /Users/sudacode/projects/japanese/SubMiner/src/core/services/ipc-command.ts
-  - /Users/sudacode/projects/japanese/SubMiner/src/core/services/mpv.ts
-  - >-
-    /Users/sudacode/projects/japanese/SubMiner/src/core/services/ipc-command.test.ts
-  - >-
-    /Users/sudacode/projects/japanese/SubMiner/src/core/services/mpv-control.test.ts
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-When cycling subtitle tracks with the default J/Shift+J keybindings, the mpv OSD currently shows raw template text like `${sid}` instead of a resolved subtitle label. Update the keybinding OSD behavior so users see the active subtitle selection clearly when cycling tracks, and ensure placeholder-based OSD messages sent through the mpv client API render correctly.
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-<!-- AC:BEGIN -->
-- [x] #1 Pressing the primary subtitle cycle keybinding shows a resolved subtitle label on the OSD instead of a raw `${sid}` placeholder.
-- [x] #2 Pressing the secondary subtitle cycle keybinding shows a resolved subtitle label on the OSD instead of a raw `${secondary-sid}` placeholder.
-- [x] #3 Proxy OSD messages that rely on mpv property expansion render resolved values when sent through the mpv client API.
-- [x] #4 Regression tests cover the subtitle-cycle OSD behavior and the placeholder-expansion OSD path.
-<!-- AC:END -->
-
-## Implementation Plan
-
-<!-- SECTION:PLAN:BEGIN -->
-1. Add focused failing tests for subtitle-cycle OSD labels and mpv placeholder-expansion behavior.
-2. Update the IPC mpv command handler to resolve primary and secondary subtitle track labels from mpv `track-list` data after cycling subtitle tracks.
-3. Update the mpv OSD runtime path so placeholder-based `show-text` messages sent through the client API opt into property expansion.
-4. Run focused tests, then the relevant core test lane, and record results in the task notes.
-<!-- SECTION:PLAN:END -->
-
-## Implementation Notes
-
-<!-- SECTION:NOTES:BEGIN -->
-Initial triage: `ipc-command.ts` emits raw `${sid}`/`${secondary-sid}` placeholder strings, and `showMpvOsdRuntime` sends `show-text` via mpv client API without enabling property expansion.
-
-User approved implementation plan on 2026-03-07.
-
-Implementation: proxy mpv command OSD now supports an async resolver so subtitle track cycling can show human-readable labels instead of raw `${sid}` placeholders.
-
-Implementation: `showMpvOsdRuntime` now prefixes placeholder-based messages with mpv client-api `expand-properties`, which fixes raw `${...}` OSD output for subtitle delay/position messages.
-
-Testing: `bun test src/core/services/ipc-command.test.ts src/core/services/mpv-control.test.ts src/main/runtime/mpv-proxy-osd.test.ts src/main/runtime/ipc-mpv-command-main-deps.test.ts src/main/runtime/ipc-bridge-actions.test.ts src/main/runtime/ipc-bridge-actions-main-deps.test.ts src/main/runtime/composers/ipc-runtime-composer.test.ts` passed.
-
-Testing: `bun x tsc --noEmit` passed.
-
-Testing: `bun run test:core:src` passed (423 pass, 6 skip, 0 fail).
-
-Docs: no update required because no checked-in docs or help text describe the J/Shift+J OSD output behavior.
-<!-- SECTION:NOTES:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-Fixed subtitle-cycle OSD handling for the default J/Shift+J keybindings. The IPC mpv command path now supports resolving proxy OSD text asynchronously, and the main-runtime resolver reads mpv `track-list` state so primary and secondary subtitle cycling show human-readable track labels instead of raw `${sid}` / `${secondary-sid}` placeholders.
-
-Also fixed the lower-level mpv OSD transport so placeholder-based `show-text` messages sent through the client API opt into `expand-properties`. That preserves existing template-based OSD messages like subtitle delay and subtitle position without leaking the raw `${...}` syntax.
-
-Added regression coverage for the async proxy OSD path, the placeholder-expansion `showMpvOsdRuntime` path, and the runtime subtitle-track label resolver. Verification run: `bun x tsc --noEmit`; focused mpv/IPC tests; and the maintained `bun run test:core:src` lane (423 pass, 6 skip, 0 fail).
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-112 - Address-Claude-review-items-on-PR-15.md

@@ -1,61 +0,0 @@
----
-id: TASK-112
-title: Address Claude review items on PR 15
-status: Done
-assignee:
-  - codex
-created_date: '2026-03-08 00:11'
-updated_date: '2026-03-08 00:12'
-labels:
-  - pr-review
-  - ci
-dependencies: []
-references:
-  - .github/workflows/release.yml
-  - .github/workflows/ci.yml
-  - .gitmodules
-  - >-
-    backlog/tasks/task-101 -
-    Index-AniList-character-alternative-names-in-the-character-dictionary.md
-priority: medium
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-Review Claude's PR feedback on PR #15, implement only the technically valid fixes on the current branch, and document which comments are non-actionable or already acceptable.
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-<!-- AC:BEGIN -->
-- [x] #1 Validated Claude's concrete PR review items against current branch state and repo conventions
-- [x] #2 Implemented the accepted fixes with regression coverage or verification where applicable
-- [x] #3 Documented which review items are non-blocking or intentionally left unchanged
-<!-- AC:END -->
-
-## Implementation Plan
-
-<!-- SECTION:PLAN:BEGIN -->
-1. Validate each Claude review item against current branch files and repo workflow.
-2. Patch release quality-gate to match CI ordering and add explicit typecheck.
-3. Remove duplicate .gitmodules stanza and normalize the TASK-101 reference path through Backlog MCP.
-4. Run relevant verification for workflow/config metadata changes and record which review items remain non-actionable.
-<!-- SECTION:PLAN:END -->
-
-## Implementation Notes
-
-<!-- SECTION:NOTES:BEGIN -->
-User asked to address Claude PR comments on PR #15 and assess whether any action items remain. Treat review suggestions skeptically; only fix validated defects.
-
-Validated Claude's five review items. Fixed release workflow ordering/typecheck, removed the duplicate .gitmodules entry, and normalized TASK-101 references to repo-relative paths via Backlog MCP.
-
-Left the vendor/subminer-yomitan branch-pin suggestion unchanged. The committed submodule SHA already controls reproducibility; adding a branch would only affect update ergonomics and was not required to address a concrete defect.
-<!-- SECTION:NOTES:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-Validated Claude's PR #15 review summary against the current branch and applied the actionable fixes. In `.github/workflows/release.yml`, the release `quality-gate` job now restores the dependency cache before installation, no longer installs twice, and runs `bun run typecheck` before the fast test suite to match CI expectations. In `.gitmodules`, removed the duplicate `vendor/yomitan-jlpt-vocab` stanza with the conflicting duplicate path. Through Backlog MCP, updated `TASK-101` references from an absolute local path to repo-relative paths so the task metadata is portable across contributors.
-
-Verification: `git diff --check`, `git config -f .gitmodules --get-regexp '^submodule\..*\.path$'`, `bun run typecheck`, and `bun run test:fast` all passed. `bun run format:check` still fails on many pre-existing unrelated files already present on the branch, including multiple backlog task files and existing source/docs files; this review patch did not attempt a repo-wide formatting sweep.
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-113 - Scope-make-pretty-to-maintained-source-files.md

@@ -1,59 +0,0 @@
----
-id: TASK-113
-title: Scope make pretty to maintained source files
-status: Done
-assignee:
-  - codex
-created_date: '2026-03-08 00:20'
-updated_date: '2026-03-08 00:22'
-labels:
-  - tooling
-  - formatting
-dependencies: []
-references:
-  - Makefile
-  - package.json
-priority: medium
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-Change the `make pretty` workflow so it formats only the maintained source/config files we intentionally keep under Prettier, instead of sweeping backlog/docs/generated content across the whole repository.
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-<!-- AC:BEGIN -->
-- [x] #1 `make pretty` formats only the approved maintained source/config paths
-- [x] #2 The allowlist is reusable for check/write flows instead of duplicating path logic
-- [x] #3 Verification shows the scoped formatting command targets the intended files without touching backlog or vendored content
-<!-- AC:END -->
-
-## Implementation Plan
-
-<!-- SECTION:PLAN:BEGIN -->
-1. Inspect current Prettier config/ignore behavior and keep the broad repo-wide format command unchanged.
-2. Add a reusable scoped Prettier script that targets maintained source/config paths only.
-3. Update `make pretty` to call the scoped script.
-4. Verify the scoped command resolves only intended files and does not traverse backlog or vendor paths.
-<!-- SECTION:PLAN:END -->
-
-## Implementation Notes
-
-<!-- SECTION:NOTES:BEGIN -->
-User approved the allowlist approach: keep repo-wide `format` intact, make `make pretty` use a maintained-path formatter scope.
-
-Added `scripts/prettier-scope.sh` as the single allowlist for scoped Prettier paths and wired `format:src` / `format:check:src` to it.
-
-Updated `make pretty` to call `bun run format:src`. Verified with `make -n pretty` and shell tracing that the helper only targets the maintained allowlist and does not traverse `backlog/` or `vendor/`.
-
-Excluded `Makefile` and `.prettierignore` from the allowlist after verification showed Prettier cannot infer parsers for them.
-<!-- SECTION:NOTES:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-Scoped the repo's day-to-day formatting entrypoint without changing the existing broad repo-wide Prettier scripts. Added `scripts/prettier-scope.sh` as the shared allowlist for maintained source/config paths (`.github`, `build`, `launcher`, `scripts`, `src`, plus selected root JSON config files), added `format:src` and `format:check:src` in `package.json`, and updated `make pretty` to run the scoped formatter.
-
-Verification: `make -n pretty` now resolves to `bun run format:src`. `bash -n scripts/prettier-scope.sh` passed, and shell-traced `bash -x scripts/prettier-scope.sh --check` confirmed the exact allowlist passed to Prettier. `bun run format:check:src` fails only because existing files inside the allowed source scope are not currently formatted; it no longer touches `backlog/` or `vendor/`.
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-114 - Fix-failing-CI-checks-on-PR-15.md

@@ -1,62 +0,0 @@
----
-id: TASK-114
-title: Fix failing CI checks on PR 15
-status: Done
-assignee:
-  - codex
-created_date: '2026-03-08 00:34'
-updated_date: '2026-03-08 00:37'
-labels:
-  - ci
-  - test
-dependencies: []
-references:
-  - src/renderer/subtitle-render.test.ts
-  - src/renderer/style.css
-  - .github/workflows/ci.yml
-priority: high
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-Investigate the failing GitHub Actions CI run for PR #15 on branch `yomitan-fork`, fix the underlying test or code regression, and verify the affected local test/CI lane passes.
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-<!-- AC:BEGIN -->
-- [x] #1 Identified the concrete failing CI job and captured the relevant failure context
-- [x] #2 Implemented the minimal code or test change needed to resolve the CI failure
-- [x] #3 Verified the affected local test target and the broader fast CI test lane pass
-<!-- AC:END -->
-
-## Implementation Plan
-
-<!-- SECTION:PLAN:BEGIN -->
-1. Inspect the failing GitHub Actions run and confirm the exact failing test/assertion.
-2. Reproduce the failing renderer stylesheet test locally and compare the assertion against current CSS.
-3. Apply the minimal test or stylesheet fix needed to restore the intended hover/selection behavior.
-4. Re-run the targeted renderer test, then re-run `bun run test` to verify the fast CI lane is green.
-<!-- SECTION:PLAN:END -->
-
-## Implementation Notes
-
-<!-- SECTION:NOTES:BEGIN -->
-GitHub Actions run 22810400921 failed in job build-test-audit, step `Test suite (source)`, with a single failing test: `JLPT CSS rules use underline-only styling in renderer stylesheet` in src/renderer/subtitle-render.test.ts.
-
-Reproduced the failing test locally with `bun test src/renderer/subtitle-render.test.ts`. The failure was a brittle stylesheet assertion, not a renderer behavior regression.
-
-Updated the renderer stylesheet test helper to split selectors safely across `:is(...)` commas and normalize multiline selector whitespace, then switched the failing hover/JLPT assertions to inspect extracted rule blocks instead of matching the entire CSS file text.
-
-Verification passed with `bun test src/renderer/subtitle-render.test.ts` and `bun run test`.
-<!-- SECTION:NOTES:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-Investigated GitHub Actions CI run `22810400921` for PR #15 and confirmed the only failing job was `build-test-audit`, step `Test suite (source)`, with a single failure in `src/renderer/subtitle-render.test.ts` (`JLPT CSS rules use underline-only styling in renderer stylesheet`).
-
-The renderer CSS itself was still correct; the regression was in the test helper. `extractClassBlock` was splitting selector lists on every comma, which breaks selectors containing `:is(...)`, and the affected assertions fell back to brittle whole-file regex matching against a multiline selector. Fixed the test by teaching the helper to split selectors only at top-level commas, normalizing selector whitespace around multiline `:not(...)` / `:is(...)` clauses, and asserting on extracted rule blocks for the plain-word hover and JLPT-only hover/selection rules.
-
-Verification: `bun test src/renderer/subtitle-render.test.ts` passed, and `bun run test` passed end to end (the same fast lane that failed in CI).
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-115 - Refresh-subminer-docs-contributor-docs-for-current-repo-workflow.md

@@ -1,59 +0,0 @@
----
-id: TASK-115
-title: Refresh subminer-docs contributor docs for current repo workflow
-status: Done
-assignee:
-  - codex
-created_date: '2026-03-08 00:40'
-updated_date: '2026-03-08 00:42'
-labels:
-  - docs
-dependencies: []
-references:
-  - ../subminer-docs/development.md
-  - ../subminer-docs/README.md
-  - Makefile
-  - package.json
-priority: medium
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-Update the sibling `subminer-docs` repo so contributor/development docs match the current SubMiner repo workflow after the docs split and recent tooling changes, including removing stale in-repo docs build steps and documenting the scoped formatting command.
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-<!-- AC:BEGIN -->
-- [x] #1 Contributor docs in `subminer-docs` no longer reference stale in-repo docs build commands for the app repo
-- [x] #2 Contributor docs mention the current scoped formatting workflow (`make pretty` / `format:src`) where relevant
-- [x] #3 Removed stale or no-longer-needed instructions that no longer match the current repo layout
-<!-- AC:END -->
-
-## Implementation Plan
-
-<!-- SECTION:PLAN:BEGIN -->
-1. Inspect `subminer-docs` for contributor/development instructions that drifted after the docs repo split and recent tooling changes.
-2. Update contributor docs to remove stale app-repo docs commands and document the current scoped formatting workflow.
-3. Verify the modified docs page and build the docs site from the sibling docs repo when local dependencies are available.
-<!-- SECTION:PLAN:END -->
-
-## Implementation Notes
-
-<!-- SECTION:NOTES:BEGIN -->
-Detected concrete doc drift in `subminer-docs/development.md`: stale in-repo docs build commands and no mention of the scoped `make pretty` formatter.
-
-Updated `../subminer-docs/development.md` to remove stale app-repo docs build steps from the local gate, document `make pretty` / `format:check:src`, and point docs-site work to the sibling docs repo explicitly.
-
-Installed docs repo dependencies locally with `bun install` and verified the docs site with `bun run docs:build` in `../subminer-docs`.
-
-Did not change `../subminer-docs/README.md`; it was already accurate for the docs repo itself.
-<!-- SECTION:NOTES:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-Refreshed the contributor/development docs in the sibling `subminer-docs` repo to match the current SubMiner workflow. In `development.md`, removed the stale app-repo `bun run docs:build` step from the local CI-equivalent gate, added an explicit note to run docs builds from `../subminer-docs` when docs change, documented the scoped formatting workflow (`make pretty` and `bun run format:check:src`), and replaced the old in-repo `make docs*` instructions with the correct sibling-repo `bun run docs:*` commands. Also updated the Makefile reference to include `make pretty` and removed the obsolete `make docs-dev` entry.
-
-Verification: installed docs repo dependencies with `bun install` in `../subminer-docs` and ran `bun run docs:build` successfully. Left `README.md` unchanged because it was already accurate for the standalone docs repo.
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-116 - Audit-branch-commits-for-remaining-subminer-docs-updates.md

@@ -1,53 +0,0 @@
----
-id: TASK-116
-title: Audit branch commits for remaining subminer-docs updates
-status: Done
-assignee:
-  - codex
-created_date: '2026-03-08 00:46'
-updated_date: '2026-03-08 00:48'
-labels:
-  - docs
-dependencies: []
-references:
-  - ../subminer-docs/installation.md
-  - ../subminer-docs/troubleshooting.md
-  - src/core/services/yomitan-extension-paths.ts
-  - scripts/build-yomitan.mjs
-priority: medium
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-Review recent `yomitan-fork` commits against the sibling `subminer-docs` repo, identify any concrete documentation drift that remains after the earlier contributor-doc updates, and patch the docs for behavior/tooling changes that are now outdated or misleading.
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-<!-- AC:BEGIN -->
-- [x] #1 Reviewed recent branch commits for user-facing or contributor-facing changes that may require docs updates
-- [x] #2 Updated `subminer-docs` pages where branch changes introduced concrete doc drift
-- [x] #3 Verified the docs site still builds after the updates
-<!-- AC:END -->
-
-## Implementation Plan
-
-<!-- SECTION:PLAN:BEGIN -->
-1. Review branch commit themes against `subminer-docs` and identify only concrete drift introduced by recent workflow/runtime changes.
-2. Patch docs for the Yomitan submodule build workflow, updated source-build prerequisites, and current runtime Yomitan search paths/manual fallback path.
-3. Rebuild the docs site to verify the updated pages render cleanly.
-<!-- SECTION:PLAN:END -->
-
-## Implementation Notes
-
-<!-- SECTION:NOTES:BEGIN -->
-Concrete remaining drift after commit audit: installation/development docs still understate the Node/npm + submodule requirements for the Yomitan build flow, and troubleshooting still points at obsolete `vendor/yomitan` / `extensions/yomitan` paths.
-
-Audited branch commits against subminer-docs coverage. Existing docs already cover first-run setup, texthooker startup/annotated websocket config, AniList merged character dictionaries, configurable collapsible sections, and subtitle name highlighting. Patched remaining drift around source-build prerequisites and Yomitan build/install paths in installation.md, development.md, and troubleshooting.md. Verified with `bun run docs:build` in ../subminer-docs.
-<!-- SECTION:NOTES:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-Audited branch commits for missing documentation updates in ../subminer-docs. Updated installation, development, and troubleshooting docs to match the current Yomitan submodule build flow, source-build prerequisites, and runtime extension search/manual fallback paths. Confirmed other recent branch features were already documented and rebuilt the docs site successfully.
-<!-- SECTION:FINAL_SUMMARY:END -->

backlog/tasks/task-99 - Add-configurable-character-dictionary-collapsible-section-open-states.md

@@ -1,38 +0,0 @@
----
-id: TASK-99
-title: Add configurable character dictionary collapsible section open states
-status: Done
-assignee: []
-created_date: '2026-03-07 00:00'
-updated_date: '2026-03-07 00:00'
-labels:
-  - dictionary
-  - config
-references:
-  - /home/sudacode/projects/japanese/SubMiner/src/main/character-dictionary-runtime.ts
-  - /home/sudacode/projects/japanese/SubMiner/src/config/resolve/integrations.ts
-  - /home/sudacode/projects/japanese/SubMiner/src/config/definitions/defaults-integrations.ts
-priority: medium
-dependencies: []
----
-
-## Description
-
-<!-- SECTION:DESCRIPTION:BEGIN -->
-Add per-section config for character dictionary collapsible glossary sections so Description, Character Information, and Voiced by can each default open or closed independently. Default all sections closed.
-<!-- SECTION:DESCRIPTION:END -->
-
-## Acceptance Criteria
-<!-- AC:BEGIN -->
-- [x] #1 Config supports `anilist.characterDictionary.collapsibleSections.description`.
-- [x] #2 Config supports `anilist.characterDictionary.collapsibleSections.characterInformation`.
-- [x] #3 Config supports `anilist.characterDictionary.collapsibleSections.voicedBy`.
-- [x] #4 Default config keeps all generated character dictionary collapsible sections closed.
-- [x] #5 Regression coverage verifies config parsing/warnings and generated glossary `details.open` behavior.
-<!-- AC:END -->
-
-## Final Summary
-
-<!-- SECTION:FINAL_SUMMARY:BEGIN -->
-Added per-section open-state config under `anilist.characterDictionary.collapsibleSections` for `description`, `characterInformation`, and `voicedBy`, all defaulting to `false`. Wired the glossary generator to read those settings so generated `details.open` matches config, and added regression coverage for defaults, parsing/warnings, registry exposure, and runtime glossary output.
-<!-- SECTION:FINAL_SUMMARY:END -->

config.example.jsonc

@@ -5,7 +5,6 @@
  * Copy to $XDG_CONFIG_HOME/SubMiner/config.jsonc (or ~/.config/SubMiner/config.jsonc) and edit as needed.
  */
 {
-
   // ==========================================
   // Overlay Auto-Start
   // When overlay connects to mpv, automatically show overlay and hide mpv subtitles.
@@ -14,12 +13,11 @@
 
   // ==========================================
   // Texthooker Server
-  // Configure texthooker startup launch and browser opening behavior.
+  // Control whether browser opens automatically for texthooker.
   // ==========================================
   "texthooker": {
-    "launchAtStartup": true, // Launch texthooker server automatically when SubMiner starts. Values: true | false
-    "openBrowser": true // Open browser setting. Values: true | false
-  }, // Configure texthooker startup launch and browser opening behavior.
+    "openBrowser": true, // Open browser setting. Values: true | false
+  }, // Control whether browser opens automatically for texthooker.
 
   // ==========================================
   // WebSocket Server
@@ -28,41 +26,17 @@
   // ==========================================
   "websocket": {
     "enabled": "auto", // Built-in subtitle websocket server mode. Values: auto | true | false
-    "port": 6677 // Built-in subtitle websocket server port.
+    "port": 6677, // Built-in subtitle websocket server port.
   }, // Built-in WebSocket server broadcasts subtitle text to connected clients.
 
-  // ==========================================
-  // Annotation WebSocket
-  // Dedicated annotated subtitle websocket for bundled texthooker and token-aware clients.
-  // Independent from websocket.auto and defaults to port 6678.
-  // ==========================================
-  "annotationWebsocket": {
-    "enabled": true, // Annotated subtitle websocket server enabled state. Values: true | false
-    "port": 6678 // Annotated subtitle websocket server port.
-  }, // Dedicated annotated subtitle websocket for bundled texthooker and token-aware clients.
-
   // ==========================================
   // Logging
   // Controls logging verbosity.
   // Set to debug for full runtime diagnostics.
   // ==========================================
   "logging": {
-    "level": "info" // Minimum log level for runtime logging. Values: debug | info | warn | error
-  }, // Controls logging verbosity.
-
-  // ==========================================
-  // Startup Warmups
-  // Background warmup controls for MeCab, Yomitan, dictionaries, and Jellyfin session.
-  // Disable individual warmups to defer load until first real usage.
-  // lowPowerMode defers all warmups except Yomitan extension.
-  // ==========================================
-  "startupWarmups": {
-    "lowPowerMode": false, // Defer startup warmups except Yomitan extension. Values: true | false
-    "mecab": true, // Warm up MeCab tokenizer at startup. Values: true | false
-    "yomitanExtension": true, // Warm up Yomitan extension at startup. Values: true | false
-    "subtitleDictionaries": true, // Warm up subtitle dictionaries at startup. Values: true | false
-    "jellyfinRemoteSession": true // Warm up Jellyfin remote session at startup. Values: true | false
-  }, // Background warmup controls for MeCab, Yomitan, dictionaries, and Jellyfin session.
+    "level": "info", // Minimum log level for runtime logging. Values: debug | info | warn | error
+  }, // Controls logging verbosity. Keep this as an object; do not replace with a bare string.
 
   // ==========================================
   // Keyboard Shortcuts
@@ -82,7 +56,7 @@
     "toggleSecondarySub": "CommandOrControl+Shift+V", // Toggle secondary sub setting.
     "markAudioCard": "CommandOrControl+Shift+A", // Mark audio card setting.
     "openRuntimeOptions": "CommandOrControl+Shift+O", // Open runtime options setting.
-    "openJimaku": "Ctrl+Shift+J" // Open jimaku setting.
+    "openJimaku": "Ctrl+Shift+J", // Open jimaku setting.
   }, // Overlay keyboard shortcuts. Set a shortcut to null to disable.
 
   // ==========================================
@@ -102,7 +76,7 @@
   "secondarySub": {
     "secondarySubLanguages": [], // Secondary sub languages setting.
     "autoLoadSecondarySub": false, // Auto load secondary sub setting. Values: true | false
-    "defaultMode": "hover" // Default mode setting.
+    "defaultMode": "hover", // Default mode setting.
   }, // Dual subtitle track options.
 
   // ==========================================
@@ -114,7 +88,7 @@
     "alass_path": "", // Alass path setting.
     "ffsubsync_path": "", // Ffsubsync path setting.
     "ffmpeg_path": "", // Ffmpeg path setting.
-    "replace": true // Replace the active subtitle file when sync completes. Values: true | false
+    "replace": true, // Replace active subtitle file when synchronization succeeds.
   }, // Subsync engine and executable paths.
 
   // ==========================================
@@ -122,7 +96,7 @@
   // Initial vertical subtitle position from the bottom.
   // ==========================================
   "subtitlePosition": {
-    "yPercent": 10 // Y percent setting.
+    "yPercent": 10, // Y percent setting.
   }, // Initial vertical subtitle position from the bottom.
 
   // ==========================================
@@ -134,11 +108,8 @@
     "enableJlpt": false, // Enable JLPT vocabulary level underlines. When disabled, JLPT tagging lookup and underlines are skipped. Values: true | false
     "preserveLineBreaks": false, // Preserve line breaks in visible overlay subtitle rendering. When false, line breaks are flattened to spaces for a single-line flow. Values: true | false
     "autoPauseVideoOnHover": true, // Automatically pause mpv playback while hovering subtitle text, then resume on leave. Values: true | false
-    "autoPauseVideoOnYomitanPopup": false, // Automatically pause mpv playback while Yomitan popup is open, then resume when popup closes. Values: true | false
     "hoverTokenColor": "#f4dbd6", // Hex color used for hovered subtitle token highlight in mpv.
     "hoverTokenBackgroundColor": "rgba(54, 58, 79, 0.84)", // CSS color used for hovered subtitle token background highlight in mpv.
-    "nameMatchEnabled": true, // Enable subtitle token coloring for matches from the SubMiner character dictionary. Values: true | false
-    "nameMatchColor": "#f5bde6", // Hex color used when a subtitle token matches an entry from the SubMiner character dictionary.
     "fontFamily": "M PLUS 1 Medium, Source Han Sans JP, Noto Sans CJK JP", // Font family setting.
     "fontSize": 35, // Font size setting.
     "fontColor": "#cad3f5", // Font color setting.
@@ -159,22 +130,16 @@
       "N2": "#f5a97f", // N2 setting.
       "N3": "#f9e2af", // N3 setting.
       "N4": "#a6e3a1", // N4 setting.
-      "N5": "#8aadf4" // N5 setting.
+      "N5": "#8aadf4", // N5 setting.
     }, // Jlpt colors setting.
     "frequencyDictionary": {
       "enabled": false, // Enable frequency-dictionary-based highlighting based on token rank. Values: true | false
-      "sourcePath": "", // Optional absolute path to a frequency dictionary directory. If empty, built-in discovery search paths are used.
+      "sourcePath": "", // Optional absolute path to a frequency dictionary directory. If empty, SubMiner searches installed/default frequency-dictionary locations.
       "topX": 1000, // Only color tokens with frequency rank <= topX (default: 1000).
       "mode": "single", // single: use one color for all matching tokens. banded: use color ramp by frequency band. Values: single | banded
-      "matchMode": "headword", // headword: frequency lookup uses dictionary form. surface: lookup uses subtitle-visible token text. Values: headword | surface
+      "matchMode": "headword", // Frequency lookup text selection mode. Values: headword | surface
       "singleColor": "#f5a97f", // Color used when frequencyDictionary.mode is `single`.
-      "bandedColors": [
-        "#ed8796",
-        "#f5a97f",
-        "#f9e2af",
-        "#8bd5ca",
-        "#8aadf4"
-      ] // Five colors used for rank bands when mode is `banded` (from most common to least within topX).
+      "bandedColors": ["#ed8796", "#f5a97f", "#f9e2af", "#8bd5ca", "#8aadf4"], // Five colors used for rank bands when mode is `banded` (from most common to least within topX).
     }, // Frequency dictionary setting.
     "secondary": {
       "fontFamily": "Inter, Noto Sans, Helvetica Neue, sans-serif", // Font family setting.
@@ -189,8 +154,8 @@
       "backgroundColor": "transparent", // Background color setting.
       "backdropFilter": "blur(6px)", // Backdrop filter setting.
       "fontWeight": "normal", // Font weight setting.
-      "fontStyle": "normal" // Font style setting.
-    } // Secondary setting.
+      "fontStyle": "normal", // Font style setting.
+    }, // Secondary setting.
   }, // Primary and secondary subtitle styling.
 
   // ==========================================
@@ -204,20 +169,18 @@
     "url": "http://127.0.0.1:8765", // Url setting.
     "pollingRate": 3000, // Polling interval in milliseconds.
     "proxy": {
-      "enabled": true, // Enable local AnkiConnect-compatible proxy for push-based auto-enrichment. Values: true | false
+      "enabled": false, // Enable local AnkiConnect-compatible proxy for push-based auto-enrichment. Values: true | false
       "host": "127.0.0.1", // Bind host for local AnkiConnect proxy.
       "port": 8766, // Bind port for local AnkiConnect proxy.
-      "upstreamUrl": "http://127.0.0.1:8765" // Upstream AnkiConnect URL proxied by local AnkiConnect proxy.
+      "upstreamUrl": "http://127.0.0.1:8765", // Upstream AnkiConnect URL proxied by local AnkiConnect proxy.
     }, // Proxy setting.
-    "tags": [
-      "SubMiner"
-    ], // Tags to add to cards mined or updated by SubMiner. Provide an empty array to disable automatic tagging.
+    "tags": ["SubMiner"], // Tags to add to cards mined or updated by SubMiner. Provide an empty array to disable automatic tagging.
     "fields": {
       "audio": "ExpressionAudio", // Audio setting.
       "image": "Picture", // Image setting.
       "sentence": "Sentence", // Sentence setting.
       "miscInfo": "MiscInfo", // Misc info setting.
-      "translation": "SelectionText" // Translation setting.
+      "translation": "SelectionText", // Translation setting.
     }, // Fields setting.
     "ai": {
       "enabled": false, // Enabled setting. Values: true | false
@@ -226,7 +189,7 @@
       "model": "openai/gpt-4o-mini", // Model setting.
       "baseUrl": "https://openrouter.ai/api", // Base url setting.
       "targetLanguage": "English", // Target language setting.
-      "systemPrompt": "You are a translation engine. Return only the translated text with no explanations." // System prompt setting.
+      "systemPrompt": "You are a translation engine. Return only the translated text with no explanations.", // System prompt setting.
     }, // Ai setting.
     "media": {
       "generateAudio": true, // Generate audio setting. Values: true | false
@@ -239,7 +202,7 @@
       "animatedCrf": 35, // Animated crf setting.
       "audioPadding": 0.5, // Audio padding setting.
       "fallbackDuration": 3, // Fallback duration setting.
-      "maxMediaDuration": 30 // Max media duration setting.
+      "maxMediaDuration": 30, // Max media duration setting.
     }, // Media setting.
     "behavior": {
       "overwriteAudio": true, // Overwrite audio setting. Values: true | false
@@ -247,7 +210,7 @@
       "mediaInsertMode": "append", // Media insert mode setting.
       "highlightWord": true, // Highlight word setting. Values: true | false
       "notificationType": "osd", // Notification type setting.
-      "autoUpdateNewCards": true // Automatically update newly added cards. Values: true | false
+      "autoUpdateNewCards": true, // Automatically update newly added cards. Values: true | false
     }, // Behavior setting.
     "nPlusOne": {
       "highlightEnabled": false, // Enable fast local highlighting for words already known in Anki. Values: true | false
@@ -256,20 +219,20 @@
       "decks": [], // Decks used for N+1 known-word cache scope. Supports one or more deck names.
       "minSentenceWords": 3, // Minimum sentence word count required for N+1 targeting (default: 3).
       "nPlusOne": "#c6a0f6", // Color used for the single N+1 target token highlight.
-      "knownWord": "#a6da95" // Color used for legacy known-word highlights.
+      "knownWord": "#a6da95", // Color used for legacy known-word highlights.
     }, // N plus one setting.
     "metadata": {
-      "pattern": "[SubMiner] %f (%t)" // Pattern setting.
+      "pattern": "[SubMiner] %f (%t)", // Pattern setting.
     }, // Metadata setting.
     "isLapis": {
       "enabled": false, // Enabled setting. Values: true | false
-      "sentenceCardModel": "Japanese sentences" // Sentence card model setting.
+      "sentenceCardModel": "Japanese sentences", // Sentence card model setting.
     }, // Is lapis setting.
     "isKiku": {
       "enabled": false, // Enabled setting. Values: true | false
       "fieldGrouping": "disabled", // Kiku duplicate-card field grouping mode. Values: auto | manual | disabled
-      "deleteDuplicateInAuto": true // Delete duplicate in auto setting. Values: true | false
-    } // Is kiku setting.
+      "deleteDuplicateInAuto": true, // Delete duplicate in auto setting. Values: true | false
+    }, // Is kiku setting.
   }, // Automatic Anki updates and media generation options.
 
   // ==========================================
@@ -279,7 +242,7 @@
   "jimaku": {
     "apiBaseUrl": "https://jimaku.cc", // Api base url setting.
     "languagePreference": "ja", // Preferred language used in Jimaku search. Values: ja | en | none
-    "maxEntryResults": 10 // Maximum Jimaku search results returned.
+    "maxEntryResults": 10, // Maximum Jimaku search results returned.
   }, // Jimaku API configuration and defaults.
 
   // ==========================================
@@ -290,33 +253,16 @@
     "mode": "automatic", // YouTube subtitle generation mode for the launcher script. Values: automatic | preprocess | off
     "whisperBin": "", // Path to whisper.cpp CLI used as fallback transcription engine.
     "whisperModel": "", // Path to whisper model used for fallback transcription.
-    "primarySubLanguages": [
-      "ja",
-      "jpn"
-    ] // Comma-separated primary subtitle language priority used by the launcher.
+    "primarySubLanguages": ["ja", "jpn"], // Comma-separated primary subtitle language priority used by the launcher.
   }, // Defaults for subminer YouTube subtitle extraction/transcription mode.
 
   // ==========================================
   // Anilist
   // Anilist API credentials and update behavior.
-  // Includes optional auto-sync for a merged MRU-based character dictionary in bundled Yomitan.
-  // Character dictionaries are keyed by AniList media ID (no season/franchise merge).
   // ==========================================
   "anilist": {
     "enabled": false, // Enable AniList post-watch progress updates. Values: true | false
     "accessToken": "", // Optional explicit AniList access token override; leave empty to use locally stored token from setup.
-    "characterDictionary": {
-      "enabled": false, // Enable automatic Yomitan character dictionary sync for currently watched AniList media. Values: true | false
-      "refreshTtlHours": 168, // Legacy setting; merged character dictionary retention is now usage-based and this value is ignored.
-      "maxLoaded": 3, // Maximum number of most-recently-used anime snapshots included in the merged Yomitan character dictionary.
-      "evictionPolicy": "delete", // Legacy setting; merged character dictionary eviction is usage-based and this value is ignored. Values: disable | delete
-      "profileScope": "all", // Yomitan profile scope for dictionary enable/disable updates. Values: all | active
-      "collapsibleSections": {
-        "description": false, // Open the Description section by default in character dictionary glossary entries. Values: true | false
-        "characterInformation": false, // Open the Character Information section by default in character dictionary glossary entries. Values: true | false
-        "voicedBy": false // Open the Voiced by section by default in character dictionary glossary entries. Values: true | false
-      } // Collapsible sections setting.
-    } // Character dictionary setting.
   }, // Anilist API credentials and update behavior.
 
   // ==========================================
@@ -340,16 +286,8 @@
     "pullPictures": false, // Enable Jellyfin poster/icon fetching for launcher menus. Values: true | false
     "iconCacheDir": "/tmp/subminer-jellyfin-icons", // Directory used by launcher for cached Jellyfin poster icons.
     "directPlayPreferred": true, // Try direct play before server-managed transcoding when possible. Values: true | false
-    "directPlayContainers": [
-      "mkv",
-      "mp4",
-      "webm",
-      "mov",
-      "flac",
-      "mp3",
-      "aac"
-    ], // Container allowlist for direct play decisions.
-    "transcodeVideoCodec": "h264" // Preferred transcode video codec when direct play is unavailable.
+    "directPlayContainers": ["mkv", "mp4", "webm", "mov", "flac", "mp3", "aac"], // Container allowlist for direct play decisions.
+    "transcodeVideoCodec": "h264", // Preferred transcode video codec when direct play is unavailable.
   }, // Optional Jellyfin integration for auth, browsing, and playback launch.
 
   // ==========================================
@@ -360,7 +298,7 @@
   "discordPresence": {
     "enabled": false, // Enable optional Discord Rich Presence updates. Values: true | false
     "updateIntervalMs": 3000, // Minimum interval between presence payload updates.
-    "debounceMs": 750 // Debounce delay used to collapse bursty presence updates.
+    "debounceMs": 750, // Debounce delay used to collapse bursty presence updates.
   }, // Optional Discord Rich Presence activity card updates for current playback/study session.
 
   // ==========================================
@@ -382,7 +320,7 @@
       "telemetryDays": 30, // Telemetry retention window in days.
       "dailyRollupsDays": 365, // Daily rollup retention window in days.
       "monthlyRollupsDays": 1825, // Monthly rollup retention window in days.
-      "vacuumIntervalDays": 7 // Minimum days between VACUUM runs.
-    } // Retention setting.
-  } // Enable/disable immersion tracking.
+      "vacuumIntervalDays": 7, // Minimum days between VACUUM runs.
+    }, // Retention setting.
+  }, // Enable/disable immersion tracking.
 }

docs/anki-integration.md

@@ -0,0 +1,28 @@
+# Anki Integration
+
+read_when:
+- changing `src/anki-integration.ts`
+- changing Anki transport/config hot-reload behavior
+- tracing note update, field grouping, or proxy ownership
+
+## Ownership
+
+- `src/anki-integration.ts`: thin facade; wires dependencies; exposes public Anki API used by runtime/services.
+- `src/anki-integration/runtime.ts`: normalized config state, polling-vs-proxy transport lifecycle, runtime config patch handling.
+- `src/anki-integration/card-creation.ts`: sentence/audio card creation and clipboard update flow.
+- `src/anki-integration/note-update-workflow.ts`: enrich newly added notes.
+- `src/anki-integration/field-grouping.ts`: preview/build helpers for Kiku field grouping.
+- `src/anki-integration/field-grouping-workflow.ts`: auto/manual merge execution.
+- `src/anki-integration/anki-connect-proxy.ts`: local proxy transport for post-add enrichment.
+- `src/anki-integration/known-word-cache.ts`: known-word cache lifecycle and persistence.
+
+## Refactor seam
+
+`AnkiIntegrationRuntime` owns the cluster that previously mixed:
+
+- config normalization/defaulting
+- polling vs proxy startup/shutdown
+- transport restart decisions during runtime patches
+- known-word cache lifecycle toggles tied to config changes
+
+Keep new orchestration work in `runtime.ts` when it changes process-level Anki state. Keep note/card behavior in the workflow/service modules.

docs/plans/2026-03-06-character-name-gating.md

@@ -0,0 +1,50 @@
+# Character Name Gating Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Disable subtitle character-name lookup/highlighting when the AniList character dictionary feature is disabled, while keeping tokenization and all other annotations working.
+
+**Architecture:** Gate `getNameMatchEnabled` at the runtime-deps boundary used by subtitle tokenization. Keep the tokenizer pipeline intact and only suppress character-name metadata requests when `anilist.characterDictionary.enabled` is false, regardless of `subtitleStyle.nameMatchEnabled`.
+
+**Tech Stack:** TypeScript, Bun test runner, Electron main/runtime wiring.
+
+---
+
+### Task 1: Add runtime gating coverage
+
+**Files:**
+- Modify: `src/main/runtime/subtitle-tokenization-main-deps.test.ts`
+
+**Step 1: Write the failing test**
+
+Add a test proving `getNameMatchEnabled()` resolves to `false` when `getCharacterDictionaryEnabled()` is `false` even if `getNameMatchEnabled()` is `true`.
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun test src/main/runtime/subtitle-tokenization-main-deps.test.ts`
+Expected: FAIL because the deps builder does not yet combine the two flags.
+
+### Task 2: Implement minimal runtime gate
+
+**Files:**
+- Modify: `src/main/runtime/subtitle-tokenization-main-deps.ts`
+- Modify: `src/main.ts`
+
+**Step 3: Write minimal implementation**
+
+Add `getCharacterDictionaryEnabled` to the main handler deps and make the built `getNameMatchEnabled` return true only when both the subtitle setting and the character dictionary setting are enabled.
+
+**Step 4: Run tests to verify green**
+
+Run: `bun test src/main/runtime/subtitle-tokenization-main-deps.test.ts`
+Expected: PASS.
+
+### Task 3: Verify no regressions in related tokenization seams
+
+**Files:**
+- Modify: none unless failures reveal drift
+
+**Step 5: Run focused verification**
+
+Run: `bun test src/core/services/subtitle-processing-controller.test.ts src/main/runtime/subtitle-tokenization-main-deps.test.ts`
+Expected: PASS.

docs/plans/2026-03-06-immersion-sqlite-verification.md

@@ -0,0 +1,155 @@
+# Immersion SQLite Verification Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Make the SQLite-backed immersion tracking persistence tests visible in the repo's verification surface and reproducible through at least one documented automated command.
+
+**Architecture:** Keep the existing Bun fast lane intact for routine local verification, but add an explicit SQLite verification lane that runs the database-backed immersion tests under a runtime with `node:sqlite` support. Surface unsupported-runtime behavior clearly in the source tests and contributor docs so skipped or omitted coverage is no longer mistaken for a fully green persistence lane.
+
+**Tech Stack:** TypeScript, Bun scripts in `package.json`, Node's built-in `node:test` and `node:sqlite`, GitHub Actions workflows, Markdown docs in `README.md`.
+
+---
+
+### Task 1: Audit and expose the SQLite-backed immersion test surface
+
+**Files:**
+
+- Modify: `src/core/services/immersion-tracker-service.test.ts`
+- Modify: `src/core/services/immersion-tracker/storage-session.test.ts`
+- Reference: `src/main/runtime/registry.test.ts`
+
+**Step 1: Write the failing test**
+
+Refactor the SQLite-gated immersion tests so missing `node:sqlite` support is reported with an explicit skip reason instead of a silent top-level `test.skip` alias.
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun test src/core/services/immersion-tracker-service.test.ts src/core/services/immersion-tracker/storage-session.test.ts`
+Expected: the current output shows generic skips or hides the storage-session suite from normal scripted verification, which is too opaque for contributors.
+
+**Step 3: Write minimal implementation**
+
+Mirror the `src/main/runtime/registry.test.ts` pattern: add a helper that either loads `DatabaseSync` or skips with a message like `requires node:sqlite support in this runtime`, then wrap each SQLite-backed test through that helper.
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun test src/core/services/immersion-tracker-service.test.ts src/core/services/immersion-tracker/storage-session.test.ts`
+Expected: PASS, with explicit skip messages in unsupported runtimes.
+
+### Task 2: Add a reproducible SQLite verification command
+
+**Files:**
+
+- Modify: `package.json`
+- Reference: `src/core/services/immersion-tracker-service.test.ts`
+- Reference: `src/core/services/immersion-tracker/storage-session.test.ts`
+
+**Step 1: Write the failing test**
+
+Add a dedicated script contract for the SQLite-backed immersion verification lane so both persistence-heavy suites are intentionally grouped and runnable together.
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun run test:immersion:sqlite`
+Expected: FAIL because no such reproducible lane exists yet.
+
+**Step 3: Write minimal implementation**
+
+Update `package.json` with explicit scripts for the SQLite lane. Prefer a command shape that actually executes the built JS tests under Node with `node:sqlite` support, for example:
+
+- `test:immersion:sqlite:dist`: `node --test dist/core/services/immersion-tracker-service.test.js dist/core/services/immersion-tracker/storage-session.test.js`
+- `test:immersion:sqlite`: `bun run build && bun run test:immersion:sqlite:dist`
+
+If build cost or runtime behavior requires a small adjustment, keep the core contract the same: one documented command must run both SQLite-backed immersion suites end-to-end.
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun run test:immersion:sqlite`
+Expected: PASS in a Node runtime with `node:sqlite`, executing both persistence suites without Bun-only skips.
+
+### Task 3: Wire the SQLite lane into automated verification
+
+**Files:**
+
+- Modify: `.github/workflows/ci.yml`
+- Modify: `.github/workflows/release.yml`
+- Reference: `package.json`
+
+**Step 1: Write the failing test**
+
+Add the new SQLite immersion lane to the repo's automated verification so contributors and CI can rely on a real persistence check rather than the Bun fast lane alone.
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun run test:immersion:sqlite`
+Expected: local command may pass, but CI/release workflows still omit the lane entirely.
+
+**Step 3: Write minimal implementation**
+
+Update both workflows to provision a Node version with `node:sqlite` support before the SQLite lane runs, then execute `bun run test:immersion:sqlite` in the quality gate after the bundle build produces `dist/**` test files.
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun run test:immersion:sqlite`
+Expected: PASS locally, and workflow definitions clearly show the SQLite lane as part of automated verification.
+
+### Task 4: Document contributor-facing prerequisites and commands
+
+**Files:**
+
+- Modify: `README.md`
+- Reference: `package.json`
+- Reference: `.github/workflows/ci.yml`
+
+**Step 1: Write the failing test**
+
+Extend the verification docs so contributors can discover the SQLite lane, know why the Bun source lane may skip those cases, and understand which command reproduces the persistence coverage.
+
+**Step 2: Run test to verify it fails**
+
+Run: `grep -n "test:immersion:sqlite" README.md`
+Expected: FAIL because the dedicated immersion SQLite lane is undocumented.
+
+**Step 3: Write minimal implementation**
+
+Update `README.md` to document:
+
+- the Bun fast/default lane versus the SQLite persistence lane
+- the `node:sqlite` prerequisite for the reproducible command
+- that the dedicated lane covers session persistence/finalization behavior beyond seam tests
+
+**Step 4: Run test to verify it passes**
+
+Run: `grep -n "test:immersion:sqlite" README.md && grep -n "node:sqlite" README.md`
+Expected: PASS, with clear contributor guidance.
+
+### Task 5: Verify persistence coverage end-to-end
+
+**Files:**
+
+- Test: `src/core/services/immersion-tracker-service.test.ts`
+- Test: `src/core/services/immersion-tracker/storage-session.test.ts`
+- Reference: `README.md`
+- Reference: `package.json`
+
+**Step 1: Write the failing test**
+
+Prove the final lane exercises real DB-backed persistence/finalization paths, not just the seam tests.
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun run test:immersion:sqlite`
+Expected: before implementation, the command does not exist or does not cover both SQLite-backed suites.
+
+**Step 3: Write minimal implementation**
+
+Keep the dedicated lane pointed at both existing SQLite-backed test files so it covers representative finalization and persistence behavior such as:
+
+- `destroy finalizes active session and persists final telemetry`
+- `start/finalize session updates ended_at and status`
+- `executeQueuedWrite inserts event and telemetry rows`
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun run test:immersion:sqlite`
+Expected: PASS, with those DB-backed persistence/finalization cases executing successfully under Node.

docs/plans/2026-03-06-merged-character-dictionary.md

@@ -0,0 +1,92 @@
+# Merged Character Dictionary Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Replace per-anime character dictionary imports with one merged Yomitan dictionary driven by MRU usage retention.
+
+**Architecture:** Persist normalized per-media character dictionary snapshots locally, maintain MRU retained media ids in auto-sync state, and rebuild a single merged Yomitan zip only when the retained set changes. Keep external AniList fetches only for media without a local snapshot; normal revisits stay local.
+
+**Tech Stack:** TypeScript, Bun test, Node fs/path, existing Yomitan zip generation helpers.
+
+---
+
+### Task 1: Lock in merged auto-sync behavior
+
+**Files:**
+- Modify: `src/main/runtime/character-dictionary-auto-sync.test.ts`
+- Test: `src/main/runtime/character-dictionary-auto-sync.test.ts`
+
+**Step 1: Write the failing test**
+
+Add tests for:
+- single merged dictionary title/import replacing per-media imports
+- MRU reorder causing rebuild only when order changes
+- unchanged revisit skipping rebuild/import
+- capped retained set evicting least-recently-used media
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun test src/main/runtime/character-dictionary-auto-sync.test.ts`
+Expected: FAIL on old per-media import assumptions / missing merged behavior
+
+**Step 3: Write minimal implementation**
+
+Update auto-sync runtime to track retained media ids and merged revision/hash, call merged zip builder, and replace one imported Yomitan dictionary.
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun test src/main/runtime/character-dictionary-auto-sync.test.ts`
+Expected: PASS
+
+### Task 2: Add snapshot + merged-zip runtime support
+
+**Files:**
+- Modify: `src/main/character-dictionary-runtime.ts`
+- Modify: `src/main/character-dictionary-runtime.test.ts`
+- Test: `src/main/character-dictionary-runtime.test.ts`
+
+**Step 1: Write the failing test**
+
+Add tests for:
+- saving/loading normalized per-media snapshots without per-media zip cache
+- building merged zip from retained media snapshots with stable dictionary title
+- preserving images/terms from multiple media in merged output
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun test src/main/character-dictionary-runtime.test.ts`
+Expected: FAIL because snapshot/merged APIs do not exist yet
+
+**Step 3: Write minimal implementation**
+
+Refactor dictionary runtime to expose snapshot generation/loading and merged zip building from stored metadata/images.
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun test src/main/character-dictionary-runtime.test.ts`
+Expected: PASS
+
+### Task 3: Wire app/runtime config and docs
+
+**Files:**
+- Modify: `src/main.ts`
+- Modify: `src/config/definitions/options-integrations.ts`
+- Modify: `README.md`
+
+**Step 1: Write the failing test**
+
+Add or update tests if needed for new dependency wiring / docs-adjacent config description expectations.
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun test src/main/runtime/character-dictionary-auto-sync.test.ts src/main/character-dictionary-runtime.test.ts`
+Expected: FAIL until wiring matches merged flow
+
+**Step 3: Write minimal implementation**
+
+Swap app wiring to new snapshot + merged build API, update config/docs text from TTL semantics to usage-based merged retention.
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun test src/main/runtime/character-dictionary-auto-sync.test.ts src/main/character-dictionary-runtime.test.ts && bun run tsc --noEmit`
+Expected: PASS

docs/plans/2026-03-06-subtitle-sync-verification.md

@@ -0,0 +1,121 @@
+# Subtitle Sync Verification Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Replace the no-op `test:subtitle` lane with real automated subtitle-sync verification that reuses the maintained subsync tests and documents the real contributor workflow.
+
+**Architecture:** Repoint the subtitle verification command at the existing source-level subsync tests instead of inventing a second hidden suite. Add one focused ffsubsync failure-path test so the subtitle lane explicitly covers both engines plus a non-happy path, then update contributor docs to describe the dedicated subtitle lane and how it relates to `test:core`.
+
+**Tech Stack:** TypeScript, Bun test, Node test/assert, npm package scripts, Markdown docs.
+
+---
+
+### Task 1: Lock subtitle lane to real subsync tests
+
+**Files:**
+
+- Modify: `package.json`
+
+**Step 1: Write the failing test**
+
+Define the intended command shape first: `test:subtitle:src` should run `src/core/services/subsync.test.ts` and `src/subsync/utils.test.ts`, `test:subtitle` should invoke that real source lane, and no placeholder echo should remain.
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun run test:subtitle`
+Expected: It performs a build and prints `Subtitle tests are currently not configured`, proving the lane is still a no-op.
+
+**Step 3: Write minimal implementation**
+
+Update `package.json` so:
+
+- `test:subtitle:src` runs `bun test src/core/services/subsync.test.ts src/subsync/utils.test.ts`
+- `test:subtitle` runs the new source lane directly
+- `test:subtitle:dist` is removed if it is no longer the real verification path
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun run test:subtitle`
+Expected: PASS with Bun executing the real subtitle-sync test files.
+
+### Task 2: Add explicit ffsubsync non-happy-path coverage
+
+**Files:**
+
+- Modify: `src/core/services/subsync.test.ts`
+- Test: `src/core/services/subsync.test.ts`
+
+**Step 1: Write the failing test**
+
+Add a test that runs `runSubsyncManual({ engine: 'ffsubsync' })` with a stub ffsubsync executable that exits non-zero and writes stderr, then assert:
+
+- `result.ok === false`
+- `result.message` starts with `ffsubsync synchronization failed`
+- the failure message includes command details surfaced to the user
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun test src/core/services/subsync.test.ts`
+Expected: FAIL because ffsubsync failure propagation is not asserted yet.
+
+**Step 3: Write minimal implementation**
+
+Keep production code unchanged unless the new test exposes a real bug. If needed, tighten failure assertions or message propagation in `src/core/services/subsync.ts` without changing successful behavior.
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun test src/core/services/subsync.test.ts`
+Expected: PASS with both alass and ffsubsync paths covered, including a non-happy path.
+
+### Task 3: Make contributor docs match the real verification path
+
+**Files:**
+
+- Modify: `README.md`
+- Modify: `package.json`
+
+**Step 1: Write the failing test**
+
+Use the repository state as the failure signal: README currently advertises subtitle sync as a feature but does not tell contributors that `bun run test:subtitle` is the real verification lane.
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun run test:subtitle && bun test src/subsync/utils.test.ts`
+Expected: Tests pass, but docs still do not explain the lane; this is the remaining acceptance-criteria gap.
+
+**Step 3: Write minimal implementation**
+
+Update `README.md` with a short contributor-facing verification note that:
+
+- points to `bun run test:subtitle` for subtitle-sync coverage
+- states that the lane reuses the maintained subsync tests already included in broader core coverage
+- avoids implying there is a separate hidden subtitle test harness beyond those tests
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun run test:subtitle`
+Expected: PASS, with docs and scripts now aligned around the same subtitle verification strategy.
+
+### Task 4: Verify matrix integration stays clean
+
+**Files:**
+
+- Modify: `package.json` (only if Task 1/3 exposed cleanup needs)
+
+**Step 1: Write the failing test**
+
+Treat duplication as the failure condition: confirm the dedicated subtitle lane reuses the same maintained files already present in `test:core:src` rather than creating a second divergent suite.
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun run test:subtitle && bun run test:core:src`
+Expected: If file lists diverge unexpectedly, this review step exposes it before handoff.
+
+**Step 3: Write minimal implementation**
+
+If needed, do the smallest script cleanup necessary so subtitle coverage remains explicit without hiding or duplicating existing core coverage.
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun run test:subtitle && bun run test:core:src`
+Expected: PASS, confirming the dedicated lane and the broader core suite agree on subtitle coverage.

docs/plans/2026-03-06-testing-workflow-test-matrix.md

@@ -0,0 +1,169 @@
+# Testing Workflow Test Matrix Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Make the standard test commands reflect the maintained test surface so newly added tests are discovered automatically or intentionally documented outside the default lane.
+
+**Architecture:** Replace the current hand-maintained file allowlists in `package.json` with directory-based Bun test lanes that map to maintained test surfaces. Keep the default developer lane fast, move slower or environment-specific checks into explicit commands, and document the resulting matrix in `README.md` so contributors know exactly which command to run.
+
+**Tech Stack:** TypeScript, Bun test, npm-style package scripts in `package.json`, Markdown docs in `README.md`.
+
+---
+
+### Task 1: Lock in the desired script matrix with failing tests/audit checks
+
+**Files:**
+
+- Modify: `package.json`
+- Test: `package.json`
+- Reference: `src/main-entry-runtime.test.ts`
+- Reference: `src/anki-integration/anki-connect-proxy.test.ts`
+- Reference: `src/main/runtime/registry.test.ts`
+
+**Step 1: Write the failing test**
+
+Add a new script structure in `package.json` expectations by editing the script map so these lanes exist conceptually:
+
+- `test:fast` for default fast verification
+- `test:full` for the maintained source test surface
+- `test:env` for environment-specific checks
+
+The fast lane should stay selective and intentional. The full lane should use directory-based discovery rather than file-by-file allowlists, with representative coverage from:
+
+- `src/main-entry-runtime.test.ts`
+- `src/anki-integration/**/*.test.ts`
+- `src/main/**/*.test.ts`
+- `launcher/**/*.test.ts`
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun run test:full`
+Expected: FAIL because `test:full` does not exist yet, and previously omitted maintained tests are still outside the standard matrix.
+
+**Step 3: Write minimal implementation**
+
+Update `package.json` scripts so:
+
+- `test` points at `test:fast`
+- `test:fast` runs the fast default lane only
+- `test:full` runs directory-based maintained suites instead of file allowlists
+- `test:env` runs environment-specific verification (for example launcher/plugin and sqlite-gated suites)
+- subsystem scripts use stable path globs or directory arguments so new tests are discovered automatically
+
+Prefer commands like these, adjusted only as needed for Bun behavior in this repo:
+
+- `bun test src/config/**/*.test.ts`
+- `bun test src/{cli,core,renderer,subtitle,subsync,main,anki-integration}/*.test.ts ...` only if Bun cannot take the broader directory directly
+- `bun test launcher/**/*.test.ts`
+
+Do not keep large hand-maintained file enumerations for maintained unit/integration lanes.
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun run test:full`
+Expected: PASS, including automated execution of representative tests that were previously omitted from the standard matrix.
+
+### Task 2: Separate environment-specific verification from the maintained default/full lanes
+
+**Files:**
+
+- Modify: `package.json`
+- Test: `src/main/runtime/registry.test.ts`
+- Test: `launcher/smoke.e2e.test.ts`
+- Test: `src/core/services/immersion-tracker-service.test.ts`
+
+**Step 1: Write the failing test**
+
+Refine the package scripts so environment-specific checks are explicitly grouped outside the default fast lane. Treat these as the primary environment-specific examples unless repo behavior proves a better split during execution:
+
+- launcher smoke/plugin checks that rely on local process or Lua execution
+- sqlite-dependent checks that may skip when `node:sqlite` is unavailable
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun run test:env`
+Expected: FAIL because the environment-specific lane is not defined yet.
+
+**Step 3: Write minimal implementation**
+
+Add explicit environment-specific scripts in `package.json`, such as:
+
+- a launcher/plugin lane that runs `launcher/smoke.e2e.test.ts` plus `lua scripts/test-plugin-start-gate.lua`
+- a sqlite lane for tests that require `node:sqlite` support or otherwise need environment notes
+- an aggregate `test:env` command that runs all environment-specific lanes
+
+Keep these lanes documented and reproducible rather than silently excluded.
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun run test:env`
+Expected: PASS in supported environments, or clear documented skip behavior where the tests themselves intentionally gate on missing runtime support.
+
+### Task 3: Document contributor-facing test commands and matrix
+
+**Files:**
+
+- Modify: `README.md`
+- Reference: `package.json`
+
+**Step 1: Write the failing test**
+
+Add a contributor-focused testing section requirement in `README.md` expectations:
+
+- fast verification command
+- full verification command
+- environment-specific verification command
+- plain-language explanation of which suites each lane covers and why
+
+**Step 2: Run test to verify it fails**
+
+Run: `grep -n "Testing" README.md`
+Expected: no contributor testing matrix section exists yet.
+
+**Step 3: Write minimal implementation**
+
+Update `README.md` with a concise `Testing` section that documents:
+
+- `bun run test` / `bun run test:fast` for fast local verification
+- `bun run test:full` for the maintained source test surface
+- `bun run test:env` for environment-specific verification
+- any important notes about sqlite-gated tests and launcher/plugin checks
+
+Keep the matrix concrete and reproducible.
+
+**Step 4: Run test to verify it passes**
+
+Run: `grep -n "Testing" README.md && grep -n "test:full" README.md && grep -n "test:env" README.md`
+Expected: PASS with the new contributor-facing matrix present.
+
+### Task 4: Verify representative omitted suites now belong to automated lanes
+
+**Files:**
+
+- Test: `src/main-entry-runtime.test.ts`
+- Test: `src/anki-integration/anki-connect-proxy.test.ts`
+- Test: `src/main/runtime/registry.test.ts`
+- Reference: `package.json`
+- Reference: `README.md`
+
+**Step 1: Write the failing test**
+
+Use targeted command checks to prove these previously omitted surfaces are now in the matrix:
+
+- entry/runtime: `src/main-entry-runtime.test.ts`
+- Anki integration: `src/anki-integration/anki-connect-proxy.test.ts`
+- main runtime: `src/main/runtime/registry.test.ts`
+
+**Step 2: Run test to verify it fails**
+
+Run: `bun run test:full src/main-entry-runtime.test.ts`
+Expected: either unsupported invocation or evidence that the current matrix still does not include these surfaces automatically.
+
+**Step 3: Write minimal implementation**
+
+Adjust the final script paths/globs until the full matrix includes those representative surfaces without file-by-file script maintenance.
+
+**Step 4: Run test to verify it passes**
+
+Run: `bun test src/main-entry-runtime.test.ts src/anki-integration/anki-connect-proxy.test.ts src/main/runtime/registry.test.ts && bun run test:fast && bun run test:full`
+Expected: PASS, with at least one representative test from each required surface executing through the documented automated lanes.

launcher/commands/playback-command.ts

@@ -1,6 +1,4 @@
 import fs from 'node:fs';
-import os from 'node:os';
-import { spawn } from 'node:child_process';
 import { fail, log } from '../log.js';
 import { commandExists, isYoutubeTarget, realpathMaybe, resolvePathMaybe } from '../util.js';
 import { collectVideos, showFzfMenu, showRofiMenu } from '../picker.js';
@@ -15,15 +13,6 @@ import {
 import { generateYoutubeSubtitles } from '../youtube.js';
 import type { Args } from '../types.js';
 import type { LauncherCommandContext } from './context.js';
-import { ensureLauncherSetupReady } from '../setup-gate.js';
-import {
-  getDefaultConfigDir,
-  getSetupStatePath,
-  readSetupState,
-} from '../../src/shared/setup-state.js';
-
-const SETUP_WAIT_TIMEOUT_MS = 10 * 60 * 1000;
-const SETUP_POLL_INTERVAL_MS = 500;
 
 function checkDependencies(args: Args): void {
   const missing: string[] = [];
@@ -95,47 +84,12 @@ function registerCleanup(context: LauncherCommandContext): void {
   });
 }
 
-async function ensurePlaybackSetupReady(context: LauncherCommandContext): Promise<void> {
-  const { args, appPath } = context;
-  if (!appPath) return;
-
-  const configDir = getDefaultConfigDir({
-    xdgConfigHome: process.env.XDG_CONFIG_HOME,
-    homeDir: os.homedir(),
-  });
-  const statePath = getSetupStatePath(configDir);
-  const ready = await ensureLauncherSetupReady({
-    readSetupState: () => readSetupState(statePath),
-    launchSetupApp: () => {
-      const setupArgs = ['--background', '--setup'];
-      if (args.logLevel) {
-        setupArgs.push('--log-level', args.logLevel);
-      }
-      const child = spawn(appPath, setupArgs, {
-        detached: true,
-        stdio: 'ignore',
-      });
-      child.unref();
-    },
-    sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
-    now: () => Date.now(),
-    timeoutMs: SETUP_WAIT_TIMEOUT_MS,
-    pollIntervalMs: SETUP_POLL_INTERVAL_MS,
-  });
-
-  if (!ready) {
-    fail('SubMiner setup is incomplete. Complete setup in the app, then retry playback.');
-  }
-}
-
 export async function runPlaybackCommand(context: LauncherCommandContext): Promise<void> {
   const { args, appPath, scriptPath, mpvSocketPath, pluginRuntimeConfig, processAdapter } = context;
   if (!appPath) {
     fail('SubMiner AppImage not found. Install to ~/.local/bin/ or set SUBMINER_APPIMAGE_PATH.');
   }
 
-  await ensurePlaybackSetupReady(context);
-
   if (!args.target) {
     checkPickerDependencies(args);
   }

launcher/setup-gate.test.ts

@@ -1,107 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { ensureLauncherSetupReady, waitForSetupCompletion } from './setup-gate';
-import type { SetupState } from '../src/shared/setup-state';
-
-test('waitForSetupCompletion resolves completed and cancelled states', async () => {
-  const sequence: Array<SetupState | null> = [
-    null,
-    {
-      version: 1,
-      status: 'in_progress',
-      completedAt: null,
-      completionSource: null,
-      lastSeenYomitanDictionaryCount: 0,
-      pluginInstallStatus: 'unknown',
-      pluginInstallPathSummary: null,
-    },
-    {
-      version: 1,
-      status: 'completed',
-      completedAt: '2026-03-07T00:00:00.000Z',
-      completionSource: 'user',
-      lastSeenYomitanDictionaryCount: 1,
-      pluginInstallStatus: 'skipped',
-      pluginInstallPathSummary: null,
-    },
-  ];
-
-  const result = await waitForSetupCompletion({
-    readSetupState: () => sequence.shift() ?? null,
-    sleep: async () => undefined,
-    now: (() => {
-      let value = 0;
-      return () => (value += 100);
-    })(),
-    timeoutMs: 5_000,
-    pollIntervalMs: 100,
-  });
-
-  assert.equal(result, 'completed');
-});
-
-test('ensureLauncherSetupReady launches setup app and resumes only after completion', async () => {
-  const calls: string[] = [];
-  let reads = 0;
-
-  const ready = await ensureLauncherSetupReady({
-    readSetupState: () => {
-      reads += 1;
-      if (reads === 1) return null;
-      if (reads === 2) {
-        return {
-          version: 1,
-          status: 'in_progress',
-          completedAt: null,
-          completionSource: null,
-          lastSeenYomitanDictionaryCount: 0,
-          pluginInstallStatus: 'unknown',
-          pluginInstallPathSummary: null,
-        };
-      }
-      return {
-        version: 1,
-        status: 'completed',
-        completedAt: '2026-03-07T00:00:00.000Z',
-        completionSource: 'user',
-        lastSeenYomitanDictionaryCount: 1,
-        pluginInstallStatus: 'installed',
-        pluginInstallPathSummary: '/tmp/mpv',
-      };
-    },
-    launchSetupApp: () => {
-      calls.push('launch');
-    },
-    sleep: async () => undefined,
-    now: (() => {
-      let value = 0;
-      return () => (value += 100);
-    })(),
-    timeoutMs: 5_000,
-    pollIntervalMs: 100,
-  });
-
-  assert.equal(ready, true);
-  assert.deepEqual(calls, ['launch']);
-});
-
-test('ensureLauncherSetupReady fails on timeout/cancelled state', async () => {
-  const result = await ensureLauncherSetupReady({
-    readSetupState: () => ({
-      version: 1,
-      status: 'cancelled',
-      completedAt: null,
-      completionSource: null,
-      lastSeenYomitanDictionaryCount: 0,
-      pluginInstallStatus: 'unknown',
-      pluginInstallPathSummary: null,
-    }),
-    launchSetupApp: () => undefined,
-    sleep: async () => undefined,
-    now: () => 0,
-    timeoutMs: 5_000,
-    pollIntervalMs: 100,
-  });
-
-  assert.equal(result, false);
-});

launcher/setup-gate.ts

@@ -1,41 +0,0 @@
-import { isSetupCompleted, type SetupState } from '../src/shared/setup-state.js';
-
-export async function waitForSetupCompletion(deps: {
-  readSetupState: () => SetupState | null;
-  sleep: (ms: number) => Promise<void>;
-  now: () => number;
-  timeoutMs: number;
-  pollIntervalMs: number;
-}): Promise<'completed' | 'cancelled' | 'timeout'> {
-  const deadline = deps.now() + deps.timeoutMs;
-
-  while (deps.now() <= deadline) {
-    const state = deps.readSetupState();
-    if (isSetupCompleted(state)) {
-      return 'completed';
-    }
-    if (state?.status === 'cancelled') {
-      return 'cancelled';
-    }
-    await deps.sleep(deps.pollIntervalMs);
-  }
-
-  return 'timeout';
-}
-
-export async function ensureLauncherSetupReady(deps: {
-  readSetupState: () => SetupState | null;
-  launchSetupApp: () => void;
-  sleep: (ms: number) => Promise<void>;
-  now: () => number;
-  timeoutMs: number;
-  pollIntervalMs: number;
-}): Promise<boolean> {
-  if (isSetupCompleted(deps.readSetupState())) {
-    return true;
-  }
-
-  deps.launchSetupApp();
-  const result = await waitForSetupCompletion(deps);
-  return result === 'completed';
-}

launcher/smoke.e2e.test.ts

@@ -4,13 +4,6 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { spawn, spawnSync } from 'node:child_process';
-import {
-  createDefaultSetupState,
-  getDefaultConfigDir,
-  getSetupStatePath,
-  readSetupState,
-  writeSetupState,
-} from '../src/shared/setup-state.js';
 
 type RunResult = {
   status: number | null;
@@ -65,13 +58,6 @@ function createSmokeCase(name: string): SmokeCase {
     `socket_path=${socketPath}\n`,
   );
 
-  const configDir = getDefaultConfigDir({ xdgConfigHome, homeDir });
-  const setupState = createDefaultSetupState();
-  setupState.status = 'completed';
-  setupState.completedAt = '2026-03-07T00:00:00.000Z';
-  setupState.completionSource = 'user';
-  writeSetupState(getSetupStatePath(configDir), setupState);
-
   const fakeMpvLogPath = path.join(artifactsDir, 'fake-mpv.log');
   const fakeAppLogPath = path.join(artifactsDir, 'fake-app.log');
   const fakeAppStartLogPath = path.join(artifactsDir, 'fake-app-start.log');
@@ -238,22 +224,6 @@ async function waitForJsonLines(
   }
 }
 
-test('launcher smoke fixture seeds completed setup state', () => {
-  const smokeCase = createSmokeCase('setup-state');
-  try {
-    const configDir = getDefaultConfigDir({
-      xdgConfigHome: smokeCase.xdgConfigHome,
-      homeDir: smokeCase.homeDir,
-    });
-    const statePath = getSetupStatePath(configDir);
-
-    assert.equal(readSetupState(statePath)?.status, 'completed');
-  } finally {
-    fs.rmSync(smokeCase.root, { recursive: true, force: true });
-    fs.rmSync(smokeCase.socketDir, { recursive: true, force: true });
-  }
-});
-
 test('launcher mpv status returns ready when socket is connectable', async () => {
   await withSmokeCase('mpv-status', async (smokeCase) => {
     const env = makeTestEnv(smokeCase);

package.json

@@ -1,6 +1,6 @@
 {
   "name": "subminer",
-  "version": "0.4.0",
+  "version": "0.3.0",
   "description": "All-in-one sentence mining overlay with AnkiConnect and dictionary integration",
   "packageManager": "bun@1.3.5",
   "main": "dist/main-entry.js",
@@ -8,24 +8,21 @@
     "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
     "typecheck:watch": "tsc --watch --preserveWatchOutput -p tsconfig.typecheck.json",
     "get-frequency": "bun run scripts/get_frequency.ts --pretty --color-top-x 10000 --yomitan-user-data ~/.config/SubMiner --colorized-line",
-    "get-frequency:electron": "bun run build:yomitan && bun build scripts/get_frequency.ts --format=cjs --target=node --outfile dist/scripts/get_frequency.js --external electron && electron dist/scripts/get_frequency.js --pretty --color-top-x 10000 --yomitan-user-data ~/.config/SubMiner --colorized-line",
+    "get-frequency:electron": "bun build scripts/get_frequency.ts --format=cjs --target=node --outfile dist/scripts/get_frequency.js --external electron && electron dist/scripts/get_frequency.js --pretty --color-top-x 10000 --yomitan-user-data ~/.config/SubMiner --colorized-line",
     "test-yomitan-parser": "bun run scripts/test-yomitan-parser.ts",
-    "test-yomitan-parser:electron": "bun run build:yomitan && bun build scripts/test-yomitan-parser.ts --format=cjs --target=node --outfile dist/scripts/test-yomitan-parser.js --external electron && electron dist/scripts/test-yomitan-parser.js",
-    "build:yomitan": "node scripts/build-yomitan.mjs",
-    "build": "bun run build:yomitan && tsc -p tsconfig.json && bun run build:renderer && cp src/renderer/index.html src/renderer/style.css dist/renderer/ && cp -r src/renderer/fonts dist/renderer/ && bash scripts/build-macos-helper.sh",
+    "test-yomitan-parser:electron": "bun build scripts/test-yomitan-parser.ts --format=cjs --target=node --outfile dist/scripts/test-yomitan-parser.js --external electron && electron dist/scripts/test-yomitan-parser.js",
+    "build": "tsc -p tsconfig.json && bun run build:renderer && cp src/renderer/index.html src/renderer/style.css dist/renderer/ && cp -r src/renderer/fonts dist/renderer/ && bash scripts/build-macos-helper.sh",
     "build:renderer": "esbuild src/renderer/renderer.ts --bundle --platform=browser --format=esm --target=es2022 --outfile=dist/renderer/renderer.js --sourcemap",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "format:src": "bash scripts/prettier-scope.sh --write",
-    "format:check:src": "bash scripts/prettier-scope.sh --check",
-    "test:config:src": "bun test src/config/config.test.ts src/config/path-resolution.test.ts src/config/resolve/anki-connect.test.ts src/config/resolve/subtitle-style.test.ts src/config/resolve/jellyfin.test.ts src/config/definitions/domain-registry.test.ts src/generate-config-example.test.ts",
-    "test:config:dist": "bun test dist/config/config.test.js dist/config/path-resolution.test.js dist/config/resolve/anki-connect.test.js dist/config/resolve/subtitle-style.test.js dist/config/resolve/jellyfin.test.js dist/config/definitions/domain-registry.test.js dist/generate-config-example.test.js",
+    "test:config:src": "bun test src/config/config.test.ts src/config/path-resolution.test.ts src/config/resolve/anki-connect.test.ts src/config/resolve/subtitle-style.test.ts src/config/resolve/jellyfin.test.ts src/config/definitions/domain-registry.test.ts",
+    "test:config:dist": "bun test dist/config/config.test.js dist/config/path-resolution.test.js dist/config/resolve/anki-connect.test.js dist/config/resolve/subtitle-style.test.js dist/config/resolve/jellyfin.test.js dist/config/definitions/domain-registry.test.js",
     "test:config:smoke:dist": "bun test dist/config/path-resolution.test.js",
     "test:plugin:src": "lua scripts/test-plugin-start-gate.lua",
     "test:launcher:smoke:src": "bun test launcher/smoke.e2e.test.ts",
     "test:launcher:src": "bun test launcher/config.test.ts launcher/config-domain-parsers.test.ts launcher/parse-args.test.ts launcher/main.test.ts launcher/commands/command-modules.test.ts launcher/smoke.e2e.test.ts && bun run test:plugin:src",
-    "test:core:src": "bun test src/cli/args.test.ts src/cli/help.test.ts src/shared/setup-state.test.ts src/core/services/cli-command.test.ts src/core/services/field-grouping-overlay.test.ts src/core/services/numeric-shortcut-session.test.ts src/core/services/secondary-subtitle.test.ts src/core/services/mpv-render-metrics.test.ts src/core/services/overlay-content-measurement.test.ts src/core/services/mpv-control.test.ts src/core/services/mpv.test.ts src/core/services/runtime-options-ipc.test.ts src/core/services/runtime-config.test.ts src/core/services/yomitan-extension-paths.test.ts src/core/services/config-hot-reload.test.ts src/core/services/discord-presence.test.ts src/core/services/tokenizer.test.ts src/core/services/tokenizer/annotation-stage.test.ts src/core/services/tokenizer/parser-selection-stage.test.ts src/core/services/tokenizer/parser-enrichment-stage.test.ts src/core/services/subsync.test.ts src/core/services/overlay-bridge.test.ts src/core/services/overlay-shortcut-handler.test.ts src/core/services/mining.test.ts src/core/services/anki-jimaku.test.ts src/core/services/jimaku-download-path.test.ts src/core/services/jellyfin.test.ts src/core/services/jellyfin-remote.test.ts src/core/services/immersion-tracker-service.test.ts src/core/services/overlay-runtime-init.test.ts src/core/services/app-ready.test.ts src/core/services/startup-bootstrap.test.ts src/core/services/subtitle-processing-controller.test.ts src/core/services/anilist/anilist-update-queue.test.ts src/core/utils/shortcut-config.test.ts src/main/runtime/first-run-setup-plugin.test.ts src/main/runtime/first-run-setup-service.test.ts src/main/runtime/first-run-setup-window.test.ts src/main/runtime/tray-runtime.test.ts src/main/runtime/tray-main-actions.test.ts src/main/runtime/tray-main-deps.test.ts src/main/runtime/tray-runtime-handlers.test.ts src/main/runtime/cli-command-context-main-deps.test.ts src/main/runtime/app-ready-main-deps.test.ts src/renderer/error-recovery.test.ts src/renderer/subtitle-render.test.ts src/renderer/handlers/mouse.test.ts src/renderer/handlers/keyboard.test.ts src/renderer/modals/jimaku.test.ts src/subsync/utils.test.ts src/main/anilist-url-guard.test.ts src/window-trackers/x11-tracker.test.ts launcher/config.test.ts launcher/config-domain-parsers.test.ts launcher/parse-args.test.ts launcher/main.test.ts launcher/commands/command-modules.test.ts launcher/setup-gate.test.ts",
-    "test:core:dist": "bun test dist/cli/args.test.js dist/cli/help.test.js dist/core/services/cli-command.test.js dist/core/services/ipc.test.js dist/core/services/anki-jimaku-ipc.test.js dist/core/services/field-grouping-overlay.test.js dist/core/services/numeric-shortcut-session.test.js dist/core/services/secondary-subtitle.test.js dist/core/services/mpv-render-metrics.test.js dist/core/services/overlay-content-measurement.test.js dist/core/services/mpv-control.test.js dist/core/services/mpv.test.js dist/core/services/runtime-options-ipc.test.js dist/core/services/runtime-config.test.js dist/core/services/yomitan-extension-paths.test.js dist/core/services/config-hot-reload.test.js dist/core/services/discord-presence.test.js dist/core/services/tokenizer.test.js dist/core/services/tokenizer/annotation-stage.test.js dist/core/services/tokenizer/parser-selection-stage.test.js dist/core/services/tokenizer/parser-enrichment-stage.test.js dist/core/services/subsync.test.js dist/core/services/overlay-bridge.test.js dist/core/services/overlay-manager.test.js dist/core/services/overlay-shortcut-handler.test.js dist/core/services/mining.test.js dist/core/services/anki-jimaku.test.js dist/core/services/jimaku-download-path.test.js dist/core/services/jellyfin.test.js dist/core/services/jellyfin-remote.test.js dist/core/services/immersion-tracker-service.test.js dist/core/services/overlay-runtime-init.test.js dist/core/services/app-ready.test.js dist/core/services/startup-bootstrap.test.js dist/core/services/subtitle-processing-controller.test.js dist/core/services/anilist/anilist-token-store.test.js dist/core/services/anilist/anilist-update-queue.test.js dist/renderer/error-recovery.test.js dist/renderer/subtitle-render.test.js dist/renderer/handlers/mouse.test.js dist/renderer/handlers/keyboard.test.js dist/renderer/modals/jimaku.test.js dist/subsync/utils.test.js dist/main/anilist-url-guard.test.js dist/window-trackers/x11-tracker.test.js",
+    "test:core:src": "bun test src/cli/args.test.ts src/cli/help.test.ts src/core/services/cli-command.test.ts src/core/services/field-grouping-overlay.test.ts src/core/services/numeric-shortcut-session.test.ts src/core/services/secondary-subtitle.test.ts src/core/services/mpv-render-metrics.test.ts src/core/services/overlay-content-measurement.test.ts src/core/services/mpv-control.test.ts src/core/services/mpv.test.ts src/core/services/runtime-options-ipc.test.ts src/core/services/runtime-config.test.ts src/core/services/config-hot-reload.test.ts src/core/services/discord-presence.test.ts src/core/services/tokenizer.test.ts src/core/services/tokenizer/annotation-stage.test.ts src/core/services/tokenizer/parser-selection-stage.test.ts src/core/services/tokenizer/parser-enrichment-stage.test.ts src/core/services/subsync.test.ts src/core/services/overlay-bridge.test.ts src/core/services/overlay-shortcut-handler.test.ts src/core/services/mining.test.ts src/core/services/anki-jimaku.test.ts src/core/services/jimaku-download-path.test.ts src/core/services/jellyfin.test.ts src/core/services/jellyfin-remote.test.ts src/core/services/immersion-tracker-service.test.ts src/core/services/overlay-runtime-init.test.ts src/core/services/app-ready.test.ts src/core/services/startup-bootstrap.test.ts src/core/services/subtitle-processing-controller.test.ts src/core/services/anilist/anilist-update-queue.test.ts src/core/utils/shortcut-config.test.ts src/renderer/error-recovery.test.ts src/renderer/subtitle-render.test.ts src/renderer/handlers/mouse.test.ts src/renderer/handlers/keyboard.test.ts src/renderer/modals/jimaku.test.ts src/subsync/utils.test.ts src/main/anilist-url-guard.test.ts src/window-trackers/x11-tracker.test.ts launcher/config.test.ts launcher/config-domain-parsers.test.ts launcher/parse-args.test.ts launcher/main.test.ts launcher/commands/command-modules.test.ts",
+    "test:core:dist": "bun test dist/cli/args.test.js dist/cli/help.test.js dist/core/services/cli-command.test.js dist/core/services/ipc.test.js dist/core/services/anki-jimaku-ipc.test.js dist/core/services/field-grouping-overlay.test.js dist/core/services/numeric-shortcut-session.test.js dist/core/services/secondary-subtitle.test.js dist/core/services/mpv-render-metrics.test.js dist/core/services/overlay-content-measurement.test.js dist/core/services/mpv-control.test.js dist/core/services/mpv.test.js dist/core/services/runtime-options-ipc.test.js dist/core/services/runtime-config.test.js dist/core/services/config-hot-reload.test.js dist/core/services/discord-presence.test.js dist/core/services/tokenizer.test.js dist/core/services/tokenizer/annotation-stage.test.js dist/core/services/tokenizer/parser-selection-stage.test.js dist/core/services/tokenizer/parser-enrichment-stage.test.js dist/core/services/subsync.test.js dist/core/services/overlay-bridge.test.js dist/core/services/overlay-manager.test.js dist/core/services/overlay-shortcut-handler.test.js dist/core/services/mining.test.js dist/core/services/anki-jimaku.test.js dist/core/services/jimaku-download-path.test.js dist/core/services/jellyfin.test.js dist/core/services/jellyfin-remote.test.js dist/core/services/immersion-tracker-service.test.js dist/core/services/overlay-runtime-init.test.js dist/core/services/app-ready.test.js dist/core/services/startup-bootstrap.test.js dist/core/services/subtitle-processing-controller.test.js dist/core/services/anilist/anilist-token-store.test.js dist/core/services/anilist/anilist-update-queue.test.js dist/renderer/error-recovery.test.js dist/renderer/subtitle-render.test.js dist/renderer/handlers/mouse.test.js dist/renderer/handlers/keyboard.test.js dist/renderer/modals/jimaku.test.js dist/subsync/utils.test.js dist/main/anilist-url-guard.test.js dist/window-trackers/x11-tracker.test.js",
     "test:core:smoke:dist": "bun test dist/cli/help.test.js dist/core/services/runtime-config.test.js dist/core/services/ipc.test.js dist/core/services/overlay-manager.test.js dist/core/services/anilist/anilist-token-store.test.js dist/core/services/startup-bootstrap.test.js dist/renderer/error-recovery.test.js dist/main/anilist-url-guard.test.js dist/window-trackers/x11-tracker.test.js",
     "test:smoke:dist": "bun run test:config:smoke:dist && bun run test:core:smoke:dist",
     "test:subtitle:src": "bun test src/core/services/subsync.test.ts src/subsync/utils.test.ts",
@@ -120,7 +117,7 @@
     ],
     "extraResources": [
       {
-        "from": "build/yomitan",
+        "from": "vendor/yomitan",
         "to": "yomitan"
       },
       {
@@ -131,14 +128,6 @@
         "from": "assets",
         "to": "assets"
       },
-      {
-        "from": "plugin/subminer",
-        "to": "plugin/subminer"
-      },
-      {
-        "from": "plugin/subminer.conf",
-        "to": "plugin/subminer.conf"
-      },
       {
         "from": "dist/scripts/get-mpv-window-macos",
         "to": "scripts/get-mpv-window-macos"

scripts/build-yomitan.mjs

@@ -1,144 +0,0 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { createHash } from 'node:crypto';
-import { execFileSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-
-const dirname = path.dirname(fileURLToPath(import.meta.url));
-const repoRoot = path.resolve(dirname, '..');
-const submoduleDir = path.join(repoRoot, 'vendor', 'subminer-yomitan');
-const submodulePackagePath = path.join(submoduleDir, 'package.json');
-const submodulePackageLockPath = path.join(submoduleDir, 'package-lock.json');
-const buildOutputDir = path.join(repoRoot, 'build', 'yomitan');
-const stampPath = path.join(buildOutputDir, '.subminer-build.json');
-const zipPath = path.join(submoduleDir, 'builds', 'yomitan-chrome.zip');
-const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-const dependencyStampPath = path.join(submoduleDir, 'node_modules', '.subminer-package-lock-hash');
-
-function run(command, args, cwd) {
-  execFileSync(command, args, { cwd, stdio: 'inherit' });
-}
-
-function readCommand(command, args, cwd) {
-  return execFileSync(command, args, { cwd, encoding: 'utf8' }).trim();
-}
-
-function readStamp() {
-  try {
-    return JSON.parse(fs.readFileSync(stampPath, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-function hashFile(filePath) {
-  const hash = createHash('sha256');
-  hash.update(fs.readFileSync(filePath));
-  return hash.digest('hex');
-}
-
-function ensureSubmodulePresent() {
-  if (!fs.existsSync(submodulePackagePath)) {
-    throw new Error(
-      'Missing vendor/subminer-yomitan submodule. Run `git submodule update --init --recursive`.',
-    );
-  }
-}
-
-function getSourceState() {
-  const revision = readCommand('git', ['rev-parse', 'HEAD'], submoduleDir);
-  const dirty = readCommand('git', ['status', '--short', '--untracked-files=no'], submoduleDir);
-  return { revision, dirty };
-}
-
-function isBuildCurrent(force) {
-  if (force) {
-    return false;
-  }
-  if (!fs.existsSync(path.join(buildOutputDir, 'manifest.json'))) {
-    return false;
-  }
-
-  const stamp = readStamp();
-  if (!stamp) {
-    return false;
-  }
-
-  const currentState = getSourceState();
-  return stamp.revision === currentState.revision && stamp.dirty === currentState.dirty;
-}
-
-function ensureDependenciesInstalled() {
-  const nodeModulesDir = path.join(submoduleDir, 'node_modules');
-  const currentLockHash = hashFile(submodulePackageLockPath);
-  let installedLockHash = '';
-  try {
-    installedLockHash = fs.readFileSync(dependencyStampPath, 'utf8').trim();
-  } catch {}
-
-  if (!fs.existsSync(nodeModulesDir) || installedLockHash !== currentLockHash) {
-    run(npmCommand, ['ci'], submoduleDir);
-    fs.mkdirSync(nodeModulesDir, { recursive: true });
-    fs.writeFileSync(dependencyStampPath, `${currentLockHash}\n`, 'utf8');
-  }
-}
-
-function installAndBuild() {
-  ensureDependenciesInstalled();
-  run(npmCommand, ['run', 'build', '--', '--target', 'chrome'], submoduleDir);
-}
-
-function extractBuild() {
-  if (!fs.existsSync(zipPath)) {
-    throw new Error(`Expected Yomitan build artifact at ${zipPath}`);
-  }
-
-  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'subminer-yomitan-'));
-  try {
-    run('unzip', ['-qo', zipPath, '-d', tempDir], repoRoot);
-    fs.rmSync(buildOutputDir, { recursive: true, force: true });
-    fs.mkdirSync(path.dirname(buildOutputDir), { recursive: true });
-    fs.cpSync(tempDir, buildOutputDir, { recursive: true });
-    if (!fs.existsSync(path.join(buildOutputDir, 'manifest.json'))) {
-      throw new Error(`Extracted Yomitan build missing manifest.json in ${buildOutputDir}`);
-    }
-  } finally {
-    fs.rmSync(tempDir, { recursive: true, force: true });
-  }
-}
-
-function writeStamp() {
-  const state = getSourceState();
-  fs.writeFileSync(
-    stampPath,
-    `${JSON.stringify(
-      {
-        revision: state.revision,
-        dirty: state.dirty,
-        builtAt: new Date().toISOString(),
-      },
-      null,
-      2,
-    )}\n`,
-    'utf8',
-  );
-}
-
-function main() {
-  const force = process.argv.includes('--force');
-  ensureSubmodulePresent();
-
-  if (isBuildCurrent(force)) {
-    process.stdout.write(`Yomitan build current: ${buildOutputDir}\n`);
-    return;
-  }
-
-  process.stdout.write('Building Yomitan Chrome artifact...\n');
-  installAndBuild();
-  extractBuild();
-  writeStamp();
-  process.stdout.write(`Yomitan extracted to ${buildOutputDir}\n`);
-}
-
-main();

scripts/get_frequency.ts

@@ -4,7 +4,6 @@ import process from 'node:process';
 
 import { createTokenizerDepsRuntime, tokenizeSubtitle } from '../src/core/services/tokenizer.js';
 import { createFrequencyDictionaryLookup } from '../src/core/services/frequency-dictionary.js';
-import { resolveYomitanExtensionPath as resolveBuiltYomitanExtensionPath } from '../src/core/services/yomitan-extension-paths.js';
 import { MecabTokenizer } from '../src/mecab-tokenizer.js';
 import type { MergedToken, FrequencyDictionaryLookup } from '../src/types.js';
 
@@ -95,7 +94,7 @@ function parseCliArgs(argv: string[]): CliOptions {
       if (!next) {
         throw new Error('Missing value for --yomitan-extension');
       }
-      yomitanExtensionPath = next;
+      yomitanExtensionPath = path.resolve(next);
       continue;
     }
 
@@ -104,7 +103,7 @@ function parseCliArgs(argv: string[]): CliOptions {
       if (!next) {
         throw new Error('Missing value for --yomitan-user-data');
       }
-      yomitanUserDataPath = next;
+      yomitanUserDataPath = path.resolve(next);
       continue;
     }
 
@@ -226,12 +225,12 @@ function parseCliArgs(argv: string[]): CliOptions {
     }
 
     if (arg.startsWith('--yomitan-extension=')) {
-      yomitanExtensionPath = arg.slice('--yomitan-extension='.length);
+      yomitanExtensionPath = path.resolve(arg.slice('--yomitan-extension='.length));
       continue;
     }
 
     if (arg.startsWith('--yomitan-user-data=')) {
-      yomitanUserDataPath = arg.slice('--yomitan-user-data='.length);
+      yomitanUserDataPath = path.resolve(arg.slice('--yomitan-user-data='.length));
       continue;
     }
 
@@ -525,10 +524,7 @@ function destroyUnknownParserWindow(window: unknown): void {
   }
 }
 
-async function createYomitanRuntimeState(
-  userDataPath: string,
-  extensionPath?: string,
-): Promise<YomitanRuntimeState> {
+async function createYomitanRuntimeState(userDataPath: string): Promise<YomitanRuntimeState> {
   const state: YomitanRuntimeState = {
     yomitanExt: null,
     parserWindow: null,
@@ -551,7 +547,6 @@ async function createYomitanRuntimeState(
     const loadYomitanExtension = (await import('../src/core/services/yomitan-extension-loader.js'))
       .loadYomitanExtension as (options: {
       userDataPath: string;
-      extensionPath?: string;
       getYomitanParserWindow: () => unknown;
       setYomitanParserWindow: (window: unknown) => void;
       setYomitanParserReadyPromise: (promise: Promise<void> | null) => void;
@@ -561,7 +556,6 @@ async function createYomitanRuntimeState(
 
     const extension = await loadYomitanExtension({
       userDataPath,
-      extensionPath,
       getYomitanParserWindow: () => state.parserWindow,
       setYomitanParserWindow: (window) => {
         state.parserWindow = window;
@@ -595,16 +589,17 @@ async function createYomitanRuntimeStateWithSearch(
   userDataPath: string,
   extensionPath?: string,
 ): Promise<YomitanRuntimeState> {
-  const resolvedExtensionPath = resolveBuiltYomitanExtensionPath({
-    explicitPath: extensionPath,
-    cwd: process.cwd(),
-  });
-  const candidates = resolvedExtensionPath ? [resolvedExtensionPath] : [];
+  const preferredPath = extensionPath ? path.resolve(extensionPath) : undefined;
+  const defaultVendorPath = path.resolve(process.cwd(), 'vendor', 'yomitan');
+  const candidates = [...(preferredPath ? [preferredPath] : []), defaultVendorPath];
 
   for (const candidate of candidates) {
+    if (!candidate) {
+      continue;
+    }
     try {
       if (fs.existsSync(path.join(candidate, 'manifest.json'))) {
-        const state = await createYomitanRuntimeState(userDataPath, candidate);
+        const state = await createYomitanRuntimeState(userDataPath);
         if (state.available) {
           return state;
         }
@@ -618,7 +613,7 @@ async function createYomitanRuntimeStateWithSearch(
     }
   }
 
-  return createYomitanRuntimeState(userDataPath, resolvedExtensionPath ?? undefined);
+  return createYomitanRuntimeState(userDataPath);
 }
 
 async function getFrequencyLookup(dictionaryPath: string): Promise<FrequencyDictionaryLookup> {

scripts/patch-yomitan.sh

@@ -1,16 +1,261 @@
 #!/bin/bash
+#
+# SubMiner - All-in-one sentence mining overlay
+# Copyright (C) 2024 sudacode
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+#
+# patch-yomitan.sh - Apply Electron compatibility patches to Yomitan
+#
+# This script applies the necessary patches to make Yomitan work in Electron
+# after upgrading to a new version. Run this after extracting a fresh Yomitan release.
+#
+# Usage: ./patch-yomitan.sh [yomitan_dir]
+#   yomitan_dir: Path to the Yomitan directory (default: vendor/yomitan)
+#
 
-set -euo pipefail
+set -e
 
-cat <<'EOF'
-patch-yomitan.sh is retired.
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+YOMITAN_DIR="${1:-$SCRIPT_DIR/../vendor/yomitan}"
 
-SubMiner now uses the forked source submodule at vendor/subminer-yomitan and builds the
-Chromium extension artifact into build/yomitan.
+if [ ! -d "$YOMITAN_DIR" ]; then
+    echo "Error: Yomitan directory not found: $YOMITAN_DIR"
+    exit 1
+fi
 
-Use:
-  git submodule update --init --recursive
-  bun run build:yomitan
+echo "Patching Yomitan in: $YOMITAN_DIR"
 
-If you need to change Electron compatibility behavior, patch the forked source repo and rebuild.
-EOF
+PERMISSIONS_UTIL="$YOMITAN_DIR/js/data/permissions-util.js"
+
+if [ ! -f "$PERMISSIONS_UTIL" ]; then
+    echo "Error: permissions-util.js not found at $PERMISSIONS_UTIL"
+    exit 1
+fi
+
+echo "Patching permissions-util.js..."
+
+if grep -q "Electron workaround" "$PERMISSIONS_UTIL"; then
+    echo "  - Already patched, skipping"
+else
+    cat > "$PERMISSIONS_UTIL.tmp" << 'PATCH_EOF'
+/*
+ * Copyright (C) 2023-2025  Yomitan Authors
+ * Copyright (C) 2021-2022  Yomichan Authors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import {getFieldMarkers} from './anki-util.js';
+
+/**
+ * This function returns whether an Anki field marker might require clipboard permissions.
+ * This is speculative and may not guarantee that the field marker actually does require the permission,
+ * as the custom handlebars template is not deeply inspected.
+ * @param {string} marker
+ * @returns {boolean}
+ */
+function ankiFieldMarkerMayUseClipboard(marker) {
+    switch (marker) {
+        case 'clipboard-image':
+        case 'clipboard-text':
+            return true;
+        default:
+            return false;
+    }
+}
+
+/**
+ * @param {chrome.permissions.Permissions} permissions
+ * @returns {Promise<boolean>}
+ */
+export function hasPermissions(permissions) {
+    return new Promise((resolve, reject) => {
+        chrome.permissions.contains(permissions, (result) => {
+            const e = chrome.runtime.lastError;
+            if (e) {
+                reject(new Error(e.message));
+            } else {
+                resolve(result);
+            }
+        });
+    });
+}
+
+/**
+ * @param {chrome.permissions.Permissions} permissions
+ * @param {boolean} shouldHave
+ * @returns {Promise<boolean>}
+ */
+export function setPermissionsGranted(permissions, shouldHave) {
+    return (
+        shouldHave ?
+        new Promise((resolve, reject) => {
+            chrome.permissions.request(permissions, (result) => {
+                const e = chrome.runtime.lastError;
+                if (e) {
+                    reject(new Error(e.message));
+                } else {
+                    resolve(result);
+                }
+            });
+        }) :
+        new Promise((resolve, reject) => {
+            chrome.permissions.remove(permissions, (result) => {
+                const e = chrome.runtime.lastError;
+                if (e) {
+                    reject(new Error(e.message));
+                } else {
+                    resolve(!result);
+                }
+            });
+        })
+    );
+}
+
+/**
+ * @returns {Promise<chrome.permissions.Permissions>}
+ */
+export function getAllPermissions() {
+    // Electron workaround - chrome.permissions.getAll() not available
+    return Promise.resolve({
+        origins: ["<all_urls>"],
+        permissions: ["clipboardWrite", "storage", "unlimitedStorage", "scripting", "contextMenus"]
+    });
+}
+
+/**
+ * @param {string} fieldValue
+ * @returns {string[]}
+ */
+export function getRequiredPermissionsForAnkiFieldValue(fieldValue) {
+    const markers = getFieldMarkers(fieldValue);
+    for (const marker of markers) {
+        if (ankiFieldMarkerMayUseClipboard(marker)) {
+            return ['clipboardRead'];
+        }
+    }
+    return [];
+}
+
+/**
+ * @param {chrome.permissions.Permissions} permissions
+ * @param {import('settings').ProfileOptions} options
+ * @returns {boolean}
+ */
+export function hasRequiredPermissionsForOptions(permissions, options) {
+    const permissionsSet = new Set(permissions.permissions);
+
+    if (!permissionsSet.has('nativeMessaging') && (options.parsing.enableMecabParser || options.general.enableYomitanApi)) {
+        return false;
+    }
+
+    if (!permissionsSet.has('clipboardRead')) {
+        if (options.clipboard.enableBackgroundMonitor || options.clipboard.enableSearchPageMonitor) {
+            return false;
+        }
+        const fieldsList = options.anki.cardFormats.map((cardFormat) => cardFormat.fields);
+
+        for (const fields of fieldsList) {
+            for (const {value: fieldValue} of Object.values(fields)) {
+                const markers = getFieldMarkers(fieldValue);
+                for (const marker of markers) {
+                    if (ankiFieldMarkerMayUseClipboard(marker)) {
+                        return false;
+                    }
+                }
+            }
+        }
+    }
+
+    return true;
+}
+PATCH_EOF
+
+    mv "$PERMISSIONS_UTIL.tmp" "$PERMISSIONS_UTIL"
+    echo "  - Patched successfully"
+fi
+
+OPTIONS_SCHEMA="$YOMITAN_DIR/data/schemas/options-schema.json"
+
+if [ ! -f "$OPTIONS_SCHEMA" ]; then
+    echo "Error: options-schema.json not found at $OPTIONS_SCHEMA"
+    exit 1
+fi
+
+echo "Patching options-schema.json..."
+
+if grep -q '"selectText".*"default": true' "$OPTIONS_SCHEMA"; then
+    sed -i '/"selectText": {/,/"default":/{s/"default": true/"default": false/}' "$OPTIONS_SCHEMA"
+    echo "  - Changed selectText default to false"
+elif grep -q '"selectText".*"default": false' "$OPTIONS_SCHEMA"; then
+    echo "  - selectText already set to false, skipping"
+else
+    echo "  - Warning: Could not find selectText setting"
+fi
+
+if grep -q '"layoutAwareScan".*"default": true' "$OPTIONS_SCHEMA"; then
+    sed -i '/"layoutAwareScan": {/,/"default":/{s/"default": true/"default": false/}' "$OPTIONS_SCHEMA"
+    echo "  - Changed layoutAwareScan default to false"
+elif grep -q '"layoutAwareScan".*"default": false' "$OPTIONS_SCHEMA"; then
+    echo "  - layoutAwareScan already set to false, skipping"
+else
+    echo "  - Warning: Could not find layoutAwareScan setting"
+fi
+
+POPUP_JS="$YOMITAN_DIR/js/app/popup.js"
+
+if [ ! -f "$POPUP_JS" ]; then
+    echo "Error: popup.js not found at $POPUP_JS"
+    exit 1
+fi
+
+echo "Patching popup.js..."
+
+if grep -q "yomitan-popup-shown" "$POPUP_JS"; then
+    echo "  - Already patched, skipping"
+else
+    # Add the visibility event dispatch after the existing _onVisibleChange code
+    # We need to add it after: void this._invokeSafe('displayVisibilityChanged', {value});
+    sed -i "/void this._invokeSafe('displayVisibilityChanged', {value});/a\\
+\\
+        // Dispatch custom events for popup visibility (Electron integration)\\
+        if (value) {\\
+            window.dispatchEvent(new CustomEvent('yomitan-popup-shown'));\\
+        } else {\\
+            window.dispatchEvent(new CustomEvent('yomitan-popup-hidden'));\\
+        }" "$POPUP_JS"
+    echo "  - Added visibility events"
+fi
+
+echo ""
+echo "Yomitan patching complete!"
+echo ""
+echo "Changes applied:"
+echo "  1. permissions-util.js: Hardcoded permissions (Electron workaround)"
+echo "  2. options-schema.json: selectText=false, layoutAwareScan=false"
+echo "  3. popup.js: Added yomitan-popup-shown/hidden events"
+echo ""
+echo "To verify: Run 'bun run dev' and check for 'Yomitan extension loaded successfully'"

scripts/prettier-scope.sh

@@ -1,20 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-cd "$ROOT_DIR"
-
-paths=(
-  "package.json"
-  "tsconfig.json"
-  "tsconfig.renderer.json"
-  "tsconfig.typecheck.json"
-  ".prettierrc.json"
-  ".github"
-  "build"
-  "launcher"
-  "scripts"
-  "src"
-)
-
-exec bunx prettier "$@" "${paths[@]}"

scripts/test-yomitan-parser.ts

@@ -4,7 +4,6 @@ import path from 'node:path';
 import process from 'node:process';
 
 import { createTokenizerDepsRuntime, tokenizeSubtitle } from '../src/core/services/tokenizer.js';
-import { resolveYomitanExtensionPath as resolveBuiltYomitanExtensionPath } from '../src/core/services/yomitan-extension-paths.js';
 import { MecabTokenizer } from '../src/mecab-tokenizer.js';
 import type { MergedToken } from '../src/types.js';
 
@@ -113,12 +112,12 @@ function parseCliArgs(argv: string[]): CliOptions {
       if (!next) {
         throw new Error('Missing value for --yomitan-extension');
       }
-      yomitanExtensionPath = next;
+      yomitanExtensionPath = path.resolve(next);
       continue;
     }
 
     if (arg.startsWith('--yomitan-extension=')) {
-      yomitanExtensionPath = arg.slice('--yomitan-extension='.length);
+      yomitanExtensionPath = path.resolve(arg.slice('--yomitan-extension='.length));
       continue;
     }
 
@@ -127,12 +126,12 @@ function parseCliArgs(argv: string[]): CliOptions {
       if (!next) {
         throw new Error('Missing value for --yomitan-user-data');
       }
-      yomitanUserDataPath = next;
+      yomitanUserDataPath = path.resolve(next);
       continue;
     }
 
     if (arg.startsWith('--yomitan-user-data=')) {
-      yomitanUserDataPath = arg.slice('--yomitan-user-data='.length);
+      yomitanUserDataPath = path.resolve(arg.slice('--yomitan-user-data='.length));
       continue;
     }
 
@@ -373,10 +372,21 @@ function findSelectedCandidateIndexes(
 }
 
 function resolveYomitanExtensionPath(explicitPath?: string): string | null {
-  return resolveBuiltYomitanExtensionPath({
-    explicitPath,
-    cwd: process.cwd(),
-  });
+  const candidates = [
+    explicitPath ? path.resolve(explicitPath) : null,
+    path.resolve(process.cwd(), 'vendor', 'yomitan'),
+  ];
+
+  for (const candidate of candidates) {
+    if (!candidate) {
+      continue;
+    }
+    if (fs.existsSync(path.join(candidate, 'manifest.json'))) {
+      return candidate;
+    }
+  }
+
+  return null;
 }
 
 async function setupYomitanRuntime(options: CliOptions): Promise<YomitanRuntimeState> {
@@ -410,7 +420,7 @@ async function setupYomitanRuntime(options: CliOptions): Promise<YomitanRuntimeS
 
   const extensionPath = resolveYomitanExtensionPath(options.yomitanExtensionPath);
   if (!extensionPath) {
-    state.note = 'no built Yomitan extension directory found; run `bun run build:yomitan`';
+    state.note = 'no Yomitan extension directory found';
     return state;
   }
 

src/anki-integration/runtime.test.ts

@@ -55,10 +55,7 @@ test('AnkiIntegrationRuntime normalizes url and proxy defaults', () => {
   assert.equal(normalized.proxy?.host, '0.0.0.0');
   assert.equal(normalized.proxy?.port, 7001);
   assert.equal(normalized.proxy?.upstreamUrl, 'http://anki.local:8765');
-  assert.equal(
-    normalized.media?.fallbackDuration,
-    DEFAULT_ANKI_CONNECT_CONFIG.media.fallbackDuration,
-  );
+  assert.equal(normalized.media?.fallbackDuration, DEFAULT_ANKI_CONNECT_CONFIG.media.fallbackDuration);
 });
 
 test('AnkiIntegrationRuntime starts proxy transport when proxy mode is enabled', () => {
@@ -73,7 +70,10 @@ test('AnkiIntegrationRuntime starts proxy transport when proxy mode is enabled',
 
   runtime.start();
 
-  assert.deepEqual(calls, ['known:start', 'proxy:start:127.0.0.1:9999:http://upstream:8765']);
+  assert.deepEqual(calls, [
+    'known:start',
+    'proxy:start:127.0.0.1:9999:http://upstream:8765',
+  ]);
 });
 
 test('AnkiIntegrationRuntime switches transports and clears known words when runtime patch disables highlighting', () => {

src/anki-integration/runtime.ts

@@ -31,7 +31,8 @@ function trimToNonEmptyString(value: unknown): string | null {
 }
 
 export function normalizeAnkiIntegrationConfig(config: AnkiConnectConfig): AnkiConnectConfig {
-  const resolvedUrl = trimToNonEmptyString(config.url) ?? DEFAULT_ANKI_CONNECT_CONFIG.url;
+  const resolvedUrl =
+    trimToNonEmptyString(config.url) ?? DEFAULT_ANKI_CONNECT_CONFIG.url;
   const proxySource =
     config.proxy && typeof config.proxy === 'object'
       ? (config.proxy as NonNullable<AnkiConnectConfig['proxy']>)

src/cli/args.test.ts

@@ -169,9 +169,4 @@ test('hasExplicitCommand and shouldStartApp preserve command intent', () => {
   assert.equal(background.background, true);
   assert.equal(hasExplicitCommand(background), true);
   assert.equal(shouldStartApp(background), true);
-
-  const setup = parseArgs(['--setup']);
-  assert.equal((setup as typeof setup & { setup?: boolean }).setup, true);
-  assert.equal(hasExplicitCommand(setup), true);
-  assert.equal(shouldStartApp(setup), true);
 });

src/cli/args.ts

@@ -5,7 +5,6 @@ export interface CliArgs {
   toggle: boolean;
   toggleVisibleOverlay: boolean;
   settings: boolean;
-  setup: boolean;
   show: boolean;
   hide: boolean;
   showVisibleOverlay: boolean;
@@ -72,7 +71,6 @@ export function parseArgs(argv: string[]): CliArgs {
     toggle: false,
     toggleVisibleOverlay: false,
     settings: false,
-    setup: false,
     show: false,
     hide: false,
     showVisibleOverlay: false,
@@ -127,7 +125,6 @@ export function parseArgs(argv: string[]): CliArgs {
     else if (arg === '--toggle') args.toggle = true;
     else if (arg === '--toggle-visible-overlay') args.toggleVisibleOverlay = true;
     else if (arg === '--settings' || arg === '--yomitan') args.settings = true;
-    else if (arg === '--setup') args.setup = true;
     else if (arg === '--show') args.show = true;
     else if (arg === '--hide') args.hide = true;
     else if (arg === '--show-visible-overlay') args.showVisibleOverlay = true;
@@ -301,7 +298,6 @@ export function hasExplicitCommand(args: CliArgs): boolean {
     args.toggle ||
     args.toggleVisibleOverlay ||
     args.settings ||
-    args.setup ||
     args.show ||
     args.hide ||
     args.showVisibleOverlay ||
@@ -345,7 +341,6 @@ export function shouldStartApp(args: CliArgs): boolean {
     args.toggle ||
     args.toggleVisibleOverlay ||
     args.settings ||
-    args.setup ||
     args.copySubtitle ||
     args.copySubtitleMultiple ||
     args.mineSentence ||
@@ -376,7 +371,6 @@ export function shouldRunSettingsOnlyStartup(args: CliArgs): boolean {
     !args.toggleVisibleOverlay &&
     !args.show &&
     !args.hide &&
-    !args.setup &&
     !args.showVisibleOverlay &&
     !args.hideVisibleOverlay &&
     !args.copySubtitle &&

src/cli/help.test.ts

@@ -18,7 +18,6 @@ test('printHelp includes configured texthooker port', () => {
   assert.match(output, /--help\s+Show this help/);
   assert.match(output, /default: 7777/);
   assert.match(output, /--refresh-known-words/);
-  assert.match(output, /--setup\s+Open first-run setup window/);
   assert.match(output, /--anilist-status/);
   assert.match(output, /--anilist-retry-queue/);
   assert.match(output, /--dictionary/);

src/cli/help.ts

@@ -20,7 +20,6 @@ ${B}Overlay${R}
   --show-visible-overlay         Show subtitle overlay
   --hide-visible-overlay         Hide subtitle overlay
   --settings                     Open Yomitan settings window
-  --setup                        Open first-run setup window
   --auto-start-overlay           Auto-hide mpv subs, show overlay on connect
 
 ${B}Mining${R}

src/config/config.test.ts

@@ -16,9 +16,6 @@ test('loads defaults when config is missing', () => {
   const service = new ConfigService(dir);
   const config = service.getConfig();
   assert.equal(config.websocket.port, DEFAULT_CONFIG.websocket.port);
-  assert.equal(config.annotationWebsocket.enabled, DEFAULT_CONFIG.annotationWebsocket.enabled);
-  assert.equal(config.annotationWebsocket.port, DEFAULT_CONFIG.annotationWebsocket.port);
-  assert.equal(config.texthooker.launchAtStartup, true);
   assert.equal(config.ankiConnect.behavior.autoUpdateNewCards, true);
   assert.deepEqual(config.ankiConnect.tags, ['SubMiner']);
   assert.equal(config.anilist.enabled, false);
@@ -27,9 +24,6 @@ test('loads defaults when config is missing', () => {
   assert.equal(config.anilist.characterDictionary.maxLoaded, 3);
   assert.equal(config.anilist.characterDictionary.evictionPolicy, 'delete');
   assert.equal(config.anilist.characterDictionary.profileScope, 'all');
-  assert.equal(config.anilist.characterDictionary.collapsibleSections.description, false);
-  assert.equal(config.anilist.characterDictionary.collapsibleSections.characterInformation, false);
-  assert.equal(config.anilist.characterDictionary.collapsibleSections.voicedBy, false);
   assert.equal(config.jellyfin.remoteControlEnabled, true);
   assert.equal(config.jellyfin.remoteControlAutoConnect, true);
   assert.equal(config.jellyfin.autoAnnounce, false);
@@ -134,88 +128,6 @@ test('parses subtitleStyle.preserveLineBreaks and warns on invalid values', () =
   );
 });
 
-test('parses texthooker.launchAtStartup and warns on invalid values', () => {
-  const validDir = makeTempDir();
-  fs.writeFileSync(
-    path.join(validDir, 'config.jsonc'),
-    `{
-      "texthooker": {
-        "launchAtStartup": false
-      }
-    }`,
-    'utf-8',
-  );
-
-  const validService = new ConfigService(validDir);
-  assert.equal(validService.getConfig().texthooker.launchAtStartup, false);
-
-  const invalidDir = makeTempDir();
-  fs.writeFileSync(
-    path.join(invalidDir, 'config.jsonc'),
-    `{
-      "texthooker": {
-        "launchAtStartup": "yes"
-      }
-    }`,
-    'utf-8',
-  );
-
-  const invalidService = new ConfigService(invalidDir);
-  assert.equal(
-    invalidService.getConfig().texthooker.launchAtStartup,
-    DEFAULT_CONFIG.texthooker.launchAtStartup,
-  );
-  assert.ok(
-    invalidService.getWarnings().some((warning) => warning.path === 'texthooker.launchAtStartup'),
-  );
-});
-
-test('parses annotationWebsocket settings and warns on invalid values', () => {
-  const validDir = makeTempDir();
-  fs.writeFileSync(
-    path.join(validDir, 'config.jsonc'),
-    `{
-      "annotationWebsocket": {
-        "enabled": false,
-        "port": 7788
-      }
-    }`,
-    'utf-8',
-  );
-
-  const validService = new ConfigService(validDir);
-  assert.equal(validService.getConfig().annotationWebsocket.enabled, false);
-  assert.equal(validService.getConfig().annotationWebsocket.port, 7788);
-
-  const invalidDir = makeTempDir();
-  fs.writeFileSync(
-    path.join(invalidDir, 'config.jsonc'),
-    `{
-      "annotationWebsocket": {
-        "enabled": "yes",
-        "port": "bad"
-      }
-    }`,
-    'utf-8',
-  );
-
-  const invalidService = new ConfigService(invalidDir);
-  assert.equal(
-    invalidService.getConfig().annotationWebsocket.enabled,
-    DEFAULT_CONFIG.annotationWebsocket.enabled,
-  );
-  assert.equal(
-    invalidService.getConfig().annotationWebsocket.port,
-    DEFAULT_CONFIG.annotationWebsocket.port,
-  );
-  assert.ok(
-    invalidService.getWarnings().some((warning) => warning.path === 'annotationWebsocket.enabled'),
-  );
-  assert.ok(
-    invalidService.getWarnings().some((warning) => warning.path === 'annotationWebsocket.port'),
-  );
-});
-
 test('parses subtitleStyle.autoPauseVideoOnHover and warns on invalid values', () => {
   const validDir = makeTempDir();
   fs.writeFileSync(
@@ -344,8 +256,8 @@ test('parses subtitleStyle.nameMatchColor and warns on invalid values', () => {
 
   const validService = new ConfigService(validDir);
   assert.equal(
-    ((validService.getConfig().subtitleStyle as unknown as Record<string, unknown>)
-      .nameMatchColor ?? null) as string | null,
+    ((validService.getConfig().subtitleStyle as unknown as Record<string, unknown>).nameMatchColor ??
+      null) as string | null,
     '#eed49f',
   );
 
@@ -367,7 +279,9 @@ test('parses subtitleStyle.nameMatchColor and warns on invalid values', () => {
     '#f5bde6',
   );
   assert.ok(
-    invalidService.getWarnings().some((warning) => warning.path === 'subtitleStyle.nameMatchColor'),
+    invalidService
+      .getWarnings()
+      .some((warning) => warning.path === 'subtitleStyle.nameMatchColor'),
   );
 });
 
@@ -497,49 +411,10 @@ test('parses anilist.characterDictionary config with clamping and enum validatio
   assert.equal(config.anilist.characterDictionary.maxLoaded, 20);
   assert.equal(config.anilist.characterDictionary.evictionPolicy, 'delete');
   assert.equal(config.anilist.characterDictionary.profileScope, 'all');
-  assert.ok(
-    warnings.some((warning) => warning.path === 'anilist.characterDictionary.refreshTtlHours'),
-  );
+  assert.ok(warnings.some((warning) => warning.path === 'anilist.characterDictionary.refreshTtlHours'));
   assert.ok(warnings.some((warning) => warning.path === 'anilist.characterDictionary.maxLoaded'));
-  assert.ok(
-    warnings.some((warning) => warning.path === 'anilist.characterDictionary.evictionPolicy'),
-  );
-  assert.ok(
-    warnings.some((warning) => warning.path === 'anilist.characterDictionary.profileScope'),
-  );
-});
-
-test('parses anilist.characterDictionary.collapsibleSections booleans and warns on invalid values', () => {
-  const dir = makeTempDir();
-  fs.writeFileSync(
-    path.join(dir, 'config.jsonc'),
-    `{
-      "anilist": {
-        "characterDictionary": {
-          "collapsibleSections": {
-            "description": true,
-            "characterInformation": "yes",
-            "voicedBy": true
-          }
-        }
-      }
-    }`,
-    'utf-8',
-  );
-
-  const service = new ConfigService(dir);
-  const config = service.getConfig();
-  const warnings = service.getWarnings();
-
-  assert.equal(config.anilist.characterDictionary.collapsibleSections.description, true);
-  assert.equal(config.anilist.characterDictionary.collapsibleSections.characterInformation, false);
-  assert.equal(config.anilist.characterDictionary.collapsibleSections.voicedBy, true);
-  assert.ok(
-    warnings.some(
-      (warning) =>
-        warning.path === 'anilist.characterDictionary.collapsibleSections.characterInformation',
-    ),
-  );
+  assert.ok(warnings.some((warning) => warning.path === 'anilist.characterDictionary.evictionPolicy'));
+  assert.ok(warnings.some((warning) => warning.path === 'anilist.characterDictionary.profileScope'));
 });
 
 test('parses jellyfin remote control fields', () => {
@@ -965,10 +840,6 @@ test('warning emission order is deterministic across reloads', () => {
         "enabled": "sometimes",
         "port": -1
       },
-      "annotationWebsocket": {
-        "enabled": "sometimes",
-        "port": -1
-      },
       "logging": {
         "level": "trace"
       }
@@ -985,14 +856,7 @@ test('warning emission order is deterministic across reloads', () => {
   assert.deepEqual(secondWarnings, firstWarnings);
   assert.deepEqual(
     firstWarnings.map((warning) => warning.path),
-    [
-      'unknownFeature',
-      'websocket.enabled',
-      'websocket.port',
-      'annotationWebsocket.enabled',
-      'annotationWebsocket.port',
-      'logging.level',
-    ],
+    ['unknownFeature', 'websocket.enabled', 'websocket.port', 'logging.level'],
   );
 });
 
@@ -1562,17 +1426,8 @@ test('template generator includes known keys', () => {
     output,
     /"enabled": "auto",? \/\/ Built-in subtitle websocket server mode\. Values: auto \| true \| false/,
   );
-  assert.match(
-    output,
-    /"enabled": true,? \/\/ Annotated subtitle websocket server enabled state\. Values: true \| false/,
-  );
-  assert.match(output, /"port": 6678,? \/\/ Annotated subtitle websocket server port\./);
   assert.match(
     output,
     /"enabled": false,? \/\/ Enable AnkiConnect integration\. Values: true \| false/,
   );
-  assert.match(
-    output,
-    /"launchAtStartup": true,? \/\/ Launch texthooker server automatically when SubMiner starts\. Values: true \| false/,
-  );
 });

src/config/definitions.ts

@@ -22,7 +22,6 @@ const {
   subtitlePosition,
   keybindings,
   websocket,
-  annotationWebsocket,
   logging,
   texthooker,
   shortcuts,
@@ -40,7 +39,6 @@ export const DEFAULT_CONFIG: ResolvedConfig = {
   subtitlePosition,
   keybindings,
   websocket,
-  annotationWebsocket,
   logging,
   texthooker,
   ankiConnect,

src/config/definitions/defaults-core.ts

@@ -5,7 +5,6 @@ export const CORE_DEFAULT_CONFIG: Pick<
   | 'subtitlePosition'
   | 'keybindings'
   | 'websocket'
-  | 'annotationWebsocket'
   | 'logging'
   | 'texthooker'
   | 'shortcuts'
@@ -20,15 +19,10 @@ export const CORE_DEFAULT_CONFIG: Pick<
     enabled: 'auto',
     port: 6677,
   },
-  annotationWebsocket: {
-    enabled: true,
-    port: 6678,
-  },
   logging: {
     level: 'info',
   },
   texthooker: {
-    launchAtStartup: true,
     openBrowser: true,
   },
   shortcuts: {

src/config/definitions/defaults-integrations.ts

@@ -92,11 +92,6 @@ export const INTEGRATIONS_DEFAULT_CONFIG: Pick<
       maxLoaded: 3,
       evictionPolicy: 'delete',
       profileScope: 'all',
-      collapsibleSections: {
-        description: false,
-        characterInformation: false,
-        voicedBy: false,
-      },
     },
   },
   jellyfin: {

src/config/definitions/domain-registry.test.ts

@@ -18,13 +18,11 @@ test('config option registry includes critical paths and has unique entries', ()
 
   for (const requiredPath of [
     'logging.level',
-    'annotationWebsocket.enabled',
     'startupWarmups.lowPowerMode',
     'subtitleStyle.enableJlpt',
     'subtitleStyle.autoPauseVideoOnYomitanPopup',
     'ankiConnect.enabled',
     'anilist.characterDictionary.enabled',
-    'anilist.characterDictionary.collapsibleSections.description',
     'immersionTracking.enabled',
   ]) {
     assert.ok(paths.includes(requiredPath), `missing config path: ${requiredPath}`);
@@ -37,7 +35,6 @@ test('config template sections include expected domains and unique keys', () =>
   const keys = CONFIG_TEMPLATE_SECTIONS.map((section) => section.key);
   const requiredKeys: (typeof keys)[number][] = [
     'websocket',
-    'annotationWebsocket',
     'startupWarmups',
     'subtitleStyle',
     'ankiConnect',

src/config/definitions/options-core.ts

@@ -12,12 +12,6 @@ export function buildCoreConfigOptionRegistry(
       defaultValue: defaultConfig.logging.level,
       description: 'Minimum log level for runtime logging.',
     },
-    {
-      path: 'texthooker.launchAtStartup',
-      kind: 'boolean',
-      defaultValue: defaultConfig.texthooker.launchAtStartup,
-      description: 'Launch texthooker server automatically when SubMiner starts.',
-    },
     {
       path: 'websocket.enabled',
       kind: 'enum',
@@ -31,18 +25,6 @@ export function buildCoreConfigOptionRegistry(
       defaultValue: defaultConfig.websocket.port,
       description: 'Built-in subtitle websocket server port.',
     },
-    {
-      path: 'annotationWebsocket.enabled',
-      kind: 'boolean',
-      defaultValue: defaultConfig.annotationWebsocket.enabled,
-      description: 'Annotated subtitle websocket server enabled state.',
-    },
-    {
-      path: 'annotationWebsocket.port',
-      kind: 'number',
-      defaultValue: defaultConfig.annotationWebsocket.port,
-      description: 'Annotated subtitle websocket server port.',
-    },
     {
       path: 'subsync.defaultMode',
       kind: 'enum',

src/config/definitions/options-integrations.ts

@@ -171,28 +171,6 @@ export function buildIntegrationConfigOptionRegistry(
       defaultValue: defaultConfig.anilist.characterDictionary.profileScope,
       description: 'Yomitan profile scope for dictionary enable/disable updates.',
     },
-    {
-      path: 'anilist.characterDictionary.collapsibleSections.description',
-      kind: 'boolean',
-      defaultValue: defaultConfig.anilist.characterDictionary.collapsibleSections.description,
-      description:
-        'Open the Description section by default in character dictionary glossary entries.',
-    },
-    {
-      path: 'anilist.characterDictionary.collapsibleSections.characterInformation',
-      kind: 'boolean',
-      defaultValue:
-        defaultConfig.anilist.characterDictionary.collapsibleSections.characterInformation,
-      description:
-        'Open the Character Information section by default in character dictionary glossary entries.',
-    },
-    {
-      path: 'anilist.characterDictionary.collapsibleSections.voicedBy',
-      kind: 'boolean',
-      defaultValue: defaultConfig.anilist.characterDictionary.collapsibleSections.voicedBy,
-      description:
-        'Open the Voiced by section by default in character dictionary glossary entries.',
-    },
     {
       path: 'jellyfin.enabled',
       kind: 'boolean',

src/config/definitions/template-sections.ts

@@ -10,7 +10,7 @@ const CORE_TEMPLATE_SECTIONS: ConfigTemplateSection[] = [
   },
   {
     title: 'Texthooker Server',
-    description: ['Configure texthooker startup launch and browser opening behavior.'],
+    description: ['Control whether browser opens automatically for texthooker.'],
     key: 'texthooker',
   },
   {
@@ -21,14 +21,6 @@ const CORE_TEMPLATE_SECTIONS: ConfigTemplateSection[] = [
     ],
     key: 'websocket',
   },
-  {
-    title: 'Annotation WebSocket',
-    description: [
-      'Dedicated annotated subtitle websocket for bundled texthooker and token-aware clients.',
-      'Independent from websocket.auto and defaults to port 6678.',
-    ],
-    key: 'annotationWebsocket',
-  },
   {
     title: 'Logging',
     description: ['Controls logging verbosity.', 'Set to debug for full runtime diagnostics.'],

src/config/resolve/core-domains.ts

@@ -5,18 +5,6 @@ export function applyCoreDomainConfig(context: ResolveContext): void {
   const { src, resolved, warn } = context;
 
   if (isObject(src.texthooker)) {
-    const launchAtStartup = asBoolean(src.texthooker.launchAtStartup);
-    if (launchAtStartup !== undefined) {
-      resolved.texthooker.launchAtStartup = launchAtStartup;
-    } else if (src.texthooker.launchAtStartup !== undefined) {
-      warn(
-        'texthooker.launchAtStartup',
-        src.texthooker.launchAtStartup,
-        resolved.texthooker.launchAtStartup,
-        'Expected boolean.',
-      );
-    }
-
     const openBrowser = asBoolean(src.texthooker.openBrowser);
     if (openBrowser !== undefined) {
       resolved.texthooker.openBrowser = openBrowser;
@@ -56,32 +44,6 @@ export function applyCoreDomainConfig(context: ResolveContext): void {
     }
   }
 
-  if (isObject(src.annotationWebsocket)) {
-    const enabled = asBoolean(src.annotationWebsocket.enabled);
-    if (enabled !== undefined) {
-      resolved.annotationWebsocket.enabled = enabled;
-    } else if (src.annotationWebsocket.enabled !== undefined) {
-      warn(
-        'annotationWebsocket.enabled',
-        src.annotationWebsocket.enabled,
-        resolved.annotationWebsocket.enabled,
-        'Expected boolean.',
-      );
-    }
-
-    const port = asNumber(src.annotationWebsocket.port);
-    if (port !== undefined && port > 0 && port <= 65535) {
-      resolved.annotationWebsocket.port = Math.floor(port);
-    } else if (src.annotationWebsocket.port !== undefined) {
-      warn(
-        'annotationWebsocket.port',
-        src.annotationWebsocket.port,
-        resolved.annotationWebsocket.port,
-        'Expected integer between 1 and 65535.',
-      );
-    }
-  }
-
   if (isObject(src.logging)) {
     const logLevel = asString(src.logging.level);
     if (

src/config/resolve/integrations.ts

@@ -124,31 +124,6 @@ export function applyIntegrationConfig(context: ResolveContext): void {
           'Expected string.',
         );
       }
-
-      if (isObject(characterDictionary.collapsibleSections)) {
-        const collapsibleSections = characterDictionary.collapsibleSections;
-        const keys = ['description', 'characterInformation', 'voicedBy'] as const;
-        for (const key of keys) {
-          const value = asBoolean(collapsibleSections[key]);
-          if (value !== undefined) {
-            resolved.anilist.characterDictionary.collapsibleSections[key] = value;
-          } else if (collapsibleSections[key] !== undefined) {
-            warn(
-              `anilist.characterDictionary.collapsibleSections.${key}`,
-              collapsibleSections[key],
-              resolved.anilist.characterDictionary.collapsibleSections[key],
-              'Expected boolean.',
-            );
-          }
-        }
-      } else if (characterDictionary.collapsibleSections !== undefined) {
-        warn(
-          'anilist.characterDictionary.collapsibleSections',
-          characterDictionary.collapsibleSections,
-          resolved.anilist.characterDictionary.collapsibleSections,
-          'Expected object.',
-        );
-      }
     } else if (src.anilist.characterDictionary !== undefined) {
       warn(
         'anilist.characterDictionary',

src/config/resolve/jellyfin.test.ts

@@ -72,11 +72,6 @@ test('anilist character dictionary fields are parsed, clamped, and enum-validate
         maxLoaded: 99,
         evictionPolicy: 'purge' as never,
         profileScope: 'global' as never,
-        collapsibleSections: {
-          description: true,
-          characterInformation: 'invalid' as never,
-          voicedBy: true,
-        } as never,
       },
     },
   });
@@ -88,19 +83,10 @@ test('anilist character dictionary fields are parsed, clamped, and enum-validate
   assert.equal(context.resolved.anilist.characterDictionary.maxLoaded, 20);
   assert.equal(context.resolved.anilist.characterDictionary.evictionPolicy, 'delete');
   assert.equal(context.resolved.anilist.characterDictionary.profileScope, 'all');
-  assert.equal(context.resolved.anilist.characterDictionary.collapsibleSections.description, true);
-  assert.equal(
-    context.resolved.anilist.characterDictionary.collapsibleSections.characterInformation,
-    false,
-  );
-  assert.equal(context.resolved.anilist.characterDictionary.collapsibleSections.voicedBy, true);
 
   const warnedPaths = warnings.map((warning) => warning.path);
   assert.ok(warnedPaths.includes('anilist.characterDictionary.refreshTtlHours'));
   assert.ok(warnedPaths.includes('anilist.characterDictionary.maxLoaded'));
   assert.ok(warnedPaths.includes('anilist.characterDictionary.evictionPolicy'));
   assert.ok(warnedPaths.includes('anilist.characterDictionary.profileScope'));
-  assert.ok(
-    warnedPaths.includes('anilist.characterDictionary.collapsibleSections.characterInformation'),
-  );
 });

src/config/resolve/subtitle-domains.ts

@@ -238,9 +238,7 @@ export function applySubtitleDomainConfig(context: ResolveContext): void {
     );
     if (nameMatchEnabled !== undefined) {
       resolved.subtitleStyle.nameMatchEnabled = nameMatchEnabled;
-    } else if (
-      (src.subtitleStyle as { nameMatchEnabled?: unknown }).nameMatchEnabled !== undefined
-    ) {
+    } else if ((src.subtitleStyle as { nameMatchEnabled?: unknown }).nameMatchEnabled !== undefined) {
       resolved.subtitleStyle.nameMatchEnabled = fallbackSubtitleStyleNameMatchEnabled;
       warn(
         'subtitleStyle.nameMatchEnabled',

src/core/services/app-lifecycle.test.ts

@@ -11,7 +11,6 @@ function makeArgs(overrides: Partial<CliArgs> = {}): CliArgs {
     toggle: false,
     toggleVisibleOverlay: false,
     settings: false,
-    setup: false,
     show: false,
     hide: false,
     showVisibleOverlay: false,

src/core/services/app-ready.test.ts

@@ -4,8 +4,7 @@ import { AppReadyRuntimeDeps, runAppReadyRuntime } from './startup';
 
 function makeDeps(overrides: Partial<AppReadyRuntimeDeps> = {}) {
   const calls: string[] = [];
-  const deps = {
-    ensureDefaultConfigBootstrap: () => calls.push('ensureDefaultConfigBootstrap'),
+  const deps: AppReadyRuntimeDeps = {
     loadSubtitlePosition: () => calls.push('loadSubtitlePosition'),
     resolveKeybindings: () => calls.push('resolveKeybindings'),
     createMpvClient: () => calls.push('createMpvClient'),
@@ -21,13 +20,8 @@ function makeDeps(overrides: Partial<AppReadyRuntimeDeps> = {}) {
     setSecondarySubMode: (mode) => calls.push(`setSecondarySubMode:${mode}`),
     defaultSecondarySubMode: 'hover',
     defaultWebsocketPort: 9001,
-    defaultAnnotationWebsocketPort: 6678,
-    defaultTexthookerPort: 5174,
     hasMpvWebsocketPlugin: () => true,
     startSubtitleWebsocket: (port) => calls.push(`startSubtitleWebsocket:${port}`),
-    startAnnotationWebsocket: (port) => calls.push(`startAnnotationWebsocket:${port}`),
-    startTexthooker: (port, websocketUrl) =>
-      calls.push(`startTexthooker:${port}:${websocketUrl ?? ''}`),
     log: (message) => calls.push(`log:${message}`),
     createMecabTokenizerAndCheck: async () => {
       calls.push('createMecabTokenizerAndCheck');
@@ -40,9 +34,6 @@ function makeDeps(overrides: Partial<AppReadyRuntimeDeps> = {}) {
     loadYomitanExtension: async () => {
       calls.push('loadYomitanExtension');
     },
-    handleFirstRunSetup: async () => {
-      calls.push('handleFirstRunSetup');
-    },
     prewarmSubtitleDictionaries: async () => {
       calls.push('prewarmSubtitleDictionaries');
     },
@@ -57,7 +48,7 @@ function makeDeps(overrides: Partial<AppReadyRuntimeDeps> = {}) {
     logDebug: (message) => calls.push(`debug:${message}`),
     now: () => 1000,
     ...overrides,
-  } as AppReadyRuntimeDeps;
+  };
   return { deps, calls };
 }
 
@@ -66,9 +57,7 @@ test('runAppReadyRuntime starts websocket in auto mode when plugin missing', asy
     hasMpvWebsocketPlugin: () => false,
   });
   await runAppReadyRuntime(deps);
-  assert.ok(calls.includes('ensureDefaultConfigBootstrap'));
   assert.ok(calls.includes('startSubtitleWebsocket:9001'));
-  assert.ok(calls.includes('startAnnotationWebsocket:6678'));
   assert.ok(calls.includes('setVisibleOverlayVisible:true'));
   assert.ok(calls.includes('initializeOverlayRuntime'));
   assert.ok(
@@ -82,46 +71,6 @@ test('runAppReadyRuntime starts websocket in auto mode when plugin missing', asy
   );
 });
 
-test('runAppReadyRuntime starts texthooker on startup when enabled in config', async () => {
-  const { deps, calls } = makeDeps({
-    getResolvedConfig: () => ({
-      websocket: { enabled: 'auto' },
-      secondarySub: {},
-      texthooker: { launchAtStartup: true },
-    }),
-  });
-
-  await runAppReadyRuntime(deps);
-
-  assert.ok(calls.includes('startTexthooker:5174:ws://127.0.0.1:6678'));
-  assert.ok(calls.indexOf('handleFirstRunSetup') < calls.indexOf('handleInitialArgs'));
-  assert.ok(
-    calls.indexOf('createMpvClient') < calls.indexOf('startTexthooker:5174:ws://127.0.0.1:6678'),
-  );
-  assert.ok(
-    calls.indexOf('startTexthooker:5174:ws://127.0.0.1:6678') < calls.indexOf('handleInitialArgs'),
-  );
-});
-
-test('runAppReadyRuntime keeps annotation websocket enabled when regular websocket auto-skips', async () => {
-  const { deps, calls } = makeDeps({
-    getResolvedConfig: () => ({
-      websocket: { enabled: 'auto' },
-      annotationWebsocket: { enabled: true, port: 6678 },
-      secondarySub: {},
-      texthooker: { launchAtStartup: true },
-    }),
-    hasMpvWebsocketPlugin: () => true,
-  });
-
-  await runAppReadyRuntime(deps);
-
-  assert.equal(calls.includes('startSubtitleWebsocket:9001'), false);
-  assert.ok(calls.includes('startAnnotationWebsocket:6678'));
-  assert.ok(calls.includes('startTexthooker:5174:ws://127.0.0.1:6678'));
-  assert.ok(calls.includes('log:mpv_websocket detected, skipping built-in WebSocket server'));
-});
-
 test('runAppReadyRuntime skips heavy startup when shouldSkipHeavyStartup returns true', async () => {
   const { deps, calls } = makeDeps({
     shouldSkipHeavyStartup: () => true,
@@ -153,7 +102,6 @@ test('runAppReadyRuntime skips heavy startup when shouldSkipHeavyStartup returns
 
   await runAppReadyRuntime(deps);
 
-  assert.equal(calls.includes('ensureDefaultConfigBootstrap'), true);
   assert.equal(calls.includes('reloadConfig'), false);
   assert.equal(calls.includes('getResolvedConfig'), false);
   assert.equal(calls.includes('getConfigWarnings'), false);
@@ -168,10 +116,7 @@ test('runAppReadyRuntime skips heavy startup when shouldSkipHeavyStartup returns
   assert.equal(calls.includes('logConfigWarning'), false);
   assert.equal(calls.includes('handleInitialArgs'), true);
   assert.equal(calls.includes('loadYomitanExtension'), true);
-  assert.equal(calls.includes('handleFirstRunSetup'), true);
   assert.ok(calls.indexOf('loadYomitanExtension') < calls.indexOf('handleInitialArgs'));
-  assert.ok(calls.indexOf('loadYomitanExtension') < calls.indexOf('handleFirstRunSetup'));
-  assert.ok(calls.indexOf('handleFirstRunSetup') < calls.indexOf('handleInitialArgs'));
 });
 
 test('runAppReadyRuntime skips Jellyfin remote startup when dependency is not wired', async () => {

src/core/services/cli-command.test.ts

@@ -11,7 +11,6 @@ function makeArgs(overrides: Partial<CliArgs> = {}): CliArgs {
     toggle: false,
     toggleVisibleOverlay: false,
     settings: false,
-    setup: false,
     show: false,
     hide: false,
     showVisibleOverlay: false,
@@ -97,9 +96,6 @@ function createDeps(overrides: Partial<CliCommandServiceDeps> = {}) {
     openYomitanSettingsDelayed: (delayMs) => {
       calls.push(`openYomitanSettingsDelayed:${delayMs}`);
     },
-    openFirstRunSetup: () => {
-      calls.push('openFirstRunSetup');
-    },
     setVisibleOverlayVisible: (visible) => {
       calls.push(`setVisibleOverlayVisible:${visible}`);
     },
@@ -233,16 +229,6 @@ test('handleCliCommand processes --start for second-instance when overlay runtim
   );
 });
 
-test('handleCliCommand opens first-run setup window for --setup', () => {
-  const { deps, calls } = createDeps();
-
-  handleCliCommand(makeArgs({ setup: true }), 'initial', deps);
-
-  assert.ok(calls.includes('openFirstRunSetup'));
-  assert.ok(calls.includes('log:Opened first-run setup flow.'));
-  assert.equal(calls.includes('openYomitanSettingsDelayed:1000'), false);
-});
-
 test('handleCliCommand applies cli log level for second-instance commands', () => {
   const { deps, calls } = createDeps({
     setLogLevel: (level) => {

src/core/services/cli-command.ts

@@ -17,7 +17,6 @@ export interface CliCommandServiceDeps {
   isOverlayRuntimeInitialized: () => boolean;
   initializeOverlayRuntime: () => void;
   toggleVisibleOverlay: () => void;
-  openFirstRunSetup: () => void;
   openYomitanSettingsDelayed: (delayMs: number) => void;
   setVisibleOverlayVisible: (visible: boolean) => void;
   copyCurrentSubtitle: () => void;
@@ -116,7 +115,6 @@ interface MiningCliRuntime {
 }
 
 interface UiCliRuntime {
-  openFirstRunSetup: () => void;
   openYomitanSettings: () => void;
   cycleSecondarySubMode: () => void;
   openRuntimeOptionsPalette: () => void;
@@ -197,7 +195,6 @@ export function createCliCommandDepsRuntime(
     isOverlayRuntimeInitialized: options.overlay.isInitialized,
     initializeOverlayRuntime: options.overlay.initialize,
     toggleVisibleOverlay: options.overlay.toggleVisible,
-    openFirstRunSetup: options.ui.openFirstRunSetup,
     openYomitanSettingsDelayed: (delayMs) => {
       options.schedule(() => {
         options.ui.openYomitanSettings();
@@ -261,8 +258,7 @@ export function handleCliCommand(
 
   const ignoreSecondInstanceStart =
     source === 'second-instance' && args.start && deps.isOverlayRuntimeInitialized();
-  const shouldStart =
-    (!ignoreSecondInstanceStart && args.start) || args.toggle || args.toggleVisibleOverlay;
+  const shouldStart = (!ignoreSecondInstanceStart && args.start) || args.toggle || args.toggleVisibleOverlay;
   const needsOverlayRuntime = commandNeedsOverlayRuntime(args);
   const shouldInitializeOverlayRuntime = needsOverlayRuntime || args.start;
 
@@ -302,9 +298,6 @@ export function handleCliCommand(
 
   if (args.toggle || args.toggleVisibleOverlay) {
     deps.toggleVisibleOverlay();
-  } else if (args.setup) {
-    deps.openFirstRunSetup();
-    deps.log('Opened first-run setup flow.');
   } else if (args.settings) {
     deps.openYomitanSettingsDelayed(1000);
   } else if (args.show || args.showVisibleOverlay) {

src/core/services/ipc-command.test.ts

@@ -38,7 +38,6 @@ function createOptions(overrides: Partial<Parameters<typeof handleMpvCommandFrom
     mpvSendCommand: (command) => {
       sentCommands.push(command);
     },
-    resolveProxyCommandOsd: async () => null,
     isMpvConnected: () => true,
     hasRuntimeOptionsManager: () => true,
     ...overrides,
@@ -53,39 +52,30 @@ test('handleMpvCommandFromIpc forwards regular mpv commands', () => {
   assert.deepEqual(osd, []);
 });
 
-test('handleMpvCommandFromIpc emits osd for subtitle position keybinding proxies', async () => {
+test('handleMpvCommandFromIpc emits osd for subtitle position keybinding proxies', () => {
   const { options, sentCommands, osd } = createOptions();
   handleMpvCommandFromIpc(['add', 'sub-pos', 1], options);
-  await new Promise((resolve) => setImmediate(resolve));
   assert.deepEqual(sentCommands, [['add', 'sub-pos', 1]]);
   assert.deepEqual(osd, ['Subtitle position: ${sub-pos}']);
 });
 
-test('handleMpvCommandFromIpc emits resolved osd for primary subtitle track keybinding proxies', async () => {
-  const { options, sentCommands, osd } = createOptions({
-    resolveProxyCommandOsd: async () => 'Subtitle track: Internal #3 - Japanese (active)',
-  });
+test('handleMpvCommandFromIpc emits osd for primary subtitle track keybinding proxies', () => {
+  const { options, sentCommands, osd } = createOptions();
   handleMpvCommandFromIpc(['cycle', 'sid'], options);
-  await new Promise((resolve) => setImmediate(resolve));
   assert.deepEqual(sentCommands, [['cycle', 'sid']]);
-  assert.deepEqual(osd, ['Subtitle track: Internal #3 - Japanese (active)']);
+  assert.deepEqual(osd, ['Subtitle track: ${sid}']);
 });
 
-test('handleMpvCommandFromIpc emits resolved osd for secondary subtitle track keybinding proxies', async () => {
-  const { options, sentCommands, osd } = createOptions({
-    resolveProxyCommandOsd: async () =>
-      'Secondary subtitle track: External #8 - English Commentary',
-  });
+test('handleMpvCommandFromIpc emits osd for secondary subtitle track keybinding proxies', () => {
+  const { options, sentCommands, osd } = createOptions();
   handleMpvCommandFromIpc(['set_property', 'secondary-sid', 'auto'], options);
-  await new Promise((resolve) => setImmediate(resolve));
   assert.deepEqual(sentCommands, [['set_property', 'secondary-sid', 'auto']]);
-  assert.deepEqual(osd, ['Secondary subtitle track: External #8 - English Commentary']);
+  assert.deepEqual(osd, ['Secondary subtitle track: ${secondary-sid}']);
 });
 
-test('handleMpvCommandFromIpc emits osd for subtitle delay keybinding proxies', async () => {
+test('handleMpvCommandFromIpc emits osd for subtitle delay keybinding proxies', () => {
   const { options, sentCommands, osd } = createOptions();
   handleMpvCommandFromIpc(['add', 'sub-delay', 0.1], options);
-  await new Promise((resolve) => setImmediate(resolve));
   assert.deepEqual(sentCommands, [['add', 'sub-delay', 0.1]]);
   assert.deepEqual(osd, ['Subtitle delay: ${sub-delay}']);
 });

src/core/services/ipc-command.ts

@@ -23,7 +23,6 @@ export interface HandleMpvCommandFromIpcOptions {
   mpvPlayNextSubtitle: () => void;
   shiftSubDelayToAdjacentSubtitle: (direction: 'next' | 'previous') => Promise<void>;
   mpvSendCommand: (command: (string | number)[]) => void;
-  resolveProxyCommandOsd?: (command: (string | number)[]) => Promise<string | null>;
   isMpvConnected: () => boolean;
   hasRuntimeOptionsManager: () => boolean;
 }
@@ -37,7 +36,7 @@ const MPV_PROPERTY_COMMANDS = new Set([
   'multiply',
 ]);
 
-function resolveProxyCommandOsdTemplate(command: (string | number)[]): string | null {
+function resolveProxyCommandOsd(command: (string | number)[]): string | null {
   const operation = typeof command[0] === 'string' ? command[0] : '';
   const property = typeof command[1] === 'string' ? command[1] : '';
   if (!MPV_PROPERTY_COMMANDS.has(operation)) return null;
@@ -56,25 +55,6 @@ function resolveProxyCommandOsdTemplate(command: (string | number)[]): string |
   return null;
 }
 
-function showResolvedProxyCommandOsd(
-  command: (string | number)[],
-  options: HandleMpvCommandFromIpcOptions,
-): void {
-  const template = resolveProxyCommandOsdTemplate(command);
-  if (!template) return;
-
-  const emit = async () => {
-    try {
-      const resolved = await options.resolveProxyCommandOsd?.(command);
-      options.showMpvOsd(resolved || template);
-    } catch {
-      options.showMpvOsd(template);
-    }
-  };
-
-  void emit();
-}
-
 export function handleMpvCommandFromIpc(
   command: (string | number)[],
   options: HandleMpvCommandFromIpcOptions,
@@ -123,7 +103,10 @@ export function handleMpvCommandFromIpc(
       options.mpvPlayNextSubtitle();
     } else {
       options.mpvSendCommand(command);
-      showResolvedProxyCommandOsd(command, options);
+      const osd = resolveProxyCommandOsd(command);
+      if (osd) {
+        options.showMpvOsd(osd);
+      }
     }
   }
 }

src/core/services/mpv-control.test.ts

@@ -22,22 +22,6 @@ test('showMpvOsdRuntime sends show-text when connected', () => {
   assert.deepEqual(commands, [['show-text', 'hello', '3000']]);
 });
 
-test('showMpvOsdRuntime enables property expansion for placeholder-based messages', () => {
-  const commands: (string | number)[][] = [];
-  showMpvOsdRuntime(
-    {
-      connected: true,
-      send: ({ command }) => {
-        commands.push(command);
-      },
-    },
-    'Subtitle delay: ${sub-delay}',
-  );
-  assert.deepEqual(commands, [
-    ['expand-properties', 'show-text', 'Subtitle delay: ${sub-delay}', '3000'],
-  ]);
-});
-
 test('showMpvOsdRuntime logs fallback when disconnected', () => {
   const logs: string[] = [];
   showMpvOsdRuntime(

src/core/services/mpv.ts

@@ -53,10 +53,7 @@ export function showMpvOsdRuntime(
   fallbackLog: (text: string) => void = (line) => logger.info(line),
 ): void {
   if (mpvClient && mpvClient.connected) {
-    const command = text.includes('${')
-      ? ['expand-properties', 'show-text', text, '3000']
-      : ['show-text', text, '3000'];
-    mpvClient.send({ command });
+    mpvClient.send({ command: ['show-text', text, '3000'] });
     return;
   }
   fallbackLog(`OSD (MPV not connected): ${text}`);

src/core/services/startup-bootstrap.test.ts

@@ -11,7 +11,6 @@ function makeArgs(overrides: Partial<CliArgs> = {}): CliArgs {
     toggle: false,
     toggleVisibleOverlay: false,
     settings: false,
-    setup: false,
     show: false,
     hide: false,
     showVisibleOverlay: false,

src/core/services/startup.ts

@@ -69,13 +69,6 @@ export function runStartupBootstrapRuntime(
 }
 
 interface AppReadyConfigLike {
-  annotationWebsocket?: {
-    enabled?: boolean;
-    port?: number;
-  };
-  texthooker?: {
-    launchAtStartup?: boolean;
-  };
   secondarySub?: {
     defaultMode?: SecondarySubMode;
   };
@@ -99,7 +92,6 @@ interface AppReadyConfigLike {
 }
 
 export interface AppReadyRuntimeDeps {
-  ensureDefaultConfigBootstrap: () => void;
   loadSubtitlePosition: () => void;
   resolveKeybindings: () => void;
   createMpvClient: () => void;
@@ -112,19 +104,14 @@ export interface AppReadyRuntimeDeps {
   setSecondarySubMode: (mode: SecondarySubMode) => void;
   defaultSecondarySubMode: SecondarySubMode;
   defaultWebsocketPort: number;
-  defaultAnnotationWebsocketPort: number;
-  defaultTexthookerPort: number;
   hasMpvWebsocketPlugin: () => boolean;
   startSubtitleWebsocket: (port: number) => void;
-  startAnnotationWebsocket: (port: number) => void;
-  startTexthooker: (port: number, websocketUrl?: string) => void;
   log: (message: string) => void;
   createMecabTokenizerAndCheck: () => Promise<void>;
   createSubtitleTimingTracker: () => void;
   createImmersionTracker?: () => void;
   startJellyfinRemoteSession?: () => Promise<void>;
   loadYomitanExtension: () => Promise<void>;
-  handleFirstRunSetup: () => Promise<void>;
   prewarmSubtitleDictionaries?: () => Promise<void>;
   startBackgroundWarmups: () => void;
   texthookerOnlyMode: boolean;
@@ -182,10 +169,8 @@ export function isAutoUpdateEnabledRuntime(
 export async function runAppReadyRuntime(deps: AppReadyRuntimeDeps): Promise<void> {
   const now = deps.now ?? (() => Date.now());
   const startupStartedAtMs = now();
-  deps.ensureDefaultConfigBootstrap();
   if (deps.shouldSkipHeavyStartup?.()) {
     await deps.loadYomitanExtension();
-    await deps.handleFirstRunSetup();
     deps.handleInitialArgs();
     return;
   }
@@ -194,7 +179,6 @@ export async function runAppReadyRuntime(deps: AppReadyRuntimeDeps): Promise<voi
 
   if (deps.shouldSkipHeavyStartup?.()) {
     await deps.loadYomitanExtension();
-    await deps.handleFirstRunSetup();
     deps.handleInitialArgs();
     deps.logDebug?.(`App-ready critical path finished in ${now() - startupStartedAtMs}ms.`);
     return;
@@ -226,11 +210,6 @@ export async function runAppReadyRuntime(deps: AppReadyRuntimeDeps): Promise<voi
   const wsConfig = config.websocket || {};
   const wsEnabled = wsConfig.enabled ?? 'auto';
   const wsPort = wsConfig.port || deps.defaultWebsocketPort;
-  const annotationWsConfig = config.annotationWebsocket || {};
-  const annotationWsEnabled = annotationWsConfig.enabled !== false;
-  const annotationWsPort = annotationWsConfig.port || deps.defaultAnnotationWebsocketPort;
-  const texthookerPort = deps.defaultTexthookerPort;
-  let texthookerWebsocketUrl: string | undefined;
 
   if (wsEnabled === true || (wsEnabled === 'auto' && !deps.hasMpvWebsocketPlugin())) {
     deps.startSubtitleWebsocket(wsPort);
@@ -238,17 +217,6 @@ export async function runAppReadyRuntime(deps: AppReadyRuntimeDeps): Promise<voi
     deps.log('mpv_websocket detected, skipping built-in WebSocket server');
   }
 
-  if (annotationWsEnabled) {
-    deps.startAnnotationWebsocket(annotationWsPort);
-    texthookerWebsocketUrl = `ws://127.0.0.1:${annotationWsPort}`;
-  } else if (wsEnabled === true || (wsEnabled === 'auto' && !deps.hasMpvWebsocketPlugin())) {
-    texthookerWebsocketUrl = `ws://127.0.0.1:${wsPort}`;
-  }
-
-  if (config.texthooker?.launchAtStartup !== false) {
-    deps.startTexthooker(texthookerPort, texthookerWebsocketUrl);
-  }
-
   deps.createSubtitleTimingTracker();
   if (deps.createImmersionTracker) {
     deps.log('Runtime ready: immersion tracker startup deferred until first media activity.');
@@ -265,8 +233,6 @@ export async function runAppReadyRuntime(deps: AppReadyRuntimeDeps): Promise<voi
     deps.log('Overlay runtime deferred: waiting for explicit overlay command.');
   }
 
-  await deps.loadYomitanExtension();
-  await deps.handleFirstRunSetup();
   deps.handleInitialArgs();
   deps.logDebug?.(`App-ready critical path finished in ${now() - startupStartedAtMs}ms.`);
 }

src/core/services/subtitle-ws.test.ts

@@ -1,10 +1,6 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
-import {
-  serializeInitialSubtitleWebsocketMessage,
-  serializeSubtitleMarkup,
-  serializeSubtitleWebsocketMessage,
-} from './subtitle-ws';
+import { serializeSubtitleMarkup, serializeSubtitleWebsocketMessage } from './subtitle-ws';
 import { PartOfSpeech, type SubtitleData } from '../../types';
 
 const frequencyOptions = {
@@ -82,51 +78,6 @@ test('serializeSubtitleMarkup includes known, n+1, jlpt, and frequency classes',
   assert.match(markup, /word word-frequency-band-1/);
 });
 
-test('serializeSubtitleMarkup preserves tooltip attrs and name-match precedence', () => {
-  const payload: SubtitleData = {
-    text: 'ignored',
-    tokens: [
-      {
-        surface: '無事',
-        reading: 'ぶじ',
-        headword: '無事',
-        startPos: 0,
-        endPos: 2,
-        partOfSpeech: PartOfSpeech.other,
-        isMerged: false,
-        isKnown: true,
-        isNPlusOneTarget: false,
-        jlptLevel: 'N2',
-        frequencyRank: 745,
-      },
-      {
-        surface: 'アレクシア',
-        reading: 'あれくしあ',
-        headword: 'アレクシア',
-        startPos: 2,
-        endPos: 7,
-        partOfSpeech: PartOfSpeech.other,
-        isMerged: false,
-        isKnown: false,
-        isNPlusOneTarget: false,
-        isNameMatch: true,
-        frequencyRank: 12,
-      },
-    ],
-  };
-
-  const markup = serializeSubtitleMarkup(payload, frequencyOptions);
-  assert.match(
-    markup,
-    /<span class="word word-known word-jlpt-n2" data-reading="ぶじ" data-headword="無事" data-frequency-rank="745" data-jlpt-level="N2">無事<\/span>/,
-  );
-  assert.match(
-    markup,
-    /<span class="word word-name-match" data-reading="あれくしあ" data-headword="アレクシア" data-frequency-rank="12">アレクシア<\/span>/,
-  );
-  assert.doesNotMatch(markup, /word-name-match word-known|word-known word-name-match/);
-});
-
 test('serializeSubtitleWebsocketMessage emits sentence payload', () => {
   const payload: SubtitleData = {
     text: '字幕',
@@ -134,101 +85,5 @@ test('serializeSubtitleWebsocketMessage emits sentence payload', () => {
   };
 
   const raw = serializeSubtitleWebsocketMessage(payload, frequencyOptions);
-  assert.deepEqual(JSON.parse(raw), {
-    version: 1,
-    text: '字幕',
-    sentence: '字幕',
-    tokens: [],
-  });
-});
-
-test('serializeSubtitleWebsocketMessage emits structured token api payload', () => {
-  const payload: SubtitleData = {
-    text: '無事',
-    tokens: [
-      {
-        surface: '無事',
-        reading: 'ぶじ',
-        headword: '無事',
-        startPos: 0,
-        endPos: 2,
-        partOfSpeech: PartOfSpeech.other,
-        isMerged: false,
-        isKnown: true,
-        isNPlusOneTarget: false,
-        jlptLevel: 'N2',
-        frequencyRank: 745,
-      },
-    ],
-  };
-
-  const raw = serializeSubtitleWebsocketMessage(payload, frequencyOptions);
-  assert.deepEqual(JSON.parse(raw), {
-    version: 1,
-    text: '無事',
-    sentence:
-      '<span class="word word-known word-jlpt-n2" data-reading="ぶじ" data-headword="無事" data-frequency-rank="745" data-jlpt-level="N2">無事</span>',
-    tokens: [
-      {
-        surface: '無事',
-        reading: 'ぶじ',
-        headword: '無事',
-        startPos: 0,
-        endPos: 2,
-        partOfSpeech: PartOfSpeech.other,
-        isMerged: false,
-        isKnown: true,
-        isNPlusOneTarget: false,
-        isNameMatch: false,
-        jlptLevel: 'N2',
-        frequencyRank: 745,
-        className: 'word word-known word-jlpt-n2',
-        frequencyRankLabel: '745',
-        jlptLevelLabel: 'N2',
-      },
-    ],
-  });
-});
-
-test('serializeInitialSubtitleWebsocketMessage keeps annotated current subtitle content', () => {
-  const payload: SubtitleData = {
-    text: 'ignored fallback',
-    tokens: [
-      {
-        surface: '既知',
-        reading: '',
-        headword: '',
-        startPos: 0,
-        endPos: 2,
-        partOfSpeech: PartOfSpeech.other,
-        isMerged: false,
-        isKnown: true,
-        isNPlusOneTarget: false,
-      },
-    ],
-  };
-
-  const raw = serializeInitialSubtitleWebsocketMessage(payload, frequencyOptions);
-  assert.deepEqual(JSON.parse(raw ?? ''), {
-    version: 1,
-    text: 'ignored fallback',
-    sentence: '<span class="word word-known">既知</span>',
-    tokens: [
-      {
-        surface: '既知',
-        reading: '',
-        headword: '',
-        startPos: 0,
-        endPos: 2,
-        partOfSpeech: PartOfSpeech.other,
-        isMerged: false,
-        isKnown: true,
-        isNPlusOneTarget: false,
-        isNameMatch: false,
-        className: 'word word-known',
-        frequencyRankLabel: null,
-        jlptLevelLabel: null,
-      },
-    ],
-  });
+  assert.deepEqual(JSON.parse(raw), { sentence: '字幕' });
 });

src/core/services/subtitle-ws.ts

@@ -18,26 +18,6 @@ export type SubtitleWebsocketFrequencyOptions = {
   mode: 'single' | 'banded';
 };
 
-type SerializedSubtitleToken = Pick<
-  MergedToken,
-  | 'surface'
-  | 'reading'
-  | 'headword'
-  | 'startPos'
-  | 'endPos'
-  | 'partOfSpeech'
-  | 'isMerged'
-  | 'isKnown'
-  | 'isNPlusOneTarget'
-  | 'frequencyRank'
-  | 'jlptLevel'
-> & {
-  isNameMatch: boolean;
-  className: string;
-  frequencyRankLabel: string | null;
-  jlptLevelLabel: string | null;
-};
-
 function escapeHtml(text: string): string {
   return text
     .replaceAll('&', '&amp;')
@@ -66,29 +46,11 @@ function computeFrequencyClass(
   return 'word-frequency-single';
 }
 
-function getFrequencyRankLabel(
-  token: MergedToken,
-  options: SubtitleWebsocketFrequencyOptions,
-): string | null {
-  if (!options.enabled) return null;
-  if (typeof token.frequencyRank !== 'number' || !Number.isFinite(token.frequencyRank)) return null;
-
-  const rank = Math.max(1, Math.floor(token.frequencyRank));
-  const topX = Math.max(1, Math.floor(options.topX));
-  return rank <= topX ? String(rank) : null;
-}
-
-function getJlptLevelLabel(token: MergedToken): string | null {
-  return token.jlptLevel ?? null;
-}
-
 function computeWordClass(token: MergedToken, options: SubtitleWebsocketFrequencyOptions): string {
   const classes = ['word'];
 
   if (token.isNPlusOneTarget) {
     classes.push('word-n-plus-one');
-  } else if (token.isNameMatch) {
-    classes.push('word-name-match');
   } else if (token.isKnown) {
     classes.push('word-known');
   }
@@ -97,7 +59,7 @@ function computeWordClass(token: MergedToken, options: SubtitleWebsocketFrequenc
     classes.push(`word-jlpt-${token.jlptLevel.toLowerCase()}`);
   }
 
-  if (!token.isKnown && !token.isNPlusOneTarget && !token.isNameMatch) {
+  if (!token.isKnown && !token.isNPlusOneTarget) {
     const frequencyClass = computeFrequencyClass(token, options);
     if (frequencyClass) {
       classes.push(frequencyClass);
@@ -107,55 +69,6 @@ function computeWordClass(token: MergedToken, options: SubtitleWebsocketFrequenc
   return classes.join(' ');
 }
 
-function serializeWordDataAttributes(
-  token: MergedToken,
-  options: SubtitleWebsocketFrequencyOptions,
-): string {
-  const attributes: string[] = [];
-
-  if (token.reading) {
-    attributes.push(`data-reading="${escapeHtml(token.reading)}"`);
-  }
-  if (token.headword) {
-    attributes.push(`data-headword="${escapeHtml(token.headword)}"`);
-  }
-
-  const frequencyRankLabel = getFrequencyRankLabel(token, options);
-  if (frequencyRankLabel) {
-    attributes.push(`data-frequency-rank="${escapeHtml(frequencyRankLabel)}"`);
-  }
-
-  const jlptLevelLabel = getJlptLevelLabel(token);
-  if (jlptLevelLabel) {
-    attributes.push(`data-jlpt-level="${escapeHtml(jlptLevelLabel)}"`);
-  }
-
-  return attributes.length > 0 ? ` ${attributes.join(' ')}` : '';
-}
-
-function serializeSubtitleToken(
-  token: MergedToken,
-  options: SubtitleWebsocketFrequencyOptions,
-): SerializedSubtitleToken {
-  return {
-    surface: token.surface,
-    reading: token.reading,
-    headword: token.headword,
-    startPos: token.startPos,
-    endPos: token.endPos,
-    partOfSpeech: token.partOfSpeech,
-    isMerged: token.isMerged,
-    isKnown: token.isKnown,
-    isNPlusOneTarget: token.isNPlusOneTarget,
-    isNameMatch: token.isNameMatch ?? false,
-    jlptLevel: token.jlptLevel,
-    frequencyRank: token.frequencyRank,
-    className: computeWordClass(token, options),
-    frequencyRankLabel: getFrequencyRankLabel(token, options),
-    jlptLevelLabel: getJlptLevelLabel(token),
-  };
-}
-
 export function serializeSubtitleMarkup(
   payload: SubtitleData,
   options: SubtitleWebsocketFrequencyOptions,
@@ -167,12 +80,11 @@ export function serializeSubtitleMarkup(
   const chunks: string[] = [];
   for (const token of payload.tokens) {
     const klass = computeWordClass(token, options);
-    const attrs = serializeWordDataAttributes(token, options);
     const parts = token.surface.split('\n');
     for (let index = 0; index < parts.length; index += 1) {
       const part = parts[index];
       if (part) {
-        chunks.push(`<span class="${klass}"${attrs}>${escapeHtml(part)}</span>`);
+        chunks.push(`<span class="${klass}">${escapeHtml(part)}</span>`);
       }
       if (index < parts.length - 1) {
         chunks.push('<br>');
@@ -187,23 +99,7 @@ export function serializeSubtitleWebsocketMessage(
   payload: SubtitleData,
   options: SubtitleWebsocketFrequencyOptions,
 ): string {
-  return JSON.stringify({
-    version: 1,
-    text: payload.text,
-    sentence: serializeSubtitleMarkup(payload, options),
-    tokens: payload.tokens?.map((token) => serializeSubtitleToken(token, options)) ?? [],
-  });
-}
-
-export function serializeInitialSubtitleWebsocketMessage(
-  payload: SubtitleData | null,
-  options: SubtitleWebsocketFrequencyOptions,
-): string | null {
-  if (!payload || !payload.text.trim()) {
-    return null;
-  }
-
-  return serializeSubtitleWebsocketMessage(payload, options);
+  return JSON.stringify({ sentence: serializeSubtitleMarkup(payload, options) });
 }
 
 export class SubtitleWebSocket {
@@ -218,11 +114,7 @@ export class SubtitleWebSocket {
     return (this.server?.clients.size ?? 0) > 0;
   }
 
-  public start(
-    port: number,
-    getCurrentSubtitleData: () => SubtitleData | null,
-    getFrequencyOptions: () => SubtitleWebsocketFrequencyOptions,
-  ): void {
+  public start(port: number, getCurrentSubtitleText: () => string): void {
     this.server = new WebSocket.Server({ port, host: '127.0.0.1' });
 
     this.server.on('connection', (ws: WebSocket) => {
@@ -232,12 +124,9 @@ export class SubtitleWebSocket {
         return;
       }
 
-      const currentMessage = serializeInitialSubtitleWebsocketMessage(
-        getCurrentSubtitleData(),
-        getFrequencyOptions(),
-      );
-      if (currentMessage) {
-        ws.send(currentMessage);
+      const currentText = getCurrentSubtitleText();
+      if (currentText) {
+        ws.send(JSON.stringify({ sentence: currentText }));
       }
     });
 

src/core/services/texthooker.test.ts

@@ -1,27 +0,0 @@
-import assert from 'node:assert/strict';
-import test from 'node:test';
-import { injectTexthookerBootstrapHtml } from './texthooker';
-
-test('injectTexthookerBootstrapHtml injects websocket bootstrap before head close', () => {
-  const html = '<html><head><title>Texthooker</title></head><body></body></html>';
-
-  const actual = injectTexthookerBootstrapHtml(html, 'ws://127.0.0.1:6678');
-
-  assert.match(
-    actual,
-    /window\.localStorage\.setItem\('bannou-texthooker-websocketUrl', "ws:\/\/127\.0\.0\.1:6678"\)/,
-  );
-  assert.ok(actual.indexOf('</script></head>') !== -1);
-  assert.ok(actual.includes('bannou-texthooker-websocketUrl'));
-  assert.ok(!actual.includes('bannou-texthooker-enableKnownWordColoring'));
-  assert.ok(!actual.includes('bannou-texthooker-enableNPlusOneColoring'));
-  assert.ok(!actual.includes('bannou-texthooker-enableNameMatchColoring'));
-  assert.ok(!actual.includes('bannou-texthooker-enableFrequencyColoring'));
-  assert.ok(!actual.includes('bannou-texthooker-enableJlptColoring'));
-});
-
-test('injectTexthookerBootstrapHtml leaves html unchanged without websocketUrl', () => {
-  const html = '<html><head></head><body></body></html>';
-
-  assert.equal(injectTexthookerBootstrapHtml(html), html);
-});

src/core/services/texthooker.ts

@@ -5,22 +5,6 @@ import { createLogger } from '../../logger';
 
 const logger = createLogger('main:texthooker');
 
-export function injectTexthookerBootstrapHtml(html: string, websocketUrl?: string): string {
-  if (!websocketUrl) {
-    return html;
-  }
-
-  const bootstrapScript = `<script>window.localStorage.setItem('bannou-texthooker-websocketUrl', ${JSON.stringify(
-    websocketUrl,
-  )});</script>`;
-
-  if (html.includes('</head>')) {
-    return html.replace('</head>', `${bootstrapScript}</head>`);
-  }
-
-  return `${bootstrapScript}${html}`;
-}
-
 export class Texthooker {
   private server: http.Server | null = null;
 
@@ -28,11 +12,7 @@ export class Texthooker {
     return this.server !== null;
   }
 
-  public start(port: number, websocketUrl?: string): http.Server | null {
-    if (this.server) {
-      return this.server;
-    }
-
+  public start(port: number): http.Server | null {
     const texthookerPath = this.getTexthookerPath();
     if (!texthookerPath) {
       logger.error('texthooker-ui not found');
@@ -62,12 +42,8 @@ export class Texthooker {
           res.end('Not found');
           return;
         }
-        const responseData =
-          urlPath === '/' || urlPath === '/index.html'
-            ? Buffer.from(injectTexthookerBootstrapHtml(data.toString('utf-8'), websocketUrl))
-            : data;
         res.writeHead(200, { 'Content-Type': mimeTypes[ext] || 'text/plain' });
-        res.end(responseData);
+        res.end(data);
       });
     });
 

src/core/services/tokenizer.test.ts

@@ -1861,9 +1861,9 @@ test('tokenizeSubtitle keeps parsing explicit by scanning-parser source only', a
   assert.equal(result.tokens?.[4]?.frequencyRank, 1500);
 });
 
-test('tokenizeSubtitle still assigns frequency to non-known multi-character Yomitan tokens', async () => {
+test('tokenizeSubtitle still assigns frequency to non-known Yomitan tokens', async () => {
   const result = await tokenizeSubtitle(
-    '小園友達',
+    '小園に',
     makeDeps({
       getYomitanExt: () => ({ id: 'dummy-ext' }) as any,
       getYomitanParserWindow: () =>
@@ -1884,9 +1884,9 @@ test('tokenizeSubtitle still assigns frequency to non-known multi-character Yomi
                   ],
                   [
                     {
-                      text: '友達',
-                      reading: 'ともだち',
-                      headwords: [[{ term: '友達' }]],
+                      text: 'に',
+                      reading: 'に',
+                      headwords: [[{ term: 'に' }]],
                     },
                   ],
                 ],
@@ -1895,7 +1895,7 @@ test('tokenizeSubtitle still assigns frequency to non-known multi-character Yomi
           },
         }) as unknown as Electron.BrowserWindow,
       getFrequencyDictionaryEnabled: () => true,
-      getFrequencyRank: (text) => (text === '小園' ? 75 : text === '友達' ? 3000 : null),
+      getFrequencyRank: (text) => (text === '小園' ? 75 : text === 'に' ? 3000 : null),
       isKnownWord: (text) => text === '小園',
     }),
   );
@@ -2635,21 +2635,6 @@ test('tokenizeSubtitle excludes default non-independent pos2 from N+1 and freque
   assert.equal(result.tokens?.[0]?.isNPlusOneTarget, false);
 });
 
-test('tokenizeSubtitle excludes single-kana merged tokens from frequency highlighting', async () => {
-  const result = await tokenizeSubtitle(
-    'た',
-    makeDepsFromYomitanTokens([{ surface: 'た', reading: 'た', headword: 'た' }], {
-      getFrequencyDictionaryEnabled: () => true,
-      getFrequencyRank: (text) => (text === 'た' ? 17 : null),
-      getMinSentenceWordsForNPlusOne: () => 1,
-      tokenizeWithMecab: async () => null,
-    }),
-  );
-
-  assert.equal(result.tokens?.length, 1);
-  assert.equal(result.tokens?.[0]?.frequencyRank, undefined);
-});
-
 test('tokenizeSubtitle excludes merged function/content token from frequency highlighting but keeps N+1', async () => {
   const result = await tokenizeSubtitle(
     'になれば',

src/core/services/tokenizer/annotation-stage.test.ts

@@ -252,12 +252,12 @@ test('annotateTokens applies configured pos1 exclusions to both frequency and N+
 test('annotateTokens allows previously default-excluded pos1 when removed from effective set', () => {
   const tokens = [
     makeToken({
-      surface: 'まで',
-      headword: 'まで',
+      surface: 'は',
+      headword: 'は',
       partOfSpeech: PartOfSpeech.other,
       pos1: '助詞',
       startPos: 0,
-      endPos: 2,
+      endPos: 1,
       frequencyRank: 8,
     }),
   ];
@@ -314,52 +314,6 @@ test('annotateTokens excludes likely kana SFX tokens from frequency when POS tag
   assert.equal(result[0]?.frequencyRank, undefined);
 });
 
-test('annotateTokens excludes single hiragana and katakana tokens from frequency when POS tags are missing', () => {
-  const tokens = [
-    makeToken({
-      surface: 'た',
-      reading: 'た',
-      headword: 'た',
-      pos1: '',
-      pos2: '',
-      partOfSpeech: PartOfSpeech.other,
-      frequencyRank: 21,
-      startPos: 0,
-      endPos: 1,
-    }),
-    makeToken({
-      surface: 'ア',
-      reading: 'ア',
-      headword: 'ア',
-      pos1: '',
-      pos2: '',
-      partOfSpeech: PartOfSpeech.other,
-      frequencyRank: 22,
-      startPos: 1,
-      endPos: 2,
-    }),
-    makeToken({
-      surface: '山',
-      reading: 'やま',
-      headword: '山',
-      pos1: '',
-      pos2: '',
-      partOfSpeech: PartOfSpeech.other,
-      frequencyRank: 23,
-      startPos: 2,
-      endPos: 3,
-    }),
-  ];
-
-  const result = annotateTokens(tokens, makeDeps(), {
-    minSentenceWordsForNPlusOne: 1,
-  });
-
-  assert.equal(result[0]?.frequencyRank, undefined);
-  assert.equal(result[1]?.frequencyRank, undefined);
-  assert.equal(result[2]?.frequencyRank, 23);
-});
-
 test('annotateTokens keeps frequency when mecab tags classify token as content-bearing', () => {
   const tokens = [
     makeToken({

src/core/services/tokenizer/annotation-stage.ts

@@ -103,10 +103,6 @@ function isFrequencyExcludedByPos(
   pos1Exclusions: ReadonlySet<string>,
   pos2Exclusions: ReadonlySet<string>,
 ): boolean {
-  if (isSingleKanaFrequencyNoiseToken(token.surface)) {
-    return true;
-  }
-
   const normalizedPos1 = normalizePos1Tag(token.pos1);
   const hasPos1 = normalizedPos1.length > 0;
   if (isExcludedByTagSet(normalizedPos1, pos1Exclusions)) {
@@ -367,20 +363,6 @@ function isLikelyFrequencyNoiseToken(token: MergedToken): boolean {
   return false;
 }
 
-function isSingleKanaFrequencyNoiseToken(text: string | undefined): boolean {
-  if (typeof text !== 'string') {
-    return false;
-  }
-
-  const normalized = text.trim();
-  if (!normalized) {
-    return false;
-  }
-
-  const chars = [...normalized];
-  return chars.length === 1 && isKanaChar(chars[0]!);
-}
-
 function isJlptEligibleToken(token: MergedToken): boolean {
   if (token.pos1 && shouldIgnoreJlptForMecabPos1(token.pos1)) {
     return false;

src/core/services/tokenizer/yomitan-parser-runtime.test.ts

@@ -643,173 +643,6 @@ test('requestYomitanScanTokens marks grouped entries when SubMiner dictionary al
   assert.equal((result as Array<{ isNameMatch?: boolean }>)[0]?.isNameMatch, true);
 });
 
-test('requestYomitanScanTokens skips fallback fragments without exact primary source matches', async () => {
-  const deps = createDeps(async (script) => {
-    if (script.includes('optionsGetFull')) {
-      return {
-        profileCurrent: 0,
-        profiles: [
-          {
-            options: {
-              scanning: { length: 40 },
-            },
-          },
-        ],
-      };
-    }
-
-    return await runInjectedYomitanScript(script, (action, params) => {
-      if (action !== 'termsFind') {
-        throw new Error(`unexpected action: ${action}`);
-      }
-
-      const text = (params as { text?: string } | undefined)?.text ?? '';
-      if (text.startsWith('だが ')) {
-        return {
-          originalTextLength: 2,
-          dictionaryEntries: [
-            {
-              headwords: [
-                {
-                  term: 'だが',
-                  reading: 'だが',
-                  sources: [{ originalText: 'だが', isPrimary: true, matchType: 'exact' }],
-                },
-              ],
-            },
-          ],
-        };
-      }
-      if (text.startsWith('それでも')) {
-        return {
-          originalTextLength: 4,
-          dictionaryEntries: [
-            {
-              headwords: [
-                {
-                  term: 'それでも',
-                  reading: 'それでも',
-                  sources: [{ originalText: 'それでも', isPrimary: true, matchType: 'exact' }],
-                },
-              ],
-            },
-          ],
-        };
-      }
-      if (text.startsWith('届かぬ')) {
-        return {
-          originalTextLength: 3,
-          dictionaryEntries: [
-            {
-              headwords: [
-                {
-                  term: '届く',
-                  reading: 'とどく',
-                  sources: [{ originalText: '届かぬ', isPrimary: true, matchType: 'exact' }],
-                },
-              ],
-            },
-          ],
-        };
-      }
-      if (text.startsWith('高み')) {
-        return {
-          originalTextLength: 2,
-          dictionaryEntries: [
-            {
-              headwords: [
-                {
-                  term: '高み',
-                  reading: 'たかみ',
-                  sources: [{ originalText: '高み', isPrimary: true, matchType: 'exact' }],
-                },
-              ],
-            },
-          ],
-        };
-      }
-      if (text.startsWith('があった')) {
-        return {
-          originalTextLength: 2,
-          dictionaryEntries: [
-            {
-              headwords: [
-                {
-                  term: 'があ',
-                  reading: '',
-                  sources: [{ originalText: 'が', isPrimary: true, matchType: 'exact' }],
-                },
-              ],
-            },
-          ],
-        };
-      }
-      if (text.startsWith('あった')) {
-        return {
-          originalTextLength: 3,
-          dictionaryEntries: [
-            {
-              headwords: [
-                {
-                  term: 'ある',
-                  reading: 'ある',
-                  sources: [{ originalText: 'あった', isPrimary: true, matchType: 'exact' }],
-                },
-              ],
-            },
-          ],
-        };
-      }
-      return { originalTextLength: 0, dictionaryEntries: [] };
-    });
-  });
-
-  const result = await requestYomitanScanTokens('だが それでも届かぬ高みがあった', deps, {
-    error: () => undefined,
-  });
-
-  assert.deepEqual(
-    result?.map((token) => ({
-      surface: token.surface,
-      headword: token.headword,
-      startPos: token.startPos,
-      endPos: token.endPos,
-    })),
-    [
-      {
-        surface: 'だが',
-        headword: 'だが',
-        startPos: 0,
-        endPos: 2,
-      },
-      {
-        surface: 'それでも',
-        headword: 'それでも',
-        startPos: 3,
-        endPos: 7,
-      },
-      {
-        surface: '届かぬ',
-        headword: '届く',
-        startPos: 7,
-        endPos: 10,
-      },
-      {
-        surface: '高み',
-        headword: '高み',
-        startPos: 10,
-        endPos: 12,
-      },
-      {
-        surface: 'あった',
-        headword: 'ある',
-        startPos: 13,
-        endPos: 16,
-      },
-    ],
-  );
-});
-
 test('getYomitanDictionaryInfo requests dictionary info via backend action', async () => {
   let scriptValue = '';
   const deps = createDeps(async (script) => {
@@ -823,7 +656,7 @@ test('getYomitanDictionaryInfo requests dictionary info via backend action', asy
   assert.match(scriptValue, /getDictionaryInfo/);
 });
 
-test('dictionary settings helpers upsert and remove dictionary entries without reordering', async () => {
+test('dictionary settings helpers upsert and remove dictionary entries', async () => {
   const scripts: string[] = [];
   const optionsFull = {
     profileCurrent: 0,
@@ -873,8 +706,7 @@ test('dictionary settings helpers upsert and remove dictionary entries without r
 
   const upsertScript = scripts.find(
     (script) =>
-      script.includes('setAllSettings') &&
-      script.includes('"SubMiner Character Dictionary (AniList 1)"'),
+      script.includes('setAllSettings') && script.includes('"SubMiner Character Dictionary (AniList 1)"'),
   );
   assert.ok(upsertScript);
   const jitendexOffset = upsertScript?.indexOf('"Jitendex"') ?? -1;
@@ -914,18 +746,9 @@ test('importYomitanDictionaryFromZip uses settings automation bridge instead of
   });
 
   assert.equal(imported, true);
-  assert.equal(
-    scripts.some((script) => script.includes('__subminerYomitanSettingsAutomation')),
-    true,
-  );
-  assert.equal(
-    scripts.some((script) => script.includes('importDictionaryArchiveBase64')),
-    true,
-  );
-  assert.equal(
-    scripts.some((script) => script.includes('subminerImportDictionary')),
-    false,
-  );
+  assert.equal(scripts.some((script) => script.includes('__subminerYomitanSettingsAutomation')), true);
+  assert.equal(scripts.some((script) => script.includes('importDictionaryArchiveBase64')), true);
+  assert.equal(scripts.some((script) => script.includes('subminerImportDictionary')), false);
 });
 
 test('deleteYomitanDictionaryByTitle uses settings automation bridge instead of custom backend action', async () => {
@@ -955,16 +778,7 @@ test('deleteYomitanDictionaryByTitle uses settings automation bridge instead of
   );
 
   assert.equal(deleted, true);
-  assert.equal(
-    scripts.some((script) => script.includes('__subminerYomitanSettingsAutomation')),
-    true,
-  );
-  assert.equal(
-    scripts.some((script) => script.includes('deleteDictionary')),
-    true,
-  );
-  assert.equal(
-    scripts.some((script) => script.includes('subminerDeleteDictionary')),
-    false,
-  );
+  assert.equal(scripts.some((script) => script.includes('__subminerYomitanSettingsAutomation')), true);
+  assert.equal(scripts.some((script) => script.includes('deleteDictionary')), true);
+  assert.equal(scripts.some((script) => script.includes('subminerDeleteDictionary')), false);
 });

src/core/services/tokenizer/yomitan-parser-runtime.ts

@@ -562,7 +562,9 @@ async function createYomitanExtensionWindow(
     });
     return window;
   } catch (err) {
-    logger.error(`Failed to create hidden Yomitan ${pageName} window: ${(err as Error).message}`);
+    logger.error(
+      `Failed to create hidden Yomitan ${pageName} window: ${(err as Error).message}`,
+    );
     if (!window.isDestroyed()) {
       window.destroy();
     }
@@ -841,7 +843,14 @@ const YOMITAN_SCANNING_HELPERS = String.raw`
             };
           }
         }
-        return null;
+        const fallback = dictionaryEntries?.[0]?.headwords?.[0];
+        return fallback
+          ? {
+              term: fallback.term,
+              reading: fallback.reading,
+              isNameMatch: matchedNameDictionary || isNameDictionaryEntry(dictionaryEntries?.[0])
+            }
+          : null;
       }
 `;
 
@@ -1041,15 +1050,13 @@ export async function requestYomitanScanTokens(
     }
     if (Array.isArray(rawResult)) {
       const selectedTokens = selectYomitanParseTokens(rawResult, () => false, 'headword');
-      return (
-        selectedTokens?.map((token) => ({
-          surface: token.surface,
-          reading: token.reading,
-          headword: token.headword,
-          startPos: token.startPos,
-          endPos: token.endPos,
-        })) ?? null
-      );
+      return selectedTokens?.map((token) => ({
+        surface: token.surface,
+        reading: token.reading,
+        headword: token.headword,
+        startPos: token.startPos,
+        endPos: token.endPos,
+      })) ?? null;
     }
     return null;
   } catch (err) {
@@ -1523,12 +1530,7 @@ export async function getYomitanDictionaryInfo(
   deps: YomitanParserRuntimeDeps,
   logger: LoggerLike,
 ): Promise<YomitanDictionaryInfo[]> {
-  const result = await invokeYomitanBackendAction<unknown>(
-    'getDictionaryInfo',
-    undefined,
-    deps,
-    logger,
-  );
+  const result = await invokeYomitanBackendAction<unknown>('getDictionaryInfo', undefined, deps, logger);
   if (!Array.isArray(result)) {
     return [];
   }
@@ -1551,12 +1553,7 @@ export async function getYomitanSettingsFull(
   deps: YomitanParserRuntimeDeps,
   logger: LoggerLike,
 ): Promise<Record<string, unknown> | null> {
-  const result = await invokeYomitanBackendAction<unknown>(
-    'optionsGetFull',
-    undefined,
-    deps,
-    logger,
-  );
+  const result = await invokeYomitanBackendAction<unknown>('optionsGetFull', undefined, deps, logger);
   return isObject(result) ? result : null;
 }
 
@@ -1663,7 +1660,7 @@ export async function upsertYomitanDictionarySettings(
       (entry) =>
         isObject(entry) &&
         typeof (entry as { name?: unknown }).name === 'string' &&
-        (entry as { name: string }).name.trim() === normalizedTitle,
+        ((entry as { name: string }).name.trim() === normalizedTitle),
     );
 
     if (existingIndex >= 0) {
@@ -1679,7 +1676,7 @@ export async function upsertYomitanDictionarySettings(
       continue;
     }
 
-    dictionaries.push(createDefaultDictionarySettings(normalizedTitle, true));
+    dictionaries.unshift(createDefaultDictionarySettings(normalizedTitle, true));
     changed = true;
   }
 

src/core/services/yomitan-extension-copy.ts

@@ -90,10 +90,7 @@ export function shouldCopyYomitanExtension(sourceDir: string, targetDir: string)
   return sourceHash === null || targetHash === null || sourceHash !== targetHash;
 }
 
-export function ensureExtensionCopy(
-  sourceDir: string,
-  userDataPath: string,
-): {
+export function ensureExtensionCopy(sourceDir: string, userDataPath: string): {
   targetDir: string;
   copied: boolean;
 } {

src/core/services/yomitan-extension-loader.test.ts

@@ -75,10 +75,7 @@ test('ensureExtensionCopy refreshes copied extension when display files change',
   assert.equal(result.targetDir, targetDir);
   assert.equal(result.copied, true);
   assert.equal(
-    fs.readFileSync(
-      path.join(targetDir, 'js', 'display', 'structured-content-generator.js'),
-      'utf8',
-    ),
+    fs.readFileSync(path.join(targetDir, 'js', 'display', 'structured-content-generator.js'), 'utf8'),
     'new display code',
   );
 });

src/core/services/yomitan-extension-loader.ts

@@ -1,17 +1,13 @@
 import { BrowserWindow, Extension, session } from 'electron';
 import * as fs from 'fs';
+import * as path from 'path';
 import { createLogger } from '../../logger';
 import { ensureExtensionCopy } from './yomitan-extension-copy';
-import {
-  getYomitanExtensionSearchPaths,
-  resolveExistingYomitanExtensionPath,
-} from './yomitan-extension-paths';
 
 const logger = createLogger('main:yomitan-extension-loader');
 
 export interface YomitanExtensionLoaderDeps {
   userDataPath: string;
-  extensionPath?: string;
   getYomitanParserWindow: () => BrowserWindow | null;
   setYomitanParserWindow: (window: BrowserWindow | null) => void;
   setYomitanParserReadyPromise: (promise: Promise<void> | null) => void;
@@ -22,17 +18,25 @@ export interface YomitanExtensionLoaderDeps {
 export async function loadYomitanExtension(
   deps: YomitanExtensionLoaderDeps,
 ): Promise<Extension | null> {
-  const searchPaths = getYomitanExtensionSearchPaths({
-    explicitPath: deps.extensionPath,
-    moduleDir: __dirname,
-    resourcesPath: process.resourcesPath,
-    userDataPath: deps.userDataPath,
-  });
-  let extPath = resolveExistingYomitanExtensionPath(searchPaths, fs.existsSync);
+  const searchPaths = [
+    path.join(__dirname, '..', '..', 'vendor', 'yomitan'),
+    path.join(__dirname, '..', '..', '..', 'vendor', 'yomitan'),
+    path.join(process.resourcesPath, 'yomitan'),
+    '/usr/share/SubMiner/yomitan',
+    path.join(deps.userDataPath, 'yomitan'),
+  ];
+
+  let extPath: string | null = null;
+  for (const p of searchPaths) {
+    if (fs.existsSync(p)) {
+      extPath = p;
+      break;
+    }
+  }
 
   if (!extPath) {
     logger.error('Yomitan extension not found in any search path');
-    logger.error('Run `bun run build:yomitan` or install Yomitan to one of:', searchPaths);
+    logger.error('Install Yomitan to one of:', searchPaths);
     return null;
   }
 

src/core/services/yomitan-extension-paths.test.ts

@@ -1,50 +0,0 @@
-import assert from 'node:assert/strict';
-import path from 'node:path';
-import test from 'node:test';
-
-import {
-  getYomitanExtensionSearchPaths,
-  resolveExistingYomitanExtensionPath,
-} from './yomitan-extension-paths';
-
-test('getYomitanExtensionSearchPaths prioritizes generated build output before packaged fallbacks', () => {
-  const searchPaths = getYomitanExtensionSearchPaths({
-    cwd: '/repo',
-    moduleDir: '/repo/dist/core/services',
-    resourcesPath: '/opt/SubMiner/resources',
-    userDataPath: '/Users/kyle/.config/SubMiner',
-  });
-
-  assert.deepEqual(searchPaths, [
-    path.join('/repo', 'build', 'yomitan'),
-    path.join('/opt/SubMiner/resources', 'yomitan'),
-    '/usr/share/SubMiner/yomitan',
-    path.join('/Users/kyle/.config/SubMiner', 'yomitan'),
-  ]);
-});
-
-test('resolveExistingYomitanExtensionPath returns first manifest-backed candidate', () => {
-  const existing = new Set<string>([
-    path.join('/repo', 'build', 'yomitan', 'manifest.json'),
-    path.join('/repo', 'vendor', 'subminer-yomitan', 'ext', 'manifest.json'),
-  ]);
-
-  const resolved = resolveExistingYomitanExtensionPath(
-    [
-      path.join('/repo', 'build', 'yomitan'),
-      path.join('/repo', 'vendor', 'subminer-yomitan', 'ext'),
-    ],
-    (candidate) => existing.has(candidate),
-  );
-
-  assert.equal(resolved, path.join('/repo', 'build', 'yomitan'));
-});
-
-test('resolveExistingYomitanExtensionPath ignores source tree without built manifest', () => {
-  const resolved = resolveExistingYomitanExtensionPath(
-    [path.join('/repo', 'vendor', 'subminer-yomitan', 'ext')],
-    () => false,
-  );
-
-  assert.equal(resolved, null);
-});

src/core/services/yomitan-extension-paths.ts

@@ -1,60 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-
-export interface YomitanExtensionPathOptions {
-  explicitPath?: string;
-  cwd?: string;
-  moduleDir?: string;
-  resourcesPath?: string;
-  userDataPath?: string;
-}
-
-function pushUnique(values: string[], candidate: string | null | undefined): void {
-  if (!candidate || values.includes(candidate)) {
-    return;
-  }
-  values.push(candidate);
-}
-
-export function getYomitanExtensionSearchPaths(
-  options: YomitanExtensionPathOptions = {},
-): string[] {
-  const searchPaths: string[] = [];
-
-  pushUnique(searchPaths, options.explicitPath ? path.resolve(options.explicitPath) : null);
-  pushUnique(searchPaths, options.cwd ? path.resolve(options.cwd, 'build', 'yomitan') : null);
-  pushUnique(
-    searchPaths,
-    options.moduleDir
-      ? path.resolve(options.moduleDir, '..', '..', '..', 'build', 'yomitan')
-      : null,
-  );
-  pushUnique(
-    searchPaths,
-    options.resourcesPath ? path.join(options.resourcesPath, 'yomitan') : null,
-  );
-  pushUnique(searchPaths, '/usr/share/SubMiner/yomitan');
-  pushUnique(searchPaths, options.userDataPath ? path.join(options.userDataPath, 'yomitan') : null);
-
-  return searchPaths;
-}
-
-export function resolveExistingYomitanExtensionPath(
-  searchPaths: string[],
-  existsSync: (path: string) => boolean = fs.existsSync,
-): string | null {
-  for (const candidate of searchPaths) {
-    if (existsSync(path.join(candidate, 'manifest.json'))) {
-      return candidate;
-    }
-  }
-
-  return null;
-}
-
-export function resolveYomitanExtensionPath(
-  options: YomitanExtensionPathOptions = {},
-  existsSync: (path: string) => boolean = fs.existsSync,
-): string | null {
-  return resolveExistingYomitanExtensionPath(getYomitanExtensionSearchPaths(options), existsSync);
-}

src/core/services/yomitan-structured-content-generator.test.ts

@@ -2,7 +2,6 @@ import assert from 'node:assert/strict';
 import path from 'node:path';
 import test from 'node:test';
 import { pathToFileURL } from 'node:url';
-import { resolveYomitanExtensionPath } from './yomitan-extension-paths';
 
 class FakeStyle {
   private values = new Map<string, string>();
@@ -156,14 +155,15 @@ function findFirstByClass(node: FakeNode, className: string): FakeNode | null {
 }
 
 test('StructuredContentGenerator uses direct img loading for popup glossary images', async () => {
-  const yomitanRoot = resolveYomitanExtensionPath({ cwd: process.cwd() });
-  assert.ok(yomitanRoot, 'Run `bun run build:yomitan` before Yomitan integration tests.');
-
   const { DisplayContentManager } = await import(
-    pathToFileURL(path.join(yomitanRoot, 'js', 'display', 'display-content-manager.js')).href
+    pathToFileURL(
+      path.join(process.cwd(), 'vendor/yomitan/js/display/display-content-manager.js'),
+    ).href
   );
   const { StructuredContentGenerator } = await import(
-    pathToFileURL(path.join(yomitanRoot, 'js', 'display', 'structured-content-generator.js')).href
+    pathToFileURL(
+      path.join(process.cwd(), 'vendor/yomitan/js/display/structured-content-generator.js'),
+    ).href
   );
 
   const createObjectURLCalls: string[] = [];
@@ -197,10 +197,14 @@ test('StructuredContentGenerator uses direct img loading for popup glossary imag
       },
     });
 
-    const generator = new StructuredContentGenerator(manager, new FakeDocument(), {
-      devicePixelRatio: 1,
-      navigator: { userAgent: 'Mozilla/5.0' },
-    });
+    const generator = new StructuredContentGenerator(
+      manager,
+      new FakeDocument(),
+      {
+        devicePixelRatio: 1,
+        navigator: { userAgent: 'Mozilla/5.0' },
+      },
+    );
 
     const node = generator.createDefinitionImage(
       {

src/generate-config-example.test.ts

@@ -1,82 +0,0 @@
-import assert from 'node:assert/strict';
-import fs from 'node:fs';
-import path from 'node:path';
-import test from 'node:test';
-import {
-  resolveConfigExampleOutputPaths,
-  writeConfigExampleArtifacts,
-} from './generate-config-example';
-
-function createWorkspace(name: string): string {
-  const baseDir = path.join(process.cwd(), '.tmp', 'generate-config-example-test');
-  fs.mkdirSync(baseDir, { recursive: true });
-  return fs.mkdtempSync(path.join(baseDir, `${name}-`));
-}
-
-test('resolveConfigExampleOutputPaths includes sibling docs repo and never local docs/public', () => {
-  const workspace = createWorkspace('with-docs-repo');
-  const projectRoot = path.join(workspace, 'SubMiner');
-  const docsRepoRoot = path.join(workspace, 'subminer-docs');
-
-  fs.mkdirSync(projectRoot, { recursive: true });
-  fs.mkdirSync(docsRepoRoot, { recursive: true });
-
-  try {
-    const outputPaths = resolveConfigExampleOutputPaths({ cwd: projectRoot });
-
-    assert.deepEqual(outputPaths, [
-      path.join(projectRoot, 'config.example.jsonc'),
-      path.join(docsRepoRoot, 'public', 'config.example.jsonc'),
-    ]);
-    assert.equal(
-      outputPaths.includes(path.join(projectRoot, 'docs', 'public', 'config.example.jsonc')),
-      false,
-    );
-  } finally {
-    fs.rmSync(workspace, { recursive: true, force: true });
-  }
-});
-
-test('resolveConfigExampleOutputPaths stays repo-local when sibling docs repo is absent', () => {
-  const workspace = createWorkspace('without-docs-repo');
-  const projectRoot = path.join(workspace, 'SubMiner');
-
-  fs.mkdirSync(projectRoot, { recursive: true });
-
-  try {
-    const outputPaths = resolveConfigExampleOutputPaths({ cwd: projectRoot });
-
-    assert.deepEqual(outputPaths, [path.join(projectRoot, 'config.example.jsonc')]);
-  } finally {
-    fs.rmSync(workspace, { recursive: true, force: true });
-  }
-});
-
-test('writeConfigExampleArtifacts creates parent directories for resolved outputs', () => {
-  const workspace = createWorkspace('write-artifacts');
-  const projectRoot = path.join(workspace, 'SubMiner');
-  const docsRepoRoot = path.join(workspace, 'subminer-docs');
-  const template = '{\n  "ok": true\n}\n';
-
-  fs.mkdirSync(projectRoot, { recursive: true });
-  fs.mkdirSync(docsRepoRoot, { recursive: true });
-
-  try {
-    const writtenPaths = writeConfigExampleArtifacts(template, {
-      cwd: projectRoot,
-      deps: { log: () => {} },
-    });
-
-    assert.deepEqual(writtenPaths, [
-      path.join(projectRoot, 'config.example.jsonc'),
-      path.join(docsRepoRoot, 'public', 'config.example.jsonc'),
-    ]);
-    assert.equal(fs.readFileSync(path.join(projectRoot, 'config.example.jsonc'), 'utf8'), template);
-    assert.equal(
-      fs.readFileSync(path.join(docsRepoRoot, 'public', 'config.example.jsonc'), 'utf8'),
-      template,
-    );
-  } finally {
-    fs.rmSync(workspace, { recursive: true, force: true });
-  }
-});

src/generate-config-example.ts

@@ -2,62 +2,18 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { DEFAULT_CONFIG, generateConfigTemplate } from './config';
 
-type ConfigExampleFsDeps = {
-  existsSync?: (candidate: string) => boolean;
-  mkdirSync?: (candidate: string, options: { recursive: true }) => void;
-  writeFileSync?: (candidate: string, content: string, encoding: BufferEncoding) => void;
-  log?: (message: string) => void;
-};
-
-export function resolveConfigExampleOutputPaths(options?: {
-  cwd?: string;
-  docsRepoName?: string;
-  existsSync?: (candidate: string) => boolean;
-}): string[] {
-  const cwd = options?.cwd ?? process.cwd();
-  const existsSync = options?.existsSync ?? fs.existsSync;
-  const docsRepoName = options?.docsRepoName ?? 'subminer-docs';
-  const outputPaths = [path.join(cwd, 'config.example.jsonc')];
-  const docsRepoRoot = path.resolve(cwd, '..', docsRepoName);
-
-  if (existsSync(docsRepoRoot)) {
-    outputPaths.push(path.join(docsRepoRoot, 'public', 'config.example.jsonc'));
-  }
-
-  return outputPaths;
-}
-
-export function writeConfigExampleArtifacts(
-  template: string,
-  options?: {
-    cwd?: string;
-    docsRepoName?: string;
-    deps?: ConfigExampleFsDeps;
-  },
-): string[] {
-  const mkdirSync = options?.deps?.mkdirSync ?? fs.mkdirSync;
-  const writeFileSync = options?.deps?.writeFileSync ?? fs.writeFileSync;
-  const log = options?.deps?.log ?? console.log;
-  const outputPaths = resolveConfigExampleOutputPaths({
-    cwd: options?.cwd,
-    docsRepoName: options?.docsRepoName,
-    existsSync: options?.deps?.existsSync,
-  });
-
-  for (const outputPath of outputPaths) {
-    mkdirSync(path.dirname(outputPath), { recursive: true });
-    writeFileSync(outputPath, template, 'utf-8');
-    log(`Generated ${outputPath}`);
-  }
-
-  return outputPaths;
-}
-
 function main(): void {
   const template = generateConfigTemplate(DEFAULT_CONFIG);
-  writeConfigExampleArtifacts(template);
+  const outputPaths = [
+    path.join(process.cwd(), 'config.example.jsonc'),
+    path.join(process.cwd(), 'docs', 'public', 'config.example.jsonc'),
+  ];
+
+  for (const outputPath of outputPaths) {
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, template, 'utf-8');
+    console.log(`Generated ${outputPath}`);
+  }
 }
 
-if (require.main === module) {
-  main();
-}
+main();

src/main-entry-runtime.test.ts

@@ -1,35 +1,12 @@
 import assert from 'node:assert/strict';
 import test from 'node:test';
 import {
-  normalizeStartupArgv,
   sanitizeHelpEnv,
-  sanitizeStartupEnv,
   sanitizeBackgroundEnv,
   shouldDetachBackgroundLaunch,
   shouldHandleHelpOnlyAtEntry,
 } from './main-entry-runtime';
 
-test('normalizeStartupArgv defaults no-arg startup to --start --background', () => {
-  assert.deepEqual(normalizeStartupArgv(['SubMiner.AppImage'], {}), [
-    'SubMiner.AppImage',
-    '--start',
-    '--background',
-  ]);
-  assert.deepEqual(
-    normalizeStartupArgv(['SubMiner.AppImage', '--password-store', 'gnome-libsecret'], {}),
-    ['SubMiner.AppImage', '--password-store', 'gnome-libsecret', '--start', '--background'],
-  );
-  assert.deepEqual(normalizeStartupArgv(['SubMiner.AppImage', '--background'], {}), [
-    'SubMiner.AppImage',
-    '--background',
-    '--start',
-  ]);
-  assert.deepEqual(normalizeStartupArgv(['SubMiner.AppImage', '--help'], {}), [
-    'SubMiner.AppImage',
-    '--help',
-  ]);
-});
-
 test('shouldHandleHelpOnlyAtEntry detects help-only invocation', () => {
   assert.equal(shouldHandleHelpOnlyAtEntry(['--help'], {}), true);
   assert.equal(shouldHandleHelpOnlyAtEntry(['--help', '--start'], {}), false);
@@ -37,14 +14,6 @@ test('shouldHandleHelpOnlyAtEntry detects help-only invocation', () => {
   assert.equal(shouldHandleHelpOnlyAtEntry(['--help'], { ELECTRON_RUN_AS_NODE: '1' }), false);
 });
 
-test('sanitizeStartupEnv suppresses warnings and lsfg layer', () => {
-  const env = sanitizeStartupEnv({
-    VK_INSTANCE_LAYERS: 'foo:lsfg-vk:bar',
-  });
-  assert.equal(env.NODE_NO_WARNINGS, '1');
-  assert.equal('VK_INSTANCE_LAYERS' in env, false);
-});
-
 test('sanitizeHelpEnv suppresses warnings and lsfg layer', () => {
   const env = sanitizeHelpEnv({
     VK_INSTANCE_LAYERS: 'foo:lsfg-vk:bar',

src/main-entry-runtime.ts

@@ -1,8 +1,6 @@
 import { CliArgs, parseArgs, shouldStartApp } from './cli/args';
 
 const BACKGROUND_ARG = '--background';
-const START_ARG = '--start';
-const PASSWORD_STORE_ARG = '--password-store';
 const BACKGROUND_CHILD_ENV = 'SUBMINER_BACKGROUND_CHILD';
 
 function removeLsfgLayer(env: NodeJS.ProcessEnv): void {
@@ -11,54 +9,10 @@ function removeLsfgLayer(env: NodeJS.ProcessEnv): void {
   }
 }
 
-function removePassiveStartupArgs(argv: string[]): string[] {
-  const filtered: string[] = [];
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (!arg) continue;
-
-    if (arg === PASSWORD_STORE_ARG) {
-      const value = argv[i + 1];
-      if (value && !value.startsWith('--')) {
-        i += 1;
-      }
-      continue;
-    }
-
-    if (arg.startsWith(`${PASSWORD_STORE_ARG}=`)) {
-      continue;
-    }
-
-    filtered.push(arg);
-  }
-
-  return filtered;
-}
-
 function parseCliArgs(argv: string[]): CliArgs {
   return parseArgs(argv);
 }
 
-export function normalizeStartupArgv(argv: string[], env: NodeJS.ProcessEnv): string[] {
-  if (env.ELECTRON_RUN_AS_NODE === '1') return argv;
-
-  const effectiveArgs = removePassiveStartupArgs(argv.slice(1));
-  if (effectiveArgs.length === 0) {
-    return [...argv, START_ARG, BACKGROUND_ARG];
-  }
-
-  if (
-    effectiveArgs.length === 1 &&
-    effectiveArgs[0] === BACKGROUND_ARG &&
-    !argv.includes(START_ARG)
-  ) {
-    return [...argv, START_ARG];
-  }
-
-  return argv;
-}
-
 export function shouldDetachBackgroundLaunch(argv: string[], env: NodeJS.ProcessEnv): boolean {
   if (env.ELECTRON_RUN_AS_NODE === '1') return false;
   if (!argv.includes(BACKGROUND_ARG)) return false;
@@ -72,7 +26,7 @@ export function shouldHandleHelpOnlyAtEntry(argv: string[], env: NodeJS.ProcessE
   return args.help && !shouldStartApp(args);
 }
 
-export function sanitizeStartupEnv(baseEnv: NodeJS.ProcessEnv): NodeJS.ProcessEnv {
+export function sanitizeHelpEnv(baseEnv: NodeJS.ProcessEnv): NodeJS.ProcessEnv {
   const env = { ...baseEnv };
   if (!env.NODE_NO_WARNINGS) {
     env.NODE_NO_WARNINGS = '1';
@@ -81,12 +35,8 @@ export function sanitizeStartupEnv(baseEnv: NodeJS.ProcessEnv): NodeJS.ProcessEn
   return env;
 }
 
-export function sanitizeHelpEnv(baseEnv: NodeJS.ProcessEnv): NodeJS.ProcessEnv {
-  return sanitizeStartupEnv(baseEnv);
-}
-
 export function sanitizeBackgroundEnv(baseEnv: NodeJS.ProcessEnv): NodeJS.ProcessEnv {
-  const env = sanitizeStartupEnv(baseEnv);
+  const env = sanitizeHelpEnv(baseEnv);
   env[BACKGROUND_CHILD_ENV] = '1';
   return env;
 }

src/main-entry.ts

@@ -1,8 +1,6 @@
 import { spawn } from 'node:child_process';
 import { printHelp } from './cli/help';
 import {
-  normalizeStartupArgv,
-  sanitizeStartupEnv,
   sanitizeBackgroundEnv,
   sanitizeHelpEnv,
   shouldDetachBackgroundLaunch,
@@ -11,21 +9,6 @@ import {
 
 const DEFAULT_TEXTHOOKER_PORT = 5174;
 
-function applySanitizedEnv(sanitizedEnv: NodeJS.ProcessEnv): void {
-  if (sanitizedEnv.NODE_NO_WARNINGS) {
-    process.env.NODE_NO_WARNINGS = sanitizedEnv.NODE_NO_WARNINGS;
-  }
-
-  if (sanitizedEnv.VK_INSTANCE_LAYERS) {
-    process.env.VK_INSTANCE_LAYERS = sanitizedEnv.VK_INSTANCE_LAYERS;
-  } else {
-    delete process.env.VK_INSTANCE_LAYERS;
-  }
-}
-
-process.argv = normalizeStartupArgv(process.argv, process.env);
-applySanitizedEnv(sanitizeStartupEnv(process.env));
-
 if (shouldDetachBackgroundLaunch(process.argv, process.env)) {
   const child = spawn(process.execPath, process.argv.slice(1), {
     detached: true,

src/main.ts

@@ -239,11 +239,6 @@ import {
   resolveKeybindings,
   showDesktopNotification,
 } from './core/utils';
-import {
-  ensureDefaultConfigBootstrap,
-  getDefaultConfigFilePaths,
-  resolveDefaultMpvInstallPaths,
-} from './shared/setup-state';
 import {
   ImmersionTrackerService,
   JellyfinRemoteSessionService,
@@ -301,21 +296,6 @@ import {
   upsertYomitanDictionarySettings,
   updateLastCardFromClipboard as updateLastCardFromClipboardCore,
 } from './core/services';
-import {
-  createFirstRunSetupService,
-  shouldAutoOpenFirstRunSetup,
-} from './main/runtime/first-run-setup-service';
-import {
-  buildFirstRunSetupHtml,
-  createMaybeFocusExistingFirstRunSetupWindowHandler,
-  createOpenFirstRunSetupWindowHandler,
-  parseFirstRunSetupSubmissionUrl,
-  type FirstRunSetupAction,
-} from './main/runtime/first-run-setup-window';
-import {
-  detectInstalledFirstRunPlugin,
-  installFirstRunPluginToDefaultLocation,
-} from './main/runtime/first-run-setup-plugin';
 import { createImmersionTrackerStartupHandler } from './main/runtime/immersion-startup';
 import { createBuildImmersionTrackerStartupMainDepsHandler } from './main/runtime/immersion-startup-main-deps';
 import { createAnilistUpdateQueue } from './core/services/anilist/anilist-update-queue';
@@ -395,7 +375,7 @@ if (process.platform === 'linux') {
     getPasswordStoreArg(process.argv) ?? getDefaultPasswordStore(),
   );
   app.commandLine.appendSwitch('password-store', passwordStore);
-  createLogger('main').debug(`Applied --password-store ${passwordStore}`);
+  console.debug(`[main] Applied --password-store ${passwordStore}`);
 }
 
 app.setName('SubMiner');
@@ -515,7 +495,6 @@ const anilistUpdateQueue = createAnilistUpdateQueue(
 const isDev = process.argv.includes('--dev') || process.argv.includes('--debug');
 const texthookerService = new Texthooker();
 const subtitleWsService = new SubtitleWebSocket();
-const annotationSubtitleWsService = new SubtitleWebSocket();
 const logger = createLogger('main');
 notifyAnilistTokenStoreWarning = (message: string) => {
   logger.warn(`[AniList] ${message}`);
@@ -622,41 +601,6 @@ const appState = createAppState({
   mpvSocketPath: getDefaultSocketPath(),
   texthookerPort: DEFAULT_TEXTHOOKER_PORT,
 });
-let firstRunSetupMessage: string | null = null;
-const firstRunSetupService = createFirstRunSetupService({
-  configDir: CONFIG_DIR,
-  getYomitanDictionaryCount: async () => {
-    await ensureYomitanExtensionLoaded();
-    const dictionaries = await getYomitanDictionaryInfo(getYomitanParserRuntimeDeps(), {
-      error: (message, ...args) => logger.error(message, ...args),
-      info: (message, ...args) => logger.info(message, ...args),
-    });
-    return dictionaries.length;
-  },
-  detectPluginInstalled: () => {
-    const installPaths = resolveDefaultMpvInstallPaths(
-      process.platform,
-      os.homedir(),
-      process.env.XDG_CONFIG_HOME,
-    );
-    return detectInstalledFirstRunPlugin(installPaths);
-  },
-  installPlugin: async () =>
-    installFirstRunPluginToDefaultLocation({
-      platform: process.platform,
-      homeDir: os.homedir(),
-      xdgConfigHome: process.env.XDG_CONFIG_HOME,
-      dirname: __dirname,
-      appPath: app.getAppPath(),
-      resourcesPath: process.resourcesPath,
-    }),
-  onStateChanged: (state) => {
-    appState.firstRunSetupCompleted = state.status === 'completed';
-    if (appTray) {
-      ensureTray();
-    }
-  },
-});
 const discordPresenceSessionStartedAtMs = Date.now();
 let discordPresenceMediaDurationSec: number | null = null;
 
@@ -946,11 +890,6 @@ const buildSubtitleProcessingControllerMainDepsHandler =
         topX: getResolvedConfig().subtitleStyle.frequencyDictionary.topX,
         mode: getResolvedConfig().subtitleStyle.frequencyDictionary.mode,
       });
-      annotationSubtitleWsService.broadcast(payload, {
-        enabled: getResolvedConfig().subtitleStyle.frequencyDictionary.enabled,
-        topX: getResolvedConfig().subtitleStyle.frequencyDictionary.topX,
-        mode: getResolvedConfig().subtitleStyle.frequencyDictionary.mode,
-      });
     },
     logDebug: (message) => {
       logger.debug(`[subtitle-processing] ${message}`);
@@ -1208,8 +1147,6 @@ const characterDictionaryRuntime = createCharacterDictionaryRuntimeService({
   getCurrentMediaTitle: () => appState.currentMediaTitle,
   resolveMediaPathForJimaku: (mediaPath) => mediaRuntime.resolveMediaPathForJimaku(mediaPath),
   guessAnilistMediaInfo: (mediaPath, mediaTitle) => guessAnilistMediaInfo(mediaPath, mediaTitle),
-  getCollapsibleSectionOpenState: (section) =>
-    getResolvedConfig().anilist.characterDictionary.collapsibleSections[section],
   now: () => Date.now(),
   logInfo: (message) => logger.info(message),
   logWarn: (message) => logger.warn(message),
@@ -1657,95 +1594,6 @@ const {
   },
 });
 
-const maybeFocusExistingFirstRunSetupWindow = createMaybeFocusExistingFirstRunSetupWindowHandler({
-  getSetupWindow: () => appState.firstRunSetupWindow,
-});
-const openFirstRunSetupWindowHandler = createOpenFirstRunSetupWindowHandler({
-  maybeFocusExistingSetupWindow: maybeFocusExistingFirstRunSetupWindow,
-  createSetupWindow: () =>
-    new BrowserWindow({
-      width: 480,
-      height: 460,
-      title: 'SubMiner Setup',
-      show: true,
-      autoHideMenuBar: true,
-      resizable: false,
-      minimizable: false,
-      maximizable: false,
-      webPreferences: {
-        nodeIntegration: false,
-        contextIsolation: true,
-      },
-    }),
-  getSetupSnapshot: async () => {
-    const snapshot = await firstRunSetupService.getSetupStatus();
-    return {
-      configReady: snapshot.configReady,
-      dictionaryCount: snapshot.dictionaryCount,
-      canFinish: snapshot.canFinish,
-      pluginStatus: snapshot.pluginStatus,
-      pluginInstallPathSummary: snapshot.pluginInstallPathSummary,
-      message: firstRunSetupMessage,
-    };
-  },
-  buildSetupHtml: (model) => buildFirstRunSetupHtml(model),
-  parseSubmissionUrl: (rawUrl) => parseFirstRunSetupSubmissionUrl(rawUrl),
-  handleAction: async (action: FirstRunSetupAction) => {
-    if (action === 'install-plugin') {
-      const snapshot = await firstRunSetupService.installMpvPlugin();
-      firstRunSetupMessage = snapshot.message;
-      return;
-    }
-    if (action === 'open-yomitan-settings') {
-      openYomitanSettings();
-      firstRunSetupMessage = 'Opened Yomitan settings. Install dictionaries, then refresh status.';
-      return;
-    }
-    if (action === 'refresh') {
-      const snapshot = await firstRunSetupService.refreshStatus('Status refreshed.');
-      firstRunSetupMessage = snapshot.message;
-      return;
-    }
-    if (action === 'skip-plugin') {
-      await firstRunSetupService.skipPluginInstall();
-      firstRunSetupMessage = 'mpv plugin installation skipped.';
-      return;
-    }
-
-    const snapshot = await firstRunSetupService.markSetupCompleted();
-    if (snapshot.state.status === 'completed') {
-      firstRunSetupMessage = null;
-      return { closeWindow: true };
-    }
-    firstRunSetupMessage = 'Install at least one Yomitan dictionary before finishing setup.';
-    return;
-  },
-  markSetupInProgress: async () => {
-    firstRunSetupMessage = null;
-    await firstRunSetupService.markSetupInProgress();
-  },
-  markSetupCancelled: async () => {
-    firstRunSetupMessage = null;
-    await firstRunSetupService.markSetupCancelled();
-  },
-  isSetupCompleted: () => firstRunSetupService.isSetupCompleted(),
-  clearSetupWindow: () => {
-    appState.firstRunSetupWindow = null;
-  },
-  setSetupWindow: (window) => {
-    appState.firstRunSetupWindow = window as BrowserWindow;
-  },
-  encodeURIComponent: (value) => encodeURIComponent(value),
-  logError: (message, error) => logger.error(message, error),
-});
-
-function openFirstRunSetupWindow(): void {
-  if (firstRunSetupService.isSetupCompleted()) {
-    return;
-  }
-  openFirstRunSetupWindowHandler();
-}
-
 const {
   notifyAnilistSetup,
   consumeAnilistSetupTokenFromUrl,
@@ -1798,7 +1646,7 @@ const {
       appPath
         ? app.setAsDefaultProtocolClient(scheme, appPath, args)
         : app.setAsDefaultProtocolClient(scheme),
-    logDebug: (message, details) => logger.debug(message, details),
+    logWarn: (message, details) => logger.warn(message, details),
   },
 });
 
@@ -2168,10 +2016,7 @@ const {
       restoreOverlayMpvSubtitles();
     },
     unregisterAllGlobalShortcuts: () => globalShortcut.unregisterAll(),
-    stopSubtitleWebsocket: () => {
-      subtitleWsService.stop();
-      annotationSubtitleWsService.stop();
-    },
+    stopSubtitleWebsocket: () => subtitleWsService.stop(),
     stopTexthookerService: () => texthookerService.stop(),
     getYomitanParserWindow: () => appState.yomitanParserWindow,
     clearYomitanParserState: () => {
@@ -2276,13 +2121,6 @@ const { appReadyRuntimeRunner } = composeAppReadyRuntime({
     },
   },
   appReadyRuntimeMainDeps: {
-    ensureDefaultConfigBootstrap: () => {
-      ensureDefaultConfigBootstrap({
-        configDir: CONFIG_DIR,
-        configFilePaths: getDefaultConfigFilePaths(CONFIG_DIR),
-        generateTemplate: () => generateConfigTemplate(DEFAULT_CONFIG),
-      });
-    },
     loadSubtitlePosition: () => loadSubtitlePosition(),
     resolveKeybindings: () => {
       appState.keybindings = resolveKeybindings(getResolvedConfig(), DEFAULT_KEYBINDINGS);
@@ -2317,49 +2155,9 @@ const { appReadyRuntimeRunner } = composeAppReadyRuntime({
     },
     defaultSecondarySubMode: 'hover',
     defaultWebsocketPort: DEFAULT_CONFIG.websocket.port,
-    defaultAnnotationWebsocketPort: DEFAULT_CONFIG.annotationWebsocket.port,
-    defaultTexthookerPort: DEFAULT_TEXTHOOKER_PORT,
     hasMpvWebsocketPlugin: () => hasMpvWebsocketPlugin(),
     startSubtitleWebsocket: (port: number) => {
-      subtitleWsService.start(
-        port,
-        () =>
-          appState.currentSubtitleData ??
-          (appState.currentSubText
-            ? {
-                text: appState.currentSubText,
-                tokens: null,
-              }
-            : null),
-        () => ({
-          enabled: getResolvedConfig().subtitleStyle.frequencyDictionary.enabled,
-          topX: getResolvedConfig().subtitleStyle.frequencyDictionary.topX,
-          mode: getResolvedConfig().subtitleStyle.frequencyDictionary.mode,
-        }),
-      );
-    },
-    startAnnotationWebsocket: (port: number) => {
-      annotationSubtitleWsService.start(
-        port,
-        () =>
-          appState.currentSubtitleData ??
-          (appState.currentSubText
-            ? {
-                text: appState.currentSubText,
-                tokens: null,
-              }
-            : null),
-        () => ({
-          enabled: getResolvedConfig().subtitleStyle.frequencyDictionary.enabled,
-          topX: getResolvedConfig().subtitleStyle.frequencyDictionary.topX,
-          mode: getResolvedConfig().subtitleStyle.frequencyDictionary.mode,
-        }),
-      );
-    },
-    startTexthooker: (port: number, websocketUrl?: string) => {
-      if (!texthookerService.isRunning()) {
-        texthookerService.start(port, websocketUrl);
-      }
+      subtitleWsService.start(port, () => appState.currentSubText);
     },
     log: (message) => appLogger.logInfo(message),
     createMecabTokenizerAndCheck: async () => {
@@ -2372,17 +2170,6 @@ const { appReadyRuntimeRunner } = composeAppReadyRuntime({
     loadYomitanExtension: async () => {
       await loadYomitanExtension();
     },
-    handleFirstRunSetup: async () => {
-      const snapshot = await firstRunSetupService.ensureSetupStateInitialized();
-      appState.firstRunSetupCompleted = snapshot.state.status === 'completed';
-      if (
-        appState.initialArgs &&
-        shouldAutoOpenFirstRunSetup(appState.initialArgs) &&
-        snapshot.state.status !== 'completed'
-      ) {
-        openFirstRunSetupWindow();
-      }
-    },
     startJellyfinRemoteSession: async () => {
       await startJellyfinRemoteSession();
     },
@@ -2403,9 +2190,7 @@ const { appReadyRuntimeRunner } = composeAppReadyRuntime({
     shouldSkipHeavyStartup: () =>
       Boolean(
         appState.initialArgs &&
-        (shouldRunSettingsOnlyStartup(appState.initialArgs) ||
-          appState.initialArgs.dictionary ||
-          appState.initialArgs.setup),
+          (shouldRunSettingsOnlyStartup(appState.initialArgs) || appState.initialArgs.dictionary),
       ),
     createImmersionTracker: () => {
       ensureImmersionTrackerStarted();
@@ -2418,64 +2203,65 @@ const { appReadyRuntimeRunner } = composeAppReadyRuntime({
   immersionTrackerStartupMainDeps,
 });
 
-const { runAndApplyStartupState } = runtimeRegistry.startup.createStartupRuntimeHandlers<
-  CliArgs,
-  StartupState,
-  ReturnType<typeof createStartupBootstrapRuntimeDeps>
->({
-  appLifecycleRuntimeRunnerMainDeps: {
-    app,
-    platform: process.platform,
-    shouldStartApp: (nextArgs: CliArgs) => shouldStartApp(nextArgs),
-    parseArgs: (argv: string[]) => parseArgs(argv),
-    handleCliCommand: (nextArgs: CliArgs, source: CliCommandSource) =>
-      handleCliCommand(nextArgs, source),
-    printHelp: () => printHelp(DEFAULT_TEXTHOOKER_PORT),
-    logNoRunningInstance: () => appLogger.logNoRunningInstance(),
-    onReady: appReadyRuntimeRunner,
-    onWillQuitCleanup: () => onWillQuitCleanupHandler(),
-    shouldRestoreWindowsOnActivate: () => shouldRestoreWindowsOnActivateHandler(),
-    restoreWindowsOnActivate: () => restoreWindowsOnActivateHandler(),
-    shouldQuitOnWindowAllClosed: () => !appState.backgroundMode,
-  },
-  createAppLifecycleRuntimeRunner: (params) => createAppLifecycleRuntimeRunner(params),
-  buildStartupBootstrapMainDeps: (startAppLifecycle) => ({
-    argv: process.argv,
-    parseArgs: (argv: string[]) => parseArgs(argv),
-    setLogLevel: (level: string, source: LogLevelSource) => {
-      setLogLevel(level, source);
+const { runAndApplyStartupState } =
+  runtimeRegistry.startup.createStartupRuntimeHandlers<
+    CliArgs,
+    StartupState,
+    ReturnType<typeof createStartupBootstrapRuntimeDeps>
+  >({
+    appLifecycleRuntimeRunnerMainDeps: {
+      app,
+      platform: process.platform,
+      shouldStartApp: (nextArgs: CliArgs) => shouldStartApp(nextArgs),
+      parseArgs: (argv: string[]) => parseArgs(argv),
+      handleCliCommand: (nextArgs: CliArgs, source: CliCommandSource) =>
+        handleCliCommand(nextArgs, source),
+      printHelp: () => printHelp(DEFAULT_TEXTHOOKER_PORT),
+      logNoRunningInstance: () => appLogger.logNoRunningInstance(),
+      onReady: appReadyRuntimeRunner,
+      onWillQuitCleanup: () => onWillQuitCleanupHandler(),
+      shouldRestoreWindowsOnActivate: () => shouldRestoreWindowsOnActivateHandler(),
+      restoreWindowsOnActivate: () => restoreWindowsOnActivateHandler(),
+      shouldQuitOnWindowAllClosed: () => !appState.backgroundMode,
     },
-    forceX11Backend: (args: CliArgs) => {
-      forceX11Backend(args);
-    },
-    enforceUnsupportedWaylandMode: (args: CliArgs) => {
-      enforceUnsupportedWaylandMode(args);
-    },
-    shouldStartApp: (args: CliArgs) => shouldStartApp(args),
-    getDefaultSocketPath: () => getDefaultSocketPath(),
-    defaultTexthookerPort: DEFAULT_TEXTHOOKER_PORT,
-    configDir: CONFIG_DIR,
-    defaultConfig: DEFAULT_CONFIG,
-    generateConfigTemplate: (config: ResolvedConfig) => generateConfigTemplate(config),
-    generateDefaultConfigFile: (
-      args: CliArgs,
-      options: {
-        configDir: string;
-        defaultConfig: unknown;
-        generateTemplate: (config: unknown) => string;
+    createAppLifecycleRuntimeRunner: (params) => createAppLifecycleRuntimeRunner(params),
+    buildStartupBootstrapMainDeps: (startAppLifecycle) => ({
+      argv: process.argv,
+      parseArgs: (argv: string[]) => parseArgs(argv),
+      setLogLevel: (level: string, source: LogLevelSource) => {
+        setLogLevel(level, source);
       },
-    ) => generateDefaultConfigFile(args, options),
-    setExitCode: (code) => {
-      process.exitCode = code;
-    },
-    quitApp: () => app.quit(),
-    logGenerateConfigError: (message) => logger.error(message),
-    startAppLifecycle,
-  }),
-  createStartupBootstrapRuntimeDeps: (deps) => createStartupBootstrapRuntimeDeps(deps),
-  runStartupBootstrapRuntime,
-  applyStartupState: (startupState) => applyStartupState(appState, startupState),
-});
+      forceX11Backend: (args: CliArgs) => {
+        forceX11Backend(args);
+      },
+      enforceUnsupportedWaylandMode: (args: CliArgs) => {
+        enforceUnsupportedWaylandMode(args);
+      },
+      shouldStartApp: (args: CliArgs) => shouldStartApp(args),
+      getDefaultSocketPath: () => getDefaultSocketPath(),
+      defaultTexthookerPort: DEFAULT_TEXTHOOKER_PORT,
+      configDir: CONFIG_DIR,
+      defaultConfig: DEFAULT_CONFIG,
+      generateConfigTemplate: (config: ResolvedConfig) => generateConfigTemplate(config),
+      generateDefaultConfigFile: (
+        args: CliArgs,
+        options: {
+          configDir: string;
+          defaultConfig: unknown;
+          generateTemplate: (config: unknown) => string;
+        },
+      ) => generateDefaultConfigFile(args, options),
+      setExitCode: (code) => {
+        process.exitCode = code;
+      },
+      quitApp: () => app.quit(),
+      logGenerateConfigError: (message) => logger.error(message),
+      startAppLifecycle,
+    }),
+    createStartupBootstrapRuntimeDeps: (deps) => createStartupBootstrapRuntimeDeps(deps),
+    runStartupBootstrapRuntime,
+    applyStartupState: (startupState) => applyStartupState(appState, startupState),
+  });
 
 runAndApplyStartupState();
 if (isAnilistTrackingEnabled(getResolvedConfig())) {
@@ -3201,7 +2987,6 @@ const { registerIpcRuntimeHandlers } = composeIpcRuntimeHandlers({
       shiftSubtitleDelayToAdjacentCueHandler(direction),
     sendMpvCommand: (rawCommand: (string | number)[]) =>
       sendMpvCommandRuntime(appState.mpvClient, rawCommand),
-    getMpvClient: () => appState.mpvClient,
     isMpvConnected: () => Boolean(appState.mpvClient && appState.mpvClient.connected),
     hasRuntimeOptionsManager: () => appState.runtimeOptionsManager !== null,
   },
@@ -3305,7 +3090,6 @@ const createCliCommandContextHandler = createCliCommandContextFactory({
   showMpvOsd: (text: string) => showMpvOsd(text),
   initializeOverlayRuntime: () => initializeOverlayRuntime(),
   toggleVisibleOverlay: () => toggleVisibleOverlay(),
-  openFirstRunSetupWindow: () => openFirstRunSetupWindow(),
   setVisibleOverlayVisible: (visible: boolean) => setVisibleOverlayVisible(visible),
   copyCurrentSubtitle: () => copyCurrentSubtitle(),
   startPendingMultiCopy: (timeoutMs: number) => startPendingMultiCopy(timeoutMs),
@@ -3340,75 +3124,72 @@ const createCliCommandContextHandler = createCliCommandContextFactory({
 });
 const { createMainWindow: createMainWindowHandler, createModalWindow: createModalWindowHandler } =
   createOverlayWindowRuntimeHandlers<BrowserWindow>({
-    createOverlayWindowDeps: {
-      createOverlayWindowCore: (kind, options) => createOverlayWindowCore(kind, options),
-      isDev,
-      ensureOverlayWindowLevel: (window) => ensureOverlayWindowLevel(window),
-      onRuntimeOptionsChanged: () => broadcastRuntimeOptionsChanged(),
-      setOverlayDebugVisualizationEnabled: (enabled) =>
-        setOverlayDebugVisualizationEnabled(enabled),
-      isOverlayVisible: (windowKind) =>
-        windowKind === 'visible' ? overlayManager.getVisibleOverlayVisible() : false,
-      tryHandleOverlayShortcutLocalFallback: (input) =>
-        overlayShortcutsRuntime.tryHandleOverlayShortcutLocalFallback(input),
-      onWindowClosed: (windowKind) => {
-        if (windowKind === 'visible') {
-          overlayManager.setMainWindow(null);
-        } else {
-          overlayManager.setModalWindow(null);
-        }
-      },
+  createOverlayWindowDeps: {
+    createOverlayWindowCore: (kind, options) => createOverlayWindowCore(kind, options),
+    isDev,
+    ensureOverlayWindowLevel: (window) => ensureOverlayWindowLevel(window),
+    onRuntimeOptionsChanged: () => broadcastRuntimeOptionsChanged(),
+    setOverlayDebugVisualizationEnabled: (enabled) => setOverlayDebugVisualizationEnabled(enabled),
+    isOverlayVisible: (windowKind) =>
+      windowKind === 'visible' ? overlayManager.getVisibleOverlayVisible() : false,
+    tryHandleOverlayShortcutLocalFallback: (input) =>
+      overlayShortcutsRuntime.tryHandleOverlayShortcutLocalFallback(input),
+    onWindowClosed: (windowKind) => {
+      if (windowKind === 'visible') {
+        overlayManager.setMainWindow(null);
+      } else {
+        overlayManager.setModalWindow(null);
+      }
     },
-    setMainWindow: (window) => overlayManager.setMainWindow(window),
-    setModalWindow: (window) => overlayManager.setModalWindow(window),
-  });
+  },
+  setMainWindow: (window) => overlayManager.setMainWindow(window),
+  setModalWindow: (window) => overlayManager.setModalWindow(window),
+});
 const { ensureTray: ensureTrayHandler, destroyTray: destroyTrayHandler } =
   createTrayRuntimeHandlers({
-    resolveTrayIconPathDeps: {
-      resolveTrayIconPathRuntime,
-      platform: process.platform,
-      resourcesPath: process.resourcesPath,
-      appPath: app.getAppPath(),
-      dirname: __dirname,
-      joinPath: (...parts) => path.join(...parts),
-      fileExists: (candidate) => fs.existsSync(candidate),
+  resolveTrayIconPathDeps: {
+    resolveTrayIconPathRuntime,
+    platform: process.platform,
+    resourcesPath: process.resourcesPath,
+    appPath: app.getAppPath(),
+    dirname: __dirname,
+    joinPath: (...parts) => path.join(...parts),
+    fileExists: (candidate) => fs.existsSync(candidate),
+  },
+  buildTrayMenuTemplateDeps: {
+    buildTrayMenuTemplateRuntime,
+    initializeOverlayRuntime: () => initializeOverlayRuntime(),
+    isOverlayRuntimeInitialized: () => appState.overlayRuntimeInitialized,
+    setVisibleOverlayVisible: (visible) => setVisibleOverlayVisible(visible),
+    openYomitanSettings: () => openYomitanSettings(),
+    openRuntimeOptionsPalette: () => openRuntimeOptionsPalette(),
+    openJellyfinSetupWindow: () => openJellyfinSetupWindow(),
+    openAnilistSetupWindow: () => openAnilistSetupWindow(),
+    quitApp: () => app.quit(),
+  },
+  ensureTrayDeps: {
+    getTray: () => appTray,
+    setTray: (tray) => {
+      appTray = tray as Tray | null;
     },
-    buildTrayMenuTemplateDeps: {
-      buildTrayMenuTemplateRuntime,
-      initializeOverlayRuntime: () => initializeOverlayRuntime(),
-      isOverlayRuntimeInitialized: () => appState.overlayRuntimeInitialized,
-      setVisibleOverlayVisible: (visible) => setVisibleOverlayVisible(visible),
-      showFirstRunSetup: () => !firstRunSetupService.isSetupCompleted(),
-      openFirstRunSetupWindow: () => openFirstRunSetupWindow(),
-      openYomitanSettings: () => openYomitanSettings(),
-      openRuntimeOptionsPalette: () => openRuntimeOptionsPalette(),
-      openJellyfinSetupWindow: () => openJellyfinSetupWindow(),
-      openAnilistSetupWindow: () => openAnilistSetupWindow(),
-      quitApp: () => app.quit(),
+    createImageFromPath: (iconPath) => nativeImage.createFromPath(iconPath),
+    createEmptyImage: () => nativeImage.createEmpty(),
+    createTray: (icon) => new Tray(icon as ConstructorParameters<typeof Tray>[0]),
+    trayTooltip: TRAY_TOOLTIP,
+    platform: process.platform,
+    logWarn: (message) => logger.warn(message),
+    initializeOverlayRuntime: () => initializeOverlayRuntime(),
+    isOverlayRuntimeInitialized: () => appState.overlayRuntimeInitialized,
+    setVisibleOverlayVisible: (visible) => setVisibleOverlayVisible(visible),
+  },
+  destroyTrayDeps: {
+    getTray: () => appTray,
+    setTray: (tray) => {
+      appTray = tray as Tray | null;
     },
-    ensureTrayDeps: {
-      getTray: () => appTray,
-      setTray: (tray) => {
-        appTray = tray as Tray | null;
-      },
-      createImageFromPath: (iconPath) => nativeImage.createFromPath(iconPath),
-      createEmptyImage: () => nativeImage.createEmpty(),
-      createTray: (icon) => new Tray(icon as ConstructorParameters<typeof Tray>[0]),
-      trayTooltip: TRAY_TOOLTIP,
-      platform: process.platform,
-      logWarn: (message) => logger.warn(message),
-      initializeOverlayRuntime: () => initializeOverlayRuntime(),
-      isOverlayRuntimeInitialized: () => appState.overlayRuntimeInitialized,
-      setVisibleOverlayVisible: (visible) => setVisibleOverlayVisible(visible),
-    },
-    destroyTrayDeps: {
-      getTray: () => appTray,
-      setTray: (tray) => {
-        appTray = tray as Tray | null;
-      },
-    },
-    buildMenuFromTemplate: (template) => Menu.buildFromTemplate(template),
-  });
+  },
+  buildMenuFromTemplate: (template) => Menu.buildFromTemplate(template),
+});
 const yomitanExtensionRuntime = createYomitanExtensionRuntime({
   loadYomitanExtensionCore,
   userDataPath: USER_DATA_PATH,

src/main/app-lifecycle.ts

@@ -19,7 +19,6 @@ export interface AppLifecycleRuntimeDepsFactoryInput {
 }
 
 export interface AppReadyRuntimeDepsFactoryInput {
-  ensureDefaultConfigBootstrap: AppReadyRuntimeDeps['ensureDefaultConfigBootstrap'];
   loadSubtitlePosition: AppReadyRuntimeDeps['loadSubtitlePosition'];
   resolveKeybindings: AppReadyRuntimeDeps['resolveKeybindings'];
   createMpvClient: AppReadyRuntimeDeps['createMpvClient'];
@@ -31,12 +30,8 @@ export interface AppReadyRuntimeDepsFactoryInput {
   setSecondarySubMode: AppReadyRuntimeDeps['setSecondarySubMode'];
   defaultSecondarySubMode: AppReadyRuntimeDeps['defaultSecondarySubMode'];
   defaultWebsocketPort: AppReadyRuntimeDeps['defaultWebsocketPort'];
-  defaultAnnotationWebsocketPort: AppReadyRuntimeDeps['defaultAnnotationWebsocketPort'];
-  defaultTexthookerPort: AppReadyRuntimeDeps['defaultTexthookerPort'];
   hasMpvWebsocketPlugin: AppReadyRuntimeDeps['hasMpvWebsocketPlugin'];
   startSubtitleWebsocket: AppReadyRuntimeDeps['startSubtitleWebsocket'];
-  startAnnotationWebsocket: AppReadyRuntimeDeps['startAnnotationWebsocket'];
-  startTexthooker: AppReadyRuntimeDeps['startTexthooker'];
   log: AppReadyRuntimeDeps['log'];
   setLogLevel: AppReadyRuntimeDeps['setLogLevel'];
   createMecabTokenizerAndCheck: AppReadyRuntimeDeps['createMecabTokenizerAndCheck'];
@@ -44,7 +39,6 @@ export interface AppReadyRuntimeDepsFactoryInput {
   createImmersionTracker?: AppReadyRuntimeDeps['createImmersionTracker'];
   startJellyfinRemoteSession?: AppReadyRuntimeDeps['startJellyfinRemoteSession'];
   loadYomitanExtension: AppReadyRuntimeDeps['loadYomitanExtension'];
-  handleFirstRunSetup: AppReadyRuntimeDeps['handleFirstRunSetup'];
   prewarmSubtitleDictionaries?: AppReadyRuntimeDeps['prewarmSubtitleDictionaries'];
   startBackgroundWarmups: AppReadyRuntimeDeps['startBackgroundWarmups'];
   texthookerOnlyMode: AppReadyRuntimeDeps['texthookerOnlyMode'];
@@ -81,7 +75,6 @@ export function createAppReadyRuntimeDeps(
   params: AppReadyRuntimeDepsFactoryInput,
 ): AppReadyRuntimeDeps {
   return {
-    ensureDefaultConfigBootstrap: params.ensureDefaultConfigBootstrap,
     loadSubtitlePosition: params.loadSubtitlePosition,
     resolveKeybindings: params.resolveKeybindings,
     createMpvClient: params.createMpvClient,
@@ -93,12 +86,8 @@ export function createAppReadyRuntimeDeps(
     setSecondarySubMode: params.setSecondarySubMode,
     defaultSecondarySubMode: params.defaultSecondarySubMode,
     defaultWebsocketPort: params.defaultWebsocketPort,
-    defaultAnnotationWebsocketPort: params.defaultAnnotationWebsocketPort,
-    defaultTexthookerPort: params.defaultTexthookerPort,
     hasMpvWebsocketPlugin: params.hasMpvWebsocketPlugin,
     startSubtitleWebsocket: params.startSubtitleWebsocket,
-    startAnnotationWebsocket: params.startAnnotationWebsocket,
-    startTexthooker: params.startTexthooker,
     log: params.log,
     setLogLevel: params.setLogLevel,
     createMecabTokenizerAndCheck: params.createMecabTokenizerAndCheck,
@@ -106,7 +95,6 @@ export function createAppReadyRuntimeDeps(
     createImmersionTracker: params.createImmersionTracker,
     startJellyfinRemoteSession: params.startJellyfinRemoteSession,
     loadYomitanExtension: params.loadYomitanExtension,
-    handleFirstRunSetup: params.handleFirstRunSetup,
     prewarmSubtitleDictionaries: params.prewarmSubtitleDictionaries,
     startBackgroundWarmups: params.startBackgroundWarmups,
     texthookerOnlyMode: params.texthookerOnlyMode,

src/main/character-dictionary-runtime.test.ts

@@ -220,9 +220,8 @@ test('generateForCurrentMedia emits structured-content glossary so image stays w
         (c as { tag?: string }).tag === 'details' &&
         Array.isArray((c as { content?: unknown[] }).content) &&
         (c as { content: Array<{ content?: string }> }).content[0]?.content === 'Description',
-    ) as { tag: string; open?: boolean; content: Array<Record<string, unknown>> } | undefined;
+    ) as { tag: string; content: Array<Record<string, unknown>> } | undefined;
     assert.ok(descSection, 'expected Description collapsible section');
-    assert.equal(descSection.open, false);
     const descBody = descSection.content[1] as { content: string };
     assert.ok(
       descBody.content.includes('Alexia Midgar is the second princess of the Kingdom of Midgar.'),
@@ -234,12 +233,11 @@ test('generateForCurrentMedia emits structured-content glossary so image stays w
         Array.isArray((c as { content?: unknown[] }).content) &&
         (c as { content: Array<{ content?: string }> }).content[0]?.content ===
           'Character Information',
-    ) as { tag: string; open?: boolean; content: Array<Record<string, unknown>> } | undefined;
+    ) as { tag: string; content: Array<Record<string, unknown>> } | undefined;
     assert.ok(
       infoSection,
       'expected Character Information collapsible section with parsed __Race:__ field',
     );
-    assert.equal(infoSection.open, false);
 
     const topLevelImageGlossaryEntry = glossary.find(
       (item) =>
@@ -251,330 +249,6 @@ test('generateForCurrentMedia emits structured-content glossary so image stays w
   }
 });
 
-test('generateForCurrentMedia applies configured open states to character dictionary sections', async () => {
-  const userDataPath = makeTempDir();
-  const originalFetch = globalThis.fetch;
-
-  globalThis.fetch = (async (input: string | URL | Request, init?: RequestInit) => {
-    const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
-    if (url === GRAPHQL_URL) {
-      const body = JSON.parse(String(init?.body ?? '{}')) as {
-        query?: string;
-      };
-
-      if (body.query?.includes('Page(perPage: 10)')) {
-        return new Response(
-          JSON.stringify({
-            data: {
-              Page: {
-                media: [
-                  {
-                    id: 130298,
-                    episodes: 20,
-                    title: {
-                      romaji: 'The Eminence in Shadow',
-                      english: 'The Eminence in Shadow',
-                      native: '陰の実力者になりたくて！',
-                    },
-                  },
-                ],
-              },
-            },
-          }),
-          { status: 200, headers: { 'content-type': 'application/json' } },
-        );
-      }
-
-      if (body.query?.includes('characters(page: $page')) {
-        return new Response(
-          JSON.stringify({
-            data: {
-              Media: {
-                title: {
-                  romaji: 'The Eminence in Shadow',
-                  english: 'The Eminence in Shadow',
-                  native: '陰の実力者になりたくて！',
-                },
-                characters: {
-                  pageInfo: { hasNextPage: false },
-                  edges: [
-                    {
-                      role: 'SUPPORTING',
-                      voiceActors: [
-                        {
-                          id: 456,
-                          name: {
-                            full: 'Rina Hidaka',
-                            native: '日高里菜',
-                          },
-                          image: {
-                            medium: 'https://cdn.example.com/va-456.jpg',
-                          },
-                        },
-                      ],
-                      node: {
-                        id: 123,
-                        description:
-                          'Alexia Midgar is the second princess of the Kingdom of Midgar.\n\n__Race:__ Human',
-                        image: {
-                          large: 'https://cdn.example.com/character-123.png',
-                          medium: 'https://cdn.example.com/character-123-small.png',
-                        },
-                        name: {
-                          full: 'Alexia Midgar',
-                          native: 'アレクシア・ミドガル',
-                        },
-                      },
-                    },
-                  ],
-                },
-              },
-            },
-          }),
-          { status: 200, headers: { 'content-type': 'application/json' } },
-        );
-      }
-    }
-
-    if (url === 'https://cdn.example.com/character-123.png') {
-      return new Response(Buffer.from([0x89, 0x50, 0x4e, 0x47]), {
-        status: 200,
-        headers: { 'content-type': 'image/png' },
-      });
-    }
-
-    if (url === 'https://cdn.example.com/va-456.jpg') {
-      return new Response(Buffer.from([0xff, 0xd8, 0xff, 0xd9]), {
-        status: 200,
-        headers: { 'content-type': 'image/jpeg' },
-      });
-    }
-
-    throw new Error(`Unexpected fetch: ${url}`);
-  }) as typeof globalThis.fetch;
-
-  try {
-    const runtime = createCharacterDictionaryRuntimeService({
-      userDataPath,
-      getCurrentMediaPath: () => '/tmp/eminence-s01e05.mkv',
-      getCurrentMediaTitle: () => 'The Eminence in Shadow - S01E05',
-      resolveMediaPathForJimaku: (mediaPath) => mediaPath,
-      guessAnilistMediaInfo: async () => ({
-        title: 'The Eminence in Shadow',
-        episode: 5,
-        source: 'fallback',
-      }),
-      getCollapsibleSectionOpenState: (section) =>
-        section === 'description' || section === 'voicedBy',
-      now: () => 1_700_000_000_000,
-    });
-
-    const result = await runtime.generateForCurrentMedia();
-    const termBank = JSON.parse(
-      readStoredZipEntry(result.zipPath, 'term_bank_1.json').toString('utf8'),
-    ) as Array<
-      [
-        string,
-        string,
-        string,
-        string,
-        number,
-        Array<string | Record<string, unknown>>,
-        number,
-        string,
-      ]
-    >;
-    const alexia = termBank.find(([term]) => term === 'アレクシア');
-    assert.ok(alexia);
-
-    const glossary = alexia[5];
-    const entry = glossary[0] as {
-      type: string;
-      content: { tag: string; content: Array<Record<string, unknown>> };
-    };
-    const children = entry.content.content;
-
-    const getSection = (title: string) =>
-      children.find(
-        (c) =>
-          (c as { tag?: string }).tag === 'details' &&
-          Array.isArray((c as { content?: unknown[] }).content) &&
-          (c as { content: Array<{ content?: string }> }).content[0]?.content === title,
-      ) as { open?: boolean } | undefined;
-
-    assert.equal(getSection('Description')?.open, true);
-    assert.equal(getSection('Character Information')?.open, false);
-    assert.equal(getSection('Voiced by')?.open, true);
-  } finally {
-    globalThis.fetch = originalFetch;
-  }
-});
-
-test('generateForCurrentMedia reapplies collapsible open states when using cached snapshot data', async () => {
-  const userDataPath = makeTempDir();
-  const originalFetch = globalThis.fetch;
-
-  globalThis.fetch = (async (input: string | URL | Request, init?: RequestInit) => {
-    const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
-    if (url === GRAPHQL_URL) {
-      const body = JSON.parse(String(init?.body ?? '{}')) as {
-        query?: string;
-      };
-
-      if (body.query?.includes('Page(perPage: 10)')) {
-        return new Response(
-          JSON.stringify({
-            data: {
-              Page: {
-                media: [
-                  {
-                    id: 130298,
-                    episodes: 20,
-                    title: {
-                      romaji: 'The Eminence in Shadow',
-                      english: 'The Eminence in Shadow',
-                      native: '陰の実力者になりたくて！',
-                    },
-                  },
-                ],
-              },
-            },
-          }),
-          { status: 200, headers: { 'content-type': 'application/json' } },
-        );
-      }
-
-      if (body.query?.includes('characters(page: $page')) {
-        return new Response(
-          JSON.stringify({
-            data: {
-              Media: {
-                title: {
-                  english: 'The Eminence in Shadow',
-                },
-                characters: {
-                  pageInfo: { hasNextPage: false },
-                  edges: [
-                    {
-                      role: 'SUPPORTING',
-                      voiceActors: [
-                        {
-                          id: 456,
-                          name: {
-                            full: 'Rina Hidaka',
-                            native: '日高里菜',
-                          },
-                          image: {
-                            medium: 'https://cdn.example.com/va-456.jpg',
-                          },
-                        },
-                      ],
-                      node: {
-                        id: 123,
-                        description:
-                          'Alexia Midgar is the second princess of the Kingdom of Midgar.\n\n__Race:__ Human',
-                        image: {
-                          large: 'https://cdn.example.com/character-123.png',
-                          medium: null,
-                        },
-                        name: {
-                          full: 'Alexia Midgar',
-                          native: 'アレクシア・ミドガル',
-                        },
-                      },
-                    },
-                  ],
-                },
-              },
-            },
-          }),
-          { status: 200, headers: { 'content-type': 'application/json' } },
-        );
-      }
-    }
-
-    if (url === 'https://cdn.example.com/character-123.png') {
-      return new Response(PNG_1X1, {
-        status: 200,
-        headers: { 'content-type': 'image/png' },
-      });
-    }
-
-    if (url === 'https://cdn.example.com/va-456.jpg') {
-      return new Response(PNG_1X1, {
-        status: 200,
-        headers: { 'content-type': 'image/png' },
-      });
-    }
-
-    throw new Error(`Unexpected fetch: ${url}`);
-  }) as typeof globalThis.fetch;
-
-  try {
-    const runtimeOpen = createCharacterDictionaryRuntimeService({
-      userDataPath,
-      getCurrentMediaPath: () => '/tmp/eminence-s01e05.mkv',
-      getCurrentMediaTitle: () => 'The Eminence in Shadow - S01E05',
-      resolveMediaPathForJimaku: (mediaPath) => mediaPath,
-      guessAnilistMediaInfo: async () => ({
-        title: 'The Eminence in Shadow',
-        episode: 5,
-        source: 'fallback',
-      }),
-      getCollapsibleSectionOpenState: () => true,
-      now: () => 1_700_000_000_000,
-    });
-    await runtimeOpen.generateForCurrentMedia();
-
-    const runtimeClosed = createCharacterDictionaryRuntimeService({
-      userDataPath,
-      getCurrentMediaPath: () => '/tmp/eminence-s01e05.mkv',
-      getCurrentMediaTitle: () => 'The Eminence in Shadow - S01E05',
-      resolveMediaPathForJimaku: (mediaPath) => mediaPath,
-      guessAnilistMediaInfo: async () => ({
-        title: 'The Eminence in Shadow',
-        episode: 5,
-        source: 'fallback',
-      }),
-      getCollapsibleSectionOpenState: () => false,
-      now: () => 1_700_000_000_500,
-    });
-    const result = await runtimeClosed.generateForCurrentMedia();
-
-    const termBank = JSON.parse(
-      readStoredZipEntry(result.zipPath, 'term_bank_1.json').toString('utf8'),
-    ) as Array<
-      [
-        string,
-        string,
-        string,
-        string,
-        number,
-        Array<string | Record<string, unknown>>,
-        number,
-        string,
-      ]
-    >;
-    const alexia = termBank.find(([term]) => term === 'アレクシア');
-    assert.ok(alexia);
-
-    const children = (
-      alexia[5][0] as {
-        content: { content: Array<Record<string, unknown>> };
-      }
-    ).content.content;
-    const sections = children.filter(
-      (item) => (item as { tag?: string }).tag === 'details',
-    ) as Array<{
-      open?: boolean;
-    }>;
-    assert.ok(sections.length >= 2);
-    assert.ok(sections.every((section) => section.open === false));
-  } finally {
-    globalThis.fetch = originalFetch;
-  }
-});
-
 test('generateForCurrentMedia adds kana aliases for romanized names when native name is kanji', async () => {
   const userDataPath = makeTempDir();
   const originalFetch = globalThis.fetch;
@@ -695,123 +369,6 @@ test('generateForCurrentMedia adds kana aliases for romanized names when native
   }
 });
 
-test('generateForCurrentMedia indexes AniList alternative character names for alias lookups', async () => {
-  const userDataPath = makeTempDir();
-  const originalFetch = globalThis.fetch;
-
-  globalThis.fetch = (async (input: string | URL | Request, init?: RequestInit) => {
-    const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
-    if (url === GRAPHQL_URL) {
-      const body = JSON.parse(String(init?.body ?? '{}')) as {
-        query?: string;
-      };
-
-      if (body.query?.includes('Page(perPage: 10)')) {
-        return new Response(
-          JSON.stringify({
-            data: {
-              Page: {
-                media: [
-                  {
-                    id: 130298,
-                    episodes: 20,
-                    title: {
-                      romaji: 'Kage no Jitsuryokusha ni Naritakute!',
-                      english: 'The Eminence in Shadow',
-                      native: '陰の実力者になりたくて！',
-                    },
-                  },
-                ],
-              },
-            },
-          }),
-          {
-            status: 200,
-            headers: { 'content-type': 'application/json' },
-          },
-        );
-      }
-
-      if (body.query?.includes('characters(page: $page')) {
-        return new Response(
-          JSON.stringify({
-            data: {
-              Media: {
-                title: {
-                  romaji: 'Kage no Jitsuryokusha ni Naritakute!',
-                  english: 'The Eminence in Shadow',
-                  native: '陰の実力者になりたくて！',
-                },
-                characters: {
-                  pageInfo: { hasNextPage: false },
-                  edges: [
-                    {
-                      role: 'MAIN',
-                      node: {
-                        id: 321,
-                        description: 'Leader of Shadow Garden.',
-                        image: null,
-                        name: {
-                          full: 'Cid Kagenou',
-                          native: 'シド・カゲノー',
-                          alternative: ['Shadow', 'Minoru Kagenou'],
-                        },
-                      },
-                    },
-                  ],
-                },
-              },
-            },
-          }),
-          {
-            status: 200,
-            headers: { 'content-type': 'application/json' },
-          },
-        );
-      }
-    }
-
-    throw new Error(`Unexpected fetch URL: ${url}`);
-  }) as typeof globalThis.fetch;
-
-  try {
-    const runtime = createCharacterDictionaryRuntimeService({
-      userDataPath,
-      getCurrentMediaPath: () => '/tmp/eminence-s01e05.mkv',
-      getCurrentMediaTitle: () => 'The Eminence in Shadow - S01E05',
-      resolveMediaPathForJimaku: (mediaPath) => mediaPath,
-      guessAnilistMediaInfo: async () => ({
-        title: 'The Eminence in Shadow',
-        episode: 5,
-        source: 'fallback',
-      }),
-      now: () => 1_700_000_000_000,
-    });
-
-    const result = await runtime.generateForCurrentMedia();
-    const termBank = JSON.parse(
-      readStoredZipEntry(result.zipPath, 'term_bank_1.json').toString('utf8'),
-    ) as Array<
-      [
-        string,
-        string,
-        string,
-        string,
-        number,
-        Array<string | Record<string, unknown>>,
-        number,
-        string,
-      ]
-    >;
-
-    const shadowKana = termBank.find(([term]) => term === 'シャドウ');
-    assert.ok(shadowKana, 'expected katakana alias from AniList alternative name');
-    assert.equal(shadowKana[1], 'しゃどう');
-  } finally {
-    globalThis.fetch = originalFetch;
-  }
-});
-
 test('getOrCreateCurrentSnapshot persists and reuses normalized snapshot data', async () => {
   const userDataPath = makeTempDir();
   const originalFetch = globalThis.fetch;
@@ -1601,308 +1158,6 @@ test('buildMergedDictionary combines stored snapshots into one stable dictionary
   }
 });
 
-test('buildMergedDictionary rebuilds snapshots written with an older format version', async () => {
-  const userDataPath = makeTempDir();
-  const originalFetch = globalThis.fetch;
-  let characterQueryCount = 0;
-
-  globalThis.fetch = (async (input: string | URL | Request, init?: RequestInit) => {
-    const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
-    if (url === GRAPHQL_URL) {
-      const body = JSON.parse(String(init?.body ?? '{}')) as {
-        query?: string;
-        variables?: Record<string, unknown>;
-      };
-
-      if (body.query?.includes('characters(page: $page')) {
-        characterQueryCount += 1;
-        assert.equal(body.variables?.id, 130298);
-        return new Response(
-          JSON.stringify({
-            data: {
-              Media: {
-                title: {
-                  english: 'The Eminence in Shadow',
-                },
-                characters: {
-                  pageInfo: { hasNextPage: false },
-                  edges: [
-                    {
-                      role: 'MAIN',
-                      node: {
-                        id: 111,
-                        description: 'Leader of Shadow Garden.',
-                        image: null,
-                        name: {
-                          full: 'Cid Kagenou',
-                          native: 'シド・カゲノー',
-                          alternative: ['Shadow'],
-                        },
-                      },
-                    },
-                  ],
-                },
-              },
-            },
-          }),
-          { status: 200, headers: { 'content-type': 'application/json' } },
-        );
-      }
-    }
-
-    throw new Error(`Unexpected fetch URL: ${url}`);
-  }) as typeof globalThis.fetch;
-
-  try {
-    const snapshotsDir = path.join(userDataPath, 'character-dictionaries', 'snapshots');
-    fs.mkdirSync(snapshotsDir, { recursive: true });
-    fs.writeFileSync(
-      path.join(snapshotsDir, 'anilist-130298.json'),
-      JSON.stringify({
-        formatVersion: 12,
-        mediaId: 130298,
-        mediaTitle: 'The Eminence in Shadow',
-        entryCount: 1,
-        updatedAt: 1_700_000_000_000,
-        termEntries: [['stale', '', 'name main', '', 100, ['stale'], 0, '']],
-        images: [],
-      }),
-      'utf8',
-    );
-
-    const runtime = createCharacterDictionaryRuntimeService({
-      userDataPath,
-      getCurrentMediaPath: () => null,
-      getCurrentMediaTitle: () => null,
-      resolveMediaPathForJimaku: (mediaPath) => mediaPath,
-      guessAnilistMediaInfo: async () => null,
-      now: () => 1_700_000_000_100,
-    });
-
-    const merged = await runtime.buildMergedDictionary([130298]);
-    const termBank = JSON.parse(
-      readStoredZipEntry(merged.zipPath, 'term_bank_1.json').toString('utf8'),
-    ) as Array<
-      [
-        string,
-        string,
-        string,
-        string,
-        number,
-        Array<string | Record<string, unknown>>,
-        number,
-        string,
-      ]
-    >;
-
-    assert.equal(characterQueryCount, 1);
-    assert.ok(termBank.find(([term]) => term === 'シャドウ'));
-  } finally {
-    globalThis.fetch = originalFetch;
-  }
-});
-
-test('buildMergedDictionary reapplies collapsible open states from current config', async () => {
-  const userDataPath = makeTempDir();
-  const originalFetch = globalThis.fetch;
-  const current = { title: 'The Eminence in Shadow', episode: 5 };
-
-  globalThis.fetch = (async (input: string | URL | Request, init?: RequestInit) => {
-    const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
-    if (url === GRAPHQL_URL) {
-      const body = JSON.parse(String(init?.body ?? '{}')) as {
-        query?: string;
-        variables?: Record<string, unknown>;
-      };
-
-      if (body.query?.includes('Page(perPage: 10)')) {
-        if (body.variables?.search === 'The Eminence in Shadow') {
-          return new Response(
-            JSON.stringify({
-              data: {
-                Page: {
-                  media: [
-                    {
-                      id: 130298,
-                      episodes: 20,
-                      title: {
-                        english: 'The Eminence in Shadow',
-                      },
-                    },
-                  ],
-                },
-              },
-            }),
-            { status: 200, headers: { 'content-type': 'application/json' } },
-          );
-        }
-
-        return new Response(
-          JSON.stringify({
-            data: {
-              Page: {
-                media: [
-                  {
-                    id: 21,
-                    episodes: 28,
-                    title: {
-                      english: 'Frieren: Beyond Journey’s End',
-                    },
-                  },
-                ],
-              },
-            },
-          }),
-          { status: 200, headers: { 'content-type': 'application/json' } },
-        );
-      }
-
-      if (body.query?.includes('characters(page: $page')) {
-        const mediaId = Number(body.variables?.id);
-        if (mediaId === 130298) {
-          return new Response(
-            JSON.stringify({
-              data: {
-                Media: {
-                  title: { english: 'The Eminence in Shadow' },
-                  characters: {
-                    pageInfo: { hasNextPage: false },
-                    edges: [
-                      {
-                        role: 'MAIN',
-                        node: {
-                          id: 111,
-                          description: 'Leader of Shadow Garden.',
-                          image: {
-                            large: 'https://example.com/alpha.png',
-                            medium: null,
-                          },
-                          name: {
-                            full: 'Alpha',
-                            native: 'アルファ',
-                          },
-                        },
-                      },
-                    ],
-                  },
-                },
-              },
-            }),
-            { status: 200, headers: { 'content-type': 'application/json' } },
-          );
-        }
-
-        return new Response(
-          JSON.stringify({
-            data: {
-              Media: {
-                title: { english: 'Frieren: Beyond Journey’s End' },
-                characters: {
-                  pageInfo: { hasNextPage: false },
-                  edges: [
-                    {
-                      role: 'MAIN',
-                      node: {
-                        id: 222,
-                        description: 'Elven mage.',
-                        image: {
-                          large: 'https://example.com/frieren.png',
-                          medium: null,
-                        },
-                        name: {
-                          full: 'Frieren',
-                          native: 'フリーレン',
-                        },
-                      },
-                    },
-                  ],
-                },
-              },
-            },
-          }),
-          { status: 200, headers: { 'content-type': 'application/json' } },
-        );
-      }
-    }
-
-    if (url === 'https://example.com/alpha.png' || url === 'https://example.com/frieren.png') {
-      return new Response(PNG_1X1, {
-        status: 200,
-        headers: { 'content-type': 'image/png' },
-      });
-    }
-
-    throw new Error(`Unexpected fetch URL: ${url}`);
-  }) as typeof globalThis.fetch;
-
-  try {
-    const runtimeOpen = createCharacterDictionaryRuntimeService({
-      userDataPath,
-      getCurrentMediaPath: () => '/tmp/current.mkv',
-      getCurrentMediaTitle: () => current.title,
-      resolveMediaPathForJimaku: (mediaPath) => mediaPath,
-      guessAnilistMediaInfo: async () => ({
-        title: current.title,
-        episode: current.episode,
-        source: 'fallback',
-      }),
-      getCollapsibleSectionOpenState: () => true,
-      now: () => 1_700_000_000_100,
-    });
-
-    await runtimeOpen.getOrCreateCurrentSnapshot();
-    current.title = 'Frieren: Beyond Journey’s End';
-    current.episode = 1;
-    await runtimeOpen.getOrCreateCurrentSnapshot();
-
-    const runtimeClosed = createCharacterDictionaryRuntimeService({
-      userDataPath,
-      getCurrentMediaPath: () => '/tmp/current.mkv',
-      getCurrentMediaTitle: () => current.title,
-      resolveMediaPathForJimaku: (mediaPath) => mediaPath,
-      guessAnilistMediaInfo: async () => ({
-        title: current.title,
-        episode: current.episode,
-        source: 'fallback',
-      }),
-      getCollapsibleSectionOpenState: () => false,
-      now: () => 1_700_000_000_200,
-    });
-
-    const merged = await runtimeClosed.buildMergedDictionary([21, 130298]);
-    const termBank = JSON.parse(
-      readStoredZipEntry(merged.zipPath, 'term_bank_1.json').toString('utf8'),
-    ) as Array<
-      [
-        string,
-        string,
-        string,
-        string,
-        number,
-        Array<string | Record<string, unknown>>,
-        number,
-        string,
-      ]
-    >;
-    const alpha = termBank.find(([term]) => term === 'アルファ');
-    assert.ok(alpha);
-    const children = (
-      alpha[5][0] as {
-        content: { content: Array<Record<string, unknown>> };
-      }
-    ).content.content;
-    const sections = children.filter(
-      (item) => (item as { tag?: string }).tag === 'details',
-    ) as Array<{
-      open?: boolean;
-    }>;
-    assert.ok(sections.length >= 1);
-    assert.ok(sections.every((section) => section.open === false));
-  } finally {
-    globalThis.fetch = originalFetch;
-  }
-});
-
 test('generateForCurrentMedia paces AniList requests and character image downloads', async () => {
   const userDataPath = makeTempDir();
   const originalFetch = globalThis.fetch;

src/main/character-dictionary-runtime.ts

@@ -3,7 +3,6 @@ import * as os from 'os';
 import * as path from 'path';
 import { createHash } from 'node:crypto';
 import type { AnilistMediaGuess } from '../core/services/anilist/anilist-updater';
-import type { AnilistCharacterDictionaryCollapsibleSectionKey } from '../types';
 import { hasVideoExtension } from '../shared/video-extensions';
 
 const ANILIST_GRAPHQL_URL = 'https://graphql.anilist.co';
@@ -55,7 +54,7 @@ export type CharacterDictionarySnapshot = {
   images: CharacterDictionarySnapshotImage[];
 };
 
-const CHARACTER_DICTIONARY_FORMAT_VERSION = 14;
+const CHARACTER_DICTIONARY_FORMAT_VERSION = 12;
 const CHARACTER_DICTIONARY_MERGED_TITLE = 'SubMiner Character Dictionary';
 
 type AniListSearchResponse = {
@@ -106,7 +105,6 @@ type AniListCharacterPageResponse = {
           name?: {
             full?: string | null;
             native?: string | null;
-            alternative?: Array<string | null> | null;
           } | null;
         } | null;
       } | null>;
@@ -126,7 +124,6 @@ type CharacterRecord = {
   role: CharacterDictionaryRole;
   fullName: string;
   nativeName: string;
-  alternativeNames: string[];
   description: string;
   imageUrl: string | null;
   voiceActors: VoiceActorRecord[];
@@ -181,9 +178,6 @@ export interface CharacterDictionaryRuntimeDeps {
   sleep?: (ms: number) => Promise<void>;
   logInfo?: (message: string) => void;
   logWarn?: (message: string) => void;
-  getCollapsibleSectionOpenState?: (
-    section: AnilistCharacterDictionaryCollapsibleSectionKey,
-  ) => boolean;
 }
 
 type ResolvedAniListMedia = {
@@ -429,7 +423,6 @@ const ROMANIZED_KANA_MONOGRAPHS: ReadonlyArray<[string, string]> = [
   ['re', 'レ'],
   ['ro', 'ロ'],
   ['wa', 'ワ'],
-  ['w', 'ウ'],
   ['wo', 'ヲ'],
   ['n', 'ン'],
 ];
@@ -497,60 +490,37 @@ function addRomanizedKanaAliases(values: Iterable<string>): string[] {
   return [...aliases];
 }
 
-function expandRawNameVariants(rawName: string): string[] {
-  const trimmed = rawName.trim();
-  if (!trimmed) return [];
-
-  const variants = new Set<string>([trimmed]);
-  const outer = trimmed
-    .replace(/[（(][^()（）]+[)）]/g, ' ')
-    .replace(/\s+/g, ' ')
-    .trim();
-  if (outer && outer !== trimmed) {
-    variants.add(outer);
-  }
-
-  for (const match of trimmed.matchAll(/[（(]([^()（）]+)[)）]/g)) {
-    const inner = match[1]?.trim() || '';
-    if (inner) {
-      variants.add(inner);
-    }
-  }
-
-  return [...variants];
-}
-
 function buildNameTerms(character: CharacterRecord): string[] {
   const base = new Set<string>();
-  const rawNames = [character.nativeName, character.fullName, ...character.alternativeNames];
+  const rawNames = [character.nativeName, character.fullName];
   for (const rawName of rawNames) {
-    for (const name of expandRawNameVariants(rawName)) {
-      base.add(name);
+    const name = rawName.trim();
+    if (!name) continue;
+    base.add(name);
 
-      const compact = name.replace(/[\s\u3000]+/g, '');
-      if (compact && compact !== name) {
-        base.add(compact);
-      }
+    const compact = name.replace(/[\s\u3000]+/g, '');
+    if (compact && compact !== name) {
+      base.add(compact);
+    }
 
-      const noMiddleDots = compact.replace(/[・･·•]/g, '');
-      if (noMiddleDots && noMiddleDots !== compact) {
-        base.add(noMiddleDots);
-      }
+    const noMiddleDots = compact.replace(/[・･·•]/g, '');
+    if (noMiddleDots && noMiddleDots !== compact) {
+      base.add(noMiddleDots);
+    }
 
-      const split = name.split(/[\s\u3000]+/).filter((part) => part.trim().length > 0);
-      if (split.length === 2) {
-        base.add(split[0]!);
-        base.add(split[1]!);
-      }
+    const split = name.split(/[\s\u3000]+/).filter((part) => part.trim().length > 0);
+    if (split.length === 2) {
+      base.add(split[0]!);
+      base.add(split[1]!);
+    }
 
-      const splitByMiddleDot = name
-        .split(/[・･·•]/)
-        .map((part) => part.trim())
-        .filter((part) => part.length > 0);
-      if (splitByMiddleDot.length >= 2) {
-        for (const part of splitByMiddleDot) {
-          base.add(part);
-        }
+    const splitByMiddleDot = name
+      .split(/[・･·•]/)
+      .map((part) => part.trim())
+      .filter((part) => part.length > 0);
+    if (splitByMiddleDot.length >= 2) {
+      for (const part of splitByMiddleDot) {
+        base.add(part);
       }
     }
   }
@@ -788,12 +758,11 @@ function roleBadgeStyle(role: CharacterDictionaryRole): Record<string, string> {
 
 function buildCollapsibleSection(
   title: string,
-  open: boolean,
   body: Array<string | Record<string, unknown>> | string | Record<string, unknown>,
 ): Record<string, unknown> {
   return {
     tag: 'details',
-    open,
+    open: true,
     style: { marginTop: '0.4em' },
     content: [
       {
@@ -880,9 +849,6 @@ function createDefinitionGlossary(
   mediaTitle: string,
   imagePath: string | null,
   vaImagePaths: Map<number, string>,
-  getCollapsibleSectionOpenState: (
-    section: AnilistCharacterDictionaryCollapsibleSectionKey,
-  ) => boolean,
 ): CharacterDictionaryGlossaryEntry[] {
   const displayName = character.nativeName || character.fullName || `Character ${character.id}`;
   const secondaryName =
@@ -944,13 +910,7 @@ function createDefinitionGlossary(
   });
 
   if (descriptionText) {
-    content.push(
-      buildCollapsibleSection(
-        'Description',
-        getCollapsibleSectionOpenState('description'),
-        descriptionText,
-      ),
-    );
+    content.push(buildCollapsibleSection('Description', descriptionText));
   }
 
   if (fields.length > 0) {
@@ -959,15 +919,11 @@ function createDefinitionGlossary(
       content: `${f.key}: ${f.value}`,
     }));
     content.push(
-      buildCollapsibleSection(
-        'Character Information',
-        getCollapsibleSectionOpenState('characterInformation'),
-        {
-          tag: 'ul',
-          style: { marginTop: '0.15em' },
-          content: fieldItems,
-        },
-      ),
+      buildCollapsibleSection('Character Information', {
+        tag: 'ul',
+        style: { marginTop: '0.15em' },
+        content: fieldItems,
+      }),
     );
   }
 
@@ -975,7 +931,6 @@ function createDefinitionGlossary(
     content.push(
       buildCollapsibleSection(
         'Voiced by',
-        getCollapsibleSectionOpenState('voicedBy'),
         buildVoicedByContent(character.voiceActors, vaImagePaths),
       ),
     );
@@ -1255,7 +1210,6 @@ async function fetchCharactersForMedia(
                   name {
                     full
                     native
-                    alternative
                   }
                 }
               }
@@ -1289,15 +1243,7 @@ async function fetchCharactersForMedia(
       if (!node || typeof node.id !== 'number') continue;
       const fullName = node.name?.full?.trim() || '';
       const nativeName = node.name?.native?.trim() || '';
-      const alternativeNames = [
-        ...new Set(
-          (node.name?.alternative ?? [])
-            .filter((value): value is string => typeof value === 'string')
-            .map((value) => value.trim())
-            .filter((value) => value.length > 0),
-        ),
-      ];
-      if (!fullName && !nativeName && alternativeNames.length === 0) continue;
+      if (!fullName && !nativeName) continue;
       const voiceActors: VoiceActorRecord[] = [];
       for (const va of edge?.voiceActors ?? []) {
         if (!va || typeof va.id !== 'number') continue;
@@ -1316,7 +1262,6 @@ async function fetchCharactersForMedia(
         role: mapRole(edge?.role),
         fullName,
         nativeName,
-        alternativeNames,
         description: node.description || '',
         imageUrl: node.image?.large || node.image?.medium || null,
         voiceActors,
@@ -1395,9 +1340,6 @@ function buildSnapshotFromCharacters(
   imagesByCharacterId: Map<number, CharacterDictionarySnapshotImage>,
   imagesByVaId: Map<number, CharacterDictionarySnapshotImage>,
   updatedAt: number,
-  getCollapsibleSectionOpenState: (
-    section: AnilistCharacterDictionaryCollapsibleSectionKey,
-  ) => boolean,
 ): CharacterDictionarySnapshot {
   const termEntries: CharacterDictionaryTermEntry[] = [];
   const seen = new Set<string>();
@@ -1409,13 +1351,7 @@ function buildSnapshotFromCharacters(
       const vaImg = imagesByVaId.get(va.id);
       if (vaImg) vaImagePaths.set(va.id, vaImg.path);
     }
-    const glossary = createDefinitionGlossary(
-      character,
-      mediaTitle,
-      imagePath,
-      vaImagePaths,
-      getCollapsibleSectionOpenState,
-    );
+    const glossary = createDefinitionGlossary(character, mediaTitle, imagePath, vaImagePaths);
     const candidateTerms = buildNameTerms(character);
     for (const term of candidateTerms) {
       const reading = buildReading(term);
@@ -1441,67 +1377,6 @@ function buildSnapshotFromCharacters(
   };
 }
 
-function getCollapsibleSectionKeyFromTitle(
-  title: string,
-): AnilistCharacterDictionaryCollapsibleSectionKey | null {
-  if (title === 'Description') return 'description';
-  if (title === 'Character Information') return 'characterInformation';
-  if (title === 'Voiced by') return 'voicedBy';
-  return null;
-}
-
-function applyCollapsibleOpenStatesToStructuredValue(
-  value: unknown,
-  getCollapsibleSectionOpenState: (
-    section: AnilistCharacterDictionaryCollapsibleSectionKey,
-  ) => boolean,
-): unknown {
-  if (Array.isArray(value)) {
-    return value.map((item) =>
-      applyCollapsibleOpenStatesToStructuredValue(item, getCollapsibleSectionOpenState),
-    );
-  }
-  if (!value || typeof value !== 'object') {
-    return value;
-  }
-
-  const record = value as Record<string, unknown>;
-  const next: Record<string, unknown> = {};
-  for (const [key, child] of Object.entries(record)) {
-    next[key] = applyCollapsibleOpenStatesToStructuredValue(child, getCollapsibleSectionOpenState);
-  }
-
-  if (record.tag === 'details') {
-    const content = Array.isArray(record.content) ? record.content : [];
-    const summary = content[0];
-    if (summary && typeof summary === 'object' && !Array.isArray(summary)) {
-      const summaryContent = (summary as Record<string, unknown>).content;
-      if (typeof summaryContent === 'string') {
-        const section = getCollapsibleSectionKeyFromTitle(summaryContent);
-        if (section) {
-          next.open = getCollapsibleSectionOpenState(section);
-        }
-      }
-    }
-  }
-
-  return next;
-}
-
-function applyCollapsibleOpenStatesToTermEntries(
-  termEntries: CharacterDictionaryTermEntry[],
-  getCollapsibleSectionOpenState: (
-    section: AnilistCharacterDictionaryCollapsibleSectionKey,
-  ) => boolean,
-): CharacterDictionaryTermEntry[] {
-  return termEntries.map((entry) => {
-    const glossary = entry[5].map((item) =>
-      applyCollapsibleOpenStatesToStructuredValue(item, getCollapsibleSectionOpenState),
-    ) as CharacterDictionaryGlossaryEntry[];
-    return [...entry.slice(0, 5), glossary, ...entry.slice(6)] as CharacterDictionaryTermEntry;
-  });
-}
-
 function buildDictionaryZip(
   outputPath: string,
   dictionaryTitle: string,
@@ -1569,7 +1444,6 @@ export function createCharacterDictionaryRuntimeService(deps: CharacterDictionar
 } {
   const outputDir = path.join(deps.userDataPath, 'character-dictionaries');
   const sleepMs = deps.sleep ?? sleep;
-  const getCollapsibleSectionOpenState = deps.getCollapsibleSectionOpenState ?? (() => false);
 
   const resolveCurrentMedia = async (
     targetPath?: string,
@@ -1683,7 +1557,6 @@ export function createCharacterDictionaryRuntimeService(deps: CharacterDictionar
       imagesByCharacterId,
       imagesByVaId,
       deps.now(),
-      getCollapsibleSectionOpenState,
     );
     writeSnapshot(snapshotPath, snapshot);
     deps.logInfo?.(
@@ -1716,10 +1589,7 @@ export function createCharacterDictionaryRuntimeService(deps: CharacterDictionar
       const normalizedMediaIds = mediaIds
         .filter((mediaId) => Number.isFinite(mediaId) && mediaId > 0)
         .map((mediaId) => Math.floor(mediaId));
-      const snapshotResults = await Promise.all(
-        normalizedMediaIds.map((mediaId) => getOrCreateSnapshot(mediaId)),
-      );
-      const snapshots = snapshotResults.map(({ mediaId }) => {
+      const snapshots = normalizedMediaIds.map((mediaId) => {
         const snapshot = readSnapshot(getSnapshotPath(outputDir, mediaId));
         if (!snapshot) {
           throw new Error(`Missing character dictionary snapshot for AniList ${mediaId}.`);
@@ -1736,10 +1606,7 @@ export function createCharacterDictionaryRuntimeService(deps: CharacterDictionar
         CHARACTER_DICTIONARY_MERGED_TITLE,
         description,
         revision,
-        applyCollapsibleOpenStatesToTermEntries(
-          snapshots.flatMap((snapshot) => snapshot.termEntries),
-          getCollapsibleSectionOpenState,
-        ),
+        snapshots.flatMap((snapshot) => snapshot.termEntries),
         snapshots.flatMap((snapshot) => snapshot.images),
       );
       deps.logInfo?.(
@@ -1784,10 +1651,7 @@ export function createCharacterDictionaryRuntimeService(deps: CharacterDictionar
         dictionaryTitle,
         description,
         revision,
-        applyCollapsibleOpenStatesToTermEntries(
-          storedSnapshot.termEntries,
-          getCollapsibleSectionOpenState,
-        ),
+        storedSnapshot.termEntries,
         storedSnapshot.images,
       );
       deps.logInfo?.(

src/main/cli-runtime.ts

@@ -18,7 +18,6 @@ export interface CliCommandRuntimeServiceContext {
   isOverlayInitialized: () => boolean;
   initializeOverlay: () => void;
   toggleVisibleOverlay: () => void;
-  openFirstRunSetup: () => void;
   setVisibleOverlay: (visible: boolean) => void;
   copyCurrentSubtitle: () => void;
   startPendingMultiCopy: (timeoutMs: number) => void;
@@ -104,7 +103,6 @@ function createCliCommandDepsFromContext(
       runCommand: context.runJellyfinCommand,
     },
     ui: {
-      openFirstRunSetup: context.openFirstRunSetup,
       openYomitanSettings: context.openYomitanSettings,
       cycleSecondarySubMode: context.cycleSecondarySubMode,
       openRuntimeOptionsPalette: context.openRuntimeOptionsPalette,

src/main/dependencies.ts

@@ -159,7 +159,6 @@ export interface CliCommandRuntimeServiceDepsParams {
     runCommand: CliCommandDepsRuntimeOptions['jellyfin']['runCommand'];
   };
   ui: {
-    openFirstRunSetup: CliCommandDepsRuntimeOptions['ui']['openFirstRunSetup'];
     openYomitanSettings: CliCommandDepsRuntimeOptions['ui']['openYomitanSettings'];
     cycleSecondarySubMode: CliCommandDepsRuntimeOptions['ui']['cycleSecondarySubMode'];
     openRuntimeOptionsPalette: CliCommandDepsRuntimeOptions['ui']['openRuntimeOptionsPalette'];
@@ -186,7 +185,6 @@ export interface MpvCommandRuntimeServiceDepsParams {
   mpvPlayNextSubtitle: HandleMpvCommandFromIpcOptions['mpvPlayNextSubtitle'];
   shiftSubDelayToAdjacentSubtitle: HandleMpvCommandFromIpcOptions['shiftSubDelayToAdjacentSubtitle'];
   mpvSendCommand: HandleMpvCommandFromIpcOptions['mpvSendCommand'];
-  resolveProxyCommandOsd?: HandleMpvCommandFromIpcOptions['resolveProxyCommandOsd'];
   isMpvConnected: HandleMpvCommandFromIpcOptions['isMpvConnected'];
   hasRuntimeOptionsManager: HandleMpvCommandFromIpcOptions['hasRuntimeOptionsManager'];
 }
@@ -309,7 +307,6 @@ export function createCliCommandRuntimeServiceDeps(
       runCommand: params.jellyfin.runCommand,
     },
     ui: {
-      openFirstRunSetup: params.ui.openFirstRunSetup,
       openYomitanSettings: params.ui.openYomitanSettings,
       cycleSecondarySubMode: params.ui.cycleSecondarySubMode,
       openRuntimeOptionsPalette: params.ui.openRuntimeOptionsPalette,
@@ -340,7 +337,6 @@ export function createMpvCommandRuntimeServiceDeps(
     mpvPlayNextSubtitle: params.mpvPlayNextSubtitle,
     shiftSubDelayToAdjacentSubtitle: params.shiftSubDelayToAdjacentSubtitle,
     mpvSendCommand: params.mpvSendCommand,
-    resolveProxyCommandOsd: params.resolveProxyCommandOsd,
     isMpvConnected: params.isMpvConnected,
     hasRuntimeOptionsManager: params.hasRuntimeOptionsManager,
   };

src/main/ipc-mpv-command.ts

@@ -2,12 +2,6 @@ import type { RuntimeOptionApplyResult, RuntimeOptionId } from '../types';
 import { handleMpvCommandFromIpc } from '../core/services';
 import { createMpvCommandRuntimeServiceDeps } from './dependencies';
 import { SPECIAL_COMMANDS } from '../config';
-import { resolveProxyCommandOsdRuntime } from './runtime/mpv-proxy-osd';
-
-type MpvPropertyClientLike = {
-  connected: boolean;
-  requestProperty: (name: string) => Promise<unknown>;
-};
 
 export interface MpvCommandFromIpcRuntimeDeps {
   triggerSubsyncFromConfig: () => void;
@@ -18,7 +12,6 @@ export interface MpvCommandFromIpcRuntimeDeps {
   playNextSubtitle: () => void;
   shiftSubDelayToAdjacentSubtitle: (direction: 'next' | 'previous') => Promise<void>;
   sendMpvCommand: (command: (string | number)[]) => void;
-  getMpvClient: () => MpvPropertyClientLike | null;
   isMpvConnected: () => boolean;
   hasRuntimeOptionsManager: () => boolean;
 }
@@ -40,8 +33,6 @@ export function handleMpvCommandFromIpcRuntime(
       shiftSubDelayToAdjacentSubtitle: (direction) =>
         deps.shiftSubDelayToAdjacentSubtitle(direction),
       mpvSendCommand: deps.sendMpvCommand,
-      resolveProxyCommandOsd: (nextCommand) =>
-        resolveProxyCommandOsdRuntime(nextCommand, deps.getMpvClient),
       isMpvConnected: deps.isMpvConnected,
       hasRuntimeOptionsManager: deps.hasRuntimeOptionsManager,
     }),

src/main/runtime/anilist-setup-protocol-main-deps.test.ts

@@ -76,7 +76,7 @@ test('register subminer protocol client main deps builder maps callbacks', () =>
     execPath: '/tmp/electron',
     resolvePath: (value) => `/abs/${value}`,
     setAsDefaultProtocolClient: () => true,
-    logDebug: (message) => calls.push(`debug:${message}`),
+    logWarn: (message) => calls.push(`warn:${message}`),
   })();
 
   assert.equal(deps.isDefaultApp(), true);

src/main/runtime/anilist-setup-protocol-main-deps.ts

@@ -60,6 +60,6 @@ export function createBuildRegisterSubminerProtocolClientMainDepsHandler(
     resolvePath: (value: string) => deps.resolvePath(value),
     setAsDefaultProtocolClient: (scheme: string, path?: string, args?: string[]) =>
       deps.setAsDefaultProtocolClient(scheme, path, args),
-    logDebug: (message: string, details?: unknown) => deps.logDebug(message, details),
+    logWarn: (message: string, details?: unknown) => deps.logWarn(message, details),
   });
 }

src/main/runtime/anilist-setup-protocol.test.ts

@@ -56,26 +56,9 @@ test('createRegisterSubminerProtocolClientHandler registers default app entry',
       calls.push(`register:${String(args?.[0])}`);
       return true;
     },
-    logDebug: (message) => calls.push(`debug:${message}`),
+    logWarn: (message) => calls.push(`warn:${message}`),
   });
 
   register();
   assert.deepEqual(calls, ['register:/resolved/./entry.js']);
 });
-
-test('createRegisterSubminerProtocolClientHandler keeps unsupported registration at debug level', () => {
-  const calls: string[] = [];
-  const register = createRegisterSubminerProtocolClientHandler({
-    isDefaultApp: () => false,
-    getArgv: () => ['SubMiner.AppImage'],
-    execPath: '/tmp/SubMiner.AppImage',
-    resolvePath: (value) => value,
-    setAsDefaultProtocolClient: () => false,
-    logDebug: (message) => calls.push(`debug:${message}`),
-  });
-
-  register();
-  assert.deepEqual(calls, [
-    'debug:Failed to register default protocol handler for subminer:// URLs',
-  ]);
-});

src/main/runtime/anilist-setup-protocol.ts

@@ -67,7 +67,7 @@ export function createRegisterSubminerProtocolClientHandler(deps: {
   execPath: string;
   resolvePath: (value: string) => string;
   setAsDefaultProtocolClient: (scheme: string, path?: string, args?: string[]) => boolean;
-  logDebug: (message: string, details?: unknown) => void;
+  logWarn: (message: string, details?: unknown) => void;
 }) {
   return (): void => {
     try {
@@ -78,10 +78,10 @@ export function createRegisterSubminerProtocolClientHandler(deps: {
           ])
         : deps.setAsDefaultProtocolClient('subminer');
       if (!success) {
-        deps.logDebug('Failed to register default protocol handler for subminer:// URLs');
+        deps.logWarn('Failed to register default protocol handler for subminer:// URLs');
       }
     } catch (error) {
-      deps.logDebug('Failed to register subminer:// protocol handler', error);
+      deps.logWarn('Failed to register subminer:// protocol handler', error);
     }
   };
 }

src/main/runtime/app-ready-main-deps.test.ts

@@ -5,7 +5,6 @@ import { createBuildAppReadyRuntimeMainDepsHandler } from './app-ready-main-deps
 test('app-ready main deps builder returns mapped app-ready runtime deps', async () => {
   const calls: string[] = [];
   const onReady = createBuildAppReadyRuntimeMainDepsHandler({
-    ensureDefaultConfigBootstrap: () => calls.push('bootstrap-config'),
     loadSubtitlePosition: () => calls.push('load-subtitle-position'),
     resolveKeybindings: () => calls.push('resolve-keybindings'),
     createMpvClient: () => calls.push('create-mpv-client'),
@@ -17,12 +16,8 @@ test('app-ready main deps builder returns mapped app-ready runtime deps', async
     setSecondarySubMode: () => calls.push('set-secondary-sub-mode'),
     defaultSecondarySubMode: 'hover',
     defaultWebsocketPort: 5174,
-    defaultAnnotationWebsocketPort: 6678,
-    defaultTexthookerPort: 5174,
     hasMpvWebsocketPlugin: () => false,
     startSubtitleWebsocket: () => calls.push('start-ws'),
-    startAnnotationWebsocket: () => calls.push('start-annotation-ws'),
-    startTexthooker: () => calls.push('start-texthooker'),
     log: () => calls.push('log'),
     setLogLevel: () => calls.push('set-log-level'),
     createMecabTokenizerAndCheck: async () => {
@@ -36,9 +31,6 @@ test('app-ready main deps builder returns mapped app-ready runtime deps', async
     loadYomitanExtension: async () => {
       calls.push('load-yomitan');
     },
-    handleFirstRunSetup: async () => {
-      calls.push('handle-first-run-setup');
-    },
     prewarmSubtitleDictionaries: async () => {
       calls.push('prewarm-dicts');
     },
@@ -57,8 +49,6 @@ test('app-ready main deps builder returns mapped app-ready runtime deps', async
 
   assert.equal(onReady.defaultSecondarySubMode, 'hover');
   assert.equal(onReady.defaultWebsocketPort, 5174);
-  assert.equal(onReady.defaultAnnotationWebsocketPort, 6678);
-  assert.equal(onReady.defaultTexthookerPort, 5174);
   assert.equal(onReady.texthookerOnlyMode, false);
   assert.equal(onReady.shouldAutoInitializeOverlayRuntimeFromConfig(), true);
   assert.equal(onReady.now?.(), 123);
@@ -67,10 +57,8 @@ test('app-ready main deps builder returns mapped app-ready runtime deps', async
   onReady.createMpvClient();
   await onReady.createMecabTokenizerAndCheck();
   await onReady.loadYomitanExtension();
-  await onReady.handleFirstRunSetup();
   await onReady.prewarmSubtitleDictionaries?.();
   onReady.startBackgroundWarmups();
-  onReady.startTexthooker(5174);
   onReady.setVisibleOverlayVisible(true);
 
   assert.deepEqual(calls, [
@@ -79,10 +67,8 @@ test('app-ready main deps builder returns mapped app-ready runtime deps', async
     'create-mpv-client',
     'create-mecab',
     'load-yomitan',
-    'handle-first-run-setup',
     'prewarm-dicts',
     'start-warmups',
-    'start-texthooker',
     'set-visible-overlay',
   ]);
 });