@elevasis/core 0.4.0 → 0.6.0

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

@@ -0,0 +1,407 @@
+import { describe, expect, it } from 'vitest'
+import { DEFAULT_ORGANIZATION_MODEL_BRANDING } from '../domains/branding'
+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 { OrganizationModelSchema } from '../schema'
+
+// ---------------------------------------------------------------------------
+// Minimal valid fixture builders
+// ---------------------------------------------------------------------------
+
+function makeFeature(id: string, surfaceIds: string[] = [], resourceIds: string[] = []) {
+  return {
+    id,
+    label: id,
+    enabled: true,
+    entityIds: [],
+    surfaceIds,
+    resourceIds,
+    capabilityIds: []
+  }
+}
+
+function makeSurface(id: string, featureIds: string[] = [], resourceIds: string[] = []) {
+  return {
+    id,
+    label: id,
+    path: `/${id}`,
+    surfaceType: 'page' as const,
+    featureIds,
+    entityIds: [],
+    resourceIds,
+    capabilityIds: []
+  }
+}
+
+function makeGroup(id: string, surfaceIds: string[] = []) {
+  return { id, label: id, placement: 'primary' as const, surfaceIds }
+}
+
+function makeResourceMapping(id: string, resourceId: string, featureIds: string[] = [], surfaceIds: string[] = []) {
+  return {
+    id,
+    label: id,
+    resourceId,
+    resourceType: 'workflow' as const,
+    featureIds,
+    entityIds: [],
+    surfaceIds,
+    capabilityIds: []
+  }
+}
+
+/**
+ * A minimal model that satisfies all base-schema field requirements.
+ * The crm/leadGen/delivery fields use the official defaults so the schema
+ * layer validates cleanly, leaving superRefine as the only concern.
+ */
+function makeMinimalModel(
+  navOverride: { defaultSurfaceId?: string; surfaces?: unknown[]; groups?: unknown[] } = {},
+  extras: { features?: unknown[]; resourceMappings?: unknown[] } = {}
+) {
+  return {
+    version: 1 as const,
+    features: extras.features ?? [],
+    branding: DEFAULT_ORGANIZATION_MODEL_BRANDING,
+    navigation: {
+      defaultSurfaceId: navOverride.defaultSurfaceId,
+      surfaces: navOverride.surfaces ?? [],
+      groups: navOverride.groups ?? []
+    },
+    sales: DEFAULT_ORGANIZATION_MODEL_SALES,
+    prospecting: DEFAULT_ORGANIZATION_MODEL_PROSPECTING,
+    projects: DEFAULT_ORGANIZATION_MODEL_PROJECTS,
+    resourceMappings: extras.resourceMappings ?? []
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Helper: collect all Zod issue messages from a failed parse
+// ---------------------------------------------------------------------------
+
+function getIssueMessages(data: unknown): string[] {
+  const result = OrganizationModelSchema.safeParse(data)
+  if (result.success) return []
+  return result.error.issues.map((i) => i.message)
+}
+
+// ---------------------------------------------------------------------------
+// Group 1: Bidirectional feature <-> surface refs
+// ---------------------------------------------------------------------------
+
+describe('bidirectional feature <-> surface refs', () => {
+  it('passes when feature and surface correctly reference each other', () => {
+    const model = makeMinimalModel(
+      { surfaces: [makeSurface('crm.pipeline', ['crm'])], groups: [] },
+      { features: [makeFeature('crm', ['crm.pipeline'])] }
+    )
+
+    expect(() => OrganizationModelSchema.parse(model)).not.toThrow()
+  })
+
+  it('throws when feature references a surface that does not exist', () => {
+    const model = makeMinimalModel(
+      { surfaces: [], groups: [] },
+      { features: [makeFeature('crm', ['nonexistent-surface'])] }
+    )
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('references unknown surface'))).toBe(true)
+  })
+
+  it('throws when feature references a surface that does not include the feature', () => {
+    // Surface exists but its featureIds does not contain 'crm'
+    const model = makeMinimalModel(
+      { surfaces: [makeSurface('crm.pipeline', [] /* featureIds omits 'crm' */)], groups: [] },
+      { features: [makeFeature('crm', ['crm.pipeline'])] }
+    )
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('does not include feature'))).toBe(true)
+  })
+
+  it('throws when surface references a feature that does not exist', () => {
+    const model = makeMinimalModel(
+      { surfaces: [makeSurface('crm.pipeline', ['nonexistent-feature'])], groups: [] },
+      { features: [] }
+    )
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('references unknown feature'))).toBe(true)
+  })
+
+  it('throws when surface references a feature that does not include the surface', () => {
+    // Feature exists but its surfaceIds does not contain 'crm.pipeline'
+    const model = makeMinimalModel(
+      { surfaces: [makeSurface('crm.pipeline', ['crm'])], groups: [] },
+      { features: [makeFeature('crm', [] /* surfaceIds omits 'crm.pipeline' */)] }
+    )
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('does not include surface'))).toBe(true)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// Group 2: Duplicate ID detection
+// ---------------------------------------------------------------------------
+
+describe('duplicate ID detection', () => {
+  it('throws on duplicate feature IDs', () => {
+    const model = makeMinimalModel({ surfaces: [], groups: [] }, { features: [makeFeature('crm'), makeFeature('crm')] })
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('Feature id "crm" must be unique'))).toBe(true)
+  })
+
+  it('throws on duplicate surface IDs', () => {
+    const model = makeMinimalModel({
+      surfaces: [makeSurface('home'), makeSurface('home')],
+      groups: []
+    })
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('Surface id "home" must be unique'))).toBe(true)
+  })
+
+  it('throws on duplicate navigation group IDs', () => {
+    const model = makeMinimalModel({
+      surfaces: [],
+      groups: [makeGroup('primary'), makeGroup('primary')]
+    })
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('Navigation group id "primary" must be unique'))).toBe(true)
+  })
+
+  it('throws on duplicate resource mapping IDs', () => {
+    const model = makeMinimalModel(
+      { surfaces: [], groups: [] },
+      { resourceMappings: [makeResourceMapping('rm-1', 'res-a'), makeResourceMapping('rm-1', 'res-b')] }
+    )
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('Resource mapping id "rm-1" must be unique'))).toBe(true)
+  })
+
+  it('throws on duplicate resource mapping resourceIds', () => {
+    const model = makeMinimalModel(
+      { surfaces: [], groups: [] },
+      {
+        resourceMappings: [
+          makeResourceMapping('rm-1', 'shared-resource'),
+          makeResourceMapping('rm-2', 'shared-resource')
+        ]
+      }
+    )
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('resourceId "shared-resource" must be unique'))).toBe(true)
+  })
+
+  it('passes when all IDs are unique across all collections', () => {
+    const model = makeMinimalModel(
+      {
+        surfaces: [makeSurface('surf-1'), makeSurface('surf-2')],
+        groups: [makeGroup('grp-1'), makeGroup('grp-2')]
+      },
+      {
+        features: [makeFeature('feat-a'), makeFeature('feat-b')],
+        resourceMappings: [makeResourceMapping('rm-1', 'res-x'), makeResourceMapping('rm-2', 'res-y')]
+      }
+    )
+
+    expect(() => OrganizationModelSchema.parse(model)).not.toThrow()
+  })
+})
+
+// ---------------------------------------------------------------------------
+// Group 3: defaultSurfaceId correctness
+// ---------------------------------------------------------------------------
+
+describe('defaultSurfaceId correctness', () => {
+  it('passes when defaultSurfaceId points at a declared surface', () => {
+    const model = makeMinimalModel(
+      {
+        defaultSurfaceId: 'crm.pipeline',
+        surfaces: [makeSurface('crm.pipeline', ['crm'])],
+        groups: []
+      },
+      { features: [makeFeature('crm', ['crm.pipeline'])] }
+    )
+
+    expect(() => OrganizationModelSchema.parse(model)).not.toThrow()
+  })
+
+  it('throws when defaultSurfaceId references a surface that does not exist', () => {
+    const model = makeMinimalModel({
+      defaultSurfaceId: 'nonexistent',
+      surfaces: [],
+      groups: []
+    })
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('must reference a declared navigation surface'))).toBe(true)
+  })
+
+  it('passes when defaultSurfaceId is absent (undefined)', () => {
+    // NOTE: The falsy guard in schema.ts (line 69) skips the check entirely when
+    // defaultSurfaceId is undefined. This is current behavior — documented here.
+    const model = makeMinimalModel({ surfaces: [], groups: [] })
+
+    expect(() => OrganizationModelSchema.parse(model)).not.toThrow()
+  })
+})
+
+// ---------------------------------------------------------------------------
+// Group 4: Resource-mapping feature <-> surface cross-refs
+// ---------------------------------------------------------------------------
+
+describe('resource-mapping feature <-> surface cross-refs', () => {
+  it('passes with a fully consistent resource mapping', () => {
+    const model = makeMinimalModel(
+      { surfaces: [makeSurface('crm.pipeline', ['crm'], ['workflow-a'])], groups: [] },
+      {
+        features: [makeFeature('crm', ['crm.pipeline'], ['workflow-a'])],
+        resourceMappings: [makeResourceMapping('rm-1', 'workflow-a', ['crm'], ['crm.pipeline'])]
+      }
+    )
+
+    expect(() => OrganizationModelSchema.parse(model)).not.toThrow()
+  })
+
+  it('throws when resource mapping references a feature that does not exist', () => {
+    const model = makeMinimalModel(
+      { surfaces: [], groups: [] },
+      { resourceMappings: [makeResourceMapping('rm-1', 'res-a', ['nonexistent-feature'])] }
+    )
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('references unknown feature'))).toBe(true)
+  })
+
+  it('throws when resource mapping references a surface that does not exist', () => {
+    const model = makeMinimalModel(
+      { surfaces: [], groups: [] },
+      { resourceMappings: [makeResourceMapping('rm-1', 'res-a', [], ['nonexistent-surface'])] }
+    )
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('references unknown surface'))).toBe(true)
+  })
+
+  it('throws when feature resourceId ref exists but mapping does not back-reference the feature', () => {
+    // Resource mapping exists for 'workflow-a', feature lists it, but mapping.featureIds is empty
+    const model = makeMinimalModel(
+      { surfaces: [], groups: [] },
+      {
+        features: [makeFeature('crm', [], ['workflow-a'])],
+        resourceMappings: [makeResourceMapping('rm-1', 'workflow-a', [] /* missing 'crm' */)]
+      }
+    )
+
+    const messages = getIssueMessages(model)
+    // Feature side: "does not include resource"; ResourceMapping side: the feature is missing
+    expect(
+      messages.some((m) => m.includes('does not include resource') || m.includes('does not include feature'))
+    ).toBe(true)
+  })
+
+  it('throws when surface resourceId ref exists but mapping does not back-reference the surface', () => {
+    // Resource mapping exists for 'workflow-b', surface lists it, but mapping.surfaceIds is empty
+    const model = makeMinimalModel(
+      { surfaces: [makeSurface('home', [], ['workflow-b'])], groups: [] },
+      { resourceMappings: [makeResourceMapping('rm-2', 'workflow-b', [], [] /* missing 'home' */)] }
+    )
+
+    const messages = getIssueMessages(model)
+    expect(
+      messages.some((m) => m.includes('does not include resource') || m.includes('does not include surface'))
+    ).toBe(true)
+  })
+
+  it('throws when feature references a resourceId that has no matching resource mapping', () => {
+    const model = makeMinimalModel(
+      { surfaces: [], groups: [] },
+      {
+        features: [makeFeature('crm', [], ['unknown-resource'])],
+        resourceMappings: []
+      }
+    )
+
+    const messages = getIssueMessages(model)
+    expect(messages.some((m) => m.includes('references unknown resource'))).toBe(true)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// Group 5: Null / undefined behavior in ref fields
+// ---------------------------------------------------------------------------
+
+describe('null/undefined behavior in ref fields', () => {
+  it('treats missing surfaceIds as empty array via Zod default — no superRefine errors', () => {
+    // ReferenceIdsSchema defaults to []; omitting surfaceIds is safe — nothing to iterate
+    const model = makeMinimalModel(
+      { surfaces: [], groups: [] },
+      {
+        features: [
+          {
+            id: 'crm',
+            label: 'CRM',
+            enabled: true,
+            entityIds: [],
+            // surfaceIds intentionally omitted — Zod fills in []
+            resourceIds: [],
+            capabilityIds: []
+          }
+        ]
+      }
+    )
+
+    expect(() => OrganizationModelSchema.parse(model)).not.toThrow()
+  })
+
+  it('treats missing featureIds on a surface as empty array — no superRefine errors', () => {
+    const model = makeMinimalModel({
+      surfaces: [
+        {
+          id: 'home',
+          label: 'Home',
+          path: '/home',
+          surfaceType: 'page' as const,
+          // featureIds intentionally omitted — Zod fills in []
+          entityIds: [],
+          resourceIds: [],
+          capabilityIds: []
+        }
+      ],
+      groups: []
+    })
+
+    expect(() => OrganizationModelSchema.parse(model)).not.toThrow()
+  })
+
+  it('rejects explicit null for surfaceIds — Zod type error before superRefine runs', () => {
+    // null is not assignable to an array; the base schema rejects it before superRefine executes
+    const model = makeMinimalModel(
+      { surfaces: [], groups: [] },
+      {
+        features: [
+          {
+            id: 'crm',
+            label: 'CRM',
+            enabled: true,
+            entityIds: [],
+            surfaceIds: null,
+            resourceIds: [],
+            capabilityIds: []
+          }
+        ]
+      }
+    )
+
+    const result = OrganizationModelSchema.safeParse(model)
+    expect(result.success).toBe(false)
+  })
+})

package/src/organization-model/contracts.ts

@@ -1,3 +1,14 @@
 export const PROJECTS_FEATURE_ID = 'projects' as const
 export const PROJECTS_INDEX_SURFACE_ID = 'projects.index' as const
-export const DELIVERY_PROJECTS_VIEW_CAPABILITY_ID = 'delivery.projects.view' as const
+export const PROJECTS_VIEW_CAPABILITY_ID = 'delivery.projects.view' as const
+
+export const SALES_FEATURE_ID = 'crm' as const
+export const PROSPECTING_FEATURE_ID = 'lead-gen' as const
+export const OPERATIONS_FEATURE_ID = 'operations' as const
+export const MONITORING_FEATURE_ID = 'monitoring' as const
+export const SETTINGS_FEATURE_ID = 'settings' as const
+export const SEO_FEATURE_ID = 'seo' as const
+
+export const SALES_PIPELINE_SURFACE_ID = 'crm.pipeline' as const
+export const PROSPECTING_LISTS_SURFACE_ID = 'lead-gen.lists' as const
+export const OPERATIONS_ORGANIZATION_GRAPH_SURFACE_ID = 'operations.organization-graph' as const

package/src/organization-model/defaults.ts

@@ -1,33 +1,53 @@
 import type { OrganizationModel } from './types'
-import { DELIVERY_PROJECTS_VIEW_CAPABILITY_ID, PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID } from './contracts'
+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_CRM } from './domains/crm'
-import { DEFAULT_ORGANIZATION_MODEL_DELIVERY } from './domains/delivery'
-import { DEFAULT_ORGANIZATION_MODEL_LEAD_GEN } from './domains/lead-gen'
+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_STATUSES } from './domains/statuses'
 
 export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
   version: 1,
   features: [
     {
-      id: 'crm',
+      id: SALES_FEATURE_ID,
       label: 'CRM',
       description: 'Relationship pipeline and deal management',
       enabled: true,
       color: 'blue',
       entityIds: ['crm.deal'],
-      surfaceIds: ['crm.pipeline'],
+      surfaceIds: [SALES_PIPELINE_SURFACE_ID],
       resourceIds: [],
       capabilityIds: ['crm.pipeline.manage']
     },
     {
-      id: 'lead-gen',
+      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: ['lead-gen.lists'],
+      surfaceIds: [PROSPECTING_LISTS_SURFACE_ID],
       resourceIds: [],
       capabilityIds: ['leadgen.lists.manage']
     },
@@ -40,17 +60,17 @@ export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
       entityIds: ['delivery.project', 'delivery.milestone', 'delivery.task'],
       surfaceIds: [PROJECTS_INDEX_SURFACE_ID],
       resourceIds: [],
-      capabilityIds: [DELIVERY_PROJECTS_VIEW_CAPABILITY_ID]
+      capabilityIds: [PROJECTS_VIEW_CAPABILITY_ID]
     },
     {
-      id: 'operations',
+      id: OPERATIONS_FEATURE_ID,
       label: 'Operations',
       description: 'Operational resources, topology, and orchestration visibility',
       enabled: true,
       color: 'violet',
       entityIds: [],
       surfaceIds: [
-        'operations.organization-graph',
+        OPERATIONS_ORGANIZATION_GRAPH_SURFACE_ID,
         'operations.command-view',
         'operations.overview',
         'operations.resources',
@@ -62,7 +82,7 @@ export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
       capabilityIds: ['operations.organization-graph', 'operations.command-view']
     },
     {
-      id: 'monitoring',
+      id: MONITORING_FEATURE_ID,
       label: 'Monitoring',
       enabled: true,
       entityIds: [],
@@ -77,7 +97,7 @@ export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
       capabilityIds: []
     },
     {
-      id: 'settings',
+      id: SETTINGS_FEATURE_ID,
       label: 'Settings',
       enabled: true,
       entityIds: [],
@@ -94,7 +114,16 @@ export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
       capabilityIds: []
     },
     {
-      id: 'seo',
+      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: [],
@@ -105,8 +134,15 @@ export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
   ],
   branding: DEFAULT_ORGANIZATION_MODEL_BRANDING,
   navigation: DEFAULT_ORGANIZATION_MODEL_NAVIGATION,
-  crm: DEFAULT_ORGANIZATION_MODEL_CRM,
-  leadGen: DEFAULT_ORGANIZATION_MODEL_LEAD_GEN,
-  delivery: DEFAULT_ORGANIZATION_MODEL_DELIVERY,
+  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: []
 }

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

@@ -0,0 +1,75 @@
+import { z } from 'zod'
+
+// ---------------------------------------------------------------------------
+// Firmographics — optional demographic/firmographic filters that describe the
+// target customer segment's organizational profile. All fields are optional so
+// a segment can declare only the axes relevant to targeting.
+// ---------------------------------------------------------------------------
+
+export const FirmographicsSchema = z.object({
+  /** Industry vertical (e.g. "Marketing Agency", "Legal", "Real Estate"). */
+  industry: z.string().trim().max(200).optional(),
+  /**
+   * Company headcount band (e.g. "1–10", "11–50", "51–200", "200+").
+   * Free-form string to accommodate any band notation.
+   */
+  companySize: z.string().trim().max(100).optional(),
+  /**
+   * Primary geographic region the segment operates in or is targeted from
+   * (e.g. "North America", "Europe", "Global").
+   */
+  region: z.string().trim().max(200).optional()
+})
+
+// ---------------------------------------------------------------------------
+// Customer segment schema — one entry per distinct buyer archetype.
+// Modeled after Value Proposition Canvas (BMC / VPC) and Business Model Canvas
+// customer-segment language. Fields use plain English throughout.
+// ---------------------------------------------------------------------------
+
+export const CustomerSegmentSchema = z.object({
+  /** Stable unique identifier for the segment (e.g. "segment-smb-agencies"). */
+  id: z.string().trim().min(1).max(100),
+  /** Human-readable name shown to agents and in UI (e.g. "SMB Marketing Agencies"). */
+  name: z.string().trim().max(200).default(''),
+  /** One or two sentences describing who this segment is. */
+  description: z.string().trim().max(2000).default(''),
+  /**
+   * The primary job(s) this segment is trying to get done — the goal they hire
+   * a product/service to accomplish. Plain-language narrative or bullet list.
+   */
+  jobsToBeDone: z.string().trim().max(2000).default(''),
+  /**
+   * Pains — frustrations, obstacles, and risks the segment experiences
+   * when trying to accomplish their jobs-to-be-done.
+   */
+  pains: z.array(z.string().trim().max(500)).default([]),
+  /**
+   * Gains — outcomes and benefits the segment desires; positive motivators
+   * beyond merely resolving pains.
+   */
+  gains: z.array(z.string().trim().max(500)).default([]),
+  /** Firmographic profile for targeting and filtering. */
+  firmographics: FirmographicsSchema.default({}),
+  /**
+   * Value proposition — one or two sentences stating why this organization's
+   * offering is uniquely suited for this segment's needs.
+   */
+  valueProp: z.string().trim().max(2000).default('')
+})
+
+// ---------------------------------------------------------------------------
+// Customers domain schema — a collection of customer segments.
+// ---------------------------------------------------------------------------
+
+export const CustomersDomainSchema = z.object({
+  segments: z.array(CustomerSegmentSchema).default([])
+})
+
+// ---------------------------------------------------------------------------
+// Seed — empty by default; adapters populate with real segment definitions.
+// ---------------------------------------------------------------------------
+
+export const DEFAULT_ORGANIZATION_MODEL_CUSTOMERS: z.infer<typeof CustomersDomainSchema> = {
+  segments: []
+}