@vibescope/mcp-server 0.2.4 → 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 (84) hide show
  1. package/CHANGELOG.md +84 -84
  2. package/README.md +194 -181
  3. package/dist/cli.d.ts +6 -3
  4. package/dist/cli.js +28 -10
  5. package/dist/handlers/tool-docs.js +828 -828
  6. package/dist/index.js +73 -73
  7. package/dist/knowledge.d.ts +6 -0
  8. package/dist/knowledge.js +218 -0
  9. package/dist/setup.d.ts +22 -0
  10. package/dist/setup.js +313 -0
  11. package/dist/templates/agent-guidelines.js +185 -185
  12. package/dist/tools.js +65 -65
  13. package/dist/utils.js +11 -11
  14. package/docs/TOOLS.md +2053 -2053
  15. package/package.json +1 -1
  16. package/scripts/generate-docs.ts +212 -212
  17. package/scripts/version-bump.ts +203 -203
  18. package/src/api-client.test.ts +723 -723
  19. package/src/api-client.ts +2499 -2499
  20. package/src/cli.ts +27 -10
  21. package/src/handlers/__test-setup__.ts +236 -236
  22. package/src/handlers/__test-utils__.ts +87 -87
  23. package/src/handlers/blockers.test.ts +468 -468
  24. package/src/handlers/blockers.ts +163 -163
  25. package/src/handlers/bodies-of-work.test.ts +704 -704
  26. package/src/handlers/bodies-of-work.ts +526 -526
  27. package/src/handlers/connectors.test.ts +834 -834
  28. package/src/handlers/connectors.ts +229 -229
  29. package/src/handlers/cost.test.ts +462 -462
  30. package/src/handlers/cost.ts +285 -285
  31. package/src/handlers/decisions.test.ts +382 -382
  32. package/src/handlers/decisions.ts +153 -153
  33. package/src/handlers/deployment.test.ts +551 -551
  34. package/src/handlers/deployment.ts +541 -541
  35. package/src/handlers/discovery.test.ts +206 -206
  36. package/src/handlers/discovery.ts +390 -390
  37. package/src/handlers/fallback.test.ts +537 -537
  38. package/src/handlers/fallback.ts +194 -194
  39. package/src/handlers/file-checkouts.test.ts +750 -750
  40. package/src/handlers/file-checkouts.ts +185 -185
  41. package/src/handlers/findings.test.ts +633 -633
  42. package/src/handlers/findings.ts +239 -239
  43. package/src/handlers/git-issues.test.ts +631 -631
  44. package/src/handlers/git-issues.ts +136 -136
  45. package/src/handlers/ideas.test.ts +644 -644
  46. package/src/handlers/ideas.ts +207 -207
  47. package/src/handlers/index.ts +84 -84
  48. package/src/handlers/milestones.test.ts +475 -475
  49. package/src/handlers/milestones.ts +180 -180
  50. package/src/handlers/organizations.test.ts +826 -826
  51. package/src/handlers/organizations.ts +315 -315
  52. package/src/handlers/progress.test.ts +269 -269
  53. package/src/handlers/progress.ts +77 -77
  54. package/src/handlers/project.test.ts +546 -546
  55. package/src/handlers/project.ts +239 -239
  56. package/src/handlers/requests.test.ts +303 -303
  57. package/src/handlers/requests.ts +99 -99
  58. package/src/handlers/roles.test.ts +303 -303
  59. package/src/handlers/roles.ts +226 -226
  60. package/src/handlers/session.test.ts +875 -875
  61. package/src/handlers/session.ts +738 -738
  62. package/src/handlers/sprints.test.ts +732 -732
  63. package/src/handlers/sprints.ts +537 -537
  64. package/src/handlers/tasks.test.ts +907 -907
  65. package/src/handlers/tasks.ts +945 -945
  66. package/src/handlers/tool-categories.test.ts +66 -66
  67. package/src/handlers/tool-docs.ts +1096 -1096
  68. package/src/handlers/types.test.ts +259 -259
  69. package/src/handlers/types.ts +175 -175
  70. package/src/handlers/validation.test.ts +582 -582
  71. package/src/handlers/validation.ts +97 -97
  72. package/src/index.ts +792 -792
  73. package/src/setup.test.ts +231 -0
  74. package/src/setup.ts +370 -0
  75. package/src/templates/agent-guidelines.ts +210 -210
  76. package/src/token-tracking.test.ts +453 -453
  77. package/src/token-tracking.ts +164 -164
  78. package/src/tools.ts +3562 -3562
  79. package/src/utils.test.ts +683 -683
  80. package/src/utils.ts +436 -436
  81. package/src/validators.test.ts +223 -223
  82. package/src/validators.ts +249 -249
  83. package/tsconfig.json +16 -16
  84. package/vitest.config.ts +14 -14
@@ -1,468 +1,468 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import {
3
- addBlocker,
4
- resolveBlocker,
5
- getBlockers,
6
- getBlockersStats,
7
- deleteBlocker,
8
- } from './blockers.js';
9
- import { ValidationError } from '../validators.js';
10
- import { createMockContext } from './__test-utils__.js';
11
- import { mockApiClient } from './__test-setup__.js';
12
-
13
- // ============================================================================
14
- // addBlocker Tests
15
- // ============================================================================
16
-
17
- describe('addBlocker', () => {
18
- beforeEach(() => vi.clearAllMocks());
19
-
20
- it('should throw error for missing project_id', async () => {
21
- const ctx = createMockContext();
22
-
23
- await expect(
24
- addBlocker({ description: 'Some blocker' }, ctx)
25
- ).rejects.toThrow(ValidationError);
26
- });
27
-
28
- it('should throw error for invalid project_id UUID', async () => {
29
- const ctx = createMockContext();
30
-
31
- await expect(
32
- addBlocker({ project_id: 'invalid', description: 'Some blocker' }, ctx)
33
- ).rejects.toThrow(ValidationError);
34
- });
35
-
36
- it('should throw error for missing description', async () => {
37
- const ctx = createMockContext();
38
-
39
- await expect(
40
- addBlocker({ project_id: '123e4567-e89b-12d3-a456-426614174000' }, ctx)
41
- ).rejects.toThrow(ValidationError);
42
- });
43
-
44
- it('should add blocker successfully', async () => {
45
- mockApiClient.addBlocker.mockResolvedValue({
46
- ok: true,
47
- data: { success: true, blocker_id: 'blocker-1' },
48
- });
49
- const ctx = createMockContext();
50
-
51
- const result = await addBlocker(
52
- {
53
- project_id: '123e4567-e89b-12d3-a456-426614174000',
54
- description: 'API is down',
55
- },
56
- ctx
57
- );
58
-
59
- expect(result.result).toMatchObject({
60
- success: true,
61
- blocker_id: 'blocker-1',
62
- });
63
- });
64
-
65
- it('should include session_id in API call', async () => {
66
- mockApiClient.addBlocker.mockResolvedValue({
67
- ok: true,
68
- data: { success: true, blocker_id: 'blocker-1' },
69
- });
70
- const ctx = createMockContext({ sessionId: 'my-session' });
71
-
72
- await addBlocker(
73
- {
74
- project_id: '123e4567-e89b-12d3-a456-426614174000',
75
- description: 'Blocked by dependency',
76
- },
77
- ctx
78
- );
79
-
80
- expect(mockApiClient.addBlocker).toHaveBeenCalledWith(
81
- '123e4567-e89b-12d3-a456-426614174000',
82
- 'Blocked by dependency',
83
- 'my-session'
84
- );
85
- });
86
-
87
- it('should return error when API call fails', async () => {
88
- mockApiClient.addBlocker.mockResolvedValue({
89
- ok: false,
90
- error: 'Insert failed',
91
- });
92
- const ctx = createMockContext();
93
-
94
- const result = await addBlocker({
95
- project_id: '123e4567-e89b-12d3-a456-426614174000',
96
- description: 'Test blocker',
97
- }, ctx);
98
-
99
- expect(result.isError).toBe(true);
100
- expect(result.result).toMatchObject({
101
- error: 'Insert failed',
102
- });
103
- });
104
- });
105
-
106
- // ============================================================================
107
- // resolveBlocker Tests
108
- // ============================================================================
109
-
110
- describe('resolveBlocker', () => {
111
- beforeEach(() => vi.clearAllMocks());
112
-
113
- it('should throw error for missing blocker_id', async () => {
114
- const ctx = createMockContext();
115
-
116
- await expect(resolveBlocker({}, ctx)).rejects.toThrow(ValidationError);
117
- });
118
-
119
- it('should throw error for invalid blocker_id UUID', async () => {
120
- const ctx = createMockContext();
121
-
122
- await expect(
123
- resolveBlocker({ blocker_id: 'invalid' }, ctx)
124
- ).rejects.toThrow(ValidationError);
125
- });
126
-
127
- it('should resolve blocker successfully', async () => {
128
- mockApiClient.resolveBlocker.mockResolvedValue({
129
- ok: true,
130
- data: { success: true, blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
131
- });
132
- const ctx = createMockContext();
133
-
134
- const result = await resolveBlocker(
135
- { blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
136
- ctx
137
- );
138
-
139
- expect(result.result).toMatchObject({
140
- success: true,
141
- blocker_id: '123e4567-e89b-12d3-a456-426614174000',
142
- });
143
- });
144
-
145
- it('should resolve blocker with resolution note', async () => {
146
- mockApiClient.resolveBlocker.mockResolvedValue({
147
- ok: true,
148
- data: { success: true, blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
149
- });
150
- const ctx = createMockContext();
151
-
152
- await resolveBlocker(
153
- {
154
- blocker_id: '123e4567-e89b-12d3-a456-426614174000',
155
- resolution_note: 'Fixed by upgrading dependency',
156
- },
157
- ctx
158
- );
159
-
160
- expect(mockApiClient.resolveBlocker).toHaveBeenCalledWith(
161
- '123e4567-e89b-12d3-a456-426614174000',
162
- 'Fixed by upgrading dependency'
163
- );
164
- });
165
-
166
- it('should call API client resolveBlocker', async () => {
167
- mockApiClient.resolveBlocker.mockResolvedValue({
168
- ok: true,
169
- data: { success: true, blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
170
- });
171
- const ctx = createMockContext();
172
-
173
- await resolveBlocker(
174
- { blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
175
- ctx
176
- );
177
-
178
- expect(mockApiClient.resolveBlocker).toHaveBeenCalledWith(
179
- '123e4567-e89b-12d3-a456-426614174000',
180
- undefined
181
- );
182
- });
183
-
184
- it('should return error when API call fails', async () => {
185
- mockApiClient.resolveBlocker.mockResolvedValue({
186
- ok: false,
187
- error: 'Update failed',
188
- });
189
- const ctx = createMockContext();
190
-
191
- const result = await resolveBlocker({ blocker_id: '123e4567-e89b-12d3-a456-426614174000' }, ctx);
192
-
193
- expect(result.isError).toBe(true);
194
- expect(result.result).toMatchObject({
195
- error: 'Update failed',
196
- });
197
- });
198
- });
199
-
200
- // ============================================================================
201
- // getBlockers Tests
202
- // ============================================================================
203
-
204
- describe('getBlockers', () => {
205
- beforeEach(() => vi.clearAllMocks());
206
-
207
- it('should throw error for missing project_id', async () => {
208
- const ctx = createMockContext();
209
-
210
- await expect(getBlockers({}, ctx)).rejects.toThrow(ValidationError);
211
- });
212
-
213
- it('should throw error for invalid project_id UUID', async () => {
214
- const ctx = createMockContext();
215
-
216
- await expect(
217
- getBlockers({ project_id: 'invalid' }, ctx)
218
- ).rejects.toThrow(ValidationError);
219
- });
220
-
221
- it('should return empty list when no blockers', async () => {
222
- mockApiClient.getBlockers.mockResolvedValue({
223
- ok: true,
224
- data: { blockers: [] },
225
- });
226
- const ctx = createMockContext();
227
-
228
- const result = await getBlockers(
229
- { project_id: '123e4567-e89b-12d3-a456-426614174000' },
230
- ctx
231
- );
232
-
233
- expect(result.result).toMatchObject({
234
- blockers: [],
235
- });
236
- });
237
-
238
- it('should return blockers list', async () => {
239
- const mockBlockers = [
240
- { id: 'b1', description: 'Blocker 1', status: 'open', created_at: '2025-01-14T10:00:00Z' },
241
- { id: 'b2', description: 'Blocker 2', status: 'open', created_at: '2025-01-14T11:00:00Z' },
242
- ];
243
- mockApiClient.getBlockers.mockResolvedValue({
244
- ok: true,
245
- data: { blockers: mockBlockers },
246
- });
247
- const ctx = createMockContext();
248
-
249
- const result = await getBlockers(
250
- { project_id: '123e4567-e89b-12d3-a456-426614174000' },
251
- ctx
252
- );
253
-
254
- expect((result.result as { blockers: unknown[] }).blockers).toHaveLength(2);
255
- });
256
-
257
- it('should pass status parameter to API (default: open)', async () => {
258
- mockApiClient.getBlockers.mockResolvedValue({
259
- ok: true,
260
- data: { blockers: [] },
261
- });
262
- const ctx = createMockContext();
263
-
264
- await getBlockers(
265
- { project_id: '123e4567-e89b-12d3-a456-426614174000' },
266
- ctx
267
- );
268
-
269
- expect(mockApiClient.getBlockers).toHaveBeenCalledWith(
270
- '123e4567-e89b-12d3-a456-426614174000',
271
- expect.objectContaining({ status: 'open' })
272
- );
273
- });
274
-
275
- it('should pass custom status to API', async () => {
276
- mockApiClient.getBlockers.mockResolvedValue({
277
- ok: true,
278
- data: { blockers: [] },
279
- });
280
- const ctx = createMockContext();
281
-
282
- await getBlockers(
283
- { project_id: '123e4567-e89b-12d3-a456-426614174000', status: 'resolved' },
284
- ctx
285
- );
286
-
287
- expect(mockApiClient.getBlockers).toHaveBeenCalledWith(
288
- '123e4567-e89b-12d3-a456-426614174000',
289
- expect.objectContaining({ status: 'resolved' })
290
- );
291
- });
292
-
293
- it('should call API client getBlockers', async () => {
294
- mockApiClient.getBlockers.mockResolvedValue({
295
- ok: true,
296
- data: { blockers: [] },
297
- });
298
- const ctx = createMockContext();
299
-
300
- await getBlockers(
301
- { project_id: '123e4567-e89b-12d3-a456-426614174000' },
302
- ctx
303
- );
304
-
305
- expect(mockApiClient.getBlockers).toHaveBeenCalled();
306
- });
307
-
308
- it('should return error when API call fails', async () => {
309
- mockApiClient.getBlockers.mockResolvedValue({
310
- ok: false,
311
- error: 'Query failed',
312
- });
313
- const ctx = createMockContext();
314
-
315
- const result = await getBlockers({ project_id: '123e4567-e89b-12d3-a456-426614174000' }, ctx);
316
-
317
- expect(result.isError).toBe(true);
318
- expect(result.result).toMatchObject({
319
- error: 'Query failed',
320
- });
321
- });
322
- });
323
-
324
- // ============================================================================
325
- // deleteBlocker Tests
326
- // ============================================================================
327
-
328
- describe('deleteBlocker', () => {
329
- beforeEach(() => vi.clearAllMocks());
330
-
331
- it('should throw error for missing blocker_id', async () => {
332
- const ctx = createMockContext();
333
-
334
- await expect(deleteBlocker({}, ctx)).rejects.toThrow(ValidationError);
335
- });
336
-
337
- it('should throw error for invalid blocker_id UUID', async () => {
338
- const ctx = createMockContext();
339
-
340
- await expect(
341
- deleteBlocker({ blocker_id: 'invalid' }, ctx)
342
- ).rejects.toThrow(ValidationError);
343
- });
344
-
345
- it('should delete blocker successfully', async () => {
346
- mockApiClient.deleteBlocker.mockResolvedValue({
347
- ok: true,
348
- data: { success: true },
349
- });
350
- const ctx = createMockContext();
351
-
352
- const result = await deleteBlocker(
353
- { blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
354
- ctx
355
- );
356
-
357
- expect(result.result).toMatchObject({
358
- success: true,
359
- });
360
- });
361
-
362
- it('should call API client deleteBlocker', async () => {
363
- mockApiClient.deleteBlocker.mockResolvedValue({
364
- ok: true,
365
- data: { success: true },
366
- });
367
- const ctx = createMockContext();
368
-
369
- await deleteBlocker(
370
- { blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
371
- ctx
372
- );
373
-
374
- expect(mockApiClient.deleteBlocker).toHaveBeenCalledWith(
375
- '123e4567-e89b-12d3-a456-426614174000'
376
- );
377
- });
378
-
379
- it('should return error when API call fails', async () => {
380
- mockApiClient.deleteBlocker.mockResolvedValue({
381
- ok: false,
382
- error: 'Delete failed',
383
- });
384
- const ctx = createMockContext();
385
-
386
- const result = await deleteBlocker({ blocker_id: '123e4567-e89b-12d3-a456-426614174000' }, ctx);
387
-
388
- expect(result.isError).toBe(true);
389
- expect(result.result).toMatchObject({
390
- error: 'Delete failed',
391
- });
392
- });
393
- });
394
-
395
- // ============================================================================
396
- // getBlockersStats Tests
397
- // ============================================================================
398
-
399
- describe('getBlockersStats', () => {
400
- beforeEach(() => vi.clearAllMocks());
401
-
402
- it('should throw error for missing project_id', async () => {
403
- const ctx = createMockContext();
404
-
405
- await expect(getBlockersStats({}, ctx)).rejects.toThrow(ValidationError);
406
- });
407
-
408
- it('should throw error for invalid project_id UUID', async () => {
409
- const ctx = createMockContext();
410
-
411
- await expect(
412
- getBlockersStats({ project_id: 'invalid' }, ctx)
413
- ).rejects.toThrow(ValidationError);
414
- });
415
-
416
- it('should return blockers stats', async () => {
417
- mockApiClient.getBlockersStats.mockResolvedValue({
418
- ok: true,
419
- data: {
420
- total: 5,
421
- by_status: { open: 3, resolved: 2 },
422
- },
423
- });
424
- const ctx = createMockContext();
425
-
426
- const result = await getBlockersStats(
427
- { project_id: '123e4567-e89b-12d3-a456-426614174000' },
428
- ctx
429
- );
430
-
431
- expect(result.result).toMatchObject({
432
- total: 5,
433
- by_status: { open: 3, resolved: 2 },
434
- });
435
- });
436
-
437
- it('should call API client getBlockersStats', async () => {
438
- mockApiClient.getBlockersStats.mockResolvedValue({
439
- ok: true,
440
- data: { total: 0, by_status: {} },
441
- });
442
- const ctx = createMockContext();
443
-
444
- await getBlockersStats(
445
- { project_id: '123e4567-e89b-12d3-a456-426614174000' },
446
- ctx
447
- );
448
-
449
- expect(mockApiClient.getBlockersStats).toHaveBeenCalledWith(
450
- '123e4567-e89b-12d3-a456-426614174000'
451
- );
452
- });
453
-
454
- it('should return error when API call fails', async () => {
455
- mockApiClient.getBlockersStats.mockResolvedValue({
456
- ok: false,
457
- error: 'Query failed',
458
- });
459
- const ctx = createMockContext();
460
-
461
- const result = await getBlockersStats({ project_id: '123e4567-e89b-12d3-a456-426614174000' }, ctx);
462
-
463
- expect(result.isError).toBe(true);
464
- expect(result.result).toMatchObject({
465
- error: 'Query failed',
466
- });
467
- });
468
- });
1
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
2
+ import {
3
+ addBlocker,
4
+ resolveBlocker,
5
+ getBlockers,
6
+ getBlockersStats,
7
+ deleteBlocker,
8
+ } from './blockers.js';
9
+ import { ValidationError } from '../validators.js';
10
+ import { createMockContext } from './__test-utils__.js';
11
+ import { mockApiClient } from './__test-setup__.js';
12
+
13
+ // ============================================================================
14
+ // addBlocker Tests
15
+ // ============================================================================
16
+
17
+ describe('addBlocker', () => {
18
+ beforeEach(() => vi.clearAllMocks());
19
+
20
+ it('should throw error for missing project_id', async () => {
21
+ const ctx = createMockContext();
22
+
23
+ await expect(
24
+ addBlocker({ description: 'Some blocker' }, ctx)
25
+ ).rejects.toThrow(ValidationError);
26
+ });
27
+
28
+ it('should throw error for invalid project_id UUID', async () => {
29
+ const ctx = createMockContext();
30
+
31
+ await expect(
32
+ addBlocker({ project_id: 'invalid', description: 'Some blocker' }, ctx)
33
+ ).rejects.toThrow(ValidationError);
34
+ });
35
+
36
+ it('should throw error for missing description', async () => {
37
+ const ctx = createMockContext();
38
+
39
+ await expect(
40
+ addBlocker({ project_id: '123e4567-e89b-12d3-a456-426614174000' }, ctx)
41
+ ).rejects.toThrow(ValidationError);
42
+ });
43
+
44
+ it('should add blocker successfully', async () => {
45
+ mockApiClient.addBlocker.mockResolvedValue({
46
+ ok: true,
47
+ data: { success: true, blocker_id: 'blocker-1' },
48
+ });
49
+ const ctx = createMockContext();
50
+
51
+ const result = await addBlocker(
52
+ {
53
+ project_id: '123e4567-e89b-12d3-a456-426614174000',
54
+ description: 'API is down',
55
+ },
56
+ ctx
57
+ );
58
+
59
+ expect(result.result).toMatchObject({
60
+ success: true,
61
+ blocker_id: 'blocker-1',
62
+ });
63
+ });
64
+
65
+ it('should include session_id in API call', async () => {
66
+ mockApiClient.addBlocker.mockResolvedValue({
67
+ ok: true,
68
+ data: { success: true, blocker_id: 'blocker-1' },
69
+ });
70
+ const ctx = createMockContext({ sessionId: 'my-session' });
71
+
72
+ await addBlocker(
73
+ {
74
+ project_id: '123e4567-e89b-12d3-a456-426614174000',
75
+ description: 'Blocked by dependency',
76
+ },
77
+ ctx
78
+ );
79
+
80
+ expect(mockApiClient.addBlocker).toHaveBeenCalledWith(
81
+ '123e4567-e89b-12d3-a456-426614174000',
82
+ 'Blocked by dependency',
83
+ 'my-session'
84
+ );
85
+ });
86
+
87
+ it('should return error when API call fails', async () => {
88
+ mockApiClient.addBlocker.mockResolvedValue({
89
+ ok: false,
90
+ error: 'Insert failed',
91
+ });
92
+ const ctx = createMockContext();
93
+
94
+ const result = await addBlocker({
95
+ project_id: '123e4567-e89b-12d3-a456-426614174000',
96
+ description: 'Test blocker',
97
+ }, ctx);
98
+
99
+ expect(result.isError).toBe(true);
100
+ expect(result.result).toMatchObject({
101
+ error: 'Insert failed',
102
+ });
103
+ });
104
+ });
105
+
106
+ // ============================================================================
107
+ // resolveBlocker Tests
108
+ // ============================================================================
109
+
110
+ describe('resolveBlocker', () => {
111
+ beforeEach(() => vi.clearAllMocks());
112
+
113
+ it('should throw error for missing blocker_id', async () => {
114
+ const ctx = createMockContext();
115
+
116
+ await expect(resolveBlocker({}, ctx)).rejects.toThrow(ValidationError);
117
+ });
118
+
119
+ it('should throw error for invalid blocker_id UUID', async () => {
120
+ const ctx = createMockContext();
121
+
122
+ await expect(
123
+ resolveBlocker({ blocker_id: 'invalid' }, ctx)
124
+ ).rejects.toThrow(ValidationError);
125
+ });
126
+
127
+ it('should resolve blocker successfully', async () => {
128
+ mockApiClient.resolveBlocker.mockResolvedValue({
129
+ ok: true,
130
+ data: { success: true, blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
131
+ });
132
+ const ctx = createMockContext();
133
+
134
+ const result = await resolveBlocker(
135
+ { blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
136
+ ctx
137
+ );
138
+
139
+ expect(result.result).toMatchObject({
140
+ success: true,
141
+ blocker_id: '123e4567-e89b-12d3-a456-426614174000',
142
+ });
143
+ });
144
+
145
+ it('should resolve blocker with resolution note', async () => {
146
+ mockApiClient.resolveBlocker.mockResolvedValue({
147
+ ok: true,
148
+ data: { success: true, blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
149
+ });
150
+ const ctx = createMockContext();
151
+
152
+ await resolveBlocker(
153
+ {
154
+ blocker_id: '123e4567-e89b-12d3-a456-426614174000',
155
+ resolution_note: 'Fixed by upgrading dependency',
156
+ },
157
+ ctx
158
+ );
159
+
160
+ expect(mockApiClient.resolveBlocker).toHaveBeenCalledWith(
161
+ '123e4567-e89b-12d3-a456-426614174000',
162
+ 'Fixed by upgrading dependency'
163
+ );
164
+ });
165
+
166
+ it('should call API client resolveBlocker', async () => {
167
+ mockApiClient.resolveBlocker.mockResolvedValue({
168
+ ok: true,
169
+ data: { success: true, blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
170
+ });
171
+ const ctx = createMockContext();
172
+
173
+ await resolveBlocker(
174
+ { blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
175
+ ctx
176
+ );
177
+
178
+ expect(mockApiClient.resolveBlocker).toHaveBeenCalledWith(
179
+ '123e4567-e89b-12d3-a456-426614174000',
180
+ undefined
181
+ );
182
+ });
183
+
184
+ it('should return error when API call fails', async () => {
185
+ mockApiClient.resolveBlocker.mockResolvedValue({
186
+ ok: false,
187
+ error: 'Update failed',
188
+ });
189
+ const ctx = createMockContext();
190
+
191
+ const result = await resolveBlocker({ blocker_id: '123e4567-e89b-12d3-a456-426614174000' }, ctx);
192
+
193
+ expect(result.isError).toBe(true);
194
+ expect(result.result).toMatchObject({
195
+ error: 'Update failed',
196
+ });
197
+ });
198
+ });
199
+
200
+ // ============================================================================
201
+ // getBlockers Tests
202
+ // ============================================================================
203
+
204
+ describe('getBlockers', () => {
205
+ beforeEach(() => vi.clearAllMocks());
206
+
207
+ it('should throw error for missing project_id', async () => {
208
+ const ctx = createMockContext();
209
+
210
+ await expect(getBlockers({}, ctx)).rejects.toThrow(ValidationError);
211
+ });
212
+
213
+ it('should throw error for invalid project_id UUID', async () => {
214
+ const ctx = createMockContext();
215
+
216
+ await expect(
217
+ getBlockers({ project_id: 'invalid' }, ctx)
218
+ ).rejects.toThrow(ValidationError);
219
+ });
220
+
221
+ it('should return empty list when no blockers', async () => {
222
+ mockApiClient.getBlockers.mockResolvedValue({
223
+ ok: true,
224
+ data: { blockers: [] },
225
+ });
226
+ const ctx = createMockContext();
227
+
228
+ const result = await getBlockers(
229
+ { project_id: '123e4567-e89b-12d3-a456-426614174000' },
230
+ ctx
231
+ );
232
+
233
+ expect(result.result).toMatchObject({
234
+ blockers: [],
235
+ });
236
+ });
237
+
238
+ it('should return blockers list', async () => {
239
+ const mockBlockers = [
240
+ { id: 'b1', description: 'Blocker 1', status: 'open', created_at: '2025-01-14T10:00:00Z' },
241
+ { id: 'b2', description: 'Blocker 2', status: 'open', created_at: '2025-01-14T11:00:00Z' },
242
+ ];
243
+ mockApiClient.getBlockers.mockResolvedValue({
244
+ ok: true,
245
+ data: { blockers: mockBlockers },
246
+ });
247
+ const ctx = createMockContext();
248
+
249
+ const result = await getBlockers(
250
+ { project_id: '123e4567-e89b-12d3-a456-426614174000' },
251
+ ctx
252
+ );
253
+
254
+ expect((result.result as { blockers: unknown[] }).blockers).toHaveLength(2);
255
+ });
256
+
257
+ it('should pass status parameter to API (default: open)', async () => {
258
+ mockApiClient.getBlockers.mockResolvedValue({
259
+ ok: true,
260
+ data: { blockers: [] },
261
+ });
262
+ const ctx = createMockContext();
263
+
264
+ await getBlockers(
265
+ { project_id: '123e4567-e89b-12d3-a456-426614174000' },
266
+ ctx
267
+ );
268
+
269
+ expect(mockApiClient.getBlockers).toHaveBeenCalledWith(
270
+ '123e4567-e89b-12d3-a456-426614174000',
271
+ expect.objectContaining({ status: 'open' })
272
+ );
273
+ });
274
+
275
+ it('should pass custom status to API', async () => {
276
+ mockApiClient.getBlockers.mockResolvedValue({
277
+ ok: true,
278
+ data: { blockers: [] },
279
+ });
280
+ const ctx = createMockContext();
281
+
282
+ await getBlockers(
283
+ { project_id: '123e4567-e89b-12d3-a456-426614174000', status: 'resolved' },
284
+ ctx
285
+ );
286
+
287
+ expect(mockApiClient.getBlockers).toHaveBeenCalledWith(
288
+ '123e4567-e89b-12d3-a456-426614174000',
289
+ expect.objectContaining({ status: 'resolved' })
290
+ );
291
+ });
292
+
293
+ it('should call API client getBlockers', async () => {
294
+ mockApiClient.getBlockers.mockResolvedValue({
295
+ ok: true,
296
+ data: { blockers: [] },
297
+ });
298
+ const ctx = createMockContext();
299
+
300
+ await getBlockers(
301
+ { project_id: '123e4567-e89b-12d3-a456-426614174000' },
302
+ ctx
303
+ );
304
+
305
+ expect(mockApiClient.getBlockers).toHaveBeenCalled();
306
+ });
307
+
308
+ it('should return error when API call fails', async () => {
309
+ mockApiClient.getBlockers.mockResolvedValue({
310
+ ok: false,
311
+ error: 'Query failed',
312
+ });
313
+ const ctx = createMockContext();
314
+
315
+ const result = await getBlockers({ project_id: '123e4567-e89b-12d3-a456-426614174000' }, ctx);
316
+
317
+ expect(result.isError).toBe(true);
318
+ expect(result.result).toMatchObject({
319
+ error: 'Query failed',
320
+ });
321
+ });
322
+ });
323
+
324
+ // ============================================================================
325
+ // deleteBlocker Tests
326
+ // ============================================================================
327
+
328
+ describe('deleteBlocker', () => {
329
+ beforeEach(() => vi.clearAllMocks());
330
+
331
+ it('should throw error for missing blocker_id', async () => {
332
+ const ctx = createMockContext();
333
+
334
+ await expect(deleteBlocker({}, ctx)).rejects.toThrow(ValidationError);
335
+ });
336
+
337
+ it('should throw error for invalid blocker_id UUID', async () => {
338
+ const ctx = createMockContext();
339
+
340
+ await expect(
341
+ deleteBlocker({ blocker_id: 'invalid' }, ctx)
342
+ ).rejects.toThrow(ValidationError);
343
+ });
344
+
345
+ it('should delete blocker successfully', async () => {
346
+ mockApiClient.deleteBlocker.mockResolvedValue({
347
+ ok: true,
348
+ data: { success: true },
349
+ });
350
+ const ctx = createMockContext();
351
+
352
+ const result = await deleteBlocker(
353
+ { blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
354
+ ctx
355
+ );
356
+
357
+ expect(result.result).toMatchObject({
358
+ success: true,
359
+ });
360
+ });
361
+
362
+ it('should call API client deleteBlocker', async () => {
363
+ mockApiClient.deleteBlocker.mockResolvedValue({
364
+ ok: true,
365
+ data: { success: true },
366
+ });
367
+ const ctx = createMockContext();
368
+
369
+ await deleteBlocker(
370
+ { blocker_id: '123e4567-e89b-12d3-a456-426614174000' },
371
+ ctx
372
+ );
373
+
374
+ expect(mockApiClient.deleteBlocker).toHaveBeenCalledWith(
375
+ '123e4567-e89b-12d3-a456-426614174000'
376
+ );
377
+ });
378
+
379
+ it('should return error when API call fails', async () => {
380
+ mockApiClient.deleteBlocker.mockResolvedValue({
381
+ ok: false,
382
+ error: 'Delete failed',
383
+ });
384
+ const ctx = createMockContext();
385
+
386
+ const result = await deleteBlocker({ blocker_id: '123e4567-e89b-12d3-a456-426614174000' }, ctx);
387
+
388
+ expect(result.isError).toBe(true);
389
+ expect(result.result).toMatchObject({
390
+ error: 'Delete failed',
391
+ });
392
+ });
393
+ });
394
+
395
+ // ============================================================================
396
+ // getBlockersStats Tests
397
+ // ============================================================================
398
+
399
+ describe('getBlockersStats', () => {
400
+ beforeEach(() => vi.clearAllMocks());
401
+
402
+ it('should throw error for missing project_id', async () => {
403
+ const ctx = createMockContext();
404
+
405
+ await expect(getBlockersStats({}, ctx)).rejects.toThrow(ValidationError);
406
+ });
407
+
408
+ it('should throw error for invalid project_id UUID', async () => {
409
+ const ctx = createMockContext();
410
+
411
+ await expect(
412
+ getBlockersStats({ project_id: 'invalid' }, ctx)
413
+ ).rejects.toThrow(ValidationError);
414
+ });
415
+
416
+ it('should return blockers stats', async () => {
417
+ mockApiClient.getBlockersStats.mockResolvedValue({
418
+ ok: true,
419
+ data: {
420
+ total: 5,
421
+ by_status: { open: 3, resolved: 2 },
422
+ },
423
+ });
424
+ const ctx = createMockContext();
425
+
426
+ const result = await getBlockersStats(
427
+ { project_id: '123e4567-e89b-12d3-a456-426614174000' },
428
+ ctx
429
+ );
430
+
431
+ expect(result.result).toMatchObject({
432
+ total: 5,
433
+ by_status: { open: 3, resolved: 2 },
434
+ });
435
+ });
436
+
437
+ it('should call API client getBlockersStats', async () => {
438
+ mockApiClient.getBlockersStats.mockResolvedValue({
439
+ ok: true,
440
+ data: { total: 0, by_status: {} },
441
+ });
442
+ const ctx = createMockContext();
443
+
444
+ await getBlockersStats(
445
+ { project_id: '123e4567-e89b-12d3-a456-426614174000' },
446
+ ctx
447
+ );
448
+
449
+ expect(mockApiClient.getBlockersStats).toHaveBeenCalledWith(
450
+ '123e4567-e89b-12d3-a456-426614174000'
451
+ );
452
+ });
453
+
454
+ it('should return error when API call fails', async () => {
455
+ mockApiClient.getBlockersStats.mockResolvedValue({
456
+ ok: false,
457
+ error: 'Query failed',
458
+ });
459
+ const ctx = createMockContext();
460
+
461
+ const result = await getBlockersStats({ project_id: '123e4567-e89b-12d3-a456-426614174000' }, ctx);
462
+
463
+ expect(result.isError).toBe(true);
464
+ expect(result.result).toMatchObject({
465
+ error: 'Query failed',
466
+ });
467
+ });
468
+ });