@vibescope/mcp-server 0.0.1 → 0.1.0

package/src/tools.ts

@@ -0,0 +1,2506 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+
+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.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				git_url: {
+					type: 'string',
+					description: 'Git repository URL. Used to find project if project_id not provided.',
+				},
+				mode: {
+					type: 'string',
+					enum: ['lite', 'full'],
+					description: 'Response mode: lite (default, minimal tokens) or full (complete context)',
+				},
+				model: {
+					type: 'string',
+					enum: ['opus', 'sonnet', 'haiku'],
+					description: 'Claude model being used (for accurate cost tracking). E.g., "opus", "sonnet", "haiku".',
+				},
+				role: {
+					type: 'string',
+					enum: ['developer', 'validator', 'deployer', 'reviewer', 'maintainer'],
+					description: 'Agent role: developer (general work, default), validator (task validation), deployer (deployments), reviewer (code review), maintainer (housekeeping)',
+				},
+			},
+		},
+	},
+	{
+		name: 'get_help',
+		description: 'Get guidance on a specific topic. Use when unsure about workflows.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				topic: {
+					type: 'string',
+					enum: ['getting_started', 'tasks', 'validation', 'deployment', 'git', 'blockers', 'milestones', 'fallback', 'session', 'tokens', 'roles', 'knowledge', 'topics'],
+					description: 'Help topic. Use "topics" to list all available.',
+				},
+			},
+			required: ['topic'],
+		},
+	},
+	{
+		name: 'get_token_usage',
+		description: 'Get token usage stats for this session. Monitor efficiency.',
+		inputSchema: {
+			type: 'object',
+			properties: {},
+		},
+	},
+	// Cost monitoring tools
+	{
+		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: 'get_cost_alerts',
+		description: 'Get cost alerts for the current user.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Filter by project (optional)',
+				},
+			},
+		},
+	},
+	{
+		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'],
+		},
+	},
+	{
+		name: 'get_task_costs',
+		description: 'Get cost breakdown by task for a project.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max tasks to return (default: 20)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	// Knowledge Base Query Tool
+	{
+		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', 'requests', 'organizations', 'cost', 'knowledge'],
+					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'],
+		},
+	},
+	{
+		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: { type: 'string' },
+				goal: { type: 'string' },
+				git_url: { type: 'string' },
+				tech_stack: {
+					type: 'array',
+					items: { type: 'string' },
+				},
+				status: {
+					type: 'string',
+					enum: ['active', 'paused', 'completed', 'archived'],
+				},
+				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',
+				},
+				git_auto_commit_on_complete: {
+					type: 'boolean',
+					description: 'Agents must commit changes after completing tasks',
+				},
+				git_auto_pr_on_complete: {
+					type: 'boolean',
+					description: 'Agents must create PR after completing tasks',
+				},
+				deployment_instructions: {
+					type: 'string',
+					description: 'Instructions for how to deploy (e.g., "Push to main for Vercel auto-deploy", "Run fly deploy")',
+				},
+			},
+			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_tasks',
+		description: 'Get tasks for a project, optionally filtered by status. By default returns only root tasks (not subtasks).',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				status: {
+					type: 'string',
+					enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'],
+					description: 'Filter by status (optional)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max number of tasks to return (default 50)',
+				},
+				include_subtasks: {
+					type: 'boolean',
+					description: 'Include subtasks in results (default false). Use get_subtasks for subtasks of a specific task.',
+				},
+				include_metadata: {
+					type: 'boolean',
+					description: 'When true, returns all task fields (description, progress, timestamps, etc.). When false (default), returns only id/title/priority/status to save tokens.',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'get_next_task',
+		description: 'Get highest priority pending task. Skips claimed tasks. Check deployment_blocks_tasks first.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'add_task',
+		description: 'Add a new task. Priority 1=highest, 5=lowest. Include estimated_minutes. Use blocking=true for deployment finalization tasks that must complete before other work.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				title: {
+					type: 'string',
+					description: 'Task title',
+				},
+				description: {
+					type: 'string',
+					description: 'Detailed description',
+				},
+				priority: {
+					type: 'number',
+					minimum: 1,
+					maximum: 5,
+					description: 'Priority 1-5 (1 = highest)',
+				},
+				estimated_minutes: {
+					type: 'number',
+					minimum: 1,
+					description: 'Estimated time to complete in minutes',
+				},
+				blocking: {
+					type: 'boolean',
+					description: 'When true, this task blocks all other work until complete (used for deployment finalization)',
+				},
+				model_capability: {
+					type: 'string',
+					enum: ['haiku', 'sonnet', 'opus'],
+					description: 'Recommended model capability: haiku (simple tasks), sonnet (standard), opus (complex reasoning)',
+				},
+			},
+			required: ['project_id', 'title'],
+		},
+	},
+	{
+		name: 'update_task',
+		description: 'Update task status, progress, or details. Include progress_note with progress_percentage.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID',
+				},
+				title: { type: 'string' },
+				description: { type: 'string' },
+				priority: {
+					type: 'number',
+					minimum: 1,
+					maximum: 5,
+				},
+				status: {
+					type: 'string',
+					enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'],
+				},
+				progress_percentage: {
+					type: 'number',
+					minimum: 0,
+					maximum: 100,
+					description: '0-100 completion percentage',
+				},
+				progress_note: {
+					type: 'string',
+					description: 'Brief note (auto-logged)',
+				},
+				estimated_minutes: {
+					type: 'number',
+					minimum: 1,
+					description: 'Revised time estimate',
+				},
+				git_branch: {
+					type: 'string',
+					description: 'Git branch associated with this task',
+				},
+				model_capability: {
+					type: 'string',
+					enum: ['haiku', 'sonnet', 'opus'],
+					description: 'Recommended model capability: haiku (simple tasks), sonnet (standard), opus (complex reasoning)',
+				},
+			},
+			required: ['task_id'],
+		},
+	},
+	{
+		name: 'complete_task',
+		description: 'Mark task done. Returns next_task and context counts (validation, blockers, deployment).',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID',
+				},
+				summary: {
+					type: 'string',
+					description: 'Brief summary of what was done',
+				},
+			},
+			required: ['task_id'],
+		},
+	},
+	{
+		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: 'add_blocker',
+		description: `Record a blocker preventing progress.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				description: {
+					type: 'string',
+					description: 'What is blocking progress?',
+				},
+			},
+			required: ['project_id', 'description'],
+		},
+	},
+	{
+		name: 'resolve_blocker',
+		description: `Mark a blocker as resolved.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				blocker_id: {
+					type: 'string',
+					description: 'Blocker UUID',
+				},
+				resolution_note: {
+					type: 'string',
+					description: 'How was it resolved?',
+				},
+			},
+			required: ['blocker_id'],
+		},
+	},
+	{
+		name: 'get_blockers',
+		description: `Get blockers for a project, optionally filtered by status.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				status: {
+					type: 'string',
+					enum: ['open', 'resolved'],
+					description: 'Filter by status (default: open)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		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_decisions',
+		description: `Get recorded decisions for a project.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'add_idea',
+		description: `Record an idea for improvements or features. Starts as 'raw', can progress to 'shipped'.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				title: {
+					type: 'string',
+					description: 'Idea title',
+				},
+				description: {
+					type: 'string',
+					description: 'Detailed description',
+				},
+				status: {
+					type: 'string',
+					enum: ['raw', 'exploring', 'planned', 'in_development', 'shipped'],
+					description: 'Development stage (default: raw)',
+				},
+			},
+			required: ['project_id', 'title'],
+		},
+	},
+	{
+		name: 'update_idea',
+		description: `Update an idea's status or details.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				idea_id: {
+					type: 'string',
+					description: 'Idea UUID',
+				},
+				title: {
+					type: 'string',
+					description: 'Updated title',
+				},
+				description: {
+					type: 'string',
+					description: 'Updated description',
+				},
+				status: {
+					type: 'string',
+					enum: ['raw', 'exploring', 'planned', 'in_development', 'shipped'],
+					description: 'New development stage',
+				},
+				doc_url: {
+					type: 'string',
+					description: 'URL to feature documentation/specification',
+				},
+			},
+			required: ['idea_id'],
+		},
+	},
+	{
+		name: 'get_ideas',
+		description: `Get recorded ideas for a project, optionally filtered by status.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				status: {
+					type: 'string',
+					enum: ['raw', 'exploring', 'planned', 'in_development', 'shipped'],
+					description: 'Filter by status (optional)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max number of ideas to return (default 50, max 100)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Number of ideas to skip for pagination (default 0)',
+				},
+				search_query: {
+					type: 'string',
+					description: 'Search ideas by title or description',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'delete_task',
+		description: `Delete a task.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID',
+				},
+			},
+			required: ['task_id'],
+		},
+	},
+	{
+		name: 'add_task_reference',
+		description: 'Add a reference URL to a task (docs, PRs, issues).',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID',
+				},
+				url: {
+					type: 'string',
+					description: 'URL to add as reference',
+				},
+				label: {
+					type: 'string',
+					description: 'Optional label/title for the reference',
+				},
+			},
+			required: ['task_id', 'url'],
+		},
+	},
+	{
+		name: 'remove_task_reference',
+		description: `Remove a reference link from a task by URL.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID',
+				},
+				url: {
+					type: 'string',
+					description: 'URL of the reference to remove',
+				},
+			},
+			required: ['task_id', 'url'],
+		},
+	},
+	{
+		name: 'delete_idea',
+		description: `Delete an idea.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				idea_id: {
+					type: 'string',
+					description: 'Idea UUID',
+				},
+			},
+			required: ['idea_id'],
+		},
+	},
+	{
+		name: 'convert_idea_to_task',
+		description: `Convert an idea to a task. Creates a task from the idea's title and description, links them, and optionally updates the idea status to 'in_development'. Useful for planned ideas that are ready for implementation.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				idea_id: {
+					type: 'string',
+					description: 'Idea UUID to convert',
+				},
+				priority: {
+					type: 'number',
+					minimum: 1,
+					maximum: 5,
+					description: 'Task priority 1-5 (default: 3, 1 = highest)',
+				},
+				estimated_minutes: {
+					type: 'number',
+					minimum: 1,
+					description: 'Estimated time to complete in minutes',
+				},
+				update_status: {
+					type: 'boolean',
+					description: "Update idea status to 'in_development' (default: true)",
+				},
+			},
+			required: ['idea_id'],
+		},
+	},
+	// Findings (knowledge base)
+	{
+		name: 'add_finding',
+		description: 'Record a finding from an audit/review (performance, security, code quality, etc).',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: { type: 'string', description: 'Project UUID' },
+				category: { type: 'string', enum: ['performance', 'security', 'code_quality', 'accessibility', 'documentation', 'architecture', 'testing', 'other'], description: 'Category of the finding (default: other)' },
+				title: { type: 'string', description: 'Brief title describing the finding' },
+				description: { type: 'string', description: 'Detailed description of the finding, including impact and suggested fix' },
+				severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Severity level (default: info)' },
+				file_path: { type: 'string', description: 'File path where the issue was found (optional)' },
+				line_number: { type: 'number', description: 'Line number in the file (optional)' },
+				related_task_id: { type: 'string', description: 'ID of related task if this finding came from a task (optional)' },
+			},
+			required: ['project_id', 'title'],
+		},
+	},
+	{
+		name: 'get_findings',
+		description: `Get findings for a project, optionally filtered by category, severity, or status.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: { type: 'string', description: 'Project UUID' },
+				category: { type: 'string', enum: ['performance', 'security', 'code_quality', 'accessibility', 'documentation', 'architecture', 'testing', 'other'], description: 'Filter by category (optional)' },
+				severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Filter by severity (optional)' },
+				status: { type: 'string', enum: ['open', 'addressed', 'dismissed', 'wontfix'], description: 'Filter by status (default: all)' },
+				limit: { type: 'number', description: 'Max number of findings to return (default 50)' },
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'update_finding',
+		description: `Update a finding's status or details. Use to mark findings as addressed or dismissed.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				finding_id: { type: 'string', description: 'Finding UUID' },
+				status: { type: 'string', enum: ['open', 'addressed', 'dismissed', 'wontfix'], description: 'New status' },
+				resolution_note: { type: 'string', description: 'Note explaining how the finding was addressed or why it was dismissed' },
+				title: { type: 'string', description: 'Updated title' },
+				description: { type: 'string', description: 'Updated description' },
+				severity: { type: 'string', enum: ['info', 'low', 'medium', 'high', 'critical'], description: 'Updated severity' },
+			},
+			required: ['finding_id'],
+		},
+	},
+	{
+		name: 'delete_finding',
+		description: `Delete a finding.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				finding_id: { type: 'string', description: 'Finding UUID' },
+			},
+			required: ['finding_id'],
+		},
+	},
+	{
+		name: 'delete_blocker',
+		description: `Delete a blocker.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				blocker_id: {
+					type: 'string',
+					description: 'Blocker UUID',
+				},
+			},
+			required: ['blocker_id'],
+		},
+	},
+	{
+		name: 'delete_decision',
+		description: `Delete a decision.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				decision_id: {
+					type: 'string',
+					description: 'Decision UUID',
+				},
+			},
+			required: ['decision_id'],
+		},
+	},
+	{
+		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 50, max 200)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'batch_update_tasks',
+		description: 'Update multiple tasks at once. Include progress_note with progress_percentage.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				updates: {
+					type: 'array',
+					description: 'Array of task updates to apply',
+					items: {
+						type: 'object',
+						properties: {
+							task_id: { type: 'string', description: 'Task UUID' },
+							status: { type: 'string', enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'] },
+							progress_percentage: { type: 'number', minimum: 0, maximum: 100 },
+							progress_note: { type: 'string', description: 'Brief note about what was achieved' },
+							priority: { type: 'number', minimum: 1, maximum: 5 },
+						},
+						required: ['task_id'],
+					},
+				},
+			},
+			required: ['updates'],
+		},
+	},
+	{
+		name: 'batch_complete_tasks',
+		description: `Mark multiple tasks as completed at once.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				completions: {
+					type: 'array',
+					description: 'Array of task completions',
+					items: {
+						type: 'object',
+						properties: {
+							task_id: { type: 'string', description: 'Task UUID' },
+							summary: { type: 'string', description: 'Optional completion summary' },
+						},
+						required: ['task_id'],
+					},
+				},
+			},
+			required: ['completions'],
+		},
+	},
+	// =========================================================================
+	// Subtask Tools
+	// =========================================================================
+	{
+		name: 'add_subtask',
+		description: `Add a subtask to break down a larger task into smaller workable pieces.
+Subtasks can be claimed and worked on independently by any agent.
+Subtasks inherit the project from their parent task.
+Max depth is 1 (subtasks cannot have their own subtasks).`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				parent_task_id: {
+					type: 'string',
+					description: 'UUID of the parent task to add subtask to',
+				},
+				title: {
+					type: 'string',
+					description: 'Subtask title',
+				},
+				description: {
+					type: 'string',
+					description: 'Detailed description (optional)',
+				},
+				priority: {
+					type: 'number',
+					minimum: 1,
+					maximum: 5,
+					description: 'Priority 1-5 (1 = highest). Defaults to parent task priority.',
+				},
+				estimated_minutes: {
+					type: 'number',
+					minimum: 1,
+					description: 'Estimated time to complete in minutes',
+				},
+			},
+			required: ['parent_task_id', 'title'],
+		},
+	},
+	{
+		name: 'get_subtasks',
+		description: `Get subtasks for a parent task.
+Returns subtasks with aggregate completion stats.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				parent_task_id: {
+					type: 'string',
+					description: 'UUID of the parent task',
+				},
+				status: {
+					type: 'string',
+					enum: ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'],
+					description: 'Filter by status (optional)',
+				},
+			},
+			required: ['parent_task_id'],
+		},
+	},
+	{
+		name: 'heartbeat',
+		description: `Send heartbeat to maintain 'active' status. Call every 30-60 seconds.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				session_id: {
+					type: 'string',
+					description: 'Session ID from start_work_session (optional, uses current session if not provided)',
+				},
+			},
+		},
+	},
+	{
+		name: 'end_work_session',
+		description: `End session and release claimed tasks. Returns session summary.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				session_id: {
+					type: 'string',
+					description: 'Session ID to end (optional, uses current session if not provided)',
+				},
+			},
+		},
+	},
+	// =========================================================================
+	// Task Validation Tools
+	// =========================================================================
+	{
+		name: 'get_tasks_awaiting_validation',
+		description: `Get completed tasks not yet validated.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'claim_validation',
+		description: 'Claim a completed task for review. Shows "being reviewed" on dashboard.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID to claim for review',
+				},
+			},
+			required: ['task_id'],
+		},
+	},
+	{
+		name: 'validate_task',
+		description: 'Validate a completed task. Include test results in validation_notes.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				task_id: {
+					type: 'string',
+					description: 'Task UUID to validate',
+				},
+				validation_notes: {
+					type: 'string',
+					description: 'Notes about the validation (what was checked, any issues found)',
+				},
+				approved: {
+					type: 'boolean',
+					description: 'Whether the task passes validation (true = approved, false = needs more work)',
+				},
+			},
+			required: ['task_id', 'approved'],
+		},
+	},
+	// =========================================================================
+	// Deployment Coordination Tools
+	// =========================================================================
+	{
+		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',
+				},
+			},
+			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'],
+				},
+			},
+			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), daily, weekly, or monthly',
+					enum: ['once', 'daily', 'weekly', 'monthly'],
+				},
+				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)',
+				},
+			},
+			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', 'daily', 'weekly', 'monthly'],
+				},
+				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'],
+		},
+	},
+	{
+		name: 'start_fallback_activity',
+		description: `Start a background activity when no tasks available.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				activity: {
+					type: 'string',
+					description: 'The fallback activity type (e.g., code_review, security_review)',
+					enum: [
+						'feature_ideation',
+						'code_review',
+						'performance_audit',
+						'ux_review',
+						'cost_analysis',
+						'security_review',
+						'test_coverage',
+						'documentation_review',
+						'dependency_audit',
+						'validate_completed_tasks',
+					],
+				},
+			},
+			required: ['project_id', 'activity'],
+		},
+	},
+	{
+		name: 'stop_fallback_activity',
+		description: `Stop current fallback activity. Auto-clears when starting a regular task.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				summary: {
+					type: 'string',
+					description: 'Optional summary of what was accomplished during this activity',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'get_activity_history',
+		description: `Get background activity completion history.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				activity_type: {
+					type: 'string',
+					description: 'Optional: filter to a specific activity type',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max number of history entries to return (default 50)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'get_activity_schedules',
+		description: `Get background activity schedules.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	// =========================================================================
+	// Agent Request Tools
+	// =========================================================================
+	{
+		name: 'get_pending_requests',
+		description: `Get unacknowledged user requests for this agent/project.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			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'],
+		},
+	},
+	// ============================================================================
+	// Milestone Tools
+	// ============================================================================
+	{
+		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'],
+		},
+	},
+	// ============================================================================
+	// Bodies of Work Tools
+	// ============================================================================
+	{
+		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'],
+		},
+	},
+	// ============================================================================
+	// Organization Tools
+	// ============================================================================
+	{
+		name: 'list_organizations',
+		description: 'List organizations the current user belongs to.',
+		inputSchema: {
+			type: 'object',
+			properties: {},
+		},
+	},
+	{
+		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: 'list_org_members',
+		description: 'List members of an organization.',
+		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'],
+		},
+	},
+	{
+		name: 'list_project_shares',
+		description: 'List all organizations a project is shared with.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	// File checkout/checkin tools for multi-agent coordination
+	{
+		name: 'checkout_file',
+		description: 'Check out a file for editing. Prevents other agents from editing the same file until checked in. ALWAYS checkout files before making changes to prevent conflicts.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				file_path: {
+					type: 'string',
+					description: 'Relative path to the file to checkout (e.g., "src/index.ts")',
+				},
+				reason: {
+					type: 'string',
+					description: 'Optional reason for checkout (e.g., "Fixing bug in login flow")',
+				},
+			},
+			required: ['project_id', 'file_path'],
+		},
+	},
+	{
+		name: 'checkin_file',
+		description: 'Check in a file after editing. Releases the file for other agents to edit. ALWAYS checkin files when done editing.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				checkout_id: {
+					type: 'string',
+					description: 'Checkout UUID (from checkout_file response)',
+				},
+				project_id: {
+					type: 'string',
+					description: 'Project UUID (alternative to checkout_id)',
+				},
+				file_path: {
+					type: 'string',
+					description: 'File path (use with project_id as alternative to checkout_id)',
+				},
+				summary: {
+					type: 'string',
+					description: 'Optional summary of changes made',
+				},
+			},
+		},
+	},
+	{
+		name: 'get_file_checkouts',
+		description: 'Get list of file checkouts for a project. Shows which files are currently checked out and by whom.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				status: {
+					type: 'string',
+					enum: ['checked_out', 'checked_in', 'abandoned'],
+					description: 'Filter by status (default: checked_out)',
+				},
+				include_completed: {
+					type: 'boolean',
+					description: 'Include checked_in and abandoned checkouts (default: false)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max checkouts to return (default: 50)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'abandon_checkout',
+		description: 'Force-release a checkout. Use when the original agent session died or is stuck.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				checkout_id: {
+					type: 'string',
+					description: 'Checkout UUID to abandon',
+				},
+				reason: {
+					type: 'string',
+					description: 'Reason for abandoning (e.g., "Agent session died")',
+				},
+			},
+			required: ['checkout_id'],
+		},
+	},
+	{
+		name: 'is_file_available',
+		description: 'Check if a file is available for checkout. Returns who has it checked out if not available.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				file_path: {
+					type: 'string',
+					description: 'Path to the file to check',
+				},
+			},
+			required: ['project_id', 'file_path'],
+		},
+	},
+	// Role management tools
+	{
+		name: 'get_role_settings',
+		description: 'Get role configuration for a project. Shows available roles and their settings.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'update_role_settings',
+		description: 'Update role settings for a project. Configure which roles are enabled and their behavior.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				role: {
+					type: 'string',
+					enum: ['developer', 'validator', 'deployer', 'reviewer', 'maintainer'],
+					description: 'Role to configure',
+				},
+				enabled: {
+					type: 'boolean',
+					description: 'Enable or disable this role',
+				},
+				display_name: {
+					type: 'string',
+					description: 'Custom display name for this role',
+				},
+				description: {
+					type: 'string',
+					description: 'Description of what this role does',
+				},
+				priority_filter: {
+					type: 'array',
+					items: { type: 'number' },
+					description: 'Only show tasks with these priorities (1-5)',
+				},
+				fallback_activities: {
+					type: 'array',
+					items: { type: 'string' },
+					description: 'Preferred fallback activities for this role',
+				},
+				auto_assign_validation: {
+					type: 'boolean',
+					description: 'Auto-assign validation tasks to agents with this role',
+				},
+				auto_assign_deployment: {
+					type: 'boolean',
+					description: 'Auto-assign deployment tasks to agents with this role',
+				},
+			},
+			required: ['project_id', 'role'],
+		},
+	},
+	{
+		name: 'set_session_role',
+		description: 'Set the role for your current session. Changes task filtering and fallback activity suggestions.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				role: {
+					type: 'string',
+					enum: ['developer', 'validator', 'deployer', 'reviewer', 'maintainer'],
+					description: 'Role to assign to this session',
+				},
+				role_config: {
+					type: 'object',
+					description: 'Custom configuration for specialist role (optional)',
+				},
+			},
+			required: ['role'],
+		},
+	},
+	{
+		name: 'get_agents_by_role',
+		description: 'Get active agents grouped by their assigned roles. See who is working on what.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+];
+