seatlist bootstrap: node-engine with its verbs seat-list and seat-list-again and its state findings, mesh-catalog as B2's definition now holds it; every bootstrap file equals its contracts file (ADR 0636 §2, §7; issue 1966)

2026-11-05 14:35:20 +01:00
parent 2b9cdb5771
commit 129dc8cffb
1 changed files with 80 additions and 0 deletions
@@ -81,6 +81,86 @@
        "type": "object",
        "description": "what dependents answers, as its description says"
      }
+    },
+    {
+      "name": "seat-definitions",
+      "description": "The seat list (ADR 0636 §4): with no seat, every trunk seat with its digest and the revision of the list; with a seat, that trunk definition resolved with the parts it includes. Reads only.",
+      "optional": true,
+      "input": {
+        "properties": {
+          "seat": {
+            "description": "the seat's name; none lists every trunk seat",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "answer": {
+        "type": "object",
+        "description": "with no seat: the revision of the list and every trunk seat with its digest; with a seat: whether it was found and its entry, the definition resolved",
+        "properties": {
+          "revision": {
+            "type": "integer"
+          },
+          "seats": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "seat": {
+                  "type": "string"
+                },
+                "source": {
+                  "type": "string",
+                  "description": "trunk"
+                },
+                "digest": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "seat",
+                "source",
+                "digest"
+              ]
+            }
+          },
+          "seat": {
+            "type": "string"
+          },
+          "found": {
+            "type": "boolean"
+          },
+          "entry": {
+            "type": "object",
+            "properties": {
+              "seat": {
+                "type": "string"
+              },
+              "source": {
+                "type": "string",
+                "description": "trunk"
+              },
+              "digest": {
+                "type": "string"
+              },
+              "definition": {
+                "type": "object",
+                "description": "the definition, resolved with the parts it includes"
+              },
+              "unparsed": {
+                "type": "string",
+                "description": "why the definition could not be read, when it could not"
+              }
+            },
+            "required": [
+              "seat",
+              "source",
+              "digest"
+            ]
+          }
+        }
+      }
    }
  ],
  "description": "The catalog of the mesh: every module the trunk holds with its manifest, fingerprint and verdict, the packages published, and the seat list (ADR 0636 §1, §4).",