@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,259 +1,259 @@
1
- import { describe, it, expect } from 'vitest';
2
- import {
3
- success,
4
- error,
5
- isSuccess,
6
- isError,
7
- type HandlerResult,
8
- type SuccessResult,
9
- type ErrorResult,
10
- } from './types.js';
11
-
12
- describe('success', () => {
13
- it('should create a success result with simple data', () => {
14
- const result = success({ message: 'hello' });
15
- expect(result.result).toEqual({ message: 'hello' });
16
- expect(result.isError).toBeUndefined();
17
- });
18
-
19
- it('should create a success result with string data', () => {
20
- const result = success('test string');
21
- expect(result.result).toBe('test string');
22
- });
23
-
24
- it('should create a success result with number data', () => {
25
- const result = success(42);
26
- expect(result.result).toBe(42);
27
- });
28
-
29
- it('should create a success result with boolean data', () => {
30
- const result = success(true);
31
- expect(result.result).toBe(true);
32
- });
33
-
34
- it('should create a success result with null data', () => {
35
- const result = success(null);
36
- expect(result.result).toBeNull();
37
- });
38
-
39
- it('should create a success result with undefined data', () => {
40
- const result = success(undefined);
41
- expect(result.result).toBeUndefined();
42
- });
43
-
44
- it('should create a success result with array data', () => {
45
- const result = success([1, 2, 3]);
46
- expect(result.result).toEqual([1, 2, 3]);
47
- });
48
-
49
- it('should create a success result with nested object data', () => {
50
- const data = {
51
- tasks: [{ id: '1', title: 'Task 1' }],
52
- total_count: 1,
53
- metadata: { page: 1, limit: 10 },
54
- };
55
- const result = success(data);
56
- expect(result.result).toEqual(data);
57
- });
58
-
59
- it('should preserve type information', () => {
60
- interface TaskData {
61
- id: string;
62
- title: string;
63
- }
64
- const result: SuccessResult<TaskData> = success({ id: '1', title: 'Test' });
65
- expect(result.result.id).toBe('1');
66
- expect(result.result.title).toBe('Test');
67
- });
68
- });
69
-
70
- describe('error', () => {
71
- it('should create an error result with message only', () => {
72
- const result = error('Something went wrong');
73
- expect(result.result.error).toBe('Something went wrong');
74
- expect(result.isError).toBe(true);
75
- });
76
-
77
- it('should create an error result with message and details', () => {
78
- const result = error('Validation failed', { field: 'title', reason: 'too long' });
79
- expect(result.result.error).toBe('Validation failed');
80
- expect(result.result.field).toBe('title');
81
- expect(result.result.reason).toBe('too long');
82
- expect(result.isError).toBe(true);
83
- });
84
-
85
- it('should handle empty details object', () => {
86
- const result = error('Error message', {});
87
- expect(result.result.error).toBe('Error message');
88
- expect(result.isError).toBe(true);
89
- });
90
-
91
- it('should handle complex details', () => {
92
- const result = error('Multiple errors', {
93
- errors: ['error1', 'error2'],
94
- count: 2,
95
- nested: { key: 'value' },
96
- });
97
- expect(result.result.error).toBe('Multiple errors');
98
- expect(result.result.errors).toEqual(['error1', 'error2']);
99
- expect(result.result.count).toBe(2);
100
- expect(result.result.nested).toEqual({ key: 'value' });
101
- });
102
-
103
- it('should always set isError to true', () => {
104
- const result1 = error('error1');
105
- const result2 = error('error2', { detail: 'info' });
106
- expect(result1.isError).toBe(true);
107
- expect(result2.isError).toBe(true);
108
- });
109
- });
110
-
111
- describe('isSuccess', () => {
112
- it('should return true for success results', () => {
113
- const result = success({ data: 'test' });
114
- expect(isSuccess(result)).toBe(true);
115
- });
116
-
117
- it('should return true for success results with various data types', () => {
118
- expect(isSuccess(success('string'))).toBe(true);
119
- expect(isSuccess(success(123))).toBe(true);
120
- expect(isSuccess(success(null))).toBe(true);
121
- expect(isSuccess(success([]))).toBe(true);
122
- expect(isSuccess(success({}))).toBe(true);
123
- });
124
-
125
- it('should return false for error results', () => {
126
- const result = error('Something failed');
127
- expect(isSuccess(result)).toBe(false);
128
- });
129
-
130
- it('should return false for error results with details', () => {
131
- const result = error('Validation error', { field: 'name' });
132
- expect(isSuccess(result)).toBe(false);
133
- });
134
-
135
- it('should narrow type correctly for success', () => {
136
- const result: HandlerResult<{ id: string }> = success({ id: '123' });
137
- if (isSuccess(result)) {
138
- // TypeScript should know result.result is { id: string }
139
- expect(result.result.id).toBe('123');
140
- }
141
- });
142
-
143
- it('should work with explicitly typed results', () => {
144
- const successResult: SuccessResult<number> = { result: 42 };
145
- const errorResult: ErrorResult = { result: { error: 'fail' }, isError: true };
146
-
147
- expect(isSuccess(successResult)).toBe(true);
148
- expect(isSuccess(errorResult)).toBe(false);
149
- });
150
- });
151
-
152
- describe('isError', () => {
153
- it('should return true for error results', () => {
154
- const result = error('Something failed');
155
- expect(isError(result)).toBe(true);
156
- });
157
-
158
- it('should return true for error results with details', () => {
159
- const result = error('Validation error', { field: 'name', code: 'INVALID' });
160
- expect(isError(result)).toBe(true);
161
- });
162
-
163
- it('should return false for success results', () => {
164
- const result = success({ data: 'test' });
165
- expect(isError(result)).toBe(false);
166
- });
167
-
168
- it('should return false for success results with various data types', () => {
169
- expect(isError(success('string'))).toBe(false);
170
- expect(isError(success(123))).toBe(false);
171
- expect(isError(success(null))).toBe(false);
172
- expect(isError(success([]))).toBe(false);
173
- expect(isError(success({}))).toBe(false);
174
- });
175
-
176
- it('should narrow type correctly for error', () => {
177
- const result: HandlerResult<unknown> = error('Task not found');
178
- if (isError(result)) {
179
- // TypeScript should know result.result.error is string
180
- expect(result.result.error).toBe('Task not found');
181
- }
182
- });
183
-
184
- it('should work with explicitly typed results', () => {
185
- const successResult: SuccessResult<number> = { result: 42 };
186
- const errorResult: ErrorResult = { result: { error: 'fail' }, isError: true };
187
-
188
- expect(isError(successResult)).toBe(false);
189
- expect(isError(errorResult)).toBe(true);
190
- });
191
- });
192
-
193
- describe('HandlerResult type usage', () => {
194
- it('should work with discriminated union pattern', () => {
195
- function processResult(result: HandlerResult<string>): string {
196
- if (isSuccess(result)) {
197
- return `Success: ${result.result}`;
198
- } else {
199
- return `Error: ${result.result.error}`;
200
- }
201
- }
202
-
203
- expect(processResult(success('hello'))).toBe('Success: hello');
204
- expect(processResult(error('failed'))).toBe('Error: failed');
205
- });
206
-
207
- it('should handle async handler patterns', async () => {
208
- async function mockHandler(): Promise<HandlerResult<{ id: string }>> {
209
- return success({ id: '123' });
210
- }
211
-
212
- const result = await mockHandler();
213
- expect(isSuccess(result)).toBe(true);
214
- if (isSuccess(result)) {
215
- expect(result.result.id).toBe('123');
216
- }
217
- });
218
-
219
- it('should handle error handler patterns', async () => {
220
- async function mockErrorHandler(): Promise<HandlerResult<{ id: string }>> {
221
- return error('Not found', { id: '123' });
222
- }
223
-
224
- const result = await mockErrorHandler();
225
- expect(isError(result)).toBe(true);
226
- if (isError(result)) {
227
- expect(result.result.error).toBe('Not found');
228
- expect(result.result.id).toBe('123');
229
- }
230
- });
231
- });
232
-
233
- describe('edge cases', () => {
234
- it('should handle result with isError explicitly set to false', () => {
235
- const result: SuccessResult<string> = { result: 'data', isError: false };
236
- expect(isSuccess(result)).toBe(true);
237
- expect(isError(result)).toBe(false);
238
- });
239
-
240
- it('should handle result without isError property', () => {
241
- const result: SuccessResult<string> = { result: 'data' };
242
- expect(isSuccess(result)).toBe(true);
243
- expect(isError(result)).toBe(false);
244
- });
245
-
246
- it('should handle success with error-like data', () => {
247
- // A success result that happens to contain an error message in its data
248
- const result = success({ error: 'This is not an error result', data: 'some data' });
249
- expect(isSuccess(result)).toBe(true);
250
- expect(isError(result)).toBe(false);
251
- });
252
-
253
- it('should handle empty string error message', () => {
254
- const result = error('');
255
- expect(result.result.error).toBe('');
256
- expect(result.isError).toBe(true);
257
- expect(isError(result)).toBe(true);
258
- });
259
- });
1
+ import { describe, it, expect } from 'vitest';
2
+ import {
3
+ success,
4
+ error,
5
+ isSuccess,
6
+ isError,
7
+ type HandlerResult,
8
+ type SuccessResult,
9
+ type ErrorResult,
10
+ } from './types.js';
11
+
12
+ describe('success', () => {
13
+ it('should create a success result with simple data', () => {
14
+ const result = success({ message: 'hello' });
15
+ expect(result.result).toEqual({ message: 'hello' });
16
+ expect(result.isError).toBeUndefined();
17
+ });
18
+
19
+ it('should create a success result with string data', () => {
20
+ const result = success('test string');
21
+ expect(result.result).toBe('test string');
22
+ });
23
+
24
+ it('should create a success result with number data', () => {
25
+ const result = success(42);
26
+ expect(result.result).toBe(42);
27
+ });
28
+
29
+ it('should create a success result with boolean data', () => {
30
+ const result = success(true);
31
+ expect(result.result).toBe(true);
32
+ });
33
+
34
+ it('should create a success result with null data', () => {
35
+ const result = success(null);
36
+ expect(result.result).toBeNull();
37
+ });
38
+
39
+ it('should create a success result with undefined data', () => {
40
+ const result = success(undefined);
41
+ expect(result.result).toBeUndefined();
42
+ });
43
+
44
+ it('should create a success result with array data', () => {
45
+ const result = success([1, 2, 3]);
46
+ expect(result.result).toEqual([1, 2, 3]);
47
+ });
48
+
49
+ it('should create a success result with nested object data', () => {
50
+ const data = {
51
+ tasks: [{ id: '1', title: 'Task 1' }],
52
+ total_count: 1,
53
+ metadata: { page: 1, limit: 10 },
54
+ };
55
+ const result = success(data);
56
+ expect(result.result).toEqual(data);
57
+ });
58
+
59
+ it('should preserve type information', () => {
60
+ interface TaskData {
61
+ id: string;
62
+ title: string;
63
+ }
64
+ const result: SuccessResult<TaskData> = success({ id: '1', title: 'Test' });
65
+ expect(result.result.id).toBe('1');
66
+ expect(result.result.title).toBe('Test');
67
+ });
68
+ });
69
+
70
+ describe('error', () => {
71
+ it('should create an error result with message only', () => {
72
+ const result = error('Something went wrong');
73
+ expect(result.result.error).toBe('Something went wrong');
74
+ expect(result.isError).toBe(true);
75
+ });
76
+
77
+ it('should create an error result with message and details', () => {
78
+ const result = error('Validation failed', { field: 'title', reason: 'too long' });
79
+ expect(result.result.error).toBe('Validation failed');
80
+ expect(result.result.field).toBe('title');
81
+ expect(result.result.reason).toBe('too long');
82
+ expect(result.isError).toBe(true);
83
+ });
84
+
85
+ it('should handle empty details object', () => {
86
+ const result = error('Error message', {});
87
+ expect(result.result.error).toBe('Error message');
88
+ expect(result.isError).toBe(true);
89
+ });
90
+
91
+ it('should handle complex details', () => {
92
+ const result = error('Multiple errors', {
93
+ errors: ['error1', 'error2'],
94
+ count: 2,
95
+ nested: { key: 'value' },
96
+ });
97
+ expect(result.result.error).toBe('Multiple errors');
98
+ expect(result.result.errors).toEqual(['error1', 'error2']);
99
+ expect(result.result.count).toBe(2);
100
+ expect(result.result.nested).toEqual({ key: 'value' });
101
+ });
102
+
103
+ it('should always set isError to true', () => {
104
+ const result1 = error('error1');
105
+ const result2 = error('error2', { detail: 'info' });
106
+ expect(result1.isError).toBe(true);
107
+ expect(result2.isError).toBe(true);
108
+ });
109
+ });
110
+
111
+ describe('isSuccess', () => {
112
+ it('should return true for success results', () => {
113
+ const result = success({ data: 'test' });
114
+ expect(isSuccess(result)).toBe(true);
115
+ });
116
+
117
+ it('should return true for success results with various data types', () => {
118
+ expect(isSuccess(success('string'))).toBe(true);
119
+ expect(isSuccess(success(123))).toBe(true);
120
+ expect(isSuccess(success(null))).toBe(true);
121
+ expect(isSuccess(success([]))).toBe(true);
122
+ expect(isSuccess(success({}))).toBe(true);
123
+ });
124
+
125
+ it('should return false for error results', () => {
126
+ const result = error('Something failed');
127
+ expect(isSuccess(result)).toBe(false);
128
+ });
129
+
130
+ it('should return false for error results with details', () => {
131
+ const result = error('Validation error', { field: 'name' });
132
+ expect(isSuccess(result)).toBe(false);
133
+ });
134
+
135
+ it('should narrow type correctly for success', () => {
136
+ const result: HandlerResult<{ id: string }> = success({ id: '123' });
137
+ if (isSuccess(result)) {
138
+ // TypeScript should know result.result is { id: string }
139
+ expect(result.result.id).toBe('123');
140
+ }
141
+ });
142
+
143
+ it('should work with explicitly typed results', () => {
144
+ const successResult: SuccessResult<number> = { result: 42 };
145
+ const errorResult: ErrorResult = { result: { error: 'fail' }, isError: true };
146
+
147
+ expect(isSuccess(successResult)).toBe(true);
148
+ expect(isSuccess(errorResult)).toBe(false);
149
+ });
150
+ });
151
+
152
+ describe('isError', () => {
153
+ it('should return true for error results', () => {
154
+ const result = error('Something failed');
155
+ expect(isError(result)).toBe(true);
156
+ });
157
+
158
+ it('should return true for error results with details', () => {
159
+ const result = error('Validation error', { field: 'name', code: 'INVALID' });
160
+ expect(isError(result)).toBe(true);
161
+ });
162
+
163
+ it('should return false for success results', () => {
164
+ const result = success({ data: 'test' });
165
+ expect(isError(result)).toBe(false);
166
+ });
167
+
168
+ it('should return false for success results with various data types', () => {
169
+ expect(isError(success('string'))).toBe(false);
170
+ expect(isError(success(123))).toBe(false);
171
+ expect(isError(success(null))).toBe(false);
172
+ expect(isError(success([]))).toBe(false);
173
+ expect(isError(success({}))).toBe(false);
174
+ });
175
+
176
+ it('should narrow type correctly for error', () => {
177
+ const result: HandlerResult<unknown> = error('Task not found');
178
+ if (isError(result)) {
179
+ // TypeScript should know result.result.error is string
180
+ expect(result.result.error).toBe('Task not found');
181
+ }
182
+ });
183
+
184
+ it('should work with explicitly typed results', () => {
185
+ const successResult: SuccessResult<number> = { result: 42 };
186
+ const errorResult: ErrorResult = { result: { error: 'fail' }, isError: true };
187
+
188
+ expect(isError(successResult)).toBe(false);
189
+ expect(isError(errorResult)).toBe(true);
190
+ });
191
+ });
192
+
193
+ describe('HandlerResult type usage', () => {
194
+ it('should work with discriminated union pattern', () => {
195
+ function processResult(result: HandlerResult<string>): string {
196
+ if (isSuccess(result)) {
197
+ return `Success: ${result.result}`;
198
+ } else {
199
+ return `Error: ${result.result.error}`;
200
+ }
201
+ }
202
+
203
+ expect(processResult(success('hello'))).toBe('Success: hello');
204
+ expect(processResult(error('failed'))).toBe('Error: failed');
205
+ });
206
+
207
+ it('should handle async handler patterns', async () => {
208
+ async function mockHandler(): Promise<HandlerResult<{ id: string }>> {
209
+ return success({ id: '123' });
210
+ }
211
+
212
+ const result = await mockHandler();
213
+ expect(isSuccess(result)).toBe(true);
214
+ if (isSuccess(result)) {
215
+ expect(result.result.id).toBe('123');
216
+ }
217
+ });
218
+
219
+ it('should handle error handler patterns', async () => {
220
+ async function mockErrorHandler(): Promise<HandlerResult<{ id: string }>> {
221
+ return error('Not found', { id: '123' });
222
+ }
223
+
224
+ const result = await mockErrorHandler();
225
+ expect(isError(result)).toBe(true);
226
+ if (isError(result)) {
227
+ expect(result.result.error).toBe('Not found');
228
+ expect(result.result.id).toBe('123');
229
+ }
230
+ });
231
+ });
232
+
233
+ describe('edge cases', () => {
234
+ it('should handle result with isError explicitly set to false', () => {
235
+ const result: SuccessResult<string> = { result: 'data', isError: false };
236
+ expect(isSuccess(result)).toBe(true);
237
+ expect(isError(result)).toBe(false);
238
+ });
239
+
240
+ it('should handle result without isError property', () => {
241
+ const result: SuccessResult<string> = { result: 'data' };
242
+ expect(isSuccess(result)).toBe(true);
243
+ expect(isError(result)).toBe(false);
244
+ });
245
+
246
+ it('should handle success with error-like data', () => {
247
+ // A success result that happens to contain an error message in its data
248
+ const result = success({ error: 'This is not an error result', data: 'some data' });
249
+ expect(isSuccess(result)).toBe(true);
250
+ expect(isError(result)).toBe(false);
251
+ });
252
+
253
+ it('should handle empty string error message', () => {
254
+ const result = error('');
255
+ expect(result.result.error).toBe('');
256
+ expect(result.isError).toBe(true);
257
+ expect(isError(result)).toBe(true);
258
+ });
259
+ });