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

package/recipes/registry.json

@@ -9,8 +9,8 @@
       "creates": "draft",
       "ref": {
         "id": "https://topic-protocol.ixo.world/recipes/research-brief",
-        "version": "1.0.0-rc.2",
-        "digest": "sha256:76aa6428b3a41ea0652c078f8020ba7918fe0f8c3ac79ef941c88b33ee62294b"
+        "version": "1.0.0-rc.4",
+        "digest": "sha256:319d13281c2aaaed6162269199ef2f46eec9f52e4ccb813c5916a02da341862d"
       }
     },
     {
@@ -21,8 +21,8 @@
       "creates": "draft",
       "ref": {
         "id": "https://topic-protocol.ixo.world/recipes/agent-delivery",
-        "version": "1.0.0-rc.2",
-        "digest": "sha256:fc646487e42ae88984b644449a90fe5b30769380d73b391cd44f46926f406e5e"
+        "version": "1.0.0-rc.4",
+        "digest": "sha256:ad9ad2bc1a7f5ae33a464931117f1366fc9f8927a5a189e2638be61fd82cfb5a"
       }
     },
     {
@@ -33,8 +33,32 @@
       "creates": "draft",
       "ref": {
         "id": "https://topic-protocol.ixo.world/recipes/verified-work-payment",
-        "version": "1.0.0-rc.2",
-        "digest": "sha256:27c0e70c6bfac1557ae402673bd4aa8bace7ff50c82c5e30cf5e6f356114fb86"
+        "version": "1.0.0-rc.4",
+        "digest": "sha256:b4544db76e0628bea78377f73408e355529cd63e5065221918597b63eaeec777"
+      }
+    },
+    {
+      "code": "software-build",
+      "label": "Software Build",
+      "description": "Coordinate reviewed software work through user-defined milestones and explicitly accepted delivery evidence.",
+      "baseRecipe": "project",
+      "creates": "draft",
+      "ref": {
+        "id": "https://topic-protocol.ixo.world/recipes/software-build",
+        "version": "1.0.0-rc.4",
+        "digest": "sha256:1abb6c50759d9c7a9c505ceeb55b384ceaa9d0838d0391a0729e778192d5e576"
+      }
+    },
+    {
+      "code": "blueprint-design",
+      "label": "Blueprint Design",
+      "description": "Coordinate a pinned design method and require independent-review evidence before explicitly closing the blueprint Project.",
+      "baseRecipe": "project",
+      "creates": "draft",
+      "ref": {
+        "id": "https://topic-protocol.ixo.world/recipes/blueprint-design",
+        "version": "1.0.0-rc.4",
+        "digest": "sha256:d3afd59a470507bdbdb0a2ed55adf3c348979369d1d1b54bd94ff5f49ce4dc9f"
       }
     }
   ]

package/recipes/research-brief.json

@@ -2,7 +2,7 @@
   "version": 1,
   "code": "research-brief",
   "id": "https://topic-protocol.ixo.world/recipes/research-brief",
-  "recipeVersion": "1.0.0-rc.2",
+  "recipeVersion": "1.0.0-rc.4",
   "label": "Research brief",
   "description": "Frame a question, do the research, verify the sources, and close the brief explicitly.",
   "baseRecipe": "research",
@@ -481,7 +481,8 @@
         "evidence": {
           "kind": "record",
           "type": "ixo.evaluation",
-          "finality": "accepted"
+          "finality": "accepted",
+          "status": "verified"
         },
         "handoff": {
           "kind": "flow",
@@ -495,6 +496,56 @@
           "unlocksKey": "topic.action.record-verification.unlocks",
           "priority": 900
         }
+      },
+      {
+        "code": "accept-answer",
+        "phase": "verifying",
+        "predecessor": {
+          "axis": "answer",
+          "state": "pending"
+        },
+        "target": {
+          "axis": "answer",
+          "state": "accepted"
+        },
+        "command": "topic.record-verification",
+        "requiredAbility": "topic/accept-answer",
+        "assignedTo": {
+          "kind": "role",
+          "value": "completion-authority"
+        },
+        "gates": [
+          {
+            "kind": "axis",
+            "axis": "work",
+            "states": [
+              "submitted"
+            ]
+          },
+          {
+            "kind": "axis",
+            "axis": "verification",
+            "states": [
+              "verified"
+            ]
+          }
+        ],
+        "confirmation": "authority",
+        "consequence": "shared-state",
+        "evidence": {
+          "kind": "record",
+          "type": "ixo.topic.answer-acceptance",
+          "finality": "accepted",
+          "status": "accepted"
+        },
+        "presentation": {
+          "reasonCode": "accept-answer",
+          "actionLabelKey": "topic.action.accept-answer.label",
+          "bodyKey": "topic.action.accept-answer.prompt",
+          "purposeKey": "topic.action.accept-answer.purpose",
+          "unlocksKey": "topic.action.accept-answer.unlocks",
+          "priority": 900
+        }
       }
     ],
     "progressRules": [

package/recipes/software-build.json

@@ -0,0 +1,566 @@
+{
+  "version": 1,
+  "code": "software-build",
+  "id": "https://topic-protocol.ixo.world/recipes/software-build",
+  "recipeVersion": "1.0.0-rc.4",
+  "label": "Software Build",
+  "description": "Coordinate reviewed software work through user-defined milestones and explicitly accepted delivery evidence.",
+  "baseRecipe": "project",
+  "creates": "draft",
+  "shape": {
+    "version": 1,
+    "code": "base/project",
+    "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": "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
+        }
+      }
+    ],
+    "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": "compose-reviewed-task",
+        "label": "Compose a reviewed Task",
+        "kind": "action",
+        "target": "compose-topic/task",
+        "suggestedChildKinds": [
+          "task"
+        ],
+        "requiresReview": true
+      },
+      {
+        "code": "compose-reviewed-agent-task",
+        "label": "Compose a reviewed Agent Task",
+        "kind": "action",
+        "target": "compose-topic/agent-task",
+        "suggestedChildKinds": [
+          "agent_task"
+        ],
+        "requiresReview": true
+      },
+      {
+        "code": "open-coding-application",
+        "label": "Open a coding application",
+        "kind": "action",
+        "target": "ixo.project.software-build/coding-entry-point",
+        "suggestedChildKinds": [
+          "task",
+          "agent_task"
+        ],
+        "requiresReview": true
+      }
+    ],
+    "milestoneSuggestions": []
+  }
+}