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

package/dist/cli.js

@@ -2362,7 +2362,6 @@ var GOOGLE_ADS_LIMITS = {
     businessNameMax: 25
   }
 };
-var GOOGLE_ADS_QUERY_MAX_PAGE_SIZE = 1e4;
 var KEYWORD_MATCH_TYPES = ["EXACT", "PHRASE", "BROAD"];
 var ADVERTISING_CHANNEL_TYPES = [
   "SEARCH",
@@ -10080,72 +10079,7 @@ function urlOptionsHints(report) {
   return hints2;
 }
 
-// src/commands/ads/google/during-literals.ts
-var GAQL_DURING_LITERALS = [
-  "TODAY",
-  "YESTERDAY",
-  "LAST_7_DAYS",
-  "LAST_14_DAYS",
-  "LAST_30_DAYS",
-  "LAST_BUSINESS_WEEK",
-  "THIS_MONTH",
-  "LAST_MONTH",
-  "THIS_WEEK_SUN_TODAY",
-  "THIS_WEEK_MON_TODAY",
-  "LAST_WEEK_SUN_SAT",
-  "LAST_WEEK_MON_SUN"
-];
-function isDuringLiteral(value) {
-  return GAQL_DURING_LITERALS.includes(value.toUpperCase());
-}
-function isoDay(date) {
-  return date.toISOString().slice(0, 10);
-}
-function utcDate(year, month, day) {
-  return new Date(Date.UTC(year, month, day));
-}
-function equivalentBetween(literal, now) {
-  const upper2 = literal.toUpperCase();
-  const today = utcDate(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
-  const yesterday = utcDate(today.getUTCFullYear(), today.getUTCMonth(), today.getUTCDate() - 1);
-  const range = (from, to) => `BETWEEN '${isoDay(from)}' AND '${isoDay(to)}'`;
-  const year = today.getUTCFullYear();
-  const quarterStart = Math.floor(today.getUTCMonth() / 3) * 3;
-  const rolling = upper2.match(/^LAST_(\d+)_(DAYS|WEEKS|MONTHS|YEARS)$/);
-  if (rolling) {
-    const n = Number(rolling[1]);
-    const unit = rolling[2];
-    if (n < 1) return null;
-    if (unit === "DAYS" || unit === "WEEKS") {
-      const days = unit === "DAYS" ? n : n * 7;
-      return range(utcDate(year, today.getUTCMonth(), today.getUTCDate() - days), yesterday);
-    }
-    const months = unit === "MONTHS" ? n : n * 12;
-    return range(utcDate(year, today.getUTCMonth() - months, today.getUTCDate()), yesterday);
-  }
-  switch (upper2) {
-    case "THIS_YEAR":
-      return range(utcDate(year, 0, 1), today);
-    case "LAST_YEAR":
-      return range(utcDate(year - 1, 0, 1), utcDate(year - 1, 11, 31));
-    case "THIS_QUARTER":
-      return range(utcDate(year, quarterStart, 1), today);
-    case "LAST_QUARTER":
-      return range(utcDate(year, quarterStart - 3, 1), utcDate(year, quarterStart, 0));
-    default:
-      return null;
-  }
-}
-function duringLiteralExplanation(literal, between) {
-  const accepted = GAQL_DURING_LITERALS.join(", ");
-  const lead = between ? `Google does not accept ${literal} after DURING. The same window as explicit dates is ${between}.` : `Google does not accept ${literal} after DURING, and it names no fixed window \u2014 use BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD', or drop the date filter.`;
-  return `${lead} DURING accepts only: ${accepted}. Any other window needs BETWEEN.`;
-}
-
 // src/commands/ads/google/changes-window.ts
-function monthlySpendTrendQuery(now = /* @__PURE__ */ new Date()) {
-  return `SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date ${equivalentBetween("LAST_12_MONTHS", now)}`;
-}
 function isChangeScope(value) {
   return CHANGE_SCOPES.includes(value);
 }
@@ -10199,7 +10133,7 @@ function lookbackTooLong(scope, days, max) {
     message: `Google's account history API reaches back ${CHANGE_SCOPE_MAX_DAYS.summary} days at most; ${days} days is outside that window.`,
     fix: {
       action: "use_different_resource",
-      explanation: `Do not abort \u2014 infer the change from performance instead. Query monthly metrics per campaign (${monthlySpendTrendQuery()}) to see which campaigns stopped or started spending. That shows what changed and when, though not who changed it. Older history exists only in the Google Ads web UI, which has no API \u2014 ask the user to check it if the 'who' matters.`
+      explanation: "Do not abort \u2014 infer the change from performance instead. Query monthly metrics per campaign (SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS) to see which campaigns stopped or started spending. That shows what changed and when, though not who changed it. Older history exists only in the Google Ads web UI, which has no API \u2014 ask the user to check it if the 'who' matters."
     }
   };
 }
@@ -10558,7 +10492,7 @@ var CORRECTION_RULES = [
     matchApiError: /changeStatusError\W{0,4}START_DATE_TOO_OLD/i,
     fix: () => ({
       action: "use_different_resource",
-      explanation: `Google's account history reaches back 90 days at most, and this query asks for more. Do not abort \u2014 infer the change from performance: ${monthlySpendTrendQuery()} shows which campaigns started or stopped spending and when, though not who changed them. Anything older with attribution exists only in the Google Ads web UI, which has no API.`
+      explanation: "Google's account history reaches back 90 days at most, and this query asks for more. Do not abort \u2014 infer the change from performance: SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS shows which campaigns started or stopped spending and when, though not who changed them. Anything older with attribution exists only in the Google Ads web UI, which has no API."
     })
   },
   // 18c. change_status rejects a date range it cannot bound. Google raises this both for
@@ -12385,16 +12319,9 @@ import { resolve } from "path";
 import { defineCommand as defineCommand28 } from "citty";
 
 // src/commands/ads/google/presets.ts
-var BETWEEN_RE = /^BETWEEN\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'\s+AND\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'$/i;
+var GAQL_DATE_RANGE_RE = /^(?:TODAY|YESTERDAY|LAST_7_DAYS|LAST_14_DAYS|LAST_30_DAYS|LAST_90_DAYS|THIS_MONTH|LAST_MONTH|THIS_QUARTER|LAST_QUARTER|THIS_YEAR|LAST_YEAR|ALL_TIME|BETWEEN\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'\s+AND\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}')$/i;
 function isValidDateRange(value) {
-  const trimmed = value.trim();
-  return isDuringLiteral(trimmed) || BETWEEN_RE.test(trimmed);
-}
-function dateRangeError(dateRange, now) {
-  if (/^[A-Za-z0-9_]+$/.test(dateRange.trim())) {
-    return `Invalid date range: "${dateRange}". ${duringLiteralExplanation(dateRange, equivalentBetween(dateRange, now))} Pass it as --date-range "BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'".`;
-  }
-  return `Invalid date range: "${dateRange}". Use a GAQL date literal (e.g. LAST_30_DAYS, TODAY) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'.`;
+  return GAQL_DATE_RANGE_RE.test(value.trim());
 }
 var SERVING_CHAINS = {
   keyword_view: ["campaign.status", "ad_group.status", "ad_group_criterion.status"],
@@ -12530,15 +12457,17 @@ function buildStatusScope(statusFields, includePaused) {
   const predicate = includePaused ? "!= 'REMOVED'" : "= 'ENABLED'";
   return statusFields.map((field) => ` AND ${field} ${predicate}`).join("");
 }
-function expandPreset(preset, params, now = /* @__PURE__ */ new Date()) {
+function expandPreset(preset, params) {
   const dateRange = params.dateRange ?? preset.defaultDateRange;
   const limit = params.limit ?? preset.defaultLimit;
-  if (preset.gaqlTemplate.includes("{dateRange}") && !isValidDateRange(dateRange)) {
-    return { query: "", dateRangeError: dateRangeError(dateRange, now) };
+  if (!isValidDateRange(dateRange)) {
+    return {
+      query: "",
+      dateRangeError: `Invalid date range: "${dateRange}". Use a GAQL date literal (e.g. LAST_30_DAYS, TODAY) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'.`
+    };
   }
   const statusScope = buildStatusScope(preset.statusFields, params.includePaused ?? false);
-  const range = dateRange.trim();
-  const query = preset.gaqlTemplate.replace(/DURING\s+\{dateRange\}/g, BETWEEN_RE.test(range) ? range : `DURING ${range}`).replace(/\{dateRange\}/g, range).replace(/\{limit\}/g, String(limit)).replace(/\{statusScope\}/g, statusScope);
+  const query = preset.gaqlTemplate.replace(/\{dateRange\}/g, dateRange).replace(/\{limit\}/g, String(limit)).replace(/\{statusScope\}/g, statusScope);
   return { query };
 }
 
@@ -12697,28 +12626,6 @@ function applyAutoFixes(query, limit) {
   }
   return { query: corrected, warnings };
 }
-function rejectUnsupportedDuring(query, customerId) {
-  for (const match of query.matchAll(/(?<=[a-z_]\.[a-z_.]+\s+)DURING\s+([A-Za-z0-9_]+)/gi)) {
-    const literal = match[1] ?? "";
-    if (isDuringLiteral(literal)) continue;
-    const between = equivalentBetween(literal, /* @__PURE__ */ new Date());
-    const fixed = between ? query.replace(match[0], between) : void 0;
-    return {
-      ok: false,
-      error: {
-        code: "INVALID_DATE_RANGE",
-        message: `DURING ${literal} is not a Google Ads date range, so Google would refuse this query.`,
-        fix: {
-          action: "narrow_date_range",
-          ...fixed ? { correctedCommand: buildCommand2(fixed, customerId) } : {},
-          explanation: duringLiteralExplanation(literal, between)
-        },
-        retryable: false
-      }
-    };
-  }
-  return null;
-}
 function validatePreflight(query, customerId, limit) {
   const warnings = [];
   const corrected = query;
@@ -12790,8 +12697,6 @@ function validatePreflight(query, customerId, limit) {
       }
     };
   }
-  const duringRejection = rejectUnsupportedDuring(corrected, customerId);
-  if (duringRejection) return { valid: false, warnings: [], error: duringRejection };
   if (/\bsegments\.conversion_action_name\b/i.test(corrected) && /\bmetrics\.cost_micros\b/i.test(corrected)) {
     return {
       valid: false,
@@ -13000,7 +12905,7 @@ registerSchema({
     },
     "date-range": {
       type: "string",
-      description: "Date range for presets: a Google date literal (TODAY, YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH \u2026) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'. Google has no LAST_90_DAYS \u2014 use BETWEEN for any other window.",
+      description: "Date range for presets (LAST_7_DAYS, LAST_30_DAYS, LAST_90_DAYS, or BETWEEN 'X' AND 'Y')",
       required: false
     },
     "include-paused": {
@@ -13439,35 +13344,9 @@ async function executeQuery(finalQuery, args5, customerId, limit, warnings, useC
 function shouldReadCache(args5) {
   return !args5["no-cache"] && !args5.out;
 }
-var DEFAULT_QUERY_LIMIT = 200;
-function parseQueryLimit(raw) {
-  if (raw === void 0 || raw === null || raw === "") return { ok: true, limit: DEFAULT_QUERY_LIMIT };
-  const limit = Number(raw);
-  if (Number.isInteger(limit) && limit >= 1 && limit <= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE) return { ok: true, limit };
-  return {
-    ok: false,
-    error: {
-      ok: false,
-      error: {
-        code: "VALIDATION_ERROR",
-        message: `--limit must be a whole number from 1 to ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}, got '${String(raw)}'.`,
-        fix: {
-          action: "retry_with_flag",
-          explanation: `--limit is the size of one page, capped at ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}. To read more rows, pass --limit ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE} with --all --out <file> and put your own LIMIT in the statement above the row count you expect.`
-        },
-        retryable: false
-      }
-    }
-  };
-}
 async function validateArgs(args5) {
-  const parsedLimit = parseQueryLimit(args5.limit);
-  if (!parsedLimit.ok) {
-    writeAdsJson(parsedLimit.error);
-    process.exit(1);
-  }
-  const { limit } = parsedLimit;
   const customerId = await resolveCustomerId(args5);
+  const limit = args5.limit ? Number(args5.limit) : 200;
   const gaql = resolveGaql(args5, limit);
   if (!gaql) {
     process.exit(1);
@@ -31153,6 +31032,278 @@ 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) {
@@ -31644,223 +31795,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"];
@@ -33035,17 +32969,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;
@@ -33075,6 +32999,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}`,
@@ -33576,7 +33514,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",
@@ -33591,6 +33530,7 @@ 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", {});
@@ -33600,13 +33540,13 @@ var conversionsCommand3 = (() => {
           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(envelope);
       } catch (err) {
         if (err instanceof ConversionArgsError) {
           handleError3(new ApiError("VALIDATION_ERROR", err.message));