Add approved Sonarr release grabs

2026-08-23 14:38:42 +02:00
parent 76bfc65978
commit 09634a27f9
3 changed files with 289 additions and 7 deletions
@@ -166,5 +166,25 @@ Der erlaubte Schreibablauf ist eng auf fehlende Episoden begrenzt:
   dort konfigurierten Indexer.

 Der Ablauf ändert weder Serien- noch Staffel-Monitoring und erlaubt weder
-beliebige Commands noch direkte URL-/Release-Downloads. Tickets gelten zehn
-Minuten, sind einmalig und an genau die angezeigte Auswahl gebunden.
+beliebige Commands noch direkte URL-Downloads. Tickets gelten zehn Minuten,
+sind einmalig und an genau die angezeigte Auswahl gebunden.
+
+### Sonarr: ein konkretes Release oder Staffelpaket laden
+
+Eine automatische Episodensuche ist **kein Ersatz** für die Auswahl eines
+bestimmten Releases. Wenn ein Benutzer etwa ausdrücklich ein FuN-Staffelpaket
+verlangt, gilt stattdessen dieser Ablauf:
+
+1. `search_releases` sucht ausschließlich über Sonarrs konfigurierte Indexer.
+2. `preview_release_grab` bekommt Serien-ID, Staffel und die **exakte GUID** des
+   ausgewählten Suchergebnisses. Sonarr wird erneut abgefragt; Titel, Größe,
+   Indexer, Ablehnungsgründe und vorhandene Episodendateien werden angezeigt.
+3. Erst nach ausdrücklicher Freigabe darf `grab_release` mit demselben Umfang,
+   `confirm=true` und dem kurzlebigen Ticket aufgerufen werden. Es übergibt
+   exakt dieses Release an Sonarrs konfigurierten Download-Client.
+
+Hat Sonarr das Release abgelehnt oder `downloadAllowed=false` gemeldet, muss
+bereits die Vorschau nach gesonderter Zustimmung `force=true` enthalten. Das
+Ticket ist auch daran gebunden. Der MCP löscht keine vorhandenen Dateien und
+verspricht keine Überschreibung: Ob eine vorhandene Episode nach dem Download
+ersetzt wird, entscheiden Sonarrs Qualitätsprofil-, Upgrade- und Importregeln.