@nbakka/mcp-appium 2.0.35 → 2.0.37

package/lib/app_context.txt

@@ -1,4 +1,5 @@
-You have to first manually execute the steps till you reach the end goal by intelligently navigating through the app and then generate the code based on the elements you find. Follow these instructions carefully:
+******** START OF GUIDELINES ********
+You are an expert Appium test case generator. You will be given a set of instructions to follow to reach a certain goal in the app. You have to generate Appium code based on the elements you find on the screen while navigating through the app.
 When asked to open buy SRP, use deeplink to open https://housing.com/in/buy/mumbai/<locality name>. For example: if asked to open 'Mira Road East' buy SRP, then open this deeplink: https://housing.com/in/buy/mumbai/mira_road_east
 Homepage deeplink -> https://housing.com/in/buy/real-estate-mumbai
 Only use the locator data from the Google Sheet at the end while generating test cases, don't use to navigate through screens, always get current screen elements and navigate then at end use locator data to generate code, if xpath is already present in sheet then directly add xpath locatorName to code if not then add the required xpath in comments which will then be added to the sheet manually
@@ -7,19 +8,99 @@ Filters on the filter screen may initially be offscreen and require scrolling to
 Stop execution if any step fails.
 IMPORTANT: If the element you looking for is not present you can use swipe
 (Remember this properly - Very important) After the execution is successful/completed, do NOT analyze what you found or did; only generate Appium code.
-Print the Java/Appium code. In our framework, we use the following methods:
 - waitForElementToBeVisible("locator_key", Wait.SHORT); locator_key is locator key and wait can be SHORT, MEDIUM, or LONG.
--  w3CGestures.scrollUp(n);;  // n is the number of times to scroll. Up  and Down in scroll methods are direction of finger movement.
--  w3CGestures.scrollScreen("image_tour_navbar", ScrollDirection.MEDIUM_UP, 2); // image_tour_navbar is locator key, ScrollDirection can be SMALL_UP, MEDIUM_UP, LARGE_UP, SMALL_DOWN, MEDIUM_DOWN, LARGE_DOWN.
+-  w3CGestures.scrollUp(n);  // n is the number of times to scroll. Up  and Down in scroll methods are direction of finger movement.
+-  w3CGestures.scrollScreen("image_tour_navbar", ScrollDirection.MEDIUM_UP, 2); // image_tour_navbar is locator key, ScrollDirection can be SMALL_UP, MEDIUM_UP, LARGE_UP, SMALL_DOWN, MEDIUM_DOWN, LARGE_DOWN and 2 is max number of scrolls to perform, if not found in 2 scrolls then it will throw error. (DO NOT USE other methods except these two for scrolling)
 - navigateBack(); // for back action.
 - deepLink.OpenDeepLink("deeplink_key"); // deeplink_key is deeplink name.
 - getText("locator_key"); // to get text of element.
-Using the above, return code that looks like:
-deepLink.OpenDeepLink(deeplink); // deeplink -> https://housing.com
-waitForElementToBeVisible("view_on_map", Wait.LONG); // view_on_map=//android.widget.TextView[@text="View On Map"]; here xpath should be comments so it can be pasted in xpath sheet.
-When giving output, please remove escape characters before double quotes.
-Do similarly for click and sendKeys methods:
 - click("search_select", Wait.SHORT)
 - sendKeys("locator_key", "string_to_be_passed", Wait.SHORT)
 Figure out dynamic paths like //android.widget.TextView[@text="View 180 Properties"] here 180 is not constant so create a xpath like //android.widget.TextView[contains(@text,"View") and contains(@text,"Properties")]
-For repeating logic, create loops
+For repeating logic, create loops
+Generated code should be pasted in aicode.txt as mentioned below, clear the existing contents of it before copying new code.
+No need to add comments in code and only mention locators that are new and not present in the locator sheet in comments at end of aicode.txt file as shown in sample code below.
+** SAMPLE FILE aicode.txt **
+/**
+ * Test Method for Nearby Properties Verification on New Project Dedicated Page
+ * Verifies that clicking on nearby properties opens the correct detail page
+ */
+
+@Test(priority = 19, dataProvider = "test-data", dataProviderClass = TestDataProvider.class)
+@Description("Test Description: Verify nearby properties functionality on new project dedicated page")
+public void npNearbyPropertiesVerification(HashMap<String, String> testData) {
+    detailPage.npNearbyPropertiesVerification(testData.get("np_dedicated_deeplink"));
+}
+
+/**
+ * Method Definition for DetailPage.java
+ * Add this method to the DetailPage class
+ */
+
+public void npNearbyPropertiesVerification(String deeplink) {
+    deepLink.OpenDeepLink(deeplink);
+    if (waitForElementToBePresent("later_btn", Wait.SHORT)) {
+        click("later_btn");
+    }
+    waitForElementToBeVisible("project_name", Wait.LONG);
+    waitForElementToBeVisible("Overview", Wait.SHORT);
+    w3CGestures.scrollScreen("high_value_project_title", ScrollDirection.MEDIUM_UP, 2);
+    waitForElementToBeVisible("high_value_project_title", Wait.SHORT);
+    String nearbyProjectsTitle = getElement("high_value_project_title").getText();
+    Assert.assertTrue(nearbyProjectsTitle.contains("Premium projects nearby"),
+        "Expected nearby projects section title to contain 'Premium projects nearby' but found: " + nearbyProjectsTitle);
+    w3CGestures.scrollScreen("near_by_project_name1", ScrollDirection.MEDIUM_UP, 2);
+    waitForElementToBeVisible("near_by_project_name1", Wait.SHORT);
+    waitForElementToBeVisible("near_by_project_price1", Wait.SHORT);
+    String expectedPropertyName = getElement("near_by_project_name1").getText();
+    String expectedPropertyPrice = getElement("near_by_project_price1").getText();
+    System.out.println("Expected Property Name: " + expectedPropertyName);
+    System.out.println("Expected Property Price: " + expectedPropertyPrice);
+    click("nearby_high_value_project1");
+    waitForElementToBeVisible("project_name", Wait.LONG);
+    waitForElementToBeVisible("project_price", Wait.SHORT);
+    String actualPropertyName = getElement("project_name").getText();
+    String actualPropertyPrice = getElement("project_price").getText();
+    System.out.println("Actual Property Name: " + actualPropertyName);
+    System.out.println("Actual Property Price: " + actualPropertyPrice);
+    Assert.assertEquals(actualPropertyName, expectedPropertyName,
+        "Property name mismatch. Expected: " + expectedPropertyName + " but found: " + actualPropertyName);
+    Assert.assertEquals(actualPropertyPrice, expectedPropertyPrice,
+        "Property price mismatch. Expected: " + expectedPropertyPrice + " but found: " + actualPropertyPrice);
+    waitForElementToBeVisible("Overview", Wait.SHORT);
+    waitForElementToBeVisible("Highlights", Wait.SHORT);
+    waitForElementToBeVisible("Property Tour", Wait.SHORT);
+    System.out.println("✓ Nearby properties verification completed successfully");
+    System.out.println("✓ Property '" + expectedPropertyName + "' opened correctly with matching price: " + expectedPropertyPrice);
+}
+
+/**
+ * Additional Locators to be added to the locator sheet or properties file:
+ *
+ * # Nearby Projects Section Locators
+ * high_value_project_title=//android.widget.TextView[@text[contains(.,'Premium projects nearby')]]
+ * high_value_project_section=//android.view.View[@content-desc='high_value_project_section']
+ * near_by_project_name1=//android.widget.TextView[@content-desc='near_by_project_name1']
+ * near_by_project_price1=//android.widget.TextView[@content-desc='near_by_project_price1']
+ * near_by_project_name2=//android.widget.TextView[@content-desc='near_by_project_name2']
+ * near_by_project_price2=//android.widget.TextView[@content-desc='near_by_project_price2']
+ * near_by_project_name3=//android.widget.TextView[@content-desc='near_by_project_name3']
+ * near_by_project_price3=//android.widget.TextView[@content-desc='near_by_project_price3']
+ * near_by_project_name4=//android.widget.TextView[@content-desc='near_by_project_name4']
+ * near_by_project_price4=//android.widget.TextView[@content-desc='near_by_project_price4']
+ * nearby_high_value_project1=//android.view.View[@content-desc='nearby_high_value_project1']
+ * nearby_high_value_project2=//android.view.View[@content-desc='nearby_high_value_project2']
+ * nearby_high_value_project3=//android.view.View[@content-desc='nearby_high_value_project3']
+ * nearby_high_value_project4=//android.view.View[@content-desc='nearby_high_value_project4']
+ * project_name=//android.widget.TextView[@content-desc='project_name']
+ * project_price=//android.widget.TextView[@content-desc='project_price']
+ * project_address=//android.widget.TextView[@content-desc='project_address']
+ * project_config=//android.widget.TextView[@content-desc='project_config']
+ * later_btn=//android.widget.TextView[@text='Later']
+ * Overview=//android.widget.TextView[@text='Overview']
+ * Highlights=//android.widget.TextView[@text='Highlights']
+ * Property Tour=//android.widget.TextView[@text='Property Tour']
+ * Data Insights=//android.widget.TextView[@text='Data Insights']
+
+** END OF SAMPLE FILE **
+******** END OF GUIDELINES ********

package/lib/server.js

@@ -200,7 +200,7 @@ const createMcpServer = () => {
            }));
 
          context.locatorData = locatorData;
-
+        }
        return `App context learned: ${JSON.stringify(context)}`;
      } catch (error) {
        return `Error reading app context notes or fetching locator data: ${error.message}`;

package/package.json

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