From e5608f7b002f5101af9d59c676a9a054fef88d2e Mon Sep 17 00:00:00 2001 From: jochen Date: Thu, 22 Oct 2026 14:17:40 +0200 Subject: [PATCH] =?UTF-8?q?Say=20in=20the=20gate's=20README=20when=20a=20r?= =?UTF-8?q?efused=20or=20rejected=20merge=20reaches=20the=20operator=20(AD?= =?UTF-8?q?R=200505=20=C2=A74,=20=C2=A75)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- modules/mesh-delivery-gate/README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/modules/mesh-delivery-gate/README.md b/modules/mesh-delivery-gate/README.md index 4f8b9de3..5b208ec6 100644 --- a/modules/mesh-delivery-gate/README.md +++ b/modules/mesh-delivery-gate/README.md @@ -20,6 +20,19 @@ of such a delivery asks the controller (`delivery-backups-again`) to take the ba delivering; a record from before the controller cleared the failure does not hold it again. A held delivery already ends as covered or delivered when a later merge covers it. +## When a refused or rejected merge is said (ADR 0505 §4, §5) + +`stalled` is what the controller raises as a condition for the operator. The gate's own list (`show`, `deliveries`) +names every refusal and rejection at once, and the pull request is told at once; only `stalled` waits: + +- a merge refused because its trunk moved, whose check the gate asked again, is stalled only once that check answered and + the merge was refused again, or twice the repository's last check time passed (at least the setting + `refusal-stall-floor-minutes`, 10). Every other refusal is stalled at once. +- a delivery that needs its author's new head (its check failed after its Approve: a conflict, a failed check, a rejected + group) is stalled only once no new head came for the setting `author-new-head-minutes` (120). Its line says + `needs: new-head` and names its author: the branch, and the session a `Pushed-by: ` line in the pull + request's description names. + ## Taking the seat over from today's module The gate claims the seat `mesh-delivery` and took it over from the module `mesh-delivery`, which the catalogue no longer holds.