@vibescope/mcp-server 0.3.0 → 0.3.3

package/src/tools/milestones.ts

@@ -0,0 +1,118 @@
+/**
+ * Milestone Tool Definitions
+ *
+ * Tools for managing task milestones:
+ * - add_milestone
+ * - update_milestone
+ * - complete_milestone
+ * - delete_milestone
+ * - get_milestones
+ */
+
+import type { Tool } from './types.js';
+
+export const milestoneTools: Tool[] = [
+	{
+		name: 'add_milestone',
+		description: `Add a milestone to a task.
+Milestones help break down large tasks into smaller trackable steps.
+Use this to show progress on complex tasks and help gauge completion.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID to add milestone to',
+				},
+				title: {
+					type: 'string',
+					description: 'Milestone title (brief description of what needs to be done)',
+				},
+				description: {
+					type: 'string',
+					description: 'Optional detailed description',
+				},
+				order_index: {
+					type: 'number',
+					minimum: 0,
+					description: 'Order of this milestone (0-based, defaults to end of list)',
+				},
+			},
+			required: ['task_id', 'title'],
+		},
+	},
+	{
+		name: 'update_milestone',
+		description: `Update a milestone's title, description, status, or order.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				milestone_id: {
+					type: 'string',
+					description: 'Milestone UUID',
+				},
+				title: {
+					type: 'string',
+					description: 'Updated title',
+				},
+				description: {
+					type: 'string',
+					description: 'Updated description',
+				},
+				status: {
+					type: 'string',
+					enum: ['pending', 'in_progress', 'completed'],
+					description: 'Milestone status',
+				},
+				order_index: {
+					type: 'number',
+					minimum: 0,
+					description: 'Updated order',
+				},
+			},
+			required: ['milestone_id'],
+		},
+	},
+	{
+		name: 'complete_milestone',
+		description: `Mark a milestone as completed. This is a convenience wrapper for update_milestone with status=completed.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				milestone_id: {
+					type: 'string',
+					description: 'Milestone UUID',
+				},
+			},
+			required: ['milestone_id'],
+		},
+	},
+	{
+		name: 'delete_milestone',
+		description: `Delete a milestone from a task.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				milestone_id: {
+					type: 'string',
+					description: 'Milestone UUID',
+				},
+			},
+			required: ['milestone_id'],
+		},
+	},
+	{
+		name: 'get_milestones',
+		description: `Get all milestones for a task, ordered by order_index.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID',
+				},
+			},
+			required: ['task_id'],
+		},
+	},
+];

package/src/tools/organizations.ts

@@ -0,0 +1,224 @@
+/**
+ * Organization Tool Definitions
+ *
+ * Tools for managing organizations and sharing:
+ * - create_organization
+ * - update_organization
+ * - delete_organization
+ * - invite_member
+ * - update_member_role
+ * - remove_member
+ * - leave_organization
+ * - share_project_with_org
+ * - update_project_share
+ * - unshare_project
+ */
+
+import type { Tool } from './types.js';
+
+export const organizationTools: Tool[] = [
+	{
+		name: 'create_organization',
+		description: 'Create a new organization. You become the owner.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				name: {
+					type: 'string',
+					description: 'Organization display name',
+				},
+				description: {
+					type: 'string',
+					description: 'Brief description of the organization',
+				},
+				slug: {
+					type: 'string',
+					description: 'URL-friendly identifier (auto-generated from name if not provided)',
+				},
+			},
+			required: ['name'],
+		},
+	},
+	{
+		name: 'update_organization',
+		description: 'Update organization details. Requires admin role.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				organization_id: {
+					type: 'string',
+					description: 'Organization UUID',
+				},
+				name: {
+					type: 'string',
+					description: 'New organization name',
+				},
+				description: {
+					type: 'string',
+					description: 'New description',
+				},
+				logo_url: {
+					type: 'string',
+					description: 'URL to organization logo',
+				},
+			},
+			required: ['organization_id'],
+		},
+	},
+	{
+		name: 'delete_organization',
+		description: 'Delete an organization. Requires owner role. Removes all shares.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				organization_id: {
+					type: 'string',
+					description: 'Organization UUID',
+				},
+			},
+			required: ['organization_id'],
+		},
+	},
+	{
+		name: 'invite_member',
+		description: 'Invite a user to an organization by email. Requires admin role.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				organization_id: {
+					type: 'string',
+					description: 'Organization UUID',
+				},
+				email: {
+					type: 'string',
+					description: 'Email address to invite',
+				},
+				role: {
+					type: 'string',
+					enum: ['admin', 'member', 'viewer'],
+					description: 'Role to assign (default: member)',
+				},
+			},
+			required: ['organization_id', 'email'],
+		},
+	},
+	{
+		name: 'update_member_role',
+		description: 'Change a member\'s role. Requires admin role. Cannot change owner.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				organization_id: {
+					type: 'string',
+					description: 'Organization UUID',
+				},
+				user_id: {
+					type: 'string',
+					description: 'User UUID to update',
+				},
+				role: {
+					type: 'string',
+					enum: ['admin', 'member', 'viewer'],
+					description: 'New role to assign',
+				},
+			},
+			required: ['organization_id', 'user_id', 'role'],
+		},
+	},
+	{
+		name: 'remove_member',
+		description: 'Remove a member from an organization. Requires admin role.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				organization_id: {
+					type: 'string',
+					description: 'Organization UUID',
+				},
+				user_id: {
+					type: 'string',
+					description: 'User UUID to remove',
+				},
+			},
+			required: ['organization_id', 'user_id'],
+		},
+	},
+	{
+		name: 'leave_organization',
+		description: 'Leave an organization. Owner cannot leave without transferring ownership.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				organization_id: {
+					type: 'string',
+					description: 'Organization UUID',
+				},
+			},
+			required: ['organization_id'],
+		},
+	},
+	{
+		name: 'share_project_with_org',
+		description: 'Share a project with an organization. You must own the project.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				organization_id: {
+					type: 'string',
+					description: 'Organization UUID to share with',
+				},
+				permission: {
+					type: 'string',
+					enum: ['read', 'write', 'admin'],
+					description: 'Permission level (default: read)',
+				},
+			},
+			required: ['project_id', 'organization_id'],
+		},
+	},
+	{
+		name: 'update_project_share',
+		description: 'Update the permission level for a project share.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				organization_id: {
+					type: 'string',
+					description: 'Organization UUID',
+				},
+				permission: {
+					type: 'string',
+					enum: ['read', 'write', 'admin'],
+					description: 'New permission level',
+				},
+			},
+			required: ['project_id', 'organization_id', 'permission'],
+		},
+	},
+	{
+		name: 'unshare_project',
+		description: 'Remove a project share from an organization.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				organization_id: {
+					type: 'string',
+					description: 'Organization UUID',
+				},
+			},
+			required: ['project_id', 'organization_id'],
+		},
+	},
+];

package/src/tools/progress.ts

@@ -0,0 +1,73 @@
+/**
+ * Progress Tool Definitions
+ *
+ * Tools for logging and viewing progress:
+ * - log_progress
+ * - get_activity_feed
+ */
+
+import type { Tool } from './types.js';
+
+export const progressTools: Tool[] = [
+	{
+		name: 'log_progress',
+		description: `Log progress update. Record significant milestones or observations.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				task_id: {
+					type: 'string',
+					description: 'Task UUID (optional, links progress to specific task)',
+				},
+				summary: {
+					type: 'string',
+					description: 'Brief summary of progress',
+				},
+				details: {
+					type: 'string',
+					description: 'Detailed notes (optional)',
+				},
+			},
+			required: ['project_id', 'summary'],
+		},
+	},
+	{
+		name: 'get_activity_feed',
+		description: `Get combined activity feed (tasks, progress, blockers, decisions) in chronological order.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				types: {
+					type: 'array',
+					items: {
+						type: 'string',
+						enum: ['task', 'progress', 'blocker', 'decision'],
+					},
+					description: 'Filter by activity types (default: all)',
+				},
+				created_by: {
+					type: 'string',
+					enum: ['agent', 'user'],
+					description: 'Filter by creator (default: all)',
+				},
+				since: {
+					type: 'string',
+					description: 'ISO date string - only return activity after this time',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max number of items to return (default 10, max 200)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+];

package/src/tools/project.ts

@@ -0,0 +1,202 @@
+/**
+ * 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: 'What does "done" look like for this project?',
+				},
+				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.',
+				},
+			},
+			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

@@ -0,0 +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'],
+		},
+	},
+];