@elevasis/core 0.21.0 → 0.23.0

package/src/reference/_generated/contracts.md

@@ -15,34 +15,58 @@ description: Auto-generated TypeScript contracts for SDK consumers. Do not edit
 export type OrganizationModel = z.infer<typeof OrganizationModelSchema>
 ```
 
+### `OrganizationModelDomainKey`
+
+```typescript
+export type OrganizationModelDomainKey = z.infer<typeof OrganizationModelDomainKeySchema>
+```
+
+### `OrganizationModelDomainMetadata`
+
+```typescript
+export type OrganizationModelDomainMetadata = z.infer<typeof OrganizationModelDomainMetadataSchema>
+```
+
+### `OrganizationModelDomainMetadataByDomain`
+
+```typescript
+export type OrganizationModelDomainMetadataByDomain = z.infer<typeof OrganizationModelDomainMetadataByDomainSchema>
+```
+
 ### `OrganizationModelBranding`
 
 ```typescript
 export type OrganizationModelBranding = z.infer<typeof OrganizationModelBrandingSchema>
 ```
 
-### `OrganizationModelSales`
+### `SalesPipeline`
 
 ```typescript
-export type OrganizationModelSales = z.infer<typeof OrganizationModelSalesSchema>
+export type SalesPipeline = z.infer<typeof SalesPipelineSchema>
 ```
 
-### `OrganizationModelProspecting`
+### `SalesStage`
 
 ```typescript
-export type OrganizationModelProspecting = z.infer<typeof OrganizationModelProspectingSchema>
+export type SalesStage = z.infer<typeof SalesStageSchema>
 ```
 
-### `OrganizationModelProjects`
+### `ProspectingBuildTemplate`
 
 ```typescript
-export type OrganizationModelProjects = z.infer<typeof OrganizationModelProjectsSchema>
+export type ProspectingBuildTemplate = z.infer<typeof ProspectingBuildTemplateSchema>
 ```
 
-### `OrganizationModelFeature`
+### `ProspectingLifecycleStage`
 
 ```typescript
-export type OrganizationModelFeature = z.infer<typeof FeatureSchema>
+export type ProspectingLifecycleStage = z.infer<typeof ProspectingLifecycleStageSchema>
+```
+
+### `ProjectsDomainState`
+
+```typescript
+export type ProjectsDomainState = z.infer<typeof ProjectsDomainStateSchema>
 ```
 
 ### `NodeIdPath`
@@ -57,58 +81,82 @@ export type NodeIdPath = z.infer<typeof NodeIdPathSchema>
 export type NodeIdString = z.infer<typeof NodeIdStringSchema>
 ```
 
+### `OrganizationModelSurface`
+
+```typescript
+export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
+```
+
+### `OrganizationModelNavigationGroup`
+
+```typescript
+export type OrganizationModelNavigationGroup = z.infer<typeof NavigationGroupSchema>
+```
+
 ### `OrganizationModelNavigation`
 
 ```typescript
 export type OrganizationModelNavigation = z.infer<typeof OrganizationModelNavigationSchema>
 ```
 
-### `OrganizationModelSurface`
+### `OrganizationModelSidebar`
 
 ```typescript
-export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
+export type OrganizationModelSidebar = z.infer<typeof SidebarNavigationSchema>
 ```
 
-### `OrganizationModelTechStackEntry`
+### `OrganizationModelSidebarSection`
 
 ```typescript
-export type OrganizationModelTechStackEntry = z.infer<typeof TechStackEntrySchema>
+export type OrganizationModelSidebarSection = z.infer<typeof SidebarSectionSchema>
 ```
 
-### `OrganizationModelStatuses`
+### `OrganizationModelSidebarNode`
 
 ```typescript
-export type OrganizationModelStatuses = z.infer<typeof StatusesDomainSchema>
+export type OrganizationModelSidebarNode = z.infer<typeof SidebarNodeSchema>
 ```
 
-### `OrganizationModelStatusEntry`
+### `OrganizationModelSidebarSurfaceTargets`
 
 ```typescript
-export type OrganizationModelStatusEntry = z.infer<typeof StatusEntrySchema>
+export type OrganizationModelSidebarSurfaceTargets = z.infer<typeof SidebarSurfaceTargetsSchema>
 ```
 
-### `OrganizationModelStatusSemanticClass`
+### `OrganizationModelSidebarSurfaceNode`
 
 ```typescript
-export type OrganizationModelStatusSemanticClass = z.infer<typeof StatusSemanticClassSchema>
+export type OrganizationModelSidebarSurfaceNode = Extract<OrganizationModelSidebarNode, { type: 'surface' }>
+```
+
+### `OrganizationModelSidebarGroupNode`
+
+```typescript
+export type OrganizationModelSidebarGroupNode = Extract<OrganizationModelSidebarNode, { type: 'group' }>
+```
+
+### `OrganizationModelTechStackEntry`
+
+```typescript
+export type OrganizationModelTechStackEntry = z.infer<typeof TechStackEntrySchema>
 ```
 
-### `OrganizationModelOperations`
+### `OrganizationModelStatuses`
 
 ```typescript
-export type OrganizationModelOperations = z.infer<typeof OperationsDomainSchema>
+export type OrganizationModelStatuses = z.infer<typeof StatusesDomainSchema>
 ```
 
-### `OrganizationModelOperationEntry`
+### `OrganizationModelStatusEntry`
 
 ```typescript
-export type OrganizationModelOperationEntry = z.infer<typeof OperationEntrySchema>
+export type OrganizationModelStatusEntry = z.infer<typeof StatusEntrySchema>
 ```
 
-### `OrganizationModelOperationSemanticClass`
+### `OrganizationModelStatusSemanticClass`
 
 ```typescript
-export type OrganizationModelOperationSemanticClass = z.infer<typeof OperationSemanticClassSchema>
+export type OrganizationModelStatusSemanticClass = z.infer<typeof StatusSemanticClassSchema>
 ```
 
 ### `OrganizationModelCustomers`
@@ -159,6 +207,36 @@ export type OrganizationModelRoles = z.infer<typeof RolesDomainSchema>
 export type OrganizationModelRole = z.infer<typeof RoleSchema>
 ```
 
+### `OrganizationModelRoleId`
+
+```typescript
+export type OrganizationModelRoleId = z.infer<typeof RoleIdSchema>
+```
+
+### `OrganizationModelRoleHolder`
+
+```typescript
+export type OrganizationModelRoleHolder = z.infer<typeof RoleHolderSchema>
+```
+
+### `OrganizationModelHumanRoleHolder`
+
+```typescript
+export type OrganizationModelHumanRoleHolder = z.infer<typeof HumanRoleHolderSchema>
+```
+
+### `OrganizationModelAgentRoleHolder`
+
+```typescript
+export type OrganizationModelAgentRoleHolder = z.infer<typeof AgentRoleHolderSchema>
+```
+
+### `OrganizationModelTeamRoleHolder`
+
+```typescript
+export type OrganizationModelTeamRoleHolder = z.infer<typeof TeamRoleHolderSchema>
+```
+
 ### `OrganizationModelGoals`
 
 ```typescript
@@ -177,6 +255,253 @@ export type OrganizationModelObjective = z.infer<typeof ObjectiveSchema>
 export type OrganizationModelKeyResult = z.infer<typeof KeyResultSchema>
 ```
 
+### `OrganizationModelSystems`
+
+```typescript
+export type OrganizationModelSystems = z.infer<typeof SystemsDomainSchema>
+```
+
+### `OrganizationModelSystemEntry`
+
+```typescript
+export type OrganizationModelSystemEntry = z.infer<typeof SystemEntrySchema>
+```
+
+### `OrganizationModelSystemId`
+
+```typescript
+export type OrganizationModelSystemId = z.infer<typeof SystemIdSchema>
+```
+
+### `OrganizationModelSystemPath`
+
+```typescript
+export type OrganizationModelSystemPath = z.infer<typeof SystemPathSchema>
+```
+
+### `OrganizationModelSystemKind`
+
+```typescript
+export type OrganizationModelSystemKind = z.infer<typeof SystemKindSchema>
+```
+
+### `OrganizationModelSystemLifecycle`
+
+```typescript
+export type OrganizationModelSystemLifecycle = z.infer<typeof SystemLifecycleSchema>
+```
+
+### `OrganizationModelSystemStatus`
+
+```typescript
+/** @deprecated Use OrganizationModelSystemLifecycle. Accepted for one publish cycle. */
+export type OrganizationModelSystemStatus = z.infer<typeof SystemStatusSchema>
+```
+
+### `OrganizationModelResources`
+
+```typescript
+export type OrganizationModelResources = z.infer<typeof ResourcesDomainSchema>
+```
+
+### `OrganizationModelResourceEntry`
+
+```typescript
+export type OrganizationModelResourceEntry = z.infer<typeof ResourceEntrySchema>
+```
+
+### `OrganizationModelResourceId`
+
+```typescript
+export type OrganizationModelResourceId = z.infer<typeof ResourceIdSchema>
+```
+
+### `EventId`
+
+```typescript
+export type EventId = z.infer<typeof EventIdSchema>
+```
+
+### `EventEmissionDescriptor`
+
+```typescript
+export type EventEmissionDescriptor = z.infer<typeof EventEmissionDescriptorSchema>
+```
+
+### `EventDescriptor`
+
+```typescript
+export type EventDescriptor = z.infer<typeof EventDescriptorSchema>
+```
+
+### `OrganizationModelResourceKind`
+
+```typescript
+export type OrganizationModelResourceKind = z.infer<typeof ResourceKindSchema>
+```
+
+### `OrganizationModelResourceGovernanceStatus`
+
+```typescript
+export type OrganizationModelResourceGovernanceStatus = z.infer<typeof ResourceGovernanceStatusSchema>
+```
+
+### `OrganizationModelAgentKind`
+
+```typescript
+export type OrganizationModelAgentKind = z.infer<typeof AgentKindSchema>
+```
+
+### `OrganizationModelScriptResourceLanguage`
+
+```typescript
+export type OrganizationModelScriptResourceLanguage = z.infer<typeof ScriptResourceLanguageSchema>
+```
+
+### `OrganizationModelScriptResourceSource`
+
+```typescript
+export type OrganizationModelScriptResourceSource = z.infer<typeof ScriptResourceSourceSchema>
+```
+
+### `OrganizationModelWorkflowResourceEntry`
+
+```typescript
+export type OrganizationModelWorkflowResourceEntry = z.infer<typeof WorkflowResourceEntrySchema>
+```
+
+### `OrganizationModelAgentResourceEntry`
+
+```typescript
+export type OrganizationModelAgentResourceEntry = z.infer<typeof AgentResourceEntrySchema>
+```
+
+### `OrganizationModelIntegrationResourceEntry`
+
+```typescript
+export type OrganizationModelIntegrationResourceEntry = z.infer<typeof IntegrationResourceEntrySchema>
+```
+
+### `OrganizationModelScriptResourceEntry`
+
+```typescript
+export type OrganizationModelScriptResourceEntry = z.infer<typeof ScriptResourceEntrySchema>
+```
+
+### `OrganizationModelActions`
+
+```typescript
+export type OrganizationModelActions = z.infer<typeof ActionsDomainSchema>
+```
+
+### `OrganizationModelAction`
+
+```typescript
+export type OrganizationModelAction = z.infer<typeof ActionSchema>
+```
+
+### `OrganizationModelActionId`
+
+```typescript
+export type OrganizationModelActionId = z.infer<typeof ActionIdSchema>
+```
+
+### `OrganizationModelActionScope`
+
+```typescript
+export type OrganizationModelActionScope = z.infer<typeof ActionScopeSchema>
+```
+
+### `OrganizationModelActionRef`
+
+```typescript
+export type OrganizationModelActionRef = z.infer<typeof ActionRefSchema>
+```
+
+### `OrganizationModelActionInvocationKind`
+
+```typescript
+export type OrganizationModelActionInvocationKind = z.infer<typeof ActionInvocationKindSchema>
+```
+
+### `OrganizationModelActionInvocation`
+
+```typescript
+export type OrganizationModelActionInvocation = z.infer<typeof ActionInvocationSchema>
+```
+
+### `EntityId`
+
+```typescript
+export type EntityId = z.infer<typeof EntityIdSchema>
+```
+
+### `EntityLink`
+
+```typescript
+export type EntityLink = z.infer<typeof EntityLinkSchema>
+```
+
+### `Entity`
+
+```typescript
+export type Entity = z.infer<typeof EntitySchema>
+```
+
+### `OrganizationModelEntity`
+
+```typescript
+export type OrganizationModelEntity = z.infer<typeof EntitySchema>
+```
+
+### `OrganizationModelEntities`
+
+```typescript
+export type OrganizationModelEntities = z.infer<typeof EntitiesDomainSchema>
+```
+
+### `OrganizationModelPolicies`
+
+```typescript
+export type OrganizationModelPolicies = z.infer<typeof PoliciesDomainSchema>
+```
+
+### `OrganizationModelPolicy`
+
+```typescript
+export type OrganizationModelPolicy = z.infer<typeof PolicySchema>
+```
+
+### `OrganizationModelPolicyId`
+
+```typescript
+export type OrganizationModelPolicyId = z.infer<typeof PolicyIdSchema>
+```
+
+### `OrganizationModelPolicyApplicability`
+
+```typescript
+export type OrganizationModelPolicyApplicability = z.infer<typeof PolicyApplicabilitySchema>
+```
+
+### `OrganizationModelPolicyTrigger`
+
+```typescript
+export type OrganizationModelPolicyTrigger = z.infer<typeof PolicyTriggerSchema>
+```
+
+### `OrganizationModelPolicyPredicate`
+
+```typescript
+export type OrganizationModelPolicyPredicate = z.infer<typeof PolicyPredicateSchema>
+```
+
+### `OrganizationModelPolicyEffect`
+
+```typescript
+export type OrganizationModelPolicyEffect = z.infer<typeof PolicyEffectSchema>
+```
+
 ### `OrganizationModelKnowledge`
 
 ```typescript
@@ -189,22 +514,34 @@ export type OrganizationModelKnowledge = z.infer<typeof KnowledgeDomainSchema>
 export type OrgKnowledgeNode = z.infer<typeof OrgKnowledgeNodeSchema>
 ```
 
+### `OrgKnowledgeNodeInput`
+
+```typescript
+export type OrgKnowledgeNodeInput = z.input<typeof OrgKnowledgeNodeSchema>
+```
+
 ### `OrgKnowledgeKind`
 
 ```typescript
 export type OrgKnowledgeKind = z.infer<typeof OrgKnowledgeKindSchema>
 ```
 
-### `KnowledgeSkillBinding`
+### `KnowledgeTargetKind`
 
 ```typescript
-export type KnowledgeSkillBinding = z.infer<typeof KnowledgeSkillBindingSchema>
+export type KnowledgeTargetKind = z.infer<typeof KnowledgeTargetKindSchema>
 ```
 
-### `KnowledgeDomainBinding`
+### `KnowledgeTargetRef`
 
 ```typescript
-export type KnowledgeDomainBinding = z.infer<typeof KnowledgeDomainBindingSchema>
+export type KnowledgeTargetRef = z.infer<typeof KnowledgeTargetRefSchema>
+```
+
+### `KnowledgeLink`
+
+```typescript
+export type KnowledgeLink = z.infer<typeof KnowledgeLinkSchema>
 ```
 
 ### `OrganizationModelIconToken`
@@ -236,76 +573,80 @@ export type ElevasisOrganizationModel = Omit<OrganizationModel, 'knowledge'> & {
 }
 ```
 
-### `FeatureSidebarComponent`
+### `SystemSidebarComponent`
 
 ```typescript
-export type FeatureSidebarComponent = ComponentType
+export type SystemSidebarComponent = ComponentType
 ```
 
-### `FeatureIconComponent`
+### `SystemIconComponent`
 
 ```typescript
-export type FeatureIconComponent = ComponentType<{ size?: number; stroke?: number }>
+export type SystemIconComponent = ComponentType<{ size?: number; stroke?: number }>
 ```
 
-### `FeatureSidebarWidthResolver`
+### `SystemSidebarWidthResolver`
 
 ```typescript
-export type FeatureSidebarWidthResolver = number | ((context: { currentPath: string }) => number)
+export type SystemSidebarWidthResolver = number | ((context: { currentPath: string }) => number)
 ```
 
-### `FeatureModule`
+### `SystemModule`
 
 ```typescript
-export interface FeatureModule {
-  /** Unique stable identifier for this feature module. */
+export interface SystemModule {
+  /** Unique stable identifier for this UI system module. */
   key: string
-  /** Organization Model feature id this module presents. */
-  featureId: string
-  /** Capability identifiers contributed by this feature module. */
+  /** 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 feature node appears in shell navigation. */
-  icon?: FeatureIconComponent
-  /** Sidebar component rendered when this feature's subtree route is active. */
-  sidebar?: FeatureSidebarComponent
+  /** 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?: FeatureSidebarWidthResolver
-  /** Operations-only bridge connecting this feature to the organization graph node. */
-  organizationGraph?: OrganizationGraphFeatureBridge
+  sidebarWidth?: SystemSidebarWidthResolver
+  /** Operations-only bridge connecting this system to the organization graph node. */
+  organizationGraph?: OrganizationGraphSystemBridge
 }
 ```
 
-### `ResolvedFeatureAccess`
+### `ResolvedSystemAccess`
 
 ```typescript
-export interface ResolvedFeatureAccess {
-  featureId: string
+export interface ResolvedSystemAccess {
+  featureKey: string
+  systemId?: string
   enabled: boolean
 }
 ```
 
-### `ResolvedFeatureSemantics`
+### `ResolvedSystemSemantics`
 
 ```typescript
-export interface ResolvedFeatureSemantics {
+export interface ResolvedSystemSemantics {
   capabilityIds: string[]
 }
 ```
 
-### `ResolvedFeatureModule`
+### `ResolvedSystemModule`
 
 ```typescript
-export interface ResolvedFeatureModule extends FeatureModule {
-  access: ResolvedFeatureAccess
-  semantics: ResolvedFeatureSemantics
+export interface ResolvedSystemModule extends SystemModule {
+  access: ResolvedSystemAccess
+  semantics: ResolvedSystemSemantics
 }
 ```
 
-### `ResolvedShellFeature`
+### `ResolvedShellSystem`
 
 ```typescript
-export interface ResolvedShellFeature extends OrganizationModelFeature {
-  iconComponent?: FeatureIconComponent
+export type ResolvedShellSystem = OrganizationModelSystemEntry & {
+  label: string
+  iconComponent?: SystemIconComponent
 }
 ```
 
@@ -313,19 +654,50 @@ export interface ResolvedShellFeature extends OrganizationModelFeature {
 
 ```typescript
 export interface ResolvedShellModel {
-  features: readonly ResolvedShellFeature[]
-  findByPath: (path: string) => ResolvedShellFeature | undefined
-  findById: (id: string) => ResolvedShellFeature | undefined
-  childrenOf: (id: string) => ResolvedShellFeature[]
-  ancestorsOf: (id: string) => ResolvedShellFeature[]
-  parentOf: (id: string) => ResolvedShellFeature | undefined
-  topLevel: () => ResolvedShellFeature[]
-  uiPositionFor: (id: string) => OrganizationModelFeature['uiPosition'] | undefined
+  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[]
+}
+```
+
+### `ShellSidebarLinkGroup`
+
+```typescript
+export interface ShellSidebarLinkGroup {
+  icon: SystemIconComponent
+  label: string
+  links?: ShellSidebarLinkItem[]
+  link?: string
+}
+```
+
+### `ShellSidebarProjectionOptions`
+
+```typescript
+export interface ShellSidebarProjectionOptions {
+  isPlatformAdmin?: boolean
+  isDev?: boolean
+  section?: 'primary' | 'bottom'
+}
+```
+
 ### `ShellRouteMatchStatus`
 
 ```typescript
@@ -338,8 +710,8 @@ export type ShellRouteMatchStatus = 'matched' | 'hidden' | 'unmatched'
 export interface ResolvedShellRouteMatch {
   status: ShellRouteMatchStatus
   path: string
-  feature?: ResolvedFeatureModule
-  node?: ResolvedShellFeature
+  system?: ResolvedSystemModule
+  node?: ResolvedShellSystem
 }
 ```
 
@@ -351,11 +723,11 @@ export interface ShellRuntime {
 }
 ```
 
-### `OrganizationGraphFeatureBridge`
+### `OrganizationGraphSystemBridge`
 
 ```typescript
-export interface OrganizationGraphFeatureBridge {
-  featureId: string
+export interface OrganizationGraphSystemBridge {
+  systemId?: string
 }
 ```
 
@@ -364,16 +736,16 @@ export interface OrganizationGraphFeatureBridge {
 ```typescript
 export interface OrganizationGraphContextValue {
   available: boolean
-  featureId?: string
-  featurePath?: string
+  systemId?: string
+  systemPath?: string
 }
 ```
 
-### `ElevasisFeaturesProviderProps`
+### `ElevasisSystemsProviderProps`
 
 ```typescript
-export interface ElevasisFeaturesProviderProps {
-  features: FeatureModule[]
+export interface ElevasisSystemsProviderProps {
+  systems?: SystemModule[]
   organizationModel?: ElevasisOrganizationModel
   timeRange?: TimeRange
   operationsApiUrl?: string
@@ -385,14 +757,15 @@ export interface ElevasisFeaturesProviderProps {
 }
 ```
 
-### `ElevasisFeaturesContextValue`
+### `ElevasisSystemsContextValue`
 
 ```typescript
-export interface ElevasisFeaturesContextValue {
+export interface ElevasisSystemsContextValue {
   shellModel: ResolvedShellModel
   shellRuntime: ShellRuntime
-  enabledResolvedFeatures: ResolvedFeatureModule[]
-  resolvedFeatures: ResolvedFeatureModule[]
+  getSidebarLinks: (options?: ShellSidebarProjectionOptions) => ShellSidebarLinkGroup[]
+  enabledResolvedSystems: ResolvedSystemModule[]
+  resolvedSystems: ResolvedSystemModule[]
   organizationGraph: OrganizationGraphContextValue
   organizationModel?: OrganizationModel
   timeRange?: TimeRange
@@ -401,8 +774,8 @@ export interface ElevasisFeaturesContextValue {
   deliveryApiUrl?: string
   deliverySSEManager?: SSEConnectionManagerLike
   disabledSubsectionPaths: string[]
-  isFeatureEnabled: (key: string) => boolean
-  getResolvedFeature: (key: string) => ResolvedFeatureModule | undefined
+  isSystemEnabled: (key: string) => boolean
+  getResolvedSystem: (key: string) => ResolvedSystemModule | undefined
 }
 ```
 
@@ -411,413 +784,464 @@ export interface ElevasisFeaturesContextValue {
 ### `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'
 ```
 
+### `ResourceSystemSummary`
+
+```typescript
+export type ResourceSystemSummary = Pick<SystemEntry, 'id' | 'title' | 'description' | 'kind' | 'lifecycle'>
+```
+
 ### `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
-
+/**
+ * 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'
-
-  /** Whether this resource is archived and should be excluded from registration and deployment */
-  archived?: boolean
+
+  /** 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
+}
+```
+
+### `RuntimeResourceDescriptor`
+
+```typescript
+export type RuntimeResourceDescriptor = Extract<ResourceEntry, { kind: 'workflow' | 'agent' | 'integration' }>
+```
+
+### `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
 }
 ```
 
+### `BoundResourceDefinition`
+
+```typescript
+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'
+ */
+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):
+/**
+ * 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
+ * - 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):
+/**
+ * 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'
-
-  /** Integration provider type */
-  provider: IntegrationType
-  /** References credentials table (e.g., 'shopify-prod', 'zendesk-api') */
-  credentialName: string
+ * - 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):
+/**
+ * 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.
+ * - 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):
+/**
+ * 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[]
-  }
+ * - 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[]
+  }
 }
 ```
 
@@ -835,6 +1259,11 @@ export interface HumanCheckpointDefinition extends ResourceDefinition {
 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 */
@@ -1155,6 +1584,9 @@ export const DealTaskIdParamsSchema = z.object({
 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)
@@ -1300,6 +1732,7 @@ 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(),
@@ -1348,7 +1781,8 @@ export const DealListResponseSchema = z.object({
  * Additive fields keep existing DealListItem callers compatible.
  */
 export const DealDetailResponseSchema = DealListItemSchema.extend({
-  conversation: DealConversationSchema
+  conversation: DealConversationSchema,
+  lineage: DealLineageSchema.optional()
 })
 ```
 
@@ -1437,6 +1871,10 @@ export const DealSchemas = {
   DealSummaryResponse: DealSummaryResponseSchema,
   DealLookupResponse: DealLookupResponseSchema,
   ConversationMessage: ConversationMessageSchema,
+  DealLineageListRef: DealLineageListRefSchema,
+  DealLineageProjectRef: DealLineageProjectRefSchema,
+  DealLineageClientRef: DealLineageClientRefSchema,
+  DealLineage: DealLineageSchema,
   DealDetailResponse: DealDetailResponseSchema,
   DealNoteResponse: DealNoteResponseSchema,
   DealNoteListResponse: DealNoteListResponseSchema,
@@ -2093,6 +2531,7 @@ export const ListContactsQuerySchema = z
 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(),
@@ -2115,6 +2554,7 @@ export const CreateCompanyRequestSchema = z
 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(),
@@ -2136,6 +2576,7 @@ export const UpdateCompanyRequestSchema = z
   .refine(
     (data) =>
       data.name !== undefined ||
+      data.clientId !== undefined ||
       data.domain !== undefined ||
       data.linkedinUrl !== undefined ||
       data.website !== undefined ||
@@ -2164,6 +2605,7 @@ export const UpdateCompanyRequestSchema = z
 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(),
@@ -2183,6 +2625,7 @@ export const CreateContactRequestSchema = z
 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(),
@@ -2200,6 +2643,7 @@ export const UpdateContactRequestSchema = z
   .refine(
     (data) =>
       data.companyId !== undefined ||
+      data.clientId !== undefined ||
       data.emailValid !== undefined ||
       data.firstName !== undefined ||
       data.lastName !== undefined ||
@@ -2224,6 +2668,7 @@ export const UpdateContactRequestSchema = z
 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(),
@@ -2290,6 +2735,7 @@ export const AcqContactCompanySummarySchema = z.object({
 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(),
@@ -2511,13 +2957,15 @@ export const AcqListSchemas = {
   BuildPlanSnapshotStep: BuildPlanSnapshotStepSchema,
   AcqListMetadata: AcqListMetadataSchema,
   LeadGenStageKey: LeadGenStageKeySchema,
-  LeadGenCapabilityKey: LeadGenCapabilityKeySchema,
+  LeadGenActionKey: LeadGenActionKeySchema,
   ProcessingStageStatus: ProcessingStageStatusSchema,
   ProcessingState: ProcessingStateSchema,
   ListStageCounts: ListStageCountsSchema,
   ListTelemetry: ListTelemetrySchema,
 
   // Requests
+  ListReadQuery: ListReadQuerySchema,
+  GetListQuery: GetListQuerySchema,
   CreateListRequest: CreateListRequestSchema,
   UpdateListRequest: UpdateListRequestSchema,
   UpdateListStatusRequest: UpdateListStatusRequestSchema,
@@ -2529,7 +2977,11 @@ export const AcqListSchemas = {
 
   // Responses
   AcqListResponse: AcqListResponseSchema,
+  AcqListDetailResponse: AcqListDetailResponseSchema,
   AcqListListResponse: AcqListListResponseSchema,
+  AcqListDealRef: AcqListDealRefSchema,
+  AcqListLineage: AcqListLineageSchema,
+  AcqListStatusResponse: AcqListStatusResponseSchema,
   ListTelemetryResponse: ListTelemetryResponseSchema,
   ListTelemetryListResponse: ListTelemetryListResponseSchema,
   ListExecutionsResponse: ListExecutionsResponseSchema,
@@ -3329,15 +3781,23 @@ export type ListToolMap = {
 ### `KnowledgeLinkSchema`
 
 ```typescript
-export const KnowledgeLinkSchema = z.object({
-  nodeId: NodeIdStringSchema
-})
+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`
@@ -3349,6 +3809,8 @@ export const OrgKnowledgeNodeSchema = z.object({
   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(),
   /** Raw MDX string. Phase 2 will introduce a structured block format. */
   body: z.string().trim().min(1),
   /**
@@ -3356,12 +3818,8 @@ export const OrgKnowledgeNodeSchema = z.object({
    * Each link emits a `governs` edge: knowledge-node -> target node.
    */
   links: z.array(KnowledgeLinkSchema).default([]),
-  /** Operator skill or command bindings relevant to this node. */
-  skills: z.array(KnowledgeSkillBindingSchema).optional(),
-  /** Domain key used to derive fast graph->skill registries. */
-  domain: KnowledgeDomainBindingSchema.optional(),
-  /** Identifiers of the roles or members who own this knowledge node. */
-  ownerIds: z.array(ModelIdSchema).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)
 })
@@ -3370,9 +3828,7 @@ export const OrgKnowledgeNodeSchema = z.object({
 ### `KnowledgeDomainSchema`
 
 ```typescript
-export const KnowledgeDomainSchema = z.object({
-  nodes: z.array(OrgKnowledgeNodeSchema).default([])
-})
+export const KnowledgeDomainSchema = z.record(ModelIdSchema, OrgKnowledgeNodeSchema).default({})
 ```
 
 ### `OrgKnowledgeNode`