feat: MbBrowser seam and FakeMbBrowser test double

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

worker/lyra_worker/adapters/fakes.py

@@ -1,5 +1,6 @@
 from typing import Callable
 
+from lyra_worker.browser import ArtistHit, ReleaseGroupInfo
 from lyra_worker.types import Candidate, DownloadResult, MBTarget, Quality
 
 _QUALITIES = {
@@ -66,3 +67,17 @@ class FailingAdapter(_BaseFake):
         self, candidate: Candidate, dest: str, on_progress: Callable[[float], None]
     ) -> DownloadResult:
         return DownloadResult(ok=False, error="simulated download failure")
+
+
+class FakeMbBrowser:
+    """In-memory MbBrowser for tests. `releases` maps artist mbid -> [ReleaseGroupInfo]."""
+
+    def __init__(self, artists=None, releases=None):
+        self._artists = list(artists or [])
+        self._releases = dict(releases or {})
+
+    def search_artist(self, name: str) -> list[ArtistHit]:
+        return list(self._artists)
+
+    def browse_release_groups(self, artist_mbid: str) -> list[ReleaseGroupInfo]:
+        return list(self._releases.get(artist_mbid, []))

worker/lyra_worker/browser.py

@@ -0,0 +1,28 @@
+from dataclasses import dataclass, field
+from typing import Protocol
+
+
+@dataclass(frozen=True)
+class ArtistHit:
+    mbid: str
+    name: str
+    disambiguation: str = ""
+
+
+@dataclass(frozen=True)
+class ReleaseGroupInfo:
+    rg_mbid: str
+    title: str
+    primary_type: str = ""
+    secondary_types: tuple[str, ...] = ()
+    first_release_date: str = ""
+
+
+class MbBrowser(Protocol):
+    def search_artist(self, name: str) -> list[ArtistHit]:
+        """Artist name search → ranked hits (best first)."""
+        ...
+
+    def browse_release_groups(self, artist_mbid: str) -> list[ReleaseGroupInfo]:
+        """All official release-groups for an artist MBID."""
+        ...