@vibescope/mcp-server 0.3.0 → 0.3.3

package/src/api-client/project.ts

@@ -0,0 +1,179 @@
+/**
+ * Project API Methods
+ *
+ * Methods for project management:
+ * - listProjects: List all projects
+ * - createProject: Create a new project
+ * - getProject: Get project details
+ * - updateProject: Update project settings
+ * - getGitWorkflow: Get git workflow configuration
+ * - updateProjectReadme: Update project README
+ * - getProjectSummary: Get project summary
+ */
+
+import type { ApiResponse, RequestFn } from './types.js';
+
+export interface ProjectMethods {
+	listProjects(): Promise<ApiResponse<{
+		projects: Array<{
+			id: string;
+			name: string;
+			description?: string;
+			status: string;
+			git_url?: string;
+			goal?: string;
+			tech_stack?: string[];
+		}>;
+	}>>;
+
+	createProject(params: {
+		name: string;
+		description?: string;
+		goal?: string;
+		git_url?: string;
+		tech_stack?: string[];
+	}): Promise<ApiResponse<{
+		success: boolean;
+		project: {
+			id: string;
+			name: string;
+		};
+	}>>;
+
+	getProject(projectId: string, gitUrl?: string): Promise<ApiResponse<{
+		found: boolean;
+		project?: {
+			id: string;
+			name: string;
+			description?: string;
+			goal?: string;
+			status: string;
+			git_url?: string;
+			agent_instructions?: string;
+			tech_stack?: string[];
+			git_workflow?: string;
+			git_main_branch?: string;
+			git_develop_branch?: string;
+			git_auto_branch?: boolean;
+			git_auto_tag?: boolean;
+			deployment_instructions?: string;
+		};
+		active_tasks?: Array<{
+			id: string;
+			title: string;
+			description?: string;
+			priority: number;
+			status: string;
+			progress_percentage?: number;
+			estimated_minutes?: number;
+		}>;
+		open_blockers?: Array<{
+			id: string;
+			description: string;
+		}>;
+		recent_decisions?: Array<{
+			id: string;
+			title: string;
+			description?: string;
+		}>;
+		message?: string;
+	}>>;
+
+	updateProject(projectId: string, updates: {
+		name?: string;
+		description?: string;
+		goal?: string;
+		git_url?: string;
+		tech_stack?: string[];
+		status?: string;
+		git_workflow?: string;
+		git_main_branch?: string;
+		git_develop_branch?: string;
+		git_auto_branch?: boolean;
+		git_auto_tag?: boolean;
+		deployment_instructions?: string;
+		agent_instructions?: string;
+		git_delete_branch_on_merge?: boolean;
+		require_pr_for_validation?: boolean;
+		auto_merge_on_approval?: boolean;
+		validation_required?: boolean;
+		default_task_priority?: number;
+		require_time_estimates?: boolean;
+		fallback_activities_enabled?: boolean;
+		preferred_fallback_activities?: string[];
+	}): Promise<ApiResponse<{
+		success: boolean;
+		project_id: string;
+	}>>;
+
+	getGitWorkflow(projectId: string, taskId?: string): Promise<ApiResponse<{
+		workflow: string;
+		main_branch: string;
+		develop_branch?: string;
+		suggested_branch?: string;
+		base_branch?: string;
+	}>>;
+
+	updateProjectReadme(projectId: string, readmeContent: string): Promise<ApiResponse<{
+		success: boolean;
+		project_id: string;
+	}>>;
+
+	getProjectSummary(projectId: string): Promise<ApiResponse<{
+		project: {
+			id: string;
+			name: string;
+			description?: string;
+			goal?: string;
+			status: string;
+		};
+		stats: {
+			total_tasks: number;
+			completed_tasks: number;
+			in_progress_tasks: number;
+			pending_tasks: number;
+			open_blockers: number;
+			total_decisions: number;
+		};
+	}>>;
+}
+
+export function createProjectMethods(request: RequestFn): ProjectMethods {
+	return {
+		async listProjects() {
+			return request('GET', '/api/mcp/projects');
+		},
+
+		async createProject(params) {
+			return request('POST', '/api/mcp/projects', params);
+		},
+
+		async getProject(projectId, gitUrl) {
+			const url = gitUrl
+				? `/api/mcp/projects/${projectId}?git_url=${encodeURIComponent(gitUrl)}`
+				: `/api/mcp/projects/${projectId}`;
+			return request('GET', url);
+		},
+
+		async updateProject(projectId, updates) {
+			return request('PATCH', `/api/mcp/projects/${projectId}`, updates);
+		},
+
+		async getGitWorkflow(projectId, taskId) {
+			const url = taskId
+				? `/api/mcp/projects/${projectId}/git-workflow?task_id=${taskId}`
+				: `/api/mcp/projects/${projectId}/git-workflow`;
+			return request('GET', url);
+		},
+
+		async updateProjectReadme(projectId, readmeContent) {
+			return request('PATCH', `/api/mcp/projects/${projectId}/readme`, {
+				readme_content: readmeContent
+			});
+		},
+
+		async getProjectSummary(projectId) {
+			return request('GET', `/api/mcp/projects/${projectId}/summary`);
+		}
+	};
+}

package/src/api-client/session.ts

@@ -0,0 +1,220 @@
+/**
+ * Session API Methods
+ *
+ * Methods for session lifecycle management:
+ * - validateAuth: Validate API key
+ * - startSession: Start a new work session
+ * - heartbeat: Maintain active status
+ * - endSession: End session and release tasks
+ * - signalIdle: Signal agent is idle
+ * - syncSession: Sync session state
+ * - confirmAgentSetup: Confirm agent setup completion
+ */
+
+import type { ApiResponse, RequestFn } from './types.js';
+
+export interface SessionMethods {
+	validateAuth(): Promise<ApiResponse<{
+		valid: boolean;
+		user_id: string;
+		api_key_id: string;
+		key_name: string;
+	}>>;
+
+	startSession(params: {
+		project_id?: string;
+		git_url?: string;
+		mode?: 'lite' | 'full';
+		model?: string;
+		role?: string;
+		hostname?: string;
+		agent_type?: string;
+		agent_name?: string; // Explicit name for cloud/remote agents (skips persona pool)
+	}): Promise<ApiResponse<{
+		session_started: boolean;
+		session_id?: string;
+		persona?: string;
+		role?: string;
+		project?: {
+			id: string;
+			name: string;
+			description?: string;
+			goal?: string;
+			status?: string;
+			git_url?: string;
+			agent_instructions?: string;
+			tech_stack?: string[];
+			git_workflow?: string;
+			git_main_branch?: string;
+			git_develop_branch?: string;
+			git_auto_branch?: boolean;
+		};
+		active_tasks?: Array<{
+			id: string;
+			title: string;
+			status: string;
+			priority: number;
+			progress_percentage?: number;
+			estimated_minutes?: number;
+		}>;
+		blockers?: Array<{
+			id: string;
+			description: string;
+			status: string;
+		}>;
+		next_task?: {
+			id: string;
+			title: string;
+			priority: number;
+			estimated_minutes?: number;
+		} | null;
+		pending_requests?: Array<{
+			id: string;
+			request_type: string;
+			message: string;
+			created_at: string;
+		}>;
+		pending_requests_count?: number;
+		URGENT_QUESTIONS?: {
+			count: number;
+			oldest_waiting_minutes: number;
+			action_required: string;
+			requests: Array<{
+				id: string;
+				message: string;
+				waiting_minutes: number;
+			}>;
+		};
+		directive?: string;
+		blockers_count?: number;
+		validation_count?: number;
+		project_not_found?: boolean;
+		message?: string;
+		suggestion?: {
+			action: string;
+			example: string;
+			note: string;
+		};
+		agent_setup?: {
+			agent_type: string;
+			is_new_agent_type: boolean;
+			setup_required: boolean;
+			instructions: string;
+			config_file: string;
+			template_url?: string;
+			steps: string[];
+		};
+		stale_worktrees?: Array<{
+			task_id: string;
+			task_title: string;
+			worktree_path: string;
+			worktree_hostname?: string | null;
+		}>;
+		stale_worktrees_count?: number;
+		cleanup_action?: string;
+		awaiting_validation?: Array<{
+			id: string;
+			title?: string;
+		}>;
+		validation_priority?: boolean;
+		next_action?: string;
+		error?: string;
+	}>>;
+
+	heartbeat(sessionId: string, options?: {
+		current_worktree_path?: string | null;
+		hostname?: string;
+	}): Promise<ApiResponse<{
+		success: boolean;
+		session_id: string;
+		timestamp: string;
+	}>>;
+
+	endSession(sessionId: string): Promise<ApiResponse<{
+		success: boolean;
+		ended_session_id?: string;
+		session_summary?: {
+			agent_name: string;
+			tasks_completed_this_session: number;
+			tasks_awaiting_validation: number;
+			tasks_released: number;
+		};
+		reminders?: string[];
+	}>>;
+
+	signalIdle(sessionId: string): Promise<ApiResponse<{
+		success: boolean;
+		session_id: string;
+		status: string;
+		message: string;
+	}>>;
+
+	syncSession(sessionId: string, params?: {
+		include_project?: boolean;
+		include_tasks?: boolean;
+	}): Promise<ApiResponse<{
+		session: {
+			id: string;
+			status: string;
+			agent_name: string;
+		};
+		project?: unknown;
+		tasks?: unknown[];
+	}>>;
+
+	confirmAgentSetup(projectId: string, agentType: string): Promise<ApiResponse<{
+		success: boolean;
+		project_id: string;
+		agent_type: string;
+	}>>;
+}
+
+export function createSessionMethods(
+	request: RequestFn,
+	getApiKey: () => string
+): SessionMethods {
+	return {
+		async validateAuth() {
+			return request('POST', '/api/mcp/auth/validate', {
+				api_key: getApiKey()
+			});
+		},
+
+		async startSession(params) {
+			return request('POST', '/api/mcp/sessions/start', params);
+		},
+
+		async heartbeat(sessionId, options) {
+			return request('POST', '/api/mcp/sessions/heartbeat', {
+				session_id: sessionId,
+				...options
+			});
+		},
+
+		async endSession(sessionId) {
+			return request('POST', '/api/mcp/sessions/end', {
+				session_id: sessionId
+			});
+		},
+
+		async signalIdle(sessionId) {
+			return request('POST', '/api/mcp/sessions/idle', {
+				session_id: sessionId
+			});
+		},
+
+		async syncSession(sessionId, params) {
+			return request('POST', '/api/mcp/sessions/sync', {
+				session_id: sessionId,
+				...params
+			});
+		},
+
+		async confirmAgentSetup(projectId, agentType) {
+			return request('POST', '/api/mcp/agent-setup/confirm', {
+				project_id: projectId,
+				agent_type: agentType
+			});
+		}
+	};
+}