@koda-sl/baker-cli 0.571.0-dev.6a3439a0a → 0.572.0-dev.61ba69c66

package/dist/google-ZVAIFXQZ.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-6AMN346B.js";
-import "./chunk-I7OJZ7QE.js";
-import {
-  imagesGoogleRequestSchema
-} from "./chunk-6DSPB6YA.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-IMS53EQU.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-LJEJCIHR.js";
-import "./chunk-SIRRBWQ2.js";
-import "./chunk-B64KJW5C.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-NXNOXZGB.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-ZVAIFXQZ.js.map

package/dist/google-ads-6Z7P3SCD.js

@@ -1,198 +0,0 @@
-import {
-  googleAdsHints
-} from "./chunk-MFGUR5OD.js";
-import {
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-MTW2NDDD.js";
-import {
-  RESEARCH_GOOGLE_ADS_DEFAULT_LIMIT,
-  RESEARCH_GOOGLE_ADS_MAX_COPY,
-  RESEARCH_GOOGLE_ADS_MAX_LIMIT,
-  researchGoogleAdsFormatSchema,
-  researchGoogleAdsPlatformSchema
-} from "./chunk-6DSPB6YA.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-IMS53EQU.js";
-import {
-  apiPost
-} from "./chunk-LJEJCIHR.js";
-import "./chunk-SIRRBWQ2.js";
-import "./chunk-B64KJW5C.js";
-import {
-  registerSchema
-} from "./chunk-NXNOXZGB.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-6Z7P3SCD.js.map

package/dist/group-3DT4UYSR.js

@@ -1,43 +0,0 @@
-import {
-  runMediaGroupLookup
-} from "./chunk-S5S54J2K.js";
-import "./chunk-LJEJCIHR.js";
-import "./chunk-SIRRBWQ2.js";
-import "./chunk-B64KJW5C.js";
-import {
-  registerSchema
-} from "./chunk-NXNOXZGB.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-3DT4UYSR.js.map

package/dist/group-OEKKCFXT.js

@@ -1,43 +0,0 @@
-import {
-  runMediaGroupLookup
-} from "./chunk-S5S54J2K.js";
-import "./chunk-LJEJCIHR.js";
-import "./chunk-SIRRBWQ2.js";
-import "./chunk-B64KJW5C.js";
-import {
-  registerSchema
-} from "./chunk-NXNOXZGB.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-OEKKCFXT.js.map

package/dist/gsc-4FEFPFPB.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-KLAKI2EY.js").then((m) => m.sitesCommand),
-    query: () => import("./query-63CTX2PH.js").then((m) => m.queryCommand),
-    sitemaps: () => import("./sitemaps-Z6IELTQV.js").then((m) => m.sitemapsCommand)
-  }
-});
-export {
-  gscCommand
-};
-//# sourceMappingURL=gsc-4FEFPFPB.js.map

package/dist/history-4QUV45ZJ.js

@@ -1,102 +0,0 @@
-import {
-  failApi,
-  failValidation,
-  validateScheduledAgentRef
-} from "./chunk-3KUNRKNV.js";
-import "./chunk-XA76OGSL.js";
-import "./chunk-6DSPB6YA.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-IMS53EQU.js";
-import {
-  apiPost
-} from "./chunk-LJEJCIHR.js";
-import "./chunk-SIRRBWQ2.js";
-import "./chunk-B64KJW5C.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-NXNOXZGB.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/scheduled-agents/history.ts
-import { defineCommand } from "citty";
-var ONLY_DESCRIPTION = "ran: only the firings that opened a run. skipped: only the ones that did not \u2014 its rules or its AI check turned down what arrived, its last run was still going, its quiet period, not one of its times, switched off.";
-var LIMIT_DESCRIPTION = "How many lines on this page, 1\u2013200. Default 50.";
-var CURSOR_DESCRIPTION = "The nextCursor of the previous page, to read older firings. Left out, the newest page.";
-var FULL_DESCRIPTION = "Include what arrived with each firing (emails and phones masked).";
-registerSchema({
-  command: "scheduled-agents.history",
-  description: "Every time a published scheduled agent's trigger fired, newest first, and what became of it: `ran` with the run's chatId and runStatus, or why it did not run (rules, ai_check with the AI check's score, busy, already_handled, cooling_down, occurrence, paused, closed). Start here when the user asks why an agent did or did not run. --full adds what arrived. Paged, newest first: pass the returned nextCursor as --cursor for older firings.",
-  args: {
-    id: { type: "string", description: "Published scheduled agent ID", required: true },
-    limit: { type: "string", description: LIMIT_DESCRIPTION, required: false },
-    cursor: { type: "string", description: CURSOR_DESCRIPTION, required: false },
-    only: { type: "string", description: ONLY_DESCRIPTION, required: false, enum: ["ran", "skipped"] },
-    full: { type: "boolean", description: FULL_DESCRIPTION, required: false }
-  }
-});
-var historyCommand = defineCommand({
-  meta: {
-    name: "history",
-    description: "What happened each time a scheduled agent was triggered: the runs, and the firings that did not run and why. Start here: baker scheduled-agents history <id> | baker scheduled-agents history <id> --only skipped --full"
-  },
-  args: {
-    id: { type: "positional", description: "Published scheduled agent ID", required: false },
-    "scheduled-agent-id": {
-      type: "string",
-      description: "Scheduled agent ID (alternative to positional)",
-      required: false
-    },
-    limit: { type: "string", description: LIMIT_DESCRIPTION, required: false },
-    cursor: { type: "string", description: CURSOR_DESCRIPTION, required: false },
-    only: { type: "string", description: ONLY_DESCRIPTION, required: false },
-    full: { type: "boolean", description: FULL_DESCRIPTION, required: false, default: false }
-  },
-  run: async ({ args }) => {
-    try {
-      const id = args.id || args["scheduled-agent-id"];
-      if (!id) {
-        failValidation("Scheduled agent ID is required.");
-      }
-      validateScheduledAgentRef(id);
-      const body = {
-        id,
-        ...historyLimit(args.limit),
-        ...typeof args.cursor === "string" && args.cursor.length > 0 ? { cursor: args.cursor } : {},
-        ...historyOnly(args.only),
-        ...args.full === true ? { full: true } : {}
-      };
-      writeJson(await apiPost("/api/scheduled-agents/history", body));
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-function historyLimit(raw) {
-  if (raw === void 0) {
-    return {};
-  }
-  const limit = Number(raw);
-  if (!Number.isInteger(limit) || limit < 1 || limit > 200) {
-    failValidation("--limit must be a whole number from 1 to 200.");
-  }
-  return { limit };
-}
-function historyOnly(raw) {
-  if (raw === void 0) {
-    return {};
-  }
-  if (raw !== "ran" && raw !== "skipped") {
-    failValidation("--only must be ran or skipped.");
-  }
-  return { only: raw };
-}
-export {
-  historyCommand
-};
-//# sourceMappingURL=history-4QUV45ZJ.js.map