Compare commits

...
Author SHA1 Message Date
mesh-tools 91d0ba10a2 Merge pull request 'Design 47 G: the lead's answer A-480a (a held module with no readable running manifest provides what its trunk manifest provides)' (#707) from design/47-G-lead-answers-117 into main 2026-11-17 22:06:42 +00:00
jschoubben 5502609780 Answer A-480a: a held module whose running manifest cannot be read provides what its trunk manifest provides 2026-11-17 23:06:28 +01:00
mesh-tools 89865f27d8 Merge pull request 'Design 47 G: the lead's answer A-480 (a held module still provides what its running build provides)' (#706) from design/47-G-lead-answers-116 into main 2026-11-17 21:53:43 +00:00
jschoubben ff43506156 Answer A-480: a held module still provides what its running build provides 2026-11-17 22:53:29 +01:00
mesh-tools a74591dc71 Merge pull request 'Design 47 G: the lead's answer A-478b (the order waits of one machine's apply stay)' (#705) from design/47-G-lead-answers-115 into main 2026-11-17 21:15:46 +00:00
jschoubben 1942c23c4a Answer A-478b: the order waits of one machine's apply stay beside the want rule 2026-11-17 22:15:30 +01:00
mesh-tools 580678e948 Merge pull request 'Design 47 G: the lead's answer A-478 (the assigner wants the newest released version that passed)' (#704) from design/47-G-lead-answers-114 into main 2026-11-17 21:05:09 +00:00
jschoubben b6b4e0232c Answer A-478: the assigner wants the newest released version that passed, on every placed machine
The operator's step 5 of the delivery walkthrough, 2026-11-17: the acting-part and
delivery-dependency holds held feh 0.1.8, a module nothing depends on.
2026-11-17 22:04:29 +01:00
mesh-tools dd89b437d2 Merge pull request 'Design 47 G: the lead's answer A-477a (the guard compares the recipe only when named)' (#703) from design/47-G-lead-answers-113 into main 2026-11-17 19:59:00 +00:00
jschoubben b27004f74d Answer A-477a: the build node's guard compares the recipe only when the ask names one 2026-11-17 20:58:49 +01:00
mesh-tools d757200010 Merge pull request 'Design 47 G: the lead's answer A-477 (a runner's step ask names the toolchain's recipe)' (#702) from design/47-G-lead-answers-112 into main 2026-11-17 19:57:58 +00:00
jschoubben b463a1518e Answer A-477: a runner's step ask names the agreed toolchain with its recipe 2026-11-17 20:57:42 +01:00
mesh-tools 21004f50e2 Merge pull request 'Design 47 G: the lead's answer A-476a (code dependents still move)' (#701) from design/47-G-lead-answers-111 into main 2026-11-17 19:21:40 +00:00
jschoubben 0ca76cf54f Answer A-476a: a commit still moves its moved modules' code dependents in any repository 2026-11-17 20:21:30 +01:00
mesh-tools 75857d9eb7 Merge pull request 'Design 47 G: the lead's answer A-476 (the take-in validates nothing, holds for no indexer build, moves only its repository's modules)' (#700) from design/47-G-lead-answers-110 into main 2026-11-17 19:13:31 +00:00
jschoubben d433411fcd Answer A-476: the take-in validates nothing, holds for no indexer build, and moves only its repository's modules 2026-11-17 20:13:20 +01:00
mesh-tools 8f08ef178f Merge pull request 'Design 47 G: the lead's answer A-475a' (#699) from design/47-G-lead-answers-109 into main 2026-11-17 15:17:50 +00:00
jschoubben 2eb4059897 Answer A-475a: the stale count, the catch-up's wait and validate-tries' bounds 2026-11-17 16:17:38 +01:00
mesh-tools fd3d7371bc Merge pull request 'Design 47 G: the lead's answer A-461e (no store address holds only the store's fetchers)' (#698) from design/47-G-lead-answers-108 into main 2026-11-17 15:11:23 +00:00
jschoubben 3982c57e98 Answer A-461e: no store address of any readable kind holds only the store's fetchers 2026-11-17 16:11:12 +01:00
mesh-tools 513920b66b Merge pull request 'Design 47 G: the lead's answer A-461d (a placed module not heard running is laid from its placement)' (#697) from design/47-G-lead-answers-107 into main 2026-11-17 15:03:50 +00:00
jschoubben 945a74b6f2 Answer A-461d: a placed module not heard running is laid from its placement or trunk build 2026-11-17 16:03:36 +01:00
mesh-tools ecf2a05179 Merge pull request 'Design 47 G: the lead's answer A-475 (a validation ask whose request moved is asked again)' (#696) from design/47-G-lead-answers-106 into main 2026-11-17 15:00:26 +00:00
jschoubben f906b7c8b3 Answer A-475: a validation ask whose request moved is asked again, not left could-not-validate 2026-11-17 16:00:12 +01:00
mesh-tools 0347a77bcb Merge pull request 'Design 47 G: the lead's answer A-474 (a module's tests read nothing outside their module)' (#695) from design/47-G-lead-answers-105 into main 2026-11-17 14:11:05 +00:00
jschoubben 16316da868 Answer A-474: a module's tests read nothing outside their module 2026-11-17 15:10:52 +01:00
mesh-tools 284c32062e Merge pull request 'Design 47 G: the lead's answer A-473 (the builder asks the tagged publish when its build ends)' (#694) from design/47-G-lead-answers-104 into main 2026-11-17 13:58:33 +00:00
jschoubben 96dadc6fde Answer A-473: the builder asks the tagged publish of a reserved version when its build ends 2026-11-17 14:58:19 +01:00
mesh-tools cc1c5cd5e1 Merge pull request 'Design 47 G: the lead's answer A-472a' (#693) from design/47-G-lead-answers-103 into main 2026-11-17 13:58:03 +00:00
jschoubben a622019bd5 Answer A-472a: the cancel's note stays; the read bound and revisions kept are settings 2026-11-17 14:57:52 +01:00
mesh-tools fa97929f21 Merge pull request 'Design 47 G: the lead's answer A-472 (a pipeline's end is said without waiting on another part)' (#692) from design/47-G-lead-answers-102 into main 2026-11-17 13:49:42 +00:00
jschoubben 76c92e4c1e Answer A-472: a pipeline's end is said without waiting on another part 2026-11-17 14:49:36 +01:00
mesh-tools bdb4efc160 Merge pull request 'Design 47 G: the lead's answer A-471 (a toolchain is agreed by its language version)' (#691) from design/47-G-lead-answers-101 into main 2026-11-17 13:48:18 +00:00
jschoubben 68148d886b Answer A-471: a toolchain is agreed by its language version, the patch not counted 2026-11-17 14:47:57 +01:00
mesh-tools 304ae5a5fb Merge pull request 'Design 47 G: the lead's answer A-470u (a reader that leaves has its wait ended)' (#690) from design/47-G-lead-answers-100 into main 2026-11-17 12:08:34 +00:00
jschoubben aa52fa5345 Answer A-470v: the search blames every refused module, not only the first 2026-11-17 13:08:28 +01:00
jschoubben e671d865d3 Answer A-470u: a reader that leaves or is replaced has its wait ended 2026-11-17 13:08:08 +01:00
mesh-tools 62b03ab4cd Merge pull request 'Design 47 G: the lead's answer A-470t (the runner's ends carry no message id)' (#689) from design/47-G-lead-answers-99 into main 2026-11-17 12:06:11 +00:00
jschoubben 5edbcdac6c Answer A-470t: the runner's ends carry no message id, so A-470q holds as built 2026-11-17 13:06:02 +01:00
mesh-tools 19e7da66d8 Merge pull request 'Design 47 G: the lead's answer A-470s (only build seats are judged for a holder)' (#688) from design/47-G-lead-answers-98 into main 2026-11-17 12:04:03 +00:00
jschoubben c1c7353191 Answer A-470s: only the build seats are judged for a holder at placing 2026-11-17 13:03:55 +01:00
mesh-tools 59cf3c25fd Merge pull request 'Design 47 G: the lead's answers A-470q, A-470r (an end said again has its own message id; a drop ends only owed ends)' (#687) from design/47-G-lead-answers-97 into main 2026-11-17 12:03:41 +00:00
jschoubben cd3428755a Answer A-470q and A-470r: an end said again has its own message id, and a drop ends only the ends owed 2026-11-17 13:03:28 +01:00
mesh-tools 7f846906ee Merge pull request 'Design 47 G: the lead's answer A-470p (a run's end before every other act)' (#686) from design/47-G-lead-answers-96 into main 2026-11-17 11:33:04 +00:00
jschoubben 42e9484261 Answer A-470p: a run's end comes before every other act of its step-ended 2026-11-17 12:32:55 +01:00
mesh-tools 83fab59cac Merge pull request 'Design 47 G: the lead's answer A-470o (an expiry judged by the key's absence)' (#685) from design/47-G-lead-answers-95 into main 2026-11-17 11:25:28 +00:00
jschoubben 384ceb714d Answer A-470o: an expiry is judged by the key's absence, and a run's end is never held behind a finding 2026-11-17 12:25:15 +01:00
mesh-tools 9ea4b009ed Merge pull request 'Design 47 G: the lead's answer A-470n (a run's bound names its ask)' (#684) from design/47-G-lead-answers-94 into main 2026-11-17 11:24:14 +00:00
jschoubben 72bc73df27 Answer A-470n: a run's bound names its ask, so a replaced run's late signal ends nothing 2026-11-17 12:24:05 +01:00
mesh-tools 60e23053c3 Merge pull request 'Design 47 G: the lead's answer A-470m (a reader's end is kept in the key)' (#683) from design/47-G-lead-answers-93 into main 2026-11-17 11:16:54 +00:00
jschoubben d71cbe8b49 Answer A-470m: a reader's end is kept in the key, so a take-up tells a passed reader from a late one 2026-11-17 12:16:40 +01:00
mesh-tools c79c69bfff Merge pull request 'Design 47 G: the lead's answer A-470l (a take-up says no end again for a reader that passed)' (#682) from design/47-G-lead-answers-92 into main 2026-11-17 11:14:54 +00:00
jschoubben 93a3e46923 Answer A-470l: a take-up says no end again for a reader that passed 2026-11-17 12:14:43 +01:00
mesh-tools b269b5f3fa Merge pull request 'Design 47 G-23: causes found on 2026-11-17' (#681) from design/47-G-after-delivery-notes-1117b into main 2026-11-17 11:12:14 +00:00
jschoubben c6943ee76f G-23: the causes found on 2026-11-17 for the assigner's long line, the toolchain disagreement and an untaken merge 2026-11-17 12:12:05 +01:00
mesh-tools 6e43789deb Merge pull request 'Design 47 G: the lead's answer A-470k (the case carries the revision's none)' (#680) from design/47-G-lead-answers-91 into main 2026-11-17 10:59:29 +00:00
jschoubben ff60461f5b Answer A-470k: the case carries the revision's none, so the composer can tell a build that can never be made 2026-11-17 11:58:59 +01:00
mesh-tools 3608c10b5c Merge pull request 'Design 47 G: the lead's answer A-470j (a module that can never be built is blamed)' (#679) from design/47-G-lead-answers-90 into main 2026-11-17 10:56:51 +00:00
jschoubben 10d6d75902 Answer A-470j: a module that can never be built is blamed, not a reason to judge no machine 2026-11-17 11:56:06 +01:00
mesh-tools 16c2f1339c Merge pull request 'Design 47 G: the lead's answer A-470i (a fill names the cap that refuses)' (#678) from design/47-G-lead-answers-89 into main 2026-11-17 10:55:33 +00:00
jschoubben e2e464a046 Answer A-470i: a fill names the cap that refuses, answered by the process that holds it 2026-11-17 11:55:24 +01:00
mesh-tools 8a45d966bd Merge pull request 'Design 47 G: the lead's answer A-470h (a holderless seat's pipeline asks none of its steps)' (#677) from design/47-G-lead-answers-88 into main 2026-11-17 10:54:25 +00:00
jschoubben 8231fd0acb Answer A-470h: a pipeline failed for a holderless seat asks none of its steps 2026-11-17 11:54:15 +01:00
mesh-tools 14a0c6c44f Merge pull request 'Design 47 G: the lead's answer A-470g (no holder fails at once; fill against the cap that refuses)' (#676) from design/47-G-lead-answers-87 into main 2026-11-17 10:51:01 +00:00
jschoubben bb99034295 Answer A-470g: no holder fails at once, and a fill is said against the cap that refuses 2026-11-17 11:50:50 +01:00
mesh-tools fd8c4aaeb7 Merge pull request 'Design 47 G: the lead's answer A-470f (the run drops refuse no caller)' (#675) from design/47-G-lead-answers-86 into main 2026-11-17 10:48:32 +00:00
jschoubben 12a3ef6960 Answer A-470f: the run drops refuse no caller, as every seat verb admits every caller 2026-11-17 11:48:23 +01:00
mesh-tools 79181abfa7 Merge pull request 'Design 47 G: the lead's answers A-470d, A-470e (a rerun carries every reader; a newer run is told by its ask)' (#674) from design/47-G-lead-answers-85 into main 2026-11-17 10:39:29 +00:00
jschoubben 520e95a10c Answer A-470d and A-470e: a rerun carries every reader with its mark, and a newer run is told by its ask 2026-11-17 11:39:20 +01:00
mesh-tools 12b7e246e4 Merge pull request 'Design 47 G: the lead's answers A-470a..A-470c (aging test runs; an untried module never fails; the composer's readings)' (#673) from design/47-G-lead-answers-84 into main 2026-11-17 10:24:26 +00:00
jschoubben 328e17112e Answer A-470a..A-470c: aging test runs, an untried module never fails, the composer's four readings 2026-11-17 11:24:13 +01:00
mesh-tools 36b66c0b54 Merge pull request 'Design 47 G: the lead's answers A-469w..A-470 (caps, settings, waits, bound keys)' (#672) from design/47-G-lead-answers-83 into main 2026-11-17 10:22:16 +00:00
jschoubben f62a73d757 Answer A-469w..A-470: the assigner developer's five questions on caps, settings, waits and bound keys 2026-11-17 11:22:06 +01:00
mesh-tools ff464265b9 Merge pull request 'Design 47 G-23: the faults met on 2026-11-17' (#671) from design/47-G-after-delivery-notes-1117 into main 2026-11-17 10:17:35 +00:00
jschoubben 8884fc9ee7 G-23: the faults met on 2026-11-17, so none is lost before G is delivered 2026-11-17 11:17:23 +01:00
mesh-tools c94cbff169 Merge pull request 'Design 47 G: the lead's answer A-469v (a drop's answer; named run definitions)' (#670) from design/47-G-lead-answers-82 into main 2026-11-17 10:11:37 +00:00
jschoubben 2ed3c5d368 Answer A-469v: a drop's answer names the run and the readers it ended apart, so C1 can go on 2026-11-17 11:11:27 +01:00
mesh-tools 5880f85e5b Merge pull request 'Design 47 G: the lead's answers A-469t, A-469u (one shared form; the four run verbs)' (#669) from design/47-G-lead-answers-81 into main 2026-11-17 10:10:14 +00:00
jschoubben 9bfb8b0211 Answer A-469t and A-469u: one shared form, and the four run verbs' names and answers, so C1 can go on 2026-11-17 11:10:03 +01:00
mesh-tools 9c23309b38 Merge pull request 'Design 47 G: the lead's answers A-468..A-469s (G-24's prepare: 14 design questions, 20 design-meets-code)' (#668) from design/47-G-lead-answers-80 into main 2026-11-17 10:04:16 +00:00
jschoubben e88cce45dd Answer A-468..A-469s: G-24's 14 design questions and 20 design-meets-code entries, so its develop can start 2026-11-17 11:04:04 +01:00
mesh-tools be550d1790 Merge pull request 'Design 47 G: the lead's answer A-467a (a composition step with no machine judged never passes)' (#667) from design/47-G-lead-answers-79 into main 2026-11-17 09:48:03 +00:00
jschoubben 92f967f542 Answer A-467a: a composition step with no machine judged never passes 2026-11-17 10:47:50 +01:00
mesh-tools c2aae05b59 Merge pull request 'Design 47 G: one composition run per candidate and machine, one test run per module's packages (G-24)' (#666) from design/47-G-shared-runs into main 2026-11-17 09:41:41 +00:00
jschoubben cbf12d3380 Merge main (A-467) into the shared-runs design 2026-11-17 10:41:23 +01:00
jschoubben 849a4012d6 Design 47 G: read "no holder" from the seat-holders view, not the seat list
The seat list answers definitions alone (§527); the holders are the seat mesh-module-assigner's
view seat-holders, which the runner now consumes (A-466z).
2026-11-17 10:39:47 +01:00
jschoubben 32302e0bd1 Design 47 G: test 109's line in G-24 names the queued run A-466y keeps 2026-11-17 10:38:51 +01:00
jschoubben 017e20504a Design 47 G: read "no holder" from the seat list, never from five minutes in the queue
A test run queued behind the build capacity with its holder present was ended failed for no
holder after five minutes, which is not true; the queue is §86's finding's and the untaken
bound's to time (A-466y).
2026-11-17 10:38:35 +01:00
jschoubben d7321df3e5 Design 47 G: write in round 2 of the review of the composition runs and test runs
A run's bound times owed progress from the ask's taking, a run never taken ends at a bound of
its own, blame-tries travels in the request, the hand order goes, a test run's output lives
with its key, stands names what a reader waits on, and G-24 reads in number order
(A-466p to A-466x).
2026-11-17 10:37:41 +01:00
mesh-tools e82887d67c Merge pull request 'Design 47 G: the lead's answer A-467 (no composition passes on a machine it did not judge)' (#665) from design/47-G-lead-answers-78 into main 2026-11-17 09:35:27 +00:00
jschoubben 605e0878a5 Answer A-467: a composition step never passes on a machine it did not judge; seats from the trunk while the revision names none 2026-11-17 10:35:05 +01:00
jschoubben cebac2e791 Design 47 G: count both run bounds from the ask's taking, 30 minutes
A bound counted from the asking would end a run that only waited in the queue as could not
run, which is not true; the queue is the build-capacity finding's to time (A-466n).
2026-11-17 10:33:58 +01:00
jschoubben 661fb8a742 Design 47 G: name the runs' asks where they are known, bound the runs, time every reader
The lead's answers A-466m to A-466o: the assigner names the composition runs' asks in its
step-progress, each run's bound is a setting, and since the watchman on main times only a
build seat's running ask, it now times every pipeline step that reads a run, so a reader no
part ends is said as pipeline-stands.
2026-11-17 10:33:22 +01:00
jschoubben 6b7adc5ec2 Design 47 G: write in the review of the composition runs and test runs
The four reviewers by architectural domain found results crossing candidates, a read of a
build seat's state, fixed durations and caps, unstated seat contract fields and a rerun rule
that differed between the two kinds; the lead's answers A-466 to A-466l settle each. The
lines move to a file of their own, G-24, so G-2 stays under its bound. The split of the main
file and G-22 waits until after G, as the operator decided at 10:31 CET.
2026-11-17 10:31:28 +01:00
jschoubben 77318ca60e Design 47 G: a test run asked again moves every step that reads it; two items after G
The coordinator's answers of 2026-11-17: a step left reading a failed result would say what
is no longer true, so a rerun of a test run moves all its readers; the node-engine's
differing input bytes and the split of design 47's main file wait until after G.
2026-11-17 10:25:15 +01:00
jschoubben 31cd62aeec Design 47 G: one composition run per candidate and machine, one test run per tested packages
G's live delivery of 2026-11-17 composed each machine once per pipeline (96 runs for one
revision, 80 more on rerun, the assigner's inputs state at its cap twice) and ran the same
tests once per artifact. Pipelines of one candidate now read one composition run per
machine, kept by the assigner, whose verdict names the modules it blames so one module's
fault fails only its own pipelines; test steps naming the same packages read one test run,
kept by the runner. The operator, 2026-11-17 about 10:20 CET: "In G, now".
2026-11-17 10:24:28 +01:00
mesh-tools 2407183c70 Merge pull request 'Design 47 G: the lead's answer A-465b (the inputs key form is the assigner's own)' (#664) from design/47-G-lead-answers-77 into main 2026-11-17 08:46:28 +00:00
jschoubben 399ac934f6 Answer A-465b: the inputs key form is the assigner's own; an ask's key holds its time; old keys age out 2026-11-17 09:46:15 +01:00
mesh-tools a550fb9256 Merge pull request 'Design 47 G: the lead's answer A-461c (the golden node grant checked against invokes); after G item 14' (#663) from design/47-G-lead-answers-76 into main 2026-11-17 08:40:06 +00:00
jschoubben ec6aae9997 Answer A-461c: the node-engine's golden grant is checked against its invokes; after G: no pass waits on a call 2026-11-17 09:39:53 +01:00
mesh-tools 1ac43e4ddf Merge pull request 'Design 47 G: the lead's answer A-465a (a composition input kept once per content)' (#662) from design/47-G-lead-answers-75 into main 2026-11-17 08:38:18 +00:00
jschoubben cb1ce7291f Answer A-465a: a composition input is kept once per content, shared by the asks that use it 2026-11-17 09:38:02 +01:00
mesh-tools 8fd85c6768 Merge pull request 'Design 47 G: after G, a full delivery cycle by hand (the operator, 2026-11-17)' (#661) from design/47-G-after-hand-cycle into main 2026-11-17 08:23:07 +00:00
jschoubben 0fc357c96b After G: say catalog, the glossary's word 2026-11-17 09:22:54 +01:00
jschoubben d84b7cbb57 After G: a full delivery cycle by hand, as the operator asked on 2026-11-17 2026-11-17 09:22:37 +01:00
mesh-tools 36d5b50d5b Merge pull request 'Design 47 G: the lead's answer A-465 (the assigner's inputs end with their objects)' (#660) from design/47-G-lead-answers-74 into main 2026-11-17 08:00:16 +00:00
jschoubben 64ff3fd4e9 Answer A-465: the assigner's composition inputs end with their objects, and a drop tool for those left 2026-11-17 09:00:02 +01:00
mesh-tools 2b59494c30 Merge pull request 'Design 47 G: the lead's answer A-464e (the gate's start comparison ends only when every head was compared)' (#659) from design/47-G-lead-answers-73 into main 2026-11-17 07:56:55 +00:00
jschoubben 782f90c003 Answer A-464e: the gate's start comparison ends only when every head was compared 2026-11-17 08:56:43 +01:00
mesh-tools f0a940463b Merge pull request 'Design 47 G: the lead's answers A-463a and A-464d (from the review)' (#658) from design/47-G-lead-answers-72 into main 2026-11-17 01:08:47 +00:00
jschoubben 5385c798c0 Answer A-463a and A-464d: a pending merge is not behind, and every source move is forward 2026-11-17 02:08:39 +01:00
mesh-tools cf08f6e69b Merge pull request 'Design 47 G: the lead's answer A-464c (the gate's source moves a head only forward)' (#657) from design/47-G-lead-answers-71 into main 2026-11-17 01:01:11 +00:00
jschoubben 163fe51f96 Answer A-464c: the gate's source moves a head only forward, and only when it changes 2026-11-17 02:00:59 +01:00
mesh-tools c81a186a3d Merge pull request 'Design 47 G: the lead's answer A-464b (a merge the gate did not make)' (#656) from design/47-G-lead-answers-70 into main 2026-11-17 00:57:23 +00:00
jschoubben acd7f1f588 Answer A-464b: what makes a merge one the gate did not make, and where that is said 2026-11-17 01:57:14 +01:00
mesh-tools 6664193aac Merge pull request 'Design 47 G: the lead's answer A-464a (a read tool for the indexer's takeins state)' (#655) from design/47-G-lead-answers-69 into main 2026-11-17 00:50:39 +00:00
jschoubben d47f617ad5 Answer A-464a: a read tool for the indexer's takeins state, so a hand take-in is seen 2026-11-17 01:50:25 +01:00
mesh-tools 84ef09d4b4 Merge pull request 'Design 47 G: the lead's answer A-464 (the gate's source follows every merge)' (#654) from design/47-G-lead-answers-68 into main 2026-11-17 00:43:10 +00:00
jschoubben 709ad9de59 A-464: name mesh-host in a code span, as the words test asks 2026-11-17 01:42:59 +01:00
jschoubben a4d7d44cd0 Answer A-464: the gate's source follows every merge into a watched branch 2026-11-17 01:42:43 +01:00
mesh-tools 47332934b8 Merge pull request 'Design 47 G: the lead's answer A-463 (the indexer takes in a merge it never took in)' (#653) from design/47-G-lead-answers-67 into main 2026-11-17 00:40:25 +00:00
jschoubben b6c99f171d Answer A-463: the indexer takes in a merge it never took in, and says so 2026-11-17 01:40:16 +01:00
mesh-tools e34c74c2f8 Merge pull request 'Design 47 G: A-459b withdraws A-459 and A-459a; A-462b' (#652) from design/47-G-lead-answers-66 into main 2026-11-17 00:32:53 +00:00
jschoubben f44b0fc90b Answer A-459b (withdraw A-459, A-459a: rule 7 reads the node's own composition) and A-462b 2026-11-17 01:32:44 +01:00
mesh-tools c91aafb6dd Merge pull request 'Design 47 G: the lead's answer A-457b (republish-max-versions goes)' (#651) from design/47-G-lead-answers-65 into main 2026-11-17 00:30:28 +00:00
jschoubben 1209008aba Answer A-457b: the builder's republish-max-versions setting goes with the path it bounded 2026-11-17 01:30:16 +01:00
mesh-tools 25449d1d4f Merge pull request 'Design 47 G: the lead's answer A-456b (the release record is bounded; a publish item ends with its release)' (#650) from design/47-G-lead-answers-64 into main 2026-11-17 00:24:02 +00:00
jschoubben dcaad0c6a4 Answer A-456b: the release record is bounded per module; a publish item ends with its release or its reservation 2026-11-17 01:23:38 +01:00
mesh-tools 66b3d0c7f6 Merge pull request 'Design 47 G: correct A-459a (composed is followed through the declared read)' (#649) from design/47-G-lead-answers-63 into main 2026-11-17 00:22:12 +00:00
jschoubben 92929d55ef Correct A-459a: rule 7 follows composed through the read the assigner's manifest declares 2026-11-17 01:22:00 +01:00
mesh-tools 0bb30e6bc9 Merge pull request 'Design 47 G: the lead's answer A-461b (an absent placed build is the trunk build)' (#648) from design/47-G-lead-answers-62 into main 2026-11-17 00:18:06 +00:00
jschoubben e69d2693de Answer A-461b: an absent placed build is the trunk build from mesh-catalog's module verb 2026-11-17 01:17:57 +01:00
mesh-tools b90489afc7 Merge pull request 'Design 47 G: the lead's answer A-460a (ace's refusal was a hand act; no retry added)' (#647) from design/47-G-lead-answers-61 into main 2026-11-17 00:11:52 +00:00
jschoubben bca45ea0df Answer A-460a: ace's refusal was a hand act; a failed install is tried again when its want changes 2026-11-17 01:11:39 +01:00
mesh-tools f48d5f5091 Merge pull request 'Design 47 G: the lead's answers A-456a, A-457a, A-461a' (#646) from design/47-G-lead-answers-60 into main 2026-11-17 00:11:21 +00:00
jschoubben 2ff96d1b7e Answer A-461a: another node's module is laid from the assignment's placed build 2026-11-17 01:11:09 +01:00
jschoubben e68d3a892e Answer A-456a and A-457a: a released build counts as reserved; the publish retries on the builder's own re-ask state 2026-11-17 01:10:59 +01:00
mesh-tools de9d3378af Merge pull request 'Design 47 G: the lead's answer A-462a (no entry in the followed catalog; the assigner asks the indexer nothing)' (#645) from design/47-G-lead-answers-59 into main 2026-11-17 00:10:20 +00:00
jschoubben 547006dd59 Answer A-462a: no entry means none in the followed catalog; the assigner asks the indexer nothing 2026-11-17 01:10:07 +01:00
mesh-tools 2945e57a4a Merge pull request 'Design 47 G: the lead's answer A-459a (rule 7 hears composed per module and fingerprint)' (#644) from design/47-G-lead-answers-58 into main 2026-11-17 00:09:49 +00:00
jschoubben fc5ec32b90 Answer A-459a: rule 7 hears composed per module and fingerprint from the node-engine's events 2026-11-17 01:09:38 +01:00
mesh-tools 242bae0d0c Merge pull request 'Design 47 G: the lead's answers A-454a, A-456..A-462 (the delivery path after a passed pipeline)' (#643) from design/47-G-lead-answers-57 into main 2026-11-17 00:05:31 +00:00
jschoubben 928aa7e5ba Answer A-454a, A-456..A-462: close the delivery path's six gaps after a passed pipeline 2026-11-17 01:05:14 +01:00
mesh-tools 4d4815c83d Merge pull request 'Design 47 G: the lead's answer A-455 (a stale reservation is taken over; builder_reserve_done)' (#642) from design/47-G-lead-answers-56 into main 2026-11-16 23:50:58 +00:00
jschoubben 975f83f045 Answer A-455: a newer trunk build takes over a stale reservation; builder_reserve_done for a done build 2026-11-17 00:50:50 +01:00
mesh-tools acc54c16b9 Merge pull request 'Design 47 G: correct A-453a (a held have has not moved past its hold)' (#641) from design/47-G-lead-answers-55 into main 2026-11-16 23:49:01 +00:00
jschoubben 77cf51b4c7 Correct A-453a: 'at another fingerprint' applies only to a have that is not held 2026-11-17 00:48:47 +01:00
mesh-tools 5f90d599c6 Merge pull request 'Design 47 G: the lead's answer A-454 (an upstream image is no part of the want)' (#640) from design/47-G-lead-answers-54 into main 2026-11-16 23:47:36 +00:00
jschoubben 987283dd30 Answer A-454: an upstream image a manifest pins is no part of the want 2026-11-17 00:47:28 +01:00
mesh-tools 0da67d6323 Merge pull request 'Design 47 G: the lead's answer A-453a (a have mid-move is not 'no longer held')' (#639) from design/47-G-lead-answers-53 into main 2026-11-16 23:46:13 +00:00
jschoubben 2ecb831355 Answer A-453a: a have mid-move is not 'no longer held' 2026-11-17 00:46:04 +01:00
mesh-tools 59d9f397e2 Merge pull request 'Design 47 G: the lead's answer A-453 (a backup ask only for a failed backup)' (#638) from design/47-G-lead-answers-52 into main 2026-11-16 23:37:41 +00:00
jschoubben 7b1607d933 Answer A-453: the operator is asked about a backup only when a backup failed 2026-11-17 00:37:32 +01:00
mesh-tools bfc7272b3c Merge pull request 'Design 47 G after delivery: retire held/kept for a module left on its build; hollow composition pass' (#637) from design/47-G-after-words into main 2026-11-16 23:17:48 +00:00
jschoubben 37fdc292f7 After G: retire held and kept for a module left on its build; a composition that judged nothing is no pass 2026-11-17 00:17:38 +01:00
mesh-tools 21ab7b1bdf Merge pull request 'Design 47 G: the lead's answer A-452 (an unanswered requirement costs its consumer, not the machine)' (#636) from design/47-G-lead-answers-51 into main 2026-11-16 23:15:03 +00:00
jschoubben e17cffa59e Answer A-452: an unanswered requirement costs its consumer, not the machine 2026-11-17 00:14:46 +01:00
mesh-tools dcdfbc12a6 Merge pull request 'Design 47 G: the lead's answer A-451 (composition with a node-engine not heard running)' (#635) from design/47-G-lead-answers-50 into main 2026-11-16 13:53:44 +00:00
jschoubben 7dd6563ab5 Answer A-451: a machine whose node-engine is not heard running composes with the revision's node-engine entry 2026-11-16 14:53:14 +01:00
mesh-tools eb5cc23a86 Merge pull request 'Design 47 G: the lead's answer A-237c (inline input stays for the checker until G)' (#634) from design/47-G-lead-answers-49 into main 2026-11-16 13:47:23 +00:00
jschoubben d07de2840d Answer A-237c: the token-less inline input stays for the checker until G removes it 2026-11-16 14:47:11 +01:00
mesh-tools 2ab0507440 Merge pull request 'Design 47 G: the lead's answer A-237b (compose-candidate sends its input in chunks)' (#633) from design/47-G-lead-answers-48 into main 2026-11-16 13:35:32 +00:00
jschoubben c47f9ea48e Answer A-237b: compose-candidate sends its input in chunks 2026-11-16 14:35:22 +01:00
mesh-tools dd462aa1ff Merge pull request 'Design 47 G: the lead's answer A-450 (the node-engine's account in the catalog's caller check)' (#632) from design/47-G-lead-answers-47 into main 2026-11-16 13:12:41 +00:00
jschoubben c0736710e8 Answer A-450: the node-engine's account counts as the module holding node-engine for the catalog's caller check 2026-11-16 14:12:28 +01:00
mesh-tools bedc92e251 Merge pull request 'Design 47 G: the lead's answer A-226c (a run's key reads candidates.run-<id>)' (#631) from design/47-G-lead-answers-46 into main 2026-11-16 12:59:58 +00:00
jschoubben d93dddf5b3 Answer A-226c: a run's key reads candidates.run-<id> 2026-11-16 13:59:47 +01:00
mesh-tools 2a52d91cc6 Merge pull request 'Design 47 G: the lead's answer A-226b (compose-candidate reads a revision key and a run key)' (#630) from design/47-G-lead-answers-45 into main 2026-11-16 12:55:03 +00:00
jschoubben ecaf070846 Answer A-226b: compose-candidate reads a branch revision key and a run key too 2026-11-16 13:54:52 +01:00
mesh-tools 2631a11447 Merge pull request 'Principles 11 and 12, and the reviewers ask them' (#629) from principles/configurable-and-own-files into main 2026-11-16 12:53:40 +00:00
jschoubben 39f7ae7203 Reviewers: a hard-coded value and a file written for another module are findings (principles 11 and 12) 2026-11-16 13:53:30 +01:00
jschoubben 6517bbebf0 Principles 11 and 12: configurable, never hard-coded; a module writes only its own 2026-11-16 13:51:28 +01:00
mesh-tools 4de493a784 Merge pull request 'Design 47 G: the lead's answer A-449a (the indexer pins a take-in's revision for its pipelines)' (#628) from design/47-G-lead-answers-44 into main 2026-11-16 12:44:33 +00:00
jschoubben 79214618f3 Answer A-449a: the indexer pins a take-in's revision for its pipelines when it keeps it 2026-11-16 13:44:23 +01:00
mesh-tools 8fa037074c Merge pull request 'Design 47 G: the lead's answers A-448 and A-449 (a take-in names its revision; a pipeline pins it)' (#627) from design/47-G-lead-answers-43 into main 2026-11-16 12:33:23 +00:00
jschoubben f07c337c22 Answer A-448 and A-449: a take-in names its revision; a pipeline pins it 2026-11-16 13:33:12 +01:00
mesh-tools d595d08042 Merge pull request 'After G: tests against the composed bus, kept events heard or loud, one way of asking work' (#626) from design/47-G-after-list-2 into main 2026-11-16 12:01:14 +00:00
jschoubben eaa6de7faf After G: tests against the composed bus, kept events heard or loud, one way of asking work 2026-11-16 13:01:03 +01:00
mesh-tools 2d4b34c51c Merge pull request 'Design 47 G: the lead's answer A-447e (the checker is removed at G, not rebuilt per module)' (#625) from design/47-G-lead-answers-42 into main 2026-11-16 10:39:32 +00:00
jschoubben d4c31d4ff0 Answer A-447e: the checker is removed at G, not rebuilt per module; the no-dir refusal lands with its removal 2026-11-16 11:39:23 +01:00
mesh-tools 71cb172953 Merge pull request 'Design 47 G: the lead's answer A-447d (the checker fetches per changed module)' (#624) from design/47-G-lead-answers-41 into main 2026-11-16 10:38:20 +00:00
jschoubben fa74c6d594 Answer A-447d: the checker fetches per changed module 2026-11-16 11:38:10 +01:00
mesh-tools 97c8c81e82 Merge pull request 'Principle 10: the module is the unit, never the repository' (#623) from principles/module-is-the-unit into main 2026-11-16 10:35:37 +00:00
jschoubben b5e5a35460 Principle 10: a merge moves only the modules it changes 2026-11-16 11:35:33 +01:00
jschoubben 3c0389f74e Principle 10: the module is the unit, never the repository 2026-11-16 11:32:32 +01:00
mesh-tools 99e2966bb7 Merge pull request 'Design 47 G: the lead's answer A-447c (nothing is ever repository-based)' (#622) from design/47-G-lead-answers-40 into main 2026-11-16 10:31:45 +00:00
jschoubben 42054c599c Answer A-447c: nothing in building, checking or delivering works on a repository 2026-11-16 11:31:35 +01:00
mesh-tools f887e777b2 Merge pull request 'Design 47 G: the lead's answer A-447b (a build is always for one module)' (#621) from design/47-G-lead-answers-39 into main 2026-11-16 10:30:14 +00:00
jschoubben bc9ba62959 Answer A-447b: a build, a step and a check are always for one module; a fetch with no dir is refused 2026-11-16 11:30:04 +01:00
mesh-tools 4353e7c018 Merge pull request 'Design 47 G: the lead's answer A-447a (a module whose directory holds no go.mod; an empty choice fails)' (#620) from design/47-G-lead-answers-38 into main 2026-11-16 10:15:43 +00:00
jschoubben ca8cda69d9 Answer A-447a: a module whose directory holds no go.mod takes the go.mod files under it; an empty choice fails 2026-11-16 11:15:34 +01:00
mesh-tools a7b72d49d2 Merge pull request 'Design 47 G: the lead's answer A-447 (a Go fetch asked with a module's directory resolves that module alone)' (#619) from design/47-G-lead-answers-37 into main 2026-11-16 10:00:19 +00:00
jschoubben 2c399ac708 Answer A-447: a Go fetch asked with a module's directory resolves that module and its local replaces alone 2026-11-16 11:00:04 +01:00
mesh-tools 8c307e0e7a Merge pull request 'Design 47 G: A-446a, what goes with the runner's set-aside' (#618) from design/47-G-lead-answers-36 into main 2026-11-16 09:35:06 +00:00
jschoubben 2d6da3f34d Answer A-446a: a placed pipeline says pipeline-started; what only the set-aside used goes 2026-11-16 10:34:59 +01:00
mesh-tools 45b43ce81c Merge pull request 'Design 47 G: A-446, the pipeline runner holds no pipeline for its own new version' (#617) from design/47-G-lead-answers-35 into main 2026-11-16 09:25:12 +00:00
jschoubben 13ad18268f Answer A-446: the pipeline runner holds no pipeline for its own new version (the operator) 2026-11-16 10:25:02 +01:00
mesh-tools 5be43e0193 Merge pull request 'Principles: no part without a need (7); depend on the contract, at the level it is interchangeable (9)' (#616) from principles/contract-and-no-part-without-need into main 2026-11-16 09:06:33 +00:00
jschoubben 4e0f340916 Principles: 7 becomes 'no part without a need', 9 'depend on the contract, at the level it is interchangeable' (the operator, 2026-11-16) 2026-11-16 10:06:25 +01:00
mesh-tools 12c0f66fab Merge pull request 'After G: the module graph's edges are dependencies, never verbs' (#615) from design/47-G-after-delivery-2 into main 2026-11-16 08:57:25 +00:00
jschoubben 6ccd7c3edf After G: the module graph's edges are dependencies on a seat or a module, never verbs or bus subjects (the operator) 2026-11-16 09:57:18 +01:00
mesh-tools ea02e537a3 Merge pull request 'Design 47 G: the lead's answer A-445 (the bus keeper's start path)' (#614) from design/47-G-lead-answers-34 into main 2026-11-16 08:52:04 +00:00
jschoubben 60872e67e9 Answer A-445: the bus keeper's A-376 path and its four manifest lines go 2026-11-16 09:51:57 +01:00
mesh-tools 9cf4d63c9c Merge pull request 'Design 47 G: what is owed once G is delivered' (#613) from design/47-G-after-delivery into main 2026-11-16 08:46:19 +00:00
jschoubben 1a2d31b82f Keep what is owed once G is delivered in hq, not in a session's memory 2026-11-16 09:46:13 +01:00
mesh-tools 267f1ef0de Merge pull request 'Design 47 G: the lead's answer A-443a (a given-up publish step)' (#612) from design/47-G-lead-answers-33 into main 2026-11-16 08:42:19 +00:00
jschoubben 23cba849e3 Answer A-443a: a given-up publish step's call ends at the SDK's own bound and is said 2026-11-16 09:42:12 +01:00
mesh-tools 3723b2ea41 Merge pull request 'Design 47 G: the lead's answers A-394 and A-434 to A-444 (the start fixes' review)' (#611) from design/47-G-lead-answers-32 into main 2026-11-16 08:38:26 +00:00
jschoubben 62e3715af4 Answer A-394 and A-434 to A-444: the start fixes' review questions, each against a principle or the operator's word 2026-11-16 09:38:16 +01:00
mesh-tools 18ce04f6e8 Merge pull request 'Design 47 G: the lead's answers A-363 to A-372 (G starts)' (#609) from design/47-G-lead-answers-31 into main 2026-11-16 08:24:38 +00:00
jschoubben 91f60c7075 Use the glossary's words in lead answers 31, so the words test passes 2026-11-16 09:24:19 +01:00
jschoubben 4169ded5cd Answer A-433: before the catalog half is read, a module account's call runs unmarked, seat verbs too 2026-11-16 02:34:22 +01:00
jschoubben d9dd5dab67 Answer A-432: a runtime of its own runs the tool runner's program, which §524's check of the module's parts leaves out 2026-11-16 01:00:35 +01:00
jschoubben 2829a47ea0 Answer A-431: a take-in names the source revision it makes, one above the newest seen or said 2026-11-15 17:51:01 +01:00
jschoubben 09cf7d609d Answer A-430b: a branch build is named by the version the builder reserved; build.ended carries it and the registry tags it unreleased 2026-11-15 16:48:29 +01:00
jschoubben 547eec3373 Answer A-430a: every wanted build has a version; the node-engine resolves artifacts by version through the registry's versions verb 2026-11-15 16:44:17 +01:00
jschoubben d2094f657e Answer A-430: a want names the module version; the node-engine fetches the artifacts by that version (the operator) 2026-11-15 16:43:23 +01:00
jschoubben ee80b4d84b Answer A-426a: every rule waiting on a serving part counts any healthy running build that serves it 2026-11-15 16:17:01 +01:00
jschoubben 14c3e90332 Answer A-429: a released build is done for rule 1 2026-11-15 16:13:29 +01:00
jschoubben cac334e749 Narrow A-428: only the pipeline runner's own want skips the passed-pipeline gate while no runner runs 2026-11-15 16:04:05 +01:00
jschoubben aad8f7c921 Answer A-428: with no pipeline runner running, wants do not wait for a passed pipeline 2026-11-15 16:03:56 +01:00
jschoubben b20b382cd9 Answer A-426 (an acting wait ends on any running build that serves the edge) and A-427 (a put may hold the running build) 2026-11-15 15:56:51 +01:00
jschoubben 8abbb539fd Answer A-425a: which proposals are asked is the assigner's config key ask-operator-for 2026-11-15 15:55:34 +01:00
jschoubben f988c23d1e Answer A-425: a passing placement proposal is applied without the operator's ask (the operator, 2026-11-15) 2026-11-15 15:54:46 +01:00
jschoubben fd45f01929 Answer A-424: the operator channel keeps no limit of open asks per asker (the operator, 2026-11-15) 2026-11-15 15:49:03 +01:00
jschoubben f0b9c73a9f Answer A-423: one reader per durable through the hub; a consumed kept event with no route is said 2026-11-15 03:52:41 +01:00
jschoubben 17ab2d028e Answer A-422: the SDK's event hub binds the kept seat streams in its own start 2026-11-15 03:48:47 +01:00
jschoubben 9a60a312a0 Answer A-421: a trunk entry with no fp-src is matched to its release by the digests its build made 2026-11-15 03:17:45 +01:00
jschoubben 1de67e76ed Answer A-419 (release matched by the fingerprint's source) and A-420 (a message given up is said) 2026-11-15 03:14:06 +01:00
jschoubben 1088d86e5c Answer A-418: a bundle's or archive's name for reserved is <module>/<artifact> from its entry's artifact reference 2026-11-15 02:59:19 +01:00
jschoubben 2ce9268504 Answer A-417: a registry holder tags a version on the artifact it holds by digest, else takes it from the artifact store 2026-11-15 02:37:16 +01:00
jschoubben 39ab7efb6b Answer A-416a: the builder reads a registry seat's holder from the catalog's seat holders, not FollowSeat 2026-11-15 02:17:33 +01:00
jschoubben 6c5f8aabb0 Answer A-416: the builder knows a registry seat's holder through FollowSeat, not from running events since its start 2026-11-15 02:16:18 +01:00
jschoubben 3d56f25942 Answer A-415: a published heard before the build's digests is kept on its reservation and marks it when the digests land 2026-11-15 02:05:05 +01:00
jschoubben 9da181e12d Answer A-414: the grants part composes a module whose running build has no entry from its newest entry, as A-407 does for the node 2026-11-15 00:23:25 +01:00
jschoubben 8b9b450855 Answer A-413: named asks are unused only while no account the part composes may publish one 2026-11-15 00:03:35 +01:00
jschoubben 16f4fd8696 Answer A-412a: the entry's digest readings live in the mesh-catalog contract 2026-11-14 23:44:50 +01:00
jschoubben ee543b8601 Answer A-412: the builder takes the entry's manifest digest bare, and a look that writes nothing says why 2026-11-14 23:44:11 +01:00
jschoubben 7981d72d9b Answer A-411: the builder reads the last versions-filled from the seat event's kept stream, not EVENTS 2026-11-14 23:37:07 +01:00
jschoubben 842071859a Answer A-410: a running module the node cannot fingerprint is held, never counted as removed 2026-11-14 23:14:41 +01:00
jschoubben 11054da240 Answer A-409: a consumed seat event matches by name and filters on the seat's subject; the revision's id names its branch 2026-11-14 22:51:41 +01:00
jschoubben 46b6b74148 Answer A-408: the builder reads the kept versions-filled at its start 2026-11-14 22:47:32 +01:00
jschoubben 706e76b566 Answer A-407: a running build with no entry is described for resolving by the entry of the build its want says is being built 2026-11-14 22:46:19 +01:00
jschoubben 4b2eb0bcf4 Answer A-405 and A-406: a node composes around a running build with no entry; the pipeline's manifest passes the judge and is built once by hand 2026-11-14 22:42:00 +01:00
jschoubben 634b4ea49e Answer A-404: a source the gate started from the forge names no group in its source-moved 2026-11-14 22:16:04 +01:00
jschoubben b6380d0958 Answer A-403: the gate adds a registered repository a held source key lacks, and changes no head it holds 2026-11-14 22:08:40 +01:00
jschoubben dbe9d711ea Answer A-402: a head is read whole on any failure to read its merged message 2026-11-14 22:08:11 +01:00
jschoubben de9f6d3353 Answer A-401: a newly watched branch starts from the forge at its head, as a clone does 2026-11-14 22:05:17 +01:00
jschoubben d5e7d42d17 Answer A-400: seat-holders names the assigned claimant of a seat no assignments holds 2026-11-14 20:21:29 +01:00
jschoubben 232454cf76 A-397: the rule is the developer's judgement (share a durable only for shared work), not an operator ruling 2026-11-14 18:51:53 +01:00
jschoubben f55a6e7927 Answer A-399: a seat pulled by kind's holder says the seat's own events 2026-11-14 18:39:47 +01:00
jschoubben f6f82721d5 Answer A-398: a seat-form read resolves to the assigned claimant when no holder is on record 2026-11-14 18:17:34 +01:00
jschoubben 98e8bc395b A-397: the operator's decision time read from the clock 2026-11-14 18:03:19 +01:00
jschoubben ed95207361 Answer A-397: every process that hears events has a durable consumer of its own, named constantly; a shared one split the first registrations between the assigner's program and its tool runner 2026-11-14 18:02:11 +01:00
jschoubben 525a9590cd Answer A-396: every module is composed as invoking the tool runner's own reads
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 12:09:52 +01:00
jschoubben 6bc258db0d Answer A-395: every trunk part and the tool runner may read the catalog half
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 12:00:53 +01:00
jschoubben 5f04a5e3af Answer A-393: a node seat's verb asked with no machine is answered by any one holder
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 11:31:09 +01:00
jschoubben 087e17c799 Answer A-392: a seed asks a silent build seat once, and says so
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 11:24:49 +01:00
jschoubben 19f5ad86d2 Answer A-391: the indexer's start replay writes the view once, and says its length
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 04:03:00 +01:00
jschoubben 5d7a96fe66 Answer A-390: the verb revision's callers count an invokes of a single *, as grants reads it
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 03:19:13 +01:00
jschoubben 5aa4510f0f Answer A-389: before the catalog half is read, a module's call of another module's tool runs unmarked, logged
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 02:36:55 +01:00
jschoubben c1a647e9bb Answer A-388: the start path takes only an explicit read class; the broker's four reads are classed
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 02:22:16 +01:00
jschoubben 8dffde7f33 Answer A-387: before the catalog half is read, a read verb of a held definition runs; git is bootstrapped
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 02:20:39 +01:00
jschoubben 240f6401ce Answer A-386: a runner kept as it runs still gains the runner grants of what it carries
mesh/delivery ready: it is merged on the Approve
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 01:32:07 +01:00
jschoubben 77a6a9aa68 Answer A-385: a kept account is the union of the list in force and this pass's composition
mesh/delivery closed: a newer head of the same pull request
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 01:06:35 +01:00
jschoubben 9e619006c7 Answer A-384: a runner may make the ordered consumers its bundles hear new events on
mesh/delivery closed: a newer head of the same pull request
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 00:43:18 +01:00
jschoubben 8af69b2082 Answer A-383: a right every account carries reaches a kept account too
mesh/delivery closed: a newer head of the same pull request
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 00:22:48 +01:00
jschoubben 2c67b2e53b Answer A-382: every account may list stream names, which hearing an event starts with
mesh/delivery closed: a newer head of the same pull request
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-14 00:06:50 +01:00
jschoubben be264026b5 Answer A-381: grants' own account may list stream names, which its stream assertion starts with
mesh/delivery closed: a newer head of the same pull request
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 23:59:02 +01:00
jschoubben a95c0d6d98 Answer A-380: the runner's old-objects fallback uses the name grants creates
mesh/delivery closed: a newer head of the same pull request
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 23:18:26 +01:00
jschoubben c1065d9868 Answer A-379: the runner reaches a module's old objects by the name its membership gives, beside bindings
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 23:15:17 +01:00
jschoubben 0e9b6e5286 Answer A-377 and A-378: first-view tools pass the start path; the keeper may read the indexer's views
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 23:12:47 +01:00
jschoubben 64b9ffe8c1 Answer A-376: the keeper makes the catalog holder's own bus state before its catalog half is in
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 23:01:04 +01:00
jschoubben c5adb7fe48 Answer A-375: the gate's start path also lets the bindings' first view through
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 22:46:43 +01:00
jschoubben 61149124f8 Answer A-374: the seat verb withheld reads a small key beside the list
mesh/delivery closed: a newer head of the same pull request
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 22:10:26 +01:00
jschoubben 591297f02e Answer A-373: grants keeps its user list and pass in an object store, since they outgrow one bucket value
mesh/delivery closed: a newer head of the same pull request
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 22:00:46 +01:00
jschoubben e9a2aaf253 Answer A-371 and A-372: grants counts a seat stream it creates itself as empty, and the assigner asks Ready
mesh/delivery closed: a newer head of the same pull request
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 20:54:05 +01:00
jschoubben 904f5bfac5 Answer A-370: the indexer answers the catalog's first views at once, never behind a running take-in
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 20:53:47 +01:00
jschoubben da161cdbf1 Answer A-369: grants' catalog wait asks the client's Ready, as every part does
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 20:45:09 +01:00
jschoubben 916be3a63c Answer A-363 to A-368: G's first start composes rights from the trunk, builds unpublished packages at the source commit, and waits for nothing only G answers
Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
2026-11-13 20:34:47 +01:00
12 changed files with 1756 additions and 23 deletions
+4
View File
@@ -26,6 +26,10 @@ questions are.
- an interaction the design does not place that is not a mesh path: one module naming another, reading another's - an interaction the design does not place that is not a mesh path: one module naming another, reading another's
internals or being special-cased in another part; a module's name in shared code; state only in memory; a poll or internals or being special-cased in another part; a module's name in shared code; state only in memory; a poll or
a timer where an event exists; a timer where an event exists;
- a value written into the code that can differ between machines, modules or over time (a port, a path, a bound, a
cap, a name, a time) and is not a setting with a default (principle 11); name the setting it should be, eagerly;
- a module that writes another module's file or state, or anything in another module's place, instead of giving it
through a provision or a contribution that module declares (principle 12);
- an effect or a reader of the build map's `What exists today` whose fate the diff does not carry out (run its - an effect or a reader of the build map's `What exists today` whose fate the diff does not carry out (run its
searches again on the reviewed tree), or one the search finds and the answer omits; searches again on the reviewed tree), or one the search finds and the answer omits;
- a test that does not fail without its change (check it by taking the change out in a copy), an acceptance - a test that does not fail without its change (check it by taking the change out in a copy), an acceptance
+3
View File
@@ -25,6 +25,9 @@ write.
What you judge: What you judge:
- Seams: where each piece of state lives on the bus (key-value bucket, stream, object store) and which module owns it; which seat, verb or event joins two parts; any link that is not NATS-native (a poll, a timer, HTTP between modules, a shared file, state only in memory); whether a form the manifest lacks is named with its cost (a mesh-sdk change rebuilds every module). - Seams: where each piece of state lives on the bus (key-value bucket, stream, object store) and which module owns it; which seat, verb or event joins two parts; any link that is not NATS-native (a poll, a timer, HTTP between modules, a shared file, state only in memory); whether a form the manifest lacks is named with its cost (a mesh-sdk change rebuilds every module).
- Settings and ownership: every value that can differ between machines, modules or over time is a setting with a
default, never hard-coded (principle 11), and the design names it; no module writes another module's file or state:
what one module needs from another goes through a provision or a contribution that module declares (principle 12).
- Tools: for every new piece of state a tool that reads it, and for every new behaviour a tool that steers it (do by hand, ask again, drop, repair, re-check), as the instruction tools-are-how-a-module-is-spoken-to says. - Tools: for every new piece of state a tool that reads it, and for every new behaviour a tool that steers it (do by hand, ask again, drop, repair, re-check), as the instruction tools-are-how-a-module-is-spoken-to says.
Judge only whether the settled direction or design is complete and sound in your two architectural domains, Judge only whether the settled direction or design is complete and sound in your two architectural domains,
+9
View File
@@ -620,6 +620,15 @@ controller (the planner, the rollout) until release 6 of ADR 0429; from each rel
- **composition step** — the pipeline step that composes each machine's declaration with a change, by the composer built - **composition step** — the pipeline step that composes each machine's declaration with a change, by the composer built
from its heads in the sandbox, refusing a change in which two modules own one path; served by the seat `mesh-wants` from its heads in the sandbox, refusing a change in which two modules own one path; served by the seat `mesh-wants`
(ADR 0666 §17). From milestone G's delivery it replaces the **composition check**. (ADR 0666 §17). From milestone G's delivery it replaces the **composition check**.
- **composition run** — the one run of the composer for one candidate on one machine, started by the first
composition step of that candidate that needs the machine and kept by the assigner in its state `composition-runs`;
every composition step of the candidate whose module is placed on the machine reads its verdict (design 47 G §718).
Not a **composition**, one module's resources composed for one node; nor the **composition step**, the pipeline
step that reads one composition run per machine.
- **test run** — the one run of a lint, unit test or integration test pipeline step for one candidate, one level and
one set of tested packages at their digests, kept by the runner in its state `test-runs`; every artifact's pipeline step of that candidate
naming the same packages reads its result (design 47 G §724). Not a **pipeline step**, each artifact's own, nor a **run
on request**, a whole pipeline that delivers nothing.
- **merge check** — what a pull request carries before it may merge, judging the merge of its head into a - **merge check** — what a pull request carries before it may merge, judging the merge of its head into a
named **trunk commit**, made in a clone of its own on a build node and never pushed (ADR 0323). One status, named **trunk commit**, made in a clone of its own on a build node and never pushed (ADR 0323). One status,
`mesh/check`, written by the checker: the change's tests, run by the language's build module, and the `mesh/check`, written by the checker: the change's tests, run by the language's build module, and the
+12 -3
View File
@@ -1,6 +1,6 @@
--- ---
status: canonical status: canonical
updated: 2026-11-11 updated: 2026-11-16
--- ---
# The principles # The principles
@@ -22,9 +22,18 @@ add, sharpen or drop a principle in a pull request to this file.
6. **Nothing is exposed publicly.** No data leaves the mesh unasked: no secret in a record, a log or a public 6. **Nothing is exposed publicly.** No data leaves the mesh unasked: no secret in a record, a log or a public
repository, no service reachable from outside unless it is meant to be. Inside the mesh, every agent and module repository, no service reachable from outside unless it is meant to be. Inside the mesh, every agent and module
is trusted; who may do what is not a question to ask. is trusted; who may do what is not a question to ask.
7. **The simplest thing that works.** Prefer what already exists. No new mechanism unless it is needed, and fewer 7. **No part without a need.** Every mechanism, field, seat and step exists because something needs it; prefer what
parts over more. exists over a new one, and remove what no longer serves. Never a shortcut instead of the right shape.
8. **One word per thing**, from the [glossary](glossary.md). 8. **One word per thing**, from the [glossary](glossary.md).
9. **Depend on the contract, at the level it is interchangeable.** A module depends on a seat where the mesh means
more than one module to be able to fill the need, and on a module where only that module does; never on another
module's internals.
10. **The module is the unit.** Everything is done per module, never per repository. A repository is only where a
module's files are kept; a merge moves only the modules it changes.
11. **Configurable, never hard-coded.** A value that can differ between machines, modules or over time (a port, a
path, a bound, a cap, a name, a time) is a setting with a default, never written into the code.
12. **A module writes only its own.** A module writes its own files and state alone; what another module needs from it
goes through a provision or a contribution that module declares, never a file written in its place.
How it is checked: the one code review of a milestone checks the code against these principles and the design's How it is checked: the one code review of a milestone checks the code against these principles and the design's
shape; an answer to a develop question names the principle that settles it. shape; an answer to a develop question names the principle that settles it.
@@ -2,7 +2,7 @@
layer: to-be layer: to-be
status: in-progress status: in-progress
code: [mesh-controller, mesh-catalog modules/mesh-delivery-gate, mesh-catalog modules/gitea, mesh-delivery, mesh-host, mesh-sdk, mesh-vault, mesh-contracts, mesh-tools, mesh-networking, hq 00-META/checks] code: [mesh-controller, mesh-catalog modules/mesh-delivery-gate, mesh-catalog modules/gitea, mesh-delivery, mesh-host, mesh-sdk, mesh-vault, mesh-contracts, mesh-tools, mesh-networking, hq 00-META/checks]
updated: 2026-11-11 updated: 2026-11-17
decisions: decisions:
- "ADR 0673" - "ADR 0673"
- "ADR 0672" - "ADR 0672"
@@ -1972,6 +1972,27 @@ ADR 0667's checks, of milestone G itself:
`condition-raised` (whole, condition keeper and a fixture observer, mesh-catalog and mesh-sdk). Live: after G's `condition-raised` (whole, condition keeper and a fixture observer, mesh-catalog and mesh-sdk). Live: after G's
delivery, a node-engine restarted with the full seat list clears its `seat-list-unread`, read with delivery, a node-engine restarted with the full seat list clears its `seat-list-unread`, read with
`mesh-conditions.conditions`. `mesh-conditions.conditions`.
108. **One composition run per candidate and machine** (design 47 G §718 to §723, §727 to §733). Two composition
steps of one candidate started at once make one key, one request and one run ask; three steps of one revision on
two machines start two runs, each step reading both verdicts. A machine whose verdict blames one module fails that
module's composition step alone and says it as a warning in the others; a verdict with no `blamed` is judged as
today, naming no culprits. A run with no `step-ended` within its bound ends `could not run` with its readers; steps
asked again together start one run per machine that did not pass and move every former reader, a reopened
pipeline saying `pipeline-ended` again; a run that keeps saying its progress past 30 minutes is not ended, and a
taken ask silent for 30 minutes ends `could not run`. Both drop tools end
the readers, and a reader-only account calling one is refused (whole, assigner and the node-engine's composer,
mesh-delivery and `mesh-host`). Live: in the first publish after G's delivery, the composition run asks of a
revision number at most its machines, read with `assigner_compositions` and `assigner_inputs`.
109. **One test run per level and tested packages** (design 47 G §724 to §733). A module whose program and tools
bundle test one directory runs its unit and integration tests once per level, both artifacts' pipeline steps
ending with that result and naming it in `shared`, a failing test failing once, and `pipeline-ended` counting the
module's tests once. A rerun that passes moves both artifacts' steps and the pipeline ends again; a runner
restarted during a run takes it up again; a replaced reader leaves the ask to the others; at the cap a step ends
`could not run` naming the fill; a second revision with the same digests runs a failed test again; a test run queued past five minutes with a
holder present is not failed (design 47 G A-466y) (whole, runner
and Go build module, mesh-delivery and mesh-catalog). Live: each module's test steps run once per level, read with
`runner_test_runs`. A reader no part ends raises `pipeline-stands` within five minutes of its last sign of life
(whole, watchman; design 47 G §732).
## What retires ## What retires
@@ -384,12 +384,15 @@ that round are written into the lines they name, here. Questions that an earlier
- §535 **A missing build seat and a seat with no holder, each read where it shows.** The runner reads that no build - §535 **A missing build seat and a seat with no holder, each read where it shows.** The runner reads that no build
seat serves an artifact's language from the catalog half of its revision view: no entry whose `acts`, the acting seat serves an artifact's language from the catalog half of its revision view: no entry whose `acts`, the acting
rules of the seats it claims, hold a rule `build` with `on` naming that language (§323); the pipeline then ends rules of the seats it claims, hold a rule `build` with `on` naming that language (§323); the pipeline then ends
failed at once, naming the language and the missing build seat. It reads that a seat has no holder from the step failed at once, naming the language and the missing build seat. *Amended by A-466y and A-466z (2026-11-17):* it reads that
itself: an ask on that seat's work queue whose `step-started` is not heard within five minutes ends the pipeline a seat has no holder only when the seat `mesh-module-assigner`'s view `seat-holders` names none for it (G-21 §717's
failed, naming the seat (§32). It reads neither from the seat list, which answers definitions alone (§527), nor follower; never the seat list, which answers definitions alone, §527), and a seat with none ends the pipeline failed
from any holding. Why: §32 already ends a pipeline whose step nothing starts, and the catalog half is the runner's at once, naming it; an ask waiting for an existing holder is timed by §86's `build-capacity-waits` and A-466s's
one view (develop question Q-RN7). How it is checked: whole (runner), a fixture language with no build seat ends at `run-untaken-bound` (G-24 §720, §725), never by five minutes from the ask. Why: §32 already ends a pipeline whose
once, naming it; a seat whose holder is stopped ends within five minutes, naming the seat. step nothing starts, and the catalog half is the runner's one view (develop question Q-RN7); a queued step ended
failed for "no holder" while its holder is present would say what is not true (principle 3). How it is checked:
whole (runner), a fixture language with no build seat ends at once, naming it; a seat the seat-holders view names
no holder for ends at once, naming the seat; a step queued past five minutes with a holder present is not failed.
- §539 **The runner's tools are named `runner_`.** The runner's module, `mesh-delivery-pipeline`, names its tools with - §539 **The runner's tools are named `runner_`.** The runner's module, `mesh-delivery-pipeline`, names its tools with
the prefix `runner_`, so the design's `runner_catch_up`, `runner_waits`, `runner_release` and `runner_health` the prefix `runner_`, so the design's `runner_catch_up`, `runner_waits`, `runner_release` and `runner_health`
stand, and its first-view tool is `runner_first_views`; `<module>_first_views` (§205) carries the prefix the stand, and its first-view tool is `runner_first_views`; `<module>_first_views` (§205) carries the prefix the
@@ -378,9 +378,17 @@ for several build maps is answered once, and the maps' names for it are given in
- §646 **The runner's bodies name `fingerprint`.** (§585) The runner's `step-ended`, pipeline and wait bodies name the - §646 **The runner's bodies name `fingerprint`.** (§585) The runner's `step-ended`, pipeline and wait bodies name the
build-input fingerprint `fingerprint`, not `fp`, as §585 reads it. [mesh-delivery DQ-2.] How it is checked: unit build-input fingerprint `fingerprint`, not `fp`, as §585 reads it. [mesh-delivery DQ-2.] How it is checked: unit
(runner's contract). (runner's contract).
- §647 **The runner times an ask from `ask-taken`.** (§535, §602) §535's five minutes run from the ask until the build - §647 **The runner times an ask from `ask-taken`.** (§535, §602; A-466y) The runner consumes the build seat holder's
seat holder's `ask-taken` (§602), which the runner consumes; `step-started` is the runner's own. [mesh-delivery `ask-taken` (§602); `step-started` is the runner's own. *Amended by A-466y and A-466z (2026-11-17):* §535's five
DQ-3.] How it is checked: whole (runner), an ask no holder takes ends its pipeline after the setting. minutes from the ask until `ask-taken` go. A seat for which the seat `mesh-module-assigner`'s view `seat-holders`
names no holder ends the pipeline failed at once, naming it, judged only once that view's first view is read, never
from the not-ready picture `FollowSeat` answers before it (principle 3). The runner's manifest gains the `consumes`
entry `seat:mesh-module-assigner.views.seat-holders` (on main it has none: its `invokes` names only
`seat:mesh-module-assigner.assignments`); an
ask waiting for an existing holder is timed by §86's `build-capacity-waits` and by A-466s's `run-untaken-bound`
(G-24 §720, §725), and from its `ask-taken` by its step's bound (A-466p). [mesh-delivery DQ-3.] How it is checked:
whole (runner), a seat with no holder ends the pipeline at once, naming it; an ask a present holder has not taken
past five minutes is not failed (test 109).
- §648 **A `take-in.taken` entry carries the pull request.** (§476, §542) An entry is `{module, commit, fingerprint, - §648 **A `take-in.taken` entry carries the pull request.** (§476, §542) An entry is `{module, commit, fingerprint,
repository, pull}`, the last two from a `merged` message and absent for a `pushed` one. [mesh-delivery DQ-5.] How it repository, pull}`, the last two from a `merged` message and absent for a `pushed` one. [mesh-delivery DQ-5.] How it
is checked: unit (indexer's contract). is checked: unit (indexer's contract).
@@ -3,7 +3,7 @@ layer: to-be
status: in-progress status: in-progress
design: 47 design: 47
milestone: G milestone: G
updated: 2026-11-11 updated: 2026-11-17
decisions: decisions:
- "ADR 0667" - "ADR 0667"
- "ADR 0666" - "ADR 0666"
@@ -149,7 +149,7 @@ One file of milestone G's part of [design 47](../47-delivery-from-commit-to-deli
| `pipeline-started`, `pipeline-ended` | a pipeline's start, and its end with every step's result, its test counts, the source revision and `widens` | | `pipeline-started`, `pipeline-ended` | a pipeline's start, and its end with every step's result, its test counts, the source revision and `widens` |
| `group-ended` | a group's one pipeline's end, on which alone its wants are written | | `group-ended` | a group's one pipeline's end, on which alone its wants are written |
| `run-started` | a run on request's start, with its members at their commits | | `run-started` | a run on request's start, with its members at their commits |
| `step-started`, `step-ended` | each step's start and end: the step, its status in the policy, its outcome, its build-input fingerprint, its test counts, for a carried result what it was carried from, and for a rerun that it is one and the caller the runtime proved; a bypassed step too | | `step-started`, `step-ended` | each step's start and end: the step, its status in the policy, its outcome, its build-input fingerprint, its test counts, for a carried result what it was carried from, and for a rerun that it is one and the caller the runtime proved, for a step that read a test run or a composition run another step asked its `shared` (G-24 §729); a bypassed step too |
| `wait-held`, `wait-ended` | a step's wait: on a person (approval, code review), on a build node, on the revision view | | `wait-held`, `wait-ended` | a step's wait: on a person (approval, code review), on a build node, on the revision view |
- §74 **What a session hears after its merge.** Between its `merge-pull` and the delivery, a session waits with `mesh_wait` - §74 **What a session hears after its merge.** Between its `merge-pull` and the delivery, a session waits with `mesh_wait`
@@ -195,14 +195,14 @@ four lines a module's tools answer; every read tool of a store also answers its
| Part (seat) | Read everything it holds | Do by hand what it does itself | Recover without help | | Part (seat) | Read everything it holds | Do by hand what it does itself | Recover without help |
|---|---|---|---| |---|---|---|---|
| the runner (`mesh-pipeline-runner`) | `show` (one pipeline whole, its steps, step log and outputs), `list` (the pipelines of a module, a branch or a commit), `stands` (what stands still, since when), `why-carried` (where a step's result was carried from), `kept` (the kept results by digest) | `start` (a delivering pipeline for a watched branch's head), `run` (the run on request), `rerun` (one step again) | `accept` (a failed `optional` step, with why), `cancel` (a pipeline, dropping its asks), `ask-again` (a declined `approval`) | | the runner (`mesh-pipeline-runner`) | `show` (one pipeline whole, its steps, step log and outputs), `list` (the pipelines of a module, a branch or a commit), `stands` (what stands still, since when), `why-carried` (where a step's result was carried from), `kept` (the kept results by digest), `runner_test_runs` (each test run, G-24 §728) | `start` (a delivering pipeline for a watched branch's head), `run` (the run on request), `rerun` (one step again) | `accept` (a failed `optional` step, with why), `cancel` (a pipeline, dropping its asks), `ask-again` (a declined `approval`), `runner_test_runs_drop` |
| the indexer (`mesh-catalog`) | `registrations` (with each one's history); `indexer_edges` (an artifact's edges per watched branch), `indexer_order` (the order of a change, its cycles named), `indexer_catalog_difference` (two revisions); `indexer_pending` (a group with its missing members) | `register`, `policy`, `watch`, `unwatch` (each on the operator's Approve) | `indexer_seed_again` (the first registrations' ask raised again), `indexer_take_in_pending` (a group taken in as gathered), `indexer_drop_pending` (dropped) | | the indexer (`mesh-catalog`) | `registrations` (with each one's history); `indexer_edges` (an artifact's edges per watched branch), `indexer_order` (the order of a change, its cycles named), `indexer_catalog_difference` (two revisions); `indexer_pending` (a group with its missing members) | `register`, `policy`, `watch`, `unwatch` (each on the operator's Approve) | `indexer_seed_again` (the first registrations' ask raised again), `indexer_take_in_pending` (a group taken in as gathered), `indexer_drop_pending` (dropped) |
| the gate (`mesh-delivery`) | `source` with a branch (`gate_source`: every branch's source revision) | — | `gate_source_again` (say `source-moved` again for a branch) | | the gate (`mesh-delivery`) | `source` with a branch (`gate_source`: every branch's source revision) | — | `gate_source_again` (say `source-moved` again for a branch) |
| the forge module (`git`) | `git_failed_steps` (the failed `required` steps it holds, by module and fingerprint, with the run that failed each) | — | `git_failed_steps_drop` (drop one, with why) | | the forge module (`git`) | `git_failed_steps` (the failed `required` steps it holds, by module and fingerprint, with the run that failed each) | — | `git_failed_steps_drop` (drop one, with why) |
| the grants part (`mesh-grants`) | `grants_callers` (the callers each verb admits, read from the seat definitions) | — | `grants_why_refused` (for an account and a verb, the grant it lacks and the definition's line that leaves it out) | | the grants part (`mesh-grants`) | `grants_callers` (the callers each verb admits, read from the seat definitions) | — | `grants_why_refused` (for an account and a verb, the grant it lacks and the definition's line that leaves it out) |
| the build seats | `steps` (the steps detected for an artifact) | `steps` with `again` (detect again) | `drop` (ADR 0664 §4) | | the build seats | `steps` (the steps detected for an artifact) | `steps` with `again` (detect again) | `drop` (ADR 0664 §4) |
| the builder (`mesh-builds`) | `builder_reserved` (each module's reserved version, §369); the released versions are the catalog's `versions` | `builder_publish_again` (publish the missing artifacts under the reserved version) | — | | the builder (`mesh-builds`) | `builder_reserved` (each module's reserved version, §369); the released versions are the catalog's `versions` | `builder_publish_again` (publish the missing artifacts under the reserved version) | — |
| the assigner (`mesh-wants`) | `assigner_why_not` (why a module is not on a machine yet: the pipeline it waits for, its hold, the placement, the node's last `running`) | — | `assigner_release` | | the assigner (`mesh-wants`) | `assigner_why_not` (why a module is not on a machine yet: the pipeline it waits for, its hold, the placement, the node's last `running`), `assigner_compositions` (each composition run, G-24 §728) | — | `assigner_release`, `assigner_compositions_drop` |
| the watchman | `watchman_views` (how far behind each part's view is, from each part's `view-waits` and first-view tools) | — | each part's `<module>_first_view_again` | | the watchman | `watchman_views` (how far behind each part's view is, from each part's `view-waits` and first-view tools) | — | each part's `<module>_first_view_again` |
| the operator-channel | `asks` (with each asker's asks held back) | — | `ask-again` (offer a held-back ask now) | | the operator-channel | `asks` (with each asker's asks held back) | — | `ask-again` (offer a held-back ask now) |
| every module that imports mesh-sdk's small object store package | `<module>_state_objects`, `<module>_sent_objects` | — | `<module>_state_objects_drop`, `<module>_sent_objects_drop` | | every module that imports mesh-sdk's small object store package | `<module>_state_objects`, `<module>_sent_objects` | — | `<module>_state_objects_drop`, `<module>_sent_objects_drop` |
@@ -230,6 +230,8 @@ and an estimated 2 mesh-sdk publishes a day, each rebuilding about 120 artifacts
| the builder | `reserved`: one key per module and `MAJOR.MINOR` (§369) | old `state` section | until its `version-released`, a release of another `MAJOR.MINOR` of the module, or `builder_reserved_drop` | a few KiB; at the cap the builder reserves nothing and says why | | the builder | `reserved`: one key per module and `MAJOR.MINOR` (§369) | old `state` section | until its `version-released`, a release of another `MAJOR.MINOR` of the module, or `builder_reserved_drop` | a few KiB; at the cap the builder reserves nothing and says why |
| the assigner | `written`: the last source revision and end count per module and watched branch (§352) | old `state` section | until the branch is unwatched | a few KiB | | the assigner | `written`: the last source revision and end count per module and watched branch (§352) | old `state` section | until the branch is unwatched | a few KiB |
| the indexer and the assigner | `inputs`: a `run` ask's input by write time and sha256 (§354) | old `state` section | until the ask's `step-ended`, at most a day | 64 MiB; an estimated 300 asks a day of under 100 KiB each is under 30 MiB; at the cap the asker refuses the ask loudly, naming the store | | the indexer and the assigner | `inputs`: a `run` ask's input by write time and sha256 (§354) | old `state` section | until the ask's `step-ended`, at most a day | 64 MiB; an estimated 300 asks a day of under 100 KiB each is under 30 MiB; at the cap the asker refuses the ask loudly, naming the store |
| the assigner | `composition-runs`: one key per candidate and machine, its program, input, ask, readers and verdict (G-24 §719) | old `state` section, `max-mib` the setting `composition-runs-cap-mib` | the setting `composition-runs-kept` (default 24 hours) after its end; deleted by the assigner (§719) | default 16 MiB; an estimated 30 candidates a day on four machines, 120 keys of at most 8 KiB, is under 1 MiB a day |
| the runner | `test-runs`: one key per candidate, level and tested packages, its ask, readers, outcome and counts (G-24 §725) | old `state` section, `max-mib` the setting `test-runs-cap-mib` | the setting `test-runs-kept` (default 7 days) after its end, deleted by the runner in the step log's order with its output object in `test-runs-objects` (§330) | default 16 MiB; an estimated 1,000 test runs a day of about 1 KiB is about 7 MiB at 7 days |
| the runner and the assigner | `findings` (§355), read by their own read tools alone; the keeper hears the findings as events (§383) | old `state` section | an entry deleted when its finding clears | a few KiB | | the runner and the assigner | `findings` (§355), read by their own read tools alone; the keeper hears the findings as events (§383) | old `state` section | an entry deleted when its finding clears | a few KiB |
| every observer (§387) | the stream `<module>-findings`: `finding-written`, `finding-cleared`, `findings-stated` (§383) | old `streams` section for a foundation part, the module's `streams` otherwise | 7 days, its oldest dropped when full; the next statement covers a lost one (§384) | 16 MiB; an estimate of a few hundred findings a day of about 1 KiB is under 2 MiB a week | | every observer (§387) | the stream `<module>-findings`: `finding-written`, `finding-cleared`, `findings-stated` (§383) | old `streams` section for a foundation part, the module's `streams` otherwise | 7 days, its oldest dropped when full; the next statement covers a lost one (§384) | 16 MiB; an estimate of a few hundred findings a day of about 1 KiB is under 2 MiB a week |
| the condition keeper | `findings-views`: one key per observer and node, its last stated set, pending keys and open asks (§388) | the form of its `conditions` | deleted when the module leaves the catalog or the node (§365) | under 1 MiB; about 30 observers on four machines | | the condition keeper | `findings-views`: one key per observer and node, its last stated set, pending keys and open asks (§388) | the form of its `conditions` | deleted when the module leaves the catalog or the node (§365) | under 1 MiB; about 30 observers on four machines |
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,209 @@
---
layer: to-be
status: in-progress
design: 47
milestone: G
updated: 2026-11-17
decisions:
- "ADR 0667"
---
# 47, milestone G — what is owed once G is delivered
The list of what waits for G's delivery: the operator's remarks deferred while G was brought up, the stand-ins the
lead's answers mark to go after G, the hand state of G's live start, and the faults met on the way. It is checked when
G is delivered: each item is then removed, taken into a design or a record through its playbook, or noted on the issue
that covers it (asking the operator before a new issue). An item is struck from this list in the same pull request that
deals with it, which is how the list is kept true.
## The operator's remarks (2026-11-14, deferred until G is live)
1. **Two graphs only:** the catalog graph and the assignment graph. Each node's modules publish the state they own and
the version they run on the bus; a gap between the assignments and what a node says is closed by the node-engine.
2. **What a node can run is checked only on assignment and un-assignment** (for the modules that depend on it), never
as an input to every computation. The glossary's *assignment graph* and ADR 0656 say the assigner computes from the
catalog graph, the placements and the nodes' capabilities: check the record and the code against this.
3. **Assignments enter as commands** (the seat `mesh-module-assigner`'s `propose`: place, take off, ...); the assigner
computes no placement, it only derives each placed module's version from the catalog graph into the wants. Check the
glossary's wording against this.
4. **A pin** ("use this provider for this provision") may not belong in the assignments at all: question it, and what
the provision wiring should be instead.
5. **Who says a node's running versions:** the node-engine (its haves) or each module itself. The operator's picture
is each module; check which the design means.
6. **One address for a seat's view.** A reader's manifest names the assigner's view by its seat, the reader's code asks
the holder module's tool by its module name, and the grants part translates one into the other (and gave only the
events, not the right to ask: the indexer's first view was refused at G's live start). One address, the same in
manifest, code and rights.
7. **A registration is part of the module graph, not a list beside it.** After G's start the module graph held 178
modules while the registrations held none, with a seed ask to copy them from the old registry. Check the design
against one graph whose entries are the registrations and what each registered repository says.
8. **One bookmark (durable consumer) per process, never shared** (A-397). A module's program and its tool runner read
events under one durable name; the runner took all 178 first registrations and the program heard none, silently.
Share a durable name only for shared work (a queue). Owed: amend design 19's "one durable consumer per module"
(written when a module was one process) and the lines of designs 25, 32 §3, 57, G-5 and G-8 that follow it; build
per-process names in the grants part, mesh-sdk's process hub and the tool runner, with a start refusal and a log
line; the test of two processes of one module both hearing one event on a real bus; a check that a durable has one
reader; and a design-review playbook question: "what if two processes of one module do this?"
9. **The same mistake elsewhere.** A survey at G's start found it live in three modules (the assigner, the indexer and
the grants part: the runner acks and drops what no tool view wants) and possible in every module whose tool runner
arrives later (builder, checker, forge bridge, pipeline runner, teller, view, watchman, distribution, recovery).
Already avoided: the bus and zfs keepers (A-340), the node-engine, work queues. Also: a seat verb served by both a
program and its runner in one queue group splits the answers between them; durables nothing reads keep pending
messages.
10. **`registration-changed` is said for a first registration too:** check the event's name against what it says.
11. **Silent waits met during G's start:** the indexer's first versions fill returns without a word while another fill
runs, so a hung fill held every later one silently for two hours; `grants_membership` and `grants_assert` time out
after 30 seconds with no log line; the tool runner says a dropped event once per key.
12. **The module graph's edges are dependencies, never verbs or bus subjects** (2026-11-16; principle 9): a manifest
says what its module depends on, a seat where the need is meant to be interchangeable and otherwise a module (a
build dependency on a package module, a program needing another module), and the graph's edges come from that
alone. The verb edges of ADR 0614 §2 and §3, and the cycle exceptions they needed (A-361, A-428, A-437), go; whether
`invokes`, `uses` and the `views` forms stay in a manifest at all is asked with the research on the mesh's
accounts, and "each fact is declared in one place".
13. **A full delivery cycle by hand** (the operator, 2026-11-17 about 09:00: "make sure that every part of the
build-and-delivery system is also doable by hand via mcp tools", "so you can fully take control of a full cycle";
asked when, "after G"; principle 4). A survey of 2026-11-17 found, along the cycle merge, the gate's source,
take-in, entries, pipeline, steps, release, wants, grants, put and running: about 52 acts a module does by itself
with no hand tool, about 110 bus states with no per-key clear and 26 with no read tool, all but one of about 25 capped
states with no fill against their cap, and 14 recoveries with no tool. One milestone: the SDK's state tools for
every declared state (read, fill against cap, clear a key, drop key-gone objects), the missing hand acts per module,
a summary of the pipeline runner's pipelines by outcome, `source-moved` and the runner's `ended` declared so they
can be waited on, and the catalog check that refuses a module whose state or act has no tool. Also a consumer
composed from the union of the want's and the trunk's manifests, as grants already are (a bundle's new `consumes`
is unbound until a want names its build).
14. **No pass waits on a call** (principle 1; from the node-engine's #233 (`mesh-host`), A-461b): the node-engine's composer asks the seat
mesh-catalog's `module` for a trunk build at the top of every pass and waits up to the call's bound, so a seat that
answers slowly stalls every pass. The ask goes beside the pass, which composes with what it holds and takes the
answer at the next pass.
## Met during G's start (2026-11-14)
- **The seed of registrations** left out modules whose manifest lives in the application's own repository on its
watched branch, so they were assigned but unheld and the assigner refused every proposal (ADR 0567 §2). The seed
should register every assigned module from where its manifest is.
- **The indexer's catch-up and take-in** say nothing in the indexer program's journal.
- **The provisioner** drops a published composition with neither plan nor refusal silently and then removes the
node's plans; no read tool shows a node's composition.
- **The node-engine** is refused the builder's `build.ended` by the bus every five minutes: the grants part does not
give it; to fix before builds matter.
- **The register verb refuses an unprotected watched branch:** the operator approved removing the check (from the
seat `mesh-catalog`'s definition and the indexer that serves `register`).
## Stand-ins the lead's answers mark to go after G (2026-11-16)
- **A-436 with A-430b:** a want carries parts beside its version for a node-engine that reads parts, and a module
wanted with no passed pipeline names the parts its `build.ended` made until its release is heard.
- **A-438:** for an acting wait, a running have whose node-engine states no health counts as healthy, and an online
node runs its node-engine; goes when every node-engine states health.
- **A-439:** `assigner_written` with `why` answering for `assigner_why`.
- **A-434:** every account may do everything, and every seat verb admits every caller, until the research on the
mesh's accounts replaces it (the operator, 2026-11-15: three accounts, mesh, agent and operator; approval only as a
per-tool mark for agent calls).
## Hand state of G's live start (2026-11-16)
- **Runtime drop-ins on the control-node** that pin a hand-made fingerprint (and the tool runner's environment) for
the grants part, the teller, the forge bridge and the tool runner. A delivery does not remove them: each goes before
its module restarts on the delivered build, or the module believes it runs the old one.
- **Hand-placed builds** (the indexer and its tools, the tool runner, the control-node's node-engine, the assigner) are
replaced only by their deliveries; check each is.
- **About 80 hand-built modules on the control-node have no catalog entry:** their first move is held for a backup
(the kept-form hold).
## Faults met on the way (2026-11-16; note each on the issue that covers it)
- `node-files.delete` cannot move a root-owned file to the trash; `node-service-manager` has no daemon-reload.
- The indexer does not stop on SIGTERM: it keeps draining build-log entries until systemd kills it.
- The backup ask's headline says "backup failed" for a kept-form hold.
- The assigner logs a line naming about 140 modules every one to three seconds, and did not raise the backup ask
again after a restart.
- `mesh_wait` refuses the operator channel's events: `operator-channel` is neither a seat nor a module of the catalog
half.
- Four tests of mesh-delivery fail on main, reading files that do not exist there: `sdk`'s
`TestThePackageArtifactNamesNoPathForTheWholeDirectory`, `sdk/buildstep`'s two fixture tests and
`meshdeliveryclient`'s `TestTheRemovedVerbsAreTheDefinitionsRemovedRows`.
- The node-engine's repository holds about 1721 unit tests against the budget of 500.
- The live indexer was seen refusing the assigner's manifest for claiming `mesh-placement`, which neither main nor
G's branch claims: confirm the verdict after G's take-in.
## Tests run against what runs (the operator, 2026-11-16 about 13:00 CET)
- **A test runs against the bus as the mesh composes it.** The pipeline runner's integration test made its own
shared event stream catching every seat event, so a step's end reached the runner there; on the live bus a step's
end is a kept event on a stream of its own, which the runner never bound, and no pipeline could pass (fixed in the
runner at G's start, 2026-11-16). Wanted: a principle ("a test runs against what the module runs against: the bus as
the mesh composes it from the manifest, never a layout written in the test"); the shared library gives an
integration test the streams, kept streams and consumers the composition makes for the module's manifest; every
integration test that creates its own streams moves onto it (count them first); the runner's test publishes a step's
end on the kept stream.
- **A handler of a kept event is heard or fails loudly.** Starting a program's events binds only the shared stream;
kept seat events need a second call, and a program that registers a handler for one and never makes it hears
nothing and says nothing. The shared library binds the kept streams of every registered handler itself, or refuses
to start.
## One way of asking work (2026-11-16)
- The builder, the pipeline runner, the indexer (its validation before a take-in) and the checker each ask the build
seats in a shape of their own; the validation rides the check queue behind pipeline steps (a 6-second validation
waited over 20 minutes). Parked by the operator for research right after G: one generic pipeline for work and gates.
- An ask given again after a fix keeps its old form (a step asked with no module directory came back without one).
- The builder asks a failing build again every two to three minutes, reserving a new version each time.
- The builder's queue tool lists only the oldest 50 waiting entries (left over from 2026-11-14), so it cannot show
what waits now.
- The pipeline runner serves no tools on the control-node and logs nothing per step; the build seat's step events say
no pipeline before a step ends; `mesh_wait` refuses the build seats' and the runner's events; the bus's stream reader
cuts a body at 4 KiB; a running test step logs nothing.
- `TestTheBuildModulesKeepNoCopyOfTheDeliverySDKsStepCode` fails on mesh-catalog's main (the empty
`modules/mesh-build-go/buildstep` directory); the seven `checks/` tests, nats-tools and distribution fail in a run over
the whole of mesh-catalog.
- The glossary's **pipeline** and **pipeline step** entries leave out the build, which the runner asks as the step
`build` of the seat `mesh-builds`: correct them.
- A pipeline the runner set aside before A-446 with steps already written (`main.940.mesh-delivery-sdk`) is started
again by neither of the runner's start paths.
- The node-engine's journal and the have's phases say a module is "held" and that the node "keeps running what it
runs" for one thing: a module left on the build it runs, its new build not applied. The operator, 2026-11-17, wants
those words gone: retire "held" and "kept" in that sense from the node-engine's lines and the glossary, with one
glossary word in their place.
- A composition that passes on every machine as "not judged: the composer was handed no seat list" is reported as
passed: a composition step that judged nothing must fail or say so (principle 3).
## From the composition runs of 2026-11-17
- **The node-engine answers `compose-candidate` with different bytes for one candidate.** Within 30 seconds the
assigner kept twelve inputs of exactly 1,491,623 bytes with different digests for the same revision. The bytes differ
in the node-engine's answer, not in the assigner's request; a guess, not checked: a slice whose order changes between
asks, perhaps `ComposedHow.Running`. Under design 47 G §718 one composition run per candidate and machine asks each
node once, so this no longer multiplies anything and stays out of G (principle 7; the coordinator, 2026-11-17). After
G: find it by comparing two kept inputs of one node, read by digest through `mesh-wants`' `input`, and decide whether
the answer must be the same bytes while the node is unchanged.
- **Design 47's main file and G-22 are split** (playbook 02, *The shape of a design*). The main file is about 250 KB
against its 80 KB bound, and G-22 about 165 KB against a milestone file's 60 KB. The operator decided at 10:31 CET on
2026-11-17 that the split comes after G, as a separate amendment.
## Faults met on the way (2026-11-17; note each on the issue that covers it)
- **The assigner's long line, met a second time.** On 2026-11-17 from 11:02 CET the assigner on the stable node logs,
several times a minute, that "the manifest of the running build of" about 100 modules "cannot be read, so what the
module graph says they serve is counted as served". Cause not yet known: nearly every module is named, so the
assigner reads the running builds' manifests where none is kept. Being the second meeting, its fix is folded into
G-24's assigner change once A1 to A7 are built. Cause found the same day: the assigner reads a running build's
manifest only from the builder's end in its stream, which the builder has said only since 2026-11-11, so no build
made before then has one. G-24 says the list once per change of the set; after G, the builder says the end of each
build it keeps into its stream once (principle 1; the alternative, reading the catalog entry at that fingerprint,
reads another module's data).
- **The Node build modules disagree on their toolchain.** On 2026-11-17 shanks's recipe differed from the other three
nodes', and g14 ran Node v26.13.1 against v26.13.0, so no version and recipe held a majority, and lidarr, radarr and
gitea had no fingerprint at revision 449 (A-470j keeps that from leaving whole machines not judged). After G: one
version and one recipe declared through the mesh on every build node.
- **The catalog had not taken in the node-engine's merge #234** by revision 450 (2026-11-17 about 11:50 CET), and the
indexer's module reads answered "no responders": read why after G-24's delivery.
- **The builder's and teller's integration tests fail only the 30 s setup bound under load**, and pass idle: the bound's
kind (a setup bound judged on a busy build node) is decided after G.
- The runner's journal floods with ends that name `pipeline ""`: the build seats' run asks are heard on the runner's
subjects.
- `TestAProposalIsAnsweredApprovedAndWritten` (assigner) fails on main; `TestTheNodeComposesItsWantsFromTheBus`
(node-engine) fails now and then.
- `mesh-enrolment` is placed on no node, so its composition step can never run and it never releases.
- `claude_code_wait`'s `said` refused a wait past its bound; `mesh_wait` cannot wait on the gate's `source-moved` nor on
the runner's events.
@@ -0,0 +1,290 @@
---
layer: to-be
status: in-progress
design: 47
milestone: G
updated: 2026-11-17
decisions:
- "ADR 0667"
- "ADR 0666"
- "ADR 0596"
- "ADR 0564"
- "ADR 0267"
---
# 47, milestone G: one composition run per candidate and machine, one test run per level and tested packages
One file of milestone G's part of [design 47](../47-delivery-from-commit-to-delivered.md); the part opens at
[G.md](G.md). Its design lines are numbered across every file of the part and cited as "design 47 G §n".
*§718 to §733 come from milestone G's live delivery of 2026-11-17. The 24 pipelines of one catalog revision asked 96
composition runs, one per pipeline and machine, and 80 more when they were asked again. Each run kept its own copy of
a node's input of 1.1 to 1.5 MB in the assigner's state `inputs`, which reached its 64 MiB cap twice. The indexer's
and the teller's same failing tests failed once per artifact. The operator, 2026-11-17 about 10:20 CET: "In G, now".
Each line is a choice within ADR 0666 §7, §8 and §17, settled by the principle it names. The review by architectural
domain of 2026-11-17 was answered by the lead in A-466 to A-466l (G-22), each cited at the line it settles.*
### Composition runs
- §718 **One composition run per candidate and machine.** (§354, A-226, A-243, A-252, A-466l; ADR 0666 §17; principle
7) The assigner, holding the seat `mesh-wants`, composes each machine once per candidate, whatever number of
composition steps name it. The candidate is named by its key (A-226): `<branch>.<revision>` for a branch pipeline,
`run-<id>` for a run on request. The first composition step of a candidate that needs a machine starts that machine's
composition run: one `compose-candidate` ask of the node, its request kept once in `inputs`, one `run` ask on
`node-build-go`. Every other composition step of that candidate whose module is placed on that machine (A-252) reads
that run's verdict, under §720's rules. The request carries the candidate's manifests, verdicts and seat
definitions, depth compose, the one machine and the case `change`, and the node's own `compose-candidate` answer at
the moment the run started; it carries nothing of the module whose pipeline asked it. A step of the same candidate
that comes later so reuses a verdict composed from the node's answer of that earlier moment, knowingly: within one
candidate, that answer is the machine as the candidate is judged on it (A-466l). The composer program is chosen once,
when the run starts, by A-252's and A-451's rule, and recorded in the run. This replaces "one run ask per machine" for
each composition step (A-243, A-252) with one per candidate and machine.
- §719 **Kept in the assigner's state `composition-runs`.** (§354, §85; ADR 0666 §4, §7; A-466e; principles 1, 2, 7 and
11) Each composition run is one key of the assigner's old `state` section `composition-runs`, whose `max-mib` is the
assigner's setting `composition-runs-cap-mib`, default 16. The key is `<candidate key>.<machine>`, each part escaped as
a key's name (`keys.EscapeName`). The step that starts the run writes the key create-only, so two steps of one
candidate starting at once start one run and the second reads it. The value holds:
- `candidate` and `machine`;
- `program`: repository, commit, directory, and the node-engine fingerprint it was chosen from;
- `input`: the digest of the kept request;
- `ask`: the id of the build seat's run ask;
- `started`;
- `readers`: the step keys of the composition steps reading the run, each added and removed by compare-and-set;
- at the run's end, `ended`, `outcome` (`passed`, `failed` or `could not run`, with its words) and `verdict` (that
machine's composer verdict, §721).
A step waiting on a running composition run hears its end through the assigner's own watch of that key (a module
watches its own state, principle 1). At its start the assigner takes up again each key with no `ended`, by its
`ask`'s `step-ended` (A-240) and the bound of §720. The assigner deletes a key once the time its setting
`composition-runs-kept`, default 24 hours, names has passed since its `ended`; both this and the bound are judged as
the state `inputs` is (A-465b). At the cap no run is started, and its steps end `could not run`, naming the fill (as
A-465a).
- §720 **What a run's result serves, and its bound.** (§75, §86, §718; ADR 0666 §8, §17; ADR 0596; ADR 0564 §2;
A-466, A-466b, A-466n, A-466p, A-466q, A-466s; principles 1 and 3)
- **Within its candidate only.** An ended run's verdict is read only by composition steps of the same candidate. A
step of another candidate starts a run of its own; nothing composed for one candidate crosses to another.
- **`could not run` is never read.** A step that finds an ended run whose outcome is `could not run` starts a new
run, replacing the key by compare-and-set; its former readers have already ended `could not run` with it.
- **The bound times owed progress, not run length** (§75; ADR 0564 §2; A-466n, A-466p). A run has one clock: a bound
key `bound.<run key>` in `composition-runs`, with its own time to live (A-77, A-101). The assigner writes it at
the build seat's `ask-taken` of the run's ask, and writes it again at each `step-progress` of that ask, its time
to live the assigner's setting `composition-step-bound`, default 30 minutes. An ask still waiting in the queue has
no clock: it is timed by §86's build-capacity finding, since a `could not run` for a run that only waited for a
build node would say what is not true. A run that runs past 30 minutes and keeps saying its progress is never
ended by it.
- **When the clock ends.** Its expiry, heard as the bus's event, ends the run: the assigner drops its ask (§119,
A-182), writes `ended` with `could not run` naming the ask and the bound, and ends every reader `could not run`
with it. A `step-ended` of that ask heard later is ignored, said in its journal with the ask and the run's key.
- **A run never taken** (A-466s). A run whose ask has no `ask-taken` within the assigner's setting
`run-untaken-bound` after its `started`, default 24 hours, ends `could not run` the same way, naming the bound;
§86's `build-capacity-waits` says it meanwhile.
- **What the assigner hears** (A-240, A-466q). Its manifest gains `consumes` entries for the build seats'
`ask-taken` and `step-progress`, heard on its durable consumer as A-240 hears `step-ended`. The assigner never
reads the build seat's state (ADR 0596).
- §721 **A machine's verdict names the modules it blames.** (ADR 0666 §17; A-452, A-466g, A-466h, A-466r, A-466u; principles 10, 3, 7
and 11) The composer's verdict of a machine (mesh-delivery-sdk's `composer.Machine`, answered by the node-engine's
`mesh-compose`) gains `blamed`, a list of `{module, problem}`.
- **What it names.** Each module that the candidate's composition of the machine holds or refuses and the
composition without the candidate does not (the modules in its input's `HeldBefore` are left out). Two modules
owning one path are each blamed, with that path. `composes` stays false when the machine does not compose with
every module of the candidate. A machine that does not compose and blames no module fails on the node's own
account (its own composition, or no module composed at all, as A-452 has it).
- **How culprits are found, and its bound.** Only the candidate's changed modules placed on the machine (those whose
entry in the candidate differs from the composition without it) are held, one at a time, each try composing once
more; the search ends at the first module whose hold ends the problem, as the indexer's validator names a manifest
whose removal ends a problem. It composes at most once per such module plus once, never more than `blame-tries`, the
assigner's setting, default 20, carried in the run's request to the composer (the request's field
`blame-tries`), since the composer program has no settings of its own (A-466r); past that bound, the modules not yet tried are named in `blamed` with the words
"not tried: the search reached its bound".
- **An old composer.** A verdict with no `blamed` field (a node-engine's composer from before this line) is judged as
today: a machine that does not compose fails every composition step placing a module on it, with the warning "the
composer names no culprits".
- **No order between them.** mesh-delivery-sdk's `composer` package is published before the node-engine and the
assigner build (an edge of kind 1, as for every package); nothing orders the node-engine's composer before the
assigner, since an assigner meeting an old composer judges as today (A-466u).
- §722 **One module's fault fails only its own pipelines.** (§721; ADR 0666 §9, §17; A-452; principles 10 and 3) A
composition step judges each of its machines from that machine's verdict:
- `failed` when the verdict blames the step's module, or when the machine does not compose and blames no module;
- `could not run` when the composition run could not run;
- `passed` otherwise, with a warning for each module blamed there that is not the step's own (`<machine> holds
<module>: <problem>`). Another module's fault is so said in every pipeline it touches and fails none of them.
The step's outcome then follows from its machines, as today: failed before could not run before passed (§354). A
machine that is away passes with a warning and is not composed (§64).
- §723 **How a composition run ends and is said.** (§73, §116, §119, §496, A-182; ADR 0666 §7, §21; A-466j;
principles 1, 7 and 8) A composition run says no event of its own. Its end is the build seat's `step-ended` of its
`ask`, which the assigner alone hears (A-240). Each composition step reading the run says its own `step-ended` on
`mesh-wants`, as today, with its own build-input fingerprint and `shared` (§729), naming per machine the run it read,
that run's `ask` and its verdict: the result was taken from the build seat's holder once, at that ask, and the step
names it, as §25's carry names where a carried result came from (ADR 0666 §21). Each reading step says its
`step-progress` once a minute while it waits (A-262), naming the runs' asks in `shared`. A step that is superseded or
cancelled leaves `readers`. The run's `ask` is dropped (§119, A-182) only when no reader is left, so a superseded
pipeline never takes away another pipeline's composition run.
### Test runs
- §724 **One test run per level and tested packages.** (§22, §25, §27, §416; ADR 0666 §8, §17; ADR 0267 §1; A-466,
A-466d; principles 3 and 7) The runner asks a lint, unit test or integration test step of a build seat once per
candidate, level and tested packages, whatever number of artifacts' steps name them. A test step's candidate is its
pipeline's in A-226's form: `<branch>.<revision>`, or `run-<id>` for a run on request. A module's program and its
tools bundle are built from different import closures (ADR 0267 §1), but their test steps run the packages of one
directory (the build seat's `steps`, §22), so one set of tests is run. The share digest is the sha256 of:
- the step's build-input fingerprint with the artifact's own part left out (its program's package and recipe), so two
artifacts of one directory meet;
- the step's status in the policy (§23), so the key is §25's carry key: two artifacts whose policies differ do not
share;
- the sorted lines `<package>@<digest>`, one for each package the step would run after its carry (§25: those with no
kept result for their digest), the digests being those the runner already reads for its carry (§416).
The first step of a key puts the build seat's `step` ask; every other step of the same candidate with that key reads
its result. An ended run's result is read only within its candidate; a step of another candidate asks a new run, and
a passed result crosses candidates only as §25's carry, through `kept`. A `could not run` result is never read: a
step finding one asks a new run, replacing the key by compare-and-set. So within a candidate the same failing tests
fail once, not once per artifact, and a second revision with the same digests runs a failed test again.
- §725 **Kept in the runner's state `test-runs`.** (§27, §85, §330; ADR 0666 §4; A-466e, A-466f, A-466p, A-466v; principles 1, 2, 3, 7
and 11) Each test run is one key of the runner's old `state` section `test-runs`, whose `max-mib` is the runner's setting
`test-runs-cap-mib`, default 16. The key is `<candidate key>.<level>.<digest>`, each part escaped as a key's name,
written create-only by the step that asks the run. The value holds:
- `level` and `digest`; the list of packages with their digests is in the run's output object, never in the key or
the value;
- `seat` and `ask`, and `node` once a holder has taken the ask;
- `started`;
- `readers`: each reading step's pipeline key and artifact, added and removed by compare-and-set;
- at the run's end, `ended`, `outcome`, its test counts, and the name of its output object.
A test run's output object is kept in the state's own object store `test-runs-objects`, an old `objects` section
with no age of its own, so it lives exactly as long as its key, whatever `step-outputs`' 7 days (A-466v); a step's
own output stays in `step-outputs` as today. A reader whose run's object is gone (a drop, a fault) answers its run
without the packages, saying "the run's output is gone".
The runner hears the run's end as the build seat's `step-ended` of its `ask`, on its durable consumer, as it hears
every step (§24). A test run has §720's one clock, a bound key `bound.<run key>` in `test-runs`, written at the
build seat's `ask-taken` of its ask and again at each `step-progress` of it, its time to live the runner's setting
`test-step-bound`, default 30 minutes; an ask still in the queue is timed by §86's build-capacity finding alone. Its
expiry ends the run as §720's does: the ask dropped (§119), every reader ended `could not run`, a later
`step-ended` of the ask ignored and said in the journal. A run whose ask is never taken ends `could not run` at the
runner's setting `run-untaken-bound`, default 24 hours after its `started` (A-466n, A-466p, A-466s). The runner
consumes `ask-taken` already (§647); its manifest gains `step-progress` where it does not consume it. At its start the runner takes up again each key with no `ended`, by its
`ask` and that bound. It deletes a key once the time its setting `test-runs-kept`, default 7 days, names has passed
since its `ended`, in the step log's order as §330 ages its `pipelines`, and deletes the run's output object from
`test-runs-objects` with the key, after the last reader's end. At the cap no run is asked, and the step ends `could not run`, naming the fill, as
§719 has it, with no condition of its own. A passed run's results go into `kept` per package, as today (§27), so a
step asked after the key is deleted carries them.
- §726 **How a test run ends and is said.** (§24, §73, §119, §419, §496; ADR 0666 §8, §21; A-466i, A-466j; principles
3, 7 and 1)
- **Each reading step is said.** Each step reading a test run says its own `step-started` and `step-ended`, with its
own build-input fingerprint and `shared` (§729). Its `step-ended` carries the run's outcome and counts. Its
`step-started` names the run's `ask`, so the watchman times it from that ask's `step-progress` (§496). The result
was taken from the build seat's holder once, at that ask, which the step names, as §25's carry does (ADR 0666 §21).
- **Counted once.** `pipeline-ended` counts a module's tests once per pipeline and test run, never once per step
reading it (§24, §419).
- **Dropped only with its last reader.** A step that is superseded or cancelled leaves `readers`, and the run's ask
is dropped (§119) only when no reader is left.
### For both kinds
- §727 **Asking a run again moves every reader.** (§30, §73, §83 `rerun`, §29; ADR 0666 §9, §11, §24; A-466a;
principle 3) One rule for composition runs and test runs. A `rerun` of a composition step (for each machine whose
verdict in it was not `passed`) or of a test step joins the run of its key while that run is running, reads one that
started after the step's last end, or otherwise starts a new run, replacing the ended key by compare-and-set and
carrying the former run's `readers` into the new value. The new run's end moves every step that read the former run
and did not pass: each says `step-ended` again with the new outcome, marked as a rerun with the caller of the step
asked again (§73). A moved step reopens its pipeline, which says `pipeline-ended` again with a higher end count; the
assigner writes wants only from a pipeline's latest end (§29). A step a person `accepted` (§30) does not move: a
person's act stands. A machine that passed in a composition step keeps its verdict. A step left reading a failed
result would say what is no longer true. So twenty composition steps of one revision asked again together start one
run per machine.
- §728 **The tools.** (§83, §391; ADR 0666 §25; A-466c; principle 4) Two for each new state, in §83's table:
- `assigner_compositions` (class `read`) takes a candidate, a machine, or neither, and answers each composition run
with its program, input digest, ask, readers, outcome and verdict, and the state's fill against its cap.
- `assigner_compositions_drop` (class `act`, §391's default callers) takes `{candidate, machine, why}`. It writes the
hand-act log first, drops the run's ask, ends each reader `could not run` naming the drop, and deletes the key.
- `runner_test_runs` (class `read`) takes a candidate, a level, a digest, a module, or none of them, and answers each
test run with its packages (read from its output object), ask, node, readers, outcome and counts, and the state's
fill against its cap.
- `runner_test_runs_drop` (class `act`, §391's default callers) takes `{key, why}` and does the same as
`assigner_compositions_drop`, deleting the run's output object with the key.
- §729 **`shared` in the seat contracts.** (§73, §116, §496; ADR 0666 §21, §24; A-466j; principles 1 and 8) The seat
definitions in mesh-delivery's `mesh-delivery-contracts` change, and the contracts' code is generated from them by
`seatgen`, never edited by hand:
- **`mesh-wants`' `step-ended`** gains `shared`: a list of `{machine, run, ask}`, one per machine composed, `run` the
`composition-runs` key and `ask` its run ask's id, all strings.
- **The composer's request** (mesh-delivery-sdk's `composer.Request`) gains `blame-tries` (a number, §721).
- **`mesh-wants`' `step-progress`** gains the same `shared` list, naming the runs the step waits on.
- **`mesh-pipeline-runner`'s `step-started`** gains `shared`: `{run, ask}` for a test step, `run` the `test-runs` key
and `ask` its build seat ask's id, strings.
- **`mesh-pipeline-runner`'s `step-ended`** gains `shared`: `{run, ask, asked-by}`, `asked-by` being `{pipeline,
artifact}` of the step that asked the run (strings), left out for that step itself.
- **`mesh-pipeline-runner`'s `stands`** answer: each entry gains `ask` (string) and `shared` (`{run, ask}`, strings,
where the runner knows it), as §731 says.
A step that names `shared` names its own build-input fingerprint beside it, as every `step-ended` does (§73). A
composition step's `step-started` is said by the runner when it asks the assigner, before any run is chosen, so it
cannot name the runs' asks; the assigner, the part that knows them, names them in its `step-progress`, and the
watchman times a composition step from that (§496, A-262, A-466m).
- §730 **What runs in flight, and going back.** (§65, §78; ADR 0666 §19, §24; ADR 0667 §9; A-466k; principle 3) A
composition step or test step asked before the new assigner or the new runner runs ends by the path it was asked
under, one run per step; composition runs and test runs are made only for steps asked after the new part runs. A
return to an earlier build (§78) leaves `composition-runs` and `test-runs` unread; their readers are ended `could not
run` by the bound of §720 and §725 once the new build runs again. Until then the earlier build applies no such bound,
and a reader standing still is said by the watchman as `pipeline-stands`, by §732 (A-466o).
- §731 **The runner's `stands` names what a reading step waits on.** (§75, §83; A-466t; principles 3 and 4) `stands`
already answers every pipeline step started and not ended whose outcome is running or waiting (mesh-delivery's
runner on main, its `Stands` read), so a composition step waiting on the assigner is in it. Each of its entries
gains `ask`, the step's own ask (§496), and `shared` where the runner knows it (§729, a test step's run key and
ask). At its start the watchman seeds §732's open steps from it, each clock begun at that moment, and times each by
those asks from then on.
- §732 **The watchman times every step that reads a run.** (§75, §496, §602; ADR 0564 §2, §4; ADR 0666 §24; A-466o;
principles 3 and 1) §75 and §496 time each pipeline step from its `step-started` or its latest `step-progress`, but
the watchman on main times only a build seat's running ask (its `ask-taken` and `step-progress`) and a step queued
for a build node; a step whose run has ended, or a composition step waiting on the assigner, is timed by nothing.
From G the watchman also:
- **hears** the runner's `step-started` and `step-ended` of every pipeline step (it consumes them already, for the
build capacity), and `mesh-wants`' `step-progress`, a `consumes` entry its manifest gains;
- **keeps** each started step with no `step-ended` in memory under `<pipeline>/<step>`, its clock begun at its
`step-started` and begun again at each `step-progress` whose `ask` is the step's own ask (§496) or an ask its
`shared` names (§729), and at the `step-ended` of the run's ask a test step names;
- **raises** `pipeline-stands` for that step when its clock passes the watchman's existing five-minute progress bound
(§75), naming the pipeline, the step and the ask it last heard of, and clears it at the step's `step-ended`. A
step said waiting on a person, or queued for a build node (§86), is owed no progress, as today;
- **seeds** its open steps at its start from the runner's `stands`, as §75 has it.
So a reader that neither the assigner nor the runner ends, after a return to an earlier build or any fault, is said
within five minutes of its last sign of life.
- §733 **How it is checked.** Tests 108 and 109.
- **Whole (assigner, mesh-delivery), test 108.** Two composition steps of one candidate started at once make one key,
one request and one run ask. Three composition steps of one revision on two machines start two runs, and each step
reads both verdicts. A machine whose verdict blames module A fails A's composition step and passes B's, with a
warning naming A; a machine that does not compose and blames no module fails both; a verdict with no `blamed` is
judged as today and says "the composer names no culprits". A step of another candidate starts its own run, and a
`could not run` result starts a new one. A taken ask with no `step-ended` and no `step-progress` for 30 minutes
ends `could not run`, with its readers and its ask dropped, and a `step-ended` of that ask heard later is ignored
and said in the journal; a run past 30 minutes that keeps saying its progress is not ended; an ask never taken
ends `could not run` at `run-untaken-bound`. Steps asked again together start one run per machine that did not
pass, and move every former reader; a reopened pipeline says `pipeline-ended` again. A superseded step leaves the run running for its other readers. An assigner restarted during a run takes it
up again by its ask. At the cap a step ends `could not run`, naming the fill. `assigner_compositions_drop` ends the
readers and deletes the key, and a reader-only account calling it is refused.
- **Whole (the node-engine's composer, `mesh-host`).** A fixture module whose manifest is refused on the machine is
blamed by name, two modules owning one path are both blamed, and the search past the request's `blame-tries` names
the untried.
- **Whole (runner and Go build module, mesh-delivery and mesh-catalog), test 109.** A module whose program and bundle
test one directory asks one unit step and one integration step, and both artifacts' steps end with that result and
`shared`. A failing test fails once, and `pipeline-ended` counts the module's tests once. A rerun of one artifact's
failed step that passes moves the other artifact's step to passed too, and the pipeline says `pipeline-ended` again;
an `accepted` step does not move. A runner restarted during a run takes it up again by its ask. A replaced reader
leaves the ask to the other readers. At the cap a step ends `could not run`, naming the fill. A run past 30
minutes that keeps saying its progress is not ended, and a taken ask silent for 30 minutes ends `could not run`
with its readers. A test run queued past five minutes with a holder present is not failed (A-466y). A second
revision with the same digests runs a failed test again. `runner_test_runs_drop` deletes the key and its output object, and a
reader-only account calling it is refused.
- **Unit (runner).** A test run whose output object is gone is answered by `runner_test_runs` and its readers
without its packages, saying "the run's output is gone"; the object outlives `step-outputs`' 7 days while its
key lives.
- **Whole (watchman), tests 108 and 109.** A composition step whose `mesh-wants` `step-progress` stops raises
`pipeline-stands` within five minutes; a test step whose run's ask ended with no `step-ended` of the step raises it
five minutes later; each clears at the step's `step-ended`; a step waiting on a person raises nothing; a watchman
restarted while a composition step waits on the assigner seeds it from `stands` and raises it if no progress
follows.
- **Live.** In the first publish after G's delivery, the composition run asks of each revision number at most its
machines, read with `assigner_compositions` and `assigner_inputs`; each module's test steps run once per level, read
with `runner_test_runs`.
+4 -2
View File
@@ -3,7 +3,7 @@ layer: to-be
status: in-progress status: in-progress
design: 47 design: 47
milestone: G milestone: G
updated: 2026-11-12 updated: 2026-11-17
decisions: decisions:
- "ADR 0500" - "ADR 0500"
- "ADR 0673" - "ADR 0673"
@@ -88,7 +88,7 @@ file on 2026-11-10, and is cited as "design 47 G §n". A sentence that holds a d
stayed in the main file, and G builds what it says from G's delivery. A section named in italics is in this part, or, stayed in the main file, and G builds what it says from G's delivery. A section named in italics is in this part, or,
when it is not here, in the main file. when it is not here, in the main file.
The part is twenty-two files, each read whole, its design lines numbered across them: The part is twenty-four files, each read whole, its design lines numbered across them:
- [G-1-pipelines-registration-and-steps](G-1-pipelines-registration-and-steps.md): pipelines per module: registration, watched branches, steps and policy, what holds a delivery, approval, groups, dependencies, a publish. - [G-1-pipelines-registration-and-steps](G-1-pipelines-registration-and-steps.md): pipelines per module: registration, watched branches, steps and policy, what holds a delivery, approval, groups, dependencies, a publish.
- [G-2-pipelines-sizes-checks-and-tools](G-2-pipelines-sizes-checks-and-tools.md): pipelines per module: any size, the pipeline makes the check, who may say what, health, recovery, tools, kept data, how G itself is delivered, the choices under ADR 0666 and ADR 0667. - [G-2-pipelines-sizes-checks-and-tools](G-2-pipelines-sizes-checks-and-tools.md): pipelines per module: any size, the pipeline makes the check, who may say what, health, recovery, tools, kept data, how G itself is delivered, the choices under ADR 0666 and ADR 0667.
@@ -112,5 +112,7 @@ The part is twenty-two files, each read whole, its design lines numbered across
- [G-20-lead-answers](G-20-lead-answers.md): the lead's one-line answers to develop's questions, each tested against the principles (A-1 on). - [G-20-lead-answers](G-20-lead-answers.md): the lead's one-line answers to develop's questions, each tested against the principles (A-1 on).
- [G-21-provider-and-revert-ask](G-21-provider-and-revert-ask.md): the provider a requirement points to, the named seat and the contribution edge (§708, §709, completing §357), and the assigner's ask of a held revert (§710, completing §300), the edge an acting rule gives (§711, completing §47's kind 5), the validation before take-in (§712, §713, completing §16), the take-in and groups of every watched branch (§714, §715), where the gate keeps a group's members (§716) and the seats of the status view's and the assigner's views, followed before their holder is known (§717). - [G-21-provider-and-revert-ask](G-21-provider-and-revert-ask.md): the provider a requirement points to, the named seat and the contribution edge (§708, §709, completing §357), and the assigner's ask of a held revert (§710, completing §300), the edge an acting rule gives (§711, completing §47's kind 5), the validation before take-in (§712, §713, completing §16), the take-in and groups of every watched branch (§714, §715), where the gate keeps a group's members (§716) and the seats of the status view's and the assigner's views, followed before their holder is known (§717).
- [G-22-lead-answers-2](G-22-lead-answers-2.md): the lead's answers continued, from A-182. - [G-22-lead-answers-2](G-22-lead-answers-2.md): the lead's answers continued, from A-182.
- [G-23-after-delivery](G-23-after-delivery.md): what is owed once G is delivered.
- [G-24-composition-runs-and-test-runs](G-24-composition-runs-and-test-runs.md): one composition run per candidate and machine, one test run per level and tested packages, from G's live delivery of 2026-11-17 (§718 to §733).
Design 34's milestone [every-event](../34-milestones/every-event.md) and design 46's milestone [7-approval-mark](../46-milestones/7-approval-mark.md) ship in milestone G's release, built in its repositories beside G's lines (lead-47, 2026-11-11 15:30 CET); where one of their lines and a line of G differ, G's later line holds and the other is corrected in place (§624 to §626). Design 34's milestone [every-event](../34-milestones/every-event.md) and design 46's milestone [7-approval-mark](../46-milestones/7-approval-mark.md) ship in milestone G's release, built in its repositories beside G's lines (lead-47, 2026-11-11 15:30 CET); where one of their lines and a line of G differ, G's later line holds and the other is corrected in place (§624 to §626).