@vibescope/mcp-server 0.2.4 → 0.2.6

package/src/cli.ts

@@ -1,195 +1,212 @@
-#!/usr/bin/env node
-
-/**
- * Vibescope CLI - Enforcement verification tool
- *
- * Used by Claude Code Stop hook to verify agent compliance with Vibescope tracking.
- * Exit codes:
- *   0 = Compliant (allow exit)
- *   1 = Non-compliant (block exit, loop back)
- *   2 = Error (allow exit with warning)
- */
-
-import { execSync } from 'child_process';
-
-// ============================================================================
-// Types
-// ============================================================================
-
-export interface VerificationResult {
-	status: 'compliant' | 'non_compliant' | 'no_session' | 'error';
-	reason: string;
-	continuation_prompt?: string;
-	details?: {
-		session_started: boolean;
-		project_id: string | null;
-		project_name: string | null;
-		git_url: string | null;
-		in_progress_tasks: number;
-		tasks_completed_this_session: number;
-		progress_logs_this_session: number;
-		blockers_logged_this_session: number;
-		session_duration_minutes: number | null;
-	};
-}
-
-// ============================================================================
-// Configuration (read at runtime for testability)
-// ============================================================================
-
-function getApiKey(): string | undefined {
-	return process.env.VIBESCOPE_API_KEY;
-}
-
-function getApiUrl(): string {
-	return process.env.VIBESCOPE_API_URL || 'https://vibescope.dev';
-}
-
-// ============================================================================
-// Git URL Detection
-// ============================================================================
-
-export function normalizeGitUrl(url: string): string {
-	// Remove .git suffix
-	let normalized = url.replace(/\.git$/, '');
-	// Convert SSH to HTTPS format
-	if (normalized.startsWith('git@')) {
-		normalized = normalized
-			.replace(/^git@/, 'https://')
-			.replace(/:([^/])/, '/$1');
-	}
-	return normalized;
-}
-
-export function detectGitUrl(): string | null {
-	try {
-		const url = execSync('git config --get remote.origin.url', {
-			encoding: 'utf8',
-			timeout: 5000,
-			stdio: ['pipe', 'pipe', 'pipe'],
-		}).trim();
-
-		return normalizeGitUrl(url);
-	} catch {
-		return null;
-	}
-}
-
-// ============================================================================
-// Verification Logic
-// ============================================================================
-
-export async function verify(
-	gitUrl?: string,
-	projectId?: string
-): Promise<VerificationResult> {
-	// Check environment (read at runtime for testability)
-	const apiKey = getApiKey();
-	if (!apiKey) {
-		return {
-			status: 'error',
-			reason: 'VIBESCOPE_API_KEY environment variable not set',
-		};
-	}
-
-	// Auto-detect git URL if not provided
-	if (!gitUrl && !projectId) {
-		gitUrl = detectGitUrl() || undefined;
-	}
-
-	try {
-		const response = await fetch(`${getApiUrl()}/api/mcp/verify`, {
-			method: 'POST',
-			headers: {
-				'Content-Type': 'application/json',
-			},
-			body: JSON.stringify({
-				api_key: apiKey,
-				git_url: gitUrl,
-				project_id: projectId,
-			}),
-		});
-
-		const result = await response.json() as VerificationResult;
-		return result;
-	} catch (err) {
-		return {
-			status: 'error',
-			reason: err instanceof Error ? err.message : 'Network error',
-		};
-	}
-}
-
-// ============================================================================
-// CLI Entry Point
-// ============================================================================
-
-async function main() {
-	const args = process.argv.slice(2);
-	const command = args[0];
-
-	if (command === 'verify') {
-		// Parse --git-url and --project-id flags
-		let gitUrl: string | undefined;
-		let projectId: string | undefined;
-
-		for (let i = 1; i < args.length; i++) {
-			if (args[i] === '--git-url' && args[i + 1]) {
-				gitUrl = args[++i];
-			} else if (args[i] === '--project-id' && args[i + 1]) {
-				projectId = args[++i];
-			}
-		}
-
-		const result = await verify(gitUrl, projectId);
-		console.log(JSON.stringify(result, null, 2));
-
-		// Exit codes: 0=compliant, 1=non-compliant, 2=error
-		if (result.status === 'compliant') {
-			process.exit(0);
-		} else if (result.status === 'error') {
-			process.exit(2);
-		} else {
-			process.exit(1);
-		}
-	} else if (command === 'help' || command === '--help' || command === '-h') {
-		console.log(`
-Vibescope CLI - Enforcement verification tool
-
-Usage:
-  vibescope-cli verify [options]    Check Vibescope compliance before exit
-
-Options:
-  --git-url <url>       Git repository URL (auto-detected if not provided)
-  --project-id <id>     Vibescope project UUID
-
-Exit Codes:
-  0  Compliant - agent can exit
-  1  Non-compliant - agent should continue work
-  2  Error - allow exit with warning
-
-Environment Variables:
-  VIBESCOPE_API_KEY       Required - Your Vibescope API key
-  VIBESCOPE_API_URL       Optional - API URL (default: https://vibescope.dev)
-`);
-		process.exit(0);
-	} else {
-		console.error('Usage: vibescope-cli verify [--git-url <url>] [--project-id <id>]');
-		console.error('       vibescope-cli --help');
-		process.exit(2);
-	}
-}
-
-// Only run main when executed directly (not when imported for testing)
-const isMainModule = import.meta.url === `file://${process.argv[1]?.replace(/\\/g, '/')}`;
-if (isMainModule || process.argv[1]?.endsWith('cli.js')) {
-	main().catch((err) => {
-		console.error(
-			JSON.stringify({
-				status: 'error',
-				reason: err instanceof Error ? err.message : 'Unknown error',
-			})
-		);
-		process.exit(2);
-	});
-}
+#!/usr/bin/env node
+
+/**
+ * Vibescope CLI - Setup wizard and enforcement verification tool
+ *
+ * Commands:
+ *   setup   - Interactive wizard to configure Vibescope for your IDE
+ *   verify  - Check agent compliance with Vibescope tracking (used by hooks)
+ *
+ * Exit codes (for verify command):
+ *   0 = Compliant (allow exit)
+ *   1 = Non-compliant (block exit, loop back)
+ *   2 = Error (allow exit with warning)
+ */
+
+import { execSync } from 'child_process';
+import { runSetup } from './setup.js';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface VerificationResult {
+	status: 'compliant' | 'non_compliant' | 'no_session' | 'error';
+	reason: string;
+	continuation_prompt?: string;
+	details?: {
+		session_started: boolean;
+		project_id: string | null;
+		project_name: string | null;
+		git_url: string | null;
+		in_progress_tasks: number;
+		tasks_completed_this_session: number;
+		progress_logs_this_session: number;
+		blockers_logged_this_session: number;
+		session_duration_minutes: number | null;
+	};
+}
+
+// ============================================================================
+// Configuration (read at runtime for testability)
+// ============================================================================
+
+function getApiKey(): string | undefined {
+	return process.env.VIBESCOPE_API_KEY;
+}
+
+function getApiUrl(): string {
+	return process.env.VIBESCOPE_API_URL || 'https://vibescope.dev';
+}
+
+// ============================================================================
+// Git URL Detection
+// ============================================================================
+
+export function normalizeGitUrl(url: string): string {
+	// Remove .git suffix
+	let normalized = url.replace(/\.git$/, '');
+	// Convert SSH to HTTPS format
+	if (normalized.startsWith('git@')) {
+		normalized = normalized
+			.replace(/^git@/, 'https://')
+			.replace(/:([^/])/, '/$1');
+	}
+	return normalized;
+}
+
+export function detectGitUrl(): string | null {
+	try {
+		const url = execSync('git config --get remote.origin.url', {
+			encoding: 'utf8',
+			timeout: 5000,
+			stdio: ['pipe', 'pipe', 'pipe'],
+		}).trim();
+
+		return normalizeGitUrl(url);
+	} catch {
+		return null;
+	}
+}
+
+// ============================================================================
+// Verification Logic
+// ============================================================================
+
+export async function verify(
+	gitUrl?: string,
+	projectId?: string
+): Promise<VerificationResult> {
+	// Check environment (read at runtime for testability)
+	const apiKey = getApiKey();
+	if (!apiKey) {
+		return {
+			status: 'error',
+			reason: 'VIBESCOPE_API_KEY environment variable not set',
+		};
+	}
+
+	// Auto-detect git URL if not provided
+	if (!gitUrl && !projectId) {
+		gitUrl = detectGitUrl() || undefined;
+	}
+
+	try {
+		const response = await fetch(`${getApiUrl()}/api/mcp/verify`, {
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/json',
+			},
+			body: JSON.stringify({
+				api_key: apiKey,
+				git_url: gitUrl,
+				project_id: projectId,
+			}),
+		});
+
+		const result = await response.json() as VerificationResult;
+		return result;
+	} catch (err) {
+		return {
+			status: 'error',
+			reason: err instanceof Error ? err.message : 'Network error',
+		};
+	}
+}
+
+// ============================================================================
+// CLI Entry Point
+// ============================================================================
+
+async function main() {
+	const args = process.argv.slice(2);
+	const command = args[0];
+
+	if (command === 'setup') {
+		// Run interactive setup wizard
+		await runSetup();
+		process.exit(0);
+	} else if (command === 'verify') {
+		// Parse --git-url and --project-id flags
+		let gitUrl: string | undefined;
+		let projectId: string | undefined;
+
+		for (let i = 1; i < args.length; i++) {
+			if (args[i] === '--git-url' && args[i + 1]) {
+				gitUrl = args[++i];
+			} else if (args[i] === '--project-id' && args[i + 1]) {
+				projectId = args[++i];
+			}
+		}
+
+		const result = await verify(gitUrl, projectId);
+		console.log(JSON.stringify(result, null, 2));
+
+		// Exit codes: 0=compliant, 1=non-compliant, 2=error
+		if (result.status === 'compliant') {
+			process.exit(0);
+		} else if (result.status === 'error') {
+			process.exit(2);
+		} else {
+			process.exit(1);
+		}
+	} else if (command === 'help' || command === '--help' || command === '-h') {
+		console.log(`
+Vibescope CLI - Setup wizard and enforcement verification tool
+
+Usage:
+  vibescope-cli setup                 Interactive setup wizard for your IDE
+  vibescope-cli verify [options]      Check Vibescope compliance before exit
+
+Setup:
+  Configures Vibescope MCP integration for:
+  - Claude Code (CLI)
+  - Claude Desktop
+  - Cursor
+  - Gemini CLI
+
+Verify Options:
+  --git-url <url>       Git repository URL (auto-detected if not provided)
+  --project-id <id>     Vibescope project UUID
+
+Exit Codes (verify):
+  0  Compliant - agent can exit
+  1  Non-compliant - agent should continue work
+  2  Error - allow exit with warning
+
+Environment Variables:
+  VIBESCOPE_API_KEY       Required for verify - Your Vibescope API key
+  VIBESCOPE_API_URL       Optional - API URL (default: https://vibescope.dev)
+`);
+		process.exit(0);
+	} else {
+		console.error('Usage: vibescope-cli setup');
+		console.error('       vibescope-cli verify [--git-url <url>] [--project-id <id>]');
+		console.error('       vibescope-cli --help');
+		process.exit(2);
+	}
+}
+
+// Only run main when executed directly (not when imported for testing)
+const isMainModule = import.meta.url === `file://${process.argv[1]?.replace(/\\/g, '/')}`;
+if (isMainModule || process.argv[1]?.endsWith('cli.js')) {
+	main().catch((err) => {
+		console.error(
+			JSON.stringify({
+				status: 'error',
+				reason: err instanceof Error ? err.message : 'Unknown error',
+			})
+		);
+		process.exit(2);
+	});
+}

package/src/setup.test.ts

@@ -0,0 +1,233 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+
+// Mock node:fs before importing setup module
+vi.mock('node:fs', () => ({
+	existsSync: vi.fn(),
+	readFileSync: vi.fn(),
+	writeFileSync: vi.fn(),
+	mkdirSync: vi.fn(),
+}));
+
+// Mock node:os
+vi.mock('node:os', () => ({
+	homedir: vi.fn(() => '/home/testuser'),
+	platform: vi.fn(() => 'darwin'),
+}));
+
+import { existsSync } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { detectIdes, generateMcpConfig, type IdeConfig } from './setup.js';
+
+describe('Setup module', () => {
+	beforeEach(() => {
+		vi.clearAllMocks();
+		vi.mocked(homedir).mockReturnValue('/home/testuser');
+		vi.mocked(platform).mockReturnValue('darwin');
+	});
+
+	describe('detectIdes', () => {
+		it('should always include Claude Code as detected', () => {
+			vi.mocked(existsSync).mockReturnValue(false);
+			const ides = detectIdes();
+			const claudeCode = ides.find(ide => ide.name === 'claude-code');
+
+			expect(claudeCode).toBeDefined();
+			expect(claudeCode?.detected).toBe(true);
+			expect(claudeCode?.configPath).toBe('.mcp.json');
+			expect(claudeCode?.configFormat).toBe('mcp-json');
+		});
+
+		it('should always include Gemini CLI as detected', () => {
+			vi.mocked(existsSync).mockReturnValue(false);
+			const ides = detectIdes();
+			const gemini = ides.find(ide => ide.name === 'gemini');
+
+			expect(gemini).toBeDefined();
+			expect(gemini?.detected).toBe(true);
+			expect(gemini?.configFormat).toBe('settings-json');
+		});
+
+		it('should detect Claude Desktop when directory exists', () => {
+			vi.mocked(existsSync).mockImplementation((path: unknown) => {
+				if (typeof path === 'string' && path.includes('Claude')) {
+					return true;
+				}
+				return false;
+			});
+
+			const ides = detectIdes();
+			const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
+
+			expect(claudeDesktop).toBeDefined();
+			expect(claudeDesktop?.detected).toBe(true);
+		});
+
+		it('should not detect Claude Desktop when directory does not exist', () => {
+			vi.mocked(existsSync).mockReturnValue(false);
+
+			const ides = detectIdes();
+			const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
+
+			expect(claudeDesktop).toBeDefined();
+			expect(claudeDesktop?.detected).toBe(false);
+		});
+
+		it('should detect Cursor when directory exists', () => {
+			vi.mocked(existsSync).mockImplementation((path: unknown) => {
+				if (typeof path === 'string' && path.includes('Cursor')) {
+					return true;
+				}
+				return false;
+			});
+
+			const ides = detectIdes();
+			const cursor = ides.find(ide => ide.name === 'cursor');
+
+			expect(cursor).toBeDefined();
+			expect(cursor?.detected).toBe(true);
+		});
+
+		it('should return all four IDE configs', () => {
+			vi.mocked(existsSync).mockReturnValue(false);
+			const ides = detectIdes();
+
+			expect(ides).toHaveLength(4);
+			expect(ides.map(ide => ide.name)).toEqual([
+				'claude-code',
+				'claude-desktop',
+				'cursor',
+				'gemini',
+			]);
+		});
+
+		it('should use correct config paths on macOS', () => {
+			vi.mocked(platform).mockReturnValue('darwin');
+			vi.mocked(homedir).mockReturnValue('/Users/testuser');
+			vi.mocked(existsSync).mockReturnValue(true);
+
+			const ides = detectIdes();
+
+			const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
+			// Note: path.join uses OS separator, so we check for path components
+			expect(claudeDesktop?.configPath).toMatch(/Library.*Application Support.*Claude/);
+
+			const cursor = ides.find(ide => ide.name === 'cursor');
+			expect(cursor?.configPath).toMatch(/Library.*Application Support.*Cursor/);
+
+			const gemini = ides.find(ide => ide.name === 'gemini');
+			expect(gemini?.configPath).toMatch(/Users.*testuser.*\.gemini.*settings\.json/);
+		});
+
+		it('should use correct config paths on Windows', () => {
+			vi.mocked(platform).mockReturnValue('win32');
+			vi.mocked(homedir).mockReturnValue('C:\\Users\\testuser');
+			vi.mocked(existsSync).mockReturnValue(true);
+
+			const ides = detectIdes();
+
+			const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
+			// Note: path.join uses OS separator, so we check for path components
+			expect(claudeDesktop?.configPath).toMatch(/AppData.*Roaming.*Claude/);
+
+			const cursor = ides.find(ide => ide.name === 'cursor');
+			expect(cursor?.configPath).toMatch(/AppData.*Roaming.*Cursor/);
+		});
+
+		it('should use correct config paths on Linux', () => {
+			vi.mocked(platform).mockReturnValue('linux');
+			vi.mocked(homedir).mockReturnValue('/home/testuser');
+			vi.mocked(existsSync).mockReturnValue(true);
+
+			const ides = detectIdes();
+
+			const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
+			// Note: path.join uses OS separator, so we check for path components
+			expect(claudeDesktop?.configPath).toMatch(/\.config.*Claude/);
+
+			const cursor = ides.find(ide => ide.name === 'cursor');
+			expect(cursor?.configPath).toMatch(/\.config.*Cursor/);
+		});
+	});
+
+	describe('IdeConfig types', () => {
+		it('should have correct config format for MCP-based IDEs', () => {
+			vi.mocked(existsSync).mockReturnValue(true);
+			const ides = detectIdes();
+
+			const claudeCode = ides.find(ide => ide.name === 'claude-code');
+			const claudeDesktop = ides.find(ide => ide.name === 'claude-desktop');
+			const cursor = ides.find(ide => ide.name === 'cursor');
+
+			expect(claudeCode?.configFormat).toBe('mcp-json');
+			expect(claudeDesktop?.configFormat).toBe('mcp-json');
+			expect(cursor?.configFormat).toBe('mcp-json');
+		});
+
+		it('should have correct config format for Gemini CLI', () => {
+			vi.mocked(existsSync).mockReturnValue(true);
+			const ides = detectIdes();
+
+			const gemini = ides.find(ide => ide.name === 'gemini');
+			expect(gemini?.configFormat).toBe('settings-json');
+		});
+	});
+
+	describe('generateMcpConfig', () => {
+		it('should generate correct config structure for standard MCP IDEs', () => {
+			const claudeCodeIde: IdeConfig = {
+				name: 'claude-code',
+				displayName: 'Claude Code (CLI)',
+				configPath: '.mcp.json',
+				detected: true,
+				configFormat: 'mcp-json',
+			};
+
+			const config = generateMcpConfig('test-api-key', claudeCodeIde);
+			const mcpServers = config.mcpServers as Record<string, unknown>;
+			const vibescope = mcpServers.vibescope as Record<string, unknown>;
+
+			expect(vibescope.command).toBe('npx');
+			expect(vibescope.args).toContain('@vibescope/mcp-server@latest');
+			expect((vibescope.env as Record<string, string>).VIBESCOPE_API_KEY).toBe('test-api-key');
+			// Standard MCP config should NOT have timeout/trust
+			expect(vibescope.timeout).toBeUndefined();
+			expect(vibescope.trust).toBeUndefined();
+		});
+
+		it('should include timeout and trust for Gemini CLI config', () => {
+			const geminiIde: IdeConfig = {
+				name: 'gemini',
+				displayName: 'Gemini CLI',
+				configPath: '~/.gemini/settings.json',
+				detected: true,
+				configFormat: 'settings-json',
+			};
+
+			const config = generateMcpConfig('test-api-key', geminiIde);
+			const mcpServers = config.mcpServers as Record<string, unknown>;
+			const vibescope = mcpServers.vibescope as Record<string, unknown>;
+
+			expect(vibescope.command).toBe('npx');
+			expect(vibescope.args).toContain('@vibescope/mcp-server@latest');
+			expect((vibescope.env as Record<string, string>).VIBESCOPE_API_KEY).toBe('test-api-key');
+			expect(vibescope.timeout).toBe(30000);
+			expect(vibescope.trust).toBe(true);
+		});
+
+		it('should use correct npx args format', () => {
+			const ide: IdeConfig = {
+				name: 'claude-code',
+				displayName: 'Claude Code (CLI)',
+				configPath: '.mcp.json',
+				detected: true,
+				configFormat: 'mcp-json',
+			};
+
+			const config = generateMcpConfig('my-key', ide);
+			const mcpServers = config.mcpServers as Record<string, unknown>;
+			const vibescope = mcpServers.vibescope as Record<string, unknown>;
+
+			expect(vibescope.args).toEqual(['-y', '-p', '@vibescope/mcp-server@latest', 'vibescope-mcp']);
+		});
+	});
+});