feat: Lidarr searches for a better copy of a rip that has none (M498 #5447)

The operator chose option 2: an album holding a video rip that is the only
copy of its song is searched in Lidarr (AlbumSearch), at most once a week
and ten albums a pass. Lidarr grabs only when the quality profile allows an
upgrade, so nothing is removed and the rip stays held back either way.

- lidarr.Client.SearchAlbums posts the AlbumSearch command.
- ListAlbumsWithSoleCopyRips finds the albums: a held-back rip with no
  present clean copy sharing its song or its pending group, and not searched
  in the last week (audit action lidarr_rip_search).
- Suspect sources shows when Lidarr last searched the track's album.

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

internal/lidarr/releases.go

@@ -152,3 +152,24 @@ func (c *Client) SetMonitoredRelease(ctx context.Context, albumID, releaseID int
 	_ = putResp.Body.Close()
 	return nil
 }
+
+// SearchAlbums asks Lidarr to search its indexers for the albums
+// (POST /api/v1/command, AlbumSearch). Lidarr grabs a release only when it
+// beats the files the album already has under the quality profile, so for an
+// album whose tracks are all present this is an upgrade search: harmless when
+// nothing better exists. The command is queued; the call does not wait for it.
+func (c *Client) SearchAlbums(ctx context.Context, albumIDs []int) error {
+	if len(albumIDs) == 0 {
+		return nil
+	}
+	body, err := json.Marshal(map[string]any{"name": "AlbumSearch", "albumIds": albumIDs})
+	if err != nil {
+		return fmt.Errorf("%w: marshal command: %v", ErrInvalidPayload, err)
+	}
+	resp, err := c.post(ctx, "/api/v1/command", body)
+	if err != nil {
+		return err
+	}
+	_ = resp.Body.Close()
+	return nil
+}

internal/lidarr/releases_test.go

@@ -114,3 +114,25 @@ func TestSetMonitoredRelease_UnknownReleaseSendsNothing(t *testing.T) {
 		t.Errorf("err = %v, want ErrNotFound", err)
 	}
 }
+
+func TestSearchAlbums_PostsTheCommand(t *testing.T) {
+	var got map[string]any
+	c, srv := newTestClient(func(w http.ResponseWriter, r *http.Request) {
+		if r.Method != http.MethodPost || r.URL.Path != "/api/v1/command" {
+			t.Errorf("request = %s %s, want POST /api/v1/command", r.Method, r.URL.Path)
+		}
+		b, _ := io.ReadAll(r.Body)
+		_ = json.Unmarshal(b, &got)
+		w.WriteHeader(http.StatusCreated)
+		_, _ = w.Write([]byte(`{"id":1,"name":"AlbumSearch"}`))
+	})
+	defer srv.Close()
+
+	if err := c.SearchAlbums(context.Background(), []int{4723, 12}); err != nil {
+		t.Fatalf("SearchAlbums: %v", err)
+	}
+	ids, _ := got["albumIds"].([]any)
+	if got["name"] != "AlbumSearch" || len(ids) != 2 || ids[0] != float64(4723) || ids[1] != float64(12) {
+		t.Errorf("command = %v", got)
+	}
+}