@rokealvo/jira-mcp 1.2.2 → 1.3.0

package/build/index.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-import { Server as f } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport as h } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { ListPromptsRequestSchema as g, GetPromptRequestSchema as I, McpError as c, ErrorCode as p, ListToolsRequestSchema as w, CallToolRequestSchema as _ } from "@modelcontextprotocol/sdk/types.js";
-class y {
+import { Server as h } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport as f } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListPromptsRequestSchema as g, GetPromptRequestSchema as I, McpError as c, ErrorCode as d, ListToolsRequestSchema as w, CallToolRequestSchema as _ } from "@modelcontextprotocol/sdk/types.js";
+class m {
   baseUrl;
   headers;
   constructor(t, e, s, i = "basic") {
     this.baseUrl = t;
-    let a;
-    i === "bearer" ? a = `Bearer ${s}` : a = `Basic ${Buffer.from(`${e}:${s}`).toString("base64")}`, this.headers = new Headers({
-      Authorization: a,
+    let r;
+    i === "bearer" ? r = `Bearer ${s}` : r = `Basic ${Buffer.from(`${e}:${s}`).toString("base64")}`, this.headers = new Headers({
+      Authorization: r,
       Accept: "application/json",
       "Content-Type": "application/json"
     });
@@ -25,14 +25,14 @@ class y {
         else if (i.errorMessage)
           s = i.errorMessage;
         else if (i.errors && typeof i.errors == "object") {
-          const a = Object.entries(i.errors).map(([r, n]) => `${r}: ${n}`).join("; ");
-          a && (s = a);
+          const r = Object.entries(i.errors).map(([a, n]) => `${a}: ${n}`).join("; ");
+          r && (s = r);
         }
         s === t.statusText && Object.keys(i).length > 0 && (s = JSON.stringify(i));
       } catch {
         try {
-          const r = await t.text();
-          r && (s = r.substring(0, 500));
+          const a = await t.text();
+          a && (s = a.substring(0, 500));
         } catch {
         }
       }
@@ -47,9 +47,9 @@ class y {
    * Looks for nodes that were auto-converted to issue links
    */
   extractIssueMentions(t, e, s) {
-    const i = [], a = (r) => {
-      if (r.type === "inlineCard" && r.attrs?.url) {
-        const n = r.attrs.url.match(/\/browse\/([A-Z]+-\d+)/);
+    const i = [], r = (a) => {
+      if (a.type === "inlineCard" && a.attrs?.url) {
+        const n = a.attrs.url.match(/\/browse\/([A-Z]+-\d+)/);
         n && i.push({
           key: n[1],
           type: "mention",
@@ -57,16 +57,16 @@ class y {
           commentId: s
         });
       }
-      r.type === "text" && r.text && (r.text.match(/[A-Z]+-\d+/g) || []).forEach((o) => {
+      a.type === "text" && a.text && (a.text.match(/[A-Z]+-\d+/g) || []).forEach((o) => {
         i.push({
           key: o,
           type: "mention",
           source: e,
           commentId: s
         });
-      }), r.content && r.content.forEach(a);
+      }), a.content && a.content.forEach(r);
     };
-    return t.forEach(a), [...new Map(i.map((r) => [r.key, r])).values()];
+    return t.forEach(r), [...new Map(i.map((a) => [a.key, a])).values()];
   }
   cleanComment(t) {
     const e = t.body?.content ? this.extractTextContent(t.body.content) : "", s = t.body?.content ? this.extractIssueMentions(t.body.content, "comment", t.id) : [];
@@ -118,11 +118,11 @@ class y {
       i.length > 0 && (s.relatedIssues = i);
     }
     if (t.fields?.issuelinks?.length > 0) {
-      const i = t.fields.issuelinks.map((a) => {
-        const r = a.inwardIssue || a.outwardIssue, n = a.type.inward || a.type.outward;
+      const i = t.fields.issuelinks.map((r) => {
+        const a = r.inwardIssue || r.outwardIssue, n = r.type.inward || r.type.outward;
         return {
-          key: r.key,
-          summary: r.fields?.summary,
+          key: a.key,
+          summary: a.fields?.summary,
           type: "link",
           relationship: n,
           source: "description"
@@ -154,7 +154,8 @@ class y {
       ...e,
       headers: this.headers
     });
-    return s.ok || await this.handleFetchError(s, t), s.json();
+    if (s.ok || await this.handleFetchError(s, t), !(s.status === 204 || s.headers.get("content-length") === "0"))
+      return s.json();
   }
   async searchIssues(t) {
     const e = new URLSearchParams({
@@ -200,17 +201,17 @@ class y {
       expand: "names,renderedFields"
     }), s = await this.fetchJson(`/rest/api/3/search?${e}`);
     return await Promise.all(
-      s.issues.map(async (a) => {
-        const r = await this.fetchJson(
-          `/rest/api/3/issue/${a.key}/comment`
-        ), n = this.cleanIssue(a), o = r.comments.map(
-          (d) => this.cleanComment(d)
-        ), u = o.flatMap(
-          (d) => d.mentions
+      s.issues.map(async (r) => {
+        const a = await this.fetchJson(
+          `/rest/api/3/issue/${r.key}/comment`
+        ), n = this.cleanIssue(r), o = a.comments.map(
+          (u) => this.cleanComment(u)
+        ), p = o.flatMap(
+          (u) => u.mentions
         );
         return n.relatedIssues = [
           ...n.relatedIssues,
-          ...u
+          ...p
         ], n.comments = o, n;
       })
     );
@@ -242,24 +243,24 @@ class y {
     } catch (o) {
       throw o instanceof Error && o.message.includes("(Status: 404)") ? new Error(`Issue not found: ${t}`) : o;
     }
-    const a = this.cleanIssue(s), r = i.comments.map(
+    const r = this.cleanIssue(s), a = i.comments.map(
       (o) => this.cleanComment(o)
-    ), n = r.flatMap(
+    ), n = a.flatMap(
       (o) => o.mentions
     );
-    if (a.relatedIssues = [...a.relatedIssues, ...n], a.comments = r, a.epicLink)
+    if (r.relatedIssues = [...r.relatedIssues, ...n], r.comments = a, r.epicLink)
       try {
         const o = await this.fetchJson(
-          `/rest/api/3/issue/${a.epicLink.key}?fields=summary`
+          `/rest/api/3/issue/${r.epicLink.key}?fields=summary`
         );
-        a.epicLink.summary = o.fields?.summary;
+        r.epicLink.summary = o.fields?.summary;
       } catch (o) {
         console.error("Failed to fetch epic details:", o);
       }
-    return a;
+    return r;
   }
-  async createIssue(t, e, s, i, a) {
-    const r = {
+  async createIssue(t, e, s, i, r) {
+    const a = {
       fields: {
         project: {
           key: t
@@ -269,41 +270,41 @@ class y {
           name: e
         },
         ...i && { description: i },
-        ...a
+        ...r
       }
     };
     return this.fetchJson("/rest/api/3/issue", {
       method: "POST",
-      body: JSON.stringify(r)
+      body: JSON.stringify(a)
     });
   }
   async getCreateMeta(t, e, s) {
-    let a = (await this.fetchJson(
+    let r = (await this.fetchJson(
       `/rest/api/3/issue/createmeta/${t}/issuetypes`
     )).issueTypes || [];
-    return e && (a = a.filter(
+    return e && (r = r.filter(
       (n) => n.name.toLowerCase() === e.toLowerCase()
     )), {
       projectKey: t,
       issueTypes: await Promise.all(
-        a.map(async (n) => {
+        r.map(async (n) => {
           try {
-            let u = (await this.fetchJson(
+            let p = (await this.fetchJson(
               `/rest/api/3/issue/createmeta/${t}/issuetypes/${n.id}`
             )).fields || [];
-            return s && (u = u.map((d) => ({
-              fieldId: d.fieldId,
-              name: d.name,
-              required: d.required,
-              schema: d.schema,
-              hasDefaultValue: d.hasDefaultValue,
-              allowedValuesCount: d.allowedValues?.length ?? 0
+            return s && (p = p.map((u) => ({
+              fieldId: u.fieldId,
+              name: u.name,
+              required: u.required,
+              schema: u.schema,
+              hasDefaultValue: u.hasDefaultValue,
+              allowedValuesCount: u.allowedValues?.length ?? 0
             }))), {
               id: n.id,
               name: n.name,
               description: n.description,
               subtask: n.subtask,
-              fields: u
+              fields: p
             };
           } catch (o) {
             return {
@@ -322,7 +323,7 @@ class y {
   async getFieldOptions(t, e, s) {
     return ((await this.fetchJson(
       `/rest/api/3/issue/createmeta/${t}/issuetypes/${e}`
-    )).fields || []).find((r) => r.fieldId === s)?.allowedValues ?? [];
+    )).fields || []).find((a) => a.fieldId === s)?.allowedValues ?? [];
   }
   async updateIssue(t, e) {
     await this.fetchJson(`/rest/api/3/issue/${t}`, {
@@ -369,18 +370,18 @@ class y {
   async addAttachment(t, e, s) {
     const i = new FormData();
     i.append("file", new Blob([new Uint8Array(e)]), s);
-    const a = new Headers(this.headers);
-    a.delete("Content-Type"), a.set("X-Atlassian-Token", "no-check");
-    const r = await fetch(
+    const r = new Headers(this.headers);
+    r.delete("Content-Type"), r.set("X-Atlassian-Token", "no-check");
+    const a = await fetch(
       `${this.baseUrl}/rest/api/3/issue/${t}/attachments`,
       {
         method: "POST",
-        headers: a,
+        headers: r,
         body: i
       }
     );
-    r.ok || await this.handleFetchError(r);
-    const o = (await r.json())[0];
+    a.ok || await this.handleFetchError(a);
+    const o = (await a.json())[0];
     return {
       id: o.id,
       filename: o.filename
@@ -412,7 +413,7 @@ class y {
   async addCommentToIssue(t, e) {
     const i = {
       body: this.createAdfFromBody(e)
-    }, a = await this.fetchJson(
+    }, r = await this.fetchJson(
       `/rest/api/3/issue/${t}/comment`,
       {
         method: "POST",
@@ -420,11 +421,11 @@ class y {
       }
     );
     return {
-      id: a.id,
-      author: a.author.displayName,
-      created: a.created,
-      updated: a.updated,
-      body: this.extractTextContent(a.body.content)
+      id: r.id,
+      author: r.author.displayName,
+      created: r.created,
+      updated: r.updated,
+      body: this.extractTextContent(r.body.content)
     };
   }
   async getServerInfo() {
@@ -447,11 +448,11 @@ class y {
       query: t,
       maxResults: e.toString()
     });
-    return (await this.fetchJson(`/rest/api/3/user/search?${s}`)).map((a) => ({
-      accountId: a.accountId,
-      displayName: a.displayName,
-      emailAddress: a.emailAddress,
-      active: a.active
+    return (await this.fetchJson(`/rest/api/3/user/search?${s}`)).map((r) => ({
+      accountId: r.accountId,
+      displayName: r.displayName,
+      emailAddress: r.emailAddress,
+      active: r.active
     }));
   }
   async deleteIssue(t) {
@@ -473,8 +474,30 @@ class y {
       mimeType: e.mimeType
     };
   }
+  // ============================================================================
+  // TM4J / Zephyr Scale API Methods
+  // ============================================================================
+  tm4jBasePath = "/rest/atm/1.0";
+  async getTestCase(t) {
+    return this.fetchJson(`${this.tm4jBasePath}/testcase/${t}`);
+  }
+  async searchTestCases(t, e = 50) {
+    const s = encodeURIComponent(t);
+    return this.fetchJson(
+      `${this.tm4jBasePath}/testcase/search?query=${s}&maxResults=${e}`
+    );
+  }
+  async getTestRun(t) {
+    return this.fetchJson(`${this.tm4jBasePath}/testrun/${t}`);
+  }
+  async searchTestRuns(t, e = 50) {
+    const s = encodeURIComponent(t);
+    return this.fetchJson(
+      `${this.tm4jBasePath}/testrun/search?query=${s}&maxResults=${e}`
+    );
+  }
 }
-class b extends y {
+class b extends m {
   constructor(t, e, s, i = "basic") {
     super(t, e, s, i);
   }
@@ -489,32 +512,32 @@ class b extends y {
   }
   // Override getCreateMeta to use API v2 endpoints for Jira Server 9.0+
   async getCreateMeta(t, e, s) {
-    let a = (await this.fetchJson(
+    let r = (await this.fetchJson(
       `/rest/api/3/issue/createmeta/${t}/issuetypes`
     )).values || [];
-    return e && (a = a.filter(
+    return e && (r = r.filter(
       (n) => n.name.toLowerCase() === e.toLowerCase()
     )), {
       projectKey: t,
       issueTypes: await Promise.all(
-        a.map(async (n) => {
+        r.map(async (n) => {
           try {
-            let u = (await this.fetchJson(
+            let p = (await this.fetchJson(
               `/rest/api/3/issue/createmeta/${t}/issuetypes/${n.id}`
             )).values || [];
-            return s && (u = u.map((d) => ({
-              fieldId: d.fieldId,
-              name: d.name,
-              required: d.required,
-              schema: d.schema,
-              hasDefaultValue: d.hasDefaultValue,
-              allowedValuesCount: d.allowedValues?.length ?? 0
+            return s && (p = p.map((u) => ({
+              fieldId: u.fieldId,
+              name: u.name,
+              required: u.required,
+              schema: u.schema,
+              hasDefaultValue: u.hasDefaultValue,
+              allowedValuesCount: u.allowedValues?.length ?? 0
             }))), {
               id: n.id,
               name: n.name,
               description: n.description,
               subtask: n.subtask,
-              fields: u
+              fields: p
             };
           } catch (o) {
             return {
@@ -534,7 +557,7 @@ class b extends y {
   async getFieldOptions(t, e, s) {
     return ((await this.fetchJson(
       `/rest/api/3/issue/createmeta/${t}/issuetypes/${e}`
-    )).values || []).find((r) => r.fieldId === s)?.allowedValues ?? [];
+    )).values || []).find((a) => a.fieldId === s)?.allowedValues ?? [];
   }
   // Override getUsers for Jira Server (uses 'username' parameter instead of 'query')
   async getUsers(t, e = 50) {
@@ -542,12 +565,12 @@ class b extends y {
       username: t,
       maxResults: e.toString()
     });
-    return (await this.fetchJson(`/rest/api/3/user/search?${s}`)).map((a) => ({
+    return (await this.fetchJson(`/rest/api/3/user/search?${s}`)).map((r) => ({
       // Jira Server uses 'name' or 'key' instead of 'accountId'
-      accountId: a.key || a.name,
-      displayName: a.displayName,
-      emailAddress: a.emailAddress,
-      active: a.active
+      accountId: r.key || r.name,
+      displayName: r.displayName,
+      emailAddress: r.emailAddress,
+      active: r.active
     }));
   }
   // Override addCommentToIssue for Jira Server (uses plain text instead of ADF)
@@ -594,15 +617,15 @@ class b extends y {
   extractIssueMentionsFromText(t, e, s) {
     if (!t) return [];
     const i = t.match(/[A-Z]+-\d+/g) || [];
-    return [...new Set(i)].map((r) => ({
-      key: r,
+    return [...new Set(i)].map((a) => ({
+      key: a,
       type: "mention",
       source: e,
       commentId: s
     }));
   }
 }
-function A() {
+function T() {
   const l = process.env.JIRA_API_TOKEN ?? "", t = process.env.JIRA_BASE_URL ?? "", e = process.env.JIRA_USER_EMAIL ?? "", s = process.env.JIRA_TYPE === "server" ? "server" : "cloud", i = process.env.JIRA_AUTH_TYPE === "bearer" ? "bearer" : "basic";
   if (!l || !t || !e)
     throw new Error(
@@ -610,7 +633,7 @@ function A() {
     );
   return { JIRA_API_TOKEN: l, JIRA_BASE_URL: t, JIRA_USER_EMAIL: e, JIRA_TYPE: s, JIRA_AUTH_TYPE: i };
 }
-const m = {
+const y = {
   jira_guidelines: {
     description: "Общие правила и регламенты работы с Jira в компании",
     content: `# Регламент работы с Jira
@@ -863,7 +886,7 @@ class S {
   server;
   jiraApi;
   constructor() {
-    this.server = new f(
+    this.server = new h(
       {
         name: "jira-mcp",
         version: "0.3.0"
@@ -875,32 +898,32 @@ class S {
         }
       }
     );
-    const { JIRA_API_TOKEN: t, JIRA_BASE_URL: e, JIRA_USER_EMAIL: s, JIRA_TYPE: i, JIRA_AUTH_TYPE: a } = A();
+    const { JIRA_API_TOKEN: t, JIRA_BASE_URL: e, JIRA_USER_EMAIL: s, JIRA_TYPE: i, JIRA_AUTH_TYPE: r } = T();
     i === "server" ? this.jiraApi = new b(
       e,
       s,
       t,
-      a
-    ) : this.jiraApi = new y(
+      r
+    ) : this.jiraApi = new m(
       e,
       s,
       t,
-      a
-    ), this.setupToolHandlers(), this.server.onerror = (r) => {
+      r
+    ), this.setupToolHandlers(), this.server.onerror = (a) => {
     }, process.on("SIGINT", async () => {
       await this.server.close(), process.exit(0);
     });
   }
   setupToolHandlers() {
     this.server.setRequestHandler(g, async () => ({
-      prompts: Object.entries(m).map(([t, { description: e }]) => ({
+      prompts: Object.entries(y).map(([t, { description: e }]) => ({
         name: t,
         description: e
       }))
     })), this.server.setRequestHandler(I, async (t) => {
-      const { name: e } = t.params, s = m[e];
+      const { name: e } = t.params, s = y[e];
       if (!s)
-        throw new c(p.InvalidParams, `Unknown prompt: ${e}`);
+        throw new c(d.InvalidParams, `Unknown prompt: ${e}`);
       return {
         messages: [
           {
@@ -1027,7 +1050,13 @@ See prompt "update_issue_workflow" for guidelines.`,
 - Only transitions returned by this tool are valid
 - Transition availability depends on workflow rules (e.g., user can only have one task "В работе")
 - If desired transition is not in the list, inform the user — do NOT guess or invent transition names/IDs
-- Returns array with: id (use this for transition_issue), name, to.name (target status)`,
+- Returns array with: id (use this for transition_issue), name, to.name (target status)
+
+⚠️ STATUS MISMATCH RULE: When user requests a specific status (e.g., "в работу", "на ревью"):
+1. Compare available transitions with the requested status
+2. If exact match NOT found — ALWAYS ASK the user which status to use
+3. Present the list of available transitions to choose from
+4. NEVER silently choose a "similar" status on your own`,
           inputSchema: {
             type: "object",
             properties: {
@@ -1051,6 +1080,13 @@ See prompt "update_issue_workflow" for guidelines.`,
   - Current status may not allow direct transition to target status
   - User permissions may limit available transitions
 
+⚠️ STATUS MISMATCH RULE:
+- If user requested a specific status that is NOT in available transitions:
+  - STOP and ASK user which available status to use
+  - List all available transitions with their target statuses
+  - Explain why requested status may be unavailable
+- NEVER silently substitute a different status — this confuses users!
+
 ⚠️ CANCELLATION RULE: When transitioning to "Отмена" (Cancel), you MUST first:
 1. Ask user for cancellation reason
 2. Add comment with the reason using add_comment
@@ -1234,6 +1270,83 @@ Remember to add a comment with cancellation reason first.`,
             required: ["attachmentId"],
             additionalProperties: !1
           }
+        },
+        // ====================================================================
+        // TM4J / Zephyr Scale Tools
+        // ====================================================================
+        {
+          name: "search_test_cases",
+          description: `Search TM4J/Zephyr Scale test cases using query.
+
+Supported query fields: projectKey (required), folder, status, priority, component.
+Example: projectKey = "IM3" AND status = "Approved"
+
+⚠️ LIMITATION: Full-text search is NOT supported. Queries like name ~ "keyword" do NOT work.
+To search by name: fetch all test cases for project, then filter results on your side.`,
+          inputSchema: {
+            type: "object",
+            properties: {
+              query: {
+                type: "string",
+                description: 'TM4J query string (e.g., projectKey = "IM3")'
+              },
+              maxResults: {
+                type: "number",
+                description: "Maximum number of results to return (default: 50)"
+              }
+            },
+            required: ["query"],
+            additionalProperties: !1
+          }
+        },
+        {
+          name: "get_test_case",
+          description: "Get a TM4J/Zephyr Scale test case by key (e.g., IM3-T9). Returns test case details including steps.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              testCaseKey: {
+                type: "string",
+                description: "Test case key (e.g., IM3-T9)"
+              }
+            },
+            required: ["testCaseKey"],
+            additionalProperties: !1
+          }
+        },
+        {
+          name: "search_test_runs",
+          description: 'Search TM4J/Zephyr Scale test runs/cycles. Example: projectKey = "IM3"',
+          inputSchema: {
+            type: "object",
+            properties: {
+              query: {
+                type: "string",
+                description: 'TM4J query string (e.g., projectKey = "IM3")'
+              },
+              maxResults: {
+                type: "number",
+                description: "Maximum number of results to return (default: 50)"
+              }
+            },
+            required: ["query"],
+            additionalProperties: !1
+          }
+        },
+        {
+          name: "get_test_run",
+          description: "Get a TM4J/Zephyr Scale test run by key. Returns test run details including all test case items and their execution status.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              testRunKey: {
+                type: "string",
+                description: "Test run key"
+              }
+            },
+            required: ["testRunKey"],
+            additionalProperties: !1
+          }
         }
       ]
     })), this.server.setRequestHandler(_, async (t) => {
@@ -1243,7 +1356,7 @@ Remember to add a comment with cancellation reason first.`,
           case "search_issues": {
             if (!e.searchString || typeof e.searchString != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "Search string is required"
               );
             const s = await this.jiraApi.searchIssues(e.searchString);
@@ -1256,7 +1369,7 @@ Remember to add a comment with cancellation reason first.`,
           case "get_epic_children": {
             if (!e.epicKey || typeof e.epicKey != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "Epic key is required"
               );
             const s = await this.jiraApi.getEpicChildren(e.epicKey);
@@ -1269,7 +1382,7 @@ Remember to add a comment with cancellation reason first.`,
           case "get_issue": {
             if (!e.issueId || typeof e.issueId != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "Issue ID is required"
               );
             const s = await this.jiraApi.getIssueWithComments(
@@ -1284,7 +1397,7 @@ Remember to add a comment with cancellation reason first.`,
           case "create_issue": {
             if (!e.projectKey || typeof e.projectKey != "string" || !e.issueType || typeof e.issueType != "string" || !e.summary || typeof e.summary != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "projectKey, issueType, and summary are required"
               );
             const s = await this.jiraApi.createIssue(
@@ -1303,7 +1416,7 @@ Remember to add a comment with cancellation reason first.`,
           case "update_issue": {
             if (!e.issueKey || typeof e.issueKey != "string" || !e.fields || typeof e.fields != "object")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "issueKey and fields object are required"
               );
             return await this.jiraApi.updateIssue(e.issueKey, e.fields), {
@@ -1322,7 +1435,7 @@ Remember to add a comment with cancellation reason first.`,
           case "get_transitions": {
             if (!e.issueKey || typeof e.issueKey != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "Issue key is required"
               );
             const s = await this.jiraApi.getTransitions(e.issueKey);
@@ -1335,7 +1448,7 @@ Remember to add a comment with cancellation reason first.`,
           case "transition_issue": {
             if (!e.issueKey || typeof e.issueKey != "string" || !e.transitionId || typeof e.transitionId != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "issueKey and transitionId are required"
               );
             return await this.jiraApi.transitionIssue(
@@ -1360,7 +1473,7 @@ Remember to add a comment with cancellation reason first.`,
           case "add_attachment": {
             if (!e.issueKey || typeof e.issueKey != "string" || !e.fileContent || typeof e.fileContent != "string" || !e.filename || typeof e.filename != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "issueKey, fileContent, and filename are required"
               );
             const s = Buffer.from(e.fileContent, "base64"), i = await this.jiraApi.addAttachment(
@@ -1388,7 +1501,7 @@ Remember to add a comment with cancellation reason first.`,
           case "add_comment": {
             if (!e.issueIdOrKey || typeof e.issueIdOrKey != "string" || !e.body || typeof e.body != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "issueIdOrKey and body are required"
               );
             const s = await this.jiraApi.addCommentToIssue(
@@ -1404,7 +1517,7 @@ Remember to add a comment with cancellation reason first.`,
           case "get_create_meta": {
             if (!e.projectKey || typeof e.projectKey != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "projectKey is required"
               );
             const s = await this.jiraApi.getCreateMeta(
@@ -1421,7 +1534,7 @@ Remember to add a comment with cancellation reason first.`,
           case "get_field_options": {
             if (!e.projectKey || typeof e.projectKey != "string" || !e.issueTypeId || typeof e.issueTypeId != "string" || !e.fieldId || typeof e.fieldId != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "projectKey, issueTypeId, and fieldId are required"
               );
             const s = await this.jiraApi.getFieldOptions(
@@ -1454,7 +1567,7 @@ Remember to add a comment with cancellation reason first.`,
           case "get_users": {
             if (!e.query || typeof e.query != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "query is required"
               );
             const s = await this.jiraApi.getUsers(
@@ -1470,7 +1583,7 @@ Remember to add a comment with cancellation reason first.`,
           case "delete_issue": {
             if (!e.issueKey || typeof e.issueKey != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "issueKey is required"
               );
             return await this.jiraApi.deleteIssue(e.issueKey), {
@@ -1489,7 +1602,7 @@ Remember to add a comment with cancellation reason first.`,
           case "get_attachment": {
             if (!e.attachmentId || typeof e.attachmentId != "string")
               throw new c(
-                p.InvalidParams,
+                d.InvalidParams,
                 "attachmentId is required"
               );
             const s = await this.jiraApi.getAttachment(e.attachmentId);
@@ -1514,27 +1627,88 @@ Remember to add a comment with cancellation reason first.`,
               ]
             };
           }
+          // ================================================================
+          // TM4J / Zephyr Scale Tool Handlers
+          // ================================================================
+          case "search_test_cases": {
+            if (!e.query || typeof e.query != "string")
+              throw new c(
+                d.InvalidParams,
+                "query is required"
+              );
+            const s = await this.jiraApi.searchTestCases(
+              e.query,
+              typeof e.maxResults == "number" ? e.maxResults : 50
+            );
+            return {
+              content: [
+                { type: "text", text: JSON.stringify(s, null, 2) }
+              ]
+            };
+          }
+          case "get_test_case": {
+            if (!e.testCaseKey || typeof e.testCaseKey != "string")
+              throw new c(
+                d.InvalidParams,
+                "testCaseKey is required"
+              );
+            const s = await this.jiraApi.getTestCase(e.testCaseKey);
+            return {
+              content: [
+                { type: "text", text: JSON.stringify(s, null, 2) }
+              ]
+            };
+          }
+          case "search_test_runs": {
+            if (!e.query || typeof e.query != "string")
+              throw new c(
+                d.InvalidParams,
+                "query is required"
+              );
+            const s = await this.jiraApi.searchTestRuns(
+              e.query,
+              typeof e.maxResults == "number" ? e.maxResults : 50
+            );
+            return {
+              content: [
+                { type: "text", text: JSON.stringify(s, null, 2) }
+              ]
+            };
+          }
+          case "get_test_run": {
+            if (!e.testRunKey || typeof e.testRunKey != "string")
+              throw new c(
+                d.InvalidParams,
+                "testRunKey is required"
+              );
+            const s = await this.jiraApi.getTestRun(e.testRunKey);
+            return {
+              content: [
+                { type: "text", text: JSON.stringify(s, null, 2) }
+              ]
+            };
+          }
           default:
             throw new c(
-              p.MethodNotFound,
+              d.MethodNotFound,
               `Unknown tool: ${t.params.name}`
             );
         }
       } catch (e) {
         throw e instanceof c ? e : new c(
-          p.InternalError,
+          d.InternalError,
           e instanceof Error ? e.message : "Unknown error occurred"
         );
       }
     });
   }
   async run() {
-    const t = new h();
+    const t = new f();
     await this.server.connect(t);
   }
 }
-const T = process.argv[1]?.endsWith("index.js") || process.argv[1]?.endsWith("index.ts") || process.argv[1]?.endsWith("jira-mcp");
-T && new S().run().catch(() => {
+const A = process.argv[1]?.endsWith("index.js") || process.argv[1]?.endsWith("index.ts") || process.argv[1]?.endsWith("jira-mcp");
+A && new S().run().catch(() => {
 });
 export {
   S as JiraServer