@elevasis/core 0.1.0

package/src/organization-model/__tests__/resolve.test.ts

@@ -0,0 +1,47 @@
+import { describe, expect, it } from 'vitest'
+import { defineOrganizationModel, resolveOrganizationModel } from '../resolve'
+
+describe('organization-model', () => {
+  it('resolves defaults for a minimal override', () => {
+    const model = resolveOrganizationModel(
+      defineOrganizationModel({
+        branding: {
+          organizationName: 'Acme',
+          productName: 'Acme OS',
+          shortName: 'Acme'
+        }
+      })
+    )
+
+    expect(model.version).toBe(1)
+    expect(model.branding.organizationName).toBe('Acme')
+    expect(model.crm.pipelines[0]?.stages).toHaveLength(6)
+    expect(model.navigation.defaultSurfaceId).toBe('crm.pipeline')
+    expect(model.features.enabled.operations).toBe(true)
+  })
+
+  it('replaces arrays when a downstream override supplies a full slice', () => {
+    const model = resolveOrganizationModel({
+      navigation: {
+        defaultSurfaceId: 'custom.home',
+        surfaces: [
+          {
+            id: 'custom.home',
+            label: 'Home',
+            path: '/home',
+            surfaceType: 'page',
+            domainIds: ['crm'],
+            entityIds: [],
+            resourceIds: [],
+            capabilityIds: []
+          }
+        ],
+        groups: [{ id: 'primary', label: 'Primary', placement: 'primary', surfaceIds: ['custom.home'] }]
+      }
+    })
+
+    expect(model.navigation.defaultSurfaceId).toBe('custom.home')
+    expect(model.navigation.surfaces).toHaveLength(1)
+    expect(model.navigation.surfaces[0]?.path).toBe('/home')
+  })
+})

package/src/organization-model/defaults.ts

@@ -0,0 +1,60 @@
+import type { OrganizationModel } from './types'
+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: [
+    {
+      id: 'crm',
+      label: 'CRM',
+      description: 'Relationship pipeline and deal management',
+      color: 'blue',
+      entityIds: ['crm.deal'],
+      surfaceIds: ['crm.pipeline'],
+      resourceIds: [],
+      capabilityIds: ['crm.pipeline.manage']
+    },
+    {
+      id: 'lead-gen',
+      label: 'Lead Gen',
+      description: 'Prospecting, qualification, and outreach preparation',
+      color: 'cyan',
+      entityIds: ['leadgen.list', 'leadgen.company', 'leadgen.contact'],
+      surfaceIds: ['lead-gen.lists'],
+      resourceIds: [],
+      capabilityIds: ['leadgen.lists.manage']
+    },
+    {
+      id: 'delivery',
+      label: 'Delivery',
+      description: 'Projects, milestones, and client work execution',
+      color: 'orange',
+      entityIds: ['delivery.project', 'delivery.milestone', 'delivery.task'],
+      surfaceIds: ['projects.index'],
+      resourceIds: [],
+      capabilityIds: ['delivery.projects.view']
+    },
+    {
+      id: 'operations',
+      label: 'Operations',
+      description: 'Operational resources, topology, and orchestration visibility',
+      color: 'violet',
+      entityIds: [],
+      surfaceIds: ['operations.organization-graph', 'operations.command-view'],
+      resourceIds: [],
+      capabilityIds: ['operations.organization-graph', 'operations.command-view']
+    }
+  ],
+  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,
+  delivery: DEFAULT_ORGANIZATION_MODEL_DELIVERY,
+  resourceMappings: []
+}

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

@@ -0,0 +1,22 @@
+import { z } from 'zod'
+import { DescriptionSchema, LabelSchema } from './shared'
+
+export const OrganizationModelBrandingSchema = z.object({
+  organizationName: LabelSchema,
+  productName: LabelSchema,
+  shortName: z.string().trim().min(1).max(40),
+  description: DescriptionSchema.optional(),
+  logos: z
+    .object({
+      light: z.string().trim().min(1).max(2048).optional(),
+      dark: z.string().trim().min(1).max(2048).optional()
+    })
+    .default({})
+})
+
+export const DEFAULT_ORGANIZATION_MODEL_BRANDING: z.infer<typeof OrganizationModelBrandingSchema> = {
+  organizationName: 'Default Organization',
+  productName: 'Elevasis',
+  shortName: 'Elevasis',
+  logos: {}
+}

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

@@ -0,0 +1,46 @@
+import { z } from 'zod'
+import { DescriptionSchema, DisplayMetadataSchema, ModelIdSchema, ReferenceIdsSchema } from './shared'
+
+export const CrmStageSemanticClassSchema = z.enum(['open', 'active', 'nurturing', 'closed_won', 'closed_lost'])
+
+export const CrmStageSchema = DisplayMetadataSchema.extend({
+  id: ModelIdSchema,
+  order: z.number().int().min(0),
+  semanticClass: CrmStageSemanticClassSchema,
+  surfaceIds: ReferenceIdsSchema,
+  resourceIds: ReferenceIdsSchema
+})
+
+export const CrmPipelineSchema = z.object({
+  id: ModelIdSchema,
+  label: z.string().trim().min(1).max(120),
+  description: DescriptionSchema.optional(),
+  entityId: ModelIdSchema,
+  stages: z.array(CrmStageSchema).min(1)
+})
+
+export const OrganizationModelCrmSchema = z.object({
+  entityId: ModelIdSchema,
+  defaultPipelineId: ModelIdSchema,
+  pipelines: z.array(CrmPipelineSchema).min(1)
+})
+
+export const DEFAULT_ORGANIZATION_MODEL_CRM: z.infer<typeof OrganizationModelCrmSchema> = {
+  entityId: 'crm.deal',
+  defaultPipelineId: 'default',
+  pipelines: [
+    {
+      id: 'default',
+      label: 'Default Pipeline',
+      entityId: 'crm.deal',
+      stages: [
+        { id: 'interested', label: 'Interested', color: 'blue', order: 1, semanticClass: 'open', surfaceIds: ['crm.pipeline'], resourceIds: [] },
+        { id: 'proposal', label: 'Proposal', color: 'yellow', order: 2, semanticClass: 'active', surfaceIds: ['crm.pipeline'], resourceIds: [] },
+        { id: 'closing', label: 'Closing', color: 'lime', order: 3, semanticClass: 'active', surfaceIds: ['crm.pipeline'], resourceIds: [] },
+        { id: 'closed_won', label: 'Closed Won', color: 'green', order: 4, semanticClass: 'closed_won', surfaceIds: ['crm.pipeline'], resourceIds: [] },
+        { id: 'closed_lost', label: 'Closed Lost', color: 'red', order: 5, semanticClass: 'closed_lost', surfaceIds: ['crm.pipeline'], resourceIds: [] },
+        { id: 'nurturing', label: 'Nurturing', color: 'grape', order: 6, semanticClass: 'nurturing', surfaceIds: ['crm.pipeline'], resourceIds: [] }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,48 @@
+import { z } from 'zod'
+import { DisplayMetadataSchema, ModelIdSchema } from './shared'
+
+export const DeliveryStateSchema = DisplayMetadataSchema.extend({
+  id: ModelIdSchema,
+  order: z.number().int().min(0)
+})
+
+export const OrganizationModelDeliverySchema = z.object({
+  projectEntityId: ModelIdSchema,
+  milestoneEntityId: ModelIdSchema,
+  taskEntityId: ModelIdSchema,
+  projectStatuses: z.array(DeliveryStateSchema).min(1),
+  milestoneStatuses: z.array(DeliveryStateSchema).min(1),
+  taskStatuses: z.array(DeliveryStateSchema).min(1)
+})
+
+export const DEFAULT_ORGANIZATION_MODEL_DELIVERY: z.infer<typeof OrganizationModelDeliverySchema> = {
+  projectEntityId: 'delivery.project',
+  milestoneEntityId: 'delivery.milestone',
+  taskEntityId: 'delivery.task',
+  projectStatuses: [
+    { id: 'active', label: 'Active', order: 1 },
+    { id: 'on_track', label: 'On Track', order: 2 },
+    { id: 'at_risk', label: 'At Risk', order: 3 },
+    { id: 'blocked', label: 'Blocked', order: 4 },
+    { id: 'paused', label: 'Paused', order: 5 },
+    { id: 'completed', label: 'Completed', order: 6 }
+  ],
+  milestoneStatuses: [
+    { id: 'upcoming', label: 'Upcoming', order: 1 },
+    { id: 'in_progress', label: 'In Progress', order: 2 },
+    { id: 'blocked', label: 'Blocked', order: 3 },
+    { id: 'overdue', label: 'Overdue', order: 4 },
+    { id: 'completed', label: 'Completed', order: 5 }
+  ],
+  taskStatuses: [
+    { id: 'planned', label: 'Planned', order: 1 },
+    { id: 'in_progress', label: 'In Progress', order: 2 },
+    { id: 'blocked', label: 'Blocked', order: 3 },
+    { id: 'submitted', label: 'Submitted', order: 4 },
+    { id: 'approved', label: 'Approved', order: 5 },
+    { id: 'revision_requested', label: 'Revision Requested', order: 6 },
+    { id: 'rejected', label: 'Rejected', order: 7 },
+    { id: 'cancelled', label: 'Cancelled', order: 8 },
+    { id: 'completed', label: 'Completed', order: 9 }
+  ]
+}

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

@@ -0,0 +1,57 @@
+import { z } from 'zod'
+
+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 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/lead-gen.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod'
+import { DescriptionSchema, DisplayMetadataSchema, ModelIdSchema } from './shared'
+
+export const LeadGenLifecycleStageSchema = DisplayMetadataSchema.extend({
+  id: ModelIdSchema,
+  order: z.number().int().min(0)
+})
+
+export const OrganizationModelLeadGenSchema = z.object({
+  listEntityId: ModelIdSchema,
+  companyEntityId: ModelIdSchema,
+  contactEntityId: ModelIdSchema,
+  description: DescriptionSchema.optional(),
+  companyStages: z.array(LeadGenLifecycleStageSchema).min(1),
+  contactStages: z.array(LeadGenLifecycleStageSchema).min(1)
+})
+
+export const DEFAULT_ORGANIZATION_MODEL_LEAD_GEN: z.infer<typeof OrganizationModelLeadGenSchema> = {
+  listEntityId: 'leadgen.list',
+  companyEntityId: 'leadgen.company',
+  contactEntityId: 'leadgen.contact',
+  companyStages: [
+    { id: 'populated', label: 'Populated', order: 1 },
+    { id: 'extracted', label: 'Extracted', order: 2 },
+    { id: 'qualified', label: 'Qualified', order: 3 }
+  ],
+  contactStages: [
+    { id: 'discovered', label: 'Discovered', order: 1 },
+    { id: 'verified', label: 'Verified', order: 2 },
+    { id: 'personalized', label: 'Personalized', order: 3 },
+    { id: 'uploaded', label: 'Uploaded', order: 4 }
+  ]
+}

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

@@ -0,0 +1,103 @@
+import { z } from 'zod'
+import { FeatureKeySchema } from './features'
+import { DescriptionSchema, IconNameSchema, LabelSchema, ModelIdSchema, PathSchema, ReferenceIdsSchema } from './shared'
+
+export const SurfaceTypeSchema = z.enum(['page', 'dashboard', 'graph', 'detail', 'list', 'settings'])
+
+export const SurfaceDefinitionSchema = z.object({
+  id: ModelIdSchema,
+  label: LabelSchema,
+  path: PathSchema,
+  surfaceType: SurfaceTypeSchema,
+  description: DescriptionSchema.optional(),
+  icon: IconNameSchema.optional(),
+  featureKey: FeatureKeySchema.optional(),
+  domainIds: ReferenceIdsSchema,
+  entityIds: ReferenceIdsSchema,
+  resourceIds: ReferenceIdsSchema,
+  capabilityIds: ReferenceIdsSchema,
+  parentId: ModelIdSchema.optional()
+})
+
+export const NavigationGroupSchema = z.object({
+  id: ModelIdSchema,
+  label: LabelSchema,
+  placement: z.enum(['primary', 'secondary', 'bottom']),
+  surfaceIds: z.array(ModelIdSchema).default([])
+})
+
+export const OrganizationModelNavigationSchema = z.object({
+  defaultSurfaceId: ModelIdSchema.optional(),
+  surfaces: z.array(SurfaceDefinitionSchema).default([]),
+  groups: z.array(NavigationGroupSchema).default([])
+})
+
+export const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: z.infer<typeof OrganizationModelNavigationSchema> = {
+  defaultSurfaceId: 'crm.pipeline',
+  surfaces: [
+    {
+      id: 'crm.pipeline',
+      label: 'Pipeline',
+      path: '/crm/pipeline',
+      surfaceType: 'graph',
+      featureKey: 'acquisition',
+      domainIds: ['crm'],
+      entityIds: ['crm.deal'],
+      resourceIds: [],
+      capabilityIds: ['crm.pipeline.manage']
+    },
+    {
+      id: 'lead-gen.lists',
+      label: 'Lists',
+      path: '/lead-gen/lists',
+      surfaceType: 'list',
+      featureKey: 'acquisition',
+      domainIds: ['lead-gen'],
+      entityIds: ['leadgen.list'],
+      resourceIds: [],
+      capabilityIds: ['leadgen.lists.manage']
+    },
+    {
+      id: 'projects.index',
+      label: 'Projects',
+      path: '/projects',
+      surfaceType: 'list',
+      featureKey: 'delivery',
+      domainIds: ['delivery'],
+      entityIds: ['delivery.project'],
+      resourceIds: [],
+      capabilityIds: ['delivery.projects.view']
+    },
+    {
+      id: 'operations.organization-graph',
+      label: 'Organization Graph',
+      path: '/operations/organization-graph',
+      surfaceType: 'graph',
+      featureKey: 'operations',
+      domainIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: ['operations.organization-graph']
+    },
+    {
+      id: 'operations.command-view',
+      label: 'Command View',
+      path: '/operations/command-view',
+      surfaceType: 'graph',
+      featureKey: 'operations',
+      domainIds: ['operations'],
+      entityIds: [],
+      resourceIds: [],
+      capabilityIds: ['operations.command-view']
+    }
+  ],
+  groups: [
+    { id: 'primary-workspace', label: 'Workspace', placement: 'primary', surfaceIds: ['crm.pipeline', 'lead-gen.lists', 'projects.index'] },
+    {
+      id: 'primary-operations',
+      label: 'Operations',
+      placement: 'primary',
+      surfaceIds: ['operations.organization-graph', 'operations.command-view']
+    }
+  ]
+}

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

@@ -0,0 +1,42 @@
+import { z } from 'zod'
+
+export const ModelIdSchema = z
+  .string()
+  .trim()
+  .min(1)
+  .max(100)
+  .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 ReferenceIdsSchema = z.array(ModelIdSchema).default([])
+
+export const DisplayMetadataSchema = z.object({
+  label: LabelSchema,
+  description: DescriptionSchema.optional(),
+  color: ColorTokenSchema.optional(),
+  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,
+  entityIds: ReferenceIdsSchema,
+  surfaceIds: ReferenceIdsSchema,
+  capabilityIds: ReferenceIdsSchema
+})
+