@plune-ai/cli 0.12.0 → 0.14.0

package/dist/cli.cjs

@@ -512,7 +512,7 @@ var init_retry = __esm({
     "use strict";
     init_cjs_shims();
     init_errors2();
-    defaultSleep = (ms) => new Promise((resolve7) => setTimeout(resolve7, ms));
+    defaultSleep = (ms) => new Promise((resolve8) => setTimeout(resolve8, ms));
   }
 });
 
@@ -2159,6 +2159,8 @@ function saveToken(token) {
   return file;
 }
 function loadToken() {
+  const fromEnv = process.env["PLUNE_TOKEN"]?.trim();
+  if (fromEnv !== void 0 && fromEnv !== "") return fromEnv;
   try {
     const parsed = JSON.parse((0, import_node_fs.readFileSync)(credentialsFile(), "utf-8"));
     return typeof parsed.token === "string" && parsed.token.length > 0 ? parsed.token : null;
@@ -2184,6 +2186,35 @@ var init_credentials = __esm({
 });
 
 // src/reporter-core/client.ts
+function nodeTransport(url, init, idleMs = IDLE_MS) {
+  return new Promise((resolve8, reject) => {
+    const target = new URL(url);
+    const send = target.protocol === "https:" ? import_node_https.request : import_node_http.request;
+    const req = send(target, { method: init.method, headers: init.headers }, (res) => {
+      const chunks = [];
+      res.on("data", (chunk2) => chunks.push(chunk2));
+      res.on("error", reject);
+      res.on("end", () => {
+        const status = res.statusCode ?? 0;
+        const text2 = Buffer.concat(chunks).toString("utf8");
+        resolve8({
+          ok: status >= 200 && status <= 299,
+          status,
+          headers: {
+            get: (name) => {
+              const value2 = res.headers[name.toLowerCase()];
+              return value2 === void 0 ? null : Array.isArray(value2) ? value2.join(", ") : value2;
+            }
+          },
+          json: async () => JSON.parse(text2)
+        });
+      });
+    });
+    req.setTimeout(idleMs, () => req.destroy(new Error(`no answer from ${target.origin} in ${idleMs} ms`)));
+    req.on("error", reject);
+    req.end(init.body);
+  });
+}
 async function detailOf(res) {
   try {
     const body = await res.json();
@@ -2206,7 +2237,7 @@ function classify3(status) {
   return "other";
 }
 function createClient(opts) {
-  const doFetch = opts.fetchImpl ?? fetch;
+  const doFetch = opts.fetchImpl ?? nodeTransport;
   const wait = opts.wait ?? sleep;
   const base = opts.apiUrl.replace(/\/+$/, "");
   const scrub = (text2) => opts.token === "" ? text2 : text2.split(opts.token).join("***");
@@ -2251,12 +2282,15 @@ function createClient(opts) {
     del: (path14) => send("DELETE", path14)
   };
 }
-var RETRY_DELAYS_MS, sleep;
+var import_node_http, import_node_https, RETRY_DELAYS_MS, IDLE_MS, sleep;
 var init_client = __esm({
   "src/reporter-core/client.ts"() {
     "use strict";
     init_cjs_shims();
+    import_node_http = require("http");
+    import_node_https = require("https");
     RETRY_DELAYS_MS = [300, 900];
+    IDLE_MS = 3e5;
     sleep = (ms) => new Promise((r) => setTimeout(r, ms));
   }
 });
@@ -2365,6 +2399,23 @@ function boundKey(key) {
 function boundTitle(title) {
   return title.length <= TITLE_MAX ? title : `${title.slice(0, TITLE_MAX - 1)}\u2026`;
 }
+function packed(results) {
+  const out = [];
+  let part = [];
+  let bytes = ENVELOPE_BYTES;
+  for (const result of results) {
+    const size = Buffer.byteLength(JSON.stringify(result));
+    if (part.length > 0 && bytes + 1 + size > BATCH_BYTES) {
+      out.push(part);
+      part = [];
+      bytes = ENVELOPE_BYTES;
+    }
+    bytes += (part.length > 0 ? 1 : 0) + size;
+    part.push(result);
+  }
+  if (part.length > 0) out.push(part);
+  return out;
+}
 function chunk(items, size) {
   const out = [];
   for (let i = 0; i < items.length; i += size) out.push(items.slice(i, i + size));
@@ -2566,27 +2617,32 @@ async function startRun(passed, declared) {
       progress();
       return;
     }
-    const out = await client.post(
-      `/v1/runs/${runId}/results`,
-      { results: submissions }
-    );
-    if (out.ok) {
-      stats.accepted += out.body.counts.accepted ?? 0;
-      stats.duplicate += out.body.counts.duplicate ?? 0;
-      stats.conflict += out.body.counts.conflict ?? 0;
-      stats.rejected += out.body.counts.rejected ?? 0;
-      progress();
-      return;
-    }
-    if (out.kind === "auth") {
-      log('plune: the API token was refused \u2014 run "plune login" with a fresh one.');
-      offline = true;
-    } else if (out.kind === "conflict") {
-      log(`plune: this run is closed \u2014 ${out.detail}`);
-    } else {
-      log(`plune: could not send results (${out.detail || out.kind}).`);
+    for (const part of packed(submissions)) {
+      if (offline) {
+        defer(part);
+        continue;
+      }
+      const out = await client.post(`/v1/runs/${runId}/results`, {
+        results: part
+      });
+      if (out.ok) {
+        stats.accepted += out.body.counts.accepted ?? 0;
+        stats.duplicate += out.body.counts.duplicate ?? 0;
+        stats.conflict += out.body.counts.conflict ?? 0;
+        stats.rejected += out.body.counts.rejected ?? 0;
+        progress();
+        continue;
+      }
+      if (out.kind === "auth") {
+        log('plune: the API token was refused \u2014 run "plune login" with a fresh one.');
+        offline = true;
+      } else if (out.kind === "conflict") {
+        log(`plune: this run is closed \u2014 ${out.detail}`);
+      } else {
+        log(`plune: could not send results (${out.detail || out.kind}).`);
+      }
+      defer(part);
     }
-    defer(submissions);
   }
   function progress() {
     const total = expected?.length ?? 0;
@@ -2602,9 +2658,12 @@ async function startRun(passed, declared) {
     if (stats.unresolved > 0) parts.push(`${stats.unresolved} with no matching test case`);
     if (stats.offered > 0) parts.push(`${stats.offered} offered for review`);
     if (stats.created > 0) parts.push(`${stats.created} added as cases (trusted source)`);
-    if (stats.deferred > 0) parts.push(`${stats.deferred} written to ${fallbackPath}`);
+    if (stats.deferred > 0) parts.push(`${stats.deferred} not delivered \u2014 written to ${fallbackPath}`);
     if (shortened.size > 0) parts.push(`${shortened.size} test name(s) shortened to fit a key`);
     log(`plune: ${parts.join(" \xB7 ")}`);
+    if (stats.deferred > 0 && process.env["GITHUB_ACTIONS"] === "true") {
+      log(`::warning::${stats.deferred} result(s) were not delivered to Plune \u2014 see the reporting step's log.`);
+    }
   }
   return {
     get runId() {
@@ -2650,7 +2709,7 @@ async function startRun(passed, declared) {
     }
   };
 }
-var import_node_crypto2, RESOLVE_CHUNK, BATCH_MAX, DISCOVER_MAX, BATCH_DEFAULT, EXPECTED_MAX, KEY_MAX, TITLE_MAX;
+var import_node_crypto2, RESOLVE_CHUNK, BATCH_MAX, DISCOVER_MAX, BATCH_DEFAULT, EXPECTED_MAX, KEY_MAX, TITLE_MAX, BATCH_BYTES, ENVELOPE_BYTES;
 var init_session = __esm({
   "src/reporter-core/session.ts"() {
     "use strict";
@@ -2668,6 +2727,8 @@ var init_session = __esm({
     EXPECTED_MAX = 1e4;
     KEY_MAX = 1024;
     TITLE_MAX = 300;
+    BATCH_BYTES = 8 * 1024 * 1024;
+    ENVELOPE_BYTES = Buffer.byteLength(JSON.stringify({ results: [] }));
   }
 });
 
@@ -2763,14 +2824,14 @@ async function handleRunExec(options) {
   if (command === void 0) throw new RunCommandError("Nothing to run \u2014 pass a command after `--`.");
   const run = await handleRunStart(options);
   const spawnImpl = options.spawnImpl ?? import_node_child_process.spawn;
-  const code = await new Promise((resolve7) => {
+  const code = await new Promise((resolve8) => {
     const child = spawnImpl(command, args, {
       stdio: "inherit",
       shell: process.platform === "win32",
       env: { ...process.env, PLUNE_RUN: run.externalKey, PLUNE_PROCEED: "1" }
     });
-    child.on("close", (exitCode) => resolve7(exitCode ?? 1));
-    child.on("error", () => resolve7(1));
+    child.on("close", (exitCode) => resolve8(exitCode ?? 1));
+    child.on("error", () => resolve8(1));
   });
   await handleRunFinish(run.id, options);
   return code;
@@ -3102,21 +3163,163 @@ var init_junit = __esm({
   }
 });
 
+// src/reporter-core/failure-detail.ts
+function failureOf(attempt) {
+  const error = chosen(attempt);
+  const headline = error === void 0 ? void 0 : firstLine(error.text);
+  const steps = chainOf(attempt.steps);
+  const location = error === void 0 ? void 0 : fromRoot(placeOf(error, attempt.testFile), attempt.repoRoot);
+  const artifacts = attempt.attachments.filter((a) => a.path !== void 0 && a.name !== "" && !a.name.startsWith("_") && a.contentType !== METADATA_TYPE).map(({ name, contentType }) => contentType === void 0 ? { name } : { name, contentType });
+  const ciUrl = webLink(attempt.buildHref);
+  const failure = {
+    ...headline !== void 0 ? { headline } : {},
+    ...steps.length > 0 ? { steps } : {},
+    ...location !== void 0 ? { location } : {},
+    ...artifacts.length > 0 ? { artifacts } : {},
+    ...ciUrl !== void 0 ? { ciUrl } : {}
+  };
+  return Object.keys(failure).length === 0 ? void 0 : failure;
+}
+function repoRootOf(dir, stopAt) {
+  for (let here = (0, import_node_path2.resolve)(dir); ; here = (0, import_node_path2.dirname)(here)) {
+    if ((0, import_node_fs2.existsSync)((0, import_node_path2.join)(here, ".git"))) return here;
+    if (here === stopAt || (0, import_node_path2.dirname)(here) === here) return void 0;
+  }
+}
+function errorContextOf(attempt, home = (0, import_node_os2.homedir)()) {
+  let text2 = (0, import_node_util.stripVTControlCharacters)(
+    attempt.errors.map((e) => e.text).filter((t) => t !== "").join("\n\n")
+  ).replaceAll("\x1B", "");
+  const root = attempt.repoRoot === void 0 ? void 0 : pathIn(attempt.repoRoot);
+  if (root !== void 0) text2 = text2.replace(new RegExp(`${root.source}[\\\\/]`, root.flags), "");
+  const own = pathIn(home);
+  if (own !== void 0) text2 = text2.replace(new RegExp(`${own.source}(?![\\w.-])`, own.flags), "~");
+  if (attempt.repoRoot === void 0) text2 = text2.replace(ANY_HOME, "~");
+  return cut(text2);
+}
+function pathIn(path14) {
+  const parts = path14.split(/[\\/]+/);
+  while (parts.length > 1 && parts.at(-1) === "") parts.pop();
+  if (!parts.some((part) => part !== "" && !/^[A-Za-z]:$/.test(part))) return void 0;
+  const escaped = parts.map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("[\\\\/]");
+  return new RegExp(`(?:file:\\/\\/\\/?)?${escaped}`, /^[A-Za-z]:$/.test(parts[0]) ? "gi" : "g");
+}
+function cut(text2) {
+  if (Buffer.byteLength(text2) <= TEXT_LIMIT) return text2;
+  const lines = text2.split("\n");
+  const size = lines.map((line) => Buffer.byteLength(line) + 1);
+  const budget = TEXT_LIMIT - Buffer.byteLength(omitted(lines.length));
+  let used = 0;
+  let head = 0;
+  let tail = lines.length;
+  while (head < tail && used + size[head] <= budget / 2) used += size[head++];
+  while (tail > head && used + size[tail - 1] <= budget) used += size[--tail];
+  return [...lines.slice(0, head), omitted(tail - head), ...lines.slice(tail)].join("\n");
+}
+function chosen({ status, errors }) {
+  if (status === "timedOut") {
+    const timeout = errors.findIndex((e) => firstLine(e.text)?.startsWith("Test timeout of ") === true);
+    if (timeout !== -1 && timeout + 1 < errors.length) return errors[timeout + 1];
+  }
+  return errors[0];
+}
+function chainOf(steps) {
+  const chain = [];
+  for (let failed = steps.find((s) => s.failed); failed !== void 0; failed = failed.steps.find((s) => s.failed)) {
+    chain.push(failed.title);
+  }
+  return chain;
+}
+function placeOf(error, testFile) {
+  const own = normal(testFile);
+  let first;
+  for (const line of (0, import_node_util.stripVTControlCharacters)(error.text).split("\n")) {
+    const frame = FRAME.exec(line);
+    if (frame === null) continue;
+    const place = { file: fileOf(frame[1]), line: Number(frame[2]), column: Number(frame[3]) };
+    if (normal(place.file) === own) return place;
+    if (first === void 0 && !normal(place.file).includes("/node_modules/")) first = place;
+  }
+  return error.location ?? first;
+}
+function fileOf(raw) {
+  if (!raw.startsWith("file://")) return raw;
+  const path14 = decodeURIComponent(raw.slice("file://".length));
+  return /^\/[A-Za-z]:\//.test(path14) ? path14.slice(1) : path14;
+}
+function fromRoot(place, root) {
+  if (place === void 0 || root === void 0 || !Number.isInteger(place.line) || place.line < 1) return void 0;
+  const base = normal(root).replace(/\/+$/, "");
+  const file = normal(place.file);
+  if (!file.startsWith(`${base}/`)) return void 0;
+  const relative2 = file.slice(base.length + 1);
+  if (!REPO_RELATIVE.test(relative2)) return void 0;
+  const column = place.column !== void 0 && Number.isInteger(place.column) && place.column >= 1 ? place.column : void 0;
+  return column === void 0 ? { file: relative2, line: place.line } : { file: relative2, line: place.line, column };
+}
+function webLink(href) {
+  if (href === void 0) return void 0;
+  try {
+    const { protocol } = new URL(href);
+    return protocol === "http:" || protocol === "https:" ? href : void 0;
+  } catch {
+    return void 0;
+  }
+}
+var import_node_fs2, import_node_os2, import_node_path2, import_node_util, TEXT_LIMIT, ANY_HOME, omitted, METADATA_TYPE, REPO_RELATIVE, FRAME, firstLine, normal;
+var init_failure_detail = __esm({
+  "src/reporter-core/failure-detail.ts"() {
+    "use strict";
+    init_cjs_shims();
+    import_node_fs2 = require("fs");
+    import_node_os2 = require("os");
+    import_node_path2 = require("path");
+    import_node_util = require("util");
+    TEXT_LIMIT = 524288;
+    ANY_HOME = /(?<=^|[\s'"`(=,[])(?:file:\/\/\/?)?(?:\/home\/|\/Users\/|[A-Za-z]:[\\/]Users[\\/])[^\\/\s'"`:*?<>|]+/g;
+    omitted = (lines) => `\u2026[omitted ${lines} lines]\u2026`;
+    METADATA_TYPE = "application/plune.metadata+json";
+    REPO_RELATIVE = /^(?![A-Za-z][A-Za-z0-9+.-]*:)(?![\\/~])(?!(?:.*[\\/])?\.\.(?:[\\/]|$)).+$/;
+    FRAME = /^\s+at (?:.*? \()?(.+?):(\d+):(\d+)\)?$/;
+    firstLine = (text2) => (0, import_node_util.stripVTControlCharacters)(text2).split("\n").map((line) => line.trim()).find((line) => line !== "");
+    normal = (path14) => import_node_path2.posix.normalize(path14.replace(/\\/g, "/")).replace(/^([a-z]):/, (_, drive) => `${drive.toUpperCase()}:`);
+  }
+});
+
 // src/importers/playwright-json.ts
 function statedIdOf(test, title) {
   const annotation = test.annotations?.find((a) => a.type === "PluneId")?.description;
   if (annotation !== void 0 && annotation !== "") return annotation;
   return TOKEN.exec(title)?.[1];
 }
-function errorTextOf2(result) {
-  return (result.errors ?? []).map((e) => e.stack ?? e.message ?? e.value ?? "").filter((text2) => text2 !== "").join("\n\n");
+function attemptOf(result, file, ctx) {
+  const steps = (list2) => (list2 ?? []).map((s) => ({ title: s.title ?? "", failed: s.error !== void 0, steps: steps(s.steps) }));
+  return {
+    status: result.status ?? "unknown",
+    errors: (result.errors ?? []).map(({ message, value: value2, location: at }) => ({
+      text: message ?? value2 ?? "",
+      ...typeof at?.file === "string" && typeof at.line === "number" ? { location: { file: at.file, line: at.line, ...typeof at.column === "number" ? { column: at.column } : {} } } : {}
+    })),
+    steps: steps(result.steps),
+    attachments: (result.attachments ?? []).map(({ name, contentType, path: path14 }) => ({
+      name: name ?? "",
+      ...contentType !== void 0 ? { contentType } : {},
+      ...path14 !== void 0 ? { path: path14 } : {}
+    })),
+    ...ctx.buildHref !== void 0 ? { buildHref: ctx.buildHref } : {},
+    // Spec files are posix and relative to the root dir; the core reads either slash.
+    testFile: ctx.rootDir === void 0 ? file : `${ctx.rootDir.replace(/[\\/]+$/, "")}/${file}`,
+    ...ctx.repoRoot !== void 0 ? { repoRoot: ctx.repoRoot } : {}
+  };
 }
-function pendingFrom(spec, test, result, file, titles) {
+function pendingFrom(spec, test, result, file, titles, ctx) {
   const pathTitle = [file, ...titles].join("#");
   const seed = test.id ?? pathTitle;
   const stated = statedIdOf(test, spec.title ?? "");
   const expected = test.expectedStatus;
-  const errorContext = errorTextOf2(result);
+  const attempt = attemptOf(result, file, ctx);
+  const errorContext = errorContextOf(attempt);
+  const failure = NOT_FAILED.has(attempt.status) ? void 0 : failureOf(attempt);
   const keys = [
     ...test.id !== void 0 ? [{ kind: "playwright-id", value: test.id }] : [],
     { kind: "path-title", value: pathTitle }
@@ -3144,19 +3347,20 @@ function pendingFrom(spec, test, result, file, titles) {
         ...result.workerIndex !== void 0 ? { worker: String(result.workerIndex) } : {}
       }
     } : {},
-    ...errorContext !== "" ? { errorContext } : {}
+    ...errorContext !== "" ? { errorContext } : {},
+    ...failure !== void 0 ? { failure } : {}
   };
 }
-function walk(suite, describes, depth, out) {
+function walk(suite, describes, depth, ctx, out) {
   const here = depth === 0 ? [] : [...describes, suite.title ?? ""];
   for (const spec of suite.specs ?? []) {
     const file = spec.file ?? suite.file ?? suite.title ?? "";
     const titles = [...here, spec.title ?? ""];
     for (const test of spec.tests ?? []) {
-      for (const result of test.results ?? []) out.push(pendingFrom(spec, test, result, file, titles));
+      for (const result of test.results ?? []) out.push(pendingFrom(spec, test, result, file, titles, ctx));
     }
   }
-  for (const child of suite.suites ?? []) walk(child, here, depth + 1, out);
+  for (const child of suite.suites ?? []) walk(child, here, depth + 1, ctx, out);
 }
 function readPlaywrightJson(source, file) {
   let parsed;
@@ -3168,22 +3372,34 @@ function readPlaywrightJson(source, file) {
   if (typeof parsed !== "object" || parsed === null || !Array.isArray(parsed.suites)) {
     throw new JsonReportError(file, 'no "suites" array \u2014 is this a Playwright JSON report?');
   }
+  const { config, suites } = parsed;
+  const rootDir = typeof config?.rootDir === "string" ? config.rootDir : void 0;
+  const buildHref = config?.metadata?.ci?.buildHref;
+  const repoRoot = rootDir !== void 0 && (0, import_node_fs3.existsSync)(rootDir) ? repoRootOf(rootDir) : void 0;
+  const ctx = {
+    ...rootDir !== void 0 ? { rootDir } : {},
+    ...repoRoot !== void 0 ? { repoRoot } : {},
+    ...typeof buildHref === "string" ? { buildHref } : {}
+  };
   const out = [];
-  for (const suite of parsed.suites) walk(suite, [], 0, out);
-  return out;
+  for (const suite of suites) walk(suite, [], 0, ctx, out);
+  const ciUrl = webLink(ctx.buildHref);
+  return ciUrl === void 0 ? { results: out } : { results: out, ciUrl };
 }
 function looksLikePlaywrightJson(source) {
-  const head = source.slice(0, 4096);
-  return head.trimStart().startsWith("{") && head.includes('"suites"');
+  return /^\s*\{/.test(source) && source.includes('"suites"');
 }
-var SOURCE2, TOKEN, JsonReportError;
+var import_node_fs3, SOURCE2, TOKEN, NOT_FAILED, JsonReportError;
 var init_playwright_json = __esm({
   "src/importers/playwright-json.ts"() {
     "use strict";
     init_cjs_shims();
+    import_node_fs3 = require("fs");
+    init_failure_detail();
     init_result_key();
     SOURCE2 = "playwright";
     TOKEN = /@P([A-Za-z0-9_-]+)/;
+    NOT_FAILED = /* @__PURE__ */ new Set(["passed", "skipped"]);
     JsonReportError = class extends Error {
       constructor(file, detail) {
         super(`${file} \u2014 ${detail}`);
@@ -3214,11 +3430,9 @@ function detectFormat(source, file) {
   );
 }
 function readReport(source, file, format) {
-  const chosen = format ?? detectFormat(source, file);
-  return {
-    format: chosen,
-    results: chosen === "junit" ? readJUnit(source, file) : readPlaywrightJson(source, file)
-  };
+  const chosen2 = format ?? detectFormat(source, file);
+  if (chosen2 === "junit") return { format: chosen2, results: readJUnit(source, file) };
+  return { format: chosen2, ...readPlaywrightJson(source, file) };
 }
 var IMPORT_FORMATS, UnknownFormatError;
 var init_importers = __esm({
@@ -3253,7 +3467,7 @@ async function handleRunImport(options) {
   } catch {
     throw new RunCommandError(`Cannot read ${options.file}.`);
   }
-  const { format, results } = readReport(source, options.file, options.format);
+  const { format, results, ciUrl } = readReport(source, options.file, options.format);
   if (results.length === 0) {
     throw new RunCommandError(`No test cases in ${options.file} \u2014 it parsed, but there is nothing in it.`);
   }
@@ -3269,7 +3483,8 @@ async function handleRunImport(options) {
       ...options.key !== void 0 ? { externalKey: options.key } : {},
       ...options.create === true ? { offerDiscovered: true } : {},
       kind: "automated",
-      meta: { runner: format },
+      // The CI run the report names, never this machine's: whoever imports may be another job (#790).
+      meta: { runner: format, ...ciUrl !== void 0 ? { ciUrl } : {} },
       log: write
     },
     // The file is the complete list of what ran, so the platform can resolve every test in one
@@ -3310,7 +3525,9 @@ function describe(result, apiUrl) {
     // «Imported 555 result(s): 0 accepted, 0 already there, 0 unmatched» was a sentence whose two
     // halves disagreed, and readers stop at the verb — a run that reached nobody read as one that
     // worked (#622).
-    `Read ${result.parsed} result(s) from a ${result.format} report: ${result.accepted} accepted, ${result.duplicate} already there, ${result.unresolved} unmatched.`
+    // `not delivered` always, zero included (#790): a number that only appears when it is bad is one
+    // nobody learns to look for. The `[0-9]+ unmatched` the workflows read stays whole.
+    `Read ${result.parsed} result(s) from a ${result.format} report: ${result.accepted} accepted, ${result.duplicate} already there, ${result.unresolved} unmatched, ${result.deferred} not delivered.`
   ];
   if (result.conflict > 0 || result.rejected > 0) {
     lines.push(`${result.conflict} conflicted and ${result.rejected} were refused.`);
@@ -4029,7 +4246,7 @@ var init_sync = __esm({
     init_credentials();
     NotLoggedInError = class extends Error {
       constructor() {
-        super('Not logged in. Run "plune login" first to save your API token.');
+        super('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.');
         this.name = "NotLoggedInError";
       }
     };
@@ -4306,7 +4523,7 @@ var init_ingest = __esm({
     init_cairn_artifact();
     IngestNotLoggedInError = class extends Error {
       constructor() {
-        super('Not logged in. Run "plune login" first to save your API token.');
+        super('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.');
         this.name = "IngestNotLoggedInError";
       }
     };
@@ -4472,6 +4689,68 @@ var init_cases = __esm({
   }
 });
 
+// src/cli/commands/plan.ts
+var plan_exports = {};
+__export(plan_exports, {
+  formatGrep: () => formatGrep,
+  grepFragment: () => grepFragment,
+  handlePlanGrep: () => handlePlanGrep
+});
+function grepFragment(c) {
+  const pathTitle = c.externalKeys.find((k) => k.kind === "path-title")?.value;
+  const segments = pathTitle?.split("#") ?? [c.title];
+  return (segments.length > 1 ? segments.slice(1) : segments).flatMap((s) => s.split(/ [>›] /)).map(escape).join(BOUNDARY);
+}
+function formatGrep(cases) {
+  if (cases.length === 0) return "(?!)";
+  return cases.map(grepFragment).join("|");
+}
+async function safeErrorDetail4(res) {
+  try {
+    const body = await res.json();
+    return typeof body.error === "string" ? body.error : "";
+  } catch {
+    return "";
+  }
+}
+async function handlePlanGrep(deps) {
+  const apiUrl = resolveApiUrl(deps.apiUrl);
+  const token = (deps.loadToken ?? loadToken)();
+  if (token === null) throw new NotLoggedInError();
+  const doFetch = deps.fetchImpl ?? fetch;
+  let res;
+  try {
+    res = await doFetch(`${apiUrl}/v1/plans/${encodeURIComponent(deps.planId)}/cases`, {
+      headers: { authorization: `Bearer ${token}` }
+    });
+  } catch {
+    throw new SyncNetworkError(apiUrl);
+  }
+  if (!res.ok) {
+    const detail = await safeErrorDetail4(res);
+    if (res.status === 401) throw new TokenRejectedError2();
+    throw new SyncHttpError(res.status, detail);
+  }
+  const { cases } = await res.json();
+  return {
+    pattern: formatGrep(cases),
+    cases: cases.length,
+    keyed: cases.filter((c) => c.externalKeys.some((k) => k.kind === "path-title")).length
+  };
+}
+var escape, BOUNDARY;
+var init_plan = __esm({
+  "src/cli/commands/plan.ts"() {
+    "use strict";
+    init_cjs_shims();
+    init_api_url();
+    init_credentials();
+    init_sync();
+    escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    BOUNDARY = "[ >#]+";
+  }
+});
+
 // src/cli.ts
 var cli_exports = {};
 __export(cli_exports, {
@@ -4481,11 +4760,11 @@ module.exports = __toCommonJS(cli_exports);
 init_cjs_shims();
 init_api_url();
 var import_commander = require("commander");
-var import_node_fs2 = require("fs");
-var import_node_path2 = require("path");
+var import_node_fs4 = require("fs");
+var import_node_path3 = require("path");
 var import_node_url = require("url");
-var __dirname = (0, import_node_path2.dirname)((0, import_node_url.fileURLToPath)(importMetaUrl));
-var pkg = JSON.parse((0, import_node_fs2.readFileSync)((0, import_node_path2.join)(__dirname, "..", "package.json"), "utf-8"));
+var __dirname = (0, import_node_path3.dirname)((0, import_node_url.fileURLToPath)(importMetaUrl));
+var pkg = JSON.parse((0, import_node_fs4.readFileSync)((0, import_node_path3.join)(__dirname, "..", "package.json"), "utf-8"));
 function toFormat(s) {
   return s === "json" || s === "markdown" ? s : "console";
 }
@@ -4494,7 +4773,7 @@ function shouldColor(outputPath) {
 }
 function writeReport(text2, outputPath) {
   if (outputPath !== void 0) {
-    (0, import_node_fs2.writeFileSync)(outputPath, text2);
+    (0, import_node_fs4.writeFileSync)(outputPath, text2);
   } else {
     process.stdout.write(text2 + "\n");
   }
@@ -4560,7 +4839,7 @@ function createProgram() {
         Promise.resolve().then(() => (init_errors(), errors_exports)),
         Promise.resolve().then(() => (init_errors2(), errors_exports2))
       ]);
-      loadEnv2(configPath !== void 0 ? (0, import_node_path2.dirname)((0, import_node_path2.resolve)(configPath)) : process.cwd());
+      loadEnv2(configPath !== void 0 ? (0, import_node_path3.dirname)((0, import_node_path3.resolve)(configPath)) : process.cwd());
       try {
         const result = await handleRun2({
           dryRun: options.dryRun,
@@ -4691,7 +4970,8 @@ function createProgram() {
         Promise.resolve().then(() => (init_run_import(), run_import_exports)),
         Promise.resolve().then(() => (init_importers(), importers_exports))
       ]);
-      const format = options.format;
+      const run = command.parent;
+      const format = options.format ?? (run?.getOptionValueSource("format") === "cli" ? run.opts().format : void 0);
       if (format !== void 0 && !IMPORT_FORMATS2.includes(format)) {
         process.stderr.write(
           `Unknown --format "${format}". Use ${IMPORT_FORMATS2.join(" or ")}.
@@ -4724,7 +5004,7 @@ function createProgram() {
       Promise.resolve().then(() => (init_report(), report_exports)),
       Promise.resolve().then(() => (init_reporters(), reporters_exports))
     ]);
-    const cwd = globals.config !== void 0 ? (0, import_node_path2.dirname)((0, import_node_path2.resolve)(globals.config)) : process.cwd();
+    const cwd = globals.config !== void 0 ? (0, import_node_path3.dirname)((0, import_node_path3.resolve)(globals.config)) : process.cwd();
     loadEnv2(cwd);
     try {
       const result = handleReport2({ cwd });
@@ -4822,7 +5102,7 @@ function createProgram() {
     const globals = command.optsWithGlobals();
     const verbose = globals.verbose === true;
     const { handleSync: handleSync2, reportSyncFailure: reportSyncFailure2 } = await Promise.resolve().then(() => (init_sync(), sync_exports));
-    const cwd = globals.config !== void 0 ? (0, import_node_path2.dirname)((0, import_node_path2.resolve)(globals.config)) : process.cwd();
+    const cwd = globals.config !== void 0 ? (0, import_node_path3.dirname)((0, import_node_path3.resolve)(globals.config)) : process.cwd();
     try {
       const { id, url } = await handleSync2({
         cwd,
@@ -4905,6 +5185,30 @@ function createProgram() {
       failUnexpected(err, verbose);
     }
   });
+  const planCommand = program.command("plan").description("Test plans on the platform \u2014 what a plan collects, as something a runner can take");
+  planCommand.command("grep").argument("<id>", "The plan").description(
+    "Print the plan's cases as one --grep pattern for the runner (GET /v1/plans/:id/cases)"
+  ).action(async (id, _options, command) => {
+    const verbose = command.optsWithGlobals().verbose === true;
+    const { handlePlanGrep: handlePlanGrep2 } = await Promise.resolve().then(() => (init_plan(), plan_exports));
+    const { reportCasesFailure: reportCasesFailure2 } = await Promise.resolve().then(() => (init_cases(), cases_exports));
+    try {
+      const out = await handlePlanGrep2({ planId: id });
+      process.stdout.write(out.pattern + "\n");
+      process.stderr.write(
+        out.cases === 0 ? "plune: the plan matches no case \u2014 the pattern matches nothing.\n" : `plune: ${out.cases} case(s) in the plan, ${out.keyed} with a test key; the rest by title.
+`
+      );
+    } catch (err) {
+      const code = reportCasesFailure2(err, (s) => process.stderr.write(s));
+      if (code !== null) {
+        maybeStack(err, verbose);
+        process.exitCode = code;
+        return;
+      }
+      failUnexpected(err, verbose);
+    }
+  });
   program.on("command:*", (operands) => {
     process.stderr.write(`Unknown command: ${operands.join(" ")}
 `);
@@ -4916,7 +5220,7 @@ function isMainModule() {
   const entry = process.argv[1];
   if (entry === void 0) return false;
   try {
-    return (0, import_node_fs2.realpathSync)(entry) === (0, import_node_fs2.realpathSync)((0, import_node_url.fileURLToPath)(importMetaUrl));
+    return (0, import_node_fs4.realpathSync)(entry) === (0, import_node_fs4.realpathSync)((0, import_node_url.fileURLToPath)(importMetaUrl));
   } catch {
     return false;
   }