@elevasis/core 0.39.0 → 0.41.0

package/src/business/acquisition/ontology-validation.ts

@@ -15,10 +15,7 @@ import {
   SYSTEM_INTERFACE_READINESS_PROFILES
 } from '../../organization-model/domains/systems'
 import type { OmTopologyRelationship } from '../../organization-model/domains/topology'
-import {
-  type LeadGenStageCatalogEntry,
-  type StatefulStateDefinition
-} from '../../organization-model/domains/sales'
+import { type LeadGenStageCatalogEntry, type StatefulStateDefinition } from '../../organization-model/domains/sales'
 import { getSystem } from '../../organization-model/helpers'
 import { getLeadGenStageCatalog } from '../../organization-model/migration-helpers'
 
@@ -107,6 +104,11 @@ export type SystemInterfaceReadinessIssueFamily =
   | 'SYSTEM_INTERFACE_INVALID'
   | 'SYSTEM_INTERFACE_NOT_READY'
   | 'SYSTEM_BRIDGE_NOT_READY'
+  /**
+   * The deployed OM snapshot hash does not match the canonical source hash.
+   * Redeploy with `pnpm operations:deploy` to refresh the snapshot.
+   */
+  | 'STALE_OM_SNAPSHOT'
 
 export interface SystemInterfaceReadinessIssue {
   family: SystemInterfaceReadinessIssueFamily
@@ -266,7 +268,10 @@ function getActiveScopedResources(
   return resources
 }
 
-function resourceBindingIds(resources: ResourceEntry[], key: 'reads' | 'writes' | 'usesCatalogs' | 'actions' | 'emits'): Set<string> {
+function resourceBindingIds(
+  resources: ResourceEntry[],
+  key: 'reads' | 'writes' | 'usesCatalogs' | 'actions' | 'emits'
+): Set<string> {
   return new Set(resources.flatMap((resource) => resource.ontology?.[key] ?? []))
 }
 
@@ -288,7 +293,11 @@ function requireScopedBinding(
   )
 }
 
-function ontologyOwnerMatches(ontologyId: string, expectedSystemPath: string, catalog: OntologyCatalogType | undefined): boolean {
+function ontologyOwnerMatches(
+  ontologyId: string,
+  expectedSystemPath: string,
+  catalog: OntologyCatalogType | undefined
+): boolean {
   if (catalog?.ownerSystemId !== undefined) return catalog.ownerSystemId === expectedSystemPath
   return parseOntologyId(ontologyId).scope === expectedSystemPath
 }
@@ -579,7 +588,13 @@ export function computeInterfaceReadiness(
       `System "${request.systemPath}" is missing.`,
       { ref: request.systemPath }
     )
-    return { ready: false, systemPath: request.systemPath, interfaceKey: request.interfaceKey, scopedResourceIds, issues }
+    return {
+      ready: false,
+      systemPath: request.systemPath,
+      interfaceKey: request.interfaceKey,
+      scopedResourceIds,
+      issues
+    }
   }
 
   if (systemInterface === undefined) {
@@ -590,7 +605,13 @@ export function computeInterfaceReadiness(
       `System "${request.systemPath}" does not declare interface "${request.interfaceKey}".`,
       { path: readinessMarkerPath(request) }
     )
-    return { ready: false, systemPath: request.systemPath, interfaceKey: request.interfaceKey, scopedResourceIds, issues }
+    return {
+      ready: false,
+      systemPath: request.systemPath,
+      interfaceKey: request.interfaceKey,
+      scopedResourceIds,
+      issues
+    }
   }
 
   if (systemInterface.lifecycle !== 'active') {
@@ -604,7 +625,8 @@ export function computeInterfaceReadiness(
   }
 
   const supportedProfile =
-    readinessProfile !== undefined && SYSTEM_INTERFACE_PROFILES.some((profile) => profile.readinessProfile === readinessProfile)
+    readinessProfile !== undefined &&
+    SYSTEM_INTERFACE_PROFILES.some((profile) => profile.readinessProfile === readinessProfile)
 
   if (!supportedProfile) {
     addReadinessIssue(

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/knowledge/index.ts

@@ -1,4 +1,17 @@
-export { bySystem, byOntology, byKind, byOwner, governs, governedBy, parsePath, omSearch, omDescribe } from './queries'
+export {
+  bySystem,
+  byOntology,
+  byKind,
+  byOwner,
+  governs,
+  governedBy,
+  parsePath,
+  omSearch,
+  omDescribe,
+  listAllSystemsFlat,
+  listAllResources,
+  listAllRoles
+} from './queries'
 export type {
   KnowledgeMount,
   ParsedKnowledgePath,

package/src/knowledge/queries.ts

@@ -217,12 +217,54 @@ export function governedBy(graph: OrganizationGraph, nodeId: string): string[] {
   return results
 }
 
+// ---------------------------------------------------------------------------
+// Enumeration helpers (Bucket 4: /all-* mounts)
+// ---------------------------------------------------------------------------
+
+/**
+ * Returns all systems flattened from the recursive OM tree via `listAllSystems`.
+ *
+ * Each entry is `{ path, system }` — the same shape produced by `listAllSystems`.
+ *
+ * @param model - The resolved OrganizationModel.
+ */
+export function listAllSystemsFlat(model: OrganizationModel): ReturnType<typeof listAllSystems> {
+  return listAllSystems(model)
+}
+
+/**
+ * Returns every resource from the model as a flat array, sorted by id.
+ *
+ * @param model - The resolved OrganizationModel.
+ */
+export function listAllResources(model: OrganizationModel): NonNullable<OrganizationModel['resources']>[string][] {
+  return Object.values(model.resources ?? {}).sort((a, b) => a.id.localeCompare(b.id))
+}
+
+/**
+ * Returns every role from the model as a flat array, sorted by id.
+ *
+ * @param model - The resolved OrganizationModel.
+ */
+export function listAllRoles(model: OrganizationModel): NonNullable<OrganizationModel['roles']>[string][] {
+  return Object.values(model.roles ?? {}).sort((a, b) => a.id.localeCompare(b.id))
+}
+
 // ---------------------------------------------------------------------------
 // Path parser
 // ---------------------------------------------------------------------------
 
 /** The recognized mount axes for Knowledge Map paths. */
-export type KnowledgeMount = 'by-system' | 'by-ontology' | 'by-kind' | 'by-owner' | 'graph' | 'node'
+export type KnowledgeMount =
+  | 'by-system'
+  | 'by-ontology'
+  | 'by-kind'
+  | 'by-owner'
+  | 'graph'
+  | 'node'
+  | 'all-systems'
+  | 'all-resources'
+  | 'all-roles'
 
 /**
  * The result of parsing a Knowledge Map path string.
@@ -230,12 +272,15 @@ export type KnowledgeMount = 'by-system' | 'by-ontology' | 'by-kind' | 'by-owner
  * Shape: `{ mount: KnowledgeMount, args: string[] }`
  *
  * Per-mount arg arrays:
- * - `by-system`:  `[systemId]`   (e.g. `['sales.crm']`)
- * - `by-ontology`:`[ontologyId]` (e.g. `['sales.crm:object/deal']`)
- * - `by-kind`:    `[kind]`       (e.g. `['playbook']`)
- * - `by-owner`:   `[ownerId]`    (e.g. `['role.ops-lead']`)
- * - `graph`:      `[nodeId, verb]` where verb is `'governs'` or `'governed-by'`
- * - `node`:       `[nodeId]`     (single node lookup, no sub-path)
+ * - `by-system`:    `[systemId]`   (e.g. `['sales.crm']`)
+ * - `by-ontology`:  `[ontologyId]` (e.g. `['sales.crm:object/deal']`)
+ * - `by-kind`:      `[kind]`       (e.g. `['playbook']`)
+ * - `by-owner`:     `[ownerId]`    (e.g. `['role.ops-lead']`)
+ * - `graph`:        `[nodeId, verb]` where verb is `'governs'` or `'governed-by'`
+ * - `node`:         `[nodeId]`     (single node lookup, no sub-path)
+ * - `all-systems`:  `[]`           (no args — returns all systems flattened)
+ * - `all-resources`:`[]`           (no args — returns all resources)
+ * - `all-roles`:    `[]`           (no args — returns all roles)
  */
 export interface ParsedKnowledgePath {
   mount: KnowledgeMount
@@ -246,13 +291,16 @@ export interface ParsedKnowledgePath {
  * Parses a Knowledge Map path string into a `{ mount, args }` descriptor.
  *
  * Supported path patterns:
- *   `/by-system/<systemId>`           -> `{ mount: 'by-system', args: ['<systemId>'] }`
- *   `/by-ontology/<ontologyId>`       -> `{ mount: 'by-ontology', args: ['<ontologyId>'] }`
- *   `/by-kind/<kind>`                 → `{ mount: 'by-kind',    args: ['<kind>'] }`
- *   `/by-owner/<ownerId>`             → `{ mount: 'by-owner',   args: ['<ownerId>'] }`
- *   `/graph/<nodeId>/governs`         → `{ mount: 'graph',      args: ['<nodeId>', 'governs'] }`
- *   `/graph/<nodeId>/governed-by`     → `{ mount: 'graph',      args: ['<nodeId>', 'governed-by'] }`
- *   `/<nodeId>`                       → `{ mount: 'node',       args: ['<nodeId>'] }`
+ *   `/by-system/<systemId>`           -> `{ mount: ‘by-system’,    args: [‘<systemId>’] }`
+ *   `/by-ontology/<ontologyId>`       -> `{ mount: ‘by-ontology’,  args: [‘<ontologyId>’] }`
+ *   `/by-kind/<kind>`                 -> `{ mount: ‘by-kind’,      args: [‘<kind>’] }`
+ *   `/by-owner/<ownerId>`             -> `{ mount: ‘by-owner’,     args: [‘<ownerId>’] }`
+ *   `/graph/<nodeId>/governs`         -> `{ mount: ‘graph’,        args: [‘<nodeId>’, ‘governs’] }`
+ *   `/graph/<nodeId>/governed-by`     -> `{ mount: ‘graph’,        args: [‘<nodeId>’, ‘governed-by’] }`
+ *   `/<nodeId>`                       -> `{ mount: ‘node’,         args: [‘<nodeId>’] }`
+ *   `/all-systems`                    -> `{ mount: ‘all-systems’,  args: [] }`
+ *   `/all-resources`                  -> `{ mount: ‘all-resources’,args: [] }`
+ *   `/all-roles`                      -> `{ mount: ‘all-roles’,    args: [] }`
  *
  * The path MUST start with `/`.  Trailing slashes are stripped before parsing.
  *
@@ -325,6 +373,17 @@ export function parsePath(pathString: string): ParsedKnowledgePath {
     return { mount: 'graph', args: [graphNodeId, verb] }
   }
 
+  // /all-systems  /all-resources  /all-roles  (no-arg enumeration mounts)
+  if (first === 'all-systems' && rest.length === 0) {
+    return { mount: 'all-systems', args: [] }
+  }
+  if (first === 'all-resources' && rest.length === 0) {
+    return { mount: 'all-resources', args: [] }
+  }
+  if (first === 'all-roles' && rest.length === 0) {
+    return { mount: 'all-roles', args: [] }
+  }
+
   // /<nodeId>  (single node)
   // first must not be a recognized mount prefix
   if (segments.length === 1) {
@@ -332,7 +391,7 @@ export function parsePath(pathString: string): ParsedKnowledgePath {
   }
 
   throw new Error(
-    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-system/<id>, /by-kind/<kind>, /by-owner/<id>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>`
+    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-system/<id>, /by-kind/<kind>, /by-owner/<id>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>, /all-systems, /all-resources, /all-roles`
   )
 }
 

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' })
+  })
+})