feat: slskd reconnect guard in downloaders_reset, mass v2 sync

- downloaders_reset: connection check block before slskd API sections;
  triggers PUT /api/v0/server reconnect if disconnected, polls 60s,
  gates Stuck Searches and Dead Transfer Records on SLSKD_CONNECTED
- Sync all modified/new/deleted files from v2 refactor across Docker_Essentials,
  Media, Monitors, Partnership, Rsync, Tools, Transcodes, unRAID_Essentials,
  common.sh, master confs, and new Manual/README docs

Tools/emby_database_repair.sh

@@ -2,43 +2,81 @@
 # ==============================================================================================
 # ============================= Emby Database Repair ===========================================
 # ==============================================================================================
-# Stops Emby, runs SQLite integrity checks on all Emby databases, and restarts.
-# Use when Emby reports database corruption, unexpected crashes, or playback state issues.
 #
-# ── CHECKS PERFORMED ──────────────────────────────────────────────────────────────────────────
-#   PRAGMA integrity_check — full SQLite integrity verification per database
-#   Skips missing databases gracefully — not all files exist on all setups
+# PURPOSE
+# ─────────────────────────────────────────────────────────────────────────────
+# Stops Emby, runs SQLite PRAGMA integrity_check on all Emby databases, and
+# restarts. Use when Emby reports corruption, unexpected crashes, or playback
+# state issues.
 #
-# ── DATABASES CHECKED ─────────────────────────────────────────────────────────────────────────
+# Reports which databases are corrupted. Does NOT automatically repair.
+# Repair requires manual steps — guidance is printed in the summary output.
+# Always take a backup before deleting any database file.
+#
+# ==============================================================================================
+# OPERATIONAL MODEL
+# ==============================================================================================
+#
+# Databases Checked
 #   library.db        — media library metadata (largest, most critical)
-#   library.db-wal    — write-ahead log (if exists — uncommitted transactions)
+#   library.db-wal    — write-ahead log (if present — uncommitted transactions)
 #   librarydb.db      — legacy library database
 #   users.db          — user accounts and settings
 #   authentication.db — API keys and sessions
-#   activity.db       — activity log (least critical, safe to delete)
+#   activity.db       — activity log (least critical, safe to delete if corrupt)
 #
-# ── IF CORRUPTION FOUND ───────────────────────────────────────────────────────────────────────
-# Reports which databases are corrupted. Does NOT automatically repair.
-# Corruption repair requires manual steps — see guidance in summary output.
-# Always take a backup before deleting any database file.
+# Missing databases are skipped gracefully — not all files exist on all setups.
+# Emby's config path is detected from the Docker mount — no hardcoded paths.
 #
-# ── HOST AWARENESS ────────────────────────────────────────────────────────────────────────────
-# detect_hosts() sets MY_ID and aliases HOST*_EMBY_CONTAINER → EMBY_CONTAINER.
-# Each server checks its own Emby instance automatically.
+# ==============================================================================================
+# OPERATIONAL SAFEGUARDS
+# ==============================================================================================
 #
-# ── SAFEGUARDS ────────────────────────────────────────────────────────────────────────────────
-#   EXIT trap            — Emby always restarted even if script crashes mid-check
-#   DOCKER_TIMEOUT       — all docker calls protected against hung daemon
-#   jq validation        — verifies jq available before config path detection
-#   validate_unraid_cmd  — sqlite3 and notify validated before use
-#   Container verify     — checks Emby stayed running after restart
-#   Silent healthy       — only corruption produces visible output
+# Guaranteed Restart
+#   EXIT trap ensures Emby is always restarted even if the script crashes
+#   mid-check — Emby is never left stopped due to a script error.
+#
+# Docker Timeout
+#   DOCKER_TIMEOUT (30s) protects all docker calls against a hung daemon.
+#   Emby can take time to stop cleanly — 30s is intentionally generous.
+#
+# Tool Validation
+#   validate_unraid_cmd confirms sqlite3 and the notify script are present
+#   before use. jq is checked separately — required for config path detection.
+#
+# Post-Restart Verify
+#   Checks that Emby is still running after restart — detects cases where
+#   Emby crashes immediately after start (which would indicate deeper trouble).
+#
+# Silent When Healthy
+#   Only corruption produces visible output and a notification.
+#
+# ==============================================================================================
+# CONFIGURATION
+# ==============================================================================================
+#
+# master_host*.conf
+#
+#   HOST*_EMBY_CONTAINER
+#       Name of the Emby Docker container on this host.
+#       Aliased by detect_hosts() → EMBY_CONTAINER.
+#
+# ==============================================================================================
+# RUNTIME MODES
+# ==============================================================================================
+#
+# emby_database_repair.sh
+#     Stop Emby, check all databases with PRAGMA integrity_check, restart.
+#
+# emby_database_repair.sh --dry-run
+#     Show which databases would be checked and Emby container name. No stop.
+#
+# emby_database_repair.sh --log
+#     Verbose output with per-database check result.
+#
+# emby_database_repair.sh --status
+#     Show Emby container name and config path detected from Docker. Then exit.
 #
-# ── USAGE ─────────────────────────────────────────────────────────────────────────────────────
-#   emby_database_repair.sh              — stop Emby, check all databases, restart
-#   emby_database_repair.sh --dry-run    — show what would be checked, no Emby stop
-#   emby_database_repair.sh --log        — verbose output per database
-#   emby_database_repair.sh --status     — show config and exit
 # ==============================================================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"