@koda-sl/baker-cli 0.560.0 → 0.562.0

package/dist/chunk-ZZ5B2ZRM.js

@@ -0,0 +1,94 @@
+import {
+  ApiError
+} from "./chunk-QEREDRZO.js";
+import {
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+
+// src/commands/landing/inspiration/shared.ts
+var INSPIRATION_HINTS = {
+  adapt: "Reference only. Re-express this in the client's BRAND.md palette, type and imagery register. Reusing a headline, subhead or CTA verbatim is a Tier 0 message-match failure (references/gotchas.md).",
+  structureNotCopy: "Take the structural decision, not the furniture: what the eye hits first, the grid ratio, what was deliberately left out. Your copy must come from the client's own offer."
+};
+function favoritesScopeHints(health, resultCount) {
+  if (!health) return [];
+  const hints = [];
+  if (health.savedPages === 0) {
+    hints.push(
+      "This company hasn't saved any reference pages yet, so there is no taste profile to search \u2014 an empty result here says nothing about the library. Search the whole shared library with --scope all, or save a page the client admires with `baker landing inspiration add <url>`."
+    );
+    return hints;
+  }
+  if (health.failedPages > 0) {
+    const retryable = health.failedExamples.filter((example) => example.retryable).map((example) => example.url);
+    const permanent = health.failedExamples.filter((example) => !example.retryable).map((example) => example.url);
+    hints.push(
+      `${health.failedPages} of this company's ${health.savedPages} saved pages could not be read, so they hold no sections \u2014 only ${health.usablePages} are usable, which is why this result is thin. Search the whole library with --scope all.`
+    );
+    if (retryable.length > 0) {
+      hints.push(
+        `Worth another go: ${retryable.join(", ")} \u2014 run \`baker landing inspiration add <url>\` on one of them to study it again.`
+      );
+    }
+    if (permanent.length > 0) {
+      hints.push(`Not worth retrying \u2014 these sites refuse automated readers: ${permanent.join(", ")}.`);
+    }
+  }
+  if (health.studyingPages > 0) {
+    hints.push(
+      `${health.studyingPages} saved ${health.studyingPages === 1 ? "page is" : "pages are"} still being studied and will be searchable in a few minutes. Carry on; do not wait on them.`
+    );
+  }
+  if (resultCount === 0 && health.failedPages === 0 && health.studyingPages === 0) {
+    hints.push(
+      `Nothing in this company's ${health.usablePages} readable saved pages matches. The saved set is healthy, so this is the query, not the library \u2014 loosen the filters or search everything with --scope all.`
+    );
+  }
+  return hints;
+}
+function fidelityHint(fidelity) {
+  if (fidelity == null) return null;
+  if (fidelity >= 0.9) return null;
+  if (fidelity >= 0.75) {
+    return `Reproduction fidelity ${fidelity.toFixed(2)} \u2014 the markup is close but not exact. Trust the screenshot over the code.`;
+  }
+  return `Reproduction fidelity ${fidelity.toFixed(2)} \u2014 this section is scroll- or JS-driven and the extracted markup does NOT render like the original. Use the screenshot and the notes; treat the code as a hint only.`;
+}
+var STALE_COPY_AFTER_MS = 30 * 24 * 60 * 60 * 1e3;
+function staleCopyHint(studiedAt, filedUrl, now = Date.now()) {
+  if (!studiedAt || now - studiedAt < STALE_COPY_AFTER_MS) return null;
+  const date = new Date(studiedAt).toLocaleDateString("en-US", { month: "short", day: "numeric", timeZone: "UTC" });
+  return `This copy of the page was read on ${date}. If the user says the live page looks different, run: baker landing inspiration add ${filedUrl} --refresh`;
+}
+function reportError(error) {
+  if (error instanceof ApiError) {
+    writeJson({ ok: false, error: { code: error.code, message: error.message } });
+  } else {
+    writeJson({
+      ok: false,
+      error: { code: "UNKNOWN", message: error instanceof Error ? error.message : String(error) }
+    });
+  }
+  process.exit(1);
+}
+function splitList(value) {
+  if (!value) return void 0;
+  const parts = value.split(",").map((part) => part.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+function parseNumber(value) {
+  if (value === void 0 || value === "") return void 0;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+
+export {
+  INSPIRATION_HINTS,
+  favoritesScopeHints,
+  fidelityHint,
+  staleCopyHint,
+  reportError,
+  splitList,
+  parseNumber
+};
+//# sourceMappingURL=chunk-ZZ5B2ZRM.js.map

package/dist/cite-AJ5ZQWD2.js

@@ -0,0 +1,191 @@
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-D3YAFC6K.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/cite.ts
+import { defineCommand } from "citty";
+var TIMEOUT_MS = 18e4;
+var STALE_AFTER_DAYS = 14;
+registerSchema({
+  command: "research.cite",
+  description: "Prove a quote-grade claim: read the page, check each span is on it word for word, and record the evidence (url, time, page hash, the span in context). Not-found spans come back found:false \u2014 drop the quotation marks or label the line `Synthesis:`. `--check <evidenceId>` re-reads the page before you reuse a fact.",
+  args: {
+    url: { type: "string", description: "The page that says it", required: false },
+    span: {
+      type: "string",
+      description: "Exact words from the page (8-1000 chars). Repeat --span for several, up to 10",
+      required: false
+    },
+    check: {
+      type: "string",
+      description: "Re-read a cited page by its evidenceId and say whether the spans are still there, and how old the citation is",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Also return the final URL, page title, content hash and the page's own spelling of each span",
+      required: false,
+      default: false
+    }
+  }
+});
+var FIELDS = {
+  evidenceId: "Id of the recorded evidence \u2014 put it next to the claim, and pass it to --check before reusing the fact",
+  url: "The page as asked for",
+  capturedAt: "When the page was read and the spans checked",
+  spans: "Each span: found (word for word on the page) and, when found, the page's words around it"
+};
+function quoted(text) {
+  return `"${text.length > 80 ? `${text.slice(0, 77)}\u2026` : text}"`;
+}
+function citeHints(result) {
+  const missing = result.spans.filter((span) => !span.found);
+  const hints = [];
+  if (missing.length > 0) {
+    hints.push(
+      `Not on the page word for word: ${missing.map((span) => quoted(span.text)).join(", ")}. Do not present these as quotes: drop the quotation marks and paraphrase with the link, or label the line \`Synthesis:\`. Never attribute them to a person. Carry on with the rest of the job.`
+    );
+    if (result.truncated) {
+      hints.push(
+        `The page was cut at ${result.contentChars} characters, so a span further down reads as not found. Cite a deeper URL (the section's own page) if there is one.`
+      );
+    }
+  }
+  if (missing.length < result.spans.length) {
+    hints.push(
+      `Write the found spans as quotes with the link and the capture date, and keep evidenceId ${result.evidenceId} beside the claim. Before reusing the fact in a later deliverable, run \`baker research cite --check ${result.evidenceId}\`.`
+    );
+  }
+  return hints;
+}
+function citeCheckHints(result) {
+  const hints = [];
+  const gone = result.spans.filter((span) => span.wasFound && !span.found);
+  if (gone.length > 0 && result.truncated) {
+    hints.push(
+      `Not found this time: ${gone.map((span) => quoted(span.text)).join(", ")} \u2014 but the page was cut before its end, so they may sit past the cut rather than be gone. Re-cite them on the section's own URL before reusing them, or state them as "as of ${result.capturedAt.slice(0, 10)}".`
+    );
+  } else if (gone.length > 0) {
+    hints.push(
+      `No longer on the page: ${gone.map((span) => quoted(span.text)).join(", ")}. The page changed since ${result.capturedAt.slice(0, 10)} \u2014 do not reuse these as current facts. Re-research them, or state them as "as of ${result.capturedAt.slice(0, 10)}".`
+    );
+  } else if (result.ageDays >= STALE_AFTER_DAYS) {
+    hints.push(
+      `Still on the page, but first cited ${result.ageDays} days ago. Prices, plans and ownership move: cite again (\`baker research cite\`) so the deliverable carries today's date.`
+    );
+  }
+  return hints;
+}
+function citeView(result, full) {
+  if (full) return result;
+  return {
+    evidenceId: result.evidenceId,
+    url: result.url,
+    capturedAt: result.capturedAt,
+    spans: result.spans.map(({ text, found, context }) => context ? { text, found, context } : { text, found })
+  };
+}
+function checkView(result, full) {
+  if (full) return result;
+  return {
+    evidenceId: result.evidenceId,
+    url: result.url,
+    capturedAt: result.capturedAt,
+    checkedAt: result.checkedAt,
+    ageDays: result.ageDays,
+    pageChanged: result.pageChanged,
+    ...result.truncated ? { truncated: true } : {},
+    spans: result.spans.map(({ text, found, wasFound }) => ({ text, found, wasFound }))
+  };
+}
+function citeFix(code) {
+  if (code === "VALIDATION_ERROR" || code === "BAD_REQUEST") {
+    return {
+      action: "retry_with_changes",
+      explanation: 'Pass the full page address (https://\u2026) and at least one exact span of 8+ characters: baker research cite "<url>" "<exact words>" --span "<more exact words>".'
+    };
+  }
+  if (code === "NOT_FOUND") {
+    return {
+      action: "continue_without",
+      explanation: "The page or the evidence id does not exist. Do not quote from it: drop the quotation marks or label the line `Synthesis:`, and carry on."
+    };
+  }
+  return {
+    action: "continue_without",
+    explanation: "The page could not be read, so nothing on it is verified. Do not present the claim as a quote: drop the quotation marks or label the line `Synthesis:`, name the page as a gap, and finish the rest of the job."
+  };
+}
+function failValidation(message) {
+  writeResearchJson({ ok: false, error: { code: "VALIDATION_ERROR", message, fix: citeFix("VALIDATION_ERROR") } });
+  process.exit(1);
+}
+var citeCommand = defineCommand({
+  meta: {
+    name: "cite",
+    description: `Prove a quote-grade claim before it goes into Knowledge, a landing, an ad or a report.
+
+Start here: pass the page and the exact words you want to quote. The page is read fresh, each span is checked word for word (case, spacing, curly quotes and dashes forgiven \u2014 nothing else), and the evidence is recorded: when, where, a hash of the page and the words around each span.
+
+A span that is not on the page comes back found:false. Do not quote it: drop the quotation marks and paraphrase with the link, or label it \`Synthesis:\`.
+
+Before reusing a cited fact later, re-check it: \`--check <evidenceId>\` re-reads the page and says whether the spans are still there and how old the citation is.
+
+Examples:
+  baker research cite "https://acme.com/pricing" "Plans start at $10 per month"
+  baker research cite "https://acme.com/about" --span "founded in 2014" --span "offices in Berlin and Madrid"
+  baker research cite --check jd7f0m3k2x9y`
+  },
+  args: {
+    url: { type: "positional", description: "The page that says it", required: false },
+    span: { type: "string", description: "Exact words from the page; repeat for several", required: false },
+    check: { type: "string", description: "Re-check an evidenceId", required: false },
+    full: { type: "boolean", description: "Return every field", required: false }
+  },
+  run: async ({ args, rawArgs }) => {
+    const full = Boolean(args.full);
+    const check = typeof args.check === "string" ? args.check.trim() : "";
+    try {
+      if (check) {
+        const body2 = { evidenceId: check };
+        const result2 = await apiPost("/api/research/cite/check", body2, {
+          timeoutMs: TIMEOUT_MS
+        });
+        writeResearchJson({ ok: true, data: checkView(result2, full), hints: citeCheckHints(result2) });
+        return;
+      }
+      const positionals = (Array.isArray(args._) ? args._ : []).filter(
+        (word) => typeof word === "string" && word.trim().length > 0
+      );
+      const [url, ...positionalSpans] = positionals;
+      if (!url) failValidation("A page URL is required (or --check <evidenceId>).");
+      const spans = [...positionalSpans, ...repeatedValues(rawArgs, "span", args.span)];
+      if (spans.length === 0) failValidation("At least one exact span is required.");
+      const body = { url, spans };
+      const result = await apiPost("/api/research/cite", body, { timeoutMs: TIMEOUT_MS });
+      writeResearchJson({ ok: true, data: citeView(result, full), fields: FIELDS, hints: citeHints(result) });
+    } catch (err) {
+      handleResearchError(err, citeFix);
+    }
+  }
+});
+export {
+  STALE_AFTER_DAYS,
+  citeCheckHints,
+  citeCommand,
+  citeHints
+};
+//# sourceMappingURL=cite-AJ5ZQWD2.js.map

package/dist/claim-G4TW75Z2.js

@@ -0,0 +1,200 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-PXLBPOI3.js";
+import "./chunk-TK7VRZKM.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import {
+  requireChatId
+} from "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/claim.ts
+import { defineCommand } from "citty";
+
+// src/commands/actions/skillCatalog.ts
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+var DESCRIPTION_MAX = 600;
+var SKILLS_SUBPATH = join(".claude", "skills");
+var EXCLUDED_SKILLS = /* @__PURE__ */ new Set(["actions"]);
+function stripQuotes(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+    return trimmed.slice(1, -1).replace(/\\"/g, '"').replace(/\\n/g, "\n");
+  }
+  if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
+    return trimmed.slice(1, -1).replace(/''/g, "'");
+  }
+  return trimmed;
+}
+function extractFrontmatterLines(md) {
+  if (!md.startsWith("---")) return null;
+  const end = md.indexOf("\n---", 3);
+  if (end === -1) return null;
+  return md.slice(md.indexOf("\n", 3) + 1, end).split("\n");
+}
+var BLOCK_SCALAR = /^([|>])[+-]?$/;
+function collectBlockLines(lines, start) {
+  const collected = [];
+  for (let i = start; i < lines.length; i++) {
+    const line = lines[i] ?? "";
+    if (line.trim() === "") {
+      collected.push("");
+    } else if (/^\s/.test(line)) {
+      collected.push(line.trim());
+    } else {
+      break;
+    }
+  }
+  while (collected.length > 0 && collected.at(-1) === "") collected.pop();
+  return collected;
+}
+function foldLines(collected) {
+  const paragraphs = [];
+  let buffer = [];
+  for (const line of collected) {
+    if (line === "") {
+      if (buffer.length > 0) paragraphs.push(buffer.join(" "));
+      buffer = [];
+    } else {
+      buffer.push(line);
+    }
+  }
+  if (buffer.length > 0) paragraphs.push(buffer.join(" "));
+  return paragraphs.join("\n");
+}
+function readBlockScalar(lines, start, style) {
+  const collected = collectBlockLines(lines, start);
+  return style === "|" ? collected.join("\n") : foldLines(collected);
+}
+function readField(lines, field) {
+  for (let i = 0; i < lines.length; i++) {
+    const match = (lines[i] ?? "").match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!match || match[1] !== field) continue;
+    const inline = (match[2] ?? "").trim();
+    const scalar = inline.match(BLOCK_SCALAR);
+    if (scalar) {
+      return readBlockScalar(lines, i + 1, scalar[1]);
+    }
+    return stripQuotes(inline);
+  }
+  return null;
+}
+function parseSkillFrontmatter(md) {
+  const lines = extractFrontmatterLines(md);
+  if (!lines) return null;
+  const name = readField(lines, "name");
+  const description = readField(lines, "description");
+  if (!name || !description) return null;
+  const trimmed = description.length > DESCRIPTION_MAX ? `${description.slice(0, DESCRIPTION_MAX)}\u2026` : description;
+  return { name, description: trimmed };
+}
+function findSkillsDir(startDir) {
+  let dir = startDir;
+  for (; ; ) {
+    const candidate = join(dir, SKILLS_SUBPATH);
+    if (existsSync(candidate)) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function readSkillCatalog(startDir) {
+  const skillsDir = findSkillsDir(startDir);
+  if (!skillsDir) return [];
+  const entries = [];
+  for (const dirent of readdirSync(skillsDir, { withFileTypes: true })) {
+    if (!dirent.isDirectory() || EXCLUDED_SKILLS.has(dirent.name)) continue;
+    const skillFile = join(skillsDir, dirent.name, "SKILL.md");
+    if (!existsSync(skillFile)) continue;
+    try {
+      const parsed = parseSkillFrontmatter(readFileSync(skillFile, "utf8"));
+      if (parsed) entries.push(parsed);
+    } catch {
+    }
+  }
+  return entries.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+// src/commands/actions/claim.ts
+registerSchema({
+  command: "actions.claim",
+  description: "Claim an action for the current chat (live \u2014 visible to other chats immediately). Claim only what you're actively working on now: it's required before `complete`, but NOT for `update` or `discard` (those stage without a claim). Returns action details plus a fast-model recommendation of which skills to load for the work (`recommendedSkills`) and a routing hint: load every skill that owns part of the work and the tool doc for each baker CLI family you'll use.",
+  args: {
+    id: { type: "string", description: "Action ID", required: true }
+  }
+});
+async function recommendSkills(actionId) {
+  const skills = readSkillCatalog(process.cwd());
+  if (skills.length === 0) return [];
+  const response = await apiPost("/api/actions/recommend-skills", {
+    actionId,
+    skills
+  });
+  return response.data.recommendations;
+}
+var ROUTING_HINT = "Actions often span several surfaces (a landing page plus a Google Ads change, a sheet pull plus an audience upload). Before starting, load EVERY skill that owns part of the work and read the tool doc (__tooling__/docs/tools/baker/<family>.md) for each baker CLI family you'll use. If the action references source material living in a connected tool (an email attachment, a call, a CRM record, a spreadsheet), reach for that tool too. If it describes recurring or future-dated work, it belongs on a schedule \u2014 see __tooling__/docs/tools/baker/scheduled-agents.md.";
+function buildHints(recommendations) {
+  if (recommendations.length === 0) {
+    return ["Review the action name, description, and tags above.", ROUTING_HINT];
+  }
+  return [
+    "Recommended skills for this action (load the ones you'll use):",
+    ...recommendations.map((r) => `  /${r.name} \u2014 ${r.reason}`),
+    "Suggestions come from the action's name/description/tags only \u2014 the work may need more.",
+    ROUTING_HINT
+  ];
+}
+var claimCommand = defineCommand({
+  meta: {
+    name: "claim",
+    description: "Claim an action so other chats see you're working on it. Required before `complete` (update and discard don't need a claim). Example: baker actions claim <action-id>"
+  },
+  args: {
+    id: { type: "positional", description: "Action ID", required: false },
+    "action-id": { type: "string", description: "Action ID", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      validateConvexId(id);
+      const chatId = requireChatId();
+      const response = await apiPost("/api/actions/claim", {
+        actionId: id,
+        chatId
+      });
+      let recommendedSkills = [];
+      try {
+        recommendedSkills = await recommendSkills(id);
+      } catch {
+      }
+      const data = response.data ? { ...response.data, recommendedSkills } : response.data;
+      writeJson({ ok: response.ok, data, hints: buildHints(recommendedSkills) });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  claimCommand
+};
+//# sourceMappingURL=claim-G4TW75Z2.js.map

package/dist/cli.js

@@ -9,6 +9,9 @@ import {
   applyAgentProfile,
   loadCommands
 } from "./chunk-WR5Y64OE.js";
+import {
+  ApiError
+} from "./chunk-QEREDRZO.js";
 import {
   installExitRecord,
   installStreamTaps,
@@ -91,6 +94,58 @@ function takeCompanyFlag(root, argv) {
   return { argv, company: null };
 }
 
+// src/error-guidance.ts
+var CHANGES_SOMETHING = " If the command changes something (stages, uploads, publishes), first read back whether it took effect, and run it again only if it did not.";
+var ASK_FOR_LESS = "ask for less in one call \u2014 a shorter date range, a lower --limit, fewer dimensions or fields \u2014 or split it into parts.";
+var SERVER_FAILURE_FIX = {
+  INTERNAL_ERROR: {
+    action: "retry_then_narrow",
+    explanation: `Baker failed on its own side; nothing in the request was refused. Run the same command once more, unchanged. If it fails the same way again, the request is likely too heavy to answer: ${ASK_FOR_LESS} If that fails too, carry on with the rest of the job and say which read could not be done.` + CHANGES_SOMETHING
+  },
+  UNAVAILABLE: {
+    action: "retry",
+    explanation: "A service this command depends on did not answer just now; the request itself was fine. Wait a few seconds and run it again, unchanged. If it keeps failing, carry on with the rest of the job and say what could not be read." + CHANGES_SOMETHING
+  },
+  TIMEOUT: {
+    action: "retry_then_narrow",
+    explanation: `The answer took too long. Run the same command once more; if it times out again, ${ASK_FOR_LESS}` + CHANGES_SOMETHING
+  },
+  NETWORK_ERROR: {
+    action: "retry",
+    explanation: "Baker could not be reached. Wait a few seconds and run the same command again. If it keeps failing, carry on with the rest of the job and say what could not be done." + CHANGES_SOMETHING
+  },
+  RATE_LIMITED: {
+    action: "wait_and_retry",
+    explanation: "Too many requests in a short time; the request itself was fine. Wait as long as the message says (about a minute if it names no time), then run it again unchanged, and space out repeated calls instead of looping."
+  }
+};
+var PASSING_FAILURE = /UNAVAILABLE|TIMEOUT|SLOW|RATE_LIMIT|NETWORK|UNREACHABLE|IMPORTING|INTERNAL|_FAILED$|^HTTP_ERROR$|^UNKNOWN$/;
+function saysNothing(fix, message) {
+  if (fix === void 0 || fix === null || fix === message) return true;
+  return typeof fix === "object" && fix.explanation === message;
+}
+function guideErrorEnvelope(envelope) {
+  const error = envelope.error;
+  if (envelope.ok !== false || typeof error !== "object" || error === null) return envelope;
+  const { code, message, fix, retryable } = error;
+  if (typeof code !== "string") return envelope;
+  const serverFix = SERVER_FAILURE_FIX[code];
+  const guided = { ...error };
+  if (typeof retryable !== "boolean") {
+    guided.retryable = serverFix !== void 0 || PASSING_FAILURE.test(code);
+  }
+  if (serverFix && saysNothing(fix, message)) {
+    guided.fix = serverFix;
+  }
+  return { ...envelope, error: guided };
+}
+function guideWrites(stream) {
+  rewriteWrites(stream, (text) => {
+    const parsed = parsePrintedEnvelope(text);
+    return parsed === null || parsed.ok !== false ? null : reprint(text, guideErrorEnvelope(parsed));
+  });
+}
+
 // src/full-flag.ts
 var FLAG2 = "--full";
 function commandThatRuns(command) {
@@ -460,46 +515,46 @@ File: --out <file> writes the whole envelope to a file and prints a summary (fil
 Introspection: Run 'baker schema <command>' to inspect argument schemas.`
   },
   subCommands: {
-    capabilities: () => import("./capabilities-EDXVGZXC.js").then((m) => m.capabilitiesCommand),
-    actions: () => import("./actions-LI43PTFN.js").then((m) => m.actionsCommand),
-    "scheduled-agents": () => import("./scheduled-agents-YAHYCFDA.js").then((m) => m.scheduledAgentsCommand),
-    ads: () => import("./ads-OC3ENYUC.js").then((m) => m.adsCommand),
+    capabilities: () => import("./capabilities-YFXCTUJJ.js").then((m) => m.capabilitiesCommand),
+    actions: () => import("./actions-CVTRCHPG.js").then((m) => m.actionsCommand),
+    "scheduled-agents": () => import("./scheduled-agents-RRAWQYPE.js").then((m) => m.scheduledAgentsCommand),
+    ads: () => import("./ads-LDCZ65B5.js").then((m) => m.adsCommand),
     brand: () => import("./brand-OISTKMY4.js").then((m) => m.brandCommand),
-    analytics: () => import("./analytics-XT4ANMLP.js").then((m) => m.analyticsCommand),
-    experiment: () => import("./experiment-O6726OBP.js").then((m) => m.experimentCommand),
-    ga4: () => import("./ga4-XFJO7VK2.js").then((m) => m.ga4Command),
-    gsc: () => import("./gsc-ILEIJYWP.js").then((m) => m.gscCommand),
-    research: () => import("./research-JN3JGEEL.js").then((m) => m.researchCommand),
-    decide: () => import("./decide-JZXG6LZR.js").then((m) => m.decideCommand),
-    knowledge: () => import("./knowledge-PN3FAZJ2.js").then((m) => m.knowledgeCommand),
-    creatives: () => import("./creatives-UPZU7BLY.js").then((m) => m.creativesCommand),
-    flows: () => import("./flows-XWU2XNYP.js").then((m) => m.flowsCommand),
-    funnel: () => import("./funnel-NMC3JWTF.js").then((m) => m.funnelCommand),
-    images: () => import("./images-36DGQZMH.js").then((m) => m.imagesCommand),
-    studio: () => import("./studio-ZLBBYHNY.js").then((m) => m.studioCommand),
-    avatars: () => import("./avatars-SDQ5LCNG.js").then((m) => m.avatarsCommand),
-    landing: () => import("./landing-7PZPYD3M.js").then((m) => m.landingCommand),
-    videos: () => import("./videos-GY6YCGFH.js").then((m) => m.videosCommand),
-    testimonials: () => import("./testimonials-OJV7EFGS.js").then((m) => m.testimonialsCommand),
-    canvas: () => import("./canvas-HGU7FJ34.js").then((m) => m.canvasCommand),
-    tags: () => import("./tags-HKR2GWXV.js").then((m) => m.tagsCommand),
-    "tag-manager": () => import("./tag-manager-5WZPX2FJ.js").then((m) => m.tagManagerCommand),
-    chats: () => import("./chats-HFKSZWZD.js").then((m) => m.chatsCommand),
-    history: () => import("./history-6RCRBB4Q.js").then((m) => m.historyCommand),
-    credentials: () => import("./credentials-WRC7ERSS.js").then((m) => m.credentialsCommand),
-    hubspot: () => import("./hubspot-SNLOCDPF.js").then((m) => m.hubspotCommand),
-    activecampaign: () => import("./activecampaign-5A6YHDJW.js").then((m) => m.activecampaignCommand),
-    accounts: () => import("./accounts-KXQY6WKR.js").then((m) => m.accountsCommand),
-    shopify: () => import("./shopify-BPQCUFFX.js").then((m) => m.shopifyCommand),
-    "winning-ads": () => import("./winning-ads-L7FHCD75.js").then((m) => m.winningAdsCommand),
-    "media-sources": () => import("./media-sources-POL5DMD4.js").then((m) => m.mediaSourcesCommand),
-    posts: () => import("./posts-K3QTBX2B.js").then((m) => m.postsCommand),
-    site: () => import("./site-KYB2EL72.js").then((m) => m.siteCommand),
-    "lead-routes": () => import("./lead-routes-RLYGO47M.js").then((m) => m.leadRoutesCommand),
-    mcp: () => import("./mcp-Y43SKNHV.js").then((m) => m.mcpCommand),
-    "setup-links": () => import("./setup-links-AHWFGUAO.js").then((m) => m.setupLinksCommand),
-    feedback: () => import("./feedback-Y4AXR354.js").then((m) => m.feedbackCommand),
-    organization: () => import("./organization-KORFOK7Q.js").then((m) => m.organizationCommand),
+    analytics: () => import("./analytics-YHOXWFBI.js").then((m) => m.analyticsCommand),
+    experiment: () => import("./experiment-EFLKDQ3C.js").then((m) => m.experimentCommand),
+    ga4: () => import("./ga4-FCMTGV4S.js").then((m) => m.ga4Command),
+    gsc: () => import("./gsc-A3KB36WH.js").then((m) => m.gscCommand),
+    research: () => import("./research-ZBZONY3D.js").then((m) => m.researchCommand),
+    decide: () => import("./decide-AM6B7WIL.js").then((m) => m.decideCommand),
+    knowledge: () => import("./knowledge-H5PJ6LZB.js").then((m) => m.knowledgeCommand),
+    creatives: () => import("./creatives-XQILGK6P.js").then((m) => m.creativesCommand),
+    flows: () => import("./flows-YPBWZR4P.js").then((m) => m.flowsCommand),
+    funnel: () => import("./funnel-MF2KFXEX.js").then((m) => m.funnelCommand),
+    images: () => import("./images-2FDXHKMR.js").then((m) => m.imagesCommand),
+    studio: () => import("./studio-ZRAZ2C25.js").then((m) => m.studioCommand),
+    avatars: () => import("./avatars-I73KFB3F.js").then((m) => m.avatarsCommand),
+    landing: () => import("./landing-VE3MHOA3.js").then((m) => m.landingCommand),
+    videos: () => import("./videos-MXEQHDMN.js").then((m) => m.videosCommand),
+    testimonials: () => import("./testimonials-5MA427KH.js").then((m) => m.testimonialsCommand),
+    canvas: () => import("./canvas-YTSJAEOF.js").then((m) => m.canvasCommand),
+    tags: () => import("./tags-J6IPWIZ5.js").then((m) => m.tagsCommand),
+    "tag-manager": () => import("./tag-manager-3GIW6BPB.js").then((m) => m.tagManagerCommand),
+    chats: () => import("./chats-D5W2UWD4.js").then((m) => m.chatsCommand),
+    history: () => import("./history-LBIA45H3.js").then((m) => m.historyCommand),
+    credentials: () => import("./credentials-IWF37PAQ.js").then((m) => m.credentialsCommand),
+    hubspot: () => import("./hubspot-NEENQKIP.js").then((m) => m.hubspotCommand),
+    activecampaign: () => import("./activecampaign-UNNM6J7M.js").then((m) => m.activecampaignCommand),
+    accounts: () => import("./accounts-XL2TMLGE.js").then((m) => m.accountsCommand),
+    shopify: () => import("./shopify-SOTGSWXW.js").then((m) => m.shopifyCommand),
+    "winning-ads": () => import("./winning-ads-YKBB2UZC.js").then((m) => m.winningAdsCommand),
+    "media-sources": () => import("./media-sources-NMT4G45B.js").then((m) => m.mediaSourcesCommand),
+    posts: () => import("./posts-TRQCRLYZ.js").then((m) => m.postsCommand),
+    site: () => import("./site-IAIGIP3R.js").then((m) => m.siteCommand),
+    "lead-routes": () => import("./lead-routes-ZMKRNL57.js").then((m) => m.leadRoutesCommand),
+    mcp: () => import("./mcp-QSDCAWMU.js").then((m) => m.mcpCommand),
+    "setup-links": () => import("./setup-links-CK7LBYJK.js").then((m) => m.setupLinksCommand),
+    feedback: () => import("./feedback-ECAZWGJP.js").then((m) => m.feedbackCommand),
+    organization: () => import("./organization-6T4Q6XYI.js").then((m) => m.organizationCommand),
     schema: () => import("./schema-L4PETLZT.js").then((m) => m.schemaCommand)
   }
 });
@@ -541,6 +596,7 @@ if (fullFlag.taken) {
   process.argv = [...process.argv.slice(0, 2), ...fullFlag.argv];
   installFullNote(commandPathOf(main, fullFlag.argv));
 }
+guideWrites(process.stdout);
 var companyFlag = takeCompanyFlag(main, process.argv.slice(2));
 if (companyFlag.company) {
   process.argv = [...process.argv.slice(0, 2), ...companyFlag.argv];
@@ -570,6 +626,11 @@ if (rawArgs.some((arg) => arg === "--help" || arg === "-h") || rawArgs.length ==
     const refusal = parseRefusalEnvelope(error, main, rawArgs);
     if (refusal) {
       writeJson(refusal);
+    } else if (error instanceof ApiError) {
+      writeJson({
+        ok: false,
+        error: { code: error.code, message: error.message, ...error.fix && { fix: error.fix } }
+      });
     } else {
       console.error(error, "\n");
     }