@vibescope/mcp-server 0.4.9 → 0.5.1

package/src/tools/project.ts

@@ -1,210 +1,210 @@
-/**
- * Project Tool Definitions
- *
- * Tools for project management:
- * - get_project_context
- * - get_git_workflow
- * - create_project
- * - update_project
- * - update_project_readme
- * - get_project_summary
- */
-
-import type { Tool } from './types.js';
-
-export const projectTools: Tool[] = [
-	{
-		name: 'get_project_context',
-		description: 'Get full project context: goals, instructions, tasks, blockers, decisions.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID. If not provided, will list all projects.',
-				},
-				git_url: {
-					type: 'string',
-					description: 'Git repository URL. Used to find project if project_id not provided.',
-				},
-			},
-		},
-	},
-	{
-		name: 'get_git_workflow',
-		description: 'Get git workflow config and branching instructions for the project.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				task_id: {
-					type: 'string',
-					description: 'Optional task ID to include branch naming suggestion',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'create_project',
-		description: 'Create a new project to track in Vibescope.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				name: {
-					type: 'string',
-					description: 'Project display name',
-				},
-				description: {
-					type: 'string',
-					description: 'Brief project description',
-				},
-				goal: {
-					type: 'string',
-					description: 'High-level project goal or purpose (e.g. "A multiplayer card game platform")',
-				},
-				git_url: {
-					type: 'string',
-					description: 'Git repository URL (if available)',
-				},
-				tech_stack: {
-					type: 'array',
-					items: { type: 'string' },
-					description: 'Technologies used (e.g., ["TypeScript", "React", "PostgreSQL"])',
-				},
-			},
-			required: ['name'],
-		},
-	},
-	{
-		name: 'update_project',
-		description: 'Update project details (name, description, goal, settings).',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				name: { type: 'string', description: 'Project name' },
-				description: { type: 'string', description: 'Project description' },
-				goal: { type: 'string', description: 'Project goal or objective' },
-				git_url: { type: 'string', description: 'Git repository URL' },
-				tech_stack: {
-					type: 'array',
-					items: { type: 'string' },
-					description: 'List of technologies used in the project',
-				},
-				status: {
-					type: 'string',
-					enum: ['active', 'paused', 'completed', 'archived'],
-					description: 'Project status',
-				},
-				git_workflow: {
-					type: 'string',
-					enum: ['none', 'trunk-based', 'github-flow', 'git-flow'],
-					description: 'Git workflow: none (no branching), trunk-based (commit to main), github-flow (feature branches + PR), git-flow (develop/release branches)',
-				},
-				git_main_branch: {
-					type: 'string',
-					description: 'Main branch name (default: main)',
-				},
-				git_develop_branch: {
-					type: 'string',
-					description: 'Development branch name (used with git-flow)',
-				},
-				git_auto_branch: {
-					type: 'boolean',
-					description: 'Automatically create feature branches for new tasks',
-				},
-				git_auto_tag: {
-					type: 'boolean',
-					description: 'Automatically tag deployments on main branch',
-				},
-				deployment_instructions: {
-					type: 'string',
-					description: 'Instructions for how to deploy (e.g., "Push to main for Vercel auto-deploy", "Run fly deploy")',
-				},
-				git_delete_branch_on_merge: {
-					type: 'boolean',
-					description: 'Delete feature branch after PR merge (default: true)',
-				},
-				require_pr_for_validation: {
-					type: 'boolean',
-					description: 'Require PR exists before task validation can be approved (default: true for github-flow/git-flow)',
-				},
-				auto_merge_on_approval: {
-					type: 'boolean',
-					description: 'Automatically merge PR when validator approves (default: true)',
-				},
-				validation_required: {
-					type: 'boolean',
-					description: 'Completed tasks require validation before being considered done (default: true)',
-				},
-				default_task_priority: {
-					type: 'integer',
-					minimum: 1,
-					maximum: 5,
-					description: 'Default priority for new tasks when not specified (1=highest, 5=lowest, default: 3)',
-				},
-				require_time_estimates: {
-					type: 'boolean',
-					description: 'Require estimated_minutes when creating tasks (default: false)',
-				},
-				fallback_activities_enabled: {
-					type: 'boolean',
-					description: 'Allow agents to perform background activities when no tasks available (default: true)',
-				},
-				preferred_fallback_activities: {
-					type: 'array',
-					items: { type: 'string' },
-					description: 'Array of preferred fallback activities (e.g., ["code_review", "security_review"]). Null means all allowed.',
-				},
-				allow_local_agent_task_creation: {
-					type: 'boolean',
-					description: 'Allow local agents (running on developer machine) to create tasks via add_task (default: true).',
-				},
-				allow_cloud_agent_task_creation: {
-					type: 'boolean',
-					description: 'Allow cloud/remote agents to create tasks via add_task (default: false).',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'update_project_readme',
-		description: 'Sync README content to the dashboard.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				readme_content: {
-					type: 'string',
-					description: 'README content in markdown format',
-				},
-			},
-			required: ['project_id', 'readme_content'],
-		},
-	},
-	{
-		name: 'get_project_summary',
-		description: 'Get a unified project overview with aggregated stats. Token-efficient way to get task counts, blockers, findings, active agents, and more in a single call.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-];
+/**
+ * Project Tool Definitions
+ *
+ * Tools for project management:
+ * - get_project_context
+ * - get_git_workflow
+ * - create_project
+ * - update_project
+ * - update_project_readme
+ * - get_project_summary
+ */
+
+import type { Tool } from './types.js';
+
+export const projectTools: Tool[] = [
+	{
+		name: 'get_project_context',
+		description: 'Get full project context: goals, instructions, tasks, blockers, decisions.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID. If not provided, will list all projects.',
+				},
+				git_url: {
+					type: 'string',
+					description: 'Git repository URL. Used to find project if project_id not provided.',
+				},
+			},
+		},
+	},
+	{
+		name: 'get_git_workflow',
+		description: 'Get git workflow config and branching instructions for the project.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				task_id: {
+					type: 'string',
+					description: 'Optional task ID to include branch naming suggestion',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'create_project',
+		description: 'Create a new project to track in Vibescope.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				name: {
+					type: 'string',
+					description: 'Project display name',
+				},
+				description: {
+					type: 'string',
+					description: 'Brief project description',
+				},
+				goal: {
+					type: 'string',
+					description: 'High-level project goal or purpose (e.g. "A multiplayer card game platform")',
+				},
+				git_url: {
+					type: 'string',
+					description: 'Git repository URL (if available)',
+				},
+				tech_stack: {
+					type: 'array',
+					items: { type: 'string' },
+					description: 'Technologies used (e.g., ["TypeScript", "React", "PostgreSQL"])',
+				},
+			},
+			required: ['name'],
+		},
+	},
+	{
+		name: 'update_project',
+		description: 'Update project details (name, description, goal, settings).',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				name: { type: 'string', description: 'Project name' },
+				description: { type: 'string', description: 'Project description' },
+				goal: { type: 'string', description: 'Project goal or objective' },
+				git_url: { type: 'string', description: 'Git repository URL' },
+				tech_stack: {
+					type: 'array',
+					items: { type: 'string' },
+					description: 'List of technologies used in the project',
+				},
+				status: {
+					type: 'string',
+					enum: ['active', 'paused', 'completed', 'archived'],
+					description: 'Project status',
+				},
+				git_workflow: {
+					type: 'string',
+					enum: ['none', 'trunk-based', 'github-flow', 'git-flow'],
+					description: 'Git workflow: none (no branching), trunk-based (commit to main), github-flow (feature branches + PR), git-flow (develop/release branches)',
+				},
+				git_main_branch: {
+					type: 'string',
+					description: 'Main branch name (default: main)',
+				},
+				git_develop_branch: {
+					type: 'string',
+					description: 'Development branch name (used with git-flow)',
+				},
+				git_auto_branch: {
+					type: 'boolean',
+					description: 'Automatically create feature branches for new tasks',
+				},
+				git_auto_tag: {
+					type: 'boolean',
+					description: 'Automatically tag deployments on main branch',
+				},
+				deployment_instructions: {
+					type: 'string',
+					description: 'Instructions for how to deploy (e.g., "Push to main for Vercel auto-deploy", "Run fly deploy")',
+				},
+				git_delete_branch_on_merge: {
+					type: 'boolean',
+					description: 'Delete feature branch after PR merge (default: true)',
+				},
+				require_pr_for_validation: {
+					type: 'boolean',
+					description: 'Require PR exists before task validation can be approved (default: true for github-flow/git-flow)',
+				},
+				auto_merge_on_approval: {
+					type: 'boolean',
+					description: 'Automatically merge PR when validator approves (default: true)',
+				},
+				validation_required: {
+					type: 'boolean',
+					description: 'Completed tasks require validation before being considered done (default: true)',
+				},
+				default_task_priority: {
+					type: 'integer',
+					minimum: 1,
+					maximum: 5,
+					description: 'Default priority for new tasks when not specified (1=highest, 5=lowest, default: 3)',
+				},
+				require_time_estimates: {
+					type: 'boolean',
+					description: 'Require estimated_minutes when creating tasks (default: false)',
+				},
+				fallback_activities_enabled: {
+					type: 'boolean',
+					description: 'Allow agents to perform background activities when no tasks available (default: true)',
+				},
+				preferred_fallback_activities: {
+					type: 'array',
+					items: { type: 'string' },
+					description: 'Array of preferred fallback activities (e.g., ["code_review", "security_review"]). Null means all allowed.',
+				},
+				allow_local_agent_task_creation: {
+					type: 'boolean',
+					description: 'Allow local agents (running on developer machine) to create tasks via add_task (default: true).',
+				},
+				allow_cloud_agent_task_creation: {
+					type: 'boolean',
+					description: 'Allow cloud/remote agents to create tasks via add_task (default: false).',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'update_project_readme',
+		description: 'Sync README content to the dashboard.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				readme_content: {
+					type: 'string',
+					description: 'README content in markdown format',
+				},
+			},
+			required: ['project_id', 'readme_content'],
+		},
+	},
+	{
+		name: 'get_project_summary',
+		description: 'Get a unified project overview with aggregated stats. Token-efficient way to get task counts, blockers, findings, active agents, and more in a single call.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+];

package/src/tools/requests.ts

@@ -1,68 +1,68 @@
-/**
- * Request Tool Definitions
- *
- * Tools for handling user requests:
- * - get_pending_requests
- * - acknowledge_request
- * - answer_question
- */
-
-import type { Tool } from './types.js';
-
-export const requestTools: Tool[] = [
-	{
-		name: 'get_pending_requests',
-		description: `Get unacknowledged user requests for this agent/project.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				limit: {
-					type: 'number',
-					description: 'Max number of requests to return (default 50, max 200)',
-				},
-				offset: {
-					type: 'number',
-					description: 'Number of requests to skip for pagination (default 0)',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'acknowledge_request',
-		description: `Mark a user request as handled.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				request_id: {
-					type: 'string',
-					description: 'Request UUID to acknowledge',
-				},
-			},
-			required: ['request_id'],
-		},
-	},
-	{
-		name: 'answer_question',
-		description: `Answer a question from the user. Use this when the user has asked a question via the dashboard.
-The answer will be displayed to the user and the question marked as answered.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				request_id: {
-					type: 'string',
-					description: 'Request UUID of the question to answer',
-				},
-				answer: {
-					type: 'string',
-					description: 'Your answer to the user\'s question',
-				},
-			},
-			required: ['request_id', 'answer'],
-		},
-	},
-];
+/**
+ * Request Tool Definitions
+ *
+ * Tools for handling user requests:
+ * - get_pending_requests
+ * - acknowledge_request
+ * - answer_question
+ */
+
+import type { Tool } from './types.js';
+
+export const requestTools: Tool[] = [
+	{
+		name: 'get_pending_requests',
+		description: `Get unacknowledged user requests for this agent/project.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max number of requests to return (default 50, max 200)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Number of requests to skip for pagination (default 0)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'acknowledge_request',
+		description: `Mark a user request as handled.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				request_id: {
+					type: 'string',
+					description: 'Request UUID to acknowledge',
+				},
+			},
+			required: ['request_id'],
+		},
+	},
+	{
+		name: 'answer_question',
+		description: `Answer a question from the user. Use this when the user has asked a question via the dashboard.
+The answer will be displayed to the user and the question marked as answered.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				request_id: {
+					type: 'string',
+					description: 'Request UUID of the question to answer',
+				},
+				answer: {
+					type: 'string',
+					description: 'Your answer to the user\'s question',
+				},
+			},
+			required: ['request_id', 'answer'],
+		},
+	},
+];