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/zfs_pool_scrub.sh

@@ -2,47 +2,80 @@
 # ==============================================================================================
 # ================================= ZFS Pool Scrub ============================================
 # ==============================================================================================
-# Triggers a ZFS scrub on all pools (or a specific pool) and waits for completion.
-# Sends a notification when scrub completes with a summary of any errors found.
 #
-# ── WHAT ZFS SCRUB DOES ───────────────────────────────────────────────────────────────────────
-# Reads every block on every pool and verifies checksums against the stored hash.
-# Catches silent data corruption that would otherwise only surface when you read the
-# corrupted data — by then it may be too late for redundancy to help.
+# PURPOSE
+# ─────────────────────────────────────────────────────────────────────────────
+# Triggers a ZFS scrub on all pools (or a specific pool), waits for completion,
+# and sends a notification with any errors found. Reads every block on every pool
+# and verifies checksums — catches silent corruption that would otherwise only
+# surface when the corrupted data is read (possibly after redundancy can no
+# longer help). Monthly recommended for all pools; quarterly minimum for large pools.
 #
-# Scrub is safe to run while the pool is in use — it does not interrupt normal I/O.
-# It does consume I/O bandwidth — run during off-peak hours or maintenance windows.
-# Monthly is recommended for all pools. Quarterly minimum for large pools.
+# ==============================================================================================
+# OPERATIONAL MODEL
+# ==============================================================================================
 #
-# ── BEHAVIOUR ─────────────────────────────────────────────────────────────────────────────────
-# Starts scrub on each pool then polls every 60 seconds until all complete.
-# Progress shown via warn() every poll (visible) when scrub is running.
-# Safe to leave running or interrupt — scrub continues even if script is stopped.
-# On completion reports errors per pool and notifies if any found.
+# Starts a scrub on each pool, then polls every 60 seconds until all complete.
+# Progress is shown every poll — safe to leave running or interrupt. ZFS scrub
+# continues in the kernel even if the script is stopped — it does not depend on
+# this script remaining alive.
 #
-# ── HOST AWARENESS ────────────────────────────────────────────────────────────────────────────
-# detect_hosts() sets MY_ID and aliases HOST*_ZFS_REPORT_IGNORE_POOLS → ZFS_REPORT_IGNORE_POOLS.
-# Pools in ZFS_REPORT_IGNORE_POOLS are skipped (single-disk VMs, temp pools etc.)
-# unless specified explicitly as a positional argument.
+# Scrub is safe to run while the pool is in use. It does consume I/O bandwidth —
+# schedule during off-peak hours or maintenance windows.
 #
-# ── SAFEGUARDS ────────────────────────────────────────────────────────────────────────────────
-#   acquire_lock            — prevents concurrent scrub starts on same server
-#   detect_hosts()          — correct pool ignore list per host
-#   validate_unraid_cmd     — zpool and notify validated before use
-#   Scrub-in-progress check — skips pools already scrubbing rather than erroring
-#   SIGTERM trap            — poll loop exits cleanly on signal
-#   Silent when clean       — only errors produce visible output and notification
+# Pools in HOST*_ZFS_REPORT_IGNORE_POOLS are skipped automatically (single-disk
+# VM pools, temp pools, etc.). Specifying a pool by name bypasses the ignore list.
 #
-# ── CONFIGURATION (master_host*.conf) ─────────────────────────────────────────────────────────
-#   HOST*_ZFS_REPORT_IGNORE_POOLS — pools excluded from automatic scrub
-#   Aliased by detect_hosts() — script uses ZFS_REPORT_IGNORE_POOLS
+# ==============================================================================================
+# OPERATIONAL SAFEGUARDS
+# ==============================================================================================
+#
+# Single Instance Lock
+#   acquire_lock prevents concurrent scrub starts on the same server.
+#
+# Scrub-in-Progress Check
+#   Detects pools already scrubbing and skips them rather than erroring — safe
+#   to run when a scrub may have been started by another path.
+#
+# SIGTERM Trap
+#   The poll loop exits cleanly on signal. The ZFS scrub continues regardless.
+#
+# Tool Validation
+#   validate_unraid_cmd confirms zpool and the notify script are present before use.
+#
+# Silent When Clean
+#   Only errors produce visible output and a notification.
+#
+# ==============================================================================================
+# CONFIGURATION
+# ==============================================================================================
+#
+# master_host*.conf
+#
+#   HOST*_ZFS_REPORT_IGNORE_POOLS
+#       Pools to exclude from automatic scrub. Typically single-disk VM pools
+#       or temporary pools that do not need integrity checking.
+#       Aliased by detect_hosts() → ZFS_REPORT_IGNORE_POOLS.
+#
+# ==============================================================================================
+# RUNTIME MODES
+# ==============================================================================================
+#
+# zfs_pool_scrub.sh
+#     Scrub all pools not in ZFS_REPORT_IGNORE_POOLS. Wait for completion.
+#
+# zfs_pool_scrub.sh poolname
+#     Scrub a specific pool by name. Bypasses the ignore list.
+#
+# zfs_pool_scrub.sh --status
+#     Show current scrub status for all pools and exit.
+#
+# zfs_pool_scrub.sh --dry-run
+#     Show which pools would be scrubbed. No scrub started.
+#
+# zfs_pool_scrub.sh --log
+#     Verbose progress output every poll cycle.
 #
-# ── USAGE ─────────────────────────────────────────────────────────────────────────────────────
-#   zfs_pool_scrub.sh              — scrub all non-ignored pools
-#   zfs_pool_scrub.sh poolname     — scrub specific pool (bypasses ignore list)
-#   zfs_pool_scrub.sh --status     — show scrub status for all pools
-#   zfs_pool_scrub.sh --dry-run    — show what would be scrubbed
-#   zfs_pool_scrub.sh --log        — verbose progress output
 # ==============================================================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"