@elevasis/core 0.10.0 → 0.11.1

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

@@ -73,7 +73,7 @@ function ensureResourceNode(
   })
 }
 
-type CommandViewResource =
+type CommandViewResource =
   | CommandViewData['workflows'][number]
   | CommandViewData['agents'][number]
   | CommandViewData['triggers'][number]
@@ -87,7 +87,7 @@ function normalizeCommandViewResourceType(
   return resourceType === 'human' ? 'human_checkpoint' : resourceType
 }
 
-function collectCommandViewResources(commandViewData: CommandViewData): CommandViewResource[] {
+function collectCommandViewResources(commandViewData: CommandViewData): CommandViewResource[] {
   return [
     ...commandViewData.workflows,
     ...commandViewData.agents,
@@ -95,8 +95,24 @@ function collectCommandViewResources(commandViewData: CommandViewData): CommandV
     ...commandViewData.integrations,
     ...commandViewData.externalResources,
     ...commandViewData.humanCheckpoints
-  ]
-}
+  ]
+}
+
+function pushResourceLinks(
+  edges: OrganizationGraphEdge[],
+  edgeIds: Set<string>,
+  resourceNodeId: string,
+  links: CommandViewResource['links'] | undefined
+): void {
+  for (const link of links ?? []) {
+    pushUniqueEdge(edges, edgeIds, {
+      id: edgeId(link.kind, resourceNodeId, link.nodeId),
+      kind: link.kind,
+      sourceId: resourceNodeId,
+      targetId: link.nodeId
+    })
+  }
+}
 
 export function buildOrganizationGraph(input: BuildOrganizationGraphInput): OrganizationGraph {
   const parsed = BuildOrganizationGraphInputSchema.parse(input)
@@ -116,34 +132,8 @@ export function buildOrganizationGraph(input: BuildOrganizationGraphInput): Orga
   }
   pushUniqueNode(nodes, nodeIds, organizationNode)
 
-  // Build feature map for lookups
-  const featureMap = new Map<string, (typeof organizationModel.features)[number]>()
-  for (const feature of organizationModel.features) {
-    featureMap.set(feature.id, feature)
-  }
-
-  const surfaceMap = new Map<string, (typeof organizationModel.navigation.surfaces)[number]>()
-  for (const surface of organizationModel.navigation.surfaces) {
-    surfaceMap.set(surface.id, surface)
-  }
-
-  const entityIds = new Set<string>()
-  const capabilityIds = new Set<string>()
-  const resourceMappings = [...organizationModel.resourceMappings].sort((a, b) =>
-    a.resourceId.localeCompare(b.resourceId)
-  )
-  for (const resourceMapping of resourceMappings) {
-    for (const entityId of resourceMapping.entityIds) {
-      entityIds.add(entityId)
-    }
-    for (const capabilityId of resourceMapping.capabilityIds) {
-      capabilityIds.add(capabilityId)
-    }
-  }
-
-  // Unified feature loop: creates feature nodes with semantic data (replaces old feature + domain loops)
-  for (const feature of [...organizationModel.features].sort((a, b) => a.id.localeCompare(b.id))) {
-    const id = nodeId('feature', feature.id)
+  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',
@@ -157,173 +147,18 @@ export function buildOrganizationGraph(input: BuildOrganizationGraphInput): Orga
       id: edgeId('contains', organizationNode.id, id),
       kind: 'contains',
       sourceId: organizationNode.id,
-      targetId: id
-    })
-
-    for (const entityId of feature.entityIds) {
-      entityIds.add(entityId)
-    }
-    for (const capabilityId of feature.capabilityIds) {
-      capabilityIds.add(capabilityId)
-    }
-    for (const surfaceId of feature.surfaceIds) {
-      const surface = surfaceMap.get(surfaceId)
-      if (surface) {
-        pushUniqueEdge(edges, edgeIds, {
-          id: edgeId('references', id, nodeId('surface', surface.id)),
-          kind: 'references',
-          sourceId: id,
-          targetId: nodeId('surface', surface.id)
-        })
-      }
-    }
-  }
-
-  for (const surface of [...organizationModel.navigation.surfaces].sort((a, b) => a.id.localeCompare(b.id))) {
-    const id = nodeId('surface', surface.id)
-    pushUniqueNode(nodes, nodeIds, {
-      id,
-      kind: 'surface',
-      label: surface.label,
-      sourceId: surface.id,
-      description: surface.description,
-      surfaceType: surface.surfaceType
-    })
-    pushUniqueEdge(edges, edgeIds, {
-      id: edgeId('contains', organizationNode.id, id),
-      kind: 'contains',
-      sourceId: organizationNode.id,
-      targetId: id
-    })
-
-    if (surface.featureId) {
-      pushUniqueEdge(edges, edgeIds, {
-        id: edgeId('exposes', nodeId('feature', surface.featureId), id),
-        kind: 'exposes',
-        sourceId: nodeId('feature', surface.featureId),
-        targetId: id
-      })
-    }
-
-    for (const featureId of surface.featureIds) {
-      if (featureMap.has(featureId)) {
-        pushUniqueEdge(edges, edgeIds, {
-          id: edgeId('references', id, nodeId('feature', featureId)),
-          kind: 'references',
-          sourceId: id,
-          targetId: nodeId('feature', featureId)
-        })
-      }
-    }
-
-    for (const entityId of surface.entityIds) {
-      entityIds.add(entityId)
-      pushUniqueEdge(edges, edgeIds, {
-        id: edgeId('references', id, nodeId('entity', entityId)),
-        kind: 'references',
-        sourceId: id,
-        targetId: nodeId('entity', entityId)
-      })
-    }
-
-    for (const capabilityId of surface.capabilityIds) {
-      capabilityIds.add(capabilityId)
-      pushUniqueEdge(edges, edgeIds, {
-        id: edgeId('references', id, nodeId('capability', capabilityId)),
-        kind: 'references',
-        sourceId: id,
-        targetId: nodeId('capability', capabilityId)
-      })
-    }
-  }
-
-  for (const entityId of [...entityIds].sort()) {
-    pushUniqueNode(nodes, nodeIds, {
-      id: nodeId('entity', entityId),
-      kind: 'entity',
-      label: entityId,
-      sourceId: entityId
-    })
-    pushUniqueEdge(edges, edgeIds, {
-      id: edgeId('contains', organizationNode.id, nodeId('entity', entityId)),
-      kind: 'contains',
-      sourceId: organizationNode.id,
-      targetId: nodeId('entity', entityId)
-    })
-  }
-
-  for (const capabilityId of [...capabilityIds].sort()) {
-    pushUniqueNode(nodes, nodeIds, {
-      id: nodeId('capability', capabilityId),
-      kind: 'capability',
-      label: capabilityId,
-      sourceId: capabilityId
-    })
-    pushUniqueEdge(edges, edgeIds, {
-      id: edgeId('contains', organizationNode.id, nodeId('capability', capabilityId)),
-      kind: 'contains',
-      sourceId: organizationNode.id,
-      targetId: nodeId('capability', capabilityId)
-    })
-  }
-
-  for (const resourceMapping of resourceMappings) {
-    const id = nodeId('resource', resourceMapping.resourceId)
-    upsertResourceNode(nodes, nodeIds, resourceNodesById, {
-      id,
-      kind: 'resource',
-      label: resourceMapping.label,
-      sourceId: resourceMapping.resourceId,
-      description: resourceMapping.description,
-      resourceType: resourceMapping.resourceType
-    })
-    pushUniqueEdge(edges, edgeIds, {
-      id: edgeId('contains', organizationNode.id, id),
-      kind: 'contains',
-      sourceId: organizationNode.id,
-      targetId: id
-    })
-
-    for (const featureId of resourceMapping.featureIds) {
-      if (featureMap.has(featureId)) {
-        pushUniqueEdge(edges, edgeIds, {
-          id: edgeId('maps_to', id, nodeId('feature', featureId)),
-          kind: 'maps_to',
-          sourceId: id,
-          targetId: nodeId('feature', featureId)
-        })
-      }
-    }
-
-    for (const entityId of resourceMapping.entityIds) {
-      pushUniqueEdge(edges, edgeIds, {
-        id: edgeId('maps_to', id, nodeId('entity', entityId)),
-        kind: 'maps_to',
-        sourceId: id,
-        targetId: nodeId('entity', entityId)
-      })
-    }
-
-    for (const surfaceId of resourceMapping.surfaceIds) {
-      if (surfaceMap.has(surfaceId)) {
-        pushUniqueEdge(edges, edgeIds, {
-          id: edgeId('maps_to', id, nodeId('surface', surfaceId)),
-          kind: 'maps_to',
-          sourceId: id,
-          targetId: nodeId('surface', surfaceId)
-        })
-      }
-    }
-
-    for (const capabilityId of resourceMapping.capabilityIds) {
-      pushUniqueEdge(edges, edgeIds, {
-        id: edgeId('maps_to', id, nodeId('capability', capabilityId)),
-        kind: 'maps_to',
-        sourceId: id,
-        targetId: nodeId('capability', capabilityId)
-      })
-    }
-  }
+      targetId: id
+    })
+    const parentId = feature.id.includes('.') ? feature.id.slice(0, feature.id.lastIndexOf('.')) : undefined
+    if (parentId) {
+      pushUniqueEdge(edges, edgeIds, {
+        id: edgeId('contains', nodeId('feature', parentId), id),
+        kind: 'contains',
+        sourceId: nodeId('feature', parentId),
+        targetId: id
+      })
+    }
+  }
 
   if (commandViewData) {
     const commandViewResources = collectCommandViewResources(commandViewData).sort((a, b) =>
@@ -341,24 +176,14 @@ export function buildOrganizationGraph(input: BuildOrganizationGraphInput): Orga
         resourceType: normalizeCommandViewResourceType(resource.type)
       })
 
-      for (const featureId of resource.domains ?? []) {
-        if (featureMap.has(featureId)) {
-          pushUniqueEdge(edges, edgeIds, {
-            id: edgeId('references', resourceNode.id, nodeId('feature', featureId), 'feature'),
-            kind: 'references',
-            sourceId: resourceNode.id,
-            targetId: nodeId('feature', featureId)
-          })
-        }
-      }
-
-      pushUniqueEdge(edges, edgeIds, {
-        id: edgeId('contains', organizationNode.id, resourceNode.id),
-        kind: 'contains',
-        sourceId: organizationNode.id,
-        targetId: resourceNode.id
-      })
-    }
+      pushUniqueEdge(edges, edgeIds, {
+        id: edgeId('contains', organizationNode.id, resourceNode.id),
+        kind: 'contains',
+        sourceId: organizationNode.id,
+        targetId: resourceNode.id
+      })
+      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)

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

@@ -1,4 +1,4 @@
-export * from './types'
-export * from './schema'
-export * from './build'
-
+export * from './types'
+export * from './schema'
+export * from './build'
+export * from './link'

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

@@ -0,0 +1,10 @@
+import { z } from 'zod'
+import { NodeIdStringSchema } from '../domains/features'
+import { OrganizationGraphEdgeKindSchema } from './schema'
+
+export const LinkSchema = z.object({
+  nodeId: NodeIdStringSchema,
+  kind: OrganizationGraphEdgeKindSchema
+})
+
+export type Link = z.infer<typeof LinkSchema>

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

@@ -1,7 +1,6 @@
-import { z } from 'zod'
-import { DescriptionSchema, LabelSchema, ModelIdSchema } from '../domains/shared'
-import { SurfaceTypeSchema } from '../domains/navigation'
-import { OrganizationModelSchema } from '../schema'
+import { z } from 'zod'
+import { DescriptionSchema, LabelSchema } from '../domains/shared'
+import { OrganizationModelSchema } from '../schema'
 
 export const OrganizationGraphNodeKindSchema = z.enum([
   'organization',
@@ -12,19 +11,25 @@ export const OrganizationGraphNodeKindSchema = z.enum([
   'resource'
 ])
 
-export const OrganizationGraphEdgeKindSchema = z.enum(['contains', 'references', 'exposes', 'maps_to'])
+export const OrganizationGraphEdgeKindSchema = z.enum([
+  'contains',
+  'references',
+  'exposes',
+  'maps_to',
+  'operates-on',
+  'uses'
+])
 
-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(),
-  enabled: z.boolean().optional(),
-  featureId: ModelIdSchema.optional(),
-  surfaceType: SurfaceTypeSchema.optional(),
-  resourceType: z.enum(['workflow', 'agent', 'trigger', 'integration', 'external', 'human_checkpoint']).optional()
-})
+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(),
+  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),

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

@@ -1,22 +1,22 @@
-import type { CommandViewData } from '../../platform/registry/command-view'
-import type { OrganizationModel, OrganizationModelResourceMapping, OrganizationModelSurface } from '../types'
-import type { RelationshipType } from '../../platform/registry/command-view'
+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'
+export type OrganizationGraphEdgeKind = 'contains' | 'references' | 'exposes' | 'maps_to' | 'operates-on' | 'uses'
+export type { Link } from './link'
 
 export interface OrganizationGraphNode {
   id: string
   kind: OrganizationGraphNodeKind
   label: string
   sourceId?: string
-  description?: string
-  enabled?: boolean
-  featureId?: string
-  surfaceType?: OrganizationModelSurface['surfaceType']
-  resourceType?: OrganizationModelResourceMapping['resourceType']
-}
+  description?: string
+  enabled?: boolean
+  featureId?: string
+  resourceType?: 'workflow' | 'agent' | 'trigger' | 'integration' | 'external' | 'human_checkpoint'
+}
 
 export interface OrganizationGraphEdge {
   id: string

package/src/organization-model/helpers.ts

@@ -0,0 +1,74 @@
+import type { OrganizationModelFeature } from './types'
+
+export function defaultPathFor(id: string): string {
+  return `/${id.replaceAll('.', '/')}`
+}
+
+export function parentIdOf(id: string): string | undefined {
+  const index = id.lastIndexOf('.')
+  return index === -1 ? undefined : id.slice(0, index)
+}
+
+export function findById(features: readonly OrganizationModelFeature[], id: string): OrganizationModelFeature | undefined {
+  return features.find((feature) => feature.id === id)
+}
+
+export function findByPath(
+  features: readonly OrganizationModelFeature[],
+  path: string
+): OrganizationModelFeature | undefined {
+  return features.find((feature) => (feature.path ?? defaultPathFor(feature.id)) === path)
+}
+
+export function childrenOf(
+  features: readonly OrganizationModelFeature[],
+  id: string
+): OrganizationModelFeature[] {
+  const prefix = `${id}.`
+  return features.filter((feature) => feature.id.startsWith(prefix) && !feature.id.slice(prefix.length).includes('.'))
+}
+
+export function topLevel(features: readonly OrganizationModelFeature[]): OrganizationModelFeature[] {
+  return features.filter((feature) => !feature.id.includes('.'))
+}
+
+export function ancestorsOf(
+  features: readonly OrganizationModelFeature[],
+  id: string
+): OrganizationModelFeature[] {
+  const segments = id.split('.')
+  const ids = segments.map((_, index) => segments.slice(0, index + 1).join('.'))
+  return ids.map((ancestorId) => findById(features, ancestorId)).filter((feature): feature is OrganizationModelFeature => Boolean(feature))
+}
+
+export function parentOf(
+  features: readonly OrganizationModelFeature[],
+  id: string
+): OrganizationModelFeature | undefined {
+  const parentId = parentIdOf(id)
+  return parentId ? findById(features, parentId) : undefined
+}
+
+function inheritedValue<T>(
+  features: readonly OrganizationModelFeature[],
+  id: string,
+  getValue: (feature: OrganizationModelFeature) => T | undefined
+): T | undefined {
+  return ancestorsOf(features, id)
+    .slice()
+    .reverse()
+    .map(getValue)
+    .find((value): value is T => value !== undefined)
+}
+
+export function uiPositionFor(features: readonly OrganizationModelFeature[], id: string) {
+  return inheritedValue(features, id, (feature) => feature.uiPosition)
+}
+
+export function requiresAdminFor(features: readonly OrganizationModelFeature[], id: string): boolean {
+  return inheritedValue(features, id, (feature) => feature.requiresAdmin) ?? false
+}
+
+export function devOnlyFor(features: readonly OrganizationModelFeature[], id: string): boolean {
+  return inheritedValue(features, id, (feature) => feature.devOnly) ?? false
+}

package/src/organization-model/index.ts

@@ -1,13 +1,13 @@
 export * from './schema'
 export * from './types'
 export * from './contracts'
-export * from './defaults'
-export * from './resolve'
-export * from './foundation'
-export * from './graph'
+export * from './defaults'
+export * from './resolve'
+export * from './foundation'
+export * from './helpers'
+export * from './graph'
 export * from './domains/branding'
 export * from './domains/sales'
 export * from './domains/projects'
-export * from './domains/features'
-export * from './domains/prospecting'
-export * from './domains/navigation'
+export * from './domains/features'
+export * from './domains/prospecting'