@piwitests/reporter 0.55.0 → 0.57.0

package/dist/cli/index.js

@@ -24,8 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/cli/ai.ts
-var path5 = __toESM(require("path"));
-var import_node_child_process = require("child_process");
+var path6 = __toESM(require("path"));
 
 // src/internal/ai/check.ts
 var fs2 = __toESM(require("fs"));
@@ -38,8 +37,8 @@ var path2 = __toESM(require("path"));
 // src/internal/capture/locator-healing.ts
 var path = __toESM(require("path"));
 
-// ../core/src/locator-methods.ts
-var LOCATOR_BUILDER_METHODS = [
+// ../core/src/locator-chain.ts
+var LOCATING_METHODS = /* @__PURE__ */ new Set([
   "getByRole",
   "getByTestId",
   "getByText",
@@ -47,677 +46,565 @@ var LOCATOR_BUILDER_METHODS = [
   "getByPlaceholder",
   "getByAltText",
   "getByTitle",
-  "locator"
-];
-
-// ../core/src/locator-generation.ts
-function classifyCssStability(className) {
-  if (/[a-f0-9]{8,}/i.test(className)) return 10;
-  if (/^(?:css|sc|emotion|styled)-/i.test(className)) return 15;
-  if (/^(bg|text|border|shadow|opacity|font|w-|h-|m[tblrxy]?-|p[tblrxy]?-|flex|grid|gap|rounded|absolute|relative|fixed|sticky|block|inline|hidden|overflow|z-|top-|right-|bottom-|left-|inset-|justify-|items-|self-|content-|order-|col-|row-)/.test(
-    className
-  ))
-    return 25;
-  if (/__/.test(className) || /--/.test(className)) return 35;
-  if (/^[a-z]+(-[a-z]+)+$/.test(className)) return 40;
-  if (/^[a-z]+[A-Z][a-zA-Z]+$/.test(className)) return 40;
-  if (className.includes("_")) return 15;
-  if (/^[a-z]+-[a-z0-9]{5,}$/.test(className) && /[0-9]/.test(className)) return 15;
-  return 15;
-}
-function isAutoGenerated(value) {
-  if (/^[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$/i.test(value)) return true;
-  if (/^[a-f0-9]{8,}$/i.test(value)) return true;
-  if (/^[a-z]+-\d{4,}$/.test(value)) return true;
-  if (/^(tab|panel|input|select|option|dialog|modal|popup|tooltip|menu|listbox|combobox|checkbox|radio|textarea|button|field|label|accordion|collapse|step|slider|toggle|switch|dropdown|overlay|portal|layer)-\d+$/i.test(
-    value
-  )) {
-    return true;
-  }
-  if (/^(emotion-|styled-|css-|sc-)/.test(value)) return true;
-  if (value.startsWith("ng-")) return true;
-  if (/^(radix-|headlessui-|mui-|mantine-|chakra-|reka-|bits-|downshift-|react-aria|el-id-)/i.test(value)) return true;
-  if (/^:r[0-9a-z]+:$/i.test(value) || /^«r[0-9a-z]+»$/i.test(value)) return true;
-  if (/(^|[-_:])v-\d+(-\d+)+$/.test(value) || /(^|[-_:])v-\d+(-\d+)+[-_:]/.test(value)) return true;
-  return false;
-}
-
-// src/internal/capture/locator-healing.ts
-var LOCATOR_METHODS = [...LOCATOR_BUILDER_METHODS];
-var ACTION_METHODS = [
-  "click",
-  "fill",
-  "check",
-  "uncheck",
-  "selectOption",
-  "dblclick",
-  "tap",
-  "hover",
-  "press",
-  "type",
-  "pressSequentially",
-  "clear",
-  "setInputFiles",
-  "dragTo",
-  "focus",
-  "blur",
-  "scrollIntoViewIfNeeded",
-  "dispatchEvent",
-  "selectText",
-  // Not an action, but a successful waitFor proves the element resolved — the
-  // closest capture hook available for assertion-style usage of a locator.
-  "waitFor"
-];
-var LOCATOR_CREATING_CHAINS = new Set(LOCATOR_METHODS);
-
-// src/internal/ai/artifact.ts
-var ARTIFACT_VERSION = 1;
-var LOCATOR_METHOD_SET = new Set(LOCATOR_METHODS);
-var ACTION_METHOD_SET = new Set(ACTION_METHODS);
-var POSTCONDITION_ASSERTS = /* @__PURE__ */ new Set([
+  "locator",
+  "frameLocator"
+]);
+var NARROWING_METHODS = /* @__PURE__ */ new Set([
+  "filter",
+  "first",
+  "last",
+  "nth",
+  "and",
+  "or",
   "visible",
-  "hidden",
-  "attached",
-  "url"
+  "contentFrame",
+  "owner"
 ]);
-function sortDeep(value) {
-  if (Array.isArray(value)) return value.map(sortDeep);
-  if (value !== null && typeof value === "object") {
-    const out = {};
-    for (const key of Object.keys(value).sort()) {
-      const v = value[key];
-      if (v !== void 0) out[key] = sortDeep(v);
-    }
-    return out;
+var LOCATOR_CHAIN_METHODS = /* @__PURE__ */ new Set([...LOCATING_METHODS, ...NARROWING_METHODS]);
+var LocatorParseError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "LocatorParseError";
   }
-  return value;
-}
-function serializeEntry(entry) {
-  return `${JSON.stringify(sortDeep(entry), null, 2)}
-`;
-}
-var ArtifactError = class extends Error {
 };
-function assert(condition, message) {
-  if (!condition) throw new ArtifactError(message);
-}
-function validateStructuredLocator(value, where) {
-  assert(value !== null && typeof value === "object", `${where}: locator must be an object`);
-  const loc = value;
-  assert(typeof loc.method === "string", `${where}: locator.method must be a string`);
-  assert(LOCATOR_METHOD_SET.has(loc.method), `${where}: locator method "${String(loc.method)}" is not allowlisted`);
-  assert(Array.isArray(loc.args), `${where}: locator.args must be an array`);
-  if (loc.chain !== void 0) {
-    assert(Array.isArray(loc.chain), `${where}: locator.chain must be an array`);
-    loc.chain.forEach((child, i) => validateStructuredLocator(child, `${where}.chain[${i}]`));
+var SIMPLE_ESCAPES = {
+  n: "\n",
+  t: "	",
+  r: "\r",
+  b: "\b",
+  f: "\f",
+  v: "\v",
+  "0": "\0"
+};
+var Parser = class {
+  constructor(src) {
+    this.src = src;
+    this.i = 0;
   }
-}
-function validateRunStep(value, where) {
-  assert(value !== null && typeof value === "object", `${where}: step must be an object`);
-  const step = value;
-  validateStructuredLocator(step.locator, `${where}.locator`);
-  assert(typeof step.action === "string", `${where}: action must be a string`);
-  assert(ACTION_METHOD_SET.has(step.action), `${where}: action "${String(step.action)}" is not allowlisted`);
-  if (step.value !== void 0) assert(typeof step.value === "string", `${where}: value must be a string`);
-  if (step.optional !== void 0) assert(typeof step.optional === "boolean", `${where}: optional must be a boolean`);
-  if (step.waitForResponse !== void 0) {
-    assert(typeof step.waitForResponse === "string", `${where}: waitForResponse must be a string`);
+  parseTopLevel() {
+    const chain = this.parseChain();
+    this.skipSpace();
+    if (this.i < this.src.length) this.fail("unexpected text");
+    return chain;
   }
-}
-function validatePostcondition(value) {
-  assert(value !== null && typeof value === "object", "postcondition must be an object");
-  const post = value;
-  assert(
-    POSTCONDITION_ASSERTS.has(post.assert),
-    `postcondition.assert "${String(post.assert)}" is not supported`
-  );
-  if (post.assert === "url") {
-    assert(typeof post.url === "string", "postcondition.url must be a string for a url assert");
-  } else {
-    validateStructuredLocator(post.locator, "postcondition.locator");
+  fail(message) {
+    throw new LocatorParseError(`${message} at "${this.src.slice(this.i, this.i + 20)}"`);
   }
-}
-function parseEntry(text) {
-  let raw;
-  try {
-    raw = JSON.parse(text);
-  } catch (error) {
-    throw new ArtifactError(`entry is not valid JSON: ${error.message}`);
+  skipSpace() {
+    while (this.i < this.src.length && /\s/.test(this.src[this.i])) this.i++;
   }
-  assert(raw !== null && typeof raw === "object", "entry must be an object");
-  const obj = raw;
-  assert(obj.version === ARTIFACT_VERSION, `unsupported entry version ${String(obj.version)}`);
-  assert(typeof obj.template === "string", "entry.template must be a string");
-  if (obj.kind === "locator") {
-    validateStructuredLocator(obj.locator, "entry.locator");
-    return obj;
+  peek() {
+    return this.src[this.i];
   }
-  if (obj.kind === "run") {
-    assert(Array.isArray(obj.steps), "entry.steps must be an array");
-    obj.steps.forEach((step, i) => validateRunStep(step, `entry.steps[${i}]`));
-    validatePostcondition(obj.postcondition);
-    return obj;
+  expect(ch) {
+    this.skipSpace();
+    if (this.src[this.i] !== ch) this.fail(`expected "${ch}"`);
+    this.i++;
   }
-  throw new ArtifactError(`unsupported entry kind "${String(obj.kind)}"`);
-}
-
-// src/internal/ai/keys.ts
-var crypto = __toESM(require("crypto"));
-var path3 = __toESM(require("path"));
-var DEFAULT_AI_DIR = "__piwi__";
-function normalizeTemplate(template) {
-  return template.trim().replace(/\s+/g, " ").toLowerCase();
-}
-
-// src/internal/ai/check.ts
-function findEntryFiles(root, dir) {
-  const out = [];
-  const walk = (current) => {
-    let items;
-    try {
-      items = fs2.readdirSync(current, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    for (const item of items) {
-      const full = path4.join(current, item.name);
-      if (item.isDirectory()) {
-        walk(full);
-      } else if (item.isFile() && item.name.endsWith(".json")) {
-        const specFileDir = path4.dirname(full);
-        const dirName = path4.basename(path4.dirname(specFileDir));
-        if (dirName !== dir) continue;
-        const specDir = path4.dirname(path4.dirname(specFileDir));
-        const specFile = path4.join(specDir, path4.basename(specFileDir));
-        out.push({ file: full, specFile, testSlug: item.name.split(".")[0] });
-      }
-    }
-  };
-  walk(root);
-  return out;
-}
-function readTextOr(file, fallback) {
-  try {
-    return fs2.readFileSync(file, "utf8");
-  } catch {
-    return fallback;
+  identifier() {
+    const m = /^[A-Za-z_$][\w$]*/.exec(this.src.slice(this.i));
+    if (!m) this.fail("expected a name");
+    this.i += m[0].length;
+    return m[0];
   }
-}
-function checkAiTree(root, opts = {}) {
-  const dir = opts.dir ?? DEFAULT_AI_DIR;
-  const findings = [];
-  const rel = (file) => path4.relative(root, file).split(path4.sep).join("/");
-  const sourceCache = /* @__PURE__ */ new Map();
-  const duplicates = /* @__PURE__ */ new Map();
-  for (const found of findEntryFiles(root, dir)) {
-    const text = readTextOr(found.file, null);
-    if (text === null) continue;
-    let templateNormalized = null;
-    try {
-      const entry = parseEntry(text);
-      templateNormalized = normalizeTemplate(entry.template);
-      if (serializeEntry(entry) !== text) {
-        findings.push({
-          severity: "error",
-          kind: "non-canonical",
-          file: rel(found.file),
-          message: "file is not in canonical form \u2014 re-author it with `piwi ai resolve --update-ai`"
-        });
+  /**
+   * A chain of calls joined by `.`. With `lenient`, parsing stops before the
+   * first link that doesn't parse instead of failing, so a chain followed by
+   * other text (an error message) is read up to where it ends. `spans` receives
+   * where each top-level call starts and ends.
+   */
+  parseChain(opts = {}) {
+    this.skipSpace();
+    const calls = [];
+    for (; ; ) {
+      const before = this.i;
+      if (calls.length > 0) this.i++;
+      this.skipSpace();
+      const start = this.i;
+      try {
+        calls.push(this.parseCall(calls.length === 0));
+      } catch (error) {
+        if (!opts.lenient || calls.length === 0) throw error;
+        this.i = before;
+        break;
       }
-      if (!sourceCache.has(found.specFile)) sourceCache.set(found.specFile, readTextOr(found.specFile, null));
-      const source = sourceCache.get(found.specFile) ?? null;
-      if (source === null) {
-        findings.push({
-          severity: "error",
-          kind: "orphan",
-          file: rel(found.file),
-          message: `spec file is gone (${rel(found.specFile)}) \u2014 the entry is orphaned`
-        });
-      } else if (!source.includes(entry.template.trim())) {
-        findings.push({
-          severity: "error",
-          kind: "orphan",
-          file: rel(found.file),
-          message: `template "${entry.template}" no longer appears in ${rel(found.specFile)} \u2014 the entry is orphaned`
-        });
+      opts.spans?.push({ start, end: this.i });
+      const end = this.i;
+      this.skipSpace();
+      if (this.peek() !== ".") {
+        this.i = end;
+        break;
       }
-    } catch (error) {
-      findings.push({
-        severity: "error",
-        kind: "invalid",
-        file: rel(found.file),
-        message: `not a valid entry: ${error.message}`
-      });
     }
-    if (templateNormalized !== null) {
-      const key = `${found.specFile}::${found.testSlug}::${templateNormalized}`;
-      const list = duplicates.get(key) ?? [];
-      list.push(rel(found.file));
-      duplicates.set(key, list);
+    return { calls };
+  }
+  /** Where the parser stopped. */
+  get position() {
+    return this.i;
+  }
+  parseCall(first) {
+    this.skipSpace();
+    const method = this.identifier();
+    if (!LOCATOR_CHAIN_METHODS.has(method)) this.fail(`unsupported method ${method}()`);
+    if (first && !LOCATING_METHODS.has(method)) this.fail(`${method}() needs a locator before it`);
+    this.expect("(");
+    const args = [];
+    this.skipSpace();
+    if (this.peek() === ")") {
+      this.i++;
+      return { method, args };
+    }
+    for (; ; ) {
+      args.push(this.parseValue());
+      this.skipSpace();
+      if (this.peek() === ",") {
+        this.i++;
+        this.skipSpace();
+        if (this.peek() === ")") {
+          this.i++;
+          break;
+        }
+        continue;
+      }
+      this.expect(")");
+      break;
     }
+    return { method, args };
   }
-  for (const files of duplicates.values()) {
-    if (files.length < 2) continue;
-    for (const file of files) {
-      findings.push({
-        severity: "warning",
-        kind: "duplicate-template",
-        file,
-        message: `duplicate template within the same test \u2014 consider distinct phrasings (${files.join(", ")})`
-      });
+  parseValue() {
+    this.skipSpace();
+    const ch = this.peek();
+    if (ch === "'" || ch === '"' || ch === "`") return { type: "string", value: this.parseString() };
+    if (ch === "/") return this.parseRegex();
+    if (ch === "{") return this.parseObject();
+    if (ch !== void 0 && /[-\d]/.test(ch)) {
+      const m = /^-?\d+(?:\.\d+)?/.exec(this.src.slice(this.i));
+      if (!m) this.fail("expected a number");
+      this.i += m[0].length;
+      return { type: "number", value: Number(m[0]) };
+    }
+    const rest = this.src.slice(this.i);
+    if (/^true\b/.test(rest)) {
+      this.i += 4;
+      return { type: "boolean", value: true };
+    }
+    if (/^false\b/.test(rest)) {
+      this.i += 5;
+      return { type: "boolean", value: false };
     }
+    if (/^[A-Za-z_$]/.test(rest)) return { type: "chain", chain: this.parseChain() };
+    return this.fail("expected a value");
   }
-  return findings.sort((a, b) => a.file < b.file ? -1 : a.file > b.file ? 1 : 0);
+  /** A quoted string, decoding the escapes `JSON.stringify` and JavaScript produce. */
+  parseString() {
+    const quote3 = this.src[this.i];
+    let out = "";
+    this.i++;
+    while (this.i < this.src.length) {
+      const c = this.src[this.i];
+      if (c === quote3) {
+        this.i++;
+        return out;
+      }
+      if (c !== "\\") {
+        out += c;
+        this.i++;
+        continue;
+      }
+      const next = this.src[this.i + 1];
+      if (next === void 0) break;
+      const simple = SIMPLE_ESCAPES[next];
+      if (simple !== void 0) {
+        out += simple;
+        this.i += 2;
+        continue;
+      }
+      const hex = next === "u" && this.src[this.i + 2] === "{" ? /^u\{([0-9a-fA-F]{1,6})\}/.exec(this.src.slice(this.i + 1)) : next === "u" ? /^u([0-9a-fA-F]{4})/.exec(this.src.slice(this.i + 1)) : next === "x" ? /^x([0-9a-fA-F]{2})/.exec(this.src.slice(this.i + 1)) : null;
+      if (hex) {
+        out += String.fromCodePoint(parseInt(hex[1], 16));
+        this.i += 1 + hex[0].length;
+        continue;
+      }
+      if (next === "u" || next === "x") this.fail("malformed escape");
+      out += next;
+      this.i += 2;
+    }
+    return this.fail("unterminated string");
+  }
+  parseRegex() {
+    let j = this.i + 1;
+    let inClass = false;
+    while (j < this.src.length) {
+      const c = this.src[j];
+      if (c === "\\") {
+        j += 2;
+        continue;
+      }
+      if (c === "[") inClass = true;
+      else if (c === "]") inClass = false;
+      else if (c === "/" && !inClass) break;
+      j++;
+    }
+    if (j >= this.src.length) this.fail("unterminated regex");
+    const source = this.src.slice(this.i + 1, j);
+    const flags = /^[a-z]*/.exec(this.src.slice(j + 1))[0];
+    this.i = j + 1 + flags.length;
+    return { type: "regex", source, flags };
+  }
+  parseObject() {
+    this.expect("{");
+    const entries = [];
+    for (; ; ) {
+      this.skipSpace();
+      if (this.peek() === "}") {
+        this.i++;
+        break;
+      }
+      const ch = this.peek();
+      const key = ch === "'" || ch === '"' ? this.parseString() : this.identifier();
+      this.expect(":");
+      entries.push([key, this.parseValue()]);
+      this.skipSpace();
+      if (this.peek() === ",") {
+        this.i++;
+        continue;
+      }
+      this.expect("}");
+      break;
+    }
+    return { type: "object", entries };
+  }
+};
+function parseLocatorChain(expr) {
+  const trimmed = expr.trim().replace(/^(?:await\s+)?(?:this\.)?page\./, "");
+  if (!trimmed) throw new LocatorParseError("empty expression");
+  return new Parser(trimmed).parseTopLevel();
 }
-function hasBlockingFindings(findings) {
-  return findings.some((f) => f.severity === "error");
+function tryParseLocatorChain(expr) {
+  try {
+    return parseLocatorChain(expr);
+  } catch {
+    return null;
+  }
+}
+function quoteJsString(value) {
+  const json = JSON.stringify(value).slice(1, -1);
+  return `'${json.replace(/\\"/g, '"').replace(/'/g, "\\'").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029")}'`;
+}
+function renderArg(arg) {
+  switch (arg.type) {
+    case "string":
+      return quoteJsString(arg.value);
+    case "regex":
+      return `/${arg.source}/${arg.flags}`;
+    case "number":
+    case "boolean":
+      return String(arg.value);
+    case "object":
+      return arg.entries.length === 0 ? "{}" : `{ ${arg.entries.map(([k, v]) => `${/^[A-Za-z_$][\w$]*$/.test(k) ? k : quoteJsString(k)}: ${renderArg(v)}`).join(", ")} }`;
+    case "chain":
+      return renderLocatorChain(arg.chain);
+  }
+}
+function renderLocatorCall(call) {
+  return `${call.method}(${call.args.map(renderArg).join(", ")})`;
+}
+function renderLocatorChain(chain) {
+  return chain.calls.map(renderLocatorCall).join(".");
+}
+function canonicalLocator(expr) {
+  const chain = tryParseLocatorChain(expr);
+  return chain ? renderLocatorChain(chain) : null;
 }
 
-// src/cli/ai.ts
-var EXIT_OK = 0;
-var EXIT_ISSUES = 1;
-var EXIT_ERROR = 2;
-var USAGE = `
-Usage: piwi ai <command> [options]
-
-Commands:
-  check    Scan committed AI-step entries for orphans, non-canonical files and
-           duplicate templates. Read-only; exits 1 when issues are found.
-  resolve  Author missing entries by running the suite in resolve mode against
-           the configured authoring server (forces --workers=1).
-  prune    Delete orphaned/dormant entries.
+// ../core/src/locator-fingerprint.ts
+var FUNCTION_WORDS = new Set(
+  "the and for with from your you our this that les des une pour avec par sur aux dans vos votre nos notre".split(" ")
+);
 
-Options (check):
-  --dir <name>   Entry directory name per spec        (env PIWI_AI_DIR, default ${DEFAULT_AI_DIR})
-  --cwd <path>   Root to scan                          (default: current directory)
-  --json         Emit findings as JSON
-
-Options (resolve):
-  --grep <re>       Only author entries for matching tests
-  --project <name>  Author under one Playwright project (a resolve profile)
-  --env K=V         Extra env for the run (repeatable \u2014 flags/viewport profiles)
-  --update-ai       Re-author entries that already exist
-                    (needs PIWI_DASHBOARD_URL / PIWI_API_KEY for the server)
+// ../core/src/locator-methods.ts
+var LOCATOR_BUILDER_METHODS = [
+  "getByRole",
+  "getByTestId",
+  "getByText",
+  "getByLabel",
+  "getByPlaceholder",
+  "getByAltText",
+  "getByTitle",
+  "locator"
+];
 
-Exit codes:
-  0  clean (or --help)
-  1  hygiene issues found
-  2  bad arguments / command unavailable
-`.trim();
-function readOption(argv, name) {
-  const withEquals = argv.find((arg) => arg.startsWith(`${name}=`));
-  if (withEquals) return withEquals.slice(name.length + 1);
-  const index = argv.indexOf(name);
-  if (index === -1) return void 0;
-  const value = argv[index + 1];
-  return value && !value.startsWith("--") ? value : void 0;
+// ../core/src/locator-generation.ts
+function classifyCssStability(className) {
+  if (/[a-f0-9]{8,}/i.test(className)) return 10;
+  if (/^(?:css|sc|emotion|styled)-/i.test(className)) return 15;
+  if (/^(bg|text|border|shadow|opacity|font|w-|h-|m[tblrxy]?-|p[tblrxy]?-|flex|grid|gap|rounded|absolute|relative|fixed|sticky|block|inline|hidden|overflow|z-|top-|right-|bottom-|left-|inset-|justify-|items-|self-|content-|order-|col-|row-)/.test(
+    className
+  ))
+    return 25;
+  if (/__/.test(className) || /--/.test(className)) return 35;
+  if (/^[a-z]+(-[a-z]+)+$/.test(className)) return 40;
+  if (/^[a-z]+[A-Z][a-zA-Z]+$/.test(className)) return 40;
+  if (className.includes("_")) return 15;
+  if (/^[a-z]+-[a-z0-9]{5,}$/.test(className) && /[0-9]/.test(className)) return 15;
+  return 15;
 }
-function readAll(argv, name) {
-  const values = [];
-  for (let i = 0; i < argv.length; i++) {
-    if (argv[i].startsWith(`${name}=`)) values.push(argv[i].slice(name.length + 1));
-    else if (argv[i] === name && argv[i + 1] && !argv[i + 1].startsWith("--")) values.push(argv[++i]);
+function isAutoGenerated(value) {
+  if (/^[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$/i.test(value)) return true;
+  if (/^[a-f0-9]{8,}$/i.test(value)) return true;
+  if (/^[a-z]+-\d{4,}$/.test(value)) return true;
+  if (/^(tab|panel|input|select|option|dialog|modal|popup|tooltip|menu|listbox|combobox|checkbox|radio|textarea|button|field|label|accordion|collapse|step|slider|toggle|switch|dropdown|overlay|portal|layer)-\d+$/i.test(
+    value
+  )) {
+    return true;
   }
-  return values;
-}
-function formatFinding(finding) {
-  const mark = finding.severity === "error" ? "\u2716" : "\u26A0";
-  return `${mark} ${finding.file}
-    ${finding.kind}: ${finding.message}`;
+  if (/^(emotion-|styled-|css-|sc-)/.test(value)) return true;
+  if (value.startsWith("ng-")) return true;
+  if (/^(radix-|headlessui-|mui-|mantine-|chakra-|reka-|bits-|downshift-|react-aria|el-id-)/i.test(value)) return true;
+  if (/^:r[0-9a-z]+:$/i.test(value) || /^«r[0-9a-z]+»$/i.test(value)) return true;
+  if (/(^|[-_:])v-\d+(-\d+)+$/.test(value) || /(^|[-_:])v-\d+(-\d+)+[-_:]/.test(value)) return true;
+  return false;
 }
-function runCheck(argv, env) {
-  const root = path5.resolve(readOption(argv, "--cwd") ?? process.cwd());
-  const dir = readOption(argv, "--dir") ?? env.PIWI_AI_DIR ?? DEFAULT_AI_DIR;
-  let findings;
-  try {
-    findings = checkAiTree(root, { dir });
-  } catch (error) {
-    console.error(`piwi ai check: ${error.message}`);
-    return EXIT_ERROR;
-  }
-  if (argv.includes("--json")) {
-    console.log(JSON.stringify({ findings }, null, 2));
-  } else if (findings.length === 0) {
-    console.log("piwi ai check: no issues found.");
-  } else {
-    for (const finding of findings) console.log(formatFinding(finding));
-    const errors = findings.filter((f) => f.severity === "error").length;
-    const warnings = findings.length - errors;
-    console.log(`
-${errors} error(s), ${warnings} warning(s).`);
+
+// src/internal/capture/locator-healing.ts
+var LOCATOR_METHODS = [...LOCATOR_BUILDER_METHODS];
+var ACTION_METHODS = [
+  "click",
+  "fill",
+  "check",
+  "uncheck",
+  "selectOption",
+  "dblclick",
+  "tap",
+  "hover",
+  "press",
+  "type",
+  "pressSequentially",
+  "clear",
+  "setInputFiles",
+  "dragTo",
+  "focus",
+  "blur",
+  "scrollIntoViewIfNeeded",
+  "dispatchEvent",
+  "selectText",
+  // Not an action, but a successful waitFor proves the element resolved — the
+  // closest capture hook available for assertion-style usage of a locator.
+  "waitFor"
+];
+var LOCATOR_CREATING_CHAINS = new Set(LOCATOR_METHODS);
+
+// src/internal/ai/artifact.ts
+var ARTIFACT_VERSION = 1;
+var LOCATOR_METHOD_SET = new Set(LOCATOR_METHODS);
+var ACTION_METHOD_SET = new Set(ACTION_METHODS);
+var POSTCONDITION_ASSERTS = /* @__PURE__ */ new Set([
+  "visible",
+  "hidden",
+  "attached",
+  "url"
+]);
+function sortDeep(value) {
+  if (Array.isArray(value)) return value.map(sortDeep);
+  if (value !== null && typeof value === "object") {
+    const out = {};
+    for (const key of Object.keys(value).sort()) {
+      const v = value[key];
+      if (v !== void 0) out[key] = sortDeep(v);
+    }
+    return out;
   }
-  return hasBlockingFindings(findings) ? EXIT_ISSUES : EXIT_OK;
+  return value;
 }
-function buildResolveInvocation(argv, env) {
-  const args = ["playwright", "test"];
-  const grep = readOption(argv, "--grep");
-  if (grep) args.push("--grep", grep);
-  const project = readOption(argv, "--project");
-  if (project) args.push("--project", project);
-  args.push("--workers=1");
-  const childEnv = { ...env, PIWI_AI: "resolve" };
-  if (argv.includes("--update-ai")) childEnv.PIWI_AI_UPDATE = "true";
-  for (const pair of readAll(argv, "--env")) {
-    const eq = pair.indexOf("=");
-    if (eq > 0) childEnv[pair.slice(0, eq)] = pair.slice(eq + 1);
+function serializeEntry(entry) {
+  return `${JSON.stringify(sortDeep(entry), null, 2)}
+`;
+}
+var ArtifactError = class extends Error {
+};
+function assert(condition, message) {
+  if (!condition) throw new ArtifactError(message);
+}
+function validateStructuredLocator(value, where) {
+  assert(value !== null && typeof value === "object", `${where}: locator must be an object`);
+  const loc = value;
+  assert(typeof loc.method === "string", `${where}: locator.method must be a string`);
+  assert(LOCATOR_METHOD_SET.has(loc.method), `${where}: locator method "${String(loc.method)}" is not allowlisted`);
+  assert(Array.isArray(loc.args), `${where}: locator.args must be an array`);
+  if (loc.chain !== void 0) {
+    assert(Array.isArray(loc.chain), `${where}: locator.chain must be an array`);
+    loc.chain.forEach((child, i) => validateStructuredLocator(child, `${where}.chain[${i}]`));
   }
-  return { command: "npx", args, env: childEnv };
 }
-function runResolve(argv, env) {
-  if (!env.PIWI_DASHBOARD_URL) {
-    console.error("piwi ai resolve: set PIWI_DASHBOARD_URL (the authoring server) before resolving.");
-    return EXIT_ERROR;
+function validateRunStep(value, where) {
+  assert(value !== null && typeof value === "object", `${where}: step must be an object`);
+  const step = value;
+  validateStructuredLocator(step.locator, `${where}.locator`);
+  assert(typeof step.action === "string", `${where}: action must be a string`);
+  assert(ACTION_METHOD_SET.has(step.action), `${where}: action "${String(step.action)}" is not allowlisted`);
+  if (step.value !== void 0) assert(typeof step.value === "string", `${where}: value must be a string`);
+  if (step.optional !== void 0) assert(typeof step.optional === "boolean", `${where}: optional must be a boolean`);
+  if (step.waitForResponse !== void 0) {
+    assert(typeof step.waitForResponse === "string", `${where}: waitForResponse must be a string`);
   }
-  const invocation = buildResolveInvocation(argv, env);
-  const result = (0, import_node_child_process.spawnSync)(invocation.command, invocation.args, { stdio: "inherit", env: invocation.env });
-  if (result.error) {
-    console.error(`piwi ai resolve: ${result.error.message}`);
-    return EXIT_ERROR;
+}
+function validatePostcondition(value) {
+  assert(value !== null && typeof value === "object", "postcondition must be an object");
+  const post = value;
+  assert(
+    POSTCONDITION_ASSERTS.has(post.assert),
+    `postcondition.assert "${String(post.assert)}" is not supported`
+  );
+  if (post.assert === "url") {
+    assert(typeof post.url === "string", "postcondition.url must be a string for a url assert");
+  } else {
+    validateStructuredLocator(post.locator, "postcondition.locator");
   }
-  return result.status ?? EXIT_ERROR;
 }
-async function runAi(argv, env = process.env) {
-  const [sub, ...rest] = argv;
-  if (sub === void 0 || sub === "-h" || sub === "--help") {
-    console.log(USAGE);
-    return EXIT_OK;
+function parseEntry(text) {
+  let raw;
+  try {
+    raw = JSON.parse(text);
+  } catch (error) {
+    throw new ArtifactError(`entry is not valid JSON: ${error.message}`);
   }
-  switch (sub) {
-    case "check":
-      return runCheck(rest, env);
-    case "resolve":
-      return runResolve(rest, env);
-    case "prune":
-      console.error(
-        "piwi ai prune: not available in this build yet. `piwi ai check` lists orphaned entries: delete their files by hand, and re-author a non-canonical one with `piwi ai resolve --update-ai`."
-      );
-      return EXIT_ERROR;
-    default:
-      console.error(`piwi ai: unknown command "${sub}"
-`);
-      console.error(USAGE);
-      return EXIT_ERROR;
+  assert(raw !== null && typeof raw === "object", "entry must be an object");
+  const obj = raw;
+  assert(obj.version === ARTIFACT_VERSION, `unsupported entry version ${String(obj.version)}`);
+  assert(typeof obj.template === "string", "entry.template must be a string");
+  if (obj.kind === "locator") {
+    validateStructuredLocator(obj.locator, "entry.locator");
+    return obj;
+  }
+  if (obj.kind === "run") {
+    assert(Array.isArray(obj.steps), "entry.steps must be an array");
+    obj.steps.forEach((step, i) => validateRunStep(step, `entry.steps[${i}]`));
+    validatePostcondition(obj.postcondition);
+    return obj;
   }
+  throw new ArtifactError(`unsupported entry kind "${String(obj.kind)}"`);
 }
 
-// src/cli/bug.ts
-var fs4 = __toESM(require("fs"));
-var path7 = __toESM(require("path"));
-var import_node_child_process2 = require("child_process");
-var import_node_module = require("module");
-
-// src/internal/config/desktop.ts
-var fs3 = __toESM(require("fs"));
-var os = __toESM(require("os"));
-var path6 = __toESM(require("path"));
-function defaultDesktopConfigPath() {
-  return path6.join(os.homedir(), ".piwi", "desktop.json");
+// src/internal/ai/keys.ts
+var crypto = __toESM(require("crypto"));
+var path3 = __toESM(require("path"));
+var DEFAULT_AI_DIR = "__piwi__";
+function normalizeTemplate(template) {
+  return template.trim().replace(/\s+/g, " ").toLowerCase();
 }
-function readDesktopConfig(filePath2) {
-  try {
-    const parsed = JSON.parse(fs3.readFileSync(filePath2, "utf8"));
-    const url = parsed?.url;
-    const token = parsed?.token;
-    if (typeof url !== "string" || !url) return null;
-    if (typeof token !== "string" || !token) return null;
-    return { url, token };
-  } catch {
-    return null;
-  }
-}
-
-// src/internal/config/env.ts
-var DEFAULTS = {
-  projectName: "default-project",
-  uploadTraces: true,
-  uploadReport: true,
-  liveFileUploads: true,
-  collectScmInfo: true,
-  collectCiInfo: true,
-  collectPerformanceMetrics: true,
-  captureLocators: true,
-  capturePageState: true,
-  // Off by default: the page inventory reads control and link names from every
-  // visited page, so it stays opt-in until a project turns it on.
-  capturePageInventory: false,
-  // Off by default: JavaScript coverage adds time to every test, so a scheduled job opts in.
-  captureCodeReach: false,
-  captureServerTraces: true,
-  captureResources: true,
-  leakCheck: "report",
-  sampleAriaOnPass: true,
-  uploadManifest: true,
-  defaultCapture: true,
-  checkBaseUrl: false,
-  streaming: true,
-  streamingBatchSize: 20,
-  streamingBatchDelay: 2e3,
-  maxStreamBufferBytes: 100 * 1024 * 1024,
-  submitTimeout: 15 * 60 * 1e3,
-  failOnFlakyTests: false,
-  username: null,
-  password: null,
-  apiKey: null,
-  verbose: false
-};
-var PIWI_ENV_KEYS = {
-  serverUrl: "PIWI_DASHBOARD_URL",
-  projectName: "PIWI_PROJECT_NAME",
-  verbose: "PIWI_VERBOSE",
-  apiKey: "PIWI_API_KEY",
-  username: "PIWI_USERNAME",
-  password: "PIWI_PASSWORD",
-  environment: "PIWI_ENVIRONMENT",
-  label: "PIWI_LABEL",
-  runLabel: "PIWI_RUN_LABEL",
-  keep: "PIWI_KEEP",
-  streaming: "PIWI_STREAMING",
-  streamingBatchSize: "PIWI_STREAMING_BATCH_SIZE",
-  streamingBatchDelay: "PIWI_STREAMING_BATCH_DELAY",
-  maxStreamBufferBytes: "PIWI_MAX_STREAM_BUFFER_BYTES",
-  submitTimeout: "PIWI_SUBMIT_TIMEOUT",
-  liveFileUploads: "PIWI_LIVE_FILE_UPLOADS",
-  failOnFlakyTests: "PIWI_FAIL_ON_FLAKY_TESTS",
-  uploadTraces: "PIWI_UPLOAD_TRACES",
-  uploadReport: "PIWI_UPLOAD_REPORT",
-  captureLocators: "PIWI_CAPTURE_LOCATORS",
-  capturePageState: "PIWI_CAPTURE_PAGE_STATE",
-  capturePageInventory: "PIWI_CAPTURE_PAGE_INVENTORY",
-  captureCodeReach: "PIWI_CAPTURE_CODE_REACH",
-  codeReachRoots: "PIWI_CODE_REACH_ROOTS",
-  coverageBrowser: "PIWI_COVERAGE_BROWSER",
-  coverageServer: "PIWI_COVERAGE_SERVER",
-  captureServerTraces: "PIWI_CAPTURE_SERVER_TRACES",
-  captureResources: "PIWI_CAPTURE_RESOURCES",
-  leakCheck: "PIWI_LEAK_CHECK",
-  sampleAriaOnPass: "PIWI_SAMPLE_ARIA_ON_PASS",
-  uploadManifest: "PIWI_UPLOAD_MANIFEST",
-  defaultCapture: "PIWI_DEFAULT_CAPTURE",
-  checkBaseUrl: "PIWI_CHECK_BASE_URL",
-  inspectOnFailure: "PIWI_INSPECT_ON_FAIL",
-  pickLocatorOnFailure: "PIWI_PICK_LOCATOR_ON_FAIL",
-  outputFile: "PIWI_OUTPUT_FILE",
-  aiMode: "PIWI_AI",
-  aiDir: "PIWI_AI_DIR",
-  aiOnMiss: "PIWI_AI_ON_MISS",
-  aiMaxSteps: "PIWI_AI_MAX_FLOW_STEPS",
-  aiMaxSnapshotChars: "PIWI_AI_MAX_SNAPSHOT_CHARS",
-  aiOptionalProbeTimeout: "PIWI_AI_OPTIONAL_PROBE_TIMEOUT",
-  aiResponseWaitTimeout: "PIWI_AI_RESPONSE_WAIT_TIMEOUT",
-  aiScreenshotFallback: "PIWI_AI_SCREENSHOT_FALLBACK"
-};
-var PIWI_DESKTOP_CONFIG_ENV = "PIWI_DESKTOP_CONFIG";
-var PIWI_ORIGIN_ENV = {
-  kind: "PIWI_ORIGIN",
-  ref: "PIWI_ORIGIN_REF"
-};
-function originEnv(kind, ref) {
-  return ref === void 0 ? { [PIWI_ORIGIN_ENV.kind]: kind } : { [PIWI_ORIGIN_ENV.kind]: kind, [PIWI_ORIGIN_ENV.ref]: String(ref) };
-}
-var PIWI_SHARD_ENV = "PIWI_SHARD";
-var PIWI_PROBE_ENV = {
-  flag: "PIWI_PROBE",
-  plan: "PIWI_PROBE_PLAN",
-  results: "PIWI_PROBE_RESULTS",
-  secret: "PIWI_PROBE_SECRET"
-};
-var PIWI_FLAKE_ENV = {
-  plan: "PIWI_FLAKE_PLAN",
-  results: "PIWI_FLAKE_RESULTS"
-};
-var ENV_FALLBACK_SPECS = [
-  { option: "serverUrl", env: PIWI_ENV_KEYS.serverUrl, kind: "string" },
-  { option: "projectName", env: PIWI_ENV_KEYS.projectName, kind: "string" },
-  { option: "apiKey", env: PIWI_ENV_KEYS.apiKey, kind: "string" },
-  { option: "username", env: PIWI_ENV_KEYS.username, kind: "string" },
-  { option: "password", env: PIWI_ENV_KEYS.password, kind: "string" },
-  { option: "environment", env: PIWI_ENV_KEYS.environment, kind: "string" },
-  { option: "label", env: PIWI_ENV_KEYS.label, kind: "string" },
-  { option: "runLabel", env: PIWI_ENV_KEYS.runLabel, kind: "string" },
-  { option: "keep", env: PIWI_ENV_KEYS.keep, kind: "bool" },
-  { option: "streaming", env: PIWI_ENV_KEYS.streaming, kind: "bool" },
-  { option: "streamingBatchSize", env: PIWI_ENV_KEYS.streamingBatchSize, kind: "number" },
-  { option: "streamingBatchDelay", env: PIWI_ENV_KEYS.streamingBatchDelay, kind: "number" },
-  { option: "maxStreamBufferBytes", env: PIWI_ENV_KEYS.maxStreamBufferBytes, kind: "number" },
-  { option: "submitTimeout", env: PIWI_ENV_KEYS.submitTimeout, kind: "number" },
-  { option: "liveFileUploads", env: PIWI_ENV_KEYS.liveFileUploads, kind: "bool" },
-  { option: "failOnFlakyTests", env: PIWI_ENV_KEYS.failOnFlakyTests, kind: "bool" },
-  { option: "uploadTraces", env: PIWI_ENV_KEYS.uploadTraces, kind: "bool" },
-  { option: "uploadReport", env: PIWI_ENV_KEYS.uploadReport, kind: "bool" },
-  { option: "captureLocators", env: PIWI_ENV_KEYS.captureLocators, kind: "bool" },
-  { option: "capturePageState", env: PIWI_ENV_KEYS.capturePageState, kind: "bool" },
-  { option: "capturePageInventory", env: PIWI_ENV_KEYS.capturePageInventory, kind: "bool" },
-  { option: "captureCodeReach", env: PIWI_ENV_KEYS.captureCodeReach, kind: "bool" },
-  { option: "captureServerTraces", env: PIWI_ENV_KEYS.captureServerTraces, kind: "bool" },
-  { option: "captureResources", env: PIWI_ENV_KEYS.captureResources, kind: "bool" },
-  { option: "leakCheck", env: PIWI_ENV_KEYS.leakCheck, kind: "string" },
-  { option: "sampleAriaOnPass", env: PIWI_ENV_KEYS.sampleAriaOnPass, kind: "bool" },
-  { option: "uploadManifest", env: PIWI_ENV_KEYS.uploadManifest, kind: "bool" },
-  { option: "defaultCapture", env: PIWI_ENV_KEYS.defaultCapture, kind: "bool" },
-  { option: "checkBaseUrl", env: PIWI_ENV_KEYS.checkBaseUrl, kind: "bool" },
-  { option: "inspectOnFailure", env: PIWI_ENV_KEYS.inspectOnFailure, kind: "bool" },
-  { option: "pickLocatorOnFailure", env: PIWI_ENV_KEYS.pickLocatorOnFailure, kind: "bool" },
-  { option: "outputFile", env: PIWI_ENV_KEYS.outputFile, kind: "string" }
-];
-
-// src/cli/bug.ts
-var EXIT_OK2 = 0;
-var EXIT_RUN_FAILED = 1;
-var EXIT_ERROR2 = 2;
-var REQUEST_TIMEOUT_MS = 3e4;
-var USAGE2 = `
-piwi bug \u2014 a bug report's failing test, from the dashboard
-
-Usage:
-  npx @piwitests/reporter bug <id> [options]
-
-Prints the spec to commit: the report's steps, test.fail() while the bug
-exists, @bug and piwi:bug <id>, written with the project's settings.
-
-Options:
-  --write               Write it to the project's bugs folder (tests/bugs by default, from the
-                        repository root), then run it once
-  --out <file>          Write it to this file instead (then run it once)
-  --no-run              With --write or --out: write it without running it
-  --force               Replace an existing file
-  --run-mode            The spec without test.fail(), as a reproduction runs it
-  --server-url <url>    Dashboard URL         (env PIWI_DASHBOARD_URL)
-  --api-key <key>       API key               (env PIWI_API_KEY)
 
-Exit codes: 0 printed or written (and, when run, the test behaved as its
-test.fail() expects: the bug reproduces), 1 the run did not (the bug may be
-fixed, or a step no longer matches the page), 2 the report could not be read
-or the file could not be written.
-`.trim();
-var VALUE_FLAGS = /* @__PURE__ */ new Set(["--out", "--server-url", "--api-key"]);
-function readOption2(argv, name) {
-  const index = argv.indexOf(name);
-  if (index === -1) return void 0;
-  const value = argv[index + 1];
-  return value !== void 0 && !value.startsWith("--") ? value : void 0;
-}
-function parseBugArgs(argv, env) {
-  let idText;
-  for (let i = 0; i < argv.length; i++) {
-    const token = argv[i];
-    if (token.startsWith("--")) {
-      if (VALUE_FLAGS.has(token)) i++;
-      continue;
+// src/internal/ai/check.ts
+function findEntryFiles(root, dir) {
+  const out = [];
+  const walk = (current) => {
+    let items;
+    try {
+      items = fs2.readdirSync(current, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const item of items) {
+      const full = path4.join(current, item.name);
+      if (item.isDirectory()) {
+        walk(full);
+      } else if (item.isFile() && item.name.endsWith(".json")) {
+        const specFileDir = path4.dirname(full);
+        const dirName = path4.basename(path4.dirname(specFileDir));
+        if (dirName !== dir) continue;
+        const specDir = path4.dirname(path4.dirname(specFileDir));
+        const specFile = path4.join(specDir, path4.basename(specFileDir));
+        out.push({ file: full, specFile, testSlug: item.name.split(".")[0] });
+      }
     }
-    idText = token;
-    break;
-  }
-  const id = Number((idText ?? "").replace(/^#/, ""));
-  if (!idText || !Number.isInteger(id) || id <= 0) throw new Error("No bug report id \u2014 usage: piwi bug <id>");
-  for (const flag of VALUE_FLAGS) {
-    if (argv.includes(flag) && readOption2(argv, flag) === void 0) throw new Error(`${flag} expects a value`);
-  }
-  const serverUrl = (readOption2(argv, "--server-url") ?? env.PIWI_DASHBOARD_URL ?? "").replace(/\/+$/, "");
-  if (!serverUrl) throw new Error("No dashboard \u2014 pass --server-url or set PIWI_DASHBOARD_URL");
-  const out = readOption2(argv, "--out") ?? null;
-  const write = argv.includes("--write") || out !== null;
-  return {
-    id,
-    write,
-    out,
-    run: write && !argv.includes("--no-run"),
-    force: argv.includes("--force"),
-    mode: argv.includes("--run-mode") ? "run" : "commit",
-    serverUrl,
-    apiKey: readOption2(argv, "--api-key") ?? env.PIWI_API_KEY ?? null
   };
+  walk(root);
+  return out;
 }
-async function fetchBugSpec(args, specDir) {
-  const dir = specDir !== void 0 ? `&specDir=${encodeURIComponent(specDir)}` : "";
-  const url = `${args.serverUrl}/api/bug-reports/${args.id}/spec?mode=${args.mode}${dir}`;
-  let res;
+function readTextOr(file, fallback) {
   try {
-    res = await fetch(url, {
-      headers: args.apiKey ? { "X-API-Key": args.apiKey } : {},
-      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
-    });
-  } catch (e) {
-    throw new Error(`could not reach ${args.serverUrl} (${e.message})`);
+    return fs2.readFileSync(file, "utf8");
+  } catch {
+    return fallback;
   }
-  if (res.status === 404) throw new Error(`no bug report #${args.id} on ${args.serverUrl}`);
-  if (res.status === 401 || res.status === 403) throw new Error(`the dashboard refused the API key (${res.status})`);
-  if (!res.ok) throw new Error(`the dashboard answered ${res.status}`);
-  const body = await res.json();
-  if (typeof body.code !== "string" || typeof body.path !== "string") throw new Error("the dashboard sent no spec");
-  return { code: body.code, path: body.path, warnings: Array.isArray(body.warnings) ? body.warnings : [] };
 }
-function repositoryRoot(cwd) {
-  try {
-    const out = (0, import_node_child_process2.execFileSync)("git", ["rev-parse", "--show-toplevel"], {
-      cwd,
-      encoding: "utf-8",
-      stdio: ["ignore", "pipe", "ignore"]
-    }).trim();
-    return out ? path7.resolve(out) : null;
-  } catch {
-    return null;
+function checkAiTree(root, opts = {}) {
+  const dir = opts.dir ?? DEFAULT_AI_DIR;
+  const findings = [];
+  const rel = (file) => path4.relative(root, file).split(path4.sep).join("/");
+  const sourceCache = /* @__PURE__ */ new Map();
+  const duplicates = /* @__PURE__ */ new Map();
+  for (const found of findEntryFiles(root, dir)) {
+    const text = readTextOr(found.file, null);
+    if (text === null) continue;
+    let templateNormalized = null;
+    try {
+      const entry = parseEntry(text);
+      templateNormalized = normalizeTemplate(entry.template);
+      if (serializeEntry(entry) !== text) {
+        findings.push({
+          severity: "error",
+          kind: "non-canonical",
+          file: rel(found.file),
+          message: "file is not in canonical form \u2014 re-author it with `piwi ai resolve --update-ai`"
+        });
+      }
+      if (!sourceCache.has(found.specFile)) sourceCache.set(found.specFile, readTextOr(found.specFile, null));
+      const source = sourceCache.get(found.specFile) ?? null;
+      if (source === null) {
+        findings.push({
+          severity: "error",
+          kind: "orphan",
+          file: rel(found.file),
+          message: `spec file is gone (${rel(found.specFile)}) \u2014 the entry is orphaned`
+        });
+      } else if (!source.includes(entry.template.trim())) {
+        findings.push({
+          severity: "error",
+          kind: "orphan",
+          file: rel(found.file),
+          message: `template "${entry.template}" no longer appears in ${rel(found.specFile)} \u2014 the entry is orphaned`
+        });
+      }
+    } catch (error) {
+      findings.push({
+        severity: "error",
+        kind: "invalid",
+        file: rel(found.file),
+        message: `not a valid entry: ${error.message}`
+      });
+    }
+    if (templateNormalized !== null) {
+      const key = `${found.specFile}::${found.testSlug}::${templateNormalized}`;
+      const list = duplicates.get(key) ?? [];
+      list.push(rel(found.file));
+      duplicates.set(key, list);
+    }
   }
-}
-function realFolder(dir) {
-  const rest = [];
-  let current = dir;
-  while (!fs4.existsSync(current) && path7.dirname(current) !== current) {
-    rest.unshift(path7.basename(current));
-    current = path7.dirname(current);
+  for (const files of duplicates.values()) {
+    if (files.length < 2) continue;
+    for (const file of files) {
+      findings.push({
+        severity: "warning",
+        kind: "duplicate-template",
+        file,
+        message: `duplicate template within the same test \u2014 consider distinct phrasings (${files.join(", ")})`
+      });
+    }
   }
-  return path7.join(fs4.realpathSync(current), ...rest);
-}
-function folderInRepository(root, dir) {
-  const relative8 = path7.relative(realFolder(root), realFolder(dir));
-  if (relative8.startsWith("..") || path7.isAbsolute(relative8)) return void 0;
-  return relative8.split(path7.sep).join("/");
+  return findings.sort((a, b) => a.file < b.file ? -1 : a.file > b.file ? 1 : 0);
 }
-function fileFilter(file) {
-  const escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  return `${escape(path7.basename(path7.dirname(file)))}[\\\\/]${escape(path7.basename(file))}$`;
+function hasBlockingFindings(findings) {
+  return findings.some((f) => f.severity === "error");
 }
-function resolvePlaywrightCli(cwd) {
-  const require2 = (0, import_node_module.createRequire)(path7.join(cwd, "noop.js"));
+
+// src/internal/support/playwright-spawn.ts
+var import_node_child_process = require("child_process");
+var fs3 = __toESM(require("fs"));
+var import_node_module = require("module");
+var path5 = __toESM(require("path"));
+var COULD_NOT_START = 2;
+function resolvePlaywrightCli(cwd = process.cwd()) {
+  const require2 = (0, import_node_module.createRequire)(path5.join(cwd, "noop.js"));
   for (const id of ["playwright/cli", "@playwright/test/cli", "playwright/lib/cli/cli"]) {
     try {
       return require2.resolve(id);
@@ -726,479 +613,639 @@ function resolvePlaywrightCli(cwd) {
   }
   return null;
 }
-function runPlaywright(file, cwd, id, env) {
-  const cli = resolvePlaywrightCli(cwd);
-  const filter = fileFilter(file);
-  const childEnv = { ...env, ...originEnv("bug", id) };
-  const child = cli ? (0, import_node_child_process2.spawn)(process.execPath, [cli, "test", filter], { stdio: "inherit", cwd, env: childEnv }) : (0, import_node_child_process2.spawn)(process.platform === "win32" ? "npx.cmd" : "npx", ["playwright", "test", filter], {
-    stdio: "inherit",
-    cwd,
-    env: childEnv
-  });
+function resolveNpmEntry(name, execPath = process.execPath) {
+  const dir = path5.dirname(execPath);
+  for (const candidate of [
+    path5.join(dir, "node_modules", "npm", "bin", `${name}-cli.js`),
+    path5.join(dir, "..", "lib", "node_modules", "npm", "bin", `${name}-cli.js`)
+  ]) {
+    if (fs3.existsSync(candidate)) return candidate;
+  }
+  return null;
+}
+function playwrightInvocation(playwrightArgs2, options = {}) {
+  const cli = resolvePlaywrightCli(options.cwd);
+  if (cli) return { file: process.execPath, args: [cli, "test", ...playwrightArgs2] };
+  const runner = options.runner ?? "npx";
+  if ((options.platform ?? process.platform) !== "win32") {
+    return { file: runner, args: ["playwright", "test", ...playwrightArgs2] };
+  }
+  const npx = runner === "npx" ? resolveNpmEntry("npx") : null;
+  return npx ? { file: process.execPath, args: [npx, "playwright", "test", ...playwrightArgs2] } : null;
+}
+function spawnPlaywright(playwrightArgs2, env, options = {}) {
+  const label = options.command ?? "piwi";
+  const cwd = options.cwd ?? process.cwd();
+  const invocation = playwrightInvocation(playwrightArgs2, { cwd, runner: options.runner });
+  if (!invocation) {
+    console.error(
+      `${label}: could not find Playwright in ${cwd} \u2014 install it there (npm install --save-dev @playwright/test).`
+    );
+    return Promise.resolve(COULD_NOT_START);
+  }
+  const output = options.output ?? "inherit";
+  let fd = output === "inherit" ? null : fs3.openSync(output.file, "a");
+  const stdio = fd === null ? "inherit" : ["ignore", fd, fd];
+  const child = (0, import_node_child_process.spawn)(invocation.file, invocation.args, { stdio, env, cwd });
   return new Promise((resolve10) => {
+    const done = (code) => {
+      if (fd !== null) fs3.closeSync(fd);
+      fd = null;
+      resolve10(code);
+    };
     child.on("error", (err) => {
-      console.error(`piwi bug: could not start Playwright \u2014 ${err.message}`);
-      resolve10(EXIT_ERROR2);
+      console.error(`${label}: could not start Playwright \u2014 ${err.message}`);
+      done(COULD_NOT_START);
     });
-    child.on("exit", (code) => resolve10(code ?? EXIT_ERROR2));
+    child.on("exit", (code) => done(code ?? COULD_NOT_START));
   });
 }
-async function runBug(argv, env = process.env, cwd = process.cwd()) {
-  if (argv.includes("-h") || argv.includes("--help")) {
-    console.log(USAGE2);
-    return EXIT_OK2;
-  }
-  let args;
-  try {
-    args = parseBugArgs(argv, env);
-  } catch (e) {
-    console.error(`piwi bug: ${e.message}
+function runPackageManager(command, args, cwd) {
+  const result = process.platform === "win32" ? (0, import_node_child_process.spawnSync)([command, ...args].join(" "), { cwd, stdio: "inherit", shell: true }) : (0, import_node_child_process.spawnSync)(command, args, { cwd, stdio: "inherit" });
+  return result.status;
+}
 
-${USAGE2}`);
-    return EXIT_ERROR2;
+// src/cli/ai.ts
+var EXIT_OK = 0;
+var EXIT_ISSUES = 1;
+var EXIT_ERROR = 2;
+var USAGE = `
+Usage: piwi ai <command> [options]
+
+Commands:
+  check    Scan committed AI-step entries for orphans, non-canonical files and
+           duplicate templates. Read-only; exits 1 when issues are found.
+  resolve  Author missing entries by running the suite in resolve mode against
+           the configured authoring server (forces --workers=1).
+  prune    Delete orphaned/dormant entries.
+
+Options (check):
+  --dir <name>   Entry directory name per spec        (env PIWI_AI_DIR, default ${DEFAULT_AI_DIR})
+  --cwd <path>   Root to scan                          (default: current directory)
+  --json         Emit findings as JSON
+
+Options (resolve):
+  --grep <re>       Only author entries for matching tests
+  --project <name>  Author under one Playwright project (a resolve profile)
+  --env K=V         Extra env for the run (repeatable \u2014 flags/viewport profiles)
+  --update-ai       Re-author entries that already exist
+                    (needs PIWI_DASHBOARD_URL / PIWI_API_KEY for the server)
+
+Exit codes:
+  0  clean (or --help)
+  1  hygiene issues found
+  2  bad arguments / command unavailable
+`.trim();
+function readOption(argv, name) {
+  const withEquals = argv.find((arg) => arg.startsWith(`${name}=`));
+  if (withEquals) return withEquals.slice(name.length + 1);
+  const index = argv.indexOf(name);
+  if (index === -1) return void 0;
+  const value = argv[index + 1];
+  return value && !value.startsWith("--") ? value : void 0;
+}
+function readAll(argv, name) {
+  const values = [];
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i].startsWith(`${name}=`)) values.push(argv[i].slice(name.length + 1));
+    else if (argv[i] === name && argv[i + 1] && !argv[i + 1].startsWith("--")) values.push(argv[++i]);
   }
-  const root = args.write ? repositoryRoot(cwd) : null;
-  const outFile = args.out !== null ? path7.resolve(cwd, args.out) : null;
-  let spec;
+  return values;
+}
+function formatFinding(finding) {
+  const mark = finding.severity === "error" ? "\u2716" : "\u26A0";
+  return `${mark} ${finding.file}
+    ${finding.kind}: ${finding.message}`;
+}
+function runCheck(argv, env) {
+  const root = path6.resolve(readOption(argv, "--cwd") ?? process.cwd());
+  const dir = readOption(argv, "--dir") ?? env.PIWI_AI_DIR ?? DEFAULT_AI_DIR;
+  let findings;
   try {
-    spec = await fetchBugSpec(args, outFile && root ? folderInRepository(root, path7.dirname(outFile)) : void 0);
-  } catch (e) {
-    console.error(`piwi bug: ${e.message}`);
-    return EXIT_ERROR2;
+    findings = checkAiTree(root, { dir });
+  } catch (error) {
+    console.error(`piwi ai check: ${error.message}`);
+    return EXIT_ERROR;
   }
-  for (const warning of spec.warnings) {
-    console.error(`piwi bug: warning: step ${warning.step + 1}: ${warning.message}`);
+  if (argv.includes("--json")) {
+    console.log(JSON.stringify({ findings }, null, 2));
+  } else if (findings.length === 0) {
+    console.log("piwi ai check: no issues found.");
+  } else {
+    for (const finding of findings) console.log(formatFinding(finding));
+    const errors = findings.filter((f) => f.severity === "error").length;
+    const warnings = findings.length - errors;
+    console.log(`
+${errors} error(s), ${warnings} warning(s).`);
   }
-  if (!args.write) {
-    process.stdout.write(spec.code);
-    return EXIT_OK2;
+  return hasBlockingFindings(findings) ? EXIT_ISSUES : EXIT_OK;
+}
+function buildResolveInvocation(argv, env) {
+  const args = [];
+  const grep = readOption(argv, "--grep");
+  if (grep) args.push("--grep", grep);
+  const project = readOption(argv, "--project");
+  if (project) args.push("--project", project);
+  args.push("--workers=1");
+  const childEnv = { ...env, PIWI_AI: "resolve" };
+  if (argv.includes("--update-ai")) childEnv.PIWI_AI_UPDATE = "true";
+  for (const pair of readAll(argv, "--env")) {
+    const eq = pair.indexOf("=");
+    if (eq > 0) childEnv[pair.slice(0, eq)] = pair.slice(eq + 1);
   }
-  if (!outFile && !root) {
-    console.error("piwi bug: not in a git repository \u2014 the bugs folder is read from the working directory");
+  return { args, env: childEnv };
+}
+function runResolve(argv, env) {
+  if (!env.PIWI_DASHBOARD_URL) {
+    console.error("piwi ai resolve: set PIWI_DASHBOARD_URL (the authoring server) before resolving.");
+    return Promise.resolve(EXIT_ERROR);
   }
-  const file = outFile ?? path7.resolve(root ?? cwd, spec.path);
-  try {
-    fs4.mkdirSync(path7.dirname(file), { recursive: true });
-    fs4.writeFileSync(file, spec.code, { flag: args.force ? "w" : "wx" });
-  } catch (e) {
-    const exists = e.code === "EEXIST";
-    console.error(`piwi bug: ${exists ? `${file} exists \u2014 pass --force to replace it` : e.message}`);
-    return EXIT_ERROR2;
+  const invocation = buildResolveInvocation(argv, env);
+  return spawnPlaywright(invocation.args, invocation.env, { command: "piwi ai resolve" });
+}
+async function runAi(argv, env = process.env) {
+  const [sub, ...rest] = argv;
+  if (sub === void 0 || sub === "-h" || sub === "--help") {
+    console.log(USAGE);
+    return EXIT_OK;
   }
-  const shown = path7.relative(cwd, file) || file;
-  console.error(`piwi bug: wrote ${shown}`);
-  if (!args.run) return EXIT_OK2;
-  const code = await runPlaywright(file, cwd, args.id, env);
-  if (code === EXIT_ERROR2 && !resolvePlaywrightCli(cwd)) return EXIT_ERROR2;
-  if (code === 0) {
-    console.error(
-      args.mode === "commit" ? `piwi bug: the bug reproduces \u2014 the spec fails on it, as test.fail() expects. Commit ${shown}; remove test.fail() with the fix.` : "piwi bug: the spec passed \u2014 the bug does not show here."
-    );
-    return EXIT_OK2;
+  switch (sub) {
+    case "check":
+      return runCheck(rest, env);
+    case "resolve":
+      return runResolve(rest, env);
+    case "prune":
+      console.error(
+        "piwi ai prune: not available in this build yet. `piwi ai check` lists orphaned entries: delete their files by hand, and re-author a non-canonical one with `piwi ai resolve --update-ai`."
+      );
+      return EXIT_ERROR;
+    default:
+      console.error(`piwi ai: unknown command "${sub}"
+`);
+      console.error(USAGE);
+      return EXIT_ERROR;
   }
-  console.error(
-    args.mode === "commit" ? "piwi bug: the spec did not fail as test.fail() expects \u2014 the bug may be fixed here, or a step no longer matches the page (see the output above)." : "piwi bug: the spec failed \u2014 the bug reproduces here, or a step no longer matches the page (see the output above)."
-  );
-  return EXIT_RUN_FAILED;
 }
 
-// src/cli/codegen.ts
+// src/cli/bug.ts
 var fs5 = __toESM(require("fs"));
 var path8 = __toESM(require("path"));
+var import_node_child_process2 = require("child_process");
 
-// ../core/src/recording.ts
-var ASSERTION_MATCHERS = [
-  "toHaveText",
-  "toHaveValue",
-  "toHaveAccessibleName",
-  "toBeVisible",
-  "toBeHidden",
-  "toBeEnabled",
-  "toBeDisabled",
-  "toHaveURL"
-];
-var VALUE_MATCHERS = /* @__PURE__ */ new Set([
-  "toHaveText",
-  "toHaveValue",
-  "toHaveAccessibleName",
-  "toHaveURL"
-]);
-
-// ../core/src/function-match.ts
-function paramArgKey(source) {
-  return source.path ? `${source.param}.${source.path}` : source.param;
-}
-function globToRegExp(glob) {
-  const escaped = glob.split("**").map((part) => part.replace(/[.?+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/]*")).join(".*");
-  return new RegExp(`^${escaped}$`);
+// src/internal/config/desktop.ts
+var fs4 = __toESM(require("fs"));
+var os = __toESM(require("os"));
+var path7 = __toESM(require("path"));
+function defaultDesktopConfigPath() {
+  return path7.join(os.homedir(), ".piwi", "desktop.json");
 }
-function urlMatches(pattern, url) {
-  if (!pattern) return true;
+function readDesktopConfig(filePath2) {
   try {
-    return globToRegExp(pattern).test(url);
+    const parsed = JSON.parse(fs4.readFileSync(filePath2, "utf8"));
+    const url = parsed?.url;
+    const token = parsed?.token;
+    if (typeof url !== "string" || !url) return null;
+    if (typeof token !== "string" || !token) return null;
+    return { url, token };
   } catch {
-    return true;
-  }
-}
-function scoreTargetMatch(pattern, candidate) {
-  if (!candidate) return pattern.role || pattern.testId || pattern.name ? 0 : 0.3;
-  if (pattern.testId) {
-    return candidate.testId && candidate.testId.toLowerCase() === pattern.testId.toLowerCase() ? 1 : 0;
-  }
-  const roleMatches = !pattern.role || candidate.role != null && candidate.role.toLowerCase() === pattern.role.toLowerCase();
-  if (!roleMatches) return 0;
-  if (pattern.name) {
-    const needle = pattern.name.toLowerCase();
-    const haystack = `${candidate.accessibleName ?? ""} ${candidate.text ?? ""}`.toLowerCase().trim();
-    const nameMatches2 = haystack.length > 0 && (haystack.includes(needle) || needle.includes(haystack));
-    if (!nameMatches2) return pattern.role ? 0.35 : 0;
-    return pattern.role ? 0.95 : 0.6;
-  }
-  return pattern.role ? 0.7 : 0.3;
-}
-function actionCompatible(patternAction, recordedAction) {
-  if (patternAction === recordedAction) return true;
-  return patternAction === "click" && recordedAction === "press" || patternAction === "press" && recordedAction === "click";
-}
-function stepPairScore(pattern, recorded) {
-  if (!actionCompatible(pattern.action, recorded.action)) return 0;
-  const base = scoreTargetMatch(pattern.target, recorded.target);
-  return pattern.action === recorded.action ? base : base * 0.6;
-}
-function extractArgs(entry, window, pairs) {
-  const args = {};
-  const byPatternIndex = new Map(pairs.map(([windowIdx, patternIdx]) => [patternIdx, windowIdx]));
-  for (const source of entry.paramSources) {
-    const windowIdx = byPatternIndex.get(source.stepIndex);
-    if (windowIdx == null) continue;
-    const step = window[windowIdx];
-    const value = source.from === "value" ? step.value : source.from === "testId" ? step.target?.testId ?? null : step.target?.text ?? null;
-    if (value != null) args[paramArgKey(source)] = value;
-  }
-  return args;
-}
-function sameElement(pattern, recorded) {
-  if (pattern.testId || !pattern.name) return true;
-  const haystack = `${recorded?.accessibleName ?? ""} ${recorded?.text ?? ""}`.toLowerCase().trim();
-  const needle = pattern.name.toLowerCase();
-  return haystack.length > 0 && (haystack.includes(needle) || needle.includes(haystack));
-}
-function contiguousAlignment(steps, startIndex, pattern) {
-  if (startIndex + pattern.length > steps.length) return null;
-  const pairs = [];
-  let total = 0;
-  for (let j = 0; j < pattern.length; j++) {
-    const recorded = steps[startIndex + j];
-    const score = stepPairScore(pattern[j], recorded);
-    if (score <= 0 || !sameElement(pattern[j].target, recorded.target)) return null;
-    total += score;
-    pairs.push([j, j]);
-  }
-  return { total, pairs };
-}
-function matchFunctionAt(steps, startIndex, catalog) {
-  const anchor = steps[startIndex];
-  if (!anchor) return null;
-  let best = null;
-  for (const entry of catalog) {
-    if (entry.steps.length === 0) continue;
-    if (!urlMatches(entry.urlPattern, anchor.pageUrl)) continue;
-    const aligned = contiguousAlignment(steps, startIndex, entry.steps);
-    if (!aligned) continue;
-    const { total, pairs } = aligned;
-    const window = steps.slice(startIndex, startIndex + entry.steps.length);
-    const score = total / entry.steps.length;
-    const match = {
-      entry,
-      score,
-      matchedIndices: pairs.map(([windowIdx]) => windowIdx + startIndex),
-      complete: true,
-      args: extractArgs(entry, window, pairs)
-    };
-    if (!best || match.score > best.score || match.score === best.score && entry.steps.length > best.entry.steps.length)
-      best = match;
+    return null;
   }
-  return best;
 }
 
-// ../core/src/locator-chain.ts
-var LOCATING_METHODS = /* @__PURE__ */ new Set([
-  "getByRole",
-  "getByTestId",
-  "getByText",
-  "getByLabel",
-  "getByPlaceholder",
-  "getByAltText",
-  "getByTitle",
-  "locator",
-  "frameLocator"
-]);
-var NARROWING_METHODS = /* @__PURE__ */ new Set([
-  "filter",
-  "first",
-  "last",
-  "nth",
-  "and",
-  "or",
-  "visible",
-  "contentFrame",
-  "owner"
-]);
-var LOCATOR_CHAIN_METHODS = /* @__PURE__ */ new Set([...LOCATING_METHODS, ...NARROWING_METHODS]);
-var LocatorParseError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "LocatorParseError";
-  }
+// src/internal/config/env.ts
+var DEFAULTS = {
+  projectName: "default-project",
+  uploadTraces: true,
+  uploadReport: true,
+  liveFileUploads: true,
+  collectScmInfo: true,
+  collectCiInfo: true,
+  collectPerformanceMetrics: true,
+  captureLocators: true,
+  capturePageState: true,
+  // Off by default: the page inventory reads control and link names from every
+  // visited page, so it stays opt-in until a project turns it on.
+  capturePageInventory: false,
+  // Off by default: JavaScript coverage adds time to every test, so a scheduled job opts in.
+  captureCodeReach: false,
+  captureServerTraces: true,
+  captureResources: true,
+  leakCheck: "report",
+  sampleAriaOnPass: true,
+  uploadManifest: true,
+  defaultCapture: true,
+  checkBaseUrl: false,
+  streaming: true,
+  streamingBatchSize: 20,
+  streamingBatchDelay: 2e3,
+  maxStreamBufferBytes: 100 * 1024 * 1024,
+  submitTimeout: 15 * 60 * 1e3,
+  failOnFlakyTests: false,
+  username: null,
+  password: null,
+  apiKey: null,
+  verbose: false
 };
-var SIMPLE_ESCAPES = {
-  n: "\n",
-  t: "	",
-  r: "\r",
-  b: "\b",
-  f: "\f",
-  v: "\v",
-  "0": "\0"
+var PIWI_ENV_KEYS = {
+  serverUrl: "PIWI_DASHBOARD_URL",
+  projectName: "PIWI_PROJECT_NAME",
+  verbose: "PIWI_VERBOSE",
+  apiKey: "PIWI_API_KEY",
+  username: "PIWI_USERNAME",
+  password: "PIWI_PASSWORD",
+  environment: "PIWI_ENVIRONMENT",
+  label: "PIWI_LABEL",
+  runLabel: "PIWI_RUN_LABEL",
+  keep: "PIWI_KEEP",
+  streaming: "PIWI_STREAMING",
+  streamingBatchSize: "PIWI_STREAMING_BATCH_SIZE",
+  streamingBatchDelay: "PIWI_STREAMING_BATCH_DELAY",
+  maxStreamBufferBytes: "PIWI_MAX_STREAM_BUFFER_BYTES",
+  submitTimeout: "PIWI_SUBMIT_TIMEOUT",
+  liveFileUploads: "PIWI_LIVE_FILE_UPLOADS",
+  failOnFlakyTests: "PIWI_FAIL_ON_FLAKY_TESTS",
+  uploadTraces: "PIWI_UPLOAD_TRACES",
+  uploadReport: "PIWI_UPLOAD_REPORT",
+  captureLocators: "PIWI_CAPTURE_LOCATORS",
+  capturePageState: "PIWI_CAPTURE_PAGE_STATE",
+  capturePageInventory: "PIWI_CAPTURE_PAGE_INVENTORY",
+  captureCodeReach: "PIWI_CAPTURE_CODE_REACH",
+  codeReachRoots: "PIWI_CODE_REACH_ROOTS",
+  coverageBrowser: "PIWI_COVERAGE_BROWSER",
+  coverageServer: "PIWI_COVERAGE_SERVER",
+  captureServerTraces: "PIWI_CAPTURE_SERVER_TRACES",
+  captureResources: "PIWI_CAPTURE_RESOURCES",
+  leakCheck: "PIWI_LEAK_CHECK",
+  sampleAriaOnPass: "PIWI_SAMPLE_ARIA_ON_PASS",
+  uploadManifest: "PIWI_UPLOAD_MANIFEST",
+  defaultCapture: "PIWI_DEFAULT_CAPTURE",
+  checkBaseUrl: "PIWI_CHECK_BASE_URL",
+  inspectOnFailure: "PIWI_INSPECT_ON_FAIL",
+  pickLocatorOnFailure: "PIWI_PICK_LOCATOR_ON_FAIL",
+  outputFile: "PIWI_OUTPUT_FILE",
+  aiMode: "PIWI_AI",
+  aiDir: "PIWI_AI_DIR",
+  aiOnMiss: "PIWI_AI_ON_MISS",
+  aiMaxSteps: "PIWI_AI_MAX_FLOW_STEPS",
+  aiMaxSnapshotChars: "PIWI_AI_MAX_SNAPSHOT_CHARS",
+  aiOptionalProbeTimeout: "PIWI_AI_OPTIONAL_PROBE_TIMEOUT",
+  aiResponseWaitTimeout: "PIWI_AI_RESPONSE_WAIT_TIMEOUT",
+  aiScreenshotFallback: "PIWI_AI_SCREENSHOT_FALLBACK"
 };
-var Parser = class {
-  constructor(src) {
-    this.src = src;
-    this.i = 0;
-  }
-  parseTopLevel() {
-    const chain = this.parseChain();
-    this.skipSpace();
-    if (this.i < this.src.length) this.fail("unexpected text");
-    return chain;
-  }
-  fail(message) {
-    throw new LocatorParseError(`${message} at "${this.src.slice(this.i, this.i + 20)}"`);
-  }
-  skipSpace() {
-    while (this.i < this.src.length && /\s/.test(this.src[this.i])) this.i++;
-  }
-  peek() {
-    return this.src[this.i];
+var PIWI_DESKTOP_CONFIG_ENV = "PIWI_DESKTOP_CONFIG";
+var PIWI_ORIGIN_ENV = {
+  kind: "PIWI_ORIGIN",
+  ref: "PIWI_ORIGIN_REF"
+};
+function originEnv(kind, ref) {
+  return ref === void 0 ? { [PIWI_ORIGIN_ENV.kind]: kind } : { [PIWI_ORIGIN_ENV.kind]: kind, [PIWI_ORIGIN_ENV.ref]: String(ref) };
+}
+var PIWI_SHARD_ENV = "PIWI_SHARD";
+var PIWI_PROBE_ENV = {
+  flag: "PIWI_PROBE",
+  plan: "PIWI_PROBE_PLAN",
+  results: "PIWI_PROBE_RESULTS",
+  secret: "PIWI_PROBE_SECRET"
+};
+var PIWI_FLAKE_ENV = {
+  plan: "PIWI_FLAKE_PLAN",
+  results: "PIWI_FLAKE_RESULTS"
+};
+var ENV_FALLBACK_SPECS = [
+  { option: "serverUrl", env: PIWI_ENV_KEYS.serverUrl, kind: "string" },
+  { option: "projectName", env: PIWI_ENV_KEYS.projectName, kind: "string" },
+  { option: "apiKey", env: PIWI_ENV_KEYS.apiKey, kind: "string" },
+  { option: "username", env: PIWI_ENV_KEYS.username, kind: "string" },
+  { option: "password", env: PIWI_ENV_KEYS.password, kind: "string" },
+  { option: "environment", env: PIWI_ENV_KEYS.environment, kind: "string" },
+  { option: "label", env: PIWI_ENV_KEYS.label, kind: "string" },
+  { option: "runLabel", env: PIWI_ENV_KEYS.runLabel, kind: "string" },
+  { option: "keep", env: PIWI_ENV_KEYS.keep, kind: "bool" },
+  { option: "streaming", env: PIWI_ENV_KEYS.streaming, kind: "bool" },
+  { option: "streamingBatchSize", env: PIWI_ENV_KEYS.streamingBatchSize, kind: "number" },
+  { option: "streamingBatchDelay", env: PIWI_ENV_KEYS.streamingBatchDelay, kind: "number" },
+  { option: "maxStreamBufferBytes", env: PIWI_ENV_KEYS.maxStreamBufferBytes, kind: "number" },
+  { option: "submitTimeout", env: PIWI_ENV_KEYS.submitTimeout, kind: "number" },
+  { option: "liveFileUploads", env: PIWI_ENV_KEYS.liveFileUploads, kind: "bool" },
+  { option: "failOnFlakyTests", env: PIWI_ENV_KEYS.failOnFlakyTests, kind: "bool" },
+  { option: "uploadTraces", env: PIWI_ENV_KEYS.uploadTraces, kind: "bool" },
+  { option: "uploadReport", env: PIWI_ENV_KEYS.uploadReport, kind: "bool" },
+  { option: "captureLocators", env: PIWI_ENV_KEYS.captureLocators, kind: "bool" },
+  { option: "capturePageState", env: PIWI_ENV_KEYS.capturePageState, kind: "bool" },
+  { option: "capturePageInventory", env: PIWI_ENV_KEYS.capturePageInventory, kind: "bool" },
+  { option: "captureCodeReach", env: PIWI_ENV_KEYS.captureCodeReach, kind: "bool" },
+  { option: "captureServerTraces", env: PIWI_ENV_KEYS.captureServerTraces, kind: "bool" },
+  { option: "captureResources", env: PIWI_ENV_KEYS.captureResources, kind: "bool" },
+  { option: "leakCheck", env: PIWI_ENV_KEYS.leakCheck, kind: "string" },
+  { option: "sampleAriaOnPass", env: PIWI_ENV_KEYS.sampleAriaOnPass, kind: "bool" },
+  { option: "uploadManifest", env: PIWI_ENV_KEYS.uploadManifest, kind: "bool" },
+  { option: "defaultCapture", env: PIWI_ENV_KEYS.defaultCapture, kind: "bool" },
+  { option: "checkBaseUrl", env: PIWI_ENV_KEYS.checkBaseUrl, kind: "bool" },
+  { option: "inspectOnFailure", env: PIWI_ENV_KEYS.inspectOnFailure, kind: "bool" },
+  { option: "pickLocatorOnFailure", env: PIWI_ENV_KEYS.pickLocatorOnFailure, kind: "bool" },
+  { option: "outputFile", env: PIWI_ENV_KEYS.outputFile, kind: "string" }
+];
+
+// src/cli/bug.ts
+var EXIT_OK2 = 0;
+var EXIT_RUN_FAILED = 1;
+var EXIT_ERROR2 = 2;
+var REQUEST_TIMEOUT_MS = 3e4;
+var USAGE2 = `
+piwi bug \u2014 a bug report's failing test, from the dashboard
+
+Usage:
+  npx @piwitests/reporter bug <id> [options]
+
+Prints the spec to commit: the report's steps, test.fail() while the bug
+exists, @bug and piwi:bug <id>, written with the project's settings.
+
+Options:
+  --write               Write it to the project's bugs folder (tests/bugs by default, from the
+                        repository root), then run it once
+  --out <file>          Write it to this file instead (then run it once)
+  --no-run              With --write or --out: write it without running it
+  --force               Replace an existing file
+  --run-mode            The spec without test.fail(), as a reproduction runs it
+  --server-url <url>    Dashboard URL         (env PIWI_DASHBOARD_URL)
+  --api-key <key>       API key               (env PIWI_API_KEY)
+
+Exit codes: 0 printed or written (and, when run, the test behaved as its
+test.fail() expects: the bug reproduces), 1 the run did not (the bug may be
+fixed, or a step no longer matches the page), 2 the report could not be read
+or the file could not be written.
+`.trim();
+var VALUE_FLAGS = /* @__PURE__ */ new Set(["--out", "--server-url", "--api-key"]);
+function readOption2(argv, name) {
+  const index = argv.indexOf(name);
+  if (index === -1) return void 0;
+  const value = argv[index + 1];
+  return value !== void 0 && !value.startsWith("--") ? value : void 0;
+}
+function parseBugArgs(argv, env) {
+  let idText;
+  for (let i = 0; i < argv.length; i++) {
+    const token = argv[i];
+    if (token.startsWith("--")) {
+      if (VALUE_FLAGS.has(token)) i++;
+      continue;
+    }
+    idText = token;
+    break;
   }
-  expect(ch) {
-    this.skipSpace();
-    if (this.src[this.i] !== ch) this.fail(`expected "${ch}"`);
-    this.i++;
+  const id = Number((idText ?? "").replace(/^#/, ""));
+  if (!idText || !Number.isInteger(id) || id <= 0) throw new Error("No bug report id \u2014 usage: piwi bug <id>");
+  for (const flag of VALUE_FLAGS) {
+    if (argv.includes(flag) && readOption2(argv, flag) === void 0) throw new Error(`${flag} expects a value`);
   }
-  identifier() {
-    const m = /^[A-Za-z_$][\w$]*/.exec(this.src.slice(this.i));
-    if (!m) this.fail("expected a name");
-    this.i += m[0].length;
-    return m[0];
+  const serverUrl = (readOption2(argv, "--server-url") ?? env.PIWI_DASHBOARD_URL ?? "").replace(/\/+$/, "");
+  if (!serverUrl) throw new Error("No dashboard \u2014 pass --server-url or set PIWI_DASHBOARD_URL");
+  const out = readOption2(argv, "--out") ?? null;
+  const write = argv.includes("--write") || out !== null;
+  return {
+    id,
+    write,
+    out,
+    run: write && !argv.includes("--no-run"),
+    force: argv.includes("--force"),
+    mode: argv.includes("--run-mode") ? "run" : "commit",
+    serverUrl,
+    apiKey: readOption2(argv, "--api-key") ?? env.PIWI_API_KEY ?? null
+  };
+}
+async function fetchBugSpec(args, specDir) {
+  const dir = specDir !== void 0 ? `&specDir=${encodeURIComponent(specDir)}` : "";
+  const url = `${args.serverUrl}/api/bug-reports/${args.id}/spec?mode=${args.mode}${dir}`;
+  let res;
+  try {
+    res = await fetch(url, {
+      headers: args.apiKey ? { "X-API-Key": args.apiKey } : {},
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+    });
+  } catch (e) {
+    throw new Error(`could not reach ${args.serverUrl} (${e.message})`);
   }
-  /**
-   * A chain of calls joined by `.`. With `lenient`, parsing stops before the
-   * first link that doesn't parse instead of failing, so a chain followed by
-   * other text (an error message) is read up to where it ends. `spans` receives
-   * where each top-level call starts and ends.
-   */
-  parseChain(opts = {}) {
-    this.skipSpace();
-    const calls = [];
-    for (; ; ) {
-      const before = this.i;
-      if (calls.length > 0) this.i++;
-      this.skipSpace();
-      const start = this.i;
-      try {
-        calls.push(this.parseCall(calls.length === 0));
-      } catch (error) {
-        if (!opts.lenient || calls.length === 0) throw error;
-        this.i = before;
-        break;
-      }
-      opts.spans?.push({ start, end: this.i });
-      const end = this.i;
-      this.skipSpace();
-      if (this.peek() !== ".") {
-        this.i = end;
-        break;
-      }
-    }
-    return { calls };
+  if (res.status === 404) throw new Error(`no bug report #${args.id} on ${args.serverUrl}`);
+  if (res.status === 401 || res.status === 403) throw new Error(`the dashboard refused the API key (${res.status})`);
+  if (!res.ok) throw new Error(`the dashboard answered ${res.status}`);
+  const body = await res.json();
+  if (typeof body.code !== "string" || typeof body.path !== "string") throw new Error("the dashboard sent no spec");
+  return { code: body.code, path: body.path, warnings: Array.isArray(body.warnings) ? body.warnings : [] };
+}
+function repositoryRoot(cwd) {
+  try {
+    const out = (0, import_node_child_process2.execFileSync)("git", ["rev-parse", "--show-toplevel"], {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    return out ? path8.resolve(out) : null;
+  } catch {
+    return null;
   }
-  /** Where the parser stopped. */
-  get position() {
-    return this.i;
+}
+function realFolder(dir) {
+  const rest = [];
+  let current = dir;
+  while (!fs5.existsSync(current) && path8.dirname(current) !== current) {
+    rest.unshift(path8.basename(current));
+    current = path8.dirname(current);
   }
-  parseCall(first) {
-    this.skipSpace();
-    const method = this.identifier();
-    if (!LOCATOR_CHAIN_METHODS.has(method)) this.fail(`unsupported method ${method}()`);
-    if (first && !LOCATING_METHODS.has(method)) this.fail(`${method}() needs a locator before it`);
-    this.expect("(");
-    const args = [];
-    this.skipSpace();
-    if (this.peek() === ")") {
-      this.i++;
-      return { method, args };
-    }
-    for (; ; ) {
-      args.push(this.parseValue());
-      this.skipSpace();
-      if (this.peek() === ",") {
-        this.i++;
-        this.skipSpace();
-        if (this.peek() === ")") {
-          this.i++;
-          break;
-        }
-        continue;
-      }
-      this.expect(")");
-      break;
-    }
-    return { method, args };
+  return path8.join(fs5.realpathSync(current), ...rest);
+}
+function folderInRepository(root, dir) {
+  const relative9 = path8.relative(realFolder(root), realFolder(dir));
+  if (relative9.startsWith("..") || path8.isAbsolute(relative9)) return void 0;
+  return relative9.split(path8.sep).join("/");
+}
+function fileFilter(file) {
+  const escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return `${escape(path8.basename(path8.dirname(file)))}[\\\\/]${escape(path8.basename(file))}$`;
+}
+function runPlaywright(file, cwd, id, env) {
+  return spawnPlaywright([fileFilter(file)], { ...env, ...originEnv("bug", id) }, { cwd, command: "piwi bug" });
+}
+async function runBug(argv, env = process.env, cwd = process.cwd()) {
+  if (argv.includes("-h") || argv.includes("--help")) {
+    console.log(USAGE2);
+    return EXIT_OK2;
   }
-  parseValue() {
-    this.skipSpace();
-    const ch = this.peek();
-    if (ch === "'" || ch === '"' || ch === "`") return { type: "string", value: this.parseString() };
-    if (ch === "/") return this.parseRegex();
-    if (ch === "{") return this.parseObject();
-    if (ch !== void 0 && /[-\d]/.test(ch)) {
-      const m = /^-?\d+(?:\.\d+)?/.exec(this.src.slice(this.i));
-      if (!m) this.fail("expected a number");
-      this.i += m[0].length;
-      return { type: "number", value: Number(m[0]) };
-    }
-    const rest = this.src.slice(this.i);
-    if (/^true\b/.test(rest)) {
-      this.i += 4;
-      return { type: "boolean", value: true };
-    }
-    if (/^false\b/.test(rest)) {
-      this.i += 5;
-      return { type: "boolean", value: false };
-    }
-    if (/^[A-Za-z_$]/.test(rest)) return { type: "chain", chain: this.parseChain() };
-    return this.fail("expected a value");
+  let args;
+  try {
+    args = parseBugArgs(argv, env);
+  } catch (e) {
+    console.error(`piwi bug: ${e.message}
+
+${USAGE2}`);
+    return EXIT_ERROR2;
   }
-  /** A quoted string, decoding the escapes `JSON.stringify` and JavaScript produce. */
-  parseString() {
-    const quote4 = this.src[this.i];
-    let out = "";
-    this.i++;
-    while (this.i < this.src.length) {
-      const c = this.src[this.i];
-      if (c === quote4) {
-        this.i++;
-        return out;
-      }
-      if (c !== "\\") {
-        out += c;
-        this.i++;
-        continue;
-      }
-      const next = this.src[this.i + 1];
-      if (next === void 0) break;
-      const simple = SIMPLE_ESCAPES[next];
-      if (simple !== void 0) {
-        out += simple;
-        this.i += 2;
-        continue;
-      }
-      const hex = next === "u" && this.src[this.i + 2] === "{" ? /^u\{([0-9a-fA-F]{1,6})\}/.exec(this.src.slice(this.i + 1)) : next === "u" ? /^u([0-9a-fA-F]{4})/.exec(this.src.slice(this.i + 1)) : next === "x" ? /^x([0-9a-fA-F]{2})/.exec(this.src.slice(this.i + 1)) : null;
-      if (hex) {
-        out += String.fromCodePoint(parseInt(hex[1], 16));
-        this.i += 1 + hex[0].length;
-        continue;
-      }
-      if (next === "u" || next === "x") this.fail("malformed escape");
-      out += next;
-      this.i += 2;
-    }
-    return this.fail("unterminated string");
+  const root = args.write ? repositoryRoot(cwd) : null;
+  const outFile = args.out !== null ? path8.resolve(cwd, args.out) : null;
+  let spec;
+  try {
+    spec = await fetchBugSpec(args, outFile && root ? folderInRepository(root, path8.dirname(outFile)) : void 0);
+  } catch (e) {
+    console.error(`piwi bug: ${e.message}`);
+    return EXIT_ERROR2;
   }
-  parseRegex() {
-    let j = this.i + 1;
-    let inClass = false;
-    while (j < this.src.length) {
-      const c = this.src[j];
-      if (c === "\\") {
-        j += 2;
-        continue;
-      }
-      if (c === "[") inClass = true;
-      else if (c === "]") inClass = false;
-      else if (c === "/" && !inClass) break;
-      j++;
-    }
-    if (j >= this.src.length) this.fail("unterminated regex");
-    const source = this.src.slice(this.i + 1, j);
-    const flags = /^[a-z]*/.exec(this.src.slice(j + 1))[0];
-    this.i = j + 1 + flags.length;
-    return { type: "regex", source, flags };
+  for (const warning of spec.warnings) {
+    console.error(`piwi bug: warning: step ${warning.step + 1}: ${warning.message}`);
   }
-  parseObject() {
-    this.expect("{");
-    const entries = [];
-    for (; ; ) {
-      this.skipSpace();
-      if (this.peek() === "}") {
-        this.i++;
-        break;
-      }
-      const ch = this.peek();
-      const key = ch === "'" || ch === '"' ? this.parseString() : this.identifier();
-      this.expect(":");
-      entries.push([key, this.parseValue()]);
-      this.skipSpace();
-      if (this.peek() === ",") {
-        this.i++;
-        continue;
-      }
-      this.expect("}");
-      break;
-    }
-    return { type: "object", entries };
+  if (!args.write) {
+    process.stdout.write(spec.code);
+    return EXIT_OK2;
   }
-};
-function parseLocatorChain(expr) {
-  const trimmed = expr.trim().replace(/^(?:await\s+)?(?:this\.)?page\./, "");
-  if (!trimmed) throw new LocatorParseError("empty expression");
-  return new Parser(trimmed).parseTopLevel();
+  if (!outFile && !root) {
+    console.error("piwi bug: not in a git repository \u2014 the bugs folder is read from the working directory");
+  }
+  const file = outFile ?? path8.resolve(root ?? cwd, spec.path);
+  try {
+    fs5.mkdirSync(path8.dirname(file), { recursive: true });
+    fs5.writeFileSync(file, spec.code, { flag: args.force ? "w" : "wx" });
+  } catch (e) {
+    const exists = e.code === "EEXIST";
+    console.error(`piwi bug: ${exists ? `${file} exists \u2014 pass --force to replace it` : e.message}`);
+    return EXIT_ERROR2;
+  }
+  const shown = path8.relative(cwd, file) || file;
+  console.error(`piwi bug: wrote ${shown}`);
+  if (!args.run) return EXIT_OK2;
+  const code = await runPlaywright(file, cwd, args.id, env);
+  if (code === EXIT_ERROR2 && !resolvePlaywrightCli(cwd)) return EXIT_ERROR2;
+  if (code === 0) {
+    console.error(
+      args.mode === "commit" ? `piwi bug: the bug reproduces \u2014 the spec fails on it, as test.fail() expects. Commit ${shown}; remove test.fail() with the fix.` : "piwi bug: the spec passed \u2014 the bug does not show here."
+    );
+    return EXIT_OK2;
+  }
+  console.error(
+    args.mode === "commit" ? "piwi bug: the spec did not fail as test.fail() expects \u2014 the bug may be fixed here, or a step no longer matches the page (see the output above)." : "piwi bug: the spec failed \u2014 the bug reproduces here, or a step no longer matches the page (see the output above)."
+  );
+  return EXIT_RUN_FAILED;
 }
-function tryParseLocatorChain(expr) {
+
+// src/cli/codegen.ts
+var fs6 = __toESM(require("fs"));
+var path9 = __toESM(require("path"));
+
+// ../core/src/recording.ts
+var ASSERTION_MATCHERS = [
+  "toHaveText",
+  "toHaveValue",
+  "toHaveAccessibleName",
+  "toBeVisible",
+  "toBeHidden",
+  "toBeEnabled",
+  "toBeDisabled",
+  "toHaveURL",
+  "toContainText",
+  "toHaveCount",
+  "toBeChecked"
+];
+var VALUE_MATCHERS = /* @__PURE__ */ new Set([
+  "toHaveText",
+  "toHaveValue",
+  "toHaveAccessibleName",
+  "toHaveURL",
+  "toContainText",
+  "toHaveCount"
+]);
+
+// ../core/src/function-match.ts
+function paramArgKey(source) {
+  return source.path ? `${source.param}.${source.path}` : source.param;
+}
+function globToRegExp(glob) {
+  const escaped = glob.split("**").map((part) => part.replace(/[.?+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/]*")).join(".*");
+  return new RegExp(`^${escaped}$`);
+}
+function urlMatches(pattern, url) {
+  if (!pattern) return true;
   try {
-    return parseLocatorChain(expr);
+    return globToRegExp(pattern).test(url);
   } catch {
-    return null;
+    return true;
   }
 }
-function quote(value) {
-  const json = JSON.stringify(value);
-  return `'${json.slice(1, -1).replace(/\\"/g, '"').replace(/'/g, "\\'")}'`;
+function scoreTargetMatch(pattern, candidate) {
+  if (!candidate) return pattern.role || pattern.testId || pattern.name ? 0 : 0.3;
+  if (pattern.testId) {
+    return candidate.testId && candidate.testId.toLowerCase() === pattern.testId.toLowerCase() ? 1 : 0;
+  }
+  const roleMatches = !pattern.role || candidate.role != null && candidate.role.toLowerCase() === pattern.role.toLowerCase();
+  if (!roleMatches) return 0;
+  if (pattern.name) {
+    const needle = pattern.name.toLowerCase();
+    const haystack = `${candidate.accessibleName ?? ""} ${candidate.text ?? ""}`.toLowerCase().trim();
+    const nameMatches2 = haystack.length > 0 && (haystack.includes(needle) || needle.includes(haystack));
+    if (!nameMatches2) return pattern.role ? 0.35 : 0;
+    return pattern.role ? 0.95 : 0.6;
+  }
+  return pattern.role ? 0.7 : 0.3;
 }
-function renderArg(arg) {
-  switch (arg.type) {
-    case "string":
-      return quote(arg.value);
-    case "regex":
-      return `/${arg.source}/${arg.flags}`;
-    case "number":
-    case "boolean":
-      return String(arg.value);
-    case "object":
-      return arg.entries.length === 0 ? "{}" : `{ ${arg.entries.map(([k, v]) => `${/^[A-Za-z_$][\w$]*$/.test(k) ? k : quote(k)}: ${renderArg(v)}`).join(", ")} }`;
-    case "chain":
-      return renderLocatorChain(arg.chain);
+function actionCompatible(patternAction, recordedAction) {
+  if (patternAction === recordedAction) return true;
+  return patternAction === "click" && recordedAction === "press" || patternAction === "press" && recordedAction === "click";
+}
+function stepPairScore(pattern, recorded) {
+  if (!actionCompatible(pattern.action, recorded.action)) return 0;
+  const base = scoreTargetMatch(pattern.target, recorded.target);
+  return pattern.action === recorded.action ? base : base * 0.6;
+}
+function extractArgs(entry, window, pairs) {
+  const args = {};
+  const byPatternIndex = new Map(pairs.map(([windowIdx, patternIdx]) => [patternIdx, windowIdx]));
+  for (const source of entry.paramSources) {
+    const windowIdx = byPatternIndex.get(source.stepIndex);
+    if (windowIdx == null) continue;
+    const step = window[windowIdx];
+    const value = source.from === "value" ? step.value : source.from === "testId" ? step.target?.testId ?? null : step.target?.text ?? null;
+    if (value != null) args[paramArgKey(source)] = value;
   }
+  return args;
 }
-function renderLocatorCall(call) {
-  return `${call.method}(${call.args.map(renderArg).join(", ")})`;
+function sameElement(pattern, recorded) {
+  if (pattern.testId || !pattern.name) return true;
+  const haystack = `${recorded?.accessibleName ?? ""} ${recorded?.text ?? ""}`.toLowerCase().trim();
+  const needle = pattern.name.toLowerCase();
+  return haystack.length > 0 && (haystack.includes(needle) || needle.includes(haystack));
 }
-function renderLocatorChain(chain) {
-  return chain.calls.map(renderLocatorCall).join(".");
+function contiguousAlignment(steps, startIndex, pattern) {
+  if (startIndex + pattern.length > steps.length) return null;
+  const pairs = [];
+  let total = 0;
+  for (let j = 0; j < pattern.length; j++) {
+    const recorded = steps[startIndex + j];
+    const score = stepPairScore(pattern[j], recorded);
+    if (score <= 0 || !sameElement(pattern[j].target, recorded.target)) return null;
+    total += score;
+    pairs.push([j, j]);
+  }
+  return { total, pairs };
 }
-function canonicalLocator(expr) {
-  const chain = tryParseLocatorChain(expr);
-  return chain ? renderLocatorChain(chain) : null;
+function matchFunctionAt(steps, startIndex, catalog) {
+  const anchor = steps[startIndex];
+  if (!anchor) return null;
+  let best = null;
+  for (const entry of catalog) {
+    if (entry.steps.length === 0) continue;
+    if (!urlMatches(entry.urlPattern, anchor.pageUrl)) continue;
+    const aligned = contiguousAlignment(steps, startIndex, entry.steps);
+    if (!aligned) continue;
+    const { total, pairs } = aligned;
+    const window = steps.slice(startIndex, startIndex + entry.steps.length);
+    const score = total / entry.steps.length;
+    const match = {
+      entry,
+      score,
+      matchedIndices: pairs.map(([windowIdx]) => windowIdx + startIndex),
+      complete: true,
+      args: extractArgs(entry, window, pairs)
+    };
+    if (!best || match.score > best.score || match.score === best.score && entry.steps.length > best.entry.steps.length)
+      best = match;
+  }
+  return best;
 }
 
 // ../core/src/locator-stability.ts
@@ -1332,16 +1379,16 @@ function checkFilterOptions(arg, out) {
 function splitTopLevel(text, separator) {
   const parts = [];
   let depth = 0;
-  let quote4 = null;
+  let quote3 = null;
   let start = 0;
   for (let i = 0; i < text.length; i++) {
     const c = text[i];
-    if (quote4) {
+    if (quote3) {
       if (c === "\\") i++;
-      else if (c === quote4) quote4 = null;
+      else if (c === quote3) quote3 = null;
       continue;
     }
-    if (c === '"' || c === "'") quote4 = c;
+    if (c === '"' || c === "'") quote3 = c;
     else if (c === "[" || c === "(") depth++;
     else if (c === "]" || c === ")") depth = Math.max(0, depth - 1);
     else if (depth === 0 && text.startsWith(separator, i)) {
@@ -1421,7 +1468,7 @@ function tokenizeComplex(selector) {
   const combinators = [];
   let current = "";
   let depth = 0;
-  let quote4 = null;
+  let quote3 = null;
   let pending = null;
   const flush = () => {
     if (!current) return;
@@ -1433,14 +1480,14 @@ function tokenizeComplex(selector) {
   };
   for (let i = 0; i < selector.length; i++) {
     const c = selector[i];
-    if (quote4) {
+    if (quote3) {
       current += c;
       if (c === "\\" && i + 1 < selector.length) current += selector[++i];
-      else if (c === quote4) quote4 = null;
+      else if (c === quote3) quote3 = null;
       continue;
     }
     if (c === '"' || c === "'") {
-      quote4 = c;
+      quote3 = c;
       current += c;
     } else if (c === "[" || c === "(") {
       depth++;
@@ -1482,16 +1529,16 @@ function checkCompound(compound, out) {
   };
   const readBalanced = (open, close) => {
     let depth = 0;
-    let quote4 = null;
+    let quote3 = null;
     const start = i + 1;
     for (; i < compound.length; i++) {
       const c = compound[i];
-      if (quote4) {
+      if (quote3) {
         if (c === "\\") i++;
-        else if (c === quote4) quote4 = null;
+        else if (c === quote3) quote3 = null;
         continue;
       }
-      if (c === '"' || c === "'") quote4 = c;
+      if (c === '"' || c === "'") quote3 = c;
       else if (c === open) depth++;
       else if (c === close && --depth === 0) {
         i++;
@@ -1631,17 +1678,7 @@ function pageKey(url) {
 }
 
 // ../core/src/codegen.ts
-var QUOTE_ESCAPES = {
-  "\\": "\\\\",
-  "'": "\\'",
-  "\n": "\\n",
-  "\r": "\\r",
-  "\u2028": "\\u2028",
-  "\u2029": "\\u2029"
-};
-function quote2(s) {
-  return `'${s.replace(/[\\'\n\r\u2028\u2029]/g, (c) => QUOTE_ESCAPES[c])}'`;
-}
+var quote = quoteJsString;
 var LINE_TERMINATORS = /[\n\r\u2028\u2029]/;
 function argIsSafe(arg) {
   switch (arg.type) {
@@ -1768,7 +1805,7 @@ function locatorForStep(step, index, ctx) {
   const chosen = chooseLocator(step.target, ctx.options);
   if (!chosen) {
     ctx.warnings.push({ step: index, code: "no-locator", message: "No locator was captured for this element." });
-    return `${ctx.page}.locator(${quote2("/* no locator captured */")})`;
+    return `${ctx.page}.locator(${quote("/* no locator captured */")})`;
   }
   if (chosen.level === "brittle") {
     ctx.warnings.push({
@@ -1801,12 +1838,12 @@ function renderAssertStep(step, index, ctx) {
       });
       return [`  // Step ${index + 1}: ${matcher} without an expected value.`];
     }
-    arg = quote2(matcher === "toHaveURL" ? urlForCode(assertion.expected, ctx) : assertion.expected);
+    arg = matcher === "toHaveCount" ? String(Number.parseInt(assertion.expected, 10) || 0) : quote(matcher === "toHaveURL" ? urlForCode(assertion.expected, ctx) : assertion.expected);
   }
   const subject = matcher === "toHaveURL" ? ctx.page : locatorForStep(step, index, ctx);
   let line = `  await expect(${subject})${not}.${matcher}(${arg});`;
   if (assertion?.actual != null && assertion.actual !== assertion.expected) {
-    line += ` // recorded: ${quote2(assertion.actual)}`;
+    line += ` // recorded: ${quote(assertion.actual)}`;
   }
   lines.push(line);
   return lines;
@@ -1814,12 +1851,27 @@ function renderAssertStep(step, index, ctx) {
 function fileNames(value) {
   return (value ?? "").split("\n").map((name) => name.trim().replace(/^.*[\\/]/, "")).filter(Boolean);
 }
+function renderManualStep(step, index, ctx) {
+  const description = commentText(step.manual?.description ?? "") || "a step to do by hand";
+  ctx.warnings.push({
+    step: index,
+    code: "manual-step",
+    detail: description,
+    message: `Step ${index + 1} cannot be written as code: ${description}`
+  });
+  const lines = [`  // Manual step: ${description}`];
+  const call = step.manual?.call ? commentText(step.manual.call) : "";
+  const location = step.manual?.location ? commentText(step.manual.location) : "";
+  if (call || location) lines.push(`  //   ${[call, location ? `at ${location}` : ""].filter(Boolean).join(" ")}`);
+  return lines;
+}
 function renderRawStep(step, index, ctx) {
   const { page } = ctx;
-  if (step.action === "goto") return [`  await ${page}.goto(${quote2(urlForCode(step.value ?? step.pageUrl, ctx))});`];
+  if (step.action === "goto") return [`  await ${page}.goto(${quote(urlForCode(step.value ?? step.pageUrl, ctx))});`];
   if (step.action === "assert" || step.action === "assertVisible") return renderAssertStep(step, index, ctx);
+  if (step.action === "manual") return renderManualStep(step, index, ctx);
   if (step.action === "press" && !step.target) {
-    return [`  await ${page}.keyboard.press(${quote2(step.value ?? "Enter")});`];
+    return [`  await ${page}.keyboard.press(${quote(step.value ?? "Enter")});`];
   }
   const loc = locatorForStep(step, index, ctx);
   switch (step.action) {
@@ -1840,23 +1892,23 @@ function renderRawStep(step, index, ctx) {
         detail: names.join(", "),
         message: `A file was chosen here (${names.join(", ")}); the spec reads it from the directory Playwright runs in.`
       });
-      const files = names.length === 1 ? quote2(names[0]) : `[${names.map(quote2).join(", ")}]`;
+      const files = names.length === 1 ? quote(names[0]) : `[${names.map(quote).join(", ")}]`;
       return [`  await ${loc}.setInputFiles(${files});`];
     }
     case "hover":
       return [`  await ${loc}.hover();`];
     case "fill": {
       if (readsEnv(step, ctx)) return [`  await ${loc}.fill(process.env.${envVarFor(step, index, ctx)} ?? '');`];
-      return [`  await ${loc}.fill(${quote2(step.value ?? "")});`];
+      return [`  await ${loc}.fill(${quote(step.value ?? "")});`];
     }
     case "check":
       return [`  await ${loc}.check();`];
     case "uncheck":
       return [`  await ${loc}.uncheck();`];
     case "selectOption":
-      return [`  await ${loc}.selectOption(${quote2(step.value ?? "")});`];
+      return [`  await ${loc}.selectOption(${quote(step.value ?? "")});`];
     case "press":
-      return [`  await ${loc}.press(${quote2(step.value ?? "Enter")});`];
+      return [`  await ${loc}.press(${quote(step.value ?? "Enter")});`];
   }
 }
 var IDENTIFIER_RE = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
@@ -1939,7 +1991,7 @@ function objectArgExpr(param, match, envArgs) {
     const env = envArgs.get(key);
     const raw = match.args[key];
     if (env == null && raw == null) return null;
-    return `${IDENTIFIER_RE.test(field) ? field : quote2(field)}: ${env ?? quote2(raw)}`;
+    return `${IDENTIFIER_RE.test(field) ? field : quote(field)}: ${env ?? quote(raw)}`;
   }).filter((pair) => pair != null);
   return entries.length === 0 ? "{}" : `{ ${entries.join(", ")} }`;
 }
@@ -1967,7 +2019,7 @@ function argExpr(entry, match, envArgs) {
     if (raw == null) return p.type === "number" ? "0" : p.type === "boolean" ? "false" : "''";
     if (p.type === "number") return String(Number(raw) || 0);
     if (p.type === "boolean") return String(raw === "true" || raw === "1");
-    return quote2(raw);
+    return quote(raw);
   }).join(", ");
 }
 function renderFunctionCall(match, page, envArgs) {
@@ -1987,11 +2039,11 @@ function renderImports(usedEntries, given) {
       const moduleKey = `${entry.module}#${entry.importName}`;
       if (!seenModules.has(moduleKey)) {
         seenModules.add(moduleKey);
-        lines.push(`import { ${entry.importName} } from ${quote2(entry.module)};`);
+        lines.push(`import { ${entry.importName} } from ${quote(entry.module)};`);
       }
     } else if (!seenModules.has(entry.module + entry.name)) {
       seenModules.add(entry.module + entry.name);
-      lines.push(`import { ${entry.name} } from ${quote2(entry.module)};`);
+      lines.push(`import { ${entry.name} } from ${quote(entry.module)};`);
     }
   }
   return lines;
@@ -2011,12 +2063,12 @@ function renderDetails(options) {
   const tags = (options.tags ?? []).map((t) => t.trim()).filter(Boolean);
   const annotations = (options.annotations ?? []).filter((a) => a.type.trim());
   const lines = [];
-  if (tags.length > 0) lines.push(`  tag: [${tags.map((t) => quote2(t.startsWith("@") ? t : `@${t}`)).join(", ")}],`);
+  if (tags.length > 0) lines.push(`  tag: [${tags.map((t) => quote(t.startsWith("@") ? t : `@${t}`)).join(", ")}],`);
   if (annotations.length > 0) {
     lines.push("  annotation: [");
     for (const a of annotations) {
-      const description = a.description != null ? `, description: ${quote2(a.description)}` : "";
-      lines.push(`    { type: ${quote2(a.type)}${description} },`);
+      const description = a.description != null ? `, description: ${quote(a.description)}` : "";
+      lines.push(`    { type: ${quote(a.type)}${description} },`);
     }
     lines.push("  ],");
   }
@@ -2028,6 +2080,7 @@ function expectFailLine(options) {
   return reason ? `  test.fail(); // ${reason}` : "  test.fail();";
 }
 function samePage(a, b) {
+  if (!a || !b) return true;
   const ka = pageKey(a);
   const kb = pageKey(b);
   return ka === null || kb === null || ka === kb;
@@ -2049,7 +2102,7 @@ function wrapInPageSteps(lines, starts, origin) {
   const out = lines.slice(0, starts[0].line);
   starts.forEach((start, n) => {
     const end = starts[n + 1]?.line ?? lines.length;
-    out.push(`  await test.step(${quote2(pageStepTitle(start.url, origin))}, async () => {`);
+    out.push(`  await test.step(${quote(pageStepTitle(start.url, origin))}, async () => {`);
     out.push(...lines.slice(start.line, end).map((line) => `  ${line}`));
     out.push("  });");
   });
@@ -2079,7 +2132,7 @@ function renderSpec(session, options = {}) {
   const pageStarts = [];
   const enterPageOf = (index) => {
     const url = steps[index]?.pageUrl;
-    if (options.testSteps !== "page" || url == null) return;
+    if (options.testSteps !== "page" || !url) return;
     const last = pageStarts[pageStarts.length - 1];
     if (!last || !samePage(last.url, url)) pageStarts.push({ line: bodyLines.length, url });
   };
@@ -2091,7 +2144,7 @@ function renderSpec(session, options = {}) {
     const pattern = pageUrlPattern(next.pageUrl);
     enterPageOf(last + 1);
     if (pattern) bodyLines.push(`  await expect(${page}).toHaveURL(${pattern});`);
-    const acts = next.action !== "assert" && next.action !== "assertVisible";
+    const acts = next.action !== "assert" && next.action !== "assertVisible" && next.action !== "manual";
     const chosen = acts && next.target ? chooseLocator(next.target, options) : null;
     if (chosen) bodyLines.push(`  await expect(${page}.${chosen.text}).toHaveCount(1);`);
   };
@@ -2135,7 +2188,7 @@ function renderSpec(session, options = {}) {
   const start = viewportAt.get(0);
   const opening = [
     ...start ? [viewportLine(start, page)] : [],
-    ...!sawGoto && session.startUrl ? [`  await ${page}.goto(${quote2(urlForCode(session.startUrl, ctx))});`] : []
+    ...!sawGoto && session.startUrl ? [`  await ${page}.goto(${quote(urlForCode(session.startUrl, ctx))});`] : []
   ];
   bodyLines.unshift(...opening);
   const bodyOffset = opening.length;
@@ -2172,7 +2225,7 @@ function renderSpec(session, options = {}) {
   }
   const details = renderDetails(options);
   const fixture = [.../* @__PURE__ */ new Set([page.split(".")[0], ...fixtureReceivers])].join(", ");
-  const testOpening = details.length > 0 ? [`test(${quote2(title)}, {`, ...details, `}, async ({ ${fixture} }) => {`] : [`test(${quote2(title)}, async ({ ${fixture} }) => {`];
+  const testOpening = details.length > 0 ? [`test(${quote(title)}, {`, ...details, `}, async ({ ${fixture} }) => {`] : [`test(${quote(title)}, async ({ ${fixture} }) => {`];
   if (options.format === "test") {
     const needs = needsLines("");
     return result([...needs, ...testOpening, ...testBody, `});`, ``], needs.length + testOpening.length);
@@ -2181,7 +2234,7 @@ function renderSpec(session, options = {}) {
     // Package name interpolated rather than adjoining the preceding keyword
     // directly, so this generated-code line does not itself look like a real
     // import to the boundary test in tests/boundary.test.ts.
-    `import { test, expect } from ${quote2(options.testImport?.trim() || "@playwright/test")};`,
+    `import { test, expect } from ${quote(options.testImport?.trim() || "@playwright/test")};`,
     ...importLines,
     ``,
     ...testOpening,
@@ -2193,7 +2246,11 @@ function renderSpec(session, options = {}) {
 }
 
 // ../core/src/steps.ts
-var STEPS_VERSION = 1;
+var STEPS_VERSION = 2;
+var VERSION_2_MATCHERS = /* @__PURE__ */ new Set(["toContainText", "toHaveCount", "toBeChecked"]);
+function stepsVersionFor(steps) {
+  return steps.some((s) => s.action === "manual" || !!s.assertion && VERSION_2_MATCHERS.has(s.assertion.matcher)) ? 2 : 1;
+}
 var STEPS_LIMITS = {
   steps: 200,
   alternatives: 10,
@@ -2220,7 +2277,8 @@ var ACTIONS = /* @__PURE__ */ new Set([
   "setInputFiles",
   "dragTo",
   "assertVisible",
-  "assert"
+  "assert",
+  "manual"
 ]);
 function originOf2(url) {
   try {
@@ -2245,7 +2303,7 @@ function toAbsolute(url, origin) {
 function toStepsDocument(session, meta = {}) {
   const origin = originOf2(session.startUrl) ?? originOf2(session.steps[0]?.pageUrl ?? "");
   return {
-    v: STEPS_VERSION,
+    v: stepsVersionFor(session.steps),
     title: meta.title ?? null,
     origin,
     recordedAt: session.startedAt,
@@ -2285,43 +2343,43 @@ var Checker = class {
   constructor() {
     this.errors = [];
   }
-  fail(path23, message) {
-    if (this.errors.length < 20) this.errors.push(`${path23}: ${message}`);
+  fail(path24, message) {
+    if (this.errors.length < 20) this.errors.push(`${path24}: ${message}`);
   }
-  text(v, path23, max, nullable) {
+  text(v, path24, max, nullable) {
     if (v == null) {
-      if (!nullable) this.fail(path23, "is required");
+      if (!nullable) this.fail(path24, "is required");
       return null;
     }
     if (typeof v !== "string") {
-      this.fail(path23, "must be a string");
+      this.fail(path24, "must be a string");
       return null;
     }
-    if (v.length > max) this.fail(path23, `is longer than ${max} characters`);
+    if (v.length > max) this.fail(path24, `is longer than ${max} characters`);
     return v;
   }
-  number(v, path23) {
+  number(v, path24) {
     if (typeof v !== "number" || !Number.isFinite(v)) {
-      this.fail(path23, "must be a number");
+      this.fail(path24, "must be a number");
       return 0;
     }
     return v;
   }
 };
-function checkTarget(c, v, path23) {
+function checkTarget(c, v, path24) {
   if (v == null) return null;
   if (!isObject(v)) {
-    c.fail(path23, "must be an object");
+    c.fail(path24, "must be an object");
     return null;
   }
   const alternativesIn = v.alternatives ?? [];
   const alternatives = [];
-  if (!Array.isArray(alternativesIn)) c.fail(`${path23}.alternatives`, "must be a list");
+  if (!Array.isArray(alternativesIn)) c.fail(`${path24}.alternatives`, "must be a list");
   else if (alternativesIn.length > STEPS_LIMITS.alternatives)
-    c.fail(`${path23}.alternatives`, `holds more than ${STEPS_LIMITS.alternatives}`);
+    c.fail(`${path24}.alternatives`, `holds more than ${STEPS_LIMITS.alternatives}`);
   else {
     alternativesIn.forEach((alt, i) => {
-      const at = `${path23}.alternatives[${i}]`;
+      const at = `${path24}.alternatives[${i}]`;
       if (!isObject(alt)) return c.fail(at, "must be an object");
       const locator = c.text(alt.locator, `${at}.locator`, STEPS_LIMITS.textLength, false);
       const safe = locator ? safeLocator(locator) : null;
@@ -2335,31 +2393,47 @@ function checkTarget(c, v, path23) {
     });
   }
   return {
-    tagName: c.text(v.tagName, `${path23}.tagName`, 64, false) ?? "",
-    role: c.text(v.role, `${path23}.role`, 64, true),
-    accessibleName: c.text(v.accessibleName, `${path23}.accessibleName`, STEPS_LIMITS.textLength, true),
-    testId: c.text(v.testId, `${path23}.testId`, STEPS_LIMITS.textLength, true),
-    text: c.text(v.text, `${path23}.text`, STEPS_LIMITS.textLength, true),
+    tagName: c.text(v.tagName, `${path24}.tagName`, 64, false) ?? "",
+    role: c.text(v.role, `${path24}.role`, 64, true),
+    accessibleName: c.text(v.accessibleName, `${path24}.accessibleName`, STEPS_LIMITS.textLength, true),
+    testId: c.text(v.testId, `${path24}.testId`, STEPS_LIMITS.textLength, true),
+    text: c.text(v.text, `${path24}.text`, STEPS_LIMITS.textLength, true),
     alternatives
   };
 }
-function checkAssertion(c, v, path23) {
+function checkAssertion(c, v, path24) {
   if (!isObject(v)) {
-    c.fail(path23, "is required on an assert step");
+    c.fail(path24, "is required on an assert step");
     return void 0;
   }
   const matcher = v.matcher;
   if (!ASSERTION_MATCHERS.includes(matcher)) {
-    c.fail(`${path23}.matcher`, `must be one of ${ASSERTION_MATCHERS.join(", ")}`);
+    c.fail(`${path24}.matcher`, `must be one of ${ASSERTION_MATCHERS.join(", ")}`);
     return void 0;
   }
-  const expected = c.text(v.expected, `${path23}.expected`, STEPS_LIMITS.valueLength, !VALUE_MATCHERS.has(matcher));
+  const expected = c.text(v.expected, `${path24}.expected`, STEPS_LIMITS.valueLength, !VALUE_MATCHERS.has(matcher));
+  if (matcher === "toHaveCount" && expected != null && !/^\d{1,6}$/.test(expected)) {
+    c.fail(`${path24}.expected`, "must be a whole number of elements on a toHaveCount assertion");
+  }
   return {
     matcher,
     expected: VALUE_MATCHERS.has(matcher) ? expected : null,
-    actual: c.text(v.actual, `${path23}.actual`, STEPS_LIMITS.valueLength, true),
+    actual: c.text(v.actual, `${path24}.actual`, STEPS_LIMITS.valueLength, true),
     negated: v.negated === true,
-    note: c.text(v.note, `${path23}.note`, STEPS_LIMITS.valueLength, true)
+    note: c.text(v.note, `${path24}.note`, STEPS_LIMITS.valueLength, true)
+  };
+}
+function checkManual(c, v, path24) {
+  if (!isObject(v)) {
+    c.fail(path24, "is required on a manual step");
+    return void 0;
+  }
+  const description = c.text(v.description, `${path24}.description`, STEPS_LIMITS.valueLength, false);
+  if (description != null && !description.trim()) c.fail(`${path24}.description`, "must not be empty");
+  return {
+    description: description ?? "",
+    location: c.text(v.location, `${path24}.location`, STEPS_LIMITS.textLength, true),
+    call: c.text(v.call, `${path24}.call`, STEPS_LIMITS.textLength, true)
   };
 }
 function checkViewports(c, v, stepCount) {
@@ -2400,40 +2474,43 @@ function checkViewports(c, v, stepCount) {
   });
   return out;
 }
-function checkStep(c, v, path23) {
+function checkStep(c, v, path24) {
   if (!isObject(v)) {
-    c.fail(path23, "must be an object");
+    c.fail(path24, "must be an object");
     return null;
   }
   const action = v.action;
   if (!ACTIONS.has(action)) {
-    c.fail(`${path23}.action`, "is not a known action");
+    c.fail(`${path24}.action`, "is not a known action");
     return null;
   }
   const step = {
     action: action === "assertVisible" ? "assert" : action,
-    target: checkTarget(c, v.target, `${path23}.target`),
-    value: c.text(v.value, `${path23}.value`, STEPS_LIMITS.valueLength, true),
+    target: checkTarget(c, v.target, `${path24}.target`),
+    value: c.text(v.value, `${path24}.value`, STEPS_LIMITS.valueLength, true),
     redacted: v.redacted === true,
-    pageUrl: c.text(v.pageUrl, `${path23}.pageUrl`, STEPS_LIMITS.valueLength, false) ?? "",
-    timestamp: v.timestamp == null ? 0 : c.number(v.timestamp, `${path23}.timestamp`)
+    pageUrl: c.text(v.pageUrl, `${path24}.pageUrl`, STEPS_LIMITS.valueLength, false) ?? "",
+    timestamp: v.timestamp == null ? 0 : c.number(v.timestamp, `${path24}.timestamp`)
   };
   if (step.redacted) step.value = null;
   if (action === "hover" || action === "dblclick") {
     step.value = null;
-    if (!step.target) c.fail(`${path23}.target`, `is required on a ${action} step`);
+    if (!step.target) c.fail(`${path24}.target`, `is required on a ${action} step`);
   }
-  if (action === "setInputFiles" && !step.target) c.fail(`${path23}.target`, "is required on a setInputFiles step");
+  if (action === "setInputFiles" && !step.target) c.fail(`${path24}.target`, "is required on a setInputFiles step");
   if (action === "dragTo") {
     step.value = null;
-    if (!step.target) c.fail(`${path23}.target`, "is required on a dragTo step");
-    step.dropTarget = checkTarget(c, v.dropTarget, `${path23}.dropTarget`);
-    if (!step.dropTarget) c.fail(`${path23}.dropTarget`, "is required on a dragTo step");
+    if (!step.target) c.fail(`${path24}.target`, "is required on a dragTo step");
+    step.dropTarget = checkTarget(c, v.dropTarget, `${path24}.dropTarget`);
+    if (!step.dropTarget) c.fail(`${path24}.dropTarget`, "is required on a dragTo step");
   }
   if (action === "assertVisible") {
     step.assertion = { matcher: "toBeVisible", expected: null, actual: null, negated: false, note: null };
   } else if (action === "assert") {
-    step.assertion = checkAssertion(c, v.assertion, `${path23}.assertion`);
+    step.assertion = checkAssertion(c, v.assertion, `${path24}.assertion`);
+  } else if (action === "manual") {
+    step.value = null;
+    step.manual = checkManual(c, v.manual, `${path24}.manual`);
   }
   return step;
 }
@@ -2449,8 +2526,8 @@ function parseSteps(input) {
   if (!isObject(value)) return { ok: false, errors: ["a steps document must be a JSON object"] };
   const c = new Checker();
   const legacy = value.v == null && typeof value.startUrl === "string";
-  if (!legacy && value.v !== STEPS_VERSION) {
-    return { ok: false, errors: [`v: this reads version ${STEPS_VERSION}, not ${JSON.stringify(value.v)}`] };
+  if (!legacy && value.v !== 1 && value.v !== STEPS_VERSION) {
+    return { ok: false, errors: [`v: this reads versions 1 to ${STEPS_VERSION}, not ${JSON.stringify(value.v)}`] };
   }
   if (!Array.isArray(value.steps)) return { ok: false, errors: ["steps: must be a list"] };
   if (value.steps.length > STEPS_LIMITS.steps) {
@@ -2473,7 +2550,7 @@ function parseSteps(input) {
     if (originText && !origin) c.fail("origin", "must be an http(s) origin");
     const viewports = checkViewports(c, value.viewports, steps.length);
     doc = {
-      v: STEPS_VERSION,
+      v: stepsVersionFor(steps),
       title: c.text(value.title, "title", STEPS_LIMITS.textLength, true),
       origin,
       recordedAt: value.recordedAt == null ? 0 : c.number(value.recordedAt, "recordedAt"),
@@ -2732,8 +2809,8 @@ ${USAGE3}`);
     }
   } else {
     try {
-      if (fs5.statSync(args.file).size > MAX_STEPS_FILE_BYTES) throw new Error("is too large to be a steps file");
-      text = fs5.readFileSync(args.file, "utf-8");
+      if (fs6.statSync(args.file).size > MAX_STEPS_FILE_BYTES) throw new Error("is too large to be a steps file");
+      text = fs6.readFileSync(args.file, "utf-8");
     } catch (e) {
       const reason = e.code === "ENOENT" ? "does not exist" : e.message;
       console.error(`piwi codegen: ${args.file} ${reason}`);
@@ -2765,8 +2842,8 @@ ${USAGE3}`);
     return EXIT_OK3;
   }
   try {
-    fs5.mkdirSync(path8.dirname(args.out), { recursive: true });
-    fs5.writeFileSync(args.out, result.code, { flag: args.force ? "w" : "wx" });
+    fs6.mkdirSync(path9.dirname(args.out), { recursive: true });
+    fs6.writeFileSync(args.out, result.code, { flag: args.force ? "w" : "wx" });
   } catch (e) {
     const exists = e.code === "EEXIST";
     console.error(`piwi codegen: ${exists ? `${args.out} exists \u2014 pass --force to replace it` : e.message}`);
@@ -2780,7 +2857,7 @@ ${USAGE3}`);
 }
 
 // src/cli/coverage.ts
-var path12 = __toESM(require("path"));
+var path14 = __toESM(require("path"));
 
 // ../core/src/codeowners.ts
 function patternParts(pattern) {
@@ -2818,10 +2895,10 @@ function pathPatternMatcher(pattern) {
   const { segments, floating } = patternParts(pattern);
   if (floating) {
     const only = segments[0];
-    return (path23) => path23.split("/").some((part) => segmentMatches(only, part));
+    return (path24) => path24.split("/").some((part) => segmentMatches(only, part));
   }
-  return (path23) => {
-    const parts = path23.split("/");
+  return (path24) => {
+    const parts = path24.split("/");
     let at = new Uint8Array(parts.length);
     at[0] = 1;
     for (let i = 0; i < segments.length; i++) {
@@ -2887,8 +2964,8 @@ function parseCoverageScope(raw) {
 function compileCoverageScope(scope) {
   const include = scope.include.map(pathPatternMatcher);
   const exclude = scope.exclude.map(pathPatternMatcher);
-  return (path23) => {
-    const file = path23.replace(/\\/g, "/").replace(/^\.?\//, "");
+  return (path24) => {
+    const file = path24.replace(/\\/g, "/").replace(/^\.?\//, "");
     if (include.length > 0 && !include.some((matches) => matches(file))) return false;
     return !exclude.some((matches) => matches(file));
   };
@@ -2903,6 +2980,9 @@ function errorMessage(error) {
   return String(error);
 }
 
+// src/internal/support/test-paths.ts
+var path10 = __toESM(require("path"));
+
 // src/internal/collect/metadata-collector.ts
 var DETACHED_HEAD = "HEAD";
 function resolveScmBranch(env, gitBranch) {
@@ -2934,14 +3014,14 @@ function normalizeRef(ref) {
 
 // src/internal/coverage-upload/git-inventory.ts
 var import_node_child_process5 = require("child_process");
-var fs7 = __toESM(require("fs"));
-var path10 = __toESM(require("path"));
+var fs8 = __toESM(require("fs"));
+var path12 = __toESM(require("path"));
 
 // src/internal/collect/blob-ids.ts
 var import_node_child_process4 = require("child_process");
 var crypto2 = __toESM(require("crypto"));
-var fs6 = __toESM(require("fs"));
-var path9 = __toESM(require("path"));
+var fs7 = __toESM(require("fs"));
+var path11 = __toESM(require("path"));
 function gitHashObjects(root, paths) {
   return new Promise((resolve10) => {
     const child = (0, import_node_child_process4.execFile)(
@@ -3008,7 +3088,7 @@ async function readInventory(root, warn = () => {
   const changed = [];
   for (const file of (await git(root, ["diff", "--name-only", "-z", "HEAD"]).catch(() => "")).split("\0")) {
     if (!file || !inventory.has(file)) continue;
-    if (fs7.existsSync(path10.join(root, file))) changed.push(file);
+    if (fs8.existsSync(path12.join(root, file))) changed.push(file);
     else inventory.delete(file);
   }
   const ids = await hashPaths(root, changed);
@@ -3027,8 +3107,8 @@ async function readInventory(root, warn = () => {
 }
 
 // src/internal/coverage-upload/report-files.ts
-var fs8 = __toESM(require("fs"));
-var path11 = __toESM(require("path"));
+var fs9 = __toESM(require("fs"));
+var path13 = __toESM(require("path"));
 
 // ../core/src/coverage.ts
 var MAX_LINE = 1e6;
@@ -3107,7 +3187,7 @@ var FileLines = class {
       this.functions.set(key, { start, end: last, ran });
     }
   }
-  toFile(path23) {
+  toFile(path24) {
     const executable = [];
     const lines = [];
     const push = (ranges, line) => {
@@ -3127,7 +3207,7 @@ var FileLines = class {
       if (didRun) ran.push([start, end]);
     }
     return {
-      path: path23,
+      path: path24,
       executable,
       lines,
       functions: normalizeFunctionRanges(ran),
@@ -3139,16 +3219,16 @@ var ReportFiles = class {
   constructor() {
     this.byPath = /* @__PURE__ */ new Map();
   }
-  of(path23) {
-    let file = this.byPath.get(path23);
+  of(path24) {
+    let file = this.byPath.get(path24);
     if (!file) {
       file = new FileLines();
-      this.byPath.set(path23, file);
+      this.byPath.set(path24, file);
     }
     return file;
   }
   toFiles() {
-    return [...this.byPath].map(([path23, file]) => file.toFile(path23));
+    return [...this.byPath].map(([path24, file]) => file.toFile(path24));
   }
 };
 var XML_ENTITIES = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
@@ -3231,21 +3311,21 @@ var CoberturaReader = class {
     if (head.length < 9 && ("<!--".startsWith(head) || "<![CDATA[".startsWith(head))) return -1;
     if (head.startsWith("<!--")) return this.through(text, open, "-->", 4);
     if (head.startsWith("<![CDATA[")) return this.through(text, open, "]]>", 9);
-    let quote4 = this.quote;
+    let quote3 = this.quote;
     for (let at = open + Math.max(1, this.scanned); at < text.length; at++) {
       const char = text.charCodeAt(at);
-      if (quote4 !== 0) {
-        if (char === quote4) quote4 = 0;
+      if (quote3 !== 0) {
+        if (char === quote3) quote3 = 0;
       } else if (char === GREATER_THAN) {
         this.scanned = 0;
         this.quote = 0;
         return at;
       } else if (char === DOUBLE_QUOTE || char === SINGLE_QUOTE) {
-        quote4 = char;
+        quote3 = char;
       }
     }
     this.scanned = text.length - open;
-    this.quote = quote4;
+    this.quote = quote3;
     return -1;
   }
   /** Where a comment or CDATA section starting at `open` ends: the last character of `end`; -1 if not yet read. */
@@ -3487,36 +3567,36 @@ function normalizeSlashPath(raw) {
   }
   return (drive || (absolute ? "/" : "")) + out.join("/");
 }
-function isAbsolutePath(path23) {
-  return path23.startsWith("/") || /^[A-Za-z]:\//.test(path23);
+function isAbsolutePath(path24) {
+  return path24.startsWith("/") || /^[A-Za-z]:\//.test(path24);
 }
-function relativeTo(path23, root) {
+function relativeTo(path24, root) {
   const drive = /^[A-Za-z]:/.test(root);
   const base = root.endsWith("/") ? root : `${root}/`;
-  const head = path23.slice(0, base.length);
+  const head = path24.slice(0, base.length);
   const inside = drive ? head.toLowerCase() === base.toLowerCase() : head === base;
   if (!inside) return null;
-  const relative8 = path23.slice(base.length);
-  return relative8 || null;
+  const relative9 = path24.slice(base.length);
+  return relative9 || null;
 }
 function reportPathCandidates(raw, { repoRoot, bases }) {
   const slash = (value) => value.replace(/\\/g, "/");
   const root = normalizeSlashPath(slash(repoRoot));
-  const path23 = slash(raw.trim());
-  if (!root || !path23 || path23.includes("\0")) return [];
+  const path24 = slash(raw.trim());
+  if (!root || !path24 || path24.includes("\0")) return [];
   const out = [];
   const add = (absolute) => {
     const normalized = normalizeSlashPath(absolute);
     if (!normalized) return;
-    const relative8 = normalized.startsWith("/_/") ? normalized.slice(3) : relativeTo(normalized, root);
-    if (relative8 && !out.includes(relative8)) out.push(relative8);
+    const relative9 = normalized.startsWith("/_/") ? normalized.slice(3) : relativeTo(normalized, root);
+    if (relative9 && !out.includes(relative9)) out.push(relative9);
   };
-  if (isAbsolutePath(path23)) {
-    add(path23);
+  if (isAbsolutePath(path24)) {
+    add(path24);
   } else {
     for (const base of bases) {
       const dir = slash(base);
-      if (isAbsolutePath(dir)) add(`${dir}/${path23}`);
+      if (isAbsolutePath(dir)) add(`${dir}/${path24}`);
     }
   }
   return out;
@@ -3540,14 +3620,14 @@ function globSegmentRegExp(segment) {
 function expandPattern(pattern, cwd) {
   const normalized = pattern.replace(/\\/g, "/");
   if (!/[*?]/.test(normalized)) {
-    const file = path11.resolve(cwd, normalized);
-    return fs8.existsSync(file) && fs8.statSync(file).isFile() ? [file] : [];
+    const file = path13.resolve(cwd, normalized);
+    return fs9.existsSync(file) && fs9.statSync(file).isFile() ? [file] : [];
   }
-  const absolute = path11.isAbsolute(normalized) || /^[A-Za-z]:\//.test(normalized);
+  const absolute = path13.isAbsolute(normalized) || /^[A-Za-z]:\//.test(normalized);
   const segments = normalized.split("/");
   const firstWild = segments.findIndex((s) => /[*?]/.test(s));
   const baseParts = segments.slice(0, firstWild);
-  const base = absolute ? baseParts.join("/") || "/" : path11.resolve(cwd, ...baseParts);
+  const base = absolute ? baseParts.join("/") || "/" : path13.resolve(cwd, ...baseParts);
   const rest = segments.slice(firstWild).filter((s) => s !== "");
   const out = [];
   const walk = (dir, at) => {
@@ -3555,14 +3635,14 @@ function expandPattern(pattern, cwd) {
     const segment = rest[at];
     let entries;
     try {
-      entries = fs8.readdirSync(dir, { withFileTypes: true });
+      entries = fs9.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
     if (segment === "**") {
       walk(dir, at + 1);
       for (const entry of entries) {
-        if (entry.isDirectory() && !SKIPPED_DIRS.has(entry.name)) walk(path11.join(dir, entry.name), at);
+        if (entry.isDirectory() && !SKIPPED_DIRS.has(entry.name)) walk(path13.join(dir, entry.name), at);
       }
       return;
     }
@@ -3570,7 +3650,7 @@ function expandPattern(pattern, cwd) {
     const last = at === rest.length - 1;
     for (const entry of entries) {
       if (!match.test(entry.name)) continue;
-      const full = path11.join(dir, entry.name);
+      const full = path13.join(dir, entry.name);
       if (last && entry.isFile()) out.push(full);
       else if (!last && entry.isDirectory() && (!SKIPPED_DIRS.has(entry.name) || segment === entry.name)) {
         walk(full, at + 1);
@@ -3583,7 +3663,7 @@ function expandPattern(pattern, cwd) {
 async function readReport(file, format) {
   let reader = format ? new CoverageReportReader(format) : null;
   let head = "";
-  for await (const chunk of fs8.createReadStream(file, { encoding: "utf8", highWaterMark: 1024 * 1024 })) {
+  for await (const chunk of fs9.createReadStream(file, { encoding: "utf8", highWaterMark: 1024 * 1024 })) {
     if (!reader) {
       head += chunk;
       if (head.length < 4096) continue;
@@ -3605,18 +3685,18 @@ async function readReport(file, format) {
   return reader.end();
 }
 function reportBases(report, reportFile, options) {
-  if (options.root) return [path11.resolve(options.cwd, options.root)];
-  const dir = path11.dirname(path11.resolve(reportFile));
+  if (options.root) return [path13.resolve(options.cwd, options.root)];
+  const dir = path13.dirname(path13.resolve(reportFile));
   const sources = report.sources.map(
-    (source) => path11.isAbsolute(source) || /^[A-Za-z]:[\\/]/.test(source) ? source : path11.resolve(dir, source)
+    (source) => path13.isAbsolute(source) || /^[A-Za-z]:[\\/]/.test(source) ? source : path13.resolve(dir, source)
   );
-  return [...sources, options.cwd, dir, path11.dirname(dir), options.repoRoot];
+  return [...sources, options.cwd, dir, path13.dirname(dir), options.repoRoot];
 }
 function resolveReport(report, reportFile, options, into) {
   const bases = reportBases(report, reportFile, options);
   for (const file of report.files) {
     const candidates = reportPathCandidates(file.path, { repoRoot: options.repoRoot, bases });
-    const match = candidates.find((candidate) => options.inventory.has(candidate)) ?? candidates.find((candidate) => fs8.existsSync(path11.join(options.repoRoot, candidate)));
+    const match = candidates.find((candidate) => options.inventory.has(candidate)) ?? candidates.find((candidate) => fs9.existsSync(path13.join(options.repoRoot, candidate)));
     if (!match) {
       into.unmatched.push(file.path);
       continue;
@@ -3841,7 +3921,7 @@ async function uploadCoverage(args, env, cwd, warn = warnOnStderr) {
     commit: checkout.commit,
     branch,
     suite: args.suite,
-    reports: reports.map((report) => path12.relative(cwd, report) || report),
+    reports: reports.map((report) => path14.relative(cwd, report) || report),
     files: files.length,
     unmatched: resolved.unmatched.length,
     outOfScope: resolved.outOfScope,
@@ -3910,10 +3990,10 @@ ${USAGE4}`);
 }
 
 // src/cli/flake.ts
-var import_node_child_process7 = require("child_process");
+var import_node_child_process6 = require("child_process");
 var fs11 = __toESM(require("fs"));
 var os2 = __toESM(require("os"));
-var path15 = __toESM(require("path"));
+var path16 = __toESM(require("path"));
 
 // ../core/src/error-parse.ts
 var ANSI_RE = new RegExp("\\u001B\\[[0-9;]*m", "g");
@@ -3932,6 +4012,7 @@ var CHAIN_LINK_METHODS = /* @__PURE__ */ new Set([
 var LEAF_METHODS = new Set(LOCATOR_BUILDER_METHODS);
 var SUBJECTS = "locator|page|frame|frameLocator|elementHandle|mouse|keyboard|touchscreen|browserContext|browser|apiRequestContext|request|response|route|download|dialog|fileChooser|expect|worker|jsHandle|clock|tracing|video";
 var CALL_RE = new RegExp(`\\b(${SUBJECTS})\\.(\\w+): `);
+var MAX_PARSED_ERROR_CHARS = 64 * 1024;
 
 // ../core/src/flake-plan.ts
 var FLAKE_PLAN_VERSION = 1;
@@ -4114,8 +4195,8 @@ function withinBudget(startedAt, now, budgetMs) {
 }
 
 // src/internal/support/connection.ts
-var fs9 = __toESM(require("fs"));
-var path13 = __toESM(require("path"));
+var fs10 = __toESM(require("fs"));
+var path15 = __toESM(require("path"));
 
 // ../core/src/dotenv.ts
 function parseDotEnv(text) {
@@ -4124,10 +4205,10 @@ function parseDotEnv(text) {
     const m = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*?)\s*$/.exec(raw);
     if (!m) continue;
     let value = m[2];
-    const quote4 = value[0];
-    if ((quote4 === '"' || quote4 === "'") && value.length > 1 && value.endsWith(quote4)) {
+    const quote3 = value[0];
+    if ((quote3 === '"' || quote3 === "'") && value.length > 1 && value.endsWith(quote3)) {
       value = value.slice(1, -1);
-      if (quote4 === '"') value = value.replace(/\\n/g, "\n").replace(/\\"/g, '"');
+      if (quote3 === '"') value = value.replace(/\\n/g, "\n").replace(/\\"/g, '"');
     } else {
       value = value.replace(/\s+#.*$/, "");
     }
@@ -4156,7 +4237,7 @@ function resolveCliConnection(flags, env, dirs) {
   let dotEnv = {};
   for (const dir of dirs) {
     try {
-      dotEnv = { ...parseDotEnv(fs9.readFileSync(path13.join(dir, ".env"), "utf-8")), ...dotEnv };
+      dotEnv = { ...parseDotEnv(fs10.readFileSync(path15.join(dir, ".env"), "utf-8")), ...dotEnv };
     } catch {
     }
   }
@@ -4168,44 +4249,6 @@ function resolveCliConnection(flags, env, dirs) {
   });
 }
 
-// src/internal/support/playwright-spawn.ts
-var import_node_child_process6 = require("child_process");
-var fs10 = __toESM(require("fs"));
-var import_node_module2 = require("module");
-var path14 = __toESM(require("path"));
-function resolvePlaywrightCli2(cwd = process.cwd()) {
-  const require2 = (0, import_node_module2.createRequire)(path14.join(cwd, "noop.js"));
-  for (const id of ["playwright/cli", "@playwright/test/cli", "playwright/lib/cli/cli"]) {
-    try {
-      return require2.resolve(id);
-    } catch {
-    }
-  }
-  return null;
-}
-function spawnPlaywright(playwrightArgs2, env, options = {}) {
-  const output = options.output ?? "inherit";
-  let fd = output === "inherit" ? null : fs10.openSync(output.file, "a");
-  const stdio = fd === null ? "inherit" : ["ignore", fd, fd];
-  const cli = resolvePlaywrightCli2();
-  const child = cli ? (0, import_node_child_process6.spawn)(process.execPath, [cli, "test", ...playwrightArgs2], { stdio, env }) : (0, import_node_child_process6.spawn)(process.platform === "win32" ? "npx.cmd" : "npx", ["playwright", "test", ...playwrightArgs2], {
-    stdio,
-    env
-  });
-  return new Promise((resolve10) => {
-    const done = (code) => {
-      if (fd !== null) fs10.closeSync(fd);
-      fd = null;
-      resolve10(code);
-    };
-    child.on("error", (err) => {
-      console.error(`${options.command ?? "piwi"}: could not start Playwright \u2014 ${err.message}`);
-      done(2);
-    });
-    child.on("exit", (code) => done(code ?? 2));
-  });
-}
-
 // src/cli/flake.ts
 var USAGE5 = `
 piwi flake \u2014 make a flaky test fail on demand, then prove the fix
@@ -4351,7 +4394,7 @@ function parseFlakeArgs(argv) {
 }
 function gitHead() {
   try {
-    return (0, import_node_child_process7.execFileSync)("git", ["rev-parse", "HEAD"], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    return (0, import_node_child_process6.execFileSync)("git", ["rev-parse", "HEAD"], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
   } catch {
     return null;
   }
@@ -4395,7 +4438,7 @@ function playwrightRunner(dir, log) {
   return {
     now: () => Date.now(),
     async runBatch(plan, arm, repeat, batch) {
-      const planFile = path15.join(dir, `${arm.id}.plan.json`);
+      const planFile = path16.join(dir, `${arm.id}.plan.json`);
       if (!fs11.existsSync(planFile)) {
         fs11.writeFileSync(
           planFile,
@@ -4408,7 +4451,7 @@ function playwrightRunner(dir, log) {
           })
         );
       }
-      const resultsFile = path15.join(dir, `${arm.id}.${batch}.jsonl`);
+      const resultsFile = path16.join(dir, `${arm.id}.${batch}.jsonl`);
       fs11.writeFileSync(resultsFile, "");
       const env = {
         ...process.env,
@@ -4687,8 +4730,8 @@ async function runFlake(argv, runner) {
   if (!args.json) {
     printHeader(plan, commit, estimate, args.budgetMs);
   }
-  const dir = fs11.mkdtempSync(path15.join(os2.tmpdir(), "piwi-flake-"));
-  const log = path15.join(dir, "playwright.log");
+  const dir = fs11.mkdtempSync(path16.join(os2.tmpdir(), "piwi-flake-"));
+  const log = path16.join(dir, "playwright.log");
   let session;
   try {
     session = await runSession(runner ?? playwrightRunner(dir, log), plan, args, (result) => {
@@ -4879,9 +4922,9 @@ function readCount(argv, name) {
   if (!Number.isFinite(n) || n < 0) throw new Error(`${name} expects a non-negative number, got "${raw}"`);
   return Math.floor(n);
 }
-function readRunIdFromFile(path23) {
+function readRunIdFromFile(path24) {
   try {
-    const parsed = JSON.parse(fs12.readFileSync(path23, "utf-8"));
+    const parsed = JSON.parse(fs12.readFileSync(path24, "utf-8"));
     const runId = Number(parsed.runId);
     return Number.isFinite(runId) && runId > 0 ? runId : null;
   } catch {
@@ -4973,8 +5016,7 @@ async function runGate(argv, env = process.env) {
 
 // src/cli/init.ts
 var fs15 = __toESM(require("fs"));
-var path18 = __toESM(require("path"));
-var import_node_child_process8 = require("child_process");
+var path19 = __toESM(require("path"));
 
 // src/cli/report.ts
 var STATUS_MARK = {
@@ -4992,7 +5034,7 @@ function formatStep(result) {
 
 // src/cli/detect.ts
 var fs13 = __toESM(require("fs"));
-var path16 = __toESM(require("path"));
+var path17 = __toESM(require("path"));
 var CONFIG_NAMES = [
   "playwright.config.ts",
   "playwright.config.mts",
@@ -5010,7 +5052,7 @@ var LOCKFILES = [
 ];
 var REPORTER_PACKAGE = "@piwitests/reporter";
 function readPackageJson(root) {
-  const pkgPath = path16.join(root, "package.json");
+  const pkgPath = path17.join(root, "package.json");
   try {
     return { pkg: JSON.parse(fs13.readFileSync(pkgPath, "utf-8")), pkgPath };
   } catch {
@@ -5021,13 +5063,13 @@ function detectPackageManager(root, pkg) {
   const declared = pkg?.packageManager?.split("@")[0];
   if (declared === "pnpm" || declared === "yarn" || declared === "bun" || declared === "npm") return declared;
   for (const [file, manager] of LOCKFILES) {
-    if (fs13.existsSync(path16.join(root, file))) return manager;
+    if (fs13.existsSync(path17.join(root, file))) return manager;
   }
   return "npm";
 }
 function findConfig(root) {
   for (const name of CONFIG_NAMES) {
-    const candidate = path16.join(root, name);
+    const candidate = path17.join(root, name);
     if (fs13.existsSync(candidate)) return candidate;
   }
   return null;
@@ -5038,14 +5080,14 @@ function langOf(configPath) {
 }
 function suggestProjectName(root, pkg) {
   const fromPkg = pkg?.name?.replace(/^@[^/]+\//, "").trim();
-  return fromPkg || path16.basename(root) || "default-project";
+  return fromPkg || path17.basename(root) || "default-project";
 }
 function hasReporter(pkg) {
   if (!pkg) return false;
   return Boolean(pkg.dependencies?.[REPORTER_PACKAGE] || pkg.devDependencies?.[REPORTER_PACKAGE]);
 }
 function detectProject(root) {
-  const absRoot = path16.resolve(root);
+  const absRoot = path17.resolve(root);
   const { pkg, pkgPath } = readPackageJson(absRoot);
   const configPath = findConfig(absRoot);
   return {
@@ -5075,9 +5117,7 @@ function installCommand(manager) {
 // src/cli/configure.ts
 var REPORTER_IMPORT = "import { wrapConfig } from '@piwitests/reporter'";
 var MANUAL_HINT = "Could not find `export default defineConfig(...)`. Wrap your exported config by hand: import { wrapConfig } from '@piwitests/reporter', then export default wrapConfig(defineConfig({ ... }), { serverUrl, projectName }).";
-function quote3(value) {
-  return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
-}
+var quote2 = quoteJsString;
 function matchClosingParen(src, openIndex) {
   let depth = 0;
   let quoteChar = null;
@@ -5113,8 +5153,8 @@ function matchClosingParen(src, openIndex) {
 }
 function optionsLiteral(opts) {
   const lines = [];
-  if (opts.serverUrl) lines.push(`    serverUrl: ${quote3(opts.serverUrl)},`);
-  lines.push(`    projectName: ${quote3(opts.projectName)},`);
+  if (opts.serverUrl) lines.push(`    serverUrl: ${quote2(opts.serverUrl)},`);
+  lines.push(`    projectName: ${quote2(opts.projectName)},`);
   return `{
 ${lines.join("\n")}
   }`;
@@ -5188,7 +5228,7 @@ function ensureGitignoreEntry(existing, entry = ".env") {
 
 // src/cli/skills.ts
 var fs14 = __toESM(require("fs"));
-var path17 = __toESM(require("path"));
+var path18 = __toESM(require("path"));
 
 // ../core/src/skill-stamp.ts
 var SKILL_VERSION_KEY = "piwi-version";
@@ -5251,16 +5291,16 @@ var WORKFLOW_SKILLS = [
   "fix-a-reported-bug"
 ];
 var ALL_SKILLS = [SETUP_SKILL, ...WORKFLOW_SKILLS];
-var DEFAULT_SKILLS_DIR = path17.join(".claude", "skills");
+var DEFAULT_SKILLS_DIR = path18.join(".claude", "skills");
 function findTemplatesDir(fromDir) {
   let dir = fromDir;
   for (let i = 0; i < 6; i++) {
-    if (fs14.existsSync(path17.join(dir, "templates", "skills"))) return path17.join(dir, "templates");
-    const parent = path17.dirname(dir);
+    if (fs14.existsSync(path18.join(dir, "templates", "skills"))) return path18.join(dir, "templates");
+    const parent = path18.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return path17.resolve(fromDir, "..", "..", "templates");
+  return path18.resolve(fromDir, "..", "..", "templates");
 }
 function readFrontMatter(markdown) {
   const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(markdown);
@@ -5274,14 +5314,14 @@ function readFrontMatter(markdown) {
 }
 function readTemplatesVersion(templatesDir) {
   try {
-    const pkg = JSON.parse(fs14.readFileSync(path17.join(templatesDir, "..", "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs14.readFileSync(path18.join(templatesDir, "..", "package.json"), "utf-8"));
     return typeof pkg.version === "string" ? pkg.version : "0.0.0";
   } catch {
     return "0.0.0";
   }
 }
 function templatePath(templatesDir, slug) {
-  return path17.join(templatesDir, "skills", slug, "SKILL.md");
+  return path18.join(templatesDir, "skills", slug, "SKILL.md");
 }
 function listSkills(templatesDir, slugs = ALL_SKILLS) {
   const infos = [];
@@ -5298,8 +5338,8 @@ function installSkills(opts) {
   for (const slug of opts.slugs) {
     const step = `skill:${slug}`;
     const source = templatePath(opts.templatesDir, slug);
-    const relDest = path17.join(opts.skillsDir, slug, "SKILL.md");
-    const dest = path17.join(opts.root, relDest);
+    const relDest = path18.join(opts.skillsDir, slug, "SKILL.md");
+    const dest = path18.join(opts.root, relDest);
     if (!fs14.existsSync(source)) {
       results.push({ step, status: "error", detail: `no template found for "${slug}"` });
       continue;
@@ -5331,7 +5371,7 @@ function installSkills(opts) {
       }
     }
     if (!opts.dryRun) {
-      fs14.mkdirSync(path17.dirname(dest), { recursive: true });
+      fs14.mkdirSync(path18.dirname(dest), { recursive: true });
       fs14.writeFileSync(dest, contents);
     }
     results.push({ step, file: relDest, status: exists ? "updated" : "created", detail });
@@ -5404,7 +5444,7 @@ function runSkills(argv, templatesDir, cwd = process.cwd()) {
     }
     const results = installSkills({
       templatesDir,
-      root: path17.resolve(readOption5(rest, "--cwd") ?? cwd),
+      root: path18.resolve(readOption5(rest, "--cwd") ?? cwd),
       skillsDir: readOption5(rest, "--dir") ?? DEFAULT_SKILLS_DIR,
       slugs: requested.length ? requested : ALL_SKILLS,
       force: rest.includes("--force"),
@@ -5475,7 +5515,7 @@ function resolveSkillSlugs(raw) {
   return raw.split(",").map((slug) => slug.trim()).filter(Boolean);
 }
 function parseInitArgs(argv, env, cwd) {
-  const root = path18.resolve(readOption6(argv, "--cwd") ?? cwd);
+  const root = path19.resolve(readOption6(argv, "--cwd") ?? cwd);
   const detected = detectProject(root);
   return {
     root,
@@ -5524,12 +5564,12 @@ function stepInstallReporter(project, opts) {
   if (opts.dryRun || !opts.install)
     return { step, status: "manual", detail: `Run \`${installCommand(project.packageManager)}\`` };
   const [command, args] = installArgv(project.packageManager);
-  const result = (0, import_node_child_process8.spawnSync)(command, args, { cwd: opts.root, stdio: "inherit" });
-  if (result.status === 0) return { step, status: "updated", detail: `Installed ${REPORTER_PACKAGE}` };
+  const status = runPackageManager(command, args, opts.root);
+  if (status === 0) return { step, status: "updated", detail: `Installed ${REPORTER_PACKAGE}` };
   return {
     step,
     status: "error",
-    detail: `\`${installCommand(project.packageManager)}\` failed (exit ${result.status ?? "unknown"}) \u2014 install it by hand`
+    detail: `\`${installCommand(project.packageManager)}\` failed (exit ${status ?? "unknown"}) \u2014 install it by hand`
   };
 }
 function stepConfig(project, opts) {
@@ -5540,7 +5580,7 @@ function stepConfig(project, opts) {
       status: "manual",
       detail: "No playwright.config found \u2014 create one, then re-run `npx @piwitests/reporter init`"
     };
-  const rel = path18.relative(project.root, project.configPath) || path18.basename(project.configPath);
+  const rel = path19.relative(project.root, project.configPath) || path19.basename(project.configPath);
   const edit = wrapPlaywrightConfig(readFileOr(project.configPath, ""), {
     serverUrl: opts.serverUrl,
     projectName: opts.projectName
@@ -5550,8 +5590,8 @@ function stepConfig(project, opts) {
 }
 function stepFixtures(project, opts) {
   const step = "fixtures";
-  const rel = path18.join("tests", project.configLang === "js" ? "fixtures.js" : "fixtures.ts");
-  const dest = path18.join(project.root, rel);
+  const rel = path19.join("tests", project.configLang === "js" ? "fixtures.js" : "fixtures.ts");
+  const dest = path19.join(project.root, rel);
   if (fs15.existsSync(dest)) {
     const current = readFileOr(dest, "");
     if (/piwiFixtures/.test(current))
@@ -5564,7 +5604,7 @@ function stepFixtures(project, opts) {
     };
   }
   if (!opts.dryRun) {
-    fs15.mkdirSync(path18.dirname(dest), { recursive: true });
+    fs15.mkdirSync(path19.dirname(dest), { recursive: true });
     fs15.writeFileSync(dest, fixturesContents());
   }
   return {
@@ -5576,7 +5616,7 @@ function stepFixtures(project, opts) {
 }
 function stepEnv(project, opts) {
   const results = [];
-  const examplePath = path18.join(project.root, ".env.example");
+  const examplePath = path19.join(project.root, ".env.example");
   const example = upsertEnvKeys(readFileOr(examplePath, ""), [
     ["PIWI_DASHBOARD_URL", opts.serverUrl],
     ["PIWI_API_KEY", ""]
@@ -5589,7 +5629,7 @@ function stepEnv(project, opts) {
     detail: example.added.length ? `Recorded ${example.added.join(", ")}` : "connection template already present"
   });
   if (opts.apiKey) {
-    const envPath = path18.join(project.root, ".env");
+    const envPath = path19.join(project.root, ".env");
     const env = upsertEnvKeys(readFileOr(envPath, ""), [
       ["PIWI_DASHBOARD_URL", opts.serverUrl],
       ["PIWI_API_KEY", opts.apiKey]
@@ -5601,7 +5641,7 @@ function stepEnv(project, opts) {
       status: env.added.length ? "updated" : "already",
       detail: env.added.length ? `Wrote ${env.added.join(", ")} (keep .env out of git)` : "already set"
     });
-    const gitignorePath = path18.join(project.root, ".gitignore");
+    const gitignorePath = path19.join(project.root, ".gitignore");
     const gitignore = ensureGitignoreEntry(readFileOr(gitignorePath, ""));
     if (gitignore.added && !opts.dryRun) fs15.writeFileSync(gitignorePath, gitignore.text);
     results.push({
@@ -5665,7 +5705,7 @@ async function runInit(argv, env = process.env, cwd = process.cwd()) {
           project: {
             root: project.root,
             packageManager: project.packageManager,
-            configPath: project.configPath ? path18.relative(project.root, project.configPath) : null,
+            configPath: project.configPath ? path19.relative(project.root, project.configPath) : null,
             projectName: opts.projectName,
             serverUrl: opts.serverUrl
           },
@@ -5690,14 +5730,13 @@ Piwi setup${opts.dryRun ? " (dry run \u2014 nothing written)" : ""} for "${opts.
 
 // src/cli/select.ts
 var fs17 = __toESM(require("fs"));
-var path20 = __toESM(require("path"));
-var import_node_child_process9 = require("child_process");
-var import_node_module4 = require("module");
+var path21 = __toESM(require("path"));
+var import_node_child_process7 = require("child_process");
 
 // src/cli/add-reporter.ts
 var fs16 = __toESM(require("fs"));
-var path19 = __toESM(require("path"));
-var import_node_module3 = require("module");
+var path20 = __toESM(require("path"));
+var import_node_module2 = require("module");
 var REPORTER_PACKAGE2 = "@piwitests/reporter";
 var ADD_REPORTER_FLAG = "--add-reporter";
 var ADD_REPORTER_MIN = { major: 1, minor: 63 };
@@ -5729,9 +5768,9 @@ function resolveConfigPath(cwd, playwrightArgs2) {
     const arg = playwrightArgs2[i];
     if (arg === "--config" || arg === "-c") {
       const next = playwrightArgs2[i + 1];
-      if (next) return path19.resolve(cwd, next);
+      if (next) return path20.resolve(cwd, next);
     } else if (arg.startsWith("--config=")) {
-      return path19.resolve(cwd, arg.slice("--config=".length));
+      return path20.resolve(cwd, arg.slice("--config=".length));
     }
   }
   return detectProject(cwd).configPath;
@@ -5746,7 +5785,7 @@ function readConfigSource(configPath) {
 }
 function readInstalledPlaywrightVersion(cwd) {
   try {
-    const require2 = (0, import_node_module3.createRequire)(path19.join(cwd, "noop.js"));
+    const require2 = (0, import_node_module2.createRequire)(path20.join(cwd, "noop.js"));
     for (const id of ["@playwright/test/package.json", "playwright/package.json"]) {
       try {
         return require2(id).version ?? null;
@@ -5866,7 +5905,7 @@ function parseSelectArgs(argv, env) {
     extra
   };
 }
-var CACHE_FILE = path20.join(".piwi", "selection-cache.json");
+var CACHE_FILE = path21.join(".piwi", "selection-cache.json");
 function cacheKey(args) {
   return `${args.project.toLowerCase()}:${args.key}:${args.format}:${args.budgetMs ?? 0}:${args.shard ?? ""}:${args.order ?? ""}`;
 }
@@ -5886,7 +5925,7 @@ function writeCache(args, resolution) {
     } catch {
     }
     store[cacheKey(args)] = resolution;
-    fs17.mkdirSync(path20.dirname(CACHE_FILE), { recursive: true });
+    fs17.mkdirSync(path21.dirname(CACHE_FILE), { recursive: true });
     fs17.writeFileSync(CACHE_FILE, JSON.stringify(store, null, 2));
   } catch {
   }
@@ -5911,7 +5950,7 @@ function printWarnings(resolution) {
   for (const w of resolution.warnings) console.error(`piwi: warning [${w.code}] ${w.message}`);
 }
 function gitChangedFiles(base) {
-  const out = (0, import_node_child_process9.execFileSync)("git", ["diff", "--name-only", base], {
+  const out = (0, import_node_child_process7.execFileSync)("git", ["diff", "--name-only", base], {
     encoding: "utf-8",
     stdio: ["ignore", "pipe", "ignore"]
   });
@@ -5983,34 +6022,10 @@ async function runSelect(argv, env = process.env) {
   else console.log(resolution.materialization.args.join(" "));
   return EXIT_OK6;
 }
-function resolvePlaywrightCli3() {
-  const require2 = (0, import_node_module4.createRequire)(path20.join(process.cwd(), "noop.js"));
-  for (const id of ["playwright/cli", "@playwright/test/cli", "playwright/lib/cli/cli"]) {
-    try {
-      return require2.resolve(id);
-    } catch {
-    }
-  }
-  return null;
-}
-function spawnPlaywright2(pkgRunner, playwrightArgs2, env) {
-  const cli = resolvePlaywrightCli3();
-  const child = cli ? (0, import_node_child_process9.spawn)(process.execPath, [cli, "test", ...playwrightArgs2], { stdio: "inherit", env }) : (0, import_node_child_process9.spawn)(process.platform === "win32" ? `${pkgRunner}.cmd` : pkgRunner, ["playwright", "test", ...playwrightArgs2], {
-    stdio: "inherit",
-    env
-  });
-  return new Promise((resolve10) => {
-    child.on("error", (err) => {
-      console.error(`piwi run: could not start Playwright \u2014 ${err.message}`);
-      resolve10(EXIT_ERROR7);
-    });
-    child.on("exit", (code) => resolve10(code ?? EXIT_ERROR7));
-  });
-}
 function spawnPlaywrightForRun(pkgRunner, playwrightArgs2, env) {
   const decision = computeAddReporterArgs(process.cwd(), playwrightArgs2);
   if (decision.log) console.error(decision.log);
-  return spawnPlaywright2(pkgRunner, [...decision.args, ...playwrightArgs2], env);
+  return spawnPlaywright([...decision.args, ...playwrightArgs2], env, { runner: pkgRunner, command: "piwi run" });
 }
 function shardEnv(args) {
   return args.shard ? { [PIWI_SHARD_ENV]: args.shard } : {};
@@ -6118,15 +6133,15 @@ async function runRun(argv, env = process.env) {
 
 // src/cli/preflight.ts
 var fs18 = __toESM(require("fs"));
-var path21 = __toESM(require("path"));
-var import_node_child_process10 = require("child_process");
+var path22 = __toESM(require("path"));
+var import_node_child_process8 = require("child_process");
 
 // ../core/src/diff-anchors.ts
 var RENAME_FROM = `rename from `;
 var RENAME_TO = "rename to ";
 var HUNK_HEADER = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/;
-function stripPrefix(path23) {
-  const unquoted = path23.startsWith('"') && path23.endsWith('"') ? path23.slice(1, -1) : path23;
+function stripPrefix(path24) {
+  const unquoted = path24.startsWith('"') && path24.endsWith('"') ? path24.slice(1, -1) : path24;
   return unquoted.replace(/^[ab]\//, "");
 }
 function parseUnifiedDiff(text) {
@@ -6236,8 +6251,8 @@ function pathGlobToRegExp(glob) {
   });
   return new RegExp(`^(?:${parts.join("|")})$`);
 }
-function isTranslationFile(path23, globs = DEFAULT_TRANSLATION_GLOBS) {
-  const posix = path23.replace(/\\/g, "/");
+function isTranslationFile(path24, globs = DEFAULT_TRANSLATION_GLOBS) {
+  const posix = path24.replace(/\\/g, "/");
   if (!TRANSLATION_EXTENSIONS.test(posix)) return false;
   return globs.some((g) => pathGlobToRegExp(g).test(posix));
 }
@@ -6248,7 +6263,7 @@ function keepable(value) {
   return new RegExp("\\p{L}", "u").test(v);
 }
 function readQuoted(text, start) {
-  const quote4 = text[start];
+  const quote3 = text[start];
   let value = "";
   for (let i = start + 1; i < text.length; i++) {
     const ch = text[i];
@@ -6258,8 +6273,8 @@ function readQuoted(text, start) {
       i++;
       continue;
     }
-    if (quote4 === "`" && ch === "$" && text[i + 1] === "{") return null;
-    if (ch === quote4) return { value, end: i + 1 };
+    if (quote3 === "`" && ch === "$" && text[i + 1] === "{") return null;
+    if (ch === quote3) return { value, end: i + 1 };
     value += ch;
   }
   return null;
@@ -6377,13 +6392,13 @@ function unquoteYaml(raw) {
 function decodeXml2(text) {
   return text.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&");
 }
-function parseTranslationFile(path23, content) {
+function parseTranslationFile(path24, content) {
   const lines = content.split(/\r?\n/);
   const out = [];
-  const ext = /\.([a-z]+)$/i.exec(path23)?.[1]?.toLowerCase();
+  const ext = /\.([a-z]+)$/i.exec(path24)?.[1]?.toLowerCase();
   if (ext === "json") {
     const stack = [];
-    const path24 = (key) => [...stack.map((f) => f.key), key].join(".");
+    const path25 = (key) => [...stack.map((f) => f.key), key].join(".");
     lines.forEach((text, i) => {
       const t = text.trim();
       const top = stack[stack.length - 1];
@@ -6392,14 +6407,14 @@ function parseTranslationFile(path23, content) {
         const key = JSON.parse(`"${pair[1]}"`);
         const rest = pair[2];
         const str = /^"((?:[^"\\]|\\.)*)"/.exec(rest);
-        if (str) out.push({ key: path24(key), value: JSON.parse(`"${str[1]}"`), line: i + 1 });
+        if (str) out.push({ key: path25(key), value: JSON.parse(`"${str[1]}"`), line: i + 1 });
         else if (/^[[{]\s*$/.test(rest)) stack.push({ key, array: rest.startsWith("["), next: 0 });
         return;
       }
       if (top?.array) {
         const str = /^"((?:[^"\\]|\\.)*)"\s*,?$/.exec(t);
         if (str) {
-          out.push({ key: path24(top.next++), value: JSON.parse(`"${str[1]}"`), line: i + 1 });
+          out.push({ key: path25(top.next++), value: JSON.parse(`"${str[1]}"`), line: i + 1 });
           return;
         }
         if (/^[[{]\s*$/.test(t)) {
@@ -6463,8 +6478,8 @@ function parseTranslationFile(path23, content) {
   }
   return out;
 }
-function translationLineToken(path23, text, line) {
-  const ext = /\.([a-z]+)$/i.exec(path23)?.[1]?.toLowerCase();
+function translationLineToken(path24, text, line) {
+  const ext = /\.([a-z]+)$/i.exec(path24)?.[1]?.toLowerCase();
   let key;
   let value;
   if (ext === "json") {
@@ -6501,9 +6516,9 @@ function translationLineToken(path23, text, line) {
   if (value === void 0 || !keepable(value)) return null;
   return { kind: "translation", group: `translation:${key ?? ""}`, value, key, line };
 }
-function lineTokens(path23, text, line, side, attributes, options) {
+function lineTokens(path24, text, line, side, attributes, options) {
   const spans = [];
-  const markup = MARKUP_FILE.test(path23);
+  const markup = MARKUP_FILE.test(path24);
   return [
     ...attributeTokens(text, attributes, line, spans),
     ...translationRefTokens(text, line, side, options.translations, spans),
@@ -6511,10 +6526,10 @@ function lineTokens(path23, text, line, side, attributes, options) {
     ...textTokens(text, line, markup)
   ];
 }
-function keysByLine(path23, side, options) {
-  const content = options.readFile?.(path23, side);
+function keysByLine(path24, side, options) {
+  const content = options.readFile?.(path24, side);
   if (content === void 0) return null;
-  return new Map(parseTranslationFile(path23, content).map((e) => [e.line, e.key]));
+  return new Map(parseTranslationFile(path24, content).map((e) => [e.line, e.key]));
 }
 function tokenId(t) {
   return `${t.group}\0${t.value}`;
@@ -6712,9 +6727,9 @@ function cssSlots(selector, testIds, replace) {
     const attr = m[1];
     const names = testIds.includes(attr) ? testIds : attr === "id" || attr === "name" ? [attr] : null;
     if (!names) continue;
-    const quote4 = m[2] !== void 0 ? '"' : m[3] !== void 0 ? "'" : "";
+    const quote3 = m[2] !== void 0 ? '"' : m[3] !== void 0 ? "'" : "";
     const value = m[2] ?? m[3] ?? m[4];
-    slot(value, [attr], (v) => `[${attr}=${quote4}${v}${quote4}]`, m.index, m[0].length);
+    slot(value, [attr], (v) => `[${attr}=${quote3}${v}${quote3}]`, m.index, m[0].length);
   }
   return slots;
 }
@@ -6814,7 +6829,7 @@ function slotMatches(slot, text) {
       return textMatches(slot.value, slot.exact, text);
   }
 }
-var filePath = (path23) => path23.replace(/\\/g, "/").replace(/^\.\//, "");
+var filePath = (path24) => path24.replace(/\\/g, "/").replace(/^\.\//, "");
 function sameFilePath(a, b) {
   const x = filePath(a);
   const y = filePath(b);
@@ -6908,16 +6923,16 @@ function confidenceOf(anchor, tests, reach) {
 }
 
 // ../core/src/locator-edit.ts
-function escapeForQuote(value, quote4) {
-  let out = value.replace(/\\/g, "\\\\").replace(/\n/g, "\\n");
-  out = out.split(quote4).join(`\\${quote4}`);
-  return quote4 === "`" ? out.replace(/\$\{/g, "\\${") : out;
+function escapeForQuote(value, quote3) {
+  let out = value.replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+  out = out.split(quote3).join(`\\${quote3}`);
+  return quote3 === "`" ? out.replace(/\$\{/g, "\\${") : out;
 }
 function buildLiteralEdit(sourceLine, oldValue, newValue) {
   if (!sourceLine || oldValue === newValue) return null;
   for (let i = 0; i < sourceLine.length; i++) {
-    const quote4 = sourceLine[i];
-    if (quote4 !== "'" && quote4 !== '"' && quote4 !== "`") continue;
+    const quote3 = sourceLine[i];
+    if (quote3 !== "'" && quote3 !== '"' && quote3 !== "`") continue;
     let value = "";
     let end = -1;
     for (let j = i + 1; j < sourceLine.length; j++) {
@@ -6928,8 +6943,8 @@ function buildLiteralEdit(sourceLine, oldValue, newValue) {
         j++;
         continue;
       }
-      if (quote4 === "`" && ch === "$" && sourceLine[j + 1] === "{") break;
-      if (ch === quote4) {
+      if (quote3 === "`" && ch === "$" && sourceLine[j + 1] === "{") break;
+      if (ch === quote3) {
         end = j;
         break;
       }
@@ -6937,7 +6952,7 @@ function buildLiteralEdit(sourceLine, oldValue, newValue) {
     }
     if (end === -1) continue;
     if (value === oldValue) {
-      const next = sourceLine.slice(0, i + 1) + escapeForQuote(newValue, quote4) + sourceLine.slice(end);
+      const next = sourceLine.slice(0, i + 1) + escapeForQuote(newValue, quote3) + sourceLine.slice(end);
       return { old: sourceLine, new: next };
     }
     i = end;
@@ -7029,16 +7044,16 @@ function parsePreflightArgs(argv) {
 }
 var CONFIG_NAMES2 = ["playwright.config.ts", "playwright.config.js", "playwright.config.mjs", "playwright.config.cjs"];
 function findPlaywrightRoot(from) {
-  let dir = path21.resolve(from);
+  let dir = path22.resolve(from);
   for (; ; ) {
-    if (CONFIG_NAMES2.some((name) => fs18.existsSync(path21.join(dir, name)))) return dir;
-    const parent = path21.dirname(dir);
+    if (CONFIG_NAMES2.some((name) => fs18.existsSync(path22.join(dir, name)))) return dir;
+    const parent = path22.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
 }
 function git2(cwd, args) {
-  return (0, import_node_child_process10.execFileSync)("git", args, {
+  return (0, import_node_child_process8.execFileSync)("git", args, {
     cwd,
     encoding: "utf-8",
     stdio: ["ignore", "pipe", "pipe"],
@@ -7062,7 +7077,7 @@ function translationLookup(repoRoot, base, locale) {
   const build = (side) => {
     const map = /* @__PURE__ */ new Map();
     for (const file of files) {
-      const content = side === "new" ? readText(path21.join(repoRoot, file)) : tryGit(repoRoot, ["show", `${base}:${file}`]);
+      const content = side === "new" ? readText(path22.join(repoRoot, file)) : tryGit(repoRoot, ["show", `${base}:${file}`]);
       if (content === void 0) continue;
       for (const entry of parseTranslationFile(file, content)) {
         if (!map.has(entry.key)) map.set(entry.key, entry.value);
@@ -7086,20 +7101,20 @@ function readText(file) {
     return void 0;
   }
 }
-var CACHE_FILE2 = path21.join(".piwi", "locator-index.json");
+var CACHE_FILE2 = path22.join(".piwi", "locator-index.json");
 function cacheKey2(connection, branch) {
   return `${connection.serverUrl}|${connection.project}|${branch ?? ""}`;
 }
 function readCache2(root, key) {
   try {
-    const store = JSON.parse(fs18.readFileSync(path21.join(root, CACHE_FILE2), "utf-8"));
+    const store = JSON.parse(fs18.readFileSync(path22.join(root, CACHE_FILE2), "utf-8"));
     return store[key] ?? null;
   } catch {
     return null;
   }
 }
 function writeCache2(root, key, index) {
-  const file = path21.join(root, CACHE_FILE2);
+  const file = path22.join(root, CACHE_FILE2);
   try {
     let store = {};
     try {
@@ -7107,7 +7122,7 @@ function writeCache2(root, key, index) {
     } catch {
     }
     store[key] = { savedAt: (/* @__PURE__ */ new Date()).toISOString(), index };
-    fs18.mkdirSync(path21.dirname(file), { recursive: true });
+    fs18.mkdirSync(path22.dirname(file), { recursive: true });
     fs18.writeFileSync(file, JSON.stringify(store));
   } catch {
   }
@@ -7124,7 +7139,7 @@ function planSites(b, testRoot) {
   const sites = [...new Set(b.uses.flatMap((u) => u.callSites))];
   return sites.map((callSite) => {
     if (!b.rewrite || !b.replacements?.length) return { callSite, action: "none" };
-    const file = path21.resolve(testRoot, callSiteFile(callSite));
+    const file = path22.resolve(testRoot, callSiteFile(callSite));
     const lineNo = callSiteLine(callSite);
     const text = readText(file);
     if (text === void 0 || lineNo === null) return { callSite, action: "elsewhere" };
@@ -7140,8 +7155,8 @@ function planSites(b, testRoot) {
     }
     const holders = /* @__PURE__ */ new Set();
     for (const [before] of b.replacements) {
-      for (const quote4 of ["'", '"', "`"]) {
-        const out = tryGit(testRoot, ["grep", "-n", "--fixed-strings", `${quote4}${before}${quote4}`]);
+      for (const quote3 of ["'", '"', "`"]) {
+        const out = tryGit(testRoot, ["grep", "-n", "--fixed-strings", `${quote3}${before}${quote3}`]);
         for (const row of (out ?? "").split("\n")) {
           const m = /^(.+?):(\d+):/.exec(row);
           if (m) holders.add(`${m[1]}:${m[2]}`);
@@ -7288,7 +7303,7 @@ async function runPreflight(argv, env = process.env, cwd = process.cwd()) {
     console.error("piwi preflight: not inside a git repository");
     return EXIT_ERROR8;
   }
-  const testRoot = path21.resolve(cwd, args.testRoot ?? findPlaywrightRoot(cwd) ?? cwd);
+  const testRoot = path22.resolve(cwd, args.testRoot ?? findPlaywrightRoot(cwd) ?? cwd);
   let files;
   try {
     files = parseUnifiedDiff(git2(repoRoot, ["diff", "--unified=0", "--no-color", "--no-ext-diff", args.base, "--"]));
@@ -7325,7 +7340,7 @@ async function runPreflight(argv, env = process.env, cwd = process.cwd()) {
     testIdAttributes: index.testIdAttributes ?? void 0,
     isTestFile: (file) => TEST_FILE.test(file),
     translations: translationLookup(repoRoot, args.base, args.locale),
-    readFile: (file, side) => side === "new" ? readText(path21.join(repoRoot, file)) : tryGit(repoRoot, ["show", `${args.base}:${file}`])
+    readFile: (file, side) => side === "new" ? readText(path22.join(repoRoot, file)) : tryGit(repoRoot, ["show", `${args.base}:${file}`])
   });
   const found = predictLocatorBreaks(anchors, index, { reach: await loadReach(connection, projectId, args.branch) });
   const replacementsOf = /* @__PURE__ */ new Map();
@@ -7370,8 +7385,8 @@ async function runPreflight(argv, env = process.env, cwd = process.cwd()) {
   if (args.json) console.log(JSON.stringify(result, null, 2));
   else {
     const rel = (file) => {
-      const abs = path21.isAbsolute(file) ? file : path21.resolve(testRoot, file);
-      const r = path21.relative(cwd, abs).split(path21.sep).join("/");
+      const abs = path22.isAbsolute(file) ? file : path22.resolve(testRoot, file);
+      const r = path22.relative(cwd, abs).split(path22.sep).join("/");
       return r.startsWith("..") ? file : r || file;
     };
     console.log(renderPreflight(result, rel));
@@ -7403,7 +7418,7 @@ async function runPreflight(argv, env = process.env, cwd = process.cwd()) {
 // src/cli/probe.ts
 var fs19 = __toESM(require("fs"));
 var os3 = __toESM(require("os"));
-var path22 = __toESM(require("path"));
+var path23 = __toESM(require("path"));
 var EXIT_OK8 = 0;
 var EXIT_ERROR9 = 2;
 var USAGE11 = `
@@ -7428,9 +7443,9 @@ function escapeRegex2(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 async function runProbe(argv) {
-  const sep6 = argv.indexOf("--");
-  const own = sep6 < 0 ? argv : argv.slice(0, sep6);
-  const playwrightArgs2 = sep6 < 0 ? [] : argv.slice(sep6 + 1);
+  const sep7 = argv.indexOf("--");
+  const own = sep7 < 0 ? argv : argv.slice(0, sep7);
+  const playwrightArgs2 = sep7 < 0 ? [] : argv.slice(sep7 + 1);
   if (own.includes("-h") || own.includes("--help")) {
     console.log(USAGE11);
     return EXIT_OK8;
@@ -7467,10 +7482,10 @@ async function runProbe(argv) {
     return EXIT_OK8;
   }
   console.error(`piwi probe: ${plan.items.length} pair(s) to probe (budget ${plan.budget}).`);
-  const dir = fs19.mkdtempSync(path22.join(os3.tmpdir(), "piwi-probe-"));
-  const planFile = path22.join(dir, "plan.json");
-  const resultsFile = path22.join(dir, "results.jsonl");
-  const runOutputFile = path22.join(dir, "run.json");
+  const dir = fs19.mkdtempSync(path23.join(os3.tmpdir(), "piwi-probe-"));
+  const planFile = path23.join(dir, "plan.json");
+  const resultsFile = path23.join(dir, "results.jsonl");
+  const runOutputFile = path23.join(dir, "run.json");
   fs19.writeFileSync(planFile, JSON.stringify(plan));
   fs19.writeFileSync(resultsFile, "");
   const grep = plan.items.map((i) => i.testTitle).filter(Boolean).map(escapeRegex2).join("|");