wopee-mcp 1.21.0 → 1.23.0

package/README.md

@@ -298,7 +298,7 @@ Dispatches an autonomous testing agent to execute test cases for a selected suit
   - `testCases` - Array of test case objects to execute, each containing:
     - `testCaseId` - The ID of the test case
     - `userStoryId` - The ID of the associated user story
-- **Returns:** Success message indicating the agent has been dispatched
+- **Returns:** Array of executed test case objects with their initial execution state (uuid, executionStatus, agentReportStatus, codeReportStatus, etc.)
 
 **Example Usage:**
 
@@ -306,6 +306,27 @@ Dispatches an autonomous testing agent to execute test cases for a selected suit
 Dispatch agent for my latest suite's user story US001 and test case TC003
 ```
 
+### Test Results
+
+#### `wopee_fetch_executed_test_cases`
+
+Fetches executed test cases and their results for a given analysis suite. Use this to check the status and reports of dispatched agent runs.
+
+- **Parameters:**
+  - `suiteUuid` - The UUID of the analysis suite to fetch results for
+  - `analysisIdentifier` _(optional)_ - Analysis identifier to narrow results (e.g. `A068`)
+- **Returns:** Array of results grouped by user story, each containing executed test cases with execution status, agent report, agent report status, code report, and code report status
+
+**Example Usage:**
+
+```
+Fetch test results for suite <suiteUuid>
+```
+
+```
+Show me the executed test cases for my latest analysis suite
+```
+
 ## Typical Workflow
 
 1. **Start with a suite:**
@@ -326,6 +347,20 @@ Dispatch agent for my latest suite's user story US001 and test case TC003
 4. **Run tests:**
    - Use `wopee_dispatch_agent` to execute test cases with the autonomous testing agent
 
+5. **Check results:**
+   - Use `wopee_fetch_executed_test_cases` to check the status and reports of dispatched agent runs
+   - Or use the `fetch-test-results` prompt for a formatted summary of all test results
+
+## Available Prompts
+
+### `fetch-project-summary`
+
+Fetches analysis suites and their user stories/test cases, then displays a formatted summary with two markdown tables: a suite overview and a detailed test case breakdown.
+
+### `fetch-test-results`
+
+Fetches analysis suites and their executed test case results, then displays formatted markdown tables showing execution status, agent report status, and code report status for each test case. Also surfaces failed report details.
+
 ## Notes
 
 - Most tools require a `suiteUuid`. Always start by fetching or creating a suite.

package/build/prompts/fetch_test_results/index.js

@@ -0,0 +1,65 @@
+import { PromptName } from "../shared/types.js";
+export const fetchTestResults = {
+    name: PromptName.FETCH_TEST_RESULTS,
+    config: {
+        title: "Fetch test results",
+        description: "Fetch and display test execution results for analysis suites",
+    },
+    handler: () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Please, fetch my analysis suites using 'wopee_fetch_analysis_suites' tool. If there are more than 5 suites, ask the user to select which suite(s) they want to see results for.
+
+          Then, for each selected suite, fetch the executed test cases using 'wopee_fetch_executed_test_cases' tool with the suite's uuid and analysisIdentifier.
+
+          After fetching all of the necessary data, summarize and display readable markdown tables as an output in the same chat conversation. Do NOT create, write, or save any files to disk - only display the formatted tables in your response.
+
+          Display the following tables:
+
+          1. **Suite Overview Table** - one row per suite showing:
+            - Suite name
+            - Analysis identifier
+            - Execution status
+            - Suite running status
+
+          ### Example:
+          | Suite Name | Identifier | Execution Status | Running Status |
+          |------------|------------|------------------|----------------|
+          | Analysis - A068 | A068 | FINISHED | IDLE |
+          | Analysis - A067 | A067 | IN_PROGRESS | IN_PROGRESS |
+
+          ___
+
+          2. **Test Case Results Table** - for each suite that has executed test cases:
+            - Suite name
+            - User story ID
+            - Test case ID
+            - Execution status
+            - Agent report status (PASSED/FAILED or N/A)
+            - Code report status (PASSED/FAILED or N/A)
+
+          ### Example:
+          | Suite Name | User Story | Test Case | Execution | Agent Status | Code Status |
+          |------------|------------|-----------|-----------|--------------|-------------|
+          | Analysis - A068 | US001 | TC001 | FINISHED | PASSED | PASSED |
+          | | US001 | TC002 | FINISHED | PASSED | FAILED |
+          | | US002 | TC001 | FINISHED | FAILED | N/A |
+          | Analysis - A067 | US001 | TC001 | IN_PROGRESS | N/A | N/A |
+
+          ___
+
+          3. If any test case has a FAILED agent or code report status, display the report content below the tables under a "Failed Reports" section, showing the suite name, test case ID, and the report text.
+
+          ## Important Notes:
+            - If a test case's executionStatus is IN_PROGRESS, note that results are not yet available.
+            - Use "N/A" for report statuses that are null (not yet available).
+            - Group test cases by user story within each suite.
+          `,
+                },
+            },
+        ],
+    }),
+};

package/build/prompts/index.js

@@ -1,2 +1,3 @@
 import { fetchProjectSummary } from "./fetch_project_summary/index.js";
-export const PROMPTS = [fetchProjectSummary];
+import { fetchTestResults } from "./fetch_test_results/index.js";
+export const PROMPTS = [fetchProjectSummary, fetchTestResults];

package/build/prompts/shared/types.js

@@ -1,4 +1,5 @@
 export var PromptName;
 (function (PromptName) {
     PromptName["FETCH_PROJECT_SUMMARY"] = "fetch-project-summary";
+    PromptName["FETCH_TEST_RESULTS"] = "fetch-test-results";
 })(PromptName || (PromptName = {}));

package/build/tools/index.js

@@ -5,9 +5,11 @@ import { wopeeDispatchAgent } from "./wopee_dispatch_agent/index.js";
 import { wopeeDispatchAnalysis } from "./wopee_dispatch_analysis/index.js";
 import { wopeeCreateBlankSuite } from "./wopee_create_blank_suite/index.js";
 import { wopeeFetchAnalysisSuites } from "./wopee_fetch_analysis_suites/index.js";
+import { wopeeFetchExecutedTestCases } from "./wopee_fetch_executed_test_cases/index.js";
 export const TOOLS = [
     wopeeCreateBlankSuite,
     wopeeFetchAnalysisSuites,
+    wopeeFetchExecutedTestCases,
     wopeeDispatchAnalysis,
     wopeeDispatchAgent,
     wopeeFetchArtifact,

package/build/tools/shared/gql-queries.js

@@ -155,6 +155,28 @@ export const GenerateReusableTestCaseSteps = `
     generateReusableTestCaseSteps(input: $input)
   }
 `;
+export const FetchExecutedTestCases = `
+  query FetchExecutedTestCases($input: FetchExecutedTestCasesInput!) {
+    fetchExecutedTestCases(input: $input) {
+      userStoryId
+      executedTestCases {
+        uuid
+        suiteUuid
+        analysisSuiteUuid
+        analysisIdentifier
+        userStoryId
+        testCaseId
+        executionStatus
+        agentReport
+        agentReportStatus
+        codeReport
+        codeReportStatus
+        createdAt
+        updatedAt
+      }
+    }
+  }
+`;
 export const CreateBlankAnalysisSuite = `
   mutation CreateBlankAnalysisSuite($projectUuid: ID!) {
     createBlankAnalysisSuite(projectUuid: $projectUuid) {

package/build/tools/shared/types.js

@@ -2,6 +2,7 @@ export var ToolName;
 (function (ToolName) {
     ToolName["WOPEE_CREATE_BLANK_SUITE"] = "wopee_create_blank_suite";
     ToolName["WOPEE_FETCH_ANALYSIS_SUITES"] = "wopee_fetch_analysis_suites";
+    ToolName["WOPEE_FETCH_EXECUTED_TEST_CASES"] = "wopee_fetch_executed_test_cases";
     ToolName["WOPEE_DISPATCH_ANALYSIS"] = "wopee_dispatch_analysis";
     ToolName["WOPEE_DISPATCH_AGENT"] = "wopee_dispatch_agent";
     ToolName["WOPEE_FETCH_ARTIFACT"] = "wopee_fetch_artifact";
@@ -56,3 +57,8 @@ export var GenerationStatus;
     GenerationStatus["FINISHED"] = "FINISHED";
     GenerationStatus["FAILED"] = "FAILED";
 })(GenerationStatus || (GenerationStatus = {}));
+export var ReportStatus;
+(function (ReportStatus) {
+    ReportStatus["PASSED"] = "PASSED";
+    ReportStatus["FAILED"] = "FAILED";
+})(ReportStatus || (ReportStatus = {}));

package/build/tools/wopee_dispatch_agent/index.js

@@ -32,7 +32,7 @@ export const wopeeDispatchAgent = {
                 content: [
                     {
                         type: "text",
-                        text: "Agent dispatched successfully",
+                        text: JSON.stringify(result.dispatchAgent, null, 2),
                     },
                 ],
             };

package/build/tools/wopee_fetch_executed_test_cases/factory.js

@@ -0,0 +1,13 @@
+import { getConfig } from "../../utils/getConfig.js";
+export const createFetchExecutedTestCasesInput = (input) => {
+    const { WOPEE_PROJECT_UUID } = getConfig();
+    if (!WOPEE_PROJECT_UUID)
+        throw new Error("WOPEE_PROJECT_UUID is not set");
+    return {
+        projectUuid: WOPEE_PROJECT_UUID,
+        analysisSuiteUuid: input.suiteUuid,
+        ...(input.analysisIdentifier
+            ? { analysisIdentifier: input.analysisIdentifier }
+            : {}),
+    };
+};

package/build/tools/wopee_fetch_executed_test_cases/index.js

@@ -0,0 +1,43 @@
+import { WopeeFetchExecutedTestCasesInputSchema, FetchExecutedTestCasesInputSchema, } from "./schema.js";
+import { ToolName } from "../shared/types.js";
+import { _parseError } from "../shared/helpers.js";
+import { createFetchExecutedTestCasesInput } from "./factory.js";
+import { FetchExecutedTestCases } from "../shared/gql-queries.js";
+import { requestClient } from "../../utils/requestClient.js";
+export const wopeeFetchExecutedTestCases = {
+    name: ToolName.WOPEE_FETCH_EXECUTED_TEST_CASES,
+    config: {
+        title: "Fetch executed test cases",
+        description: "Fetch executed test cases and their results (agent report, code report, execution status) for a given analysis suite.",
+        inputSchema: WopeeFetchExecutedTestCasesInputSchema.shape,
+    },
+    handler: async (input) => {
+        try {
+            const factoryInput = createFetchExecutedTestCasesInput(input);
+            const parsedInput = FetchExecutedTestCasesInputSchema.parse(factoryInput);
+            const result = await requestClient(FetchExecutedTestCases, {
+                input: parsedInput,
+            });
+            if (!result?.fetchExecutedTestCases)
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Failed to fetch executed test cases: no data returned",
+                        },
+                    ],
+                };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result.fetchExecutedTestCases, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return _parseError(error);
+        }
+    },
+};

package/build/tools/wopee_fetch_executed_test_cases/schema.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export const WopeeFetchExecutedTestCasesInputSchema = z.object({
+    suiteUuid: z
+        .string({
+        description: "UUID of the analysis suite to fetch executed test cases for",
+    })
+        .min(1, "Suite UUID is required"),
+    analysisIdentifier: z
+        .string({
+        description: "Analysis identifier of the suite (ex. A068). Can be found in the analysis suite data.",
+    })
+        .optional(),
+});
+export const FetchExecutedTestCasesInputSchema = z.object({
+    projectUuid: z.string().min(1, "Project UUID is required"),
+    analysisSuiteUuid: z.string().min(1, "Suite UUID is required"),
+    analysisIdentifier: z.string().optional(),
+});

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "wopee-mcp": "./build/index.js"
   },
-  "version": "1.21.0",
+  "version": "1.23.0",
   "mcpName": "io.github.Wopee-io/wopee-mcp",
   "description": "Wopee.io MCP server for autonomous testing platform",
   "main": "./build/index.js",