@x12i/memorix-metadata 3.1.0 → 3.2.1

package/examples/opx/normalized/pack.json

@@ -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"
+        }
       ]
     }
   ],
@@ -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": [
@@ -673,18 +979,17 @@
     {
       "id": "opx-work-items-list",
       "kind": "list",
-      "objectType": "work-items",
       "title": "Work items",
       "columns": [
         "concept.title",
         "data.status",
         "data.priority"
-      ]
+      ],
+      "abstractType": "WorkItems"
     },
     {
       "id": "opx-work-items-item",
       "kind": "item",
-      "objectType": "work-items",
       "title": "Work item",
       "sections": [
         "concept",
@@ -692,7 +997,8 @@
         "workflow",
         "analysis",
         "decisions"
-      ]
+      ],
+      "abstractType": "WorkItems"
     },
     {
       "id": "opx-people-list",
@@ -708,9 +1014,9 @@
     {
       "id": "opx-work-item-expand-people",
       "kind": "relationship-expansion",
-      "objectType": "work-items",
       "relationshipDefinitionId": "people-assigned-to-work-items",
-      "direction": "to-from"
+      "direction": "to-from",
+      "abstractType": "WorkItems"
     }
   ],
   "writes": [
@@ -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": [
@@ -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/examples/opx/raw/view-definitions.json

@@ -3,14 +3,14 @@
     {
       "id": "opx-work-items-list",
       "kind": "list",
-      "objectType": "work-items",
+      "abstractType": "WorkItems",
       "title": "Work items",
       "columns": ["concept.title", "data.status", "data.priority"]
     },
     {
       "id": "opx-work-items-item",
       "kind": "item",
-      "objectType": "work-items",
+      "abstractType": "WorkItems",
       "title": "Work item",
       "sections": ["concept", "data", "workflow", "analysis", "decisions"]
     },
@@ -24,7 +24,7 @@
     {
       "id": "opx-work-item-expand-people",
       "kind": "relationship-expansion",
-      "objectType": "work-items",
+      "abstractType": "WorkItems",
       "relationshipDefinitionId": "people-assigned-to-work-items",
       "direction": "to-from"
     }

package/examples/project-opx/normalized/pack.json

@@ -674,7 +674,7 @@
     {
       "id": "opx-work-items-list",
       "kind": "list",
-      "objectType": "work-items",
+      "abstractType": "WorkItems",
       "title": "Work items",
       "columns": [
         "concept.title",
@@ -685,7 +685,7 @@
     {
       "id": "opx-work-items-item",
       "kind": "item",
-      "objectType": "work-items",
+      "abstractType": "WorkItems",
       "title": "Work item",
       "sections": [
         "concept",
@@ -709,7 +709,7 @@
     {
       "id": "opx-work-item-expand-people",
       "kind": "relationship-expansion",
-      "objectType": "work-items",
+      "abstractType": "WorkItems",
       "relationshipDefinitionId": "people-assigned-to-work-items",
       "direction": "to-from"
     },
@@ -717,7 +717,7 @@
       "id": "project-opx-work-items-list",
       "kind": "list",
       "title": "Project work items",
-      "objectType": "work-items",
+      "abstractType": "WorkItems",
       "extends": "opx-work-items-list"
     }
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/memorix-metadata",
-  "version": "3.1.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",