@vibescope/mcp-server 0.3.0 → 0.3.3

package/dist/tools/bodies-of-work.js

@@ -0,0 +1,280 @@
+/**
+ * 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
+ */
+export const bodiesOfWorkTools = [
+    {
+        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/dist/tools/cloud-agents.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cloud Agent Tool Definitions
+ *
+ * Tools for managing cloud-spawned agents:
+ * - cleanup_stale_cloud_agents
+ * - list_cloud_agents
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const cloudAgentTools: Tool[];

package/dist/tools/cloud-agents.js

@@ -0,0 +1,67 @@
+/**
+ * Cloud Agent Tool Definitions
+ *
+ * Tools for managing cloud-spawned agents:
+ * - cleanup_stale_cloud_agents
+ * - list_cloud_agents
+ */
+export const cloudAgentTools = [
+    {
+        name: 'cleanup_stale_cloud_agents',
+        description: `Clean up stale cloud agents that failed to start or lost connection.
+
+Finds agents stuck in 'starting' status (or optionally 'running' with no heartbeat) 
+and marks them as failed. Only operates on the current session's project.
+
+Use this when:
+- You see agents stuck in "starting" status on the dashboard
+- Cloud agents failed to spawn but weren't cleaned up
+- You want to clear ghost agents from a previous session
+
+SECURITY: This only affects agents in YOUR current project. Cannot access other users' projects.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID (required)'
+                },
+                stale_minutes: {
+                    type: 'number',
+                    description: 'Consider agents stale after this many minutes (default: 5)'
+                },
+                include_running: {
+                    type: 'boolean',
+                    description: 'Also clean up "running" agents with no recent heartbeat (default: false)'
+                },
+                dry_run: {
+                    type: 'boolean',
+                    description: 'If true, just report what would be cleaned without actually cleaning (default: false)'
+                }
+            },
+            required: ['project_id']
+        }
+    },
+    {
+        name: 'list_cloud_agents',
+        description: `List cloud agents for a project.
+
+Returns all spawned cloud agents for the project with their current status.
+Use this to check the state of cloud agents before/after cleanup.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID (required)'
+                },
+                status: {
+                    type: 'string',
+                    enum: ['starting', 'running', 'stopped', 'failed', 'all'],
+                    description: 'Filter by status (default: all)'
+                }
+            },
+            required: ['project_id']
+        }
+    }
+];

package/dist/tools/connectors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Connector Tool Definitions
+ *
+ * Tools for external integrations (Slack, Discord, webhooks, etc.):
+ * - get_connectors
+ * - get_connector
+ * - add_connector
+ * - update_connector
+ * - delete_connector
+ * - test_connector
+ * - get_connector_events
+ */
+import type { Tool } from './types.js';
+export declare const connectorTools: Tool[];

package/dist/tools/connectors.js

@@ -0,0 +1,188 @@
+/**
+ * Connector Tool Definitions
+ *
+ * Tools for external integrations (Slack, Discord, webhooks, etc.):
+ * - get_connectors
+ * - get_connector
+ * - add_connector
+ * - update_connector
+ * - delete_connector
+ * - test_connector
+ * - get_connector_events
+ */
+export const connectorTools = [
+    {
+        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/dist/tools/cost.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cost Tool Definitions
+ *
+ * Tools for cost monitoring and alerts:
+ * - get_cost_summary
+ * - add_cost_alert
+ * - update_cost_alert
+ * - delete_cost_alert
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const costTools: Tool[];

package/dist/tools/cost.js

@@ -0,0 +1,108 @@
+/**
+ * Cost Tool Definitions
+ *
+ * Tools for cost monitoring and alerts:
+ * - get_cost_summary
+ * - add_cost_alert
+ * - update_cost_alert
+ * - delete_cost_alert
+ */
+export const costTools = [
+    {
+        name: 'get_cost_summary',
+        description: 'Get cost summary (daily/weekly/monthly) for a project.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                period: {
+                    type: 'string',
+                    enum: ['daily', 'weekly', 'monthly'],
+                    description: 'Summary period (default: daily)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max records to return (default: 30)',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'add_cost_alert',
+        description: 'Add a cost alert threshold.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID (null for all projects)',
+                },
+                threshold_amount: {
+                    type: 'number',
+                    description: 'Amount in USD that triggers the alert',
+                },
+                threshold_period: {
+                    type: 'string',
+                    enum: ['daily', 'weekly', 'monthly'],
+                    description: 'Period for the threshold',
+                },
+                alert_type: {
+                    type: 'string',
+                    enum: ['warning', 'critical'],
+                    description: 'Alert severity (default: warning)',
+                },
+            },
+            required: ['threshold_amount', 'threshold_period'],
+        },
+    },
+    {
+        name: 'update_cost_alert',
+        description: 'Update a cost alert.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                alert_id: {
+                    type: 'string',
+                    description: 'Alert UUID',
+                },
+                threshold_amount: {
+                    type: 'number',
+                    description: 'New threshold amount in USD',
+                },
+                threshold_period: {
+                    type: 'string',
+                    enum: ['daily', 'weekly', 'monthly'],
+                    description: 'New period',
+                },
+                alert_type: {
+                    type: 'string',
+                    enum: ['warning', 'critical'],
+                    description: 'New alert type',
+                },
+                enabled: {
+                    type: 'boolean',
+                    description: 'Enable or disable the alert',
+                },
+            },
+            required: ['alert_id'],
+        },
+    },
+    {
+        name: 'delete_cost_alert',
+        description: 'Delete a cost alert.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                alert_id: {
+                    type: 'string',
+                    description: 'Alert UUID to delete',
+                },
+            },
+            required: ['alert_id'],
+        },
+    },
+];

package/dist/tools/decisions.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Decision Tool Definitions
+ *
+ * Tools for recording architectural and technical decisions:
+ * - log_decision
+ * - get_decision
+ * - get_decisions
+ * - get_decisions_stats
+ * - delete_decision
+ */
+import type { Tool } from './types.js';
+export declare const decisionTools: Tool[];