@koda-sl/baker-cli 0.489.0-dev.63e618e80 → 0.490.0

package/dist/google-ads-G7REKD4A.js

@@ -0,0 +1,195 @@
+import {
+  googleAdsHints
+} from "./chunk-NEIUVSDK.js";
+import {
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-BFRIRZRZ.js";
+import {
+  RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT,
+  RESEARCH_GOOGLE_ADS_MAX_COPY,
+  RESEARCH_GOOGLE_ADS_MAX_LIMIT,
+  researchGoogleAdsFormatSchema,
+  researchGoogleAdsPlatformSchema
+} from "./chunk-66QHX566.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import {
+  registerSchema
+} from "./chunk-WNSE7N75.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-G7REKD4A.js.map

package/dist/gsc-FIZTQX3N.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-GRC6CCCK.js").then((m) => m.sitesCommand),
+    query: () => import("./query-YBS6ZQ75.js").then((m) => m.queryCommand),
+    sitemaps: () => import("./sitemaps-QKKXMXMV.js").then((m) => m.sitemapsCommand)
+  }
+});
+export {
+  gscCommand
+};
+//# sourceMappingURL=gsc-FIZTQX3N.js.map

package/dist/history-QKDYBSYM.js

@@ -0,0 +1,67 @@
+import {
+  schemaArgs
+} from "./chunk-AQM4JH62.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-IG627WWY.js";
+import "./chunk-SWL4AAPP.js";
+import {
+  apiGet
+} from "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import {
+  registerSchema
+} from "./chunk-WNSE7N75.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-QKDYBSYM.js.map

package/dist/history-YMK2JNZU.js

@@ -0,0 +1,133 @@
+import {
+  failApi
+} from "./chunk-TP7HKSBX.js";
+import "./chunk-66QHX566.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WNSE7N75.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-YMK2JNZU.js.map