docs+test(closeout): final-review reservations — stale ACL prose, worker test gaps, config sample fix

2026-08-17 05:23:23 -04:00
parent f5a58d884b
commit b621d692d0
18 changed files with 167 additions and 46 deletions
@@ -77,10 +77,15 @@ public interface IAlarmCommandHandler : IDisposable
    ///     rather than read from a separate property, both so the pair comes from
    ///     one atomic consumer read and because it is the only carrier left once
    ///     <paramref name="alarmFilterPrefix"/> (or an empty galaxy) filters the
-    ///     records down to none. <see langword="false"/> when there is no active
-    ///     subscription: no fetch has happened, so nothing is capped.
+    ///     records down to none. Never assigned when there is no active
+    ///     subscription — that case throws rather than reporting an empty,
+    ///     never-capped set, so a query issued before <c>SubscribeAlarms</c> is a
+    ///     caller error and not a silent all-clear.
    /// </param>
    /// <returns>The currently active alarms matching the filter.</returns>
+    /// <exception cref="InvalidOperationException">
+    ///     Thrown when there is no active subscription.
+    /// </exception>
    IReadOnlyList<ActiveAlarmSnapshot> QueryActive(string? alarmFilterPrefix, out bool snapshotTruncated);

    /// <summary>