@specforge/mcp 3.3.8 → 3.5.0

package/dist/tools/index.js

@@ -14,7 +14,7 @@
  * - Search: Search, find by file/tag, find related
  * - Git: Link commits and PRs, get linked items
  */
-import { ValidationError, ApiError, validateToolArgs, formatMCPError, transformError, validateTicket, filterWarningsByStrictness, } from '../validation/index.js';
+import { ValidationError, ApiError, validateToolArgs, formatMCPError, transformError, } from '../validation/index.js';
 import { resolvePatternsWithCache, getPatternOverrides, flattenCodeStandards, } from '../patterns/index.js';
 import { getResponseModeFromArgs, formatWriteResponse, } from '../lib/response.js';
 import { createFeedbackHandler } from './core/feedback.js';
@@ -33,75 +33,6 @@ import { findProjectRoot } from '../cli/config/paths.js';
  *
  * @returns Array of tool definitions
  */
-/**
- * Format parameter definition for read operations
- * Allows AI agents to request JSON or TOON-formatted responses
- */
-const FORMAT_PARAMETER = {
-    type: 'string',
-    enum: ['json', 'toon'],
-    description: 'Output format. TOON (default) provides ~44% token reduction. Use "json" for structured data processing.',
-    default: 'toon',
-};
-/**
- * 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',
-    // Blueprint operations
-    'blueprint',
-    // Epic operations
-    'list_epics',
-    'get_epic',
-    'lookup_epic',
-    // Ticket operations
-    'list_tickets',
-    'get_ticket',
-    'lookup_ticket',
-    'lookup_tickets_by_status',
-    // Dependency operations
-    'get_dependency_tree',
-    'check_circular_dependencies',
-    // Context operations
-    'get_implementation_context',
-    'get_next_actionable_tickets',
-    'get_blocked_tickets',
-    'get_critical_path',
-    'get_patterns',
-    // Status & Analytics
-    'get_report',
-    // Search operations
-    'search_tickets',
-    // Agent Teams (read operations)
-    'get_epic_dependency_graph',
-    'get_implementation_plan',
-    // Review operations
-    'review_planning',
-    'review_implementation',
-]);
-/**
- * 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() {
     const tools = [
         // ========================================================================
@@ -140,11 +71,6 @@ export function getTools() {
                         type: 'string',
                         description: 'Project name to search for (partial match, case-insensitive)',
                     },
-                    format: {
-                        type: 'string',
-                        enum: ['json', 'toon'],
-                        description: 'Output format (default: json)',
-                    },
                 },
                 required: ['name'],
             },
@@ -214,40 +140,6 @@ export function getTools() {
                 required: ['projectId'],
             },
         },
-        {
-            name: 'get_specification',
-            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: {
-                    specificationId: {
-                        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.',
@@ -262,11 +154,6 @@ Optional includes (ignored when summary=true):
                         type: 'string',
                         description: 'Specification title to search for (partial match, case-insensitive)',
                     },
-                    format: {
-                        type: 'string',
-                        enum: ['json', 'toon'],
-                        description: 'Output format (default: json)',
-                    },
                 },
                 required: ['projectId', 'title'],
             },
@@ -276,7 +163,7 @@ Optional includes (ignored when summary=true):
         // ========================================================================
         {
             name: 'list_epics',
-            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.',
+            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. During active planning sessions, field selection and result limits are automatically enforced.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -330,39 +217,6 @@ Optional includes (ignored when summary=true):
                 required: ['specificationId'],
             },
         },
-        {
-            name: 'get_epic',
-            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: {
-                    epicId: {
-                        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.",
@@ -381,11 +235,6 @@ Optional includes (ignored when summary=true):
                         type: 'string',
                         description: 'Epic title for partial match lookup',
                     },
-                    format: {
-                        type: 'string',
-                        enum: ['json', 'toon'],
-                        description: 'Output format (default: json)',
-                    },
                 },
                 required: ['specificationId'],
             },
@@ -395,7 +244,7 @@ Optional includes (ignored when summary=true):
         // ========================================================================
         {
             name: 'list_tickets',
-            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.',
+            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. During active planning sessions, field selection and result limits are automatically enforced.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -466,44 +315,6 @@ Optional includes (ignored when summary=true):
                 required: ['epicId'],
             },
         },
-        {
-            name: 'get_ticket',
-            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: {
-                    ticketId: {
-                        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.",
@@ -522,11 +333,6 @@ Optional includes (ignored when summary=true):
                         type: 'string',
                         description: 'Ticket title for partial match lookup',
                     },
-                    format: {
-                        type: 'string',
-                        enum: ['json', 'toon'],
-                        description: 'Output format (default: json)',
-                    },
                 },
                 required: ['epicId'],
             },
@@ -548,90 +354,6 @@ Optional includes (ignored when summary=true):
             },
         },
         // ========================================================================
-        // Core Operations - Dependencies (Epic 3)
-        // ========================================================================
-        {
-            name: 'add_dependency',
-            description: 'Add a dependency between two tickets. The first ticket will depend on the second.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    ticketId: {
-                        type: 'string',
-                        description: 'The ID of the ticket that will depend on another',
-                    },
-                    dependsOnId: {
-                        type: 'string',
-                        description: 'The ID of the ticket it will depend on',
-                    },
-                    type: {
-                        type: 'string',
-                        enum: ['blocks', 'requires'],
-                        description: "Type of dependency (default: 'requires')",
-                    },
-                },
-                required: ['ticketId', 'dependsOnId'],
-            },
-        },
-        {
-            name: 'remove_dependency',
-            description: 'Remove a dependency between two tickets',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    ticketId: {
-                        type: 'string',
-                        description: 'The ID of the dependent ticket',
-                    },
-                    dependsOnId: {
-                        type: 'string',
-                        description: 'The ID of the ticket it depends on',
-                    },
-                    dependencyId: {
-                        type: 'string',
-                        description: 'Alternative: Direct ID of the dependency record',
-                    },
-                },
-            },
-        },
-        {
-            name: 'get_dependency_tree',
-            description: 'Get the full dependency tree for a specification, showing all tickets and their dependency relationships',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    specificationId: {
-                        type: 'string',
-                        description: 'The ID of the specification',
-                    },
-                },
-                required: ['specificationId'],
-            },
-        },
-        {
-            name: 'check_circular_dependencies',
-            description: `Check for circular dependencies between tickets in a specification.
-
-Returns any cycles found where tickets depend on each other in a loop (e.g., A→B→C→A).
-
-Examples:
-- check_circular_dependencies specificationId="spec-123"
-- check_circular_dependencies projectId="proj-123"  // Check all specs in project`,
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    specificationId: {
-                        type: 'string',
-                        description: 'Specification ID to check (optional if projectId provided)',
-                    },
-                    projectId: {
-                        type: 'string',
-                        description: 'Project ID to check all specifications (optional if specificationId provided)',
-                    },
-                },
-            },
-        },
-        // ========================================================================
         // Context & AI Tools (Epic 4)
         // ========================================================================
         {
@@ -689,20 +411,6 @@ Examples:
                 required: ['specificationId'],
             },
         },
-        {
-            name: 'get_critical_path',
-            description: 'Get the critical path (longest dependency chain) for a specification',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    specificationId: {
-                        type: 'string',
-                        description: 'The ID of the specification',
-                    },
-                },
-                required: ['specificationId'],
-            },
-        },
         {
             name: 'get_patterns',
             description: 'Get patterns for a specification or ticket with full inheritance chain. When ticketId is provided, returns resolved patterns with spec → epic → ticket inheritance.',
@@ -725,7 +433,7 @@ Examples:
         // ========================================================================
         {
             name: 'start_work_session',
-            description: 'Start working on a ticket. Creates a WorkSession record and transitions ready -> active. Returns the workSessionId along with error with statusReason if ticket is pending (dependencies not met).',
+            description: 'Start working on a ticket. Returns full ticket details (description, implementation steps, AC, technicalDetails, codeReferences, typeReferences, tags, notes, complexity, priority) alongside checklistState and workSessionId. No need to call get_ticket separately. Returns error with statusReason if ticket is pending.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -852,7 +560,9 @@ Use this instead of calling update_ticket for checklist changes. Provides:
 - Auto-calculated progress percentage
 - Completion readiness hints
 
-IMPORTANT: All acceptance criteria must be validated and all implementation steps must be completed via this tool before calling complete_work_session. The completion gate enforces this.`,
+IMPORTANT: All acceptance criteria must be validated and all implementation steps must be completed via this tool before calling complete_work_session. The completion gate enforces this.
+
+Set getTicket: true to fetch full ticket details in the response — useful for re-reading ticket context mid-implementation. Can be the sole operation or combined with other actions.`,
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -977,6 +687,10 @@ IMPORTANT: All acceptance criteria must be validated and all implementation step
                         type: 'boolean',
                         description: 'Clear existing blocker and resume work.',
                     },
+                    getTicket: {
+                        type: 'boolean',
+                        description: 'Fetch full ticket details. Can be the sole operation or combined with other actions.',
+                    },
                 },
                 required: ['ticketId'],
             },
@@ -1014,11 +728,6 @@ Format options:
                         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)',
@@ -1046,7 +755,7 @@ Combines:
 - 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.`,
+At least one scope filter (projectId, specificationId, or epicId) is required. During active planning sessions, prefer lookup_ticket for targeted lookups.`,
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -1223,7 +932,7 @@ At least one scope filter (projectId, specificationId, or epicId) is required.`,
         // ========================================================================
         {
             name: 'create_specification',
-            description: 'Create a new specification with full context. Create epics separately using epic.create for better quality.',
+            description: 'Create a new specification with full context. Create epics separately using epic.create for better quality. After creation, use start_planning_session to begin structured planning.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -1387,766 +1096,107 @@ At least one scope filter (projectId, specificationId, or epicId) is required.`,
             },
         },
         {
-            name: 'create_epic',
-            description: 'Create a new epic in a specification with full context. Create tickets separately using ticket.create for better quality.',
+            name: 'import_specification',
+            description: 'Import a markdown file as a complete specification with AI-powered parsing. Parses epics from ## headers and tickets from ### headers.',
             inputSchema: {
                 type: 'object',
                 properties: {
-                    specificationId: {
+                    projectId: {
                         type: 'string',
-                        description: 'The ID of the specification',
+                        description: 'The ID of the project to import into',
+                    },
+                    content: {
+                        type: 'string',
+                        description: 'Raw markdown content to parse and import',
                     },
                     title: {
                         type: 'string',
-                        description: 'Epic title',
+                        description: 'Override the parsed title (optional)',
                     },
-                    description: {
+                    specificationTypeId: {
                         type: 'string',
-                        description: 'Detailed description',
+                        description: 'Specification type ID (uses default if not provided)',
                     },
-                    objective: {
+                },
+                required: ['projectId', 'content'],
+            },
+        },
+        // ========================================================================
+        // Implementation Session Operations
+        // ========================================================================
+        {
+            name: 'start_implementation_session',
+            description: 'Start an implementation session for a specification. An implementation session is for autonomous multi-ticket implementation, tracking completed/failed/skipped tickets. This is different from a work session (session.start) which is for working on a single ticket. Returns actionable and blocked tickets.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    specificationId: {
                         type: 'string',
-                        description: 'What this epic achieves',
+                        description: 'The ID of the specification to create a session for',
                     },
-                    epicNumber: {
-                        type: 'number',
-                        description: 'Epic number (auto-incremented if not provided)',
+                    config: {
+                        type: 'object',
+                        description: 'Optional session configuration',
+                        properties: {
+                            mode: {
+                                type: 'string',
+                                enum: ['single', 'autonomous', 'guided'],
+                                description: 'Implementation mode (default: autonomous)',
+                            },
+                            maxTickets: {
+                                type: 'number',
+                                description: 'Maximum tickets to process (null = unlimited, default: 5)',
+                            },
+                            stopOnFailure: {
+                                type: 'boolean',
+                                description: 'Stop session on first failure (default: false)',
+                            },
+                            autoCommit: {
+                                type: 'boolean',
+                                description: 'Auto-commit after each ticket (default: true)',
+                            },
+                            reviewAtEpicBoundaries: {
+                                type: 'boolean',
+                                description: 'Pause when crossing epic boundaries (default: false)',
+                            },
+                            epicReviewList: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                description: 'Epic IDs that require review',
+                            },
+                        },
                     },
-                    content: {
-                        type: 'string',
-                        description: 'Full epic content (markdown)',
+                    force: {
+                        type: 'boolean',
+                        description: 'Force create by ending any existing active session (default: false)',
                     },
-                    scope: {
+                },
+                required: ['specificationId'],
+            },
+        },
+        {
+            name: 'end_session',
+            description: 'End an implementation session (started with start_implementation_session). Returns final stats. This is different from session.complete which completes work on a single ticket.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sessionId: {
                         type: 'string',
-                        description: "What's in/out of scope for this epic",
+                        description: 'The ID of the session to end',
                     },
-                    goals: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Epic-specific goals',
+                    status: {
+                        type: 'string',
+                        enum: ['completed', 'aborted'],
+                        description: 'How the session ended',
                     },
-                    guardrails: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'What NOT to do for this epic',
-                    },
-                    risks: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Risk factors for this epic',
-                    },
-                    constraints: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Technical or business constraints for this epic',
-                    },
-                    assumptions: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Key assumptions made for this epic',
-                    },
-                    architecture: {
-                        type: 'string',
-                        description: 'Architectural approach for this epic',
-                    },
-                    fileStructure: {
-                        type: 'string',
-                        description: 'File/folder organization for this epic',
-                    },
-                    techStack: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Technologies used (subset of specification)',
-                    },
-                    dependencies: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Required packages/libraries',
-                    },
-                    apiContracts: {
-                        type: 'object',
-                        description: 'API specifications for this epic',
-                    },
-                    acceptanceCriteria: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Epic-level success criteria',
-                    },
-                    priority: {
-                        type: 'string',
-                        enum: ['high', 'medium', 'low'],
-                        description: 'Priority level',
-                    },
-                    tags: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Categorization tags',
-                    },
-                    estimatedHours: {
-                        type: 'number',
-                        description: 'Total estimated hours for epic',
-                    },
-                    // 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. Returns validation warnings based on complexity level.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    epicId: {
-                        type: 'string',
-                        description: 'The ID of the epic',
-                    },
-                    title: {
-                        type: 'string',
-                        description: 'Ticket title',
-                    },
-                    ticketNumber: {
-                        type: 'number',
-                        description: 'Ticket number (auto-incremented if not provided)',
-                    },
-                    description: {
-                        type: 'string',
-                        description: 'Ticket description',
-                    },
-                    implementation: {
-                        type: 'object',
-                        description: 'Detailed implementation steps (JSON)',
-                    },
-                    technicalDetails: {
-                        type: 'object',
-                        description: 'Technical details like stack, endpoints (JSON)',
-                    },
-                    acceptanceCriteria: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Success criteria',
-                    },
-                    priority: {
-                        type: 'string',
-                        enum: ['high', 'medium', 'low'],
-                        description: 'Priority level',
-                    },
-                    complexity: {
-                        type: 'string',
-                        enum: ['small', 'medium', 'large', 'xlarge'],
-                        description: 'Size/complexity indicator',
-                    },
-                    tags: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Categorization tags',
-                    },
-                    notes: {
-                        type: 'string',
-                        description: 'Additional context, warnings, or considerations',
-                    },
-                    estimatedHours: {
-                        type: 'number',
-                        description: 'Estimated effort in hours',
-                    },
-                    dependsOn: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Array of ticket IDs this ticket depends on',
-                    },
-                    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'],
-            },
-        },
-        {
-            name: 'import_specification',
-            description: 'Import a markdown file as a complete specification with AI-powered parsing. Parses epics from ## headers and tickets from ### headers.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    projectId: {
-                        type: 'string',
-                        description: 'The ID of the project to import into',
-                    },
-                    content: {
-                        type: 'string',
-                        description: 'Raw markdown content to parse and import',
-                    },
-                    title: {
-                        type: 'string',
-                        description: 'Override the parsed title (optional)',
-                    },
-                    specificationTypeId: {
-                        type: 'string',
-                        description: 'Specification type ID (uses default if not provided)',
-                    },
-                },
-                required: ['projectId', 'content'],
-            },
-        },
-        // ========================================================================
-        // Update Operations
-        // ========================================================================
-        {
-            name: 'update_ticket',
-            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: {
-                    ticketId: {
-                        type: 'string',
-                        description: 'The ID of the ticket to update',
-                    },
-                    title: {
-                        type: 'string',
-                        description: 'New title (optional)',
-                    },
-                    description: {
-                        type: 'string',
-                        description: 'New description (optional)',
-                    },
-                    status: {
-                        type: 'string',
-                        enum: ['pending', 'ready', 'active', 'done'],
-                        description: 'Ticket status. pending/ready may be recalculated based on dependencies.',
-                    },
-                    priority: {
-                        type: 'string',
-                        enum: ['low', 'medium', 'high', 'critical'],
-                        description: 'Priority level (optional)',
-                    },
-                    complexity: {
-                        type: 'string',
-                        enum: ['small', 'medium', 'large', 'xlarge'],
-                        description: 'Size/complexity indicator (optional)',
-                    },
-                    blockReason: {
-                        type: 'string',
-                        description: 'External block reason. Forces status to pending until cleared.',
-                    },
-                    notes: {
-                        type: 'string',
-                        description: 'Additional context, warnings, or considerations (optional)',
-                    },
-                    estimatedHours: {
-                        type: 'number',
-                        description: 'Estimated hours (optional)',
-                    },
-                    tags: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Tags (optional)',
-                    },
-                    acceptanceCriteria: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Acceptance criteria (optional)',
-                    },
-                    implementation: {
-                        type: 'object',
-                        description: 'Detailed implementation steps (JSON) (optional)',
-                    },
-                    technicalDetails: {
-                        type: 'object',
-                        description: 'Technical details like stack, endpoints (JSON) (optional)',
-                    },
-                    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'],
-            },
-        },
-        {
-            name: 'update_epic',
-            description: "Update an epic's properties",
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    epicId: {
-                        type: 'string',
-                        description: 'The ID of the epic to update',
-                    },
-                    title: {
-                        type: 'string',
-                        description: 'New title (optional)',
-                    },
-                    description: {
-                        type: 'string',
-                        description: 'New description (optional)',
-                    },
-                    status: {
-                        type: 'string',
-                        enum: ['todo', 'in_progress', 'completed'],
-                        description: 'New status (optional)',
-                    },
-                    objective: {
-                        type: 'string',
-                        description: 'New objective (optional)',
-                    },
-                    scope: {
-                        type: 'string',
-                        description: 'What\'s in/out of scope (optional)',
-                    },
-                    goals: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Epic-specific goals (optional)',
-                    },
-                    guardrails: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'What NOT to do (optional)',
-                    },
-                    risks: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Risk factors (optional)',
-                    },
-                    constraints: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Technical/business constraints (optional)',
-                    },
-                    assumptions: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Key assumptions (optional)',
-                    },
-                    architecture: {
-                        type: 'string',
-                        description: 'Architectural approach (optional)',
-                    },
-                    fileStructure: {
-                        type: 'string',
-                        description: 'File/folder organization (optional)',
-                    },
-                    techStack: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Technologies used (optional)',
-                    },
-                    dependencies: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Required packages/libraries (optional)',
-                    },
-                    apiContracts: {
-                        type: 'object',
-                        description: 'API specifications (optional)',
-                    },
-                    acceptanceCriteria: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Success criteria (optional)',
-                    },
-                    tags: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Categorization tags (optional)',
-                    },
-                    estimatedHours: {
-                        type: 'number',
-                        description: 'Total estimated hours (optional)',
-                    },
-                    priority: {
-                        type: 'string',
-                        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'],
-            },
-        },
-        {
-            name: 'update_specification',
-            description: "Update a specification's properties",
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    specificationId: {
-                        type: 'string',
-                        description: 'The ID of the specification to update',
-                    },
-                    title: {
-                        type: 'string',
-                        description: 'New title (optional)',
-                    },
-                    description: {
-                        type: 'string',
-                        description: 'New description (optional)',
-                    },
-                    status: {
-                        type: 'string',
-                        enum: ['draft', 'planning', 'ready', 'in_progress', 'completed'],
-                        description: 'New status (optional)',
-                    },
-                    background: {
-                        type: 'string',
-                        description: 'New background (optional)',
-                    },
-                    scope: {
-                        type: 'string',
-                        description: 'New scope (optional)',
-                    },
-                    goals: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Business/user/technical objectives (optional)',
-                    },
-                    requirements: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Functional requirements (optional)',
-                    },
-                    nonFunctionalRequirements: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Non-functional requirements like performance, security (optional)',
-                    },
-                    successMetrics: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'KPIs to measure success (optional)',
-                    },
-                    constraints: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Technical/business constraints (optional)',
-                    },
-                    assumptions: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Key assumptions made (optional)',
-                    },
-                    risks: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Risk factors and mitigations (optional)',
-                    },
-                    guardrails: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'What NOT to do (optional)',
-                    },
-                    architecture: {
-                        type: 'string',
-                        description: 'Architectural approach (optional)',
-                    },
-                    fileStructure: {
-                        type: 'string',
-                        description: 'File/folder organization (optional)',
-                    },
-                    techStack: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Technologies to use (optional)',
-                    },
-                    dependencies: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Required packages/libraries (optional)',
-                    },
-                    apiContracts: {
-                        type: 'object',
-                        description: 'API specifications (optional)',
-                    },
-                    acceptanceCriteria: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Success criteria (optional)',
-                    },
-                    tags: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: 'Categorization tags (optional)',
-                    },
-                    estimatedHours: {
-                        type: 'number',
-                        description: 'Total estimated hours (optional)',
-                    },
-                    targetAudience: {
-                        type: 'string',
-                        description: 'Who this is for - developers, users, stakeholders, etc. (optional)',
-                    },
-                    priority: {
-                        type: 'string',
-                        enum: ['low', 'medium', 'high', 'critical'],
-                        description: 'Priority level (optional)',
-                    },
-                    validationCommands: {
-                        type: 'object',
-                        description: 'Validation commands (test, lint, build, typeCheck, custom) (optional)',
-                        properties: {
-                            test: { type: 'string', description: 'Test command' },
-                            lint: { type: 'string', description: 'Lint command' },
-                            build: { type: 'string', description: 'Build command' },
-                            typeCheck: { type: 'string', description: 'Type check command' },
-                            preValidation: { type: 'string', description: 'Pre-validation command' },
-                            postValidation: { type: 'string', description: 'Post-validation command' },
-                            custom: {
-                                type: 'object',
-                                description: 'Custom validation commands',
-                                additionalProperties: { type: 'string' },
-                            },
-                        },
-                    },
-                    workingDirectory: {
-                        type: 'string',
-                        description: 'Working directory for commands (optional)',
-                    },
-                    outputDirectory: {
-                        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'],
-            },
-        },
-        // ========================================================================
-        // Implementation Session Operations
-        // ========================================================================
-        {
-            name: 'start_implementation_session',
-            description: 'Start an implementation session for a specification. An implementation session is for autonomous multi-ticket implementation, tracking completed/failed/skipped tickets. This is different from a work session (session.start) which is for working on a single ticket. Returns actionable and blocked tickets.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    specificationId: {
-                        type: 'string',
-                        description: 'The ID of the specification to create a session for',
-                    },
-                    config: {
-                        type: 'object',
-                        description: 'Optional session configuration',
-                        properties: {
-                            mode: {
-                                type: 'string',
-                                enum: ['single', 'autonomous', 'guided'],
-                                description: 'Implementation mode (default: autonomous)',
-                            },
-                            maxTickets: {
-                                type: 'number',
-                                description: 'Maximum tickets to process (null = unlimited, default: 5)',
-                            },
-                            stopOnFailure: {
-                                type: 'boolean',
-                                description: 'Stop session on first failure (default: false)',
-                            },
-                            autoCommit: {
-                                type: 'boolean',
-                                description: 'Auto-commit after each ticket (default: true)',
-                            },
-                            reviewAtEpicBoundaries: {
-                                type: 'boolean',
-                                description: 'Pause when crossing epic boundaries (default: false)',
-                            },
-                            epicReviewList: {
-                                type: 'array',
-                                items: { type: 'string' },
-                                description: 'Epic IDs that require review',
-                            },
-                        },
-                    },
-                    force: {
-                        type: 'boolean',
-                        description: 'Force create by ending any existing active session (default: false)',
-                    },
-                },
-                required: ['specificationId'],
-            },
-        },
-        {
-            name: 'end_session',
-            description: 'End an implementation session (started with start_implementation_session). Returns final stats. This is different from session.complete which completes work on a single ticket.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    sessionId: {
-                        type: 'string',
-                        description: 'The ID of the session to end',
-                    },
-                    status: {
-                        type: 'string',
-                        enum: ['completed', 'aborted'],
-                        description: 'How the session ended',
-                    },
-                    summary: {
-                        type: 'string',
-                        description: 'End-of-session summary',
+                    summary: {
+                        type: 'string',
+                        description: 'End-of-session summary',
                     },
                 },
                 required: ['sessionId', 'status'],
             },
         },
-        // ========================================================================
-        // Bulk Operations
-        // ========================================================================
-        {
-            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).',
@@ -2544,34 +1594,6 @@ At least one scope filter (projectId, specificationId, or epicId) is required.`,
         // ========================================================================
         // Delete Operations
         // ========================================================================
-        {
-            name: 'delete_ticket',
-            description: 'Delete a ticket and all its related records (dependencies, test results, discoveries, blueprint references)',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    ticketId: {
-                        type: 'string',
-                        description: 'The ID of the ticket to delete',
-                    },
-                },
-                required: ['ticketId'],
-            },
-        },
-        {
-            name: 'delete_epic',
-            description: 'Delete an epic and cascade delete all its tickets and related records',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    epicId: {
-                        type: 'string',
-                        description: 'The ID of the epic to delete',
-                    },
-                },
-                required: ['epicId'],
-            },
-        },
         {
             name: 'delete_specification',
             description: 'Delete a specification and cascade delete all epics, tickets, and related records',
@@ -2665,54 +1687,42 @@ At least one scope filter (projectId, specificationId, or epicId) is required.`,
         // Review & Completion
         // ========================================================================
         {
-            name: 'review_planning',
-            description: 'Review the planning quality of a specification. Analyzes ticket completeness, dependency structure, estimation coverage, and acceptance criteria. Returns a detailed report with scores and actionable suggestions.',
+            name: 'review_implementation',
+            description: 'Review the implementation progress and quality of a specification. Analyzes completed tickets, test coverage, code quality signals, and remaining work. Returns a progress report with recommendations.',
             inputSchema: {
                 type: 'object',
                 properties: {
                     specificationId: {
                         type: 'string',
-                        description: 'The ID of the specification to review',
-                    },
-                    page: {
-                        type: 'integer',
-                        description: 'Page number for paginated results (default: 1)',
-                    },
-                    pageSize: {
-                        type: 'integer',
-                        description: 'Number of items per page (default: 20)',
-                    },
-                    includeFullReport: {
-                        type: 'boolean',
-                        description: 'Whether to include the full detailed report (default: false)',
+                        description: 'The ID of the specification to review',
                     },
                 },
                 required: ['specificationId'],
             },
         },
         {
-            name: 'review_implementation',
-            description: 'Review the implementation progress and quality of a specification. Analyzes completed tickets, test coverage, code quality signals, and remaining work. Returns a progress report with recommendations.',
+            name: 'complete_specification',
+            description: 'Mark a specification as complete. Validates that all epics and tickets are done, calculates final metrics, and transitions the specification to completed status. Use review_implementation first to check readiness.',
             inputSchema: {
                 type: 'object',
                 properties: {
                     specificationId: {
                         type: 'string',
-                        description: 'The ID of the specification to review',
+                        description: 'The ID of the specification to complete',
                     },
                 },
                 required: ['specificationId'],
             },
         },
         {
-            name: 'complete_specification',
-            description: 'Mark a specification as complete. Validates that all epics and tickets are done, calculates final metrics, and transitions the specification to completed status. Use review_implementation first to check readiness.',
+            name: 'reopen_specification',
+            description: 'Reopen a specification in "ready" status, regressing to "planning". After reopening, call start_planning_session to begin a new planning session.',
             inputSchema: {
                 type: 'object',
                 properties: {
                     specificationId: {
                         type: 'string',
-                        description: 'The ID of the specification to complete',
+                        description: 'The ID of the specification to reopen',
                     },
                 },
                 required: ['specificationId'],
@@ -2738,9 +1748,85 @@ At least one scope filter (projectId, specificationId, or epicId) is required.`,
                 },
             },
         },
+        // ========================================================================
+        // Planning Session Operations
+        // ========================================================================
+        {
+            name: 'start_planning_session',
+            description: 'Start or resume a guided planning session for a specification. Auto-detects the current state — whether the spec is new, partially complete, or needs refinement after review. Returns current status, progress scores, blockers, and suggested next actions. Always call this before using action_planning_session.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    specificationId: {
+                        type: 'string',
+                        description: 'The ID of the specification to plan',
+                    },
+                },
+                required: ['specificationId'],
+            },
+        },
+        {
+            name: 'action_planning_session',
+            description: "Execute a planning action within an active session. Wraps all planning operations (create/update epics, tickets, dependencies, blueprints) and read operations (get_ticket for inspecting details) with automatic status tracking. The spec status advances or regresses automatically based on the action type and gate checks. Returns updated progress, blockers, and next suggested actions after every call. Use responseDetail to control verbosity: 'minimal' (~80 tokens) for rapid iteration, 'standard' (~200 tokens, default) for normal work, 'full' (~500 tokens) for debugging.",
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    specificationId: {
+                        type: 'string',
+                        description: 'The ID of the specification',
+                    },
+                    operation: {
+                        type: 'object',
+                        description: 'The operation to perform. Must include a "type" field.',
+                        properties: {
+                            type: {
+                                type: 'string',
+                                enum: [
+                                    'set_metadata',
+                                    'create_epic',
+                                    'update_epic',
+                                    'create_ticket',
+                                    'update_ticket',
+                                    'delete_epic',
+                                    'delete_ticket',
+                                    'add_dependencies',
+                                    'remove_dependency',
+                                    'create_blueprint',
+                                    'link_blueprint',
+                                    'get_ticket',
+                                    'advance_phase',
+                                    'get_status',
+                                ],
+                                description: 'The type of planning operation to perform',
+                            },
+                        },
+                        required: ['type'],
+                    },
+                    responseDetail: {
+                        type: 'string',
+                        enum: ['minimal', 'standard', 'full'],
+                        description: 'Response detail level: minimal (~80 tokens), standard (~200, default), full (~500)',
+                    },
+                },
+                required: ['specificationId', 'operation'],
+            },
+        },
+        {
+            name: 'complete_planning_session',
+            description: "Complete the planning session and submit the spec for final review. Spec must be in 'validating' status. Runs a dry-run check first, then full review if no errors. Transitions spec to 'ready' on success. If the spec isn't in validating yet, returns what's needed to get there.",
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    specificationId: {
+                        type: 'string',
+                        description: 'The ID of the specification to complete planning for',
+                    },
+                },
+                required: ['specificationId'],
+            },
+        },
     ];
-    // Apply format parameter to all read operations
-    return tools.map(tool => READ_TOOL_NAMES.has(tool.name) ? addFormatParameter(tool) : tool);
+    return tools;
 }
 /**
  * Retry configuration for transient failures
@@ -2849,14 +1935,6 @@ export function createToolHandlers(apiClient) {
                 fields: argsWithContext.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, 'title');
             // Inject projectId from .specforge.json if not provided
@@ -2881,14 +1959,6 @@ export function createToolHandlers(apiClient) {
                 fields: argsWithContext.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) => {
             // Must provide either title or number
             if (!args.title && args.number === undefined) {
@@ -2920,14 +1990,6 @@ export function createToolHandlers(apiClient) {
                 fields: argsWithContext.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
@@ -2965,42 +2027,6 @@ export function createToolHandlers(apiClient) {
             });
         },
         // ========================================================================
-        // Core Operations - Dependencies
-        // ========================================================================
-        add_dependency: async (_client, args) => {
-            validateRequired(args, 'ticketId');
-            validateRequired(args, 'dependsOnId');
-            return await apiClient.call('add_dependency', {
-                ticketId: args.ticketId,
-                dependsOnId: args.dependsOnId,
-                type: args.type,
-            });
-        },
-        remove_dependency: async (_client, args) => {
-            // Either dependencyId or (ticketId + dependsOnId) required
-            if (!args.dependencyId && !args.ticketId) {
-                throw new Error('Either dependencyId or ticketId is required');
-            }
-            return await apiClient.call('remove_dependency', {
-                ticketId: args.ticketId,
-                dependsOnId: args.dependsOnId,
-                dependencyId: args.dependencyId,
-            });
-        },
-        get_dependency_tree: async (_client, args) => {
-            validateRequired(args, 'specificationId');
-            return await apiClient.call('get_dependency_tree', {
-                specificationId: args.specificationId,
-            });
-        },
-        check_circular_dependencies: async (_client, args) => {
-            const argsWithContext = injectContext(args, ['specificationId', 'projectId']);
-            return await apiClient.call('check_circular_dependencies', {
-                specificationId: argsWithContext.specificationId,
-                projectId: argsWithContext.projectId,
-            });
-        },
-        // ========================================================================
         // Context & AI Tools
         // ========================================================================
         get_implementation_context: async (_client, args) => {
@@ -3075,16 +2101,6 @@ export function createToolHandlers(apiClient) {
                 specificationId: argsWithContext.specificationId,
             });
         },
-        get_critical_path: async (_client, args) => {
-            // Inject specificationId from .specforge.json if not provided
-            const argsWithContext = injectContext(args, ['specificationId']);
-            if (!argsWithContext.specificationId) {
-                throw new Error('specificationId is required. Set working context with "specforge switch" or provide explicitly.');
-            }
-            return await apiClient.call('get_critical_path', {
-                specificationId: argsWithContext.specificationId,
-            });
-        },
         get_patterns: async (_client, args) => {
             // Inject specificationId from .specforge.json if not provided
             const argsWithContext = injectContext(args, ['specificationId']);
@@ -3261,6 +2277,7 @@ export function createToolHandlers(apiClient) {
                 filesDeleted: args.filesDeleted,
                 blockReason: args.blockReason,
                 clearBlockReason: args.clearBlockReason,
+                getTicket: args.getTicket,
             });
         },
         // ========================================================================
@@ -3375,79 +2392,6 @@ export function createToolHandlers(apiClient) {
             });
             return formatWriteResponse(result, responseMode, 'Specification created');
         },
-        create_epic: async (_client, args) => {
-            validateRequired(args, 'specificationId', 'title', 'description', 'objective');
-            const responseMode = getResponseModeFromArgs(args);
-            const result = await apiClient.call('create_epic', {
-                specificationId: args.specificationId,
-                title: args.title,
-                description: args.description,
-                objective: args.objective,
-                epicNumber: args.epicNumber,
-                content: args.content,
-                scope: args.scope,
-                goals: args.goals,
-                acceptanceCriteria: args.acceptanceCriteria,
-                priority: args.priority,
-                tags: args.tags,
-                estimatedHours: args.estimatedHours,
-                order: args.order,
-                // FI-003 fields
-                guardrails: args.guardrails,
-                risks: args.risks,
-                constraints: args.constraints,
-                assumptions: args.assumptions,
-                architecture: args.architecture,
-                fileStructure: args.fileStructure,
-                techStack: args.techStack,
-                dependencies: args.dependencies,
-                apiContracts: args.apiContracts,
-                // Pattern inheritance fields (F7-002)
-                sharedPatterns: args.sharedPatterns,
-                additionalImports: args.additionalImports,
-                commonFiles: args.commonFiles,
-            });
-            return formatWriteResponse(result, responseMode, 'Epic created');
-        },
-        create_ticket: async (_client, args) => {
-            validateRequired(args, 'epicId', 'title');
-            const responseMode = getResponseModeFromArgs(args);
-            // Extract validation options
-            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,
-                description: args.description,
-                implementation: args.implementation,
-                technicalDetails: args.technicalDetails,
-                acceptanceCriteria: args.acceptanceCriteria,
-                priority: args.priority,
-                complexity: args.complexity,
-                tags: args.tags,
-                estimatedHours: args.estimatedHours,
-                order: args.order,
-                dependsOn: args.dependsOn,
-                notes: args.notes, // F8-001: Add missing notes field
-            });
-            // Run validation
-            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');
             return await apiClient.call('import_specification', {
@@ -3458,145 +2402,6 @@ export function createToolHandlers(apiClient) {
             });
         },
         // ========================================================================
-        // Update Operations
-        // ========================================================================
-        update_ticket: async (_client, args) => {
-            validateRequired(args, 'ticketId');
-            const responseMode = getResponseModeFromArgs(args);
-            // Extract validation options
-            const validationStrictness = args.validationStrictness === 'lenient' || args.validationStrictness === 'strict'
-                ? args.validationStrictness
-                : 'normal';
-            // Get current ticket to calculate previous completeness score
-            let previousCompletenessScore;
-            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,
-                status: args.status,
-                priority: args.priority,
-                estimatedHours: args.estimatedHours,
-                tags: args.tags,
-                acceptanceCriteria: args.acceptanceCriteria,
-                // Additional fields
-                complexity: args.complexity,
-                notes: args.notes,
-                implementation: args.implementation,
-                technicalDetails: args.technicalDetails,
-                blockReason: args.blockReason,
-            });
-            // Run validation on updated ticket
-            // 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');
-            const responseMode = getResponseModeFromArgs(args);
-            const result = await apiClient.call('update_epic', {
-                epicId: args.epicId,
-                title: args.title,
-                description: args.description,
-                status: args.status,
-                objective: args.objective,
-                priority: args.priority,
-                // FI-003 fields
-                scope: args.scope,
-                goals: args.goals,
-                guardrails: args.guardrails,
-                risks: args.risks,
-                constraints: args.constraints,
-                assumptions: args.assumptions,
-                architecture: args.architecture,
-                fileStructure: args.fileStructure,
-                techStack: args.techStack,
-                dependencies: args.dependencies,
-                apiContracts: args.apiContracts,
-                acceptanceCriteria: args.acceptanceCriteria,
-                tags: args.tags,
-                estimatedHours: args.estimatedHours,
-                // Pattern inheritance fields (F7-002)
-                sharedPatterns: args.sharedPatterns,
-                additionalImports: args.additionalImports,
-                commonFiles: args.commonFiles,
-            });
-            return formatWriteResponse(result, responseMode, 'Epic updated');
-        },
-        update_specification: async (_client, args) => {
-            validateRequired(args, 'specificationId');
-            const responseMode = getResponseModeFromArgs(args);
-            const result = await apiClient.call('update_specification', {
-                specificationId: args.specificationId,
-                title: args.title,
-                description: args.description,
-                status: args.status,
-                background: args.background,
-                scope: args.scope,
-                priority: args.priority,
-                // FI-003 fields
-                goals: args.goals,
-                requirements: args.requirements,
-                nonFunctionalRequirements: args.nonFunctionalRequirements,
-                successMetrics: args.successMetrics,
-                constraints: args.constraints,
-                assumptions: args.assumptions,
-                risks: args.risks,
-                guardrails: args.guardrails,
-                architecture: args.architecture,
-                fileStructure: args.fileStructure,
-                techStack: args.techStack,
-                dependencies: args.dependencies,
-                apiContracts: args.apiContracts,
-                acceptanceCriteria: args.acceptanceCriteria,
-                tags: args.tags,
-                estimatedHours: args.estimatedHours,
-                targetAudience: args.targetAudience,
-                // Pattern inheritance fields (F7-001)
-                codeStandards: args.codeStandards,
-                commonImports: args.commonImports,
-                returnTypes: args.returnTypes,
-                // Validation and workflow fields
-                validationCommands: args.validationCommands,
-                workingDirectory: args.workingDirectory,
-                outputDirectory: args.outputDirectory,
-            });
-            return formatWriteResponse(result, responseMode, 'Specification updated');
-        },
-        // ========================================================================
         // Implementation Session Operations
         // ========================================================================
         start_implementation_session: async (_client, args) => {
@@ -3615,33 +2420,6 @@ export function createToolHandlers(apiClient) {
                 summary: args.summary,
             });
         },
-        // ========================================================================
-        // Bulk Operations
-        // ========================================================================
-        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');
@@ -3771,18 +2549,6 @@ export function createToolHandlers(apiClient) {
         // ========================================================================
         // Delete Operations
         // ========================================================================
-        delete_ticket: async (_client, args) => {
-            validateRequired(args, 'ticketId');
-            return await apiClient.call('delete_ticket', {
-                ticketId: args.ticketId,
-            });
-        },
-        delete_epic: async (_client, args) => {
-            validateRequired(args, 'epicId');
-            return await apiClient.call('delete_epic', {
-                epicId: args.epicId,
-            });
-        },
         delete_specification: async (_client, args) => {
             validateRequired(args, 'specificationId');
             return await apiClient.call('delete_specification', {
@@ -3832,15 +2598,6 @@ export function createToolHandlers(apiClient) {
         // ========================================================================
         // Review & Completion
         // ========================================================================
-        review_planning: async (_client, args) => {
-            const argsWithContext = injectContextRequired(args, ['specificationId']);
-            return await apiClient.call('review_planning', {
-                specificationId: argsWithContext.specificationId,
-                page: argsWithContext.page,
-                pageSize: argsWithContext.pageSize,
-                includeFullReport: argsWithContext.includeFullReport,
-            });
-        },
         review_implementation: async (_client, args) => {
             const argsWithContext = injectContextRequired(args, ['specificationId']);
             return await apiClient.call('review_implementation', {
@@ -3853,12 +2610,44 @@ export function createToolHandlers(apiClient) {
                 specificationId: argsWithContext.specificationId,
             });
         },
+        reopen_specification: async (_client, args) => {
+            const argsWithContext = injectContextRequired(args, ['specificationId']);
+            return await apiClient.call('reopen_specification', {
+                specificationId: argsWithContext.specificationId,
+            });
+        },
         // ========================================================================
         // Agent Teams - Workspace Files (Local-only)
         // ========================================================================
         get_workspace_files: async (_client, args) => {
             return await getWorkspaceFiles(args);
         },
+        // ========================================================================
+        // Planning Session Operations
+        // ========================================================================
+        start_planning_session: async (_client, args) => {
+            validateRequired(args, 'specificationId');
+            return await apiClient.call('start_planning_session', {
+                specificationId: args.specificationId,
+            });
+        },
+        action_planning_session: async (_client, args) => {
+            validateRequired(args, 'specificationId');
+            if (!args.operation || typeof args.operation !== 'object') {
+                throw new Error('Missing required argument: operation');
+            }
+            return await apiClient.call('action_planning_session', {
+                specificationId: args.specificationId,
+                operation: args.operation,
+                responseDetail: args.responseDetail,
+            });
+        },
+        complete_planning_session: async (_client, args) => {
+            validateRequired(args, 'specificationId');
+            return await apiClient.call('complete_planning_session', {
+                specificationId: args.specificationId,
+            });
+        },
     };
 }
 /**