@piwitests/reporter 0.61.0 → 0.63.0

package/dist/cli/index.js

@@ -36,6 +36,7 @@ var path2 = __toESM(require("path"));
 
 // src/internal/capture/locator-healing.ts
 var path = __toESM(require("path"));
+var import_node_url = require("url");
 
 // ../core/src/locator-chain.ts
 var LOCATING_METHODS = /* @__PURE__ */ new Set([
@@ -647,11 +648,11 @@ function spawnPlaywright(playwrightArgs2, env, options = {}) {
   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) => {
+  return new Promise((resolve11) => {
     const done = (code) => {
       if (fd !== null) fs3.closeSync(fd);
       fd = null;
-      resolve10(code);
+      resolve11(code);
     };
     child.on("error", (err) => {
       console.error(`${label}: could not start Playwright \u2014 ${err.message}`);
@@ -788,9 +789,8 @@ async function runAi(argv, env = process.env) {
 }
 
 // src/cli/bug.ts
-var fs6 = __toESM(require("fs"));
-var path9 = __toESM(require("path"));
-var import_node_child_process2 = require("child_process");
+var fs7 = __toESM(require("fs"));
+var path10 = __toESM(require("path"));
 
 // src/internal/config/env.ts
 var path8 = __toESM(require("path"));
@@ -870,6 +870,13 @@ function readDotEnv(filePath2) {
   }
 }
 
+// src/internal/support/ci.ts
+function detectCi(env) {
+  return Boolean(
+    env.JENKINS_URL || env.GITHUB_ACTIONS || env.GITLAB_CI || env.CIRCLECI || env.TRAVIS || env.TF_BUILD || env.BITBUCKET_BUILD_NUMBER || env.TEAMCITY_VERSION || env.CODEBUILD_BUILD_ID || env.bamboo_buildKey || env.CI && env.CI.toLowerCase() !== "false" && env.CI !== "0"
+  );
+}
+
 // src/internal/config/env.ts
 var DEFAULTS = {
   projectName: "default-project",
@@ -1007,6 +1014,82 @@ var ENV_FALLBACK_SPECS = [
   { option: "pickLocatorOnFailure", env: PIWI_ENV_KEYS.pickLocatorOnFailure, kind: "bool" },
   { option: "outputFile", env: PIWI_ENV_KEYS.outputFile, kind: "string" }
 ];
+var DESKTOP_APP_MODES = ["prefer", "fallback", "off"];
+function desktopAppMode(option, envValue) {
+  const fromEnv = envValue?.trim().toLowerCase();
+  if (DESKTOP_APP_MODES.includes(fromEnv)) return fromEnv;
+  if (DESKTOP_APP_MODES.includes(option)) return option;
+  return "fallback";
+}
+
+// src/internal/support/connection.ts
+var fs6 = __toESM(require("fs"));
+var path9 = __toESM(require("path"));
+var import_node_child_process2 = require("child_process");
+var CONFIG_NAMES = ["playwright.config.ts", "playwright.config.js", "playwright.config.mjs", "playwright.config.cjs"];
+function findPlaywrightRoot(from, root) {
+  const top = root ? path9.resolve(root) : null;
+  let dir = path9.resolve(from);
+  for (; ; ) {
+    if (CONFIG_NAMES.some((name) => fs6.existsSync(path9.join(dir, name)))) return dir;
+    const parent = path9.dirname(dir);
+    if (dir === top || parent === dir) return null;
+    dir = parent;
+  }
+}
+function gitRoot(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 ? path9.resolve(out) : null;
+  } catch {
+    return null;
+  }
+}
+function connectionFolders(cwd) {
+  const root = gitRoot(cwd);
+  const dirs = [findPlaywrightRoot(cwd, root) ?? cwd, cwd, root];
+  return [...new Set(dirs.filter((dir) => dir !== null).map((dir) => path9.resolve(dir)))];
+}
+function projectOf(source) {
+  const project = source[PIWI_ENV_KEYS.projectName];
+  return project ? { [PIWI_ENV_KEYS.projectName]: project } : {};
+}
+function readDotEnvConnection(dirs) {
+  const files = dirs.map((dir) => readDotEnv(path9.join(dir, ".env")));
+  const withUrl = files.find((file) => file[PIWI_ENV_KEYS.serverUrl]);
+  const vars = {};
+  if (withUrl) {
+    vars[PIWI_ENV_KEYS.serverUrl] = withUrl[PIWI_ENV_KEYS.serverUrl];
+    if (withUrl[PIWI_ENV_KEYS.apiKey]) vars[PIWI_ENV_KEYS.apiKey] = withUrl[PIWI_ENV_KEYS.apiKey];
+  }
+  const project = files.find((file) => file[PIWI_ENV_KEYS.projectName])?.[PIWI_ENV_KEYS.projectName];
+  if (project) vars[PIWI_ENV_KEYS.projectName] = project;
+  return { vars, anyKey: files.some((file) => file[PIWI_ENV_KEYS.apiKey]) };
+}
+function resolveCliConnection(flags, env, dirs, command = "piwi") {
+  const { vars: dotEnv, anyKey } = readDotEnvConnection(dirs);
+  const mode = desktopAppMode(void 0, env[PIWI_ENV_KEYS.desktopApp]);
+  const preferLocally = mode === "prefer" && !flags.serverUrl && !detectCi(env);
+  const urlSet = Boolean(flags.serverUrl || env[PIWI_ENV_KEYS.serverUrl] || dotEnv[PIWI_ENV_KEYS.serverUrl]);
+  const keySet = Boolean(flags.apiKey || env[PIWI_ENV_KEYS.apiKey] || anyKey);
+  const readDesktop = mode !== "off" && (preferLocally || urlSet || !keySet);
+  const desktop = readDesktop ? readDesktopConfig(env[PIWI_DESKTOP_CONFIG_ENV] || defaultDesktopConfigPath()) : null;
+  const preferDesktop = desktop !== null && preferLocally;
+  const connection = resolvePiwiConnection(
+    preferDesktop ? { flags, env: projectOf(env), dotEnv: projectOf(dotEnv), desktop } : { flags, env, dotEnv, desktop }
+  );
+  if (connection && flags.apiKey && connection.apiKey !== flags.apiKey) {
+    const from = !preferDesktop && dotEnv[PIWI_ENV_KEYS.serverUrl] ? "a .env file" : "the desktop app";
+    console.error(
+      `${command}: --api-key is not sent to ${connection.serverUrl}, which comes from ${from}: a key goes only to the URL given with it. Pass --server-url to name the instance the key is for.`
+    );
+  }
+  return connection;
+}
 
 // src/cli/bug.ts
 var EXIT_OK2 = 0;
@@ -1029,8 +1112,8 @@ Options:
   --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)
+  --server-url <url>    Dashboard URL         (env PIWI_DASHBOARD_URL, .env, the desktop app)
+  --api-key <key>       API key               (env PIWI_API_KEY, .env)
 
 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
@@ -1044,7 +1127,7 @@ function readOption2(argv, name) {
   const value = argv[index + 1];
   return value !== void 0 && !value.startsWith("--") ? value : void 0;
 }
-function parseBugArgs(argv, env) {
+function parseBugArgs(argv, env, dirs = []) {
   let idText;
   for (let i = 0; i < argv.length; i++) {
     const token = argv[i];
@@ -1060,8 +1143,13 @@ function parseBugArgs(argv, env) {
   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 connection = resolveCliConnection(
+    { serverUrl: readOption2(argv, "--server-url"), apiKey: readOption2(argv, "--api-key") },
+    env,
+    dirs,
+    "piwi bug"
+  );
+  if (!connection) throw new Error("No dashboard \u2014 pass --server-url or set PIWI_DASHBOARD_URL (environment or .env)");
   const out = readOption2(argv, "--out") ?? null;
   const write = argv.includes("--write") || out !== null;
   return {
@@ -1071,8 +1159,8 @@ function parseBugArgs(argv, env) {
     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
+    serverUrl: connection.serverUrl,
+    apiKey: connection.apiKey
   };
 }
 async function fetchBugSpec(args, specDir) {
@@ -1094,35 +1182,23 @@ async function fetchBugSpec(args, specDir) {
   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 ? path9.resolve(out) : null;
-  } catch {
-    return null;
-  }
-}
 function realFolder(dir) {
   const rest = [];
   let current = dir;
-  while (!fs6.existsSync(current) && path9.dirname(current) !== current) {
-    rest.unshift(path9.basename(current));
-    current = path9.dirname(current);
+  while (!fs7.existsSync(current) && path10.dirname(current) !== current) {
+    rest.unshift(path10.basename(current));
+    current = path10.dirname(current);
   }
-  return path9.join(fs6.realpathSync(current), ...rest);
+  return path10.join(fs7.realpathSync(current), ...rest);
 }
 function folderInRepository(root, dir) {
-  const relative9 = path9.relative(realFolder(root), realFolder(dir));
-  if (relative9.startsWith("..") || path9.isAbsolute(relative9)) return void 0;
-  return relative9.split(path9.sep).join("/");
+  const relative8 = path10.relative(realFolder(root), realFolder(dir));
+  if (relative8.startsWith("..") || path10.isAbsolute(relative8)) return void 0;
+  return relative8.split(path10.sep).join("/");
 }
 function fileFilter(file) {
   const escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  return `${escape(path9.basename(path9.dirname(file)))}[\\\\/]${escape(path9.basename(file))}$`;
+  return `${escape(path10.basename(path10.dirname(file)))}[\\\\/]${escape(path10.basename(file))}$`;
 }
 function runPlaywright(file, cwd, id, env) {
   return spawnPlaywright([fileFilter(file)], { ...env, ...originEnv("bug", id) }, { cwd, command: "piwi bug" });
@@ -1134,18 +1210,18 @@ async function runBug(argv, env = process.env, cwd = process.cwd()) {
   }
   let args;
   try {
-    args = parseBugArgs(argv, env);
+    args = parseBugArgs(argv, env, readOption2(argv, "--server-url") ? [] : connectionFolders(cwd));
   } catch (e) {
     console.error(`piwi bug: ${e.message}
 
 ${USAGE2}`);
     return EXIT_ERROR2;
   }
-  const root = args.write ? repositoryRoot(cwd) : null;
-  const outFile = args.out !== null ? path9.resolve(cwd, args.out) : null;
+  const root = args.write ? gitRoot(cwd) : null;
+  const outFile = args.out !== null ? path10.resolve(cwd, args.out) : null;
   let spec;
   try {
-    spec = await fetchBugSpec(args, outFile && root ? folderInRepository(root, path9.dirname(outFile)) : void 0);
+    spec = await fetchBugSpec(args, outFile && root ? folderInRepository(root, path10.dirname(outFile)) : void 0);
   } catch (e) {
     console.error(`piwi bug: ${e.message}`);
     return EXIT_ERROR2;
@@ -1160,16 +1236,16 @@ ${USAGE2}`);
   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 ?? path9.resolve(root ?? cwd, spec.path);
+  const file = outFile ?? path10.resolve(root ?? cwd, spec.path);
   try {
-    fs6.mkdirSync(path9.dirname(file), { recursive: true });
-    fs6.writeFileSync(file, spec.code, { flag: args.force ? "w" : "wx" });
+    fs7.mkdirSync(path10.dirname(file), { recursive: true });
+    fs7.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 = path9.relative(cwd, file) || file;
+  const shown = path10.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);
@@ -1187,8 +1263,8 @@ ${USAGE2}`);
 }
 
 // src/cli/codegen.ts
-var fs7 = __toESM(require("fs"));
-var path10 = __toESM(require("path"));
+var fs8 = __toESM(require("fs"));
+var path11 = __toESM(require("path"));
 
 // ../core/src/recording.ts
 var ASSERTION_MATCHERS = [
@@ -1879,6 +1955,44 @@ function locatorForStep(step, index, ctx) {
   }
   return `${ctx.page}.${chosen.text}`;
 }
+function escapedInTemplate(code) {
+  return code < 32 && code !== 9 || code === 127 || code === 8232 || code === 8233;
+}
+function templateText(text) {
+  let out = "";
+  for (let i = 0; i < text.length; i++) {
+    const c = text[i];
+    const code = c.charCodeAt(0);
+    if (c === "\\" || c === "`" || c === "$" && text[i + 1] === "{") out += `\\${c}`;
+    else if (escapedInTemplate(code)) out += `\\u${code.toString(16).padStart(4, "0")}`;
+    else out += c;
+  }
+  return out;
+}
+function ariaSnapshotLiteral(snapshot, indent) {
+  const lines = snapshot.split(/\r\n?|\n/).filter((line) => line.trim());
+  const common = Math.min(...lines.map((line) => line.length - line.replace(/^ +/, "").length));
+  return ["`", ...lines.map((line) => `${indent}  ${templateText(line.slice(common).trimEnd())}`), `${indent}\``];
+}
+function renderAriaSnapshotStep(step, index, ctx, not) {
+  const snapshot = step.assertion?.expected ?? "";
+  if (!snapshot.trim()) {
+    ctx.warnings.push({
+      step: index,
+      code: "incomplete-assertion",
+      detail: "toMatchAriaSnapshot",
+      message: "toMatchAriaSnapshot needs the ARIA snapshot to match."
+    });
+    return [`  // Step ${index + 1}: toMatchAriaSnapshot without a snapshot.`];
+  }
+  const [open, ...rest] = ariaSnapshotLiteral(snapshot, "  ");
+  const close = rest.pop();
+  return [
+    `  await expect(${locatorForStep(step, index, ctx)})${not}.toMatchAriaSnapshot(${open}`,
+    ...rest,
+    `${close});`
+  ];
+}
 function renderAssertStep(step, index, ctx) {
   const assertion = step.action === "assertVisible" ? null : step.assertion;
   if (step.action === "assert" && !assertion) {
@@ -1889,6 +2003,7 @@ function renderAssertStep(step, index, ctx) {
   const not = assertion?.negated ? ".not" : "";
   const lines = [];
   if (assertion?.note) lines.push(`  // ${commentText(assertion.note)}`);
+  if (matcher === "toMatchAriaSnapshot") return [...lines, ...renderAriaSnapshotStep(step, index, ctx, not)];
   let arg = "";
   if (VALUE_MATCHERS.has(matcher)) {
     if (assertion?.expected == null) {
@@ -2779,9 +2894,9 @@ Code:
   --tag <tag>           Add a tag; repeat for more
 
 Project (optional: your function catalog, and the locators your tests already use):
-  --project <name|id>   Project               (env PIWI_PROJECT_NAME)
-  --server-url <url>    Dashboard URL         (env PIWI_DASHBOARD_URL)
-  --api-key <key>       API key               (env PIWI_API_KEY)
+  --project <name|id>   Project               (env PIWI_PROJECT_NAME, .env)
+  --server-url <url>    Dashboard URL         (env PIWI_DASHBOARD_URL, .env, the desktop app)
+  --api-key <key>       API key               (env PIWI_API_KEY, .env)
   --offline             Do not contact the dashboard
 
 Exit codes: 0 ok, 2 the steps could not be read or the spec could not be written.
@@ -2821,12 +2936,22 @@ function findFile(argv) {
   }
   return void 0;
 }
-function parseCodegenArgs(argv, env) {
+function parseCodegenArgs(argv, env, dirs = []) {
   const file = findFile(argv);
   if (!file) throw new Error("No steps file \u2014 usage: piwi codegen <steps.json>");
   for (const flag of VALUE_FLAGS2) {
     if (argv.includes(flag) && readOption3(argv, flag) === void 0) throw new Error(`${flag} expects a value`);
   }
+  const connection = resolveCliConnection(
+    {
+      serverUrl: readOption3(argv, "--server-url"),
+      apiKey: readOption3(argv, "--api-key"),
+      project: readOption3(argv, "--project")
+    },
+    env,
+    dirs,
+    "piwi codegen"
+  );
   return {
     file,
     out: readOption3(argv, "--out") ?? null,
@@ -2840,9 +2965,9 @@ function parseCodegenArgs(argv, env) {
     fail: argv.includes("--fail") || argv.includes("--fail-reason"),
     failReason: readOption3(argv, "--fail-reason") ?? null,
     tags: readAll2(argv, "--tag"),
-    project: readOption3(argv, "--project") ?? env.PIWI_PROJECT_NAME ?? "",
-    serverUrl: (readOption3(argv, "--server-url") ?? env.PIWI_DASHBOARD_URL ?? "").replace(/\/+$/, ""),
-    apiKey: readOption3(argv, "--api-key") ?? env.PIWI_API_KEY ?? null,
+    project: connection?.project ?? readOption3(argv, "--project") ?? env.PIWI_PROJECT_NAME ?? "",
+    serverUrl: connection?.serverUrl ?? "",
+    apiKey: connection?.apiKey ?? null,
     offline: argv.includes("--offline")
   };
 }
@@ -2901,14 +3026,15 @@ async function loadProjectContext(args) {
   );
   return { catalog, suiteLocators };
 }
-async function runCodegen(argv, env = process.env) {
+async function runCodegen(argv, env = process.env, cwd = process.cwd()) {
   if (argv.includes("-h") || argv.includes("--help")) {
     console.log(USAGE3);
     return EXIT_OK3;
   }
   let args;
   try {
-    args = parseCodegenArgs(argv, env);
+    const given = readOption3(argv, "--server-url") && (readOption3(argv, "--project") || env.PIWI_PROJECT_NAME);
+    args = parseCodegenArgs(argv, env, given ? [] : connectionFolders(cwd));
   } catch (e) {
     console.error(`piwi codegen: ${e.message}
 
@@ -2920,7 +3046,7 @@ ${USAGE3}`);
   if (bugId) {
     if (!args.serverUrl) {
       console.error(
-        "piwi codegen: bug:<id> reads the report from the dashboard \u2014 pass --server-url or set PIWI_DASHBOARD_URL"
+        "piwi codegen: bug:<id> reads the report from the dashboard \u2014 pass --server-url or set PIWI_DASHBOARD_URL (environment or .env)"
       );
       return EXIT_ERROR3;
     }
@@ -2933,8 +3059,8 @@ ${USAGE3}`);
     }
   } else {
     try {
-      if (fs7.statSync(args.file).size > MAX_STEPS_FILE_BYTES) throw new Error("is too large to be a steps file");
-      text = fs7.readFileSync(args.file, "utf-8");
+      if (fs8.statSync(args.file).size > MAX_STEPS_FILE_BYTES) throw new Error("is too large to be a steps file");
+      text = fs8.readFileSync(args.file, "utf-8");
     } catch (e) {
       const reason = e.code === "ENOENT" ? "does not exist" : e.message;
       console.error(`piwi codegen: ${args.file} ${reason}`);
@@ -2966,8 +3092,8 @@ ${USAGE3}`);
     return EXIT_OK3;
   }
   try {
-    fs7.mkdirSync(path10.dirname(args.out), { recursive: true });
-    fs7.writeFileSync(args.out, result.code, { flag: args.force ? "w" : "wx" });
+    fs8.mkdirSync(path11.dirname(args.out), { recursive: true });
+    fs8.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}`);
@@ -2981,7 +3107,7 @@ ${USAGE3}`);
 }
 
 // src/cli/coverage.ts
-var path15 = __toESM(require("path"));
+var path16 = __toESM(require("path"));
 
 // ../core/src/codeowners.ts
 function patternParts(pattern) {
@@ -3105,7 +3231,7 @@ function errorMessage(error) {
 }
 
 // src/internal/support/test-paths.ts
-var path11 = __toESM(require("path"));
+var path12 = __toESM(require("path"));
 
 // src/internal/collect/metadata-collector.ts
 var DETACHED_HEAD = "HEAD";
@@ -3138,23 +3264,23 @@ function normalizeRef(ref) {
 
 // src/internal/coverage-upload/git-inventory.ts
 var import_node_child_process5 = require("child_process");
-var fs9 = __toESM(require("fs"));
-var path13 = __toESM(require("path"));
+var fs10 = __toESM(require("fs"));
+var path14 = __toESM(require("path"));
 
 // src/internal/collect/blob-ids.ts
 var import_node_child_process4 = require("child_process");
 var crypto2 = __toESM(require("crypto"));
-var fs8 = __toESM(require("fs"));
-var path12 = __toESM(require("path"));
+var fs9 = __toESM(require("fs"));
+var path13 = __toESM(require("path"));
 function gitHashObjects(root, paths) {
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     const child = (0, import_node_child_process4.execFile)(
       "git",
       ["hash-object", "--stdin-paths"],
       { cwd: root, encoding: "utf8", timeout: 3e4, windowsHide: true },
       (error, stdout) => {
         const ids = error ? [] : stdout.split("\n").filter(Boolean);
-        resolve10(ids.length === paths.length ? ids : null);
+        resolve11(ids.length === paths.length ? ids : null);
       }
     );
     child.stdin?.on("error", () => {
@@ -3168,12 +3294,12 @@ function gitHashObjects(root, paths) {
 var MAX_GIT_OUTPUT = 512 * 1024 * 1024;
 var GIT_BATCH = 500;
 function git(cwd, args) {
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve11, reject) => {
     (0, import_node_child_process5.execFile)(
       "git",
       args,
       { cwd, encoding: "utf8", maxBuffer: MAX_GIT_OUTPUT, timeout: 12e4, windowsHide: true },
-      (error, stdout) => error ? reject(error) : resolve10(stdout)
+      (error, stdout) => error ? reject(error) : resolve11(stdout)
     );
   });
 }
@@ -3212,7 +3338,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 (fs9.existsSync(path13.join(root, file))) changed.push(file);
+    if (fs10.existsSync(path14.join(root, file))) changed.push(file);
     else inventory.delete(file);
   }
   const ids = await hashPaths(root, changed);
@@ -3231,8 +3357,8 @@ async function readInventory(root, warn = () => {
 }
 
 // src/internal/coverage-upload/report-files.ts
-var fs10 = __toESM(require("fs"));
-var path14 = __toESM(require("path"));
+var fs11 = __toESM(require("fs"));
+var path15 = __toESM(require("path"));
 
 // ../core/src/coverage.ts
 var MAX_LINE = 1e6;
@@ -3700,8 +3826,8 @@ function relativeTo(path25, root) {
   const head = path25.slice(0, base.length);
   const inside = drive ? head.toLowerCase() === base.toLowerCase() : head === base;
   if (!inside) return null;
-  const relative9 = path25.slice(base.length);
-  return relative9 || null;
+  const relative8 = path25.slice(base.length);
+  return relative8 || null;
 }
 function reportPathCandidates(raw, { repoRoot, bases }) {
   const slash = (value) => value.replace(/\\/g, "/");
@@ -3712,8 +3838,8 @@ function reportPathCandidates(raw, { repoRoot, bases }) {
   const add = (absolute) => {
     const normalized = normalizeSlashPath(absolute);
     if (!normalized) return;
-    const relative9 = normalized.startsWith("/_/") ? normalized.slice(3) : relativeTo(normalized, root);
-    if (relative9 && !out.includes(relative9)) out.push(relative9);
+    const relative8 = normalized.startsWith("/_/") ? normalized.slice(3) : relativeTo(normalized, root);
+    if (relative8 && !out.includes(relative8)) out.push(relative8);
   };
   if (isAbsolutePath(path25)) {
     add(path25);
@@ -3744,14 +3870,14 @@ function globSegmentRegExp(segment) {
 function expandPattern(pattern, cwd) {
   const normalized = pattern.replace(/\\/g, "/");
   if (!/[*?]/.test(normalized)) {
-    const file = path14.resolve(cwd, normalized);
-    return fs10.existsSync(file) && fs10.statSync(file).isFile() ? [file] : [];
+    const file = path15.resolve(cwd, normalized);
+    return fs11.existsSync(file) && fs11.statSync(file).isFile() ? [file] : [];
   }
-  const absolute = path14.isAbsolute(normalized) || /^[A-Za-z]:\//.test(normalized);
+  const absolute = path15.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("/") || "/" : path14.resolve(cwd, ...baseParts);
+  const base = absolute ? baseParts.join("/") || "/" : path15.resolve(cwd, ...baseParts);
   const rest = segments.slice(firstWild).filter((s) => s !== "");
   const out = [];
   const walk = (dir, at) => {
@@ -3759,14 +3885,14 @@ function expandPattern(pattern, cwd) {
     const segment = rest[at];
     let entries;
     try {
-      entries = fs10.readdirSync(dir, { withFileTypes: true });
+      entries = fs11.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(path14.join(dir, entry.name), at);
+        if (entry.isDirectory() && !SKIPPED_DIRS.has(entry.name)) walk(path15.join(dir, entry.name), at);
       }
       return;
     }
@@ -3774,7 +3900,7 @@ function expandPattern(pattern, cwd) {
     const last = at === rest.length - 1;
     for (const entry of entries) {
       if (!match.test(entry.name)) continue;
-      const full = path14.join(dir, entry.name);
+      const full = path15.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);
@@ -3787,7 +3913,7 @@ function expandPattern(pattern, cwd) {
 async function readReport(file, format) {
   let reader = format ? new CoverageReportReader(format) : null;
   let head = "";
-  for await (const chunk of fs10.createReadStream(file, { encoding: "utf8", highWaterMark: 1024 * 1024 })) {
+  for await (const chunk of fs11.createReadStream(file, { encoding: "utf8", highWaterMark: 1024 * 1024 })) {
     if (!reader) {
       head += chunk;
       if (head.length < 4096) continue;
@@ -3809,18 +3935,18 @@ async function readReport(file, format) {
   return reader.end();
 }
 function reportBases(report, reportFile, options) {
-  if (options.root) return [path14.resolve(options.cwd, options.root)];
-  const dir = path14.dirname(path14.resolve(reportFile));
+  if (options.root) return [path15.resolve(options.cwd, options.root)];
+  const dir = path15.dirname(path15.resolve(reportFile));
   const sources = report.sources.map(
-    (source) => path14.isAbsolute(source) || /^[A-Za-z]:[\\/]/.test(source) ? source : path14.resolve(dir, source)
+    (source) => path15.isAbsolute(source) || /^[A-Za-z]:[\\/]/.test(source) ? source : path15.resolve(dir, source)
   );
-  return [...sources, options.cwd, dir, path14.dirname(dir), options.repoRoot];
+  return [...sources, options.cwd, dir, path15.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) => fs10.existsSync(path14.join(options.repoRoot, candidate)));
+    const match = candidates.find((candidate) => options.inventory.has(candidate)) ?? candidates.find((candidate) => fs11.existsSync(path15.join(options.repoRoot, candidate)));
     if (!match) {
       into.unmatched.push(file.path);
       continue;
@@ -3860,9 +3986,9 @@ Suite:
   --kind <kind>            unit (the default) or e2e
 
 Connection:
-  --project <name|id>      Project                 (env PIWI_PROJECT_NAME)
-  --server-url <url>       Dashboard URL           (env PIWI_DASHBOARD_URL)
-  --api-key <key>          API key                 (env PIWI_API_KEY)
+  --project <name|id>      Project                 (env PIWI_PROJECT_NAME, .env)
+  --server-url <url>       Dashboard URL           (env PIWI_DASHBOARD_URL, .env, the desktop app)
+  --api-key <key>          API key                 (env PIWI_API_KEY, .env)
   --branch <name>          The branch              (env PIWI_BRANCH, the CI's, else git's)
 
 Other:
@@ -3882,7 +4008,7 @@ var VALUE_OPTIONS = /* @__PURE__ */ new Set([
   "--api-key",
   "--branch"
 ]);
-function parseCoverageUploadArgs(argv, env) {
+function parseCoverageUploadArgs(argv, env, dirs = []) {
   const values = /* @__PURE__ */ new Map();
   const patterns2 = [];
   const flags = /* @__PURE__ */ new Set();
@@ -3913,11 +4039,19 @@ function parseCoverageUploadArgs(argv, env) {
   if (format !== void 0 && format !== "cobertura" && format !== "lcov" && format !== "piwi") {
     throw new Error("--format is cobertura, lcov or piwi");
   }
-  const serverUrl = (values.get("--server-url") ?? env.PIWI_DASHBOARD_URL ?? "").replace(/\/+$/, "");
+  const connection = resolveCliConnection(
+    { serverUrl: values.get("--server-url"), apiKey: values.get("--api-key"), project: values.get("--project") },
+    env,
+    dirs,
+    "piwi coverage upload"
+  );
+  const serverUrl = connection?.serverUrl ?? "";
   const dryRun = flags.has("--dry-run");
-  if (!serverUrl && !dryRun) throw new Error("No dashboard URL \u2014 pass --server-url or set PIWI_DASHBOARD_URL");
-  const project = values.get("--project") ?? env.PIWI_PROJECT_NAME ?? "";
-  if (!project && !dryRun) throw new Error("No project \u2014 pass --project or set PIWI_PROJECT_NAME");
+  if (!serverUrl && !dryRun)
+    throw new Error("No dashboard URL \u2014 pass --server-url or set PIWI_DASHBOARD_URL (environment or .env)");
+  const project = connection?.project ?? values.get("--project") ?? env.PIWI_PROJECT_NAME ?? "";
+  if (!project && !dryRun)
+    throw new Error("No project \u2014 pass --project or set PIWI_PROJECT_NAME (environment or .env)");
   return {
     patterns: patterns2,
     suite,
@@ -3926,7 +4060,7 @@ function parseCoverageUploadArgs(argv, env) {
     ...values.get("--root") ? { root: values.get("--root") } : {},
     project,
     serverUrl,
-    apiKey: values.get("--api-key") ?? env.PIWI_API_KEY ?? null,
+    apiKey: connection?.apiKey ?? null,
     ...values.get("--branch") ? { branch: values.get("--branch") } : {},
     dryRun,
     json: flags.has("--json")
@@ -4045,7 +4179,7 @@ async function uploadCoverage(args, env, cwd, warn = warnOnStderr) {
     commit: checkout.commit,
     branch,
     suite: args.suite,
-    reports: reports.map((report) => path15.relative(cwd, report) || report),
+    reports: reports.map((report) => path16.relative(cwd, report) || report),
     files: files.length,
     unmatched: resolved.unmatched.length,
     outOfScope: resolved.outOfScope,
@@ -4092,7 +4226,7 @@ ${USAGE4}`);
   }
   let args;
   try {
-    args = parseCoverageUploadArgs(rest, env);
+    args = parseCoverageUploadArgs(rest, env, [cwd]);
   } catch (error) {
     console.error(`piwi coverage upload: ${errorMessage(error)}`);
     return EXIT_ERROR4;
@@ -4115,7 +4249,7 @@ ${USAGE4}`);
 
 // src/cli/flake.ts
 var import_node_child_process6 = require("child_process");
-var fs11 = __toESM(require("fs"));
+var fs12 = __toESM(require("fs"));
 var os2 = __toESM(require("os"));
 var path17 = __toESM(require("path"));
 
@@ -4318,19 +4452,6 @@ function withinBudget(startedAt, now, budgetMs) {
   return now - startedAt < budgetMs;
 }
 
-// src/internal/support/connection.ts
-var path16 = __toESM(require("path"));
-function resolveCliConnection(flags, env, dirs) {
-  let dotEnv = {};
-  for (const dir of dirs) dotEnv = { ...readDotEnv(path16.join(dir, ".env")), ...dotEnv };
-  return resolvePiwiConnection({
-    flags,
-    env,
-    dotEnv,
-    desktop: readDesktopConfig(env[PIWI_DESKTOP_CONFIG_ENV] || defaultDesktopConfigPath())
-  });
-}
-
 // src/cli/flake.ts
 var USAGE5 = `
 piwi flake \u2014 make a flaky test fail on demand, then prove the fix
@@ -4373,7 +4494,7 @@ Options:
   --json               Print the results as JSON instead of text
   --server-url <url>   Dashboard URL (env PIWI_DASHBOARD_URL, .env, the desktop app)
   --api-key <key>      Reporter API key (env PIWI_API_KEY, .env)
-  --project <name|id>  The Piwi project, for a file:line test (env PIWI_PROJECT_NAME)
+  --project <name|id>  The Piwi project, for a file:line test (env PIWI_PROJECT_NAME, .env)
 
 Exit codes: 0 an arm reproduced the failure (verify: the fix held),
             1 nothing reproduced (verify: it still fails, or too few runs),
@@ -4521,8 +4642,8 @@ function playwrightRunner(dir, log) {
     now: () => Date.now(),
     async runBatch(plan, arm, repeat, batch) {
       const planFile = path17.join(dir, `${arm.id}.plan.json`);
-      if (!fs11.existsSync(planFile)) {
-        fs11.writeFileSync(
+      if (!fs12.existsSync(planFile)) {
+        fs12.writeFileSync(
           planFile,
           JSON.stringify({
             version: FLAKE_PLAN_VERSION,
@@ -4534,14 +4655,14 @@ function playwrightRunner(dir, log) {
         );
       }
       const resultsFile = path17.join(dir, `${arm.id}.${batch}.jsonl`);
-      fs11.writeFileSync(resultsFile, "");
+      fs12.writeFileSync(resultsFile, "");
       const env = {
         ...process.env,
         [PIWI_FLAKE_ENV.plan]: planFile,
         [PIWI_FLAKE_ENV.results]: resultsFile
       };
       delete env[PIWI_PROBE_ENV.flag];
-      fs11.appendFileSync(log, `
+      fs12.appendFileSync(log, `
 \u2500\u2500 ${arm.id} batch ${batch} \u2500\u2500
 `);
       await spawnPlaywright(playwrightArgs(plan.test, arm, repeat), env, {
@@ -4554,7 +4675,7 @@ function playwrightRunner(dir, log) {
 }
 function readResults(file) {
   const lines = [];
-  for (const line of fs11.readFileSync(file, "utf8").split("\n")) {
+  for (const line of fs12.readFileSync(file, "utf8").split("\n")) {
     if (!line.trim()) continue;
     try {
       lines.push(JSON.parse(line));
@@ -4718,7 +4839,7 @@ function printHeader(plan, commit, estimate, budgetMs) {
 async function loadPlan(args, commit) {
   if (args.planFile) {
     try {
-      const raw = JSON.parse(fs11.readFileSync(args.planFile, "utf8"));
+      const raw = JSON.parse(fs12.readFileSync(args.planFile, "utf8"));
       const plan = "plan" in raw && raw.plan ? raw.plan : raw;
       if (plan.version !== 1 || !plan.control || !Array.isArray(plan.arms)) throw new Error("not a flake-lab plan");
       if (args.verify !== (plan.kind === "verify")) {
@@ -4733,7 +4854,8 @@ async function loadPlan(args, commit) {
   const connection = resolveCliConnection(
     { serverUrl: args.serverUrl, apiKey: args.apiKey, project: args.project },
     process.env,
-    [process.cwd()]
+    [process.cwd()],
+    args.verify ? "piwi flake verify" : "piwi flake"
   );
   if (!connection) {
     throw new FlakeError(
@@ -4812,7 +4934,7 @@ async function runFlake(argv, runner) {
   if (!args.json) {
     printHeader(plan, commit, estimate, args.budgetMs);
   }
-  const dir = fs11.mkdtempSync(path17.join(os2.tmpdir(), "piwi-flake-"));
+  const dir = fs12.mkdtempSync(path17.join(os2.tmpdir(), "piwi-flake-"));
   const log = path17.join(dir, "playwright.log");
   let session;
   try {
@@ -4821,8 +4943,8 @@ async function runFlake(argv, runner) {
     });
   } catch (error) {
     console.error(`piwi flake: ${error.message}`);
-    if (fs11.existsSync(log)) {
-      const tail = fs11.readFileSync(log, "utf8").trimEnd().split("\n").slice(-LOG_TAIL_LINES).join("\n");
+    if (fs12.existsSync(log)) {
+      const tail = fs12.readFileSync(log, "utf8").trimEnd().split("\n").slice(-LOG_TAIL_LINES).join("\n");
       console.error(`
 Playwright's output (${log}):
 ${tail}`);
@@ -4895,7 +5017,7 @@ ${tail}`);
     verifyCommand: plan.kind === "reproduce" && verdict === "reproduced" ? verifyCommand : null,
     exitCode: code
   };
-  fs11.rmSync(dir, { recursive: true, force: true });
+  fs12.rmSync(dir, { recursive: true, force: true });
   if (args.json) {
     console.log(JSON.stringify(report, null, 2));
     return code;
@@ -4910,7 +5032,7 @@ ${tail}`);
 }
 
 // src/cli/gate.ts
-var fs12 = __toESM(require("fs"));
+var fs13 = __toESM(require("fs"));
 
 // ../core/src/gate.ts
 function formatGateResult(result) {
@@ -4956,8 +5078,8 @@ Where the run comes from (first match wins):
   (default)                ./piwi-run.json, if it exists
 
 Connection:
-  --server-url <url>       Dashboard URL      (env PIWI_DASHBOARD_URL)
-  --api-key <key>          API key            (env PIWI_API_KEY)
+  --server-url <url>       Dashboard URL      (env PIWI_DASHBOARD_URL, .env, the desktop app)
+  --api-key <key>          API key            (env PIWI_API_KEY, .env)
 
 Policy (at least one rule or warn-only flag is required):
   --require-tag <tags>     Comma-separated; every test carrying the tag must pass
@@ -5006,16 +5128,22 @@ function readCount(argv, name) {
 }
 function readRunIdFromFile(path25) {
   try {
-    const parsed = JSON.parse(fs12.readFileSync(path25, "utf-8"));
+    const parsed = JSON.parse(fs13.readFileSync(path25, "utf-8"));
     const runId = Number(parsed.runId);
     return Number.isFinite(runId) && runId > 0 ? runId : null;
   } catch {
     return null;
   }
 }
-function parseGateArgs(argv, env) {
-  const serverUrl = (readOption4(argv, "--server-url") ?? env.PIWI_DASHBOARD_URL ?? "").replace(/\/$/, "");
-  if (!serverUrl) throw new Error("No dashboard URL \u2014 pass --server-url or set PIWI_DASHBOARD_URL");
+function parseGateArgs(argv, env, dirs = []) {
+  const connection = resolveCliConnection(
+    { serverUrl: readOption4(argv, "--server-url"), apiKey: readOption4(argv, "--api-key") },
+    env,
+    dirs,
+    "piwi gate"
+  );
+  if (!connection)
+    throw new Error("No dashboard URL \u2014 pass --server-url or set PIWI_DASHBOARD_URL (environment or .env)");
   let runId = Number(readOption4(argv, "--run-id") ?? NaN);
   if (!Number.isFinite(runId) || runId <= 0) {
     const candidate = readOption4(argv, "--from-file") ?? env.PIWI_OUTPUT_FILE ?? "piwi-run.json";
@@ -5040,8 +5168,8 @@ function parseGateArgs(argv, env) {
     maxNewLeaks: readCount(argv, "--max-new-leaks")
   };
   return {
-    serverUrl,
-    apiKey: readOption4(argv, "--api-key") ?? env.PIWI_API_KEY ?? null,
+    serverUrl: connection.serverUrl,
+    apiKey: connection.apiKey,
     runId,
     policy,
     maxUncoveredChanges: readCount(argv, "--max-uncovered-changes"),
@@ -5066,14 +5194,14 @@ async function requestGate(args) {
   }
   return await res.json();
 }
-async function runGate(argv, env = process.env) {
+async function runGate(argv, env = process.env, cwd = process.cwd()) {
   if (argv.includes("-h") || argv.includes("--help")) {
     console.log(USAGE6);
     return EXIT_OK5;
   }
   let args;
   try {
-    args = parseGateArgs(argv, env);
+    args = parseGateArgs(argv, env, [cwd]);
   } catch (e) {
     console.error(`piwi gate: ${e.message}
 `);
@@ -5097,7 +5225,7 @@ async function runGate(argv, env = process.env) {
 }
 
 // src/cli/init.ts
-var fs15 = __toESM(require("fs"));
+var fs16 = __toESM(require("fs"));
 var path20 = __toESM(require("path"));
 
 // src/cli/report.ts
@@ -5115,9 +5243,9 @@ function formatStep(result) {
 }
 
 // src/cli/detect.ts
-var fs13 = __toESM(require("fs"));
+var fs14 = __toESM(require("fs"));
 var path18 = __toESM(require("path"));
-var CONFIG_NAMES = [
+var CONFIG_NAMES2 = [
   "playwright.config.ts",
   "playwright.config.mts",
   "playwright.config.cts",
@@ -5136,7 +5264,7 @@ var REPORTER_PACKAGE = "@piwitests/reporter";
 function readPackageJson(root) {
   const pkgPath = path18.join(root, "package.json");
   try {
-    return { pkg: JSON.parse(fs13.readFileSync(pkgPath, "utf-8")), pkgPath };
+    return { pkg: JSON.parse(fs14.readFileSync(pkgPath, "utf-8")), pkgPath };
   } catch {
     return { pkg: null, pkgPath: null };
   }
@@ -5145,14 +5273,14 @@ 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(path18.join(root, file))) return manager;
+    if (fs14.existsSync(path18.join(root, file))) return manager;
   }
   return "npm";
 }
 function findConfig(root) {
-  for (const name of CONFIG_NAMES) {
+  for (const name of CONFIG_NAMES2) {
     const candidate = path18.join(root, name);
-    if (fs13.existsSync(candidate)) return candidate;
+    if (fs14.existsSync(candidate)) return candidate;
   }
   return null;
 }
@@ -5313,7 +5441,7 @@ function ensureGitignoreEntry(existing, entry = ".env") {
 }
 
 // src/cli/skills.ts
-var fs14 = __toESM(require("fs"));
+var fs15 = __toESM(require("fs"));
 var path19 = __toESM(require("path"));
 
 // ../core/src/skill-stamp.ts
@@ -5381,7 +5509,7 @@ var DEFAULT_SKILLS_DIR = path19.join(".claude", "skills");
 function findTemplatesDir(fromDir) {
   let dir = fromDir;
   for (let i = 0; i < 6; i++) {
-    if (fs14.existsSync(path19.join(dir, "templates", "skills"))) return path19.join(dir, "templates");
+    if (fs15.existsSync(path19.join(dir, "templates", "skills"))) return path19.join(dir, "templates");
     const parent = path19.dirname(dir);
     if (parent === dir) break;
     dir = parent;
@@ -5400,7 +5528,7 @@ function readFrontMatter(markdown) {
 }
 function readTemplatesVersion(templatesDir) {
   try {
-    const pkg = JSON.parse(fs14.readFileSync(path19.join(templatesDir, "..", "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs15.readFileSync(path19.join(templatesDir, "..", "package.json"), "utf-8"));
     return typeof pkg.version === "string" ? pkg.version : "0.0.0";
   } catch {
     return "0.0.0";
@@ -5413,8 +5541,8 @@ function listSkills(templatesDir, slugs = ALL_SKILLS) {
   const infos = [];
   for (const slug of slugs) {
     const file = templatePath(templatesDir, slug);
-    if (!fs14.existsSync(file)) continue;
-    const front = readFrontMatter(fs14.readFileSync(file, "utf-8"));
+    if (!fs15.existsSync(file)) continue;
+    const front = readFrontMatter(fs15.readFileSync(file, "utf-8"));
     infos.push({ slug, name: front.name ?? slug, description: front.description ?? "" });
   }
   return infos;
@@ -5426,16 +5554,16 @@ function installSkills(opts) {
     const source = templatePath(opts.templatesDir, slug);
     const relDest = path19.join(opts.skillsDir, slug, "SKILL.md");
     const dest = path19.join(opts.root, relDest);
-    if (!fs14.existsSync(source)) {
+    if (!fs15.existsSync(source)) {
       results.push({ step, status: "error", detail: `no template found for "${slug}"` });
       continue;
     }
     const version = opts.version ?? readTemplatesVersion(opts.templatesDir);
-    const contents = stampSkill(fs14.readFileSync(source, "utf-8"), version);
-    const exists = fs14.existsSync(dest);
+    const contents = stampSkill(fs15.readFileSync(source, "utf-8"), version);
+    const exists = fs15.existsSync(dest);
     let detail = "installed skill";
     if (exists) {
-      const installed = fs14.readFileSync(dest, "utf-8");
+      const installed = fs15.readFileSync(dest, "utf-8");
       const state = classifyInstalledSkill(installed, contents);
       const from = readSkillStamp(installed).version;
       if (state === "current") {
@@ -5457,8 +5585,8 @@ function installSkills(opts) {
       }
     }
     if (!opts.dryRun) {
-      fs14.mkdirSync(path19.dirname(dest), { recursive: true });
-      fs14.writeFileSync(dest, contents);
+      fs15.mkdirSync(path19.dirname(dest), { recursive: true });
+      fs15.writeFileSync(dest, contents);
     }
     results.push({ step, file: relDest, status: exists ? "updated" : "created", detail });
   }
@@ -5552,7 +5680,7 @@ function runSkills(argv, templatesDir, cwd = process.cwd()) {
 
 // src/cli/init.ts
 var DEFAULT_SERVER_URL = "http://localhost:3000";
-var DESKTOP_APP_MODES = ["prefer", "fallback", "off"];
+var DESKTOP_APP_MODES2 = ["prefer", "fallback", "off"];
 var USAGE8 = `
 piwi init \u2014 wire a Playwright project up to a Piwi Dashboard
 
@@ -5628,7 +5756,7 @@ function parseInitArgs(argv, env, cwd) {
 }
 function readFileOr(file, fallback) {
   try {
-    return fs15.readFileSync(file, "utf-8");
+    return fs16.readFileSync(file, "utf-8");
   } catch {
     return fallback;
   }
@@ -5682,7 +5810,7 @@ function stepConfig(project, opts) {
     projectName: opts.projectName,
     desktopApp
   });
-  if (edit.status === "updated" && !opts.dryRun) fs15.writeFileSync(project.configPath, edit.text);
+  if (edit.status === "updated" && !opts.dryRun) fs16.writeFileSync(project.configPath, edit.text);
   if (edit.status === "already" && desktopApp && !new RegExp(`\\bdesktopApp\\s*:\\s*['"\`]${desktopApp}['"\`]`).test(source)) {
     return {
       step,
@@ -5697,7 +5825,7 @@ function stepFixtures(project, opts) {
   const step = "fixtures";
   const rel = path20.join("tests", project.configLang === "js" ? "fixtures.js" : "fixtures.ts");
   const dest = path20.join(project.root, rel);
-  if (fs15.existsSync(dest)) {
+  if (fs16.existsSync(dest)) {
     const current = readFileOr(dest, "");
     if (/piwiFixtures/.test(current))
       return { step, file: rel, status: "already", detail: "capture fixtures already set up" };
@@ -5709,8 +5837,8 @@ function stepFixtures(project, opts) {
     };
   }
   if (!opts.dryRun) {
-    fs15.mkdirSync(path20.dirname(dest), { recursive: true });
-    fs15.writeFileSync(dest, fixturesContents());
+    fs16.mkdirSync(path20.dirname(dest), { recursive: true });
+    fs16.writeFileSync(dest, fixturesContents());
   }
   return {
     step,
@@ -5726,7 +5854,7 @@ function stepEnv(project, opts) {
     ["PIWI_DASHBOARD_URL", opts.serverUrl],
     ["PIWI_API_KEY", ""]
   ]);
-  if (example.added.length && !opts.dryRun) fs15.writeFileSync(examplePath, example.text);
+  if (example.added.length && !opts.dryRun) fs16.writeFileSync(examplePath, example.text);
   results.push({
     step: "env",
     file: ".env.example",
@@ -5738,7 +5866,7 @@ function stepEnv(project, opts) {
     const entries = [["PIWI_API_KEY", opts.apiKey]];
     if (opts.serverUrl) entries.unshift(["PIWI_DASHBOARD_URL", opts.serverUrl]);
     const env = upsertEnvKeys(readFileOr(envPath, ""), entries);
-    if (env.added.length && !opts.dryRun) fs15.writeFileSync(envPath, env.text);
+    if (env.added.length && !opts.dryRun) fs16.writeFileSync(envPath, env.text);
     results.push({
       step: "env",
       file: ".env",
@@ -5747,7 +5875,7 @@ function stepEnv(project, opts) {
     });
     const gitignorePath = path20.join(project.root, ".gitignore");
     const gitignore = ensureGitignoreEntry(readFileOr(gitignorePath, ""));
-    if (gitignore.added && !opts.dryRun) fs15.writeFileSync(gitignorePath, gitignore.text);
+    if (gitignore.added && !opts.dryRun) fs16.writeFileSync(gitignorePath, gitignore.text);
     results.push({
       step: "gitignore",
       file: ".gitignore",
@@ -5790,8 +5918,8 @@ async function runInit(argv, env = process.env, cwd = process.cwd()) {
     return 0;
   }
   const opts = parseInitArgs(argv, env, cwd);
-  if (opts.desktopApp !== null && !DESKTOP_APP_MODES.includes(opts.desktopApp)) {
-    console.error(`--desktop-app must be one of ${DESKTOP_APP_MODES.join(", ")} (got "${opts.desktopApp}")`);
+  if (opts.desktopApp !== null && !DESKTOP_APP_MODES2.includes(opts.desktopApp)) {
+    console.error(`--desktop-app must be one of ${DESKTOP_APP_MODES2.join(", ")} (got "${opts.desktopApp}")`);
     return 1;
   }
   const project = detectProject(opts.root);
@@ -5848,7 +5976,7 @@ Piwi setup${opts.dryRun ? " (dry run \u2014 nothing written)" : ""} for "${opts.
 }
 
 // src/cli/select.ts
-var fs17 = __toESM(require("fs"));
+var fs18 = __toESM(require("fs"));
 var path22 = __toESM(require("path"));
 var import_node_child_process7 = require("child_process");
 
@@ -5979,9 +6107,9 @@ function pathGlobToRegExp(glob) {
   return new RegExp(`^(?:${parts.join("|")})$`);
 }
 function isTranslationFile(path25, globs = DEFAULT_TRANSLATION_GLOBS) {
-  const posix = path25.replace(/\\/g, "/");
-  if (!TRANSLATION_EXTENSIONS.test(posix)) return false;
-  return globs.some((g) => pathGlobToRegExp(g).test(posix));
+  const posix2 = path25.replace(/\\/g, "/");
+  if (!TRANSLATION_EXTENSIONS.test(posix2)) return false;
+  return globs.some((g) => pathGlobToRegExp(g).test(posix2));
 }
 function keepable(value) {
   const v = value.trim();
@@ -6694,7 +6822,7 @@ function diffImpactInput(files) {
 }
 
 // src/cli/add-reporter.ts
-var fs16 = __toESM(require("fs"));
+var fs17 = __toESM(require("fs"));
 var path21 = __toESM(require("path"));
 var import_node_module2 = require("module");
 var REPORTER_PACKAGE2 = "@piwitests/reporter";
@@ -6738,7 +6866,7 @@ function resolveConfigPath(cwd, playwrightArgs2) {
 function readConfigSource(configPath) {
   if (!configPath) return null;
   try {
-    return fs16.readFileSync(configPath, "utf-8");
+    return fs17.readFileSync(configPath, "utf-8");
   } catch {
     return null;
   }
@@ -6773,9 +6901,9 @@ Usage:
   npx @piwitests/reporter run impact --base <ref>    run the tests your diff impacts
 
 Connection:
-  --server-url <url>    Dashboard URL         (env PIWI_DASHBOARD_URL)
-  --api-key <key>       API key               (env PIWI_API_KEY)
-  --project <name|id>   Project               (env PIWI_PROJECT_NAME)
+  --server-url <url>    Dashboard URL         (env PIWI_DASHBOARD_URL, .env, the desktop app)
+  --api-key <key>       API key               (env PIWI_API_KEY, .env)
+  --project <name|id>   Project               (env PIWI_PROJECT_NAME, .env)
 
 Selection:
   --format <fmt>        args (file:line, default) | grep | files | json
@@ -6832,12 +6960,22 @@ function parseDuration2(raw) {
   const ms = Math.round(value * factor);
   return ms > 0 ? ms : null;
 }
-function parseSelectArgs(argv, env) {
+function parseSelectArgs(argv, env, dirs = [], command = "piwi select") {
   const dashIndex = argv.indexOf("--");
   const own = dashIndex === -1 ? argv : argv.slice(0, dashIndex);
   const extra = dashIndex === -1 ? [] : argv.slice(dashIndex + 1);
-  const serverUrl = (readOption7(own, "--server-url") ?? env.PIWI_DASHBOARD_URL ?? "").replace(/\/$/, "");
-  if (!serverUrl) throw new Error("No dashboard URL \u2014 pass --server-url or set PIWI_DASHBOARD_URL");
+  const connection = resolveCliConnection(
+    {
+      serverUrl: readOption7(own, "--server-url"),
+      apiKey: readOption7(own, "--api-key"),
+      project: readOption7(own, "--project")
+    },
+    env,
+    dirs,
+    command
+  );
+  if (!connection)
+    throw new Error("No dashboard URL \u2014 pass --server-url or set PIWI_DASHBOARD_URL (environment or .env)");
   const key = findKey(own);
   if (!key) throw new Error("No selection key \u2014 usage: piwi select <key>");
   const budgetRaw = readOption7(own, "--budget");
@@ -6851,9 +6989,9 @@ function parseSelectArgs(argv, env) {
     throw new Error(`--shard expects an "i/n" spec like 2/4, got "${shard}"`);
   }
   return {
-    serverUrl,
-    apiKey: readOption7(own, "--api-key") ?? env.PIWI_API_KEY ?? null,
-    project: readOption7(own, "--project") ?? env.PIWI_PROJECT_NAME ?? "",
+    serverUrl: connection.serverUrl,
+    apiKey: connection.apiKey,
+    project: connection.project,
     key,
     format: readOption7(own, "--format") ?? "args",
     budgetMs,
@@ -6872,7 +7010,7 @@ function cacheKey(args) {
 }
 function readCache(args) {
   try {
-    const store = JSON.parse(fs17.readFileSync(CACHE_FILE, "utf-8"));
+    const store = JSON.parse(fs18.readFileSync(CACHE_FILE, "utf-8"));
     return store[cacheKey(args)] ?? null;
   } catch {
     return null;
@@ -6882,12 +7020,12 @@ function writeCache(args, resolution) {
   try {
     let store = {};
     try {
-      store = JSON.parse(fs17.readFileSync(CACHE_FILE, "utf-8"));
+      store = JSON.parse(fs18.readFileSync(CACHE_FILE, "utf-8"));
     } catch {
     }
     store[cacheKey(args)] = resolution;
-    fs17.mkdirSync(path22.dirname(CACHE_FILE), { recursive: true });
-    fs17.writeFileSync(CACHE_FILE, JSON.stringify(store, null, 2));
+    fs18.mkdirSync(path22.dirname(CACHE_FILE), { recursive: true });
+    fs18.writeFileSync(CACHE_FILE, JSON.stringify(store, null, 2));
   } catch {
   }
 }
@@ -6979,7 +7117,7 @@ async function runSelect(argv, env = process.env) {
   }
   let args;
   try {
-    args = parseSelectArgs(argv, env);
+    args = parseSelectArgs(argv, env, [process.cwd()]);
   } catch (e) {
     console.error(`piwi select: ${e.message}
 `);
@@ -7070,7 +7208,7 @@ async function runRun(argv, env = process.env) {
   }
   let args;
   try {
-    args = parseSelectArgs(argv, env);
+    args = parseSelectArgs(argv, env, [process.cwd()], "piwi run");
   } catch (e) {
     console.error(`piwi run: ${e.message}
 `);
@@ -7120,7 +7258,7 @@ async function runRun(argv, env = process.env) {
 }
 
 // src/cli/preflight.ts
-var fs18 = __toESM(require("fs"));
+var fs19 = __toESM(require("fs"));
 var path23 = __toESM(require("path"));
 var import_node_child_process8 = require("child_process");
 
@@ -7186,8 +7324,8 @@ Actions:
 
 Connection:
   --server-url <url>    Dashboard URL         (env PIWI_DASHBOARD_URL, .env, the desktop app)
-  --api-key <key>       API key               (env PIWI_API_KEY)
-  --project <name|id>   Project               (env PIWI_PROJECT_NAME)
+  --api-key <key>       API key               (env PIWI_API_KEY, .env)
+  --project <name|id>   Project               (env PIWI_PROJECT_NAME, .env)
 
 Output:
   --json                Print the breaks, the edits and the impact as JSON
@@ -7244,16 +7382,6 @@ function parsePreflightArgs(argv) {
     extra: dashIndex === -1 ? [] : argv.slice(dashIndex + 1)
   };
 }
-var CONFIG_NAMES2 = ["playwright.config.ts", "playwright.config.js", "playwright.config.mjs", "playwright.config.cjs"];
-function findPlaywrightRoot(from) {
-  let dir = path23.resolve(from);
-  for (; ; ) {
-    if (CONFIG_NAMES2.some((name) => fs18.existsSync(path23.join(dir, name)))) return dir;
-    const parent = path23.dirname(dir);
-    if (parent === dir) return null;
-    dir = parent;
-  }
-}
 function git3(cwd, args) {
   return (0, import_node_child_process8.execFileSync)("git", args, {
     cwd,
@@ -7271,7 +7399,12 @@ function tryGit(cwd, args) {
 }
 var TEST_FILE = /(?:^|\/)[^/]+\.(?:spec|test)\.[cm]?[jt]sx?$/;
 function resolveConnection(args, env, dirs) {
-  return resolveCliConnection({ serverUrl: args.serverUrl, apiKey: args.apiKey, project: args.project }, env, dirs);
+  return resolveCliConnection(
+    { serverUrl: args.serverUrl, apiKey: args.apiKey, project: args.project },
+    env,
+    dirs,
+    "piwi preflight"
+  );
 }
 function translationLookup(repoRoot, base, locale) {
   const files = (tryGit(repoRoot, ["ls-files"]) ?? "").split("\n").filter((f) => f && isTranslationFile(f)).sort((a, b) => Number(prefersLocale(b, locale)) - Number(prefersLocale(a, locale)) || a.localeCompare(b));
@@ -7298,7 +7431,7 @@ function prefersLocale(file, locale) {
 }
 function readText(file) {
   try {
-    return fs18.readFileSync(file, "utf-8");
+    return fs19.readFileSync(file, "utf-8");
   } catch {
     return void 0;
   }
@@ -7309,7 +7442,7 @@ function cacheKey2(connection, branch) {
 }
 function readCache2(root, key) {
   try {
-    const store = JSON.parse(fs18.readFileSync(path23.join(root, CACHE_FILE2), "utf-8"));
+    const store = JSON.parse(fs19.readFileSync(path23.join(root, CACHE_FILE2), "utf-8"));
     return store[key] ?? null;
   } catch {
     return null;
@@ -7320,12 +7453,12 @@ function writeCache2(root, key, index) {
   try {
     let store = {};
     try {
-      store = JSON.parse(fs18.readFileSync(file, "utf-8"));
+      store = JSON.parse(fs19.readFileSync(file, "utf-8"));
     } catch {
     }
     store[key] = { savedAt: (/* @__PURE__ */ new Date()).toISOString(), index };
-    fs18.mkdirSync(path23.dirname(file), { recursive: true });
-    fs18.writeFileSync(file, JSON.stringify(store));
+    fs19.mkdirSync(path23.dirname(file), { recursive: true });
+    fs19.writeFileSync(file, JSON.stringify(store));
   } catch {
   }
 }
@@ -7384,7 +7517,7 @@ function applyEdits(breaks, replacementsOf) {
   }
   const edited = [];
   for (const [file, edits] of byFile) {
-    const text = fs18.readFileSync(file, "utf-8");
+    const text = fs19.readFileSync(file, "utf-8");
     const eol = text.includes("\r\n") ? "\r\n" : "\n";
     const lines = text.split(/\r?\n/);
     for (const e of edits) {
@@ -7394,7 +7527,7 @@ function applyEdits(breaks, replacementsOf) {
     }
     const next = lines.join(eol);
     if (next !== text) {
-      fs18.writeFileSync(file, next);
+      fs19.writeFileSync(file, next);
       edited.push(file);
     }
   }
@@ -7505,7 +7638,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 = path23.resolve(cwd, args.testRoot ?? findPlaywrightRoot(cwd) ?? cwd);
+  const testRoot = path23.resolve(cwd, args.testRoot ?? findPlaywrightRoot(cwd, repoRoot) ?? cwd);
   let files;
   try {
     files = parseUnifiedDiff(
@@ -7631,7 +7764,7 @@ async function runPreflight(argv, env = process.env, cwd = process.cwd()) {
 }
 
 // src/cli/probe.ts
-var fs19 = __toESM(require("fs"));
+var fs20 = __toESM(require("fs"));
 var os3 = __toESM(require("os"));
 var path24 = __toESM(require("path"));
 var EXIT_OK8 = 0;
@@ -7643,9 +7776,9 @@ Usage:
   npx @piwitests/reporter probe [options] [-- <playwright args>]
 
 Options:
-  --server-url <url>   Dashboard URL (or PIWI_DASHBOARD_URL)
-  --api-key <key>      Reporter API key (or PIWI_API_KEY)
-  --project <name|id>  Project name or id (or PIWI_PROJECT_NAME)
+  --server-url <url>   Dashboard URL (or PIWI_DASHBOARD_URL, .env, the desktop app)
+  --api-key <key>      Reporter API key (or PIWI_API_KEY, .env)
+  --project <name|id>  Project name or id (or PIWI_PROJECT_NAME, .env)
   --budget <n>         Max pairs to probe this run (default the server's)
 
 Everything after \`--\` is passed to \`playwright test\`.
@@ -7658,21 +7791,29 @@ function escapeRegex2(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 async function runProbe(argv) {
-  const sep7 = argv.indexOf("--");
-  const own = sep7 < 0 ? argv : argv.slice(0, sep7);
-  const playwrightArgs2 = sep7 < 0 ? [] : argv.slice(sep7 + 1);
+  const sep6 = argv.indexOf("--");
+  const own = sep6 < 0 ? argv : argv.slice(0, sep6);
+  const playwrightArgs2 = sep6 < 0 ? [] : argv.slice(sep6 + 1);
   if (own.includes("-h") || own.includes("--help")) {
     console.log(USAGE11);
     return EXIT_OK8;
   }
   const env = process.env;
-  const serverUrl = (readOption9(own, "--server-url") ?? env.PIWI_DASHBOARD_URL ?? "").replace(/\/$/, "");
-  if (!serverUrl) {
-    console.error("piwi probe: no dashboard URL \u2014 pass --server-url or set PIWI_DASHBOARD_URL");
+  const connection = resolveCliConnection(
+    {
+      serverUrl: readOption9(own, "--server-url"),
+      apiKey: readOption9(own, "--api-key"),
+      project: readOption9(own, "--project")
+    },
+    env,
+    [process.cwd()],
+    "piwi probe"
+  );
+  if (!connection) {
+    console.error("piwi probe: no dashboard URL \u2014 pass --server-url or set PIWI_DASHBOARD_URL (environment or .env)");
     return EXIT_ERROR9;
   }
-  const apiKey = readOption9(own, "--api-key") ?? env.PIWI_API_KEY ?? null;
-  const project = readOption9(own, "--project") ?? env.PIWI_PROJECT_NAME ?? "";
+  const { serverUrl, apiKey, project } = connection;
   const budget = readOption9(own, "--budget");
   let projectId;
   try {
@@ -7697,12 +7838,12 @@ 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(path24.join(os3.tmpdir(), "piwi-probe-"));
+  const dir = fs20.mkdtempSync(path24.join(os3.tmpdir(), "piwi-probe-"));
   const planFile = path24.join(dir, "plan.json");
   const resultsFile = path24.join(dir, "results.jsonl");
   const runOutputFile = path24.join(dir, "run.json");
-  fs19.writeFileSync(planFile, JSON.stringify(plan));
-  fs19.writeFileSync(resultsFile, "");
+  fs20.writeFileSync(planFile, JSON.stringify(plan));
+  fs20.writeFileSync(resultsFile, "");
   const grep = plan.items.map((i) => i.testTitle).filter(Boolean).map(escapeRegex2).join("|");
   const pwArgs = [...playwrightArgs2];
   if (grep && !playwrightArgs2.includes("--grep") && !playwrightArgs2.includes("-g")) pwArgs.push("--grep", grep);
@@ -7716,7 +7857,7 @@ async function runProbe(argv) {
     [PIWI_ENV_KEYS.outputFile]: runOutputFile
   };
   await spawnPlaywright(pwArgs, childEnv, { command: "piwi probe" });
-  const lines = fs19.readFileSync(resultsFile, "utf8").split("\n").filter(Boolean);
+  const lines = fs20.readFileSync(resultsFile, "utf8").split("\n").filter(Boolean);
   const results = [];
   for (const line of lines) {
     try {
@@ -7730,7 +7871,7 @@ async function runProbe(argv) {
   }
   let runId = null;
   try {
-    const out = JSON.parse(fs19.readFileSync(runOutputFile, "utf8"));
+    const out = JSON.parse(fs20.readFileSync(runOutputFile, "utf8"));
     if (typeof out.runId === "number") runId = out.runId;
   } catch {
   }
@@ -7755,7 +7896,7 @@ async function runProbe(argv) {
 }
 
 // src/cli/quality-report.ts
-var fs20 = __toESM(require("fs"));
+var fs21 = __toESM(require("fs"));
 var EXIT_OK9 = 0;
 var EXIT_VERDICT = 1;
 var EXIT_ERROR10 = 2;
@@ -7768,8 +7909,8 @@ Usage:
   npx @piwitests/reporter report [options]
 
 Connection:
-  --server-url <url>     Dashboard URL                 (env PIWI_DASHBOARD_URL)
-  --api-key <key>        API key                       (env PIWI_API_KEY)
+  --server-url <url>     Dashboard URL                 (env PIWI_DASHBOARD_URL, .env, the desktop app)
+  --api-key <key>        API key                       (env PIWI_API_KEY, .env)
 
 What to report:
   --project <names|ids>  Comma-separated projects (default: every project you can see)
@@ -7801,9 +7942,15 @@ function normalizePeriod(raw) {
   const days = raw.trim().match(/^(\d+)d$/);
   return days ? `last-${days[1]}d` : raw.trim();
 }
-function parseReportArgs(argv, env) {
-  const serverUrl = (readOption10(argv, "--server-url") ?? env.PIWI_DASHBOARD_URL ?? "").replace(/\/$/, "");
-  if (!serverUrl) throw new Error("No dashboard URL \u2014 pass --server-url or set PIWI_DASHBOARD_URL");
+function parseReportArgs(argv, env, dirs = []) {
+  const connection = resolveCliConnection(
+    { serverUrl: readOption10(argv, "--server-url"), apiKey: readOption10(argv, "--api-key") },
+    env,
+    dirs,
+    "piwi report"
+  );
+  if (!connection)
+    throw new Error("No dashboard URL \u2014 pass --server-url or set PIWI_DASHBOARD_URL (environment or .env)");
   const format = (readOption10(argv, "--format") ?? "md").toLowerCase();
   if (!FORMATS.includes(format)) {
     throw new Error(`--format must be one of ${FORMATS.join(", ")}, got "${format}"`);
@@ -7823,8 +7970,8 @@ function parseReportArgs(argv, env) {
   const output = readOption10(argv, "--output") ?? null;
   if (format === "pdf" && !output) throw new Error("A PDF needs --output <file>");
   return {
-    serverUrl,
-    apiKey: readOption10(argv, "--api-key") ?? env.PIWI_API_KEY ?? null,
+    serverUrl: connection.serverUrl,
+    apiKey: connection.apiKey,
     projects: (readOption10(argv, "--project") ?? "").split(",").map((p) => p.trim()).filter(Boolean),
     period: normalizePeriod(readOption10(argv, "--period") ?? "30d"),
     compare: readOption10(argv, "--compare") ?? null,
@@ -7868,14 +8015,14 @@ async function runQualityReport(argv) {
     return EXIT_OK9;
   }
   try {
-    const args = parseReportArgs(argv, process.env);
+    const args = parseReportArgs(argv, process.env, [process.cwd()]);
     const projectIds = [];
     for (const project of args.projects) {
       projectIds.push(await resolveProjectId({ serverUrl: args.serverUrl, apiKey: args.apiKey, project, key: "" }));
     }
     const res = await fetchReport(args, reportQuery(args, projectIds, args.format));
     const bytes = new Uint8Array(await res.arrayBuffer());
-    if (args.output) fs20.writeFileSync(args.output, bytes);
+    if (args.output) fs21.writeFileSync(args.output, bytes);
     else process.stdout.write(bytes);
     if (!args.failOn) return EXIT_OK9;
     const bundle = args.format === "json" ? JSON.parse(new TextDecoder().decode(bytes)) : await (await fetchReport(args, reportQuery(args, projectIds, "json"))).json();