@elevasis/sdk 1.20.2 → 1.21.0

package/reference/scaffold/reference/contracts.md

@@ -18,34 +18,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`
@@ -60,58 +84,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' }>
 ```
 
-### `OrganizationModelOperations`
+### `OrganizationModelSidebarGroupNode`
 
 ```typescript
-export type OrganizationModelOperations = z.infer<typeof OperationsDomainSchema>
+export type OrganizationModelSidebarGroupNode = Extract<OrganizationModelSidebarNode, { type: 'group' }>
 ```
 
-### `OrganizationModelOperationEntry`
+### `OrganizationModelTechStackEntry`
 
 ```typescript
-export type OrganizationModelOperationEntry = z.infer<typeof OperationEntrySchema>
+export type OrganizationModelTechStackEntry = z.infer<typeof TechStackEntrySchema>
 ```
 
-### `OrganizationModelOperationSemanticClass`
+### `OrganizationModelStatuses`
+
+```typescript
+export type OrganizationModelStatuses = z.infer<typeof StatusesDomainSchema>
+```
+
+### `OrganizationModelStatusEntry`
 
 ```typescript
-export type OrganizationModelOperationSemanticClass = z.infer<typeof OperationSemanticClassSchema>
+export type OrganizationModelStatusEntry = z.infer<typeof StatusEntrySchema>
+```
+
+### `OrganizationModelStatusSemanticClass`
+
+```typescript
+export type OrganizationModelStatusSemanticClass = z.infer<typeof StatusSemanticClassSchema>
 ```
 
 ### `OrganizationModelCustomers`
@@ -228,15 +276,28 @@ export type OrganizationModelSystemEntry = z.infer<typeof SystemEntrySchema>
 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>
 ```
 
@@ -258,6 +319,24 @@ export type OrganizationModelResourceEntry = z.infer<typeof ResourceEntrySchema>
 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
@@ -276,6 +355,18 @@ export type OrganizationModelResourceGovernanceStatus = z.infer<typeof ResourceG
 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
@@ -294,6 +385,126 @@ export type OrganizationModelAgentResourceEntry = z.infer<typeof AgentResourceEn
 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
@@ -306,22 +517,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 KnowledgeTargetKind = z.infer<typeof KnowledgeTargetKindSchema>
+```
+
+### `KnowledgeTargetRef`
 
 ```typescript
-export type KnowledgeSkillBinding = z.infer<typeof KnowledgeSkillBindingSchema>
+export type KnowledgeTargetRef = z.infer<typeof KnowledgeTargetRefSchema>
 ```
 
-### `KnowledgeDomainBinding`
+### `KnowledgeLink`
 
 ```typescript
-export type KnowledgeDomainBinding = z.infer<typeof KnowledgeDomainBindingSchema>
+export type KnowledgeLink = z.infer<typeof KnowledgeLinkSchema>
 ```
 
 ### `OrganizationModelIconToken`
@@ -353,76 +576,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
 }
 ```
 
@@ -430,19 +657,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
@@ -455,8 +713,8 @@ export type ShellRouteMatchStatus = 'matched' | 'hidden' | 'unmatched'
 export interface ResolvedShellRouteMatch {
   status: ShellRouteMatchStatus
   path: string
-  feature?: ResolvedFeatureModule
-  node?: ResolvedShellFeature
+  system?: ResolvedSystemModule
+  node?: ResolvedShellSystem
 }
 ```
 
@@ -468,11 +726,11 @@ export interface ShellRuntime {
 }
 ```
 
-### `OrganizationGraphFeatureBridge`
+### `OrganizationGraphSystemBridge`
 
 ```typescript
-export interface OrganizationGraphFeatureBridge {
-  featureId: string
+export interface OrganizationGraphSystemBridge {
+  systemId?: string
 }
 ```
 
@@ -481,16 +739,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
@@ -502,14 +760,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
@@ -518,8 +777,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
 }
 ```
 
@@ -557,7 +816,7 @@ export type ExecutableResourceType = 'workflow' | 'agent'
 ### `ResourceSystemSummary`
 
 ```typescript
-export type ResourceSystemSummary = Pick<SystemEntry, 'id' | 'title' | 'description' | 'kind' | 'status'>
+export type ResourceSystemSummary = Pick<SystemEntry, 'id' | 'title' | 'description' | 'kind' | 'lifecycle'>
 ```
 
 ### `ResourceDefinition`
@@ -598,8 +857,8 @@ export interface ResourceDefinition {
   /** Whether the resource is local (monorepo) or remote (externally deployed) */
   origin?: 'local' | 'remote'
 
-  /** OM System membership, when backed by a Resource descriptor */
-  systemId?: string
+  /** 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
@@ -2701,7 +2960,7 @@ export const AcqListSchemas = {
   BuildPlanSnapshotStep: BuildPlanSnapshotStepSchema,
   AcqListMetadata: AcqListMetadataSchema,
   LeadGenStageKey: LeadGenStageKeySchema,
-  LeadGenCapabilityKey: LeadGenCapabilityKeySchema,
+  LeadGenActionKey: LeadGenActionKeySchema,
   ProcessingStageStatus: ProcessingStageStatusSchema,
   ProcessingState: ProcessingStateSchema,
   ListStageCounts: ListStageCountsSchema,
@@ -3525,15 +3784,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`
@@ -3545,6 +3812,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),
   /**
@@ -3552,12 +3821,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(),
   /** Role identifiers that own this knowledge node. */
-  ownerIds: z.array(RoleIdSchema).default([]),
+  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)
 })
@@ -3566,9 +3831,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`