@koda-sl/baker-cli 0.328.0 → 0.330.0

package/dist/cli.js

@@ -578,12 +578,24 @@ var registry = /* @__PURE__ */ new Map();
 function registerSchema(schema) {
   registry.set(schema.command, schema);
 }
-function getSchema(command) {
-  return registry.get(command);
-}
 function listSchemas() {
   return [...registry.keys()];
 }
+function spellingKey(name) {
+  return name.toLowerCase().replaceAll("-", "");
+}
+function resolveSchemaName(words2, names) {
+  const joined = words2.join(".");
+  if (names.includes(joined)) {
+    return joined;
+  }
+  const matches = names.filter((name) => spellingKey(name) === spellingKey(joined));
+  return matches.length === 1 ? matches[0] : void 0;
+}
+function findSchema(words2) {
+  const name = resolveSchemaName(words2, listSchemas());
+  return name === void 0 ? void 0 : registry.get(name);
+}
 
 // ../api/src/actions.ts
 import { z } from "zod";
@@ -1626,11 +1638,11 @@ var trackingParamsSetSchema = z3.object({
       message: `${both.join(", ")} is set as both a dynamic and a fixed parameter \u2014 LinkedIn appends each key once, so keep only one`
     });
   }
-  const count = Object.keys(p.dynamicValueParameters ?? {}).length + Object.keys(p.customValueParameters ?? {}).length;
-  if (count > LINKEDIN_LIMITS.trackingParams.parametersMax) {
+  const count2 = Object.keys(p.dynamicValueParameters ?? {}).length + Object.keys(p.customValueParameters ?? {}).length;
+  if (count2 > LINKEDIN_LIMITS.trackingParams.parametersMax) {
     ctx.addIssue({
       code: "custom",
-      message: `${count} parameters \u2014 keep it under ${LINKEDIN_LIMITS.trackingParams.parametersMax}`
+      message: `${count2} parameters \u2014 keep it under ${LINKEDIN_LIMITS.trackingParams.parametersMax}`
     });
   }
 });
@@ -1937,8 +1949,8 @@ var leadFormQuestionSchema = z3.object({
     });
   }
   if (q.questionType === "MULTIPLE_CHOICE") {
-    const count = q.options?.length ?? 0;
-    if (count < LEAD.choiceOptionsMin || count > LEAD.choiceOptionsMax) {
+    const count2 = q.options?.length ?? 0;
+    if (count2 < LEAD.choiceOptionsMin || count2 > LEAD.choiceOptionsMax) {
       ctx.addIssue({
         code: "custom",
         path: ["options"],
@@ -10672,23 +10684,23 @@ var FALSE_RANGE_PATTERNS = [
   /\bdesde\s+([^,.;]{3,30}?)\s+hasta\s+([^,.;]{3,30}?)(?=[,.;]|$)/gi
 ];
 function countFalseRanges(text2) {
-  let count = 0;
+  let count2 = 0;
   let first = "";
   for (const re2 of FALSE_RANGE_PATTERNS) {
     for (const m of text2.matchAll(re2)) {
       const left = m[1] ?? "";
       const right = m[2] ?? "";
       if (/\d/.test(left) || /\d/.test(right)) continue;
-      count++;
+      count2++;
       if (!first) first = m[0] ?? "";
     }
   }
-  return { count, first };
+  return { count: count2, first };
 }
 function countStaccato(text2) {
   const sentences = text2.split(/(?<=[.!?])\s+/).map((s) => s.trim()).filter(Boolean);
   let run = 0;
-  let count = 0;
+  let count2 = 0;
   let first = "";
   let runStart = 0;
   for (const [i, s] of sentences.entries()) {
@@ -10697,17 +10709,17 @@ function countStaccato(text2) {
       if (run === 0) runStart = i;
       run++;
       if (run === STACCATO_RUN) {
-        count++;
+        count2++;
         if (!first) first = sentences.slice(runStart, i + 1).join(" ");
       }
     } else {
       run = 0;
     }
   }
-  return { count, first };
+  return { count: count2, first };
 }
 function countTitleCaseHeadings(text2) {
-  let count = 0;
+  let count2 = 0;
   let first = "";
   for (const m of text2.matchAll(/^\s{0,3}#{1,6}\s+(.+)$/gm)) {
     const heading = (m[1] ?? "").trim();
@@ -10715,10 +10727,10 @@ function countTitleCaseHeadings(text2) {
     if (words2.length < 4) continue;
     const capitalized = words2.filter((w) => new RegExp("^\\p{Lu}", "u").test(w)).length;
     if (capitalized / words2.length < 0.8) continue;
-    count++;
+    count2++;
     if (!first) first = heading;
   }
-  return { count, first };
+  return { count: count2, first };
 }
 function countInlineHeaderList(text2) {
   const matches = [...text2.matchAll(/^\s*(?:[-*+]|\d+\.)\s+\*\*[^*\n]{2,40}:?\*\*:?\s/gm)];
@@ -10728,15 +10740,15 @@ function countInlineHeaderList(text2) {
 var EMOJI = /[\u{1F300}-\u{1FAFF}]|[\u{2600}-\u{27BF}]|[\u{1F000}-\u{1F2FF}]|\u{FE0F}/gu;
 var CURLY = /[‘’“”]/g;
 function countPhraseTell(text2, id, phrases) {
-  let count = 0;
+  let count2 = 0;
   let first = "";
   for (const phrase of phrases) {
     for (const m of text2.matchAll(matcherFor(id, phrase))) {
-      count++;
+      count2++;
       if (!first) first = m[0] ?? "";
     }
   }
-  return { count, first };
+  return { count: count2, first };
 }
 function countPattern(text2, re2) {
   const matches = text2.match(re2) ?? [];
@@ -10974,7 +10986,7 @@ function renderOutcome(data, lines) {
     const status = op.result?.status ?? "pending";
     counts.set(status, (counts.get(status) ?? 0) + 1);
   }
-  const summary = [...counts].map(([status, count]) => `${count} ${status}`).join(", ");
+  const summary = [...counts].map(([status, count2]) => `${count2} ${status}`).join(", ");
   lines.push(`Google Ads \u2014 published \xB7 ${summary || `${data.count} op(s)`} \xB7 ${data.mode}`);
   for (const op of data.ops) {
     const status = op.result?.status;
@@ -11976,11 +11988,11 @@ function renderKeywordLimits(limits) {
   const sentences = REASON_ORDER.filter((reason) => limits.detailsByReason.has(reason)).map(
     (reason) => describeLimit(reason, limits.detailsByReason.get(reason) ?? [])
   );
-  const count = limits.keywords.size;
+  const count2 = limits.keywords.size;
   return [
     {
       code: "KEYWORD_SERVING_LIMITED",
-      message: `${count} ${count === 1 ? "keyword is" : "keywords are"} limited and not getting the traffic they could. ${sentences.join(" ")} Amounts are in the account currency (baker ads google currency).`
+      message: `${count2} ${count2 === 1 ? "keyword is" : "keywords are"} limited and not getting the traffic they could. ${sentences.join(" ")} Amounts are in the account currency (baker ads google currency).`
     }
   ];
 }
@@ -16678,11 +16690,11 @@ function nestAddressFlags(row) {
 }
 function readNumericFlags(args4, row) {
   if (args4["conversion-count"] !== void 0 && args4["conversion-count"] !== "") {
-    const count = Number(args4["conversion-count"]);
-    if (!Number.isInteger(count) || count < 1) {
+    const count2 = Number(args4["conversion-count"]);
+    if (!Number.isInteger(count2) || count2 < 1) {
       failWriteValidation("--conversion-count must be a whole number of conversions, e.g. 3");
     }
-    row.conversionCount = count;
+    row.conversionCount = count2;
   }
   if (args4.value !== void 0 && args4.value !== "") {
     const numeric = Number(args4.value);
@@ -17243,12 +17255,12 @@ function keywordKillHints(status) {
   const kills = typeof status === "string" && ["PAUSED", "REMOVED"].includes(status.toUpperCase());
   return kills ? KEYWORD_KILL_HINTS : [];
 }
-function keywordFinalUrlHints(finalUrl, count) {
+function keywordFinalUrlHints(finalUrl, count2) {
   if (typeof finalUrl !== "string" || finalUrl.length === 0) {
     return [];
   }
-  return count > 1 ? [
-    `--final-url applied the same landing page to all ${count} keywords \u2014 the flag has no per-keyword form. A keyword-level URL only earns its place when that keyword must land somewhere the ad doesn't, so one URL shared by every keyword belongs on the ad instead: set the ad's final URL to this page and re-stage the keywords without --final-url. Keep it only if this page is genuinely each keyword's own destination and not the ad's.`
+  return count2 > 1 ? [
+    `--final-url applied the same landing page to all ${count2} keywords \u2014 the flag has no per-keyword form. A keyword-level URL only earns its place when that keyword must land somewhere the ad doesn't, so one URL shared by every keyword belongs on the ad instead: set the ad's final URL to this page and re-stage the keywords without --final-url. Keep it only if this page is genuinely each keyword's own destination and not the ad's.`
   ] : [
     "Keep --final-url only if this keyword's destination differs from the ad's final URL \u2014 otherwise drop it and let the keyword inherit the ad's landing page."
   ];
@@ -21849,7 +21861,7 @@ function renderOutcome2(data, lines) {
     const status = op.result?.status ?? "pending";
     counts.set(status, (counts.get(status) ?? 0) + 1);
   }
-  const summary = [...counts].map(([status, count]) => `${count} ${status}`).join(", ");
+  const summary = [...counts].map(([status, count2]) => `${count2} ${status}`).join(", ");
   lines.push(`LinkedIn Ads \u2014 published \xB7 ${summary || `${data.count} op(s)`} \xB7 ${data.mode}`);
   for (const op of data.ops ?? []) {
     const status = op.result?.status;
@@ -26986,12 +26998,12 @@ function compact(payload) {
   return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== void 0));
 }
 function batchNudge2(data) {
-  const count = data?.sameKindStaged;
-  if (!count) {
+  const count2 = data?.sameKindStaged;
+  if (!count2) {
     return [];
   }
   return [
-    `${count} other change${count === 1 ? "" : "s"} of this kind and payload ${count === 1 ? "is" : "are"} already staged \u2014 pass every id to one call (\`--ids a,b,c\`) instead of one call each.`
+    `${count2} other change${count2 === 1 ? "" : "s"} of this kind and payload ${count2 === 1 ? "is" : "are"} already staged \u2014 pass every id to one call (\`--ids a,b,c\`) instead of one call each.`
   ];
 }
 async function stageXOp(raw, hints2) {
@@ -35848,14 +35860,14 @@ function canvasDims(ar) {
 function fillPanel(label, w, h, out) {
   return `[${label}]scale=${w}:${h}:force_original_aspect_ratio=increase,crop=${w}:${h},setsar=1,fps=30[${out}]`;
 }
-function splitStackArgs(count, axis, dims) {
+function splitStackArgs(count2, axis, dims) {
   const span = axis === "horizontal" ? dims.w : dims.h;
-  const base = Math.floor(span / count / 2) * 2;
-  const sizeAt = (i) => i === count - 1 ? span - base * (count - 1) : base;
+  const base = Math.floor(span / count2 / 2) * 2;
+  const sizeAt = (i) => i === count2 - 1 ? span - base * (count2 - 1) : base;
   const inputs = [];
   const filt = [];
   let labels = "";
-  for (let i = 0; i < count; i++) {
+  for (let i = 0; i < count2; i++) {
     inputs.push("-i", `{{in.c${i}}}`);
     const pw = axis === "horizontal" ? sizeAt(i) : dims.w;
     const ph = axis === "vertical" ? sizeAt(i) : dims.h;
@@ -35863,7 +35875,7 @@ function splitStackArgs(count, axis, dims) {
     labels += `[p${i}]`;
   }
   const stack = axis === "vertical" ? "vstack" : "hstack";
-  filt.push(`${labels}${stack}=inputs=${count}[v]`);
+  filt.push(`${labels}${stack}=inputs=${count2}[v]`);
   return [...inputs, "-filter_complex", filt.join(";"), "-map", "[v]", "{{out.video}}"];
 }
 function overlayXY(position, marginPx) {
@@ -42537,13 +42549,13 @@ async function markDirectoryIsReal(dir) {
 var INK_ALPHA = 128;
 function inkLuma(rgba) {
   let sum = 0;
-  let count = 0;
+  let count2 = 0;
   for (let i = 0; i + 3 < rgba.length; i += 4) {
     if (rgba[i + 3] < INK_ALPHA) continue;
     sum += 0.2126 * rgba[i] + 0.7152 * rgba[i + 1] + 0.0722 * rgba[i + 2];
-    count += 1;
+    count2 += 1;
   }
-  return count === 0 ? null : sum / count;
+  return count2 === 0 ? null : sum / count2;
 }
 var LIGHT_INK_LUMA = 170;
 async function markInkIsLight(markPath) {
@@ -45008,185 +45020,6 @@ async function foldExperiment(root, target) {
   };
 }
 
-// src/commands/experiment/hints.ts
-var LIVE_HINT = {
-  keep_running: (row) => `${row.experimentId} cannot yet tell the two pages apart \u2014 do not read its numbers as a result, and do not end it hoping for one. ${describeWait(row)}`,
-  winner: (row) => row.winner === "variant" ? `${row.experimentId} has a winner: the new variant. Run \`baker experiment finish --id ${row.experimentId} --keep variant\` to show it to everyone, then \`baker experiment fold\`.` : `${row.experimentId} has a winner: the page as it is. Run \`baker experiment finish --id ${row.experimentId} --keep original\` to put all the traffic back on it.`,
-  no_difference: (row) => `${row.experimentId} measured the two pages as alike \u2014 it collected enough traffic to see the change it was looking for, and there was none. End it with \`--keep original\` and test a bigger change \u2014 a headline, an offer, the shape of the page, not a button colour.`,
-  stopped_early_harmful: (row) => `${row.experimentId} is doing damage and is STILL being shown to visitors. Run \`baker experiment finish --id ${row.experimentId} --keep original\` now.`,
-  // Unreachable on a live test — only ending one produces it. The Record is
-  // exhaustive by type so a verdict added upstream fails to compile here rather
-  // than printing nothing.
-  inconclusive: (row) => `${row.experimentId} was ended before it concluded and found nothing.`,
-  invalid: (row) => `${row.experimentId} cannot be read: ${row.invalidReason === "crossover" ? "too many visitors saw both versions" : "the traffic did not split evenly"}. End it with \`--keep original\` and start again rather than reporting anything from it.`
-};
-function describeWait(row) {
-  if (row.willNotConclude) {
-    return "This page's traffic will not settle it at any point, so end it with `--keep original` and test a bigger change.";
-  }
-  if (row.earliestDecisionAt === null) {
-    return "This page has produced no visitors yet, so there is nothing to project a finish date from.";
-  }
-  return `Earliest it could say anything: ${new Date(row.earliestDecisionAt).toISOString().slice(0, 10)}.`;
-}
-function pausedNote(row) {
-  return row.status === "paused" ? `${row.experimentId} is paused \u2014 everyone sees the original. \`baker experiment resume --id ${row.experimentId}\` restarts the split with the same sides. ` : "";
-}
-function unlearnedHint(experiments) {
-  const unlearned = experiments.filter(
-    (row) => row.status === "finished" && row.learning === null && row.verdict !== "inconclusive"
-  );
-  if (unlearned.length === 0) return null;
-  const ids = unlearned.map((row) => row.experimentId).join(", ");
-  return `${unlearned.length === 1 ? "One finished test has" : `${unlearned.length} finished tests have`} no learning written down yet (${ids}). Say what it taught in one or two sentences \u2014 what the client should believe about this page now \u2014 with \`baker experiment update --id <id> --learning "\u2026"\`. It is what \`plan\` hands the next test.`;
-}
-function buildStatusHints(experiments) {
-  const hints2 = experiments.filter((row) => row.status !== "finished").map((row) => pausedNote(row) + LIVE_HINT[row.verdict](row));
-  const unlearned = unlearnedHint(experiments);
-  if (unlearned) hints2.push(unlearned);
-  if (experiments.length === 0) {
-    hints2.push(
-      "No tests yet. `baker experiment plan --landing <slug> --variant <slug>` says whether a page has enough traffic for one before you build the alternative."
-    );
-  }
-  return hints2;
-}
-function asLift(value) {
-  return `+${Math.round(value * 100)}%`;
-}
-function horizonsHint(plan) {
-  const settled = plan.horizons.filter((horizon) => horizon.detectableLift !== null);
-  if (settled.length === 0) {
-    return "At this page's traffic no window up to 90 days would gather enough visitors to settle anything, at any size of change. The constraint is the traffic, not the test.";
-  }
-  const parts = settled.map((horizon) => `${horizon.days} days \u2192 ${asLift(horizon.detectableLift ?? 0)}`);
-  return `The smallest change each window could settle on this page's traffic: ${parts.join(", ")}. Design the alternative to be at least that different.`;
-}
-function conversionsHint(plan) {
-  if (plan.conversions.length <= 1) return null;
-  const others = plan.conversions.filter((entry) => entry.eventKey !== plan.goal);
-  return `This page's visitors also went on to: ${others.map((entry) => `\`${entry.eventKey}\`${entry.name ? ` (\u201C${entry.name}\u201D)` : ""} \u2014 ${entry.convertingVisitors}`).join(
-    ", "
-  )}. Any of them can be the goal (--goal <key>); the named ones are reported beside it on every result, and decide nothing.`;
-}
-function pastTestLine(test) {
-  const outcome = {
-    supported: "the idea held",
-    refuted_opposite: "the idea was WRONG \u2014 the change made it worse",
-    refuted_no_effect: "no difference \u2014 the change did not matter",
-    unanswered: "never answered"
-  };
-  const kept = test.survivor === "variant" ? "the new version was kept" : "the original was kept";
-  const learning = test.learning ? ` Learning: ${test.learning}` : "";
-  return `\u201C${test.hypothesis.change}\u201D (${test.experimentId}, ${test.ranForDays} days): ${outcome[test.hypothesisOutcome]}; ${kept}${test.againstVerdict ? " against the numbers" : ""}.${learning}`;
-}
-function pastTestsHint(plan) {
-  if (plan.pastTests.length === 0) return null;
-  const lines = plan.pastTests.slice(0, 5).map(pastTestLine);
-  const more = plan.pastTests.length > 5 ? ` \u2026and ${plan.pastTests.length - 5} more \u2014 \`baker experiment history --landing <slug>\` lists them all.` : "";
-  return `This page has been tested before \u2014 read this before choosing what to change, and build on it rather than repeating it: ${lines.join(" ")}${more}`;
-}
-function buildPlanHints(plan) {
-  const horizons = horizonsHint(plan);
-  const past = pastTestsHint(plan);
-  if (!plan.canRun) {
-    return [
-      plan.reason ?? "This test cannot run on this page.",
-      ...horizons && plan.visitors > 0 ? [horizons] : [],
-      ...past ? [past] : [],
-      "A test that cannot conclude is worse than no test \u2014 it still produces a number, and somebody acts on it."
-    ];
-  }
-  const hints2 = [
-    ...past ? [past] : [],
-    // First, because it changes how every number below should be read: a plan
-    // sized on a stand-in is a guide, and the agent must say so to the client
-    // rather than quote "about 70 days" as though it were measured.
-    ...plan.warning ? [plan.warning] : [],
-    `This test is read on \u201C${plan.goal}\u201D. That is fixed when it starts and cannot be changed later.`,
-    // Fires at the exact moment the hypothesis gets invented, whether or not
-    // the agent read the family doc. `plan` says a question CAN be settled here
-    // and says nothing about which question is worth asking — and a well-run
-    // test of a bad idea spends the page's traffic and returns `no_difference`.
-    "Now decide WHAT to change, from evidence rather than taste. These numbers say which page and which step; they cannot say why. A second opinion answers why \u2014 Microsoft Clarity for what visitors actually do on the page, `baker gsc` for what they searched, `baker ads <platform>` for what the ad promised, `baker ga4` for the client's own measurement. `baker capabilities` lists everything this client has in one call. Message match \u2014 what the ad or the search promised against what the page opens with \u2014 is the cheapest hypothesis worth testing and is wrong surprisingly often.",
-    // The base always works, so a missing integration is never a reason to
-    // stop. Naming what it would have shown is worth more to the client than
-    // either a silent gap or a run that waited.
-    "If none of that is connected, this page's own drop-off is enough to test on \u2014 say which source you lacked and what it would have told you, then run the test anyway. A test never waits on an integration."
-  ];
-  const conversions = conversionsHint(plan);
-  if (conversions) hints2.push(conversions);
-  if (plan.estimatedDays !== null && plan.estimatedDays > 60) {
-    hints2.push(
-      `At this page's recent traffic it would take about ${plan.estimatedDays} days \u2014 a guide, not a limit: it ends when the numbers are clear, and more traffic (a campaign, ads) shortens it. If the traffic will stay as it is, test a bigger change, which needs fewer visitors to detect.`
-    );
-  }
-  if (horizons) hints2.push(horizons);
-  return hints2;
-}
-function buildHistoryHints(tests, landing) {
-  if (tests.length === 0) {
-    return [
-      landing ? `No finished test on \u201C${landing}\u201D yet \u2014 nothing to build on, and nothing to avoid repeating. \`baker experiment plan\` says whether the page can settle one.` : "No finished tests yet. `baker experiment plan --landing <slug> --variant <slug>` says whether a page can settle one."
-    ];
-  }
-  const hints2 = [];
-  const supported = tests.filter((test) => test.hypothesisOutcome === "supported");
-  const refuted = tests.filter((test) => test.hypothesisOutcome === "refuted_opposite");
-  const noEffect = tests.filter((test) => test.hypothesisOutcome === "refuted_no_effect");
-  if (supported.length > 0) {
-    hints2.push(
-      `Held: ${supported.map((test) => `\u201C${test.hypothesis.change}\u201D on ${test.landingSlug}`).join("; ")}. Build on these \u2014 the same insight usually has more in it.`
-    );
-  }
-  if (refuted.length > 0) {
-    hints2.push(
-      `Made it worse: ${refuted.map((test) => `\u201C${test.hypothesis.change}\u201D on ${test.landingSlug}`).join("; ")}. Do not propose these again as they were; the observation behind each may still be right, the change was not.`
-    );
-  }
-  if (noEffect.length > 0) {
-    hints2.push(
-      `Did not matter: ${noEffect.map((test) => `\u201C${test.hypothesis.change}\u201D on ${test.landingSlug}`).join("; ")}. The next change on these pages has to be bigger \u2014 a headline, an offer, the shape of the page.`
-    );
-  }
-  const unlearned = tests.filter((test) => test.learning === null && test.verdict !== "inconclusive");
-  if (unlearned.length > 0) {
-    hints2.push(
-      `${unlearned.length === 1 ? "One test has" : `${unlearned.length} tests have`} no learning written down (${unlearned.map((test) => test.experimentId).join(", ")}). Read its numbers and write one: \`baker experiment update --id <id> --learning "\u2026"\`.`
-    );
-  }
-  return hints2;
-}
-function buildStartHints(staged) {
-  const hints2 = [];
-  for (const entry of staged.drift) {
-    hints2.push(driftHint(staged, entry));
-  }
-  if (staged.composition && staged.composition.forked.length === 0) {
-    hints2.push(
-      `\u201C${staged.variant}\u201D does not have its own copy of any section \u2014 it renders exactly the same page as \u201C${staged.landing}\u201D, so this test cannot find anything. Fork the section you want to test (\`baker landing variant ${staged.landing} --fork Hero.astro\`) and edit only that file.`
-    );
-  }
-  if (staged.newForms.length > 0 && staged.variantGoal === void 0) {
-    const forms = staged.newForms.map((flow) => `\u201C${flow}\u201D`).join(", ");
-    hints2.push(
-      `\u201C${staged.variant}\u201D uses ${staged.newForms.length === 1 ? "a Form" : "Forms"} the page does not: ${forms}. The test reads the new version on \`${staged.goal}\`, the page's event \u2014 if the new version converts by reaching this Form's ending instead, it can never convert on that key and the test will call it harmful. Say its own event: \`baker experiment update --id <id> --variant-goal submit:${staged.newForms[0]}\` (or the confirmation step's \`form:${staged.newForms[0]}:<node>:<trigger>\` key, from \`baker analytics conversions --candidates\` once the Form has been opened in the preview).`
-    );
-  }
-  return hints2;
-}
-function driftHint(staged, entry) {
-  const suffix = ` Check both versions before reading that number, and give the new version's step its own name if it is not the same action (\`baker analytics conversions --candidates\`).`;
-  if (entry.reason === "trigger_differs") {
-    return `\u201C${staged.landing}\u201D and \u201C${staged.variant}\u201D both count \`${entry.name}\`, but one fires it when the element is **scrolled into view** and the other when the visitor **does something**. Those are two different questions with one answer, and the test will report a difference that is the trigger rather than the page.${suffix}`;
-  }
-  if (entry.reason === "variant_only_missing" || entry.reason === "control_only_missing") {
-    const missing = entry.reason === "variant_only_missing" ? staged.variant : staged.landing;
-    return `Only one version fires \`${entry.name}\` \u2014 \u201C${missing}\u201D does not declare it at all, so it can only ever read zero for that conversion and the comparison will look like a collapse.${suffix}`;
-  }
-  return `Both versions count \`${entry.name}\`, and the section the test changed is what fires it \u2014 the markup around it is not the same on the two pages. If the new version fires it on a different action (a block that is visible from the start rather than one the visitor opens), that conversion is comparing two different things.${suffix}`;
-}
-
 // ../api/src/experiments/composition.ts
 import { z as z41 } from "zod";
 var experimentCompositionSchema = z41.object({
@@ -45251,6 +45084,25 @@ var experimentHypothesisOutcomeSchema = z43.enum([
   "unanswered"
 ]);
 
+// ../api/src/experiments/wait.ts
+var DAY_MS5 = 24 * 60 * 60 * 1e3;
+function count(value, unit) {
+  return `about ${value} ${unit}${value === 1 ? "" : "s"}`;
+}
+function describeWait(earliestDecisionAt, now) {
+  const days = (earliestDecisionAt - now) / DAY_MS5;
+  if (days <= 0) return "any moment now";
+  if (days < 1) return "within a day";
+  if (days < 14) return count(Math.round(days), "day");
+  if (days < 60) return count(Math.round(days / 7), "week");
+  return count(Math.round(days / 30), "month");
+}
+function roughCount(count2) {
+  if (count2 < 10) return `about ${Math.max(1, Math.round(count2)).toLocaleString("en-US")}`;
+  const magnitude = 10 ** Math.max(1, Math.floor(Math.log10(count2)) - 1);
+  return `about ${(Math.round(count2 / magnitude) * magnitude).toLocaleString("en-US")}`;
+}
+
 // ../api/src/experiments/wire.ts
 import { z as z44 } from "zod";
 var slugSchema = z44.string().min(1).max(120).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "Use a page slug, like `oferta`");
@@ -45470,7 +45322,17 @@ var experimentVerdictSchema = z44.enum([
   "keep_running",
   "winner",
   "no_difference",
+  /**
+   * Even the best case is under the lift the test was built to find, so there
+   * is nothing left for it to discover: keep the original. The "is this a
+   * failure" answer — not proven worse, but proven not worth running.
+   */
+  "cannot_win",
   "invalid",
+  /**
+   * Only on tests read before the stopping rule was one interval: a version
+   * proven worse is now `winner` with `winner: "control"`, whenever it is seen.
+   */
   "stopped_early_harmful",
   /**
    * Ended before the numbers could say anything. Never produced by the
@@ -45615,6 +45477,14 @@ var experimentStatusRowSchema = z44.object({
   precision: z44.number(),
   /** When the test could first say something. `null` with no traffic to project from. */
   earliestDecisionAt: z44.number().nullable(),
+  /**
+   * What the test is still missing before its verdict changes, if the gap it
+   * is seeing holds: visitors across both arms, and the conversions they bring.
+   * A test is gated on data, never on days — `earliestDecisionAt` is only this
+   * divided by the page's pace. Null once it has spoken, before anyone has
+   * arrived, or when no amount of traffic would settle it.
+   */
+  stillNeeded: z44.object({ visitors: z44.number(), conversions: z44.number() }).nullable().default(null),
   /**
    * True when no amount of this page's traffic would settle the comparison.
    * A different thing from a page that is merely slow, and the reason to end
@@ -45699,6 +45569,190 @@ var experimentFinishResponseSchema = z44.object({
   summary: z44.string()
 });
 
+// src/commands/experiment/hints.ts
+var LIVE_HINT = {
+  keep_running: (row, now) => `${row.experimentId} cannot yet tell the two pages apart \u2014 do not end it hoping for a result. ${describeWait2(row, now)} To the user, say only this in plain words: "${row.summary}" plus how much more data it needs and roughly when. Never quote confidence, chance-better or intervals to them \u2014 those numbers confuse marketers and decide nothing.`,
+  winner: (row) => row.winner === "variant" ? `${row.experimentId} has a winner: the new variant. Run \`baker experiment finish --id ${row.experimentId} --keep variant\` to show it to everyone, then \`baker experiment fold\`.` : `${row.experimentId}: the new version is proven worse and is STILL being shown to half the visitors. Run \`baker experiment finish --id ${row.experimentId} --keep original\` now.`,
+  no_difference: (row) => `${row.experimentId} measured the two pages as alike \u2014 it collected enough traffic to see the change it was looking for, and there was none. End it with \`--keep original\` and test a bigger change \u2014 a headline, an offer, the shape of the page, not a button colour.`,
+  cannot_win: (row) => `${row.experimentId}: the new version cannot win \u2014 even its best case is under the lift this test was looking for, so there is nothing left to find. Run \`baker experiment finish --id ${row.experimentId} --keep original --reason numbers_clear\` and write down what it taught.`,
+  stopped_early_harmful: (row) => `${row.experimentId} is doing damage and is STILL being shown to visitors. Run \`baker experiment finish --id ${row.experimentId} --keep original\` now.`,
+  // Unreachable on a live test — only ending one produces it. The Record is
+  // exhaustive by type so a verdict added upstream fails to compile here rather
+  // than printing nothing.
+  inconclusive: (row) => `${row.experimentId} was ended before it concluded and found nothing.`,
+  invalid: (row) => `${row.experimentId} cannot be read: ${row.invalidReason === "crossover" ? "too many visitors saw both versions" : "the traffic did not split evenly"}. End it with \`--keep original\` and start again rather than reporting anything from it.`
+};
+function describeWait2(row, now) {
+  if (row.willNotConclude) {
+    return "This page's traffic will not settle it at any point, so end it with `--keep original` and test a bigger change.";
+  }
+  if (row.earliestDecisionAt === null) {
+    return "This page has produced no visitors yet, so there is nothing to project a finish date from.";
+  }
+  if (row.stillNeeded === null) {
+    return `It already has the data it needs; the verdict waits only until it has seen a full day of visitors \u2014 ${describeWait(row.earliestDecisionAt, now)}.`;
+  }
+  const needed = `It needs ${roughCount(row.stillNeeded.visitors)} more visitors (${roughCount(row.stillNeeded.conversions)} more conversions) for an answer if the gap holds \u2014 `;
+  return `${needed}${describeWait(row.earliestDecisionAt, now)} at today's traffic (${new Date(row.earliestDecisionAt).toISOString().slice(0, 10)}). A test is gated on this data, never on days.`;
+}
+function pausedNote(row) {
+  return row.status === "paused" ? `${row.experimentId} is paused \u2014 everyone sees the original. \`baker experiment resume --id ${row.experimentId}\` restarts the split with the same sides. ` : "";
+}
+function unlearnedHint(experiments) {
+  const unlearned = experiments.filter(
+    (row) => row.status === "finished" && row.learning === null && row.verdict !== "inconclusive"
+  );
+  if (unlearned.length === 0) return null;
+  const ids = unlearned.map((row) => row.experimentId).join(", ");
+  return `${unlearned.length === 1 ? "One finished test has" : `${unlearned.length} finished tests have`} no learning written down yet (${ids}). Say what it taught in one or two sentences \u2014 what the client should believe about this page now \u2014 with \`baker experiment update --id <id> --learning "\u2026"\`. It is what \`plan\` hands the next test.`;
+}
+function buildStatusHints(experiments, now = Date.now()) {
+  const hints2 = experiments.filter((row) => row.status !== "finished").map((row) => pausedNote(row) + LIVE_HINT[row.verdict](row, now));
+  const unlearned = unlearnedHint(experiments);
+  if (unlearned) hints2.push(unlearned);
+  if (experiments.length === 0) {
+    hints2.push(
+      "No tests yet. `baker experiment plan --landing <slug> --variant <slug>` says whether a page has enough traffic for one before you build the alternative."
+    );
+  }
+  return hints2;
+}
+function asLift(value) {
+  return `+${Math.round(value * 100)}%`;
+}
+function horizonsHint(plan) {
+  const settled = plan.horizons.filter((horizon) => horizon.detectableLift !== null);
+  if (settled.length === 0) {
+    return "At this page's traffic no window up to 90 days would gather enough visitors to settle anything, at any size of change. The constraint is the traffic, not the test.";
+  }
+  const parts = settled.map((horizon) => `${horizon.days} days \u2192 ${asLift(horizon.detectableLift ?? 0)}`);
+  return `The smallest change each window could settle on this page's traffic: ${parts.join(", ")}. Design the alternative to be at least that different.`;
+}
+function conversionsHint(plan) {
+  if (plan.conversions.length <= 1) return null;
+  const others = plan.conversions.filter((entry) => entry.eventKey !== plan.goal);
+  return `This page's visitors also went on to: ${others.map((entry) => `\`${entry.eventKey}\`${entry.name ? ` (\u201C${entry.name}\u201D)` : ""} \u2014 ${entry.convertingVisitors}`).join(
+    ", "
+  )}. Any of them can be the goal (--goal <key>); the named ones are reported beside it on every result, and decide nothing.`;
+}
+function pastTestLine(test) {
+  const outcome = {
+    supported: "the idea held",
+    refuted_opposite: "the idea was WRONG \u2014 the change made it worse",
+    refuted_no_effect: "no difference \u2014 the change did not matter",
+    unanswered: "never answered"
+  };
+  const kept = test.survivor === "variant" ? "the new version was kept" : "the original was kept";
+  const learning = test.learning ? ` Learning: ${test.learning}` : "";
+  return `\u201C${test.hypothesis.change}\u201D (${test.experimentId}, ${test.ranForDays} days): ${outcome[test.hypothesisOutcome]}; ${kept}${test.againstVerdict ? " against the numbers" : ""}.${learning}`;
+}
+function pastTestsHint(plan) {
+  if (plan.pastTests.length === 0) return null;
+  const lines = plan.pastTests.slice(0, 5).map(pastTestLine);
+  const more = plan.pastTests.length > 5 ? ` \u2026and ${plan.pastTests.length - 5} more \u2014 \`baker experiment history --landing <slug>\` lists them all.` : "";
+  return `This page has been tested before \u2014 read this before choosing what to change, and build on it rather than repeating it: ${lines.join(" ")}${more}`;
+}
+function buildPlanHints(plan) {
+  const horizons = horizonsHint(plan);
+  const past = pastTestsHint(plan);
+  if (!plan.canRun) {
+    return [
+      plan.reason ?? "This test cannot run on this page.",
+      ...horizons && plan.visitors > 0 ? [horizons] : [],
+      ...past ? [past] : [],
+      "A test that cannot conclude is worse than no test \u2014 it still produces a number, and somebody acts on it."
+    ];
+  }
+  const hints2 = [
+    ...past ? [past] : [],
+    // First, because it changes how every number below should be read: a plan
+    // sized on a stand-in is a guide, and the agent must say so to the client
+    // rather than quote "about 70 days" as though it were measured.
+    ...plan.warning ? [plan.warning] : [],
+    `This test is read on \u201C${plan.goal}\u201D. That is fixed when it starts and cannot be changed later.`,
+    // Fires at the exact moment the hypothesis gets invented, whether or not
+    // the agent read the family doc. `plan` says a question CAN be settled here
+    // and says nothing about which question is worth asking — and a well-run
+    // test of a bad idea spends the page's traffic and returns `no_difference`.
+    "Now decide WHAT to change, from evidence rather than taste. These numbers say which page and which step; they cannot say why. A second opinion answers why \u2014 Microsoft Clarity for what visitors actually do on the page, `baker gsc` for what they searched, `baker ads <platform>` for what the ad promised, `baker ga4` for the client's own measurement. `baker capabilities` lists everything this client has in one call. Message match \u2014 what the ad or the search promised against what the page opens with \u2014 is the cheapest hypothesis worth testing and is wrong surprisingly often.",
+    // The base always works, so a missing integration is never a reason to
+    // stop. Naming what it would have shown is worth more to the client than
+    // either a silent gap or a run that waited.
+    "If none of that is connected, this page's own drop-off is enough to test on \u2014 say which source you lacked and what it would have told you, then run the test anyway. A test never waits on an integration."
+  ];
+  const conversions = conversionsHint(plan);
+  if (conversions) hints2.push(conversions);
+  if (plan.estimatedDays !== null && plan.estimatedDays > 60) {
+    hints2.push(
+      `At this page's recent traffic it would take about ${plan.estimatedDays} days \u2014 a guide, not a limit: it ends when the numbers are clear, and more traffic (a campaign, ads) shortens it. If the traffic will stay as it is, test a bigger change, which needs fewer visitors to detect.`
+    );
+  }
+  if (horizons) hints2.push(horizons);
+  return hints2;
+}
+function buildHistoryHints(tests, landing) {
+  if (tests.length === 0) {
+    return [
+      landing ? `No finished test on \u201C${landing}\u201D yet \u2014 nothing to build on, and nothing to avoid repeating. \`baker experiment plan\` says whether the page can settle one.` : "No finished tests yet. `baker experiment plan --landing <slug> --variant <slug>` says whether a page can settle one."
+    ];
+  }
+  const hints2 = [];
+  const supported = tests.filter((test) => test.hypothesisOutcome === "supported");
+  const refuted = tests.filter((test) => test.hypothesisOutcome === "refuted_opposite");
+  const noEffect = tests.filter((test) => test.hypothesisOutcome === "refuted_no_effect");
+  if (supported.length > 0) {
+    hints2.push(
+      `Held: ${supported.map((test) => `\u201C${test.hypothesis.change}\u201D on ${test.landingSlug}`).join("; ")}. Build on these \u2014 the same insight usually has more in it.`
+    );
+  }
+  if (refuted.length > 0) {
+    hints2.push(
+      `Made it worse: ${refuted.map((test) => `\u201C${test.hypothesis.change}\u201D on ${test.landingSlug}`).join("; ")}. Do not propose these again as they were; the observation behind each may still be right, the change was not.`
+    );
+  }
+  if (noEffect.length > 0) {
+    hints2.push(
+      `Did not matter: ${noEffect.map((test) => `\u201C${test.hypothesis.change}\u201D on ${test.landingSlug}`).join("; ")}. The next change on these pages has to be bigger \u2014 a headline, an offer, the shape of the page.`
+    );
+  }
+  const unlearned = tests.filter((test) => test.learning === null && test.verdict !== "inconclusive");
+  if (unlearned.length > 0) {
+    hints2.push(
+      `${unlearned.length === 1 ? "One test has" : `${unlearned.length} tests have`} no learning written down (${unlearned.map((test) => test.experimentId).join(", ")}). Read its numbers and write one: \`baker experiment update --id <id> --learning "\u2026"\`.`
+    );
+  }
+  return hints2;
+}
+function buildStartHints(staged) {
+  const hints2 = [];
+  for (const entry of staged.drift) {
+    hints2.push(driftHint(staged, entry));
+  }
+  if (staged.composition && staged.composition.forked.length === 0) {
+    hints2.push(
+      `\u201C${staged.variant}\u201D does not have its own copy of any section \u2014 it renders exactly the same page as \u201C${staged.landing}\u201D, so this test cannot find anything. Fork the section you want to test (\`baker landing variant ${staged.landing} --fork Hero.astro\`) and edit only that file.`
+    );
+  }
+  if (staged.newForms.length > 0 && staged.variantGoal === void 0) {
+    const forms = staged.newForms.map((flow) => `\u201C${flow}\u201D`).join(", ");
+    hints2.push(
+      `\u201C${staged.variant}\u201D uses ${staged.newForms.length === 1 ? "a Form" : "Forms"} the page does not: ${forms}. The test reads the new version on \`${staged.goal}\`, the page's event \u2014 if the new version converts by reaching this Form's ending instead, it can never convert on that key and the test will call it harmful. Say its own event: \`baker experiment update --id <id> --variant-goal submit:${staged.newForms[0]}\` (or the confirmation step's \`form:${staged.newForms[0]}:<node>:<trigger>\` key, from \`baker analytics conversions --candidates\` once the Form has been opened in the preview).`
+    );
+  }
+  return hints2;
+}
+function driftHint(staged, entry) {
+  const suffix = ` Check both versions before reading that number, and give the new version's step its own name if it is not the same action (\`baker analytics conversions --candidates\`).`;
+  if (entry.reason === "trigger_differs") {
+    return `\u201C${staged.landing}\u201D and \u201C${staged.variant}\u201D both count \`${entry.name}\`, but one fires it when the element is **scrolled into view** and the other when the visitor **does something**. Those are two different questions with one answer, and the test will report a difference that is the trigger rather than the page.${suffix}`;
+  }
+  if (entry.reason === "variant_only_missing" || entry.reason === "control_only_missing") {
+    const missing = entry.reason === "variant_only_missing" ? staged.variant : staged.landing;
+    return `Only one version fires \`${entry.name}\` \u2014 \u201C${missing}\u201D does not declare it at all, so it can only ever read zero for that conversion and the comparison will look like a collapse.${suffix}`;
+  }
+  return `Both versions count \`${entry.name}\`, and the section the test changed is what fires it \u2014 the markup around it is not the same on the two pages. If the new version fires it on a different action (a block that is visible from the start rather than one the visitor opens), that conversion is comparing two different things.${suffix}`;
+}
+
 // src/commands/experiment/hypothesis.ts
 var SOURCES = experimentEvidenceSourceSchema.options.join(", ");
 function parseOne(raw) {
@@ -46056,7 +46110,7 @@ registerSchema({
 var statusCommand6 = defineCommand123({
   meta: {
     name: "status",
-    description: "The verdict on each test. Read `verdict` and nothing else to decide: keep_running | winner | no_difference | invalid | stopped_early_harmful. `summary` is one sentence you can show the client, and `secondary` lists every other conversion the company counts on the same two arms \u2014 context, never a second decision. The numbers under `--full` are for printing, never for deciding \u2014 a test that says keep_running has not finished, however good its numbers look."
+    description: "The verdict on each test. Read `verdict` and nothing else to decide: keep_running | winner | no_difference | cannot_win | invalid. `cannot_win` means even the best case is under the lift the test was looking for \u2014 end it and keep the original. `stillNeeded` is the data (visitors, conversions) the test still needs; a test is gated on data, never on days. `summary` is one sentence you can show the client, and `secondary` lists every other conversion the company counts on the same two arms \u2014 context, never a second decision. The numbers under `--full` are for printing, never for deciding \u2014 a test that says keep_running has not finished, however good its numbers look."
   },
   args: {
     id: { type: "string", description: "One test, by its id", required: false },
@@ -52809,7 +52863,7 @@ async function runMediaGroupLookup(input) {
     const data = await apiGet(`${input.path}?${query.toString()}`);
     const images = data.images.map((image) => compactImage(image));
     const videos = (data.videos ?? []).map((video) => compactVideo(video));
-    const count = images.length + videos.length;
+    const count2 = images.length + videos.length;
     writeJson({
       ok: true,
       data: {
@@ -52819,11 +52873,11 @@ async function runMediaGroupLookup(input) {
         // place the campaign is named.
         groupTitle: data.groupTitle ?? null,
         groupUrl: data.groupUrl ?? null,
-        count,
+        count: count2,
         images,
         videos
       },
-      hints: count > 1 ? ["These arrived together and are ordered. Read them in sequence before using any one of them alone."] : void 0
+      hints: count2 > 1 ? ["These arrived together and are ordered. Read them in sequence before using any one of them alone."] : void 0
     });
   } catch (err) {
     if (err instanceof ApiError) {
@@ -53523,9 +53577,9 @@ function getDominantEdgeColor(data, width, height) {
   let maxCount = 0;
   let dominantColor = { r: 0, g: 0, b: 0 };
   for (const key in colorCount) {
-    const count = colorCount[key];
-    if (count > maxCount) {
-      maxCount = count;
+    const count2 = colorCount[key];
+    if (count2 > maxCount) {
+      maxCount = count2;
       const parts = key.split(",").map(Number);
       dominantColor = { r: parts[0], g: parts[1], b: parts[2] };
     }
@@ -55969,10 +56023,10 @@ var ANALYZERS = [
     scope: "page",
     run: (text2, file) => {
       const body = stripHtmlToText(text2).replace(/&mdash;|&#0*8212;|&#x0*2014;/gi, "\u2014");
-      const count = (body.match(/[—]|(?<!-)--(?!-)(?=\S)/g) ?? []).length;
-      if (count < EM_DASH_FLOOR) return [];
-      if (body.length > count * EM_DASH_CHARS_PER_DASH) return [];
-      return [{ id: "em-dash-overuse", snippet: `${count} em-dashes in body copy`, file }];
+      const count2 = (body.match(/[—]|(?<!-)--(?!-)(?=\S)/g) ?? []).length;
+      if (count2 < EM_DASH_FLOOR) return [];
+      if (body.length > count2 * EM_DASH_CHARS_PER_DASH) return [];
+      return [{ id: "em-dash-overuse", snippet: `${count2} em-dashes in body copy`, file }];
     }
   },
   // Agent washing: an autonomy claim the page never scaffolds with a signal about
@@ -55999,25 +56053,25 @@ var ANALYZERS = [
     run: (text2, file) => {
       const body = stripHtmlToText(text2);
       const lower = body.toLowerCase();
-      let count = 0;
+      let count2 = 0;
       let firstSample = "";
       for (const phrase of BUZZWORDS) {
         let from = 0;
         for (; ; ) {
           const idx = lower.indexOf(phrase, from);
           if (idx === -1) break;
-          count++;
+          count2++;
           if (!firstSample) {
             firstSample = body.slice(Math.max(0, idx - 12), Math.min(body.length, idx + phrase.length + 12)).trim();
           }
           from = idx + phrase.length;
         }
       }
-      if (count === 0) return [];
+      if (count2 === 0) return [];
       return [
         {
           id: "marketing-buzzword",
-          snippet: `${count} buzzword phrase${count === 1 ? "" : "s"}: "${firstSample}"`,
+          snippet: `${count2} buzzword phrase${count2 === 1 ? "" : "s"}: "${firstSample}"`,
           file
         }
       ];
@@ -56029,18 +56083,18 @@ var ANALYZERS = [
     scope: "page",
     run: (text2, file) => {
       const body = stripHtmlToText(text2);
-      let count = 0;
+      let count2 = 0;
       let firstSample = "";
       for (const m of body.matchAll(/\bNot an? [a-z][^.!?]{1,40}[.!]\s+[A-Z][^.!?]{1,60}[.!]/g)) {
-        count++;
+        count2++;
         if (!firstSample) firstSample = cap2(m, 0).trim().slice(0, 80);
       }
       for (const m of body.matchAll(/\b[A-Z][^.!?]{4,80}[.!]\s+(No|Just)\s+[a-z][^.!?]{2,60}[.!]/g)) {
-        count++;
+        count2++;
         if (!firstSample) firstSample = cap2(m, 0).trim().slice(0, 80);
       }
-      if (count < 3) return [];
-      return [{ id: "aphoristic-cadence", snippet: `${count} aphoristic constructions: "${firstSample}"`, file }];
+      if (count2 < 3) return [];
+      return [{ id: "aphoristic-cadence", snippet: `${count2} aphoristic constructions: "${firstSample}"`, file }];
     }
   },
   // Shared AI copy tells (engine/copy-tells) — the Wikipedia "Signs of AI
@@ -62344,23 +62398,24 @@ function narrowToFamily(commandName, available) {
 var schemaCommand2 = defineCommand204({
   meta: {
     name: "schema",
-    description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
+    description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images search (or images.search)"
   },
   args: {
     command: {
       type: "positional",
-      description: "Command name (e.g. images.list). Omit to list all.",
+      description: "Command path, as typed (images list) or dotted (images.list). Omit to list all.",
       required: false
     }
   },
   run: ({ args: args4 }) => {
-    const commandName = args4.command;
-    if (!commandName) {
+    const words2 = args4._.filter((word) => typeof word === "string" && word.length > 0);
+    if (words2.length === 0) {
       const schemas = listSchemas();
       writeJson({ ok: true, data: { commands: schemas } });
       return;
     }
-    const schema = getSchema(commandName);
+    const commandName = words2.join(".");
+    const schema = findSchema(words2);
     if (!schema) {
       const all = listSchemas();
       const available = narrowToFamily(commandName, all);
@@ -62810,7 +62865,7 @@ function clipImageLimitFor(args4) {
   if (args4.from !== "references") {
     return {
       max: 1,
-      refuse: (count) => `Animating one exact frame uses a single image \u2014 you passed ${count}. Pick one, or switch --from references to guide the shot with all of them.`
+      refuse: (count2) => `Animating one exact frame uses a single image \u2014 you passed ${count2}. Pick one, or switch --from references to guide the shot with all of them.`
     };
   }
   if (!supportsReferenceToVideo(model)) {
@@ -62823,7 +62878,7 @@ function clipImageLimitFor(args4) {
   if (max === void 0) return void 0;
   return {
     max,
-    refuse: (count) => `${label} takes up to ${max} reference images \u2014 you passed ${count}. Drop the weakest ones.`
+    refuse: (count2) => `${label} takes up to ${max} reference images \u2014 you passed ${count2}. Drop the weakest ones.`
   };
 }
 function clipModeFor(from) {
@@ -62848,7 +62903,7 @@ function buildAnimateBody(args4, prompt, imageIds) {
   return body;
 }
 function costHintsFor(body) {
-  const count = body.count ?? 1;
+  const count2 = body.count ?? 1;
   const model = body.model ?? DEFAULT_VIDEO_GENERATE_MODEL;
   const perTake = estimateVideoCredits({
     model,
@@ -62865,9 +62920,9 @@ function costHintsFor(body) {
     // that gets re-routed — a frame-started clip never does.
     mayRouteToFal: body.clipMode === "references" && body.imageIds.length > 0
   });
-  const total = perTake * count;
+  const total = perTake * count2;
   const hints2 = [
-    count === 1 ? `This clip costs about ${total} credits \u2014 roughly 45x an image.` : `${count} takes at about ${perTake} credits each \u2014 about ${total} credits.`
+    count2 === 1 ? `This clip costs about ${total} credits \u2014 roughly 45x an image.` : `${count2} takes at about ${perTake} credits each \u2014 about ${total} credits.`
   ];
   const pinned = pinnedModelHint({ avatar: body.avatar, model: body.model, generateAudio: body.generateAudio });
   if (pinned) hints2.push(pinned);
@@ -62875,7 +62930,7 @@ function costHintsFor(body) {
   if (pace) hints2.push(pace);
   const silent = silentModelHint(model, body.prompt);
   if (silent) hints2.push(silent);
-  if (count > 1) {
+  if (count2 > 1) {
     hints2.push(
       "Ask for more than one take only when the MOTION is the risk \u2014 for a look you are unsure about, iterate on the still first."
     );
@@ -63128,7 +63183,7 @@ function referenceLimitFor(model) {
   const label = MODEL_REGISTRY.image_generate[chosen]?.label ?? chosen;
   return {
     max,
-    refuse: (count) => max === 1 ? `${label} takes exactly one reference image \u2014 you passed ${count}. Pick the one that matters, or switch to a model that reads several.` : `${label} takes up to ${max} reference images \u2014 you passed ${count}. Drop the weakest ones.`
+    refuse: (count2) => max === 1 ? `${label} takes exactly one reference image \u2014 you passed ${count2}. Pick the one that matters, or switch to a model that reads several.` : `${label} takes up to ${max} reference images \u2014 you passed ${count2}. Drop the weakest ones.`
   };
 }
 async function effectiveModel(pinned, skillId, fetchSkills = () => apiGet("/api/studio/skills")) {
@@ -66953,7 +67008,7 @@ function commandFor(root, argv) {
   const { command, resolved } = resolveCommand2(root, argv);
   return resolved ? command : null;
 }
-function unknownFlagEnvelope(unknown, commandPath, suggestion) {
+function unknownFlagEnvelope(unknown, commandPath, suggestion, hasSchema) {
   const list = unknown.join(", ");
   return {
     ok: false,
@@ -66961,8 +67016,8 @@ function unknownFlagEnvelope(unknown, commandPath, suggestion) {
       code: "UNKNOWN_ARGUMENT",
       message: `${list} ${unknown.length > 1 ? "are not options" : "is not an option"} of \`baker ${commandPath}\`.`,
       fix: {
-        action: "check_schema",
-        explanation: (suggestion ? `Did you mean ${suggestion}? ` : "") + `Run \`baker schema ${commandPath}\` to see every option this command takes. Do not re-run the same call: until this version an unrecognised option was accepted and ignored, so a command that looked like it had filtered or narrowed the result was in fact answering the unfiltered question.`
+        action: hasSchema ? "check_schema" : "check_help",
+        explanation: (suggestion ? `Did you mean ${suggestion}? ` : "") + `Run \`${hasSchema ? `baker schema ${commandPath}` : `baker ${commandPath} --help`}\` to see every option this command takes. Do not re-run the same call: until this version an unrecognised option was accepted and ignored, so a command that looked like it had filtered or narrowed the result was in fact answering the unfiltered question.`
       },
       retryable: false
     }
@@ -66993,8 +67048,9 @@ function refuseUnknownFlags(root, argv) {
   const command = commandFor(root, argv);
   const first = unknown[0];
   const suggestion = command && first ? closestFlag(first, command) : null;
+  const path48 = commandPathOf(root, argv);
   process.stdout.write(
-    `${JSON.stringify(unknownFlagEnvelope(unknown, commandPathOf(root, argv), suggestion), null, 2)}
+    `${JSON.stringify(unknownFlagEnvelope(unknown, path48, suggestion, findSchema(path48.split(" ")) !== void 0), null, 2)}
 `
   );
   process.exit(1);