From c45f1621fbb1c20c834d8a50d9e7e89db5217dde Mon Sep 17 00:00:00 2001 From: jochen Date: Sun, 22 Nov 2026 18:30:30 +0100 Subject: [PATCH] Seat mesh-builds: publish-queue lists in stream order (H-A-483) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The verb's description and its answer's class and list say what the builder now does: one consumer per holder, items listed in stream order, no class pulled first. Description only, regenerated with seatgen; the seat's format stays, as at B4's description changes of this seat. Builds: design 47 H2 H-A-483 third addendum, §793 --- .../mesh-delivery-contracts/go/seats/meshbuilds/contract.go | 6 +++--- modules/mesh-delivery-contracts/seats/mesh-builds/seat.json | 6 +++--- .../mesh-delivery-contracts/ts/seats/meshbuilds/index.d.ts | 4 ++-- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/modules/mesh-delivery-contracts/go/seats/meshbuilds/contract.go b/modules/mesh-delivery-contracts/go/seats/meshbuilds/contract.go index 594afb9f6..7d0a0c843 100644 --- a/modules/mesh-delivery-contracts/go/seats/meshbuilds/contract.go +++ b/modules/mesh-delivery-contracts/go/seats/meshbuilds/contract.go @@ -57,7 +57,7 @@ func VerbDescription(verb string) string { case VerbDrop: return "End an ask on the seat's work queue for a caller that no longer waits for it (its step ended by its bound): one waiting is ended dropped when it is pulled, one taken is cancelled; both end the step could-not-run, its why naming the drop and who asked it, so no holder works on it after (design 47 H2 §778; H-A-401; ADR 0664 §4)." case VerbPublishQueue: - return "What the builder's work queue publishes holds, read by the builder from its own stream (design 47 H2 §793; H-A-454): the items' count per registry seat holder and class with the oldest and newest queue time, and the first 50 in the order they are pulled (the live class first, each class oldest first); module, and version, list only that module's items. A queue read past 4,000 items is answered capped, naming the items read and the queue's size." + return "What the builder's work queue publishes holds, read by the builder from its own stream (design 47 H2 §793; H-A-454): the items' count per registry seat holder and class with the oldest and newest queue time, and the first 50 in stream order, the order each holder's one consumer pulls them (H-A-483); module, and version, list only that module's items. A queue read past 4,000 items is answered capped, naming the items read and the queue's size." } return "" } @@ -338,7 +338,7 @@ const ( type PublishQueueAnswerQueueItem struct { // each artifact reference, :, with the digest to publish Artifacts map[string]string `json:"artifacts,omitempty"` - // live, a build a pipeline's step waits on, pulled first; again, asked again at a start + // live, a build a pipeline's step waits on; again, asked again at a start Class string `json:"class"` // the registry seat's holder the item is sent to, a module Holder string `json:"holder"` @@ -368,7 +368,7 @@ type PublishQueueAnswer struct { ItemsRead int64 `json:"items-read,omitempty"` // how many of total the answer lists Listed int64 `json:"listed"` - // the first 50 items listed, per holder in the order they are pulled + // the first 50 items listed, in stream order Queue []PublishQueueAnswerQueueItem `json:"queue"` // with capped: the queue's size in bytes QueueBytes int64 `json:"queue-bytes,omitempty"` diff --git a/modules/mesh-delivery-contracts/seats/mesh-builds/seat.json b/modules/mesh-delivery-contracts/seats/mesh-builds/seat.json index b19a7f796..d077cd8c2 100644 --- a/modules/mesh-delivery-contracts/seats/mesh-builds/seat.json +++ b/modules/mesh-delivery-contracts/seats/mesh-builds/seat.json @@ -156,7 +156,7 @@ { "name": "publish-queue", "class": "read", - "description": "What the builder's work queue publishes holds, read by the builder from its own stream (design 47 H2 §793; H-A-454): the items' count per registry seat holder and class with the oldest and newest queue time, and the first 50 in the order they are pulled (the live class first, each class oldest first); module, and version, list only that module's items. A queue read past 4,000 items is answered capped, naming the items read and the queue's size.", + "description": "What the builder's work queue publishes holds, read by the builder from its own stream (design 47 H2 §793; H-A-454): the items' count per registry seat holder and class with the oldest and newest queue time, and the first 50 in stream order, the order each holder's one consumer pulls them (H-A-483); module, and version, list only that module's items. A queue read past 4,000 items is answered capped, naming the items read and the queue's size.", "input": { "type": "object", "properties": { @@ -243,7 +243,7 @@ "live", "again" ], - "description": "live, a build a pipeline's step waits on, pulled first; again, asked again at a start" + "description": "live, a build a pipeline's step waits on; again, asked again at a start" }, "artifacts": { "type": "object", @@ -266,7 +266,7 @@ "queued" ] }, - "description": "the first 50 items listed, per holder in the order they are pulled" + "description": "the first 50 items listed, in stream order" }, "listed": { "type": "integer", diff --git a/modules/mesh-delivery-contracts/ts/seats/meshbuilds/index.d.ts b/modules/mesh-delivery-contracts/ts/seats/meshbuilds/index.d.ts index bb720d9a6..5e2903e05 100644 --- a/modules/mesh-delivery-contracts/ts/seats/meshbuilds/index.d.ts +++ b/modules/mesh-delivery-contracts/ts/seats/meshbuilds/index.d.ts @@ -251,7 +251,7 @@ export interface PublishQueueAnswerCountsItem { export interface PublishQueueAnswerQueueItem { /** each artifact reference, :, with the digest to publish */ "artifacts"?: Record; - /** live, a build a pipeline's step waits on, pulled first; again, asked again at a start */ + /** live, a build a pipeline's step waits on; again, asked again at a start */ "class": "live" | "again"; /** the registry seat's holder the item is sent to, a module */ "holder": string; @@ -275,7 +275,7 @@ export interface PublishQueueAnswer { "items-read"?: number; /** how many of total the answer lists */ "listed": number; - /** the first 50 items listed, per holder in the order they are pulled */ + /** the first 50 items listed, in stream order */ "queue": PublishQueueAnswerQueueItem[]; /** with capped: the queue's size in bytes */ "queue-bytes"?: number;