ctrlrelay 0.20.1__tar.gz → 0.20.2__tar.gz

{ctrlrelay-0.20.1 → ctrlrelay-0.20.2}/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.20.2] - 2026-11-04
+
+### Fixed
+
+- A node no longer stops taking work when the agent CLI reports its usage
+  status as `allowed_warning`. That status means a usage window has passed
+  a warning line, and calls are still served; it was treated as a refusal,
+  so nodes at 26% of the 7-day window paused until that window reset, a
+  week away. How close a window is to its limit is still decided by the
+  pause threshold, and any other status still pauses (#338).
+
 ## [0.20.1] - 2026-11-04
 
 ### Fixed
@@ -2348,7 +2359,8 @@ pipeline).
   per-phase implementation plans (Phase 0 through Phase 4).
 - `docs/Claude_Code_Project_Guide.md` — project development guide.
 
-[Unreleased]: https://github.com/AInvirion/ctrlrelay/compare/v0.20.1...HEAD
+[Unreleased]: https://github.com/AInvirion/ctrlrelay/compare/v0.20.2...HEAD
+[0.20.2]: https://github.com/AInvirion/ctrlrelay/compare/v0.20.1...v0.20.2
 [0.20.1]: https://github.com/AInvirion/ctrlrelay/compare/v0.20.0...v0.20.1
 [0.20.0]: https://github.com/AInvirion/ctrlrelay/compare/v0.19.1...v0.20.0
 [0.19.1]: https://github.com/AInvirion/ctrlrelay/compare/v0.19.0...v0.19.1

{ctrlrelay-0.20.1 → ctrlrelay-0.20.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ctrlrelay
-Version: 0.20.1
+Version: 0.20.2
 Summary: Local-first orchestrator for headless coding agents across multiple GitHub repos
 Project-URL: Homepage, https://github.com/AInvirion/ctrlrelay
 Project-URL: Documentation, https://ainvirion.github.io/ctrlrelay/

{ctrlrelay-0.20.1 → ctrlrelay-0.20.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ctrlrelay"
-version = "0.20.1"
+version = "0.20.2"
 description = "Local-first orchestrator for headless coding agents across multiple GitHub repos"
 readme = "README.md"
 requires-python = ">=3.12"

{ctrlrelay-0.20.1 → ctrlrelay-0.20.2}/src/ctrlrelay/core/usage.py

@@ -43,6 +43,14 @@ UNKNOWN_RESET_PAUSE_SECONDS = 3600
 # recursion limit (RecursionError). Any of them is unreadable, not fatal.
 _UNPARSEABLE = (ValueError, RecursionError)
 ALLOWED = "allowed"
+# Statuses that still let a run through. The agent CLI reports
+# ``allowed_warning`` once a window passes a warning line well short of
+# its limit (seen at 26% of the 7-day window), and the call is served.
+# Pausing on it idled machines for the rest of the 7-day window, so it
+# counts as allowed; how close a window is to its limit is the
+# threshold's question, not the status's. Any other status, including
+# one not seen before, still pauses.
+RUNNABLE_STATUSES = frozenset({ALLOWED, "allowed_warning"})
 
 
 @dataclass(frozen=True)
@@ -225,7 +233,7 @@ def pause_for(
 ) -> Pause | None:
     """Whether to stop taking new work.
 
-    Paused when the status is not ``allowed`` or a window is at or above
+    Paused when the status is not one of ``RUNNABLE_STATUSES`` or a window is at or above
     ``threshold``, until that window's reset (for the status, the event's
     own reset). A reading whose reset time has passed says nothing about
     now, so it does not pause. When the reset time is missing or cannot
@@ -243,7 +251,7 @@ def pause_for(
     # From the reading, or from now if the reading claims to be from the
     # future (a clock set back): an hour, never longer.
     fallback = int(min(reading.read_at, now)) + UNKNOWN_RESET_PAUSE_SECONDS
-    if reading.status != ALLOWED:
+    if reading.status not in RUNNABLE_STATUSES:
         until = reading.resets_at if reading.resets_at is not None else fallback
         hits.append((f"usage status is {reading.status}", until))
     for name, w in reading.windows.items():

{ctrlrelay-0.20.1 → ctrlrelay-0.20.2}/tests/test_usage.py

@@ -110,6 +110,30 @@ class TestPause:
         p = pause_for(_reading(status="rejected"), threshold=0.9, now=NOW)
         assert p is not None and p.until == NOW + 3600
 
+    def test_allowed_warning_below_the_threshold_does_not_pause(self) -> None:
+        # The usage.json alkamax wrote on 2026-11-04: a warning status at
+        # 26% of the 7-day window, which had paused it for a week.
+        r = UsageReading.from_json(json.loads(
+            '{"status": "allowed_warning", "read_at": 1793857204, '
+            '"resets_at": 1794412800, '
+            '"seven_day": {"used": 0.26, "resets_at": 1794412800}}'
+        ))
+        assert r is not None and r.status == "allowed_warning"
+        assert pause_for(r, threshold=0.9, now=1793857204) is None
+
+    def test_allowed_warning_at_the_threshold_still_pauses(self) -> None:
+        p = pause_for(
+            _reading(status="allowed_warning",
+                     windows={"seven_day": Window(0.95, NOW + 86400)}),
+            threshold=0.9, now=NOW,
+        )
+        assert p is not None and p.until == NOW + 86400
+        assert "status" not in p.reason
+
+    @pytest.mark.parametrize("status", ["rejected", "allowed_later", "", "ALLOWED"])
+    def test_any_other_status_pauses(self, status: str) -> None:
+        assert pause_for(_reading(status=status), threshold=0.9, now=NOW) is not None
+
     def test_after_the_reset_the_old_reading_does_not_pause(self) -> None:
         r = _reading(windows={"five_hour": Window(0.99, NOW + 600)})
         assert pause_for(r, threshold=0.9, now=NOW + 600) is None