Add file dependency map to sky-cam.conf

Documents who calls whom and exactly which files to update
if any script is renamed — so future-you doesn't have to grep.

https://claude.ai/code/session_01C4jbd3waXG3eKZYbGUjLUQ

sky-cam.conf

@@ -72,8 +72,76 @@
 #  Helpers (called by the scripts above, not run directly):
 #    notify.sh             — sends notifications via ntfy / email / Mattermost
 #    season_info.py        — outputs astronomical season/movement/year for a date
-#    sunrise.py            — outputs today's sunrise time (used by sunrise_video)
+#    sunrise.py            — outputs today's sunrise time (used by daily_sunrise_video)
 #    sunrise2mm.py         — uploads the sunrise video to Mattermost
+#    sunrise_overlay.py    — burns a timestamp overlay onto the sunrise video
+#
+# -----------------------------------------------------------------------------
+# FILE DEPENDENCIES — who calls whom, and what to update if you rename a file
+# -----------------------------------------------------------------------------
+#
+#  sky-cam.conf  (this file)
+#    ← sourced by every .sh script; read by sunrise.py, sunrise2mm.py
+#    → if renamed: update the 'source' line at the top of ALL scripts
+#                  (don't rename it — just edit it in place)
+#
+#  install.sh
+#    ← run manually; reads this conf
+#    → if renamed: update the note at the top of this conf file only
+#    generates → systemd unit files (sky-cam-*.service / .timer)
+#                and sky-cam-notify-failure@.service
+#
+#  daily_sunrise_video.sh
+#    ← called by systemd sky-cam-sunrise.timer (09:00)
+#    → if renamed: update install.sh (write_service call, line ~80)
+#                  then re-run install.sh to regenerate the unit
+#    calls → sunrise.py, sunrise_overlay.py, sunrise2mm.py
+#
+#  4-seasons.sh
+#    ← called by systemd sky-cam-4seasons.timer (01:00)
+#    → if renamed: update install.sh (write_service call, line ~86)
+#                  then re-run install.sh
+#    calls → season_info.py, montage-mvt.sh
+#
+#  fullday-video.sh
+#    ← called by systemd sky-cam-fullday.timer (02:00)
+#    → if renamed: update install.sh (write_service call, line ~93)
+#                  then re-run install.sh
+#
+#  montage-mvt.sh
+#    ← called by 4-seasons.sh on the last day of each movement
+#    → if renamed: update 4-seasons.sh (the exec line near the bottom)
+#    calls → season_info.py, notify.sh, year-end-join.sh
+#
+#  year-end-join.sh
+#    ← called by montage-mvt.sh at end of Autumn Mvt 3
+#    → if renamed: update montage-mvt.sh (the exec line at the bottom)
+#    calls → notify.sh
+#
+#  notify.sh
+#    ← called by montage-mvt.sh, year-end-join.sh
+#       also referenced in install.sh for the OnFailure= failure template
+#    → if renamed: update montage-mvt.sh, year-end-join.sh, install.sh
+#
+#  season_info.py
+#    ← called by 4-seasons.sh and montage-mvt.sh
+#    → if renamed: update 4-seasons.sh and montage-mvt.sh (the eval lines)
+#
+#  sunrise.py
+#    ← called by daily_sunrise_video.sh
+#    → if renamed: update daily_sunrise_video.sh
+#
+#  sunrise_overlay.py
+#    ← called by daily_sunrise_video.sh
+#    → if renamed: update daily_sunrise_video.sh
+#
+#  sunrise2mm.py
+#    ← called by daily_sunrise_video.sh
+#    → if renamed: update daily_sunrise_video.sh
+#
+#  stitch-cameras.py
+#    ← run manually only; no script calls it
+#    → safe to rename with no other changes needed
 #
 # =============================================================================