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

unRAID_Essentials/clear_logs.sh

@@ -2,51 +2,81 @@
 # ==============================================================================================
 # ================================= Clear Logs =================================================
 # ==============================================================================================
+#
+# PURPOSE
+# ─────────────────────────────────────────────────────────────────────────────
 # Clears system and Docker container logs to prevent rootfs fill over time.
-# Runs weekly via WEEKLY_MAINTENANCE_SCRIPTS — Sunday 2:30am.
-# Uses size thresholds — only clears logs that have grown large enough to matter.
+# Called weekly via WEEKLY_MAINTENANCE_SCRIPTS. Uses size thresholds — only
+# clears logs large enough to be worth clearing. Small logs are left intact,
+# preserving recent diagnostic context.
 #
-# ── WHAT IT CLEARS ────────────────────────────────────────────────────────────────────────────
-#   System logs  — LOG_FILES from master.conf (/var/log/syslog, messages, dmesg)
-#                  Cleared if size exceeds LOG_MIN_SIZE_MB
-#                  These grow continuously — weekly clearing keeps rootfs healthy
+# System logs (LOG_FILES): cleared if size exceeds LOG_MIN_SIZE_MB.
+# Docker logs (/var/lib/docker/containers/**/*-json.log): cleared only if the
+# individual container log exceeds LOG_DOCKER_MAX_MB. Active containers (Emby,
+# SABnzbd) grow fastest — inactive containers typically remain small.
 #
-#   Docker logs  — /var/lib/docker/containers/**/*-json.log
-#                  Cleared only if individual container log exceeds LOG_DOCKER_MAX_MB
-#                  Active containers (Emby, SABnzbd) grow fastest — 100MB+ easily
-#                  Inactive containers not cleared — their logs are typically small
+# ==============================================================================================
+# DESIGN PRINCIPLES
+# ==============================================================================================
 #
-# ── SIZE THRESHOLD APPROACH ───────────────────────────────────────────────────────────────────
-# Truncating everything blindly destroys useful diagnostic context.
-# A 2MB log is not worth clearing — it contains useful recent history.
-# A 500MB log is consuming rootfs and contains mostly noise — clear it.
+# Size Thresholds, Not Blind Truncation
+#   A 2MB syslog contains useful recent diagnostic history — not worth clearing.
+#   A 500MB Docker log is consuming rootfs and contains mostly noise — clear it.
+#   Blind truncation destroys diagnostic context for no benefit.
 #
-# LOG_MIN_SIZE_MB     — system logs under this size are left alone
-# LOG_DOCKER_MAX_MB   — Docker logs under this size are left alone
+# Truncation, Not Logrotate
+#   unRAID writes logs to tmpfs (/var/log). Logrotate's compress + archive approach
+#   would consume more tmpfs space, not less. Truncation (`: > file`) keeps the
+#   file descriptor open and valid while emptying content — syslogd continues
+#   writing to the same fd without interruption.
 #
-# ── WHY NOT LOGROTATE ─────────────────────────────────────────────────────────────────────────
-# unRAID writes to tmpfs (/var/log) — logrotate's compress + archive approach
-# would consume even more tmpfs space. Truncation (: > file) keeps the file
-# descriptor open and valid while emptying content — safe for running services.
+# ==============================================================================================
+# OPERATIONAL SAFEGUARDS
+# ==============================================================================================
 #
-# ── SAFEGUARDS ────────────────────────────────────────────────────────────────────────────────
-#   acquire_lock     — prevents concurrent runs corrupting logs
-#   Root check       — truncating system logs requires root
-#   Size thresholds  — only clears logs that have grown large enough
-#   Byte tracking    — reports MB freed for weekly digest
-#   validate_unraid  — notify validated before use
-#   Silent on clean  — small logs = nothing to clear = no output ✅
+# Single Instance Lock
+#   acquire_lock prevents concurrent runs from corrupting logs.
 #
-# ── CONFIGURATION (master.conf) ───────────────────────────────────────────────────────────────
-#   LOG_FILES          — system log paths to check and clear
-#   LOG_MIN_SIZE_MB    — minimum system log size before clearing (default 10MB)
-#   LOG_DOCKER_MAX_MB  — clear Docker log only if above this size (default 100MB)
+# Root Required
+#   Truncating system logs requires root.
+#
+# Size Thresholds
+#   Each file checked against its threshold before clearing.
+#
+# Silent When Clean
+#   All logs below threshold = no visible output.
+#
+# ==============================================================================================
+# CONFIGURATION
+# ==============================================================================================
+#
+# master.conf
+#
+#   LOG_FILES
+#       System log paths to check and clear. (default: /var/log/syslog /var/log/messages /var/log/dmesg)
+#
+#   LOG_MIN_SIZE_MB
+#       Skip system log if under this size — keep recent history. (default: 10)
+#
+#   LOG_DOCKER_MAX_MB
+#       Clear Docker container log only if over this size. (default: 100)
+#
+# ==============================================================================================
+# RUNTIME MODES
+# ==============================================================================================
+#
+# clear_logs.sh
+#     Check all configured logs. Clear those above threshold. Silent when all are small.
+#
+# clear_logs.sh --dry-run
+#     Show which logs would be cleared and their current sizes. No clearing.
+#
+# clear_logs.sh --status
+#     Show current log sizes vs thresholds.
+#
+# clear_logs.sh --log
+#     Verbose output — show each file evaluated, its size, and action taken.
 #
-# ── USAGE ─────────────────────────────────────────────────────────────────────────────────────
-#   clear_logs.sh              — normal run (threshold-based clearing)
-#   clear_logs.sh --dry-run    — show what would be cleared and sizes
-#   clear_logs.sh --status     — show current log sizes
-#   clear_logs.sh --log        — verbose output per file
 # ==============================================================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"