docs: library comments say what the scanner and resolver do, not how they came to be (#6277)

Rewrites the internal/library comment blocks to rule 32. Task, milestone,
decision and rule ids are gone; the incidents behind them are restated as
the constraint they left (why a file is deleted before its row, why the
missing mark is a mark, why duplicates block on duration). Counts and
album names from one library are dropped from production comments; test
comments keep the names their fixtures use. The tagReadVersion log keeps
each version's before and after, without the measurements.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

internal/library/duplicate_settle.go

@@ -19,22 +19,21 @@ import (
 	syncpkg "git.fabledsword.com/bvandeusen/minstrel/internal/sync"
 )
 
-// Duplicates that settle without a merge (M498, operator 2026-10-19: "this
-// needs to be automated away"). The measured library had 536 groups waiting
-// on the operator; most were retitles across releases, now linked like any
-// cross-release group. What is left on one album is two shapes:
+// Duplicates that settle without a merge, so they do not wait on an admin.
+// Retitles across releases are linked like any cross-release group. What is
+// left on one album is three shapes:
 //
 //   - distinct: two versions of a song that sound alike ("Lovesick" and
 //     "Lovesick (Instrumental)"). Not duplicates, so the group is dismissed.
-//   - mismatch: one file filling several track slots (Savant's Void held one
-//     recording as tracks 15, 17 and 20). The album's MusicBrainz track list
+//   - mismatch: one file filling several track slots (one recording as
+//     three of an album's tracks). The album's MusicBrainz track list
 //     says how long each slot's song is. When exactly one slot's song is as
 //     long as the file and every other slot's song is clearly not, the copies
 //     in the other slots are removed and their tracks marked missing, so the
 //     reacquisition sweeper wants the album back and a good copy fills them.
 //     When every slot's song is clearly not the file, every copy goes.
-//   - named: the lengths cannot say (Savant's Mortals held one recording as
-//     16 of its 50 tracks, each cut to its own slot's length), but AcoustID
+//   - named: the lengths cannot say (one recording filed as many tracks, each
+//     cut to its own slot's length), but AcoustID
 //     can. When every copy's lookup names one recording, or the copies are
 //     the same audio and a lookup names any, the track list says whose slot
 //     that recording is: that copy is kept and the rest go, or every copy
@@ -42,9 +41,9 @@ import (
 //     know at all is no copy's song, and every copy goes.
 //
 // Whenever copies go, the release the files came from is set aside, so the
-// album fetched again is not the same files (#6169).
+// album fetched again is not the same files.
 //
-// Anything less certain stays with the operator, who settles it the same way
+// Anything less certain stays with an admin, who settles it the same way
 // with their own answer (SettleWrongSlot).
 
 const (
@@ -63,7 +62,7 @@ const (
 	// sameAudioBER is the worst bit error rate at which an acoustic group's
 	// copies are one recording cut differently rather than takes that sound
 	// alike: the groups measured as one recording trimmed to several slots
-	// read 0.000, and two takes of one song read far above this (#6169).
+	// read 0.000, and two takes of one song read far above this.
 	sameAudioBER = 0.02
 )
 
@@ -268,7 +267,7 @@ type WrongSlotResult struct {
 }
 
 // SettleWrongSlot settles a one-album mismatch the resolver left for the
-// operator (#6184), with their answer in place of MusicBrainz's lengths and
+// admin, with their answer in place of MusicBrainz's lengths and
 // AcoustID's. keepID is the copy whose title they say the recording is; an
 // invalid id means they cannot say, and every copy goes. Either way it is the
 // resolver's own path: the release the files came from is set aside, the
@@ -522,7 +521,7 @@ func neverRead(ctx context.Context, q *dbq.Queries, rg string) bool {
 // are stamped to wait for a copy fetched again (emptiedSlots). blocked names
 // the releases set aside, for the record. A file that cannot be removed stops
 // the group; the ones already gone are still marked, and the group waits for
-// the next pass. actorID is the operator settling it by hand, invalid for the
+// the next pass. actorID is the admin settling it by hand, invalid for the
 // resolver.
 func removeWrongSlots(
 	ctx context.Context, pool *pgxpool.Pool, logger *slog.Logger, g *resolveGroup, keep int, losers []int,
@@ -597,8 +596,7 @@ func removeWrongSlots(
 
 // notifyNewForReview tells admins about groups this pass classified for the
 // first time and left for them. A group the resolver settled, linked or will
-// link is not news: telling admins about those was most of what the notice
-// used to say.
+// link is not news, and would bury the groups that need them.
 func notifyNewForReview(ctx context.Context, groups []*resolveGroup, settled map[pgtype.UUID]bool) {
 	var count int64
 	var items []string