Merge pull request 'Allow serienen/videoen categories in movetdarr' (#5) from fix/movetdarr-en-categories-20260916 into main

Die Kategorie-Whitelist kannte nur serien4k|serien|video4k|video. Die
englischen Arr-Instanzen sonarrEN (Port 8991, Root /data/FHD/serienen) und
radarrEN (Port 7880, Root /data/FHD/videoen) nutzen aber serienen/videoen.

Folge: Downloads dieser Kategorien wurden mit "nicht unterstuetzte Kategorie"
abgewiesen und blieben in /usenet/complete liegen, ohne je in den
FileFlows/Arr-Flow zu gelangen. Gefunden: Mutiny.2026 x2 (08./09.09.2026,
zusammen ~21 GB), beide Filme in radarrEN weiter monitored/hasFile=false.

/tdarr/complete/{serienen,videoen} existieren bereits; die FileFlows-Library
scannt /tdarr/complete rekursiv, es braucht also nur die Whitelist.

2 neue Testfaelle (serienen + videoen), test_movetdarr.py und
test_movetdarr_parallel.py gruen.

usenet-scripts/movetdarr.sh

@@ -1,7 +1,9 @@
 #!/bin/bash
-# movetdarr.sh v3 — SABnzbd -> FileFlows with durable n8n handoff lease
+# movetdarr.sh v5 — SABnzbd -> FileFlows with durable n8n handoff lease
 # Categories: serien4k->Sonarr UHD, serien->Sonarr FHD,
 #             video4k->Radarr UHD, video->Radarr FHD.
+# v5: BusyBox-kompatibler FD-Lock auf lokalem /config-Dateisystem.
+#     Der alte Lock unter /usenet lag auf NFS und konnte dauerhaft fehlschlagen.
 
 DIR="$1"
 NZB_NAME="$2"
@@ -15,6 +17,7 @@ SOURCE_ROOT="${SOURCE_ROOT:-/usenet/complete}"
 DEST_ROOT="${DEST_ROOT:-/tdarr/complete}"
 POLL_SECONDS="${POLL_SECONDS:-60}"
 MAX_POLLS="${MAX_POLLS:-1440}"  # 24 hours
+LEASE_LOCK="${LEASE_LOCK:-/config/.movetdarr.lease.lock}"
 
 log() { echo "$(date '+%d.%m.%Y %H:%M:%S'): $1" >> "$LOGFILE"; }
 
@@ -39,7 +42,7 @@ notify_failure() {
     handoff "$payload" >/dev/null 2>&1 || true
 }
 
-log "Start v3 - Kategorie=$CATEGORY Status=$STATUS Dir=$DIR"
+log "Start v5 - Kategorie=$CATEGORY Status=$STATUS Dir=$DIR"
 
 if [ "$STATUS" != "0" ]; then
     log "Download fehlgeschlagen, ueberspringe"
@@ -47,7 +50,7 @@ if [ "$STATUS" != "0" ]; then
 fi
 
 case "$CATEGORY" in
-    serien4k|serien|video4k|video) ;;
+    serien4k|serien|serienen|video4k|video|videoen) ;;
     *)
         log "FEHLER: nicht unterstuetzte Kategorie '$CATEGORY' - Quelle bleibt unangetastet"
         exit 1
@@ -68,30 +71,39 @@ if [ ! -d "$DIR" ]; then
     exit 1
 fi
 
-# Lease registrieren, solange der SAB-Job und sein Quellpfad noch sichtbar sind.
+EXPECTED_FILES="$(find "$DIR" -type f \( -iname '*.mkv' -o -iname '*.mp4' -o -iname '*.avi' \) | wc -l | tr -d ' ')"
-START_PAYLOAD="$(json_payload action start category "$CATEGORY" directory "$DIR" release "$NZB_NAME" cleanName "$CLEAN_NAME")"
+if [ -z "$EXPECTED_FILES" ] || [ "$EXPECTED_FILES" -lt 1 ] || [ "$EXPECTED_FILES" -gt 100 ]; then
-START_RESPONSE="$(handoff "$START_PAYLOAD" 2>>"$LOGFILE")" || {
+    log "FEHLER: ungueltige Anzahl Videodateien: ${EXPECTED_FILES:-0} - kein Move"
-    log "FEHLER: n8n-Handoff konnte nicht registriert werden - kein Move"
-    exit 1
-}
-JOB_ID="$(printf '%s' "$START_RESPONSE" | json_field jobId 2>>"$LOGFILE")"
-START_OK="$(printf '%s' "$START_RESPONSE" | json_field ok 2>>"$LOGFILE")"
-if [ "$START_OK" != "True" ] && [ "$START_OK" != "true" ] || [ -z "$JOB_ID" ]; then
-    log "FEHLER: ungueltige Handoff-Antwort - kein Move"
     exit 1
 fi
-log "Handoff registriert: Job=$JOB_ID"
 
-DEST="${DEST_ROOT}/${CATEGORY}"
+# Lease registrieren und Move+Bestaetigung unter exclusivem Lock, damit parallele
-BASENAME="$(basename "$DIR")"
+# SAB-Auftraege sich nicht gegenseitig den n8n-staticData-Job zerstoeren (v4).
-TARGET="$DEST/$BASENAME"
+register_lease() {
-mkdir -p "$DEST" || {
+    START_PAYLOAD="$(json_payload action start category "$CATEGORY" directory "$DIR" release "$NZB_NAME" cleanName "$CLEAN_NAME" expectedFiles "$EXPECTED_FILES")"
+    START_RESPONSE="$(handoff "$START_PAYLOAD" 2>>"$LOGFILE")" || {
+        log "FEHLER: n8n-Handoff konnte nicht registriert werden - kein Move"
+        exit 1
+    }
+    JOB_ID="$(printf '%s' "$START_RESPONSE" | json_field jobId 2>>"$LOGFILE")"
+    START_OK="$(printf '%s' "$START_RESPONSE" | json_field ok 2>>"$LOGFILE")"
+    if [ "$START_OK" != "True" ] && [ "$START_OK" != "true" ] || [ -z "$JOB_ID" ]; then
+        log "FEHLER: ungueltige Handoff-Antwort - kein Move"
+        exit 1
+    fi
+    log "Handoff registriert: Job=$JOB_ID"
+    export JOB_ID
+
+    DEST="${DEST_ROOT:?DEST_ROOT muss gesetzt sein}/${CATEGORY}"
+    BASENAME="$(basename "$DIR")"
+    TARGET="$DEST/$BASENAME"
+    mkdir -p "$DEST" || {
         log "FEHLER: Zielbasis konnte nicht erstellt werden: $DEST"
         notify_failure "mkdir_failed"
         exit 1
-}
+    }
 
-if [ -d "$TARGET" ]; then
+    if [ -d "$TARGET" ]; then
         if find "$TARGET" -maxdepth 1 -type f \( -iname '*.mkv' -o -iname '*.mp4' -o -iname '*.avi' \) -print -quit | grep -q .; then
             log "WARNUNG: Ziel $TARGET enthaelt bereits Video-Dateien - kein Ueberschreiben"
             notify_failure "target_contains_video"
@@ -103,18 +115,18 @@ if [ -d "$TARGET" ]; then
             notify_failure "stale_target_remove_failed"
             exit 1
         }
-fi
+    fi
 
-if ! mv -- "$DIR" "$DEST/"; then
+    if ! mv -- "$DIR" "$DEST/"; then
         log "FEHLER beim Verschieben nach $TARGET (Quelle bleibt: $DIR)"
         notify_failure "move_failed"
         exit 1
-fi
+    fi
-log "Erfolgreich verschoben nach $TARGET; SAB-Job bleibt bis Arr-Import aktiv"
+    log "Erfolgreich verschoben nach $TARGET; SAB-Job bleibt bis Arr-Import aktiv"
 
-MOVED_PAYLOAD="$(json_payload action moved jobId "$JOB_ID")"
+    MOVED_PAYLOAD="$(json_payload action moved jobId "$JOB_ID")"
-MOVED_OK=false
+    MOVED_OK=false
-for attempt in 1 2 3 4 5; do
+    for attempt in 1 2 3 4 5; do
         if MOVED_RESPONSE="$(handoff "$MOVED_PAYLOAD" 2>>"$LOGFILE")"; then
             MOVED_STATE="$(printf '%s' "$MOVED_RESPONSE" | json_field state 2>>"$LOGFILE")"
             if [ "$MOVED_STATE" = "processing" ] || [ "$MOVED_STATE" = "success" ]; then
@@ -124,13 +136,44 @@ for attempt in 1 2 3 4 5; do
         fi
         log "Handoff-Move-Bestaetigung Versuch $attempt/5 fehlgeschlagen"
         sleep 15
-done
+    done
-if [ "$MOVED_OK" != "true" ]; then
+    if [ "$MOVED_OK" != "true" ]; then
         log "FEHLER: Move konnte n8n nicht bestaetigt werden; Datei bleibt fuer Recovery in $TARGET"
         notify_failure "move_confirmation_failed"
         exit 1
+    fi
+}
+
+if command -v flock >/dev/null 2>&1; then
+    # BusyBox flock hat kein -w: FD öffnen und -n mit Retry-Loop verwenden.
+    # Der FD bleibt bis nach start -> mv -> moved offen und wird vor dem
+    # lang laufenden Status-Polling ausdrücklich entsperrt.
+    exec 9>"$LEASE_LOCK" || {
+        log "FEHLER: Lease-Lock-Datei konnte nicht geoeffnet werden - kein Move"
+        exit 1
+    }
+    LEASE_ACQUIRED=false
+    for i in $(seq 1 900); do
+        if flock -n 9 2>/dev/null; then
+            LEASE_ACQUIRED=true
+            break
+        fi
+        sleep 1
+    done
+    if [ "$LEASE_ACQUIRED" != "true" ]; then
+        log "FEHLER: Lease-Lock nach 15 Minuten nicht erhalten - kein Move"
+        exec 9>&-
+        exit 1
+    fi
+    register_lease
+    flock -u 9
+    exec 9>&-
+else
+    log "FEHLER: flock fehlt - kein sicherer Handoff und kein Move"
+    exit 1
 fi
 
+# Ab hier: Status-Polling ohne Lock (lang laufend, stoert keine andere Registrierung).
 STATUS_PAYLOAD="$(json_payload action status jobId "$JOB_ID")"
 for poll in $(seq 1 "$MAX_POLLS"); do
     if RESPONSE="$(handoff "$STATUS_PAYLOAD" 2>>"$LOGFILE")"; then

usenet-scripts/test_movetdarr.py

@@ -52,6 +52,7 @@ def run_case(root, category="serien4k", status="0", name="Show.S01E01", target_v
         "DEST_ROOT": str(dst_root),
         "LOGFILE": str(root / "postprocess.log"),
         "HANDOFF_URL": f"http://127.0.0.1:{server.server_port}/media/handoff",
+        "LEASE_LOCK": str(root / "lease.lock"),
         "POLL_SECONDS": "0",
         "MAX_POLLS": "3",
     }
@@ -76,6 +77,7 @@ try:
         assert result.returncode == 0, (result.stdout, result.stderr)
         assert not source.exists() and (target / "episode.mkv").exists()
         assert [a["action"] for a in actions] == ["start", "moved", "status", "status"]
+        assert actions[0]["expectedFiles"] == "1"
 
     with tempfile.TemporaryDirectory() as td:
         actions.clear()
@@ -101,7 +103,22 @@ try:
         assert result.returncode == 0 and not source.exists()
         assert not (target / "leftover.nfo").exists() and (target / "episode.mkv").exists()
 
-    print("PASS: success lease, category fail-closed, no-overwrite, stale-directory cleanup")
+    # 16.09.2026: serienen/videoen (englische Arr-Instanzen sonarrEN:8991 /
+    # radarrEN:7880 mit Root-Foldern /data/FHD/serienen bzw. /data/FHD/videoen)
+    # fehlten in der Kategorie-Whitelist. Folge: Mutiny.2026 x2 blieben am
+    # 08./09.09.2026 mit "nicht unterstuetzte Kategorie 'videoen'" in
+    # /usenet/complete liegen und wurden nie importiert.
+    for extra_category in ("serienen", "videoen"):
+        with tempfile.TemporaryDirectory() as td:
+            actions.clear()
+            status_polls = 0
+            result, source, target = run_case(Path(td), category=extra_category)
+            assert result.returncode == 0, (extra_category, result.stdout, result.stderr)
+            assert not source.exists(), extra_category
+            assert (target / "episode.mkv").exists(), extra_category
+            assert [a["action"] for a in actions] == ["start", "moved", "status", "status"], extra_category
+
+    print("PASS: success lease, category fail-closed, no-overwrite, stale-directory cleanup, EN-Kategorien")
 finally:
     server.shutdown()
     server.server_close()

usenet-scripts/test_movetdarr_parallel.py

@@ -0,0 +1,110 @@
+import json
+import os
+import subprocess
+import tempfile
+import threading
+import time
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+from pathlib import Path
+
+
+SCRIPT = Path(__file__).with_name("movetdarr.sh")
+state_lock = threading.Lock()
+next_job = 0
+open_leases = 0
+max_open_leases = 0
+job_ids = {}
+
+
+class Handler(BaseHTTPRequestHandler):
+    def do_POST(self):
+        global next_job, open_leases, max_open_leases
+        data = json.loads(self.rfile.read(int(self.headers.get("Content-Length", "0"))))
+        action = data.get("action")
+        if action == "start":
+            with state_lock:
+                next_job += 1
+                job_id = f"job-{next_job}"
+                job_ids[data["directory"]] = job_id
+                open_leases += 1
+                max_open_leases = max(max_open_leases, open_leases)
+            time.sleep(0.3)
+            result = {"ok": True, "jobId": job_id, "state": "registered"}
+        elif action == "moved":
+            with state_lock:
+                open_leases -= 1
+            result = {"ok": True, "jobId": data["jobId"], "state": "processing"}
+        elif action == "status":
+            result = {"ok": True, "jobId": data["jobId"], "state": "success"}
+        else:
+            result = {"ok": False, "state": "failed"}
+        body = json.dumps(result).encode()
+        self.send_response(200)
+        self.send_header("Content-Type", "application/json")
+        self.send_header("Content-Length", str(len(body)))
+        self.end_headers()
+        self.wfile.write(body)
+
+    def log_message(self, *_args):
+        pass
+
+
+def start_script(root, name, server_port):
+    source_root = root / "source"
+    source = source_root / "serien" / name
+    source.mkdir(parents=True)
+    (source / f"{name}.mkv").write_bytes(b"video")
+    env = os.environ | {
+        "SOURCE_ROOT": str(source_root),
+        "DEST_ROOT": str(root / "dest"),
+        "LOGFILE": str(root / "postprocess.log"),
+        "LEASE_LOCK": str(root / "lease.lock"),
+        "HANDOFF_URL": f"http://127.0.0.1:{server_port}/media/handoff",
+        "POLL_SECONDS": "0",
+        "MAX_POLLS": "2",
+    }
+    return subprocess.Popen(
+        ["bash", str(SCRIPT), str(source), name + ".nzb", name, "", "serien", "", "0"],
+        env=env,
+        text=True,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+    )
+
+
+def test_parallel_lease_blocks_are_serialized():
+    global next_job, open_leases, max_open_leases, job_ids
+    next_job = 0
+    open_leases = 0
+    max_open_leases = 0
+    job_ids = {}
+    server = ThreadingHTTPServer(("127.0.0.1", 0), Handler)
+    thread = threading.Thread(target=server.serve_forever, daemon=True)
+    thread.start()
+    try:
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            first = start_script(root, "Show.S01E01", server.server_port)
+            second = start_script(root, "Show.S01E02", server.server_port)
+            first_result = first.communicate(timeout=20)
+            second_result = second.communicate(timeout=20)
+            assert first.returncode == 0, first_result
+            assert second.returncode == 0, second_result
+            assert len(set(job_ids.values())) == 2
+            assert max_open_leases == 1, "start→move→moved blocks overlapped"
+    finally:
+        server.shutdown()
+        server.server_close()
+
+
+def test_lock_is_held_on_a_file_descriptor_until_register_returns():
+    source = SCRIPT.read_text()
+    assert 'exec 9>"$LEASE_LOCK"' in source
+    assert 'flock -n 9' in source
+    assert 'flock -u 9' in source
+
+
+if __name__ == "__main__":
+    test_lock_is_held_on_a_file_descriptor_until_register_returns()
+    test_parallel_lease_blocks_are_serialized()
+    print("PASS: parallel start→move→moved blocks are serialized")