@x12i/memorix-metadata 3.0.3 → 3.2.0

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

@@ -7,31 +7,38 @@
       "id": "opx",
       "name": "Operations (generic parent)",
       "description": "Complete generic parent agent for ordinary operational work. Permanent Memorix acceptance pack.",
+      "parentIds": [],
       "parentId": null
     },
     {
       "id": "project-opx",
       "name": "Project Operations (child of opx)",
       "description": "Inheritance smoke agent. Extends opx without replacing core definitions.",
+      "parentIds": [
+        "opx"
+      ],
       "parentId": "opx"
     }
   ],
   "objectTypes": [
     {
-      "id": "employees",
-      "name": "Employees",
+      "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 \u2014 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",
@@ -53,63 +60,6 @@
           "id": "relationships",
           "notes": "Candidate store shape until Gate G4"
         }
-      ],
-      "fields": [
-        {
-          "path": "data.displayName",
-          "valueType": "string",
-          "contentType": "snapshots"
-        },
-        {
-          "path": "data.role",
-          "valueType": "string",
-          "contentType": "snapshots"
-        }
-      ]
-    },
-    {
-      "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"
-        }
-      ],
-      "fields": [
-        {
-          "path": "data.displayName",
-          "valueType": "string",
-          "contentType": "snapshots"
-        },
-        {
-          "path": "data.role",
-          "valueType": "string",
-          "contentType": "snapshots"
-        }
       ]
     },
     {
@@ -167,11 +117,11 @@
       }
     },
     {
-      "id": "procedures",
-      "name": "Procedures",
+      "id": "playbooks",
+      "name": "Playbooks",
       "dataCategory": "knowledge",
       "abstractTypes": [
-        "Procedures"
+        "Playbooks"
       ],
       "contentTypes": [
         {
@@ -212,7 +162,7 @@
     {
       "id": "People",
       "name": "People",
-      "meaning": "Employees and contractors who perform operational work",
+      "meaning": "People who perform operational work \u2014 inside the org (employeeId) or outside (externalPersonId), distinguished by identity kind",
       "category": "entity",
       "properties": [
         {
@@ -229,113 +179,233 @@
           "id": "lens",
           "valueType": "string",
           "required": false
+        },
+        {
+          "id": "email",
+          "valueType": "string",
+          "required": false
+        },
+        {
+          "id": "organization",
+          "valueType": "string",
+          "required": false
         }
-      ]
-    },
-    {
-      "id": "WorkItems",
-      "name": "Work Items",
-      "meaning": "Units of operational work",
-      "category": "entity"
-    },
-    {
-      "id": "Procedures",
-      "name": "Procedures",
-      "meaning": "Reusable operational knowledge / playbooks",
-      "category": "knowledge"
-    },
-    {
-      "id": "ActivityEvents",
-      "name": "Activity Events",
-      "meaning": "Progress and activity reports about work items",
-      "category": "event"
-    }
-  ],
-  "abstractBindings": [
-    {
-      "id": "people-employees-contractors",
-      "abstractType": "People",
-      "concreteObjectTypes": [
-        "employees",
-        "contractors"
       ],
-      "union": true,
-      "notes": "People = Employees ∪ Contractors. No abstract records exist.",
       "members": [
         {
-          "objectType": "employees",
+          "objectType": "people",
           "contentType": "snapshots",
           "properties": [
             {
               "abstractProperty": "title",
               "contentType": "snapshots",
-              "mappingId": "opx-people-abstract-employees"
+              "mappingId": "opx-people-abstract"
             },
             {
               "abstractProperty": "role",
               "contentType": "snapshots",
-              "mappingId": "opx-people-abstract-employees"
+              "mappingId": "opx-people-abstract"
             },
             {
               "abstractProperty": "lens",
               "contentType": "snapshots",
-              "mappingId": "opx-people-abstract-employees"
+              "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
         },
         {
-          "objectType": "contractors",
+          "id": "priority",
+          "valueType": "string",
+          "required": false
+        }
+      ],
+      "members": [
+        {
+          "objectType": "work-items",
           "contentType": "snapshots",
           "properties": [
             {
               "abstractProperty": "title",
               "contentType": "snapshots",
-              "mappingId": "opx-people-abstract-contractors"
+              "propertyPath": "data.title",
+              "concreteValueType": "string"
             },
             {
-              "abstractProperty": "role",
+              "abstractProperty": "status",
               "contentType": "snapshots",
-              "mappingId": "opx-people-abstract-contractors"
+              "propertyPath": "data.status",
+              "concreteValueType": "string"
             },
             {
-              "abstractProperty": "lens",
+              "abstractProperty": "priority",
               "contentType": "snapshots",
-              "mappingId": "opx-people-abstract-contractors"
+              "propertyPath": "data.priority",
+              "concreteValueType": "string"
             }
           ]
         }
-      ]
-    },
-    {
-      "id": "work-items-concrete",
-      "abstractType": "WorkItems",
-      "concreteObjectTypes": [
-        "work-items"
       ],
       "union": false
     },
     {
-      "id": "procedures-concrete",
-      "abstractType": "Procedures",
-      "concreteObjectTypes": [
-        "procedures"
+      "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": "activity-events-concrete",
-      "abstractType": "ActivityEvents",
-      "concreteObjectTypes": [
-        "activity-events"
+      "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
     }
   ],
+  "abstractBindings": [],
   "relationshipDefinitions": [
     {
       "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",
@@ -350,28 +420,28 @@
           "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",
-        "path": "usedProcedures"
+        "path": "usedPlaybooks"
       },
       "to": {
-        "abstractType": "Procedures",
+        "abstractType": "Playbooks",
         "path": "usedByWorkItems"
       },
       "discoveryRules": [
         {
-          "id": "from-source-procedure-ids",
+          "id": "from-source-playbook-ids",
           "kind": "source-field",
-          "sourcePath": "procedureIds"
+          "sourcePath": "playbookIds"
         }
       ]
     },
@@ -442,12 +512,12 @@
   "mappings": [
     {
       "id": "opx-source-employees-to-raw",
+      "purpose": "source",
       "sourceId": "opx-source",
       "endpoint": "/employees",
-      "objectType": "employees",
+      "objectType": "people",
       "contentType": "raw",
       "mode": "knowledge",
-      "purpose": "source",
       "map": {
         "recordId": {
           "op": "path",
@@ -456,7 +526,7 @@
         },
         "objectType": {
           "op": "constant",
-          "value": "employees"
+          "value": "people"
         },
         "data.displayName": {
           "op": "path",
@@ -479,13 +549,13 @@
       }
     },
     {
-      "id": "opx-source-contractors-to-raw",
+      "id": "opx-source-external-people-to-raw",
+      "purpose": "source",
       "sourceId": "opx-source",
-      "endpoint": "/contractors",
-      "objectType": "contractors",
+      "endpoint": "/external-people",
+      "objectType": "people",
       "contentType": "raw",
       "mode": "knowledge",
-      "purpose": "source",
       "map": {
         "recordId": {
           "op": "path",
@@ -494,7 +564,7 @@
         },
         "objectType": {
           "op": "constant",
-          "value": "contractors"
+          "value": "people"
         },
         "data.displayName": {
           "op": "path",
@@ -506,9 +576,9 @@
           "path": "role",
           "required": true
         },
-        "data.vendor": {
+        "data.organization": {
           "op": "path",
-          "path": "vendor"
+          "path": "organization"
         },
         "data.sourceId": {
           "op": "path",
@@ -518,12 +588,12 @@
     },
     {
       "id": "opx-source-work-items-to-raw",
+      "purpose": "source",
       "sourceId": "opx-source",
       "endpoint": "/work-items",
       "objectType": "work-items",
       "contentType": "raw",
       "mode": "knowledge",
-      "purpose": "source",
       "map": {
         "data": {
           "op": "path",
@@ -533,13 +603,13 @@
     },
     {
       "id": "opx-source-work-item-context",
+      "purpose": "source",
       "sourceId": "opx-source",
       "endpoint": "/work-items/:id/context",
       "objectType": "work-items",
       "contentType": "context",
       "mode": "context",
       "trigger": "on-demand",
-      "purpose": "source",
       "map": {
         "data": {
           "op": "path",
@@ -548,10 +618,10 @@
       }
     },
     {
-      "id": "opx-people-abstract-employees",
+      "id": "opx-people-abstract",
       "purpose": "abstract",
       "abstractType": "People",
-      "objectType": "employees",
+      "objectType": "people",
       "contentType": "snapshots",
       "map": {
         "title": {
@@ -572,51 +642,6 @@
           "op": "constant",
           "value": "people"
         }
-      },
-      "reverse": {
-        "title": {
-          "expr": {
-            "op": "path",
-            "path": "title"
-          },
-          "targetPath": "data.displayName"
-        }
-      }
-    },
-    {
-      "id": "opx-people-abstract-contractors",
-      "purpose": "abstract",
-      "abstractType": "People",
-      "objectType": "contractors",
-      "contentType": "snapshots",
-      "map": {
-        "title": {
-          "expr": {
-            "op": "path",
-            "path": "data.displayName"
-          },
-          "required": true
-        },
-        "role": {
-          "expr": {
-            "op": "path",
-            "path": "data.role"
-          },
-          "required": true
-        },
-        "lens": {
-          "op": "constant",
-          "value": "people"
-        }
-      },
-      "reverse": {
-        "title": {
-          "expr": {
-            "op": "path",
-            "path": "title"
-          },
-          "targetPath": "data.displayName"
-        }
       }
     },
     {
@@ -649,7 +674,7 @@
     {
       "id": "opx-work-items-list",
       "kind": "list",
-      "objectType": "work-items",
+      "abstractType": "WorkItems",
       "title": "Work items",
       "columns": [
         "concept.title",
@@ -660,7 +685,7 @@
     {
       "id": "opx-work-items-item",
       "kind": "item",
-      "objectType": "work-items",
+      "abstractType": "WorkItems",
       "title": "Work item",
       "sections": [
         "concept",
@@ -684,26 +709,22 @@
     {
       "id": "opx-work-item-expand-people",
       "kind": "relationship-expansion",
-      "objectType": "work-items",
+      "abstractType": "WorkItems",
       "relationshipDefinitionId": "people-assigned-to-work-items",
       "direction": "to-from"
     },
     {
       "id": "project-opx-work-items-list",
       "kind": "list",
-      "objectType": "work-items",
       "title": "Project work items",
-      "extends": "opx-work-items-list",
-      "columns": [
-        "concept.title",
-        "data.status"
-      ]
+      "abstractType": "WorkItems",
+      "extends": "opx-work-items-list"
     }
   ],
   "writes": [
     {
-      "id": "opx-employees-snapshots",
-      "objectType": "employees",
+      "id": "opx-people-employee-snapshots",
+      "objectType": "people",
       "contentType": "snapshots",
       "identity": {
         "primaryKind": "employeeId",
@@ -711,11 +732,11 @@
       }
     },
     {
-      "id": "opx-contractors-snapshots",
-      "objectType": "contractors",
+      "id": "opx-people-external-snapshots",
+      "objectType": "people",
       "contentType": "snapshots",
       "identity": {
-        "primaryKind": "contractorId",
+        "primaryKind": "externalPersonId",
         "issuer": "opx-source"
       }
     },
@@ -729,11 +750,11 @@
       }
     },
     {
-      "id": "opx-procedures-snapshots",
-      "objectType": "procedures",
+      "id": "opx-playbooks-snapshots",
+      "objectType": "playbooks",
       "contentType": "snapshots",
       "identity": {
-        "primaryKind": "procedureId",
+        "primaryKind": "playbookId",
         "issuer": "opx-source"
       }
     },
@@ -751,66 +772,140 @@
     {
       "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-rest",
       "endpoints": [
         "/employees",
-        "/contractors",
+        "/external-people",
         "/work-items",
         "/activity-events",
-        "/procedures",
+        "/playbooks",
         "/work-items/:id/context"
-      ]
-    }
-  ],
-  "services": [
-    {
-      "id": "opx-normalize",
-      "name": "Normalize records",
-      "description": "Logical normalize capability for ops knowledge pull",
-      "capabilities": [
-        "normalize"
       ],
-      "inputs": [
-        {
-          "id": "raw-records",
-          "schemaRef": "memorix-record/raw"
+      "pagination": {
+        "style": "cursor",
+        "defaultPageSize": 50
+      },
+      "retention": {
+        "context": {
+          "ttlSeconds": 3600,
+          "discardOnWorkCompletion": true
         }
-      ],
-      "outputs": [
+      },
+      "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"
+          }
+        },
         {
-          "id": "normalized-records",
-          "schemaRef": "memorix-record/snapshots"
+          "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"
+          }
         }
-      ],
-      "invocation": {
-        "kind": "worker",
-        "operation": "normalize"
-      }
-    },
+      ]
+    }
+  ],
+  "services": [
     {
-      "id": "opx-completion",
-      "name": "Field completion",
+      "id": "opx-enrich-priority",
+      "name": "Enrich work-item priority",
+      "description": "Deterministic priority score draft for WorkItems. Returns a patch plan \u2014 does not persist. Pipeline write-record applies the revision-safe mutation on the concrete member.",
+      "role": "agent",
       "capabilities": [
-        "completion"
+        "enrich"
       ],
       "inputs": [
         {
           "id": "snapshot",
-          "schemaRef": "memorix-record/snapshots"
+          "abstractType": "WorkItems",
+          "path": "snapshots",
+          "description": "Current WorkItems projection at a captured revision"
         }
       ],
       "outputs": [
         {
-          "id": "completed",
-          "schemaRef": "memorix-record/snapshots"
+          "id": "patch-plan",
+          "abstractType": "WorkItems",
+          "path": "snapshots",
+          "description": "Draft patch / scored fields for the writer step"
         }
       ],
       "invocation": {
         "kind": "worker",
-        "operation": "complete"
+        "operation": "enrich-priority"
       }
     }
   ],
@@ -837,21 +932,6 @@
         {
           "id": "promote",
           "kind": "promote-snapshots"
-        },
-        {
-          "id": "normalize-svc",
-          "kind": "invoke-service",
-          "serviceId": "opx-normalize"
-        },
-        {
-          "id": "complete",
-          "kind": "completion",
-          "serviceId": "opx-completion",
-          "mappingId": "opx-work-items-completion-priority",
-          "completionPolicy": {
-            "mode": "fill-missing",
-            "maxFields": 20
-          }
         }
       ]
     },
@@ -930,15 +1010,27 @@
           "contentType": "workflow"
         }
       ]
-    }
-  ],
-  "schedules": [
+    },
     {
-      "id": "opx-knowledge-hourly",
-      "pipelineId": "opx-knowledge-pull",
-      "cron": "0 * * * *",
-      "timezone": "UTC",
-      "enabled": true
+      "id": "opx-enrich-priority",
+      "name": "Enrich WI priority (draft then write)",
+      "trigger": "explicit",
+      "description": "Capture snapshot \u2192 enrich service (opx-enrich-priority) \u2192 write-record. Runtime v2 uses stepKind enrich + serviceId.",
+      "steps": [
+        {
+          "id": "enrich",
+          "kind": "enrich",
+          "serviceId": "opx-enrich-priority"
+        },
+        {
+          "id": "write",
+          "kind": "write-record",
+          "contentType": "snapshots"
+        }
+      ]
     }
-  ]
+  ],
+  "schedules": [],
+  "kindDeclarations": [],
+  "extensions": {}
 }