wopee-mcp 1.4.0 → 1.5.1

package/README.md

@@ -92,122 +92,40 @@ Dispatch a new analysis suite
 
 ### Generation Tools
 
-These tools generate various artifacts for a specific suite. All require a `suiteUuid`.
+These tools generate various artifacts for a specific suite. All require a `suiteUuid` and `fileType` to generate.
 
-#### `wopee_generate_app_context`
+#### `wopee_generate_file`
 
-Generates an application context markdown file for the selected suite. This provides a comprehensive overview of the application being analyzed.
-
-- **Parameters:**
-  - `suiteUuid` - The UUID of the suite to generate context for
-- **Returns:** Generated output in case of successful generation
-
-**Example Usage:**
-
-```
-Generate app context for suite abc-123-def-456
-```
-
-#### `wopee_generate_general_user_stories`
-
-Generates general user stories markdown file for the selected suite.
+Generates a specific file(artifact) for the selected suite.
 
 - **Parameters:**
   - `suiteUuid` - The UUID of the suite
-- **Returns:** Generated output in case of successful generation
-
-**Example Usage:**
-
-```
-Generate general user stories for my latest suite
-```
-
-#### `wopee_generate_user_stories`
-
-Generates detailed user stories JSON file for the selected suite.
-
-- **Parameters:**
-  - `suiteUuid` - The UUID of the suite
-- **Returns:** Generated output in case of successful generation
-
-**Example Usage:**
-
-```
-Generate user stories for suite abc-123-def-456
-```
-
-#### `wopee_generate_test_cases`
-
-Generates test cases for the selected suite based on the analysis and user stories.
-
-- **Parameters:**
-  - `suiteUuid` - The UUID of the suite
-- **Returns:** Generated output in case of successful generation
+  - `fileType` - `"APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES" | "TEST_CASES"`
+- **Returns:** Generated output in case of successful generation.
 
 **Example Usage:**
 
 ```
-Generate test cases for suite abc-123-def-456
+Generate app context for my most recent analysis suite
 ```
 
 ### Fetch Tools
 
-These tools retrieve generated artifacts for a specific suite. All require a `suiteUuid`.
+These tools retrieve generated artifacts for a specific suite. All require a `suiteUuid` and `fileType`.
 
-#### `wopee_fetch_app_context`
+#### `wopee_fetch_file`
 
-Fetches the application context markdown file for a suite.
+Fetches the enquired file(artifact) from the selected suite.
 
 - **Parameters:**
   - `suiteUuid` - The UUID of the suite
-- **Returns:** The application context markdown content
-
-**Example Usage:**
-
-```
-Fetch app context for my latest suite
-```
-
-#### `wopee_fetch_general_user_stories`
-
-Fetches the general user stories markdown file for a suite.
-
-- **Parameters:**
-  - `suiteUuid` - The UUID of the suite
-- **Returns:** The general user stories markdown content
-
-**Example Usage:**
-
-```
-Fetch general user stories for suite abc-123-def-456
-```
-
-#### `wopee_fetch_user_stories`
-
-Fetches the user stories JSON file for a suite.
-
-- **Parameters:**
-  - `suiteUuid` - The UUID of the suite
-- **Returns:** The user stories JSON content
-
-**Example Usage:**
-
-```
-Fetch user stories for suite abc-123-def-456
-```
-
-#### `wopee_fetch_test_cases`
-
-Fetches the test cases JSON file for a suite.
-
-- **Parameters:**
-  - `suiteUuid` - The UUID of the suite
-- **Returns:** The test cases JSON content
+  - `fileType` - `"APP_CONTEXT" | "GENERAL_USER_STORIES" | "USER_STORIES" | "TEST_CASES"`
+- **Returns:** The file contents in case of successful fetch.
 
 **Example Usage:**
 
 ```
-Fetch test cases for suite abc-123-def-456
+Fetch user stories for the latest suite
 ```
 
 ### Update Tools
@@ -259,9 +177,10 @@ Dispatch agent for my latest suite's user story US001 and test case TC003
 
 2. **Generate artifacts:**
 
-   - Generate app context: `wopee_generate_app_context`
-   - Generate user stories: `wopee_generate_user_stories` or `wopee_generate_general_user_stories`
-   - Generate test cases: `wopee_generate_test_cases`
+   - Generate app context: `wopee_generate_file` with `APP_CONTEXT` and specific `suiteUuid`
+   - Generate general user stories: `wopee_generate_file` with `GENERAL_USER_STORIES` and specific `suiteUuid`
+   - Generate user stories: `wopee_generate_file` with `USER_STORIES` and specific `suiteUuid`
+   - Generate test cases: `wopee_generate_file` with `TEST_CASES` and specific `suiteUuid`
 
 3. **Fetch generated content:**
 
@@ -273,5 +192,5 @@ Dispatch agent for my latest suite's user story US001 and test case TC003
 ## Notes
 
 - Most tools require a `suiteUuid`. Always start by fetching or creating a suite.
-- `wopee_dispatch_analysis` tool will go through whole cycle of processing - crawling the application and generating all of the artifacts one by one.
+- `wopee_dispatch_analysis` tool will go through whole cycle of processing - crawling the application and generating all of the files(artifacts) one by one.
 - It is advisable to use [cmd.wopee.io](https://cmd.wopee.io) for a convenient visual representation of the generated data and results of the agent runs.

package/build/tools/index.js

@@ -1,26 +1,14 @@
+import { wopeeFetchFile } from "./wopee_fetch_file/index.js";
 import { wopeeUpdateFile } from "./wopee_update_file/index.js";
+import { wopeeGenerateFile } from "./wopee_generate_file/index.js";
 import { wopeeDispatchAgent } from "./wopee_dispatch_agent/index.js";
-import { wopeeFetchTestCases } from "./wopee_fetch_test_cases/index.js";
-import { wopeeFetchAppContext } from "./wopee_fetch_app_context/index.js";
 import { wopeeDispatchAnalysis } from "./wopee_dispatch_analysis/index.js";
-import { wopeeFetchUserStories } from "./wopee_fetch_user_stories/index.js";
-import { wopeeGenerateTestCases } from "./wopee_generate_test_cases/index.js";
-import { wopeeGenerateAppContext } from "./wopee_generate_app_context/index.js";
 import { wopeeFetchAnalysisSuites } from "./wopee_fetch_analysis_suites/index.js";
-import { wopeeGenerateUserStories } from "./wopee_generate_user_stories/index.js";
-import { wopeeFetchGeneralUserStories } from "./wopee_fetch_general_user_stories/index.js";
-import { wopeeGenerateGeneralUserStories } from "./wopee_generate_general_user_stories/index.js";
 export const TOOLS = [
+    wopeeFetchAnalysisSuites,
     wopeeDispatchAnalysis,
     wopeeDispatchAgent,
-    wopeeGenerateAppContext,
-    wopeeGenerateGeneralUserStories,
-    wopeeGenerateUserStories,
-    wopeeGenerateTestCases,
-    wopeeFetchAnalysisSuites,
-    wopeeFetchAppContext,
-    wopeeFetchGeneralUserStories,
-    wopeeFetchUserStories,
-    wopeeFetchTestCases,
+    wopeeFetchFile,
     wopeeUpdateFile,
+    wopeeGenerateFile,
 ];

package/build/tools/shared/factories.js

@@ -38,6 +38,6 @@ export const createUpdateFileInput = (input) => {
         bucket: input.bucket,
         projectUuid: WOPEE_PROJECT_UUID,
         suiteUuid: input.suiteUuid,
-        [input.type === "markdown" ? "code" : "json"]: input.fileContent,
+        [input.outputType === "markdown" ? "code" : "json"]: input.fileContent,
     };
 };

package/build/tools/shared/handlers.js

@@ -28,7 +28,7 @@ function parseFileType(type) {
                 query: GenerateAppContext,
                 dataKey: "generateAppContext",
                 bucket: Bucket.APP_CONTEXT,
-                type: "markdown",
+                outputType: "markdown",
                 description: "application's context markdown file for selected suite",
             };
         case FileType.GENERAL_USER_STORIES:
@@ -36,7 +36,7 @@ function parseFileType(type) {
                 query: GenerateGeneralUserStories,
                 dataKey: "generateGeneralUserStories",
                 bucket: Bucket.GENERAL_USER_STORIES,
-                type: "markdown",
+                outputType: "markdown",
                 description: "general user stories markdown file for selected suite",
             };
         case FileType.USER_STORIES:
@@ -44,7 +44,7 @@ function parseFileType(type) {
                 query: GenerateUserStories,
                 dataKey: "generateUserStories",
                 bucket: Bucket.USER_STORIES,
-                type: "json",
+                outputType: "json",
                 description: "user stories JSON file for selected suite",
             };
         case FileType.TEST_CASES:
@@ -52,7 +52,7 @@ function parseFileType(type) {
                 query: GenerateTestCases,
                 dataKey: "generateTestCases",
                 bucket: Bucket.USER_STORIES,
-                type: "json",
+                outputType: "json",
                 description: "test cases for selected suite",
             };
         default:
@@ -60,14 +60,27 @@ function parseFileType(type) {
                 query: null,
                 dataKey: null,
                 bucket: null,
-                type: null,
+                outputType: null,
                 description: null,
             };
     }
 }
 export async function fetchFile(input) {
     try {
-        const fetchFileInput = createFetchFileInput(input);
+        const { bucket, description } = parseFileType(input.fileType);
+        if (!bucket || !description)
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Failed to parse file type",
+                    },
+                ],
+            };
+        const fetchFileInput = createFetchFileInput({
+            bucket,
+            suiteUuid: input.suiteUuid,
+        });
         const parsedInput = FetchFileInputSchema.parse(fetchFileInput);
         const result = await requestClient(FetchFile, parsedInput);
         if (!result || !result.fetchFile)
@@ -92,8 +105,8 @@ export async function fetchFile(input) {
         return parseError(error);
     }
 }
-export async function generateAIDataFile(type, input) {
-    const { query, dataKey, bucket, description } = parseFileType(type);
+export async function generateAIDataFile(input) {
+    const { query, dataKey, bucket, description } = parseFileType(input.fileType);
     if (!query || !dataKey || !description || !bucket)
         return {
             content: [
@@ -120,7 +133,7 @@ export async function generateAIDataFile(type, input) {
             };
         return await fetchFile({
             suiteUuid: parsedInput.suiteUuid,
-            bucket,
+            fileType: input.fileType,
         });
     }
     catch (error) {
@@ -129,8 +142,8 @@ export async function generateAIDataFile(type, input) {
 }
 export async function updateFile(input) {
     try {
-        const { bucket, type } = parseFileType(input.fileType);
-        if (!bucket || !type)
+        const { bucket, outputType } = parseFileType(input.fileType);
+        if (!bucket || !outputType)
             return {
                 content: [
                     {
@@ -140,8 +153,8 @@ export async function updateFile(input) {
                 ],
             };
         const updateFileInput = createUpdateFileInput({
-            type,
             bucket,
+            outputType,
             suiteUuid: input.suiteUuid,
             fileContent: input.fileContent,
         });

package/build/tools/shared/schemas.js

@@ -15,8 +15,11 @@ export const SuiteAnalysisConfigSchema = z.object({
     additionalVariables: z.string().nullable().default(null),
 });
 export const GenerateAIDataHandlerInputSchema = z.object({
+    fileType: z.nativeEnum(FileType, {
+        description: "Chosen type of file(artifact) to generate",
+    }),
     suiteUuid: z
-        .string({ description: "UUID of the suite to generate AI data for" })
+        .string({ description: "UUID of the suite to generate file(artifact) for" })
         .min(1, "Suite UUID is required"),
 });
 export const GenerateAIDataInputSchema = z.object({
@@ -29,6 +32,9 @@ export const GenerateAIDataInputSchema = z.object({
     continueGeneration: z.boolean().nullish().default(false),
 });
 export const FetchFileHandlerInputSchema = z.object({
+    fileType: z.nativeEnum(FileType, {
+        description: "Chosen file(artifact) to fetch",
+    }),
     suiteUuid: z
         .string({ description: "UUID of the suite to fetch the file from" })
         .min(1, "Suite UUID is required"),
@@ -44,10 +50,10 @@ export const FetchFileInputSchema = z.object({
 });
 export const UpdateFileHandlerInputSchema = z.object({
     fileType: z.nativeEnum(FileType, {
-        description: "Chosen file/artifact to update",
+        description: "Chosen file(artifact) to update",
     }),
     fileContent: z.string({
-        description: "Content of the file/artifact to update",
+        description: "Content of the file(artifact) to update",
     }),
     suiteUuid: z
         .string({ description: "UUID of the suite to update the file for" })
@@ -57,7 +63,7 @@ export const UpdateFileFactoryInputSchema = z.object({
     bucket: z.nativeEnum(Bucket),
     suiteUuid: z.string().min(1, "Suite UUID is required"),
     fileContent: z.string(),
-    type: z.enum(["markdown", "json"]),
+    outputType: z.enum(["markdown", "json"]),
 });
 export const UpdateFileInputSchema = z.object({
     projectUuid: z.string().min(1, "Project UUID is required"),

package/build/tools/shared/types.js

@@ -1,17 +1,11 @@
 export var ToolName;
 (function (ToolName) {
+    ToolName["WOPEE_FETCH_ANALYSIS_SUITES"] = "wopee_fetch_analysis_suites";
     ToolName["WOPEE_DISPATCH_ANALYSIS"] = "wopee_dispatch_analysis";
     ToolName["WOPEE_DISPATCH_AGENT"] = "wopee_dispatch_agent";
-    ToolName["WOPEE_FETCH_ANALYSIS_SUITES"] = "wopee_fetch_analysis_suites";
-    ToolName["WOPEE_FETCH_APP_CONTEXT"] = "wopee_fetch_app_context";
-    ToolName["WOPEE_FETCH_GENERAL_USER_STORIES"] = "wopee_fetch_general_user_stories";
-    ToolName["WOPEE_FETCH_USER_STORIES"] = "wopee_fetch_user_stories";
-    ToolName["WOPEE_FETCH_TEST_CASES"] = "wopee_fetch_test_cases";
-    ToolName["WOPEE_GENERATE_APP_CONTEXT"] = "wopee_generate_app_context";
-    ToolName["WOPEE_GENERATE_GENERAL_USER_STORIES"] = "wopee_generate_general_user_stories";
-    ToolName["WOPEE_GENERATE_USER_STORIES"] = "wopee_generate_user_stories";
-    ToolName["WOPEE_GENERATE_TEST_CASES"] = "wopee_generate_test_cases";
+    ToolName["WOPEE_FETCH_FILE"] = "wopee_fetch_file";
     ToolName["WOPEE_UPDATE_FILE"] = "wopee_update_file";
+    ToolName["WOPEE_GENERATE_FILE"] = "wopee_generate_file";
 })(ToolName || (ToolName = {}));
 export const Bucket = {
     APP_CONTEXT: "project-suite-app-context",

package/build/tools/wopee_fetch_file/index.js

@@ -0,0 +1,12 @@
+import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
+import { ToolName } from "../shared/types.js";
+import { fetchFile } from "../shared/handlers.js";
+export const wopeeFetchFile = {
+    name: ToolName.WOPEE_FETCH_FILE,
+    config: {
+        title: "Fetch file(artifact)",
+        description: "Fetch suite's file(artifact) for selected project",
+        inputSchema: FetchFileHandlerInputSchema.shape,
+    },
+    handler: async (input) => await fetchFile(input),
+};

package/build/tools/wopee_generate_file/index.js

@@ -0,0 +1,12 @@
+import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
+import { ToolName } from "../shared/types.js";
+import { generateAIDataFile } from "../shared/handlers.js";
+export const wopeeGenerateFile = {
+    name: ToolName.WOPEE_GENERATE_FILE,
+    config: {
+        title: "Generate file(artifact)",
+        description: "Generate AI data file for selected suite",
+        inputSchema: GenerateAIDataHandlerInputSchema.shape,
+    },
+    handler: async (input) => await generateAIDataFile(input),
+};

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "wopee-mcp": "./build/index.js"
   },
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Wopee.io MCP server",
   "main": "./build/index.js",
   "scripts": {

package/build/tools/wopee_fetch_app_context/index.js

@@ -1,15 +0,0 @@
-import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
-import { fetchFile } from "../shared/handlers.js";
-import { Bucket, ToolName } from "../shared/types.js";
-export const wopeeFetchAppContext = {
-    name: ToolName.WOPEE_FETCH_APP_CONTEXT,
-    config: {
-        title: "Fetch app context",
-        description: "Fetch suite's application context markdown file for selected project",
-        inputSchema: FetchFileHandlerInputSchema.shape,
-    },
-    handler: async (input) => await fetchFile({
-        ...input,
-        bucket: Bucket.APP_CONTEXT,
-    }),
-};

package/build/tools/wopee_fetch_general_user_stories/index.js

@@ -1,15 +0,0 @@
-import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
-import { fetchFile } from "../shared/handlers.js";
-import { Bucket, ToolName } from "../shared/types.js";
-export const wopeeFetchGeneralUserStories = {
-    name: ToolName.WOPEE_FETCH_GENERAL_USER_STORIES,
-    config: {
-        title: "Fetch general user stories",
-        description: "Fetch suite's general user stories markdown file for selected project",
-        inputSchema: FetchFileHandlerInputSchema.shape,
-    },
-    handler: async (input) => await fetchFile({
-        ...input,
-        bucket: Bucket.GENERAL_USER_STORIES,
-    }),
-};

package/build/tools/wopee_fetch_test_cases/index.js

@@ -1,15 +0,0 @@
-import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
-import { fetchFile } from "../shared/handlers.js";
-import { Bucket, ToolName } from "../shared/types.js";
-export const wopeeFetchTestCases = {
-    name: ToolName.WOPEE_FETCH_TEST_CASES,
-    config: {
-        title: "Fetch test cases",
-        description: "Fetch suite's test cases JSON file for selected project",
-        inputSchema: FetchFileHandlerInputSchema.shape,
-    },
-    handler: async (input) => await fetchFile({
-        ...input,
-        bucket: Bucket.USER_STORIES,
-    }),
-};

package/build/tools/wopee_fetch_user_stories/index.js

@@ -1,15 +0,0 @@
-import { FetchFileHandlerInputSchema, } from "../shared/schemas.js";
-import { fetchFile } from "../shared/handlers.js";
-import { Bucket, ToolName } from "../shared/types.js";
-export const wopeeFetchUserStories = {
-    name: ToolName.WOPEE_FETCH_USER_STORIES,
-    config: {
-        title: "Fetch user stories",
-        description: "Fetch suite's user stories JSON file for selected project",
-        inputSchema: FetchFileHandlerInputSchema.shape,
-    },
-    handler: async (input) => await fetchFile({
-        ...input,
-        bucket: Bucket.USER_STORIES,
-    }),
-};

package/build/tools/wopee_generate_app_context/index.js

@@ -1,12 +0,0 @@
-import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
-import { FileType, ToolName } from "../shared/types.js";
-import { generateAIDataFile } from "../shared/handlers.js";
-export const wopeeGenerateAppContext = {
-    name: ToolName.WOPEE_GENERATE_APP_CONTEXT,
-    config: {
-        title: "Generate app context",
-        description: "Generate application's context markdown file for selected suite",
-        inputSchema: GenerateAIDataHandlerInputSchema.shape,
-    },
-    handler: async (input) => await generateAIDataFile(FileType.APP_CONTEXT, input),
-};

package/build/tools/wopee_generate_general_user_stories/index.js

@@ -1,12 +0,0 @@
-import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
-import { FileType, ToolName } from "../shared/types.js";
-import { generateAIDataFile } from "../shared/handlers.js";
-export const wopeeGenerateGeneralUserStories = {
-    name: ToolName.WOPEE_GENERATE_GENERAL_USER_STORIES,
-    config: {
-        title: "Generate general user stories",
-        description: "Generate general user stories markdown file for selected suite",
-        inputSchema: GenerateAIDataHandlerInputSchema.shape,
-    },
-    handler: async (input) => await generateAIDataFile(FileType.GENERAL_USER_STORIES, input),
-};

package/build/tools/wopee_generate_test_cases/index.js

@@ -1,12 +0,0 @@
-import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
-import { FileType, ToolName } from "../shared/types.js";
-import { generateAIDataFile } from "../shared/handlers.js";
-export const wopeeGenerateTestCases = {
-    name: ToolName.WOPEE_GENERATE_TEST_CASES,
-    config: {
-        title: "Generate test cases",
-        description: "Generate test cases for selected suite",
-        inputSchema: GenerateAIDataHandlerInputSchema.shape,
-    },
-    handler: async (input) => await generateAIDataFile(FileType.TEST_CASES, input),
-};

package/build/tools/wopee_generate_user_stories/index.js

@@ -1,12 +0,0 @@
-import { GenerateAIDataHandlerInputSchema, } from "../shared/schemas.js";
-import { FileType, ToolName } from "../shared/types.js";
-import { generateAIDataFile } from "../shared/handlers.js";
-export const wopeeGenerateUserStories = {
-    name: ToolName.WOPEE_GENERATE_USER_STORIES,
-    config: {
-        title: "Generate user stories",
-        description: "Generate user stories JSON file for selected suite",
-        inputSchema: GenerateAIDataHandlerInputSchema.shape,
-    },
-    handler: async (input) => await generateAIDataFile(FileType.USER_STORIES, input),
-};