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

package/dist/cli.js

@@ -67,7 +67,7 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-D5P4COPD.js";
+} from "./chunk-YBD3W4M7.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -76,7 +76,7 @@ import {
   resolveAccountIdArg,
   resolveEffectiveStatus,
   todayIso
-} from "./chunk-JWMLQSGK.js";
+} from "./chunk-NA5CPMUA.js";
 import {
   buildQueryCacheKey,
   cacheGet,
@@ -92,33 +92,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 +168,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 +384,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 +391,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({
@@ -8509,12 +8055,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 +8075,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 +8094,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();
@@ -13135,8 +12677,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);
   }
@@ -22339,7 +21881,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 +21891,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 +21927,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 +25300,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 +25448,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 +30627,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 +31398,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 +32572,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 +32602,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 +33117,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 +33133,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 +33514,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) {
@@ -39436,7 +39043,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 +39055,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 +39071,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 +40834,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) {
@@ -45218,11 +44825,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 +52742,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 +52767,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 +56672,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 +56709,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 +60872,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 +60894,7 @@ function writeResearchOutput(data, format, fields) {
       writeJsonl(data);
       break;
     case "md":
-      writeMd2(data, fields);
+      writeMd(data, fields);
       break;
     default:
       writeResearchJson({ ok: true, data });