@elevasis/core 0.10.0 → 0.11.1

package/src/organization-model/defaults.ts

@@ -1,148 +1,284 @@
-import type { OrganizationModel } from './types'
-import {
-  SALES_FEATURE_ID,
-  SALES_PIPELINE_SURFACE_ID,
-  PROJECTS_VIEW_CAPABILITY_ID,
-  PROSPECTING_FEATURE_ID,
-  PROSPECTING_LISTS_SURFACE_ID,
-  MONITORING_FEATURE_ID,
-  OPERATIONS_FEATURE_ID,
-  OPERATIONS_ORGANIZATION_GRAPH_SURFACE_ID,
-  PROJECTS_FEATURE_ID,
-  PROJECTS_INDEX_SURFACE_ID,
-  SETTINGS_FEATURE_ID,
-  SEO_FEATURE_ID
-} from './contracts'
-import { DEFAULT_ORGANIZATION_MODEL_BRANDING } from './domains/branding'
-import { DEFAULT_ORGANIZATION_MODEL_IDENTITY } from './domains/identity'
-import { DEFAULT_ORGANIZATION_MODEL_CUSTOMERS } from './domains/customers'
+import type { OrganizationModel } from './types'
+import { DEFAULT_ORGANIZATION_MODEL_BRANDING } from './domains/branding'
+import { DEFAULT_ORGANIZATION_MODEL_IDENTITY } from './domains/identity'
+import { DEFAULT_ORGANIZATION_MODEL_CUSTOMERS } from './domains/customers'
 import { DEFAULT_ORGANIZATION_MODEL_OFFERINGS } from './domains/offerings'
-import { DEFAULT_ORGANIZATION_MODEL_SALES } from './domains/sales'
-import { DEFAULT_ORGANIZATION_MODEL_PROJECTS } from './domains/projects'
-import { DEFAULT_ORGANIZATION_MODEL_PROSPECTING } from './domains/prospecting'
-import { DEFAULT_ORGANIZATION_MODEL_NAVIGATION } from './domains/navigation'
-import { DEFAULT_ORGANIZATION_MODEL_OPERATIONS } from './domains/operations'
-import { DEFAULT_ORGANIZATION_MODEL_ROLES } from './domains/roles'
-import { DEFAULT_ORGANIZATION_MODEL_GOALS } from './domains/goals'
+import { DEFAULT_ORGANIZATION_MODEL_SALES } from './domains/sales'
+import { DEFAULT_ORGANIZATION_MODEL_PROJECTS } from './domains/projects'
+import { DEFAULT_ORGANIZATION_MODEL_PROSPECTING } from './domains/prospecting'
+import { DEFAULT_ORGANIZATION_MODEL_OPERATIONS } from './domains/operations'
+import { DEFAULT_ORGANIZATION_MODEL_ROLES } from './domains/roles'
+import { DEFAULT_ORGANIZATION_MODEL_GOALS } from './domains/goals'
 import { DEFAULT_ORGANIZATION_MODEL_STATUSES } from './domains/statuses'
 
 export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
-  version: 1,
-  features: [
-    {
-      id: SALES_FEATURE_ID,
-      label: 'CRM',
-      description: 'Relationship pipeline and deal management',
-      enabled: true,
-      color: 'blue',
-      entityIds: ['crm.deal'],
-      surfaceIds: [SALES_PIPELINE_SURFACE_ID],
-      resourceIds: [],
-      capabilityIds: ['crm.pipeline.manage']
-    },
-    {
-      id: PROSPECTING_FEATURE_ID,
-      label: 'Lead Gen',
-      description: 'Prospecting, qualification, and outreach preparation',
-      enabled: true,
-      color: 'cyan',
-      entityIds: ['leadgen.list', 'leadgen.company', 'leadgen.contact'],
-      surfaceIds: [PROSPECTING_LISTS_SURFACE_ID],
-      resourceIds: [],
-      capabilityIds: ['leadgen.lists.manage']
-    },
-    {
-      id: PROJECTS_FEATURE_ID,
-      label: 'Projects',
-      description: 'Projects, milestones, and client work execution',
-      enabled: true,
-      color: 'orange',
-      entityIds: ['delivery.project', 'delivery.milestone', 'delivery.task'],
-      surfaceIds: [PROJECTS_INDEX_SURFACE_ID],
-      resourceIds: [],
-      capabilityIds: [PROJECTS_VIEW_CAPABILITY_ID]
-    },
-    {
-      id: OPERATIONS_FEATURE_ID,
-      label: 'Operations',
-      description: 'Operational resources, topology, and orchestration visibility',
-      enabled: true,
-      color: 'violet',
-      entityIds: [],
-      surfaceIds: [
-        OPERATIONS_ORGANIZATION_GRAPH_SURFACE_ID,
-        'operations.command-view',
-        'operations.overview',
-        'operations.resources',
-        'operations.command-queue',
-        'operations.sessions',
-        'operations.task-scheduler'
-      ],
-      resourceIds: [],
-      capabilityIds: ['operations.organization-graph', 'operations.command-view']
-    },
-    {
-      id: MONITORING_FEATURE_ID,
-      label: 'Monitoring',
-      enabled: true,
-      entityIds: [],
-      surfaceIds: [
-        'monitoring.activity-log',
-        'monitoring.execution-logs',
-        'monitoring.execution-health',
-        'monitoring.cost-analytics',
-        'monitoring.notifications'
-      ],
-      resourceIds: [],
-      capabilityIds: []
-    },
-    {
-      id: SETTINGS_FEATURE_ID,
-      label: 'Settings',
-      enabled: true,
-      entityIds: [],
-      surfaceIds: [
-        'settings.account',
-        'settings.appearance',
-        'settings.organization',
-        'settings.credentials',
-        'settings.api-keys',
-        'settings.webhooks',
-        'settings.deployments'
-      ],
-      resourceIds: [],
-      capabilityIds: []
-    },
-    {
-      id: 'submitted-requests',
-      label: 'Submitted Requests',
-      enabled: true,
-      entityIds: ['reported_request'],
-      surfaceIds: ['submitted-requests.list', 'submitted-requests.detail'],
-      resourceIds: [],
-      capabilityIds: []
-    },
-    {
-      id: SEO_FEATURE_ID,
-      label: 'SEO',
-      enabled: false,
-      entityIds: [],
-      surfaceIds: [],
-      resourceIds: [],
-      capabilityIds: []
-    }
-  ],
-  branding: DEFAULT_ORGANIZATION_MODEL_BRANDING,
-  navigation: DEFAULT_ORGANIZATION_MODEL_NAVIGATION,
-  sales: DEFAULT_ORGANIZATION_MODEL_SALES,
-  prospecting: DEFAULT_ORGANIZATION_MODEL_PROSPECTING,
-  projects: DEFAULT_ORGANIZATION_MODEL_PROJECTS,
+  version: 1,
+  features: [
+    {
+      id: 'dashboard',
+      label: 'Dashboard',
+      enabled: true,
+      path: '/',
+      icon: 'dashboard',
+      uiPosition: 'sidebar-primary'
+    },
+    {
+      id: 'sales',
+      label: 'Sales',
+      description: 'Revenue workflows and customer acquisition',
+      enabled: true,
+      color: 'blue',
+      icon: 'crm',
+      uiPosition: 'sidebar-primary'
+    },
+    {
+      id: 'sales.crm',
+      label: 'CRM',
+      description: 'Relationship pipeline and deal management',
+      enabled: true,
+      color: 'blue',
+      icon: 'crm',
+      path: '/crm'
+    },
+    {
+      id: 'sales.lead-gen',
+      label: 'Lead Gen',
+      description: 'Prospecting, qualification, and outreach preparation',
+      enabled: true,
+      color: 'cyan',
+      icon: 'lead-gen',
+      path: '/lead-gen'
+    },
+    {
+      id: 'projects',
+      label: 'Projects',
+      description: 'Projects, milestones, and client work execution',
+      enabled: true,
+      color: 'orange',
+      icon: 'projects',
+      path: '/projects',
+      uiPosition: 'sidebar-primary'
+    },
+    {
+      id: 'operations',
+      label: 'Operations',
+      description: 'Operational resources, topology, and orchestration visibility',
+      enabled: true,
+      color: 'violet',
+      icon: 'operations',
+      uiPosition: 'sidebar-primary'
+    },
+    {
+      id: 'operations.graph',
+      label: 'Organization Graph',
+      enabled: true,
+      path: '/operations/organization-graph'
+    },
+    {
+      id: 'operations.command-view',
+      label: 'Command View',
+      enabled: true,
+      path: '/operations/command-view',
+      devOnly: true
+    },
+    {
+      id: 'operations.overview',
+      label: 'Overview',
+      enabled: true,
+      path: '/operations'
+    },
+    {
+      id: 'operations.resources',
+      label: 'Resources',
+      enabled: true,
+      path: '/operations/resources'
+    },
+    {
+      id: 'operations.command-queue',
+      label: 'Command Queue',
+      enabled: true,
+      path: '/operations/command-queue'
+    },
+    {
+      id: 'operations.sessions',
+      label: 'Sessions',
+      enabled: false,
+      path: '/operations/sessions'
+    },
+    {
+      id: 'operations.task-scheduler',
+      label: 'Task Scheduler',
+      enabled: true,
+      path: '/operations/task-scheduler'
+    },
+    {
+      id: 'monitoring',
+      label: 'Monitoring',
+      enabled: true,
+      uiPosition: 'sidebar-primary'
+    },
+    {
+      id: 'monitoring.activity-log',
+      label: 'Activity Log',
+      enabled: true,
+      path: '/monitoring/activity-log'
+    },
+    {
+      id: 'monitoring.execution-logs',
+      label: 'Execution Logs',
+      enabled: true,
+      path: '/monitoring/execution-logs'
+    },
+    {
+      id: 'monitoring.execution-health',
+      label: 'Execution Health',
+      enabled: true,
+      path: '/monitoring/execution-health'
+    },
+    {
+      id: 'monitoring.cost-analytics',
+      label: 'Cost Analytics',
+      enabled: false,
+      path: '/monitoring/cost-analytics'
+    },
+    {
+      id: 'monitoring.notifications',
+      label: 'Notifications',
+      enabled: true,
+      path: '/monitoring/notifications'
+    },
+    {
+      id: 'monitoring.submitted-requests',
+      label: 'Submitted Requests',
+      enabled: true,
+      path: '/monitoring/requests'
+    },
+    {
+      id: 'settings',
+      label: 'Settings',
+      enabled: true,
+      icon: 'settings',
+      uiPosition: 'sidebar-bottom'
+    },
+    {
+      id: 'settings.account',
+      label: 'Account',
+      enabled: true,
+      path: '/settings/account'
+    },
+    {
+      id: 'settings.appearance',
+      label: 'Appearance',
+      enabled: true,
+      path: '/settings/appearance'
+    },
+    {
+      id: 'settings.organization',
+      label: 'Organization',
+      enabled: true,
+      path: '/settings/organization'
+    },
+    {
+      id: 'settings.credentials',
+      label: 'Credentials',
+      enabled: true,
+      path: '/settings/credentials'
+    },
+    {
+      id: 'settings.api-keys',
+      label: 'API Keys',
+      enabled: true,
+      path: '/settings/api-keys'
+    },
+    {
+      id: 'settings.webhooks',
+      label: 'Webhooks',
+      enabled: true,
+      path: '/settings/webhooks'
+    },
+    {
+      id: 'settings.deployments',
+      label: 'Deployments',
+      enabled: true,
+      path: '/settings/deployments'
+    },
+    {
+      id: 'admin',
+      label: 'Admin',
+      enabled: true,
+      path: '/admin',
+      icon: 'settings',
+      uiPosition: 'sidebar-bottom',
+      requiresAdmin: true
+    },
+    {
+      id: 'admin.system-health',
+      label: 'System Health',
+      enabled: true,
+      path: '/admin/system-health'
+    },
+    {
+      id: 'admin.organizations',
+      label: 'Organizations',
+      enabled: true,
+      path: '/admin/organizations'
+    },
+    {
+      id: 'admin.users',
+      label: 'Users',
+      enabled: true,
+      path: '/admin/users'
+    },
+    {
+      id: 'admin.design-showcase',
+      label: 'Design Showcase',
+      enabled: true,
+      path: '/admin/design-showcase'
+    },
+    {
+      id: 'admin.debug',
+      label: 'Debug',
+      enabled: true,
+      path: '/admin/debug'
+    },
+    {
+      id: 'archive',
+      label: 'Archive',
+      enabled: true,
+      path: '/archive',
+      icon: 'archive',
+      uiPosition: 'sidebar-bottom',
+      devOnly: true
+    },
+    {
+      id: 'archive.agent-chat',
+      label: 'Agent Chat',
+      enabled: true,
+      path: '/archive/agent-chat'
+    },
+    {
+      id: 'archive.execution-runner',
+      label: 'Execution Runner',
+      enabled: true,
+      path: '/archive/execution-runner'
+    },
+    {
+      id: 'seo',
+      label: 'SEO',
+      enabled: false,
+      path: '/seo'
+    }
+  ],
+  branding: DEFAULT_ORGANIZATION_MODEL_BRANDING,
+  navigation: { surfaces: [], groups: [] },
+  sales: DEFAULT_ORGANIZATION_MODEL_SALES,
+  prospecting: DEFAULT_ORGANIZATION_MODEL_PROSPECTING,
+  projects: DEFAULT_ORGANIZATION_MODEL_PROJECTS,
   identity: DEFAULT_ORGANIZATION_MODEL_IDENTITY,
   customers: DEFAULT_ORGANIZATION_MODEL_CUSTOMERS,
   offerings: DEFAULT_ORGANIZATION_MODEL_OFFERINGS,
-  roles: DEFAULT_ORGANIZATION_MODEL_ROLES,
-  goals: DEFAULT_ORGANIZATION_MODEL_GOALS,
-  statuses: DEFAULT_ORGANIZATION_MODEL_STATUSES,
-  operations: DEFAULT_ORGANIZATION_MODEL_OPERATIONS,
-  resourceMappings: []
-}
+  roles: DEFAULT_ORGANIZATION_MODEL_ROLES,
+  goals: DEFAULT_ORGANIZATION_MODEL_GOALS,
+  statuses: DEFAULT_ORGANIZATION_MODEL_STATUSES,
+  operations: DEFAULT_ORGANIZATION_MODEL_OPERATIONS
+}

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

@@ -1,22 +1,31 @@
-import { z } from 'zod'
-import {
-  ColorTokenSchema,
-  DescriptionSchema,
-  IconNameSchema,
-  LabelSchema,
-  ModelIdSchema,
-  ReferenceIdsSchema
-} from './shared'
-
-export const FeatureSchema = z.object({
-  id: ModelIdSchema,
-  label: LabelSchema,
-  description: DescriptionSchema.optional(),
-  enabled: z.boolean().default(true),
-  color: ColorTokenSchema.optional(),
-  icon: IconNameSchema.optional(),
-  entityIds: ReferenceIdsSchema,
-  surfaceIds: ReferenceIdsSchema,
-  resourceIds: ReferenceIdsSchema,
-  capabilityIds: ReferenceIdsSchema
-})
+import { z } from 'zod'
+import { ColorTokenSchema, DescriptionSchema, IconNameSchema, LabelSchema, PathSchema } from './shared'
+
+export const NodeIdPathSchema = z
+  .string()
+  .trim()
+  .min(1)
+  .max(100)
+  .regex(/^([a-z0-9-]+)(\.[a-z0-9-]+)*$/, 'Node IDs must be lowercase dotted paths')
+
+export const NodeIdStringSchema = z
+  .string()
+  .trim()
+  .min(1)
+  .max(200)
+  .regex(/^[a-z]+:([a-z0-9-]+)(\.[a-z0-9-]+)*$/, 'Node references must use kind:dotted-path')
+
+export const UiPositionSchema = z.enum(['sidebar-primary', 'sidebar-bottom'])
+
+export const FeatureSchema = z.object({
+  id: NodeIdPathSchema,
+  label: LabelSchema,
+  description: DescriptionSchema.optional(),
+  enabled: z.boolean().default(true),
+  path: PathSchema.optional(),
+  icon: IconNameSchema.optional(),
+  color: ColorTokenSchema.optional(),
+  uiPosition: UiPositionSchema.optional(),
+  requiresAdmin: z.boolean().optional(),
+  devOnly: z.boolean().optional()
+})

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

@@ -1,5 +1,10 @@
 import { z } from 'zod'
-import { PROJECTS_VIEW_CAPABILITY_ID, PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID } from '../contracts'
+import {
+  OPERATIONS_COMMAND_VIEW_SURFACE_ID,
+  PROJECTS_VIEW_CAPABILITY_ID,
+  PROJECTS_FEATURE_ID,
+  PROJECTS_INDEX_SURFACE_ID
+} from '../contracts'
 import { DescriptionSchema, IconNameSchema, LabelSchema, ModelIdSchema, PathSchema, ReferenceIdsSchema } from './shared'
 
 export const SurfaceTypeSchema = z.enum(['page', 'dashboard', 'graph', 'detail', 'list', 'settings'])
@@ -9,9 +14,10 @@ export const SurfaceDefinitionSchema = z.object({
   label: LabelSchema,
   path: PathSchema,
   surfaceType: SurfaceTypeSchema,
-  description: DescriptionSchema.optional(),
-  enabled: z.boolean().default(true),
-  icon: IconNameSchema.optional(),
+  description: DescriptionSchema.optional(),
+  enabled: z.boolean().default(true),
+  devOnly: z.boolean().optional(),
+  icon: IconNameSchema.optional(),
   featureId: ModelIdSchema.optional(),
   featureIds: ReferenceIdsSchema,
   entityIds: ReferenceIdsSchema,
@@ -96,16 +102,17 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       entityIds: [],
       resourceIds: [],
       capabilityIds: ['operations.organization-graph']
-    },
-    {
-      id: 'operations.command-view',
-      label: 'Command View',
-      path: '/operations/command-view',
-      surfaceType: 'graph',
-      enabled: false,
-      featureId: 'operations',
-      featureIds: ['operations'],
-      entityIds: [],
+    },
+    {
+      id: OPERATIONS_COMMAND_VIEW_SURFACE_ID,
+      label: 'Command View',
+      path: '/operations/command-view',
+      surfaceType: 'graph',
+      enabled: true,
+      devOnly: true,
+      featureId: 'operations',
+      featureIds: ['operations'],
+      entityIds: [],
       resourceIds: [],
       capabilityIds: ['operations.command-view']
     },
@@ -347,12 +354,12 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
     },
     {
       id: 'primary-operations',
-      label: 'Operations',
-      placement: 'primary',
-      surfaceIds: [
-        'operations.organization-graph',
-        'operations.command-view',
-        'operations.overview',
+      label: 'Operations',
+      placement: 'primary',
+      surfaceIds: [
+        'operations.organization-graph',
+        OPERATIONS_COMMAND_VIEW_SURFACE_ID,
+        'operations.overview',
         'operations.resources',
         'operations.command-queue',
         'operations.sessions',

package/src/organization-model/foundation.ts

@@ -1,19 +1,19 @@
-import { PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID } from './contracts'
-import { resolveOrganizationModel } from './resolve'
-import type { DeepPartial, OrganizationModel, OrganizationModelSurface } from './types'
-
-export type FoundationSurfaceType = OrganizationModelSurface['surfaceType']
-
-export type FoundationSurfaceIcon = 'dashboard' | 'crm' | 'lead-gen' | 'projects' | 'operations' | 'settings'
-
-export interface FoundationNavigationSurface extends Omit<OrganizationModelSurface, 'icon'> {
-  icon?: FoundationSurfaceIcon
-}
-
-export interface FoundationOrganizationModel extends Omit<OrganizationModel, 'navigation'> {
-  navigation: {
-    defaultSurfaceId: string
-    homeLabel: string
+import { resolveOrganizationModel } from './resolve'
+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 interface FoundationNavigationSurface extends Omit<OrganizationModelFeature, 'icon' | 'uiPosition'> {
+  icon?: FoundationSurfaceIcon
+  surfaceType?: FoundationSurfaceType
+}
+
+export interface FoundationOrganizationModel extends Omit<OrganizationModel, 'navigation'> {
+  navigation: {
+    defaultSurfaceId: string
+    homeLabel: string
     quickAccessSurfaceIds: readonly string[]
     surfaces: FoundationNavigationSurface[]
   }
@@ -32,46 +32,34 @@ export function createFoundationOrganizationModel(override: DeepPartial<Organiza
   quickAccessSurfaceIds: readonly string[]
   getOrganizationSurface: (surfaceId: string) => FoundationNavigationSurface | undefined
 } {
-  const canonical = resolveOrganizationModel(override)
-
-  function requireCoreSurface(surfaceId: string): OrganizationModelSurface {
-    const surface = canonical.navigation.surfaces.find((candidate) => candidate.id === surfaceId)
-
-    if (!surface) {
-      throw new Error(`Missing organization surface: ${surfaceId}`)
-    }
-
-    return surface
-  }
-
-  const operationsGraphSurface = requireCoreSurface('operations.organization-graph')
-  const projectsSurface = requireCoreSurface(PROJECTS_INDEX_SURFACE_ID)
-  const leadGenSurface = requireCoreSurface('lead-gen.lists')
-  const crmSurface = requireCoreSurface('crm.pipeline')
-
-  const navigationSurfaces: FoundationNavigationSurface[] = [
-    { ...operationsGraphSurface, id: 'operations', path: '/operations', icon: 'operations' },
-    { ...operationsGraphSurface, path: '/operations', icon: 'operations' },
-    { ...projectsSurface, id: PROJECTS_FEATURE_ID, icon: 'projects' },
-    { ...leadGenSurface, id: 'lead-gen', icon: 'lead-gen' },
-    { ...crmSurface, id: 'crm', icon: 'crm' },
-    {
-      id: 'settings',
-      label: 'Settings',
-      path: '/settings/account',
-      surfaceType: 'settings',
-      enabled: true,
-      icon: 'settings',
-      featureId: 'settings',
-      featureIds: ['settings'],
-      entityIds: [],
-      resourceIds: [],
-      capabilityIds: []
-    }
-  ]
+  const canonical = resolveOrganizationModel(override)
+
+  function requireCoreFeature(featureId: string): OrganizationModelFeature {
+    const feature = canonical.features.find((candidate) => candidate.id === featureId)
+
+    if (!feature) {
+      throw new Error(`Missing organization surface/feature: ${featureId}`)
+    }
+
+    return feature
+  }
+
+  const operationsGraphFeature = requireCoreFeature('operations.graph')
+  const projectsFeature = requireCoreFeature('projects')
+  const leadGenFeature = requireCoreFeature('sales.lead-gen')
+  const crmFeature = requireCoreFeature('sales.crm')
+
+  const navigationSurfaces: FoundationNavigationSurface[] = [
+    { ...operationsGraphFeature, id: 'operations', path: '/operations', icon: 'operations', surfaceType: 'graph' },
+    { ...operationsGraphFeature, path: '/operations', icon: 'operations', surfaceType: 'graph' },
+    { ...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' }
+  ]
 
   const homeLabel = 'Dashboard'
-  const quickAccessSurfaceIds = ['operations', PROJECTS_FEATURE_ID, 'lead-gen', 'crm'] as const
+  const quickAccessSurfaceIds = ['operations', 'projects', 'lead-gen', 'crm'] as const
 
   const model: FoundationOrganizationModel = {
     ...canonical,