@elevasis/core 0.20.0 → 0.22.0

package/src/platform/registry/index.ts

@@ -15,8 +15,19 @@ export {
   validateDeploymentSpec,
   validateRelationships,
   validateExecutionInterface,
+  validateResourceGovernance,
   RegistryValidationError
 } from './validation'
+export type {
+  ResourceGovernanceModel,
+  ResourceGovernanceValidationIssue,
+  ResourceGovernanceValidationIssueType,
+  ResourceGovernanceValidationOptions,
+  ResourceGovernanceValidationResult,
+  ResourceValidatorMode
+} from './validation'
+
+export { bindResourceDescriptor } from './types'
 
 // Serialization utilities
 export { serializeAllOrganizations, serializeOrganization, buildEdges } from './serialization'
@@ -27,6 +38,9 @@ export type {
   ResourceType,
   ExecutableResourceType,
   ResourceDefinition,
+  RuntimeResourceDescriptor,
+  DescriptorBackedResourceDefinition,
+  BoundResourceDefinition,
   ResourceList,
   TriggerDefinition,
   IntegrationDefinition,

package/src/platform/registry/resource-registry.ts

@@ -11,6 +11,9 @@
 
 import type { WorkflowDefinition } from '../../execution/engine/workflow/types'
 import type { AgentDefinition } from '../../execution/engine/agent/core/types'
+import type { OrganizationModelResources, OrganizationModelSystems } from '../../organization-model/types'
+import type { ResourceEntry } from '../../organization-model/domains/resources'
+import type { SystemEntry } from '../../organization-model/domains/systems'
 import type {
   ResourceStatus,
   ResourceDefinition,
@@ -44,6 +47,18 @@ function filterArchived(org: DeploymentSpec): DeploymentSpec {
   }
 }
 
+function summarizeSystem(system: SystemEntry | undefined): ResourceDefinition['system'] {
+  if (!system) return undefined
+
+  return {
+    id: system.id,
+    title: system.title,
+    description: system.description,
+    kind: system.kind,
+    status: system.status
+  }
+}
+
 /**
  * Configuration for a remotely-deployed organization
  *
@@ -88,6 +103,11 @@ export interface SystemConfig {
 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 */
@@ -283,6 +303,22 @@ export class ResourceRegistry {
       }
     }
 
+    const resourcesById = new Map((orgResources.organizationModel?.resources?.entries ?? []).map((r) => [r.id, r]))
+    const systemsById = new Map((orgResources.organizationModel?.systems?.systems ?? []).map((s) => [s.id, s]))
+    const getGovernanceMetadata = (
+      resourceId: string,
+      descriptor: ResourceEntry | undefined
+    ): Pick<ResourceDefinition, 'systemId' | 'system' | 'governanceStatus'> => {
+      const resource = descriptor ?? resourcesById.get(resourceId)
+      if (!resource) return {}
+
+      return {
+        systemId: resource.systemId,
+        system: summarizeSystem(systemsById.get(resource.systemId)),
+        governanceStatus: resource.status
+      }
+    }
+
     // Map workflows to ResourceDefinition metadata and filter by environment
     const workflows: ResourceDefinition[] = (orgResources.workflows || [])
       .map((def) => ({
@@ -296,7 +332,8 @@ export class ResourceRegistry {
         category: def.config.category,
         origin: this.remoteResources.has(`${organizationName}/${def.config.resourceId}`)
           ? ('remote' as const)
-          : ('local' as const)
+          : ('local' as const),
+        ...getGovernanceMetadata(def.config.resourceId, def.config.resource)
       }))
       .filter((resource) => !environment || resource.status === environment)
 
@@ -314,7 +351,8 @@ export class ResourceRegistry {
         sessionCapable: def.config.sessionCapable ?? false,
         origin: this.remoteResources.has(`${organizationName}/${def.config.resourceId}`)
           ? ('remote' as const)
-          : ('local' as const)
+          : ('local' as const),
+        ...getGovernanceMetadata(def.config.resourceId, def.config.resource)
       }))
       .filter((resource) => !environment || resource.status === environment)
 

package/src/platform/registry/serialization.ts

@@ -1,50 +1,85 @@
-/**
- * Registry Serialization Utilities
- *
- * Pre-serialization logic for ResourceRegistry.
- * Converts resource definitions to JSON-safe structures at startup.
- */
-
-import type { DeploymentSpec } from './resource-registry'
-import type { ResourceDefinition } from './types'
+/**
+ * Registry Serialization Utilities
+ *
+ * Pre-serialization logic for ResourceRegistry.
+ * Converts resource definitions to JSON-safe structures at startup.
+ */
+
+import type { DeploymentSpec } from './resource-registry'
+import type { ResourceDefinition } from './types'
+import type { ResourceEntry } from '../../organization-model/domains/resources'
+import type { SystemEntry } from '../../organization-model/domains/systems'
 import type {
   SerializedOrganizationData,
   SerializedAgentDefinition,
   SerializedWorkflowDefinition,
   CommandViewAgent,
-  CommandViewWorkflow,
-  CommandViewEdge
+  CommandViewWorkflow,
+  CommandViewEdge
 } from './serialized-types'
 import { serializeDefinition } from '../../execution/engine/base/serialization'
-
-/**
- * Serialize all organization resources
- * Called once during ResourceRegistry construction
- */
-export function serializeAllOrganizations(
-  registry: Record<string, DeploymentSpec>
-): Map<string, SerializedOrganizationData> {
-  const cache = new Map<string, SerializedOrganizationData>()
-  for (const [orgName, resources] of Object.entries(registry)) {
-    cache.set(orgName, serializeOrganization(resources))
-  }
-  return cache
-}
-
+
+function summarizeSystem(system: SystemEntry | undefined): ResourceDefinition['system'] {
+  if (!system) return undefined
+
+  return {
+    id: system.id,
+    title: system.title,
+    description: system.description,
+    kind: system.kind,
+    status: system.status
+  }
+}
+
+function createGovernanceMetadataResolver(resources: DeploymentSpec) {
+  const resourcesById = new Map((resources.organizationModel?.resources?.entries ?? []).map((r) => [r.id, r]))
+  const systemsById = new Map((resources.organizationModel?.systems?.systems ?? []).map((s) => [s.id, s]))
+
+  return (
+    resourceId: string,
+    descriptor: ResourceEntry | undefined
+  ): Pick<ResourceDefinition, 'systemId' | 'system' | 'governanceStatus'> => {
+    const resource = descriptor ?? resourcesById.get(resourceId)
+    if (!resource) return {}
+
+    return {
+      systemId: resource.systemId,
+      system: summarizeSystem(systemsById.get(resource.systemId)),
+      governanceStatus: resource.status
+    }
+  }
+}
+
+/**
+ * Serialize all organization resources
+ * Called once during ResourceRegistry construction
+ */
+export function serializeAllOrganizations(
+  registry: Record<string, DeploymentSpec>
+): Map<string, SerializedOrganizationData> {
+  const cache = new Map<string, SerializedOrganizationData>()
+  for (const [orgName, resources] of Object.entries(registry)) {
+    cache.set(orgName, serializeOrganization(resources))
+  }
+  return cache
+}
+
 /**
  * Serialize single organization's resources
  */
-export function serializeOrganization(resources: DeploymentSpec): SerializedOrganizationData {
-  // Serialize workflows
-  const workflowDefinitions = new Map<string, SerializedWorkflowDefinition>()
-  const workflowResources: ResourceDefinition[] = []
-  const commandViewWorkflows: CommandViewWorkflow[] = []
-
-  for (const workflow of resources.workflows ?? []) {
-    const resourceId = workflow.config.resourceId
-    const serialized = serializeDefinition(workflow) as SerializedWorkflowDefinition
-    workflowDefinitions.set(resourceId, serialized)
-
+export function serializeOrganization(resources: DeploymentSpec): SerializedOrganizationData {
+  const getGovernanceMetadata = createGovernanceMetadataResolver(resources)
+
+  // Serialize workflows
+  const workflowDefinitions = new Map<string, SerializedWorkflowDefinition>()
+  const workflowResources: ResourceDefinition[] = []
+  const commandViewWorkflows: CommandViewWorkflow[] = []
+
+  for (const workflow of resources.workflows ?? []) {
+    const resourceId = workflow.config.resourceId
+    const serialized = serializeDefinition(workflow) as SerializedWorkflowDefinition
+    workflowDefinitions.set(resourceId, serialized)
+
     workflowResources.push({
       resourceId,
       name: workflow.config.name,
@@ -53,33 +88,35 @@ export function serializeOrganization(resources: DeploymentSpec): SerializedOrga
       type: 'workflow',
       status: workflow.config.status,
       links: workflow.config.links,
-      category: workflow.config.category
+      category: workflow.config.category,
+      ...getGovernanceMetadata(resourceId, workflow.config.resource)
     })
-
-    commandViewWorkflows.push({
-      resourceId,
-      name: workflow.config.name,
+
+    commandViewWorkflows.push({
+      resourceId,
+      name: workflow.config.name,
       description: workflow.config.description,
       version: workflow.config.version,
       type: 'workflow',
       status: workflow.config.status,
       links: workflow.config.links,
       category: workflow.config.category,
+      ...getGovernanceMetadata(resourceId, workflow.config.resource),
       stepCount: Object.keys(workflow.steps).length,
       entryPoint: workflow.entryPoint
     })
-  }
-
-  // Serialize agents
-  const agentDefinitions = new Map<string, SerializedAgentDefinition>()
-  const agentResources: ResourceDefinition[] = []
-  const commandViewAgents: CommandViewAgent[] = []
-
-  for (const agent of resources.agents ?? []) {
-    const resourceId = agent.config.resourceId
-    const serialized = serializeDefinition(agent) as SerializedAgentDefinition
-    agentDefinitions.set(resourceId, serialized)
-
+  }
+
+  // Serialize agents
+  const agentDefinitions = new Map<string, SerializedAgentDefinition>()
+  const agentResources: ResourceDefinition[] = []
+  const commandViewAgents: CommandViewAgent[] = []
+
+  for (const agent of resources.agents ?? []) {
+    const resourceId = agent.config.resourceId
+    const serialized = serializeDefinition(agent) as SerializedAgentDefinition
+    agentDefinitions.set(resourceId, serialized)
+
     agentResources.push({
       resourceId,
       name: agent.config.name,
@@ -88,169 +125,171 @@ export function serializeOrganization(resources: DeploymentSpec): SerializedOrga
       type: 'agent',
       status: agent.config.status,
       links: agent.config.links,
-      category: agent.config.category
+      category: agent.config.category,
+      ...getGovernanceMetadata(resourceId, agent.config.resource)
     })
-
-    commandViewAgents.push({
-      resourceId,
-      name: agent.config.name,
+
+    commandViewAgents.push({
+      resourceId,
+      name: agent.config.name,
       description: agent.config.description,
       version: agent.config.version,
       type: 'agent',
       status: agent.config.status,
       links: agent.config.links,
       category: agent.config.category,
+      ...getGovernanceMetadata(resourceId, agent.config.resource),
       modelProvider: agent.modelConfig.provider,
-      modelId: agent.modelConfig.model,
-      toolCount: agent.tools.length,
-      hasKnowledgeMap: agent.knowledgeMap !== undefined,
-      hasMemory: agent.config.memoryPreferences !== undefined,
-      sessionCapable: agent.config.sessionCapable ?? false
-    })
-  }
-
-  // Build edges from triggers and relationships
-  const edges = buildEdges(resources)
-
-  // Pass-through manifest data (already JSON-safe)
-  const triggers = resources.triggers ?? []
+      modelId: agent.modelConfig.model,
+      toolCount: agent.tools.length,
+      hasKnowledgeMap: agent.knowledgeMap !== undefined,
+      hasMemory: agent.config.memoryPreferences !== undefined,
+      sessionCapable: agent.config.sessionCapable ?? false
+    })
+  }
+
+  // Build edges from triggers and relationships
+  const edges = buildEdges(resources)
+
+  // Pass-through manifest data (already JSON-safe)
+  const triggers = resources.triggers ?? []
   const integrations = resources.integrations ?? []
   const externalResources = resources.externalResources ?? []
   const humanCheckpoints = resources.humanCheckpoints ?? []
 
   return {
-    version: resources.version,
-    resources: {
-      workflows: workflowResources,
-      agents: agentResources,
-      total: workflowResources.length + agentResources.length
-    },
-    definitions: {
-      workflows: workflowDefinitions,
-      agents: agentDefinitions
-    },
-    commandView: {
-      workflows: commandViewWorkflows,
-      agents: commandViewAgents,
-      triggers,
+    version: resources.version,
+    resources: {
+      workflows: workflowResources,
+      agents: agentResources,
+      total: workflowResources.length + agentResources.length
+    },
+    definitions: {
+      workflows: workflowDefinitions,
+      agents: agentDefinitions
+    },
+    commandView: {
+      workflows: commandViewWorkflows,
+      agents: commandViewAgents,
+      triggers,
       integrations,
       externalResources,
       humanCheckpoints,
       edges
     },
-    triggers,
-    integrations,
-    externalResources,
-    humanCheckpoints,
-    relationships: resources.relationships
-  }
-}
-
-/**
- * Build Command View edges from relationships
- * NOTE: Trigger relationships are now declared in ResourceRelationships, not on TriggerDefinition
- */
-export function buildEdges(resources: DeploymentSpec): CommandViewEdge[] {
-  const edges: CommandViewEdge[] = []
-  let edgeId = 0
-
-  // All relationship edges (triggers, agents, workflows can all declare relationships)
-  for (const [resourceId, declaration] of Object.entries(resources.relationships ?? {})) {
-    for (const agentId of declaration.triggers?.agents ?? []) {
-      edges.push({
-        id: `edge-${edgeId++}`,
-        source: resourceId,
-        target: agentId,
-        relationship: 'triggers'
-      })
-    }
-    for (const workflowId of declaration.triggers?.workflows ?? []) {
-      edges.push({
-        id: `edge-${edgeId++}`,
-        source: resourceId,
-        target: workflowId,
-        relationship: 'triggers'
-      })
-    }
-    for (const integrationId of declaration.uses?.integrations ?? []) {
-      edges.push({
-        id: `edge-${edgeId++}`,
-        source: resourceId,
-        target: integrationId,
-        relationship: 'uses'
-      })
-    }
-  }
-
-  // External Resource edges (forward-only)
-  for (const external of resources.externalResources ?? []) {
-    // External -> Internal
-    for (const workflowId of external.triggers?.workflows ?? []) {
-      edges.push({
-        id: `edge-${edgeId++}`,
-        source: external.resourceId,
-        target: workflowId,
-        relationship: 'triggers'
-      })
-    }
-    for (const agentId of external.triggers?.agents ?? []) {
-      edges.push({
-        id: `edge-${edgeId++}`,
-        source: external.resourceId,
-        target: agentId,
-        relationship: 'triggers'
-      })
-    }
-
-    // External -> Integration
-    for (const integrationId of external.uses?.integrations ?? []) {
-      edges.push({
-        id: `edge-${edgeId++}`,
-        source: external.resourceId,
-        target: integrationId,
-        relationship: 'uses'
-      })
-    }
-  }
-
-  // Human Checkpoint edges
-  for (const humanCheckpoint of resources.humanCheckpoints ?? []) {
-    // Agent/Workflow -> ApprovalPoint
-    for (const agentId of humanCheckpoint.requestedBy?.agents ?? []) {
-      edges.push({
-        id: `edge-${edgeId++}`,
-        source: agentId,
-        target: humanCheckpoint.resourceId,
-        relationship: 'approval'
-      })
-    }
-    for (const workflowId of humanCheckpoint.requestedBy?.workflows ?? []) {
-      edges.push({
-        id: `edge-${edgeId++}`,
-        source: workflowId,
-        target: humanCheckpoint.resourceId,
-        relationship: 'approval'
-      })
-    }
-
-    // ApprovalPoint -> Agent/Workflow
-    for (const agentId of humanCheckpoint.routesTo?.agents ?? []) {
-      edges.push({
-        id: `edge-${edgeId++}`,
-        source: humanCheckpoint.resourceId,
-        target: agentId,
-        relationship: 'triggers'
-      })
-    }
-    for (const workflowId of humanCheckpoint.routesTo?.workflows ?? []) {
-      edges.push({
-        id: `edge-${edgeId++}`,
-        source: humanCheckpoint.resourceId,
-        target: workflowId,
-        relationship: 'triggers'
-      })
-    }
-  }
-
-  return edges
-}
+    triggers,
+    integrations,
+    externalResources,
+    humanCheckpoints,
+    relationships: resources.relationships
+  }
+}
+
+/**
+ * Build Command View edges from relationships
+ * NOTE: Trigger relationships are now declared in ResourceRelationships, not on TriggerDefinition
+ */
+export function buildEdges(resources: DeploymentSpec): CommandViewEdge[] {
+  const edges: CommandViewEdge[] = []
+  let edgeId = 0
+
+  // All relationship edges (triggers, agents, workflows can all declare relationships)
+  for (const [resourceId, declaration] of Object.entries(resources.relationships ?? {})) {
+    for (const agentId of declaration.triggers?.agents ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: resourceId,
+        target: agentId,
+        relationship: 'triggers'
+      })
+    }
+    for (const workflowId of declaration.triggers?.workflows ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: resourceId,
+        target: workflowId,
+        relationship: 'triggers'
+      })
+    }
+    for (const integrationId of declaration.uses?.integrations ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: resourceId,
+        target: integrationId,
+        relationship: 'uses'
+      })
+    }
+  }
+
+  // External Resource edges (forward-only)
+  for (const external of resources.externalResources ?? []) {
+    // External -> Internal
+    for (const workflowId of external.triggers?.workflows ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: external.resourceId,
+        target: workflowId,
+        relationship: 'triggers'
+      })
+    }
+    for (const agentId of external.triggers?.agents ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: external.resourceId,
+        target: agentId,
+        relationship: 'triggers'
+      })
+    }
+
+    // External -> Integration
+    for (const integrationId of external.uses?.integrations ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: external.resourceId,
+        target: integrationId,
+        relationship: 'uses'
+      })
+    }
+  }
+
+  // Human Checkpoint edges
+  for (const humanCheckpoint of resources.humanCheckpoints ?? []) {
+    // Agent/Workflow -> ApprovalPoint
+    for (const agentId of humanCheckpoint.requestedBy?.agents ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: agentId,
+        target: humanCheckpoint.resourceId,
+        relationship: 'approval'
+      })
+    }
+    for (const workflowId of humanCheckpoint.requestedBy?.workflows ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: workflowId,
+        target: humanCheckpoint.resourceId,
+        relationship: 'approval'
+      })
+    }
+
+    // ApprovalPoint -> Agent/Workflow
+    for (const agentId of humanCheckpoint.routesTo?.agents ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: humanCheckpoint.resourceId,
+        target: agentId,
+        relationship: 'triggers'
+      })
+    }
+    for (const workflowId of humanCheckpoint.routesTo?.workflows ?? []) {
+      edges.push({
+        id: `edge-${edgeId++}`,
+        source: humanCheckpoint.resourceId,
+        target: workflowId,
+        relationship: 'triggers'
+      })
+    }
+  }
+
+  return edges
+}

package/src/platform/registry/serialized-types.ts

@@ -31,6 +31,7 @@ export interface SerializedAgentDefinition {
     description: string
     version: string
     type: 'agent'
+    kind: 'orchestrator' | 'specialist' | 'utility' | 'system'
     status: 'dev' | 'prod'
     links?: ResourceLink[]
     category?: ResourceCategory