@vibescope/mcp-server 0.2.3 → 0.2.5

package/src/handlers/ideas.ts

@@ -1,175 +1,207 @@
-/**
- * Ideas Handlers
- *
- * Handles feature ideas tracking:
- * - add_idea
- * - update_idea
- * - get_ideas
- * - delete_idea
- * - convert_idea_to_task
- *
- * MIGRATED: Uses Vibescope API client instead of direct Supabase
- */
-
-import type { Handler, HandlerRegistry } from './types.js';
-import {
-	parseArgs,
-	uuidValidator,
-	priorityValidator,
-	minutesValidator,
-	createEnumValidator,
-} from '../validators.js';
-import { getApiClient } from '../api-client.js';
-
-const VALID_IDEA_STATUSES = ['raw', 'exploring', 'planned', 'in_development', 'shipped'] as const;
-type IdeaStatus = typeof VALID_IDEA_STATUSES[number];
-
-// Argument schemas for type-safe parsing
-const addIdeaSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	title: { type: 'string' as const, required: true as const },
-	description: { type: 'string' as const },
-	status: { type: 'string' as const, validate: createEnumValidator(VALID_IDEA_STATUSES) },
-};
-
-const updateIdeaSchema = {
-	idea_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	title: { type: 'string' as const },
-	description: { type: 'string' as const },
-	status: { type: 'string' as const, validate: createEnumValidator(VALID_IDEA_STATUSES) },
-	doc_url: { type: 'string' as const },
-};
-
-const getIdeasSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	status: { type: 'string' as const, validate: createEnumValidator(VALID_IDEA_STATUSES) },
-	limit: { type: 'number' as const, default: 50 },
-	offset: { type: 'number' as const, default: 0 },
-	search_query: { type: 'string' as const },
-};
-
-const deleteIdeaSchema = {
-	idea_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-};
-
-const convertIdeaToTaskSchema = {
-	idea_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	priority: { type: 'number' as const, default: 3, validate: priorityValidator },
-	estimated_minutes: { type: 'number' as const, validate: minutesValidator },
-	update_status: { type: 'boolean' as const, default: true },
-};
-
-export const addIdea: Handler = async (args, ctx) => {
-	const { project_id, title, description, status } = parseArgs(args, addIdeaSchema);
-
-	const { session } = ctx;
-	const apiClient = getApiClient();
-
-	const response = await apiClient.addIdea(project_id, {
-		title,
-		description,
-		status: status as IdeaStatus | undefined
-	}, session.currentSessionId || undefined);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to add idea' }, isError: true };
-	}
-
-	return { result: { success: true, idea_id: response.data?.idea_id, title } };
-};
-
-export const updateIdea: Handler = async (args, _ctx) => {
-	const { idea_id, title, description, status, doc_url } = parseArgs(args, updateIdeaSchema);
-
-	const apiClient = getApiClient();
-
-	const response = await apiClient.updateIdea(idea_id, {
-		title,
-		description,
-		status: status as IdeaStatus | undefined,
-		doc_url
-	});
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to update idea' }, isError: true };
-	}
-
-	return { result: { success: true, idea_id } };
-};
-
-export const getIdeas: Handler = async (args, _ctx) => {
-	const { project_id, status, limit, offset, search_query } = parseArgs(args, getIdeasSchema);
-
-	const apiClient = getApiClient();
-
-	const response = await apiClient.getIdeas(project_id, {
-		status: status as IdeaStatus | undefined,
-		limit,
-		offset,
-		search_query
-	});
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to fetch ideas' }, isError: true };
-	}
-
-	return {
-		result: {
-			ideas: response.data?.ideas || [],
-		},
-	};
-};
-
-export const deleteIdea: Handler = async (args, _ctx) => {
-	const { idea_id } = parseArgs(args, deleteIdeaSchema);
-
-	const apiClient = getApiClient();
-
-	const response = await apiClient.deleteIdea(idea_id);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to delete idea' }, isError: true };
-	}
-
-	return { result: { success: true } };
-};
-
-export const convertIdeaToTask: Handler = async (args, _ctx) => {
-	const { idea_id, priority, estimated_minutes, update_status } = parseArgs(args, convertIdeaToTaskSchema);
-
-	const apiClient = getApiClient();
-
-	// Use proxy for convert_idea_to_task operation
-	const response = await apiClient.proxy<{
-		success: boolean;
-		task_id?: string;
-		task_title?: string;
-		idea_id?: string;
-		idea_status?: string;
-		message?: string;
-		error?: string;
-		existing_task_id?: string;
-	}>('convert_idea_to_task', {
-		idea_id,
-		priority,
-		estimated_minutes,
-		update_status
-	});
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to convert idea' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-/**
- * Ideas handlers registry
- */
-export const ideaHandlers: HandlerRegistry = {
-	add_idea: addIdea,
-	update_idea: updateIdea,
-	get_ideas: getIdeas,
-	delete_idea: deleteIdea,
-	convert_idea_to_task: convertIdeaToTask,
-};
+/**
+ * Ideas Handlers
+ *
+ * Handles feature ideas tracking:
+ * - add_idea
+ * - update_idea
+ * - get_ideas
+ * - delete_idea
+ * - convert_idea_to_task
+ *
+ * MIGRATED: Uses Vibescope API client instead of direct Supabase
+ */
+
+import type { Handler, HandlerRegistry } from './types.js';
+import {
+	parseArgs,
+	uuidValidator,
+	priorityValidator,
+	minutesValidator,
+	createEnumValidator,
+} from '../validators.js';
+import { getApiClient } from '../api-client.js';
+
+const VALID_IDEA_STATUSES = ['raw', 'exploring', 'planned', 'in_development', 'shipped'] as const;
+type IdeaStatus = typeof VALID_IDEA_STATUSES[number];
+
+// Argument schemas for type-safe parsing
+const addIdeaSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	title: { type: 'string' as const, required: true as const },
+	description: { type: 'string' as const },
+	status: { type: 'string' as const, validate: createEnumValidator(VALID_IDEA_STATUSES) },
+};
+
+const updateIdeaSchema = {
+	idea_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	title: { type: 'string' as const },
+	description: { type: 'string' as const },
+	status: { type: 'string' as const, validate: createEnumValidator(VALID_IDEA_STATUSES) },
+	doc_url: { type: 'string' as const },
+};
+
+const getIdeaSchema = {
+	idea_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+};
+
+const getIdeasSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	status: { type: 'string' as const, validate: createEnumValidator(VALID_IDEA_STATUSES) },
+	limit: { type: 'number' as const, default: 10 },
+	offset: { type: 'number' as const, default: 0 },
+	search_query: { type: 'string' as const },
+};
+
+const deleteIdeaSchema = {
+	idea_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+};
+
+const convertIdeaToTaskSchema = {
+	idea_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	priority: { type: 'number' as const, default: 3, validate: priorityValidator },
+	estimated_minutes: { type: 'number' as const, validate: minutesValidator },
+	update_status: { type: 'boolean' as const, default: true },
+};
+
+export const addIdea: Handler = async (args, ctx) => {
+	const { project_id, title, description, status } = parseArgs(args, addIdeaSchema);
+
+	const { session } = ctx;
+	const apiClient = getApiClient();
+
+	const response = await apiClient.addIdea(project_id, {
+		title,
+		description,
+		status: status as IdeaStatus | undefined
+	}, session.currentSessionId || undefined);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to add idea' }, isError: true };
+	}
+
+	return { result: { success: true, idea_id: response.data?.idea_id, title } };
+};
+
+export const updateIdea: Handler = async (args, _ctx) => {
+	const { idea_id, title, description, status, doc_url } = parseArgs(args, updateIdeaSchema);
+
+	const apiClient = getApiClient();
+
+	const response = await apiClient.updateIdea(idea_id, {
+		title,
+		description,
+		status: status as IdeaStatus | undefined,
+		doc_url
+	});
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to update idea' }, isError: true };
+	}
+
+	return { result: { success: true, idea_id } };
+};
+
+/**
+ * Get a single idea by ID.
+ * More token-efficient than get_ideas when you need details for a specific idea.
+ */
+export const getIdea: Handler = async (args, _ctx) => {
+	const { idea_id } = parseArgs(args, getIdeaSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.proxy<{
+		idea: {
+			id: string;
+			title: string;
+			description?: string;
+			status: string;
+			doc_url?: string;
+			created_at: string;
+			updated_at: string;
+		};
+	}>('get_idea', { idea_id });
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to get idea' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const getIdeas: Handler = async (args, _ctx) => {
+	const { project_id, status, limit, offset, search_query } = parseArgs(args, getIdeasSchema);
+
+	const apiClient = getApiClient();
+
+	const response = await apiClient.getIdeas(project_id, {
+		status: status as IdeaStatus | undefined,
+		limit: Math.min(limit ?? 10, 100),
+		offset,
+		search_query
+	});
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to fetch ideas' }, isError: true };
+	}
+
+	return {
+		result: {
+			ideas: response.data?.ideas || [],
+		},
+	};
+};
+
+export const deleteIdea: Handler = async (args, _ctx) => {
+	const { idea_id } = parseArgs(args, deleteIdeaSchema);
+
+	const apiClient = getApiClient();
+
+	const response = await apiClient.deleteIdea(idea_id);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to delete idea' }, isError: true };
+	}
+
+	return { result: { success: true } };
+};
+
+export const convertIdeaToTask: Handler = async (args, _ctx) => {
+	const { idea_id, priority, estimated_minutes, update_status } = parseArgs(args, convertIdeaToTaskSchema);
+
+	const apiClient = getApiClient();
+
+	// Use proxy for convert_idea_to_task operation
+	const response = await apiClient.proxy<{
+		success: boolean;
+		task_id?: string;
+		task_title?: string;
+		idea_id?: string;
+		idea_status?: string;
+		message?: string;
+		error?: string;
+		existing_task_id?: string;
+	}>('convert_idea_to_task', {
+		idea_id,
+		priority,
+		estimated_minutes,
+		update_status
+	});
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to convert idea' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Ideas handlers registry
+ */
+export const ideaHandlers: HandlerRegistry = {
+	add_idea: addIdea,
+	update_idea: updateIdea,
+	get_idea: getIdea,
+	get_ideas: getIdeas,
+	delete_idea: deleteIdea,
+	convert_idea_to_task: convertIdeaToTask,
+};

package/src/handlers/index.ts

@@ -1,84 +1,84 @@
-/**
- * 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';
-export * from './git-issues.js';
-export * from './sprints.js';
-export * from './file-checkouts.js';
-export * from './roles.js';
-export * from './connectors.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';
-import { gitIssueHandlers } from './git-issues.js';
-import { sprintHandlers } from './sprints.js';
-import { fileCheckoutHandlers } from './file-checkouts.js';
-import { roleHandlers } from './roles.js';
-import { connectorHandlers } from './connectors.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,
-		...gitIssueHandlers,
-		...sprintHandlers,
-		...fileCheckoutHandlers,
-		...roleHandlers,
-		...connectorHandlers,
-	};
-}
+/**
+ * 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';
+export * from './git-issues.js';
+export * from './sprints.js';
+export * from './file-checkouts.js';
+export * from './roles.js';
+export * from './connectors.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';
+import { gitIssueHandlers } from './git-issues.js';
+import { sprintHandlers } from './sprints.js';
+import { fileCheckoutHandlers } from './file-checkouts.js';
+import { roleHandlers } from './roles.js';
+import { connectorHandlers } from './connectors.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,
+		...gitIssueHandlers,
+		...sprintHandlers,
+		...fileCheckoutHandlers,
+		...roleHandlers,
+		...connectorHandlers,
+	};
+}