jerry/buzz
1
0
Fork 0
mirror of https://github.com/block/buzz.git synced 2026-10-30 05:51:46 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(relay): ack version is a code constant that also gates execution

Browse Source 
Signed-off-by: OpenAI Codex <codex@openai.com>
This commit is contained in:
OpenAI Codex
2026-09-29 18:16:18 -04:00
parent bb59f0ef27
commit e21151f47d
1 changed files with 9 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/operator-community-deletion.md
View File

@@ -157,11 +157,15 @@ current `status` at any stage, including after membership purge, and admits no
new work. Clients recover an ambiguous submission by resending it. The same
UUID with a different tuple returns `409 deletion_request_conflict`.
The acknowledgement version is validated before the UUID lookup, so resend
recovery only works while the relay still accepts the version the request was
made under. Retiring a version makes resends of pending requests created under
it fail with `400 unsupported_acknowledgement_version`; keep the old version
accepted for replay until no client can hold a pending request made with it.
The acknowledgement version is a compile-time constant
(`OWNER_DELETION_ACKNOWLEDGEMENT_VERSION`), not operator configuration.
Admission validates it before the UUID lookup, and the executor claims and
leases only requests carrying the current version. Raising it therefore makes
resends of pending requests made under the old version fail with
`400 unsupported_acknowledgement_version`, and leaves already-admitted
old-version requests unclaimed in `submitted`. A version bump must ship code
that keeps admitting replays of, and executing, requests at the prior version
until none remain in a non-terminal stage.
## Owner quota