@koda-sl/baker-cli 0.345.0-dev.9f4314fa9 → 0.345.0

package/dist/cli.js

@@ -67,7 +67,7 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-D5P4COPD.js";
+} from "./chunk-FFOURYP5.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -31032,278 +31032,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 +31523,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 +32914,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 +32954,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 +33455,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,7 +33470,6 @@ 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", {});
@@ -33540,13 +33479,13 @@ var conversionsCommand3 = (() => {
           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));
@@ -67754,6 +67693,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 +67703,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 +67742,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 +67820,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 +67858,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);