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

package/README.md

@@ -9,7 +9,7 @@ identity of a discussion.
 
 ## Status
 
-**Version:** 1.0.0-rc.1
+**Version:** 1.0.0-rc.2
 
 The normative Topic Shape progression and Portal Now projection are defined in
 [Topic Shape Framework v1](docs/topic-shape-framework.md).

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

@@ -1,13 +1,12 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://topic-protocol.ixo.world/schemas/topic-contract-body.schema.json",
-    "title": "Topic contract body v3",
+    "title": "Topic contract body v4",
     "type": "object",
-    "required": ["version", "revision", "status", "kindRef", "authoredBy", "authoredAt", "workingMode", "baseRecipe", "shapeSources", "shapeDigest"],
+    "required": ["version", "revision", "kindRef", "authoredBy", "authoredAt", "workingMode", "baseRecipe", "shapeSources", "shapeDigest"],
     "properties": {
-        "version": { "const": 3 },
+        "version": { "const": 4 },
         "revision": { "type": "string", "minLength": 1 },
-        "status": { "enum": ["draft", "accepted", "superseded"] },
         "kindRef": { "type": "object" },
         "kindProfile": { "type": "object" },
         "kindResource": { "type": "object" },
@@ -19,6 +18,8 @@
         "shapeSources": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/shapeSource" } },
         "shapeDigest": { "$ref": "#/$defs/digest" },
         "claimBinding": { "type": "object", "required": ["entityDid", "collectionId"], "properties": { "entityDid": { "type": "string", "pattern": "^did:ixo:" }, "collectionId": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
+        "activationPolicy": { "$ref": "#/$defs/activationPolicy" },
+        "assentPolicy": { "$ref": "#/$defs/assentPolicy" },
         "locale": { "type": "string" },
         "timezone": { "type": "string" },
         "temporalMode": { "enum": ["finite", "ongoing"] },
@@ -38,29 +39,19 @@
         "decision": { "type": "object" },
         "plan": { "type": "object" },
         "attachments": { "type": "array", "items": { "type": "object" } },
-        "fieldProvenance": {
-            "type": "object",
-            "propertyNames": { "pattern": "^/" },
-            "additionalProperties": { "$ref": "#/$defs/fieldProvenance" }
-        }
+        "fieldProvenance": { "type": "object", "propertyNames": { "pattern": "^/" }, "additionalProperties": { "$ref": "#/$defs/fieldProvenance" } }
     },
     "additionalProperties": false,
     "$defs": {
         "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
         "digestRef": { "type": "object", "required": ["id", "version", "digest"], "properties": { "id": { "type": "string", "format": "uri" }, "version": { "type": "string", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false },
         "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", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false },
+        "subject": { "type": "object", "required": ["kind", "id"], "properties": { "kind": { "enum": ["actor", "role"] }, "id": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
+        "confirmationRule": { "type": "object", "required": ["mode", "subjects"], "properties": { "mode": { "enum": ["any", "all", "threshold"] }, "subjects": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/subject" } }, "threshold": { "type": "integer", "minimum": 1 } }, "additionalProperties": false },
+        "assentPolicy": { "type": "object", "required": ["mode", "signatories"], "properties": { "mode": { "enum": ["any", "all", "threshold"] }, "signatories": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/subject" } }, "threshold": { "type": "integer", "minimum": 1 } }, "additionalProperties": false },
+        "disputePolicy": { "type": "object", "properties": { "resolvers": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/subject" } }, "process": { "type": "object", "required": ["kind", "id"], "properties": { "kind": { "enum": ["flow", "resource"] }, "id": { "type": "string", "minLength": 1 }, "label": { "type": "string" } }, "additionalProperties": false } }, "additionalProperties": false },
+        "activationPolicy": { "type": "object", "properties": { "editors": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/subject" } }, "confirmation": { "$ref": "#/$defs/confirmationRule" }, "lifecycle": { "type": "object", "required": ["onExpiry"], "properties": { "effectiveAt": { "type": "string", "format": "date-time" }, "reviewAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "onExpiry": { "const": "pause-consequential" } }, "additionalProperties": false }, "dispute": { "$ref": "#/$defs/disputePolicy" } }, "additionalProperties": false },
         "risk": { "type": "object", "required": ["id", "description", "status"], "properties": { "id": { "type": "string" }, "description": { "type": "string" }, "impact": { "enum": ["low", "medium", "high", "critical"] }, "status": { "enum": ["open", "mitigated", "accepted", "closed"] }, "owner": { "type": "string" }, "mitigation": { "type": "string" } }, "additionalProperties": false },
-        "fieldProvenance": {
-            "type": "object",
-            "required": ["basis", "acceptance", "sourceEventIds"],
-            "properties": {
-                "basis": { "enum": ["explicit", "contextual", "inferred", "suggested", "retrieved"] },
-                "acceptance": { "enum": ["proposed", "accepted", "rejected", "superseded"] },
-                "sourceEventIds": { "type": "array", "items": { "type": "string" } },
-                "createdBy": { "type": "string" },
-                "createdAt": { "type": "string", "format": "date-time" }
-            },
-            "additionalProperties": false
-        }
+        "fieldProvenance": { "type": "object", "required": ["basis", "acceptance", "sourceEventIds"], "properties": { "basis": { "enum": ["explicit", "contextual", "inferred", "suggested", "retrieved"] }, "acceptance": { "enum": ["proposed", "accepted", "rejected", "superseded"] }, "sourceEventIds": { "type": "array", "items": { "type": "string" } }, "createdBy": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }
     }
 }

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

@@ -1,112 +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 v3",
+    "title": "Qi Topic Contract state profile v4",
     "type": "object",
     "required": ["version", "profile", "schema", "topicId", "anchor", "manifest", "contracts", "shape", "progress", "projection", "policy", "bindings", "provenance"],
     "properties": {
-        "version": { "const": 3 },
-        "profile": { "const": "qi.topic-contract-state/v3" },
+        "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": {
-            "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": 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
-        },
-        "contracts": { "type": "object" },
-        "shape": {
-            "type": "object",
-            "required": ["digest", "sources"],
-            "properties": {
-                "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
-        },
-        "progress": {
-            "type": "object",
-            "required": ["version", "topicId", "topicRevision", "contractRevision", "shapeDigest", "phase", "condition", "reasonCode", "axisStates", "stateTags", "candidates", "provenance"],
-            "properties": {
-                "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
-        },
-        "projection": {
-            "type": "object",
-            "required": ["revision", "contractRevision", "title", "status", "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"] }, "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
-        },
+        "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": {
-            "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",
-                        "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
-                    }
-                },
-                "udidReferences": {
-                    "type": "array",
-                    "items": {
-                        "type": "object",
-                        "required": ["id", "role"],
-                        "properties": {
-                            "id": { "type": "string", "minLength": 1 },
-                            "role": { "enum": ["evaluation", "decision", "effect", "settlement"] },
-                            "digest": { "$ref": "#/$defs/digest" }
-                        },
-                        "additionalProperties": false
-                    }
-                }
-            },
-            "additionalProperties": false
-        },
-        "provenance": { "type": "object" }, "extensions": { "type": "object" }
+        "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}$" },
         "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": [
+        "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-root.schema.json

@@ -5,7 +5,7 @@
     "type": "object",
     "required": ["version", "id", "title", "status", "createdBy", "createdAt"],
     "properties": {
-        "version": { "enum": [1, 2, 3] },
+        "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"] },
@@ -65,6 +65,10 @@
         {
             "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

@@ -42,7 +42,7 @@
             "minItems": 1,
             "items": {
                 "type": "object",
-                "required": ["code", "phase", "predecessor", "target", "command", "requiredAbility", "assignedTo", "gates", "confirmation", "consequence", "evidence"],
+                "required": ["code", "phase", "predecessor", "target", "command", "requiredAbility", "assignedTo", "gates", "confirmation", "consequence", "evidence", "presentation"],
                 "properties": {
                     "code": { "type": "string", "minLength": 1 },
                     "phase": { "$ref": "#/$defs/phase" },
@@ -56,13 +56,13 @@
                         "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 } },
+                    "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" }
+                    "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
             }
@@ -73,7 +73,8 @@
     "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"] },
+        "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 }
     }
 }