@elevasis/core 0.23.0 → 0.24.0

package/dist/knowledge/index.js

@@ -1,7 +1,104 @@
+import { z } from 'zod';
+
+// src/organization-model/ontology.ts
+var OntologyKindSchema = z.enum([
+  "object",
+  "link",
+  "action",
+  "catalog",
+  "event",
+  "interface",
+  "value-type",
+  "property",
+  "group",
+  "surface"
+]);
+var SYSTEM_PATH_PATTERN = "[a-z0-9][a-z0-9-]*(?:\\.[a-z0-9][a-z0-9-]*)*";
+var LOCAL_ID_PATTERN = "[a-z0-9][a-z0-9._-]*";
+var ONTOLOGY_ID_PATTERN = `^(global|${SYSTEM_PATH_PATTERN}):(${OntologyKindSchema.options.join("|")})\\/(${LOCAL_ID_PATTERN})$`;
+var ONTOLOGY_ID_REGEX = new RegExp(ONTOLOGY_ID_PATTERN);
+var OntologyIdSchema = z.string().trim().min(1).max(300).regex(
+  ONTOLOGY_ID_REGEX,
+  "Ontology IDs must use <system-path>:<kind>/<local-id> or global:<kind>/<local-id>"
+);
+var OntologyReferenceListSchema = z.array(OntologyIdSchema).default([]).optional();
+var OntologyRecordBaseSchema = z.object({
+  id: OntologyIdSchema,
+  label: z.string().trim().min(1).max(160).optional(),
+  description: z.string().trim().min(1).max(2e3).optional(),
+  ownerSystemId: z.string().trim().min(1).max(200).optional(),
+  aliases: z.array(OntologyIdSchema).optional()
+}).passthrough();
+var OntologyObjectTypeSchema = OntologyRecordBaseSchema.extend({
+  properties: z.record(z.string().trim().min(1).max(200), z.unknown()).optional(),
+  storage: z.record(z.string(), z.unknown()).optional()
+});
+var OntologyLinkTypeSchema = OntologyRecordBaseSchema.extend({
+  from: OntologyIdSchema,
+  to: OntologyIdSchema,
+  cardinality: z.string().trim().min(1).max(80).optional(),
+  via: z.string().trim().min(1).max(255).optional()
+});
+var OntologyActionTypeSchema = OntologyRecordBaseSchema.extend({
+  actsOn: OntologyReferenceListSchema,
+  input: z.record(z.string().trim().min(1).max(200), z.unknown()).optional(),
+  effects: z.array(z.record(z.string(), z.unknown())).optional()
+});
+var OntologyCatalogTypeSchema = OntologyRecordBaseSchema.extend({
+  kind: z.string().trim().min(1).max(120).optional(),
+  appliesTo: OntologyIdSchema.optional(),
+  entries: z.record(z.string().trim().min(1).max(200), z.unknown()).optional()
+});
+var OntologyEventTypeSchema = OntologyRecordBaseSchema.extend({
+  payload: z.record(z.string().trim().min(1).max(200), z.unknown()).optional()
+});
+var OntologyInterfaceTypeSchema = OntologyRecordBaseSchema.extend({
+  properties: z.record(z.string().trim().min(1).max(200), z.unknown()).optional()
+});
+var OntologyValueTypeSchema = OntologyRecordBaseSchema.extend({
+  primitive: z.string().trim().min(1).max(120).optional()
+});
+var OntologySharedPropertySchema = OntologyRecordBaseSchema.extend({
+  valueType: OntologyIdSchema.optional(),
+  searchable: z.boolean().optional(),
+  pii: z.boolean().optional()
+});
+var OntologyGroupSchema = OntologyRecordBaseSchema.extend({
+  members: OntologyReferenceListSchema
+});
+var OntologySurfaceTypeSchema = OntologyRecordBaseSchema.extend({
+  route: z.string().trim().min(1).max(500).optional()
+});
+z.object({
+  objectTypes: z.record(OntologyIdSchema, OntologyObjectTypeSchema).default({}).optional(),
+  linkTypes: z.record(OntologyIdSchema, OntologyLinkTypeSchema).default({}).optional(),
+  actionTypes: z.record(OntologyIdSchema, OntologyActionTypeSchema).default({}).optional(),
+  catalogTypes: z.record(OntologyIdSchema, OntologyCatalogTypeSchema).default({}).optional(),
+  eventTypes: z.record(OntologyIdSchema, OntologyEventTypeSchema).default({}).optional(),
+  interfaceTypes: z.record(OntologyIdSchema, OntologyInterfaceTypeSchema).default({}).optional(),
+  valueTypes: z.record(OntologyIdSchema, OntologyValueTypeSchema).default({}).optional(),
+  sharedProperties: z.record(OntologyIdSchema, OntologySharedPropertySchema).default({}).optional(),
+  groups: z.record(OntologyIdSchema, OntologyGroupSchema).default({}).optional(),
+  surfaces: z.record(OntologyIdSchema, OntologySurfaceTypeSchema).default({}).optional()
+}).default({});
+function ontologyGraphNodeId(id) {
+  return `ontology:${OntologyIdSchema.parse(id)}`;
+}
+
 // src/knowledge/queries.ts
 function toGraphNodeId(omNodeId) {
   return `knowledge:${omNodeId}`;
 }
+function toTargetGraphNodeId(nodeId) {
+  if (nodeId.startsWith("system:") || nodeId.startsWith("knowledge:") || nodeId.startsWith("resource:") || nodeId.startsWith("content-node:") || nodeId.startsWith("ontology:")) {
+    return nodeId;
+  }
+  const ontologyId = OntologyIdSchema.safeParse(nodeId);
+  if (ontologyId.success) {
+    return ontologyGraphNodeId(ontologyId.data);
+  }
+  return `system:${nodeId}`;
+}
 function buildKnowledgeSourceIdMap(graph) {
   const map = /* @__PURE__ */ new Map();
   for (const node of graph.nodes) {
@@ -44,7 +141,7 @@ function governs(graph, nodeId) {
   return results;
 }
 function governedBy(graph, nodeId) {
-  const targetId = nodeId.startsWith("system:") || nodeId.startsWith("knowledge:") || nodeId.startsWith("resource:") ? nodeId : `system:${nodeId}`;
+  const targetId = toTargetGraphNodeId(nodeId);
   const results = [];
   for (const edge of graph.edges) {
     if (edge.kind === "governs" && edge.targetId === targetId) {
@@ -72,6 +169,12 @@ function parsePath(pathString) {
     }
     return { mount: "by-system", args: [rest.join("/")] };
   }
+  if (first === "by-ontology") {
+    if (rest.length === 0) {
+      throw new Error(`parsePath: /by-ontology requires an ontologyId argument, got: "${pathString}"`);
+    }
+    return { mount: "by-ontology", args: [rest.join("/")] };
+  }
   if (first === "by-kind") {
     if (rest.length === 0) {
       throw new Error(`parsePath: /by-kind requires a kind argument, got: "${pathString}"`);