D-4, D-5, D-6: the bootstrapped and test seat definitions are the contracts' files at milestone G's heads

The catalogue's tests of the retired delivery verbs go with them.

Builds: design 47 G §203, §309, §365, §302, §337, §336, §389, §390, §83, §307, §308, §260, §349, §375
Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
This commit is contained in:
2026-11-11 11:27:05 +01:00
parent 77db185889
commit 66ad4956d5
44 changed files with 12333 additions and 480 deletions
+264 -14
View File
@@ -5,8 +5,14 @@
"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.",
"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",
"on": "every"
}
],
"verbs": [
{
"name": "hand-over",
@@ -29,7 +35,8 @@
},
"answer": {
"$ref": "#/defs/Asked"
}
},
"class": "warrant"
},
{
"name": "access-act",
@@ -57,7 +64,8 @@
},
"answer": {
"$ref": "#/defs/Asked"
}
},
"class": "warrant"
},
{
"name": "judge-directories",
@@ -68,7 +76,8 @@
},
"answer": {
"$ref": "#/defs/Said"
}
},
"class": "read"
},
{
"name": "setuid-search",
@@ -84,7 +93,8 @@
},
"answer": {
"$ref": "#/defs/Said"
}
},
"class": "read"
},
{
"name": "root-free",
@@ -107,7 +117,8 @@
"required": [
"machines"
]
}
},
"class": "read"
},
{
"name": "acts",
@@ -127,7 +138,8 @@
},
"answer": {
"$ref": "#/defs/Acts"
}
},
"class": "read"
},
{
"name": "packages",
@@ -217,7 +229,8 @@
"node",
"source"
]
}
},
"class": "read"
},
{
"name": "composition",
@@ -491,7 +504,8 @@
"composition",
"judged"
]
}
},
"class": "read"
},
{
"name": "compose",
@@ -554,7 +568,8 @@
"required": [
"pass"
]
}
},
"class": "act"
},
{
"name": "compose-candidate",
@@ -633,7 +648,8 @@
"own",
"took"
]
}
},
"class": "read"
},
{
"name": "manifest-reads",
@@ -673,12 +689,17 @@
"stated-at"
],
"description": "what this machine's engine reads of a manifest (ADR 0618 §3)"
}
},
"class": "read"
},
{
"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": "the operator and the healers",
"callers": [
"persons",
"sessions",
"healers"
],
"input": {
"type": "object",
"properties": {}
@@ -690,7 +711,11 @@
{
"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": "the operator and the healers",
"callers": [
"persons",
"sessions",
"healers"
],
"input": {
"type": "object",
"properties": {}
@@ -698,6 +723,29 @@
"answer": {
"$ref": "#/defs/SeatList"
}
},
{
"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": {
"module": {
"type": "string",
"description": "only this module's processes"
}
},
"additionalProperties": false
},
"answer": {
"$ref": "#/defs/ProcessBuilds"
},
"class": "read"
}
],
"events": [
@@ -728,6 +776,31 @@
"body": {
"$ref": "#/defs/ManifestReadsChanged"
}
},
{
"name": "composed",
"subject": "composed.<node>",
"body": {
"$ref": "#/defs/Composed"
}
},
{
"name": "running",
"subject": "running.<node>.<module>",
"keep": {
"max-age-days": 0,
"last-per-subject": true
},
"body": {
"$ref": "#/defs/Running"
}
},
{
"name": "capabilities-changed",
"subject": "capabilities-changed.<node>",
"body": {
"$ref": "#/defs/CapabilitiesChanged"
}
}
],
"family": {
@@ -2658,6 +2731,183 @@
"state",
"since"
]
},
"Composed": {
"type": "object",
"description": "an entry composed on a node (design 47 *What each step says*)",
"properties": {
"v": {
"type": "integer",
"description": "the layout's version"
},
"node": {
"type": "string",
"description": "the node"
},
"module": {
"type": "string",
"description": "the module"
},
"fingerprint": {
"type": "string",
"description": "the fingerprint of the want composed"
},
"digest": {
"type": "string",
"description": "the digest of the composition (design 47 G 404)"
},
"at": {
"type": "string",
"description": "when, RFC 3339",
"format": "date-time"
}
},
"required": [
"v",
"node",
"module",
"fingerprint",
"digest",
"at"
]
},
"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",
"properties": {
"v": {
"type": "integer",
"description": "the layout's version"
},
"node": {
"type": "string",
"description": "the node"
},
"module": {
"type": "string",
"description": "the module"
},
"fingerprint": {
"type": "string",
"description": "the fingerprint of the build it runs; none with stopped"
},
"manifest": {
"type": "string",
"description": "the digest of that build's manifest, the indexer's manifest of it, read by digest from the catalog half"
},
"at": {
"type": "string",
"description": "when it was seen running healthy, 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"
}
},
"required": [
"v",
"node",
"module",
"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",
"properties": {
"module": {
"type": "string",
"description": "the module"
},
"process": {
"type": "string",
"description": "the service's unit or the container's name"
},
"kind": {
"type": "string",
"description": "service or container",
"enum": [
"service",
"container"
]
},
"fingerprint": {
"type": "string",
"description": "the fingerprint handed to it in MESH_FINGERPRINT; empty when it was started without one"
},
"unknown": {
"type": "string",
"description": "why its build is unknown: started before the node-engine handed MESH_FINGERPRINT, or the value could not be read"
},
"started": {
"type": "string",
"description": "when it was started, RFC 3339",
"format": "date-time"
}
},
"required": [
"module",
"process",
"kind"
]
},
"ProcessBuilds": {
"type": "object",
"description": "what process-builds answers",
"properties": {
"node": {
"type": "string",
"description": "the node"
},
"processes": {
"type": "array",
"items": {
"$ref": "#/defs/ProcessBuild"
},
"description": "every process the node-engine started, by module"
},
"error": {
"type": "string",
"description": "why they could not be read"
}
},
"required": [
"node",
"processes"
]
}
}
}