@vibescope/mcp-server 0.4.5 → 0.4.6

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