Change default overage policy from REJECT to ALLOW_IF_AVAILABLE

README.md

@@ -325,7 +325,7 @@ interface WithCyclesConfig {
   // Reservation settings
   ttlMs?: number;          // Time-to-live in ms (default: 60000, range: 1000–86400000)
   gracePeriodMs?: number;  // Grace period in ms (range: 0–60000)
-  overagePolicy?: string;  // "REJECT" (default), "ALLOW_IF_AVAILABLE", "ALLOW_WITH_OVERDRAFT"
+  overagePolicy?: string;  // "ALLOW_IF_AVAILABLE" (default), "REJECT", "ALLOW_WITH_OVERDRAFT"
   dryRun?: boolean;        // Shadow mode — evaluates budget without executing
 
   // Subject fields (override config defaults)

src/lifecycle.ts

@@ -134,7 +134,7 @@ function buildReservationBody(
     action,
     estimate: { unit, amount: estimate },
     ttl_ms: ttlMs,
-    overage_policy: cfg.overagePolicy ?? "REJECT",
+    overage_policy: cfg.overagePolicy ?? "ALLOW_IF_AVAILABLE",
   };
 
   validateGracePeriodMs(cfg.gracePeriodMs);

src/streaming.ts

@@ -120,7 +120,7 @@ export async function reserveForStream(
     actionTags,
     ttlMs = DEFAULT_TTL_MS,
     gracePeriodMs,
-    overagePolicy = "REJECT",
+    overagePolicy = "ALLOW_IF_AVAILABLE",
     dimensions,
   } = options;
 

tests/lifecycle.test.ts

@@ -62,7 +62,7 @@ describe("AsyncCyclesLifecycle", () => {
     const createBody = client.createReservation.mock.calls[0][0];
     expect(createBody.idempotency_key).toBeDefined();
     expect(createBody.ttl_ms).toBe(60000);
-    expect(createBody.overage_policy).toBe("REJECT");
+    expect(createBody.overage_policy).toBe("ALLOW_IF_AVAILABLE");
 
     // Verify wire-format keys in commit body
     const commitBody = client.commitReservation.mock.calls[0][1];