@vibescope/mcp-server 0.3.0 → 0.3.3

package/dist/tools/decisions.js

@@ -0,0 +1,108 @@
+/**
+ * Decision Tool Definitions
+ *
+ * Tools for recording architectural and technical decisions:
+ * - log_decision
+ * - get_decision
+ * - get_decisions
+ * - get_decisions_stats
+ * - delete_decision
+ */
+export const decisionTools = [
+    {
+        name: 'log_decision',
+        description: `Record an architectural or technical decision with rationale.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Decision title (e.g., "Use PostgreSQL for database")',
+                },
+                description: {
+                    type: 'string',
+                    description: 'What was decided',
+                },
+                rationale: {
+                    type: 'string',
+                    description: 'Why this decision was made',
+                },
+                alternatives_considered: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Other options that were considered',
+                },
+            },
+            required: ['project_id', 'title', 'description'],
+        },
+    },
+    {
+        name: 'get_decision',
+        description: `Get a single decision by ID. More token-efficient than get_decisions when you need details for a specific decision.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                decision_id: {
+                    type: 'string',
+                    description: 'Decision UUID',
+                },
+            },
+            required: ['decision_id'],
+        },
+    },
+    {
+        name: 'get_decisions',
+        description: `Get recorded decisions for a project.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max number of decisions to return (default 10, max 200)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of decisions to skip for pagination (default 0)',
+                },
+                search_query: {
+                    type: 'string',
+                    description: 'Search decisions by title',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'get_decisions_stats',
+        description: `Get aggregate statistics about decisions for a project. Returns total count. More token-efficient than get_decisions when you just need to know how many decisions exist.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: { type: 'string', description: 'Project UUID' },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'delete_decision',
+        description: `Delete a decision.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                decision_id: {
+                    type: 'string',
+                    description: 'Decision UUID',
+                },
+            },
+            required: ['decision_id'],
+        },
+    },
+];

package/dist/tools/deployment.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Deployment Tool Definitions
+ *
+ * Tools for deployment coordination:
+ * - request_deployment
+ * - claim_deployment_validation
+ * - report_validation
+ * - check_deployment_status
+ * - start_deployment
+ * - complete_deployment
+ * - cancel_deployment
+ * - add_deployment_requirement
+ * - complete_deployment_requirement
+ * - get_deployment_requirements
+ * - get_deployment_requirements_stats
+ * - schedule_deployment
+ * - get_scheduled_deployments
+ * - update_scheduled_deployment
+ * - delete_scheduled_deployment
+ * - trigger_scheduled_deployment
+ * - check_due_deployments
+ */
+import type { Tool } from './types.js';
+export declare const deploymentTools: Tool[];

package/dist/tools/deployment.js

@@ -0,0 +1,439 @@
+/**
+ * Deployment Tool Definitions
+ *
+ * Tools for deployment coordination:
+ * - request_deployment
+ * - claim_deployment_validation
+ * - report_validation
+ * - check_deployment_status
+ * - start_deployment
+ * - complete_deployment
+ * - cancel_deployment
+ * - add_deployment_requirement
+ * - complete_deployment_requirement
+ * - get_deployment_requirements
+ * - get_deployment_requirements_stats
+ * - schedule_deployment
+ * - get_scheduled_deployments
+ * - update_scheduled_deployment
+ * - delete_scheduled_deployment
+ * - trigger_scheduled_deployment
+ * - check_due_deployments
+ */
+export const deploymentTools = [
+    {
+        name: 'request_deployment',
+        description: 'Request a deployment. Requires validation first. One active deployment per project.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                environment: {
+                    type: 'string',
+                    enum: ['development', 'staging', 'production'],
+                    description: 'Target environment (default: production)',
+                },
+                version_bump: {
+                    type: 'string',
+                    enum: ['patch', 'minor', 'major'],
+                    description: 'Version bump: major/minor/patch (default: patch)',
+                },
+                notes: {
+                    type: 'string',
+                    description: 'Optional notes about this deployment',
+                },
+                git_ref: {
+                    type: 'string',
+                    description: 'Git branch or commit being deployed',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'claim_deployment_validation',
+        description: `Claim pending deployment for validation. Run build+tests, then call report_validation.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'report_validation',
+        description: `Report build/test results. If passed, status->'ready'. If failed, creates investigation task.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                build_passed: {
+                    type: 'boolean',
+                    description: 'Whether the build succeeded',
+                },
+                tests_passed: {
+                    type: 'boolean',
+                    description: 'Whether the tests passed',
+                },
+                error_message: {
+                    type: 'string',
+                    description: 'Error details if validation failed',
+                },
+            },
+            required: ['project_id', 'build_passed', 'tests_passed'],
+        },
+    },
+    {
+        name: 'check_deployment_status',
+        description: `Get active deployment status and details.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'start_deployment',
+        description: `Start deployment (requires 'ready' status). Sets status to 'deploying'.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'complete_deployment',
+        description: `Mark deployment as complete (success or failure).`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                success: {
+                    type: 'boolean',
+                    description: 'Whether the deployment succeeded',
+                },
+                summary: {
+                    type: 'string',
+                    description: 'Summary of what was deployed or why it failed',
+                },
+            },
+            required: ['project_id', 'success'],
+        },
+    },
+    {
+        name: 'cancel_deployment',
+        description: `Cancel active deployment. Sets status to 'failed'.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'Reason for cancellation',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'add_deployment_requirement',
+        description: `Add a pre-deployment requirement (migration, env var, config change). These are shown as a checklist before deployment.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                type: {
+                    type: 'string',
+                    description: 'Type of requirement',
+                    enum: ['migration', 'env_var', 'config', 'manual', 'breaking_change', 'agent_task'],
+                },
+                title: {
+                    type: 'string',
+                    description: 'Brief description (e.g., "Run migration: 20250114_token_tracking.sql")',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Optional detailed instructions',
+                },
+                file_path: {
+                    type: 'string',
+                    description: 'Optional file path reference',
+                },
+                stage: {
+                    type: 'string',
+                    description: 'Deployment stage: preparation (default), deployment, or verification',
+                    enum: ['preparation', 'deployment', 'verification'],
+                },
+                blocking: {
+                    type: 'boolean',
+                    description: 'When true, converted task blocks all other work until complete',
+                },
+                recurring: {
+                    type: 'boolean',
+                    description: 'When true, requirement resets to pending when a new deployment is requested',
+                },
+            },
+            required: ['project_id', 'type', 'title'],
+        },
+    },
+    {
+        name: 'complete_deployment_requirement',
+        description: `Mark a deployment requirement as completed.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                requirement_id: {
+                    type: 'string',
+                    description: 'Requirement UUID',
+                },
+            },
+            required: ['requirement_id'],
+        },
+    },
+    {
+        name: 'get_deployment_requirements',
+        description: `Get pending deployment requirements for a project.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                status: {
+                    type: 'string',
+                    description: 'Filter by status (default: pending)',
+                    enum: ['pending', 'completed', 'converted_to_task', 'all'],
+                },
+                stage: {
+                    type: 'string',
+                    description: 'Filter by stage (optional)',
+                    enum: ['preparation', 'deployment', 'verification', 'all'],
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max number of requirements to return (default 50, max 200)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of requirements to skip for pagination (default 0)',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'get_deployment_requirements_stats',
+        description: `Get aggregate statistics about deployment requirements for a project. Returns total count and breakdowns by status, stage, and type. More token-efficient than get_deployment_requirements when you just need to understand the overall state.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: { type: 'string', description: 'Project UUID' },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'schedule_deployment',
+        description: `Schedule a deployment for a specific time. Supports one-time and recurring schedules with auto-trigger or manual trigger modes.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                scheduled_at: {
+                    type: 'string',
+                    description: 'ISO 8601 datetime for when the deployment should be triggered',
+                },
+                schedule_type: {
+                    type: 'string',
+                    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',
+                    description: 'Whether agents should automatically trigger this deployment when due (default: true)',
+                },
+                environment: {
+                    type: 'string',
+                    description: 'Target environment (default: production)',
+                    enum: ['development', 'staging', 'production'],
+                },
+                version_bump: {
+                    type: 'string',
+                    description: 'Version bump: patch, minor, or major (default: patch)',
+                    enum: ['patch', 'minor', 'major'],
+                },
+                notes: {
+                    type: 'string',
+                    description: 'Optional notes about this scheduled deployment',
+                },
+                git_ref: {
+                    type: 'string',
+                    description: 'Optional git branch or commit to deploy',
+                },
+            },
+            required: ['project_id', 'scheduled_at'],
+        },
+    },
+    {
+        name: 'get_scheduled_deployments',
+        description: `Get scheduled deployments for a project.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                include_disabled: {
+                    type: 'boolean',
+                    description: 'Include disabled schedules (default: false)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max schedules to return (default: 50)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of schedules to skip for pagination (default: 0)',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'update_scheduled_deployment',
+        description: `Update a scheduled deployment's configuration.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                schedule_id: {
+                    type: 'string',
+                    description: 'Schedule UUID',
+                },
+                scheduled_at: {
+                    type: 'string',
+                    description: 'New scheduled time (ISO 8601)',
+                },
+                schedule_type: {
+                    type: 'string',
+                    description: 'New schedule type',
+                    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',
+                    description: 'Whether to auto-trigger',
+                },
+                enabled: {
+                    type: 'boolean',
+                    description: 'Enable or disable the schedule',
+                },
+                environment: {
+                    type: 'string',
+                    description: 'Target environment',
+                    enum: ['development', 'staging', 'production'],
+                },
+                version_bump: {
+                    type: 'string',
+                    description: 'Version bump type',
+                    enum: ['patch', 'minor', 'major'],
+                },
+                notes: {
+                    type: 'string',
+                    description: 'Notes about this deployment',
+                },
+                git_ref: {
+                    type: 'string',
+                    description: 'Git branch or commit to deploy',
+                },
+            },
+            required: ['schedule_id'],
+        },
+    },
+    {
+        name: 'delete_scheduled_deployment',
+        description: `Delete a scheduled deployment.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                schedule_id: {
+                    type: 'string',
+                    description: 'Schedule UUID',
+                },
+            },
+            required: ['schedule_id'],
+        },
+    },
+    {
+        name: 'trigger_scheduled_deployment',
+        description: `Manually trigger a scheduled deployment. Creates a new deployment and updates the schedule.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                schedule_id: {
+                    type: 'string',
+                    description: 'Schedule UUID',
+                },
+            },
+            required: ['schedule_id'],
+        },
+    },
+    {
+        name: 'check_due_deployments',
+        description: `Check for scheduled deployments that are due. Returns schedules where: enabled AND auto_trigger AND scheduled_at <= NOW().`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+];

package/dist/tools/discovery.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Discovery Tool Definitions
+ *
+ * Tools for discovering and querying project knowledge:
+ * - query_knowledge_base
+ * - discover_tools
+ * - get_tool_info
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const discoveryTools: Tool[];

package/dist/tools/discovery.js

@@ -0,0 +1,73 @@
+/**
+ * Discovery Tool Definitions
+ *
+ * Tools for discovering and querying project knowledge:
+ * - query_knowledge_base
+ * - discover_tools
+ * - get_tool_info
+ */
+export const discoveryTools = [
+    {
+        name: 'query_knowledge_base',
+        description: `Query aggregated project knowledge in a single call. Returns findings, Q&A, decisions, completed tasks, and resolved blockers. Use this instead of multiple separate tool calls to reduce token usage.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                scope: {
+                    type: 'string',
+                    enum: ['summary', 'detailed'],
+                    description: 'Response detail level: summary (default) or detailed (includes rationales)',
+                },
+                categories: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: ['findings', 'qa', 'decisions', 'completed_tasks', 'blockers', 'progress'],
+                    },
+                    description: 'Categories to include (default: all). Filter to reduce response size.',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max items per category (default: 5, max: 20)',
+                },
+                search_query: {
+                    type: 'string',
+                    description: 'Optional text search across all knowledge',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    {
+        name: 'discover_tools',
+        description: 'List tools by category. Use get_tool_info for details.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                category: {
+                    type: 'string',
+                    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)',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_tool_info',
+        description: 'Get detailed tool documentation.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                tool_name: {
+                    type: 'string',
+                    description: 'Tool name',
+                },
+            },
+            required: ['tool_name'],
+        },
+    },
+];

package/dist/tools/fallback.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fallback Activity Tool Definitions
+ *
+ * Tools for managing background activities when no tasks available:
+ * - start_fallback_activity
+ * - stop_fallback_activity
+ * - get_activity_history
+ * - get_activity_schedules
+ */
+import type { Tool } from './types.js';
+export declare const fallbackTools: Tool[];