feat(plugin): add AniSkip intro skip flow with launcher metadata hints

backlog/tasks/task-108 - Add-AniSkip-intro-skip-OSD-button.md

@@ -0,0 +1,68 @@
+---
+id: TASK-108
+title: Add AniSkip intro skip markers and OSD skip button in mpv plugin
+status: In Progress
+assignee:
+  - codex
+created_date: '2026-02-22 08:05'
+updated_date: '2026-02-22 09:26'
+labels:
+  - feature
+  - mpv
+  - intro-skip
+dependencies: []
+priority: high
+ordinal: 98100
+---
+
+## Description
+
+<!-- SECTION:DESCRIPTION:BEGIN -->
+Wire `plugin/subminer.lua` to call AniSkip API, parse intro skip window, add skip markers/chapters to mpv, and show an OSD skip button while playback is inside the intro range.
+<!-- SECTION:DESCRIPTION:END -->
+
+## Action Steps
+
+<!-- SECTION:PLAN:BEGIN -->
+1. Add configurable AniSkip options + state in plugin.
+2. Resolve anime id + episode from mpv metadata/filename.
+3. Fetch AniSkip skip-times API and parse OP interval.
+4. Create/update chapters for OP marker.
+5. Render clickable OSD skip button while inside OP range.
+6. Add manual script message to retry fetch.
+7. Update plugin docs/config comments.
+<!-- SECTION:PLAN:END -->
+
+## Acceptance Criteria
+<!-- AC:BEGIN -->
+- [ ] #1 Plugin calls AniSkip API and handles missing data gracefully.
+- [ ] #2 Intro marker/chapter is visible in mpv when OP range exists.
+- [ ] #3 OSD skip button appears only while inside OP range.
+- [ ] #4 Clicking/activating button seeks to OP end.
+- [ ] #5 Docs/config include new options + script message.
+<!-- AC:END -->
+
+## Implementation Notes
+
+<!-- SECTION:NOTES:BEGIN -->
+Linked to user request on 2026-02-22 for porting intro skip via AniSkip.
+- Follow-up implemented per user request:
+  - launcher now runs `guessit` for file targets and passes `subminer-aniskip_title`, `subminer-aniskip_season`, `subminer-aniskip_episode` via mpv `--script-opts`
+  - fallback metadata path passes filename-derived title when `guessit` is unavailable/empty
+  - intro hint now displays for first 3 seconds from intro start (`You can skip by pressing y-k`)
+- Runtime bugfix follow-up:
+  - always binds `y-k` fallback key for intro skip, even when custom `aniskip_button_key` configured
+  - intro skip handler now shows explicit OSD reason if skip is unavailable or outside intro window
+- Validation:
+  - `bun test launcher/aniskip-metadata.test.ts`
+  - `bun test launcher/mpv.test.ts`
+  - `luac -p plugin/subminer.lua`
+  - `bun run tsc --noEmit`
+<!-- SECTION:NOTES:END -->
+
+## Definition of Done
+<!-- DOD:BEGIN -->
+- [ ] #1 Focused plugin smoke validation in mpv.
+- [ ] #2 Lua parse/load check passes in local environment.
+- [ ] #3 Task notes capture fallback behavior.
+<!-- DOD:END -->