@x12i/memorix-metadata 0.0.0-bootstrap.0

package/examples/ops/raw/abstract-bindings.json

@@ -0,0 +1,38 @@
+{
+  "bindings": [
+    {
+      "id": "people-employees-contractors",
+      "abstractType": "People",
+      "concreteObjectTypes": [
+        "employees",
+        "contractors"
+      ],
+      "union": true,
+      "notes": "People = Employees ∪ Contractors. No abstract records exist."
+    },
+    {
+      "id": "work-items-concrete",
+      "abstractType": "WorkItems",
+      "concreteObjectTypes": [
+        "work-items"
+      ],
+      "union": false
+    },
+    {
+      "id": "procedures-concrete",
+      "abstractType": "Procedures",
+      "concreteObjectTypes": [
+        "procedures"
+      ],
+      "union": false
+    },
+    {
+      "id": "activity-events-concrete",
+      "abstractType": "ActivityEvents",
+      "concreteObjectTypes": [
+        "activity-events"
+      ],
+      "union": false
+    }
+  ]
+}

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

@@ -0,0 +1,28 @@
+{
+  "abstractTypes": [
+    {
+      "id": "People",
+      "name": "People",
+      "meaning": "Employees and contractors who perform operational work",
+      "category": "entity"
+    },
+    {
+      "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"
+    }
+  ]
+}

package/examples/ops/raw/agents.json

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

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

@@ -0,0 +1,170 @@
+{
+  "objectTypes": [
+    {
+      "id": "employees",
+      "name": "Employees",
+      "dataCategory": "entity",
+      "abstractTypes": [
+        "People"
+      ],
+      "contentTypes": [
+        {
+          "id": "raw",
+          "required": true
+        },
+        {
+          "id": "snapshots",
+          "required": true
+        },
+        {
+          "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": "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": "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": "procedures",
+      "name": "Procedures",
+      "dataCategory": "knowledge",
+      "abstractTypes": [
+        "Procedures"
+      ],
+      "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/raw/pipelines-and-sources.json

@@ -0,0 +1,185 @@
+{
+  "pipelineDefinitions": [
+    {
+      "id": "ops-knowledge-pull",
+      "name": "Scheduled knowledge pull from ops-source",
+      "trigger": "scheduled",
+      "mode": "knowledge",
+      "steps": [
+        {
+          "id": "pull",
+          "kind": "memory-pull",
+          "sourceId": "ops-source"
+        },
+        {
+          "id": "land-raw",
+          "kind": "write-raw"
+        },
+        {
+          "id": "normalize",
+          "kind": "normalize"
+        },
+        {
+          "id": "promote",
+          "kind": "promote-snapshots"
+        }
+      ]
+    },
+    {
+      "id": "ops-context-pull",
+      "name": "On-demand work-item context pull",
+      "trigger": "on-demand",
+      "mode": "context",
+      "steps": [
+        {
+          "id": "pull",
+          "kind": "memory-pull",
+          "sourceId": "ops-source"
+        },
+        {
+          "id": "land-raw",
+          "kind": "write-raw"
+        },
+        {
+          "id": "normalize-context",
+          "kind": "normalize-context"
+        },
+        {
+          "id": "ttl",
+          "kind": "apply-ttl"
+        }
+      ]
+    },
+    {
+      "id": "ops-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": "ops-analysis",
+      "name": "Work-item analysis sibling",
+      "trigger": "explicit",
+      "steps": [
+        {
+          "id": "analyze",
+          "kind": "analysis"
+        },
+        {
+          "id": "write-sibling",
+          "kind": "write-content",
+          "contentType": "analysis"
+        }
+      ]
+    },
+    {
+      "id": "ops-workflow",
+      "name": "Work-item workflow sibling",
+      "trigger": "explicit",
+      "steps": [
+        {
+          "id": "sync-workflow",
+          "kind": "workflow-sync"
+        },
+        {
+          "id": "write-sibling",
+          "kind": "write-content",
+          "contentType": "workflow"
+        }
+      ]
+    }
+  ],
+  "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",
+      "endpoints": [
+        "/employees",
+        "/contractors",
+        "/work-items",
+        "/activity-events",
+        "/procedures",
+        "/work-items/:id/context"
+      ],
+      "pagination": {
+        "style": "cursor",
+        "defaultPageSize": 50
+      },
+      "retention": {
+        "context": {
+          "ttlSeconds": 3600,
+          "discardOnWorkCompletion": true
+        }
+      },
+      "routes": [
+        {
+          "endpoint": "/procedures",
+          "objectType": "procedures",
+          "dataCategory": "knowledge",
+          "identityPath": "id",
+          "primaryKind": "procedureId",
+          "modes": ["knowledge"],
+          "pageSize": 2
+        },
+        {
+          "endpoint": "/work-items/:id/context",
+          "objectType": "work-items",
+          "dataCategory": "entity",
+          "identityPath": "workItemId",
+          "primaryKind": "workItemId",
+          "modes": ["context"]
+        },
+        {
+          "endpoint": "/work-items",
+          "objectType": "work-items",
+          "dataCategory": "entity",
+          "identityPath": "id",
+          "primaryKind": "workItemId",
+          "modes": ["knowledge"]
+        },
+        {
+          "endpoint": "/employees",
+          "objectType": "employees",
+          "dataCategory": "entity",
+          "identityPath": "id",
+          "primaryKind": "employeeId",
+          "modes": ["knowledge"]
+        },
+        {
+          "endpoint": "/contractors",
+          "objectType": "contractors",
+          "dataCategory": "entity",
+          "identityPath": "id",
+          "primaryKind": "contractorId",
+          "modes": ["knowledge"]
+        },
+        {
+          "endpoint": "/activity-events",
+          "objectType": "activity-events",
+          "dataCategory": "event",
+          "identityPath": "id",
+          "primaryKind": "activityEventId",
+          "modes": ["knowledge"]
+        }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,110 @@
+{
+  "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",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "People",
+        "property": "assignedWorkItems"
+      },
+      "to": {
+        "abstractType": "WorkItems",
+        "property": "assignedPeople"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-source-assignee",
+          "kind": "source-field",
+          "sourcePath": "assigneeId",
+          "notes": "ops-source work-items.assigneeId resolves across employees and contractors"
+        }
+      ]
+    },
+    {
+      "id": "work-items-use-procedures",
+      "name": "Work items use procedures",
+      "meaning": "A work item follows one or more reusable procedures",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "WorkItems",
+        "property": "usedProcedures"
+      },
+      "to": {
+        "abstractType": "Procedures",
+        "property": "usedByWorkItems"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-source-procedure-ids",
+          "kind": "source-field",
+          "sourcePath": "procedureIds"
+        }
+      ]
+    },
+    {
+      "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"
+        }
+      ]
+    }
+  ]
+}

package/examples/ops/raw/view-definitions.json

@@ -0,0 +1,46 @@
+{
+  "viewDefinitions": [
+    {
+      "id": "ops-work-items-list",
+      "kind": "list",
+      "objectType": "work-items",
+      "title": "Work items",
+      "columns": [
+        "concept.title",
+        "data.status",
+        "data.priority"
+      ]
+    },
+    {
+      "id": "ops-work-items-item",
+      "kind": "item",
+      "objectType": "work-items",
+      "title": "Work item",
+      "sections": [
+        "concept",
+        "data",
+        "workflow",
+        "analysis",
+        "decisions"
+      ]
+    },
+    {
+      "id": "ops-people-list",
+      "kind": "list",
+      "abstractType": "People",
+      "title": "People",
+      "columns": [
+        "concept.title",
+        "objectType",
+        "data.role"
+      ]
+    },
+    {
+      "id": "ops-work-item-expand-people",
+      "kind": "relationship-expansion",
+      "objectType": "work-items",
+      "relationshipDefinitionId": "people-assigned-to-work-items",
+      "direction": "to-from"
+    }
+  ]
+}