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

package/dist/schemas/topic-contract-state.schema.json

@@ -1,344 +1,37 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://topic-protocol.ixo.world/schemas/topic-contract-state.schema.json",
-    "title": "Qi Topic Contract state profile v2",
+    "title": "Qi Topic Contract state profile v4",
     "type": "object",
-    "required": ["version", "profile", "schema", "topicId", "anchor", "manifest", "contracts", "projection", "policy", "bindings", "provenance"],
+    "required": ["version", "profile", "schema", "topicId", "anchor", "manifest", "contracts", "shape", "progress", "projection", "policy", "bindings", "provenance"],
     "properties": {
-        "version": { "const": 2 },
-        "profile": { "const": "qi.topic-contract-state/v2" },
+        "version": { "const": 4 },
+        "profile": { "const": "qi.topic-contract-state/v4" },
         "schema": { "const": "https://topic-protocol.ixo.world/schemas/topic-contract-state.schema.json" },
         "topicId": { "$ref": "#/$defs/topicId" },
-        "anchor": { "$ref": "#/$defs/anchor" },
-        "manifest": { "$ref": "#/$defs/manifest" },
-        "contracts": { "$ref": "#/$defs/contractHeads" },
-        "projection": { "$ref": "#/$defs/projection" },
+        "anchor": { "type": "object", "required": ["mode", "roomId", "rootEventId", "manifestSource"], "properties": { "mode": { "enum": ["native", "adopted"] }, "roomId": { "type": "string", "pattern": "^!" }, "rootEventId": { "type": "string", "pattern": "^\\$" }, "manifestSource": { "enum": ["root-event", "state-event"] } }, "additionalProperties": false },
+        "manifest": { "type": "object", "required": ["version", "id", "title", "kind", "status", "createdBy", "createdAt", "baseRecipe", "shapeDigest"], "properties": { "version": { "const": 4 }, "id": { "$ref": "#/$defs/topicId" }, "title": { "type": "string", "minLength": 1, "maxLength": 280 }, "kind": { "type": "string", "minLength": 1 }, "status": { "enum": ["draft", "active", "waiting", "blocked", "resolved", "archived", "redirected"] }, "createdBy": { "type": "string", "minLength": 1 }, "createdAt": { "type": "string", "format": "date-time" }, "baseRecipe": { "enum": ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"] }, "topicRecipeRef": { "type": "object" }, "shapeDigest": { "$ref": "#/$defs/digest" } }, "additionalProperties": true },
+        "contracts": { "type": "object", "properties": { "proposed": { "allOf": [{ "$ref": "#/$defs/contractRef" }, { "type": "object", "properties": { "confirmations": { "type": "array", "items": { "type": "object" } }, "assents": { "type": "array", "items": { "type": "object" } } } }] }, "effective": { "allOf": [{ "$ref": "#/$defs/contractRef" }, { "type": "object", "required": ["effectiveAt", "confirmations"], "properties": { "effectiveAt": { "type": "string", "format": "date-time" }, "confirmations": { "type": "array", "items": { "type": "object" } }, "assents": { "type": "array", "items": { "type": "object" } } } }] }, "superseded": { "type": "array", "items": { "type": "object" } } }, "additionalProperties": false },
+        "shape": { "type": "object", "required": ["digest", "sources"], "properties": { "digest": { "$ref": "#/$defs/digest" }, "sources": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/shapeSource" } } }, "additionalProperties": false },
+        "progress": { "type": "object", "required": ["version", "topicId", "topicRevision", "contractRevision", "shapeDigest", "phase", "condition", "reasonCode", "axisStates", "stateTags", "candidates", "obligations", "provenance"], "properties": { "version": { "const": 2 }, "topicId": { "$ref": "#/$defs/topicId" }, "topicRevision": { "type": "string" }, "contractRevision": { "type": "string" }, "shapeDigest": { "$ref": "#/$defs/digest" }, "phase": { "$ref": "#/$defs/phase" }, "condition": { "$ref": "#/$defs/condition" }, "reasonCode": { "type": "string" }, "axisStates": { "type": "object", "additionalProperties": { "type": "string" } }, "stateTags": { "type": "array", "items": { "type": "object" } }, "candidates": { "type": "array", "items": { "type": "object" } }, "obligations": { "type": "array", "items": { "$ref": "#/$defs/obligation" } }, "primaryObligationId": { "type": "string" }, "evaluatedAt": { "type": "object" }, "provenance": { "type": "array", "items": { "type": "string" } }, "block": { "type": "object" }, "dispute": { "type": "object" } }, "additionalProperties": false },
+        "projection": { "type": "object", "required": ["revision", "contractRevision", "title", "status", "setupStatus", "kindRef", "attachmentCount", "operationCount"], "properties": { "revision": { "type": "string", "minLength": 1 }, "contractRevision": { "type": "string", "minLength": 1 }, "title": { "type": "string", "minLength": 1 }, "status": { "enum": ["draft", "active", "waiting", "blocked", "resolved", "archived", "redirected"] }, "setupStatus": { "enum": ["draft", "awaiting-confirmation", "scheduled", "confirmed", "review-due", "expired", "disputed"] }, "kindRef": { "type": "object" }, "attachmentCount": { "type": "integer", "minimum": 0 }, "operationCount": { "type": "integer", "minimum": 0 }, "claimBinding": { "type": "object" }, "claimResolution": { "type": "object" } }, "additionalProperties": true },
         "policy": { "type": "object" },
-        "bindings": { "$ref": "#/$defs/bindings" },
-        "provenance": { "$ref": "#/$defs/provenance" },
+        "bindings": { "type": "object", "properties": { "flows": { "type": "array", "items": { "$ref": "https://topic-protocol.ixo.world/schemas/topic-flow-binding.schema.json" } }, "context": { "type": "array", "items": { "type": "object" } }, "udidReferences": { "type": "array", "items": { "type": "object" } } }, "additionalProperties": false },
+        "provenance": { "type": "object" },
         "extensions": { "type": "object" }
     },
     "additionalProperties": false,
     "$defs": {
         "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
-        "entryId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
-        "eventId": { "type": "string", "pattern": "^\\$" },
-        "roomId": { "type": "string", "pattern": "^!" },
-        "hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
-        "persistedKind": { "type": "string", "enum": ["task", "agent_task", "proposal", "evaluation", "claims", "question", "discussion", "incident"] },
-        "kindRef": {
-            "oneOf": [
-                {
-                    "type": "object",
-                    "required": ["source", "kind"],
-                    "properties": { "source": { "const": "standard" }, "kind": { "$ref": "#/$defs/persistedKind" } },
-                    "additionalProperties": false
-                },
-                {
-                    "type": "object",
-                    "required": ["source", "customId", "label", "baseKind"],
-                    "properties": {
-                        "source": { "const": "custom" },
-                        "customId": { "type": "string", "minLength": 1, "maxLength": 128 },
-                        "label": { "type": "string", "minLength": 1, "maxLength": 80 },
-                        "baseKind": { "$ref": "#/$defs/persistedKind" }
-                    },
-                    "additionalProperties": false
-                }
-            ]
-        },
-        "kindProfileRef": {
-            "type": "object",
-            "required": ["id", "version", "schema", "digest"],
-            "properties": {
-                "id": { "type": "string", "format": "uri" },
-                "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
-                "schema": { "type": "string", "format": "uri" },
-                "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
-            },
-            "additionalProperties": false
-        },
-        "kindResource": {
-            "type": "object",
-            "required": ["profile", "type", "id", "version", "value"],
-            "properties": {
-                "profile": { "$ref": "#/$defs/kindProfileRef" },
-                "type": { "type": "string", "minLength": 1, "maxLength": 128 },
-                "id": { "type": "string", "minLength": 1, "maxLength": 512 },
-                "version": { "type": "integer", "minimum": 1 },
-                "value": { "type": "object" }
-            },
-            "additionalProperties": false
-        },
-        "anchor": {
-            "oneOf": [
-                {
-                    "type": "object",
-                    "required": ["mode", "roomId", "rootEventId", "manifestSource"],
-                    "properties": {
-                        "mode": { "const": "native" },
-                        "roomId": { "$ref": "#/$defs/roomId" },
-                        "rootEventId": { "$ref": "#/$defs/eventId" },
-                        "manifestSource": { "const": "root-event" }
-                    },
-                    "additionalProperties": false
-                },
-                {
-                    "type": "object",
-                    "required": ["mode", "roomId", "rootEventId", "manifestSource"],
-                    "properties": {
-                        "mode": { "const": "adopted" },
-                        "roomId": { "$ref": "#/$defs/roomId" },
-                        "rootEventId": { "$ref": "#/$defs/eventId" },
-                        "manifestSource": { "const": "state-event" }
-                    },
-                    "additionalProperties": false
-                }
-            ]
-        },
-        "manifest": {
-            "type": "object",
-            "required": ["version", "id", "title", "kind", "status", "createdBy", "createdAt"],
-            "properties": {
-                "version": { "const": 2 },
-                "id": { "$ref": "#/$defs/topicId" },
-                "title": { "type": "string", "minLength": 1, "maxLength": 280 },
-                "kind": { "$ref": "#/$defs/persistedKind" },
-                "status": { "type": "string", "enum": ["draft", "active", "waiting", "blocked", "resolved", "archived", "redirected"] },
-                "createdBy": { "type": "string", "minLength": 1 },
-                "createdAt": { "type": "string", "format": "date-time" }
-            },
-            "additionalProperties": true
-        },
-        "provenance": {
-            "type": "object",
-            "required": ["basis", "acceptance", "sourceEventIds"],
-            "properties": {
-                "basis": { "type": "string", "enum": ["explicit", "contextual", "inferred", "suggested", "retrieved"] },
-                "acceptance": { "type": "string", "enum": ["proposed", "accepted", "rejected", "superseded"] },
-                "sourceEventIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/eventId" } },
-                "createdBy": { "type": "string", "minLength": 1 },
-                "createdAt": { "type": "string", "format": "date-time" }
-            },
-            "additionalProperties": false
-        },
-        "statement": {
-            "type": "object",
-            "required": ["id", "text", "provenance"],
-            "properties": {
-                "id": { "$ref": "#/$defs/entryId" },
-                "text": { "type": "string", "minLength": 1, "maxLength": 4000 },
-                "provenance": { "$ref": "#/$defs/provenance" }
-            },
-            "additionalProperties": false
-        },
-        "temporalTarget": {
-            "oneOf": [
-                {
-                    "type": "object",
-                    "required": ["precision", "value", "timezone"],
-                    "properties": {
-                        "precision": { "const": "date" },
-                        "value": { "type": "string", "format": "date" },
-                        "timezone": { "type": "string", "minLength": 1, "maxLength": 128 }
-                    },
-                    "additionalProperties": false
-                },
-                {
-                    "type": "object",
-                    "required": ["precision", "value", "timezone"],
-                    "properties": {
-                        "precision": { "const": "datetime" },
-                        "value": { "type": "string", "format": "date-time" },
-                        "timezone": { "type": "string", "minLength": 1, "maxLength": 128 }
-                    },
-                    "additionalProperties": false
-                }
-            ]
-        },
-        "criterion": {
-            "type": "object",
-            "required": ["id", "description", "status"],
-            "properties": {
-                "id": { "$ref": "#/$defs/entryId" },
-                "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
-                "status": { "type": "string", "enum": ["pending", "met", "not_met", "waived"] },
-                "verification": { "type": "object" }
-            },
-            "additionalProperties": false
-        },
-        "outcome": {
-            "type": "object",
-            "properties": {
-                "statement": { "$ref": "#/$defs/statement" },
-                "status": { "type": "string", "enum": ["proposed", "accepted", "achieved", "abandoned"] },
-                "target": { "$ref": "#/$defs/temporalTarget" },
-                "successCriteria": { "type": "array", "maxItems": 50, "items": { "$ref": "#/$defs/criterion" } },
-                "outcomeRecordId": { "type": "string", "minLength": 1 },
-                "abandonedReason": { "type": "string", "minLength": 1, "maxLength": 2000 }
-            },
-            "additionalProperties": false
-        },
-        "risk": {
-            "type": "object",
-            "required": ["id", "description", "status"],
-            "properties": {
-                "id": { "$ref": "#/$defs/entryId" },
-                "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
-                "impact": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
-                "status": { "type": "string", "enum": ["open", "mitigated", "accepted", "closed"] },
-                "owner": { "type": "string", "minLength": 1 },
-                "mitigation": { "type": "string", "minLength": 1, "maxLength": 2000 }
-            },
-            "additionalProperties": false
-        },
-        "appearance": {
-            "type": "object",
-            "properties": {
-                "glyph": {
-                    "oneOf": [
-                        { "type": "object", "required": ["type", "value"], "properties": { "type": { "const": "emoji" }, "value": { "type": "string", "minLength": 1, "maxLength": 16 } }, "additionalProperties": false },
-                        { "type": "object", "required": ["type", "name"], "properties": { "type": { "const": "icon" }, "name": { "type": "string", "enum": ["task", "agent", "proposal", "evaluation", "claims", "question", "discussion", "incident"] } }, "additionalProperties": false }
-                    ]
-                }
-            },
-            "additionalProperties": false
-        },
-        "contractBody": {
-            "type": "object",
-            "required": ["version", "revision", "status", "kindRef", "authoredBy", "authoredAt", "workingMode", "recipe"],
-            "properties": {
-                "version": { "const": 2 },
-                "revision": { "type": "string", "minLength": 1 },
-                "status": { "type": "string", "enum": ["draft", "accepted", "superseded"] },
-                "kindRef": { "$ref": "#/$defs/kindRef" },
-                "kindProfile": { "$ref": "#/$defs/kindProfileRef" },
-                "kindResource": { "$ref": "#/$defs/kindResource" },
-                "authoredBy": { "type": "string", "minLength": 1 },
-                "authoredAt": { "type": "string", "format": "date-time" },
-                "workingMode": { "type": "string", "enum": ["solo", "team", "client"] },
-                "recipe": { "type": "string", "enum": ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"] },
-                "locale": { "type": "string", "minLength": 2, "maxLength": 32 },
-                "timezone": { "type": "string", "minLength": 1, "maxLength": 128 },
-                "temporalMode": { "type": "string", "enum": ["finite", "ongoing"] },
-                "tags": { "type": "array", "uniqueItems": true, "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 80 } },
-                "appearance": { "$ref": "#/$defs/appearance" },
-                "intent": { "$ref": "#/$defs/statement" },
-                "outcome": { "$ref": "#/$defs/outcome" },
-                "completion": { "type": "object" },
-                "ownerId": { "type": "string", "minLength": 1 },
-                "scope": { "type": "object" },
-                "constraints": { "type": "array", "maxItems": 50, "items": { "$ref": "#/$defs/statement" } },
-                "assumptions": { "type": "array", "maxItems": 50, "items": { "type": "object" } },
-                "questions": { "type": "array", "maxItems": 50, "items": { "type": "object" } },
-                "risks": { "type": "array", "maxItems": 50, "items": { "$ref": "#/$defs/risk" } },
-                "participants": { "type": "array", "maxItems": 100, "items": { "type": "object" } },
-                "roles": { "type": "array", "maxItems": 50, "items": { "type": "object" } },
-                "agents": { "type": "array", "maxItems": 20, "items": { "type": "object" } },
-                "decision": { "type": "object" },
-                "plan": { "type": "object" },
-                "attachments": { "type": "array", "maxItems": 100, "items": { "type": "object" } }
-            },
-            "additionalProperties": true
-        },
-        "contractRef": {
-            "type": "object",
-            "required": ["revision", "bodyHash", "bodyRef"],
-            "properties": {
-                "revision": { "type": "string", "minLength": 1 },
-                "bodyHash": { "$ref": "#/$defs/hash" },
-                "bodyRef": { "type": "object" },
-                "body": { "$ref": "#/$defs/contractBody" }
-            },
-            "additionalProperties": true
-        },
-        "effectiveContractRef": {
-            "allOf": [
-                { "$ref": "#/$defs/contractRef" },
-                {
-                    "type": "object",
-                    "required": ["acceptedBy", "acceptedAt"],
-                    "properties": {
-                        "acceptedBy": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
-                        "acceptedAt": { "type": "string", "format": "date-time" }
-                    }
-                }
-            ]
-        },
-        "contractHeads": {
-            "type": "object",
-            "properties": { "proposed": { "$ref": "#/$defs/contractRef" }, "effective": { "$ref": "#/$defs/effectiveContractRef" } },
-            "additionalProperties": false
-        },
-        "projection": {
-            "type": "object",
-            "required": ["revision", "title", "status", "kindRef", "attachmentCount", "operationCount"],
-            "properties": {
-                "revision": { "type": "string", "minLength": 1 },
-                "title": { "type": "string", "minLength": 1, "maxLength": 280 },
-                "status": { "type": "string", "enum": ["draft", "active", "waiting", "blocked", "resolved", "archived", "redirected"] },
-                "kindRef": { "$ref": "#/$defs/kindRef" },
-                "kindProfile": { "$ref": "#/$defs/kindProfileRef" },
-                "appearance": { "$ref": "#/$defs/appearance" },
-                "attachmentCount": { "type": "integer", "minimum": 0 },
-                "operationCount": { "type": "integer", "minimum": 0 },
-                "actions": {
-                    "type": "array",
-                    "maxItems": 500,
-                    "items": {
-                        "type": "object",
-                        "required": ["request", "status", "operationId"],
-                        "properties": {
-                            "request": { "$ref": "https://topic-protocol.ixo.world/schemas/topic-action-request.schema.json" },
-                            "latestReceipt": { "$ref": "https://topic-protocol.ixo.world/schemas/action-receipt.schema.json#/$defs/v2" },
-                            "status": { "enum": ["requested", "awaiting_confirmation", "running", "succeeded", "failed", "rejected", "cancelled", "needs_verification"] },
-                            "operationId": { "type": "string", "minLength": 1 }
-                        },
-                        "additionalProperties": false
-                    }
-                }
-            },
-            "additionalProperties": true
-        },
-        "recurrence": {
-            "oneOf": [
-                { "type": "object", "required": ["frequency", "time", "timezone"], "properties": { "frequency": { "const": "daily" }, "time": { "type": "string", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$" }, "timezone": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
-                { "type": "object", "required": ["frequency", "days", "time", "timezone"], "properties": { "frequency": { "const": "weekly" }, "days": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"] } }, "time": { "type": "string", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$" }, "timezone": { "type": "string", "minLength": 1 } }, "additionalProperties": false }
-            ]
-        },
-        "automation": {
-            "type": "object",
-            "required": ["provider", "scheduleId", "recurrence", "status"],
-            "properties": {
-                "provider": { "const": "temporal" },
-                "scheduleId": { "type": "string", "minLength": 1 },
-                "actionId": { "type": "string", "minLength": 1 },
-                "target": {
-                    "oneOf": [
-                        { "type": "object", "required": ["kind", "actionType"], "properties": { "kind": { "const": "action" }, "actionType": { "type": "string", "pattern": "^qi/" } }, "additionalProperties": false },
-                        { "type": "object", "required": ["kind", "bindingId"], "properties": { "kind": { "const": "flow" }, "bindingId": { "type": "string", "minLength": 1 } }, "additionalProperties": false }
-                    ]
-                },
-                "recurrence": { "$ref": "#/$defs/recurrence" },
-                "status": { "type": "string", "enum": ["pending", "active", "paused", "failed"] },
-                "nextRunAt": { "type": "string", "format": "date-time" }
-            },
-            "additionalProperties": false,
-            "anyOf": [
-                { "properties": { "actionId": true }, "required": ["actionId"] },
-                { "properties": { "target": true }, "required": ["target"] }
-            ]
-        },
-        "bindings": {
-            "type": "object",
-            "properties": {
-                "governanceProposal": { "type": "object" },
-                "claims": { "type": "object" },
-                "automations": { "type": "array", "maxItems": 20, "items": { "$ref": "#/$defs/automation" } },
-                "flows": { "type": "array", "maxItems": 20, "items": { "$ref": "https://topic-protocol.ixo.world/schemas/topic-flow-binding.schema.json" } },
-                "context": { "type": "array", "maxItems": 100, "items": { "type": "object" } }
-            },
-            "additionalProperties": false
-        }
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "phase": { "enum": ["forming", "working", "verifying", "deciding", "effecting", "settling", "complete", "dormant"] },
+        "condition": { "enum": ["on-track", "needs-input", "needs-confirmation", "review-due", "expired", "waiting", "blocked", "failed", "disputed", "degraded"] },
+        "shapeSource": { "type": "object", "required": ["kind", "id", "version", "digest"], "properties": { "kind": { "enum": ["base-recipe", "topic-recipe", "kind", "topic"] }, "id": { "type": "string", "format": "uri" }, "version": { "type": "string" }, "digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false },
+        "contractRef": { "type": "object", "required": ["revision", "bodyHash", "bodyRef"], "properties": { "revision": { "type": "string" }, "bodyHash": { "$ref": "#/$defs/digest" }, "bodyRef": { "type": "object" }, "body": { "type": "object" } }, "additionalProperties": true },
+        "obligation": { "type": "object", "required": ["id", "code", "kind", "phase", "status", "priority", "blocking", "assignedActors", "consequence", "presentation", "provenance"], "properties": { "id": { "type": "string" }, "code": { "type": "string" }, "kind": { "enum": ["safety", "input", "confirmation", "assent", "transition", "wait", "review", "expiry", "dispute"] }, "phase": { "$ref": "#/$defs/phase" }, "status": { "enum": ["open", "ready", "waiting", "blocked", "unavailable"] }, "priority": { "type": "integer" }, "blocking": { "type": "boolean" }, "responsibility": { "type": "object" }, "assignedActors": { "type": "array", "items": { "type": "string" } }, "requiredAbility": { "type": "string" }, "consequence": { "enum": ["none", "shared-state", "external-effect", "settlement"] }, "focusPath": { "type": "string" }, "transitionCode": { "type": "string" }, "command": { "type": "string" }, "handoff": { "type": "object" }, "presentation": { "type": "object" }, "provenance": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false },
+        "temporalTarget": { "oneOf": [
+                { "type": "object", "required": ["precision", "value", "timezone"], "properties": { "precision": { "const": "date" }, "value": { "type": "string", "format": "date" }, "timezone": { "type": "string" } }, "additionalProperties": false },
+                { "type": "object", "required": ["precision", "value", "timezone"], "properties": { "precision": { "const": "datetime" }, "value": { "type": "string", "format": "date-time" }, "timezone": { "type": "string" } }, "additionalProperties": false }
+            ] }
     }
 }

package/dist/schemas/topic-operation.schema.json

@@ -8,7 +8,7 @@
         "version": { "enum": [1, 2] },
         "operationId": { "type": "string", "minLength": 1 },
         "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
-        "type": { "type": "string", "enum": ["rename", "change-status", "update-overview", "link-context", "unlink-context", "attach-files", "detach-files", "record-decision", "propose-contract", "update-contract", "accept-contract", "supersede-contract", "bind-automation", "update-automation", "pause-automation", "remove-automation", "bind-flow", "update-flow-binding", "unbind-flow", "request-action", "cancel-action", "record-action-receipt", "bind-external-work", "sync-external-work", "unlink-external-work", "submit-delivery", "record-delivery-decision", "record-evaluation", "record-approval", "record-claim", "record-settlement", "redirect", "branch", "merge", "resolve-conflict"] },
+        "type": { "type": "string", "enum": ["rename", "change-status", "update-overview", "link-context", "unlink-context", "attach-files", "detach-files", "record-decision", "record-outcome", "propose-contract", "update-contract", "accept-contract", "confirm-setup", "withdraw-setup-confirmation", "record-assent", "withdraw-assent", "raise-dispute", "resolve-dispute", "supersede-contract", "bind-automation", "update-automation", "pause-automation", "remove-automation", "bind-flow", "update-flow-binding", "unbind-flow", "request-action", "cancel-action", "record-action-receipt", "bind-external-work", "sync-external-work", "unlink-external-work", "submit-delivery", "record-delivery-decision", "record-evaluation", "record-approval", "record-claim", "record-settlement", "redirect", "branch", "merge", "resolve-conflict"] },
         "previousRevision": { "type": "string", "minLength": 1 },
         "actor": { "type": "string", "minLength": 1 },
         "createdAt": { "type": "string", "format": "date-time" },
@@ -20,7 +20,7 @@
         {
             "if": {
                 "properties": {
-                    "type": { "enum": ["propose-contract", "update-contract", "accept-contract", "supersede-contract", "bind-automation", "update-automation", "pause-automation", "remove-automation", "bind-flow", "update-flow-binding", "unbind-flow", "request-action", "cancel-action", "record-action-receipt", "bind-external-work", "sync-external-work", "unlink-external-work", "submit-delivery", "record-delivery-decision", "record-evaluation", "record-approval", "record-claim", "record-settlement"] }
+                    "type": { "enum": ["record-outcome", "propose-contract", "update-contract", "accept-contract", "confirm-setup", "withdraw-setup-confirmation", "record-assent", "withdraw-assent", "raise-dispute", "resolve-dispute", "supersede-contract", "bind-automation", "update-automation", "pause-automation", "remove-automation", "bind-flow", "update-flow-binding", "unbind-flow", "request-action", "cancel-action", "record-action-receipt", "bind-external-work", "sync-external-work", "unlink-external-work", "submit-delivery", "record-delivery-decision", "record-evaluation", "record-approval", "record-claim", "record-settlement"] }
                 },
                 "required": ["type"]
             },

package/dist/schemas/topic-recipe.schema.json

@@ -0,0 +1,19 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/topic-recipe.schema.json",
+    "title": "Topic Recipe v1",
+    "type": "object",
+    "required": ["version", "code", "id", "recipeVersion", "label", "description", "baseRecipe", "creates", "shape"],
+    "properties": {
+        "version": { "const": 1 },
+        "code": { "enum": ["research-brief", "agent-delivery", "verified-work-payment"] },
+        "id": { "type": "string", "format": "uri" },
+        "recipeVersion": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "description": { "type": "string", "minLength": 1 },
+        "baseRecipe": { "enum": ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"] },
+        "creates": { "const": "draft" },
+        "shape": { "$ref": "https://topic-protocol.ixo.world/schemas/topic-shape.schema.json" }
+    },
+    "additionalProperties": false
+}

package/dist/schemas/topic-root.schema.json

@@ -5,7 +5,7 @@
     "type": "object",
     "required": ["version", "id", "title", "status", "createdBy", "createdAt"],
     "properties": {
-        "version": { "enum": [1, 2] },
+        "version": { "enum": [1, 2, 3, 4] },
         "id": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
         "title": { "type": "string", "minLength": 1, "maxLength": 280 },
         "kind": { "type": "string", "enum": ["discussion", "question", "decision", "proposal", "task", "incident", "flow", "agent_task", "evaluation", "claims"] },
@@ -25,6 +25,18 @@
                 "additionalProperties": false
             }
         },
+        "baseRecipe": { "enum": ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"] },
+        "topicRecipeRef": {
+            "type": "object",
+            "required": ["id", "version", "digest"],
+            "properties": {
+                "id": { "type": "string", "format": "uri" },
+                "version": { "type": "string", "minLength": 1 },
+                "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+            },
+            "additionalProperties": false
+        },
+        "shapeDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
         "overview": {
             "type": "object",
             "required": ["summary"],
@@ -49,6 +61,14 @@
         {
             "if": { "properties": { "version": { "const": 2 } }, "required": ["version"] },
             "then": { "properties": { "kind": true }, "required": ["kind"] }
+        },
+        {
+            "if": { "properties": { "version": { "const": 3 } }, "required": ["version"] },
+            "then": { "properties": { "kind": true, "baseRecipe": true, "shapeDigest": true }, "required": ["kind", "baseRecipe", "shapeDigest"] }
+        },
+        {
+            "if": { "properties": { "version": { "const": 4 } }, "required": ["version"] },
+            "then": { "properties": { "kind": true, "baseRecipe": true, "shapeDigest": true }, "required": ["kind", "baseRecipe", "shapeDigest"] }
         }
     ]
 }

package/dist/schemas/topic-shape.schema.json

@@ -0,0 +1,80 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/topic-shape.schema.json",
+    "title": "Topic Shape v1",
+    "type": "object",
+    "required": ["version", "code", "axes", "transitions", "progressRules", "inferredRecordPolicy"],
+    "properties": {
+        "version": { "const": 1 },
+        "code": { "type": "string", "minLength": 1 },
+        "axes": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+                "type": "object",
+                "required": ["code", "phase", "required", "initialState", "states"],
+                "properties": {
+                    "code": { "type": "string", "minLength": 1 },
+                    "phase": { "$ref": "#/$defs/phase" },
+                    "required": { "type": "boolean" },
+                    "initialState": { "type": "string", "minLength": 1 },
+                    "states": {
+                        "type": "array",
+                        "minItems": 2,
+                        "items": {
+                            "type": "object",
+                            "required": ["code"],
+                            "properties": {
+                                "code": { "type": "string", "minLength": 1 },
+                                "labelKey": { "type": "string", "minLength": 1 },
+                                "terminal": { "type": "boolean" },
+                                "condition": { "$ref": "#/$defs/condition" }
+                            },
+                            "additionalProperties": false
+                        }
+                    }
+                },
+                "additionalProperties": false
+            }
+        },
+        "transitions": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+                "type": "object",
+                "required": ["code", "phase", "predecessor", "target", "command", "requiredAbility", "assignedTo", "gates", "confirmation", "consequence", "evidence", "presentation"],
+                "properties": {
+                    "code": { "type": "string", "minLength": 1 },
+                    "phase": { "$ref": "#/$defs/phase" },
+                    "predecessor": { "$ref": "#/$defs/axisState" },
+                    "target": { "$ref": "#/$defs/axisState" },
+                    "command": { "type": "string", "minLength": 1 },
+                    "requiredAbility": { "type": "string", "minLength": 1 },
+                    "assignedTo": {
+                        "type": "object",
+                        "required": ["kind", "value"],
+                        "properties": { "kind": { "enum": ["actor", "role"] }, "value": { "type": "string", "minLength": 1 } },
+                        "additionalProperties": false
+                    },
+                    "gates": { "type": "array", "items": { "type": "object", "required": ["kind"], "properties": { "kind": { "enum": ["field", "field-any", "record", "receipt", "axis", "binding", "condition"] }, "requirement": { "$ref": "#/$defs/requirement" } }, "additionalProperties": true } },
+                    "confirmation": { "enum": ["none", "viewer", "authority"] },
+                    "consequence": { "enum": ["none", "shared-state", "external-effect", "settlement"] },
+                    "evidence": { "type": "object", "required": ["kind", "type"], "properties": { "kind": { "enum": ["operation", "record", "receipt"] }, "type": { "type": "string", "minLength": 1 }, "finality": { "enum": ["observed", "accepted", "verified", "final"] } }, "additionalProperties": false },
+                    "completesTopic": { "type": "boolean" },
+                    "handoff": { "type": "object", "required": ["kind", "binding"], "properties": { "kind": { "enum": ["flow", "resource"] }, "binding": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
+                    "presentation": { "type": "object", "required": ["reasonCode", "actionLabelKey", "bodyKey", "purposeKey", "unlocksKey", "priority"], "properties": { "reasonCode": { "type": "string", "minLength": 1 }, "actionLabelKey": { "type": "string", "minLength": 1 }, "bodyKey": { "type": "string", "minLength": 1 }, "purposeKey": { "type": "string", "minLength": 1 }, "unlocksKey": { "type": "string", "minLength": 1 }, "priority": { "type": "integer" }, "focusPath": { "type": "string" } }, "additionalProperties": false }
+                },
+                "additionalProperties": false
+            }
+        },
+        "progressRules": { "type": "array", "items": { "type": "object", "required": ["code", "condition", "priority", "source"], "properties": { "code": { "type": "string" }, "condition": { "$ref": "#/$defs/condition" }, "priority": { "type": "integer" }, "source": { "type": "object" }, "states": { "type": "array", "items": { "type": "string" } }, "requiresTarget": { "type": "boolean" } }, "additionalProperties": false } },
+        "inferredRecordPolicy": { "type": "object", "required": ["autoAccept", "neverAutoAccept"], "properties": { "autoAccept": { "type": "array", "items": { "type": "string" } }, "neverAutoAccept": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }
+    },
+    "additionalProperties": false,
+    "$defs": {
+        "phase": { "enum": ["forming", "working", "verifying", "deciding", "effecting", "settling", "complete", "dormant"] },
+        "condition": { "enum": ["on-track", "needs-input", "needs-confirmation", "review-due", "expired", "waiting", "blocked", "failed", "disputed", "degraded"] },
+        "requirement": { "type": "object", "required": ["code", "labelKey", "promptKey", "purposeKey", "priority"], "properties": { "code": { "type": "string", "minLength": 1 }, "labelKey": { "type": "string", "minLength": 1 }, "promptKey": { "type": "string", "minLength": 1 }, "purposeKey": { "type": "string", "minLength": 1 }, "priority": { "type": "integer" }, "focusPath": { "type": "string" }, "assignedTo": { "type": "object", "required": ["kind", "value"], "properties": { "kind": { "enum": ["actor", "role"] }, "value": { "type": "string", "minLength": 1 } }, "additionalProperties": false } }, "additionalProperties": false },
+        "axisState": { "type": "object", "required": ["axis", "state"], "properties": { "axis": { "type": "string", "minLength": 1 }, "state": { "type": "string", "minLength": 1 } }, "additionalProperties": false }
+    }
+}