feat(catalog): browse peer catalogs and request titles into *arr

[roziscoding]

What

Browse a unified, cross-peer media catalog and request titles into Radarr/Sonarr — Jack downloads the file straight from the peer and hands it to *arr.

• One catalog page (/catalog) aggregates every connected peer's library into a single poster wall with a peer picker and movie/TV filter, enriched with TMDB artwork, year, and rating, plus a per-title detail slideover.
• Request a title → pick the destination *arr and root folder → Jack adds the title to Radarr/Sonarr monitored with search disabled, direct-downloads the matching release(s) from the peer, then triggers a *arr manual import so the file lands in the library. No indexer grab is involved.
• TMDB key is managed in Settings (config.jack.tmdbApiKey) with a live connection-status indicator.

How it's built

• New backend catalog module exposing GET /catalog (fans out to every initialized peer, groups their releases into unified titles), GET /catalog/tmdb/status, GET /catalog/tmdb/:mediaType/:tmdbId (per-card metadata), GET /catalog/request-options (destinations + root folders), and POST /catalog/request.
• Request flow (requestDownload): server.add looks the title up (tmdb:/tvdb:) and adds it monitored without triggering a search, then startDirectDownload creates a jack_manual download row per release bound to the destination + import target. Movies pick the single best release; series pick the best release per episode, all bound to one series id.
• Import: the ImportWatcher reconciles import_queued rows — a match against *arr's import history (by derived hash) flips the row to imported, otherwise it triggers a *arr manual-import command and tracks it by command id (completed / failed / pending). A pruned command record (404) is terminal so the row fails instead of polling a vanished id forever; transient errors retry next tick.
• TMDB metadata comes from a small cached, concurrency-capped TmdbClient.
• Frontend: unified catalog page (instant-load skeletons, peer picker, type filter), poster card with image fallback, title detail slideover with a "View in Logflix" link, a per-peer download request modal, plus TMDB settings and an About section (Nuxt UI).

Tests / checks

• 386 backend tests pass — catalog grouping, TMDB mappers, status branching, request routing, MSW-mocked Radarr/Sonarr add + manual-import payloads, and manual-import command-status recovery.
• eslint clean on the touched files.

Scope notes

• *arr is added monitored with search off — the actual file comes from the peer direct-download + manual import, not a Jack torznab indexer / blackhole grab.
• Catalog pagination/virtualization is intentionally deferred (posters lazy-load).
• Pre-upgrade import_queued rows are not backfilled with the new stable sourceServerId; they keep matching their destination by name (intentional — consequences are minimal).

Manual verification (needs a live peer + *arr + TMDB key)

• Browse the catalog, open a title, request it to a destination, and confirm Jack downloads the release and the file imports into Radarr/Sonarr.

Greptile Summary

This PR adds a cross-peer catalog and request flow for sending titles into Radarr and Sonarr. The main changes are:

• New backend catalog endpoints for browsing peer releases, TMDB metadata, request options, and title requests.
• Direct-download request handling that adds titles to Radarr or Sonarr and queues manual imports.
• Import watcher updates for manual import command tracking and stable destination matching.
• Frontend catalog, detail, request modal, and TMDB settings UI.

Confidence Score: 5/5

This looks safe to merge.

• No blocking issues found in the changed code.

Comments Outside Diff (8)

1. apps/backend/src/modules/catalog/catalog.controller.ts, line 2620-2622 (link)

   Duplicate Downloads Report Success

   When startDirectDownload() returns duplicate, this movie path treats it as success and reports started: 1 even though no new row was created and no download was started. A repeated request or filename collision can tell the user the title is downloading while the catalog flow did not queue anything new.

   

2. apps/backend/src/modules/catalog/catalog.controller.ts, line 2643-2644 (link)

   Duplicate Episodes Count As Started

   The series loop increments started for every result except failed, so duplicate episode downloads are counted as newly started. If two selected episodes resolve to the same destination filename, or one episode was already queued, the API overstates the started count and the skipped episode is never downloaded or imported by this request.

   

3. apps/backend/src/modules/downloads/import-watcher.ts, line 3044-3052 (link)

   Manual Imports Can Stay Queued

   After this branch successfully posts a ManualImport command, the row is only completed later if the history poll sees the derived hash in downloadFolderImported events. Catalog downloads bypass the download-client import path, so if Radarr or Sonarr records ManualImport under a different event type or ignores the supplied downloadId, manualImportTriggered suppresses retries while the row remains import_queued forever.

   

4. apps/backend/src/modules/downloads/import-watcher.ts, line 3032-3033 (link)

   Renamed Servers Orphan Imports

   Queued imports are grouped by the stored destination server name and later matched with s.name. If a direct catalog download reaches import_queued and the destination is renamed before the watcher processes it, no connector matches the old name, the group is skipped silently, and ManualImport is never triggered for that row.

   

5. apps/backend/src/lib/servers/arr/sonarr.ts, line 2337-2339 (link)

   Unparsed Episodes Retry Forever

   A matching Sonarr manual-import candidate is dropped when Sonarr returns it without episode ids. For filenames Sonarr cannot parse, this leaves files empty on every watcher tick, so the row stays queued and logs the same manual-import failure repeatedly instead of marking the download failed or surfacing the unimportable file.

   

6. apps/backend/src/modules/catalog/catalog.lib.ts, line 2736-2739 (link)

   Same-Name Titles Can Merge

   The alias map is first-writer-wins by normalized title name, so two different id-bearing titles with the same display name can be collapsed under whichever strong key appears first. For remakes or same-name TV series from different years, the catalog can mix releases under one title and send the request flow the wrong external id.

   

7. apps/backend/src/modules/catalog/catalog.lib.ts, line 2817-2821 (link)

   Unnumbered Episodes Collapse Together

   pickBestPerEpisode() maps missing season and episode to 0:0, so every unnumbered release for a series competes for the same slot. If a peer returns specials, extras, or poorly parsed TV releases without S/E fields, only one is downloaded and the rest are silently skipped.

   

8. apps/ui/app/composables/useCatalogMetadata.ts, line 3991-3999 (link)

   Metadata Errors Block Retry

   The cache guard treats an error entry as already loaded because { status: 'error', data: null } is truthy. A transient TMDB or backend failure while a card first loads leaves that title blank for the rest of the page session, even after the service recovers.

   

_{Reviews (5): Last reviewed commit: "fix(arr): fail rows on pruned manual-imp..." | Re-trigger Greptile}