@vibescope/mcp-server 0.2.9 → 0.3.0

package/src/cli.test.ts

@@ -23,24 +23,40 @@ describe('CLI verification logic', () => {
 	});
 
 	describe('normalizeGitUrl', () => {
-		it('should remove .git suffix', () => {
-			expect(normalizeGitUrl('https://github.com/user/repo.git')).toBe('https://github.com/user/repo');
+		it('should remove .git suffix and lowercase', () => {
+			expect(normalizeGitUrl('https://github.com/User/Repo.git')).toBe('https://github.com/user/repo');
 		});
 
-		it('should convert SSH to HTTPS format', () => {
-			expect(normalizeGitUrl('git@github.com:user/repo.git')).toBe('https://github.com/user/repo');
+		it('should convert SSH to HTTPS format and lowercase', () => {
+			expect(normalizeGitUrl('git@github.com:User/Repo.git')).toBe('https://github.com/user/repo');
 		});
 
 		it('should handle HTTPS URLs without .git suffix', () => {
 			expect(normalizeGitUrl('https://github.com/user/repo')).toBe('https://github.com/user/repo');
 		});
 
-		it('should handle GitLab SSH URLs', () => {
-			expect(normalizeGitUrl('git@gitlab.com:user/repo.git')).toBe('https://gitlab.com/user/repo');
+		it('should handle GitLab SSH URLs and lowercase', () => {
+			expect(normalizeGitUrl('git@gitlab.com:User/Repo.git')).toBe('https://gitlab.com/user/repo');
 		});
 
-		it('should handle Bitbucket SSH URLs', () => {
-			expect(normalizeGitUrl('git@bitbucket.org:user/repo.git')).toBe('https://bitbucket.org/user/repo');
+		it('should handle Bitbucket SSH URLs and lowercase', () => {
+			expect(normalizeGitUrl('git@bitbucket.org:User/Repo.git')).toBe('https://bitbucket.org/user/repo');
+		});
+
+		it('should return null for empty string', () => {
+			expect(normalizeGitUrl('')).toBe(null);
+		});
+
+		it('should handle http and upgrade to https', () => {
+			expect(normalizeGitUrl('http://github.com/user/repo')).toBe('https://github.com/user/repo');
+		});
+
+		it('should handle trailing slashes', () => {
+			expect(normalizeGitUrl('https://github.com/user/repo/')).toBe('https://github.com/user/repo');
+		});
+
+		it('should add https protocol to bare URLs', () => {
+			expect(normalizeGitUrl('github.com/user/repo')).toBe('https://github.com/user/repo');
 		});
 	});
 

package/src/cli.ts

@@ -1,212 +1,204 @@
-#!/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);
-	});
-}
+#!/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';
+import { normalizeGitUrl as normalizeGitUrlFn } from './utils.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
+// ============================================================================
+
+// Re-export normalizeGitUrl from utils for backwards compatibility with tests
+export { normalizeGitUrl } from './utils.js';
+
+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 normalizeGitUrlFn(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);
+	});
+}