@vibescope/mcp-server 0.0.1

package/src/handlers/milestones.ts

@@ -0,0 +1,217 @@
+/**
+ * Milestone Handlers
+ *
+ * Handles task milestone CRUD operations:
+ * - add_milestone
+ * - update_milestone
+ * - complete_milestone
+ * - delete_milestone
+ * - get_milestones
+ */
+
+import type { Handler, HandlerRegistry } from './types.js';
+import { ValidationError, validateRequired, validateUUID } from '../validators.js';
+
+export const addMilestone: Handler = async (args, ctx) => {
+	const { task_id, title, description, order_index } = args as {
+		task_id: string;
+		title: string;
+		description?: string;
+		order_index?: number;
+	};
+
+	validateRequired(task_id, 'task_id');
+	validateUUID(task_id, 'task_id');
+	validateRequired(title, 'title');
+
+	const { supabase, session } = ctx;
+
+	// Verify task exists
+	const { data: task, error: taskError } = await supabase
+		.from('tasks')
+		.select('id, project_id')
+		.eq('id', task_id)
+		.single();
+
+	if (taskError || !task) {
+		throw new Error('Task not found');
+	}
+
+	// Get the next order_index if not provided
+	let orderIdx = order_index;
+	if (orderIdx === undefined) {
+		const { data: maxOrder } = await supabase
+			.from('task_milestones')
+			.select('order_index')
+			.eq('task_id', task_id)
+			.order('order_index', { ascending: false })
+			.limit(1)
+			.single();
+
+		orderIdx = maxOrder ? maxOrder.order_index + 1 : 0;
+	}
+
+	const { data: milestone, error } = await supabase
+		.from('task_milestones')
+		.insert({
+			task_id,
+			title,
+			description: description || null,
+			order_index: orderIdx,
+			created_by: 'agent',
+			created_by_session_id: session.currentSessionId,
+		})
+		.select()
+		.single();
+
+	if (error) throw error;
+
+	return {
+		result: {
+			success: true,
+			milestone,
+		},
+	};
+};
+
+export const updateMilestone: Handler = async (args, ctx) => {
+	const { milestone_id, title, description, status, order_index } = args as {
+		milestone_id: string;
+		title?: string;
+		description?: string;
+		status?: string;
+		order_index?: number;
+	};
+
+	validateRequired(milestone_id, 'milestone_id');
+	validateUUID(milestone_id, 'milestone_id');
+
+	const updates: Record<string, unknown> = {};
+	if (title !== undefined) updates.title = title;
+	if (description !== undefined) updates.description = description;
+	if (order_index !== undefined) updates.order_index = order_index;
+	if (status !== undefined) {
+		if (!['pending', 'in_progress', 'completed'].includes(status)) {
+			throw new ValidationError('status must be pending, in_progress, or completed');
+		}
+		updates.status = status;
+		if (status === 'completed') {
+			updates.completed_at = new Date().toISOString();
+		} else {
+			updates.completed_at = null;
+		}
+	}
+
+	if (Object.keys(updates).length === 0) {
+		throw new ValidationError('At least one field to update is required');
+	}
+
+	const { data: milestone, error } = await ctx.supabase
+		.from('task_milestones')
+		.update(updates)
+		.eq('id', milestone_id)
+		.select()
+		.single();
+
+	if (error) throw error;
+
+	return {
+		result: {
+			success: true,
+			milestone,
+		},
+	};
+};
+
+export const completeMilestone: Handler = async (args, ctx) => {
+	const { milestone_id } = args as { milestone_id: string };
+
+	validateRequired(milestone_id, 'milestone_id');
+	validateUUID(milestone_id, 'milestone_id');
+
+	const { data: milestone, error } = await ctx.supabase
+		.from('task_milestones')
+		.update({
+			status: 'completed',
+			completed_at: new Date().toISOString(),
+		})
+		.eq('id', milestone_id)
+		.select()
+		.single();
+
+	if (error) throw error;
+
+	return {
+		result: {
+			success: true,
+			milestone,
+		},
+	};
+};
+
+export const deleteMilestone: Handler = async (args, ctx) => {
+	const { milestone_id } = args as { milestone_id: string };
+
+	validateRequired(milestone_id, 'milestone_id');
+	validateUUID(milestone_id, 'milestone_id');
+
+	const { error } = await ctx.supabase
+		.from('task_milestones')
+		.delete()
+		.eq('id', milestone_id);
+
+	if (error) throw error;
+
+	return {
+		result: {
+			success: true,
+			message: 'Milestone deleted',
+		},
+	};
+};
+
+export const getMilestones: Handler = async (args, ctx) => {
+	const { task_id } = args as { task_id: string };
+
+	validateRequired(task_id, 'task_id');
+	validateUUID(task_id, 'task_id');
+
+	const { data: milestones, error } = await ctx.supabase
+		.from('task_milestones')
+		.select('*')
+		.eq('task_id', task_id)
+		.order('order_index', { ascending: true });
+
+	if (error) throw error;
+
+	// Calculate progress stats
+	const total = milestones?.length || 0;
+	const completed = milestones?.filter(m => m.status === 'completed').length || 0;
+	const in_progress = milestones?.filter(m => m.status === 'in_progress').length || 0;
+	const pending = total - completed - in_progress;
+	const progress_percentage = total > 0 ? Math.round((completed / total) * 100) : 0;
+
+	return {
+		result: {
+			milestones: milestones || [],
+			stats: {
+				total,
+				completed,
+				in_progress,
+				pending,
+				progress_percentage,
+			},
+		},
+	};
+};
+
+/**
+ * Milestone handlers registry
+ */
+export const milestoneHandlers: HandlerRegistry = {
+	add_milestone: addMilestone,
+	update_milestone: updateMilestone,
+	complete_milestone: completeMilestone,
+	delete_milestone: deleteMilestone,
+	get_milestones: getMilestones,
+};