Skip to content

Commit 1f1b5f4

Browse files
author
Elrond
committed
docs: clarify community deletion abort boundary
Signed-off-by: Elrond <28d6302a099e5225b02c4155ac4236e4912603df2ab08dbfc2f4fef08ce598c8@buzz.block.builderlab.xyz>
1 parent c237fd4 commit 1f1b5f4

2 files changed

Lines changed: 6 additions & 4 deletions

File tree

‎ARCHITECTURE.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,8 @@ upstream ceremony. No owner-signed attestation is required or checked, and
3636
owners have no self-service cancellation. Recovery is a privileged abort,
3737
which stays open across the reversible `submitted`, `inventoried`, `approved`,
3838
and `fenced` stages — releasing the request fence while leaving the community
39-
archived — and closes from `drained` onward, once tenant state is destroyed.
39+
archived — and closes from `drained` onward, when tenant-state destruction may
40+
have begun.
4041

4142
Manual operator handoff converges on an admitted owner request only when
4243
`buzz-admin deletions submit --requested-by` repeats the owner pubkey recorded

‎crates/buzz-db/src/store/deletion.rs‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2207,7 +2207,8 @@ impl DeletionStore {
22072207
/// privileged path is the only recovery when preparation cannot continue.
22082208
/// Abort reverses deletion intent, not the owner's archive decision: the
22092209
/// community stays archived and the owner restores it explicitly.
2210-
/// Stages from `drained` onward have destroyed tenant state and stay closed.
2210+
/// Stages from `drained` onward stay closed because tenant-state destruction
2211+
/// may have begun.
22112212
pub async fn abort(
22122213
&self,
22132214
request_id: Uuid,
@@ -4758,8 +4759,8 @@ mod postgres_tests {
47584759
);
47594760
}
47604761

4761-
/// The reversible boundary stops at `inventoried`. Once execution has
4762-
/// destroyed anything, abort must stay closed.
4762+
/// The reversible boundary extends through `fenced`. From `drained`
4763+
/// onward, destruction may have begun, so abort must stay closed.
47634764
#[tokio::test]
47644765
#[ignore = "requires Postgres"]
47654766
async fn privileged_abort_spans_only_the_reversible_pre_destruction_boundary() {

0 commit comments

Comments
 (0)