@x12i/memorix-metadata 3.0.3 → 3.2.0

package/examples/opx/raw/abstract-types.json

@@ -3,26 +3,242 @@
     {
       "id": "People",
       "name": "People",
-      "meaning": "Employees and contractors who perform operational work",
-      "category": "entity"
+      "meaning": "People who perform operational work \u2014 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
+        }
+      ],
+      "members": [
+        {
+          "objectType": "people",
+          "contentType": "snapshots",
+          "properties": [
+            {
+              "abstractProperty": "title",
+              "contentType": "snapshots",
+              "mappingId": "opx-people-abstract"
+            },
+            {
+              "abstractProperty": "role",
+              "contentType": "snapshots",
+              "mappingId": "opx-people-abstract"
+            },
+            {
+              "abstractProperty": "lens",
+              "contentType": "snapshots",
+              "mappingId": "opx-people-abstract"
+            },
+            {
+              "abstractProperty": "email",
+              "contentType": "snapshots",
+              "mappingId": "opx-people-abstract"
+            },
+            {
+              "abstractProperty": "organization",
+              "contentType": "snapshots",
+              "mappingId": "opx-people-abstract"
+            }
+          ]
+        }
+      ],
+      "union": false,
+      "notes": "People abstract \u2194 people OT 1:1. Inside/outside org is concept.identifiers.primary.kind (employeeId | externalPersonId), not a second OT."
     },
     {
       "id": "WorkItems",
       "name": "Work Items",
       "meaning": "Units of operational work",
-      "category": "entity"
+      "category": "entity",
+      "properties": [
+        {
+          "id": "title",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "status",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "priority",
+          "valueType": "string",
+          "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"
+            }
+          ]
+        }
+      ],
+      "union": false
     },
     {
-      "id": "Procedures",
-      "name": "Procedures",
+      "id": "Playbooks",
+      "name": "Playbooks",
       "meaning": "Reusable operational knowledge / playbooks",
-      "category": "knowledge"
+      "category": "knowledge",
+      "properties": [
+        {
+          "id": "title",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "body",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "contentHash",
+          "valueType": "string",
+          "required": false
+        }
+      ],
+      "members": [
+        {
+          "objectType": "playbooks",
+          "contentType": "snapshots",
+          "properties": [
+            {
+              "abstractProperty": "title",
+              "contentType": "snapshots",
+              "propertyPath": "data.name",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "body",
+              "contentType": "snapshots",
+              "propertyPath": "data.body",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "contentHash",
+              "contentType": "snapshots",
+              "propertyPath": "data.contentHash",
+              "concreteValueType": "string"
+            }
+          ]
+        }
+      ],
+      "union": false
     },
     {
       "id": "ActivityEvents",
       "name": "Activity Events",
       "meaning": "Progress and activity reports about work items",
-      "category": "event"
+      "category": "event",
+      "properties": [
+        {
+          "id": "type",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "message",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "workItemId",
+          "valueType": "recordId",
+          "required": true
+        },
+        {
+          "id": "actorId",
+          "valueType": "recordId",
+          "required": false
+        },
+        {
+          "id": "occurredAt",
+          "valueType": "datetime",
+          "required": false
+        }
+      ],
+      "members": [
+        {
+          "objectType": "activity-events",
+          "contentType": "snapshots",
+          "properties": [
+            {
+              "abstractProperty": "type",
+              "contentType": "snapshots",
+              "propertyPath": "data.type",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "message",
+              "contentType": "snapshots",
+              "propertyPath": "data.message",
+              "concreteValueType": "string"
+            },
+            {
+              "abstractProperty": "workItemId",
+              "contentType": "snapshots",
+              "propertyPath": "data.workItemId",
+              "concreteValueType": "recordId"
+            },
+            {
+              "abstractProperty": "actorId",
+              "contentType": "snapshots",
+              "propertyPath": "data.actorId",
+              "concreteValueType": "recordId"
+            },
+            {
+              "abstractProperty": "occurredAt",
+              "contentType": "snapshots",
+              "propertyPath": "data.occurredAt",
+              "concreteValueType": "datetime"
+            }
+          ]
+        }
+      ],
+      "union": false
     }
   ]
 }

package/examples/opx/raw/object-types.json

@@ -1,20 +1,21 @@
 {
   "objectTypes": [
     {
-      "id": "employees",
-      "name": "Employees",
+      "id": "people",
+      "name": "People",
       "dataCategory": "entity",
-      "abstractTypes": [
-        "People"
-      ],
+      "abstractTypes": ["People"],
+      "notes": "Single people OT. Inside vs outside org is identity kind (concept.identifiers.primary.kind): employeeId | externalPersonId — not separate object types.",
       "contentTypes": [
         {
           "id": "raw",
-          "required": true
+          "required": true,
+          "requiredReason": "Landed provider-native payload; identity and lineage depend on it."
         },
         {
           "id": "snapshots",
-          "required": true
+          "required": true,
+          "requiredReason": "Canonical composed person view used by queries and abstracts."
         },
         {
           "id": "discovery",
@@ -32,65 +33,20 @@
             "defaultValue": "default"
           }
         },
-        {
-          "id": "relationships",
-          "notes": "Candidate store shape until Gate G4"
-        }
-      ]
-    },
-    {
-      "id": "contractors",
-      "name": "Contractors",
-      "dataCategory": "entity",
-      "abstractTypes": [
-        "People"
-      ],
-      "contentTypes": [
-        {
-          "id": "raw"
-        },
-        {
-          "id": "snapshots"
-        },
-        {
-          "id": "discovery",
-          "discriminator": {
-            "path": "data.discoveryType",
-            "required": false
-          }
-        },
-        {
-          "id": "analysis",
-          "discriminator": {
-            "path": "data.analysisType",
-            "required": false
-          }
-        },
-        {
-          "id": "relationships"
-        }
+        { "id": "relationships", "notes": "Candidate store shape until Gate G4" }
       ]
     },
     {
       "id": "work-items",
       "name": "Work Items",
       "dataCategory": "entity",
-      "abstractTypes": [
-        "WorkItems"
-      ],
+      "abstractTypes": ["WorkItems"],
       "contentTypes": [
-        {
-          "id": "raw"
-        },
-        {
-          "id": "snapshots"
-        },
+        { "id": "raw" },
+        { "id": "snapshots" },
         {
           "id": "discovery",
-          "discriminator": {
-            "path": "data.discoveryType",
-            "required": false
-          }
+          "discriminator": { "path": "data.discoveryType", "required": false }
         },
         {
           "id": "analysis",
@@ -108,16 +64,9 @@
             "defaultValue": "priority"
           }
         },
-        {
-          "id": "workflow"
-        },
-        {
-          "id": "context",
-          "retention": "work-scoped-ttl"
-        },
-        {
-          "id": "relationships"
-        }
+        { "id": "workflow" },
+        { "id": "context", "retention": "work-scoped-ttl" },
+        { "id": "relationships" }
       ],
       "snapshotBuckets": {
         "analytics": "optional",
@@ -126,23 +75,14 @@
       }
     },
     {
-      "id": "procedures",
-      "name": "Procedures",
+      "id": "playbooks",
+      "name": "Playbooks",
       "dataCategory": "knowledge",
-      "abstractTypes": [
-        "Procedures"
-      ],
+      "abstractTypes": ["Playbooks"],
       "contentTypes": [
-        {
-          "id": "raw"
-        },
-        {
-          "id": "snapshots",
-          "notes": "Persistent knowledge content"
-        },
-        {
-          "id": "relationships"
-        }
+        { "id": "raw" },
+        { "id": "snapshots", "notes": "Persistent knowledge content" },
+        { "id": "relationships" }
       ],
       "retention": "persistent-knowledge"
     },
@@ -150,20 +90,11 @@
       "id": "activity-events",
       "name": "Activity Events",
       "dataCategory": "event",
-      "abstractTypes": [
-        "ActivityEvents"
-      ],
+      "abstractTypes": ["ActivityEvents"],
       "contentTypes": [
-        {
-          "id": "raw"
-        },
-        {
-          "id": "snapshots",
-          "notes": "Normalized event content"
-        },
-        {
-          "id": "relationships"
-        }
+        { "id": "raw" },
+        { "id": "snapshots", "notes": "Normalized event content" },
+        { "id": "relationships" }
       ]
     }
   ]

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

@@ -100,23 +100,41 @@
           "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-fixture",
+      "kind": "rest",
       "baseUrlEnv": "OPX_SOURCE_URL",
       "defaultBaseUrl": "http://127.0.0.1:5102",
       "credentialRef": "opx-source-local",
-      "connectorRef": "opx-fixture",
+      "connectorRef": "opx-rest",
       "endpoints": [
         "/employees",
-        "/contractors",
+        "/external-people",
         "/work-items",
         "/activity-events",
-        "/procedures",
+        "/playbooks",
         "/work-items/:id/context"
       ],
       "pagination": {
@@ -131,13 +149,18 @@
       },
       "routes": [
         {
-          "endpoint": "/procedures",
-          "objectType": "procedures",
+          "endpoint": "/playbooks",
+          "objectType": "playbooks",
           "dataCategory": "knowledge",
           "identityPath": "id",
-          "primaryKind": "procedureId",
-          "modes": ["knowledge"],
-          "pageSize": 2
+          "primaryKind": "playbookId",
+          "modes": [
+            "knowledge"
+          ],
+          "pageSize": 2,
+          "checkpoint": {
+            "method": "cursor"
+          }
         },
         {
           "endpoint": "/work-items/:id/context",
@@ -145,7 +168,12 @@
           "dataCategory": "entity",
           "identityPath": "workItemId",
           "primaryKind": "workItemId",
-          "modes": ["context"]
+          "modes": [
+            "context"
+          ],
+          "checkpoint": {
+            "method": "cursor"
+          }
         },
         {
           "endpoint": "/work-items",
@@ -153,23 +181,38 @@
           "dataCategory": "entity",
           "identityPath": "id",
           "primaryKind": "workItemId",
-          "modes": ["knowledge"]
+          "modes": [
+            "knowledge"
+          ],
+          "checkpoint": {
+            "method": "cursor"
+          }
         },
         {
           "endpoint": "/employees",
-          "objectType": "employees",
+          "objectType": "people",
           "dataCategory": "entity",
           "identityPath": "id",
           "primaryKind": "employeeId",
-          "modes": ["knowledge"]
+          "modes": [
+            "knowledge"
+          ],
+          "checkpoint": {
+            "method": "cursor"
+          }
         },
         {
-          "endpoint": "/contractors",
-          "objectType": "contractors",
+          "endpoint": "/external-people",
+          "objectType": "people",
           "dataCategory": "entity",
           "identityPath": "id",
-          "primaryKind": "contractorId",
-          "modes": ["knowledge"]
+          "primaryKind": "externalPersonId",
+          "modes": [
+            "knowledge"
+          ],
+          "checkpoint": {
+            "method": "cursor"
+          }
         },
         {
           "endpoint": "/activity-events",
@@ -177,7 +220,12 @@
           "dataCategory": "event",
           "identityPath": "id",
           "primaryKind": "activityEventId",
-          "modes": ["knowledge"]
+          "modes": [
+            "knowledge"
+          ],
+          "checkpoint": {
+            "method": "cursor"
+          }
         }
       ]
     }

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

@@ -3,43 +3,31 @@
     {
       "id": "people-assigned-to-work-items",
       "name": "People assigned to work items",
-      "meaning": "A person (employee or contractor) is assigned to perform a work item",
+      "meaning": "A person is assigned to perform a work item",
       "directionality": "directed",
-      "from": {
-        "abstractType": "People",
-        "property": "assignedWorkItems"
-      },
-      "to": {
-        "abstractType": "WorkItems",
-        "property": "assignedPeople"
-      },
+      "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 across employees and contractors"
+          "notes": "opx-source work-items.assigneeId resolves to people OT (any identity kind)"
         }
       ]
     },
     {
-      "id": "work-items-use-procedures",
-      "name": "Work items use procedures",
-      "meaning": "A work item follows one or more reusable procedures",
+      "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": "usedProcedures"
-      },
-      "to": {
-        "abstractType": "Procedures",
-        "property": "usedByWorkItems"
-      },
+      "from": { "abstractType": "WorkItems", "property": "usedPlaybooks" },
+      "to": { "abstractType": "Playbooks", "property": "usedByWorkItems" },
       "discoveryRules": [
         {
-          "id": "from-source-procedure-ids",
+          "id": "from-source-playbook-ids",
           "kind": "source-field",
-          "sourcePath": "procedureIds"
+          "sourcePath": "playbookIds"
         }
       ]
     },
@@ -48,14 +36,8 @@
       "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"
-      },
+      "from": { "abstractType": "ActivityEvents", "property": "aboutWorkItems" },
+      "to": { "abstractType": "WorkItems", "property": "activityEvents" },
       "discoveryRules": [
         {
           "id": "from-source-work-item-id",
@@ -69,14 +51,8 @@
       "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"
-      },
+      "from": { "abstractType": "WorkItems", "property": "dependsOn" },
+      "to": { "abstractType": "WorkItems", "property": "dependedOnBy" },
       "discoveryRules": [
         {
           "id": "from-source-depends-on",
@@ -90,14 +66,8 @@
       "name": "People collaborate with people",
       "meaning": "Two people collaborate on operational work",
       "directionality": "undirected",
-      "from": {
-        "abstractType": "People",
-        "property": "collaborators"
-      },
-      "to": {
-        "abstractType": "People",
-        "property": "collaborators"
-      },
+      "from": { "abstractType": "People", "property": "collaborators" },
+      "to": { "abstractType": "People", "property": "collaborators" },
       "discoveryRules": [
         {
           "id": "from-source-collaborator-ids",