@elevasis/core 0.22.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) {
@@ -11,8 +108,8 @@ function buildKnowledgeSourceIdMap(graph) {
   }
   return map;
 }
-function byFeature(graph, featureId, knowledgeNodes) {
-  const targetGraphNodeId = `feature:${featureId}`;
+function bySystem(graph, systemId, knowledgeNodes) {
+  const targetGraphNodeId = `system:${systemId}`;
   const governingKnowledgeNodeIds = /* @__PURE__ */ new Set();
   for (const edge of graph.edges) {
     if (edge.kind === "governs" && edge.targetId === targetGraphNodeId && edge.sourceId.startsWith("knowledge:")) {
@@ -44,7 +141,7 @@ function governs(graph, nodeId) {
   return results;
 }
 function governedBy(graph, nodeId) {
-  const targetId = nodeId.startsWith("feature:") || nodeId.startsWith("knowledge:") || nodeId.startsWith("resource:") ? nodeId : `feature:${nodeId}`;
+  const targetId = toTargetGraphNodeId(nodeId);
   const results = [];
   for (const edge of graph.edges) {
     if (edge.kind === "governs" && edge.targetId === targetId) {
@@ -66,11 +163,17 @@ function parsePath(pathString) {
     throw new Error(`parsePath: path resolves to root with no mount: "${pathString}"`);
   }
   const [first, ...rest] = segments;
-  if (first === "by-feature") {
+  if (first === "by-system") {
+    if (rest.length === 0) {
+      throw new Error(`parsePath: /by-system requires a systemId argument, got: "${pathString}"`);
+    }
+    return { mount: "by-system", args: [rest.join("/")] };
+  }
+  if (first === "by-ontology") {
     if (rest.length === 0) {
-      throw new Error(`parsePath: /by-feature requires a featureId argument, got: "${pathString}"`);
+      throw new Error(`parsePath: /by-ontology requires an ontologyId argument, got: "${pathString}"`);
     }
-    return { mount: "by-feature", args: [rest.join("/")] };
+    return { mount: "by-ontology", args: [rest.join("/")] };
   }
   if (first === "by-kind") {
     if (rest.length === 0) {
@@ -101,7 +204,7 @@ function parsePath(pathString) {
     return { mount: "node", args: [first] };
   }
   throw new Error(
-    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-feature/<id>, /by-kind/<kind>, /by-owner/<id>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>`
+    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-system/<id>, /by-kind/<kind>, /by-owner/<id>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>`
   );
 }
 
@@ -116,7 +219,7 @@ function formatText(results) {
   const divider = "-".repeat(header.length + 20);
   const rows = results.map((n) => {
     const summary = n.summary.length > 80 ? n.summary.slice(0, 77) + "..." : n.summary;
-    return `${n.kind.padEnd(kindWidth)}  ${n.id.padEnd(idWidth)}  ${n.title}  \u2014  ${summary}`;
+    return `${n.kind.padEnd(kindWidth)}  ${n.id.padEnd(idWidth)}  ${n.title}  \xE2\u20AC\u201D  ${summary}`;
   });
   return [header, divider, ...rows].join("\n");
 }
@@ -135,4 +238,4 @@ function formatIdsOnly(results) {
   return ids.join("\n");
 }
 
-export { byFeature, byKind, byOwner, formatIdsOnly, formatJson, formatText, governedBy, governs, parsePath };
+export { byKind, byOwner, bySystem, formatIdsOnly, formatJson, formatText, governedBy, governs, parsePath };