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

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

@@ -1,344 +1,112 @@
 {
     "$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 v3",
     "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": 3 },
+        "profile": { "const": "qi.topic-contract-state/v3" },
         "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" },
-        "policy": { "type": "object" },
-        "bindings": { "$ref": "#/$defs/bindings" },
-        "provenance": { "$ref": "#/$defs/provenance" },
-        "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": {
+        "anchor": {
             "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" }
-            },
+            "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
         },
-        "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"],
+            "required": ["version", "id", "title", "kind", "status", "createdBy", "createdAt", "baseRecipe", "shapeDigest"],
             "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" }
+                "version": { "const": 3 }, "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
         },
-        "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": {
+        "contracts": { "type": "object" },
+        "shape": {
             "type": "object",
-            "required": ["id", "description", "status"],
+            "required": ["digest", "sources"],
             "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 }
+                "digest": { "$ref": "#/$defs/digest" },
+                "sources": { "type": "array", "minItems": 1, "items": { "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 } }
             },
             "additionalProperties": false
         },
-        "appearance": {
+        "progress": {
             "type": "object",
+            "required": ["version", "topicId", "topicRevision", "contractRevision", "shapeDigest", "phase", "condition", "reasonCode", "axisStates", "stateTags", "candidates", "provenance"],
             "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 }
-                    ]
-                }
+                "version": { "const": 1 }, "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" } }, "provenance": { "type": "array", "items": { "type": "string" } }, "block": { "type": "object" }
             },
             "additionalProperties": false
         },
-        "contractBody": {
+        "projection": {
             "type": "object",
-            "required": ["version", "revision", "status", "kindRef", "authoredBy", "authoredAt", "workingMode", "recipe"],
+            "required": ["revision", "contractRevision", "title", "status", "kindRef", "attachmentCount", "operationCount"],
             "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" } }
+                "revision": { "type": "string", "minLength": 1 }, "contractRevision": { "type": "string", "minLength": 1 }, "title": { "type": "string", "minLength": 1 },
+                "status": { "enum": ["draft", "active", "waiting", "blocked", "resolved", "archived", "redirected"] }, "kindRef": { "type": "object" },
+                "attachmentCount": { "type": "integer", "minimum": 0 }, "operationCount": { "type": "integer", "minimum": 0 },
+                "claimBinding": { "type": "object", "required": ["entityDid", "collectionId"], "properties": { "entityDid": { "type": "string" }, "collectionId": { "type": "string" } }, "additionalProperties": false },
+                "claimResolution": { "type": "object", "required": ["entityDid", "collectionId", "protocolDid", "rubric"], "properties": { "entityDid": { "type": "string" }, "collectionId": { "type": "string" }, "protocolDid": { "type": "string" }, "rubric": { "type": "object" } }, "additionalProperties": false }
             },
             "additionalProperties": true
         },
-        "contractRef": {
+        "policy": { "type": "object" },
+        "bindings": {
             "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" }
+                "flows": { "type": "array", "items": { "$ref": "https://topic-protocol.ixo.world/schemas/topic-flow-binding.schema.json" } },
+                "context": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "required": ["type", "id"],
+                        "properties": {
+                            "type": { "enum": ["ixo.resource", "ixo.flow", "matrix.conversation", "ixo.entity", "ixo.service"] },
+                            "id": { "type": "string", "minLength": 1 },
+                            "label": { "type": "string" }
+                        },
+                        "additionalProperties": false
                     }
-                }
-            ]
-        },
-        "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": {
+                },
+                "udidReferences": {
                     "type": "array",
-                    "maxItems": 500,
                     "items": {
                         "type": "object",
-                        "required": ["request", "status", "operationId"],
+                        "required": ["id", "role"],
                         "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 }
+                            "id": { "type": "string", "minLength": 1 },
+                            "role": { "enum": ["evaluation", "decision", "effect", "settlement"] },
+                            "digest": { "$ref": "#/$defs/digest" }
                         },
                         "additionalProperties": false
                     }
                 }
             },
-            "additionalProperties": true
+            "additionalProperties": false
         },
-        "recurrence": {
+        "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}$" },
+        "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-acceptance", "waiting", "blocked", "failed", "disputed", "degraded"] },
+        "temporalTarget": {
             "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 }
+                { "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 }
             ]
-        },
-        "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
         }
     }
 }

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] },
         "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,10 @@
         {
             "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"] }
         }
     ]
 }

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

@@ -0,0 +1,79 @@
+{
+    "$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"],
+                "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"] } }, "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" }
+                },
+                "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-acceptance", "waiting", "blocked", "failed", "disputed", "degraded"] },
+        "axisState": { "type": "object", "required": ["axis", "state"], "properties": { "axis": { "type": "string", "minLength": 1 }, "state": { "type": "string", "minLength": 1 } }, "additionalProperties": false }
+    }
+}