@elevasis/core 0.2.1 → 0.4.0

package/src/organization-model/defaults.ts

@@ -1,18 +1,19 @@
 import type { OrganizationModel } from './types'
+import { DELIVERY_PROJECTS_VIEW_CAPABILITY_ID, PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID } from './contracts'
 import { DEFAULT_ORGANIZATION_MODEL_BRANDING } from './domains/branding'
 import { DEFAULT_ORGANIZATION_MODEL_CRM } from './domains/crm'
 import { DEFAULT_ORGANIZATION_MODEL_DELIVERY } from './domains/delivery'
-import { DEFAULT_ORGANIZATION_MODEL_FEATURES } from './domains/features'
 import { DEFAULT_ORGANIZATION_MODEL_LEAD_GEN } from './domains/lead-gen'
 import { DEFAULT_ORGANIZATION_MODEL_NAVIGATION } from './domains/navigation'
 
 export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
   version: 1,
-  domains: [
+  features: [
     {
       id: 'crm',
       label: 'CRM',
       description: 'Relationship pipeline and deal management',
+      enabled: true,
       color: 'blue',
       entityIds: ['crm.deal'],
       surfaceIds: ['crm.pipeline'],
@@ -23,6 +24,7 @@ export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
       id: 'lead-gen',
       label: 'Lead Gen',
       description: 'Prospecting, qualification, and outreach preparation',
+      enabled: true,
       color: 'cyan',
       entityIds: ['leadgen.list', 'leadgen.company', 'leadgen.contact'],
       surfaceIds: ['lead-gen.lists'],
@@ -30,28 +32,78 @@ export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
       capabilityIds: ['leadgen.lists.manage']
     },
     {
-      id: 'delivery',
+      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'],
+      surfaceIds: [PROJECTS_INDEX_SURFACE_ID],
       resourceIds: [],
-      capabilityIds: ['delivery.projects.view']
+      capabilityIds: [DELIVERY_PROJECTS_VIEW_CAPABILITY_ID]
     },
     {
       id: 'operations',
       label: 'Operations',
       description: 'Operational resources, topology, and orchestration visibility',
+      enabled: true,
       color: 'violet',
       entityIds: [],
-      surfaceIds: ['operations.organization-graph', 'operations.command-view'],
+      surfaceIds: [
+        'operations.organization-graph',
+        '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',
+      label: 'Monitoring',
+      enabled: true,
+      entityIds: [],
+      surfaceIds: [
+        'monitoring.activity-log',
+        'monitoring.execution-logs',
+        'monitoring.execution-health',
+        'monitoring.cost-analytics',
+        'monitoring.notifications'
+      ],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings',
+      label: 'Settings',
+      enabled: true,
+      entityIds: [],
+      surfaceIds: [
+        'settings.account',
+        'settings.appearance',
+        'settings.organization',
+        'settings.credentials',
+        'settings.api-keys',
+        'settings.webhooks',
+        'settings.deployments'
+      ],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'seo',
+      label: 'SEO',
+      enabled: false,
+      entityIds: [],
+      surfaceIds: [],
+      resourceIds: [],
+      capabilityIds: []
     }
   ],
   branding: DEFAULT_ORGANIZATION_MODEL_BRANDING,
-  features: DEFAULT_ORGANIZATION_MODEL_FEATURES,
   navigation: DEFAULT_ORGANIZATION_MODEL_NAVIGATION,
   crm: DEFAULT_ORGANIZATION_MODEL_CRM,
   leadGen: DEFAULT_ORGANIZATION_MODEL_LEAD_GEN,

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

@@ -1,57 +1,22 @@
 import { z } from 'zod'
+import {
+  ColorTokenSchema,
+  DescriptionSchema,
+  IconNameSchema,
+  LabelSchema,
+  ModelIdSchema,
+  ReferenceIdsSchema
+} from './shared'
 
-export const FeatureKeySchema = z.enum([
-  'acquisition',
-  'delivery',
-  'operations',
-  'monitoring',
-  'settings',
-  'seo',
-  'calibration'
-])
-
-export const OrganizationModelFeaturesSchema = z.object({
-  enabled: z
-    .object({
-      acquisition: z.boolean().default(true),
-      delivery: z.boolean().default(true),
-      operations: z.boolean().default(true),
-      monitoring: z.boolean().default(true),
-      settings: z.boolean().default(true),
-      seo: z.boolean().default(false),
-      calibration: z.boolean().default(false)
-    })
-    .default({
-      acquisition: true,
-      delivery: true,
-      operations: true,
-      monitoring: true,
-      settings: true,
-      seo: false,
-      calibration: false
-    }),
-  labels: z
-    .object({
-      acquisition: z.string().trim().min(1).max(80).optional(),
-      delivery: z.string().trim().min(1).max(80).optional(),
-      operations: z.string().trim().min(1).max(80).optional(),
-      monitoring: z.string().trim().min(1).max(80).optional(),
-      settings: z.string().trim().min(1).max(80).optional(),
-      seo: z.string().trim().min(1).max(80).optional(),
-      calibration: z.string().trim().min(1).max(80).optional()
-    })
-    .default({})
+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
 })
-
-export const DEFAULT_ORGANIZATION_MODEL_FEATURES: z.infer<typeof OrganizationModelFeaturesSchema> = {
-  enabled: {
-    acquisition: true,
-    delivery: true,
-    operations: true,
-    monitoring: true,
-    settings: true,
-    seo: false,
-    calibration: false
-  },
-  labels: {}
-}

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

@@ -1,5 +1,5 @@
 import { z } from 'zod'
-import { FeatureKeySchema } from './features'
+import { DELIVERY_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'])
@@ -10,9 +10,10 @@ export const SurfaceDefinitionSchema = z.object({
   path: PathSchema,
   surfaceType: SurfaceTypeSchema,
   description: DescriptionSchema.optional(),
+  enabled: z.boolean().default(true),
   icon: IconNameSchema.optional(),
-  featureKey: FeatureKeySchema.optional(),
-  domainIds: ReferenceIdsSchema,
+  featureId: ModelIdSchema.optional(),
+  featureIds: ReferenceIdsSchema,
   entityIds: ReferenceIdsSchema,
   resourceIds: ReferenceIdsSchema,
   capabilityIds: ReferenceIdsSchema,
@@ -40,8 +41,9 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       label: 'Pipeline',
       path: '/crm/pipeline',
       surfaceType: 'graph',
-      featureKey: 'acquisition',
-      domainIds: ['crm'],
+      enabled: true,
+      featureId: 'crm',
+      featureIds: ['crm'],
       entityIds: ['crm.deal'],
       resourceIds: [],
       capabilityIds: ['crm.pipeline.manage']
@@ -51,30 +53,33 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       label: 'Lists',
       path: '/lead-gen/lists',
       surfaceType: 'list',
-      featureKey: 'acquisition',
-      domainIds: ['lead-gen'],
+      enabled: true,
+      featureId: 'lead-gen',
+      featureIds: ['lead-gen'],
       entityIds: ['leadgen.list'],
       resourceIds: [],
       capabilityIds: ['leadgen.lists.manage']
     },
     {
-      id: 'projects.index',
+      id: PROJECTS_INDEX_SURFACE_ID,
       label: 'Projects',
       path: '/projects',
       surfaceType: 'list',
-      featureKey: 'delivery',
-      domainIds: ['delivery'],
+      enabled: true,
+      featureId: PROJECTS_FEATURE_ID,
+      featureIds: [PROJECTS_FEATURE_ID],
       entityIds: ['delivery.project'],
       resourceIds: [],
-      capabilityIds: ['delivery.projects.view']
+      capabilityIds: [DELIVERY_PROJECTS_VIEW_CAPABILITY_ID]
     },
     {
       id: 'operations.organization-graph',
       label: 'Organization Graph',
       path: '/operations/organization-graph',
       surfaceType: 'graph',
-      featureKey: 'operations',
-      domainIds: ['operations'],
+      enabled: true,
+      featureId: 'operations',
+      featureIds: ['operations'],
       entityIds: [],
       resourceIds: [],
       capabilityIds: ['operations.organization-graph']
@@ -84,20 +89,264 @@ export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationM
       label: 'Command View',
       path: '/operations/command-view',
       surfaceType: 'graph',
-      featureKey: 'operations',
-      domainIds: ['operations'],
+      enabled: false,
+      featureId: 'operations',
+      featureIds: ['operations'],
       entityIds: [],
       resourceIds: [],
       capabilityIds: ['operations.command-view']
+    },
+    {
+      id: 'operations.overview',
+      label: 'Overview',
+      path: '/operations',
+      surfaceType: 'dashboard',
+      enabled: true,
+      featureId: 'operations',
+      featureIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'operations.resources',
+      label: 'Resources',
+      path: '/operations/resources',
+      surfaceType: 'list',
+      enabled: true,
+      featureId: 'operations',
+      featureIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'operations.command-queue',
+      label: 'Command Queue',
+      path: '/operations/command-queue',
+      surfaceType: 'list',
+      enabled: true,
+      featureId: 'operations',
+      featureIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'operations.sessions',
+      label: 'Sessions',
+      path: '/operations/sessions',
+      surfaceType: 'page',
+      enabled: false,
+      featureId: 'operations',
+      featureIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'operations.task-scheduler',
+      label: 'Task Scheduler',
+      path: '/operations/task-scheduler',
+      surfaceType: 'page',
+      enabled: true,
+      featureId: 'operations',
+      featureIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'monitoring.activity-log',
+      label: 'Activity Log',
+      path: '/monitoring/activity-log',
+      surfaceType: 'list',
+      enabled: true,
+      featureId: 'monitoring',
+      featureIds: ['monitoring'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'monitoring.execution-logs',
+      label: 'Execution Logs',
+      path: '/monitoring/execution-logs',
+      surfaceType: 'list',
+      enabled: true,
+      featureId: 'monitoring',
+      featureIds: ['monitoring'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'monitoring.execution-health',
+      label: 'Execution Health',
+      path: '/monitoring/execution-health',
+      surfaceType: 'dashboard',
+      enabled: true,
+      featureId: 'monitoring',
+      featureIds: ['monitoring'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'monitoring.cost-analytics',
+      label: 'Cost Analytics',
+      path: '/monitoring/cost-analytics',
+      surfaceType: 'dashboard',
+      enabled: false,
+      featureId: 'monitoring',
+      featureIds: ['monitoring'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'monitoring.notifications',
+      label: 'Notifications',
+      path: '/monitoring/notifications',
+      surfaceType: 'page',
+      enabled: true,
+      featureId: 'monitoring',
+      featureIds: ['monitoring'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.account',
+      label: 'Account',
+      path: '/settings/account',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.appearance',
+      label: 'Appearance',
+      path: '/settings/appearance',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.organization',
+      label: 'Organization',
+      path: '/settings/organization',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.credentials',
+      label: 'Credentials',
+      path: '/settings/credentials',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.api-keys',
+      label: 'API Keys',
+      path: '/settings/api-keys',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.webhooks',
+      label: 'Webhooks',
+      path: '/settings/webhooks',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
+    },
+    {
+      id: 'settings.deployments',
+      label: 'Deployments',
+      path: '/settings/deployments',
+      surfaceType: 'settings',
+      enabled: true,
+      featureId: 'settings',
+      featureIds: ['settings'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: []
     }
   ],
   groups: [
-    { id: 'primary-workspace', label: 'Workspace', placement: 'primary', surfaceIds: ['crm.pipeline', 'lead-gen.lists', 'projects.index'] },
+    {
+      id: 'primary-workspace',
+      label: 'Workspace',
+      placement: 'primary',
+      surfaceIds: ['crm.pipeline', 'lead-gen.lists', PROJECTS_INDEX_SURFACE_ID]
+    },
     {
       id: 'primary-operations',
       label: 'Operations',
       placement: 'primary',
-      surfaceIds: ['operations.organization-graph', 'operations.command-view']
+      surfaceIds: [
+        'operations.organization-graph',
+        'operations.command-view',
+        'operations.overview',
+        'operations.resources',
+        'operations.command-queue',
+        'operations.sessions',
+        'operations.task-scheduler'
+      ]
+    },
+    {
+      id: 'primary-monitoring',
+      label: 'Monitoring',
+      placement: 'primary',
+      surfaceIds: [
+        'monitoring.activity-log',
+        'monitoring.execution-logs',
+        'monitoring.execution-health',
+        'monitoring.cost-analytics',
+        'monitoring.notifications'
+      ]
+    },
+    {
+      id: 'primary-settings',
+      label: 'Settings',
+      placement: 'bottom',
+      surfaceIds: [
+        'settings.account',
+        'settings.appearance',
+        'settings.organization',
+        'settings.credentials',
+        'settings.api-keys',
+        'settings.webhooks',
+        'settings.deployments'
+      ]
     }
   ]
 }

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

@@ -22,21 +22,12 @@ export const DisplayMetadataSchema = z.object({
   icon: IconNameSchema.optional()
 })
 
-export const SemanticDomainSchema = DisplayMetadataSchema.extend({
-  id: ModelIdSchema,
-  entityIds: ReferenceIdsSchema,
-  surfaceIds: ReferenceIdsSchema,
-  resourceIds: ReferenceIdsSchema,
-  capabilityIds: ReferenceIdsSchema
-})
-
 export const ResourceMappingSchema = DisplayMetadataSchema.extend({
   id: ModelIdSchema,
   resourceId: z.string().trim().min(1).max(255),
   resourceType: z.enum(['workflow', 'agent', 'trigger', 'integration', 'external', 'human_checkpoint']),
-  domainIds: ReferenceIdsSchema,
+  featureIds: ReferenceIdsSchema,
   entityIds: ReferenceIdsSchema,
   surfaceIds: ReferenceIdsSchema,
   capabilityIds: ReferenceIdsSchema
 })
-

package/src/organization-model/foundation.ts

@@ -0,0 +1,97 @@
+import { PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID } from './contracts'
+import { resolveOrganizationModel } from './resolve'
+import type { 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
+    quickAccessSurfaceIds: readonly string[]
+    surfaces: FoundationNavigationSurface[]
+  }
+}
+
+export interface FoundationBranding {
+  organizationName: string
+  productName: string
+  shortName: string
+}
+
+export function createFoundationOrganizationModel(branding: FoundationBranding): {
+  canonical: OrganizationModel
+  model: FoundationOrganizationModel
+  homeLabel: string
+  quickAccessSurfaceIds: readonly string[]
+  getOrganizationSurface: (surfaceId: string) => FoundationNavigationSurface | undefined
+} {
+  const canonical = resolveOrganizationModel({ branding })
+
+  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 homeLabel = 'Dashboard'
+  const quickAccessSurfaceIds = ['operations', PROJECTS_FEATURE_ID, 'lead-gen', 'crm'] as const
+
+  const model: FoundationOrganizationModel = {
+    ...canonical,
+    navigation: {
+      defaultSurfaceId: 'operations',
+      homeLabel,
+      quickAccessSurfaceIds: [...quickAccessSurfaceIds],
+      surfaces: navigationSurfaces
+    }
+  }
+
+  function getOrganizationSurface(surfaceId: string): FoundationNavigationSurface | undefined {
+    return model.navigation.surfaces.find((candidate) => candidate.id === surfaceId)
+  }
+
+  return {
+    canonical,
+    model,
+    homeLabel,
+    quickAccessSurfaceIds,
+    getOrganizationSurface
+  }
+}