Personal fork of habirabbu/musicseerr — multi-instance + inline downloads + lidarr-request

Squashes 26 incremental fork commits (Apr–May 2026) onto upstream main as a single
diff for cleaner cross-fork comparison. Original history preserved on the
pre-squash-backup tag locally.

Feature additions
─────────────────

• Inline single-track download via yt-dlp-worker proxy
  New routes: POST /api/v1/track-download/search (source: youtube | spotify),
  POST /api/v1/track-download, GET /api/v1/track-download/{id}. Frontend
  TrackDownloadButton in album track list AND popular-songs row, with a per-button
  source picker. Per-user rate limits live in the worker's SQLite store. On
  completion the backend fires Lidarr RefreshArtist + Plex library refresh +
  cache invalidation, and the popular-songs list auto-refreshes.

• Per-instance library pinning via MUSICSEERR_LIBRARY env
  Backend stamps the library label server-side (music / music-personal /
  music-shared); clients cannot override. Drives an instance-segregated
  deployment of three musicseerr containers sharing one source tree.

• Lidarr-request flow (single-track requests via Lidarr indexers)
  New routes: POST /api/v1/lidarr-request, GET /api/v1/lidarr-request/status.
  Per-album asyncio.Lock keyed on album_mbid so rapid-clicks on the same album
  serialize correctly. Cross-release track matcher with foreignTrackId →
  foreignRecordingId → position+disc → exact-title → substring fallback chain,
  evaluated per release (recording UUIDs frequently differ between album,
  single, and deluxe edition releases of the same song). Flips
  artist.monitored = True on request so Lidarr's WantedAlbums query reaches
  the track. Full Lidarr-chain gate (artist AND album AND track) for the
  status endpoint to avoid false-positive REQUESTED display. Persistent UI
  state so button icons survive refresh and cross-album navigation.

• Privacy: show_now_playing toggle in Settings → Home
  Default off. Plex /status/sessions returns active audio sessions across the
  whole server with no library-section filter, so a shared instance leaks
  every household member's listening activity. The merged store still emits
  the user's local MusicSeerr playback bar; only server-derived sessions
  (Plex / Jellyfin / Navidrome) are gated.

• Per-button visibility prefs for the track-row action cluster
  Settings → Preferences → Download Options / Playback Buttons. Per-context
  (popular_songs / album_page) force-off flags layered on top of the existing
  source-availability gate.

• UX: wrap action cluster on mobile, hide LidarrRequestButton in tight
  layouts, cross-album status-leak fix in AlbumTrackList ($effect keyed on
  album.musicbrainz_id to rebuild lookup; map keyed by
  "{albumMbid}:{position}:{disc}").

Test coverage
─────────────

Backend pytest: full suite green (2031/2031 as of squash). New: schema-default
tests for HomeSettings, lidarr_request_service cross-release matcher
regression test, singleton-registry expected-count bump to 59. Frontend
vitest: SettingsHome.svelte.spec covers new toggle, nowPlayingSessions
.svelte.spec covers the privacy gate (no fetch when off; fetches when on).

backend/repositories/lidarr/artist.py

@@ -192,6 +192,37 @@ class LidarrArtistRepository(LidarrBase):
         except Exception as e:  # noqa: BLE001
             return None
 
+    async def trigger_refresh_by_mbid(self, artist_mbid: str) -> int | None:
+        """Fire RefreshArtist for the artist matching `artist_mbid` (best effort,
+        does NOT wait for completion). Returns the Lidarr command id on success.
+
+        Used by the track-download flow to scope a rescan to JUST the artist
+        whose file was just written, rather than a full RescanFolders. Failures
+        are swallowed — this is an enhancement, not a critical-path call.
+        """
+        try:
+            items = await self._get("/api/v1/artist", params={"mbId": artist_mbid})
+            if not items or not isinstance(items, list):
+                logger.debug("trigger_refresh_by_mbid: no Lidarr artist for mbid=%s", artist_mbid)
+                return None
+            artist_id = items[0].get("id")
+            if not artist_id:
+                return None
+            cmd = await self._post_command(
+                {"name": "RefreshArtist", "artistId": artist_id}
+            )
+            cmd_id = cmd.get("id") if isinstance(cmd, dict) else None
+            logger.info(
+                "trigger_refresh_by_mbid: fired RefreshArtist artist_id=%s mbid=%s cmd_id=%s",
+                artist_id, artist_mbid, cmd_id,
+            )
+            return cmd_id
+        except Exception as e:  # noqa: BLE001
+            logger.warning(
+                "trigger_refresh_by_mbid failed for mbid=%s: %s", artist_mbid, e
+            )
+            return None
+
     async def delete_artist(self, artist_id: int, delete_files: bool = False) -> bool:
         try:
             params = {"deleteFiles": str(delete_files).lower(), "addImportListExclusion": "false"}