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
2026-05-19 20:00:10 -04:00
parent 5cb16d4b18
commit e13f2fa14f
81 changed files with 12164 additions and 10656 deletions
@@ -2,45 +2,70 @@
 # ==============================================================================================
 # ============================= User Scripts Stop ==============================================
 # ==============================================================================================
-# Stops all running User Script processes spawned by the unRAID User Scripts plugin.
-# Identifies processes by their /tmp/user.scripts path signature.
-# Shows script names not just PIDs — you know what's being stopped.
 #
-# ── WHEN TO USE ───────────────────────────────────────────────────────────────────────────────
-#   - Before a planned reboot when scripts are running mid-cycle
-#   - When a script is stuck and won't respond to the Abort button in the UI
-#   - Called automatically by server_reboot.sh as part of shutdown sequence
-#   - Emergency stop of all background ecosystem scripts
+# PURPOSE
+# ─────────────────────────────────────────────────────────────────────────────
+# Stops all running User Script processes spawned by the unRAID User Scripts
+# plugin. Shows script names not just PIDs so you know what's being stopped.
+# Called automatically by server_reboot.sh as part of the shutdown sequence,
+# and useful directly when a script is stuck and won't respond to the UI.
 #
-# ── HOW IT IDENTIFIES PROCESSES ───────────────────────────────────────────────────────────────
-# Scans /proc/*/cmdline for processes whose command line contains "/tmp/user.scripts".
-# The unRAID User Scripts plugin stages all scripts in /tmp/user.scripts/ before execution.
-# This is more reliable than process name matching which can vary.
+# ==============================================================================================
+# OPERATIONAL MODEL
+# ==============================================================================================
 #
-# ── STOP SEQUENCE PER PROCESS ─────────────────────────────────────────────────────────────────
-#   1. Send SIGTERM — allows script to trap and clean up gracefully
+# Process Identification
+#   Scans /proc/*/cmdline for processes whose command line contains
+#   "/tmp/user.scripts". The User Scripts plugin stages all scripts in
+#   /tmp/user.scripts/ before execution — more reliable than process name
+#   matching which can vary.
+#
+# Stop Sequence Per Process
+#   1. Send SIGTERM — allows the script to trap and clean up gracefully
 #   2. Wait 5 seconds
-#   3. Check if still running → SIGKILL (force) if SIGTERM ignored
-#   4. Verify dead after SIGKILL
+#   3. If still running → SIGKILL (force)
+#   4. Verify dead after SIGKILL — error if still running
 #
-# ── SELF-EXCLUSION ────────────────────────────────────────────────────────────────────────────
-# If this script itself is run via the User Scripts plugin it would find its own PID.
-# Self-exclusion prevents this script from killing itself mid-execution.
+# Self-Exclusion
+#   If this script is run via the User Scripts plugin it would find its own
+#   PID in the scan. Self-exclusion by PID prevents killing its own process
+#   tree mid-execution.
 #
-# ── SAFEGUARDS ────────────────────────────────────────────────────────────────────────────────
-#   Root check           — kill requires root for other users' processes
-#   acquire_lock         — prevents concurrent stop attempts
-#   Self-exclusion       — never kills its own process tree
-#   SIGTERM → SIGKILL    — graceful then forced
-#   Verify after kill    — confirms processes are actually dead
-#   validate_unraid_cmd  — notify validated before use
-#   Silent when clean    — no processes running = log() only ✅
+# ==============================================================================================
+# OPERATIONAL SAFEGUARDS
+# ==============================================================================================
+#
+# Root Required
+#   kill requires root for other users' processes.
+#
+# Single Instance Lock
+#   acquire_lock prevents concurrent stop attempts.
+#
+# SIGTERM → SIGKILL Sequence
+#   Graceful first. Forced only if SIGTERM ignored after 5 seconds.
+#
+# Post-Kill Verify
+#   Confirms each process is actually dead. Errors and notifies if unkillable.
+#
+# Silent When Clean
+#   No processes running = log() only, no visible output.
+#
+# ==============================================================================================
+# RUNTIME MODES
+# ==============================================================================================
+#
+# user_scripts_stop.sh
+#     Find and stop all User Script processes. Silent if none running.
+#
+# user_scripts_stop.sh --dry-run
+#     Show which processes would be stopped, with names and runtimes. No kills.
+#
+# user_scripts_stop.sh --status
+#     Show currently running User Script processes with names and elapsed time.
+#
+# user_scripts_stop.sh --log
+#     Verbose output — show each process found, each signal sent, each result.
 #
-# ── USAGE ─────────────────────────────────────────────────────────────────────────────────────
-#   user_scripts_stop.sh              — stop all user scripts
-#   user_scripts_stop.sh --dry-run    — show what would be stopped
-#   user_scripts_stop.sh --status     — show currently running user scripts
-#   user_scripts_stop.sh --log        — verbose output
 # ==============================================================================================

 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"