Add full banner headers to all scripts across the codebase

Every script now has the established header format: PURPOSE with ─────── separator, OPERATIONAL MODEL, DESIGN PRINCIPLES, OPERATIONAL SAFEGUARDS, CONFIGURATION, and RUNTIME MODES — structured with full ====== banner sections throughout. Orchestrators converted from compact ── inline format to full banners. Stale emby-fallback and dirty sync references removed from Plugin/user_script_plug-in.sh.
2026-06-26 18:50:05 -04:00
parent 1003bee72a
commit f92ee4064b
51 changed files with 1822 additions and 563 deletions
@@ -19,6 +19,25 @@
 # from master.conf if dynamix.cfg is not found.
 #
 # ==============================================================================================
+# DESIGN PRINCIPLES
+# ==============================================================================================
+#
+# Live Queries, No Persistent State
+#   Every run queries smartctl directly — no cached attribute history, no trend
+#   tracking. Each report is a snapshot of current drive health. This keeps the
+#   script simple and the output always current.
+#
+# Threshold Parity With unRAID Dashboard
+#   Temperature thresholds are read from dynamix.cfg — the same values unRAID
+#   uses on its own dashboard. A consistent threshold means no conflicting alerts
+#   between this script and the built-in unRAID warnings.
+#
+# Silent When Healthy
+#   No output, no notification on a clean run. The absence of a report is the
+#   confirmation that all drives passed. Noise from weekly healthy runs would
+#   erode attention to the reports that matter.
+#
+# ==============================================================================================
 # OPERATIONAL SAFEGUARDS
 # ==============================================================================================
 #