mcp-jira-stdio 1.8.0 → 1.9.0

package/dist/index.js

@@ -441,7 +441,7 @@ var require_package2 = __commonJS({
   "package.json"(exports$1, module) {
     module.exports = {
       name: "mcp-jira-stdio",
-      version: "1.8.0",
+      version: "1.9.0",
       description: "Model Context Protocol (MCP) server for Jira API integration",
       author: "graslt",
       license: "MIT",
@@ -497,7 +497,7 @@ var require_package2 = __commonJS({
         zod: "^3.22.4"
       },
       devDependencies: {
-        "@types/node": "^22.5.0",
+        "@types/node": "^25.3.3",
         "@typescript-eslint/eslint-plugin": "^8.0.0",
         "@typescript-eslint/parser": "^8.0.0",
         "@vitest/coverage-v8": "^4.0.10",
@@ -577,7 +577,9 @@ var TOOL_NAMES = {
   GET_COMMENTS: "jira_get_comments",
   ADD_ATTACHMENT: "jira_add_attachment",
   GET_ATTACHMENTS: "jira_get_attachments",
-  DELETE_ATTACHMENT: "jira_delete_attachment"
+  DELETE_ATTACHMENT: "jira_delete_attachment",
+  GET_TRANSITIONS: "jira_get_transitions",
+  TRANSITION_ISSUE: "jira_transition_issue"
 };
 
 // src/utils/logger.ts
@@ -883,6 +885,9 @@ var UpdateIssueInputSchema = z.object({
   assignee: z.string().optional().describe("New assignee account ID"),
   labels: z.array(z.string()).optional().describe("New labels (replaces existing)"),
   components: z.array(z.string()).optional().describe("New components (replaces existing)"),
+  parent: z.string().optional().describe(
+    "New parent issue key (e.g., PROJECT-100). Set to empty string to remove the parent."
+  ),
   returnIssue: z.boolean().optional().describe("When false, skip fetching full issue after update"),
   format: z.enum(["markdown", "adf", "plain"]).optional().default("markdown").describe(
     'Description format: "markdown" (converts Markdown to ADF), "adf" (use as-is ADF object), "plain" (converts plain text to ADF with basic formatting). Default: "markdown"'
@@ -985,6 +990,27 @@ var GetAttachmentsInputSchema = z.object({
 var DeleteAttachmentInputSchema = z.object({
   attachmentId: z.string().min(1).describe("ID of the attachment to delete")
 });
+var GetTransitionsInputSchema = z.object({
+  issueKey: z.string().describe("Issue key to get available transitions for (e.g., PROJECT-123)").refine((v) => isValidIssueKey(v), "Invalid issue key format")
+});
+var TransitionIssueInputSchema = z.object({
+  issueKey: z.string().describe("Issue key to transition (e.g., PROJECT-123)").refine((v) => isValidIssueKey(v), "Invalid issue key format"),
+  transitionId: z.string().optional().describe(
+    "ID of the transition to perform. Use jira_get_transitions to find available transition IDs."
+  ),
+  transitionName: z.string().optional().describe(
+    'Name of the transition to perform (e.g., "In Progress", "Done"). Case-insensitive. Alternative to transitionId.'
+  ),
+  comment: z.string().optional().describe("Optional comment to add when transitioning the issue"),
+  resolution: z.string().optional().describe(
+    'Resolution name when transitioning to a resolved/done status (e.g., "Done", "Fixed")'
+  ),
+  format: z.enum(["markdown", "adf", "plain"]).optional().default("markdown").describe(
+    'Comment format: "markdown" (converts Markdown to ADF), "adf" (use as-is ADF object), "plain" (converts plain text to ADF with basic formatting). Default: "markdown"'
+  )
+}).refine((data) => data.transitionId || data.transitionName, {
+  message: "Either transitionId or transitionName must be provided"
+});
 function ensureAdfDescription(desc, format = "markdown") {
   if (!desc) return desc;
   if (typeof desc === "object") return desc;
@@ -1237,6 +1263,9 @@ async function updateIssue(issueKey, updates) {
   if (updates.components !== void 0) {
     fields.components = updates.components.map((name) => ({ name }));
   }
+  if (updates.parent !== void 0) {
+    fields.parent = updates.parent ? { key: updates.parent } : null;
+  }
   const config = {
     method: "PUT",
     url: `/issue/${issueKey}`,
@@ -1521,6 +1550,42 @@ async function deleteAttachment(attachmentId) {
   };
   await makeJiraRequest(config);
 }
+async function getTransitions(issueKey) {
+  const config = {
+    method: "GET",
+    url: `/issue/${issueKey}/transitions`
+  };
+  const response = await makeJiraRequest(config);
+  return response.transitions;
+}
+async function transitionIssue(issueKey, transitionId, options = {}) {
+  const data = {
+    transition: { id: transitionId }
+  };
+  if (options.resolution) {
+    data.fields = {
+      resolution: { name: options.resolution }
+    };
+  }
+  if (options.comment) {
+    const adfBody = ensureAdfDescription(options.comment, options.format || "markdown");
+    data.update = {
+      comment: [
+        {
+          add: {
+            body: adfBody
+          }
+        }
+      ]
+    };
+  }
+  const config = {
+    method: "POST",
+    url: `/issue/${issueKey}/transitions`,
+    data
+  };
+  await makeJiraRequest(config);
+}
 
 // src/utils/redaction.ts
 function isRedactionEnabled() {
@@ -1608,6 +1673,8 @@ function formatIssueResponse(issue) {
   }
   const createdText = fields?.created ? new Date(fields.created).toISOString() : "N/A";
   const updatedText = fields?.updated ? new Date(fields.updated).toISOString() : "N/A";
+  const parentText = fields?.parent ? `
+**Parent:** ${fields.parent.key}${fields.parent.fields?.summary ? ` - ${fields.parent.fields.summary}` : ""}${fields.parent.fields?.status ? ` (${fields.parent.fields.status.name})` : ""}` : "";
   return {
     content: [
       {
@@ -1621,7 +1688,7 @@ function formatIssueResponse(issue) {
 **Project:** ${fields?.project?.name || "Unknown"} (${fields?.project?.key || "N/A"})
 **Issue Type:** ${fields?.issuetype?.name || "Unknown"}
 **Labels:** ${labelsText}
-**Components:** ${componentsText}
+**Components:** ${componentsText}${parentText}
 **Created:** ${createdText}
 **Updated:** ${updatedText}
 
@@ -2062,6 +2129,34 @@ ${attachmentsList}
     ]
   };
 }
+function formatTransitionsResponse(transitions, issueKey) {
+  if (transitions.length === 0) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `No transitions available for issue ${issueKey}. The issue may be in a final state or you may lack permission.`
+        }
+      ]
+    };
+  }
+  const transitionsList = transitions.map(
+    (t) => `\u2022 **${t.name}** (ID: ${t.id})
+  Target status: ${t.to.name} (Category: ${t.to.statusCategory?.name || "Unknown"})`
+  ).join("\n\n");
+  return {
+    content: [
+      {
+        type: "text",
+        text: `**Available transitions for ${issueKey}** (${transitions.length}):
+
+${transitionsList}
+
+\u{1F4A1} **Tip:** Use \`jira_transition_issue\` with the transition ID or name to move this issue.`
+      }
+    ]
+  };
+}
 
 // src/utils/error-handler.ts
 var log2 = createLogger("error-handler");
@@ -2612,6 +2707,10 @@ var updateIssueTool = {
         items: { type: "string" },
         description: "New components array (replaces existing components) - optional"
       },
+      parent: {
+        type: "string",
+        description: "New parent issue key (e.g., PROJECT-100). Set to empty string to remove the parent."
+      },
       returnIssue: {
         type: "boolean",
         description: "If false, returns a success message without fetching the updated issue",
@@ -2638,6 +2737,7 @@ async function handleUpdateIssue(input) {
     if (validated.assignee !== void 0) updateParams.assignee = validated.assignee;
     if (validated.labels !== void 0) updateParams.labels = validated.labels;
     if (validated.components !== void 0) updateParams.components = validated.components;
+    if (validated.parent !== void 0) updateParams.parent = validated.parent;
     if (validated.format !== void 0) updateParams.format = validated.format;
     await updateIssue(validated.issueKey, updateParams);
     if (validated.returnIssue === false) {
@@ -3130,6 +3230,115 @@ async function handleDeleteAttachment(input) {
   }
 }
 
+// src/tools/get-transitions.ts
+var log23 = createLogger("tool:get-transitions");
+var getTransitionsTool = {
+  name: TOOL_NAMES.GET_TRANSITIONS,
+  description: "Retrieves all available workflow transitions for a Jira issue. Use this to discover which status changes are possible for an issue before calling jira_transition_issue.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      issueKey: {
+        type: "string",
+        description: "Issue key to get available transitions for (e.g., PROJECT-123)"
+      }
+    },
+    required: ["issueKey"]
+  }
+};
+async function handleGetTransitions(input) {
+  try {
+    const validated = validateInput(GetTransitionsInputSchema, input);
+    log23.info(`Getting transitions for issue ${validated.issueKey}...`);
+    const transitions = await getTransitions(validated.issueKey);
+    log23.info(`Found ${transitions.length} transition(s) for ${validated.issueKey}`);
+    return formatTransitionsResponse(transitions, validated.issueKey);
+  } catch (error) {
+    log23.error("Error in handleGetTransitions:", error);
+    return handleError(error);
+  }
+}
+
+// src/tools/transition-issue.ts
+var log24 = createLogger("tool:transition-issue");
+var transitionIssueTool = {
+  name: TOOL_NAMES.TRANSITION_ISSUE,
+  description: 'Transitions a Jira issue to a new workflow status (e.g., "To Do" -> "In Progress" -> "Done"). Use jira_get_transitions first to discover available transitions. Supports adding a comment and setting resolution during the transition.',
+  inputSchema: {
+    type: "object",
+    properties: {
+      issueKey: {
+        type: "string",
+        description: "Issue key to transition (e.g., PROJECT-123)"
+      },
+      transitionId: {
+        type: "string",
+        description: "ID of the transition to perform. Use jira_get_transitions to find available transition IDs."
+      },
+      transitionName: {
+        type: "string",
+        description: 'Name of the transition to perform (e.g., "In Progress", "Done"). Case-insensitive. Alternative to transitionId.'
+      },
+      comment: {
+        type: "string",
+        description: "Optional comment to add when transitioning the issue"
+      },
+      resolution: {
+        type: "string",
+        description: 'Resolution name when transitioning to a resolved/done status (e.g., "Done", "Fixed")'
+      },
+      format: {
+        type: "string",
+        enum: ["markdown", "adf", "plain"],
+        description: 'Comment format: "markdown" (converts Markdown to ADF), "adf" (use as-is ADF object), "plain" (converts plain text to ADF with basic formatting). Default: "markdown"',
+        default: "markdown"
+      }
+    },
+    required: ["issueKey"]
+  }
+};
+async function handleTransitionIssue(input) {
+  try {
+    const validated = validateInput(TransitionIssueInputSchema, input);
+    let transitionId = validated.transitionId;
+    if (!transitionId && validated.transitionName) {
+      log24.info(
+        `Looking up transition "${validated.transitionName}" for issue ${validated.issueKey}...`
+      );
+      const transitions = await getTransitions(validated.issueKey);
+      const match = transitions.find(
+        (t) => t.name.toLowerCase() === validated.transitionName.toLowerCase()
+      );
+      if (!match) {
+        const available = transitions.map((t) => `"${t.name}" (ID: ${t.id})`).join(", ");
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Transition "${validated.transitionName}" not found for issue ${validated.issueKey}.
+
+Available transitions: ${available || "none"}`
+            }
+          ]
+        };
+      }
+      transitionId = match.id;
+    }
+    log24.info(`Transitioning issue ${validated.issueKey} with transition ${transitionId}...`);
+    const transitionOptions = {};
+    if (validated.comment) transitionOptions.comment = validated.comment;
+    if (validated.resolution) transitionOptions.resolution = validated.resolution;
+    if (validated.format) transitionOptions.format = validated.format;
+    await transitionIssue(validated.issueKey, transitionId, transitionOptions);
+    const updatedIssue = await getIssue(validated.issueKey);
+    log24.info(`Transitioned issue ${validated.issueKey} to ${updatedIssue.fields.status.name}`);
+    return formatIssueResponse(updatedIssue);
+  } catch (error) {
+    log24.error("Error in handleTransitionIssue:", error);
+    return handleError(error);
+  }
+}
+
 // src/index.ts
 if (process.env.NODE_ENV !== "production") {
   try {
@@ -3138,7 +3347,7 @@ if (process.env.NODE_ENV !== "production") {
   } catch {
   }
 }
-var log23 = createLogger("server");
+var log25 = createLogger("server");
 var toolHandlers = /* @__PURE__ */ new Map([
   [TOOL_NAMES.GET_VISIBLE_PROJECTS, handleGetVisibleProjects],
   [TOOL_NAMES.GET_ISSUE, handleGetIssue],
@@ -3159,7 +3368,9 @@ var toolHandlers = /* @__PURE__ */ new Map([
   [TOOL_NAMES.GET_COMMENTS, handleGetComments],
   [TOOL_NAMES.ADD_ATTACHMENT, handleAddAttachment],
   [TOOL_NAMES.GET_ATTACHMENTS, handleGetAttachments],
-  [TOOL_NAMES.DELETE_ATTACHMENT, handleDeleteAttachment]
+  [TOOL_NAMES.DELETE_ATTACHMENT, handleDeleteAttachment],
+  [TOOL_NAMES.GET_TRANSITIONS, handleGetTransitions],
+  [TOOL_NAMES.TRANSITION_ISSUE, handleTransitionIssue]
 ]);
 var allTools = [
   getVisibleProjectsTool,
@@ -3181,7 +3392,9 @@ var allTools = [
   getCommentsTool,
   addAttachmentTool,
   getAttachmentsTool,
-  deleteAttachmentTool
+  deleteAttachmentTool,
+  getTransitionsTool,
+  transitionIssueTool
 ];
 async function main() {
   const isDryRun = (process.env.DRY_RUN || "").toLowerCase() === "1" || (process.env.DRY_RUN || "").toLowerCase() === "true";
@@ -3252,7 +3465,7 @@ async function main() {
   console.error("\u{1F680} Jira MCP server running on stdio");
 }
 main().catch((error) => {
-  log23.error("Fatal error:", error);
+  log25.error("Fatal error:", error);
   process.exit(1);
 });
 //# sourceMappingURL=index.js.map