The builder's publishes have one consumer per holder; publish_first retired (H-A-483) #333

Merged
mesh-tools merged 3 commits from fix/publishes-one-consumer into main 2026-11-22 17:39:51 +00:00
Member

Design lines

Design 47 H2, lead answer H-A-483 and its three addenda (hq branch design/47-H1-answers-59: 4333c3d8, cc125479, 571bb261, 1b336cf0).

Cause

The builder's publish queue dispatched through two class consumers (live, again) and tried to order live before again. That cannot hold under every scheduling: the idle-dispatch test row failed on the build node after four review rounds. Lead answer H-A-473 (the two-consumer live-first dispatch) is withdrawn; H-A-483 replaces it.

Change

  • 915a54f1: one pull consumer per learnt holder (publishes-<holder>), items given in stream order; a failed send is handed back with its pause, so an item put meanwhile goes first by construction. The holder's class durables of the earlier release are retired before the one consumer is made (a work queue refuses overlapping filters); their unacknowledged items reach the one consumer. The gap read, the held again items and the live in-flight check go.
  • fd2cb139: builder_publish_first, its mode and its act are retired; the verb publish-queue lists items in stream order. A holder ending in -live or -again is refused at the learn, said, instead of deleting another holder's durable.
  • c45f1621: the seat mesh-builds' publish-queue description and answer class/list regenerated with seatgen. Description only; the seat's form stays.

Tests

  • cmd integration tests 10/10 passing under load; the new rows failed first against the old dispatch.
  • Unit suite whole before every commit; go vet -tags integration ./... clean.

Reviewed-by: mesh-code-reviewer@shanks at c45f1621fb (two rounds)
Pushed-by: lead-47@shanks

## Design lines Design 47 H2, lead answer H-A-483 and its three addenda (hq branch design/47-H1-answers-59: 4333c3d8, cc125479, 571bb261, 1b336cf0). ## Cause The builder's publish queue dispatched through two class consumers (live, again) and tried to order live before again. That cannot hold under every scheduling: the idle-dispatch test row failed on the build node after four review rounds. Lead answer H-A-473 (the two-consumer live-first dispatch) is withdrawn; H-A-483 replaces it. ## Change - 915a54f1: one pull consumer per learnt holder (`publishes-<holder>`), items given in stream order; a failed send is handed back with its pause, so an item put meanwhile goes first by construction. The holder's class durables of the earlier release are retired before the one consumer is made (a work queue refuses overlapping filters); their unacknowledged items reach the one consumer. The gap read, the held again items and the live in-flight check go. - fd2cb139: `builder_publish_first`, its mode and its act are retired; the verb publish-queue lists items in stream order. A holder ending in -live or -again is refused at the learn, said, instead of deleting another holder's durable. - c45f1621: the seat mesh-builds' publish-queue description and answer class/list regenerated with seatgen. Description only; the seat's form stays. ## Tests - cmd integration tests 10/10 passing under load; the new rows failed first against the old dispatch. - Unit suite whole before every commit; `go vet -tags integration ./...` clean. Reviewed-by: mesh-code-reviewer@shanks at c45f1621fbb1c20c834d8a50d9e7e89db5217dde (two rounds) Pushed-by: lead-47@shanks
mesh-tools added 3 commits 2026-11-22 17:39:38 +00:00
The two class consumers (live, again) could not order live before again
under every scheduling: the idle-dispatch row failed on the build node
after four review rounds. One consumer per learnt holder (publishes-<holder>)
gives items in order; a failed send is handed back with its pause, so an
item put meanwhile goes first by construction. The builder retires the
holder's class durables of the earlier release before making the one,
since a work queue refuses overlapping filters; their unacknowledged items
reach the one consumer. The gap read, the held again items and the live
in-flight check go.

Builds: design 47 H2 H-A-483, its addendum and second addendum, §793
With one consumer per holder an item has no class to move ahead of, so
builder_publish_first, its mode and its act go. The verb publish-queue
lists the items in stream order, the order the one consumer gives them,
and its description says so. A holder is a module name, so one ending in
-live or -again (an earlier release's class durable) is refused at the
learn, said, instead of having another holder's durable deleted.

Builds: design 47 H2 H-A-483 third addendum, §793
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-tools merged commit 96d8136e2b into main 2026-11-22 17:39:51 +00:00
mesh-tools deleted branch fix/publishes-one-consumer 2026-11-22 17:39:51 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novox/mesh-delivery#333