@elevasis/core 0.24.1 → 0.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/core",
-  "version": "0.24.1",
+  "version": "0.26.0",
   "license": "MIT",
   "description": "Minimal shared constants across Elevasis monorepo",
   "sideEffects": false,

package/src/_gen/__tests__/__snapshots__/contracts.md.snap

@@ -306,7 +306,7 @@ export type OrganizationModelSystemLifecycle = z.infer<typeof SystemLifecycleSch
 ### `OrganizationModelSystemStatus`
 
 ```typescript
-/** @deprecated Use OrganizationModelSystemLifecycle. Accepted for one publish cycle. */
+/** @deprecated Use OrganizationModelSystemLifecycle. Accepted for one publish cycle. */
 export type OrganizationModelSystemStatus = z.infer<typeof SystemStatusSchema>
 ```
 
@@ -376,6 +376,18 @@ export type OrganizationModelResourceGovernanceStatus = z.infer<typeof ResourceG
 export type OrganizationModelResourceOntologyBinding = z.infer<typeof ResourceOntologyBindingSchema>
 ```
 
+### `OrganizationModelContractRef`
+
+```typescript
+export type OrganizationModelContractRef = z.infer<typeof ContractRefSchema>
+```
+
+### `OrganizationModelResourceOntologyBindingContract`
+
+```typescript
+export type OrganizationModelResourceOntologyBindingContract = ResourceOntologyBindingContract
+```
+
 ### `OrganizationModelAgentKind`
 
 ```typescript
@@ -625,7 +637,7 @@ export type OrganizationModelBuiltinIconToken = z.infer<typeof OrganizationModel
 ### `DeepPartial`
 
 ```typescript
-export type DeepPartial<T> =
+export type DeepPartial<T> =
   T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T
 ```
 
@@ -634,8 +646,8 @@ export type DeepPartial<T> =
 ### `ElevasisOrganizationModel`
 
 ```typescript
-export type ElevasisOrganizationModel = Omit<OrganizationModel, 'knowledge'> & {
-  knowledge?: OrganizationModel['knowledge']
+export type ElevasisOrganizationModel = Omit<OrganizationModel, 'knowledge'> & {
+  knowledge?: OrganizationModel['knowledge']
 }
 ```
 
@@ -660,107 +672,107 @@ export type SystemSidebarWidthResolver = number | ((context: { currentPath: stri
 ### `SystemModule`
 
 ```typescript
-export interface SystemModule {
-  /** Unique stable identifier for this UI system module. */
-  key: string
-  /** Organization Model system id this module presents. Omit for navigation-only app surfaces. */
-  systemId?: string
-  /** Route prefixes owned by navigation-only app surfaces. */
-  routePrefixes?: string[]
-  /** Capability identifiers contributed by this system module. */
-  capabilityIds?: string[]
-  /** Icon used when this system node appears in shell navigation. */
-  icon?: SystemIconComponent
-  /** Sidebar component rendered when this system's subtree route is active. */
-  sidebar?: SystemSidebarComponent
-  /** Optional shell sidebar width override. Defaults to 250px. */
-  sidebarWidth?: SystemSidebarWidthResolver
-  /** Operations-only bridge connecting this system to the organization graph node. */
-  organizationGraph?: OrganizationGraphSystemBridge
+export interface SystemModule {
+  /** Unique stable identifier for this UI system module. */
+  key: string
+  /** Organization Model system id this module presents. Omit for navigation-only app surfaces. */
+  systemId?: string
+  /** Route prefixes owned by navigation-only app surfaces. */
+  routePrefixes?: string[]
+  /** Capability identifiers contributed by this system module. */
+  capabilityIds?: string[]
+  /** Icon used when this system node appears in shell navigation. */
+  icon?: SystemIconComponent
+  /** Sidebar component rendered when this system's subtree route is active. */
+  sidebar?: SystemSidebarComponent
+  /** Optional shell sidebar width override. Defaults to 250px. */
+  sidebarWidth?: SystemSidebarWidthResolver
+  /** Operations-only bridge connecting this system to the organization graph node. */
+  organizationGraph?: OrganizationGraphSystemBridge
 }
 ```
 
 ### `ResolvedSystemAccess`
 
 ```typescript
-export interface ResolvedSystemAccess {
-  featureKey: string
-  systemId?: string
-  enabled: boolean
+export interface ResolvedSystemAccess {
+  systemKey: string
+  systemId?: string
+  enabled: boolean
 }
 ```
 
 ### `ResolvedSystemSemantics`
 
 ```typescript
-export interface ResolvedSystemSemantics {
-  capabilityIds: string[]
+export interface ResolvedSystemSemantics {
+  capabilityIds: string[]
 }
 ```
 
 ### `ResolvedSystemModule`
 
 ```typescript
-export interface ResolvedSystemModule extends SystemModule {
-  access: ResolvedSystemAccess
-  semantics: ResolvedSystemSemantics
+export interface ResolvedSystemModule extends SystemModule {
+  access: ResolvedSystemAccess
+  semantics: ResolvedSystemSemantics
 }
 ```
 
 ### `ResolvedShellSystem`
 
 ```typescript
-export type ResolvedShellSystem = OrganizationModelSystemEntry & {
-  label: string
-  iconComponent?: SystemIconComponent
+export type ResolvedShellSystem = OrganizationModelSystemEntry & {
+  label: string
+  iconComponent?: SystemIconComponent
 }
 ```
 
 ### `ResolvedShellModel`
 
 ```typescript
-export interface ResolvedShellModel {
-  systems: readonly ResolvedShellSystem[]
-  findByPath: (path: string) => ResolvedShellSystem | undefined
-  findById: (id: string) => ResolvedShellSystem | undefined
-  childrenOf: (id: string) => ResolvedShellSystem[]
-  ancestorsOf: (id: string) => ResolvedShellSystem[]
-  parentOf: (id: string) => ResolvedShellSystem | undefined
-  topLevel: () => ResolvedShellSystem[]
-  requiresAdminFor: (id: string) => boolean
-  devOnlyFor: (id: string) => boolean
+export interface ResolvedShellModel {
+  systems: readonly ResolvedShellSystem[]
+  findByPath: (path: string) => ResolvedShellSystem | undefined
+  findById: (id: string) => ResolvedShellSystem | undefined
+  childrenOf: (id: string) => ResolvedShellSystem[]
+  ancestorsOf: (id: string) => ResolvedShellSystem[]
+  parentOf: (id: string) => ResolvedShellSystem | undefined
+  topLevel: () => ResolvedShellSystem[]
+  requiresAdminFor: (id: string) => boolean
+  devOnlyFor: (id: string) => boolean
 }
 ```
 
 ### `ShellSidebarLinkItem`
 
 ```typescript
-export interface ShellSidebarLinkItem {
-  label: string
-  link: string
-  exact?: boolean
-  activeMatchPaths?: string[]
+export interface ShellSidebarLinkItem {
+  label: string
+  link: string
+  exact?: boolean
+  activeMatchPaths?: string[]
 }
 ```
 
 ### `ShellSidebarLinkGroup`
 
 ```typescript
-export interface ShellSidebarLinkGroup {
-  icon: SystemIconComponent
-  label: string
-  links?: ShellSidebarLinkItem[]
-  link?: string
+export interface ShellSidebarLinkGroup {
+  icon: SystemIconComponent
+  label: string
+  links?: ShellSidebarLinkItem[]
+  link?: string
 }
 ```
 
 ### `ShellSidebarProjectionOptions`
 
 ```typescript
-export interface ShellSidebarProjectionOptions {
-  isPlatformAdmin?: boolean
-  isDev?: boolean
-  section?: 'primary' | 'bottom'
+export interface ShellSidebarProjectionOptions {
+  isPlatformAdmin?: boolean
+  isDev?: boolean
+  section?: 'primary' | 'bottom'
 }
 ```
 
@@ -773,75 +785,75 @@ export type ShellRouteMatchStatus = 'matched' | 'hidden' | 'unmatched'
 ### `ResolvedShellRouteMatch`
 
 ```typescript
-export interface ResolvedShellRouteMatch {
-  status: ShellRouteMatchStatus
-  path: string
-  system?: ResolvedSystemModule
-  node?: ResolvedShellSystem
+export interface ResolvedShellRouteMatch {
+  status: ShellRouteMatchStatus
+  path: string
+  system?: ResolvedSystemModule
+  node?: ResolvedShellSystem
 }
 ```
 
 ### `ShellRuntime`
 
 ```typescript
-export interface ShellRuntime {
-  resolveRoute: (path: string) => ResolvedShellRouteMatch
+export interface ShellRuntime {
+  resolveRoute: (path: string) => ResolvedShellRouteMatch
 }
 ```
 
 ### `OrganizationGraphSystemBridge`
 
 ```typescript
-export interface OrganizationGraphSystemBridge {
-  systemId?: string
+export interface OrganizationGraphSystemBridge {
+  systemId?: string
 }
 ```
 
 ### `OrganizationGraphContextValue`
 
 ```typescript
-export interface OrganizationGraphContextValue {
-  available: boolean
-  systemId?: string
-  systemPath?: string
+export interface OrganizationGraphContextValue {
+  available: boolean
+  systemId?: string
+  systemPath?: string
 }
 ```
 
 ### `ElevasisSystemsProviderProps`
 
 ```typescript
-export interface ElevasisSystemsProviderProps {
-  systems?: SystemModule[]
-  organizationModel?: ElevasisOrganizationModel
-  timeRange?: TimeRange
-  operationsApiUrl?: string
-  operationsSSEManager?: SSEConnectionManagerLike
-  deliveryApiUrl?: string
-  deliverySSEManager?: SSEConnectionManagerLike
-  disabledSubsectionPaths?: string[]
-  children: ReactNode
+export interface ElevasisSystemsProviderProps {
+  systems?: SystemModule[]
+  organizationModel?: ElevasisOrganizationModel
+  timeRange?: TimeRange
+  operationsApiUrl?: string
+  operationsSSEManager?: SSEConnectionManagerLike
+  deliveryApiUrl?: string
+  deliverySSEManager?: SSEConnectionManagerLike
+  disabledSubsectionPaths?: string[]
+  children: ReactNode
 }
 ```
 
 ### `ElevasisSystemsContextValue`
 
 ```typescript
-export interface ElevasisSystemsContextValue {
-  shellModel: ResolvedShellModel
-  shellRuntime: ShellRuntime
-  getSidebarLinks: (options?: ShellSidebarProjectionOptions) => ShellSidebarLinkGroup[]
-  enabledResolvedSystems: ResolvedSystemModule[]
-  resolvedSystems: ResolvedSystemModule[]
-  organizationGraph: OrganizationGraphContextValue
-  organizationModel?: OrganizationModel
-  timeRange?: TimeRange
-  operationsApiUrl?: string
-  operationsSSEManager?: SSEConnectionManagerLike
-  deliveryApiUrl?: string
-  deliverySSEManager?: SSEConnectionManagerLike
-  disabledSubsectionPaths: string[]
-  isSystemEnabled: (key: string) => boolean
-  getResolvedSystem: (key: string) => ResolvedSystemModule | undefined
+export interface ElevasisSystemsContextValue {
+  shellModel: ResolvedShellModel
+  shellRuntime: ShellRuntime
+  getSidebarLinks: (options?: ShellSidebarProjectionOptions) => ShellSidebarLinkGroup[]
+  enabledResolvedSystems: ResolvedSystemModule[]
+  resolvedSystems: ResolvedSystemModule[]
+  organizationGraph: OrganizationGraphContextValue
+  organizationModel?: OrganizationModel
+  timeRange?: TimeRange
+  operationsApiUrl?: string
+  operationsSSEManager?: SSEConnectionManagerLike
+  deliveryApiUrl?: string
+  deliverySSEManager?: SSEConnectionManagerLike
+  disabledSubsectionPaths: string[]
+  isSystemEnabled: (key: string) => boolean
+  getResolvedSystem: (key: string) => ResolvedSystemModule | undefined
 }
 ```
 

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

@@ -2,8 +2,7 @@ import { describe, expect, it } from 'vitest'
 import {
   CRM_PIPELINE_DEFINITION,
   DEFAULT_CRM_PRIORITY_RULE_CONFIG,
-  LEAD_GEN_PIPELINE_DEFINITIONS,
-  LEAD_GEN_STAGE_CATALOG
+  LEAD_GEN_PIPELINE_DEFINITIONS
 } from '../../organization-model/domains/sales'
 import { CrmPriorityOverrideSchema, evaluateCrmDealPriority, resolveCrmPriorityRuleConfig } from './crm-priority'
 import {
@@ -61,8 +60,7 @@ import {
   CRM_STAGE_KEYS_FROM_ONTOLOGY,
   LEAD_GEN_STAGE_CATALOG_ONTOLOGY_ID,
   LEAD_GEN_STAGE_KEYS_FROM_ONTOLOGY,
-  getLeadGenStageCatalogFromOntology,
-  isLeadGenActionKey
+  getLeadGenStageCatalogFromOntology
 } from './ontology-validation'
 
 // ---------------------------------------------------------------------------
@@ -70,8 +68,10 @@ import {
 // ---------------------------------------------------------------------------
 
 const VALID_UUID = '00000000-0000-4000-8000-000000000001'
-const ISO_TS = '2026-04-27T12:34:56.000Z'
-const PRIORITY = {
+const ISO_TS = '2026-04-27T12:34:56.000Z'
+const VALID_COMPANY_STAGE_KEY = 'qualified'
+const VALID_CONTACT_STAGE_KEY = 'verified'
+const PRIORITY = {
   bucketKey: 'waiting' as const,
   rank: 30,
   label: 'Waiting',
@@ -130,17 +130,14 @@ describe('business ontology validation bridge', () => {
     expect(CrmStageKeySchema.options).toEqual(CRM_STAGE_KEYS_FROM_ONTOLOGY)
   })
 
-  it('keeps lead-gen schema validation aligned to the ontology catalog and legacy stage constant', () => {
-    const legacyStageKeys = Object.keys(LEAD_GEN_STAGE_CATALOG)
-
-    expect(LEAD_GEN_STAGE_KEYS_FROM_ONTOLOGY).toEqual(legacyStageKeys)
-    expect(Object.keys(getLeadGenStageCatalogFromOntology())).toEqual(legacyStageKeys)
+  it('keeps the generic core lead-gen catalog bridge vacuous until a model-owned catalog is supplied', () => {
+    expect(LEAD_GEN_STAGE_KEYS_FROM_ONTOLOGY).toEqual([])
+    expect(getLeadGenStageCatalogFromOntology()).toEqual({})
   })
 
-  it('indexes legacy action ids through compiled ontology action types', () => {
-    expect(BUSINESS_ONTOLOGY_VALIDATION_INDEX.actionTypesByLegacyId['send_reply']?.ownerSystemId).toBe('sales.crm')
-    expect(isLeadGenActionKey('lead-gen.company.source')).toBe(true)
-    expect(isLeadGenActionKey('lead-gen.missing.action')).toBe(false)
+  it('does not publish Elevasis lead-gen action ids through the generic core ontology bridge', () => {
+    expect(BUSINESS_ONTOLOGY_VALIDATION_INDEX.actionTypesByLegacyId['send_reply']).toBeUndefined()
+    expect(BUSINESS_ONTOLOGY_VALIDATION_INDEX.actionTypesByLegacyId['lead-gen.company.source']).toBeUndefined()
   })
 })
 
@@ -273,11 +270,11 @@ describe('CrmTransitionItemRequestSchema', () => {
     }
   })
 
-  it('rejects non-CRM pipeline keys and unknown CRM keys', () => {
-    expect(CrmTransitionItemRequestSchema.safeParse({ ...valid, pipelineKey: 'lead-gen' }).success).toBe(false)
-    expect(CrmTransitionItemRequestSchema.safeParse({ ...valid, stageKey: 'unknown_stage' }).success).toBe(false)
-    expect(CrmTransitionItemRequestSchema.safeParse({ ...valid, stateKey: 'unknown_state' }).success).toBe(false)
-  })
+  it('accepts generic non-empty pipeline keys but rejects unknown CRM stage/state keys', () => {
+    expect(CrmTransitionItemRequestSchema.safeParse({ ...valid, pipelineKey: 'lead-gen' }).success).toBe(true)
+    expect(CrmTransitionItemRequestSchema.safeParse({ ...valid, stageKey: 'unknown_stage' }).success).toBe(false)
+    expect(CrmTransitionItemRequestSchema.safeParse({ ...valid, stateKey: 'unknown_state' }).success).toBe(false)
+  })
 })
 
 // ---------------------------------------------------------------------------
@@ -550,13 +547,13 @@ describe('UpdateContactRequestSchema', () => {
     )
   })
 
-  it('accepts processingState keyed by the stage catalog', () => {
-    const result = UpdateContactRequestSchema.safeParse({
-      processingState: {
-        [LEAD_GEN_STAGE_CATALOG.verified.key]: {
-          status: 'no_result'
-        }
-      }
+  it('accepts processingState keyed by the stage catalog', () => {
+    const result = UpdateContactRequestSchema.safeParse({
+      processingState: {
+        [VALID_CONTACT_STAGE_KEY]: {
+          status: 'no_result'
+        }
+      }
     })
 
     expect(result.success).toBe(true)
@@ -1027,20 +1024,16 @@ describe('ListStatusSchema', () => {
 // PipelineStageSchema
 // ---------------------------------------------------------------------------
 
-describe('PipelineStageSchema', () => {
-  it('accepts a key present in LEAD_GEN_STAGE_CATALOG', () => {
-    for (const key of Object.keys(LEAD_GEN_STAGE_CATALOG)) {
-      expect(PipelineStageSchema.safeParse({ key }).success).toBe(true)
-    }
-  })
-
-  it('rejects a key not in LEAD_GEN_STAGE_CATALOG', () => {
-    const result = PipelineStageSchema.safeParse({ key: 'not_a_real_stage' })
-    expect(result.success).toBe(false)
-    if (!result.success) {
-      expect(result.error.issues[0]?.message).toMatch(/LEAD_GEN_STAGE_CATALOG/)
-    }
-  })
+describe('PipelineStageSchema', () => {
+  it('accepts non-empty model-owned stage keys', () => {
+    expect(PipelineStageSchema.safeParse({ key: VALID_COMPANY_STAGE_KEY }).success).toBe(true)
+    expect(PipelineStageSchema.safeParse({ key: 'tenant-custom-stage' }).success).toBe(true)
+  })
+
+  it('rejects an empty stage key', () => {
+    const result = PipelineStageSchema.safeParse({ key: '' })
+    expect(result.success).toBe(false)
+  })
 
   it('accepts optional label, enabled, and order fields', () => {
     expect(PipelineStageSchema.safeParse({ key: 'scraped', label: 'Scraped', enabled: true, order: 1 }).success).toBe(
@@ -1061,23 +1054,23 @@ describe('BuildPlanSnapshotSchema', () => {
     expect(BuildPlanSnapshotSchema.safeParse(validSnapshot).success).toBe(true)
   })
 
-  it('rejects a step stageKey outside LEAD_GEN_STAGE_CATALOG', () => {
-    const result = BuildPlanSnapshotSchema.safeParse({
-      ...validSnapshot,
-      steps: [{ ...validSnapshot!.steps[0], stageKey: 'made-up-stage' }]
-    })
-
-    expect(result.success).toBe(false)
-  })
-
-  it('rejects a step actionKey outside ACTION_REGISTRY', () => {
-    const result = BuildPlanSnapshotSchema.safeParse({
-      ...validSnapshot,
-      steps: [{ ...validSnapshot!.steps[0], actionKey: 'lead-gen.missing.action' }]
-    })
-
-    expect(result.success).toBe(false)
-  })
+  it('accepts custom non-empty step stage keys at the transport boundary', () => {
+    const result = BuildPlanSnapshotSchema.safeParse({
+      ...validSnapshot,
+      steps: [{ ...validSnapshot!.steps[0], stageKey: 'made-up-stage' }]
+    })
+
+    expect(result.success).toBe(true)
+  })
+
+  it('accepts custom non-empty action keys at the transport boundary', () => {
+    const result = BuildPlanSnapshotSchema.safeParse({
+      ...validSnapshot,
+      steps: [{ ...validSnapshot!.steps[0], actionKey: 'lead-gen.missing.action' }]
+    })
+
+    expect(result.success).toBe(true)
+  })
 
   it('rejects duplicate step ids', () => {
     const first = validSnapshot!.steps[0]!
@@ -1475,13 +1468,13 @@ describe('UpdateCompanyRequestSchema', () => {
     expect(UpdateCompanyRequestSchema.safeParse({ status: 'invalid' }).success).toBe(true)
   })
 
-  it('accepts processingState keyed by the stage catalog', () => {
-    const result = UpdateCompanyRequestSchema.safeParse({
-      processingState: {
-        [LEAD_GEN_STAGE_CATALOG.qualified.key]: {
-          status: 'success',
-          data: { score: 92 }
-        }
+  it('accepts processingState keyed by the stage catalog', () => {
+    const result = UpdateCompanyRequestSchema.safeParse({
+      processingState: {
+        [VALID_COMPANY_STAGE_KEY]: {
+          status: 'success',
+          data: { score: 92 }
+        }
       }
     })
 
@@ -1492,14 +1485,14 @@ describe('UpdateCompanyRequestSchema', () => {
     expect(UpdateCompanyRequestSchema.safeParse({ pipelineStatus: 'emailed' }).success).toBe(true)
   })
 
-  it('rejects processingState keys outside the stage catalog', () => {
-    expect(
-      UpdateCompanyRequestSchema.safeParse({
-        processingState: {
-          madeUpStage: { status: 'success' }
-        }
-      }).success
-    ).toBe(false)
+  it('rejects empty processingState keys', () => {
+    expect(
+      UpdateCompanyRequestSchema.safeParse({
+        processingState: {
+          '': { status: 'success' }
+        }
+      }).success
+    ).toBe(false)
   })
 
   it('accepts numEmployees of 0', () => {
@@ -1744,10 +1737,10 @@ describe('ListRecordsQuerySchema', () => {
     expect(ListRecordsQuerySchema.safeParse({ entity: 'company', stage: 'uploaded' }).success).toBe(true)
   })
 
-  it('still rejects unrelated stage/entity combinations', () => {
-    expect(ListRecordsQuerySchema.safeParse({ entity: 'contact', stage: 'qualified' }).success).toBe(false)
-  })
-})
+  it('accepts stage/entity combinations at the transport boundary', () => {
+    expect(ListRecordsQuerySchema.safeParse({ entity: 'contact', stage: 'qualified' }).success).toBe(true)
+  })
+})
 
 // ---------------------------------------------------------------------------
 // AcqListResponseSchema (forward-compat)

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

@@ -1,29 +1,19 @@
 import { z } from 'zod'
 import { UuidSchema, NonEmptyStringSchema } from '../../platform/utils/validation'
-import { CRM_PIPELINE_DEFINITION } from '../../organization-model/domains/sales'
 import { CredentialRequirementSchema, RecordColumnConfigSchema } from '../../organization-model/domains/prospecting'
 import { isProspectingBuildTemplateId } from './build-templates'
 import {
   CRM_STAGE_KEYS_FROM_ONTOLOGY,
-  CRM_STATE_KEYS_FROM_ONTOLOGY,
-  isLeadGenActionKey,
-  isLeadGenRecordStageValidForEntity,
-  isLeadGenStageKey
+  CRM_STATE_KEYS_FROM_ONTOLOGY
 } from './ontology-validation'
 export { CrmPriorityBucketKeySchema, CrmPriorityBucketOverrideSchema, CrmPriorityOverrideSchema } from './crm-priority'
 export type { CrmPriorityBucketOverride, CrmPriorityOverride, ResolvedCrmPriorityRuleConfig } from './crm-priority'
 
 export const ProcessingStageStatusSchema = z.enum(['success', 'no_result', 'skipped', 'error'])
 
-export const LeadGenStageKeySchema = z
-  .string()
-  .refine((value) => isLeadGenStageKey(value), {
-    message: 'processing state key must match LEAD_GEN_STAGE_CATALOG'
-  })
+export const LeadGenStageKeySchema = z.string().trim().min(1)
 
-export const LeadGenActionKeySchema = z.string().refine((value) => isLeadGenActionKey(value), {
-  message: 'actionKey must match ACTION_REGISTRY'
-})
+export const LeadGenActionKeySchema = z.string().trim().min(1)
 
 const crmStageKeys = CRM_STAGE_KEYS_FROM_ONTOLOGY
 const crmStateKeys = CRM_STATE_KEYS_FROM_ONTOLOGY
@@ -135,9 +125,9 @@ export const TransitionItemRequestSchema = z
   })
   .strict()
 
-export const CrmTransitionItemRequestSchema = z
-  .object({
-    pipelineKey: z.literal(CRM_PIPELINE_DEFINITION.pipelineKey),
+export const CrmTransitionItemRequestSchema = z
+  .object({
+    pipelineKey: z.string().min(1),
     stageKey: CrmStageKeySchema,
     stateKey: CrmStateKeySchema.nullable().optional(),
     reason: z.string().optional(),
@@ -508,14 +498,14 @@ export const IcpRubricSchema = z.object({
 })
 
 /**
- * One stage entry in a list's `pipeline_config.stages[]`. The `key` is
- * validated against `LEAD_GEN_STAGE_CATALOG` so list pipeline definitions
- * stay aligned with the org-os semantic layer.
- */
+ * One stage entry in a list's `pipeline_config.stages[]`.
+ *
+ * Stage catalogs are model-owned. The published core schema validates the
+ * transport shape and leaves closed-catalog checks to callers with a resolved
+ * Organization Model.
+ */
 export const PipelineStageSchema = z.object({
-  key: z.string().refine((value) => isLeadGenStageKey(value), {
-    message: 'pipeline stage key must match LEAD_GEN_STAGE_CATALOG'
-  }),
+  key: LeadGenStageKeySchema,
   label: z.string().optional(),
   enabled: z.boolean().optional(),
   order: z.number().int().optional()
@@ -1183,25 +1173,14 @@ export const ListMembersQuerySchema = z
 
 export const ListRecordEntitySchema = z.enum(['company', 'contact'])
 
-export const ListRecordsQuerySchema = z
-  .object({
-    entity: ListRecordEntitySchema,
-    stage: LeadGenStageKeySchema.optional(),
-    limit: z.coerce.number().int().min(1).max(500).default(50),
-    offset: z.coerce.number().int().min(0).default(0)
-  })
-  .strict()
-  .superRefine((query, ctx) => {
-    if (!query.stage) return
-
-    if (!isLeadGenRecordStageValidForEntity(query.stage, query.entity)) {
-      ctx.addIssue({
-        code: z.ZodIssueCode.custom,
-        message: `stage "${query.stage}" is not valid for ${query.entity} records`,
-        path: ['stage']
-      })
-    }
-  })
+export const ListRecordsQuerySchema = z
+  .object({
+    entity: ListRecordEntitySchema,
+    stage: LeadGenStageKeySchema.optional(),
+    limit: z.coerce.number().int().min(1).max(500).default(50),
+    offset: z.coerce.number().int().min(0).default(0)
+  })
+  .strict()
 
 export const MemberIdParamsSchema = z.object({
   memberId: UuidSchema