@koda-sl/baker-cli 0.563.0-dev.25ca3cbc8 → 0.564.0

package/dist/google-VNEVAKGL.js

@@ -1,163 +0,0 @@
-import {
-  parseRequestFlags
-} from "./chunk-4N3Y5QWW.js";
-import {
-  AUTO_INGEST_MAX,
-  parseAutoIngest
-} from "./chunk-KKJ4KJCW.js";
-import {
-  activeFilterFlags,
-  emptyResultHints
-} from "./chunk-Q6ULQMWG.js";
-import {
-  OUTPUT_ARGS,
-  writeProviderHits
-} from "./chunk-KNA3OWJC.js";
-import "./chunk-I7OJZ7QE.js";
-import {
-  imagesGoogleRequestSchema
-} from "./chunk-OVNVYNVH.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-R7XDGNZD.js";
-import "./chunk-7XFVKPE5.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-QEREDRZO.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-CCYZJMZ7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/images/google.ts
-import { defineCommand } from "citty";
-var GOOGLE_ERROR_FIX = {
-  action: "use_different_resource",
-  explanation: "Generate the asset instead of retrying Google. Google is the last-resort image provider. Run `baker studio generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
-};
-registerSchema({
-  command: "images.google",
-  description: "Google Images search via the official Custom Search JSON API. Unverified source \u2014 inspect before placing.",
-  args: {
-    query: { type: "string", description: "Search query", required: true },
-    type: {
-      type: "string",
-      description: "imgType: photo | clipart | lineart | stock | animated | face | news",
-      required: false
-    },
-    size: {
-      type: "string",
-      description: "imgSize: icon | small | medium | large | xlarge | xxlarge | huge",
-      required: false
-    },
-    color: {
-      type: "string",
-      description: "imgColorType: color | gray | mono | trans",
-      required: false
-    },
-    safe: { type: "string", description: "safe: off | active", required: false },
-    limit: { type: "number", description: "Max results (1-50, paginated 10 per call)", required: false, default: 10 },
-    "auto-ingest": {
-      type: "number",
-      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.google}, default 0) and return Baker-owned URLs on ingested hits`,
-      required: false,
-      default: 0
-    },
-    context: {
-      type: "string",
-      description: "Free-text hint applied to every auto-ingested hit (overrides Google title)",
-      required: false
-    },
-    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
-    fields: { type: "string", description: "Comma-separated field names to include", required: false },
-    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
-  }
-});
-var googleCommand = defineCommand({
-  meta: {
-    name: "google",
-    description: "Google Images via the official Custom Search JSON API ($0.005/query, free 100/day). \u26A0 Source unverified \u2014 watermarks, low-res, mislabeled results are common. Use as last resort. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExample: baker images google 'industrial workshop' --type photo --size large --limit 20"
-  },
-  args: {
-    query: { type: "positional", description: "Search query", required: false },
-    type: { type: "string", description: "imgType filter", required: false },
-    size: { type: "string", description: "imgSize filter", required: false },
-    color: { type: "string", description: "imgColorType filter", required: false },
-    safe: { type: "string", description: "safe (off|active)", required: false },
-    limit: { type: "string", description: "Max results (1-50)", required: false },
-    "auto-ingest": {
-      type: "string",
-      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.google}) and return Baker-owned URLs on ingested hits`,
-      required: false
-    },
-    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false },
-    ...OUTPUT_ARGS
-  },
-  run: async ({ args }) => {
-    try {
-      const query = args.query;
-      if (!query) {
-        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
-        process.exit(1);
-      }
-      const body = { query };
-      if (args.type) body.type = args.type;
-      if (args.size) body.size = args.size;
-      if (args.color) body.color = args.color;
-      if (args.safe) body.safe = args.safe;
-      if (args.limit) body.limit = Number(args.limit);
-      if (args["auto-ingest"] !== void 0) {
-        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.google);
-        if (!parsed.ok) {
-          writeJson({
-            ok: false,
-            error: {
-              code: "VALIDATION_ERROR",
-              message: parsed.message,
-              fix: {
-                action: "retry_with_changes",
-                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.google}.`
-              }
-            }
-          });
-          process.exit(1);
-        }
-        body.autoIngest = parsed.value;
-      }
-      if (args.context) body.descriptionContext = args.context;
-      const request = parseRequestFlags(imagesGoogleRequestSchema, body, { limit: "--limit", safe: "--safe" });
-      if (!request.ok) {
-        writeJson(request.envelope);
-        process.exit(1);
-      }
-      const data = await apiPost("/api/images/google", request.data);
-      const hints = emptyResultHints({
-        provider: "google",
-        hitCount: data.hits.length,
-        activeFilters: activeFilterFlags(args, ["type", "size", "color", "safe"])
-      });
-      writeProviderHits(data, data.hits, args, hints);
-    } catch (err) {
-      if (err instanceof ApiError) {
-        writeJson({
-          ok: false,
-          error: { code: err.code, message: err.message, fix: GOOGLE_ERROR_FIX }
-        });
-        process.exit(1);
-      }
-      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-      process.exit(1);
-    }
-  }
-});
-export {
-  googleCommand
-};
-//# sourceMappingURL=google-VNEVAKGL.js.map

package/dist/google-ads-WXZHRP2N.js

@@ -1,198 +0,0 @@
-import {
-  googleAdsHints
-} from "./chunk-AJFWK2DW.js";
-import {
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-D3YAFC6K.js";
-import {
-  RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT,
-  RESEARCH_GOOGLE_ADS_MAX_COPY,
-  RESEARCH_GOOGLE_ADS_MAX_LIMIT,
-  researchGoogleAdsFormatSchema,
-  researchGoogleAdsPlatformSchema
-} from "./chunk-OVNVYNVH.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-R7XDGNZD.js";
-import "./chunk-7XFVKPE5.js";
-import {
-  apiPost
-} from "./chunk-QEREDRZO.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema
-} from "./chunk-CCYZJMZ7.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-WXZHRP2N.js.map

package/dist/gsc-OJDMSP6H.js

@@ -1,30 +0,0 @@
-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-TURWC53D.js").then((m) => m.sitesCommand),
-    query: () => import("./query-QXKGVHZL.js").then((m) => m.queryCommand),
-    sitemaps: () => import("./sitemaps-P3K5Z4TW.js").then((m) => m.sitemapsCommand)
-  }
-});
-export {
-  gscCommand
-};
-//# sourceMappingURL=gsc-OJDMSP6H.js.map

package/dist/history-4Q6SPKOJ.js

@@ -1,69 +0,0 @@
-import {
-  schemaArgs
-} from "./chunk-6E5S477W.js";
-import {
-  CHATGPT_ADS_REFERENCE,
-  runChatgptRead
-} from "./chunk-6UNTNNQB.js";
-import "./chunk-RBCO3C3Q.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import {
-  apiGet
-} from "./chunk-QEREDRZO.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema
-} from "./chunk-CCYZJMZ7.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-4Q6SPKOJ.js.map

package/dist/history-JECMIEEV.js

@@ -1,153 +0,0 @@
-import {
-  failApi
-} from "./chunk-HC6464KT.js";
-import "./chunk-OVNVYNVH.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-R7XDGNZD.js";
-import "./chunk-7XFVKPE5.js";
-import {
-  apiPost
-} from "./chunk-QEREDRZO.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-CCYZJMZ7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/history/index.ts
-import { defineCommand } from "citty";
-var CURSOR_DESCRIPTION = "The meta.nextCursor of the previous page, to read the entries older than it (same --days and --category). Left out, the newest page.";
-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. Paged, newest first: meta.hasMore says older entries exist, and passing meta.nextCursor as --cursor reads them.",
-  args: {
-    limit: {
-      type: "string",
-      description: "Max entries to return, 1-200 (default: 30)",
-      required: false
-    },
-    cursor: { type: "string", description: CURSOR_DESCRIPTION, 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;
-}
-function fullPageHint(entries, nextCursor, days) {
-  const oldest = entries[entries.length - 1];
-  const reached = oldest ? `reaches back only to ${new Date(oldest.at).toISOString()}` : "is not the whole window";
-  const window = days === void 0 ? "" : ` of the --days ${days} asked for`;
-  return `This page holds ${entries.length} entries and ${reached}${window}: older entries exist and are NOT shown. Do not report it as everything that changed \u2014 re-run the same command with --cursor ${nextCursor} for the next page, or narrow with --category.`;
-}
-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 },
-    cursor: { type: "string", description: CURSOR_DESCRIPTION, 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.cursor) {
-        body.cursor = args.cursor;
-      }
-      if (args.full) {
-        body.full = true;
-      }
-      const response = await apiPost("/api/history/list", body);
-      const { entries, nextCursor } = response.data;
-      const hints = [
-        ...entries.length === 0 ? ["No history entries matched. Widen with a larger --days or drop --category."] : [],
-        ...nextCursor ? [fullPageHint(entries, nextCursor, days)] : []
-      ];
-      writeJson({
-        ...response,
-        meta: { count: entries.length, hasMore: Boolean(nextCursor), ...nextCursor ? { nextCursor } : {} },
-        ...hints.length > 0 ? { hints } : {}
-      });
-    } 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-JECMIEEV.js.map