@x12i/memorix-metadata 3.2.0 → 3.2.3

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

@@ -1,233 +1,264 @@
-{
-  "pipelineDefinitions": [
-    {
-      "id": "opx-knowledge-pull",
-      "name": "Scheduled knowledge pull from opx-source",
-      "trigger": "scheduled",
-      "mode": "knowledge",
-      "steps": [
-        {
-          "id": "pull",
-          "kind": "memory-pull",
-          "sourceId": "opx-source"
-        },
-        {
-          "id": "land-raw",
-          "kind": "write-raw"
-        },
-        {
-          "id": "normalize",
-          "kind": "normalize"
-        },
-        {
-          "id": "promote",
-          "kind": "promote-snapshots"
-        }
-      ]
-    },
-    {
-      "id": "opx-context-pull",
-      "name": "On-demand work-item context pull",
-      "trigger": "on-demand",
-      "mode": "context",
-      "steps": [
-        {
-          "id": "pull",
-          "kind": "memory-pull",
-          "sourceId": "opx-source"
-        },
-        {
-          "id": "land-raw",
-          "kind": "write-raw"
-        },
-        {
-          "id": "normalize-context",
-          "kind": "normalize-context"
-        },
-        {
-          "id": "ttl",
-          "kind": "apply-ttl"
-        }
-      ]
-    },
-    {
-      "id": "opx-relationship-build",
-      "name": "Discover and write lightweight relationships",
-      "trigger": "explicit",
-      "steps": [
-        {
-          "id": "discover",
-          "kind": "relationship-discover"
-        },
-        {
-          "id": "write",
-          "kind": "relationship-write"
-        },
-        {
-          "id": "verify",
-          "kind": "relationship-verify"
-        }
-      ]
-    },
-    {
-      "id": "opx-analysis",
-      "name": "Work-item analysis sibling",
-      "trigger": "explicit",
-      "steps": [
-        {
-          "id": "analyze",
-          "kind": "analysis"
-        },
-        {
-          "id": "write-sibling",
-          "kind": "write-content",
-          "contentType": "analysis"
-        }
-      ]
-    },
-    {
-      "id": "opx-workflow",
-      "name": "Work-item workflow sibling",
-      "trigger": "explicit",
-      "steps": [
-        {
-          "id": "sync-workflow",
-          "kind": "workflow-sync"
-        },
-        {
-          "id": "write-sibling",
-          "kind": "write-content",
-          "contentType": "workflow"
-        }
-      ]
-    },
-    {
-      "id": "opx-enrich-priority",
-      "name": "Enrich WI priority (draft then write)",
-      "trigger": "explicit",
-      "description": "Capture snapshot → enrich service (opx-enrich-priority) → write-record. Runtime v2 uses stepKind enrich + serviceId.",
-      "steps": [
-        {
-          "id": "enrich",
-          "kind": "enrich",
-          "serviceId": "opx-enrich-priority"
-        },
-        {
-          "id": "write",
-          "kind": "write-record",
-          "contentType": "snapshots"
-        }
-      ]
-    }
-  ],
-  "sources": [
-    {
-      "id": "opx-source",
-      "name": "Opx-service",
-      "kind": "rest",
-      "baseUrlEnv": "OPX_SOURCE_URL",
-      "defaultBaseUrl": "http://127.0.0.1:5102",
-      "credentialRef": "opx-source-local",
-      "connectorRef": "opx-rest",
-      "endpoints": [
-        "/employees",
-        "/external-people",
-        "/work-items",
-        "/activity-events",
-        "/playbooks",
-        "/work-items/:id/context"
-      ],
-      "pagination": {
-        "style": "cursor",
-        "defaultPageSize": 50
-      },
-      "retention": {
-        "context": {
-          "ttlSeconds": 3600,
-          "discardOnWorkCompletion": true
-        }
-      },
-      "routes": [
-        {
-          "endpoint": "/playbooks",
-          "objectType": "playbooks",
-          "dataCategory": "knowledge",
-          "identityPath": "id",
-          "primaryKind": "playbookId",
-          "modes": [
-            "knowledge"
-          ],
-          "pageSize": 2,
-          "checkpoint": {
-            "method": "cursor"
-          }
-        },
-        {
-          "endpoint": "/work-items/:id/context",
-          "objectType": "work-items",
-          "dataCategory": "entity",
-          "identityPath": "workItemId",
-          "primaryKind": "workItemId",
-          "modes": [
-            "context"
-          ],
-          "checkpoint": {
-            "method": "cursor"
-          }
-        },
-        {
-          "endpoint": "/work-items",
-          "objectType": "work-items",
-          "dataCategory": "entity",
-          "identityPath": "id",
-          "primaryKind": "workItemId",
-          "modes": [
-            "knowledge"
-          ],
-          "checkpoint": {
-            "method": "cursor"
-          }
-        },
-        {
-          "endpoint": "/employees",
-          "objectType": "people",
-          "dataCategory": "entity",
-          "identityPath": "id",
-          "primaryKind": "employeeId",
-          "modes": [
-            "knowledge"
-          ],
-          "checkpoint": {
-            "method": "cursor"
-          }
-        },
-        {
-          "endpoint": "/external-people",
-          "objectType": "people",
-          "dataCategory": "entity",
-          "identityPath": "id",
-          "primaryKind": "externalPersonId",
-          "modes": [
-            "knowledge"
-          ],
-          "checkpoint": {
-            "method": "cursor"
-          }
-        },
-        {
-          "endpoint": "/activity-events",
-          "objectType": "activity-events",
-          "dataCategory": "event",
-          "identityPath": "id",
-          "primaryKind": "activityEventId",
-          "modes": [
-            "knowledge"
-          ],
-          "checkpoint": {
-            "method": "cursor"
-          }
-        }
-      ]
-    }
-  ]
-}
+{
+  "pipelineDefinitions": [
+    {
+      "id": "opx-knowledge-pull",
+      "name": "Scheduled knowledge pull from opx-source",
+      "trigger": "scheduled",
+      "mode": "knowledge",
+      "steps": [
+        {
+          "id": "pull",
+          "kind": "memory-pull",
+          "sourceId": "opx-source"
+        },
+        {
+          "id": "land-raw",
+          "kind": "write-raw"
+        },
+        {
+          "id": "normalize",
+          "kind": "normalize"
+        },
+        {
+          "id": "promote",
+          "kind": "promote-snapshots"
+        }
+      ]
+    },
+    {
+      "id": "opx-context-pull",
+      "name": "On-demand work-item context pull",
+      "trigger": "on-demand",
+      "mode": "context",
+      "steps": [
+        {
+          "id": "pull",
+          "kind": "memory-pull",
+          "sourceId": "opx-source"
+        },
+        {
+          "id": "land-raw",
+          "kind": "write-raw"
+        },
+        {
+          "id": "normalize-context",
+          "kind": "normalize-context"
+        },
+        {
+          "id": "ttl",
+          "kind": "apply-ttl"
+        }
+      ]
+    },
+    {
+      "id": "opx-relationship-build",
+      "name": "Discover and write lightweight relationships",
+      "trigger": "explicit",
+      "steps": [
+        {
+          "id": "discover",
+          "kind": "relationship-discover"
+        },
+        {
+          "id": "write",
+          "kind": "relationship-write"
+        },
+        {
+          "id": "verify",
+          "kind": "relationship-verify"
+        }
+      ]
+    },
+    {
+      "id": "opx-analysis",
+      "name": "Work-item analysis sibling",
+      "trigger": "explicit",
+      "steps": [
+        {
+          "id": "analyze",
+          "kind": "analysis"
+        },
+        {
+          "id": "write-sibling",
+          "kind": "write-content",
+          "contentType": "analysis"
+        }
+      ]
+    },
+    {
+      "id": "opx-workflow",
+      "name": "Work-item workflow sibling",
+      "trigger": "explicit",
+      "steps": [
+        {
+          "id": "sync-workflow",
+          "kind": "workflow-sync"
+        },
+        {
+          "id": "write-sibling",
+          "kind": "write-content",
+          "contentType": "workflow"
+        }
+      ]
+    },
+    {
+      "id": "opx-enrich-priority",
+      "name": "Enrich WI priority (draft then write)",
+      "trigger": "explicit",
+      "description": "Capture snapshot → enrich service (opx-enrich-priority) → write-record. Runtime v2 uses stepKind enrich + serviceId.",
+      "steps": [
+        {
+          "id": "enrich",
+          "kind": "enrich",
+          "serviceId": "opx-enrich-priority"
+        },
+        {
+          "id": "write",
+          "kind": "write-record",
+          "contentType": "snapshots"
+        }
+      ]
+    },
+    {
+      "id": "opx-nexum-analyze",
+      "name": "Nexum analyze + write-record",
+      "trigger": "explicit",
+      "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",
+          "kind": "analyze",
+          "serviceId": "nexum"
+        },
+        {
+          "id": "write-graph",
+          "kind": "write-record",
+          "contentType": "snapshots",
+          "portConfig": {
+            "mode": "nexum"
+          },
+          "dependsOn": [
+            "analyze"
+          ],
+          "inputs": [
+            {
+              "fromStep": "analyze",
+              "key": "analyze"
+            }
+          ],
+          "notes": "mode nexum — create-or-update contribution/node/claim records from proposedGraph"
+        }
+      ]
+    }
+  ],
+  "sources": [
+    {
+      "id": "opx-source",
+      "name": "Opx-service",
+      "kind": "rest",
+      "baseUrlEnv": "OPX_SOURCE_URL",
+      "defaultBaseUrl": "http://127.0.0.1:5102",
+      "credentialRef": "opx-source-local",
+      "connectorRef": "opx-rest",
+      "endpoints": [
+        "/employees",
+        "/external-people",
+        "/work-items",
+        "/activity-events",
+        "/playbooks",
+        "/work-items/:id/context"
+      ],
+      "pagination": {
+        "style": "cursor",
+        "defaultPageSize": 50
+      },
+      "retention": {
+        "context": {
+          "ttlSeconds": 3600,
+          "discardOnWorkCompletion": true
+        }
+      },
+      "routes": [
+        {
+          "endpoint": "/playbooks",
+          "objectType": "playbooks",
+          "dataCategory": "knowledge",
+          "identityPath": "id",
+          "primaryKind": "playbookId",
+          "modes": [
+            "knowledge"
+          ],
+          "pageSize": 2,
+          "checkpoint": {
+            "method": "cursor"
+          }
+        },
+        {
+          "endpoint": "/work-items/:id/context",
+          "objectType": "work-items",
+          "dataCategory": "entity",
+          "identityPath": "workItemId",
+          "primaryKind": "workItemId",
+          "modes": [
+            "context"
+          ],
+          "checkpoint": {
+            "method": "cursor"
+          }
+        },
+        {
+          "endpoint": "/work-items",
+          "objectType": "work-items",
+          "dataCategory": "entity",
+          "identityPath": "id",
+          "primaryKind": "workItemId",
+          "modes": [
+            "knowledge"
+          ],
+          "checkpoint": {
+            "method": "cursor"
+          }
+        },
+        {
+          "endpoint": "/employees",
+          "objectType": "people",
+          "dataCategory": "entity",
+          "identityPath": "id",
+          "primaryKind": "employeeId",
+          "modes": [
+            "knowledge"
+          ],
+          "checkpoint": {
+            "method": "cursor"
+          }
+        },
+        {
+          "endpoint": "/external-people",
+          "objectType": "people",
+          "dataCategory": "entity",
+          "identityPath": "id",
+          "primaryKind": "externalPersonId",
+          "modes": [
+            "knowledge"
+          ],
+          "checkpoint": {
+            "method": "cursor"
+          }
+        },
+        {
+          "endpoint": "/activity-events",
+          "objectType": "activity-events",
+          "dataCategory": "event",
+          "identityPath": "id",
+          "primaryKind": "activityEventId",
+          "modes": [
+            "knowledge"
+          ],
+          "checkpoint": {
+            "method": "cursor"
+          }
+        }
+      ]
+    }
+  ]
+}

package/examples/opx/raw/relationship-definitions.json

@@ -1,80 +1,80 @@
-{
-  "relationshipDefinitions": [
-    {
-      "id": "people-assigned-to-work-items",
-      "name": "People assigned to work items",
-      "meaning": "A person is assigned to perform a work item",
-      "directionality": "directed",
-      "from": { "abstractType": "People", "property": "assignedWorkItems" },
-      "to": { "abstractType": "WorkItems", "property": "assignedPeople" },
-      "discoveryRules": [
-        {
-          "id": "from-source-assignee",
-          "kind": "source-field",
-          "sourcePath": "assigneeId",
-          "notes": "opx-source work-items.assigneeId resolves to people OT (any identity kind)"
-        }
-      ]
-    },
-    {
-      "id": "work-items-use-playbooks",
-      "name": "Work items use playbooks",
-      "meaning": "A work item follows one or more reusable playbooks",
-      "directionality": "directed",
-      "from": { "abstractType": "WorkItems", "property": "usedPlaybooks" },
-      "to": { "abstractType": "Playbooks", "property": "usedByWorkItems" },
-      "discoveryRules": [
-        {
-          "id": "from-source-playbook-ids",
-          "kind": "source-field",
-          "sourcePath": "playbookIds"
-        }
-      ]
-    },
-    {
-      "id": "activity-events-about-work-items",
-      "name": "Activity events about work items",
-      "meaning": "An activity event reports progress on a work item",
-      "directionality": "directed",
-      "from": { "abstractType": "ActivityEvents", "property": "aboutWorkItems" },
-      "to": { "abstractType": "WorkItems", "property": "activityEvents" },
-      "discoveryRules": [
-        {
-          "id": "from-source-work-item-id",
-          "kind": "source-field",
-          "sourcePath": "workItemId"
-        }
-      ]
-    },
-    {
-      "id": "work-items-depend-on-work-items",
-      "name": "Work items depend on work items",
-      "meaning": "A work item cannot complete until another work item completes",
-      "directionality": "directed",
-      "from": { "abstractType": "WorkItems", "property": "dependsOn" },
-      "to": { "abstractType": "WorkItems", "property": "dependedOnBy" },
-      "discoveryRules": [
-        {
-          "id": "from-source-depends-on",
-          "kind": "source-field",
-          "sourcePath": "dependsOnIds"
-        }
-      ]
-    },
-    {
-      "id": "people-collaborate-with-people",
-      "name": "People collaborate with people",
-      "meaning": "Two people collaborate on operational work",
-      "directionality": "undirected",
-      "from": { "abstractType": "People", "property": "collaborators" },
-      "to": { "abstractType": "People", "property": "collaborators" },
-      "discoveryRules": [
-        {
-          "id": "from-source-collaborator-ids",
-          "kind": "source-field",
-          "sourcePath": "collaboratorIds"
-        }
-      ]
-    }
-  ]
-}
+{
+  "relationshipDefinitions": [
+    {
+      "id": "people-assigned-to-work-items",
+      "name": "People assigned to work items",
+      "meaning": "A person is assigned to perform a work item",
+      "directionality": "directed",
+      "from": { "abstractType": "People", "property": "assignedWorkItems" },
+      "to": { "abstractType": "WorkItems", "property": "assignedPeople" },
+      "discoveryRules": [
+        {
+          "id": "from-source-assignee",
+          "kind": "source-field",
+          "sourcePath": "assigneeId",
+          "notes": "opx-source work-items.assigneeId resolves to people OT (any identity kind)"
+        }
+      ]
+    },
+    {
+      "id": "work-items-use-playbooks",
+      "name": "Work items use playbooks",
+      "meaning": "A work item follows one or more reusable playbooks",
+      "directionality": "directed",
+      "from": { "abstractType": "WorkItems", "property": "usedPlaybooks" },
+      "to": { "abstractType": "Playbooks", "property": "usedByWorkItems" },
+      "discoveryRules": [
+        {
+          "id": "from-source-playbook-ids",
+          "kind": "source-field",
+          "sourcePath": "playbookIds"
+        }
+      ]
+    },
+    {
+      "id": "activity-events-about-work-items",
+      "name": "Activity events about work items",
+      "meaning": "An activity event reports progress on a work item",
+      "directionality": "directed",
+      "from": { "abstractType": "ActivityEvents", "property": "aboutWorkItems" },
+      "to": { "abstractType": "WorkItems", "property": "activityEvents" },
+      "discoveryRules": [
+        {
+          "id": "from-source-work-item-id",
+          "kind": "source-field",
+          "sourcePath": "workItemId"
+        }
+      ]
+    },
+    {
+      "id": "work-items-depend-on-work-items",
+      "name": "Work items depend on work items",
+      "meaning": "A work item cannot complete until another work item completes",
+      "directionality": "directed",
+      "from": { "abstractType": "WorkItems", "property": "dependsOn" },
+      "to": { "abstractType": "WorkItems", "property": "dependedOnBy" },
+      "discoveryRules": [
+        {
+          "id": "from-source-depends-on",
+          "kind": "source-field",
+          "sourcePath": "dependsOnIds"
+        }
+      ]
+    },
+    {
+      "id": "people-collaborate-with-people",
+      "name": "People collaborate with people",
+      "meaning": "Two people collaborate on operational work",
+      "directionality": "undirected",
+      "from": { "abstractType": "People", "property": "collaborators" },
+      "to": { "abstractType": "People", "property": "collaborators" },
+      "discoveryRules": [
+        {
+          "id": "from-source-collaborator-ids",
+          "kind": "source-field",
+          "sourcePath": "collaboratorIds"
+        }
+      ]
+    }
+  ]
+}