@vibescope/mcp-server 0.0.1 → 0.1.0

package/src/handlers/git-issues.ts

@@ -0,0 +1,174 @@
+/**
+ * Git Issues Handlers
+ *
+ * Handles git issue management:
+ * - add_git_issue: Record a git-related issue (conflicts, push failures, etc.)
+ * - resolve_git_issue: Mark a git issue as resolved
+ * - get_git_issues: List git issues for a project
+ * - delete_git_issue: Remove a git issue
+ */
+
+import type { Handler, HandlerRegistry } from './types.js';
+import { validateRequired, validateUUID } from '../validators.js';
+import { getApiClient } from '../api-client.js';
+
+const VALID_GIT_ISSUE_TYPES = [
+	'merge_conflict',
+	'push_failed',
+	'rebase_needed',
+	'branch_diverged',
+	'pr_not_mergeable',
+] as const;
+
+const VALID_GIT_ISSUE_STATUSES = ['open', 'resolved'] as const;
+
+type GitIssueType = (typeof VALID_GIT_ISSUE_TYPES)[number];
+type GitIssueStatus = (typeof VALID_GIT_ISSUE_STATUSES)[number];
+
+export const addGitIssue: Handler = async (args, ctx) => {
+	const {
+		project_id,
+		issue_type,
+		branch,
+		target_branch,
+		pr_url,
+		conflicting_files,
+		error_message,
+		task_id,
+	} = args as {
+		project_id: string;
+		issue_type: string;
+		branch: string;
+		target_branch?: string;
+		pr_url?: string;
+		conflicting_files?: string[];
+		error_message?: string;
+		task_id?: string;
+	};
+
+	validateRequired(project_id, 'project_id');
+	validateUUID(project_id, 'project_id');
+	validateRequired(issue_type, 'issue_type');
+	validateRequired(branch, 'branch');
+
+	if (!VALID_GIT_ISSUE_TYPES.includes(issue_type as GitIssueType)) {
+		throw new Error(
+			`Invalid issue_type. Valid types: ${VALID_GIT_ISSUE_TYPES.join(', ')}`
+		);
+	}
+
+	if (task_id) {
+		validateUUID(task_id, 'task_id');
+	}
+
+	const apiClient = getApiClient();
+	const response = await apiClient.addGitIssue(project_id, {
+		issue_type: issue_type as GitIssueType,
+		branch,
+		target_branch,
+		pr_url,
+		conflicting_files,
+		error_message,
+		task_id
+	}, ctx.session.currentSessionId || undefined);
+
+	if (!response.ok) {
+		throw new Error(response.error || 'Failed to add git issue');
+	}
+
+	return { result: response.data };
+};
+
+export const resolveGitIssue: Handler = async (args, ctx) => {
+	const { git_issue_id, resolution_note, auto_resolved } = args as {
+		git_issue_id: string;
+		resolution_note?: string;
+		auto_resolved?: boolean;
+	};
+
+	validateRequired(git_issue_id, 'git_issue_id');
+	validateUUID(git_issue_id, 'git_issue_id');
+
+	const apiClient = getApiClient();
+	const response = await apiClient.resolveGitIssue(git_issue_id, {
+		resolution_note,
+		auto_resolved
+	}, ctx.session.currentSessionId || undefined);
+
+	if (!response.ok) {
+		throw new Error(response.error || 'Failed to resolve git issue');
+	}
+
+	return { result: response.data };
+};
+
+export const getGitIssues: Handler = async (args, ctx) => {
+	const {
+		project_id,
+		status = 'open',
+		issue_type,
+		branch,
+		limit = 50,
+	} = args as {
+		project_id: string;
+		status?: string;
+		issue_type?: string;
+		branch?: string;
+		limit?: number;
+	};
+
+	validateRequired(project_id, 'project_id');
+	validateUUID(project_id, 'project_id');
+
+	if (status && !VALID_GIT_ISSUE_STATUSES.includes(status as GitIssueStatus)) {
+		throw new Error(
+			`Invalid status. Valid statuses: ${VALID_GIT_ISSUE_STATUSES.join(', ')}`
+		);
+	}
+
+	if (issue_type && !VALID_GIT_ISSUE_TYPES.includes(issue_type as GitIssueType)) {
+		throw new Error(
+			`Invalid issue_type. Valid types: ${VALID_GIT_ISSUE_TYPES.join(', ')}`
+		);
+	}
+
+	const apiClient = getApiClient();
+	const response = await apiClient.getGitIssues(project_id, {
+		status,
+		issue_type,
+		branch,
+		limit
+	});
+
+	if (!response.ok) {
+		throw new Error(response.error || 'Failed to fetch git issues');
+	}
+
+	return { result: response.data };
+};
+
+export const deleteGitIssue: Handler = async (args, ctx) => {
+	const { git_issue_id } = args as { git_issue_id: string };
+
+	validateRequired(git_issue_id, 'git_issue_id');
+	validateUUID(git_issue_id, 'git_issue_id');
+
+	const apiClient = getApiClient();
+	const response = await apiClient.deleteGitIssue(git_issue_id);
+
+	if (!response.ok) {
+		throw new Error(response.error || 'Failed to delete git issue');
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Git Issues handlers registry
+ */
+export const gitIssueHandlers: HandlerRegistry = {
+	add_git_issue: addGitIssue,
+	resolve_git_issue: resolveGitIssue,
+	get_git_issues: getGitIssues,
+	delete_git_issue: deleteGitIssue,
+};