@vibescope/mcp-server 0.5.0 → 0.5.1

package/src/tools/file-checkouts.ts

@@ -1,145 +1,145 @@
-/**
- * File Checkout Tool Definitions
- *
- * Tools for multi-agent file coordination:
- * - checkout_file
- * - checkin_file
- * - get_file_checkouts
- * - abandon_checkout
- * - is_file_available
- * - get_file_checkouts_stats
- */
-
-import type { Tool } from './types.js';
-
-export const fileCheckoutTools: Tool[] = [
-	{
-		name: 'checkout_file',
-		description: 'Check out a file for editing. Prevents other agents from editing the same file until checked in. ALWAYS checkout files before making changes to prevent conflicts.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				file_path: {
-					type: 'string',
-					description: 'Relative path to the file to checkout (e.g., "src/index.ts")',
-				},
-				reason: {
-					type: 'string',
-					description: 'Optional reason for checkout (e.g., "Fixing bug in login flow")',
-				},
-			},
-			required: ['project_id', 'file_path'],
-		},
-	},
-	{
-		name: 'checkin_file',
-		description: 'Check in a file after editing. Releases the file for other agents to edit. ALWAYS checkin files when done editing.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				checkout_id: {
-					type: 'string',
-					description: 'Checkout UUID (from checkout_file response)',
-				},
-				project_id: {
-					type: 'string',
-					description: 'Project UUID (alternative to checkout_id)',
-				},
-				file_path: {
-					type: 'string',
-					description: 'File path (use with project_id as alternative to checkout_id)',
-				},
-				summary: {
-					type: 'string',
-					description: 'Optional summary of changes made',
-				},
-			},
-		},
-	},
-	{
-		name: 'get_file_checkouts',
-		description: 'Get list of file checkouts for a project. Shows which files are currently checked out and by whom.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				status: {
-					type: 'string',
-					enum: ['checked_out', 'checked_in', 'abandoned'],
-					description: 'Filter by status (default: checked_out)',
-				},
-				include_completed: {
-					type: 'boolean',
-					description: 'Include checked_in and abandoned checkouts (default: false)',
-				},
-				limit: {
-					type: 'number',
-					description: 'Max checkouts to return (default: 50)',
-				},
-				offset: {
-					type: 'number',
-					description: 'Number of checkouts to skip for pagination (default 0)',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'abandon_checkout',
-		description: 'Force-release a checkout. Use when the original agent session died or is stuck.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				checkout_id: {
-					type: 'string',
-					description: 'Checkout UUID to abandon',
-				},
-				reason: {
-					type: 'string',
-					description: 'Reason for abandoning (e.g., "Agent session died")',
-				},
-			},
-			required: ['checkout_id'],
-		},
-	},
-	{
-		name: 'is_file_available',
-		description: 'Check if a file is available for checkout. Returns who has it checked out if not available.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				file_path: {
-					type: 'string',
-					description: 'Path to the file to check',
-				},
-			},
-			required: ['project_id', 'file_path'],
-		},
-	},
-	{
-		name: 'get_file_checkouts_stats',
-		description:
-			'Get aggregate statistics about file checkouts for a project. Returns counts by status without the actual checkout data. This is much more token-efficient than get_file_checkouts for understanding the overall state.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-];
+/**
+ * File Checkout Tool Definitions
+ *
+ * Tools for multi-agent file coordination:
+ * - checkout_file
+ * - checkin_file
+ * - get_file_checkouts
+ * - abandon_checkout
+ * - is_file_available
+ * - get_file_checkouts_stats
+ */
+
+import type { Tool } from './types.js';
+
+export const fileCheckoutTools: Tool[] = [
+	{
+		name: 'checkout_file',
+		description: 'Check out a file for editing. Prevents other agents from editing the same file until checked in. ALWAYS checkout files before making changes to prevent conflicts.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				file_path: {
+					type: 'string',
+					description: 'Relative path to the file to checkout (e.g., "src/index.ts")',
+				},
+				reason: {
+					type: 'string',
+					description: 'Optional reason for checkout (e.g., "Fixing bug in login flow")',
+				},
+			},
+			required: ['project_id', 'file_path'],
+		},
+	},
+	{
+		name: 'checkin_file',
+		description: 'Check in a file after editing. Releases the file for other agents to edit. ALWAYS checkin files when done editing.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				checkout_id: {
+					type: 'string',
+					description: 'Checkout UUID (from checkout_file response)',
+				},
+				project_id: {
+					type: 'string',
+					description: 'Project UUID (alternative to checkout_id)',
+				},
+				file_path: {
+					type: 'string',
+					description: 'File path (use with project_id as alternative to checkout_id)',
+				},
+				summary: {
+					type: 'string',
+					description: 'Optional summary of changes made',
+				},
+			},
+		},
+	},
+	{
+		name: 'get_file_checkouts',
+		description: 'Get list of file checkouts for a project. Shows which files are currently checked out and by whom.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				status: {
+					type: 'string',
+					enum: ['checked_out', 'checked_in', 'abandoned'],
+					description: 'Filter by status (default: checked_out)',
+				},
+				include_completed: {
+					type: 'boolean',
+					description: 'Include checked_in and abandoned checkouts (default: false)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max checkouts to return (default: 50)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Number of checkouts to skip for pagination (default 0)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'abandon_checkout',
+		description: 'Force-release a checkout. Use when the original agent session died or is stuck.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				checkout_id: {
+					type: 'string',
+					description: 'Checkout UUID to abandon',
+				},
+				reason: {
+					type: 'string',
+					description: 'Reason for abandoning (e.g., "Agent session died")',
+				},
+			},
+			required: ['checkout_id'],
+		},
+	},
+	{
+		name: 'is_file_available',
+		description: 'Check if a file is available for checkout. Returns who has it checked out if not available.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				file_path: {
+					type: 'string',
+					description: 'Path to the file to check',
+				},
+			},
+			required: ['project_id', 'file_path'],
+		},
+	},
+	{
+		name: 'get_file_checkouts_stats',
+		description:
+			'Get aggregate statistics about file checkouts for a project. Returns counts by status without the actual checkout data. This is much more token-efficient than get_file_checkouts for understanding the overall state.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+];

package/src/tools/findings.ts

@@ -1,101 +1,101 @@
-/**
- * Finding Tool Definitions
- *
- * Tools for managing audit/review findings:
- * - add_finding
- * - get_finding
- * - get_findings
- * - get_findings_stats
- * - update_finding
- * - delete_finding
- */
-
-import type { Tool } from './types.js';
-
-export const findingTools: Tool[] = [
-	{
-		name: 'add_finding',
-		description: 'Record a finding from an audit/review (performance, security, code quality, etc).',
-		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: 'Category of the finding (default: other)' },
-				title: { type: 'string', description: 'Brief title describing the finding' },
-				description: { type: 'string', description: 'Detailed description of the finding, including impact and suggested fix' },
-				severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Severity level (default: info)' },
-				file_path: { type: 'string', description: 'File path where the issue was found (optional)' },
-				line_number: { type: 'number', description: 'Line number in the file (optional)' },
-				related_task_id: { type: 'string', description: 'ID of related task if this finding came from a task (optional)' },
-			},
-			required: ['project_id', 'title'],
-		},
-	},
-	{
-		name: 'get_finding',
-		description: `Get a single finding by ID. More token-efficient than get_findings when you need details for a specific finding.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				finding_id: { type: 'string', description: 'Finding UUID' },
-			},
-			required: ['finding_id'],
-		},
-	},
-	{
-		name: 'get_findings',
-		description: `Get findings for a project, optionally filtered by category, severity, or status. Returns summary fields by default (id, title, category, severity, status). Set summary_only=false for full details. 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: open)' },
-				limit: { type: 'number', description: 'Max number of findings to return (default 10, 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 (default), returns only id, title, category, severity, status. Set to false for full details.' },
-			},
-			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'],
-		},
-	},
-	{
-		name: 'update_finding',
-		description: `Update a finding's status or details. Use to mark findings as addressed or dismissed.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				finding_id: { type: 'string', description: 'Finding UUID' },
-				status: { type: 'string', enum: ['open', 'addressed', 'dismissed', 'wontfix'], description: 'New status' },
-				resolution_note: { type: 'string', description: 'Note explaining how the finding was addressed or why it was dismissed' },
-				title: { type: 'string', description: 'Updated title' },
-				description: { type: 'string', description: 'Updated description' },
-				severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Updated severity' },
-			},
-			required: ['finding_id'],
-		},
-	},
-	{
-		name: 'delete_finding',
-		description: `Delete a finding.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				finding_id: { type: 'string', description: 'Finding UUID' },
-			},
-			required: ['finding_id'],
-		},
-	},
-];
+/**
+ * Finding Tool Definitions
+ *
+ * Tools for managing audit/review findings:
+ * - add_finding
+ * - get_finding
+ * - get_findings
+ * - get_findings_stats
+ * - update_finding
+ * - delete_finding
+ */
+
+import type { Tool } from './types.js';
+
+export const findingTools: Tool[] = [
+	{
+		name: 'add_finding',
+		description: 'Record a finding from an audit/review (performance, security, code quality, etc).',
+		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: 'Category of the finding (default: other)' },
+				title: { type: 'string', description: 'Brief title describing the finding' },
+				description: { type: 'string', description: 'Detailed description of the finding, including impact and suggested fix' },
+				severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Severity level (default: info)' },
+				file_path: { type: 'string', description: 'File path where the issue was found (optional)' },
+				line_number: { type: 'number', description: 'Line number in the file (optional)' },
+				related_task_id: { type: 'string', description: 'ID of related task if this finding came from a task (optional)' },
+			},
+			required: ['project_id', 'title'],
+		},
+	},
+	{
+		name: 'get_finding',
+		description: `Get a single finding by ID. More token-efficient than get_findings when you need details for a specific finding.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				finding_id: { type: 'string', description: 'Finding UUID' },
+			},
+			required: ['finding_id'],
+		},
+	},
+	{
+		name: 'get_findings',
+		description: `Get findings for a project, optionally filtered by category, severity, or status. Returns summary fields by default (id, title, category, severity, status). Set summary_only=false for full details. 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: open)' },
+				limit: { type: 'number', description: 'Max number of findings to return (default 10, 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 (default), returns only id, title, category, severity, status. Set to false for full details.' },
+			},
+			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'],
+		},
+	},
+	{
+		name: 'update_finding',
+		description: `Update a finding's status or details. Use to mark findings as addressed or dismissed.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				finding_id: { type: 'string', description: 'Finding UUID' },
+				status: { type: 'string', enum: ['open', 'addressed', 'dismissed', 'wontfix'], description: 'New status' },
+				resolution_note: { type: 'string', description: 'Note explaining how the finding was addressed or why it was dismissed' },
+				title: { type: 'string', description: 'Updated title' },
+				description: { type: 'string', description: 'Updated description' },
+				severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Updated severity' },
+			},
+			required: ['finding_id'],
+		},
+	},
+	{
+		name: 'delete_finding',
+		description: `Delete a finding.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				finding_id: { type: 'string', description: 'Finding UUID' },
+			},
+			required: ['finding_id'],
+		},
+	},
+];