K15 (findings state): the state findings is keyed <scope>.<id>.<kind> and holds the Finding body

Builds: design 47 G §660, §461, §437, §439

Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
This commit is contained in:
2026-11-11 20:31:03 +01:00
parent 22911c3644
commit 68b0c97079
2 changed files with 27 additions and 122 deletions
@@ -7,7 +7,7 @@
"evidence": [
{
"at": "2026-10-26T20:19:41.474823121Z",
"said": "mesh-build-node on ace uses mesh-build-node.cache as found: used as found: owned by 10005:10005, mode 700, as found; mesh-build-node, mode 0711 was declared and not given it \u2014 `ace/node-engine.hand-over` with the directory's path, then your yes on your channel, with its path, hands it to the mesh"
"said": "mesh-build-node on ace uses mesh-build-node.cache as found: used as found: owned by 10005:10005, mode 700, as found; mesh-build-node, mode 0711 was declared and not given it — `ace/node-engine.hand-over` with the directory's path, then your yes on your channel, with its path, hands it to the mesh"
}
],
"explanation": "Needs you: hand the directory over from the control-node, as the operator; the details name it and the line to type. A directory of mesh-build-node was already on ace, with another owner or mode than mesh-build-node declares.",
@@ -27,7 +27,7 @@
"machine": "ace",
"scope": "module"
},
"summary": "mesh-build-node on ace uses mesh-build-node.cache as found: used as found: owned by 10005:10005, mode 700, as found; mesh-build-node, mode 0711 was declared and not given it \u2014 `ace/node-engine.hand-over` with the directory's path, then your yes on your channel, with its path, hands it to the mesh"
"summary": "mesh-build-node on ace uses mesh-build-node.cache as found: used as found: owned by 10005:10005, mode 700, as found; mesh-build-node, mode 0711 was declared and not given it — `ace/node-engine.hand-over` with the directory's path, then your yes on your channel, with its path, hands it to the mesh"
}
},
{
@@ -61,11 +61,9 @@
}
},
{
"name": "a finding of the bus scope with its zero time (captured from the watchman; empty fields left out)",
"of": "state:findings/<key>",
"name": "a finding of the bus scope with its zero time (in the finding layout (design 47 G 660))",
"of": "state:findings/<scope>.<id>.<kind>",
"given": {
"v": 1,
"key": "bus.EVENTS.controller.max-deliveries",
"kind": "max-deliveries",
"subject": {
"id": "EVENTS.controller",
@@ -82,15 +80,16 @@
"said": "1 held for EVENTS.controller (counted again every 5m0s while any is held, so one delivered again or dropped ends this within it)"
}
],
"at": "0001-01-01T00:00:00Z"
"at": "0001-01-01T00:00:00Z",
"scope": "bus",
"id": "EVENTS.controller",
"since": "0001-01-01T00:00:00Z"
}
},
{
"name": "a finding of the module scope with its machine (captured from the watchman; empty fields left out)",
"of": "state:findings/<key>",
"name": "a finding of the module scope with its machine (in the finding layout (design 47 G 660))",
"of": "state:findings/<scope>.<id>.<kind>",
"given": {
"v": 1,
"key": "module.mesh-build-node.ace.directory-used-as-found",
"kind": "directory-used-as-found",
"subject": {
"id": "mesh-build-node.ace",
@@ -102,7 +101,6 @@
"explanation": "Needs you: hand the directory over from the control-node, as the operator.",
"headline": "mesh-build-node waits for a directory on ace",
"needs": "hand the directory over from the control-node, as the operator; the details name it and the line to type.",
"resolved": "mesh-build-node's directory on ace is the mesh's",
"observer": "mesh-delivery-watchman",
"source": "health-report",
"evidence": [
@@ -111,15 +109,16 @@
"said": "mesh-build-node on ace uses mesh-build-node.cache as found: owned by 10005:10005, mode 700, as found"
}
],
"at": "2026-10-26T20:19:41.474823121Z"
"at": "2026-10-26T20:19:41.474823121Z",
"scope": "module",
"id": "mesh-build-node.ace",
"since": "2026-10-26T20:19:41.474823121Z"
}
},
{
"name": "a finding owned by a session and waiting on a seat (design 47 G 678)",
"of": "state:findings/<key>",
"of": "state:findings/<scope>.<id>.<kind>",
"given": {
"v": 1,
"key": "module.mesh-host.ace.directory-used-as-found",
"kind": "directory-used-as-found",
"subject": {
"scope": "module",
@@ -132,15 +131,16 @@
"observer": "mesh-delivery-watchman",
"at": "2026-11-11T10:00:00Z",
"owner": "jochen@shanks",
"waiting-on": "node-engine"
"waiting-on": "node-engine",
"scope": "module",
"id": "mesh-host.ace",
"since": "2026-11-11T10:00:00Z"
}
},
{
"name": "a finding owned by a seat and waiting on a commit's author (design 47 G 678, 540)",
"of": "state:findings/<key>",
"of": "state:findings/<scope>.<id>.<kind>",
"given": {
"v": 1,
"key": "module.mesh-host.ace.directory-used-as-found",
"kind": "directory-used-as-found",
"subject": {
"scope": "module",
@@ -153,7 +153,10 @@
"observer": "mesh-delivery-watchman",
"at": "2026-11-11T10:00:00Z",
"owner": "node-engine",
"waiting-on": "forge:jochen"
"waiting-on": "forge:jochen",
"scope": "module",
"id": "mesh-host.ace",
"since": "2026-11-11T10:00:00Z"
}
}
]
@@ -330,109 +330,11 @@
"writer": "caller",
"key-forms": [
{
"key": "<key>",
"key": "<scope>.<id>.<kind>",
"value": {
"type": "object",
"description": "one thing an observer sees wrong now",
"properties": {
"v": {
"type": "integer",
"description": "layout version, 1"
},
"key": {
"type": "string",
"description": "scope.id.token"
},
"kind": {
"type": "string"
},
"subject": {
"$ref": "#/defs/Subject"
},
"severity": {
"type": "string",
"enum": [
"urgent",
"warning"
]
},
"summary": {
"type": "string",
"description": "one line"
},
"headline": {
"type": "string"
},
"explanation": {
"type": "string"
},
"resolved": {
"type": "string"
},
"needs": {
"type": "string"
},
"actions": {
"type": "array",
"items": {
"$ref": "#/defs/Action"
}
},
"evidence": {
"type": "array",
"description": "newest first, at most 10",
"items": {
"$ref": "#/defs/Evidence"
}
},
"source": {
"type": "string",
"description": "the row, probe or event that saw it"
},
"resolver": {
"type": "string",
"description": "self, operator, agent or healer:<name>"
},
"ref": {
"type": "string",
"description": "the key's last part when it is not the kind"
},
"observer": {
"type": "string",
"description": "the module that wrote it"
},
"run": {
"type": "string",
"description": "what of its own saw it last"
},
"at": {
"type": "string",
"format": "date-time"
},
"owner": {
"type": "string",
"pattern": "^([a-z0-9][a-z0-9._-]*@[a-z0-9][a-z0-9-]*|[a-z][a-z0-9-]*|forge:[A-Za-z0-9._-]+)$",
"description": "who the finding is about, when not the observer: a session who@node (^[a-z0-9][a-z0-9._-]*@[a-z0-9][a-z0-9-]*$), a seat's name (^[a-z][a-z0-9-]*$) or a commit's author forge:<account> (^forge:[A-Za-z0-9._-]+$); another is refused (design 47 G 678)"
},
"waiting-on": {
"type": "string",
"pattern": "^([a-z0-9][a-z0-9._-]*@[a-z0-9][a-z0-9-]*|[a-z][a-z0-9-]*|forge:[A-Za-z0-9._-]+)$",
"description": "what it waits on: a session who@node (^[a-z0-9][a-z0-9._-]*@[a-z0-9][a-z0-9-]*$), a seat's name (^[a-z][a-z0-9-]*$) or a commit's author forge:<account> (^forge:[A-Za-z0-9._-]+$); another is refused (design 47 G 678)"
}
},
"required": [
"v",
"key",
"kind",
"subject",
"severity",
"summary",
"source",
"observer",
"at"
]
"$ref": "#/bodies/Finding"
},
"description": "one finding of the observer that wrote it"
"description": "one finding of the observer that wrote it, its layout the body Finding (design 47 G 439, 461, 660)"
}
],
"description": "every observer's findings, one key per finding, kept in the observer's own state and read only by its owner's read tool; the keeper hears each change as the observer's events finding-written, finding-cleared and findings-stated (design 47 G 383, 434)"