@vibescope/mcp-server 0.2.0 → 0.2.1

package/src/tools.ts

@@ -2528,5 +2528,392 @@ Only returns tasks where all dependencies are completed.`,
 			required: ['project_id'],
 		},
 	},
+	// ============================================================================
+	// Sprint Tools
+	// ============================================================================
+	{
+		name: 'create_sprint',
+		description: `Create a new sprint. Sprints are time-bounded bodies of work with velocity tracking.
+Sprints start in 'planning' status where tasks can be added with story points.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				title: {
+					type: 'string',
+					description: 'Sprint title (e.g., "Sprint 5" or "Q1 Release")',
+				},
+				goal: {
+					type: 'string',
+					description: 'Sprint goal statement',
+				},
+				start_date: {
+					type: 'string',
+					description: 'Start date (YYYY-MM-DD)',
+				},
+				end_date: {
+					type: 'string',
+					description: 'End date (YYYY-MM-DD)',
+				},
+				auto_deploy_on_completion: {
+					type: 'boolean',
+					description: 'Automatically request deployment when sprint completes (default: false)',
+				},
+				deploy_environment: {
+					type: 'string',
+					enum: ['development', 'staging', 'production'],
+					description: 'Target environment for auto-deploy (default: production)',
+				},
+				deploy_version_bump: {
+					type: 'string',
+					enum: ['patch', 'minor', 'major'],
+					description: 'Version bump for auto-deploy (default: minor)',
+				},
+			},
+			required: ['project_id', 'title', 'start_date', 'end_date'],
+		},
+	},
+	{
+		name: 'update_sprint',
+		description: `Update a sprint's details. Can update title, goal, dates, and deployment settings.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				sprint_id: {
+					type: 'string',
+					description: 'Sprint UUID',
+				},
+				title: {
+					type: 'string',
+					description: 'New sprint title',
+				},
+				goal: {
+					type: 'string',
+					description: 'New sprint goal',
+				},
+				start_date: {
+					type: 'string',
+					description: 'New start date (YYYY-MM-DD)',
+				},
+				end_date: {
+					type: 'string',
+					description: 'New end date (YYYY-MM-DD)',
+				},
+				auto_deploy_on_completion: {
+					type: 'boolean',
+					description: 'Auto-deploy setting',
+				},
+				deploy_environment: {
+					type: 'string',
+					enum: ['development', 'staging', 'production'],
+					description: 'Target environment',
+				},
+				deploy_version_bump: {
+					type: 'string',
+					enum: ['patch', 'minor', 'major'],
+					description: 'Version bump type',
+				},
+			},
+			required: ['sprint_id'],
+		},
+	},
+	{
+		name: 'get_sprint',
+		description: `Get a sprint with all its tasks organized by phase (pre/core/post).
+Includes progress percentage, velocity points, and committed points.
+Use summary_only: true to get task counts and next task instead of full task arrays (saves tokens).`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				sprint_id: {
+					type: 'string',
+					description: 'Sprint UUID',
+				},
+				summary_only: {
+					type: 'boolean',
+					description: 'Return task counts and next task instead of full task arrays (default: false)',
+				},
+			},
+			required: ['sprint_id'],
+		},
+	},
+	{
+		name: 'get_sprints',
+		description: `List sprints for a project with velocity metrics.
+Returns sprints sorted by sprint_number descending (most recent first).`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				status: {
+					type: 'string',
+					enum: ['planning', 'active', 'in_review', 'retrospective', 'completed', 'cancelled'],
+					description: 'Filter by sprint status (optional)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max sprints to return (default: 20, max: 100)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'delete_sprint',
+		description: `Delete a sprint. Tasks are preserved but no longer grouped.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				sprint_id: {
+					type: 'string',
+					description: 'Sprint UUID',
+				},
+			},
+			required: ['sprint_id'],
+		},
+	},
+	{
+		name: 'start_sprint',
+		description: `Start a sprint. Transitions from 'planning' to 'active' status.
+Locks the committed_points at the current total story points.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				sprint_id: {
+					type: 'string',
+					description: 'Sprint UUID',
+				},
+			},
+			required: ['sprint_id'],
+		},
+	},
+	{
+		name: 'complete_sprint',
+		description: `Complete a sprint. Handles retrospective phase and auto-deployment if configured.
+Status flow: active → in_review → retrospective → completed`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				sprint_id: {
+					type: 'string',
+					description: 'Sprint UUID',
+				},
+				retrospective_notes: {
+					type: 'string',
+					description: 'Sprint retrospective notes',
+				},
+				skip_retrospective: {
+					type: 'boolean',
+					description: 'Skip retrospective phase and go directly to completed (default: false)',
+				},
+			},
+			required: ['sprint_id'],
+		},
+	},
+	{
+		name: 'add_task_to_sprint',
+		description: `Add a task to a sprint with optional story points.
+Tasks can be added during 'planning' status. Story points contribute to committed_points.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				sprint_id: {
+					type: 'string',
+					description: 'Sprint UUID',
+				},
+				task_id: {
+					type: 'string',
+					description: 'Task UUID to add',
+				},
+				story_points: {
+					type: 'number',
+					description: 'Story point estimate (optional, must be non-negative integer)',
+				},
+				phase: {
+					type: 'string',
+					enum: ['pre', 'core', 'post'],
+					description: 'Task phase (default: core)',
+				},
+			},
+			required: ['sprint_id', 'task_id'],
+		},
+	},
+	{
+		name: 'remove_task_from_sprint',
+		description: `Remove a task from a sprint. Task is preserved but returns to backlog.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				sprint_id: {
+					type: 'string',
+					description: 'Sprint UUID',
+				},
+				task_id: {
+					type: 'string',
+					description: 'Task UUID to remove',
+				},
+			},
+			required: ['sprint_id', 'task_id'],
+		},
+	},
+	{
+		name: 'get_sprint_backlog',
+		description: `Get tasks from backlog/pending that can be added to a sprint.
+Returns tasks not already assigned to any body of work or sprint.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				sprint_id: {
+					type: 'string',
+					description: 'Sprint UUID to exclude already-added tasks (optional)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'get_sprint_velocity',
+		description: `Get velocity metrics for completed sprints.
+Returns committed vs completed points and average velocity.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				limit: {
+					type: 'number',
+					description: 'Number of sprints to analyze (default: 10, max: 50)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	// ============================================================================
+	// Git Issue Tools
+	// ============================================================================
+	{
+		name: 'add_git_issue',
+		description: `Record a git-related issue (merge conflict, push failure, etc.). Auto-created by claim_validation when conflicts detected.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				issue_type: {
+					type: 'string',
+					enum: ['merge_conflict', 'push_failed', 'rebase_needed', 'branch_diverged', 'pr_not_mergeable'],
+					description: 'Type of git issue',
+				},
+				branch: {
+					type: 'string',
+					description: 'Branch where the issue occurred',
+				},
+				target_branch: {
+					type: 'string',
+					description: 'Target branch for merge/rebase (optional)',
+				},
+				pr_url: {
+					type: 'string',
+					description: 'Pull request URL if applicable (optional)',
+				},
+				conflicting_files: {
+					type: 'array',
+					items: { type: 'string' },
+					description: 'List of files with conflicts (optional)',
+				},
+				error_message: {
+					type: 'string',
+					description: 'Error message from git operation (optional)',
+				},
+				task_id: {
+					type: 'string',
+					description: 'Related task UUID (optional)',
+				},
+			},
+			required: ['project_id', 'issue_type', 'branch'],
+		},
+	},
+	{
+		name: 'resolve_git_issue',
+		description: `Mark a git issue as resolved.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				git_issue_id: {
+					type: 'string',
+					description: 'Git issue UUID',
+				},
+				resolution_note: {
+					type: 'string',
+					description: 'How the issue was resolved (optional)',
+				},
+				auto_resolved: {
+					type: 'boolean',
+					description: 'Whether this was auto-resolved (e.g., PR became mergeable)',
+				},
+			},
+			required: ['git_issue_id'],
+		},
+	},
+	{
+		name: 'get_git_issues',
+		description: `Get git issues for a project, optionally filtered by status, type, or branch.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				status: {
+					type: 'string',
+					enum: ['open', 'resolved'],
+					description: 'Filter by status (default: open)',
+				},
+				issue_type: {
+					type: 'string',
+					enum: ['merge_conflict', 'push_failed', 'rebase_needed', 'branch_diverged', 'pr_not_mergeable'],
+					description: 'Filter by issue type (optional)',
+				},
+				branch: {
+					type: 'string',
+					description: 'Filter by branch (optional)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max issues to return (default: 50)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'delete_git_issue',
+		description: `Delete a git issue.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				git_issue_id: {
+					type: 'string',
+					description: 'Git issue UUID',
+				},
+			},
+			required: ['git_issue_id'],
+		},
+	},
 ];
 

package/dist/config/tool-categories.d.ts

@@ -1,31 +0,0 @@
-/**
- * Tool Categories Configuration
- *
- * Defines the categorization of MCP tools for discovery.
- * Moved to separate config for lazy-loading optimization.
- */
-export interface ToolEntry {
-    name: string;
-    brief: string;
-}
-export interface CategoryEntry {
-    description: string;
-    tools: ToolEntry[];
-}
-export declare const TOOL_CATEGORIES: Record<string, CategoryEntry>;
-/**
- * Get list of category names
- */
-export declare function getCategoryNames(): string[];
-/**
- * Get category summary (without full tool list)
- */
-export declare function getCategorySummary(): Array<{
-    name: string;
-    description: string;
-    tool_count: number;
-}>;
-/**
- * Get tools in a specific category
- */
-export declare function getCategoryTools(category: string): CategoryEntry | undefined;

package/dist/config/tool-categories.js

@@ -1,253 +0,0 @@
-/**
- * Tool Categories Configuration
- *
- * Defines the categorization of MCP tools for discovery.
- * Moved to separate config for lazy-loading optimization.
- */
-export const TOOL_CATEGORIES = {
-    session: {
-        description: 'Session lifecycle and monitoring',
-        tools: [
-            { name: 'start_work_session', brief: 'Initialize session, get next task' },
-            { name: 'get_help', brief: 'Get workflow guidance' },
-            { name: 'get_token_usage', brief: 'View token stats' },
-            { name: 'heartbeat', brief: 'Maintain active status' },
-            { name: 'end_work_session', brief: 'End session, release tasks' },
-        ],
-    },
-    project: {
-        description: 'Project CRUD and configuration',
-        tools: [
-            { name: 'get_project_context', brief: 'Full project info' },
-            { name: 'get_git_workflow', brief: 'Git branching config' },
-            { name: 'create_project', brief: 'Create new project' },
-            { name: 'update_project', brief: 'Modify project settings' },
-            { name: 'update_project_readme', brief: 'Sync README to dashboard' },
-        ],
-    },
-    tasks: {
-        description: 'Task management and tracking',
-        tools: [
-            { name: 'get_tasks', brief: 'List project tasks' },
-            { name: 'get_next_task', brief: 'Get highest priority task' },
-            { name: 'add_task', brief: 'Create new task' },
-            { name: 'update_task', brief: 'Update task status/progress' },
-            { name: 'complete_task', brief: 'Mark task done' },
-            { name: 'delete_task', brief: 'Remove a task' },
-            { name: 'batch_update_tasks', brief: 'Update multiple tasks' },
-            { name: 'batch_complete_tasks', brief: 'Complete multiple tasks' },
-            { name: 'add_task_reference', brief: 'Add URL to task' },
-            { name: 'remove_task_reference', brief: 'Remove URL from task' },
-        ],
-    },
-    milestones: {
-        description: 'Task breakdown into steps',
-        tools: [
-            { name: 'add_milestone', brief: 'Add step to task' },
-            { name: 'update_milestone', brief: 'Update milestone' },
-            { name: 'complete_milestone', brief: 'Mark step done' },
-            { name: 'delete_milestone', brief: 'Remove milestone' },
-            { name: 'get_milestones', brief: 'List task milestones' },
-        ],
-    },
-    progress: {
-        description: 'Progress logging and activity',
-        tools: [
-            { name: 'log_progress', brief: 'Record progress update' },
-            { name: 'get_activity_feed', brief: 'Combined activity feed' },
-        ],
-    },
-    blockers: {
-        description: 'Blocker management',
-        tools: [
-            { name: 'add_blocker', brief: 'Record a blocker' },
-            { name: 'resolve_blocker', brief: 'Mark resolved' },
-            { name: 'get_blockers', brief: 'List blockers' },
-            { name: 'delete_blocker', brief: 'Remove blocker' },
-        ],
-    },
-    decisions: {
-        description: 'Architectural decisions',
-        tools: [
-            { name: 'log_decision', brief: 'Record decision' },
-            { name: 'get_decisions', brief: 'List decisions' },
-            { name: 'delete_decision', brief: 'Remove decision' },
-        ],
-    },
-    ideas: {
-        description: 'Feature ideas tracking',
-        tools: [
-            { name: 'add_idea', brief: 'Record an idea' },
-            { name: 'update_idea', brief: 'Update idea status' },
-            { name: 'get_ideas', brief: 'List ideas' },
-            { name: 'delete_idea', brief: 'Remove idea' },
-            { name: 'convert_idea_to_task', brief: 'Convert idea to task' },
-        ],
-    },
-    findings: {
-        description: 'Audit findings/knowledge base',
-        tools: [
-            { name: 'add_finding', brief: 'Record audit finding' },
-            { name: 'get_findings', brief: 'List findings' },
-            { name: 'update_finding', brief: 'Update finding status' },
-            { name: 'delete_finding', brief: 'Remove finding' },
-        ],
-    },
-    validation: {
-        description: 'Cross-agent task validation',
-        tools: [
-            { name: 'get_tasks_awaiting_validation', brief: 'Unvalidated tasks' },
-            { name: 'claim_validation', brief: 'Claim task for review' },
-            { name: 'validate_task', brief: 'Approve/reject task' },
-        ],
-    },
-    deployment: {
-        description: 'Deployment coordination',
-        tools: [
-            { name: 'request_deployment', brief: 'Request deploy' },
-            { name: 'claim_deployment_validation', brief: 'Claim for validation' },
-            { name: 'report_validation', brief: 'Report build/test results' },
-            { name: 'check_deployment_status', brief: 'Get deploy status' },
-            { name: 'start_deployment', brief: 'Begin deployment' },
-            { name: 'complete_deployment', brief: 'Mark deploy done' },
-            { name: 'cancel_deployment', brief: 'Cancel deployment' },
-            { name: 'add_deployment_requirement', brief: 'Add pre-deploy step' },
-            { name: 'complete_deployment_requirement', brief: 'Mark step done' },
-            { name: 'get_deployment_requirements', brief: 'List pre-deploy steps' },
-            { name: 'schedule_deployment', brief: 'Schedule future deployment' },
-            { name: 'get_scheduled_deployments', brief: 'List scheduled deployments' },
-            { name: 'update_scheduled_deployment', brief: 'Update schedule config' },
-            { name: 'delete_scheduled_deployment', brief: 'Delete schedule' },
-            { name: 'trigger_scheduled_deployment', brief: 'Manual trigger' },
-            { name: 'check_due_deployments', brief: 'Check due schedules' },
-        ],
-    },
-    fallback: {
-        description: 'Background activities when idle',
-        tools: [
-            { name: 'start_fallback_activity', brief: 'Start background work' },
-            { name: 'stop_fallback_activity', brief: 'Stop background work' },
-            { name: 'get_activity_history', brief: 'Activity history' },
-            { name: 'get_activity_schedules', brief: 'Activity schedules' },
-        ],
-    },
-    bodies_of_work: {
-        description: 'Group tasks into bodies of work',
-        tools: [
-            { name: 'create_body_of_work', brief: 'Create task group' },
-            { name: 'update_body_of_work', brief: 'Update settings' },
-            { name: 'get_body_of_work', brief: 'Get with tasks' },
-            { name: 'get_bodies_of_work', brief: 'List bodies of work' },
-            { name: 'delete_body_of_work', brief: 'Remove body of work' },
-            { name: 'add_task_to_body_of_work', brief: 'Add task to group' },
-            { name: 'remove_task_from_body_of_work', brief: 'Remove from group' },
-            { name: 'activate_body_of_work', brief: 'Activate for work' },
-        ],
-    },
-    requests: {
-        description: 'User request handling',
-        tools: [
-            { name: 'get_pending_requests', brief: 'Unhandled requests' },
-            { name: 'acknowledge_request', brief: 'Mark handled' },
-            { name: 'answer_question', brief: 'Answer user question' },
-        ],
-    },
-    organizations: {
-        description: 'Organization and team management',
-        tools: [
-            { name: 'list_organizations', brief: 'List user orgs' },
-            { name: 'create_organization', brief: 'Create new org' },
-            { name: 'update_organization', brief: 'Update org settings' },
-            { name: 'delete_organization', brief: 'Delete org' },
-            { name: 'list_org_members', brief: 'List org members' },
-            { name: 'invite_member', brief: 'Invite by email' },
-            { name: 'update_member_role', brief: 'Change member role' },
-            { name: 'remove_member', brief: 'Remove from org' },
-            { name: 'leave_organization', brief: 'Leave an org' },
-            { name: 'share_project_with_org', brief: 'Share project' },
-            { name: 'update_project_share', brief: 'Update share perms' },
-            { name: 'unshare_project', brief: 'Remove share' },
-            { name: 'list_project_shares', brief: 'List project shares' },
-        ],
-    },
-    cost: {
-        description: 'Cost monitoring and alerts',
-        tools: [
-            { name: 'get_cost_summary', brief: 'Cost by period' },
-            { name: 'get_cost_alerts', brief: 'List cost alerts' },
-            { name: 'add_cost_alert', brief: 'Add threshold alert' },
-            { name: 'update_cost_alert', brief: 'Update alert config' },
-            { name: 'delete_cost_alert', brief: 'Remove alert' },
-            { name: 'get_task_costs', brief: 'Cost per task' },
-        ],
-    },
-    knowledge: {
-        description: 'Queryable knowledge base from project data',
-        tools: [
-            { name: 'query_knowledge_base', brief: 'Aggregated project knowledge in one call' },
-        ],
-    },
-    subtasks: {
-        description: 'Subtask management',
-        tools: [
-            { name: 'add_subtask', brief: 'Add subtask to parent' },
-            { name: 'get_subtasks', brief: 'List subtasks' },
-        ],
-    },
-    sprints: {
-        description: 'Sprint planning and tracking',
-        tools: [
-            { name: 'create_sprint', brief: 'Create new sprint' },
-            { name: 'update_sprint', brief: 'Update sprint' },
-            { name: 'get_sprint', brief: 'Get sprint details' },
-            { name: 'get_sprints', brief: 'List sprints' },
-            { name: 'delete_sprint', brief: 'Remove sprint' },
-            { name: 'start_sprint', brief: 'Start sprint' },
-            { name: 'complete_sprint', brief: 'End sprint' },
-            { name: 'add_task_to_sprint', brief: 'Add task' },
-            { name: 'remove_task_from_sprint', brief: 'Remove task' },
-            { name: 'get_sprint_backlog', brief: 'Available tasks' },
-            { name: 'get_sprint_velocity', brief: 'Velocity metrics' },
-        ],
-    },
-    git_issues: {
-        description: 'Git issue tracking',
-        tools: [
-            { name: 'add_git_issue', brief: 'Record git issue' },
-            { name: 'resolve_git_issue', brief: 'Mark resolved' },
-            { name: 'get_git_issues', brief: 'List git issues' },
-            { name: 'delete_git_issue', brief: 'Remove issue' },
-        ],
-    },
-    dependencies: {
-        description: 'Task dependencies',
-        tools: [
-            { name: 'add_task_dependency', brief: 'Add dependency' },
-            { name: 'remove_task_dependency', brief: 'Remove dependency' },
-            { name: 'get_task_dependencies', brief: 'List dependencies' },
-            { name: 'get_next_body_of_work_task', brief: 'Next available task' },
-        ],
-    },
-};
-/**
- * Get list of category names
- */
-export function getCategoryNames() {
-    return Object.keys(TOOL_CATEGORIES);
-}
-/**
- * Get category summary (without full tool list)
- */
-export function getCategorySummary() {
-    return Object.entries(TOOL_CATEGORIES).map(([name, cat]) => ({
-        name,
-        description: cat.description,
-        tool_count: cat.tools.length,
-    }));
-}
-/**
- * Get tools in a specific category
- */
-export function getCategoryTools(category) {
-    return TOOL_CATEGORIES[category];
-}

package/dist/knowledge.d.ts

@@ -1,6 +0,0 @@
-/**
- * Knowledge Base
- *
- * Embedded help topics for on-demand agent guidance.
- */
-export declare const KNOWLEDGE_BASE: Record<string, string>;