Files
SubMiner/backlog/tasks/task-57 - Evaluate-anki-integration.ts-for-further-decomposition.md
2026-02-21 23:31:09 -08:00

2.4 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-57 Evaluate anki-integration.ts for further decomposition To Do
2026-02-16 04:47 2026-02-22 07:14
maintainability
anki
/home/sudacode/projects/japanese/SubMiner/src/anki-integration.ts
/home/sudacode/projects/japanese/SubMiner/src/anki-integration/
medium

Description

src/anki-integration.ts remains a major hotspot after refactors and still centralizes too many adapter and helper responsibilities.

Current state:

  • Main file: src/anki-integration.ts (~1120 lines on 2026-02-22)
  • Extracted modules:
    • workflow and service collaborators already exist under src/anki-integration/*
    • main class still owns media generation wrappers, field parsing helpers, config normalization, and notification plumbing

This task decides and documents the next decomposition move, then prepares an implementation-ready extraction plan.

Action Steps

  1. Re-map src/anki-integration.ts by concern: orchestration, media generation wrappers, field parsing helpers, notification/UI feedback, runtime config patching.
  2. Identify cohesive extraction candidates that reduce class surface without adding indirection noise.
  3. Define target module boundaries and public interfaces for each candidate extraction.
  4. Produce a concrete follow-up implementation plan (candidate files, migration order, regression tests).
  5. If no extraction is justified, record explicit rationale and closure criteria.

Acceptance Criteria

  • #1 Current anki-integration responsibilities are documented with concrete line/section mapping.
  • #2 At least one recommended path is chosen: extraction plan or explicit keep-as-is rationale.
  • #3 Decision includes maintainability tradeoffs and expected impact on testability/readability.
  • #4 Follow-up implementation scope (files/tests/sequence) is explicit enough to execute directly.

Definition of Done

  • #1 Decision + plan/rationale is captured in task notes.
  • #2 Any proposed extraction references existing collaborators under src/anki-integration/*.
  • #3 Follow-up implementation task(s) are created if extraction is recommended.