@x12i/memorix-metadata 3.2.0 → 3.2.1

package/examples/knowx/normalized/pack.json

@@ -1119,10 +1119,108 @@
         "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 when URL unset or companion down — associate then falls back to Explore.",
+      "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-graphify",
+      "name": "Knowledge graph analyze (graphifier)",
+      "description": "Adapter for @x12i/memorix-graphifier (MEMORIX_GRAPHIFIER_URL, default local :7500). Maps KnowX pipeline bags (extract/promote/write) to graphifier items[], POSTs memorix-capability/1 analyze, returns graphDraft/patchPlan. Soft-skips when URL unset or companion down unless MEMORIX_GRAPHIFIER_REQUIRED=1. Persistence is platform write-record (create-or-update) after this step.",
+      "role": "agent",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [],
+      "inputs": [
+        {
+          "id": "knowxDrafts",
+          "abstractType": "Content",
+          "description": "Drafts from knowx-extract / write path (structured items for graphifier)"
+        },
+        {
+          "id": "contentDrafts",
+          "abstractType": "Content",
+          "description": "Optional Content snapshot drafts from knowx-promote-content"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "graphDraft",
+          "control": true,
+          "description": "Deterministic nodes/edges draft from memorix-graphifier"
+        },
+        {
+          "id": "patchPlan",
+          "control": true,
+          "description": "Graph patch plan + sourceRefs (not applied by this step)"
+        },
+        {
+          "id": "graphify",
+          "control": true,
+          "description": "enabled / itemCount / warnings for ops"
+        },
+        {
+          "id": "diagnostics",
+          "control": true,
+          "description": "Remote worker diagnostics"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-graphify",
+        "notes": "KnowX control-plane adapter; remote target is memorix-graphifier via MEMORIX_GRAPHIFIER_URL (alias GRAPHIFIER_URL)."
+      }
+    },
     {
       "id": "knowx-associate-knowledge",
       "name": "Associate knowledge",
-      "description": "Classify extracted drafts against existing Content scope: known, novel, contradicts. When aiService is bound, Memorix invokes Catalox skill knowx.associate-knowledge and pushes existingKnowx from Explore. Worker fallback fetches via memorix callback or accepts pushed existingKnowx. Returns classification buckets + candidate knowledge relationship plans. Does not persist.",
+      "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"
@@ -1139,7 +1237,7 @@
         {
           "id": "existingKnowx",
           "abstractType": "Content",
-          "description": "Optional pushed existing Content for offline/fixture runs"
+          "description": "Optional: pipeline output from knowx-retrieval-index, fixtures, or Explore push"
         }
       ],
       "outputs": [
@@ -1215,7 +1313,7 @@
       "id": "knowx-ingest-associate",
       "name": "Ingest then associate knowledge and entities",
       "trigger": "explicit",
-      "description": "extract → write knowx → associate-knowledge → relationship-write → associate-entities → relationship-write. Services do not persist; write-record and relationship-write do.",
+      "description": "extract → write knowx → retrieval-index (candidate-retrieval upsert + candidates) → graphify (memorix-graphifier draft) → write-graph (persist) → write-graph-links + index-graph → associate-knowledge → relationship-write → associate-entities → relationship-write. Services do not persist; write-record and relationship-write do.",
       "steps": [
         {
           "id": "extract",
@@ -1236,17 +1334,111 @@
             }
           ]
         },
+        {
+          "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 when MEMORIX_RETRIEVAL_URL unset."
+        },
+        {
+          "id": "graphify",
+          "kind": "analyze",
+          "serviceId": "knowx-graphify",
+          "dependsOn": [
+            "index-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            }
+          ],
+          "notes": "Remote memorix-graphifier analyze (graphDraft/patchPlan). Soft-skip when MEMORIX_GRAPHIFIER_URL unset/down. Platform write-record applies the draft."
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "snapshots",
+          "portConfig": {
+            "mode": "graphifier",
+            "objectType": "content",
+            "contentType": "snapshots",
+            "edgeDefinitionId": "knowx-derived-from"
+          },
+          "dependsOn": [
+            "graphify"
+          ],
+          "inputs": [
+            {
+              "fromStep": "graphify",
+              "key": "graphify"
+            }
+          ],
+          "notes": "Applies memorix-graphifier patchPlan/graphDraft (mode graphifier) → content/snapshots Knowledge graph artifact. Empty graph when companion soft-skips is a no-op success."
+        },
+        {
+          "id": "write-graph-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "Materializes graphDraft.edges as relationshipPlans when endpoints resolve to sourceRefs/recordIds (from write-graph)."
+        },
+        {
+          "id": "index-graph",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "CRS knowx.snapshot upsert for knowledge-graph contentDrafts from write-graph. Soft-skip when CRS unset/down."
+        },
         {
           "id": "associate-knowledge",
           "kind": "analyze",
           "serviceId": "knowx-associate-knowledge",
           "dependsOn": [
-            "write-knowx"
+            "index-knowx",
+            "write-graph-links",
+            "index-graph"
           ],
           "inputs": [
             {
               "fromStep": "extract",
               "key": "extract"
+            },
+            {
+              "fromStep": "index-knowx",
+              "key": "index-knowx"
             }
           ]
         },
@@ -1298,7 +1490,7 @@
       "id": "knowx-ingest-content-source",
       "name": "Folder connector ingest then derive knowledge",
       "trigger": "explicit",
-      "description": "knowx-folder-pull (exact raw via CF collectStream) → knowx-promote-content (format→Markdown snapshots) → knowx-extract → write knowx → associate-knowledge → relationship-write → associate-entities → relationship-write.",
+      "description": "knowx-folder-pull → promote-content → index-snapshots (CRS knowx.snapshot) → extract → write knowx → index-knowx (CRS candidates + knowx.knowledge) → graphify (memorix-graphifier) → write-graph → write-graph-links + index-graph → associate-knowledge → relationship-write → associate-entities → relationship-write.",
       "steps": [
         {
           "id": "folder-pull",
@@ -1319,12 +1511,27 @@
             }
           ]
         },
+        {
+          "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": [
-            "promote-content"
+            "index-snapshots"
           ],
           "inputs": [
             {
@@ -1347,12 +1554,110 @@
             }
           ]
         },
+        {
+          "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": "graphify",
+          "kind": "analyze",
+          "serviceId": "knowx-graphify",
+          "dependsOn": [
+            "index-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "Remote memorix-graphifier analyze from promote + extract bags. Soft-skip when graphifier unset/down. write-graph applies draft."
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "snapshots",
+          "portConfig": {
+            "mode": "graphifier",
+            "objectType": "content",
+            "contentType": "snapshots",
+            "edgeDefinitionId": "knowx-derived-from"
+          },
+          "dependsOn": [
+            "graphify"
+          ],
+          "inputs": [
+            {
+              "fromStep": "graphify",
+              "key": "graphify"
+            }
+          ],
+          "notes": "Applies memorix-graphifier patchPlan/graphDraft (mode graphifier) → content/snapshots graph artifact."
+        },
+        {
+          "id": "write-graph-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "Materializes graphDraft.edges as relationshipPlans when endpoints resolve to sourceRefs/recordIds (from write-graph)."
+        },
+        {
+          "id": "index-graph",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "CRS knowx.snapshot upsert for knowledge-graph contentDrafts from write-graph. Soft-skip when CRS unset/down."
+        },
         {
           "id": "associate-knowledge",
           "kind": "analyze",
           "serviceId": "knowx-associate-knowledge",
           "dependsOn": [
-            "write-knowx"
+            "index-knowx",
+            "write-graph-links",
+            "index-graph"
           ],
           "inputs": [
             {
@@ -1362,6 +1667,10 @@
             {
               "fromStep": "write-knowx",
               "key": "write-knowx"
+            },
+            {
+              "fromStep": "index-knowx",
+              "key": "index-knowx"
             }
           ]
         },
@@ -1417,7 +1726,7 @@
       "id": "knowx-ingest-managed-item",
       "name": "Managed Drive item ingest then derive knowledge",
       "trigger": "explicit",
-      "description": "knowx-managed-pull (exact raw via CF collectStream) → knowx-promote-content → knowx-extract → write knowx → associate-knowledge → relationship-write → associate-entities → relationship-write.",
+      "description": "knowx-managed-pull → promote-content → index-snapshots (CRS) → extract → write knowx → index-knowx (CRS candidates + upsert) → graphify (memorix-graphifier) → write-graph → write-graph-links + index-graph → associate-knowledge → relationship-write → associate-entities → relationship-write.",
       "steps": [
         {
           "id": "managed-pull",
@@ -1438,12 +1747,27 @@
             }
           ]
         },
+        {
+          "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": [
-            "promote-content"
+            "index-snapshots"
           ],
           "inputs": [
             {
@@ -1466,12 +1790,110 @@
             }
           ]
         },
+        {
+          "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": "graphify",
+          "kind": "analyze",
+          "serviceId": "knowx-graphify",
+          "dependsOn": [
+            "index-knowx"
+          ],
+          "inputs": [
+            {
+              "fromStep": "extract",
+              "key": "extract"
+            },
+            {
+              "fromStep": "write-knowx",
+              "key": "write-knowx"
+            },
+            {
+              "fromStep": "promote-content",
+              "key": "promote-content"
+            }
+          ],
+          "notes": "Remote memorix-graphifier analyze from promote + extract bags. Soft-skip when graphifier unset/down. write-graph applies draft."
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "snapshots",
+          "portConfig": {
+            "mode": "graphifier",
+            "objectType": "content",
+            "contentType": "snapshots",
+            "edgeDefinitionId": "knowx-derived-from"
+          },
+          "dependsOn": [
+            "graphify"
+          ],
+          "inputs": [
+            {
+              "fromStep": "graphify",
+              "key": "graphify"
+            }
+          ],
+          "notes": "Applies memorix-graphifier patchPlan/graphDraft (mode graphifier) → content/snapshots graph artifact."
+        },
+        {
+          "id": "write-graph-links",
+          "kind": "relationship-write",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "Materializes graphDraft.edges as relationshipPlans when endpoints resolve to sourceRefs/recordIds (from write-graph)."
+        },
+        {
+          "id": "index-graph",
+          "kind": "analyze",
+          "serviceId": "knowx-retrieval-index",
+          "dependsOn": [
+            "write-graph"
+          ],
+          "inputs": [
+            {
+              "fromStep": "write-graph",
+              "key": "write-graph"
+            }
+          ],
+          "notes": "CRS knowx.snapshot upsert for knowledge-graph contentDrafts from write-graph. Soft-skip when CRS unset/down."
+        },
         {
           "id": "associate-knowledge",
           "kind": "analyze",
           "serviceId": "knowx-associate-knowledge",
           "dependsOn": [
-            "write-knowx"
+            "index-knowx",
+            "write-graph-links",
+            "index-graph"
           ],
           "inputs": [
             {
@@ -1481,6 +1903,10 @@
             {
               "fromStep": "write-knowx",
               "key": "write-knowx"
+            },
+            {
+              "fromStep": "index-knowx",
+              "key": "index-knowx"
             }
           ]
         },

package/examples/opx/normalized/pack.json

@@ -28,7 +28,7 @@
       "abstractTypes": [
         "People"
       ],
-      "notes": "Single people OT. Inside vs outside org is identity kind (concept.identifiers.primary.kind): employeeId | externalPersonId \u2014 not separate object types.",
+      "notes": "Single people OT. Inside vs outside org is identity kind (concept.identifiers.primary.kind): employeeId | externalPersonId — not separate object types.",
       "contentTypes": [
         {
           "id": "raw",
@@ -60,6 +60,36 @@
           "id": "relationships",
           "notes": "Candidate store shape until Gate G4"
         }
+      ],
+      "fields": [
+        {
+          "path": "data.displayName",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.role",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.email",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.organization",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.collaboratorIds",
+          "valueType": "array",
+          "contentType": "snapshots",
+          "refersTo": {
+            "objectType": "people"
+          }
+        }
       ]
     },
     {
@@ -114,7 +144,48 @@
         "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"
+          }
+        },
+        {
+          "path": "data.playbookIds",
+          "valueType": "array",
+          "contentType": "snapshots",
+          "refersTo": {
+            "objectType": "playbooks"
+          }
+        },
+        {
+          "path": "data.dependsOnIds",
+          "valueType": "array",
+          "contentType": "snapshots",
+          "refersTo": {
+            "objectType": "work-items"
+          }
+        }
+      ]
     },
     {
       "id": "playbooks",
@@ -135,7 +206,24 @@
           "id": "relationships"
         }
       ],
-      "retention": "persistent-knowledge"
+      "retention": "persistent-knowledge",
+      "fields": [
+        {
+          "path": "data.name",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.body",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.contentHash",
+          "valueType": "string",
+          "contentType": "snapshots"
+        }
+      ]
     },
     {
       "id": "activity-events",
@@ -155,6 +243,195 @@
         {
           "id": "relationships"
         }
+      ],
+      "fields": [
+        {
+          "path": "data.type",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.message",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.occurredAt",
+          "valueType": "datetime",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.workItemId",
+          "valueType": "recordId",
+          "contentType": "snapshots",
+          "refersTo": {
+            "objectType": "work-items"
+          }
+        },
+        {
+          "path": "data.actorId",
+          "valueType": "recordId",
+          "contentType": "snapshots",
+          "refersTo": {
+            "objectType": "people"
+          }
+        }
+      ]
+    },
+    {
+      "id": "content",
+      "name": "Content",
+      "dataCategory": "knowledge",
+      "abstractTypes": [
+        "KnowledgeArtifacts"
+      ],
+      "notes": "Knowledge graph snapshots and Nexum apply-plan records (write-record mode nexum)",
+      "contentTypes": [
+        {
+          "id": "raw"
+        },
+        {
+          "id": "snapshots",
+          "required": false,
+          "notes": "Knowledge-graph and other snapshot artififacts (data.kind: knowledge-graph)"
+        },
+        {
+          "id": "nexum",
+          "required": false,
+          "notes": "Optional Nexum snapshot facet; durable apply-plan kinds use nexum-* object types"
+        },
+        {
+          "id": "relationships"
+        }
+      ],
+      "fields": [
+        {
+          "path": "concept.title",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.title",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.kind",
+          "valueType": "string",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.graphDraft",
+          "valueType": "object",
+          "contentType": "snapshots"
+        },
+        {
+          "path": "data.patchPlan",
+          "valueType": "object",
+          "contentType": "snapshots"
+        }
+      ]
+    },
+    {
+      "id": "nexum-contribution",
+      "name": "Nexum contribution",
+      "dataCategory": "knowledge",
+      "notes": "Per-source contribution envelope (write-record mode nexum). Adapter kind nexum.contribution/v1.",
+      "contentTypes": [
+        {
+          "id": "nexum"
+        }
+      ],
+      "fields": [
+        {
+          "path": "data.op",
+          "valueType": "string",
+          "contentType": "nexum"
+        },
+        {
+          "path": "data.kind",
+          "valueType": "string",
+          "contentType": "nexum"
+        },
+        {
+          "path": "data.idempotencyKey",
+          "valueType": "string",
+          "contentType": "nexum"
+        }
+      ]
+    },
+    {
+      "id": "nexum-node",
+      "name": "Nexum node",
+      "dataCategory": "knowledge",
+      "notes": "Evidence-graph node (write-record mode nexum). Adapter kind nexum.node/v1.",
+      "contentTypes": [
+        {
+          "id": "nexum"
+        }
+      ],
+      "fields": [
+        {
+          "path": "data.nodeId",
+          "valueType": "string",
+          "contentType": "nexum"
+        },
+        {
+          "path": "data.kind",
+          "valueType": "string",
+          "contentType": "nexum"
+        }
+      ]
+    },
+    {
+      "id": "nexum-node-claim",
+      "name": "Nexum node claim",
+      "dataCategory": "knowledge",
+      "notes": "Property claim on a node (write-record mode nexum). Adapter kind nexum.node-claim/v1.",
+      "contentTypes": [
+        {
+          "id": "nexum"
+        }
+      ],
+      "fields": [
+        {
+          "path": "data.claimId",
+          "valueType": "string",
+          "contentType": "nexum"
+        },
+        {
+          "path": "data.kind",
+          "valueType": "string",
+          "contentType": "nexum"
+        }
+      ]
+    },
+    {
+      "id": "nexum-edge-claim",
+      "name": "Nexum edge claim",
+      "dataCategory": "knowledge",
+      "notes": "Edge claim (write-record mode nexum). Adapter kind nexum.edge-claim/v1.",
+      "contentTypes": [
+        {
+          "id": "nexum"
+        }
+      ],
+      "fields": [
+        {
+          "path": "data.claimId",
+          "valueType": "string",
+          "contentType": "nexum"
+        },
+        {
+          "path": "data.edgeId",
+          "valueType": "string",
+          "contentType": "nexum"
+        },
+        {
+          "path": "data.kind",
+          "valueType": "string",
+          "contentType": "nexum"
+        }
       ]
     }
   ],
@@ -162,7 +439,7 @@
     {
       "id": "People",
       "name": "People",
-      "meaning": "People who perform operational work \u2014 inside the org (employeeId) or outside (externalPersonId), distinguished by identity kind",
+      "meaning": "People who perform operational work — inside the org (employeeId) or outside (externalPersonId), distinguished by identity kind",
       "category": "entity",
       "properties": [
         {
@@ -225,7 +502,7 @@
         }
       ],
       "union": false,
-      "notes": "People abstract \u2194 people OT 1:1. Inside/outside org is concept.identifiers.primary.kind (employeeId | externalPersonId), not a second OT."
+      "notes": "People abstract ↔ people OT 1:1. Inside/outside org is concept.identifiers.primary.kind (employeeId | externalPersonId), not a second OT."
     },
     {
       "id": "WorkItems",
@@ -398,6 +675,35 @@
         }
       ],
       "union": false
+    },
+    {
+      "id": "KnowledgeArtifacts",
+      "name": "Knowledge Artifacts",
+      "meaning": "Structured knowledge graphs and snapshot bags produced by analyze workers (Nexum)",
+      "category": "knowledge",
+      "properties": [
+        {
+          "id": "title",
+          "valueType": "string",
+          "required": false
+        }
+      ],
+      "members": [
+        {
+          "objectType": "content",
+          "contentType": "snapshots",
+          "properties": [
+            {
+              "abstractProperty": "title",
+              "contentType": "snapshots",
+              "propertyPath": "concept.title",
+              "concreteValueType": "string"
+            }
+          ]
+        }
+      ],
+      "union": false,
+      "notes": "Used by nexum service ports; durable apply-plan kinds use nexum-* object types (content/snapshots remains the KnowledgeArtifacts member)"
     }
   ],
   "relationshipDefinitions": [
@@ -874,7 +1180,7 @@
     {
       "id": "opx-enrich-priority",
       "name": "Enrich work-item priority",
-      "description": "Deterministic priority score draft for WorkItems. Returns a patch plan \u2014 does not persist. Pipeline write-record applies the revision-safe mutation on the concrete member.",
+      "description": "Deterministic priority score draft for WorkItems. Returns a patch plan — does not persist. Pipeline write-record applies the revision-safe mutation on the concrete member.",
       "role": "agent",
       "capabilities": [
         "enrich"
@@ -899,6 +1205,39 @@
         "kind": "worker",
         "operation": "enrich-priority"
       }
+    },
+    {
+      "id": "nexum",
+      "name": "Nexum analyze",
+      "description": "Deterministic evidence-graph draft and per-item apply plan from @x12i/memorix-nexum-adapter (zone nexum · worker :7500 · MEMORIX_NEXUM_URL). Successor to Graphifier — Memorix does not support the Graphifier worker or write-record mode graphifier. Does not persist. Pipeline write-record mode nexum applies contributions.",
+      "role": "agent",
+      "capabilities": [
+        "analyze"
+      ],
+      "memorixAccess": [
+        "explore"
+      ],
+      "inputs": [
+        {
+          "id": "snapshot",
+          "abstractType": "KnowledgeArtifacts",
+          "path": "snapshots",
+          "description": "KnowledgeArtifacts projection or NexumAnalyzeRequest items"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "apply-plan",
+          "abstractType": "KnowledgeArtifacts",
+          "path": "snapshots",
+          "description": "x12i-nexum/1 graph draft and replace-contribution apply plan"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "analyze",
+        "endpointEnv": "MEMORIX_NEXUM_URL"
+      }
     }
   ],
   "pipelines": [
@@ -1007,7 +1346,7 @@
       "id": "opx-enrich-priority",
       "name": "Enrich WI priority (draft then write)",
       "trigger": "explicit",
-      "description": "Capture snapshot \u2192 enrich service (opx-enrich-priority) \u2192 write-record. Runtime v2 uses stepKind enrich + serviceId.",
+      "description": "Capture snapshot → enrich service (opx-enrich-priority) → write-record. Runtime v2 uses stepKind enrich + serviceId.",
       "steps": [
         {
           "id": "enrich",
@@ -1020,6 +1359,37 @@
           "contentType": "snapshots"
         }
       ]
+    },
+    {
+      "id": "opx-nexum-analyze",
+      "name": "Nexum analyze + write-record",
+      "trigger": "explicit",
+      "description": "Invoke @x12i/memorix-nexum-adapter analyze (MEMORIX_NEXUM_URL · default :7500), then platform write-record applies applyPlan (mode nexum). Worker drafts; Memorix persists. Nexum is the knowledge-graph analyze path (Graphifier is not supported).",
+      "steps": [
+        {
+          "id": "analyze",
+          "kind": "analyze",
+          "serviceId": "nexum"
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "nexum",
+          "portConfig": {
+            "mode": "nexum"
+          },
+          "dependsOn": [
+            "analyze"
+          ],
+          "inputs": [
+            {
+              "fromStep": "analyze",
+              "key": "analyze"
+            }
+          ],
+          "notes": "mode nexum — create-or-update contribution/node/claim records from applyPlan"
+        }
+      ]
     }
   ],
   "schedules": [],

package/examples/opx/raw/pipelines-and-sources.json

@@ -118,6 +118,37 @@
           "contentType": "snapshots"
         }
       ]
+    },
+    {
+      "id": "opx-nexum-analyze",
+      "name": "Nexum analyze + write-record",
+      "trigger": "explicit",
+      "description": "Invoke @x12i/memorix-nexum-adapter analyze (MEMORIX_NEXUM_URL · default :7500), then platform write-record applies applyPlan (mode nexum). Worker drafts; Memorix persists. Nexum is the knowledge-graph analyze path (Graphifier is not supported).",
+      "steps": [
+        {
+          "id": "analyze",
+          "kind": "analyze",
+          "serviceId": "nexum"
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "nexum",
+          "portConfig": {
+            "mode": "nexum"
+          },
+          "dependsOn": [
+            "analyze"
+          ],
+          "inputs": [
+            {
+              "fromStep": "analyze",
+              "key": "analyze"
+            }
+          ],
+          "notes": "mode nexum — create-or-update contribution/node/claim records from applyPlan"
+        }
+      ]
     }
   ],
   "sources": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/memorix-metadata",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "Canonical Memorix metadata contracts, effective multi-agent resolution, and metadata-only abstract unions (Phase 3).",
   "type": "module",
   "main": "./dist/index.js",