feat: download lifecycle — stalled and failed downloads are given up and searched again; imported ones seed, then go (M502 #5523)

Ported from Fabled Librarian's System 104. A new lifecycle poller, every
ten minutes:
- a download the client fails is given up at once;
- one nobody shares, or still fetching its file list, past the stall
  setting (6 h) is asked for again three times, then given up;
- giving up removes the download with its files, holds the release back
  for a week (release_blocks.expires_at), ends the grab and searches the
  album again, with no limit per album;
- a running download the client stops listing for half an hour ends and is
  searched again, not held back; an empty list is not taken as gone;
- an imported download seeds to ratio 2.0 or 14 days, then is removed;
- a download the client would not remove is asked again every pass.

Every condition and act is one open row per (client, download, condition)
in download_interventions. Activity shows what is wrong with a download and
how often it was retried, why one ended, its seeding, and a banner for a
client that does not answer. A running download can be given up by hand
(set aside for good). The seed ratio, seed days and stall hours are on the
search settings card. The download client lookup moves to
acquire.DownloadClientFor, shared by the importer and the lifecycle.

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

internal/db/dbq/imports.sql.go

@@ -16,7 +16,7 @@ UPDATE grabs
    SET import_state = 'importing', import_attempts = import_attempts + 1,
        import_updated_at = now(), progress = 1
  WHERE id = $1 AND ended_at IS NULL AND import_state IN ('', 'downloading', 'waiting')
-RETURNING id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination
+RETURNING id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination, seeding, ratio, seed_released_at
 `
 
 // Takes a finished download for import. The update is the lock: a second
@@ -52,6 +52,9 @@ func (q *Queries) ClaimGrabImport(ctx context.Context, id pgtype.UUID) (Grab, er
 		&i.ImportedAt,
 		&i.ImportedFiles,
 		&i.Destination,
+		&i.Seeding,
+		&i.Ratio,
+		&i.SeedReleasedAt,
 	)
 	return i, err
 }
@@ -60,7 +63,7 @@ const forceGrabImport = `-- name: ForceGrabImport :one
 UPDATE grabs
    SET import_state = '', import_forced = true, import_reason = '', import_updated_at = now()
  WHERE id = $1 AND ended_at IS NULL AND import_state IN ('review', 'failed')
-RETURNING id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination
+RETURNING id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination, seeding, ratio, seed_released_at
 `
 
 // "Import anyway": the next pass imports the download whatever the check said.
@@ -95,12 +98,15 @@ func (q *Queries) ForceGrabImport(ctx context.Context, id pgtype.UUID) (Grab, er
 		&i.ImportedAt,
 		&i.ImportedFiles,
 		&i.Destination,
+		&i.Seeding,
+		&i.Ratio,
+		&i.SeedReleasedAt,
 	)
 	return i, err
 }
 
 const getGrab = `-- name: GetGrab :one
-SELECT id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination FROM grabs WHERE id = $1
+SELECT id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination, seeding, ratio, seed_released_at FROM grabs WHERE id = $1
 `
 
 func (q *Queries) GetGrab(ctx context.Context, id pgtype.UUID) (Grab, error) {
@@ -134,6 +140,9 @@ func (q *Queries) GetGrab(ctx context.Context, id pgtype.UUID) (Grab, error) {
 		&i.ImportedAt,
 		&i.ImportedFiles,
 		&i.Destination,
+		&i.Seeding,
+		&i.Ratio,
+		&i.SeedReleasedAt,
 	)
 	return i, err
 }
@@ -202,9 +211,16 @@ const listGrabs = `-- name: ListGrabs :many
 SELECT g.id, g.want_id, g.name, g.indexer, g.client, g.quality, g.origin, g.forced,
        g.grabbed_at, g.ended_at, g.end_reason, g.end_detail, g.progress, g.import_state,
        g.import_reason, g.import_detail, g.import_updated_at, g.imported_at, g.imported_files,
-       g.destination, w.title AS want_title, w.artist_name AS want_artist
+       g.destination, g.seeding, g.ratio, g.seed_released_at,
+       w.title AS want_title, w.artist_name AS want_artist,
+       di.trigger AS condition, di.detail AS condition_detail, di.remediations AS condition_retries,
+       di.first_seen AS condition_since
   FROM grabs g
   LEFT JOIN wants w ON w.id = g.want_id
+  LEFT JOIN download_interventions di
+         ON di.id = (SELECT x.id FROM download_interventions x
+                      WHERE x.grab_id = g.id AND x.outcome = 'open'
+                      ORDER BY x.last_seen DESC LIMIT 1)
  ORDER BY (g.ended_at IS NULL AND g.import_state IN ('review', 'failed')) DESC,
           g.ended_at IS NULL DESC, g.grabbed_at DESC, g.id
  LIMIT $2 OFFSET $1
@@ -216,32 +232,40 @@ type ListGrabsParams struct {
 }
 
 type ListGrabsRow struct {
-	ID              pgtype.UUID
-	WantID          pgtype.UUID
-	Name            string
-	Indexer         string
-	Client          string
-	Quality         string
-	Origin          string
-	Forced          bool
-	GrabbedAt       pgtype.Timestamptz
-	EndedAt         pgtype.Timestamptz
-	EndReason       string
-	EndDetail       string
-	Progress        float32
-	ImportState     string
-	ImportReason    string
-	ImportDetail    []byte
-	ImportUpdatedAt pgtype.Timestamptz
-	ImportedAt      pgtype.Timestamptz
-	ImportedFiles   int32
-	Destination     string
-	WantTitle       *string
-	WantArtist      *string
+	ID               pgtype.UUID
+	WantID           pgtype.UUID
+	Name             string
+	Indexer          string
+	Client           string
+	Quality          string
+	Origin           string
+	Forced           bool
+	GrabbedAt        pgtype.Timestamptz
+	EndedAt          pgtype.Timestamptz
+	EndReason        string
+	EndDetail        string
+	Progress         float32
+	ImportState      string
+	ImportReason     string
+	ImportDetail     []byte
+	ImportUpdatedAt  pgtype.Timestamptz
+	ImportedAt       pgtype.Timestamptz
+	ImportedFiles    int32
+	Destination      string
+	Seeding          bool
+	Ratio            float32
+	SeedReleasedAt   pgtype.Timestamptz
+	WantTitle        *string
+	WantArtist       *string
+	Condition        *string
+	ConditionDetail  *string
+	ConditionRetries *int32
+	ConditionSince   pgtype.Timestamptz
 }
 
 // The Wanted view's Activity tab: downloads waiting on a person first, then
-// the rest still running, then the ended ones newest first.
+// the rest still running, then the ended ones newest first. Each carries
+// what is wrong with it now, if anything (#5523).
 func (q *Queries) ListGrabs(ctx context.Context, arg ListGrabsParams) ([]ListGrabsRow, error) {
 	rows, err := q.db.Query(ctx, listGrabs, arg.Skip, arg.MaxRows)
 	if err != nil {
@@ -272,8 +296,15 @@ func (q *Queries) ListGrabs(ctx context.Context, arg ListGrabsParams) ([]ListGra
 			&i.ImportedAt,
 			&i.ImportedFiles,
 			&i.Destination,
+			&i.Seeding,
+			&i.Ratio,
+			&i.SeedReleasedAt,
 			&i.WantTitle,
 			&i.WantArtist,
+			&i.Condition,
+			&i.ConditionDetail,
+			&i.ConditionRetries,
+			&i.ConditionSince,
 		); err != nil {
 			return nil, err
 		}
@@ -287,7 +318,7 @@ func (q *Queries) ListGrabs(ctx context.Context, arg ListGrabsParams) ([]ListGra
 
 const listLiveGrabs = `-- name: ListLiveGrabs :many
 
-SELECT g.id, g.want_id, g.info_hash, g.name, g.key, g.indexer, g.source, g.client, g.save_path, g.quality, g.origin, g.forced, g.grabbed_by, g.grabbed_at, g.ended_at, g.end_reason, g.end_detail, g.progress, g.import_state, g.import_reason, g.import_detail, g.import_forced, g.import_attempts, g.import_updated_at, g.imported_at, g.imported_files, g.destination, w.release_group_mbid, w.artist_mbid, w.artist_name, w.title AS want_title,
+SELECT g.id, g.want_id, g.info_hash, g.name, g.key, g.indexer, g.source, g.client, g.save_path, g.quality, g.origin, g.forced, g.grabbed_by, g.grabbed_at, g.ended_at, g.end_reason, g.end_detail, g.progress, g.import_state, g.import_reason, g.import_detail, g.import_forced, g.import_attempts, g.import_updated_at, g.imported_at, g.imported_files, g.destination, g.seeding, g.ratio, g.seed_released_at, w.release_group_mbid, w.artist_mbid, w.artist_name, w.title AS want_title,
        w.reason AS want_reason, w.album_id AS want_album_id
   FROM grabs g
   LEFT JOIN wants w ON w.id = g.want_id
@@ -323,6 +354,9 @@ type ListLiveGrabsRow struct {
 	ImportedAt       pgtype.Timestamptz
 	ImportedFiles    int32
 	Destination      string
+	Seeding          bool
+	Ratio            float32
+	SeedReleasedAt   pgtype.Timestamptz
 	ReleaseGroupMbid *string
 	ArtistMbid       *string
 	ArtistName       *string
@@ -370,6 +404,9 @@ func (q *Queries) ListLiveGrabs(ctx context.Context) ([]ListLiveGrabsRow, error)
 			&i.ImportedAt,
 			&i.ImportedFiles,
 			&i.Destination,
+			&i.Seeding,
+			&i.Ratio,
+			&i.SeedReleasedAt,
 			&i.ReleaseGroupMbid,
 			&i.ArtistMbid,
 			&i.ArtistName,
@@ -388,10 +425,11 @@ func (q *Queries) ListLiveGrabs(ctx context.Context) ([]ListLiveGrabsRow, error)
 }
 
 const listReleaseBlocksPage = `-- name: ListReleaseBlocksPage :many
-SELECT b.info_hash, b.name, b.reason, b.detail, b.blocked_at, w.title AS want_title,
+SELECT b.info_hash, b.name, b.reason, b.detail, b.blocked_at, b.expires_at, w.title AS want_title,
        w.artist_name AS want_artist
   FROM release_blocks b
   LEFT JOIN wants w ON w.id = b.want_id
+ WHERE b.expires_at IS NULL OR b.expires_at > now()
  ORDER BY b.blocked_at DESC, b.info_hash
  LIMIT $2 OFFSET $1
 `
@@ -407,6 +445,7 @@ type ListReleaseBlocksPageRow struct {
 	Reason     string
 	Detail     string
 	BlockedAt  pgtype.Timestamptz
+	ExpiresAt  pgtype.Timestamptz
 	WantTitle  *string
 	WantArtist *string
 }
@@ -426,6 +465,7 @@ func (q *Queries) ListReleaseBlocksPage(ctx context.Context, arg ListReleaseBloc
 			&i.Reason,
 			&i.Detail,
 			&i.BlockedAt,
+			&i.ExpiresAt,
 			&i.WantTitle,
 			&i.WantArtist,
 		); err != nil {
@@ -522,13 +562,16 @@ UPDATE grabs
        import_updated_at = now(),
        import_forced = false,
        imported_at = CASE WHEN $1::text = 'imported' THEN now() ELSE imported_at END,
+       -- The files were copied, so an imported download goes on sharing
+       -- until the lifecycle removes it (#5523).
+       seeding = $1::text = 'imported',
        imported_files = $4,
        destination = $5,
        ended_at = CASE WHEN $6::text <> '' THEN now() ELSE ended_at END,
        end_reason = $6,
        end_detail = CASE WHEN $6::text <> '' THEN $2::text ELSE end_detail END
  WHERE id = $7
-RETURNING id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination
+RETURNING id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination, seeding, ratio, seed_released_at
 `
 
 type RecordImportParams struct {
@@ -582,6 +625,9 @@ func (q *Queries) RecordImport(ctx context.Context, arg RecordImportParams) (Gra
 		&i.ImportedAt,
 		&i.ImportedFiles,
 		&i.Destination,
+		&i.Seeding,
+		&i.Ratio,
+		&i.SeedReleasedAt,
 	)
 	return i, err
 }
@@ -591,7 +637,7 @@ UPDATE grabs g
    SET want_id = $1
  WHERE g.id = $2 AND g.ended_at IS NULL
    AND NOT EXISTS (SELECT 1 FROM grabs o WHERE o.want_id = $1 AND o.ended_at IS NULL)
-RETURNING id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination
+RETURNING id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination, seeding, ratio, seed_released_at
 `
 
 type RehomeGrabParams struct {
@@ -632,6 +678,9 @@ func (q *Queries) RehomeGrab(ctx context.Context, arg RehomeGrabParams) (Grab, e
 		&i.ImportedAt,
 		&i.ImportedFiles,
 		&i.Destination,
+		&i.Seeding,
+		&i.Ratio,
+		&i.SeedReleasedAt,
 	)
 	return i, err
 }
@@ -640,7 +689,7 @@ const retryGrabImport = `-- name: RetryGrabImport :one
 UPDATE grabs
    SET import_state = '', import_reason = '', import_updated_at = now()
  WHERE id = $1 AND ended_at IS NULL AND import_state = 'failed'
-RETURNING id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination
+RETURNING id, want_id, info_hash, name, key, indexer, source, client, save_path, quality, origin, forced, grabbed_by, grabbed_at, ended_at, end_reason, end_detail, progress, import_state, import_reason, import_detail, import_forced, import_attempts, import_updated_at, imported_at, imported_files, destination, seeding, ratio, seed_released_at
 `
 
 func (q *Queries) RetryGrabImport(ctx context.Context, id pgtype.UUID) (Grab, error) {
@@ -674,6 +723,9 @@ func (q *Queries) RetryGrabImport(ctx context.Context, id pgtype.UUID) (Grab, er
 		&i.ImportedAt,
 		&i.ImportedFiles,
 		&i.Destination,
+		&i.Seeding,
+		&i.Ratio,
+		&i.SeedReleasedAt,
 	)
 	return i, err
 }