@vibescope/mcp-server 0.4.9 → 0.5.1

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 (159) hide show
  1. package/CHANGELOG.md +84 -84
  2. package/README.md +194 -194
  3. package/dist/api-client/tasks.d.ts +1 -0
  4. package/dist/cli-init.js +21 -21
  5. package/dist/cli.js +26 -26
  6. package/dist/handlers/tasks.js +7 -1
  7. package/dist/handlers/tool-docs.js +1216 -1216
  8. package/dist/index.js +73 -73
  9. package/dist/templates/agent-guidelines.d.ts +1 -1
  10. package/dist/templates/agent-guidelines.js +205 -205
  11. package/dist/templates/help-content.js +1621 -1621
  12. package/dist/tools/bodies-of-work.js +6 -6
  13. package/dist/tools/cloud-agents.js +22 -22
  14. package/dist/tools/milestones.js +2 -2
  15. package/dist/tools/requests.js +1 -1
  16. package/dist/tools/session.js +11 -11
  17. package/dist/tools/sprints.js +9 -9
  18. package/dist/tools/tasks.js +43 -35
  19. package/dist/tools/worktrees.js +14 -14
  20. package/dist/utils.js +11 -11
  21. package/docs/TOOLS.md +2687 -2685
  22. package/package.json +53 -53
  23. package/scripts/generate-docs.ts +212 -212
  24. package/scripts/version-bump.ts +203 -203
  25. package/src/api-client/blockers.ts +86 -86
  26. package/src/api-client/bodies-of-work.ts +194 -194
  27. package/src/api-client/chat.ts +50 -50
  28. package/src/api-client/connectors.ts +152 -152
  29. package/src/api-client/cost.ts +185 -185
  30. package/src/api-client/decisions.ts +87 -87
  31. package/src/api-client/deployment.ts +313 -313
  32. package/src/api-client/discovery.ts +81 -81
  33. package/src/api-client/fallback.ts +52 -52
  34. package/src/api-client/file-checkouts.ts +115 -115
  35. package/src/api-client/findings.ts +100 -100
  36. package/src/api-client/git-issues.ts +88 -88
  37. package/src/api-client/ideas.ts +112 -112
  38. package/src/api-client/index.ts +592 -592
  39. package/src/api-client/milestones.ts +83 -83
  40. package/src/api-client/organizations.ts +185 -185
  41. package/src/api-client/progress.ts +94 -94
  42. package/src/api-client/project.ts +181 -181
  43. package/src/api-client/requests.ts +54 -54
  44. package/src/api-client/session.ts +220 -220
  45. package/src/api-client/sprints.ts +227 -227
  46. package/src/api-client/subtasks.ts +57 -57
  47. package/src/api-client/tasks.ts +451 -450
  48. package/src/api-client/types.ts +32 -32
  49. package/src/api-client/validation.ts +60 -60
  50. package/src/api-client/worktrees.ts +53 -53
  51. package/src/api-client.test.ts +847 -847
  52. package/src/api-client.ts +2728 -2728
  53. package/src/cli-init.ts +558 -558
  54. package/src/cli.test.ts +284 -284
  55. package/src/cli.ts +204 -204
  56. package/src/handlers/__test-setup__.ts +240 -240
  57. package/src/handlers/__test-utils__.ts +89 -89
  58. package/src/handlers/blockers.test.ts +468 -468
  59. package/src/handlers/blockers.ts +172 -172
  60. package/src/handlers/bodies-of-work.test.ts +704 -704
  61. package/src/handlers/bodies-of-work.ts +526 -526
  62. package/src/handlers/chat.test.ts +185 -185
  63. package/src/handlers/chat.ts +101 -101
  64. package/src/handlers/cloud-agents.test.ts +438 -438
  65. package/src/handlers/cloud-agents.ts +156 -156
  66. package/src/handlers/connectors.test.ts +834 -834
  67. package/src/handlers/connectors.ts +229 -229
  68. package/src/handlers/cost.test.ts +462 -462
  69. package/src/handlers/cost.ts +285 -285
  70. package/src/handlers/decisions.test.ts +382 -382
  71. package/src/handlers/decisions.ts +153 -153
  72. package/src/handlers/deployment.test.ts +551 -551
  73. package/src/handlers/deployment.ts +570 -570
  74. package/src/handlers/discovery.test.ts +206 -206
  75. package/src/handlers/discovery.ts +433 -433
  76. package/src/handlers/fallback.test.ts +537 -537
  77. package/src/handlers/fallback.ts +194 -194
  78. package/src/handlers/file-checkouts.test.ts +750 -750
  79. package/src/handlers/file-checkouts.ts +185 -185
  80. package/src/handlers/findings.test.ts +633 -633
  81. package/src/handlers/findings.ts +239 -239
  82. package/src/handlers/git-issues.test.ts +631 -631
  83. package/src/handlers/git-issues.ts +136 -136
  84. package/src/handlers/ideas.test.ts +644 -644
  85. package/src/handlers/ideas.ts +207 -207
  86. package/src/handlers/index.ts +93 -93
  87. package/src/handlers/milestones.test.ts +475 -475
  88. package/src/handlers/milestones.ts +180 -180
  89. package/src/handlers/organizations.test.ts +826 -826
  90. package/src/handlers/organizations.ts +315 -315
  91. package/src/handlers/progress.test.ts +269 -269
  92. package/src/handlers/progress.ts +77 -77
  93. package/src/handlers/project.test.ts +546 -546
  94. package/src/handlers/project.ts +245 -245
  95. package/src/handlers/requests.test.ts +303 -303
  96. package/src/handlers/requests.ts +99 -99
  97. package/src/handlers/roles.test.ts +305 -305
  98. package/src/handlers/roles.ts +219 -219
  99. package/src/handlers/session.test.ts +998 -998
  100. package/src/handlers/session.ts +1105 -1105
  101. package/src/handlers/sprints.test.ts +732 -732
  102. package/src/handlers/sprints.ts +537 -537
  103. package/src/handlers/tasks.test.ts +931 -931
  104. package/src/handlers/tasks.ts +1144 -1137
  105. package/src/handlers/tool-categories.test.ts +66 -66
  106. package/src/handlers/tool-docs.test.ts +511 -511
  107. package/src/handlers/tool-docs.ts +1595 -1595
  108. package/src/handlers/types.test.ts +259 -259
  109. package/src/handlers/types.ts +176 -176
  110. package/src/handlers/validation.test.ts +582 -582
  111. package/src/handlers/validation.ts +164 -164
  112. package/src/handlers/version.ts +63 -63
  113. package/src/index.test.ts +674 -674
  114. package/src/index.ts +884 -884
  115. package/src/setup.test.ts +243 -243
  116. package/src/setup.ts +410 -410
  117. package/src/templates/agent-guidelines.ts +233 -233
  118. package/src/templates/help-content.ts +1751 -1751
  119. package/src/token-tracking.test.ts +463 -463
  120. package/src/token-tracking.ts +167 -167
  121. package/src/tools/blockers.ts +122 -122
  122. package/src/tools/bodies-of-work.ts +283 -283
  123. package/src/tools/chat.ts +72 -72
  124. package/src/tools/cloud-agents.ts +101 -101
  125. package/src/tools/connectors.ts +191 -191
  126. package/src/tools/cost.ts +111 -111
  127. package/src/tools/decisions.ts +111 -111
  128. package/src/tools/deployment.ts +455 -455
  129. package/src/tools/discovery.ts +76 -76
  130. package/src/tools/fallback.ts +111 -111
  131. package/src/tools/features.ts +154 -154
  132. package/src/tools/file-checkouts.ts +145 -145
  133. package/src/tools/findings.ts +101 -101
  134. package/src/tools/git-issues.ts +130 -130
  135. package/src/tools/ideas.ts +162 -162
  136. package/src/tools/index.ts +145 -145
  137. package/src/tools/milestones.ts +118 -118
  138. package/src/tools/organizations.ts +224 -224
  139. package/src/tools/persona-templates.ts +25 -25
  140. package/src/tools/progress.ts +73 -73
  141. package/src/tools/project.ts +210 -210
  142. package/src/tools/requests.ts +68 -68
  143. package/src/tools/roles.ts +112 -112
  144. package/src/tools/session.ts +181 -181
  145. package/src/tools/sprints.ts +298 -298
  146. package/src/tools/tasks.ts +583 -575
  147. package/src/tools/tools.test.ts +222 -222
  148. package/src/tools/types.ts +9 -9
  149. package/src/tools/validation.ts +75 -75
  150. package/src/tools/version.ts +34 -34
  151. package/src/tools/worktrees.ts +66 -66
  152. package/src/tools.test.ts +416 -416
  153. package/src/utils.test.ts +1014 -1014
  154. package/src/utils.ts +586 -586
  155. package/src/validators.test.ts +223 -223
  156. package/src/validators.ts +249 -249
  157. package/src/version.ts +162 -162
  158. package/tsconfig.json +16 -16
  159. 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
+ });