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