@elevasis/core 0.25.0 → 0.26.0

package/src/organization-model/types.ts

@@ -1,57 +1,58 @@
-import type { z } from 'zod'
-import { OrganizationModelBrandingSchema } from './domains/branding'
-import { SalesPipelineSchema, SalesStageSchema } from './domains/sales'
-import { ProjectsDomainStateSchema } from './domains/projects'
-import { NodeIdPathSchema, NodeIdStringSchema } from './domains/systems'
-import { ProspectingBuildTemplateSchema, ProspectingLifecycleStageSchema } from './domains/prospecting'
-import {
-  NavigationGroupSchema,
-  OrganizationModelNavigationSchema,
-  SidebarNavigationSchema,
-  SidebarNodeSchema,
-  SidebarSectionSchema,
-  SidebarSurfaceTargetsSchema,
-  SurfaceDefinitionSchema
-} from './domains/navigation'
-import { TechStackEntrySchema } from './domains/shared'
-import { StatusesDomainSchema, StatusEntrySchema, StatusSemanticClassSchema } from './domains/statuses'
-import { CustomersDomainSchema, CustomerSegmentSchema, FirmographicsSchema } from './domains/customers'
-import { OfferingsDomainSchema, ProductSchema, PricingModelSchema } from './domains/offerings'
-import {
-  AgentRoleHolderSchema,
-  HumanRoleHolderSchema,
-  RoleHolderSchema,
-  RoleIdSchema,
-  RolesDomainSchema,
-  RoleSchema,
-  TeamRoleHolderSchema
-} from './domains/roles'
-import { GoalsDomainSchema, ObjectiveSchema, KeyResultSchema } from './domains/goals'
-import {
-  KnowledgeDomainSchema,
-  KnowledgeLinkSchema,
-  KnowledgeTargetKindSchema,
-  KnowledgeTargetRefSchema,
-  OrgKnowledgeKindSchema,
-  OrgKnowledgeNodeSchema
-} from './domains/knowledge'
-import {
+import type { z } from 'zod'
+import { OrganizationModelBrandingSchema } from './domains/branding'
+import { SalesPipelineSchema, SalesStageSchema } from './domains/sales'
+import { ProjectsDomainStateSchema } from './domains/projects'
+import { NodeIdPathSchema, NodeIdStringSchema } from './domains/systems'
+import { ProspectingBuildTemplateSchema, ProspectingLifecycleStageSchema } from './domains/prospecting'
+import {
+  NavigationGroupSchema,
+  OrganizationModelNavigationSchema,
+  SidebarNavigationSchema,
+  SidebarNodeSchema,
+  SidebarSectionSchema,
+  SidebarSurfaceTargetsSchema,
+  SurfaceDefinitionSchema
+} from './domains/navigation'
+import { TechStackEntrySchema } from './domains/shared'
+import { StatusesDomainSchema, StatusEntrySchema, StatusSemanticClassSchema } from './domains/statuses'
+import { CustomersDomainSchema, CustomerSegmentSchema, FirmographicsSchema } from './domains/customers'
+import { OfferingsDomainSchema, ProductSchema, PricingModelSchema } from './domains/offerings'
+import {
+  AgentRoleHolderSchema,
+  HumanRoleHolderSchema,
+  RoleHolderSchema,
+  RoleIdSchema,
+  RolesDomainSchema,
+  RoleSchema,
+  TeamRoleHolderSchema
+} from './domains/roles'
+import { GoalsDomainSchema, ObjectiveSchema, KeyResultSchema } from './domains/goals'
+import {
+  KnowledgeDomainSchema,
+  KnowledgeLinkSchema,
+  KnowledgeTargetKindSchema,
+  KnowledgeTargetRefSchema,
+  OrgKnowledgeKindSchema,
+  OrgKnowledgeNodeSchema
+} from './domains/knowledge'
+import {
   SystemEntrySchema,
   SystemConfigSchema,
   SystemIdSchema,
-  SystemKindSchema,
-  SystemLifecycleSchema,
-  SystemPathSchema,
-  SystemStatusSchema,
-  SystemsDomainSchema
-} from './domains/systems'
-import {
-  AgentKindSchema,
-  AgentResourceEntrySchema,
-  CodeReferenceRoleSchema,
-  CodeReferenceSchema,
-  EventDescriptorSchema,
-  EventEmissionDescriptorSchema,
+  SystemKindSchema,
+  SystemLifecycleSchema,
+  SystemPathSchema,
+  SystemStatusSchema,
+  SystemsDomainSchema
+} from './domains/systems'
+import {
+  AgentKindSchema,
+  AgentResourceEntrySchema,
+  CodeReferenceRoleSchema,
+  CodeReferenceSchema,
+  ContractRefSchema,
+  EventDescriptorSchema,
+  EventEmissionDescriptorSchema,
   EventIdSchema,
   IntegrationResourceEntrySchema,
   ResourceEntrySchema,
@@ -63,7 +64,9 @@ import {
   ScriptResourceEntrySchema,
   ScriptResourceLanguageSchema,
   ScriptResourceSourceSchema,
-  WorkflowResourceEntrySchema
+  WorkflowResourceEntrySchema,
+  type ParsedContractRef,
+  type ResourceOntologyBindingContract
 } from './domains/resources'
 import {
   OmTopologyDomainSchema,
@@ -73,75 +76,75 @@ import {
   OmTopologyRelationshipKindSchema,
   OmTopologyRelationshipSchema
 } from './domains/topology'
-import {
-  ActionsDomainSchema,
-  ActionIdSchema,
-  ActionInvocationKindSchema,
-  ActionInvocationSchema,
-  ActionRefSchema,
-  ActionSchema,
-  ActionScopeSchema
-} from './domains/actions'
-import { EntitiesDomainSchema, EntityIdSchema, EntityLinkSchema, EntitySchema } from './domains/entities'
-import {
-  PoliciesDomainSchema,
-  PolicyEffectSchema,
-  PolicyApplicabilitySchema,
-  PolicyIdSchema,
-  PolicyPredicateSchema,
-  PolicySchema,
-  PolicyTriggerSchema
-} from './domains/policies'
+import {
+  ActionsDomainSchema,
+  ActionIdSchema,
+  ActionInvocationKindSchema,
+  ActionInvocationSchema,
+  ActionRefSchema,
+  ActionSchema,
+  ActionScopeSchema
+} from './domains/actions'
+import { EntitiesDomainSchema, EntityIdSchema, EntityLinkSchema, EntitySchema } from './domains/entities'
+import {
+  PoliciesDomainSchema,
+  PolicyEffectSchema,
+  PolicyApplicabilitySchema,
+  PolicyIdSchema,
+  PolicyPredicateSchema,
+  PolicySchema,
+  PolicyTriggerSchema
+} from './domains/policies'
 import { OrganizationModelIconTokenSchema, OrganizationModelBuiltinIconTokenSchema } from './icons'
 import { OntologyScopeSchema } from './ontology'
 import {
   OrganizationModelDomainKeySchema,
-  OrganizationModelDomainMetadataByDomainSchema,
-  OrganizationModelDomainMetadataSchema,
-  OrganizationModelSchema
-} from './schema'
-
-export type OrganizationModel = z.infer<typeof OrganizationModelSchema>
-export type OrganizationModelDomainKey = z.infer<typeof OrganizationModelDomainKeySchema>
-export type OrganizationModelDomainMetadata = z.infer<typeof OrganizationModelDomainMetadataSchema>
-export type OrganizationModelDomainMetadataByDomain = z.infer<typeof OrganizationModelDomainMetadataByDomainSchema>
-export type OrganizationModelBranding = z.infer<typeof OrganizationModelBrandingSchema>
-// Phase 4: OrganizationModelSales, OrganizationModelProspecting, OrganizationModelProjects,
-// OrganizationModelNavigation removed — compound domain top-level fields deleted per D8/D1.
-// Retained as local aliases for content-kind payload shapes used in migration-helpers:
-export type SalesPipeline = z.infer<typeof SalesPipelineSchema>
-export type SalesStage = z.infer<typeof SalesStageSchema>
-export type ProspectingBuildTemplate = z.infer<typeof ProspectingBuildTemplateSchema>
-export type ProspectingLifecycleStage = z.infer<typeof ProspectingLifecycleStageSchema>
-export type ProjectsDomainState = z.infer<typeof ProjectsDomainStateSchema>
-export type NodeIdPath = z.infer<typeof NodeIdPathSchema>
-export type NodeIdString = z.infer<typeof NodeIdStringSchema>
-export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
-export type OrganizationModelNavigationGroup = z.infer<typeof NavigationGroupSchema>
-export type OrganizationModelNavigation = z.infer<typeof OrganizationModelNavigationSchema>
-export type OrganizationModelSidebar = z.infer<typeof SidebarNavigationSchema>
-export type OrganizationModelSidebarSection = z.infer<typeof SidebarSectionSchema>
-export type OrganizationModelSidebarNode = z.infer<typeof SidebarNodeSchema>
-export type OrganizationModelSidebarSurfaceTargets = z.infer<typeof SidebarSurfaceTargetsSchema>
-export type OrganizationModelSidebarSurfaceNode = Extract<OrganizationModelSidebarNode, { type: 'surface' }>
-export type OrganizationModelSidebarGroupNode = Extract<OrganizationModelSidebarNode, { type: 'group' }>
-export type OrganizationModelTechStackEntry = z.infer<typeof TechStackEntrySchema>
-export type OrganizationModelStatuses = z.infer<typeof StatusesDomainSchema>
-export type OrganizationModelStatusEntry = z.infer<typeof StatusEntrySchema>
-export type OrganizationModelStatusSemanticClass = z.infer<typeof StatusSemanticClassSchema>
-export type OrganizationModelCustomers = z.infer<typeof CustomersDomainSchema>
-export type OrganizationModelCustomerSegment = z.infer<typeof CustomerSegmentSchema>
-export type OrganizationModelCustomerFirmographics = z.infer<typeof FirmographicsSchema>
-export type OrganizationModelOfferings = z.infer<typeof OfferingsDomainSchema>
-export type OrganizationModelProduct = z.infer<typeof ProductSchema>
-export type OrganizationModelPricingModel = z.infer<typeof PricingModelSchema>
-export type OrganizationModelRoles = z.infer<typeof RolesDomainSchema>
-export type OrganizationModelRole = z.infer<typeof RoleSchema>
-export type OrganizationModelRoleId = z.infer<typeof RoleIdSchema>
-export type OrganizationModelRoleHolder = z.infer<typeof RoleHolderSchema>
-export type OrganizationModelHumanRoleHolder = z.infer<typeof HumanRoleHolderSchema>
-export type OrganizationModelAgentRoleHolder = z.infer<typeof AgentRoleHolderSchema>
-export type OrganizationModelTeamRoleHolder = z.infer<typeof TeamRoleHolderSchema>
+  OrganizationModelDomainMetadataByDomainSchema,
+  OrganizationModelDomainMetadataSchema,
+  OrganizationModelSchema
+} from './schema'
+
+export type OrganizationModel = z.infer<typeof OrganizationModelSchema>
+export type OrganizationModelDomainKey = z.infer<typeof OrganizationModelDomainKeySchema>
+export type OrganizationModelDomainMetadata = z.infer<typeof OrganizationModelDomainMetadataSchema>
+export type OrganizationModelDomainMetadataByDomain = z.infer<typeof OrganizationModelDomainMetadataByDomainSchema>
+export type OrganizationModelBranding = z.infer<typeof OrganizationModelBrandingSchema>
+// Phase 4: OrganizationModelSales, OrganizationModelProspecting, OrganizationModelProjects,
+// OrganizationModelNavigation removed — compound domain top-level fields deleted per D8/D1.
+// Retained as local aliases for content-kind payload shapes used in migration-helpers:
+export type SalesPipeline = z.infer<typeof SalesPipelineSchema>
+export type SalesStage = z.infer<typeof SalesStageSchema>
+export type ProspectingBuildTemplate = z.infer<typeof ProspectingBuildTemplateSchema>
+export type ProspectingLifecycleStage = z.infer<typeof ProspectingLifecycleStageSchema>
+export type ProjectsDomainState = z.infer<typeof ProjectsDomainStateSchema>
+export type NodeIdPath = z.infer<typeof NodeIdPathSchema>
+export type NodeIdString = z.infer<typeof NodeIdStringSchema>
+export type OrganizationModelSurface = z.infer<typeof SurfaceDefinitionSchema>
+export type OrganizationModelNavigationGroup = z.infer<typeof NavigationGroupSchema>
+export type OrganizationModelNavigation = z.infer<typeof OrganizationModelNavigationSchema>
+export type OrganizationModelSidebar = z.infer<typeof SidebarNavigationSchema>
+export type OrganizationModelSidebarSection = z.infer<typeof SidebarSectionSchema>
+export type OrganizationModelSidebarNode = z.infer<typeof SidebarNodeSchema>
+export type OrganizationModelSidebarSurfaceTargets = z.infer<typeof SidebarSurfaceTargetsSchema>
+export type OrganizationModelSidebarSurfaceNode = Extract<OrganizationModelSidebarNode, { type: 'surface' }>
+export type OrganizationModelSidebarGroupNode = Extract<OrganizationModelSidebarNode, { type: 'group' }>
+export type OrganizationModelTechStackEntry = z.infer<typeof TechStackEntrySchema>
+export type OrganizationModelStatuses = z.infer<typeof StatusesDomainSchema>
+export type OrganizationModelStatusEntry = z.infer<typeof StatusEntrySchema>
+export type OrganizationModelStatusSemanticClass = z.infer<typeof StatusSemanticClassSchema>
+export type OrganizationModelCustomers = z.infer<typeof CustomersDomainSchema>
+export type OrganizationModelCustomerSegment = z.infer<typeof CustomerSegmentSchema>
+export type OrganizationModelCustomerFirmographics = z.infer<typeof FirmographicsSchema>
+export type OrganizationModelOfferings = z.infer<typeof OfferingsDomainSchema>
+export type OrganizationModelProduct = z.infer<typeof ProductSchema>
+export type OrganizationModelPricingModel = z.infer<typeof PricingModelSchema>
+export type OrganizationModelRoles = z.infer<typeof RolesDomainSchema>
+export type OrganizationModelRole = z.infer<typeof RoleSchema>
+export type OrganizationModelRoleId = z.infer<typeof RoleIdSchema>
+export type OrganizationModelRoleHolder = z.infer<typeof RoleHolderSchema>
+export type OrganizationModelHumanRoleHolder = z.infer<typeof HumanRoleHolderSchema>
+export type OrganizationModelAgentRoleHolder = z.infer<typeof AgentRoleHolderSchema>
+export type OrganizationModelTeamRoleHolder = z.infer<typeof TeamRoleHolderSchema>
 export type OrganizationModelGoals = z.infer<typeof GoalsDomainSchema>
 export type OrganizationModelObjective = z.infer<typeof ObjectiveSchema>
 export type OrganizationModelKeyResult = z.infer<typeof KeyResultSchema>
@@ -150,22 +153,25 @@ export type OrganizationModelSystems = z.infer<typeof SystemsDomainSchema>
 export type OrganizationModelSystemEntry = z.infer<typeof SystemEntrySchema>
 export type OrganizationModelSystemConfig = z.infer<typeof SystemConfigSchema>
 export type OrganizationModelSystemId = z.infer<typeof SystemIdSchema>
-export type OrganizationModelSystemPath = z.infer<typeof SystemPathSchema>
-export type OrganizationModelSystemKind = z.infer<typeof SystemKindSchema>
-export type OrganizationModelSystemLifecycle = z.infer<typeof SystemLifecycleSchema>
-/** @deprecated Use OrganizationModelSystemLifecycle. Accepted for one publish cycle. */
-export type OrganizationModelSystemStatus = z.infer<typeof SystemStatusSchema>
-export type OrganizationModelResources = z.infer<typeof ResourcesDomainSchema>
-export type OrganizationModelResourceEntry = z.infer<typeof ResourceEntrySchema>
-export type OrganizationModelResourceId = z.infer<typeof ResourceIdSchema>
-export type OrganizationModelCodeReference = z.infer<typeof CodeReferenceSchema>
-export type OrganizationModelCodeReferenceRole = z.infer<typeof CodeReferenceRoleSchema>
-export type EventId = z.infer<typeof EventIdSchema>
-export type EventEmissionDescriptor = z.infer<typeof EventEmissionDescriptorSchema>
-export type EventDescriptor = z.infer<typeof EventDescriptorSchema>
-export type OrganizationModelResourceKind = z.infer<typeof ResourceKindSchema>
+export type OrganizationModelSystemPath = z.infer<typeof SystemPathSchema>
+export type OrganizationModelSystemKind = z.infer<typeof SystemKindSchema>
+export type OrganizationModelSystemLifecycle = z.infer<typeof SystemLifecycleSchema>
+/** @deprecated Use OrganizationModelSystemLifecycle. Accepted for one publish cycle. */
+export type OrganizationModelSystemStatus = z.infer<typeof SystemStatusSchema>
+export type OrganizationModelResources = z.infer<typeof ResourcesDomainSchema>
+export type OrganizationModelResourceEntry = z.infer<typeof ResourceEntrySchema>
+export type OrganizationModelResourceId = z.infer<typeof ResourceIdSchema>
+export type OrganizationModelCodeReference = z.infer<typeof CodeReferenceSchema>
+export type OrganizationModelCodeReferenceRole = z.infer<typeof CodeReferenceRoleSchema>
+export type EventId = z.infer<typeof EventIdSchema>
+export type EventEmissionDescriptor = z.infer<typeof EventEmissionDescriptorSchema>
+export type EventDescriptor = z.infer<typeof EventDescriptorSchema>
+export type OrganizationModelResourceKind = z.infer<typeof ResourceKindSchema>
 export type OrganizationModelResourceGovernanceStatus = z.infer<typeof ResourceGovernanceStatusSchema>
 export type OrganizationModelResourceOntologyBinding = z.infer<typeof ResourceOntologyBindingSchema>
+export type OrganizationModelContractRef = z.infer<typeof ContractRefSchema>
+export type OrganizationModelResourceOntologyBindingContract = ResourceOntologyBindingContract
+export type { ParsedContractRef }
 export type OrganizationModelAgentKind = z.infer<typeof AgentKindSchema>
 export type OrganizationModelScriptResourceLanguage = z.infer<typeof ScriptResourceLanguageSchema>
 export type OrganizationModelScriptResourceSource = z.infer<typeof ScriptResourceSourceSchema>
@@ -180,33 +186,33 @@ export type OrganizationModelTopologyRelationshipKind = z.infer<typeof OmTopolog
 export type OrganizationModelTopologyRelationship = z.infer<typeof OmTopologyRelationshipSchema>
 export type OrganizationModelTopologyMetadata = z.infer<typeof OmTopologyMetadataSchema>
 export type OrganizationModelActions = z.infer<typeof ActionsDomainSchema>
-export type OrganizationModelAction = z.infer<typeof ActionSchema>
-export type OrganizationModelActionId = z.infer<typeof ActionIdSchema>
-export type OrganizationModelActionScope = z.infer<typeof ActionScopeSchema>
-export type OrganizationModelActionRef = z.infer<typeof ActionRefSchema>
-export type OrganizationModelActionInvocationKind = z.infer<typeof ActionInvocationKindSchema>
-export type OrganizationModelActionInvocation = z.infer<typeof ActionInvocationSchema>
-export type EntityId = z.infer<typeof EntityIdSchema>
-export type EntityLink = z.infer<typeof EntityLinkSchema>
-export type Entity = z.infer<typeof EntitySchema>
-export type OrganizationModelEntity = z.infer<typeof EntitySchema>
-export type OrganizationModelEntities = z.infer<typeof EntitiesDomainSchema>
-export type OrganizationModelPolicies = z.infer<typeof PoliciesDomainSchema>
-export type OrganizationModelPolicy = z.infer<typeof PolicySchema>
-export type OrganizationModelPolicyId = z.infer<typeof PolicyIdSchema>
-export type OrganizationModelPolicyApplicability = z.infer<typeof PolicyApplicabilitySchema>
-export type OrganizationModelPolicyTrigger = z.infer<typeof PolicyTriggerSchema>
-export type OrganizationModelPolicyPredicate = z.infer<typeof PolicyPredicateSchema>
-export type OrganizationModelPolicyEffect = z.infer<typeof PolicyEffectSchema>
-export type OrganizationModelKnowledge = z.infer<typeof KnowledgeDomainSchema>
-export type OrgKnowledgeNode = z.infer<typeof OrgKnowledgeNodeSchema>
-export type OrgKnowledgeNodeInput = z.input<typeof OrgKnowledgeNodeSchema>
-export type OrgKnowledgeKind = z.infer<typeof OrgKnowledgeKindSchema>
-export type KnowledgeTargetKind = z.infer<typeof KnowledgeTargetKindSchema>
-export type KnowledgeTargetRef = z.infer<typeof KnowledgeTargetRefSchema>
-export type KnowledgeLink = z.infer<typeof KnowledgeLinkSchema>
-export type OrganizationModelIconToken = z.infer<typeof OrganizationModelIconTokenSchema>
-export type OrganizationModelBuiltinIconToken = z.infer<typeof OrganizationModelBuiltinIconTokenSchema>
-
-export type DeepPartial<T> =
-  T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T
+export type OrganizationModelAction = z.infer<typeof ActionSchema>
+export type OrganizationModelActionId = z.infer<typeof ActionIdSchema>
+export type OrganizationModelActionScope = z.infer<typeof ActionScopeSchema>
+export type OrganizationModelActionRef = z.infer<typeof ActionRefSchema>
+export type OrganizationModelActionInvocationKind = z.infer<typeof ActionInvocationKindSchema>
+export type OrganizationModelActionInvocation = z.infer<typeof ActionInvocationSchema>
+export type EntityId = z.infer<typeof EntityIdSchema>
+export type EntityLink = z.infer<typeof EntityLinkSchema>
+export type Entity = z.infer<typeof EntitySchema>
+export type OrganizationModelEntity = z.infer<typeof EntitySchema>
+export type OrganizationModelEntities = z.infer<typeof EntitiesDomainSchema>
+export type OrganizationModelPolicies = z.infer<typeof PoliciesDomainSchema>
+export type OrganizationModelPolicy = z.infer<typeof PolicySchema>
+export type OrganizationModelPolicyId = z.infer<typeof PolicyIdSchema>
+export type OrganizationModelPolicyApplicability = z.infer<typeof PolicyApplicabilitySchema>
+export type OrganizationModelPolicyTrigger = z.infer<typeof PolicyTriggerSchema>
+export type OrganizationModelPolicyPredicate = z.infer<typeof PolicyPredicateSchema>
+export type OrganizationModelPolicyEffect = z.infer<typeof PolicyEffectSchema>
+export type OrganizationModelKnowledge = z.infer<typeof KnowledgeDomainSchema>
+export type OrgKnowledgeNode = z.infer<typeof OrgKnowledgeNodeSchema>
+export type OrgKnowledgeNodeInput = z.input<typeof OrgKnowledgeNodeSchema>
+export type OrgKnowledgeKind = z.infer<typeof OrgKnowledgeKindSchema>
+export type KnowledgeTargetKind = z.infer<typeof KnowledgeTargetKindSchema>
+export type KnowledgeTargetRef = z.infer<typeof KnowledgeTargetRefSchema>
+export type KnowledgeLink = z.infer<typeof KnowledgeLinkSchema>
+export type OrganizationModelIconToken = z.infer<typeof OrganizationModelIconTokenSchema>
+export type OrganizationModelBuiltinIconToken = z.infer<typeof OrganizationModelBuiltinIconTokenSchema>
+
+export type DeepPartial<T> =
+  T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T

package/src/platform/registry/__tests__/validation.test.ts

@@ -662,6 +662,29 @@ describe('validateResourceGovernance', () => {
     ).toThrow("Resource 'lead-import' declares ontology bindings but no ontology actions")
   })
 
+  it('accepts contract-only workflow ontology bindings without ontology.actions', () => {
+    const contractOnlyResource: ResourceEntry = {
+      ...workflowResource,
+      ontology: {
+        contract: {
+          input: '@repo/elevasis-core/contracts/full-diagnostic#inputSchema'
+        }
+      }
+    }
+
+    const result = validateResourceGovernance(
+      'test-org',
+      {
+        version: '1.0.0',
+        workflows: [createGovernedWorkflow(contractOnlyResource)]
+      },
+      createModel([contractOnlyResource], [systemA], { ontology: validOntology }),
+      { mode: 'strict' }
+    )
+
+    expect(result.valid).toBe(true)
+  })
+
   it('reports dangling required topology refs', () => {
     expect(() =>
       validateResourceGovernance(

package/src/platform/registry/validation.ts

@@ -156,7 +156,7 @@ function hasOntologySources(organizationModel: ResourceGovernanceModel): boolean
 }
 
 function systemHasOntologySource(system: SystemEntry): boolean {
-  if (system.ontology !== undefined || (system.content !== undefined && Object.keys(system.content).length > 0)) return true
+  if (system.ontology !== undefined) return true
   return Object.values(system.systems ?? system.subsystems ?? {}).some(systemHasOntologySource)
 }
 
@@ -198,7 +198,18 @@ function addOntologyBindingIssues(
   const binding = resource.ontology
   if (binding === undefined) return
 
-  if ((resource.kind === 'workflow' || resource.kind === 'agent') && (binding.actions?.length ?? 0) === 0) {
+  const hasOperationalOntologyBinding =
+    binding.primaryAction !== undefined ||
+    (binding.reads?.length ?? 0) > 0 ||
+    (binding.writes?.length ?? 0) > 0 ||
+    (binding.usesCatalogs?.length ?? 0) > 0 ||
+    (binding.emits?.length ?? 0) > 0
+
+  if (
+    (resource.kind === 'workflow' || resource.kind === 'agent') &&
+    hasOperationalOntologyBinding &&
+    (binding.actions?.length ?? 0) === 0
+  ) {
     addGovernanceIssue(
       issues,
       'missing-ontology-actions',

package/src/reference/_generated/contracts.md

@@ -306,7 +306,7 @@ export type OrganizationModelSystemLifecycle = z.infer<typeof SystemLifecycleSch
 ### `OrganizationModelSystemStatus`
 
 ```typescript
-/** @deprecated Use OrganizationModelSystemLifecycle. Accepted for one publish cycle. */
+/** @deprecated Use OrganizationModelSystemLifecycle. Accepted for one publish cycle. */
 export type OrganizationModelSystemStatus = z.infer<typeof SystemStatusSchema>
 ```
 
@@ -376,6 +376,18 @@ export type OrganizationModelResourceGovernanceStatus = z.infer<typeof ResourceG
 export type OrganizationModelResourceOntologyBinding = z.infer<typeof ResourceOntologyBindingSchema>
 ```
 
+### `OrganizationModelContractRef`
+
+```typescript
+export type OrganizationModelContractRef = z.infer<typeof ContractRefSchema>
+```
+
+### `OrganizationModelResourceOntologyBindingContract`
+
+```typescript
+export type OrganizationModelResourceOntologyBindingContract = ResourceOntologyBindingContract
+```
+
 ### `OrganizationModelAgentKind`
 
 ```typescript
@@ -625,7 +637,7 @@ export type OrganizationModelBuiltinIconToken = z.infer<typeof OrganizationModel
 ### `DeepPartial`
 
 ```typescript
-export type DeepPartial<T> =
+export type DeepPartial<T> =
   T extends Array<infer U> ? Array<DeepPartial<U>> : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T
 ```
 

package/src/organization-model/content-kinds/config.ts

@@ -1,36 +0,0 @@
-import { z } from 'zod'
-import { defineContentType } from './registry'
-
-// ---------------------------------------------------------------------------
-// config kinds (Phase 3, Wave 2A)
-// ---------------------------------------------------------------------------
-//
-// `config:kv` — a flat key-value configuration store co-located with a system.
-//               Per L15: single starter config type; feature-flag semantics are
-//               a usage pattern over kv, not a separate type.
-//
-// Per L15: `config` is a first-class registered meta-kind. Scope: NEW
-// tenant-defined settings co-located with a system. Strongly-typed platform
-// fields (system.ui.devOnly, system.ui.requiresAdmin, etc.) stay where they
-// are and are NOT hoisting destinations for existing typed fields.
-
-const ConfigKvPayloadSchema = z.object({
-  /**
-   * Flat key-value entries. Values are JSON primitives.
-   * Keys are short identifiers (e.g. 'maxBatchSize', 'featureEnabled').
-   */
-  entries: z
-    .record(z.string().trim().min(1).max(200), z.union([z.string(), z.number(), z.boolean(), z.null()]))
-    .meta({ label: 'Entries', hint: 'Key-value configuration entries (string, number, boolean, or null values)' })
-})
-
-export type ConfigKvPayload = z.infer<typeof ConfigKvPayloadSchema>
-
-export const configKvKind = defineContentType({
-  kind: 'config',
-  type: 'kv',
-  label: 'Key-Value Config',
-  description: 'A flat key-value configuration store co-located with a system. Values are JSON primitives.',
-  payloadSchema: ConfigKvPayloadSchema,
-  parentTypes: []
-})

package/src/organization-model/content-kinds/index.ts

@@ -1,78 +0,0 @@
-// ---------------------------------------------------------------------------
-// content-kinds barrel (Phase 3, Wave 2A)
-// ---------------------------------------------------------------------------
-//
-// Per D8 (locked): CONTENT_KIND_REGISTRY is populated via static import, not
-// side-effecting registration. This file is the single source of truth for
-// the populated registry. `registry.ts` exports the EMPTY registry constant
-// (kept for historical/import-chain reasons) — consumers MUST import from
-// this barrel, not from `registry.ts` directly, to get the populated registry.
-//
-// Registry keys follow the `<kind>:<type>` ContentTypeKey format (per L4, D8).
-
-export { defineContentType } from './registry'
-export type { ContentTypeKey, ContentTypeDefinition } from './types'
-export { ContentNodeBaseSchema, ContentNodeSchema, ExtensionNodeSchema } from './types'
-export type { ContentNodeBase, ContentNode, ExtensionNode } from './types'
-
-export { pipelineKind, stageKind } from './pipeline'
-export type { PipelinePayload, StagePayload } from './pipeline'
-
-export { templateKind, templateStepKind } from './template'
-export type { TemplatePayload, TemplateStepPayload } from './template'
-
-export { statusFlowKind, statusKind } from './status'
-export type { StatusFlowPayload, StatusPayload } from './status'
-
-export { configKvKind } from './config'
-export type { ConfigKvPayload } from './config'
-
-import { pipelineKind, stageKind } from './pipeline'
-import { templateKind, templateStepKind } from './template'
-import { statusFlowKind, statusKind } from './status'
-import { configKvKind } from './config'
-import type { ContentTypeDefinition, ContentTypeKey } from './types'
-
-/**
- * Compatibility registry for bridge-era System.content nodes.
- * New schema/catalog authoring should use System.ontology, and new
- * system-local settings should use System.config. These definitions remain so
- * old tenant content can parse, render, migrate, and project read-only.
- *
- * Per D8: static const object keyed by `'<kind>:<type>'` composite key.
- *
- * Bridge keys:
- *   'schema:pipeline'      — projects to ontology catalog records
- *   'schema:stage'         — projects to ontology catalog entries
- *   'schema:template'      — projects to ontology/catalog or action metadata
- *   'schema:template-step' — projects to template metadata or catalog entries
- *   'schema:status-flow'   — projects to ontology catalog records
- *   'schema:status'        — projects to ontology catalog entries
- *   'config:kv'            — projects into resolved System.config
- *
- * Wave 3A's `ContentNodeDescribeView` consumes `lookupContentType(kind, type)`
- * which indexes into this registry. Import `lookupContentType` from this barrel
- * to get the populated version.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export const CONTENT_KIND_REGISTRY: Readonly<Record<ContentTypeKey, ContentTypeDefinition<any>>> = {
-  'schema:pipeline': pipelineKind,
-  'schema:stage': stageKind,
-  'schema:template': templateKind,
-  'schema:template-step': templateStepKind,
-  'schema:status-flow': statusFlowKind,
-  'schema:status': statusKind,
-  'config:kv': configKvKind
-} as const
-
-/**
- * Look up a registered content-type definition by (kind, type).
- * Uses the populated CONTENT_KIND_REGISTRY from this barrel — wave 2A override
- * of the empty registry exported from registry.ts.
- * Returns `undefined` when the pair is not registered — per D2, this is not
- * an error; unregistered pairs render generically and skip payload validation.
- */
-export function lookupContentType(kind: string, type: string): ContentTypeDefinition | undefined {
-  const key: ContentTypeKey = `${kind}:${type}`
-  return CONTENT_KIND_REGISTRY[key]
-}

package/src/organization-model/content-kinds/pipeline.ts

@@ -1,68 +0,0 @@
-import { z } from 'zod'
-import { defineContentType } from './registry'
-
-// ---------------------------------------------------------------------------
-// pipeline + stage kinds (Phase 3, Wave 2A)
-// ---------------------------------------------------------------------------
-//
-// `schema:pipeline` — a named pipeline that applies to an entity type.
-// `schema:stage`    — a stage within a pipeline; parentTypes constrains it to
-//                     live under a `schema:pipeline` sibling.
-//
-// Per L19: `schema:stage` parents only under `schema:pipeline`.
-// Per L19 (parent kind constraint): both share the same meta-kind `schema`.
-
-const PipelinePayloadSchema = z.object({
-  /**
-   * Local NodeId of the entity this pipeline applies to (e.g. 'crm.deal').
-   * `.meta({ ref: 'entity' })` enables SchemaDrivenFieldList to render a
-   * clickable graph link to the referenced entity node.
-   */
-  entityId: z
-    .string()
-    .trim()
-    .min(1)
-    .max(200)
-    .meta({ label: 'Entity', ref: 'entity', hint: 'The entity type this pipeline tracks' }),
-  /**
-   * Optional Kanban column color token for UI rendering.
-   */
-  kanbanColor: z.string().trim().min(1).max(40).optional().meta({ label: 'Kanban color', hint: 'UI color token' })
-})
-
-export type PipelinePayload = z.infer<typeof PipelinePayloadSchema>
-
-export const pipelineKind = defineContentType({
-  kind: 'schema',
-  type: 'pipeline',
-  label: 'Pipeline',
-  description: 'A named progression pipeline that applies to a specific entity type.',
-  payloadSchema: PipelinePayloadSchema,
-  parentTypes: []
-})
-
-// ---------------------------------------------------------------------------
-
-const StagePayloadSchema = z.object({
-  /**
-   * Semantic classification for this stage.
-   * Drives color, icon, and CRM-priority logic in consuming views.
-   * Optional — prospecting stages use data.entityKind instead.
-   * Enum aligned with SalesStageSemanticClassSchema (sales.ts).
-   */
-  semanticClass: z
-    .enum(['open', 'active', 'nurturing', 'closed_won', 'closed_lost', 'won', 'lost', 'closed'])
-    .optional()
-    .meta({ label: 'Semantic class', hint: 'Semantic meaning of this stage', color: 'blue' })
-})
-
-export type StagePayload = z.infer<typeof StagePayloadSchema>
-
-export const stageKind = defineContentType({
-  kind: 'schema',
-  type: 'stage',
-  label: 'Stage',
-  description: 'A stage within a pipeline. Must be parented under a schema:pipeline content node.',
-  payloadSchema: StagePayloadSchema,
-  parentTypes: ['schema:pipeline']
-})