Implement read-only fixture scanner foundation #1

Closed
opened 2026-06-10 15:56:19 -07:00 by david · 2 comments
Owner

Goal

Build the first scanner foundation against fixtures/test-library.

Current foundation

  • Dependency-free Node scanner.
  • npm run scan:fixtures emits a read-only JSON report.
  • npm test covers fixture discovery, multi-disc audiobook grouping, partial-download filtering, and core candidate visibility.

Next work

  • Extract metadata evidence from OPF, JSON, NFO, and filename/folder signals.
  • Add duplicate signals.
  • Start dry-run import plan output.
  • Keep source fixture files read-only.
## Goal Build the first scanner foundation against fixtures/test-library. ## Current foundation - Dependency-free Node scanner. - npm run scan:fixtures emits a read-only JSON report. - npm test covers fixture discovery, multi-disc audiobook grouping, partial-download filtering, and core candidate visibility. ## Next work - Extract metadata evidence from OPF, JSON, NFO, and filename/folder signals. - Add duplicate signals. - Start dry-run import plan output. - Keep source fixture files read-only.
Author
Owner

Metadata evidence extraction is now implemented in the scanner foundation.

Current fixture scan summary:

  • 26 files
  • 16 candidates
  • 10 importable candidates
  • 33 evidence records
  • 2 partial downloads held as not importable

Evidence records now include source path, source type, confidence, normalized fields, and notes. Current parsers cover OPF, JSON, NFO, and path-derived hints.

Next target: duplicate signals and dry-run import plan output.

Metadata evidence extraction is now implemented in the scanner foundation. Current fixture scan summary: - 26 files - 16 candidates - 10 importable candidates - 33 evidence records - 2 partial downloads held as not importable Evidence records now include source path, source type, confidence, normalized fields, and notes. Current parsers cover OPF, JSON, NFO, and path-derived hints. Next target: duplicate signals and dry-run import plan output.
Author
Owner

M1 scanner foundation is complete locally.

Final fixture scan summary:

  • 27 files
  • 17 candidates
  • 11 importable candidates
  • 34 evidence records
  • 2 duplicate signals
  • 17 dry-run import plan actions
  • 2 partial downloads held as not importable

Implemented behavior:

  • Read-only scanner against fixture roots
  • File classification
  • Candidate grouping, including audiobook disc folders
  • OPF/JSON/NFO/path metadata evidence
  • Duplicate normalized identity signals
  • Non-destructive dry-run import plan actions: stage-copy, review, hold

This is not a release. Next milestone: M2 data model/schema planning from the scanner report shape.

M1 scanner foundation is complete locally. Final fixture scan summary: - 27 files - 17 candidates - 11 importable candidates - 34 evidence records - 2 duplicate signals - 17 dry-run import plan actions - 2 partial downloads held as not importable Implemented behavior: - Read-only scanner against fixture roots - File classification - Candidate grouping, including audiobook disc folders - OPF/JSON/NFO/path metadata evidence - Duplicate normalized identity signals - Non-destructive dry-run import plan actions: stage-copy, review, hold This is not a release. Next milestone: M2 data model/schema planning from the scanner report shape.
david closed this issue 2026-06-10 16:40:46 -07:00
Sign in to join this conversation.
No labels
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
david/library-manager#1
No description provided.