SubMiner/backlog/tasks/task-71 - Anki-integration-add-local-AnkiConnect-proxy-transport-for-push-based-auto-enrichment.md

id, title, status, assignee, created_date, updated_date, labels, dependencies, references, priority, ordinal

id	title	status	assignee	created_date	updated_date	labels	dependencies	references	priority	ordinal
TASK-71	Anki integration: add local AnkiConnect proxy transport for push-based auto-enrichment	Done		2026-02-28 02:38	2026-03-04 13:55			src/anki-integration/anki-connect-proxy.ts src/anki-integration/anki-connect-proxy.test.ts src/anki-integration.ts src/config/resolve/anki-connect.ts src/core/services/tokenizer/yomitan-parser-runtime.ts src/core/services/tokenizer/yomitan-parser-runtime.test.ts docs/anki-integration.md config.example.jsonc	medium	2000

Description

Scope: Current unmerged working-tree changes implement an optional local AnkiConnect-compatible proxy and transport switching for card enrichment.

Delivered behavior:

• Added proxy server that forwards AnkiConnect requests and enqueues addNote/addNotes note IDs for post-create enrichment, with de-duplication and loop-configuration protection.
• Added follow-up response-shape compatibility handling so proxy enqueue works for both envelope ({result,error}) and bare JSON payloads, including multi variants.
• Added config schema/defaults/resolution for ankiConnect.proxy (enabled, host, port, upstreamUrl) with validation warnings and fallback behavior.
• Runtime now supports transport switching (polling vs proxy) and restarts transport when runtime config patches change transport keys.
• Added Yomitan default-profile server sync helper to keep bundled parser profile aligned with configured Anki endpoint.
• Updated user docs/config examples for proxy mode setup, troubleshooting, and mining workflow behavior.

Risk/impact context:

• New network surface on local host/port; correctness depends on safe proxy upstream configuration and robust response handling.
• Tests added for proxy queue behavior, config resolution, and parser sync routines.

Final Summary

Completed implementation in branch working tree; ready to merge once local changes are committed and test gate passes.

Follow-up fix (2026-03-04):

• Updated bundled Yomitan server-sync behavior to target profileCurrent instead of hardcoded profiles[0].
• Added proxy-mode force override so bundled Yomitan always points at SubMiner proxy URL when ankiConnect.proxy.enabled=true; this ensures mined cards pass through proxy and trigger auto-enrichment.
• Added regression tests for blocked existing-server case and force-override injection path.