@elevasis/core 0.22.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 (244) hide show
  1. package/dist/index.d.ts +3214 -2501
  2. package/dist/index.js +3112 -1222
  3. package/dist/knowledge/index.d.ts +1108 -1264
  4. package/dist/knowledge/index.js +112 -9
  5. package/dist/organization-model/index.d.ts +3214 -2501
  6. package/dist/organization-model/index.js +3112 -1222
  7. package/dist/test-utils/index.d.ts +985 -1103
  8. package/dist/test-utils/index.js +2464 -1165
  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 -80
  13. package/src/_gen/__tests__/__snapshots__/contracts.md.snap +2389 -2121
  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 +1493 -1500
  37. package/src/business/acquisition/build-templates.test.ts +240 -240
  38. package/src/business/acquisition/build-templates.ts +83 -41
  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 -151
  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 -392
  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 +33 -32
  123. package/src/knowledge/__tests__/queries.test.ts +633 -541
  124. package/src/knowledge/format.ts +100 -99
  125. package/src/knowledge/index.ts +5 -5
  126. package/src/knowledge/published.ts +5 -5
  127. package/src/knowledge/queries.ts +274 -222
  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 -109
  131. package/src/organization-model/__tests__/content-kinds-registry.test.ts +210 -0
  132. package/src/organization-model/__tests__/defaults.test.ts +168 -194
  133. package/src/organization-model/__tests__/domains/actions.test.ts +78 -0
  134. package/src/organization-model/__tests__/domains/customers.test.ts +48 -44
  135. package/src/organization-model/__tests__/domains/entities.test.ts +56 -0
  136. package/src/organization-model/__tests__/domains/goals.test.ts +110 -96
  137. package/src/organization-model/__tests__/domains/identity.test.ts +4 -3
  138. package/src/organization-model/__tests__/domains/navigation.test.ts +222 -166
  139. package/src/organization-model/__tests__/domains/offerings.test.ts +83 -88
  140. package/src/organization-model/__tests__/domains/policies.test.ts +323 -0
  141. package/src/organization-model/__tests__/domains/resource-mappings.test.ts +30 -30
  142. package/src/organization-model/__tests__/domains/resources.test.ts +396 -175
  143. package/src/organization-model/__tests__/domains/roles.test.ts +463 -402
  144. package/src/organization-model/__tests__/domains/statuses.test.ts +13 -10
  145. package/src/organization-model/__tests__/domains/systems.test.ts +209 -193
  146. package/src/organization-model/__tests__/flatten-additive-merge.test.ts +362 -0
  147. package/src/organization-model/__tests__/foundation.test.ts +47 -75
  148. package/src/organization-model/__tests__/get-resources-for-system.test.ts +144 -0
  149. package/src/organization-model/__tests__/graph.test.ts +1336 -149
  150. package/src/organization-model/__tests__/icons.test.ts +10 -1
  151. package/src/organization-model/__tests__/knowledge.test.ts +418 -61
  152. package/src/organization-model/__tests__/lookup-helpers.test.ts +438 -0
  153. package/src/organization-model/__tests__/migration-helpers.test.ts +591 -0
  154. package/src/organization-model/__tests__/prospecting-ssot.test.ts +103 -94
  155. package/src/organization-model/__tests__/recursive-system-schema.test.ts +549 -0
  156. package/src/organization-model/__tests__/resolve.test.ts +303 -42
  157. package/src/organization-model/__tests__/schema.test.ts +863 -153
  158. package/src/organization-model/__tests__/surface-projection.test.ts +284 -174
  159. package/src/organization-model/catalogs/lead-gen.ts +144 -0
  160. package/src/organization-model/content-kinds/config.ts +36 -0
  161. package/src/organization-model/content-kinds/index.ts +78 -0
  162. package/src/organization-model/content-kinds/pipeline.ts +68 -0
  163. package/src/organization-model/content-kinds/registry.ts +44 -0
  164. package/src/organization-model/content-kinds/status.ts +71 -0
  165. package/src/organization-model/content-kinds/template.ts +83 -0
  166. package/src/organization-model/content-kinds/types.ts +117 -0
  167. package/src/organization-model/contracts.ts +27 -17
  168. package/src/organization-model/defaults.ts +489 -107
  169. package/src/organization-model/domains/actions.ts +333 -0
  170. package/src/organization-model/domains/customers.ts +10 -7
  171. package/src/organization-model/domains/entities.ts +144 -0
  172. package/src/organization-model/domains/goals.ts +9 -6
  173. package/src/organization-model/domains/knowledge.ts +128 -54
  174. package/src/organization-model/domains/navigation.ts +139 -416
  175. package/src/organization-model/domains/offerings.ts +15 -10
  176. package/src/organization-model/domains/policies.ts +102 -0
  177. package/src/organization-model/domains/projects.ts +6 -40
  178. package/src/organization-model/domains/prospecting.ts +395 -514
  179. package/src/organization-model/domains/resources.ts +173 -81
  180. package/src/organization-model/domains/roles.ts +96 -93
  181. package/src/organization-model/domains/sales.test.ts +218 -218
  182. package/src/organization-model/domains/sales.ts +380 -589
  183. package/src/organization-model/domains/shared.ts +8 -8
  184. package/src/organization-model/domains/statuses.ts +298 -89
  185. package/src/organization-model/domains/systems.ts +240 -38
  186. package/src/organization-model/foundation.ts +35 -48
  187. package/src/organization-model/graph/build.ts +1035 -279
  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 +77 -56
  191. package/src/organization-model/graph/types.ts +75 -56
  192. package/src/organization-model/helpers.ts +312 -59
  193. package/src/organization-model/icons.ts +78 -66
  194. package/src/organization-model/index.ts +129 -16
  195. package/src/organization-model/migration-helpers.ts +252 -0
  196. package/src/organization-model/ontology.ts +661 -0
  197. package/src/organization-model/organization-graph.mdx +110 -89
  198. package/src/organization-model/organization-model.mdx +226 -171
  199. package/src/organization-model/published.ts +295 -139
  200. package/src/organization-model/resolve.ts +139 -21
  201. package/src/organization-model/schema.ts +841 -301
  202. package/src/organization-model/surface-projection.ts +212 -218
  203. package/src/organization-model/types.ts +181 -90
  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 +5 -7
  208. package/src/platform/registry/__tests__/resource-link.test.ts +35 -30
  209. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +17 -32
  210. package/src/platform/registry/__tests__/resource-registry.nested-systems.test.ts +245 -0
  211. package/src/platform/registry/__tests__/resource-registry.test.ts +2053 -2051
  212. package/src/platform/registry/__tests__/validation.test.ts +1347 -1343
  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 -878
  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 -743
  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 +2389 -2121
  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 -3093
  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 -49
  242. package/src/organization-model/__tests__/domains/operations.test.ts +0 -203
  243. package/src/organization-model/domains/features.ts +0 -31
  244. package/src/organization-model/domains/operations.ts +0 -85
@@ -1,39 +1,39 @@
1
- import { describe, expect, it } from 'vitest'
2
- import {
3
- CreateNoteRequestSchema,
4
- NoteTypeSchema,
5
- UpdateMilestoneRequestSchema
6
- } from './api-schemas'
7
-
8
- describe('NoteTypeSchema', () => {
9
- it('accepts agent_learning', () => {
10
- expect(NoteTypeSchema.safeParse('agent_learning').success).toBe(true)
11
- })
12
- })
13
-
14
- describe('CreateNoteRequestSchema', () => {
15
- it('accepts agent_learning notes', () => {
16
- const result = CreateNoteRequestSchema.safeParse({
17
- project_id: '123e4567-e89b-12d3-a456-426614174000',
18
- type: 'agent_learning',
19
- content: 'Capture a reusable implementation lesson for this project.'
20
- })
21
-
22
- expect(result.success).toBe(true)
23
- })
24
- })
25
-
26
- describe('UpdateMilestoneRequestSchema', () => {
27
- it('accepts description-only updates', () => {
28
- const result = UpdateMilestoneRequestSchema.safeParse({
29
- description: ''
30
- })
31
-
32
- expect(result.success).toBe(true)
33
- })
34
-
35
- it('rejects empty payloads', () => {
36
- const result = UpdateMilestoneRequestSchema.safeParse({})
37
- expect(result.success).toBe(false)
38
- })
39
- })
1
+ import { describe, expect, it } from 'vitest'
2
+ import {
3
+ CreateNoteRequestSchema,
4
+ NoteTypeSchema,
5
+ UpdateMilestoneRequestSchema
6
+ } from './api-schemas'
7
+
8
+ describe('NoteTypeSchema', () => {
9
+ it('accepts agent_learning', () => {
10
+ expect(NoteTypeSchema.safeParse('agent_learning').success).toBe(true)
11
+ })
12
+ })
13
+
14
+ describe('CreateNoteRequestSchema', () => {
15
+ it('accepts agent_learning notes', () => {
16
+ const result = CreateNoteRequestSchema.safeParse({
17
+ project_id: '123e4567-e89b-12d3-a456-426614174000',
18
+ type: 'agent_learning',
19
+ content: 'Capture a reusable implementation lesson for this project.'
20
+ })
21
+
22
+ expect(result.success).toBe(true)
23
+ })
24
+ })
25
+
26
+ describe('UpdateMilestoneRequestSchema', () => {
27
+ it('accepts description-only updates', () => {
28
+ const result = UpdateMilestoneRequestSchema.safeParse({
29
+ description: ''
30
+ })
31
+
32
+ expect(result.success).toBe(true)
33
+ })
34
+
35
+ it('rejects empty payloads', () => {
36
+ const result = UpdateMilestoneRequestSchema.safeParse({})
37
+ expect(result.success).toBe(false)
38
+ })
39
+ })
@@ -1,291 +1,291 @@
1
- import { z } from 'zod'
2
- import { UuidSchema } from '../platform/utils/validation'
3
-
4
- /**
5
- * Project Management API Schemas
6
- *
7
- * Request/response validation for /api/external/projects surface.
8
- * Used by both the API (external-routes.ts) and the CLI (packages/cli).
9
- *
10
- * Table mapping:
11
- * prj_projects -> ProjectSchemas
12
- * prj_milestones -> MilestoneSchemas
13
- * prj_tasks -> TaskSchemas
14
- * prj_notes -> NoteSchemas
15
- */
16
-
17
- // ---------------------------------------------------------------------------
18
- // Enum literals (must match DB CHECK constraints exactly)
19
- // ---------------------------------------------------------------------------
20
-
21
- export const ProjectKindSchema = z.enum(['client_engagement', 'internal', 'research', 'other'])
22
- export const ProjectStatusSchema = z.enum(['active', 'on_track', 'at_risk', 'blocked', 'completed', 'paused'])
23
- export const MilestoneStatusSchema = z.enum(['upcoming', 'in_progress', 'completed', 'overdue', 'blocked'])
24
- export const TaskStatusSchema = z.enum([
25
- 'planned',
26
- 'in_progress',
27
- 'blocked',
28
- 'completed',
29
- 'cancelled',
30
- 'submitted',
31
- 'approved',
32
- 'rejected',
33
- 'revision_requested'
34
- ])
35
- export const TaskTypeSchema = z.enum([
36
- 'documentation',
37
- 'code',
38
- 'report',
39
- 'design',
40
- 'refactor',
41
- 'feature',
42
- 'bug',
43
- 'research',
44
- 'other'
45
- ])
46
- export const NoteTypeSchema = z.enum(['call_note', 'status_update', 'issue', 'blocker', 'agent_learning'])
47
-
48
- // ---------------------------------------------------------------------------
49
- // Checklist item shape (JSONB array stored on prj_tasks)
50
- // ---------------------------------------------------------------------------
51
-
52
- export const ChecklistItemSchema = z.object({
53
- id: z.string(),
54
- label: z.string(),
55
- completed: z.boolean()
56
- })
57
-
58
- export const ChecklistSchema = z.array(ChecklistItemSchema)
59
-
60
- // ---------------------------------------------------------------------------
61
- // resume_context shape (JSONB on prj_tasks, merged on PATCH .../resume-context)
62
- // ---------------------------------------------------------------------------
63
-
64
- export const ResumeContextSchema = z.record(z.string(), z.unknown())
65
-
66
- // ---------------------------------------------------------------------------
67
- // Projects
68
- // ---------------------------------------------------------------------------
69
-
70
- export const CreateProjectRequestSchema = z
71
- .object({
72
- name: z.string().trim().min(1).max(255),
73
- kind: ProjectKindSchema,
74
- status: ProjectStatusSchema.optional(),
75
- description: z.string().nullable().optional(),
76
- deal_id: UuidSchema.nullable().optional(),
77
- client_id: UuidSchema.nullable().optional(),
78
- client_company_id: UuidSchema.nullable().optional(),
79
- start_date: z.string().nullable().optional(),
80
- target_end_date: z.string().nullable().optional(),
81
- contract_value: z.number().nullable().optional(),
82
- metadata: z.record(z.string(), z.unknown()).nullable().optional()
83
- })
84
- .strict()
85
-
86
- export const UpdateProjectRequestSchema = z
87
- .object({
88
- name: z.string().trim().min(1).max(255).optional(),
89
- kind: ProjectKindSchema.optional(),
90
- status: ProjectStatusSchema.optional(),
91
- description: z.string().nullable().optional(),
92
- deal_id: UuidSchema.nullable().optional(),
93
- client_id: UuidSchema.nullable().optional(),
94
- client_company_id: UuidSchema.nullable().optional(),
95
- start_date: z.string().nullable().optional(),
96
- target_end_date: z.string().nullable().optional(),
97
- actual_end_date: z.string().nullable().optional(),
98
- contract_value: z.number().nullable().optional(),
99
- metadata: z.record(z.string(), z.unknown()).nullable().optional()
100
- })
101
- .strict()
102
- .refine((data) => Object.keys(data).length > 0, { message: 'At least one field must be provided' })
103
-
104
- export const GetProjectsQuerySchema = z
105
- .object({
106
- kind: ProjectKindSchema.optional(),
107
- status: ProjectStatusSchema.optional(),
108
- search: z.string().trim().min(1).max(255).optional(),
109
- client_id: UuidSchema.optional()
110
- })
111
- .strict()
112
-
113
- export const ProjectIdParamsSchema = z.object({ id: UuidSchema })
114
-
115
- export const ProjectSourceDealRefSchema = z.object({
116
- id: z.string(),
117
- clientId: z.string().nullable().optional(),
118
- contactEmail: z.string(),
119
- stageKey: z.string().nullable(),
120
- stateKey: z.string().nullable(),
121
- sourceListId: z.string().nullable(),
122
- updatedAt: z.string()
123
- })
124
-
125
- export const ProjectClientRefSchema = z.object({
126
- id: z.string(),
127
- name: z.string(),
128
- status: z.string()
129
- })
130
-
131
- // ---------------------------------------------------------------------------
132
- // Milestones
133
- // ---------------------------------------------------------------------------
134
-
135
- export const CreateMilestoneRequestSchema = z
136
- .object({
137
- name: z.string().trim().min(1).max(255),
138
- status: MilestoneStatusSchema.optional(),
139
- description: z.string().nullable().optional(),
140
- due_date: z.string().nullable().optional(),
141
- sequence: z.number().int().min(0).optional(),
142
- metadata: z.record(z.string(), z.unknown()).nullable().optional()
143
- })
144
- .strict()
145
-
146
- export const UpdateMilestoneRequestSchema = z
147
- .object({
148
- name: z.string().trim().min(1).max(255).optional(),
149
- status: MilestoneStatusSchema.optional(),
150
- description: z.string().nullable().optional(),
151
- due_date: z.string().nullable().optional(),
152
- completed_at: z.string().nullable().optional(),
153
- sequence: z.number().int().min(0).optional(),
154
- checklist: ChecklistSchema.optional(),
155
- metadata: z.record(z.string(), z.unknown()).nullable().optional()
156
- })
157
- .strict()
158
- .refine((data) => Object.keys(data).length > 0, { message: 'At least one field must be provided' })
159
-
160
- export const ProjectIdPathParamsSchema = z.object({ projectId: UuidSchema })
161
- export const MilestoneIdParamsSchema = z.object({ id: UuidSchema })
162
-
163
- // ---------------------------------------------------------------------------
164
- // Tasks
165
- // ---------------------------------------------------------------------------
166
-
167
- export const CreateTaskRequestSchema = z
168
- .object({
169
- project_id: UuidSchema,
170
- name: z.string().trim().min(1).max(255),
171
- type: TaskTypeSchema.optional(),
172
- status: TaskStatusSchema.optional(),
173
- description: z.string().nullable().optional(),
174
- milestone_id: UuidSchema.nullable().optional(),
175
- parent_task_id: UuidSchema.nullable().optional(),
176
- due_date: z.string().nullable().optional(),
177
- checklist: ChecklistSchema.optional(),
178
- resume_context: ResumeContextSchema.nullable().optional(),
179
- metadata: z.record(z.string(), z.unknown()).nullable().optional()
180
- })
181
- .strict()
182
-
183
- export const UpdateTaskRequestSchema = z
184
- .object({
185
- name: z.string().trim().min(1).max(255).optional(),
186
- type: TaskTypeSchema.optional(),
187
- status: TaskStatusSchema.optional(),
188
- description: z.string().nullable().optional(),
189
- milestone_id: UuidSchema.nullable().optional(),
190
- parent_task_id: UuidSchema.nullable().optional(),
191
- due_date: z.string().nullable().optional(),
192
- completed_at: z.string().nullable().optional(),
193
- checklist: ChecklistSchema.optional(),
194
- resume_context: ResumeContextSchema.nullable().optional(),
195
- file_url: z.string().nullable().optional(),
196
- metadata: z.record(z.string(), z.unknown()).nullable().optional()
197
- })
198
- .strict()
199
- .refine((data) => Object.keys(data).length > 0, { message: 'At least one field must be provided' })
200
-
201
- export const MergeResumeContextRequestSchema = z
202
- .record(z.string(), z.unknown())
203
- .refine((data) => Object.keys(data).length > 0, { message: 'At least one field must be provided' })
204
-
205
- export const GetTasksQuerySchema = z
206
- .object({
207
- status: TaskStatusSchema.optional(),
208
- milestone_id: UuidSchema.optional(),
209
- parent_task_id: UuidSchema.optional()
210
- })
211
- .strict()
212
-
213
- export const TaskIdParamsSchema = z.object({ id: UuidSchema })
214
-
215
- // ---------------------------------------------------------------------------
216
- // Notes
217
- // ---------------------------------------------------------------------------
218
-
219
- export const CreateNoteRequestSchema = z
220
- .object({
221
- project_id: UuidSchema,
222
- content: z.string().trim().min(1),
223
- type: NoteTypeSchema.optional(),
224
- summary: z.string().nullable().optional(),
225
- task_id: UuidSchema.nullable().optional(),
226
- milestone_id: UuidSchema.nullable().optional(),
227
- occurred_at: z.string().optional(),
228
- metadata: z.record(z.string(), z.unknown()).nullable().optional()
229
- })
230
- .strict()
231
-
232
- export const UpdateNoteRequestSchema = z
233
- .object({
234
- content: z.string().trim().min(1).optional(),
235
- type: NoteTypeSchema.optional(),
236
- summary: z.string().nullable().optional(),
237
- task_id: UuidSchema.nullable().optional(),
238
- milestone_id: UuidSchema.nullable().optional(),
239
- occurred_at: z.string().optional(),
240
- metadata: z.record(z.string(), z.unknown()).nullable().optional()
241
- })
242
- .strict()
243
- .refine((data) => Object.keys(data).length > 0, { message: 'At least one field must be provided' })
244
-
245
- export const NoteIdParamsSchema = z.object({ id: UuidSchema })
246
-
247
- // ---------------------------------------------------------------------------
248
- // Bundled export (mirrors CredentialSchemas pattern)
249
- // ---------------------------------------------------------------------------
250
-
251
- export const ProjectSchemas = {
252
- // Projects
253
- CreateProjectRequest: CreateProjectRequestSchema,
254
- UpdateProjectRequest: UpdateProjectRequestSchema,
255
- GetProjectsQuery: GetProjectsQuerySchema,
256
- ProjectIdParams: ProjectIdParamsSchema,
257
- ProjectSourceDealRef: ProjectSourceDealRefSchema,
258
- ProjectClientRef: ProjectClientRefSchema,
259
-
260
- // Milestones
261
- CreateMilestoneRequest: CreateMilestoneRequestSchema,
262
- UpdateMilestoneRequest: UpdateMilestoneRequestSchema,
263
- ProjectIdPathParams: ProjectIdPathParamsSchema,
264
- MilestoneIdParams: MilestoneIdParamsSchema,
265
-
266
- // Tasks
267
- CreateTaskRequest: CreateTaskRequestSchema,
268
- UpdateTaskRequest: UpdateTaskRequestSchema,
269
- MergeResumeContextRequest: MergeResumeContextRequestSchema,
270
- GetTasksQuery: GetTasksQuerySchema,
271
- TaskIdParams: TaskIdParamsSchema,
272
-
273
- // Notes
274
- CreateNoteRequest: CreateNoteRequestSchema,
275
- UpdateNoteRequest: UpdateNoteRequestSchema,
276
- NoteIdParams: NoteIdParamsSchema
277
- }
278
-
279
- // ---------------------------------------------------------------------------
280
- // Inferred types
281
- // ---------------------------------------------------------------------------
282
-
283
- export type ProjectKind = z.infer<typeof ProjectKindSchema>
284
- export type ProjectStatus = z.infer<typeof ProjectStatusSchema>
285
- export type MilestoneStatus = z.infer<typeof MilestoneStatusSchema>
286
- export type TaskStatus = z.infer<typeof TaskStatusSchema>
287
- export type TaskType = z.infer<typeof TaskTypeSchema>
288
- export type NoteType = z.infer<typeof NoteTypeSchema>
289
- export type ChecklistItem = z.infer<typeof ChecklistItemSchema>
290
- export type ProjectSourceDealRef = z.infer<typeof ProjectSourceDealRefSchema>
291
- export type ProjectClientRef = z.infer<typeof ProjectClientRefSchema>
1
+ import { z } from 'zod'
2
+ import { UuidSchema } from '../platform/utils/validation'
3
+
4
+ /**
5
+ * Project Management API Schemas
6
+ *
7
+ * Request/response validation for /api/external/projects surface.
8
+ * Used by both the API (external-routes.ts) and the CLI (packages/cli).
9
+ *
10
+ * Table mapping:
11
+ * prj_projects -> ProjectSchemas
12
+ * prj_milestones -> MilestoneSchemas
13
+ * prj_tasks -> TaskSchemas
14
+ * prj_notes -> NoteSchemas
15
+ */
16
+
17
+ // ---------------------------------------------------------------------------
18
+ // Enum literals (must match DB CHECK constraints exactly)
19
+ // ---------------------------------------------------------------------------
20
+
21
+ export const ProjectKindSchema = z.enum(['client_engagement', 'internal', 'research', 'other'])
22
+ export const ProjectStatusSchema = z.enum(['active', 'on_track', 'at_risk', 'blocked', 'completed', 'paused'])
23
+ export const MilestoneStatusSchema = z.enum(['upcoming', 'in_progress', 'completed', 'overdue', 'blocked'])
24
+ export const TaskStatusSchema = z.enum([
25
+ 'planned',
26
+ 'in_progress',
27
+ 'blocked',
28
+ 'completed',
29
+ 'cancelled',
30
+ 'submitted',
31
+ 'approved',
32
+ 'rejected',
33
+ 'revision_requested'
34
+ ])
35
+ export const TaskTypeSchema = z.enum([
36
+ 'documentation',
37
+ 'code',
38
+ 'report',
39
+ 'design',
40
+ 'refactor',
41
+ 'feature',
42
+ 'bug',
43
+ 'research',
44
+ 'other'
45
+ ])
46
+ export const NoteTypeSchema = z.enum(['call_note', 'status_update', 'issue', 'blocker', 'agent_learning'])
47
+
48
+ // ---------------------------------------------------------------------------
49
+ // Checklist item shape (JSONB array stored on prj_tasks)
50
+ // ---------------------------------------------------------------------------
51
+
52
+ export const ChecklistItemSchema = z.object({
53
+ id: z.string(),
54
+ label: z.string(),
55
+ completed: z.boolean()
56
+ })
57
+
58
+ export const ChecklistSchema = z.array(ChecklistItemSchema)
59
+
60
+ // ---------------------------------------------------------------------------
61
+ // resume_context shape (JSONB on prj_tasks, merged on PATCH .../resume-context)
62
+ // ---------------------------------------------------------------------------
63
+
64
+ export const ResumeContextSchema = z.record(z.string(), z.unknown())
65
+
66
+ // ---------------------------------------------------------------------------
67
+ // Projects
68
+ // ---------------------------------------------------------------------------
69
+
70
+ export const CreateProjectRequestSchema = z
71
+ .object({
72
+ name: z.string().trim().min(1).max(255),
73
+ kind: ProjectKindSchema,
74
+ status: ProjectStatusSchema.optional(),
75
+ description: z.string().nullable().optional(),
76
+ deal_id: UuidSchema.nullable().optional(),
77
+ client_id: UuidSchema.nullable().optional(),
78
+ client_company_id: UuidSchema.nullable().optional(),
79
+ start_date: z.string().nullable().optional(),
80
+ target_end_date: z.string().nullable().optional(),
81
+ contract_value: z.number().nullable().optional(),
82
+ metadata: z.record(z.string(), z.unknown()).nullable().optional()
83
+ })
84
+ .strict()
85
+
86
+ export const UpdateProjectRequestSchema = z
87
+ .object({
88
+ name: z.string().trim().min(1).max(255).optional(),
89
+ kind: ProjectKindSchema.optional(),
90
+ status: ProjectStatusSchema.optional(),
91
+ description: z.string().nullable().optional(),
92
+ deal_id: UuidSchema.nullable().optional(),
93
+ client_id: UuidSchema.nullable().optional(),
94
+ client_company_id: UuidSchema.nullable().optional(),
95
+ start_date: z.string().nullable().optional(),
96
+ target_end_date: z.string().nullable().optional(),
97
+ actual_end_date: z.string().nullable().optional(),
98
+ contract_value: z.number().nullable().optional(),
99
+ metadata: z.record(z.string(), z.unknown()).nullable().optional()
100
+ })
101
+ .strict()
102
+ .refine((data) => Object.keys(data).length > 0, { message: 'At least one field must be provided' })
103
+
104
+ export const GetProjectsQuerySchema = z
105
+ .object({
106
+ kind: ProjectKindSchema.optional(),
107
+ status: ProjectStatusSchema.optional(),
108
+ search: z.string().trim().min(1).max(255).optional(),
109
+ client_id: UuidSchema.optional()
110
+ })
111
+ .strict()
112
+
113
+ export const ProjectIdParamsSchema = z.object({ id: UuidSchema })
114
+
115
+ export const ProjectSourceDealRefSchema = z.object({
116
+ id: z.string(),
117
+ clientId: z.string().nullable().optional(),
118
+ contactEmail: z.string(),
119
+ stageKey: z.string().nullable(),
120
+ stateKey: z.string().nullable(),
121
+ sourceListId: z.string().nullable(),
122
+ updatedAt: z.string()
123
+ })
124
+
125
+ export const ProjectClientRefSchema = z.object({
126
+ id: z.string(),
127
+ name: z.string(),
128
+ status: z.string()
129
+ })
130
+
131
+ // ---------------------------------------------------------------------------
132
+ // Milestones
133
+ // ---------------------------------------------------------------------------
134
+
135
+ export const CreateMilestoneRequestSchema = z
136
+ .object({
137
+ name: z.string().trim().min(1).max(255),
138
+ status: MilestoneStatusSchema.optional(),
139
+ description: z.string().nullable().optional(),
140
+ due_date: z.string().nullable().optional(),
141
+ sequence: z.number().int().min(0).optional(),
142
+ metadata: z.record(z.string(), z.unknown()).nullable().optional()
143
+ })
144
+ .strict()
145
+
146
+ export const UpdateMilestoneRequestSchema = z
147
+ .object({
148
+ name: z.string().trim().min(1).max(255).optional(),
149
+ status: MilestoneStatusSchema.optional(),
150
+ description: z.string().nullable().optional(),
151
+ due_date: z.string().nullable().optional(),
152
+ completed_at: z.string().nullable().optional(),
153
+ sequence: z.number().int().min(0).optional(),
154
+ checklist: ChecklistSchema.optional(),
155
+ metadata: z.record(z.string(), z.unknown()).nullable().optional()
156
+ })
157
+ .strict()
158
+ .refine((data) => Object.keys(data).length > 0, { message: 'At least one field must be provided' })
159
+
160
+ export const ProjectIdPathParamsSchema = z.object({ projectId: UuidSchema })
161
+ export const MilestoneIdParamsSchema = z.object({ id: UuidSchema })
162
+
163
+ // ---------------------------------------------------------------------------
164
+ // Tasks
165
+ // ---------------------------------------------------------------------------
166
+
167
+ export const CreateTaskRequestSchema = z
168
+ .object({
169
+ project_id: UuidSchema,
170
+ name: z.string().trim().min(1).max(255),
171
+ type: TaskTypeSchema.optional(),
172
+ status: TaskStatusSchema.optional(),
173
+ description: z.string().nullable().optional(),
174
+ milestone_id: UuidSchema.nullable().optional(),
175
+ parent_task_id: UuidSchema.nullable().optional(),
176
+ due_date: z.string().nullable().optional(),
177
+ checklist: ChecklistSchema.optional(),
178
+ resume_context: ResumeContextSchema.nullable().optional(),
179
+ metadata: z.record(z.string(), z.unknown()).nullable().optional()
180
+ })
181
+ .strict()
182
+
183
+ export const UpdateTaskRequestSchema = z
184
+ .object({
185
+ name: z.string().trim().min(1).max(255).optional(),
186
+ type: TaskTypeSchema.optional(),
187
+ status: TaskStatusSchema.optional(),
188
+ description: z.string().nullable().optional(),
189
+ milestone_id: UuidSchema.nullable().optional(),
190
+ parent_task_id: UuidSchema.nullable().optional(),
191
+ due_date: z.string().nullable().optional(),
192
+ completed_at: z.string().nullable().optional(),
193
+ checklist: ChecklistSchema.optional(),
194
+ resume_context: ResumeContextSchema.nullable().optional(),
195
+ file_url: z.string().nullable().optional(),
196
+ metadata: z.record(z.string(), z.unknown()).nullable().optional()
197
+ })
198
+ .strict()
199
+ .refine((data) => Object.keys(data).length > 0, { message: 'At least one field must be provided' })
200
+
201
+ export const MergeResumeContextRequestSchema = z
202
+ .record(z.string(), z.unknown())
203
+ .refine((data) => Object.keys(data).length > 0, { message: 'At least one field must be provided' })
204
+
205
+ export const GetTasksQuerySchema = z
206
+ .object({
207
+ status: TaskStatusSchema.optional(),
208
+ milestone_id: UuidSchema.optional(),
209
+ parent_task_id: UuidSchema.optional()
210
+ })
211
+ .strict()
212
+
213
+ export const TaskIdParamsSchema = z.object({ id: UuidSchema })
214
+
215
+ // ---------------------------------------------------------------------------
216
+ // Notes
217
+ // ---------------------------------------------------------------------------
218
+
219
+ export const CreateNoteRequestSchema = z
220
+ .object({
221
+ project_id: UuidSchema,
222
+ content: z.string().trim().min(1),
223
+ type: NoteTypeSchema.optional(),
224
+ summary: z.string().nullable().optional(),
225
+ task_id: UuidSchema.nullable().optional(),
226
+ milestone_id: UuidSchema.nullable().optional(),
227
+ occurred_at: z.string().optional(),
228
+ metadata: z.record(z.string(), z.unknown()).nullable().optional()
229
+ })
230
+ .strict()
231
+
232
+ export const UpdateNoteRequestSchema = z
233
+ .object({
234
+ content: z.string().trim().min(1).optional(),
235
+ type: NoteTypeSchema.optional(),
236
+ summary: z.string().nullable().optional(),
237
+ task_id: UuidSchema.nullable().optional(),
238
+ milestone_id: UuidSchema.nullable().optional(),
239
+ occurred_at: z.string().optional(),
240
+ metadata: z.record(z.string(), z.unknown()).nullable().optional()
241
+ })
242
+ .strict()
243
+ .refine((data) => Object.keys(data).length > 0, { message: 'At least one field must be provided' })
244
+
245
+ export const NoteIdParamsSchema = z.object({ id: UuidSchema })
246
+
247
+ // ---------------------------------------------------------------------------
248
+ // Bundled export (mirrors CredentialSchemas pattern)
249
+ // ---------------------------------------------------------------------------
250
+
251
+ export const ProjectSchemas = {
252
+ // Projects
253
+ CreateProjectRequest: CreateProjectRequestSchema,
254
+ UpdateProjectRequest: UpdateProjectRequestSchema,
255
+ GetProjectsQuery: GetProjectsQuerySchema,
256
+ ProjectIdParams: ProjectIdParamsSchema,
257
+ ProjectSourceDealRef: ProjectSourceDealRefSchema,
258
+ ProjectClientRef: ProjectClientRefSchema,
259
+
260
+ // Milestones
261
+ CreateMilestoneRequest: CreateMilestoneRequestSchema,
262
+ UpdateMilestoneRequest: UpdateMilestoneRequestSchema,
263
+ ProjectIdPathParams: ProjectIdPathParamsSchema,
264
+ MilestoneIdParams: MilestoneIdParamsSchema,
265
+
266
+ // Tasks
267
+ CreateTaskRequest: CreateTaskRequestSchema,
268
+ UpdateTaskRequest: UpdateTaskRequestSchema,
269
+ MergeResumeContextRequest: MergeResumeContextRequestSchema,
270
+ GetTasksQuery: GetTasksQuerySchema,
271
+ TaskIdParams: TaskIdParamsSchema,
272
+
273
+ // Notes
274
+ CreateNoteRequest: CreateNoteRequestSchema,
275
+ UpdateNoteRequest: UpdateNoteRequestSchema,
276
+ NoteIdParams: NoteIdParamsSchema
277
+ }
278
+
279
+ // ---------------------------------------------------------------------------
280
+ // Inferred types
281
+ // ---------------------------------------------------------------------------
282
+
283
+ export type ProjectKind = z.infer<typeof ProjectKindSchema>
284
+ export type ProjectStatus = z.infer<typeof ProjectStatusSchema>
285
+ export type MilestoneStatus = z.infer<typeof MilestoneStatusSchema>
286
+ export type TaskStatus = z.infer<typeof TaskStatusSchema>
287
+ export type TaskType = z.infer<typeof TaskTypeSchema>
288
+ export type NoteType = z.infer<typeof NoteTypeSchema>
289
+ export type ChecklistItem = z.infer<typeof ChecklistItemSchema>
290
+ export type ProjectSourceDealRef = z.infer<typeof ProjectSourceDealRefSchema>
291
+ export type ProjectClientRef = z.infer<typeof ProjectClientRefSchema>