@plune-ai/cli 0.17.1 → 0.19.0

package/dist/cli.cjs

@@ -1621,6 +1621,76 @@ var init_concurrency = __esm({
   }
 });
 
+// src/types/test-case-schema.ts
+var import_zod2, TEST_CASE_SCHEMA_VERSION, externalKeySchema, manualStepSchema, assertionResultRecordSchema, manualCaseSchema, automatedCaseSchema, evalCaseSchema, testCaseBaseSchema, testCaseSchema;
+var init_test_case_schema = __esm({
+  "src/types/test-case-schema.ts"() {
+    "use strict";
+    init_cjs_shims();
+    import_zod2 = require("zod");
+    TEST_CASE_SCHEMA_VERSION = 2;
+    externalKeySchema = import_zod2.z.object({
+      kind: import_zod2.z.enum(["playwright-id", "path-title", "allure-history", "cairn-stable", "eval-id", "qase", "testrail"]),
+      value: import_zod2.z.string().min(1)
+    });
+    manualStepSchema = import_zod2.z.object({
+      action: import_zod2.z.string().min(1),
+      expected: import_zod2.z.string().min(1).optional()
+    });
+    assertionResultRecordSchema = import_zod2.z.object({
+      type: import_zod2.z.string().min(1),
+      passed: import_zod2.z.boolean(),
+      score: import_zod2.z.number().optional(),
+      reason: import_zod2.z.string().optional()
+    });
+    manualCaseSchema = import_zod2.z.object({
+      type: import_zod2.z.literal("manual"),
+      steps: import_zod2.z.array(manualStepSchema).min(1),
+      expected: import_zod2.z.string().min(1).optional()
+    });
+    automatedCaseSchema = import_zod2.z.object({
+      type: import_zod2.z.literal("automated"),
+      specRef: import_zod2.z.string().min(1)
+    });
+    evalCaseSchema = import_zod2.z.object({
+      type: import_zod2.z.literal("eval"),
+      prompt: import_zod2.z.string().min(1),
+      goldenSetId: import_zod2.z.string().min(1).optional(),
+      assertions: import_zod2.z.array(assertionResultRecordSchema).min(1)
+    });
+    testCaseBaseSchema = import_zod2.z.object({
+      schemaVersion: import_zod2.z.literal(TEST_CASE_SCHEMA_VERSION),
+      id: import_zod2.z.string().min(1),
+      externalKeys: import_zod2.z.array(externalKeySchema).optional(),
+      /** ADR 0045 / plune#1246 — optional, purely additive; schemaVersion stays 2. */
+      is_flaky: import_zod2.z.boolean().optional(),
+      /** ADR 0045 / plune#1246 — optional, purely additive; schemaVersion stays 2. */
+      is_muted: import_zod2.z.boolean().optional()
+    });
+    testCaseSchema = import_zod2.z.discriminatedUnion("type", [
+      testCaseBaseSchema.merge(manualCaseSchema),
+      testCaseBaseSchema.merge(automatedCaseSchema),
+      testCaseBaseSchema.merge(evalCaseSchema)
+    ]);
+  }
+});
+
+// src/types/results.ts
+function rowStatus(row) {
+  if (row.inconclusive !== void 0) return row.inconclusive;
+  if (row.error !== void 0) return "errored";
+  return row.assertions.every((a) => a.passed) ? "passed" : "failed";
+}
+var ROW_INCONCLUSIVE;
+var init_results = __esm({
+  "src/types/results.ts"() {
+    "use strict";
+    init_cjs_shims();
+    init_test_case_schema();
+    ROW_INCONCLUSIVE = ["blocked", "skipped"];
+  }
+});
+
 // src/orchestrator/run.ts
 function resolvePrompt(template, vars) {
   return template.replace(/\{\{\s*(\w+)\s*\}\}/g, (_match, key) => {
@@ -1754,10 +1824,25 @@ function resolveTemplate(ev, baseDir) {
   }
   throw new RunConfigError(`Eval "${ev.id}" has neither prompt nor prompt_file`);
 }
-function classify(row) {
-  if (row.error !== void 0) return "errored";
-  if (row.assertions.some((a) => !a.passed)) return "failed";
-  return "passed";
+function summarize(evals, durationMs) {
+  const summary = {
+    total: 0,
+    passed: 0,
+    failed: 0,
+    errored: 0,
+    blocked: 0,
+    skipped: 0,
+    cost_usd: 0,
+    duration_ms: durationMs
+  };
+  for (const ev of evals) {
+    for (const row of ev.rows) {
+      summary.total += 1;
+      summary[rowStatus(row)] += 1;
+      summary.cost_usd += row.usage?.cost_usd ?? 0;
+    }
+  }
+  return summary;
 }
 async function runOrchestration(config, options, deps) {
   const started = deps.now();
@@ -1792,26 +1877,12 @@ async function runOrchestration(config, options, deps) {
         noCache
       })
     );
-    const passed = rowResults.every((r) => classify(r) === "passed");
+    const passed = rowResults.every((r) => rowStatus(r) === "passed");
     evalResults.push({ id: ev.id, tags: ev.tags ?? [], rows: rowResults, passed });
     if (options.bail === true && !passed) break;
   }
   const finished = deps.now();
-  const summary = {
-    total: 0,
-    passed: 0,
-    failed: 0,
-    errored: 0,
-    cost_usd: 0,
-    duration_ms: finished - started
-  };
-  for (const ev of evalResults) {
-    for (const row of ev.rows) {
-      summary.total += 1;
-      summary[classify(row)] += 1;
-      summary.cost_usd += row.usage?.cost_usd ?? 0;
-    }
-  }
+  const summary = summarize(evalResults, finished - started);
   return {
     schemaVersion: 1,
     plune_version: PLUNE_VERSION,
@@ -1834,6 +1905,7 @@ var init_run = __esm({
     init_judge();
     init_concurrency();
     init_errors2();
+    init_results();
     DEFAULT_MAX_TOKENS2 = 1024;
     PLUNE_VERSION = "0.1.0";
     RunConfigError = class extends Error {
@@ -2027,8 +2099,10 @@ function renderConsole(result, opts = {}) {
   const passedTxt = s.green(`${summary.passed} passed`);
   const failedTxt = summary.failed > 0 ? s.red(`${summary.failed} failed`) : `${summary.failed} failed`;
   const erroredTxt = summary.errored > 0 ? s.yellow(`${summary.errored} errored`) : `${summary.errored} errored`;
+  const blockedTxt = (summary.blocked ?? 0) > 0 ? ` \xB7 ${s.yellow(`${summary.blocked} blocked`)}` : "";
+  const skippedTxt = (summary.skipped ?? 0) > 0 ? ` \xB7 ${s.dim(`${summary.skipped} skipped`)}` : "";
   lines.push(
-    `${passedTxt} \xB7 ${failedTxt} \xB7 ${erroredTxt} \xB7 ${summary.total} total \xB7 $${summary.cost_usd.toFixed(4)} \xB7 ${summary.duration_ms}ms`
+    `${passedTxt} \xB7 ${failedTxt} \xB7 ${erroredTxt}${blockedTxt}${skippedTxt} \xB7 ${summary.total} total \xB7 $${summary.cost_usd.toFixed(4)} \xB7 ${summary.duration_ms}ms`
   );
   lines.push("");
   for (const ev of result.evals) {
@@ -2037,17 +2111,21 @@ function renderConsole(result, opts = {}) {
     lines.push(`${mark} ${s.bold(ev.id)}${tags}`);
     let passedCount = 0;
     for (const row of ev.rows) {
+      const status = rowStatus(row);
+      if (status === "passed") {
+        passedCount += 1;
+        continue;
+      }
+      lines.push(`  ${s.dim("vars:")} ${JSON.stringify(row.vars)}`);
+      if (status === "blocked" || status === "skipped") {
+        lines.push(`  ${s.yellow(status)} (not judged)`);
+        continue;
+      }
       if (row.error !== void 0) {
-        lines.push(`  ${s.dim("vars:")} ${JSON.stringify(row.vars)}`);
         lines.push(`  ${s.red("error:")} ${row.error.message}`);
         continue;
       }
       const failed = row.assertions.filter((a) => !a.passed);
-      if (failed.length === 0) {
-        passedCount += 1;
-        continue;
-      }
-      lines.push(`  ${s.dim("vars:")} ${JSON.stringify(row.vars)}`);
       if (row.output !== null) {
         lines.push(`  ${s.dim("output:")} ${truncate(row.output, maxOut)}`);
       }
@@ -2068,6 +2146,7 @@ var init_console = __esm({
   "src/reporters/console.ts"() {
     "use strict";
     init_cjs_shims();
+    init_results();
     init_style();
     init_helpers();
     DEFAULT_MAX_OUTPUT = 500;
@@ -2086,11 +2165,6 @@ var init_json = __esm({
 });
 
 // src/reporters/markdown.ts
-function classify2(row) {
-  if (row.error !== void 0) return "errored";
-  if (row.assertions.some((a) => !a.passed)) return "failed";
-  return "passed";
-}
 function fence(content) {
   const runs = content.match(new RegExp(TICK + "+", "g"));
   const longest = runs ? runs.reduce((m, r) => Math.max(m, r.length), 0) : 0;
@@ -2111,18 +2185,22 @@ function renderMarkdown(result, opts = {}) {
   out.push(`| Passed | ${summary.passed} |`);
   out.push(`| Failed | ${summary.failed} |`);
   out.push(`| Errored | ${summary.errored} |`);
+  if ((summary.blocked ?? 0) > 0) out.push(`| Blocked | ${summary.blocked} |`);
+  if ((summary.skipped ?? 0) > 0) out.push(`| Skipped | ${summary.skipped} |`);
   out.push(`| Cost (USD) | ${summary.cost_usd.toFixed(4)} |`);
   out.push(`| Duration (ms) | ${summary.duration_ms} |`);
   out.push("");
   const failures = [];
+  let allPassed = true;
   for (const ev of result.evals) {
     for (const row of ev.rows) {
-      const state = classify2(row);
-      if (state !== "passed") failures.push({ id: ev.id, row, state });
+      const state = rowStatus(row);
+      if (state !== "passed") allPassed = false;
+      if (state === "failed" || state === "errored") failures.push({ id: ev.id, row, state });
     }
   }
   if (failures.length === 0) {
-    out.push("All evals passed.");
+    if (allPassed) out.push("All evals passed.");
     return out.join("\n");
   }
   out.push("## Failures");
@@ -2153,6 +2231,7 @@ var init_markdown = __esm({
   "src/reporters/markdown.ts"() {
     "use strict";
     init_cjs_shims();
+    init_results();
     init_helpers();
     DEFAULT_MAX_OUTPUT2 = 500;
     TICK = String.fromCharCode(96);
@@ -2298,7 +2377,7 @@ function retryAfterMs2(res) {
   const seconds = Number(raw.trim());
   return Number.isFinite(seconds) && seconds >= 0 ? seconds * 1e3 : null;
 }
-function classify3(status) {
+function classify(status) {
   if (status === 401 || status === 403) return "auth";
   if (status === 409) return "conflict";
   if (status === 400) return "invalid";
@@ -2341,13 +2420,13 @@ function createClient(opts) {
         }
       }
       const said = await detailOf(res);
-      const kind = classify3(res.status);
+      const kind = classify(res.status);
       last = { kind, status: res.status, detail: scrub(said.detail), ...said.code !== void 0 ? { code: said.code } : {} };
       if (kind !== "unavailable") break;
       if (res.status === 429 && retryAfterMs2(res) === null) {
         last.kind = "invalid";
         last.detail = "quota exceeded (no Retry-After)";
-        if (said.detail) last.detail += ` \u2014 ${said.detail}`;
+        if (said.detail) last.detail += ` \u2014 ${scrub(said.detail)}`;
         break;
       }
       if (attempt < RETRY_DELAYS_MS.length) {
@@ -3227,21 +3306,26 @@ async function startRun(passed, declared2) {
     },
     flush,
     async finish(reason) {
-      if (done) return;
+      if (done) return void 0;
       done = true;
       await flush();
       await offer();
+      let frozen;
       if (runId !== null && !offline) {
         const out = await client.post(`/v1/runs/${runId}/events`, {
           event: "finish",
           ...reason !== void 0 ? { reason } : {}
         });
         if (!out.ok) log(`plune: could not close run ${runId} (${out.detail || out.kind}).`);
-        else if (typeof out.body?.detached === "number" && out.body.detached > 0) {
-          log(`plune: ${out.body.detached} test case(s) marked detached \u2014 this full run no longer reports them.`);
+        else {
+          frozen = out.body?.summary ?? void 0;
+          if (typeof out.body?.detached === "number" && out.body.detached > 0) {
+            log(`plune: ${out.body.detached} test case(s) marked detached \u2014 this full run no longer reports them.`);
+          }
         }
       }
       summarise();
+      return frozen;
     },
     async leaveOpen() {
       if (done) return;
@@ -3319,6 +3403,28 @@ var init_session = __esm({
   }
 });
 
+// src/cli/gate.ts
+function gateExit(verdict, runnerCode) {
+  if (verdict?.statusEvent === "terminated") {
+    return { code: 1, line: "plune: gate failed \u2014 the run was terminated, so it has no verdict to pass on." };
+  }
+  const counts = verdict?.counts;
+  if (counts == null) return { code: 1, line: "plune: gate failed \u2014 no verdict from the platform, and no verdict is no pass." };
+  const n = (status) => counts[status] ?? 0;
+  const notRun = verdict?.notRun?.length ?? 0;
+  if (runnerCode !== void 0 && notRun === 0 && Object.values(counts).every((k) => !k)) {
+    return { code: runnerCode, line: `plune: gate \u2014 no result reached the run, so the exit code is the command's own (${runnerCode}).` };
+  }
+  const said = `${n("failed")} failed \xB7 ${n("broken")} broken \xB7 ${notRun} not run \xB7 ${n("muted")} muted`;
+  return n("failed") + n("broken") > 0 || notRun > 0 ? { code: 1, line: `plune: gate failed \u2014 ${said}` } : { code: 0, line: `plune: gate passed \u2014 ${said}` };
+}
+var init_gate = __esm({
+  "src/cli/gate.ts"() {
+    "use strict";
+    init_cjs_shims();
+  }
+});
+
 // src/cli/commands/run-lifecycle.ts
 var run_lifecycle_exports = {};
 __export(run_lifecycle_exports, {
@@ -3376,7 +3482,7 @@ async function handleRunStart(options = {}) {
   }
   return result;
 }
-async function handleRunFinish(id, options = {}) {
+async function handleRunFinish(id, options = {}, runnerCode) {
   const { client, write } = connect(options);
   const event = options.terminate === true ? "terminate" : "finish";
   const out = await client.post(`/v1/runs/${id}/events`, {
@@ -3389,6 +3495,11 @@ async function handleRunFinish(id, options = {}) {
     );
   }
   write(`Run ${id} ${event === "finish" ? "finished" : "terminated"}.`);
+  if (options.failOnFailures !== true) return runnerCode ?? 0;
+  const summary = out.body?.summary;
+  const gate = gateExit({ statusEvent: out.body?.run?.statusEvent, counts: summary?.counts, notRun: summary?.notRun }, runnerCode);
+  write(gate.line);
+  return gate.code;
 }
 async function handleRunDelete(id, options = {}) {
   const { client, write } = connect(options);
@@ -3404,7 +3515,7 @@ async function handleRunDelete(id, options = {}) {
     );
   }
   write(`Run ${id} deleted, with its results and the review-queue entries it produced.`);
-  write("Recoverable for 30 days \u2014 ask Plune to put it back.");
+  write("Recoverable for 30 days \u2014 an owner of the project can put it back from Settings \u2192 Bin.");
 }
 async function handleRunExec(options) {
   const [command, ...args] = options.argv;
@@ -3420,8 +3531,7 @@ async function handleRunExec(options) {
     child.on("close", (exitCode) => resolve9(exitCode ?? 1));
     child.on("error", () => resolve9(1));
   });
-  await handleRunFinish(run.id, options);
-  return code;
+  return handleRunFinish(run.id, options, code);
 }
 async function handleRunReport(options = {}) {
   const file = options.file ?? DEFAULT_FALLBACK_PATH;
@@ -3517,6 +3627,7 @@ var init_run_lifecycle = __esm({
     init_env2();
     init_fallback();
     init_session();
+    init_gate();
     NoTokenError = class extends Error {
       constructor() {
         super('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.');
@@ -4390,8 +4501,9 @@ async function handleRunImport(options) {
     results.map((r) => r.keys)
   );
   for (const result2 of results) await session.add(result2);
+  let frozen;
   if (env.keepOpen) await session.leaveOpen();
-  else await session.finish();
+  else frozen = await session.finish();
   const stats = session.stats;
   const result = {
     runId: session.runId,
@@ -4420,6 +4532,14 @@ async function handleRunImport(options) {
     offering: options.create === true
   };
   for (const line of describe(result, apiUrl)) write(line);
+  if (options.failOnFailures === true) {
+    if (env.keepOpen) {
+      write("plune: the run is left open for the jobs still reporting, so there is no verdict yet \u2014 gate on the step that finishes it.");
+    }
+    const gate = gateExit(frozen);
+    write(gate.line);
+    result.gate = gate.code;
+  }
   return result;
 }
 function runUrl2(apiUrl, id) {
@@ -4486,6 +4606,7 @@ var init_run_import = __esm({
     init_run_lifecycle();
     init_api_url();
     init_credentials();
+    init_gate();
     init_env2();
     NEXT = {
       queue: "the review queue is full. Approve or reject what is waiting, then import this report again to offer the rest.",
@@ -4544,18 +4665,13 @@ var init_report = __esm({
 });
 
 // src/diff/diff.ts
-function rowStatus(r) {
-  if (r.error !== void 0) return "errored";
-  if (r.assertions.some((a) => !a.passed)) return "failed";
-  return "passed";
-}
 function evalStatus(e) {
   const statuses = e.rows.map(rowStatus);
   if (statuses.includes("failed")) return "failed";
   if (statuses.includes("errored")) return "errored";
   return "passed";
 }
-function classify4(baseline, current) {
+function classify2(baseline, current) {
   if (current === "errored") return "errored";
   if (baseline === "absent") return current === "passed" ? "new-pass" : "new-fail";
   if (current === "absent") return "removed";
@@ -4569,7 +4685,7 @@ function diffRuns(baseline, current) {
   const evals = ids.map((id) => {
     const baselineP = baseMap.get(id) ?? "absent";
     const currentP = curMap.get(id) ?? "absent";
-    return { id, status: classify4(baselineP, currentP), baseline: baselineP, current: currentP };
+    return { id, status: classify2(baselineP, currentP), baseline: baselineP, current: currentP };
   });
   const count2 = (s) => evals.filter((e) => e.status === s).length;
   const summary = {
@@ -4589,6 +4705,7 @@ var init_diff = __esm({
   "src/diff/diff.ts"() {
     "use strict";
     init_cjs_shims();
+    init_results();
   }
 });
 
@@ -5007,71 +5124,6 @@ var init_logout = __esm({
   }
 });
 
-// src/types/test-case-schema.ts
-var import_zod2, TEST_CASE_SCHEMA_VERSION, externalKeySchema, manualStepSchema, assertionResultRecordSchema, manualCaseSchema, automatedCaseSchema, evalCaseSchema, testCaseBaseSchema, testCaseSchema;
-var init_test_case_schema = __esm({
-  "src/types/test-case-schema.ts"() {
-    "use strict";
-    init_cjs_shims();
-    import_zod2 = require("zod");
-    TEST_CASE_SCHEMA_VERSION = 2;
-    externalKeySchema = import_zod2.z.object({
-      kind: import_zod2.z.enum(["playwright-id", "path-title", "allure-history", "cairn-stable", "eval-id", "qase", "testrail"]),
-      value: import_zod2.z.string().min(1)
-    });
-    manualStepSchema = import_zod2.z.object({
-      action: import_zod2.z.string().min(1),
-      expected: import_zod2.z.string().min(1).optional()
-    });
-    assertionResultRecordSchema = import_zod2.z.object({
-      type: import_zod2.z.string().min(1),
-      passed: import_zod2.z.boolean(),
-      score: import_zod2.z.number().optional(),
-      reason: import_zod2.z.string().optional()
-    });
-    manualCaseSchema = import_zod2.z.object({
-      type: import_zod2.z.literal("manual"),
-      steps: import_zod2.z.array(manualStepSchema).min(1),
-      expected: import_zod2.z.string().min(1).optional()
-    });
-    automatedCaseSchema = import_zod2.z.object({
-      type: import_zod2.z.literal("automated"),
-      specRef: import_zod2.z.string().min(1)
-    });
-    evalCaseSchema = import_zod2.z.object({
-      type: import_zod2.z.literal("eval"),
-      prompt: import_zod2.z.string().min(1),
-      goldenSetId: import_zod2.z.string().min(1).optional(),
-      assertions: import_zod2.z.array(assertionResultRecordSchema).min(1)
-    });
-    testCaseBaseSchema = import_zod2.z.object({
-      schemaVersion: import_zod2.z.literal(TEST_CASE_SCHEMA_VERSION),
-      id: import_zod2.z.string().min(1),
-      externalKeys: import_zod2.z.array(externalKeySchema).optional(),
-      /** ADR 0045 / plune#1246 — optional, purely additive; schemaVersion stays 2. */
-      is_flaky: import_zod2.z.boolean().optional(),
-      /** ADR 0045 / plune#1246 — optional, purely additive; schemaVersion stays 2. */
-      is_muted: import_zod2.z.boolean().optional()
-    });
-    testCaseSchema = import_zod2.z.discriminatedUnion("type", [
-      testCaseBaseSchema.merge(manualCaseSchema),
-      testCaseBaseSchema.merge(automatedCaseSchema),
-      testCaseBaseSchema.merge(evalCaseSchema)
-    ]);
-  }
-});
-
-// src/types/results.ts
-var ROW_INCONCLUSIVE;
-var init_results = __esm({
-  "src/types/results.ts"() {
-    "use strict";
-    init_cjs_shims();
-    init_test_case_schema();
-    ROW_INCONCLUSIVE = ["blocked", "skipped"];
-  }
-});
-
 // src/types/run-result-schema.ts
 function parseRunResult(value2) {
   return runResultSchema.parse(value2);
@@ -5120,6 +5172,9 @@ var init_run_result_schema = __esm({
       passed: import_zod3.z.number(),
       failed: import_zod3.z.number(),
       errored: import_zod3.z.number(),
+      /** plune#1245. Optional and additive — a RunResult written before them validates unchanged. */
+      blocked: import_zod3.z.number().optional(),
+      skipped: import_zod3.z.number().optional(),
       cost_usd: import_zod3.z.number(),
       duration_ms: import_zod3.z.number()
     });
@@ -5207,7 +5262,18 @@ async function handleSync(deps = {}) {
   }
   const body = await res.json().catch(() => ({}));
   const id = typeof body.id === "string" ? body.id : "";
-  return { id, url: `${endpoint}/${id}` };
+  const result = { id, url: `${endpoint}/${id}` };
+  if (deps.failOnFailures === true) result.gate = gateExit(await readVerdict(doFetch, `${endpoint}/${id}/summary`, token));
+  return result;
+}
+async function readVerdict(doFetch, url, token) {
+  try {
+    const res = await doFetch(url, { method: "GET", headers: { authorization: `Bearer ${token}` } });
+    const body = await res.json().catch(() => void 0);
+    return res.ok ? { statusEvent: body?.run?.statusEvent, counts: body?.counts, notRun: body?.notRun } : void 0;
+  } catch {
+    return void 0;
+  }
 }
 function reportSyncFailure(err, write) {
   if (err instanceof NotLoggedInError || err instanceof TokenRejectedError2 || err instanceof SyncFileError) {
@@ -5230,6 +5296,7 @@ var init_sync = __esm({
     init_run_result_schema();
     init_api_url();
     init_credentials();
+    init_gate();
     NotLoggedInError = class extends Error {
       constructor() {
         super('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.');
@@ -5894,6 +5961,7 @@ function createProgram() {
     process.exit(1);
   };
   const verboseOf = (command) => command.optsWithGlobals().verbose === true;
+  const FAIL_ON_FAILURES = "Exit with the platform's verdict on the run: 1 on a failed or broken result (muted ones do not count), on an expected case that never ran, or when there is no verdict at all";
   runCommand.command("start").description("Open a platform run (or join one already carrying the key) and print its id").option("--key <externalKey>", "The key several processes share; generated when absent").option("--json", "Print one machine-readable line instead of prose", false).action(async (options, command) => {
     try {
       const { handleRunStart: handleRunStart2 } = await Promise.resolve().then(() => (init_run_lifecycle(), run_lifecycle_exports));
@@ -5905,14 +5973,16 @@ function createProgram() {
       await failRunCommand(err, verboseOf(command));
     }
   });
-  runCommand.command("finish").argument("<id>", "The run to close").description("Close a platform run \u2014 what the reporter tells you to do for a run left open").option("--terminate", "Record the run as cut short rather than finished", false).option("--reason <text>", "Why, for a terminated run").action(
+  runCommand.command("finish").argument("<id>", "The run to close").description("Close a platform run \u2014 what the reporter tells you to do for a run left open").option("--terminate", "Record the run as cut short rather than finished", false).option("--reason <text>", "Why, for a terminated run").option("--fail-on-failures", FAIL_ON_FAILURES, false).action(
     async (id, options, command) => {
       try {
         const { handleRunFinish: handleRunFinish2 } = await Promise.resolve().then(() => (init_run_lifecycle(), run_lifecycle_exports));
-        await handleRunFinish2(id, {
+        const code = await handleRunFinish2(id, {
           terminate: options.terminate,
-          ...options.reason !== void 0 ? { reason: options.reason } : {}
+          ...options.reason !== void 0 ? { reason: options.reason } : {},
+          ...options.failOnFailures ? { failOnFailures: true } : {}
         });
+        if (options.failOnFailures) process.exitCode = code;
       } catch (err) {
         await failRunCommand(err, verboseOf(command));
       }
@@ -5920,12 +5990,13 @@ function createProgram() {
   );
   runCommand.command("exec").argument("<command...>", "The command to run inside the run, after `--`").description(
     "Open a run, run a command inside it, close the run \u2014 whatever the command returns"
-  ).option("--key <externalKey>", "The key several processes share; generated when absent").action(async (argv, options, command) => {
+  ).option("--key <externalKey>", "The key several processes share; generated when absent").option("--fail-on-failures", `${FAIL_ON_FAILURES}; the command's own exit code when no result reached the run`, false).action(async (argv, options, command) => {
     try {
       const { handleRunExec: handleRunExec2 } = await Promise.resolve().then(() => (init_run_lifecycle(), run_lifecycle_exports));
       process.exitCode = await handleRunExec2({
         argv,
-        ...options.key !== void 0 ? { key: options.key } : {}
+        ...options.key !== void 0 ? { key: options.key } : {},
+        ...options.failOnFailures ? { failOnFailures: true } : {}
       });
     } catch (err) {
       await failRunCommand(err, verboseOf(command));
@@ -5934,7 +6005,7 @@ function createProgram() {
   runCommand.command("delete").argument(
     "<id>",
     "The run id \u2014 the one `plune run import` printed, or the one in the dashboard URL"
-  ).description("Delete a run and everything it produced \u2014 recoverable for six months").action(async (id, _options, command) => {
+  ).description("Delete a run and everything it produced \u2014 recoverable for 30 days").action(async (id, _options, command) => {
     try {
       const { handleRunDelete: handleRunDelete2 } = await Promise.resolve().then(() => (init_run_lifecycle(), run_lifecycle_exports));
       await handleRunDelete2(id);
@@ -5954,7 +6025,7 @@ function createProgram() {
     "--fail-on-missing-attachments",
     "Exit 1 when a file the report names ([[ATTACHMENT|path]] in JUnit, a source in allure-results) is not there; the results are sent either way",
     false
-  ).action(
+  ).option("--fail-on-failures", FAIL_ON_FAILURES, false).action(
     async (file, options, command) => {
       const [
         { handleRunImport: handleRunImport2 },
@@ -5978,9 +6049,11 @@ function createProgram() {
           file,
           ...format !== void 0 ? { format } : {},
           ...options.key !== void 0 ? { key: options.key } : {},
-          ...options.create ? { create: true } : {}
+          ...options.create ? { create: true } : {},
+          ...options.failOnFailures ? { failOnFailures: true } : {}
         });
         if (options.failOnMissingAttachments && imported.missingAttachments.length > 0) process.exitCode = 1;
+        if (imported.gate === 1) process.exitCode = 1;
       } catch (err) {
         if (err instanceof UnknownFormatError2 || err instanceof XmlParseError2 || err instanceof JsonReportError2 || err instanceof AllureReportError2) {
           process.stderr.write(err.message + "\n");
@@ -6090,18 +6163,24 @@ function createProgram() {
       failUnexpected(err, verbose);
     }
   });
-  program.command("sync").description("Upload your latest local run to the Plune platform (POST /v1/runs)").option("--file <path>", "Sync a specific run JSON instead of .plune/last-run.json").action(async (options, command) => {
+  program.command("sync").description("Upload your latest local run to the Plune platform (POST /v1/runs)").option("--file <path>", "Sync a specific run JSON instead of .plune/last-run.json").option("--fail-on-failures", `${FAIL_ON_FAILURES}; read with one GET of the run's summary after the upload`, false).action(async (options, command) => {
     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_path4.dirname)((0, import_node_path4.resolve)(globals.config)) : process.cwd();
     try {
-      const { id, url } = await handleSync2({
+      const { id, url, gate } = await handleSync2({
         cwd,
-        ...options.file !== void 0 ? { file: options.file } : {}
+        ...options.file !== void 0 ? { file: options.file } : {},
+        ...options.failOnFailures ? { failOnFailures: true } : {}
       });
       process.stdout.write(`Synced run ${id} \u2192 ${url}
 `);
+      if (gate !== void 0) {
+        process.stdout.write(`${gate.line}
+`);
+        process.exitCode = gate.code;
+      }
     } catch (err) {
       const code = reportSyncFailure2(err, (s) => process.stderr.write(s));
       if (code !== null) {