@elevasis/core 0.21.0 → 0.22.0

package/src/organization-model/README.md

@@ -47,10 +47,13 @@ Top-level fields:
 - `offerings`
 - `roles`
 - `goals`
+- `systems`
+- `resources`
 - `statuses`
 - `operations`
+- `knowledge`
 
-Resources bind to the graph from deployment metadata through `links` and `category`.
+Resource identity is authored in `resources.entries`. Runtime workflows, agents, and integrations import those descriptors, derive `resourceId` and kind from them, and attach executable behavior in operations code.
 
 ## Feature Set
 
@@ -77,6 +80,10 @@ Cross-collection links use kind-prefixed IDs:
 - `resource:lead-import`
 - `capability:operations.queue.review`
 
+## Resource Descriptors
+
+The OM Resources domain is governance-only. Descriptors declare canonical `id`, required `systemId`, governance `status`, and optional role ownership. `DeploymentSpec` remains the runtime/deploy assembly around those descriptors, not a second resource identity catalog.
+
 ## Resolution Semantics
 
 - `defineOrganizationModel()` is a typed helper.
@@ -92,11 +99,11 @@ Cross-collection links use kind-prefixed IDs:
 - Child feature IDs require ancestor feature nodes.
 - Container features omit `path`.
 - Leaf features provide `path`.
-- Resource links are validated against graph node IDs during registry registration.
+- Systems, resources, roles, knowledge nodes, and goals must resolve their declared cross-references.
 
 ## Practical Guidance
 
 - Use `resolveOrganizationModel()` when you need a runtime-safe model.
 - Use `defineOrganizationModel()` when authoring static overrides.
 - Keep feature IDs stable because shell routing, gating, breadcrumbs, and docs depend on them.
-- Put semantic resource relationships on resource metadata, not on feature nodes.
+- Put resource identity and governance in `resources.entries`; attach executable behavior in operations.

package/src/organization-model/__tests__/defaults.test.ts

@@ -14,6 +14,7 @@ import { DEFAULT_ORGANIZATION_MODEL_OPERATIONS } from '../domains/operations'
 import { OperationsDomainSchema } from '../domains/operations'
 import { DEFAULT_ORGANIZATION_MODEL_STATUSES } from '../domains/statuses'
 import { StatusesDomainSchema } from '../domains/statuses'
+import { DEFAULT_ORGANIZATION_MODEL_SYSTEMS, SystemsDomainSchema } from '../domains/systems'
 import { resolveOrganizationModel } from '../resolve'
 import { OrganizationModelSchema } from '../schema'
 
@@ -55,6 +56,11 @@ const domainCases = [
     name: 'DEFAULT_ORGANIZATION_MODEL_OPERATIONS',
     constant: DEFAULT_ORGANIZATION_MODEL_OPERATIONS,
     schema: OperationsDomainSchema
+  },
+  {
+    name: 'DEFAULT_ORGANIZATION_MODEL_SYSTEMS',
+    constant: DEFAULT_ORGANIZATION_MODEL_SYSTEMS,
+    schema: SystemsDomainSchema
   }
 ] as const
 

package/src/organization-model/__tests__/domains/resources.test.ts

@@ -0,0 +1,188 @@
+import { describe, expect, it } from 'vitest'
+import { bindResourceDescriptor } from '../../../platform/registry/types'
+import {
+  DEFAULT_ORGANIZATION_MODEL_RESOURCES,
+  ResourceEntrySchema,
+  ResourceKindSchema,
+  ResourcesDomainSchema,
+  defineResource,
+  defineResources
+} from '../../domains/resources'
+import { resolveOrganizationModel } from '../../resolve'
+
+const VALID_SYSTEM = {
+  id: 'sys.lead-gen',
+  title: 'Lead Generation Pipeline',
+  description: 'Coordinates prospecting, enrichment, qualification, and outreach preparation.',
+  kind: 'operational' as const,
+  status: 'active' as const
+}
+
+const VALID_ROLE = {
+  id: 'role.sales-ops',
+  title: 'Sales Ops'
+}
+
+const WORKFLOW_RESOURCE = {
+  id: 'LGN-01-company-scrape',
+  kind: 'workflow' as const,
+  systemId: 'sys.lead-gen',
+  ownerRoleId: 'role.sales-ops',
+  status: 'active' as const,
+  capabilityKey: 'lead-gen.company.scrape'
+}
+
+const AGENT_RESOURCE = {
+  id: 'command-center-assistant',
+  kind: 'agent' as const,
+  systemId: 'sys.lead-gen',
+  ownerRoleId: 'role.sales-ops',
+  status: 'active' as const,
+  agentKind: 'system' as const,
+  actsAsRoleId: 'role.sales-ops',
+  sessionCapable: true
+}
+
+const INTEGRATION_RESOURCE = {
+  id: 'attio-crm',
+  kind: 'integration' as const,
+  systemId: 'sys.lead-gen',
+  ownerRoleId: 'role.sales-ops',
+  status: 'active' as const,
+  provider: 'attio'
+}
+
+function resolveWithResources(resources: unknown[]) {
+  return resolveOrganizationModel({
+    roles: { roles: [VALID_ROLE] },
+    systems: { systems: [VALID_SYSTEM] },
+    resources: { entries: resources }
+  })
+}
+
+describe('ResourceEntrySchema', () => {
+  it('accepts workflow, agent, and integration descriptors with required systemId', () => {
+    expect(ResourceEntrySchema.safeParse(WORKFLOW_RESOURCE).success).toBe(true)
+    expect(ResourceEntrySchema.safeParse(AGENT_RESOURCE).success).toBe(true)
+    expect(ResourceEntrySchema.safeParse(INTEGRATION_RESOURCE).success).toBe(true)
+  })
+
+  it('rejects resources without a systemId', () => {
+    const { systemId: _systemId, ...resourceWithoutSystem } = WORKFLOW_RESOURCE
+
+    expect(ResourceEntrySchema.safeParse(resourceWithoutSystem).success).toBe(false)
+  })
+
+  it('rejects multi-system membership', () => {
+    expect(
+      ResourceEntrySchema.safeParse({
+        ...WORKFLOW_RESOURCE,
+        systemId: ['sys.lead-gen', 'sys.crm']
+      }).success
+    ).toBe(false)
+  })
+
+  it('rejects an agent kind outside the code-side mirror enum', () => {
+    expect(
+      ResourceEntrySchema.safeParse({
+        ...AGENT_RESOURCE,
+        agentKind: 'runner'
+      }).success
+    ).toBe(false)
+  })
+})
+
+describe('ResourcesDomainSchema', () => {
+  it('defaults resources to an empty array when omitted', () => {
+    const result = ResourcesDomainSchema.safeParse({})
+
+    expect(result.success).toBe(true)
+    if (result.success) {
+      expect(result.data).toEqual(DEFAULT_ORGANIZATION_MODEL_RESOURCES)
+    }
+  })
+
+  it.each(['workflow', 'agent', 'integration'] as const)('accepts kind "%s"', (kind) => {
+    expect(ResourceKindSchema.safeParse(kind).success).toBe(true)
+  })
+})
+
+describe('resolveOrganizationModel - resources domain integration', () => {
+  it('accepts valid resources with system and role references', () => {
+    const model = resolveWithResources([WORKFLOW_RESOURCE, AGENT_RESOURCE, INTEGRATION_RESOURCE])
+
+    expect(model.resources.entries).toHaveLength(3)
+  })
+
+  it('throws when resource IDs are duplicated', () => {
+    expect(() =>
+      resolveWithResources([
+        WORKFLOW_RESOURCE,
+        {
+          ...WORKFLOW_RESOURCE,
+          capabilityKey: 'lead-gen.company.scrape-duplicate'
+        }
+      ])
+    ).toThrow(/Resource id \\"LGN-01-company-scrape\\" must be unique/)
+  })
+
+  it('throws when systemId references an unknown system', () => {
+    expect(() =>
+      resolveWithResources([
+        {
+          ...WORKFLOW_RESOURCE,
+          systemId: 'sys.missing'
+        }
+      ])
+    ).toThrow(/unknown systemId \\"sys\.missing\\"/)
+  })
+
+  it('throws when ownerRoleId references an unknown role', () => {
+    expect(() =>
+      resolveWithResources([
+        {
+          ...WORKFLOW_RESOURCE,
+          ownerRoleId: 'role.missing'
+        }
+      ])
+    ).toThrow(/unknown ownerRoleId \\"role\.missing\\"/)
+  })
+
+  it('throws when agent actsAsRoleId references an unknown role', () => {
+    expect(() =>
+      resolveWithResources([
+        {
+          ...AGENT_RESOURCE,
+          actsAsRoleId: 'role.missing'
+        }
+      ])
+    ).toThrow(/unknown actsAsRoleId \\"role\.missing\\"/)
+  })
+})
+
+describe('descriptor helper contract', () => {
+  it('preserves typed descriptor exports through defineResource and defineResources', () => {
+    const workflow = defineResource(WORKFLOW_RESOURCE)
+    const resources = defineResources({
+      companyScrape: WORKFLOW_RESOURCE,
+      commandCenterAssistant: AGENT_RESOURCE
+    })
+
+    expect(workflow.id).toBe('LGN-01-company-scrape')
+    expect(resources.commandCenterAssistant.agentKind).toBe('system')
+  })
+
+  it('derives runtime resourceId and type from the descriptor', () => {
+    const bound = bindResourceDescriptor({
+      resource: WORKFLOW_RESOURCE,
+      name: 'Company Scrape',
+      description: 'Scrapes company data for lead generation.',
+      version: '1.0.0',
+      status: 'prod'
+    })
+
+    expect(bound.resourceId).toBe('LGN-01-company-scrape')
+    expect(bound.type).toBe('workflow')
+    expect(bound.resource).toBe(WORKFLOW_RESOURCE)
+  })
+})