@ixo/topic-protocol 0.5.0 → 0.6.0

package/README.md

@@ -9,7 +9,7 @@ identity of a discussion.
 
 ## Status
 
-**Version:** 0.5.0
+**Version:** 0.6.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 20 contracts, including Kind Profiles and Job Cards;
+- 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;

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/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/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
+}

package/dist/src/contracts/schemas.d.ts

@@ -128,6 +128,99 @@ export declare const SCHEMA_REGISTRY: Readonly<{
         };
         additionalProperties: boolean;
     };
+    "job-card": {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            version: {
+                const: number;
+            };
+            type: {
+                const: string;
+            };
+            id: {
+                type: string;
+                pattern: string;
+            };
+            jobNumber: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+            };
+            phase: {
+                type: string;
+                enum: string[];
+            };
+            priority: {
+                type: string;
+                enum: string[];
+            };
+            instructions: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+            };
+            scheduled: {
+                type: string;
+                properties: {
+                    start: {
+                        $ref: string;
+                    };
+                    end: {
+                        $ref: string;
+                    };
+                };
+                additionalProperties: boolean;
+            };
+            site: {
+                $ref: string;
+            };
+            asset: {
+                $ref: string;
+            };
+            requestedBy: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+            };
+            assignedTo: {
+                type: string;
+                uniqueItems: boolean;
+                maxItems: number;
+                items: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                };
+            };
+            extensions: {
+                type: string;
+            };
+        };
+        additionalProperties: boolean;
+        $defs: {
+            resourceTarget: {
+                type: string;
+                required: string[];
+                properties: {
+                    label: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    id: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                };
+                additionalProperties: boolean;
+            };
+        };
+    };
     "room-policy": {
         $schema: string;
         $id: string;
@@ -338,6 +431,56 @@ export declare const SCHEMA_REGISTRY: Readonly<{
                     additionalProperties: boolean;
                 })[];
             };
+            kindProfileRef: {
+                type: string;
+                required: string[];
+                properties: {
+                    id: {
+                        type: string;
+                        format: string;
+                    };
+                    version: {
+                        type: string;
+                        pattern: string;
+                    };
+                    schema: {
+                        type: string;
+                        format: string;
+                    };
+                    digest: {
+                        type: string;
+                        pattern: string;
+                    };
+                };
+                additionalProperties: boolean;
+            };
+            kindResource: {
+                type: string;
+                required: string[];
+                properties: {
+                    profile: {
+                        $ref: string;
+                    };
+                    type: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    id: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    version: {
+                        type: string;
+                        minimum: number;
+                    };
+                    value: {
+                        type: string;
+                    };
+                };
+                additionalProperties: boolean;
+            };
             anchor: {
                 oneOf: {
                     type: string;
@@ -603,6 +746,12 @@ export declare const SCHEMA_REGISTRY: Readonly<{
                     kindRef: {
                         $ref: string;
                     };
+                    kindProfile: {
+                        $ref: string;
+                    };
+                    kindResource: {
+                        $ref: string;
+                    };
                     authoredBy: {
                         type: string;
                         minLength: number;
@@ -806,6 +955,9 @@ export declare const SCHEMA_REGISTRY: Readonly<{
                     kindRef: {
                         $ref: string;
                     };
+                    kindProfile: {
+                        $ref: string;
+                    };
                     appearance: {
                         $ref: string;
                     };
@@ -1148,6 +1300,145 @@ export declare const SCHEMA_REGISTRY: Readonly<{
         };
         additionalProperties: boolean;
     };
+    "topic-kind-profile": {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            version: {
+                const: number;
+            };
+            id: {
+                type: string;
+                format: string;
+            };
+            profileVersion: {
+                type: string;
+                pattern: string;
+            };
+            label: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+            };
+            description: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+            };
+            kind: {
+                type: string;
+                required: string[];
+                properties: {
+                    customId: {
+                        type: string;
+                        pattern: string;
+                        maxLength: number;
+                    };
+                    baseKind: {
+                        type: string;
+                        enum: string[];
+                    };
+                    recipe: {
+                        type: string;
+                        enum: string[];
+                    };
+                };
+                additionalProperties: boolean;
+            };
+            resource: {
+                type: string;
+                required: string[];
+                properties: {
+                    type: {
+                        type: string;
+                        pattern: string;
+                        maxLength: number;
+                    };
+                    version: {
+                        type: string;
+                        minimum: number;
+                    };
+                    schema: {
+                        type: string;
+                        format: string;
+                    };
+                };
+                additionalProperties: boolean;
+            };
+            acceptance: {
+                type: string;
+                required: string[];
+                properties: {
+                    requiredResourcePaths: {
+                        type: string;
+                        uniqueItems: boolean;
+                        maxItems: number;
+                        items: {
+                            type: string;
+                            pattern: string;
+                        };
+                    };
+                };
+                additionalProperties: boolean;
+            };
+            projection: {
+                type: string;
+                required: string[];
+                properties: {
+                    key: {
+                        type: string;
+                        pattern: string;
+                        maxLength: number;
+                    };
+                    roomVisibleFields: {
+                        type: string;
+                        uniqueItems: boolean;
+                        maxItems: number;
+                        items: {
+                            type: string;
+                            pattern: string;
+                        };
+                    };
+                };
+                additionalProperties: boolean;
+            };
+            presentation: {
+                type: string;
+                required: string[];
+                properties: {
+                    fallbackLabel: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    primaryFields: {
+                        type: string;
+                        uniqueItems: boolean;
+                        maxItems: number;
+                        items: {
+                            type: string;
+                            pattern: string;
+                        };
+                    };
+                };
+                additionalProperties: boolean;
+            };
+            capabilities: {
+                type: string;
+                uniqueItems: boolean;
+                maxItems: number;
+                items: {
+                    type: string;
+                    minLength: number;
+                    maxLength: number;
+                };
+            };
+        };
+        additionalProperties: boolean;
+    };
     "topic-message": {
         $schema: string;
         $id: string;
@@ -1779,4 +2070,4 @@ export declare const SCHEMA_REGISTRY: Readonly<{
     };
 }>;
 export type ContractName = keyof typeof SCHEMA_REGISTRY;
-export declare const CONTRACT_NAMES: readonly ("action-receipt" | "agent-run" | "external-session-binding" | "room-policy" | "topic-capsule" | "topic-contract-state" | "topic-file-attachment" | "topic-index-entry" | "topic-index" | "topic-message" | "topic-operation" | "topic-preferences" | "topic-record" | "topic-record-message" | "topic-relation" | "topic-root" | "topic-state" | "topic-source-message")[];
+export declare const CONTRACT_NAMES: readonly ("action-receipt" | "agent-run" | "external-session-binding" | "job-card" | "room-policy" | "topic-capsule" | "topic-contract-state" | "topic-file-attachment" | "topic-index-entry" | "topic-index" | "topic-kind-profile" | "topic-message" | "topic-operation" | "topic-preferences" | "topic-record" | "topic-record-message" | "topic-relation" | "topic-root" | "topic-state" | "topic-source-message")[];

package/dist/src/contracts/schemas.js

@@ -1,12 +1,14 @@
 import actionReceipt from "../../schemas/action-receipt.schema.json" with { type: "json" };
 import agentRun from "../../schemas/agent-run.schema.json" with { type: "json" };
 import externalSessionBinding from "../../schemas/external-session-binding.schema.json" with { type: "json" };
+import jobCard from "../../schemas/job-card.schema.json" with { type: "json" };
 import roomPolicy from "../../schemas/room-policy.schema.json" with { type: "json" };
 import topicCapsule from "../../schemas/topic-capsule.schema.json" with { type: "json" };
 import topicContractState from "../../schemas/topic-contract-state.schema.json" with { type: "json" };
 import topicFileAttachment from "../../schemas/topic-file-attachment.schema.json" with { type: "json" };
 import topicIndexEntry from "../../schemas/topic-index-entry.schema.json" with { type: "json" };
 import topicIndex from "../../schemas/topic-index.schema.json" with { type: "json" };
+import topicKindProfile from "../../schemas/topic-kind-profile.schema.json" with { type: "json" };
 import topicMessage from "../../schemas/topic-message.schema.json" with { type: "json" };
 import topicOperation from "../../schemas/topic-operation.schema.json" with { type: "json" };
 import topicPreferences from "../../schemas/topic-preferences.schema.json" with { type: "json" };
@@ -20,12 +22,14 @@ export const SCHEMA_REGISTRY = Object.freeze({
     "action-receipt": actionReceipt,
     "agent-run": agentRun,
     "external-session-binding": externalSessionBinding,
+    "job-card": jobCard,
     "room-policy": roomPolicy,
     "topic-capsule": topicCapsule,
     "topic-contract-state": topicContractState,
     "topic-file-attachment": topicFileAttachment,
     "topic-index-entry": topicIndexEntry,
     "topic-index": topicIndex,
+    "topic-kind-profile": topicKindProfile,
     "topic-message": topicMessage,
     "topic-operation": topicOperation,
     "topic-preferences": topicPreferences,

package/dist/src/contracts/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/contracts/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,QAAQ,MAAM,qCAAqC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjF,OAAO,sBAAsB,MAAM,oDAAoD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9G,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtG,OAAO,mBAAmB,MAAM,iDAAiD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxG,OAAO,eAAe,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAChG,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,cAAc,MAAM,2CAA2C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC7F,OAAO,gBAAgB,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjG,OAAO,WAAW,MAAM,wCAAwC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACvF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtG,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,SAAS,MAAM,sCAAsC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnF,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEtG,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,gBAAgB,EAAE,aAAa;IAC/B,WAAW,EAAE,QAAQ;IACrB,0BAA0B,EAAE,sBAAsB;IAClD,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,YAAY;IAC7B,sBAAsB,EAAE,kBAAkB;IAC1C,uBAAuB,EAAE,mBAAmB;IAC5C,mBAAmB,EAAE,eAAe;IACpC,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,YAAY;IAC7B,iBAAiB,EAAE,cAAc;IACjC,mBAAmB,EAAE,gBAAgB;IACrC,cAAc,EAAE,WAAW;IAC3B,sBAAsB,EAAE,kBAAkB;IAC1C,gBAAgB,EAAE,aAAa;IAC/B,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,UAAU;IACzB,sBAAsB,EAAE,kBAAkB;CAC3C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CACzC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,EAAoB,CACtD,CAAC"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/contracts/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,QAAQ,MAAM,qCAAqC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjF,OAAO,sBAAsB,MAAM,oDAAoD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9G,OAAO,OAAO,MAAM,oCAAoC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC/E,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtG,OAAO,mBAAmB,MAAM,iDAAiD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxG,OAAO,eAAe,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAChG,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,gBAAgB,MAAM,8CAA8C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAClG,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,cAAc,MAAM,2CAA2C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC7F,OAAO,gBAAgB,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjG,OAAO,WAAW,MAAM,wCAAwC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACvF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtG,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,SAAS,MAAM,sCAAsC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnF,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEtG,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,gBAAgB,EAAE,aAAa;IAC/B,WAAW,EAAE,QAAQ;IACrB,0BAA0B,EAAE,sBAAsB;IAClD,UAAU,EAAE,OAAO;IACnB,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,YAAY;IAC7B,sBAAsB,EAAE,kBAAkB;IAC1C,uBAAuB,EAAE,mBAAmB;IAC5C,mBAAmB,EAAE,eAAe;IACpC,aAAa,EAAE,UAAU;IACzB,oBAAoB,EAAE,gBAAgB;IACtC,eAAe,EAAE,YAAY;IAC7B,iBAAiB,EAAE,cAAc;IACjC,mBAAmB,EAAE,gBAAgB;IACrC,cAAc,EAAE,WAAW;IAC3B,sBAAsB,EAAE,kBAAkB;IAC1C,gBAAgB,EAAE,aAAa;IAC/B,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,UAAU;IACzB,sBAAsB,EAAE,kBAAkB;CAC3C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CACzC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,EAAoB,CACtD,CAAC"}

package/dist/src/contracts/topic-contract.d.ts

@@ -1,3 +1,4 @@
+import type { TopicKindProfileRef, TopicKindResourceBinding } from "./topic-kind-profile.js";
 export declare const PERSISTED_TOPIC_KINDS: readonly ["task", "agent_task", "proposal", "evaluation", "claims", "question", "discussion", "incident"];
 export declare const TOPIC_CONTRACT_RECIPES: readonly ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"];
 export type PersistedTopicKind = (typeof PERSISTED_TOPIC_KINDS)[number];
@@ -71,6 +72,8 @@ export interface TopicContractBodyV2 {
     readonly revision: string;
     readonly status: "draft" | "accepted" | "superseded";
     readonly kindRef: TopicKindRef;
+    readonly kindProfile?: TopicKindProfileRef;
+    readonly kindResource?: TopicKindResourceBinding;
     readonly authoredBy: string;
     readonly authoredAt: string;
     readonly workingMode: "solo" | "team" | "client";

package/dist/src/contracts/topic-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"topic-contract.js","sourceRoot":"","sources":["../../../src/contracts/topic-contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"topic-contract.js","sourceRoot":"","sources":["../../../src/contracts/topic-contract.ts"],"names":[],"mappings":"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"}

package/dist/src/contracts/topic-kind-profile.d.ts

@@ -0,0 +1,81 @@
+import { type TemporalTarget, type TopicContractBodyV2, type TopicContractCompletenessIssue, type TopicContractRecipe, type PersistedTopicKind } from "./topic-contract.js";
+export interface TopicKindProfileRef {
+    readonly id: string;
+    readonly version: string;
+    readonly schema: string;
+    readonly digest: `sha256:${string}`;
+}
+export interface TopicKindProfileV1 {
+    readonly version: 1;
+    readonly id: string;
+    readonly profileVersion: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly kind: {
+        readonly customId: string;
+        readonly baseKind: PersistedTopicKind;
+        readonly recipe: TopicContractRecipe;
+    };
+    readonly resource: {
+        readonly type: string;
+        readonly version: number;
+        readonly schema: string;
+    };
+    readonly acceptance: {
+        readonly requiredResourcePaths: readonly string[];
+    };
+    readonly projection: {
+        readonly key: string;
+        readonly roomVisibleFields: readonly string[];
+    };
+    readonly presentation: {
+        readonly fallbackLabel: string;
+        readonly primaryFields: readonly string[];
+    };
+    readonly capabilities?: readonly string[];
+}
+export interface TopicKindResourceBinding<TValue extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>> {
+    readonly profile: TopicKindProfileRef;
+    readonly type: string;
+    readonly id: string;
+    readonly version: number;
+    readonly value: TValue;
+}
+export declare const JOB_CARD_PHASES: readonly ["requested", "scheduled", "dispatched", "in_progress", "ready_for_review", "completed", "cancelled"];
+export declare const JOB_CARD_PRIORITIES: readonly ["low", "normal", "high", "urgent"];
+export type JobCardPhase = (typeof JOB_CARD_PHASES)[number];
+export type JobCardPriority = (typeof JOB_CARD_PRIORITIES)[number];
+export interface JobCardV1 extends Readonly<Record<string, unknown>> {
+    readonly version: 1;
+    readonly type: "org.ixo.job-card";
+    readonly id: string;
+    readonly jobNumber?: string;
+    readonly phase?: JobCardPhase;
+    readonly priority?: JobCardPriority;
+    readonly instructions?: string;
+    readonly scheduled?: {
+        readonly start?: TemporalTarget;
+        readonly end?: TemporalTarget;
+    };
+    readonly site?: {
+        readonly label: string;
+        readonly id?: string;
+    };
+    readonly asset?: {
+        readonly label: string;
+        readonly id?: string;
+    };
+    readonly requestedBy?: string;
+    readonly assignedTo?: readonly string[];
+    readonly extensions?: Readonly<Record<string, unknown>>;
+}
+export declare const JOB_CARD_KIND_REF: Readonly<{
+    readonly source: "custom";
+    readonly customId: "org.ixo.job-card";
+    readonly label: "Job";
+    readonly baseKind: "task";
+}>;
+export declare const JOB_CARD_KIND_PROFILE: TopicKindProfileV1;
+export declare const JOB_CARD_KIND_PROFILE_REF: TopicKindProfileRef;
+export declare function resolveTopicKindProfile(ref: TopicKindProfileRef): TopicKindProfileV1 | undefined;
+export declare function contractCompletenessWithProfiles(body: TopicContractBodyV2): readonly TopicContractCompletenessIssue[];

package/dist/src/contracts/topic-kind-profile.js

@@ -0,0 +1,76 @@
+import jobCardKindProfile from "../../profiles/job-card/profile.json" with { type: "json" };
+import { contractCompleteness } from "./topic-contract.js";
+import { validateContract } from "./validator.js";
+export const JOB_CARD_PHASES = [
+    "requested",
+    "scheduled",
+    "dispatched",
+    "in_progress",
+    "ready_for_review",
+    "completed",
+    "cancelled",
+];
+export const JOB_CARD_PRIORITIES = ["low", "normal", "high", "urgent"];
+export const JOB_CARD_KIND_REF = Object.freeze({
+    source: "custom",
+    customId: "org.ixo.job-card",
+    label: "Job",
+    baseKind: "task",
+});
+export const JOB_CARD_KIND_PROFILE = Object.freeze(jobCardKindProfile);
+export const JOB_CARD_KIND_PROFILE_REF = Object.freeze({
+    id: JOB_CARD_KIND_PROFILE.id,
+    version: JOB_CARD_KIND_PROFILE.profileVersion,
+    schema: "https://topic-protocol.ixo.world/schemas/topic-kind-profile.schema.json",
+    digest: "sha256:0991eb565e1253c5caf92e7f06a392edacda6d9d90c3b3111ebfa6bf65b8eaf5",
+});
+function sameProfileRef(left, right) {
+    return left.id === right.id
+        && left.version === right.version
+        && left.schema === right.schema
+        && left.digest === right.digest;
+}
+export function resolveTopicKindProfile(ref) {
+    return sameProfileRef(ref, JOB_CARD_KIND_PROFILE_REF) ? JOB_CARD_KIND_PROFILE : undefined;
+}
+function jobCardIssues(body) {
+    if (body.kindRef.source !== "custom" || body.kindRef.customId !== JOB_CARD_KIND_REF.customId)
+        return [];
+    if (body.status !== "accepted")
+        return [];
+    const binding = body.kindResource;
+    if (binding === undefined) {
+        return [{ path: "/kindResource", message: "Accepted Job contracts require a Job Card resource" }];
+    }
+    const issues = [];
+    if (body.kindProfile === undefined || !sameProfileRef(body.kindProfile, JOB_CARD_KIND_PROFILE_REF)) {
+        issues.push({ path: "/kindProfile", message: "Job contracts require the supported pinned Job Kind Profile" });
+    }
+    if (!sameProfileRef(binding.profile, JOB_CARD_KIND_PROFILE_REF)) {
+        issues.push({ path: "/kindResource/profile", message: "Job Card resource must use the pinned Job Kind Profile" });
+    }
+    if (binding.type !== JOB_CARD_KIND_PROFILE.resource.type || binding.version !== JOB_CARD_KIND_PROFILE.resource.version) {
+        issues.push({ path: "/kindResource", message: "Job Card resource type and version must match its Kind Profile" });
+    }
+    const value = binding.value;
+    if (value.id !== binding.id) {
+        issues.push({ path: "/kindResource/value/id", message: "Job Card binding and resource identifiers must match" });
+    }
+    const validation = validateContract("job-card", value);
+    if (!validation.ok) {
+        for (const error of validation.errors) {
+            issues.push({ path: `/kindResource/value${error.instancePath === "/" ? "" : error.instancePath}`, message: error.message });
+        }
+    }
+    if (!value.jobNumber?.trim()) {
+        issues.push({ path: "/kindResource/value/jobNumber", message: "Accepted Job contracts require a job number" });
+    }
+    if (value.phase === undefined) {
+        issues.push({ path: "/kindResource/value/phase", message: "Accepted Job contracts require a job phase" });
+    }
+    return issues;
+}
+export function contractCompletenessWithProfiles(body) {
+    return [...contractCompleteness(body), ...jobCardIssues(body)];
+}
+//# sourceMappingURL=topic-kind-profile.js.map

package/dist/src/contracts/topic-kind-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-kind-profile.js","sourceRoot":"","sources":["../../../src/contracts/topic-kind-profile.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -1,6 +1,7 @@
 export { CONTRACT_NAMES, type ContractName, } from "./contracts/schemas.js";
 export { assertContract, validateContract, type ContractValidationError, type ContractValidationResult, } from "./contracts/validator.js";
 export { PERSISTED_TOPIC_KINDS, TOPIC_CONTRACT_RECIPES, assertContractComplete, baseTopicKind, contractCompleteness, topicRecipeForKind, type PersistedTopicKind, type TemporalTarget, type TopicAppearance, type TopicAutomationBindingV2, type TopicContractBodyV2, type TopicContractCompletenessIssue, type TopicContractRecipe, type TopicIconName, type TopicKindRef, type TopicRecurrence, type TopicReminder, type TopicRiskV2, type TopicStatementV2, type TopicUserSettings, type Weekday, } from "./contracts/topic-contract.js";
+export { JOB_CARD_KIND_PROFILE, JOB_CARD_KIND_PROFILE_REF, JOB_CARD_KIND_REF, JOB_CARD_PHASES, JOB_CARD_PRIORITIES, contractCompletenessWithProfiles, resolveTopicKindProfile, type JobCardPhase, type JobCardPriority, type JobCardV1, type TopicKindProfileRef, type TopicKindProfileV1, type TopicKindResourceBinding, } from "./contracts/topic-kind-profile.js";
 export { TopicProtocolError, type TopicProtocolErrorCode, } from "./errors.js";
 export { projectTopic } from "./projector/project.js";
 export { adoptedTopicAnchor, nativeTopicAnchor, selectCanonicalTopicAnchor } from "./matrix/anchors.js";

package/dist/src/index.js

@@ -1,6 +1,7 @@
 export { CONTRACT_NAMES, } from "./contracts/schemas.js";
 export { assertContract, validateContract, } from "./contracts/validator.js";
 export { PERSISTED_TOPIC_KINDS, TOPIC_CONTRACT_RECIPES, assertContractComplete, baseTopicKind, contractCompleteness, topicRecipeForKind, } from "./contracts/topic-contract.js";
+export { JOB_CARD_KIND_PROFILE, JOB_CARD_KIND_PROFILE_REF, JOB_CARD_KIND_REF, JOB_CARD_PHASES, JOB_CARD_PRIORITIES, contractCompletenessWithProfiles, resolveTopicKindProfile, } from "./contracts/topic-kind-profile.js";
 export { TopicProtocolError, } from "./errors.js";
 export { projectTopic } from "./projector/project.js";
 export { adoptedTopicAnchor, nativeTopicAnchor, selectCanonicalTopicAnchor } from "./matrix/anchors.js";

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAEf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,cAAc,EACd,gBAAgB,GAGjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,GAgBnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,GAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACxG,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,EACb,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,GAS/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAA4B,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,GAkB3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EA+BvB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,GAkBzB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAEf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,cAAc,EACd,gBAAgB,GAGjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,GAgBnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,gCAAgC,EAChC,uBAAuB,GAOxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,kBAAkB,GAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACxG,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,EACb,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,GAS/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAA4B,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,GAkB3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EA+BvB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,GAkBzB,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ixo/topic-protocol",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Reference contracts and deterministic projection for IXO Topics",
   "type": "module",
   "sideEffects": false,
@@ -17,6 +17,7 @@
   "types": "./dist/src/index.d.ts",
   "files": [
     "dist",
+    "profiles",
     "README.md"
   ],
   "exports": {
@@ -24,7 +25,8 @@
       "types": "./dist/src/index.d.ts",
       "import": "./dist/src/index.js"
     },
-    "./schemas/*": "./dist/schemas/*"
+    "./schemas/*": "./dist/schemas/*",
+    "./profiles/*": "./profiles/*"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/profiles/job-card/README.md

@@ -0,0 +1,11 @@
+# Job Card Kind Profile
+
+`profile.json` is the immutable profile document for the first-party Job Kind
+extension. It is pinned from Topic contracts by exact version and SHA-256
+digest. The Job-specific resource validates against
+`schemas/job-card.schema.json`.
+
+Generic Topic clients fall back to the standard `task` Kind and `project`
+recipe. Profile-aware clients may edit and project the room-visible fields
+declared by the profile, but must keep the complete Job Card in the encrypted
+contract body or its authorised bound resource.

package/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"]
+}