@specforge/mcp 1.5.2 → 1.6.0

package/dist/tools/index.js

@@ -14,7 +14,9 @@
  * - Search: Search, find by file/tag, find related
  * - Git: Link commits and PRs, get linked items
  */
-import { ValidationError, ApiError, validateToolArgs, formatMCPError, transformError, } from '../validation/index.js';
+import { ValidationError, ApiError, validateToolArgs, formatMCPError, transformError, validateTicket, filterWarningsByStrictness, } from '../validation/index.js';
+import { resolvePatternsWithCache, getPatternOverrides, flattenCodeStandards, } from '../patterns/index.js';
+import { getResponseModeFromArgs, formatWriteResponse, } from '../lib/response.js';
 /**
  * Get list of all available tools
  *
@@ -23,8 +25,91 @@ import { ValidationError, ApiError, validateToolArgs, formatMCPError, transformE
  *
  * @returns Array of tool definitions
  */
+/**
+ * Format parameter definition for read operations
+ * Allows AI agents to request TOON-formatted responses for token efficiency
+ */
+const FORMAT_PARAMETER = {
+    type: 'string',
+    enum: ['json', 'toon'],
+    description: 'Output format. Use "toon" for ~44% token reduction. Default: "json"',
+    default: 'json',
+};
+/**
+ * List of read operation tool names that support the format parameter
+ * Write operations (create_*, update_*, report_*, etc.) are excluded
+ */
+const READ_TOOL_NAMES = new Set([
+    // Project operations
+    'list_projects',
+    'get_project',
+    'lookup_project',
+    // Specification operations
+    'list_specifications',
+    'get_specification',
+    'lookup_specification',
+    'get_specification_status',
+    // Epic operations
+    'list_epics',
+    'get_epic',
+    'lookup_epic',
+    'get_epic_status',
+    // Ticket operations
+    'list_tickets',
+    'get_ticket',
+    'lookup_ticket',
+    'lookup_tickets_by_status',
+    'get_ticket_dependencies',
+    'get_ticket_test_status',
+    // Dependency operations
+    'get_dependency_tree',
+    // Context operations
+    'get_implementation_context',
+    'get_next_actionable_tickets',
+    'get_blocked_tickets',
+    'get_critical_path',
+    'get_patterns',
+    // Workflow read operations
+    'get_work_summary',
+    // Discovery read operations
+    'get_pending_discoveries',
+    // Status & Analytics
+    'get_implementation_summary',
+    'get_time_report',
+    'get_blockers_report',
+    // Search operations
+    'search_tickets',
+    'find_tickets_by_file',
+    'find_tickets_by_tag',
+    'find_related_tickets',
+    // Git read operations
+    'get_ticket_commits',
+    'get_ticket_prs',
+    // Working context
+    'get_working_context',
+    // Session read operations
+    'get_session',
+    'list_sessions',
+    // Job status
+    'get_job_status',
+]);
+/**
+ * Add format parameter to a tool's input schema
+ */
+function addFormatParameter(tool) {
+    return {
+        ...tool,
+        inputSchema: {
+            ...tool.inputSchema,
+            properties: {
+                ...tool.inputSchema.properties,
+                format: FORMAT_PARAMETER,
+            },
+        },
+    };
+}
 export function getTools() {
-    return [
+    const tools = [
         // ========================================================================
         // Core Operations - Projects (Epic 3)
         // ========================================================================
@@ -51,12 +136,26 @@ export function getTools() {
                 required: ['projectId'],
             },
         },
+        {
+            name: 'lookup_project',
+            description: 'Fast project lookup by name. Returns minimal data (id, name, specCount) for token efficiency. Use this instead of list_projects when you just need to find a project ID.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                        description: 'Project name to search for (partial match, case-insensitive)',
+                    },
+                },
+                required: ['name'],
+            },
+        },
         // ========================================================================
         // Core Operations - Specifications (Epic 3)
         // ========================================================================
         {
             name: 'list_specifications',
-            description: 'List specifications for a project with optional status filter',
+            description: 'List specifications for a project with optional status and field filters. Supports pagination with limit/offset. Use fields to select specific fields and reduce token usage.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -72,13 +171,60 @@ export function getTools() {
                         },
                         description: 'Filter by status (optional)',
                     },
+                    limit: {
+                        type: 'integer',
+                        minimum: 1,
+                        maximum: 100,
+                        description: 'Maximum number of items to return (default: 20, max: 100)',
+                    },
+                    offset: {
+                        type: 'integer',
+                        minimum: 0,
+                        description: 'Number of items to skip for offset-based pagination (default: 0)',
+                    },
+                    fields: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: [
+                                'id',
+                                'projectId',
+                                'title',
+                                'description',
+                                'background',
+                                'status',
+                                'priority',
+                                'estimatedHours',
+                                'goals',
+                                'requirements',
+                                'constraints',
+                                'guardrails',
+                                'techStack',
+                                'architecture',
+                                'fileStructure',
+                                'epicCount',
+                                'ticketCount',
+                                'completedTicketCount',
+                                'createdAt',
+                                'updatedAt',
+                            ],
+                        },
+                        description: 'Select specific fields to return. Returns all fields if not specified. id is always included. Example: ["id", "title", "status"] for minimal response.',
+                    },
                 },
                 required: ['projectId'],
             },
         },
         {
             name: 'get_specification',
-            description: 'Get full specification with goals, requirements, constraints, and guardrails',
+            description: `Get specification with optional summary mode or full details.
+
+Use summary: true for minimal response (~70 tokens) with key fields only (id, title, status, priority, epicCount, ticketCount, completedTicketCount).
+
+Optional includes (ignored when summary=true):
+- 'status': Progress, ticket counts, blockers (replaces get_specification_status)
+- 'epics': List of epics with summary data
+- 'patterns': Tech stack, code patterns, naming conventions`,
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -86,16 +232,47 @@ export function getTools() {
                         type: 'string',
                         description: 'The ID of the specification to retrieve',
                     },
+                    summary: {
+                        type: 'boolean',
+                        description: 'Return minimal summary fields only (~70 tokens vs ~600 full). Ignores include parameter when true. Default: false',
+                        default: false,
+                    },
+                    include: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['status', 'epics', 'patterns'],
+                        },
+                        description: 'Optional data to include in response (ignored when summary=true)',
+                    },
                 },
                 required: ['specificationId'],
             },
         },
+        {
+            name: 'lookup_specification',
+            description: 'Fast specification lookup by title. Returns minimal data (id, title, status, epicCount, ticketCount) for token efficiency.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    projectId: {
+                        type: 'string',
+                        description: 'Project ID to search within',
+                    },
+                    title: {
+                        type: 'string',
+                        description: 'Specification title to search for (partial match, case-insensitive)',
+                    },
+                },
+                required: ['projectId', 'title'],
+            },
+        },
         // ========================================================================
         // Core Operations - Epics (Epic 3)
         // ========================================================================
         {
             name: 'list_epics',
-            description: 'List epics for a specification with optional status filter',
+            description: 'List epics for a specification with optional status and field filters. Supports pagination with limit/offset. Use fields to select specific fields and reduce token usage.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -108,13 +285,56 @@ export function getTools() {
                         enum: ['todo', 'in_progress', 'completed'],
                         description: 'Filter by status (optional)',
                     },
+                    limit: {
+                        type: 'integer',
+                        minimum: 1,
+                        maximum: 100,
+                        description: 'Maximum number of items to return (default: 20, max: 100)',
+                    },
+                    offset: {
+                        type: 'integer',
+                        minimum: 0,
+                        description: 'Number of items to skip for offset-based pagination (default: 0)',
+                    },
+                    fields: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: [
+                                'id',
+                                'specificationId',
+                                'epicNumber',
+                                'title',
+                                'description',
+                                'objective',
+                                'status',
+                                'priority',
+                                'estimatedHours',
+                                'acceptanceCriteria',
+                                'scope',
+                                'constraints',
+                                'assumptions',
+                                'ticketCount',
+                                'completedTicketCount',
+                                'createdAt',
+                                'updatedAt',
+                            ],
+                        },
+                        description: 'Select specific fields to return. Returns all fields if not specified. id is always included. Example: ["id", "epicNumber", "title", "status"] for minimal response.',
+                    },
                 },
                 required: ['specificationId'],
             },
         },
         {
             name: 'get_epic',
-            description: 'Get epic with scope, goals, acceptance criteria, and ticket summary',
+            description: `Get epic with optional summary mode or full details.
+
+Use summary: true for minimal response (~80 tokens) with key fields only (id, epicNumber, title, status, objective, ticketCount, completedTicketCount).
+
+Optional includes (ignored when summary=true):
+- 'status': Progress percentage, ticket counts, active tickets (replaces get_epic_status)
+- 'tickets': List of tickets with summary data`,
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -122,16 +342,51 @@ export function getTools() {
                         type: 'string',
                         description: 'The ID of the epic to retrieve',
                     },
+                    summary: {
+                        type: 'boolean',
+                        description: 'Return minimal summary fields only (~80 tokens vs ~400 full). Ignores include parameter when true. Default: false',
+                        default: false,
+                    },
+                    include: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['status', 'tickets'],
+                        },
+                        description: 'Optional data to include in response (ignored when summary=true)',
+                    },
                 },
                 required: ['epicId'],
             },
         },
+        {
+            name: 'lookup_epic',
+            description: "Fast epic lookup by number or title. Returns minimal data (id, number, title, status, ticketCount). Use 'number' for exact match, 'title' for partial match.",
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    specificationId: {
+                        type: 'string',
+                        description: 'Specification ID to search within',
+                    },
+                    number: {
+                        type: 'integer',
+                        description: 'Epic number for exact match lookup',
+                    },
+                    title: {
+                        type: 'string',
+                        description: 'Epic title for partial match lookup',
+                    },
+                },
+                required: ['specificationId'],
+            },
+        },
         // ========================================================================
         // Core Operations - Tickets (Epic 3)
         // ========================================================================
         {
             name: 'list_tickets',
-            description: 'List tickets for an epic with optional status filter',
+            description: 'List tickets for an epic with optional status and field filters. Supports pagination with limit/offset. Use fields to select specific fields and reduce token usage. Use include: ["statusReason"] to get reasons why pending tickets are blocked.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -143,9 +398,60 @@ export function getTools() {
                         type: 'array',
                         items: {
                             type: 'string',
-                            enum: ['todo', 'queue', 'in_progress', 'blocked', 'done'],
+                            enum: ['pending', 'ready', 'active', 'done'],
                         },
-                        description: 'Filter by status (optional)',
+                        description: 'Filter by status (optional). pending/ready are auto-calculated based on dependencies.',
+                    },
+                    limit: {
+                        type: 'integer',
+                        minimum: 1,
+                        maximum: 100,
+                        description: 'Maximum number of items to return (default: 20, max: 100)',
+                    },
+                    offset: {
+                        type: 'integer',
+                        minimum: 0,
+                        description: 'Number of items to skip for offset-based pagination (default: 0)',
+                    },
+                    include: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['statusReason'],
+                        },
+                        description: 'Include statusReason for pending tickets (shows unsatisfied dependencies or block reasons)',
+                    },
+                    fields: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: [
+                                'id',
+                                'epicId',
+                                'ticketNumber',
+                                'title',
+                                'description',
+                                'status',
+                                'priority',
+                                'complexity',
+                                'estimatedHours',
+                                'actualHours',
+                                'acceptanceCriteria',
+                                'implementation',
+                                'technicalDetails',
+                                'notes',
+                                'tags',
+                                'blockReason',
+                                'progress',
+                                'testsPassed',
+                                'order',
+                                'startedAt',
+                                'completedAt',
+                                'createdAt',
+                                'updatedAt',
+                            ],
+                        },
+                        description: 'Select specific fields to return. Returns all fields if not specified. id is always included. Example: ["id", "ticketNumber", "title", "status"] for minimal response (~60 tokens per ticket vs ~500 full).',
                     },
                 },
                 required: ['epicId'],
@@ -153,7 +459,18 @@ export function getTools() {
         },
         {
             name: 'get_ticket',
-            description: 'Get full ticket details including implementation steps, acceptance criteria, and dependencies',
+            description: `Get ticket with optional summary mode or full details.
+
+Use summary: true for minimal response (~100 tokens) with key fields only (id, ticketNumber, title, status, complexity, estimatedHours, priority).
+
+For full details, statusReason is auto-included for pending tickets explaining why the ticket is blocked.
+
+Optional includes (ignored when summary=true):
+- 'dependencies': Tickets this blocks and is blocked by (replaces get_ticket_dependencies)
+- 'testStatus': Test results and history (replaces get_ticket_test_status)
+- 'commits': Linked git commits (replaces get_ticket_commits)
+- 'prs': Linked pull requests (replaces get_ticket_prs)
+- 'statusReason': Why ticket is pending (auto-included for pending tickets)`,
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -161,10 +478,61 @@ export function getTools() {
                         type: 'string',
                         description: 'The ID of the ticket to retrieve',
                     },
+                    summary: {
+                        type: 'boolean',
+                        description: 'Return minimal summary fields only (~100 tokens vs ~500 full). Ignores include parameter when true. Default: false',
+                        default: false,
+                    },
+                    include: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['dependencies', 'testStatus', 'commits', 'prs', 'statusReason'],
+                        },
+                        description: 'Additional data to include (ignored when summary=true). statusReason is auto-included for pending tickets.',
+                    },
                 },
                 required: ['ticketId'],
             },
         },
+        {
+            name: 'lookup_ticket',
+            description: "Fast ticket lookup by number or title. Returns minimal data (id, number, title, status, complexity). Use 'number' for exact match, 'title' for partial match.",
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    epicId: {
+                        type: 'string',
+                        description: 'Epic ID to search within',
+                    },
+                    number: {
+                        type: 'integer',
+                        description: 'Ticket number for exact match lookup',
+                    },
+                    title: {
+                        type: 'string',
+                        description: 'Ticket title for partial match lookup',
+                    },
+                },
+                required: ['epicId'],
+            },
+        },
+        {
+            name: 'lookup_tickets_by_status',
+            description: 'Batch lookup of ticket statuses. Optimized for checking if dependencies are satisfied. Returns minimal data (id, status, title) for up to 50 tickets.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ticketIds: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        maxItems: 50,
+                        description: 'Array of ticket IDs to lookup (max 50)',
+                    },
+                },
+                required: ['ticketIds'],
+            },
+        },
         // ========================================================================
         // Core Operations - Dependencies (Epic 3)
         // ========================================================================
@@ -245,7 +613,7 @@ export function getTools() {
         // ========================================================================
         {
             name: 'get_implementation_context',
-            description: 'Get full implementation context for a ticket including spec, epic, dependencies, and patterns',
+            description: 'Get implementation context for a ticket. Use depth parameter to control response size: minimal (~300 tokens) for quick status checks, standard (~800 tokens) for typical implementation, full (~2000 tokens) for complex debugging.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -253,13 +621,19 @@ export function getTools() {
                         type: 'string',
                         description: 'The ID of the ticket',
                     },
+                    depth: {
+                        type: 'string',
+                        enum: ['minimal', 'standard', 'full'],
+                        description: 'Context depth level. minimal: ticket essentials + dependency status (~300 tokens). standard: ticket + epic summary + blockers (~800 tokens). full: complete context with patterns and history (~2000 tokens). Default: standard',
+                        default: 'standard',
+                    },
                 },
                 required: ['ticketId'],
             },
         },
         {
             name: 'get_next_actionable_tickets',
-            description: 'Get tickets that can be worked on now (all dependencies satisfied). Can query by specification or project.',
+            description: 'Get tickets with status "ready" (all dependencies satisfied). Use start_work_session() to begin work on these tickets.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -280,7 +654,7 @@ export function getTools() {
         },
         {
             name: 'get_blocked_tickets',
-            description: 'Get tickets that are blocked with reasons why',
+            description: 'Get tickets with status "pending" and their statusReason explaining why they are blocked (unsatisfied dependencies or external block)',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -308,16 +682,19 @@ export function getTools() {
         },
         {
             name: 'get_patterns',
-            description: 'Extract tech stack, code patterns, and naming conventions from specification',
+            description: 'Get patterns for a specification or ticket with full inheritance chain. When ticketId is provided, returns resolved patterns with spec → epic → ticket inheritance.',
             inputSchema: {
                 type: 'object',
                 properties: {
                     specificationId: {
                         type: 'string',
-                        description: 'The ID of the specification',
+                        description: 'Get patterns for entire specification (raw spec patterns only)',
+                    },
+                    ticketId: {
+                        type: 'string',
+                        description: 'Get resolved patterns for a specific ticket with inheritance chain and override analysis',
                     },
                 },
-                required: ['specificationId'],
             },
         },
         // ========================================================================
@@ -325,7 +702,7 @@ export function getTools() {
         // ========================================================================
         {
             name: 'start_work_session',
-            description: 'Start working on a ticket - validates dependencies are satisfied',
+            description: 'Start working on a ticket. Transitions ready -> active. Returns error with statusReason if ticket is pending (dependencies not met).',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -339,7 +716,15 @@ export function getTools() {
         },
         {
             name: 'complete_work_session',
-            description: 'Mark a ticket as complete with summary and results',
+            description: 'Mark a ticket as complete. Transitions active -> done.\n\n' +
+                'Automatically recalculates status for dependent tickets and returns cascade info.\n\n' +
+                'By default, checks if summary addresses acceptance criteria and returns warnings (not errors) for gaps.\n\n' +
+                'Use validated: true as a simple confirmation that the agent has verified all work meets criteria.\n\n' +
+                'Optional validation flags can be provided to report test results inline:\n' +
+                '- tests: Unit/integration test results\n' +
+                '- lint: Linting results\n' +
+                '- typeCheck: TypeScript type checking\n' +
+                '- build: Build/compilation results',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -361,6 +746,52 @@ export function getTools() {
                         items: { type: 'string' },
                         description: 'List of files created',
                     },
+                    actualHours: {
+                        type: 'number',
+                        description: 'Actual hours spent on the ticket',
+                    },
+                    validated: {
+                        type: 'boolean',
+                        description: 'Simple validation confirmation. When true, indicates:\n' +
+                            '- Agent has verified work meets acceptance criteria\n' +
+                            '- All necessary tests/validations were run and passed\n' +
+                            '- No detailed breakdown needed\n' +
+                            'Trust-based approach for streamlined completion.',
+                    },
+                    validation: {
+                        type: 'object',
+                        description: 'Detailed validation flags (optional with validated: true)',
+                        properties: {
+                            tests: {
+                                type: 'string',
+                                enum: ['passed', 'failed', 'skipped', 'na'],
+                                description: 'Unit/integration test results',
+                            },
+                            lint: {
+                                type: 'string',
+                                enum: ['passed', 'failed', 'skipped', 'na'],
+                                description: 'Linting results',
+                            },
+                            typeCheck: {
+                                type: 'string',
+                                enum: ['passed', 'failed', 'skipped', 'na'],
+                                description: 'TypeScript type checking results',
+                            },
+                            build: {
+                                type: 'string',
+                                enum: ['passed', 'failed', 'skipped', 'na'],
+                                description: 'Build/compilation results',
+                            },
+                            notes: {
+                                type: 'string',
+                                description: 'Additional validation notes',
+                            },
+                        },
+                    },
+                    skipCriteriaCheck: {
+                        type: 'boolean',
+                        description: 'Skip acceptance criteria validation. Use for trivial changes or when criteria check is not needed. Default: false',
+                    },
                 },
                 required: ['ticketId', 'summary'],
             },
@@ -391,7 +822,7 @@ export function getTools() {
         },
         {
             name: 'get_work_summary',
-            description: 'Get summary of completed work with optional scope filtering',
+            description: '[DEPRECATED: Use get_report with type="work"] Get summary of completed work with optional scope filtering',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -421,7 +852,7 @@ export function getTools() {
         // ========================================================================
         {
             name: 'report_test_results',
-            description: 'Report test results for a ticket',
+            description: '[DEPRECATED] Report test results for a ticket. Use complete_work_session({ validation: { tests: "passed", ... } }) instead. Will be removed in v3.0.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -476,7 +907,7 @@ export function getTools() {
         },
         {
             name: 'get_ticket_test_status',
-            description: 'Get test status and history for a ticket',
+            description: "[DEPRECATED] Get test status and history for a ticket. Use get_ticket({ include: ['testStatus'] }) instead. Will be removed in v3.0.",
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -490,7 +921,7 @@ export function getTools() {
         },
         {
             name: 'validate_ticket_completion',
-            description: 'Validate that a ticket is ready to be marked complete',
+            description: '[DEPRECATED] Validate that a ticket is ready to be marked complete. Validation is now built into complete_work_session(). Will be removed in v3.0.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -503,11 +934,11 @@ export function getTools() {
             },
         },
         // ========================================================================
-        // Discovery Tools (Epic 7)
+        // Discovery Tools (Epic 7) - DEPRECATED: Use tag-based ticket operations instead
         // ========================================================================
         {
             name: 'report_discovery',
-            description: 'Report a discovery (new requirement, bug, or improvement) found during implementation',
+            description: '[DEPRECATED: Use create_ticket with tags: ["discovery", "discovery:<type>"] instead] Report a discovery (new requirement, bug, or improvement) found during implementation',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -539,7 +970,7 @@ export function getTools() {
         },
         {
             name: 'get_pending_discoveries',
-            description: 'Get pending discoveries that need resolution',
+            description: '[DEPRECATED: Use search_tickets with tags: ["discovery"] and status filter instead] Get pending discoveries that need resolution',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -557,7 +988,7 @@ export function getTools() {
         },
         {
             name: 'resolve_discovery',
-            description: 'Resolve a discovery as created (new ticket) or dismissed',
+            description: '[DEPRECATED: Use update_ticket to mark done or remove discovery tag instead] Resolve a discovery as created (new ticket) or dismissed',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -613,9 +1044,56 @@ export function getTools() {
                 required: ['epicId'],
             },
         },
+        {
+            name: 'get_report',
+            description: `Generate unified reports for implementation, time tracking, blockers, or work summary.
+
+Report types:
+- 'implementation': Progress, velocity, completions (replaces get_implementation_summary)
+- 'time': Estimated vs actual hours (replaces get_time_report)
+- 'blockers': Blocked tickets with reasons (replaces get_blockers_report)
+- 'work': Completed work summary (replaces get_work_summary)
+
+Format options:
+- 'json': Full structured data (default)
+- 'summary': Condensed text summary`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    type: {
+                        type: 'string',
+                        enum: ['implementation', 'time', 'blockers', 'work'],
+                        description: 'Type of report to generate',
+                    },
+                    scope: {
+                        type: 'string',
+                        enum: ['project', 'specification', 'epic'],
+                        description: 'Scope of the report',
+                    },
+                    scopeId: {
+                        type: 'string',
+                        description: 'ID of the scoped entity (projectId, specificationId, or epicId)',
+                    },
+                    format: {
+                        type: 'string',
+                        enum: ['json', 'toon', 'summary'],
+                        description: 'Output format: json (full structured), toon (~44% smaller), summary (key metrics only ~70% smaller). Default: json',
+                    },
+                    startDate: {
+                        type: 'string',
+                        description: 'Start date for work report (ISO 8601)',
+                    },
+                    endDate: {
+                        type: 'string',
+                        description: 'End date for work report (ISO 8601)',
+                    },
+                },
+                required: ['type', 'scope', 'scopeId'],
+            },
+        },
         {
             name: 'get_implementation_summary',
-            description: 'Get cross-specification implementation summary with velocity metrics',
+            description: '[DEPRECATED: Use get_report with type="implementation"] Get cross-specification implementation summary with velocity metrics',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -629,7 +1107,7 @@ export function getTools() {
         },
         {
             name: 'get_time_report',
-            description: 'Get time tracking report with estimated vs actual analysis',
+            description: '[DEPRECATED: Use get_report with type="time"] Get time tracking report with estimated vs actual analysis',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -648,7 +1126,7 @@ export function getTools() {
         },
         {
             name: 'get_blockers_report',
-            description: 'Get report of all blockers with duration and grouping',
+            description: '[DEPRECATED: Use get_report with type="blockers"] Get report of all blockers with duration and grouping',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -669,37 +1147,124 @@ export function getTools() {
         // ========================================================================
         {
             name: 'search_tickets',
-            description: 'Full-text search across tickets with relevance ranking',
+            description: `Unified ticket search with multiple filter options.
+
+Combines:
+- Full-text search (query)
+- File matching (files) - replaces find_tickets_by_file
+- Tag filtering (tags) - replaces find_tickets_by_tag
+- Related tickets (relatedTo) - replaces find_related_tickets
+- Status, complexity, priority filters
+
+At least one of: query, files, tags, or relatedTo is required.
+At least one scope filter (projectId, specificationId, or epicId) is required.`,
             inputSchema: {
                 type: 'object',
                 properties: {
                     query: {
                         type: 'string',
-                        description: 'Search query',
+                        description: 'Full-text search query',
                     },
-                    specificationId: {
+                    files: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Glob patterns to match ticket files (e.g., "**/channel/*.ts")',
+                    },
+                    tags: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Tags to filter by',
+                    },
+                    matchAllTags: {
+                        type: 'boolean',
+                        description: 'If true, match all tags (AND). If false, match any (OR). Default: false',
+                    },
+                    relatedTo: {
                         type: 'string',
-                        description: 'Limit search to specification (optional)',
+                        description: 'Find tickets related to this ticket ID (by tags, files, tech stack)',
+                    },
+                    status: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['pending', 'ready', 'active', 'done'],
+                        },
+                        description: 'Filter by status',
+                    },
+                    complexity: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['small', 'medium', 'large', 'xlarge'],
+                        },
+                        description: 'Filter by complexity',
+                    },
+                    priority: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['low', 'medium', 'high', 'critical'],
+                        },
+                        description: 'Filter by priority',
                     },
                     projectId: {
                         type: 'string',
-                        description: 'Limit search to project (optional)',
+                        description: 'Limit search to project',
+                    },
+                    specificationId: {
+                        type: 'string',
+                        description: 'Limit search to specification',
+                    },
+                    epicId: {
+                        type: 'string',
+                        description: 'Limit search to epic',
                     },
                     limit: {
                         type: 'number',
-                        description: 'Maximum results (default: 20)',
+                        description: 'Maximum results (default: 20, max: 100)',
                     },
                     offset: {
                         type: 'number',
                         description: 'Pagination offset (default: 0)',
                     },
+                    fields: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: [
+                                'id',
+                                'epicId',
+                                'ticketNumber',
+                                'title',
+                                'description',
+                                'status',
+                                'priority',
+                                'complexity',
+                                'estimatedHours',
+                                'actualHours',
+                                'acceptanceCriteria',
+                                'implementation',
+                                'technicalDetails',
+                                'notes',
+                                'tags',
+                                'blockReason',
+                                'progress',
+                                'testsPassed',
+                                'order',
+                                'startedAt',
+                                'completedAt',
+                                'createdAt',
+                                'updatedAt',
+                            ],
+                        },
+                        description: 'Select specific fields to return. Returns all fields if not specified. id is always included. Example: ["id", "ticketNumber", "title", "status"] for minimal results.',
+                    },
                 },
-                required: ['query'],
             },
         },
         {
             name: 'find_tickets_by_file',
-            description: 'Find tickets that modify or create specific files (supports glob patterns)',
+            description: '[DEPRECATED: Use search_tickets with files parameter] Find tickets that modify or create specific files (supports glob patterns)',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -721,7 +1286,7 @@ export function getTools() {
         },
         {
             name: 'find_tickets_by_tag',
-            description: 'Find tickets by tags with AND/OR logic',
+            description: '[DEPRECATED: Use search_tickets with tags parameter] Find tickets by tags with AND/OR logic',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -748,7 +1313,7 @@ export function getTools() {
         },
         {
             name: 'find_related_tickets',
-            description: 'Find tickets related to a given ticket based on files, tags, and tech stack',
+            description: '[DEPRECATED: Use search_tickets with relatedTo parameter] Find tickets related to a given ticket based on files, tags, and tech stack',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -833,7 +1398,7 @@ export function getTools() {
         },
         {
             name: 'get_ticket_commits',
-            description: 'Get all commits linked to a ticket',
+            description: "[DEPRECATED: Use get_ticket with include: ['commits'] instead] Get all commits linked to a ticket",
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -855,7 +1420,7 @@ export function getTools() {
         },
         {
             name: 'get_ticket_prs',
-            description: 'Get all pull requests linked to a ticket',
+            description: "[DEPRECATED: Use get_ticket with include: ['prs'] instead] Get all pull requests linked to a ticket",
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -1023,6 +1588,48 @@ export function getTools() {
                             required: ['title', 'description', 'objective'],
                         },
                     },
+                    // Pattern inheritance fields (specification level)
+                    codeStandards: {
+                        type: 'object',
+                        description: 'Code standards inherited by all epics/tickets',
+                        properties: {
+                            language: { type: 'string', description: 'Primary language (e.g., "TypeScript")' },
+                            asyncPattern: { type: 'string', description: 'Async pattern (e.g., "async/await")' },
+                            errorHandling: { type: 'string', description: 'Error handling approach' },
+                            documentation: { type: 'string', description: 'Documentation style' },
+                            testing: { type: 'string', description: 'Testing approach' },
+                            naming: {
+                                type: 'object',
+                                description: 'Naming conventions',
+                                properties: {
+                                    files: { type: 'string', description: 'File naming convention' },
+                                    functions: { type: 'string', description: 'Function naming convention' },
+                                    interfaces: { type: 'string', description: 'Interface naming convention' },
+                                    actions: { type: 'string', description: 'Action naming convention' },
+                                },
+                            },
+                        },
+                    },
+                    commonImports: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Common imports inherited by all epics/tickets',
+                    },
+                    returnTypes: {
+                        type: 'object',
+                        description: 'Standard return types for CRUD operations',
+                        properties: {
+                            create: { type: 'string', description: 'Return type for create operations' },
+                            update: { type: 'string', description: 'Return type for update operations' },
+                            delete: { type: 'string', description: 'Return type for delete operations' },
+                            list: { type: 'string', description: 'Return type for list operations' },
+                        },
+                    },
+                    responseMode: {
+                        type: 'string',
+                        enum: ['full', 'minimal', 'id-only'],
+                        description: 'Response verbosity: full (default, ~500 tokens), minimal (~50 tokens), id-only (~20 tokens)',
+                    },
                 },
                 required: ['projectId', 'title'],
             },
@@ -1129,7 +1736,7 @@ export function getTools() {
                     },
                     tickets: {
                         type: 'array',
-                        description: 'Nested tickets to create (bulk creation)',
+                        description: 'Nested tickets to create (bulk creation) with optional inline dependencies',
                         items: {
                             type: 'object',
                             properties: {
@@ -1138,17 +1745,57 @@ export function getTools() {
                                 acceptanceCriteria: { type: 'array', items: { type: 'string' } },
                                 estimatedHours: { type: 'number' },
                                 complexity: { type: 'string', enum: ['small', 'medium', 'large', 'xlarge'] },
+                                priority: { type: 'string', enum: ['high', 'medium', 'low'] },
+                                implementation: { type: 'object', description: 'Implementation details' },
+                                technicalDetails: { type: 'object', description: 'Technical details' },
+                                tags: { type: 'array', items: { type: 'string' } },
+                                dependsOn: {
+                                    type: 'array',
+                                    items: { type: 'number' },
+                                    description: 'Indexes of other tickets in this array that this ticket depends on',
+                                },
                             },
                             required: ['title'],
                         },
                     },
+                    // Pattern inheritance fields (epic level)
+                    sharedPatterns: {
+                        type: 'object',
+                        description: 'Patterns shared by all tickets in this epic',
+                        properties: {
+                            errorHandling: { type: 'string', description: 'Override error handling for this epic' },
+                            returnType: { type: 'string', description: 'Epic-specific return type' },
+                            actionPrefix: { type: 'string', description: 'Redux/action prefix for this epic' },
+                            stateSlice: { type: 'string', description: 'State slice path for this epic' },
+                        },
+                    },
+                    additionalImports: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Additional imports for tickets in this epic (added to spec-level imports)',
+                    },
+                    commonFiles: {
+                        type: 'object',
+                        description: 'Common file paths for this epic',
+                        properties: {
+                            reducer: { type: 'string', description: 'Reducer file path' },
+                            actions: { type: 'string', description: 'Actions file path' },
+                            types: { type: 'string', description: 'Types file path' },
+                            index: { type: 'string', description: 'Index/barrel file path' },
+                        },
+                    },
+                    responseMode: {
+                        type: 'string',
+                        enum: ['full', 'minimal', 'id-only'],
+                        description: 'Response verbosity: full (default, ~500 tokens), minimal (~50 tokens), id-only (~20 tokens)',
+                    },
                 },
                 required: ['specificationId', 'title', 'description', 'objective'],
             },
         },
         {
             name: 'create_ticket',
-            description: 'Create a new ticket in an epic',
+            description: 'Create a new ticket in an epic. Returns validation warnings based on complexity level.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -1209,6 +1856,20 @@ export function getTools() {
                         items: { type: 'string' },
                         description: 'Array of ticket IDs this ticket depends on',
                     },
+                    skipValidation: {
+                        type: 'boolean',
+                        description: 'Skip validation and completeness scoring. Default: false',
+                    },
+                    validationStrictness: {
+                        type: 'string',
+                        enum: ['lenient', 'normal', 'strict'],
+                        description: 'Warning strictness level. lenient=warnings only, normal=warnings+recommendations, strict=all. Default: normal',
+                    },
+                    responseMode: {
+                        type: 'string',
+                        enum: ['full', 'minimal', 'id-only'],
+                        description: 'Response verbosity: full (default, ~500 tokens), minimal (~50 tokens), id-only (~20 tokens)',
+                    },
                 },
                 required: ['epicId', 'title'],
             },
@@ -1244,7 +1905,9 @@ export function getTools() {
         // ========================================================================
         {
             name: 'update_ticket',
-            description: "Update a ticket's properties (status, description, estimate, etc.)",
+            description: "Update a ticket's properties (status, description, estimate, etc.).\n\n" +
+                'When status changes, counts are automatically propagated up the hierarchy ' +
+                '(Epic → Specification → Project).',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -1262,8 +1925,8 @@ export function getTools() {
                     },
                     status: {
                         type: 'string',
-                        enum: ['todo', 'queue', 'in_progress', 'blocked', 'done'],
-                        description: 'New status (optional)',
+                        enum: ['pending', 'ready', 'active', 'done'],
+                        description: 'Ticket status. pending/ready may be recalculated based on dependencies.',
                     },
                     priority: {
                         type: 'string',
@@ -1277,7 +1940,7 @@ export function getTools() {
                     },
                     blockReason: {
                         type: 'string',
-                        description: 'Reason why ticket is blocked (optional, typically used when status is blocked)',
+                        description: 'External block reason. Forces status to pending until cleared.',
                     },
                     notes: {
                         type: 'string',
@@ -1305,6 +1968,22 @@ export function getTools() {
                         type: 'object',
                         description: 'Technical details like stack, endpoints (JSON) (optional)',
                     },
+                    skipValidation: {
+                        type: 'boolean',
+                        description: 'Skip validation and completeness scoring (default: false)',
+                        default: false,
+                    },
+                    validationStrictness: {
+                        type: 'string',
+                        enum: ['lenient', 'normal', 'strict'],
+                        description: 'Warning strictness level (default: normal)',
+                        default: 'normal',
+                    },
+                    responseMode: {
+                        type: 'string',
+                        enum: ['full', 'minimal', 'id-only'],
+                        description: 'Response verbosity: full (default, ~500 tokens), minimal (~50 tokens), id-only (~20 tokens)',
+                    },
                 },
                 required: ['ticketId'],
             },
@@ -1406,6 +2085,37 @@ export function getTools() {
                         enum: ['low', 'medium', 'high', 'critical'],
                         description: 'Priority level (optional)',
                     },
+                    // Pattern inheritance fields (epic level)
+                    sharedPatterns: {
+                        type: 'object',
+                        description: 'Patterns shared by all tickets in this epic (optional)',
+                        properties: {
+                            errorHandling: { type: 'string', description: 'Override error handling for this epic' },
+                            returnType: { type: 'string', description: 'Epic-specific return type' },
+                            actionPrefix: { type: 'string', description: 'Redux/action prefix for this epic' },
+                            stateSlice: { type: 'string', description: 'State slice path for this epic' },
+                        },
+                    },
+                    additionalImports: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Additional imports for tickets in this epic (optional)',
+                    },
+                    commonFiles: {
+                        type: 'object',
+                        description: 'Common file paths for this epic (optional)',
+                        properties: {
+                            reducer: { type: 'string', description: 'Reducer file path' },
+                            actions: { type: 'string', description: 'Actions file path' },
+                            types: { type: 'string', description: 'Types file path' },
+                            index: { type: 'string', description: 'Index/barrel file path' },
+                        },
+                    },
+                    responseMode: {
+                        type: 'string',
+                        enum: ['full', 'minimal', 'id-only'],
+                        description: 'Response verbosity: full (default, ~500 tokens), minimal (~50 tokens), id-only (~20 tokens)',
+                    },
                 },
                 required: ['epicId'],
             },
@@ -1551,6 +2261,48 @@ export function getTools() {
                         type: 'string',
                         description: 'Output directory for build artifacts (optional)',
                     },
+                    // Pattern inheritance fields (specification level)
+                    codeStandards: {
+                        type: 'object',
+                        description: 'Code standards inherited by all epics/tickets (optional)',
+                        properties: {
+                            language: { type: 'string', description: 'Primary language (e.g., "TypeScript")' },
+                            asyncPattern: { type: 'string', description: 'Async pattern (e.g., "async/await")' },
+                            errorHandling: { type: 'string', description: 'Error handling approach' },
+                            documentation: { type: 'string', description: 'Documentation style' },
+                            testing: { type: 'string', description: 'Testing approach' },
+                            naming: {
+                                type: 'object',
+                                description: 'Naming conventions',
+                                properties: {
+                                    files: { type: 'string', description: 'File naming convention' },
+                                    functions: { type: 'string', description: 'Function naming convention' },
+                                    interfaces: { type: 'string', description: 'Interface naming convention' },
+                                    actions: { type: 'string', description: 'Action naming convention' },
+                                },
+                            },
+                        },
+                    },
+                    commonImports: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Common imports inherited by all epics/tickets (optional)',
+                    },
+                    returnTypes: {
+                        type: 'object',
+                        description: 'Standard return types for CRUD operations (optional)',
+                        properties: {
+                            create: { type: 'string', description: 'Return type for create operations' },
+                            update: { type: 'string', description: 'Return type for update operations' },
+                            delete: { type: 'string', description: 'Return type for delete operations' },
+                            list: { type: 'string', description: 'Return type for list operations' },
+                        },
+                    },
+                    responseMode: {
+                        type: 'string',
+                        enum: ['full', 'minimal', 'id-only'],
+                        description: 'Response verbosity: full (default, ~500 tokens), minimal (~50 tokens), id-only (~20 tokens)',
+                    },
                 },
                 required: ['specificationId'],
             },
@@ -1644,7 +2396,7 @@ export function getTools() {
         },
         {
             name: 'get_session',
-            description: 'Get session by ID or get active session for specification',
+            description: "[DEPRECATED: Use get_specification with include: ['session'] instead] Get session by ID or get active session for specification",
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -1666,7 +2418,7 @@ export function getTools() {
         },
         {
             name: 'update_session',
-            description: 'Update session state (pause/resume, update config, add notes)',
+            description: '[DEPRECATED: Use end_session() then create_session() with new config instead] Update session state (pause/resume, update config, add notes)',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -1697,7 +2449,7 @@ export function getTools() {
         },
         {
             name: 'record_session_ticket',
-            description: 'Record a ticket completion/failure within a session. Returns next actionable ticket if available.',
+            description: '[DEPRECATED: Use complete_work_session() which auto-records in active session] Record a ticket completion/failure within a session. Returns next actionable ticket if available.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -1755,7 +2507,7 @@ export function getTools() {
         },
         {
             name: 'list_sessions',
-            description: 'List sessions with filtering by specification, project, or status',
+            description: "[DEPRECATED: Use get_report({ type: 'work' }) for work summaries] List sessions with filtering by specification, project, or status",
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -1790,6 +2542,147 @@ export function getTools() {
         // ========================================================================
         // Bulk Operations
         // ========================================================================
+        {
+            name: 'bulk_create_tickets',
+            description: 'Create multiple tickets in an epic with optional inline dependencies in a single atomic transaction. Reduces 15+ API calls to one.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    epicId: {
+                        type: 'string',
+                        description: 'The ID of the epic to create tickets in',
+                    },
+                    tickets: {
+                        type: 'array',
+                        description: 'Array of ticket definitions to create',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                title: { type: 'string', description: 'Ticket title (required)' },
+                                description: { type: 'string', description: 'Ticket description' },
+                                estimatedHours: { type: 'number', description: 'Estimated hours' },
+                                complexity: {
+                                    type: 'string',
+                                    enum: ['small', 'medium', 'large', 'xlarge'],
+                                    description: 'Complexity level',
+                                },
+                                priority: {
+                                    type: 'string',
+                                    enum: ['high', 'medium', 'low'],
+                                    description: 'Priority level',
+                                },
+                                acceptanceCriteria: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'Acceptance criteria',
+                                },
+                                implementation: {
+                                    type: 'object',
+                                    description: 'Implementation details (filesToCreate, filesToModify, steps, etc.)',
+                                },
+                                technicalDetails: {
+                                    type: 'object',
+                                    description: 'Technical details (files, stack, endpoints, etc.)',
+                                },
+                                tags: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'Tags',
+                                },
+                            },
+                            required: ['title'],
+                        },
+                    },
+                    dependencies: {
+                        type: 'array',
+                        description: 'Optional inline dependencies using array indexes',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                ticket: {
+                                    type: 'number',
+                                    description: 'Index of the ticket in the tickets array',
+                                },
+                                dependsOn: {
+                                    oneOf: [
+                                        { type: 'number', description: 'Index of the ticket it depends on' },
+                                        {
+                                            type: 'array',
+                                            items: { type: 'number' },
+                                            description: 'Indexes of the tickets it depends on',
+                                        },
+                                    ],
+                                    description: 'Index(es) of the ticket(s) it depends on',
+                                },
+                            },
+                            required: ['ticket', 'dependsOn'],
+                        },
+                    },
+                    onError: {
+                        type: 'string',
+                        enum: ['rollback', 'continue'],
+                        description: "Error handling mode: 'rollback' stops and undoes all, 'continue' skips failures (default: 'continue')",
+                    },
+                },
+                required: ['epicId', 'tickets'],
+            },
+        },
+        {
+            name: 'get_job_status',
+            description: 'Get the status of an asynchronous bulk operation job. For batches >= 20 items, bulk operations return a job ID for async processing.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    jobId: {
+                        type: 'string',
+                        description: 'The job ID returned from a bulk operation',
+                    },
+                },
+                required: ['jobId'],
+            },
+        },
+        {
+            name: 'bulk_add_dependencies',
+            description: 'Add multiple dependencies between tickets in a single atomic transaction.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    dependencies: {
+                        type: 'array',
+                        description: 'Array of dependency definitions',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                ticketId: {
+                                    type: 'string',
+                                    description: 'ID of the ticket that will depend on another',
+                                },
+                                dependsOnId: {
+                                    type: 'string',
+                                    description: 'ID of the ticket it will depend on',
+                                },
+                                type: {
+                                    type: 'string',
+                                    enum: ['blocks', 'requires'],
+                                    description: "Type of dependency (default: 'requires')",
+                                },
+                            },
+                            required: ['ticketId', 'dependsOnId'],
+                        },
+                    },
+                    skipCircularCheck: {
+                        type: 'boolean',
+                        description: 'Skip validation of circular dependencies (default: false)',
+                    },
+                    onError: {
+                        type: 'string',
+                        enum: ['rollback', 'continue'],
+                        description: "Error handling mode: 'rollback' stops and undoes all, 'continue' skips failures (default: 'continue')",
+                    },
+                },
+                required: ['dependencies'],
+            },
+        },
         {
             name: 'bulk_update_tickets',
             description: 'Update multiple tickets in a single atomic operation. All updates succeed or all fail (unless atomic: false).',
@@ -1807,8 +2700,8 @@ export function getTools() {
                                 },
                                 status: {
                                     type: 'string',
-                                    enum: ['todo', 'queue', 'in_progress', 'blocked', 'done'],
-                                    description: 'New status',
+                                    enum: ['pending', 'ready', 'active', 'done'],
+                                    description: 'Ticket status. Completing (done) triggers cascade to unblock dependents.',
                                 },
                                 priority: {
                                     type: 'string',
@@ -1823,7 +2716,7 @@ export function getTools() {
                                 },
                                 blockReason: {
                                     type: 'string',
-                                    description: 'Reason for blocking (when status is blocked)',
+                                    description: 'External block reason. Forces status to pending until cleared.',
                                 },
                             },
                             required: ['ticketId'],
@@ -1838,13 +2731,21 @@ export function getTools() {
                         type: 'boolean',
                         description: 'All-or-nothing updates. If false, partial success allowed (default: true)',
                     },
+                    responseMode: {
+                        type: 'string',
+                        enum: ['full', 'minimal', 'id-only'],
+                        description: `Response verbosity:
+              - full: Complete updated tickets (default, ~500 tokens per ticket)
+              - minimal: id, title, status per ticket (~50 tokens total)
+              - id-only: Array of updated ticket IDs only (~20 tokens total)`,
+                    },
                 },
                 required: ['updates'],
             },
         },
         {
             name: 'reset_tickets',
-            description: 'Reset tickets to todo/queue status. By default excludes completed tickets - use includeCompleted: true to also reset done tickets.',
+            description: 'Reset tickets to pending/ready status (calculated from dependencies). Returns statusCalculation showing how many became pending vs ready.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -1869,11 +2770,6 @@ export function getTools() {
                         type: 'boolean',
                         description: 'Reset all tickets in the specification',
                     },
-                    targetStatus: {
-                        type: 'string',
-                        enum: ['todo', 'queue'],
-                        description: 'Status to reset tickets to (default: todo)',
-                    },
                     resetDependents: {
                         type: 'boolean',
                         description: 'Also reset tickets that depend on the specified tickets (default: false)',
@@ -1894,7 +2790,47 @@ export function getTools() {
                 required: ['specificationId'],
             },
         },
+        // ========================================================================
+        // Validation Operations (MCI-075)
+        // ========================================================================
+        {
+            name: 'validate_counts',
+            description: 'Validate denormalized counts across the hierarchy. ' +
+                'Compares stored counts with actual data and optionally repairs discrepancies.\n\n' +
+                'Use this tool to:\n' +
+                '- Diagnose count inconsistencies\n' +
+                '- Repair counts after data migrations\n' +
+                '- Verify counts before bulk operations',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    projectId: {
+                        type: 'string',
+                        description: 'Validate all counts within a project',
+                    },
+                    specificationId: {
+                        type: 'string',
+                        description: 'Validate all counts within a specification',
+                    },
+                    epicId: {
+                        type: 'string',
+                        description: 'Validate counts for a single epic',
+                    },
+                    repair: {
+                        type: 'boolean',
+                        description: 'If true, fix any issues found. Default: false (dry run)',
+                    },
+                    verbose: {
+                        type: 'boolean',
+                        description: 'Include detailed breakdown in response',
+                    },
+                },
+                required: [],
+            },
+        },
     ];
+    // Apply format parameter to all read operations
+    return tools.map(tool => READ_TOOL_NAMES.has(tool.name) ? addFormatParameter(tool) : tool);
 }
 /**
  * Retry configuration for transient failures
@@ -1982,6 +2918,12 @@ export function createToolHandlers(apiClient) {
                 projectId: args.projectId,
             });
         },
+        lookup_project: async (_client, args) => {
+            validateRequired(args, 'name');
+            return await apiClient.call('lookup_project', {
+                name: args.name,
+            });
+        },
         // ========================================================================
         // Core Operations - Specifications
         // ========================================================================
@@ -1990,12 +2932,24 @@ export function createToolHandlers(apiClient) {
             return await apiClient.call('list_specifications', {
                 projectId: args.projectId,
                 status: args.status,
+                limit: args.limit,
+                offset: args.offset,
+                fields: args.fields,
             });
         },
         get_specification: async (_client, args) => {
             validateRequired(args, 'specificationId');
             return await apiClient.call('get_specification', {
                 specificationId: args.specificationId,
+                summary: args.summary,
+                include: args.include,
+            });
+        },
+        lookup_specification: async (_client, args) => {
+            validateRequired(args, 'projectId', 'title');
+            return await apiClient.call('lookup_specification', {
+                projectId: args.projectId,
+                title: args.title,
             });
         },
         // ========================================================================
@@ -2006,12 +2960,29 @@ export function createToolHandlers(apiClient) {
             return await apiClient.call('list_epics', {
                 specificationId: args.specificationId,
                 status: args.status,
+                limit: args.limit,
+                offset: args.offset,
+                fields: args.fields,
             });
         },
         get_epic: async (_client, args) => {
             validateRequired(args, 'epicId');
             return await apiClient.call('get_epic', {
                 epicId: args.epicId,
+                summary: args.summary,
+                include: args.include,
+            });
+        },
+        lookup_epic: async (_client, args) => {
+            validateRequired(args, 'specificationId');
+            // Must provide either title or number
+            if (!args.title && args.number === undefined) {
+                throw new Error("Must provide either 'title' or 'number'");
+            }
+            return await apiClient.call('lookup_epic', {
+                specificationId: args.specificationId,
+                title: args.title,
+                number: args.number,
             });
         },
         // ========================================================================
@@ -2022,12 +2993,53 @@ export function createToolHandlers(apiClient) {
             return await apiClient.call('list_tickets', {
                 epicId: args.epicId,
                 status: args.status,
+                limit: args.limit,
+                offset: args.offset,
+                include: args.include,
+                fields: args.fields,
             });
         },
         get_ticket: async (_client, args) => {
             validateRequired(args, 'ticketId');
             return await apiClient.call('get_ticket', {
                 ticketId: args.ticketId,
+                summary: args.summary,
+                include: args.include,
+            });
+        },
+        lookup_ticket: async (_client, args) => {
+            validateRequired(args, 'epicId');
+            // Must provide either title or number
+            if (!args.title && args.number === undefined) {
+                throw new Error("Must provide either 'title' or 'number'");
+            }
+            return await apiClient.call('lookup_ticket', {
+                epicId: args.epicId,
+                title: args.title,
+                number: args.number,
+            });
+        },
+        lookup_tickets_by_status: async (_client, args) => {
+            validateRequired(args, 'ticketIds');
+            if (!Array.isArray(args.ticketIds)) {
+                throw new Error('ticketIds must be an array');
+            }
+            const MAX_BATCH_SIZE = 50;
+            if (args.ticketIds.length > MAX_BATCH_SIZE) {
+                throw new Error(`Maximum ${MAX_BATCH_SIZE} tickets per call`);
+            }
+            // Empty array returns empty result
+            if (args.ticketIds.length === 0) {
+                return { tickets: [], notFound: [] };
+            }
+            // Validate all IDs are strings
+            for (let i = 0; i < args.ticketIds.length; i++) {
+                if (typeof args.ticketIds[i] !== 'string') {
+                    throw new Error(`ticketIds[${i}] must be a string`);
+                }
+            }
+            return await apiClient.call('lookup_tickets_by_status', {
+                ticketIds: args.ticketIds,
             });
         },
         // ========================================================================
@@ -2070,9 +3082,52 @@ export function createToolHandlers(apiClient) {
         // ========================================================================
         get_implementation_context: async (_client, args) => {
             validateRequired(args, 'ticketId');
-            return await apiClient.call('get_implementation_context', {
+            const depth = args.depth || 'standard';
+            // Fetch the implementation context from API with depth parameter
+            const context = await apiClient.call('get_implementation_context', {
                 ticketId: args.ticketId,
+                depth,
             });
+            // Only resolve inherited patterns for 'full' depth (minimal/standard don't include them)
+            if (depth === 'full' && context.specification && context.epic) {
+                const spec = context.specification;
+                const epic = context.epic;
+                const ticket = context.ticket;
+                try {
+                    const resolvedPatterns = resolvePatternsWithCache({
+                        ticketId: args.ticketId,
+                        specification: {
+                            id: spec.id,
+                            codeStandards: spec.codeStandards,
+                            commonImports: spec.commonImports,
+                            returnTypes: spec.returnTypes,
+                        },
+                        epic: {
+                            id: epic.id,
+                            sharedPatterns: epic.sharedPatterns,
+                            additionalImports: epic.additionalImports,
+                            commonFiles: epic.commonFiles,
+                        },
+                        ticket: ticket ? {
+                            id: ticket.id,
+                            technicalDetails: ticket.technicalDetails,
+                        } : undefined,
+                    });
+                    // Add inherited patterns to the response
+                    context.inheritedPatterns = {
+                        imports: resolvedPatterns.imports,
+                        patterns: resolvedPatterns.patterns,
+                        returnTypes: resolvedPatterns.returnTypes,
+                        commonFiles: resolvedPatterns.commonFiles,
+                        naming: resolvedPatterns.naming,
+                    };
+                }
+                catch {
+                    // If pattern resolution fails, return context without inherited patterns
+                    // This maintains backward compatibility
+                }
+            }
+            return context;
         },
         get_next_actionable_tickets: async (_client, args) => {
             // Either specificationId or projectId is required
@@ -2098,10 +3153,130 @@ export function createToolHandlers(apiClient) {
             });
         },
         get_patterns: async (_client, args) => {
-            validateRequired(args, 'specificationId');
-            return await apiClient.call('get_patterns', {
+            // Either specificationId or ticketId is required
+            if (!args.specificationId && !args.ticketId) {
+                throw new Error('Either specificationId or ticketId is required');
+            }
+            // If ticketId is provided, return resolved patterns with inheritance
+            if (args.ticketId) {
+                // Fetch ticket data
+                const ticket = await apiClient.call('get_ticket', {
+                    ticketId: args.ticketId,
+                });
+                // Get epic data
+                const epic = await apiClient.call('get_epic', {
+                    epicId: ticket.epicId,
+                });
+                // Get specification data
+                const spec = await apiClient.call('get_specification', {
+                    specificationId: epic.specificationId,
+                });
+                // Build pattern resolution input
+                const input = {
+                    ticketId: args.ticketId,
+                    specification: {
+                        id: spec.id,
+                        codeStandards: spec.codeStandards,
+                        commonImports: spec.commonImports,
+                        returnTypes: spec.returnTypes,
+                    },
+                    epic: {
+                        id: epic.id,
+                        sharedPatterns: epic.sharedPatterns,
+                        additionalImports: epic.additionalImports,
+                        commonFiles: epic.commonFiles,
+                    },
+                    ticket: {
+                        id: ticket.id,
+                        technicalDetails: ticket.technicalDetails,
+                    },
+                };
+                // Resolve patterns and get override info
+                const resolved = resolvePatternsWithCache(input);
+                const overrideReport = getPatternOverrides(input);
+                return {
+                    resolved: {
+                        imports: resolved.imports,
+                        patterns: resolved.patterns,
+                        returnTypes: resolved.returnTypes,
+                        commonFiles: resolved.commonFiles,
+                        naming: resolved.naming,
+                    },
+                    raw: {
+                        specification: {
+                            codeStandards: spec.codeStandards ?? null,
+                            commonImports: spec.commonImports ?? [],
+                            returnTypes: spec.returnTypes ?? null,
+                        },
+                        epic: {
+                            sharedPatterns: epic.sharedPatterns ?? null,
+                            additionalImports: epic.additionalImports ?? [],
+                            commonFiles: epic.commonFiles ?? null,
+                        },
+                        ticket: {
+                            patterns: ticket.technicalDetails?.patterns ?? null,
+                        },
+                    },
+                    overrides: overrideReport.overrides,
+                    chain: {
+                        specificationId: spec.id,
+                        specificationTitle: spec.title,
+                        epicId: epic.id,
+                        epicTitle: epic.title,
+                        ticketId: ticket.id,
+                        ticketTitle: ticket.title,
+                    },
+                };
+            }
+            // Specification-level query (backward compatible)
+            const specPatterns = await apiClient.call('get_patterns', {
                 specificationId: args.specificationId,
             });
+            // Get spec details for raw patterns if available
+            let specData = null;
+            try {
+                specData = await apiClient.call('get_specification', {
+                    specificationId: args.specificationId,
+                });
+            }
+            catch {
+                // If spec fetch fails, just return the raw response
+                return specPatterns;
+            }
+            // Return enhanced response with raw patterns
+            return {
+                resolved: {
+                    imports: specData.commonImports ?? [],
+                    patterns: flattenCodeStandards(specData.codeStandards),
+                    returnTypes: specData.returnTypes ?? {},
+                    commonFiles: {},
+                    naming: specData.codeStandards?.naming ?? {},
+                },
+                raw: {
+                    specification: {
+                        codeStandards: specData.codeStandards ?? null,
+                        commonImports: specData.commonImports ?? [],
+                        returnTypes: specData.returnTypes ?? null,
+                    },
+                    epic: {
+                        sharedPatterns: null,
+                        additionalImports: [],
+                        commonFiles: null,
+                    },
+                    ticket: {
+                        patterns: null,
+                    },
+                },
+                overrides: [],
+                chain: {
+                    specificationId: specData.id,
+                    specificationTitle: specData.title,
+                    epicId: '',
+                    epicTitle: '',
+                    ticketId: '',
+                    ticketTitle: '',
+                },
+            };
         },
         // ========================================================================
         // Workflow & Tracking
@@ -2119,6 +3294,10 @@ export function createToolHandlers(apiClient) {
                 summary: args.summary,
                 filesModified: args.filesModified,
                 filesCreated: args.filesCreated,
+                actualHours: args.actualHours,
+                validated: args.validated, // MCI-066: simple validation flag
+                validation: args.validation, // MCI-064: validation flags
+                skipCriteriaCheck: args.skipCriteriaCheck, // MCI-065: skip criteria check
             });
         },
         report_progress: async (_client, args) => {
@@ -2230,15 +3409,41 @@ export function createToolHandlers(apiClient) {
                 projectId: args.projectId,
             });
         },
+        get_report: async (_client, args) => {
+            validateRequired(args, 'type', 'scope', 'scopeId');
+            return await apiClient.call('get_report', {
+                type: args.type,
+                scope: args.scope,
+                scopeId: args.scopeId,
+                format: args.format ?? 'json',
+                startDate: args.startDate,
+                endDate: args.endDate,
+            });
+        },
         // ========================================================================
         // Search Tools
         // ========================================================================
         search_tickets: async (_client, args) => {
-            validateRequired(args, 'query');
+            // Validate at least one search criterion
+            if (!args.query && !args.files && !args.tags && !args.relatedTo) {
+                throw new Error('At least one filter is required: query, files, tags, or relatedTo');
+            }
+            // Validate at least one scope
+            if (!args.projectId && !args.specificationId && !args.epicId) {
+                throw new Error('One of projectId, specificationId, or epicId is required');
+            }
             return await apiClient.call('search_tickets', {
                 query: args.query,
+                files: args.files,
+                tags: args.tags,
+                matchAllTags: args.matchAllTags ?? false,
+                relatedTo: args.relatedTo,
+                status: args.status,
+                complexity: args.complexity,
+                priority: args.priority,
                 specificationId: args.specificationId,
                 projectId: args.projectId,
+                epicId: args.epicId,
                 limit: args.limit ?? 20,
                 offset: args.offset ?? 0,
             });
@@ -2316,7 +3521,8 @@ export function createToolHandlers(apiClient) {
         // ========================================================================
         create_specification: async (_client, args) => {
             validateRequired(args, 'projectId', 'title');
-            return await apiClient.call('create_specification', {
+            const responseMode = getResponseModeFromArgs(args);
+            const result = await apiClient.call('create_specification', {
                 projectId: args.projectId,
                 title: args.title,
                 description: args.description,
@@ -2345,10 +3551,54 @@ export function createToolHandlers(apiClient) {
                 apiContracts: args.apiContracts,
                 targetAudience: args.targetAudience,
             });
+            return formatWriteResponse(result, responseMode, 'Specification created');
         },
         create_epic: async (_client, args) => {
             validateRequired(args, 'specificationId', 'title', 'description', 'objective');
-            return await apiClient.call('create_epic', {
+            const responseMode = getResponseModeFromArgs(args);
+            // Validate inline dependencies if tickets are provided with dependsOn
+            if (args.tickets && Array.isArray(args.tickets)) {
+                const tickets = args.tickets;
+                const ticketCount = tickets.length;
+                for (let i = 0; i < ticketCount; i++) {
+                    const ticket = tickets[i];
+                    if (ticket.dependsOn && Array.isArray(ticket.dependsOn)) {
+                        for (const depIndex of ticket.dependsOn) {
+                            // Check bounds
+                            if (typeof depIndex !== 'number' || depIndex < 0 || depIndex >= ticketCount) {
+                                throw new Error(`tickets[${i}].dependsOn: index ${depIndex} is out of bounds (must be 0-${ticketCount - 1})`);
+                            }
+                            // Check self-reference
+                            if (depIndex === i) {
+                                throw new Error(`tickets[${i}].dependsOn: ticket cannot depend on itself`);
+                            }
+                        }
+                    }
+                }
+                // Check for circular dependencies using DFS
+                const hasCycle = (startIdx, visited, path) => {
+                    if (path.has(startIdx))
+                        return true;
+                    if (visited.has(startIdx))
+                        return false;
+                    visited.add(startIdx);
+                    path.add(startIdx);
+                    const deps = tickets[startIdx].dependsOn || [];
+                    for (const depIdx of deps) {
+                        if (hasCycle(depIdx, visited, path))
+                            return true;
+                    }
+                    path.delete(startIdx);
+                    return false;
+                };
+                const visited = new Set();
+                for (let i = 0; i < ticketCount; i++) {
+                    if (hasCycle(i, visited, new Set())) {
+                        throw new Error(`Circular dependency detected in tickets array`);
+                    }
+                }
+            }
+            const result = await apiClient.call('create_epic', {
                 specificationId: args.specificationId,
                 title: args.title,
                 description: args.description,
@@ -2374,10 +3624,18 @@ export function createToolHandlers(apiClient) {
                 dependencies: args.dependencies,
                 apiContracts: args.apiContracts,
             });
+            return formatWriteResponse(result, responseMode, 'Epic created');
         },
         create_ticket: async (_client, args) => {
             validateRequired(args, 'epicId', 'title');
-            return await apiClient.call('create_ticket', {
+            const responseMode = getResponseModeFromArgs(args);
+            // Extract validation options
+            const skipValidation = args.skipValidation === true;
+            const validationStrictness = args.validationStrictness === 'lenient' || args.validationStrictness === 'strict'
+                ? args.validationStrictness
+                : 'normal';
+            // Create the ticket
+            const result = await apiClient.call('create_ticket', {
                 epicId: args.epicId,
                 title: args.title,
                 ticketNumber: args.ticketNumber,
@@ -2392,6 +3650,22 @@ export function createToolHandlers(apiClient) {
                 order: args.order,
                 dependsOn: args.dependsOn,
             });
+            // Run validation unless skipped
+            if (!skipValidation) {
+                const validation = validateTicket({
+                    complexity: args.complexity,
+                    implementation: args.implementation,
+                    technicalDetails: args.technicalDetails,
+                    notes: args.notes,
+                    acceptanceCriteria: args.acceptanceCriteria,
+                });
+                // Filter warnings by strictness level
+                const warnings = filterWarningsByStrictness(validation.warnings, validationStrictness);
+                // Add validation results to response
+                result.warnings = warnings;
+                result.completenessScore = validation.completenessScore;
+            }
+            return formatWriteResponse(result, responseMode, 'Ticket created');
         },
         import_specification: async (_client, args) => {
             validateRequired(args, 'projectId', 'content');
@@ -2407,7 +3681,36 @@ export function createToolHandlers(apiClient) {
         // ========================================================================
         update_ticket: async (_client, args) => {
             validateRequired(args, 'ticketId');
-            return await apiClient.call('update_ticket', {
+            const responseMode = getResponseModeFromArgs(args);
+            // Extract validation options
+            const skipValidation = args.skipValidation === true;
+            const validationStrictness = args.validationStrictness === 'lenient' || args.validationStrictness === 'strict'
+                ? args.validationStrictness
+                : 'normal';
+            // Get current ticket to calculate previous completeness score
+            let previousCompletenessScore;
+            if (!skipValidation) {
+                try {
+                    const currentTicket = await apiClient.call('get_ticket', {
+                        ticketId: args.ticketId,
+                    });
+                    // Calculate previous completeness score
+                    const prevValidation = validateTicket({
+                        complexity: currentTicket.complexity,
+                        implementation: currentTicket.implementation,
+                        technicalDetails: currentTicket.technicalDetails,
+                        notes: currentTicket.notes,
+                        acceptanceCriteria: currentTicket.acceptanceCriteria,
+                    });
+                    previousCompletenessScore = prevValidation.completenessScore;
+                }
+                catch {
+                    // If we can't get the current ticket, skip previous score tracking
+                    previousCompletenessScore = undefined;
+                }
+            }
+            // Update the ticket
+            const result = await apiClient.call('update_ticket', {
                 ticketId: args.ticketId,
                 title: args.title,
                 description: args.description,
@@ -2423,10 +3726,32 @@ export function createToolHandlers(apiClient) {
                 technicalDetails: args.technicalDetails,
                 blockReason: args.blockReason,
             });
+            // Run validation on updated ticket unless skipped
+            if (!skipValidation) {
+                // Use the updated values (from args) merged with existing values (from result)
+                // The result should contain the final state after update
+                const validation = validateTicket({
+                    complexity: (args.complexity || result.complexity),
+                    implementation: (args.implementation || result.implementation),
+                    technicalDetails: (args.technicalDetails || result.technicalDetails),
+                    notes: (args.notes || result.notes),
+                    acceptanceCriteria: (args.acceptanceCriteria || result.acceptanceCriteria),
+                });
+                // Filter warnings by strictness level
+                const warnings = filterWarningsByStrictness(validation.warnings, validationStrictness);
+                // Add validation results to response
+                result.warnings = warnings;
+                result.completenessScore = validation.completenessScore;
+                if (previousCompletenessScore !== undefined) {
+                    result.previousCompletenessScore = previousCompletenessScore;
+                }
+            }
+            return formatWriteResponse(result, responseMode, 'Ticket updated');
         },
         update_epic: async (_client, args) => {
             validateRequired(args, 'epicId');
-            return await apiClient.call('update_epic', {
+            const responseMode = getResponseModeFromArgs(args);
+            const result = await apiClient.call('update_epic', {
                 epicId: args.epicId,
                 title: args.title,
                 description: args.description,
@@ -2449,10 +3774,12 @@ export function createToolHandlers(apiClient) {
                 tags: args.tags,
                 estimatedHours: args.estimatedHours,
             });
+            return formatWriteResponse(result, responseMode, 'Epic updated');
         },
         update_specification: async (_client, args) => {
             validateRequired(args, 'specificationId');
-            return await apiClient.call('update_specification', {
+            const responseMode = getResponseModeFromArgs(args);
+            const result = await apiClient.call('update_specification', {
                 specificationId: args.specificationId,
                 title: args.title,
                 description: args.description,
@@ -2483,6 +3810,7 @@ export function createToolHandlers(apiClient) {
                 workingDirectory: args.workingDirectory,
                 outputDirectory: args.outputDirectory,
             });
+            return formatWriteResponse(result, responseMode, 'Specification updated');
         },
         // ========================================================================
         // Working Context Operations
@@ -2559,6 +3887,74 @@ export function createToolHandlers(apiClient) {
         // ========================================================================
         // Bulk Operations
         // ========================================================================
+        bulk_create_tickets: async (_client, args) => {
+            validateRequired(args, 'epicId', 'tickets');
+            if (!Array.isArray(args.tickets) || args.tickets.length === 0) {
+                throw new Error('tickets array is required and must not be empty');
+            }
+            // Validate each ticket has a title
+            const tickets = args.tickets;
+            for (let i = 0; i < tickets.length; i++) {
+                if (!tickets[i].title || typeof tickets[i].title !== 'string') {
+                    throw new Error(`tickets[${i}].title is required and must be a string`);
+                }
+            }
+            // Validate dependencies if provided
+            if (args.dependencies && Array.isArray(args.dependencies)) {
+                const deps = args.dependencies;
+                for (let i = 0; i < deps.length; i++) {
+                    const dep = deps[i];
+                    if (typeof dep.ticket !== 'number' || dep.ticket < 0 || dep.ticket >= tickets.length) {
+                        throw new Error(`dependencies[${i}].ticket must be a valid index in tickets array (0-${tickets.length - 1})`);
+                    }
+                    const dependsOn = Array.isArray(dep.dependsOn) ? dep.dependsOn : [dep.dependsOn];
+                    for (const idx of dependsOn) {
+                        if (typeof idx !== 'number' || idx < 0 || idx >= tickets.length) {
+                            throw new Error(`dependencies[${i}].dependsOn contains invalid index ${idx} (must be 0-${tickets.length - 1})`);
+                        }
+                        if (idx === dep.ticket) {
+                            throw new Error(`dependencies[${i}]: ticket cannot depend on itself`);
+                        }
+                    }
+                }
+            }
+            return await apiClient.call('bulk_create_tickets', {
+                epicId: args.epicId,
+                tickets: args.tickets,
+                dependencies: args.dependencies,
+                onError: args.onError,
+            });
+        },
+        get_job_status: async (_client, args) => {
+            validateRequired(args, 'jobId');
+            return await apiClient.call('get_job_status', {
+                jobId: args.jobId,
+            });
+        },
+        bulk_add_dependencies: async (_client, args) => {
+            validateRequired(args, 'dependencies');
+            if (!Array.isArray(args.dependencies) || args.dependencies.length === 0) {
+                throw new Error('dependencies array is required and must not be empty');
+            }
+            // Validate each dependency has required fields
+            const deps = args.dependencies;
+            for (let i = 0; i < deps.length; i++) {
+                if (!deps[i].ticketId || typeof deps[i].ticketId !== 'string') {
+                    throw new Error(`dependencies[${i}].ticketId is required`);
+                }
+                if (!deps[i].dependsOnId || typeof deps[i].dependsOnId !== 'string') {
+                    throw new Error(`dependencies[${i}].dependsOnId is required`);
+                }
+                if (deps[i].ticketId === deps[i].dependsOnId) {
+                    throw new Error(`dependencies[${i}]: ticket cannot depend on itself`);
+                }
+            }
+            return await apiClient.call('bulk_add_dependencies', {
+                dependencies: args.dependencies,
+                skipCircularCheck: args.skipCircularCheck,
+                onError: args.onError,
+            });
+        },
         bulk_update_tickets: async (_client, args) => {
             if (!args.updates || !Array.isArray(args.updates) || args.updates.length === 0) {
                 throw new Error('updates array is required and must not be empty');
@@ -2584,6 +3980,22 @@ export function createToolHandlers(apiClient) {
                 clearTestResults: args.clearTestResults,
             });
         },
+        // ========================================================================
+        // Validation Operations (MCI-075)
+        // ========================================================================
+        validate_counts: async (_client, args) => {
+            // Must specify at least one scope
+            if (!args.projectId && !args.specificationId && !args.epicId) {
+                throw new Error('Must specify projectId, specificationId, or epicId');
+            }
+            return await apiClient.call('validate_counts', {
+                projectId: args.projectId,
+                specificationId: args.specificationId,
+                epicId: args.epicId,
+                repair: args.repair,
+                verbose: args.verbose,
+            });
+        },
     };
 }
 /**