Seat mesh-builds: publish-queue lists in stream order (H-A-483)

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
This commit is contained in:
2026-11-22 18:30:30 +01:00
parent fd2cb13961
commit c45f1621fb
3 changed files with 8 additions and 8 deletions
@@ -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, <module>:<artifact>, 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"`
@@ -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",
@@ -251,7 +251,7 @@ export interface PublishQueueAnswerCountsItem {
export interface PublishQueueAnswerQueueItem {
/** each artifact reference, <module>:<artifact>, with the digest to publish */
"artifacts"?: Record<string, string>;
/** 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;