From 2f680c661e01ca01407b98cfe525a6b7e542263f Mon Sep 17 00:00:00 2001 From: jochen Date: Wed, 11 Nov 2026 14:40:11 +0100 Subject: [PATCH] Take out C7: node-backup's aside, discard-aside, ended and restored, and the kept, form and fingerprint arguments MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit G section 555: the seat node-backup gains nothing for kept data on the bus; its now and restore keep the class act (§405). Builds: design 47 G §555, §405 Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ --- seats/node-backup/fixtures/events.json | 29 ---- seats/node-backup/seat.json | 213 +------------------------ 2 files changed, 3 insertions(+), 239 deletions(-) delete mode 100644 seats/node-backup/fixtures/events.json diff --git a/seats/node-backup/fixtures/events.json b/seats/node-backup/fixtures/events.json deleted file mode 100644 index 9a5e58f..0000000 --- a/seats/node-backup/fixtures/events.json +++ /dev/null @@ -1,29 +0,0 @@ -[ - { - "name": "ended is said, its node, module and kept data in its subject", - "of": "event:ended", - "subject": "mesh.seat.node-backup.event.ended.ace.plex.library", - "given": { - "v": 1, - "module": "plex", - "kept": "library", - "form": 2, - "fingerprint": "src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", - "outcome": "done" - } - }, - { - "name": "restored failed says why", - "of": "event:restored", - "subject": "mesh.seat.node-backup.event.restored.ace.plex.library", - "given": { - "v": 1, - "module": "plex", - "kept": "library", - "form": 2, - "fingerprint": "src2:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", - "outcome": "failed", - "error": "restore point missing" - } - } -] diff --git a/seats/node-backup/seat.json b/seats/node-backup/seat.json index 66653b7..e9a8efe 100644 --- a/seats/node-backup/seat.json +++ b/seats/node-backup/seat.json @@ -8,7 +8,7 @@ "verbs": [ { "name": "backed-up", - "description": "What this machine backs up: each module, what it declared, its last good night, how many restore points are kept and the repository's size. Also each module's restore points of its kept data on the bus (the kept data, the form, the fingerprint each was taken before) and the data set aside at each restore, with its size.", + "description": "What this machine backs up: each module, what it declared, its last good night, how many restore points are kept and the repository's size.", "replaces": [ "restic snapshots" ], @@ -24,7 +24,7 @@ }, { "name": "now", - "description": "Take a backup now, of one module or of every module on this machine — before a migration, a retirement or anything else that could go wrong. With kept, a restore point of one kept data on the bus instead, said by the event ended.", + "description": "Take a backup now, of one module or of every module on this machine — before a migration, a retirement or anything else that could go wrong.", "replaces": [ "restic backup" ], @@ -33,33 +33,6 @@ "module": { "description": "one module (optional)", "type": "string" - }, - "kept": { - "type": "string", - "description": "one kept data of the module on the bus, its local name: its restore point is taken by the bus module's account, of the node holding mesh-broker" - }, - "form": { - "type": "integer", - "description": "with kept: its form now" - }, - "fingerprint": { - "type": "string", - "description": "with kept: the fingerprint the restore point is taken before" - }, - "catch-up": { - "type": "object", - "description": "with kept: the catch-up tool the newer manifest declares beside it and its arguments whole, recorded in the restore point (design 47 G 299, 406)", - "properties": { - "tool": { - "type": "string" - }, - "arguments": { - "type": "object" - } - }, - "required": [ - "tool" - ] } }, "type": "object" @@ -68,7 +41,7 @@ }, { "name": "restore", - "description": "Restore one module's data from a restore point BESIDE the live data, never over it: each directory as .restored-. Swapping it in is a person's act. Lists the restore points when none is named. With kept, the restore point of one kept data on the bus by its module, kept data and form, the live data set aside and never removed, said by the event restored.", + "description": "Restore one module's data from a restore point BESIDE the live data, never over it: each directory as .restored-. Swapping it in is a person's act. Lists the restore points when none is named.", "replaces": [ "restic restore" ], @@ -85,18 +58,6 @@ "snapshot": { "description": "the restore point (from `backed-up`; the newest when omitted)", "type": "string" - }, - "kept": { - "type": "string", - "description": "one kept data of the module on the bus, its local name: its restore point is taken by the bus module's account, of the node holding mesh-broker" - }, - "form": { - "type": "integer", - "description": "with kept: its form now" - }, - "fingerprint": { - "type": "string", - "description": "with kept: the fingerprint the restore point is taken before" } }, "required": [ @@ -105,76 +66,6 @@ "type": "object" }, "class": "act" - }, - { - "name": "aside", - "description": "Set one module's live kept data on the bus aside under a name of its own and restore nothing, after the node agent stopped the newer build (design 47 G 297, 405); the data set aside is listed by backed-up and removed only by discard-aside.", - "class": "act", - "input": { - "type": "object", - "properties": { - "module": { - "type": "string", - "description": "the module" - }, - "kept": { - "type": "string", - "description": "one kept data of the module on the bus, its local name: its restore point is taken by the bus module's account, of the node holding mesh-broker" - }, - "form": { - "type": "integer", - "description": "with kept: its form now" - }, - "fingerprint": { - "type": "string", - "description": "with kept: the fingerprint the restore point is taken before" - } - }, - "required": [ - "module", - "kept", - "form", - "fingerprint" - ] - }, - "answer": { - "type": "object", - "properties": { - "aside": { - "type": "string", - "description": "the name the live data is set aside under" - }, - "error": { - "type": "string", - "description": "why it failed; set alone" - } - } - } - }, - { - "name": "discard-aside", - "description": "Remove data a restore set aside, on a person's call alone; writes the act, who and why in the hand-act log of the seat mesh-hand-acts.", - "callers": [ - "operator" - ], - "input": { - "type": "object", - "properties": { - "id": { - "type": "string", - "description": "the aside's id, as backed-up lists it" - }, - "why": { - "type": "string", - "description": "why" - } - }, - "required": [ - "id", - "why" - ] - }, - "class": "act" } ], "receives": [ @@ -188,103 +79,5 @@ "comment": "#", "dirs": true } - ], - "events": [ - { - "name": "ended", - "subject": "ended...", - "body": { - "type": "object", - "description": "a restore point of a kept data on the bus taken, done or failed", - "properties": { - "v": { - "type": "integer", - "description": "the layout's version" - }, - "module": { - "type": "string", - "description": "the module" - }, - "kept": { - "type": "string", - "description": "the kept data" - }, - "form": { - "type": "integer", - "description": "its form" - }, - "fingerprint": { - "type": "string", - "description": "the fingerprint" - }, - "outcome": { - "enum": [ - "done", - "failed" - ] - }, - "error": { - "type": "string", - "description": "why it failed" - } - }, - "required": [ - "v", - "module", - "kept", - "form", - "fingerprint", - "outcome" - ] - } - }, - { - "name": "restored", - "subject": "restored...", - "body": { - "type": "object", - "description": "a kept data on the bus restored from its restore point beside the live data, done or failed", - "properties": { - "v": { - "type": "integer", - "description": "the layout's version" - }, - "module": { - "type": "string", - "description": "the module" - }, - "kept": { - "type": "string", - "description": "the kept data" - }, - "form": { - "type": "integer", - "description": "its form" - }, - "fingerprint": { - "type": "string", - "description": "the fingerprint" - }, - "outcome": { - "enum": [ - "done", - "failed" - ] - }, - "error": { - "type": "string", - "description": "why it failed" - } - }, - "required": [ - "v", - "module", - "kept", - "form", - "fingerprint", - "outcome" - ] - } - } ] }