@elevasis/sdk 1.21.0 → 1.22.0

package/reference/scaffold/reference/contracts.md

@@ -258,6 +258,12 @@ export type OrganizationModelObjective = z.infer<typeof ObjectiveSchema>
 export type OrganizationModelKeyResult = z.infer<typeof KeyResultSchema>
 ```
 
+### `OrganizationModelOntology`
+
+```typescript
+export type OrganizationModelOntology = z.infer<typeof OntologyScopeSchema>
+```
+
 ### `OrganizationModelSystems`
 
 ```typescript
@@ -270,6 +276,12 @@ export type OrganizationModelSystems = z.infer<typeof SystemsDomainSchema>
 export type OrganizationModelSystemEntry = z.infer<typeof SystemEntrySchema>
 ```
 
+### `OrganizationModelSystemConfig`
+
+```typescript
+export type OrganizationModelSystemConfig = z.infer<typeof SystemConfigSchema>
+```
+
 ### `OrganizationModelSystemId`
 
 ```typescript
@@ -297,7 +309,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>
 ```
 
@@ -319,6 +331,18 @@ export type OrganizationModelResourceEntry = z.infer<typeof ResourceEntrySchema>
 export type OrganizationModelResourceId = z.infer<typeof ResourceIdSchema>
 ```
 
+### `OrganizationModelCodeReference`
+
+```typescript
+export type OrganizationModelCodeReference = z.infer<typeof CodeReferenceSchema>
+```
+
+### `OrganizationModelCodeReferenceRole`
+
+```typescript
+export type OrganizationModelCodeReferenceRole = z.infer<typeof CodeReferenceRoleSchema>
+```
+
 ### `EventId`
 
 ```typescript
@@ -349,6 +373,12 @@ export type OrganizationModelResourceKind = z.infer<typeof ResourceKindSchema>
 export type OrganizationModelResourceGovernanceStatus = z.infer<typeof ResourceGovernanceStatusSchema>
 ```
 
+### `OrganizationModelResourceOntologyBinding`
+
+```typescript
+export type OrganizationModelResourceOntologyBinding = z.infer<typeof ResourceOntologyBindingSchema>
+```
+
 ### `OrganizationModelAgentKind`
 
 ```typescript
@@ -562,7 +592,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
 ```
 
@@ -571,8 +601,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']
 }
 ```
 
@@ -597,107 +627,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 {
+  featureKey: 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'
 }
 ```
 
@@ -710,75 +740,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
 }
 ```
 
@@ -787,29 +817,29 @@ export interface ElevasisSystemsContextValue {
 ### `ResourceStatus`
 
 ```typescript
-/**
- * Environment/deployment status for resources
- */
+/**
+ * Environment/deployment status for resources
+ */
 export type ResourceStatus = 'dev' | 'prod'
 ```
 
 ### `ResourceType`
 
 ```typescript
-/**
- * All resource types in the platform
- * Used as the discriminator field in ResourceDefinition
- */
+/**
+ * All resource types in the platform
+ * Used as the discriminator field in ResourceDefinition
+ */
 export type ResourceType = 'agent' | 'workflow' | 'trigger' | 'integration' | 'external' | 'human'
 ```
 
 ### `ExecutableResourceType`
 
 ```typescript
-/**
- * Executable resource types (subset of ResourceType)
- * These resources can be directly executed by the execution engine
- */
+/**
+ * Executable resource types (subset of ResourceType)
+ * These resources can be directly executed by the execution engine
+ */
 export type ExecutableResourceType = 'workflow' | 'agent'
 ```
 
@@ -822,52 +852,52 @@ export type ResourceSystemSummary = Pick<SystemEntry, 'id' | 'title' | 'descript
 ### `ResourceDefinition`
 
 ```typescript
-/**
- * Base interface for ALL platform resources
- * Shared by both executable (agents, workflows) and non-executable (triggers, integrations, etc.) resources
- */
-export interface ResourceDefinition {
-  /** Unique resource identifier */
-  resourceId: string
-
-  /** Display name */
-  name: string
-
-  /** Purpose and functionality description */
-  description: string
-
-  /** Version for change tracking and evolution */
-  version: string
-
-  /** Resource type discriminator */
-  type: ResourceType
-
-  /** Environment/deployment status */
-  status: ResourceStatus
-
-  /** Graph links to Organization Model nodes */
-  links?: ResourceLink[]
-
-  /** Infrastructure category for filtering */
-  category?: ResourceCategory
-
-  /** Whether the agent supports multi-turn sessions (agents only) */
-  sessionCapable?: boolean
-
-  /** Whether the resource is local (monorepo) or remote (externally deployed) */
-  origin?: 'local' | 'remote'
-
-  /** OM System membership — dot-separated system path (e.g. "sys.lead-gen"), when backed by a Resource descriptor */
-  systemPath?: string
-
-  /** Display metadata for the owning OM System */
-  system?: ResourceSystemSummary
-
-  /** Governance lifecycle status from the OM Resource descriptor */
-  governanceStatus?: ResourceGovernanceStatus
-
-  /** Whether this resource is archived and should be excluded from registration and deployment */
-  archived?: boolean
+/**
+ * Base interface for ALL platform resources
+ * Shared by both executable (agents, workflows) and non-executable (triggers, integrations, etc.) resources
+ */
+export interface ResourceDefinition {
+  /** Unique resource identifier */
+  resourceId: string
+
+  /** Display name */
+  name: string
+
+  /** Purpose and functionality description */
+  description: string
+
+  /** Version for change tracking and evolution */
+  version: string
+
+  /** Resource type discriminator */
+  type: ResourceType
+
+  /** Environment/deployment status */
+  status: ResourceStatus
+
+  /** Graph links to Organization Model nodes */
+  links?: ResourceLink[]
+
+  /** Infrastructure category for filtering */
+  category?: ResourceCategory
+
+  /** Whether the agent supports multi-turn sessions (agents only) */
+  sessionCapable?: boolean
+
+  /** Whether the resource is local (monorepo) or remote (externally deployed) */
+  origin?: 'local' | 'remote'
+
+  /** OM System membership — dot-separated system path (e.g. "sys.lead-gen"), when backed by a Resource descriptor */
+  systemPath?: string
+
+  /** Display metadata for the owning OM System */
+  system?: ResourceSystemSummary
+
+  /** Governance lifecycle status from the OM Resource descriptor */
+  governanceStatus?: ResourceGovernanceStatus
+
+  /** Whether this resource is archived and should be excluded from registration and deployment */
+  archived?: boolean
 }
 ```
 
@@ -880,371 +910,371 @@ export type RuntimeResourceDescriptor = Extract<ResourceEntry, { kind: 'workflow
 ### `DescriptorBackedResourceDefinition`
 
 ```typescript
-export type DescriptorBackedResourceDefinition<
-  TResource extends RuntimeResourceDescriptor = RuntimeResourceDescriptor
-> = Omit<ResourceDefinition, 'resourceId' | 'type'> & {
-  /** OM descriptor that owns canonical identity and governance metadata. */
-  resource: TResource
-  resourceId?: never
-  type?: never
+export type DescriptorBackedResourceDefinition<
+  TResource extends RuntimeResourceDescriptor = RuntimeResourceDescriptor
+> = Omit<ResourceDefinition, 'resourceId' | 'type'> & {
+  /** OM descriptor that owns canonical identity and governance metadata. */
+  resource: TResource
+  resourceId?: never
+  type?: never
 }
 ```
 
 ### `BoundResourceDefinition`
 
 ```typescript
-export type BoundResourceDefinition<TResource extends RuntimeResourceDescriptor = RuntimeResourceDescriptor> = Omit<
-  DescriptorBackedResourceDefinition<TResource>,
-  'resource'
-> &
-  ResourceDefinition & {
-    resource: TResource
-    resourceId: TResource['id']
-    type: TResource['kind']
+export type BoundResourceDefinition<TResource extends RuntimeResourceDescriptor = RuntimeResourceDescriptor> = Omit<
+  DescriptorBackedResourceDefinition<TResource>,
+  'resource'
+> &
+  ResourceDefinition & {
+    resource: TResource
+    resourceId: TResource['id']
+    type: TResource['kind']
   }
 ```
 
 ### `ResourceList`
 
 ```typescript
-/**
- * Resource list for organization
- * Returns ResourceDefinition metadata (not full definitions)
- */
-export interface ResourceList {
-  workflows: ResourceDefinition[]
-  agents: ResourceDefinition[]
-  total: number
-  organizationName: string
-  environment?: 'dev' | 'prod'
+/**
+ * Resource list for organization
+ * Returns ResourceDefinition metadata (not full definitions)
+ */
+export interface ResourceList {
+  workflows: ResourceDefinition[]
+  agents: ResourceDefinition[]
+  total: number
+  organizationName: string
+  environment?: 'dev' | 'prod'
 }
 ```
 
 ### `WebhookProviderType`
 
 ```typescript
-/** Webhook provider identifiers */
+/** Webhook provider identifiers */
 export type WebhookProviderType = 'cal-com' | 'stripe' | 'signature-api' | 'instantly' | 'apify' | 'test'
 ```
 
 ### `WebhookTriggerConfig`
 
 ```typescript
-/** Webhook trigger configuration */
-export interface WebhookTriggerConfig {
-  /** Provider identifier */
-  provider: WebhookProviderType
-  /** Event type for documentation (not used for matching - workflow handles routing) */
-  event?: string
-  /** Optional filtering (e.g., specific form ID for Fillout) */
-  filter?: Record<string, string>
-  /** References credential in credentials table for per-org webhook secrets */
-  credentialName?: string
+/** Webhook trigger configuration */
+export interface WebhookTriggerConfig {
+  /** Provider identifier */
+  provider: WebhookProviderType
+  /** Event type for documentation (not used for matching - workflow handles routing) */
+  event?: string
+  /** Optional filtering (e.g., specific form ID for Fillout) */
+  filter?: Record<string, string>
+  /** References credential in credentials table for per-org webhook secrets */
+  credentialName?: string
 }
 ```
 
 ### `ScheduleTriggerConfig`
 
 ```typescript
-/** Schedule trigger configuration */
-export interface ScheduleTriggerConfig {
-  /** Cron expression (e.g., '0 6 * * *') */
-  cron: string
-  /** Optional timezone (default: UTC) */
-  timezone?: string
+/** Schedule trigger configuration */
+export interface ScheduleTriggerConfig {
+  /** Cron expression (e.g., '0 6 * * *') */
+  cron: string
+  /** Optional timezone (default: UTC) */
+  timezone?: string
 }
 ```
 
 ### `EventTriggerConfig`
 
 ```typescript
-/** Event trigger configuration */
-export interface EventTriggerConfig {
-  /** Internal event type */
-  eventType: string
-  /** Event source */
-  source?: string
+/** Event trigger configuration */
+export interface EventTriggerConfig {
+  /** Internal event type */
+  eventType: string
+  /** Event source */
+  source?: string
 }
 ```
 
 ### `TriggerConfig`
 
 ```typescript
-/** Union of all trigger configs */
+/** Union of all trigger configs */
 export type TriggerConfig = WebhookTriggerConfig | ScheduleTriggerConfig | EventTriggerConfig
 ```
 
 ### `TriggerDefinition`
 
 ```typescript
-/**
- * Trigger metadata - entry points that initiate resource execution
- *
- * Triggers represent how executions start: webhooks from external services,
- * scheduled cron jobs, platform events, or manual user actions.
- *
- * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
- * - Field renames: `id` -> `resourceId` (inherited), `type` -> `triggerType`
- * - Relationship rename: `invokes` -> `triggers` (unified vocabulary)
- * - New required fields: `version` (inherited), `type: 'trigger'` (inherited)
- * - triggers object now includes `externalResources` option
- *
- * @example
- * // TriggerDefinition - metadata only
- * {
- *   resourceId: 'trigger-new-order',
- *   type: 'trigger',
- *   triggerType: 'webhook',
- *   name: 'New Order',
- *   description: 'Webhook from Shopify on new orders',
- *   version: '1.0.0',
- *   status: 'prod',
- *   webhookPath: '/webhooks/shopify/orders'
- * }
- *
- * // Relationships declared in ResourceRelationships (not on TriggerDefinition):
- * // relationships: {
- * //   'trigger-new-order': { triggers: { workflows: ['order-fulfillment-workflow'] } }
- * // }
- */
-export interface TriggerDefinition extends ResourceDefinition {
-  /** Resource type discriminator (narrowed from base union) */
-  type: 'trigger'
-
-  /** Trigger mechanism type (renamed from 'type' to avoid collision with base type discriminator) */
-  triggerType: 'webhook' | 'schedule' | 'manual' | 'event'
-
-  /** Type-specific configuration */
-  config?: TriggerConfig
-
-  // Legacy fields (deprecated, use config instead)
-  /** For webhook triggers: path like '/webhooks/shopify/orders' */
-  webhookPath?: string
-  /** For schedule triggers: cron expression like '0 6 * * *' */
-  schedule?: string
-  /** For event triggers: event type like 'low-stock-alert' */
-  eventType?: string
-
-  // NOTE: What this trigger starts is declared in ResourceRelationships, not here
-  // This prevents duplication - triggers are forward-declared in relationships
+/**
+ * Trigger metadata - entry points that initiate resource execution
+ *
+ * Triggers represent how executions start: webhooks from external services,
+ * scheduled cron jobs, platform events, or manual user actions.
+ *
+ * BREAKING CHANGES (2025-11-30):
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
+ * - Field renames: `id` -> `resourceId` (inherited), `type` -> `triggerType`
+ * - Relationship rename: `invokes` -> `triggers` (unified vocabulary)
+ * - New required fields: `version` (inherited), `type: 'trigger'` (inherited)
+ * - triggers object now includes `externalResources` option
+ *
+ * @example
+ * // TriggerDefinition - metadata only
+ * {
+ *   resourceId: 'trigger-new-order',
+ *   type: 'trigger',
+ *   triggerType: 'webhook',
+ *   name: 'New Order',
+ *   description: 'Webhook from Shopify on new orders',
+ *   version: '1.0.0',
+ *   status: 'prod',
+ *   webhookPath: '/webhooks/shopify/orders'
+ * }
+ *
+ * // Relationships declared in ResourceRelationships (not on TriggerDefinition):
+ * // relationships: {
+ * //   'trigger-new-order': { triggers: { workflows: ['order-fulfillment-workflow'] } }
+ * // }
+ */
+export interface TriggerDefinition extends ResourceDefinition {
+  /** Resource type discriminator (narrowed from base union) */
+  type: 'trigger'
+
+  /** Trigger mechanism type (renamed from 'type' to avoid collision with base type discriminator) */
+  triggerType: 'webhook' | 'schedule' | 'manual' | 'event'
+
+  /** Type-specific configuration */
+  config?: TriggerConfig
+
+  // Legacy fields (deprecated, use config instead)
+  /** For webhook triggers: path like '/webhooks/shopify/orders' */
+  webhookPath?: string
+  /** For schedule triggers: cron expression like '0 6 * * *' */
+  schedule?: string
+  /** For event triggers: event type like 'low-stock-alert' */
+  eventType?: string
+
+  // NOTE: What this trigger starts is declared in ResourceRelationships, not here
+  // This prevents duplication - triggers are forward-declared in relationships
 }
 ```
 
 ### `IntegrationDefinition`
 
 ```typescript
-/**
- * Integration metadata - external service connections
- *
- * References credentials table for actual connection. No connection status
- * stored here (queried at runtime from credentials table).
- *
- * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
- * - Field renames: `id` -> `resourceId` (inherited)
- * - New required field: `status` (inherited) - organizations must add status to all integrations
- * - New required field: `version` (inherited) - organizations must add version to all integrations
- * - New required field: `type: 'integration'` (inherited) - resource type discriminator
- *
- * @example
- * {
- *   resourceId: 'integration-shopify-prod',
- *   type: 'integration',
- *   provider: 'shopify',
- *   credentialName: 'shopify-prod',
- *   name: 'Shopify Production',
- *   description: 'E-commerce platform',
- *   version: '1.0.0',
- *   status: 'prod'
- * }
- */
-export interface IntegrationDefinition extends ResourceDefinition {
-  /** Resource type discriminator (narrowed from base union) */
-  type: 'integration'
-
-  /** OM descriptor that owns canonical identity and governance metadata. */
-  resource?: Extract<ResourceEntry, { kind: 'integration' }>
-
-  /** Integration provider type */
-  provider: IntegrationType
-  /** References credentials table (e.g., 'shopify-prod', 'zendesk-api') */
-  credentialName: string
+/**
+ * Integration metadata - external service connections
+ *
+ * References credentials table for actual connection. No connection status
+ * stored here (queried at runtime from credentials table).
+ *
+ * BREAKING CHANGES (2025-11-30):
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
+ * - Field renames: `id` -> `resourceId` (inherited)
+ * - New required field: `status` (inherited) - organizations must add status to all integrations
+ * - New required field: `version` (inherited) - organizations must add version to all integrations
+ * - New required field: `type: 'integration'` (inherited) - resource type discriminator
+ *
+ * @example
+ * {
+ *   resourceId: 'integration-shopify-prod',
+ *   type: 'integration',
+ *   provider: 'shopify',
+ *   credentialName: 'shopify-prod',
+ *   name: 'Shopify Production',
+ *   description: 'E-commerce platform',
+ *   version: '1.0.0',
+ *   status: 'prod'
+ * }
+ */
+export interface IntegrationDefinition extends ResourceDefinition {
+  /** Resource type discriminator (narrowed from base union) */
+  type: 'integration'
+
+  /** OM descriptor that owns canonical identity and governance metadata. */
+  resource?: Extract<ResourceEntry, { kind: 'integration' }>
+
+  /** Integration provider type */
+  provider: IntegrationType
+  /** References credentials table (e.g., 'shopify-prod', 'zendesk-api') */
+  credentialName: string
 }
 ```
 
 ### `RelationshipDeclaration`
 
 ```typescript
-/**
- * Explicit resource relationship declaration
- *
- * Single-direction only - Command View derives reverse relationships.
- * Agents/workflows declare what they trigger and use.
- *
- * @example
- * {
- *   triggers: { workflows: ['order-fulfillment-workflow'] },
- *   uses: { integrations: ['integration-shopify-prod', 'integration-postgres'] }
- * }
- */
-export interface RelationshipDeclaration {
-  /** Resources this resource triggers */
-  triggers?: {
-    /** Agent resourceIds this resource triggers */
-    agents?: string[]
-    /** Workflow resourceIds this resource triggers */
-    workflows?: string[]
-  }
-  /** Integrations this resource uses */
-  uses?: {
-    /** Integration IDs this resource uses */
-    integrations?: string[]
-  }
+/**
+ * Explicit resource relationship declaration
+ *
+ * Single-direction only - Command View derives reverse relationships.
+ * Agents/workflows declare what they trigger and use.
+ *
+ * @example
+ * {
+ *   triggers: { workflows: ['order-fulfillment-workflow'] },
+ *   uses: { integrations: ['integration-shopify-prod', 'integration-postgres'] }
+ * }
+ */
+export interface RelationshipDeclaration {
+  /** Resources this resource triggers */
+  triggers?: {
+    /** Agent resourceIds this resource triggers */
+    agents?: string[]
+    /** Workflow resourceIds this resource triggers */
+    workflows?: string[]
+  }
+  /** Integrations this resource uses */
+  uses?: {
+    /** Integration IDs this resource uses */
+    integrations?: string[]
+  }
 }
 ```
 
 ### `ResourceRelationships`
 
 ```typescript
-/**
- * Resource relationships map
- * Maps resourceId to its relationship declarations
- *
- * @example
- * {
- *   'order-processor-agent': {
- *     triggers: { workflows: ['order-fulfillment-workflow'] },
- *     uses: { integrations: ['integration-shopify-prod'] }
- *   }
- * }
- */
+/**
+ * Resource relationships map
+ * Maps resourceId to its relationship declarations
+ *
+ * @example
+ * {
+ *   'order-processor-agent': {
+ *     triggers: { workflows: ['order-fulfillment-workflow'] },
+ *     uses: { integrations: ['integration-shopify-prod'] }
+ *   }
+ * }
+ */
 export type ResourceRelationships = Record<string, RelationshipDeclaration>
 ```
 
 ### `ExternalPlatform`
 
 ```typescript
-/**
- * External platform type
- * Supported third-party automation platforms
- */
+/**
+ * External platform type
+ * Supported third-party automation platforms
+ */
 export type ExternalPlatform = 'n8n' | 'make' | 'zapier' | 'other'
 ```
 
 ### `ExternalResourceDefinition`
 
 ```typescript
-/**
- * External automation resource metadata
- *
- * Represents workflows/automations running on third-party platforms
- * (n8n, Make, Zapier, etc.) for visualization in Command View.
- *
- * NOTE: This is metadata ONLY for visualization. No execution logic,
- * no API integration with external platforms, no status syncing.
- *
- * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
- * - Field renames: `id` -> `resourceId` (inherited)
- * - New required field: `version` (inherited) - organizations must add version to all external resources
- * - New required field: `type: 'external'` (inherited) - resource type discriminator
- * - REMOVED FIELD: `triggeredBy` - per relationship-consolidation design, all relationships are forward-only declarations
- *
- * @example
- * {
- *   resourceId: 'external-n8n-order-sync',
- *   type: 'external',
- *   version: '1.0.0',
- *   platform: 'n8n',
- *   name: 'Shopify Order Sync',
- *   description: 'Legacy n8n workflow for syncing Shopify orders',
- *   status: 'prod',
- *   platformUrl: 'https://n8n.client.com/workflow/123',
- *   triggers: { workflows: ['order-fulfillment-workflow'] },
- *   uses: { integrations: ['integration-shopify-prod'] }
- * }
- */
-export interface ExternalResourceDefinition extends ResourceDefinition {
-  /** Resource type discriminator (narrowed from base union) */
-  type: 'external'
-
-  /** Platform type */
-  platform: ExternalPlatform
-
-  // Optional platform-specific metadata
-  /** Link to external platform (e.g., n8n workflow editor URL) */
-  platformUrl?: string
-  /** Platform's internal ID/reference */
-  externalId?: string
-
-  /** What this external resource triggers (external -> internal) */
-  triggers?: {
-    /** Elevasis workflow resourceIds this external automation triggers */
-    workflows?: string[]
-    /** Elevasis agent resourceIds this external automation triggers */
-    agents?: string[]
-  }
-
-  /** Integrations this external resource uses (shared credentials) */
-  uses?: {
-    /** Integration IDs this external automation uses */
-    integrations?: string[]
-  }
-
-  // NOTE: triggeredBy field removed - per relationship-consolidation design,
-  // all relationships are forward-only declarations. Graph edges are built
-  // from forward declarations only.
+/**
+ * External automation resource metadata
+ *
+ * Represents workflows/automations running on third-party platforms
+ * (n8n, Make, Zapier, etc.) for visualization in Command View.
+ *
+ * NOTE: This is metadata ONLY for visualization. No execution logic,
+ * no API integration with external platforms, no status syncing.
+ *
+ * BREAKING CHANGES (2025-11-30):
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
+ * - Field renames: `id` -> `resourceId` (inherited)
+ * - New required field: `version` (inherited) - organizations must add version to all external resources
+ * - New required field: `type: 'external'` (inherited) - resource type discriminator
+ * - REMOVED FIELD: `triggeredBy` - per relationship-consolidation design, all relationships are forward-only declarations
+ *
+ * @example
+ * {
+ *   resourceId: 'external-n8n-order-sync',
+ *   type: 'external',
+ *   version: '1.0.0',
+ *   platform: 'n8n',
+ *   name: 'Shopify Order Sync',
+ *   description: 'Legacy n8n workflow for syncing Shopify orders',
+ *   status: 'prod',
+ *   platformUrl: 'https://n8n.client.com/workflow/123',
+ *   triggers: { workflows: ['order-fulfillment-workflow'] },
+ *   uses: { integrations: ['integration-shopify-prod'] }
+ * }
+ */
+export interface ExternalResourceDefinition extends ResourceDefinition {
+  /** Resource type discriminator (narrowed from base union) */
+  type: 'external'
+
+  /** Platform type */
+  platform: ExternalPlatform
+
+  // Optional platform-specific metadata
+  /** Link to external platform (e.g., n8n workflow editor URL) */
+  platformUrl?: string
+  /** Platform's internal ID/reference */
+  externalId?: string
+
+  /** What this external resource triggers (external -> internal) */
+  triggers?: {
+    /** Elevasis workflow resourceIds this external automation triggers */
+    workflows?: string[]
+    /** Elevasis agent resourceIds this external automation triggers */
+    agents?: string[]
+  }
+
+  /** Integrations this external resource uses (shared credentials) */
+  uses?: {
+    /** Integration IDs this external automation uses */
+    integrations?: string[]
+  }
+
+  // NOTE: triggeredBy field removed - per relationship-consolidation design,
+  // all relationships are forward-only declarations. Graph edges are built
+  // from forward declarations only.
 }
 ```
 
 ### `HumanCheckpointDefinition`
 
 ```typescript
-/**
- * Human Checkpoint definition - human decision points in automation
- *
- * Represents where human judgment is deployed in the automation landscape.
- * Tasks with matching command_queue_group are routed to this checkpoint.
- *
- * BREAKING CHANGES (2025-11-30):
- * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
- * - Field renames: `id` -> `resourceId` (inherited)
- * - description is now REQUIRED (was optional) - organizations must add description to all human checkpoints
- * - New required field: `version` (inherited) - organizations must add version to all human checkpoints
- * - New required field: `type: 'human'` (inherited) - resource type discriminator
- *
- * @example
- * {
- *   resourceId: 'sales-approval',
- *   type: 'human',
- *   name: 'Sales Approval Queue',
- *   description: 'High-value order approvals for sales team',
- *   version: '1.0.0',
- *   status: 'prod',
- *   requestedBy: { agents: ['order-processor-agent'] },
- *   routesTo: { agents: ['order-fulfillment-agent'] }
- * }
- */
-export interface HumanCheckpointDefinition extends ResourceDefinition {
-  /** Resource type discriminator (narrowed from base union) */
-  type: 'human'
-
-  /** Resources that create tasks for this checkpoint */
-  requestedBy?: {
-    /** Agent resourceIds that request approval here */
-    agents?: string[]
-    /** Workflow resourceIds that request approval here */
-    workflows?: string[]
-  }
-
-  /** Resources that receive approved decisions */
-  routesTo?: {
-    /** Agent resourceIds that handle approved tasks */
-    agents?: string[]
-    /** Workflow resourceIds that handle approved tasks */
-    workflows?: string[]
-  }
+/**
+ * Human Checkpoint definition - human decision points in automation
+ *
+ * Represents where human judgment is deployed in the automation landscape.
+ * Tasks with matching command_queue_group are routed to this checkpoint.
+ *
+ * BREAKING CHANGES (2025-11-30):
+ * - Now extends ResourceDefinition (inherits: resourceId, name, description, version, type, status, links, category)
+ * - Field renames: `id` -> `resourceId` (inherited)
+ * - description is now REQUIRED (was optional) - organizations must add description to all human checkpoints
+ * - New required field: `version` (inherited) - organizations must add version to all human checkpoints
+ * - New required field: `type: 'human'` (inherited) - resource type discriminator
+ *
+ * @example
+ * {
+ *   resourceId: 'sales-approval',
+ *   type: 'human',
+ *   name: 'Sales Approval Queue',
+ *   description: 'High-value order approvals for sales team',
+ *   version: '1.0.0',
+ *   status: 'prod',
+ *   requestedBy: { agents: ['order-processor-agent'] },
+ *   routesTo: { agents: ['order-fulfillment-agent'] }
+ * }
+ */
+export interface HumanCheckpointDefinition extends ResourceDefinition {
+  /** Resource type discriminator (narrowed from base union) */
+  type: 'human'
+
+  /** Resources that create tasks for this checkpoint */
+  requestedBy?: {
+    /** Agent resourceIds that request approval here */
+    agents?: string[]
+    /** Workflow resourceIds that request approval here */
+    workflows?: string[]
+  }
+
+  /** Resources that receive approved decisions */
+  routesTo?: {
+    /** Agent resourceIds that handle approved tasks */
+    agents?: string[]
+    /** Workflow resourceIds that handle approved tasks */
+    workflows?: string[]
+  }
 }
 ```
 
@@ -1253,36 +1283,36 @@ export interface HumanCheckpointDefinition extends ResourceDefinition {
 ### `DeploymentSpec`
 
 ```typescript
-/**
- * Organization-specific resource collection
- *
- * Complete manifest of all automation resources for an organization.
- * Used by ResourceRegistry for discovery and Command View for visualization.
- */
-export interface DeploymentSpec {
-  /** Deployment version (semver) */
-  version: string
-  /** Optional Organization Model governance catalog used for OM-code validation */
-  organizationModel?: {
-    systems?: OrganizationModelSystems
-    resources?: OrganizationModelResources
-  }
-  /** Workflow definitions */
-  workflows?: WorkflowDefinition[]
-  /** Agent definitions */
-  agents?: AgentDefinition[]
-
-  // Resource Manifest fields (optional for backwards compatibility)
-  /** Trigger definitions - entry points that initiate executions */
-  triggers?: TriggerDefinition[]
-  /** Integration definitions - external service connections */
-  integrations?: IntegrationDefinition[]
-  /** Explicit relationship declarations between resources */
-  relationships?: ResourceRelationships
-  /** External automation resources (n8n, Make, Zapier, etc.) */
-  externalResources?: ExternalResourceDefinition[]
-  /** Human checkpoint definitions - human decision points in automation */
-  humanCheckpoints?: HumanCheckpointDefinition[]
+/**
+ * Organization-specific resource collection
+ *
+ * Complete manifest of all automation resources for an organization.
+ * Used by ResourceRegistry for discovery and Command View for visualization.
+ */
+export interface DeploymentSpec {
+  /** Deployment version (semver) */
+  version: string
+  /** Optional Organization Model governance catalog used for OM-code validation */
+  organizationModel?: {
+    systems?: OrganizationModelSystems
+    resources?: OrganizationModelResources
+  }
+  /** Workflow definitions */
+  workflows?: WorkflowDefinition[]
+  /** Agent definitions */
+  agents?: AgentDefinition[]
+
+  // Resource Manifest fields (optional for backwards compatibility)
+  /** Trigger definitions - entry points that initiate executions */
+  triggers?: TriggerDefinition[]
+  /** Integration definitions - external service connections */
+  integrations?: IntegrationDefinition[]
+  /** Explicit relationship declarations between resources */
+  relationships?: ResourceRelationships
+  /** External automation resources (n8n, Make, Zapier, etc.) */
+  externalResources?: ExternalResourceDefinition[]
+  /** Human checkpoint definitions - human decision points in automation */
+  humanCheckpoints?: HumanCheckpointDefinition[]
 }
 ```
 
@@ -1291,77 +1321,77 @@ export interface DeploymentSpec {
 ### `AcqCompany`
 
 ```typescript
-/**
- * Company record in the acquisition database.
- * Contains enriched company data from various sources.
- * Transformed from AcqCompanyRow with camelCase properties.
- */
-export interface AcqCompany {
-  id: string
-  organizationId: string
-  name: string
-  domain: string | null
-  linkedinUrl: string | null
-  website: string | null
-  numEmployees: number | null
-  foundedYear: number | null
-  locationCity: string | null
-  locationState: string | null
-  category: string | null
-  categoryPain: string | null
-  segment: string | null
-  processingState: CompanyProcessingState | null
-  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
-  pipelineStatus?: LegacyPipelineStatus | null
-  enrichmentData: CompanyEnrichmentData | null
-  source: string | null
-  batchId: string | null
-  status: 'active' | 'invalid'
-  verticalResearch: string | null
-  /** Track A: flat qualification score (null until a scoring rubric is defined). Added by W1 migration. */
-  qualificationScore: number | null
-  /** Track A: flat qualification signals jsonb preserving the result payload shape. Added by W1 migration. */
-  qualificationSignals: Record<string, unknown> | null
-  /** Track A: key identifying the rubric used for qualification. Added by W1 migration. */
-  qualificationRubricKey: string | null
-  createdAt: Date
-  updatedAt: Date
+/**
+ * Company record in the acquisition database.
+ * Contains enriched company data from various sources.
+ * Transformed from AcqCompanyRow with camelCase properties.
+ */
+export interface AcqCompany {
+  id: string
+  organizationId: string
+  name: string
+  domain: string | null
+  linkedinUrl: string | null
+  website: string | null
+  numEmployees: number | null
+  foundedYear: number | null
+  locationCity: string | null
+  locationState: string | null
+  category: string | null
+  categoryPain: string | null
+  segment: string | null
+  processingState: CompanyProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
+  enrichmentData: CompanyEnrichmentData | null
+  source: string | null
+  batchId: string | null
+  status: 'active' | 'invalid'
+  verticalResearch: string | null
+  /** Track A: flat qualification score (null until a scoring rubric is defined). Added by W1 migration. */
+  qualificationScore: number | null
+  /** Track A: flat qualification signals jsonb preserving the result payload shape. Added by W1 migration. */
+  qualificationSignals: Record<string, unknown> | null
+  /** Track A: key identifying the rubric used for qualification. Added by W1 migration. */
+  qualificationRubricKey: string | null
+  createdAt: Date
+  updatedAt: Date
 }
 ```
 
 ### `AcqContact`
 
 ```typescript
-/**
- * Contact record in the acquisition database.
- * Contains enriched contact data and personalization content.
- * Transformed from AcqContactRow with camelCase properties.
- */
-export interface AcqContact {
-  id: string
-  organizationId: string
-  companyId: string | null
-  email: string
-  emailValid: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN' | null
-  firstName: string | null
-  lastName: string | null
-  linkedinUrl: string | null
-  title: string | null
-  headline: string | null
-  filterReason: string | null
-  openingLine: string | null
-  source: string | null
-  sourceId: string | null
-  processingState: ContactProcessingState | null
-  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
-  pipelineStatus?: LegacyPipelineStatus | null
-  enrichmentData: ContactEnrichmentData | null
-  /** Attio Person record ID - set when contact responds and is added to CRM */
-  attioPersonId: string | null
-  batchId: string | null
-  status: 'active' | 'invalid'
-  createdAt: Date
-  updatedAt: Date
+/**
+ * Contact record in the acquisition database.
+ * Contains enriched contact data and personalization content.
+ * Transformed from AcqContactRow with camelCase properties.
+ */
+export interface AcqContact {
+  id: string
+  organizationId: string
+  companyId: string | null
+  email: string
+  emailValid: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN' | null
+  firstName: string | null
+  lastName: string | null
+  linkedinUrl: string | null
+  title: string | null
+  headline: string | null
+  filterReason: string | null
+  openingLine: string | null
+  source: string | null
+  sourceId: string | null
+  processingState: ContactProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
+  enrichmentData: ContactEnrichmentData | null
+  /** Attio Person record ID - set when contact responds and is added to CRM */
+  attioPersonId: string | null
+  batchId: string | null
+  status: 'active' | 'invalid'
+  createdAt: Date
+  updatedAt: Date
 }
 ```
 
@@ -1380,23 +1410,23 @@ export type DealPriorityBucketKey = 'needs_response' | 'follow_up_due' | 'waitin
 ### `DealPriority`
 
 ```typescript
-export interface DealPriority {
-  bucketKey: DealPriorityBucketKey
-  rank: number
-  label: string
-  color: string
-  reason: string
-  latestActivityAt: string | null
-  nextActionAt: string | null
+export interface DealPriority {
+  bucketKey: DealPriorityBucketKey
+  rank: number
+  label: string
+  color: string
+  reason: string
+  latestActivityAt: string | null
+  nextActionAt: string | null
 }
 ```
 
 ### `KanbanStageConfig`
 
 ```typescript
-export interface KanbanStageConfig {
-  color: string // Mantine color token (e.g. 'blue', 'teal')
-  label?: string // Optional display label override
+export interface KanbanStageConfig {
+  color: string // Mantine color token (e.g. 'blue', 'teal')
+  label?: string // Optional display label override
 }
 ```
 
@@ -1409,49 +1439,49 @@ export type KanbanBoardConfig = Partial<Record<DealStage, KanbanStageConfig>>
 ### `DealContact`
 
 ```typescript
-export interface DealContact {
-  id: string
-  first_name: string | null
-  last_name: string | null
-  email: string
-  title: string | null
-  headline: string | null
-  linkedin_url: string | null
-  processing_state: Record<string, unknown> | null
-  enrichment_data: Record<string, unknown> | null
-  company: {
-    id: string
-    name: string
-    domain: string | null
-    website: string | null
-    linkedin_url: string | null
-    segment: string | null
-    category: string | null
-    num_employees: number | null
-  } | null
+export interface DealContact {
+  id: string
+  first_name: string | null
+  last_name: string | null
+  email: string
+  title: string | null
+  headline: string | null
+  linkedin_url: string | null
+  processing_state: Record<string, unknown> | null
+  enrichment_data: Record<string, unknown> | null
+  company: {
+    id: string
+    name: string
+    domain: string | null
+    website: string | null
+    linkedin_url: string | null
+    segment: string | null
+    category: string | null
+    num_employees: number | null
+  } | null
 }
 ```
 
 ### `DealFilters`
 
 ```typescript
-export interface DealFilters {
-  stage?: DealStage
-  search?: string
-  limit?: number
-  offset?: number
+export interface DealFilters {
+  stage?: DealStage
+  search?: string
+  limit?: number
+  offset?: number
 }
 ```
 
 ### `DealListItem`
 
 ```typescript
-/** Deal list item with joined contact and company data */
-export interface DealListItem extends AcqDealRow {
-  priority: DealPriority
-  ownership: 'us' | 'them' | null
-  nextAction: string | null
-  contact: DealContact | null
+/** Deal list item with joined contact and company data */
+export interface DealListItem extends AcqDealRow {
+  priority: DealPriority
+  ownership: 'us' | 'them' | null
+  nextAction: string | null
+  contact: DealContact | null
 }
 ```
 
@@ -1464,31 +1494,31 @@ export type DealDetail = DealListItem
 ### `AcqDealTaskKind`
 
 ```typescript
-/** Task kind options for a deal task (human follow-up action type) */
+/** Task kind options for a deal task (human follow-up action type) */
 export type AcqDealTaskKind = 'call' | 'email' | 'meeting' | 'other'
 ```
 
 ### `AcqDealTask`
 
 ```typescript
-/**
- * A CRM to-do item attached to a deal representing a human follow-up action.
- * Transformed from AcqDealTaskRow with camelCase properties.
- */
-export interface AcqDealTask {
-  id: string
-  organizationId: string
-  dealId: string
-  title: string
-  description: string | null
-  kind: AcqDealTaskKind
-  dueAt: string | null
-  assigneeUserId: string | null
-  completedAt: string | null
-  completedByUserId: string | null
-  createdAt: string
-  updatedAt: string
-  createdByUserId: string | null
+/**
+ * A CRM to-do item attached to a deal representing a human follow-up action.
+ * Transformed from AcqDealTaskRow with camelCase properties.
+ */
+export interface AcqDealTask {
+  id: string
+  organizationId: string
+  dealId: string
+  title: string
+  description: string | null
+  kind: AcqDealTaskKind
+  dueAt: string | null
+  assigneeUserId: string | null
+  completedAt: string | null
+  completedByUserId: string | null
+  createdAt: string
+  updatedAt: string
+  createdByUserId: string | null
 }
 ```
 
@@ -1501,54 +1531,54 @@ export type CrmPriorityBucketKey = 'needs_response' | 'follow_up_due' | 'waiting
 ### `CrmPriorityBucketDefinition`
 
 ```typescript
-export interface CrmPriorityBucketDefinition {
-  bucketKey: CrmPriorityBucketKey
-  label: string
-  /** Lower ranks sort first in deal lists and pipeline columns. */
-  rank: number
-  /** UI color token. Consumers may map this to their design system. */
-  color: string
+export interface CrmPriorityBucketDefinition {
+  bucketKey: CrmPriorityBucketKey
+  label: string
+  /** Lower ranks sort first in deal lists and pipeline columns. */
+  rank: number
+  /** UI color token. Consumers may map this to their design system. */
+  color: string
 }
 ```
 
 ### `CrmPriorityRuleConfig`
 
 ```typescript
-export interface CrmPriorityRuleConfig {
-  buckets: CrmPriorityBucketDefinition[]
-  closedStageKeys: string[]
-  followUpAfterDaysByStateKey: Record<string, number>
-  staleAfterDays: number
+export interface CrmPriorityRuleConfig {
+  buckets: CrmPriorityBucketDefinition[]
+  closedStageKeys: string[]
+  followUpAfterDaysByStateKey: Record<string, number>
+  staleAfterDays: number
 }
 ```
 
 ### `CRM_PRIORITY_BUCKETS`
 
 ```typescript
-export const CRM_PRIORITY_BUCKETS: CrmPriorityBucketDefinition[] = [
-  { bucketKey: 'needs_response', label: 'Needs Response', rank: 10, color: 'red' },
-  { bucketKey: 'follow_up_due', label: 'Follow-up Due', rank: 20, color: 'orange' },
-  { bucketKey: 'waiting', label: 'Waiting', rank: 30, color: 'blue' },
-  { bucketKey: 'stale', label: 'Stale', rank: 40, color: 'gray' },
-  { bucketKey: 'closed_low', label: 'Closed', rank: 50, color: 'dark' }
+export const CRM_PRIORITY_BUCKETS: CrmPriorityBucketDefinition[] = [
+  { bucketKey: 'needs_response', label: 'Needs Response', rank: 10, color: 'red' },
+  { bucketKey: 'follow_up_due', label: 'Follow-up Due', rank: 20, color: 'orange' },
+  { bucketKey: 'waiting', label: 'Waiting', rank: 30, color: 'blue' },
+  { bucketKey: 'stale', label: 'Stale', rank: 40, color: 'gray' },
+  { bucketKey: 'closed_low', label: 'Closed', rank: 50, color: 'dark' }
 ]
 ```
 
 ### `DEFAULT_CRM_PRIORITY_RULE_CONFIG`
 
 ```typescript
-export const DEFAULT_CRM_PRIORITY_RULE_CONFIG: CrmPriorityRuleConfig = {
-  buckets: CRM_PRIORITY_BUCKETS,
-  closedStageKeys: ['closed_won', 'closed_lost'],
-  followUpAfterDaysByStateKey: {
-    discovery_link_sent: 3,
-    discovery_nudging: 2,
-    reply_sent: 3,
-    followup_1_sent: 3,
-    followup_2_sent: 5,
-    followup_3_sent: 7
-  },
-  staleAfterDays: 14
+export const DEFAULT_CRM_PRIORITY_RULE_CONFIG: CrmPriorityRuleConfig = {
+  buckets: CRM_PRIORITY_BUCKETS,
+  closedStageKeys: ['closed_won', 'closed_lost'],
+  followUpAfterDaysByStateKey: {
+    discovery_link_sent: 3,
+    discovery_nudging: 2,
+    reply_sent: 3,
+    followup_1_sent: 3,
+    followup_2_sent: 5,
+    followup_3_sent: 7
+  },
+  staleAfterDays: 14
 }
 ```
 
@@ -1567,242 +1597,242 @@ export const AcqDealTaskKindSchema = z.enum(['call', 'email', 'meeting', 'other'
 ### `DealIdParamsSchema`
 
 ```typescript
-export const DealIdParamsSchema = z.object({
-  dealId: UuidSchema
+export const DealIdParamsSchema = z.object({
+  dealId: UuidSchema
 })
 ```
 
 ### `DealTaskIdParamsSchema`
 
 ```typescript
-export const DealTaskIdParamsSchema = z.object({
-  dealId: UuidSchema,
-  taskId: UuidSchema
+export const DealTaskIdParamsSchema = z.object({
+  dealId: UuidSchema,
+  taskId: UuidSchema
 })
 ```
 
 ### `ListDealsQuerySchema`
 
 ```typescript
-export const ListDealsQuerySchema = z
-  .object({
-    stage: DealStageSchema.optional(),
-    list: UuidSchema.optional(),
-    batch: z.string().trim().min(1).max(255).optional(),
-    staleSince: z.string().datetime().optional(),
-    search: z.string().optional(),
-    limit: z.coerce.number().int().positive().default(50),
-    offset: z.coerce.number().int().min(0).default(0)
-  })
+export const ListDealsQuerySchema = z
+  .object({
+    stage: DealStageSchema.optional(),
+    list: UuidSchema.optional(),
+    batch: z.string().trim().min(1).max(255).optional(),
+    staleSince: z.string().datetime().optional(),
+    search: z.string().optional(),
+    limit: z.coerce.number().int().positive().default(50),
+    offset: z.coerce.number().int().min(0).default(0)
+  })
   .strict()
 ```
 
 ### `DealLookupQuerySchema`
 
 ```typescript
-export const DealLookupQuerySchema = z
-  .object({
-    search: z.string().trim().min(1).max(200).optional(),
-    limit: z.coerce.number().int().min(1).max(25).default(10)
-  })
+export const DealLookupQuerySchema = z
+  .object({
+    search: z.string().trim().min(1).max(200).optional(),
+    limit: z.coerce.number().int().min(1).max(25).default(10)
+  })
   .strict()
 ```
 
 ### `ListDealTasksDueQuerySchema`
 
 ```typescript
-export const ListDealTasksDueQuerySchema = z
-  .object({
-    window: z.enum(['overdue', 'today', 'today_and_overdue', 'upcoming']).optional(),
-    assigneeUserId: UuidSchema.optional()
-  })
+export const ListDealTasksDueQuerySchema = z
+  .object({
+    window: z.enum(['overdue', 'today', 'today_and_overdue', 'upcoming']).optional(),
+    assigneeUserId: UuidSchema.optional()
+  })
   .strict()
 ```
 
 ### `CreateDealNoteRequestSchema`
 
 ```typescript
-export const CreateDealNoteRequestSchema = z
-  .object({
-    body: z.string().trim().min(1).max(10000)
-  })
+export const CreateDealNoteRequestSchema = z
+  .object({
+    body: z.string().trim().min(1).max(10000)
+  })
   .strict()
 ```
 
 ### `CreateDealTaskRequestSchema`
 
 ```typescript
-export const CreateDealTaskRequestSchema = z
-  .object({
-    title: z.string().trim().min(1).max(255),
-    description: z.string().nullable().optional(),
-    kind: AcqDealTaskKindSchema.optional(),
-    dueAt: z.string().datetime().nullable().optional(),
-    assigneeUserId: UuidSchema.nullable().optional()
-  })
+export const CreateDealTaskRequestSchema = z
+  .object({
+    title: z.string().trim().min(1).max(255),
+    description: z.string().nullable().optional(),
+    kind: AcqDealTaskKindSchema.optional(),
+    dueAt: z.string().datetime().nullable().optional(),
+    assigneeUserId: UuidSchema.nullable().optional()
+  })
   .strict()
 ```
 
 ### `TransitionItemRequestSchema`
 
 ```typescript
-export const TransitionItemRequestSchema = z
-  .object({
-    pipelineKey: z.string().min(1),
-    stageKey: z.string().min(1),
-    stateKey: z.string().min(1).nullable().optional(),
-    reason: z.string().optional(),
-    expectedUpdatedAt: z.string().datetime().optional()
-  })
+export const TransitionItemRequestSchema = z
+  .object({
+    pipelineKey: z.string().min(1),
+    stageKey: z.string().min(1),
+    stateKey: z.string().min(1).nullable().optional(),
+    reason: z.string().optional(),
+    expectedUpdatedAt: z.string().datetime().optional()
+  })
   .strict()
 ```
 
 ### `ExecuteActionParamsSchema`
 
 ```typescript
-export const ExecuteActionParamsSchema = z
-  .object({
-    dealId: UuidSchema,
-    actionKey: NonEmptyStringSchema
-  })
+export const ExecuteActionParamsSchema = z
+  .object({
+    dealId: UuidSchema,
+    actionKey: NonEmptyStringSchema
+  })
   .strict()
 ```
 
 ### `ExecuteActionRequestSchema`
 
 ```typescript
-export const ExecuteActionRequestSchema = z
-  .object({
-    payload: z.record(z.string(), z.unknown()).optional()
-  })
+export const ExecuteActionRequestSchema = z
+  .object({
+    payload: z.record(z.string(), z.unknown()).optional()
+  })
   .strict()
 ```
 
 ### `DealContactSummarySchema`
 
 ```typescript
-/**
- * Contact summary nested inside DealListItem / DealDetailResponse.
- * Matches the joined shape returned by useDeals / useDealDetail Supabase queries.
- */
-export const DealContactSummarySchema = z.object({
-  id: z.string(),
-  first_name: z.string().nullable(),
-  last_name: z.string().nullable(),
-  email: z.string(),
-  title: z.string().nullable(),
-  headline: z.string().nullable(),
-  linkedin_url: z.string().nullable(),
-  processing_state: ProcessingStateSchema.nullable(),
-  enrichment_data: z.record(z.string(), z.unknown()).nullable(),
-  company: z
-    .object({
-      id: z.string(),
-      name: z.string(),
-      domain: z.string().nullable(),
-      website: z.string().nullable(),
-      linkedin_url: z.string().nullable(),
-      segment: z.string().nullable(),
-      category: z.string().nullable(),
-      num_employees: z.number().nullable()
-    })
-    .nullable()
+/**
+ * Contact summary nested inside DealListItem / DealDetailResponse.
+ * Matches the joined shape returned by useDeals / useDealDetail Supabase queries.
+ */
+export const DealContactSummarySchema = z.object({
+  id: z.string(),
+  first_name: z.string().nullable(),
+  last_name: z.string().nullable(),
+  email: z.string(),
+  title: z.string().nullable(),
+  headline: z.string().nullable(),
+  linkedin_url: z.string().nullable(),
+  processing_state: ProcessingStateSchema.nullable(),
+  enrichment_data: z.record(z.string(), z.unknown()).nullable(),
+  company: z
+    .object({
+      id: z.string(),
+      name: z.string(),
+      domain: z.string().nullable(),
+      website: z.string().nullable(),
+      linkedin_url: z.string().nullable(),
+      segment: z.string().nullable(),
+      category: z.string().nullable(),
+      num_employees: z.number().nullable()
+    })
+    .nullable()
 })
 ```
 
 ### `DealPrioritySchema`
 
 ```typescript
-export const DealPrioritySchema = z.object({
-  bucketKey: z.enum(['needs_response', 'follow_up_due', 'waiting', 'stale', 'closed_low']),
-  rank: z.number().int(),
-  label: z.string(),
-  color: z.string(),
-  reason: z.string(),
-  latestActivityAt: z.string().nullable(),
-  nextActionAt: z.string().nullable()
+export const DealPrioritySchema = z.object({
+  bucketKey: z.enum(['needs_response', 'follow_up_due', 'waiting', 'stale', 'closed_low']),
+  rank: z.number().int(),
+  label: z.string(),
+  color: z.string(),
+  reason: z.string(),
+  latestActivityAt: z.string().nullable(),
+  nextActionAt: z.string().nullable()
 })
 ```
 
 ### `DealListItemSchema`
 
 ```typescript
-/**
- * Deal list item with joined contact (and company via contact).
- * Matches DealListItem from @repo/core types.
- */
-export const DealListItemSchema = z.object({
-  // acq_deals columns
-  id: z.string(),
-  organization_id: z.string(),
-  client_id: z.string().nullable().optional(),
-  contact_id: z.string().nullable(),
-  contact_email: z.string(),
-  pipeline_key: z.string(),
-  stage_key: z.string().nullable(),
-  state_key: z.string().nullable(),
-  activity_log: z.unknown(),
-  discovery_data: z.unknown().nullable(),
-  discovery_submitted_at: z.string().nullable(),
-  discovery_submitted_by: z.string().nullable(),
-  proposal_data: z.unknown().nullable(),
-  proposal_sent_at: z.string().nullable(),
-  proposal_pdf_url: z.string().nullable(),
-  signature_envelope_id: z.string().nullable(),
-  source_list_id: z.string().nullable(),
-  source_type: z.string().nullable(),
-  initial_fee: z.number().nullable(),
-  monthly_fee: z.number().nullable(),
-  closed_lost_at: z.string().nullable(),
-  closed_lost_reason: z.string().nullable(),
-  created_at: z.string(),
-  updated_at: z.string(),
-  priority: DealPrioritySchema,
-  ownership: z.enum(['us', 'them']).nullable(),
-  nextAction: z.string().nullable(),
-  // joined relation
-  contact: DealContactSummarySchema.nullable()
+/**
+ * Deal list item with joined contact (and company via contact).
+ * Matches DealListItem from @repo/core types.
+ */
+export const DealListItemSchema = z.object({
+  // acq_deals columns
+  id: z.string(),
+  organization_id: z.string(),
+  client_id: z.string().nullable().optional(),
+  contact_id: z.string().nullable(),
+  contact_email: z.string(),
+  pipeline_key: z.string(),
+  stage_key: z.string().nullable(),
+  state_key: z.string().nullable(),
+  activity_log: z.unknown(),
+  discovery_data: z.unknown().nullable(),
+  discovery_submitted_at: z.string().nullable(),
+  discovery_submitted_by: z.string().nullable(),
+  proposal_data: z.unknown().nullable(),
+  proposal_sent_at: z.string().nullable(),
+  proposal_pdf_url: z.string().nullable(),
+  signature_envelope_id: z.string().nullable(),
+  source_list_id: z.string().nullable(),
+  source_type: z.string().nullable(),
+  initial_fee: z.number().nullable(),
+  monthly_fee: z.number().nullable(),
+  closed_lost_at: z.string().nullable(),
+  closed_lost_reason: z.string().nullable(),
+  created_at: z.string(),
+  updated_at: z.string(),
+  priority: DealPrioritySchema,
+  ownership: z.enum(['us', 'them']).nullable(),
+  nextAction: z.string().nullable(),
+  // joined relation
+  contact: DealContactSummarySchema.nullable()
 })
 ```
 
 ### `DealListResponseSchema`
 
 ```typescript
-export const DealListResponseSchema = z.object({
-  data: z.array(DealListItemSchema),
-  total: z.number().int(),
-  limit: z.number().int(),
-  offset: z.number().int()
+export const DealListResponseSchema = z.object({
+  data: z.array(DealListItemSchema),
+  total: z.number().int(),
+  limit: z.number().int(),
+  offset: z.number().int()
 })
 ```
 
 ### `DealDetailResponseSchema`
 
 ```typescript
-/**
- * Deal detail shape — currently the same as a list item (full joined record).
- * Additive fields keep existing DealListItem callers compatible.
- */
-export const DealDetailResponseSchema = DealListItemSchema.extend({
-  conversation: DealConversationSchema,
-  lineage: DealLineageSchema.optional()
+/**
+ * Deal detail shape — currently the same as a list item (full joined record).
+ * Additive fields keep existing DealListItem callers compatible.
+ */
+export const DealDetailResponseSchema = DealListItemSchema.extend({
+  conversation: DealConversationSchema,
+  lineage: DealLineageSchema.optional()
 })
 ```
 
 ### `DealNoteResponseSchema`
 
 ```typescript
-/**
- * Single acq_deal_notes row (camelCase API representation).
- */
-export const DealNoteResponseSchema = z.object({
-  id: z.string(),
-  dealId: z.string(),
-  organizationId: z.string(),
-  authorUserId: z.string().nullable(),
-  body: z.string(),
-  createdAt: z.string(),
-  updatedAt: z.string()
+/**
+ * Single acq_deal_notes row (camelCase API representation).
+ */
+export const DealNoteResponseSchema = z.object({
+  id: z.string(),
+  dealId: z.string(),
+  organizationId: z.string(),
+  authorUserId: z.string().nullable(),
+  body: z.string(),
+  createdAt: z.string(),
+  updatedAt: z.string()
 })
 ```
 
@@ -1815,24 +1845,24 @@ export const DealNoteListResponseSchema = z.array(DealNoteResponseSchema)
 ### `DealTaskResponseSchema`
 
 ```typescript
-/**
- * Single acq_deal_tasks row (camelCase API representation).
- * Matches AcqDealTask domain type from types.ts.
- */
-export const DealTaskResponseSchema = z.object({
-  id: z.string(),
-  organizationId: z.string(),
-  dealId: z.string(),
-  title: z.string(),
-  description: z.string().nullable(),
-  kind: AcqDealTaskKindSchema,
-  dueAt: z.string().nullable(),
-  assigneeUserId: z.string().nullable(),
-  completedAt: z.string().nullable(),
-  completedByUserId: z.string().nullable(),
-  createdAt: z.string(),
-  updatedAt: z.string(),
-  createdByUserId: z.string().nullable()
+/**
+ * Single acq_deal_tasks row (camelCase API representation).
+ * Matches AcqDealTask domain type from types.ts.
+ */
+export const DealTaskResponseSchema = z.object({
+  id: z.string(),
+  organizationId: z.string(),
+  dealId: z.string(),
+  title: z.string(),
+  description: z.string().nullable(),
+  kind: AcqDealTaskKindSchema,
+  dueAt: z.string().nullable(),
+  assigneeUserId: z.string().nullable(),
+  completedAt: z.string().nullable(),
+  completedByUserId: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+  createdByUserId: z.string().nullable()
 })
 ```
 
@@ -1845,44 +1875,44 @@ export const DealTaskListResponseSchema = z.array(DealTaskResponseSchema)
 ### `DealSchemas`
 
 ```typescript
-export const DealSchemas = {
-  // Primitives
-  CrmStageKey: CrmStageKeySchema,
-  CrmStateKey: CrmStateKeySchema,
-  DealStage: DealStageSchema,
-
-  // Params
-  DealIdParams: DealIdParamsSchema,
-  DealTaskIdParams: DealTaskIdParamsSchema,
-
-  // Queries
-  ListDealsQuery: ListDealsQuerySchema,
-  DealLookupQuery: DealLookupQuerySchema,
-  ListDealTasksDueQuery: ListDealTasksDueQuerySchema,
-
-  // Request bodies
-  CreateDealNoteRequest: CreateDealNoteRequestSchema,
-  CreateDealTaskRequest: CreateDealTaskRequestSchema,
-  TransitionItemRequest: CrmTransitionItemRequestSchema,
-  TransitionDealStateRequest: TransitionDealStateRequestSchema,
-  ExecuteActionParams: ExecuteActionParamsSchema,
-  ExecuteActionRequest: ExecuteActionRequestSchema,
-
-  // Responses
-  DealPriority: DealPrioritySchema,
-  DealListResponse: DealListResponseSchema,
-  DealSummaryResponse: DealSummaryResponseSchema,
-  DealLookupResponse: DealLookupResponseSchema,
-  ConversationMessage: ConversationMessageSchema,
-  DealLineageListRef: DealLineageListRefSchema,
-  DealLineageProjectRef: DealLineageProjectRefSchema,
-  DealLineageClientRef: DealLineageClientRefSchema,
-  DealLineage: DealLineageSchema,
-  DealDetailResponse: DealDetailResponseSchema,
-  DealNoteResponse: DealNoteResponseSchema,
-  DealNoteListResponse: DealNoteListResponseSchema,
-  DealTaskResponse: DealTaskResponseSchema,
-  DealTaskListResponse: DealTaskListResponseSchema
+export const DealSchemas = {
+  // Primitives
+  CrmStageKey: CrmStageKeySchema,
+  CrmStateKey: CrmStateKeySchema,
+  DealStage: DealStageSchema,
+
+  // Params
+  DealIdParams: DealIdParamsSchema,
+  DealTaskIdParams: DealTaskIdParamsSchema,
+
+  // Queries
+  ListDealsQuery: ListDealsQuerySchema,
+  DealLookupQuery: DealLookupQuerySchema,
+  ListDealTasksDueQuery: ListDealTasksDueQuerySchema,
+
+  // Request bodies
+  CreateDealNoteRequest: CreateDealNoteRequestSchema,
+  CreateDealTaskRequest: CreateDealTaskRequestSchema,
+  TransitionItemRequest: CrmTransitionItemRequestSchema,
+  TransitionDealStateRequest: TransitionDealStateRequestSchema,
+  ExecuteActionParams: ExecuteActionParamsSchema,
+  ExecuteActionRequest: ExecuteActionRequestSchema,
+
+  // Responses
+  DealPriority: DealPrioritySchema,
+  DealListResponse: DealListResponseSchema,
+  DealSummaryResponse: DealSummaryResponseSchema,
+  DealLookupResponse: DealLookupResponseSchema,
+  ConversationMessage: ConversationMessageSchema,
+  DealLineageListRef: DealLineageListRefSchema,
+  DealLineageProjectRef: DealLineageProjectRefSchema,
+  DealLineageClientRef: DealLineageClientRefSchema,
+  DealLineage: DealLineageSchema,
+  DealDetailResponse: DealDetailResponseSchema,
+  DealNoteResponse: DealNoteResponseSchema,
+  DealNoteListResponse: DealNoteListResponseSchema,
+  DealTaskResponse: DealTaskResponseSchema,
+  DealTaskListResponse: DealTaskListResponseSchema
 }
 ```
 
@@ -1899,12 +1929,12 @@ export interface Action {
 ### `ActionDef`
 
 ```typescript
-export interface ActionDef {
-  key: string
-  label: string
-  isAvailableFor: (deal: AcqDealRow) => boolean
-  workflowId: string
-  payloadSchema?: z.ZodTypeAny
+export interface ActionDef {
+  key: string
+  label: string
+  isAvailableFor: (deal: AcqDealRow) => boolean
+  workflowId: string
+  payloadSchema?: z.ZodTypeAny
 }
 ```
 
@@ -1912,66 +1942,42 @@ export interface ActionDef {
 
 ```typescript
 export const DEFAULT_CRM_ACTIONS: ActionDef[] = [
-  {
-    key: 'move_to_proposal',
-    label: 'Move to Proposal',
-    isAvailableFor: (deal) => deal.stage_key === 'interested',
-    workflowId: 'move_to_proposal-workflow'
-  },
-  {
-    key: 'move_to_closing',
-    label: 'Move to Closing',
-    isAvailableFor: (deal) => deal.stage_key === 'proposal',
-    workflowId: 'move_to_closing-workflow'
-  },
-  {
-    key: 'move_to_closed_won',
-    label: 'Close Won',
-    isAvailableFor: (deal) => deal.stage_key === 'closing',
-    workflowId: 'move_to_closed_won-workflow'
-  },
-  {
-    key: 'move_to_closed_lost',
-    label: 'Close Lost',
+  crmAction('move_to_proposal', {
+    isAvailableFor: (deal) => deal.stage_key === 'interested'
+  }),
+  crmAction('move_to_closing', {
+    isAvailableFor: (deal) => deal.stage_key === 'proposal'
+  }),
+  crmAction('move_to_closed_won', {
+    isAvailableFor: (deal) => deal.stage_key === 'closing'
+  }),
+  crmAction('move_to_closed_lost', {
     isAvailableFor: (deal) =>
-      deal.stage_key === 'interested' || deal.stage_key === 'proposal' || deal.stage_key === 'closing',
-    workflowId: 'move_to_closed_lost-workflow'
-  },
-  {
-    key: 'move_to_nurturing',
-    label: 'Move to Nurturing',
+      deal.stage_key === 'interested' || deal.stage_key === 'proposal' || deal.stage_key === 'closing'
+  }),
+  crmAction('move_to_nurturing', {
     isAvailableFor: (deal) =>
-      deal.stage_key === 'interested' || deal.stage_key === 'proposal' || deal.stage_key === 'closing',
-    workflowId: 'move_to_nurturing-workflow'
-  },
-  {
-    key: 'send_reply',
-    label: 'Send Reply',
-    isAvailableFor: (deal) =>
-      deal.stage_key === 'interested' &&
-      isOurReplyAction(deal) &&
-      (deal.state_key === CRM_DISCOVERY_REPLIED_STATE.stateKey ||
-        deal.state_key === CRM_DISCOVERY_LINK_SENT_STATE.stateKey ||
-        deal.state_key === CRM_DISCOVERY_NUDGING_STATE.stateKey),
-    workflowId: 'crm-send-reply-workflow',
+      deal.stage_key === 'interested' || deal.stage_key === 'proposal' || deal.stage_key === 'closing'
+  }),
+  crmAction('send_reply', {
+    isAvailableFor: (deal) =>
+      deal.stage_key === 'interested' &&
+      isOurReplyAction(deal) &&
+      (deal.state_key === CRM_DISCOVERY_REPLIED_STATE.stateKey ||
+        deal.state_key === CRM_DISCOVERY_LINK_SENT_STATE.stateKey ||
+        deal.state_key === CRM_DISCOVERY_NUDGING_STATE.stateKey),
     payloadSchema: SendReplyActionPayloadSchema
-  },
-  {
-    key: 'send_link',
-    label: 'Send Booking Link',
+  }),
+  crmAction('send_link', {
     isAvailableFor: (deal) =>
-      deal.stage_key === 'interested' && deal.state_key === CRM_DISCOVERY_REPLIED_STATE.stateKey,
-    workflowId: 'crm-send-booking-link-workflow'
-  },
-  {
-    key: 'send_nudge',
-    label: 'Send Nudge',
+      deal.stage_key === 'interested' && deal.state_key === CRM_DISCOVERY_REPLIED_STATE.stateKey
+  }),
+  crmAction('send_nudge', {
     isAvailableFor: (deal) =>
       deal.stage_key === 'interested' &&
       (deal.state_key === CRM_DISCOVERY_LINK_SENT_STATE.stateKey ||
-        deal.state_key === CRM_DISCOVERY_NUDGING_STATE.stateKey),
-    workflowId: 'crm-send-nudge-workflow'
-  },
+        deal.state_key === CRM_DISCOVERY_NUDGING_STATE.stateKey)
+  }),
   {
     key: 'mark_no_show',
     label: 'Mark No-Show',
@@ -1982,32 +1988,29 @@ export const DEFAULT_CRM_ACTIONS: ActionDef[] = [
     // event captures operator intent and distinguishes the manual variant from the timed one.
     workflowId: 'mark_no_show-workflow'
   },
-  {
-    key: 'rebook',
-    label: 'Rebook',
+  crmAction('rebook', {
     isAvailableFor: (deal) =>
-      deal.stage_key === 'interested' && deal.state_key === CRM_DISCOVERY_BOOKING_CANCELLED_STATE.stateKey,
-    workflowId: 'crm-rebook-workflow'
-  }
+      deal.stage_key === 'interested' && deal.state_key === CRM_DISCOVERY_BOOKING_CANCELLED_STATE.stateKey
+  })
 ]
 ```
 
 ### `CrmToolMap`
 
 ```typescript
-export type CrmToolMap = {
-  getRecentActivity: { params: CrmRecentActivityParams; result: RecentActivityEntry[] }
-  listDeals: { params: CrmListDealsParams; result: DealListItem[] }
-  getDeal: { params: CrmGetDealParams; result: DealDetail | null }
-  getDealByEmail: { params: CrmGetDealByEmailParams; result: DealDetail | null }
-  createDealNote: { params: CrmDealNoteParams; result: AcqDealNote }
-  listDealNotes: { params: Omit<ListDealNotesParams, 'organizationId'>; result: AcqDealNote[] }
-  createDealTask: { params: CrmDealTaskParams; result: AcqDealTask }
-  listDealTasks: { params: Omit<ListDealTasksParams, 'organizationId'>; result: AcqDealTask[] }
-  listDealTasksDue: { params: CrmTaskDueParams; result: AcqDealTask[] }
-  completeDealTask: { params: Omit<CompleteDealTaskParams, 'organizationId'>; result: AcqDealTask }
-  recordActivity: { params: CrmRecordActivityParams; result: void }
-  deleteDeal: { params: CrmDeleteDealParams; result: void }
+export type CrmToolMap = {
+  getRecentActivity: { params: CrmRecentActivityParams; result: RecentActivityEntry[] }
+  listDeals: { params: CrmListDealsParams; result: DealListItem[] }
+  getDeal: { params: CrmGetDealParams; result: DealDetail | null }
+  getDealByEmail: { params: CrmGetDealByEmailParams; result: DealDetail | null }
+  createDealNote: { params: CrmDealNoteParams; result: AcqDealNote }
+  listDealNotes: { params: Omit<ListDealNotesParams, 'organizationId'>; result: AcqDealNote[] }
+  createDealTask: { params: CrmDealTaskParams; result: AcqDealTask }
+  listDealTasks: { params: Omit<ListDealTasksParams, 'organizationId'>; result: AcqDealTask[] }
+  listDealTasksDue: { params: CrmTaskDueParams; result: AcqDealTask[] }
+  completeDealTask: { params: Omit<CompleteDealTaskParams, 'organizationId'>; result: AcqDealTask }
+  recordActivity: { params: CrmRecordActivityParams; result: void }
+  deleteDeal: { params: CrmDeleteDealParams; result: void }
 }
 ```
 
@@ -2016,402 +2019,402 @@ export type CrmToolMap = {
 ### `WebPost`
 
 ```typescript
-/**
- * Represents a web post from company website scraping.
- * Used for recent blog posts, news, or announcements.
- */
-export interface WebPost {
-  /** ISO date string of when the post was published */
-  date: string
-  /** Title of the web post */
-  title: string
-  /** Brief summary of the post content */
-  summary: string
-  /** AI-generated insight about the post's relevance */
-  aiInsight?: string
+/**
+ * Represents a web post from company website scraping.
+ * Used for recent blog posts, news, or announcements.
+ */
+export interface WebPost {
+  /** ISO date string of when the post was published */
+  date: string
+  /** Title of the web post */
+  title: string
+  /** Brief summary of the post content */
+  summary: string
+  /** AI-generated insight about the post's relevance */
+  aiInsight?: string
 }
 ```
 
 ### `CompanyEnrichmentData`
 
 ```typescript
-/**
- * Enrichment data collected for a company from various sources.
- */
-export interface CompanyEnrichmentData {
-  googleMaps?: {
-    placeId?: string
-    totalScore?: number
-    reviewsCount?: number
-    address?: string
-    phone?: string
-    categoryName?: string
-    googleMapsUrl?: string
-    scrapedAt?: string
-  }
-  websiteCrawl?: {
-    companyDescription?: string
-    services?: string[]
-    specialties?: string[]
-    staff?: Array<{ name: string; title?: string; email?: string }>
-    automationGaps?: string[]
-    targetAudience?: string
-    category?: string
-    segment?: string
-    recentWin?: string
-    emailCount?: number
-    pageCount?: number
-    totalChars?: number
-    crawledAt?: string
-    extractedAt?: string
-  }
-  website?: {
-    missionVision?: string
-    uniqueAttributes?: string
-    coreOfferings?: string
-    targetAudience?: string
-    companyValues?: string
-    businessDescription?: string
-    recentPosts?: Array<{ date?: string; title?: string; summary?: string; aiInsight?: string }>
-  }
-  tomba?: {
-    waterfallEmail?: {
-      email: string
-      name?: string
-      title?: string
-      department?: string
-    } | null
-    genericEmail?: string | null
-    totalFound?: number
-    searchedAt?: string
-  }
+/**
+ * Enrichment data collected for a company from various sources.
+ */
+export interface CompanyEnrichmentData {
+  googleMaps?: {
+    placeId?: string
+    totalScore?: number
+    reviewsCount?: number
+    address?: string
+    phone?: string
+    categoryName?: string
+    googleMapsUrl?: string
+    scrapedAt?: string
+  }
+  websiteCrawl?: {
+    companyDescription?: string
+    services?: string[]
+    specialties?: string[]
+    staff?: Array<{ name: string; title?: string; email?: string }>
+    automationGaps?: string[]
+    targetAudience?: string
+    category?: string
+    segment?: string
+    recentWin?: string
+    emailCount?: number
+    pageCount?: number
+    totalChars?: number
+    crawledAt?: string
+    extractedAt?: string
+  }
+  website?: {
+    missionVision?: string
+    uniqueAttributes?: string
+    coreOfferings?: string
+    targetAudience?: string
+    companyValues?: string
+    businessDescription?: string
+    recentPosts?: Array<{ date?: string; title?: string; summary?: string; aiInsight?: string }>
+  }
+  tomba?: {
+    waterfallEmail?: {
+      email: string
+      name?: string
+      title?: string
+      department?: string
+    } | null
+    genericEmail?: string | null
+    totalFound?: number
+    searchedAt?: string
+  }
 }
 ```
 
 ### `ContactEnrichmentData`
 
 ```typescript
-/**
- * Enrichment data collected for a contact from various sources.
- */
-export interface ContactEnrichmentData {
-  linkedin?: {
-    summary?: string
-    pastExperience?: string
-    education?: string
-    activity?: Array<{ date?: string; content?: string }>
-  }
+/**
+ * Enrichment data collected for a contact from various sources.
+ */
+export interface ContactEnrichmentData {
+  linkedin?: {
+    summary?: string
+    pastExperience?: string
+    education?: string
+    activity?: Array<{ date?: string; content?: string }>
+  }
 }
 ```
 
 ### `AcqList`
 
 ```typescript
-export interface AcqList {
-  id: string
-  organizationId: string
-  name: string
-  description: string | null
-  batchIds: string[]
-  instantlyCampaignId: string | null
-  status: ListStatus
-  scrapingConfig: ScrapingConfig
-  icp: IcpRubric
-  pipelineConfig: PipelineConfig
-  metadata: AcqListMetadata
-  launchedAt: Date | null
-  completedAt: Date | null
-  createdAt: Date
+export interface AcqList {
+  id: string
+  organizationId: string
+  name: string
+  description: string | null
+  batchIds: string[]
+  instantlyCampaignId: string | null
+  status: ListStatus
+  scrapingConfig: ScrapingConfig
+  icp: IcpRubric
+  pipelineConfig: PipelineConfig
+  metadata: AcqListMetadata
+  launchedAt: Date | null
+  completedAt: Date | null
+  createdAt: Date
 }
 ```
 
 ### `AcqCompany`
 
 ```typescript
-/**
- * Company record in the acquisition database.
- * Contains enriched company data from various sources.
- * Transformed from AcqCompanyRow with camelCase properties.
- */
-export interface AcqCompany {
-  id: string
-  organizationId: string
-  name: string
-  domain: string | null
-  linkedinUrl: string | null
-  website: string | null
-  numEmployees: number | null
-  foundedYear: number | null
-  locationCity: string | null
-  locationState: string | null
-  category: string | null
-  categoryPain: string | null
-  segment: string | null
-  processingState: CompanyProcessingState | null
-  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
-  pipelineStatus?: LegacyPipelineStatus | null
-  enrichmentData: CompanyEnrichmentData | null
-  source: string | null
-  batchId: string | null
-  status: 'active' | 'invalid'
-  verticalResearch: string | null
-  /** Track A: flat qualification score (null until a scoring rubric is defined). Added by W1 migration. */
-  qualificationScore: number | null
-  /** Track A: flat qualification signals jsonb preserving the result payload shape. Added by W1 migration. */
-  qualificationSignals: Record<string, unknown> | null
-  /** Track A: key identifying the rubric used for qualification. Added by W1 migration. */
-  qualificationRubricKey: string | null
-  createdAt: Date
-  updatedAt: Date
+/**
+ * Company record in the acquisition database.
+ * Contains enriched company data from various sources.
+ * Transformed from AcqCompanyRow with camelCase properties.
+ */
+export interface AcqCompany {
+  id: string
+  organizationId: string
+  name: string
+  domain: string | null
+  linkedinUrl: string | null
+  website: string | null
+  numEmployees: number | null
+  foundedYear: number | null
+  locationCity: string | null
+  locationState: string | null
+  category: string | null
+  categoryPain: string | null
+  segment: string | null
+  processingState: CompanyProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
+  enrichmentData: CompanyEnrichmentData | null
+  source: string | null
+  batchId: string | null
+  status: 'active' | 'invalid'
+  verticalResearch: string | null
+  /** Track A: flat qualification score (null until a scoring rubric is defined). Added by W1 migration. */
+  qualificationScore: number | null
+  /** Track A: flat qualification signals jsonb preserving the result payload shape. Added by W1 migration. */
+  qualificationSignals: Record<string, unknown> | null
+  /** Track A: key identifying the rubric used for qualification. Added by W1 migration. */
+  qualificationRubricKey: string | null
+  createdAt: Date
+  updatedAt: Date
 }
 ```
 
 ### `AcqContact`
 
 ```typescript
-/**
- * Contact record in the acquisition database.
- * Contains enriched contact data and personalization content.
- * Transformed from AcqContactRow with camelCase properties.
- */
-export interface AcqContact {
-  id: string
-  organizationId: string
-  companyId: string | null
-  email: string
-  emailValid: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN' | null
-  firstName: string | null
-  lastName: string | null
-  linkedinUrl: string | null
-  title: string | null
-  headline: string | null
-  filterReason: string | null
-  openingLine: string | null
-  source: string | null
-  sourceId: string | null
-  processingState: ContactProcessingState | null
-  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
-  pipelineStatus?: LegacyPipelineStatus | null
-  enrichmentData: ContactEnrichmentData | null
-  /** Attio Person record ID - set when contact responds and is added to CRM */
-  attioPersonId: string | null
-  batchId: string | null
-  status: 'active' | 'invalid'
-  createdAt: Date
-  updatedAt: Date
+/**
+ * Contact record in the acquisition database.
+ * Contains enriched contact data and personalization content.
+ * Transformed from AcqContactRow with camelCase properties.
+ */
+export interface AcqContact {
+  id: string
+  organizationId: string
+  companyId: string | null
+  email: string
+  emailValid: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN' | null
+  firstName: string | null
+  lastName: string | null
+  linkedinUrl: string | null
+  title: string | null
+  headline: string | null
+  filterReason: string | null
+  openingLine: string | null
+  source: string | null
+  sourceId: string | null
+  processingState: ContactProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
+  enrichmentData: ContactEnrichmentData | null
+  /** Attio Person record ID - set when contact responds and is added to CRM */
+  attioPersonId: string | null
+  batchId: string | null
+  status: 'active' | 'invalid'
+  createdAt: Date
+  updatedAt: Date
 }
 ```
 
 ### `ListTelemetry`
 
 ```typescript
-/**
- * Live-scan aggregate telemetry for a single list, computed on demand from
- * the list junction tables and current contact deliverability state.
- * `stageCounts` are attempted counts from list-row processing_state.
- */
-export interface ListTelemetry {
-  listId: string
-  totalCompanies: number
-  totalContacts: number
-  stageCounts: {
-    populated: number
-    extracted: number
-    qualified: number
-    discovered: number
-    verified: number
-    personalized: number
-    uploaded: number
-  }
-  deliverability: {
-    valid: number
-    risky: number
-    invalid: number
-    unknown: number
-    bounced: number
-  }
-  /** Reserved -- active workflow IDs associated with this list. */
-  activeWorkflows?: string[]
+/**
+ * Live-scan aggregate telemetry for a single list, computed on demand from
+ * the list junction tables and current contact deliverability state.
+ * `stageCounts` are attempted counts from list-row processing_state.
+ */
+export interface ListTelemetry {
+  listId: string
+  totalCompanies: number
+  totalContacts: number
+  stageCounts: {
+    populated: number
+    extracted: number
+    qualified: number
+    discovered: number
+    verified: number
+    personalized: number
+    uploaded: number
+  }
+  deliverability: {
+    valid: number
+    risky: number
+    invalid: number
+    unknown: number
+    bounced: number
+  }
+  /** Reserved -- active workflow IDs associated with this list. */
+  activeWorkflows?: string[]
 }
 ```
 
 ### `ListStageCountsSchema`
 
 ```typescript
-export const ListStageCountsSchema = z.object({
-  // Attempted counts by canonical lead-gen stage. The detailed status
-  // distribution lives on ListProgress; telemetry keeps the overview payload small.
-  stageCounts: z.object({
-    populated: z.number().int(),
-    extracted: z.number().int(),
-    qualified: z.number().int(),
-    discovered: z.number().int(),
-    verified: z.number().int(),
-    personalized: z.number().int(),
-    uploaded: z.number().int()
-  }),
-  deliverability: z.object({
-    valid: z.number().int(),
-    risky: z.number().int(),
-    invalid: z.number().int(),
-    unknown: z.number().int(),
-    bounced: z.number().int()
-  })
+export const ListStageCountsSchema = z.object({
+  // Attempted counts by canonical lead-gen stage. The detailed status
+  // distribution lives on ListProgress; telemetry keeps the overview payload small.
+  stageCounts: z.object({
+    populated: z.number().int(),
+    extracted: z.number().int(),
+    qualified: z.number().int(),
+    discovered: z.number().int(),
+    verified: z.number().int(),
+    personalized: z.number().int(),
+    uploaded: z.number().int()
+  }),
+  deliverability: z.object({
+    valid: z.number().int(),
+    risky: z.number().int(),
+    invalid: z.number().int(),
+    unknown: z.number().int(),
+    bounced: z.number().int()
+  })
 })
 ```
 
 ### `ListTelemetrySchema`
 
 ```typescript
-export const ListTelemetrySchema = z.object({
-  listId: UuidSchema,
-  totalCompanies: z.number().int(),
-  totalContacts: z.number().int(),
-  stageCounts: ListStageCountsSchema.shape.stageCounts,
-  deliverability: ListStageCountsSchema.shape.deliverability,
-  activeWorkflows: z.array(z.string()).optional()
+export const ListTelemetrySchema = z.object({
+  listId: UuidSchema,
+  totalCompanies: z.number().int(),
+  totalContacts: z.number().int(),
+  stageCounts: ListStageCountsSchema.shape.stageCounts,
+  deliverability: ListStageCountsSchema.shape.deliverability,
+  activeWorkflows: z.array(z.string()).optional()
 })
 ```
 
 ### `ListIdParamsSchema`
 
 ```typescript
-export const ListIdParamsSchema = z.object({
-  listId: UuidSchema
+export const ListIdParamsSchema = z.object({
+  listId: UuidSchema
 })
 ```
 
 ### `CreateListRequestSchema`
 
 ```typescript
-export const CreateListRequestSchema = z
-  .object({
-    name: z.string().trim().min(1).max(255),
-    description: z.string().trim().nullable().optional(),
-    status: ListStatusSchema.optional(),
-    buildTemplateId: ProspectingBuildTemplateIdSchema.optional(),
-    scrapingConfig: ScrapingConfigSchema.optional(),
-    icp: IcpRubricSchema.optional(),
-    pipelineConfig: PipelineConfigSchema.optional()
-  })
+export const CreateListRequestSchema = z
+  .object({
+    name: z.string().trim().min(1).max(255),
+    description: z.string().trim().nullable().optional(),
+    status: ListStatusSchema.optional(),
+    buildTemplateId: ProspectingBuildTemplateIdSchema.optional(),
+    scrapingConfig: ScrapingConfigSchema.optional(),
+    icp: IcpRubricSchema.optional(),
+    pipelineConfig: PipelineConfigSchema.optional()
+  })
   .strict()
 ```
 
 ### `UpdateListRequestSchema`
 
 ```typescript
-export const UpdateListRequestSchema = z
-  .object({
-    name: z.string().trim().min(1).max(255).optional(),
-    description: z.string().trim().nullable().optional(),
-    batchIds: z.array(z.string()).optional(),
-    buildTemplateId: ProspectingBuildTemplateIdSchema.optional(),
-    confirmBuildTemplateChange: z.literal(true).optional()
-  })
-  .strict()
-  .refine(
-    (data) =>
-      data.name !== undefined ||
-      data.description !== undefined ||
-      data.batchIds !== undefined ||
-      data.buildTemplateId !== undefined,
-    {
-      message: 'At least one field (name, description, batchIds, or buildTemplateId) must be provided'
-    }
-  )
-  .refine((data) => data.buildTemplateId === undefined || data.confirmBuildTemplateChange === true, {
-    message: 'confirmBuildTemplateChange must be true when changing buildTemplateId',
-    path: ['confirmBuildTemplateChange']
+export const UpdateListRequestSchema = z
+  .object({
+    name: z.string().trim().min(1).max(255).optional(),
+    description: z.string().trim().nullable().optional(),
+    batchIds: z.array(z.string()).optional(),
+    buildTemplateId: ProspectingBuildTemplateIdSchema.optional(),
+    confirmBuildTemplateChange: z.literal(true).optional()
+  })
+  .strict()
+  .refine(
+    (data) =>
+      data.name !== undefined ||
+      data.description !== undefined ||
+      data.batchIds !== undefined ||
+      data.buildTemplateId !== undefined,
+    {
+      message: 'At least one field (name, description, batchIds, or buildTemplateId) must be provided'
+    }
+  )
+  .refine((data) => data.buildTemplateId === undefined || data.confirmBuildTemplateChange === true, {
+    message: 'confirmBuildTemplateChange must be true when changing buildTemplateId',
+    path: ['confirmBuildTemplateChange']
   })
 ```
 
 ### `UpdateListConfigRequestSchema`
 
 ```typescript
-/**
- * Partial patch for the three jsonb config columns. UI sends only the edited
- * subtree; server writes the field as-is (no deep merge — each column is
- * replaced atomically when present in the patch).
- */
-export const UpdateListConfigRequestSchema = z
-  .object({
-    scrapingConfig: ScrapingConfigSchema.partial().optional(),
-    icp: IcpRubricSchema.partial().optional(),
-    pipelineConfig: PipelineConfigSchema.partial().optional()
-  })
-  .strict()
-  .refine((data) => data.scrapingConfig !== undefined || data.icp !== undefined || data.pipelineConfig !== undefined, {
-    message: 'At least one of scrapingConfig, icp, or pipelineConfig must be provided'
+/**
+ * Partial patch for the three jsonb config columns. UI sends only the edited
+ * subtree; server writes the field as-is (no deep merge — each column is
+ * replaced atomically when present in the patch).
+ */
+export const UpdateListConfigRequestSchema = z
+  .object({
+    scrapingConfig: ScrapingConfigSchema.partial().optional(),
+    icp: IcpRubricSchema.partial().optional(),
+    pipelineConfig: PipelineConfigSchema.partial().optional()
+  })
+  .strict()
+  .refine((data) => data.scrapingConfig !== undefined || data.icp !== undefined || data.pipelineConfig !== undefined, {
+    message: 'At least one of scrapingConfig, icp, or pipelineConfig must be provided'
   })
 ```
 
 ### `AddCompaniesToListRequestSchema`
 
 ```typescript
-export const AddCompaniesToListRequestSchema = z
-  .object({
-    companyIds: z.array(UuidSchema).min(1).max(1000)
-  })
+export const AddCompaniesToListRequestSchema = z
+  .object({
+    companyIds: z.array(UuidSchema).min(1).max(1000)
+  })
   .strict()
 ```
 
 ### `RemoveCompaniesFromListRequestSchema`
 
 ```typescript
-export const RemoveCompaniesFromListRequestSchema = z
-  .object({
-    companyIds: z.array(UuidSchema).min(1).max(1000)
-  })
+export const RemoveCompaniesFromListRequestSchema = z
+  .object({
+    companyIds: z.array(UuidSchema).min(1).max(1000)
+  })
   .strict()
 ```
 
 ### `AddContactsToListRequestSchema`
 
 ```typescript
-export const AddContactsToListRequestSchema = z
-  .object({
-    contactIds: z.array(UuidSchema).min(1).max(1000)
-  })
+export const AddContactsToListRequestSchema = z
+  .object({
+    contactIds: z.array(UuidSchema).min(1).max(1000)
+  })
   .strict()
 ```
 
 ### `RecordListExecutionRequestSchema`
 
 ```typescript
-export const RecordListExecutionRequestSchema = z
-  .object({
-    executionId: UuidSchema,
-    configSnapshot: z.record(z.string(), z.unknown()).optional()
-  })
+export const RecordListExecutionRequestSchema = z
+  .object({
+    executionId: UuidSchema,
+    configSnapshot: z.record(z.string(), z.unknown()).optional()
+  })
   .strict()
 ```
 
 ### `AcqListResponseSchema`
 
 ```typescript
-/**
- * Single list as returned by /api/acquisition/lists/:id etc.
- * Camel-cased domain shape matching AcqList in types.ts.
- */
-export const AcqListResponseSchema = z.object({
-  id: z.string(),
-  organizationId: z.string(),
-  name: z.string(),
-  description: z.string().nullable(),
-  batchIds: z.array(z.string()),
-  instantlyCampaignId: z.string().nullable(),
-  /** Lifecycle status (draft | enriching | launched | closing | archived). */
-  status: ListStatusSchema,
-  metadata: AcqListMetadataSchema,
-  launchedAt: z.string().nullable(),
-  completedAt: z.string().nullable(),
-  createdAt: z.string(),
-  /** Scraping criteria stored as jsonb on the row. */
-  scrapingConfig: ScrapingConfigSchema,
-  /** ICP / qualification rubric stored as jsonb on the row. */
-  icp: IcpRubricSchema,
-  /** Pipeline presentation contract stored as jsonb on the row. */
-  pipelineConfig: PipelineConfigSchema
+/**
+ * Single list as returned by /api/acquisition/lists/:id etc.
+ * Camel-cased domain shape matching AcqList in types.ts.
+ */
+export const AcqListResponseSchema = z.object({
+  id: z.string(),
+  organizationId: z.string(),
+  name: z.string(),
+  description: z.string().nullable(),
+  batchIds: z.array(z.string()),
+  instantlyCampaignId: z.string().nullable(),
+  /** Lifecycle status (draft | enriching | launched | closing | archived). */
+  status: ListStatusSchema,
+  metadata: AcqListMetadataSchema,
+  launchedAt: z.string().nullable(),
+  completedAt: z.string().nullable(),
+  createdAt: z.string(),
+  /** Scraping criteria stored as jsonb on the row. */
+  scrapingConfig: ScrapingConfigSchema,
+  /** ICP / qualification rubric stored as jsonb on the row. */
+  icp: IcpRubricSchema,
+  /** Pipeline presentation contract stored as jsonb on the row. */
+  pipelineConfig: PipelineConfigSchema
 })
 ```
 
@@ -2436,18 +2439,18 @@ export const ListTelemetryListResponseSchema = z.array(ListTelemetrySchema)
 ### `ListExecutionSummarySchema`
 
 ```typescript
-/**
- * Row from acq_list_executions joined with the execution summary,
- * shaped for the /lists/:id/executions response.
- */
-export const ListExecutionSummarySchema = z.object({
-  executionId: z.string(),
-  resourceId: z.string(),
-  status: z.string(),
-  createdAt: z.string(),
-  completedAt: z.string().nullable(),
-  durationMs: z.number().int().nullable(),
-  input: z.unknown().nullable().optional()
+/**
+ * Row from acq_list_executions joined with the execution summary,
+ * shaped for the /lists/:id/executions response.
+ */
+export const ListExecutionSummarySchema = z.object({
+  executionId: z.string(),
+  resourceId: z.string(),
+  status: z.string(),
+  createdAt: z.string(),
+  completedAt: z.string().nullable(),
+  durationMs: z.number().int().nullable(),
+  input: z.unknown().nullable().optional()
 })
 ```
 
@@ -2478,299 +2481,299 @@ export const AcqEmailValidSchema = z.enum(['VALID', 'INVALID', 'RISKY', 'UNKNOWN
 ### `CompanyIdParamsSchema`
 
 ```typescript
-export const CompanyIdParamsSchema = z.object({
-  companyId: UuidSchema
+export const CompanyIdParamsSchema = z.object({
+  companyId: UuidSchema
 })
 ```
 
 ### `ContactIdParamsSchema`
 
 ```typescript
-export const ContactIdParamsSchema = z.object({
-  contactId: UuidSchema
+export const ContactIdParamsSchema = z.object({
+  contactId: UuidSchema
 })
 ```
 
 ### `ListCompaniesQuerySchema`
 
 ```typescript
-export const ListCompaniesQuerySchema = z
-  .object({
-    search: z.string().trim().min(1).max(200).optional(),
-    listId: UuidSchema.optional(),
-    domain: z.string().trim().min(1).max(255).optional(),
-    website: z.string().trim().min(1).max(2048).optional(),
-    segment: z.string().trim().min(1).max(255).optional(),
-    category: z.string().trim().min(1).max(255).optional(),
-    pipelineStatus: z.unknown().optional(),
-    batchId: z.string().trim().min(1).max(255).optional(),
-    status: AcqCompanyStatusSchema.optional(),
-    includeAll: QueryBooleanSchema.optional(),
-    limit: z.coerce.number().int().min(1).max(5000).default(50),
-    offset: z.coerce.number().int().min(0).default(0)
-  })
+export const ListCompaniesQuerySchema = z
+  .object({
+    search: z.string().trim().min(1).max(200).optional(),
+    listId: UuidSchema.optional(),
+    domain: z.string().trim().min(1).max(255).optional(),
+    website: z.string().trim().min(1).max(2048).optional(),
+    segment: z.string().trim().min(1).max(255).optional(),
+    category: z.string().trim().min(1).max(255).optional(),
+    pipelineStatus: z.unknown().optional(),
+    batchId: z.string().trim().min(1).max(255).optional(),
+    status: AcqCompanyStatusSchema.optional(),
+    includeAll: QueryBooleanSchema.optional(),
+    limit: z.coerce.number().int().min(1).max(5000).default(50),
+    offset: z.coerce.number().int().min(0).default(0)
+  })
   .strict()
 ```
 
 ### `ListContactsQuerySchema`
 
 ```typescript
-export const ListContactsQuerySchema = z
-  .object({
-    search: z.string().trim().min(1).max(200).optional(),
-    listId: UuidSchema.optional(),
-    openingLineIsNull: QueryBooleanSchema.optional(),
-    batchId: z.string().trim().min(1).max(255).optional(),
-    contactStatus: AcqContactStatusSchema.optional(),
-    limit: z.coerce.number().int().min(1).max(5000).default(5000),
-    offset: z.coerce.number().int().min(0).default(0)
-  })
+export const ListContactsQuerySchema = z
+  .object({
+    search: z.string().trim().min(1).max(200).optional(),
+    listId: UuidSchema.optional(),
+    openingLineIsNull: QueryBooleanSchema.optional(),
+    batchId: z.string().trim().min(1).max(255).optional(),
+    contactStatus: AcqContactStatusSchema.optional(),
+    limit: z.coerce.number().int().min(1).max(5000).default(5000),
+    offset: z.coerce.number().int().min(0).default(0)
+  })
   .strict()
 ```
 
 ### `CreateCompanyRequestSchema`
 
 ```typescript
-export const CreateCompanyRequestSchema = z
-  .object({
-    name: z.string().trim().min(1).max(255),
-    clientId: UuidSchema.nullable().optional(),
-    domain: z.string().trim().min(1).max(255).optional(),
-    linkedinUrl: z.string().trim().url().optional(),
-    website: z.string().trim().url().optional(),
-    numEmployees: z.number().int().min(0).optional(),
-    foundedYear: z.number().int().optional(),
-    locationCity: z.string().trim().min(1).max(255).optional(),
-    locationState: z.string().trim().min(1).max(255).optional(),
-    category: z.string().trim().min(1).max(255).optional(),
-    source: z.string().trim().min(1).max(255).optional(),
-    batchId: z.string().trim().min(1).max(255).optional(),
-    pipelineStatus: z.unknown().optional(),
-    verticalResearch: z.string().trim().min(1).max(5000).optional()
-  })
+export const CreateCompanyRequestSchema = z
+  .object({
+    name: z.string().trim().min(1).max(255),
+    clientId: UuidSchema.nullable().optional(),
+    domain: z.string().trim().min(1).max(255).optional(),
+    linkedinUrl: z.string().trim().url().optional(),
+    website: z.string().trim().url().optional(),
+    numEmployees: z.number().int().min(0).optional(),
+    foundedYear: z.number().int().optional(),
+    locationCity: z.string().trim().min(1).max(255).optional(),
+    locationState: z.string().trim().min(1).max(255).optional(),
+    category: z.string().trim().min(1).max(255).optional(),
+    source: z.string().trim().min(1).max(255).optional(),
+    batchId: z.string().trim().min(1).max(255).optional(),
+    pipelineStatus: z.unknown().optional(),
+    verticalResearch: z.string().trim().min(1).max(5000).optional()
+  })
   .strict()
 ```
 
 ### `UpdateCompanyRequestSchema`
 
 ```typescript
-export const UpdateCompanyRequestSchema = z
-  .object({
-    name: z.string().trim().min(1).max(255).optional(),
-    clientId: UuidSchema.nullable().optional(),
-    domain: z.string().trim().min(1).max(255).optional(),
-    linkedinUrl: z.string().trim().url().optional(),
-    website: z.string().trim().url().optional(),
-    numEmployees: z.number().int().min(0).optional(),
-    foundedYear: z.number().int().optional(),
-    locationCity: z.string().trim().min(1).max(255).optional(),
-    locationState: z.string().trim().min(1).max(255).optional(),
-    category: z.string().trim().min(1).max(255).optional(),
-    segment: z.string().trim().min(1).max(255).optional(),
-    processingState: CompanyProcessingStateSchema.optional(),
-    pipelineStatus: z.unknown().optional(),
-    enrichmentData: z.record(z.string(), z.unknown()).optional(),
-    source: z.string().trim().min(1).max(255).optional(),
-    batchId: z.string().trim().min(1).max(255).optional(),
-    status: AcqCompanyStatusSchema.optional(),
-    verticalResearch: z.string().trim().min(1).max(5000).nullable().optional()
-  })
-  .strict()
-  .refine(
-    (data) =>
-      data.name !== undefined ||
-      data.clientId !== undefined ||
-      data.domain !== undefined ||
-      data.linkedinUrl !== undefined ||
-      data.website !== undefined ||
-      data.numEmployees !== undefined ||
-      data.foundedYear !== undefined ||
-      data.locationCity !== undefined ||
-      data.locationState !== undefined ||
-      data.category !== undefined ||
-      data.segment !== undefined ||
-      data.processingState !== undefined ||
-      data.pipelineStatus !== undefined ||
-      data.enrichmentData !== undefined ||
-      data.source !== undefined ||
-      data.batchId !== undefined ||
-      data.status !== undefined ||
-      data.verticalResearch !== undefined,
-    {
-      message: 'At least one field must be provided'
-    }
+export const UpdateCompanyRequestSchema = z
+  .object({
+    name: z.string().trim().min(1).max(255).optional(),
+    clientId: UuidSchema.nullable().optional(),
+    domain: z.string().trim().min(1).max(255).optional(),
+    linkedinUrl: z.string().trim().url().optional(),
+    website: z.string().trim().url().optional(),
+    numEmployees: z.number().int().min(0).optional(),
+    foundedYear: z.number().int().optional(),
+    locationCity: z.string().trim().min(1).max(255).optional(),
+    locationState: z.string().trim().min(1).max(255).optional(),
+    category: z.string().trim().min(1).max(255).optional(),
+    segment: z.string().trim().min(1).max(255).optional(),
+    processingState: CompanyProcessingStateSchema.optional(),
+    pipelineStatus: z.unknown().optional(),
+    enrichmentData: z.record(z.string(), z.unknown()).optional(),
+    source: z.string().trim().min(1).max(255).optional(),
+    batchId: z.string().trim().min(1).max(255).optional(),
+    status: AcqCompanyStatusSchema.optional(),
+    verticalResearch: z.string().trim().min(1).max(5000).nullable().optional()
+  })
+  .strict()
+  .refine(
+    (data) =>
+      data.name !== undefined ||
+      data.clientId !== undefined ||
+      data.domain !== undefined ||
+      data.linkedinUrl !== undefined ||
+      data.website !== undefined ||
+      data.numEmployees !== undefined ||
+      data.foundedYear !== undefined ||
+      data.locationCity !== undefined ||
+      data.locationState !== undefined ||
+      data.category !== undefined ||
+      data.segment !== undefined ||
+      data.processingState !== undefined ||
+      data.pipelineStatus !== undefined ||
+      data.enrichmentData !== undefined ||
+      data.source !== undefined ||
+      data.batchId !== undefined ||
+      data.status !== undefined ||
+      data.verticalResearch !== undefined,
+    {
+      message: 'At least one field must be provided'
+    }
   )
 ```
 
 ### `CreateContactRequestSchema`
 
 ```typescript
-export const CreateContactRequestSchema = z
-  .object({
-    email: z.string().trim().email(),
-    clientId: UuidSchema.nullable().optional(),
-    companyId: UuidSchema.optional(),
-    firstName: z.string().trim().min(1).max(255).optional(),
-    lastName: z.string().trim().min(1).max(255).optional(),
-    linkedinUrl: z.string().trim().url().optional(),
-    title: z.string().trim().min(1).max(255).optional(),
-    source: z.string().trim().min(1).max(255).optional(),
-    sourceId: z.string().trim().min(1).max(255).optional(),
-    batchId: z.string().trim().min(1).max(255).optional(),
-    pipelineStatus: z.unknown().optional()
-  })
+export const CreateContactRequestSchema = z
+  .object({
+    email: z.string().trim().email(),
+    clientId: UuidSchema.nullable().optional(),
+    companyId: UuidSchema.optional(),
+    firstName: z.string().trim().min(1).max(255).optional(),
+    lastName: z.string().trim().min(1).max(255).optional(),
+    linkedinUrl: z.string().trim().url().optional(),
+    title: z.string().trim().min(1).max(255).optional(),
+    source: z.string().trim().min(1).max(255).optional(),
+    sourceId: z.string().trim().min(1).max(255).optional(),
+    batchId: z.string().trim().min(1).max(255).optional(),
+    pipelineStatus: z.unknown().optional()
+  })
   .strict()
 ```
 
 ### `UpdateContactRequestSchema`
 
 ```typescript
-export const UpdateContactRequestSchema = z
-  .object({
-    companyId: UuidSchema.optional(),
-    clientId: UuidSchema.nullable().optional(),
-    emailValid: AcqEmailValidSchema.optional(),
-    firstName: z.string().trim().min(1).max(255).optional(),
-    lastName: z.string().trim().min(1).max(255).optional(),
-    linkedinUrl: z.string().trim().url().optional(),
-    title: z.string().trim().min(1).max(255).optional(),
-    headline: z.string().trim().min(1).max(5000).optional(),
-    filterReason: z.string().trim().min(1).max(5000).optional(),
-    openingLine: z.string().trim().min(1).max(5000).optional(),
-    processingState: ContactProcessingStateSchema.optional(),
-    pipelineStatus: z.unknown().optional(),
-    enrichmentData: z.record(z.string(), z.unknown()).optional(),
-    status: AcqContactStatusSchema.optional()
-  })
-  .strict()
-  .refine(
-    (data) =>
-      data.companyId !== undefined ||
-      data.clientId !== undefined ||
-      data.emailValid !== undefined ||
-      data.firstName !== undefined ||
-      data.lastName !== undefined ||
-      data.linkedinUrl !== undefined ||
-      data.title !== undefined ||
-      data.headline !== undefined ||
-      data.filterReason !== undefined ||
-      data.openingLine !== undefined ||
-      data.processingState !== undefined ||
-      data.pipelineStatus !== undefined ||
-      data.enrichmentData !== undefined ||
-      data.status !== undefined,
-    {
-      message: 'At least one field must be provided'
-    }
+export const UpdateContactRequestSchema = z
+  .object({
+    companyId: UuidSchema.optional(),
+    clientId: UuidSchema.nullable().optional(),
+    emailValid: AcqEmailValidSchema.optional(),
+    firstName: z.string().trim().min(1).max(255).optional(),
+    lastName: z.string().trim().min(1).max(255).optional(),
+    linkedinUrl: z.string().trim().url().optional(),
+    title: z.string().trim().min(1).max(255).optional(),
+    headline: z.string().trim().min(1).max(5000).optional(),
+    filterReason: z.string().trim().min(1).max(5000).optional(),
+    openingLine: z.string().trim().min(1).max(5000).optional(),
+    processingState: ContactProcessingStateSchema.optional(),
+    pipelineStatus: z.unknown().optional(),
+    enrichmentData: z.record(z.string(), z.unknown()).optional(),
+    status: AcqContactStatusSchema.optional()
+  })
+  .strict()
+  .refine(
+    (data) =>
+      data.companyId !== undefined ||
+      data.clientId !== undefined ||
+      data.emailValid !== undefined ||
+      data.firstName !== undefined ||
+      data.lastName !== undefined ||
+      data.linkedinUrl !== undefined ||
+      data.title !== undefined ||
+      data.headline !== undefined ||
+      data.filterReason !== undefined ||
+      data.openingLine !== undefined ||
+      data.processingState !== undefined ||
+      data.pipelineStatus !== undefined ||
+      data.enrichmentData !== undefined ||
+      data.status !== undefined,
+    {
+      message: 'At least one field must be provided'
+    }
   )
 ```
 
 ### `AcqCompanyResponseSchema`
 
 ```typescript
-export const AcqCompanyResponseSchema = z.object({
-  id: z.string(),
-  organizationId: z.string(),
-  clientId: z.string().nullable().optional(),
-  name: z.string(),
-  domain: z.string().nullable(),
-  linkedinUrl: z.string().nullable(),
-  website: z.string().nullable(),
-  numEmployees: z.number().nullable(),
-  foundedYear: z.number().nullable(),
-  locationCity: z.string().nullable(),
-  locationState: z.string().nullable(),
-  category: z.string().nullable(),
-  categoryPain: z.string().nullable(),
-  segment: z.string().nullable(),
-  processingState: CompanyProcessingStateSchema.nullable(),
-  pipelineStatus: z.unknown().nullable().optional(),
-  enrichmentData: z.record(z.string(), z.unknown()).nullable(),
-  source: z.string().nullable(),
-  batchId: z.string().nullable(),
-  status: AcqCompanyStatusSchema,
-  contactCount: z.number().int().min(0),
-  verticalResearch: z.string().nullable(),
-  createdAt: z.string(),
-  updatedAt: z.string()
+export const AcqCompanyResponseSchema = z.object({
+  id: z.string(),
+  organizationId: z.string(),
+  clientId: z.string().nullable().optional(),
+  name: z.string(),
+  domain: z.string().nullable(),
+  linkedinUrl: z.string().nullable(),
+  website: z.string().nullable(),
+  numEmployees: z.number().nullable(),
+  foundedYear: z.number().nullable(),
+  locationCity: z.string().nullable(),
+  locationState: z.string().nullable(),
+  category: z.string().nullable(),
+  categoryPain: z.string().nullable(),
+  segment: z.string().nullable(),
+  processingState: CompanyProcessingStateSchema.nullable(),
+  pipelineStatus: z.unknown().nullable().optional(),
+  enrichmentData: z.record(z.string(), z.unknown()).nullable(),
+  source: z.string().nullable(),
+  batchId: z.string().nullable(),
+  status: AcqCompanyStatusSchema,
+  contactCount: z.number().int().min(0),
+  verticalResearch: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string()
 })
 ```
 
 ### `AcqCompanyListResponseSchema`
 
 ```typescript
-export const AcqCompanyListResponseSchema = z.object({
-  data: z.array(AcqCompanyResponseSchema),
-  total: z.number().int(),
-  limit: z.number().int(),
-  offset: z.number().int()
+export const AcqCompanyListResponseSchema = z.object({
+  data: z.array(AcqCompanyResponseSchema),
+  total: z.number().int(),
+  limit: z.number().int(),
+  offset: z.number().int()
 })
 ```
 
 ### `AcqCompanyFacetsResponseSchema`
 
 ```typescript
-export const AcqCompanyFacetsResponseSchema = z.object({
-  segments: z.array(z.string()),
-  categories: z.array(z.string()),
-  statuses: z.array(AcqCompanyStatusSchema)
+export const AcqCompanyFacetsResponseSchema = z.object({
+  segments: z.array(z.string()),
+  categories: z.array(z.string()),
+  statuses: z.array(AcqCompanyStatusSchema)
 })
 ```
 
 ### `AcqContactCompanySummarySchema`
 
 ```typescript
-export const AcqContactCompanySummarySchema = z.object({
-  id: z.string(),
-  name: z.string(),
-  domain: z.string().nullable(),
-  website: z.string().nullable(),
-  linkedinUrl: z.string().nullable(),
-  segment: z.string().nullable(),
-  category: z.string().nullable(),
-  status: AcqCompanyStatusSchema
+export const AcqContactCompanySummarySchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  domain: z.string().nullable(),
+  website: z.string().nullable(),
+  linkedinUrl: z.string().nullable(),
+  segment: z.string().nullable(),
+  category: z.string().nullable(),
+  status: AcqCompanyStatusSchema
 })
 ```
 
 ### `AcqContactResponseSchema`
 
 ```typescript
-export const AcqContactResponseSchema = z.object({
-  id: z.string(),
-  organizationId: z.string(),
-  clientId: z.string().nullable().optional(),
-  companyId: z.string().nullable(),
-  email: z.string(),
-  emailValid: AcqEmailValidSchema.nullable(),
-  firstName: z.string().nullable(),
-  lastName: z.string().nullable(),
-  linkedinUrl: z.string().nullable(),
-  title: z.string().nullable(),
-  headline: z.string().nullable(),
-  filterReason: z.string().nullable(),
-  openingLine: z.string().nullable(),
-  source: z.string().nullable(),
-  sourceId: z.string().nullable(),
-  processingState: ContactProcessingStateSchema.nullable(),
-  pipelineStatus: z.unknown().nullable().optional(),
-  enrichmentData: z.record(z.string(), z.unknown()).nullable(),
-  attioPersonId: z.string().nullable(),
-  batchId: z.string().nullable(),
-  status: AcqContactStatusSchema,
-  company: AcqContactCompanySummarySchema.nullable().optional(),
-  createdAt: z.string(),
-  updatedAt: z.string()
+export const AcqContactResponseSchema = z.object({
+  id: z.string(),
+  organizationId: z.string(),
+  clientId: z.string().nullable().optional(),
+  companyId: z.string().nullable(),
+  email: z.string(),
+  emailValid: AcqEmailValidSchema.nullable(),
+  firstName: z.string().nullable(),
+  lastName: z.string().nullable(),
+  linkedinUrl: z.string().nullable(),
+  title: z.string().nullable(),
+  headline: z.string().nullable(),
+  filterReason: z.string().nullable(),
+  openingLine: z.string().nullable(),
+  source: z.string().nullable(),
+  sourceId: z.string().nullable(),
+  processingState: ContactProcessingStateSchema.nullable(),
+  pipelineStatus: z.unknown().nullable().optional(),
+  enrichmentData: z.record(z.string(), z.unknown()).nullable(),
+  attioPersonId: z.string().nullable(),
+  batchId: z.string().nullable(),
+  status: AcqContactStatusSchema,
+  company: AcqContactCompanySummarySchema.nullable().optional(),
+  createdAt: z.string(),
+  updatedAt: z.string()
 })
 ```
 
 ### `AcqContactListResponseSchema`
 
 ```typescript
-export const AcqContactListResponseSchema = z.object({
-  data: z.array(AcqContactResponseSchema),
-  total: z.number().int(),
-  limit: z.number().int(),
-  offset: z.number().int()
+export const AcqContactListResponseSchema = z.object({
+  data: z.array(AcqContactResponseSchema),
+  total: z.number().int(),
+  limit: z.number().int(),
+  offset: z.number().int()
 })
 ```
 
@@ -2783,524 +2786,524 @@ export const AcqArtifactOwnerKindSchema = z.enum(['company', 'contact', 'deal',
 ### `ListArtifactsQuerySchema`
 
 ```typescript
-export const ListArtifactsQuerySchema = z
-  .object({
-    ownerKind: AcqArtifactOwnerKindSchema,
-    ownerId: UuidSchema
-  })
+export const ListArtifactsQuerySchema = z
+  .object({
+    ownerKind: AcqArtifactOwnerKindSchema,
+    ownerId: UuidSchema
+  })
   .strict()
 ```
 
 ### `CreateArtifactRequestSchema`
 
 ```typescript
-export const CreateArtifactRequestSchema = z
-  .object({
-    ownerKind: AcqArtifactOwnerKindSchema,
-    ownerId: UuidSchema,
-    kind: z.string().trim().min(1).max(255),
-    content: z.record(z.string(), z.unknown()),
-    sourceExecutionId: UuidSchema.optional()
-  })
+export const CreateArtifactRequestSchema = z
+  .object({
+    ownerKind: AcqArtifactOwnerKindSchema,
+    ownerId: UuidSchema,
+    kind: z.string().trim().min(1).max(255),
+    content: z.record(z.string(), z.unknown()),
+    sourceExecutionId: UuidSchema.optional()
+  })
   .strict()
 ```
 
 ### `AcqArtifactResponseSchema`
 
 ```typescript
-export const AcqArtifactResponseSchema = z.object({
-  id: z.string(),
-  organizationId: z.string(),
-  ownerKind: z.string(),
-  ownerId: z.string(),
-  kind: z.string(),
-  content: z.record(z.string(), z.unknown()),
-  sourceExecutionId: z.string().nullable(),
-  createdBy: z.string().nullable(),
-  createdAt: z.string(),
-  version: z.number().int()
+export const AcqArtifactResponseSchema = z.object({
+  id: z.string(),
+  organizationId: z.string(),
+  ownerKind: z.string(),
+  ownerId: z.string(),
+  kind: z.string(),
+  content: z.record(z.string(), z.unknown()),
+  sourceExecutionId: z.string().nullable(),
+  createdBy: z.string().nullable(),
+  createdAt: z.string(),
+  version: z.number().int()
 })
 ```
 
 ### `AcqArtifactListResponseSchema`
 
 ```typescript
-export const AcqArtifactListResponseSchema = z.object({
-  artifacts: z.array(AcqArtifactResponseSchema)
+export const AcqArtifactListResponseSchema = z.object({
+  artifacts: z.array(AcqArtifactResponseSchema)
 })
 ```
 
 ### `ListMembersQuerySchema`
 
 ```typescript
-export const ListMembersQuerySchema = z
-  .object({
-    limit: z.coerce.number().int().min(1).max(500).default(50),
-    offset: z.coerce.number().int().min(0).default(0)
-  })
+export const ListMembersQuerySchema = z
+  .object({
+    limit: z.coerce.number().int().min(1).max(500).default(50),
+    offset: z.coerce.number().int().min(0).default(0)
+  })
   .strict()
 ```
 
 ### `MemberIdParamsSchema`
 
 ```typescript
-export const MemberIdParamsSchema = z.object({
-  memberId: UuidSchema
+export const MemberIdParamsSchema = z.object({
+  memberId: UuidSchema
 })
 ```
 
 ### `AcqListMemberContactSummarySchema`
 
 ```typescript
-export const AcqListMemberContactSummarySchema = z.object({
-  id: z.string(),
-  email: z.string(),
-  firstName: z.string().nullable(),
-  lastName: z.string().nullable(),
-  title: z.string().nullable(),
-  linkedinUrl: z.string().nullable(),
-  companyId: z.string().nullable()
+export const AcqListMemberContactSummarySchema = z.object({
+  id: z.string(),
+  email: z.string(),
+  firstName: z.string().nullable(),
+  lastName: z.string().nullable(),
+  title: z.string().nullable(),
+  linkedinUrl: z.string().nullable(),
+  companyId: z.string().nullable()
 })
 ```
 
 ### `AcqListMemberResponseSchema`
 
 ```typescript
-export const AcqListMemberResponseSchema = z.object({
-  id: z.string(),
-  listId: z.string(),
-  contactId: z.string(),
-  pipelineKey: z.string(),
-  stageKey: z.string(),
-  stateKey: z.string(),
-  activityLog: z.unknown(),
-  addedAt: z.string(),
-  addedBy: z.string().nullable(),
-  sourceExecutionId: z.string().nullable(),
-  contact: AcqListMemberContactSummarySchema.nullable()
+export const AcqListMemberResponseSchema = z.object({
+  id: z.string(),
+  listId: z.string(),
+  contactId: z.string(),
+  pipelineKey: z.string(),
+  stageKey: z.string(),
+  stateKey: z.string(),
+  activityLog: z.unknown(),
+  addedAt: z.string(),
+  addedBy: z.string().nullable(),
+  sourceExecutionId: z.string().nullable(),
+  contact: AcqListMemberContactSummarySchema.nullable()
 })
 ```
 
 ### `AcqListMembersResponseSchema`
 
 ```typescript
-export const AcqListMembersResponseSchema = z.object({
-  members: z.array(AcqListMemberResponseSchema)
+export const AcqListMembersResponseSchema = z.object({
+  members: z.array(AcqListMemberResponseSchema)
 })
 ```
 
 ### `ListCompanyIdParamsSchema`
 
 ```typescript
-export const ListCompanyIdParamsSchema = z.object({
-  listCompanyId: UuidSchema
+export const ListCompanyIdParamsSchema = z.object({
+  listCompanyId: UuidSchema
 })
 ```
 
 ### `AcqListCompanyResponseSchema`
 
 ```typescript
-export const AcqListCompanyResponseSchema = z.object({
-  id: z.string(),
-  listId: z.string(),
-  companyId: z.string(),
-  pipelineKey: z.string(),
-  stageKey: z.string(),
-  stateKey: z.string(),
-  activityLog: z.unknown(),
-  addedAt: z.string(),
-  addedBy: z.string().nullable(),
-  sourceExecutionId: z.string().nullable()
+export const AcqListCompanyResponseSchema = z.object({
+  id: z.string(),
+  listId: z.string(),
+  companyId: z.string(),
+  pipelineKey: z.string(),
+  stageKey: z.string(),
+  stateKey: z.string(),
+  activityLog: z.unknown(),
+  addedAt: z.string(),
+  addedBy: z.string().nullable(),
+  sourceExecutionId: z.string().nullable()
 })
 ```
 
 ### `AcqCompanySchemas`
 
 ```typescript
-export const AcqCompanySchemas = {
-  CompanyProcessingState: CompanyProcessingStateSchema,
-  CompanyIdParams: CompanyIdParamsSchema,
-  ListCompaniesQuery: ListCompaniesQuerySchema,
-  CreateCompanyRequest: CreateCompanyRequestSchema,
-  UpdateCompanyRequest: UpdateCompanyRequestSchema,
-  AcqCompanyResponse: AcqCompanyResponseSchema,
-  AcqCompanyListResponse: AcqCompanyListResponseSchema,
-  AcqCompanyFacetsResponse: AcqCompanyFacetsResponseSchema
+export const AcqCompanySchemas = {
+  CompanyProcessingState: CompanyProcessingStateSchema,
+  CompanyIdParams: CompanyIdParamsSchema,
+  ListCompaniesQuery: ListCompaniesQuerySchema,
+  CreateCompanyRequest: CreateCompanyRequestSchema,
+  UpdateCompanyRequest: UpdateCompanyRequestSchema,
+  AcqCompanyResponse: AcqCompanyResponseSchema,
+  AcqCompanyListResponse: AcqCompanyListResponseSchema,
+  AcqCompanyFacetsResponse: AcqCompanyFacetsResponseSchema
 }
 ```
 
 ### `AcqContactSchemas`
 
 ```typescript
-export const AcqContactSchemas = {
-  ContactProcessingState: ContactProcessingStateSchema,
-  ContactIdParams: ContactIdParamsSchema,
-  ListContactsQuery: ListContactsQuerySchema,
-  CreateContactRequest: CreateContactRequestSchema,
-  UpdateContactRequest: UpdateContactRequestSchema,
-  AcqContactResponse: AcqContactResponseSchema,
-  AcqContactListResponse: AcqContactListResponseSchema
+export const AcqContactSchemas = {
+  ContactProcessingState: ContactProcessingStateSchema,
+  ContactIdParams: ContactIdParamsSchema,
+  ListContactsQuery: ListContactsQuerySchema,
+  CreateContactRequest: CreateContactRequestSchema,
+  UpdateContactRequest: UpdateContactRequestSchema,
+  AcqContactResponse: AcqContactResponseSchema,
+  AcqContactListResponse: AcqContactListResponseSchema
 }
 ```
 
 ### `AcqListSchemas`
 
 ```typescript
-export const AcqListSchemas = {
-  // Params
-  ListIdParams: ListIdParamsSchema,
-
-  // Primitives (for UI / tests)
-  ListStatus: ListStatusSchema,
-  ScrapingConfig: ScrapingConfigSchema,
-  IcpRubric: IcpRubricSchema,
-  PipelineConfig: PipelineConfigSchema,
-  PipelineStage: PipelineStageSchema,
-  BuildPlanSnapshot: BuildPlanSnapshotSchema,
-  BuildPlanSnapshotStep: BuildPlanSnapshotStepSchema,
-  AcqListMetadata: AcqListMetadataSchema,
-  LeadGenStageKey: LeadGenStageKeySchema,
-  LeadGenActionKey: LeadGenActionKeySchema,
-  ProcessingStageStatus: ProcessingStageStatusSchema,
-  ProcessingState: ProcessingStateSchema,
-  ListStageCounts: ListStageCountsSchema,
-  ListTelemetry: ListTelemetrySchema,
-
-  // Requests
-  ListReadQuery: ListReadQuerySchema,
-  GetListQuery: GetListQuerySchema,
-  CreateListRequest: CreateListRequestSchema,
-  UpdateListRequest: UpdateListRequestSchema,
-  UpdateListStatusRequest: UpdateListStatusRequestSchema,
-  UpdateListConfigRequest: UpdateListConfigRequestSchema,
-  AddCompaniesToListRequest: AddCompaniesToListRequestSchema,
-  RemoveCompaniesFromListRequest: RemoveCompaniesFromListRequestSchema,
-  AddContactsToListRequest: AddContactsToListRequestSchema,
-  RecordListExecutionRequest: RecordListExecutionRequestSchema,
-
-  // Responses
-  AcqListResponse: AcqListResponseSchema,
-  AcqListDetailResponse: AcqListDetailResponseSchema,
-  AcqListListResponse: AcqListListResponseSchema,
-  AcqListDealRef: AcqListDealRefSchema,
-  AcqListLineage: AcqListLineageSchema,
-  AcqListStatusResponse: AcqListStatusResponseSchema,
-  ListTelemetryResponse: ListTelemetryResponseSchema,
-  ListTelemetryListResponse: ListTelemetryListResponseSchema,
-  ListExecutionsResponse: ListExecutionsResponseSchema,
-  ListProgressResponse: ListProgressResponseSchema
+export const AcqListSchemas = {
+  // Params
+  ListIdParams: ListIdParamsSchema,
+
+  // Primitives (for UI / tests)
+  ListStatus: ListStatusSchema,
+  ScrapingConfig: ScrapingConfigSchema,
+  IcpRubric: IcpRubricSchema,
+  PipelineConfig: PipelineConfigSchema,
+  PipelineStage: PipelineStageSchema,
+  BuildPlanSnapshot: BuildPlanSnapshotSchema,
+  BuildPlanSnapshotStep: BuildPlanSnapshotStepSchema,
+  AcqListMetadata: AcqListMetadataSchema,
+  LeadGenStageKey: LeadGenStageKeySchema,
+  LeadGenActionKey: LeadGenActionKeySchema,
+  ProcessingStageStatus: ProcessingStageStatusSchema,
+  ProcessingState: ProcessingStateSchema,
+  ListStageCounts: ListStageCountsSchema,
+  ListTelemetry: ListTelemetrySchema,
+
+  // Requests
+  ListReadQuery: ListReadQuerySchema,
+  GetListQuery: GetListQuerySchema,
+  CreateListRequest: CreateListRequestSchema,
+  UpdateListRequest: UpdateListRequestSchema,
+  UpdateListStatusRequest: UpdateListStatusRequestSchema,
+  UpdateListConfigRequest: UpdateListConfigRequestSchema,
+  AddCompaniesToListRequest: AddCompaniesToListRequestSchema,
+  RemoveCompaniesFromListRequest: RemoveCompaniesFromListRequestSchema,
+  AddContactsToListRequest: AddContactsToListRequestSchema,
+  RecordListExecutionRequest: RecordListExecutionRequestSchema,
+
+  // Responses
+  AcqListResponse: AcqListResponseSchema,
+  AcqListDetailResponse: AcqListDetailResponseSchema,
+  AcqListListResponse: AcqListListResponseSchema,
+  AcqListDealRef: AcqListDealRefSchema,
+  AcqListLineage: AcqListLineageSchema,
+  AcqListStatusResponse: AcqListStatusResponseSchema,
+  ListTelemetryResponse: ListTelemetryResponseSchema,
+  ListTelemetryListResponse: ListTelemetryListResponseSchema,
+  ListExecutionsResponse: ListExecutionsResponseSchema,
+  ListProgressResponse: ListProgressResponseSchema
 }
 ```
 
 ### `AcqSubstrateSchemas`
 
 ```typescript
-export const AcqSubstrateSchemas = {
-  // Artifacts
-  ListArtifactsQuery: ListArtifactsQuerySchema,
-  CreateArtifactRequest: CreateArtifactRequestSchema,
-  AcqArtifactResponse: AcqArtifactResponseSchema,
-  AcqArtifactListResponse: AcqArtifactListResponseSchema,
-
-  // List members
-  ListMembersQuery: ListMembersQuerySchema,
-  ListRecordsQuery: ListRecordsQuerySchema,
-  MemberIdParams: MemberIdParamsSchema,
-  AcqListMemberResponse: AcqListMemberResponseSchema,
-  AcqListMembersResponse: AcqListMembersResponseSchema,
-  AcqListCompanyRecordRow: AcqListCompanyRecordRowSchema,
-  AcqListContactRecordRow: AcqListContactRecordRowSchema,
-  ListRecordRow: ListRecordRowSchema,
-  ListRecordsResponse: ListRecordsResponseSchema,
-
-  // List companies
-  ListCompanyIdParams: ListCompanyIdParamsSchema,
-  AcqListCompanyResponse: AcqListCompanyResponseSchema,
-
-  // Transition (generic stateful substrate)
-  TransitionItemRequest: TransitionItemRequestSchema
+export const AcqSubstrateSchemas = {
+  // Artifacts
+  ListArtifactsQuery: ListArtifactsQuerySchema,
+  CreateArtifactRequest: CreateArtifactRequestSchema,
+  AcqArtifactResponse: AcqArtifactResponseSchema,
+  AcqArtifactListResponse: AcqArtifactListResponseSchema,
+
+  // List members
+  ListMembersQuery: ListMembersQuerySchema,
+  ListRecordsQuery: ListRecordsQuerySchema,
+  MemberIdParams: MemberIdParamsSchema,
+  AcqListMemberResponse: AcqListMemberResponseSchema,
+  AcqListMembersResponse: AcqListMembersResponseSchema,
+  AcqListCompanyRecordRow: AcqListCompanyRecordRowSchema,
+  AcqListContactRecordRow: AcqListContactRecordRowSchema,
+  ListRecordRow: ListRecordRowSchema,
+  ListRecordsResponse: ListRecordsResponseSchema,
+
+  // List companies
+  ListCompanyIdParams: ListCompanyIdParamsSchema,
+  AcqListCompanyResponse: AcqListCompanyResponseSchema,
+
+  // Transition (generic stateful substrate)
+  TransitionItemRequest: TransitionItemRequestSchema
 }
 ```
 
 ### `Stateful`
 
 ```typescript
-/**
- * Stateful trait — the (pipeline_key, stage_key, state_key, activity_log) quartet
- * applied to acq_deals (CRM HITL, shipped 2026-04-27) and being generalized to
- * acq_lists / acq_list_members / acq_list_companies via Track B.
- */
-export interface Stateful {
-  pipeline_key: string
-  stage_key: string
-  state_key: string
-  activity_log: ActivityEvent[]
+/**
+ * Stateful trait — the (pipeline_key, stage_key, state_key, activity_log) quartet
+ * applied to acq_deals (CRM HITL, shipped 2026-04-27) and being generalized to
+ * acq_lists / acq_list_members / acq_list_companies via Track B.
+ */
+export interface Stateful {
+  pipeline_key: string
+  stage_key: string
+  state_key: string
+  activity_log: ActivityEvent[]
 }
 ```
 
 ### `TransitionItem`
 
 ```typescript
-/** Generic transition shape — concrete per-entity transitionItem implementations satisfy this. */
-export type TransitionItem<T extends Stateful, TEvent extends ActivityEvent> = (
-  item: T,
-  transition: { stage_key?: string; state_key?: string; event: TEvent }
+/** Generic transition shape — concrete per-entity transitionItem implementations satisfy this. */
+export type TransitionItem<T extends Stateful, TEvent extends ActivityEvent> = (
+  item: T,
+  transition: { stage_key?: string; state_key?: string; event: TEvent }
 ) => T
 ```
 
 ### `DeriveActions`
 
 ```typescript
-/** Generic action-derivation shape — concrete per-entity deriveActions implementations satisfy this. */
+/** Generic action-derivation shape — concrete per-entity deriveActions implementations satisfy this. */
 export type DeriveActions<T extends Stateful, TAction> = (item: T) => TAction[]
 ```
 
 ### `StatefulSchema`
 
 ```typescript
-export const StatefulSchema = z.object({
-  pipeline_key: z.string(),
-  stage_key: z.string(),
-  state_key: z.string(),
-  activity_log: z.array(ActivityEventSchema)
+export const StatefulSchema = z.object({
+  pipeline_key: z.string(),
+  stage_key: z.string(),
+  state_key: z.string(),
+  activity_log: z.array(ActivityEventSchema)
 })
 ```
 
 ### `StatefulStateDefinition`
 
 ```typescript
-/** One state within a stage — minimal shape: key + display label. */
-export interface StatefulStateDefinition {
-  /** Matches state_key values written by workflow steps. */
-  stateKey: string
-  label: string
+/** One state within a stage — minimal shape: key + display label. */
+export interface StatefulStateDefinition {
+  /** Matches state_key values written by workflow steps. */
+  stateKey: string
+  label: string
 }
 ```
 
 ### `StatefulStageDefinition`
 
 ```typescript
-/** One stage within a pipeline — has a stage_key and an ordered list of valid states. */
-export interface StatefulStageDefinition {
-  /** Matches stage_key values written by workflow steps. */
-  stageKey: string
-  label: string
-  /** UI color token. Consumers may map this to their design system. */
-  color?: string
-  states: StatefulStateDefinition[]
+/** One stage within a pipeline — has a stage_key and an ordered list of valid states. */
+export interface StatefulStageDefinition {
+  /** Matches stage_key values written by workflow steps. */
+  stageKey: string
+  label: string
+  /** UI color token. Consumers may map this to their design system. */
+  color?: string
+  states: StatefulStateDefinition[]
 }
 ```
 
 ### `StatefulPipelineDefinition`
 
 ```typescript
-/**
- * Pipeline definition for a single entity participating in the Stateful trait.
- * Parallel to acq_deals' pipeline_key concept but structured for lead-gen entities.
- */
-export interface StatefulPipelineDefinition {
-  /** Matches pipeline_key values in the database (e.g. 'lead-gen'). */
-  pipelineKey: string
-  label: string
-  /** Entity this pipeline applies to (e.g. 'acq.list', 'acq.list-member', 'acq.list-company'). */
-  entityKey: string
-  stages: StatefulStageDefinition[]
+/**
+ * Pipeline definition for a single entity participating in the Stateful trait.
+ * Parallel to acq_deals' pipeline_key concept but structured for lead-gen entities.
+ */
+export interface StatefulPipelineDefinition {
+  /** Matches pipeline_key values in the database (e.g. 'lead-gen'). */
+  pipelineKey: string
+  label: string
+  /** Entity this pipeline applies to (e.g. 'acq.list', 'acq.list-member', 'acq.list-company'). */
+  entityKey: string
+  stages: StatefulStageDefinition[]
 }
 ```
 
 ### `ACQ_LIST_MEMBERS_LEAD_GEN_PIPELINE`
 
 ```typescript
-/**
- * Lead-gen pipeline definition for acq_list_members (contacts).
- * Three stages matching the post-restructure sales subdomain tree.
- *
- * Note: members visit outreach and prospecting states depending on which
- * workflow last processed them. stage_key is set per-transition by the workflow.
- */
-export const ACQ_LIST_MEMBERS_LEAD_GEN_PIPELINE: StatefulPipelineDefinition = {
-  pipelineKey: 'lead-gen',
-  label: 'Lead Generation',
-  entityKey: 'acq.list-member',
-  stages: [
-    {
-      stageKey: 'outreach',
-      label: 'Outreach',
-      states: [
-        PENDING_STATE,
-        { stateKey: 'personalized', label: 'Personalized' },
-        { stateKey: 'uploaded', label: 'Uploaded' },
-        { stateKey: 'interested', label: 'Interested' }
-      ]
-    },
-    {
-      stageKey: 'prospecting',
-      label: 'Prospecting',
-      states: [
-        PENDING_STATE,
-        { stateKey: 'discovered', label: 'Discovered' },
-        { stateKey: 'verified', label: 'Verified' }
-      ]
-    },
-    {
-      stageKey: 'qualification',
-      label: 'Qualification',
-      states: [PENDING_STATE]
-    }
-  ]
+/**
+ * Lead-gen pipeline definition for acq_list_members (contacts).
+ * Three stages matching the post-restructure sales subdomain tree.
+ *
+ * Note: members visit outreach and prospecting states depending on which
+ * workflow last processed them. stage_key is set per-transition by the workflow.
+ */
+export const ACQ_LIST_MEMBERS_LEAD_GEN_PIPELINE: StatefulPipelineDefinition = {
+  pipelineKey: 'lead-gen',
+  label: 'Lead Generation',
+  entityKey: 'acq.list-member',
+  stages: [
+    {
+      stageKey: 'outreach',
+      label: 'Outreach',
+      states: [
+        PENDING_STATE,
+        { stateKey: 'personalized', label: 'Personalized' },
+        { stateKey: 'uploaded', label: 'Uploaded' },
+        { stateKey: 'interested', label: 'Interested' }
+      ]
+    },
+    {
+      stageKey: 'prospecting',
+      label: 'Prospecting',
+      states: [
+        PENDING_STATE,
+        { stateKey: 'discovered', label: 'Discovered' },
+        { stateKey: 'verified', label: 'Verified' }
+      ]
+    },
+    {
+      stageKey: 'qualification',
+      label: 'Qualification',
+      states: [PENDING_STATE]
+    }
+  ]
 }
 ```
 
 ### `ACQ_LIST_COMPANIES_LEAD_GEN_PIPELINE`
 
 ```typescript
-/**
- * Lead-gen pipeline definition for acq_list_companies.
- * Three stages matching the post-restructure sales subdomain tree.
- *
- * Note: companies visit prospecting and qualification states depending on which
- * workflow last processed them. stage_key is set per-transition by the workflow.
- */
-export const ACQ_LIST_COMPANIES_LEAD_GEN_PIPELINE: StatefulPipelineDefinition = {
-  pipelineKey: 'lead-gen',
-  label: 'Lead Generation',
-  entityKey: 'acq.list-company',
-  stages: [
-    {
-      stageKey: 'outreach',
-      label: 'Outreach',
-      states: [PENDING_STATE, { stateKey: 'uploaded', label: 'Uploaded' }]
-    },
-    {
-      stageKey: 'prospecting',
-      label: 'Prospecting',
-      states: [
-        PENDING_STATE,
-        { stateKey: 'populated', label: 'Populated' },
-        { stateKey: 'extracted', label: 'Extracted' }
-      ]
-    },
-    {
-      stageKey: 'qualification',
-      label: 'Qualification',
-      states: [PENDING_STATE, { stateKey: 'qualified', label: 'Qualified' }]
-    }
-  ]
+/**
+ * Lead-gen pipeline definition for acq_list_companies.
+ * Three stages matching the post-restructure sales subdomain tree.
+ *
+ * Note: companies visit prospecting and qualification states depending on which
+ * workflow last processed them. stage_key is set per-transition by the workflow.
+ */
+export const ACQ_LIST_COMPANIES_LEAD_GEN_PIPELINE: StatefulPipelineDefinition = {
+  pipelineKey: 'lead-gen',
+  label: 'Lead Generation',
+  entityKey: 'acq.list-company',
+  stages: [
+    {
+      stageKey: 'outreach',
+      label: 'Outreach',
+      states: [PENDING_STATE, { stateKey: 'uploaded', label: 'Uploaded' }]
+    },
+    {
+      stageKey: 'prospecting',
+      label: 'Prospecting',
+      states: [
+        PENDING_STATE,
+        { stateKey: 'populated', label: 'Populated' },
+        { stateKey: 'extracted', label: 'Extracted' }
+      ]
+    },
+    {
+      stageKey: 'qualification',
+      label: 'Qualification',
+      states: [PENDING_STATE, { stateKey: 'qualified', label: 'Qualified' }]
+    }
+  ]
 }
 ```
 
 ### `LEAD_GEN_PIPELINE_DEFINITIONS`
 
 ```typescript
-/**
- * All lead-gen pipeline definitions indexed by entity key.
- * Use findPipeline() to locate a definition by pipeline_key within any of these arrays.
- */
-export const LEAD_GEN_PIPELINE_DEFINITIONS: Record<string, StatefulPipelineDefinition[]> = {
-  'acq.list-member': [ACQ_LIST_MEMBERS_LEAD_GEN_PIPELINE],
-  'acq.list-company': [ACQ_LIST_COMPANIES_LEAD_GEN_PIPELINE]
+/**
+ * All lead-gen pipeline definitions indexed by entity key.
+ * Use findPipeline() to locate a definition by pipeline_key within any of these arrays.
+ */
+export const LEAD_GEN_PIPELINE_DEFINITIONS: Record<string, StatefulPipelineDefinition[]> = {
+  'acq.list-member': [ACQ_LIST_MEMBERS_LEAD_GEN_PIPELINE],
+  'acq.list-company': [ACQ_LIST_COMPANIES_LEAD_GEN_PIPELINE]
 }
 ```
 
 ### `PaginationParams`
 
 ```typescript
-export interface PaginationParams {
-  limit: number
-  offset: number
+export interface PaginationParams {
+  limit: number
+  offset: number
 }
 ```
 
 ### `PaginatedResult`
 
 ```typescript
-export interface PaginatedResult<T> {
-  data: T[]
-  total: number
-  limit: number
-  offset: number
+export interface PaginatedResult<T> {
+  data: T[]
+  total: number
+  limit: number
+  offset: number
 }
 ```
 
 ### `CreateListParams`
 
 ```typescript
-export interface CreateListParams {
-  organizationId: string
-  name: string
-  description?: string
-  type?: string
-  batchIds?: string[]
-  instantlyCampaignId?: string
-  status?: ListStatus
-  buildTemplateId?: string
-  metadata?: Record<string, unknown>
-  scrapingConfig?: ScrapingConfig
-  icp?: IcpRubric
-  pipelineConfig?: PipelineConfig
+export interface CreateListParams {
+  organizationId: string
+  name: string
+  description?: string
+  type?: string
+  batchIds?: string[]
+  instantlyCampaignId?: string
+  status?: ListStatus
+  buildTemplateId?: string
+  metadata?: Record<string, unknown>
+  scrapingConfig?: ScrapingConfig
+  icp?: IcpRubric
+  pipelineConfig?: PipelineConfig
 }
 ```
 
 ### `UpdateListParams`
 
 ```typescript
-export interface UpdateListParams {
-  name?: string
-  description?: string
-  batchIds?: string[]
+export interface UpdateListParams {
+  name?: string
+  description?: string
+  batchIds?: string[]
 }
 ```
 
 ### `CreateCompanyParams`
 
 ```typescript
-export interface CreateCompanyParams {
-  organizationId: string
-  name: string
-  domain?: string
-  linkedinUrl?: string
-  website?: string
-  numEmployees?: number
-  foundedYear?: number
-  locationCity?: string
-  locationState?: string
-  category?: string
-  source?: string
-  batchId?: string
-  verticalResearch?: string
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
+export interface CreateCompanyParams {
+  organizationId: string
+  name: string
+  domain?: string
+  linkedinUrl?: string
+  website?: string
+  numEmployees?: number
+  foundedYear?: number
+  locationCity?: string
+  locationState?: string
+  category?: string
+  source?: string
+  batchId?: string
+  verticalResearch?: string
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
 }
 ```
 
 ### `UpdateCompanyParams`
 
 ```typescript
-export interface UpdateCompanyParams {
-  name?: string
-  domain?: string
-  linkedinUrl?: string
-  website?: string
-  numEmployees?: number
-  foundedYear?: number
-  locationCity?: string
-  locationState?: string
-  category?: string
-  segment?: string
-  processingState?: ProcessingState
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
-  enrichmentData?: Record<string, unknown>
-  source?: string
-  batchId?: string
-  status?: 'active' | 'invalid'
-  verticalResearch?: string | null
-  /** Track A: flat qualification score column (null until a scoring rubric is defined) */
-  qualificationScore?: number | null
-  /** Track A: flat qualification signals jsonb */
-  qualificationSignals?: Record<string, unknown> | null
-  /** Track A: key identifying the rubric used for qualification */
-  qualificationRubricKey?: string | null
+export interface UpdateCompanyParams {
+  name?: string
+  domain?: string
+  linkedinUrl?: string
+  website?: string
+  numEmployees?: number
+  foundedYear?: number
+  locationCity?: string
+  locationState?: string
+  category?: string
+  segment?: string
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
+  enrichmentData?: Record<string, unknown>
+  source?: string
+  batchId?: string
+  status?: 'active' | 'invalid'
+  verticalResearch?: string | null
+  /** Track A: flat qualification score column (null until a scoring rubric is defined) */
+  qualificationScore?: number | null
+  /** Track A: flat qualification signals jsonb */
+  qualificationSignals?: Record<string, unknown> | null
+  /** Track A: key identifying the rubric used for qualification */
+  qualificationRubricKey?: string | null
 }
 ```
 
@@ -3313,63 +3316,63 @@ export type UpsertCompanyParams = CreateCompanyParams
 ### `CompanyFilters`
 
 ```typescript
-export interface CompanyFilters {
-  listId?: string // Filter to companies in a specific list (via acq_list_companies)
-  search?: string
-  domain?: string
-  website?: string
-  segment?: string
-  category?: string
-  processingState?: ProcessingState
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
-  /** Exclude companies whose processing state contains this value (PostgREST NOT contains) */
-  processingStateNot?: ProcessingState
-  batchId?: string
-  status?: 'active' | 'invalid'
-  includeAll?: boolean
-  excludeColumns?: Array<'enrichmentData' | 'processingState'>
-  limit?: number
+export interface CompanyFilters {
+  listId?: string // Filter to companies in a specific list (via acq_list_companies)
+  search?: string
+  domain?: string
+  website?: string
+  segment?: string
+  category?: string
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
+  /** Exclude companies whose processing state contains this value (PostgREST NOT contains) */
+  processingStateNot?: ProcessingState
+  batchId?: string
+  status?: 'active' | 'invalid'
+  includeAll?: boolean
+  excludeColumns?: Array<'enrichmentData' | 'processingState'>
+  limit?: number
 }
 ```
 
 ### `CreateContactParams`
 
 ```typescript
-export interface CreateContactParams {
-  organizationId: string
-  email: string
-  companyId?: string
-  firstName?: string
-  lastName?: string
-  linkedinUrl?: string
-  title?: string
-  source?: string
-  sourceId?: string
-  batchId?: string
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
+export interface CreateContactParams {
+  organizationId: string
+  email: string
+  companyId?: string
+  firstName?: string
+  lastName?: string
+  linkedinUrl?: string
+  title?: string
+  source?: string
+  sourceId?: string
+  batchId?: string
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
 }
 ```
 
 ### `UpdateContactParams`
 
 ```typescript
-export interface UpdateContactParams {
-  companyId?: string
-  emailValid?: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN'
-  firstName?: string
-  lastName?: string
-  linkedinUrl?: string
-  title?: string
-  headline?: string
-  filterReason?: string
-  openingLine?: string
-  processingState?: ProcessingState
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
-  enrichmentData?: Record<string, unknown>
-  status?: 'active' | 'invalid'
+export interface UpdateContactParams {
+  companyId?: string
+  emailValid?: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN'
+  firstName?: string
+  lastName?: string
+  linkedinUrl?: string
+  title?: string
+  headline?: string
+  filterReason?: string
+  openingLine?: string
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
+  enrichmentData?: Record<string, unknown>
+  status?: 'active' | 'invalid'
 }
 ```
 
@@ -3382,400 +3385,400 @@ export type UpsertContactParams = CreateContactParams
 ### `ContactFilters`
 
 ```typescript
-export interface ContactFilters {
-  listId?: string // Filter to contacts in a specific list (via acq_list_members)
-  search?: string
-  openingLineIsNull?: boolean // Filter to contacts without personalization
-  processingState?: ProcessingState
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
-  batchId?: string
-  contactStatus?: 'active' | 'invalid' // Filter by contact status (soft-delete flag)
+export interface ContactFilters {
+  listId?: string // Filter to contacts in a specific list (via acq_list_members)
+  search?: string
+  openingLineIsNull?: boolean // Filter to contacts without personalization
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
+  batchId?: string
+  contactStatus?: 'active' | 'invalid' // Filter by contact status (soft-delete flag)
 }
 ```
 
 ### `UpsertSocialPostParams`
 
 ```typescript
-export interface UpsertSocialPostParams {
-  organizationId: string
-  platform: string
-  platformPostId: string
-  authorName: string
-  authorUrl?: string | null
-  postTitle: string
-  postText: string
-  postUrl: string
-  engagementCount?: number
-  commentsCount?: number
-  postedAt: string
-  metadata?: Record<string, unknown>
-  relevanceScore?: number
-  matchedKeywords?: string[]
-  matchedQuery?: string | null
-  initialDraft?: string | null
-  finalResponse?: string | null
-  sourceCategory?: string | null
+export interface UpsertSocialPostParams {
+  organizationId: string
+  platform: string
+  platformPostId: string
+  authorName: string
+  authorUrl?: string | null
+  postTitle: string
+  postText: string
+  postUrl: string
+  engagementCount?: number
+  commentsCount?: number
+  postedAt: string
+  metadata?: Record<string, unknown>
+  relevanceScore?: number
+  matchedKeywords?: string[]
+  matchedQuery?: string | null
+  initialDraft?: string | null
+  finalResponse?: string | null
+  sourceCategory?: string | null
 }
 ```
 
 ### `UpsertSocialPostsParams`
 
 ```typescript
-export interface UpsertSocialPostsParams {
-  organizationId: string
-  posts: Omit<UpsertSocialPostParams, 'organizationId'>[]
+export interface UpsertSocialPostsParams {
+  organizationId: string
+  posts: Omit<UpsertSocialPostParams, 'organizationId'>[]
 }
 ```
 
 ### `UpsertSocialPostsResult`
 
 ```typescript
-export interface UpsertSocialPostsResult {
-  inserted: number
-  duplicatesSkipped: number
+export interface UpsertSocialPostsResult {
+  inserted: number
+  duplicatesSkipped: number
 }
 ```
 
 ### `AddContactsToListParams`
 
 ```typescript
-export interface AddContactsToListParams {
-  organizationId: string
-  listId: string
-  contactIds: string[]
+export interface AddContactsToListParams {
+  organizationId: string
+  listId: string
+  contactIds: string[]
 }
 ```
 
 ### `AddContactsToListResult`
 
 ```typescript
-export interface AddContactsToListResult {
-  added: number
-  alreadyExisted: number
+export interface AddContactsToListResult {
+  added: number
+  alreadyExisted: number
 }
 ```
 
 ### `UpdateListConfigParams`
 
 ```typescript
-export interface UpdateListConfigParams {
-  organizationId: string
-  listId: string
-  scrapingConfig?: ScrapingConfig
-  icp?: IcpRubric
-  pipelineConfig?: PipelineConfig
+export interface UpdateListConfigParams {
+  organizationId: string
+  listId: string
+  scrapingConfig?: ScrapingConfig
+  icp?: IcpRubric
+  pipelineConfig?: PipelineConfig
 }
 ```
 
 ### `UpdateCompanyStageParams`
 
 ```typescript
-export interface UpdateCompanyStageParams {
-  organizationId: string
-  listId: string
-  companyId: string
-  stage: string
-  status?: ProcessingStageStatus
-  executionId?: string
+export interface UpdateCompanyStageParams {
+  organizationId: string
+  listId: string
+  companyId: string
+  stage: string
+  status?: ProcessingStageStatus
+  executionId?: string
 }
 ```
 
 ### `UpdateContactStageParams`
 
 ```typescript
-export interface UpdateContactStageParams {
-  organizationId: string
-  listId: string
-  contactId: string
-  stage: string
-  status?: ProcessingStageStatus
-  executionId?: string
+export interface UpdateContactStageParams {
+  organizationId: string
+  listId: string
+  contactId: string
+  stage: string
+  status?: ProcessingStageStatus
+  executionId?: string
 }
 ```
 
 ### `AddCompaniesToListParams`
 
 ```typescript
-export interface AddCompaniesToListParams {
-  organizationId: string
-  listId: string
-  companyIds: string[]
+export interface AddCompaniesToListParams {
+  organizationId: string
+  listId: string
+  companyIds: string[]
 }
 ```
 
 ### `AddCompaniesToListResult`
 
 ```typescript
-export interface AddCompaniesToListResult {
-  added: number
-  alreadyExisted: number
+export interface AddCompaniesToListResult {
+  added: number
+  alreadyExisted: number
 }
 ```
 
 ### `RemoveCompaniesFromListParams`
 
 ```typescript
-export interface RemoveCompaniesFromListParams {
-  organizationId: string
-  listId: string
-  companyIds: string[]
+export interface RemoveCompaniesFromListParams {
+  organizationId: string
+  listId: string
+  companyIds: string[]
 }
 ```
 
 ### `RemoveCompaniesFromListResult`
 
 ```typescript
-export interface RemoveCompaniesFromListResult {
-  removed: number
+export interface RemoveCompaniesFromListResult {
+  removed: number
 }
 ```
 
 ### `RecordListExecutionParams`
 
 ```typescript
-export interface RecordListExecutionParams {
-  organizationId: string
-  listId: string
-  executionId: string
-  configSnapshot?: Record<string, unknown>
+export interface RecordListExecutionParams {
+  organizationId: string
+  listId: string
+  executionId: string
+  configSnapshot?: Record<string, unknown>
 }
 ```
 
 ### `ListExecutionSummary`
 
 ```typescript
-export interface ListExecutionSummary {
-  executionId: string
-  resourceId: string
-  status: string
-  createdAt: string
-  completedAt: string | null
-  durationMs: number | null
+export interface ListExecutionSummary {
+  executionId: string
+  resourceId: string
+  status: string
+  createdAt: string
+  completedAt: string | null
+  durationMs: number | null
 }
 ```
 
 ### `BulkImportParams`
 
 ```typescript
-export interface BulkImportParams {
-  organizationId: string
-  contacts: CreateContactParams[]
-  listId?: string
+export interface BulkImportParams {
+  organizationId: string
+  contacts: CreateContactParams[]
+  listId?: string
 }
 ```
 
 ### `BulkImportResult`
 
 ```typescript
-export interface BulkImportResult {
-  created: number
-  updated: number
-  errors: Array<{ email: string; error: string }>
+export interface BulkImportResult {
+  created: number
+  updated: number
+  errors: Array<{ email: string; error: string }>
 }
 ```
 
 ### `BulkImportCompanyEntry`
 
 ```typescript
-export interface BulkImportCompanyEntry {
-  name: string
-  domain: string
-  website?: string
-  locationCity?: string
-  locationState?: string
-  category?: string
-  source?: string
-  enrichmentData?: Record<string, unknown>
-  processingState?: ProcessingState
+export interface BulkImportCompanyEntry {
+  name: string
+  domain: string
+  website?: string
+  locationCity?: string
+  locationState?: string
+  category?: string
+  source?: string
+  enrichmentData?: Record<string, unknown>
+  processingState?: ProcessingState
 }
 ```
 
 ### `BulkImportCompaniesParams`
 
 ```typescript
-export interface BulkImportCompaniesParams {
-  organizationId: string
-  batchId: string
-  companies: BulkImportCompanyEntry[]
+export interface BulkImportCompaniesParams {
+  organizationId: string
+  batchId: string
+  companies: BulkImportCompanyEntry[]
 }
 ```
 
 ### `BulkImportCompaniesResult`
 
 ```typescript
-export interface BulkImportCompaniesResult {
-  created: number
-  skipped: number
-  errors: Array<{ companyName: string; error: string }>
+export interface BulkImportCompaniesResult {
+  created: number
+  skipped: number
+  errors: Array<{ companyName: string; error: string }>
 }
 ```
 
 ### `LeadToolMap`
 
 ```typescript
-export type LeadToolMap = {
-  // List operations
-  listLists: { params: Record<string, never>; result: AcqList[] }
-  createList: { params: Omit<CreateListParams, 'organizationId'>; result: AcqList }
-  updateList: { params: { id: string } & UpdateListParams; result: AcqList }
-  deleteList: { params: { id: string }; result: void }
-  addContactsToList: { params: Omit<AddContactsToListParams, 'organizationId'>; result: AddContactsToListResult }
-  addCompaniesToList: { params: Omit<AddCompaniesToListParams, 'organizationId'>; result: AddCompaniesToListResult }
-  updateCompanyStage: {
-    params: Omit<UpdateCompanyStageParams, 'organizationId'>
-    result: void
-  }
-  updateContactStage: {
-    params: Omit<UpdateContactStageParams, 'organizationId'>
-    result: void
-  }
-  // Company operations
-  createCompany: { params: Omit<CreateCompanyParams, 'organizationId'>; result: AcqCompany }
-  upsertCompany: { params: Omit<UpsertCompanyParams, 'organizationId'>; result: AcqCompany }
-  updateCompany: { params: { id: string } & UpdateCompanyParams; result: AcqCompany }
-  getCompany: { params: { id: string }; result: AcqCompany | null }
-  listCompanies: { params: CompanyFilters; result: AcqCompany[] }
-  deleteCompany: { params: { id: string }; result: void }
-  // Contact operations
-  createContact: { params: Omit<CreateContactParams, 'organizationId'>; result: AcqContact }
-  upsertContact: { params: Omit<UpsertContactParams, 'organizationId'>; result: AcqContact }
-  updateContact: { params: { id: string } & UpdateContactParams; result: AcqContact }
-  getContact: { params: { id: string }; result: AcqContact | null }
-  getContactByEmail: { params: { email: string }; result: AcqContact | null }
-  listContacts: {
-    params: ContactFilters & { limit?: number; offset?: number }
-    result: PaginatedResult<AcqContact>
-  }
-  deleteContact: { params: { id: string }; result: void }
-  bulkImportContacts: { params: Omit<BulkImportParams, 'organizationId'>; result: BulkImportResult }
-  bulkImportCompanies: {
-    params: Omit<BulkImportCompaniesParams, 'organizationId'>
-    result: BulkImportCompaniesResult
-  }
-  deactivateContactsByCompany: {
-    params: { companyId: string }
-    result: { deactivated: number }
-  }
-  // Deal operations
-  upsertDeal: { params: Omit<UpsertDealParams, 'organizationId'>; result: AcqDeal }
-  getDealByEmail: { params: { email: string }; result: AcqDeal | null }
-  getDealByEnvelopeId: { params: { envelopeId: string }; result: AcqDeal | null }
-  updateDealEnvelopeId: { params: { dealId: string; envelopeId: string }; result: AcqDeal | null }
-  getDealById: { params: Omit<GetDealByIdParams, 'organizationId'>; result: AcqDeal | null }
-  getContactById: { params: Omit<GetContactByIdParams, 'organizationId'>; result: AcqContact | null }
-  getCompanyById: { params: Omit<GetCompanyByIdParams, 'organizationId'>; result: AcqCompany | null }
-  // Deal-sync operations
-  updateDiscoveryData: { params: Omit<UpdateDiscoveryDataParams, 'organizationId'>; result: void }
-  updateProposalData: { params: Omit<UpdateProposalDataParams, 'organizationId'>; result: void }
-  markProposalSent: { params: Omit<MarkProposalSentParams, 'organizationId'>; result: void }
-  markProposalReviewed: { params: Omit<MarkProposalReviewedParams, 'organizationId'>; result: void }
-  updateCloseLostReason: { params: Omit<UpdateCloseLostReasonParams, 'organizationId'>; result: void }
-  updateFees: { params: Omit<UpdateFeesParams, 'organizationId'>; result: void }
-  cacheInstantlyThreadIds: { params: Omit<CacheInstantlyThreadIdsParams, 'organizationId'>; result: void }
-  transitionItem: { params: Omit<TransitionItemParams, 'organizationId'>; result: void }
-  setContactNurture: { params: Omit<SetContactNurtureParams, 'organizationId'>; result: void }
-  cancelSchedulesAndHitlByEmail: {
-    params: Omit<CancelSchedulesAndHitlByEmailParams, 'organizationId'>
-    result: { schedulesCancelled: number; hitlDeleted: number }
-  }
-  cancelHitlByDealId: { params: Omit<CancelHitlByDealIdParams, 'organizationId'>; result: { hitlDeleted: number } }
-  clearDealFields: { params: Omit<ClearDealFieldsParams, 'organizationId'>; result: void }
-  deleteDeal: { params: Omit<DeleteDealParams, 'organizationId'>; result: void }
-  recordDealActivity: {
-    params: Omit<RecordDealActivityParams, 'organizationId'>
-    result: void
-  }
-  // Deal note operations
-  createDealNote: {
-    params: Omit<CreateDealNoteParams, 'organizationId'>
-    result: AcqDealNote
-  }
-  listDealNotes: {
-    params: Omit<ListDealNotesParams, 'organizationId'>
-    result: AcqDealNote[]
-  }
-  // Deal task operations
-  createDealTask: {
-    params: Omit<CreateDealTaskParams, 'organizationId'>
-    result: AcqDealTask
-  }
-  listDealTasks: {
-    params: Omit<ListDealTasksParams, 'organizationId'>
-    result: AcqDealTask[]
-  }
-  listDealTasksDue: {
-    params: Omit<ListDealTasksDueParams, 'organizationId'>
-    result: AcqDealTask[]
-  }
-  completeDealTask: {
-    params: Omit<CompleteDealTaskParams, 'organizationId'>
-    result: AcqDealTask
-  }
-  // Deal query & analytics operations
-  listDeals: { params: DealFilters; result: AcqDeal[] }
-  getDealPipelineAnalytics: { params: { recentLimit?: number }; result: DealPipelineAnalytics }
-  // Enrichment data operations
-  mergeEnrichmentData: {
-    params: { id: string; table: 'acq_companies' | 'acq_contacts'; data: Record<string, unknown> }
-    result: void
-  }
-  // Social monitoring operations
-  upsertSocialPosts: {
-    params: { posts: Omit<UpsertSocialPostParams, 'organizationId'>[] }
-    result: UpsertSocialPostsResult
-  }
-  setDealStateKey: {
-    params: {
-      dealId: string
-      stateKey: string
-    }
-    result: { ok: true }
-  }
-  // CRM workflow helpers
-  transitionDeal: {
-    params: {
-      dealId: string
-      toStage: string
-      toState?: string
-    }
-    result: { deal: AcqDeal }
-  }
-  loadDeal: {
-    params: { dealId: string }
-    result: DealDetail | null
-  }
+export type LeadToolMap = {
+  // List operations
+  listLists: { params: Record<string, never>; result: AcqList[] }
+  createList: { params: Omit<CreateListParams, 'organizationId'>; result: AcqList }
+  updateList: { params: { id: string } & UpdateListParams; result: AcqList }
+  deleteList: { params: { id: string }; result: void }
+  addContactsToList: { params: Omit<AddContactsToListParams, 'organizationId'>; result: AddContactsToListResult }
+  addCompaniesToList: { params: Omit<AddCompaniesToListParams, 'organizationId'>; result: AddCompaniesToListResult }
+  updateCompanyStage: {
+    params: Omit<UpdateCompanyStageParams, 'organizationId'>
+    result: void
+  }
+  updateContactStage: {
+    params: Omit<UpdateContactStageParams, 'organizationId'>
+    result: void
+  }
+  // Company operations
+  createCompany: { params: Omit<CreateCompanyParams, 'organizationId'>; result: AcqCompany }
+  upsertCompany: { params: Omit<UpsertCompanyParams, 'organizationId'>; result: AcqCompany }
+  updateCompany: { params: { id: string } & UpdateCompanyParams; result: AcqCompany }
+  getCompany: { params: { id: string }; result: AcqCompany | null }
+  listCompanies: { params: CompanyFilters; result: AcqCompany[] }
+  deleteCompany: { params: { id: string }; result: void }
+  // Contact operations
+  createContact: { params: Omit<CreateContactParams, 'organizationId'>; result: AcqContact }
+  upsertContact: { params: Omit<UpsertContactParams, 'organizationId'>; result: AcqContact }
+  updateContact: { params: { id: string } & UpdateContactParams; result: AcqContact }
+  getContact: { params: { id: string }; result: AcqContact | null }
+  getContactByEmail: { params: { email: string }; result: AcqContact | null }
+  listContacts: {
+    params: ContactFilters & { limit?: number; offset?: number }
+    result: PaginatedResult<AcqContact>
+  }
+  deleteContact: { params: { id: string }; result: void }
+  bulkImportContacts: { params: Omit<BulkImportParams, 'organizationId'>; result: BulkImportResult }
+  bulkImportCompanies: {
+    params: Omit<BulkImportCompaniesParams, 'organizationId'>
+    result: BulkImportCompaniesResult
+  }
+  deactivateContactsByCompany: {
+    params: { companyId: string }
+    result: { deactivated: number }
+  }
+  // Deal operations
+  upsertDeal: { params: Omit<UpsertDealParams, 'organizationId'>; result: AcqDeal }
+  getDealByEmail: { params: { email: string }; result: AcqDeal | null }
+  getDealByEnvelopeId: { params: { envelopeId: string }; result: AcqDeal | null }
+  updateDealEnvelopeId: { params: { dealId: string; envelopeId: string }; result: AcqDeal | null }
+  getDealById: { params: Omit<GetDealByIdParams, 'organizationId'>; result: AcqDeal | null }
+  getContactById: { params: Omit<GetContactByIdParams, 'organizationId'>; result: AcqContact | null }
+  getCompanyById: { params: Omit<GetCompanyByIdParams, 'organizationId'>; result: AcqCompany | null }
+  // Deal-sync operations
+  updateDiscoveryData: { params: Omit<UpdateDiscoveryDataParams, 'organizationId'>; result: void }
+  updateProposalData: { params: Omit<UpdateProposalDataParams, 'organizationId'>; result: void }
+  markProposalSent: { params: Omit<MarkProposalSentParams, 'organizationId'>; result: void }
+  markProposalReviewed: { params: Omit<MarkProposalReviewedParams, 'organizationId'>; result: void }
+  updateCloseLostReason: { params: Omit<UpdateCloseLostReasonParams, 'organizationId'>; result: void }
+  updateFees: { params: Omit<UpdateFeesParams, 'organizationId'>; result: void }
+  cacheInstantlyThreadIds: { params: Omit<CacheInstantlyThreadIdsParams, 'organizationId'>; result: void }
+  transitionItem: { params: Omit<TransitionItemParams, 'organizationId'>; result: void }
+  setContactNurture: { params: Omit<SetContactNurtureParams, 'organizationId'>; result: void }
+  cancelSchedulesAndHitlByEmail: {
+    params: Omit<CancelSchedulesAndHitlByEmailParams, 'organizationId'>
+    result: { schedulesCancelled: number; hitlDeleted: number }
+  }
+  cancelHitlByDealId: { params: Omit<CancelHitlByDealIdParams, 'organizationId'>; result: { hitlDeleted: number } }
+  clearDealFields: { params: Omit<ClearDealFieldsParams, 'organizationId'>; result: void }
+  deleteDeal: { params: Omit<DeleteDealParams, 'organizationId'>; result: void }
+  recordDealActivity: {
+    params: Omit<RecordDealActivityParams, 'organizationId'>
+    result: void
+  }
+  // Deal note operations
+  createDealNote: {
+    params: Omit<CreateDealNoteParams, 'organizationId'>
+    result: AcqDealNote
+  }
+  listDealNotes: {
+    params: Omit<ListDealNotesParams, 'organizationId'>
+    result: AcqDealNote[]
+  }
+  // Deal task operations
+  createDealTask: {
+    params: Omit<CreateDealTaskParams, 'organizationId'>
+    result: AcqDealTask
+  }
+  listDealTasks: {
+    params: Omit<ListDealTasksParams, 'organizationId'>
+    result: AcqDealTask[]
+  }
+  listDealTasksDue: {
+    params: Omit<ListDealTasksDueParams, 'organizationId'>
+    result: AcqDealTask[]
+  }
+  completeDealTask: {
+    params: Omit<CompleteDealTaskParams, 'organizationId'>
+    result: AcqDealTask
+  }
+  // Deal query & analytics operations
+  listDeals: { params: DealFilters; result: AcqDeal[] }
+  getDealPipelineAnalytics: { params: { recentLimit?: number }; result: DealPipelineAnalytics }
+  // Enrichment data operations
+  mergeEnrichmentData: {
+    params: { id: string; table: 'acq_companies' | 'acq_contacts'; data: Record<string, unknown> }
+    result: void
+  }
+  // Social monitoring operations
+  upsertSocialPosts: {
+    params: { posts: Omit<UpsertSocialPostParams, 'organizationId'>[] }
+    result: UpsertSocialPostsResult
+  }
+  setDealStateKey: {
+    params: {
+      dealId: string
+      stateKey: string
+    }
+    result: { ok: true }
+  }
+  // CRM workflow helpers
+  transitionDeal: {
+    params: {
+      dealId: string
+      toStage: string
+      toState?: string
+    }
+    result: { deal: AcqDeal }
+  }
+  loadDeal: {
+    params: { dealId: string }
+    result: DealDetail | null
+  }
 }
 ```
 
 ### `ListToolMap`
 
 ```typescript
-export type ListToolMap = {
-  getConfig: {
-    params: { listId: string }
-    result: { scrapingConfig: ScrapingConfig; icp: IcpRubric; pipelineConfig: PipelineConfig }
-  }
-  recordExecution: {
-    params: Omit<RecordListExecutionParams, 'organizationId'>
-    result: void
-  }
-  updateCompanyStage: {
-    params: Omit<UpdateCompanyStageParams, 'organizationId'>
-    result: void
-  }
-  updateContactStage: {
-    params: Omit<UpdateContactStageParams, 'organizationId'>
-    result: void
-  }
-  listPendingCompanyIds: {
-    params: Omit<ListPendingCompanyIdsParams, 'organizationId'>
-    result: string[]
-  }
-  listPendingContactIds: {
-    params: Omit<ListPendingContactIdsParams, 'organizationId'>
-    result: string[]
-  }
+export type ListToolMap = {
+  getConfig: {
+    params: { listId: string }
+    result: { scrapingConfig: ScrapingConfig; icp: IcpRubric; pipelineConfig: PipelineConfig }
+  }
+  recordExecution: {
+    params: Omit<RecordListExecutionParams, 'organizationId'>
+    result: void
+  }
+  updateCompanyStage: {
+    params: Omit<UpdateCompanyStageParams, 'organizationId'>
+    result: void
+  }
+  updateContactStage: {
+    params: Omit<UpdateContactStageParams, 'organizationId'>
+    result: void
+  }
+  listPendingCompanyIds: {
+    params: Omit<ListPendingCompanyIdsParams, 'organizationId'>
+    result: string[]
+  }
+  listPendingContactIds: {
+    params: Omit<ListPendingContactIdsParams, 'organizationId'>
+    result: string[]
+  }
 }
 ```
 
@@ -3784,47 +3787,49 @@ export type ListToolMap = {
 ### `KnowledgeLinkSchema`
 
 ```typescript
-export const KnowledgeLinkSchema = z
-  .union([CanonicalKnowledgeLinkSchema, LegacyKnowledgeLinkSchema])
-  .transform((link) => {
-    const target = 'target' in link ? link.target : targetFromNodeId(link.nodeId)
-    return {
-      target,
-      nodeId: nodeIdFromTarget(target)
-    }
+export const KnowledgeLinkSchema = z
+  .union([CanonicalKnowledgeLinkSchema, LegacyKnowledgeLinkSchema])
+  .transform((link) => {
+    const target = 'target' in link ? link.target : targetFromNodeId(link.nodeId)
+    return {
+      target,
+      nodeId: nodeIdFromTarget(target)
+    }
   })
 ```
 
 ### `OrgKnowledgeKindSchema`
 
 ```typescript
-export const OrgKnowledgeKindSchema = z
-  .enum(['playbook', 'strategy', 'reference'])
+export const OrgKnowledgeKindSchema = z
+  .enum(['playbook', 'strategy', 'reference'])
   .meta({ label: 'Knowledge kind', color: 'grape' })
 ```
 
 ### `OrgKnowledgeNodeSchema`
 
 ```typescript
-export const OrgKnowledgeNodeSchema = z.object({
-  id: ModelIdSchema,
-  kind: OrgKnowledgeKindSchema,
-  title: z.string().trim().min(1).max(200),
-  summary: z.string().trim().min(1).max(1000),
+export const OrgKnowledgeNodeSchema = z.object({
+  id: ModelIdSchema,
+  kind: OrgKnowledgeKindSchema,
+  title: z.string().trim().min(1).max(200),
+  summary: z.string().trim().min(1).max(1000),
   icon: IconNameSchema.optional(),
   /** Canonical documentation URL when body content is a local summary. */
   externalUrl: z.string().trim().url().max(500).optional(),
+  /** Optional generated source file path for local MDX-backed knowledge nodes. */
+  sourceFilePath: z.string().trim().min(1).max(500).optional(),
   /** Raw MDX string. Phase 2 will introduce a structured block format. */
   body: z.string().trim().min(1),
-  /**
-   * Graph links to other OM nodes this knowledge node governs.
-   * Each link emits a `governs` edge: knowledge-node -> target node.
-   */
-  links: z.array(KnowledgeLinkSchema).default([]),
-  /** Role identifiers that own this knowledge node. */
-  ownerIds: z.array(RoleIdSchema.meta({ ref: 'role' })).default([]),
-  /** ISO date string (YYYY-MM-DD or full ISO 8601) of last meaningful update. */
-  updatedAt: z.string().trim().min(1).max(50)
+  /**
+   * Graph links to other OM nodes this knowledge node governs.
+   * Each link emits a `governs` edge: knowledge-node -> target node.
+   */
+  links: z.array(KnowledgeLinkSchema).default([]),
+  /** Role identifiers that own this knowledge node. */
+  ownerIds: z.array(RoleIdSchema.meta({ ref: 'role' })).default([]),
+  /** ISO date string (YYYY-MM-DD or full ISO 8601) of last meaningful update. */
+  updatedAt: z.string().trim().min(1).max(50)
 })
 ```