@elevasis/sdk 1.26.2 → 1.27.0

package/dist/cli.cjs

@@ -40268,6 +40268,9 @@ function getRuntimeResources(resources) {
     }))
   ];
 }
+function isStaticPlatformAgentResource(resource) {
+  return resource.kind === "agent" && resource.agentKind === "platform";
+}
 function hasOntologySources(organizationModel) {
   return organizationModel.ontology !== void 0 || organizationModel.entities !== void 0 || organizationModel.actions !== void 0 || Object.values(organizationModel.systems ?? {}).some(systemHasOntologySource);
 }
@@ -40421,6 +40424,9 @@ function validateResourceGovernance(orgName, deployment, organizationModel = dep
     }
     const runtimeResource = runtimeResourcesById.get(resource.id);
     if (!runtimeResource) {
+      if (isStaticPlatformAgentResource(resource)) {
+        continue;
+      }
       addGovernanceIssue(
         issues,
         "missing-code-resource",
@@ -44124,7 +44130,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.26.2",
+  version: "1.27.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -44373,6 +44379,9 @@ function listOrganizationModelContractRefs(org) {
   });
 }
 function validateResourceGovernancePreflight(orgName, org, contractRegistry) {
+  if (org.organizationModel !== void 0) {
+    OrganizationModelSchema.parse(org.organizationModel);
+  }
   if (process.env.ELEVASIS_RESOURCE_VALIDATOR === "warn-only") return;
   validateResourceGovernance(orgName, org, org.organizationModel, { mode: "strict" });
   const contractRefs = listOrganizationModelContractRefs(org);

package/dist/index.d.ts

@@ -11494,8 +11494,8 @@ interface SystemConfig {
 interface DeploymentSpec {
     /** Deployment version (semver) */
     version: string;
-    /** Optional Organization Model governance catalog used for OM-code validation */
-    organizationModel?: Partial<Pick<OrganizationModel$1, 'systems' | 'resources' | 'ontology' | 'topology' | 'roles' | 'policies' | 'entities' | 'actions'>>;
+    /** Optional full Organization Model snapshot used for OM-code validation and deployment persistence */
+    organizationModel?: OrganizationModel$1;
     /** Workflow definitions */
     workflows?: WorkflowDefinition[];
     /** Agent definitions */
@@ -11833,6 +11833,11 @@ interface ResourceGovernanceValidationOptions {
 /**
  * Validates runtime resource definitions against OM Resources and Systems.
  *
+ * This is an overlay validator for code/resource bindings, ontology bindings,
+ * and topology refs that need runtime manifest context. It does not validate
+ * Organization Model shape; deploy/runtime structural gates use
+ * OrganizationModelSchema.
+ *
  * This is the shared core entry point for SDK, CI, deploy, and ResourceRegistry.
  * Default mode is strict. ELEVASIS_RESOURCE_VALIDATOR=warn-only remains a
  * permanent emergency escape hatch unless an explicit mode is passed.

package/dist/index.js

@@ -1583,6 +1583,9 @@ function getRuntimeResources(resources) {
     }))
   ];
 }
+function isStaticPlatformAgentResource(resource) {
+  return resource.kind === "agent" && resource.agentKind === "platform";
+}
 function hasOntologySources(organizationModel) {
   return organizationModel.ontology !== void 0 || organizationModel.entities !== void 0 || organizationModel.actions !== void 0 || Object.values(organizationModel.systems ?? {}).some(systemHasOntologySource);
 }
@@ -1735,6 +1738,9 @@ function validateResourceGovernance(orgName, deployment, organizationModel = dep
     }
     const runtimeResource = runtimeResourcesById.get(resource.id);
     if (!runtimeResource) {
+      if (isStaticPlatformAgentResource(resource)) {
+        continue;
+      }
       addGovernanceIssue(
         issues,
         "missing-code-resource",
@@ -6325,20 +6331,9 @@ function projectDeploymentSpec(options) {
     options.getIntegrationResourceDescriptor,
     options.getResourceOntologyBinding
   );
-  const workflowResourceIds = new Set(workflows.map((workflow) => workflow.config.resourceId));
-  const integrationResourceIds = new Set(integrations.map((integration) => integration.resourceId));
-  const resources = projectDeploymentResources(
-    options.organizationModel.resources,
-    workflowResourceIds,
-    integrationResourceIds,
-    options.getResourceOntologyBinding
-  );
   return {
     version: options.version,
-    organizationModel: {
-      systems: projectDeploymentSystems(options.organizationModel),
-      resources
-    },
+    organizationModel: options.organizationModel,
     workflows,
     agents: options.agents ?? [],
     triggers: options.triggers,
@@ -6348,38 +6343,6 @@ function projectDeploymentSpec(options) {
     ...options.externalResources ? { externalResources: options.externalResources } : {}
   };
 }
-function projectDeploymentResources(resources, workflowResourceIds, integrationResourceIds, getResourceOntologyBinding) {
-  return Object.fromEntries(
-    Object.values(resources).filter((resource) => workflowResourceIds.has(resource.id) || integrationResourceIds.has(resource.id)).map((resource) => {
-      const sdkResource = toSdkResourceDescriptor(resource, getResourceOntologyBinding);
-      return [sdkResource.id, sdkResource];
-    })
-  );
-}
-function projectDeploymentSystems(model) {
-  return Object.fromEntries(
-    listAllSystems(model).map(({ path, system }, index) => {
-      const lifecycle = system.lifecycle === "archived" ? "archived" : system.lifecycle === "deprecated" ? "deprecated" : "active";
-      return [
-        system.id,
-        {
-          id: system.id,
-          order: system.order ?? (index + 1) * 10,
-          title: system.label ?? system.title ?? system.id,
-          description: system.description ?? "",
-          kind: system.kind ?? "product",
-          ...system.parentSystemId ? { parentSystemId: system.parentSystemId } : {},
-          ...path !== system.id ? { systemPath: path } : {},
-          governedByKnowledge: system.governedByKnowledge ?? [],
-          drivesGoals: system.drivesGoals ?? [],
-          lifecycle,
-          status: lifecycle,
-          ...system.responsibleRoleId ? { responsibleRoleId: system.responsibleRoleId } : {}
-        }
-      ];
-    })
-  );
-}
 var ListBuilderStageKeySchema = z.string().min(1);
 
 export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, ContractRefResolutionError, CrmStageKeySchema, CrmStateKeySchema, EmailSchema, ExecutionError, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, bindResourceDescriptor, compileBusinessOntologyValidationIndex, concurrentPool, createLeadGenStageValidators, defineContract, defineResource, defineResourceOntology, defineResources, defineStep, defineTopology, defineTopologyRelationship, defineWorkflow, deriveActions, diagnosticOutput, integrationInput, isZodType, parseTopologyNodeRef, projectDeploymentSpec, projectTopologyRelationships, resolveContractRef, runDiagnostic, splitName, toSdkResourceDescriptor, topologyRef, topologyRelationship, validateResourceGovernance, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors };

package/dist/node/index.d.ts

@@ -3001,8 +3001,8 @@ type ResourceLink = Link;
 interface DeploymentSpec {
     /** Deployment version (semver) */
     version: string;
-    /** Optional Organization Model governance catalog used for OM-code validation */
-    organizationModel?: Partial<Pick<OrganizationModel$1, 'systems' | 'resources' | 'ontology' | 'topology' | 'roles' | 'policies' | 'entities' | 'actions'>>;
+    /** Optional full Organization Model snapshot used for OM-code validation and deployment persistence */
+    organizationModel?: OrganizationModel$1;
     /** Workflow definitions */
     workflows?: WorkflowDefinition[];
     /** Agent definitions */

package/dist/node/index.js

@@ -511,26 +511,6 @@ async function runKnowledgeCodegen(layout) {
   );
 }
 
-// ../core/src/organization-model/helpers.ts
-function childSystemsOf(system) {
-  return system.systems ?? system.subsystems ?? {};
-}
-function listAllSystems(model) {
-  const results = [];
-  function walk(map, prefix) {
-    for (const [localId, system] of Object.entries(map)) {
-      const fullPath = prefix ? `${prefix}.${localId}` : localId;
-      results.push({ path: fullPath, system });
-      const childSystems = childSystemsOf(system);
-      if (Object.keys(childSystems).length > 0) {
-        walk(childSystems, fullPath);
-      }
-    }
-  }
-  walk(model.systems, "");
-  return results;
-}
-
 // src/project-deployment-spec.ts
 function toSdkResourceDescriptor(resource, getResourceOntologyBinding) {
   const ontologyBinding = getResourceOntologyBinding?.(resource.id);
@@ -617,20 +597,9 @@ function projectDeploymentSpec(options) {
     options.getIntegrationResourceDescriptor,
     options.getResourceOntologyBinding
   );
-  const workflowResourceIds = new Set(workflows.map((workflow) => workflow.config.resourceId));
-  const integrationResourceIds = new Set(integrations.map((integration) => integration.resourceId));
-  const resources = projectDeploymentResources(
-    options.organizationModel.resources,
-    workflowResourceIds,
-    integrationResourceIds,
-    options.getResourceOntologyBinding
-  );
   return {
     version: options.version,
-    organizationModel: {
-      systems: projectDeploymentSystems(options.organizationModel),
-      resources
-    },
+    organizationModel: options.organizationModel,
     workflows,
     agents: options.agents ?? [],
     triggers: options.triggers,
@@ -640,37 +609,5 @@ function projectDeploymentSpec(options) {
     ...options.externalResources ? { externalResources: options.externalResources } : {}
   };
 }
-function projectDeploymentResources(resources, workflowResourceIds, integrationResourceIds, getResourceOntologyBinding) {
-  return Object.fromEntries(
-    Object.values(resources).filter((resource) => workflowResourceIds.has(resource.id) || integrationResourceIds.has(resource.id)).map((resource) => {
-      const sdkResource = toSdkResourceDescriptor(resource, getResourceOntologyBinding);
-      return [sdkResource.id, sdkResource];
-    })
-  );
-}
-function projectDeploymentSystems(model) {
-  return Object.fromEntries(
-    listAllSystems(model).map(({ path, system }, index) => {
-      const lifecycle = system.lifecycle === "archived" ? "archived" : system.lifecycle === "deprecated" ? "deprecated" : "active";
-      return [
-        system.id,
-        {
-          id: system.id,
-          order: system.order ?? (index + 1) * 10,
-          title: system.label ?? system.title ?? system.id,
-          description: system.description ?? "",
-          kind: system.kind ?? "product",
-          ...system.parentSystemId ? { parentSystemId: system.parentSystemId } : {},
-          ...path !== system.id ? { systemPath: path } : {},
-          governedByKnowledge: system.governedByKnowledge ?? [],
-          drivesGoals: system.drivesGoals ?? [],
-          lifecycle,
-          status: lifecycle,
-          ...system.responsibleRoleId ? { responsibleRoleId: system.responsibleRoleId } : {}
-        }
-      ];
-    })
-  );
-}
 
 export { generateKnowledgeBodies, generateKnowledgeNodes, generateKnowledgeNodesTs, projectDeploymentSpec, projectTopologyRelationships, readKnowledgeNodeMdx, runKnowledgeCodegen, toSdkResourceDescriptor, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors };

package/dist/test-utils/index.d.ts

@@ -10471,8 +10471,8 @@ type ResourceLink = Link;
 interface DeploymentSpec {
     /** Deployment version (semver) */
     version: string;
-    /** Optional Organization Model governance catalog used for OM-code validation */
-    organizationModel?: Partial<Pick<OrganizationModel, 'systems' | 'resources' | 'ontology' | 'topology' | 'roles' | 'policies' | 'entities' | 'actions'>>;
+    /** Optional full Organization Model snapshot used for OM-code validation and deployment persistence */
+    organizationModel?: OrganizationModel;
     /** Workflow definitions */
     workflows?: WorkflowDefinition[];
     /** Agent definitions */

package/dist/test-utils/index.js

@@ -8601,6 +8601,9 @@ function getRuntimeResources(resources) {
     }))
   ];
 }
+function isStaticPlatformAgentResource(resource) {
+  return resource.kind === "agent" && resource.agentKind === "platform";
+}
 function hasOntologySources(organizationModel) {
   return organizationModel.ontology !== void 0 || organizationModel.entities !== void 0 || organizationModel.actions !== void 0 || Object.values(organizationModel.systems ?? {}).some(systemHasOntologySource);
 }
@@ -8753,6 +8756,9 @@ function validateResourceGovernance(orgName, deployment, organizationModel = dep
     }
     const runtimeResource = runtimeResourcesById.get(resource.id);
     if (!runtimeResource) {
+      if (isStaticPlatformAgentResource(resource)) {
+        continue;
+      }
       addGovernanceIssue(
         issues,
         "missing-code-resource",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.26.2",
+  "version": "1.27.0",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -58,7 +58,7 @@
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
     "zod": "^4.1.0",
-    "@repo/core": "0.33.0",
+    "@repo/core": "0.34.2",
     "@repo/eslint-config": "0.0.0",
     "@repo/typescript-config": "0.0.0"
   },

package/reference/claude-config/sync-notes/2026-05-23-om-full-model-deploy-contract.md

@@ -0,0 +1,33 @@
+# Full Organization Model deploy contract
+
+## Why this note exists
+
+The deployment contract now requires SDK projects to deploy the full canonical `organizationModel`, not the internal `resourceGovernanceModel` projection. The SDK and API now parse deployment snapshots with `OrganizationModelSchema` before overlay validation or persistence, so partial governance projections will fail before they can become active deployment snapshots.
+
+This fixes the class of production failures where an active deployment persisted only `systems`, `resources`, `topology`, `entities`, and `actions`, then the runtime resolver failed because referenced `roles`, `goals`, and `navigation` were absent.
+
+## Applies to
+
+All template-derived projects with an `operations/src/index.ts` deployment spec and a `core/config/organization-model.ts` canonical model.
+
+## Required actions
+
+1. Pull the new package baselines after the release train publishes:
+   - `@elevasis/core`
+   - `@elevasis/sdk`
+2. Ensure `operations/src/index.ts` imports and passes the canonical full `organizationModel` from `@core/config/organization-model`.
+3. Keep `resourceGovernanceModel` only for local compatibility assertions or profile assembly. Do not pass it as `DeploymentSpec.organizationModel`.
+4. Redeploy the operations bundle so the active platform deployment persists a full model snapshot:
+   - dev: `pnpm -C operations deploy`
+   - prod: `pnpm -C operations deploy:prod`
+
+## Verification
+
+- `pnpm -C operations check`
+- `pnpm -C core test -- organization-model`
+- Confirm the active deployment Organization Model snapshot parses and includes full domains such as `roles`, `goals`, and `navigation`.
+- Confirm acquisition/list or other OM-backed routes no longer fail with `MODEL_PARSE_FAILED`.
+
+## Not handled by /git-sync
+
+`/git-sync` can propagate template guidance and package baselines, but it does not install dependencies, publish packages, deploy the operations bundle, or verify the active platform deployment snapshot. Each derived project must run install/deploy and production smoke checks after syncing.

package/reference/framework/project-structure.mdx

@@ -18,13 +18,13 @@ The registry entry point for your workspace. This file imports OM resource gover
 
 ```ts
 import type { DeploymentSpec } from '@elevasis/sdk'
-import { resourceGovernanceModel } from '@core/config/organization-model'
+import { organizationModel } from '@core/config/organization-model'
 import * as example from './example/index.js'
 import * as emailNotification from './email-notification/exports.js'
 
 const org: DeploymentSpec = {
   version: '0.1.0',
-  organizationModel: resourceGovernanceModel,
+  organizationModel,
   workflows: [...example.workflows, ...emailNotification.workflows],
   agents: [...example.agents, ...emailNotification.agents]
 }

package/reference/resources/index.mdx

@@ -301,11 +301,11 @@ All executable resources must be assembled through a `DeploymentSpec` default ex
 
 ```typescript
 import type { DeploymentSpec } from '@elevasis/sdk';
-import { resourceGovernanceModel } from '@core/config/organization-model';
+import { organizationModel } from '@core/config/organization-model';
 
 const org: DeploymentSpec = {
   version: '0.1.0',
-  organizationModel: resourceGovernanceModel,
+  organizationModel,
   workflows: [echoWorkflow, pipeline],
   agents: [
     // myAgent,

package/reference/scaffold/operations/workflow-recipes.md

@@ -410,16 +410,16 @@ operations/src/
 Top-level registry (`operations/src/index.ts`):
 
 ```typescript
-import type { DeploymentSpec } from '@elevasis/sdk'
-import { resourceGovernanceModel } from '@core/config/organization-model'
-import * as example from './example/index.js'
-import * as emailNotification from './email-notification/exports.js'
-
-const org: DeploymentSpec = {
-  version: '0.1.0',
-  organizationModel: resourceGovernanceModel,
-  workflows: [...example.workflows, ...emailNotification.workflows],
-  agents: [...example.agents, ...emailNotification.agents]
+import type { DeploymentSpec } from '@elevasis/sdk'
+import { organizationModel } from '@core/config/organization-model'
+import * as example from './example/index.js'
+import * as emailNotification from './email-notification/exports.js'
+
+const org: DeploymentSpec = {
+  version: '0.1.0',
+  organizationModel,
+  workflows: [...example.workflows, ...emailNotification.workflows],
+  agents: [...example.agents, ...emailNotification.agents]
 }
 export default org
 ```

package/reference/scaffold/recipes/add-a-feature.md

@@ -218,8 +218,8 @@ Use `codeRefs` as repo-relative breadcrumbs for agents and operators. They point
 Workflow and agent code owns schemas, handlers, steps, and runtime behavior. It should import the descriptor and derive `resourceId`, `type`, and display metadata from it.
 
 ```ts
-import type { WorkflowDefinition } from '@elevasis/sdk'
-import { resourceDescriptors } from '@core/config/organization-model'
+import type { WorkflowDefinition } from '@elevasis/sdk'
+import { organizationModel, resourceDescriptors } from '@core/config/organization-model'
 
 export const approveReviewItemWorkflow: WorkflowDefinition = {
   config: {
@@ -244,11 +244,11 @@ export const approveReviewItemWorkflow: WorkflowDefinition = {
 Register runtime resources in the deployment assembly, usually `operations/src/index.ts`:
 
 ```ts
-export const org = {
-  version: '0.1.0',
-  organizationModel: resourceGovernanceModel,
-  workflows: [approveReviewItemWorkflow],
-  agents: [],
+export const org = {
+  version: '0.1.0',
+  organizationModel,
+  workflows: [approveReviewItemWorkflow],
+  agents: [],
   relationships: {
     'approve-review-item-workflow': {
       uses: { integrations: ['email'] }

package/reference/scaffold/recipes/add-a-resource.md

@@ -111,14 +111,14 @@ export const myWorkflow: WorkflowDefinition = {
 ## 3. Register in the deployment spec
 
 ```ts
-import { resourceGovernanceModel } from '@core/config/organization-model'
-import { myWorkflow } from './my-workflow/index.js'
-
-export const org = {
-  version: '0.1.0',
-  organizationModel: resourceGovernanceModel,
-  workflows: [myWorkflow],
-  agents: []
+import { organizationModel } from '@core/config/organization-model'
+import { myWorkflow } from './my-workflow/index.js'
+
+export const org = {
+  version: '0.1.0',
+  organizationModel,
+  workflows: [myWorkflow],
+  agents: []
 }
 ```
 

package/reference/scaffold/reference/contracts.md

@@ -1331,38 +1331,33 @@ export interface HumanCheckpointDefinition extends ResourceDefinition {
 ### `DeploymentSpec`
 
 ```typescript
-/**
- * Organization-specific resource collection
- *
- * Complete manifest of all automation resources for an organization.
- * Used by ResourceRegistry for discovery and Command View for visualization.
- */
-export interface DeploymentSpec {
+/**
+ * Organization-specific resource collection
+ *
+ * Complete manifest of all automation resources for an organization.
+ * Used by ResourceRegistry for discovery and Command View for visualization.
+ */
+export interface DeploymentSpec {
   /** Deployment version (semver) */
   version: string
-  /** Optional Organization Model governance catalog used for OM-code validation */
-  organizationModel?: Partial<
-    Pick<
-      OrganizationModel,
-      'systems' | 'resources' | 'ontology' | 'topology' | 'roles' | 'policies' | 'entities' | 'actions'
-    >
-  >
-  /** Workflow definitions */
-  workflows?: WorkflowDefinition[]
-  /** Agent definitions */
-  agents?: AgentDefinition[]
-
-  // Resource Manifest fields (optional for backwards compatibility)
-  /** Trigger definitions - entry points that initiate executions */
-  triggers?: TriggerDefinition[]
-  /** Integration definitions - external service connections */
-  integrations?: IntegrationDefinition[]
-  /** Explicit relationship declarations between resources */
-  relationships?: ResourceRelationships
-  /** External automation resources (n8n, Make, Zapier, etc.) */
-  externalResources?: ExternalResourceDefinition[]
-  /** Human checkpoint definitions - human decision points in automation */
-  humanCheckpoints?: HumanCheckpointDefinition[]
+  /** Optional full Organization Model snapshot used for OM-code validation and deployment persistence */
+  organizationModel?: OrganizationModel
+  /** Workflow definitions */
+  workflows?: WorkflowDefinition[]
+  /** Agent definitions */
+  agents?: AgentDefinition[]
+
+  // Resource Manifest fields (optional for backwards compatibility)
+  /** Trigger definitions - entry points that initiate executions */
+  triggers?: TriggerDefinition[]
+  /** Integration definitions - external service connections */
+  integrations?: IntegrationDefinition[]
+  /** Explicit relationship declarations between resources */
+  relationships?: ResourceRelationships
+  /** External automation resources (n8n, Make, Zapier, etc.) */
+  externalResources?: ExternalResourceDefinition[]
+  /** Human checkpoint definitions - human decision points in automation */
+  humanCheckpoints?: HumanCheckpointDefinition[]
 }
 ```