diff --git a/modules/nats/cmd/nats-tools/requests.go b/modules/nats/cmd/nats-tools/requests.go index 7c9d0d47e..b0902d809 100644 --- a/modules/nats/cmd/nats-tools/requests.go +++ b/modules/nats/cmd/nats-tools/requests.go @@ -173,7 +173,8 @@ func askExpiry(a map[string]any) (time.Duration, error) { // askFor is the operator's ask for a recreate or a drop of one entry, its approve option binding exactly that act: at // the approve level until a channel carries a destroy answer, ending at the request's AskExpires, the caller's (design -// 47 H-A-237). +// 47 H-A-237); the bend ends with the research effort that designs the channel carrying the destroy proof (design 47 H2 +// §813 (11)). func askFor(r keeper.Request) (oc.Ask, error) { binds, err := occ.ActDigest(r.Act()) if err != nil { diff --git a/modules/nats/internal/keeper/requests.go b/modules/nats/internal/keeper/requests.go index 69be4ae0a..0f1b08821 100644 --- a/modules/nats/internal/keeper/requests.go +++ b/modules/nats/internal/keeper/requests.go @@ -72,8 +72,8 @@ type Request struct { } // AskLasts is how long the operator's ask for a recreate or a drop waits for an answer when its caller names no expiry: -// sixty minutes (design 47 H-A-237: the ask is at the approve level until a channel carries a destroy answer, with the -// asker's expiry). It is shorter than the day the state requests keeps a key, so a request whose ask ended unanswered is +// sixty minutes (design 47 H-A-237: the ask is at the approve level, with the asker's expiry, a bend that ends with the +// research effort designing the channel that carries the destroy proof, design 47 H2 §813 (11)). It is shorter than the day the state requests keeps a key, so a request whose ask ended unanswered is // ended by the keeper, saying so, before its key ages out, and the warrant's acted key (ActedKey) outlives the ask it // spends. const AskLasts = 60 * time.Minute @@ -333,7 +333,8 @@ func (k *Keeper) warranted(r *Request) error { return fmt.Errorf("no warrant: %w", err) } // An approve-level choice warrants a recreate or a drop (design 47 H-A-237): no channel carries a destroy answer yet, - // so the ask is at the approve level; a destroy-level choice still warrants it. + // so the ask is at the approve level; a destroy-level choice still warrants it. The bend ends with the research effort + // that designs the channel carrying the destroy proof (design 47 H2 §813 (11)); this check then asks the destroy level. if occ.Rank(o.Level) < occ.Rank(occ.Approve) { return fmt.Errorf("the operator chose %s, so nothing is removed", o.Label) }