v0.191.2 — a quiet fill check now says so (R-167)
gates / gates (push) Successful in 9s

Earned during v0.191.1's own live validation. After the customer had been
warned, a restart produced ZERO fillwatch lines — equally consistent with
'ran and chose silence' and 'never ran'. Proving the checker was alive
needed a deliberate crossing into the critical band.

For an edge-triggered check the quiet run IS the healthy steady state, so
that ambiguity is permanent rather than rare. Check now logs a per-RUN
summary on every run, counting unreadable separately from healthy so a
drive that has quietly gone unreadable cannot read as 'all fine'.
This commit is contained in:
2026-08-02 23:37:04 +02:00
parent 5adae4dad9
commit 9a3c4855d7
3 changed files with 100 additions and 0 deletions
@@ -195,6 +195,7 @@ func (w *Watcher) Check() error {
targets := w.targets()
seen := make(map[string]bool, len(targets))
changed := false
var checked, skipped, emitted int
for _, t := range targets {
if t.Path == "" {
@@ -208,8 +209,10 @@ func (w *Watcher) Check() error {
// backup_target_absent). Reporting it as "full" would be a false alarm with a misleading
// cause, and would tell the customer to delete files that are not the problem.
w.logger.Printf("[DEBUG] [fillwatch] %s: usage unreadable — skipped (an unreadable filesystem is not a full one)", t.Path)
skipped++
continue
}
checked++
prev := w.bands[t.Path]
next := classify(*u, prev)
if next == prev {
@@ -230,6 +233,7 @@ func (w *Watcher) Check() error {
msg := Message(t, *u, next)
w.logger.Printf("[WARN] [fillwatch] %s (%q): %s → %s — %.0f%% used, %.1f GB free of %.1f GB; notifying the customer",
t.Path, t.Label, prev, next, u.UsedPercent, u.AvailGB, u.TotalGB)
emitted++
if w.notify != nil {
w.notify(Event{Target: t, Band: next, Usage: *u, Message: msg})
}
@@ -244,12 +248,38 @@ func (w *Watcher) Check() error {
}
}
// A POSITIVE OBSERVABLE, every run, healthy or not (standing rule 3). Without it a quiet run is
// indistinguishable from a checker that never ran — and because this check is edge-triggered, the
// HEALTHY steady state IS a quiet run, so the ambiguity is permanent rather than rare. It was hit
// for real while live-validating v0.191.1 on 9201: an unchanged band produced zero log lines, and
// proving the checker was alive needed a deliberate threshold crossing.
w.logger.Printf("[INFO] [fillwatch] checked %d filesystem(s), %d unreadable/skipped, %d notification(s); bands: %s",
checked, skipped, emitted, w.bandSummaryLocked())
if !changed {
return nil
}
return w.saveLocked()
}
// bandSummaryLocked renders the current per-path bands for the run summary, deterministically. Caller
// holds w.mu.
func (w *Watcher) bandSummaryLocked() string {
if len(w.bands) == 0 {
return "all ok"
}
paths := make([]string, 0, len(w.bands))
for p := range w.bands {
paths = append(paths, p)
}
sort.Strings(paths)
parts := make([]string, 0, len(paths))
for _, p := range paths {
parts = append(parts, p+"="+w.bands[p].String())
}
return strings.Join(parts, " ")
}
// Bands returns a copy of the current per-path state (diagnostics + tests).
func (w *Watcher) Bands() map[string]Band {
w.mu.Lock()