Comment blocks in cmd/minstrel and 30 smaller internal packages, rewritten
to rule 32's standard with each citation read in context: task, milestone
and rule ids go, and so do the stories they were attached to ("used to",
"Before #N", measurements from one install, quotes, pointers to Fabled
Librarian's records and to docs/superpowers files that are not in the
repo). Where a story wrapped a real constraint, the constraint stays as a
present-tense fact.
Comments that had gone stale are corrected:
- taste.Config: the tuned values are overlaid by internal/recsettings;
it is no longer "a later follow-up".
- StorageConfig: the data dir holds art, caches and the stream secret,
not only playlist covers.
- the Subsonic album list and getUser comments describe what they do
today rather than a milestone that would change it.
Checked: the non-comment token stream of every changed file matches
HEAD, and gofmt -l is empty.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Black Keys' Ohio Players was grabbed 40 times in a day. FabledExchange
already held the torrent under another category from before Minstrel took
the downloads over: the add answered "duplicate", which counted as added,
and Exchange's listing, filtered to Minstrel's category, never showed it.
Half an hour later the grab ended gone, and the next pass took it again.
- A duplicate add that the client does not list for Minstrel is not a
grab: the release is held back for a day with the client's own reason
(already downloading X (category)), and the search moves on. Forced,
it is refused with that reason.
- A release that ends gone a second time within a week is held back for
a day, whatever the cause.
- release_blocks gains the reason 'gone' (migration 0098), shown as
"Held back: its download client lost track of it".
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- internal/release: reads a release name (format, bitrate, bit depth and
sample rate, source, year, video, discography) and judges it against the
album wanted: the artist and title must be in it; video rips,
discographies, other versions (drumless, instrumental, karaoke, remix,
live unless the album is live…) and singles or EPs for an album are
refused. Quality tiers on Lidarr's ladder; a .torrent's file list is read
for format, video files and a track count short of the album.
- internal/acquire: fan-out across every search source with a narrowed
search kept, a process-wide pacer per source, every candidate judged and
kept with its reasons, and the grab: one live grab per want, tie-broken
(a person's grab beats the schedule's; a better release replaces a worse
one unless it is nearly done). Each download lands in its own folder
under the client's downloads folder.
- internal/wanted: the search schedule, every ten minutes, never-searched
first, then requests, missing files and followed artists, taking the
best release when auto-grab is on (the default).
- Migration 0082: acquisition_settings (auto-grab, interval, allowed
qualities seeded from Lidarr's "Any"), want search columns,
want_candidates, grabs, release_blocks.
- Web: the Wanted page shows each want's last search, a Search button and
every release found with its verdict (Grab, Grab anyway, Never this one,
Allow again). Integrations gains "Searching and grabbing".
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>