Plan and implement guide-faithful parity improvements for the AniList character dictionary flow inside SubMiner's current single-media generation path. Scope includes AniList first/last name hints, hint-aware reading generation for kanji/native names, expanded honorific coverage, 160x200 JPEG thumbnail handling, and AniList 429 retry/backoff behavior.
Acceptance Criteria
#1 AniList character queries include first/last name fields and preserve them through runtime data models.
#2 Dictionary generation uses hint-aware name splitting and reading generation for kanji and mixed native names, not only kana-only readings.
#3 Honorific generation is expanded substantially toward upstream coverage and is covered by regression tests.
#4 Character and voice-actor images are resized or re-encoded to bounded JPEG thumbnails with fallback behavior.
#5 AniList requests handle 429 responses with bounded exponential backoff and tests cover retry behavior.
Implementation Plan
Add targeted regression tests in src/main/character-dictionary-runtime.test.ts for AniList 429 retry behavior and thumbnail conversion/fallback image paths before changing runtime code.
Update fetchAniList in src/main/character-dictionary-runtime.ts to retry 429 responses with bounded exponential backoff or Retry-After delays, while preserving existing request pacing hook behavior.
Update downloadCharacterImage to run downloaded bytes through convertImageToThumbnail, returning .jpg paths when conversion succeeds and preserving original bytes/extensions on fallback.
Run focused character-dictionary tests first, then broader required verification commands if the focused lane passes.
Record progress against acceptance criteria #4 and #5 in TASK-133 notes/final checklist once verified.
Implementation Notes
Approved design and implementation plan captured on 2026-03-08. Scope stays within current single-media AniList dictionary flow; excludes username-driven CURRENT-list fetching and Yomitan auto-update schema work.
Resumed TASK-133 to finish remaining AC #4 image thumbnail wiring and AC #5 AniList 429 retry handling. Existing code already contains helper constants/functions; next work is wiring plus regression coverage.
