@elevasis/core 0.22.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 (112) hide show
  1. package/dist/index.d.ts +2330 -2391
  2. package/dist/index.js +2322 -1147
  3. package/dist/knowledge/index.d.ts +702 -1136
  4. package/dist/knowledge/index.js +9 -9
  5. package/dist/organization-model/index.d.ts +2330 -2391
  6. package/dist/organization-model/index.js +2322 -1147
  7. package/dist/test-utils/index.d.ts +703 -1106
  8. package/dist/test-utils/index.js +1735 -1089
  9. package/package.json +1 -1
  10. package/src/__tests__/template-core-compatibility.test.ts +11 -79
  11. package/src/_gen/__tests__/__snapshots__/contracts.md.snap +360 -98
  12. package/src/business/acquisition/api-schemas.test.ts +2 -2
  13. package/src/business/acquisition/api-schemas.ts +7 -9
  14. package/src/business/acquisition/build-templates.test.ts +4 -4
  15. package/src/business/acquisition/build-templates.ts +72 -30
  16. package/src/business/acquisition/crm-state-actions.test.ts +13 -11
  17. package/src/business/acquisition/types.ts +7 -3
  18. package/src/execution/engine/agent/core/types.ts +1 -1
  19. package/src/execution/engine/workflow/types.ts +2 -2
  20. package/src/knowledge/README.md +8 -7
  21. package/src/knowledge/__tests__/queries.test.ts +74 -73
  22. package/src/knowledge/format.ts +10 -9
  23. package/src/knowledge/index.ts +1 -1
  24. package/src/knowledge/published.ts +1 -1
  25. package/src/knowledge/queries.ts +26 -25
  26. package/src/organization-model/README.md +66 -26
  27. package/src/organization-model/__tests__/content-kinds-registry.test.ts +210 -0
  28. package/src/organization-model/__tests__/defaults.test.ts +72 -98
  29. package/src/organization-model/__tests__/domains/actions.test.ts +56 -0
  30. package/src/organization-model/__tests__/domains/customers.test.ts +299 -295
  31. package/src/organization-model/__tests__/domains/entities.test.ts +56 -0
  32. package/src/organization-model/__tests__/domains/goals.test.ts +493 -479
  33. package/src/organization-model/__tests__/domains/identity.test.ts +280 -279
  34. package/src/organization-model/__tests__/domains/navigation.test.ts +268 -212
  35. package/src/organization-model/__tests__/domains/offerings.test.ts +414 -419
  36. package/src/organization-model/__tests__/domains/policies.test.ts +323 -0
  37. package/src/organization-model/__tests__/domains/resource-mappings.test.ts +271 -271
  38. package/src/organization-model/__tests__/domains/resources.test.ts +159 -37
  39. package/src/organization-model/__tests__/domains/roles.test.ts +147 -86
  40. package/src/organization-model/__tests__/domains/statuses.test.ts +246 -243
  41. package/src/organization-model/__tests__/domains/systems.test.ts +67 -51
  42. package/src/organization-model/__tests__/flatten-additive-merge.test.ts +361 -0
  43. package/src/organization-model/__tests__/foundation.test.ts +74 -102
  44. package/src/organization-model/__tests__/get-resources-for-system.test.ts +144 -0
  45. package/src/organization-model/__tests__/graph.test.ts +899 -71
  46. package/src/organization-model/__tests__/knowledge.test.ts +173 -52
  47. package/src/organization-model/__tests__/lookup-helpers.test.ts +438 -0
  48. package/src/organization-model/__tests__/migration-helpers.test.ts +591 -0
  49. package/src/organization-model/__tests__/prospecting-ssot.test.ts +36 -27
  50. package/src/organization-model/__tests__/recursive-system-schema.test.ts +520 -0
  51. package/src/organization-model/__tests__/resolve.test.ts +174 -23
  52. package/src/organization-model/__tests__/schema.test.ts +291 -114
  53. package/src/organization-model/__tests__/surface-projection.test.ts +207 -97
  54. package/src/organization-model/catalogs/lead-gen.ts +144 -0
  55. package/src/organization-model/content-kinds/config.ts +36 -0
  56. package/src/organization-model/content-kinds/index.ts +74 -0
  57. package/src/organization-model/content-kinds/pipeline.ts +68 -0
  58. package/src/organization-model/content-kinds/registry.ts +44 -0
  59. package/src/organization-model/content-kinds/status.ts +71 -0
  60. package/src/organization-model/content-kinds/template.ts +83 -0
  61. package/src/organization-model/content-kinds/types.ts +117 -0
  62. package/src/organization-model/contracts.ts +13 -3
  63. package/src/organization-model/defaults.ts +488 -96
  64. package/src/organization-model/domains/actions.ts +239 -0
  65. package/src/organization-model/domains/customers.ts +78 -75
  66. package/src/organization-model/domains/entities.ts +144 -0
  67. package/src/organization-model/domains/goals.ts +83 -80
  68. package/src/organization-model/domains/knowledge.ts +74 -16
  69. package/src/organization-model/domains/navigation.ts +107 -384
  70. package/src/organization-model/domains/offerings.ts +71 -66
  71. package/src/organization-model/domains/policies.ts +102 -0
  72. package/src/organization-model/domains/projects.ts +14 -48
  73. package/src/organization-model/domains/prospecting.ts +62 -181
  74. package/src/organization-model/domains/resources.ts +81 -24
  75. package/src/organization-model/domains/roles.ts +13 -10
  76. package/src/organization-model/domains/sales.ts +10 -219
  77. package/src/organization-model/domains/shared.ts +57 -57
  78. package/src/organization-model/domains/statuses.ts +339 -130
  79. package/src/organization-model/domains/systems.ts +186 -29
  80. package/src/organization-model/foundation.ts +54 -67
  81. package/src/organization-model/graph/build.ts +682 -54
  82. package/src/organization-model/graph/link.ts +1 -1
  83. package/src/organization-model/graph/schema.ts +24 -9
  84. package/src/organization-model/graph/types.ts +20 -7
  85. package/src/organization-model/helpers.ts +231 -26
  86. package/src/organization-model/index.ts +116 -5
  87. package/src/organization-model/migration-helpers.ts +249 -0
  88. package/src/organization-model/organization-graph.mdx +16 -15
  89. package/src/organization-model/organization-model.mdx +89 -41
  90. package/src/organization-model/published.ts +120 -18
  91. package/src/organization-model/resolve.ts +117 -54
  92. package/src/organization-model/schema.ts +561 -140
  93. package/src/organization-model/surface-projection.ts +116 -122
  94. package/src/organization-model/types.ts +102 -21
  95. package/src/platform/constants/versions.ts +1 -1
  96. package/src/platform/registry/__tests__/command-view.test.ts +6 -8
  97. package/src/platform/registry/__tests__/resource-link.test.ts +13 -8
  98. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +16 -31
  99. package/src/platform/registry/__tests__/resource-registry.nested-systems.test.ts +245 -0
  100. package/src/platform/registry/__tests__/resource-registry.test.ts +9 -7
  101. package/src/platform/registry/__tests__/validation.test.ts +15 -11
  102. package/src/platform/registry/resource-registry.ts +20 -8
  103. package/src/platform/registry/serialization.ts +7 -7
  104. package/src/platform/registry/types.ts +3 -3
  105. package/src/platform/registry/validation.ts +17 -15
  106. package/src/reference/_generated/contracts.md +362 -99
  107. package/src/reference/glossary.md +18 -18
  108. package/src/supabase/database.types.ts +60 -0
  109. package/src/test-utils/test-utils.test.ts +1 -6
  110. package/src/organization-model/__tests__/domains/operations.test.ts +0 -203
  111. package/src/organization-model/domains/features.ts +0 -31
  112. 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
+ })