@vibescope/mcp-server 0.2.1 → 0.2.2

package/src/tools.ts

@@ -8,7 +8,9 @@ export const tools: Tool[] = [
 	{
 		name: 'start_work_session',
 		description: `CALL THIS FIRST when beginning work on a project.
-Returns session info, persona, role, and next task. Use mode:'full' for complete context.`,
+Returns session info, persona, role, and next_task. Start the next_task IMMEDIATELY without asking the user.
+
+Use mode:'full' for complete context, mode:'lite' (default) for minimal tokens.`,
 		inputSchema: {
 			type: 'object',
 			properties: {
@@ -190,6 +192,40 @@ Returns session info, persona, role, and next task. Use mode:'full' for complete
 			required: ['project_id'],
 		},
 	},
+	{
+		name: 'get_body_of_work_costs',
+		description: 'Get cost breakdown by body of work with phase-level details. Returns costs for pre/core/post phases and model breakdown.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				body_of_work_id: {
+					type: 'string',
+					description: 'Body of work UUID (optional if project_id provided)',
+				},
+				project_id: {
+					type: 'string',
+					description: 'Project UUID to get all body of work costs (optional if body_of_work_id provided)',
+				},
+			},
+		},
+	},
+	{
+		name: 'get_sprint_costs',
+		description: 'Get cost breakdown by sprint with velocity metrics. Returns cost per story point and phase breakdown.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				sprint_id: {
+					type: 'string',
+					description: 'Sprint UUID (optional if project_id provided)',
+				},
+				project_id: {
+					type: 'string',
+					description: 'Project UUID to get all sprint costs (optional if sprint_id provided)',
+				},
+			},
+		},
+	},
 	// Knowledge Base Query Tool
 	{
 		name: 'query_knowledge_base',
@@ -234,7 +270,7 @@ Returns session info, persona, role, and next task. Use mode:'full' for complete
 			properties: {
 				category: {
 					type: 'string',
-					enum: ['session', 'project', 'tasks', 'milestones', 'progress', 'blockers', 'decisions', 'ideas', 'findings', 'validation', 'deployment', 'fallback', 'requests', 'organizations', 'cost', 'knowledge'],
+					enum: ['session', 'project', 'tasks', 'milestones', 'progress', 'blockers', 'decisions', 'ideas', 'findings', 'validation', 'deployment', 'fallback', 'bodies_of_work', 'sprints', 'requests', 'organizations', 'cost', 'git_issues', 'knowledge', 'discovery', 'subtasks', 'worktrees', 'roles', 'file_locks'],
 					description: 'Category to list (omit for all categories)',
 				},
 			},
@@ -430,7 +466,9 @@ Returns session info, persona, role, and next task. Use mode:'full' for complete
 	},
 	{
 		name: 'get_next_task',
-		description: 'Get highest priority pending task. Skips claimed tasks. Check deployment_blocks_tasks first.',
+		description: `Get highest priority pending task. Start it IMMEDIATELY by calling update_task(task_id, status: "in_progress").
+
+Do NOT ask the user for permission. Follow the directive in the response.`,
 		inputSchema: {
 			type: 'object',
 			properties: {
@@ -486,7 +524,13 @@ Returns session info, persona, role, and next task. Use mode:'full' for complete
 	},
 	{
 		name: 'update_task',
-		description: 'Update task status, progress, or details. Include progress_note with progress_percentage.',
+		description: `Update task status, progress, or details. Include progress_note with progress_percentage.
+
+IMPORTANT: When setting status to "in_progress", you MUST provide git_branch AND worktree_path to enable cleanup tracking.
+Create worktree first: git worktree add ../PROJECT-task-TASKID -b feature/TASKID-description BASE_BRANCH
+Then call: update_task(task_id, status: "in_progress", git_branch: "feature/TASKID-description", worktree_path: "../PROJECT-task-TASKID")
+
+For projects without git branching (trunk-based or none), use skip_worktree_requirement: true.`,
 		inputSchema: {
 			type: 'object',
 			properties: {
@@ -522,20 +566,35 @@ Returns session info, persona, role, and next task. Use mode:'full' for complete
 				},
 				git_branch: {
 					type: 'string',
-					description: 'Git branch associated with this task',
+					description: 'Git branch associated with this task. REQUIRED when status is "in_progress" (unless skip_worktree_requirement is true)',
+				},
+				worktree_path: {
+					type: 'string',
+					description: 'Git worktree path for this task (e.g., "../project-task-abc123"). Store this for cleanup tracking across sessions.',
 				},
 				model_capability: {
 					type: 'string',
 					enum: ['haiku', 'sonnet', 'opus'],
 					description: 'Recommended model capability: haiku (simple tasks), sonnet (standard), opus (complex reasoning)',
 				},
+				skip_worktree_requirement: {
+					type: 'boolean',
+					description: 'Skip git_branch requirement for projects without branching workflows (trunk-based or none). Default: false',
+				},
 			},
 			required: ['task_id'],
 		},
 	},
 	{
 		name: 'complete_task',
-		description: 'Mark task done. Returns next_task and context counts (validation, blockers, deployment).',
+		description: `Mark task done. Returns next_task which you MUST start immediately without asking the user.
+
+CRITICAL: After calling this tool, you must:
+1. If next_task is returned → Start it immediately by calling update_task(task_id, status: "in_progress")
+2. If no next_task → Call get_next_task() or start a fallback_activity
+3. NEVER ask the user "What should I do next?" or "Should I continue?"
+
+The auto_continue: true flag in the response means you are expected to continue working autonomously.`,
 		inputSchema: {
 			type: 'object',
 			properties: {
@@ -1107,6 +1166,46 @@ Returns subtasks with aggregate completion stats.`,
 			required: ['parent_task_id'],
 		},
 	},
+	{
+		name: 'get_stale_worktrees',
+		description: `Get worktrees that need cleanup.
+
+Returns tasks with worktree_path set where:
+- Task is completed or cancelled (worktree should have been cleaned up)
+- Task has been abandoned (no activity for 24+ hours while in_progress)
+
+IMPORTANT: Call this on session start to clean up orphaned worktrees from previous sessions.
+For each stale worktree:
+1. Run: git worktree remove <worktree_path>
+2. Call: clear_worktree_path(task_id)`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'clear_worktree_path',
+		description: `Clear the worktree_path from a task after cleanup.
+
+Call this AFTER removing the worktree with git worktree remove.
+This marks the task as cleaned up so it won't appear in get_stale_worktrees.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID',
+				},
+			},
+			required: ['task_id'],
+		},
+	},
 	{
 		name: 'heartbeat',
 		description: `Send heartbeat to maintain 'active' status. Call every 30-60 seconds.`,
@@ -1435,8 +1534,14 @@ Returns subtasks with aggregate completion stats.`,
 				},
 				schedule_type: {
 					type: 'string',
-					description: 'Schedule type: once (one-time), daily, weekly, or monthly',
-					enum: ['once', 'daily', 'weekly', 'monthly'],
+					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',
@@ -1499,7 +1604,13 @@ Returns subtasks with aggregate completion stats.`,
 				schedule_type: {
 					type: 'string',
 					description: 'New schedule type',
-					enum: ['once', 'daily', 'weekly', 'monthly'],
+					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',
@@ -1597,6 +1708,7 @@ Returns subtasks with aggregate completion stats.`,
 						'documentation_review',
 						'dependency_audit',
 						'validate_completed_tasks',
+						'worktree_cleanup',
 					],
 				},
 			},
@@ -2915,5 +3027,182 @@ Returns committed vs completed points and average velocity.`,
 			required: ['git_issue_id'],
 		},
 	},
+	// ============================================================================
+	// Connector Tools (External Integrations)
+	// ============================================================================
+	{
+		name: 'get_connectors',
+		description: `List connectors for a project. Connectors enable sending events to external services (Slack, Discord, webhooks, etc.).`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				type: {
+					type: 'string',
+					enum: ['webhook', 'slack', 'discord', 'github', 'custom'],
+					description: 'Filter by connector type (optional)',
+				},
+				status: {
+					type: 'string',
+					enum: ['active', 'disabled'],
+					description: 'Filter by status (optional)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max connectors to return (default: 50)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Pagination offset (default: 0)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'get_connector',
+		description: `Get a single connector with full details including configuration (sensitive fields are masked).`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				connector_id: {
+					type: 'string',
+					description: 'Connector UUID',
+				},
+			},
+			required: ['connector_id'],
+		},
+	},
+	{
+		name: 'add_connector',
+		description: `Add a new connector for external integrations. Supports webhook, Slack, Discord, GitHub, and custom connectors.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				name: {
+					type: 'string',
+					description: 'Connector name (e.g., "Slack Notifications")',
+				},
+				type: {
+					type: 'string',
+					enum: ['webhook', 'slack', 'discord', 'github', 'custom'],
+					description: 'Connector type',
+				},
+				description: {
+					type: 'string',
+					description: 'Optional description',
+				},
+				config: {
+					type: 'object',
+					description: 'Type-specific configuration (e.g., { webhook_url: "..." } for Slack)',
+				},
+				events: {
+					type: 'object',
+					description: 'Event subscriptions (e.g., { task_completed: true, blocker_added: true })',
+				},
+			},
+			required: ['project_id', 'name', 'type'],
+		},
+	},
+	{
+		name: 'update_connector',
+		description: `Update a connector's configuration, events, or status.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				connector_id: {
+					type: 'string',
+					description: 'Connector UUID',
+				},
+				name: {
+					type: 'string',
+					description: 'Updated name',
+				},
+				description: {
+					type: 'string',
+					description: 'Updated description',
+				},
+				config: {
+					type: 'object',
+					description: 'Updated configuration (merged with existing)',
+				},
+				events: {
+					type: 'object',
+					description: 'Updated event subscriptions',
+				},
+				status: {
+					type: 'string',
+					enum: ['active', 'disabled'],
+					description: 'Enable or disable the connector',
+				},
+			},
+			required: ['connector_id'],
+		},
+	},
+	{
+		name: 'delete_connector',
+		description: `Delete a connector.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				connector_id: {
+					type: 'string',
+					description: 'Connector UUID',
+				},
+			},
+			required: ['connector_id'],
+		},
+	},
+	{
+		name: 'test_connector',
+		description: `Test a connector by sending a test event. Returns success/failure status.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				connector_id: {
+					type: 'string',
+					description: 'Connector UUID to test',
+				},
+			},
+			required: ['connector_id'],
+		},
+	},
+	{
+		name: 'get_connector_events',
+		description: `Get event history for a connector or project. Shows delivery status and errors.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				connector_id: {
+					type: 'string',
+					description: 'Connector UUID (optional if project_id provided)',
+				},
+				project_id: {
+					type: 'string',
+					description: 'Project UUID (optional if connector_id provided)',
+				},
+				status: {
+					type: 'string',
+					enum: ['pending', 'sent', 'failed', 'retrying'],
+					description: 'Filter by delivery status (optional)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max events to return (default: 50)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Pagination offset (default: 0)',
+				},
+			},
+		},
+	},
 ];
 

package/src/utils.test.ts

@@ -43,8 +43,8 @@ describe('AGENT_PERSONAS', () => {
 // ============================================================================
 
 describe('FALLBACK_ACTIVITIES', () => {
-	it('should have 11 activities', () => {
-		expect(FALLBACK_ACTIVITIES).toHaveLength(11);
+	it('should have 12 activities', () => {
+		expect(FALLBACK_ACTIVITIES).toHaveLength(12);
 	});
 
 	it('should have required fields on each activity', () => {

package/src/utils.ts

@@ -133,6 +133,23 @@ export const FALLBACK_ACTIVITIES = [
 		description: 'Review tasks completed by other agents to ensure quality.',
 		prompt: 'Call get_tasks_awaiting_validation to find completed tasks that need review. Validate each one by checking the implementation and running tests if applicable.',
 	},
+	{
+		activity: 'worktree_cleanup',
+		title: 'Clean up stale worktrees',
+		description: 'Find and remove git worktrees from completed or abandoned tasks.',
+		prompt: `Clean up stale git worktrees to reclaim disk space and prevent confusion:
+
+1. Call get_stale_worktrees(project_id) to find worktrees needing cleanup
+2. For each stale worktree returned:
+   a. Check if the worktree directory exists: ls -la <worktree_path>
+   b. If it exists, remove it: git worktree remove <worktree_path>
+   c. If removal fails (untracked files), use: git worktree remove --force <worktree_path>
+   d. Call clear_worktree_path(task_id) to mark it as cleaned up
+3. Run 'git worktree list' to verify cleanup
+4. Log any issues encountered with add_blocker if worktrees cannot be removed
+
+This prevents disk bloat from accumulated worktrees and keeps the workspace clean.`,
+	},
 ] as const;
 
 export type FallbackActivity = typeof FALLBACK_ACTIVITIES[number];