sudacode/SubMiner
1
0
Fork 0
mirror of https://github.com/ksyasuda/SubMiner.git synced 2026-02-27 18:22:41 -08:00
Code Issues Packages Projects Releases Wiki Activity

refactor(anki): extract workflow services from integration facade

Browse Source 
Split note-update and field-grouping orchestration out of AnkiIntegration so the facade remains focused on composition and shared policy wiring. This keeps mining behavior stable while creating focused workflow seams with dedicated regression coverage and clearer ownership docs.
This commit is contained in:
Kyle Yasuda
2026-02-21 13:23:53 -08:00
parent 54109deb94
commit 5cb0ee1591
7 changed files with 822 additions and 276 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/anki-integration.md
View File

@@ -22,6 +22,28 @@ SubMiner polls AnkiConnect at a regular interval (default: 3 seconds, configurab
Polling uses the query `"deck:<your-deck>" added:1` to find recently added cards. If no deck is configured, it searches all decks.
## Ownership Boundaries (TASK-76)
After workflow-service decomposition, ownership is split as follows:
1. **`src/anki-integration.ts` (facade/orchestrator)**
- Owns dependency wiring, config normalization, shared helpers, and runtime lifecycle (`start`, `stop`, runtime patching).
- Routes public entry points to collaborators/workflows and keeps cross-cutting state (polling/update flags, notifications, callbacks, known-word cache).
2. **`src/anki-integration/note-update-workflow.ts`**
- Owns the "new card was detected" update path.
- Loads note data, applies sentence/audio/image/misc updates, and triggers duplicate handling via auto/manual field-grouping handlers when enabled.
3. **`src/anki-integration/field-grouping-workflow.ts`**
- Owns duplicate merge execution for auto and manual grouping.
- Resolves manual choice callback, computes merged field payloads, updates kept note, optionally deletes duplicate note, and emits grouping notifications.
4. **Existing collaborators**
- `card-creation`: manual clipboard-driven updates, sentence-card creation, and card-type/tag update operations.
- `field-grouping` service: user-triggered grouping for the last added card and merge preview assembly.
- `known-word-cache`: known-word lifecycle/refresh/persistence used by N+1 highlighting.
- `polling`: periodic AnkiConnect polling, new-note detection, tracked-note state, and connection backoff.
## Field Mapping
SubMiner maps its data to your Anki note fields. Configure these under `ankiConnect.fields`: