@vibescope/mcp-server 0.5.0 → 0.5.2

package/src/tools/sprints.ts

@@ -1,298 +1,298 @@
-/**
- * Sprint Tool Definitions
- *
- * Tools for managing sprints with velocity tracking:
- * - 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 { Tool } from './types.js';
-
-export const sprintTools: Tool[] = [
-	{
-		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 with pagination.
-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)',
-				},
-				limit: {
-					type: 'number',
-					description: 'Max tasks to return (default: 20, max: 50)',
-				},
-				offset: {
-					type: 'number',
-					description: 'Number of tasks to skip (default: 0)',
-				},
-			},
-			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'],
-		},
-	},
-];
+/**
+ * Sprint Tool Definitions
+ *
+ * Tools for managing sprints with velocity tracking:
+ * - 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 { Tool } from './types.js';
+
+export const sprintTools: Tool[] = [
+	{
+		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 with pagination.
+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)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max tasks to return (default: 20, max: 50)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Number of tasks to skip (default: 0)',
+				},
+			},
+			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'],
+		},
+	},
+];