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

package/dist/schemas/payment-terms-v2.schema.json

@@ -0,0 +1,238 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/payment-terms-v2.schema.json",
+    "title": "IXO Claims-native Payment Terms resource v2",
+    "description": "Immutable authoring terms mapped to an IXO Claims Collection. The deployed collection remains authoritative for execution and payment.",
+    "type": "object",
+    "required": [
+        "$schema",
+        "version",
+        "type",
+        "id",
+        "revision",
+        "status",
+        "deedDid",
+        "topicTemplate",
+        "collectionConfiguration",
+        "submitAuthorizationPolicy",
+        "evaluationPolicy",
+        "disputePolicy",
+        "authoredBy",
+        "authoredAt"
+    ],
+    "properties": {
+        "$schema": { "type": "string", "minLength": 1 },
+        "version": { "const": 2 },
+        "type": { "const": "org.ixo.payment-terms" },
+        "id": { "type": "string", "pattern": "^urn:ixo:payment-terms:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "revision": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "status": { "enum": ["draft", "accepted", "superseded"] },
+        "deedDid": { "$ref": "#/$defs/did" },
+        "topicTemplate": { "$ref": "#/$defs/templateRef" },
+        "collectionConfiguration": { "$ref": "#/$defs/collectionConfiguration" },
+        "collectionBinding": { "$ref": "#/$defs/collectionBinding" },
+        "submitAuthorizationPolicy": { "$ref": "#/$defs/submitAuthorizationPolicy" },
+        "evaluationPolicy": { "$ref": "#/$defs/evaluationPolicy" },
+        "disputePolicy": { "$ref": "#/$defs/disputePolicy" },
+        "authoredBy": { "$ref": "#/$defs/did" },
+        "authoredAt": { "type": "string", "format": "date-time" },
+        "extensions": { "type": "object" }
+    },
+    "additionalProperties": false,
+    "allOf": [
+        {
+            "if": { "type": "object", "properties": { "status": { "const": "accepted" } }, "required": ["status"] },
+            "then": {
+                "type": "object",
+                "properties": { "collectionBinding": { "$ref": "#/$defs/collectionBinding" } },
+                "required": ["collectionBinding"]
+            }
+        },
+        {
+            "if": {
+                "type": "object",
+                "properties": {
+                    "collectionConfiguration": {
+                        "type": "object",
+                        "properties": { "intentPolicy": { "const": "REQUIRED" } },
+                        "required": ["intentPolicy"]
+                    }
+                },
+                "required": ["collectionConfiguration"]
+            },
+            "then": {
+                "type": "object",
+                "properties": {
+                    "submitAuthorizationPolicy": {
+                        "type": "object",
+                        "properties": { "intentDurationNs": { "not": { "const": "0" } } },
+                        "required": ["intentDurationNs"]
+                    }
+                }
+            }
+        }
+    ],
+    "$defs": {
+        "did": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "address": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "uint": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" },
+        "positiveUint": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+        "nativeAmount": {
+            "type": "object",
+            "required": ["denom", "amount"],
+            "properties": {
+                "denom": { "type": "string", "minLength": 1, "maxLength": 128 },
+                "amount": { "$ref": "#/$defs/positiveUint" }
+            },
+            "additionalProperties": false
+        },
+        "templateRef": {
+            "type": "object",
+            "required": ["id", "version", "ref", "digest"],
+            "properties": {
+                "id": { "const": "urn:ixo:decision-to-pay:template:verified-work-payment" },
+                "version": { "const": "0.2.0" },
+                "ref": { "type": "string", "format": "uri-reference" },
+                "digest": { "$ref": "#/$defs/digest" }
+            },
+            "additionalProperties": false
+        },
+        "paymentSlot": {
+            "type": "object",
+            "required": ["account", "native", "timeoutNs"],
+            "properties": {
+                "account": { "$ref": "#/$defs/address" },
+                "native": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/nativeAmount" } },
+                "timeoutNs": { "$ref": "#/$defs/uint" },
+                "isOraclePayment": { "type": "boolean" }
+            },
+            "additionalProperties": false
+        },
+        "payments": {
+            "type": "object",
+            "required": ["approval"],
+            "properties": {
+                "submission": { "$ref": "#/$defs/paymentSlot" },
+                "evaluation": { "$ref": "#/$defs/paymentSlot" },
+                "approval": { "$ref": "#/$defs/paymentSlot" },
+                "rejection": { "$ref": "#/$defs/paymentSlot" }
+            },
+            "additionalProperties": false
+        },
+        "depositRequirement": {
+            "type": "object",
+            "required": ["amount"],
+            "properties": {
+                "amount": { "$ref": "#/$defs/nativeAmount" }
+            },
+            "additionalProperties": false
+        },
+        "collectionConfiguration": {
+            "type": "object",
+            "required": [
+                "authority",
+                "entityDid",
+                "protocolDid",
+                "startsAt",
+                "endsAt",
+                "quota",
+                "state",
+                "intentPolicy",
+                "payments",
+                "serviceAgentDeposit",
+                "evaluationAgentDeposit",
+                "disputeDeposit",
+                "minDepositPeriodNs",
+                "adjudicatorDids"
+            ],
+            "properties": {
+                "authority": { "const": "ixo.claims.v1beta1.Collection" },
+                "entityDid": { "$ref": "#/$defs/did" },
+                "protocolDid": { "$ref": "#/$defs/did" },
+                "startsAt": { "type": "string", "format": "date-time" },
+                "endsAt": { "type": "string", "format": "date-time" },
+                "quota": { "$ref": "#/$defs/positiveUint" },
+                "state": { "const": "OPEN" },
+                "intentPolicy": { "enum": ["ALLOW", "DENY", "REQUIRED"] },
+                "payments": { "$ref": "#/$defs/payments" },
+                "serviceAgentDeposit": { "$ref": "#/$defs/depositRequirement" },
+                "evaluationAgentDeposit": { "$ref": "#/$defs/depositRequirement" },
+                "disputeDeposit": { "$ref": "#/$defs/nativeAmount" },
+                "minDepositPeriodNs": { "$ref": "#/$defs/uint" },
+                "adjudicatorDids": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": { "$ref": "#/$defs/did" }
+                }
+            },
+            "additionalProperties": false
+        },
+        "chainRef": {
+            "type": "object",
+            "required": ["txHash", "height"],
+            "properties": {
+                "txHash": { "type": "string", "pattern": "^[0-9A-Fa-f]{64}$" },
+                "height": { "$ref": "#/$defs/positiveUint" }
+            },
+            "additionalProperties": false
+        },
+        "collectionBinding": {
+            "type": "object",
+            "required": ["collectionId", "configurationDigest", "created"],
+            "properties": {
+                "collectionId": { "$ref": "#/$defs/positiveUint" },
+                "configurationDigest": { "$ref": "#/$defs/digest" },
+                "created": { "$ref": "#/$defs/chainRef" }
+            },
+            "additionalProperties": false
+        },
+        "submitAuthorizationPolicy": {
+            "type": "object",
+            "required": ["typeUrl", "agentQuota", "maxNativeAmount", "intentDurationNs", "expiresAt", "deriveGranteeFromAcceptedBid"],
+            "properties": {
+                "typeUrl": { "const": "/ixo.claims.v1beta1.SubmitClaimAuthorization" },
+                "agentQuota": { "$ref": "#/$defs/positiveUint" },
+                "maxNativeAmount": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/nativeAmount" } },
+                "intentDurationNs": { "$ref": "#/$defs/uint" },
+                "memberAddress": { "$ref": "#/$defs/address" },
+                "expiresAt": { "type": "string", "format": "date-time" },
+                "deriveGranteeFromAcceptedBid": { "const": true }
+            },
+            "additionalProperties": false
+        },
+        "evaluationPolicy": {
+            "type": "object",
+            "required": ["mode", "engineDid", "evaluatorDids", "allowedStatuses", "grantExpiresAt", "maxCustomNativeAmount", "humanOverrideRequiresNewReceipt"],
+            "properties": {
+                "mode": { "enum": ["HUMAN_SIGNED", "CAPPED_AUTOMATIC"] },
+                "engineDid": { "$ref": "#/$defs/did" },
+                "evaluatorDids": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/did" } },
+                "allowedStatuses": {
+                    "type": "array",
+                    "minItems": 4,
+                    "uniqueItems": true,
+                    "items": { "enum": ["APPROVED", "REJECTED", "FLAGGED", "INVALIDATED"] }
+                },
+                "grantExpiresAt": { "type": "string", "format": "date-time" },
+                "maxCustomNativeAmount": { "type": "array", "items": { "$ref": "#/$defs/nativeAmount" } },
+                "humanOverrideRequiresNewReceipt": { "const": true }
+            },
+            "additionalProperties": false
+        },
+        "disputePolicy": {
+            "type": "object",
+            "required": ["messageType", "targetRoles", "requiresRegisteredIid", "requiresDeposit", "adjudicationMessageType", "recourse"],
+            "properties": {
+                "messageType": { "const": "/ixo.claims.v1beta1.MsgDisputeClaim" },
+                "targetRoles": { "type": "array", "minItems": 2, "uniqueItems": true, "items": { "enum": ["SUBMITTER", "EVALUATOR"] } },
+                "requiresRegisteredIid": { "const": true },
+                "requiresDeposit": { "const": true },
+                "adjudicationMessageType": { "const": "/ixo.claims.v1beta1.MsgAdjudicateDispute" },
+                "recourse": { "const": "deposit_slashing_and_adjudication_not_payment_reversal" }
+            },
+            "additionalProperties": false
+        }
+    }
+}

package/dist/schemas/payment-terms.schema.json

@@ -0,0 +1,287 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/payment-terms.schema.json",
+    "title": "IXO Payment Terms resource v1",
+    "type": "object",
+    "required": [
+        "version",
+        "type",
+        "id",
+        "revision",
+        "status",
+        "payer",
+        "payee",
+        "asset",
+        "calculation",
+        "paymentCondition",
+        "timing",
+        "approvalPolicy",
+        "settlementPolicy",
+        "disputePolicy",
+        "capabilityRequirements",
+        "authoredBy",
+        "authoredAt"
+    ],
+    "properties": {
+        "$schema": { "type": "string", "minLength": 1 },
+        "version": { "const": 1 },
+        "type": { "const": "org.ixo.payment-terms" },
+        "id": { "type": "string", "pattern": "^urn:ixo:payment-terms:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "revision": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "status": { "enum": ["draft", "accepted", "superseded"] },
+        "payer": { "$ref": "#/$defs/payer" },
+        "payee": { "$ref": "#/$defs/payee" },
+        "asset": { "$ref": "#/$defs/asset" },
+        "calculation": {
+            "oneOf": [
+                { "$ref": "#/$defs/fixedCalculation" },
+                { "$ref": "#/$defs/formulaCalculation" },
+                { "$ref": "#/$defs/milestoneCalculation" },
+                { "$ref": "#/$defs/outcomeCalculation" }
+            ]
+        },
+        "paymentCondition": { "$ref": "#/$defs/paymentCondition" },
+        "timing": { "$ref": "#/$defs/timing" },
+        "partialPayments": { "$ref": "#/$defs/partialPayments" },
+        "approvalPolicy": { "$ref": "#/$defs/approvalPolicy" },
+        "settlementPolicy": { "$ref": "#/$defs/settlementPolicy" },
+        "disputePolicy": { "$ref": "#/$defs/disputePolicy" },
+        "capabilityRequirements": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#/$defs/capabilityRequirement" }
+        },
+        "authoredBy": { "$ref": "#/$defs/did" },
+        "authoredAt": { "type": "string", "format": "date-time" },
+        "extensions": { "type": "object" }
+    },
+    "additionalProperties": false,
+    "allOf": [
+        {
+            "if": {
+                "type": "object",
+                "properties": { "calculation": { "type": "object", "properties": { "model": { "const": "outcome" } }, "required": ["model"] } },
+                "required": ["calculation"]
+            },
+            "then": {
+                "properties": {
+                    "paymentCondition": {
+                        "type": "object",
+                        "properties": {
+                            "type": { "const": "outcome_supported" },
+                            "supportedEvaluationsRequired": { "type": "integer", "minimum": 1 }
+                        }
+                    }
+                }
+            }
+        }
+    ],
+    "$defs": {
+        "did": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "decimal": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" },
+        "policyRef": {
+            "type": "object",
+            "required": ["ref", "version", "digest"],
+            "properties": {
+                "ref": { "type": "string", "format": "uri" },
+                "version": { "type": "string", "minLength": 1 },
+                "digest": { "$ref": "#/$defs/digest" }
+            },
+            "additionalProperties": false
+        },
+        "payer": {
+            "type": "object",
+            "required": ["did"],
+            "properties": {
+                "did": { "$ref": "#/$defs/did" },
+                "label": { "type": "string", "minLength": 1, "maxLength": 280 }
+            },
+            "additionalProperties": false
+        },
+        "payee": {
+            "type": "object",
+            "required": ["did", "recipient"],
+            "properties": {
+                "did": { "$ref": "#/$defs/did" },
+                "recipient": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "label": { "type": "string", "minLength": 1, "maxLength": 280 }
+            },
+            "additionalProperties": false
+        },
+        "asset": {
+            "type": "object",
+            "required": ["id"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+                "decimals": { "type": "integer", "minimum": 0, "maximum": 30 }
+            },
+            "additionalProperties": false
+        },
+        "fixedCalculation": {
+            "type": "object",
+            "required": ["model", "amount"],
+            "properties": {
+                "model": { "const": "fixed" },
+                "amount": { "$ref": "#/$defs/decimal" }
+            },
+            "additionalProperties": false
+        },
+        "formulaCalculation": {
+            "type": "object",
+            "required": ["model", "formula"],
+            "properties": {
+                "model": { "const": "formula" },
+                "formula": { "$ref": "#/$defs/policyRef" },
+                "maximumAmount": { "$ref": "#/$defs/decimal" },
+                "requiredInputTypes": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": { "type": "string", "minLength": 1 }
+                }
+            },
+            "additionalProperties": false
+        },
+        "milestoneCalculation": {
+            "type": "object",
+            "required": ["model", "milestoneId", "amount"],
+            "properties": {
+                "model": { "const": "milestone" },
+                "milestoneId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "amount": { "$ref": "#/$defs/decimal" }
+            },
+            "additionalProperties": false
+        },
+        "outcomeCalculation": {
+            "type": "object",
+            "required": ["model", "rubric", "amountRule"],
+            "properties": {
+                "model": { "const": "outcome" },
+                "rubric": { "$ref": "#/$defs/policyRef" },
+                "amountRule": { "$ref": "#/$defs/policyRef" },
+                "maximumAmount": { "$ref": "#/$defs/decimal" }
+            },
+            "additionalProperties": false
+        },
+        "paymentCondition": {
+            "type": "object",
+            "required": ["type", "requiredEvidenceTypes", "deliveryDecisionRequired", "supportedEvaluationsRequired"],
+            "properties": {
+                "type": {
+                    "enum": ["delivery_accepted", "milestone_accepted", "outcome_supported", "obligation_approved"]
+                },
+                "requiredEvidenceTypes": {
+                    "type": "array",
+                    "uniqueItems": true,
+                    "items": { "type": "string", "minLength": 1 }
+                },
+                "deliveryDecisionRequired": { "type": "boolean" },
+                "supportedEvaluationsRequired": { "type": "integer", "minimum": 0, "maximum": 100 }
+            },
+            "additionalProperties": false
+        },
+        "timing": {
+            "type": "object",
+            "required": ["trigger"],
+            "properties": {
+                "trigger": { "enum": ["claim_approved", "fixed_date"] },
+                "dueWithin": { "type": "string", "pattern": "^P" },
+                "dueAt": { "type": "string", "format": "date-time" },
+                "timezone": { "type": "string", "minLength": 1 }
+            },
+            "additionalProperties": false,
+            "allOf": [
+                {
+                    "if": { "type": "object", "properties": { "trigger": { "const": "claim_approved" } }, "required": ["trigger"] },
+                    "then": { "properties": { "dueWithin": { "type": "string", "pattern": "^P" } }, "required": ["dueWithin"] }
+                },
+                {
+                    "if": { "type": "object", "properties": { "trigger": { "const": "fixed_date" } }, "required": ["trigger"] },
+                    "then": {
+                        "properties": {
+                            "dueAt": { "type": "string", "format": "date-time" },
+                            "timezone": { "type": "string", "minLength": 1 }
+                        },
+                        "required": ["dueAt", "timezone"]
+                    }
+                }
+            ]
+        },
+        "partialPayments": {
+            "type": "object",
+            "required": ["allowed"],
+            "properties": {
+                "allowed": { "type": "boolean" },
+                "minimumAmount": { "$ref": "#/$defs/decimal" },
+                "maximumInstallments": { "type": "integer", "minimum": 1, "maximum": 1000 }
+            },
+            "additionalProperties": false
+        },
+        "approvalPolicy": {
+            "type": "object",
+            "required": ["policy", "authorityDids", "requiredApprovals", "humanConfirmationRequired"],
+            "properties": {
+                "policy": { "$ref": "#/$defs/policyRef" },
+                "authorityDids": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": { "$ref": "#/$defs/did" }
+                },
+                "requiredApprovals": { "type": "integer", "minimum": 1, "maximum": 100 },
+                "humanConfirmationRequired": { "type": "boolean" }
+            },
+            "additionalProperties": false
+        },
+        "settlementPolicy": {
+            "type": "object",
+            "required": ["allowedPaymentRails", "fundingCheckRequired", "identityCheckRequired", "kycCheckRequired", "sanctionsCheckRequired", "humanConfirmationRequired"],
+            "properties": {
+                "allowedPaymentRails": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": { "type": "string", "minLength": 1, "maxLength": 128 }
+                },
+                "fundingCheckRequired": { "type": "boolean" },
+                "identityCheckRequired": { "type": "boolean" },
+                "kycCheckRequired": { "type": "boolean" },
+                "sanctionsCheckRequired": { "type": "boolean" },
+                "humanConfirmationRequired": { "type": "boolean" },
+                "humanConfirmationThreshold": { "$ref": "#/$defs/decimal" }
+            },
+            "additionalProperties": false
+        },
+        "disputePolicy": {
+            "type": "object",
+            "required": ["window", "authorityDids", "allowedRemedies"],
+            "properties": {
+                "window": { "type": "string", "pattern": "^P" },
+                "authorityDids": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": { "$ref": "#/$defs/did" }
+                },
+                "allowedRemedies": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": { "enum": ["withhold", "return_for_changes", "partial_payment", "refund", "recovery", "escalate"] }
+                }
+            },
+            "additionalProperties": false
+        },
+        "capabilityRequirement": {
+            "type": "object",
+            "required": ["action", "ability", "resource"],
+            "properties": {
+                "action": { "enum": ["submit_delivery", "accept_delivery", "evaluate", "approve", "record_claim", "record_settlement", "resolve_dispute"] },
+                "ability": { "type": "string", "minLength": 1 },
+                "resource": { "type": "string", "minLength": 1 }
+            },
+            "additionalProperties": false
+        }
+    }
+}

package/dist/schemas/topic-action-request.schema.json

@@ -0,0 +1,30 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/topic-action-request.schema.json",
+    "title": "Topic Action Request v1",
+    "type": "object",
+    "required": ["version", "requestId", "topicId", "topicRevision", "actionType", "actionContractDigest", "executor", "inputs", "requestedBy", "requestedAt", "idempotencyKey", "confirmation", "capability"],
+    "properties": {
+        "version": { "const": 1 },
+        "requestId": { "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}$" },
+        "topicRevision": { "type": "string", "minLength": 1 },
+        "actionType": { "type": "string", "pattern": "^qi/[a-z0-9]+(?:[._-][a-z0-9]+)*$" },
+        "actionContractDigest": { "$ref": "#/$defs/digest" },
+        "executor": { "enum": ["qi-flow", "qiforge", "mcp"] },
+        "inputs": {
+            "type": "object",
+            "required": ["digest"],
+            "properties": { "digest": { "$ref": "#/$defs/digest" }, "ref": { "type": "string", "minLength": 1 } },
+            "additionalProperties": false
+        },
+        "requestedBy": { "type": "string", "pattern": "^did:" },
+        "requestedAt": { "type": "string", "format": "date-time" },
+        "idempotencyKey": { "type": "string", "minLength": 1 },
+        "confirmation": { "enum": ["not-required", "required", "confirmed"] },
+        "flowBindingId": { "type": "string", "minLength": 1 },
+        "capability": { "type": "string", "minLength": 1 }
+    },
+    "additionalProperties": false,
+    "$defs": { "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

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

@@ -0,0 +1,66 @@
+{
+    "$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",
+    "type": "object",
+    "required": ["version", "revision", "status", "kindRef", "authoredBy", "authoredAt", "workingMode", "baseRecipe", "shapeSources", "shapeDigest"],
+    "properties": {
+        "version": { "const": 3 },
+        "revision": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["draft", "accepted", "superseded"] },
+        "kindRef": { "type": "object" },
+        "kindProfile": { "type": "object" },
+        "kindResource": { "type": "object" },
+        "authoredBy": { "type": "string", "minLength": 1 },
+        "authoredAt": { "type": "string", "format": "date-time" },
+        "workingMode": { "enum": ["solo", "team", "client"] },
+        "baseRecipe": { "enum": ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"] },
+        "topicRecipeRef": { "$ref": "#/$defs/digestRef" },
+        "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 },
+        "locale": { "type": "string" },
+        "timezone": { "type": "string" },
+        "temporalMode": { "enum": ["finite", "ongoing"] },
+        "tags": { "type": "array", "items": { "type": "string" } },
+        "appearance": { "type": "object" },
+        "intent": { "type": "object" },
+        "outcome": { "type": "object" },
+        "completion": { "type": "object" },
+        "ownerId": { "type": "string" },
+        "scope": { "type": "object" },
+        "constraints": { "type": "array", "items": { "type": "object" } },
+        "assumptions": { "type": "array", "items": { "type": "object" } },
+        "questions": { "type": "array", "items": { "type": "object" } },
+        "risks": { "type": "array", "items": { "$ref": "#/$defs/risk" } },
+        "participants": { "type": "array", "items": { "type": "object" } },
+        "roles": { "type": "array", "items": { "type": "object" } },
+        "decision": { "type": "object" },
+        "plan": { "type": "object" },
+        "attachments": { "type": "array", "items": { "type": "object" } },
+        "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 },
+        "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
+        }
+    }
+}