Update locator-healer.md

Author: Tahanima

.gemini/skills/healing-agent/locator-healer.md

@@ -1,23 +1,18 @@
-# Playwright Locator Healing Logic
+# Playwright Locator Healing Logic (with MCP)
 
-## 1. Diagnose the Brittle Locator
-Identify if the current locator uses any of these "Anti-Patterns":
-- Long XPath strings (e.g., `/html/body/div[1]/...`)
-- CSS classes that look autogenerated (e.g., `.css-19v7kv`)
-- Locators relying on specific DOM nesting that is likely to change.
+## 1. Diagnose via MCP
+When using the `@playwright` tool:
+- Use `playwright_click` with a generic selector to see if the element responds.
+- Use the tool's output to find **Aria Roles** and **Labels** that aren't visible in the raw source code.
 
-## 2. Healing Strategy (Priority Order)
-Refactor the broken locator using the following Playwright priority list:
-1.  **Role (Preferred):** `page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Login"))`
-2.  **Label:** `page.getByLabel("Username")`
-3.  **Placeholder:** `page.getByPlaceholder("Enter password")`
-4.  **Text:** `page.getByText("Welcome back")`
-5.  **Alt Text:** `page.getByAltText("Company Logo")`
-6.  **TestID:** `page.getByTestId("submit-button")` (If `data-testid` is present in your HTML).
+## 2. Healing Strategy (Java SDK mapping)
+Refactor using the live data from MCP into these Java patterns:
 
-## 3. Example Transformation
-**Broken:**
-`private Locator loginBtn = page.locator("//div[@id='login-form']//button[2]");`
+| MCP Finding | Java SDK Implementation |
+| :--- | :--- |
+| Button with name "Submit" | `page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Submit"))` |
+| Input with label "Email" | `page.getByLabel("Email")` |
+| Image with alt "Logo" | `page.getByAltText("Logo")` |
 
-**Healed:**
-`private Locator loginBtn = page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Login"));`
+## 3. The "Double-Check" Rule
+Before finalizing the response, the agent should mentally (or via MCP) verify that the proposed locator is unique on the page to avoid "strict mode" violations in Playwright Java.