@vibescope/mcp-server 0.4.5 → 0.4.7

package/src/tools/bodies-of-work.ts

@@ -1,283 +1,283 @@
-/**
- * Bodies of Work Tool Definitions
- *
- * Tools for managing grouped task collections:
- * - create_body_of_work
- * - update_body_of_work
- * - get_body_of_work
- * - get_bodies_of_work
- * - delete_body_of_work
- * - add_task_to_body_of_work
- * - remove_task_from_body_of_work
- * - activate_body_of_work
- * - add_task_dependency
- * - remove_task_dependency
- * - get_task_dependencies
- * - get_next_body_of_work_task
- */
-
-import type { Tool } from './types.js';
-
-export const bodiesOfWorkTools: Tool[] = [
-	{
-		name: 'create_body_of_work',
-		description: `Create a new body of work to group tasks into phases (pre/core/post).
-Bodies of work allow organizing related tasks with optional auto-deployment on completion.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				title: {
-					type: 'string',
-					description: 'Title for the body of work',
-				},
-				description: {
-					type: 'string',
-					description: 'Optional description',
-				},
-				auto_deploy_on_completion: {
-					type: 'boolean',
-					description: 'Automatically request deployment when all tasks complete (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)',
-				},
-				deploy_trigger: {
-					type: 'string',
-					enum: ['all_completed', 'all_completed_validated'],
-					description: 'When to trigger auto-deploy: all_completed (immediate) or all_completed_validated (requires validation, default)',
-				},
-			},
-			required: ['project_id', 'title'],
-		},
-	},
-	{
-		name: 'update_body_of_work',
-		description: `Update a body of work's settings.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				body_of_work_id: {
-					type: 'string',
-					description: 'Body of work UUID',
-				},
-				title: {
-					type: 'string',
-					description: 'Updated title',
-				},
-				description: {
-					type: 'string',
-					description: 'Updated description',
-				},
-				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',
-				},
-				deploy_trigger: {
-					type: 'string',
-					enum: ['all_completed', 'all_completed_validated'],
-					description: 'When to trigger auto-deploy',
-				},
-			},
-			required: ['body_of_work_id'],
-		},
-	},
-	{
-		name: 'get_body_of_work',
-		description: `Get a body of work with all its tasks organized by phase.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				body_of_work_id: {
-					type: 'string',
-					description: 'Body of work UUID',
-				},
-			},
-			required: ['body_of_work_id'],
-		},
-	},
-	{
-		name: 'get_bodies_of_work',
-		description: `List bodies of work for a project with task counts per phase.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				status: {
-					type: 'string',
-					enum: ['draft', 'active', 'completed', 'cancelled'],
-					description: 'Filter by status (optional)',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'delete_body_of_work',
-		description: `Delete a body of work. Tasks are preserved but no longer grouped.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				body_of_work_id: {
-					type: 'string',
-					description: 'Body of work UUID',
-				},
-			},
-			required: ['body_of_work_id'],
-		},
-	},
-	{
-		name: 'add_task_to_body_of_work',
-		description: `Add a task to a body of work in a specific phase.
-Phases control execution order: pre tasks run first, then core, then post.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				body_of_work_id: {
-					type: 'string',
-					description: 'Body of work UUID',
-				},
-				task_id: {
-					type: 'string',
-					description: 'Task UUID to add',
-				},
-				phase: {
-					type: 'string',
-					enum: ['pre', 'core', 'post'],
-					description: 'Task phase (default: core)',
-				},
-				order_index: {
-					type: 'number',
-					description: 'Order within phase (auto-assigned if not specified)',
-				},
-			},
-			required: ['body_of_work_id', 'task_id'],
-		},
-	},
-	{
-		name: 'remove_task_from_body_of_work',
-		description: `Remove a task from its body of work. The task is preserved.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				task_id: {
-					type: 'string',
-					description: 'Task UUID to remove',
-				},
-			},
-			required: ['task_id'],
-		},
-	},
-	{
-		name: 'activate_body_of_work',
-		description: `Activate a draft body of work to start execution.
-Requires at least one task. Once active, tasks can be worked on following phase order.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				body_of_work_id: {
-					type: 'string',
-					description: 'Body of work UUID',
-				},
-			},
-			required: ['body_of_work_id'],
-		},
-	},
-	{
-		name: 'add_task_dependency',
-		description: `Add a dependency between tasks in a body of work.
-The dependent task cannot start until the dependency is completed. Prevents circular dependencies.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				body_of_work_id: {
-					type: 'string',
-					description: 'Body of work UUID',
-				},
-				task_id: {
-					type: 'string',
-					description: 'Task that depends on another task',
-				},
-				depends_on_task_id: {
-					type: 'string',
-					description: 'Task that must complete first',
-				},
-			},
-			required: ['body_of_work_id', 'task_id', 'depends_on_task_id'],
-		},
-	},
-	{
-		name: 'remove_task_dependency',
-		description: `Remove a dependency between tasks.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				task_id: {
-					type: 'string',
-					description: 'Task UUID',
-				},
-				depends_on_task_id: {
-					type: 'string',
-					description: 'Dependency task UUID',
-				},
-			},
-			required: ['task_id', 'depends_on_task_id'],
-		},
-	},
-	{
-		name: 'get_task_dependencies',
-		description: `Get task dependencies for a body of work or specific task.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				body_of_work_id: {
-					type: 'string',
-					description: 'Body of work UUID (optional if task_id provided)',
-				},
-				task_id: {
-					type: 'string',
-					description: 'Specific task UUID (optional if body_of_work_id provided)',
-				},
-			},
-		},
-	},
-	{
-		name: 'get_next_body_of_work_task',
-		description: `Get the next available task from a body of work.
-Considers phase order (pre → core → post) and task dependencies.
-Only returns tasks where all dependencies are completed.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				body_of_work_id: {
-					type: 'string',
-					description: 'Body of work UUID',
-				},
-			},
-			required: ['body_of_work_id'],
-		},
-	},
-];
+/**
+ * Bodies of Work Tool Definitions
+ *
+ * Tools for managing grouped task collections:
+ * - create_body_of_work
+ * - update_body_of_work
+ * - get_body_of_work
+ * - get_bodies_of_work
+ * - delete_body_of_work
+ * - add_task_to_body_of_work
+ * - remove_task_from_body_of_work
+ * - activate_body_of_work
+ * - add_task_dependency
+ * - remove_task_dependency
+ * - get_task_dependencies
+ * - get_next_body_of_work_task
+ */
+
+import type { Tool } from './types.js';
+
+export const bodiesOfWorkTools: Tool[] = [
+	{
+		name: 'create_body_of_work',
+		description: `Create a new body of work to group tasks into phases (pre/core/post).
+Bodies of work allow organizing related tasks with optional auto-deployment on completion.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				title: {
+					type: 'string',
+					description: 'Title for the body of work',
+				},
+				description: {
+					type: 'string',
+					description: 'Optional description',
+				},
+				auto_deploy_on_completion: {
+					type: 'boolean',
+					description: 'Automatically request deployment when all tasks complete (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)',
+				},
+				deploy_trigger: {
+					type: 'string',
+					enum: ['all_completed', 'all_completed_validated'],
+					description: 'When to trigger auto-deploy: all_completed (immediate) or all_completed_validated (requires validation, default)',
+				},
+			},
+			required: ['project_id', 'title'],
+		},
+	},
+	{
+		name: 'update_body_of_work',
+		description: `Update a body of work's settings.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				body_of_work_id: {
+					type: 'string',
+					description: 'Body of work UUID',
+				},
+				title: {
+					type: 'string',
+					description: 'Updated title',
+				},
+				description: {
+					type: 'string',
+					description: 'Updated description',
+				},
+				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',
+				},
+				deploy_trigger: {
+					type: 'string',
+					enum: ['all_completed', 'all_completed_validated'],
+					description: 'When to trigger auto-deploy',
+				},
+			},
+			required: ['body_of_work_id'],
+		},
+	},
+	{
+		name: 'get_body_of_work',
+		description: `Get a body of work with all its tasks organized by phase.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				body_of_work_id: {
+					type: 'string',
+					description: 'Body of work UUID',
+				},
+			},
+			required: ['body_of_work_id'],
+		},
+	},
+	{
+		name: 'get_bodies_of_work',
+		description: `List bodies of work for a project with task counts per phase.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				status: {
+					type: 'string',
+					enum: ['draft', 'active', 'completed', 'cancelled'],
+					description: 'Filter by status (optional)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'delete_body_of_work',
+		description: `Delete a body of work. Tasks are preserved but no longer grouped.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				body_of_work_id: {
+					type: 'string',
+					description: 'Body of work UUID',
+				},
+			},
+			required: ['body_of_work_id'],
+		},
+	},
+	{
+		name: 'add_task_to_body_of_work',
+		description: `Add a task to a body of work in a specific phase.
+Phases control execution order: pre tasks run first, then core, then post.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				body_of_work_id: {
+					type: 'string',
+					description: 'Body of work UUID',
+				},
+				task_id: {
+					type: 'string',
+					description: 'Task UUID to add',
+				},
+				phase: {
+					type: 'string',
+					enum: ['pre', 'core', 'post'],
+					description: 'Task phase (default: core)',
+				},
+				order_index: {
+					type: 'number',
+					description: 'Order within phase (auto-assigned if not specified)',
+				},
+			},
+			required: ['body_of_work_id', 'task_id'],
+		},
+	},
+	{
+		name: 'remove_task_from_body_of_work',
+		description: `Remove a task from its body of work. The task is preserved.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID to remove',
+				},
+			},
+			required: ['task_id'],
+		},
+	},
+	{
+		name: 'activate_body_of_work',
+		description: `Activate a draft body of work to start execution.
+Requires at least one task. Once active, tasks can be worked on following phase order.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				body_of_work_id: {
+					type: 'string',
+					description: 'Body of work UUID',
+				},
+			},
+			required: ['body_of_work_id'],
+		},
+	},
+	{
+		name: 'add_task_dependency',
+		description: `Add a dependency between tasks in a body of work.
+The dependent task cannot start until the dependency is completed. Prevents circular dependencies.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				body_of_work_id: {
+					type: 'string',
+					description: 'Body of work UUID',
+				},
+				task_id: {
+					type: 'string',
+					description: 'Task that depends on another task',
+				},
+				depends_on_task_id: {
+					type: 'string',
+					description: 'Task that must complete first',
+				},
+			},
+			required: ['body_of_work_id', 'task_id', 'depends_on_task_id'],
+		},
+	},
+	{
+		name: 'remove_task_dependency',
+		description: `Remove a dependency between tasks.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID',
+				},
+				depends_on_task_id: {
+					type: 'string',
+					description: 'Dependency task UUID',
+				},
+			},
+			required: ['task_id', 'depends_on_task_id'],
+		},
+	},
+	{
+		name: 'get_task_dependencies',
+		description: `Get task dependencies for a body of work or specific task.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				body_of_work_id: {
+					type: 'string',
+					description: 'Body of work UUID (optional if task_id provided)',
+				},
+				task_id: {
+					type: 'string',
+					description: 'Specific task UUID (optional if body_of_work_id provided)',
+				},
+			},
+		},
+	},
+	{
+		name: 'get_next_body_of_work_task',
+		description: `Get the next available task from a body of work.
+Considers phase order (pre → core → post) and task dependencies.
+Only returns tasks where all dependencies are completed.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				body_of_work_id: {
+					type: 'string',
+					description: 'Body of work UUID',
+				},
+			},
+			required: ['body_of_work_id'],
+		},
+	},
+];

package/src/tools/chat.ts

@@ -1,46 +1,72 @@
-/**
- * Project chat tools:
- * - send_project_message
- * - get_project_messages
- */
-
-import type { Tool } from './types.js';
-
-export const chatTools: Tool[] = [
-	{
-		name: 'send_project_message',
-		description: 'Send a message to the project chat channel. All agents and the project owner can see messages here. Use this to communicate status updates, ask questions, report blockers, or coordinate with other agents.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				message: {
-					type: 'string',
-					description: 'Message content (supports markdown)',
-				},
-			},
-			required: ['project_id', 'message'],
-		},
-	},
-	{
-		name: 'get_project_messages',
-		description: 'Read recent messages from the project chat channel. Use this to check if the user or other agents have posted anything.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				limit: {
-					type: 'number',
-					description: 'Number of recent messages to fetch (default: 20, max: 100)',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-];
+/**
+ * Project chat tools:
+ * - send_project_message
+ * - get_project_messages
+ * - post_progress
+ */
+
+import type { Tool } from './types.js';
+
+export const chatTools: Tool[] = [
+	{
+		name: 'send_project_message',
+		description: 'Send a message to the project chat channel. All agents and the project owner can see messages here. Use this to communicate status updates, ask questions, report blockers, or coordinate with other agents.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				message: {
+					type: 'string',
+					description: 'Message content (supports markdown)',
+				},
+			},
+			required: ['project_id', 'message'],
+		},
+	},
+	{
+		name: 'get_project_messages',
+		description: 'Read recent messages from the project chat channel. Use this to check if the user or other agents have posted anything.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				limit: {
+					type: 'number',
+					description: 'Number of recent messages to fetch (default: 20, max: 100)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'post_progress',
+		description:
+			'Post a structured progress update to the project chat. Use this at key milestones during your work: when starting a task, creating a PR, hitting a blocker, or completing a task. Messages are attributed to your agent and shown with a type icon.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				message: {
+					type: 'string',
+					description: 'Progress update message (supports markdown)',
+				},
+				type: {
+					type: 'string',
+					enum: ['info', 'milestone', 'blocker', 'question'],
+					description:
+						'Type of update: info (general update), milestone (key achievement), blocker (something blocking progress), question (asking for input). Defaults to info.',
+				},
+			},
+			required: ['project_id', 'message'],
+		},
+	},
+];