fix: automate cross-source media library audits

docs/UNRAID_MEDIA_AUDIT_WORKFLOW.md

@@ -0,0 +1,57 @@
+# Automatische Medienbestandsprüfung auf Unraid
+
+Stand: 24. August 2026
+
+## Zweck
+
+Lokale Medienbestände können in einem Open-WebUI-Auftrag mit einer offiziellen
+Online-Liste verglichen werden, ohne dass der Benutzer Werkzeuge nachträglich
+einschaltet. Der Ablauf bleibt vollständig read-only.
+
+## Werkzeugwahl
+
+Der Auto Tool Selector 3.4 erkennt einen ausdrücklich lesenden Unraid-Auftrag
+und stellt ausschließlich `mua-readonly-local` bereit. Wörter wie „Folgen
+fehlen“ oder „Hörspielserie“ aktivieren nicht mehr fälschlich Sonarr/Radarr.
+Formulierungen wie „ohne Änderungen“, „ohne Downloads“ und „keinerlei
+Änderungen“ verhindern zuverlässig die Auswahl von MUA-Admin.
+
+Die öffentliche Recherche erfolgt anschließend mit Open WebUIs nativen
+Werkzeugen `search_web` und `fetch_url`.
+
+## Dateiinventar
+
+MUA r020 stellt `unraid_files_inventory` bereit. Das Werkzeug liest keine
+Dateiinhalte und akzeptiert ausschließlich einen vorhandenen Unraid-Share plus
+einen relativen Pfad unterhalb dieses Shares. Pfadtraversal, absolute Pfade und
+Symlink-Verfolgung sind gesperrt. Tiefe, Trefferzahl und Zahl der untersuchten
+Einträge sind begrenzt.
+
+Empfohlener Ablauf:
+
+1. `unraid_shares_list` nur dann verwenden, wenn der Share unbekannt ist.
+2. Mit `unraid_files_inventory`, `name_contains` und nur Verzeichnissen die
+   passende Sammlung lokalisieren.
+3. Den exakten zurückgegebenen `relative_path` in einem zweiten Aufruf ohne
+   Namensfilter inventarisieren.
+4. Aus Dateinamen lokale Nummern/Titel extrahieren.
+5. Offizielle Liste über native Websuche ermitteln und Differenz bilden.
+6. Fehlende Titel beim gewünschten Anbieter gezielt verifizieren.
+7. Fakten, Dateinamen-Schlussfolgerungen und Unsicherheiten getrennt ausgeben.
+
+Die generische Nur-Lese-Shell ist nur ein Fallback, wenn das Inventarwerkzeug
+die konkrete Frage nicht beantworten kann. Wiederholte `ls`/`find`-Ketten sind
+für Bibliotheksprüfungen nicht vorgesehen.
+
+## Regressionstest
+
+Der ursprüngliche Lauf zur Reihe „Die drei ???“ brauchte nach dem Share-Fund
+vier einzelne Shell-Aufrufe und verbrauchte das Werkzeugbudget vor dem
+eigentlichen Datei- und Webabgleich. Dieser Fall ist der verbindliche
+Regressionstest für Selector 3.4 und MUA r020:
+
+- automatisch nur MUA read-only;
+- höchstens zwei Inventaraufrufe für Lokalisierung und Bestand;
+- danach native Webrecherche;
+- keine Rückfrage, kein Download und keine Dateisystemänderung.
+