docs: query comments say what each query selects and why, not how it came to be (#6277)

Rewrites the internal/db/queries comments to rule 32 and regenerates dbq, whose doc comments and embedded SQL carry them. The bugs behind the tiered mixes, the md5 order seed, the score bands and the round-robin arms are restated as the constraint each one enforces; counts from one library and stale cross-references are gone. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 12:31:13 -04:00
parent 7e6228c13f
commit 1d4ef1a23f
100 changed files with 648 additions and 698 deletions
@@ -8,7 +8,7 @@ UPDATE library_settings
 WHERE id = true
 RETURNING *;

-- A library folder that moved (#6129): every path under old_root is rewritten
+-- A library folder that moved: every path under old_root is rewritten
 -- to the same place under new_root, so the tracks keep their ids and with them
 -- their plays, likes and playlists. updated_at is left alone on purpose: the
 -- scan compares it with each file's mtime, and the files have not changed.