@vibescope/mcp-server 0.2.4 → 0.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/CHANGELOG.md +84 -84
  2. package/README.md +194 -181
  3. package/dist/cli.d.ts +6 -3
  4. package/dist/cli.js +28 -10
  5. package/dist/handlers/tool-docs.js +828 -828
  6. package/dist/index.js +73 -73
  7. package/dist/knowledge.d.ts +6 -0
  8. package/dist/knowledge.js +218 -0
  9. package/dist/setup.d.ts +22 -0
  10. package/dist/setup.js +313 -0
  11. package/dist/templates/agent-guidelines.js +185 -185
  12. package/dist/tools.js +65 -65
  13. package/dist/utils.js +11 -11
  14. package/docs/TOOLS.md +2053 -2053
  15. package/package.json +1 -1
  16. package/scripts/generate-docs.ts +212 -212
  17. package/scripts/version-bump.ts +203 -203
  18. package/src/api-client.test.ts +723 -723
  19. package/src/api-client.ts +2499 -2499
  20. package/src/cli.ts +27 -10
  21. package/src/handlers/__test-setup__.ts +236 -236
  22. package/src/handlers/__test-utils__.ts +87 -87
  23. package/src/handlers/blockers.test.ts +468 -468
  24. package/src/handlers/blockers.ts +163 -163
  25. package/src/handlers/bodies-of-work.test.ts +704 -704
  26. package/src/handlers/bodies-of-work.ts +526 -526
  27. package/src/handlers/connectors.test.ts +834 -834
  28. package/src/handlers/connectors.ts +229 -229
  29. package/src/handlers/cost.test.ts +462 -462
  30. package/src/handlers/cost.ts +285 -285
  31. package/src/handlers/decisions.test.ts +382 -382
  32. package/src/handlers/decisions.ts +153 -153
  33. package/src/handlers/deployment.test.ts +551 -551
  34. package/src/handlers/deployment.ts +541 -541
  35. package/src/handlers/discovery.test.ts +206 -206
  36. package/src/handlers/discovery.ts +390 -390
  37. package/src/handlers/fallback.test.ts +537 -537
  38. package/src/handlers/fallback.ts +194 -194
  39. package/src/handlers/file-checkouts.test.ts +750 -750
  40. package/src/handlers/file-checkouts.ts +185 -185
  41. package/src/handlers/findings.test.ts +633 -633
  42. package/src/handlers/findings.ts +239 -239
  43. package/src/handlers/git-issues.test.ts +631 -631
  44. package/src/handlers/git-issues.ts +136 -136
  45. package/src/handlers/ideas.test.ts +644 -644
  46. package/src/handlers/ideas.ts +207 -207
  47. package/src/handlers/index.ts +84 -84
  48. package/src/handlers/milestones.test.ts +475 -475
  49. package/src/handlers/milestones.ts +180 -180
  50. package/src/handlers/organizations.test.ts +826 -826
  51. package/src/handlers/organizations.ts +315 -315
  52. package/src/handlers/progress.test.ts +269 -269
  53. package/src/handlers/progress.ts +77 -77
  54. package/src/handlers/project.test.ts +546 -546
  55. package/src/handlers/project.ts +239 -239
  56. package/src/handlers/requests.test.ts +303 -303
  57. package/src/handlers/requests.ts +99 -99
  58. package/src/handlers/roles.test.ts +303 -303
  59. package/src/handlers/roles.ts +226 -226
  60. package/src/handlers/session.test.ts +875 -875
  61. package/src/handlers/session.ts +738 -738
  62. package/src/handlers/sprints.test.ts +732 -732
  63. package/src/handlers/sprints.ts +537 -537
  64. package/src/handlers/tasks.test.ts +907 -907
  65. package/src/handlers/tasks.ts +945 -945
  66. package/src/handlers/tool-categories.test.ts +66 -66
  67. package/src/handlers/tool-docs.ts +1096 -1096
  68. package/src/handlers/types.test.ts +259 -259
  69. package/src/handlers/types.ts +175 -175
  70. package/src/handlers/validation.test.ts +582 -582
  71. package/src/handlers/validation.ts +97 -97
  72. package/src/index.ts +792 -792
  73. package/src/setup.test.ts +231 -0
  74. package/src/setup.ts +370 -0
  75. package/src/templates/agent-guidelines.ts +210 -210
  76. package/src/token-tracking.test.ts +453 -453
  77. package/src/token-tracking.ts +164 -164
  78. package/src/tools.ts +3562 -3562
  79. package/src/utils.test.ts +683 -683
  80. package/src/utils.ts +436 -436
  81. package/src/validators.test.ts +223 -223
  82. package/src/validators.ts +249 -249
  83. package/tsconfig.json +16 -16
  84. package/vitest.config.ts +14 -14
@@ -1,462 +1,462 @@
1
- /**
2
- * Cost Handlers Unit Tests
3
- */
4
-
5
- import { describe, it, expect, vi, beforeEach } from 'vitest';
6
- import {
7
- getCostSummary,
8
- getCostAlerts,
9
- addCostAlert,
10
- updateCostAlert,
11
- deleteCostAlert,
12
- getTaskCosts,
13
- } from './cost.js';
14
- import { createMockContext } from './__test-utils__.js';
15
- import { mockApiClient } from './__test-setup__.js';
16
- import { ValidationError } from '../validators.js';
17
-
18
- const VALID_UUID = '123e4567-e89b-12d3-a456-426614174000';
19
-
20
- describe('Cost Handlers', () => {
21
- beforeEach(() => {
22
- vi.clearAllMocks();
23
- });
24
-
25
- // ============================================================================
26
- // getCostSummary
27
- // ============================================================================
28
-
29
- describe('getCostSummary', () => {
30
- it('should throw ValidationError when project_id is missing', async () => {
31
- const ctx = createMockContext();
32
-
33
- await expect(getCostSummary({}, ctx)).rejects.toThrow(ValidationError);
34
- await expect(getCostSummary({}, ctx)).rejects.toThrow('Missing required field: project_id');
35
- });
36
-
37
- it('should return daily cost summary with totals', async () => {
38
- const mockData = [
39
- {
40
- date: '2025-01-14',
41
- session_count: 5,
42
- total_tokens: 10000,
43
- total_calls: 50,
44
- estimated_cost_usd: '0.50',
45
- },
46
- {
47
- date: '2025-01-13',
48
- session_count: 3,
49
- total_tokens: 6000,
50
- total_calls: 30,
51
- estimated_cost_usd: '0.30',
52
- },
53
- ];
54
- mockApiClient.getCostSummary.mockResolvedValue({
55
- ok: true,
56
- data: {
57
- period: 'daily',
58
- summary: mockData,
59
- totals: {
60
- sessions: 8,
61
- tokens: 16000,
62
- calls: 80,
63
- cost: 0.8,
64
- },
65
- },
66
- });
67
- const ctx = createMockContext();
68
-
69
- const result = await getCostSummary({ project_id: VALID_UUID }, ctx);
70
-
71
- expect(result.isError).toBeUndefined();
72
- expect(result.result.period).toBe('daily');
73
- expect(result.result.summary).toEqual(mockData);
74
- expect(result.result.totals).toEqual({
75
- sessions: 8,
76
- tokens: 16000,
77
- calls: 80,
78
- cost: 0.8,
79
- });
80
- });
81
-
82
- it('should handle weekly period', async () => {
83
- mockApiClient.getCostSummary.mockResolvedValue({
84
- ok: true,
85
- data: { period: 'weekly', summary: [], totals: { sessions: 0, tokens: 0, calls: 0, cost: 0 } },
86
- });
87
- const ctx = createMockContext();
88
-
89
- const result = await getCostSummary(
90
- { project_id: VALID_UUID, period: 'weekly' },
91
- ctx
92
- );
93
-
94
- expect(result.result.period).toBe('weekly');
95
- expect(mockApiClient.getCostSummary).toHaveBeenCalledWith(
96
- VALID_UUID,
97
- expect.objectContaining({ period: 'weekly' })
98
- );
99
- });
100
-
101
- it('should handle monthly period', async () => {
102
- mockApiClient.getCostSummary.mockResolvedValue({
103
- ok: true,
104
- data: { period: 'monthly', summary: [], totals: { sessions: 0, tokens: 0, calls: 0, cost: 0 } },
105
- });
106
- const ctx = createMockContext();
107
-
108
- const result = await getCostSummary(
109
- { project_id: VALID_UUID, period: 'monthly' },
110
- ctx
111
- );
112
-
113
- expect(result.result.period).toBe('monthly');
114
- expect(mockApiClient.getCostSummary).toHaveBeenCalledWith(
115
- VALID_UUID,
116
- expect.objectContaining({ period: 'monthly' })
117
- );
118
- });
119
-
120
- it('should return error on API failure', async () => {
121
- mockApiClient.getCostSummary.mockResolvedValue({
122
- ok: false,
123
- error: 'Database error',
124
- });
125
- const ctx = createMockContext();
126
-
127
- const result = await getCostSummary({ project_id: VALID_UUID }, ctx);
128
-
129
- expect(result.isError).toBe(true);
130
- expect(result.result.error).toBe('Database error');
131
- });
132
- });
133
-
134
- // ============================================================================
135
- // getCostAlerts
136
- // ============================================================================
137
-
138
- describe('getCostAlerts', () => {
139
- it('should return all alerts for user', async () => {
140
- const mockAlerts = [
141
- { id: 'alert-1', threshold_amount: 10, threshold_period: 'daily' },
142
- { id: 'alert-2', threshold_amount: 50, threshold_period: 'weekly' },
143
- ];
144
- mockApiClient.getCostAlerts.mockResolvedValue({
145
- ok: true,
146
- data: { alerts: mockAlerts, count: 2 },
147
- });
148
- const ctx = createMockContext();
149
-
150
- const result = await getCostAlerts({}, ctx);
151
-
152
- expect(result.result.alerts).toEqual(mockAlerts);
153
- expect(result.result.count).toBe(2);
154
- });
155
-
156
- it('should call getCostAlerts with no args (project filtering done server-side)', async () => {
157
- mockApiClient.getCostAlerts.mockResolvedValue({
158
- ok: true,
159
- data: { alerts: [], count: 0 },
160
- });
161
- const ctx = createMockContext();
162
-
163
- await getCostAlerts({ project_id: VALID_UUID }, ctx);
164
-
165
- expect(mockApiClient.getCostAlerts).toHaveBeenCalledWith();
166
- });
167
-
168
- it('should return error on API failure', async () => {
169
- mockApiClient.getCostAlerts.mockResolvedValue({
170
- ok: false,
171
- error: 'Query failed',
172
- });
173
- const ctx = createMockContext();
174
-
175
- const result = await getCostAlerts({}, ctx);
176
-
177
- expect(result.isError).toBe(true);
178
- expect(result.result.error).toBe('Query failed');
179
- });
180
- });
181
-
182
- // ============================================================================
183
- // addCostAlert
184
- // ============================================================================
185
-
186
- describe('addCostAlert', () => {
187
- it('should throw ValidationError when threshold_amount is missing', async () => {
188
- const ctx = createMockContext();
189
-
190
- await expect(
191
- addCostAlert({ threshold_period: 'daily' }, ctx)
192
- ).rejects.toThrow(ValidationError);
193
- await expect(
194
- addCostAlert({ threshold_period: 'daily' }, ctx)
195
- ).rejects.toThrow('Missing required field: threshold_amount');
196
- });
197
-
198
- it('should throw ValidationError when threshold_amount is not positive', async () => {
199
- const ctx = createMockContext();
200
-
201
- await expect(
202
- addCostAlert({ threshold_amount: -5, threshold_period: 'daily' }, ctx)
203
- ).rejects.toThrow(ValidationError);
204
- await expect(
205
- addCostAlert({ threshold_amount: -5, threshold_period: 'daily' }, ctx)
206
- ).rejects.toThrow('threshold_amount must be a positive number');
207
- });
208
-
209
- it('should throw ValidationError when threshold_period is invalid', async () => {
210
- const ctx = createMockContext();
211
-
212
- await expect(
213
- addCostAlert({ threshold_amount: 10, threshold_period: 'yearly' }, ctx)
214
- ).rejects.toThrow(ValidationError);
215
- await expect(
216
- addCostAlert({ threshold_amount: 10, threshold_period: 'yearly' }, ctx)
217
- ).rejects.toThrow('Invalid threshold_period');
218
- });
219
-
220
- it('should create alert successfully', async () => {
221
- const mockAlert = {
222
- id: 'new-alert',
223
- threshold_amount: 10,
224
- threshold_period: 'daily',
225
- alert_type: 'warning',
226
- };
227
- mockApiClient.addCostAlert.mockResolvedValue({
228
- ok: true,
229
- data: { success: true, alert: mockAlert, message: 'Alert created' },
230
- });
231
- const ctx = createMockContext();
232
-
233
- const result = await addCostAlert(
234
- { threshold_amount: 10, threshold_period: 'daily' },
235
- ctx
236
- );
237
-
238
- expect(result.result.success).toBe(true);
239
- expect(result.result.alert).toEqual(mockAlert);
240
- expect(result.result.message).toContain('Alert created');
241
- });
242
-
243
- it('should create alert with project_id', async () => {
244
- mockApiClient.addCostAlert.mockResolvedValue({
245
- ok: true,
246
- data: { success: true, alert: { id: 'new-alert' } },
247
- });
248
- const ctx = createMockContext();
249
-
250
- await addCostAlert(
251
- {
252
- project_id: VALID_UUID,
253
- threshold_amount: 10,
254
- threshold_period: 'daily',
255
- },
256
- ctx
257
- );
258
-
259
- expect(mockApiClient.addCostAlert).toHaveBeenCalledWith(
260
- expect.objectContaining({
261
- project_id: VALID_UUID,
262
- threshold_amount: 10,
263
- threshold_period: 'daily',
264
- })
265
- );
266
- });
267
-
268
- it('should return error on API failure', async () => {
269
- mockApiClient.addCostAlert.mockResolvedValue({
270
- ok: false,
271
- error: 'Insert failed',
272
- });
273
- const ctx = createMockContext();
274
-
275
- const result = await addCostAlert(
276
- { threshold_amount: 10, threshold_period: 'daily' },
277
- ctx
278
- );
279
-
280
- expect(result.isError).toBe(true);
281
- expect(result.result.error).toBe('Insert failed');
282
- });
283
- });
284
-
285
- // ============================================================================
286
- // updateCostAlert
287
- // ============================================================================
288
-
289
- describe('updateCostAlert', () => {
290
- it('should throw ValidationError when alert_id is missing', async () => {
291
- const ctx = createMockContext();
292
-
293
- await expect(updateCostAlert({}, ctx)).rejects.toThrow(ValidationError);
294
- await expect(updateCostAlert({}, ctx)).rejects.toThrow('Missing required field: alert_id');
295
- });
296
-
297
- it('should return error when no updates provided', async () => {
298
- const ctx = createMockContext();
299
-
300
- const result = await updateCostAlert({ alert_id: VALID_UUID }, ctx);
301
-
302
- expect(result.isError).toBe(true);
303
- expect(result.result.error).toBe('No updates provided');
304
- });
305
-
306
- it('should update alert successfully', async () => {
307
- const mockUpdatedAlert = {
308
- id: VALID_UUID,
309
- threshold_amount: 20,
310
- threshold_period: 'weekly',
311
- };
312
- mockApiClient.updateCostAlert.mockResolvedValue({
313
- ok: true,
314
- data: { success: true, alert: mockUpdatedAlert },
315
- });
316
- const ctx = createMockContext();
317
-
318
- const result = await updateCostAlert(
319
- { alert_id: VALID_UUID, threshold_amount: 20 },
320
- ctx
321
- );
322
-
323
- expect(result.result.success).toBe(true);
324
- expect(result.result.alert).toEqual(mockUpdatedAlert);
325
- });
326
-
327
- it('should update enabled status', async () => {
328
- mockApiClient.updateCostAlert.mockResolvedValue({
329
- ok: true,
330
- data: { success: true, alert: { id: VALID_UUID, enabled: false } },
331
- });
332
- const ctx = createMockContext();
333
-
334
- await updateCostAlert({ alert_id: VALID_UUID, enabled: false }, ctx);
335
-
336
- expect(mockApiClient.updateCostAlert).toHaveBeenCalledWith(
337
- VALID_UUID,
338
- expect.objectContaining({ enabled: false })
339
- );
340
- });
341
-
342
- it('should return error on API failure', async () => {
343
- mockApiClient.updateCostAlert.mockResolvedValue({
344
- ok: false,
345
- error: 'Update failed',
346
- });
347
- const ctx = createMockContext();
348
-
349
- const result = await updateCostAlert(
350
- { alert_id: VALID_UUID, threshold_amount: 20 },
351
- ctx
352
- );
353
-
354
- expect(result.isError).toBe(true);
355
- expect(result.result.error).toBe('Update failed');
356
- });
357
- });
358
-
359
- // ============================================================================
360
- // deleteCostAlert
361
- // ============================================================================
362
-
363
- describe('deleteCostAlert', () => {
364
- it('should throw ValidationError when alert_id is missing', async () => {
365
- const ctx = createMockContext();
366
-
367
- await expect(deleteCostAlert({}, ctx)).rejects.toThrow(ValidationError);
368
- await expect(deleteCostAlert({}, ctx)).rejects.toThrow('Missing required field: alert_id');
369
- });
370
-
371
- it('should delete alert successfully', async () => {
372
- mockApiClient.deleteCostAlert.mockResolvedValue({
373
- ok: true,
374
- data: { success: true, deleted_alert_id: VALID_UUID },
375
- });
376
- const ctx = createMockContext();
377
-
378
- const result = await deleteCostAlert({ alert_id: VALID_UUID }, ctx);
379
-
380
- expect(result.result.success).toBe(true);
381
- expect(result.result.deleted_alert_id).toBe(VALID_UUID);
382
- });
383
-
384
- it('should return error on API failure', async () => {
385
- mockApiClient.deleteCostAlert.mockResolvedValue({
386
- ok: false,
387
- error: 'Delete failed',
388
- });
389
- const ctx = createMockContext();
390
-
391
- const result = await deleteCostAlert({ alert_id: VALID_UUID }, ctx);
392
-
393
- expect(result.isError).toBe(true);
394
- expect(result.result.error).toBe('Delete failed');
395
- });
396
- });
397
-
398
- // ============================================================================
399
- // getTaskCosts
400
- // ============================================================================
401
-
402
- describe('getTaskCosts', () => {
403
- it('should throw ValidationError when project_id is missing', async () => {
404
- const ctx = createMockContext();
405
-
406
- await expect(getTaskCosts({}, ctx)).rejects.toThrow(ValidationError);
407
- await expect(getTaskCosts({}, ctx)).rejects.toThrow('Missing required field: project_id');
408
- });
409
-
410
- it('should return task costs with total', async () => {
411
- const mockTasks = [
412
- { id: 'task-1', title: 'Task 1', estimated_cost_usd: '0.50' },
413
- { id: 'task-2', title: 'Task 2', estimated_cost_usd: '0.30' },
414
- ];
415
- mockApiClient.getTaskCosts.mockResolvedValue({
416
- ok: true,
417
- data: {
418
- project_id: VALID_UUID,
419
- tasks: mockTasks,
420
- total_cost_usd: 0.8,
421
- },
422
- });
423
- const ctx = createMockContext();
424
-
425
- const result = await getTaskCosts({ project_id: VALID_UUID }, ctx);
426
-
427
- expect(result.result.project_id).toBe(VALID_UUID);
428
- expect(result.result.tasks).toEqual(mockTasks);
429
- expect(result.result.total_cost_usd).toBe(0.8);
430
- });
431
-
432
- it('should handle empty task list', async () => {
433
- mockApiClient.getTaskCosts.mockResolvedValue({
434
- ok: true,
435
- data: {
436
- project_id: VALID_UUID,
437
- tasks: [],
438
- total_cost_usd: 0,
439
- },
440
- });
441
- const ctx = createMockContext();
442
-
443
- const result = await getTaskCosts({ project_id: VALID_UUID }, ctx);
444
-
445
- expect(result.result.tasks).toEqual([]);
446
- expect(result.result.total_cost_usd).toBe(0);
447
- });
448
-
449
- it('should return error on API failure', async () => {
450
- mockApiClient.getTaskCosts.mockResolvedValue({
451
- ok: false,
452
- error: 'Query failed',
453
- });
454
- const ctx = createMockContext();
455
-
456
- const result = await getTaskCosts({ project_id: VALID_UUID }, ctx);
457
-
458
- expect(result.isError).toBe(true);
459
- expect(result.result.error).toBe('Query failed');
460
- });
461
- });
462
- });
1
+ /**
2
+ * Cost Handlers Unit Tests
3
+ */
4
+
5
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
6
+ import {
7
+ getCostSummary,
8
+ getCostAlerts,
9
+ addCostAlert,
10
+ updateCostAlert,
11
+ deleteCostAlert,
12
+ getTaskCosts,
13
+ } from './cost.js';
14
+ import { createMockContext } from './__test-utils__.js';
15
+ import { mockApiClient } from './__test-setup__.js';
16
+ import { ValidationError } from '../validators.js';
17
+
18
+ const VALID_UUID = '123e4567-e89b-12d3-a456-426614174000';
19
+
20
+ describe('Cost Handlers', () => {
21
+ beforeEach(() => {
22
+ vi.clearAllMocks();
23
+ });
24
+
25
+ // ============================================================================
26
+ // getCostSummary
27
+ // ============================================================================
28
+
29
+ describe('getCostSummary', () => {
30
+ it('should throw ValidationError when project_id is missing', async () => {
31
+ const ctx = createMockContext();
32
+
33
+ await expect(getCostSummary({}, ctx)).rejects.toThrow(ValidationError);
34
+ await expect(getCostSummary({}, ctx)).rejects.toThrow('Missing required field: project_id');
35
+ });
36
+
37
+ it('should return daily cost summary with totals', async () => {
38
+ const mockData = [
39
+ {
40
+ date: '2025-01-14',
41
+ session_count: 5,
42
+ total_tokens: 10000,
43
+ total_calls: 50,
44
+ estimated_cost_usd: '0.50',
45
+ },
46
+ {
47
+ date: '2025-01-13',
48
+ session_count: 3,
49
+ total_tokens: 6000,
50
+ total_calls: 30,
51
+ estimated_cost_usd: '0.30',
52
+ },
53
+ ];
54
+ mockApiClient.getCostSummary.mockResolvedValue({
55
+ ok: true,
56
+ data: {
57
+ period: 'daily',
58
+ summary: mockData,
59
+ totals: {
60
+ sessions: 8,
61
+ tokens: 16000,
62
+ calls: 80,
63
+ cost: 0.8,
64
+ },
65
+ },
66
+ });
67
+ const ctx = createMockContext();
68
+
69
+ const result = await getCostSummary({ project_id: VALID_UUID }, ctx);
70
+
71
+ expect(result.isError).toBeUndefined();
72
+ expect(result.result.period).toBe('daily');
73
+ expect(result.result.summary).toEqual(mockData);
74
+ expect(result.result.totals).toEqual({
75
+ sessions: 8,
76
+ tokens: 16000,
77
+ calls: 80,
78
+ cost: 0.8,
79
+ });
80
+ });
81
+
82
+ it('should handle weekly period', async () => {
83
+ mockApiClient.getCostSummary.mockResolvedValue({
84
+ ok: true,
85
+ data: { period: 'weekly', summary: [], totals: { sessions: 0, tokens: 0, calls: 0, cost: 0 } },
86
+ });
87
+ const ctx = createMockContext();
88
+
89
+ const result = await getCostSummary(
90
+ { project_id: VALID_UUID, period: 'weekly' },
91
+ ctx
92
+ );
93
+
94
+ expect(result.result.period).toBe('weekly');
95
+ expect(mockApiClient.getCostSummary).toHaveBeenCalledWith(
96
+ VALID_UUID,
97
+ expect.objectContaining({ period: 'weekly' })
98
+ );
99
+ });
100
+
101
+ it('should handle monthly period', async () => {
102
+ mockApiClient.getCostSummary.mockResolvedValue({
103
+ ok: true,
104
+ data: { period: 'monthly', summary: [], totals: { sessions: 0, tokens: 0, calls: 0, cost: 0 } },
105
+ });
106
+ const ctx = createMockContext();
107
+
108
+ const result = await getCostSummary(
109
+ { project_id: VALID_UUID, period: 'monthly' },
110
+ ctx
111
+ );
112
+
113
+ expect(result.result.period).toBe('monthly');
114
+ expect(mockApiClient.getCostSummary).toHaveBeenCalledWith(
115
+ VALID_UUID,
116
+ expect.objectContaining({ period: 'monthly' })
117
+ );
118
+ });
119
+
120
+ it('should return error on API failure', async () => {
121
+ mockApiClient.getCostSummary.mockResolvedValue({
122
+ ok: false,
123
+ error: 'Database error',
124
+ });
125
+ const ctx = createMockContext();
126
+
127
+ const result = await getCostSummary({ project_id: VALID_UUID }, ctx);
128
+
129
+ expect(result.isError).toBe(true);
130
+ expect(result.result.error).toBe('Database error');
131
+ });
132
+ });
133
+
134
+ // ============================================================================
135
+ // getCostAlerts
136
+ // ============================================================================
137
+
138
+ describe('getCostAlerts', () => {
139
+ it('should return all alerts for user', async () => {
140
+ const mockAlerts = [
141
+ { id: 'alert-1', threshold_amount: 10, threshold_period: 'daily' },
142
+ { id: 'alert-2', threshold_amount: 50, threshold_period: 'weekly' },
143
+ ];
144
+ mockApiClient.getCostAlerts.mockResolvedValue({
145
+ ok: true,
146
+ data: { alerts: mockAlerts, count: 2 },
147
+ });
148
+ const ctx = createMockContext();
149
+
150
+ const result = await getCostAlerts({}, ctx);
151
+
152
+ expect(result.result.alerts).toEqual(mockAlerts);
153
+ expect(result.result.count).toBe(2);
154
+ });
155
+
156
+ it('should call getCostAlerts with no args (project filtering done server-side)', async () => {
157
+ mockApiClient.getCostAlerts.mockResolvedValue({
158
+ ok: true,
159
+ data: { alerts: [], count: 0 },
160
+ });
161
+ const ctx = createMockContext();
162
+
163
+ await getCostAlerts({ project_id: VALID_UUID }, ctx);
164
+
165
+ expect(mockApiClient.getCostAlerts).toHaveBeenCalledWith();
166
+ });
167
+
168
+ it('should return error on API failure', async () => {
169
+ mockApiClient.getCostAlerts.mockResolvedValue({
170
+ ok: false,
171
+ error: 'Query failed',
172
+ });
173
+ const ctx = createMockContext();
174
+
175
+ const result = await getCostAlerts({}, ctx);
176
+
177
+ expect(result.isError).toBe(true);
178
+ expect(result.result.error).toBe('Query failed');
179
+ });
180
+ });
181
+
182
+ // ============================================================================
183
+ // addCostAlert
184
+ // ============================================================================
185
+
186
+ describe('addCostAlert', () => {
187
+ it('should throw ValidationError when threshold_amount is missing', async () => {
188
+ const ctx = createMockContext();
189
+
190
+ await expect(
191
+ addCostAlert({ threshold_period: 'daily' }, ctx)
192
+ ).rejects.toThrow(ValidationError);
193
+ await expect(
194
+ addCostAlert({ threshold_period: 'daily' }, ctx)
195
+ ).rejects.toThrow('Missing required field: threshold_amount');
196
+ });
197
+
198
+ it('should throw ValidationError when threshold_amount is not positive', async () => {
199
+ const ctx = createMockContext();
200
+
201
+ await expect(
202
+ addCostAlert({ threshold_amount: -5, threshold_period: 'daily' }, ctx)
203
+ ).rejects.toThrow(ValidationError);
204
+ await expect(
205
+ addCostAlert({ threshold_amount: -5, threshold_period: 'daily' }, ctx)
206
+ ).rejects.toThrow('threshold_amount must be a positive number');
207
+ });
208
+
209
+ it('should throw ValidationError when threshold_period is invalid', async () => {
210
+ const ctx = createMockContext();
211
+
212
+ await expect(
213
+ addCostAlert({ threshold_amount: 10, threshold_period: 'yearly' }, ctx)
214
+ ).rejects.toThrow(ValidationError);
215
+ await expect(
216
+ addCostAlert({ threshold_amount: 10, threshold_period: 'yearly' }, ctx)
217
+ ).rejects.toThrow('Invalid threshold_period');
218
+ });
219
+
220
+ it('should create alert successfully', async () => {
221
+ const mockAlert = {
222
+ id: 'new-alert',
223
+ threshold_amount: 10,
224
+ threshold_period: 'daily',
225
+ alert_type: 'warning',
226
+ };
227
+ mockApiClient.addCostAlert.mockResolvedValue({
228
+ ok: true,
229
+ data: { success: true, alert: mockAlert, message: 'Alert created' },
230
+ });
231
+ const ctx = createMockContext();
232
+
233
+ const result = await addCostAlert(
234
+ { threshold_amount: 10, threshold_period: 'daily' },
235
+ ctx
236
+ );
237
+
238
+ expect(result.result.success).toBe(true);
239
+ expect(result.result.alert).toEqual(mockAlert);
240
+ expect(result.result.message).toContain('Alert created');
241
+ });
242
+
243
+ it('should create alert with project_id', async () => {
244
+ mockApiClient.addCostAlert.mockResolvedValue({
245
+ ok: true,
246
+ data: { success: true, alert: { id: 'new-alert' } },
247
+ });
248
+ const ctx = createMockContext();
249
+
250
+ await addCostAlert(
251
+ {
252
+ project_id: VALID_UUID,
253
+ threshold_amount: 10,
254
+ threshold_period: 'daily',
255
+ },
256
+ ctx
257
+ );
258
+
259
+ expect(mockApiClient.addCostAlert).toHaveBeenCalledWith(
260
+ expect.objectContaining({
261
+ project_id: VALID_UUID,
262
+ threshold_amount: 10,
263
+ threshold_period: 'daily',
264
+ })
265
+ );
266
+ });
267
+
268
+ it('should return error on API failure', async () => {
269
+ mockApiClient.addCostAlert.mockResolvedValue({
270
+ ok: false,
271
+ error: 'Insert failed',
272
+ });
273
+ const ctx = createMockContext();
274
+
275
+ const result = await addCostAlert(
276
+ { threshold_amount: 10, threshold_period: 'daily' },
277
+ ctx
278
+ );
279
+
280
+ expect(result.isError).toBe(true);
281
+ expect(result.result.error).toBe('Insert failed');
282
+ });
283
+ });
284
+
285
+ // ============================================================================
286
+ // updateCostAlert
287
+ // ============================================================================
288
+
289
+ describe('updateCostAlert', () => {
290
+ it('should throw ValidationError when alert_id is missing', async () => {
291
+ const ctx = createMockContext();
292
+
293
+ await expect(updateCostAlert({}, ctx)).rejects.toThrow(ValidationError);
294
+ await expect(updateCostAlert({}, ctx)).rejects.toThrow('Missing required field: alert_id');
295
+ });
296
+
297
+ it('should return error when no updates provided', async () => {
298
+ const ctx = createMockContext();
299
+
300
+ const result = await updateCostAlert({ alert_id: VALID_UUID }, ctx);
301
+
302
+ expect(result.isError).toBe(true);
303
+ expect(result.result.error).toBe('No updates provided');
304
+ });
305
+
306
+ it('should update alert successfully', async () => {
307
+ const mockUpdatedAlert = {
308
+ id: VALID_UUID,
309
+ threshold_amount: 20,
310
+ threshold_period: 'weekly',
311
+ };
312
+ mockApiClient.updateCostAlert.mockResolvedValue({
313
+ ok: true,
314
+ data: { success: true, alert: mockUpdatedAlert },
315
+ });
316
+ const ctx = createMockContext();
317
+
318
+ const result = await updateCostAlert(
319
+ { alert_id: VALID_UUID, threshold_amount: 20 },
320
+ ctx
321
+ );
322
+
323
+ expect(result.result.success).toBe(true);
324
+ expect(result.result.alert).toEqual(mockUpdatedAlert);
325
+ });
326
+
327
+ it('should update enabled status', async () => {
328
+ mockApiClient.updateCostAlert.mockResolvedValue({
329
+ ok: true,
330
+ data: { success: true, alert: { id: VALID_UUID, enabled: false } },
331
+ });
332
+ const ctx = createMockContext();
333
+
334
+ await updateCostAlert({ alert_id: VALID_UUID, enabled: false }, ctx);
335
+
336
+ expect(mockApiClient.updateCostAlert).toHaveBeenCalledWith(
337
+ VALID_UUID,
338
+ expect.objectContaining({ enabled: false })
339
+ );
340
+ });
341
+
342
+ it('should return error on API failure', async () => {
343
+ mockApiClient.updateCostAlert.mockResolvedValue({
344
+ ok: false,
345
+ error: 'Update failed',
346
+ });
347
+ const ctx = createMockContext();
348
+
349
+ const result = await updateCostAlert(
350
+ { alert_id: VALID_UUID, threshold_amount: 20 },
351
+ ctx
352
+ );
353
+
354
+ expect(result.isError).toBe(true);
355
+ expect(result.result.error).toBe('Update failed');
356
+ });
357
+ });
358
+
359
+ // ============================================================================
360
+ // deleteCostAlert
361
+ // ============================================================================
362
+
363
+ describe('deleteCostAlert', () => {
364
+ it('should throw ValidationError when alert_id is missing', async () => {
365
+ const ctx = createMockContext();
366
+
367
+ await expect(deleteCostAlert({}, ctx)).rejects.toThrow(ValidationError);
368
+ await expect(deleteCostAlert({}, ctx)).rejects.toThrow('Missing required field: alert_id');
369
+ });
370
+
371
+ it('should delete alert successfully', async () => {
372
+ mockApiClient.deleteCostAlert.mockResolvedValue({
373
+ ok: true,
374
+ data: { success: true, deleted_alert_id: VALID_UUID },
375
+ });
376
+ const ctx = createMockContext();
377
+
378
+ const result = await deleteCostAlert({ alert_id: VALID_UUID }, ctx);
379
+
380
+ expect(result.result.success).toBe(true);
381
+ expect(result.result.deleted_alert_id).toBe(VALID_UUID);
382
+ });
383
+
384
+ it('should return error on API failure', async () => {
385
+ mockApiClient.deleteCostAlert.mockResolvedValue({
386
+ ok: false,
387
+ error: 'Delete failed',
388
+ });
389
+ const ctx = createMockContext();
390
+
391
+ const result = await deleteCostAlert({ alert_id: VALID_UUID }, ctx);
392
+
393
+ expect(result.isError).toBe(true);
394
+ expect(result.result.error).toBe('Delete failed');
395
+ });
396
+ });
397
+
398
+ // ============================================================================
399
+ // getTaskCosts
400
+ // ============================================================================
401
+
402
+ describe('getTaskCosts', () => {
403
+ it('should throw ValidationError when project_id is missing', async () => {
404
+ const ctx = createMockContext();
405
+
406
+ await expect(getTaskCosts({}, ctx)).rejects.toThrow(ValidationError);
407
+ await expect(getTaskCosts({}, ctx)).rejects.toThrow('Missing required field: project_id');
408
+ });
409
+
410
+ it('should return task costs with total', async () => {
411
+ const mockTasks = [
412
+ { id: 'task-1', title: 'Task 1', estimated_cost_usd: '0.50' },
413
+ { id: 'task-2', title: 'Task 2', estimated_cost_usd: '0.30' },
414
+ ];
415
+ mockApiClient.getTaskCosts.mockResolvedValue({
416
+ ok: true,
417
+ data: {
418
+ project_id: VALID_UUID,
419
+ tasks: mockTasks,
420
+ total_cost_usd: 0.8,
421
+ },
422
+ });
423
+ const ctx = createMockContext();
424
+
425
+ const result = await getTaskCosts({ project_id: VALID_UUID }, ctx);
426
+
427
+ expect(result.result.project_id).toBe(VALID_UUID);
428
+ expect(result.result.tasks).toEqual(mockTasks);
429
+ expect(result.result.total_cost_usd).toBe(0.8);
430
+ });
431
+
432
+ it('should handle empty task list', async () => {
433
+ mockApiClient.getTaskCosts.mockResolvedValue({
434
+ ok: true,
435
+ data: {
436
+ project_id: VALID_UUID,
437
+ tasks: [],
438
+ total_cost_usd: 0,
439
+ },
440
+ });
441
+ const ctx = createMockContext();
442
+
443
+ const result = await getTaskCosts({ project_id: VALID_UUID }, ctx);
444
+
445
+ expect(result.result.tasks).toEqual([]);
446
+ expect(result.result.total_cost_usd).toBe(0);
447
+ });
448
+
449
+ it('should return error on API failure', async () => {
450
+ mockApiClient.getTaskCosts.mockResolvedValue({
451
+ ok: false,
452
+ error: 'Query failed',
453
+ });
454
+ const ctx = createMockContext();
455
+
456
+ const result = await getTaskCosts({ project_id: VALID_UUID }, ctx);
457
+
458
+ expect(result.isError).toBe(true);
459
+ expect(result.result.error).toBe('Query failed');
460
+ });
461
+ });
462
+ });