@elevasis/core 0.15.1 → 0.16.0

package/src/organization-model/domains/shared.ts

@@ -1,4 +1,5 @@
-import { z } from 'zod'
+import { z } from 'zod'
+import { OrganizationModelIconTokenSchema } from '../icons'
 
 export const ModelIdSchema = z
   .string()
@@ -8,10 +9,10 @@ export const ModelIdSchema = z
   .regex(/^[a-z0-9]+(?:[-._][a-z0-9]+)*$/, 'IDs must be lowercase and use -, _, or . separators')
 
 export const LabelSchema = z.string().trim().min(1).max(120)
-export const DescriptionSchema = z.string().trim().min(1).max(2000)
-export const ColorTokenSchema = z.string().trim().min(1).max(50)
-export const IconNameSchema = z.string().trim().min(1).max(80)
-export const PathSchema = z.string().trim().startsWith('/').max(300)
+export const DescriptionSchema = z.string().trim().min(1).max(2000)
+export const ColorTokenSchema = z.string().trim().min(1).max(50)
+export const IconNameSchema = OrganizationModelIconTokenSchema
+export const PathSchema = z.string().trim().startsWith('/').max(300)
 
 export const ReferenceIdsSchema = z.array(ModelIdSchema).default([])
 

package/src/organization-model/foundation.ts

@@ -1,9 +1,13 @@
 import { resolveOrganizationModel } from './resolve'
+import type { OrganizationModelBuiltinIconToken } from './icons'
 import type { DeepPartial, OrganizationModel, OrganizationModelFeature } from './types'
 
 export type FoundationSurfaceType = 'page' | 'dashboard' | 'graph' | 'detail' | 'list' | 'settings'
 
-export type FoundationSurfaceIcon = 'dashboard' | 'crm' | 'lead-gen' | 'projects' | 'operations' | 'settings'
+export type FoundationSurfaceIcon = Extract<
+  OrganizationModelBuiltinIconToken,
+  'feature.dashboard' | 'feature.crm' | 'feature.lead-gen' | 'feature.projects' | 'feature.operations' | 'feature.settings'
+>
 
 export interface FoundationNavigationSurface extends Omit<OrganizationModelFeature, 'icon' | 'uiPosition'> {
   icon?: FoundationSurfaceIcon
@@ -50,11 +54,11 @@ export function createFoundationOrganizationModel(override: DeepPartial<Organiza
   const crmFeature = requireCoreFeature('sales.crm')
 
   const navigationSurfaces: FoundationNavigationSurface[] = [
-    { ...operationsFeature, id: 'operations', path: '/operations', icon: 'operations', surfaceType: 'dashboard' },
-    { ...projectsFeature, icon: 'projects', surfaceType: 'list' },
-    { ...leadGenFeature, id: 'lead-gen', icon: 'lead-gen', surfaceType: 'list' },
-    { ...crmFeature, id: 'crm', icon: 'crm', surfaceType: 'graph' },
-    { ...requireCoreFeature('settings.account'), id: 'settings', icon: 'settings', surfaceType: 'settings' }
+    { ...operationsFeature, id: 'operations', path: '/operations', icon: 'feature.operations', surfaceType: 'dashboard' },
+    { ...projectsFeature, icon: 'feature.projects', surfaceType: 'list' },
+    { ...leadGenFeature, id: 'lead-gen', icon: 'feature.lead-gen', surfaceType: 'list' },
+    { ...crmFeature, id: 'crm', icon: 'feature.crm', surfaceType: 'graph' },
+    { ...requireCoreFeature('settings.account'), id: 'settings', icon: 'feature.settings', surfaceType: 'settings' }
   ]
 
   const homeLabel = 'Dashboard'

package/src/organization-model/graph/build.ts

@@ -1,100 +1,100 @@
-import { BuildOrganizationGraphInputSchema, OrganizationGraphSchema } from './schema'
-import type { CommandViewData } from '../../platform/registry/command-view'
-import type {
-  BuildOrganizationGraphInput,
-  OrganizationGraph,
-  OrganizationGraphEdge,
-  OrganizationGraphNode,
-  OrganizationGraphNodeKind
-} from './types'
-
-function nodeId(kind: OrganizationGraphNodeKind, sourceId?: string): string {
-  return kind === 'organization' ? 'organization-model' : `${kind}:${sourceId ?? ''}`
-}
-
-function edgeId(kind: string, sourceId: string, targetId: string, variant?: string): string {
-  return variant ? `edge:${kind}:${variant}:${sourceId}:${targetId}` : `edge:${kind}:${sourceId}:${targetId}`
-}
-
-function pushUniqueNode(nodes: OrganizationGraphNode[], seen: Set<string>, node: OrganizationGraphNode): void {
-  if (seen.has(node.id)) return
-  seen.add(node.id)
-  nodes.push(node)
-}
-
-function pushUniqueEdge(edges: OrganizationGraphEdge[], seen: Set<string>, edge: OrganizationGraphEdge): void {
-  if (seen.has(edge.id)) return
-  seen.add(edge.id)
-  edges.push(edge)
-}
-
-function upsertResourceNode(
-  nodes: OrganizationGraphNode[],
-  seen: Set<string>,
-  resourceNodesById: Map<string, OrganizationGraphNode>,
-  node: OrganizationGraphNode
-): OrganizationGraphNode {
-  const existing = resourceNodesById.get(node.id)
-  if (existing) {
-    if (!existing.label || existing.label === existing.sourceId) {
-      existing.label = node.label
-    }
-    if (!existing.description && node.description) {
-      existing.description = node.description
-    }
-    if (!existing.sourceId && node.sourceId) {
-      existing.sourceId = node.sourceId
-    }
-    if (!existing.resourceType && node.resourceType) {
-      existing.resourceType = node.resourceType
-    }
-    return existing
-  }
-
-  resourceNodesById.set(node.id, node)
-  pushUniqueNode(nodes, seen, node)
-  return node
-}
-
-function ensureResourceNode(
-  nodes: OrganizationGraphNode[],
-  seen: Set<string>,
-  resourceNodesById: Map<string, OrganizationGraphNode>,
-  resourceId: string
-): OrganizationGraphNode {
-  const existing = resourceNodesById.get(nodeId('resource', resourceId))
-  if (existing) return existing
-
-  return upsertResourceNode(nodes, seen, resourceNodesById, {
-    id: nodeId('resource', resourceId),
-    kind: 'resource',
-    label: resourceId,
-    sourceId: resourceId
-  })
-}
-
+import { BuildOrganizationGraphInputSchema, OrganizationGraphSchema } from './schema'
+import type { CommandViewData } from '../../platform/registry/command-view'
+import type {
+  BuildOrganizationGraphInput,
+  OrganizationGraph,
+  OrganizationGraphEdge,
+  OrganizationGraphNode,
+  OrganizationGraphNodeKind
+} from './types'
+
+function nodeId(kind: OrganizationGraphNodeKind, sourceId?: string): string {
+  return kind === 'organization' ? 'organization-model' : `${kind}:${sourceId ?? ''}`
+}
+
+function edgeId(kind: string, sourceId: string, targetId: string, variant?: string): string {
+  return variant ? `edge:${kind}:${variant}:${sourceId}:${targetId}` : `edge:${kind}:${sourceId}:${targetId}`
+}
+
+function pushUniqueNode(nodes: OrganizationGraphNode[], seen: Set<string>, node: OrganizationGraphNode): void {
+  if (seen.has(node.id)) return
+  seen.add(node.id)
+  nodes.push(node)
+}
+
+function pushUniqueEdge(edges: OrganizationGraphEdge[], seen: Set<string>, edge: OrganizationGraphEdge): void {
+  if (seen.has(edge.id)) return
+  seen.add(edge.id)
+  edges.push(edge)
+}
+
+function upsertResourceNode(
+  nodes: OrganizationGraphNode[],
+  seen: Set<string>,
+  resourceNodesById: Map<string, OrganizationGraphNode>,
+  node: OrganizationGraphNode
+): OrganizationGraphNode {
+  const existing = resourceNodesById.get(node.id)
+  if (existing) {
+    if (!existing.label || existing.label === existing.sourceId) {
+      existing.label = node.label
+    }
+    if (!existing.description && node.description) {
+      existing.description = node.description
+    }
+    if (!existing.sourceId && node.sourceId) {
+      existing.sourceId = node.sourceId
+    }
+    if (!existing.resourceType && node.resourceType) {
+      existing.resourceType = node.resourceType
+    }
+    return existing
+  }
+
+  resourceNodesById.set(node.id, node)
+  pushUniqueNode(nodes, seen, node)
+  return node
+}
+
+function ensureResourceNode(
+  nodes: OrganizationGraphNode[],
+  seen: Set<string>,
+  resourceNodesById: Map<string, OrganizationGraphNode>,
+  resourceId: string
+): OrganizationGraphNode {
+  const existing = resourceNodesById.get(nodeId('resource', resourceId))
+  if (existing) return existing
+
+  return upsertResourceNode(nodes, seen, resourceNodesById, {
+    id: nodeId('resource', resourceId),
+    kind: 'resource',
+    label: resourceId,
+    sourceId: resourceId
+  })
+}
+
 type CommandViewResource =
-  | CommandViewData['workflows'][number]
-  | CommandViewData['agents'][number]
-  | CommandViewData['triggers'][number]
-  | CommandViewData['integrations'][number]
-  | CommandViewData['externalResources'][number]
-  | CommandViewData['humanCheckpoints'][number]
-
-function normalizeCommandViewResourceType(
-  resourceType: CommandViewResource['type']
-): OrganizationGraphNode['resourceType'] {
-  return resourceType === 'human' ? 'human_checkpoint' : resourceType
-}
-
+  | CommandViewData['workflows'][number]
+  | CommandViewData['agents'][number]
+  | CommandViewData['triggers'][number]
+  | CommandViewData['integrations'][number]
+  | CommandViewData['externalResources'][number]
+  | CommandViewData['humanCheckpoints'][number]
+
+function normalizeCommandViewResourceType(
+  resourceType: CommandViewResource['type']
+): OrganizationGraphNode['resourceType'] {
+  return resourceType === 'human' ? 'human_checkpoint' : resourceType
+}
+
 function collectCommandViewResources(commandViewData: CommandViewData): CommandViewResource[] {
-  return [
-    ...commandViewData.workflows,
-    ...commandViewData.agents,
-    ...commandViewData.triggers,
-    ...commandViewData.integrations,
-    ...commandViewData.externalResources,
-    ...commandViewData.humanCheckpoints
+  return [
+    ...commandViewData.workflows,
+    ...commandViewData.agents,
+    ...commandViewData.triggers,
+    ...commandViewData.integrations,
+    ...commandViewData.externalResources,
+    ...commandViewData.humanCheckpoints
   ]
 }
 
@@ -113,40 +113,41 @@ function pushResourceLinks(
     })
   }
 }
-
-export function buildOrganizationGraph(input: BuildOrganizationGraphInput): OrganizationGraph {
-  const parsed = BuildOrganizationGraphInputSchema.parse(input)
-  const organizationModel = parsed.organizationModel
-  const commandViewData = parsed.commandViewData as CommandViewData | undefined
-
-  const nodes: OrganizationGraphNode[] = []
-  const edges: OrganizationGraphEdge[] = []
-  const nodeIds = new Set<string>()
-  const edgeIds = new Set<string>()
-  const resourceNodesById = new Map<string, OrganizationGraphNode>()
-
-  const organizationNode: OrganizationGraphNode = {
-    id: nodeId('organization'),
-    kind: 'organization',
-    label: 'Organization Model'
-  }
-  pushUniqueNode(nodes, nodeIds, organizationNode)
-
+
+export function buildOrganizationGraph(input: BuildOrganizationGraphInput): OrganizationGraph {
+  const parsed = BuildOrganizationGraphInputSchema.parse(input)
+  const organizationModel = parsed.organizationModel
+  const commandViewData = parsed.commandViewData as CommandViewData | undefined
+
+  const nodes: OrganizationGraphNode[] = []
+  const edges: OrganizationGraphEdge[] = []
+  const nodeIds = new Set<string>()
+  const edgeIds = new Set<string>()
+  const resourceNodesById = new Map<string, OrganizationGraphNode>()
+
+  const organizationNode: OrganizationGraphNode = {
+    id: nodeId('organization'),
+    kind: 'organization',
+    label: 'Organization Model'
+  }
+  pushUniqueNode(nodes, nodeIds, organizationNode)
+
   for (const feature of [...organizationModel.features].sort((a, b) => a.id.localeCompare(b.id))) {
     const id = nodeId('feature', feature.id)
-    pushUniqueNode(nodes, nodeIds, {
-      id,
-      kind: 'feature',
-      label: feature.label,
-      sourceId: feature.id,
-      description: feature.description,
-      enabled: feature.enabled,
-      featureId: feature.id
-    })
-    pushUniqueEdge(edges, edgeIds, {
-      id: edgeId('contains', organizationNode.id, id),
-      kind: 'contains',
-      sourceId: organizationNode.id,
+    pushUniqueNode(nodes, nodeIds, {
+      id,
+      kind: 'feature',
+      label: feature.label,
+      sourceId: feature.id,
+      description: feature.description,
+      icon: feature.icon,
+      enabled: feature.enabled,
+      featureId: feature.id
+    })
+    pushUniqueEdge(edges, edgeIds, {
+      id: edgeId('contains', organizationNode.id, id),
+      kind: 'contains',
+      sourceId: organizationNode.id,
       targetId: id
     })
     const parentId = feature.id.includes('.') ? feature.id.slice(0, feature.id.lastIndexOf('.')) : undefined
@@ -159,23 +160,49 @@ export function buildOrganizationGraph(input: BuildOrganizationGraphInput): Orga
       })
     }
   }
-
-  if (commandViewData) {
-    const commandViewResources = collectCommandViewResources(commandViewData).sort((a, b) =>
-      a.resourceId.localeCompare(b.resourceId)
-    )
-
-    for (const resource of commandViewResources) {
-      const id = nodeId('resource', resource.resourceId)
-      const resourceNode = upsertResourceNode(nodes, nodeIds, resourceNodesById, {
-        id,
-        kind: 'resource',
-        label: resource.name,
-        sourceId: resource.resourceId,
-        description: resource.description,
-        resourceType: normalizeCommandViewResourceType(resource.type)
-      })
-
+
+  for (const node of [...(organizationModel.knowledge?.nodes ?? [])].sort((a, b) => a.id.localeCompare(b.id))) {
+    const id = nodeId('knowledge', node.id)
+    pushUniqueNode(nodes, nodeIds, {
+      id,
+      kind: 'knowledge',
+      label: node.title,
+      sourceId: node.id,
+      description: node.summary,
+      icon: node.icon
+    })
+    pushUniqueEdge(edges, edgeIds, {
+      id: edgeId('contains', organizationNode.id, id),
+      kind: 'contains',
+      sourceId: organizationNode.id,
+      targetId: id
+    })
+    for (const link of node.links) {
+      pushUniqueEdge(edges, edgeIds, {
+        id: edgeId('governs', id, link.nodeId),
+        kind: 'governs',
+        sourceId: id,
+        targetId: link.nodeId
+      })
+    }
+  }
+
+  if (commandViewData) {
+    const commandViewResources = collectCommandViewResources(commandViewData).sort((a, b) =>
+      a.resourceId.localeCompare(b.resourceId)
+    )
+
+    for (const resource of commandViewResources) {
+      const id = nodeId('resource', resource.resourceId)
+      const resourceNode = upsertResourceNode(nodes, nodeIds, resourceNodesById, {
+        id,
+        kind: 'resource',
+        label: resource.name,
+        sourceId: resource.resourceId,
+        description: resource.description,
+        resourceType: normalizeCommandViewResourceType(resource.type)
+      })
+
       pushUniqueEdge(edges, edgeIds, {
         id: edgeId('contains', organizationNode.id, resourceNode.id),
         kind: 'contains',
@@ -184,41 +211,41 @@ export function buildOrganizationGraph(input: BuildOrganizationGraphInput): Orga
       })
       pushResourceLinks(edges, edgeIds, resourceNode.id, resource.links)
     }
-
-    for (const relationship of [...commandViewData.edges].sort((a, b) => a.id.localeCompare(b.id))) {
-      const sourceNode = ensureResourceNode(nodes, nodeIds, resourceNodesById, relationship.source)
-      const targetNode = ensureResourceNode(nodes, nodeIds, resourceNodesById, relationship.target)
-
-      pushUniqueEdge(edges, edgeIds, {
-        id: edgeId('contains', organizationNode.id, sourceNode.id),
-        kind: 'contains',
-        sourceId: organizationNode.id,
-        targetId: sourceNode.id
-      })
-      pushUniqueEdge(edges, edgeIds, {
-        id: edgeId('contains', organizationNode.id, targetNode.id),
-        kind: 'contains',
-        sourceId: organizationNode.id,
-        targetId: targetNode.id
-      })
-
-      pushUniqueEdge(edges, edgeIds, {
-        id: edgeId('references', sourceNode.id, targetNode.id, relationship.relationship),
-        kind: 'references',
-        sourceId: sourceNode.id,
-        targetId: targetNode.id,
-        label: relationship.relationship,
-        relationshipType: relationship.relationship
-      })
-    }
-  }
-
-  const graph: OrganizationGraph = {
-    version: 1,
-    organizationModelVersion: organizationModel.version,
-    nodes,
-    edges
-  }
-
-  return OrganizationGraphSchema.parse(graph)
-}
+
+    for (const relationship of [...commandViewData.edges].sort((a, b) => a.id.localeCompare(b.id))) {
+      const sourceNode = ensureResourceNode(nodes, nodeIds, resourceNodesById, relationship.source)
+      const targetNode = ensureResourceNode(nodes, nodeIds, resourceNodesById, relationship.target)
+
+      pushUniqueEdge(edges, edgeIds, {
+        id: edgeId('contains', organizationNode.id, sourceNode.id),
+        kind: 'contains',
+        sourceId: organizationNode.id,
+        targetId: sourceNode.id
+      })
+      pushUniqueEdge(edges, edgeIds, {
+        id: edgeId('contains', organizationNode.id, targetNode.id),
+        kind: 'contains',
+        sourceId: organizationNode.id,
+        targetId: targetNode.id
+      })
+
+      pushUniqueEdge(edges, edgeIds, {
+        id: edgeId('references', sourceNode.id, targetNode.id, relationship.relationship),
+        kind: 'references',
+        sourceId: sourceNode.id,
+        targetId: targetNode.id,
+        label: relationship.relationship,
+        relationshipType: relationship.relationship
+      })
+    }
+  }
+
+  const graph: OrganizationGraph = {
+    version: 1,
+    organizationModelVersion: organizationModel.version,
+    nodes,
+    edges
+  }
+
+  return OrganizationGraphSchema.parse(graph)
+}

package/src/organization-model/graph/schema.ts

@@ -1,53 +1,56 @@
 import { z } from 'zod'
-import { DescriptionSchema, LabelSchema } from '../domains/shared'
+import { DescriptionSchema, IconNameSchema, LabelSchema } from '../domains/shared'
 import { OrganizationModelSchema } from '../schema'
-
-export const OrganizationGraphNodeKindSchema = z.enum([
-  'organization',
-  'feature',
-  'surface',
-  'entity',
-  'capability',
-  'resource'
-])
-
+
+export const OrganizationGraphNodeKindSchema = z.enum([
+  'organization',
+  'feature',
+  'surface',
+  'entity',
+  'capability',
+  'resource',
+  'knowledge'
+])
+
 export const OrganizationGraphEdgeKindSchema = z.enum([
   'contains',
   'references',
   'exposes',
   'maps_to',
   'operates-on',
-  'uses'
+  'uses',
+  'governs'
 ])
-
+
 export const OrganizationGraphNodeSchema = z.object({
   id: z.string().trim().min(1).max(200),
   kind: OrganizationGraphNodeKindSchema,
   label: LabelSchema,
   sourceId: z.string().trim().min(1).max(255).optional(),
   description: DescriptionSchema.optional(),
+  icon: IconNameSchema.optional(),
   enabled: z.boolean().optional(),
   featureId: z.string().trim().min(1).max(100).optional(),
   resourceType: z.enum(['workflow', 'agent', 'trigger', 'integration', 'external', 'human_checkpoint']).optional()
 })
-
-export const OrganizationGraphEdgeSchema = z.object({
-  id: z.string().trim().min(1).max(250),
-  kind: OrganizationGraphEdgeKindSchema,
-  sourceId: z.string().trim().min(1).max(200),
-  targetId: z.string().trim().min(1).max(200),
-  label: z.string().trim().min(1).max(120).optional(),
-  relationshipType: z.enum(['triggers', 'uses', 'approval']).optional()
-})
-
-export const OrganizationGraphSchema = z.object({
-  version: z.literal(1),
-  organizationModelVersion: OrganizationModelSchema.shape.version,
-  nodes: z.array(OrganizationGraphNodeSchema),
-  edges: z.array(OrganizationGraphEdgeSchema)
-})
-
-export const BuildOrganizationGraphInputSchema = z.object({
-  organizationModel: OrganizationModelSchema,
-  commandViewData: z.unknown().optional()
-})
+
+export const OrganizationGraphEdgeSchema = z.object({
+  id: z.string().trim().min(1).max(250),
+  kind: OrganizationGraphEdgeKindSchema,
+  sourceId: z.string().trim().min(1).max(200),
+  targetId: z.string().trim().min(1).max(200),
+  label: z.string().trim().min(1).max(120).optional(),
+  relationshipType: z.enum(['triggers', 'uses', 'approval']).optional()
+})
+
+export const OrganizationGraphSchema = z.object({
+  version: z.literal(1),
+  organizationModelVersion: OrganizationModelSchema.shape.version,
+  nodes: z.array(OrganizationGraphNodeSchema),
+  edges: z.array(OrganizationGraphEdgeSchema)
+})
+
+export const BuildOrganizationGraphInputSchema = z.object({
+  organizationModel: OrganizationModelSchema,
+  commandViewData: z.unknown().optional()
+})

package/src/organization-model/graph/types.ts

@@ -1,40 +1,56 @@
 import type { CommandViewData } from '../../platform/registry/command-view'
 import type { OrganizationModel } from '../types'
 import type { RelationshipType } from '../../platform/registry/command-view'
-
-export type OrganizationGraphNodeKind = 'organization' | 'feature' | 'surface' | 'entity' | 'capability' | 'resource'
-
-export type OrganizationGraphEdgeKind = 'contains' | 'references' | 'exposes' | 'maps_to' | 'operates-on' | 'uses'
+import type { OrganizationModelIconToken } from '../icons'
+
+export type OrganizationGraphNodeKind =
+  | 'organization'
+  | 'feature'
+  | 'surface'
+  | 'entity'
+  | 'capability'
+  | 'resource'
+  | 'knowledge'
+
+export type OrganizationGraphEdgeKind =
+  | 'contains'
+  | 'references'
+  | 'exposes'
+  | 'maps_to'
+  | 'operates-on'
+  | 'uses'
+  | 'governs'
 export type { Link } from './link'
-
-export interface OrganizationGraphNode {
-  id: string
-  kind: OrganizationGraphNodeKind
-  label: string
-  sourceId?: string
+
+export interface OrganizationGraphNode {
+  id: string
+  kind: OrganizationGraphNodeKind
+  label: string
+  sourceId?: string
   description?: string
+  icon?: OrganizationModelIconToken
   enabled?: boolean
   featureId?: string
   resourceType?: 'workflow' | 'agent' | 'trigger' | 'integration' | 'external' | 'human_checkpoint'
 }
-
-export interface OrganizationGraphEdge {
-  id: string
-  kind: OrganizationGraphEdgeKind
-  sourceId: string
-  targetId: string
-  label?: string
-  relationshipType?: RelationshipType
-}
-
-export interface OrganizationGraph {
-  version: 1
-  organizationModelVersion: OrganizationModel['version']
-  nodes: OrganizationGraphNode[]
-  edges: OrganizationGraphEdge[]
-}
-
-export interface BuildOrganizationGraphInput {
-  organizationModel: OrganizationModel
-  commandViewData?: CommandViewData
-}
+
+export interface OrganizationGraphEdge {
+  id: string
+  kind: OrganizationGraphEdgeKind
+  sourceId: string
+  targetId: string
+  label?: string
+  relationshipType?: RelationshipType
+}
+
+export interface OrganizationGraph {
+  version: 1
+  organizationModelVersion: OrganizationModel['version']
+  nodes: OrganizationGraphNode[]
+  edges: OrganizationGraphEdge[]
+}
+
+export interface BuildOrganizationGraphInput {
+  organizationModel: OrganizationModel
+  commandViewData?: CommandViewData
+}