@elevasis/core 0.21.0 → 0.23.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 (132) hide show
  1. package/dist/index.d.ts +2518 -2169
  2. package/dist/index.js +2495 -1095
  3. package/dist/knowledge/index.d.ts +706 -1044
  4. package/dist/knowledge/index.js +9 -9
  5. package/dist/organization-model/index.d.ts +2518 -2169
  6. package/dist/organization-model/index.js +2495 -1095
  7. package/dist/test-utils/index.d.ts +826 -1014
  8. package/dist/test-utils/index.js +1894 -1032
  9. package/package.json +3 -3
  10. package/src/__tests__/template-core-compatibility.test.ts +11 -79
  11. package/src/_gen/__tests__/__snapshots__/contracts.md.snap +852 -397
  12. package/src/auth/multi-tenancy/permissions.ts +20 -8
  13. package/src/business/README.md +2 -2
  14. package/src/business/acquisition/api-schemas.test.ts +175 -2
  15. package/src/business/acquisition/api-schemas.ts +132 -16
  16. package/src/business/acquisition/build-templates.test.ts +4 -4
  17. package/src/business/acquisition/build-templates.ts +72 -30
  18. package/src/business/acquisition/crm-state-actions.test.ts +13 -11
  19. package/src/business/acquisition/index.ts +12 -0
  20. package/src/business/acquisition/types.ts +7 -3
  21. package/src/business/clients/api-schemas.test.ts +115 -0
  22. package/src/business/clients/api-schemas.ts +158 -0
  23. package/src/business/clients/index.ts +1 -0
  24. package/src/business/deals/api-schemas.ts +8 -0
  25. package/src/business/index.ts +5 -2
  26. package/src/business/projects/types.ts +19 -0
  27. package/src/execution/engine/__tests__/fixtures/test-agents.ts +10 -8
  28. package/src/execution/engine/agent/core/__tests__/agent.test.ts +16 -12
  29. package/src/execution/engine/agent/core/__tests__/error-passthrough.test.ts +4 -3
  30. package/src/execution/engine/agent/core/types.ts +25 -15
  31. package/src/execution/engine/agent/index.ts +6 -4
  32. package/src/execution/engine/agent/reasoning/__tests__/request-builder.test.ts +24 -18
  33. package/src/execution/engine/index.ts +3 -0
  34. package/src/execution/engine/workflow/types.ts +9 -2
  35. package/src/knowledge/README.md +8 -7
  36. package/src/knowledge/__tests__/queries.test.ts +74 -73
  37. package/src/knowledge/format.ts +10 -9
  38. package/src/knowledge/index.ts +1 -1
  39. package/src/knowledge/published.ts +1 -1
  40. package/src/knowledge/queries.ts +26 -25
  41. package/src/organization-model/README.md +73 -26
  42. package/src/organization-model/__tests__/content-kinds-registry.test.ts +210 -0
  43. package/src/organization-model/__tests__/defaults.test.ts +76 -96
  44. package/src/organization-model/__tests__/domains/actions.test.ts +56 -0
  45. package/src/organization-model/__tests__/domains/customers.test.ts +299 -295
  46. package/src/organization-model/__tests__/domains/entities.test.ts +56 -0
  47. package/src/organization-model/__tests__/domains/goals.test.ts +493 -479
  48. package/src/organization-model/__tests__/domains/identity.test.ts +280 -279
  49. package/src/organization-model/__tests__/domains/navigation.test.ts +268 -212
  50. package/src/organization-model/__tests__/domains/offerings.test.ts +414 -419
  51. package/src/organization-model/__tests__/domains/policies.test.ts +323 -0
  52. package/src/organization-model/__tests__/domains/resource-mappings.test.ts +271 -271
  53. package/src/organization-model/__tests__/domains/resources.test.ts +310 -0
  54. package/src/organization-model/__tests__/domains/roles.test.ts +463 -347
  55. package/src/organization-model/__tests__/domains/statuses.test.ts +246 -243
  56. package/src/organization-model/__tests__/domains/systems.test.ts +209 -0
  57. package/src/organization-model/__tests__/flatten-additive-merge.test.ts +361 -0
  58. package/src/organization-model/__tests__/foundation.test.ts +74 -102
  59. package/src/organization-model/__tests__/get-resources-for-system.test.ts +144 -0
  60. package/src/organization-model/__tests__/graph.test.ts +899 -71
  61. package/src/organization-model/__tests__/knowledge.test.ts +209 -49
  62. package/src/organization-model/__tests__/lookup-helpers.test.ts +438 -0
  63. package/src/organization-model/__tests__/migration-helpers.test.ts +591 -0
  64. package/src/organization-model/__tests__/prospecting-ssot.test.ts +36 -27
  65. package/src/organization-model/__tests__/recursive-system-schema.test.ts +520 -0
  66. package/src/organization-model/__tests__/resolve.test.ts +174 -23
  67. package/src/organization-model/__tests__/schema.test.ts +291 -114
  68. package/src/organization-model/__tests__/surface-projection.test.ts +207 -97
  69. package/src/organization-model/catalogs/lead-gen.ts +144 -0
  70. package/src/organization-model/content-kinds/config.ts +36 -0
  71. package/src/organization-model/content-kinds/index.ts +74 -0
  72. package/src/organization-model/content-kinds/pipeline.ts +68 -0
  73. package/src/organization-model/content-kinds/registry.ts +44 -0
  74. package/src/organization-model/content-kinds/status.ts +71 -0
  75. package/src/organization-model/content-kinds/template.ts +83 -0
  76. package/src/organization-model/content-kinds/types.ts +117 -0
  77. package/src/organization-model/contracts.ts +13 -3
  78. package/src/organization-model/defaults.ts +499 -86
  79. package/src/organization-model/domains/actions.ts +239 -0
  80. package/src/organization-model/domains/customers.ts +78 -75
  81. package/src/organization-model/domains/entities.ts +144 -0
  82. package/src/organization-model/domains/goals.ts +83 -80
  83. package/src/organization-model/domains/knowledge.ts +76 -17
  84. package/src/organization-model/domains/navigation.ts +107 -384
  85. package/src/organization-model/domains/offerings.ts +71 -66
  86. package/src/organization-model/domains/policies.ts +102 -0
  87. package/src/organization-model/domains/projects.ts +14 -48
  88. package/src/organization-model/domains/prospecting.ts +62 -181
  89. package/src/organization-model/domains/resources.ts +145 -0
  90. package/src/organization-model/domains/roles.ts +96 -55
  91. package/src/organization-model/domains/sales.ts +10 -219
  92. package/src/organization-model/domains/shared.ts +57 -57
  93. package/src/organization-model/domains/statuses.ts +339 -130
  94. package/src/organization-model/domains/systems.ts +203 -0
  95. package/src/organization-model/foundation.ts +54 -67
  96. package/src/organization-model/graph/build.ts +682 -54
  97. package/src/organization-model/graph/link.ts +1 -1
  98. package/src/organization-model/graph/schema.ts +24 -9
  99. package/src/organization-model/graph/types.ts +20 -7
  100. package/src/organization-model/helpers.ts +231 -26
  101. package/src/organization-model/icons.ts +1 -0
  102. package/src/organization-model/index.ts +118 -5
  103. package/src/organization-model/migration-helpers.ts +249 -0
  104. package/src/organization-model/organization-graph.mdx +16 -15
  105. package/src/organization-model/organization-model.mdx +111 -44
  106. package/src/organization-model/published.ts +172 -19
  107. package/src/organization-model/resolve.ts +117 -54
  108. package/src/organization-model/schema.ts +654 -112
  109. package/src/organization-model/surface-projection.ts +116 -122
  110. package/src/organization-model/types.ts +146 -20
  111. package/src/platform/api/types.ts +38 -35
  112. package/src/platform/constants/versions.ts +1 -1
  113. package/src/platform/registry/__tests__/command-view.test.ts +6 -8
  114. package/src/platform/registry/__tests__/resource-link.test.ts +13 -8
  115. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +16 -31
  116. package/src/platform/registry/__tests__/resource-registry.nested-systems.test.ts +245 -0
  117. package/src/platform/registry/__tests__/resource-registry.test.ts +2053 -2005
  118. package/src/platform/registry/__tests__/validation.test.ts +1347 -1086
  119. package/src/platform/registry/index.ts +14 -0
  120. package/src/platform/registry/resource-registry.ts +52 -2
  121. package/src/platform/registry/serialization.ts +241 -202
  122. package/src/platform/registry/serialized-types.ts +1 -0
  123. package/src/platform/registry/types.ts +411 -361
  124. package/src/platform/registry/validation.ts +745 -513
  125. package/src/projects/api-schemas.ts +290 -267
  126. package/src/reference/_generated/contracts.md +853 -397
  127. package/src/reference/glossary.md +23 -18
  128. package/src/supabase/database.types.ts +181 -0
  129. package/src/test-utils/test-utils.test.ts +1 -6
  130. package/src/organization-model/__tests__/domains/operations.test.ts +0 -203
  131. package/src/organization-model/domains/features.ts +0 -31
  132. package/src/organization-model/domains/operations.ts +0 -85
@@ -1,105 +1,77 @@
1
- import { describe, expect, it } from 'vitest'
2
- import { createFoundationOrganizationModel } from '../foundation'
3
-
4
- describe('createFoundationOrganizationModel', () => {
5
- it('builds the foundation model from a branding-only override', () => {
6
- const result = createFoundationOrganizationModel({
7
- branding: { organizationName: 'Acme', productName: 'Acme OS', shortName: 'Acme' }
8
- })
9
-
10
- expect(result.canonical.branding.organizationName).toBe('Acme')
11
- expect(result.homeLabel).toBe('Dashboard')
12
- expect(result.model.navigation.defaultSurfaceId).toBe('operations')
13
-
14
- const surfaces = result.model.navigation.surfaces
15
- expect(surfaces.find((s) => s.id === 'crm')).toBeDefined()
16
- expect(surfaces.find((s) => s.id === 'lead-gen')).toBeDefined()
17
- expect(surfaces.find((s) => s.id === 'projects')).toBeDefined()
18
- expect(surfaces.find((s) => s.id === 'operations')).toBeDefined()
19
- expect(surfaces.find((s) => s.id === 'settings')).toBeDefined()
20
-
21
- expect(result.quickAccessSurfaceIds).toContain('operations')
22
- expect(result.quickAccessSurfaceIds).toContain('projects')
23
- expect(result.quickAccessSurfaceIds).toContain('lead-gen')
24
- expect(result.quickAccessSurfaceIds).toContain('crm')
25
- })
26
-
27
- it('passes deeper overrides through to the canonical model', () => {
28
- const result = createFoundationOrganizationModel({
29
- branding: { organizationName: 'Acme', productName: 'Acme OS', shortName: 'Acme' },
30
- sales: {
31
- pipelines: [
32
- {
33
- id: 'custom-pipeline',
34
- label: 'Custom Pipeline',
35
- description: 'A custom pipeline',
36
- entityId: 'crm.deal',
37
- stages: [
38
- {
39
- id: 'stage-1',
40
- label: 'Stage 1',
41
- color: 'blue',
42
- order: 0,
43
- semanticClass: 'open' as const,
44
- surfaceIds: ['crm.pipeline'],
45
- resourceIds: []
46
- }
47
- ]
48
- }
49
- ]
50
- }
51
- })
52
-
53
- expect(result.canonical.sales.pipelines).toHaveLength(1)
54
- expect(result.canonical.sales.pipelines[0]?.id).toBe('custom-pipeline')
55
- })
56
-
57
- it('exposes a working getOrganizationSurface lookup', () => {
58
- const result = createFoundationOrganizationModel({
59
- branding: { organizationName: 'Acme', productName: 'Acme OS', shortName: 'Acme' }
60
- })
61
-
62
- const crmSurface = result.getOrganizationSurface('crm')
63
- expect(crmSurface).toBeDefined()
64
- expect(crmSurface?.id).toBe('crm')
65
- expect(crmSurface?.icon).toBe('feature.crm')
1
+ import { describe, expect, it } from 'vitest'
2
+ import { createFoundationOrganizationModel } from '../foundation'
3
+
4
+ describe('createFoundationOrganizationModel', () => {
5
+ it('builds the foundation model from derived sidebar navigation', () => {
6
+ const result = createFoundationOrganizationModel({
7
+ branding: { organizationName: 'Acme', productName: 'Acme OS', shortName: 'Acme' }
8
+ })
9
+
10
+ expect(result.canonical.branding.organizationName).toBe('Acme')
11
+ expect(result.homeLabel).toBe('Dashboard')
12
+ expect(result.model.navigation.defaultSurfaceId).toBe('dashboard')
13
+
14
+ const surfaces = result.model.navigation.surfaces
15
+ expect(surfaces.find((s) => s.id === 'dashboard')).toMatchObject({ path: '/', surfaceType: 'dashboard' })
16
+ expect(surfaces.find((s) => s.id === 'sales')).toBeDefined()
17
+ expect(surfaces.find((s) => s.id === 'clients')).toMatchObject({ path: '/clients' })
18
+ expect(surfaces.find((s) => s.id === 'projects')).toBeDefined()
19
+ expect(surfaces.find((s) => s.id === 'operations-overview')).toBeDefined()
20
+ expect(surfaces.find((s) => s.id === 'settings-account')).toBeDefined()
21
+
22
+ expect(result.quickAccessSurfaceIds).toContain('sales')
23
+ expect(result.quickAccessSurfaceIds).toContain('clients')
24
+ expect(result.quickAccessSurfaceIds).toContain('projects')
25
+ expect(result.quickAccessSurfaceIds).toContain('operations-overview')
26
+ })
27
+
28
+ it.skip('passes deeper overrides through to the canonical model (deferred - Phase 4: sales domain removed)', () => {
29
+ // Previously tested: result.canonical.sales.pipelines.
30
+ // Re-enable with a content-node based pipeline override test if needed.
31
+ })
32
+
33
+ it('exposes a working getOrganizationSurface lookup', () => {
34
+ const result = createFoundationOrganizationModel({
35
+ branding: { organizationName: 'Acme', productName: 'Acme OS', shortName: 'Acme' }
36
+ })
37
+
38
+ const clientsSurface = result.getOrganizationSurface('clients')
39
+ expect(clientsSurface).toBeDefined()
40
+ expect(clientsSurface?.id).toBe('clients')
41
+ expect(clientsSurface?.path).toBe('/clients')
66
42
 
67
43
  expect(result.getOrganizationSurface('nonexistent')).toBeUndefined()
68
44
  })
69
-
70
- it('throws when a required core surface is missing', () => {
71
- const override = {
72
- features: [
73
- {
74
- id: 'crm',
75
- label: 'CRM',
76
- description: 'CRM workspace',
77
- enabled: true,
78
- color: 'blue',
79
- entityIds: [],
80
- surfaceIds: ['custom.home'],
81
- resourceIds: [],
82
- capabilityIds: []
83
- }
84
- ],
85
- navigation: {
86
- defaultSurfaceId: 'custom.home',
87
- surfaces: [
88
- {
89
- id: 'custom.home',
90
- label: 'Home',
91
- path: '/home',
92
- surfaceType: 'page' as const,
93
- featureIds: ['crm'],
94
- entityIds: [],
95
- resourceIds: [],
96
- capabilityIds: []
97
- }
98
- ],
99
- groups: [{ id: 'primary', label: 'Primary', placement: 'primary', surfaceIds: ['custom.home'] }]
100
- }
101
- }
102
-
103
- expect(() => createFoundationOrganizationModel(override)).toThrow(/Missing organization surface/)
104
- })
105
- })
45
+
46
+ it('does not require hardcoded system-backed foundation surfaces', () => {
47
+ const result = createFoundationOrganizationModel({
48
+ navigation: {
49
+ sidebar: {
50
+ primary: {
51
+ dashboard: {
52
+ type: 'surface',
53
+ label: 'Home',
54
+ path: '/',
55
+ surfaceType: 'dashboard',
56
+ order: 10,
57
+ targets: { systems: ['dashboard'] }
58
+ },
59
+ custom: {
60
+ type: 'surface',
61
+ label: 'Custom',
62
+ path: '/custom',
63
+ surfaceType: 'page',
64
+ order: 20,
65
+ targets: { systems: [] }
66
+ }
67
+ },
68
+ bottom: {}
69
+ }
70
+ }
71
+ })
72
+
73
+ expect(result.model.navigation.defaultSurfaceId).toBe('dashboard')
74
+ expect(result.homeLabel).toBe('Home')
75
+ expect(result.getOrganizationSurface('custom')).toMatchObject({ label: 'Custom', path: '/custom' })
76
+ })
77
+ })
@@ -0,0 +1,144 @@
1
+ /**
2
+ * Unit tests for getResourcesForSystem helper.
3
+ *
4
+ * Coverage:
5
+ * - Empty model (no resources)
6
+ * - Single leaf resource, exact match
7
+ * - includeDescendants: true returns descendants
8
+ * - Deep nesting (three levels)
9
+ * - Segment-boundary safety: 'sales' must NOT match 'salesforce.foo'
10
+ * - Root path with includeDescendants: false
11
+ * - Root path with includeDescendants: true
12
+ * - Mixed resources, only matching ones returned
13
+ */
14
+ import { describe, it, expect } from 'vitest'
15
+ import { getResourcesForSystem } from '../helpers'
16
+ import type { OrganizationModel } from '../types'
17
+ import type { ResourceEntry } from '../domains/resources'
18
+
19
+ // ---------------------------------------------------------------------------
20
+ // Minimal fixture builder
21
+ // ---------------------------------------------------------------------------
22
+
23
+ function makeModel(resources: Record<string, ResourceEntry>): OrganizationModel {
24
+ return {
25
+ systems: {},
26
+ resources,
27
+ roles: {},
28
+ goals: {},
29
+ knowledge: {},
30
+ actions: {},
31
+ entities: {},
32
+ policies: {},
33
+ navigation: { sidebar: { primary: {}, bottom: {} } }
34
+ } as unknown as OrganizationModel
35
+ }
36
+
37
+ function makeWorkflow(id: string, systemPath: string): ResourceEntry {
38
+ return {
39
+ id,
40
+ order: 10,
41
+ kind: 'workflow',
42
+ systemPath,
43
+ status: 'active'
44
+ }
45
+ }
46
+
47
+ // ---------------------------------------------------------------------------
48
+ // Tests
49
+ // ---------------------------------------------------------------------------
50
+
51
+ describe('getResourcesForSystem', () => {
52
+ it('returns empty array when model has no resources', () => {
53
+ const model = makeModel({})
54
+ expect(getResourcesForSystem(model, 'sales')).toEqual([])
55
+ })
56
+
57
+ it('returns empty array when no resources match the path', () => {
58
+ const model = makeModel({
59
+ 'wf-a': makeWorkflow('wf-a', 'marketing')
60
+ })
61
+ expect(getResourcesForSystem(model, 'sales')).toEqual([])
62
+ })
63
+
64
+ it('returns a single resource with exact match', () => {
65
+ const r = makeWorkflow('wf-a', 'sales')
66
+ const model = makeModel({ 'wf-a': r })
67
+ const result = getResourcesForSystem(model, 'sales')
68
+ expect(result).toHaveLength(1)
69
+ expect(result[0].id).toBe('wf-a')
70
+ })
71
+
72
+ it('does NOT return descendants when includeDescendants is false (default)', () => {
73
+ const model = makeModel({
74
+ 'wf-a': makeWorkflow('wf-a', 'sales'),
75
+ 'wf-b': makeWorkflow('wf-b', 'sales.crm'),
76
+ 'wf-c': makeWorkflow('wf-c', 'sales.lead-gen')
77
+ })
78
+ const result = getResourcesForSystem(model, 'sales')
79
+ expect(result).toHaveLength(1)
80
+ expect(result[0].id).toBe('wf-a')
81
+ })
82
+
83
+ it('returns exact match AND descendants when includeDescendants is true', () => {
84
+ const model = makeModel({
85
+ 'wf-a': makeWorkflow('wf-a', 'sales'),
86
+ 'wf-b': makeWorkflow('wf-b', 'sales.crm'),
87
+ 'wf-c': makeWorkflow('wf-c', 'sales.lead-gen'),
88
+ 'wf-d': makeWorkflow('wf-d', 'marketing')
89
+ })
90
+ const result = getResourcesForSystem(model, 'sales', { includeDescendants: true })
91
+ const ids = result.map((r) => r.id).sort()
92
+ expect(ids).toEqual(['wf-a', 'wf-b', 'wf-c'])
93
+ })
94
+
95
+ it('matches three-level deep descendants', () => {
96
+ const model = makeModel({
97
+ 'wf-a': makeWorkflow('wf-a', 'sales.crm.dispositions'),
98
+ 'wf-b': makeWorkflow('wf-b', 'sales.crm'),
99
+ 'wf-c': makeWorkflow('wf-c', 'sales')
100
+ })
101
+ const result = getResourcesForSystem(model, 'sales', { includeDescendants: true })
102
+ expect(result).toHaveLength(3)
103
+ })
104
+
105
+ it('segment-boundary: "sales" does NOT match "salesforce.foo"', () => {
106
+ const model = makeModel({
107
+ 'wf-a': makeWorkflow('wf-a', 'salesforce.foo'),
108
+ 'wf-b': makeWorkflow('wf-b', 'salesforce'),
109
+ 'wf-c': makeWorkflow('wf-c', 'sales')
110
+ })
111
+ const result = getResourcesForSystem(model, 'sales', { includeDescendants: true })
112
+ // Only exact 'sales' match — 'salesforce' and 'salesforce.foo' must NOT appear
113
+ expect(result).toHaveLength(1)
114
+ expect(result[0].id).toBe('wf-c')
115
+ })
116
+
117
+ it('segment-boundary: "sys" does NOT match "sys2.foo" or "system.bar"', () => {
118
+ const model = makeModel({
119
+ 'wf-a': makeWorkflow('wf-a', 'sys'),
120
+ 'wf-b': makeWorkflow('wf-b', 'sys.platform'),
121
+ 'wf-c': makeWorkflow('wf-c', 'sys2.foo'),
122
+ 'wf-d': makeWorkflow('wf-d', 'system.bar')
123
+ })
124
+ const result = getResourcesForSystem(model, 'sys', { includeDescendants: true })
125
+ const ids = result.map((r) => r.id).sort()
126
+ expect(ids).toEqual(['wf-a', 'wf-b'])
127
+ })
128
+
129
+ it('root path with includeDescendants false returns only exact root resources', () => {
130
+ const model = makeModel({
131
+ 'wf-a': makeWorkflow('wf-a', 'sys'),
132
+ 'wf-b': makeWorkflow('wf-b', 'sys.platform'),
133
+ 'wf-c': makeWorkflow('wf-c', 'sys.diagnostic')
134
+ })
135
+ const result = getResourcesForSystem(model, 'sys')
136
+ expect(result).toHaveLength(1)
137
+ expect(result[0].id).toBe('wf-a')
138
+ })
139
+
140
+ it('handles undefined resources gracefully via nullish coalescing', () => {
141
+ const model = { systems: {}, resources: undefined } as unknown as OrganizationModel
142
+ expect(getResourcesForSystem(model, 'sales')).toEqual([])
143
+ })
144
+ })