@vibescope/mcp-server 0.2.8 → 0.3.0

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