Standardize Cycles scope terminology and clarify protocol behavior#2
Merged
Standardize Cycles scope terminology and clarify protocol behavior#2
Conversation
- Fix commit/release lifecycle: clarify that commit auto-releases unused remainder per spec, and explicit release is for cancellation only - Align scope hierarchy field names with actual Subject schema: environment→workspace, application→app, tool→toolset - Clarify that "run" is not a built-in subject field; run-level budgets are modeled via the dimensions field - Fix scope path examples to use actual field values (not path-prefixed) - Connect shadow mode concept to the dry_run API parameter https://claude.ai/code/session_01KLGxrhRub1DLcL9ZXZZ9wG
New posts: - Events: direct debit without reservation (POST /v1/events) - Decide: preflight budget checks without reservation (POST /v1/decide) - Caps and the three-way decision model (ALLOW/ALLOW_WITH_CAPS/DENY) - Debt, overdraft, and the over-limit model - Commit overage policies (REJECT/ALLOW_IF_AVAILABLE/ALLOW_WITH_OVERDRAFT) - Reservation TTL, grace period, and extend (heartbeat pattern) - Scope derivation: how subject fields become budget hierarchies - Units: USD_MICROCENTS, TOKENS, CREDITS, RISK_POINTS - Getting started with the @cycles Spring Boot Starter - Error codes and error handling (all 12 error codes) - Querying balances: understanding budget state Also updates VitePress sidebar with new "Protocol Reference" section and reorganizes existing posts. https://claude.ai/code/session_01KLGxrhRub1DLcL9ZXZZ9wG
4 tasks
5 tasks
4 tasks
amavashev
added a commit
that referenced
this pull request
May 8, 2026
…ction-kind Round 1 reviewer fixes: - Intro restructured: DENY payoff (`409 BUDGET_EXCEEDED` on external send, draft kept for review, side effect blocked) now appears in the lede instead of the receipts section. - Action-kind clarification: `send-email`/`send-email-approved` are toolset names; the canonical action kind in the v0.1.26 registry is `message.email.send`. Avoids spec confusion. - "What broke" #2 reframed from "budget mutation broken" to "admin-plane mutation hardening" — runtime path (reserve, commit, release, deny) worked; mutation paths are the hardening item. - "What happened in the first live runs" compressed: cut 18-artifact table and standalone triage table; queue counts moved to prose. - Keywords block tightened to reviewer's focused set. Skipped: title alts (current 51 chars vs 67-char alternative), date shift (explicit author choice), description rewrite (reviewer's version was over the 150-160 char SEO limit).
6 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR updates documentation across multiple guides to standardize terminology for Cycles budget scopes and clarify the reserve/commit/release protocol behavior. The changes reflect a more consistent naming convention and better explain automatic vs. explicit release semantics.
Key Changes
Scope Terminology Updates:
dimensionsfield for run-level trackingProtocol Behavior Clarification:
Documentation Improvements:
dimensionsfielddry_run: trueprotocol parameterNotable Details
https://claude.ai/code/session_01KLGxrhRub1DLcL9ZXZZ9wG