@piwitests/reporter 0.36.0 → 0.38.0

package/dist/cli/index.js

@@ -422,6 +422,7 @@ function formatGateResult(result) {
     );
   }
   for (const violation of result.violations) lines.push(`  \u2716 ${violation.message}`);
+  for (const warning of result.warnings ?? []) lines.push(`  \u26A0 ${warning}`);
   lines.push(`  ${facts.runUrl}`);
   return lines.join("\n");
 }
@@ -456,6 +457,9 @@ Policy (at least one is required):
   --fail-on-flaky          Fail when this run contains any flaky test
   --require-selection <key>  Fail when a test the named selection matches did not run or failed
 
+Warn-only (reported, never fails the build):
+  --max-uncovered-changes <n>  Warn when more than n changed files have no observed test reach
+
 Other:
   --json                   Print the raw result as JSON instead of a summary
   -h, --help               Show this help
@@ -477,9 +481,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(path11) {
+function readRunIdFromFile(path13) {
   try {
-    const parsed = JSON.parse(fs3.readFileSync(path11, "utf-8"));
+    const parsed = JSON.parse(fs3.readFileSync(path13, "utf-8"));
     const runId = Number(parsed.runId);
     return Number.isFinite(runId) && runId > 0 ? runId : null;
   } catch {
@@ -510,7 +514,13 @@ function parseGateArgs(argv, env) {
     failOnFlaky: argv.includes("--fail-on-flaky"),
     requireSelection: readOption2(argv, "--require-selection")
   };
-  return { serverUrl, apiKey: readOption2(argv, "--api-key") ?? env.PIWI_API_KEY ?? null, runId, policy };
+  return {
+    serverUrl,
+    apiKey: readOption2(argv, "--api-key") ?? env.PIWI_API_KEY ?? null,
+    runId,
+    policy,
+    maxUncoveredChanges: readCount(argv, "--max-uncovered-changes")
+  };
 }
 async function requestGate(args) {
   const headers = { "Content-Type": "application/json" };
@@ -518,7 +528,7 @@ async function requestGate(args) {
   const res = await fetch(`${args.serverUrl}/api/test-runs/${args.runId}/gate`, {
     method: "POST",
     headers,
-    body: JSON.stringify(args.policy)
+    body: JSON.stringify({ ...args.policy, maxUncoveredChanges: args.maxUncoveredChanges })
   });
   if (!res.ok) {
     const body = await res.json().catch(() => ({}));
@@ -778,7 +788,8 @@ var WORKFLOW_SKILLS = [
   "investigate-failure",
   "apply-locator-healing",
   "stabilize-flaky-tests",
-  "run-the-right-tests"
+  "run-the-right-tests",
+  "write-the-missing-test"
 ];
 var ALL_SKILLS = [SETUP_SKILL, ...WORKFLOW_SKILLS];
 var DEFAULT_SKILLS_DIR = path7.join(".claude", "skills");
@@ -1675,8 +1686,267 @@ async function runRun(argv, env = process.env) {
   return spawnPlaywrightForRun(args.pkgRunner, [...resolution.materialization.args, ...args.extra], runEnv);
 }
 
-// src/cli/index.ts
+// src/cli/probe.ts
+var import_node_child_process4 = require("child_process");
+var import_node_module3 = require("module");
+var fs10 = __toESM(require("fs"));
+var os2 = __toESM(require("os"));
+var path12 = __toESM(require("path"));
+
+// src/internal/config/desktop.ts
+var fs9 = __toESM(require("fs"));
+var os = __toESM(require("os"));
+var path11 = __toESM(require("path"));
+
+// 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,
+  captureServerTraces: true,
+  sampleAriaOnPass: true,
+  uploadManifest: true,
+  defaultCapture: true,
+  streaming: true,
+  streamingBatchSize: 5,
+  streamingBatchDelay: 2e3,
+  maxStreamBufferBytes: 100 * 1024 * 1024,
+  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",
+  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",
+  captureServerTraces: "PIWI_CAPTURE_SERVER_TRACES",
+  sampleAriaOnPass: "PIWI_SAMPLE_ARIA_ON_PASS",
+  uploadManifest: "PIWI_UPLOAD_MANIFEST",
+  defaultCapture: "PIWI_DEFAULT_CAPTURE",
+  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_PROBE_ENV = {
+  flag: "PIWI_PROBE",
+  plan: "PIWI_PROBE_PLAN",
+  results: "PIWI_PROBE_RESULTS",
+  secret: "PIWI_PROBE_SECRET"
+};
+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: "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: "captureServerTraces", env: PIWI_ENV_KEYS.captureServerTraces, kind: "bool" },
+  { 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: "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/probe.ts
+var EXIT_OK4 = 0;
+var EXIT_ERROR4 = 2;
 var USAGE6 = `
+piwi probe \u2014 run the dashboard's probe plan and record what the suite noticed
+
+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)
+  --budget <n>         Max pairs to probe this run (default the server's)
+
+Everything after \`--\` is passed to \`playwright test\`.
+`.trim();
+function readOption6(argv, name) {
+  const i = argv.indexOf(name);
+  return i >= 0 && i + 1 < argv.length ? argv[i + 1] : void 0;
+}
+function escapeRegex(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function resolvePlaywrightCli2() {
+  const require2 = (0, import_node_module3.createRequire)(path12.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(playwrightArgs, env) {
+  const cli = resolvePlaywrightCli2();
+  const child = cli ? (0, import_node_child_process4.spawn)(process.execPath, [cli, "test", ...playwrightArgs], { stdio: "inherit", env }) : (0, import_node_child_process4.spawn)(process.platform === "win32" ? "npx.cmd" : "npx", ["playwright", "test", ...playwrightArgs], {
+    stdio: "inherit",
+    env
+  });
+  return new Promise((resolve6) => {
+    child.on("error", (err) => {
+      console.error(`piwi probe: could not start Playwright \u2014 ${err.message}`);
+      resolve6(EXIT_ERROR4);
+    });
+    child.on("exit", (code) => resolve6(code ?? EXIT_ERROR4));
+  });
+}
+async function runProbe(argv) {
+  const sep3 = argv.indexOf("--");
+  const own = sep3 < 0 ? argv : argv.slice(0, sep3);
+  const playwrightArgs = sep3 < 0 ? [] : argv.slice(sep3 + 1);
+  if (own.includes("-h") || own.includes("--help")) {
+    console.log(USAGE6);
+    return EXIT_OK4;
+  }
+  const env = process.env;
+  const serverUrl = (readOption6(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");
+    return EXIT_ERROR4;
+  }
+  const apiKey = readOption6(own, "--api-key") ?? env.PIWI_API_KEY ?? null;
+  const project = readOption6(own, "--project") ?? env.PIWI_PROJECT_NAME ?? "";
+  const budget = readOption6(own, "--budget");
+  let projectId;
+  try {
+    projectId = await resolveProjectId({ serverUrl, apiKey, project, key: "" });
+  } catch (e) {
+    console.error(`piwi probe: ${e.message}`);
+    return EXIT_ERROR4;
+  }
+  const authHeaders2 = apiKey ? { "X-API-Key": apiKey } : {};
+  const planUrl = `${serverUrl}/api/projects/${projectId}/probes/plan${budget ? `?budget=${encodeURIComponent(budget)}` : ""}`;
+  let plan;
+  try {
+    const res = await fetch(planUrl, { headers: authHeaders2 });
+    if (!res.ok) throw new Error(`dashboard returned ${res.status}`);
+    plan = await res.json();
+  } catch (e) {
+    console.error(`piwi probe: could not fetch the probe plan \u2014 ${e.message}`);
+    return EXIT_ERROR4;
+  }
+  if (!plan.items || plan.items.length === 0) {
+    console.error("piwi probe: nothing to probe \u2014 the plan is empty.");
+    return EXIT_OK4;
+  }
+  console.error(`piwi probe: ${plan.items.length} pair(s) to probe (budget ${plan.budget}).`);
+  const dir = fs10.mkdtempSync(path12.join(os2.tmpdir(), "piwi-probe-"));
+  const planFile = path12.join(dir, "plan.json");
+  const resultsFile = path12.join(dir, "results.jsonl");
+  const runOutputFile = path12.join(dir, "run.json");
+  fs10.writeFileSync(planFile, JSON.stringify(plan));
+  fs10.writeFileSync(resultsFile, "");
+  const grep = plan.items.map((i) => i.testTitle).filter(Boolean).map(escapeRegex).join("|");
+  const pwArgs = [...playwrightArgs];
+  if (grep && !playwrightArgs.includes("--grep") && !playwrightArgs.includes("-g")) pwArgs.push("--grep", grep);
+  const childEnv = {
+    ...env,
+    [PIWI_PROBE_ENV.flag]: "1",
+    [PIWI_PROBE_ENV.plan]: planFile,
+    [PIWI_PROBE_ENV.results]: resultsFile,
+    // The reporter creates the probe run and knows its server-assigned id; have
+    // it write the run output here so the results POST can name the run.
+    [PIWI_ENV_KEYS.outputFile]: runOutputFile
+  };
+  await spawnPlaywright2(pwArgs, childEnv);
+  const lines = fs10.readFileSync(resultsFile, "utf8").split("\n").filter(Boolean);
+  const results = [];
+  for (const line of lines) {
+    try {
+      results.push(JSON.parse(line));
+    } catch {
+    }
+  }
+  if (results.length === 0) {
+    console.error("piwi probe: no probe outcomes were recorded (are the Piwi capture fixtures active?).");
+    return EXIT_OK4;
+  }
+  let runId = null;
+  try {
+    const out = JSON.parse(fs10.readFileSync(runOutputFile, "utf8"));
+    if (typeof out.runId === "number") runId = out.runId;
+  } catch {
+  }
+  try {
+    const res = await fetch(`${serverUrl}/api/projects/${projectId}/probes/results`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...authHeaders2 },
+      body: JSON.stringify({ runId, results })
+    });
+    if (!res.ok) throw new Error(`dashboard returned ${res.status}`);
+    const body = await res.json();
+    const noticed = results.filter((r) => r.outcome === "noticed").length;
+    const notNoticed = results.filter((r) => r.outcome === "not-noticed").length;
+    console.error(
+      `piwi probe: recorded ${body.recorded ?? results.length} outcome(s) \u2014 ${noticed} noticed, ${notNoticed} not noticed.`
+    );
+  } catch (e) {
+    console.error(`piwi probe: could not post probe results \u2014 ${e.message}`);
+    return EXIT_ERROR4;
+  }
+  return EXIT_OK4;
+}
+
+// src/cli/index.ts
+var USAGE7 = `
 piwi \u2014 companion commands for the Piwi Dashboard reporter
 
 Usage:
@@ -1688,6 +1958,7 @@ Commands:
   gate      Fail a CI job on the dashboard's analysis of a run
   select    Print the Playwright args for a saved test selection
   run       Run a saved test selection with playwright test
+  probe     Run the dashboard's probe plan and record what the suite noticed
   ai        Manage committed natural-language AI-step artifacts
 
 Run \`npx @piwitests/reporter <command> --help\` for a command's options.
@@ -1707,17 +1978,19 @@ async function main() {
       return runSelect(rest);
     case "run":
       return runRun(rest);
+    case "probe":
+      return runProbe(rest);
     case "ai":
       return runAi(rest);
     case void 0:
     case "-h":
     case "--help":
-      console.log(USAGE6);
+      console.log(USAGE7);
       return 0;
     default:
       console.error(`piwi: unknown command "${command}"
 `);
-      console.error(USAGE6);
+      console.error(USAGE7);
       return 2;
   }
 }

package/dist/global-setup-module.js

@@ -35,7 +35,7 @@ __export(global_setup_module_exports, {
 module.exports = __toCommonJS(global_setup_module_exports);
 
 // src/public/global-setup.ts
-var path4 = __toESM(require("path"));
+var path5 = __toESM(require("path"));
 
 // src/internal/support/errors.ts
 function errorMessage(error) {
@@ -44,7 +44,7 @@ function errorMessage(error) {
 }
 
 // src/public/global-setup.ts
-var fs4 = __toESM(require("fs"));
+var fs5 = __toESM(require("fs"));
 
 // src/internal/config/desktop.ts
 var fs = __toESM(require("fs"));
@@ -77,8 +77,12 @@ var DEFAULTS = {
   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,
   captureServerTraces: true,
   sampleAriaOnPass: true,
+  uploadManifest: true,
   defaultCapture: true,
   streaming: true,
   streamingBatchSize: 5,
@@ -100,6 +104,7 @@ var PIWI_ENV_KEYS = {
   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",
@@ -110,8 +115,10 @@ var PIWI_ENV_KEYS = {
   uploadReport: "PIWI_UPLOAD_REPORT",
   captureLocators: "PIWI_CAPTURE_LOCATORS",
   capturePageState: "PIWI_CAPTURE_PAGE_STATE",
+  capturePageInventory: "PIWI_CAPTURE_PAGE_INVENTORY",
   captureServerTraces: "PIWI_CAPTURE_SERVER_TRACES",
   sampleAriaOnPass: "PIWI_SAMPLE_ARIA_ON_PASS",
+  uploadManifest: "PIWI_UPLOAD_MANIFEST",
   defaultCapture: "PIWI_DEFAULT_CAPTURE",
   inspectOnFailure: "PIWI_INSPECT_ON_FAIL",
   pickLocatorOnFailure: "PIWI_PICK_LOCATOR_ON_FAIL",
@@ -139,6 +146,7 @@ var ENV_FALLBACK_SPECS = [
   { 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" },
@@ -149,8 +157,10 @@ var ENV_FALLBACK_SPECS = [
   { 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: "captureServerTraces", env: PIWI_ENV_KEYS.captureServerTraces, kind: "bool" },
   { 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: "inspectOnFailure", env: PIWI_ENV_KEYS.inspectOnFailure, kind: "bool" },
   { option: "pickLocatorOnFailure", env: PIWI_ENV_KEYS.pickLocatorOnFailure, kind: "bool" },
@@ -351,6 +361,27 @@ var HttpClient = class {
       return {};
     }
   }
+  /** Send a JSON PUT request. Used for the declared-surface manifest upload. */
+  async putJSON(pathname, payload, auth) {
+    const body = JSON.stringify(payload);
+    const res = await this.request("PUT", pathname, {
+      headers: {
+        "Content-Type": "application/json",
+        "Content-Length": Buffer.byteLength(body)
+      },
+      body,
+      auth
+    });
+    if (res.status < 200 || res.status >= 300) {
+      this.logger.debugError(`Response: ${res.text}`);
+      throw new HttpError(res.status);
+    }
+    try {
+      return JSON.parse(res.text);
+    } catch {
+      return {};
+    }
+  }
   /** Send a multipart form-data POST request. Used for report and trace uploads. */
   async postFormData(pathname, form, auth) {
     const headers = form.getHeaders();
@@ -453,6 +484,36 @@ function detectCiRunLabel() {
   return null;
 }
 
+// src/internal/collect/metadata-collector.ts
+var import_node_child_process = require("child_process");
+var DETACHED_HEAD = "HEAD";
+function resolveScmBranch(env, gitBranch) {
+  const pick = (...names) => {
+    for (const name of names) {
+      const value = env[name]?.trim();
+      if (value) return value;
+    }
+    return void 0;
+  };
+  const override = env.PIWI_BRANCH?.trim();
+  if (override) return override;
+  let provider;
+  if (env.JENKINS_URL) provider = pick("CHANGE_BRANCH", "BRANCH_NAME");
+  else if (env.GITHUB_ACTIONS) provider = pick("GITHUB_HEAD_REF", "GITHUB_REF_NAME");
+  else if (env.GITLAB_CI) provider = pick("CI_MERGE_REQUEST_SOURCE_BRANCH_NAME", "CI_COMMIT_REF_NAME");
+  else if (env.CIRCLECI) provider = pick("CIRCLE_BRANCH");
+  else if (env.TRAVIS) provider = pick("TRAVIS_PULL_REQUEST_BRANCH", "TRAVIS_BRANCH");
+  else if (env.TF_BUILD) provider = pick("SYSTEM_PULLREQUEST_SOURCEBRANCH", "BUILD_SOURCEBRANCHNAME");
+  else if (env.BITBUCKET_BUILD_NUMBER) provider = pick("BITBUCKET_BRANCH");
+  if (provider) return normalizeRef(provider);
+  const trimmed = gitBranch?.trim();
+  if (trimmed && trimmed !== DETACHED_HEAD) return trimmed;
+  return void 0;
+}
+function normalizeRef(ref) {
+  return ref.replace(/^refs\/heads\//, "");
+}
+
 // src/internal/support/setup-file.ts
 var path2 = __toESM(require("path"));
 var os3 = __toESM(require("os"));
@@ -500,17 +561,83 @@ function isListMode(argv = process.argv) {
   return rest.some((tok) => PW_LIST_FLAGS.some((flag) => tok === flag || tok.startsWith(`${flag}=`)));
 }
 
+// src/internal/manifest/collect.ts
+var fs4 = __toESM(require("fs"));
+var path4 = __toESM(require("path"));
+var COMMITTED_MANIFEST_FILE = "piwi.manifest.json";
+var INSTRUMENTATION_MANIFEST_PATH = "/__piwi/manifest";
+var INSTRUMENTATION_HEADERS = ["x-piwi-logs", "x-piwi-trace"];
+function parseManifestJson(text) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object") return null;
+  const obj = parsed;
+  const routes = Array.isArray(obj.routes) ? obj.routes.filter((r) => !!r && typeof r === "object").filter((r) => typeof r.method === "string" && typeof r.pattern === "string").map((r) => ({
+    method: r.method,
+    pattern: r.pattern,
+    handler: typeof r.handler === "string" ? r.handler : void 0,
+    responses: Array.isArray(r.responses) ? r.responses.filter((c) => Number.isInteger(c)) : void 0
+  })) : void 0;
+  const pages = Array.isArray(obj.pages) ? obj.pages.filter((p) => !!p && typeof p === "object").filter((p) => typeof p.pattern === "string").map((p) => ({ pattern: p.pattern, name: typeof p.name === "string" ? p.name : void 0 })) : void 0;
+  if (!routes && !pages) return null;
+  return { routes, pages };
+}
+function hasInstrumentationHeader(headers) {
+  const get = (name) => typeof headers.get === "function" ? headers.get(name) : headers[name];
+  return INSTRUMENTATION_HEADERS.some((h) => get(h) != null && get(h) !== "");
+}
+function readCommittedManifest(configDir) {
+  const file = path4.join(configDir, COMMITTED_MANIFEST_FILE);
+  try {
+    if (!fs4.existsSync(file)) return null;
+    return parseManifestJson(fs4.readFileSync(file, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function configDirFromConfig(config) {
+  if (config?.configFile) return path4.dirname(config.configFile);
+  if (config?.rootDir) return config.rootDir;
+  return process.cwd();
+}
+function baseUrlFromConfig(config) {
+  const top = config?.use?.baseURL;
+  if (typeof top === "string" && top) return top;
+  for (const project of config?.projects ?? []) {
+    const url = project?.use?.baseURL;
+    if (typeof url === "string" && url) return url;
+  }
+  return null;
+}
+var INSTRUMENTATION_FETCH_TIMEOUT_MS = 5e3;
+async function fetchInstrumentationManifest(baseUrl, fetchImpl = fetch) {
+  try {
+    const probe = await fetchImpl(baseUrl, { signal: AbortSignal.timeout(INSTRUMENTATION_FETCH_TIMEOUT_MS) });
+    if (!hasInstrumentationHeader(probe.headers)) return null;
+    const manifestUrl = new URL(INSTRUMENTATION_MANIFEST_PATH, baseUrl).toString();
+    const res = await fetchImpl(manifestUrl, { signal: AbortSignal.timeout(INSTRUMENTATION_FETCH_TIMEOUT_MS) });
+    if (!res.ok) return null;
+    return parseManifestJson(await res.text());
+  } catch {
+    return null;
+  }
+}
+
 // src/public/global-setup.ts
 function createGlobalSetup(options, userSetup) {
   return async function globalSetupFn(config) {
-    const piwiReporterPath = path4.resolve(__dirname, "./index.js");
+    const piwiReporterPath = path5.resolve(__dirname, "./index.js");
     let inlineReporterOptions = {};
     if (Array.isArray(config?.reporter)) {
       for (const r of config.reporter) {
         if (!Array.isArray(r) || typeof r[0] !== "string") continue;
         const isPiwi = r[0].toLowerCase().includes("piwi") || (() => {
           try {
-            return path4.resolve(require.resolve(r[0])) === piwiReporterPath;
+            return path5.resolve(require.resolve(r[0])) === piwiReporterPath;
           } catch {
             return false;
           }
@@ -542,7 +669,7 @@ function createGlobalSetup(options, userSetup) {
       if (!Array.isArray(r) || typeof r[0] !== "string") return false;
       if (r[0].toLowerCase().includes("piwi")) return true;
       try {
-        return path4.resolve(require.resolve(r[0])) === piwiReporterPath;
+        return path5.resolve(require.resolve(r[0])) === piwiReporterPath;
       } catch {
         return false;
       }
@@ -566,6 +693,7 @@ function createGlobalSetup(options, userSetup) {
           projectDescription: opts.projectDescription,
           environment: opts.environment || null,
           label: opts.label || null,
+          keep: opts.keep === true,
           startTime: (/* @__PURE__ */ new Date()).toISOString(),
           instanceId: computeInstanceId(opts.projectName, runLabel),
           shardIndex,
@@ -574,7 +702,7 @@ function createGlobalSetup(options, userSetup) {
         auth
       );
       if (response?.runId && response?.setupToken) {
-        fs4.writeFileSync(
+        fs5.writeFileSync(
           getSetupFilePath(opts.projectName),
           JSON.stringify({
             runId: response.runId,
@@ -585,18 +713,43 @@ function createGlobalSetup(options, userSetup) {
         logger.debug(`Global setup: initializing run #${response.runId}`);
       }
       if (opts.projectName) clearAriaSampleFile(opts.projectName);
-      if (opts.sampleAriaOnPass !== false && opts.projectName) {
+      const wantsAria = opts.sampleAriaOnPass !== false && !!opts.projectName;
+      const committedManifest = opts.uploadManifest !== false ? readCommittedManifest(configDirFromConfig(config)) : null;
+      const manifestBaseUrl = opts.uploadManifest !== false ? baseUrlFromConfig(config) : null;
+      const wantsManifest = opts.uploadManifest !== false && !!opts.projectName && (!!committedManifest || !!manifestBaseUrl);
+      let projectId;
+      if ((wantsAria || wantsManifest) && opts.projectName) {
         const menu = await httpClient.getJSON("/api/projects/menu", auth);
-        const projectId = menu?.items?.find(
+        projectId = menu?.items?.find(
           (p) => p.name.toLowerCase() === opts.projectName.toLowerCase()
         )?.id;
-        if (projectId != null) {
-          const sampling = await httpClient.getJSON(`/api/projects/${projectId}/aria-sampling`, auth);
-          const tests = Array.isArray(sampling?.tests) ? sampling.tests : null;
-          if (tests) {
-            const identities = tests.filter((t) => typeof t.filePath === "string" && typeof t.title === "string").map((t) => ariaSampleIdentity(t.filePath, t.title));
-            writeAriaSampleFile(opts.projectName, identities);
-            logger.debug(`Green ARIA sampling: ${identities.length} test(s) due a sample.`);
+      }
+      if (wantsAria && projectId != null) {
+        const sampling = await httpClient.getJSON(`/api/projects/${projectId}/aria-sampling`, auth);
+        const tests = Array.isArray(sampling?.tests) ? sampling.tests : null;
+        if (tests) {
+          const identities = tests.filter((t) => typeof t.filePath === "string" && typeof t.title === "string").map((t) => ariaSampleIdentity(t.filePath, t.title));
+          writeAriaSampleFile(opts.projectName, identities);
+          logger.debug(`Green ARIA sampling: ${identities.length} test(s) due a sample.`);
+        }
+      }
+      if (wantsManifest && projectId != null) {
+        const branch = resolveScmBranch(process.env) ?? null;
+        if (committedManifest) {
+          await httpClient.putJSON(
+            `/api/projects/${projectId}/surface/manifest`,
+            { source: "committed", branch, manifest: committedManifest },
+            auth
+          ).catch((e) => logger.debug(`Manifest upload (committed) skipped: ${errorMessage(e)}`));
+        }
+        if (manifestBaseUrl) {
+          const declared = await fetchInstrumentationManifest(manifestBaseUrl);
+          if (declared) {
+            await httpClient.putJSON(
+              `/api/projects/${projectId}/surface/manifest`,
+              { source: "instrumentation", branch, manifest: declared },
+              auth
+            ).catch((e) => logger.debug(`Manifest upload (instrumentation) skipped: ${errorMessage(e)}`));
           }
         }
       }