@ixo/topic-protocol 0.5.0 → 0.7.0

package/README.md

@@ -9,7 +9,7 @@ identity of a discussion.
 
 ## Status
 
-**Version:** 0.5.0
+**Version:** 0.7.0
 
 **Maturity:** Draft implementation candidate  
 **Execution source of truth:** [Linear Topic Protocol project](https://linear.app/ixo-world/project/topic-protocol-4ea58bc7910d)
@@ -23,6 +23,7 @@ and external action execution require their dedicated conformance evidence.
 
 - [Architecture decisions](docs/adr/README.md)
 - [Why Topics matter](docs/topics-feature-guide.md) — a non-technical feature guide
+- [Extending Topic Kinds](docs/extending-topic-kinds.md) — third-party custom Kind and Kind Profile guide
 - [Protocol chapters](docs/protocol/README.md)
 - [Machine-readable contracts](contracts/README.md)
 - [Reference implementation](docs/reference-implementation.md)
@@ -39,7 +40,8 @@ key-value adapter at its integration boundary.
 
 The package includes:
 
-- strict Draft 2020-12 validation for all 18 contracts;
+- strict Draft 2020-12 validation for all 29 contracts, including Kind Profiles, Job Cards, external work, delivery, evaluation, claims, and settlement receipts;
+- pinned, declarative Kind Profiles with safe standard-Kind fallback;
 - deterministic Topic-index reconciliation, structured search, and personal ranking;
 - deterministic Topic projection from a root and authorised operations;
 - singular accepted Overview projection with deterministic conflict handling;
@@ -48,6 +50,8 @@ The package includes:
 - restart-safe two-event Topic creation with duplicate suppression;
 - append-only Matrix operation parsing and room-upgrade anchor selection;
 - explicit conflict, duplicate-delivery, unauthorised, and unreachable handling;
+- governed external-work bindings and immutable Delivery Packet handoff with separate evaluation, approval, claim, and settlement axes;
+- fail-closed settlement projection that cannot promote tracker completion into approval or payment;
 - immutable caller inputs and typed protocol errors.
 
 Topics retain a singular conversational `kind` while linking any number of

package/dist/profiles/job-card/profile.json

@@ -0,0 +1,29 @@
+{
+    "version": 1,
+    "id": "https://topic-protocol.ixo.world/profiles/job-card",
+    "profileVersion": "1.0.0",
+    "label": "Job",
+    "description": "A portable digital job card coordinated through a Task-based Topic.",
+    "kind": {
+        "customId": "org.ixo.job-card",
+        "baseKind": "task",
+        "recipe": "project"
+    },
+    "resource": {
+        "type": "org.ixo.job-card",
+        "version": 1,
+        "schema": "https://topic-protocol.ixo.world/schemas/job-card.schema.json"
+    },
+    "acceptance": {
+        "requiredResourcePaths": ["/jobNumber", "/phase"]
+    },
+    "projection": {
+        "key": "org.ixo.topic-kind/job-card/v1",
+        "roomVisibleFields": ["/jobNumber", "/phase", "/priority", "/scheduled/start"]
+    },
+    "presentation": {
+        "fallbackLabel": "Job",
+        "primaryFields": ["/jobNumber", "/phase", "/priority", "/scheduled/start", "/site", "/asset"]
+    },
+    "capabilities": ["topic/write", "topic/change-status", "topic/confirm-completion"]
+}

package/dist/schemas/approval-decision.schema.json

@@ -0,0 +1,30 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/approval-decision.schema.json",
+    "title": "Outcome approval decision v1",
+    "type": "object",
+    "required": ["version", "approvalId", "topicId", "deliveryPacketId", "deliveryPacketDigest", "evaluationIds", "decision", "policy", "decidedBy", "decidedAt", "capability", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "approvalId": { "$ref": "#/$defs/uuidV7" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "deliveryPacketDigest": { "$ref": "#/$defs/digest" },
+        "evaluationIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/uuidV7" } },
+        "decision": { "enum": ["approved", "rejected", "changes_requested", "superseded"] },
+        "reasons": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1, "maxLength": 2000 } },
+        "policy": { "type": "object", "required": ["ref", "version", "digest"], "properties": { "ref": { "type": "string", "format": "uri" }, "version": { "type": "string", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false },
+        "decidedBy": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" } },
+        "decidedAt": { "type": "string", "format": "date-time" },
+        "capability": { "type": "string", "minLength": 1 },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "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}$" },
+        "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}$" }
+    },
+    "additionalProperties": false,
+    "allOf": [{ "if": { "properties": { "decision": { "enum": ["rejected", "changes_requested"] } }, "required": ["decision"] }, "then": { "properties": { "reasons": { "type": "array", "minItems": 1 } }, "required": ["reasons"] } }]
+}

package/dist/schemas/claim-record.schema.json

@@ -0,0 +1,30 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/claim-record.schema.json",
+    "title": "Outcome claim record v1",
+    "type": "object",
+    "required": ["version", "claimId", "topicId", "deliveryPacketId", "deliveryPacketDigest", "evaluationIds", "approvalId", "claimantDid", "requested", "status", "replayKey", "source", "recordedAt", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "claimId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "deliveryPacketDigest": { "$ref": "#/$defs/digest" },
+        "evaluationIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/uuidV7" } },
+        "approvalId": { "$ref": "#/$defs/uuidV7" },
+        "claimantDid": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "requested": { "type": "object", "required": ["amount", "asset", "recipient"], "properties": { "amount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "asset": { "type": "string", "minLength": 1, "maxLength": 128 }, "recipient": { "type": "string", "minLength": 1, "maxLength": 256 } }, "additionalProperties": false },
+        "status": { "enum": ["pending", "approved", "rejected", "disputed", "invalidated", "flagged"] },
+        "replayKey": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "source": { "type": "object", "required": ["provider", "ref"], "properties": { "provider": { "type": "string", "pattern": "^[a-z][a-z0-9.-]{0,63}$" }, "ref": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
+        "recordedAt": { "type": "string", "format": "date-time" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "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}$" },
+        "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}$" }
+    },
+    "additionalProperties": false
+}

package/dist/schemas/delivery-decision.schema.json

@@ -0,0 +1,28 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/delivery-decision.schema.json",
+    "title": "Delivery handoff decision v1",
+    "type": "object",
+    "required": ["version", "decisionId", "topicId", "deliveryPacketId", "deliveryPacketDigest", "decision", "decidedBy", "decidedAt", "capability", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "decisionId": { "$ref": "#/$defs/uuidV7" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "deliveryPacketDigest": { "$ref": "#/$defs/digest" },
+        "decision": { "enum": ["accepted", "returned", "rejected"] },
+        "reasons": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1, "maxLength": 2000 } },
+        "decidedBy": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "decidedAt": { "type": "string", "format": "date-time" },
+        "capability": { "type": "string", "minLength": 1 },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "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}$" },
+        "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}$" }
+    },
+    "additionalProperties": false,
+    "allOf": [{ "if": { "properties": { "decision": { "enum": ["returned", "rejected"] } }, "required": ["decision"] }, "then": { "properties": { "reasons": { "type": "array", "minItems": 1 } }, "required": ["reasons"] } }]
+}

package/dist/schemas/delivery-packet.schema.json

@@ -0,0 +1,58 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/delivery-packet.schema.json",
+    "title": "Delivery Packet v1",
+    "type": "object",
+    "required": ["version", "deliveryPacketId", "sequence", "topicId", "bindingId", "contract", "workItemSnapshot", "deliverables", "evidence", "traces", "submittedBy", "submittedAt", "capability", "status", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "sequence": { "type": "integer", "minimum": 1 },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "bindingId": { "$ref": "#/$defs/uuidV7" },
+        "supersedes": { "$ref": "#/$defs/uuidV7" },
+        "contract": {
+            "type": "object",
+            "required": ["revision", "digest", "status"],
+            "properties": {
+                "revision": { "type": "string", "minLength": 1 },
+                "digest": { "$ref": "#/$defs/digest" },
+                "status": { "const": "accepted" }
+            },
+            "additionalProperties": false
+        },
+        "workItemSnapshot": {
+            "type": "object",
+            "required": ["snapshotId", "ref", "digest"],
+            "properties": {
+                "snapshotId": { "$ref": "#/$defs/uuidV7" },
+                "ref": { "type": "string", "format": "uri" },
+                "digest": { "$ref": "#/$defs/digest" }
+            },
+            "additionalProperties": false
+        },
+        "deliverables": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/artifact" } },
+        "evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } },
+        "traces": { "type": "array", "items": { "$ref": "#/$defs/artifact" } },
+        "paymentTerms": {
+            "type": "object",
+            "required": ["ref", "digest"],
+            "properties": { "ref": { "type": "string", "format": "uri" }, "digest": { "$ref": "#/$defs/digest" } },
+            "additionalProperties": false
+        },
+        "submittedBy": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "submittedAt": { "type": "string", "format": "date-time" },
+        "capability": { "type": "string", "minLength": 1 },
+        "status": { "const": "submitted" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "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}$" },
+        "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}$" },
+        "artifact": { "type": "object", "required": ["type", "uri", "digest"], "properties": { "type": { "type": "string", "minLength": 1 }, "uri": { "type": "string", "format": "uri" }, "digest": { "$ref": "#/$defs/digest" }, "label": { "type": "string", "minLength": 1 }, "mediaType": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
+        "evidence": { "type": "object", "required": ["type", "uri", "digest", "provenanceClass"], "properties": { "type": { "type": "string", "minLength": 1 }, "uri": { "type": "string", "format": "uri" }, "digest": { "$ref": "#/$defs/digest" }, "provenanceClass": { "enum": ["claimant_provided", "client_assisted", "server_verified", "third_party_attested"] }, "label": { "type": "string", "minLength": 1 } }, "additionalProperties": false }
+    },
+    "additionalProperties": false
+}

package/dist/schemas/evaluation-assertion.schema.json

@@ -0,0 +1,37 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/evaluation-assertion.schema.json",
+    "title": "Evaluation assertion v1",
+    "type": "object",
+    "required": ["version", "evaluationId", "topicId", "deliveryPacketId", "deliveryPacketDigest", "rubric", "evidenceDigests", "traceDigests", "outcome", "result", "evaluatorDid", "evaluatedAt", "capability", "signature", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "evaluationId": { "$ref": "#/$defs/uuidV7" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "deliveryPacketDigest": { "$ref": "#/$defs/digest" },
+        "rubric": {
+            "type": "object",
+            "required": ["id", "version", "ref", "digest", "governanceStatus"],
+            "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 }, "ref": { "type": "string", "format": "uri" }, "digest": { "$ref": "#/$defs/digest" }, "governanceStatus": { "const": "approved" } },
+            "additionalProperties": false
+        },
+        "evidenceDigests": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/digest" } },
+        "traceDigests": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/digest" } },
+        "outcome": { "enum": ["supported", "refuted", "insufficient_evidence", "human_review", "disputed", "superseded"] },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "result": { "type": "object" },
+        "evaluatorDid": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "evaluatedAt": { "type": "string", "format": "date-time" },
+        "capability": { "type": "string", "minLength": 1 },
+        "signature": { "type": "object", "required": ["type", "verificationMethod", "value"], "properties": { "type": { "type": "string", "minLength": 1 }, "verificationMethod": { "type": "string", "format": "uri" }, "value": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "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}$" },
+        "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}$" }
+    },
+    "additionalProperties": false
+}

package/dist/schemas/external-work-binding.schema.json

@@ -0,0 +1,83 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/external-work-binding.schema.json",
+    "title": "External work binding v1",
+    "type": "object",
+    "required": ["version", "bindingId", "topicId", "role", "createdFrom", "external", "syncPolicy", "workState", "checkpoint", "identity", "health", "createdBy", "createdAt"],
+    "properties": {
+        "version": { "const": 1 },
+        "bindingId": { "$ref": "#/$defs/uuidV7" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "role": { "enum": ["primary", "child", "related", "verification", "delivery"] },
+        "createdFrom": { "enum": ["topic", "external"] },
+        "external": {
+            "type": "object",
+            "required": ["provider", "resourceType", "organizationId", "resourceId", "identifier", "url"],
+            "properties": {
+                "provider": { "type": "string", "pattern": "^[a-z][a-z0-9.-]{0,63}$" },
+                "resourceType": { "type": "string", "minLength": 1, "maxLength": 80 },
+                "organizationId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "teamId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "resourceId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "identifier": { "type": "string", "minLength": 1, "maxLength": 128 },
+                "url": { "type": "string", "format": "uri" }
+            },
+            "additionalProperties": false
+        },
+        "syncPolicy": {
+            "type": "object",
+            "required": ["mode", "direction", "comments", "files", "delete", "fieldPolicy"],
+            "properties": {
+                "mode": { "enum": ["link_only", "governed_projection"] },
+                "direction": { "enum": ["external_to_topic", "topic_to_external", "bidirectional"] },
+                "comments": { "enum": ["none", "explicit_promote"] },
+                "files": { "enum": ["none", "reference_only", "explicit_ingest"] },
+                "delete": { "const": "tombstone" },
+                "fieldPolicy": {
+                    "type": "object",
+                    "required": ["id", "version", "digest"],
+                    "properties": {
+                        "id": { "type": "string", "format": "uri" },
+                        "version": { "type": "integer", "minimum": 1 },
+                        "digest": { "$ref": "#/$defs/digest" }
+                    },
+                    "additionalProperties": false
+                }
+            },
+            "additionalProperties": false
+        },
+        "workState": { "enum": ["planned", "ready", "in_progress", "blocked", "handoff_ready", "handed_off", "cancelled"] },
+        "checkpoint": {
+            "type": "object",
+            "required": ["topicRevision", "syncedAt"],
+            "properties": {
+                "topicRevision": { "type": "string", "minLength": 1 },
+                "effectiveContractDigest": { "$ref": "#/$defs/digest" },
+                "externalUpdatedAt": { "type": "string", "format": "date-time" },
+                "externalSnapshotDigest": { "$ref": "#/$defs/digest" },
+                "lastEventId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "syncedAt": { "type": "string", "format": "date-time" }
+            },
+            "additionalProperties": false
+        },
+        "identity": {
+            "type": "object",
+            "required": ["bridgeDid"],
+            "properties": {
+                "bridgeDid": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+                "externalAppActorId": { "type": "string", "minLength": 1, "maxLength": 256 }
+            },
+            "additionalProperties": false
+        },
+        "health": { "enum": ["up_to_date", "changes_pending", "degraded", "disconnected", "conflicted", "permission_lost"] },
+        "createdBy": { "type": "string", "minLength": 1 },
+        "createdAt": { "type": "string", "format": "date-time" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "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}$" },
+        "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}$" }
+    },
+    "additionalProperties": false
+}

package/dist/schemas/external-work-state-map.schema.json

@@ -0,0 +1,29 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/external-work-state-map.schema.json",
+    "title": "External work state mapping profile v1",
+    "type": "object",
+    "required": ["version", "profileId", "provider", "organizationId", "teamId", "mappings"],
+    "properties": {
+        "version": { "const": 1 },
+        "profileId": { "type": "string", "format": "uri" },
+        "provider": { "type": "string", "pattern": "^[a-z][a-z0-9.-]{0,63}$" },
+        "organizationId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "teamId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "mappings": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+                "type": "object",
+                "required": ["workflowStateId", "category", "workState"],
+                "properties": {
+                    "workflowStateId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                    "category": { "enum": ["triage", "backlog", "unstarted", "started", "completed", "canceled"] },
+                    "workState": { "enum": ["planned", "ready", "in_progress", "blocked", "handoff_ready", "handed_off", "cancelled"] }
+                },
+                "additionalProperties": false
+            }
+        }
+    },
+    "additionalProperties": false
+}

package/dist/schemas/job-card.schema.json

@@ -0,0 +1,46 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/job-card.schema.json",
+    "title": "IXO Job Card resource v1",
+    "type": "object",
+    "required": ["version", "type", "id"],
+    "properties": {
+        "version": { "const": 1 },
+        "type": { "const": "org.ixo.job-card" },
+        "id": { "type": "string", "pattern": "^urn:ixo:job:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "jobNumber": { "type": "string", "minLength": 1, "maxLength": 80 },
+        "phase": { "type": "string", "enum": ["requested", "scheduled", "dispatched", "in_progress", "ready_for_review", "completed", "cancelled"] },
+        "priority": { "type": "string", "enum": ["low", "normal", "high", "urgent"] },
+        "instructions": { "type": "string", "minLength": 1, "maxLength": 10000 },
+        "scheduled": {
+            "type": "object",
+            "properties": {
+                "start": { "$ref": "https://topic-protocol.ixo.world/schemas/topic-contract-state.schema.json#/$defs/temporalTarget" },
+                "end": { "$ref": "https://topic-protocol.ixo.world/schemas/topic-contract-state.schema.json#/$defs/temporalTarget" }
+            },
+            "additionalProperties": false
+        },
+        "site": { "$ref": "#/$defs/resourceTarget" },
+        "asset": { "$ref": "#/$defs/resourceTarget" },
+        "requestedBy": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "assignedTo": {
+            "type": "array",
+            "uniqueItems": true,
+            "maxItems": 100,
+            "items": { "type": "string", "minLength": 1, "maxLength": 256 }
+        },
+        "extensions": { "type": "object" }
+    },
+    "additionalProperties": false,
+    "$defs": {
+        "resourceTarget": {
+            "type": "object",
+            "required": ["label"],
+            "properties": {
+                "label": { "type": "string", "minLength": 1, "maxLength": 280 },
+                "id": { "type": "string", "minLength": 1, "maxLength": 512 }
+            },
+            "additionalProperties": false
+        }
+    }
+}

package/dist/schemas/settlement-receipt.schema.json

@@ -0,0 +1,53 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/settlement-receipt.schema.json",
+    "title": "Settlement receipt v1",
+    "type": "object",
+    "required": ["version", "settlementId", "topicId", "claimId", "deliveryPacketId", "deliveryPacketDigest", "evaluationIds", "approvalId", "policy", "idempotencyKey", "amount", "asset", "recipient", "paymentRail", "state", "finality", "signerDid", "recordedAt", "capability", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "settlementId": { "$ref": "#/$defs/uuidV7" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "claimId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "deliveryPacketDigest": { "$ref": "#/$defs/digest" },
+        "evaluationIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/uuidV7" } },
+        "approvalId": { "$ref": "#/$defs/uuidV7" },
+        "policy": { "type": "object", "required": ["ref", "digest"], "properties": { "ref": { "type": "string", "format": "uri" }, "digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false },
+        "idempotencyKey": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "amount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" },
+        "asset": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "recipient": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "paymentRail": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "transactionReference": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "state": { "enum": ["unfunded", "funded", "held", "authorised", "submitted", "confirmed", "failed", "refunded"] },
+        "finality": { "type": "object", "required": ["state"], "properties": { "state": { "enum": ["pending", "confirmed", "failed"] }, "confirmations": { "type": "integer", "minimum": 0 }, "confirmedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false },
+        "signerDid": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "recordedAt": { "type": "string", "format": "date-time" },
+        "capability": { "type": "string", "minLength": 1 },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "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}$" },
+        "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}$" }
+    },
+    "additionalProperties": false,
+    "allOf": [
+        {
+            "if": { "properties": { "state": { "const": "confirmed" } }, "required": ["state"] },
+            "then": {
+                "required": ["transactionReference"],
+                "properties": {
+                    "transactionReference": { "type": "string", "minLength": 1, "maxLength": 512 },
+                    "finality": {
+                        "type": "object",
+                        "properties": { "state": { "const": "confirmed" }, "confirmedAt": { "type": "string", "format": "date-time" } },
+                        "required": ["state", "confirmedAt"]
+                    }
+                }
+            }
+        }
+    ]
+}

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

@@ -47,6 +47,29 @@
                 }
             ]
         },
+        "kindProfileRef": {
+            "type": "object",
+            "required": ["id", "version", "schema", "digest"],
+            "properties": {
+                "id": { "type": "string", "format": "uri" },
+                "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+                "schema": { "type": "string", "format": "uri" },
+                "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+            },
+            "additionalProperties": false
+        },
+        "kindResource": {
+            "type": "object",
+            "required": ["profile", "type", "id", "version", "value"],
+            "properties": {
+                "profile": { "$ref": "#/$defs/kindProfileRef" },
+                "type": { "type": "string", "minLength": 1, "maxLength": 128 },
+                "id": { "type": "string", "minLength": 1, "maxLength": 512 },
+                "version": { "type": "integer", "minimum": 1 },
+                "value": { "type": "object" }
+            },
+            "additionalProperties": false
+        },
         "anchor": {
             "oneOf": [
                 {
@@ -189,6 +212,8 @@
                 "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"] },
@@ -253,6 +278,7 @@
                 "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 }

package/dist/schemas/topic-kind-profile.schema.json

@@ -0,0 +1,82 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/topic-kind-profile.schema.json",
+    "title": "Topic Kind Profile v1",
+    "type": "object",
+    "required": ["version", "id", "profileVersion", "label", "kind", "resource", "acceptance", "projection", "presentation"],
+    "properties": {
+        "version": { "const": 1 },
+        "id": { "type": "string", "format": "uri" },
+        "profileVersion": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+        "label": { "type": "string", "minLength": 1, "maxLength": 80 },
+        "description": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "kind": {
+            "type": "object",
+            "required": ["customId", "baseKind", "recipe"],
+            "properties": {
+                "customId": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)+$", "maxLength": 128 },
+                "baseKind": { "type": "string", "enum": ["task", "agent_task", "proposal", "evaluation", "claims", "question", "discussion", "incident"] },
+                "recipe": { "type": "string", "enum": ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"] }
+            },
+            "additionalProperties": false
+        },
+        "resource": {
+            "type": "object",
+            "required": ["type", "version", "schema"],
+            "properties": {
+                "type": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)+$", "maxLength": 128 },
+                "version": { "type": "integer", "minimum": 1 },
+                "schema": { "type": "string", "format": "uri" }
+            },
+            "additionalProperties": false
+        },
+        "acceptance": {
+            "type": "object",
+            "required": ["requiredResourcePaths"],
+            "properties": {
+                "requiredResourcePaths": {
+                    "type": "array",
+                    "uniqueItems": true,
+                    "maxItems": 50,
+                    "items": { "type": "string", "pattern": "^/" }
+                }
+            },
+            "additionalProperties": false
+        },
+        "projection": {
+            "type": "object",
+            "required": ["key", "roomVisibleFields"],
+            "properties": {
+                "key": { "type": "string", "pattern": "^[a-z0-9]+(?:[._/-][a-z0-9]+)+$", "maxLength": 160 },
+                "roomVisibleFields": {
+                    "type": "array",
+                    "uniqueItems": true,
+                    "maxItems": 20,
+                    "items": { "type": "string", "pattern": "^/" }
+                }
+            },
+            "additionalProperties": false
+        },
+        "presentation": {
+            "type": "object",
+            "required": ["fallbackLabel", "primaryFields"],
+            "properties": {
+                "fallbackLabel": { "type": "string", "minLength": 1, "maxLength": 80 },
+                "primaryFields": {
+                    "type": "array",
+                    "uniqueItems": true,
+                    "maxItems": 20,
+                    "items": { "type": "string", "pattern": "^/" }
+                }
+            },
+            "additionalProperties": false
+        },
+        "capabilities": {
+            "type": "array",
+            "uniqueItems": true,
+            "maxItems": 20,
+            "items": { "type": "string", "minLength": 1, "maxLength": 128 }
+        }
+    },
+    "additionalProperties": false
+}