@keepsnappy/agent 0.1.0-alpha.16 → 0.1.0-alpha.17

package/dist/keepsnappy.js

@@ -212,6 +212,15 @@ class ConfigError extends Error {
     this.name = "ConfigError";
   }
 }
+
+class UsageError extends ConfigError {
+  constructor(lines) {
+    super(lines);
+    this.message = lines.join(`
+`);
+    this.name = "UsageError";
+  }
+}
 var TITLE_MAX = 200;
 var DESCRIPTION_MAX = 2000;
 var TOP = ["project", "app", "platform", "device", "repetitions", "flows", "steps", "output", "timeout_seconds"];
@@ -5171,7 +5180,7 @@ async function call(f, base, path, headers, body, method = "POST") {
   try {
     return text ? JSON.parse(text) : {};
   } catch {
-    return {};
+    throw new UploadError(`${method} ${path} -> ${res.status}, the answer is not JSON (is the URL the KeepSnappy API?): ${text.slice(0, 200)}`);
   }
 }
 async function uploadRuns(deps, outDir, runs, opts) {
@@ -5276,6 +5285,7 @@ var STATE_WORDS = {
 var INFO_WORDS = { heat: "Phone heated up" };
 var isWorseState = (state) => state === "worse";
 var NOT_BLOCKING = "not blocking";
+var badgedWord = (word, blocking) => word === STATE_WORDS.worse && blocking === false ? `${word} (${NOT_BLOCKING})` : word;
 
 // packages/present/dist/src/values.js
 var NO_VALUE = "–";
@@ -5348,6 +5358,39 @@ var JOURNEY_ROW_WORDS = {
   notInRun: upperFirst(GONE_TAILS.journey.notInRun),
   removed: upperFirst(GONE_TAILS.journey.removed)
 };
+var NEW_IN_PR_CHIP = "New in this PR";
+var placeNamesChangedTitle = (sdk) => `Place names changed with SDK ${sdk}`;
+var restartRowText = (sdk, mainSessions, needed) => `${placeNamesChangedTitle(sdk)}: ${restartContextText(mainSessions, needed)}`;
+var restartContextText = (mainSessions, needed) => `main has ${mainSessions} of ${needed} sessions on the new names`;
+function removedRowsText(n, page) {
+  return { lead: `${plural(n, "component", "components")} ${GONE_TAILS[page].removed}:`, rest: " not counted." };
+}
+function notInRunRowsText(c, page) {
+  const what = [c.screens ? plural(c.screens, "screen", "screens") : "", c.places ? `${c.places} ${c.places === 1 ? "tap or scroll" : "taps and scrolls"}` : ""].filter(Boolean).join(" and ");
+  const them = c.screens + c.places === 1 ? "it" : "them";
+  return { lead: `${what} ${GONE_TAILS[page].notInRun}:`, rest: ` the ${page === "journey" ? "newest session" : "journey"} did not reach ${them}; not counted.` };
+}
+var OUTSIDE_APP_NAME = "Outside app components";
+var OTHER_RENDER_WORK_NAME = "Other render work";
+var plural = (n, one, many) => `${n} ${n === 1 ? one : many}`;
+var rolledUpText = (rolledUpMs, totalMs) => `From libraries: ${valueText("self_ms", rolledUpMs)} of ${valueText("self_ms", totalMs)}`;
+var libraryLineText = (l) => `${l.name} · ${l.renders} rendered · ${valueText("self_ms", l.ms)}`;
+var rolledUpRestText = (rest) => `${plural(rest.n, "other library", "other libraries")} · ${valueText("self_ms", rest.ms)}`;
+var measureWords = (measure) => isMeasureId(measure) ? MEASURES[measure].label : `component ${BREAKDOWN_MEASURES[measure].label}`;
+var TIER_STATE = { worse: "worse", slight: "warning", better: "better", same: "no-change" };
+function leadBody(subject, measure, main, pr) {
+  const unit = shownUnit(isMeasureId(measure) ? MEASURES[measure].unit : BREAKDOWN_MEASURES[measure].unit).unit;
+  const to = valueText(measure, pr);
+  const from = valueText(measure, main);
+  const bare = unit && from.endsWith(` ${unit}`) && to.endsWith(` ${unit}`) ? from.slice(0, from.length - unit.length - 1) : from;
+  return `${subject}, ${measureWords(measure)} ${bare} → ${to}`;
+}
+var screenLeadText = (tier, subject, measure, main, pr) => `${STATE_WORDS[TIER_STATE[tier]]}: ${leadBody(subject, measure, main, pr)}`;
+var FOR_INFORMATION = "For information";
+var informationLeadText = (subject, measure, main, pr) => `${FOR_INFORMATION}: ${leadBody(subject, measure, main, pr)}`;
+function foldedText(n, rows, page) {
+  return `${n} ${GONE_TAILS[page][rows === "components" ? "removed" : "notInRun"]}`;
+}
 function placeShownName(p, o = {}) {
   const target = p.target ? componentShownName(p.target.name, p.target.file) : libraryViewName(p.kind, p.host ?? "");
   const named = p.target && p.parent ? `${target} in ${componentShownName(p.parent.name, p.parent.file)}${p.k ? `, ${ordinal(p.k)}` : ""}` : target;
@@ -5355,7 +5398,7 @@ function placeShownName(p, o = {}) {
 }
 var libraryViewName = (kind, hostType) => `${kind === "drag" ? "Scroll" : "Tap"} outside app components (${hostType})`;
 function componentShownName(name, file) {
-  if (name !== "default")
+  if (name !== "default" || !file)
     return name;
   const path = file.replace(/\.[^.\/]+$/, "");
   const route = /^(?:src\/)?app\/(.*)$/.exec(path)?.[1];
@@ -5394,7 +5437,20 @@ var BACKGROUND_SOURCES = {
   touch: "work of a tap outside its window",
   input: "work of typing outside its window"
 };
+var OPEN_WORDS = { first: "first time", repeat: "again" };
 var OPEN_MARK = /#(1|repeat)$/;
+var isInputKind = (kind) => kind === "press" || kind === "drag";
+function placeOpen(id) {
+  const ref = placeRef(id);
+  if (!isInputKind(ref.kind))
+    return null;
+  const m = OPEN_MARK.exec(ref.stem);
+  return m ? m[1] === "repeat" ? "repeat" : "first" : null;
+}
+var placeOpenWord = (id) => {
+  const open = placeOpen(id);
+  return open ? OPEN_WORDS[open] : null;
+};
 function placeIdShownName(id, o = {}) {
   const p = placeParts(id);
   if (!p)
@@ -5438,6 +5494,14 @@ function placeKindWord(id) {
   const { kind } = placeRef(id);
   return kind === "other" ? "Window" : KIND_WORD[kind];
 }
+function windowQualified(id) {
+  const word = placeOpenWord(id);
+  const label = placeLabel(id);
+  if (!word)
+    return label;
+  const after = placeRef(id).segment === "after3s" ? ` · ${PLACE_KIND_WORDS.after3s}` : "";
+  return `${after ? label.slice(0, -after.length) : label} (${word})${after}`;
+}
 var ELEMENT_SEPARATORS = /(?<!\d)\.|\.(?!\d)|[_-]+/g;
 var elementWords = (testId) => testId.replace(ELEMENT_SEPARATORS, " ").replace(/\s+/g, " ").trim();
 function placeLabel(id, screen) {
@@ -5456,27 +5520,33 @@ function placeLabel(id, screen) {
   const colon = name.indexOf(": ");
   return `${colon > 0 && ref.kind !== "other" ? `${name.slice(0, colon)} · ${name.slice(colon + 2)}` : name}${after}`;
 }
-// packages/present/dist/src/words.js
-var REASON_WORDS = {
-  "no-baseline": "there are no main runs on this phone and journey yet",
-  "too-few-runs": "there are too few valid runs on a side",
-  "judged-measures-missing": "the judged measures are missing on a side",
-  "measured-differently": "the sides were measured differently",
-  "runs-unknown": "a change that would count has no value in some runs, so it cannot be confirmed in every run",
-  "facts-version-mismatch": "the sides were derived with different versions",
-  "not-judged-on-simulators": "timing is not judged on simulators",
-  "platforms-differ": "the sides ran on different platforms (iOS and Android are never compared)",
-  "not-enough-main": "main does not have enough sessions on this phone and journey yet"
-};
-var waitingWords = (runs) => `${runs} main ${runs === 1 ? "run waits" : "runs wait"} for a reprocess`;
+// packages/present/dist/src/placeNames.js
+function shortestPaths(files) {
+  const out = new Map;
+  for (const file of files) {
+    const parts = file.split("/");
+    let shown = file;
+    for (let k = 1;k <= parts.length; k++) {
+      const tail = parts.slice(-k).join("/");
+      if (!files.some((f) => f !== file && f.split("/").slice(-k).join("/") === tail)) {
+        shown = tail;
+        break;
+      }
+    }
+    out.set(file, shown);
+  }
+  return out;
+}
 // packages/present/dist/src/stability.js
 var UNSTABLE_WORDS = {
   short: "main varies too much here",
   label: `${STATE_WORDS["cant-tell"]} · main varies too much here`,
   line: "Main varies too much here to tell",
   ratioTip: "1.0 = main’s run-to-run noise alone would pass the warning step about once in 100 comparisons.",
+  note: "This place varies a lot between runs. Worth checking why: it may be in the code.",
   what: "Main’s own runs vary too much here to tell, so a comparison there would mostly measure noise. It is shown with its values, never judged, never blocks and is never counted. It is judged again once main settles."
 };
+
 // packages/present/dist/src/present.js
 var ASPECT_WORDS = {
   renderer: "React renderer",
@@ -5493,6 +5563,127 @@ var ASPECT_WORDS = {
   endGc: "memory clean-up at the journey end",
   cpuProfiling: "CPU profiling"
 };
+var measuredDifferentlyText = (aspects) => `measured differently (${aspects.map((a) => ASPECT_WORDS[a] ?? a).join(", ")})`;
+
+// packages/present/dist/src/readWords.js
+function componentReadName(c) {
+  const ref = (c.key ? parseComponentKey(c.key) : null) ?? parseComponentKey(c.name);
+  return componentShownName(ref?.name ?? c.name, c.file ?? ref?.file ?? "");
+}
+function componentReadNames(cs) {
+  const names = cs.map(componentReadName);
+  const rawNames = cs.map((c) => (c.key ? parseComponentKey(c.key)?.name : undefined) ?? parseComponentKey(c.name)?.name ?? c.name);
+  return cs.map((c, i) => {
+    const equals = cs.filter((_, k) => rawNames[k] === rawNames[i]);
+    const file = c.file ?? (c.key ? parseComponentKey(c.key)?.file : undefined);
+    const files = equals.flatMap((x) => x.file ?? (x.key ? parseComponentKey(x.key)?.file ?? [] : []));
+    return new Set(files).size > 1 && file ? `${names[i]} · ${shortestPaths(files).get(file)}` : names[i];
+  });
+}
+function storedRefWords(ref, peers = []) {
+  if (!ref.startsWith("b:component:"))
+    return ref;
+  const cut = ref.lastIndexOf(":");
+  const key = ref.slice("b:component:".length, cut);
+  const components = [ref, ...peers].filter((r) => r.startsWith("b:component:")).map((r) => {
+    const componentKey = r.slice("b:component:".length, r.lastIndexOf(":"));
+    return { key: componentKey, name: componentKey };
+  });
+  const name = componentReadNames(components)[0] ?? componentReadName({ key, name: key });
+  return `${name}, ${measureWords(ref.slice(cut + 1))}`;
+}
+function resultContextLines(c, verbose = false, short = false) {
+  if (!c)
+    return [];
+  const out = [];
+  if (c.namesChanged)
+    out.push(restartRowText(c.namesChanged.sdk, c.namesChanged.mainSessions, c.namesChanged.needed));
+  for (const w of c.windows) {
+    const shownPlace = `${windowQualified(w.place)}${verbose ? ` (${w.place})` : ""}`;
+    if (w.slowestCommit)
+      out.push(`${shownPlace}: ${MEASURES.commit_max_ms.label}: ${valueText("commit_max_ms", w.slowestCommit.main)} → ${valueText("commit_max_ms", w.slowestCommit.pr)}`);
+    if (!w.cause)
+      continue;
+    const s = w.cause.subject;
+    const subject = s.kind === "component" ? `${componentShownName(s.ref.name, s.ref.file)}${verbose ? ` (${s.ref.file})` : ""}` : placeShownName({ kind: placeParts(s.place)?.kind === "drag" ? "drag" : "press", target: s.target, parent: s.parent, k: s.k, ...s.host ? { host: s.host } : {} });
+    out.push(`${shownPlace}: ${w.information || !w.tier ? informationLeadText(subject, w.cause.measure, w.cause.main, w.cause.pr) : screenLeadText(w.tier, subject, w.cause.measure, w.cause.main, w.cause.pr)}${w.cause.measuredDifferently?.length ? `; ${measuredDifferentlyText(w.cause.measuredDifferently)}` : ""}`);
+  }
+  const screens = new Map;
+  for (const p of c.notInThisRun) {
+    const parts = placeParts(p.place);
+    const key = parts ? componentShownName(parts.screen.name, parts.screen.file ?? "") : "";
+    screens.set(key, [...screens.get(key) ?? [], p]);
+  }
+  for (const [screen, rows] of screens) {
+    const line = notInRunRowsText({ screens: rows.filter((p) => p.kind === "screen").length, places: rows.filter((p) => p.kind !== "screen").length }, c.page);
+    out.push(`${screen ? `${screen}: ` : ""}${line.lead}${line.rest}`);
+    if (rows.length > 3)
+      out.push(`  ${foldedText(rows.length, "places", c.page)}`);
+    if (!short || rows.length <= 3)
+      out.push(...rows.map((p) => `  ${windowQualified(p.place)}`));
+  }
+  const removed = new Map;
+  for (const r of c.removed)
+    removed.set(r.place, [...removed.get(r.place) ?? [], r]);
+  for (const [place, rows] of removed) {
+    const line = removedRowsText(rows.length, c.page);
+    out.push(`${windowQualified(place)}: ${line.lead}${line.rest}`);
+    if (rows.length > 3)
+      out.push(`  ${foldedText(rows.length, "components", c.page)}`);
+    if (!short || rows.length <= 3)
+      out.push(...rows.map((r) => `  ${r.ref.kind === "breakdown" ? componentReadName({ key: r.ref.key, name: r.ref.name }) : measureWords(r.ref.measure)}`));
+  }
+  return out;
+}
+function laneContextLines(context, journey, phone, verbose = false, short = false) {
+  const lines = resultContextLines(context, verbose, short);
+  return lines.length ? [`${journey} on ${phone}:`, ...lines.map((line) => `  ${line}`)] : [];
+}
+var exactComponentMs = (ms) => `${ms} ms`;
+var componentPageText = (page, count) => `Component rows: ${count ? `${page.offset + 1}–${page.offset + count}` : "0"} of ${page.total} stored${page.next_offset !== null ? `; next --page ${Math.floor(page.next_offset / page.limit) + 1} (MCP component_offset ${page.next_offset})` : ""}.`;
+var omissionText = (o) => `${o.run_id}: SDK omitted ${o.sdkOmitted ?? "unknown"}; Derivation left out ${o.omitted ?? "unknown"}${o.selfMs === null ? "" : ` · ${exactComponentMs(o.selfMs)}`}. Paging leaves recorded omissions unchanged.`;
+var READ_WORDS = {
+  componentTime: "component render time",
+  ownTime: "own time",
+  detailUnavailable: "Only render time recorded; renders, parent and library detail unavailable.",
+  parent: "Placed by",
+  slowest: MEASURES.commit_max_ms.label,
+  runA: "Run A",
+  runB: "Run B",
+  notMeasured: "Not measured",
+  onlyA: "Only in run A",
+  onlyB: "Only in run B"
+};
+var READ_USAGE = {
+  listFindings: `What got ${STATE_WORDS.worse.toLowerCase()} (${STATE_WORDS.worse} / ${STATE_WORDS.warning}) or ${STATE_WORDS.better.toLowerCase()} in the app, worst first, as KeepSnappy measured it on real phones. The answer starts with whether and when the branch was measured and how its newest run set read: an empty list on a branch that was never measured, or whose newest run set was not judged, is not a clean result. Filter by a PR branch or main, journey, phone, and state (present by default; not-judged = the newest run set did not judge it, so it may still be there). Each finding says what changed, where, how sure, and has an id for get_finding. Page with offset.`,
+  components: "  --page N | --all  (places or compare: a component page, or every stored component and place; --top-components sets the bounded page size)",
+  verbose: "  --verbose        (include source files and raw identities in text; JSON is unchanged)",
+  page: "--page must be a whole number from 1; use it only with places or compare.",
+  all: "--all is for places or compare; do not combine it with --page, --offset or --short.",
+  detailFlag: "  --detail         (places: include recorded run detail; also included by --verbose or component paging)",
+  detail: "Include recorded per-run component and window detail.",
+  compareTop: "--top-components must be a whole number from 1 to 200 for compare.",
+  top: "--top-components must be a whole number from 0 to 20, or from 1 to 200 with --page or --all.",
+  paging: "The API did not advance the component page; stopped without claiming the list is complete.",
+  componentOffset: "Skip this many stored components per place.",
+  componentLimit: "Component page size; the response gives stored totals and next offsets."
+};
+var componentListsText = (totals, shown) => `Stored component rows: ${shown.rows} of ${totals.rows} compared; ${shown.added} of ${totals.added} ${READ_WORDS.onlyB.toLowerCase()}; ${shown.removed} of ${totals.removed} ${READ_WORDS.onlyA.toLowerCase()}.`;
+var notMeasuredText = (side) => `${READ_WORDS.notMeasured} in run ${side.toUpperCase()}`;
+
+// packages/present/dist/src/words.js
+var REASON_WORDS = {
+  "no-baseline": "there are no main runs on this phone and journey yet",
+  "too-few-runs": "there are too few valid runs on a side",
+  "judged-measures-missing": "the judged measures are missing on a side",
+  "measured-differently": "the sides were measured differently",
+  "runs-unknown": "a change that would count has no value in some runs, so it cannot be confirmed in every run",
+  "facts-version-mismatch": "the sides were derived with different versions",
+  "not-judged-on-simulators": "timing is not judged on simulators",
+  "platforms-differ": "the sides ran on different platforms (iOS and Android are never compared)",
+  "not-enough-main": "main does not have enough sessions on this phone and journey yet"
+};
+var waitingWords = (runs) => `${runs} main ${runs === 1 ? "run waits" : "runs wait"} for a reprocess`;
 // packages/present/dist/src/main-history.js
 var MAIN_TIER_WORDS = {
   same: "In norm",
@@ -5501,6 +5692,13 @@ var MAIN_TIER_WORDS = {
   slight: STATE_WORDS.warning,
   worse: STATE_WORDS.worse
 };
+var MAIN_TIER_RESULT_WORDS = {
+  same: STATE_WORDS["no-change"],
+  better: STATE_WORDS.better,
+  cant: STATE_WORDS["cant-tell"],
+  slight: STATE_WORDS.warning,
+  worse: STATE_WORDS.worse
+};
 var MAIN_TIER_RANK = { worse: 0, slight: 1, cant: 2, better: 3, same: 4 };
 function mainCantWords(reason, config) {
   if (!reason)
@@ -5526,7 +5724,6 @@ function mainPlaceReasonWords(reason, config) {
   }
 }
 var MAIN_SUMMARY_PENDING = "Runs received; the summary is not computed yet.";
-var MAIN_NEWEST_SUMMARY_PENDING = `Newest: ${MAIN_SUMMARY_PENDING}`;
 var SHORT_ASPECT_WORDS = {
   ...ASPECT_WORDS,
   sdk: "SDK",
@@ -5563,6 +5760,7 @@ function mainCutWords(v) {
   }
   return parts.length ? parts.join(" ") : "Measures alike; no baseline cut.";
 }
+var BY_RANK = Object.keys(MAIN_TIER_RANK).sort((a, b) => MAIN_TIER_RANK[a] - MAIN_TIER_RANK[b]);
 // apps/agent/src/summary.ts
 var fieldWord = (field) => measureDef(field)?.short ?? field;
 function plainMetric(metric) {
@@ -5654,10 +5852,16 @@ var setupLine = (h) => {
 var keyHeader = (t) => ({ "x-keepsnappy-key": t.key });
 async function createRunSet(t, body) {
   const r = await call(t.fetch ?? fetch, t.url, "/v1/run-sets", keyHeader(t), body);
-  return { run_set_id: String(r.run_set_id), dashboard_url: String(r.dashboard_url) };
+  if (typeof r.run_set_id !== "string" || !r.run_set_id)
+    throw new UploadError("POST /v1/run-sets: response has no run_set_id (is the URL the KeepSnappy API?)");
+  return { run_set_id: r.run_set_id, dashboard_url: String(r.dashboard_url ?? "") };
 }
 async function completeRunSet(t, id, verdicts) {
-  return await call(t.fetch ?? fetch, t.url, `/v1/run-sets/${encodeURIComponent(id)}/complete`, keyHeader(t), { verdicts });
+  const path = `/v1/run-sets/${encodeURIComponent(id)}/complete`;
+  const r = await call(t.fetch ?? fetch, t.url, path, keyHeader(t), { verdicts });
+  if (!r.run_set_id)
+    throw new UploadError(`POST ${path}: response has no run_set_id`);
+  return r;
 }
 async function createIngestRun(t, body) {
   const r = await call(t.fetch ?? fetch, t.url, "/v1/runs", keyHeader(t), body);
@@ -5672,13 +5876,20 @@ async function finishIngestRun(t, runId, invalidReason, farmSession) {
   });
 }
 async function getRunSetRuns(t, id) {
-  return await call(t.fetch ?? fetch, t.url, `/v1/run-sets/${encodeURIComponent(id)}/runs`, keyHeader(t), undefined, "GET");
+  const path = `/v1/run-sets/${encodeURIComponent(id)}/runs`;
+  const r = await call(t.fetch ?? fetch, t.url, path, keyHeader(t), undefined, "GET");
+  if (!Array.isArray(r.runs))
+    throw new UploadError(`GET ${path}: response has no runs`);
+  return r;
 }
 var FEW_RUNS = "Few runs — result may be noisy";
-var word = (s, server, h) => {
-  const w = server || stateWord(s ?? "inconclusive");
-  return h?.blocking === false && h.measured_differently?.length && (w === STATE_WORDS.worse || s === "worse") ? `${w} (${NOT_BLOCKING})` : w;
-};
+var word = (s, server, blocking) => badgedWord(server || stateWord(s ?? "inconclusive"), blocking);
+var setWord = (v) => word(v?.state ?? null, v?.word, v?.blocking ?? v?.headline?.blocking);
+var scenarioWord = (sc) => word(sc.state, sc.word, sc.headline?.blocking);
+var notComputed = (s) => !s.verdicts || s.verdicts.state === null && !s.verdicts.blocking;
+var resultWord = (s) => setWord(s.verdicts);
+var UNCHECKED_GATE = "Verdict not computed yet (computed on demand): --fail-on-worse checked nothing";
+var uncheckedGate = (s) => notComputed(s) ? UNCHECKED_GATE : null;
 var countsLine = (c) => countsWords(c);
 var noCounts = (c) => !c.worse && !c.warnings && !c.better && !c.noChange && !c.inconclusive;
 var change = (metric, a, b) => {
@@ -5691,7 +5902,7 @@ function formatRunSet(s, top = 5) {
   const lines = [];
   const where = `${s.branch}${s.commit_sha ? ` @ ${s.commit_sha.slice(0, 7)}` : ""}`;
   const v = s.verdicts;
-  lines.push(`KeepSnappy result for ${where}: ${word(v?.state ?? null, v?.word, v?.headline)}`);
+  lines.push(`KeepSnappy result for ${where}: ${setWord(v)}`);
   if (setupLine(v?.headline))
     lines.push(`  ${setupLine(v?.headline)}`);
   if (v?.low_data)
@@ -5705,13 +5916,14 @@ function formatRunSet(s, top = 5) {
     const dev = sc.device ? `${sc.device.model}${sc.device.os ? ` (${sc.device.os})` : ""}` : "no device";
     const what = sc.role === "comparison" ? "compared with the baseline branch" : sc.role === "history" ? "latest runs compared with earlier ones" : "not judged (no branch or flow name)";
     lines.push("");
-    lines.push(`${sc.scenario ?? "(no flow name)"} on ${dev}, ${what}: ${word(sc.state, sc.word, sc.headline)}`);
+    lines.push(`${sc.scenario ?? "(no flow name)"} on ${dev}, ${what}: ${scenarioWord(sc)}`);
     if (setupLine(sc.headline) && (v?.scenarios.length ?? 0) > 1)
       lines.push(`  ${setupLine(sc.headline)}`);
     if (sc.low_data && (v?.scenarios.length ?? 0) > 1)
       lines.push(`  ${FEW_RUNS}`);
     if (sc.role !== "adhoc" && !noCounts(movedCounts(sc)))
       lines.push(`  ${countsLine(movedCounts(sc))}`);
+    lines.push(...resultContextLines(sc.context).map((line) => `  ${line}`));
     if (heatNote(sc))
       lines.push(`  ${heatNote(sc)}`);
     const allMoved = movedItems(v, sc).sort((a, b) => Number(b.state === "worse") - Number(a.state === "worse") || Number(a.grade === "warn") - Number(b.grade === "warn"));
@@ -5743,12 +5955,13 @@ Runs uploaded for \`${fallback.branch}\`. The result appears on the dashboard: [
   }
   const v = s.verdicts;
   const heated = v.scenarios.flatMap((sc) => heatNote(sc) ?? []);
+  const contextLines = v.scenarios.flatMap((sc) => laneContextLines(sc.context, sc.scenario ?? "-", sc.device?.model ?? "-"));
   const rows = v.scenarios.map((sc) => {
     const c = movedCounts(sc);
-    return `| ${sc.scenario ?? "-"} | ${sc.device ? sc.device.model : "-"} | ${word(sc.state, sc.word, sc.headline)}${sc.low_data ? ` (${FEW_RUNS})` : ""} | ${noCounts(c) ? "–" : `${c.worse} / ${c.warnings} / ${c.better} / ${c.noChange} / ${c.inconclusive}`} | ${sc.dashboard_url ? `[open](${sc.dashboard_url})` : "-"} |`;
+    return `| ${sc.scenario ?? "-"} | ${sc.device ? sc.device.model : "-"} | ${scenarioWord(sc)}${sc.low_data ? ` (${FEW_RUNS})` : ""} | ${noCounts(c) ? "–" : `${c.worse} / ${c.warnings} / ${c.better} / ${c.noChange} / ${c.inconclusive}`} | ${sc.dashboard_url ? `[open](${sc.dashboard_url})` : "-"} |`;
   });
   return [
-    `### KeepSnappy: ${word(v.state, v.word, v.headline)}`,
+    `### KeepSnappy: ${setWord(v)}`,
     "",
     ...setupLine(v.headline) ? [`${setupLine(v.headline)}.`, ""] : [],
     `\`${s.branch}\`${s.commit_sha ? ` @ \`${s.commit_sha.slice(0, 7)}\`` : ""}, ${s.runs.valid}/${s.runs.total} runs used.${v.low_data ? ` ${FEW_RUNS}.` : ""}`,
@@ -5756,6 +5969,7 @@ Runs uploaded for \`${fallback.branch}\`. The result appears on the dashboard: [
     `| Journey | Device | Result | ${STATE_WORDS.worse} / ${STATE_WORDS.warning} / ${STATE_WORDS.better} / ${STATE_WORDS["no-change"]} / ${STATE_WORDS["cant-tell"]} | Details |`,
     "|---|---|---|---|---|",
     ...rows,
+    ...contextLines.length ? ["", ...contextLines] : [],
     ...heated.length ? ["", ...heated.map((note) => `${note}.`)] : [],
     "",
     `[Open the dashboard](${s.dashboard_url})`,
@@ -9591,6 +9805,14 @@ ${outcome.summary}`);
     ...api.fetch ? { fetch: api.fetch } : {}
   }).catch(infra(`results are saved in ${out}, but the upload failed`));
   rt.print(`uploaded ${up.uploaded} runs to ${api.url}${up.skipped.length ? ` (${up.skipped.length} skipped: ${up.skipped.map((x) => `${x.run_id} ${x.why}`).join(", ")})` : ""}`);
+  if (up.uploaded === 0) {
+    if (runSet)
+      await completeRunSet(api, runSet.run_set_id, "on-read").catch(infra("no run was uploaded, and the run set could not be closed"));
+    rt.print("Blocked: no run sent any data. Check that the build carries the SDK and that the app reaches the API.");
+    if (runSet)
+      await writeResult(deps, out, rt, runSet, null, git.branch, true);
+    return EXIT.infra;
+  }
   if (!runSet)
     return EXIT.ok;
   let summary = null;
@@ -9607,6 +9829,9 @@ ${formatRunSet(summary)}`);
     rt.print(`--fail-on-worse: a journey is ${STATE_WORDS.worse.toLowerCase()} than its baseline and blocks (exit 3)`);
     return EXIT.worse;
   }
+  const unchecked = o["fail-on-worse"] && summary ? uncheckedGate(summary) : null;
+  if (unchecked)
+    rt.print(unchecked);
   return EXIT.ok;
 }
 async function replayFlow(config, scenario) {
@@ -9623,13 +9848,16 @@ var infra = (what) => (e) => {
     throw new Error(`${what}: ${e.message}`);
   throw e;
 };
-async function writeResult(deps, out, rt, runSet, summary, branch) {
+async function writeResult(deps, out, rt, runSet, summary, branch, blocked = false) {
   const url = summary?.dashboard_url ?? runSet.dashboard_url;
-  await deps.fs.writeFile(join9(out, "keepsnappy-result.json"), `${JSON.stringify({ run_set_id: runSet.run_set_id, dashboard_url: url, state: summary?.verdicts?.state ?? null, summary }, null, 2)}
+  await deps.fs.writeFile(join9(out, "keepsnappy-result.json"), `${JSON.stringify({ run_set_id: runSet.run_set_id, dashboard_url: url, state: blocked ? "blocked" : summary?.verdicts?.state ?? null, summary }, null, 2)}
 `);
   const step = rt.env.GITHUB_STEP_SUMMARY;
   if (step)
-    await deps.fs.appendFile(step, markdownRunSet(summary, { dashboardUrl: url, branch }));
+    await deps.fs.appendFile(step, blocked ? `### KeepSnappy: Blocked
+
+No run sent any data. [Open the dashboard](${url})
+` : markdownRunSet(summary, { dashboardUrl: url, branch }));
 }
 
 // apps/agent/src/doctor.ts
@@ -10091,7 +10319,7 @@ import { existsSync, readFileSync, statSync } from "node:fs";
 import { dirname as dirname2, join as join11, relative as relative2, resolve as resolve4 } from "node:path";
 import { fileURLToPath } from "node:url";
 function driverVersion() {
-  const built = "0.1.0-alpha.16";
+  const built = "0.1.0-alpha.17";
   if (built)
     return built;
   let dir = dirname2(fileURLToPath(import.meta.url));
@@ -10146,8 +10374,6 @@ var SDK_FLUSH_WORST_CASE_MS = 315000;
 var FLUSH_MARGIN_MS = 30000;
 var FLUSH_WAIT_MS = SDK_FLUSH_WORST_CASE_MS + FLUSH_MARGIN_MS;
 var FLUSH_STATUSES = new Set(["ok", "error", "off"]);
-// packages/appium-driver/dist/src/gestures.js
-var densities = new WeakMap;
 // apps/agent/src/device-model.ts
 import { tmpdir } from "node:os";
 import { join as join12 } from "node:path";
@@ -10317,6 +10543,7 @@ function slackMessage(s, ctx) {
   const better = items.filter(isBetter).sort(bySize);
   const commit = commitLine(ctx);
   const heated = v.scenarios.filter((sc) => heatNote(sc));
+  const contextLines = v.scenarios.flatMap((sc) => laneContextLines(sc.context, sc.scenario ?? "-", phone(sc))).map(context);
   const heat = heated.map((sc) => context(heatNote(sc)));
   const errorRows = worse.filter((i) => i.grade !== "warn");
   const warningRows = worse.filter((i) => i.grade === "warn");
@@ -10330,15 +10557,15 @@ function slackMessage(s, ctx) {
     if (!worse.length) {
       if (!heat.length)
         return null;
-      const head = `⚪ ${ctx.branch}: ${INFO_WORDS.heat}`;
-      const blocks = [section(`*${head}*`), ...heat, ...commit ? [context(commit)] : [], section(`\uD83D\uDC49 <${heated[0].dashboard_url ?? s.dashboard_url}|View the comparison>`)];
+      const head = `⚪ ${ctx.branch}: ${heat.length ? INFO_WORDS.heat : v.word ?? STATE_WORDS["no-change"]}`;
+      const blocks = [section(`*${head}*`), ...heat, ...contextLines, ...commit ? [context(commit)] : [], section(`\uD83D\uDC49 <${heated[0]?.dashboard_url ?? s.dashboard_url}|View the comparison>`)];
       return { text: head, attachments: [{ color: COLOR.none, blocks }] };
     }
     const graded = worse.some((i) => i.grade);
     const places = (word, n) => `${word.toLowerCase()} in ${n} place${n > 1 ? "s" : ""}`;
     const counts = graded ? [errors ? `${places(STATE_WORDS.worse, errors)}${notBlocking ? ` (${NOT_BLOCKING})` : ""}` : "", warns ? places(STATE_WORDS.warning, warns) : ""].filter(Boolean).join(", ") : `${places(STATE_WORDS.worse, placeCount(worse))}${notBlocking ? ` (${NOT_BLOCKING})` : ""}`;
     const head = `${worseMark} ${ctx.branch}: ${counts}`;
-    const blocks = [section(`*${head}*`)];
+    const blocks = [section(`*${head}*`), ...contextLines];
     const groups = new Map;
     for (const i of worse)
       groups.set(scenarioOf(i), [...groups.get(scenarioOf(i)) ?? [], i]);
@@ -10373,7 +10600,7 @@ ${prTable(rows, sc)}`));
   const head = `${worse.length ? worseMark : improved ? "\uD83D\uDFE2" : v.state === "inconclusive" && (ctx.always || !heat.length) ? "❔" : "⚪"} ${status}`;
   const journeys = new Set(v.scenarios.map((sc) => `${sc.scenario}|${sc.device?.id}`)).size;
   const blocks = [section(`*${head}*
-${journeys} journey${journeys === 1 ? "" : "s"} checked`)];
+${journeys} journey${journeys === 1 ? "" : "s"} checked`), ...contextLines];
   let shown = 0;
   for (const [title, list] of [[STATE_WORDS.worse, errorRows], [STATE_WORDS.warning, warningRows], [STATE_WORDS.better, better]]) {
     for (const i of list) {
@@ -10409,17 +10636,23 @@ var LINKS_USAGE = `keepsnappy activation-link --scheme <app://> --token <run tok
   flush-link --scheme <app://>
   gc-link    --scheme <app://> [--n 1]`;
 function linksCommand(cmd, argv, rt) {
-  const { values: o } = parseArgs({
-    args: [...argv],
-    options: {
-      scheme: { type: "string" },
-      token: { type: "string" },
-      n: { type: "string" },
-      "no-diag": { type: "boolean" },
-      "no-profile": { type: "boolean" },
-      set: { type: "string", multiple: true }
+  const { values: o } = (() => {
+    try {
+      return parseArgs({
+        args: [...argv],
+        options: {
+          scheme: { type: "string" },
+          token: { type: "string" },
+          n: { type: "string" },
+          "no-diag": { type: "boolean" },
+          "no-profile": { type: "boolean" },
+          set: { type: "string", multiple: true }
+        }
+      });
+    } catch (e) {
+      throw new UsageError([e.message, LINKS_USAGE]);
     }
-  });
+  })();
   if (!o.scheme)
     throw new ConfigError([`--scheme is required (the app's URL scheme, e.g. myapp://)`]);
   if (cmd === "flush-link") {
@@ -10865,9 +11098,9 @@ ${tail.join(" ")}
       ...blocked ? { blocked: { reason: `No iteration sent any data${session.known ? ` (device session ${session.status})` : ""}.` } } : {},
       always: envValue(rt.env, "SLACK_ALWAYS") === "1"
     });
-    if (!msg)
-      rt.print(f.wait ? `Slack: nothing to report (${STATE_WORDS["no-change"].toLowerCase()})` : "Slack: skipped, the message needs --wait");
-    else {
+    if (!msg) {
+      rt.print(!f.wait ? "Slack: skipped, the message needs --wait" : notComputed(summary) ? "Slack: nothing to report, the verdict is not computed yet" : `Slack: nothing to report (${resultWord(summary).toLowerCase()})`);
+    } else {
       const r = await postToSlack(hook, msg, rt.fetch ?? fetch);
       rt.print(r.ok ? "Slack: posted" : `Slack: not posted (${r.error}); the job is not affected`);
     }
@@ -10878,6 +11111,9 @@ ${tail.join(" ")}
     rt.print(`--fail-on-worse: a journey is ${STATE_WORDS.worse.toLowerCase()} than its baseline and blocks (exit 3)`);
     return EXIT.worse;
   }
+  const unchecked = f["fail-on-worse"] ? uncheckedGate(summary) : null;
+  if (unchecked)
+    rt.print(unchecked);
   return EXIT.ok;
 }
 
@@ -11297,7 +11533,7 @@ function printPlan(p, f, rt) {
     line(`     env ${k}=${substitute(v, {})}`);
   line(`  6. farm close${f.wait ? " --wait" : ""}${f["fail-on-worse"] ? " --fail-on-worse" : ""} with ${join16(p.out, `browserstack.${p.platform}.json`)}`);
   line("  7. always: stop the tunnel, put the empty stub back over the tokens file");
-  line("  exit: 0 any verdict, 1 infrastructure / driver failed / Blocked, 2 configuration, 3 --fail-on-worse");
+  line("  exit: 0 any verdict, 1 infrastructure / driver failed / Blocked, 2 configuration, 3 --fail-on-worse (a computed blocking Worse only; no computed verdict: nothing checked)");
 }
 var ANNOTATION = /^::(error|warning|notice)( [^:]*)?::/;
 async function runDriver2(deps, rt, f, p, ports, ctx) {
@@ -11729,7 +11965,8 @@ var SHORT_FORM_NOTES = {
   main_vs_previous: `the movers after the first ${SHORT_PLACES} (every new, gone or multi-device place stays)`,
   place_trend: `the sessions older than the newest ${SHORT_SESSIONS} and the history restarts among them (unknown restarts always stay)`,
   window_history: `the runs older than the newest ${SHORT_POINTS}`,
-  pr_status: "the per-journey dashboard links and the heat note"
+  pr_status: "the per-journey dashboard links and the heat note",
+  list_problems: `the work and component lines, the dashboard links and the problems after the first ${SHORT_PLACES}`
 };
 var andList = (xs) => xs.length < 2 ? xs[0] ?? "" : `${xs.slice(0, -1).join(", ")} and ${xs[xs.length - 1]}`;
 
@@ -11748,6 +11985,13 @@ class Rows {
   full(...texts) {
     return this.add(false, ...texts);
   }
+  detail(...texts) {
+    for (const text of texts)
+      for (const line of text.split(`
+`))
+        this.rows.push({ text: line, short: false, notice: false });
+    return this;
+  }
   render(form, left = []) {
     if (form !== "short")
       return this.rows.map((r) => r.text).join(`
@@ -11762,7 +12006,7 @@ class Rows {
     }
     if (kept[kept.length - 1] === "")
       kept.pop();
-    if (this.rows.some((r) => !r.short && r.text.trim() !== ""))
+    if (this.rows.some((r) => !r.short && r.notice !== false && r.text.trim() !== ""))
       kept.push(`Short form: ${andList(left.length ? left : ["other lines"])} left out; the full form shows them.`);
     return kept.join(`
 `);
@@ -11770,19 +12014,22 @@ class Rows {
 }
 var LABEL_W = 14;
 var line = (label, text) => `  ${label.padEnd(LABEL_W)}${text}`;
-var plural = (n, w) => `${n} ${w}${n === 1 ? "" : "s"}`;
+var plural2 = (n, w) => `${n} ${w}${n === 1 ? "" : "s"}`;
 var promptText = (f) => f.what_to_do.prompt ?? "No prompt: this finding is an improvement.";
 function formatFinding(f, opts = {}) {
   const r = new Rows;
   r.both(f.answer.headline, line("What changed", f.answer.what_changed), line("Where", f.answer.where), line("How sure", f.answer.how_sure));
+  if (f.lane)
+    r.both(...laneContextLines(f.lane.context, f.lane.journey, f.lane.phone_name, opts.verbose, opts.form === "short"));
   r.full(line("Why", f.answer.why));
   r.both(line("What to do", f.answer.what_to_do));
   r.full(line("Seen", f.answer.lifecycle), line("Layer", `${f.layer.id} · ${f.layer.name} (${f.certificate ? "certified" : "uncertified"})${f.limits.length ? `; limits: ${f.limits.join("; ")}` : ""}`));
   r.both(line("Id", f.id));
   if (f.why.components.length) {
     r.full(line("Components", ""));
-    for (const c of f.why.components) {
-      r.full(`    ${c.component}: ${c.self_ms_before ?? "–"} → ${c.self_ms_after} ms own time, renders ${c.renders_before ?? "–"} → ${c.renders_after ?? "–"}${c.cause ? `; ${c.cause}` : ""}${c.flagged ? "" : " (not certain)"}`);
+    const names = componentReadNames(f.why.components.map((c) => ({ key: c.key, name: c.component, ...c.file ? { file: c.file } : {} })));
+    for (const [i, c] of f.why.components.entries()) {
+      r.full(`    ${names[i]}${opts.verbose && c.file ? ` (${c.file})` : ""}: ${c.self_ms_before ?? "–"} → ${c.self_ms_after} ms ${c.key ? READ_WORDS.componentTime : READ_WORDS.ownTime}, renders ${c.renders_before ?? "–"} → ${c.renders_after ?? "–"}${c.cause ? `; ${c.cause}` : ""}${c.flagged ? "" : " (not certain)"}`);
     }
   }
   const memory = f.why.memory ?? [];
@@ -11797,15 +12044,15 @@ function formatFinding(f, opts = {}) {
     r.full("", promptText(f));
   return r.render(opts.form, [
     "the why, seen and layer lines",
-    ...f.why.components.length ? [plural(f.why.components.length, "component line")] : [],
-    ...memory.some((m) => m.metric !== f.what.metric) ? [plural(memory.filter((m) => m.metric !== f.what.metric).length, "memory evidence line")] : [],
+    ...f.why.components.length ? [plural2(f.why.components.length, "component line")] : [],
+    ...memory.some((m) => m.metric !== f.what.metric) ? [plural2(memory.filter((m) => m.metric !== f.what.metric).length, "memory evidence line")] : [],
     ...opts.prompt ? ["the prompt"] : []
   ]);
 }
 var when = (iso) => iso.slice(0, 16).replace("T", " ");
 var LANES_SHOWN = 8;
 var STATE_WORDS2 = { present: "still present", resolved: "resolved", "not-judged": "not judged in the newest run set" };
-function measuredLines(l, r) {
+function measuredLines(l, r, opts) {
   const f = l.filters;
   const scope = [f.branch ?? "all branches", f.journey, f.phone].filter(Boolean).join(" · ");
   const m = l.measured;
@@ -11813,7 +12060,7 @@ function measuredLines(l, r) {
   if (!n) {
     const on = f.branch ? f.branch === l.baseline_branch ? f.branch : `branch ${f.branch}` : "any branch";
     const narrow = [f.journey, f.phone ? `phone “${f.phone}”` : null].filter(Boolean).join(", ");
-    r.both(m.run_sets ? `${scope}: ${plural(m.run_sets, "run set")} measured, but no verdict yet: nothing is known about its performance.` : `No KeepSnappy measurement on ${on}${narrow ? ` for ${narrow}` : ""}: nothing is known about its performance.`);
+    r.both(m.run_sets ? `${scope}: ${plural2(m.run_sets, "run set")} measured, but no verdict yet: nothing is known about its performance.` : `No KeepSnappy measurement on ${on}${narrow ? ` for ${narrow}` : ""}: nothing is known about its performance.`);
     return [];
   }
   const lane = (x) => {
@@ -11821,22 +12068,29 @@ function measuredLines(l, r) {
     return `${x.commit?.sha ? `commit ${x.commit.sha.slice(0, 7)}` : "commit not recorded"} (${when(x.at)}): ${x.word}${runs}${x.waiting_for_reprocess ? `; ${waitingWords(x.waiting_for_reprocess)}` : ""}`;
   };
   if (m.lanes.length === 1) {
-    r.both(`${scope}: newest measured ${f.branch ? "" : `on ${n.branch}, `}${lane(n)}; ${plural(m.run_sets, "run set")} measured.`);
+    r.both(`${scope}: newest measured ${f.branch ? "" : `on ${n.branch}, `}${lane(n)}; ${plural2(m.run_sets, "run set")} measured.`);
+    r.both(...laneContextLines(n.context, n.journey, n.phone_name, opts.verbose, opts.form === "short"));
     return [];
   }
   const shown = m.lanes.slice(0, LANES_SHOWN);
-  const unjudged = shown.filter((x) => !x.judged);
-  r.add(unjudged.length > 0, `${scope}: ${plural(m.run_sets, "run set")} measured; the newest of each journey × phone:`);
-  for (const x of shown)
-    r.add(!x.judged, `  ${x.journey} on ${x.phone_name}${f.branch ? "" : ` (${x.branch})`}: ${lane(x)}`);
+  r.add(shown.some((x) => !x.judged || !!x.context), `${scope}: ${plural2(m.run_sets, "run set")} measured; the newest of each journey × phone:`);
+  for (const x of shown) {
+    const keep = !x.judged || !!x.context;
+    r.add(keep, `  ${x.journey} on ${x.phone_name}${f.branch ? "" : ` (${x.branch})`}: ${lane(x)}`);
+    r.add(keep, ...resultContextLines(x.context, opts.verbose, opts.form === "short").map((line) => `    ${line}`));
+  }
   if (m.lanes.length > shown.length)
     r.full(`  … ${m.lanes.length - shown.length} more (--journey / --phone narrow it)`);
-  return [...shown.length > unjudged.length ? [plural(shown.length - unjudged.length, "judged lane")] : [], ...m.lanes.length > shown.length ? [plural(m.lanes.length - shown.length, "lane") + " beyond the eighth"] : []];
+  const judgedLeft = shown.filter((x) => x.judged && !x.context).length;
+  return [
+    ...judgedLeft ? [plural2(judgedLeft, "judged lane")] : [],
+    ...m.lanes.length > shown.length ? [plural2(m.lanes.length - shown.length, "lane") + " beyond the eighth"] : []
+  ];
 }
 function countsLine2(l) {
   const c = l.counts;
   const parts = [
-    c.worse ? `${c.worse} ${STATE_WORDS.worse.toLowerCase()}${c.not_blocking ? ` (${c.not_blocking} not blocking)` : ""}` : "",
+    c.worse ? `${c.worse} ${STATE_WORDS.worse.toLowerCase()}${c.not_blocking ? ` (${c.not_blocking} ${NOT_BLOCKING})` : ""}` : "",
     c.warn ? `${c.warn} ${STATE_WORDS.warning.toLowerCase()}` : "",
     c.better ? `${c.better} ${STATE_WORDS.better.toLowerCase()}` : ""
   ].filter(Boolean);
@@ -11845,7 +12099,7 @@ function countsLine2(l) {
   const head = parts.length ? `${parts.join(", ")}${state === "all" ? "" : `, ${STATE_WORDS2[state] ?? state}`}` : state !== "present" && state !== "all" ? `No finding ${STATE_WORDS2[state] ?? state}` : unjudged.length === l.measured.lanes.length ? `No finding, but nothing was compared yet (${[...new Set(unjudged.map((x) => x.word))].join(", ")}): measure again before calling it clean` : `Nothing ${STATE_WORDS.worse.toLowerCase()}, nothing ${STATE_WORDS.warning.toLowerCase()}, nothing ${STATE_WORDS.better.toLowerCase()}`;
   const heated = c.heat_runs ?? 0;
   const more = [
-    heated ? `${INFO_WORDS.heat.toLowerCase()} in ${plural(heated, "run")} (run health, layer 3)` : "",
+    heated ? `${INFO_WORDS.heat.toLowerCase()} in ${plural2(heated, "run")} (run health, layer 3)` : "",
     state === "present" && l.states.not_judged ? `${l.states.not_judged} more not judged in the newest run set (state not-judged)` : ""
   ].filter(Boolean);
   const line = `${head}${more.length ? `; ${more.join("; ")}` : ""}.`;
@@ -11853,7 +12107,7 @@ function countsLine2(l) {
 }
 function formatFindingList(l, opts = {}) {
   const r = new Rows;
-  const lanesLeft = measuredLines(l, r);
+  const lanesLeft = measuredLines(l, r, opts);
   if (l.measured.newest || l.total)
     r.both(countsLine2(l));
   l.findings.forEach((f, i) => {
@@ -11870,11 +12124,7 @@ function formatFindingList(l, opts = {}) {
   if (l.findings.length)
     r.both("", "One finding with its evidence and a prompt: keepsnappy finding <id> --prompt");
   const notWorse = l.findings.filter((f) => !isWorseState(f.state)).length;
-  return r.render(opts.form, [
-    ...l.findings.length ? [plural(l.findings.length, "how-sure line")] : [],
-    ...notWorse ? [plural(notWorse, "place line")] : [],
-    ...lanesLeft
-  ]);
+  return r.render(opts.form, [...l.findings.length ? [plural2(l.findings.length, "how-sure line")] : [], ...notWorse ? [plural2(notWorse, "place line")] : [], ...lanesLeft]);
 }
 var STATUS_LEAD = {
   ok: "ok",
@@ -11890,9 +12140,10 @@ function formatBranchStatus(s, opts = {}) {
   if (s.lanes.length)
     r.both("");
   for (const l of s.lanes) {
-    const badge = l.result === "blocks" ? " (blocks)" : l.word === STATE_WORDS.worse ? ` (${NOT_BLOCKING})` : "";
+    const shown = l.result === "blocks" ? `${l.word} (blocks)` : badgedWord(l.word, l.blocking);
     const sha = l.commit?.sha?.slice(0, 7);
-    r.both(`  ${l.journey_title ?? l.journey} on ${l.phone_name}: ${l.word}${badge} · ${sha ? `commit ${sha}` : "commit not recorded"} (${when(l.at)})${l.in_newest_run_set ? "" : " · older run set"}${l.waiting_for_reprocess ? `; ${waitingWords(l.waiting_for_reprocess)}` : ""}`);
+    r.both(`  ${l.journey_title ?? l.journey} on ${l.phone_name}: ${shown} · ${sha ? `commit ${sha}` : "commit not recorded"} (${when(l.at)})${l.in_newest_run_set ? "" : " · older run set"}${l.waiting_for_reprocess ? `; ${waitingWords(l.waiting_for_reprocess)}` : ""}`);
+    r.both(...resultContextLines(l.context, opts.verbose, opts.form === "short"));
     for (const f of l.worst)
       r.both(`    ${f.id}  ${f.headline}`);
     if (l.present_findings > l.worst.length)
@@ -11903,8 +12154,13 @@ function formatBranchStatus(s, opts = {}) {
   const links = s.lanes.filter((l) => l.link).length;
   const heated = s.counts.heat_runs ?? 0;
   const more = [
-    [false, heated ? `${INFO_WORDS.heat.toLowerCase()} in ${plural(heated, "run")} (information, never blocks)` : ""],
-    [true, s.not_judged_findings ? `${plural(s.not_judged_findings, "finding")} not judged in the newest run set; they may still be there: keepsnappy findings --branch ${s.branch} --state not-judged` : ""],
+    [false, heated ? `${INFO_WORDS.heat.toLowerCase()} in ${plural2(heated, "run")} (information, never blocks)` : ""],
+    [
+      true,
+      s.not_judged_findings ? `${plural2(s.not_judged_findings, "finding")} not judged in the newest run set; they may still be there: keepsnappy findings --branch ${s.branch} --state not-judged` : ""
+    ],
+    [true, statusProblemsLine(s)],
+    [true, s.problems?.unread_lanes ? `${unreadWords(s.problems.unread_lanes)} for problems: ${staleResult(s.problems.unread_lanes)}` : ""],
     [true, s.links.overview ? `Dashboard: ${s.links.overview}` : ""],
     [true, s.worst.length ? "One finding with its evidence and a prompt: keepsnappy finding <id> --prompt" : ""]
   ];
@@ -11913,10 +12169,65 @@ function formatBranchStatus(s, opts = {}) {
     r.both("");
   for (const [short, text] of shownMore)
     r.add(short, text);
-  return r.render(opts.form, [...links ? [plural(links, "dashboard link")] : [], ...heated ? ["the heat note"] : []]);
+  return r.render(opts.form, [...links ? [plural2(links, "dashboard link")] : [], ...heated ? ["the heat note"] : []]);
+}
+function statusProblemsLine(s) {
+  const p = s.problems;
+  if (!p?.count)
+    return "";
+  return `${plural2(p.places, "place")} over budget in this branch’s own runs (${p.far_count ? `${p.far_count} far over budget; ` : ""}not a regression, never blocks): list_problems, or keepsnappy problems --branch ${s.branch}`;
+}
+var unreadWords = (n) => `${n} journey × phone not read`;
+var staleResult = (n) => `${n === 1 ? "its stored result is" : "their stored results are"} not current`;
+function formatProblemList(l, opts = {}) {
+  const r = new Rows;
+  const b = l.filters.branch;
+  const c = l.counts;
+  const unread = c.unread_lanes ?? 0;
+  const read = l.lanes.length - unread;
+  if (!l.measured.run_sets) {
+    r.both(`No KeepSnappy measurement on ${b === l.baseline_branch ? b : `branch ${b}`}: nothing is known about its problems.`);
+    return r.render(opts.form);
+  }
+  if (!l.lanes.length) {
+    r.both(`${b}: ${plural2(l.measured.run_sets, "run set")} measured, but no judgement yet to read problems from.`);
+    return r.render(opts.form);
+  }
+  if (c.count)
+    r.both(`${b}: ${plural2(c.places, "place")} over budget in ${b === l.baseline_branch ? "main’s" : "this branch’s"} own runs${c.far_count ? ` (${c.far_count} far over budget)` : ""}`);
+  else if (read)
+    r.both(`${b}: no problem over budget in the newest run set (${read} journey × phone read)`);
+  else
+    r.both(`${b}: no problem could be read: ${unread} journey × phone has a stored result that is not current, so nothing is known about its problems.`);
+  r.both(l.note);
+  if (read && unread)
+    r.both(`${unreadWords(unread)}: ${staleResult(unread)}, so nothing is known about ${unread === 1 ? "its" : "their"} problems.`);
+  l.problems.forEach((p, i) => {
+    const keep = i < SHORT_PLACES;
+    r.add(keep, "", `${l.offset + i + 1}. ${p.text}: ${p.place_name}${opts.verbose ? ` (${p.place})` : ""}${p.intermittent ? ` — ${p.note}, not counted` : ""}`);
+    r.add(keep, `   ${p.journey_title ?? p.journey} on ${p.phone_name}, ${p.runs_text}${p.tag_word ? `, ${p.tag_word}` : ""}`);
+    const top = p.top_components[0];
+    const topName = componentReadNames(p.top_components)[0];
+    const detail = [p.work, top ? `heaviest ${topName}${opts.verbose && top.key ? ` (${top.key})` : ""} ${top.self_text}` : null, p.new_component ? NEW_IN_PR_CHIP : null, p.range_text ? `${p.range_text} between runs` : null].filter(Boolean);
+    if (detail.length)
+      r.full(`   ${detail.join("; ")}`);
+    if (p.url)
+      r.full(`   ${p.url}`);
+  });
+  const shown = l.problems.length ? `Showing ${l.offset + 1}–${l.offset + l.problems.length} of ${l.total}` : "";
+  if (l.next_offset !== null)
+    r.both("", `${shown || `Showing none of ${l.total}`}; the rest from offset ${l.next_offset} (--offset ${l.next_offset}).`);
+  else if (l.offset > 0)
+    r.both("", shown ? `${shown}.` : `Offset ${l.offset} is past the last of ${l.total}.`);
+  const detailLines = l.problems.some((p) => p.work || p.top_components.length || p.new_component || p.range_text);
+  return r.render(opts.form, [
+    ...detailLines ? ["the work and component lines"] : [],
+    ...l.problems.some((p) => p.url) ? ["the dashboard links"] : [],
+    ...l.problems.length > SHORT_PLACES ? [`${plural2(l.problems.length - SHORT_PLACES, "problem")} beyond the fifth`] : []
+  ]);
 }
 var commitText = (c) => !c ? "commit not recorded" : c.title ? `“${c.title}”${c.author ? ` by ${c.author}` : ""}${c.sha ? ` (${c.sha.slice(0, 7)})` : ""}` : c.sha ? c.sha.slice(0, 7) : "commit not recorded";
-function formatCompare(r) {
+function formatCompare(r, opts = {}) {
   const out = [
     `Run A: ${r.a.external_id} on ${r.a.branch ?? "?"}, ${commitText(r.a.commit ? { sha: r.a.commit_sha, ...r.a.commit } : { sha: r.a.commit_sha, title: null, author: null })}`,
     `Run B: ${r.b.external_id} on ${r.b.branch ?? "?"}, ${commitText(r.b.commit ? { sha: r.b.commit_sha, ...r.b.commit } : { sha: r.b.commit_sha, title: null, author: null })}`,
@@ -11926,9 +12237,42 @@ function formatCompare(r) {
     out.push(`Measured differently: ${r.setup_differs.map((d) => `${d.field} ${JSON.stringify(d.a)} → ${JSON.stringify(d.b)}`).join(", ")}`);
   for (const w of r.windows) {
     const ms = w.metrics.filter((m) => m.a !== null || m.b !== null);
-    if (!ms.length)
+    const c = w.component_page ?? w.components;
+    if (!ms.length && !c)
       continue;
-    out.push("", w.window_name);
+    out.push("", `${w.window_name}${opts.verbose ? ` (${w.window})` : ""}`);
+    const singles = [...c?.added ?? [], ...c?.removed ?? [], ...w.component_page?.uncompared?.a ?? [], ...w.component_page?.uncompared?.b ?? []];
+    const components = [...c?.rows ?? [], ...singles];
+    const names = componentReadNames(components.map((row) => ({ key: row.key, name: row.component })));
+    const shown = new Map(components.map((row, i) => [row.key, names[i]]));
+    for (const row of c?.rows ?? [])
+      out.push(`  ${shown.get(row.key)}: ${row.self_ms_a === null ? "–" : exactComponentMs(row.self_ms_a)} → ${row.self_ms_b === null ? "–" : exactComponentMs(row.self_ms_b)}${opts.verbose ? ` (${row.key})` : ""}`);
+    for (const [label, rows] of [
+      [READ_WORDS.onlyB, c?.added ?? []],
+      [READ_WORDS.onlyA, c?.removed ?? []]
+    ]) {
+      for (const row of rows)
+        out.push(`  ${shown.get(row.key)}: ${label}; ${row.self_ms === null ? "–" : exactComponentMs(row.self_ms)}${opts.verbose ? ` (${row.key})` : ""}`);
+    }
+    const page = w.component_page;
+    if (page) {
+      for (const side of ["a", "b"]) {
+        if (!page.measured[side])
+          out.push(`  ${notMeasuredText(side)}`);
+        for (const row of page.uncompared?.[side] ?? [])
+          out.push(`  ${shown.get(row.key)}: ${side === "a" ? READ_WORDS.runA : READ_WORDS.runB} ${row.self_ms === null ? "–" : exactComponentMs(row.self_ms)}${opts.verbose ? ` (${row.key})` : ""}`);
+      }
+      out.push(`  ${componentPageText(page.page, components.length)}`);
+    } else if (c?.totals)
+      out.push(`  ${componentListsText(c.totals, { rows: c.rows.length, added: c.added?.length ?? 0, removed: c.removed?.length ?? 0 })}`);
+    if (c?.omissions)
+      for (const side of ["a", "b"]) {
+        if (page && !page.measured[side])
+          continue;
+        const o = c.omissions[side];
+        if (o.sdkOmitted === null || o.omitted === null || o.sdkOmitted > 0 || o.omitted > 0)
+          out.push(`  ${omissionText({ run_id: side === "a" ? READ_WORDS.runA : READ_WORDS.runB, ...o })}`);
+      }
     for (const m of ms)
       out.push(`  ${m.label.padEnd(28)}${m.a_text.padStart(10)} → ${m.b_text}`);
   }
@@ -11937,7 +12281,7 @@ function formatCompare(r) {
 }
 function formatHistory(h, opts = {}) {
   const r = new Rows;
-  r.both(`${h.window_name} in ${h.journey_title ?? h.journey} on ${h.branch}: ${h.points.length ? `${plural(h.points.length, "run")}, oldest first` : h.note ?? "no runs"}`);
+  r.both(`${h.window_name}${opts.verbose ? ` (${h.window})` : ""} in ${h.journey_title ?? h.journey} on ${h.branch}: ${h.points.length ? `${plural2(h.points.length, "run")}, oldest first` : h.note ?? "no runs"}`);
   const ms = h.measures.slice(0, 4);
   if (h.points.length) {
     r.both(`  ${"when".padEnd(17)}${ms.map((m) => (m.label.length > 22 ? `${m.label.slice(0, 21)}…` : m.label).padStart(24)).join("")}  commit`);
@@ -11948,11 +12292,11 @@ function formatHistory(h, opts = {}) {
   if (h.findings.length)
     r.both("", "Findings on this window:", ...h.findings.map((f) => `  ${f.answer.headline} — ${f.where.branch} (${f.id})`));
   const older = Math.max(0, h.points.length - SHORT_POINTS);
-  return r.render(opts.form, older ? [plural(older, "older run")] : []);
+  return r.render(opts.form, older ? [plural2(older, "older run")] : []);
 }
 function formatCommits(c) {
   return [
-    `${plural(c.commits.length, "measured commit")} (${plural(c.sessions, "session")}) on ${c.branch}, oldest first:`,
+    `${plural2(c.commits.length, "measured commit")} (${plural2(c.sessions, "session")}) on ${c.branch}, oldest first:`,
     ...c.commits.map((x) => `  ${when(x.first_measured_at)}  ${commitText(x)}${x.pull_request?.number ? `, PR #${x.pull_request.number}` : ""}${x.sessions > 1 ? `; ${x.sessions} sessions, the last ${when(x.last_measured_at)}` : ""}`),
     c.note
   ].join(`
@@ -11994,8 +12338,39 @@ function formatSessionPlaces(p, opts = {}) {
   p.places.forEach((place, i) => {
     const m = place.measures.find((x) => x.measure === by);
     const value = m ? `${fieldValueText(by, m.median)} (p90 ${fieldValueText(by, m.p90)}, n ${m.n})` : `no ${by}`;
-    const comps = place.components.map((c) => `${c.name} ${valueText("self_ms", c.self_ms.median)} (p90 ${valueText("self_ms", c.self_ms.p90)}${c.renders_median !== null ? `, ${plural(c.renders_median, "render")}` : ""})`);
-    r.both(`${p.offset + i + 1}. ${place.window_name}: ${value}`);
+    const names = componentReadNames(place.components);
+    const comps = place.components.map((c, i) => `${names[i]}${opts.verbose && c.file ? ` (${c.file})` : ""} ${valueText("self_ms", c.self_ms.median)} (p90 ${valueText("self_ms", c.self_ms.p90)}${c.renders_median !== null ? `, ${plural2(c.renders_median, "render")}` : ""})`);
+    r.both(`${p.offset + i + 1}. ${place.window_name}${opts.verbose ? ` (${place.window})` : ""}: ${value}`);
+    if (place.components_page)
+      r.detail(`   ${componentPageText(place.components_page, place.components.length)}`);
+    for (const o of (place.omissions ?? []).filter((o) => o.sdkOmitted === null || o.omitted === null || o.sdkOmitted > 0 || o.omitted > 0))
+      r.detail(`   ${omissionText(o)}`);
+    const slowest = place.measures.find((m) => m.measure === "commit_max_ms");
+    if (by !== "commit_max_ms" && slowest)
+      r.detail(`   ${READ_WORDS.slowest}: ${fieldValueText("commit_max_ms", slowest.median)}`);
+    for (const detail of place.details ?? []) {
+      if (detail.slowestCommit)
+        r.detail(`   ${detail.run_id}: ${READ_WORDS.slowest}: ${exactComponentMs(detail.slowestCommit.ms)}`);
+      r.detail(`   ${detail.run_id}: ${OUTSIDE_APP_NAME}: ${detail.outside ? exactComponentMs(detail.outside.selfMs) : "–"}; ${OTHER_RENDER_WORK_NAME}: ${detail.remainderMs === null ? "–" : exactComponentMs(detail.remainderMs)}`);
+      for (const l of detail.outside?.rolledUp ?? [])
+        r.detail(`     ${libraryLineText(l)}`);
+      if (detail.outside?.rolledUpRest)
+        r.detail(`     ${rolledUpRestText(detail.outside.rolledUpRest)}`);
+    }
+    for (const [ci, c] of place.components.entries()) {
+      if (c.detail === "ms-only" && !c.runs?.length)
+        r.detail(`   ${names[ci]}: ${READ_WORDS.detailUnavailable}`);
+      for (const d of c.runs ?? [])
+        if (d.detail === "ms-only")
+          r.detail(`   ${names[ci]} · ${d.run_id}: ${d.selfMs === null ? "–" : exactComponentMs(d.selfMs)}; ${READ_WORDS.detailUnavailable}`);
+      for (const d of c.runs ?? [])
+        if (d.detail === "full") {
+          if (d.parent)
+            r.detail(`   ${names[ci]} · ${d.run_id}: ${READ_WORDS.parent} ${componentReadName({ key: d.parent, name: d.parent })}`);
+          if (d.rolledUpMs !== undefined && d.selfMs !== null)
+            r.detail(`   ${names[ci]} · ${d.run_id}: ${rolledUpText(d.rolledUpMs, d.selfMs)}`, ...(d.rolledUp ?? []).map((l) => `     ${libraryLineText(l)}`), ...d.rolledUpRest ? [`     ${rolledUpRestText(d.rolledUpRest)}`] : []);
+        }
+    }
     if (comps.length) {
       r.full(`   Components: ${list(comps)}`);
       componentLines++;
@@ -12005,7 +12380,7 @@ function formatSessionPlaces(p, opts = {}) {
     r.both(p.total ? `Offset ${p.offset} is past the last of ${p.total} places.` : "No place with stored statistics in this session matches.");
   else if (p.next_offset !== null)
     r.both("", `Showing ${p.offset + 1}–${p.offset + p.places.length} of ${p.total}; the rest from offset ${p.next_offset} (--offset ${p.next_offset}).`);
-  return r.render(opts.form, componentLines ? [plural(componentLines, "component line")] : []);
+  return r.render(opts.form, componentLines ? [plural2(componentLines, "component line")] : []);
 }
 function formatLayers(l) {
   return [
@@ -12027,7 +12402,7 @@ function formatMainSessions(h, opts = {}) {
   let otherChanges = 0;
   for (const s of h.sessions) {
     const k = recent.has(s);
-    r.add(k, `${when(s.at)}  ${s.run_set_id}  ${commitText(s.commit ? { ...s.commit, author: null } : null)} (${plural(s.runs, "run")})`);
+    r.add(k, `${when(s.at)}  ${s.run_set_id}  ${commitText(s.commit ? { ...s.commit, author: null } : null)} (${plural2(s.runs, "run")})`);
     if (!s.places)
       r.add(k, `  ${MAIN_SUMMARY_PENDING}${s.summary_reason ? ` (${s.summary_reason})` : ""}`);
     else
@@ -12039,13 +12414,16 @@ function formatMainSessions(h, opts = {}) {
     for (const v of h.versions.filter((v) => v.from_run_set_id === s.run_set_id))
       r.add(k, `  Version: ${v.label}; ${mainCutWords(v)}`);
     for (const c of h.changes.filter((c) => c.from_run_set_id === s.run_set_id)) {
-      r.add(s === latest, `  Main change: ${c.place} ${c.ref}, ${c.before_median ?? "–"} → ${c.after_median ?? "–"}`);
+      r.add(s === latest, `  Main change: ${windowQualified(c.place)}${opts.verbose ? ` (${c.place}; ${c.ref})` : ""} ${storedRefWords(c.ref, h.changes.filter((x) => x.place === c.place && x.from_run_set_id === c.from_run_set_id).map((x) => x.ref))}, ${c.before_median ?? "–"} → ${c.after_median ?? "–"}`);
       if (k && s !== latest)
         otherChanges++;
     }
   }
   const older = h.sessions.length - recent.size;
-  return r.render(opts.form, [...older ? [plural(older, "older session")] : [], ...otherChanges ? [plural(otherChanges, "main change") + " of the other recent sessions"] : []]);
+  return r.render(opts.form, [
+    ...older ? [plural2(older, "older session")] : [],
+    ...otherChanges ? [plural2(otherChanges, "main change") + " of the other recent sessions"] : []
+  ]);
 }
 function formatMainSessionPlaces(p, opts = {}) {
   const r = new Rows;
@@ -12054,12 +12432,12 @@ function formatMainSessionPlaces(p, opts = {}) {
   const baselineSessions = p.baseline_sessions;
   r.both(`Main session places: tiers are verdicts vs ${p.baseline_sessions === undefined ? "earlier sessions" : `the ${p.baseline_sessions} sessions before`}.`);
   for (const x of p.places)
-    r.add(x.tier !== "same", `  ${x.place} ${x.ref}: ${MAIN_TIER_WORDS[x.tier]}${x.reason ? `; ${mainPlaceReasonWords(x.reason, { baseline: { sessions: baselineSessions } })}` : ""}`);
+    r.add(x.tier !== "same", `  ${windowQualified(x.place)}${opts.verbose ? ` (${x.place}; ${x.ref})` : ""} ${storedRefWords(x.ref, p.places.filter((row) => row.place === x.place).map((row) => row.ref))}: ${MAIN_TIER_WORDS[x.tier]}${x.reason ? `; ${mainPlaceReasonWords(x.reason, { baseline: { sessions: baselineSessions } })}` : ""}`);
   const inNorm = p.places.filter((x) => x.tier === "same").length;
-  return r.render(opts.form, inNorm ? [plural(inNorm, "place") + " in norm"] : []);
+  return r.render(opts.form, inNorm ? [plural2(inNorm, "place") + " in norm"] : []);
 }
 var signed = (n) => `${n > 0 ? "+" : ""}${Number(n.toFixed(3))}`;
-var previousLine = (p) => `  ${p.place} ${p.ref}${p.devices ? ` [devices ${p.devices.before.join(", ") || "–"} → ${p.devices.after.join(", ") || "–"}]` : ""}: ${p.status === "compared" ? "" : `${p.status}; `}${p.before ?? "–"} → ${p.after ?? "–"}; delta ${p.delta === null ? "–" : signed(p.delta)}; ${p.percent_change === null ? "change undefined" : `${signed(p.percent_change)}%`}; n ${p.n.before ?? "–"} → ${p.n.after ?? "–"}`;
+var previousLine = (p, verbose = false, peers = []) => `  ${windowQualified(p.place)}${verbose ? ` (${p.place}; ${p.ref})` : ""} ${storedRefWords(p.ref, peers)}${p.devices ? ` [devices ${p.devices.before.join(", ") || "–"} → ${p.devices.after.join(", ") || "–"}]` : ""}: ${p.status === "compared" ? "" : `${p.status === "gone" ? p.ref.startsWith("b:component:") ? JOURNEY_ROW_WORDS.removed : JOURNEY_ROW_WORDS.notInRun : p.status === "new" ? JOURNEY_ROW_WORDS.new : p.status}; `}${p.before ?? "–"} → ${p.after ?? "–"}; delta ${p.delta === null ? "–" : signed(p.delta)}; ${p.percent_change === null ? "change undefined" : `${signed(p.percent_change)}%`}; n ${p.n.before ?? "–"} → ${p.n.after ?? "–"}`;
 function formatMainVsPrevious(m, opts = {}) {
   const r = new Rows().both(`Information only: main session ${m.run_set_id} vs ${m.previous_run_set_id ?? "no previous session"}.`, `Measure: ${m.measure}; ${m.status}.`);
   if (m.cut === "unknown")
@@ -12071,12 +12449,12 @@ function formatMainVsPrevious(m, opts = {}) {
   if (m.stale.length)
     r.both(`stale: ${m.stale.join(", ")}`);
   if (m.journey)
-    r.both("Whole journey:", previousLine(m.journey));
-  m.places.forEach((p, i) => r.add(i < SHORT_PLACES || p.status !== "compared", previousLine(p)));
+    r.both("Whole journey:", previousLine(m.journey, opts.verbose));
+  m.places.forEach((p, i) => r.add(i < SHORT_PLACES || p.status !== "compared", previousLine(p, opts.verbose, m.places.filter((row) => row.place === p.place).map((row) => row.ref))));
   if (m.next_offset !== null)
     r.both(`Showing ${m.offset + 1}–${m.offset + m.places.length} of ${m.total}; next offset ${m.next_offset}.`);
   const smaller = m.places.filter((p, i) => i >= SHORT_PLACES && p.status === "compared").length;
-  return r.render(opts.form, smaller ? [plural(smaller, "smaller mover")] : []);
+  return r.render(opts.form, smaller ? [plural2(smaller, "smaller mover")] : []);
 }
 function formatPlaceTrend(t, opts = {}) {
   const r = new Rows().both(`${t.journey} · ${t.phone.model} · ${t.baseline_branch}: stored per-session statistics`);
@@ -12099,7 +12477,7 @@ function formatPlaceTrend(t, opts = {}) {
       const unit = place.unit ? ` ${place.unit}` : "";
       if (!k)
         olderSessions.add(session.run_set_id);
-      r.add(k, `${session.completed_at?.slice(0, 10) ?? "date unknown"} ${session.commit.sha?.slice(0, 7) ?? "commit unknown"} · ${place.window} · ${place.label} (${place.ref}): median ${value.median}${unit}, MAD ${value.mad}${unit}, n=${value.n}`);
+      r.add(k, `${session.completed_at?.slice(0, 10) ?? "date unknown"} ${session.commit.sha?.slice(0, 7) ?? "commit unknown"} · ${windowQualified(place.window)}${opts.verbose ? ` (${place.window}; ${place.ref})` : ""} · ${place.label} (${storedRefWords(place.ref, t.places.filter((row) => row.window === place.window).map((row) => row.ref))}): median ${value.median}${unit}, MAD ${value.mad}${unit}, n=${value.n}`);
     }
   }
   if (!t.sessions.length)
@@ -12108,7 +12486,10 @@ function formatPlaceTrend(t, opts = {}) {
     r.both(`Not computed: ${t.not_computed.join(", ")}`);
   if (t.stale.length)
     r.both(`Stale: ${t.stale.join(", ")}`);
-  return r.render(opts.form, [...olderSessions.size ? [plural(olderSessions.size, "older session")] : [], ...olderRestarts ? [plural(olderRestarts, "older restart marker")] : []]);
+  return r.render(opts.form, [
+    ...olderSessions.size ? [plural2(olderSessions.size, "older session")] : [],
+    ...olderRestarts ? [plural2(olderRestarts, "older restart marker")] : []
+  ]);
 }
 
 // packages/mcp/dist/src/client.js
@@ -12133,7 +12514,13 @@ async function get(t, path, query = {}) {
   }
   const r = await (t.fetch ?? fetch)(u, { headers: { "x-keepsnappy-key": t.key, accept: "application/json" } });
   const text = await r.text();
-  const body = text ? JSON.parse(text) : {};
+  let body;
+  try {
+    body = text ? JSON.parse(text) : {};
+  } catch {
+    const page = text.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim().slice(0, 120);
+    throw new ApiError(r.status, "not_json", `the API answered ${r.status} with a body that is not JSON${page ? `: ${page}` : ""}`);
+  }
   if (!r.ok) {
     const code = typeof body.error === "string" ? body.error : String(r.status);
     const message = typeof body.message === "string" ? body.message : code;
@@ -12144,8 +12531,9 @@ async function get(t, path, query = {}) {
 }
 var listFindings = (t, f = {}) => get(t, "v1/findings", { branch: f.branch, main: f.main ? "true" : undefined, journey: f.journey, phone: f.phone, state: f.state, limit: f.limit, offset: f.offset || undefined });
 var branchStatus = (t, branch) => get(t, "v1/branches/status", { branch });
+var listProblems = (t, f = {}) => get(t, "v1/problems", { branch: f.branch, main: f.main ? "true" : undefined, journey: f.journey, phone: f.phone, limit: f.limit, offset: f.offset || undefined });
 var getFinding = (t, id) => get(t, `v1/findings/${encodeURIComponent(id)}`);
-var compareRuns = (t, a, b) => get(t, "v1/compare", { a, b });
+var compareRuns = (t, a, b, page = {}) => get(t, "v1/compare", { a, b, ...page });
 var windowHistory = (t, q) => get(t, "v1/history", q);
 var commitsBetween = (t, q) => get(t, "v1/commits", q);
 var layers = (t) => get(t, "v1/layers");
@@ -12159,7 +12547,10 @@ var sessionPlaces = (t, f) => get(t, "v1/sessions/places", {
   window: f.window,
   limit: f.limit,
   offset: f.offset || undefined,
-  top_components: f.top_components
+  top_components: f.top_components,
+  detail: f.detail,
+  component_offset: f.component_offset,
+  component_limit: f.component_limit
 });
 var SESSION_SORTS = ["median", "p90", "mad"];
 var mainSessions = (t, q) => get(t, "v1/main/sessions", { ...q });
@@ -12173,6 +12564,8 @@ var placeTrend = (t, q) => get(t, "v1/places/trend", { ...q });
 // apps/agent/src/findings.ts
 var FINDINGS_USAGE = `keepsnappy findings [--branch NAME | --main] [--journey KEY] [--phone MODEL] [--state present|not-judged|resolved|all] [--limit N] [--offset N] [--short] [--json]
   status   --branch NAME [--short] [--json]                        (is my PR ok? one answer: blocked / nothing blocks / ok, per journey × phone the word, the ids of the worst findings, dashboard links; never measured and not judged are not ok)
+  problems --branch NAME | --main [--journey KEY] [--phone MODEL] [--limit N] [--offset N] [--short] [--json]
+           (the single problems "Over budget" / "Far over budget" in the branch's own runs, whatever main does: not a regression, never blocking)
   finding  <id> [--prompt] [--short] [--json]                      (--prompt: only the hand-off for a coding agent; with --json the whole finding)
   compare  <runA> <runB> [--json]                                  (run ids or external ids; one run against one, no statistics)
   history  <journey> <window> [--phone MODEL] [--short] [--json]   (exact window id, e.g. "press:live.chat.send")
@@ -12183,20 +12576,14 @@ var FINDINGS_USAGE = `keepsnappy findings [--branch NAME | --main] [--journey KE
   layers   [--json]
   trend    <journey> <window words...> --phone MODEL [--window PLACE ...] [--ref REF ...] [--sessions N] [--short] [--json]
            (the words after the journey are one window name; more windows with repeated --window)
-  --short  (findings, status, finding, history, places, main, trend: what decides, without the evidence detail; the same as the MCP tools' form short; --json is unchanged)
+${READ_USAGE.components}
+${READ_USAGE.verbose}
+${READ_USAGE.detailFlag}
+  --short  (findings, status, problems, finding, history, places, main, trend: what decides, without the evidence detail; the same as the MCP tools' form short; --json is unchanged)
   (key: KEEPSNAPPY_KEY or --key-env NAME; API: --api URL or KEEPSNAPPY_API)`;
-
-class UsageError extends ConfigError {
-  constructor(lines) {
-    super(lines);
-    this.message = lines.join(`
-`);
-    this.name = "UsageError";
-  }
-}
 var STATES = ["present", "not-judged", "resolved", "all"];
-var SHORT_COMMANDS = new Set(["findings", "status", "finding", "history", "places", "main", "trend"]);
-var FINDINGS_COMMANDS = new Set(["findings", "status", "finding", "compare", "history", "commits", "places", "layers", "main", "trend"]);
+var SHORT_COMMANDS = new Set(["findings", "status", "problems", "finding", "history", "places", "main", "trend"]);
+var FINDINGS_COMMANDS = new Set(["findings", "status", "problems", "finding", "compare", "history", "commits", "places", "layers", "main", "trend"]);
 async function findingsCommand(cmd, argv, rt) {
   const args = (() => {
     try {
@@ -12204,6 +12591,10 @@ async function findingsCommand(cmd, argv, rt) {
         args: argv,
         allowPositionals: true,
         options: {
+          verbose: { type: "boolean" },
+          detail: { type: "boolean" },
+          page: { type: "string" },
+          all: { type: "boolean" },
           branch: { type: "string" },
           main: { type: "boolean" },
           journey: { type: "string" },
@@ -12237,7 +12628,7 @@ async function findingsCommand(cmd, argv, rt) {
   if (!key)
     throw new ConfigError([`a project key with read scope is needed: set the environment variable ${keyEnv}`]);
   const t = { url: o.api ?? envValue(rt.env, "API") ?? DEFAULT_API_URL, key, ...rt.fetch ? { fetch: rt.fetch } : {} };
-  const answerForm = { form: o.short ? "short" : "full" };
+  const answerForm = { form: o.short ? "short" : "full", verbose: o.verbose };
   const out = (v, text) => {
     rt.print(o.json ? JSON.stringify(v, null, 2) : text(v, answerForm));
     return 0;
@@ -12254,6 +12645,11 @@ async function findingsCommand(cmd, argv, rt) {
   const offset = o.offset === undefined ? undefined : Number(o.offset);
   if (offset !== undefined && (!Number.isInteger(offset) || offset < 0))
     throw new UsageError(["--offset must be a whole number >= 0"]);
+  const page = o.page === undefined ? undefined : Number(o.page);
+  if (page !== undefined && (!["places", "compare"].includes(cmd) || !Number.isInteger(page) || page < 1))
+    throw new UsageError([READ_USAGE.page]);
+  if (o.all && (!["places", "compare"].includes(cmd) || page !== undefined || o.offset !== undefined || o.short))
+    throw new UsageError([READ_USAGE.all]);
   switch (cmd) {
     case "main": {
       if (!o.journey)
@@ -12292,6 +12688,19 @@ async function findingsCommand(cmd, argv, rt) {
       if (!o.branch)
         throw new UsageError(["keepsnappy status needs --branch NAME", FINDINGS_USAGE]);
       return out(await branchStatus(t, o.branch), formatBranchStatus);
+    case "problems":
+      if (!o.branch && !o.main)
+        throw new UsageError(["keepsnappy problems needs --branch NAME or --main", FINDINGS_USAGE]);
+      if (o.branch && o.main)
+        throw new UsageError(["give --branch or --main, not both"]);
+      return out(await listProblems(t, {
+        ...o.branch ? { branch: o.branch } : {},
+        ...o.main ? { main: true } : {},
+        ...o.journey ? { journey: o.journey } : {},
+        ...o.phone ? { phone: o.phone } : {},
+        ...limit ? { limit } : {},
+        ...offset ? { offset } : {}
+      }), formatProblemList);
     case "finding": {
       need(1, "<id>");
       const f = await getFinding(t, p[0]);
@@ -12301,9 +12710,15 @@ async function findingsCommand(cmd, argv, rt) {
       }
       return out(f, formatFinding);
     }
-    case "compare":
+    case "compare": {
       need(2, "<runA> <runB>");
-      return out(await compareRuns(t, p[0], p[1]), formatCompare);
+      const size = o["top-components"] === undefined ? 12 : Number(o["top-components"]);
+      if (!Number.isInteger(size) || size < 1 || size > 200)
+        throw new UsageError([READ_USAGE.compareTop]);
+      const query = page || o.all || o["top-components"] !== undefined ? { component_offset: ((page ?? 1) - 1) * size, component_limit: size } : {};
+      const compared = await compareRuns(t, p[0], p[1], query);
+      return out(o.all ? await allCompare(t, compared, size) : compared, formatCompare);
+    }
     case "history":
       need(2, "<journey> <window>");
       return out(await windowHistory(t, { journey: p[0], window: p.slice(1).join(" "), ...o.phone ? { phone: o.phone } : {}, ...limit ? { limit } : {} }), formatHistory);
@@ -12315,9 +12730,12 @@ async function findingsCommand(cmd, argv, rt) {
       if (sort && !SESSION_SORTS.includes(sort))
         throw new UsageError([`--sort is ${SESSION_SORTS.join(", ")}`]);
       const top = o["top-components"] === undefined ? undefined : Number(o["top-components"]);
-      if (top !== undefined && (!Number.isInteger(top) || top < 0 || top > 20))
-        throw new UsageError(["--top-components must be a whole number from 0 to 20"]);
-      return out(await sessionPlaces(t, {
+      if (top !== undefined && (!Number.isInteger(top) || top < (page || o.all ? 1 : 0) || top > (page || o.all ? 200 : 20)))
+        throw new UsageError([READ_USAGE.top]);
+      if ((o.window?.length ?? 0) > 1)
+        throw new UsageError(["keepsnappy places takes one --window (more windows: keepsnappy trend)", FINDINGS_USAGE]);
+      const query = {
+        ...o.verbose || o.detail ? { detail: true } : {},
         ...o["run-set"] ? { run_set: o["run-set"] } : {},
         ...o.journey ? { journey: o.journey } : {},
         ...o.phone ? { phone: o.phone } : {},
@@ -12327,8 +12745,9 @@ async function findingsCommand(cmd, argv, rt) {
         ...o.window?.length ? { window: o.window[0] } : {},
         ...limit ? { limit } : {},
         ...offset ? { offset } : {},
-        ...top !== undefined ? { top_components: top } : {}
-      }), formatSessionPlaces);
+        ...page || o.all ? { component_offset: ((page ?? 1) - 1) * (top ?? 5), component_limit: top ?? 5 } : top !== undefined ? { top_components: top } : {}
+      };
+      return out(o.all ? await allSessionPlaces(t, query) : await sessionPlaces(t, query), formatSessionPlaces);
     }
     case "layers":
       return out(await layers(t), formatLayers);
@@ -12347,6 +12766,100 @@ async function findingsCommand(cmd, argv, rt) {
       throw new UsageError([FINDINGS_USAGE]);
   }
 }
+async function allSessionPlaces(target, query) {
+  let first = await sessionPlaces(target, query);
+  if (first.places.some((p) => !p.components_page))
+    throw new UsageError([READ_USAGE.paging]);
+  if (first.session.not_computed || first.session.stale)
+    return first;
+  const result = { ...first, places: [], offset: 0, next_offset: null };
+  const pinned = { ...query, run_set: first.session.run_set_id, branch: undefined };
+  const visited = new Set;
+  for (;; ) {
+    const places = first.places.map((p) => ({ ...p, components: [...p.components] }));
+    let response = first;
+    for (;; ) {
+      const next = response.places.flatMap((p) => p.components_page?.next_offset ?? []);
+      if (!next.length)
+        break;
+      const component_offset = Math.min(...next);
+      const mark = `${first.offset}:${component_offset}`;
+      if (visited.has(mark))
+        throw new UsageError([READ_USAGE.paging]);
+      visited.add(mark);
+      response = await sessionPlaces(target, { ...pinned, offset: first.offset, component_offset });
+      for (const p of places) {
+        const more = response.places.find((x) => x.window === p.window);
+        if (!more?.components_page)
+          throw new UsageError([READ_USAGE.paging]);
+        const keys = new Set(p.components.map((c) => c.key));
+        p.components.push(...more.components.filter((c) => !keys.has(c.key)));
+        p.components_page = more.components_page;
+      }
+    }
+    result.places.push(...places.map((p) => ({ ...p, ...p.components_page ? { components_page: { ...p.components_page, offset: 0, limit: p.components.length, next_offset: null } } : {} })));
+    if (places.some((p) => p.components_page && p.components.length !== p.components_page.total))
+      throw new UsageError([READ_USAGE.paging]);
+    if (first.next_offset === null) {
+      if (result.places.length !== result.total)
+        throw new UsageError([READ_USAGE.paging]);
+      return result;
+    }
+    const mark = `places:${first.next_offset}`;
+    if (visited.has(mark))
+      throw new UsageError([READ_USAGE.paging]);
+    visited.add(mark);
+    first = await sessionPlaces(target, { ...pinned, offset: first.next_offset, component_offset: 0 });
+  }
+}
+async function allCompare(target, result, size) {
+  let response = result;
+  const visited = new Set;
+  for (;; ) {
+    if (response.windows.some((w) => w.components && !w.component_page))
+      throw new UsageError([READ_USAGE.paging]);
+    const offsets = response.windows.flatMap((w) => w.component_page?.page.next_offset ?? []);
+    if (!offsets.length)
+      break;
+    const offset = Math.min(...offsets);
+    if (visited.has(offset))
+      throw new UsageError([READ_USAGE.paging]);
+    visited.add(offset);
+    response = await compareRuns(target, result.a.id, result.b.id, { component_offset: offset, component_limit: size });
+    for (const w of result.windows) {
+      const c = w.component_page;
+      if (!c && !w.components)
+        continue;
+      const more = response.windows.find((x) => x.window === w.window)?.component_page;
+      if (!c || !more)
+        throw new UsageError([READ_USAGE.paging]);
+      const keys = new Set(c.rows.map((row) => row.key));
+      c.rows.push(...more.rows.filter((row) => !keys.has(row.key)));
+      for (const field of ["added", "removed"]) {
+        const existing = c[field] ?? [];
+        const known = new Set(existing.map((row) => row.key));
+        c[field] = [...existing, ...(more[field] ?? []).filter((row) => !known.has(row.key))];
+      }
+      for (const side of ["a", "b"]) {
+        if (!c.uncompared || !more.uncompared)
+          continue;
+        const known = new Set(c.uncompared[side].map((row) => row.key));
+        c.uncompared[side].push(...more.uncompared[side].filter((row) => !known.has(row.key)));
+      }
+      c.page = more.page;
+    }
+  }
+  for (const w of result.windows) {
+    const c = w.component_page;
+    if (!c)
+      continue;
+    const count = c.rows.length + (c.added?.length ?? 0) + (c.removed?.length ?? 0) + (c.uncompared?.a.length ?? 0) + (c.uncompared?.b.length ?? 0);
+    if (count !== c.page.total)
+      throw new UsageError([READ_USAGE.paging]);
+    c.page = { ...c.page, offset: 0, limit: count, next_offset: null };
+  }
+  return result;
+}
 
 // apps/agent/src/cli.ts
 var USAGE = `keepsnappy <command>
@@ -12354,6 +12867,8 @@ var USAGE = `keepsnappy <command>
           [--upload [--wait] [--fail-on-worse] [--ingest-url URL] [--commit SHA] [--branch NAME] [--base-commit SHA]]
           [--device-model NAME --device-os VERSION] [--scenario NAME] [--replay <out dir>[:ARM] ...]
           [--no-markers] [-- <e2e command...>]
+          (--fail-on-worse: exit 3 only when the verdict computed on that run set is Worse and blocking; closing never computes one,
+           so with no computed verdict it checks nothing: "Verdict not computed yet (computed on demand): --fail-on-worse checked nothing", exit 0)
   measure --repeat N [--arms A=<app|bundle>,B=<app|bundle>] [--arm-env 'A:KEY=VAL' ...] [--bundle-id ID] [--platform ios-sim|ios-device]
           [--device UDID] [--out DIR] [--timeout SEC] [--ri-capture observations.ndjson] [--mem-window NAME]
           [--clock-offset-ms N] [--no-markers]
@@ -12366,6 +12881,7 @@ var USAGE = `keepsnappy <command>
              [--driver appium --journey-module FILE] [--driver-version V] [--app-build-id ID] [--harness-version V] [--journey-version V] [--flag-set LABEL]   (setup fingerprint, plan 51)
              [--sdk-args k=v&...]   (over the run defaults profile=1 diag=1; tokens.js carries them to the flows' activation link)
   farm close --state <file> [--wait [--fail-on-worse]] [--bs-build browserstack.ios.json] [--settle-seconds 60] [--max-wait-seconds 300] [--out DIR]
+             (--fail-on-worse as for run: with no verdict computed on the run set it checks nothing)
   farm run   --app <eas:ID|file.ipa|file.apk|bs://ID|custom_id:ID> --journeys a,b [--repeat 5] --device "iPhone 15 Pro-17" [--platform ios|android] [--driver maestro|appium]
              [--tunnel-for localhost:PORT ...] [--env KEY=VALUE ...] (values may use {tunnel:PORT} {run_id} {out} {tokens_js} {run_set_id})
              maestro: --suite-dir DIR --execute FLOW [--tokens-path flows/keepsnappy/tokens.js] [--maestro-version V]
@@ -12408,74 +12924,80 @@ async function main2(argv) {
   if (cmd && LINK_COMMANDS.has(cmd))
     return linksCommand(cmd, rest, { print: console.log });
   const deps = nodeDeps();
-  const { values: o, positionals } = parseArgs4({
-    args: rest,
-    allowPositionals: true,
-    options: {
-      repeat: { type: "string" },
-      arms: { type: "string" },
-      "arm-env": { type: "string", multiple: true },
-      platform: { type: "string" },
-      device: { type: "string" },
-      out: { type: "string" },
-      "bundle-id": { type: "string" },
-      timeout: { type: "string" },
-      reps: { type: "string" },
-      boot: { type: "string" },
-      "ri-capture": { type: "string" },
-      "mem-window": { type: "string" },
-      "clock-offset-ms": { type: "string" },
-      "no-markers": { type: "boolean" },
-      config: { type: "string" },
-      upload: { type: "boolean" },
-      "ingest-url": { type: "string" },
-      commit: { type: "string" },
-      branch: { type: "string" },
-      "base-commit": { type: "string" },
-      wait: { type: "boolean" },
-      "fail-on-worse": { type: "boolean" },
-      scenario: { type: "string" },
-      "device-model": { type: "string" },
-      "device-os": { type: "string" },
-      "device-id": { type: "string" },
-      replay: { type: "string", multiple: true },
-      api: { type: "string" },
-      "key-env": { type: "string" },
-      "device-provider": { type: "string" },
-      journeys: { type: "string" },
-      "tokens-js": { type: "string" },
-      state: { type: "string" },
-      "ttl-seconds": { type: "string" },
-      "bs-build": { type: "string" },
-      "settle-seconds": { type: "string" },
-      "max-wait-seconds": { type: "string" },
-      flows: { type: "string" },
-      "completion-marker": { type: "boolean" },
-      "driver-version": { type: "string" },
-      "app-build-id": { type: "string" },
-      "harness-version": { type: "string" },
-      "journey-version": { type: "string" },
-      "flag-set": { type: "string" },
-      app: { type: "string" },
-      driver: { type: "string" },
-      "tunnel-for": { type: "string", multiple: true },
-      env: { type: "string", multiple: true },
-      "driver-script": { type: "string" },
-      "journey-module": { type: "string" },
-      "driver-arg": { type: "string", multiple: true },
-      "suite-dir": { type: "string" },
-      execute: { type: "string" },
-      "tokens-path": { type: "string" },
-      "maestro-version": { type: "string" },
-      "timeout-minutes": { type: "string" },
-      "kill-after-seconds": { type: "string" },
-      "poll-seconds": { type: "string" },
-      "custom-id": { type: "string" },
-      "run-id": { type: "string" },
-      "dry-run": { type: "boolean" },
-      "sdk-args": { type: "string" }
+  const { values: o, positionals } = (() => {
+    try {
+      return parseArgs4({
+        args: rest,
+        allowPositionals: true,
+        options: {
+          repeat: { type: "string" },
+          arms: { type: "string" },
+          "arm-env": { type: "string", multiple: true },
+          platform: { type: "string" },
+          device: { type: "string" },
+          out: { type: "string" },
+          "bundle-id": { type: "string" },
+          timeout: { type: "string" },
+          reps: { type: "string" },
+          boot: { type: "string" },
+          "ri-capture": { type: "string" },
+          "mem-window": { type: "string" },
+          "clock-offset-ms": { type: "string" },
+          "no-markers": { type: "boolean" },
+          config: { type: "string" },
+          upload: { type: "boolean" },
+          "ingest-url": { type: "string" },
+          commit: { type: "string" },
+          branch: { type: "string" },
+          "base-commit": { type: "string" },
+          wait: { type: "boolean" },
+          "fail-on-worse": { type: "boolean" },
+          scenario: { type: "string" },
+          "device-model": { type: "string" },
+          "device-os": { type: "string" },
+          "device-id": { type: "string" },
+          replay: { type: "string", multiple: true },
+          api: { type: "string" },
+          "key-env": { type: "string" },
+          "device-provider": { type: "string" },
+          journeys: { type: "string" },
+          "tokens-js": { type: "string" },
+          state: { type: "string" },
+          "ttl-seconds": { type: "string" },
+          "bs-build": { type: "string" },
+          "settle-seconds": { type: "string" },
+          "max-wait-seconds": { type: "string" },
+          flows: { type: "string" },
+          "completion-marker": { type: "boolean" },
+          "driver-version": { type: "string" },
+          "app-build-id": { type: "string" },
+          "harness-version": { type: "string" },
+          "journey-version": { type: "string" },
+          "flag-set": { type: "string" },
+          app: { type: "string" },
+          driver: { type: "string" },
+          "tunnel-for": { type: "string", multiple: true },
+          env: { type: "string", multiple: true },
+          "driver-script": { type: "string" },
+          "journey-module": { type: "string" },
+          "driver-arg": { type: "string", multiple: true },
+          "suite-dir": { type: "string" },
+          execute: { type: "string" },
+          "tokens-path": { type: "string" },
+          "maestro-version": { type: "string" },
+          "timeout-minutes": { type: "string" },
+          "kill-after-seconds": { type: "string" },
+          "poll-seconds": { type: "string" },
+          "custom-id": { type: "string" },
+          "run-id": { type: "string" },
+          "dry-run": { type: "boolean" },
+          "sdk-args": { type: "string" }
+        }
+      });
+    } catch (e) {
+      throw new UsageError([e.message, "keepsnappy --help lists the commands and their flags"]);
     }
-  });
+  })();
   if (cmd === "doctor") {
     console.log(formatChecks(await doctor(deps.spawner, process.version)));
     return 0;
@@ -12495,12 +13017,12 @@ async function main2(argv) {
   if (cmd === "measure") {
     const repeat = Number(o.repeat);
     if (!Number.isInteger(repeat) || repeat < 1)
-      throw new Error("--repeat N (>= 1) is required");
+      throw new ConfigError(["--repeat N (>= 1) is required"]);
     const platform = o.platform ?? "ios-sim";
     if (platform !== "ios-sim" && platform !== "ios-device")
-      throw new Error(`unknown --platform ${platform}`);
+      throw new ConfigError([`unknown --platform ${platform}`]);
     if (platform === "ios-device" && !o.device)
-      throw new Error("--device <udid> is required for ios-device");
+      throw new ConfigError(["--device <udid> is required for ios-device"]);
     const arms = parseArmEnv(o["arm-env"], parseArms(o.arms));
     const out = resolve8(o.out ?? `keepsnappy-${new Date().toISOString().replace(/[:.]/g, "-")}`);
     const udid = o.device ?? "booted";
@@ -12534,7 +13056,7 @@ async function main2(argv) {
   if (cmd === "extract") {
     const dir = positionals[0];
     if (!dir)
-      throw new Error("extract needs <out-dir>");
+      throw new ConfigError(["extract needs <out-dir>"]);
     const ri = o["ri-capture"] ? new FileRiSource(deps, resolve8(o["ri-capture"])) : undefined;
     const rows = await extract(deps, resolve8(dir), ri, o["mem-window"], o["clock-offset-ms"] ? Number(o["clock-offset-ms"]) : undefined);
     console.log(`${rows.length} rows -> ${resolve8(dir, "metrics.csv")}`);
@@ -12543,7 +13065,7 @@ async function main2(argv) {
   if (cmd === "aa") {
     const dir = positionals[0];
     if (!dir)
-      throw new Error("aa needs <out-dir>");
+      throw new ConfigError(["aa needs <out-dir>"]);
     const config = { ...o.reps ? { reps: Number(o.reps) } : {}, ...o.boot ? { nBoot: Number(o.boot) } : {} };
     console.log((await aa(deps, resolve8(dir), { config })).table);
     return 0;