G D-7: the bootstrapped seat copies are laid again from the contracts' heads, byte for byte

node-engine, node-backup, operator-channel, mesh-broker, mesh-config, mesh-conditions,
mesh-catalog and mesh-delivery-checker, with the tests' own seat list and the captured
copies (mesh-contracts b76e52d, mesh-delivery 5bf8481).

Builds: design 47 G §203, §427
Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
This commit is contained in:
2026-11-11 21:30:48 +01:00
parent 311b7380aa
commit 72e1cb77de
25 changed files with 1133 additions and 2129 deletions
+194 -54
View File
@@ -6,7 +6,6 @@
"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).",
"held-by-the-engine": true,
"acts": [
{
"step": "compose",
@@ -695,11 +694,6 @@
{
"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.",
"callers": [
"persons",
"sessions",
"healers"
],
"input": {
"type": "object",
"properties": {}
@@ -711,11 +705,6 @@
{
"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.",
"callers": [
"persons",
"sessions",
"healers"
],
"input": {
"type": "object",
"properties": {}
@@ -724,14 +713,112 @@
"$ref": "#/defs/SeatList"
}
},
{
"name": "first-views",
"description": "The node-engine's first views of the owners' states it follows (design 47 G 422, 204): per owner and state, the tool it asks, the revision its picture holds and why it is behind, when it asked and was answered, how many asks and whether its condition is raised; served by mesh-sdk's runtime as the view's read tool.",
"class": "read",
"input": {
"type": "object",
"properties": {}
},
"answer": {
"type": "object",
"required": [
"first-views"
],
"properties": {
"first-views": {
"type": "array",
"items": {
"type": "object"
},
"description": "one status per owner and state followed, as mesh-sdk's views runtime keeps it"
}
}
}
},
{
"name": "first-view-again",
"description": "Ask the node-engine's first view of an owner's state again now, by hand (design 47 G 422, 204): a hand act, its caller and why kept in the status first-views reads; served by mesh-sdk's runtime as the view's again tool.",
"class": "act",
"input": {
"type": "object",
"required": [
"owner",
"state",
"why"
],
"properties": {
"owner": {
"type": "string",
"description": "the owner module, as first-views names it"
},
"state": {
"type": "string",
"description": "the owner's state, as first-views names it"
},
"why": {
"type": "string",
"description": "why it is asked again, in plain words"
}
}
},
"answer": {
"type": "object",
"required": [
"asked",
"read"
],
"properties": {
"asked": {
"type": "object",
"description": "the hand ask written",
"required": [
"v",
"owner",
"state",
"why",
"by",
"at"
],
"properties": {
"v": {
"type": "integer",
"description": "the layout's version"
},
"owner": {
"type": "string",
"description": "the owner module"
},
"state": {
"type": "string",
"description": "the owner's state"
},
"why": {
"type": "string",
"description": "why it was asked again"
},
"by": {
"type": "string",
"description": "the caller the runtime proved"
},
"at": {
"type": "string",
"format": "date-time",
"description": "when it was asked, RFC 3339"
}
}
},
"read": {
"type": "string",
"description": "the verb that reads the status, first-views"
}
}
}
},
{
"name": "process-builds",
"description": "The build each process on this node was started with (design 47 *The revision view*): per service and container the fingerprint the node-engine handed it in MESH_FINGERPRINT, or why it is unknown, and when it started. Narrowed by module. Reads only.",
"callers": [
"persons",
"sessions",
"healers"
],
"input": {
"type": "object",
"properties": {
@@ -796,10 +883,25 @@
}
},
{
"name": "capabilities-changed",
"subject": "capabilities-changed.<node>",
"name": "wait-held",
"subject": "wait-held.<node>.<module>",
"keep": {
"max-age-days": 0,
"last-per-subject": true
},
"body": {
"$ref": "#/defs/CapabilitiesChanged"
"$ref": "#/defs/Wait"
}
},
{
"name": "wait-ended",
"subject": "wait-ended.<node>.<module>",
"keep": {
"max-age-days": 0,
"last-per-subject": true
},
"body": {
"$ref": "#/defs/Wait"
}
}
],
@@ -905,6 +1007,9 @@
},
"handed": {
"$ref": "#/defs/AccountsHanded"
},
"wait": {
"$ref": "#/defs/Wait"
}
},
"required": [
@@ -2773,7 +2878,7 @@
},
"Running": {
"type": "object",
"description": "a module running healthy on a node at a build: what the node-engines of other nodes and the grants part decide a seat's pass from (ADR 0660 §2), 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 §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",
"properties": {
"v": {
"type": "integer",
@@ -2795,14 +2900,21 @@
"type": "string",
"description": "the digest of that build's manifest, the indexer's manifest of it, read by digest from the catalog half"
},
"healthy": {
"type": [
"boolean",
"null"
],
"description": "the health of the build that runs, as the node-engine's have holds it from the module's declared check (ADR 0240); a running with none, said by a node-engine of before design 47 G, reads as healthy (design 47 G 520). SeatsToPassOn reads none of it: an unhealthy holder still holds its seat"
},
"at": {
"type": "string",
"description": "when it was seen running healthy, RFC 3339",
"description": "when it was said, RFC 3339",
"format": "date-time"
},
"stopped": {
"type": "boolean",
"description": "true when the module no longer runs on the node: no fingerprint or manifest then (design 47 G 365, 404); mesh-sdk's SeatsToPassOn counts such a module as not running there"
"description": "true when the have no longer holds the module on the node, never for an unhealthy build: no fingerprint or manifest then (design 47 G 365, 404, 520); mesh-sdk's SeatsToPassOn counts such a module as not running there"
}
},
"required": [
@@ -2812,38 +2924,6 @@
"at"
]
},
"CapabilitiesChanged": {
"type": "object",
"description": "a node's capabilities changed, which the assigner places by",
"properties": {
"v": {
"type": "integer",
"description": "the layout's version"
},
"node": {
"type": "string",
"description": "the node"
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
},
"description": "its capabilities now"
},
"at": {
"type": "string",
"description": "when, RFC 3339",
"format": "date-time"
}
},
"required": [
"v",
"node",
"capabilities",
"at"
]
},
"ProcessBuild": {
"type": "object",
"description": "the build one process of a module was started with",
@@ -2908,6 +2988,66 @@
"node",
"processes"
]
},
"Wait": {
"type": "object",
"description": "a hold or wait a node-engine says, the fields of the seat mesh-wants' wait (design 47 G 498, 512, 629); in the have it also carries ask-at and act (design 47 G 560)",
"properties": {
"owner": {
"type": "string",
"description": "the seat holding the wait: node-engine"
},
"step": {
"type": "string",
"enum": [
"compose",
"kept-build"
],
"description": "compose: a hold of the composition (a restore point missing, an entry missing, parts that differ, a recovery that waits); kept-build: waiting for a kept build (design 47 G 499, 541)"
},
"node": {
"type": "string",
"description": "the node waited on: the build node for a kept build; the subject's <node> is the node that says it"
},
"on": {
"type": "string",
"description": "what it waits on"
},
"bound": {
"type": "string",
"description": "a duration such as 30m"
},
"since": {
"type": "string",
"format": "date-time"
},
"clock-from": {
"type": "string",
"format": "date-time",
"description": "the time the bound counts from (design 47 G 266, 269, 498)"
},
"words": {
"type": "string",
"description": "the wait said in words"
},
"reason": {
"type": "string",
"description": "why it holds, such as restore point missing, entry-missing, parts-differ, node away or build no longer kept (design 47 G 541, 499)"
},
"ask-at": {
"type": "string",
"format": "date-time",
"description": "in the have: the time of the first ask of the recovery module for this wait (design 47 G 560)"
},
"act": {
"type": "string",
"description": "in the have: the act the recovery module answered accepted with (design 47 G 560)"
}
},
"required": [
"step",
"since"
]
}
}
}