- V9 adds source/external_id to songs, moods, recommendations and jobs
- Deezer public catalog for search, related album covers and metadata
- streamrip downloader configured with DEEZER_ARL, 128/320 MP3
- per-mood source selector; switching clears and refills recommendations
- keep YouTube Music as a full second catalog and downloader
- media layout <source>-<externalId>, legacy YouTube folders still read
- Docker/streamrip install, chart ARL secret, docs and dual-source smoke test
- V8 wipe migration and the shared song store keyed by YouTube video id
- media store, indexer, downloader, recommendation top-up and refcounted GC
- mood songs plus the recommendation lifecycle and mixed radio pools
- new search, song and recommendation API; remove library/longform/seed routes
- chart PVC/media env, docs, Nix, README and an end-to-end smoke test
Scanner and library:
- Keep the last library when a configured folder cannot be walked; the
previous code deleted every song, cascading away mood seeds and progress.
- Re-adding a file now clears its tombstone, and a re-deletion refreshes the
timestamp instead of keeping the old one.
- Tombstone timestamps are unique per row, and delta pages continue from the
older of the song/tombstone page ends.
- Snapshot pagination accepts a stable revision for later pages so songs
inserted mid-sync are not skipped forever.
- Reject "%" and "_" searches that normalize to an empty LIKE needle.
Downloads and discovery:
- Download promotion uses the deterministic path id, one folder per track so
covers do not overwrite each other, removes failed promotions, and restarts
the scan after a running one finishes.
- Stale downloading jobs are recovered; reject cancels queued/in-flight jobs;
markDone only owns downloading rows; rejecting no longer seeds the track.
- Reuse an already completed download of the same video for another mood.
- yt-dlp stdout and stderr are separated, empty discovery results no longer
prune undecided recommendations, and filenames are capped by UTF-8 bytes.
API and data:
- Malformed or missing JSON returns 400 instead of 500; optional session
bodies use receiveNullable.
- Playback events must belong to the session, known song and open session.
- Radio refills the candidate pool after recent-song pruning.
- Seed percent is required in MoodRepository.update.
- Normalize legacy V4 liked/downloaded recommendation states before V5, with
an upgrade regression test.
CI: check out without persisting credentials and require tests before chart
publishing.
- user-scoped getMusicFolders, getIndexes, getArtists, getArtist,
getAlbum and getSong
- search3 with pagination, literal matching and empty/wildcard queries
- stream and download with Range support and RFC 5987 filenames
- getCoverArt with cached size variants and visibility checks
- V2 migration for per-user album and artist ratings