sudacode
f2b3af17d7
Update configuration, immersion tracking, and mining workflow docs. Add backlog tasks for upcoming work items and change notes for recent features and fixes.
3.3 KiB
id, title, status, assignee, created_date, updated_date, labels, dependencies, references, priority
| id | title | status | assignee | created_date | updated_date | labels | dependencies | references | priority | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| TASK-185 | Clarify library stats word-count labels | Done |
|
2026-03-17 22:58 | 2026-03-17 23:00 |
|
|
medium |
Description
Fix the library/media detail stats header so occurrence-based subtitle counts are not presented as unique-word vocabulary totals. The UI should clearly distinguish subtitle word occurrences from unique known-word headword coverage to avoid misleading comparisons.
Acceptance Criteria
- #1 Library/media detail view labels subtitle occurrence totals with wording that does not imply unique vocabulary counts
- #2 Known-words summary in the same view explicitly communicates that its denominator is unique words/headwords
- #3 Frontend tests cover the updated copy so the mismatch does not regress
Implementation Plan
- Add a focused stats frontend test for MediaHeader copy that distinguishes occurrence totals from unique known-word coverage.
- Update MediaHeader labels so occurrence-based totals no longer imply unique vocabulary counts.
- Update the known-words label copy to explicitly state it is based on unique words/headwords.
- Run targeted stats tests and record results.
Implementation Notes
Root cause confirmed: library header compares occurrence-based totalWordsSeen against unique-headword known-words summary. Awaiting plan approval before code changes.
Updated library header copy to label totalWordsSeen as word occurrences and known-word coverage as known unique words. Added an optional initialKnownWordsSummary prop to support deterministic server-render tests without changing runtime behavior.
Verification: bun test stats/src/lib/yomitan-lookup.test.tsx passes. bun run typecheck:stats remains blocked by preexisting unrelated errors in stats/src/components/anime/AnilistSelector.tsx, stats/src/lib/reading-utils.ts, stats/src/lib/reading-utils.test.ts, and stats/src/lib/vocabulary-tab.test.ts.
Final Summary
Clarified the library/media header so occurrence-based subtitle counts are no longer presented as if they were unique vocabulary totals. The header now labels totalWordsSeen as word occurrences, and the known-words summary explicitly says known unique words, which matches the backend's DISTINCT headword calculation.
For regression coverage, added a focused MediaHeader render test that exercises the exact mismatch case (30 occurrences vs 34 unique words) and verifies the new copy. Also updated one stale AnimeOverviewStats assertion in the same targeted test file so the focused stats test lane is green.
Tests run:
bun test stats/src/lib/yomitan-lookup.test.tsx✅bun run typecheck:stats⚠️ blocked by preexisting unrelated errors in AnilistSelector and reading-utils/vocabulary-tab stats files.