@vibescope/mcp-server 0.4.4 → 0.4.6

package/src/api-client/session.ts

@@ -1,220 +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
-			});
-		}
-	};
-}
+/**
+ * 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
+			});
+		}
+	};
+}

package/src/api-client/sprints.ts

@@ -0,0 +1,227 @@
+/**
+ * Sprints API Methods
+ *
+ * Methods for sprint management:
+ * - createSprint: Create a new sprint
+ * - updateSprint: Update sprint details
+ * - getSprint: Get a sprint with tasks
+ * - getSprints: List sprints for a project
+ * - deleteSprint: Delete a sprint
+ * - startSprint: Activate a sprint
+ * - completeSprint: Complete a sprint
+ * - addTaskToSprint: Add a task to a sprint
+ * - removeTaskFromSprint: Remove a task from a sprint
+ * - getSprintBacklog: Get tasks available to add to a sprint
+ * - getSprintVelocity: Get velocity metrics for completed sprints
+ */
+
+import type { ApiResponse, ProxyFn } from './types.js';
+
+export interface SprintsMethods {
+	createSprint(projectId: string, params: {
+		title: string;
+		start_date: string;
+		end_date: string;
+		goal?: string;
+		auto_deploy_on_completion?: boolean;
+		deploy_environment?: string;
+		deploy_version_bump?: string;
+	}): Promise<ApiResponse<{
+		success: boolean;
+		sprint_id: string;
+		sprint_number: number;
+	}>>;
+
+	updateSprint(sprintId: string, updates: {
+		title?: string;
+		goal?: string;
+		start_date?: string;
+		end_date?: string;
+		auto_deploy_on_completion?: boolean;
+		deploy_environment?: string;
+		deploy_version_bump?: string;
+	}): Promise<ApiResponse<{
+		success: boolean;
+	}>>;
+
+	getSprint(sprintId: string, summaryOnly?: boolean): Promise<ApiResponse<{
+		id: string;
+		title: string;
+		goal?: string;
+		sprint_number: number;
+		sprint_status: string;
+		start_date: string;
+		end_date: string;
+		progress_percentage: number;
+		velocity_points: number;
+		committed_points: number;
+		pre_tasks?: unknown[];
+		core_tasks?: unknown[];
+		post_tasks?: unknown[];
+		total_tasks?: number;
+		task_counts?: {
+			pre: { total: number; completed: number };
+			core: { total: number; completed: number };
+			post: { total: number; completed: number };
+			total: number;
+			completed: number;
+			in_progress: number;
+		};
+		next_task?: { id: string; title: string; priority: number; phase: string } | null;
+	}>>;
+
+	getSprints(projectId: string, params?: {
+		status?: string;
+		limit?: number;
+		offset?: number;
+	}): Promise<ApiResponse<{
+		sprints: Array<{
+			id: string;
+			title: string;
+			sprint_number: number;
+			sprint_status: string;
+			start_date: string;
+			end_date: string;
+			progress_percentage: number;
+			velocity_points: number;
+			committed_points: number;
+		}>;
+		total_count: number;
+		has_more: boolean;
+	}>>;
+
+	deleteSprint(sprintId: string): Promise<ApiResponse<{
+		success: boolean;
+	}>>;
+
+	startSprint(sprintId: string): Promise<ApiResponse<{
+		success: boolean;
+		sprint_id: string;
+		status: string;
+	}>>;
+
+	completeSprint(sprintId: string, params?: {
+		retrospective_notes?: string;
+		skip_retrospective?: boolean;
+	}): Promise<ApiResponse<{
+		success: boolean;
+		sprint_id: string;
+		status: string;
+	}>>;
+
+	addTaskToSprint(sprintId: string, taskId: string, params?: {
+		story_points?: number;
+		phase?: string;
+	}): Promise<ApiResponse<{
+		success: boolean;
+	}>>;
+
+	removeTaskFromSprint(sprintId: string, taskId: string): Promise<ApiResponse<{
+		success: boolean;
+	}>>;
+
+	getSprintBacklog(projectId: string, sprintId?: string, params?: {
+		limit?: number;
+		offset?: number;
+	}): Promise<ApiResponse<{
+		tasks: Array<{
+			id: string;
+			title: string;
+			priority: number;
+			status: string;
+			estimated_minutes?: number;
+		}>;
+		total_count: number;
+		has_more: boolean;
+	}>>;
+
+	getSprintVelocity(projectId: string, limit?: number): Promise<ApiResponse<{
+		sprints: Array<{
+			sprint_id: string;
+			sprint_number: number;
+			title: string;
+			committed_points: number;
+			velocity_points: number;
+			completion_rate: number;
+		}>;
+		average_velocity: number;
+		total_sprints: number;
+	}>>;
+}
+
+export function createSprintsMethods(proxy: ProxyFn): SprintsMethods {
+	return {
+		async createSprint(projectId, params) {
+			return proxy('create_sprint', {
+				project_id: projectId,
+				...params
+			});
+		},
+
+		async updateSprint(sprintId, updates) {
+			return proxy('update_sprint', {
+				sprint_id: sprintId,
+				...updates
+			});
+		},
+
+		async getSprint(sprintId, summaryOnly) {
+			return proxy('get_sprint', {
+				sprint_id: sprintId,
+				summary_only: summaryOnly
+			});
+		},
+
+		async getSprints(projectId, params) {
+			return proxy('get_sprints', {
+				project_id: projectId,
+				...params
+			});
+		},
+
+		async deleteSprint(sprintId) {
+			return proxy('delete_sprint', { sprint_id: sprintId });
+		},
+
+		async startSprint(sprintId) {
+			return proxy('start_sprint', { sprint_id: sprintId });
+		},
+
+		async completeSprint(sprintId, params) {
+			return proxy('complete_sprint', {
+				sprint_id: sprintId,
+				...params
+			});
+		},
+
+		async addTaskToSprint(sprintId, taskId, params) {
+			return proxy('add_task_to_sprint', {
+				sprint_id: sprintId,
+				task_id: taskId,
+				...params
+			});
+		},
+
+		async removeTaskFromSprint(sprintId, taskId) {
+			return proxy('remove_task_from_sprint', {
+				sprint_id: sprintId,
+				task_id: taskId
+			});
+		},
+
+		async getSprintBacklog(projectId, sprintId, params) {
+			return proxy('get_sprint_backlog', {
+				project_id: projectId,
+				sprint_id: sprintId,
+				...params
+			});
+		},
+
+		async getSprintVelocity(projectId, limit) {
+			return proxy('get_sprint_velocity', {
+				project_id: projectId,
+				limit
+			});
+		}
+	};
+}