@vibescope/mcp-server 0.4.4 → 0.4.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +84 -84
- package/README.md +194 -194
- package/dist/api-client/bodies-of-work.d.ts +125 -0
- package/dist/api-client/bodies-of-work.js +78 -0
- package/dist/api-client/chat.d.ts +26 -0
- package/dist/api-client/chat.js +20 -0
- package/dist/api-client/connectors.d.ts +104 -0
- package/dist/api-client/connectors.js +46 -0
- package/dist/api-client/deployment.d.ts +190 -0
- package/dist/api-client/deployment.js +113 -0
- package/dist/api-client/file-checkouts.d.ts +71 -0
- package/dist/api-client/file-checkouts.js +43 -0
- package/dist/api-client/git-issues.d.ts +55 -0
- package/dist/api-client/git-issues.js +34 -0
- package/dist/api-client/index.d.ts +619 -1
- package/dist/api-client/index.js +148 -0
- package/dist/api-client/organizations.d.ts +101 -0
- package/dist/api-client/organizations.js +86 -0
- package/dist/api-client/progress.d.ts +61 -0
- package/dist/api-client/progress.js +34 -0
- package/dist/api-client/project.d.ts +1 -0
- package/dist/api-client/requests.d.ts +28 -0
- package/dist/api-client/requests.js +28 -0
- package/dist/api-client/sprints.d.ts +153 -0
- package/dist/api-client/sprints.js +82 -0
- package/dist/api-client/subtasks.d.ts +37 -0
- package/dist/api-client/subtasks.js +23 -0
- package/dist/api-client.d.ts +23 -0
- package/dist/api-client.js +15 -0
- package/dist/cli-init.js +21 -21
- package/dist/cli.js +26 -26
- package/dist/handlers/blockers.js +4 -0
- package/dist/handlers/chat.d.ts +23 -0
- package/dist/handlers/chat.js +84 -0
- package/dist/handlers/deployment.d.ts +3 -0
- package/dist/handlers/deployment.js +23 -0
- package/dist/handlers/discovery.js +13 -0
- package/dist/handlers/index.d.ts +1 -0
- package/dist/handlers/index.js +3 -0
- package/dist/handlers/project.js +4 -2
- package/dist/handlers/session.js +7 -0
- package/dist/handlers/tasks.js +7 -0
- package/dist/handlers/tool-docs.js +1204 -1131
- package/dist/index.js +73 -73
- package/dist/templates/agent-guidelines.d.ts +1 -1
- package/dist/templates/agent-guidelines.js +205 -187
- package/dist/templates/help-content.js +1621 -1621
- package/dist/tools/bodies-of-work.js +6 -6
- package/dist/tools/chat.d.ts +1 -0
- package/dist/tools/chat.js +24 -0
- package/dist/tools/cloud-agents.js +22 -22
- package/dist/tools/deployment.js +13 -0
- package/dist/tools/features.d.ts +13 -0
- package/dist/tools/features.js +151 -0
- package/dist/tools/index.d.ts +3 -1
- package/dist/tools/index.js +4 -1
- package/dist/tools/milestones.js +2 -2
- package/dist/tools/project.js +4 -0
- package/dist/tools/requests.js +1 -1
- package/dist/tools/session.js +11 -11
- package/dist/tools/sprints.js +9 -9
- package/dist/tools/tasks.js +35 -35
- package/dist/tools/worktrees.js +14 -14
- package/dist/tools.d.ts +2 -0
- package/dist/tools.js +3602 -0
- package/dist/utils.js +11 -11
- package/docs/TOOLS.md +2663 -2545
- package/package.json +53 -53
- package/scripts/generate-docs.ts +212 -212
- package/scripts/version-bump.ts +203 -203
- package/src/api-client/blockers.ts +86 -86
- package/src/api-client/bodies-of-work.ts +194 -0
- package/src/api-client/chat.ts +50 -0
- package/src/api-client/connectors.ts +152 -0
- package/src/api-client/cost.ts +185 -185
- package/src/api-client/decisions.ts +87 -87
- package/src/api-client/deployment.ts +313 -0
- package/src/api-client/discovery.ts +81 -81
- package/src/api-client/fallback.ts +52 -52
- package/src/api-client/file-checkouts.ts +115 -0
- package/src/api-client/findings.ts +100 -100
- package/src/api-client/git-issues.ts +88 -0
- package/src/api-client/ideas.ts +112 -112
- package/src/api-client/index.ts +592 -426
- package/src/api-client/milestones.ts +83 -83
- package/src/api-client/organizations.ts +185 -0
- package/src/api-client/progress.ts +94 -0
- package/src/api-client/project.ts +180 -179
- package/src/api-client/requests.ts +54 -0
- package/src/api-client/session.ts +220 -220
- package/src/api-client/sprints.ts +227 -0
- package/src/api-client/subtasks.ts +57 -0
- package/src/api-client/tasks.ts +450 -450
- package/src/api-client/types.ts +32 -32
- package/src/api-client/validation.ts +60 -60
- package/src/api-client/worktrees.ts +53 -53
- package/src/api-client.test.ts +847 -850
- package/src/api-client.ts +2707 -2672
- package/src/cli-init.ts +557 -557
- package/src/cli.test.ts +284 -284
- package/src/cli.ts +204 -204
- package/src/handlers/__test-setup__.ts +240 -236
- package/src/handlers/__test-utils__.ts +89 -89
- package/src/handlers/blockers.test.ts +468 -468
- package/src/handlers/blockers.ts +172 -163
- package/src/handlers/bodies-of-work.test.ts +704 -704
- package/src/handlers/bodies-of-work.ts +526 -526
- package/src/handlers/chat.test.ts +185 -0
- package/src/handlers/chat.ts +101 -0
- package/src/handlers/cloud-agents.test.ts +438 -438
- package/src/handlers/cloud-agents.ts +156 -156
- package/src/handlers/connectors.test.ts +834 -834
- package/src/handlers/connectors.ts +229 -229
- package/src/handlers/cost.test.ts +462 -462
- package/src/handlers/cost.ts +285 -285
- package/src/handlers/decisions.test.ts +382 -382
- package/src/handlers/decisions.ts +153 -153
- package/src/handlers/deployment.test.ts +551 -551
- package/src/handlers/deployment.ts +570 -541
- package/src/handlers/discovery.test.ts +206 -206
- package/src/handlers/discovery.ts +427 -414
- package/src/handlers/fallback.test.ts +537 -537
- package/src/handlers/fallback.ts +194 -194
- package/src/handlers/file-checkouts.test.ts +750 -750
- package/src/handlers/file-checkouts.ts +185 -185
- package/src/handlers/findings.test.ts +633 -633
- package/src/handlers/findings.ts +239 -239
- package/src/handlers/git-issues.test.ts +631 -631
- package/src/handlers/git-issues.ts +136 -136
- package/src/handlers/ideas.test.ts +644 -644
- package/src/handlers/ideas.ts +207 -207
- package/src/handlers/index.ts +93 -90
- package/src/handlers/milestones.test.ts +475 -475
- package/src/handlers/milestones.ts +180 -180
- package/src/handlers/organizations.test.ts +826 -826
- package/src/handlers/organizations.ts +315 -315
- package/src/handlers/progress.test.ts +269 -269
- package/src/handlers/progress.ts +77 -77
- package/src/handlers/project.test.ts +546 -546
- package/src/handlers/project.ts +242 -239
- package/src/handlers/requests.test.ts +303 -303
- package/src/handlers/requests.ts +99 -99
- package/src/handlers/roles.test.ts +305 -305
- package/src/handlers/roles.ts +219 -219
- package/src/handlers/session.test.ts +998 -998
- package/src/handlers/session.ts +1105 -1093
- package/src/handlers/sprints.test.ts +732 -732
- package/src/handlers/sprints.ts +537 -537
- package/src/handlers/tasks.test.ts +931 -931
- package/src/handlers/tasks.ts +1133 -1121
- package/src/handlers/tool-categories.test.ts +66 -66
- package/src/handlers/tool-docs.test.ts +511 -511
- package/src/handlers/tool-docs.ts +1571 -1491
- package/src/handlers/types.test.ts +259 -259
- package/src/handlers/types.ts +176 -176
- package/src/handlers/validation.test.ts +582 -582
- package/src/handlers/validation.ts +164 -164
- package/src/handlers/version.ts +63 -63
- package/src/index.test.ts +674 -674
- package/src/index.ts +807 -807
- package/src/setup.test.ts +233 -233
- package/src/setup.ts +404 -404
- package/src/templates/agent-guidelines.ts +233 -215
- package/src/templates/help-content.ts +1751 -1751
- package/src/token-tracking.test.ts +463 -463
- package/src/token-tracking.ts +167 -167
- package/src/tools/blockers.ts +122 -122
- package/src/tools/bodies-of-work.ts +283 -283
- package/src/tools/chat.ts +72 -46
- package/src/tools/cloud-agents.ts +101 -101
- package/src/tools/connectors.ts +191 -191
- package/src/tools/cost.ts +111 -111
- package/src/tools/decisions.ts +111 -111
- package/src/tools/deployment.ts +455 -442
- package/src/tools/discovery.ts +76 -76
- package/src/tools/fallback.ts +111 -111
- package/src/tools/features.ts +154 -0
- package/src/tools/file-checkouts.ts +145 -145
- package/src/tools/findings.ts +101 -101
- package/src/tools/git-issues.ts +130 -130
- package/src/tools/ideas.ts +162 -162
- package/src/tools/index.ts +141 -137
- package/src/tools/milestones.ts +118 -118
- package/src/tools/organizations.ts +224 -224
- package/src/tools/progress.ts +73 -73
- package/src/tools/project.ts +206 -202
- package/src/tools/requests.ts +68 -68
- package/src/tools/roles.ts +112 -112
- package/src/tools/session.ts +181 -181
- package/src/tools/sprints.ts +298 -298
- package/src/tools/tasks.ts +550 -550
- package/src/tools/tools.test.ts +222 -222
- package/src/tools/types.ts +9 -9
- package/src/tools/validation.ts +75 -75
- package/src/tools/version.ts +34 -34
- package/src/tools/worktrees.ts +66 -66
- package/src/tools.test.ts +416 -416
- package/src/utils.test.ts +1014 -1014
- package/src/utils.ts +586 -586
- package/src/validators.test.ts +223 -223
- package/src/validators.ts +249 -249
- package/src/version.ts +109 -109
- package/tsconfig.json +16 -16
- package/vitest.config.ts +14 -14
package/src/cli.test.ts
CHANGED
|
@@ -1,284 +1,284 @@
|
|
|
1
|
-
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
|
|
2
|
-
|
|
3
|
-
// Mock child_process before importing cli module
|
|
4
|
-
vi.mock('child_process', () => ({
|
|
5
|
-
execSync: vi.fn(),
|
|
6
|
-
}));
|
|
7
|
-
|
|
8
|
-
// Mock fetch
|
|
9
|
-
const mockFetch = vi.fn();
|
|
10
|
-
global.fetch = mockFetch;
|
|
11
|
-
|
|
12
|
-
import { execSync } from 'child_process';
|
|
13
|
-
import {
|
|
14
|
-
detectGitUrl,
|
|
15
|
-
normalizeGitUrl,
|
|
16
|
-
verify,
|
|
17
|
-
type VerificationResult,
|
|
18
|
-
} from './cli.js';
|
|
19
|
-
|
|
20
|
-
describe('CLI verification logic', () => {
|
|
21
|
-
beforeEach(() => {
|
|
22
|
-
vi.clearAllMocks();
|
|
23
|
-
});
|
|
24
|
-
|
|
25
|
-
describe('normalizeGitUrl', () => {
|
|
26
|
-
it('should remove .git suffix and lowercase', () => {
|
|
27
|
-
expect(normalizeGitUrl('https://github.com/User/Repo.git')).toBe('https://github.com/user/repo');
|
|
28
|
-
});
|
|
29
|
-
|
|
30
|
-
it('should convert SSH to HTTPS format and lowercase', () => {
|
|
31
|
-
expect(normalizeGitUrl('git@github.com:User/Repo.git')).toBe('https://github.com/user/repo');
|
|
32
|
-
});
|
|
33
|
-
|
|
34
|
-
it('should handle HTTPS URLs without .git suffix', () => {
|
|
35
|
-
expect(normalizeGitUrl('https://github.com/user/repo')).toBe('https://github.com/user/repo');
|
|
36
|
-
});
|
|
37
|
-
|
|
38
|
-
it('should handle GitLab SSH URLs and lowercase', () => {
|
|
39
|
-
expect(normalizeGitUrl('git@gitlab.com:User/Repo.git')).toBe('https://gitlab.com/user/repo');
|
|
40
|
-
});
|
|
41
|
-
|
|
42
|
-
it('should handle Bitbucket SSH URLs and lowercase', () => {
|
|
43
|
-
expect(normalizeGitUrl('git@bitbucket.org:User/Repo.git')).toBe('https://bitbucket.org/user/repo');
|
|
44
|
-
});
|
|
45
|
-
|
|
46
|
-
it('should return null for empty string', () => {
|
|
47
|
-
expect(normalizeGitUrl('')).toBe(null);
|
|
48
|
-
});
|
|
49
|
-
|
|
50
|
-
it('should handle http and upgrade to https', () => {
|
|
51
|
-
expect(normalizeGitUrl('http://github.com/user/repo')).toBe('https://github.com/user/repo');
|
|
52
|
-
});
|
|
53
|
-
|
|
54
|
-
it('should handle trailing slashes', () => {
|
|
55
|
-
expect(normalizeGitUrl('https://github.com/user/repo/')).toBe('https://github.com/user/repo');
|
|
56
|
-
});
|
|
57
|
-
|
|
58
|
-
it('should add https protocol to bare URLs', () => {
|
|
59
|
-
expect(normalizeGitUrl('github.com/user/repo')).toBe('https://github.com/user/repo');
|
|
60
|
-
});
|
|
61
|
-
});
|
|
62
|
-
|
|
63
|
-
describe('detectGitUrl', () => {
|
|
64
|
-
it('should return normalized git URL when git command succeeds', () => {
|
|
65
|
-
vi.mocked(execSync).mockReturnValue('git@github.com:user/repo.git\n');
|
|
66
|
-
const result = detectGitUrl();
|
|
67
|
-
expect(result).toBe('https://github.com/user/repo');
|
|
68
|
-
});
|
|
69
|
-
|
|
70
|
-
it('should return null when git command fails', () => {
|
|
71
|
-
vi.mocked(execSync).mockImplementation(() => {
|
|
72
|
-
throw new Error('Not a git repository');
|
|
73
|
-
});
|
|
74
|
-
const result = detectGitUrl();
|
|
75
|
-
expect(result).toBeNull();
|
|
76
|
-
});
|
|
77
|
-
|
|
78
|
-
it('should handle HTTPS URLs', () => {
|
|
79
|
-
vi.mocked(execSync).mockReturnValue('https://github.com/user/repo.git\n');
|
|
80
|
-
const result = detectGitUrl();
|
|
81
|
-
expect(result).toBe('https://github.com/user/repo');
|
|
82
|
-
});
|
|
83
|
-
|
|
84
|
-
it('should call execSync with correct options', () => {
|
|
85
|
-
vi.mocked(execSync).mockReturnValue('https://github.com/user/repo.git');
|
|
86
|
-
detectGitUrl();
|
|
87
|
-
expect(execSync).toHaveBeenCalledWith('git config --get remote.origin.url', {
|
|
88
|
-
encoding: 'utf8',
|
|
89
|
-
timeout: 5000,
|
|
90
|
-
stdio: ['pipe', 'pipe', 'pipe'],
|
|
91
|
-
});
|
|
92
|
-
});
|
|
93
|
-
|
|
94
|
-
it('should trim whitespace from git URL', () => {
|
|
95
|
-
vi.mocked(execSync).mockReturnValue(' https://github.com/user/repo.git \n');
|
|
96
|
-
const result = detectGitUrl();
|
|
97
|
-
expect(result).toBe('https://github.com/user/repo');
|
|
98
|
-
});
|
|
99
|
-
|
|
100
|
-
it('should return null on timeout', () => {
|
|
101
|
-
vi.mocked(execSync).mockImplementation(() => {
|
|
102
|
-
const error = new Error('Command timed out');
|
|
103
|
-
(error as NodeJS.ErrnoException).code = 'ETIMEDOUT';
|
|
104
|
-
throw error;
|
|
105
|
-
});
|
|
106
|
-
const result = detectGitUrl();
|
|
107
|
-
expect(result).toBeNull();
|
|
108
|
-
});
|
|
109
|
-
});
|
|
110
|
-
});
|
|
111
|
-
|
|
112
|
-
describe('verify function', () => {
|
|
113
|
-
const originalEnv = process.env;
|
|
114
|
-
|
|
115
|
-
beforeEach(() => {
|
|
116
|
-
vi.clearAllMocks();
|
|
117
|
-
mockFetch.mockReset();
|
|
118
|
-
process.env = { ...originalEnv };
|
|
119
|
-
process.env.VIBESCOPE_API_KEY = 'test-api-key';
|
|
120
|
-
});
|
|
121
|
-
|
|
122
|
-
afterEach(() => {
|
|
123
|
-
process.env = originalEnv;
|
|
124
|
-
});
|
|
125
|
-
|
|
126
|
-
it('should return error when API key is not set', async () => {
|
|
127
|
-
delete process.env.VIBESCOPE_API_KEY;
|
|
128
|
-
// Need to re-import to get the new env value
|
|
129
|
-
// Since the module caches the env var, we test the behavior directly
|
|
130
|
-
const result = await verify('https://github.com/test/repo');
|
|
131
|
-
// The module reads env at import time, so this test may not work as expected
|
|
132
|
-
// But the function should handle missing API key
|
|
133
|
-
expect(result.status).toBeDefined();
|
|
134
|
-
});
|
|
135
|
-
|
|
136
|
-
it('should call API with correct parameters', async () => {
|
|
137
|
-
mockFetch.mockResolvedValueOnce({
|
|
138
|
-
json: () => Promise.resolve({
|
|
139
|
-
status: 'compliant',
|
|
140
|
-
reason: 'All good',
|
|
141
|
-
}),
|
|
142
|
-
});
|
|
143
|
-
|
|
144
|
-
await verify('https://github.com/test/repo', 'proj-123');
|
|
145
|
-
|
|
146
|
-
expect(mockFetch).toHaveBeenCalledWith(
|
|
147
|
-
'https://vibescope.dev/api/mcp/verify',
|
|
148
|
-
expect.objectContaining({
|
|
149
|
-
method: 'POST',
|
|
150
|
-
headers: { 'Content-Type': 'application/json' },
|
|
151
|
-
body: expect.stringContaining('test-api-key'),
|
|
152
|
-
})
|
|
153
|
-
);
|
|
154
|
-
|
|
155
|
-
const body = JSON.parse(mockFetch.mock.calls[0][1].body);
|
|
156
|
-
expect(body.git_url).toBe('https://github.com/test/repo');
|
|
157
|
-
expect(body.project_id).toBe('proj-123');
|
|
158
|
-
});
|
|
159
|
-
|
|
160
|
-
it('should return compliant status from API', async () => {
|
|
161
|
-
mockFetch.mockResolvedValueOnce({
|
|
162
|
-
json: () => Promise.resolve({
|
|
163
|
-
status: 'compliant',
|
|
164
|
-
reason: 'All tracked work completed properly',
|
|
165
|
-
details: {
|
|
166
|
-
session_started: true,
|
|
167
|
-
project_id: 'proj-123',
|
|
168
|
-
project_name: 'Test Project',
|
|
169
|
-
git_url: 'https://github.com/test/repo',
|
|
170
|
-
in_progress_tasks: 0,
|
|
171
|
-
tasks_completed_this_session: 5,
|
|
172
|
-
progress_logs_this_session: 3,
|
|
173
|
-
blockers_logged_this_session: 0,
|
|
174
|
-
session_duration_minutes: 30,
|
|
175
|
-
},
|
|
176
|
-
}),
|
|
177
|
-
});
|
|
178
|
-
|
|
179
|
-
const result = await verify('https://github.com/test/repo');
|
|
180
|
-
|
|
181
|
-
expect(result.status).toBe('compliant');
|
|
182
|
-
expect(result.details?.tasks_completed_this_session).toBe(5);
|
|
183
|
-
});
|
|
184
|
-
|
|
185
|
-
it('should return non_compliant status from API', async () => {
|
|
186
|
-
mockFetch.mockResolvedValueOnce({
|
|
187
|
-
json: () => Promise.resolve({
|
|
188
|
-
status: 'non_compliant',
|
|
189
|
-
reason: 'You have 2 task(s) still in_progress',
|
|
190
|
-
continuation_prompt: 'Complete your tasks before exiting',
|
|
191
|
-
}),
|
|
192
|
-
});
|
|
193
|
-
|
|
194
|
-
const result = await verify('https://github.com/test/repo');
|
|
195
|
-
|
|
196
|
-
expect(result.status).toBe('non_compliant');
|
|
197
|
-
expect(result.continuation_prompt).toBeDefined();
|
|
198
|
-
});
|
|
199
|
-
|
|
200
|
-
it('should handle network errors', async () => {
|
|
201
|
-
mockFetch.mockRejectedValueOnce(new Error('Network error'));
|
|
202
|
-
|
|
203
|
-
const result = await verify('https://github.com/test/repo');
|
|
204
|
-
|
|
205
|
-
expect(result.status).toBe('error');
|
|
206
|
-
expect(result.reason).toBe('Network error');
|
|
207
|
-
});
|
|
208
|
-
|
|
209
|
-
it('should auto-detect git URL if not provided', async () => {
|
|
210
|
-
vi.mocked(execSync).mockReturnValue('https://github.com/auto/detected.git');
|
|
211
|
-
mockFetch.mockResolvedValueOnce({
|
|
212
|
-
json: () => Promise.resolve({ status: 'compliant', reason: 'OK' }),
|
|
213
|
-
});
|
|
214
|
-
|
|
215
|
-
await verify();
|
|
216
|
-
|
|
217
|
-
const body = JSON.parse(mockFetch.mock.calls[0][1].body);
|
|
218
|
-
expect(body.git_url).toBe('https://github.com/auto/detected');
|
|
219
|
-
});
|
|
220
|
-
|
|
221
|
-
it('should use custom API URL from env', async () => {
|
|
222
|
-
process.env.VIBESCOPE_API_URL = 'https://custom.api.com';
|
|
223
|
-
mockFetch.mockResolvedValueOnce({
|
|
224
|
-
json: () => Promise.resolve({ status: 'compliant', reason: 'OK' }),
|
|
225
|
-
});
|
|
226
|
-
|
|
227
|
-
// Note: The module caches VIBESCOPE_API_URL at import time
|
|
228
|
-
// This test verifies the URL construction logic
|
|
229
|
-
await verify('https://github.com/test/repo');
|
|
230
|
-
|
|
231
|
-
// The actual URL used depends on when the module was loaded
|
|
232
|
-
expect(mockFetch).toHaveBeenCalled();
|
|
233
|
-
});
|
|
234
|
-
});
|
|
235
|
-
|
|
236
|
-
describe('VerificationResult types', () => {
|
|
237
|
-
it('should have correct status types', () => {
|
|
238
|
-
const compliant: VerificationResult = {
|
|
239
|
-
status: 'compliant',
|
|
240
|
-
reason: 'All good',
|
|
241
|
-
};
|
|
242
|
-
expect(compliant.status).toBe('compliant');
|
|
243
|
-
|
|
244
|
-
const nonCompliant: VerificationResult = {
|
|
245
|
-
status: 'non_compliant',
|
|
246
|
-
reason: 'Tasks in progress',
|
|
247
|
-
continuation_prompt: 'Complete your tasks',
|
|
248
|
-
};
|
|
249
|
-
expect(nonCompliant.status).toBe('non_compliant');
|
|
250
|
-
|
|
251
|
-
const error: VerificationResult = {
|
|
252
|
-
status: 'error',
|
|
253
|
-
reason: 'Missing env vars',
|
|
254
|
-
};
|
|
255
|
-
expect(error.status).toBe('error');
|
|
256
|
-
|
|
257
|
-
const noSession: VerificationResult = {
|
|
258
|
-
status: 'no_session',
|
|
259
|
-
reason: 'No git URL detected',
|
|
260
|
-
};
|
|
261
|
-
expect(noSession.status).toBe('no_session');
|
|
262
|
-
});
|
|
263
|
-
|
|
264
|
-
it('should support optional details', () => {
|
|
265
|
-
const result: VerificationResult = {
|
|
266
|
-
status: 'compliant',
|
|
267
|
-
reason: 'All good',
|
|
268
|
-
details: {
|
|
269
|
-
session_started: true,
|
|
270
|
-
project_id: 'proj-123',
|
|
271
|
-
project_name: 'Test Project',
|
|
272
|
-
git_url: 'https://github.com/user/repo',
|
|
273
|
-
in_progress_tasks: 0,
|
|
274
|
-
tasks_completed_this_session: 5,
|
|
275
|
-
progress_logs_this_session: 3,
|
|
276
|
-
blockers_logged_this_session: 1,
|
|
277
|
-
session_duration_minutes: 45,
|
|
278
|
-
},
|
|
279
|
-
};
|
|
280
|
-
|
|
281
|
-
expect(result.details?.session_started).toBe(true);
|
|
282
|
-
expect(result.details?.tasks_completed_this_session).toBe(5);
|
|
283
|
-
});
|
|
284
|
-
});
|
|
1
|
+
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
|
|
2
|
+
|
|
3
|
+
// Mock child_process before importing cli module
|
|
4
|
+
vi.mock('child_process', () => ({
|
|
5
|
+
execSync: vi.fn(),
|
|
6
|
+
}));
|
|
7
|
+
|
|
8
|
+
// Mock fetch
|
|
9
|
+
const mockFetch = vi.fn();
|
|
10
|
+
global.fetch = mockFetch;
|
|
11
|
+
|
|
12
|
+
import { execSync } from 'child_process';
|
|
13
|
+
import {
|
|
14
|
+
detectGitUrl,
|
|
15
|
+
normalizeGitUrl,
|
|
16
|
+
verify,
|
|
17
|
+
type VerificationResult,
|
|
18
|
+
} from './cli.js';
|
|
19
|
+
|
|
20
|
+
describe('CLI verification logic', () => {
|
|
21
|
+
beforeEach(() => {
|
|
22
|
+
vi.clearAllMocks();
|
|
23
|
+
});
|
|
24
|
+
|
|
25
|
+
describe('normalizeGitUrl', () => {
|
|
26
|
+
it('should remove .git suffix and lowercase', () => {
|
|
27
|
+
expect(normalizeGitUrl('https://github.com/User/Repo.git')).toBe('https://github.com/user/repo');
|
|
28
|
+
});
|
|
29
|
+
|
|
30
|
+
it('should convert SSH to HTTPS format and lowercase', () => {
|
|
31
|
+
expect(normalizeGitUrl('git@github.com:User/Repo.git')).toBe('https://github.com/user/repo');
|
|
32
|
+
});
|
|
33
|
+
|
|
34
|
+
it('should handle HTTPS URLs without .git suffix', () => {
|
|
35
|
+
expect(normalizeGitUrl('https://github.com/user/repo')).toBe('https://github.com/user/repo');
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
it('should handle GitLab SSH URLs and lowercase', () => {
|
|
39
|
+
expect(normalizeGitUrl('git@gitlab.com:User/Repo.git')).toBe('https://gitlab.com/user/repo');
|
|
40
|
+
});
|
|
41
|
+
|
|
42
|
+
it('should handle Bitbucket SSH URLs and lowercase', () => {
|
|
43
|
+
expect(normalizeGitUrl('git@bitbucket.org:User/Repo.git')).toBe('https://bitbucket.org/user/repo');
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
it('should return null for empty string', () => {
|
|
47
|
+
expect(normalizeGitUrl('')).toBe(null);
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
it('should handle http and upgrade to https', () => {
|
|
51
|
+
expect(normalizeGitUrl('http://github.com/user/repo')).toBe('https://github.com/user/repo');
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
it('should handle trailing slashes', () => {
|
|
55
|
+
expect(normalizeGitUrl('https://github.com/user/repo/')).toBe('https://github.com/user/repo');
|
|
56
|
+
});
|
|
57
|
+
|
|
58
|
+
it('should add https protocol to bare URLs', () => {
|
|
59
|
+
expect(normalizeGitUrl('github.com/user/repo')).toBe('https://github.com/user/repo');
|
|
60
|
+
});
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
describe('detectGitUrl', () => {
|
|
64
|
+
it('should return normalized git URL when git command succeeds', () => {
|
|
65
|
+
vi.mocked(execSync).mockReturnValue('git@github.com:user/repo.git\n');
|
|
66
|
+
const result = detectGitUrl();
|
|
67
|
+
expect(result).toBe('https://github.com/user/repo');
|
|
68
|
+
});
|
|
69
|
+
|
|
70
|
+
it('should return null when git command fails', () => {
|
|
71
|
+
vi.mocked(execSync).mockImplementation(() => {
|
|
72
|
+
throw new Error('Not a git repository');
|
|
73
|
+
});
|
|
74
|
+
const result = detectGitUrl();
|
|
75
|
+
expect(result).toBeNull();
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
it('should handle HTTPS URLs', () => {
|
|
79
|
+
vi.mocked(execSync).mockReturnValue('https://github.com/user/repo.git\n');
|
|
80
|
+
const result = detectGitUrl();
|
|
81
|
+
expect(result).toBe('https://github.com/user/repo');
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
it('should call execSync with correct options', () => {
|
|
85
|
+
vi.mocked(execSync).mockReturnValue('https://github.com/user/repo.git');
|
|
86
|
+
detectGitUrl();
|
|
87
|
+
expect(execSync).toHaveBeenCalledWith('git config --get remote.origin.url', {
|
|
88
|
+
encoding: 'utf8',
|
|
89
|
+
timeout: 5000,
|
|
90
|
+
stdio: ['pipe', 'pipe', 'pipe'],
|
|
91
|
+
});
|
|
92
|
+
});
|
|
93
|
+
|
|
94
|
+
it('should trim whitespace from git URL', () => {
|
|
95
|
+
vi.mocked(execSync).mockReturnValue(' https://github.com/user/repo.git \n');
|
|
96
|
+
const result = detectGitUrl();
|
|
97
|
+
expect(result).toBe('https://github.com/user/repo');
|
|
98
|
+
});
|
|
99
|
+
|
|
100
|
+
it('should return null on timeout', () => {
|
|
101
|
+
vi.mocked(execSync).mockImplementation(() => {
|
|
102
|
+
const error = new Error('Command timed out');
|
|
103
|
+
(error as NodeJS.ErrnoException).code = 'ETIMEDOUT';
|
|
104
|
+
throw error;
|
|
105
|
+
});
|
|
106
|
+
const result = detectGitUrl();
|
|
107
|
+
expect(result).toBeNull();
|
|
108
|
+
});
|
|
109
|
+
});
|
|
110
|
+
});
|
|
111
|
+
|
|
112
|
+
describe('verify function', () => {
|
|
113
|
+
const originalEnv = process.env;
|
|
114
|
+
|
|
115
|
+
beforeEach(() => {
|
|
116
|
+
vi.clearAllMocks();
|
|
117
|
+
mockFetch.mockReset();
|
|
118
|
+
process.env = { ...originalEnv };
|
|
119
|
+
process.env.VIBESCOPE_API_KEY = 'test-api-key';
|
|
120
|
+
});
|
|
121
|
+
|
|
122
|
+
afterEach(() => {
|
|
123
|
+
process.env = originalEnv;
|
|
124
|
+
});
|
|
125
|
+
|
|
126
|
+
it('should return error when API key is not set', async () => {
|
|
127
|
+
delete process.env.VIBESCOPE_API_KEY;
|
|
128
|
+
// Need to re-import to get the new env value
|
|
129
|
+
// Since the module caches the env var, we test the behavior directly
|
|
130
|
+
const result = await verify('https://github.com/test/repo');
|
|
131
|
+
// The module reads env at import time, so this test may not work as expected
|
|
132
|
+
// But the function should handle missing API key
|
|
133
|
+
expect(result.status).toBeDefined();
|
|
134
|
+
});
|
|
135
|
+
|
|
136
|
+
it('should call API with correct parameters', async () => {
|
|
137
|
+
mockFetch.mockResolvedValueOnce({
|
|
138
|
+
json: () => Promise.resolve({
|
|
139
|
+
status: 'compliant',
|
|
140
|
+
reason: 'All good',
|
|
141
|
+
}),
|
|
142
|
+
});
|
|
143
|
+
|
|
144
|
+
await verify('https://github.com/test/repo', 'proj-123');
|
|
145
|
+
|
|
146
|
+
expect(mockFetch).toHaveBeenCalledWith(
|
|
147
|
+
'https://vibescope.dev/api/mcp/verify',
|
|
148
|
+
expect.objectContaining({
|
|
149
|
+
method: 'POST',
|
|
150
|
+
headers: { 'Content-Type': 'application/json' },
|
|
151
|
+
body: expect.stringContaining('test-api-key'),
|
|
152
|
+
})
|
|
153
|
+
);
|
|
154
|
+
|
|
155
|
+
const body = JSON.parse(mockFetch.mock.calls[0][1].body);
|
|
156
|
+
expect(body.git_url).toBe('https://github.com/test/repo');
|
|
157
|
+
expect(body.project_id).toBe('proj-123');
|
|
158
|
+
});
|
|
159
|
+
|
|
160
|
+
it('should return compliant status from API', async () => {
|
|
161
|
+
mockFetch.mockResolvedValueOnce({
|
|
162
|
+
json: () => Promise.resolve({
|
|
163
|
+
status: 'compliant',
|
|
164
|
+
reason: 'All tracked work completed properly',
|
|
165
|
+
details: {
|
|
166
|
+
session_started: true,
|
|
167
|
+
project_id: 'proj-123',
|
|
168
|
+
project_name: 'Test Project',
|
|
169
|
+
git_url: 'https://github.com/test/repo',
|
|
170
|
+
in_progress_tasks: 0,
|
|
171
|
+
tasks_completed_this_session: 5,
|
|
172
|
+
progress_logs_this_session: 3,
|
|
173
|
+
blockers_logged_this_session: 0,
|
|
174
|
+
session_duration_minutes: 30,
|
|
175
|
+
},
|
|
176
|
+
}),
|
|
177
|
+
});
|
|
178
|
+
|
|
179
|
+
const result = await verify('https://github.com/test/repo');
|
|
180
|
+
|
|
181
|
+
expect(result.status).toBe('compliant');
|
|
182
|
+
expect(result.details?.tasks_completed_this_session).toBe(5);
|
|
183
|
+
});
|
|
184
|
+
|
|
185
|
+
it('should return non_compliant status from API', async () => {
|
|
186
|
+
mockFetch.mockResolvedValueOnce({
|
|
187
|
+
json: () => Promise.resolve({
|
|
188
|
+
status: 'non_compliant',
|
|
189
|
+
reason: 'You have 2 task(s) still in_progress',
|
|
190
|
+
continuation_prompt: 'Complete your tasks before exiting',
|
|
191
|
+
}),
|
|
192
|
+
});
|
|
193
|
+
|
|
194
|
+
const result = await verify('https://github.com/test/repo');
|
|
195
|
+
|
|
196
|
+
expect(result.status).toBe('non_compliant');
|
|
197
|
+
expect(result.continuation_prompt).toBeDefined();
|
|
198
|
+
});
|
|
199
|
+
|
|
200
|
+
it('should handle network errors', async () => {
|
|
201
|
+
mockFetch.mockRejectedValueOnce(new Error('Network error'));
|
|
202
|
+
|
|
203
|
+
const result = await verify('https://github.com/test/repo');
|
|
204
|
+
|
|
205
|
+
expect(result.status).toBe('error');
|
|
206
|
+
expect(result.reason).toBe('Network error');
|
|
207
|
+
});
|
|
208
|
+
|
|
209
|
+
it('should auto-detect git URL if not provided', async () => {
|
|
210
|
+
vi.mocked(execSync).mockReturnValue('https://github.com/auto/detected.git');
|
|
211
|
+
mockFetch.mockResolvedValueOnce({
|
|
212
|
+
json: () => Promise.resolve({ status: 'compliant', reason: 'OK' }),
|
|
213
|
+
});
|
|
214
|
+
|
|
215
|
+
await verify();
|
|
216
|
+
|
|
217
|
+
const body = JSON.parse(mockFetch.mock.calls[0][1].body);
|
|
218
|
+
expect(body.git_url).toBe('https://github.com/auto/detected');
|
|
219
|
+
});
|
|
220
|
+
|
|
221
|
+
it('should use custom API URL from env', async () => {
|
|
222
|
+
process.env.VIBESCOPE_API_URL = 'https://custom.api.com';
|
|
223
|
+
mockFetch.mockResolvedValueOnce({
|
|
224
|
+
json: () => Promise.resolve({ status: 'compliant', reason: 'OK' }),
|
|
225
|
+
});
|
|
226
|
+
|
|
227
|
+
// Note: The module caches VIBESCOPE_API_URL at import time
|
|
228
|
+
// This test verifies the URL construction logic
|
|
229
|
+
await verify('https://github.com/test/repo');
|
|
230
|
+
|
|
231
|
+
// The actual URL used depends on when the module was loaded
|
|
232
|
+
expect(mockFetch).toHaveBeenCalled();
|
|
233
|
+
});
|
|
234
|
+
});
|
|
235
|
+
|
|
236
|
+
describe('VerificationResult types', () => {
|
|
237
|
+
it('should have correct status types', () => {
|
|
238
|
+
const compliant: VerificationResult = {
|
|
239
|
+
status: 'compliant',
|
|
240
|
+
reason: 'All good',
|
|
241
|
+
};
|
|
242
|
+
expect(compliant.status).toBe('compliant');
|
|
243
|
+
|
|
244
|
+
const nonCompliant: VerificationResult = {
|
|
245
|
+
status: 'non_compliant',
|
|
246
|
+
reason: 'Tasks in progress',
|
|
247
|
+
continuation_prompt: 'Complete your tasks',
|
|
248
|
+
};
|
|
249
|
+
expect(nonCompliant.status).toBe('non_compliant');
|
|
250
|
+
|
|
251
|
+
const error: VerificationResult = {
|
|
252
|
+
status: 'error',
|
|
253
|
+
reason: 'Missing env vars',
|
|
254
|
+
};
|
|
255
|
+
expect(error.status).toBe('error');
|
|
256
|
+
|
|
257
|
+
const noSession: VerificationResult = {
|
|
258
|
+
status: 'no_session',
|
|
259
|
+
reason: 'No git URL detected',
|
|
260
|
+
};
|
|
261
|
+
expect(noSession.status).toBe('no_session');
|
|
262
|
+
});
|
|
263
|
+
|
|
264
|
+
it('should support optional details', () => {
|
|
265
|
+
const result: VerificationResult = {
|
|
266
|
+
status: 'compliant',
|
|
267
|
+
reason: 'All good',
|
|
268
|
+
details: {
|
|
269
|
+
session_started: true,
|
|
270
|
+
project_id: 'proj-123',
|
|
271
|
+
project_name: 'Test Project',
|
|
272
|
+
git_url: 'https://github.com/user/repo',
|
|
273
|
+
in_progress_tasks: 0,
|
|
274
|
+
tasks_completed_this_session: 5,
|
|
275
|
+
progress_logs_this_session: 3,
|
|
276
|
+
blockers_logged_this_session: 1,
|
|
277
|
+
session_duration_minutes: 45,
|
|
278
|
+
},
|
|
279
|
+
};
|
|
280
|
+
|
|
281
|
+
expect(result.details?.session_started).toBe(true);
|
|
282
|
+
expect(result.details?.tasks_completed_this_session).toBe(5);
|
|
283
|
+
});
|
|
284
|
+
});
|