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

package/recipes/agent-delivery.json

@@ -2,7 +2,7 @@
   "version": 1,
   "code": "agent-delivery",
   "id": "https://topic-protocol.ixo.world/recipes/agent-delivery",
-  "recipeVersion": "1.0.0-rc.2",
+  "recipeVersion": "1.0.0-rc.4",
   "label": "Agent delivery",
   "description": "Commission agent work, review its delivery, and explicitly confirm any external Action.",
   "baseRecipe": "flow",
@@ -514,7 +514,8 @@
         "evidence": {
           "kind": "record",
           "type": "ixo.evaluation",
-          "finality": "accepted"
+          "finality": "accepted",
+          "status": "verified"
         },
         "handoff": {
           "kind": "flow",
@@ -560,7 +561,8 @@
         "evidence": {
           "kind": "record",
           "type": "ixo.decision",
-          "finality": "accepted"
+          "finality": "accepted",
+          "status": "approved"
         },
         "presentation": {
           "reasonCode": "decision-required",
@@ -643,7 +645,8 @@
         "evidence": {
           "kind": "receipt",
           "type": "ixo.action-receipt",
-          "finality": "final"
+          "finality": "final",
+          "status": "succeeded"
         },
         "handoff": {
           "kind": "flow",
@@ -657,6 +660,53 @@
           "unlocksKey": "topic.action.confirm-action.unlocks",
           "priority": 900
         }
+      },
+      {
+        "code": "retry-action",
+        "phase": "effecting",
+        "predecessor": {
+          "axis": "effect",
+          "state": "requested"
+        },
+        "target": {
+          "axis": "effect",
+          "state": "requested"
+        },
+        "command": "topic.request-action",
+        "requiredAbility": "topic/request-action",
+        "assignedTo": {
+          "kind": "role",
+          "value": "action-requester"
+        },
+        "gates": [
+          {
+            "kind": "receipt",
+            "type": "ixo.action-receipt",
+            "status": "failed"
+          },
+          {
+            "kind": "binding",
+            "type": "flow"
+          }
+        ],
+        "confirmation": "viewer",
+        "consequence": "external-effect",
+        "evidence": {
+          "kind": "operation",
+          "type": "request-action"
+        },
+        "handoff": {
+          "kind": "flow",
+          "binding": "action"
+        },
+        "presentation": {
+          "reasonCode": "action-retry-required",
+          "actionLabelKey": "topic.action.retry-action.label",
+          "bodyKey": "topic.action.retry-action.prompt",
+          "purposeKey": "topic.action.retry-action.purpose",
+          "unlocksKey": "topic.action.retry-action.unlocks",
+          "priority": 900
+        }
       }
     ],
     "progressRules": [

package/recipes/blueprint-design.json

@@ -0,0 +1,613 @@
+{
+  "version": 1,
+  "code": "blueprint-design",
+  "id": "https://topic-protocol.ixo.world/recipes/blueprint-design",
+  "recipeVersion": "1.0.0-rc.4",
+  "label": "Blueprint Design",
+  "description": "Coordinate a pinned design method and require independent-review evidence before explicitly closing the blueprint Project.",
+  "baseRecipe": "project",
+  "creates": "draft",
+  "shape": {
+    "version": 1,
+    "code": "recipe/blueprint-design",
+    "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",
+          "status": "verified"
+        },
+        "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"
+      ]
+    }
+  },
+  "project": {
+    "version": 1,
+    "compatibleKind": "project",
+    "compatibleShapeVersion": 1,
+    "allowedChildKinds": [
+      "task",
+      "agent_task",
+      "proposal",
+      "evaluation",
+      "claims",
+      "incident",
+      "question",
+      "discussion"
+    ],
+    "entryPoints": [
+      {
+        "code": "start-design-pod",
+        "label": "Prepare a Design POD draft",
+        "kind": "flow",
+        "target": "design-yoma/v1",
+        "suggestedChildKinds": [
+          "question",
+          "discussion",
+          "evaluation",
+          "proposal"
+        ],
+        "requiresReview": true
+      }
+    ],
+    "milestoneSuggestions": [],
+    "requiredCloseEvidenceTypes": [
+      "ixo.blueprint.independent-review"
+    ]
+  }
+}