feat(ipa0132): Add IPA-132 Long-Running Operations (experimental) - #119
Open
julius-jogela wants to merge 11 commits into
Open
feat(ipa0132): Add IPA-132 Long-Running Operations (experimental)#119julius-jogela wants to merge 11 commits into
julius-jogela wants to merge 11 commits into
Conversation
Publishes IPA-132 as an experimental guideline, porting all 21 guidelines for classifying, initiating, and observing long-running operations, verbatim from the approved guideline source. Adds the `list-operation` and `lro-schema` given aliases needed by the new guidelines. CLOUDP-418892
Points the operation-response guideline's OperationResponse mention at the schema section anchor, matching how IPA-114 links ApiError.
The given="lro-schema" alias already resolves silently through guideline.ts, like every other given alias in the repo. No guideline table anywhere else explains an alias inline, so remove the one-off sentence here too.
…iError Drop the inline JSONPath lead-in sentence so the section goes straight from heading to schema, matching IPA-114's API Error Format section, and add a concrete Example instance underneath.
…or List guideline
julius-jogela
requested review from
andreaangiolillo,
drinkbird,
lovisaberggren,
matt-condon,
saisundar,
wtrocki and
yelizhenden-mdb
August 4, 2026 17:14
…amples Prettier's proseWrap breaks long path code spans mid-string when they contain path parameters, reintroducing literal spaces in rendered paths. Reword the two affected sentences so each path starts its own line and stays intact.
julius-jogela
changed the title
julius-jogela
changed the title
matt-condon
reviewed
Aug 5, 2026
| <Guideline id="IPA-132-operations-must-expire-after-a-finite-retention-period" given="lro-schema" enforcement="review" effort="explore" implementation dependsOn={["IPA-132-operation-endpoints-must-return-operation-response"]}> | ||
|
|
||
| Operation records **must** be transient: they **must** expire after a finite | ||
| retention period, exposed via an `expiredAt` timestamp on the Operation schema |
Collaborator
There was a problem hiding this comment.
matt-condon
reviewed
Aug 5, 2026
| properties: | ||
| status: | ||
| type: string | ||
| enum: [PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED, SUPERSEDED] |
Collaborator
There was a problem hiding this comment.
Is there somewhere we can define/describe these enums?
For example SUPERSEDED might not be intuitive
matt-condon
approved these changes
Aug 5, 2026
matt-condon
left a comment
matt-condon
left a comment
Collaborator
There was a problem hiding this comment.
LGTM no blocking comments and the IPA is experimental so changes could be considered in this PR or a follow-up
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
2 participants
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
Adds IPA-132, the experimental Long-Running Operations guideline set (LRO classification, Operations endpoint conventions, OperationResponse schema, retry/retention/expiry semantics).
Follow-up cleanup after initial review: fixes stray whitespace, drops a restatement-only workflow, relocates the retention default into schema comments, updates example operationIds to match the new generation logic, removes redundant
dependsOnself-references, and scopesretryAfterSecondsto non-terminal operation states.All follow-up cleanup is documented in the Changelog tab of the IPA-132 Google Doc.