@elevasis/core 0.23.0 → 0.24.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (243) hide show
  1. package/dist/index.d.ts +4343 -2690
  2. package/dist/index.js +1101 -156
  3. package/dist/knowledge/index.d.ts +574 -210
  4. package/dist/knowledge/index.js +104 -1
  5. package/dist/organization-model/index.d.ts +4343 -2690
  6. package/dist/organization-model/index.js +1101 -156
  7. package/dist/test-utils/index.d.ts +483 -109
  8. package/dist/test-utils/index.js +904 -144
  9. package/package.json +3 -3
  10. package/src/README.md +14 -14
  11. package/src/__tests__/publish.test.ts +24 -24
  12. package/src/__tests__/template-core-compatibility.test.ts +9 -12
  13. package/src/_gen/__tests__/__snapshots__/contracts.md.snap +2137 -2093
  14. package/src/_gen/__tests__/scaffold-contracts.test.ts +30 -30
  15. package/src/auth/multi-tenancy/credentials/__tests__/encryption.test.ts +217 -217
  16. package/src/auth/multi-tenancy/credentials/server/encryption.ts +69 -69
  17. package/src/auth/multi-tenancy/credentials/server/kek-loader.ts +37 -37
  18. package/src/auth/multi-tenancy/index.ts +26 -26
  19. package/src/auth/multi-tenancy/invitations/api-schemas.ts +104 -104
  20. package/src/auth/multi-tenancy/memberships/api-schemas.ts +143 -143
  21. package/src/auth/multi-tenancy/memberships/index.ts +26 -26
  22. package/src/auth/multi-tenancy/memberships/membership.ts +130 -130
  23. package/src/auth/multi-tenancy/organizations/__tests__/api-schemas.test.ts +194 -194
  24. package/src/auth/multi-tenancy/organizations/api-schemas.ts +136 -136
  25. package/src/auth/multi-tenancy/permissions.test.ts +42 -42
  26. package/src/auth/multi-tenancy/permissions.ts +123 -123
  27. package/src/auth/multi-tenancy/role-management/api-schemas.ts +78 -78
  28. package/src/auth/multi-tenancy/role-management/index.ts +16 -16
  29. package/src/auth/multi-tenancy/theme-presets.ts +45 -45
  30. package/src/auth/multi-tenancy/types.ts +57 -57
  31. package/src/auth/multi-tenancy/users/api-schemas.ts +165 -165
  32. package/src/business/README.md +2 -2
  33. package/src/business/acquisition/activity-events.test.ts +250 -250
  34. package/src/business/acquisition/activity-events.ts +93 -93
  35. package/src/business/acquisition/api-schemas.test.ts +1883 -1843
  36. package/src/business/acquisition/api-schemas.ts +1492 -1497
  37. package/src/business/acquisition/build-templates.test.ts +240 -240
  38. package/src/business/acquisition/build-templates.ts +98 -98
  39. package/src/business/acquisition/crm-next-action.test.ts +262 -262
  40. package/src/business/acquisition/crm-next-action.ts +220 -220
  41. package/src/business/acquisition/crm-priority.test.ts +216 -216
  42. package/src/business/acquisition/crm-priority.ts +349 -349
  43. package/src/business/acquisition/crm-state-actions.test.ts +153 -153
  44. package/src/business/acquisition/deal-ownership.test.ts +351 -351
  45. package/src/business/acquisition/deal-ownership.ts +120 -120
  46. package/src/business/acquisition/derive-actions.test.ts +129 -104
  47. package/src/business/acquisition/derive-actions.ts +74 -84
  48. package/src/business/acquisition/index.ts +171 -170
  49. package/src/business/acquisition/ontology-validation.ts +309 -0
  50. package/src/business/acquisition/stateful.ts +30 -30
  51. package/src/business/acquisition/types.ts +396 -396
  52. package/src/business/clients/api-schemas.test.ts +115 -115
  53. package/src/business/clients/api-schemas.ts +158 -158
  54. package/src/business/clients/index.ts +1 -1
  55. package/src/business/crm/api-schemas.ts +40 -40
  56. package/src/business/crm/index.ts +1 -1
  57. package/src/business/deals/api-schemas.ts +87 -87
  58. package/src/business/deals/index.ts +1 -1
  59. package/src/business/index.ts +5 -5
  60. package/src/business/projects/types.ts +144 -144
  61. package/src/commands/queue/types/task.ts +15 -15
  62. package/src/execution/core/runner-types.ts +61 -61
  63. package/src/execution/core/sse-executions.ts +7 -7
  64. package/src/execution/engine/__tests__/fixtures/test-agents.ts +10 -10
  65. package/src/execution/engine/agent/core/__tests__/agent.test.ts +16 -16
  66. package/src/execution/engine/agent/core/__tests__/error-passthrough.test.ts +4 -4
  67. package/src/execution/engine/agent/core/types.ts +25 -25
  68. package/src/execution/engine/agent/index.ts +6 -6
  69. package/src/execution/engine/agent/reasoning/__tests__/request-builder.test.ts +24 -24
  70. package/src/execution/engine/index.ts +443 -443
  71. package/src/execution/engine/tools/integration/server/adapters/apify/__tests__/apify-run-actor.integration.test.ts +298 -298
  72. package/src/execution/engine/tools/integration/server/adapters/apify/apify-adapter.test.ts +55 -55
  73. package/src/execution/engine/tools/integration/server/adapters/apify/apify-adapter.ts +107 -107
  74. package/src/execution/engine/tools/integration/server/adapters/apollo/apollo-adapter.test.ts +48 -48
  75. package/src/execution/engine/tools/integration/server/adapters/apollo/apollo-adapter.ts +99 -99
  76. package/src/execution/engine/tools/integration/server/adapters/apollo/index.ts +1 -1
  77. package/src/execution/engine/tools/integration/server/adapters/attio/__tests__/attio-crud.integration.test.ts +363 -363
  78. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/get-record/index.test.ts +162 -162
  79. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-records/index.test.ts +316 -316
  80. package/src/execution/engine/tools/integration/server/adapters/clickup/clickup-adapter.test.ts +18 -18
  81. package/src/execution/engine/tools/integration/server/adapters/clickup/clickup-adapter.ts +194 -194
  82. package/src/execution/engine/tools/integration/server/adapters/clickup/index.ts +7 -7
  83. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-adapter.ts +204 -204
  84. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-tools.ts +105 -105
  85. package/src/execution/engine/tools/integration/server/adapters/google-calendar/google-calendar-adapter.ts +428 -428
  86. package/src/execution/engine/tools/integration/server/adapters/google-calendar/index.ts +2 -2
  87. package/src/execution/engine/tools/integration/server/adapters/google-sheets/__tests__/google-sheets.integration.test.ts +261 -261
  88. package/src/execution/engine/tools/integration/server/adapters/instantly/instantly-tools.ts +1474 -1474
  89. package/src/execution/engine/tools/integration/server/adapters/millionverifier/millionverifier-tools.ts +103 -103
  90. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/send-email/index.test.ts +88 -88
  91. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/send-email/index.ts +141 -141
  92. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/utils/types.ts +76 -76
  93. package/src/execution/engine/tools/integration/server/adapters/signature-api/signature-api-tools.ts +182 -182
  94. package/src/execution/engine/tools/integration/server/adapters/stripe/stripe-tools.ts +310 -310
  95. package/src/execution/engine/tools/integration/service.test.ts +239 -239
  96. package/src/execution/engine/tools/integration/service.ts +172 -172
  97. package/src/execution/engine/tools/integration/tool.ts +255 -255
  98. package/src/execution/engine/tools/lead-service-types.ts +1005 -1005
  99. package/src/execution/engine/tools/messages.ts +43 -43
  100. package/src/execution/engine/tools/platform/acquisition/company-tools.ts +7 -7
  101. package/src/execution/engine/tools/platform/acquisition/contact-tools.ts +6 -6
  102. package/src/execution/engine/tools/platform/acquisition/list-tools.ts +6 -6
  103. package/src/execution/engine/tools/platform/acquisition/types.ts +280 -280
  104. package/src/execution/engine/tools/platform/email/types.ts +97 -97
  105. package/src/execution/engine/tools/registry.ts +704 -704
  106. package/src/execution/engine/tools/tool-maps.ts +831 -831
  107. package/src/execution/engine/tools/types.ts +234 -234
  108. package/src/execution/engine/workflow/types.ts +195 -197
  109. package/src/execution/external/__tests__/api-schemas.test.ts +127 -127
  110. package/src/execution/external/api-schemas.ts +40 -40
  111. package/src/execution/external/index.ts +1 -1
  112. package/src/index.ts +18 -18
  113. package/src/integrations/credentials/__tests__/api-schemas.test.ts +420 -420
  114. package/src/integrations/credentials/api-schemas.ts +146 -146
  115. package/src/integrations/credentials/schemas.ts +200 -200
  116. package/src/integrations/oauth/__tests__/provider-registry.test.ts +7 -7
  117. package/src/integrations/oauth/provider-registry.ts +74 -74
  118. package/src/integrations/oauth/server/credentials.ts +43 -43
  119. package/src/integrations/webhook-endpoints/__tests__/api-schemas.test.ts +327 -327
  120. package/src/integrations/webhook-endpoints/api-schemas.ts +103 -103
  121. package/src/integrations/webhook-endpoints/types.ts +58 -58
  122. package/src/knowledge/README.md +32 -32
  123. package/src/knowledge/__tests__/queries.test.ts +626 -535
  124. package/src/knowledge/format.ts +99 -99
  125. package/src/knowledge/index.ts +5 -5
  126. package/src/knowledge/published.ts +5 -5
  127. package/src/knowledge/queries.ts +269 -218
  128. package/src/operations/activities/api-schemas.ts +80 -80
  129. package/src/operations/activities/types.ts +64 -64
  130. package/src/organization-model/README.md +149 -149
  131. package/src/organization-model/__tests__/content-kinds-registry.test.ts +210 -210
  132. package/src/organization-model/__tests__/defaults.test.ts +168 -168
  133. package/src/organization-model/__tests__/domains/actions.test.ts +78 -56
  134. package/src/organization-model/__tests__/domains/customers.test.ts +299 -299
  135. package/src/organization-model/__tests__/domains/entities.test.ts +56 -56
  136. package/src/organization-model/__tests__/domains/goals.test.ts +493 -493
  137. package/src/organization-model/__tests__/domains/identity.test.ts +280 -280
  138. package/src/organization-model/__tests__/domains/navigation.test.ts +268 -268
  139. package/src/organization-model/__tests__/domains/offerings.test.ts +414 -414
  140. package/src/organization-model/__tests__/domains/policies.test.ts +323 -323
  141. package/src/organization-model/__tests__/domains/resource-mappings.test.ts +293 -293
  142. package/src/organization-model/__tests__/domains/resources.test.ts +387 -277
  143. package/src/organization-model/__tests__/domains/roles.test.ts +463 -463
  144. package/src/organization-model/__tests__/domains/statuses.test.ts +246 -246
  145. package/src/organization-model/__tests__/domains/systems.test.ts +209 -209
  146. package/src/organization-model/__tests__/domains/topology.test.ts +188 -0
  147. package/src/organization-model/__tests__/flatten-additive-merge.test.ts +362 -361
  148. package/src/organization-model/__tests__/foundation.test.ts +77 -77
  149. package/src/organization-model/__tests__/get-resources-for-system.test.ts +144 -144
  150. package/src/organization-model/__tests__/graph.test.ts +1312 -862
  151. package/src/organization-model/__tests__/icons.test.ts +10 -1
  152. package/src/organization-model/__tests__/knowledge.test.ts +251 -15
  153. package/src/organization-model/__tests__/lookup-helpers.test.ts +438 -438
  154. package/src/organization-model/__tests__/migration-helpers.test.ts +591 -591
  155. package/src/organization-model/__tests__/prospecting-ssot.test.ts +103 -103
  156. package/src/organization-model/__tests__/recursive-system-schema.test.ts +535 -506
  157. package/src/organization-model/__tests__/resolve.test.ts +274 -164
  158. package/src/organization-model/__tests__/schema.test.ts +844 -301
  159. package/src/organization-model/__tests__/surface-projection.test.ts +284 -284
  160. package/src/organization-model/catalogs/lead-gen.ts +144 -144
  161. package/src/organization-model/content-kinds/config.ts +36 -36
  162. package/src/organization-model/content-kinds/index.ts +76 -72
  163. package/src/organization-model/content-kinds/pipeline.ts +68 -68
  164. package/src/organization-model/content-kinds/registry.ts +44 -44
  165. package/src/organization-model/content-kinds/status.ts +71 -71
  166. package/src/organization-model/content-kinds/template.ts +83 -83
  167. package/src/organization-model/content-kinds/types.ts +117 -117
  168. package/src/organization-model/contracts.ts +27 -27
  169. package/src/organization-model/defaults.ts +42 -50
  170. package/src/organization-model/domains/actions.ts +333 -239
  171. package/src/organization-model/domains/customers.ts +78 -78
  172. package/src/organization-model/domains/entities.ts +144 -144
  173. package/src/organization-model/domains/goals.ts +83 -83
  174. package/src/organization-model/domains/knowledge.ts +117 -101
  175. package/src/organization-model/domains/navigation.ts +139 -139
  176. package/src/organization-model/domains/offerings.ts +71 -71
  177. package/src/organization-model/domains/policies.ts +102 -102
  178. package/src/organization-model/domains/projects.ts +14 -14
  179. package/src/organization-model/domains/prospecting.ts +395 -395
  180. package/src/organization-model/domains/resources.ts +202 -124
  181. package/src/organization-model/domains/roles.ts +96 -96
  182. package/src/organization-model/domains/sales.test.ts +218 -218
  183. package/src/organization-model/domains/sales.ts +380 -380
  184. package/src/organization-model/domains/shared.ts +63 -63
  185. package/src/organization-model/domains/statuses.ts +339 -339
  186. package/src/organization-model/domains/systems.ts +217 -172
  187. package/src/organization-model/domains/topology.ts +261 -0
  188. package/src/organization-model/foundation.ts +75 -75
  189. package/src/organization-model/graph/build.ts +1043 -867
  190. package/src/organization-model/graph/index.ts +4 -4
  191. package/src/organization-model/graph/link.ts +10 -10
  192. package/src/organization-model/graph/schema.ts +75 -68
  193. package/src/organization-model/graph/types.ts +71 -64
  194. package/src/organization-model/helpers.ts +289 -241
  195. package/src/organization-model/icons.ts +78 -66
  196. package/src/organization-model/index.ts +128 -125
  197. package/src/organization-model/migration-helpers.ts +247 -244
  198. package/src/organization-model/ontology.ts +658 -0
  199. package/src/organization-model/organization-graph.mdx +110 -90
  200. package/src/organization-model/organization-model.mdx +225 -213
  201. package/src/organization-model/published.ts +299 -222
  202. package/src/organization-model/resolve.ts +146 -91
  203. package/src/organization-model/schema.ts +818 -659
  204. package/src/organization-model/surface-projection.ts +212 -212
  205. package/src/organization-model/types.ts +179 -155
  206. package/src/platform/api/types.ts +38 -38
  207. package/src/platform/constants/versions.ts +3 -3
  208. package/src/platform/index.ts +23 -23
  209. package/src/platform/registry/__tests__/command-view.test.ts +10 -10
  210. package/src/platform/registry/__tests__/resource-link.test.ts +35 -35
  211. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +20 -20
  212. package/src/platform/registry/__tests__/resource-registry.nested-systems.test.ts +245 -245
  213. package/src/platform/registry/__tests__/resource-registry.test.ts +2053 -2053
  214. package/src/platform/registry/__tests__/validation.test.ts +1444 -1259
  215. package/src/platform/registry/command-view.ts +10 -10
  216. package/src/platform/registry/index.ts +103 -103
  217. package/src/platform/registry/resource-link.ts +32 -32
  218. package/src/platform/registry/resource-registry.ts +886 -886
  219. package/src/platform/registry/serialization.ts +295 -295
  220. package/src/platform/registry/serialized-types.ts +166 -166
  221. package/src/platform/registry/stats-types.ts +68 -68
  222. package/src/platform/registry/types.ts +425 -425
  223. package/src/platform/registry/validation.ts +876 -684
  224. package/src/platform/utils/__tests__/validation.test.ts +1084 -1084
  225. package/src/platform/utils/validation.ts +425 -425
  226. package/src/projects/api-schemas.test.ts +39 -39
  227. package/src/projects/api-schemas.ts +291 -291
  228. package/src/reference/_generated/contracts.md +2136 -2093
  229. package/src/reference/glossary.md +76 -76
  230. package/src/scaffold-registry/__tests__/index.test.ts +206 -206
  231. package/src/scaffold-registry/__tests__/schema.test.ts +166 -166
  232. package/src/scaffold-registry/index.ts +392 -392
  233. package/src/scaffold-registry/schema.ts +243 -243
  234. package/src/server.ts +289 -289
  235. package/src/supabase/database.types.ts +3 -0
  236. package/src/test-utils/README.md +37 -37
  237. package/src/test-utils/entities.ts +108 -108
  238. package/src/test-utils/fixtures/memberships.ts +82 -82
  239. package/src/test-utils/index.ts +12 -12
  240. package/src/test-utils/organization-model.ts +65 -65
  241. package/src/test-utils/published.ts +6 -6
  242. package/src/test-utils/rls/RLSTestContext.ts +588 -588
  243. package/src/test-utils/test-utils.test.ts +44 -44
@@ -32,14 +32,14 @@ describe('ResourceRegistry Integration', () => {
32
32
  // Mock Data Helpers
33
33
  // ============================================================================
34
34
 
35
- const createMockWorkflow = (resourceId: string, status: 'dev' | 'prod' = 'dev'): WorkflowDefinition => ({
35
+ const createMockWorkflow = (resourceId: string, status: 'dev' | 'prod' = 'dev'): WorkflowDefinition => ({
36
36
  config: {
37
37
  resourceId,
38
38
  name: `Workflow ${resourceId}`,
39
39
  description: `Test workflow ${resourceId}`,
40
- version: '1.0.0',
41
- type: 'workflow',
42
- status
40
+ version: '1.0.0',
41
+ type: 'workflow',
42
+ status
43
43
  },
44
44
  contract: {
45
45
  inputSchema: z.object({ data: z.string() }),
@@ -59,15 +59,15 @@ describe('ResourceRegistry Integration', () => {
59
59
  entryPoint: 'step1'
60
60
  })
61
61
 
62
- const createMockAgent = (resourceId: string, status: 'dev' | 'prod' = 'dev'): AgentDefinition => ({
62
+ const createMockAgent = (resourceId: string, status: 'dev' | 'prod' = 'dev'): AgentDefinition => ({
63
63
  config: {
64
64
  resourceId,
65
65
  name: `Agent ${resourceId}`,
66
66
  description: `Test agent ${resourceId}`,
67
67
  version: '1.0.0',
68
- type: 'agent',
69
- status,
70
- systemPrompt: 'You are a test agent'
68
+ type: 'agent',
69
+ status,
70
+ systemPrompt: 'You are a test agent'
71
71
  },
72
72
  contract: {
73
73
  inputSchema: z.object({ query: z.string() }),
@@ -87,13 +87,13 @@ describe('ResourceRegistry Integration', () => {
87
87
  */
88
88
  const createTestOrganization = (): DeploymentSpec => {
89
89
  const workflows = [
90
- createMockWorkflow('order-workflow', 'prod'),
91
- createMockWorkflow('support-workflow', 'dev')
90
+ createMockWorkflow('order-workflow', 'prod'),
91
+ createMockWorkflow('support-workflow', 'dev')
92
92
  ]
93
93
 
94
94
  const agents = [
95
- createMockAgent('order-agent', 'prod'),
96
- createMockAgent('support-agent', 'dev')
95
+ createMockAgent('order-agent', 'prod'),
96
+ createMockAgent('support-agent', 'dev')
97
97
  ]
98
98
 
99
99
  const triggers: TriggerDefinition[] = [
@@ -105,7 +105,7 @@ describe('ResourceRegistry Integration', () => {
105
105
  name: 'Order Webhook',
106
106
  description: 'Webhook from Shopify on new orders',
107
107
  status: 'prod',
108
- webhookPath: '/webhooks/shopify/orders'
108
+ webhookPath: '/webhooks/shopify/orders'
109
109
  },
110
110
  {
111
111
  resourceId: 'trigger-schedule-support',
@@ -114,8 +114,8 @@ describe('ResourceRegistry Integration', () => {
114
114
  version: '1.0.0',
115
115
  name: 'Support Ticket Check',
116
116
  description: 'Check for new support tickets every hour',
117
- status: 'dev',
118
- schedule: '0 * * * *'
117
+ status: 'dev',
118
+ schedule: '0 * * * *'
119
119
  },
120
120
  {
121
121
  resourceId: 'trigger-manual-test',
@@ -136,8 +136,8 @@ describe('ResourceRegistry Integration', () => {
136
136
  status: 'prod',
137
137
  provider: 'shopify',
138
138
  credentialName: 'shopify-prod',
139
- name: 'Shopify Production',
140
- description: 'E-commerce platform'
139
+ name: 'Shopify Production',
140
+ description: 'E-commerce platform'
141
141
  },
142
142
  {
143
143
  resourceId: 'integration-zendesk',
@@ -146,8 +146,8 @@ describe('ResourceRegistry Integration', () => {
146
146
  status: 'dev',
147
147
  provider: 'zendesk',
148
148
  credentialName: 'zendesk-dev',
149
- name: 'Zendesk Support',
150
- description: 'Support ticket system'
149
+ name: 'Zendesk Support',
150
+ description: 'Support ticket system'
151
151
  }
152
152
  ]
153
153
 
@@ -187,7 +187,7 @@ describe('ResourceRegistry Integration', () => {
187
187
  description: 'Approve orders over $10,000',
188
188
  status: 'prod',
189
189
  requestedBy: { agents: ['order-agent'] },
190
- routesTo: { workflows: ['order-workflow'] }
190
+ routesTo: { workflows: ['order-workflow'] }
191
191
  },
192
192
  {
193
193
  resourceId: 'approval-escalation',
@@ -1,245 +1,245 @@
1
- /**
2
- * Regression tests for resource-registry nested-systems lookup (Wave 1 hotfix).
3
- *
4
- * Before the fix, `listResourcesForOrganization` built the systems map with
5
- * `Object.values(org.systems)`, which only surfaced top-level entries. Systems
6
- * declared as children under `system.subsystems` were invisible, so
7
- * `summarizeSystem` always returned `undefined` for nested paths.
8
- *
9
- * After the fix, the map is built via `listAllSystems` (DFS), which walks the
10
- * full tree and keys every entry by its dot-joined path.
11
- */
12
- import { describe, it, expect } from 'vitest'
13
- import { z } from 'zod'
14
- import { ResourceRegistry } from '../resource-registry'
15
- import type { SystemEntry } from '../../../organization-model/domains/systems'
16
- import type { ResourceEntry } from '../../../organization-model/domains/resources'
17
- import type { WorkflowDefinition } from '../../../execution/engine/workflow/types'
18
-
19
- // ---------------------------------------------------------------------------
20
- // Minimal fixture helpers
21
- // ---------------------------------------------------------------------------
22
-
23
- function makeWorkflow(resourceId: string, resource?: ResourceEntry): WorkflowDefinition {
24
- return {
25
- config: {
26
- resourceId,
27
- name: `Workflow ${resourceId}`,
28
- description: `Test workflow ${resourceId}`,
29
- version: '1.0.0',
30
- type: 'workflow',
31
- status: 'prod',
32
- resource
33
- },
34
- contract: {
35
- inputSchema: z.object({ input: z.string() }),
36
- outputSchema: z.object({ output: z.string() })
37
- },
38
- steps: {
39
- step1: {
40
- id: 'step1',
41
- name: 'Step 1',
42
- description: 'Only step',
43
- handler: async () => ({ output: 'ok' }),
44
- inputSchema: z.object({ input: z.string() }),
45
- outputSchema: z.object({ output: z.string() }),
46
- next: null
47
- }
48
- },
49
- entryPoint: 'step1'
50
- }
51
- }
52
-
53
- // ---------------------------------------------------------------------------
54
- // Fixture: two-level system tree
55
- //
56
- // systems
57
- // └── acquisition (top-level, id: 'acquisition')
58
- // └── subsystems
59
- // └── outbound (nested, id: 'outbound') ← formerly invisible
60
- // ---------------------------------------------------------------------------
61
-
62
- const topLevelSystem: SystemEntry = {
63
- id: 'acquisition',
64
- label: 'Acquisition',
65
- description: 'Top-level acquisition system.',
66
- kind: 'operational',
67
- governedByKnowledge: [],
68
- drivesGoals: [],
69
- lifecycle: 'active',
70
- order: 10
71
- }
72
-
73
- const nestedSystem: SystemEntry = {
74
- id: 'outbound',
75
- label: 'Outbound',
76
- description: 'Outbound automation sub-system.',
77
- kind: 'operational',
78
- governedByKnowledge: [],
79
- drivesGoals: [],
80
- lifecycle: 'active',
81
- order: 10
82
- }
83
-
84
- /** Dot-joined path for the nested system as it appears in resource.systemPath */
85
- const NESTED_SYSTEM_PATH = 'acquisition.outbound'
86
-
87
- const topLevelSystemWithChildren: SystemEntry = {
88
- ...topLevelSystem,
89
- subsystems: {
90
- outbound: nestedSystem
91
- }
92
- }
93
-
94
- const nestedSystemResource: ResourceEntry = {
95
- id: 'cold-outreach-workflow',
96
- kind: 'workflow',
97
- systemPath: NESTED_SYSTEM_PATH,
98
- status: 'active',
99
- order: 10
100
- }
101
-
102
- // ---------------------------------------------------------------------------
103
- // Tests
104
- // ---------------------------------------------------------------------------
105
-
106
- describe('ResourceRegistry — nested-systems lookup regression', () => {
107
- it('resolves system metadata for a TOP-LEVEL system path', () => {
108
- const topResource: ResourceEntry = {
109
- id: 'top-workflow',
110
- kind: 'workflow',
111
- systemPath: 'acquisition',
112
- status: 'active',
113
- order: 10
114
- }
115
- const workflow = makeWorkflow('top-workflow', topResource)
116
-
117
- const registry = new ResourceRegistry({
118
- 'test-org': {
119
- version: '1.0.0',
120
- organizationModel: {
121
- systems: { acquisition: topLevelSystemWithChildren },
122
- resources: { 'top-workflow': topResource }
123
- },
124
- workflows: [workflow]
125
- }
126
- })
127
-
128
- const result = registry.listResourcesForOrganization('test-org')
129
-
130
- expect(result.workflows).toHaveLength(1)
131
- expect(result.workflows[0].system).toBeDefined()
132
- expect(result.workflows[0].system).toMatchObject({
133
- id: 'acquisition',
134
- title: 'Acquisition',
135
- kind: 'operational',
136
- lifecycle: 'active'
137
- })
138
- expect(result.workflows[0].systemPath).toBe('acquisition')
139
- })
140
-
141
- it('resolves system metadata for a NESTED system path (the regression case)', () => {
142
- const workflow = makeWorkflow('cold-outreach-workflow', nestedSystemResource)
143
-
144
- const registry = new ResourceRegistry({
145
- 'test-org': {
146
- version: '1.0.0',
147
- organizationModel: {
148
- // The nested system lives under acquisition.subsystems, NOT as a top-level key.
149
- // Before the fix, Object.values(systems) missed this entirely.
150
- systems: { acquisition: topLevelSystemWithChildren },
151
- resources: { 'cold-outreach-workflow': nestedSystemResource }
152
- },
153
- workflows: [workflow]
154
- }
155
- })
156
-
157
- const result = registry.listResourcesForOrganization('test-org')
158
-
159
- expect(result.workflows).toHaveLength(1)
160
- // Before the fix this was undefined; it must now be defined.
161
- expect(result.workflows[0].system).toBeDefined()
162
- expect(result.workflows[0].system).toMatchObject({
163
- id: 'outbound',
164
- title: 'Outbound',
165
- kind: 'operational',
166
- lifecycle: 'active'
167
- })
168
- expect(result.workflows[0].systemPath).toBe(NESTED_SYSTEM_PATH)
169
- expect(result.workflows[0].governanceStatus).toBe('active')
170
- })
171
-
172
- it('resolves system metadata for a THREE-level nested path', () => {
173
- const deepSystem: SystemEntry = {
174
- id: 'sequences',
175
- label: 'Sequences',
176
- description: 'Email sequence sub-sub-system.',
177
- kind: 'operational',
178
- governedByKnowledge: [],
179
- drivesGoals: [],
180
- lifecycle: 'active',
181
- order: 10
182
- }
183
-
184
- const outboundWithChildren: SystemEntry = {
185
- ...nestedSystem,
186
- subsystems: { sequences: deepSystem }
187
- }
188
-
189
- const topWithDeepNesting: SystemEntry = {
190
- ...topLevelSystem,
191
- subsystems: { outbound: outboundWithChildren }
192
- }
193
-
194
- const deepResource: ResourceEntry = {
195
- id: 'sequence-enroller',
196
- kind: 'workflow',
197
- systemPath: 'acquisition.outbound.sequences',
198
- status: 'active',
199
- order: 10
200
- }
201
-
202
- const workflow = makeWorkflow('sequence-enroller', deepResource)
203
-
204
- const registry = new ResourceRegistry({
205
- 'test-org': {
206
- version: '1.0.0',
207
- organizationModel: {
208
- systems: { acquisition: topWithDeepNesting },
209
- resources: { 'sequence-enroller': deepResource }
210
- },
211
- workflows: [workflow]
212
- }
213
- })
214
-
215
- const result = registry.listResourcesForOrganization('test-org')
216
-
217
- expect(result.workflows).toHaveLength(1)
218
- expect(result.workflows[0].system).toBeDefined()
219
- expect(result.workflows[0].system).toMatchObject({
220
- id: 'sequences',
221
- title: 'Sequences',
222
- lifecycle: 'active'
223
- })
224
- expect(result.workflows[0].systemPath).toBe('acquisition.outbound.sequences')
225
- })
226
-
227
- it('returns undefined system when the workflow has no resource descriptor and no OM entry', () => {
228
- // A workflow with no OM resource descriptor and no organizationModel at all
229
- // should leave system undefined (no governance metadata attached).
230
- const workflow = makeWorkflow('bare-workflow')
231
-
232
- const registry = new ResourceRegistry({
233
- 'test-org': {
234
- version: '1.0.0',
235
- workflows: [workflow]
236
- }
237
- })
238
-
239
- const result = registry.listResourcesForOrganization('test-org')
240
-
241
- expect(result.workflows).toHaveLength(1)
242
- expect(result.workflows[0].system).toBeUndefined()
243
- expect(result.workflows[0].systemPath).toBeUndefined()
244
- })
245
- })
1
+ /**
2
+ * Regression tests for resource-registry nested-systems lookup (Wave 1 hotfix).
3
+ *
4
+ * Before the fix, `listResourcesForOrganization` built the systems map with
5
+ * `Object.values(org.systems)`, which only surfaced top-level entries. Systems
6
+ * declared as children under `system.subsystems` were invisible, so
7
+ * `summarizeSystem` always returned `undefined` for nested paths.
8
+ *
9
+ * After the fix, the map is built via `listAllSystems` (DFS), which walks the
10
+ * full tree and keys every entry by its dot-joined path.
11
+ */
12
+ import { describe, it, expect } from 'vitest'
13
+ import { z } from 'zod'
14
+ import { ResourceRegistry } from '../resource-registry'
15
+ import type { SystemEntry } from '../../../organization-model/domains/systems'
16
+ import type { ResourceEntry } from '../../../organization-model/domains/resources'
17
+ import type { WorkflowDefinition } from '../../../execution/engine/workflow/types'
18
+
19
+ // ---------------------------------------------------------------------------
20
+ // Minimal fixture helpers
21
+ // ---------------------------------------------------------------------------
22
+
23
+ function makeWorkflow(resourceId: string, resource?: ResourceEntry): WorkflowDefinition {
24
+ return {
25
+ config: {
26
+ resourceId,
27
+ name: `Workflow ${resourceId}`,
28
+ description: `Test workflow ${resourceId}`,
29
+ version: '1.0.0',
30
+ type: 'workflow',
31
+ status: 'prod',
32
+ resource
33
+ },
34
+ contract: {
35
+ inputSchema: z.object({ input: z.string() }),
36
+ outputSchema: z.object({ output: z.string() })
37
+ },
38
+ steps: {
39
+ step1: {
40
+ id: 'step1',
41
+ name: 'Step 1',
42
+ description: 'Only step',
43
+ handler: async () => ({ output: 'ok' }),
44
+ inputSchema: z.object({ input: z.string() }),
45
+ outputSchema: z.object({ output: z.string() }),
46
+ next: null
47
+ }
48
+ },
49
+ entryPoint: 'step1'
50
+ }
51
+ }
52
+
53
+ // ---------------------------------------------------------------------------
54
+ // Fixture: two-level system tree
55
+ //
56
+ // systems
57
+ // └── acquisition (top-level, id: 'acquisition')
58
+ // └── subsystems
59
+ // └── outbound (nested, id: 'outbound') ← formerly invisible
60
+ // ---------------------------------------------------------------------------
61
+
62
+ const topLevelSystem: SystemEntry = {
63
+ id: 'acquisition',
64
+ label: 'Acquisition',
65
+ description: 'Top-level acquisition system.',
66
+ kind: 'operational',
67
+ governedByKnowledge: [],
68
+ drivesGoals: [],
69
+ lifecycle: 'active',
70
+ order: 10
71
+ }
72
+
73
+ const nestedSystem: SystemEntry = {
74
+ id: 'outbound',
75
+ label: 'Outbound',
76
+ description: 'Outbound automation sub-system.',
77
+ kind: 'operational',
78
+ governedByKnowledge: [],
79
+ drivesGoals: [],
80
+ lifecycle: 'active',
81
+ order: 10
82
+ }
83
+
84
+ /** Dot-joined path for the nested system as it appears in resource.systemPath */
85
+ const NESTED_SYSTEM_PATH = 'acquisition.outbound'
86
+
87
+ const topLevelSystemWithChildren: SystemEntry = {
88
+ ...topLevelSystem,
89
+ subsystems: {
90
+ outbound: nestedSystem
91
+ }
92
+ }
93
+
94
+ const nestedSystemResource: ResourceEntry = {
95
+ id: 'cold-outreach-workflow',
96
+ kind: 'workflow',
97
+ systemPath: NESTED_SYSTEM_PATH,
98
+ status: 'active',
99
+ order: 10
100
+ }
101
+
102
+ // ---------------------------------------------------------------------------
103
+ // Tests
104
+ // ---------------------------------------------------------------------------
105
+
106
+ describe('ResourceRegistry — nested-systems lookup regression', () => {
107
+ it('resolves system metadata for a TOP-LEVEL system path', () => {
108
+ const topResource: ResourceEntry = {
109
+ id: 'top-workflow',
110
+ kind: 'workflow',
111
+ systemPath: 'acquisition',
112
+ status: 'active',
113
+ order: 10
114
+ }
115
+ const workflow = makeWorkflow('top-workflow', topResource)
116
+
117
+ const registry = new ResourceRegistry({
118
+ 'test-org': {
119
+ version: '1.0.0',
120
+ organizationModel: {
121
+ systems: { acquisition: topLevelSystemWithChildren },
122
+ resources: { 'top-workflow': topResource }
123
+ },
124
+ workflows: [workflow]
125
+ }
126
+ })
127
+
128
+ const result = registry.listResourcesForOrganization('test-org')
129
+
130
+ expect(result.workflows).toHaveLength(1)
131
+ expect(result.workflows[0].system).toBeDefined()
132
+ expect(result.workflows[0].system).toMatchObject({
133
+ id: 'acquisition',
134
+ title: 'Acquisition',
135
+ kind: 'operational',
136
+ lifecycle: 'active'
137
+ })
138
+ expect(result.workflows[0].systemPath).toBe('acquisition')
139
+ })
140
+
141
+ it('resolves system metadata for a NESTED system path (the regression case)', () => {
142
+ const workflow = makeWorkflow('cold-outreach-workflow', nestedSystemResource)
143
+
144
+ const registry = new ResourceRegistry({
145
+ 'test-org': {
146
+ version: '1.0.0',
147
+ organizationModel: {
148
+ // The nested system lives under acquisition.subsystems, NOT as a top-level key.
149
+ // Before the fix, Object.values(systems) missed this entirely.
150
+ systems: { acquisition: topLevelSystemWithChildren },
151
+ resources: { 'cold-outreach-workflow': nestedSystemResource }
152
+ },
153
+ workflows: [workflow]
154
+ }
155
+ })
156
+
157
+ const result = registry.listResourcesForOrganization('test-org')
158
+
159
+ expect(result.workflows).toHaveLength(1)
160
+ // Before the fix this was undefined; it must now be defined.
161
+ expect(result.workflows[0].system).toBeDefined()
162
+ expect(result.workflows[0].system).toMatchObject({
163
+ id: 'outbound',
164
+ title: 'Outbound',
165
+ kind: 'operational',
166
+ lifecycle: 'active'
167
+ })
168
+ expect(result.workflows[0].systemPath).toBe(NESTED_SYSTEM_PATH)
169
+ expect(result.workflows[0].governanceStatus).toBe('active')
170
+ })
171
+
172
+ it('resolves system metadata for a THREE-level nested path', () => {
173
+ const deepSystem: SystemEntry = {
174
+ id: 'sequences',
175
+ label: 'Sequences',
176
+ description: 'Email sequence sub-sub-system.',
177
+ kind: 'operational',
178
+ governedByKnowledge: [],
179
+ drivesGoals: [],
180
+ lifecycle: 'active',
181
+ order: 10
182
+ }
183
+
184
+ const outboundWithChildren: SystemEntry = {
185
+ ...nestedSystem,
186
+ subsystems: { sequences: deepSystem }
187
+ }
188
+
189
+ const topWithDeepNesting: SystemEntry = {
190
+ ...topLevelSystem,
191
+ subsystems: { outbound: outboundWithChildren }
192
+ }
193
+
194
+ const deepResource: ResourceEntry = {
195
+ id: 'sequence-enroller',
196
+ kind: 'workflow',
197
+ systemPath: 'acquisition.outbound.sequences',
198
+ status: 'active',
199
+ order: 10
200
+ }
201
+
202
+ const workflow = makeWorkflow('sequence-enroller', deepResource)
203
+
204
+ const registry = new ResourceRegistry({
205
+ 'test-org': {
206
+ version: '1.0.0',
207
+ organizationModel: {
208
+ systems: { acquisition: topWithDeepNesting },
209
+ resources: { 'sequence-enroller': deepResource }
210
+ },
211
+ workflows: [workflow]
212
+ }
213
+ })
214
+
215
+ const result = registry.listResourcesForOrganization('test-org')
216
+
217
+ expect(result.workflows).toHaveLength(1)
218
+ expect(result.workflows[0].system).toBeDefined()
219
+ expect(result.workflows[0].system).toMatchObject({
220
+ id: 'sequences',
221
+ title: 'Sequences',
222
+ lifecycle: 'active'
223
+ })
224
+ expect(result.workflows[0].systemPath).toBe('acquisition.outbound.sequences')
225
+ })
226
+
227
+ it('returns undefined system when the workflow has no resource descriptor and no OM entry', () => {
228
+ // A workflow with no OM resource descriptor and no organizationModel at all
229
+ // should leave system undefined (no governance metadata attached).
230
+ const workflow = makeWorkflow('bare-workflow')
231
+
232
+ const registry = new ResourceRegistry({
233
+ 'test-org': {
234
+ version: '1.0.0',
235
+ workflows: [workflow]
236
+ }
237
+ })
238
+
239
+ const result = registry.listResourcesForOrganization('test-org')
240
+
241
+ expect(result.workflows).toHaveLength(1)
242
+ expect(result.workflows[0].system).toBeUndefined()
243
+ expect(result.workflows[0].systemPath).toBeUndefined()
244
+ })
245
+ })