From a3934b7c62c2ed86940caddc2ea9011b3be5f438 Mon Sep 17 00:00:00 2001 From: christian Date: Tue, 13 Oct 2026 15:36:32 -0400 Subject: [PATCH] docs: the change guard is 'a HyperDeck is recording' only; Sunday stays an auto-fix window Co-Authored-By: Claude Fable 5.1 --- docs/settings-plan-audit.md | 2 +- docs/settings-plan.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/settings-plan-audit.md b/docs/settings-plan-audit.md index 2050201..371ecbb 100644 --- a/docs/settings-plan-audit.md +++ b/docs/settings-plan-audit.md @@ -290,6 +290,6 @@ C14, preview run. Review has no "Preview the deck with these settings" button th ## Still open (needs the user) - Q1 Answered 2026-10-13: the editing code lives in config.json in the private repo; everyone with the repo has it. -- Q2 Still open: the page refuses to apply changes while a service is on (Sunday 06:30-13:30 today, plus any time a deck is recording). Are there other times, such as a midweek service or a rehearsal, when it should refuse too? +- Q2 Answered 2026-10-13: changes wait only while a HyperDeck is recording; no clock windows at NA (Sunday 06:30-13:30 stays the auto-fix window). - Q3 Answered 2026-10-13: Apollo Beach, Woonsocket and Southcoast, each with a Mac Studio already running Companion. - Q4 Answered 2026-10-13: the unwatched connections stay unwatched. diff --git a/docs/settings-plan.md b/docs/settings-plan.md index 22c8192..cc6e658 100644 --- a/docs/settings-plan.md +++ b/docs/settings-plan.md @@ -121,7 +121,7 @@ COMPUTERS - MAP [Check computers now] looked 2 Six sections, each opening on the few things a person changes: - **Site:** site name, this Mac's name and addresses, contacts for the cheat sheet, the alert message hook. Advanced: page port, the login key (present / not, public half to copy), helper paths, the editing code, install the staged folder, export the site bundle. -- **Schedules:** one schedule, the **live services** (Sunday 06:30–13:30 today): during them changes wait, auto-fix may act, alarms are always on. The tick list of fixes auto-fix may run. Advanced: the timing numbers (a fault must last 3 s, flapping, the 60 s cooldown, the 2 s hold). +- **Schedules:** when **auto-fix may act by itself** (Sunday 06:30–13:30 today) and the tick list of fixes it may run; alarms are always on. Changes to the panel wait while a HyperDeck is recording, not by the clock (a campus can add clock windows here too; NA has none). Advanced: the timing numbers (a fault must last 3 s, flapping, the 60 s cooldown, the 2 s hold). - **Companion:** the lights (variables exist, blink trigger, our pages exist, quiet Tascam module, ATEM module), the live list of connections with their module and which key watches each, "Add a key for it" for the ones nothing watches, the page-number buttons ("coloured on 96 of 97 pages" + Colour them now / Undo). Advanced: address, variable names, nav settings, grid, purple-after, export stamps. - **Network & Dante:** the port and gateway the NET key watches, the Dante switches, and the **Dante device list** (the one place the DANTE key's devices are edited, with key text and per-device fix), "Check the Dante network now". Advanced: the blip rule, survey interval. - **Spotify:** one field for the playlist (paste the link; name and song count fill in), the two waits, a light saying the watchdog may control Spotify. @@ -142,7 +142,7 @@ Grouped here; every single field is in [the details table](settings-plan-details | Fixes | every fix: what it is built from, computer, program, waits, "may close a running program", "never runs by itself", reconnect Companion afterwards; the raw command under Advanced | Fixes, and inline from a key's When held | | Computers | each computer: display name, kind (Mac/Windows), log-in address, wake-on-LAN, does not answer pings, notes, what runs there (programs, tasks, services, helpers, MIDI sessions), network ports, done-by-hand ticks | Computers | | Gear | where each device is, notes | Computers → Gear | -| Schedules | live-service windows (overnight allowed), the auto-fix list and numbers, the timing numbers, the daily log folder and how long logs are kept | Site setup → Schedules | +| Schedules | the auto-fix windows (overnight allowed) and the fixes it may run, optional clock windows for the change guard (none at NA: a recording HyperDeck is the guard), the timing numbers, the daily log folder and how long logs are kept | Site setup → Schedules | | Companion | address, variable names, page-number button settings, grid, purple-after, export stamps; the connection labels are read live | Site setup → Companion | | Network & Dante | port, gateway, blip rule, switches, survey interval, Dante devices and key texts and per-device fixes | Site setup → Network & Dante | | Spotify | playlist, name, waits | Site setup → Spotify | @@ -170,7 +170,7 @@ Setting up a new campus: install Companion and the command-line tools on its Ing 2. **Check.** On every change and again at Apply: the rules (ids, positions, windows, addresses, every fix's computer exists…), the watchdog's own loader on a temporary copy, a build of both pages in memory, and live warnings (a connection label not in Companion, a computer unreachable, a private playlist). 3. **Review.** The plain change list, warnings, anything built as a command in red, what Apply will do. 4. **Apply**, each step only after the previous one worked: keep a copy of the current version in History → write the new file in one go (and the new switcher file with it, if there is one) → wait for any fix that is running to finish → restart the watchdog (a change to key notes alone skips this) → **prove it came back** (its start stamp with the new file's fingerprint, no error, still alive after 10 s) → only then re-import the pages if the layout changed (key notes alone never trigger a re-import; the page refuses to overwrite a key someone added by hand in Companion and names its position) → recolour the page-number buttons if pages changed → rebuild "What each key does". If the watchdog does not come back, the previous version (and switcher file) is restored automatically, once, and Overview shows a red note until the next good Apply. -5. **During a live service** (the schedule, or any HyperDeck that follows the recording is recording) Apply is refused with the reason and when it ends; the draft stays saved. The same goes for Run this fix now, Restart the watchdog, re-imports, the switcher check and program installs. An **Emergency** button states the consequence, asks you to type LIVE and a reason, and is logged. Starting a watchdog that is down is always allowed. Silencing alarms is never blocked. +5. **While a HyperDeck is recording** (that is what "live" means at NA; a campus may add clock windows) Apply is refused with the reason and when it ends; the draft stays saved. The same goes for Run this fix now, Restart the watchdog, re-imports, the switcher check and program installs. An **Emergency** button states the consequence, asks you to type LIVE and a reason, and is logged. Starting a watchdog that is down is always allowed. Silencing alarms is never blocked. 6. **Going back** = History → Go back to this (or Undo the last change) through the same steps. ## 8. Safety @@ -224,7 +224,7 @@ Later, if wanted: a Training copy of the page where nothing is real; an "OBS is ## 13. Answers so far 1. **Who can edit:** the editing code lives in `config.json` in the private repo, so everyone with the repo has it (answered 2026-10-13). -2. **When changes must wait:** the page refuses to apply a change while a service is on, so nothing is restarted mid-service. Today it knows Sunday 6:30 AM–1:30 PM (and any time a HyperDeck is recording). Still open: are there other times — a midweek service, a rehearsal — when it should refuse too? If not, Sunday is the only window. +2. **When changes must wait:** only while a HyperDeck is recording (answered 2026-10-13). No clock windows at NA; the Sunday 6:30–13:30 window is for auto-fix only. 3. **The other campuses:** Apollo Beach, Woonsocket and Southcoast, each with a Mac Studio already running Companion (answered 2026-10-13). 4. **Unwatched Companion connections** (7 Govee lights, DiGiCo_OSC, m32, AbleSet, tcp-HyperDeck-1..6): stay unwatched (answered 2026-10-13).