mesh-delivery-builder, mesh-delivery-indexer: upstream artifacts by pinned digest; newest entry only; no git tag (design 47 H2 H-A-486, H-A-487, H-A-489, H-A-492, H-A-494) #336

Merged
mesh-tools merged 8 commits from fix/upstream-release into main 2026-11-22 20:04:59 +00:00
Member

Builds design 47 H2:

  • H-A-486: an upstream artifact is released by its pinned digest and needs no publish.
  • H-A-487: a module's builds are read without every key's history.
  • H-A-489: the builder builds only a branch's newest entry; withdrawn is final.
  • H-A-492: a version's digests are recorded under the builder's own bound (a setting); a build key read error is said.
  • H-A-494: the builder writes no git tag at a release and numbers from no tag.

Reviewed-by: mesh-code-reviewer@shanks at cfd2afe3 (earlier commits)
Reviewed-by: mesh-code-reviewer@shanks at 52fa062e92

Builds design 47 H2: - H-A-486: an upstream artifact is released by its pinned digest and needs no publish. - H-A-487: a module's builds are read without every key's history. - H-A-489: the builder builds only a branch's newest entry; withdrawn is final. - H-A-492: a version's digests are recorded under the builder's own bound (a setting); a build key read error is said. - H-A-494: the builder writes no git tag at a release and numbers from no tag. Reviewed-by: mesh-code-reviewer@shanks at cfd2afe3 (earlier commits) Reviewed-by: mesh-code-reviewer@shanks at 52fa062e9204184cd248a4e64a386f3b2b7d938b
mesh-tools added 8 commits 2026-11-22 20:00:10 +00:00
Design 51 copies an upstream image by its pinned digest, and distribution's
mirror says published with no version, so nats, hello-web, mailu and showcase
could never be released. The reservation keeps its upstream refs (Upstream,
filled at the reserve from the plan's upstream tasks) and Missing never awaits
them; the indexer releases a version once every other artifact is published,
naming each upstream artifact with the pin its manifest gives, and refuses the
release loudly when an upstream artifact names no pin.

Builds: design 47 H2 H-A-486, H-A-486 (addendum)
builder_build read every key's whole history to learn when its entry was
written, one more round trip per key of the module; on nats's hundreds of keys
the read crawled. Each entry's own write time now comes with the key's read,
the history is read only for the one key a fingerprint names when its entry
says no time, and a listing cut at the 20 newest says so in its note.

Builds: design 47 H2 H-A-487
Review round 1 found the fingerprint guard of the build read unproven: every
entry of the 100-key listing carried a time. The listing is now also read with
entries that say none, and no history may be read.

Builds: design 47 H2 H-A-487 (review round 1 finding)
Two fingerprints of one module took the series from each other (nats
flipped between 0.1.140 and 0.1.152): a later look built an older
fingerprint again, and its reservation took the newer one's over.

The builder now refuses, before it reserves or builds, a fingerprint of
the first watched branch that is no longer the newest entry heard there,
saying once per key that it is superseded; a step ask of it fails so,
never waits. It looks again just before it reserves. A key withdrawn is
taken again by no look, only by a person's build again.

Builds: design 47 H2 H-A-489
Review round 1 found two paths untested: a step ask of a withdrawn key
still newest answers failed at once, and a newer entry heard between the
older build's claim and its reservation is not taken over. Each row
fails without its line. The comments of H-A-205 say that H-A-489
overrides it once the newer entry is heard.

Builds: design 47 H2 H-A-489 (review round 1)
A takeover or an end cancelling a build's context cancelled the record of its
reservation's digests eight times in a day, each leaving a passed build
unreleased. The record now runs under the builder's own bound (one minute,
not cancelled with the build), and a done build whose digests are not
recorded is recorded from its done key at the builder's next look and at its
start (before H-A-484's start check holds it against the released versions),
said each time.

Builds: design 47 H2 H-A-492
Review round 1 (principle 11, configurable, never hard-coded): the bound of
the record of a version's digests is the builder's setting
record-bound-seconds (default 60), read from its file as revision-wait and
package-wait are, set on the Builder and used for the record. A build key
the builder cannot read, or that holds no build, is said in its journal
instead of being taken silently as not done (principle 3, failure is loud).

Builds: design 47 H2 H-A-492
A Go package comes from the Go package registry alone, so a released version
is no longer written as a git tag: the release path and the start's take-in
of a released version call no seat git, and a reserve numbers a series from
the catalog's versions and the registries' only, never reading tags. A
reservation's kept tag field stays for records written before.

Builds: design 47 H2 H-A-494 (withdraws H-A-484's tag steps and H-A-493; design 51's fallback tag retired)
mesh-tools merged commit a096397928 into main 2026-11-22 20:04:59 +00:00
mesh-tools deleted branch fix/upstream-release 2026-11-22 20:05:00 +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#336