@x12i/memorix-metadata 3.2.1 → 3.2.3

package/examples/knowx/normalized/pack.json

@@ -174,7 +174,7 @@
       "abstractTypes": [
         "Content"
       ],
-      "notes": "Ingested documents (raw/snapshots) plus free-floating KnowX knowledge items (knowx NODE/EDGE with own recordId). Entity NODE facets stay on people/work-items.",
+      "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",
@@ -191,6 +191,11 @@
           "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"
@@ -1122,7 +1127,7 @@
     {
       "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.",
+      "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"
@@ -1169,9 +1174,9 @@
       }
     },
     {
-      "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.",
+      "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"
@@ -1181,7 +1186,7 @@
         {
           "id": "knowxDrafts",
           "abstractType": "Content",
-          "description": "Drafts from knowx-extract / write path (structured items for graphifier)"
+          "description": "Drafts from knowx-extract / write path (structured items for Nexum)"
         },
         {
           "id": "contentDrafts",
@@ -1191,17 +1196,12 @@
       ],
       "outputs": [
         {
-          "id": "graphDraft",
+          "id": "apply-plan",
           "control": true,
-          "description": "Deterministic nodes/edges draft from memorix-graphifier"
+          "description": "x12i-nexum/1 replace-contribution / remove-contribution apply plan (not applied by this step)"
         },
         {
-          "id": "patchPlan",
-          "control": true,
-          "description": "Graph patch plan + sourceRefs (not applied by this step)"
-        },
-        {
-          "id": "graphify",
+          "id": "nexum",
           "control": true,
           "description": "enabled / itemCount / warnings for ops"
         },
@@ -1213,8 +1213,8 @@
       ],
       "invocation": {
         "kind": "worker",
-        "operation": "knowx-graphify",
-        "notes": "KnowX control-plane adapter; remote target is memorix-graphifier via MEMORIX_GRAPHIFIER_URL (alias GRAPHIFIER_URL)."
+        "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."
       }
     },
     {
@@ -1313,7 +1313,7 @@
       "id": "knowx-ingest-associate",
       "name": "Ingest then associate knowledge and entities",
       "trigger": "explicit",
-      "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.",
+      "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",
@@ -1351,12 +1351,12 @@
               "key": "write-knowx"
             }
           ],
-          "notes": "POST /v1/candidates for associate + /v1/index/upsert (knowx.knowledge). Soft-skip when MEMORIX_RETRIEVAL_URL unset."
+          "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": "graphify",
+          "id": "nexum",
           "kind": "analyze",
-          "serviceId": "knowx-graphify",
+          "serviceId": "knowx-nexum",
           "dependsOn": [
             "index-knowx"
           ],
@@ -1370,57 +1370,25 @@
               "key": "write-knowx"
             }
           ],
-          "notes": "Remote memorix-graphifier analyze (graphDraft/patchPlan). Soft-skip when MEMORIX_GRAPHIFIER_URL unset/down. Platform write-record applies the draft."
+          "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": "graphifier",
-            "objectType": "content",
-            "contentType": "snapshots",
-            "edgeDefinitionId": "knowx-derived-from"
+            "mode": "nexum"
           },
           "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"
+            "nexum"
           ],
           "inputs": [
             {
-              "fromStep": "write-graph",
-              "key": "write-graph"
+              "fromStep": "nexum",
+              "key": "nexum"
             }
           ],
-          "notes": "CRS knowx.snapshot upsert for knowledge-graph contentDrafts from write-graph. Soft-skip when CRS unset/down."
+          "notes": "mode nexum — create-or-update proposedGraph as content/snapshots. Empty plan when companion soft-skips is a no-op success."
         },
         {
           "id": "associate-knowledge",
@@ -1428,8 +1396,7 @@
           "serviceId": "knowx-associate-knowledge",
           "dependsOn": [
             "index-knowx",
-            "write-graph-links",
-            "index-graph"
+            "write-graph"
           ],
           "inputs": [
             {
@@ -1490,7 +1457,7 @@
       "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) → graphify (memorix-graphifier) → write-graph → write-graph-links + index-graph → 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) → nexum (proposedGraph) → write-graph (mode nexum) → associate-knowledge → relationship-write → associate-entities → relationship-write.",
       "steps": [
         {
           "id": "folder-pull",
@@ -1578,9 +1545,9 @@
           "notes": "POST /v1/candidates for associate + upsert knowx + re-touch snapshots."
         },
         {
-          "id": "graphify",
+          "id": "nexum",
           "kind": "analyze",
-          "serviceId": "knowx-graphify",
+          "serviceId": "knowx-nexum",
           "dependsOn": [
             "index-knowx"
           ],
@@ -1598,57 +1565,25 @@
               "key": "promote-content"
             }
           ],
-          "notes": "Remote memorix-graphifier analyze from promote + extract bags. Soft-skip when graphifier unset/down. write-graph applies draft."
+          "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": "graphifier",
-            "objectType": "content",
-            "contentType": "snapshots",
-            "edgeDefinitionId": "knowx-derived-from"
+            "mode": "nexum"
           },
           "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"
+            "nexum"
           ],
           "inputs": [
             {
-              "fromStep": "write-graph",
-              "key": "write-graph"
+              "fromStep": "nexum",
+              "key": "nexum"
             }
           ],
-          "notes": "CRS knowx.snapshot upsert for knowledge-graph contentDrafts from write-graph. Soft-skip when CRS unset/down."
+          "notes": "mode nexum — create-or-update proposedGraph as content/snapshots."
         },
         {
           "id": "associate-knowledge",
@@ -1656,8 +1591,7 @@
           "serviceId": "knowx-associate-knowledge",
           "dependsOn": [
             "index-knowx",
-            "write-graph-links",
-            "index-graph"
+            "write-graph"
           ],
           "inputs": [
             {
@@ -1726,7 +1660,7 @@
       "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) → graphify (memorix-graphifier) → write-graph → write-graph-links + index-graph → 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) → nexum (proposedGraph) → write-graph (mode nexum) → associate-knowledge → relationship-write → associate-entities → relationship-write.",
       "steps": [
         {
           "id": "managed-pull",
@@ -1814,9 +1748,9 @@
           "notes": "POST /v1/candidates for associate + upsert knowx + re-touch snapshots."
         },
         {
-          "id": "graphify",
+          "id": "nexum",
           "kind": "analyze",
-          "serviceId": "knowx-graphify",
+          "serviceId": "knowx-nexum",
           "dependsOn": [
             "index-knowx"
           ],
@@ -1834,57 +1768,25 @@
               "key": "promote-content"
             }
           ],
-          "notes": "Remote memorix-graphifier analyze from promote + extract bags. Soft-skip when graphifier unset/down. write-graph applies draft."
+          "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": "graphifier",
-            "objectType": "content",
-            "contentType": "snapshots",
-            "edgeDefinitionId": "knowx-derived-from"
+            "mode": "nexum"
           },
           "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"
+            "nexum"
           ],
           "inputs": [
             {
-              "fromStep": "write-graph",
-              "key": "write-graph"
+              "fromStep": "nexum",
+              "key": "nexum"
             }
           ],
-          "notes": "CRS knowx.snapshot upsert for knowledge-graph contentDrafts from write-graph. Soft-skip when CRS unset/down."
+          "notes": "mode nexum — create-or-update proposedGraph as content/snapshots."
         },
         {
           "id": "associate-knowledge",
@@ -1892,8 +1794,7 @@
           "serviceId": "knowx-associate-knowledge",
           "dependsOn": [
             "index-knowx",
-            "write-graph-links",
-            "index-graph"
+            "write-graph"
           ],
           "inputs": [
             {

package/examples/opx/normalized/pack.json

@@ -319,118 +319,6 @@
           "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"
         }
       ]
     }
@@ -1209,7 +1097,7 @@
     {
       "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.",
+      "description": "Deterministic evidence-graph draft and per-item apply plan from @x12i/nexum (zone nexum · worker :7500 · MEMORIX_NEXUM_URL). Does not persist. Pipeline write-record mode nexum applies contributions.",
       "role": "agent",
       "capabilities": [
         "analyze"
@@ -1364,7 +1252,7 @@
       "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).",
+      "description": "Invoke @x12i/nexum analyze (MEMORIX_NEXUM_URL · default :7500), then platform write-record applies proposedGraph (mode nexum). Worker drafts; Memorix persists.",
       "steps": [
         {
           "id": "analyze",
@@ -1374,7 +1262,7 @@
         {
           "id": "write-graph",
           "kind": "write-record",
-          "contentType": "nexum",
+          "contentType": "snapshots",
           "portConfig": {
             "mode": "nexum"
           },
@@ -1387,7 +1275,7 @@
               "key": "analyze"
             }
           ],
-          "notes": "mode nexum — create-or-update contribution/node/claim records from applyPlan"
+          "notes": "mode nexum — create-or-update contribution/node/claim records from proposedGraph"
         }
       ]
     }