mesh-grants, mesh-delivery-assigner, mesh-delivery-indexer: the tool runner's twin from the membership; a pin names a released version (design 47 H2 H-A-472, H-A-490, H-A-495) #335

Merged
mesh-tools merged 6 commits from fix/tools-twin-membership into main 2026-11-22 20:04:57 +00:00
Member

Builds design 47 H2:

  • H-A-472 addenda: the composer makes no _tools twin; the membership carries the tool runner's twin spec (HeardIssued); mesh-grants judges both twins where uncomposed, a never-read durable is an orphan, and deletes the membership key.
  • H-A-490 (and addendum): a passed pipeline takes a mover's version released before the pass; a put's want names the version released at its build.
  • H-A-495: a pin names a released version only, never a reservation.

One delivery group with novox/mesh-tools fix/tools-twin-membership (H-A-472 fifth addendum: the runner creates the _tools twin).

Reviewed-by: mesh-code-reviewer@shanks at ae1bf209 (earlier commits)
Reviewed-by: mesh-code-reviewer@shanks at ef32d60a5e

Builds design 47 H2: - H-A-472 addenda: the composer makes no `_tools` twin; the membership carries the tool runner's twin spec (HeardIssued); mesh-grants judges both twins where uncomposed, a never-read durable is an orphan, and deletes the membership key. - H-A-490 (and addendum): a passed pipeline takes a mover's version released before the pass; a put's want names the version released at its build. - H-A-495: a pin names a released version only, never a reservation. One delivery group with novox/mesh-tools `fix/tools-twin-membership` (H-A-472 fifth addendum: the runner creates the `_tools` twin). Reviewed-by: mesh-code-reviewer@shanks at ae1bf209 (earlier commits) Reviewed-by: mesh-code-reviewer@shanks at ef32d60a5e3966b38d5be0c80eefdcc7f77f1a88
mesh-tools added 6 commits 2026-11-22 20:00:06 +00:00
The grants part stays the one composer of filters while the tool runner makes its
own `_tools` twin: each heard entry, EVENTS included, carries the twin's filters
(the again filter named for it), ack wait, max deliver, max ack pending and
deliver policy. The pass composes no `_tools` consumer any longer, so it makes no
twin nothing reads; the reader grants add the create and delete of the module's
own twin by name. A membership of a module no longer assigned on its node is
withdrawn by a whole pass, so the runner there removes that module's twins. The
part's own hearing loop leaves EVENTS to the hub, now that the membership names it.

Builds: design 47 H2 H-A-472 (fifth, sixth, seventh, eighth and ninth addenda)
Review round 1 found that with no `_tools` twin composed, the behind and orphan
checks never looked at one: live, five twins on EVENTS held 1,000 to 58,000
messages and none was named. The pass now reads, on the streams each consuming
module's heard entries name, every held `<consumer>_tools` and judges it as any
consumer: behind by the bound, or an orphan when no pull waits and its twin is
current. The stale comments on HasProgram and the orphan finding's text follow.

Builds: design 47 H2 H-A-472 (tenth addendum)
Review round 2: a durable nobody ever read (no pull waiting, no delivery ever) was
named behind when its twin was not current, and the plain durable of a module whose
program left was never judged (live: claude-code's plain durables 1,000 to 3,000
behind beside a current `_tools` twin). A never-read durable is now an orphan
whatever its twin; one read once and lagging stays behind. The pass judges both
twins of every heard entry wherever no pass composes them, also on a stream where
only such durables are held.

Builds: design 47 H2 H-A-472 (eleventh addendum)
An again pipeline on a built, published key ends naming no version, and the
runner never says its end again, so its movers kept the old want. At the pass,
a mover with no version is matched to the release of its build's parts.

Builds: design 47 H2 H-A-490
A put wrote its want by fingerprint alone, which the node-engine cannot
compose. The put now finds the version released at its build's parts, as the
pass does, names it in the want, and is refused when none is released.

Builds: design 47 H2 H-A-490 (addendum)
Importers were pinned to mesh-delivery-contracts 0.1.82 to 0.1.84, reserved by
builds a competing build withdrew before release and never published, so their
builds failed "unknown revision". The series' numbered version a reservation
writes no longer pins: a pin is the series' newest released version, so a
version-reserved moves no pin and the release's re-pin moves the importers. A
pin held on a version never released is moved at the next take-in or re-pin and
said per module ("<module>: pinned to <pkg> <v>, never released; moved to <v2>").

Builds: design 47 H2 H-A-495 and its addendum (hq 9e0923ce)
mesh-tools merged commit 5548fff81f into main 2026-11-22 20:04:57 +00:00
mesh-tools deleted branch fix/tools-twin-membership 2026-11-22 20:04:57 +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#335