Docs pass: update headers and READMEs for all new scripts

Script headers (6 files):
- Add OPERATIONAL SAFEGUARDS section to all discovery + emby sync scripts
- Add STATE FILES section to all 3 discovery scripts
- Add CONFIGURATION section to emby_to_*_sync.sh
- Rename USAGE → RUNTIME MODES in emby_to_*_sync.sh (doc standard)
- Fix SONARR_DISCOVERY_MONITOR_MODE default doc: "future" → "all"

Media/README-Media.md:
- Remove "WIP prototype" label; describe all 3 discovery scripts
- Add discovery scripts to scripts table and HOW THE SCRIPTS RELATE diagram
- Add weekly discovery schedule block to EXECUTION ORDER section
- Update intro to mention behavior-driven discovery

Media/Manual-Media.md:
- Add configuration reference sections for all 3 discovery scripts
- Add flag reference sections for all 3 discovery scripts

Tools/README-Tools.md:
- Add "Library Sync Bootstrap" category and emby_to_*_sync.sh to scripts table
- Add emby sync scripts to HOW THE SCRIPTS RELATE diagram

Tools/Manual-Tools.md:
- Update emby sync notes: search commands now fire immediately after add

README.md:
- Update Media folder description to include discovery
- Update weekly schedule to show discovery scripts
- Update README table entry for Media

Media/README-Media.md

@@ -1,9 +1,11 @@
 # ━━━━━ MEDIA ━━━━━
 
-Library health, consistency, and sync for a multi-server arr stack. Correct permissions
-so arrs can manage files. Junk removal so orphan detection isn't confused by scene debris.
-Library sync so every node tracks the same content. Orphan cleanup against live arr APIs
-so deleted content actually leaves disk. Emby notified automatically after every deletion.
+Library health, consistency, sync, and behavior-driven discovery for a multi-server arr
+stack. Correct permissions so arrs can manage files. Junk removal so orphan detection
+isn't confused by scene debris. Library sync so every node tracks the same content.
+Orphan cleanup against live arr APIs so deleted content actually leaves disk. Emby
+notified automatically after every deletion. Weekly discovery adds new music, movies,
+and TV shows based on what you actually play — no manual browsing required.
 
 > **These scripts permanently delete files.** The arr cleanup scripts are protected by
 > multiple safety layers that must all pass before anything is touched — but dry runs and
@@ -89,9 +91,15 @@ free overnight recovery.
 `lidarr_missing_art.sh` — fetch missing album and artist artwork from fanart.tv and
 fallback sources. Never overwrites existing files.
 
-**Discovery (WIP)**  
-`playback_aware_lidarr_discovery.sh` — scoring prototype for behavior-driven music
-discovery. Consumes `Kernel/decision_engine.sh`. Not yet connected to a data source.
+**Discovery**  
+`playback_aware_lidarr_discovery.sh` — behavior-driven music discovery. Scores your
+Emby play history, runs Last.fm getSimilar on top artists, adds the best matches to
+Lidarr. 0–5 meaningful adds per week.  
+`playback_aware_radarr_discovery.sh` — behavior-driven movie discovery. Scores recently
+watched movies, runs TMDB recommendations on seeds, adds top candidates to Radarr.  
+`playback_aware_sonarr_discovery.sh` — behavior-driven TV discovery. Scores recently
+watched series weighted by user diversity, runs TMDB TV recommendations on seeds, adds
+top shows to Sonarr. Multi-user design: one person binge-watching does not dominate seeds.
 
 ---
 
@@ -122,6 +130,14 @@ arr_sync.sh    — arrs agree on library → rsync then spreads the files
 arrs_failed_stalled_recovery.sh
 ```
 
+**Weekly discovery (WEEKLY_MAINTENANCE_SCRIPTS in master.conf):**
+
+```
+playback_aware_lidarr_discovery.sh   — score play history → Last.fm similar → add to Lidarr
+playback_aware_radarr_discovery.sh   — score watch history → TMDB recommendations → add to Radarr
+playback_aware_sonarr_discovery.sh   — score episode history → TMDB TV recommendations → add to Sonarr
+```
+
 **Ad-hoc or separate schedule:**
 
 ```
@@ -176,7 +192,9 @@ cleanly with no action. No manual `HOST1`/`HOST2` comparisons exist in any scrip
 | `lidarr_missing_art.sh` | Fetch missing album and artist artwork | Ad-hoc or separate schedule |
 | `radarr_tmdb_removed.sh` | Remove movies dropped from TMDb | Ad-hoc or weekly |
 | `sonarr_tvdb_removed.sh` | Remove series dropped from TVDB | Ad-hoc or weekly |
-| `playback_aware_lidarr_discovery.sh` | Behavior-driven music discovery scoring (WIP prototype) | Not yet scheduled |
+| `playback_aware_lidarr_discovery.sh` | Behavior-driven music discovery — Emby plays → Last.fm similar → Lidarr | Weekly via `weekly_sync_maintenance.sh` |
+| `playback_aware_radarr_discovery.sh` | Behavior-driven movie discovery — Emby watches → TMDB recommendations → Radarr | Weekly via `weekly_sync_maintenance.sh` |
+| `playback_aware_sonarr_discovery.sh` | Behavior-driven TV discovery — Emby episodes → TMDB TV recommendations → Sonarr | Weekly via `weekly_sync_maintenance.sh` |
 
 ---
 
@@ -206,6 +224,13 @@ Daily maintenance window (media_management.sh):
 Daily recovery:
   arrs_failed_stalled_recovery.sh ── importFailed/stalled → blocklist → re-search
 
+Weekly discovery (WEEKLY_MAINTENANCE_SCRIPTS):
+  playback_aware_lidarr_discovery.sh ─ Emby plays → Last.fm similar → top candidates → Lidarr
+  playback_aware_radarr_discovery.sh ─ Emby watches → TMDB recommendations → top candidates → Radarr
+  playback_aware_sonarr_discovery.sh ─ Emby episodes → TMDB TV recommendations → top candidates → Sonarr
+        │
+        └── each discovery script fires arr search immediately after successful add
+
 Ad-hoc enrichment:
   lidarr_missing_art.sh ─────── discovers missing artwork → fetches from fanart.tv
   radarr_tmdb_removed.sh ────── status="deleted" → remove from Radarr + add exclusion