K24 (mesh-recovery's hand verbs): take, restore, retry, aside, discard-aside and expire-points, asker and why on every hand verb, one answer form with cancel
Builds: design 47 G §682, §691 (§516, §554, §566, §656, §681) Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
This commit is contained in:
@@ -103,7 +103,8 @@
|
||||
"module": "mesh-knowledge",
|
||||
"kept": "ledger",
|
||||
"id": "20261111T121200Z",
|
||||
"why": "an aside left at removed"
|
||||
"why": "an aside left at removed",
|
||||
"asker": "jochen@shanks"
|
||||
}
|
||||
},
|
||||
{
|
||||
@@ -111,7 +112,129 @@
|
||||
"of": "verb:cancel.input",
|
||||
"given": {
|
||||
"act": "a-1",
|
||||
"why": "the dump waits too long"
|
||||
"why": "the dump waits too long",
|
||||
"asker": "jochen@shanks"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "take names the fingerprint whose form the point is taken at",
|
||||
"of": "verb:take.input",
|
||||
"given": {
|
||||
"module": "mesh-knowledge",
|
||||
"kept": "ledger",
|
||||
"why": "the operator's hand act",
|
||||
"asker": "jochen@shanks",
|
||||
"fingerprint": "0123456789ab"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "take answers accepted with the act",
|
||||
"of": "verb:take.answer",
|
||||
"given": {
|
||||
"accepted": "a-20261111t100000"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "restore takes a point by its name",
|
||||
"of": "verb:restore.input",
|
||||
"given": {
|
||||
"module": "mesh-knowledge",
|
||||
"kept": "ledger",
|
||||
"why": "the operator's hand act",
|
||||
"asker": "jochen@shanks",
|
||||
"snapshot": "2-0123456789ab",
|
||||
"from-backup": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "restore takes a keeper's snapshot by its request",
|
||||
"of": "verb:restore.input",
|
||||
"given": {
|
||||
"module": "mesh-knowledge",
|
||||
"kept": "ledger",
|
||||
"why": "the operator's hand act",
|
||||
"asker": "jochen@shanks",
|
||||
"request": "r-20261111t100000"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "restore answers busy with the act that runs",
|
||||
"of": "verb:restore.answer",
|
||||
"given": {
|
||||
"busy": "a-20261111t100000"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "retry names the module and its kept data",
|
||||
"of": "verb:retry.input",
|
||||
"given": {
|
||||
"module": "mesh-knowledge",
|
||||
"kept": "ledger",
|
||||
"why": "a failed take"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "retry answers an error when nothing failed",
|
||||
"of": "verb:retry.answer",
|
||||
"given": {
|
||||
"error": "nothing to retry"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "aside sets the live kept data aside",
|
||||
"of": "verb:aside.input",
|
||||
"given": {
|
||||
"module": "mesh-knowledge",
|
||||
"kept": "ledger",
|
||||
"why": "the operator's hand act",
|
||||
"asker": "jochen@shanks"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "aside answers accepted with the act",
|
||||
"of": "verb:aside.answer",
|
||||
"given": {
|
||||
"accepted": "a-20261111t100000"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "discard-aside names the aside",
|
||||
"of": "verb:discard-aside.input",
|
||||
"given": {
|
||||
"module": "mesh-knowledge",
|
||||
"kept": "ledger",
|
||||
"why": "the operator's hand act",
|
||||
"asker": "jochen@shanks",
|
||||
"id": "20261111T121200Z"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "discard-aside answers an error",
|
||||
"of": "verb:discard-aside.answer",
|
||||
"given": {
|
||||
"error": "no such aside"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "expire-points has no field of its own",
|
||||
"of": "verb:expire-points.input",
|
||||
"given": {
|
||||
"why": "the points past 90 days",
|
||||
"asker": "operator"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "expire-points answers accepted with the act",
|
||||
"of": "verb:expire-points.answer",
|
||||
"given": {
|
||||
"accepted": "a-20261111t100000"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "cancel answers accepted with the act it cancelled",
|
||||
"of": "verb:cancel.answer",
|
||||
"given": {
|
||||
"accepted": "a-1"
|
||||
}
|
||||
},
|
||||
{
|
||||
@@ -120,5 +243,12 @@
|
||||
"given": {
|
||||
"error": "the act has begun: step restoring"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "cancel answers busy with the act that runs",
|
||||
"of": "verb:cancel.answer",
|
||||
"given": {
|
||||
"busy": "a-20261111t100000"
|
||||
}
|
||||
}
|
||||
]
|
||||
|
||||
@@ -208,6 +208,10 @@
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why, which the hand-act log keeps"
|
||||
},
|
||||
"asker": {
|
||||
"type": "string",
|
||||
"description": "who asked: the caller the tool runner proved and recorded for the call (who@node, or operator), which the tools bundle's recovery tool passes and a module's process leaves out; the hand-act log names it beside the account the bus proved (design 47 G 682)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
@@ -253,6 +257,10 @@
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why, which the hand-act log keeps"
|
||||
},
|
||||
"asker": {
|
||||
"type": "string",
|
||||
"description": "who asked: the caller the tool runner proved and recorded for the call (who@node, or operator), which the tools bundle's recovery tool passes and a module's process leaves out; the hand-act log names it beside the account the bus proved (design 47 G 682)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
@@ -263,10 +271,15 @@
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"description": "the act cancelled, or busy, or the error; one of the three is set (design 47 G 682, 691)",
|
||||
"properties": {
|
||||
"cancelled": {
|
||||
"type": "boolean",
|
||||
"description": "the act ended cancelled"
|
||||
"accepted": {
|
||||
"type": "string",
|
||||
"description": "accepted: the id of the act it cancelled, whose ending event follows under that id"
|
||||
},
|
||||
"busy": {
|
||||
"type": "string",
|
||||
"description": "busy: the id of the act that runs; it keeps no queue, so the caller asks again on that act's ending event"
|
||||
},
|
||||
"error": {
|
||||
"type": "string",
|
||||
@@ -274,6 +287,338 @@
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "take",
|
||||
"description": "Hand act: take a point of one module's kept data at that fingerprint's form, as snapshot-kept does with no catch-up. Answers accepted, busy or error at once; the point comes on the event ended (design 47 G 682, 554).",
|
||||
"by-caller": true,
|
||||
"class": "act",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"module": {
|
||||
"type": "string",
|
||||
"description": "the module",
|
||||
"minLength": 1
|
||||
},
|
||||
"kept": {
|
||||
"type": "string",
|
||||
"description": "the kept data, its local name in the module's manifest",
|
||||
"minLength": 1
|
||||
},
|
||||
"fingerprint": {
|
||||
"type": "string",
|
||||
"description": "the fingerprint whose form the point is taken at",
|
||||
"minLength": 1
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why, which the hand-act log keeps"
|
||||
},
|
||||
"asker": {
|
||||
"type": "string",
|
||||
"description": "who asked: the caller the tool runner proved and recorded for the call (who@node, or operator), which the tools bundle's recovery tool passes and a module's process leaves out; the hand-act log names it beside the account the bus proved (design 47 G 682)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"module",
|
||||
"kept",
|
||||
"fingerprint",
|
||||
"why"
|
||||
],
|
||||
"additionalProperties": false
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"description": "the act accepted, or busy with the act that runs, or the error; one of the three is set (design 47 G 554)",
|
||||
"properties": {
|
||||
"accepted": {
|
||||
"type": "string",
|
||||
"description": "accepted: the act's id, which the ending event carries"
|
||||
},
|
||||
"busy": {
|
||||
"type": "string",
|
||||
"description": "busy: the id of the act that runs; it keeps no queue, so the caller asks again on that act's ending event"
|
||||
},
|
||||
"error": {
|
||||
"type": "string",
|
||||
"description": "why it was not taken; set alone"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "restore",
|
||||
"description": "Hand act: restore one module's kept data as restore-kept does, from a point by its name or from a keeper's snapshot by its request; exactly one of snapshot and request, and from-backup only with snapshot (design 47 G 682, 681). Answers accepted, busy or error at once; the result comes on the event restored.",
|
||||
"by-caller": true,
|
||||
"class": "act",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"module": {
|
||||
"type": "string",
|
||||
"description": "the module",
|
||||
"minLength": 1
|
||||
},
|
||||
"kept": {
|
||||
"type": "string",
|
||||
"description": "the kept data, its local name in the module's manifest",
|
||||
"minLength": 1
|
||||
},
|
||||
"snapshot": {
|
||||
"type": "string",
|
||||
"description": "a restore point's name",
|
||||
"minLength": 1
|
||||
},
|
||||
"request": {
|
||||
"type": "string",
|
||||
"description": "a keeper's snapshot by its request (design 47 G 681)",
|
||||
"minLength": 1
|
||||
},
|
||||
"from-backup": {
|
||||
"type": "boolean",
|
||||
"description": "ask the backup holder for the points directory when the point is missing there; only with snapshot"
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why, which the hand-act log keeps"
|
||||
},
|
||||
"asker": {
|
||||
"type": "string",
|
||||
"description": "who asked: the caller the tool runner proved and recorded for the call (who@node, or operator), which the tools bundle's recovery tool passes and a module's process leaves out; the hand-act log names it beside the account the bus proved (design 47 G 682)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"module",
|
||||
"kept",
|
||||
"why"
|
||||
],
|
||||
"additionalProperties": false
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"description": "the act accepted, or busy with the act that runs, or the error; one of the three is set (design 47 G 554)",
|
||||
"properties": {
|
||||
"accepted": {
|
||||
"type": "string",
|
||||
"description": "accepted: the act's id, which the ending event carries"
|
||||
},
|
||||
"busy": {
|
||||
"type": "string",
|
||||
"description": "busy: the id of the act that runs; it keeps no queue, so the caller asks again on that act's ending event"
|
||||
},
|
||||
"error": {
|
||||
"type": "string",
|
||||
"description": "why it was not taken; set alone"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "retry",
|
||||
"description": "Hand act: ask again the last failed act of that module and kept data, with its fields; the error nothing to retry when its last act did not fail. The result comes on that act's ending event (design 47 G 682).",
|
||||
"by-caller": true,
|
||||
"class": "act",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"module": {
|
||||
"type": "string",
|
||||
"description": "the module",
|
||||
"minLength": 1
|
||||
},
|
||||
"kept": {
|
||||
"type": "string",
|
||||
"description": "the kept data, its local name in the module's manifest",
|
||||
"minLength": 1
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why, which the hand-act log keeps"
|
||||
},
|
||||
"asker": {
|
||||
"type": "string",
|
||||
"description": "who asked: the caller the tool runner proved and recorded for the call (who@node, or operator), which the tools bundle's recovery tool passes and a module's process leaves out; the hand-act log names it beside the account the bus proved (design 47 G 682)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"module",
|
||||
"kept",
|
||||
"why"
|
||||
],
|
||||
"additionalProperties": false
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"description": "the act accepted, or busy with the act that runs, or the error; one of the three is set (design 47 G 554)",
|
||||
"properties": {
|
||||
"accepted": {
|
||||
"type": "string",
|
||||
"description": "accepted: the act's id, which the ending event carries"
|
||||
},
|
||||
"busy": {
|
||||
"type": "string",
|
||||
"description": "busy: the id of the act that runs; it keeps no queue, so the caller asks again on that act's ending event"
|
||||
},
|
||||
"error": {
|
||||
"type": "string",
|
||||
"description": "why it was not taken; set alone"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "aside",
|
||||
"description": "Hand act: set the live kept data aside without restoring (design 47 G 516, 682). Answers accepted, busy or error at once; the result comes on the event set-aside.",
|
||||
"by-caller": true,
|
||||
"class": "act",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"module": {
|
||||
"type": "string",
|
||||
"description": "the module",
|
||||
"minLength": 1
|
||||
},
|
||||
"kept": {
|
||||
"type": "string",
|
||||
"description": "the kept data, its local name in the module's manifest",
|
||||
"minLength": 1
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why, which the hand-act log keeps"
|
||||
},
|
||||
"asker": {
|
||||
"type": "string",
|
||||
"description": "who asked: the caller the tool runner proved and recorded for the call (who@node, or operator), which the tools bundle's recovery tool passes and a module's process leaves out; the hand-act log names it beside the account the bus proved (design 47 G 682)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"module",
|
||||
"kept",
|
||||
"why"
|
||||
],
|
||||
"additionalProperties": false
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"description": "the act accepted, or busy with the act that runs, or the error; one of the three is set (design 47 G 554)",
|
||||
"properties": {
|
||||
"accepted": {
|
||||
"type": "string",
|
||||
"description": "accepted: the act's id, which the ending event carries"
|
||||
},
|
||||
"busy": {
|
||||
"type": "string",
|
||||
"description": "busy: the id of the act that runs; it keeps no queue, so the caller asks again on that act's ending event"
|
||||
},
|
||||
"error": {
|
||||
"type": "string",
|
||||
"description": "why it was not taken; set alone"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "discard-aside",
|
||||
"description": "Hand act: remove one aside's directory (design 47 G 682). Answers accepted, busy or error at once; the result comes on the event aside-discarded.",
|
||||
"by-caller": true,
|
||||
"class": "act",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"module": {
|
||||
"type": "string",
|
||||
"description": "the module",
|
||||
"minLength": 1
|
||||
},
|
||||
"kept": {
|
||||
"type": "string",
|
||||
"description": "the kept data, its local name in the module's manifest",
|
||||
"minLength": 1
|
||||
},
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "the aside's id",
|
||||
"minLength": 1
|
||||
},
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why, which the hand-act log keeps"
|
||||
},
|
||||
"asker": {
|
||||
"type": "string",
|
||||
"description": "who asked: the caller the tool runner proved and recorded for the call (who@node, or operator), which the tools bundle's recovery tool passes and a module's process leaves out; the hand-act log names it beside the account the bus proved (design 47 G 682)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"module",
|
||||
"kept",
|
||||
"id",
|
||||
"why"
|
||||
],
|
||||
"additionalProperties": false
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"description": "the act accepted, or busy with the act that runs, or the error; one of the three is set (design 47 G 554)",
|
||||
"properties": {
|
||||
"accepted": {
|
||||
"type": "string",
|
||||
"description": "accepted: the act's id, which the ending event carries"
|
||||
},
|
||||
"busy": {
|
||||
"type": "string",
|
||||
"description": "busy: the id of the act that runs; it keeps no queue, so the caller asks again on that act's ending event"
|
||||
},
|
||||
"error": {
|
||||
"type": "string",
|
||||
"description": "why it was not taken; set alone"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "expire-points",
|
||||
"description": "Hand act: remove the points past their 90 days now, as the module does by itself (design 47 G 551, 682). Answers accepted, busy or error at once; the result comes on the event expiry-ended.",
|
||||
"by-caller": true,
|
||||
"class": "act",
|
||||
"input": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"why": {
|
||||
"type": "string",
|
||||
"description": "why, which the hand-act log keeps"
|
||||
},
|
||||
"asker": {
|
||||
"type": "string",
|
||||
"description": "who asked: the caller the tool runner proved and recorded for the call (who@node, or operator), which the tools bundle's recovery tool passes and a module's process leaves out; the hand-act log names it beside the account the bus proved (design 47 G 682)"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"why"
|
||||
],
|
||||
"additionalProperties": false
|
||||
},
|
||||
"answer": {
|
||||
"type": "object",
|
||||
"description": "the act accepted, or busy with the act that runs, or the error; one of the three is set (design 47 G 554)",
|
||||
"properties": {
|
||||
"accepted": {
|
||||
"type": "string",
|
||||
"description": "accepted: the act's id, which the ending event carries"
|
||||
},
|
||||
"busy": {
|
||||
"type": "string",
|
||||
"description": "busy: the id of the act that runs; it keeps no queue, so the caller asks again on that act's ending event"
|
||||
},
|
||||
"error": {
|
||||
"type": "string",
|
||||
"description": "why it was not taken; set alone"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
],
|
||||
"events": [
|
||||
|
||||
Reference in New Issue
Block a user