@x12i/memorix-metadata 3.0.2 → 3.1.0

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

@@ -0,0 +1,244 @@
+{
+  "abstractTypes": [
+    {
+      "id": "People",
+      "name": "People",
+      "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",
+      "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": "Playbooks",
+      "name": "Playbooks",
+      "meaning": "Reusable operational knowledge / playbooks",
+      "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",
+      "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/{ops → opx}/raw/agents.json

@@ -1,30 +1,30 @@
 {
   "agents": [
     {
-      "id": "ops",
+      "id": "opx",
       "name": "Operations (generic parent)",
       "description": "Complete generic parent agent for ordinary operational work. Permanent Memorix acceptance pack.",
       "parentAgentId": null,
       "orgScopeExample": {
         "orgId": "fieldstone",
         "agentIds": [
-          "ops"
+          "opx"
         ]
       }
     },
     {
-      "id": "project-ops",
-      "name": "Project Operations (child of ops)",
-      "description": "Inheritance smoke agent. Extends ops without replacing core definitions.",
-      "parentAgentId": "ops",
+      "id": "project-opx",
+      "name": "Project Operations (child of opx)",
+      "description": "Inheritance smoke agent. Extends opx without replacing core definitions.",
+      "parentAgentId": "opx",
       "overrides": {
         "viewDefinitions": [
           {
-            "id": "project-ops-work-items-list",
+            "id": "project-opx-work-items-list",
             "kind": "list",
             "objectType": "work-items",
             "title": "Project work items",
-            "extends": "ops-work-items-list"
+            "extends": "opx-work-items-list"
           }
         ]
       }

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

@@ -0,0 +1,101 @@
+{
+  "objectTypes": [
+    {
+      "id": "people",
+      "name": "People",
+      "dataCategory": "entity",
+      "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,
+          "requiredReason": "Landed provider-native payload; identity and lineage depend on it."
+        },
+        {
+          "id": "snapshots",
+          "required": true,
+          "requiredReason": "Canonical composed person view used by queries and abstracts."
+        },
+        {
+          "id": "discovery",
+          "discriminator": {
+            "path": "data.discoveryType",
+            "required": false,
+            "defaultValue": "default"
+          }
+        },
+        {
+          "id": "analysis",
+          "discriminator": {
+            "path": "data.analysisType",
+            "required": false,
+            "defaultValue": "default"
+          }
+        },
+        { "id": "relationships", "notes": "Candidate store shape until Gate G4" }
+      ]
+    },
+    {
+      "id": "work-items",
+      "name": "Work Items",
+      "dataCategory": "entity",
+      "abstractTypes": ["WorkItems"],
+      "contentTypes": [
+        { "id": "raw" },
+        { "id": "snapshots" },
+        {
+          "id": "discovery",
+          "discriminator": { "path": "data.discoveryType", "required": false }
+        },
+        {
+          "id": "analysis",
+          "discriminator": {
+            "path": "data.analysisType",
+            "required": false,
+            "defaultValue": "delivery-risk"
+          }
+        },
+        {
+          "id": "decisions",
+          "discriminator": {
+            "path": "data.decisionType",
+            "required": false,
+            "defaultValue": "priority"
+          }
+        },
+        { "id": "workflow" },
+        { "id": "context", "retention": "work-scoped-ttl" },
+        { "id": "relationships" }
+      ],
+      "snapshotBuckets": {
+        "analytics": "optional",
+        "enrichment": "optional",
+        "insights": "optional"
+      }
+    },
+    {
+      "id": "playbooks",
+      "name": "Playbooks",
+      "dataCategory": "knowledge",
+      "abstractTypes": ["Playbooks"],
+      "contentTypes": [
+        { "id": "raw" },
+        { "id": "snapshots", "notes": "Persistent knowledge content" },
+        { "id": "relationships" }
+      ],
+      "retention": "persistent-knowledge"
+    },
+    {
+      "id": "activity-events",
+      "name": "Activity Events",
+      "dataCategory": "event",
+      "abstractTypes": ["ActivityEvents"],
+      "contentTypes": [
+        { "id": "raw" },
+        { "id": "snapshots", "notes": "Normalized event content" },
+        { "id": "relationships" }
+      ]
+    }
+  ]
+}

package/examples/{ops → opx}/raw/pipelines-and-sources.json

@@ -1,15 +1,15 @@
 {
   "pipelineDefinitions": [
     {
-      "id": "ops-knowledge-pull",
-      "name": "Scheduled knowledge pull from ops-source",
+      "id": "opx-knowledge-pull",
+      "name": "Scheduled knowledge pull from opx-source",
       "trigger": "scheduled",
       "mode": "knowledge",
       "steps": [
         {
           "id": "pull",
           "kind": "memory-pull",
-          "sourceId": "ops-source"
+          "sourceId": "opx-source"
         },
         {
           "id": "land-raw",
@@ -26,7 +26,7 @@
       ]
     },
     {
-      "id": "ops-context-pull",
+      "id": "opx-context-pull",
       "name": "On-demand work-item context pull",
       "trigger": "on-demand",
       "mode": "context",
@@ -34,7 +34,7 @@
         {
           "id": "pull",
           "kind": "memory-pull",
-          "sourceId": "ops-source"
+          "sourceId": "opx-source"
         },
         {
           "id": "land-raw",
@@ -51,7 +51,7 @@
       ]
     },
     {
-      "id": "ops-relationship-build",
+      "id": "opx-relationship-build",
       "name": "Discover and write lightweight relationships",
       "trigger": "explicit",
       "steps": [
@@ -70,7 +70,7 @@
       ]
     },
     {
-      "id": "ops-analysis",
+      "id": "opx-analysis",
       "name": "Work-item analysis sibling",
       "trigger": "explicit",
       "steps": [
@@ -86,7 +86,7 @@
       ]
     },
     {
-      "id": "ops-workflow",
+      "id": "opx-workflow",
       "name": "Work-item workflow sibling",
       "trigger": "explicit",
       "steps": [
@@ -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": "ops-source",
-      "name": "Fieldstone ops fixture source",
-      "kind": "rest-fixture",
-      "baseUrlEnv": "OPS_SOURCE_URL",
-      "defaultBaseUrl": "http://127.0.0.1:7099",
-      "credentialRef": "ops-source-local",
-      "connectorRef": "ops-fixture",
+      "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",
-        "/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"
+          }
         }
       ]
     }