@nbakka/mcp-appium 2.0.54 → 2.0.56

package/lib/server.js

@@ -565,6 +565,25 @@ tool(
       const pdfResponse = await axios.get(pdfUrl, { responseType: "arraybuffer" });
 
       const exportPath = path.join(os.homedir(), "Desktop", "figma");
+
+      // Clear the folder before creating new PDF
+      try {
+        // Check if folder exists
+        await fs.access(exportPath);
+        // If folder exists, remove all contents
+        const files = await fs.readdir(exportPath);
+        await Promise.all(
+          files.map(file => fs.unlink(path.join(exportPath, file)))
+        );
+        console.log("✅ Cleared existing files in figma folder");
+      } catch (err) {
+        // Folder doesn't exist or is empty, no need to clear
+        if (err.code !== 'ENOENT') {
+          console.log("⚠️ Warning: Could not clear folder:", err.message);
+        }
+      }
+
+      // Ensure directory exists
       await fs.mkdir(exportPath, { recursive: true });
 
       const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, -5);
@@ -578,300 +597,64 @@ tool(
   }
 );
 
-
-// ----------------------
-// TOOL: Generate Manual Test Cases from PDF + JIRA
-// ----------------------
 tool(
   "upload_pdf_to_openai",
   "Generate manual test cases by analyzing PDF design with JIRA requirements",
   {
     jiraSummary: zod_1.z.string().describe("Jira issue summary"),
-    jiraDescription: zod_1.z.string().describe("Jira issue description"),
-    pdfPath: zod_1.z.string().describe("Path to PDF file from tool 1")
+    jiraDescription: zod_1.z.string().describe("Jira issue description")
   },
-  async ({ jiraSummary, jiraDescription, pdfPath }) => {
+  async ({ jiraSummary, jiraDescription }) => {
     try {
-      // Load OpenAI API key
+      // Load OpenAI API key from Desktop/openai.json
       const openaiConfigPath = path.join(os.homedir(), "Desktop", "openai.json");
-      const configContent = await fs.readFile(openaiConfigPath, "utf-8");
-      const { apiKey: openaiKey } = JSON.parse(configContent);
+      const configContent = fs.readFileSync(openaiConfigPath, "utf-8");
+      const { apiKey } = JSON.parse(configContent);
 
-      if (!openaiKey) throw new Error("OpenAI API key missing in openai.json");
+      const figmaDir = path.join(os.homedir(), "Desktop", "figma");
+      const files = fs.readdirSync(figmaDir);
+      const pdfFiles = files.filter(file => file.toLowerCase().endsWith('.pdf'));
 
-      const client = new OpenAI({ apiKey: openaiKey });
-
-      // Validate file exists
-      if (!await fs.access(pdfPath).then(() => true).catch(() => false)) {
-        throw new Error(`PDF file not found at path: ${pdfPath}`);
-      }
+      if (pdfFiles.length === 0) throw new Error("No PDF files found in figma folder");
 
-      const stats = await fs.stat(pdfPath);
-      const fileName = path.basename(pdfPath);
+      const latestPdf = pdfFiles.sort((a, b) => b.localeCompare(a))[0];
+      const pdfPath = path.join(figmaDir, latestPdf);
 
-      console.log(`📄 Processing ${fileName} for test case generation...`);
+      const client = new OpenAI({ apiKey });
 
-      // Upload PDF to OpenAI
-      const fileUpload = await client.files.create({
+      const file = await client.files.create({
         file: fs.createReadStream(pdfPath),
-        purpose: "assistants"
+        purpose: "user_data",
       });
 
-      console.log(`✅ PDF uploaded: ${fileUpload.id}`);
-
-      // Create specialized assistant for test case generation
-      const assistant = await client.beta.assistants.create({
-        name: "Manual Test Case Generator",
-        instructions: `You are an expert QA engineer specializing in creating comprehensive manual test cases.
-        You analyze design documents and requirements to generate detailed, actionable test cases that cover:
-        - Functional testing scenarios
-        - UI/UX validation tests
-        - Edge cases and negative scenarios
-        - Cross-browser/device compatibility tests
-        - Accessibility testing scenarios`,
-        model: "gpt-4o", // Best model for complex reasoning
-        tools: [{ type: "file_search" }],
-        tool_resources: {
-          file_search: {
-            vector_stores: [{
-              file_ids: [fileUpload.id]
-            }]
-          }
-        }
-      });
-
-      // Create comprehensive test case generation prompt
-      const testCasePrompt = `
-**JIRA REQUIREMENTS:**
-**Summary:** ${jiraSummary}
-**Description:** ${jiraDescription}
-
-**TASK:** Generate comprehensive manual test cases based on the attached PDF design and above JIRA requirements.
-
-**OUTPUT FORMAT REQUIRED:**
-Please structure your response as follows:
-
-## MANUAL TEST CASES
-
-### 1. FUNCTIONAL TEST CASES
-**TC-F-001: [Test Case Title]**
-- **Objective:** What this test validates
-- **Preconditions:** Setup required before testing
-- **Test Steps:**
-  1. Step 1 action
-  2. Step 2 action
-  3. Step 3 action
-- **Expected Result:** What should happen
-- **Priority:** High/Medium/Low
-
-### 2. UI/UX TEST CASES
-**TC-UI-001: [Test Case Title]**
-[Same format as above]
-
-### 3. EDGE CASE & NEGATIVE TEST CASES
-**TC-E-001: [Test Case Title]**
-[Same format as above]
-
-### 4. COMPATIBILITY TEST CASES
-**TC-C-001: [Test Case Title]**
-[Same format as above]
-
-### 5. ACCESSIBILITY TEST CASES
-**TC-A-001: [Test Case Title]**
-[Same format as above]
-
-**IMPORTANT GUIDELINES:**
-1. Create 15-25 test cases total covering all aspects
-2. Reference specific UI elements from the PDF design
-3. Include both positive and negative test scenarios
-4. Consider different user roles if applicable
-5. Include performance and usability aspects
-6. Make test steps specific and actionable
-7. Consider mobile/responsive design if shown in PDF
-8. Include data validation test cases
-9. Cover error handling scenarios
-10. Include integration testing if multiple components interact
-
-Generate detailed test cases now based on the PDF design and JIRA requirements.
-`;
-
-      // Create thread and run analysis
-      const thread = await client.beta.threads.create({
-        messages: [
-          {
-            role: "user",
-            content: testCasePrompt
-          }
-        ]
+      const completion = await client.chat.completions.create({
+        model: "gpt-4o",
+        messages: [{
+          role: "user",
+          content: [{
+            type: "file",
+            file: { file_id: file.id }
+          }, {
+            type: "text",
+            text: `Generate test cases based on this PDF design and JIRA requirements:
+
+Summary: ${jiraSummary}
+Description: ${jiraDescription}`
+          }]
+        }]
       });
 
-      console.log(`🔄 Generating test cases...`);
-
-      const run = await client.beta.threads.runs.create(thread.id, {
-        assistant_id: assistant.id,
-      });
-
-      // Wait for completion with progress tracking
-      let runStatus = await client.beta.threads.runs.retrieve(thread.id, run.id);
-      let attempts = 0;
-      const maxAttempts = 60; // 60 seconds for complex test case generation
-
-      while (runStatus.status !== 'completed' && attempts < maxAttempts) {
-        if (runStatus.status === 'failed') {
-          throw new Error(`Test case generation failed: ${runStatus.last_error?.message}`);
-        }
-
-        if (attempts % 5 === 0) {
-          console.log(`⏳ Still generating... (${attempts}s elapsed)`);
-        }
-
-        await new Promise(resolve => setTimeout(resolve, 1000));
-        runStatus = await client.beta.threads.runs.retrieve(thread.id, run.id);
-        attempts++;
-      }
-
-      if (runStatus.status !== 'completed') {
-        throw new Error('Test case generation timed out after 60 seconds');
-      }
-
-      // Get the generated test cases
-      const messages = await client.beta.threads.messages.list(thread.id);
-      const testCases = messages.data
-        .filter(msg => msg.role === 'assistant')
-        .map(msg => msg.content[0]?.text?.value)
-        .join('\n\n');
+      const testCases = completion.choices[0].message.content;
 
-      // Parse and structure the response
-      const testCaseCount = (testCases.match(/\*\*TC-/g) || []).length;
-
-      // Clean up assistant
-      try {
-        await client.beta.assistants.del(assistant.id);
-      } catch (cleanupError) {
-        console.warn('⚠️ Assistant cleanup failed:', cleanupError.message);
-      }
-
-      // Save test cases to file for easy reference
-      const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-      const outputFileName = `test_cases_${timestamp.substring(0, 19)}.md`;
-      const outputPath = path.join(path.dirname(pdfPath), outputFileName);
-
-      const fileContent = `# Manual Test Cases
-Generated on: ${new Date().toLocaleString()}
-
-## Source Information
-- **JIRA Summary:** ${jiraSummary}
-- **JIRA Description:** ${jiraDescription}
-- **Design File:** ${fileName}
-- **Total Test Cases:** ${testCaseCount}
-
----
-
-${testCases}
-
----
-
-## Test Execution Notes
-- Execute test cases in the order listed
-- Log defects with screenshots when issues found
-- Update test results in your test management tool
-- Verify on multiple browsers/devices for compatibility tests
-`;
-
-      await fs.writeFile(outputPath, fileContent, 'utf-8');
-
-      console.log(`✅ Test cases generated and saved!`);
-
-      return {
-        success: true,
-        message: `✅ Successfully generated ${testCaseCount} manual test cases!`,
-        results: {
-          testCases: testCases,
-          summary: {
-            totalTestCases: testCaseCount,
-            categories: [
-              "Functional Test Cases",
-              "UI/UX Test Cases",
-              "Edge Case & Negative Test Cases",
-              "Compatibility Test Cases",
-              "Accessibility Test Cases"
-            ],
-            generatedFrom: {
-              jiraSummary: jiraSummary,
-              designFile: fileName,
-              fileSize: `${(stats.size / 1024).toFixed(2)} KB`
-            }
-          },
-          outputs: {
-            savedToFile: outputPath,
-            fileName: outputFileName,
-            generatedAt: new Date().toISOString()
-          },
-          execution: {
-            processingTime: `${attempts} seconds`,
-            model: "gpt-4o",
-            pdfAnalyzed: true
-          }
-        }
-      };
+      await client.files.del(file.id);
 
+      return testCases;
     } catch (err) {
-      console.error("❌ Test Case Generation Error:", err);
-
-      let errorMessage = "❌ Failed to generate test cases: ";
-
-      if (err.message?.includes('quota')) {
-        errorMessage += "OpenAI quota exceeded. Check billing.";
-      } else if (err.message?.includes('timeout')) {
-        errorMessage += "Generation took too long. Try with smaller PDF.";
-      } else if (err.message?.includes('file')) {
-        errorMessage += "PDF processing error. Check file format.";
-      } else if (err.message?.includes('API key')) {
-        errorMessage += "Invalid OpenAI API key.";
-      } else {
-        errorMessage += err.message || "Unknown error occurred.";
-      }
-
-      return {
-        success: false,
-        message: errorMessage,
-        error: {
-          message: err.message,
-          timestamp: new Date().toISOString(),
-          attempted: {
-            jiraSummary: jiraSummary,
-            pdfPath: pdfPath
-          }
-        },
-        troubleshooting: [
-          "Verify OpenAI API key in ~/Desktop/openai.json",
-          "Check PDF file exists and is readable",
-          "Ensure sufficient OpenAI credits",
-          "Try with smaller PDF if timeout occurs"
-        ]
-      };
+      return `Error: ${err.message}`;
     }
   }
 );
 
-// ----------------------
-// USAGE EXAMPLE
-// ----------------------
-
-/*
-const result = await tools.uploadPdfToOpenai({
-  jiraSummary: "User Login Page Implementation",
-  jiraDescription: "Create a responsive login page with email/password fields, remember me checkbox, forgot password link, and social login options. Must support mobile and desktop views.",
-  pdfPath: "/path/to/login-design.pdf"
-});
-
-// Expected Output:
-// - 15-25 detailed manual test cases
-// - Categories: Functional, UI/UX, Edge Cases, Compatibility, Accessibility
-// - Saved to markdown file for easy reference
-// - Structured format ready for test management tools
-*/
-
     return server;
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbakka/mcp-appium",
-  "version": "2.0.54",
+  "version": "2.0.56",
   "description": "Appium MCP",
   "engines": {
     "node": ">=18"