@elevasis/core 0.15.0 → 0.16.0

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
+}

package/src/organization-model/icons.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod'
+
+export const ORGANIZATION_MODEL_ICON_TOKENS = [
+  'nav.dashboard',
+  'nav.sales',
+  'nav.crm',
+  'nav.lead-gen',
+  'nav.projects',
+  'nav.operations',
+  'nav.monitoring',
+  'nav.knowledge',
+  'nav.settings',
+  'nav.admin',
+  'nav.archive',
+  'knowledge.playbook',
+  'knowledge.strategy',
+  'knowledge.reference',
+  'feature.dashboard',
+  'feature.sales',
+  'feature.crm',
+  'feature.finance',
+  'feature.lead-gen',
+  'feature.platform',
+  'feature.projects',
+  'feature.operations',
+  'feature.knowledge',
+  'feature.monitoring',
+  'feature.settings',
+  'feature.admin',
+  'feature.archive',
+  'feature.seo',
+  'resource.agent',
+  'resource.workflow',
+  'resource.integration',
+  'resource.database',
+  'resource.user',
+  'resource.team',
+  'integration.gmail',
+  'integration.google-sheets',
+  'integration.attio',
+  'surface.dashboard',
+  'surface.overview',
+  'surface.command-view',
+  'surface.command-queue',
+  'surface.pipeline',
+  'surface.lists',
+  'surface.resources',
+  'surface.settings',
+  'status.success',
+  'status.error',
+  'status.warning',
+  'status.info',
+  'status.pending',
+  'action.approve',
+  'action.reject',
+  'action.retry',
+  'action.edit',
+  'action.view',
+  'action.launch',
+  'action.message',
+  'action.escalate',
+  'action.promote',
+  'action.submit',
+  'action.email'
+] as const
+
+const CustomIconTokenSchema = z
+  .string()
+  .trim()
+  .max(80)
+  .regex(/^custom\.[a-z0-9]+(?:[-._][a-z0-9]+)*$/, 'Custom icon tokens must start with custom.')
+
+export const OrganizationModelBuiltinIconTokenSchema = z.enum(ORGANIZATION_MODEL_ICON_TOKENS)
+
+export const OrganizationModelIconTokenSchema = z.union([
+  OrganizationModelBuiltinIconTokenSchema,
+  CustomIconTokenSchema
+])
+
+export type OrganizationModelBuiltinIconToken = (typeof ORGANIZATION_MODEL_ICON_TOKENS)[number]
+export type OrganizationModelIconToken = z.infer<typeof OrganizationModelIconTokenSchema>