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>

internal/db/dbq/duplicates.sql.go

@@ -55,9 +55,9 @@ SELECT count(*)::bigint
        END
 `
 
-// CountPendingDuplicateGroups narrowed to one view of the report (M498):
+// CountPendingDuplicateGroups narrowed to one view of the report:
 //
-//	review         what the operator still has to decide: every class but
+//	review         what an admin still has to decide: every class but
 //	               cross_release, and groups not yet classified
 //	cross_release  the same song on different releases, which is kept, not merged
 func (q *Queries) CountPendingDuplicateGroupsInView(ctx context.Context, view string) (int64, error) {
@@ -205,7 +205,7 @@ type ListDismissedDuplicateMemberSetsRow struct {
 	TrackIds []pgtype.UUID
 }
 
-// What the operator has already said are not duplicates. A new proposal whose
+// What an admin has already said are not duplicates. A new proposal whose
 // every member sat together in one of these is not proposed again.
 func (q *Queries) ListDismissedDuplicateMemberSets(ctx context.Context) ([]ListDismissedDuplicateMemberSetsRow, error) {
 	rows, err := q.db.Query(ctx, listDismissedDuplicateMemberSets)
@@ -236,7 +236,7 @@ SELECT t.id, t.duration_ms, f.audio_stream_sha256, f.chromaprint
    AND f.chromaprint IS NOT NULL
    -- Only chromaprints taken at the current length: prints at two lengths are not
    -- comparable, and after a length change the backfill is still re-deriving the
-   -- rest (#3913).
+   -- rest.
    AND f.chromaprint_length_sec = $2
    AND (t.duration_ms, t.id) > ($3::integer, $4::uuid)
  ORDER BY t.duration_ms, t.id
@@ -356,19 +356,19 @@ type ListDuplicateGroupsForResolveRow struct {
 	AcoustidRecording *string
 }
 
-// Every pending group's present copies, for the resolver (M498 #5435): what it
+// Every pending group's present copies, for the resolver: what it
 // needs to classify the group and to choose the copy to keep. One row per copy,
 // grouped by group. position_clash is true when another present track on the
 // same album claims the same disc and track number: tags that do not fit the
 // album, which the survivor rule weighs against a copy. source_verdict says
-// whether the copy is a video rip ('suspect') or one the operator kept ('fine').
+// whether the copy is a video rip ('suspect') or one an admin kept ('fine').
 // prior_class is the class the last pass gave the group, NULL for a group no
 // pass has seen. release_group_mbid is the album's MusicBrainz group, from its
 // tags or the library listing's match; ” when neither names one.
 // acoustid_state and acoustid_recording are what AcoustID said of the file,
-// when it was looked up (#6169: which song one recording cut to several slots
-// is). group_id narrows it to one group, for the operator settling it (#6184);
-// NULL reads them all.
+// when it was looked up: which song a recording cut to several slots is.
+// group_id narrows it to one group, for an admin settling it; NULL reads them
+// all.
 func (q *Queries) ListDuplicateGroupsForResolve(ctx context.Context, groupID pgtype.UUID) ([]ListDuplicateGroupsForResolveRow, error) {
 	rows, err := q.db.Query(ctx, listDuplicateGroupsForResolve, groupID)
 	if err != nil {
@@ -533,7 +533,7 @@ type ListPendingDuplicateGroupMembersRow struct {
 // One page of proposals in one view (see CountPendingDuplicateGroupsInView),
 // newest first, flattened to one row per member so the handler folds them
 // without a query per group. What each copy carries — likes and plays from
-// every user — is here because it is what the operator weighs when deciding
+// every user — is here because it is what an admin weighs when deciding
 // which copy to keep.
 func (q *Queries) ListPendingDuplicateGroupMembers(ctx context.Context, arg ListPendingDuplicateGroupMembersParams) ([]ListPendingDuplicateGroupMembersRow, error) {
 	rows, err := q.db.Query(ctx, listPendingDuplicateGroupMembers, arg.View, arg.PageOffset, arg.PageLimit)