@vibescope/mcp-server 0.1.0 → 0.2.1

package/src/tools.ts

@@ -884,15 +884,29 @@ Returns session info, persona, role, and next task. Use mode:'full' for complete
 	},
 	{
 		name: 'get_findings',
-		description: `Get findings for a project, optionally filtered by category, severity, or status.`,
+		description: `Get findings for a project, optionally filtered by category, severity, or status. Use summary_only=true to reduce token usage by returning only essential fields (id, title, category, severity, status). For just counts, use get_findings_stats instead.`,
 		inputSchema: {
 			type: 'object',
 			properties: {
 				project_id: { type: 'string', description: 'Project UUID' },
 				category: { type: 'string', enum: ['performance', 'security', 'code_quality', 'accessibility', 'documentation', 'architecture', 'testing', 'other'], description: 'Filter by category (optional)' },
 				severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Filter by severity (optional)' },
-				status: { type: 'string', enum: ['open', 'addressed', 'dismissed', 'wontfix'], description: 'Filter by status (default: all)' },
-				limit: { type: 'number', description: 'Max number of findings to return (default 50)' },
+				status: { type: 'string', enum: ['open', 'addressed', 'dismissed', 'wontfix'], description: 'Filter by status (default: open)' },
+				limit: { type: 'number', description: 'Max number of findings to return (default 50, max 200)' },
+				offset: { type: 'number', description: 'Number of findings to skip for pagination (default 0)' },
+				search_query: { type: 'string', description: 'Search findings by title' },
+				summary_only: { type: 'boolean', description: 'When true, returns only id, title, category, severity, status (reduces tokens by ~80%). Default: false' },
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'get_findings_stats',
+		description: `Get aggregate statistics about findings for a project. Returns total count and breakdowns by status, severity, and category. Much more token-efficient than get_findings when you just need to understand the overall state.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: { type: 'string', description: 'Project UUID' },
 			},
 			required: ['project_id'],
 		},
@@ -1103,6 +1117,10 @@ Returns subtasks with aggregate completion stats.`,
 					type: 'string',
 					description: 'Session ID from start_work_session (optional, uses current session if not provided)',
 				},
+				current_worktree_path: {
+					type: ['string', 'null'],
+					description: 'Report your current git worktree path (e.g., "../project-task-abc123"). Set to null to clear.',
+				},
 			},
 		},
 	},
@@ -1152,7 +1170,7 @@ Returns subtasks with aggregate completion stats.`,
 	},
 	{
 		name: 'validate_task',
-		description: 'Validate a completed task. Include test results in validation_notes.',
+		description: 'Validate a completed task. Include test results in validation_notes. For github-flow/git-flow projects, a PR must exist before approval (add via add_task_reference).',
 		inputSchema: {
 			type: 'object',
 			properties: {
@@ -1168,6 +1186,10 @@ Returns subtasks with aggregate completion stats.`,
 					type: 'boolean',
 					description: 'Whether the task passes validation (true = approved, false = needs more work)',
 				},
+				skip_pr_check: {
+					type: 'boolean',
+					description: 'Skip PR existence check (use only for tasks that legitimately do not need a PR)',
+				},
 			},
 			required: ['task_id', 'approved'],
 		},
@@ -1351,6 +1373,10 @@ Returns subtasks with aggregate completion stats.`,
 					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'],
 		},
@@ -2502,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;