@elevasis/core 0.40.0 → 0.42.0

package/src/business/clients/api-schemas.test.ts

@@ -1,10 +1,12 @@
 import { describe, expect, it } from 'vitest'
 import {
-  ClientDetailResponseSchema,
-  ClientListResponseSchema,
-  ClientStatusResponseSchema,
-  ListClientsQuerySchema
-} from './api-schemas'
+  ClientDetailResponseSchema,
+  ClientListResponseSchema,
+  ClientStatusResponseSchema,
+  CreateClientRequestSchema,
+  ListClientsQuerySchema,
+  UpdateClientRequestSchema
+} from './api-schemas'
 
 const VALID_UUID = '00000000-0000-4000-8000-000000000001'
 const ISO_TS = '2026-05-08T00:00:00.000Z'
@@ -12,19 +14,21 @@ const ISO_TS = '2026-05-08T00:00:00.000Z'
 describe('client API schemas', () => {
   it('coerces list pagination and accepts status/search filters', () => {
     const result = ListClientsQuerySchema.safeParse({
-      status: 'active',
-      search: 'Acme',
-      limit: '10',
-      offset: '20'
+      status: 'active',
+      source: 'acquisition',
+      search: 'Acme',
+      limit: '10',
+      offset: '20'
     })
 
     expect(result.success).toBe(true)
     if (result.success) {
       expect(result.data).toEqual({
-        status: 'active',
-        search: 'Acme',
-        limit: 10,
-        offset: 20
+        status: 'active',
+        source: 'acquisition',
+        search: 'Acme',
+        limit: 10,
+        offset: 20
       })
     }
   })
@@ -40,10 +44,11 @@ describe('client API schemas', () => {
           {
             id: VALID_UUID,
             organizationId: VALID_UUID,
-            name: 'Acme',
-            status: 'active',
-            sourceDealId: null,
-            primaryCompanyId: null,
+            name: 'Acme',
+            status: 'active',
+            source: 'manual',
+            sourceDealId: null,
+            primaryCompanyId: null,
             primaryContactId: null,
             convertedAt: null,
             metadata: {},
@@ -63,13 +68,14 @@ describe('client API schemas', () => {
       ClientDetailResponseSchema.safeParse({
         id: VALID_UUID,
         organizationId: VALID_UUID,
-        name: 'Acme',
-        status: 'onboarding',
-        sourceDealId: VALID_UUID,
-        primaryCompanyId: VALID_UUID,
-        primaryContactId: VALID_UUID,
-        convertedAt: ISO_TS,
-        metadata: { source: 'closed_won' },
+        name: 'Acme',
+        status: 'onboarding',
+        source: 'acquisition',
+        sourceDealId: VALID_UUID,
+        primaryCompanyId: VALID_UUID,
+        primaryContactId: VALID_UUID,
+        convertedAt: ISO_TS,
+        metadata: { externalProjectSlug: 'developer-workspace-slug' },
         createdAt: ISO_TS,
         updatedAt: ISO_TS,
         lineage: {
@@ -96,11 +102,39 @@ describe('client API schemas', () => {
             }
           ]
         }
-      }).success
-    ).toBe(true)
-  })
-
-  it('accepts client portfolio status responses', () => {
+      }).success
+    ).toBe(true)
+  })
+
+  it('accepts direct word-of-mouth client create requests with metadata for workspace details', () => {
+    expect(
+      CreateClientRequestSchema.safeParse({
+        name: 'Byron for Irvine',
+        status: 'onboarding',
+        source: 'word_of_mouth',
+        metadata: {
+          externalProjectSlug: 'developer-workspace-slug',
+          workspacePath: 'client-workspace',
+          campaignSlug: 'byron-for-irvine'
+        }
+      }).success
+    ).toBe(true)
+  })
+
+  it('rejects invalid client source format', () => {
+    expect(
+      CreateClientRequestSchema.safeParse({
+        name: 'Byron for Irvine',
+        source: 'Word of mouth'
+      }).success
+    ).toBe(false)
+  })
+
+  it('accepts source-only client update requests', () => {
+    expect(UpdateClientRequestSchema.safeParse({ source: 'acquisition' }).success).toBe(true)
+  })
+
+  it('accepts client portfolio status responses', () => {
     expect(
       ClientStatusResponseSchema.safeParse({
         totalClients: 1,

package/src/business/clients/api-schemas.ts

@@ -1,7 +1,13 @@
 import { z } from 'zod'
 import { UuidSchema } from '../../platform/utils/validation'
 
-export const ClientStatusSchema = z.enum(['active', 'onboarding', 'paused', 'completed', 'churned'])
+export const ClientStatusSchema = z.enum(['active', 'onboarding', 'paused', 'completed', 'churned'])
+export const ClientSourceSchema = z
+  .string()
+  .trim()
+  .min(1)
+  .max(64)
+  .regex(/^[a-z][a-z0-9_]*$/, 'Source must use lowercase letters, numbers, and underscores')
 
 export const ClientIdParamsSchema = z
   .object({
@@ -9,12 +15,13 @@ export const ClientIdParamsSchema = z
   })
   .strict()
 
-export const ListClientsQuerySchema = z
-  .object({
-    status: ClientStatusSchema.optional(),
-    search: z.string().trim().min(1).max(255).optional(),
-    limit: z.coerce.number().int().min(1).max(100).default(50),
-    offset: z.coerce.number().int().min(0).default(0)
+export const ListClientsQuerySchema = z
+  .object({
+    status: ClientStatusSchema.optional(),
+    source: ClientSourceSchema.optional(),
+    search: z.string().trim().min(1).max(255).optional(),
+    limit: z.coerce.number().int().min(1).max(100).default(50),
+    offset: z.coerce.number().int().min(0).default(0)
   })
   .strict()
 
@@ -26,12 +33,13 @@ export const ClientRefSchema = z.object({
 
 export const ClientResponseSchema = z.object({
   id: z.string(),
-  organizationId: z.string(),
-  name: z.string(),
-  status: ClientStatusSchema,
-  sourceDealId: z.string().nullable(),
-  primaryCompanyId: z.string().nullable(),
-  primaryContactId: z.string().nullable(),
+  organizationId: z.string(),
+  name: z.string(),
+  status: ClientStatusSchema,
+  source: ClientSourceSchema,
+  sourceDealId: z.string().nullable(),
+  primaryCompanyId: z.string().nullable(),
+  primaryContactId: z.string().nullable(),
   convertedAt: z.string().nullable(),
   metadata: z.record(z.string(), z.unknown()),
   createdAt: z.string(),
@@ -100,22 +108,24 @@ export const ClientStatusResponseSchema = z.object({
 
 export const CreateClientRequestSchema = z
   .object({
-    name: z.string().trim().min(1).max(255),
-    status: ClientStatusSchema.optional(),
-    sourceDealId: UuidSchema.nullable().optional(),
-    primaryCompanyId: UuidSchema.nullable().optional(),
-    primaryContactId: UuidSchema.nullable().optional(),
+    name: z.string().trim().min(1).max(255),
+    status: ClientStatusSchema.optional(),
+    source: ClientSourceSchema.optional(),
+    sourceDealId: UuidSchema.nullable().optional(),
+    primaryCompanyId: UuidSchema.nullable().optional(),
+    primaryContactId: UuidSchema.nullable().optional(),
     metadata: z.record(z.string(), z.unknown()).nullable().optional()
   })
   .strict()
 
 export const UpdateClientRequestSchema = z
   .object({
-    name: z.string().trim().min(1).max(255).optional(),
-    status: ClientStatusSchema.optional(),
-    sourceDealId: UuidSchema.nullable().optional(),
-    primaryCompanyId: UuidSchema.nullable().optional(),
-    primaryContactId: UuidSchema.nullable().optional(),
+    name: z.string().trim().min(1).max(255).optional(),
+    status: ClientStatusSchema.optional(),
+    source: ClientSourceSchema.optional(),
+    sourceDealId: UuidSchema.nullable().optional(),
+    primaryCompanyId: UuidSchema.nullable().optional(),
+    primaryContactId: UuidSchema.nullable().optional(),
     metadata: z.record(z.string(), z.unknown()).nullable().optional()
   })
   .strict()
@@ -123,10 +133,11 @@ export const UpdateClientRequestSchema = z
     message: 'At least one field must be provided'
   })
 
-export const ClientSchemas = {
-  ClientStatus: ClientStatusSchema,
-  ClientIdParams: ClientIdParamsSchema,
-  ListClientsQuery: ListClientsQuerySchema,
+export const ClientSchemas = {
+  ClientStatus: ClientStatusSchema,
+  ClientSource: ClientSourceSchema,
+  ClientIdParams: ClientIdParamsSchema,
+  ListClientsQuery: ListClientsQuerySchema,
   ClientRef: ClientRefSchema,
   ClientResponse: ClientResponseSchema,
   ClientDealRef: ClientDealRefSchema,
@@ -141,8 +152,9 @@ export const ClientSchemas = {
   UpdateClientRequest: UpdateClientRequestSchema
 }
 
-export type ClientStatus = z.infer<typeof ClientStatusSchema>
-export type ClientIdParams = z.infer<typeof ClientIdParamsSchema>
+export type ClientStatus = z.infer<typeof ClientStatusSchema>
+export type ClientSource = z.infer<typeof ClientSourceSchema>
+export type ClientIdParams = z.infer<typeof ClientIdParamsSchema>
 export type ListClientsQuery = z.infer<typeof ListClientsQuerySchema>
 export type ClientRef = z.infer<typeof ClientRefSchema>
 export type ClientResponse = z.infer<typeof ClientResponseSchema>

package/src/integrations/credentials/index.ts

@@ -26,7 +26,6 @@ export {
 export type { CredentialSchema, CredentialField } from './schemas'
 
 export { buildCredentialValue, extractFormValues } from './utils'
-
-// API validation schemas
-export * from './api-schemas'
-export { CredentialSchemas } from './api-schemas'
+
+// API validation schemas
+export * from './api-schemas'

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

@@ -0,0 +1,146 @@
+import { describe, expect, it } from 'vitest'
+import { buildOmCrossRefIndex, getClientProfile, getClientProfileBySlug, listClientProfiles } from '..'
+import { buildOrganizationGraph } from '../graph/build'
+import { OrganizationModelSchema } from '../schema'
+import { resolveOrganizationModel } from '../resolve'
+
+const CLIENT_ID = '11111111-1111-4111-8111-111111111111'
+
+function makeClientProfile(overrides: Record<string, unknown> = {}) {
+  return {
+    id: CLIENT_ID,
+    slug: 'byron-for-irvine',
+    name: 'Byron for Irvine',
+    status: 'onboarding',
+    source: 'word_of_mouth',
+    identity: {
+      organizationName: 'Byron for Irvine',
+      shortName: 'Byron',
+      clientBrief: 'Irvine City Council District 5 campaign client.',
+      geographicFocus: ['Irvine, CA'],
+      timeZone: 'America/Los_Angeles'
+    },
+    branding: {
+      voice: 'Direct and civic-minded',
+      tagline: 'Byron for Irvine',
+      values: ['Trust', 'Service']
+    },
+    workspace: {
+      kind: 'external-project',
+      owner: 'developer',
+      projectId: 'developer-owned-project-or-slug'
+    },
+    links: {
+      projectIds: ['22222222-2222-4222-8222-222222222222']
+    },
+    prompts: {
+      defaultContext: 'Campaign context.'
+    },
+    config: {
+      campaignSlug: 'byron-for-irvine'
+    },
+    customValues: {
+      tenantOwned: false
+    },
+    ...overrides
+  }
+}
+
+describe('client profile domain', () => {
+  it('parses top-level clients keyed by canonical public.clients.id', () => {
+    const model = resolveOrganizationModel({
+      clients: {
+        [CLIENT_ID]: makeClientProfile()
+      }
+    })
+
+    expect(model.clients[CLIENT_ID]).toMatchObject({
+      id: CLIENT_ID,
+      slug: 'byron-for-irvine',
+      name: 'Byron for Irvine',
+      source: 'word_of_mouth'
+    })
+    expect(model.clients[CLIENT_ID].identity.geographicFocus).toEqual(['Irvine, CA'])
+    expect(model.clients[CLIENT_ID].customValues.tenantOwned).toBe(false)
+  })
+
+  it('rejects a client profile whose id does not match its map key', () => {
+    const result = OrganizationModelSchema.safeParse({
+      clients: {
+        [CLIENT_ID]: makeClientProfile({ id: '33333333-3333-4333-8333-333333333333' })
+      }
+    })
+
+    expect(result.success).toBe(false)
+    if (!result.success) {
+      expect(result.error.issues.some((issue) => issue.message.includes('Each client profile id must match'))).toBe(
+        true
+      )
+    }
+  })
+
+  it('rejects alternate OM link fields on client profiles', () => {
+    const result = OrganizationModelSchema.safeParse({
+      clients: {
+        [CLIENT_ID]: makeClientProfile({ om_client_id: 'byron' })
+      }
+    })
+
+    expect(result.success).toBe(false)
+  })
+
+  it('projects helper lookups by id and slug', () => {
+    const model = resolveOrganizationModel({
+      clients: {
+        [CLIENT_ID]: makeClientProfile()
+      }
+    })
+
+    expect(getClientProfile(model, CLIENT_ID)?.slug).toBe('byron-for-irvine')
+    expect(getClientProfileBySlug(model, 'byron-for-irvine')?.id).toBe(CLIENT_ID)
+    expect(listClientProfiles(model).map((client) => client.id)).toEqual([CLIENT_ID])
+  })
+
+  it('indexes client profiles as knowledge targets', () => {
+    const model = resolveOrganizationModel({
+      clients: {
+        [CLIENT_ID]: makeClientProfile()
+      },
+      knowledge: {
+        'knowledge.byron-client-context': {
+          id: 'knowledge.byron-client-context',
+          kind: 'reference',
+          title: 'Byron Client Context',
+          summary: 'Client profile context for Byron for Irvine.',
+          body: '## Context\n\nByron campaign client context.',
+          links: [{ target: { kind: 'client', id: CLIENT_ID } }],
+          ownerIds: [],
+          updatedAt: '2026-05-30'
+        }
+      }
+    })
+    const index = buildOmCrossRefIndex(model)
+
+    expect(index.clientIds.has(CLIENT_ID)).toBe(true)
+    expect(model.knowledge['knowledge.byron-client-context'].links[0].nodeId).toBe(`client:${CLIENT_ID}`)
+  })
+
+  it('projects client profiles into the organization graph', () => {
+    const model = resolveOrganizationModel({
+      clients: {
+        [CLIENT_ID]: makeClientProfile()
+      }
+    })
+    const graph = buildOrganizationGraph({ organizationModel: model })
+
+    expect(graph.nodes.find((node) => node.id === `client:${CLIENT_ID}`)).toMatchObject({
+      kind: 'client',
+      sourceId: CLIENT_ID,
+      label: 'Byron for Irvine',
+      description: 'Irvine City Council District 5 campaign client.'
+    })
+    expect(
+      graph.edges.find((edge) => edge.sourceId === 'organization-model' && edge.targetId === `client:${CLIENT_ID}`)
+    ).toMatchObject({ kind: 'contains' })
+  })
+})

package/src/organization-model/contracts.ts

@@ -1,27 +1,27 @@
-export const KNOWLEDGE_FEATURE_ID = 'knowledge' as const
-export const KNOWLEDGE_SYSTEM_ID = 'knowledge' as const
-
-export const PROJECTS_SYSTEM_ID = 'projects' as const
-/** @deprecated Use PROJECTS_SYSTEM_ID. Scheduled for removal after one publish cycle. */
-export const PROJECTS_FEATURE_ID = PROJECTS_SYSTEM_ID
-export const PROJECTS_INDEX_SURFACE_ID = 'projects.index' as const
-export const PROJECTS_VIEW_ACTION_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 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_SYSTEM_ID = 'sales.crm' as const
-export const PROSPECTING_SYSTEM_ID = 'sales.lead-gen' as const
-export const OPERATIONS_SYSTEM_ID = 'operations' as const
-/** @deprecated Use OPERATIONS_SYSTEM_ID. Scheduled for removal after one publish cycle. */
-export const OPERATIONS_FEATURE_ID = OPERATIONS_SYSTEM_ID
-export const MONITORING_SYSTEM_ID = 'monitoring' as const
-export const SETTINGS_SYSTEM_ID = 'settings' as const
-export const SEO_SYSTEM_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_COMMAND_VIEW_SURFACE_ID = 'knowledge.command-view' as const
-export const SETTINGS_ROLES_SURFACE_ID = 'settings.roles' as const
+export const KNOWLEDGE_FEATURE_ID = 'knowledge' as const
+export const KNOWLEDGE_SYSTEM_ID = 'knowledge' as const
+
+export const PROJECTS_SYSTEM_ID = 'platform.projects' as const
+/** @deprecated Use PROJECTS_SYSTEM_ID. Scheduled for removal after one publish cycle. */
+export const PROJECTS_FEATURE_ID = PROJECTS_SYSTEM_ID
+export const PROJECTS_INDEX_SURFACE_ID = 'platform.projects.index' as const
+export const PROJECTS_VIEW_ACTION_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 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_SYSTEM_ID = 'sales.crm' as const
+export const PROSPECTING_SYSTEM_ID = 'sales.lead-gen' as const
+export const OPERATIONS_SYSTEM_ID = 'operations' as const
+/** @deprecated Use OPERATIONS_SYSTEM_ID. Scheduled for removal after one publish cycle. */
+export const OPERATIONS_FEATURE_ID = OPERATIONS_SYSTEM_ID
+export const MONITORING_SYSTEM_ID = 'monitoring' as const
+export const SETTINGS_SYSTEM_ID = 'settings' as const
+export const SEO_SYSTEM_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_COMMAND_VIEW_SURFACE_ID = 'knowledge.command-view' as const
+export const SETTINGS_ROLES_SURFACE_ID = 'settings.roles' as const

package/src/organization-model/cross-ref.ts

@@ -55,6 +55,7 @@ export interface OmCrossRefIndex {
    */
   systemsById: Map<string, unknown>
   resourceIds: Set<string>
+  clientIds: Set<string>
   knowledgeIds: Set<string>
   roleIds: Set<string>
   goalIds: Set<string>
@@ -82,6 +83,7 @@ export function buildOmCrossRefIndex(model: OrganizationModel): OmCrossRefIndex
   }
 
   const resourceIds = new Set(Object.keys(model.resources ?? {}))
+  const clientIds = new Set(Object.keys(model.clients ?? {}))
   const knowledgeIds = new Set(Object.keys(model.knowledge ?? {}))
   const roleIds = new Set(Object.keys(model.roles ?? {}))
   const goalIds = new Set(Object.keys(model.goals ?? {}))
@@ -121,6 +123,7 @@ export function buildOmCrossRefIndex(model: OrganizationModel): OmCrossRefIndex
   return {
     systemsById,
     resourceIds,
+    clientIds,
     knowledgeIds,
     roleIds,
     goalIds,
@@ -147,6 +150,7 @@ export function buildOmCrossRefIndex(model: OrganizationModel): OmCrossRefIndex
  */
 export function knowledgeTargetExists(index: OmCrossRefIndex, kind: string, id: string): boolean {
   if (kind === 'system') return index.systemsById.has(id)
+  if (kind === 'client') return index.clientIds.has(id)
   if (kind === 'resource') return index.resourceIds.has(id)
   if (kind === 'knowledge') return index.knowledgeIds.has(id)
   if (kind === 'stage') return index.stageIds.has(id)

package/src/organization-model/defaults.ts

@@ -23,7 +23,7 @@ import { DEFAULT_ORGANIZATION_MODEL_GOALS } from './domains/goals'
 import { DEFAULT_ORGANIZATION_MODEL_RESOURCES } from './domains/resources'
 import { DEFAULT_ORGANIZATION_MODEL_TOPOLOGY } from './domains/topology'
 import { DEFAULT_ORGANIZATION_MODEL_POLICIES } from './domains/policies'
-import { DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA } from './schema'
+import { DEFAULT_ORGANIZATION_MODEL_CLIENTS, DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA } from './schema'
 import { DEFAULT_ONTOLOGY_SCOPE } from './ontology'
 import type { OrganizationModelNavigation } from './types'
 
@@ -32,7 +32,6 @@ import type { OrganizationModelNavigation } from './types'
 export const DEFAULT_ORGANIZATION_MODEL_KNOWLEDGE = {} as const
 
 export const DEFAULT_ORGANIZATION_MODEL_ENTITIES = {}
-
 const DEFAULT_ORGANIZATION_MODEL_NAVIGATION: OrganizationModelNavigation = {
   sidebar: {
     primary: {},
@@ -47,6 +46,7 @@ export const DEFAULT_ORGANIZATION_MODEL: OrganizationModel = {
   branding: DEFAULT_ORGANIZATION_MODEL_BRANDING,
   navigation: DEFAULT_ORGANIZATION_MODEL_NAVIGATION,
   identity: DEFAULT_ORGANIZATION_MODEL_IDENTITY,
+  clients: DEFAULT_ORGANIZATION_MODEL_CLIENTS,
   customers: DEFAULT_ORGANIZATION_MODEL_CUSTOMERS,
   offerings: DEFAULT_ORGANIZATION_MODEL_OFFERINGS,
   roles: DEFAULT_ORGANIZATION_MODEL_ROLES,

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

@@ -14,6 +14,7 @@ import { defineDomainRecord } from '../helpers'
 export const KnowledgeTargetKindSchema = z
   .enum([
     'system',
+    'client',
     'resource',
     'knowledge',
     'stage',

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

@@ -281,16 +281,33 @@ export function buildOrganizationGraph(input: BuildOrganizationGraphInput): Orga
     label: 'Organization Model'
   }
   pushUniqueNode(nodes, nodeIds, organizationNode)
-  const systemsWithPaths = listAllSystems(organizationModel)
-  const systemPathByRef = new Map<string, string>()
+  const systemsWithPaths = listAllSystems(organizationModel)
+  const systemPathByRef = new Map<string, string>()
   for (const { path, system } of systemsWithPaths) {
     systemPathByRef.set(path, path)
     systemPathByRef.set(system.id, path)
   }
-  const validSystemRefs = new Set(systemPathByRef.keys())
-  const systemNodeId = (systemRef: string) => nodeId('system', systemPathByRef.get(systemRef) ?? systemRef)
-
-  function topologyNodeId(ref: OmTopologyNodeRef): string {
+  const validSystemRefs = new Set(systemPathByRef.keys())
+  const systemNodeId = (systemRef: string) => nodeId('system', systemPathByRef.get(systemRef) ?? systemRef)
+
+  for (const client of Object.values(organizationModel.clients).sort((a, b) => a.slug.localeCompare(b.slug))) {
+    const id = nodeId('client', client.id)
+    pushUniqueNode(nodes, nodeIds, {
+      id,
+      kind: 'client',
+      label: client.name,
+      sourceId: client.id,
+      description: client.identity.clientBrief || undefined
+    })
+    pushUniqueEdge(edges, edgeIds, {
+      id: edgeId('contains', organizationNode.id, id),
+      kind: 'contains',
+      sourceId: organizationNode.id,
+      targetId: id
+    })
+  }
+
+  function topologyNodeId(ref: OmTopologyNodeRef): string {
     if (ref.kind === 'system') return systemNodeId(ref.id)
     if (ref.kind === 'resource') return nodeId('resource', ref.id)
     if (ref.kind === 'ontology') return ontologyGraphNodeId(ref.id)

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

@@ -3,9 +3,10 @@ import { DescriptionSchema, IconNameSchema, LabelSchema } from '../domains/share
 import { OrganizationModelSchema } from '../schema'
 
 export const OrganizationGraphNodeKindSchema = z.enum([
-  'organization',
-  'system',
-  'role',
+  'organization',
+  'system',
+  'client',
+  'role',
   'action',
   'entity',
   'event',

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

@@ -4,9 +4,10 @@ import type { RelationshipType } from '../../platform/registry/command-view'
 import type { OrganizationModelIconToken } from '../icons'
 
 export type OrganizationGraphNodeKind =
-  | 'organization'
-  | 'system'
-  | 'role'
+  | 'organization'
+  | 'system'
+  | 'client'
+  | 'role'
   | 'action'
   | 'entity'
   | 'event'

package/src/organization-model/helpers.ts

@@ -62,6 +62,21 @@ export function listDomain<T extends { id: string; order: number }>(record: Reco
   return Object.values(record).sort((a, b) => a.order - b.order)
 }
 
+export function listClientProfiles(model: OrganizationModel): OrganizationModel['clients'][string][] {
+  return Object.values(model.clients ?? {}).sort((a, b) => a.slug.localeCompare(b.slug))
+}
+
+export function getClientProfile(model: OrganizationModel, id: string): OrganizationModel['clients'][string] | undefined {
+  return model.clients?.[id]
+}
+
+export function getClientProfileBySlug(
+  model: OrganizationModel,
+  slug: string
+): OrganizationModel['clients'][string] | undefined {
+  return Object.values(model.clients ?? {}).find((client) => client.slug === slug)
+}
+
 export function findById(
   systems: Record<string, OrganizationModelSystemEntry>,
   id: string

package/src/organization-model/published.ts

@@ -24,6 +24,15 @@ export {
 } from './ontology'
 export {
   DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA,
+  ClientProfileBrandingSchema,
+  ClientProfileIdentitySchema,
+  ClientProfileLinksSchema,
+  ClientProfilePromptsSchema,
+  ClientProfileSchema,
+  ClientProfileSourceSchema,
+  ClientProfileStatusSchema,
+  ClientProfileWorkspaceSchema,
+  ClientProfilesDomainSchema,
   OrganizationModelDomainKeySchema,
   OrganizationModelDomainMetadataByDomainSchema,
   OrganizationModelDomainMetadataSchema,
@@ -237,7 +246,7 @@ export { defineOrganizationModel, resolveOrganizationModel, resolveOrganizationM
 export type { ResolvedSystemEntry, ResolvedOrganizationModel } from './resolve'
 export { createFoundationOrganizationModel } from './foundation'
 export { scaffoldOrganizationModel } from './scaffolders'
-export { defineDomainRecord, listAllSystems } from './helpers'
+export { defineDomainRecord, getClientProfile, getClientProfileBySlug, listAllSystems, listClientProfiles } from './helpers'
 export { projectOrganizationSurfaces, validateOrganizationSurfaceProjection } from './surface-projection'
 export type {
   BaseOmScaffoldSpec,
@@ -283,11 +292,20 @@ export type {
 
 export type {
   DeepPartial,
+  ClientProfile,
+  ClientProfileBranding,
+  ClientProfileIdentity,
+  ClientProfileLinks,
+  ClientProfilePrompts,
+  ClientProfileSource,
+  ClientProfileStatus,
+  ClientProfileWorkspace,
   KnowledgeLink,
   KnowledgeTargetKind,
   KnowledgeTargetRef,
   OrganizationModel,
   OrganizationModelBranding,
+  OrganizationModelClients,
   OrganizationModelCustomerFirmographics,
   OrganizationModelCustomers,
   OrganizationModelCustomerSegment,