@koda-sl/baker-cli 0.466.0 → 0.468.0

package/dist/google-ads-R4KXBNU7.js

@@ -0,0 +1,195 @@
+import {
+  googleAdsHints
+} from "./chunk-YT74ZEVP.js";
+import {
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-JZP5IODJ.js";
+import {
+  RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT,
+  RESEARCH_GOOGLE_ADS_MAX_COPY,
+  RESEARCH_GOOGLE_ADS_MAX_LIMIT,
+  researchGoogleAdsFormatSchema,
+  researchGoogleAdsPlatformSchema
+} from "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/google-ads.ts
+import { defineCommand } from "citty";
+var TIMEOUT_MS = 18e4;
+var PLATFORMS = researchGoogleAdsPlatformSchema.options;
+var FORMATS = ["all", ...researchGoogleAdsFormatSchema.options];
+registerSchema({
+  command: "research.google-ads",
+  description: "A competitor's Google ads, from Google's Ads Transparency Center: who runs each one, its format (text, image, video), when it was first and last shown and how many days it has run \u2014 the longest-running are the ones that pay. With --copy, the headline, description and display URL of up to 20 text ads. Start here: `baker research google-ads <competitor.com> --location <cc> --copy`. Never drive the Transparency Center in a browser instead.",
+  args: {
+    target: {
+      type: "string",
+      description: "Competitor domain (competitor.com, or any URL on it) or a Transparency advertiser id (AR\u2026)",
+      required: true
+    },
+    location: {
+      type: "string",
+      description: "Country code (es, mx, us\u2026) where the ads were shown. Omit for every region",
+      required: false
+    },
+    platform: { type: "string", description: "Where they ran", required: false, enum: [...PLATFORMS] },
+    format: { type: "string", description: "Only one ad format", required: false, enum: [...FORMATS] },
+    since: { type: "string", description: "Only ads shown on or after this day (YYYY-MM-DD)", required: false },
+    limit: {
+      type: "number",
+      description: `Max ads (1-${RESEARCH_GOOGLE_ADS_MAX_LIMIT}, default ${RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT}; billed per 40)`,
+      required: false
+    },
+    copy: {
+      type: "boolean",
+      description: `Read headline, description and display URL of up to ${RESEARCH_GOOGLE_ADS_MAX_COPY} text ads`,
+      required: false,
+      default: false
+    },
+    full: {
+      type: "boolean",
+      description: "Add creative/advertiser ids, verification and preview image URL",
+      required: false,
+      default: false
+    }
+  }
+});
+var FIELDS = {
+  advertiser: "The Google Ads account that runs the ad (a brand can run several)",
+  format: "text | image | video",
+  first_shown: "First day Google showed it (UTC)",
+  last_shown: "Most recent day Google showed it (UTC) \u2014 recent means still running",
+  days_running: "First to last shown, inclusive: how long the advertiser has kept paying for it",
+  copy: "headline / description / display_url, read off the text ad's image (--copy); null otherwise",
+  transparency_url: "The ad on Google's Ads Transparency Center \u2014 the link to show the user"
+};
+function compact(ad) {
+  return {
+    advertiser: ad.advertiser,
+    format: ad.format,
+    first_shown: ad.first_shown,
+    last_shown: ad.last_shown,
+    days_running: ad.days_running,
+    copy: ad.copy,
+    transparency_url: ad.transparency_url
+  };
+}
+function googleAdsFix(code) {
+  if (code === "BAD_REQUEST" || code === "VALIDATION_ERROR") {
+    return {
+      action: "retry_with_changes",
+      explanation: "Pass the competitor's domain (competitor.com) or an advertiser id (AR\u2026), and check the flag values."
+    };
+  }
+  return {
+    action: "continue_without",
+    explanation: "This read failed. Finish the rest of the job and name the competitor's Google ads as a gap \u2014 do not open the Transparency Center in a browser instead."
+  };
+}
+function invalid(message) {
+  writeResearchJson({ ok: false, error: { code: "VALIDATION_ERROR", message, fix: googleAdsFix("VALIDATION_ERROR") } });
+  process.exit(1);
+}
+var googleAdsCommand = defineCommand({
+  meta: {
+    name: "google-ads",
+    description: `A competitor's Google ads, read from Google's Ads Transparency Center \u2014 no browser. Each ad: who runs it, format, first and last shown, days running, and its Transparency link. --copy reads the headline and description of the text ads.
+
+Examples:
+  baker research google-ads competitor.com --location es --copy
+  baker research google-ads competitor.com --platform google_search --format text --copy
+  baker research google-ads competitor.com --since 2026-07-01 --limit 80
+  baker research google-ads AR06744629793381154817 --output md`
+  },
+  args: {
+    target: { type: "positional", description: "Competitor domain or advertiser id (AR\u2026)", required: false },
+    location: {
+      type: "string",
+      description: "Country code where the ads were shown (default: every region)",
+      required: false
+    },
+    platform: { type: "string", description: `${PLATFORMS.join("|")} (default all)`, required: false },
+    format: { type: "string", description: `${FORMATS.join("|")} (default all)`, required: false },
+    since: { type: "string", description: "Only ads shown on or after YYYY-MM-DD", required: false },
+    limit: {
+      type: "string",
+      description: `Max ads (default ${RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT}, max ${RESEARCH_GOOGLE_ADS_MAX_LIMIT})`,
+      required: false
+    },
+    copy: { type: "boolean", description: "Read the text ads' headline and description", required: false },
+    full: { type: "boolean", description: "Add ids, verification and preview image URL", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip the 6h server cache", required: false }
+  },
+  run: async ({ args }) => {
+    const target = args.target?.trim();
+    if (!target) invalid("A competitor domain or advertiser id is required");
+    const platform = args.platform ?? "all";
+    if (!researchGoogleAdsPlatformSchema.safeParse(platform).success) {
+      invalid(`--platform must be one of ${PLATFORMS.join(", ")}`);
+    }
+    const format = args.format ?? "all";
+    if (!FORMATS.includes(format)) invalid(`--format must be one of ${FORMATS.join(", ")}`);
+    const body = {
+      target,
+      platform,
+      format,
+      copy: Boolean(args.copy)
+    };
+    if (args.location) body.location = args.location;
+    if (args.since) body.since = args.since;
+    if (args.limit) body.limit = Number(args.limit);
+    if (args["no-cache"]) body.skipCache = true;
+    try {
+      const result = await apiPost("/api/research/google-ads", body, {
+        timeoutMs: TIMEOUT_MS
+      });
+      const hints = googleAdsHints({
+        target: result.target,
+        adCount: result.ads.length,
+        located: body.location !== void 0,
+        textWithoutCopy: result.ads.filter((ad) => ad.format === "text" && ad.copy === null).length,
+        copyAsked: body.copy === true,
+        copyUnread: result.copy_unread,
+        visual: result.ads.filter((ad) => ad.format !== "text").length
+      });
+      const ads = args.full ? result.ads : result.ads.map(compact);
+      const output = args.output || "json";
+      if (output !== "json") {
+        writeResearchOutput(ads, output);
+        writeResearchHints(hints, output);
+        return;
+      }
+      writeResearchJson({
+        ok: true,
+        data: ads,
+        fields: FIELDS,
+        target: result.target,
+        total_ads: result.total_ads,
+        check_url: result.check_url,
+        hints
+      });
+    } catch (err) {
+      handleResearchError(err, googleAdsFix);
+    }
+  }
+});
+export {
+  googleAdsCommand
+};
+//# sourceMappingURL=google-ads-R4KXBNU7.js.map

package/dist/google-ads-R4KXBNU7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/google-ads.ts"],"sourcesContent":["import {\n  RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT,\n  RESEARCH_GOOGLE_ADS_MAX_COPY,\n  RESEARCH_GOOGLE_ADS_MAX_LIMIT,\n  type ResearchGoogleAd,\n  type ResearchGoogleAdsRequest,\n  type ResearchGoogleAdsResponse,\n  researchGoogleAdsFormatSchema,\n  researchGoogleAdsPlatformSchema,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { googleAdsHints } from \"./hints.ts\";\nimport {\n  handleResearchError,\n  type ResearchFix,\n  writeResearchHints,\n  writeResearchJson,\n  writeResearchOutput,\n} from \"./output.ts\";\n\n/** Reading twenty ad images takes a vision call on top of the search; the default 60s is too tight. */\nconst TIMEOUT_MS = 180_000;\n\nconst PLATFORMS = researchGoogleAdsPlatformSchema.options;\nconst FORMATS = [\"all\", ...researchGoogleAdsFormatSchema.options] as const;\n\nregisterSchema({\n  command: \"research.google-ads\",\n  description:\n    \"A competitor's Google ads, from Google's Ads Transparency Center: who runs each one, its format (text, image, video), when it was first and last shown and how many days it has run — the longest-running are the ones that pay. With --copy, the headline, description and display URL of up to 20 text ads. Start here: `baker research google-ads <competitor.com> --location <cc> --copy`. Never drive the Transparency Center in a browser instead.\",\n  args: {\n    target: {\n      type: \"string\",\n      description: \"Competitor domain (competitor.com, or any URL on it) or a Transparency advertiser id (AR…)\",\n      required: true,\n    },\n    location: {\n      type: \"string\",\n      description: \"Country code (es, mx, us…) where the ads were shown. Omit for every region\",\n      required: false,\n    },\n    platform: { type: \"string\", description: \"Where they ran\", required: false, enum: [...PLATFORMS] },\n    format: { type: \"string\", description: \"Only one ad format\", required: false, enum: [...FORMATS] },\n    since: { type: \"string\", description: \"Only ads shown on or after this day (YYYY-MM-DD)\", required: false },\n    limit: {\n      type: \"number\",\n      description: `Max ads (1-${RESEARCH_GOOGLE_ADS_MAX_LIMIT}, default ${RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT}; billed per 40)`,\n      required: false,\n    },\n    copy: {\n      type: \"boolean\",\n      description: `Read headline, description and display URL of up to ${RESEARCH_GOOGLE_ADS_MAX_COPY} text ads`,\n      required: false,\n      default: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"Add creative/advertiser ids, verification and preview image URL\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nconst FIELDS: Record<string, string> = {\n  advertiser: \"The Google Ads account that runs the ad (a brand can run several)\",\n  format: \"text | image | video\",\n  first_shown: \"First day Google showed it (UTC)\",\n  last_shown: \"Most recent day Google showed it (UTC) — recent means still running\",\n  days_running: \"First to last shown, inclusive: how long the advertiser has kept paying for it\",\n  copy: \"headline / description / display_url, read off the text ad's image (--copy); null otherwise\",\n  transparency_url: \"The ad on Google's Ads Transparency Center — the link to show the user\",\n};\n\nfunction compact(ad: ResearchGoogleAd) {\n  return {\n    advertiser: ad.advertiser,\n    format: ad.format,\n    first_shown: ad.first_shown,\n    last_shown: ad.last_shown,\n    days_running: ad.days_running,\n    copy: ad.copy,\n    transparency_url: ad.transparency_url,\n  };\n}\n\nfunction googleAdsFix(code: string): ResearchFix {\n  if (code === \"BAD_REQUEST\" || code === \"VALIDATION_ERROR\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation:\n        \"Pass the competitor's domain (competitor.com) or an advertiser id (AR…), and check the flag values.\",\n    };\n  }\n  return {\n    action: \"continue_without\",\n    explanation:\n      \"This read failed. Finish the rest of the job and name the competitor's Google ads as a gap — do not open the Transparency Center in a browser instead.\",\n  };\n}\n\nfunction invalid(message: string): never {\n  writeResearchJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message, fix: googleAdsFix(\"VALIDATION_ERROR\") } });\n  process.exit(1);\n}\n\nexport const googleAdsCommand = defineCommand({\n  meta: {\n    name: \"google-ads\",\n    description: `A competitor's Google ads, read from Google's Ads Transparency Center — no browser. Each ad: who runs it, format, first and last shown, days running, and its Transparency link. --copy reads the headline and description of the text ads.\n\nExamples:\n  baker research google-ads competitor.com --location es --copy\n  baker research google-ads competitor.com --platform google_search --format text --copy\n  baker research google-ads competitor.com --since 2026-07-01 --limit 80\n  baker research google-ads AR06744629793381154817 --output md`,\n  },\n  args: {\n    target: { type: \"positional\", description: \"Competitor domain or advertiser id (AR…)\", required: false },\n    location: {\n      type: \"string\",\n      description: \"Country code where the ads were shown (default: every region)\",\n      required: false,\n    },\n    platform: { type: \"string\", description: `${PLATFORMS.join(\"|\")} (default all)`, required: false },\n    format: { type: \"string\", description: `${FORMATS.join(\"|\")} (default all)`, required: false },\n    since: { type: \"string\", description: \"Only ads shown on or after YYYY-MM-DD\", required: false },\n    limit: {\n      type: \"string\",\n      description: `Max ads (default ${RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT}, max ${RESEARCH_GOOGLE_ADS_MAX_LIMIT})`,\n      required: false,\n    },\n    copy: { type: \"boolean\", description: \"Read the text ads' headline and description\", required: false },\n    full: { type: \"boolean\", description: \"Add ids, verification and preview image URL\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip the 6h server cache\", required: false },\n  },\n  run: async ({ args }) => {\n    const target = (args.target as string | undefined)?.trim();\n    if (!target) invalid(\"A competitor domain or advertiser id is required\");\n    const platform = (args.platform as string | undefined) ?? \"all\";\n    if (!researchGoogleAdsPlatformSchema.safeParse(platform).success) {\n      invalid(`--platform must be one of ${PLATFORMS.join(\", \")}`);\n    }\n    const format = (args.format as string | undefined) ?? \"all\";\n    if (!(FORMATS as readonly string[]).includes(format)) invalid(`--format must be one of ${FORMATS.join(\", \")}`);\n\n    const body: ResearchGoogleAdsRequest = {\n      target,\n      platform: platform as ResearchGoogleAdsRequest[\"platform\"],\n      format: format as ResearchGoogleAdsRequest[\"format\"],\n      copy: Boolean(args.copy),\n    };\n    if (args.location) body.location = args.location as string;\n    if (args.since) body.since = args.since as string;\n    if (args.limit) body.limit = Number(args.limit);\n    if (args[\"no-cache\"]) body.skipCache = true;\n\n    try {\n      const result = await apiPost<ResearchGoogleAdsResponse>(\"/api/research/google-ads\", body, {\n        timeoutMs: TIMEOUT_MS,\n      });\n      const hints = googleAdsHints({\n        target: result.target,\n        adCount: result.ads.length,\n        located: body.location !== undefined,\n        textWithoutCopy: result.ads.filter((ad) => ad.format === \"text\" && ad.copy === null).length,\n        copyAsked: body.copy === true,\n        copyUnread: result.copy_unread,\n        visual: result.ads.filter((ad) => ad.format !== \"text\").length,\n      });\n      const ads = args.full ? result.ads : result.ads.map(compact);\n      const output = (args.output as string) || \"json\";\n      if (output !== \"json\") {\n        writeResearchOutput(ads as unknown as Array<Record<string, unknown>>, output);\n        writeResearchHints(hints, output);\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        data: ads,\n        fields: FIELDS,\n        target: result.target,\n        total_ads: result.total_ads,\n        check_url: result.check_url,\n        hints,\n      });\n    } catch (err) {\n      handleResearchError(err, googleAdsFix);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/group-CTIZVYX2.js

@@ -0,0 +1,43 @@
+import {
+  runMediaGroupLookup
+} from "./chunk-G7LAQE56.js";
+import "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/group.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.group",
+  description: "List every image and clip that arrived in the same set as this one (carousel slides, one page's images)",
+  args: {
+    id: { type: "string", description: "An image or video id \u2014 returns that asset's whole set", required: false },
+    "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
+  }
+});
+var groupCommand = defineCommand({
+  meta: {
+    name: "group",
+    description: "List every asset that arrived in the same set \u2014 the slides of one Instagram carousel, the images off one scraped page. Start here whenever a hit looks like part of a sequence: carousel slides are authored to be read in order and usually only make sense together. Takes an image or a video id, since one carousel can contain both. Example: baker images group <imageId>"
+  },
+  args: {
+    id: { type: "positional", description: "An image or video id from the set", required: false },
+    "group-key": { type: "string", description: "The set key, if you already have it", required: false }
+  },
+  run: async ({ args }) => {
+    await runMediaGroupLookup({
+      id: args.id,
+      groupKey: args["group-key"],
+      path: "/api/images/group",
+      idLabel: "an image or video id"
+    });
+  }
+});
+export {
+  groupCommand
+};
+//# sourceMappingURL=group-CTIZVYX2.js.map

package/dist/group-HKWQ75CJ.js

@@ -0,0 +1,43 @@
+import {
+  runMediaGroupLookup
+} from "./chunk-G7LAQE56.js";
+import "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/group.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "videos.group",
+  description: "List every clip and image that arrived in the same set as this video (carousel slides, one page)",
+  args: {
+    id: { type: "string", description: "A video or image id \u2014 returns that asset's whole set", required: false },
+    "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
+  }
+});
+var groupCommand = defineCommand({
+  meta: {
+    name: "group",
+    description: "List every asset that arrived in the same set as this clip \u2014 the other slides of the Instagram post it came from, stills included. A carousel is authored to be read in order, so a clip pulled out of one is usually missing half its meaning. Example: baker videos group <videoId>"
+  },
+  args: {
+    id: { type: "positional", description: "A video or image id from the set", required: false },
+    "group-key": { type: "string", description: "The set key, if you already have it", required: false }
+  },
+  run: async ({ args }) => {
+    await runMediaGroupLookup({
+      id: args.id,
+      groupKey: args["group-key"],
+      path: "/api/videos/group",
+      idLabel: "a video or image id"
+    });
+  }
+});
+export {
+  groupCommand
+};
+//# sourceMappingURL=group-HKWQ75CJ.js.map

package/dist/gsc-CORRYJBJ.js

@@ -0,0 +1,30 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/gsc/index.ts
+import { defineCommand } from "citty";
+var gscCommand = defineCommand({
+  meta: {
+    name: "gsc",
+    description: `Google Search Console commands. PPC-SEO arbitrage, brand halo analysis, negative keyword discovery.
+
+Start here:
+  baker gsc sites                         \u2014 list verified sites
+  baker gsc query --list-presets          \u2014 see available query presets
+
+Examples:
+  baker gsc query --preset cannibalization                          \u2014 find PPC-SEO overlap
+  baker gsc query --preset brand-halo --brand "Acme" --days 90      \u2014 brand search trends
+  baker gsc query --dimensions "query,page" --days 28               \u2014 free-form query
+  baker gsc sitemaps                                                \u2014 check sitemap health
+Full guide: __tooling__/docs/tools/baker/gsc.md`
+  },
+  subCommands: {
+    sites: () => import("./sites-6B76JW6C.js").then((m) => m.sitesCommand),
+    query: () => import("./query-TWNH6GV7.js").then((m) => m.queryCommand),
+    sitemaps: () => import("./sitemaps-7KHY2KXI.js").then((m) => m.sitemapsCommand)
+  }
+});
+export {
+  gscCommand
+};
+//# sourceMappingURL=gsc-CORRYJBJ.js.map

package/dist/history-ZRCMN5TI.js

@@ -0,0 +1,133 @@
+import {
+  failApi
+} from "./chunk-6KD4HB6Y.js";
+import "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/history/index.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "history.list",
+  description: "Start here: unified account history (audit log) \u2014 everything that changed on this account, newest first: publishes, chat lifecycle, backlog actions, team changes, setup links, tags, schedules, ad-platform writes, followed advertisers, media, creatives, reports, domains, and integrations. Use it to see what happened recently before planning work. Compact by default; add --full for raw metadata per entry.",
+  args: {
+    limit: {
+      type: "string",
+      description: "Max entries to return, 1-200 (default: 30)",
+      required: false
+    },
+    category: {
+      type: "string",
+      description: "Filter: publish|chat|action|team|setup_link|company|tag|schedule|ads|advertiser|media|creative|report|domain|integration",
+      required: false
+    },
+    days: {
+      type: "string",
+      description: "Only entries from the last N days (1-365)",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Include raw metadata for each entry",
+      required: false,
+      default: false
+    }
+  }
+});
+var CATEGORIES = [
+  "publish",
+  "chat",
+  "action",
+  "team",
+  "setup_link",
+  "company",
+  "tag",
+  "schedule",
+  "ads",
+  "advertiser",
+  "media",
+  "creative",
+  "report",
+  "domain",
+  "integration"
+];
+function parseBoundedInt(raw, name, min, max) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  const value = Number.parseInt(raw, 10);
+  if (Number.isNaN(value) || value < min || value > max) {
+    throw new Error(`--${name} must be an integer between ${min} and ${max}`);
+  }
+  return value;
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List recent account changes (unified audit log), newest first."
+  },
+  args: {
+    limit: { type: "string", description: "Max entries (1-200, default 30)", required: false },
+    category: {
+      type: "string",
+      description: "Filter: publish|chat|action|team|setup_link|company|tag|schedule|ads|advertiser|media|creative|report|domain|integration",
+      required: false
+    },
+    days: { type: "string", description: "Only the last N days (1-365)", required: false },
+    full: { type: "boolean", description: "Include raw metadata", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = {};
+      const limit = parseBoundedInt(args.limit, "limit", 1, 200);
+      if (limit !== void 0) {
+        body.limit = limit;
+      }
+      const days = parseBoundedInt(args.days, "days", 1, 365);
+      if (days !== void 0) {
+        body.days = days;
+      }
+      if (args.category) {
+        if (!CATEGORIES.includes(args.category)) {
+          throw new Error(`--category must be one of: ${CATEGORIES.join("|")}`);
+        }
+        body.category = args.category;
+      }
+      if (args.full) {
+        body.full = true;
+      }
+      const response = await apiPost("/api/history/list", body);
+      writeJson({
+        ...response,
+        meta: { count: response.data.entries.length },
+        ...response.data.entries.length === 0 ? { hints: ["No history entries matched. Widen with a larger --days or drop --category."] } : {}
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var historyCommand = defineCommand({
+  meta: {
+    name: "history",
+    description: `Unified account history (audit log): what changed, who did it, and when.
+Full guide: __tooling__/docs/tools/baker/history.md`
+  },
+  subCommands: { list: listCommand }
+});
+export {
+  historyCommand
+};
+//# sourceMappingURL=history-ZRCMN5TI.js.map

package/dist/history-ZRCMN5TI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/history/index.ts"],"sourcesContent":["import type { HistoryListResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi } from \"../actions/shared.ts\";\n\nregisterSchema({\n  command: \"history.list\",\n  description:\n    \"Start here: unified account history (audit log) — everything that changed on this account, newest first: publishes, chat lifecycle, backlog actions, team changes, setup links, tags, schedules, ad-platform writes, followed advertisers, media, creatives, reports, domains, and integrations. Use it to see what happened recently before planning work. Compact by default; add --full for raw metadata per entry.\",\n  args: {\n    limit: {\n      type: \"string\",\n      description: \"Max entries to return, 1-200 (default: 30)\",\n      required: false,\n    },\n    category: {\n      type: \"string\",\n      description:\n        \"Filter: publish|chat|action|team|setup_link|company|tag|schedule|ads|advertiser|media|creative|report|domain|integration\",\n      required: false,\n    },\n    days: {\n      type: \"string\",\n      description: \"Only entries from the last N days (1-365)\",\n      required: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"Include raw metadata for each entry\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nconst CATEGORIES = [\n  \"publish\",\n  \"chat\",\n  \"action\",\n  \"team\",\n  \"setup_link\",\n  \"company\",\n  \"tag\",\n  \"schedule\",\n  \"ads\",\n  \"advertiser\",\n  \"media\",\n  \"creative\",\n  \"report\",\n  \"domain\",\n  \"integration\",\n] as const;\n\nfunction parseBoundedInt(raw: string | undefined, name: string, min: number, max: number): number | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const value = Number.parseInt(raw, 10);\n  if (Number.isNaN(value) || value < min || value > max) {\n    throw new Error(`--${name} must be an integer between ${min} and ${max}`);\n  }\n  return value;\n}\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description: \"List recent account changes (unified audit log), newest first.\",\n  },\n  args: {\n    limit: { type: \"string\", description: \"Max entries (1-200, default 30)\", required: false },\n    category: {\n      type: \"string\",\n      description:\n        \"Filter: publish|chat|action|team|setup_link|company|tag|schedule|ads|advertiser|media|creative|report|domain|integration\",\n      required: false,\n    },\n    days: { type: \"string\", description: \"Only the last N days (1-365)\", required: false },\n    full: { type: \"boolean\", description: \"Include raw metadata\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const body: Record<string, unknown> = {};\n      const limit = parseBoundedInt(args.limit, \"limit\", 1, 200);\n      if (limit !== undefined) {\n        body.limit = limit;\n      }\n      const days = parseBoundedInt(args.days, \"days\", 1, 365);\n      if (days !== undefined) {\n        body.days = days;\n      }\n      if (args.category) {\n        if (!(CATEGORIES as readonly string[]).includes(args.category)) {\n          throw new Error(`--category must be one of: ${CATEGORIES.join(\"|\")}`);\n        }\n        body.category = args.category;\n      }\n      if (args.full) {\n        body.full = true;\n      }\n      const response = await apiPost<HistoryListResponse>(\"/api/history/list\", body);\n      writeJson({\n        ...response,\n        meta: { count: response.data.entries.length },\n        ...(response.data.entries.length === 0\n          ? { hints: [\"No history entries matched. Widen with a larger --days or drop --category.\"] }\n          : {}),\n      });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n\nexport const historyCommand = defineCommand({\n  meta: {\n    name: \"history\",\n    description: `Unified account history (audit log): what changed, who did it, and when.\nFull guide: __tooling__/docs/tools/baker/history.md`,\n  },\n  subCommands: { list: listCommand },\n});\n"],"mappings":"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","names":[]}

package/dist/history-ZTDRLZQL.js

@@ -0,0 +1,67 @@
+import {
+  schemaArgs
+} from "./chunk-GJ3BWGOJ.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-2I35PA3W.js";
+import "./chunk-6SL6463H.js";
+import {
+  apiGet
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/history.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  days: { type: "string", description: "The last N days, 1-90 (default 7)" },
+  limit: { type: "string", description: "Changes to show, 1-100 (default 50), newest first" },
+  "campaign-id": { type: "string", description: "Only this campaign and what is under it" },
+  "ad-group-id": { type: "string", description: "Only this ad group and its ads" },
+  "ad-id": { type: "string", description: "Only this ad" }
+};
+registerSchema({
+  command: "ads.chatgpt.history",
+  description: "What changed in the ChatGPT Ads account \u2014 by Baker or anyone in Ads Manager \u2014 newest first: each change, what it touched, and each field before and after (money in micros).",
+  args: schemaArgs(ARGS)
+});
+var historyCommand = defineCommand({
+  meta: {
+    name: "history",
+    description: `What changed in the account, and when.
+
+Examples:
+  baker ads chatgpt history
+  baker ads chatgpt history --campaign-id cmpn_123 --days 30`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const params = {};
+    for (const [flag, name] of [
+      ["days", "days"],
+      ["limit", "limit"],
+      ["campaign-id", "campaign_id"],
+      ["ad-group-id", "ad_group_id"],
+      ["ad-id", "ad_id"]
+    ]) {
+      const value = args[flag];
+      if (typeof value === "string" && value.trim()) {
+        params[name] = value.trim();
+      }
+    }
+    await runChatgptRead(
+      CHATGPT_ADS_REFERENCE.overview,
+      () => apiGet("/api/ads/chatgpt/history", params),
+      (entries) => entries.length === 0 ? ["No change in this window. Widen it with --days (up to 90)."] : []
+    );
+  }
+});
+export {
+  historyCommand
+};
+//# sourceMappingURL=history-ZTDRLZQL.js.map