@vibescope/mcp-server 0.0.1

package/src/handlers/ideas.ts

@@ -0,0 +1,247 @@
+/**
+ * Ideas Handlers
+ *
+ * Handles feature ideas tracking:
+ * - add_idea
+ * - update_idea
+ * - get_ideas
+ * - delete_idea
+ */
+
+import type { Handler, HandlerRegistry } from './types.js';
+import { validateRequired, validateUUID, validatePriority, validateEstimatedMinutes } from '../validators.js';
+
+type IdeaStatus = 'raw' | 'exploring' | 'planned' | 'in_development' | 'shipped';
+
+export const addIdea: Handler = async (args, ctx) => {
+	const { project_id, title, description, status } = args as {
+		project_id: string;
+		title: string;
+		description?: string;
+		status?: IdeaStatus;
+	};
+
+	validateRequired(project_id, 'project_id');
+	validateUUID(project_id, 'project_id');
+	validateRequired(title, 'title');
+
+	const { supabase, session } = ctx;
+
+	const { data, error } = await supabase
+		.from('ideas')
+		.insert({
+			project_id,
+			title,
+			description: description || null,
+			status: status || 'raw',
+			created_by: 'agent',
+			created_by_session_id: session.currentSessionId,
+		})
+		.select('id')
+		.single();
+
+	if (error) throw new Error(`Failed to add idea: ${error.message}`);
+
+	return { result: { success: true, idea_id: data.id, title } };
+};
+
+export const updateIdea: Handler = async (args, ctx) => {
+	const { idea_id, title, description, status, doc_url } = args as {
+		idea_id: string;
+		title?: string;
+		description?: string;
+		status?: IdeaStatus;
+		doc_url?: string;
+	};
+
+	validateRequired(idea_id, 'idea_id');
+	validateUUID(idea_id, 'idea_id');
+
+	const { supabase } = ctx;
+
+	// Get current idea status
+	const { data: existingIdea } = await supabase
+		.from('ideas')
+		.select('status')
+		.eq('id', idea_id)
+		.single();
+
+	if (!existingIdea) {
+		throw new Error(`Idea not found: ${idea_id}`);
+	}
+
+	// Build update object
+	const updates: Record<string, unknown> = { updated_at: new Date().toISOString() };
+	if (title !== undefined) updates.title = title;
+	if (description !== undefined) updates.description = description;
+	if (doc_url !== undefined) updates.doc_url = doc_url;
+	if (status !== undefined) {
+		updates.status = status;
+		// Set planned_at when transitioning to planned status
+		if (status === 'planned' && existingIdea.status !== 'planned') {
+			updates.planned_at = new Date().toISOString();
+		}
+	}
+
+	const { error } = await supabase
+		.from('ideas')
+		.update(updates)
+		.eq('id', idea_id);
+
+	if (error) throw new Error(`Failed to update idea: ${error.message}`);
+
+	return { result: { success: true, idea_id } };
+};
+
+export const getIdeas: Handler = async (args, ctx) => {
+	const { project_id, status } = args as {
+		project_id: string;
+		status?: IdeaStatus;
+	};
+
+	validateRequired(project_id, 'project_id');
+	validateUUID(project_id, 'project_id');
+
+	const { supabase } = ctx;
+
+	let query = supabase
+		.from('ideas')
+		.select('id, title, description, status, doc_url')
+		.eq('project_id', project_id);
+
+	if (status) {
+		query = query.eq('status', status);
+	}
+
+	const { data, error } = await query.order('created_at', { ascending: false });
+
+	if (error) throw new Error(`Failed to fetch ideas: ${error.message}`);
+
+	return { result: { ideas: data || [] } };
+};
+
+export const deleteIdea: Handler = async (args, ctx) => {
+	const { idea_id } = args as { idea_id: string };
+
+	validateRequired(idea_id, 'idea_id');
+	validateUUID(idea_id, 'idea_id');
+
+	const { error } = await ctx.supabase
+		.from('ideas')
+		.delete()
+		.eq('id', idea_id);
+
+	if (error) throw new Error(`Failed to delete idea: ${error.message}`);
+
+	return { result: { success: true } };
+};
+
+export const convertIdeaToTask: Handler = async (args, ctx) => {
+	const { idea_id, priority = 3, estimated_minutes, update_status = true } = args as {
+		idea_id: string;
+		priority?: number;
+		estimated_minutes?: number;
+		update_status?: boolean;
+	};
+
+	validateRequired(idea_id, 'idea_id');
+	validateUUID(idea_id, 'idea_id');
+	validatePriority(priority);
+	validateEstimatedMinutes(estimated_minutes);
+
+	const { supabase, session } = ctx;
+	const currentSessionId = session.currentSessionId;
+
+	// Get the idea
+	const { data: idea, error: fetchError } = await supabase
+		.from('ideas')
+		.select('id, project_id, title, description, status, converted_to_task_id')
+		.eq('id', idea_id)
+		.single();
+
+	if (fetchError || !idea) {
+		throw new Error(`Idea not found: ${idea_id}`);
+	}
+
+	// Check if already converted
+	if (idea.converted_to_task_id) {
+		return {
+			result: {
+				success: false,
+				error: 'Idea has already been converted to a task',
+				existing_task_id: idea.converted_to_task_id,
+				hint: 'Use get_tasks to find the existing task',
+			},
+		};
+	}
+
+	// Create the task
+	const { data: task, error: taskError } = await supabase
+		.from('tasks')
+		.insert({
+			project_id: idea.project_id,
+			title: idea.title,
+			description: idea.description || `Converted from idea: ${idea.title}`,
+			priority,
+			estimated_minutes: estimated_minutes || null,
+			created_by: 'agent',
+			created_by_session_id: currentSessionId,
+		})
+		.select('id, title')
+		.single();
+
+	if (taskError || !task) {
+		throw new Error(`Failed to create task: ${taskError?.message}`);
+	}
+
+	// Update the idea with the task reference and optionally update status
+	const ideaUpdates: Record<string, unknown> = {
+		converted_to_task_id: task.id,
+		updated_at: new Date().toISOString(),
+	};
+
+	if (update_status && idea.status !== 'shipped') {
+		ideaUpdates.status = 'in_development';
+	}
+
+	const { error: updateError } = await supabase
+		.from('ideas')
+		.update(ideaUpdates)
+		.eq('id', idea_id);
+
+	if (updateError) {
+		// Log but don't fail - task was created successfully
+		console.error(`Failed to update idea after conversion: ${updateError.message}`);
+	}
+
+	// Log progress
+	await supabase.from('progress_logs').insert({
+		project_id: idea.project_id,
+		task_id: task.id,
+		summary: `Converted idea "${idea.title}" to task`,
+		created_by: 'agent',
+		created_by_session_id: currentSessionId,
+	});
+
+	return {
+		result: {
+			success: true,
+			task_id: task.id,
+			task_title: task.title,
+			idea_id: idea.id,
+			idea_status: update_status ? 'in_development' : idea.status,
+			message: `Created task from idea. Start with: update_task(task_id: "${task.id}", status: "in_progress")`,
+		},
+	};
+};
+
+/**
+ * Ideas handlers registry
+ */
+export const ideaHandlers: HandlerRegistry = {
+	add_idea: addIdea,
+	update_idea: updateIdea,
+	get_ideas: getIdeas,
+	delete_idea: deleteIdea,
+	convert_idea_to_task: convertIdeaToTask,
+};

package/src/handlers/index.ts

@@ -0,0 +1,69 @@
+/**
+ * MCP Server Handlers
+ *
+ * This module exports all tool handlers organized by category.
+ * Each handler receives a HandlerContext and returns a HandlerResult.
+ */
+
+export * from './types.js';
+export * from './milestones.js';
+export * from './session.js';
+export * from './ideas.js';
+export * from './findings.js';
+export * from './blockers.js';
+export * from './decisions.js';
+export * from './progress.js';
+export * from './requests.js';
+export * from './tasks.js';
+export * from './project.js';
+export * from './deployment.js';
+export * from './validation.js';
+export * from './fallback.js';
+export * from './bodies-of-work.js';
+export * from './discovery.js';
+export * from './organizations.js';
+export * from './cost.js';
+
+import type { HandlerRegistry } from './types.js';
+import { milestoneHandlers } from './milestones.js';
+import { sessionHandlers } from './session.js';
+import { ideaHandlers } from './ideas.js';
+import { findingHandlers } from './findings.js';
+import { blockerHandlers } from './blockers.js';
+import { decisionHandlers } from './decisions.js';
+import { progressHandlers } from './progress.js';
+import { requestHandlers } from './requests.js';
+import { taskHandlers } from './tasks.js';
+import { projectHandlers } from './project.js';
+import { deploymentHandlers } from './deployment.js';
+import { validationHandlers } from './validation.js';
+import { fallbackHandlers } from './fallback.js';
+import { bodiesOfWorkHandlers } from './bodies-of-work.js';
+import { discoveryHandlers } from './discovery.js';
+import { organizationHandlers } from './organizations.js';
+import { costHandlers } from './cost.js';
+
+/**
+ * Build the complete handler registry from all modules
+ */
+export function buildHandlerRegistry(): HandlerRegistry {
+	return {
+		...milestoneHandlers,
+		...sessionHandlers,
+		...ideaHandlers,
+		...findingHandlers,
+		...blockerHandlers,
+		...decisionHandlers,
+		...progressHandlers,
+		...requestHandlers,
+		...taskHandlers,
+		...projectHandlers,
+		...deploymentHandlers,
+		...validationHandlers,
+		...fallbackHandlers,
+		...bodiesOfWorkHandlers,
+		...discoveryHandlers,
+		...organizationHandlers,
+		...costHandlers,
+	};
+}