@koda-sl/baker-cli 0.347.0-dev.043fc924c → 0.348.0-dev.78a35388f

package/dist/cli.js

@@ -23,6 +23,7 @@ import {
   YtDlpError,
   bestSupportedQuality,
   canonicalUrl,
+  catalogView,
   clipAudioMode,
   clipDurationsFor,
   clipParamRecipe,
@@ -67,7 +68,7 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-D5P4COPD.js";
+} from "./chunk-4QG7SF4U.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -76,7 +77,7 @@ import {
   resolveAccountIdArg,
   resolveEffectiveStatus,
   todayIso
-} from "./chunk-JWMLQSGK.js";
+} from "./chunk-NA5CPMUA.js";
 import {
   buildQueryCacheKey,
   cacheGet,
@@ -92,33 +93,42 @@ import {
   writeAdsJson,
   writeAdsOutput,
   writeJsonEnvelope
-} from "./chunk-KGDL7F7M.js";
+} from "./chunk-2IC3CGQO.js";
 import {
   ApiError,
   apiGet,
   apiGetWithHeaders,
   apiPost,
   validateConvexId
-} from "./chunk-XPUSSDLR.js";
+} from "./chunk-4QXKWIFC.js";
 import {
   installExitRecord,
   installStreamTaps,
   logInvocation
-} from "./chunk-PWGY347J.js";
+} from "./chunk-XWHHYHKQ.js";
 import {
+  adContentNormalizer,
   captureBudgetMs,
   captureProxyCredentials,
   captureVimeoCookie,
+  compactImage,
+  compactVideo,
   getEnv,
   hasOpenRouterKey,
   isProxyFailure,
   openRouterKey,
+  optionalChatId,
   plannedRoutes,
   refuseNonPublicUrl,
   requireChatId,
   resolveChatId,
-  shouldEscalate
-} from "./chunk-4VP5WWPR.js";
+  shouldEscalate,
+  testimonialNormalizer,
+  videoNormalizer,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-2OKSJNLA.js";
 
 // src/cli.ts
 import { defineCommand as defineCommand245, runMain } from "citty";
@@ -159,420 +169,6 @@ import { defineCommand as defineCommand18 } from "citty";
 // src/commands/actions/claim.ts
 import { defineCommand } from "citty";
 
-// src/output.ts
-var ASPECT_RATIO_MAP = {
-  "1:1": 1,
-  "16:9": 16 / 9,
-  "9:16": 9 / 16,
-  "2:3": 2 / 3,
-  "3:4": 3 / 4,
-  "1:2": 1 / 2,
-  "2:1": 2,
-  "4:5": 4 / 5,
-  "3:2": 3 / 2,
-  "4:3": 4 / 3
-};
-var ASPECT_RATIO_TOLERANCE = 0.08;
-function formatAspectRatio(ratio) {
-  if (ratio === void 0 || ratio === null) {
-    return null;
-  }
-  for (const [label, value] of Object.entries(ASPECT_RATIO_MAP)) {
-    if (Math.abs(ratio - value) / value < ASPECT_RATIO_TOLERANCE) {
-      return label;
-    }
-  }
-  return null;
-}
-function groupSummary(record) {
-  const key = record.groupKey;
-  if (typeof key !== "string" || !key) {
-    return null;
-  }
-  const index = typeof record.groupIndex === "number" ? record.groupIndex : null;
-  const size = typeof record.groupSize === "number" ? record.groupSize : null;
-  return {
-    key,
-    kind: typeof record.groupKind === "string" ? record.groupKind : null,
-    position: index === null ? null : size === null ? `${index + 1}` : `${index + 1} of ${size}`,
-    title: typeof record.groupTitle === "string" ? record.groupTitle : null,
-    url: typeof record.groupUrl === "string" ? record.groupUrl : null
-  };
-}
-function peopleLines(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value.flatMap((entry) => {
-    const person = asRecord(entry);
-    const role = typeof person.role === "string" ? person.role : "";
-    if (!role) {
-      return [];
-    }
-    const identity = typeof person.identity === "string" && person.identity ? ` \u2014 ${person.identity}` : "";
-    const appearance = typeof person.appearance === "string" && person.appearance ? ` (${person.appearance})` : "";
-    const speaking = person.speaking === true ? " [speaking]" : "";
-    return [`${role}${identity}${appearance}${speaking}`];
-  });
-}
-function compactImage(image) {
-  const analysis = asRecord(image.analysis);
-  return {
-    _id: String(image._id ?? ""),
-    name: String(image.name ?? ""),
-    imageUrl: String(image.imageUrl ?? ""),
-    description: String(image.description ?? ""),
-    tags: Array.isArray(image.tags) ? image.tags : [],
-    // Two numbers that are not about choosing the image but about placing it.
-    // A remote <BakerImage> with no width/height makes Astro DOWNLOAD the file
-    // at build time just to measure it — one request per image per build, on a
-    // build that is otherwise offline, and a single dropped connection there
-    // fails a client's whole verify. They are cheap enough to always carry, and
-    // burying them behind --full meant the agent placing the image never had
-    // them.
-    width: typeof image.width === "number" ? image.width : null,
-    height: typeof image.height === "number" ? image.height : null,
-    // The facts that decide a pick, so choosing does not need a second call:
-    // whose brand it is, who is in it, and what text is burned in.
-    subject: typeof analysis.subject === "string" ? analysis.subject : null,
-    brandOwnership: typeof analysis.brandOwnership === "string" ? analysis.brandOwnership : null,
-    people: peopleLines(analysis.people),
-    textInImage: Array.isArray(analysis.textInImage) ? analysis.textInImage : [],
-    group: groupSummary(image)
-  };
-}
-function fullImage(image) {
-  const compact3 = compactImage(image);
-  return {
-    ...compact3,
-    aspectRatio: formatAspectRatio(image.aspectRatio),
-    dominantColor: image.dominantColor ?? null,
-    imagePalette: Array.isArray(image.imagePalette) ? image.imagePalette : [],
-    source: String(image.source ?? ""),
-    externalUrl: image.externalUrl ?? null,
-    originalFilename: image.originalFilename ?? null,
-    descriptionContext: image.descriptionContext ?? null,
-    style: typeof asRecord(image.analysis).style === "string" ? asRecord(image.analysis).style : null,
-    composition: typeof asRecord(image.analysis).composition === "string" ? asRecord(image.analysis).composition : null,
-    usageNotes: typeof asRecord(image.analysis).usageNotes === "string" ? asRecord(image.analysis).usageNotes : null,
-    createdAt: image.createdAt ?? null
-  };
-}
-function imageNormalizer(record, full) {
-  if (full) {
-    return fullImage(record);
-  }
-  return compactImage(record);
-}
-function compactVideo(video) {
-  const analysis = asRecord(video.analysis);
-  const sceneCount = typeof video.sceneCount === "number" ? video.sceneCount : Array.isArray(video.scenes) ? video.scenes.length : 0;
-  return {
-    _id: String(video._id ?? ""),
-    name: String(video.name ?? ""),
-    thumbnailUrl: String(video.thumbnailUrl ?? ""),
-    description: String(video.description ?? ""),
-    tags: Array.isArray(video.tags) ? video.tags : [],
-    status: String(video.status ?? ""),
-    // What decides whether this clip is usable, without a second call: who is
-    // on camera and in what role, what language they speak, how it opens, and
-    // how many beats there are to cut from.
-    subject: typeof analysis.subject === "string" ? analysis.subject : null,
-    brandOwnership: typeof analysis.brandOwnership === "string" ? analysis.brandOwnership : null,
-    people: peopleLines(analysis.people),
-    spokenLanguages: Array.isArray(analysis.spokenLanguages) ? analysis.spokenLanguages : [],
-    hook: typeof analysis.hook === "string" ? analysis.hook : null,
-    sceneCount,
-    group: groupSummary(video)
-  };
-}
-function sceneDecoration(scene) {
-  const shot = typeof scene.shot === "string" && scene.shot ? ` [${scene.shot}]` : "";
-  const change = typeof scene.visualChange === "string" && scene.visualChange ? ` <${scene.visualChange}>` : "";
-  const overlayText = Array.isArray(scene.onScreenText) ? scene.onScreenText.filter(Boolean) : [];
-  let overlay = "";
-  if (scene.hasOverlay === true) {
-    overlay = overlayText.length > 0 ? ` \u2014 banner: "${overlayText.join('" / "')}"` : " \u2014 banner";
-  } else if (scene.hasOverlay === false) {
-    overlay = " \u2014 clean frame";
-  }
-  const spoken = typeof scene.spoken === "string" && scene.spoken ? ` \u2014 says: "${scene.spoken}"` : "";
-  return `${shot}${change}${overlay}${spoken}`;
-}
-function sceneLines(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value.flatMap((s) => {
-    const scene = asRecord(s);
-    const title = typeof scene.title === "string" ? scene.title : "";
-    if (!title) {
-      return [];
-    }
-    const start = round2(scene.startSecond);
-    const end = round2(scene.endSecond);
-    const range = start !== null && end !== null ? ` (${start}-${end}s)` : "";
-    return [`${title}${range}${sceneDecoration(scene)}`];
-  });
-}
-function fullVideo(video) {
-  const compact3 = compactVideo(video);
-  return {
-    ...compact3,
-    duration: video.duration ?? null,
-    muxPlaybackId: String(video.muxPlaybackId ?? ""),
-    source: String(video.source ?? ""),
-    // The spoken transcript + AI scene breakdown of the client's own clip — the
-    // "understand what's in this video" payload. Kept out of the compact/search
-    // projection (too large for a list) and surfaced here on --full.
-    transcript: video.transcript ?? null,
-    transcript_segment_count: Array.isArray(video.transcriptSegments) ? video.transcriptSegments.length : 0,
-    scenes: sceneLines(video.scenes),
-    originalFilename: video.originalFilename ?? null,
-    descriptionContext: video.descriptionContext ?? null,
-    shotStyle: typeof asRecord(video.analysis).shotStyle === "string" ? asRecord(video.analysis).shotStyle : null,
-    audioStyle: typeof asRecord(video.analysis).audioStyle === "string" ? asRecord(video.analysis).audioStyle : null,
-    onScreenText: Array.isArray(asRecord(video.analysis).onScreenText) ? asRecord(video.analysis).onScreenText : [],
-    usageNotes: typeof asRecord(video.analysis).usageNotes === "string" ? asRecord(video.analysis).usageNotes : null,
-    createdAt: video.createdAt ?? null
-  };
-}
-function videoNormalizer(record, full) {
-  if (full) {
-    return fullVideo(record);
-  }
-  return compactVideo(record);
-}
-function truncate(text2, maxLength) {
-  if (text2.length <= maxLength) return text2;
-  return `${text2.slice(0, maxLength)}...`;
-}
-function compactTestimonial(record) {
-  return {
-    _id: String(record._id ?? ""),
-    reviewerName: String(record.reviewerName ?? ""),
-    reviewText: truncate(String(record.reviewText ?? ""), 200),
-    rating: record.rating ?? null,
-    sentiment: record.sentiment ?? null,
-    tags: Array.isArray(record.tags) ? record.tags : [],
-    sourceType: String(record.sourceType ?? "")
-  };
-}
-function fullTestimonial(record) {
-  const compact3 = compactTestimonial(record);
-  return {
-    ...compact3,
-    reviewText: String(record.reviewText ?? ""),
-    highlight: record.highlight ?? null,
-    summary: record.summary ?? null,
-    language: record.language ?? null,
-    reviewerImageUrl: record.reviewerImageUrl ?? null,
-    sourceUrl: record.sourceUrl ?? null,
-    reviewDate: record.reviewDate ?? null,
-    createdAt: record.createdAt ?? null,
-    status: String(record.status ?? "")
-  };
-}
-function testimonialNormalizer(record, full) {
-  if (full) {
-    return fullTestimonial(record);
-  }
-  return compactTestimonial(record);
-}
-function round2(value) {
-  if (typeof value !== "number" || Number.isNaN(value)) {
-    return null;
-  }
-  return Math.round(value * 100) / 100;
-}
-function asRecord(value) {
-  return value && typeof value === "object" ? value : {};
-}
-function compactWinningAd(record) {
-  const dna = asRecord(record.dna);
-  return {
-    advertiser: String(record.advertiser ?? ""),
-    platform: String(record.platform ?? ""),
-    format: String(record.format ?? ""),
-    relevance: round2(record.relevance),
-    winner_score: round2(record.winner_score),
-    summary: String(dna.creative_concept ?? ""),
-    advertiser_id: String(record.advertiser_id ?? ""),
-    ad_id: String(record.ad_id ?? ""),
-    media_url: String(record.media_url ?? "")
-  };
-}
-function fullWinningAd(record) {
-  const compact3 = compactWinningAd(record);
-  const dna = asRecord(record.dna);
-  return {
-    ...compact3,
-    winner_category: String(record.winner_category ?? ""),
-    media_kind: record.media_kind ?? null,
-    days_active: record.days_active ?? null,
-    reach: record.reach ?? null,
-    active: typeof record.active === "boolean" ? record.active : null,
-    angle: dna.angle ?? null,
-    awareness_stage: dna.awareness_stage ?? null,
-    target_persona: dna.target_persona ?? null,
-    hook_archetype: dna.hook_archetype ?? null,
-    industry: dna.industry ?? null
-  };
-}
-function winningAdNormalizer(record, full) {
-  if (full) {
-    return fullWinningAd(record);
-  }
-  return compactWinningAd(record);
-}
-function overlayLines(value, detailed = false) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value.flatMap((o) => {
-    const item = asRecord(o);
-    const text2 = typeof item.text === "string" ? item.text : "";
-    if (!text2) {
-      return [];
-    }
-    const at = round2(item.appears_at_s);
-    let line = at !== null ? `${text2} @${at}s` : text2;
-    if (detailed) {
-      const tags = [item.role, item.position].filter((t) => typeof t === "string" && t.length > 0);
-      if (tags.length) {
-        line += ` [${tags.join(", ")}]`;
-      }
-    }
-    return [line];
-  });
-}
-function compactAdContent(record) {
-  return {
-    ad_id: record.ad_id ?? null,
-    advertiser: record.advertiser ?? null,
-    format: record.format ?? null,
-    media_kind: record.media_kind ?? null,
-    media_url: record.media_url ?? null,
-    summary: record.summary ?? null,
-    transcript: record.transcript ?? null,
-    on_screen_text: overlayLines(record.on_screen_text),
-    has_captions: typeof record.has_captions === "boolean" ? record.has_captions : null,
-    primary_text: record.primary_text ?? null,
-    headline: record.headline ?? null,
-    cta: record.cta ?? null
-  };
-}
-function fullAdContent(record) {
-  const speech = asRecord(record.speech);
-  const pacing = asRecord(record.pacing);
-  const music = asRecord(record.music);
-  return {
-    ...compactAdContent(record),
-    platform: record.platform ?? null,
-    // Re-derive with role/position tags — the lean compact version dropped them.
-    on_screen_text: overlayLines(record.on_screen_text, true),
-    winner_score: round2(record.winner_score),
-    winner_category: record.winner_category ?? null,
-    angle: record.angle ?? null,
-    hook_archetype: record.hook_archetype ?? null,
-    caption_style: record.caption_style ?? null,
-    has_speech: typeof record.has_speech === "boolean" ? record.has_speech : null,
-    speech_pct_of_runtime: round2(speech.speech_pct_of_runtime),
-    speaker_count: speech.speaker_count ?? null,
-    voiceover_vs_sync: speech.voiceover_vs_sync ?? null,
-    is_direct_address: typeof speech.is_direct_address === "boolean" ? speech.is_direct_address : null,
-    speech_emotion_dominant: speech.speech_emotion_dominant ?? null,
-    scene_count: pacing.scene_count ?? null,
-    avg_shot_length_s: round2(pacing.avg_shot_length_s),
-    pacing_shape: pacing.pacing_shape ?? null,
-    hook_ends_at_s: round2(pacing.hook_ends_at_s),
-    cta_first_shown_at_s: round2(pacing.cta_first_shown_at_s),
-    product_first_appears_at_s: round2(pacing.product_first_appears_at_s),
-    music_track_title: music.track_title ?? null,
-    music_track_artist: music.track_artist ?? null
-  };
-}
-function adContentNormalizer(record, full) {
-  return full ? fullAdContent(record) : compactAdContent(record);
-}
-function applyFieldMask(data, fields) {
-  const result = {};
-  for (const field of fields) {
-    if (field in data) {
-      result[field] = data[field];
-    }
-  }
-  return result;
-}
-function write(text2) {
-  process.stdout.write(text2);
-}
-function writeJson(envelope) {
-  write(`${JSON.stringify(envelope, null, 2)}
-`);
-}
-function writeFiles(data, fields) {
-  write(`${fields.join("	")}
-`);
-  for (const item of data) {
-    const values = fields.map((f) => String(item[f] ?? ""));
-    write(`${values.join("	")}
-`);
-  }
-}
-function writeMd(data, fields) {
-  write(`| ${fields.join(" | ")} |
-`);
-  write(`| ${fields.map(() => "---").join(" | ")} |
-`);
-  for (const item of data) {
-    const values = fields.map((f) => String(item[f] ?? ""));
-    write(`| ${values.join(" | ")} |
-`);
-  }
-}
-function normalizeData(envelope, fields, full, normalizer) {
-  const raw = Array.isArray(envelope.data) ? envelope.data : [envelope.data];
-  const items = raw.map((item) => {
-    const record = item;
-    return normalizer(record, full);
-  });
-  if (fields) {
-    return items.map((item) => applyFieldMask(item, fields));
-  }
-  return items;
-}
-function writeOutput(envelope, format, fields, full, normalizer) {
-  if (!envelope.ok || "dryRun" in envelope) {
-    writeJson(envelope);
-    return;
-  }
-  if (format === "json") {
-    writeJson(envelope);
-    return;
-  }
-  if (format !== "files" && format !== "md") {
-    process.stderr.write(`Unknown --output "${String(format)}". Valid formats: json, files, md. Using json.
-`);
-    writeJson(envelope);
-    return;
-  }
-  const items = normalizeData(envelope, fields, full ?? false, normalizer ?? imageNormalizer);
-  const displayFields = fields ?? Object.keys(items[0] ?? {});
-  if (format === "files") {
-    writeFiles(items, displayFields);
-  } else {
-    writeMd(items, displayFields);
-  }
-  writeHints(envelope.hints);
-}
-function writeHints(hints2) {
-  for (const hint of hints2 ?? []) {
-    process.stderr.write(`${hint}
-`);
-  }
-}
-
 // src/schemas.ts
 var registry = /* @__PURE__ */ new Map();
 function registerSchema(schema) {
@@ -789,50 +385,6 @@ var actionsUpdateRequestSchema = z.object({
 var actionsUpdateResponseSchema = okOnlySchema();
 var ACTION_COMPLETE_NOTE_MIN = 20;
 var actionsCompleteNoteMessage = `A completion note (\u2265${ACTION_COMPLETE_NOTE_MIN} chars) describing what was done is required: what changed, where, and the outcome.`;
-var ACCOUNT_CONTEXT = "(?:account|accounts|cuenta|cuentas|customer|cliente|property|propiedad|meta|facebook|google|ads|linkedin|ga4|analytics|gtm|tag manager|id)";
-var COMPLETION_NOTE_INTERNALS = [
-  // Repo paths: rooted in a workspace directory, or a path or lowercase file name
-  // ending in a source extension (a product name like "Next.js" is not a file).
-  /(?:\.{0,2}\/)?(?:src|public|__tooling__|\.claude)\/[^\s,;:)`'"]*[^\s,;:)`'".]/g,
-  /(?:[\w.-]*\/[\w./-]*|\b[a-z_][\w-]*)\.(?:mdx?|astro|tsx?|jsx?|mjs|json|ya?ml)\b/g,
-  // Meta ad-account ids, Tag Manager containers and GA4 measurement ids.
-  /\bact_\d+\b/g,
-  /\bGTM-[A-Z0-9]{4,}\b/g,
-  /\bG-[A-Z0-9]{6,}\b/g,
-  // Google Ads customer ids (386-508-3115), LinkedIn, GA4 and bare Google Ads ids:
-  // a long number named next to a platform or an account, so a phone number or
-  // a figure elsewhere in the note is not one.
-  new RegExp(
-    String.raw`(?<=\b${ACCOUNT_CONTEXT}\b[^.\n\d]{0,20})(?<![\w-])(?:\d{3}-\d{3}-\d{4}|\d{7,})(?![\w-])`,
-    "gi"
-  ),
-  // Error codes: SCREAMING_SNAKE in the shapes platforms and Baker return them
-  // (NO_GOOGLE_ADS_CONNECTION, PERMISSION_DENIED, INVALID_ACCOUNT_ID).
-  /\b(?:(?:ERR|INVALID|MISSING)(?:_[A-Z0-9]+)+|[A-Z][A-Z0-9]*(?:_[A-Z0-9]+)*_(?:ERROR|CONNECTION|FAILED|NOT_FOUND|DENIED|REQUIRED|INVALID|EXPIRED|UNAVAILABLE|EXCEEDED|UNREACHABLE|UNAUTHORIZED|FORBIDDEN|TIMEOUT|TOKEN)|BAD_REQUEST|NOT_FOUND|RATE_LIMITED)\b/g,
-  // CLI invocations (`baker analytics flow`).
-  /\bbaker [a-z][a-z-]*/g
-];
-function completionNoteInternals(note) {
-  const hits = [];
-  for (const pattern of COMPLETION_NOTE_INTERNALS) {
-    for (const match of note.matchAll(pattern)) {
-      const index = match.index ?? 0;
-      hits.push({ index, end: index + match[0].length, text: match[0] });
-    }
-  }
-  hits.sort((a, b) => a.index - b.index || b.end - a.end);
-  const found = [];
-  let coveredUntil = -1;
-  for (const hit of hits) {
-    if (hit.index < coveredUntil) continue;
-    found.push(hit.text);
-    coveredUntil = hit.end;
-  }
-  return found;
-}
-function completionNoteInternalsMessage(internals) {
-  return `The completion note is read by the client on the Task, and it carries internal details they cannot use: ${internals.join(", ")}. Rewrite it in product terms \u2014 name the page, campaign or Knowledge entry instead of a file, the platform instead of an account id, and say what is missing instead of an error code.`;
-}
 var actionsCompleteRequestSchema = z.object({
   chatId: z.string(),
   actionRef: z.string().min(1, "actionRef is required"),
@@ -840,11 +392,6 @@ var actionsCompleteRequestSchema = z.object({
 }).transform((body) => ({ ...body, note: (body.note ?? "").trim() })).refine((body) => body.note.length >= ACTION_COMPLETE_NOTE_MIN, {
   message: actionsCompleteNoteMessage,
   path: ["note"]
-}).superRefine((body, ctx) => {
-  const internals = completionNoteInternals(body.note);
-  if (internals.length > 0) {
-    ctx.addIssue({ code: "custom", message: completionNoteInternalsMessage(internals), path: ["note"] });
-  }
 });
 var actionsCompleteResponseSchema = okOnlySchema();
 var actionsDiscardRequestSchema = z.object({
@@ -2411,6 +1958,7 @@ var GOOGLE_ADS_LIMITS = {
     businessNameMax: 25
   }
 };
+var GOOGLE_ADS_QUERY_MAX_PAGE_SIZE = 8192;
 var KEYWORD_MATCH_TYPES = ["EXACT", "PHRASE", "BROAD"];
 var ADVERTISING_CHANNEL_TYPES = [
   "SEARCH",
@@ -8509,12 +8057,12 @@ var claimCommand = defineCommand({
 import { defineCommand as defineCommand2 } from "citty";
 registerSchema({
   command: "actions.complete",
-  description: 'Stage completion of an action (it was DONE). Accepts a real action ID (must be claimed) or a temp ID from the same draft. The action becomes completed when the chat is published. --note is REQUIRED and must describe what you actually did to resolve it (what changed, where, and the outcome) \u2014 it is the client-facing record shown on the Task in Tasks and surfaced by `baker actions log`, so write it for a marketer, in the client\'s language and product terms: a few lines, no file paths, account ids, error codes or `baker` commands ("Weekly review saved in your Knowledge; Google Ads and LinkedIn are not connected yet", not "written to src/content/audits/\u2026md; NO_GOOGLE_ADS_CONNECTION"). A note carrying those is refused. Do NOT use this to drop an action you no longer want \u2014 to remove a staged op use `actions draft remove`, to close an unwanted published action use `actions discard`.',
+  description: "Stage completion of an action (it was DONE). Accepts a real action ID (must be claimed) or a temp ID from the same draft. The action becomes completed when the chat is published. --note is REQUIRED and must describe what you actually did to resolve it (what changed, where, and the outcome) \u2014 it is the client-facing record surfaced by `baker actions log`. Do NOT use this to drop an action you no longer want \u2014 to remove a staged op use `actions draft remove`, to close an unwanted published action use `actions discard`.",
   args: {
     id: { type: "string", description: "Action ID or temp ID", required: true },
     note: {
       type: "string",
-      description: "REQUIRED. What you did to resolve this \u2014 what changed, where (in product terms: the page, the campaign, Knowledge), and the outcome \u2014 in a few lines. The client reads it on the Task: no file paths, account ids, error codes or `baker` commands.",
+      description: "REQUIRED. Detailed description of what you did to resolve this: what changed, where, and the outcome. This is the durable, client-facing record shown by `baker actions log`.",
       required: true
     }
   }
@@ -8529,7 +8077,7 @@ var completeCommand = defineCommand2({
     "action-id": { type: "string", description: "Action ID or temp ID", required: false },
     note: {
       type: "string",
-      description: "REQUIRED. What you did, where (in product terms) and the outcome \u2014 read by the client, so no file paths, account ids or error codes.",
+      description: "REQUIRED. What you did to resolve this: what changed, where, and the outcome.",
       required: false
     }
   },
@@ -8548,10 +8096,6 @@ var completeCommand = defineCommand2({
           `--note is required and must describe what you did (\u2265${ACTION_COMPLETE_NOTE_MIN} chars): what changed, where, and the outcome. This becomes the client-facing record surfaced by \`baker actions log\`.`
         );
       }
-      const internals = completionNoteInternals(note);
-      if (internals.length > 0) {
-        failValidation(`--note: ${completionNoteInternalsMessage(internals)} Then run the same command again.`);
-      }
       const chatId = requireChatId();
       await apiPost("/api/actions/complete", { chatId, actionRef: id, note });
       writeOk();
@@ -10132,7 +9676,76 @@ function urlOptionsHints(report) {
   return hints2;
 }
 
+// src/commands/ads/google/during-literals.ts
+var GAQL_DURING_LITERALS = [
+  "TODAY",
+  "YESTERDAY",
+  "LAST_7_DAYS",
+  "LAST_14_DAYS",
+  "LAST_30_DAYS",
+  "LAST_BUSINESS_WEEK",
+  "THIS_MONTH",
+  "LAST_MONTH",
+  "THIS_WEEK_SUN_TODAY",
+  "THIS_WEEK_MON_TODAY",
+  "LAST_WEEK_SUN_SAT",
+  "LAST_WEEK_MON_SUN"
+];
+function isDuringLiteral(value) {
+  return GAQL_DURING_LITERALS.includes(value.toUpperCase());
+}
+function isoDay(date) {
+  return date.toISOString().slice(0, 10);
+}
+function utcDate(year, month, day) {
+  return new Date(Date.UTC(year, month, day));
+}
+function monthsBefore(date, months) {
+  const lastDayOfTarget = utcDate(date.getUTCFullYear(), date.getUTCMonth() - months + 1, 0).getUTCDate();
+  return utcDate(date.getUTCFullYear(), date.getUTCMonth() - months, Math.min(date.getUTCDate(), lastDayOfTarget));
+}
+function equivalentBetween(literal, now) {
+  const upper2 = literal.toUpperCase();
+  const today = utcDate(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
+  const yesterday = utcDate(today.getUTCFullYear(), today.getUTCMonth(), today.getUTCDate() - 1);
+  const range = (from, to) => `BETWEEN '${isoDay(from)}' AND '${isoDay(to)}'`;
+  const year = today.getUTCFullYear();
+  const quarterStart = Math.floor(today.getUTCMonth() / 3) * 3;
+  const rolling = upper2.match(/^LAST_(\d+)_(DAYS|WEEKS|MONTHS|YEARS)$/);
+  if (rolling) {
+    const n = Number(rolling[1]);
+    const unit = rolling[2];
+    if (n < 1) return null;
+    if (unit === "DAYS" || unit === "WEEKS") {
+      const days = unit === "DAYS" ? n : n * 7;
+      return range(utcDate(year, today.getUTCMonth(), today.getUTCDate() - days), yesterday);
+    }
+    const months = unit === "MONTHS" ? n : n * 12;
+    return range(monthsBefore(today, months), yesterday);
+  }
+  switch (upper2) {
+    case "THIS_YEAR":
+      return range(utcDate(year, 0, 1), today);
+    case "LAST_YEAR":
+      return range(utcDate(year - 1, 0, 1), utcDate(year - 1, 11, 31));
+    case "THIS_QUARTER":
+      return range(utcDate(year, quarterStart, 1), today);
+    case "LAST_QUARTER":
+      return range(utcDate(year, quarterStart - 3, 1), utcDate(year, quarterStart, 0));
+    default:
+      return null;
+  }
+}
+function duringLiteralExplanation(literal, between) {
+  const accepted = GAQL_DURING_LITERALS.join(", ");
+  const lead = between ? `Google does not accept ${literal} after DURING. The same window as explicit dates is ${between}.` : `Google does not accept ${literal} after DURING, and it names no fixed window \u2014 use BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD', or drop the date filter.`;
+  return `${lead} DURING accepts only: ${accepted}. Any other window needs BETWEEN.`;
+}
+
 // src/commands/ads/google/changes-window.ts
+function monthlySpendTrendQuery(now = /* @__PURE__ */ new Date()) {
+  return `SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date ${equivalentBetween("LAST_12_MONTHS", now)}`;
+}
 function isChangeScope(value) {
   return CHANGE_SCOPES.includes(value);
 }
@@ -10186,7 +9799,7 @@ function lookbackTooLong(scope, days, max) {
     message: `Google's account history API reaches back ${CHANGE_SCOPE_MAX_DAYS.summary} days at most; ${days} days is outside that window.`,
     fix: {
       action: "use_different_resource",
-      explanation: "Do not abort \u2014 infer the change from performance instead. Query monthly metrics per campaign (SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS) to see which campaigns stopped or started spending. That shows what changed and when, though not who changed it. Older history exists only in the Google Ads web UI, which has no API \u2014 ask the user to check it if the 'who' matters."
+      explanation: `Do not abort \u2014 infer the change from performance instead. Query monthly metrics per campaign (${monthlySpendTrendQuery()}) to see which campaigns stopped or started spending. That shows what changed and when, though not who changed it. Older history exists only in the Google Ads web UI, which has no API \u2014 ask the user to check it if the 'who' matters.`
     }
   };
 }
@@ -10545,7 +10158,7 @@ var CORRECTION_RULES = [
     matchApiError: /changeStatusError\W{0,4}START_DATE_TOO_OLD/i,
     fix: () => ({
       action: "use_different_resource",
-      explanation: "Google's account history reaches back 90 days at most, and this query asks for more. Do not abort \u2014 infer the change from performance: SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS shows which campaigns started or stopped spending and when, though not who changed them. Anything older with attribution exists only in the Google Ads web UI, which has no API."
+      explanation: `Google's account history reaches back 90 days at most, and this query asks for more. Do not abort \u2014 infer the change from performance: ${monthlySpendTrendQuery()} shows which campaigns started or stopped spending and when, though not who changed them. Anything older with attribution exists only in the Google Ads web UI, which has no API.`
     })
   },
   // 18c. change_status rejects a date range it cannot bound. Google raises this both for
@@ -12372,9 +11985,16 @@ import { resolve } from "path";
 import { defineCommand as defineCommand28 } from "citty";
 
 // src/commands/ads/google/presets.ts
-var GAQL_DATE_RANGE_RE = /^(?:TODAY|YESTERDAY|LAST_7_DAYS|LAST_14_DAYS|LAST_30_DAYS|LAST_90_DAYS|THIS_MONTH|LAST_MONTH|THIS_QUARTER|LAST_QUARTER|THIS_YEAR|LAST_YEAR|ALL_TIME|BETWEEN\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'\s+AND\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}')$/i;
+var BETWEEN_RE = /^BETWEEN\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'\s+AND\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'$/i;
 function isValidDateRange(value) {
-  return GAQL_DATE_RANGE_RE.test(value.trim());
+  const trimmed = value.trim();
+  return isDuringLiteral(trimmed) || BETWEEN_RE.test(trimmed);
+}
+function dateRangeError(dateRange, now) {
+  if (/^[A-Za-z0-9_]+$/.test(dateRange.trim())) {
+    return `Invalid date range: "${dateRange}". ${duringLiteralExplanation(dateRange, equivalentBetween(dateRange, now))} Pass it as --date-range "BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'".`;
+  }
+  return `Invalid date range: "${dateRange}". Use a GAQL date literal (e.g. LAST_30_DAYS, TODAY) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'.`;
 }
 var SERVING_CHAINS = {
   keyword_view: ["campaign.status", "ad_group.status", "ad_group_criterion.status"],
@@ -12510,17 +12130,15 @@ function buildStatusScope(statusFields, includePaused) {
   const predicate = includePaused ? "!= 'REMOVED'" : "= 'ENABLED'";
   return statusFields.map((field) => ` AND ${field} ${predicate}`).join("");
 }
-function expandPreset(preset, params) {
+function expandPreset(preset, params, now = /* @__PURE__ */ new Date()) {
   const dateRange = params.dateRange ?? preset.defaultDateRange;
   const limit = params.limit ?? preset.defaultLimit;
-  if (!isValidDateRange(dateRange)) {
-    return {
-      query: "",
-      dateRangeError: `Invalid date range: "${dateRange}". Use a GAQL date literal (e.g. LAST_30_DAYS, TODAY) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'.`
-    };
+  if (preset.gaqlTemplate.includes("{dateRange}") && !isValidDateRange(dateRange)) {
+    return { query: "", dateRangeError: dateRangeError(dateRange, now) };
   }
   const statusScope = buildStatusScope(preset.statusFields, params.includePaused ?? false);
-  const query = preset.gaqlTemplate.replace(/\{dateRange\}/g, dateRange).replace(/\{limit\}/g, String(limit)).replace(/\{statusScope\}/g, statusScope);
+  const range = dateRange.trim();
+  const query = preset.gaqlTemplate.replace(/DURING\s+\{dateRange\}/g, BETWEEN_RE.test(range) ? range : `DURING ${range}`).replace(/\{dateRange\}/g, range).replace(/\{limit\}/g, String(limit)).replace(/\{statusScope\}/g, statusScope);
   return { query };
 }
 
@@ -12679,6 +12297,49 @@ function applyAutoFixes(query, limit) {
   }
   return { query: corrected, warnings };
 }
+var DURING_CLAUSE = /(?<=[a-z_]\.[a-z_.]+\s+)DURING\s+([A-Za-z0-9_]+)/gi;
+function rejectUnsupportedDuring(query, customerId) {
+  const unsupported = [...query.matchAll(DURING_CLAUSE)].map((match) => match[1] ?? "").filter((literal2) => !isDuringLiteral(literal2));
+  const literal = unsupported[0];
+  if (literal === void 0) return null;
+  const now = /* @__PURE__ */ new Date();
+  const between = equivalentBetween(literal, now);
+  const fixed = unsupported.every((l) => equivalentBetween(l, now) !== null) ? query.replace(
+    DURING_CLAUSE,
+    (clause, l) => isDuringLiteral(l) ? clause : equivalentBetween(l, now) ?? clause
+  ) : void 0;
+  return {
+    ok: false,
+    error: {
+      code: "INVALID_DATE_RANGE",
+      message: `DURING ${literal} is not a Google Ads date range, so Google would refuse this query.`,
+      fix: {
+        action: "narrow_date_range",
+        ...fixed ? { correctedCommand: buildCommand2(fixed, customerId) } : {},
+        explanation: duringLiteralExplanation(literal, between)
+      },
+      retryable: false
+    }
+  };
+}
+function rejectOversizedLimit(query, customerId) {
+  const match = query.match(/\bLIMIT\s+(\d+)\s*$/i);
+  if (!match || Number(match[1]) <= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE) return null;
+  const fixed = query.replace(/\bLIMIT\s+\d+\s*$/i, `LIMIT ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}`);
+  return {
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: `LIMIT ${match[1]} is more rows than one read can return (${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}).`,
+      fix: {
+        action: "retry_with_flag",
+        correctedCommand: buildCommand2(fixed, customerId),
+        explanation: `One query returns at most ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE} rows. For more, split the read into narrower queries \u2014 a shorter BETWEEN range each, or one campaign each \u2014 write each with --out, and combine the files.`
+      },
+      retryable: false
+    }
+  };
+}
 function validatePreflight(query, customerId, limit) {
   const warnings = [];
   const corrected = query;
@@ -12750,6 +12411,10 @@ function validatePreflight(query, customerId, limit) {
       }
     };
   }
+  const duringRejection = rejectUnsupportedDuring(corrected, customerId);
+  if (duringRejection) return { valid: false, warnings: [], error: duringRejection };
+  const limitRejection = rejectOversizedLimit(corrected, customerId);
+  if (limitRejection) return { valid: false, warnings: [], error: limitRejection };
   if (/\bsegments\.conversion_action_name\b/i.test(corrected) && /\bmetrics\.cost_micros\b/i.test(corrected)) {
     return {
       valid: false,
@@ -12958,7 +12623,7 @@ registerSchema({
     },
     "date-range": {
       type: "string",
-      description: "Date range for presets (LAST_7_DAYS, LAST_30_DAYS, LAST_90_DAYS, or BETWEEN 'X' AND 'Y')",
+      description: "Date range for presets: a Google date literal (TODAY, YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH \u2026) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'. Google has no LAST_90_DAYS \u2014 use BETWEEN for any other window.",
       required: false
     },
     "include-paused": {
@@ -12968,7 +12633,7 @@ registerSchema({
     },
     limit: {
       type: "number",
-      description: "Max rows in ONE page (default 200), AND the LIMIT added to a query that has none \u2014 so it caps the whole read with --all too. Values up to 10000 are accepted. Any read that fills this cap comes back flagged TRUNCATED_RESULTS \u2014 never count or total from one.",
+      description: "Max rows in ONE page (default 200), AND the LIMIT added to a query that has none \u2014 so it caps the whole read with --all too. Values up to 8192 are accepted \u2014 the most one read can return. Any read that fills this cap comes back flagged TRUNCATED_RESULTS \u2014 never count or total from one.",
       required: false,
       default: 200
     },
@@ -12976,7 +12641,7 @@ registerSchema({
     cursor: { type: "string", description: "Pagination cursor from previous response", required: false },
     all: {
       type: "boolean",
-      description: "Follow every page until the data set is exhausted (use with --out for large datasets). Needed for a read you may count or total, but not sufficient: it exhausts the pages, not the statement's LIMIT, so pair it with a --limit above the row count you expect (or your own LIMIT) and check the read came back without TRUNCATED_RESULTS.",
+      description: "Follow every page until the data set is exhausted (use with --out for large datasets). Needed for a read you may count or total, but not sufficient: it exhausts the pages, not the statement's LIMIT, so pair it with a LIMIT in the statement above the row count you expect (at most 8192 \u2014 split bigger reads into narrower queries) and check the read came back without TRUNCATED_RESULTS.",
       required: false
     },
     out: {
@@ -13063,7 +12728,8 @@ function completenessWarnings(read) {
   const filledTheCap = cap3 !== void 0 && cap3 > 0 && read.rowCount >= cap3;
   if (!read.hasMore && !filledTheCap) return [];
   const cause = read.hasMore ? `More rows are waiting: the account returned a next-page cursor this run did not follow.` : `The ${read.rowCount} rows returned exactly fill the row cap in force (${cap3}).`;
-  const fix = read.all ? `Every page was followed, so the cap is the LIMIT in the statement itself \u2014 raise it above ${cap3}, or drop it and pass a larger --limit, then re-run.` : `Re-run with --all --out <file> to page through everything, or raise --limit above ${cap3}.`;
+  const atPageCap = cap3 !== void 0 && cap3 >= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE;
+  const fix = atPageCap ? `${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE} rows is the most one read can return \u2014 split it into narrower queries (a shorter BETWEEN range each, or one campaign each), write each with --out, and combine the files.` : read.all ? `Every page was followed, so the cap is the LIMIT in the statement itself \u2014 raise it above ${cap3}, or drop it and pass a larger --limit (up to ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}), then re-run.` : `Re-run with --all --out <file> to page through everything, or raise --limit above ${cap3} (up to ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}).`;
   return [
     {
       code: "TRUNCATED_RESULTS",
@@ -13135,8 +12801,8 @@ var writeMdRows = (rows, fields, notices) => {
 };
 var ROW_WRITERS = { csv: writeCsvRows, jsonl: writeJsonlRows, md: writeMdRows };
 function writeRows(format, rows, columns, notices) {
-  const write2 = ROW_WRITERS[format] ?? writeMdRows;
-  write2(rows, columns, notices);
+  const write = ROW_WRITERS[format] ?? writeMdRows;
+  write(rows, columns, notices);
   if (rows.length > REPEAT_NOTICE_ABOVE_ROWS) {
     for (const line of notices) writeLine(line);
   }
@@ -13397,9 +13063,35 @@ async function executeQuery(finalQuery, args5, customerId, limit, warnings, useC
 function shouldReadCache(args5) {
   return !args5["no-cache"] && !args5.out;
 }
+var DEFAULT_QUERY_LIMIT = 200;
+function parseQueryLimit(raw) {
+  if (raw === void 0 || raw === null || raw === "") return { ok: true, limit: DEFAULT_QUERY_LIMIT };
+  const limit = Number(raw);
+  if (Number.isInteger(limit) && limit >= 1 && limit <= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE) return { ok: true, limit };
+  return {
+    ok: false,
+    error: {
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: `--limit must be a whole number from 1 to ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}, got '${String(raw)}'.`,
+        fix: {
+          action: "retry_with_flag",
+          explanation: `One read returns at most ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE} rows. For more, split the read into narrower queries (a shorter BETWEEN range each, or one campaign each), write each with --out, and combine the files.`
+        },
+        retryable: false
+      }
+    }
+  };
+}
 async function validateArgs(args5) {
+  const parsedLimit = parseQueryLimit(args5.limit);
+  if (!parsedLimit.ok) {
+    writeAdsJson(parsedLimit.error);
+    process.exit(1);
+  }
+  const { limit } = parsedLimit;
   const customerId = await resolveCustomerId(args5);
-  const limit = args5.limit ? Number(args5.limit) : 200;
   const gaql = resolveGaql(args5, limit);
   if (!gaql) {
     process.exit(1);
@@ -22339,7 +22031,7 @@ Subcommands:
 
 // src/commands/ads/linkedin/creatives.ts
 import { defineCommand as defineCommand44 } from "citty";
-function asRecord2(value) {
+function asRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
 }
 function asString(value) {
@@ -22349,12 +22041,12 @@ function creativeDestination(content) {
   if (!content) return { format: "unknown" };
   const reference = asString(content.reference);
   if (reference) return { format: "post", postUrn: reference };
-  const textAd = asRecord2(content.textAd);
+  const textAd = asRecord(content.textAd);
   if (textAd) return { format: "text", landingUrl: asString(textAd.landingPage) };
-  const spotlight = asRecord2(content.spotlight);
+  const spotlight = asRecord(content.spotlight);
   if (spotlight) return { format: "spotlight", landingUrl: asString(spotlight.landingPage) };
-  if (asRecord2(content.follower)) return { format: "follower" };
-  if (asRecord2(content.jobs)) return { format: "jobs" };
+  if (asRecord(content.follower)) return { format: "follower" };
+  if (asRecord(content.jobs)) return { format: "jobs" };
   return { format: "unknown" };
 }
 var COMPACT_COLUMNS = [
@@ -22385,7 +22077,7 @@ function compactRow(row) {
 function readPath(row, path48) {
   let current = row;
   for (const segment of path48.split(".")) {
-    const record = asRecord2(current);
+    const record = asRecord(current);
     if (!record) return void 0;
     current = record[segment];
   }
@@ -25758,10 +25450,10 @@ Example: baker ads meta ads retag 120252158038400247 --url-tags "utm_source={{si
     }
   },
   run: async ({ args: args5 }) => {
-    const { apiPost: apiPost2 } = await import("./client-PWRZOA3Q.js");
-    const { requireChatId: requireChatId2 } = await import("./env-TQTHWLBN.js");
-    const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-HD63GTWI.js");
-    const { handleMetaError: handleMetaError2 } = await import("./shared-5662SBDW.js");
+    const { apiPost: apiPost2 } = await import("./client-ODCNYCP4.js");
+    const { requireChatId: requireChatId2 } = await import("./env-BSG7TY5Y.js");
+    const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-2XBCYF7L.js");
+    const { handleMetaError: handleMetaError2 } = await import("./shared-RYAF7Y7H.js");
     try {
       const accountId = bareAccountId2(args5);
       const urlTags = typeof args5["url-tags"] === "string" ? args5["url-tags"] : void 0;
@@ -25906,10 +25598,10 @@ function duplicateCommand2(entity, label) {
       replace: { type: "boolean", description: "Pause the original once the copy publishes" }
     },
     run: async ({ args: args5 }) => {
-      const { apiPost: apiPost2 } = await import("./client-PWRZOA3Q.js");
-      const { requireChatId: requireChatId2 } = await import("./env-TQTHWLBN.js");
-      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-HD63GTWI.js");
-      const { handleMetaError: handleMetaError2 } = await import("./shared-5662SBDW.js");
+      const { apiPost: apiPost2 } = await import("./client-ODCNYCP4.js");
+      const { requireChatId: requireChatId2 } = await import("./env-BSG7TY5Y.js");
+      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-2XBCYF7L.js");
+      const { handleMetaError: handleMetaError2 } = await import("./shared-RYAF7Y7H.js");
       try {
         const accountId = bareAccountId2(args5);
         const chatId = requireChatId2();
@@ -31085,6 +30777,286 @@ function mergeStoredWithCounts(stored, reported) {
   }).sort((a, b) => a.name.localeCompare(b.name));
 }
 
+// src/commands/analytics/render.ts
+var SPARKLINE_POINTS = 30;
+var DASHBOARD_ONLY_FIELDS = /* @__PURE__ */ new Set([
+  // The Convex row id. It exists so a dashboard can link to the row; an agent
+  // addresses a landing by `landingId`, which is the id in its `_definition.md`.
+  "landingRef"
+]);
+function isAbsent(value) {
+  if (value === "") return true;
+  if (Array.isArray(value)) return value.length === 0;
+  if (typeof value === "object" && value !== null) return Object.keys(value).length === 0;
+  return false;
+}
+function resample(series, points) {
+  if (series.length <= points || points < 1) return [...series];
+  const out = [];
+  for (let i = 0; i < points; i += 1) {
+    const from = Math.floor(i * series.length / points);
+    const to = Math.floor((i + 1) * series.length / points);
+    let sum = 0;
+    for (let j = from; j < to; j += 1) sum += series[j] ?? 0;
+    out.push(sum);
+  }
+  return out;
+}
+function pruneValue(value, full) {
+  if (Array.isArray(value)) return value.map((entry) => pruneValue(entry, full));
+  if (typeof value === "object" && value !== null) {
+    return pruneRow(value, full);
+  }
+  return value;
+}
+function pruneRow(row, full) {
+  const out = {};
+  for (const [key, value] of Object.entries(row)) {
+    if (DASHBOARD_ONLY_FIELDS.has(key)) continue;
+    if (key === "sparkline" && Array.isArray(value)) {
+      if (!full) continue;
+      out[key] = resample(value, SPARKLINE_POINTS);
+      continue;
+    }
+    if (isAbsent(value)) continue;
+    out[key] = pruneValue(value, full);
+  }
+  return out;
+}
+function pruneForAgent(data, full) {
+  return pruneRow(data, full);
+}
+function isTabular(rows) {
+  return rows.every(
+    (row) => typeof row === "object" && row !== null && !Array.isArray(row) && Object.values(row).every(
+      (value) => value === null || typeof value !== "object" || Array.isArray(value) && value.every((e) => typeof e !== "object")
+    )
+  );
+}
+function cell2(value, key) {
+  if (value === null || value === void 0) return "";
+  if (Array.isArray(value)) return value.join(" ");
+  if (typeof value === "number" && !Number.isInteger(value)) {
+    if (key?.endsWith("Ms")) return String(Math.round(value));
+    return value.toFixed(4).replace(/0+$/, "").replace(/\.$/, "");
+  }
+  return String(value);
+}
+var IDENTITY_COLUMNS = [
+  "landingId",
+  "name",
+  "slug",
+  "path",
+  "flowSlug",
+  "stepId",
+  "value",
+  "key",
+  "bucket",
+  "tag",
+  "eventName",
+  "release",
+  "place",
+  "bot",
+  "source",
+  "medium",
+  "campaign",
+  "platform",
+  "sessionId",
+  "eventId"
+];
+function byIdentityFirst(a, b) {
+  const ia = IDENTITY_COLUMNS.indexOf(a);
+  const ib = IDENTITY_COLUMNS.indexOf(b);
+  if (ia !== -1 || ib !== -1)
+    return (ia === -1 ? Number.MAX_SAFE_INTEGER : ia) - (ib === -1 ? Number.MAX_SAFE_INTEGER : ib);
+  return 0;
+}
+var BLOCK_ORDER = ["window", "totals", "previous", "pageInfo"];
+function byBlockOrder(a, b) {
+  const rank = (key) => {
+    const at = BLOCK_ORDER.indexOf(key);
+    if (at !== -1) return at;
+    return key === "preset" ? BLOCK_ORDER.length + 1 : BLOCK_ORDER.length;
+  };
+  return rank(a) - rank(b);
+}
+function columnsOf(rows) {
+  const seen = [];
+  for (const row of rows) {
+    for (const key of Object.keys(row)) {
+      if (!seen.includes(key)) seen.push(key);
+    }
+  }
+  return seen.filter((key) => rows.some((row) => !isAbsent(row[key]) && row[key] !== null && row[key] !== void 0)).sort(byIdentityFirst);
+}
+function table2(rows) {
+  const cols = columnsOf(rows);
+  if (cols.length === 0) return "";
+  const head = `| ${cols.join(" | ")} |`;
+  const rule = `| ${cols.map(() => "---").join(" | ")} |`;
+  const body = rows.map((row) => `| ${cols.map((col) => cell2(row[col], col)).join(" | ")} |`);
+  return [head, rule, ...body].join("\n");
+}
+function isRowList(value) {
+  return Array.isArray(value) && value.length > 0 && value.every((entry) => typeof entry === "object" && entry !== null && !Array.isArray(entry));
+}
+function labelOf(row, index) {
+  for (const key of IDENTITY_COLUMNS) {
+    const value = row[key];
+    if (typeof value === "string" && value !== "") return value;
+  }
+  return `#${index + 1}`;
+}
+function nestedBlock(name, rows) {
+  const parents = rows.map(
+    (row) => Object.fromEntries(Object.entries(row).filter(([, value]) => !isRowList(value) && !isPlainRow(value)))
+  );
+  const parts = [`### ${name}`, table2(parents)];
+  rows.forEach((row, index) => {
+    for (const [key, value] of Object.entries(row)) {
+      if (isRowList(value)) parts.push(`#### ${name}[${labelOf(row, index)}].${key}`, table2(value));
+      else if (isPlainRow(value)) parts.push(`#### ${name}[${labelOf(row, index)}].${key}`, table2([value]));
+    }
+  });
+  return parts.filter((part) => part !== "").join("\n");
+}
+function isPlainRow(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function block(name, value) {
+  if (Array.isArray(value)) {
+    if (value.length === 0) return "";
+    if (isTabular(value)) return `### ${name}
+${table2(value)}`;
+    if (isRowList(value)) return nestedBlock(name, value);
+    return `### ${name}
+${JSON.stringify(value)}`;
+  }
+  if (typeof value === "object" && value !== null) {
+    const entries = Object.entries(value);
+    if (entries.length === 0) return "";
+    if (entries.every(([, v]) => v === null || typeof v !== "object")) {
+      return `### ${name}
+${entries.map(([k, v]) => `- ${k}: ${v === null ? "null" : cell2(v, k)}`).join("\n")}`;
+    }
+    return `### ${name}
+${JSON.stringify(value)}`;
+  }
+  return `### ${name}
+${cell2(value)}`;
+}
+function renderMarkdown3(envelope) {
+  const parts = [];
+  for (const warning of envelope.warnings ?? []) parts.push(`> **${warning.code}** \u2014 ${warning.message}`);
+  for (const hint of envelope.hints ?? []) parts.push(`> ${hint}`);
+  for (const [name, value] of Object.entries(envelope.data).sort(([a], [b]) => byBlockOrder(a, b))) {
+    const rendered = block(name, value);
+    if (rendered !== "") parts.push(rendered);
+  }
+  return `${parts.join("\n\n")}
+`;
+}
+function missingBreakdownHint(data, asked) {
+  if (asked.eventName === void 0) return [];
+  const breakdown = data.eventBreakdown;
+  if (Array.isArray(breakdown) && breakdown.length > 0) return [];
+  const known = Array.isArray(data.customEvents) ? data.customEvents.flatMap((row) => isPlainRow(row) && typeof row.eventName === "string" ? [row.eventName] : []) : [];
+  return [
+    `No rows came back for --event ${asked.eventName}${asked.property ? ` --property ${asked.property}` : ""}. That event or property does not exist on these pages${known.length > 0 ? `; the ones that do are: ${known.slice(0, 12).join(", ")}${known.length > 12 ? ", \u2026" : ""}` : ""}.`
+  ];
+}
+var ANALYTICS_OUTPUT_FORMATS = ["json", "md"];
+function isAnalyticsOutputFormat(value) {
+  return ANALYTICS_OUTPUT_FORMATS.includes(value);
+}
+function writeAnalyticsReport(envelope, format) {
+  if (format === "md") {
+    process.stdout.write(renderMarkdown3(envelope));
+    return;
+  }
+  process.stdout.write(`${JSON.stringify(envelope)}
+`);
+}
+var ROWS_BEFORE_FORMAT_HINT = 25;
+function rowCount(data) {
+  let total = 0;
+  for (const value of Object.values(data)) {
+    if (Array.isArray(value)) total += value.length;
+  }
+  return total;
+}
+function formatHint(data, format) {
+  if (format === "md") return [];
+  const rows = rowCount(data);
+  if (rows < ROWS_BEFORE_FORMAT_HINT) return [];
+  return [
+    `This report is ${rows} rows. If you are going to read the numbers rather than pick one field out of them, --output md returns the same answer as tables, typically a third to a half smaller.`
+  ];
+}
+
+// src/commands/analytics/conversionsMarkdown.ts
+function doorsCell(doors) {
+  return doors.map((door) => `${door.door}=${door.events}/${door.sessions}`).join(" ");
+}
+function eventKeysCell(eventKeys) {
+  const formKeys = eventKeys.filter((key) => key.startsWith("form:")).length;
+  const others = eventKeys.filter((key) => !key.startsWith("form:"));
+  return [...others, ...formKeys > 0 ? [`${formKeys} Form ending(s)`] : []].join(" + ");
+}
+function trafficByForm(candidates) {
+  const byForm = /* @__PURE__ */ new Map();
+  for (const row of candidates) {
+    const form = byForm.get(row.flowSlug) ?? { "endings seen": 0, "endings counted": 0, events: 0, lastSeen: "" };
+    if (row.events > 0) form["endings seen"] += 1;
+    if (row.isCounted) form["endings counted"] += 1;
+    form.events += row.events;
+    if (row.lastSeen && row.lastSeen.slice(0, 10) > form.lastSeen) form.lastSeen = row.lastSeen.slice(0, 10);
+    byForm.set(row.flowSlug, form);
+  }
+  return byForm;
+}
+var NO_TRAFFIC = { "endings seen": 0, "endings counted": 0, events: 0, lastSeen: "" };
+var FORM_KEYS_HINT = "A Form's candidates are one row per Form: `baker analytics conversions --flow <slug>` lists that Form's event keys, and `--candidates --output json` lists every key.";
+function renderConversionsMarkdown(envelope) {
+  const { definitions, flow, flows, candidates } = envelope.data;
+  const data = {
+    definitions: definitions.map(({ name, eventKeys, ...row }) => ({
+      name,
+      eventKeys: eventKeysCell(eventKeys),
+      ...row
+    }))
+  };
+  if (flow) {
+    data.flow = { slug: flow.slug, noConversionReason: flow.noConversionReason };
+    data.flowEndings = flow.endings;
+  }
+  const traffic = candidates ? trafficByForm(candidates.filter((row) => row.flowSlug !== "")) : /* @__PURE__ */ new Map();
+  if (flows) {
+    data.flows = flows.map((row) => ({
+      slug: row.slug,
+      counted: row.counted.map((entry) => `${entry.name} @ ${entry.step}`).join("; "),
+      noConversion: row.noConversion,
+      ...candidates ? traffic.get(row.slug) ?? NO_TRAFFIC : {}
+    }));
+  }
+  const hints2 = [...envelope.hints ?? []];
+  if (candidates) {
+    const listed2 = new Set(flows?.map((row) => row.slug));
+    const unlisted = [...traffic].filter(([slug]) => !listed2.has(slug));
+    if (unlisted.length > 0) data.formCandidates = unlisted.map(([form, row]) => ({ form, ...row }));
+    data.candidates = candidates.filter((row) => row.flowSlug === "").map(({ doors, flowSlug: _flowSlug, nodeType: _nodeType, ...row }) => ({
+      ...row,
+      "doors (events/sessions)": doorsCell(doors)
+    }));
+    if (traffic.size > 0) hints2.push(FORM_KEYS_HINT);
+  }
+  return renderMarkdown3({ data, ...hints2.length > 0 ? { hints: hints2 } : {} });
+}
+function withFormatHint(envelope, format) {
+  const hints2 = [...envelope.hints ?? [], ...formatHint(envelope.data, format)];
+  return { ...envelope, ...hints2.length > 0 ? { hints: hints2 } : {} };
+}
+
 // src/commands/analytics/errorEnvelope.ts
 function analyticsErrorEnvelope(err) {
   if (err instanceof ApiError) {
@@ -31576,223 +31548,6 @@ var ANALYTICS_PRESET_INFO = [
   }
 ];
 
-// src/commands/analytics/render.ts
-var SPARKLINE_POINTS = 30;
-var DASHBOARD_ONLY_FIELDS = /* @__PURE__ */ new Set([
-  // The Convex row id. It exists so a dashboard can link to the row; an agent
-  // addresses a landing by `landingId`, which is the id in its `_definition.md`.
-  "landingRef"
-]);
-function isAbsent(value) {
-  if (value === "") return true;
-  if (Array.isArray(value)) return value.length === 0;
-  if (typeof value === "object" && value !== null) return Object.keys(value).length === 0;
-  return false;
-}
-function resample(series, points) {
-  if (series.length <= points || points < 1) return [...series];
-  const out = [];
-  for (let i = 0; i < points; i += 1) {
-    const from = Math.floor(i * series.length / points);
-    const to = Math.floor((i + 1) * series.length / points);
-    let sum = 0;
-    for (let j = from; j < to; j += 1) sum += series[j] ?? 0;
-    out.push(sum);
-  }
-  return out;
-}
-function pruneValue(value, full) {
-  if (Array.isArray(value)) return value.map((entry) => pruneValue(entry, full));
-  if (typeof value === "object" && value !== null) {
-    return pruneRow(value, full);
-  }
-  return value;
-}
-function pruneRow(row, full) {
-  const out = {};
-  for (const [key, value] of Object.entries(row)) {
-    if (DASHBOARD_ONLY_FIELDS.has(key)) continue;
-    if (key === "sparkline" && Array.isArray(value)) {
-      if (!full) continue;
-      out[key] = resample(value, SPARKLINE_POINTS);
-      continue;
-    }
-    if (isAbsent(value)) continue;
-    out[key] = pruneValue(value, full);
-  }
-  return out;
-}
-function pruneForAgent(data, full) {
-  return pruneRow(data, full);
-}
-function isTabular(rows) {
-  return rows.every(
-    (row) => typeof row === "object" && row !== null && !Array.isArray(row) && Object.values(row).every(
-      (value) => value === null || typeof value !== "object" || Array.isArray(value) && value.every((e) => typeof e !== "object")
-    )
-  );
-}
-function cell2(value, key) {
-  if (value === null || value === void 0) return "";
-  if (Array.isArray(value)) return value.join(" ");
-  if (typeof value === "number" && !Number.isInteger(value)) {
-    if (key?.endsWith("Ms")) return String(Math.round(value));
-    return value.toFixed(4).replace(/0+$/, "").replace(/\.$/, "");
-  }
-  return String(value);
-}
-var IDENTITY_COLUMNS = [
-  "landingId",
-  "name",
-  "slug",
-  "path",
-  "flowSlug",
-  "stepId",
-  "value",
-  "key",
-  "bucket",
-  "tag",
-  "eventName",
-  "release",
-  "place",
-  "bot",
-  "source",
-  "medium",
-  "campaign",
-  "platform",
-  "sessionId",
-  "eventId"
-];
-function byIdentityFirst(a, b) {
-  const ia = IDENTITY_COLUMNS.indexOf(a);
-  const ib = IDENTITY_COLUMNS.indexOf(b);
-  if (ia !== -1 || ib !== -1)
-    return (ia === -1 ? Number.MAX_SAFE_INTEGER : ia) - (ib === -1 ? Number.MAX_SAFE_INTEGER : ib);
-  return 0;
-}
-var BLOCK_ORDER = ["window", "totals", "previous", "pageInfo"];
-function byBlockOrder(a, b) {
-  const rank = (key) => {
-    const at = BLOCK_ORDER.indexOf(key);
-    if (at !== -1) return at;
-    return key === "preset" ? BLOCK_ORDER.length + 1 : BLOCK_ORDER.length;
-  };
-  return rank(a) - rank(b);
-}
-function columnsOf(rows) {
-  const seen = [];
-  for (const row of rows) {
-    for (const key of Object.keys(row)) {
-      if (!seen.includes(key)) seen.push(key);
-    }
-  }
-  return seen.filter((key) => rows.some((row) => !isAbsent(row[key]) && row[key] !== null && row[key] !== void 0)).sort(byIdentityFirst);
-}
-function table2(rows) {
-  const cols = columnsOf(rows);
-  if (cols.length === 0) return "";
-  const head = `| ${cols.join(" | ")} |`;
-  const rule = `| ${cols.map(() => "---").join(" | ")} |`;
-  const body = rows.map((row) => `| ${cols.map((col) => cell2(row[col], col)).join(" | ")} |`);
-  return [head, rule, ...body].join("\n");
-}
-function isRowList(value) {
-  return Array.isArray(value) && value.length > 0 && value.every((entry) => typeof entry === "object" && entry !== null && !Array.isArray(entry));
-}
-function labelOf(row, index) {
-  for (const key of IDENTITY_COLUMNS) {
-    const value = row[key];
-    if (typeof value === "string" && value !== "") return value;
-  }
-  return `#${index + 1}`;
-}
-function nestedBlock(name, rows) {
-  const parents = rows.map(
-    (row) => Object.fromEntries(Object.entries(row).filter(([, value]) => !isRowList(value) && !isPlainRow(value)))
-  );
-  const parts = [`### ${name}`, table2(parents)];
-  rows.forEach((row, index) => {
-    for (const [key, value] of Object.entries(row)) {
-      if (isRowList(value)) parts.push(`#### ${name}[${labelOf(row, index)}].${key}`, table2(value));
-      else if (isPlainRow(value)) parts.push(`#### ${name}[${labelOf(row, index)}].${key}`, table2([value]));
-    }
-  });
-  return parts.filter((part) => part !== "").join("\n");
-}
-function isPlainRow(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function block(name, value) {
-  if (Array.isArray(value)) {
-    if (value.length === 0) return "";
-    if (isTabular(value)) return `### ${name}
-${table2(value)}`;
-    if (isRowList(value)) return nestedBlock(name, value);
-    return `### ${name}
-${JSON.stringify(value)}`;
-  }
-  if (typeof value === "object" && value !== null) {
-    const entries = Object.entries(value);
-    if (entries.length === 0) return "";
-    if (entries.every(([, v]) => v === null || typeof v !== "object")) {
-      return `### ${name}
-${entries.map(([k, v]) => `- ${k}: ${v === null ? "null" : cell2(v, k)}`).join("\n")}`;
-    }
-    return `### ${name}
-${JSON.stringify(value)}`;
-  }
-  return `### ${name}
-${cell2(value)}`;
-}
-function renderMarkdown3(envelope) {
-  const parts = [];
-  for (const warning of envelope.warnings ?? []) parts.push(`> **${warning.code}** \u2014 ${warning.message}`);
-  for (const hint of envelope.hints ?? []) parts.push(`> ${hint}`);
-  for (const [name, value] of Object.entries(envelope.data).sort(([a], [b]) => byBlockOrder(a, b))) {
-    const rendered = block(name, value);
-    if (rendered !== "") parts.push(rendered);
-  }
-  return `${parts.join("\n\n")}
-`;
-}
-function missingBreakdownHint(data, asked) {
-  if (asked.eventName === void 0) return [];
-  const breakdown = data.eventBreakdown;
-  if (Array.isArray(breakdown) && breakdown.length > 0) return [];
-  const known = Array.isArray(data.customEvents) ? data.customEvents.flatMap((row) => isPlainRow(row) && typeof row.eventName === "string" ? [row.eventName] : []) : [];
-  return [
-    `No rows came back for --event ${asked.eventName}${asked.property ? ` --property ${asked.property}` : ""}. That event or property does not exist on these pages${known.length > 0 ? `; the ones that do are: ${known.slice(0, 12).join(", ")}${known.length > 12 ? ", \u2026" : ""}` : ""}.`
-  ];
-}
-var ANALYTICS_OUTPUT_FORMATS = ["json", "md"];
-function isAnalyticsOutputFormat(value) {
-  return ANALYTICS_OUTPUT_FORMATS.includes(value);
-}
-function writeAnalyticsReport(envelope, format) {
-  if (format === "md") {
-    process.stdout.write(renderMarkdown3(envelope));
-    return;
-  }
-  process.stdout.write(`${JSON.stringify(envelope)}
-`);
-}
-var ROWS_BEFORE_FORMAT_HINT = 25;
-function rowCount(data) {
-  let total = 0;
-  for (const value of Object.values(data)) {
-    if (Array.isArray(value)) total += value.length;
-  }
-  return total;
-}
-function formatHint(data, format) {
-  if (format === "md") return [];
-  const rows = rowCount(data);
-  if (rows < ROWS_BEFORE_FORMAT_HINT) return [];
-  return [
-    `This report is ${rows} rows. If you are going to read the numbers rather than pick one field out of them, --output md returns the same answer as tables, typically a third to a half smaller.`
-  ];
-}
-
 // src/commands/analytics/sends.ts
 import { defineCommand as defineCommand97 } from "citty";
 var SET_FLAGS = ["--source-event", "--platform", "--tag", "--event"];
@@ -32967,17 +32722,7 @@ async function runPreset(args5, options) {
     const response = await apiPost("/api/analytics/query", requestBody(args5, options));
     const requestedPlatform = args5.platform === void 0 ? "" : String(args5.platform);
     const adPlatformScope = isAdPlatform(requestedPlatform) ? requestedPlatform : void 0;
-    const format = args5.output === void 0 ? "json" : String(args5.output);
-    if (!isAnalyticsOutputFormat(format)) {
-      writeJsonEnvelope({
-        ok: false,
-        error: {
-          code: "VALIDATION_ERROR",
-          message: `Unknown --output "${format}". Use one of: ${ANALYTICS_OUTPUT_FORMATS.join(", ")}.`
-        }
-      });
-      process.exit(1);
-    }
+    const format = outputFormatOrExit(args5.output);
     const data = pruneForAgent(response.data, args5.full === true);
     const feed = "stream" in data ? shapeFeed(data.stream, args5.everything === true) : void 0;
     if (feed !== void 0) data.stream = feed.rows;
@@ -33007,6 +32752,20 @@ async function runPreset(args5, options) {
     handleError3(err);
   }
 }
+function outputFormatOrExit(raw) {
+  const format = raw === void 0 ? "json" : String(raw);
+  if (!isAnalyticsOutputFormat(format)) {
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: `Unknown --output "${format}". Use one of: ${ANALYTICS_OUTPUT_FORMATS.join(", ")}.`
+      }
+    });
+    process.exit(1);
+  }
+  return format;
+}
 function presetCommand(options) {
   registerSchema({
     command: `analytics.${options.name}`,
@@ -33508,7 +33267,8 @@ var conversionsCommand3 = (() => {
       type: "string",
       description: "Lookback for the counts and for --candidates. Default 30",
       required: false
-    }
+    },
+    output: SHARED_ARGS.output
   };
   registerSchema({
     command: "analytics.conversions",
@@ -33523,22 +33283,23 @@ var conversionsCommand3 = (() => {
     args: args5,
     run: async ({ args: raw }) => {
       try {
+        const format = outputFormatOrExit(raw.output);
         const args6 = parseConversionsArgs(raw, process.argv);
         for (const eventKey of args6.eventKeys) refuseUnmatchableKey(eventKey);
         const before = await apiPost("/api/analytics/conversions", {});
-        const write2 = conversionsWrite(args6, before.data.definitions);
-        const stored = write2 ? (await apiPost("/api/analytics/conversions", write2)).data.definitions : before.data.definitions;
+        const write = conversionsWrite(args6, before.data.definitions);
+        const stored = write ? (await apiPost("/api/analytics/conversions", write)).data.definitions : before.data.definitions;
         const report = await apiPost("/api/analytics/query", {
           preset: "conversions",
           days: args6.days
         });
-        writeJsonEnvelope(
-          conversionsEnvelope(
-            args6,
-            mergeStoredWithCounts(stored, report.data.conversions ?? []),
-            report.data.eventCatalog ?? []
-          )
+        const envelope = conversionsEnvelope(
+          args6,
+          mergeStoredWithCounts(stored, report.data.conversions ?? []),
+          report.data.eventCatalog ?? []
         );
+        if (format === "md") process.stdout.write(renderConversionsMarkdown(envelope));
+        else writeJsonEnvelope(withFormatHint(envelope, format));
       } catch (err) {
         if (err instanceof ConversionArgsError) {
           handleError3(new ApiError("VALIDATION_ERROR", err.message));
@@ -33903,11 +33664,7 @@ function rosterRow(avatar) {
   };
 }
 function chatIdFromEnv() {
-  try {
-    return getEnv().BAKER_CHAT_ID || void 0;
-  } catch {
-    return void 0;
-  }
+  return optionalChatId();
 }
 function rosterHints(roster, statusFilter) {
   if (roster.length === 0) {
@@ -35761,15 +35518,38 @@ import { defineCommand as defineCommand119 } from "citty";
 
 // src/commands/canvas/catalog.ts
 import { defineCommand as defineCommand108 } from "citty";
-var catalogCommand = defineCommand108({
-  meta: {
-    name: "catalog",
-    description: "Print the agent-facing node catalog (JSON Schema). Includes every registered node grouped by category."
+var DESCRIPTION = "The canvas node catalog. Start here: `baker canvas catalog` lists every node by category with one line each (a few KB). Then `--node video_generate` prints that node's full JSON Schema \u2014 params, inputs, outputs, models, when to use it. `--category image` narrows the list; add `--full` for that category's schemas. `--full` alone prints every schema (~160 KB) \u2014 prefer `--node`.";
+var ARGS = {
+  node: {
+    type: "string",
+    required: false,
+    description: "Node id(s) whose full schema to print, comma-separated. Example: --node video_generate,tts"
   },
-  async run() {
-    const cat = await generateCatalog(defaultRegistry());
-    process.stdout.write(`${JSON.stringify(cat, null, 2)}
+  category: {
+    type: "string",
+    required: false,
+    description: "Only this category (audio, video, image, \u2026). Listed with one line per node unless --full."
+  },
+  full: {
+    type: "boolean",
+    required: false,
+    default: false,
+    description: "Print full JSON Schemas instead of the one-line index (every node, or the --category)."
+  }
+};
+registerSchema({ command: "canvas.catalog", description: DESCRIPTION, args: ARGS });
+var catalogCommand = defineCommand108({
+  meta: { name: "catalog", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args: args5 }) {
+    const view = catalogView(generateCatalog(defaultRegistry()), {
+      node: typeof args5.node === "string" ? args5.node : void 0,
+      category: typeof args5.category === "string" ? args5.category : void 0,
+      full: args5.full === true
+    });
+    process.stdout.write(`${JSON.stringify(view, null, 2)}
 `);
+    if (!view.ok) process.exit(1);
   }
 });
 
@@ -39436,7 +39216,7 @@ function sceneSpokenText(scene) {
   return (scene.dialogue ?? []).map((d) => d.line?.trim()).filter((l) => Boolean(l)).join(" ") || null;
 }
 function buildMotionBoard(blueprint) {
-  const round5 = (n) => Math.round(n * 100) / 100;
+  const round4 = (n) => Math.round(n * 100) / 100;
   let cursor = 0;
   return blueprint.scenes.map((scene, i) => {
     const start_s = scene.start_s ?? cursor;
@@ -39448,15 +39228,15 @@ function buildMotionBoard(blueprint) {
     const graphics = [
       ...(overlays.success ? overlays.data : []).filter((ov) => ov.text?.trim()).map((ov) => ({
         kind: "text",
-        at_s: round5(ov.appears_at_s ?? start_s),
-        dur_s: round5(ov.duration_s ?? 2.5),
+        at_s: round4(ov.appears_at_s ?? start_s),
+        dur_s: round4(ov.duration_s ?? 2.5),
         position: ov.position ?? "bottom_center",
         text: ov.text?.trim()
       })),
       ...(floats.success ? floats.data : []).map((fe) => ({
         kind: "graphic",
-        at_s: round5(fe.appears_at_s ?? start_s),
-        dur_s: round5(fe.duration_s ?? 2.5),
+        at_s: round4(fe.appears_at_s ?? start_s),
+        dur_s: round4(fe.duration_s ?? 2.5),
         position: fe.position ?? "bottom_center",
         label: fe.brand_name || fe.what_it_represents || fe.description || fe.kind || "element"
       }))
@@ -39464,7 +39244,7 @@ function buildMotionBoard(blueprint) {
     return {
       scene: i,
       role: resolveSceneRole(scene, i, blueprint.scenes.length),
-      window_s: [round5(start_s), round5(end_s)],
+      window_s: [round4(start_s), round4(end_s)],
       // A continuation b-roll scene shares the previous scene's end frame as its start
       // (no own `s<i>_start` node), so point the storyboard at that shared keyframe.
       storyboard_frames: [scene.continues_previous && i > 0 ? `s${i - 1}_end` : `s${i}_start`],
@@ -41227,7 +41007,7 @@ ${describeRewrites(healed.rewrites)}
     // "edited since last render". Computed from the on-disk canvas.json +
     // prompt.json — the same helper the edit-sync uses, so the two are comparable.
     sourceSha: await computeSourceSha(filePath),
-    chatId: getEnv().BAKER_CHAT_ID || void 0,
+    chatId: optionalChatId(),
     canvasSnapshotUrl
   };
   if (client) {
@@ -44737,7 +44517,7 @@ Subcommands:
   baker canvas run <file.json>        \u2014 execute the canvas, write outputs to ./canvas/<run_id>/
   baker canvas rerun <slug>           \u2014 restore a creative's latest recorded canvas from run history and run it (works in a fresh workspace)
   baker canvas sync-definition <path> \u2014 push a creative's current node-graph + input thumbnails to the dashboard without rendering (runs automatically on canvas/prompt edits)
-  baker canvas catalog                \u2014 print the agent-facing node + composition catalog (JSON Schema)
+  baker canvas catalog                \u2014 one line per node; --node <id> for its full schema
   baker canvas inspect <run_id>       \u2014 one-page summary of a completed run
   baker canvas scaffold-ad --spec <spec.json>        \u2014 DEFAULT for a new ad: write beats (one spoken line + one shot each), get the whole runnable canvas
   baker canvas scaffold-video <video>                \u2014 reproduce a video the USER gave you (an ad you found is inspiration, not a copy target)
@@ -45218,11 +44998,7 @@ function detectCreativeContentType(filePath) {
   });
 }
 function chatIdFromEnv2() {
-  try {
-    return getEnv().BAKER_CHAT_ID || void 0;
-  } catch {
-    return void 0;
-  }
+  return optionalChatId();
 }
 function parseOptionalUrl(value) {
   if (value === void 0 || value.trim() === "") {
@@ -53139,7 +52915,7 @@ var extractCommand = defineCommand149({
 import { defineCommand as defineCommand150 } from "citty";
 
 // src/commands/images/providerHits.ts
-function asRecord3(value) {
+function asRecord2(value) {
   return value && typeof value === "object" ? value : {};
 }
 function str(value) {
@@ -53164,7 +52940,7 @@ function providerHitNormalizer(record, full) {
   if (!full) {
     return compact3;
   }
-  const group = asRecord3(record.group);
+  const group = asRecord2(record.group);
   return {
     ...compact3,
     externalUrl: str(record.externalUrl),
@@ -57069,7 +56845,7 @@ function dedupe(findings) {
 
 // src/engine/landing/lib/critique.ts
 var FAMILIES = ["typography", "color", "borders_depth", "motion", "spacing", "copy", "integrity"];
-function round4(n) {
+function round2(n) {
   return Math.round(n * 100) / 100;
 }
 function clamp012(n) {
@@ -57106,11 +56882,11 @@ function critiqueLanding(input) {
   const dimensions = FAMILIES.map((family) => {
     const fam = findings.filter((f) => f.family === family);
     const penalty = fam.reduce((s, f) => s + SEVERITY_WEIGHT[f.severity], 0);
-    const score = round4(clamp012(1 - penalty));
+    const score = round2(clamp012(1 - penalty));
     const note = fam.length === 0 ? "clean" : `${fam.length} finding(s): ${describeCounts(fam)}`;
     return { dimension: family, score, note };
   });
-  const overall = round4(dimensions.reduce((s, d) => s + d.score, 0) / dimensions.length);
+  const overall = round2(dimensions.reduce((s, d) => s + d.score, 0) / dimensions.length);
   const counts = {
     block: findings.filter((f) => f.severity === "block").length,
     warn: findings.filter((f) => f.severity === "warn").length,
@@ -61269,7 +61045,7 @@ function writeJsonl(data) {
 `);
   }
 }
-function writeMd2(data, fields) {
+function writeMd(data, fields) {
   if (data.length === 0) return;
   const cols = fields ?? Object.keys(data[0] ?? {});
   process.stdout.write(`| ${cols.join(" | ")} |
@@ -61291,7 +61067,7 @@ function writeResearchOutput(data, format, fields) {
       writeJsonl(data);
       break;
     case "md":
-      writeMd2(data, fields);
+      writeMd(data, fields);
       break;
     default:
       writeResearchJson({ ok: true, data });
@@ -64077,10 +63853,10 @@ var getCommand5 = defineCommand208({
 
 // src/commands/studio/improve.ts
 import { defineCommand as defineCommand209 } from "citty";
-var DESCRIPTION = "Sharpen a rough brief into directed art direction \u2014 the same rewrite the client gets from the wand in the Studio prompt bar. Reach for it when you are relaying the CLIENT's own words and want them shaped without substituting your voice; when you are writing the art direction yourself, just write it, because you will do a better job than this does.";
+var DESCRIPTION2 = "Sharpen a rough brief into directed art direction \u2014 the same rewrite the client gets from the wand in the Studio prompt bar. Reach for it when you are relaying the CLIENT's own words and want them shaped without substituting your voice; when you are writing the art direction yourself, just write it, because you will do a better job than this does.";
 registerSchema({
   command: "studio.improve",
-  description: DESCRIPTION,
+  description: DESCRIPTION2,
   args: {
     prompt: { type: "string", description: "The rough brief to sharpen", required: true },
     kind: {
@@ -64104,7 +63880,7 @@ registerSchema({
 var improveCommand = defineCommand209({
   meta: {
     name: "improve",
-    description: `${DESCRIPTION}
+    description: `${DESCRIPTION2}
 
 Both the rewrite and the original come back, so you can show the client what changed rather than silently replacing their words. Nothing is generated \u2014 feed the result to \`baker studio generate\` yourself.
 
@@ -64252,10 +64028,10 @@ var listCommand18 = defineCommand211({
 
 // src/commands/studio/models.ts
 import { defineCommand as defineCommand212 } from "citty";
-var DESCRIPTION2 = "What each Studio model actually accepts: its shapes, resolutions, clip lengths, prompt character cap, how many reference images it takes, and which knobs it has. Read this before a batch you care about \u2014 the models disagree far more than they look like they do, and a setting the chosen model does not have is REFUSED, not ignored.";
+var DESCRIPTION3 = "What each Studio model actually accepts: its shapes, resolutions, clip lengths, prompt character cap, how many reference images it takes, and which knobs it has. Read this before a batch you care about \u2014 the models disagree far more than they look like they do, and a setting the chosen model does not have is REFUSED, not ignored.";
 registerSchema({
   command: "studio.models",
-  description: DESCRIPTION2,
+  description: DESCRIPTION3,
   args: {
     kind: {
       type: "string",
@@ -64341,7 +64117,7 @@ function buildModelCards(kind, model) {
 var modelsCommand = defineCommand212({
   meta: {
     name: "models",
-    description: `${DESCRIPTION2}
+    description: `${DESCRIPTION3}
 
 Everything here is read from the same table the backend validates against, so it cannot drift from what a request will actually be allowed to do.