@vibescope/mcp-server 0.2.3 → 0.2.5

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 (117) hide show
  1. package/CHANGELOG.md +84 -0
  2. package/README.md +194 -138
  3. package/dist/api-client.d.ts +276 -8
  4. package/dist/api-client.js +123 -8
  5. package/dist/cli.d.ts +6 -3
  6. package/dist/cli.js +28 -10
  7. package/dist/handlers/blockers.d.ts +11 -0
  8. package/dist/handlers/blockers.js +37 -2
  9. package/dist/handlers/bodies-of-work.d.ts +2 -0
  10. package/dist/handlers/bodies-of-work.js +30 -1
  11. package/dist/handlers/connectors.js +2 -2
  12. package/dist/handlers/decisions.d.ts +11 -0
  13. package/dist/handlers/decisions.js +37 -2
  14. package/dist/handlers/deployment.d.ts +6 -0
  15. package/dist/handlers/deployment.js +33 -5
  16. package/dist/handlers/discovery.js +27 -11
  17. package/dist/handlers/fallback.js +12 -6
  18. package/dist/handlers/file-checkouts.d.ts +1 -0
  19. package/dist/handlers/file-checkouts.js +17 -2
  20. package/dist/handlers/findings.d.ts +5 -0
  21. package/dist/handlers/findings.js +19 -2
  22. package/dist/handlers/git-issues.js +4 -2
  23. package/dist/handlers/ideas.d.ts +5 -0
  24. package/dist/handlers/ideas.js +19 -2
  25. package/dist/handlers/progress.js +2 -2
  26. package/dist/handlers/project.d.ts +1 -0
  27. package/dist/handlers/project.js +35 -2
  28. package/dist/handlers/requests.js +6 -3
  29. package/dist/handlers/roles.js +13 -2
  30. package/dist/handlers/session.d.ts +12 -0
  31. package/dist/handlers/session.js +288 -25
  32. package/dist/handlers/sprints.d.ts +2 -0
  33. package/dist/handlers/sprints.js +30 -1
  34. package/dist/handlers/tasks.d.ts +25 -2
  35. package/dist/handlers/tasks.js +228 -35
  36. package/dist/handlers/tool-docs.js +834 -767
  37. package/dist/index.js +73 -73
  38. package/dist/knowledge.d.ts +6 -0
  39. package/dist/knowledge.js +218 -0
  40. package/dist/setup.d.ts +22 -0
  41. package/dist/setup.js +313 -0
  42. package/dist/templates/agent-guidelines.d.ts +18 -0
  43. package/dist/templates/agent-guidelines.js +207 -0
  44. package/dist/tools.js +527 -174
  45. package/dist/utils.d.ts +5 -2
  46. package/dist/utils.js +101 -62
  47. package/docs/TOOLS.md +2053 -2053
  48. package/package.json +51 -46
  49. package/scripts/generate-docs.ts +212 -212
  50. package/scripts/version-bump.ts +203 -0
  51. package/src/api-client.test.ts +723 -723
  52. package/src/api-client.ts +2499 -2140
  53. package/src/cli.ts +27 -10
  54. package/src/handlers/__test-setup__.ts +236 -231
  55. package/src/handlers/__test-utils__.ts +87 -87
  56. package/src/handlers/blockers.test.ts +468 -392
  57. package/src/handlers/blockers.ts +163 -109
  58. package/src/handlers/bodies-of-work.test.ts +704 -704
  59. package/src/handlers/bodies-of-work.ts +526 -468
  60. package/src/handlers/connectors.test.ts +834 -834
  61. package/src/handlers/connectors.ts +229 -229
  62. package/src/handlers/cost.test.ts +462 -462
  63. package/src/handlers/cost.ts +285 -285
  64. package/src/handlers/decisions.test.ts +382 -313
  65. package/src/handlers/decisions.ts +153 -99
  66. package/src/handlers/deployment.test.ts +551 -470
  67. package/src/handlers/deployment.ts +541 -508
  68. package/src/handlers/discovery.test.ts +206 -206
  69. package/src/handlers/discovery.ts +390 -374
  70. package/src/handlers/fallback.test.ts +537 -536
  71. package/src/handlers/fallback.ts +194 -188
  72. package/src/handlers/file-checkouts.test.ts +750 -670
  73. package/src/handlers/file-checkouts.ts +185 -165
  74. package/src/handlers/findings.test.ts +633 -633
  75. package/src/handlers/findings.ts +239 -203
  76. package/src/handlers/git-issues.test.ts +631 -631
  77. package/src/handlers/git-issues.ts +136 -134
  78. package/src/handlers/ideas.test.ts +644 -644
  79. package/src/handlers/ideas.ts +207 -175
  80. package/src/handlers/index.ts +84 -84
  81. package/src/handlers/milestones.test.ts +475 -475
  82. package/src/handlers/milestones.ts +180 -180
  83. package/src/handlers/organizations.test.ts +826 -826
  84. package/src/handlers/organizations.ts +315 -315
  85. package/src/handlers/progress.test.ts +269 -269
  86. package/src/handlers/progress.ts +77 -77
  87. package/src/handlers/project.test.ts +546 -546
  88. package/src/handlers/project.ts +239 -194
  89. package/src/handlers/requests.test.ts +303 -272
  90. package/src/handlers/requests.ts +99 -96
  91. package/src/handlers/roles.test.ts +303 -303
  92. package/src/handlers/roles.ts +226 -208
  93. package/src/handlers/session.test.ts +875 -576
  94. package/src/handlers/session.ts +738 -425
  95. package/src/handlers/sprints.test.ts +732 -732
  96. package/src/handlers/sprints.ts +537 -477
  97. package/src/handlers/tasks.test.ts +907 -980
  98. package/src/handlers/tasks.ts +945 -716
  99. package/src/handlers/tool-categories.test.ts +66 -66
  100. package/src/handlers/tool-docs.ts +1096 -1024
  101. package/src/handlers/types.test.ts +259 -0
  102. package/src/handlers/types.ts +175 -175
  103. package/src/handlers/validation.test.ts +582 -582
  104. package/src/handlers/validation.ts +97 -97
  105. package/src/index.ts +792 -792
  106. package/src/setup.test.ts +231 -0
  107. package/src/setup.ts +370 -0
  108. package/src/templates/agent-guidelines.ts +210 -0
  109. package/src/token-tracking.test.ts +453 -453
  110. package/src/token-tracking.ts +164 -164
  111. package/src/tools.ts +3562 -3208
  112. package/src/utils.test.ts +683 -681
  113. package/src/utils.ts +436 -392
  114. package/src/validators.test.ts +223 -223
  115. package/src/validators.ts +249 -249
  116. package/tsconfig.json +16 -16
  117. 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
+ });