@specforge/cli 0.1.0 → 0.2.4

package/dist/tools/index.js

@@ -1,3 +1,4 @@
+import { appendFileSync } from "node:fs";
 import {
   ValidationError,
   ApiError,
@@ -6,6 +7,8 @@ import {
   transformError
 } from "../validation/index.js";
 import { injectContext, injectContextRequired } from "./core/context-helper.js";
+import { probeExistingFiles } from "./core/file-existence-injection.js";
+import { readWorktreeGitEvidence, readHeadCommitSha } from "./core/git-injection.js";
 import { tryLoadProjectConfig, saveProjectConfig } from "../cli/config/index.js";
 import {
   appendPlanningSessionRegistry,
@@ -24,19 +27,15 @@ function getTools() {
         properties: {
           type: {
             type: "string",
-            enum: ["project", "specification", "epic", "ticket", "implementation_session"],
+            enum: ["project", "specification", "epic", "ticket", "blueprint"],
             description: "Entity type to retrieve"
           },
           id: {
             type: "string",
-            description: "Entity ID (for project, specification, epic, ticket)"
-          },
-          specificationId: {
-            type: "string",
-            description: "Specification ID (for implementation_session)"
+            description: "Entity ID"
           }
         },
-        required: ["type"]
+        required: ["type", "id"]
       }
     },
     {
@@ -47,7 +46,7 @@ function getTools() {
         properties: {
           type: {
             type: "string",
-            enum: ["projects", "specifications", "epics", "tickets"],
+            enum: ["projects", "specifications", "epics", "tickets", "blueprints"],
             description: "Entity type to list"
           },
           projectId: {
@@ -108,7 +107,7 @@ At least one scope filter (projectId, specificationId, or epicId) is required.`,
             type: "array",
             items: {
               type: "string",
-              enum: ["pending", "ready", "active", "done"]
+              enum: ["pending", "ready", "active", "done", "blocked"]
             },
             description: "Filter by status"
           },
@@ -120,14 +119,6 @@ At least one scope filter (projectId, specificationId, or epicId) is required.`,
             },
             description: "Filter by complexity"
           },
-          priority: {
-            type: "array",
-            items: {
-              type: "string",
-              enum: ["low", "medium", "high", "critical"]
-            },
-            description: "Filter by priority"
-          },
           projectId: {
             type: "string",
             description: "Limit search to project"
@@ -168,7 +159,6 @@ At least one scope filter (projectId, specificationId, or epicId) is required.`,
                 "technicalDetails",
                 "notes",
                 "tags",
-                "blockReason",
                 "progress",
                 "testsPassed",
                 "order",
@@ -206,7 +196,7 @@ At least one scope filter (projectId, specificationId, or epicId) is required.`,
     },
     {
       name: "get_blocked_tickets",
-      description: 'Get tickets with status "pending" and their statusReason explaining why they are blocked (unsatisfied dependencies or external block)',
+      description: 'Get tickets with status "pending", each with the `blockedBy` list of unsatisfied dependency tickets computed from the dependency tree.',
       inputSchema: {
         type: "object",
         properties: {
@@ -227,7 +217,6 @@ Report types:
 - 'time': Estimated vs actual hours (replaces get_time_report)
 - 'blockers': Blocked tickets with reasons (replaces get_blockers_report)
 - 'work': Completed work summary from WorkSession records (replaces get_work_summary)
-- 'implementation_analysis': Deeper implementation insights
 - 'sessions': Live planning/work/review sessions for a project (requires scope='project')
 
 Format options:
@@ -238,7 +227,7 @@ Format options:
         properties: {
           type: {
             type: "string",
-            enum: ["implementation", "time", "blockers", "work", "implementation_analysis", "sessions"],
+            enum: ["implementation", "time", "blockers", "work", "sessions"],
             description: "Type of report to generate"
           },
           scope: {
@@ -257,6 +246,11 @@ Format options:
           endDate: {
             type: "string",
             description: "End date for work report (ISO 8601)"
+          },
+          format: {
+            type: "string",
+            enum: ["json", "summary"],
+            description: "Response format: 'json' (default) or 'summary'."
           }
         },
         required: ["type", "scope", "scopeId"]
@@ -267,23 +261,27 @@ Format options:
     // ========================================================================
     {
       name: "start_planning_session",
-      description: "Start or resume a guided planning session for a specification. Project-scoped lock: only one active planning session per project (the project is derived from the spec \u2014 you do not pass it). Calling with the same spec resumes the existing session (idempotent). Calling with a different spec while one is active returns a rejection with the active session details. Planning is independent of implementation and review \u2014 they can run concurrently.",
+      description: "Start or resume a guided planning session for a specification. Project-scoped lock: only one active planning session per project. Calling with the same spec resumes the existing session (idempotent). Calling with a different spec while one is active returns a rejection with the active session details. Planning is independent of implementation and review \u2014 they can run concurrently.",
       inputSchema: {
         type: "object",
         properties: {
           specificationId: {
             type: "string",
-            description: "The specification to plan. Optional \u2014 defaults to the active spec in the local config (.specforge/config.json), so you normally omit it. Do NOT pass projectId; it is derived from the spec."
+            description: "The specification to plan. Optional \u2014 defaults to the active spec in the local config (.specforge/config.json), so you normally omit it."
+          },
+          projectId: {
+            type: "string",
+            description: "The owning project. Optional \u2014 defaults to the active project in the local config (.specforge/config.json); injected automatically, so you normally omit it."
           }
         },
-        // Nothing is required: specificationId falls back to local config, and the
-        // returned sessionId is persisted + injected into subsequent calls.
+        // Nothing is required: specificationId/projectId fall back to local config, and
+        // the returned sessionId is persisted + injected into subsequent calls.
         required: []
       }
     },
     {
       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, gps for full readiness X-ray worst-first) 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.",
+      description: "Execute a planning action within an active session. Wraps the planning write operations (create/update/delete for epics, tickets and blueprints; plus the dependency, blueprint-link, step-link, justify and creator-election operations) and the read operation get_planning_status. The operation.type IS the backend PlanningOperationName; the remaining fields are the operation payload. To read a single ticket, use the `get` tool (type:'ticket').",
       inputSchema: {
         type: "object",
         properties: {
@@ -294,104 +292,188 @@ Format options:
               type: {
                 type: "string",
                 enum: [
-                  "set_metadata",
+                  "update_spec",
                   "create_epic",
                   "update_epic",
-                  "create_ticket",
-                  "update_ticket",
                   "delete_epic",
+                  "create_ticket",
+                  "ticket_general_actions",
+                  "ticket_step_actions",
+                  "ticket_criteria_actions",
+                  "ticket_test_actions",
                   "delete_ticket",
-                  "add_dependencies",
-                  "remove_dependency",
                   "create_blueprint",
-                  "link_blueprint",
                   "update_blueprint",
                   "delete_blueprint",
-                  "unlink_blueprint",
-                  "get_ticket",
-                  "get_status",
-                  "gps"
+                  "link_blueprint_to_tickets",
+                  "unlink_blueprint_to_tickets",
+                  "link_step_file",
+                  "unlink_step_file",
+                  "link_step_snippet",
+                  "unlink_step_snippet",
+                  "create_dependencies",
+                  "delete_dependencies",
+                  "apply_creator_election",
+                  "justify",
+                  "unjustify",
+                  "get_planning_status"
                 ],
-                description: "The type of planning operation to perform"
+                description: "The planning operation to perform (lifecycle vocabulary). The type IS the backend PlanningOperationName; remaining fields are the operation payload."
               }
             },
             required: ["type"],
             oneOf: [
               {
-                properties: { type: { const: "set_metadata" } },
-                required: ["type"]
+                properties: {
+                  type: { const: "update_spec" },
+                  fields: { type: "object", description: "Partial spec update \u2014 only the keys you send are changed (e.g. background, goals, nonGoals, constraints, successCriteria). Fields that do not apply are declared with the `justify` op (undo with `unjustify`), never by writing values here." }
+                },
+                required: ["type", "fields"]
               },
+              // create_epic — SHELL only (epic_decomposition). Body fields are authored
+              // by update_epic in epic_expansion; only title/description/objective are
+              // persisted on create, so only those are advertised.
               {
                 properties: {
                   type: { const: "create_epic" },
                   title: { type: "string", minLength: 1, description: "Epic title (non-empty)" },
-                  description: { type: "string", minLength: 1, description: "What this epic delivers" },
-                  objective: { type: "string", minLength: 1, description: "Goal achieved for the user" },
-                  goals: { type: "array", items: { type: "string" } },
-                  acceptanceCriteria: { type: "array", items: { type: "string" } },
-                  tickets: { type: "array", description: "Optional bulk-create tickets within the epic" }
+                  description: { type: "string", description: "What this epic delivers" },
+                  objective: { type: "string", description: "Goal achieved for the user" }
                 },
-                required: ["type", "title", "description", "objective"]
+                required: ["type", "title"]
               },
               {
                 properties: {
                   type: { const: "update_epic" },
-                  epicId: { type: "string", description: "Epic id; use list_epics or lookup_epic to find" }
+                  id: { type: "string", description: "Epic id (use list_epics / lookup_epic to find)." },
+                  fields: {
+                    type: "object",
+                    description: "Partial epic update \u2014 only the keys you send are changed. Fields that do not apply are declared with the `justify` op (undo with `unjustify`), never by writing values here.",
+                    properties: {
+                      title: { type: "string" },
+                      description: { type: "string" },
+                      objective: { type: "string", description: "Goal achieved for the user." },
+                      architecture: { type: "string", description: "Structural approach specific to this epic." },
+                      scope: { type: "object", description: "Epic scope.", properties: { inScope: { type: "array", items: { type: "string" } }, outOfScope: { type: "array", items: { type: "string" } }, assumptions: { type: "array", items: { type: "string" } }, externalDependencies: { type: "array", items: { type: "string" } } } },
+                      goals: { type: "array", description: "Epic goals as objects (Epic.goals is a json object[], not string[]).", items: { type: "object", properties: { title: { type: "string" }, description: { type: "string" }, type: { type: "string", enum: ["business", "technical", "user", "operational"] }, successCriteria: { type: "array", items: { type: "string" } } }, required: ["title", "description"] } },
+                      acceptanceCriteria: { type: "array", description: "BDD criteria objects (Epic.acceptanceCriteria is a json object[], not string[]).", items: { type: "object", properties: { given: { type: "string" }, when: { type: "string" }, then: { type: "string" } }, required: ["given", "when", "then"] } },
+                      validationCommands: { type: "array", items: { type: "string" }, description: "Commands that verify this epic end-to-end." },
+                      apiContracts: { type: "array", description: "API contracts this epic exposes.", items: { type: "object", properties: { id: { type: "string" }, name: { type: "string" }, type: { type: "string" }, description: { type: "string" } } } },
+                      sharedPatterns: { type: "array", description: "Reusable patterns the epic's tickets should follow.", items: { type: "object" } },
+                      fileStructures: { type: "array", description: "Concrete files this epic creates/modifies.", items: { type: "object", properties: { id: { type: "string" }, scope: { type: "string" }, description: { type: "string" }, content: { type: "string" } } } },
+                      requirementsCovered: { type: "array", items: { type: "string" }, description: "Spec requirement ids this epic covers." },
+                      nfrsCovered: { type: "array", items: { type: "string" }, description: "Spec NFR ids this epic covers." },
+                      goalsCovered: { type: "array", items: { type: "string" }, description: "Spec goal ids this epic advances." }
+                    }
+                  }
                 },
-                required: ["type", "epicId"]
+                required: ["type", "id", "fields"]
               },
+              // create_ticket — SHELL (ticket_decomposition): epicId/title/description
+              // + ticketType (the impl/verification decision, set HERE). The remaining body
+              // fields are authored by the ticket node verbs in ticket_expansion;
+              // dependencies via create_dependencies in cross_validation.
               {
                 properties: {
                   type: { const: "create_ticket" },
                   epicId: { type: "string", description: "Parent epic id" },
                   title: { type: "string", minLength: 1, description: "Ticket title (non-empty)" },
                   description: { type: "string" },
-                  ticketType: { type: "string", enum: ["implementation", "verification"], description: "Ticket type \u2014 implementation (default) or verification (tests/QA). Drives which fields the readiness rubric expects." },
-                  priority: { type: "string", enum: ["high", "medium", "low"] },
-                  complexity: { type: "string", enum: ["small", "medium", "large", "xlarge"] },
-                  acceptanceCriteria: { type: "array", items: { type: "string" } },
-                  implementationSteps: { type: "array", items: { type: "string" }, description: "Implementation steps; persisted as TicketImplementationStep rows" },
-                  dependsOn: { type: "array", items: { type: "string" }, description: "Other ticket ids this depends on; created post-insert" }
+                  ticketType: { type: "string", enum: ["implementation", "verification"], description: "Ticket type \u2014 set here (decomposition); defaults to implementation. Editing it later via ticket_general_actions rolls the session back to ticket_decomposition." }
                 },
                 required: ["type", "epicId", "title"]
               },
+              // ME.19.1 (D8/D20) — the four ticket NODE VERBS replace the retired free-form
+              // `update_ticket`. Each targets ONE scope with a TYPED payload (no `fields`
+              // bag); complexity/planningType/ticketType are enums, so an out-of-enum value
+              // is denied at the schema gate before persistence. `status` is NOT settable
+              // (system/event-driven). Blueprint links are NOT settable here — use
+              // link_blueprint_to_tickets.
+              // ticket_general_actions — shell/general fields (partial edit).
               {
+                description: "Edit a ticket's shell/general fields. Only the keys you send are changed. Fields that do not apply are declared with the `justify` op (undo with `unjustify`), never by writing values here.",
                 properties: {
-                  type: { const: "update_ticket" },
-                  ticketId: { type: "string", description: "Ticket id; use list_tickets or lookup_ticket to find" }
+                  type: { const: "ticket_general_actions" },
+                  ticketId: { type: "string", description: "Ticket id (use list_tickets / lookup_ticket to find)." },
+                  title: { type: "string", description: "Concise imperative title." },
+                  description: { type: "string", description: "What this ticket delivers and why." },
+                  complexity: { type: "string", enum: ["small", "medium", "large", "xlarge"] },
+                  planningType: { type: "string", enum: ["planning", "on_flight"], description: "Changing this rolls the session back to ticket_decomposition to re-score." },
+                  ticketType: { type: "string", enum: ["implementation", "verification"], description: "Changing this rolls the session back to ticket_decomposition to re-score." },
+                  epicId: { type: "string", description: "Re-parent the ticket to another epic." },
+                  order: { type: "integer", description: "Rank hint within the epic." },
+                  guardrails: { type: "array", items: { type: "string" }, description: "Per-ticket guardrail ids or descriptions." },
+                  estimatedMinutes: { type: "integer", minimum: 0 }
                 },
                 required: ["type", "ticketId"]
               },
+              // ticket_step_actions — batch add/edit/remove/reorder of implementation steps.
+              {
+                description: "Batch-edit a ticket's implementation steps (add/edit/remove/reorder in one call). A step is a unit of FUNCTIONAL WORK \u2014 describe the functions/components/adjustments it makes AND what each does, never a bare filename. Declare the file(s) each step touches INLINE via `files: [{path, role}]`, role one of creates|modifies|deletes|imports|reads (imports couples to a build/run dependency; reads is a context-only glance). Fields that do not apply are declared with the `justify` op, never by writing empty values here.",
+                properties: {
+                  type: { const: "ticket_step_actions" },
+                  ticketId: { type: "string", description: "Ticket id (use list_tickets / lookup_ticket to find)." },
+                  add: { type: "array", description: "New steps to append.", items: { type: "object", properties: { text: { type: "string" }, files: { type: "array", description: "Files this step touches, by role \u2014 derives the step\u2194file link + the TicketFileChange row.", items: { type: "object", properties: { path: { type: "string" }, role: { type: "string", enum: ["creates", "modifies", "deletes", "imports", "reads"] }, symbol: { type: "string" }, why: { type: "string" } }, required: ["path", "role"] } } }, required: ["text"] } },
+                  edit: { type: "array", description: "Existing steps to edit (by stepId).", items: { type: "object", properties: { stepId: { type: "string" }, text: { type: "string" }, files: { type: "array", items: { type: "object", properties: { path: { type: "string" }, role: { type: "string", enum: ["creates", "modifies", "deletes", "imports", "reads"] }, symbol: { type: "string" }, why: { type: "string" } }, required: ["path", "role"] } } }, required: ["stepId"] } },
+                  remove: { type: "array", items: { type: "string" }, description: "Step ids to remove." },
+                  reorder: { type: "array", items: { type: "string" }, description: "Step ids in the desired order." }
+                },
+                required: ["type", "ticketId"]
+              },
+              // ticket_criteria_actions — batch add/edit/remove/reorder of acceptance criteria.
+              {
+                description: "Batch-edit a ticket's acceptance criteria (given/when/then; add/edit/remove/reorder in one call). Fields that do not apply are declared with the `justify` op, never by writing empty values here.",
+                properties: {
+                  type: { const: "ticket_criteria_actions" },
+                  ticketId: { type: "string", description: "Ticket id (use list_tickets / lookup_ticket to find)." },
+                  add: { type: "array", description: "New acceptance criteria to append.", items: { type: "object", properties: { given: { type: "string" }, when: { type: "string" }, then: { type: "string" } }, required: ["given", "when", "then"] } },
+                  edit: { type: "array", description: "Existing criteria to edit (by criterionId).", items: { type: "object", properties: { criterionId: { type: "string" }, given: { type: "string" }, when: { type: "string" }, then: { type: "string" } }, required: ["criterionId"] } },
+                  remove: { type: "array", items: { type: "string" }, description: "Criterion ids to remove." },
+                  reorder: { type: "array", items: { type: "string" }, description: "Criterion ids in the desired order." }
+                },
+                required: ["type", "ticketId"]
+              },
+              // ticket_test_actions — author the existing single-object testSpecification.
+              {
+                description: "Author a ticket's testSpecification (testTypes, qualityGates, testCommands, coverageTarget). Fields that do not apply are declared with the `justify` op, never by writing empty values here.",
+                properties: {
+                  type: { const: "ticket_test_actions" },
+                  ticketId: { type: "string", description: "Ticket id (use list_tickets / lookup_ticket to find)." },
+                  testSpecification: { type: "object", properties: { testTypes: { type: "array", items: { type: "string", enum: ["unit", "integration", "e2e", "typecheck", "lint", "build", "contract", "structural", "layout", "a11y", "performance"] } }, qualityGates: { type: "array", items: { type: "string" } }, testCommands: { type: "array", items: { type: "string" } }, coverageTarget: { type: "integer", minimum: 0, maximum: 100 } } }
+                },
+                required: ["type", "ticketId", "testSpecification"]
+              },
               {
                 properties: {
                   type: { const: "delete_epic" },
-                  epicId: { type: "string", description: "Epic id; cascades to all tickets in the epic" }
+                  id: { type: "string", description: "Epic id; cascades to all tickets in the epic." },
+                  cascadeRemoveDependencies: { type: "boolean", description: "Confirm removing dependency edges pointing at this epic's tickets from outside the epic. Required (true) when such referrers exist, else the delete is denied." }
                 },
-                required: ["type", "epicId"]
+                required: ["type", "id"]
               },
               {
                 properties: {
                   type: { const: "delete_ticket" },
-                  ticketId: { type: "string" }
+                  id: { type: "string", description: "Ticket id (use list_tickets / lookup_ticket to find)." },
+                  cascadeRemoveDependencies: { type: "boolean", description: "Confirm removing dependency edges from other tickets that point at this ticket. Required (true) when such referrers exist, else the delete is denied." }
                 },
-                required: ["type", "ticketId"]
+                required: ["type", "id"]
               },
               {
                 properties: {
-                  type: { const: "add_dependencies" },
+                  type: { const: "create_dependencies" },
                   dependencies: {
                     type: "array",
                     minItems: 1,
-                    maxItems: 100,
-                    description: "Up to 100 dependency pairs. Valid pairs commit; malformed pairs come back in failed[] with a per-entry reason.",
+                    maxItems: 5e3,
+                    description: 'Up to 5000 dependency pairs, each a "requires" edge (fromTicketId depends on toTicketId). The batch is validated atomically: a cycle or an all-duplicate batch is rejected with guidance; already-existing edges are skipped.',
                     items: {
                       type: "object",
                       properties: {
-                        ticketId: { type: "string", description: "The dependent ticket" },
-                        dependsOnId: { type: "string", description: "The blocker ticket" },
-                        type: { type: "string", enum: ["requires", "blocks"], description: 'Defaults to "requires"' }
+                        fromTicketId: { type: "string", description: "The dependent ticket (this one depends on the other)." },
+                        toTicketId: { type: "string", description: "The blocker ticket it depends on." }
                       },
-                      required: ["ticketId", "dependsOnId"]
+                      required: ["fromTicketId", "toTicketId"]
                     }
                   }
                 },
@@ -399,95 +481,178 @@ Format options:
               },
               {
                 properties: {
-                  type: { const: "remove_dependency" },
-                  dependencyId: { type: "string" }
+                  type: { const: "delete_dependencies" },
+                  dependencyIds: { type: "array", minItems: 1, items: { type: "string" }, description: "TicketDependency ids to remove (use lookup/list to find)." }
                 },
-                required: ["type", "dependencyId"]
+                required: ["type", "dependencyIds"]
               },
+              // apply_creator_election (MB.16.1) — the atomic creator-election batch: file
+              // moves + producing steps + ordering deps in ONE cross-phase op. Only the
+              // status:'clean' partition is applied; conflicts are excluded + surfaced to
+              // get_ticket. `dependencies` may be empty (single-toucher flips).
               {
                 properties: {
-                  type: { const: "remove_dependency" },
-                  ticketId: { type: "string" },
-                  dependsOnId: { type: "string" }
+                  type: { const: "apply_creator_election" },
+                  elections: {
+                    type: "array",
+                    minItems: 1,
+                    maxItems: 5e3,
+                    description: "The per-file creator elections. Each moves an orphan shared file to filesToBeCreated on its elected creator ticket + declares the producing step so the moved file is not a new orphan.",
+                    items: {
+                      type: "object",
+                      properties: {
+                        path: { type: "string", description: "The orphan shared file path to resolve." },
+                        kind: { type: "string", enum: ["creates", "modifies", "deletes", "imports", "reads"], description: "The step-file role the elected ticket takes for this path (normally creates)." },
+                        creatorTicketId: { type: "string", description: "The elected creator ticket (topologically-earliest toucher)." },
+                        producingStep: {
+                          type: "object",
+                          description: "The step that produces the moved file: pass an existing step id to link it, OR text to create-and-link a new step.",
+                          properties: {
+                            text: { type: "string", description: "Text of a NEW producing step to create + link." },
+                            stepId: { type: "string", description: "Id of an EXISTING step to link to the moved file." }
+                          }
+                        }
+                      },
+                      required: ["path", "kind", "creatorTicketId", "producingStep"]
+                    }
+                  },
+                  dependencies: {
+                    type: "array",
+                    maxItems: 5e3,
+                    description: `The ordering deps (each a "requires" edge). May be empty. Only the CLEAN partition's deps are persisted (recomputed + cycle-checked server-side).`,
+                    items: {
+                      type: "object",
+                      properties: {
+                        fromTicketId: { type: "string", description: "The dependent ticket (a non-elected toucher)." },
+                        toTicketId: { type: "string", description: "The elected creator it depends on." }
+                      },
+                      required: ["fromTicketId", "toTicketId"]
+                    }
+                  }
                 },
-                required: ["type", "ticketId", "dependsOnId"]
+                required: ["type", "elections", "dependencies"]
               },
               {
                 properties: {
                   type: { const: "create_blueprint" },
                   title: { type: "string", minLength: 1, description: "Blueprint title (non-empty)" },
-                  content: { type: "string", description: "Body. Mermaid format extracts ```mermaid``` fences automatically." },
-                  format: { type: "string", description: 'Defaults to "mermaid"' },
-                  category: { type: "string" },
+                  content: { type: "string", description: "Body \u2014 diagram source or markdown, persisted as-is on create." },
+                  format: { type: "string", enum: ["markdown", "mermaid", "ascii", "mixed", "html", "svg", "image"], description: 'Defaults to "mermaid"' },
+                  category: { type: "string", enum: ["flowchart", "architecture", "state", "sequence", "erd", "mockup", "adr", "component", "deployment", "api", "algorithm", "protocol", "glossary", "design_system"], description: "Blueprint category (SpecificationBlueprint.category model enum)." },
                   description: { type: "string" },
                   tags: { type: "array", items: { type: "string" } }
                 },
-                required: ["type", "title"]
+                required: ["type", "title", "category"]
               },
               {
                 properties: {
                   type: { const: "update_blueprint" },
-                  blueprintId: { type: "string" }
+                  id: { type: "string", description: "Blueprint id." },
+                  fields: {
+                    type: "object",
+                    description: "Partial blueprint update \u2014 only the keys you send are changed.",
+                    properties: {
+                      title: { type: "string" },
+                      content: { type: "string" },
+                      category: { type: "string" },
+                      description: { type: "string" },
+                      tags: { type: "array", items: { type: "string" } }
+                    }
+                  }
                 },
-                required: ["type", "blueprintId"]
+                required: ["type", "id", "fields"]
               },
               {
                 properties: {
                   type: { const: "delete_blueprint" },
-                  blueprintId: { type: "string" }
+                  id: { type: "string", description: "Blueprint id." }
                 },
-                required: ["type", "blueprintId"]
+                required: ["type", "id"]
               },
               {
                 properties: {
-                  type: { const: "link_blueprint" },
-                  ticketId: { type: "string" },
-                  blueprintId: { type: "string" },
-                  context: { type: "string", description: "Optional context annotation" },
-                  section: { type: "string", description: "Optional section reference" }
+                  type: { const: "link_blueprint_to_tickets" },
+                  blueprintId: { type: "string", description: "Blueprint to link." },
+                  ticketIds: { type: "array", minItems: 1, items: { type: "string" }, description: "Tickets to link the blueprint to." }
                 },
-                required: ["type", "ticketId", "blueprintId"]
+                required: ["type", "blueprintId", "ticketIds"]
               },
               {
                 properties: {
-                  type: { const: "unlink_blueprint" },
-                  referenceId: { type: "string" }
+                  type: { const: "unlink_blueprint_to_tickets" },
+                  blueprintId: { type: "string", description: "Blueprint to unlink." },
+                  ticketIds: { type: "array", minItems: 1, items: { type: "string" }, description: "Tickets to unlink the blueprint from." }
                 },
-                required: ["type", "referenceId"]
+                required: ["type", "blueprintId", "ticketIds"]
               },
+              // MB.14.1 — step↔artifact link verbs (create/delete a join row keyed on
+              // stepId + fileChangeId/snippetId). Get the ids from the ticket read-shape.
               {
                 properties: {
-                  type: { const: "unlink_blueprint" },
-                  ticketId: { type: "string" },
-                  blueprintId: { type: "string" }
+                  type: { const: "link_step_file" },
+                  stepId: { type: "string", description: "Implementation step id (the functional unit of work)." },
+                  fileChangeId: { type: "string", description: "Declared file-change id the step produces (from the ticket read-shape)." }
                 },
-                required: ["type", "ticketId", "blueprintId"]
+                required: ["type", "stepId", "fileChangeId"]
               },
               {
                 properties: {
-                  type: { const: "get_ticket" },
-                  ticketId: { type: "string" },
-                  include: { type: "array", items: { type: "string", enum: ["dependencies", "testStatus", "statusReason"] } }
+                  type: { const: "unlink_step_file" },
+                  stepId: { type: "string", description: "Implementation step id." },
+                  fileChangeId: { type: "string", description: "Declared file-change id to unlink from the step." }
                 },
-                required: ["type", "ticketId"]
+                required: ["type", "stepId", "fileChangeId"]
               },
               {
-                properties: { type: { const: "get_status" } },
-                required: ["type"]
+                properties: {
+                  type: { const: "link_step_snippet" },
+                  stepId: { type: "string", description: "Implementation step id." },
+                  snippetType: { type: "string", enum: ["code", "type"], description: "'code' \u2192 TicketCodeSnippet, 'type' \u2192 TicketTypeSnippet." },
+                  snippetId: { type: "string", description: "Code/type snippet id the step follows (recommended, not required per step \u2014 but a snippet linking NO step is dangling and blocks the ticket; link or drop it)." }
+                },
+                required: ["type", "stepId", "snippetType", "snippetId"]
+              },
+              {
+                properties: {
+                  type: { const: "unlink_step_snippet" },
+                  stepId: { type: "string", description: "Implementation step id." },
+                  snippetType: { type: "string", enum: ["code", "type"], description: "Which snippet table to unlink from." },
+                  snippetId: { type: "string", description: "Code/type snippet id to unlink from the step." }
+                },
+                required: ["type", "stepId", "snippetType", "snippetId"]
+              },
+              // justify — declare a field N/A (the paired declare op; unjustify removes it).
+              // Structural-neutral: it writes only the fieldDeclarations[scope] declaration,
+              // so it is native in EVERY planning phase and never rolls back. `scope` is the
+              // canonical field name the checks read (e.g. dependencies, codeReferences,
+              // apiContracts) — NOT a `fieldDeclarations`-shaped payload on update_*.
+              {
+                properties: {
+                  type: { const: "justify" },
+                  scope: { type: "string", description: "Canonical field name to mark not-applicable (e.g. 'dependencies', 'codeReferences', 'apiContracts')." },
+                  entityId: { type: "string", description: "The spec/epic/ticket id the field belongs to (resolved server-side; ids are unique across the spec)." },
+                  reason: { type: "string", description: "Why the field does not apply (must be at least 20 characters)." }
+                },
+                required: ["type", "scope", "entityId", "reason"]
               },
+              // unjustify — remove a previously declared N/A (clears fieldDeclarations[scope]).
+              // A no-op if the scope was never justified. No reason (a delete is unconditional).
               {
                 properties: {
-                  type: { const: "gps" },
-                  responseDetail: { type: "string", enum: ["minimal", "standard", "full"] }
+                  type: { const: "unjustify" },
+                  scope: { type: "string", description: "Canonical field name whose not-applicable declaration to remove." },
+                  entityId: { type: "string", description: "The spec/epic/ticket id the field belongs to." }
+                },
+                required: ["type", "scope", "entityId"]
+              },
+              {
+                // Read-only poll/resume. To read a single ticket, use the `get` tool (type:'ticket').
+                properties: {
+                  type: { const: "get_planning_status" }
                 },
                 required: ["type"]
               }
             ]
-          },
-          responseDetail: {
-            type: "string",
-            enum: ["minimal", "standard", "full"],
-            description: "Response detail level: minimal (~80 tokens), standard (~200, default), full (~500)"
           }
         },
         required: ["operation"]
@@ -506,7 +671,7 @@ Format options:
     },
     {
       name: "start_work_session",
-      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.",
+      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 the `get` tool (type:'ticket') separately. Returns error with statusReason if ticket is pending.",
       inputSchema: {
         type: "object",
         properties: {
@@ -522,9 +687,9 @@ Format options:
       name: "action_work_session",
       description: `Update checklist state during an active WorkSession. Combines step completion, AC validation, test result reporting, file tracking, reference review confirmation, and discovery reporting into a single atomic operation. All state changes are recorded on the WorkSession and its related validation/completion records.
 
-Use this instead of calling update_ticket for checklist changes. Provides:
-- Step completion (individual or bulk via WorkSessionStepCompletion)
-- Acceptance criteria validation (individual or bulk via WorkSessionACValidation)
+Use this instead of reopening the planning session for checklist changes. Provides:
+- Step completion (individual or bulk via WorkSessionImplStepCompletion)
+- Acceptance criteria validation (individual or bulk via WorkSessionAcceptanceCheck)
 - Test result reporting (merged by test type via WorkSessionTestResult)
 - File tracking (created, modified, deleted on WorkSession)
 - Discovery reporting (create discoveries for blockers, bugs, tech debt)
@@ -545,124 +710,32 @@ Set getTicket: true to fetch full ticket details in the response \u2014 useful f
             type: "string",
             description: "The ID of the ticket being worked on (must be in active status)"
           },
-          steps: {
-            type: "array",
-            description: "Individual step completion updates",
-            items: {
-              type: "object",
-              properties: {
-                index: {
-                  type: "number",
-                  description: "Zero-based index of the step in the implementation.steps array"
-                },
-                completed: {
-                  type: "boolean",
-                  description: "Whether the step is completed"
-                },
-                notes: {
-                  type: "string",
-                  description: "Optional note about this step"
-                }
-              },
-              required: ["index", "completed"]
-            }
-          },
-          allStepsDone: {
-            type: "boolean",
-            description: "Shortcut: mark all steps as completed"
-          },
-          acceptanceCriteria: {
-            type: "array",
-            description: "Individual AC validation updates",
-            items: {
-              type: "object",
-              properties: {
-                index: {
-                  type: "number",
-                  description: "Zero-based index of the AC in the acceptanceCriteria array"
-                },
-                validated: {
-                  type: "boolean",
-                  description: "Whether the AC is validated"
-                },
-                notes: {
-                  type: "string",
-                  description: "Optional note about this AC"
-                }
-              },
-              required: ["index", "validated"]
-            }
-          },
-          allACValidated: {
-            type: "boolean",
-            description: "Shortcut: mark all acceptance criteria as validated"
-          },
-          testResults: {
-            type: "array",
-            description: "Test result reports to append (merged by testType)",
-            items: {
-              type: "object",
-              properties: {
-                testType: {
-                  type: "string",
-                  description: 'Type of test (e.g., "unit", "integration", "e2e", "lint", "typeCheck")'
-                },
-                passed: {
-                  type: "number",
-                  description: "Number of tests that passed"
-                },
-                failed: {
-                  type: "number",
-                  description: "Number of tests that failed"
-                },
-                skipped: {
-                  type: "number",
-                  description: "Number of tests skipped"
-                },
-                command: {
-                  type: "string",
-                  description: "Command used to run the tests"
-                },
-                output: {
-                  type: "string",
-                  description: "Test output (truncated if needed)"
-                },
-                duration: {
-                  type: "number",
-                  description: "Duration in milliseconds"
-                },
-                suites: {
-                  type: "array",
-                  description: "Optional suite-level breakdown",
-                  items: {
-                    type: "object",
-                    properties: {
-                      name: { type: "string", description: "Suite name" },
-                      passed: { type: "number", description: "Passed tests in suite" },
-                      failed: { type: "number", description: "Failed tests in suite" },
-                      skipped: { type: "number", description: "Skipped tests in suite" },
-                      duration: { type: "number", description: "Suite duration in ms" }
-                    },
-                    required: ["name", "passed", "failed"]
-                  }
-                },
-                tests: {
-                  type: "array",
-                  description: "Optional individual test breakdown",
-                  items: {
-                    type: "object",
-                    properties: {
-                      name: { type: "string", description: "Test name" },
-                      suite: { type: "string", description: "Parent suite name" },
-                      status: { type: "string", enum: ["passed", "failed", "skipped"], description: "Test result" },
-                      duration: { type: "number", description: "Test duration in ms" }
-                    },
-                    required: ["name", "status"]
-                  }
-                }
+          action: {
+            type: "object",
+            description: "The assay action to record \u2014 the AWS action vocabulary. `action` (the discriminator) is one of: mark_implementation_step_completion, mark_acceptance_check, record_test_result, add_skip_justification, amend_skip_justification, add_failure_justification, amend_failure_justification, record_file_change, add_file_change_justification, amend_file_change_justification, create_discovery (with `blocking`), update_discovery, set_discovery_resolved. Include `workSessionId` and the per-action fields. Forwarded verbatim as the lifecycle inner payload.",
+            properties: {
+              action: {
+                type: "string",
+                enum: [
+                  "mark_implementation_step_completion",
+                  "mark_acceptance_check",
+                  "record_test_result",
+                  "add_skip_justification",
+                  "amend_skip_justification",
+                  "add_failure_justification",
+                  "amend_failure_justification",
+                  "record_file_change",
+                  "add_file_change_justification",
+                  "amend_file_change_justification",
+                  "create_discovery",
+                  "update_discovery",
+                  "set_discovery_resolved"
+                ],
+                description: "The AWS action discriminator."
               },
-              required: ["testType", "passed", "failed"]
-            }
+              workSessionId: { type: "string", description: "The active WorkSession id (from start_work_session)." }
+            },
+            required: ["action"]
           },
           notes: {
             type: "string",
@@ -760,22 +833,22 @@ Set getTicket: true to fetch full ticket details in the response \u2014 useful f
             properties: {
               tests: {
                 type: "string",
-                enum: ["passed", "failed", "skipped", "na"],
+                enum: ["passed", "failed", "partial", "pending"],
                 description: "Unit/integration test results"
               },
               lint: {
                 type: "string",
-                enum: ["passed", "failed", "skipped", "na"],
+                enum: ["passed", "failed", "partial", "pending"],
                 description: "Linting results"
               },
               typeCheck: {
                 type: "string",
-                enum: ["passed", "failed", "skipped", "na"],
+                enum: ["passed", "failed", "partial", "pending"],
                 description: "TypeScript type checking results"
               },
               build: {
                 type: "string",
-                enum: ["passed", "failed", "skipped", "na"],
+                enum: ["passed", "failed", "partial", "pending"],
                 description: "Build/compilation results"
               },
               notes: {
@@ -788,111 +861,9 @@ Set getTicket: true to fetch full ticket details in the response \u2014 useful f
         required: ["ticketId", "summary"]
       }
     },
-    {
-      name: "start_review_session",
-      description: 'Start the implementation review lifecycle. Runs the implementation gate and either auto-transitions to "reviewed" (on pass) or transitions to "in_review" with an active ReviewSession (on fail). Creates correction tickets via action_review_session, then call complete_review_session.',
-      inputSchema: {
-        type: "object",
-        properties: {
-          specificationId: {
-            type: "string",
-            description: "The ID of the specification to review (must be in ready_for_review status)"
-          }
-        },
-        required: ["specificationId"]
-      }
-    },
-    {
-      name: "action_review_session",
-      description: 'Address findings in an active review session. Create correction tickets inline or dismiss findings with justification. Only available when specification is in "in_review" status.',
-      inputSchema: {
-        type: "object",
-        properties: {
-          specificationId: {
-            type: "string",
-            description: "The ID of the specification"
-          },
-          reviewSessionId: {
-            type: "string",
-            description: "The review session ID (auto-detected if omitted)"
-          },
-          findingsAddressed: {
-            type: "array",
-            description: "Findings to address in this action",
-            items: {
-              type: "object",
-              properties: {
-                findingId: {
-                  type: "string",
-                  description: "The finding ID to address"
-                },
-                action: {
-                  type: "string",
-                  enum: ["correction_ticket", "dismissed"],
-                  description: "How to address the finding"
-                },
-                correctionTicket: {
-                  type: "object",
-                  description: "Inline ticket creation params (required for correction_ticket action)",
-                  properties: {
-                    epicId: { type: "string", description: "Epic to add the correction ticket to" },
-                    title: { type: "string", description: "Ticket title" },
-                    description: { type: "string", description: "Ticket description" },
-                    ticketType: { type: "string", enum: ["implementation", "verification"], description: "Ticket type \u2014 defaults to implementation." },
-                    priority: { type: "string", enum: ["low", "medium", "high", "critical"] },
-                    complexity: { type: "string", enum: ["small", "medium", "large", "xlarge"] },
-                    estimatedHours: { type: "number" },
-                    acceptanceCriteria: { type: "array", items: { type: "string" } },
-                    implementationSteps: { type: "array", items: { type: "string" }, description: "Implementation steps; persisted as TicketImplementationStep rows" },
-                    tags: { type: "array", items: { type: "string" } }
-                  },
-                  required: ["epicId", "title"]
-                },
-                justification: {
-                  type: "string",
-                  description: 'Required justification when action is "dismissed"'
-                }
-              },
-              required: ["findingId", "action"]
-            }
-          },
-          notes: {
-            type: "string",
-            description: "Optional notes for this review action"
-          }
-        },
-        required: ["specificationId"]
-      }
-    },
-    {
-      name: "complete_review_session",
-      description: 'Complete an active review session. All error-severity findings must be addressed. If correction tickets exist, transitions to "in_progress". If all findings dismissed, triggers user confirmation flow.',
-      inputSchema: {
-        type: "object",
-        properties: {
-          specificationId: {
-            type: "string",
-            description: "The ID of the specification"
-          },
-          reviewSessionId: {
-            type: "string",
-            description: "The review session ID (auto-detected if omitted)"
-          },
-          summary: {
-            type: "string",
-            description: "Optional completion summary"
-          },
-          confirmAllDismissed: {
-            type: "boolean",
-            description: "Set to true when all findings were dismissed to trigger user confirmation flow"
-          }
-        },
-        required: ["specificationId"]
-      }
-    },
     {
       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.',
+      description: 'Reopen a specification in "ready" status, regressing to "planning". Use when action_planning_session reports the spec is no longer in planning. After reopening, call start_planning_session to begin a new planning session.',
       inputSchema: {
         type: "object",
         properties: {
@@ -989,53 +960,6 @@ Set getTicket: true to fetch full ticket details in the response \u2014 useful f
         required: ["operation"]
       }
     },
-    {
-      name: "reset_work_session",
-      description: "Reset tickets to pending/ready status (calculated from dependencies). Returns statusCalculation showing how many became pending vs ready.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          specificationId: {
-            type: "string",
-            description: "The specification containing the tickets"
-          },
-          ticketIds: {
-            type: "array",
-            items: { type: "string" },
-            description: "Specific ticket IDs to reset"
-          },
-          fromTicketId: {
-            type: "string",
-            description: "Reset this ticket and all its dependents"
-          },
-          epicId: {
-            type: "string",
-            description: "Reset all tickets in this epic"
-          },
-          allTickets: {
-            type: "boolean",
-            description: "Reset all tickets in the specification"
-          },
-          resetDependents: {
-            type: "boolean",
-            description: "Also reset tickets that depend on the specified tickets (default: false)"
-          },
-          includeCompleted: {
-            type: "boolean",
-            description: "Include tickets with done status in the reset (default: false)"
-          },
-          preserveNotes: {
-            type: "boolean",
-            description: "Keep existing notes on tickets (default: true)"
-          },
-          clearTestResults: {
-            type: "boolean",
-            description: "Clear test result history (default: false)"
-          }
-        },
-        required: ["specificationId"]
-      }
-    },
     {
       name: "link_pull_request",
       description: "Associate a pull request with a ticket",
@@ -1102,6 +1026,19 @@ Set getTicket: true to fetch full ticket details in the response \u2014 useful f
       }
     }
   ];
+  const IN_DEVELOPMENT_PLANNED_FOR = {
+    start_work_session: "0.2.0",
+    action_work_session: "0.2.0",
+    complete_work_session: "0.2.0"
+  };
+  for (const t of tools) {
+    const plannedFor = IN_DEVELOPMENT_PLANNED_FOR[t.name];
+    if (plannedFor) {
+      t.description = `**In development \u2014 ships with ${plannedFor}.** Calling returns a typed stub response the client should render as a "coming soon" affordance.
+
+${t.description}`;
+    }
+  }
   return tools;
 }
 const RETRY_CONFIG = {
@@ -1155,7 +1092,22 @@ async function withRetry(fn, toolName, debug) {
 }
 function createToolHandlers(apiClient) {
   const callLocal = async (op, args) => {
+    const debug = process.env.SPECFORGE_DEBUG === "true";
+    const debugFile = process.env.SPECFORGE_DEBUG_FILE;
+    const trace = (line) => {
+      if (!debug) return;
+      if (debugFile) {
+        try {
+          appendFileSync(debugFile, line + "\n");
+          return;
+        } catch {
+        }
+      }
+      process.stderr.write(line + "\n");
+    };
+    trace(`[cli:wire \u2192] ${op} ${JSON.stringify(args)}`);
     const body = await apiClient.getTransport().execute(op, args);
+    trace(`[cli:wire \u2190] ${op} ${JSON.stringify(body).slice(0, 800)}`);
     if (body && typeof body === "object") {
       if (body.kind === "standard_error") {
         const guidance = body.guidance;
@@ -1239,9 +1191,13 @@ function createToolHandlers(apiClient) {
       if (!specificationId) {
         throw new Error("No active specification. Run `specforge switch <spec-id>` or pass specificationId.");
       }
+      const projectId = args.projectId ?? cfg?.projectId;
+      if (!projectId) {
+        throw new Error("No active project. Run `specforge switch <spec-id>` or pass projectId.");
+      }
       const agentResponse = await callLocal(
         "start_planning_session",
-        { specificationId }
+        { projectId, specificationId }
       );
       if (agentResponse?.sessionId) {
         saveProjectConfig({ planningSessionId: agentResponse.sessionId });
@@ -1281,37 +1237,37 @@ function createToolHandlers(apiClient) {
       if (!sessionId) {
         throw new Error("No active planning session. Call start_planning_session first.");
       }
-      return await callLocal("complete_planning_session", { sessionId });
+      const first = await callLocal(
+        "complete_planning_session",
+        { sessionId }
+      );
+      if (first?.outcome !== "evidence_required") {
+        return first;
+      }
+      const requested = Array.isArray(first.grepRequest?.paths) ? first.grepRequest.paths : [];
+      const existingFiles = probeExistingFiles(requested);
+      return await callLocal("complete_planning_session", { sessionId, existingFiles });
     },
     start_work_session: async (_client, args) => {
       validateRequired(args, "ticketId");
+      const git = readWorktreeGitEvidence();
       return await callLocal("start_work_session", {
-        ticketId: args.ticketId
+        ticketId: args.ticketId,
+        gitClean: git.gitClean,
+        worktreePath: git.worktreePath,
+        branch: git.branch
       });
     },
     action_work_session: async (_client, args) => {
       validateRequired(args, "ticketId");
       return await callLocal("action_work_session", {
         ticketId: args.ticketId,
-        steps: args.steps,
-        allStepsDone: args.allStepsDone,
-        acceptanceCriteria: args.acceptanceCriteria,
-        allACValidated: args.allACValidated,
-        testResults: args.testResults,
-        notes: args.notes,
-        filesCreated: args.filesCreated,
-        filesModified: args.filesModified,
-        filesDeleted: args.filesDeleted,
-        discovery: args.discovery,
-        blockReason: args.blockReason,
-        getTicket: args.getTicket,
-        includeFullContext: args.includeFullContext,
-        codeSnippetsReviewed: args.codeSnippetsReviewed,
-        typeReferencesReviewed: args.typeReferencesReviewed
+        payload: args.action ?? args.payload
       });
     },
     complete_work_session: async (_client, args) => {
       validateRequired(args, "ticketId", "summary");
+      const commitSha = readHeadCommitSha();
       return await callLocal("complete_work_session", {
         ticketId: args.ticketId,
         summary: args.summary,
@@ -1319,31 +1275,8 @@ function createToolHandlers(apiClient) {
         filesCreated: args.filesCreated,
         filesDeleted: args.filesDeleted,
         actualHours: args.actualHours,
-        validation: args.validation
-      });
-    },
-    start_review_session: async (_client, args) => {
-      const argsWithContext = injectContextRequired(args, ["specificationId"]);
-      return await callLocal("start_review_session", {
-        specificationId: argsWithContext.specificationId
-      });
-    },
-    action_review_session: async (_client, args) => {
-      const argsWithContext = injectContextRequired(args, ["specificationId"]);
-      return await callLocal("action_review_session", {
-        specificationId: argsWithContext.specificationId,
-        reviewSessionId: args.reviewSessionId,
-        findingsAddressed: args.findingsAddressed,
-        notes: args.notes
-      });
-    },
-    complete_review_session: async (_client, args) => {
-      const argsWithContext = injectContextRequired(args, ["specificationId"]);
-      return await callLocal("complete_review_session", {
-        specificationId: argsWithContext.specificationId,
-        reviewSessionId: args.reviewSessionId,
-        summary: args.summary,
-        confirmAllDismissed: args.confirmAllDismissed
+        validation: args.validation,
+        ...commitSha !== null && { commitSha }
       });
     },
     reopen_specification: async (_client, args) => {
@@ -1361,21 +1294,6 @@ function createToolHandlers(apiClient) {
     feedback: async (_client, args) => {
       return await callLocal("feedback", args);
     },
-    reset_work_session: async (_client, args) => {
-      validateRequired(args, "specificationId");
-      return await callLocal("reset_work_session", {
-        specificationId: args.specificationId,
-        ticketIds: args.ticketIds,
-        fromTicketId: args.fromTicketId,
-        epicId: args.epicId,
-        allTickets: args.allTickets,
-        targetStatus: args.targetStatus,
-        resetDependents: args.resetDependents,
-        includeCompleted: args.includeCompleted,
-        preserveNotes: args.preserveNotes,
-        clearTestResults: args.clearTestResults
-      });
-    },
     link_pull_request: async (_client, args) => {
       validateRequired(args, "ticketId");
       if (!args.prNumber && !args.prUrl) {