@koda-sl/baker-cli 0.344.0-dev.1f4f1c4b7 → 0.344.0-dev.9890d9fcc

package/README.md

@@ -118,14 +118,12 @@ Use `--output` to change format:
 
 | Format  | Description                        | Best for           | Available on |
 |---------|------------------------------------|--------------------|--------------|
-| `json`  | Structured JSON envelope (default) | AI agents          | every command that prints the envelope |
-| `files` | Tab-separated, one row per result  | Piping / shell     | commands whose `baker schema` lists `output` |
-| `md`    | Markdown table                     | Human reading      | commands whose `baker schema` lists `output` |
+| `json`  | Structured JSON envelope (default) | AI agents          | every command |
+| `files` | Tab-separated, one row per result  | Piping / shell     | every command |
+| `md`    | Markdown table                     | Human reading      | every command |
 | `csv`   | RFC 4180 comma-separated values    | Analysis tools     | `baker research …` only |
 | `jsonl` | One JSON object per line           | Streaming/appending | `baker research …` only |
 
-`--output json` is accepted even by a command that declares no `--output`: the envelope is already what it prints, and on a command whose default is a readable view (`baker tags list`, the `draft` commands) it becomes that command's `--json`. The few commands that print only text — `baker analytics sending-events`, `baker canvas run` and `rerun` — refuse it, as a command without its own `--output` refuses `md` and `files`.
-
 `csv` and `jsonl` are implemented by the research family alone. Asking any other command for them — or for a format that does not exist — falls back to the JSON envelope and says so on stderr, rather than printing nothing and exiting 0.
 
 `files` and `md` print rows and nothing else, so any `hints` or data-quality note the envelope carries is written to **stderr** instead. Reading stdout alone still gives you clean, parseable rows.
@@ -341,9 +339,9 @@ The same lines also go to stderr. A read with nothing to report prints none of i
 |-----------------|--------------------------------------------------------------|
 | `--customer-id` | Google Ads customer ID (10 digits, no dashes). Falls back to `BAKER_GOOGLE_ADS_CUSTOMER_ID` env var. |
 | `--preset`      | Named query template (see presets below)                     |
-| `--date-range`  | Override preset date range (LAST_7_DAYS, LAST_30_DAYS, etc.) |
+| `--date-range`  | Override preset date range: a Google literal (LAST_7_DAYS, LAST_30_DAYS, LAST_MONTH, etc.) or `BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'` — there is no LAST_90_DAYS |
 | `--include-paused` | Include paused entities in preset results. Off by default: presets return only actually-serving entities (enabled campaign **and** ad group **and** ad). Google Ads has no single serving flag, so the whole chain must be `ENABLED` for an entity to serve. |
-| `--limit`       | Max rows per page (default 200)                              |
+| `--limit`       | Max rows per page (default 200, at most 10,000)              |
 | `--cursor`      | Pagination cursor from previous response                     |
 | `--all`         | Auto-paginate all results. Exhausts the pages, not the statement's `LIMIT` — pair it with a `--limit` above the expected row count, and a read that still fills its cap is flagged `TRUNCATED_RESULTS` either way |
 | `--out`         | Write data to file (format from extension: .csv, .jsonl, .json) |
@@ -389,6 +387,8 @@ The CLI rejects or automatically corrects common GAQL mistakes before hitting th
 | `shopping_performance_view.product_*` | Rewrites to `segments.product_*` | Field renamed |
 | `campaign.status = 'ACTIVE'` | Rewrites to `= 'ENABLED'` | Enum corrected |
 | `segments.conversion_action_name` with `metrics.cost_micros` | Rejects; split into separate conversion-action and spend queries | `INCOMPATIBLE_FIELDS` with `fix.action: "split_query"` |
+| `DURING` with a literal Google does not accept (`LAST_90_DAYS`, `LAST_12_MONTHS`, `THIS_YEAR` …) | Rejects before any request; `DURING` takes only `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` | `INVALID_DATE_RANGE`, with `fix.correctedCommand` spelling the same window as `BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'` |
+| `--limit` outside 1–10,000 | Rejects before any request | `VALIDATION_ERROR` naming the cap and `--all --out` for bigger reads |
 | `FROM ad_group_criterion` without `negative` field | Warns | `"ad_group_criterion returns BOTH positive and negative keywords. Use --preset positive-keywords or negative-keywords."` |
 
 Auto-fixed queries proceed normally. Warnings appear in the response:

package/canvas/end-card-composition/meta.json

@@ -8,7 +8,11 @@
   "default_duration": 3,
   "inputs": {},
   "params": {
-    "logo_svg": { "kind": "string", "default": "", "description": "Raw inline <svg>…</svg> wordmark with fill set to text_color (optional)." },
+    "logo_svg": {
+      "kind": "string",
+      "default": "",
+      "description": "Raw inline <svg>…</svg> wordmark with fill set to text_color (optional)."
+    },
     "headline": { "kind": "string", "required": true, "description": "Closing line." },
     "cta_text": { "kind": "string", "default": "", "description": "Call-to-action pill label (optional)." },
     "bg_color": { "kind": "color", "default": "#0b1020" },

package/canvas/feature-reveal-composition/meta.json

@@ -9,10 +9,20 @@
   "inputs": {},
   "params": {
     "title": { "kind": "string", "default": "", "description": "Optional heading above the list." },
-    "features": { "kind": "json", "required": true, "description": "Array of 1–6 short labels, e.g. [\"No setup fees\", \"Cancel anytime\"]." },
+    "features": {
+      "kind": "json",
+      "required": true,
+      "description": "Array of 1–6 short labels, e.g. [\"No setup fees\", \"Cancel anytime\"]."
+    },
     "text_color": { "kind": "color", "default": "#0b1020" },
     "accent_color": { "kind": "color", "default": "#1f9d57", "description": "Check-circle fill." },
     "check_color": { "kind": "color", "default": "#ffffff", "description": "The check mark inside the circle." },
-    "stagger_s": { "kind": "number", "default": 0.18, "min": 0.02, "max": 1, "description": "Seconds between each item." }
+    "stagger_s": {
+      "kind": "number",
+      "default": 0.18,
+      "min": 0.02,
+      "max": 1,
+      "description": "Seconds between each item."
+    }
   }
 }

package/canvas/lower-third-composition/meta.json

@@ -13,6 +13,12 @@
     "bar_color": { "kind": "color", "default": "#0b1020" },
     "text_color": { "kind": "color", "default": "#ffffff" },
     "accent_color": { "kind": "color", "default": "#5b8cff", "description": "The leading accent block." },
-    "from_bottom_px": { "kind": "integer", "default": 220, "min": 0, "max": 1600, "description": "Distance of the bar from the bottom edge." }
+    "from_bottom_px": {
+      "kind": "integer",
+      "default": 220,
+      "min": 0,
+      "max": 1600,
+      "description": "Distance of the bar from the bottom edge."
+    }
   }
 }

package/canvas/video-call-composition/meta.json

@@ -15,12 +15,34 @@
     }
   },
   "params": {
-    "headline": { "kind": "string", "default": "", "description": "Big line on the content stage (what the presenter is showing)." },
-    "claim": { "kind": "string", "default": "", "description": "Short proof/claim on the floating glass card (optional)." },
+    "headline": {
+      "kind": "string",
+      "default": "",
+      "description": "Big line on the content stage (what the presenter is showing)."
+    },
+    "claim": {
+      "kind": "string",
+      "default": "",
+      "description": "Short proof/claim on the floating glass card (optional)."
+    },
     "caption": { "kind": "string", "default": "", "description": "A caption line in the lower band (optional)." },
-    "pip_at_s": { "kind": "number", "default": 2, "min": 0, "max": 30, "description": "When the presenter shrinks to the corner pill." },
-    "bg_color": { "kind": "color", "default": "#0b1020", "description": "Content-stage background (behind the presenter)." },
+    "pip_at_s": {
+      "kind": "number",
+      "default": 2,
+      "min": 0,
+      "max": 30,
+      "description": "When the presenter shrinks to the corner pill."
+    },
+    "bg_color": {
+      "kind": "color",
+      "default": "#0b1020",
+      "description": "Content-stage background (behind the presenter)."
+    },
     "text_color": { "kind": "color", "default": "#ffffff" },
-    "accent_color": { "kind": "color", "default": "#5b8cff", "description": "Headline accent + caption underline + pill ring tint." }
+    "accent_color": {
+      "kind": "color",
+      "default": "#5b8cff",
+      "description": "Headline accent + caption underline + pill ring tint."
+    }
   }
 }

package/dist/cli.js

@@ -2362,6 +2362,7 @@ 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",
@@ -10079,7 +10080,72 @@ 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);
 }
@@ -10133,7 +10199,7 @@ function lookbackTooLong(scope, days, max) {
     message: `Google's account history API reaches back ${CHANGE_SCOPE_MAX_DAYS.summary} days at most; ${days} days is outside that window.`,
     fix: {
       action: "use_different_resource",
-      explanation: "Do not abort \u2014 infer the change from performance instead. Query monthly metrics per campaign (SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS) to see which campaigns stopped or started spending. That shows what changed and when, though not who changed it. Older history exists only in the Google Ads web UI, which has no API \u2014 ask the user to check it if the 'who' matters."
+      explanation: `Do not abort \u2014 infer the change from performance instead. Query monthly metrics per campaign (${monthlySpendTrendQuery()}) to see which campaigns stopped or started spending. That shows what changed and when, though not who changed it. Older history exists only in the Google Ads web UI, which has no API \u2014 ask the user to check it if the 'who' matters.`
     }
   };
 }
@@ -10492,7 +10558,7 @@ var CORRECTION_RULES = [
     matchApiError: /changeStatusError\W{0,4}START_DATE_TOO_OLD/i,
     fix: () => ({
       action: "use_different_resource",
-      explanation: "Google's account history reaches back 90 days at most, and this query asks for more. Do not abort \u2014 infer the change from performance: SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS shows which campaigns started or stopped spending and when, though not who changed them. Anything older with attribution exists only in the Google Ads web UI, which has no API."
+      explanation: `Google's account history reaches back 90 days at most, and this query asks for more. Do not abort \u2014 infer the change from performance: ${monthlySpendTrendQuery()} shows which campaigns started or stopped spending and when, though not who changed them. Anything older with attribution exists only in the Google Ads web UI, which has no API.`
     })
   },
   // 18c. change_status rejects a date range it cannot bound. Google raises this both for
@@ -12319,9 +12385,16 @@ import { resolve } from "path";
 import { defineCommand as defineCommand28 } from "citty";
 
 // src/commands/ads/google/presets.ts
-var GAQL_DATE_RANGE_RE = /^(?:TODAY|YESTERDAY|LAST_7_DAYS|LAST_14_DAYS|LAST_30_DAYS|LAST_90_DAYS|THIS_MONTH|LAST_MONTH|THIS_QUARTER|LAST_QUARTER|THIS_YEAR|LAST_YEAR|ALL_TIME|BETWEEN\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'\s+AND\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}')$/i;
+var BETWEEN_RE = /^BETWEEN\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'\s+AND\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'$/i;
 function isValidDateRange(value) {
-  return GAQL_DATE_RANGE_RE.test(value.trim());
+  const trimmed = value.trim();
+  return isDuringLiteral(trimmed) || BETWEEN_RE.test(trimmed);
+}
+function dateRangeError(dateRange, now) {
+  if (/^[A-Za-z0-9_]+$/.test(dateRange.trim())) {
+    return `Invalid date range: "${dateRange}". ${duringLiteralExplanation(dateRange, equivalentBetween(dateRange, now))} Pass it as --date-range "BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'".`;
+  }
+  return `Invalid date range: "${dateRange}". Use a GAQL date literal (e.g. LAST_30_DAYS, TODAY) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'.`;
 }
 var SERVING_CHAINS = {
   keyword_view: ["campaign.status", "ad_group.status", "ad_group_criterion.status"],
@@ -12457,17 +12530,15 @@ function buildStatusScope(statusFields, includePaused) {
   const predicate = includePaused ? "!= 'REMOVED'" : "= 'ENABLED'";
   return statusFields.map((field) => ` AND ${field} ${predicate}`).join("");
 }
-function expandPreset(preset, params) {
+function expandPreset(preset, params, now = /* @__PURE__ */ new Date()) {
   const dateRange = params.dateRange ?? preset.defaultDateRange;
   const limit = params.limit ?? preset.defaultLimit;
-  if (!isValidDateRange(dateRange)) {
-    return {
-      query: "",
-      dateRangeError: `Invalid date range: "${dateRange}". Use a GAQL date literal (e.g. LAST_30_DAYS, TODAY) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'.`
-    };
+  if (preset.gaqlTemplate.includes("{dateRange}") && !isValidDateRange(dateRange)) {
+    return { query: "", dateRangeError: dateRangeError(dateRange, now) };
   }
   const statusScope = buildStatusScope(preset.statusFields, params.includePaused ?? false);
-  const query = preset.gaqlTemplate.replace(/\{dateRange\}/g, dateRange).replace(/\{limit\}/g, String(limit)).replace(/\{statusScope\}/g, statusScope);
+  const range = dateRange.trim();
+  const query = preset.gaqlTemplate.replace(/DURING\s+\{dateRange\}/g, BETWEEN_RE.test(range) ? range : `DURING ${range}`).replace(/\{dateRange\}/g, range).replace(/\{limit\}/g, String(limit)).replace(/\{statusScope\}/g, statusScope);
   return { query };
 }
 
@@ -12626,6 +12697,28 @@ 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;
@@ -12697,6 +12790,8 @@ 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,
@@ -12905,7 +13000,7 @@ registerSchema({
     },
     "date-range": {
       type: "string",
-      description: "Date range for presets (LAST_7_DAYS, LAST_30_DAYS, LAST_90_DAYS, or BETWEEN 'X' AND 'Y')",
+      description: "Date range for presets: a Google date literal (TODAY, YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH \u2026) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'. Google has no LAST_90_DAYS \u2014 use BETWEEN for any other window.",
       required: false
     },
     "include-paused": {
@@ -13344,9 +13439,35 @@ async function executeQuery(finalQuery, args5, customerId, limit, warnings, useC
 function shouldReadCache(args5) {
   return !args5["no-cache"] && !args5.out;
 }
+var DEFAULT_QUERY_LIMIT = 200;
+function parseQueryLimit(raw) {
+  if (raw === void 0 || raw === null || raw === "") return { ok: true, limit: DEFAULT_QUERY_LIMIT };
+  const limit = Number(raw);
+  if (Number.isInteger(limit) && limit >= 1 && limit <= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE) return { ok: true, limit };
+  return {
+    ok: false,
+    error: {
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: `--limit must be a whole number from 1 to ${GOOGLE_ADS_QUERY_MAX_PAGE_SIZE}, got '${String(raw)}'.`,
+        fix: {
+          action: "retry_with_flag",
+          explanation: `--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);
@@ -67693,7 +67814,6 @@ 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 {
@@ -67703,7 +67823,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: (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.`
+        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
     }
@@ -67742,53 +67862,6 @@ 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() {
@@ -67815,7 +67888,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: --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.)
+Formats: Use --output json|files|md to control output format. Default: json. (The research commands additionally accept csv and jsonl.)
 Introspection: Run 'baker schema <command>' to inspect argument schemas.`
   },
   subCommands: {
@@ -67853,7 +67926,6 @@ 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);