tamash-playwright 0.6.0 → 0.6.1

package/README.md

@@ -1,207 +1,207 @@
-# tamash-playwright
-
-`tamash-playwright` is a plug and play self-healing solution for any Playwright test framework. All you need to do is install the package, update your AI API key details, and import `test` from `tamash-playwright`.
-
-That's it. No code changes required if you're following standard Playwright best practices.
-
-### Why you need this
-
-Websites change often. A button gets renamed or moved, and your test can't find it anymore — even though the app still works fine for real users. Normally, that just means a broken test.
-
-`tamash-playwright` fixes this automatically. When a test can't find an element, it asks an AI model to find it on the current page and tries again. If it succeeds, your test keeps going. If not, it fails normally, just like before.
-
-**Want to see it working before you set it up yourself?** Clone the sample repo — [github.com/qtpsudhakarproducts/tamash-playwright-typescript-playwright](https://github.com/qtpsudhakarproducts/tamash-playwright-typescript-playwright) — a full worked example with both a plain-locator test and a Page Object Model test, an intentionally broken selector, and step-by-step setup instructions.
-
-Here are the detailed steps to use this package.
-
-## Step 1: Install it
-
-```sh
-npm install tamash-playwright
-```
-
-You also need Playwright's own test package, if you don't already have it:
-
-```sh
-npm install -D @playwright/test
-```
-
-## Step 2: Connect an AI model
-
-`tamash-playwright` needs an AI model to decide where a broken element actually went. Pick one of Ollama, OpenAI, Anthropic (Claude), or Google Gemini, and give it an API key.
-
-Create a file named `.env` in your project folder:
-
-```sh
-# Master on/off switch. Leave this as true, or remove the line entirely.
-HEALER_ENABLED=true
-
-# Pick one: ollama | openai | anthropic | gemini
-HEALER_PROVIDER=ollama
-
-# Optional, off by default — see "Action recovery" below.
-# HEALER_ACTION_RECOVERY_ENABLED=true
-
-# --- Ollama Cloud (https://ollama.com) ---
-OLLAMA_MODEL=gpt-oss:120b
-OLLAMA_API_KEY=
-
-# --- OpenAI ---
-# OPENAI_MODEL=gpt-4.1-mini
-# OPENAI_API_KEY=
-
-# --- Anthropic (Claude) ---
-# ANTHROPIC_MODEL=claude-haiku-4-5
-# ANTHROPIC_API_KEY=
-
-# --- Google Gemini ---
-# GEMINI_MODEL=
-# GEMINI_API_KEY=
-```
-
-Just fill in the API key and model for whichever one you want to use, and leave the rest as-is (or delete them).
-
-### Getting a free Ollama key (fastest way to get started)
-
-Ollama Cloud is a quick, free way to get an API key without signing up for OpenAI/Anthropic/Gemini billing.
-
-1. Go to [ollama.com](https://ollama.com/) and create an account.
-2. Once signed in, go to [ollama.com/settings/keys](https://ollama.com/settings/keys).
-3. Create a new API key and copy it.
-4. Paste it into your `.env` file:
-
-```sh
-HEALER_ENABLED=true
-HEALER_PROVIDER=ollama
-OLLAMA_MODEL=gpt-oss:120b
-OLLAMA_API_KEY=paste_your_key_here
-```
-
-That's all you need — no other variables required.
-
-### Important: set `actionTimeout` in your `playwright.config.ts`
-
-By default, Playwright lets a broken locator retry silently for your *entire* test timeout before it ever throws an error — which means self-healing never gets a turn at all, since it only kicks in once an action actually fails. Set `actionTimeout` to something well below your test timeout so a broken locator fails fast, leaving real time for healing to run:
-
-```ts
-export default defineConfig({
-  timeout: 60000, // your overall test timeout
-  use: {
-    actionTimeout: 8000, // must be comfortably less than the test timeout above
-  },
-});
-```
-
-Without this, healing attempts will show `stage=no_snapshot` in the console and never recover anything — not because healing failed, but because it never had time to run before the whole test was torn down.
-
-## Step 3: Check your setup
-
-Run the built-in doctor command to confirm everything's wired up correctly before you rely on it:
-
-```sh
-npx tamash-playwright doctor
-```
-
-It checks:
-
-1. **AI connectivity** — confirms `HEALER_ENABLED`/`HEALER_PROVIDER` are set correctly and actually calls your configured provider to make sure the API key and model work.
-2. **`actionTimeout` configuration** — checks your `playwright.config.ts` for an `actionTimeout` set well below your test `timeout` (see above); flags it if missing or too close to the test timeout, since that silently starves self-healing of any time to run.
-3. **Action recovery status** — whether `HEALER_ACTION_RECOVERY_ENABLED` is on (see below).
-4. **Vision capability** — whether your configured model is expected to support the screenshot-based fallback (see below), based on its name.
-5. **Missing `.describe()` labels** — scans your test files (`tests/` by default, or pass `--dir <path>`) for locators that don't have a `.describe('...')` label, and flags the ones most worth fixing (raw CSS/XPath selectors first).
-6. **Locators written directly in test files** — flags any locator defined inline in a test rather than inside a Page Object class, which is a Playwright best practice regardless of self-healing: it keeps tests readable and means a UI change only needs a fix in one place.
-
-If it finds issues, the fastest fix is to open the project in an AI coding assistant (Claude Code, Cursor, GitHub Copilot, etc.) and ask it to address what it flagged — add `.describe()` calls, or extract locators into Page Object classes. You can also add a standing rule to that assistant's instructions/skill file (e.g. `CLAUDE.md`, `.cursor/rules`, `.github/copilot-instructions.md`) so it follows both practices automatically on any new test code going forward.
-
-## Step 4: Use it in your tests
-
-Change one line at the top of your test file — everything else about how you write tests stays exactly the same:
-
-```ts
-// Before
-import { test, expect } from '@playwright/test';
-
-// After
-import { test, expect } from 'tamash-playwright';
-```
-
-That's it. Write your tests as normal:
-
-```ts
-import { test, expect } from 'tamash-playwright';
-
-test('logs in', async ({ page }) => {
-  await page.goto('/');
-  const txtUserName = page.locator('input[name="username"]').describe('User Name Textbox');
-  await txtUserName.fill('testadmin');
-
-  const txtPassword = page.locator('input[placeholder="Password"]').describe('Password Textbox');
-  await txtPassword.fill('secret');
-
-  const btnLogin = page.locator('button[type="submit"]').describe('Login Button');
-  await btnLogin.click();
-
-  await expect(page.getByRole('heading', { name: 'Dashboard' })).toBeVisible();
-});
-```
-
-### A quick tip for better results
-
-If you're using plain CSS selectors (like `page.locator('input[name="username"]')`) rather than Playwright's more descriptive locators (`getByRole`, `getByPlaceholder`, etc.), it helps to add a short, human-readable label so the healer knows what it's actually looking for. Chain `.describe('...')` right onto the locator:
-
-```ts
-test('login test using CSS Selectors', async ({ page }) => {
-  await page.goto('https://example.com/auth/login');
-
-  const txtUserName = page.locator('input[name="username"]').describe('User Name Textbox');
-  await txtUserName.fill('testadmin');
-
-  const txtPassword = page.locator('input[placeholder="Password"]').describe('Password Textbox');
-  await txtPassword.fill('secret');
-
-  const btnLogin = page.locator('button[type="submit"]').describe('Login Button');
-  await btnLogin.click();
-
-  await expect(page.locator('h6')).toHaveText('Dashboard');
-});
-```
-
-This step is optional, but recommended — without it, the healer has to guess purely from a broken CSS selector, which gives it a lot less to work with.
-
-## What else it heals — no extra setup needed
-
-Beyond a single broken `click`/`fill`/`getByRole` on the main page, all of this works automatically once you've done Steps 1–2:
-
-- **Popups and extra tabs.** A page opened via `context.newPage()`, `window.open`, or a `target="_blank"` link is just as healing-aware as your main `page` — no manual wrapping needed.
-- **Elements inside `<iframe>`s.** `page.frameLocator('#my-iframe')` and anything chained off it heals the same way, scoped correctly to the iframe's own document.
-- **Most of the Playwright API surface**, not just clicks and fills — `check`, `selectOption`, `dragTo`, `dispatchEvent`, read methods like `textContent`/`getAttribute`/`isChecked`, `screenshot`, and more. Methods that can't be safely healed by guessing a replacement element (`dragTo`, `drop`) are still reported honestly on failure, they're just never silently retried with a different element.
-
-## When text alone isn't enough: vision fallback
-
-Sometimes an element has nothing useful to match on by text — an icon-only button with no label, or several visually distinct elements that all look identical in the accessibility tree. If your configured model supports image input (e.g. `gpt-4o`, `claude-haiku-4-5`, `gemini-2.0-flash`), `tamash-playwright` automatically falls back to a screenshot-based search after the normal text-based attempt fails — no separate setup, it just uses the same provider and API key from Step 2. Run `npx tamash-playwright doctor` to check whether your configured model is expected to support this.
-
-## Action recovery (optional)
-
-Occasionally a locator heals correctly — the AI found the right element — but the *action* on it still fails, e.g. it's covered by an overlay or needs scrolling into view first. Set `HEALER_ACTION_RECOVERY_ENABLED=true` to let the AI pick a recovery tactic from a fixed, safe set (scroll into view, retry bypassing actionability checks, wait briefly and retry, or dispatch the DOM event directly) before giving up. It's off by default since it's a second, more speculative layer of intervention beyond selector healing — the AI only ever picks from that fixed menu, it never decides how to interact with the page on its own.
-
-## Checking what actually happened
-
-Every healing attempt — whether it succeeded or not — shows up in Playwright's own HTML report (`npx playwright show-report`), no separate report to check:
-
-- An annotation on the test summarizing what happened, e.g. `Recovered using ollama:gpt-oss:120b (role:button:Submit)`.
-- A JSON attachment with the full detail: which provider was used, whether the vision or action-recovery fallback was involved, the AI's suggested selector, token cost, and — if it didn't heal — which stage it stopped at (e.g. `ai_declined`, `replay_failed`).
-- Exactly where in your own code the locator was created — a test file or a Page Object class, whichever it really is — so you know which line to go fix even if you never look at the healing report again.
-
-The same detail is also printed to the console as it happens, one line per attempt:
-
-```
-[self-healer] src/pages/loginpage.ts:11 — locator.fill "Username Textbox" -> HEALED [provider=ollama:gpt-oss:120b, vision=no, actionRecovery=no, suggested="role:textbox:Username", 620 tokens (489 input + 131 output)] — locator.fill: Timeout 8000ms exceeded.
-```
-
-## License
-
-Free to use, including commercially. The source code may not be copied, modified, redistributed, or resold without prior written permission. See the LICENSE file included in this package for the full terms.
-
-## Support
-
-For questions or concerns, contact us at support@vibetestq.com.
+# tamash-playwright
+
+`tamash-playwright` is a plug and play self-healing solution for any Playwright test framework. All you need to do is install the package, update your AI API key details, and import `test` from `tamash-playwright`.
+
+That's it. No code changes required if you're following standard Playwright best practices.
+
+### Why you need this
+
+Websites change often. A button gets renamed or moved, and your test can't find it anymore — even though the app still works fine for real users. Normally, that just means a broken test.
+
+`tamash-playwright` fixes this automatically. When a test can't find an element, it asks an AI model to find it on the current page and tries again. If it succeeds, your test keeps going. If not, it fails normally, just like before.
+
+**Want to see it working before you set it up yourself?** Clone the sample repo — [github.com/qtpsudhakarproducts/tamash-playwright-typescript-playwright](https://github.com/qtpsudhakarproducts/tamash-playwright-typescript-playwright) — a full worked example with both a plain-locator test and a Page Object Model test, an intentionally broken selector, and step-by-step setup instructions.
+
+Here are the detailed steps to use this package.
+
+## Step 1: Install it
+
+```sh
+npm install tamash-playwright
+```
+
+You also need Playwright's own test package, if you don't already have it:
+
+```sh
+npm install -D @playwright/test
+```
+
+## Step 2: Connect an AI model
+
+`tamash-playwright` needs an AI model to decide where a broken element actually went. Pick one of Ollama, OpenAI, Anthropic (Claude), or Google Gemini, and give it an API key.
+
+Create a file named `.env` in your project folder:
+
+```sh
+# Master on/off switch. Leave this as true, or remove the line entirely.
+HEALER_ENABLED=true
+
+# Pick one: ollama | openai | anthropic | gemini
+HEALER_PROVIDER=ollama
+
+# Optional, off by default — see "Action recovery" below.
+# HEALER_ACTION_RECOVERY_ENABLED=true
+
+# --- Ollama Cloud (https://ollama.com) ---
+OLLAMA_MODEL=gpt-oss:120b
+OLLAMA_API_KEY=
+
+# --- OpenAI ---
+# OPENAI_MODEL=gpt-4.1-mini
+# OPENAI_API_KEY=
+
+# --- Anthropic (Claude) ---
+# ANTHROPIC_MODEL=claude-haiku-4-5
+# ANTHROPIC_API_KEY=
+
+# --- Google Gemini ---
+# GEMINI_MODEL=
+# GEMINI_API_KEY=
+```
+
+Just fill in the API key and model for whichever one you want to use, and leave the rest as-is (or delete them).
+
+### Getting a free Ollama key (fastest way to get started)
+
+Ollama Cloud is a quick, free way to get an API key without signing up for OpenAI/Anthropic/Gemini billing.
+
+1. Go to [ollama.com](https://ollama.com/) and create an account.
+2. Once signed in, go to [ollama.com/settings/keys](https://ollama.com/settings/keys).
+3. Create a new API key and copy it.
+4. Paste it into your `.env` file:
+
+```sh
+HEALER_ENABLED=true
+HEALER_PROVIDER=ollama
+OLLAMA_MODEL=gpt-oss:120b
+OLLAMA_API_KEY=paste_your_key_here
+```
+
+That's all you need — no other variables required.
+
+### Important: set `actionTimeout` in your `playwright.config.ts`
+
+By default, Playwright lets a broken locator retry silently for your *entire* test timeout before it ever throws an error — which means self-healing never gets a turn at all, since it only kicks in once an action actually fails. Set `actionTimeout` to something well below your test timeout so a broken locator fails fast, leaving real time for healing to run:
+
+```ts
+export default defineConfig({
+  timeout: 60000, // your overall test timeout
+  use: {
+    actionTimeout: 8000, // must be comfortably less than the test timeout above
+  },
+});
+```
+
+Without this, healing attempts will show `stage=no_snapshot` in the console and never recover anything — not because healing failed, but because it never had time to run before the whole test was torn down.
+
+## Step 3: Check your setup
+
+Run the built-in doctor command to confirm everything's wired up correctly before you rely on it:
+
+```sh
+npx tamash-playwright doctor
+```
+
+It checks:
+
+1. **AI connectivity** — confirms `HEALER_ENABLED`/`HEALER_PROVIDER` are set correctly and actually calls your configured provider to make sure the API key and model work.
+2. **`actionTimeout` configuration** — checks your `playwright.config.ts` for an `actionTimeout` set well below your test `timeout` (see above); flags it if missing or too close to the test timeout, since that silently starves self-healing of any time to run.
+3. **Action recovery status** — whether `HEALER_ACTION_RECOVERY_ENABLED` is on (see below).
+4. **Vision capability** — whether your configured model is expected to support the screenshot-based fallback (see below), based on its name.
+5. **Missing `.describe()` labels** — scans your test files (`tests/` by default, or pass `--dir <path>`) for locators that don't have a `.describe('...')` label, and flags the ones most worth fixing (raw CSS/XPath selectors first).
+6. **Locators written directly in test files** — flags any locator defined inline in a test rather than inside a Page Object class, which is a Playwright best practice regardless of self-healing: it keeps tests readable and means a UI change only needs a fix in one place.
+
+If it finds issues, the fastest fix is to open the project in an AI coding assistant (Claude Code, Cursor, GitHub Copilot, etc.) and ask it to address what it flagged — add `.describe()` calls, or extract locators into Page Object classes. You can also add a standing rule to that assistant's instructions/skill file (e.g. `CLAUDE.md`, `.cursor/rules`, `.github/copilot-instructions.md`) so it follows both practices automatically on any new test code going forward.
+
+## Step 4: Use it in your tests
+
+Change one line at the top of your test file — everything else about how you write tests stays exactly the same:
+
+```ts
+// Before
+import { test, expect } from '@playwright/test';
+
+// After
+import { test, expect } from 'tamash-playwright';
+```
+
+That's it. Write your tests as normal:
+
+```ts
+import { test, expect } from 'tamash-playwright';
+
+test('logs in', async ({ page }) => {
+  await page.goto('/');
+  const txtUserName = page.locator('input[name="username"]').describe('User Name Textbox');
+  await txtUserName.fill('testadmin');
+
+  const txtPassword = page.locator('input[placeholder="Password"]').describe('Password Textbox');
+  await txtPassword.fill('secret');
+
+  const btnLogin = page.locator('button[type="submit"]').describe('Login Button');
+  await btnLogin.click();
+
+  await expect(page.getByRole('heading', { name: 'Dashboard' })).toBeVisible();
+});
+```
+
+### A quick tip for better results
+
+If you're using plain CSS selectors (like `page.locator('input[name="username"]')`) rather than Playwright's more descriptive locators (`getByRole`, `getByPlaceholder`, etc.), it helps to add a short, human-readable label so the healer knows what it's actually looking for. Chain `.describe('...')` right onto the locator:
+
+```ts
+test('login test using CSS Selectors', async ({ page }) => {
+  await page.goto('https://example.com/auth/login');
+
+  const txtUserName = page.locator('input[name="username"]').describe('User Name Textbox');
+  await txtUserName.fill('testadmin');
+
+  const txtPassword = page.locator('input[placeholder="Password"]').describe('Password Textbox');
+  await txtPassword.fill('secret');
+
+  const btnLogin = page.locator('button[type="submit"]').describe('Login Button');
+  await btnLogin.click();
+
+  await expect(page.locator('h6')).toHaveText('Dashboard');
+});
+```
+
+This step is optional, but recommended — without it, the healer has to guess purely from a broken CSS selector, which gives it a lot less to work with.
+
+## What else it heals — no extra setup needed
+
+Beyond a single broken `click`/`fill`/`getByRole` on the main page, all of this works automatically once you've done Steps 1–2:
+
+- **Popups and extra tabs.** A page opened via `context.newPage()`, `window.open`, or a `target="_blank"` link is just as healing-aware as your main `page` — no manual wrapping needed.
+- **Elements inside `<iframe>`s.** `page.frameLocator('#my-iframe')` and anything chained off it heals the same way, scoped correctly to the iframe's own document.
+- **Most of the Playwright API surface**, not just clicks and fills — `check`, `selectOption`, `dragTo`, `dispatchEvent`, read methods like `textContent`/`getAttribute`/`isChecked`, `screenshot`, and more. Methods that can't be safely healed by guessing a replacement element (`dragTo`, `drop`) are still reported honestly on failure, they're just never silently retried with a different element.
+
+## When text alone isn't enough: vision fallback
+
+Sometimes an element has nothing useful to match on by text — an icon-only button with no label, or several visually distinct elements that all look identical in the accessibility tree. If your configured model supports image input (e.g. `gpt-4o`, `claude-haiku-4-5`, `gemini-2.0-flash`), `tamash-playwright` automatically falls back to a screenshot-based search after the normal text-based attempt fails — no separate setup, it just uses the same provider and API key from Step 2. Run `npx tamash-playwright doctor` to check whether your configured model is expected to support this.
+
+## Action recovery (optional)
+
+Occasionally a locator heals correctly — the AI found the right element — but the *action* on it still fails, e.g. it's covered by an overlay or needs scrolling into view first. Set `HEALER_ACTION_RECOVERY_ENABLED=true` to let the AI pick a recovery tactic from a fixed, safe set (scroll into view, retry bypassing actionability checks, wait briefly and retry, or dispatch the DOM event directly) before giving up. It's off by default since it's a second, more speculative layer of intervention beyond selector healing — the AI only ever picks from that fixed menu, it never decides how to interact with the page on its own.
+
+## Checking what actually happened
+
+Every healing attempt — whether it succeeded or not — shows up in Playwright's own HTML report (`npx playwright show-report`), no separate report to check:
+
+- An annotation on the test summarizing what happened, e.g. `Recovered using ollama:gpt-oss:120b (role:button:Submit)`.
+- A JSON attachment with the full detail: which provider was used, whether the vision or action-recovery fallback was involved, the AI's suggested selector, token cost, and — if it didn't heal — which stage it stopped at (e.g. `ai_declined`, `replay_failed`).
+- Exactly where in your own code the locator was created — a test file or a Page Object class, whichever it really is — so you know which line to go fix even if you never look at the healing report again.
+
+The same detail is also printed to the console as it happens, one line per attempt:
+
+```
+[self-healer] src/pages/loginpage.ts:11 — locator.fill "Username Textbox" -> HEALED [provider=ollama:gpt-oss:120b, vision=no, actionRecovery=no, suggested="role:textbox:Username", 620 tokens (489 input + 131 output)] — locator.fill: Timeout 8000ms exceeded.
+```
+
+## License
+
+Free to use, including commercially. The source code may not be copied, modified, redistributed, or resold without prior written permission. See the LICENSE file included in this package for the full terms.
+
+## Support
+
+For questions or concerns, contact us at support@vibetestq.com.

package/dist/cli/scanActionTimeout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanActionTimeout.d.ts","sourceRoot":"","sources":["../../src/cli/scanActionTimeout.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAuB5F,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,kBAAkB,CAoBlF"}
+{"version":3,"file":"scanActionTimeout.d.ts","sourceRoot":"","sources":["../../src/cli/scanActionTimeout.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AA6E5F,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,kBAAkB,CAoBlF"}

package/dist/cli/scanActionTimeout.js

@@ -22,6 +22,54 @@ function extractNumber(content, key) {
     const match = content.match(new RegExp(`\\b${key}\\s*:\\s*(\\d+)`));
     return match ? Number(match[1]) : undefined;
 }
+// Strips `//` and `/* */` comments before extractNumber ever sees the text — otherwise a
+// commented-out `// actionTimeout: 8000,` reads as active, which is worse than not checking at
+// all (a confident false "OK" on the exact footgun this check exists to catch). Has to respect
+// string boundaries so a `//` inside a legitimate value (e.g. `baseURL: 'https://...'`) is never
+// mistaken for a comment start — same character-scanning approach as findFactoryCallOnLine in
+// applyHeals.ts, not a real parser, just comment/string-aware instead of comment-blind.
+function stripComments(content) {
+    let result = '';
+    let i = 0;
+    let inString = null;
+    while (i < content.length) {
+        const ch = content[i];
+        if (inString) {
+            result += ch;
+            if (ch === '\\') {
+                result += content[i + 1] ?? '';
+                i += 2;
+                continue;
+            }
+            if (ch === inString) {
+                inString = null;
+            }
+            i++;
+            continue;
+        }
+        if (ch === '"' || ch === "'" || ch === '`') {
+            inString = ch;
+            result += ch;
+            i++;
+            continue;
+        }
+        if (ch === '/' && content[i + 1] === '/') {
+            while (i < content.length && content[i] !== '\n')
+                i++;
+            continue;
+        }
+        if (ch === '/' && content[i + 1] === '*') {
+            i += 2;
+            while (i < content.length && !(content[i] === '*' && content[i + 1] === '/'))
+                i++;
+            i += 2;
+            continue;
+        }
+        result += ch;
+        i++;
+    }
+    return result;
+}
 // A plain regex scan over the config file's text, not a real parser — same "good enough for a
 // human to review" philosophy as scanDescribe.ts. Exists to catch the single most common
 // self-healing footgun: without an `actionTimeout` well below the test `timeout`, a broken locator
@@ -32,7 +80,7 @@ function checkActionTimeout(cwd = process.cwd()) {
     if (!configFile) {
         return { status: 'no_config' };
     }
-    const content = fs_1.default.readFileSync(configFile, 'utf-8');
+    const content = stripComments(fs_1.default.readFileSync(configFile, 'utf-8'));
     const relativeFile = path_1.default.relative(cwd, configFile);
     const actionTimeout = extractNumber(content, 'actionTimeout');
     if (actionTimeout === undefined) {

package/dist/cli/scanActionTimeout.js.map

@@ -1 +1 @@
-{"version":3,"file":"scanActionTimeout.js","sourceRoot":"","sources":["../../src/cli/scanActionTimeout.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AAExB,MAAM,gBAAgB,GAAG,CAAC,sBAAsB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,uBAAuB,CAAC,CAAC;AAQ5H,SAAS,cAAc,CAAC,GAAW;IACjC,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACvC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+FAA+F;AAC/F,+FAA+F;AAC/F,mEAAmE;AACnE,SAAS,aAAa,CAAC,OAAe,EAAE,GAAW;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC;AAED,8FAA8F;AAC9F,yFAAyF;AACzF,mGAAmG;AACnG,iGAAiG;AACjG,uFAAuF;AACvF,4BAAmC,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE;IAC5D,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,cAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAE9D,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACtD,IAAI,WAAW,KAAK,SAAS,IAAI,aAAa,IAAI,WAAW,EAAE,CAAC;QAC9D,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;IACvF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AACnE,CAAC"}
+{"version":3,"file":"scanActionTimeout.js","sourceRoot":"","sources":["../../src/cli/scanActionTimeout.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,43 +1,43 @@
-{
-  "name": "tamash-playwright",
-  "version": "0.6.0",
-  "description": "Plug and Play Self-healing for Playwright and automatically recovers broken selectors using an AI model (Ollama, OpenAI, Anthropic, or Gemini).",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "tamash-playwright": "dist/cli/index.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    ".env.example"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "playwright",
-    "self-healing",
-    "test-automation",
-    "llm",
-    "ollama",
-    "openai",
-    "anthropic",
-    "gemini"
-  ],
-  "author": "QtpSudhakar / VibeTestQ",
-  "license": "SEE LICENSE IN LICENSE",
-  "peerDependencies": {
-    "@playwright/test": ">=1.40.0"
-  },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.115.0",
-    "dotenv": "^16.0.1"
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.62.1",
-    "@types/node": "^26.1.2",
-    "typescript": "^7.0.2"
-  }
-}
+{
+  "name": "tamash-playwright",
+  "version": "0.6.1",
+  "description": "Plug and Play Self-healing for Playwright and automatically recovers broken selectors using an AI model (Ollama, OpenAI, Anthropic, or Gemini).",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "tamash-playwright": "dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    ".env.example"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "playwright",
+    "self-healing",
+    "test-automation",
+    "llm",
+    "ollama",
+    "openai",
+    "anthropic",
+    "gemini"
+  ],
+  "author": "QtpSudhakar / VibeTestQ",
+  "license": "SEE LICENSE IN LICENSE",
+  "peerDependencies": {
+    "@playwright/test": ">=1.40.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.115.0",
+    "dotenv": "^16.0.1"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.62.1",
+    "@types/node": "^26.1.2",
+    "typescript": "^7.0.2"
+  }
+}