@x12i/memorix-metadata 3.0.1 → 3.0.3

package/examples/knowx/normalized/pack.json

@@ -0,0 +1,579 @@
+{
+  "format": "memorix-metadata/1",
+  "agentId": "knowx",
+  "version": "0.1.0",
+  "agents": [
+    {
+      "id": "opx",
+      "name": "Operations (generic parent)",
+      "description": "Complete generic parent agent for ordinary operational work. Permanent Memorix acceptance pack.",
+      "parentId": null
+    },
+    {
+      "id": "knowx",
+      "name": "KnowX (knowledge agent)",
+      "description": "First-party KnowX agent: extract knowledge from text+source, associate to existing knowledge, associate novel knowledge to entities. Child of opx — inherits domain subjects.",
+      "parentId": "opx"
+    }
+  ],
+  "objectTypes": [
+    {
+      "id": "employees",
+      "name": "Employees",
+      "dataCategory": "entity",
+      "abstractTypes": [
+        "People",
+        "KnowXEntity"
+      ],
+      "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": "knowx",
+          "notes": "KnowX NODE facet — provenance required in .data"
+        }
+      ]
+    },
+    {
+      "id": "contractors",
+      "name": "Contractors",
+      "dataCategory": "entity",
+      "abstractTypes": [
+        "People",
+        "KnowXEntity"
+      ],
+      "contentTypes": [
+        {
+          "id": "raw"
+        },
+        {
+          "id": "snapshots"
+        },
+        {
+          "id": "discovery",
+          "discriminator": {
+            "path": "data.discoveryType",
+            "required": false
+          }
+        },
+        {
+          "id": "analysis",
+          "discriminator": {
+            "path": "data.analysisType",
+            "required": false
+          }
+        },
+        {
+          "id": "relationships"
+        },
+        {
+          "id": "knowx",
+          "notes": "KnowX NODE facet — provenance required in .data"
+        }
+      ]
+    },
+    {
+      "id": "work-items",
+      "name": "Work Items",
+      "dataCategory": "entity",
+      "abstractTypes": [
+        "WorkItems",
+        "KnowXEntity"
+      ],
+      "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"
+        },
+        {
+          "id": "knowx",
+          "notes": "KnowX NODE facet — provenance required in .data"
+        }
+      ],
+      "snapshotBuckets": {
+        "analytics": "optional",
+        "enrichment": "optional",
+        "insights": "optional"
+      }
+    },
+    {
+      "id": "assertions",
+      "name": "Assertions",
+      "dataCategory": "knowledge",
+      "abstractTypes": [
+        "KnowXEntity"
+      ],
+      "contentTypes": [
+        {
+          "id": "knowx",
+          "required": true,
+          "notes": "EDGE claims — data.kind EDGE; provenance mandatory"
+        },
+        {
+          "id": "workflow",
+          "notes": "Human review assignment sibling"
+        },
+        {
+          "id": "confirmations",
+          "notes": "Accept/reject decision sibling"
+        }
+      ]
+    },
+    {
+      "id": "content",
+      "name": "Content",
+      "dataCategory": "knowledge",
+      "abstractTypes": [],
+      "contentTypes": [
+        {
+          "id": "raw",
+          "required": true,
+          "notes": "Landed from knowx-source Memory pull or folder ingestion"
+        },
+        {
+          "id": "snapshots",
+          "required": false,
+          "notes": "Post-processing promote after knowledge pull"
+        }
+      ]
+    }
+  ],
+  "abstractTypes": [
+    {
+      "id": "People",
+      "name": "People",
+      "meaning": "Employees and contractors who perform operational work",
+      "category": "entity",
+      "properties": [
+        {
+          "id": "title",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "role",
+          "valueType": "string",
+          "required": true
+        },
+        {
+          "id": "lens",
+          "valueType": "string",
+          "required": false
+        }
+      ]
+    },
+    {
+      "id": "WorkItems",
+      "name": "Work Items",
+      "meaning": "Units of operational work",
+      "category": "entity"
+    },
+    {
+      "id": "KnowXEntity",
+      "name": "KnowX Entity",
+      "meaning": "Virtual union of subjects that carry knowx content (NODE facets and EDGE assertions). Not a collection.",
+      "category": "knowledge"
+    }
+  ],
+  "abstractBindings": [
+    {
+      "id": "knowx-entity-union",
+      "abstractType": "KnowXEntity",
+      "concreteObjectTypes": [
+        "employees",
+        "contractors",
+        "work-items",
+        "assertions"
+      ],
+      "union": true,
+      "notes": "KnowXEntity = concrete types that may wear contentType knowx. No abstract records. Writers always target concrete object types."
+    }
+  ],
+  "relationshipDefinitions": [
+    {
+      "id": "knowx-same-as",
+      "name": "KnowX same as",
+      "meaning": "Extracted claim matches an existing KnowX claim (classification: known)",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "KnowXEntity",
+        "path": "sameAs"
+      },
+      "to": {
+        "abstractType": "KnowXEntity",
+        "path": "sameAsFrom"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-associate-knowledge-known",
+          "kind": "service-plan",
+          "sourcePath": "known",
+          "notes": "Emitted by knowx-associate-knowledge relationship plans"
+        }
+      ]
+    },
+    {
+      "id": "knowx-supports",
+      "name": "KnowX supports",
+      "meaning": "A KnowX claim reinforces or supports another KnowX claim",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "KnowXEntity",
+        "path": "supports"
+      },
+      "to": {
+        "abstractType": "KnowXEntity",
+        "path": "supportedBy"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-associate-knowledge-supports",
+          "kind": "service-plan",
+          "sourcePath": "supports",
+          "notes": "Optional support links from associate-knowledge plans"
+        }
+      ]
+    },
+    {
+      "id": "knowx-contradicts",
+      "name": "KnowX contradicts",
+      "meaning": "A KnowX claim conflicts with an existing KnowX claim (classification: contradicts)",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "KnowXEntity",
+        "path": "contradicts"
+      },
+      "to": {
+        "abstractType": "KnowXEntity",
+        "path": "contradictedBy"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-associate-knowledge-contradicts",
+          "kind": "service-plan",
+          "sourcePath": "contradicts",
+          "notes": "Emitted by knowx-associate-knowledge relationship plans"
+        }
+      ]
+    },
+    {
+      "id": "knowx-derived-from",
+      "name": "KnowX derived from",
+      "meaning": "A KnowX claim is sourced or derived from another KnowX claim",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "KnowXEntity",
+        "path": "derivedFrom"
+      },
+      "to": {
+        "abstractType": "KnowXEntity",
+        "path": "derivations"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-associate-knowledge-derived",
+          "kind": "service-plan",
+          "sourcePath": "derivedFrom",
+          "notes": "Optional derivation links from associate-knowledge plans"
+        }
+      ]
+    },
+    {
+      "id": "knowx-edge-from",
+      "name": "KnowX edge from",
+      "meaning": "Structural link from an EDGE assertion to its domain from-endpoint subject",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "KnowXEntity",
+        "path": "edgeFrom"
+      },
+      "to": {
+        "abstractType": "KnowXEntity",
+        "path": "incomingKnowxEdges"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-edge-refs-from",
+          "kind": "knowx-refs",
+          "sourcePath": "data.refs.from",
+          "notes": "Emitted by knowx-associate-entities from EDGE refs.from"
+        }
+      ]
+    },
+    {
+      "id": "knowx-edge-to",
+      "name": "KnowX edge to",
+      "meaning": "Structural link from an EDGE assertion to its domain to-endpoint subject",
+      "directionality": "directed",
+      "from": {
+        "abstractType": "KnowXEntity",
+        "path": "edgeTo"
+      },
+      "to": {
+        "abstractType": "KnowXEntity",
+        "path": "incomingKnowxEdgesTo"
+      },
+      "discoveryRules": [
+        {
+          "id": "from-edge-refs-to",
+          "kind": "knowx-refs",
+          "sourcePath": "data.refs.to",
+          "notes": "Emitted by knowx-associate-entities from EDGE refs.to"
+        }
+      ]
+    }
+  ],
+  "mappings": [],
+  "views": [],
+  "writes": [],
+  "sources": [
+    {
+      "id": "knowx-source",
+      "name": "KnowX knowledge fixture source",
+      "kind": "rest-fixture",
+      "baseUrlEnv": "KNOWX_SOURCE_URL",
+      "defaultBaseUrl": "http://127.0.0.1:5104",
+      "credentialRef": "knowx-source-local",
+      "connectorRef": "knowx-fixture",
+      "endpoints": [
+        "/content"
+      ],
+      "pagination": {
+        "style": "cursor",
+        "defaultPageSize": 50
+      },
+      "routes": [
+        {
+          "endpoint": "/content",
+          "objectType": "content",
+          "dataCategory": "knowledge",
+          "identityPath": "id",
+          "primaryKind": "contentId",
+          "modes": [
+            "knowledge"
+          ],
+          "pageSize": 10
+        }
+      ]
+    }
+  ],
+  "services": [
+    {
+      "id": "knowx-extract",
+      "name": "KnowX extract",
+      "description": "Extract KnowX NODE/EDGE drafts from text + knowledge source. Returns drafts only — does not persist. Pipeline write-record applies knowx content.",
+      "capabilities": [
+        "analyze"
+      ],
+      "inputs": [
+        {
+          "id": "text",
+          "description": "Input text to analyze (inline string or resolved from source)"
+        },
+        {
+          "id": "knowledgeSource",
+          "description": "Exact source bytes / Memory DataRef + provenance envelope (docId, docType, retrievedAt)"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "knowxDrafts",
+          "description": "Array of knowx content drafts (NODE facets + EDGE assertions) with mandatory provenance"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-extract"
+      }
+    },
+    {
+      "id": "knowx-associate-knowledge",
+      "name": "KnowX associate knowledge",
+      "description": "Classify extracted drafts against existing KnowX scope: known, novel, contradicts. Returns classification buckets + candidate knowledge relationship plans. Does not persist.",
+      "capabilities": [
+        "analyze"
+      ],
+      "inputs": [
+        {
+          "id": "drafts",
+          "description": "KnowX drafts from knowx-extract (or already written knowx content)"
+        },
+        {
+          "id": "existingKnowx",
+          "description": "Existing KnowXEntity scope (contentType=knowx records in org)"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "classification",
+          "description": "{ known[], novel[], contradicts[] } draft/claim references"
+        },
+        {
+          "id": "relationshipPlans",
+          "description": "Candidate four-field plans for knowx-same-as / knowx-supports / knowx-contradicts / knowx-derived-from"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-associate-knowledge"
+      }
+    },
+    {
+      "id": "knowx-associate-entities",
+      "name": "KnowX associate entities",
+      "description": "Associate novel KnowX drafts to existing domain entities. Returns entity link candidate plans (knowx-edge-from/to and/or domain defs). Does not persist.",
+      "capabilities": [
+        "analyze"
+      ],
+      "inputs": [
+        {
+          "id": "novelDrafts",
+          "description": "Novel KnowX drafts from knowx-associate-knowledge classification"
+        },
+        {
+          "id": "entityCatalog",
+          "description": "Entity subjects / abstract projections available in scope (People, WorkItems, …)"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "entityRelationshipPlans",
+          "description": "Candidate four-field plans for knowx-edge-from / knowx-edge-to (and optional domain relationship defs)"
+        }
+      ],
+      "invocation": {
+        "kind": "worker",
+        "operation": "knowx-associate-entities"
+      }
+    }
+  ],
+  "pipelines": [
+    {
+      "id": "knowx-knowledge-pull",
+      "name": "Scheduled knowledge pull from knowx-source",
+      "trigger": "scheduled",
+      "mode": "knowledge",
+      "steps": [
+        {
+          "id": "pull",
+          "kind": "memory-pull",
+          "sourceId": "knowx-source"
+        },
+        {
+          "id": "land-raw",
+          "kind": "write-raw"
+        },
+        {
+          "id": "normalize",
+          "kind": "normalize"
+        },
+        {
+          "id": "promote",
+          "kind": "promote-snapshots"
+        }
+      ]
+    },
+    {
+      "id": "knowx-ingest-associate",
+      "name": "KnowX ingest then associate knowledge and entities",
+      "trigger": "explicit",
+      "description": "extract → write knowx → associate-knowledge → relationship-write → associate-entities → relationship-write. Services do not persist; write-record and relationship-write do. Deterministic fixtures; no live AI required.",
+      "steps": [
+        {
+          "id": "extract",
+          "kind": "analyze",
+          "serviceId": "knowx-extract"
+        },
+        {
+          "id": "write-knowx",
+          "kind": "write-record",
+          "contentType": "knowx"
+        },
+        {
+          "id": "associate-knowledge",
+          "kind": "analyze",
+          "serviceId": "knowx-associate-knowledge"
+        },
+        {
+          "id": "write-knowledge-links",
+          "kind": "relationship-write",
+          "notes": "Consumes relationshipPlans → knowx-same-as / knowx-supports / knowx-contradicts / knowx-derived-from"
+        },
+        {
+          "id": "associate-entities",
+          "kind": "analyze",
+          "serviceId": "knowx-associate-entities"
+        },
+        {
+          "id": "write-entity-links",
+          "kind": "relationship-write",
+          "notes": "Consumes entityRelationshipPlans → knowx-edge-from / knowx-edge-to"
+        }
+      ]
+    }
+  ],
+  "schedules": [],
+  "kindDeclarations": [],
+  "extensions": {}
+}