agent-tasks 1.7.0 → 1.9.0

package/dist/transport/mcp.js

@@ -4,61 +4,79 @@
 // Maps MCP tool calls to the TaskService. Thin adapter — validation lives
 // in the domain layer, not here.
 // =============================================================================
-import { writeFileSync, mkdirSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
 import { ValidationError } from '../types.js';
-import { generateRules } from '../domain/rules.js';
+import { handlers } from './mcp-handlers.js';
 // ---------------------------------------------------------------------------
-// Tool definitions
+// Tool definitions (13 tools)
 // ---------------------------------------------------------------------------
 export const tools = [
     {
         name: 'task_create',
-        description: 'Create a pipeline task with optional stage, priority, and project.',
+        description: 'Create a pipeline task. Tasks start in "backlog" and move through stages: backlog → spec → plan → implement → test → review → done. Use parent_id to create subtasks under an existing task.',
         inputSchema: {
             type: 'object',
             properties: {
                 title: { type: 'string', description: 'Task title (max 500 chars)' },
                 description: { type: 'string', description: 'Detailed instructions (max 50K chars)' },
                 assign_to: { type: 'string', description: 'Agent name to assign to' },
-                stage: { type: 'string', description: 'Pipeline stage (default: backlog)' },
+                stage: {
+                    type: 'string',
+                    description: 'Initial pipeline stage (default: backlog)',
+                },
                 priority: {
                     type: 'number',
-                    description: 'Priority (higher = more important, default: 0)',
+                    description: 'Priority — higher number = more important (default: 0)',
                 },
                 project: { type: 'string', description: 'Project name for grouping' },
                 tags: { type: 'array', items: { type: 'string' }, description: 'Tags for categorization' },
-                parent_id: { type: 'number', description: 'Parent task ID (creates a subtask)' },
+                parent_id: {
+                    type: 'number',
+                    description: 'Parent task ID — creates a subtask that inherits project and priority',
+                },
             },
             required: ['title'],
         },
     },
     {
         name: 'task_list',
-        description: 'List tasks with optional filters and pagination.',
+        description: 'List, search, or pick tasks. Without params: returns all tasks. With filters: narrow by status/stage/project/assignee. With "query": full-text search across titles and descriptions. With "next": true: returns the single highest-priority unassigned task with all dependencies met (uses affinity scoring when agent is provided).',
         inputSchema: {
             type: 'object',
             properties: {
+                query: {
+                    type: 'string',
+                    description: 'Full-text search across task titles and descriptions (FTS5)',
+                },
+                next: {
+                    type: 'boolean',
+                    description: 'Return the single best available task — highest priority, unassigned, all dependencies met. Uses affinity scoring when "agent" is provided.',
+                },
+                agent: {
+                    type: 'string',
+                    description: 'Agent name for affinity scoring (only with next: true) — prefers tasks where the agent worked on the parent, a dependency, or the same project',
+                },
                 status: {
                     type: 'string',
                     enum: ['pending', 'in_progress', 'completed', 'failed', 'cancelled'],
                     description: 'Filter by status',
                 },
-                assigned_to: { type: 'string', description: 'Filter by assigned agent name' },
+                assign_to: { type: 'string', description: 'Filter by assigned agent name' },
                 stage: { type: 'string', description: 'Filter by pipeline stage' },
                 project: { type: 'string', description: 'Filter by project' },
                 collaborator: { type: 'string', description: 'Filter tasks where agent is a collaborator' },
                 root_only: { type: 'boolean', description: 'Only show top-level tasks (no subtasks)' },
                 parent_id: { type: 'number', description: 'Filter subtasks of a specific parent' },
-                limit: { type: 'number', description: 'Max results (default/max: 500)' },
+                limit: {
+                    type: 'number',
+                    description: 'Max results (default: 500 for list, 50 for search)',
+                },
                 offset: { type: 'number', description: 'Skip first N results (for pagination)' },
             },
         },
     },
     {
         name: 'task_claim',
-        description: 'Claim a pending task. Assigns it and advances from backlog to the next stage.',
+        description: 'Claim a pending task — assigns it to you and advances from backlog to spec. This is the standard way to start working on a task.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -72,189 +90,170 @@ export const tools = [
         },
     },
     {
-        name: 'task_complete',
-        description: 'Mark a task as completed with a result.',
+        name: 'task_update',
+        description: 'Update task metadata — title, description, priority, tags, project, or assignment. Does not change stage or status (use task_stage for that).',
         inputSchema: {
             type: 'object',
             properties: {
                 task_id: { type: 'number', description: 'Task ID' },
-                result: { type: 'string', description: 'Result or output' },
+                title: { type: 'string', description: 'New title' },
+                description: { type: 'string', description: 'New description' },
+                priority: { type: 'number', description: 'New priority' },
+                project: { type: 'string', description: 'New project' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'New tags' },
+                assign_to: {
+                    type: 'string',
+                    description: 'New assignee (empty string to unassign)',
+                },
             },
-            required: ['task_id', 'result'],
+            required: ['task_id'],
         },
     },
     {
-        name: 'task_fail',
-        description: 'Mark a task as failed with an error message.',
+        name: 'task_delete',
+        description: 'Delete a task and all its artifacts, comments, and dependencies (cascading delete). Cannot be undone.',
         inputSchema: {
             type: 'object',
             properties: {
-                task_id: { type: 'number', description: 'Task ID' },
-                result: { type: 'string', description: 'Error description' },
+                task_id: { type: 'number', description: 'Task ID to delete' },
             },
-            required: ['task_id', 'result'],
+            required: ['task_id'],
         },
     },
     {
-        name: 'task_cancel',
-        description: 'Cancel a task — moves it to the cancelled stage.',
+        name: 'task_comment',
+        description: 'Add a comment to a task — used for async discussion between agents. Supports threading via parent_comment_id. Comments also satisfy stage-gate "require_comment" checks.',
         inputSchema: {
             type: 'object',
             properties: {
                 task_id: { type: 'number', description: 'Task ID' },
-                reason: { type: 'string', description: 'Why the task was cancelled' },
+                content: { type: 'string', description: 'Comment text' },
+                parent_comment_id: { type: 'number', description: 'Reply to this comment (threading)' },
             },
-            required: ['task_id', 'reason'],
+            required: ['task_id', 'content'],
         },
     },
     {
-        name: 'task_advance',
-        description: 'Advance a task to the next pipeline stage (or a specific stage). Validates dependencies and stage gates. Optionally attach a comment in the same call.',
+        name: 'task_stage',
+        description: 'Move a task through its lifecycle. Actions: "advance" → next stage (or jump to a specific one), "regress" → earlier stage (requires reason), "complete" → marks done with result, "fail" → marks failed with error, "cancel" → cancels with reason.',
         inputSchema: {
             type: 'object',
             properties: {
+                action: {
+                    type: 'string',
+                    enum: ['advance', 'regress', 'complete', 'fail', 'cancel'],
+                    description: 'Lifecycle action to perform',
+                },
                 task_id: { type: 'number', description: 'Task ID' },
-                stage: { type: 'string', description: 'Target stage (omit to advance to next stage)' },
+                stage: {
+                    type: 'string',
+                    description: 'Target stage (advance: optional — advances to next if omitted; regress: required)',
+                },
                 comment: {
                     type: 'string',
-                    description: 'Optional comment to attach (also satisfies stage-gate require_comment check)',
+                    description: 'Comment (advance: optional, also satisfies stage-gate require_comment check)',
                 },
-            },
-            required: ['task_id'],
-        },
-    },
-    {
-        name: 'task_regress',
-        description: 'Send a task back to an earlier stage (e.g. review rejection).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: { type: 'number', description: 'Task ID' },
-                stage: { type: 'string', description: 'Target stage to regress to' },
                 reason: {
                     type: 'string',
-                    description: 'Reason for regression (stored as artifact)',
+                    description: 'Reason for regression, failure, or cancellation',
                 },
-            },
-            required: ['task_id', 'stage'],
-        },
-    },
-    {
-        name: 'task_update',
-        description: 'Update task metadata (title, description, priority, tags, assignment).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: { type: 'number', description: 'Task ID' },
-                title: { type: 'string', description: 'New title' },
-                description: { type: 'string', description: 'New description' },
-                priority: { type: 'number', description: 'New priority' },
-                project: { type: 'string', description: 'New project' },
-                tags: { type: 'array', items: { type: 'string' }, description: 'New tags' },
-                assign_to: {
+                result: {
                     type: 'string',
-                    description: 'New assignee (empty string to unassign)',
+                    description: 'Result summary (complete) or error description (fail)',
                 },
             },
-            required: ['task_id'],
-        },
-    },
-    {
-        name: 'task_next',
-        description: 'Get the highest-priority unassigned task with all dependencies met. Returns null if none.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                project: { type: 'string', description: 'Filter by project' },
-                stage: { type: 'string', description: 'Filter by stage' },
-            },
+            required: ['action', 'task_id'],
         },
     },
     {
-        name: 'task_add_dependency',
-        description: 'Add a relationship between tasks. "blocks" prevents advancement until dependency is done. "related" and "duplicate" are informational only.',
+        name: 'task_query',
+        description: 'Read task-related data. Types: "subtasks" → child tasks, "artifacts" → attached documents/decisions/learnings (filterable by stage), "comments" → discussion threads.',
         inputSchema: {
             type: 'object',
             properties: {
-                task_id: { type: 'number', description: 'Task that depends on another' },
-                depends_on: {
-                    type: 'number',
-                    description: 'Task that must complete first (for blocks) or related task',
-                },
-                relationship: {
+                type: {
                     type: 'string',
-                    enum: ['blocks', 'related', 'duplicate'],
-                    description: 'Relationship type (default: blocks)',
+                    enum: ['subtasks', 'artifacts', 'comments'],
+                    description: 'What to query',
                 },
-            },
-            required: ['task_id', 'depends_on'],
-        },
-    },
-    {
-        name: 'task_remove_dependency',
-        description: 'Remove a dependency between tasks.',
-        inputSchema: {
-            type: 'object',
-            properties: {
                 task_id: { type: 'number', description: 'Task ID' },
-                depends_on: { type: 'number', description: 'Dependency to remove' },
+                stage: {
+                    type: 'string',
+                    description: 'Filter artifacts by stage (only used with type: "artifacts")',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max comments to return (only used with type: "comments", default: 100)',
+                },
             },
-            required: ['task_id', 'depends_on'],
+            required: ['type', 'task_id'],
         },
     },
     {
-        name: 'task_add_artifact',
-        description: 'Attach a document/artifact to a task (spec, plan, test results, review notes, etc.).',
+        name: 'task_artifact',
+        description: 'Attach artifacts to a task. Types: "general" → document (spec, test-results, review-notes), "decision" → structured decision record (chose/over/because), "learning" → insight that auto-propagates to parent and sibling tasks on completion.',
         inputSchema: {
             type: 'object',
             properties: {
+                type: {
+                    type: 'string',
+                    enum: ['general', 'decision', 'learning'],
+                    description: 'Artifact type',
+                },
                 task_id: { type: 'number', description: 'Task ID' },
                 name: {
                     type: 'string',
-                    description: 'Artifact name (e.g. "spec", "test-results", "review-notes")',
+                    description: 'Artifact name (type: "general" only, e.g. "spec", "test-results", "review-notes")',
                 },
                 content: {
                     type: 'string',
-                    description: 'Artifact content (text, markdown, JSON, max 100K)',
+                    description: 'Artifact content (type: "general": text/markdown/JSON, max 100K; type: "learning": the insight)',
                 },
                 stage: {
                     type: 'string',
-                    description: 'Stage to attach to (defaults to task current stage)',
+                    description: 'Stage to attach to (type: "general" only, defaults to current stage)',
+                },
+                chose: { type: 'string', description: 'What was chosen (type: "decision" only)' },
+                over: {
+                    type: 'string',
+                    description: 'What alternatives were considered (type: "decision" only)',
+                },
+                because: {
+                    type: 'string',
+                    description: 'Rationale for the decision (type: "decision" only)',
+                },
+                category: {
+                    type: 'string',
+                    enum: ['technique', 'pitfall', 'decision', 'pattern'],
+                    description: 'Learning category (type: "learning" only, default: technique)',
                 },
             },
-            required: ['task_id', 'name', 'content'],
-        },
-    },
-    {
-        name: 'task_get_artifacts',
-        description: 'Get artifacts attached to a task.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: { type: 'number', description: 'Task ID' },
-                stage: { type: 'string', description: 'Filter by stage' },
-            },
-            required: ['task_id'],
+            required: ['type', 'task_id'],
         },
     },
     {
-        name: 'task_pipeline_config',
-        description: 'Get or set pipeline stages and gate config for a project. Call without stages/gate_config to get current config.',
+        name: 'task_config',
+        description: 'Configuration and admin. Actions: "session" → set agent identity (call this first), "pipeline" → get/set pipeline stages and gate config for a project, "cleanup" → purge old completed tasks, "rules" → generate IDE rule files (.mdc or CLAUDE.md).',
         inputSchema: {
             type: 'object',
             properties: {
+                action: {
+                    type: 'string',
+                    enum: ['pipeline', 'session', 'cleanup', 'rules'],
+                    description: 'Config action to perform',
+                },
                 project: {
                     type: 'string',
-                    description: 'Project name (omit for default pipeline)',
+                    description: 'Project name (pipeline: scope, rules: project-specific rules)',
                 },
                 stages: {
                     type: 'array',
                     items: { type: 'string' },
-                    description: 'Stage names in order (set mode)',
+                    description: 'Stage names in order (pipeline set mode)',
                 },
                 gate_config: {
                     type: 'object',
-                    description: 'Stage-gate enforcement config. Example: { "require_comment": true, "require_artifact": false, "exempt_stages": ["backlog"] }',
+                    description: 'Stage-gate enforcement config (pipeline only). Example: { "require_comment": true, "require_artifact": false, "exempt_stages": ["backlog"] }',
                     properties: {
                         require_comment: {
                             type: 'boolean',
@@ -297,588 +296,129 @@ export const tools = [
                         },
                     },
                 },
+                id: { type: 'string', description: 'Session ID (session only)' },
+                name: { type: 'string', description: 'Session name (session only)' },
+                mode: {
+                    type: 'string',
+                    enum: ['retention', 'stale_agents', 'all'],
+                    description: 'Cleanup mode (cleanup only, default: retention)',
+                },
+                timeout_minutes: {
+                    type: 'number',
+                    description: 'Heartbeat timeout in minutes for stale agent detection (cleanup only, default: 30)',
+                },
+                format: {
+                    type: 'string',
+                    enum: ['mdc', 'claude_md'],
+                    description: 'Output format for rules: mdc (Cursor) or claude_md (Claude Code)',
+                },
             },
+            required: ['action'],
         },
     },
     {
-        name: 'task_set_session',
-        description: 'Set the session identity for this connection (used to track who creates/claims tasks).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                id: { type: 'string', description: 'Session ID' },
-                name: { type: 'string', description: 'Session name' },
-            },
-            required: ['id', 'name'],
-        },
-    },
-    {
-        name: 'task_delete',
-        description: 'Delete a task and all its artifacts and dependencies (cascading delete).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: { type: 'number', description: 'Task ID to delete' },
-            },
-            required: ['task_id'],
-        },
-    },
-    {
-        name: 'task_comment',
-        description: 'Add a comment to a task for async discussion between agents.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: { type: 'number', description: 'Task ID' },
-                content: { type: 'string', description: 'Comment text' },
-                parent_comment_id: { type: 'number', description: 'Reply to this comment (threading)' },
-            },
-            required: ['task_id', 'content'],
-        },
-    },
-    {
-        name: 'task_get_comments',
-        description: 'Get comments on a task.',
+        name: 'task_dependency',
+        description: 'Manage task dependencies. "add" → create a blocks/related/duplicate relationship between two tasks (blocks advancement until resolved). "remove" → delete a dependency.',
         inputSchema: {
             type: 'object',
             properties: {
-                task_id: { type: 'number', description: 'Task ID' },
-                limit: { type: 'number', description: 'Max comments (default: 100)' },
+                action: {
+                    type: 'string',
+                    enum: ['add', 'remove'],
+                    description: 'Action to perform',
+                },
+                task_id: { type: 'number', description: 'Task that depends on another' },
+                depends_on: {
+                    type: 'number',
+                    description: 'Task that must complete first (for blocks) or related task',
+                },
+                relationship: {
+                    type: 'string',
+                    enum: ['blocks', 'related', 'duplicate'],
+                    description: 'Relationship type (default: blocks, only used with "add")',
+                },
             },
-            required: ['task_id'],
+            required: ['action', 'task_id', 'depends_on'],
         },
     },
     {
-        name: 'task_add_collaborator',
-        description: 'Add an agent as collaborator on a task (roles: collaborator, reviewer, watcher).',
+        name: 'task_collaborator',
+        description: 'Manage task collaborators. "add" → assign an agent as collaborator (can work on it), reviewer (reviews artifacts), or watcher (gets notifications). "remove" → unassign an agent.',
         inputSchema: {
             type: 'object',
             properties: {
+                action: {
+                    type: 'string',
+                    enum: ['add', 'remove'],
+                    description: 'Action to perform',
+                },
                 task_id: { type: 'number', description: 'Task ID' },
                 agent_id: { type: 'string', description: 'Agent name or ID' },
                 role: {
                     type: 'string',
                     enum: ['collaborator', 'reviewer', 'watcher'],
-                    description: 'Role (default: collaborator)',
+                    description: 'Role (default: collaborator, only used with "add")',
                 },
             },
-            required: ['task_id', 'agent_id'],
-        },
-    },
-    {
-        name: 'task_remove_collaborator',
-        description: 'Remove a collaborator from a task.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: { type: 'number', description: 'Task ID' },
-                agent_id: { type: 'string', description: 'Agent name or ID' },
-            },
-            required: ['task_id', 'agent_id'],
-        },
-    },
-    {
-        name: 'task_search',
-        description: 'Full-text search across task titles and descriptions.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                query: { type: 'string', description: 'Search query' },
-                project: { type: 'string', description: 'Filter by project' },
-                limit: { type: 'number', description: 'Max results (default: 50)' },
-            },
-            required: ['query'],
-        },
-    },
-    {
-        name: 'task_get_subtasks',
-        description: 'Get subtasks of a parent task.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: { type: 'number', description: 'Parent task ID' },
-            },
-            required: ['task_id'],
-        },
-    },
-    {
-        name: 'task_request_approval',
-        description: 'Request approval for a task at a specific stage.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: { type: 'number', description: 'Task ID' },
-                stage: { type: 'string', description: 'Stage requiring approval (defaults to current)' },
-                reviewer: { type: 'string', description: 'Specific reviewer to assign' },
-            },
-            required: ['task_id'],
-        },
-    },
-    {
-        name: 'task_approve',
-        description: 'Approve a pending approval request.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                approval_id: { type: 'number', description: 'Approval ID' },
-                comment: { type: 'string', description: 'Approval comment' },
-            },
-            required: ['approval_id'],
-        },
-    },
-    {
-        name: 'task_reject',
-        description: 'Reject a pending approval and optionally regress the task.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                approval_id: { type: 'number', description: 'Approval ID' },
-                comment: { type: 'string', description: 'Rejection reason (required)' },
-                regress_to: { type: 'string', description: 'Stage to regress task to' },
-            },
-            required: ['approval_id', 'comment'],
+            required: ['action', 'task_id', 'agent_id'],
         },
     },
     {
-        name: 'task_pending_approvals',
-        description: 'List pending approval requests, optionally filtered by reviewer.',
+        name: 'task_approval',
+        description: 'Manage approval workflows for stage gates. Actions: "request" → create approval request at current stage, "approve"/"reject" → decide on a pending approval, "list" → show pending approvals, "review" → convenience action that approves+advances or rejects+regresses in one call.',
         inputSchema: {
             type: 'object',
             properties: {
-                reviewer: { type: 'string', description: 'Filter by reviewer' },
-            },
-        },
-    },
-    {
-        name: 'task_review_cycle',
-        description: 'Review a task: approve (advance to next stage) or reject (regress with reason). Convenience wrapper for the maker-checker pattern.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: { type: 'number', description: 'Task ID to review' },
                 action: {
                     type: 'string',
-                    enum: ['approve', 'reject'],
-                    description: 'Approve or reject',
+                    enum: ['request', 'approve', 'reject', 'list', 'review'],
+                    description: 'Action to perform',
                 },
-                reason: { type: 'string', description: 'Rejection reason (required for reject)' },
-                regress_to: {
+                task_id: {
+                    type: 'number',
+                    description: 'Task ID (required for request and review)',
+                },
+                approval_id: {
+                    type: 'number',
+                    description: 'Approval ID (required for approve and reject)',
+                },
+                stage: {
                     type: 'string',
-                    description: 'Stage to regress to on rejection (default: implement)',
+                    description: 'Stage requiring approval (request only, defaults to current)',
                 },
-            },
-            required: ['task_id', 'action'],
-        },
-    },
-    {
-        name: 'task_expand',
-        description: 'Break a task into subtasks. Creates subtasks with parent_id pointing to the given task, inheriting project and priority.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: { type: 'number', description: 'Parent task ID to expand' },
-                subtasks: {
-                    type: 'array',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            title: { type: 'string', description: 'Subtask title' },
-                            description: { type: 'string', description: 'Subtask description' },
-                            priority: {
-                                type: 'number',
-                                description: 'Priority override (inherits from parent if omitted)',
-                            },
-                        },
-                        required: ['title'],
-                    },
-                    description: 'Array of subtasks to create',
+                reviewer: {
+                    type: 'string',
+                    description: 'Reviewer to assign (request) or filter by (list)',
                 },
-            },
-            required: ['task_id', 'subtasks'],
-        },
-    },
-    {
-        name: 'task_cleanup',
-        description: 'Run data cleanup. Modes: "retention" (default) purges old completed/cancelled tasks, "stale_agents" checks agent heartbeats and fails tasks from dead agents, "all" runs both.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                mode: {
+                comment: {
                     type: 'string',
-                    enum: ['retention', 'stale_agents', 'all'],
-                    description: 'Cleanup mode (default: retention)',
+                    description: 'Comment (optional for approve, required for reject)',
                 },
-                timeout_minutes: {
-                    type: 'number',
-                    description: 'Heartbeat timeout in minutes for stale agent detection (default: 30, only used with stale_agents mode)',
+                decision: {
+                    type: 'string',
+                    enum: ['approve', 'reject'],
+                    description: 'Decision for review action',
                 },
-            },
-        },
-    },
-    {
-        name: 'task_generate_rules',
-        description: 'Generate IDE-specific rule files that instruct agents to use the pipeline. Supports Cursor (.mdc) and Claude Code (CLAUDE.md) formats.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                format: {
+                reason: {
                     type: 'string',
-                    enum: ['mdc', 'claude_md'],
-                    description: 'Output format: mdc (Cursor) or claude_md (Claude Code)',
+                    description: 'Rejection reason (required for review+reject)',
+                },
+                regress_to: {
+                    type: 'string',
+                    description: 'Stage to regress to on rejection (reject/review, default: implement)',
                 },
-                project: { type: 'string', description: 'Project name for project-specific rules' },
-            },
-            required: ['format'],
-        },
-    },
-    {
-        name: 'task_decision',
-        description: 'Record an architectural or design decision as a structured artifact on a task. Stored at the current stage.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task_id: { type: 'number', description: 'Task ID to record the decision on' },
-                chose: { type: 'string', description: 'What was chosen' },
-                over: { type: 'string', description: 'What alternatives were considered' },
-                because: { type: 'string', description: 'Rationale for the decision' },
             },
-            required: ['task_id', 'chose', 'over', 'because'],
+            required: ['action'],
         },
     },
 ];
-// ---------------------------------------------------------------------------
-// Input validation helpers
-// ---------------------------------------------------------------------------
-function requireString(args, key) {
-    const val = args[key];
-    if (typeof val !== 'string' || !val.trim()) {
-        throw new ValidationError(`"${key}" must be a non-empty string.`);
-    }
-    return val;
-}
-function optString(args, key) {
-    const val = args[key];
-    if (val === undefined || val === null)
-        return undefined;
-    if (typeof val !== 'string')
-        throw new ValidationError(`"${key}" must be a string.`);
-    return val;
-}
-function requireNumber(args, key) {
-    const val = args[key];
-    if (typeof val !== 'number') {
-        throw new ValidationError(`"${key}" is required and must be a number.`);
-    }
-    return val;
-}
-function optNumber(args, key) {
-    const val = args[key];
-    if (val === undefined || val === null)
-        return undefined;
-    if (typeof val !== 'number')
-        throw new ValidationError(`"${key}" must be a number.`);
-    return val;
-}
-function optBoolean(args, key) {
-    const val = args[key];
-    if (val === undefined || val === null)
-        return undefined;
-    if (typeof val !== 'boolean')
-        throw new ValidationError(`"${key}" must be a boolean.`);
-    return val;
-}
-function optStringArray(args, key) {
-    const val = args[key];
-    if (val === undefined || val === null)
-        return undefined;
-    if (!Array.isArray(val) || !val.every((v) => typeof v === 'string')) {
-        throw new ValidationError(`"${key}" must be an array of strings.`);
-    }
-    return val;
-}
 export function createToolHandler(ctx) {
-    let currentSession = null;
-    function sessionName() {
-        return currentSession?.name ?? 'system';
-    }
+    const session = { current: null };
     return function handleTool(name, args) {
-        switch (name) {
-            case 'task_set_session': {
-                const id = requireString(args, 'id');
-                const sName = requireString(args, 'name');
-                currentSession = { id, name: sName };
-                writeSessionFile(id, sName);
-                return { success: true, id, name: sName };
-            }
-            case 'task_create': {
-                return ctx.tasks.create({
-                    title: requireString(args, 'title'),
-                    description: optString(args, 'description'),
-                    assign_to: optString(args, 'assign_to'),
-                    stage: optString(args, 'stage'),
-                    priority: optNumber(args, 'priority'),
-                    project: optString(args, 'project'),
-                    tags: optStringArray(args, 'tags'),
-                    parent_id: optNumber(args, 'parent_id'),
-                }, sessionName());
-            }
-            case 'task_list': {
-                return ctx.tasks.list({
-                    status: optString(args, 'status'),
-                    assigned_to: optString(args, 'assigned_to'),
-                    stage: optString(args, 'stage'),
-                    project: optString(args, 'project'),
-                    parent_id: optNumber(args, 'parent_id'),
-                    root_only: optBoolean(args, 'root_only'),
-                    collaborator: optString(args, 'collaborator'),
-                    limit: optNumber(args, 'limit'),
-                    offset: optNumber(args, 'offset'),
-                });
-            }
-            case 'task_claim': {
-                const claimer = optString(args, 'claimer') ?? sessionName();
-                return ctx.tasks.claim(requireNumber(args, 'task_id'), claimer);
-            }
-            case 'task_complete':
-                return ctx.tasks.complete(requireNumber(args, 'task_id'), requireString(args, 'result'));
-            case 'task_fail':
-                return ctx.tasks.fail(requireNumber(args, 'task_id'), requireString(args, 'result'));
-            case 'task_cancel':
-                return ctx.tasks.cancel(requireNumber(args, 'task_id'), requireString(args, 'reason'));
-            case 'task_advance': {
-                const advanceTaskId = requireNumber(args, 'task_id');
-                const advanceComment = optString(args, 'comment');
-                const advanced = ctx.tasks.advance(advanceTaskId, optString(args, 'stage'), advanceComment);
-                if (advanceComment) {
-                    ctx.comments.add(advanceTaskId, sessionName(), advanceComment);
-                }
-                return advanced;
-            }
-            case 'task_regress':
-                return ctx.tasks.regress(requireNumber(args, 'task_id'), requireString(args, 'stage'), optString(args, 'reason'));
-            case 'task_update':
-                return ctx.tasks.update(requireNumber(args, 'task_id'), {
-                    title: optString(args, 'title'),
-                    description: optString(args, 'description'),
-                    priority: optNumber(args, 'priority'),
-                    project: optString(args, 'project'),
-                    tags: optStringArray(args, 'tags'),
-                    assigned_to: optString(args, 'assign_to'),
-                });
-            case 'task_next': {
-                return (ctx.tasks.next(optString(args, 'project'), optString(args, 'stage')) ?? {
-                    message: 'No available tasks.',
-                });
-            }
-            case 'task_add_dependency': {
-                const relationship = (optString(args, 'relationship') ?? 'blocks');
-                ctx.tasks.addDependency(requireNumber(args, 'task_id'), requireNumber(args, 'depends_on'), relationship);
-                return { success: true, task_id: args.task_id, depends_on: args.depends_on, relationship };
-            }
-            case 'task_remove_dependency': {
-                ctx.tasks.removeDependency(requireNumber(args, 'task_id'), requireNumber(args, 'depends_on'));
-                return { success: true };
-            }
-            case 'task_add_artifact': {
-                return ctx.tasks.addArtifact(requireNumber(args, 'task_id'), requireString(args, 'name'), requireString(args, 'content'), sessionName(), optString(args, 'stage'));
-            }
-            case 'task_get_artifacts':
-                return ctx.tasks.getArtifacts(requireNumber(args, 'task_id'), optString(args, 'stage'));
-            case 'task_pipeline_config': {
-                const stages = optStringArray(args, 'stages');
-                const gateConfig = args.gate_config;
-                const project = optString(args, 'project') || 'default';
-                if (stages) {
-                    ctx.tasks.setPipelineConfig(project, stages);
-                }
-                if (gateConfig && typeof gateConfig === 'object') {
-                    const parsedGates = {};
-                    if (gateConfig.gates && typeof gateConfig.gates === 'object') {
-                        for (const [stageName, stageRule] of Object.entries(gateConfig.gates)) {
-                            parsedGates[stageName] = {
-                                require_artifacts: Array.isArray(stageRule.require_artifacts)
-                                    ? stageRule.require_artifacts
-                                    : undefined,
-                                require_min_artifacts: typeof stageRule.require_min_artifacts === 'number'
-                                    ? stageRule.require_min_artifacts
-                                    : undefined,
-                                require_comment: stageRule.require_comment === true ? true : undefined,
-                                require_approval: stageRule.require_approval === true ? true : undefined,
-                            };
-                        }
-                    }
-                    ctx.tasks.setGateConfig(project, {
-                        require_comment: gateConfig.require_comment === true,
-                        require_artifact: gateConfig.require_artifact === true,
-                        exempt_stages: Array.isArray(gateConfig.exempt_stages)
-                            ? gateConfig.exempt_stages
-                            : undefined,
-                        gates: Object.keys(parsedGates).length > 0 ? parsedGates : undefined,
-                    });
-                }
-                if (stages || gateConfig) {
-                    const config = ctx.tasks.getGateConfig(project);
-                    return {
-                        stages: ctx.tasks.getPipelineStages(project),
-                        gate_config: config ?? { require_comment: false },
-                    };
-                }
-                return {
-                    stages: ctx.tasks.getPipelineStages(optString(args, 'project')),
-                    gate_config: ctx.tasks.getGateConfig(optString(args, 'project')) ?? {
-                        require_comment: false,
-                    },
-                };
-            }
-            case 'task_delete': {
-                ctx.tasks.delete(requireNumber(args, 'task_id'));
-                return { success: true };
-            }
-            case 'task_comment': {
-                return ctx.comments.add(requireNumber(args, 'task_id'), sessionName(), requireString(args, 'content'), optNumber(args, 'parent_comment_id'));
-            }
-            case 'task_get_comments':
-                return ctx.comments.list(requireNumber(args, 'task_id'), optNumber(args, 'limit'));
-            case 'task_add_collaborator': {
-                return ctx.collaborators.add(requireNumber(args, 'task_id'), requireString(args, 'agent_id'), (optString(args, 'role') ?? 'collaborator'));
-            }
-            case 'task_remove_collaborator': {
-                ctx.collaborators.remove(requireNumber(args, 'task_id'), requireString(args, 'agent_id'));
-                return { success: true };
-            }
-            case 'task_search':
-                return ctx.tasks.search(requireString(args, 'query'), {
-                    project: optString(args, 'project'),
-                    limit: optNumber(args, 'limit'),
-                });
-            case 'task_get_subtasks':
-                return ctx.tasks.getSubtasks(requireNumber(args, 'task_id'));
-            case 'task_request_approval': {
-                const taskId = requireNumber(args, 'task_id');
-                const task = ctx.tasks.getById(taskId);
-                if (!task)
-                    throw new ValidationError(`Task ${taskId} not found.`);
-                const stage = optString(args, 'stage') ?? task.stage;
-                return ctx.approvals.request(taskId, stage, optString(args, 'reviewer'));
-            }
-            case 'task_approve':
-                return ctx.approvals.approve(requireNumber(args, 'approval_id'), sessionName(), optString(args, 'comment'));
-            case 'task_reject': {
-                const approval = ctx.approvals.reject(requireNumber(args, 'approval_id'), sessionName(), requireString(args, 'comment'));
-                const regressTo = optString(args, 'regress_to');
-                if (regressTo) {
-                    ctx.tasks.regress(approval.task_id, regressTo, requireString(args, 'comment'));
-                }
-                return approval;
-            }
-            case 'task_pending_approvals':
-                return ctx.approvals.getPending(optString(args, 'reviewer'));
-            case 'task_review_cycle': {
-                const taskId = requireNumber(args, 'task_id');
-                const action = requireString(args, 'action');
-                const task = ctx.tasks.getById(taskId);
-                if (!task)
-                    throw new ValidationError(`Task ${taskId} not found.`);
-                if (action === 'approve') {
-                    ctx.tasks.advance(taskId);
-                    return { success: true, action: 'approved', task: ctx.tasks.getById(taskId) };
-                }
-                else if (action === 'reject') {
-                    const reason = requireString(args, 'reason');
-                    const regressTo = optString(args, 'regress_to') ?? 'implement';
-                    ctx.tasks.regress(taskId, regressTo, reason);
-                    return { success: true, action: 'rejected', task: ctx.tasks.getById(taskId) };
-                }
-                else {
-                    throw new ValidationError(`Invalid action: ${action}. Use "approve" or "reject".`);
-                }
-            }
-            case 'task_expand': {
-                const parentId = requireNumber(args, 'task_id');
-                const parent = ctx.tasks.getById(parentId);
-                if (!parent)
-                    throw new ValidationError(`Task ${parentId} not found.`);
-                const subtaskDefs = args.subtasks;
-                if (!Array.isArray(subtaskDefs) || subtaskDefs.length === 0) {
-                    throw new ValidationError('"subtasks" must be a non-empty array.');
-                }
-                const created = [];
-                for (const sub of subtaskDefs) {
-                    if (typeof sub !== 'object' ||
-                        sub === null ||
-                        typeof sub.title !== 'string') {
-                        throw new ValidationError('Each subtask must have a "title" string.');
-                    }
-                    const s = sub;
-                    created.push(ctx.tasks.create({
-                        title: s.title,
-                        description: s.description ?? undefined,
-                        priority: typeof s.priority === 'number' ? s.priority : parent.priority,
-                        project: parent.project ?? undefined,
-                        parent_id: parentId,
-                    }, sessionName()));
-                }
-                return created;
-            }
-            case 'task_cleanup': {
-                const cleanupMode = (optString(args, 'mode') ?? 'retention');
-                const timeoutMinutes = optNumber(args, 'timeout_minutes');
-                if (cleanupMode === 'stale_agents') {
-                    return ctx.cleanup.failStaleAgentTasks(timeoutMinutes).then((stale) => ({
-                        stale_agents: stale,
-                    }));
-                }
-                if (cleanupMode === 'all') {
-                    const retention = ctx.cleanup.run();
-                    return ctx.cleanup.failStaleAgentTasks(timeoutMinutes).then((stale) => ({
-                        retention,
-                        stale_agents: stale,
-                    }));
-                }
-                return ctx.cleanup.run();
-            }
-            case 'task_generate_rules': {
-                const format = requireString(args, 'format');
-                if (format !== 'mdc' && format !== 'claude_md') {
-                    throw new ValidationError('Format must be "mdc" or "claude_md".');
-                }
-                const project = optString(args, 'project');
-                const stages = ctx.tasks.getPipelineStages(project);
-                return { rules: generateRules(format, stages, project) };
-            }
-            case 'task_decision': {
-                const taskId = requireNumber(args, 'task_id');
-                const chose = requireString(args, 'chose');
-                const over = requireString(args, 'over');
-                const because = requireString(args, 'because');
-                const task = ctx.tasks.getById(taskId);
-                if (!task)
-                    throw new ValidationError(`Task ${taskId} not found.`);
-                const decisionStage = task.stage;
-                const decisionContent = [
-                    '## Decision',
-                    `**Chose:** ${chose}`,
-                    `**Over:** ${over}`,
-                    `**Because:** ${because}`,
-                    '',
-                    `_Recorded at stage: ${decisionStage}_`,
-                ].join('\n');
-                return ctx.tasks.addArtifact(taskId, decisionStage, 'decision', decisionContent);
-            }
-            default:
-                throw new ValidationError(`Unknown tool: ${name}`);
-        }
+        const handler = handlers[name];
+        if (!handler)
+            throw new ValidationError(`Unknown tool: ${name}`);
+        return handler(ctx, args, session);
     };
 }
-function writeSessionFile(id, name) {
-    try {
-        const claudeDir = join(homedir(), '.claude');
-        mkdirSync(claudeDir, { recursive: true });
-        const filePath = join(claudeDir, `hub-session.${id}.json`);
-        writeFileSync(filePath, JSON.stringify({ pid: process.pid, name, id, timestamp: new Date().toISOString() }));
-    }
-    catch {
-        /* non-critical */
-    }
-}
 //# sourceMappingURL=mcp.js.map