feat: add collect command for markdown-to-Anki import

[sysid]

Summary

This PR implements complete feature parity between ankiview and inka2 for the markdown-to-Anki import workflow. It adds a new collect command that imports markdown flashcards into Anki collections with automatic ID tracking, media handling, and smart caching.

Key Features

Core Functionality

• Markdown Import: Convert markdown files to Anki notes (basic and cloze cards)
• ID Tracking: Automatic injection and detection of ID comments for update detection
• Media Handling: Copy images from markdown to Anki's collection.media directory
• Hash Cache: SHA256-based change detection to skip unchanged files
• Recursive Processing: Scan directory trees for markdown files

Command-Line Flags

• --recursive / -r: Process subdirectories recursively
• --force: Overwrite conflicting media files
• --ignore-errors / -i: Continue processing on errors, report at end
• --full-sync / -f: Bypass hash cache for complete rebuild
• --update-ids / -u: Search Anki for existing notes and recover IDs

Implementation Details

Architecture

• New inka module with hexagonal architecture
• CardCollector use case for orchestrating imports
• Markdown parser supporting basic and cloze card formats
• Media handler for file copying and path resolution
• Hash cache for performance optimization
• File I/O with ID comment preservation

Card Format Support

Basic Cards:

---
Deck: MyDeck
Tags: tag1 tag2

1. Question text?
> Answer text
---

Cloze Cards:

---
Deck: MyDeck

1. Text with {cloze deletion}.
2. Multiple {{c1::deletions}} with {{c2::numbers}}.
---

ID Tracking

After first import, markdown files are updated with ID comments:

<!--ID:1686433857327-->
1. Question text?
> Answer text

This enables:

• Update detection (modify content and re-run to update, not duplicate)
• Content-based ID recovery with --update-ids flag
• Preserving user edits across imports

Performance

• Hash cache tracks file SHA256 hashes in ankiview_hashes.json
• Unchanged files are skipped automatically
• Typical re-import of 100 files: ~0.5s with cache, ~5s without

Testing

Test Coverage

• 133 tests passing (unit + integration)
• End-to-end tests with real Anki collection
• Media file handling tests
• Error handling tests (both fail-fast and continue-on-error modes)
• Hash cache persistence tests
• ID injection and recovery tests

Manual Testing

Tested with:

• Single file imports
• Directory imports (recursive and non-recursive)
• Media file conflicts
• ID recovery scenarios
• Error handling with invalid markdown
• Cache behavior with unchanged/modified files

Documentation

User Documentation (README.md)

• Complete collect command section
• Markdown format specification with examples
• Common workflows and use cases
• Flag reference table
• Troubleshooting guide

Developer Documentation (CLI Help)

• Comprehensive flag descriptions
• Contextual explanations of technical concepts
• Clear guidance on when to use each flag
• Hash cache and ID injection mechanism details

Migration Notes

This implementation achieves feature parity with inka2 (Python) including:

• All major flags and behavior
• Compatible markdown format
• Same ID injection approach
• Similar performance characteristics

Key differences:

• Hash cache location: stored per-collection in ankiview vs. global in inka2
• Better cross-platform collection detection
• More granular error reporting

Breaking Changes

None. This is a new command with no impact on existing view/delete functionality.

Checklist

• All tests passing
• Zero clippy warnings
• Code formatted with rustfmt
• Documentation updated (README.md, CLI help)
• Integration tests added
• Manual testing completed

[Copilot]

Pull Request Overview

This PR implements complete feature parity with inka2 for markdown-to-Anki import, adding a comprehensive collect command that converts markdown flashcards to Anki notes with automatic ID tracking, media handling, and performance optimizations.

Key changes include:

• New collect command with 6 configuration flags for flexible import workflows
• Complete inka module with hexagonal architecture for markdown processing and Anki integration
• Hash-based caching system to skip unchanged files for improved performance

Reviewed Changes

Copilot reviewed 33 out of 46 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
ankiview/src/lib.rs	Adds inka module and implements handle_collect_command function
ankiview/src/cli/args.rs	Defines collect command with comprehensive flag options and help text
ankiview/src/infrastructure/anki.rs	Extends AnkiRepository with note creation, updating, and content search capabilities
ankiview/src/inka/	Complete inka module implementing markdown parsing, cloze conversion, media handling, and file I/O
ankiview/tests/test_collect.rs	Integration tests for collect command functionality
ankiview/examples/	Sample markdown files demonstrating card formats and usage
README.md	Comprehensive documentation for collect command including format guide and troubleshooting

Files not reviewed (1)

• .idea/anki.iml: Language not supported

Comments suppressed due to low confidence (8)

ankiview/tests/test_cli.rs:1

• Using assert!(!json) is more idiomatic than assert_eq!(json, false) for boolean assertions.
  ankiview/tests/test_cli.rs:1
• Using assert!(!json) is more idiomatic than assert_eq!(json, false) for boolean assertions.
  ankiview/tests/test_cli.rs:1
• Using assert!(json) is more idiomatic than assert_eq!(json, true) for boolean assertions.
  ankiview/tests/test_cli.rs:1
• Using assert!(!json) is more idiomatic than assert_eq!(json, false) for boolean assertions.
  ankiview/tests/test_cli.rs:1
• Using assert!(json) is more idiomatic than assert_eq!(json, true) for boolean assertions.
  ankiview/tests/test_anki.rs:1
• Using assert!(!notes.is_empty()) is more idiomatic than assert!(notes.len() > 0) for checking non-empty collections.
  ankiview/tests/fixtures/build_test_collection.rs:1
• Removing unnecessary reference operator (&) since rust_logo_png is already a slice.
  ankiview/tests/fixtures/build_test_collection.rs:1
• Removing unnecessary reference operator (&) since rust_logo_png is already a slice.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.