@vibescope/mcp-server 0.2.9 → 0.3.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 (95) hide show
  1. package/CHANGELOG.md +84 -84
  2. package/README.md +194 -194
  3. package/dist/api-client.d.ts +36 -0
  4. package/dist/api-client.js +34 -0
  5. package/dist/cli.d.ts +1 -1
  6. package/dist/cli.js +30 -38
  7. package/dist/handlers/discovery.js +2 -0
  8. package/dist/handlers/session.d.ts +11 -0
  9. package/dist/handlers/session.js +101 -0
  10. package/dist/handlers/tasks.d.ts +8 -0
  11. package/dist/handlers/tasks.js +163 -3
  12. package/dist/handlers/tool-docs.js +840 -828
  13. package/dist/handlers/validation.js +49 -2
  14. package/dist/index.js +73 -73
  15. package/dist/setup.js +6 -6
  16. package/dist/templates/agent-guidelines.js +185 -185
  17. package/dist/templates/help-content.js +1622 -1544
  18. package/dist/tools.js +130 -74
  19. package/dist/utils.d.ts +15 -11
  20. package/dist/utils.js +53 -28
  21. package/docs/TOOLS.md +2407 -2053
  22. package/package.json +51 -51
  23. package/scripts/generate-docs.ts +212 -212
  24. package/scripts/version-bump.ts +203 -203
  25. package/src/api-client.test.ts +723 -723
  26. package/src/api-client.ts +2561 -2499
  27. package/src/cli.test.ts +24 -8
  28. package/src/cli.ts +204 -212
  29. package/src/handlers/__test-setup__.ts +236 -236
  30. package/src/handlers/__test-utils__.ts +87 -87
  31. package/src/handlers/blockers.test.ts +468 -468
  32. package/src/handlers/blockers.ts +163 -163
  33. package/src/handlers/bodies-of-work.test.ts +704 -704
  34. package/src/handlers/bodies-of-work.ts +526 -526
  35. package/src/handlers/connectors.test.ts +834 -834
  36. package/src/handlers/connectors.ts +229 -229
  37. package/src/handlers/cost.test.ts +462 -462
  38. package/src/handlers/cost.ts +285 -285
  39. package/src/handlers/decisions.test.ts +382 -382
  40. package/src/handlers/decisions.ts +153 -153
  41. package/src/handlers/deployment.test.ts +551 -551
  42. package/src/handlers/deployment.ts +541 -541
  43. package/src/handlers/discovery.test.ts +206 -206
  44. package/src/handlers/discovery.ts +392 -390
  45. package/src/handlers/fallback.test.ts +537 -537
  46. package/src/handlers/fallback.ts +194 -194
  47. package/src/handlers/file-checkouts.test.ts +750 -750
  48. package/src/handlers/file-checkouts.ts +185 -185
  49. package/src/handlers/findings.test.ts +633 -633
  50. package/src/handlers/findings.ts +239 -239
  51. package/src/handlers/git-issues.test.ts +631 -631
  52. package/src/handlers/git-issues.ts +136 -136
  53. package/src/handlers/ideas.test.ts +644 -644
  54. package/src/handlers/ideas.ts +207 -207
  55. package/src/handlers/index.ts +84 -84
  56. package/src/handlers/milestones.test.ts +475 -475
  57. package/src/handlers/milestones.ts +180 -180
  58. package/src/handlers/organizations.test.ts +826 -826
  59. package/src/handlers/organizations.ts +315 -315
  60. package/src/handlers/progress.test.ts +269 -269
  61. package/src/handlers/progress.ts +77 -77
  62. package/src/handlers/project.test.ts +546 -546
  63. package/src/handlers/project.ts +239 -239
  64. package/src/handlers/requests.test.ts +303 -303
  65. package/src/handlers/requests.ts +99 -99
  66. package/src/handlers/roles.test.ts +305 -305
  67. package/src/handlers/roles.ts +219 -219
  68. package/src/handlers/session.test.ts +998 -875
  69. package/src/handlers/session.ts +839 -730
  70. package/src/handlers/sprints.test.ts +732 -732
  71. package/src/handlers/sprints.ts +537 -537
  72. package/src/handlers/tasks.test.ts +931 -907
  73. package/src/handlers/tasks.ts +1121 -945
  74. package/src/handlers/tool-categories.test.ts +66 -66
  75. package/src/handlers/tool-docs.ts +1109 -1096
  76. package/src/handlers/types.test.ts +259 -259
  77. package/src/handlers/types.ts +175 -175
  78. package/src/handlers/validation.test.ts +582 -582
  79. package/src/handlers/validation.ts +164 -113
  80. package/src/index.test.ts +674 -0
  81. package/src/index.ts +792 -792
  82. package/src/setup.test.ts +233 -233
  83. package/src/setup.ts +404 -403
  84. package/src/templates/agent-guidelines.ts +210 -210
  85. package/src/templates/help-content.ts +1751 -1673
  86. package/src/token-tracking.test.ts +463 -463
  87. package/src/token-tracking.ts +166 -166
  88. package/src/tools.test.ts +416 -0
  89. package/src/tools.ts +3611 -3555
  90. package/src/utils.test.ts +785 -683
  91. package/src/utils.ts +469 -436
  92. package/src/validators.test.ts +223 -223
  93. package/src/validators.ts +249 -249
  94. package/tsconfig.json +16 -16
  95. 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
+ });