feat(library): exclude configured folders from scanning and analysis

services/recommender/tests/test_db_integration.py

@@ -122,6 +122,37 @@ def test_analysis_worker_saves_features(world: dict[str, Any]) -> None:
         assert row is not None and row[0] == pytest.approx(120.0)
 
 
+def test_analysis_worker_skips_excluded_folders_and_uses_allowed_copy(world: dict[str, Any]) -> None:
+    worker = Worker(DSN, "/library", "/library-host", 1)
+    blocked, alternative, allowed = world["tracks"][:3]
+    with psycopg.connect(DSN, autocommit=True) as conn:
+        source = conn.execute(
+            "SELECT source_id FROM media_files WHERE track_id = %s", (blocked,)
+        ).fetchone()
+        assert source is not None
+        conn.execute(
+            "UPDATE library_sources SET excluded_dirs = ARRAY['Downloads_PumpEars'] WHERE id = %s",
+            (source[0],),
+        )
+        for track, rel in [(blocked, "Downloads_PumpEars/nested/loop.wav"), (alternative, "Downloads_PumpEars/loop.wav"), (allowed, "Downloads_PumpEars-copy/song.flac")]:
+            conn.execute("UPDATE media_files SET rel_path = %s WHERE track_id = %s", (rel, track))
+        conn.execute(
+            "INSERT INTO media_files (id, source_id, rel_path, size_bytes, mtime, format, duration_ms, track_id) "
+            "VALUES (%s, %s, 'Music/allowed-copy.flac', 1, now(), 'flac', 200000, %s)",
+            (uid(), source[0], alternative),
+        )
+        conn.execute(
+            "UPDATE analysis_jobs SET status = 'queued' WHERE track_id = ANY(%s::uuid[])",
+            ([blocked, alternative, allowed],),
+        )
+        jobs = {job.track_id: job.path for job in worker.claim(conn, 10000)}
+        assert blocked not in jobs
+        assert jobs[alternative].replace("\\", "/").endswith("/Music/allowed-copy.flac")
+        assert jobs[allowed].replace("\\", "/").endswith("/Downloads_PumpEars-copy/song.flac")
+        row = conn.execute("SELECT attempts, status FROM analysis_jobs WHERE track_id = %s", (blocked,)).fetchone()
+        assert row == (0, 'queued'), "excluded files must not consume retry attempts"
+
+
 def test_training_and_wave_queries(world: dict[str, Any]) -> None:
     with psycopg.connect(DSN) as conn:
         assert len(load_interactions(conn)) >= 60