@vibescope/mcp-server 0.2.5 → 0.2.7

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 (82) hide show
  1. package/CHANGELOG.md +84 -84
  2. package/README.md +194 -194
  3. package/dist/cli.js +26 -26
  4. package/dist/handlers/tool-docs.js +828 -828
  5. package/dist/index.js +73 -73
  6. package/dist/templates/agent-guidelines.js +185 -185
  7. package/dist/token-tracking.js +4 -2
  8. package/dist/tools.js +65 -65
  9. package/dist/utils.js +11 -11
  10. package/docs/TOOLS.md +2053 -2053
  11. package/package.json +3 -2
  12. package/scripts/generate-docs.ts +212 -212
  13. package/scripts/version-bump.ts +203 -203
  14. package/src/api-client.test.ts +723 -723
  15. package/src/api-client.ts +2499 -2499
  16. package/src/cli.ts +212 -212
  17. package/src/handlers/__test-setup__.ts +236 -236
  18. package/src/handlers/__test-utils__.ts +87 -87
  19. package/src/handlers/blockers.test.ts +468 -468
  20. package/src/handlers/blockers.ts +163 -163
  21. package/src/handlers/bodies-of-work.test.ts +704 -704
  22. package/src/handlers/bodies-of-work.ts +526 -526
  23. package/src/handlers/connectors.test.ts +834 -834
  24. package/src/handlers/connectors.ts +229 -229
  25. package/src/handlers/cost.test.ts +462 -462
  26. package/src/handlers/cost.ts +285 -285
  27. package/src/handlers/decisions.test.ts +382 -382
  28. package/src/handlers/decisions.ts +153 -153
  29. package/src/handlers/deployment.test.ts +551 -551
  30. package/src/handlers/deployment.ts +541 -541
  31. package/src/handlers/discovery.test.ts +206 -206
  32. package/src/handlers/discovery.ts +390 -390
  33. package/src/handlers/fallback.test.ts +537 -537
  34. package/src/handlers/fallback.ts +194 -194
  35. package/src/handlers/file-checkouts.test.ts +750 -750
  36. package/src/handlers/file-checkouts.ts +185 -185
  37. package/src/handlers/findings.test.ts +633 -633
  38. package/src/handlers/findings.ts +239 -239
  39. package/src/handlers/git-issues.test.ts +631 -631
  40. package/src/handlers/git-issues.ts +136 -136
  41. package/src/handlers/ideas.test.ts +644 -644
  42. package/src/handlers/ideas.ts +207 -207
  43. package/src/handlers/index.ts +84 -84
  44. package/src/handlers/milestones.test.ts +475 -475
  45. package/src/handlers/milestones.ts +180 -180
  46. package/src/handlers/organizations.test.ts +826 -826
  47. package/src/handlers/organizations.ts +315 -315
  48. package/src/handlers/progress.test.ts +269 -269
  49. package/src/handlers/progress.ts +77 -77
  50. package/src/handlers/project.test.ts +546 -546
  51. package/src/handlers/project.ts +239 -239
  52. package/src/handlers/requests.test.ts +303 -303
  53. package/src/handlers/requests.ts +99 -99
  54. package/src/handlers/roles.test.ts +303 -303
  55. package/src/handlers/roles.ts +226 -226
  56. package/src/handlers/session.test.ts +875 -875
  57. package/src/handlers/session.ts +738 -738
  58. package/src/handlers/sprints.test.ts +732 -732
  59. package/src/handlers/sprints.ts +537 -537
  60. package/src/handlers/tasks.test.ts +907 -907
  61. package/src/handlers/tasks.ts +945 -945
  62. package/src/handlers/tool-categories.test.ts +66 -66
  63. package/src/handlers/tool-docs.ts +1096 -1096
  64. package/src/handlers/types.test.ts +259 -259
  65. package/src/handlers/types.ts +175 -175
  66. package/src/handlers/validation.test.ts +582 -582
  67. package/src/handlers/validation.ts +97 -97
  68. package/src/index.ts +792 -792
  69. package/src/setup.test.ts +233 -231
  70. package/src/setup.ts +370 -370
  71. package/src/templates/agent-guidelines.ts +210 -210
  72. package/src/token-tracking.test.ts +463 -453
  73. package/src/token-tracking.ts +166 -164
  74. package/src/tools.ts +3562 -3562
  75. package/src/utils.test.ts +683 -683
  76. package/src/utils.ts +436 -436
  77. package/src/validators.test.ts +223 -223
  78. package/src/validators.ts +249 -249
  79. package/tsconfig.json +16 -16
  80. package/vitest.config.ts +14 -14
  81. package/dist/knowledge.d.ts +0 -6
  82. package/dist/knowledge.js +0 -218
package/src/setup.test.ts CHANGED
@@ -1,231 +1,233 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest';
2
-
3
- // Mock node:fs before importing setup module
4
- vi.mock('node:fs', () => ({
5
- existsSync: vi.fn(),
6
- readFileSync: vi.fn(),
7
- writeFileSync: vi.fn(),
8
- mkdirSync: vi.fn(),
9
- }));
10
-
11
- // Mock node:os
12
- vi.mock('node:os', () => ({
13
- homedir: vi.fn(() => '/home/testuser'),
14
- platform: vi.fn(() => 'darwin'),
15
- }));
16
-
17
- import { existsSync } from 'node:fs';
18
- import { homedir, platform } from 'node:os';
19
- import { detectIdes, generateMcpConfig, type IdeConfig } from './setup.js';
20
-
21
- describe('Setup module', () => {
22
- beforeEach(() => {
23
- vi.clearAllMocks();
24
- vi.mocked(homedir).mockReturnValue('/home/testuser');
25
- vi.mocked(platform).mockReturnValue('darwin');
26
- });
27
-
28
- describe('detectIdes', () => {
29
- it('should always include Claude Code as detected', () => {
30
- vi.mocked(existsSync).mockReturnValue(false);
31
- const ides = detectIdes();
32
- const claudeCode = ides.find(ide => ide.name === 'claude-code');
33
-
34
- expect(claudeCode).toBeDefined();
35
- expect(claudeCode?.detected).toBe(true);
36
- expect(claudeCode?.configPath).toBe('.mcp.json');
37
- expect(claudeCode?.configFormat).toBe('mcp-json');
38
- });
39
-
40
- it('should always include Gemini CLI as detected', () => {
41
- vi.mocked(existsSync).mockReturnValue(false);
42
- const ides = detectIdes();
43
- const gemini = ides.find(ide => ide.name === 'gemini');
44
-
45
- expect(gemini).toBeDefined();
46
- expect(gemini?.detected).toBe(true);
47
- expect(gemini?.configFormat).toBe('settings-json');
48
- });
49
-
50
- it('should detect Claude Desktop when directory exists', () => {
51
- vi.mocked(existsSync).mockImplementation((path: unknown) => {
52
- if (typeof path === 'string' && path.includes('Claude')) {
53
- return true;
54
- }
55
- return false;
56
- });
57
-
58
- const ides = detectIdes();
59
- const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
60
-
61
- expect(claudeDesktop).toBeDefined();
62
- expect(claudeDesktop?.detected).toBe(true);
63
- });
64
-
65
- it('should not detect Claude Desktop when directory does not exist', () => {
66
- vi.mocked(existsSync).mockReturnValue(false);
67
-
68
- const ides = detectIdes();
69
- const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
70
-
71
- expect(claudeDesktop).toBeDefined();
72
- expect(claudeDesktop?.detected).toBe(false);
73
- });
74
-
75
- it('should detect Cursor when directory exists', () => {
76
- vi.mocked(existsSync).mockImplementation((path: unknown) => {
77
- if (typeof path === 'string' && path.includes('Cursor')) {
78
- return true;
79
- }
80
- return false;
81
- });
82
-
83
- const ides = detectIdes();
84
- const cursor = ides.find(ide => ide.name === 'cursor');
85
-
86
- expect(cursor).toBeDefined();
87
- expect(cursor?.detected).toBe(true);
88
- });
89
-
90
- it('should return all four IDE configs', () => {
91
- vi.mocked(existsSync).mockReturnValue(false);
92
- const ides = detectIdes();
93
-
94
- expect(ides).toHaveLength(4);
95
- expect(ides.map(ide => ide.name)).toEqual([
96
- 'claude-code',
97
- 'claude-desktop',
98
- 'cursor',
99
- 'gemini',
100
- ]);
101
- });
102
-
103
- it('should use correct config paths on macOS', () => {
104
- vi.mocked(platform).mockReturnValue('darwin');
105
- vi.mocked(homedir).mockReturnValue('/Users/testuser');
106
- vi.mocked(existsSync).mockReturnValue(true);
107
-
108
- const ides = detectIdes();
109
-
110
- const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
111
- expect(claudeDesktop?.configPath).toContain('Library/Application Support/Claude');
112
-
113
- const cursor = ides.find(ide => ide.name === 'cursor');
114
- expect(cursor?.configPath).toContain('Library/Application Support/Cursor');
115
-
116
- const gemini = ides.find(ide => ide.name === 'gemini');
117
- expect(gemini?.configPath).toBe('/Users/testuser/.gemini/settings.json');
118
- });
119
-
120
- it('should use correct config paths on Windows', () => {
121
- vi.mocked(platform).mockReturnValue('win32');
122
- vi.mocked(homedir).mockReturnValue('C:\\Users\\testuser');
123
- vi.mocked(existsSync).mockReturnValue(true);
124
-
125
- const ides = detectIdes();
126
-
127
- const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
128
- // Note: path.join uses OS separator, so we check for path components
129
- expect(claudeDesktop?.configPath).toMatch(/AppData.*Roaming.*Claude/);
130
-
131
- const cursor = ides.find(ide => ide.name === 'cursor');
132
- expect(cursor?.configPath).toMatch(/AppData.*Roaming.*Cursor/);
133
- });
134
-
135
- it('should use correct config paths on Linux', () => {
136
- vi.mocked(platform).mockReturnValue('linux');
137
- vi.mocked(homedir).mockReturnValue('/home/testuser');
138
- vi.mocked(existsSync).mockReturnValue(true);
139
-
140
- const ides = detectIdes();
141
-
142
- const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
143
- expect(claudeDesktop?.configPath).toContain('.config/Claude');
144
-
145
- const cursor = ides.find(ide => ide.name === 'cursor');
146
- expect(cursor?.configPath).toContain('.config/Cursor');
147
- });
148
- });
149
-
150
- describe('IdeConfig types', () => {
151
- it('should have correct config format for MCP-based IDEs', () => {
152
- vi.mocked(existsSync).mockReturnValue(true);
153
- const ides = detectIdes();
154
-
155
- const claudeCode = ides.find(ide => ide.name === 'claude-code');
156
- const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
157
- const cursor = ides.find(ide => ide.name === 'cursor');
158
-
159
- expect(claudeCode?.configFormat).toBe('mcp-json');
160
- expect(claudeDesktop?.configFormat).toBe('mcp-json');
161
- expect(cursor?.configFormat).toBe('mcp-json');
162
- });
163
-
164
- it('should have correct config format for Gemini CLI', () => {
165
- vi.mocked(existsSync).mockReturnValue(true);
166
- const ides = detectIdes();
167
-
168
- const gemini = ides.find(ide => ide.name === 'gemini');
169
- expect(gemini?.configFormat).toBe('settings-json');
170
- });
171
- });
172
-
173
- describe('generateMcpConfig', () => {
174
- it('should generate correct config structure for standard MCP IDEs', () => {
175
- const claudeCodeIde: IdeConfig = {
176
- name: 'claude-code',
177
- displayName: 'Claude Code (CLI)',
178
- configPath: '.mcp.json',
179
- detected: true,
180
- configFormat: 'mcp-json',
181
- };
182
-
183
- const config = generateMcpConfig('test-api-key', claudeCodeIde);
184
- const mcpServers = config.mcpServers as Record<string, unknown>;
185
- const vibescope = mcpServers.vibescope as Record<string, unknown>;
186
-
187
- expect(vibescope.command).toBe('npx');
188
- expect(vibescope.args).toContain('@vibescope/mcp-server@latest');
189
- expect((vibescope.env as Record<string, string>).VIBESCOPE_API_KEY).toBe('test-api-key');
190
- // Standard MCP config should NOT have timeout/trust
191
- expect(vibescope.timeout).toBeUndefined();
192
- expect(vibescope.trust).toBeUndefined();
193
- });
194
-
195
- it('should include timeout and trust for Gemini CLI config', () => {
196
- const geminiIde: IdeConfig = {
197
- name: 'gemini',
198
- displayName: 'Gemini CLI',
199
- configPath: '~/.gemini/settings.json',
200
- detected: true,
201
- configFormat: 'settings-json',
202
- };
203
-
204
- const config = generateMcpConfig('test-api-key', geminiIde);
205
- const mcpServers = config.mcpServers as Record<string, unknown>;
206
- const vibescope = mcpServers.vibescope as Record<string, unknown>;
207
-
208
- expect(vibescope.command).toBe('npx');
209
- expect(vibescope.args).toContain('@vibescope/mcp-server@latest');
210
- expect((vibescope.env as Record<string, string>).VIBESCOPE_API_KEY).toBe('test-api-key');
211
- expect(vibescope.timeout).toBe(30000);
212
- expect(vibescope.trust).toBe(true);
213
- });
214
-
215
- it('should use correct npx args format', () => {
216
- const ide: IdeConfig = {
217
- name: 'claude-code',
218
- displayName: 'Claude Code (CLI)',
219
- configPath: '.mcp.json',
220
- detected: true,
221
- configFormat: 'mcp-json',
222
- };
223
-
224
- const config = generateMcpConfig('my-key', ide);
225
- const mcpServers = config.mcpServers as Record<string, unknown>;
226
- const vibescope = mcpServers.vibescope as Record<string, unknown>;
227
-
228
- expect(vibescope.args).toEqual(['-y', '-p', '@vibescope/mcp-server@latest', 'vibescope-mcp']);
229
- });
230
- });
231
- });
1
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
2
+
3
+ // Mock node:fs before importing setup module
4
+ vi.mock('node:fs', () => ({
5
+ existsSync: vi.fn(),
6
+ readFileSync: vi.fn(),
7
+ writeFileSync: vi.fn(),
8
+ mkdirSync: vi.fn(),
9
+ }));
10
+
11
+ // Mock node:os
12
+ vi.mock('node:os', () => ({
13
+ homedir: vi.fn(() => '/home/testuser'),
14
+ platform: vi.fn(() => 'darwin'),
15
+ }));
16
+
17
+ import { existsSync } from 'node:fs';
18
+ import { homedir, platform } from 'node:os';
19
+ import { detectIdes, generateMcpConfig, type IdeConfig } from './setup.js';
20
+
21
+ describe('Setup module', () => {
22
+ beforeEach(() => {
23
+ vi.clearAllMocks();
24
+ vi.mocked(homedir).mockReturnValue('/home/testuser');
25
+ vi.mocked(platform).mockReturnValue('darwin');
26
+ });
27
+
28
+ describe('detectIdes', () => {
29
+ it('should always include Claude Code as detected', () => {
30
+ vi.mocked(existsSync).mockReturnValue(false);
31
+ const ides = detectIdes();
32
+ const claudeCode = ides.find(ide => ide.name === 'claude-code');
33
+
34
+ expect(claudeCode).toBeDefined();
35
+ expect(claudeCode?.detected).toBe(true);
36
+ expect(claudeCode?.configPath).toBe('.mcp.json');
37
+ expect(claudeCode?.configFormat).toBe('mcp-json');
38
+ });
39
+
40
+ it('should always include Gemini CLI as detected', () => {
41
+ vi.mocked(existsSync).mockReturnValue(false);
42
+ const ides = detectIdes();
43
+ const gemini = ides.find(ide => ide.name === 'gemini');
44
+
45
+ expect(gemini).toBeDefined();
46
+ expect(gemini?.detected).toBe(true);
47
+ expect(gemini?.configFormat).toBe('settings-json');
48
+ });
49
+
50
+ it('should detect Claude Desktop when directory exists', () => {
51
+ vi.mocked(existsSync).mockImplementation((path: unknown) => {
52
+ if (typeof path === 'string' && path.includes('Claude')) {
53
+ return true;
54
+ }
55
+ return false;
56
+ });
57
+
58
+ const ides = detectIdes();
59
+ const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
60
+
61
+ expect(claudeDesktop).toBeDefined();
62
+ expect(claudeDesktop?.detected).toBe(true);
63
+ });
64
+
65
+ it('should not detect Claude Desktop when directory does not exist', () => {
66
+ vi.mocked(existsSync).mockReturnValue(false);
67
+
68
+ const ides = detectIdes();
69
+ const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
70
+
71
+ expect(claudeDesktop).toBeDefined();
72
+ expect(claudeDesktop?.detected).toBe(false);
73
+ });
74
+
75
+ it('should detect Cursor when directory exists', () => {
76
+ vi.mocked(existsSync).mockImplementation((path: unknown) => {
77
+ if (typeof path === 'string' && path.includes('Cursor')) {
78
+ return true;
79
+ }
80
+ return false;
81
+ });
82
+
83
+ const ides = detectIdes();
84
+ const cursor = ides.find(ide => ide.name === 'cursor');
85
+
86
+ expect(cursor).toBeDefined();
87
+ expect(cursor?.detected).toBe(true);
88
+ });
89
+
90
+ it('should return all four IDE configs', () => {
91
+ vi.mocked(existsSync).mockReturnValue(false);
92
+ const ides = detectIdes();
93
+
94
+ expect(ides).toHaveLength(4);
95
+ expect(ides.map(ide => ide.name)).toEqual([
96
+ 'claude-code',
97
+ 'claude-desktop',
98
+ 'cursor',
99
+ 'gemini',
100
+ ]);
101
+ });
102
+
103
+ it('should use correct config paths on macOS', () => {
104
+ vi.mocked(platform).mockReturnValue('darwin');
105
+ vi.mocked(homedir).mockReturnValue('/Users/testuser');
106
+ vi.mocked(existsSync).mockReturnValue(true);
107
+
108
+ const ides = detectIdes();
109
+
110
+ const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
111
+ // Note: path.join uses OS separator, so we check for path components
112
+ expect(claudeDesktop?.configPath).toMatch(/Library.*Application Support.*Claude/);
113
+
114
+ const cursor = ides.find(ide => ide.name === 'cursor');
115
+ expect(cursor?.configPath).toMatch(/Library.*Application Support.*Cursor/);
116
+
117
+ const gemini = ides.find(ide => ide.name === 'gemini');
118
+ expect(gemini?.configPath).toMatch(/Users.*testuser.*\.gemini.*settings\.json/);
119
+ });
120
+
121
+ it('should use correct config paths on Windows', () => {
122
+ vi.mocked(platform).mockReturnValue('win32');
123
+ vi.mocked(homedir).mockReturnValue('C:\\Users\\testuser');
124
+ vi.mocked(existsSync).mockReturnValue(true);
125
+
126
+ const ides = detectIdes();
127
+
128
+ const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
129
+ // Note: path.join uses OS separator, so we check for path components
130
+ expect(claudeDesktop?.configPath).toMatch(/AppData.*Roaming.*Claude/);
131
+
132
+ const cursor = ides.find(ide => ide.name === 'cursor');
133
+ expect(cursor?.configPath).toMatch(/AppData.*Roaming.*Cursor/);
134
+ });
135
+
136
+ it('should use correct config paths on Linux', () => {
137
+ vi.mocked(platform).mockReturnValue('linux');
138
+ vi.mocked(homedir).mockReturnValue('/home/testuser');
139
+ vi.mocked(existsSync).mockReturnValue(true);
140
+
141
+ const ides = detectIdes();
142
+
143
+ const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
144
+ // Note: path.join uses OS separator, so we check for path components
145
+ expect(claudeDesktop?.configPath).toMatch(/\.config.*Claude/);
146
+
147
+ const cursor = ides.find(ide => ide.name === 'cursor');
148
+ expect(cursor?.configPath).toMatch(/\.config.*Cursor/);
149
+ });
150
+ });
151
+
152
+ describe('IdeConfig types', () => {
153
+ it('should have correct config format for MCP-based IDEs', () => {
154
+ vi.mocked(existsSync).mockReturnValue(true);
155
+ const ides = detectIdes();
156
+
157
+ const claudeCode = ides.find(ide => ide.name === 'claude-code');
158
+ const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
159
+ const cursor = ides.find(ide => ide.name === 'cursor');
160
+
161
+ expect(claudeCode?.configFormat).toBe('mcp-json');
162
+ expect(claudeDesktop?.configFormat).toBe('mcp-json');
163
+ expect(cursor?.configFormat).toBe('mcp-json');
164
+ });
165
+
166
+ it('should have correct config format for Gemini CLI', () => {
167
+ vi.mocked(existsSync).mockReturnValue(true);
168
+ const ides = detectIdes();
169
+
170
+ const gemini = ides.find(ide => ide.name === 'gemini');
171
+ expect(gemini?.configFormat).toBe('settings-json');
172
+ });
173
+ });
174
+
175
+ describe('generateMcpConfig', () => {
176
+ it('should generate correct config structure for standard MCP IDEs', () => {
177
+ const claudeCodeIde: IdeConfig = {
178
+ name: 'claude-code',
179
+ displayName: 'Claude Code (CLI)',
180
+ configPath: '.mcp.json',
181
+ detected: true,
182
+ configFormat: 'mcp-json',
183
+ };
184
+
185
+ const config = generateMcpConfig('test-api-key', claudeCodeIde);
186
+ const mcpServers = config.mcpServers as Record<string, unknown>;
187
+ const vibescope = mcpServers.vibescope as Record<string, unknown>;
188
+
189
+ expect(vibescope.command).toBe('npx');
190
+ expect(vibescope.args).toContain('@vibescope/mcp-server@latest');
191
+ expect((vibescope.env as Record<string, string>).VIBESCOPE_API_KEY).toBe('test-api-key');
192
+ // Standard MCP config should NOT have timeout/trust
193
+ expect(vibescope.timeout).toBeUndefined();
194
+ expect(vibescope.trust).toBeUndefined();
195
+ });
196
+
197
+ it('should include timeout and trust for Gemini CLI config', () => {
198
+ const geminiIde: IdeConfig = {
199
+ name: 'gemini',
200
+ displayName: 'Gemini CLI',
201
+ configPath: '~/.gemini/settings.json',
202
+ detected: true,
203
+ configFormat: 'settings-json',
204
+ };
205
+
206
+ const config = generateMcpConfig('test-api-key', geminiIde);
207
+ const mcpServers = config.mcpServers as Record<string, unknown>;
208
+ const vibescope = mcpServers.vibescope as Record<string, unknown>;
209
+
210
+ expect(vibescope.command).toBe('npx');
211
+ expect(vibescope.args).toContain('@vibescope/mcp-server@latest');
212
+ expect((vibescope.env as Record<string, string>).VIBESCOPE_API_KEY).toBe('test-api-key');
213
+ expect(vibescope.timeout).toBe(30000);
214
+ expect(vibescope.trust).toBe(true);
215
+ });
216
+
217
+ it('should use correct npx args format', () => {
218
+ const ide: IdeConfig = {
219
+ name: 'claude-code',
220
+ displayName: 'Claude Code (CLI)',
221
+ configPath: '.mcp.json',
222
+ detected: true,
223
+ configFormat: 'mcp-json',
224
+ };
225
+
226
+ const config = generateMcpConfig('my-key', ide);
227
+ const mcpServers = config.mcpServers as Record<string, unknown>;
228
+ const vibescope = mcpServers.vibescope as Record<string, unknown>;
229
+
230
+ expect(vibescope.args).toEqual(['-y', '-p', '@vibescope/mcp-server@latest', 'vibescope-mcp']);
231
+ });
232
+ });
233
+ });