@elevasis/core 0.23.0 → 0.24.0

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 (241) hide show
  1. package/dist/index.d.ts +1326 -552
  2. package/dist/index.js +869 -154
  3. package/dist/knowledge/index.d.ts +487 -209
  4. package/dist/knowledge/index.js +104 -1
  5. package/dist/organization-model/index.d.ts +1326 -552
  6. package/dist/organization-model/index.js +869 -154
  7. package/dist/test-utils/index.d.ts +357 -72
  8. package/dist/test-utils/index.js +795 -142
  9. package/package.json +5 -5
  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 +2102 -2096
  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 +202 -202
  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 +382 -283
  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__/flatten-additive-merge.test.ts +362 -361
  147. package/src/organization-model/__tests__/foundation.test.ts +77 -77
  148. package/src/organization-model/__tests__/get-resources-for-system.test.ts +144 -144
  149. package/src/organization-model/__tests__/graph.test.ts +1246 -887
  150. package/src/organization-model/__tests__/icons.test.ts +10 -1
  151. package/src/organization-model/__tests__/knowledge.test.ts +251 -15
  152. package/src/organization-model/__tests__/lookup-helpers.test.ts +438 -438
  153. package/src/organization-model/__tests__/migration-helpers.test.ts +591 -591
  154. package/src/organization-model/__tests__/prospecting-ssot.test.ts +103 -103
  155. package/src/organization-model/__tests__/recursive-system-schema.test.ts +535 -506
  156. package/src/organization-model/__tests__/resolve.test.ts +274 -164
  157. package/src/organization-model/__tests__/schema.test.ts +834 -301
  158. package/src/organization-model/__tests__/surface-projection.test.ts +284 -284
  159. package/src/organization-model/catalogs/lead-gen.ts +144 -144
  160. package/src/organization-model/content-kinds/config.ts +36 -36
  161. package/src/organization-model/content-kinds/index.ts +76 -72
  162. package/src/organization-model/content-kinds/pipeline.ts +68 -68
  163. package/src/organization-model/content-kinds/registry.ts +44 -44
  164. package/src/organization-model/content-kinds/status.ts +71 -71
  165. package/src/organization-model/content-kinds/template.ts +83 -83
  166. package/src/organization-model/content-kinds/types.ts +117 -117
  167. package/src/organization-model/contracts.ts +27 -27
  168. package/src/organization-model/defaults.ts +40 -50
  169. package/src/organization-model/domains/actions.ts +333 -239
  170. package/src/organization-model/domains/customers.ts +78 -78
  171. package/src/organization-model/domains/entities.ts +144 -144
  172. package/src/organization-model/domains/goals.ts +83 -83
  173. package/src/organization-model/domains/knowledge.ts +117 -101
  174. package/src/organization-model/domains/navigation.ts +139 -139
  175. package/src/organization-model/domains/offerings.ts +71 -71
  176. package/src/organization-model/domains/policies.ts +102 -102
  177. package/src/organization-model/domains/projects.ts +14 -14
  178. package/src/organization-model/domains/prospecting.ts +395 -395
  179. package/src/organization-model/domains/resources.ts +167 -132
  180. package/src/organization-model/domains/roles.ts +96 -96
  181. package/src/organization-model/domains/sales.test.ts +218 -218
  182. package/src/organization-model/domains/sales.ts +380 -380
  183. package/src/organization-model/domains/shared.ts +63 -63
  184. package/src/organization-model/domains/statuses.ts +339 -339
  185. package/src/organization-model/domains/systems.ts +217 -172
  186. package/src/organization-model/foundation.ts +75 -75
  187. package/src/organization-model/graph/build.ts +1016 -888
  188. package/src/organization-model/graph/index.ts +4 -4
  189. package/src/organization-model/graph/link.ts +10 -10
  190. package/src/organization-model/graph/schema.ts +76 -70
  191. package/src/organization-model/graph/types.ts +73 -67
  192. package/src/organization-model/helpers.ts +289 -241
  193. package/src/organization-model/icons.ts +78 -66
  194. package/src/organization-model/index.ts +130 -128
  195. package/src/organization-model/migration-helpers.ts +247 -244
  196. package/src/organization-model/ontology.ts +661 -0
  197. package/src/organization-model/organization-graph.mdx +110 -90
  198. package/src/organization-model/organization-model.mdx +226 -219
  199. package/src/organization-model/published.ts +289 -235
  200. package/src/organization-model/resolve.ts +146 -91
  201. package/src/organization-model/schema.ts +790 -671
  202. package/src/organization-model/surface-projection.ts +212 -212
  203. package/src/organization-model/types.ts +177 -167
  204. package/src/platform/api/types.ts +38 -38
  205. package/src/platform/constants/versions.ts +3 -3
  206. package/src/platform/index.ts +23 -23
  207. package/src/platform/registry/__tests__/command-view.test.ts +10 -10
  208. package/src/platform/registry/__tests__/resource-link.test.ts +35 -35
  209. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +20 -20
  210. package/src/platform/registry/__tests__/resource-registry.nested-systems.test.ts +245 -245
  211. package/src/platform/registry/__tests__/resource-registry.test.ts +2053 -2053
  212. package/src/platform/registry/__tests__/validation.test.ts +1347 -1347
  213. package/src/platform/registry/command-view.ts +10 -10
  214. package/src/platform/registry/index.ts +103 -103
  215. package/src/platform/registry/resource-link.ts +32 -32
  216. package/src/platform/registry/resource-registry.ts +890 -890
  217. package/src/platform/registry/serialization.ts +295 -295
  218. package/src/platform/registry/serialized-types.ts +166 -166
  219. package/src/platform/registry/stats-types.ts +68 -68
  220. package/src/platform/registry/types.ts +425 -425
  221. package/src/platform/registry/validation.ts +745 -745
  222. package/src/platform/utils/__tests__/validation.test.ts +1084 -1084
  223. package/src/platform/utils/validation.ts +425 -425
  224. package/src/projects/api-schemas.test.ts +39 -39
  225. package/src/projects/api-schemas.ts +291 -291
  226. package/src/reference/_generated/contracts.md +2101 -2096
  227. package/src/reference/glossary.md +76 -76
  228. package/src/scaffold-registry/__tests__/index.test.ts +206 -206
  229. package/src/scaffold-registry/__tests__/schema.test.ts +166 -166
  230. package/src/scaffold-registry/index.ts +392 -392
  231. package/src/scaffold-registry/schema.ts +243 -243
  232. package/src/server.ts +289 -289
  233. package/src/supabase/database.types.ts +3153 -3153
  234. package/src/test-utils/README.md +37 -37
  235. package/src/test-utils/entities.ts +108 -108
  236. package/src/test-utils/fixtures/memberships.ts +82 -82
  237. package/src/test-utils/index.ts +12 -12
  238. package/src/test-utils/organization-model.ts +65 -65
  239. package/src/test-utils/published.ts +6 -6
  240. package/src/test-utils/rls/RLSTestContext.ts +588 -588
  241. package/src/test-utils/test-utils.test.ts +44 -44
@@ -0,0 +1,661 @@
1
+ import { z } from 'zod'
2
+
3
+ export const OntologyKindSchema = z.enum([
4
+ 'object',
5
+ 'link',
6
+ 'action',
7
+ 'catalog',
8
+ 'event',
9
+ 'interface',
10
+ 'value-type',
11
+ 'property',
12
+ 'group',
13
+ 'surface'
14
+ ])
15
+
16
+ export type OntologyKind = z.infer<typeof OntologyKindSchema>
17
+
18
+ const SYSTEM_PATH_PATTERN = '[a-z0-9][a-z0-9-]*(?:\\.[a-z0-9][a-z0-9-]*)*'
19
+ const LOCAL_ID_PATTERN = '[a-z0-9][a-z0-9._-]*'
20
+ const ONTOLOGY_ID_PATTERN = `^(global|${SYSTEM_PATH_PATTERN}):(${OntologyKindSchema.options.join('|')})\\/(${LOCAL_ID_PATTERN})$`
21
+ const ONTOLOGY_ID_REGEX = new RegExp(ONTOLOGY_ID_PATTERN)
22
+
23
+ export const OntologyIdSchema = z
24
+ .string()
25
+ .trim()
26
+ .min(1)
27
+ .max(300)
28
+ .regex(
29
+ ONTOLOGY_ID_REGEX,
30
+ 'Ontology IDs must use <system-path>:<kind>/<local-id> or global:<kind>/<local-id>'
31
+ )
32
+
33
+ export type OntologyId = z.infer<typeof OntologyIdSchema>
34
+
35
+ export type ParsedOntologyId = {
36
+ id: OntologyId
37
+ scope: string
38
+ kind: OntologyKind
39
+ localId: string
40
+ isGlobal: boolean
41
+ }
42
+
43
+ export function parseOntologyId(id: string): ParsedOntologyId {
44
+ const normalized = OntologyIdSchema.parse(id)
45
+ const match = ONTOLOGY_ID_REGEX.exec(normalized)
46
+ if (match === null) {
47
+ throw new Error(`Invalid ontology ID "${id}"`)
48
+ }
49
+
50
+ return {
51
+ id: normalized,
52
+ scope: match[1],
53
+ kind: match[2] as OntologyKind,
54
+ localId: match[3],
55
+ isGlobal: match[1] === 'global'
56
+ }
57
+ }
58
+
59
+ export function formatOntologyId(input: {
60
+ scope: string
61
+ kind: OntologyKind
62
+ localId: string
63
+ }): OntologyId {
64
+ return OntologyIdSchema.parse(`${input.scope}:${input.kind}/${input.localId}`)
65
+ }
66
+
67
+ const OntologyReferenceListSchema = z.array(OntologyIdSchema).default([]).optional()
68
+
69
+ const OntologyRecordBaseSchema = z
70
+ .object({
71
+ id: OntologyIdSchema,
72
+ label: z.string().trim().min(1).max(160).optional(),
73
+ description: z.string().trim().min(1).max(2000).optional(),
74
+ ownerSystemId: z.string().trim().min(1).max(200).optional(),
75
+ aliases: z.array(OntologyIdSchema).optional()
76
+ })
77
+ .passthrough()
78
+
79
+ export const OntologyObjectTypeSchema = OntologyRecordBaseSchema.extend({
80
+ properties: z.record(z.string().trim().min(1).max(200), z.unknown()).optional(),
81
+ storage: z.record(z.string(), z.unknown()).optional()
82
+ })
83
+
84
+ export const OntologyLinkTypeSchema = OntologyRecordBaseSchema.extend({
85
+ from: OntologyIdSchema,
86
+ to: OntologyIdSchema,
87
+ cardinality: z.string().trim().min(1).max(80).optional(),
88
+ via: z.string().trim().min(1).max(255).optional()
89
+ })
90
+
91
+ export const OntologyActionTypeSchema = OntologyRecordBaseSchema.extend({
92
+ actsOn: OntologyReferenceListSchema,
93
+ input: z.record(z.string().trim().min(1).max(200), z.unknown()).optional(),
94
+ effects: z.array(z.record(z.string(), z.unknown())).optional()
95
+ })
96
+
97
+ export const OntologyCatalogTypeSchema = OntologyRecordBaseSchema.extend({
98
+ kind: z.string().trim().min(1).max(120).optional(),
99
+ appliesTo: OntologyIdSchema.optional(),
100
+ entries: z.record(z.string().trim().min(1).max(200), z.unknown()).optional()
101
+ })
102
+
103
+ export const OntologyEventTypeSchema = OntologyRecordBaseSchema.extend({
104
+ payload: z.record(z.string().trim().min(1).max(200), z.unknown()).optional()
105
+ })
106
+
107
+ export const OntologyInterfaceTypeSchema = OntologyRecordBaseSchema.extend({
108
+ properties: z.record(z.string().trim().min(1).max(200), z.unknown()).optional()
109
+ })
110
+
111
+ export const OntologyValueTypeSchema = OntologyRecordBaseSchema.extend({
112
+ primitive: z.string().trim().min(1).max(120).optional()
113
+ })
114
+
115
+ export const OntologySharedPropertySchema = OntologyRecordBaseSchema.extend({
116
+ valueType: OntologyIdSchema.optional(),
117
+ searchable: z.boolean().optional(),
118
+ pii: z.boolean().optional()
119
+ })
120
+
121
+ export const OntologyGroupSchema = OntologyRecordBaseSchema.extend({
122
+ members: OntologyReferenceListSchema
123
+ })
124
+
125
+ export const OntologySurfaceTypeSchema = OntologyRecordBaseSchema.extend({
126
+ route: z.string().trim().min(1).max(500).optional()
127
+ })
128
+
129
+ export const OntologyScopeSchema = z
130
+ .object({
131
+ objectTypes: z.record(OntologyIdSchema, OntologyObjectTypeSchema).default({}).optional(),
132
+ linkTypes: z.record(OntologyIdSchema, OntologyLinkTypeSchema).default({}).optional(),
133
+ actionTypes: z.record(OntologyIdSchema, OntologyActionTypeSchema).default({}).optional(),
134
+ catalogTypes: z.record(OntologyIdSchema, OntologyCatalogTypeSchema).default({}).optional(),
135
+ eventTypes: z.record(OntologyIdSchema, OntologyEventTypeSchema).default({}).optional(),
136
+ interfaceTypes: z.record(OntologyIdSchema, OntologyInterfaceTypeSchema).default({}).optional(),
137
+ valueTypes: z.record(OntologyIdSchema, OntologyValueTypeSchema).default({}).optional(),
138
+ sharedProperties: z.record(OntologyIdSchema, OntologySharedPropertySchema).default({}).optional(),
139
+ groups: z.record(OntologyIdSchema, OntologyGroupSchema).default({}).optional(),
140
+ surfaces: z.record(OntologyIdSchema, OntologySurfaceTypeSchema).default({}).optional()
141
+ })
142
+ .default({})
143
+
144
+ export const DEFAULT_ONTOLOGY_SCOPE: OntologyScope = {
145
+ valueTypes: {
146
+ 'global:value-type/uuid': {
147
+ id: 'global:value-type/uuid',
148
+ label: 'UUID',
149
+ primitive: 'string'
150
+ },
151
+ 'global:value-type/text': {
152
+ id: 'global:value-type/text',
153
+ label: 'Text',
154
+ primitive: 'string'
155
+ },
156
+ 'global:value-type/url': {
157
+ id: 'global:value-type/url',
158
+ label: 'URL',
159
+ primitive: 'string'
160
+ },
161
+ 'global:value-type/email': {
162
+ id: 'global:value-type/email',
163
+ label: 'Email',
164
+ primitive: 'string'
165
+ }
166
+ }
167
+ }
168
+
169
+ export type OntologyObjectType = z.infer<typeof OntologyObjectTypeSchema>
170
+ export type OntologyLinkType = z.infer<typeof OntologyLinkTypeSchema>
171
+ export type OntologyActionType = z.infer<typeof OntologyActionTypeSchema>
172
+ export type OntologyCatalogType = z.infer<typeof OntologyCatalogTypeSchema>
173
+ export type OntologyEventType = z.infer<typeof OntologyEventTypeSchema>
174
+ export type OntologyInterfaceType = z.infer<typeof OntologyInterfaceTypeSchema>
175
+ export type OntologyValueType = z.infer<typeof OntologyValueTypeSchema>
176
+ export type OntologySharedProperty = z.infer<typeof OntologySharedPropertySchema>
177
+ export type OntologyGroup = z.infer<typeof OntologyGroupSchema>
178
+ export type OntologySurfaceType = z.infer<typeof OntologySurfaceTypeSchema>
179
+ export type OntologyScope = z.infer<typeof OntologyScopeSchema>
180
+
181
+ export type ResolvedOntologyIndex = {
182
+ objectTypes: Record<OntologyId, ResolvedOntologyRecord<OntologyObjectType>>
183
+ linkTypes: Record<OntologyId, ResolvedOntologyRecord<OntologyLinkType>>
184
+ actionTypes: Record<OntologyId, ResolvedOntologyRecord<OntologyActionType>>
185
+ catalogTypes: Record<OntologyId, ResolvedOntologyRecord<OntologyCatalogType>>
186
+ eventTypes: Record<OntologyId, ResolvedOntologyRecord<OntologyEventType>>
187
+ interfaceTypes: Record<OntologyId, ResolvedOntologyRecord<OntologyInterfaceType>>
188
+ valueTypes: Record<OntologyId, ResolvedOntologyRecord<OntologyValueType>>
189
+ sharedProperties: Record<OntologyId, ResolvedOntologyRecord<OntologySharedProperty>>
190
+ groups: Record<OntologyId, ResolvedOntologyRecord<OntologyGroup>>
191
+ surfaces: Record<OntologyId, ResolvedOntologyRecord<OntologySurfaceType>>
192
+ }
193
+
194
+ export type OntologyRecordOrigin = {
195
+ kind: 'authored' | 'projected'
196
+ source: string
197
+ path: Array<string | number>
198
+ systemPath?: string
199
+ legacyId?: string
200
+ }
201
+
202
+ export type ResolvedOntologyRecord<TRecord> = TRecord & { origin: OntologyRecordOrigin }
203
+
204
+ export type OntologyDiagnostic = {
205
+ code: 'duplicate_ontology_id' | 'invalid_ontology_id' | 'ontology_kind_mismatch'
206
+ message: string
207
+ id: string
208
+ path: Array<string | number>
209
+ source: string
210
+ origin: OntologyRecordOrigin
211
+ existingSource?: string
212
+ existingOrigin?: OntologyRecordOrigin
213
+ }
214
+
215
+ export type OntologyCompilation = {
216
+ ontology: ResolvedOntologyIndex
217
+ diagnostics: OntologyDiagnostic[]
218
+ }
219
+
220
+ export type ResolvedOntologyRecordEntry = {
221
+ id: OntologyId
222
+ kind: OntologyKind
223
+ record: ResolvedOntologyRecord<
224
+ | OntologyObjectType
225
+ | OntologyLinkType
226
+ | OntologyActionType
227
+ | OntologyCatalogType
228
+ | OntologyEventType
229
+ | OntologyInterfaceType
230
+ | OntologyValueType
231
+ | OntologySharedProperty
232
+ | OntologyGroup
233
+ | OntologySurfaceType
234
+ >
235
+ }
236
+
237
+ type ScopeKey = keyof ResolvedOntologyIndex
238
+
239
+ const SCOPE_KIND: Record<ScopeKey, OntologyKind> = {
240
+ objectTypes: 'object',
241
+ linkTypes: 'link',
242
+ actionTypes: 'action',
243
+ catalogTypes: 'catalog',
244
+ eventTypes: 'event',
245
+ interfaceTypes: 'interface',
246
+ valueTypes: 'value-type',
247
+ sharedProperties: 'property',
248
+ groups: 'group',
249
+ surfaces: 'surface'
250
+ }
251
+
252
+ const SCOPE_KEYS = Object.keys(SCOPE_KIND) as ScopeKey[]
253
+
254
+ export function ontologyGraphNodeId(id: OntologyId | string): string {
255
+ return `ontology:${OntologyIdSchema.parse(id)}`
256
+ }
257
+
258
+ export function ontologyIdFromGraphNodeId(nodeId: string): OntologyId | undefined {
259
+ if (!nodeId.startsWith('ontology:')) return undefined
260
+
261
+ const result = OntologyIdSchema.safeParse(nodeId.slice('ontology:'.length))
262
+ return result.success ? result.data : undefined
263
+ }
264
+
265
+ export function isOntologyGraphNodeId(nodeId: string): boolean {
266
+ return ontologyIdFromGraphNodeId(nodeId) !== undefined
267
+ }
268
+
269
+ export function listResolvedOntologyRecords(index: ResolvedOntologyIndex): ResolvedOntologyRecordEntry[] {
270
+ return SCOPE_KEYS.flatMap((scopeKey) => {
271
+ const kind = SCOPE_KIND[scopeKey]
272
+ return Object.entries(index[scopeKey])
273
+ .sort(([leftId], [rightId]) => leftId.localeCompare(rightId))
274
+ .map(([id, record]) => ({
275
+ id: id as OntologyId,
276
+ kind,
277
+ record
278
+ }))
279
+ })
280
+ }
281
+
282
+ type ModelLike = {
283
+ ontology?: OntologyScope
284
+ systems?: Record<string, SystemLike>
285
+ entities?: Record<string, EntityLike>
286
+ actions?: Record<string, ActionLike>
287
+ }
288
+
289
+ type SystemLike = {
290
+ id: string
291
+ label?: string
292
+ title?: string
293
+ description?: string
294
+ ontology?: OntologyScope
295
+ content?: Record<string, ContentLike>
296
+ systems?: Record<string, SystemLike>
297
+ subsystems?: Record<string, SystemLike>
298
+ }
299
+
300
+ type EntityLike = {
301
+ id: string
302
+ label: string
303
+ description?: string
304
+ ownedBySystemId: string
305
+ table?: string
306
+ rowSchema?: string
307
+ stateCatalogId?: string
308
+ links?: Array<{ toEntity: string; kind: string; via?: string; label?: string }>
309
+ }
310
+
311
+ type ActionLike = {
312
+ id: string
313
+ label: string
314
+ description?: string
315
+ resourceId?: string
316
+ scope?: 'global' | { domain: string }
317
+ affects?: string[]
318
+ invocations?: unknown[]
319
+ lifecycle?: string
320
+ }
321
+
322
+ type ContentLike = {
323
+ kind: string
324
+ type: string
325
+ label?: string
326
+ description?: string
327
+ parentContentId?: string
328
+ data?: Record<string, unknown>
329
+ }
330
+
331
+ type SourceContext = {
332
+ source: string
333
+ path: Array<string | number>
334
+ kind: 'authored' | 'projected'
335
+ systemPath?: string
336
+ legacyId?: string
337
+ }
338
+
339
+ function originFromContext(context: SourceContext): OntologyRecordOrigin {
340
+ return {
341
+ kind: context.kind,
342
+ source: context.source,
343
+ path: context.path,
344
+ ...(context.systemPath !== undefined ? { systemPath: context.systemPath } : {}),
345
+ ...(context.legacyId !== undefined ? { legacyId: context.legacyId } : {})
346
+ }
347
+ }
348
+
349
+ function createEmptyIndex(): ResolvedOntologyIndex {
350
+ return {
351
+ objectTypes: {},
352
+ linkTypes: {},
353
+ actionTypes: {},
354
+ catalogTypes: {},
355
+ eventTypes: {},
356
+ interfaceTypes: {},
357
+ valueTypes: {},
358
+ sharedProperties: {},
359
+ groups: {},
360
+ surfaces: {}
361
+ }
362
+ }
363
+
364
+ function sortResolvedOntologyIndex(index: ResolvedOntologyIndex): ResolvedOntologyIndex {
365
+ const sorted = createEmptyIndex()
366
+
367
+ for (const scopeKey of SCOPE_KEYS) {
368
+ const target = sorted[scopeKey] as Record<string, unknown>
369
+ for (const [id, record] of Object.entries(index[scopeKey]).sort(([leftId], [rightId]) =>
370
+ leftId.localeCompare(rightId)
371
+ )) {
372
+ target[id] = record
373
+ }
374
+ }
375
+
376
+ return sorted
377
+ }
378
+
379
+ function childSystemsOf(system: SystemLike): Record<string, SystemLike> {
380
+ return system.systems ?? system.subsystems ?? {}
381
+ }
382
+
383
+ function addRecord<TRecord extends { id: string }>(
384
+ index: ResolvedOntologyIndex,
385
+ diagnostics: OntologyDiagnostic[],
386
+ sourcesById: Map<string, SourceContext>,
387
+ scopeKey: ScopeKey,
388
+ record: TRecord,
389
+ context: SourceContext
390
+ ): void {
391
+ let parsed: ParsedOntologyId
392
+ try {
393
+ parsed = parseOntologyId(record.id)
394
+ } catch {
395
+ diagnostics.push({
396
+ code: 'invalid_ontology_id',
397
+ message: `Invalid ontology ID "${record.id}" from ${context.source} at ${context.path.join('.')}`,
398
+ id: record.id,
399
+ path: context.path,
400
+ source: context.source,
401
+ origin: originFromContext(context)
402
+ })
403
+ return
404
+ }
405
+
406
+ const expectedKind = SCOPE_KIND[scopeKey]
407
+ if (parsed.kind !== expectedKind) {
408
+ diagnostics.push({
409
+ code: 'ontology_kind_mismatch',
410
+ message: `Ontology ID "${record.id}" has kind "${parsed.kind}" but was authored in ${scopeKey} (${expectedKind}) at ${context.path.join('.')}`,
411
+ id: record.id,
412
+ path: context.path,
413
+ source: context.source,
414
+ origin: originFromContext(context)
415
+ })
416
+ return
417
+ }
418
+
419
+ const existing = sourcesById.get(parsed.id)
420
+ if (existing !== undefined) {
421
+ diagnostics.push({
422
+ code: 'duplicate_ontology_id',
423
+ message: `Duplicate ontology ID "${parsed.id}" from ${context.source} at ${context.path.join('.')} conflicts with ${existing.source} at ${existing.path.join('.')}`,
424
+ id: parsed.id,
425
+ path: context.path,
426
+ source: context.source,
427
+ origin: originFromContext(context),
428
+ existingSource: existing.source,
429
+ existingOrigin: originFromContext(existing)
430
+ })
431
+ return
432
+ }
433
+
434
+ sourcesById.set(parsed.id, context)
435
+ ;(index[scopeKey] as Record<string, ResolvedOntologyRecord<TRecord>>)[parsed.id] = {
436
+ ...record,
437
+ origin: originFromContext(context)
438
+ }
439
+ }
440
+
441
+ function addScope(
442
+ index: ResolvedOntologyIndex,
443
+ diagnostics: OntologyDiagnostic[],
444
+ sourcesById: Map<string, SourceContext>,
445
+ scope: OntologyScope | undefined,
446
+ source: string,
447
+ path: Array<string | number>
448
+ ): void {
449
+ if (scope === undefined) return
450
+
451
+ for (const scopeKey of SCOPE_KEYS) {
452
+ const records = scope[scopeKey] ?? {}
453
+ for (const [key, record] of Object.entries(records)) {
454
+ addRecord(index, diagnostics, sourcesById, scopeKey, record, {
455
+ source,
456
+ path: [...path, scopeKey, key],
457
+ kind: 'authored',
458
+ systemPath: source.startsWith('system:') ? source.slice('system:'.length, -'.ontology'.length) : undefined
459
+ })
460
+ }
461
+ }
462
+ }
463
+
464
+ function legacyObjectId(entity: EntityLike): OntologyId {
465
+ return formatOntologyId({ scope: entity.ownedBySystemId, kind: 'object', localId: entity.id })
466
+ }
467
+
468
+ function legacyActionOwner(action: ActionLike, entities: Record<string, EntityLike>): string {
469
+ const firstAffectedEntityId = action.affects?.find((entityId) => entities[entityId] !== undefined)
470
+ if (firstAffectedEntityId !== undefined) {
471
+ return entities[firstAffectedEntityId].ownedBySystemId
472
+ }
473
+ if (typeof action.scope === 'object') {
474
+ return action.scope.domain
475
+ }
476
+ return 'global'
477
+ }
478
+
479
+ function addLegacyEntityProjections(
480
+ index: ResolvedOntologyIndex,
481
+ diagnostics: OntologyDiagnostic[],
482
+ sourcesById: Map<string, SourceContext>,
483
+ entities: Record<string, EntityLike>
484
+ ): void {
485
+ for (const entity of Object.values(entities)) {
486
+ const objectType: OntologyObjectType = {
487
+ id: legacyObjectId(entity),
488
+ label: entity.label,
489
+ description: entity.description,
490
+ ownerSystemId: entity.ownedBySystemId,
491
+ ...(entity.table !== undefined
492
+ ? {
493
+ storage: {
494
+ kind: 'table',
495
+ table: entity.table
496
+ }
497
+ }
498
+ : {}),
499
+ legacyEntityId: entity.id,
500
+ ...(entity.rowSchema !== undefined ? { rowSchema: entity.rowSchema } : {}),
501
+ ...(entity.stateCatalogId !== undefined ? { stateCatalogId: entity.stateCatalogId } : {})
502
+ }
503
+
504
+ addRecord(index, diagnostics, sourcesById, 'objectTypes', objectType, {
505
+ source: 'legacy.entities',
506
+ path: ['entities', entity.id],
507
+ kind: 'projected',
508
+ systemPath: entity.ownedBySystemId,
509
+ legacyId: entity.id
510
+ })
511
+
512
+ entity.links?.forEach((link, linkIndex) => {
513
+ const targetEntity = entities[link.toEntity]
514
+ if (targetEntity === undefined) return
515
+
516
+ const linkType: OntologyLinkType = {
517
+ id: formatOntologyId({
518
+ scope: entity.ownedBySystemId,
519
+ kind: 'link',
520
+ localId: `${entity.id}-${link.toEntity}-${linkIndex}`
521
+ }),
522
+ label: link.label ?? link.kind,
523
+ ownerSystemId: entity.ownedBySystemId,
524
+ from: legacyObjectId(entity),
525
+ to: legacyObjectId(targetEntity),
526
+ cardinality: link.kind,
527
+ ...(link.via !== undefined ? { via: link.via } : {}),
528
+ legacyEntityId: entity.id
529
+ }
530
+
531
+ addRecord(index, diagnostics, sourcesById, 'linkTypes', linkType, {
532
+ source: 'legacy.entities.links',
533
+ path: ['entities', entity.id, 'links', linkIndex],
534
+ kind: 'projected',
535
+ systemPath: entity.ownedBySystemId,
536
+ legacyId: `${entity.id}.links.${linkIndex}`
537
+ })
538
+ })
539
+ }
540
+ }
541
+
542
+ function addLegacyActionProjections(
543
+ index: ResolvedOntologyIndex,
544
+ diagnostics: OntologyDiagnostic[],
545
+ sourcesById: Map<string, SourceContext>,
546
+ actions: Record<string, ActionLike>,
547
+ entities: Record<string, EntityLike>
548
+ ): void {
549
+ for (const action of Object.values(actions)) {
550
+ const ownerSystemId = legacyActionOwner(action, entities)
551
+ const actionType: OntologyActionType = {
552
+ id: formatOntologyId({ scope: ownerSystemId, kind: 'action', localId: action.id }),
553
+ label: action.label,
554
+ description: action.description,
555
+ ownerSystemId,
556
+ actsOn: action.affects?.map((entityId) => (entities[entityId] ? legacyObjectId(entities[entityId]) : undefined)).filter((id): id is OntologyId => id !== undefined),
557
+ ...(action.resourceId !== undefined ? { resourceId: action.resourceId } : {}),
558
+ ...(action.invocations !== undefined ? { invocations: action.invocations } : {}),
559
+ ...(action.lifecycle !== undefined ? { lifecycle: action.lifecycle } : {}),
560
+ legacyActionId: action.id
561
+ }
562
+
563
+ addRecord(index, diagnostics, sourcesById, 'actionTypes', actionType, {
564
+ source: 'legacy.actions',
565
+ path: ['actions', action.id],
566
+ kind: 'projected',
567
+ systemPath: ownerSystemId,
568
+ legacyId: action.id
569
+ })
570
+ }
571
+ }
572
+
573
+ function addSystemContentProjections(
574
+ index: ResolvedOntologyIndex,
575
+ diagnostics: OntologyDiagnostic[],
576
+ sourcesById: Map<string, SourceContext>,
577
+ systemPath: string,
578
+ system: SystemLike,
579
+ schemaPath: Array<string | number>
580
+ ): void {
581
+ const content = system.content ?? {}
582
+ for (const [localId, node] of Object.entries(content)) {
583
+ if (node.kind !== 'schema') continue
584
+
585
+ const entries = Object.fromEntries(
586
+ Object.entries(content)
587
+ .filter(([, candidate]) => candidate.parentContentId === localId)
588
+ .map(([entryId, candidate]) => [
589
+ entryId,
590
+ {
591
+ label: candidate.label ?? entryId,
592
+ type: candidate.type,
593
+ ...(candidate.description !== undefined ? { description: candidate.description } : {}),
594
+ ...(candidate.data !== undefined ? candidate.data : {})
595
+ }
596
+ ])
597
+ )
598
+
599
+ const catalogType: OntologyCatalogType = {
600
+ id: formatOntologyId({ scope: systemPath, kind: 'catalog', localId }),
601
+ label: node.label ?? localId,
602
+ description: node.description,
603
+ ownerSystemId: systemPath,
604
+ kind: node.type,
605
+ ...(typeof node.data?.['entityId'] === 'string'
606
+ ? { appliesTo: formatOntologyId({ scope: systemPath, kind: 'object', localId: node.data['entityId'] }) }
607
+ : {}),
608
+ ...(Object.keys(entries).length > 0 ? { entries } : {}),
609
+ ...(node.data !== undefined ? { data: node.data } : {}),
610
+ legacyContentId: `${systemPath}:${localId}`
611
+ }
612
+
613
+ addRecord(index, diagnostics, sourcesById, 'catalogTypes', catalogType, {
614
+ source: 'legacy.system.content',
615
+ path: [...schemaPath, 'content', localId],
616
+ kind: 'projected',
617
+ systemPath,
618
+ legacyId: `${systemPath}:${localId}`
619
+ })
620
+ }
621
+ }
622
+
623
+ function addSystemScopes(
624
+ index: ResolvedOntologyIndex,
625
+ diagnostics: OntologyDiagnostic[],
626
+ sourcesById: Map<string, SourceContext>,
627
+ systems: Record<string, SystemLike>,
628
+ prefix: string,
629
+ schemaPath: Array<string | number>
630
+ ): void {
631
+ for (const [key, system] of Object.entries(systems)) {
632
+ const systemPath = prefix ? `${prefix}.${key}` : key
633
+ const currentPath = [...schemaPath, key]
634
+ addScope(index, diagnostics, sourcesById, system.ontology, `system:${systemPath}.ontology`, [
635
+ ...currentPath,
636
+ 'ontology'
637
+ ])
638
+ addSystemContentProjections(index, diagnostics, sourcesById, systemPath, system, currentPath)
639
+ addSystemScopes(index, diagnostics, sourcesById, childSystemsOf(system), systemPath, [
640
+ ...currentPath,
641
+ system.systems !== undefined ? 'systems' : 'subsystems'
642
+ ])
643
+ }
644
+ }
645
+
646
+ export function compileOrganizationOntology(model: ModelLike): OntologyCompilation {
647
+ const ontology = createEmptyIndex()
648
+ const diagnostics: OntologyDiagnostic[] = []
649
+ const sourcesById = new Map<string, SourceContext>()
650
+
651
+ addScope(ontology, diagnostics, sourcesById, model.ontology, 'organization.ontology', ['ontology'])
652
+ addSystemScopes(ontology, diagnostics, sourcesById, model.systems ?? {}, '', ['systems'])
653
+ addLegacyEntityProjections(ontology, diagnostics, sourcesById, model.entities ?? {})
654
+ addLegacyActionProjections(ontology, diagnostics, sourcesById, model.actions ?? {}, model.entities ?? {})
655
+
656
+ return { ontology: sortResolvedOntologyIndex(ontology), diagnostics }
657
+ }
658
+
659
+ export function getOntologyDiagnostics(model: ModelLike): OntologyDiagnostic[] {
660
+ return compileOrganizationOntology(model).diagnostics
661
+ }