@uarlouski/testrail-mcp-server 2.6.0 → 2.7.0

package/dist/client/testrail.js

@@ -13,6 +13,7 @@ export class TestRailClient {
     statusesPromise = null;
     projectsPromise = null;
     templatesPromiseMap = new Map();
+    sectionsPromiseMap = new Map();
     constructor(baseUrl, email, apiKey) {
         this.baseUrl = baseUrl.replace(/\/$/, "");
         const auth = Buffer.from(`${email}:${apiKey}`).toString('base64');
@@ -60,7 +61,10 @@ export class TestRailClient {
         return this.paginateAll(url, 'cases');
     }
     async getSection(sectionId) {
-        return this.get(`${API_BASE_V2}/get_section/${sectionId}`);
+        if (!this.sectionsPromiseMap.has(sectionId.toString())) {
+            this.sectionsPromiseMap.set(sectionId.toString(), this.get(`${API_BASE_V2}/get_section/${sectionId}`));
+        }
+        return this.sectionsPromiseMap.get(sectionId.toString());
     }
     async getPriorities() {
         if (!this.prioritiesPromise) {

package/dist/index.js

@@ -27,7 +27,7 @@ if (!parseResult.success) {
 const { TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY, TESTRAIL_ENABLE_SHARED_STEPS, TESTRAIL_ENABLE_CASE_HISTORY, TESTRAIL_ENABLE_RAG_TOOLS, TESTRAIL_ALLOW_WRITE_OPERATIONS, TESTRAIL_ALLOW_READ_OPERATIONS, TESTRAIL_ALLOW_DELETE_OPERATIONS, TESTRAIL_ENABLE_DEPRECATED_TOOLS, TESTRAIL_DISABLED_TOOLS } = parseResult.data;
 const server = new McpServer({
     name: "TestRail MCP Server",
-    version: "2.6.0",
+    version: "2.7.0",
 });
 const client = new TestRailClient(TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY);
 let tools;

package/dist/tools/cases/export_cases_for_rag.js

@@ -1,9 +1,9 @@
 import { z } from "zod";
 import * as fs from "fs";
 import * as path from "path";
-import * as os from "os";
 import { normalizeEntityId, sanitizeValue } from "../../utils/sanitizer.js";
 import { processCustomFields } from "../../utils/mapper.js";
+import { getBaseDirectory } from "../../utils/fs.js";
 import { CaseFieldTypeId, getFieldType } from "./fields.js";
 const parameters = {
     case_ids: z.array(z.union([z.string(), z.number()])).min(1).describe("List of test case IDs (e.g. ['C123', 456])"),
@@ -144,14 +144,15 @@ export const exportCasesForRagTool = {
     description: "Export test cases as formatted Markdown documents with companion JSON metadata sidecar files for Knowledge Base and RAG ingestion.",
     parameters,
     handler: async ({ case_ids, output_dir }, client) => {
-        const baseDir = (process.cwd() && process.cwd() !== "/") ? process.cwd() : (process.env.PWD || os.homedir());
-        const targetDir = output_dir ? path.resolve(output_dir) : path.resolve(baseDir, `rag_export_${Date.now()}`);
+        const baseDir = getBaseDirectory();
+        const targetDir = output_dir
+            ? (path.isAbsolute(output_dir) ? output_dir : path.resolve(baseDir, output_dir))
+            : path.resolve(baseDir, `rag_export_${Date.now()}`);
         await fs.promises.mkdir(targetDir, { recursive: true });
         const [priorities, caseFields] = await Promise.all([
             client.getPriorities().catch(() => []),
             client.getCaseFields().catch(() => []),
         ]);
-        const fieldDefMap = buildFieldDefinitionMap(caseFields);
         const writtenFiles = [];
         for (const rawId of case_ids) {
             const id = normalizeEntityId(rawId);
@@ -164,6 +165,9 @@ export const exportCasesForRagTool = {
                 }
             }
             const priority = priorities.find(p => p.id === testCase.priority_id)?.name || "Unknown";
+            const templateId = testCase.template_id;
+            const applicableFields = caseFields.filter(field => field.include_all || (templateId !== null && templateId !== undefined && field.template_ids.includes(templateId)));
+            const fieldDefMap = buildFieldDefinitionMap(applicableFields);
             const customFields = processCustomFields(testCase, caseFields);
             const { markdownFields, metadataFields } = categorizeCustomFields(customFields, fieldDefMap);
             const markdownContent = buildMarkdownBody(testCase, sectionName, markdownFields);

package/dist/utils/fs.js

@@ -0,0 +1,36 @@
+import * as fs from "fs";
+import * as os from "os";
+/**
+ * Resolves a safe, writable base directory for exports and file operations.
+ *
+ * When the MCP server is spawned by host applications (IDE daemons, npx, Claude Desktop, Cursor, Gemini),
+ * `process.cwd()` or `process.env.PWD` often resolves to the root filesystem (`"/"`), where direct writes
+ * fail with ENOENT / permission errors (especially on macOS read-only APFS volumes).
+ *
+ * This function handles multi-environment fallbacks:
+ * 1. `process.env.INIT_CWD`: Set by package managers (npm/npx/pnpm) to the original caller's working directory.
+ * 2. `process.cwd()` / `process.env.PWD`: Used if pointing to a valid non-root directory.
+ * 3. `os.homedir()`: User home directory fallback if the working directory is root or invalid.
+ * 4. `os.tmpdir()`: Final safety fallback.
+ */
+export function getBaseDirectory() {
+    const candidates = [
+        process.env.INIT_CWD,
+        process.cwd(),
+        process.env.PWD,
+        os.homedir(),
+    ];
+    for (const candidate of candidates) {
+        if (candidate && candidate !== "/" && candidate.trim() !== "") {
+            try {
+                if (fs.existsSync(candidate)) {
+                    return candidate;
+                }
+            }
+            catch {
+                // Ignore and try next candidate
+            }
+        }
+    }
+    return os.tmpdir();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uarlouski/testrail-mcp-server",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "mcpName": "io.github.uarlouski/testrail-mcp-server",
   "description": "Model Context Protocol (MCP) server for TestRail integration, enabling LLMs to fetch test cases and metadata.",
   "main": "dist/index.js",