@vibescope/mcp-server 0.5.0 → 0.5.1

package/src/tools/deployment.ts

@@ -1,455 +1,455 @@
-/**
- * Deployment Tool Definitions
- *
- * Tools for deployment coordination:
- * - request_deployment
- * - claim_deployment_validation
- * - report_validation
- * - check_deployment_status
- * - start_deployment
- * - complete_deployment
- * - cancel_deployment
- * - add_deployment_requirement
- * - complete_deployment_requirement
- * - get_deployment_requirements
- * - get_deployment_requirements_stats
- * - schedule_deployment
- * - get_scheduled_deployments
- * - update_scheduled_deployment
- * - delete_scheduled_deployment
- * - trigger_scheduled_deployment
- * - check_due_deployments
- */
-
-import type { Tool } from './types.js';
-
-export const deploymentTools: Tool[] = [
-	{
-		name: 'request_deployment',
-		description: 'Request a deployment. Requires validation first. One active deployment per project.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				environment: {
-					type: 'string',
-					enum: ['development', 'staging', 'production'],
-					description: 'Target environment (default: production)',
-				},
-				version_bump: {
-					type: 'string',
-					enum: ['patch', 'minor', 'major'],
-					description: 'Version bump: major/minor/patch (default: patch)',
-				},
-				notes: {
-					type: 'string',
-					description: 'Optional notes about this deployment',
-				},
-				git_ref: {
-					type: 'string',
-					description: 'Git branch or commit being deployed',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'claim_deployment_validation',
-		description: `Claim pending deployment for validation. Run build+tests, then call report_validation.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'report_validation',
-		description: `Report build/test results. If passed, status->'ready'. If failed, creates investigation task.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				build_passed: {
-					type: 'boolean',
-					description: 'Whether the build succeeded',
-				},
-				tests_passed: {
-					type: 'boolean',
-					description: 'Whether the tests passed',
-				},
-				error_message: {
-					type: 'string',
-					description: 'Error details if validation failed',
-				},
-			},
-			required: ['project_id', 'build_passed', 'tests_passed'],
-		},
-	},
-	{
-		name: 'check_deployment_status',
-		description: `Get active deployment status and details.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'start_deployment',
-		description: `Start deployment (requires 'ready' status). Sets status to 'deploying'.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'complete_deployment',
-		description: `Mark deployment as complete (success or failure).`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				success: {
-					type: 'boolean',
-					description: 'Whether the deployment succeeded',
-				},
-				summary: {
-					type: 'string',
-					description: 'Summary of what was deployed or why it failed',
-				},
-			},
-			required: ['project_id', 'success'],
-		},
-	},
-	{
-		name: 'cancel_deployment',
-		description: `Cancel active deployment. Sets status to 'failed'.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				reason: {
-					type: 'string',
-					description: 'Reason for cancellation',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'add_deployment_requirement',
-		description: `Add a pre-deployment requirement (migration, env var, config change). These are shown as a checklist before deployment.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				type: {
-					type: 'string',
-					description: 'Type of requirement',
-					enum: ['migration', 'env_var', 'config', 'manual', 'breaking_change', 'agent_task'],
-				},
-				title: {
-					type: 'string',
-					description: 'Brief description (e.g., "Run migration: 20250114_token_tracking.sql")',
-				},
-				description: {
-					type: 'string',
-					description: 'Optional detailed instructions',
-				},
-				file_path: {
-					type: 'string',
-					description: 'Optional file path reference',
-				},
-				stage: {
-					type: 'string',
-					description: 'Deployment stage: preparation (default), deployment, or verification',
-					enum: ['preparation', 'deployment', 'verification'],
-				},
-				blocking: {
-					type: 'boolean',
-					description: 'When true, converted task blocks all other work until complete',
-				},
-				recurring: {
-					type: 'boolean',
-					description: 'When true, requirement resets to pending when a new deployment is requested',
-				},
-			},
-			required: ['project_id', 'type', 'title'],
-		},
-	},
-	{
-		name: 'complete_deployment_requirement',
-		description: `Mark a deployment requirement as completed.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				requirement_id: {
-					type: 'string',
-					description: 'Requirement UUID',
-				},
-			},
-			required: ['requirement_id'],
-		},
-	},
-	{
-		name: 'get_deployment_requirements',
-		description: `Get pending deployment requirements for a project.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				status: {
-					type: 'string',
-					description: 'Filter by status (default: pending)',
-					enum: ['pending', 'completed', 'converted_to_task', 'all'],
-				},
-				stage: {
-					type: 'string',
-					description: 'Filter by stage (optional)',
-					enum: ['preparation', 'deployment', 'verification', 'all'],
-				},
-				limit: {
-					type: 'number',
-					description: 'Max number of requirements to return (default 50, max 200)',
-				},
-				offset: {
-					type: 'number',
-					description: 'Number of requirements to skip for pagination (default 0)',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'get_deployment_requirements_stats',
-		description: `Get aggregate statistics about deployment requirements for a project. Returns total count and breakdowns by status, stage, and type. More token-efficient than get_deployment_requirements when you just need to understand the overall state.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: { type: 'string', description: 'Project UUID' },
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'reorder_deployment_requirements',
-		description: `Reorder deployment requirements within a stage. Pass the requirement IDs in the desired order.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: { type: 'string', description: 'Project UUID' },
-				stage: { type: 'string', enum: ['preparation', 'deployment', 'verification'], description: 'Deployment stage' },
-				requirement_ids: { type: 'array', items: { type: 'string' }, description: 'Ordered array of requirement UUIDs' },
-			},
-			required: ['project_id', 'stage', 'requirement_ids'],
-		},
-	},
-	{
-		name: 'schedule_deployment',
-		description: `Schedule a deployment for a specific time. Supports one-time and recurring schedules with auto-trigger or manual trigger modes.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				scheduled_at: {
-					type: 'string',
-					description: 'ISO 8601 datetime for when the deployment should be triggered',
-				},
-				schedule_type: {
-					type: 'string',
-					description: 'Schedule type: once (one-time), hourly, daily, weekly, or monthly',
-					enum: ['once', 'hourly', 'daily', 'weekly', 'monthly'],
-				},
-				hours_interval: {
-					type: 'number',
-					description: 'For hourly schedules, the number of hours between runs (1-24, default: 1)',
-					minimum: 1,
-					maximum: 24,
-				},
-				auto_trigger: {
-					type: 'boolean',
-					description: 'Whether agents should automatically trigger this deployment when due (default: true)',
-				},
-				environment: {
-					type: 'string',
-					description: 'Target environment (default: production)',
-					enum: ['development', 'staging', 'production'],
-				},
-				version_bump: {
-					type: 'string',
-					description: 'Version bump: patch, minor, or major (default: patch)',
-					enum: ['patch', 'minor', 'major'],
-				},
-				notes: {
-					type: 'string',
-					description: 'Optional notes about this scheduled deployment',
-				},
-				git_ref: {
-					type: 'string',
-					description: 'Optional git branch or commit to deploy',
-				},
-			},
-			required: ['project_id', 'scheduled_at'],
-		},
-	},
-	{
-		name: 'get_scheduled_deployments',
-		description: `Get scheduled deployments for a project.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				include_disabled: {
-					type: 'boolean',
-					description: 'Include disabled schedules (default: false)',
-				},
-				limit: {
-					type: 'number',
-					description: 'Max schedules to return (default: 50)',
-				},
-				offset: {
-					type: 'number',
-					description: 'Number of schedules to skip for pagination (default: 0)',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'update_scheduled_deployment',
-		description: `Update a scheduled deployment's configuration.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				schedule_id: {
-					type: 'string',
-					description: 'Schedule UUID',
-				},
-				scheduled_at: {
-					type: 'string',
-					description: 'New scheduled time (ISO 8601)',
-				},
-				schedule_type: {
-					type: 'string',
-					description: 'New schedule type',
-					enum: ['once', 'hourly', 'daily', 'weekly', 'monthly'],
-				},
-				hours_interval: {
-					type: 'number',
-					description: 'For hourly schedules, the number of hours between runs (1-24)',
-					minimum: 1,
-					maximum: 24,
-				},
-				auto_trigger: {
-					type: 'boolean',
-					description: 'Whether to auto-trigger',
-				},
-				enabled: {
-					type: 'boolean',
-					description: 'Enable or disable the schedule',
-				},
-				environment: {
-					type: 'string',
-					description: 'Target environment',
-					enum: ['development', 'staging', 'production'],
-				},
-				version_bump: {
-					type: 'string',
-					description: 'Version bump type',
-					enum: ['patch', 'minor', 'major'],
-				},
-				notes: {
-					type: 'string',
-					description: 'Notes about this deployment',
-				},
-				git_ref: {
-					type: 'string',
-					description: 'Git branch or commit to deploy',
-				},
-			},
-			required: ['schedule_id'],
-		},
-	},
-	{
-		name: 'delete_scheduled_deployment',
-		description: `Delete a scheduled deployment.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				schedule_id: {
-					type: 'string',
-					description: 'Schedule UUID',
-				},
-			},
-			required: ['schedule_id'],
-		},
-	},
-	{
-		name: 'trigger_scheduled_deployment',
-		description: `Manually trigger a scheduled deployment. Creates a new deployment and updates the schedule.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				schedule_id: {
-					type: 'string',
-					description: 'Schedule UUID',
-				},
-			},
-			required: ['schedule_id'],
-		},
-	},
-	{
-		name: 'check_due_deployments',
-		description: `Check for scheduled deployments that are due. Returns schedules where: enabled AND auto_trigger AND scheduled_at <= NOW().`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-];
+/**
+ * Deployment Tool Definitions
+ *
+ * Tools for deployment coordination:
+ * - request_deployment
+ * - claim_deployment_validation
+ * - report_validation
+ * - check_deployment_status
+ * - start_deployment
+ * - complete_deployment
+ * - cancel_deployment
+ * - add_deployment_requirement
+ * - complete_deployment_requirement
+ * - get_deployment_requirements
+ * - get_deployment_requirements_stats
+ * - schedule_deployment
+ * - get_scheduled_deployments
+ * - update_scheduled_deployment
+ * - delete_scheduled_deployment
+ * - trigger_scheduled_deployment
+ * - check_due_deployments
+ */
+
+import type { Tool } from './types.js';
+
+export const deploymentTools: Tool[] = [
+	{
+		name: 'request_deployment',
+		description: 'Request a deployment. Requires validation first. One active deployment per project.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				environment: {
+					type: 'string',
+					enum: ['development', 'staging', 'production'],
+					description: 'Target environment (default: production)',
+				},
+				version_bump: {
+					type: 'string',
+					enum: ['patch', 'minor', 'major'],
+					description: 'Version bump: major/minor/patch (default: patch)',
+				},
+				notes: {
+					type: 'string',
+					description: 'Optional notes about this deployment',
+				},
+				git_ref: {
+					type: 'string',
+					description: 'Git branch or commit being deployed',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'claim_deployment_validation',
+		description: `Claim pending deployment for validation. Run build+tests, then call report_validation.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'report_validation',
+		description: `Report build/test results. If passed, status->'ready'. If failed, creates investigation task.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				build_passed: {
+					type: 'boolean',
+					description: 'Whether the build succeeded',
+				},
+				tests_passed: {
+					type: 'boolean',
+					description: 'Whether the tests passed',
+				},
+				error_message: {
+					type: 'string',
+					description: 'Error details if validation failed',
+				},
+			},
+			required: ['project_id', 'build_passed', 'tests_passed'],
+		},
+	},
+	{
+		name: 'check_deployment_status',
+		description: `Get active deployment status and details.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'start_deployment',
+		description: `Start deployment (requires 'ready' status). Sets status to 'deploying'.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'complete_deployment',
+		description: `Mark deployment as complete (success or failure).`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				success: {
+					type: 'boolean',
+					description: 'Whether the deployment succeeded',
+				},
+				summary: {
+					type: 'string',
+					description: 'Summary of what was deployed or why it failed',
+				},
+			},
+			required: ['project_id', 'success'],
+		},
+	},
+	{
+		name: 'cancel_deployment',
+		description: `Cancel active deployment. Sets status to 'failed'.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				reason: {
+					type: 'string',
+					description: 'Reason for cancellation',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'add_deployment_requirement',
+		description: `Add a pre-deployment requirement (migration, env var, config change). These are shown as a checklist before deployment.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				type: {
+					type: 'string',
+					description: 'Type of requirement',
+					enum: ['migration', 'env_var', 'config', 'manual', 'breaking_change', 'agent_task'],
+				},
+				title: {
+					type: 'string',
+					description: 'Brief description (e.g., "Run migration: 20250114_token_tracking.sql")',
+				},
+				description: {
+					type: 'string',
+					description: 'Optional detailed instructions',
+				},
+				file_path: {
+					type: 'string',
+					description: 'Optional file path reference',
+				},
+				stage: {
+					type: 'string',
+					description: 'Deployment stage: preparation (default), deployment, or verification',
+					enum: ['preparation', 'deployment', 'verification'],
+				},
+				blocking: {
+					type: 'boolean',
+					description: 'When true, converted task blocks all other work until complete',
+				},
+				recurring: {
+					type: 'boolean',
+					description: 'When true, requirement resets to pending when a new deployment is requested',
+				},
+			},
+			required: ['project_id', 'type', 'title'],
+		},
+	},
+	{
+		name: 'complete_deployment_requirement',
+		description: `Mark a deployment requirement as completed.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				requirement_id: {
+					type: 'string',
+					description: 'Requirement UUID',
+				},
+			},
+			required: ['requirement_id'],
+		},
+	},
+	{
+		name: 'get_deployment_requirements',
+		description: `Get pending deployment requirements for a project.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				status: {
+					type: 'string',
+					description: 'Filter by status (default: pending)',
+					enum: ['pending', 'completed', 'converted_to_task', 'all'],
+				},
+				stage: {
+					type: 'string',
+					description: 'Filter by stage (optional)',
+					enum: ['preparation', 'deployment', 'verification', 'all'],
+				},
+				limit: {
+					type: 'number',
+					description: 'Max number of requirements to return (default 50, max 200)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Number of requirements to skip for pagination (default 0)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'get_deployment_requirements_stats',
+		description: `Get aggregate statistics about deployment requirements for a project. Returns total count and breakdowns by status, stage, and type. More token-efficient than get_deployment_requirements when you just need to understand the overall state.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: { type: 'string', description: 'Project UUID' },
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'reorder_deployment_requirements',
+		description: `Reorder deployment requirements within a stage. Pass the requirement IDs in the desired order.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: { type: 'string', description: 'Project UUID' },
+				stage: { type: 'string', enum: ['preparation', 'deployment', 'verification'], description: 'Deployment stage' },
+				requirement_ids: { type: 'array', items: { type: 'string' }, description: 'Ordered array of requirement UUIDs' },
+			},
+			required: ['project_id', 'stage', 'requirement_ids'],
+		},
+	},
+	{
+		name: 'schedule_deployment',
+		description: `Schedule a deployment for a specific time. Supports one-time and recurring schedules with auto-trigger or manual trigger modes.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				scheduled_at: {
+					type: 'string',
+					description: 'ISO 8601 datetime for when the deployment should be triggered',
+				},
+				schedule_type: {
+					type: 'string',
+					description: 'Schedule type: once (one-time), hourly, daily, weekly, or monthly',
+					enum: ['once', 'hourly', 'daily', 'weekly', 'monthly'],
+				},
+				hours_interval: {
+					type: 'number',
+					description: 'For hourly schedules, the number of hours between runs (1-24, default: 1)',
+					minimum: 1,
+					maximum: 24,
+				},
+				auto_trigger: {
+					type: 'boolean',
+					description: 'Whether agents should automatically trigger this deployment when due (default: true)',
+				},
+				environment: {
+					type: 'string',
+					description: 'Target environment (default: production)',
+					enum: ['development', 'staging', 'production'],
+				},
+				version_bump: {
+					type: 'string',
+					description: 'Version bump: patch, minor, or major (default: patch)',
+					enum: ['patch', 'minor', 'major'],
+				},
+				notes: {
+					type: 'string',
+					description: 'Optional notes about this scheduled deployment',
+				},
+				git_ref: {
+					type: 'string',
+					description: 'Optional git branch or commit to deploy',
+				},
+			},
+			required: ['project_id', 'scheduled_at'],
+		},
+	},
+	{
+		name: 'get_scheduled_deployments',
+		description: `Get scheduled deployments for a project.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				include_disabled: {
+					type: 'boolean',
+					description: 'Include disabled schedules (default: false)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max schedules to return (default: 50)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Number of schedules to skip for pagination (default: 0)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'update_scheduled_deployment',
+		description: `Update a scheduled deployment's configuration.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				schedule_id: {
+					type: 'string',
+					description: 'Schedule UUID',
+				},
+				scheduled_at: {
+					type: 'string',
+					description: 'New scheduled time (ISO 8601)',
+				},
+				schedule_type: {
+					type: 'string',
+					description: 'New schedule type',
+					enum: ['once', 'hourly', 'daily', 'weekly', 'monthly'],
+				},
+				hours_interval: {
+					type: 'number',
+					description: 'For hourly schedules, the number of hours between runs (1-24)',
+					minimum: 1,
+					maximum: 24,
+				},
+				auto_trigger: {
+					type: 'boolean',
+					description: 'Whether to auto-trigger',
+				},
+				enabled: {
+					type: 'boolean',
+					description: 'Enable or disable the schedule',
+				},
+				environment: {
+					type: 'string',
+					description: 'Target environment',
+					enum: ['development', 'staging', 'production'],
+				},
+				version_bump: {
+					type: 'string',
+					description: 'Version bump type',
+					enum: ['patch', 'minor', 'major'],
+				},
+				notes: {
+					type: 'string',
+					description: 'Notes about this deployment',
+				},
+				git_ref: {
+					type: 'string',
+					description: 'Git branch or commit to deploy',
+				},
+			},
+			required: ['schedule_id'],
+		},
+	},
+	{
+		name: 'delete_scheduled_deployment',
+		description: `Delete a scheduled deployment.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				schedule_id: {
+					type: 'string',
+					description: 'Schedule UUID',
+				},
+			},
+			required: ['schedule_id'],
+		},
+	},
+	{
+		name: 'trigger_scheduled_deployment',
+		description: `Manually trigger a scheduled deployment. Creates a new deployment and updates the schedule.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				schedule_id: {
+					type: 'string',
+					description: 'Schedule UUID',
+				},
+			},
+			required: ['schedule_id'],
+		},
+	},
+	{
+		name: 'check_due_deployments',
+		description: `Check for scheduled deployments that are due. Returns schedules where: enabled AND auto_trigger AND scheduled_at <= NOW().`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+];