fix(subtitle): restore known and JLPT token annotations

backlog/tasks/task-202 - Use-ended-session-media-position-for-anime-episode-progress.md

@@ -0,0 +1,70 @@
+---
+id: TASK-202
+title: Use ended session media position for anime episode progress
+status: Done
+assignee:
+  - Codex
+created_date: '2026-03-19 14:55'
+updated_date: '2026-03-19 17:36'
+labels:
+  - stats
+  - ui
+  - bug
+milestone: m-1
+dependencies: []
+references:
+  - stats/src/components/anime/EpisodeList.tsx
+  - stats/src/types/stats.ts
+  - src/core/services/immersion-tracker/session.ts
+  - src/core/services/immersion-tracker/query.ts
+  - src/core/services/immersion-tracker/storage.ts
+priority: medium
+ordinal: 105720
+---
+
+## Description
+
+<!-- SECTION:DESCRIPTION:BEGIN -->
+
+The anime episode list currently computes the `Progress` column from cumulative `totalActiveMs / durationMs`, which can exceed the intended watch-position meaning after rewatches or repeated sessions. Persist the playback position at the time a session ends and drive episode progress from that stored stop position instead.
+
+<!-- SECTION:DESCRIPTION:END -->
+
+## Acceptance Criteria
+
+<!-- AC:BEGIN -->
+
+- [x] #1 Session finalization persists the playback position reached when the session ended.
+- [x] #2 Anime episode queries expose the most recent ended-session media position for each episode.
+- [x] #3 Episode-list progress renders from ended media position instead of cumulative active watch time.
+- [x] #4 Regression coverage locks storage/query/UI behavior for the new progress source.
+<!-- AC:END -->
+
+## Implementation Plan
+
+<!-- SECTION:PLAN:BEGIN -->
+
+1. Add failing regression coverage for persisted ended media position and episode progress rendering.
+2. Add `ended_media_ms` to the immersion-session schema and persist `lastMediaMs` when ending a session.
+3. Thread the new field through episode queries/types and render episode progress from `endedMediaMs / durationMs`.
+4. Run targeted verification plus typecheck, then record the outcome.
+<!-- SECTION:PLAN:END -->
+
+## Outcome
+
+<!-- SECTION:OUTCOME:BEGIN -->
+
+Added nullable `ended_media_ms` storage to immersion sessions, persisted `lastMediaMs` when sessions finalize, and exposed the most recent ended-session media position through anime episode queries/types. The anime episode list now renders `Progress` from `endedMediaMs / durationMs` instead of cumulative active watch time, so rewatches no longer inflate the displayed percentage.
+
+Verification:
+
+- `bun test src/core/services/immersion-tracker/storage-session.test.ts`
+- `bun test src/core/services/immersion-tracker/__tests__/query.test.ts`
+- `bun test stats/src/lib/yomitan-lookup.test.tsx stats/src/lib/stats-ui-navigation.test.tsx`
+- `bun run typecheck`
+- `bun run changelog:lint`
+- `bun x prettier --check 'src/core/services/immersion-tracker/types.ts' 'src/core/services/immersion-tracker/storage.ts' 'src/core/services/immersion-tracker/session.ts' 'src/core/services/immersion-tracker/query.ts' 'src/core/services/immersion-tracker/storage-session.test.ts' 'src/core/services/immersion-tracker/__tests__/query.test.ts' 'stats/src/types/stats.ts' 'stats/src/components/anime/EpisodeList.tsx' 'stats/src/lib/yomitan-lookup.test.tsx' 'stats/src/lib/stats-ui-navigation.test.tsx' 'backlog/tasks/task-202 - Use-ended-session-media-position-for-anime-episode-progress.md' 'changes/2026-03-19-stats-ended-media-progress.md'`
+- `bash .agents/skills/subminer-change-verification/scripts/verify_subminer_change.sh --lane core 'src/core/services/immersion-tracker/types.ts' 'src/core/services/immersion-tracker/storage.ts' 'src/core/services/immersion-tracker/session.ts' 'src/core/services/immersion-tracker/query.ts' 'src/core/services/immersion-tracker/storage-session.test.ts' 'src/core/services/immersion-tracker/__tests__/query.test.ts' 'stats/src/types/stats.ts' 'stats/src/components/anime/EpisodeList.tsx' 'stats/src/lib/yomitan-lookup.test.tsx' 'stats/src/lib/stats-ui-navigation.test.tsx' 'backlog/tasks/task-202 - Use-ended-session-media-position-for-anime-episode-progress.md' 'changes/2026-03-19-stats-ended-media-progress.md'`
+- Verifier artifacts: `.tmp/skill-verification/subminer-verify-20260319-173511-AV7kUg/`
+
+<!-- SECTION:OUTCOME:END -->

backlog/tasks/task-203 - Restore-known-and-JLPT-annotation-for-reading-mismatch-tokens.md

@@ -0,0 +1,47 @@
+---
+id: TASK-203
+title: Restore known and JLPT annotation for reading-mismatch subtitle tokens
+status: Done
+assignee:
+  - Codex
+created_date: '2026-03-19 18:25'
+updated_date: '2026-03-19 18:25'
+labels:
+  - subtitle
+  - bug
+dependencies: []
+references:
+  - src/core/services/tokenizer/annotation-stage.ts
+  - src/core/services/tokenizer/annotation-stage.test.ts
+priority: medium
+ordinal: 105721
+---
+
+## Description
+
+<!-- SECTION:DESCRIPTION:BEGIN -->
+
+Some subtitle tokens lose both known-word coloring and JLPT underline even though the popup resolves a valid dictionary term. Repro example: `大体` in `大体 僕だって困ってたんですよ！` can be known via kana-only Anki data (`だいたい`) while JLPT lookup should still resolve from the kanji surface/headword.
+
+<!-- SECTION:DESCRIPTION:END -->
+
+## Acceptance Criteria
+
+<!-- AC:BEGIN -->
+
+- [x] #1 Subtitle annotation can mark a token known via its reading when the configured headword/surface lookup misses.
+- [x] #2 JLPT eligibility no longer drops valid kanji terms just because their reading contains repeated kana patterns.
+- [x] #3 Regression coverage locks the combined known + JLPT case for `大体`.
+<!-- AC:END -->
+
+## Outcome
+
+<!-- SECTION:OUTCOME:BEGIN -->
+
+Known-word annotation now falls back to the token reading after the configured headword/surface lookup misses, so kana-only known-card entries still light up matching subtitle tokens. JLPT eligibility now ignores repeated-kana noise checks on the reading when a real surface/headword is present, which preserves JLPT tagging for words like `大体`.
+
+Verification:
+
+- `bun test src/core/services/tokenizer/annotation-stage.test.ts`
+
+<!-- SECTION:OUTCOME:END -->