@koda-sl/baker-cli 0.345.0-dev.9f4314fa9 → 0.346.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) {
@@ -13082,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);
   }
@@ -22286,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) {
@@ -22296,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 = [
@@ -22332,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];
   }
@@ -25705,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;
@@ -25853,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();
@@ -31032,278 +30627,6 @@ 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: "" };
-    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 } : {} });
-}
-
 // src/commands/analytics/errorEnvelope.ts
 function analyticsErrorEnvelope(err) {
   if (err instanceof ApiError) {
@@ -31795,6 +31118,223 @@ 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"];
@@ -32969,7 +32509,17 @@ 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 = outputFormatOrExit(args5.output);
+    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 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;
@@ -32999,20 +32549,6 @@ 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}`,
@@ -33514,8 +33050,7 @@ var conversionsCommand3 = (() => {
       type: "string",
       description: "Lookback for the counts and for --candidates. Default 30",
       required: false
-    },
-    output: SHARED_ARGS.output
+    }
   };
   registerSchema({
     command: "analytics.conversions",
@@ -33530,23 +33065,22 @@ 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
         });
-        const envelope = conversionsEnvelope(
-          args6,
-          mergeStoredWithCounts(stored, report.data.conversions ?? []),
-          report.data.eventCatalog ?? []
+        writeJsonEnvelope(
+          conversionsEnvelope(
+            args6,
+            mergeStoredWithCounts(stored, report.data.conversions ?? []),
+            report.data.eventCatalog ?? []
+          )
         );
-        if (format === "md") process.stdout.write(renderConversionsMarkdown(envelope));
-        else writeJsonEnvelope(envelope);
       } catch (err) {
         if (err instanceof ConversionArgsError) {
           handleError3(new ApiError("VALIDATION_ERROR", err.message));
@@ -33911,11 +33445,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) {
@@ -39444,7 +38974,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;
@@ -39456,15 +38986,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"
       }))
@@ -39472,7 +39002,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`],
@@ -41235,7 +40765,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) {
@@ -45226,11 +44756,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() === "") {
@@ -53147,7 +52673,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) {
@@ -53172,7 +52698,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),
@@ -57077,7 +56603,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) {
@@ -57114,11 +56640,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,
@@ -61277,7 +60803,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(" | ")} |
@@ -61299,7 +60825,7 @@ function writeResearchOutput(data, format, fields) {
       writeJsonl(data);
       break;
     case "md":
-      writeMd2(data, fields);
+      writeMd(data, fields);
       break;
     default:
       writeResearchJson({ ok: true, data });
@@ -67754,6 +67280,7 @@ function commandFor(root, argv) {
   const { command, resolved } = resolveCommand2(root, argv);
   return resolved ? command : null;
 }
+var OUTPUT_EXPLANATION = "This command has no --output option: `--output json` is accepted by every command that prints the JSON envelope, and md or files only where `baker schema` lists `output`. Drop the option and read the default output. ";
 function unknownFlagEnvelope(unknown, commandPath, suggestion, hasSchema) {
   const list = unknown.join(", ");
   return {
@@ -67763,7 +67290,7 @@ function unknownFlagEnvelope(unknown, commandPath, suggestion, hasSchema) {
       message: `${list} ${unknown.length > 1 ? "are not options" : "is not an option"} of \`baker ${commandPath}\`.`,
       fix: {
         action: hasSchema ? "check_schema" : "check_help",
-        explanation: (suggestion ? `Did you mean ${suggestion}? ` : "") + `Run \`${hasSchema ? `baker schema ${commandPath}` : `baker ${commandPath} --help`}\` to see every option this command takes. Do not re-run the same call: until this version an unrecognised option was accepted and ignored, so a command that looked like it had filtered or narrowed the result was in fact answering the unfiltered question.`
+        explanation: (unknown.some((flag) => flag === "--output" || flag.startsWith("--output=")) ? OUTPUT_EXPLANATION : "") + (suggestion ? `Did you mean ${suggestion}? ` : "") + `Run \`${hasSchema ? `baker schema ${commandPath}` : `baker ${commandPath} --help`}\` to see every option this command takes. Do not re-run the same call: until this version an unrecognised option was accepted and ignored, so a command that looked like it had filtered or narrowed the result was in fact answering the unfiltered question.`
       },
       retryable: false
     }
@@ -67802,6 +67329,58 @@ function refuseUnknownFlags(root, argv) {
   process.exit(1);
 }
 
+// src/output-flag.ts
+var FLAG = "--output";
+var ENVELOPE = "json";
+var PRINTS_NO_ENVELOPE = /* @__PURE__ */ new Set([
+  "analytics sending-events",
+  "canvas run",
+  "canvas rerun",
+  "canvas sync-definition"
+]);
+function declaredArg(command, name) {
+  const args5 = command.args;
+  if (!args5 || typeof args5 !== "object" || !(name in args5)) {
+    return null;
+  }
+  const def = args5[name];
+  return def && typeof def === "object" ? def : {};
+}
+function envelopeRequests(argv) {
+  const end = argv.indexOf("--");
+  const limit = end === -1 ? argv.length : end;
+  const found = [];
+  for (let index = 0; index < limit; index++) {
+    const token = argv[index];
+    if (token === `${FLAG}=${ENVELOPE}`) {
+      found.push({ index, length: 1 });
+    } else if (token === FLAG && argv[index + 1] === ENVELOPE && index + 1 < limit) {
+      found.push({ index, length: 2 });
+      index++;
+    }
+  }
+  return found;
+}
+function outputFlagForCommand(root, argv) {
+  const requests = envelopeRequests(argv);
+  if (requests.length === 0) {
+    return argv;
+  }
+  const command = commandFor(root, argv);
+  if (!command || declaredArg(command, "output") || PRINTS_NO_ENVELOPE.has(commandPathOf(root, argv))) {
+    return argv;
+  }
+  const jsonSwitch = declaredArg(command, "json")?.type === "boolean";
+  const dropped = new Set(requests.flatMap(({ index, length }) => length === 2 ? [index, index + 1] : [index]));
+  const first = requests[0]?.index;
+  return argv.flatMap((token, index) => {
+    if (!dropped.has(index)) {
+      return [token];
+    }
+    return jsonSwitch && index === first ? ["--json"] : [];
+  });
+}
+
 // src/version.ts
 import { readFileSync as readFileSync21 } from "fs";
 function packageJsonUrl() {
@@ -67828,7 +67407,7 @@ var main = defineCommand245({
 Auth: Set BAKER_API_KEY (starts with bk_) and BAKER_API_URL environment variables.
 Chat: Set BAKER_CHAT_ID for action and scheduled-action commands that stage changes against a chat.
 Output: All commands return JSON envelopes: { ok: true, data: ... } or { ok: false, error: { code, message } }.
-Formats: Use --output json|files|md to control output format. Default: json. (The research commands additionally accept csv and jsonl.)
+Formats: --output json works on every command that prints the envelope. --output md|files only where 'baker schema <command>' lists output. (The research commands additionally accept csv and jsonl.)
 Introspection: Run 'baker schema <command>' to inspect argument schemas.`
   },
   subCommands: {
@@ -67866,6 +67445,7 @@ process.argv = [...process.argv.slice(0, 2), ...normalizeCacheFlag(process.argv.
 installStreamTaps();
 logInvocation(process.argv.slice(2));
 installExitRecord();
+process.argv = [...process.argv.slice(0, 2), ...outputFlagForCommand(main, process.argv.slice(2))];
 refuseUnknownFlags(main, process.argv.slice(2));
 process.argv = [...process.argv.slice(0, 2), ...cacheFlagForParser(process.argv.slice(2))];
 runMain(main);