@vibescope/mcp-server 0.4.5 → 0.4.7

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 (176) hide show
  1. package/CHANGELOG.md +84 -84
  2. package/README.md +194 -194
  3. package/dist/api-client/project.d.ts +1 -0
  4. package/dist/api-client.d.ts +4 -1
  5. package/dist/api-client.js +24 -7
  6. package/dist/cli-init.js +25 -24
  7. package/dist/cli.js +26 -26
  8. package/dist/handlers/chat.d.ts +2 -0
  9. package/dist/handlers/chat.js +25 -0
  10. package/dist/handlers/discovery.js +12 -0
  11. package/dist/handlers/project.js +4 -2
  12. package/dist/handlers/tool-docs.js +1203 -1137
  13. package/dist/handlers/version.js +1 -1
  14. package/dist/index.js +159 -87
  15. package/dist/setup.js +13 -7
  16. package/dist/templates/agent-guidelines.d.ts +1 -1
  17. package/dist/templates/agent-guidelines.js +205 -187
  18. package/dist/templates/help-content.js +1621 -1621
  19. package/dist/tools/bodies-of-work.js +6 -6
  20. package/dist/tools/chat.d.ts +1 -0
  21. package/dist/tools/chat.js +24 -0
  22. package/dist/tools/cloud-agents.js +22 -22
  23. package/dist/tools/features.d.ts +13 -0
  24. package/dist/tools/features.js +151 -0
  25. package/dist/tools/index.d.ts +3 -1
  26. package/dist/tools/index.js +4 -1
  27. package/dist/tools/milestones.js +2 -2
  28. package/dist/tools/project.js +4 -0
  29. package/dist/tools/requests.js +1 -1
  30. package/dist/tools/session.js +11 -11
  31. package/dist/tools/sprints.js +9 -9
  32. package/dist/tools/tasks.js +35 -35
  33. package/dist/tools/worktrees.js +14 -14
  34. package/dist/tools.d.ts +2 -0
  35. package/dist/tools.js +3602 -0
  36. package/dist/utils.js +11 -11
  37. package/dist/version.d.ts +9 -3
  38. package/dist/version.js +56 -8
  39. package/docs/TOOLS.md +2663 -2559
  40. package/package.json +53 -53
  41. package/scripts/generate-docs.ts +212 -212
  42. package/scripts/version-bump.ts +203 -203
  43. package/src/api-client/blockers.ts +86 -86
  44. package/src/api-client/bodies-of-work.ts +194 -194
  45. package/src/api-client/chat.ts +50 -50
  46. package/src/api-client/connectors.ts +152 -152
  47. package/src/api-client/cost.ts +185 -185
  48. package/src/api-client/decisions.ts +87 -87
  49. package/src/api-client/deployment.ts +313 -313
  50. package/src/api-client/discovery.ts +81 -81
  51. package/src/api-client/fallback.ts +52 -52
  52. package/src/api-client/file-checkouts.ts +115 -115
  53. package/src/api-client/findings.ts +100 -100
  54. package/src/api-client/git-issues.ts +88 -88
  55. package/src/api-client/ideas.ts +112 -112
  56. package/src/api-client/index.ts +592 -592
  57. package/src/api-client/milestones.ts +83 -83
  58. package/src/api-client/organizations.ts +185 -185
  59. package/src/api-client/progress.ts +94 -94
  60. package/src/api-client/project.ts +180 -179
  61. package/src/api-client/requests.ts +54 -54
  62. package/src/api-client/session.ts +220 -220
  63. package/src/api-client/sprints.ts +227 -227
  64. package/src/api-client/subtasks.ts +57 -57
  65. package/src/api-client/tasks.ts +450 -450
  66. package/src/api-client/types.ts +32 -32
  67. package/src/api-client/validation.ts +60 -60
  68. package/src/api-client/worktrees.ts +53 -53
  69. package/src/api-client.test.ts +847 -847
  70. package/src/api-client.ts +2723 -2706
  71. package/src/cli-init.ts +558 -557
  72. package/src/cli.test.ts +284 -284
  73. package/src/cli.ts +204 -204
  74. package/src/handlers/__test-setup__.ts +240 -240
  75. package/src/handlers/__test-utils__.ts +89 -89
  76. package/src/handlers/blockers.test.ts +468 -468
  77. package/src/handlers/blockers.ts +172 -172
  78. package/src/handlers/bodies-of-work.test.ts +704 -704
  79. package/src/handlers/bodies-of-work.ts +526 -526
  80. package/src/handlers/chat.test.ts +185 -185
  81. package/src/handlers/chat.ts +101 -69
  82. package/src/handlers/cloud-agents.test.ts +438 -438
  83. package/src/handlers/cloud-agents.ts +156 -156
  84. package/src/handlers/connectors.test.ts +834 -834
  85. package/src/handlers/connectors.ts +229 -229
  86. package/src/handlers/cost.test.ts +462 -462
  87. package/src/handlers/cost.ts +285 -285
  88. package/src/handlers/decisions.test.ts +382 -382
  89. package/src/handlers/decisions.ts +153 -153
  90. package/src/handlers/deployment.test.ts +551 -551
  91. package/src/handlers/deployment.ts +570 -570
  92. package/src/handlers/discovery.test.ts +206 -206
  93. package/src/handlers/discovery.ts +427 -415
  94. package/src/handlers/fallback.test.ts +537 -537
  95. package/src/handlers/fallback.ts +194 -194
  96. package/src/handlers/file-checkouts.test.ts +750 -750
  97. package/src/handlers/file-checkouts.ts +185 -185
  98. package/src/handlers/findings.test.ts +633 -633
  99. package/src/handlers/findings.ts +239 -239
  100. package/src/handlers/git-issues.test.ts +631 -631
  101. package/src/handlers/git-issues.ts +136 -136
  102. package/src/handlers/ideas.test.ts +644 -644
  103. package/src/handlers/ideas.ts +207 -207
  104. package/src/handlers/index.ts +93 -93
  105. package/src/handlers/milestones.test.ts +475 -475
  106. package/src/handlers/milestones.ts +180 -180
  107. package/src/handlers/organizations.test.ts +826 -826
  108. package/src/handlers/organizations.ts +315 -315
  109. package/src/handlers/progress.test.ts +269 -269
  110. package/src/handlers/progress.ts +77 -77
  111. package/src/handlers/project.test.ts +546 -546
  112. package/src/handlers/project.ts +242 -239
  113. package/src/handlers/requests.test.ts +303 -303
  114. package/src/handlers/requests.ts +99 -99
  115. package/src/handlers/roles.test.ts +305 -305
  116. package/src/handlers/roles.ts +219 -219
  117. package/src/handlers/session.test.ts +998 -998
  118. package/src/handlers/session.ts +1105 -1105
  119. package/src/handlers/sprints.test.ts +732 -732
  120. package/src/handlers/sprints.ts +537 -537
  121. package/src/handlers/tasks.test.ts +931 -931
  122. package/src/handlers/tasks.ts +1133 -1133
  123. package/src/handlers/tool-categories.test.ts +66 -66
  124. package/src/handlers/tool-docs.test.ts +511 -511
  125. package/src/handlers/tool-docs.ts +1571 -1499
  126. package/src/handlers/types.test.ts +259 -259
  127. package/src/handlers/types.ts +176 -176
  128. package/src/handlers/validation.test.ts +582 -582
  129. package/src/handlers/validation.ts +164 -164
  130. package/src/handlers/version.ts +63 -63
  131. package/src/index.test.ts +674 -674
  132. package/src/index.ts +884 -807
  133. package/src/setup.test.ts +243 -233
  134. package/src/setup.ts +410 -404
  135. package/src/templates/agent-guidelines.ts +233 -215
  136. package/src/templates/help-content.ts +1751 -1751
  137. package/src/token-tracking.test.ts +463 -463
  138. package/src/token-tracking.ts +167 -167
  139. package/src/tools/blockers.ts +122 -122
  140. package/src/tools/bodies-of-work.ts +283 -283
  141. package/src/tools/chat.ts +72 -46
  142. package/src/tools/cloud-agents.ts +101 -101
  143. package/src/tools/connectors.ts +191 -191
  144. package/src/tools/cost.ts +111 -111
  145. package/src/tools/decisions.ts +111 -111
  146. package/src/tools/deployment.ts +455 -455
  147. package/src/tools/discovery.ts +76 -76
  148. package/src/tools/fallback.ts +111 -111
  149. package/src/tools/features.ts +154 -0
  150. package/src/tools/file-checkouts.ts +145 -145
  151. package/src/tools/findings.ts +101 -101
  152. package/src/tools/git-issues.ts +130 -130
  153. package/src/tools/ideas.ts +162 -162
  154. package/src/tools/index.ts +141 -137
  155. package/src/tools/milestones.ts +118 -118
  156. package/src/tools/organizations.ts +224 -224
  157. package/src/tools/progress.ts +73 -73
  158. package/src/tools/project.ts +206 -202
  159. package/src/tools/requests.ts +68 -68
  160. package/src/tools/roles.ts +112 -112
  161. package/src/tools/session.ts +181 -181
  162. package/src/tools/sprints.ts +298 -298
  163. package/src/tools/tasks.ts +550 -550
  164. package/src/tools/tools.test.ts +222 -222
  165. package/src/tools/types.ts +9 -9
  166. package/src/tools/validation.ts +75 -75
  167. package/src/tools/version.ts +34 -34
  168. package/src/tools/worktrees.ts +66 -66
  169. package/src/tools.test.ts +416 -416
  170. package/src/utils.test.ts +1014 -1014
  171. package/src/utils.ts +586 -586
  172. package/src/validators.test.ts +223 -223
  173. package/src/validators.ts +249 -249
  174. package/src/version.ts +162 -109
  175. package/tsconfig.json +16 -16
  176. package/vitest.config.ts +14 -14
@@ -1,704 +1,704 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import {
3
- createBodyOfWork,
4
- updateBodyOfWork,
5
- getBodyOfWork,
6
- getBodiesOfWork,
7
- deleteBodyOfWork,
8
- addTaskToBodyOfWork,
9
- removeTaskFromBodyOfWork,
10
- activateBodyOfWork,
11
- addTaskDependency,
12
- removeTaskDependency,
13
- getTaskDependencies,
14
- getNextBodyOfWorkTask,
15
- } from './bodies-of-work.js';
16
- import { ValidationError } from '../validators.js';
17
- import { createMockContext } from './__test-utils__.js';
18
- import { mockApiClient } from './__test-setup__.js';
19
-
20
- const VALID_UUID = '123e4567-e89b-12d3-a456-426614174000';
21
- const VALID_UUID_2 = '223e4567-e89b-12d3-a456-426614174001';
22
- const VALID_UUID_3 = '323e4567-e89b-12d3-a456-426614174002';
23
-
24
- // ============================================================================
25
- // createBodyOfWork Tests
26
- // ============================================================================
27
-
28
- describe('createBodyOfWork', () => {
29
- beforeEach(() => vi.clearAllMocks());
30
-
31
- it('should throw error for missing project_id', async () => {
32
- const ctx = createMockContext();
33
- await expect(createBodyOfWork({ title: 'Test' }, ctx)).rejects.toThrow(ValidationError);
34
- });
35
-
36
- it('should throw error for invalid project_id UUID', async () => {
37
- const ctx = createMockContext();
38
- await expect(
39
- createBodyOfWork({ project_id: 'invalid', title: 'Test' }, ctx)
40
- ).rejects.toThrow(ValidationError);
41
- });
42
-
43
- it('should throw error for missing title', async () => {
44
- const ctx = createMockContext();
45
- await expect(
46
- createBodyOfWork({ project_id: VALID_UUID }, ctx)
47
- ).rejects.toThrow(ValidationError);
48
- });
49
-
50
- it('should create body of work with required fields', async () => {
51
- const ctx = createMockContext();
52
- mockApiClient.proxy.mockResolvedValue({
53
- ok: true,
54
- data: { body_of_work_id: 'bow-1' },
55
- });
56
-
57
- const result = await createBodyOfWork(
58
- { project_id: VALID_UUID, title: 'Sprint 1' },
59
- ctx
60
- );
61
-
62
- expect(result.result).toMatchObject({
63
- success: true,
64
- body_of_work_id: 'bow-1',
65
- title: 'Sprint 1',
66
- status: 'draft',
67
- });
68
- expect(mockApiClient.proxy).toHaveBeenCalledWith(
69
- 'create_body_of_work',
70
- expect.objectContaining({
71
- project_id: VALID_UUID,
72
- title: 'Sprint 1',
73
- }),
74
- expect.any(Object)
75
- );
76
- });
77
-
78
- it('should create body of work with all optional fields', async () => {
79
- const ctx = createMockContext();
80
- mockApiClient.proxy.mockResolvedValue({
81
- ok: true,
82
- data: { body_of_work_id: 'bow-2' },
83
- });
84
-
85
- await createBodyOfWork(
86
- {
87
- project_id: VALID_UUID,
88
- title: 'Release 2.0',
89
- description: 'Major release',
90
- auto_deploy_on_completion: true,
91
- deploy_environment: 'staging',
92
- deploy_version_bump: 'major',
93
- deploy_trigger: 'all_completed',
94
- },
95
- ctx
96
- );
97
-
98
- expect(mockApiClient.proxy).toHaveBeenCalledWith(
99
- 'create_body_of_work',
100
- expect.objectContaining({
101
- title: 'Release 2.0',
102
- description: 'Major release',
103
- auto_deploy_on_completion: true,
104
- deploy_environment: 'staging',
105
- deploy_version_bump: 'major',
106
- deploy_trigger: 'all_completed',
107
- }),
108
- expect.any(Object)
109
- );
110
- });
111
-
112
- it('should return error when API call fails', async () => {
113
- const ctx = createMockContext();
114
- mockApiClient.proxy.mockResolvedValue({
115
- ok: false,
116
- error: 'Insert failed',
117
- });
118
-
119
- const result = await createBodyOfWork({ project_id: VALID_UUID, title: 'Test' }, ctx);
120
-
121
- expect(result.isError).toBe(true);
122
- expect(result.result).toMatchObject({
123
- error: 'Insert failed',
124
- });
125
- });
126
- });
127
-
128
- // ============================================================================
129
- // updateBodyOfWork Tests
130
- // ============================================================================
131
-
132
- describe('updateBodyOfWork', () => {
133
- beforeEach(() => vi.clearAllMocks());
134
-
135
- it('should throw error for missing body_of_work_id', async () => {
136
- const ctx = createMockContext();
137
- await expect(updateBodyOfWork({}, ctx)).rejects.toThrow(ValidationError);
138
- });
139
-
140
- it('should return success when no updates provided', async () => {
141
- const ctx = createMockContext();
142
- const result = await updateBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
143
-
144
- expect(result.result).toMatchObject({
145
- success: true,
146
- message: 'No updates provided',
147
- });
148
- expect(mockApiClient.proxy).not.toHaveBeenCalled();
149
- });
150
-
151
- it('should update title', async () => {
152
- const ctx = createMockContext();
153
- mockApiClient.proxy.mockResolvedValue({
154
- ok: true,
155
- data: { success: true },
156
- });
157
-
158
- const result = await updateBodyOfWork(
159
- { body_of_work_id: VALID_UUID, title: 'New Title' },
160
- ctx
161
- );
162
-
163
- expect(result.result).toMatchObject({ success: true, body_of_work_id: VALID_UUID });
164
- expect(mockApiClient.proxy).toHaveBeenCalledWith('update_body_of_work', expect.objectContaining({
165
- body_of_work_id: VALID_UUID,
166
- title: 'New Title',
167
- }));
168
- });
169
-
170
- it('should update multiple fields', async () => {
171
- const ctx = createMockContext();
172
- mockApiClient.proxy.mockResolvedValue({
173
- ok: true,
174
- data: { success: true },
175
- });
176
-
177
- await updateBodyOfWork(
178
- {
179
- body_of_work_id: VALID_UUID,
180
- title: 'Updated',
181
- description: 'New desc',
182
- auto_deploy_on_completion: true,
183
- },
184
- ctx
185
- );
186
-
187
- expect(mockApiClient.proxy).toHaveBeenCalledWith('update_body_of_work', expect.objectContaining({
188
- title: 'Updated',
189
- description: 'New desc',
190
- auto_deploy_on_completion: true,
191
- }));
192
- });
193
- });
194
-
195
- // ============================================================================
196
- // getBodyOfWork Tests
197
- // ============================================================================
198
-
199
- describe('getBodyOfWork', () => {
200
- beforeEach(() => vi.clearAllMocks());
201
-
202
- it('should throw error for missing body_of_work_id', async () => {
203
- const ctx = createMockContext();
204
- await expect(getBodyOfWork({}, ctx)).rejects.toThrow(ValidationError);
205
- });
206
-
207
- it('should return error when body of work not found', async () => {
208
- const ctx = createMockContext();
209
- mockApiClient.proxy.mockResolvedValue({
210
- ok: false,
211
- error: 'Not found',
212
- });
213
-
214
- const result = await getBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
215
-
216
- expect(result.isError).toBe(true);
217
- expect(result.result).toMatchObject({
218
- error: 'Not found',
219
- });
220
- });
221
-
222
- it('should return body of work with tasks organized by phase', async () => {
223
- const ctx = createMockContext();
224
- mockApiClient.proxy.mockResolvedValue({
225
- ok: true,
226
- data: {
227
- id: 'bow-1',
228
- title: 'Sprint 1',
229
- status: 'active',
230
- pre_tasks: [{ id: 't1', title: 'Setup' }],
231
- core_tasks: [{ id: 't2', title: 'Feature A' }],
232
- post_tasks: [{ id: 't3', title: 'Cleanup' }],
233
- total_tasks: 3,
234
- completed_tasks: 1,
235
- progress_percentage: 33,
236
- },
237
- });
238
-
239
- const result = await getBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
240
-
241
- expect(result.result).toHaveProperty('pre_tasks');
242
- expect(result.result).toHaveProperty('core_tasks');
243
- expect(result.result).toHaveProperty('post_tasks');
244
- expect(result.result).toHaveProperty('total_tasks');
245
- });
246
- });
247
-
248
- // ============================================================================
249
- // getBodiesOfWork Tests
250
- // ============================================================================
251
-
252
- describe('getBodiesOfWork', () => {
253
- beforeEach(() => vi.clearAllMocks());
254
-
255
- it('should throw error for missing project_id', async () => {
256
- const ctx = createMockContext();
257
- await expect(getBodiesOfWork({}, ctx)).rejects.toThrow(ValidationError);
258
- });
259
-
260
- it('should return empty array when no bodies of work exist', async () => {
261
- const ctx = createMockContext();
262
- mockApiClient.proxy.mockResolvedValue({
263
- ok: true,
264
- data: { bodies_of_work: [], total_count: 0 },
265
- });
266
-
267
- const result = await getBodiesOfWork({ project_id: VALID_UUID }, ctx);
268
-
269
- expect(result.result).toMatchObject({ bodies_of_work: [] });
270
- });
271
-
272
- it('should filter by status when provided', async () => {
273
- const ctx = createMockContext();
274
- mockApiClient.proxy.mockResolvedValue({
275
- ok: true,
276
- data: { bodies_of_work: [], total_count: 0 },
277
- });
278
-
279
- await getBodiesOfWork({ project_id: VALID_UUID, status: 'active' }, ctx);
280
-
281
- expect(mockApiClient.proxy).toHaveBeenCalledWith('get_bodies_of_work', expect.objectContaining({
282
- project_id: VALID_UUID,
283
- status: 'active',
284
- }));
285
- });
286
- });
287
-
288
- // ============================================================================
289
- // deleteBodyOfWork Tests
290
- // ============================================================================
291
-
292
- describe('deleteBodyOfWork', () => {
293
- beforeEach(() => vi.clearAllMocks());
294
-
295
- it('should throw error for missing body_of_work_id', async () => {
296
- const ctx = createMockContext();
297
- await expect(deleteBodyOfWork({}, ctx)).rejects.toThrow(ValidationError);
298
- });
299
-
300
- it('should delete body of work successfully', async () => {
301
- const ctx = createMockContext();
302
- mockApiClient.proxy.mockResolvedValue({
303
- ok: true,
304
- data: { success: true },
305
- });
306
-
307
- const result = await deleteBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
308
-
309
- expect(result.result).toMatchObject({
310
- success: true,
311
- message: 'Body of work deleted. Tasks are preserved.',
312
- });
313
- expect(mockApiClient.proxy).toHaveBeenCalledWith('delete_body_of_work', expect.objectContaining({
314
- body_of_work_id: VALID_UUID,
315
- }));
316
- });
317
- });
318
-
319
- // ============================================================================
320
- // addTaskToBodyOfWork Tests
321
- // ============================================================================
322
-
323
- describe('addTaskToBodyOfWork', () => {
324
- beforeEach(() => vi.clearAllMocks());
325
-
326
- it('should throw error for missing body_of_work_id', async () => {
327
- const ctx = createMockContext();
328
- await expect(
329
- addTaskToBodyOfWork({ task_id: VALID_UUID }, ctx)
330
- ).rejects.toThrow(ValidationError);
331
- });
332
-
333
- it('should throw error for missing task_id', async () => {
334
- const ctx = createMockContext();
335
- await expect(
336
- addTaskToBodyOfWork({ body_of_work_id: VALID_UUID }, ctx)
337
- ).rejects.toThrow(ValidationError);
338
- });
339
-
340
- it('should return error when API returns error', async () => {
341
- const ctx = createMockContext();
342
- mockApiClient.proxy.mockResolvedValue({
343
- ok: false,
344
- error: 'Body of work not found',
345
- });
346
-
347
- const result = await addTaskToBodyOfWork({ body_of_work_id: VALID_UUID, task_id: VALID_UUID_2 }, ctx);
348
-
349
- expect(result.isError).toBe(true);
350
- expect(result.result).toMatchObject({
351
- error: 'Body of work not found',
352
- });
353
- });
354
-
355
- it('should add task with default phase "core"', async () => {
356
- const ctx = createMockContext();
357
- mockApiClient.proxy.mockResolvedValue({
358
- ok: true,
359
- data: {
360
- success: true,
361
- body_of_work_id: VALID_UUID,
362
- task_id: VALID_UUID_2,
363
- phase: 'core',
364
- order_index: 0,
365
- },
366
- });
367
-
368
- const result = await addTaskToBodyOfWork(
369
- { body_of_work_id: VALID_UUID, task_id: VALID_UUID_2 },
370
- ctx
371
- );
372
-
373
- expect(result.result).toMatchObject({
374
- success: true,
375
- body_of_work_id: VALID_UUID,
376
- task_id: VALID_UUID_2,
377
- phase: 'core',
378
- order_index: 0,
379
- });
380
- });
381
-
382
- it('should add task with specified phase', async () => {
383
- const ctx = createMockContext();
384
- mockApiClient.proxy.mockResolvedValue({
385
- ok: true,
386
- data: {
387
- body_of_work_id: VALID_UUID,
388
- task_id: VALID_UUID_2,
389
- phase: 'pre',
390
- order_index: 0,
391
- },
392
- });
393
-
394
- await addTaskToBodyOfWork(
395
- { body_of_work_id: VALID_UUID, task_id: VALID_UUID_2, phase: 'pre' },
396
- ctx
397
- );
398
-
399
- expect(mockApiClient.proxy).toHaveBeenCalledWith('add_task_to_body_of_work', expect.objectContaining({
400
- body_of_work_id: VALID_UUID,
401
- task_id: VALID_UUID_2,
402
- phase: 'pre',
403
- }));
404
- });
405
- });
406
-
407
- // ============================================================================
408
- // removeTaskFromBodyOfWork Tests
409
- // ============================================================================
410
-
411
- describe('removeTaskFromBodyOfWork', () => {
412
- beforeEach(() => vi.clearAllMocks());
413
-
414
- it('should throw error for missing task_id', async () => {
415
- const ctx = createMockContext();
416
- await expect(removeTaskFromBodyOfWork({}, ctx)).rejects.toThrow(ValidationError);
417
- });
418
-
419
- it('should remove task successfully', async () => {
420
- const ctx = createMockContext();
421
- mockApiClient.proxy.mockResolvedValue({
422
- ok: true,
423
- data: { success: true },
424
- });
425
-
426
- const result = await removeTaskFromBodyOfWork({ task_id: VALID_UUID }, ctx);
427
-
428
- expect(result.result).toMatchObject({ success: true });
429
- expect(mockApiClient.proxy).toHaveBeenCalledWith('remove_task_from_body_of_work', expect.objectContaining({
430
- task_id: VALID_UUID,
431
- }));
432
- });
433
- });
434
-
435
- // ============================================================================
436
- // activateBodyOfWork Tests
437
- // ============================================================================
438
-
439
- describe('activateBodyOfWork', () => {
440
- beforeEach(() => vi.clearAllMocks());
441
-
442
- it('should throw error for missing body_of_work_id', async () => {
443
- const ctx = createMockContext();
444
- await expect(activateBodyOfWork({}, ctx)).rejects.toThrow(ValidationError);
445
- });
446
-
447
- it('should return error when API returns error', async () => {
448
- const ctx = createMockContext();
449
- mockApiClient.proxy.mockResolvedValue({
450
- ok: false,
451
- error: 'Body of work not found',
452
- });
453
-
454
- const result = await activateBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
455
-
456
- expect(result.isError).toBe(true);
457
- expect(result.result).toMatchObject({
458
- error: 'Body of work not found',
459
- });
460
- });
461
-
462
- it('should activate body of work successfully', async () => {
463
- const ctx = createMockContext();
464
- mockApiClient.proxy.mockResolvedValue({
465
- ok: true,
466
- data: {
467
- success: true,
468
- body_of_work_id: VALID_UUID,
469
- title: 'Sprint 1',
470
- status: 'active',
471
- },
472
- });
473
-
474
- const result = await activateBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
475
-
476
- expect(result.result).toMatchObject({
477
- success: true,
478
- body_of_work_id: VALID_UUID,
479
- title: 'Sprint 1',
480
- status: 'active',
481
- });
482
- });
483
- });
484
-
485
- // ============================================================================
486
- // addTaskDependency Tests
487
- // ============================================================================
488
-
489
- describe('addTaskDependency', () => {
490
- beforeEach(() => vi.clearAllMocks());
491
-
492
- it('should throw error for missing body_of_work_id', async () => {
493
- const ctx = createMockContext();
494
- await expect(
495
- addTaskDependency({ task_id: VALID_UUID, depends_on_task_id: VALID_UUID_2 }, ctx)
496
- ).rejects.toThrow(ValidationError);
497
- });
498
-
499
- it('should return error when task depends on itself', async () => {
500
- const ctx = createMockContext();
501
-
502
- const result = await addTaskDependency({
503
- body_of_work_id: VALID_UUID,
504
- task_id: VALID_UUID_2,
505
- depends_on_task_id: VALID_UUID_2,
506
- }, ctx);
507
-
508
- expect(result.isError).toBe(true);
509
- expect(result.result).toMatchObject({
510
- error: 'A task cannot depend on itself',
511
- });
512
- });
513
-
514
- it('should add dependency successfully', async () => {
515
- const ctx = createMockContext();
516
- mockApiClient.proxy.mockResolvedValue({
517
- ok: true,
518
- data: {
519
- success: true,
520
- task_id: VALID_UUID_2,
521
- depends_on_task_id: VALID_UUID_3,
522
- },
523
- });
524
-
525
- const result = await addTaskDependency({
526
- body_of_work_id: VALID_UUID,
527
- task_id: VALID_UUID_2,
528
- depends_on_task_id: VALID_UUID_3,
529
- }, ctx);
530
-
531
- expect(result.result).toMatchObject({
532
- success: true,
533
- task_id: VALID_UUID_2,
534
- depends_on_task_id: VALID_UUID_3,
535
- });
536
- });
537
- });
538
-
539
- // ============================================================================
540
- // removeTaskDependency Tests
541
- // ============================================================================
542
-
543
- describe('removeTaskDependency', () => {
544
- beforeEach(() => vi.clearAllMocks());
545
-
546
- it('should throw error for missing task_id', async () => {
547
- const ctx = createMockContext();
548
- await expect(
549
- removeTaskDependency({ depends_on_task_id: VALID_UUID }, ctx)
550
- ).rejects.toThrow(ValidationError);
551
- });
552
-
553
- it('should throw error for missing depends_on_task_id', async () => {
554
- const ctx = createMockContext();
555
- await expect(
556
- removeTaskDependency({ task_id: VALID_UUID }, ctx)
557
- ).rejects.toThrow(ValidationError);
558
- });
559
-
560
- it('should remove dependency successfully', async () => {
561
- const ctx = createMockContext();
562
- mockApiClient.proxy.mockResolvedValue({
563
- ok: true,
564
- data: {
565
- success: true,
566
- task_id: VALID_UUID,
567
- depends_on_task_id: VALID_UUID_2,
568
- },
569
- });
570
-
571
- const result = await removeTaskDependency(
572
- { task_id: VALID_UUID, depends_on_task_id: VALID_UUID_2 },
573
- ctx
574
- );
575
-
576
- expect(result.result).toMatchObject({
577
- success: true,
578
- task_id: VALID_UUID,
579
- depends_on_task_id: VALID_UUID_2,
580
- });
581
- });
582
- });
583
-
584
- // ============================================================================
585
- // getTaskDependencies Tests
586
- // ============================================================================
587
-
588
- describe('getTaskDependencies', () => {
589
- beforeEach(() => vi.clearAllMocks());
590
-
591
- it('should return error when neither body_of_work_id nor task_id provided', async () => {
592
- const ctx = createMockContext();
593
-
594
- const result = await getTaskDependencies({}, ctx);
595
-
596
- expect(result.isError).toBe(true);
597
- expect(result.result).toMatchObject({
598
- error: 'Either body_of_work_id or task_id is required',
599
- });
600
- });
601
-
602
- it('should return dependencies filtered by body_of_work_id', async () => {
603
- const mockDeps = [
604
- { id: 'd1', task_id: 't1', depends_on_task_id: 't2', created_at: '2026-01-14' },
605
- ];
606
-
607
- const ctx = createMockContext();
608
- mockApiClient.proxy.mockResolvedValue({
609
- ok: true,
610
- data: { dependencies: mockDeps },
611
- });
612
-
613
- const result = await getTaskDependencies({ body_of_work_id: VALID_UUID }, ctx);
614
-
615
- expect(result.result).toMatchObject({ dependencies: mockDeps });
616
- expect(mockApiClient.proxy).toHaveBeenCalledWith('get_task_dependencies', expect.objectContaining({
617
- body_of_work_id: VALID_UUID,
618
- }));
619
- });
620
-
621
- it('should return dependencies filtered by task_id', async () => {
622
- const ctx = createMockContext();
623
- mockApiClient.proxy.mockResolvedValue({
624
- ok: true,
625
- data: { dependencies: [] },
626
- });
627
-
628
- const result = await getTaskDependencies({ task_id: VALID_UUID }, ctx);
629
-
630
- expect(result.result).toMatchObject({ dependencies: [] });
631
- expect(mockApiClient.proxy).toHaveBeenCalledWith('get_task_dependencies', expect.objectContaining({
632
- task_id: VALID_UUID,
633
- }));
634
- });
635
- });
636
-
637
- // ============================================================================
638
- // getNextBodyOfWorkTask Tests
639
- // ============================================================================
640
-
641
- describe('getNextBodyOfWorkTask', () => {
642
- beforeEach(() => vi.clearAllMocks());
643
-
644
- it('should throw error for missing body_of_work_id', async () => {
645
- const ctx = createMockContext();
646
- await expect(getNextBodyOfWorkTask({}, ctx)).rejects.toThrow(ValidationError);
647
- });
648
-
649
- it('should return error when API returns error', async () => {
650
- const ctx = createMockContext();
651
- mockApiClient.proxy.mockResolvedValue({
652
- ok: false,
653
- error: 'Body of work not found',
654
- });
655
-
656
- const result = await getNextBodyOfWorkTask({ body_of_work_id: VALID_UUID }, ctx);
657
-
658
- expect(result.isError).toBe(true);
659
- expect(result.result).toMatchObject({
660
- error: 'Body of work not found',
661
- });
662
- });
663
-
664
- it('should return null when no tasks available', async () => {
665
- const ctx = createMockContext();
666
- mockApiClient.proxy.mockResolvedValue({
667
- ok: true,
668
- data: {
669
- next_task: null,
670
- message: 'No available tasks',
671
- },
672
- });
673
-
674
- const result = await getNextBodyOfWorkTask({ body_of_work_id: VALID_UUID }, ctx);
675
-
676
- expect(result.result).toMatchObject({
677
- next_task: null,
678
- message: 'No available tasks',
679
- });
680
- });
681
-
682
- it('should return next pending task', async () => {
683
- const ctx = createMockContext();
684
- mockApiClient.proxy.mockResolvedValue({
685
- ok: true,
686
- data: {
687
- next_task: {
688
- id: 't1',
689
- title: 'Setup',
690
- phase: 'pre',
691
- status: 'pending',
692
- },
693
- message: 'Task available',
694
- },
695
- });
696
-
697
- const result = await getNextBodyOfWorkTask({ body_of_work_id: VALID_UUID }, ctx);
698
-
699
- expect(result.result).toHaveProperty('next_task');
700
- const nextTask = (result.result as { next_task: { id: string; phase: string } }).next_task;
701
- expect(nextTask.id).toBe('t1');
702
- expect(nextTask.phase).toBe('pre');
703
- });
704
- });
1
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
2
+ import {
3
+ createBodyOfWork,
4
+ updateBodyOfWork,
5
+ getBodyOfWork,
6
+ getBodiesOfWork,
7
+ deleteBodyOfWork,
8
+ addTaskToBodyOfWork,
9
+ removeTaskFromBodyOfWork,
10
+ activateBodyOfWork,
11
+ addTaskDependency,
12
+ removeTaskDependency,
13
+ getTaskDependencies,
14
+ getNextBodyOfWorkTask,
15
+ } from './bodies-of-work.js';
16
+ import { ValidationError } from '../validators.js';
17
+ import { createMockContext } from './__test-utils__.js';
18
+ import { mockApiClient } from './__test-setup__.js';
19
+
20
+ const VALID_UUID = '123e4567-e89b-12d3-a456-426614174000';
21
+ const VALID_UUID_2 = '223e4567-e89b-12d3-a456-426614174001';
22
+ const VALID_UUID_3 = '323e4567-e89b-12d3-a456-426614174002';
23
+
24
+ // ============================================================================
25
+ // createBodyOfWork Tests
26
+ // ============================================================================
27
+
28
+ describe('createBodyOfWork', () => {
29
+ beforeEach(() => vi.clearAllMocks());
30
+
31
+ it('should throw error for missing project_id', async () => {
32
+ const ctx = createMockContext();
33
+ await expect(createBodyOfWork({ title: 'Test' }, ctx)).rejects.toThrow(ValidationError);
34
+ });
35
+
36
+ it('should throw error for invalid project_id UUID', async () => {
37
+ const ctx = createMockContext();
38
+ await expect(
39
+ createBodyOfWork({ project_id: 'invalid', title: 'Test' }, ctx)
40
+ ).rejects.toThrow(ValidationError);
41
+ });
42
+
43
+ it('should throw error for missing title', async () => {
44
+ const ctx = createMockContext();
45
+ await expect(
46
+ createBodyOfWork({ project_id: VALID_UUID }, ctx)
47
+ ).rejects.toThrow(ValidationError);
48
+ });
49
+
50
+ it('should create body of work with required fields', async () => {
51
+ const ctx = createMockContext();
52
+ mockApiClient.proxy.mockResolvedValue({
53
+ ok: true,
54
+ data: { body_of_work_id: 'bow-1' },
55
+ });
56
+
57
+ const result = await createBodyOfWork(
58
+ { project_id: VALID_UUID, title: 'Sprint 1' },
59
+ ctx
60
+ );
61
+
62
+ expect(result.result).toMatchObject({
63
+ success: true,
64
+ body_of_work_id: 'bow-1',
65
+ title: 'Sprint 1',
66
+ status: 'draft',
67
+ });
68
+ expect(mockApiClient.proxy).toHaveBeenCalledWith(
69
+ 'create_body_of_work',
70
+ expect.objectContaining({
71
+ project_id: VALID_UUID,
72
+ title: 'Sprint 1',
73
+ }),
74
+ expect.any(Object)
75
+ );
76
+ });
77
+
78
+ it('should create body of work with all optional fields', async () => {
79
+ const ctx = createMockContext();
80
+ mockApiClient.proxy.mockResolvedValue({
81
+ ok: true,
82
+ data: { body_of_work_id: 'bow-2' },
83
+ });
84
+
85
+ await createBodyOfWork(
86
+ {
87
+ project_id: VALID_UUID,
88
+ title: 'Release 2.0',
89
+ description: 'Major release',
90
+ auto_deploy_on_completion: true,
91
+ deploy_environment: 'staging',
92
+ deploy_version_bump: 'major',
93
+ deploy_trigger: 'all_completed',
94
+ },
95
+ ctx
96
+ );
97
+
98
+ expect(mockApiClient.proxy).toHaveBeenCalledWith(
99
+ 'create_body_of_work',
100
+ expect.objectContaining({
101
+ title: 'Release 2.0',
102
+ description: 'Major release',
103
+ auto_deploy_on_completion: true,
104
+ deploy_environment: 'staging',
105
+ deploy_version_bump: 'major',
106
+ deploy_trigger: 'all_completed',
107
+ }),
108
+ expect.any(Object)
109
+ );
110
+ });
111
+
112
+ it('should return error when API call fails', async () => {
113
+ const ctx = createMockContext();
114
+ mockApiClient.proxy.mockResolvedValue({
115
+ ok: false,
116
+ error: 'Insert failed',
117
+ });
118
+
119
+ const result = await createBodyOfWork({ project_id: VALID_UUID, title: 'Test' }, ctx);
120
+
121
+ expect(result.isError).toBe(true);
122
+ expect(result.result).toMatchObject({
123
+ error: 'Insert failed',
124
+ });
125
+ });
126
+ });
127
+
128
+ // ============================================================================
129
+ // updateBodyOfWork Tests
130
+ // ============================================================================
131
+
132
+ describe('updateBodyOfWork', () => {
133
+ beforeEach(() => vi.clearAllMocks());
134
+
135
+ it('should throw error for missing body_of_work_id', async () => {
136
+ const ctx = createMockContext();
137
+ await expect(updateBodyOfWork({}, ctx)).rejects.toThrow(ValidationError);
138
+ });
139
+
140
+ it('should return success when no updates provided', async () => {
141
+ const ctx = createMockContext();
142
+ const result = await updateBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
143
+
144
+ expect(result.result).toMatchObject({
145
+ success: true,
146
+ message: 'No updates provided',
147
+ });
148
+ expect(mockApiClient.proxy).not.toHaveBeenCalled();
149
+ });
150
+
151
+ it('should update title', async () => {
152
+ const ctx = createMockContext();
153
+ mockApiClient.proxy.mockResolvedValue({
154
+ ok: true,
155
+ data: { success: true },
156
+ });
157
+
158
+ const result = await updateBodyOfWork(
159
+ { body_of_work_id: VALID_UUID, title: 'New Title' },
160
+ ctx
161
+ );
162
+
163
+ expect(result.result).toMatchObject({ success: true, body_of_work_id: VALID_UUID });
164
+ expect(mockApiClient.proxy).toHaveBeenCalledWith('update_body_of_work', expect.objectContaining({
165
+ body_of_work_id: VALID_UUID,
166
+ title: 'New Title',
167
+ }));
168
+ });
169
+
170
+ it('should update multiple fields', async () => {
171
+ const ctx = createMockContext();
172
+ mockApiClient.proxy.mockResolvedValue({
173
+ ok: true,
174
+ data: { success: true },
175
+ });
176
+
177
+ await updateBodyOfWork(
178
+ {
179
+ body_of_work_id: VALID_UUID,
180
+ title: 'Updated',
181
+ description: 'New desc',
182
+ auto_deploy_on_completion: true,
183
+ },
184
+ ctx
185
+ );
186
+
187
+ expect(mockApiClient.proxy).toHaveBeenCalledWith('update_body_of_work', expect.objectContaining({
188
+ title: 'Updated',
189
+ description: 'New desc',
190
+ auto_deploy_on_completion: true,
191
+ }));
192
+ });
193
+ });
194
+
195
+ // ============================================================================
196
+ // getBodyOfWork Tests
197
+ // ============================================================================
198
+
199
+ describe('getBodyOfWork', () => {
200
+ beforeEach(() => vi.clearAllMocks());
201
+
202
+ it('should throw error for missing body_of_work_id', async () => {
203
+ const ctx = createMockContext();
204
+ await expect(getBodyOfWork({}, ctx)).rejects.toThrow(ValidationError);
205
+ });
206
+
207
+ it('should return error when body of work not found', async () => {
208
+ const ctx = createMockContext();
209
+ mockApiClient.proxy.mockResolvedValue({
210
+ ok: false,
211
+ error: 'Not found',
212
+ });
213
+
214
+ const result = await getBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
215
+
216
+ expect(result.isError).toBe(true);
217
+ expect(result.result).toMatchObject({
218
+ error: 'Not found',
219
+ });
220
+ });
221
+
222
+ it('should return body of work with tasks organized by phase', async () => {
223
+ const ctx = createMockContext();
224
+ mockApiClient.proxy.mockResolvedValue({
225
+ ok: true,
226
+ data: {
227
+ id: 'bow-1',
228
+ title: 'Sprint 1',
229
+ status: 'active',
230
+ pre_tasks: [{ id: 't1', title: 'Setup' }],
231
+ core_tasks: [{ id: 't2', title: 'Feature A' }],
232
+ post_tasks: [{ id: 't3', title: 'Cleanup' }],
233
+ total_tasks: 3,
234
+ completed_tasks: 1,
235
+ progress_percentage: 33,
236
+ },
237
+ });
238
+
239
+ const result = await getBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
240
+
241
+ expect(result.result).toHaveProperty('pre_tasks');
242
+ expect(result.result).toHaveProperty('core_tasks');
243
+ expect(result.result).toHaveProperty('post_tasks');
244
+ expect(result.result).toHaveProperty('total_tasks');
245
+ });
246
+ });
247
+
248
+ // ============================================================================
249
+ // getBodiesOfWork Tests
250
+ // ============================================================================
251
+
252
+ describe('getBodiesOfWork', () => {
253
+ beforeEach(() => vi.clearAllMocks());
254
+
255
+ it('should throw error for missing project_id', async () => {
256
+ const ctx = createMockContext();
257
+ await expect(getBodiesOfWork({}, ctx)).rejects.toThrow(ValidationError);
258
+ });
259
+
260
+ it('should return empty array when no bodies of work exist', async () => {
261
+ const ctx = createMockContext();
262
+ mockApiClient.proxy.mockResolvedValue({
263
+ ok: true,
264
+ data: { bodies_of_work: [], total_count: 0 },
265
+ });
266
+
267
+ const result = await getBodiesOfWork({ project_id: VALID_UUID }, ctx);
268
+
269
+ expect(result.result).toMatchObject({ bodies_of_work: [] });
270
+ });
271
+
272
+ it('should filter by status when provided', async () => {
273
+ const ctx = createMockContext();
274
+ mockApiClient.proxy.mockResolvedValue({
275
+ ok: true,
276
+ data: { bodies_of_work: [], total_count: 0 },
277
+ });
278
+
279
+ await getBodiesOfWork({ project_id: VALID_UUID, status: 'active' }, ctx);
280
+
281
+ expect(mockApiClient.proxy).toHaveBeenCalledWith('get_bodies_of_work', expect.objectContaining({
282
+ project_id: VALID_UUID,
283
+ status: 'active',
284
+ }));
285
+ });
286
+ });
287
+
288
+ // ============================================================================
289
+ // deleteBodyOfWork Tests
290
+ // ============================================================================
291
+
292
+ describe('deleteBodyOfWork', () => {
293
+ beforeEach(() => vi.clearAllMocks());
294
+
295
+ it('should throw error for missing body_of_work_id', async () => {
296
+ const ctx = createMockContext();
297
+ await expect(deleteBodyOfWork({}, ctx)).rejects.toThrow(ValidationError);
298
+ });
299
+
300
+ it('should delete body of work successfully', async () => {
301
+ const ctx = createMockContext();
302
+ mockApiClient.proxy.mockResolvedValue({
303
+ ok: true,
304
+ data: { success: true },
305
+ });
306
+
307
+ const result = await deleteBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
308
+
309
+ expect(result.result).toMatchObject({
310
+ success: true,
311
+ message: 'Body of work deleted. Tasks are preserved.',
312
+ });
313
+ expect(mockApiClient.proxy).toHaveBeenCalledWith('delete_body_of_work', expect.objectContaining({
314
+ body_of_work_id: VALID_UUID,
315
+ }));
316
+ });
317
+ });
318
+
319
+ // ============================================================================
320
+ // addTaskToBodyOfWork Tests
321
+ // ============================================================================
322
+
323
+ describe('addTaskToBodyOfWork', () => {
324
+ beforeEach(() => vi.clearAllMocks());
325
+
326
+ it('should throw error for missing body_of_work_id', async () => {
327
+ const ctx = createMockContext();
328
+ await expect(
329
+ addTaskToBodyOfWork({ task_id: VALID_UUID }, ctx)
330
+ ).rejects.toThrow(ValidationError);
331
+ });
332
+
333
+ it('should throw error for missing task_id', async () => {
334
+ const ctx = createMockContext();
335
+ await expect(
336
+ addTaskToBodyOfWork({ body_of_work_id: VALID_UUID }, ctx)
337
+ ).rejects.toThrow(ValidationError);
338
+ });
339
+
340
+ it('should return error when API returns error', async () => {
341
+ const ctx = createMockContext();
342
+ mockApiClient.proxy.mockResolvedValue({
343
+ ok: false,
344
+ error: 'Body of work not found',
345
+ });
346
+
347
+ const result = await addTaskToBodyOfWork({ body_of_work_id: VALID_UUID, task_id: VALID_UUID_2 }, ctx);
348
+
349
+ expect(result.isError).toBe(true);
350
+ expect(result.result).toMatchObject({
351
+ error: 'Body of work not found',
352
+ });
353
+ });
354
+
355
+ it('should add task with default phase "core"', async () => {
356
+ const ctx = createMockContext();
357
+ mockApiClient.proxy.mockResolvedValue({
358
+ ok: true,
359
+ data: {
360
+ success: true,
361
+ body_of_work_id: VALID_UUID,
362
+ task_id: VALID_UUID_2,
363
+ phase: 'core',
364
+ order_index: 0,
365
+ },
366
+ });
367
+
368
+ const result = await addTaskToBodyOfWork(
369
+ { body_of_work_id: VALID_UUID, task_id: VALID_UUID_2 },
370
+ ctx
371
+ );
372
+
373
+ expect(result.result).toMatchObject({
374
+ success: true,
375
+ body_of_work_id: VALID_UUID,
376
+ task_id: VALID_UUID_2,
377
+ phase: 'core',
378
+ order_index: 0,
379
+ });
380
+ });
381
+
382
+ it('should add task with specified phase', async () => {
383
+ const ctx = createMockContext();
384
+ mockApiClient.proxy.mockResolvedValue({
385
+ ok: true,
386
+ data: {
387
+ body_of_work_id: VALID_UUID,
388
+ task_id: VALID_UUID_2,
389
+ phase: 'pre',
390
+ order_index: 0,
391
+ },
392
+ });
393
+
394
+ await addTaskToBodyOfWork(
395
+ { body_of_work_id: VALID_UUID, task_id: VALID_UUID_2, phase: 'pre' },
396
+ ctx
397
+ );
398
+
399
+ expect(mockApiClient.proxy).toHaveBeenCalledWith('add_task_to_body_of_work', expect.objectContaining({
400
+ body_of_work_id: VALID_UUID,
401
+ task_id: VALID_UUID_2,
402
+ phase: 'pre',
403
+ }));
404
+ });
405
+ });
406
+
407
+ // ============================================================================
408
+ // removeTaskFromBodyOfWork Tests
409
+ // ============================================================================
410
+
411
+ describe('removeTaskFromBodyOfWork', () => {
412
+ beforeEach(() => vi.clearAllMocks());
413
+
414
+ it('should throw error for missing task_id', async () => {
415
+ const ctx = createMockContext();
416
+ await expect(removeTaskFromBodyOfWork({}, ctx)).rejects.toThrow(ValidationError);
417
+ });
418
+
419
+ it('should remove task successfully', async () => {
420
+ const ctx = createMockContext();
421
+ mockApiClient.proxy.mockResolvedValue({
422
+ ok: true,
423
+ data: { success: true },
424
+ });
425
+
426
+ const result = await removeTaskFromBodyOfWork({ task_id: VALID_UUID }, ctx);
427
+
428
+ expect(result.result).toMatchObject({ success: true });
429
+ expect(mockApiClient.proxy).toHaveBeenCalledWith('remove_task_from_body_of_work', expect.objectContaining({
430
+ task_id: VALID_UUID,
431
+ }));
432
+ });
433
+ });
434
+
435
+ // ============================================================================
436
+ // activateBodyOfWork Tests
437
+ // ============================================================================
438
+
439
+ describe('activateBodyOfWork', () => {
440
+ beforeEach(() => vi.clearAllMocks());
441
+
442
+ it('should throw error for missing body_of_work_id', async () => {
443
+ const ctx = createMockContext();
444
+ await expect(activateBodyOfWork({}, ctx)).rejects.toThrow(ValidationError);
445
+ });
446
+
447
+ it('should return error when API returns error', async () => {
448
+ const ctx = createMockContext();
449
+ mockApiClient.proxy.mockResolvedValue({
450
+ ok: false,
451
+ error: 'Body of work not found',
452
+ });
453
+
454
+ const result = await activateBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
455
+
456
+ expect(result.isError).toBe(true);
457
+ expect(result.result).toMatchObject({
458
+ error: 'Body of work not found',
459
+ });
460
+ });
461
+
462
+ it('should activate body of work successfully', async () => {
463
+ const ctx = createMockContext();
464
+ mockApiClient.proxy.mockResolvedValue({
465
+ ok: true,
466
+ data: {
467
+ success: true,
468
+ body_of_work_id: VALID_UUID,
469
+ title: 'Sprint 1',
470
+ status: 'active',
471
+ },
472
+ });
473
+
474
+ const result = await activateBodyOfWork({ body_of_work_id: VALID_UUID }, ctx);
475
+
476
+ expect(result.result).toMatchObject({
477
+ success: true,
478
+ body_of_work_id: VALID_UUID,
479
+ title: 'Sprint 1',
480
+ status: 'active',
481
+ });
482
+ });
483
+ });
484
+
485
+ // ============================================================================
486
+ // addTaskDependency Tests
487
+ // ============================================================================
488
+
489
+ describe('addTaskDependency', () => {
490
+ beforeEach(() => vi.clearAllMocks());
491
+
492
+ it('should throw error for missing body_of_work_id', async () => {
493
+ const ctx = createMockContext();
494
+ await expect(
495
+ addTaskDependency({ task_id: VALID_UUID, depends_on_task_id: VALID_UUID_2 }, ctx)
496
+ ).rejects.toThrow(ValidationError);
497
+ });
498
+
499
+ it('should return error when task depends on itself', async () => {
500
+ const ctx = createMockContext();
501
+
502
+ const result = await addTaskDependency({
503
+ body_of_work_id: VALID_UUID,
504
+ task_id: VALID_UUID_2,
505
+ depends_on_task_id: VALID_UUID_2,
506
+ }, ctx);
507
+
508
+ expect(result.isError).toBe(true);
509
+ expect(result.result).toMatchObject({
510
+ error: 'A task cannot depend on itself',
511
+ });
512
+ });
513
+
514
+ it('should add dependency successfully', async () => {
515
+ const ctx = createMockContext();
516
+ mockApiClient.proxy.mockResolvedValue({
517
+ ok: true,
518
+ data: {
519
+ success: true,
520
+ task_id: VALID_UUID_2,
521
+ depends_on_task_id: VALID_UUID_3,
522
+ },
523
+ });
524
+
525
+ const result = await addTaskDependency({
526
+ body_of_work_id: VALID_UUID,
527
+ task_id: VALID_UUID_2,
528
+ depends_on_task_id: VALID_UUID_3,
529
+ }, ctx);
530
+
531
+ expect(result.result).toMatchObject({
532
+ success: true,
533
+ task_id: VALID_UUID_2,
534
+ depends_on_task_id: VALID_UUID_3,
535
+ });
536
+ });
537
+ });
538
+
539
+ // ============================================================================
540
+ // removeTaskDependency Tests
541
+ // ============================================================================
542
+
543
+ describe('removeTaskDependency', () => {
544
+ beforeEach(() => vi.clearAllMocks());
545
+
546
+ it('should throw error for missing task_id', async () => {
547
+ const ctx = createMockContext();
548
+ await expect(
549
+ removeTaskDependency({ depends_on_task_id: VALID_UUID }, ctx)
550
+ ).rejects.toThrow(ValidationError);
551
+ });
552
+
553
+ it('should throw error for missing depends_on_task_id', async () => {
554
+ const ctx = createMockContext();
555
+ await expect(
556
+ removeTaskDependency({ task_id: VALID_UUID }, ctx)
557
+ ).rejects.toThrow(ValidationError);
558
+ });
559
+
560
+ it('should remove dependency successfully', async () => {
561
+ const ctx = createMockContext();
562
+ mockApiClient.proxy.mockResolvedValue({
563
+ ok: true,
564
+ data: {
565
+ success: true,
566
+ task_id: VALID_UUID,
567
+ depends_on_task_id: VALID_UUID_2,
568
+ },
569
+ });
570
+
571
+ const result = await removeTaskDependency(
572
+ { task_id: VALID_UUID, depends_on_task_id: VALID_UUID_2 },
573
+ ctx
574
+ );
575
+
576
+ expect(result.result).toMatchObject({
577
+ success: true,
578
+ task_id: VALID_UUID,
579
+ depends_on_task_id: VALID_UUID_2,
580
+ });
581
+ });
582
+ });
583
+
584
+ // ============================================================================
585
+ // getTaskDependencies Tests
586
+ // ============================================================================
587
+
588
+ describe('getTaskDependencies', () => {
589
+ beforeEach(() => vi.clearAllMocks());
590
+
591
+ it('should return error when neither body_of_work_id nor task_id provided', async () => {
592
+ const ctx = createMockContext();
593
+
594
+ const result = await getTaskDependencies({}, ctx);
595
+
596
+ expect(result.isError).toBe(true);
597
+ expect(result.result).toMatchObject({
598
+ error: 'Either body_of_work_id or task_id is required',
599
+ });
600
+ });
601
+
602
+ it('should return dependencies filtered by body_of_work_id', async () => {
603
+ const mockDeps = [
604
+ { id: 'd1', task_id: 't1', depends_on_task_id: 't2', created_at: '2026-01-14' },
605
+ ];
606
+
607
+ const ctx = createMockContext();
608
+ mockApiClient.proxy.mockResolvedValue({
609
+ ok: true,
610
+ data: { dependencies: mockDeps },
611
+ });
612
+
613
+ const result = await getTaskDependencies({ body_of_work_id: VALID_UUID }, ctx);
614
+
615
+ expect(result.result).toMatchObject({ dependencies: mockDeps });
616
+ expect(mockApiClient.proxy).toHaveBeenCalledWith('get_task_dependencies', expect.objectContaining({
617
+ body_of_work_id: VALID_UUID,
618
+ }));
619
+ });
620
+
621
+ it('should return dependencies filtered by task_id', async () => {
622
+ const ctx = createMockContext();
623
+ mockApiClient.proxy.mockResolvedValue({
624
+ ok: true,
625
+ data: { dependencies: [] },
626
+ });
627
+
628
+ const result = await getTaskDependencies({ task_id: VALID_UUID }, ctx);
629
+
630
+ expect(result.result).toMatchObject({ dependencies: [] });
631
+ expect(mockApiClient.proxy).toHaveBeenCalledWith('get_task_dependencies', expect.objectContaining({
632
+ task_id: VALID_UUID,
633
+ }));
634
+ });
635
+ });
636
+
637
+ // ============================================================================
638
+ // getNextBodyOfWorkTask Tests
639
+ // ============================================================================
640
+
641
+ describe('getNextBodyOfWorkTask', () => {
642
+ beforeEach(() => vi.clearAllMocks());
643
+
644
+ it('should throw error for missing body_of_work_id', async () => {
645
+ const ctx = createMockContext();
646
+ await expect(getNextBodyOfWorkTask({}, ctx)).rejects.toThrow(ValidationError);
647
+ });
648
+
649
+ it('should return error when API returns error', async () => {
650
+ const ctx = createMockContext();
651
+ mockApiClient.proxy.mockResolvedValue({
652
+ ok: false,
653
+ error: 'Body of work not found',
654
+ });
655
+
656
+ const result = await getNextBodyOfWorkTask({ body_of_work_id: VALID_UUID }, ctx);
657
+
658
+ expect(result.isError).toBe(true);
659
+ expect(result.result).toMatchObject({
660
+ error: 'Body of work not found',
661
+ });
662
+ });
663
+
664
+ it('should return null when no tasks available', async () => {
665
+ const ctx = createMockContext();
666
+ mockApiClient.proxy.mockResolvedValue({
667
+ ok: true,
668
+ data: {
669
+ next_task: null,
670
+ message: 'No available tasks',
671
+ },
672
+ });
673
+
674
+ const result = await getNextBodyOfWorkTask({ body_of_work_id: VALID_UUID }, ctx);
675
+
676
+ expect(result.result).toMatchObject({
677
+ next_task: null,
678
+ message: 'No available tasks',
679
+ });
680
+ });
681
+
682
+ it('should return next pending task', async () => {
683
+ const ctx = createMockContext();
684
+ mockApiClient.proxy.mockResolvedValue({
685
+ ok: true,
686
+ data: {
687
+ next_task: {
688
+ id: 't1',
689
+ title: 'Setup',
690
+ phase: 'pre',
691
+ status: 'pending',
692
+ },
693
+ message: 'Task available',
694
+ },
695
+ });
696
+
697
+ const result = await getNextBodyOfWorkTask({ body_of_work_id: VALID_UUID }, ctx);
698
+
699
+ expect(result.result).toHaveProperty('next_task');
700
+ const nextTask = (result.result as { next_task: { id: string; phase: string } }).next_task;
701
+ expect(nextTask.id).toBe('t1');
702
+ expect(nextTask.phase).toBe('pre');
703
+ });
704
+ });