refactor(library): back library index with sqlite-direct library_tracks cache #48

Replaces the in-memory Library mirror (DirCache, Snapshot, TrackReader) and auxiliary library tables (release_provenance, release_owners, library_sidecar_covers) with a single rebuildable library_tracks SQLite cache table queried directly over WAL reader pools.

Review Links #

• Whole PR (v1..refactor/library-sqlite-cache): https://tangled.org/sullen.net/gobuz/pulls/48/latest
• Critique PR: https://critique.sullen.net/pr/sullen.net/gobuz/48
• Interdiff (v3..v4): https://tangled.org/sullen.net/gobuz/pulls/48/v3..v4
• CL 1 (mnysnsnt / fce5ab61) — Tangled diff · Interdiff (v3..v4) · Critique
• CL 2 (qpopzlmu / 5e7e436b) — Tangled diff · Interdiff (v3..v4) · Critique

Stack Overview #

• CL 1 (mnysnsnt) — refactor(config,store,models): enforce startup folder invariants and track-only library schema
  • Makes (Config).ResolveFolders() fail fast on missing/non-directory AuxDir entries, duplicate resolved roots, or nested/overlapping folder paths, resolving root symlinks once via filepath.EvalSymlinks while preserving :ro (default) and :rw AuxDir suffixes.
  • Replaces release_provenance, release_owners, and library_sidecar_covers in schemaV1 and PurgeCache with library_tracks (track_id primary key + 7 lookup indexes, storing root_folder_path).
  • Adds LocalTrackID and ReleaseKey to models.LibraryTrack, and adds ReleaseKey, RouteID(), and unabbreviated CoverModifiedTime to models.LibraryRelease.
• CL 2 (qpopzlmu) — refactor(library): back library index with sqlite-direct library_tracks cache
  • Rebuilds internal/library atop *store.DB (GetRelease, ListReleases, ListReleasesByDirectory, DeleteRelease, GetReleaseCover, MatchTrack, Scan, ScanFiles, Ready, Folders, and ThumbnailCache).
  • Derives 4-tier ReleaseKey (qobuz:<id>, mb:<uuid>, upc:<gtin>, tag:<24-hex>) purely from embedded audio tags via incremental (mtime_ns, size_bytes) worker-pool scans, ignoring symlinks inside music folders and failing fast if any configured root folder is inaccessible.
  • Resolves and validates sidecar covers (cover.{jpg,jpeg,png}) on demand in exclusive release/parent directories before falling back to embedded cover extraction, and prunes orphaned sidecars/booklet.pdf/empty subdirectories upward stopping strictly below root_folder_path on DeleteRelease.
  • Updates internal/web/library (removing bulk /library/delete-all, keying ThumbnailCache on ReleaseKey + CoverModifiedTime), internal/web/catalog (controller-local per-ReleaseKey Goosefoot import lock + multi-release directory 409 Conflict guard + detached upstream Import stream drain & post-import Scan on client disconnect), internal/playlist/resolver, internal/web/pages, and internal/web/server (ReleaseDeleted thumbnail invalidation).