R4g+R5 (mesh-sdk): asks on the build seats' streams, the assigner's layouts, mesh-pack (design 47, ADR 0524-0530, 0537) #73

Merged

jschoubben merged 32 commits from feat/r4g into main 2026-10-23 17:48:35 +00:00

Conversation 1 Commits 32 Files Changed 45

+4597 -279

mesh-tools commented 2026-10-23 15:00:46 +00:00

Member

Copy Link

Copy Source

Design 47's last milestone, R4g+R5, one delivery group on branch feat/r4g across eleven repositories (ADR 0524, ADR 0493 §12 kept by hand).

• The ask layout and subjects of the NATS-native build and check flow, the pull loop with capacity, pause by the holder, poison after three runs, bounds from a step's start, Took.Lint (issue 1887; ADR 0525, 0536 §4).
• The assigner's want, held, difference, composition-verdict, grant, ask and view-answer layouts (issue 1297; ADR 0528, 0537).
• cmd/mesh-pack, a hand build with the Go build module's recipe and digest (issue 1888; ADR 0526).
• merge-check.sh scripts gone (issue 1295; ADR 0529).

Reviewed-by: review-r4g@shanks at a2c813a6b4
Pushed-by: lead-47@shanks

Design 47's last milestone, R4g+R5, one delivery group on branch feat/r4g across eleven repositories (ADR 0524, ADR 0493 §12 kept by hand). - The ask layout and subjects of the NATS-native build and check flow, the pull loop with capacity, pause by the holder, poison after three runs, bounds from a step's start, Took.Lint (issue 1887; ADR 0525, 0536 §4). - The assigner's want, held, difference, composition-verdict, grant, ask and view-answer layouts (issue 1297; ADR 0528, 0537). - cmd/mesh-pack, a hand build with the Go build module's recipe and digest (issue 1888; ADR 0526). - merge-check.sh scripts gone (issue 1295; ADR 0529). Reviewed-by: review-r4g@shanks at a2c813a6b468899bb5a95666b8f6f305be52f200 Pushed-by: lead-47@shanks

mesh-tools added 31 commits 2026-10-23 15:00:47 +00:00

Lay out the assigner's wants, holds and differences in mesh-sdk, so the assigner, the watchman and the view read one layout (issue 1297, subtask B1a; ADR 0528 clauses 1 and 4) ec2bd3b990

Lay out the controller's grants and the assigner's composition verdict under the checker's key, so the assigner's rule 6 and the checker's composition read one layout (issue 1297 subtask B1b, issue 1394; ADR 0528 clauses 2 and 5) 687d715e99

Lay out the ask a build node pulls: its subjects, stream, workers and job, so builder, checker and build modules share one form (issue 1887 A1a, ADR 0525, ADR 0536 §4) 37eff6fe5c

Name an ask's step key <node>.<ask id> and its watch, so the asker learns which node took it and refuses other keys (issue 1887 A1b, ADR 0525 §6) b9b9c5120c

Lay out the asks the view may answer and the view's answer key, refusing the merge's ask, so the view and the teller answer only what needs no proof (issue 1297 subtask B1c; ADR 0528 clause 6, ADR 0437 clause 10) d9384bcb23

Pull a build seat's asks delivery first, at most the node's capacity, each ended on its own step key, so no part chooses a node or holds a check (issue 1887 A2a, ADR 0525 §4-§6) a1d73bdcf0

Pull nothing at capacity 0, take a new capacity at the next pull, and keep a node's pause on its pause key, so a paused node stays paused across a restart (issue 1887 A2b) 89aa6fc17c

Keep a long ask alive with in-progress signals and leave a stopped holder's ask to the stream, so a node that dies hands its ask on (issue 1887 A2c, ADR 0525 §6) 792fb2ccfd

Retire the seat node-build-agent for one build seat per language, so a node's builds are pulled and paused at its build modules and a claim on the old seat names its replacement (issue 1887 A9a, ADR 0525 §2, §10) 69041c5302

Refuse the build queue's verbs by name and drop the rows R4e removed, so a caller is told the backlog is the delivery view's and a pause the build seat's (issue 1887 A9b, ADR 0525 §9) c2967432e6

Lay out the assigner's ask value and name the asking a view answer is for, so a stale answer never fills a later asking of the same key (issue 1297 subtask B1c, for the view lane's B9 and B10) f625d98713

Run a pulled ask's whole job with a build module's own step tools, kept verdicts taken after its digest, so both build modules run asks one way and their tools stay the hand path (issue 1887 A3, ADR 0525 §3, §8) 1f6fc027c0

Read a node's build capacity from the build module's own setting at every pull, defaulting to the builder's values, so the control-node pulls nothing (issue 1887 A7, ADR 0525 §5) 8cd22892a3

Pull a build seat's ask through the bundle's runtime one at a time and settle it by id, so a tools bundle pulls by its capacity and order (issue 1887 A11) 4b503f8d0d

Release an ask's workspace when its job ends, so a pulled build or check leaves nothing for the sweep (issue 1887 A3go, ADR 0509) e1dca0a39f

Serve a build seat's current, pause and resume from the SDK, naming the asks running, so the three build modules hold their seats one way (issue 1887 A3node, A9a, ADR 0525 §10) 1672f40233

Let a composition not run say why, the assigner not running among it, and name the indexer's words for a removed module, so a check never waits for a composition nobody makes (issue 1297, B3d) 3e5d4c30ff

Put an ask on its build seat's stream and read its step, and name a building key's asks, so the builder and the checker ask no node and a restarted builder never asks twice (issue 1887 A4a, A4b) 6003da0a58

Key a building key's asks by build seat language, so a builder taking it over knows whose steps to watch (issue 1887 A4b) 34338df950

Merge branch 'feat/r4g-assigner' into feat/r4g c3915ffb11

Run the levels of one check in one ask after one fetch, keeping nothing under the candidate's runner or a digest without the siblings, as ADR 0525 §3 says a check ask is (issue 1887 A5a) ba092d543f

Ask a check's digest as the candidate under the runner and plan as any other when the installed module ignores it, as ADR 0535 §2 and §4 judge (issue 1887 A5a) 691c97ec31

Delete both merge-check scripts; the type check runs before npm test (issue 1295, S8; ADR 0529) ... 232ded26ea

gofmt and vet are the Go build module's, the unit bound the checker's.

Add mesh-pack: a hand build with the build module's recipe and mesh-sdk's own pack (F1) d7375c9811

Merge branch 'feat/r4g-asks' into feat/r4g 51756ee9a4

Merge branch 'feat/r4g-scripts' into feat/r4g 285566eed1

Merge branch 'feat/r4g-fallback' into feat/r4g 9205222a98

Bound an ask's step from its start on the node that took it, not from its put, so an ask waiting in its stream during a large rebuild is never failed and asked twice (issue 1887, review round 2 item 1; ADR 0525 §3, §6) 88fa74ce5e

Restart an ask's bound at each run's start, also on the same node, so a step redelivered after its build module was replaced is not cut by the killed run's time (issue 1887, review: issue 734 path; ADR 0525 §6) fc4f57c4b3

Run an ask no more once its stream delivered it past AskRuns, failing its step with why, so a run that kills its node is not offered to each build node in turn (issue 1907) bec9585d50

Name the unit level's lint time in a verdict's times, so the check's line can say what gofmt and go vet cost (issue 1887 D7-go, review round 2 item 5) a9560890ee

mesh-tools commented 2026-10-23 15:00:52 +00:00

Author

Member

Copy Link

Copy Source

Delivery novox/mesh-sdk@a2c813a6b468 — failed since 2026-10-23T17:59:26Z

Covered: covered after its failure: a later walk that contains it was delivered: plan-1792794944815912745 (novox/mesh-sdk at e1f393bb into main, done, contains its merge 1ff6d339)

Delivery plan — builds mesh-sdk (+41 dependent(s)) → ace, g14, novox, shanks; no bus step; 9 wait(s) for a person

• tier 0: mesh-sdk
• tier 1: mesh-tools
• tier 2: audit-logger, baserow, bazarr, bookshelf, confluence, gitea, gitlab, grafana, home-assistant, icecast, influxdb, jackett, jira, kometa, lab, letta, lidarr, mailu, mesh-catalog, minio, model-usage, mongodb, mosquitto, mssql, netcheck, nextcloud, nftables, nodered, ombi, openai-consumer, radarr, redis, route-adapter, searxng, showcase, sonarr, tautulli, umami, unifi, zsh
• ace: receives baserow, bazarr, bookshelf, grafana, home-assistant, icecast, influxdb, jackett, kometa, letta, lidarr, mosquitto, netcheck, nodered, ombi, radarr, redis, searxng, sonarr, tautulli, unifi, zsh; waits for a person: mssql, nftables
• g14: receives netcheck, zsh; waits for a person: nftables
• novox: receives gitea, mesh-catalog, netcheck, nextcloud, umami, zsh; waits for a person: mailu, minio, mongodb, mssql, nftables
• shanks: receives lab, netcheck, zsh; waits for a person: nftables
• baserow keeps data (ADR 0233): what it holds is backed up before it moves
• bazarr keeps data (ADR 0233): what it holds is backed up before it moves
• bookshelf keeps data (ADR 0233): what it holds is backed up before it moves
• gitea provides npm-package-registry, git, gitea-read, forge-account: its consumers are sent again after it
• gitea keeps data (ADR 0233): what it holds is backed up before it moves
• grafana keeps data (ADR 0233): what it holds is backed up before it moves
• home-assistant keeps data (ADR 0233): what it holds is backed up before it moves
• icecast keeps data (ADR 0233): what it holds is backed up before it moves
• influxdb provides influxdb-api: its consumers are sent again after it
• influxdb keeps data (ADR 0233): what it holds is backed up before it moves
• jackett provides jackett-api: its consumers are sent again after it
• jackett keeps data (ADR 0233): what it holds is backed up before it moves
• kometa keeps data (ADR 0233): what it holds is backed up before it moves
• lab keeps data (ADR 0233): what it holds is backed up before it moves
• lidarr provides lidarr-api: its consumers are sent again after it
• lidarr keeps data (ADR 0233): what it holds is backed up before it moves
• mailu waits for a person: its policy records (module) — unless on a machine its move recreates none of its containers and moves none of its data, which the walk judges and then sends
• mailu provides smtp: its consumers are sent again after it
• mailu keeps data (ADR 0233): what it holds is backed up before it moves
• minio waits for a person: its policy records (module) — unless on a machine its move recreates none of its containers and moves none of its data, which the walk judges and then sends
• minio provides s3-bucket: its consumers are sent again after it
• minio keeps data (ADR 0233): what it holds is backed up before it moves
• mongodb waits for a person: its policy records (module) — unless on a machine its move recreates none of its containers and moves none of its data, which the walk judges and then sends
• mongodb provides mongodb-database: its consumers are sent again after it
• mongodb keeps data (ADR 0233): what it holds is backed up before it moves
• mosquitto provides mqtt-topic: its consumers are sent again after it
• mosquitto keeps data (ADR 0233): what it holds is backed up before it moves
• mssql waits for a person: its policy records (module) — unless on a machine its move recreates none of its containers and moves none of its data, which the walk judges and then sends
• mssql provides mssql-database: its consumers are sent again after it
• mssql keeps data (ADR 0233): what it holds is backed up before it moves
• nextcloud keeps data (ADR 0233): what it holds is backed up before it moves
• nftables waits for a person: its policy records (module) — unless on a machine its move recreates none of its containers and moves none of its data, which the walk judges and then sends
• nodered keeps data (ADR 0233): what it holds is backed up before it moves
• ombi keeps data (ADR 0233): what it holds is backed up before it moves
• radarr provides radarr-api: its consumers are sent again after it
• radarr keeps data (ADR 0233): what it holds is backed up before it moves
• redis provides redis-cache: its consumers are sent again after it
• redis keeps data (ADR 0233): what it holds is backed up before it moves
• searxng keeps data (ADR 0233): what it holds is backed up before it moves
• sonarr provides sonarr-api: its consumers are sent again after it
• sonarr keeps data (ADR 0233): what it holds is backed up before it moves
• tautulli keeps data (ADR 0233): what it holds is backed up before it moves
• umami provides analytics: its consumers are sent again after it
• umami keeps data (ADR 0233): what it holds is backed up before it moves
• unifi keeps data (ADR 0233): what it holds is backed up before it moves
• grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before baserow, bazarr, bookshelf, grafana, home-assistant, icecast, influxdb, jackett, kometa, lab, letta, lidarr, mosquitto, netcheck, nodered, ombi, radarr, redis, searxng, sonarr, tautulli, unifi, zsh is judged on its first machine

Group feat/r4g: novox/hq@e8bd9171cd, novox/mesh-catalog@454fb8a918, novox/mesh-controller@c9a7102bc5, novox/mesh-delivery@b2c545c40a, novox/mesh-host@4b4bb09a05, novox/mesh-lab@4653b17e18, novox/mesh-media-catalog@f4f0bbcfe5, novox/mesh-sdk@a2c813a6b4, novox/mesh-tools-go@5023de36fd, novox/mesh-tools@860043fd7f, novox/okioki@e67d21e8b4

Machines

• claude-code on every machine running it: sent
• mesh-controller on every machine running it: sent
• mesh-delivery-indexer on every machine running it: sent
• mesh-sdk on every machine running it: sent
• node-tools on every machine running it: sent

Transitions

• 2026-10-23 15:03 (new) → proposed (announced): novox/mesh-sdk#73's head announced
• 2026-10-23 15:04 proposed → checked (checked): a verdict names this commit and the trunk's head as its trunk commit
• 2026-10-23 15:04 checked → rejected (refused): the gate failed or could not run, or the repository's own check failed
• 2026-10-23 17:48 rejected → held (merged-unchecked): merged without a passing check — a verdict known with it is taken first: only a person decides that it goes on
• 2026-10-23 17:55 held → delivering (go): its walk started on a word that was not this owner's: the controller's own path, which waits for nobody, or a person's plans go
• 2026-10-23 17:59 delivering → failed (failed): its walk failed, carrying its own commit: a gate on a first machine (what it carried put back), a build, a machine

The commit's note under refs/notes/mesh-plan keeps every transition: git log --notes=mesh-plan.

<!-- mesh-delivery:view --> **Delivery** `novox/mesh-sdk@a2c813a6b468` — **failed** since 2026-10-23T17:59:26Z **Covered**: covered after its failure: a later walk that contains it was delivered: plan-1792794944815912745 (novox/mesh-sdk at e1f393bb into main, done, contains its merge 1ff6d339) **Delivery plan** — builds mesh-sdk (+41 dependent(s)) → ace, g14, novox, shanks; no bus step; 9 wait(s) for a person - tier 0: mesh-sdk - tier 1: mesh-tools - tier 2: audit-logger, baserow, bazarr, bookshelf, confluence, gitea, gitlab, grafana, home-assistant, icecast, influxdb, jackett, jira, kometa, lab, letta, lidarr, mailu, mesh-catalog, minio, model-usage, mongodb, mosquitto, mssql, netcheck, nextcloud, nftables, nodered, ombi, openai-consumer, radarr, redis, route-adapter, searxng, showcase, sonarr, tautulli, umami, unifi, zsh - ace: receives baserow, bazarr, bookshelf, grafana, home-assistant, icecast, influxdb, jackett, kometa, letta, lidarr, mosquitto, netcheck, nodered, ombi, radarr, redis, searxng, sonarr, tautulli, unifi, zsh; waits for a person: mssql, nftables - g14: receives netcheck, zsh; waits for a person: nftables - novox: receives gitea, mesh-catalog, netcheck, nextcloud, umami, zsh; waits for a person: mailu, minio, mongodb, mssql, nftables - shanks: receives lab, netcheck, zsh; waits for a person: nftables - baserow keeps data (ADR 0233): what it holds is backed up before it moves - bazarr keeps data (ADR 0233): what it holds is backed up before it moves - bookshelf keeps data (ADR 0233): what it holds is backed up before it moves - gitea provides npm-package-registry, git, gitea-read, forge-account: its consumers are sent again after it - gitea keeps data (ADR 0233): what it holds is backed up before it moves - grafana keeps data (ADR 0233): what it holds is backed up before it moves - home-assistant keeps data (ADR 0233): what it holds is backed up before it moves - icecast keeps data (ADR 0233): what it holds is backed up before it moves - influxdb provides influxdb-api: its consumers are sent again after it - influxdb keeps data (ADR 0233): what it holds is backed up before it moves - jackett provides jackett-api: its consumers are sent again after it - jackett keeps data (ADR 0233): what it holds is backed up before it moves - kometa keeps data (ADR 0233): what it holds is backed up before it moves - lab keeps data (ADR 0233): what it holds is backed up before it moves - lidarr provides lidarr-api: its consumers are sent again after it - lidarr keeps data (ADR 0233): what it holds is backed up before it moves - mailu waits for a person: its policy records (module) — unless on a machine its move recreates none of its containers and moves none of its data, which the walk judges and then sends - mailu provides smtp: its consumers are sent again after it - mailu keeps data (ADR 0233): what it holds is backed up before it moves - minio waits for a person: its policy records (module) — unless on a machine its move recreates none of its containers and moves none of its data, which the walk judges and then sends - minio provides s3-bucket: its consumers are sent again after it - minio keeps data (ADR 0233): what it holds is backed up before it moves - mongodb waits for a person: its policy records (module) — unless on a machine its move recreates none of its containers and moves none of its data, which the walk judges and then sends - mongodb provides mongodb-database: its consumers are sent again after it - mongodb keeps data (ADR 0233): what it holds is backed up before it moves - mosquitto provides mqtt-topic: its consumers are sent again after it - mosquitto keeps data (ADR 0233): what it holds is backed up before it moves - mssql waits for a person: its policy records (module) — unless on a machine its move recreates none of its containers and moves none of its data, which the walk judges and then sends - mssql provides mssql-database: its consumers are sent again after it - mssql keeps data (ADR 0233): what it holds is backed up before it moves - nextcloud keeps data (ADR 0233): what it holds is backed up before it moves - nftables waits for a person: its policy records (module) — unless on a machine its move recreates none of its containers and moves none of its data, which the walk judges and then sends - nodered keeps data (ADR 0233): what it holds is backed up before it moves - ombi keeps data (ADR 0233): what it holds is backed up before it moves - radarr provides radarr-api: its consumers are sent again after it - radarr keeps data (ADR 0233): what it holds is backed up before it moves - redis provides redis-cache: its consumers are sent again after it - redis keeps data (ADR 0233): what it holds is backed up before it moves - searxng keeps data (ADR 0233): what it holds is backed up before it moves - sonarr provides sonarr-api: its consumers are sent again after it - sonarr keeps data (ADR 0233): what it holds is backed up before it moves - tautulli keeps data (ADR 0233): what it holds is backed up before it moves - umami provides analytics: its consumers are sent again after it - umami keeps data (ADR 0233): what it holds is backed up before it moves - unifi keeps data (ADR 0233): what it holds is backed up before it moves - grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before baserow, bazarr, bookshelf, grafana, home-assistant, icecast, influxdb, jackett, kometa, lab, letta, lidarr, mosquitto, netcheck, nodered, ombi, radarr, redis, searxng, sonarr, tautulli, unifi, zsh is judged on its first machine **Group** `feat/r4g`: novox/hq@e8bd9171cdbc, novox/mesh-catalog@454fb8a918ad, novox/mesh-controller@c9a7102bc53b, novox/mesh-delivery@b2c545c40aec, novox/mesh-host@4b4bb09a05a0, novox/mesh-lab@4653b17e18a7, novox/mesh-media-catalog@f4f0bbcfe59c, novox/mesh-sdk@a2c813a6b468, novox/mesh-tools-go@5023de36fded, novox/mesh-tools@860043fd7fa0, novox/okioki@e67d21e8b448 **Machines** - claude-code on every machine running it: sent - mesh-controller on every machine running it: sent - mesh-delivery-indexer on every machine running it: sent - mesh-sdk on every machine running it: sent - node-tools on every machine running it: sent **Transitions** - 2026-10-23 15:03 (new) → proposed (announced): novox/mesh-sdk#73's head announced - 2026-10-23 15:04 proposed → checked (checked): a verdict names this commit and the trunk's head as its trunk commit - 2026-10-23 15:04 checked → rejected (refused): the gate failed or could not run, or the repository's own check failed - 2026-10-23 17:48 rejected → held (merged-unchecked): merged without a passing check — a verdict known with it is taken first: only a person decides that it goes on - 2026-10-23 17:55 held → delivering (go): its walk started on a word that was not this owner's: the controller's own path, which waits for nobody, or a person's `plans go` - 2026-10-23 17:59 delivering → failed (failed): its walk failed, carrying its own commit: a gate on a first machine (what it carried put back), a build, a machine The commit's note under `refs/notes/mesh-plan` keeps every transition: `git log --notes=mesh-plan`.

jschoubben referenced this issue from a commit 2026-10-23 15:03:26 +00:00

Stand in node-tools beside the toolchain modules in the composition test, as the catalogue's build modules require it since issue 1911, so the test judges the toolchain alone (issue 1887, group check of #73)

jschoubben added 1 commit 2026-10-23 15:03:26 +00:00

Stand in node-tools beside the toolchain modules in the composition test, as the catalogue's build modules require it since issue 1911, so the test judges the toolchain alone (issue 1887, group check of #73) a2c813a6b4

jschoubben merged commit 1ff6d33978 into main 2026-10-23 17:48:35 +00:00

jschoubben deleted branch feat/r4g 2026-10-23 17:48:35 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

mesh/ready

Reviewed and ready: mesh-delivery merges at the marked head once its checks pass (hq ADR 0364)

No labels

Milestone

No items

No Milestone

Projects

Clear projects

No projects

Assignees

Clear assignees

agent-ace agent-g14 agent-novox agent-shanks jschoubben mesh-tools miel.truyen nox-agent

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: novox/mesh-sdk#73