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
@@ -25,6 +25,25 @@
 # album/artist directories.
 #
 # ==============================================================================================
+# DESIGN PRINCIPLES
+# ==============================================================================================
+#
+# Additive Only
+#   The script only adds missing files — it never overwrites existing artwork
+#   or touches audio files. Re-running after a partial fetch completes exactly
+#   where it left off with no side effects.
+#
+# Source Fallback Chain
+#   Multiple sources are tried in order of quality preference. fanart.tv is
+#   primary; fallbacks exist so partial coverage is better than none. A failed
+#   primary never blocks the fallback from running.
+#
+# External API Courtesy
+#   Rate limiting and parallel job caps prevent hammering fanart.tv and other
+#   external APIs. Burst behaviour during large initial runs would risk
+#   temporary blocks that break future scheduled fetches.
+#
+# ==============================================================================================
 # OPERATIONAL SAFEGUARDS
 # ==============================================================================================
 #