@vibescope/mcp-server 0.2.4 → 0.2.5

package/src/cli.ts

@@ -1,16 +1,20 @@
 #!/usr/bin/env node
 
 /**
- * Vibescope CLI - Enforcement verification tool
+ * Vibescope CLI - Setup wizard and enforcement verification tool
  *
- * Used by Claude Code Stop hook to verify agent compliance with Vibescope tracking.
- * Exit codes:
+ * 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
@@ -128,7 +132,11 @@ async function main() {
 	const args = process.argv.slice(2);
 	const command = args[0];
 
-	if (command === 'verify') {
+	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;
@@ -154,27 +162,36 @@ async function main() {
 		}
 	} else if (command === 'help' || command === '--help' || command === '-h') {
 		console.log(`
-Vibescope CLI - Enforcement verification tool
+Vibescope CLI - Setup wizard and enforcement verification tool
 
 Usage:
-  vibescope-cli verify [options]    Check Vibescope compliance before exit
+  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
 
-Options:
+Verify Options:
   --git-url <url>       Git repository URL (auto-detected if not provided)
   --project-id <id>     Vibescope project UUID
 
-Exit Codes:
+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 - Your Vibescope API key
+  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 verify [--git-url <url>] [--project-id <id>]');
+		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);
 	}

package/src/handlers/__test-setup__.ts

@@ -1,236 +1,236 @@
-/**
- * Global Test Setup for Handler Tests
- *
- * This file is loaded before all tests via vitest.config.ts setupFiles.
- * It provides a global mock for the API client used by migrated handlers.
- */
-
-import { vi, beforeEach } from 'vitest';
-
-// Default success response for API calls
-const defaultSuccess = { ok: true, data: {} };
-const defaultError = { ok: false, error: 'Mock error' };
-
-// ============================================================================
-// Global Mock API Client
-// ============================================================================
-
-/**
- * Mock API client with all methods stubbed.
- * Tests can configure return values using mockResolvedValue/mockImplementation.
- * Default return is a success response { ok: true, data: {} }
- */
-export const mockApiClient = {
-	// Session
-	startSession: vi.fn(),
-	heartbeat: vi.fn(),
-	syncSession: vi.fn(),
-	endSession: vi.fn(),
-	reportTokenUsage: vi.fn(),
-
-	// Project
-	listProjects: vi.fn(),
-	getProject: vi.fn(),
-	getProjectContext: vi.fn(),
-	createProject: vi.fn(),
-	updateProject: vi.fn(),
-	updateProjectReadme: vi.fn(),
-	getGitWorkflow: vi.fn(),
-
-	// Tasks
-	getTasks: vi.fn(),
-	getNextTask: vi.fn(),
-	createTask: vi.fn(),
-	updateTask: vi.fn(),
-	completeTask: vi.fn(),
-	deleteTask: vi.fn(),
-	addTaskReference: vi.fn(),
-	removeTaskReference: vi.fn(),
-	batchUpdateTasks: vi.fn(),
-	batchCompleteTasks: vi.fn(),
-
-	// Subtasks
-	addSubtask: vi.fn(),
-	getSubtasks: vi.fn(),
-
-	// Progress
-	logProgress: vi.fn(),
-	getActivityFeed: vi.fn(),
-
-	// Blockers
-	addBlocker: vi.fn(),
-	resolveBlocker: vi.fn(),
-	getBlockers: vi.fn(),
-	getBlockersStats: vi.fn(),
-	deleteBlocker: vi.fn(),
-
-	// Decisions
-	logDecision: vi.fn(),
-	getDecisions: vi.fn(),
-	getDecisionsStats: vi.fn(),
-	deleteDecision: vi.fn(),
-
-	// Ideas
-	addIdea: vi.fn(),
-	updateIdea: vi.fn(),
-	getIdeas: vi.fn(),
-	deleteIdea: vi.fn(),
-	convertIdeaToTask: vi.fn(),
-
-	// Findings
-	addFinding: vi.fn(),
-	getFindings: vi.fn(),
-	getFindingsStats: vi.fn(),
-	updateFinding: vi.fn(),
-	deleteFinding: vi.fn(),
-	queryKnowledgeBase: vi.fn(),
-
-	// Requests
-	getPendingRequests: vi.fn(),
-	acknowledgeRequest: vi.fn(),
-	answerQuestion: vi.fn(),
-
-	// Milestones
-	addMilestone: vi.fn(),
-	updateMilestone: vi.fn(),
-	completeMilestone: vi.fn(),
-	deleteMilestone: vi.fn(),
-	getMilestones: vi.fn(),
-
-	// Fallback
-	startFallbackActivity: vi.fn(),
-	stopFallbackActivity: vi.fn(),
-	getActivityHistory: vi.fn(),
-	getActivitySchedules: vi.fn(),
-
-	// Cost
-	getCostSummary: vi.fn(),
-	getCostAlerts: vi.fn(),
-	addCostAlert: vi.fn(),
-	updateCostAlert: vi.fn(),
-	deleteCostAlert: vi.fn(),
-	getTaskCosts: vi.fn(),
-
-	// Git Issues
-	addGitIssue: vi.fn(),
-	resolveGitIssue: vi.fn(),
-	getGitIssues: vi.fn(),
-	deleteGitIssue: vi.fn(),
-
-	// Organizations
-	listOrganizations: vi.fn(),
-	createOrganization: vi.fn(),
-	updateOrganization: vi.fn(),
-	deleteOrganization: vi.fn(),
-	listOrgMembers: vi.fn(),
-	inviteMember: vi.fn(),
-	updateMemberRole: vi.fn(),
-	removeMember: vi.fn(),
-	leaveOrganization: vi.fn(),
-	shareProjectWithOrg: vi.fn(),
-	updateProjectShare: vi.fn(),
-	unshareProject: vi.fn(),
-	listProjectShares: vi.fn(),
-
-	// Bodies of Work
-	createBodyOfWork: vi.fn(),
-	updateBodyOfWork: vi.fn(),
-	getBodyOfWork: vi.fn(),
-	getBodiesOfWork: vi.fn(),
-	deleteBodyOfWork: vi.fn(),
-	addTaskToBodyOfWork: vi.fn(),
-	removeTaskFromBodyOfWork: vi.fn(),
-	activateBodyOfWork: vi.fn(),
-	addTaskDependency: vi.fn(),
-	removeTaskDependency: vi.fn(),
-	getTaskDependencies: vi.fn(),
-	getNextBodyOfWorkTask: vi.fn(),
-
-	// Deployment
-	requestDeployment: vi.fn(),
-	claimDeploymentValidation: vi.fn(),
-	reportValidation: vi.fn(),
-	checkDeploymentStatus: vi.fn(),
-	startDeployment: vi.fn(),
-	completeDeployment: vi.fn(),
-	cancelDeployment: vi.fn(),
-	addDeploymentRequirement: vi.fn(),
-	completeDeploymentRequirement: vi.fn(),
-	getDeploymentRequirements: vi.fn(),
-	getDeploymentRequirementsStats: vi.fn(),
-	scheduleDeployment: vi.fn(),
-	getScheduledDeployments: vi.fn(),
-	updateScheduledDeployment: vi.fn(),
-	deleteScheduledDeployment: vi.fn(),
-	triggerScheduledDeployment: vi.fn(),
-	checkDueDeployments: vi.fn(),
-
-	// Validation
-	getTasksAwaitingValidation: vi.fn(),
-	claimValidation: vi.fn(),
-	validateTask: vi.fn(),
-
-	// Help Topics
-	getHelpTopic: vi.fn(),
-	getHelpTopics: vi.fn(),
-
-	// File Checkouts
-	checkoutFile: vi.fn(),
-	checkinFile: vi.fn(),
-	getFileCheckouts: vi.fn(),
-	getFileCheckoutsStats: vi.fn(),
-	abandonCheckout: vi.fn(),
-
-	// Connectors
-	getConnectors: vi.fn(),
-	getConnector: vi.fn(),
-	addConnector: vi.fn(),
-	updateConnector: vi.fn(),
-	deleteConnector: vi.fn(),
-	testConnector: vi.fn(),
-	getConnectorEvents: vi.fn(),
-
-	// Proxy (generic)
-	proxy: vi.fn(),
-};
-
-// ============================================================================
-// Mock the API Client Module
-// ============================================================================
-
-// Note: The path is relative to the test file location, not this setup file
-// This setup file is in src/handlers/, tests import from ../api-client.js
-vi.mock('../api-client.js', () => ({
-	getApiClient: () => mockApiClient,
-	initApiClient: vi.fn(),
-	VibescopeApiClient: vi.fn(),
-}));
-
-// Also mock with absolute-style path for tests outside handlers/
-vi.mock('../../api-client.js', () => ({
-	getApiClient: () => mockApiClient,
-	initApiClient: vi.fn(),
-	VibescopeApiClient: vi.fn(),
-}));
-
-// Export for test files that need direct access
-export { mockApiClient as __mockApiClient__ };
-
-// ============================================================================
-// Reset Mocks Before Each Test
-// ============================================================================
-
-/**
- * Reset all mock functions before each test and set default return values.
- * This ensures tests start with a clean slate and have sensible defaults.
- */
-beforeEach(() => {
-	// Reset all mocks
-	Object.values(mockApiClient).forEach((mockFn) => {
-		if (typeof mockFn === 'function' && mockFn.mockReset) {
-			mockFn.mockReset();
-			// Set default return value to success
-			mockFn.mockResolvedValue({ ok: true, data: {} });
-		}
-	});
-});
+/**
+ * Global Test Setup for Handler Tests
+ *
+ * This file is loaded before all tests via vitest.config.ts setupFiles.
+ * It provides a global mock for the API client used by migrated handlers.
+ */
+
+import { vi, beforeEach } from 'vitest';
+
+// Default success response for API calls
+const defaultSuccess = { ok: true, data: {} };
+const defaultError = { ok: false, error: 'Mock error' };
+
+// ============================================================================
+// Global Mock API Client
+// ============================================================================
+
+/**
+ * Mock API client with all methods stubbed.
+ * Tests can configure return values using mockResolvedValue/mockImplementation.
+ * Default return is a success response { ok: true, data: {} }
+ */
+export const mockApiClient = {
+	// Session
+	startSession: vi.fn(),
+	heartbeat: vi.fn(),
+	syncSession: vi.fn(),
+	endSession: vi.fn(),
+	reportTokenUsage: vi.fn(),
+
+	// Project
+	listProjects: vi.fn(),
+	getProject: vi.fn(),
+	getProjectContext: vi.fn(),
+	createProject: vi.fn(),
+	updateProject: vi.fn(),
+	updateProjectReadme: vi.fn(),
+	getGitWorkflow: vi.fn(),
+
+	// Tasks
+	getTasks: vi.fn(),
+	getNextTask: vi.fn(),
+	createTask: vi.fn(),
+	updateTask: vi.fn(),
+	completeTask: vi.fn(),
+	deleteTask: vi.fn(),
+	addTaskReference: vi.fn(),
+	removeTaskReference: vi.fn(),
+	batchUpdateTasks: vi.fn(),
+	batchCompleteTasks: vi.fn(),
+
+	// Subtasks
+	addSubtask: vi.fn(),
+	getSubtasks: vi.fn(),
+
+	// Progress
+	logProgress: vi.fn(),
+	getActivityFeed: vi.fn(),
+
+	// Blockers
+	addBlocker: vi.fn(),
+	resolveBlocker: vi.fn(),
+	getBlockers: vi.fn(),
+	getBlockersStats: vi.fn(),
+	deleteBlocker: vi.fn(),
+
+	// Decisions
+	logDecision: vi.fn(),
+	getDecisions: vi.fn(),
+	getDecisionsStats: vi.fn(),
+	deleteDecision: vi.fn(),
+
+	// Ideas
+	addIdea: vi.fn(),
+	updateIdea: vi.fn(),
+	getIdeas: vi.fn(),
+	deleteIdea: vi.fn(),
+	convertIdeaToTask: vi.fn(),
+
+	// Findings
+	addFinding: vi.fn(),
+	getFindings: vi.fn(),
+	getFindingsStats: vi.fn(),
+	updateFinding: vi.fn(),
+	deleteFinding: vi.fn(),
+	queryKnowledgeBase: vi.fn(),
+
+	// Requests
+	getPendingRequests: vi.fn(),
+	acknowledgeRequest: vi.fn(),
+	answerQuestion: vi.fn(),
+
+	// Milestones
+	addMilestone: vi.fn(),
+	updateMilestone: vi.fn(),
+	completeMilestone: vi.fn(),
+	deleteMilestone: vi.fn(),
+	getMilestones: vi.fn(),
+
+	// Fallback
+	startFallbackActivity: vi.fn(),
+	stopFallbackActivity: vi.fn(),
+	getActivityHistory: vi.fn(),
+	getActivitySchedules: vi.fn(),
+
+	// Cost
+	getCostSummary: vi.fn(),
+	getCostAlerts: vi.fn(),
+	addCostAlert: vi.fn(),
+	updateCostAlert: vi.fn(),
+	deleteCostAlert: vi.fn(),
+	getTaskCosts: vi.fn(),
+
+	// Git Issues
+	addGitIssue: vi.fn(),
+	resolveGitIssue: vi.fn(),
+	getGitIssues: vi.fn(),
+	deleteGitIssue: vi.fn(),
+
+	// Organizations
+	listOrganizations: vi.fn(),
+	createOrganization: vi.fn(),
+	updateOrganization: vi.fn(),
+	deleteOrganization: vi.fn(),
+	listOrgMembers: vi.fn(),
+	inviteMember: vi.fn(),
+	updateMemberRole: vi.fn(),
+	removeMember: vi.fn(),
+	leaveOrganization: vi.fn(),
+	shareProjectWithOrg: vi.fn(),
+	updateProjectShare: vi.fn(),
+	unshareProject: vi.fn(),
+	listProjectShares: vi.fn(),
+
+	// Bodies of Work
+	createBodyOfWork: vi.fn(),
+	updateBodyOfWork: vi.fn(),
+	getBodyOfWork: vi.fn(),
+	getBodiesOfWork: vi.fn(),
+	deleteBodyOfWork: vi.fn(),
+	addTaskToBodyOfWork: vi.fn(),
+	removeTaskFromBodyOfWork: vi.fn(),
+	activateBodyOfWork: vi.fn(),
+	addTaskDependency: vi.fn(),
+	removeTaskDependency: vi.fn(),
+	getTaskDependencies: vi.fn(),
+	getNextBodyOfWorkTask: vi.fn(),
+
+	// Deployment
+	requestDeployment: vi.fn(),
+	claimDeploymentValidation: vi.fn(),
+	reportValidation: vi.fn(),
+	checkDeploymentStatus: vi.fn(),
+	startDeployment: vi.fn(),
+	completeDeployment: vi.fn(),
+	cancelDeployment: vi.fn(),
+	addDeploymentRequirement: vi.fn(),
+	completeDeploymentRequirement: vi.fn(),
+	getDeploymentRequirements: vi.fn(),
+	getDeploymentRequirementsStats: vi.fn(),
+	scheduleDeployment: vi.fn(),
+	getScheduledDeployments: vi.fn(),
+	updateScheduledDeployment: vi.fn(),
+	deleteScheduledDeployment: vi.fn(),
+	triggerScheduledDeployment: vi.fn(),
+	checkDueDeployments: vi.fn(),
+
+	// Validation
+	getTasksAwaitingValidation: vi.fn(),
+	claimValidation: vi.fn(),
+	validateTask: vi.fn(),
+
+	// Help Topics
+	getHelpTopic: vi.fn(),
+	getHelpTopics: vi.fn(),
+
+	// File Checkouts
+	checkoutFile: vi.fn(),
+	checkinFile: vi.fn(),
+	getFileCheckouts: vi.fn(),
+	getFileCheckoutsStats: vi.fn(),
+	abandonCheckout: vi.fn(),
+
+	// Connectors
+	getConnectors: vi.fn(),
+	getConnector: vi.fn(),
+	addConnector: vi.fn(),
+	updateConnector: vi.fn(),
+	deleteConnector: vi.fn(),
+	testConnector: vi.fn(),
+	getConnectorEvents: vi.fn(),
+
+	// Proxy (generic)
+	proxy: vi.fn(),
+};
+
+// ============================================================================
+// Mock the API Client Module
+// ============================================================================
+
+// Note: The path is relative to the test file location, not this setup file
+// This setup file is in src/handlers/, tests import from ../api-client.js
+vi.mock('../api-client.js', () => ({
+	getApiClient: () => mockApiClient,
+	initApiClient: vi.fn(),
+	VibescopeApiClient: vi.fn(),
+}));
+
+// Also mock with absolute-style path for tests outside handlers/
+vi.mock('../../api-client.js', () => ({
+	getApiClient: () => mockApiClient,
+	initApiClient: vi.fn(),
+	VibescopeApiClient: vi.fn(),
+}));
+
+// Export for test files that need direct access
+export { mockApiClient as __mockApiClient__ };
+
+// ============================================================================
+// Reset Mocks Before Each Test
+// ============================================================================
+
+/**
+ * Reset all mock functions before each test and set default return values.
+ * This ensures tests start with a clean slate and have sensible defaults.
+ */
+beforeEach(() => {
+	// Reset all mocks
+	Object.values(mockApiClient).forEach((mockFn) => {
+		if (typeof mockFn === 'function' && mockFn.mockReset) {
+			mockFn.mockReset();
+			// Set default return value to success
+			mockFn.mockResolvedValue({ ok: true, data: {} });
+		}
+	});
+});