Merge pull request #2 from K11-Software-Solutions/copilot/merge-mcp-branch-to-main

Merge MCP branch into main

Author: kavitaj11

.gitignore

@@ -46,4 +46,8 @@ build/
 .vscode/
 
 ### Mac OS ###
-.DS_Store
+.DS_Store
+
+# MCP AI Test logs and reports
+mcp_testlog/
+mcp_testreport/

config/mcp-config.properties

@@ -1,10 +1,29 @@
-# Output directory for generated tests
-output.dir=src/test/ai_generated_tests/k11softwaresolutions
+# Directory for AI prompt templates
+prompt.dir=mcp-prompts/k11softwaresolutions
 # Web URL for AI-generated tests
 weburl=https://k11softwaresolutions-platform.vercel.app/
 username=testuser
 password=testpass
 
+# === MCPTestWorkflow properties (no prefix) ===
+scenario=Login to the dashboard and verify the dashboard is visible
+classNameBase=GeneratedPlaywrightLogin
+ai.packageName=org.k11techlab.framework_unittests.ai_generated.k11softwaresolutions
+# Java package for ConfigurationManager class
+configmanager.package=org.k11techlab.framework.selenium.webuitestengine.configManager
+# Directory for MCP test logs
+log.dir=mcp_testlog
+
+maven.test.dir=src/test/java/org/k11techlab/framework_unittests/ai_generated/k11softwaresolutions
+
+review.prompt=Review the following Java TestNG test class for correctness, best practices, and possible improvements. Provide a concise summary and suggestions.\n\n
+report.src=test-output/emailable-report.html
+# Path to Maven executable for test automation
+maven.cmd.path=C:/Program Files/maven-1.0.2/mvn/bin/mvn.cmd
+# Output directory for generated tests
+output.dir=src/test/java/org/k11techlab/framework_unittests/ai_generated/k11softwaresolutions
+
+
 # Default engine for MCP test generation (selenium or playwright)
 engine=selenium
 # Default package name for generated tests
@@ -18,3 +37,15 @@ mongo.db=mcpdb
 mongo.collection=context
 
 
+
+# === k11softwaresolutions app-specific properties ===
+k11softwaresolutions.weburl=https://k11softwaresolutions-platform.vercel.app/
+# Page object prompt config
+k11softwaresolutions.prompt.pagedir=mcp-prompts/k11softwaresolutions/pages
+k11softwaresolutions.prompt.pages=pageobject_creation_prompt_multi.txt
+# Test generation prompt config
+k11softwaresolutions.prompt.testdir=mcp-prompts/k11softwaresolutions/tests
+k11softwaresolutions.prompt.logintest=logintest_creation_prompt.txt
+
+# Framework standards prompt for test generation
+k11softwaresolutions.prompt.framework=mcp-prompts/framework_standards_prompt.txt

mcp_prompts/framework_standards_prompt.txt

@@ -0,0 +1,17 @@
+# Playwright Framework Standards Prompt
+
+- All Playwright test classes must extend `BasePlaywrightTest`.
+- Use `PlaywrightManager.getInstance()` to obtain the browser, context, and page.
+- Do not use `Playwright.create()` or direct browser/page instantiation in test classes.
+- Use `@BeforeClass` and `@AfterClass` for setup and teardown, delegating to `BasePlaywrightTest` where possible.
+- Example test method:
+
+  @Test
+  public void testExample() {
+      Page page = PlaywrightManager.getInstance().getPage();
+      // test steps...
+  }
+
+- Use the Page Object Model for all page interactions.
+- Follow Java and TestNG best practices for naming and structure.
+- All test code should be readable, maintainable, and DRY.

mcp_prompts/k11softwaresolutions/logintest_prompt.txt

@@ -0,0 +1,17 @@
+Generate a complete, compilable Java TestNG test class using Playwright for Java.
+Package: {packageName}
+Class: {className}
+MUST include:
+- All required imports (Playwright, TestNG, ConfigurationManager, etc).
+- A @BeforeClass setUp() method that launches Playwright, a Chromium browser in headless mode, and creates a Page. Store Playwright, Browser, and Page as fields.
+- A @Test method that:
+  - Reads weburl, username, and password using ConfigurationManager.getBundle().getPropertyValue('weburl'), etc.
+  - Navigates to the weburl.
+  - Fills the username and password fields and clicks the login button (use generic selectors if not specified).
+  - Asserts that the dashboard is visible after login (e.g., page.isVisible('text=Dashboard')).
+- A @AfterClass tearDown() method that closes the browser and Playwright.
+- Output ONLY Java code, no markdown.
+- The code must be complete and not truncated.
+
+Scenario:
+{scenario}

mcp_prompts/k11softwaresolutions/pageobject_creation_prompt.txt

@@ -0,0 +1,18 @@
+# Page Object Creation Prompt Example
+
+You are an AI assistant that generates Playwright Page Object Model (POM) Java classes. Use the following JSON structure as input:
+
+{
+  "className": "HomePage",
+  "fields": {
+    "isDashboardVisible": {"id": "Dashboard", "method": "isVisible"},
+    "clickServiceLink": {"id": "service", "text": "Service", "method": "click"},
+    "clickLoginMenu": {"id": "loginMenu", "text": "Login", "method": "click"},
+    "clickRegisterMenu": {"id": "registerMenu", "text": "Register", "method": "click"}
+  }
+}
+
+- Use id as the first preference, then name, then text for selectors.
+- Each field should generate a method in the Java class.
+- Use Playwright's Page API for actions (fill, click, isVisible, etc).
+- Output only valid Java code for the page object class.

mcp_prompts/k11softwaresolutions/pages/pageobject_creation_prompt_multi.txt

@@ -0,0 +1,28 @@
+# Page Object Creation Prompt for HomePage and LoginPage
+
+{
+  "pageObjects": [
+    {
+      "className": "HomePage",
+      "fields": {
+        "isDashboardVisible": {"id": "Dashboard", "method": "isVisible"},
+        "clickServiceLink": {"id": "service", "text": "Service", "method": "click"},
+        "clickLoginMenu": {"id": "loginMenu", "text": "Login", "method": "click"},
+        "clickRegisterMenu": {"id": "registerMenu", "text": "Register", "method": "click"}
+      }
+    },
+    {
+      "className": "LoginPage",
+      "fields": {
+        "enterUsername": {"id": "username", "name": "username", "text": "Username", "method": "fill"},
+        "enterPassword": {"id": "password", "name": "password", "text": "Password", "method": "fill"},
+        "clickLogin": {"id": "login", "name": "login", "text": "Login", "method": "click"}
+      }
+    }
+  ]
+}
+
+- Use id as the first preference, then name, then text for selectors.
+- Each field should generate a method in the Java class.
+- Use Playwright's Page API for actions (fill, click, isVisible, etc).
+- Output only valid Java code for the page object classes.

mcp_prompts/k11softwaresolutions/tests/logintest_creation_prompt.txt

@@ -0,0 +1,18 @@
+# Login Test Generation Prompt
+
+{
+  "testScenario": "Login to the dashboard and verify the dashboard is visible",
+  "testClassName": "GeneratedPlaywrightLoginTest",
+  "pageObjects": ["HomePage", "LoginPage"],
+  "steps": [
+    "Navigate to the login page",
+    "Enter username and password",
+    "Click the login button",
+    "Verify the dashboard is visible"
+  ]
+}
+
+- Use the provided page objects and methods.
+- Use TestNG for the test class structure.
+- Use Playwright's Page API for browser actions.
+- Output only valid Java code for the test class.

pom.xml

@@ -28,6 +28,9 @@
                 <version>2.20</version>
                 <configuration>
                     <testFailureIgnore>true</testFailureIgnore>
+                    <includes>
+                        <include>org/k11techlab/framework_unittests/webUITests/wikipedia/**</include>
+                    </includes>
                 </configuration>
             </plugin>
             <plugin>
@@ -64,7 +67,6 @@
                                     <groupId>com.microsoft.playwright</groupId>
                                     <artifactId>playwright</artifactId>
                                     <version>1.44.0</version>
-                                    <scope>test</scope>
                                 </dependency>
                         <dependency>
                             <groupId>com.github.javaparser</groupId>

src/main/java/org/k11techlab/framework/ai/mcp/MCPServer.java

@@ -29,6 +29,7 @@ public void start(int port) throws IOException {
         server.createContext("/mcp/correct-code", new CorrectCodeHandler(new OpenAIClient()));
         server.createContext("/mcp/generate-and-run-selenium-test", new GenerateAndRunTestHandler());
         server.createContext("/mcp/generate-and-run-playwright-test", new GenerateAndRunTestHandler());
+        server.createContext("/mcp/generate-page-object", new GeneratePageObjectHandler());
 
         server.setExecutor(null);
         server.start();

src/main/java/org/k11techlab/framework/ai/mcp/handlers/GenerateAndRunTestHandler.java

@@ -33,7 +33,7 @@ public GenerateAndRunTestHandler() {
 
     // Playwright wiring
     this.playwrightGenerator = new PlaywrightTestGenerator(openAI);
-    this.playwrightWorkflow = new PlaywrightWorkflow(playwrightGenerator, openAI, 2);
+    this.playwrightWorkflow = new PlaywrightWorkflow();
    }
 
 
@@ -55,7 +55,7 @@ public void handle(HttpExchange exchange) throws IOException {
 
         String packageName = (configPackage != null && !configPackage.isBlank())
                 ? configPackage.trim()
-                : "org.k11techlab.framework_unittests.ai_generated";
+                : "org.k11techlab.framework_unittests.ai_generated.k11softwaresolutions";
 
         String classBase = "GeneratedTest_" + System.currentTimeMillis();