Merge pull request #19 from runcycles/claude/review-protocol-updates-TBGQh

Change default overage policy from REJECT to ALLOW_IF_AVAILABLE

Author: amavashev

README.md

@@ -312,8 +312,8 @@ Control what happens when actual usage exceeds the estimate at commit time:
 ```python
 from runcycles import CommitOveragePolicy
 
-# REJECT (default) — commit fails if budget is insufficient for the overage
-# ALLOW_IF_AVAILABLE — commit succeeds if remaining budget covers the overage
+# REJECT — commit fails if budget is insufficient for the overage
+# ALLOW_IF_AVAILABLE (default) — commit succeeds if remaining budget covers the overage
 # ALLOW_WITH_OVERDRAFT — commit always succeeds, may create debt
 
 @cycles(estimate=1000, overage_policy="ALLOW_WITH_OVERDRAFT", client=client)

runcycles/_constants.py

@@ -8,7 +8,7 @@
 DEFAULT_READ_TIMEOUT = 5.0
 DEFAULT_TTL_MS = 60_000
 DEFAULT_GRACE_PERIOD_MS = 5_000
-DEFAULT_OVERAGE_POLICY = "REJECT"
+DEFAULT_OVERAGE_POLICY = "ALLOW_IF_AVAILABLE"
 DEFAULT_UNIT = "USD_MICROCENTS"
 
 RESERVATIONS_PATH = "/v1/reservations"

runcycles/decorator.py

@@ -62,7 +62,7 @@ def cycles(
     unit: Unit | str = Unit.USD_MICROCENTS,
     ttl_ms: int = 60_000,
     grace_period_ms: int | None = None,
-    overage_policy: str = "REJECT",
+    overage_policy: str = "ALLOW_IF_AVAILABLE",
     dry_run: bool = False,
     tenant: str | None = None,
     workspace: str | None = None,
@@ -87,7 +87,7 @@ def cycles(
         unit: Cost unit. Default: USD_MICROCENTS.
         ttl_ms: Reservation TTL in milliseconds. Default: 60000.
         grace_period_ms: Grace period after TTL expiry in milliseconds.
-        overage_policy: REJECT, ALLOW_IF_AVAILABLE, or ALLOW_WITH_OVERDRAFT.
+        overage_policy: REJECT, ALLOW_IF_AVAILABLE (default), or ALLOW_WITH_OVERDRAFT.
         dry_run: If True, evaluate without persisting (method won't execute).
         tenant: Subject tenant override.
         workspace: Subject workspace override.

runcycles/lifecycle.py

@@ -53,7 +53,7 @@ class DecoratorConfig:
     unit: str = "USD_MICROCENTS"
     ttl_ms: int = 60_000
     grace_period_ms: int | None = None
-    overage_policy: str = "REJECT"
+    overage_policy: str = "ALLOW_IF_AVAILABLE"
     dry_run: bool = False
     tenant: str | None = None
     workspace: str | None = None