@vibescope/mcp-server 0.0.1 → 0.2.0

package/dist/handlers/sprints.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Sprint Handlers
+ *
+ * Handles sprint-specific operations, leveraging bodies of work infrastructure:
+ * - create_sprint
+ * - update_sprint
+ * - get_sprint
+ * - get_sprints
+ * - delete_sprint
+ * - start_sprint
+ * - complete_sprint
+ * - add_task_to_sprint
+ * - remove_task_from_sprint
+ * - get_sprint_backlog
+ * - get_sprint_velocity
+ */
+import type { Handler, HandlerRegistry } from './types.js';
+export declare const createSprint: Handler;
+export declare const updateSprint: Handler;
+export declare const getSprint: Handler;
+export declare const getSprints: Handler;
+export declare const deleteSprint: Handler;
+export declare const startSprint: Handler;
+export declare const completeSprint: Handler;
+export declare const addTaskToSprint: Handler;
+export declare const removeTaskFromSprint: Handler;
+export declare const getSprintBacklog: Handler;
+export declare const getSprintVelocity: Handler;
+/**
+ * Sprint handlers registry
+ */
+export declare const sprintHandlers: HandlerRegistry;

package/dist/handlers/sprints.js

@@ -0,0 +1,275 @@
+/**
+ * Sprint Handlers
+ *
+ * Handles sprint-specific operations, leveraging bodies of work infrastructure:
+ * - create_sprint
+ * - update_sprint
+ * - get_sprint
+ * - get_sprints
+ * - delete_sprint
+ * - start_sprint
+ * - complete_sprint
+ * - add_task_to_sprint
+ * - remove_task_from_sprint
+ * - get_sprint_backlog
+ * - get_sprint_velocity
+ */
+import { validateRequired, validateUUID, validateEnum } from '../validators.js';
+import { getApiClient } from '../api-client.js';
+const SPRINT_STATUSES = ['planning', 'active', 'in_review', 'retrospective', 'completed', 'cancelled'];
+const TASK_PHASES = ['pre', 'core', 'post'];
+const DEPLOY_ENVIRONMENTS = ['development', 'staging', 'production'];
+const VERSION_BUMPS = ['patch', 'minor', 'major'];
+export const createSprint = async (args, ctx) => {
+    const { project_id, title, goal, start_date, end_date, auto_deploy_on_completion, deploy_environment, deploy_version_bump, } = args;
+    validateRequired(project_id, 'project_id');
+    validateUUID(project_id, 'project_id');
+    validateRequired(title, 'title');
+    validateRequired(start_date, 'start_date');
+    validateRequired(end_date, 'end_date');
+    if (deploy_environment) {
+        validateEnum(deploy_environment, DEPLOY_ENVIRONMENTS, 'deploy_environment');
+    }
+    if (deploy_version_bump) {
+        validateEnum(deploy_version_bump, VERSION_BUMPS, 'deploy_version_bump');
+    }
+    // Validate date format and order
+    const startDateObj = new Date(start_date);
+    const endDateObj = new Date(end_date);
+    if (isNaN(startDateObj.getTime())) {
+        throw new Error('Invalid start_date format. Use YYYY-MM-DD');
+    }
+    if (isNaN(endDateObj.getTime())) {
+        throw new Error('Invalid end_date format. Use YYYY-MM-DD');
+    }
+    if (endDateObj < startDateObj) {
+        throw new Error('end_date must be on or after start_date');
+    }
+    const { session } = ctx;
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('create_sprint', {
+        project_id,
+        title,
+        goal,
+        start_date,
+        end_date,
+        auto_deploy_on_completion,
+        deploy_environment,
+        deploy_version_bump,
+    }, {
+        session_id: session.currentSessionId,
+        persona: session.currentPersona,
+        instance_id: session.instanceId
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to create sprint: ${response.error}`);
+    }
+    return {
+        result: {
+            success: true,
+            sprint_id: response.data?.sprint_id,
+            sprint_number: response.data?.sprint_number,
+            title,
+            status: 'planning',
+            start_date,
+            end_date,
+            message: 'Sprint created in planning status. Add tasks with add_task_to_sprint, then call start_sprint when ready.',
+        },
+    };
+};
+export const updateSprint = async (args, ctx) => {
+    const { sprint_id, title, goal, start_date, end_date, auto_deploy_on_completion, deploy_environment, deploy_version_bump, } = args;
+    validateRequired(sprint_id, 'sprint_id');
+    validateUUID(sprint_id, 'sprint_id');
+    if (deploy_environment) {
+        validateEnum(deploy_environment, DEPLOY_ENVIRONMENTS, 'deploy_environment');
+    }
+    if (deploy_version_bump) {
+        validateEnum(deploy_version_bump, VERSION_BUMPS, 'deploy_version_bump');
+    }
+    // Validate dates if provided
+    if (start_date) {
+        const startDateObj = new Date(start_date);
+        if (isNaN(startDateObj.getTime())) {
+            throw new Error('Invalid start_date format. Use YYYY-MM-DD');
+        }
+    }
+    if (end_date) {
+        const endDateObj = new Date(end_date);
+        if (isNaN(endDateObj.getTime())) {
+            throw new Error('Invalid end_date format. Use YYYY-MM-DD');
+        }
+    }
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('update_sprint', {
+        sprint_id,
+        title,
+        goal,
+        start_date,
+        end_date,
+        auto_deploy_on_completion,
+        deploy_environment,
+        deploy_version_bump,
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to update sprint: ${response.error}`);
+    }
+    return { result: { success: true, sprint_id } };
+};
+export const getSprint = async (args, ctx) => {
+    const { sprint_id, summary_only = false } = args;
+    validateRequired(sprint_id, 'sprint_id');
+    validateUUID(sprint_id, 'sprint_id');
+    const apiClient = getApiClient();
+    // Response type varies based on summary_only
+    const response = await apiClient.proxy('get_sprint', { sprint_id, summary_only });
+    if (!response.ok) {
+        throw new Error(`Failed to get sprint: ${response.error}`);
+    }
+    return { result: response.data };
+};
+export const getSprints = async (args, ctx) => {
+    const { project_id, status, limit = 20, offset = 0 } = args;
+    validateRequired(project_id, 'project_id');
+    validateUUID(project_id, 'project_id');
+    if (status) {
+        validateEnum(status, SPRINT_STATUSES, 'status');
+    }
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('get_sprints', {
+        project_id,
+        status,
+        limit: Math.min(limit, 100),
+        offset,
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch sprints: ${response.error}`);
+    }
+    return { result: response.data };
+};
+export const deleteSprint = async (args, ctx) => {
+    const { sprint_id } = args;
+    validateRequired(sprint_id, 'sprint_id');
+    validateUUID(sprint_id, 'sprint_id');
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('delete_sprint', {
+        sprint_id
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to delete sprint: ${response.error}`);
+    }
+    return { result: { success: true, message: 'Sprint deleted. Tasks are preserved.' } };
+};
+export const startSprint = async (args, ctx) => {
+    const { sprint_id } = args;
+    validateRequired(sprint_id, 'sprint_id');
+    validateUUID(sprint_id, 'sprint_id');
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('start_sprint', { sprint_id });
+    if (!response.ok) {
+        throw new Error(`Failed to start sprint: ${response.error}`);
+    }
+    return { result: response.data };
+};
+export const completeSprint = async (args, ctx) => {
+    const { sprint_id, retrospective_notes, skip_retrospective } = args;
+    validateRequired(sprint_id, 'sprint_id');
+    validateUUID(sprint_id, 'sprint_id');
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('complete_sprint', {
+        sprint_id,
+        retrospective_notes,
+        skip_retrospective,
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to complete sprint: ${response.error}`);
+    }
+    return { result: response.data };
+};
+export const addTaskToSprint = async (args, ctx) => {
+    const { sprint_id, task_id, story_points, phase } = args;
+    validateRequired(sprint_id, 'sprint_id');
+    validateUUID(sprint_id, 'sprint_id');
+    validateRequired(task_id, 'task_id');
+    validateUUID(task_id, 'task_id');
+    if (phase) {
+        validateEnum(phase, TASK_PHASES, 'phase');
+    }
+    if (story_points !== undefined && (story_points < 0 || !Number.isInteger(story_points))) {
+        throw new Error('story_points must be a non-negative integer');
+    }
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('add_task_to_sprint', {
+        sprint_id,
+        task_id,
+        story_points,
+        phase: phase || 'core',
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to add task to sprint: ${response.error}`);
+    }
+    return { result: response.data };
+};
+export const removeTaskFromSprint = async (args, ctx) => {
+    const { sprint_id, task_id } = args;
+    validateRequired(sprint_id, 'sprint_id');
+    validateUUID(sprint_id, 'sprint_id');
+    validateRequired(task_id, 'task_id');
+    validateUUID(task_id, 'task_id');
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('remove_task_from_sprint', {
+        sprint_id,
+        task_id,
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to remove task from sprint: ${response.error}`);
+    }
+    return { result: response.data };
+};
+export const getSprintBacklog = async (args, ctx) => {
+    const { project_id, sprint_id } = args;
+    validateRequired(project_id, 'project_id');
+    validateUUID(project_id, 'project_id');
+    if (sprint_id) {
+        validateUUID(sprint_id, 'sprint_id');
+    }
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('get_sprint_backlog', {
+        project_id,
+        sprint_id,
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get sprint backlog: ${response.error}`);
+    }
+    return { result: response.data };
+};
+export const getSprintVelocity = async (args, ctx) => {
+    const { project_id, limit = 10 } = args;
+    validateRequired(project_id, 'project_id');
+    validateUUID(project_id, 'project_id');
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('get_sprint_velocity', {
+        project_id,
+        limit: Math.min(limit, 50),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get sprint velocity: ${response.error}`);
+    }
+    return { result: response.data };
+};
+/**
+ * Sprint handlers registry
+ */
+export const sprintHandlers = {
+    create_sprint: createSprint,
+    update_sprint: updateSprint,
+    get_sprint: getSprint,
+    get_sprints: getSprints,
+    delete_sprint: deleteSprint,
+    start_sprint: startSprint,
+    complete_sprint: completeSprint,
+    add_task_to_sprint: addTaskToSprint,
+    remove_task_from_sprint: removeTaskFromSprint,
+    get_sprint_backlog: getSprintBacklog,
+    get_sprint_velocity: getSprintVelocity,
+};

package/dist/handlers/tasks.d.ts

@@ -1,5 +1,5 @@
 /**
- * Task Handlers
+ * Task Handlers (Migrated to API Client)
  *
  * Handles task CRUD and management:
  * - get_tasks
@@ -12,16 +12,14 @@
  * - remove_task_reference
  * - batch_update_tasks
  * - batch_complete_tasks
+ * - add_subtask
+ * - get_subtasks
  */
 import type { Handler, HandlerRegistry } from './types.js';
-import type { SupabaseClient } from '@supabase/supabase-js';
-/**
- * Git workflow instructions generator
- */
 interface GitWorkflowConfig {
     git_workflow: string;
     git_main_branch: string;
-    git_develop_branch?: string;
+    git_develop_branch?: string | null;
     git_auto_branch?: boolean;
 }
 interface GitMergeInstructions {
@@ -31,9 +29,7 @@ interface GitMergeInstructions {
     cleanup: string[];
     note: string;
 }
-declare function getValidationApprovedGitInstructions(config: GitWorkflowConfig, taskBranch: string | undefined): GitMergeInstructions | undefined;
-export declare function getProjectGitConfig(supabase: SupabaseClient, projectId: string): Promise<GitWorkflowConfig | null>;
-export { getValidationApprovedGitInstructions };
+export declare function getValidationApprovedGitInstructions(config: GitWorkflowConfig, taskBranch: string | undefined): GitMergeInstructions | undefined;
 export declare const getTasks: Handler;
 export declare const getNextTask: Handler;
 export declare const addTask: Handler;
@@ -43,10 +39,11 @@ export declare const deleteTask: Handler;
 export declare const addTaskReference: Handler;
 export declare const removeTaskReference: Handler;
 export declare const batchUpdateTasks: Handler;
+export declare const batchCompleteTasks: Handler;
 export declare const addSubtask: Handler;
 export declare const getSubtasks: Handler;
-export declare const batchCompleteTasks: Handler;
 /**
  * Task handlers registry
  */
 export declare const taskHandlers: HandlerRegistry;
+export {};