@x12i/memorix-metadata 3.4.0 → 3.4.2

package/examples/knowx/normalized/pack.json

@@ -1,1866 +1,1888 @@
-{
-  "format": "memorix-metadata/1",
-  "agentId": "knowx",
-  "version": "0.1.0",
-  "agents": [
-    {
-      "id": "knowx",
-      "name": "KnowX (knowledge agent)",
-      "description": "First-party KnowX agent: extract knowledge from text+source, associate to existing knowledge, associate novel knowledge to entities. Standalone root agent — does not inherit from opx.",
-      "parentIds": [],
-      "parentId": null
-    }
-  ],
-  "objectTypes": [
-    {
-      "id": "people",
-      "name": "People",
-      "dataCategory": "entity",
-      "abstractTypes": [
-        "People"
-      ],
-      "notes": "Single people OT. Inside vs outside org is identity kind (concept.identifiers.primary.kind): employeeId | externalPersonId.",
-      "contentTypes": [
-        {
-          "id": "raw",
-          "required": true,
-          "requiredReason": "Landed provider-native payload; identity and lineage depend on it."
-        },
-        {
-          "id": "snapshots",
-          "required": true,
-          "requiredReason": "Canonical composed person view used by queries and abstracts."
-        },
-        {
-          "id": "discovery",
-          "discriminator": {
-            "path": "data.discoveryType",
-            "required": false,
-            "defaultValue": "default"
-          }
-        },
-        {
-          "id": "analysis",
-          "discriminator": {
-            "path": "data.analysisType",
-            "required": false,
-            "defaultValue": "default"
-          }
-        },
-        {
-          "id": "relationships",
-          "notes": "Candidate store shape until Gate G4"
-        },
-        {
-          "id": "knowx",
-          "notes": "KnowX NODE facet — provenance required in .data"
-        }
-      ],
-      "fields": [
-        {
-          "path": "data.title",
-          "valueType": "string",
-          "contentType": "snapshots"
-        },
-        {
-          "path": "data.role",
-          "valueType": "string",
-          "contentType": "snapshots"
-        },
-        {
-          "path": "data.lens",
-          "valueType": "string",
-          "contentType": "snapshots"
-        },
-        {
-          "path": "data.email",
-          "valueType": "string",
-          "contentType": "snapshots"
-        },
-        {
-          "path": "data.organization",
-          "valueType": "string",
-          "contentType": "snapshots"
-        }
-      ]
-    },
-    {
-      "id": "work-items",
-      "name": "Work Items",
-      "dataCategory": "entity",
-      "abstractTypes": [
-        "WorkItems"
-      ],
-      "contentTypes": [
-        {
-          "id": "raw"
-        },
-        {
-          "id": "snapshots"
-        },
-        {
-          "id": "discovery",
-          "discriminator": {
-            "path": "data.discoveryType",
-            "required": false
-          }
-        },
-        {
-          "id": "analysis",
-          "discriminator": {
-            "path": "data.analysisType",
-            "required": false,
-            "defaultValue": "delivery-risk"
-          }
-        },
-        {
-          "id": "decisions",
-          "discriminator": {
-            "path": "data.decisionType",
-            "required": false,
-            "defaultValue": "priority"
-          }
-        },
-        {
-          "id": "workflow"
-        },
-        {
-          "id": "context",
-          "retention": "work-scoped-ttl"
-        },
-        {
-          "id": "relationships"
-        },
-        {
-          "id": "knowx",
-          "notes": "KnowX NODE facet — provenance required in .data"
-        }
-      ],
-      "snapshotBuckets": {
-        "analytics": "optional",
-        "enrichment": "optional",
-        "insights": "optional"
-      },
-      "fields": [
-        {
-          "path": "data.title",
-          "valueType": "string",
-          "contentType": "snapshots"
-        },
-        {
-          "path": "data.status",
-          "valueType": "string",
-          "contentType": "snapshots"
-        },
-        {
-          "path": "data.priority",
-          "valueType": "string",
-          "contentType": "snapshots"
-        },
-        {
-          "path": "data.assigneeId",
-          "valueType": "recordId",
-          "contentType": "snapshots",
-          "refersTo": {
-            "objectType": "people"
-          }
-        }
-      ]
-    },
-    {
-      "id": "content",
-      "name": "Content",
-      "dataCategory": "knowledge",
-      "abstractTypes": [
-        "Content"
-      ],
-      "notes": "Ingested documents (raw/snapshots) plus free-floating KnowX knowledge items (knowx NODE/EDGE with own recordId). Nexum apply-plan records use nexum-* object types. Entity NODE facets stay on people/work-items.",
-      "contentTypes": [
-        {
+{
+  "format": "memorix-metadata/1",
+  "agentId": "knowx",
+  "version": "0.1.0",
+  "agents": [
+    {
+      "id": "knowx",
+      "name": "KnowX (knowledge agent)",
+      "description": "First-party KnowX agent: extract knowledge from text+source, associate to existing knowledge, associate novel knowledge to entities. Standalone root agent — does not inherit from opx.",
+      "parentIds": [],
+      "parentId": null
+    }
+  ],
+  "objectTypes": [
+    {
+      "id": "people",
+      "name": "People",
+      "dataCategory": "entity",
+      "abstractTypes": [
+        "People"
+      ],
+      "notes": "Single people OT. Inside vs outside org is identity kind (concept.identifiers.primary.kind): employeeId | externalPersonId.",
+      "contentTypes": [
+        {
+          "id": "raw",
+          "required": true,
+          "requiredReason": "Landed provider-native payload; identity and lineage depend on it.",
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "snapshots",
+          "required": true,
+          "requiredReason": "Canonical composed person view used by queries and abstracts.",
+          "profile": { "allowSnapshotBuckets": true }
+        },
+        {
+          "id": "discovery",
+          "discriminator": {
+            "path": "data.discoveryType",
+            "required": false,
+            "defaultValue": "default"
+          },
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "analysis",
+          "discriminator": {
+            "path": "data.analysisType",
+            "required": false,
+            "defaultValue": "default"
+          },
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "relationships",
+          "notes": "Candidate store shape until Gate G4",
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "knowx",
+          "notes": "KnowX NODE facet — provenance required in .data",
+          "profile": { "allowSnapshotBuckets": false }
+        }
+      ],
+      "fields": [
+        {
+          "path": "data.title",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.role",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.lens",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.email",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.organization",
+          "valueType": "string",
+          "contentType": "snapshots"
+        }
+      ]
+    },
+    {
+      "id": "work-items",
+      "name": "Work Items",
+      "dataCategory": "entity",
+      "abstractTypes": [
+        "WorkItems"
+      ],
+      "contentTypes": [
+        {
           "id": "raw",
-          "required": true,
-          "requiredReason": "Exact provider-native land from knowx-folder / knowx-rest connectors; ingest identity depends on it.",
-          "notes": "Exact provider-native land from knowx-folder / knowx-rest connectors"
-        },
-        {
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
           "id": "snapshots",
-          "required": false,
-          "notes": "Promoted Markdown ContentRecordData via knowx-promote-content (or knowledge-pull promote)"
-        },
-        {
-          "id": "knowx",
-          "notes": "Knowledge item payloads — data.kind NODE|EDGE (topology); data.identity.category claim|fact|opinion|assumption (AI classifier, orthogonal to kind); data.epistemic.state is review standing (≠ identity.category); provenance mandatory. EDGE and content-derived items use their own recordId."
-        },
-        {
-          "id": "nexum",
-          "required": false,
-          "notes": "Optional Nexum snapshot facet; durable apply-plan kinds use nexum-* object types"
-        },
-        {
-          "id": "workflow",
-          "notes": "Human review assignment sibling for knowledge items"
-        },
-        {
-          "id": "confirmations",
-          "notes": "Accept/reject decision sibling for knowledge items"
-        },
-        {
-          "id": "relationships",
-          "notes": "Content↔Knowledge lineage and knowledge links"
-        }
-      ],
-      "fields": [
-        {
-          "path": "data.title",
-          "valueType": "string",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.markdown",
-          "valueType": "string",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.contentHash",
-          "valueType": "string",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.sourceFormat",
-          "valueType": "string",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.sourceMediaType",
-          "valueType": "string",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.byteSize",
-          "valueType": "number",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.language",
-          "valueType": "string",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.state",
-          "valueType": "string",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.revision",
-          "valueType": "number",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.extraction.extractorId",
-          "valueType": "string",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.extraction.extractorVersion",
-          "valueType": "string",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.extraction.extractedAt",
-          "valueType": "datetime",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.origins",
-          "valueType": "array",
-          "contentType": "raw"
-        },
-        {
-          "path": "data.nav.derivedKnowledge",
-          "valueType": "array",
-          "contentType": "relationships"
-        }
-      ]
-    }
-  ],
-  "abstractTypes": [
-    {
-      "id": "People",
-      "name": "People",
-      "meaning": "People who perform operational work — inside the org (employeeId) or outside (externalPersonId), distinguished by identity kind",
-      "category": "entity",
-      "properties": [
-        {
-          "id": "title",
-          "valueType": "string",
-          "required": true
-        },
-        {
-          "id": "role",
-          "valueType": "string",
-          "required": true
-        },
-        {
-          "id": "lens",
-          "valueType": "string",
-          "required": false
-        },
-        {
-          "id": "email",
-          "valueType": "string",
-          "required": false
-        },
-        {
-          "id": "organization",
-          "valueType": "string",
-          "required": false
-        },
-        {
-          "id": "contentEdgesFrom",
-          "valueType": "array",
-          "required": false
-        }
-      ],
-      "members": [
-        {
-          "objectType": "people",
-          "contentType": "snapshots",
-          "properties": [
-            {
-              "abstractProperty": "title",
-              "contentType": "snapshots",
-              "propertyPath": "data.title",
-              "concreteValueType": "string"
-            },
-            {
-              "abstractProperty": "role",
-              "contentType": "snapshots",
-              "propertyPath": "data.role",
-              "concreteValueType": "string"
-            },
-            {
-              "abstractProperty": "lens",
-              "contentType": "snapshots",
-              "propertyPath": "data.lens",
-              "concreteValueType": "string"
-            },
-            {
-              "abstractProperty": "email",
-              "contentType": "snapshots",
-              "propertyPath": "data.email",
-              "concreteValueType": "string"
-            },
-            {
-              "abstractProperty": "organization",
-              "contentType": "snapshots",
-              "propertyPath": "data.organization",
-              "concreteValueType": "string"
-            },
-            {
-              "abstractProperty": "contentEdgesFrom",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.contentEdgesFrom"
-            }
-          ]
-        }
-      ],
-      "union": false,
-      "notes": "People abstract ↔ people OT 1:1. Identity kind employeeId | externalPersonId distinguishes inside/outside org."
-    },
-    {
-      "id": "WorkItems",
-      "name": "Work Items",
-      "meaning": "Units of operational work",
-      "category": "entity",
-      "properties": [
-        {
-          "id": "title",
-          "valueType": "string",
-          "required": true
-        },
-        {
-          "id": "status",
-          "valueType": "string",
-          "required": true
-        },
-        {
-          "id": "priority",
-          "valueType": "string",
-          "required": false
-        },
-        {
-          "id": "contentEdgesTo",
-          "valueType": "array",
-          "required": false
-        }
-      ],
-      "members": [
-        {
-          "objectType": "work-items",
-          "contentType": "snapshots",
-          "properties": [
-            {
-              "abstractProperty": "title",
-              "contentType": "snapshots",
-              "propertyPath": "data.title",
-              "concreteValueType": "string"
-            },
-            {
-              "abstractProperty": "status",
-              "contentType": "snapshots",
-              "propertyPath": "data.status",
-              "concreteValueType": "string"
-            },
-            {
-              "abstractProperty": "priority",
-              "contentType": "snapshots",
-              "propertyPath": "data.priority",
-              "concreteValueType": "string"
-            },
-            {
-              "abstractProperty": "contentEdgesTo",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.contentEdgesTo"
-            }
-          ]
-        }
-      ],
-      "union": false
-    },
-    {
-      "id": "Content",
-      "name": "Content",
-      "meaning": "Canonical ingested documents and derived knowledge items (Markdown + provenance). Knowledge claims are derived from content; content is the source of claims, not the claims themselves.",
-      "category": "knowledge",
-      "properties": [
-        {
-          "id": "title",
-          "valueType": "string",
-          "required": false
-        },
-        {
-          "id": "markdown",
-          "valueType": "string",
-          "required": true
-        },
-        {
-          "id": "contentHash",
-          "valueType": "string",
-          "required": true
-        },
-        {
-          "id": "sourceFormat",
-          "valueType": "string",
-          "required": true
-        },
-        {
-          "id": "sourceMediaType",
-          "valueType": "string",
-          "required": true
-        },
-        {
-          "id": "byteSize",
-          "valueType": "number",
-          "required": true
-        },
-        {
-          "id": "language",
-          "valueType": "string",
-          "required": false
-        },
-        {
-          "id": "state",
-          "valueType": "string",
-          "required": true
-        },
-        {
-          "id": "revision",
-          "valueType": "number",
-          "required": true
-        },
-        {
-          "id": "extractorId",
-          "valueType": "string",
-          "required": false
-        },
-        {
-          "id": "extractorVersion",
-          "valueType": "string",
-          "required": false
-        },
-        {
-          "id": "extractedAt",
-          "valueType": "datetime",
-          "required": false
-        },
-        {
-          "id": "origins",
-          "valueType": "array",
-          "required": false
-        },
-        {
-          "id": "derivedKnowledge",
-          "valueType": "array",
-          "required": false
-        },
-        {
-          "id": "sameAs",
-          "valueType": "array",
-          "required": false
-        },
-        {
-          "id": "supports",
-          "valueType": "array",
-          "required": false
-        },
-        {
-          "id": "supportedBy",
-          "valueType": "array",
-          "required": false
-        },
-        {
-          "id": "contradicts",
-          "valueType": "array",
-          "required": false
-        },
-        {
-          "id": "contradictedBy",
-          "valueType": "array",
-          "required": false
-        },
-        {
-          "id": "derivedFrom",
-          "valueType": "array",
-          "required": false
-        },
-        {
-          "id": "derivedClaims",
-          "valueType": "array",
-          "required": false
-        },
-        {
-          "id": "derivedFromContent",
-          "valueType": "array",
-          "required": false
-        },
-        {
-          "id": "edgeFrom",
-          "valueType": "array",
-          "required": false
-        },
-        {
-          "id": "edgeTo",
-          "valueType": "array",
-          "required": false
-        }
-      ],
-      "members": [
-        {
-          "objectType": "content",
-          "contentType": "raw",
-          "properties": [
-            {
-              "abstractProperty": "title",
-              "contentType": "raw",
-              "propertyPath": "data.title"
-            },
-            {
-              "abstractProperty": "markdown",
-              "contentType": "raw",
-              "propertyPath": "data.markdown"
-            },
-            {
-              "abstractProperty": "contentHash",
-              "contentType": "raw",
-              "propertyPath": "data.contentHash"
-            },
-            {
-              "abstractProperty": "sourceFormat",
-              "contentType": "raw",
-              "propertyPath": "data.sourceFormat"
-            },
-            {
-              "abstractProperty": "sourceMediaType",
-              "contentType": "raw",
-              "propertyPath": "data.sourceMediaType"
-            },
-            {
-              "abstractProperty": "byteSize",
-              "contentType": "raw",
-              "propertyPath": "data.byteSize"
-            },
-            {
-              "abstractProperty": "language",
-              "contentType": "raw",
-              "propertyPath": "data.language"
-            },
-            {
-              "abstractProperty": "state",
-              "contentType": "raw",
-              "propertyPath": "data.state"
-            },
-            {
-              "abstractProperty": "revision",
-              "contentType": "raw",
-              "propertyPath": "data.revision"
-            },
-            {
-              "abstractProperty": "extractorId",
-              "contentType": "raw",
-              "propertyPath": "data.extraction.extractorId"
-            },
-            {
-              "abstractProperty": "extractorVersion",
-              "contentType": "raw",
-              "propertyPath": "data.extraction.extractorVersion"
-            },
-            {
-              "abstractProperty": "extractedAt",
-              "contentType": "raw",
-              "propertyPath": "data.extraction.extractedAt"
-            },
-            {
-              "abstractProperty": "origins",
-              "contentType": "raw",
-              "propertyPath": "data.origins"
-            },
-            {
-              "abstractProperty": "derivedKnowledge",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.derivedKnowledge"
-            },
-            {
-              "abstractProperty": "sameAs",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.sameAs"
-            },
-            {
-              "abstractProperty": "supports",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.supports"
-            },
-            {
-              "abstractProperty": "supportedBy",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.supportedBy"
-            },
-            {
-              "abstractProperty": "contradicts",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.contradicts"
-            },
-            {
-              "abstractProperty": "contradictedBy",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.contradictedBy"
-            },
-            {
-              "abstractProperty": "derivedFrom",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.derivedFrom"
-            },
-            {
-              "abstractProperty": "derivedClaims",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.derivedClaims"
-            },
-            {
-              "abstractProperty": "derivedFromContent",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.derivedFromContent"
-            },
-            {
-              "abstractProperty": "edgeFrom",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.edgeFrom"
-            },
-            {
-              "abstractProperty": "edgeTo",
-              "contentType": "relationships",
-              "propertyPath": "data.nav.edgeTo"
-            }
-          ]
-        }
-      ],
-      "union": false,
-      "notes": "Content abstract ↔ content OT. Domain noun — not product-branded. Documents (raw/snapshots) and derived knowledge items (knowx) share this abstract; writers always target concrete content types on the OT."
-    }
-  ],
-  "relationshipDefinitions": [
-    {
-      "id": "knowx-same-as",
-      "name": "Same as",
-      "meaning": "Two knowledge claims refer to the same underlying assertion",
-      "directionality": "undirected",
-      "from": {
-        "abstractType": "Content",
-        "path": "sameAs"
-      },
-      "to": {
-        "abstractType": "Content",
-        "path": "sameAs"
-      },
-      "discoveryRules": [
-        {
-          "id": "from-associate-plan",
-          "kind": "service-plan",
-          "notes": "Materialized from knowx-associate-knowledge relationshipPlans"
-        }
-      ]
-    },
-    {
-      "id": "knowx-supports",
-      "name": "Supports",
-      "meaning": "One knowledge claim supports another",
-      "directionality": "directed",
-      "from": {
-        "abstractType": "Content",
-        "path": "supports"
-      },
-      "to": {
-        "abstractType": "Content",
-        "path": "supportedBy"
-      },
-      "discoveryRules": [
-        {
-          "id": "from-associate-plan",
-          "kind": "service-plan",
-          "notes": "Materialized from knowx-associate-knowledge relationshipPlans"
-        }
-      ]
-    },
-    {
-      "id": "knowx-contradicts",
-      "name": "Contradicts",
-      "meaning": "Two knowledge claims contradict each other",
-      "directionality": "directed",
-      "from": {
-        "abstractType": "Content",
-        "path": "contradicts"
-      },
-      "to": {
-        "abstractType": "Content",
-        "path": "contradictedBy"
-      },
-      "discoveryRules": [
-        {
-          "id": "from-associate-plan",
-          "kind": "service-plan",
-          "notes": "Materialized from knowx-associate-knowledge relationshipPlans"
-        }
-      ]
-    },
-    {
-      "id": "knowx-derived-from",
-      "name": "Derived from claim",
-      "meaning": "A knowledge claim is derived from another knowledge claim",
-      "directionality": "directed",
-      "from": {
-        "abstractType": "Content",
-        "path": "derivedFrom"
-      },
-      "to": {
-        "abstractType": "Content",
-        "path": "derivedClaims"
-      },
-      "discoveryRules": [
-        {
-          "id": "from-associate-plan",
-          "kind": "service-plan",
-          "notes": "Materialized from knowx-associate-knowledge relationshipPlans"
-        }
-      ]
-    },
-    {
-      "id": "knowx-derived-from-content",
-      "name": "Derived from content",
-      "meaning": "A knowledge claim is derived from ingested content",
-      "directionality": "directed",
-      "from": {
-        "abstractType": "Content",
-        "path": "derivedFromContent"
-      },
-      "to": {
-        "abstractType": "Content",
-        "path": "derivedKnowledge"
-      },
-      "discoveryRules": [
-        {
-          "id": "from-associate-plan",
-          "kind": "service-plan",
-          "notes": "Materialized from knowx-associate-knowledge when provenance.lineage.sourceContentId is present"
-        }
-      ]
-    },
-    {
-      "id": "knowx-edge-from",
-      "name": "Edge from",
-      "meaning": "A knowledge EDGE claim starts at an entity",
-      "directionality": "directed",
-      "from": {
-        "abstractType": "Content",
-        "path": "edgeFrom"
-      },
-      "to": {
-        "abstractType": "People",
-        "path": "contentEdgesFrom"
-      },
-      "discoveryRules": [
-        {
-          "id": "from-associate-entities-plan",
-          "kind": "service-plan",
-          "notes": "Materialized from knowx-associate-entities entityRelationshipPlans"
-        }
-      ]
-    },
-    {
-      "id": "knowx-edge-to",
-      "name": "Edge to",
-      "meaning": "A knowledge EDGE claim ends at an entity",
-      "directionality": "directed",
-      "from": {
-        "abstractType": "Content",
-        "path": "edgeTo"
-      },
-      "to": {
-        "abstractType": "WorkItems",
-        "path": "contentEdgesTo"
-      },
-      "discoveryRules": [
-        {
-          "id": "from-associate-entities-plan",
-          "kind": "service-plan",
-          "notes": "Materialized from knowx-associate-entities entityRelationshipPlans"
-        }
-      ]
-    }
-  ],
-  "mappings": [],
-  "views": [],
-  "writes": [],
-  "sources": [
-    {
-      "id": "knowx-source",
-      "name": "Knowledge source",
-      "kind": "rest",
-      "baseUrlEnv": "KNOWX_SOURCE_URL",
-      "defaultBaseUrl": "http://127.0.0.1:5104",
-      "credentialRef": "knowx-source-local",
-      "connectorRef": "knowx-rest",
-      "endpoints": [
-        "/content"
-      ],
-      "pagination": {
-        "style": "cursor",
-        "defaultPageSize": 50
-      },
-      "streams": [
-        {
-          "streamId": "content",
-          "endpoint": "/content",
-          "objectType": "content",
-          "dataCategory": "knowledge",
-          "identityPath": "id",
-          "modes": [
-            "knowledge"
-          ],
-          "pageSize": 10,
-          "checkpoint": {
-            "method": "cursor"
-          }
-        }
-      ],
-      "routes": [
-        {
-          "endpoint": "/content",
-          "objectType": "content",
-          "dataCategory": "knowledge",
-          "identityPath": "id",
-          "primaryKind": "contentId",
-          "modes": [
-            "knowledge"
-          ],
-          "pageSize": 10,
-          "checkpoint": {
-            "method": "cursor"
-          }
-        }
-      ]
-    },
-    {
-      "id": "knowx-managed",
-      "name": "Knowledge Drive (managed)",
-      "kind": "knowx-managed",
-      "connectorRef": "knowx-managed",
-      "endpoints": [
-        "/items"
-      ],
-      "pagination": {
-        "style": "page",
-        "defaultPageSize": 25
-      },
-      "streams": [
-        {
-          "streamId": "items",
-          "endpoint": "/items",
-          "objectType": "content",
-          "dataCategory": "knowledge",
-          "identityPath": "id",
-          "modes": [
-            "knowledge"
-          ],
-          "pageSize": 25,
-          "checkpoint": {
-            "method": "cursor"
-          }
-        }
-      ],
-      "routes": [
-        {
-          "endpoint": "/items",
-          "objectType": "content",
-          "dataCategory": "knowledge",
-          "identityPath": "id",
-          "primaryKind": "contentId",
-          "modes": [
-            "knowledge"
-          ],
-          "pageSize": 25,
-          "checkpoint": {
-            "method": "cursor"
-          }
-        }
-      ]
-    }
-  ],
-  "services": [
-    {
-      "id": "knowx-folder-pull",
-      "name": "Folder connector pull",
-      "description": "Runs the remote-hosted knowx-folder defineConnector (collectStream + fullScanHash). Lands exact file raw only — does not extract Markdown or derive knowledge. Connector-adjacent worker — not agent vocabulary.",
-      "role": "connector",
-      "capabilities": [
-        "analyze"
-      ],
-      "memorixAccess": [
-        "raw",
-        "checkpoints"
-      ],
-      "inputs": [
-        {
-          "id": "sourceId",
-          "control": true,
-          "description": "Managed folder ContentSource id"
-        },
-        {
-          "id": "relativePath",
-          "control": true,
-          "description": "Optional single relative path for targeted ingest"
-        },
-        {
-          "id": "triggerReason",
-          "control": true,
-          "description": "manual | scheduled | watch | delete"
-        }
-      ],
-      "outputs": [
-        {
-          "id": "pullSummary",
-          "control": true,
-          "description": "Pull status, discovered counts, rawItemIds"
-        },
-        {
-          "id": "rawItemIds",
-          "control": true,
-          "description": "Relative-path identities landed as content/raw"
-        }
-      ],
-      "invocation": {
-        "kind": "worker",
-        "operation": "knowx-folder-pull"
-      }
-    },
-    {
-      "id": "knowx-managed-pull",
-      "name": "Managed drive pull",
-      "description": "Runs the remote-hosted knowx-managed defineConnector over managed upload events / item versions. Lands exact bytes as content/raw via collectStream. Connector-adjacent worker — not agent vocabulary.",
-      "role": "connector",
-      "capabilities": [
-        "analyze"
-      ],
-      "memorixAccess": [
-        "raw",
-        "checkpoints"
-      ],
-      "inputs": [
-        {
-          "id": "itemIds",
-          "control": true,
-          "description": "Managed Knowledge Drive item ids to pull"
-        },
-        {
-          "id": "eventCursor",
-          "control": true,
-          "description": "Optional managed event cursor"
-        }
-      ],
-      "outputs": [
-        {
-          "id": "pullSummary",
-          "control": true,
-          "description": "Pull status and counts"
-        },
-        {
-          "id": "rawItemIds",
-          "control": true,
-          "description": "Managed item identities landed as content/raw"
-        }
-      ],
-      "invocation": {
-        "kind": "worker",
-        "operation": "knowx-managed-pull"
-      }
-    },
-    {
-      "id": "knowx-promote-content",
-      "name": "Promote content",
-      "description": "Reads landed content/raw file envelopes, runs format→Markdown extractors, writes Content snapshots. Connector-pipeline step — promotes concrete raw onto the Content abstract member.",
-      "role": "connector",
-      "capabilities": [
-        "analyze"
-      ],
-      "memorixAccess": [
-        "raw",
-        "explore"
-      ],
-      "inputs": [
-        {
-          "id": "sourceId",
-          "control": true,
-          "description": "Managed folder source id"
-        },
-        {
-          "id": "rawItemIds",
-          "control": true,
-          "description": "Raw identities from knowx-folder-pull"
-        },
-        {
-          "id": "pullSummary",
-          "control": true,
-          "description": "Optional pull summary carrying rawItemIds"
-        }
-      ],
-      "outputs": [
-        {
-          "id": "contentDrafts",
-          "abstractType": "Content",
-          "description": "Canonical ContentRecordData drafts on Content"
-        },
-        {
-          "id": "contentIds",
-          "abstractType": "Content",
-          "description": "Promoted Content record ids"
-        }
-      ],
-      "invocation": {
-        "kind": "worker",
-        "operation": "knowx-promote-content"
-      }
-    },
-    {
-      "id": "knowx-extract",
-      "name": "Extract knowledge",
-      "description": "Extract NODE/EDGE knowledge-item drafts from Content (text + knowledge source, or promoted content). Each draft includes data.identity.category (claim|fact|opinion|assumption). Returns drafts only — does not persist. Pipeline write-record applies knowx content. When aiService is bound and AI_SKILLS_URL is set, Memorix invokes Catalox skill knowx.extract via ai-services/1. Fallback: pack worker; test-only KNOWX_AI_SIM=1 routes to APS AI sim (:5112).",
-      "role": "agent",
-      "capabilities": [
-        "analyze"
-      ],
-      "memorixAccess": [
-        "explore"
-      ],
-      "inputs": [
-        {
-          "id": "text",
-          "control": true,
-          "description": "Input text to analyze (inline string or resolved from Content)"
-        },
-        {
-          "id": "knowledgeSource",
-          "abstractType": "Content",
-          "description": "Exact source bytes / provenance envelope for Content"
-        },
-        {
-          "id": "contentId",
-          "abstractType": "Content",
-          "description": "Promoted Content record id — open via Explore"
-        },
-        {
-          "id": "contentIds",
-          "abstractType": "Content",
-          "description": "Batch of promoted Content ids"
-        },
-        {
-          "id": "contentDrafts",
-          "abstractType": "Content",
-          "description": "In-pipeline ContentRecordData from knowx-promote-content"
-        }
-      ],
-      "outputs": [
-        {
-          "id": "knowxDrafts",
-          "abstractType": "Content",
-          "description": "Array of knowx knowledge-item drafts (NODE/EDGE + data.identity.category claim|fact|opinion|assumption) with mandatory provenance and content lineage"
-        }
-      ],
-      "aiService": {
-        "aiServiceType": "skill",
-        "itemId": "knowx.extract",
-        "endpointEnv": "AI_SKILLS_URL"
-      },
-      "invocation": {
-        "kind": "worker",
-        "operation": "knowx-extract",
-        "endpointEnv": "KNOWX_EXTRACT_WORKER_URL",
-        "notes": "Worker fallback when AI_SKILLS_URL unset / compile cannot resolve skill origin. KNOWX_EXTRACT_WORKER_URL honored only when KNOWX_AI_SIM=1 (test-only)."
-      }
-    },
-    {
-      "id": "knowx-retrieval-index",
-      "name": "Index / candidates (candidate-retrieval)",
-      "description": "Companion step for @x12i/candidate-retrival-service (MEMORIX_RETRIEVAL_URL, default local :6560). (1) POST /v1/candidates for open knowx drafts so associate sees corpus-scale priors, (2) POST /v1/index/upsert for knowx drafts (knowx.knowledge) and Content snapshots (knowx.snapshot). Soft-skips only when URL unset; when URL is set, remote failures hard-fail the step — associate then receives real CRS priors.",
-      "role": "agent",
-      "capabilities": [
-        "analyze"
-      ],
-      "memorixAccess": [],
-      "inputs": [
-        {
-          "id": "knowxDrafts",
-          "abstractType": "Content",
-          "description": "Drafts from knowx-extract / write path (candidates + upsert)"
-        },
-        {
-          "id": "contentDrafts",
-          "abstractType": "Content",
-          "description": "Optional Content snapshot drafts from knowx-promote-content (knowx.snapshot upsert)"
-        },
-        {
-          "id": "fetchCandidates",
-          "control": true,
-          "description": "When false, index only (no /v1/candidates). Default true when knowxDrafts present."
-        }
-      ],
-      "outputs": [
-        {
-          "id": "existingKnowx",
-          "abstractType": "Content",
-          "description": "Ranked prior knowx from /v1/candidates for associate (self-ids excluded)"
-        },
-        {
-          "id": "retrieval",
-          "control": true,
-          "description": "enabled / upserted / warnings for ops"
-        },
-        {
-          "id": "indexedRecordIds",
-          "control": true,
-          "description": "recordId / contentId list submitted for upsert"
-        }
-      ],
-      "invocation": {
-        "kind": "worker",
-        "operation": "knowx-retrieval-index",
-        "notes": "Requires MEMORIX_RETRIEVAL_URL (or CANDIDATE_RETRIEVAL_URL) pointing at the candidate-retrieval companion."
-      }
-    },
-    {
-      "id": "knowx-nexum",
-      "name": "Knowledge graph analyze (Nexum)",
-      "description": "KnowX control-plane adapter for @x12i/nexum (MEMORIX_NEXUM_URL, default local :7500). Maps KnowX pipeline bags (extract/promote/write) to Nexum items[], POSTs memorix-capability/1 analyze (serviceId nexum), returns proposedGraph. Soft-skips only when URL unset; when URL is set (or MEMORIX_NEXUM_REQUIRED=1), companion failures hard-fail. Persistence is platform write-record mode nexum after this step. Explore view: createKnowxNexumExploreClient (NEXUM_API_URL · :8080).",
-      "role": "agent",
-      "capabilities": [
-        "analyze"
-      ],
-      "memorixAccess": [],
-      "inputs": [
-        {
-          "id": "knowxDrafts",
-          "abstractType": "Content",
-          "description": "Drafts from knowx-extract / write path (structured items for Nexum)"
-        },
-        {
-          "id": "contentDrafts",
-          "abstractType": "Content",
-          "description": "Optional Content snapshot drafts from knowx-promote-content"
-        }
-      ],
-      "outputs": [
-        {
-          "id": "apply-plan",
-          "control": true,
-          "description": "x12i-nexum/1 replace-contribution / remove-contribution apply plan (not applied by this step)"
-        },
-        {
-          "id": "nexum",
-          "control": true,
-          "description": "enabled / itemCount / warnings for ops"
-        },
-        {
-          "id": "diagnostics",
-          "control": true,
-          "description": "Remote worker diagnostics"
-        }
-      ],
-      "invocation": {
-        "kind": "worker",
-        "operation": "analyze",
-        "notes": "KnowX control-plane adapter (serviceId knowx-nexum — not nexum). Maps bags then POSTs to nexum-worker via MEMORIX_NEXUM_URL (alias NEXUM_URL). Compile must not treat this id as serviceId nexum. Explore REST uses MEMORIX_NEXUM_READ_URL + createKnowxNexumExploreClient."
-      }
-    },
-    {
-      "id": "knowx-associate-knowledge",
-      "name": "Associate knowledge",
-      "description": "Classify extracted drafts against existing Content scope: known, novel, contradicts. Prefer existingKnowx from knowx-retrieval-index (/v1/candidates). When aiService is bound, Memorix invokes Catalox skill knowx.associate-knowledge and may also push explore/catalog. Worker fallback uses pushed existingKnowx or Explore list. Returns classification buckets + candidate knowledge relationship plans. Does not persist.",
-      "role": "agent",
-      "capabilities": [
-        "analyze"
-      ],
-      "memorixAccess": [
-        "explore"
-      ],
-      "inputs": [
-        {
-          "id": "knowxDrafts",
-          "abstractType": "Content",
-          "description": "Drafts from knowx-extract"
-        },
-        {
-          "id": "existingKnowx",
-          "abstractType": "Content",
-          "description": "Optional: pipeline output from knowx-retrieval-index, fixtures, or Explore push"
-        }
-      ],
-      "outputs": [
-        {
-          "id": "classification",
-          "abstractType": "Content",
-          "description": "known / novel / contradicts buckets"
-        },
-        {
-          "id": "relationshipPlans",
-          "abstractType": "Content",
-          "description": "Candidate knowledge relationship plans on Content"
-        }
-      ],
-      "aiService": {
-        "aiServiceType": "skill",
-        "itemId": "knowx.associate-knowledge",
-        "endpointEnv": "AI_SKILLS_URL"
-      },
-      "invocation": {
-        "kind": "worker",
-        "operation": "knowx-associate-knowledge",
-        "notes": "Worker fallback when AI_SKILLS_URL unset / compile cannot resolve skill origin."
-      }
-    },
-    {
-      "id": "knowx-associate-entities",
-      "name": "Associate entities",
-      "description": "Plan EDGE endpoint relationships for novel drafts against entity abstracts (People, WorkItems) and Content. Does not persist.",
-      "role": "agent",
-      "capabilities": [
-        "analyze"
-      ],
-      "memorixAccess": [
-        "explore"
-      ],
-      "inputs": [
-        {
-          "id": "novelDrafts",
-          "abstractType": "Content",
-          "description": "Novel drafts from associate-knowledge classification"
-        }
-      ],
-      "outputs": [
-        {
-          "id": "entityRelationshipPlans",
-          "abstractType": "People",
-          "description": "EDGE endpoint relationship plans toward People, WorkItems, and Content abstracts"
-        }
-      ],
-      "invocation": {
-        "kind": "worker",
-        "operation": "knowx-associate-entities"
-      }
-    }
-  ],
-  "pipelines": [
-    {
-      "id": "knowx-knowledge-pull",
-      "name": "Scheduled knowledge pull from knowx-source",
-      "trigger": "scheduled",
-      "mode": "knowledge",
-      "description": "Memory pull from knowx-source fixture (CF knowx-rest). Promote/extract are separate pipelines.",
-      "steps": [
-        {
-          "id": "pull",
-          "kind": "memory-pull",
-          "sourceId": "knowx-source"
-        }
-      ]
-    },
-    {
-      "id": "knowx-ingest-associate",
-      "name": "Ingest then associate knowledge and entities",
-      "trigger": "explicit",
-      "description": "extract → write knowx → retrieval-index (candidate-retrieval upsert + candidates) → nexum (proposedGraph) → write-graph (mode nexum persist) → associate-knowledge → relationship-write → associate-entities → relationship-write. Services do not persist; write-record and relationship-write do.",
-      "steps": [
-        {
-          "id": "extract",
-          "kind": "analyze",
-          "serviceId": "knowx-extract"
-        },
-        {
-          "id": "write-knowx",
-          "kind": "write-record",
-          "contentType": "knowx",
-          "dependsOn": [
-            "extract"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            }
-          ]
-        },
-        {
-          "id": "index-knowx",
-          "kind": "analyze",
-          "serviceId": "knowx-retrieval-index",
-          "dependsOn": [
-            "write-knowx"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            },
-            {
-              "fromStep": "write-knowx",
-              "key": "write-knowx"
-            }
-          ],
-          "notes": "POST /v1/candidates for associate + /v1/index/upsert (knowx.knowledge). Soft-skip only when MEMORIX_RETRIEVAL_URL unset; when set, remote failures hard-fail."
-        },
-        {
-          "id": "nexum",
-          "kind": "analyze",
-          "serviceId": "knowx-nexum",
-          "dependsOn": [
-            "index-knowx"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            },
-            {
-              "fromStep": "write-knowx",
-              "key": "write-knowx"
-            }
-          ],
-          "notes": "KnowX mapper POSTs Nexum analyze (proposedGraph). Soft-skip only when MEMORIX_NEXUM_URL unset; when set, remote failures hard-fail. Platform write-record mode nexum persists proposedGraph."
-        },
-        {
-          "id": "write-graph",
-          "kind": "write-record",
-          "contentType": "snapshots",
-          "portConfig": {
-            "mode": "nexum"
+          "profile": { "allowSnapshotBuckets": true }
+        },
+        {
+          "id": "discovery",
+          "discriminator": {
+            "path": "data.discoveryType",
+            "required": false
           },
-          "dependsOn": [
-            "nexum"
-          ],
-          "inputs": [
-            {
-              "fromStep": "nexum",
-              "key": "nexum"
-            }
-          ],
-          "notes": "mode nexum — create-or-update proposedGraph as content/snapshots. Empty plan when companion soft-skips is a no-op success."
-        },
-        {
-          "id": "associate-knowledge",
-          "kind": "analyze",
-          "serviceId": "knowx-associate-knowledge",
-          "dependsOn": [
-            "index-knowx",
-            "write-graph"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            },
-            {
-              "fromStep": "index-knowx",
-              "key": "index-knowx"
-            }
-          ]
-        },
-        {
-          "id": "write-knowledge-links",
-          "kind": "relationship-write",
-          "dependsOn": [
-            "associate-knowledge"
-          ],
-          "inputs": [
-            {
-              "fromStep": "associate-knowledge",
-              "key": "associate-knowledge"
-            }
-          ],
-          "notes": "Consumes relationshipPlans → knowx-same-as / knowx-supports / knowx-contradicts / knowx-derived-from"
-        },
-        {
-          "id": "associate-entities",
-          "kind": "analyze",
-          "serviceId": "knowx-associate-entities",
-          "dependsOn": [
-            "write-knowledge-links"
-          ],
-          "inputs": [
-            {
-              "fromStep": "associate-knowledge",
-              "key": "associate-knowledge"
-            }
-          ]
-        },
-        {
-          "id": "write-entity-links",
-          "kind": "relationship-write",
-          "dependsOn": [
-            "associate-entities"
-          ],
-          "inputs": [
-            {
-              "fromStep": "associate-entities",
-              "key": "associate-entities"
-            }
-          ],
-          "notes": "Consumes entityRelationshipPlans → knowx-edge-from / knowx-edge-to"
-        }
-      ]
-    },
-    {
-      "id": "knowx-ingest-content-source",
-      "name": "Folder connector ingest then derive knowledge",
-      "trigger": "explicit",
-      "description": "knowx-folder-pull → promote-content → index-snapshots (CRS knowx.snapshot) → extract → write knowx → index-knowx (CRS candidates + knowx.knowledge) → nexum (proposedGraph) → write-graph (mode nexum) → associate-knowledge → relationship-write → associate-entities → relationship-write.",
-      "steps": [
-        {
-          "id": "folder-pull",
-          "kind": "analyze",
-          "serviceId": "knowx-folder-pull"
-        },
-        {
-          "id": "promote-content",
-          "kind": "analyze",
-          "serviceId": "knowx-promote-content",
-          "dependsOn": [
-            "folder-pull"
-          ],
-          "inputs": [
-            {
-              "fromStep": "folder-pull",
-              "key": "folder-pull"
-            }
-          ]
-        },
-        {
-          "id": "index-snapshots",
-          "kind": "analyze",
-          "serviceId": "knowx-retrieval-index",
-          "dependsOn": [
-            "promote-content"
-          ],
-          "inputs": [
-            {
-              "fromStep": "promote-content",
-              "key": "promote-content"
-            }
-          ],
-          "notes": "Index Content snapshots only (knowx.snapshot; no knowxDrafts → no candidates). Soft-skip when CRS unset/down."
-        },
-        {
-          "id": "extract",
-          "kind": "analyze",
-          "serviceId": "knowx-extract",
-          "dependsOn": [
-            "index-snapshots"
-          ],
-          "inputs": [
-            {
-              "fromStep": "promote-content",
-              "key": "promote-content"
-            }
-          ]
-        },
-        {
-          "id": "write-knowx",
-          "kind": "write-record",
-          "contentType": "knowx",
-          "dependsOn": [
-            "extract"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            }
-          ]
-        },
-        {
-          "id": "index-knowx",
-          "kind": "analyze",
-          "serviceId": "knowx-retrieval-index",
-          "dependsOn": [
-            "write-knowx"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            },
-            {
-              "fromStep": "write-knowx",
-              "key": "write-knowx"
-            },
-            {
-              "fromStep": "promote-content",
-              "key": "promote-content"
-            }
-          ],
-          "notes": "POST /v1/candidates for associate + upsert knowx + re-touch snapshots."
-        },
-        {
-          "id": "nexum",
-          "kind": "analyze",
-          "serviceId": "knowx-nexum",
-          "dependsOn": [
-            "index-knowx"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            },
-            {
-              "fromStep": "write-knowx",
-              "key": "write-knowx"
-            },
-            {
-              "fromStep": "promote-content",
-              "key": "promote-content"
-            }
-          ],
-          "notes": "KnowX mapper POSTs Nexum analyze from promote + extract bags. Soft-skip when MEMORIX_NEXUM_URL unset; when set, remote failures hard-fail. write-graph persists proposedGraph."
-        },
-        {
-          "id": "write-graph",
-          "kind": "write-record",
-          "contentType": "snapshots",
-          "portConfig": {
-            "mode": "nexum"
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "analysis",
+          "discriminator": {
+            "path": "data.analysisType",
+            "required": false,
+            "defaultValue": "delivery-risk"
           },
-          "dependsOn": [
-            "nexum"
-          ],
-          "inputs": [
-            {
-              "fromStep": "nexum",
-              "key": "nexum"
-            }
-          ],
-          "notes": "mode nexum — create-or-update proposedGraph as content/snapshots."
-        },
-        {
-          "id": "associate-knowledge",
-          "kind": "analyze",
-          "serviceId": "knowx-associate-knowledge",
-          "dependsOn": [
-            "index-knowx",
-            "write-graph"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            },
-            {
-              "fromStep": "write-knowx",
-              "key": "write-knowx"
-            },
-            {
-              "fromStep": "index-knowx",
-              "key": "index-knowx"
-            }
-          ]
-        },
-        {
-          "id": "write-knowledge-links",
-          "kind": "relationship-write",
-          "dependsOn": [
-            "associate-knowledge"
-          ],
-          "inputs": [
-            {
-              "fromStep": "associate-knowledge",
-              "key": "associate-knowledge"
-            }
-          ],
-          "notes": "Consumes relationshipPlans including knowx-derived-from-content"
-        },
-        {
-          "id": "associate-entities",
-          "kind": "analyze",
-          "serviceId": "knowx-associate-entities",
-          "dependsOn": [
-            "write-knowledge-links"
-          ],
-          "inputs": [
-            {
-              "fromStep": "associate-knowledge",
-              "key": "associate-knowledge"
-            },
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            }
-          ]
-        },
-        {
-          "id": "write-entity-links",
-          "kind": "relationship-write",
-          "dependsOn": [
-            "associate-entities"
-          ],
-          "inputs": [
-            {
-              "fromStep": "associate-entities",
-              "key": "associate-entities"
-            }
-          ],
-          "notes": "Consumes entityRelationshipPlans → knowx-edge-from / knowx-edge-to"
-        }
-      ]
-    },
-    {
-      "id": "knowx-ingest-managed-item",
-      "name": "Managed Drive item ingest then derive knowledge",
-      "trigger": "explicit",
-      "description": "knowx-managed-pull → promote-content → index-snapshots (CRS) → extract → write knowx → index-knowx (CRS candidates + upsert) → nexum (proposedGraph) → write-graph (mode nexum) → associate-knowledge → relationship-write → associate-entities → relationship-write.",
-      "steps": [
-        {
-          "id": "managed-pull",
-          "kind": "analyze",
-          "serviceId": "knowx-managed-pull"
-        },
-        {
-          "id": "promote-content",
-          "kind": "analyze",
-          "serviceId": "knowx-promote-content",
-          "dependsOn": [
-            "managed-pull"
-          ],
-          "inputs": [
-            {
-              "fromStep": "managed-pull",
-              "key": "managed-pull"
-            }
-          ]
-        },
-        {
-          "id": "index-snapshots",
-          "kind": "analyze",
-          "serviceId": "knowx-retrieval-index",
-          "dependsOn": [
-            "promote-content"
-          ],
-          "inputs": [
-            {
-              "fromStep": "promote-content",
-              "key": "promote-content"
-            }
-          ],
-          "notes": "Index Content snapshots only (knowx.snapshot; no knowxDrafts → no candidates). Soft-skip when CRS unset/down."
-        },
-        {
-          "id": "extract",
-          "kind": "analyze",
-          "serviceId": "knowx-extract",
-          "dependsOn": [
-            "index-snapshots"
-          ],
-          "inputs": [
-            {
-              "fromStep": "promote-content",
-              "key": "promote-content"
-            }
-          ]
-        },
-        {
-          "id": "write-knowx",
-          "kind": "write-record",
-          "contentType": "knowx",
-          "dependsOn": [
-            "extract"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            }
-          ]
-        },
-        {
-          "id": "index-knowx",
-          "kind": "analyze",
-          "serviceId": "knowx-retrieval-index",
-          "dependsOn": [
-            "write-knowx"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            },
-            {
-              "fromStep": "write-knowx",
-              "key": "write-knowx"
-            },
-            {
-              "fromStep": "promote-content",
-              "key": "promote-content"
-            }
-          ],
-          "notes": "POST /v1/candidates for associate + upsert knowx + re-touch snapshots."
-        },
-        {
-          "id": "nexum",
-          "kind": "analyze",
-          "serviceId": "knowx-nexum",
-          "dependsOn": [
-            "index-knowx"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            },
-            {
-              "fromStep": "write-knowx",
-              "key": "write-knowx"
-            },
-            {
-              "fromStep": "promote-content",
-              "key": "promote-content"
-            }
-          ],
-          "notes": "KnowX mapper POSTs Nexum analyze from promote + extract bags. Soft-skip when MEMORIX_NEXUM_URL unset; when set, remote failures hard-fail. write-graph persists proposedGraph."
-        },
-        {
-          "id": "write-graph",
-          "kind": "write-record",
-          "contentType": "snapshots",
-          "portConfig": {
-            "mode": "nexum"
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "decisions",
+          "discriminator": {
+            "path": "data.decisionType",
+            "required": false,
+            "defaultValue": "priority"
           },
-          "dependsOn": [
-            "nexum"
-          ],
-          "inputs": [
-            {
-              "fromStep": "nexum",
-              "key": "nexum"
-            }
-          ],
-          "notes": "mode nexum — create-or-update proposedGraph as content/snapshots."
-        },
-        {
-          "id": "associate-knowledge",
-          "kind": "analyze",
-          "serviceId": "knowx-associate-knowledge",
-          "dependsOn": [
-            "index-knowx",
-            "write-graph"
-          ],
-          "inputs": [
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            },
-            {
-              "fromStep": "write-knowx",
-              "key": "write-knowx"
-            },
-            {
-              "fromStep": "index-knowx",
-              "key": "index-knowx"
-            }
-          ]
-        },
-        {
-          "id": "write-knowledge-links",
-          "kind": "relationship-write",
-          "dependsOn": [
-            "associate-knowledge"
-          ],
-          "inputs": [
-            {
-              "fromStep": "associate-knowledge",
-              "key": "associate-knowledge"
-            }
-          ],
-          "notes": "Consumes relationshipPlans including knowx-derived-from-content"
-        },
-        {
-          "id": "associate-entities",
-          "kind": "analyze",
-          "serviceId": "knowx-associate-entities",
-          "dependsOn": [
-            "write-knowledge-links"
-          ],
-          "inputs": [
-            {
-              "fromStep": "associate-knowledge",
-              "key": "associate-knowledge"
-            },
-            {
-              "fromStep": "extract",
-              "key": "extract"
-            }
-          ]
-        },
-        {
-          "id": "write-entity-links",
-          "kind": "relationship-write",
-          "dependsOn": [
-            "associate-entities"
-          ],
-          "inputs": [
-            {
-              "fromStep": "associate-entities",
-              "key": "associate-entities"
-            }
-          ],
-          "notes": "Consumes entityRelationshipPlans → knowx-edge-from / knowx-edge-to"
-        }
-      ]
-    }
-  ],
-  "schedules": [],
-  "kindDeclarations": [],
-  "extensions": {}
-}
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "workflow",
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "context",
+          "retention": "work-scoped-ttl",
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "relationships",
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "knowx",
+          "notes": "KnowX NODE facet — provenance required in .data",
+          "profile": { "allowSnapshotBuckets": false }
+        }
+      ],
+      "snapshotBuckets": {
+        "analytics": "optional",
+        "enrichment": "optional",
+        "insights": "optional"
+      },
+      "fields": [
+        {
+          "path": "data.title",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.status",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.priority",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.assigneeId",
+          "valueType": "recordId",
+          "contentType": "snapshots",
+          "refersTo": {
+            "objectType": "people"
+          }
+        }
+      ]
+    },
+    {
+      "id": "content",
+      "name": "Content",
+      "dataCategory": "knowledge",
+      "abstractTypes": [
+        "Content"
+      ],
+      "notes": "Ingested documents (raw/snapshots) plus free-floating KnowX knowledge items (knowx NODE/EDGE with own recordId). Nexum apply-plan records use nexum-* object types. Entity NODE facets stay on people/work-items.",
+      "contentTypes": [
+        {
+          "id": "raw",
+          "required": true,
+          "requiredReason": "Exact provider-native land from knowx-folder / knowx-rest connectors; ingest identity depends on it.",
+          "notes": "Exact provider-native land from knowx-folder / knowx-rest connectors",
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "snapshots",
+          "required": false,
+          "notes": "Promoted Markdown ContentRecordData via knowx-promote-content (or knowledge-pull promote)",
+          "profile": { "allowSnapshotBuckets": true }
+        },
+        {
+          "id": "knowx",
+          "notes": "Knowledge item payloads — data.kind NODE|EDGE (topology); data.identity.category claim|fact|opinion|assumption (AI classifier, orthogonal to kind); data.epistemic.state is review standing (≠ identity.category); provenance mandatory. EDGE and content-derived items use their own recordId.",
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "nexum",
+          "required": false,
+          "notes": "Optional Nexum snapshot facet; durable apply-plan kinds use nexum-* object types",
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "workflow",
+          "notes": "Human review assignment sibling for knowledge items",
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "confirmations",
+          "notes": "Accept/reject decision sibling for knowledge items",
+          "profile": { "allowSnapshotBuckets": false }
+        },
+        {
+          "id": "relationships",
+          "notes": "Content↔Knowledge lineage and knowledge links",
+          "profile": { "allowSnapshotBuckets": false }
+        }
+      ],
+      "fields": [
+        {
+          "path": "data.title",
+          "valueType": "string",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.markdown",
+          "valueType": "string",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.contentHash",
+          "valueType": "string",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.sourceFormat",
+          "valueType": "string",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.sourceMediaType",
+          "valueType": "string",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.byteSize",
+          "valueType": "number",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.language",
+          "valueType": "string",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.state",
+          "valueType": "string",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.revision",
+          "valueType": "number",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.extraction.extractorId",
+          "valueType": "string",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.extraction.extractorVersion",
+          "valueType": "string",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.extraction.extractedAt",
+          "valueType": "datetime",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.origins",
+          "valueType": "array",
+          "contentType": "raw"
+        },
+        {
+          "path": "data.nav.derivedKnowledge",
+          "valueType": "array",
+          "contentType": "relationships"
+        }
+      ]
+    }
+  ],
+  "abstractTypes": [
+    {
+      "id": "People",
+      "name": "People",
+      "meaning": "People who perform operational work — inside the org (employeeId) or outside (externalPersonId), distinguished by identity kind",
+      "category": "entity",
+      "properties": [
+        {
+          "id": "title",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "role",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "lens",
+          "valueType": "string",
+          "required": false
+        },
+        {
+          "id": "email",
+          "valueType": "string",
+          "required": false
+        },
+        {
+          "id": "organization",
+          "valueType": "string",
+          "required": false
+        },
+        {
+          "id": "contentEdgesFrom",
+          "valueType": "array",
+          "required": false
+        }
+      ],
+      "members": [
+        {
+          "objectType": "people",
+          "contentType": "snapshots",
+          "properties": [
+            {
+              "abstractProperty": "title",
+              "contentType": "snapshots",
+              "propertyPath": "data.title",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "role",
+              "contentType": "snapshots",
+              "propertyPath": "data.role",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "lens",
+              "contentType": "snapshots",
+              "propertyPath": "data.lens",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "email",
+              "contentType": "snapshots",
+              "propertyPath": "data.email",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "organization",
+              "contentType": "snapshots",
+              "propertyPath": "data.organization",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "contentEdgesFrom",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.contentEdgesFrom"
+            }
+          ]
+        }
+      ],
+      "union": false,
+      "notes": "People abstract ↔ people OT 1:1. Identity kind employeeId | externalPersonId distinguishes inside/outside org."
+    },
+    {
+      "id": "WorkItems",
+      "name": "Work Items",
+      "meaning": "Units of operational work",
+      "category": "entity",
+      "properties": [
+        {
+          "id": "title",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "status",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "priority",
+          "valueType": "string",
+          "required": false
+        },
+        {
+          "id": "contentEdgesTo",
+          "valueType": "array",
+          "required": false
+        }
+      ],
+      "members": [
+        {
+          "objectType": "work-items",
+          "contentType": "snapshots",
+          "properties": [
+            {
+              "abstractProperty": "title",
+              "contentType": "snapshots",
+              "propertyPath": "data.title",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "status",
+              "contentType": "snapshots",
+              "propertyPath": "data.status",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "priority",
+              "contentType": "snapshots",
+              "propertyPath": "data.priority",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "contentEdgesTo",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.contentEdgesTo"
+            }
+          ]
+        }
+      ],
+      "union": false
+    },
+    {
+      "id": "Content",
+      "name": "Content",
+      "meaning": "Canonical ingested documents and derived knowledge items (Markdown + provenance). Knowledge claims are derived from content; content is the source of claims, not the claims themselves.",
+      "category": "knowledge",
+      "properties": [
+        {
+          "id": "title",
+          "valueType": "string",
+          "required": false
+        },
+        {
+          "id": "markdown",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "contentHash",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "sourceFormat",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "sourceMediaType",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "byteSize",
+          "valueType": "number",
+          "required": true
+        },
+        {
+          "id": "language",
+          "valueType": "string",
+          "required": false
+        },
+        {
+          "id": "state",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "revision",
+          "valueType": "number",
+          "required": true
+        },
+        {
+          "id": "extractorId",
+          "valueType": "string",
+          "required": false
+        },
+        {
+          "id": "extractorVersion",
+          "valueType": "string",
+          "required": false
+        },
+        {
+          "id": "extractedAt",
+          "valueType": "datetime",
+          "required": false
+        },
+        {
+          "id": "origins",
+          "valueType": "array",
+          "required": false
+        },
+        {
+          "id": "derivedKnowledge",
+          "valueType": "array",
+          "required": false
+        },
+        {
+          "id": "sameAs",
+          "valueType": "array",
+          "required": false
+        },
+        {
+          "id": "supports",
+          "valueType": "array",
+          "required": false
+        },
+        {
+          "id": "supportedBy",
+          "valueType": "array",
+          "required": false
+        },
+        {
+          "id": "contradicts",
+          "valueType": "array",
+          "required": false
+        },
+        {
+          "id": "contradictedBy",
+          "valueType": "array",
+          "required": false
+        },
+        {
+          "id": "derivedFrom",
+          "valueType": "array",
+          "required": false
+        },
+        {
+          "id": "derivedClaims",
+          "valueType": "array",
+          "required": false
+        },
+        {
+          "id": "derivedFromContent",
+          "valueType": "array",
+          "required": false
+        },
+        {
+          "id": "edgeFrom",
+          "valueType": "array",
+          "required": false
+        },
+        {
+          "id": "edgeTo",
+          "valueType": "array",
+          "required": false
+        }
+      ],
+      "members": [
+        {
+          "objectType": "content",
+          "contentType": "raw",
+          "properties": [
+            {
+              "abstractProperty": "title",
+              "contentType": "raw",
+              "propertyPath": "data.title"
+            },
+            {
+              "abstractProperty": "markdown",
+              "contentType": "raw",
+              "propertyPath": "data.markdown"
+            },
+            {
+              "abstractProperty": "contentHash",
+              "contentType": "raw",
+              "propertyPath": "data.contentHash"
+            },
+            {
+              "abstractProperty": "sourceFormat",
+              "contentType": "raw",
+              "propertyPath": "data.sourceFormat"
+            },
+            {
+              "abstractProperty": "sourceMediaType",
+              "contentType": "raw",
+              "propertyPath": "data.sourceMediaType"
+            },
+            {
+              "abstractProperty": "byteSize",
+              "contentType": "raw",
+              "propertyPath": "data.byteSize"
+            },
+            {
+              "abstractProperty": "language",
+              "contentType": "raw",
+              "propertyPath": "data.language"
+            },
+            {
+              "abstractProperty": "state",
+              "contentType": "raw",
+              "propertyPath": "data.state"
+            },
+            {
+              "abstractProperty": "revision",
+              "contentType": "raw",
+              "propertyPath": "data.revision"
+            },
+            {
+              "abstractProperty": "extractorId",
+              "contentType": "raw",
+              "propertyPath": "data.extraction.extractorId"
+            },
+            {
+              "abstractProperty": "extractorVersion",
+              "contentType": "raw",
+              "propertyPath": "data.extraction.extractorVersion"
+            },
+            {
+              "abstractProperty": "extractedAt",
+              "contentType": "raw",
+              "propertyPath": "data.extraction.extractedAt"
+            },
+            {
+              "abstractProperty": "origins",
+              "contentType": "raw",
+              "propertyPath": "data.origins"
+            },
+            {
+              "abstractProperty": "derivedKnowledge",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.derivedKnowledge"
+            },
+            {
+              "abstractProperty": "sameAs",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.sameAs"
+            },
+            {
+              "abstractProperty": "supports",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.supports"
+            },
+            {
+              "abstractProperty": "supportedBy",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.supportedBy"
+            },
+            {
+              "abstractProperty": "contradicts",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.contradicts"
+            },
+            {
+              "abstractProperty": "contradictedBy",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.contradictedBy"
+            },
+            {
+              "abstractProperty": "derivedFrom",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.derivedFrom"
+            },
+            {
+              "abstractProperty": "derivedClaims",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.derivedClaims"
+            },
+            {
+              "abstractProperty": "derivedFromContent",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.derivedFromContent"
+            },
+            {
+              "abstractProperty": "edgeFrom",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.edgeFrom"
+            },
+            {
+              "abstractProperty": "edgeTo",
+              "contentType": "relationships",
+              "propertyPath": "data.nav.edgeTo"
+            }
+          ]
+        }
+      ],
+      "union": false,
+      "notes": "Content abstract ↔ content OT. Domain noun — not product-branded. Documents (raw/snapshots) and derived knowledge items (knowx) share this abstract; writers always target concrete content types on the OT."
+    }
+  ],
+  "relationshipDefinitions": [
+    {
+      "id": "knowx-same-as",
+      "name": "Same as",
+      "meaning": "Two knowledge claims refer to the same underlying assertion",
+      "directionality": "undirected",
+      "from": {
+        "abstractType": "Content",
+        "path": "sameAs"
+      },
+      "to": {
+        "abstractType": "Content",
+        "path": "sameAs"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-associate-plan",
+          "kind": "service-plan",
+          "notes": "Materialized from knowx-associate-knowledge relationshipPlans"
+        }
+      ]
+    },
+    {
+      "id": "knowx-supports",
+      "name": "Supports",
+      "meaning": "One knowledge claim supports another",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "Content",
+        "path": "supports"
+      },
+      "to": {
+        "abstractType": "Content",
+        "path": "supportedBy"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-associate-plan",
+          "kind": "service-plan",
+          "notes": "Materialized from knowx-associate-knowledge relationshipPlans"
+        }
+      ]
+    },
+    {
+      "id": "knowx-contradicts",
+      "name": "Contradicts",
+      "meaning": "Two knowledge claims contradict each other",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "Content",
+        "path": "contradicts"
+      },
+      "to": {
+        "abstractType": "Content",
+        "path": "contradictedBy"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-associate-plan",
+          "kind": "service-plan",
+          "notes": "Materialized from knowx-associate-knowledge relationshipPlans"
+        }
+      ]
+    },
+    {
+      "id": "knowx-derived-from",
+      "name": "Derived from claim",
+      "meaning": "A knowledge claim is derived from another knowledge claim",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "Content",
+        "path": "derivedFrom"
+      },
+      "to": {
+        "abstractType": "Content",
+        "path": "derivedClaims"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-associate-plan",
+          "kind": "service-plan",
+          "notes": "Materialized from knowx-associate-knowledge relationshipPlans"
+        }
+      ]
+    },
+    {
+      "id": "knowx-derived-from-content",
+      "name": "Derived from content",
+      "meaning": "A knowledge claim is derived from ingested content",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "Content",
+        "path": "derivedFromContent"
+      },
+      "to": {
+        "abstractType": "Content",
+        "path": "derivedKnowledge"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-associate-plan",
+          "kind": "service-plan",
+          "notes": "Materialized from knowx-associate-knowledge when provenance.lineage.sourceContentId is present"
+        }
+      ]
+    },
+    {
+      "id": "knowx-edge-from",
+      "name": "Edge from",
+      "meaning": "A knowledge EDGE claim starts at an entity",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "Content",
+        "path": "edgeFrom"
+      },
+      "to": {
+        "abstractType": "People",
+        "path": "contentEdgesFrom"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-associate-entities-plan",
+          "kind": "service-plan",
+          "notes": "Materialized from knowx-associate-entities entityRelationshipPlans"
+        }
+      ]
+    },
+    {
+      "id": "knowx-edge-to",
+      "name": "Edge to",
+      "meaning": "A knowledge EDGE claim ends at an entity",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "Content",
+        "path": "edgeTo"
+      },
+      "to": {
+        "abstractType": "WorkItems",
+        "path": "contentEdgesTo"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-associate-entities-plan",
+          "kind": "service-plan",
+          "notes": "Materialized from knowx-associate-entities entityRelationshipPlans"
+        }
+      ]
+    }
+  ],
+  "mappings": [],
+  "views": [],
+  "writes": [],
+  "sources": [
+    {
+      "id": "knowx-source",
+      "name": "Knowledge source",
+      "kind": "rest",
+      "baseUrlEnv": "KNOWX_SOURCE_URL",
+      "defaultBaseUrl": "http://127.0.0.1:5104",
+      "credentialRef": "knowx-source-local",
+      "connectorRef": "knowx-rest",
+      "endpoints": [
+        "/content"
+      ],
+      "pagination": {
+        "style": "cursor",
+        "defaultPageSize": 50
+      },
+      "streams": [
+        {
+          "streamId": "content",
+          "endpoint": "/content",
+          "objectType": "content",
+          "dataCategory": "knowledge",
+          "identityPath": "id",
+          "modes": [
+            "knowledge"
+          ],
+          "pageSize": 10,
+          "checkpoint": {
+            "method": "cursor"
+          }
+        }
+      ],
+      "routes": [
+        {
+          "endpoint": "/content",
+          "objectType": "content",
+          "dataCategory": "knowledge",
+          "identityPath": "id",
+          "primaryKind": "contentId",
+          "modes": [
+            "knowledge"
+          ],
+          "pageSize": 10,
+          "checkpoint": {
+            "method": "cursor"
+          }
+        }
+      ]
+    },
+    {
+      "id": "knowx-managed",
+      "name": "Knowledge Drive (managed)",
+      "kind": "knowx-managed",
+      "connectorRef": "knowx-managed",
+      "endpoints": [
+        "/items"
+      ],
+      "pagination": {
+        "style": "page",
+        "defaultPageSize": 25
+      },
+      "streams": [
+        {
+          "streamId": "items",
+          "endpoint": "/items",
+          "objectType": "content",
+          "dataCategory": "knowledge",
+          "identityPath": "id",
+          "modes": [
+            "knowledge"
+          ],
+          "pageSize": 25,
+          "checkpoint": {
+            "method": "cursor"
+          }
+        }
+      ],
+      "routes": [
+        {
+          "endpoint": "/items",
+          "objectType": "content",
+          "dataCategory": "knowledge",
+          "identityPath": "id",
+          "primaryKind": "contentId",
+          "modes": [
+            "knowledge"
+          ],
+          "pageSize": 25,
+          "checkpoint": {
+            "method": "cursor"
+          }
+        }
+      ]
+    }
+  ],
+  "services": [
+    {
+      "id": "knowx-folder-pull",
+      "name": "Folder connector pull",
+      "description": "Runs the remote-hosted knowx-folder defineConnector (collectStream + fullScanHash). Lands exact file raw only — does not extract Markdown or derive knowledge. Connector-adjacent worker — not agent vocabulary.",
+      "role": "connector",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [
+        "raw",
+        "checkpoints"
+      ],
+      "inputs": [
+        {
+          "id": "sourceId",
+          "control": true,
+          "description": "Managed folder ContentSource id"
+        },
+        {
+          "id": "relativePath",
+          "control": true,
+          "description": "Optional single relative path for targeted ingest"
+        },
+        {
+          "id": "triggerReason",
+          "control": true,
+          "description": "manual | scheduled | watch | delete"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "pullSummary",
+          "control": true,
+          "description": "Pull status, discovered counts, rawItemIds"
+        },
+        {
+          "id": "rawItemIds",
+          "control": true,
+          "description": "Relative-path identities landed as content/raw"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-folder-pull"
+      }
+    },
+    {
+      "id": "knowx-managed-pull",
+      "name": "Managed drive pull",
+      "description": "Runs the remote-hosted knowx-managed defineConnector over managed upload events / item versions. Lands exact bytes as content/raw via collectStream. Connector-adjacent worker — not agent vocabulary.",
+      "role": "connector",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [
+        "raw",
+        "checkpoints"
+      ],
+      "inputs": [
+        {
+          "id": "itemIds",
+          "control": true,
+          "description": "Managed Knowledge Drive item ids to pull"
+        },
+        {
+          "id": "eventCursor",
+          "control": true,
+          "description": "Optional managed event cursor"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "pullSummary",
+          "control": true,
+          "description": "Pull status and counts"
+        },
+        {
+          "id": "rawItemIds",
+          "control": true,
+          "description": "Managed item identities landed as content/raw"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-managed-pull"
+      }
+    },
+    {
+      "id": "knowx-promote-content",
+      "name": "Promote content",
+      "description": "Reads landed content/raw file envelopes, runs format→Markdown extractors, writes Content snapshots. Connector-pipeline step — promotes concrete raw onto the Content abstract member.",
+      "role": "connector",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [
+        "raw",
+        "explore"
+      ],
+      "inputs": [
+        {
+          "id": "sourceId",
+          "control": true,
+          "description": "Managed folder source id"
+        },
+        {
+          "id": "rawItemIds",
+          "control": true,
+          "description": "Raw identities from knowx-folder-pull"
+        },
+        {
+          "id": "pullSummary",
+          "control": true,
+          "description": "Optional pull summary carrying rawItemIds"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "contentDrafts",
+          "abstractType": "Content",
+          "description": "Canonical ContentRecordData drafts on Content"
+        },
+        {
+          "id": "contentIds",
+          "abstractType": "Content",
+          "description": "Promoted Content record ids"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-promote-content"
+      }
+    },
+    {
+      "id": "knowx-extract",
+      "name": "Extract knowledge",
+      "description": "Extract NODE/EDGE knowledge-item drafts from Content (text + knowledge source, or promoted content). Each draft includes data.identity.category (claim|fact|opinion|assumption). Returns drafts only — does not persist. Pipeline write-record applies knowx content. When aiService is bound and AI_SKILLS_URL is set, Memorix invokes Catalox skill knowx.extract via ai-services/1. Fallback: pack worker; test-only KNOWX_AI_SIM=1 routes to APS AI sim (:5112).",
+      "role": "agent",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [
+        "explore"
+      ],
+      "inputs": [
+        {
+          "id": "text",
+          "control": true,
+          "description": "Input text to analyze (inline string or resolved from Content)"
+        },
+        {
+          "id": "knowledgeSource",
+          "abstractType": "Content",
+          "description": "Exact source bytes / provenance envelope for Content"
+        },
+        {
+          "id": "contentId",
+          "abstractType": "Content",
+          "description": "Promoted Content record id — open via Explore"
+        },
+        {
+          "id": "contentIds",
+          "abstractType": "Content",
+          "description": "Batch of promoted Content ids"
+        },
+        {
+          "id": "contentDrafts",
+          "abstractType": "Content",
+          "description": "In-pipeline ContentRecordData from knowx-promote-content"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "knowxDrafts",
+          "abstractType": "Content",
+          "description": "Array of knowx knowledge-item drafts (NODE/EDGE + data.identity.category claim|fact|opinion|assumption) with mandatory provenance and content lineage"
+        }
+      ],
+      "aiService": {
+        "aiServiceType": "skill",
+        "itemId": "knowx.extract",
+        "endpointEnv": "AI_SKILLS_URL"
+      },
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-extract",
+        "endpointEnv": "KNOWX_EXTRACT_WORKER_URL",
+        "notes": "Worker fallback when AI_SKILLS_URL unset / compile cannot resolve skill origin. KNOWX_EXTRACT_WORKER_URL honored only when KNOWX_AI_SIM=1 (test-only)."
+      }
+    },
+    {
+      "id": "knowx-retrieval-index",
+      "name": "Index / candidates (candidate-retrieval)",
+      "description": "Companion step for @x12i/candidate-retrival-service (MEMORIX_RETRIEVAL_URL, default local :6560). (1) POST /v1/candidates for open knowx drafts so associate sees corpus-scale priors, (2) POST /v1/index/upsert for knowx drafts (knowx.knowledge) and Content snapshots (knowx.snapshot). Soft-skips only when URL unset; when URL is set, remote failures hard-fail the step — associate then receives real CRS priors.",
+      "role": "agent",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [],
+      "inputs": [
+        {
+          "id": "knowxDrafts",
+          "abstractType": "Content",
+          "description": "Drafts from knowx-extract / write path (candidates + upsert)"
+        },
+        {
+          "id": "contentDrafts",
+          "abstractType": "Content",
+          "description": "Optional Content snapshot drafts from knowx-promote-content (knowx.snapshot upsert)"
+        },
+        {
+          "id": "fetchCandidates",
+          "control": true,
+          "description": "When false, index only (no /v1/candidates). Default true when knowxDrafts present."
+        }
+      ],
+      "outputs": [
+        {
+          "id": "existingKnowx",
+          "abstractType": "Content",
+          "description": "Ranked prior knowx from /v1/candidates for associate (self-ids excluded)"
+        },
+        {
+          "id": "retrieval",
+          "control": true,
+          "description": "enabled / upserted / warnings for ops"
+        },
+        {
+          "id": "indexedRecordIds",
+          "control": true,
+          "description": "recordId / contentId list submitted for upsert"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-retrieval-index",
+        "notes": "Requires MEMORIX_RETRIEVAL_URL (or CANDIDATE_RETRIEVAL_URL) pointing at the candidate-retrieval companion."
+      }
+    },
+    {
+      "id": "knowx-nexum",
+      "name": "Knowledge graph analyze (Nexum)",
+      "description": "KnowX control-plane adapter for @x12i/nexum (MEMORIX_NEXUM_URL, default local :7500). Maps KnowX pipeline bags (extract/promote/write) to Nexum items[], POSTs memorix-capability/1 analyze (serviceId nexum), returns proposedGraph. Soft-skips only when URL unset; when URL is set (or MEMORIX_NEXUM_REQUIRED=1), companion failures hard-fail. Persistence is platform write-record mode nexum after this step. Explore view: createKnowxNexumExploreClient (NEXUM_API_URL · :8080).",
+      "role": "agent",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [],
+      "inputs": [
+        {
+          "id": "knowxDrafts",
+          "abstractType": "Content",
+          "description": "Drafts from knowx-extract / write path (structured items for Nexum)"
+        },
+        {
+          "id": "contentDrafts",
+          "abstractType": "Content",
+          "description": "Optional Content snapshot drafts from knowx-promote-content"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "apply-plan",
+          "control": true,
+          "description": "x12i-nexum/1 replace-contribution / remove-contribution apply plan (not applied by this step)"
+        },
+        {
+          "id": "nexum",
+          "control": true,
+          "description": "enabled / itemCount / warnings for ops"
+        },
+        {
+          "id": "diagnostics",
+          "control": true,
+          "description": "Remote worker diagnostics"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "analyze",
+        "notes": "KnowX control-plane adapter (serviceId knowx-nexum — not nexum). Maps bags then POSTs to nexum-worker via MEMORIX_NEXUM_URL (alias NEXUM_URL). Compile must not treat this id as serviceId nexum. Explore REST uses MEMORIX_NEXUM_READ_URL + createKnowxNexumExploreClient."
+      }
+    },
+    {
+      "id": "knowx-associate-knowledge",
+      "name": "Associate knowledge",
+      "description": "Classify extracted drafts against existing Content scope: known, novel, contradicts. Prefer existingKnowx from knowx-retrieval-index (/v1/candidates). When aiService is bound, Memorix invokes Catalox skill knowx.associate-knowledge and may also push explore/catalog. Worker fallback uses pushed existingKnowx or Explore list. Returns classification buckets + candidate knowledge relationship plans. Does not persist.",
+      "role": "agent",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [
+        "explore"
+      ],
+      "inputs": [
+        {
+          "id": "knowxDrafts",
+          "abstractType": "Content",
+          "description": "Drafts from knowx-extract"
+        },
+        {
+          "id": "existingKnowx",
+          "abstractType": "Content",
+          "description": "Optional: pipeline output from knowx-retrieval-index, fixtures, or Explore push"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "classification",
+          "abstractType": "Content",
+          "description": "known / novel / contradicts buckets"
+        },
+        {
+          "id": "relationshipPlans",
+          "abstractType": "Content",
+          "description": "Candidate knowledge relationship plans on Content"
+        }
+      ],
+      "aiService": {
+        "aiServiceType": "skill",
+        "itemId": "knowx.associate-knowledge",
+        "endpointEnv": "AI_SKILLS_URL"
+      },
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-associate-knowledge",
+        "notes": "Worker fallback when AI_SKILLS_URL unset / compile cannot resolve skill origin."
+      }
+    },
+    {
+      "id": "knowx-associate-entities",
+      "name": "Associate entities",
+      "description": "Plan EDGE endpoint relationships for novel drafts against entity abstracts (People, WorkItems) and Content. Does not persist.",
+      "role": "agent",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [
+        "explore"
+      ],
+      "inputs": [
+        {
+          "id": "novelDrafts",
+          "abstractType": "Content",
+          "description": "Novel drafts from associate-knowledge classification"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "entityRelationshipPlans",
+          "abstractType": "People",
+          "description": "EDGE endpoint relationship plans toward People, WorkItems, and Content abstracts"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-associate-entities"
+      }
+    }
+  ],
+  "pipelines": [
+    {
+      "id": "knowx-knowledge-pull",
+      "name": "Scheduled knowledge pull from knowx-source",
+      "trigger": "scheduled",
+      "mode": "knowledge",
+      "description": "Memory pull from knowx-source fixture (CF knowx-rest). Promote/extract are separate pipelines.",
+      "steps": [
+        {
+          "id": "pull",
+          "kind": "memory-pull",
+          "sourceId": "knowx-source"
+        }
+      ]
+    },
+    {
+      "id": "knowx-ingest-associate",
+      "name": "Ingest then associate knowledge and entities",
+      "trigger": "explicit",
+      "description": "extract → write knowx → retrieval-index (candidate-retrieval upsert + candidates) → nexum (proposedGraph) → write-graph (mode nexum persist) → associate-knowledge → relationship-write → associate-entities → relationship-write. Services do not persist; write-record and relationship-write do.",
+      "steps": [
+        {
+          "id": "extract",
+          "kind": "analyze",
+          "serviceId": "knowx-extract"
+        },
+        {
+          "id": "write-knowx",
+          "kind": "write-record",
+          "contentType": "knowx",
+          "dependsOn": [
+            "extract"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            }
+          ]
+        },
+        {
+          "id": "index-knowx",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            }
+          ],
+          "notes": "POST /v1/candidates for associate + /v1/index/upsert (knowx.knowledge). Soft-skip only when MEMORIX_RETRIEVAL_URL unset; when set, remote failures hard-fail."
+        },
+        {
+          "id": "nexum",
+          "kind": "analyze",
+          "serviceId": "knowx-nexum",
+          "dependsOn": [
+            "index-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            }
+          ],
+          "notes": "KnowX mapper POSTs Nexum analyze (proposedGraph). Soft-skip only when MEMORIX_NEXUM_URL unset; when set, remote failures hard-fail. Platform write-record mode nexum persists proposedGraph."
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "snapshots",
+          "portConfig": {
+            "mode": "nexum"
+          },
+          "dependsOn": [
+            "nexum"
+          ],
+          "inputs": [
+            {
+              "fromStep": "nexum",
+              "key": "nexum"
+            }
+          ],
+          "notes": "mode nexum — create-or-update proposedGraph as content/snapshots. Empty plan when companion soft-skips is a no-op success."
+        },
+        {
+          "id": "associate-knowledge",
+          "kind": "analyze",
+          "serviceId": "knowx-associate-knowledge",
+          "dependsOn": [
+            "index-knowx",
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "index-knowx",
+              "key": "index-knowx"
+            }
+          ]
+        },
+        {
+          "id": "write-knowledge-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "associate-knowledge"
+          ],
+          "inputs": [
+            {
+              "fromStep": "associate-knowledge",
+              "key": "associate-knowledge"
+            }
+          ],
+          "notes": "Consumes relationshipPlans → knowx-same-as / knowx-supports / knowx-contradicts / knowx-derived-from"
+        },
+        {
+          "id": "associate-entities",
+          "kind": "analyze",
+          "serviceId": "knowx-associate-entities",
+          "dependsOn": [
+            "write-knowledge-links"
+          ],
+          "inputs": [
+            {
+              "fromStep": "associate-knowledge",
+              "key": "associate-knowledge"
+            }
+          ]
+        },
+        {
+          "id": "write-entity-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "associate-entities"
+          ],
+          "inputs": [
+            {
+              "fromStep": "associate-entities",
+              "key": "associate-entities"
+            }
+          ],
+          "notes": "Consumes entityRelationshipPlans → knowx-edge-from / knowx-edge-to"
+        }
+      ]
+    },
+    {
+      "id": "knowx-ingest-content-source",
+      "name": "Folder connector ingest then derive knowledge",
+      "trigger": "explicit",
+      "description": "knowx-folder-pull → promote-content → index-snapshots (CRS knowx.snapshot) → extract → write knowx → index-knowx (CRS candidates + knowx.knowledge) → nexum (proposedGraph) → write-graph (mode nexum) → associate-knowledge → relationship-write → associate-entities → relationship-write.",
+      "steps": [
+        {
+          "id": "folder-pull",
+          "kind": "analyze",
+          "serviceId": "knowx-folder-pull"
+        },
+        {
+          "id": "promote-content",
+          "kind": "analyze",
+          "serviceId": "knowx-promote-content",
+          "dependsOn": [
+            "folder-pull"
+          ],
+          "inputs": [
+            {
+              "fromStep": "folder-pull",
+              "key": "folder-pull"
+            }
+          ]
+        },
+        {
+          "id": "index-snapshots",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "promote-content"
+          ],
+          "inputs": [
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "Index Content snapshots only (knowx.snapshot; no knowxDrafts → no candidates). Soft-skip when CRS unset/down."
+        },
+        {
+          "id": "extract",
+          "kind": "analyze",
+          "serviceId": "knowx-extract",
+          "dependsOn": [
+            "index-snapshots"
+          ],
+          "inputs": [
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ]
+        },
+        {
+          "id": "write-knowx",
+          "kind": "write-record",
+          "contentType": "knowx",
+          "dependsOn": [
+            "extract"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            }
+          ]
+        },
+        {
+          "id": "index-knowx",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "POST /v1/candidates for associate + upsert knowx + re-touch snapshots."
+        },
+        {
+          "id": "nexum",
+          "kind": "analyze",
+          "serviceId": "knowx-nexum",
+          "dependsOn": [
+            "index-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "KnowX mapper POSTs Nexum analyze from promote + extract bags. Soft-skip when MEMORIX_NEXUM_URL unset; when set, remote failures hard-fail. write-graph persists proposedGraph."
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "snapshots",
+          "portConfig": {
+            "mode": "nexum"
+          },
+          "dependsOn": [
+            "nexum"
+          ],
+          "inputs": [
+            {
+              "fromStep": "nexum",
+              "key": "nexum"
+            }
+          ],
+          "notes": "mode nexum — create-or-update proposedGraph as content/snapshots."
+        },
+        {
+          "id": "associate-knowledge",
+          "kind": "analyze",
+          "serviceId": "knowx-associate-knowledge",
+          "dependsOn": [
+            "index-knowx",
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "index-knowx",
+              "key": "index-knowx"
+            }
+          ]
+        },
+        {
+          "id": "write-knowledge-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "associate-knowledge"
+          ],
+          "inputs": [
+            {
+              "fromStep": "associate-knowledge",
+              "key": "associate-knowledge"
+            }
+          ],
+          "notes": "Consumes relationshipPlans including knowx-derived-from-content"
+        },
+        {
+          "id": "associate-entities",
+          "kind": "analyze",
+          "serviceId": "knowx-associate-entities",
+          "dependsOn": [
+            "write-knowledge-links"
+          ],
+          "inputs": [
+            {
+              "fromStep": "associate-knowledge",
+              "key": "associate-knowledge"
+            },
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            }
+          ]
+        },
+        {
+          "id": "write-entity-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "associate-entities"
+          ],
+          "inputs": [
+            {
+              "fromStep": "associate-entities",
+              "key": "associate-entities"
+            }
+          ],
+          "notes": "Consumes entityRelationshipPlans → knowx-edge-from / knowx-edge-to"
+        }
+      ]
+    },
+    {
+      "id": "knowx-ingest-managed-item",
+      "name": "Managed Drive item ingest then derive knowledge",
+      "trigger": "explicit",
+      "description": "knowx-managed-pull → promote-content → index-snapshots (CRS) → extract → write knowx → index-knowx (CRS candidates + upsert) → nexum (proposedGraph) → write-graph (mode nexum) → associate-knowledge → relationship-write → associate-entities → relationship-write.",
+      "steps": [
+        {
+          "id": "managed-pull",
+          "kind": "analyze",
+          "serviceId": "knowx-managed-pull"
+        },
+        {
+          "id": "promote-content",
+          "kind": "analyze",
+          "serviceId": "knowx-promote-content",
+          "dependsOn": [
+            "managed-pull"
+          ],
+          "inputs": [
+            {
+              "fromStep": "managed-pull",
+              "key": "managed-pull"
+            }
+          ]
+        },
+        {
+          "id": "index-snapshots",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "promote-content"
+          ],
+          "inputs": [
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "Index Content snapshots only (knowx.snapshot; no knowxDrafts → no candidates). Soft-skip when CRS unset/down."
+        },
+        {
+          "id": "extract",
+          "kind": "analyze",
+          "serviceId": "knowx-extract",
+          "dependsOn": [
+            "index-snapshots"
+          ],
+          "inputs": [
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ]
+        },
+        {
+          "id": "write-knowx",
+          "kind": "write-record",
+          "contentType": "knowx",
+          "dependsOn": [
+            "extract"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            }
+          ]
+        },
+        {
+          "id": "index-knowx",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "POST /v1/candidates for associate + upsert knowx + re-touch snapshots."
+        },
+        {
+          "id": "nexum",
+          "kind": "analyze",
+          "serviceId": "knowx-nexum",
+          "dependsOn": [
+            "index-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "KnowX mapper POSTs Nexum analyze from promote + extract bags. Soft-skip when MEMORIX_NEXUM_URL unset; when set, remote failures hard-fail. write-graph persists proposedGraph."
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "snapshots",
+          "portConfig": {
+            "mode": "nexum"
+          },
+          "dependsOn": [
+            "nexum"
+          ],
+          "inputs": [
+            {
+              "fromStep": "nexum",
+              "key": "nexum"
+            }
+          ],
+          "notes": "mode nexum — create-or-update proposedGraph as content/snapshots."
+        },
+        {
+          "id": "associate-knowledge",
+          "kind": "analyze",
+          "serviceId": "knowx-associate-knowledge",
+          "dependsOn": [
+            "index-knowx",
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "index-knowx",
+              "key": "index-knowx"
+            }
+          ]
+        },
+        {
+          "id": "write-knowledge-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "associate-knowledge"
+          ],
+          "inputs": [
+            {
+              "fromStep": "associate-knowledge",
+              "key": "associate-knowledge"
+            }
+          ],
+          "notes": "Consumes relationshipPlans including knowx-derived-from-content"
+        },
+        {
+          "id": "associate-entities",
+          "kind": "analyze",
+          "serviceId": "knowx-associate-entities",
+          "dependsOn": [
+            "write-knowledge-links"
+          ],
+          "inputs": [
+            {
+              "fromStep": "associate-knowledge",
+              "key": "associate-knowledge"
+            },
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            }
+          ]
+        },
+        {
+          "id": "write-entity-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "associate-entities"
+          ],
+          "inputs": [
+            {
+              "fromStep": "associate-entities",
+              "key": "associate-entities"
+            }
+          ],
+          "notes": "Consumes entityRelationshipPlans → knowx-edge-from / knowx-edge-to"
+        }
+      ]
+    }
+  ],
+  "schedules": [],
+  "kindDeclarations": [],
+  "extensions": {}
+}