@ixo/topic-protocol 0.8.0 → 1.0.0-rc.2

package/recipes/registry.json

@@ -0,0 +1,41 @@
+{
+  "version": 1,
+  "recipes": [
+    {
+      "code": "research-brief",
+      "label": "Research brief",
+      "description": "Frame a question, do the research, verify the sources, and close the brief explicitly.",
+      "baseRecipe": "research",
+      "creates": "draft",
+      "ref": {
+        "id": "https://topic-protocol.ixo.world/recipes/research-brief",
+        "version": "1.0.0-rc.2",
+        "digest": "sha256:76aa6428b3a41ea0652c078f8020ba7918fe0f8c3ac79ef941c88b33ee62294b"
+      }
+    },
+    {
+      "code": "agent-delivery",
+      "label": "Agent delivery",
+      "description": "Commission agent work, review its delivery, and explicitly confirm any external Action.",
+      "baseRecipe": "flow",
+      "creates": "draft",
+      "ref": {
+        "id": "https://topic-protocol.ixo.world/recipes/agent-delivery",
+        "version": "1.0.0-rc.2",
+        "digest": "sha256:fc646487e42ae88984b644449a90fe5b30769380d73b391cd44f46926f406e5e"
+      }
+    },
+    {
+      "code": "verified-work-payment",
+      "label": "Verified work payment",
+      "description": "Bind one entity and claim collection, verify work, decide, execute through Flow, and observe settlement finality.",
+      "baseRecipe": "claims",
+      "creates": "draft",
+      "ref": {
+        "id": "https://topic-protocol.ixo.world/recipes/verified-work-payment",
+        "version": "1.0.0-rc.2",
+        "digest": "sha256:27c0e70c6bfac1557ae402673bd4aa8bace7ff50c82c5e30cf5e6f356114fb86"
+      }
+    }
+  ]
+}

package/recipes/research-brief.json

@@ -0,0 +1,578 @@
+{
+  "version": 1,
+  "code": "research-brief",
+  "id": "https://topic-protocol.ixo.world/recipes/research-brief",
+  "recipeVersion": "1.0.0-rc.2",
+  "label": "Research brief",
+  "description": "Frame a question, do the research, verify the sources, and close the brief explicitly.",
+  "baseRecipe": "research",
+  "creates": "draft",
+  "shape": {
+    "version": 1,
+    "code": "recipe/research-brief",
+    "axes": [
+      {
+        "code": "contract",
+        "phase": "forming",
+        "required": true,
+        "initialState": "proposed",
+        "states": [
+          {
+            "code": "proposed"
+          },
+          {
+            "code": "effective",
+            "terminal": true
+          }
+        ]
+      },
+      {
+        "code": "work",
+        "phase": "working",
+        "required": true,
+        "initialState": "pending",
+        "states": [
+          {
+            "code": "pending"
+          },
+          {
+            "code": "in-progress"
+          },
+          {
+            "code": "submitted",
+            "terminal": true
+          }
+        ]
+      },
+      {
+        "code": "verification",
+        "phase": "verifying",
+        "required": true,
+        "initialState": "pending",
+        "states": [
+          {
+            "code": "pending"
+          },
+          {
+            "code": "verified",
+            "terminal": true
+          }
+        ]
+      },
+      {
+        "code": "topic",
+        "phase": "complete",
+        "required": true,
+        "initialState": "open",
+        "states": [
+          {
+            "code": "open"
+          },
+          {
+            "code": "complete",
+            "terminal": true
+          }
+        ]
+      }
+    ],
+    "transitions": [
+      {
+        "code": "edit-setup",
+        "phase": "forming",
+        "predecessor": {
+          "axis": "contract",
+          "state": "proposed"
+        },
+        "target": {
+          "axis": "contract",
+          "state": "proposed"
+        },
+        "command": "topic.edit-setup",
+        "requiredAbility": "topic/write",
+        "assignedTo": {
+          "kind": "role",
+          "value": "setup-editor"
+        },
+        "gates": [],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "update-contract"
+        },
+        "presentation": {
+          "reasonCode": "setup-needs-input",
+          "actionLabelKey": "topic.action.edit-setup.label",
+          "bodyKey": "topic.setup.edit.body",
+          "purposeKey": "topic.setup.edit.purpose",
+          "unlocksKey": "topic.setup.edit.unlocks",
+          "priority": 800
+        }
+      },
+      {
+        "code": "confirm-setup",
+        "phase": "forming",
+        "predecessor": {
+          "axis": "contract",
+          "state": "proposed"
+        },
+        "target": {
+          "axis": "contract",
+          "state": "effective"
+        },
+        "command": "topic.confirm-setup",
+        "requiredAbility": "topic/confirm-setup",
+        "assignedTo": {
+          "kind": "role",
+          "value": "setup-confirmer"
+        },
+        "gates": [],
+        "confirmation": "authority",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "confirm-setup"
+        },
+        "presentation": {
+          "reasonCode": "setup-awaits-confirmation",
+          "actionLabelKey": "topic.action.confirm-setup.label",
+          "bodyKey": "topic.setup.confirm.body",
+          "purposeKey": "topic.setup.confirm.purpose",
+          "unlocksKey": "topic.setup.confirm.unlocks",
+          "priority": 700
+        }
+      },
+      {
+        "code": "start-work",
+        "phase": "working",
+        "predecessor": {
+          "axis": "work",
+          "state": "pending"
+        },
+        "target": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "command": "topic.start-work",
+        "requiredAbility": "topic/write",
+        "assignedTo": {
+          "kind": "role",
+          "value": "worker"
+        },
+        "gates": [
+          {
+            "kind": "axis",
+            "axis": "contract",
+            "states": [
+              "effective"
+            ]
+          }
+        ],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "change-progress"
+        },
+        "presentation": {
+          "reasonCode": "start-work",
+          "actionLabelKey": "topic.action.start-work.label",
+          "bodyKey": "topic.action.start-work.prompt",
+          "purposeKey": "topic.action.start-work.purpose",
+          "unlocksKey": "topic.action.start-work.unlocks",
+          "priority": 900
+        }
+      },
+      {
+        "code": "raise-dispute",
+        "phase": "working",
+        "predecessor": {
+          "axis": "topic",
+          "state": "open"
+        },
+        "target": {
+          "axis": "topic",
+          "state": "open"
+        },
+        "command": "topic.raise-dispute",
+        "requiredAbility": "topic/raise-dispute",
+        "assignedTo": {
+          "kind": "role",
+          "value": "participant"
+        },
+        "gates": [],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "raise-dispute"
+        },
+        "presentation": {
+          "reasonCode": "dispute-available",
+          "actionLabelKey": "topic.action.raise-dispute.label",
+          "bodyKey": "topic.action.raise-dispute.prompt",
+          "purposeKey": "topic.action.raise-dispute.purpose",
+          "unlocksKey": "topic.action.raise-dispute.unlocks",
+          "priority": 900
+        }
+      },
+      {
+        "code": "resolve-dispute",
+        "phase": "working",
+        "predecessor": {
+          "axis": "topic",
+          "state": "open"
+        },
+        "target": {
+          "axis": "topic",
+          "state": "open"
+        },
+        "command": "topic.resolve-dispute",
+        "requiredAbility": "topic/resolve-dispute",
+        "assignedTo": {
+          "kind": "role",
+          "value": "dispute-resolver"
+        },
+        "gates": [
+          {
+            "kind": "condition",
+            "states": [
+              "disputed"
+            ]
+          }
+        ],
+        "confirmation": "authority",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "resolve-dispute"
+        },
+        "presentation": {
+          "reasonCode": "dispute-awaits-resolution",
+          "actionLabelKey": "topic.action.resolve-dispute.label",
+          "bodyKey": "topic.action.resolve-dispute.prompt",
+          "purposeKey": "topic.action.resolve-dispute.purpose",
+          "unlocksKey": "topic.action.resolve-dispute.unlocks",
+          "priority": 900
+        }
+      },
+      {
+        "code": "answer-question",
+        "phase": "working",
+        "predecessor": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "target": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "command": "topic.answer-question",
+        "requiredAbility": "topic/write",
+        "assignedTo": {
+          "kind": "role",
+          "value": "worker"
+        },
+        "gates": [
+          {
+            "kind": "field",
+            "path": "/questions/open",
+            "predicate": "present"
+          }
+        ],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "answer-question"
+        },
+        "presentation": {
+          "reasonCode": "question-awaits-answer",
+          "actionLabelKey": "topic.action.answer-question.label",
+          "bodyKey": "topic.action.answer-question.prompt",
+          "purposeKey": "topic.action.answer-question.purpose",
+          "unlocksKey": "topic.action.answer-question.unlocks",
+          "priority": 900
+        }
+      },
+      {
+        "code": "change-due-date",
+        "phase": "working",
+        "predecessor": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "target": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "command": "topic.change-due-date",
+        "requiredAbility": "topic/write",
+        "assignedTo": {
+          "kind": "role",
+          "value": "worker"
+        },
+        "gates": [
+          {
+            "kind": "field",
+            "path": "/outcome/target/value",
+            "predicate": "present"
+          }
+        ],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "change-due-date"
+        },
+        "presentation": {
+          "reasonCode": "due-date-review",
+          "actionLabelKey": "topic.action.change-due-date.label",
+          "bodyKey": "topic.action.change-due-date.prompt",
+          "purposeKey": "topic.action.change-due-date.purpose",
+          "unlocksKey": "topic.action.change-due-date.unlocks",
+          "priority": 900
+        }
+      },
+      {
+        "code": "unblock-topic",
+        "phase": "working",
+        "predecessor": {
+          "axis": "topic",
+          "state": "open"
+        },
+        "target": {
+          "axis": "topic",
+          "state": "open"
+        },
+        "command": "topic.unblock",
+        "requiredAbility": "topic/unblock",
+        "assignedTo": {
+          "kind": "role",
+          "value": "block-resolver"
+        },
+        "gates": [
+          {
+            "kind": "condition",
+            "states": [
+              "blocked"
+            ]
+          }
+        ],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "unblock-topic"
+        },
+        "presentation": {
+          "reasonCode": "topic-blocked",
+          "actionLabelKey": "topic.action.unblock-topic.label",
+          "bodyKey": "topic.action.unblock-topic.prompt",
+          "purposeKey": "topic.action.unblock-topic.purpose",
+          "unlocksKey": "topic.action.unblock-topic.unlocks",
+          "priority": 900
+        }
+      },
+      {
+        "code": "submit-work",
+        "phase": "working",
+        "predecessor": {
+          "axis": "work",
+          "state": "in-progress"
+        },
+        "target": {
+          "axis": "work",
+          "state": "submitted"
+        },
+        "command": "topic.record-outcome",
+        "requiredAbility": "topic/record-outcome",
+        "assignedTo": {
+          "kind": "role",
+          "value": "worker"
+        },
+        "gates": [],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "record",
+          "type": "ixo.topic.work-submission",
+          "finality": "accepted"
+        },
+        "presentation": {
+          "reasonCode": "submit-work",
+          "actionLabelKey": "topic.action.submit-work.label",
+          "bodyKey": "topic.action.submit-work.prompt",
+          "purposeKey": "topic.action.submit-work.purpose",
+          "unlocksKey": "topic.action.submit-work.unlocks",
+          "priority": 900
+        }
+      },
+      {
+        "code": "complete-topic",
+        "phase": "complete",
+        "predecessor": {
+          "axis": "topic",
+          "state": "open"
+        },
+        "target": {
+          "axis": "topic",
+          "state": "complete"
+        },
+        "command": "topic.complete",
+        "requiredAbility": "topic/confirm-completion",
+        "assignedTo": {
+          "kind": "role",
+          "value": "completion-authority"
+        },
+        "gates": [
+          {
+            "kind": "axis",
+            "axis": "work",
+            "states": [
+              "submitted"
+            ]
+          }
+        ],
+        "confirmation": "authority",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "operation",
+          "type": "complete-topic"
+        },
+        "completesTopic": true,
+        "presentation": {
+          "reasonCode": "complete-topic",
+          "actionLabelKey": "topic.action.complete-topic.label",
+          "bodyKey": "topic.action.complete-topic.prompt",
+          "purposeKey": "topic.action.complete-topic.purpose",
+          "unlocksKey": "topic.action.complete-topic.unlocks",
+          "priority": 900
+        }
+      },
+      {
+        "code": "record-verification",
+        "phase": "verifying",
+        "predecessor": {
+          "axis": "verification",
+          "state": "pending"
+        },
+        "target": {
+          "axis": "verification",
+          "state": "verified"
+        },
+        "command": "topic.record-verification",
+        "requiredAbility": "claim/evaluate",
+        "assignedTo": {
+          "kind": "role",
+          "value": "evaluator"
+        },
+        "gates": [
+          {
+            "kind": "axis",
+            "axis": "work",
+            "states": [
+              "submitted"
+            ]
+          }
+        ],
+        "confirmation": "none",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "record",
+          "type": "ixo.evaluation",
+          "finality": "accepted"
+        },
+        "handoff": {
+          "kind": "flow",
+          "binding": "evaluation"
+        },
+        "presentation": {
+          "reasonCode": "verification-required",
+          "actionLabelKey": "topic.action.record-verification.label",
+          "bodyKey": "topic.action.record-verification.prompt",
+          "purposeKey": "topic.action.record-verification.purpose",
+          "unlocksKey": "topic.action.record-verification.unlocks",
+          "priority": 900
+        }
+      }
+    ],
+    "progressRules": [
+      {
+        "code": "disputed",
+        "condition": "disputed",
+        "priority": 700,
+        "source": {
+          "kind": "record",
+          "value": "ixo.topic.dispute"
+        }
+      },
+      {
+        "code": "failed",
+        "condition": "failed",
+        "priority": 650,
+        "source": {
+          "kind": "receipt",
+          "value": "failed"
+        }
+      },
+      {
+        "code": "blocked",
+        "condition": "blocked",
+        "priority": 600,
+        "source": {
+          "kind": "topic",
+          "value": "blocked"
+        },
+        "requiresTarget": true
+      },
+      {
+        "code": "waiting",
+        "condition": "waiting",
+        "priority": 500,
+        "source": {
+          "kind": "topic",
+          "value": "waiting"
+        },
+        "requiresTarget": true
+      },
+      {
+        "code": "needs-input",
+        "condition": "needs-input",
+        "priority": 400,
+        "source": {
+          "kind": "record",
+          "value": "ixo.topic.question"
+        }
+      },
+      {
+        "code": "needs-confirmation",
+        "condition": "needs-confirmation",
+        "priority": 350,
+        "source": {
+          "kind": "axis",
+          "value": "contract"
+        },
+        "states": [
+          "proposed"
+        ]
+      }
+    ],
+    "inferredRecordPolicy": {
+      "autoAccept": [
+        "ixo.topic.fact",
+        "ixo.topic.summary",
+        "ixo.topic.classification"
+      ],
+      "neverAutoAccept": [
+        "ixo.topic.contract",
+        "ixo.topic.outcome",
+        "ixo.topic.authority",
+        "ixo.topic.action",
+        "ixo.claim",
+        "ixo.evaluation",
+        "ixo.settlement"
+      ]
+    }
+  }
+}