The tests' seat list holds the group's definitions: mesh-recovery and four more seats, eleven taken again

seatlisttest gains mesh-builds, mesh-delivery-view, mesh-grants,
mesh-pipeline-runner and mesh-recovery, which the live list (revision 473)
holds, and takes again the eleven definitions and two parts the group's heads
change (mesh-contracts feat/47-H2 e6ed560e, mesh-delivery feat/47-H2 80ff1afa,
mesh-catalog's form 5 from feat/47-H2-i 5e943280), so a test judges a manifest
against the seats the running validator judges it against. The three
bootstrapped seats among them (mesh-catalog, mesh-delivery, node-engine) are
replaced in the bootstrap and its captured contracts copy too (ADR 0635 §3,
ADR 0636 §7); the service manager's tests take its kernel-log verb, and the
grants module's name, now also a seat's, joins the kept names.

Builds: design 47 H2, H-A-452
This commit is contained in:
2026-11-22 02:29:29 +01:00
parent f90189353c
commit a323a3fd54
28 changed files with 7535 additions and 150 deletions
+3
View File
@@ -22,6 +22,9 @@ mesh-delivery d24d6a08905996841b62c723736339e809ca4625 modules/mesh-delivery-co
mesh-delivery 6e027de59773affe80d7bf45cf49d81292893ff1 modules/mesh-delivery-contracts/seats/mesh-delivery/seat.json, taken again as seat.json.captured (milestone 47/H1, C3)
mesh-delivery 9a55e6e8c0faa36dd96be2d90c13e5bb42be0bf3 modules/mesh-delivery-contracts/seats/git, mesh-delivery and mesh-catalog, taken again as seat.json.captured (milestone 47/H1, through C1d)
mesh-delivery d2d3ebbf44fbf0362edaf78d991615f564644615 modules/mesh-delivery-contracts/seats/git/seat.json, taken again as seat.json.captured (milestone 47/H2, D5)
mesh-contracts e6ed560e48216024a0ab6851074c134e69a9bc2b seats/node-engine/seat.json, taken again as seat.json.captured (milestone 47/H2, branch feat/47-H2, H-A-452)
mesh-delivery 80ff1afacca4c1d2e61b0e31139b140645c8088b modules/mesh-delivery-contracts/seats/mesh-delivery/seat.json, taken again as seat.json.captured (milestone 47/H2, branch feat/47-H2, H-A-452)
mesh-delivery 5e94328066198d72cf4fd5d6f1c57b6ad1c8e967 modules/mesh-delivery-contracts/seats/mesh-catalog/seat.json, taken again as seat.json.captured (milestone 47/H2, branch feat/47-H2-i, its form 5, H-A-452)
mesh-host cdcba9ca73755854d21e4e657d7e46c32b9b5265 internal/apply/placement_guard.go
The two seat copies are put back the same way (git show <commit>:<file> > <file>.captured, the path kept). To move the others, from this repository's go/ directory, with the two repositories checked out beside mesh-sdk:
@@ -1,11 +1,12 @@
{
"format": 1,
"form": 3,
"seat": "node-engine",
"scope": "node",
"grain": "whole",
"domain": "Core",
"decision": "novox/hq ADR 0563",
"description": "The node seat every node's engine holds (novox/hq ADR 0563, ADR 0618 §3, §4): its hand acts on the operator's warrant, its read-only judgements, its compositions and what it reads of a manifest. Each verb is answered on this node's subject, mesh.seat.node-engine.tool.<verb>.<node>, and each event is published on mesh.seat.node-engine.event.<event>.<node>, the node's name its last token, or, for an event whose subject names <node>, there (composed.<node>, running.<node>.<module>): the grants part grants a node's account only its own node's subjects (ADR 0363 §2).",
"description": "The node seat every node's engine holds (novox/hq ADR 0563, ADR 0618 \u00a73, \u00a74): its hand acts on the operator's warrant, its read-only judgements, its compositions and what it reads of a manifest. Each verb is answered on this node's subject, mesh.seat.node-engine.tool.<verb>.<node>, and each event is published on mesh.seat.node-engine.event.<event>.<node>, the node's name its last token, or, for an event whose subject names <node>, there (composed.<node>, running.<node>.<module>): the grants part grants a node's account only its own node's subjects (ADR 0363 \u00a72).",
"acts": [
{
"step": "compose",
@@ -15,7 +16,7 @@
"verbs": [
{
"name": "hand-over",
"description": "Hand a directory this machine uses as found to the mesh (novox/hq ADR 0563 §3, §5): the engine judges the path as it does every hand-over (absolute, as it states it, used as found, reached through no link) and refuses in words, or asks the operator on their channel at the level approve, binding the owner, group and mode it will set. Nothing changes on the call: only the operator's yes hands it over. One ask is open per path; acts shows where it stands.",
"description": "Hand a directory this machine uses as found to the mesh (novox/hq ADR 0563 \u00a73, \u00a75): the engine judges the path as it does every hand-over (absolute, as it states it, used as found, reached through no link) and refuses in words, or asks the operator on their channel at the level approve, binding the owner, group and mode it will set. Nothing changes on the call: only the operator's yes hands it over. One ask is open per path; acts shows where it stands.",
"input": {
"properties": {
"path": {
@@ -39,7 +40,7 @@
},
{
"name": "access-act",
"description": "Ask the operator for the take act on a library whose root holds data outside its group (novox/hq ADR 0328 §7, ADR 0563 §3, §4), on the library's home engine: the access as declared and its root as last declared, judged and refused in words or asked at the level approve. Only the operator's yes sets the library's group, group write and setgid under its root. One ask is open per access.",
"description": "Ask the operator for the take act on a library whose root holds data outside its group (novox/hq ADR 0328 \u00a77, ADR 0563 \u00a73, \u00a74), on the library's home engine: the access as declared and its root as last declared, judged and refused in words or asked at the level approve. Only the operator's yes sets the library's group, group write and setgid under its root. One ask is open per access.",
"input": {
"properties": {
"access": {
@@ -68,7 +69,7 @@
},
{
"name": "judge-directories",
"description": "Which of this machine's declared directories the engine would refuse to make or keep, one line each (novox/hq ADR 0563 §2). Read-only: changes no owner or mode.",
"description": "Which of this machine's declared directories the engine would refuse to make or keep, one line each (novox/hq ADR 0563 \u00a72). Read-only: changes no owner or mode.",
"input": {
"properties": {},
"type": "object"
@@ -80,7 +81,7 @@
},
{
"name": "setuid-search",
"description": "Throw away the engine's last search for setuid programs and start a full one (novox/hq ADR 0563 §2); until it completes root-free answers that the machine is not judged yet. Refused while one runs, and when one was started within the hour, naming when the next may start.",
"description": "Throw away the engine's last search for setuid programs and start a full one (novox/hq ADR 0563 \u00a72); until it completes root-free answers that the machine is not judged yet. Refused while one runs, and when one was started within the hour, naming when the next may start.",
"input": {
"properties": {
"why": {
@@ -97,7 +98,7 @@
},
{
"name": "root-free",
"description": "Whether this machine is root-free (novox/hq ADR 0259 §8, ADR 0563 §6): free only on the engine's own verdict, at most fifteen minutes old, that the account agents run as cannot become root without a person, and the login shell's execute not served here. Anything else is no pass, and says why. Answered by this machine's engine alone.",
"description": "Whether this machine is root-free (novox/hq ADR 0259 \u00a78, ADR 0563 \u00a76): free only on the engine's own verdict, at most fifteen minutes old, that the account agents run as cannot become root without a person, and the login shell's execute not served here. Anything else is no pass, and says why. Answered by this machine's engine alone.",
"input": {
"properties": {},
"type": "object"
@@ -121,7 +122,7 @@
},
{
"name": "acts",
"description": "Every act this machine's engine was asked through this seat (novox/hq ADR 0563 §9): each hand-over, access act and setuid search, open, done or refused, with who asked, the ask and the operator's warrant. Read-only.",
"description": "Every act this machine's engine was asked through this seat (novox/hq ADR 0563 \u00a79): each hand-over, access act and setuid search, open, done or refused, with who asked, the ask and the operator's warrant. Read-only.",
"input": {
"properties": {
"id": {
@@ -242,7 +243,7 @@
"type": "string"
},
"digest": {
"description": "a composition's digest (sha256:…), to read that revision rather than the latest",
"description": "a composition's digest (sha256:\u2026), to read that revision rather than the latest",
"type": "string"
},
"module": {
@@ -287,7 +288,7 @@
},
"self": {
"type": "boolean",
"description": "the node composes the module itself (ADR 0547 §2)"
"description": "the node composes the module itself (ADR 0547 \u00a72)"
},
"backup": {
"type": "string",
@@ -517,6 +518,27 @@
"withheld-unknown": {
"type": "string",
"description": "withheld unknown: the grants part does not answer, when its verb withheld did not answer"
},
"withheld-parts": {
"type": "array",
"description": "each part a compose kept because its read did not answer, with why (design 08 control-verbs \u00a74, H-A-321): for the packet filter's holder the part node-packet-filter.allowed, its filter file kept as it runs",
"items": {
"type": "object",
"required": [
"part",
"why"
],
"properties": {
"part": {
"type": "string",
"description": "the read asked, as <seat>.<verb>"
},
"why": {
"type": "string",
"description": "why it did not answer, naming the holder asked"
}
}
}
}
},
"required": [
@@ -529,6 +551,63 @@
},
"class": "read"
},
{
"name": "composition-diff",
"description": "One module's composed values read by resource (design 47 H2 \u00a7813 (3), H-A-349 DQ-12b): given a module and a revision or a digest of its composition, the entries that differ between the composition that runs and that one, per resource, environment entries by name, a secret's value masked. Read-only. Answered by this machine's engine alone.",
"class": "read",
"input": {
"type": "object",
"required": [
"module"
],
"properties": {
"module": {
"type": "string",
"description": "the module, as placed on this machine; node for the node's own"
},
"revision": {
"type": "integer",
"description": "the revision of the module's composition key to compare with, from the revisions the bucket keeps; give it or digest"
},
"digest": {
"type": "string",
"description": "the digest (sha256:\u2026) of the composition to compare with; give it or revision"
}
}
},
"answer": {
"type": "object",
"required": [
"node",
"module",
"resources"
],
"properties": {
"node": {
"type": "string",
"description": "the node"
},
"module": {
"type": "string",
"description": "the module"
},
"running": {
"type": "string",
"description": "the digest of the composition that runs; absent when nothing runs"
},
"other": {
"$ref": "#/defs/Revision"
},
"resources": {
"type": "array",
"description": "each resource with an entry that differs; empty when none differs",
"items": {
"$ref": "#/defs/CompositionDiffResource"
}
}
}
}
},
{
"name": "compose",
"description": "Compose this machine's modules now and say how it went, so a composition that failed, or a module held, recovers without a restart: what the pass refused or held, each with why, and when the engine composes again on its own after a seat that did not answer (a deadline, no responders: retried with a growing wait; a refusal never). With module, that module's apply is also tried again. Changes only what a pass the engine makes on its own would change.",
@@ -595,7 +674,7 @@
},
{
"name": "compose-candidate",
"description": "Compose a check's candidate on this machine in shadow, with its own sealed values and the indexer's manifest verdicts, and say per module placed here whether it composes (with its digest and whether the candidate changes it), is refused by the candidate or is held without it, each with why, and the verdict of the machine's own composition (novox/hq ADR 0593 §7). Read-only: applies nothing and writes nothing. Answered by this machine's engine alone, within the asker's bound.",
"description": "Compose a check's candidate on this machine in shadow, with its own sealed values and the indexer's manifest verdicts, and say per module placed here whether it composes (with its digest and whether the candidate changes it), is refused by the candidate or is held without it, each with why, and the verdict of the machine's own composition (novox/hq ADR 0593 \u00a77). Read-only: applies nothing and writes nothing. Answered by this machine's engine alone, within the asker's bound.",
"optional": true,
"input": {
"properties": {
@@ -640,7 +719,7 @@
"unready",
"not-judged"
],
"description": "the node's verdict (ADR 0593 §7, §9)"
"description": "the node's verdict (ADR 0593 \u00a77, \u00a79)"
},
"modules": {
"type": "array",
@@ -686,7 +765,7 @@
{
"name": "manifest-reads",
"optional": true,
"description": "The reader capabilities this machine's engine states (manifest words, forms and seat names it reads, novox/hq ADR 0618 §3) and when it last stated them. An engine built before it said them states none, which a reader takes as the baseline. Read-only. Answered by this machine's engine alone.",
"description": "The reader capabilities this machine's engine states (manifest words, forms and seat names it reads, novox/hq ADR 0618 \u00a73) and when it last stated them. An engine built before it said them states none, which a reader takes as the baseline. Read-only. Answered by this machine's engine alone.",
"input": {
"type": "object",
"properties": {}
@@ -720,7 +799,7 @@
"node",
"stated-at"
],
"description": "what this machine's engine reads of a manifest (ADR 0618 §3)"
"description": "what this machine's engine reads of a manifest (ADR 0618 \u00a73)"
},
"class": "read"
},
@@ -787,7 +866,7 @@
},
{
"name": "seat-list",
"description": "The seat list this engine holds and what it waits for (novox/hq ADR 0636 §7): each seat's source (trunk or bootstrap) and digest, the seats held from the bootstrap alone, the definitions refused, the last error and whether the seat mesh-catalog has answered. Read-only.",
"description": "The seat list this engine holds and what it waits for (novox/hq ADR 0636 \u00a77): each seat's source (trunk or bootstrap) and digest, the seats held from the bootstrap alone, the definitions refused, the last error and whether the seat mesh-catalog has answered. Read-only.",
"input": {
"type": "object",
"properties": {}
@@ -798,7 +877,7 @@
},
{
"name": "seat-list-again",
"description": "Make this engine read the seat list from the seat mesh-catalog now (novox/hq ADR 0636 §7), the recovery of a list unread; it answers what it holds afterwards, and the error when the read failed. A read that changed nothing still ends the engine's wait.",
"description": "Make this engine read the seat list from the seat mesh-catalog now (novox/hq ADR 0636 \u00a77), the recovery of a list unread; it answers what it holds afterwards, and the error when the read failed. A read that changed nothing still ends the engine's wait.",
"input": {
"type": "object",
"properties": {}
@@ -1057,6 +1136,52 @@
"$ref": "#/defs/ProcessBuilds"
},
"class": "read"
},
{
"name": "converged",
"description": "The node's convergence state, which the node-engine keeps (ADR 0168, ADR 0683; design 33 control-verbs \u00a710): adopted or converged, since when it became so, for an adopted node the kind of the firewall found, and the node's links as the engine classifies them: the tunnel's interface and the outward links (design 47 H-A-325). Read-only: the holder of node-packet-filter asks it at its start and at every allow and disallow, and refuses when it does not answer.",
"class": "read",
"input": {
"type": "object",
"properties": {}
},
"answer": {
"type": "object",
"required": [
"state",
"tunnel",
"outward"
],
"properties": {
"state": {
"type": "string",
"enum": [
"adopted",
"converged"
],
"description": "the node's mode: adopted (the found firewall's terms) or converged (the mesh's own filter)"
},
"since": {
"type": "string",
"description": "when the node became so, RFC 3339; absent where the engine recorded no time for it"
},
"found": {
"type": "string",
"description": "the kind of the firewall found, for an adopted node"
},
"tunnel": {
"type": "string",
"description": "the private network's tunnel interface on this node, as the engine's filter render names it"
},
"outward": {
"type": "array",
"items": {
"type": "string"
},
"description": "the links of this node that face outside, as the engine classifies them for its filter render (ADR 0140); an allowance with no interface never opens one"
}
}
}
}
],
"events": [
@@ -1205,6 +1330,10 @@
"type": "boolean",
"description": "the move changes the build alone"
},
"run": {
"type": "string",
"description": "the composition run's pipeline sequence, in decimal, the module was applied from (design 47 H2 §813 (1), H-A-388): a restarted engine applies no older run again"
},
"kept": {
"type": "array",
"items": {
@@ -1696,7 +1825,7 @@
"description": "one finding of the observer that wrote it"
}
],
"description": "the findings this node's engine raises about itself, one key per finding, in the layout of the seat mesh-conditions (its findings state): a key written raises the condition of the same key, a key deleted clears it (novox/hq ADR 0564 §2, ADR 0636 §1); today `machine.<node>.seat-list-unread`"
"description": "the findings this node's engine raises about itself, one key per finding, in the layout of the seat mesh-conditions (its findings state): a key written raises the condition of the same key, a key deleted clears it (novox/hq ADR 0564 \u00a72, ADR 0636 \u00a71); today `machine.<node>.seat-list-unread`"
},
{
"name": "bounds",
@@ -1708,7 +1837,7 @@
"key": "<what>.<id>",
"value": {
"type": "object",
"description": "one bound a wait of the node-engine runs against, kept with its own time to live: its expiry is heard as the bus's delete marker and ends the wait (design 47 G §560, A-77)",
"description": "one bound a wait of the node-engine runs against, kept with its own time to live: its expiry is heard as the bus's delete marker and ends the wait (design 47 G \u00a7560, A-77)",
"properties": {
"v": {
"type": "integer",
@@ -1815,7 +1944,7 @@
},
"auto": {
"type": "boolean",
"description": "the engine asked it itself, on finding a library's root holding data outside its group (ADR 0563 §4)"
"description": "the engine asked it itself, on finding a library's root holding data outside its group (ADR 0563 \u00a74)"
}
},
"required": [
@@ -1825,7 +1954,7 @@
"at",
"state"
],
"description": "one act asked through the seat, as acts reads it (ADR 0563 §9)"
"description": "one act asked through the seat, as acts reads it (ADR 0563 \u00a79)"
},
"ActSaid": {
"type": "object",
@@ -1870,7 +1999,7 @@
"state",
"node"
],
"description": "what the seat says of an act: the act, the path or access, the caller as the runtime proved it and the ask (ADR 0563 §1)"
"description": "what the seat says of an act: the act, the path or access, the caller as the runtime proved it and the ask (ADR 0563 \u00a71)"
},
"Acts": {
"type": "object",
@@ -1961,7 +2090,7 @@
"at",
"why"
],
"description": "what a node-engine says when what it reads changed or its node returned (ADR 0618 §4)"
"description": "what a node-engine says when what it reads changed or its node returned (ADR 0618 \u00a74)"
},
"Module": {
"type": "object",
@@ -2061,7 +2190,7 @@
"why",
"judged"
],
"description": "the engine's root-free verdict (ADR 0563 §6)"
"description": "the engine's root-free verdict (ADR 0563 \u00a76)"
},
"Said": {
"type": "object",
@@ -2106,7 +2235,7 @@
},
"SeatList": {
"type": "object",
"description": "what an engine holds of the seat list (novox/hq ADR 0636 §7)",
"description": "what an engine holds of the seat list (novox/hq ADR 0636 \u00a77)",
"properties": {
"status": {
"type": "object",
@@ -2451,6 +2580,10 @@
"type": "string"
}
},
"declaration-reads": {
"type": "integer",
"description": "the declaration Version its engine reads (design 47 H2 §813 (12), H-A-416 (2), H-A-419): the composer writes this node's declaration at the lower of its own Version and this one, 1 when none is stated"
},
"runner-capabilities": {
"type": "array",
"items": {
@@ -3160,7 +3293,7 @@
},
"Running": {
"type": "object",
"description": "a module's build running on a node, and its health: what the node-engines of other nodes and the grants part decide a seat's pass from (ADR 0660 §2), and the assigner reads a provider's and a canary's health and a put's end from (design 47 G 520); said again on the same subject each time healthy changes and for every module the have holds at the engine's start, kept last per subject with no age limit",
"description": "a module's build running on a node, and its health: what the node-engines of other nodes and the grants part decide a seat's pass from (ADR 0660 \u00a72), and the assigner reads a provider's and a canary's health and a put's end from (design 47 G 520); said again on the same subject each time healthy changes and for every module the have holds at the engine's start, kept last per subject with no age limit",
"properties": {
"v": {
"type": "integer",
@@ -3331,6 +3464,52 @@
"step",
"since"
]
},
"CompositionDiffEntry": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "the entry: an environment entry by its name, else the part of the resource that differs"
},
"running": {
"type": "string",
"description": "its value in the running composition; absent where the running one lacks it or the value is a secret"
},
"other": {
"type": "string",
"description": "its value in the other composition; absent where the other lacks it or the value is a secret"
},
"masked": {
"type": "boolean",
"description": "the value is a secret, so neither value is given"
}
},
"description": "one entry that differs between the running composition and the other"
},
"CompositionDiffResource": {
"type": "object",
"required": [
"resource",
"entries"
],
"properties": {
"resource": {
"type": "string",
"description": "the resource, as the composition names it"
},
"entries": {
"type": "array",
"items": {
"$ref": "#/defs/CompositionDiffEntry"
},
"description": "the entries of the resource that differ"
}
},
"description": "one resource with the entries of it that differ"
}
}
}
@@ -253,6 +253,49 @@
},
"class": "read"
},
{
"name": "seat-list",
"class": "read",
"description": "The trunk's seat list as the mesh holds it, the object of the holder's objects seat-lists of that digest (design 47 H2 §814, §820; H-A-441, H-A-443): its digest and size, then its bytes (the definitions resolved, a JSON array in the form of a composer request's seats, sorted by seat) in chunks of at most 512 KiB on the chunk subject of the call, each acknowledged by the caller on the ack subject within 30 seconds. A validate run's asker fills the request's seats from these bytes. Reads only.",
"input": {
"type": "object",
"properties": {
"call": {
"type": "string",
"description": "128 random bits the caller chooses: the subject token of this send's chunks and acknowledgements",
"minLength": 1
}
},
"required": [
"call"
]
},
"answer": {
"type": "object",
"properties": {
"digest": {
"type": "string",
"description": "the seat list's sha256, the object's name in seat-lists"
},
"size": {
"type": "integer",
"minimum": 0,
"description": "the seat list's size in bytes"
},
"chunks": {
"type": "integer",
"minimum": 0,
"description": "how many chunks are sent"
}
},
"required": [
"digest",
"size",
"chunks"
]
},
"chunks": true
},
{
"name": "revision",
"description": "The catalog half of the revision view (ADR 0656 §6): one catalog graph revision with its entries whole, the trunk heads, the seat definitions by digest, and each manifest's verdict and fingerprint; the trunk's newest when no revision and no candidate is named, or a candidate's for its group and heads. Answered by the holder from what it holds, in its own runtime (ADR 0663), in pages of entries. Reads only. A watched branch with no revision yet answers {none-yet: true} alone (design 47 G section 530).",
@@ -312,7 +355,7 @@
},
{
"name": "registrations",
"description": "Every module's registration, or one with every version and who changed it on whose warrant (design 47 *A module's registration*). Its readers take a first view here, then hear registration-changed.",
"description": "Every module's registration, or one with every version and who changed it on whose warrant (design 47 *A module's registration*). Its readers take a first view here, then hear registration-changed. Filtered by module or repository while it reads and paged by the cursor next, at most 768 KB a page (design 47 H2 §806, §811).",
"input": {
"type": "object",
"properties": {
@@ -323,6 +366,14 @@
"history": {
"type": "boolean",
"description": "with every version of the one module"
},
"repository": {
"type": "string",
"description": "only the registrations of this repository, <owner>/<name>, applied while reading (design 47 H2 §806)"
},
"next": {
"type": "string",
"description": "the cursor the previous page answered, opaque; absent for the first page (design 47 H2 §779)"
}
}
},
@@ -344,6 +395,18 @@
},
"fill": {
"$ref": "#/defs/Fill"
},
"capped": {
"type": "boolean",
"description": "yes when the answer stopped at 768 KB; the rest is read from next (design 47 H2 §806)"
},
"total": {
"type": "integer",
"description": "how many registrations the filters hold in all (design 47 H2 §811)"
},
"next": {
"type": "string",
"description": "the cursor of the next page, opaque; empty at the end (design 47 H2 §779)"
}
},
"required": [
@@ -657,6 +720,32 @@
"source": {
"type": "integer"
},
"call": {
"type": "string",
"description": "what made the revision, as the revision's call names it (design 47 H-A-212, H-A-213); absent for a candidate's"
},
"call-kind": {
"type": "string",
"enum": [
"take-in",
"release",
"take-in-again",
"recompute"
],
"description": "the kind of what made the revision, which a reader reads instead of call's words (design 47 H-A-213 (3), H-A-214, H-A-215, H-A-217); absent for a candidate's"
},
"module": {
"type": "string",
"description": "for call-kind release, the module released (H-A-215)"
},
"version": {
"type": "string",
"description": "for call-kind release, the version released (H-A-215)"
},
"repository": {
"type": "string",
"description": "for call-kind take-in-again, the repository taken in again (H-A-215)"
},
"group": {
"type": "string"
},
@@ -1448,6 +1537,13 @@
"$ref": "#/defs/Registration"
},
"description": "a module's registration"
},
{
"key": "source.<owner>.<name>",
"value": {
"$ref": "#/defs/Registration"
},
"description": "a source-only registration of a repository with no module (design 47 H2 §815)"
}
]
},
@@ -1462,6 +1558,13 @@
"$ref": "#/defs/Registration"
},
"description": "one version of a module's registration"
},
{
"key": "source.<owner>.<name>.<version>",
"value": {
"$ref": "#/defs/Registration"
},
"description": "one version of a source-only registration (design 47 H2 §815)"
}
]
},
@@ -1594,6 +1697,10 @@
"type": "string",
"description": "its manifest's verdict: accepted, refused or held"
},
"class": {
"type": "string",
"description": "core or leaf: core when its manifest claims a seat, leaf when it claims none; an entry without it reads as leaf (design 47 H2 H-A-394, H-A-431)"
},
"fp": {
"type": "string",
"description": "its fingerprint (src2: and 64 hex digits); absent when it has none"
@@ -1871,6 +1978,32 @@
"type": "integer",
"description": "the source revision it was taken in from; for a candidate, the source revision its heads are merged onto"
},
"call": {
"type": "string",
"description": "what made the revision (design 47 H-A-212, H-A-213): a take-in's the gate's call its source revision names, a re-pin's release of <module> <version>, a take-in again's take-in again of <repository>; absent for a candidate's"
},
"call-kind": {
"type": "string",
"enum": [
"take-in",
"release",
"take-in-again",
"recompute"
],
"description": "the kind of what made the revision, which a reader reads instead of call's words (design 47 H-A-213 (3), H-A-214, H-A-215, H-A-217): a take-in's, a re-pin's on a module's release, a take-in again's, a recompute's that moved a fingerprint (its call naming the reason); absent for a candidate's"
},
"module": {
"type": "string",
"description": "for call-kind release, the module released (H-A-215)"
},
"version": {
"type": "string",
"description": "for call-kind release, the version released (H-A-215)"
},
"repository": {
"type": "string",
"description": "for call-kind take-in-again, the repository taken in again (H-A-215)"
},
"group": {
"type": "string",
"description": "a candidate's group"
@@ -1927,6 +2060,10 @@
"$ref": "#/defs/TakeInEntry"
},
"description": "the movers of the take-in that wrote it, so a redelivered source-moved whose revision is kept says take-in.taken again from them, recomputing nothing (design 47 H §743, H-A-92); absent for one with no mover"
},
"base": {
"type": "integer",
"description": "the newest kept revision of its branch below it, which the take-in that wrote it pinned for its pipeline: the base of the validate step's case before (design 47 H-A-147, H-A-151, H-A-154); absent on the branch's first take-in"
}
},
"required": [
@@ -2078,14 +2215,15 @@
},
"Registration": {
"type": "object",
"description": "a module's registration (ADR 0666 section 2; design 47 *A module's registration*): its git origin, its manifest's path, its watched branches and its policy, every version with who changed it and the warrant of the operator's Approve",
"description": "a module's registration (ADR 0666 section 2; design 47 *A module's registration*): its git origin, its manifest's path, its watched branches and its policy, every version with who changed it and the warrant of the operator's Approve; or a source-only registration of a repository with no module (design 47 H2 §815): its origin, one watched branch, its policy and its check, naming no module and no path, kept under source.<owner>.<name>",
"properties": {
"v": {
"type": "integer",
"description": "the layout version"
},
"module": {
"type": "string"
"type": "string",
"description": "the module; absent for a source-only registration"
},
"origin": {
"type": "string",
@@ -2093,7 +2231,7 @@
},
"path": {
"type": "string",
"description": "the path of its manifest in the repository"
"description": "the path of its manifest in the repository; absent for a source-only registration"
},
"branches": {
"type": "array",
@@ -2121,12 +2259,14 @@
"at": {
"type": "string",
"format": "date-time"
},
"check": {
"$ref": "#/defs/SourceCheck",
"description": "for a source-only registration, the one step its heads run (design 47 H2 §815)"
}
},
"required": [
"module",
"origin",
"path",
"branches",
"policy"
]
@@ -2157,9 +2297,10 @@
"placed",
"review required",
"unknown module",
"nothing moves"
"nothing moves",
"holds-manifest"
],
"description": "why no ask was raised"
"description": "why no ask was raised; holds-manifest: a source-only registration whose repository holds a module.json at its root or under modules/ at the branch's head (design 47 H2 §815; H-A-450)"
},
"words": {
"type": "string",
@@ -2469,6 +2610,34 @@
"ref",
"language"
]
},
"SourceCheck": {
"type": "object",
"description": "the check of a source-only registration: a build seat and a step kind, run at the repository's root, never a free command (design 47 H2 §815)",
"properties": {
"seat": {
"type": "string",
"enum": [
"node-build-go",
"node-build-node",
"node-build-image"
],
"description": "the build seat that runs it"
},
"step": {
"type": "string",
"enum": [
"lint",
"unit",
"integration"
],
"description": "the step kind"
}
},
"required": [
"seat",
"step"
]
}
},
"bodies": {
@@ -2567,5 +2736,6 @@
"call"
]
}
}
},
"form": 5
}
@@ -9,7 +9,7 @@
"verbs": [
{
"name": "deliveries",
"description": "Every delivery not final, and those that ended in the last day, one line each: its id (owner/repository@commit), its state, its group, what it waits for and since when. Narrowed by state, repository or group.",
"description": "Every delivery not final, and those that ended in the last day, one line each: its id (owner/repository@commit), its state, its group, what it waits for and since when. Narrowed by state, repository or group. Filtered by repository, module, outcome and since while it reads, at most 768 KB a page, capped saying the rest is read from the cursor next (design 47 H2 §811).",
"input": {
"properties": {
"all": {
@@ -31,13 +31,55 @@
"state": {
"description": "one state, e.g. delivering or held",
"type": "string"
},
"module": {
"type": "string",
"description": "only the deliveries that move this module, applied while reading (design 47 H2 §811)"
},
"outcome": {
"type": "string",
"description": "only the deliveries that ended with this outcome, applied while reading (design 47 H2 §811)"
},
"since": {
"type": "string",
"format": "date-time",
"description": "only the deliveries opened at or after this time, applied while reading (design 47 H2 §811)"
},
"next": {
"type": "string",
"description": "the cursor the previous page answered, opaque; absent for the first page (design 47 H2 §779)"
}
},
"type": "object"
},
"answer": {
"type": "object",
"description": "what deliveries answers, as its description says"
"description": "what deliveries answers, as its description says",
"properties": {
"deliveries": {
"type": "array",
"items": {
"type": "object",
"description": "one delivery's record, as the gate keeps it"
},
"description": "this page's deliveries, the open ones first, then the newest"
},
"capped": {
"type": "boolean",
"description": "yes when the answer stopped at 768 KB; the rest is read from next (design 47 H2 §811)"
},
"total": {
"type": "integer",
"description": "how many deliveries the filters hold in all (design 47 H2 §811)"
},
"next": {
"type": "string",
"description": "the cursor of the next page, opaque; empty at the end (design 47 H2 §779)"
}
},
"required": [
"deliveries"
]
},
"class": "read"
},
@@ -196,7 +238,7 @@
"name": "record-opened",
"body": {
"type": "object",
"description": "a delivery record opened for one source revision of a merge call (design 47 H \u00a7737)",
"description": "a delivery record opened for one source revision of a merge call (design 47 H §737)",
"properties": {
"record": {
"type": "string",
@@ -319,7 +361,7 @@
"subject": "source-moved.<branch>.<source>",
"body": {
"type": "object",
"description": "a source revision of a watched branch, named once per merge call (design 47 H \u00a7737)",
"description": "a source revision of a watched branch, named once per merge call (design 47 H §737)",
"properties": {
"v": {
"type": "integer"
@@ -337,7 +379,7 @@
},
"start": {
"type": "boolean",
"description": "true only for a branch's first revision (design 47 H \u00a7768)"
"description": "true only for a branch's first revision (design 47 H §768)"
},
"heads": {
"type": "array",
@@ -448,7 +490,7 @@
},
"call": {
"type": "string",
"description": "the merge call that moved it; a call the newest revision already carries writes nothing (design 47 H \u00a7737, H-A-33)"
"description": "the merge call that moved it; a call the newest revision already carries writes nothing (design 47 H §737, H-A-33)"
}
},
"required": [
@@ -512,7 +554,7 @@
"name": "heads",
"template": "state",
"history": 1,
"description": "each head the forge bridge's head-moved said that source.<branch> does not name for that repository; deleted when source.<branch> names it (design 47 H \u00a7740)",
"description": "each head the forge bridge's head-moved said that source.<branch> does not name for that repository; deleted when source.<branch> names it (design 47 H §740)",
"key-forms": [
{
"key": "<repository>.<branch>",
@@ -672,5 +714,6 @@
"head"
]
}
}
},
"form": 2
}
+1
View File
@@ -1,3 +1,4 @@
buscompose/nats.go: mesh-grants
catalogue/environment_into.go: node-environment
catalogue/environment_into.go: node-login-shell
catalogue/environment_into.go: node-power