@cementic/cementic-test 0.2.13 → 0.2.15

package/dist/cli.js

@@ -1,11 +1,16 @@
 #!/usr/bin/env node
+import {
+  captureElements,
+  formatCaptureFailure,
+  toPageSummary
+} from "./chunk-XUWFEWJZ.js";
 import {
   genCmd
-} from "./chunk-RG26I5FB.js";
+} from "./chunk-3S26OWNR.js";
 
 // src/cli.ts
 import { Command as Command9 } from "commander";
-import { createRequire as createRequire2 } from "module";
+import { createRequire } from "module";
 
 // src/commands/new.ts
 import { Command } from "commander";
@@ -18,6 +23,8 @@ import { platform, release } from "os";
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = dirname(__filename);
 var LEGACY_MACOS_DARWIN_MAJOR = 23;
+var LEGACY_PLAYWRIGHT_VERSION = "^1.48.2";
+var LEGACY_ALLURE_VERSION = "^2.15.1";
 function resolveTemplatePath(templateDir) {
   const candidates = [
     resolve(__dirname, `templates/${templateDir}`),
@@ -27,13 +34,73 @@ function resolveTemplatePath(templateDir) {
   ];
   return candidates.find((candidate) => existsSync(candidate));
 }
+function getHostPlatform(env = process.env) {
+  return (env.CT_OS_PLATFORM_OVERRIDE ?? platform()).trim().toLowerCase();
+}
+function getHostRelease(env = process.env) {
+  return (env.CT_OS_RELEASE_OVERRIDE ?? release()).trim();
+}
+function isLegacyMacOs(env = process.env) {
+  if (getHostPlatform(env) !== "darwin") return false;
+  const majorVersion = parseInt(getHostRelease(env).split(".")[0], 10);
+  return Number.isFinite(majorVersion) && majorVersion < LEGACY_MACOS_DARWIN_MAJOR;
+}
+function resolveBrowserInstallProfile(raw) {
+  const profile = String(raw ?? "auto").trim().toLowerCase();
+  if (profile === "auto" || profile === "all" || profile === "chromium") return profile;
+  console.error(`\u274C Unsupported browser install profile "${raw}". Use "auto", "all", or "chromium".`);
+  process.exit(1);
+}
+function resolveBootstrapPlan(browserProfile, env = process.env) {
+  const legacyMacOs = isLegacyMacOs(env);
+  const resolvedProfile = browserProfile === "auto" ? legacyMacOs ? "chromium" : "all" : browserProfile;
+  return {
+    browserInstallArgs: resolvedProfile === "chromium" ? ["playwright", "install", "chromium"] : ["playwright", "install"],
+    browserProfile: resolvedProfile,
+    isLegacyMacOs: legacyMacOs,
+    packageVersionOverrides: legacyMacOs ? {
+      "@playwright/test": LEGACY_PLAYWRIGHT_VERSION,
+      "allure-playwright": LEGACY_ALLURE_VERSION
+    } : {},
+    reason: legacyMacOs ? "Detected macOS 13 or older. Using a legacy-compatible Playwright toolchain and Chromium-only browser install." : void 0
+  };
+}
+function applyPackageVersionOverrides(projectPath, versionOverrides) {
+  if (Object.keys(versionOverrides).length === 0) return;
+  const pkgJsonPath = join(projectPath, "package.json");
+  if (!existsSync(pkgJsonPath)) return;
+  try {
+    const pkgContent = readFileSync(pkgJsonPath, "utf-8");
+    const pkg = JSON.parse(pkgContent);
+    const devDependencies = pkg.devDependencies ?? {};
+    let changed = false;
+    for (const [name, version2] of Object.entries(versionOverrides)) {
+      if (typeof devDependencies[name] !== "string") continue;
+      devDependencies[name] = version2;
+      changed = true;
+    }
+    if (!changed) return;
+    pkg.devDependencies = devDependencies;
+    writeFileSync(pkgJsonPath, JSON.stringify(pkg, null, 2));
+    console.log("\u2705 Applied compatibility dependency pins for this machine.");
+  } catch (err) {
+    console.warn("\u26A0\uFE0F Failed to adjust package.json for OS compatibility:", err);
+  }
+}
 function newCmd() {
   const cmd = new Command("new").arguments("<projectName>").description("Scaffold a new CementicTest + Playwright project from scratch").addHelpText("after", `
 Examples:
   $ ct new my-awesome-test-suite
   $ ct new e2e-ts --lang ts
   $ ct new e2e-tests --no-browsers
-`).option("--mode <mode>", "greenfield|enhance", "greenfield").option("--lang <lang>", "Scaffold language (js|ts)", "js").option("--no-browsers", 'do not run "npx playwright install" during setup').action((projectName, opts) => {
+`).option("--mode <mode>", "greenfield|enhance", "greenfield").option("--lang <lang>", "Scaffold language (js|ts)", "js").option("--browser-set <profile>", "Browser install profile (auto|all|chromium)", "auto").option("--no-browsers", 'do not run "npx playwright install" during setup').action((projectName, opts) => {
+    const mode = String(opts.mode ?? "greenfield").trim().toLowerCase();
+    if (mode !== "greenfield") {
+      console.error(`\u274C Unsupported scaffold mode "${opts.mode}". Only "greenfield" is currently implemented.`);
+      process.exit(1);
+    }
+    const browserInstallProfile = resolveBrowserInstallProfile(opts.browserSet);
+    const bootstrapPlan = resolveBootstrapPlan(browserInstallProfile);
     const root = process.cwd();
     const projectPath = join(root, projectName);
     console.log(`\u{1F680} Initializing new CementicTest project in ${projectName}...`);
@@ -62,25 +129,10 @@ Examples:
       }
     }
     copyRecursive(templatePath, projectPath);
-    const legacyMacOs = isLegacyMacOs();
-    if (legacyMacOs) {
-      console.log("\u{1F34E} Detected macOS 13 or older. Adjusting versions for compatibility...");
-      const pkgJsonPath = join(projectPath, "package.json");
-      if (existsSync(pkgJsonPath)) {
-        try {
-          const pkgContent = readFileSync(pkgJsonPath, "utf-8");
-          const pkg = JSON.parse(pkgContent);
-          if (pkg.devDependencies) {
-            pkg.devDependencies["@playwright/test"] = "^1.48.2";
-            pkg.devDependencies["allure-playwright"] = "^2.15.1";
-            writeFileSync(pkgJsonPath, JSON.stringify(pkg, null, 2));
-            console.log("\u2705 Pinned Playwright packages for legacy macOS compatibility.");
-          }
-        } catch (err) {
-          console.warn("\u26A0\uFE0F Failed to adjust package.json for OS compatibility:", err);
-        }
-      }
+    if (bootstrapPlan.reason) {
+      console.log(`\u{1F34E} ${bootstrapPlan.reason}`);
     }
+    applyPackageVersionOverrides(projectPath, bootstrapPlan.packageVersionOverrides);
     try {
       execSync("git init", { cwd: projectPath, stdio: "ignore" });
       const gitignorePath = join(projectPath, ".gitignore");
@@ -101,17 +153,19 @@ Examples:
     if (opts.browsers !== false && dependenciesInstalled) {
       console.log("\u{1F310} Installing Playwright browsers...");
       try {
-        if (legacyMacOs) {
+        const installCommand = `npx ${bootstrapPlan.browserInstallArgs.join(" ")}`;
+        if (bootstrapPlan.browserProfile === "chromium" && bootstrapPlan.isLegacyMacOs) {
           console.log("\u26A0\uFE0F WebKit is not supported on this macOS version. Installing Chromium only...");
-          execSync("npx playwright install chromium", { cwd: projectPath, stdio: "inherit" });
-          console.log("\u2705 Chromium installed successfully.");
-        } else {
-          execSync("npx playwright install", { cwd: projectPath, stdio: "inherit" });
-          console.log("\u2705 Playwright browsers installed successfully.");
+        } else if (bootstrapPlan.browserProfile === "chromium") {
+          console.log("\u2139\uFE0F Installing Chromium only because --browser-set chromium was requested.");
         }
+        execSync(installCommand, { cwd: projectPath, stdio: "inherit" });
+        console.log(
+          bootstrapPlan.browserProfile === "chromium" ? "\u2705 Chromium installed successfully." : "\u2705 Playwright browsers installed successfully."
+        );
       } catch (e) {
         console.warn("\u26A0\uFE0F Browser installation did not complete. You can finish setup with:");
-        console.warn("  npx playwright install chromium");
+        console.warn(`  npx ${bootstrapPlan.browserInstallArgs.join(" ")}`);
       }
     }
     console.log(`
@@ -126,11 +180,6 @@ Happy testing! \u{1F9EA}`);
   });
   return cmd;
 }
-function isLegacyMacOs() {
-  if (platform() !== "darwin") return false;
-  const majorVersion = parseInt(release().split(".")[0], 10);
-  return Number.isFinite(majorVersion) && majorVersion < LEGACY_MACOS_DARWIN_MAJOR;
-}
 
 // src/commands/normalize.ts
 import { Command as Command2 } from "commander";
@@ -321,7 +370,7 @@ Examples:
     }
     console.log(`\u2705 Normalized ${index.summary.parsed} case(s). Output \u2192 .cementic/normalized/`);
     if (opts.andGen) {
-      const { gen } = await import("./gen-6Y65IYXO.js");
+      const { gen } = await import("./gen-AGWFMHTO.js");
       await gen({ lang: opts.lang || "ts", out: "tests/generated" });
     }
   });
@@ -352,7 +401,7 @@ function testCmd() {
 // src/commands/tc.ts
 import { Command as Command4 } from "commander";
 import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
-import { join as join5 } from "path";
+import { join as join4 } from "path";
 import { createInterface } from "readline/promises";
 import { stdin as input, stdout as output } from "process";
 
@@ -1054,6 +1103,9 @@ async function generateTcMarkdownWithAi(ctx) {
 }
 
 // src/core/analyse.ts
+function escapeForRegex(value) {
+  return value.replace(/[.*+?^${}()|[\]\\\/]/g, "\\$&");
+}
 var RULE_10_PLAYWRIGHT_KNOWLEDGE_BASE2 = `
 RULE 10 - PLAYWRIGHT KNOWLEDGE BASE
 (sourced from playwright.dev official documentation)
@@ -1365,23 +1417,37 @@ ADDITIONAL PLAYWRIGHT DOCS (fetched for this intent)
 }
 async function analyseElements(elementMap, options = {}) {
   const { verbose = false, feature } = options;
-  const providerConfig = resolveLlmProvider();
   const requestedFeature = normalizeRequestedFeature(feature, elementMap);
+  let providerConfig;
+  try {
+    providerConfig = resolveLlmProvider();
+  } catch (error) {
+    log(verbose, `
+[analyse] ${shortErrorMessage(error)}`);
+    log(verbose, "[analyse] Falling back to deterministic capture analysis.");
+    return buildDeterministicAnalysis(elementMap, requestedFeature);
+  }
   log(verbose, `
 [analyse] Sending capture to ${providerConfig.displayName} (${providerConfig.model})`);
-  const docContext = await fetchDocContext2(requestedFeature);
-  const systemPrompt = buildSystemPrompt() + docContext;
-  const userPrompt = buildUserPrompt(elementMap, requestedFeature);
-  const rawResponse = providerConfig.transport === "anthropic" ? await callAnthropic2(providerConfig.apiKey, providerConfig.model, systemPrompt, userPrompt) : await callOpenAiCompatible2(
-    providerConfig.apiKey,
-    providerConfig.model,
-    providerConfig.baseUrl ?? "https://api.openai.com/v1",
-    providerConfig.displayName,
-    systemPrompt,
-    userPrompt
-  );
-  const parsed = parseAnalysisJson(rawResponse);
-  return sanitizeAnalysis(parsed, elementMap, requestedFeature);
+  try {
+    const docContext = await fetchDocContext2(requestedFeature);
+    const systemPrompt = buildSystemPrompt() + docContext;
+    const userPrompt = buildUserPrompt(elementMap, requestedFeature);
+    const rawResponse = providerConfig.transport === "anthropic" ? await callAnthropic2(providerConfig.apiKey, providerConfig.model, systemPrompt, userPrompt) : await callOpenAiCompatible2(
+      providerConfig.apiKey,
+      providerConfig.model,
+      providerConfig.baseUrl ?? "https://api.openai.com/v1",
+      providerConfig.displayName,
+      systemPrompt,
+      userPrompt
+    );
+    const parsed = parseAnalysisJson(rawResponse);
+    return sanitizeAnalysis(parsed, elementMap, requestedFeature);
+  } catch (error) {
+    log(verbose, `[analyse] Remote analysis failed: ${shortErrorMessage(error)}`);
+    log(verbose, "[analyse] Falling back to deterministic capture analysis.");
+    return buildDeterministicAnalysis(elementMap, requestedFeature);
+  }
 }
 function buildSystemPrompt() {
   return `
@@ -1402,10 +1468,11 @@ RULES:
 9. For presence-only intents such as "verify X" or "X is present", only assert visibility. Do not click and do not assert outcomes after clicking.
 ${RULE_10_PLAYWRIGHT_KNOWLEDGE_BASE2}
 11. For fill steps, never use the literal word "value". If matching CT_VAR_* variables are listed in the prompt, use them in human-readable step text and use a realistic non-generic runtime value in the JSON value field. Otherwise use a field-specific fallback such as test-username or test-password.
-12. The "selector" field must be a raw selector expression such as locator("#username") or getByRole('button', { name: "Login" }). Never wrap selectors in page. or page.locator("...") inside JSON.
-13. Tie-breaker for multiple matching elements: prefer highest confidence, then interactive elements, then the first visible-looking candidate.
-14. If a page clearly contains login or auth fields, do not create submit scenarios that only click the button. Include realistic fill steps for captured username/email and password inputs when the intent asks for auth interaction.
-15. "verify title" means the main visible heading on the page, not the browser tab title, unless the intent explicitly says browser title, tab title, or page title.
+12. When a CTA could realistically be a button or a link, prefer a resilient selector such as getByRole('button', { name: /Join Now/i }).or(page.getByRole('link', { name: /Join Now/i })).
+13. The "selector" field must be a raw selector expression such as locator("#username") or getByRole('button', { name: "Login" }). Never wrap selectors in page. or page.locator("...") inside JSON, except inside Locator.or(...) where the alternate locator must be page-scoped.
+14. Tie-breaker for multiple matching elements: prefer highest confidence, then interactive elements, then the first visible-looking candidate.
+15. If a page clearly contains login or auth fields, do not create submit scenarios that only click the button. Include realistic fill steps for captured username/email and password inputs when the intent asks for auth interaction.
+16. "verify title" means the main visible heading on the page, not the browser tab title, unless the intent explicitly says browser title, tab title, or page title.
 
 OUTPUT SCHEMA:
 {
@@ -1605,7 +1672,7 @@ function sanitizeAnalysis(analysis, elementMap, requestedFeature) {
     resolvedPrefix
   ).slice(0, intentProfile.maxScenarios);
   const useAuthFallback = shouldUseAuthFallback(authElements, intentAlignedScenarios, intentProfile);
-  const fallbackScenarios = intentProfile.mode === "presence" ? buildPresenceOnlyScenarios(elementMap, requestedFeature, resolvedPrefix) : useAuthFallback ? buildAuthFallbackScenarios(elementMap, resolvedPrefix, authElements) : buildFallbackScenarios(elementMap, resolvedPrefix);
+  const fallbackScenarios = intentProfile.mode === "presence" ? buildPresenceOnlyScenarios(elementMap, requestedFeature, resolvedPrefix) : useAuthFallback ? buildAuthFallbackScenarios(elementMap, resolvedPrefix, authElements, requestedFeature) : buildFallbackScenarios(elementMap, resolvedPrefix, requestedFeature);
   const finalScenarios = useAuthFallback ? fallbackScenarios.slice(0, intentProfile.maxScenarios) : intentAlignedScenarios.length > 0 ? intentAlignedScenarios : fallbackScenarios.slice(0, intentProfile.maxScenarios);
   return {
     ...analysis,
@@ -1671,13 +1738,72 @@ function normalizeAssertion(candidate, selectors) {
   return assertion;
 }
 function buildFallbackScenarios(elementMap, prefix) {
+  return buildFallbackScenariosForFeature(elementMap, prefix, "");
+}
+function buildFallbackScenariosForFeature(elementMap, prefix, feature) {
+  const normalizedFeature = feature.toLowerCase();
   const heading = elementMap.elements.find((element) => element.category === "heading");
   const emailInput = elementMap.elements.find((element) => element.category === "input" && (element.attributes.type === "email" || /email/.test(`${element.name ?? ""} ${String(element.attributes.label ?? "")}`.toLowerCase())));
   const passwordInput = elementMap.elements.find((element) => element.category === "input" && element.attributes.type === "password");
   const submitButton = elementMap.elements.find((element) => element.category === "button" && /login|sign in|submit|continue/i.test(element.name ?? "")) ?? elementMap.elements.find((element) => element.category === "button");
+  const alert = findAlertElement(elementMap);
   const scenarios = [];
   const tag = (value) => normalizeTag(value);
   const nextId = (index) => `${prefix}-${String(900 + index).padStart(3, "0")}`;
+  const wantsHiddenAlertOnLoad = /\b(error|alert|message)\b/.test(normalizedFeature) && /\b(not shown|not visible|hidden|not present|gone|absent)\b/.test(normalizedFeature) && /\b(first load|first loads|first loads?|page first loads|initial load|on load)\b/.test(normalizedFeature);
+  const wantsVisibleAlert = /\b(error|alert|message|invalid|incorrect|required|validation)\b/.test(normalizedFeature) && !wantsHiddenAlertOnLoad;
+  if (wantsHiddenAlertOnLoad && alert) {
+    return [{
+      id: `${prefix}-001`,
+      title: "Error message is hidden on initial load",
+      tags: [tag("negative"), tag("ui")],
+      steps: [
+        {
+          action: "navigate",
+          selector: "page",
+          value: elementMap.url,
+          human: "Navigate to the captured page"
+        }
+      ],
+      assertions: [
+        {
+          type: "hidden",
+          selector: alert.selector,
+          expected: "hidden",
+          human: `${alert.name || "Error message"} is not shown when the page first loads`,
+          playwright: `await expect(page.${alert.selector}).toBeHidden();`
+        }
+      ],
+      narrator: "We verify that the page does not expose an error surface before any user action.",
+      codeLevel: "beginner"
+    }];
+  }
+  if (wantsVisibleAlert && alert) {
+    return [{
+      id: `${prefix}-001`,
+      title: "Page exposes an alert message when requested",
+      tags: [tag("negative"), tag("ui")],
+      steps: [
+        {
+          action: "navigate",
+          selector: "page",
+          value: elementMap.url,
+          human: "Navigate to the captured page"
+        }
+      ],
+      assertions: [
+        {
+          type: "text",
+          selector: alert.selector,
+          expected: alert.name || "error",
+          human: "An alert message is shown",
+          playwright: `await expect(page.${alert.selector}).toContainText(/invalid|error|required/i);`
+        }
+      ],
+      narrator: "We validate the alert channel directly when the intent asks about an error message.",
+      codeLevel: "beginner"
+    }];
+  }
   if (heading) {
     scenarios.push({
       id: nextId(scenarios.length + 1),
@@ -1752,16 +1878,115 @@ function buildFallbackScenarios(elementMap, prefix) {
   }
   return scenarios.slice(0, 5);
 }
-function buildAuthFallbackScenarios(elementMap, prefix, authElements) {
+function buildAuthFallbackScenarios(elementMap, prefix, authElements, feature) {
   const { usernameInput, passwordInput, submitButton, heading } = authElements;
   if (!usernameInput || !passwordInput || !submitButton) {
-    return buildFallbackScenarios(elementMap, prefix);
+    return buildFallbackScenariosForFeature(elementMap, prefix, feature);
   }
+  const normalizedFeature = feature.toLowerCase();
   const scenarios = [];
   const tag = (value) => normalizeTag(value);
   const nextId = (index) => `${prefix}-${String(index).padStart(3, "0")}`;
   const usernameValue = inferAuthValue(usernameInput, "username");
   const passwordValue = inferAuthValue(passwordInput, "password");
+  const alert = findAlertElement(elementMap);
+  const wantsNavigation = /\b(valid credentials|correct credentials|successful login|log in successfully|login succeeds|sign in succeeds)\b/.test(normalizedFeature) || /\b(redirect|redirects|redirected|secure area|dashboard|redirected to|goes to|navigates? to)\b/.test(normalizedFeature);
+  const wantsError = /\b(wrong password|wrong credentials|invalid|incorrect|error message|shows an error|alert)\b/.test(normalizedFeature);
+  const successUrlPattern = deriveSuccessUrlPattern(elementMap, normalizedFeature);
+  if (wantsNavigation) {
+    return [{
+      id: `${prefix}-001`,
+      title: "Valid credentials redirect to the authenticated area",
+      tags: [tag("auth"), tag("happy-path")],
+      steps: [
+        {
+          action: "navigate",
+          selector: "page",
+          value: elementMap.url,
+          human: "Navigate to the login page"
+        },
+        {
+          action: "fill",
+          selector: usernameInput.selector,
+          value: usernameValue,
+          human: buildFillHuman("Fill in the username field", usernameInput.selector, usernameValue)
+        },
+        {
+          action: "fill",
+          selector: passwordInput.selector,
+          value: passwordValue,
+          human: buildFillHuman("Fill in the password field", passwordInput.selector, passwordValue)
+        },
+        {
+          action: "click",
+          selector: submitButton.selector,
+          value: "",
+          human: "Click the login button"
+        }
+      ],
+      assertions: [
+        {
+          type: "url",
+          selector: "page",
+          expected: successUrlPattern,
+          human: "User is redirected to the secure area",
+          playwright: `await expect(page).toHaveURL(/${successUrlPattern}/);`
+        }
+      ],
+      narrator: "We submit valid credentials and confirm that authentication changes the page URL.",
+      codeLevel: "beginner"
+    }];
+  }
+  if (wantsError) {
+    return [{
+      id: `${prefix}-001`,
+      title: "Wrong password shows an authentication error",
+      tags: [tag("auth"), tag("negative")],
+      steps: [
+        {
+          action: "navigate",
+          selector: "page",
+          value: elementMap.url,
+          human: "Navigate to the login page"
+        },
+        {
+          action: "fill",
+          selector: usernameInput.selector,
+          value: usernameValue,
+          human: buildFillHuman("Fill in the username field", usernameInput.selector, usernameValue)
+        },
+        {
+          action: "fill",
+          selector: passwordInput.selector,
+          value: "wrong-password",
+          human: buildFillHuman("Fill in the password field", passwordInput.selector, "wrong-password")
+        },
+        {
+          action: "click",
+          selector: submitButton.selector,
+          value: "",
+          human: "Click the login button"
+        }
+      ],
+      assertions: [
+        alert ? {
+          type: "text",
+          selector: alert.selector,
+          expected: alert.name || "error",
+          human: "An alert communicates the login failure",
+          playwright: `await expect(page.${alert.selector}).toContainText(/invalid|error|required/i);`
+        } : {
+          type: "text",
+          selector: usernameInput.selector,
+          expected: "error",
+          human: "An authentication error message is shown",
+          playwright: `await expect(page.getByRole('alert')).toContainText(/invalid|error|required/i);`
+        }
+      ],
+      narrator: "We use an invalid password and confirm the page surfaces an authentication error.",
+      codeLevel: "beginner"
+    }];
+  }
   scenarios.push({
     id: nextId(1),
     title: "Login form renders expected controls",
@@ -2024,7 +2249,7 @@ function extractPresenceClaims(feature, elementMap) {
     const text = extractIntentLabel(segment);
     if (!text) continue;
     const match = findBestMatchingElement(elementMap, text, normalized);
-    const selector = match?.selector ?? buildFallbackSelector(text, normalized);
+    const selector = buildIntentSelector(text, normalized, match);
     claims.push({
       selector,
       human: `${text} is visible`
@@ -2040,16 +2265,23 @@ function chooseHeadingElement(elementMap) {
 function extractIntentLabel(segment) {
   const unquoted = Array.from(segment.matchAll(/["“”']([^"“”']+)["“”']/g)).map((match) => match[1].trim());
   if (unquoted.length > 0) return unquoted[0];
-  return segment.replace(/\b(?:verify|check|confirm|ensure)\b/gi, " ").replace(/\b(?:the|a|an)\b/gi, " ").replace(/\b(?:is|are|be|should be)\b/gi, " ").replace(/\b(?:present|visible|shown|showing|available|exists?)\b/gi, " ").replace(/\b(?:button|link|cta|label|text)\b/gi, " ").replace(/[.?!,:;]+/g, " ").replace(/\s+/g, " ").trim();
+  return segment.replace(/\b(?:verify|check|confirm|ensure)\b/gi, " ").replace(/\b(?:the|a|an)\b/gi, " ").replace(/\b(?:is|are|be|should be)\b/gi, " ").replace(/\b(?:present|visible|shown|showing|available|exists?)\b/gi, " ").replace(/\b(?:on|in)\s+(?:the\s+)?page\b/gi, " ").replace(/\b(?:button|link|cta|label|text)\b/gi, " ").replace(/[.?!,:;]+/g, " ").replace(/\s+/g, " ").trim();
 }
 function findBestMatchingElement(elementMap, text, segment) {
   const preferredCategory = /\bbutton\b/.test(segment) ? "button" : /\blink\b/.test(segment) ? "link" : /\bheading\b/.test(segment) ? "heading" : void 0;
   const query = text.toLowerCase();
   const candidates = elementMap.elements.filter((element) => {
-    if (preferredCategory && element.category !== preferredCategory) return false;
     const haystack = `${element.name ?? ""} ${element.purpose}`.toLowerCase();
     return haystack.includes(query);
   });
+  if (!preferredCategory) return rankElements(candidates)[0];
+  const preferred = candidates.filter((element) => element.category === preferredCategory);
+  if (preferred.length > 0) return rankElements(preferred)[0];
+  if ((preferredCategory === "button" || preferredCategory === "link") && shouldUseAmbiguousCtaSelector(segment, text)) {
+    const alternateCategory = preferredCategory === "button" ? "link" : "button";
+    const alternates = candidates.filter((element) => element.category === alternateCategory);
+    if (alternates.length > 0) return rankElements(alternates)[0];
+  }
   return rankElements(candidates)[0];
 }
 function rankElements(elements) {
@@ -2063,11 +2295,32 @@ function rankElements(elements) {
     return 0;
   });
 }
-function buildFallbackSelector(text, segment) {
+function buildIntentSelector(text, segment, match) {
+  if (shouldUseAmbiguousCtaSelector(segment, text)) {
+    if (/\blink\b/.test(segment)) return buildAmbiguousRoleSelector(text, "link");
+    if (/\bbutton\b/.test(segment) || match?.category === "link" || match?.category === "button") {
+      return buildAmbiguousRoleSelector(text, "button");
+    }
+  }
+  return match?.selector ?? buildFallbackSelector(text, segment);
+}
+function shouldUseAmbiguousCtaSelector(segment, text) {
+  const haystack = `${segment} ${text}`.toLowerCase();
+  return /\b(?:button|link|cta)\b/.test(haystack) && (/\b(?:join|start|get started|sign up|signup|subscribe|buy|purchase|learn more|see how it works|continue)\b/.test(haystack) || /[$€£]/.test(text));
+}
+function buildAmbiguousRoleSelector(text, preferredRole) {
+  const primary = buildRoleSelector(preferredRole, text);
+  const alternate = buildRoleSelector(preferredRole === "button" ? "link" : "button", text);
+  return `${primary}.or(page.${alternate})`;
+}
+function buildRoleSelector(role, text) {
   const safeRegex = text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  if (/\bbutton\b/.test(segment)) return `getByRole('button', { name: /${safeRegex}/i })`;
-  if (/\blink\b/.test(segment)) return `getByRole('link', { name: /${safeRegex}/i })`;
-  if (/\b(?:title|heading)\b/.test(segment)) return `getByRole('heading', { name: /${safeRegex}/i })`;
+  return `getByRole('${role}', { name: /${safeRegex}/i })`;
+}
+function buildFallbackSelector(text, segment) {
+  if (/\bbutton\b/.test(segment)) return buildRoleSelector("button", text);
+  if (/\blink\b/.test(segment)) return buildRoleSelector("link", text);
+  if (/\b(?:title|heading)\b/.test(segment)) return buildRoleSelector("heading", text);
   return `getByText(${JSON.stringify(text)})`;
 }
 function buildAudioSummary(feature, scenarios) {
@@ -2084,6 +2337,53 @@ function detectAuthElements(elementMap) {
   const heading = elementMap.elements.find((element) => element.category === "heading" && /login|sign in|auth/.test((element.name ?? "").toLowerCase())) ?? elementMap.elements.find((element) => element.category === "heading");
   return { usernameInput, passwordInput, submitButton, heading };
 }
+function findAlertElement(elementMap) {
+  return elementMap.elements.find((element) => element.role === "alert" || element.category === "status" || String(element.attributes.role ?? "").toLowerCase() === "alert");
+}
+function deriveSuccessUrlPattern(elementMap, normalizedFeature) {
+  const explicitPath = normalizedFeature.match(/\/[a-z0-9/_-]+/i)?.[0] ?? (/\bsecure area\b/.test(normalizedFeature) ? "/secure" : void 0);
+  if (explicitPath) {
+    return explicitPath.replace(/^\/+/, "").split("/").map(escapeForRegex).join("\\/");
+  }
+  const authLink = elementMap.elements.find((element) => {
+    if (element.category !== "link") return false;
+    const href2 = String(element.attributes.href ?? "");
+    const label = `${element.name ?? ""} ${href2}`.toLowerCase();
+    return /\b(secure|dashboard|home|app)\b/.test(label);
+  });
+  const href = String(authLink?.attributes.href ?? "");
+  if (href.startsWith("/")) {
+    return href.replace(/^\/+/, "").split("/").map(escapeForRegex).join("\\/");
+  }
+  return "secure|dashboard|home|app";
+}
+function buildDeterministicAnalysis(elementMap, requestedFeature) {
+  const intentProfile = buildIntentProfile(requestedFeature);
+  const suggestedPrefix = inferPrefix({
+    featureText: requestedFeature,
+    url: elementMap.url
+  }).toUpperCase();
+  const authElements = detectAuthElements(elementMap);
+  let scenarios = intentProfile.mode === "count" ? buildCountScenarios(elementMap, requestedFeature, suggestedPrefix) : intentProfile.mode === "presence" ? buildPresenceOnlyScenarios(elementMap, requestedFeature, suggestedPrefix) : intentProfile.mode === "auth" || intentProfile.mode === "form" ? buildAuthFallbackScenarios(elementMap, suggestedPrefix, authElements, requestedFeature) : buildFallbackScenariosForFeature(elementMap, suggestedPrefix, requestedFeature);
+  if (scenarios.length === 0 && (authElements.usernameInput || authElements.passwordInput || authElements.submitButton)) {
+    scenarios = buildAuthFallbackScenarios(elementMap, suggestedPrefix, authElements, requestedFeature);
+  }
+  if (scenarios.length === 0) {
+    scenarios = buildFallbackScenariosForFeature(elementMap, suggestedPrefix, requestedFeature);
+  }
+  const finalScenarios = scenarios.slice(0, intentProfile.maxScenarios);
+  return {
+    url: elementMap.url,
+    feature: requestedFeature,
+    suggestedPrefix,
+    scenarios: finalScenarios,
+    analysisNotes: "Generated deterministic capture-backed scenarios because LLM analysis was unavailable.",
+    audioSummary: buildAudioSummary(requestedFeature, finalScenarios)
+  };
+}
+function shortErrorMessage(error) {
+  return String(error?.message ?? error ?? "Unknown error").split("\n")[0];
+}
 function shouldUseAuthFallback(authElements, scenarios, intentProfile) {
   if (intentProfile.mode !== "auth" && intentProfile.mode !== "form") return false;
   if (!authElements.usernameInput || !authElements.passwordInput || !authElements.submitButton) return false;
@@ -2231,6 +2531,10 @@ function extractCtVarTemplate(value) {
 function isAllowedSelector(selector, selectors) {
   if (selector === "page") return true;
   if (selectors.has(selector)) return true;
+  if (/\.or\(page\.(?:getByRole|getByText|getByLabel|getByPlaceholder|getByTestId|locator)\(/.test(selector)) {
+    const primary = selector.replace(/\.or\(page\.(?:getByRole|getByText|getByLabel|getByPlaceholder|getByTestId|locator)\([\s\S]*\)\)\s*$/, "");
+    return isAllowedSelector(primary, selectors);
+  }
   return /^(?:getByRole|getByText|getByLabel|getByPlaceholder|getByTestId)\(/.test(selector) || /^locator\((['"])(#.+?)\1\)$/.test(selector);
 }
 function ensureStatement(value) {
@@ -2255,565 +2559,9 @@ function log(verbose, message) {
   if (verbose) console.log(message);
 }
 
-// src/core/playwright.ts
-import { existsSync as existsSync2 } from "fs";
-import { dirname as dirname2, join as join3, resolve as resolve3 } from "path";
-import { createRequire } from "module";
-import { fileURLToPath as fileURLToPath2, pathToFileURL } from "url";
-var require2 = createRequire(import.meta.url);
-var moduleDir = dirname2(fileURLToPath2(import.meta.url));
-async function resolvePlaywrightChromium(cwd = process.cwd()) {
-  const searchRoots = buildSearchRoots(cwd);
-  for (const packageName of ["@playwright/test", "playwright-core"]) {
-    for (const searchRoot of searchRoots) {
-      const resolvedPath = resolveFromRoot(packageName, searchRoot);
-      if (!resolvedPath) continue;
-      const imported = await import(pathToFileURL(resolvedPath).href);
-      const chromium = imported.chromium ?? imported.default?.chromium;
-      if (chromium) {
-        return {
-          packageName,
-          resolvedPath,
-          searchRoot,
-          chromium
-        };
-      }
-    }
-  }
-  throw new Error(
-    "Playwright runtime not found in this project.\nTry:\n  npm install\n  npx playwright install chromium"
-  );
-}
-function buildSearchRoots(cwd) {
-  const roots = [resolve3(cwd)];
-  const projectRoot = findNearestProjectRoot(cwd);
-  if (projectRoot && projectRoot !== roots[0]) {
-    roots.push(projectRoot);
-  }
-  roots.push(moduleDir);
-  return Array.from(new Set(roots));
-}
-function findNearestProjectRoot(startDir) {
-  let currentDir = resolve3(startDir);
-  while (true) {
-    if (existsSync2(join3(currentDir, "package.json"))) {
-      return currentDir;
-    }
-    const parentDir = dirname2(currentDir);
-    if (parentDir === currentDir) return void 0;
-    currentDir = parentDir;
-  }
-}
-function resolveFromRoot(packageName, searchRoot) {
-  try {
-    return require2.resolve(packageName, { paths: [searchRoot] });
-  } catch {
-    return void 0;
-  }
-}
-
-// src/core/capture.ts
-var SETTLE_MS = 1200;
-var DEFAULT_TIMEOUT_MS = 3e4;
-var MAX_PER_CATEGORY = 50;
-var CaptureRuntimeError = class extends Error {
-  constructor(code, message, options) {
-    super(message);
-    this.name = "CaptureRuntimeError";
-    this.code = code;
-    if (options?.cause !== void 0) {
-      this.cause = options.cause;
-    }
-  }
-};
-async function captureElements(url, options = {}) {
-  const {
-    headless = true,
-    timeoutMs = DEFAULT_TIMEOUT_MS,
-    verbose = false,
-    userAgent = "Mozilla/5.0 (compatible; CementicTest/0.2.7 capture)"
-  } = options;
-  const chromium = await loadChromium();
-  const mode = headless ? "headless" : "headed";
-  log2(verbose, `
-[capture] Starting ${mode} capture: ${url}`);
-  let browser;
-  try {
-    browser = await chromium.launch({
-      headless,
-      slowMo: headless ? 0 : 150
-    });
-  } catch (error) {
-    throw classifyCaptureError(error);
-  }
-  const context = await browser.newContext({
-    userAgent,
-    viewport: { width: 1280, height: 800 },
-    ignoreHTTPSErrors: true
-  });
-  const page = await context.newPage();
-  try {
-    log2(verbose, `  -> Navigating (timeout: ${timeoutMs}ms)`);
-    try {
-      await page.goto(url, {
-        waitUntil: "domcontentloaded",
-        timeout: timeoutMs
-      });
-    } catch (error) {
-      throw new CaptureRuntimeError(
-        "PAGE_LOAD_FAILED",
-        `Page load failed for ${url}. ${error?.message ?? error}`,
-        { cause: error }
-      );
-    }
-    log2(verbose, `  -> Waiting ${SETTLE_MS}ms for page settle`);
-    await page.waitForTimeout(SETTLE_MS);
-    log2(verbose, "  -> Extracting accessibility snapshot");
-    const a11ySnapshot = await getAccessibilitySnapshot(page, verbose);
-    log2(verbose, "  -> Extracting DOM data");
-    const domData = await page.evaluate(extractDomData);
-    const title = await page.title();
-    const finalUrl = page.url();
-    const elements = buildElementMap(domData);
-    const warnings = buildWarnings(elements, domData, a11ySnapshot);
-    const byCategory = {};
-    for (const element of elements) {
-      byCategory[element.category] = (byCategory[element.category] ?? 0) + 1;
-    }
-    const result = {
-      url: finalUrl,
-      title,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      mode,
-      summary: {
-        totalElements: elements.length,
-        byCategory
-      },
-      elements,
-      warnings
-    };
-    log2(verbose, `  -> Captured ${elements.length} testable elements from "${title}"`);
-    return result;
-  } catch (error) {
-    throw classifyCaptureError(error);
-  } finally {
-    await browser?.close();
-  }
-}
-function toPageSummary(elementMap) {
-  const inputs = elementMap.elements.filter((element) => element.category === "input").slice(0, 30).map((element) => ({
-    label: asString(element.attributes.label),
-    placeholder: asString(element.attributes.placeholder),
-    name: asString(element.attributes.name),
-    type: asString(element.attributes.type),
-    testId: asString(element.attributes.testId)
-  }));
-  return {
-    url: elementMap.url,
-    title: elementMap.title,
-    headings: elementMap.elements.filter((element) => element.category === "heading").map((element) => element.name ?? "").filter(Boolean).slice(0, 20),
-    buttons: elementMap.elements.filter((element) => element.category === "button").map((element) => element.name ?? "").filter(Boolean).slice(0, 30),
-    links: elementMap.elements.filter((element) => element.category === "link").map((element) => element.name ?? "").filter(Boolean).slice(0, 50),
-    inputs,
-    landmarks: [],
-    rawLength: elementMap.elements.length
-  };
-}
-async function loadChromium() {
-  try {
-    const resolution = await resolvePlaywrightChromium(process.cwd());
-    return resolution.chromium;
-  } catch (error) {
-    throw new CaptureRuntimeError(
-      "PLAYWRIGHT_NOT_FOUND",
-      error?.message ?? "Playwright runtime not found in this project.\nTry:\n  npm install\n  npx playwright install chromium",
-      { cause: error }
-    );
-  }
-}
-function extractDomData() {
-  const localMaxPerCategory = 50;
-  const attr = (el, name) => el.getAttribute(name)?.trim() || void 0;
-  const text = (el) => el?.textContent?.replace(/\s+/g, " ").trim() || void 0;
-  const jsString = (value) => JSON.stringify(value);
-  const findLabel = (el) => {
-    const id = attr(el, "id");
-    if (id) {
-      const labelEl = document.querySelector(`label[for="${id}"]`);
-      if (labelEl) return text(labelEl);
-    }
-    const ariaLabel = attr(el, "aria-label");
-    if (ariaLabel) return ariaLabel;
-    const labelledBy = attr(el, "aria-labelledby");
-    if (labelledBy) {
-      const labelEl = document.getElementById(labelledBy);
-      if (labelEl) return text(labelEl);
-    }
-    const closestLabel = el.closest("label");
-    if (closestLabel) {
-      const raw = text(closestLabel) || "";
-      const placeholder = attr(el, "placeholder") || "";
-      return raw.replace(placeholder, "").trim() || void 0;
-    }
-    const previous = el.previousElementSibling;
-    if (previous?.tagName === "LABEL") return text(previous);
-    return void 0;
-  };
-  const buildSelector = (el, labelText, buttonText) => {
-    const testId = attr(el, "data-testid");
-    if (testId) return `getByTestId(${jsString(testId)})`;
-    const id = attr(el, "id");
-    if (id && !id.match(/^(ember|react|vue|ng|auto|rand)/i)) {
-      return `locator(${jsString(`#${id}`)})`;
-    }
-    const ariaLabel = attr(el, "aria-label");
-    if (ariaLabel) {
-      return `getByRole(${jsString(el.getAttribute("role") || el.tagName.toLowerCase())}, { name: ${jsString(ariaLabel)} })`;
-    }
-    if (labelText) {
-      const tag = el.tagName.toLowerCase();
-      if (tag === "input" || tag === "textarea" || tag === "select") {
-        return `getByLabel(${jsString(labelText)})`;
-      }
-    }
-    if (buttonText) return `getByRole('button', { name: ${jsString(buttonText)} })`;
-    const name = attr(el, "name");
-    if (name) return `locator(${jsString(`[name="${name}"]`)})`;
-    return null;
-  };
-  const buttons = [];
-  document.querySelectorAll('button, [role="button"], input[type="submit"], input[type="button"]').forEach((el) => {
-    const buttonText = attr(el, "aria-label") || text(el) || attr(el, "value");
-    const testId = attr(el, "data-testid");
-    const id = attr(el, "id");
-    const type = attr(el, "type");
-    const disabled = el.hasAttribute("disabled") || el.getAttribute("aria-disabled") === "true";
-    const selector = buildSelector(el, void 0, buttonText);
-    if (buttonText || testId) {
-      buttons.push({
-        tag: el.tagName.toLowerCase(),
-        text: buttonText,
-        testId,
-        id,
-        type,
-        disabled,
-        selector,
-        cssPath: testId ? `[data-testid="${testId}"]` : id ? `#${id}` : null
-      });
-    }
-  });
-  const inputs = [];
-  document.querySelectorAll('input:not([type="hidden"]):not([type="submit"]):not([type="button"]), textarea, select').forEach((el) => {
-    const label = findLabel(el);
-    const placeholder = attr(el, "placeholder");
-    const name = attr(el, "name");
-    const id = attr(el, "id");
-    const type = attr(el, "type") || el.tagName.toLowerCase();
-    const testId = attr(el, "data-testid");
-    const required = el.hasAttribute("required");
-    const selector = buildSelector(el, label);
-    if (label || placeholder || name || testId || id) {
-      inputs.push({
-        tag: el.tagName.toLowerCase(),
-        type,
-        label,
-        placeholder,
-        name,
-        id,
-        testId,
-        required,
-        selector,
-        cssPath: testId ? `[data-testid="${testId}"]` : id ? `#${id}` : name ? `[name="${name}"]` : null
-      });
-    }
-  });
-  const links = [];
-  document.querySelectorAll("a[href]").forEach((el) => {
-    const linkText = attr(el, "aria-label") || text(el);
-    const href = attr(el, "href");
-    const testId = attr(el, "data-testid");
-    if (!linkText || href === "#") return;
-    links.push({
-      text: linkText,
-      href,
-      testId,
-      external: Boolean(href?.startsWith("http") && !href.includes(window.location.hostname)),
-      selector: testId ? `getByTestId(${jsString(testId)})` : `getByRole('link', { name: ${jsString(linkText)} })`
-    });
-  });
-  const headings = [];
-  document.querySelectorAll("h1, h2, h3").forEach((el) => {
-    const headingText = text(el);
-    if (headingText) {
-      headings.push({
-        level: el.tagName.toLowerCase(),
-        text: headingText,
-        selector: `getByRole('heading', { name: ${jsString(headingText)} })`
-      });
-    }
-  });
-  const landmarks = [];
-  document.querySelectorAll("[role], main, nav, header, footer, aside, section[aria-label]").forEach((el) => {
-    const role = attr(el, "role") || el.tagName.toLowerCase();
-    const label = attr(el, "aria-label") || text(el)?.slice(0, 40);
-    if (role && label) landmarks.push({ role, label });
-  });
-  const statusRegions = [];
-  document.querySelectorAll('[role="alert"], [role="status"], [aria-live]').forEach((el) => {
-    const role = attr(el, "role") || "live";
-    statusRegions.push({
-      role,
-      ariaLive: attr(el, "aria-live"),
-      text: text(el),
-      selector: el.getAttribute("role") ? `getByRole(${jsString(role)})` : `locator('[aria-live]')`
-    });
-  });
-  const forms = [];
-  document.querySelectorAll("form").forEach((form, index) => {
-    forms.push({
-      id: attr(form, "id"),
-      label: attr(form, "aria-label") || attr(form, "aria-labelledby"),
-      action: attr(form, "action"),
-      method: attr(form, "method") || "get",
-      fieldCount: form.querySelectorAll("input, textarea, select").length,
-      index
-    });
-  });
-  return {
-    buttons: buttons.slice(0, localMaxPerCategory),
-    inputs: inputs.slice(0, localMaxPerCategory),
-    links: links.slice(0, localMaxPerCategory),
-    headings: headings.slice(0, 20),
-    landmarks,
-    statusRegions,
-    forms,
-    pageUrl: window.location.href,
-    pageTitle: document.title
-  };
-}
-function buildElementMap(domData) {
-  const elements = [];
-  for (const input2 of domData.inputs) {
-    const displayName = input2.label || input2.placeholder || input2.name || input2.testId;
-    if (!displayName) continue;
-    const selector = input2.selector || (input2.testId ? `getByTestId(${JSON.stringify(input2.testId)})` : null) || (input2.label ? `getByLabel(${JSON.stringify(input2.label)})` : null) || (input2.id ? `locator(${JSON.stringify(`#${input2.id}`)})` : null) || (input2.name ? `locator(${JSON.stringify(`[name="${input2.name}"]`)})` : null) || `locator(${JSON.stringify(`${input2.tag}[placeholder="${input2.placeholder ?? ""}"]`)})`;
-    const selectorAlt = [];
-    if (input2.id && !selector.includes(`#${input2.id}`)) selectorAlt.push(`locator(${JSON.stringify(`#${input2.id}`)})`);
-    if (input2.name && !selector.includes(input2.name)) selectorAlt.push(`locator(${JSON.stringify(`[name="${input2.name}"]`)})`);
-    if (input2.testId && !selector.includes(input2.testId)) selectorAlt.push(`getByTestId(${JSON.stringify(input2.testId)})`);
-    if (input2.placeholder && !selector.includes(input2.placeholder)) selectorAlt.push(`getByPlaceholder(${JSON.stringify(input2.placeholder)})`);
-    if (input2.label && !selector.includes(input2.label)) selectorAlt.push(`getByLabel(${JSON.stringify(input2.label)})`);
-    elements.push({
-      category: "input",
-      role: input2.type === "checkbox" ? "checkbox" : "textbox",
-      name: displayName,
-      selector,
-      selectorAlt,
-      purpose: input2.required ? `Required ${input2.type} field - "${displayName}"` : `${input2.type} field - "${displayName}"`,
-      confidence: input2.testId || input2.label || input2.id ? "high" : input2.placeholder ? "medium" : "low",
-      attributes: {
-        type: input2.type,
-        label: input2.label,
-        placeholder: input2.placeholder,
-        name: input2.name,
-        id: input2.id,
-        testId: input2.testId,
-        required: input2.required,
-        tag: input2.tag
-      }
-    });
-  }
-  for (const button of domData.buttons) {
-    const displayName = button.text || button.testId;
-    if (!displayName) continue;
-    const selector = button.selector || (button.testId ? `getByTestId(${JSON.stringify(button.testId)})` : null) || (button.text ? `getByRole('button', { name: ${JSON.stringify(button.text)} })` : null) || (button.id ? `locator(${JSON.stringify(`#${button.id}`)})` : null) || `locator('button')`;
-    const selectorAlt = [];
-    if (button.id && !selector.includes(button.id)) selectorAlt.push(`locator(${JSON.stringify(`#${button.id}`)})`);
-    if (button.testId && !selector.includes(button.testId)) selectorAlt.push(`getByTestId(${JSON.stringify(button.testId)})`);
-    if (button.text && !selector.includes(button.text)) selectorAlt.push(`getByText(${JSON.stringify(button.text)})`);
-    if (button.cssPath) selectorAlt.push(`locator(${JSON.stringify(button.cssPath)})`);
-    elements.push({
-      category: "button",
-      role: "button",
-      name: displayName,
-      selector,
-      selectorAlt,
-      purpose: button.disabled ? `Disabled button - "${displayName}"` : button.type === "submit" ? `Form submit button - "${displayName}"` : `Button - "${displayName}"`,
-      confidence: button.testId || button.text ? "high" : button.id ? "medium" : "low",
-      attributes: {
-        text: button.text,
-        testId: button.testId,
-        id: button.id,
-        type: button.type,
-        disabled: button.disabled,
-        tag: button.tag
-      }
-    });
-  }
-  for (const link of domData.links) {
-    elements.push({
-      category: "link",
-      role: "link",
-      name: link.text,
-      selector: link.selector,
-      selectorAlt: link.testId ? [`getByTestId(${JSON.stringify(link.testId)})`] : [],
-      purpose: link.external ? `External link to "${link.href}" - "${link.text}"` : `Internal navigation link - "${link.text}" -> ${link.href}`,
-      confidence: link.testId ? "high" : "medium",
-      attributes: {
-        text: link.text,
-        href: link.href,
-        testId: link.testId,
-        external: link.external
-      }
-    });
-  }
-  for (const heading of domData.headings) {
-    elements.push({
-      category: "heading",
-      role: "heading",
-      name: heading.text,
-      selector: heading.selector,
-      selectorAlt: [`getByText(${JSON.stringify(heading.text)})`],
-      purpose: `Page ${heading.level} heading - use to assert the correct page or section loaded`,
-      confidence: "medium",
-      attributes: {
-        level: heading.level,
-        text: heading.text
-      }
-    });
-  }
-  for (const status of domData.statusRegions) {
-    elements.push({
-      category: "status",
-      role: status.role,
-      name: status.text || status.role,
-      selector: status.selector,
-      selectorAlt: [],
-      purpose: "Live region - use to assert error messages, success toasts, and validation feedback",
-      confidence: "medium",
-      attributes: {
-        role: status.role,
-        ariaLive: status.ariaLive,
-        currentText: status.text
-      }
-    });
-  }
-  return elements;
-}
-function buildWarnings(elements, domData, a11ySnapshot) {
-  const warnings = [];
-  if (!a11ySnapshot) {
-    warnings.push("Playwright accessibility snapshot was unavailable. Capture continued using DOM extraction only.");
-  }
-  const lowConfidenceInputs = elements.filter((element) => element.category === "input" && element.confidence === "low");
-  if (lowConfidenceInputs.length > 0) {
-    warnings.push(
-      `${lowConfidenceInputs.length} input(s) have low-confidence selectors. Consider adding data-testid attributes to: ${lowConfidenceInputs.map((element) => element.name).filter(Boolean).join(", ")}`
-    );
-  }
-  if (domData.statusRegions.length === 0) {
-    warnings.push("No ARIA alert or status regions detected. Error message assertions may need manual selector adjustments after generation.");
-  }
-  for (const form of domData.forms) {
-    const hasSubmit = domData.buttons.some((button) => button.type === "submit");
-    if (form.fieldCount > 0 && !hasSubmit) {
-      warnings.push(
-        `Form ${form.id || `#${form.index}`} has ${form.fieldCount} field(s) but no detected submit button. It may use keyboard submit or a custom handler.`
-      );
-    }
-  }
-  if (domData.links.length >= MAX_PER_CATEGORY) {
-    warnings.push(`Link count hit the ${MAX_PER_CATEGORY} capture limit. Generation will focus on forms and buttons.`);
-  }
-  const interactive = elements.filter((element) => element.category === "button" || element.category === "input" || element.category === "link");
-  if (interactive.length === 0) {
-    warnings.push("No interactive elements detected. The page may require authentication, render later than the current settle window, or be mostly static content.");
-  }
-  return warnings;
-}
-function log2(verbose, message) {
-  if (verbose) console.log(message);
-}
-async function getAccessibilitySnapshot(page, verbose) {
-  if (!page.accessibility || typeof page.accessibility.snapshot !== "function") {
-    log2(verbose, "  -> Accessibility snapshot API unavailable; continuing with DOM-only capture");
-    return null;
-  }
-  try {
-    return await page.accessibility.snapshot({ interestingOnly: false });
-  } catch (error) {
-    log2(verbose, `  -> Accessibility snapshot failed (${error?.message ?? error}); continuing with DOM-only capture`);
-    return null;
-  }
-}
-function asString(value) {
-  return typeof value === "string" ? value : void 0;
-}
-function formatCaptureFailure(error) {
-  const resolved = classifyCaptureError(error);
-  if (resolved.code === "PLAYWRIGHT_NOT_FOUND") {
-    return [
-      "Playwright not resolvable.",
-      "Playwright runtime not found in this project.",
-      "Try:",
-      "  npm install",
-      "  npx playwright install chromium"
-    ];
-  }
-  if (resolved.code === "BROWSER_NOT_INSTALLED") {
-    return [
-      "Browser not installed.",
-      "Playwright resolved, but Chromium is not installed for this project.",
-      "Try:",
-      "  npx playwright install chromium"
-    ];
-  }
-  if (resolved.code === "PAGE_LOAD_FAILED") {
-    return [
-      "Page load failed.",
-      resolved.message
-    ];
-  }
-  return [
-    "Capture failed.",
-    resolved.message
-  ];
-}
-function classifyCaptureError(error) {
-  if (error instanceof CaptureRuntimeError) {
-    return error;
-  }
-  const message = errorMessage(error);
-  if (isBrowserInstallError(message)) {
-    return new CaptureRuntimeError(
-      "BROWSER_NOT_INSTALLED",
-      "Playwright resolved, but Chromium is not installed for this project.",
-      { cause: error }
-    );
-  }
-  if (isPlaywrightNotFoundError(message)) {
-    return new CaptureRuntimeError(
-      "PLAYWRIGHT_NOT_FOUND",
-      "Playwright runtime not found in this project.",
-      { cause: error }
-    );
-  }
-  return new CaptureRuntimeError("CAPTURE_FAILED", message || "Unknown capture failure.", { cause: error });
-}
-function isBrowserInstallError(message) {
-  return /Executable doesn't exist|browserType\.launch: Executable doesn't exist|Please run the following command|playwright install/i.test(message);
-}
-function isPlaywrightNotFoundError(message) {
-  return /Playwright runtime not found|Cannot find package ['"](?:@playwright\/test|playwright-core)['"]/i.test(message);
-}
-function errorMessage(error) {
-  if (error instanceof Error) return error.message;
-  return String(error ?? "");
-}
-
 // src/core/report.ts
 import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join4 } from "path";
+import { join as join3 } from "path";
 function printCaptureReport(elementMap, analysis) {
   console.log("");
   console.log("=".repeat(60));
@@ -2845,10 +2593,10 @@ function printCaptureReport(elementMap, analysis) {
 function saveCaptureJson(elementMap, analysis, outputDir = ".cementic/capture") {
   mkdirSync3(outputDir, { recursive: true });
   const fileName = `capture-${slugify(elementMap.url)}-${Date.now()}.json`;
-  const filePath = join4(outputDir, fileName);
+  const filePath = join3(outputDir, fileName);
   writeFileSync3(filePath, JSON.stringify({
     _meta: {
-      version: "0.2.7",
+      version: "0.2.15",
       generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
       tool: "@cementic/cementic-test"
     },
@@ -2887,7 +2635,7 @@ function buildCasesMarkdown(analysis) {
 function saveCasesMarkdown(analysis, outputDir = "cases", fileName) {
   mkdirSync3(outputDir, { recursive: true });
   const resolvedFileName = fileName ?? `${slugify(analysis.feature || analysis.url)}.md`;
-  const filePath = join4(outputDir, resolvedFileName);
+  const filePath = join3(outputDir, resolvedFileName);
   writeFileSync3(filePath, buildCasesMarkdown(analysis));
   return filePath;
 }
@@ -2895,7 +2643,7 @@ function saveSpecPreview(analysis, outputDir = "tests/preview") {
   if (analysis.scenarios.length === 0) return null;
   mkdirSync3(outputDir, { recursive: true });
   const fileName = `spec-preview-${slugify(analysis.url)}-${Date.now()}.spec.cjs`;
-  const filePath = join4(outputDir, fileName);
+  const filePath = join3(outputDir, fileName);
   const lines = [];
   lines.push("/**");
   lines.push(" * CementicTest Capture Preview");
@@ -3028,7 +2776,7 @@ async function runTcInteractive(params) {
   });
   mkdirSync4("cases", { recursive: true });
   const fileName = `${prefix.toLowerCase()}-${slugify2(feature)}.md`;
-  const fullPath = join5("cases", fileName);
+  const fullPath = join4("cases", fileName);
   let markdown;
   let pageSummary = void 0;
   if (params.useAi) {
@@ -3182,15 +2930,15 @@ function reportCmd() {
 // src/commands/serve.ts
 import { Command as Command6 } from "commander";
 import { spawn as spawn3 } from "child_process";
-import { existsSync as existsSync3 } from "fs";
-import { join as join6 } from "path";
+import { existsSync as existsSync2 } from "fs";
+import { join as join5 } from "path";
 function serveCmd() {
   const cmd = new Command6("serve").description("Serve the Allure report").action(() => {
     console.log("\u{1F4CA} Serving Allure report...");
-    const localAllureBin = join6(process.cwd(), "node_modules", "allure-commandline", "bin", "allure");
+    const localAllureBin = join5(process.cwd(), "node_modules", "allure-commandline", "bin", "allure");
     let executable = "npx";
     let args = ["allure", "serve", "./allure-results"];
-    if (existsSync3(localAllureBin)) {
+    if (existsSync2(localAllureBin)) {
       executable = "node";
       args = [localAllureBin, "serve", "./allure-results"];
     }
@@ -3213,9 +2961,9 @@ function serveCmd() {
 // src/commands/flow.ts
 import { Command as Command7 } from "commander";
 import { spawn as spawn4 } from "child_process";
-import { resolve as resolve4 } from "path";
+import { resolve as resolve3 } from "path";
 function runStep(cmd, args, stepName) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve4, reject) => {
     console.log(`
 \u{1F30A} Flow Step: ${stepName}`);
     console.log(`> ${cmd} ${args.join(" ")}`);
@@ -3225,7 +2973,7 @@ function runStep(cmd, args, stepName) {
     });
     child.on("exit", (code) => {
       if (code === 0) {
-        resolve5();
+        resolve4();
       } else {
         reject(new Error(`${stepName} failed with exit code ${code}`));
       }
@@ -3234,7 +2982,7 @@ function runStep(cmd, args, stepName) {
 }
 function flowCmd() {
   const cmd = new Command7("flow").description("End-to-end flow: Normalize -> Generate -> Run Tests").argument("[casesDir]", "Directory containing test cases", "./cases").option("--lang <lang>", "Target language (ts|js)", "ts").option("--no-run", "Skip running tests").action(async (casesDir, opts) => {
-    const cliBin = resolve4(process.argv[1]);
+    const cliBin = resolve3(process.argv[1]);
     try {
       await runStep(process.execPath, [cliBin, "normalize", casesDir], "Normalize Cases");
       await runStep(process.execPath, [cliBin, "gen", "--lang", opts.lang], "Generate Tests");
@@ -3255,8 +3003,8 @@ function flowCmd() {
 
 // src/commands/ci.ts
 import { Command as Command8 } from "commander";
-import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync5, existsSync as existsSync4 } from "fs";
-import { join as join7 } from "path";
+import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync5, existsSync as existsSync3 } from "fs";
+import { join as join6 } from "path";
 var WORKFLOW_CONTENT = `name: Playwright Tests
 on:
   push:
@@ -3287,15 +3035,15 @@ jobs:
 `;
 function ciCmd() {
   const cmd = new Command8("ci").description("Generate GitHub Actions workflow for CI").action(() => {
-    const githubDir = join7(process.cwd(), ".github");
-    const workflowsDir = join7(githubDir, "workflows");
-    const workflowFile = join7(workflowsDir, "cementic.yml");
+    const githubDir = join6(process.cwd(), ".github");
+    const workflowsDir = join6(githubDir, "workflows");
+    const workflowFile = join6(workflowsDir, "cementic.yml");
     console.log("\u{1F916} Setting up CI/CD workflow...");
-    if (!existsSync4(workflowsDir)) {
+    if (!existsSync3(workflowsDir)) {
       mkdirSync5(workflowsDir, { recursive: true });
       console.log(`Created directory: ${workflowsDir}`);
     }
-    if (existsSync4(workflowFile)) {
+    if (existsSync3(workflowFile)) {
       console.warn(`\u26A0\uFE0F  Workflow file already exists at ${workflowFile}. Skipping.`);
       return;
     }
@@ -3309,8 +3057,8 @@ function ciCmd() {
 }
 
 // src/cli.ts
-var require3 = createRequire2(import.meta.url);
-var { version } = require3("../package.json");
+var require2 = createRequire(import.meta.url);
+var { version } = require2("../package.json");
 var program = new Command9();
 program.name("ct").description("CementicTest CLI: cases \u2192 normalized \u2192 POM tests \u2192 Playwright").version(version);
 program.addCommand(newCmd());