From 68b0c970790b27daef66c4f61f754c95513885c4 Mon Sep 17 00:00:00 2001 From: jochen Date: Wed, 11 Nov 2026 20:27:12 +0100 Subject: [PATCH] K15 (findings state): the state findings is keyed .. and holds the Finding body MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Builds: design 47 G §660, §461, §437, §439 Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ --- .../mesh-conditions/fixtures/states.json | 45 ++++---- .../seats/mesh-conditions/seat.json | 104 +----------------- 2 files changed, 27 insertions(+), 122 deletions(-) diff --git a/health-and-repair/seats/mesh-conditions/fixtures/states.json b/health-and-repair/seats/mesh-conditions/fixtures/states.json index f8b2682..6b421c1 100644 --- a/health-and-repair/seats/mesh-conditions/fixtures/states.json +++ b/health-and-repair/seats/mesh-conditions/fixtures/states.json @@ -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/", + "name": "a finding of the bus scope with its zero time (in the finding layout (design 47 G 660))", + "of": "state:findings/..", "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/", + "name": "a finding of the module scope with its machine (in the finding layout (design 47 G 660))", + "of": "state:findings/..", "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/", + "of": "state:findings/..", "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/", + "of": "state:findings/..", "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" } } ] diff --git a/health-and-repair/seats/mesh-conditions/seat.json b/health-and-repair/seats/mesh-conditions/seat.json index e4fc40a..14be042 100644 --- a/health-and-repair/seats/mesh-conditions/seat.json +++ b/health-and-repair/seats/mesh-conditions/seat.json @@ -330,109 +330,11 @@ "writer": "caller", "key-forms": [ { - "key": "", + "key": "..", "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:" - }, - "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: (^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: (^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)"