@vibescope/mcp-server 0.5.0 → 0.5.1

package/src/handlers/project.ts

@@ -1,245 +1,245 @@
-/**
- * Project Handlers
- *
- * Handles project CRUD and configuration:
- * - get_project_context
- * - get_git_workflow
- * - create_project
- * - update_project
- * - update_project_readme
- */
-
-import type { Handler, HandlerRegistry } from './types.js';
-import {
-	parseArgs,
-	uuidValidator,
-	projectStatusValidator,
-	createEnumValidator,
-	VALID_PROJECT_STATUSES,
-} from '../validators.js';
-import { getApiClient } from '../api-client.js';
-
-const VALID_GIT_WORKFLOWS = ['none', 'trunk-based', 'github-flow', 'git-flow'] as const;
-type GitWorkflow = typeof VALID_GIT_WORKFLOWS[number];
-
-// Argument schemas for type-safe parsing
-const getProjectContextSchema = {
-	project_id: { type: 'string' as const, validate: uuidValidator },
-	git_url: { type: 'string' as const },
-};
-
-const getGitWorkflowSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	task_id: { type: 'string' as const, validate: uuidValidator },
-};
-
-const createProjectSchema = {
-	name: { type: 'string' as const, required: true as const },
-	description: { type: 'string' as const },
-	goal: { type: 'string' as const },
-	git_url: { type: 'string' as const },
-	tech_stack: { type: 'array' as const },
-};
-
-const updateProjectSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	name: { type: 'string' as const },
-	description: { type: 'string' as const },
-	goal: { type: 'string' as const },
-	git_url: { type: 'string' as const },
-	tech_stack: { type: 'array' as const },
-	status: { type: 'string' as const, validate: projectStatusValidator },
-	git_workflow: { type: 'string' as const, validate: createEnumValidator(VALID_GIT_WORKFLOWS) },
-	git_main_branch: { type: 'string' as const },
-	git_develop_branch: { type: 'string' as const },
-	git_auto_branch: { type: 'boolean' as const },
-	git_auto_tag: { type: 'boolean' as const },
-	deployment_instructions: { type: 'string' as const },
-	// New project settings
-	git_delete_branch_on_merge: { type: 'boolean' as const },
-	require_pr_for_validation: { type: 'boolean' as const },
-	auto_merge_on_approval: { type: 'boolean' as const },
-	validation_required: { type: 'boolean' as const },
-	default_task_priority: { type: 'number' as const },
-	require_time_estimates: { type: 'boolean' as const },
-	fallback_activities_enabled: { type: 'boolean' as const },
-	preferred_fallback_activities: { type: 'array' as const },
-	allow_local_agent_task_creation: { type: 'boolean' as const },
-	allow_cloud_agent_task_creation: { type: 'boolean' as const },
-};
-
-const updateProjectReadmeSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	readme_content: { type: 'string' as const, required: true as const },
-};
-
-const getProjectSummarySchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-};
-
-export const getProjectContext: Handler = async (args, _ctx) => {
-	const { project_id, git_url } = parseArgs(args, getProjectContextSchema);
-
-	const apiClient = getApiClient();
-
-	// If no project_id or git_url, list all projects
-	if (!project_id && !git_url) {
-		const response = await apiClient.listProjects();
-
-		if (!response.ok) {
-			return { result: { error: response.error || 'Failed to fetch projects' }, isError: true };
-		}
-
-		return { result: { projects: response.data?.projects || [] } };
-	}
-
-	// Find project by ID or git_url
-	const response = await apiClient.getProject(project_id || 'by-git-url', git_url);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to fetch project' }, isError: true };
-	}
-
-	if (!response.data?.found) {
-		return {
-			result: {
-				found: false,
-				message: response.data?.message || 'Project not found. Use create_project to create one.',
-			},
-		};
-	}
-
-	return { result: response.data };
-};
-
-export const getGitWorkflow: Handler = async (args, _ctx) => {
-	const { project_id, task_id } = parseArgs(args, getGitWorkflowSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.getGitWorkflow(project_id, task_id);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to get git workflow' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const createProject: Handler = async (args, _ctx) => {
-	const { name, description, goal, git_url, tech_stack } = parseArgs(args, createProjectSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.createProject({
-		name,
-		description,
-		goal,
-		git_url,
-		tech_stack: tech_stack as string[] | undefined
-	});
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to create project' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const updateProject: Handler = async (args, _ctx) => {
-	const {
-		project_id,
-		name,
-		description,
-		goal,
-		git_url,
-		tech_stack,
-		status,
-		git_workflow,
-		git_main_branch,
-		git_develop_branch,
-		git_auto_branch,
-		git_auto_tag,
-		deployment_instructions,
-		// New project settings
-		git_delete_branch_on_merge,
-		require_pr_for_validation,
-		auto_merge_on_approval,
-		validation_required,
-		default_task_priority,
-		require_time_estimates,
-		fallback_activities_enabled,
-		preferred_fallback_activities,
-		allow_local_agent_task_creation,
-		allow_cloud_agent_task_creation
-	} = parseArgs(args, updateProjectSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.updateProject(project_id, {
-		name,
-		description,
-		goal,
-		git_url,
-		tech_stack: tech_stack as string[] | undefined,
-		status: status as typeof VALID_PROJECT_STATUSES[number] | undefined,
-		git_workflow: git_workflow as GitWorkflow | undefined,
-		git_main_branch,
-		git_develop_branch,
-		git_auto_branch,
-		git_auto_tag,
-		deployment_instructions,
-		// New project settings
-		git_delete_branch_on_merge,
-		require_pr_for_validation,
-		auto_merge_on_approval,
-		validation_required,
-		default_task_priority,
-		require_time_estimates,
-		fallback_activities_enabled,
-		preferred_fallback_activities: preferred_fallback_activities as string[] | undefined,
-		allow_local_agent_task_creation: allow_local_agent_task_creation as boolean | undefined,
-		allow_cloud_agent_task_creation: allow_cloud_agent_task_creation as boolean | undefined
-	});
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to update project' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const updateProjectReadme: Handler = async (args, _ctx) => {
-	const { project_id, readme_content } = parseArgs(args, updateProjectReadmeSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.updateProjectReadme(project_id, readme_content);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to update README' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const getProjectSummary: Handler = async (args, _ctx) => {
-	const { project_id } = parseArgs(args, getProjectSummarySchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.getProjectSummary(project_id);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to get project summary' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-/**
- * Project handlers registry
- */
-export const projectHandlers: HandlerRegistry = {
-	get_project_context: getProjectContext,
-	get_git_workflow: getGitWorkflow,
-	create_project: createProject,
-	update_project: updateProject,
-	update_project_readme: updateProjectReadme,
-	get_project_summary: getProjectSummary,
-};
+/**
+ * Project Handlers
+ *
+ * Handles project CRUD and configuration:
+ * - get_project_context
+ * - get_git_workflow
+ * - create_project
+ * - update_project
+ * - update_project_readme
+ */
+
+import type { Handler, HandlerRegistry } from './types.js';
+import {
+	parseArgs,
+	uuidValidator,
+	projectStatusValidator,
+	createEnumValidator,
+	VALID_PROJECT_STATUSES,
+} from '../validators.js';
+import { getApiClient } from '../api-client.js';
+
+const VALID_GIT_WORKFLOWS = ['none', 'trunk-based', 'github-flow', 'git-flow'] as const;
+type GitWorkflow = typeof VALID_GIT_WORKFLOWS[number];
+
+// Argument schemas for type-safe parsing
+const getProjectContextSchema = {
+	project_id: { type: 'string' as const, validate: uuidValidator },
+	git_url: { type: 'string' as const },
+};
+
+const getGitWorkflowSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	task_id: { type: 'string' as const, validate: uuidValidator },
+};
+
+const createProjectSchema = {
+	name: { type: 'string' as const, required: true as const },
+	description: { type: 'string' as const },
+	goal: { type: 'string' as const },
+	git_url: { type: 'string' as const },
+	tech_stack: { type: 'array' as const },
+};
+
+const updateProjectSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	name: { type: 'string' as const },
+	description: { type: 'string' as const },
+	goal: { type: 'string' as const },
+	git_url: { type: 'string' as const },
+	tech_stack: { type: 'array' as const },
+	status: { type: 'string' as const, validate: projectStatusValidator },
+	git_workflow: { type: 'string' as const, validate: createEnumValidator(VALID_GIT_WORKFLOWS) },
+	git_main_branch: { type: 'string' as const },
+	git_develop_branch: { type: 'string' as const },
+	git_auto_branch: { type: 'boolean' as const },
+	git_auto_tag: { type: 'boolean' as const },
+	deployment_instructions: { type: 'string' as const },
+	// New project settings
+	git_delete_branch_on_merge: { type: 'boolean' as const },
+	require_pr_for_validation: { type: 'boolean' as const },
+	auto_merge_on_approval: { type: 'boolean' as const },
+	validation_required: { type: 'boolean' as const },
+	default_task_priority: { type: 'number' as const },
+	require_time_estimates: { type: 'boolean' as const },
+	fallback_activities_enabled: { type: 'boolean' as const },
+	preferred_fallback_activities: { type: 'array' as const },
+	allow_local_agent_task_creation: { type: 'boolean' as const },
+	allow_cloud_agent_task_creation: { type: 'boolean' as const },
+};
+
+const updateProjectReadmeSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	readme_content: { type: 'string' as const, required: true as const },
+};
+
+const getProjectSummarySchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+};
+
+export const getProjectContext: Handler = async (args, _ctx) => {
+	const { project_id, git_url } = parseArgs(args, getProjectContextSchema);
+
+	const apiClient = getApiClient();
+
+	// If no project_id or git_url, list all projects
+	if (!project_id && !git_url) {
+		const response = await apiClient.listProjects();
+
+		if (!response.ok) {
+			return { result: { error: response.error || 'Failed to fetch projects' }, isError: true };
+		}
+
+		return { result: { projects: response.data?.projects || [] } };
+	}
+
+	// Find project by ID or git_url
+	const response = await apiClient.getProject(project_id || 'by-git-url', git_url);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to fetch project' }, isError: true };
+	}
+
+	if (!response.data?.found) {
+		return {
+			result: {
+				found: false,
+				message: response.data?.message || 'Project not found. Use create_project to create one.',
+			},
+		};
+	}
+
+	return { result: response.data };
+};
+
+export const getGitWorkflow: Handler = async (args, _ctx) => {
+	const { project_id, task_id } = parseArgs(args, getGitWorkflowSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.getGitWorkflow(project_id, task_id);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to get git workflow' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const createProject: Handler = async (args, _ctx) => {
+	const { name, description, goal, git_url, tech_stack } = parseArgs(args, createProjectSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.createProject({
+		name,
+		description,
+		goal,
+		git_url,
+		tech_stack: tech_stack as string[] | undefined
+	});
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to create project' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const updateProject: Handler = async (args, _ctx) => {
+	const {
+		project_id,
+		name,
+		description,
+		goal,
+		git_url,
+		tech_stack,
+		status,
+		git_workflow,
+		git_main_branch,
+		git_develop_branch,
+		git_auto_branch,
+		git_auto_tag,
+		deployment_instructions,
+		// New project settings
+		git_delete_branch_on_merge,
+		require_pr_for_validation,
+		auto_merge_on_approval,
+		validation_required,
+		default_task_priority,
+		require_time_estimates,
+		fallback_activities_enabled,
+		preferred_fallback_activities,
+		allow_local_agent_task_creation,
+		allow_cloud_agent_task_creation
+	} = parseArgs(args, updateProjectSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.updateProject(project_id, {
+		name,
+		description,
+		goal,
+		git_url,
+		tech_stack: tech_stack as string[] | undefined,
+		status: status as typeof VALID_PROJECT_STATUSES[number] | undefined,
+		git_workflow: git_workflow as GitWorkflow | undefined,
+		git_main_branch,
+		git_develop_branch,
+		git_auto_branch,
+		git_auto_tag,
+		deployment_instructions,
+		// New project settings
+		git_delete_branch_on_merge,
+		require_pr_for_validation,
+		auto_merge_on_approval,
+		validation_required,
+		default_task_priority,
+		require_time_estimates,
+		fallback_activities_enabled,
+		preferred_fallback_activities: preferred_fallback_activities as string[] | undefined,
+		allow_local_agent_task_creation: allow_local_agent_task_creation as boolean | undefined,
+		allow_cloud_agent_task_creation: allow_cloud_agent_task_creation as boolean | undefined
+	});
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to update project' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const updateProjectReadme: Handler = async (args, _ctx) => {
+	const { project_id, readme_content } = parseArgs(args, updateProjectReadmeSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.updateProjectReadme(project_id, readme_content);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to update README' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const getProjectSummary: Handler = async (args, _ctx) => {
+	const { project_id } = parseArgs(args, getProjectSummarySchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.getProjectSummary(project_id);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to get project summary' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Project handlers registry
+ */
+export const projectHandlers: HandlerRegistry = {
+	get_project_context: getProjectContext,
+	get_git_workflow: getGitWorkflow,
+	create_project: createProject,
+	update_project: updateProject,
+	update_project_readme: updateProjectReadme,
+	get_project_summary: getProjectSummary,
+};