Take out C7: node-backup's aside, discard-aside, ended and restored, and the kept, form and fingerprint arguments

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
This commit is contained in:
2026-11-11 14:40:11 +01:00
parent a7ab33028f
commit 2f680c661e
2 changed files with 3 additions and 239 deletions
-29
View File
@@ -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"
}
}
]
+3 -210
View File
@@ -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 <path>.restored-<date>. 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 <path>.restored-<date>. 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.<node>.<module>.<kept>",
"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.<node>.<module>.<kept>",
"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"
]
}
}
]
}