@koda-sl/baker-cli 0.510.0 → 0.512.0-dev.8a743a629

package/dist/icon-XHPEVICH.js

@@ -0,0 +1,137 @@
+import {
+  brandVerificationHints
+} from "./chunk-IVIJJXXT.js";
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-ESQX7SRQ.js";
+import {
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/icon.ts
+import { defineCommand } from "citty";
+var BRAND_MARK_SETS = /* @__PURE__ */ new Set(["simple-icons", "logos", "devicon", "cib", "fa6-brands", "fa-brands", "skill-icons"]);
+function isBrandMarkLookup(name, set) {
+  if (set && BRAND_MARK_SETS.has(set)) {
+    return true;
+  }
+  const prefix = name.includes(":") ? name.split(":")[0] : void 0;
+  return prefix !== void 0 && BRAND_MARK_SETS.has(prefix);
+}
+registerSchema({
+  command: "images.icon",
+  description: "Icon lookup via Iconify (200+ icon sets, free CDN).",
+  args: {
+    name: { type: "string", description: "Icon name (or prefixed 'lucide:check')", required: true },
+    set: {
+      type: "string",
+      description: "Iconify set (simple-icons, logos, lucide, devicon, heroicons, tabler, \u2026)",
+      required: false
+    },
+    color: { type: "string", description: "Hex color (replaces currentColor)", required: false },
+    width: { type: "number", description: "Render width in px", required: false },
+    "auto-ingest": {
+      type: "number",
+      description: `Auto-ingest top N hits (0-${AUTO_INGEST_MAX.icon}, default 0). The Iconify CDN URL is stable so ingest is opt-in.`,
+      required: false,
+      default: 0
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to ingested icons (e.g. 'Stripe integration logo', 'feature checklist icon')",
+      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 iconCommand = defineCommand({
+  meta: {
+    name: "icon",
+    description: "Icon via Iconify (simple-icons, logos, lucide, devicon, heroicons, tabler, phosphor, material-symbols, \u2026). Free CDN, no API key.\n\nExample: baker images icon react --set devicon\nExample: baker images icon lucide:check --color '#0a0a0a'"
+  },
+  args: {
+    name: { type: "positional", description: "Icon name or prefixed id", required: false },
+    set: { type: "string", description: "Iconify set", required: false },
+    color: { type: "string", description: "Hex color", required: false },
+    width: { type: "string", description: "Width in px", required: false },
+    "auto-ingest": { type: "string", description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.icon})`, required: false },
+    context: { type: "string", description: "Description context hint applied to ingested icons", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const name = args.name;
+      if (!name) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Icon name is required" } });
+        process.exit(1);
+      }
+      const body = { name };
+      const set = args.set;
+      if (set) body.set = set;
+      if (args.color) body.color = args.color;
+      if (args.width) body.width = Number(args.width);
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.icon);
+        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.icon}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/icon", body);
+      const hints = [
+        // A brand-mark set matches on the icon slug, so it mis-ships another
+        // company's mark the same way Brandfetch does — same check applies.
+        ...isBrandMarkLookup(name, set) ? brandVerificationHints({
+          domain: name,
+          ingested: data.ingested,
+          hitCount: data.hits.length,
+          recover: "`baker images logo <the brand's domain>`, which resolves the brand's own published mark"
+        }) : [],
+        ...emptyResultHints({ provider: "icon", hitCount: data.hits.length, activeFilters: [], subject: name })
+      ];
+      writeProviderHits(data, data.hits, args, hints);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  iconCommand,
+  isBrandMarkLookup
+};
+//# sourceMappingURL=icon-XHPEVICH.js.map

package/dist/ideas-UICGLEUI.js

@@ -0,0 +1,43 @@
+import {
+  buildNext,
+  compactIdea,
+  ideasCommand,
+  ideasHints,
+  ideasReport
+} from "./chunk-ETWTY7IU.js";
+import "./chunk-DQVI7GCX.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-KTZCLJ2D.js";
+import "./chunk-RPGPHMUY.js";
+import "./chunk-MKUA54QE.js";
+import "./chunk-6ZFSDYWV.js";
+import "./chunk-QPESDKZC.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-FJZYOVSW.js";
+import "./chunk-F3CZFUXZ.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-7D7YRHN3.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  buildNext,
+  compactIdea,
+  ideasCommand,
+  ideasHints,
+  ideasReport
+};
+//# sourceMappingURL=ideas-UICGLEUI.js.map

package/dist/images-TJGUKE2W.js

@@ -0,0 +1,92 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/index.ts
+import { defineCommand } from "citty";
+var imagesCommand = defineCommand({
+  meta: {
+    name: "images",
+    description: `Find, source, and normalize images. Subcommands route by provider so cost + license are explicit.
+
+Library + search:
+  baker images library <q>              Search the company library (replaces search)
+  baker images find <q> --sources \u2026     Fanout: library first, then opt-in providers
+
+External providers:
+  baker images stock <q> [--type \u2026]                    Free stock \u2014 Pexels photos + Pixabay illustrations/vectors
+  baker images google <q>                              Google Images via the official Custom Search API
+  baker images pinterest <q>                           Pinterest reference imagery via ScrapeCreators (photo-real mood boards)
+  baker images logo <domain>                           Brand logo via Brandfetch CDN
+  baker images icon <name> [--set \u2026]                   Iconify (200+ sets)
+  baker images meme <reaction> [--auto-ingest N]       The real, well-known meme template for a reaction (Imgflip)
+  baker images gif <q> [--trending]                    Giphy GIFs / reaction memes (paid-social creative)
+  baker images sticker <q> [--trending]                Giphy stickers \u2014 transparent overlays for ad creative
+  baker images extract <url>                           Firecrawl page extract
+  baker images screenshot <url>                        ScreenshotOne capture
+
+Making new imagery lives in its own family \u2014 baker studio generate / baker studio animate. See __tooling__/docs/tools/baker/studio.md
+
+Library writes (run on the Convex backend):
+  baker images ingest <url> --source <enum>            Save remote URL to library
+  baker images use <url>                               Ingest and wait for ready
+  baker images upload ./file                           Upload local file
+  baker images get <id>                                Get a single record
+  baker images group <id>                              Every image that arrived in the same set (carousel, page scrape)
+  baker images delete <id>                             Delete a record
+  baker images retry <id>                              Process a failed image (status 'error') again
+  baker images describe <id> --description "\u2026"         Correct a wrong name/description/tags \u2014 what library search reads on
+
+Local transforms (operate on files in the sandbox, before upload):
+  baker images download <url|imageId\u2026> [--out \u2026]      Remote URL or library image \u2192 local file (never use curl)
+  baker images normalize <files> [--color \u2026] [--remove-bg] [--height N | --width N | --size WxH]
+                                                       Declarative recolor + bg removal + trim + resize
+  baker images crop <file> --x N --y N --width N --height N
+                                                       Coordinate-based rectangular extract
+  baker images dimensions <file-or-url>                Width / height / aspect / format without decoding the full image
+
+Taxonomy:
+  baker images tags                                    List available image tag names (defaults + company custom tags)
+  baker images tags create|update|delete <name>        Manage the company's custom tags (shared with videos and testimonials)
+
+Paid transforms (run on the Convex backend, cost-tracked):
+  baker images upscale <imageId>                       Real-ESRGAN super-resolution ($0.05/image, waits for completion)
+  baker images upscale <imageId> --remove              Drop the upscaled copy, back to the original (free)
+  baker images layerize <imageId>                      Split into editable layers; recovers baked-in copy as editable text (costs credits)
+  baker images layers <imageId>                        Read the layers of an already-split image (free)
+Full guide: __tooling__/docs/tools/baker/images.md`
+  },
+  subCommands: {
+    get: () => import("./get-UOXXHYXJ.js").then((m) => m.getCommand),
+    group: () => import("./group-JROMVKDU.js").then((m) => m.groupCommand),
+    library: () => import("./library-OLXEGJ73.js").then((m) => m.libraryCommand),
+    find: () => import("./find-5FCDTFYC.js").then((m) => m.findCommand),
+    stock: () => import("./stock-TAKWC3YI.js").then((m) => m.stockCommand),
+    google: () => import("./google-3BO7KNZ6.js").then((m) => m.googleCommand),
+    pinterest: () => import("./pinterest-PONS4KLN.js").then((m) => m.pinterestCommand),
+    logo: () => import("./logo-4MGGQHQ7.js").then((m) => m.logoCommand),
+    icon: () => import("./icon-XHPEVICH.js").then((m) => m.iconCommand),
+    meme: () => import("./meme-LVRZR7XL.js").then((m) => m.memeCommand),
+    gif: () => import("./gif-2D6UXHP5.js").then((m) => m.gifCommand),
+    sticker: () => import("./sticker-CJ6Y36AO.js").then((m) => m.stickerCommand),
+    extract: () => import("./extract-55YRHNCV.js").then((m) => m.extractCommand),
+    screenshot: () => import("./screenshot-CREF7FB4.js").then((m) => m.screenshotCommand),
+    ingest: () => import("./ingest-XLRFEWZX.js").then((m) => m.ingestCommand),
+    use: () => import("./use-J3TZJZ4M.js").then((m) => m.useCommand),
+    search: () => import("./search-7343MBTZ.js").then((m) => m.searchCommand),
+    upload: () => import("./upload-5237F4WV.js").then((m) => m.uploadCommand),
+    delete: () => import("./delete-GPTU4DJ5.js").then((m) => m.deleteCommand),
+    retry: () => import("./retry-42COPYFE.js").then((m) => m.retryCommand),
+    describe: () => import("./describe-DUPBGFKA.js").then((m) => m.describeCommand),
+    download: () => import("./download-NNDBNAVZ.js").then((m) => m.downloadCommand),
+    normalize: () => import("./normalize-BREMV3IB.js").then((m) => m.normalizeCommand),
+    crop: () => import("./crop-NBVWWXF2.js").then((m) => m.cropCommand),
+    dimensions: () => import("./dimensions-M4LMNCBV.js").then((m) => m.dimensionsCommand),
+    layerize: () => import("./layerize-M5XLTCO4.js").then((m) => m.layerizeCommand),
+    layers: () => import("./layerize-M5XLTCO4.js").then((m) => m.layersCommand),
+    upscale: () => import("./upscale-KLMXV6JG.js").then((m) => m.upscaleCommand),
+    tags: () => import("./tags-UTICOZ4V.js").then((m) => m.tagsCommand)
+  }
+});
+export {
+  imagesCommand
+};
+//# sourceMappingURL=images-TJGUKE2W.js.map

package/dist/ingest-E74SWVT6.js

@@ -0,0 +1,24 @@
+import {
+  ingestCommand,
+  ingestHints,
+  runVideoIngest
+} from "./chunk-I2CLKSKS.js";
+import "./chunk-FKOECEVC.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-7D7YRHN3.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  ingestCommand,
+  ingestHints,
+  runVideoIngest
+};
+//# sourceMappingURL=ingest-E74SWVT6.js.map

package/dist/ingest-XLRFEWZX.js

@@ -0,0 +1,108 @@
+import {
+  imageSourceSchema
+} from "./chunk-7D7YRHN3.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/ingest.ts
+import { defineCommand } from "citty";
+var SOURCE_VALUES = imageSourceSchema.options.join(" | ");
+registerSchema({
+  command: "images.ingest",
+  description: "Ingest a remote image URL into the library (full describe + embed).",
+  args: {
+    url: { type: "string", description: "Image URL to ingest", required: true },
+    source: { type: "string", description: `Where the image came from. One of: ${SOURCE_VALUES}`, required: true },
+    "external-id": { type: "string", description: "Provider asset id", required: false },
+    "external-url": { type: "string", description: "Canonical page URL", required: false },
+    context: { type: "string", description: "Description context hint", 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 }
+  }
+});
+var ingestCommand = defineCommand({
+  meta: {
+    name: "ingest",
+    description: "Download a remote URL and store it in the library. Hash-deduped on bytes + externalId.\n\nExample: baker images ingest https://images.pexels.com/photos/13219418/pexels-photo-13219418.jpeg --source pexels --external-id 13219418"
+  },
+  args: {
+    url: { type: "positional", description: "Image URL", required: false },
+    source: { type: "string", description: `Where the image came from. One of: ${SOURCE_VALUES}`, required: false },
+    "external-id": { type: "string", description: "Provider asset id", required: false },
+    "external-url": { type: "string", description: "Canonical page URL", required: false },
+    context: { type: "string", description: "Description context", 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 }
+  },
+  run: async ({ args }) => {
+    try {
+      const url = args.url;
+      const source = args.source;
+      if (!url) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "URL is required" } });
+        process.exit(1);
+      }
+      if (!source) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: "--source is required",
+            fix: `Pass one of: ${SOURCE_VALUES}. Use "website" for an asset pulled off a company's own site.`
+          }
+        });
+        process.exit(1);
+      }
+      const parsedSource = imageSourceSchema.safeParse(source);
+      if (!parsedSource.success) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: `--source "${source}" is not a known image source`,
+            fix: `Pass one of: ${SOURCE_VALUES}. Use "website" for an asset pulled off a company's own site.`
+          }
+        });
+        process.exit(1);
+      }
+      const body = { url, source: parsedSource.data };
+      if (args["external-id"]) body.externalId = args["external-id"];
+      if (args["external-url"]) body.externalUrl = args["external-url"];
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/ingest", body);
+      writeOutput(
+        { ok: true, data },
+        args.output || "json",
+        args.fields ? args.fields.split(",") : void 0,
+        false,
+        (record) => record
+      );
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  ingestCommand
+};
+//# sourceMappingURL=ingest-XLRFEWZX.js.map

package/dist/insights-DYCUSIPZ.js

@@ -0,0 +1,130 @@
+import {
+  CHATGPT_ADS_GRANULARITIES,
+  CHATGPT_ADS_LEVELS,
+  CHATGPT_ADS_METRICS,
+  CHATGPT_ADS_REFERENCE,
+  CHATGPT_ADS_SEGMENTS,
+  chatgptAdsInsightsRequestSchema,
+  insightsRequestFromArgs,
+  runChatgptRead
+} from "./chunk-URBN6DXM.js";
+import {
+  syncedFirstHint
+} from "./chunk-Y2FAUFWK.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/insights.ts
+import { defineCommand } from "citty";
+var args = {
+  level: {
+    type: "string",
+    description: `What one row is: ${CHATGPT_ADS_LEVELS.join("|")} (default campaign)`,
+    required: false
+  },
+  "campaign-id": { type: "string", description: "Report on one campaign (cmpn_\u2026)", required: false },
+  "ad-group-id": { type: "string", description: "Report on one ad group (adgrp_\u2026)", required: false },
+  "ad-id": { type: "string", description: "Report on one ad (ad_\u2026)", required: false },
+  days: {
+    type: "string",
+    description: "Last N complete days, ending the account's yesterday (default 7)",
+    required: false
+  },
+  since: {
+    type: "string",
+    description: "First day, YYYY-MM-DD, account timezone (instead of --days)",
+    required: false
+  },
+  until: { type: "string", description: "Last day, inclusive, YYYY-MM-DD", required: false },
+  granularity: {
+    type: "string",
+    description: `${CHATGPT_ADS_GRANULARITIES.join("|")} (default none: one total per row)`,
+    required: false
+  },
+  segment: {
+    type: "string",
+    description: `Break rows down by one of ${CHATGPT_ADS_SEGMENTS.join("|")}`,
+    required: false
+  },
+  metrics: {
+    type: "string",
+    description: `CSV of ${CHATGPT_ADS_METRICS.join(",")} (default impressions,clicks,spend,ctr,cpc,conversions,cpa)`,
+    required: false
+  },
+  sort: { type: "string", description: "Metric to rank rows by, highest first", required: false },
+  limit: { type: "string", description: "Rows, 1-2000 (default 200)", required: false }
+};
+registerSchema({
+  command: "ads.chatgpt.insights",
+  description: "Performance of the connected ChatGPT Ads account: impressions, clicks, spend, CTR, CPC, CPM, conversions, CPA, attributed sales and ROAS, per account, campaign, ad group or ad, over a window, optionally per day and broken down by country, device, platform or product. Spend and costs are in the account currency; null means not reported, not zero.",
+  args
+});
+function insightsHints(report) {
+  const hints = [];
+  if (report.rows.length === 0) {
+    hints.push(
+      "No delivery in this window. Check `baker ads chatgpt campaigns` for serving issues before concluding the ads do not work."
+    );
+  }
+  if (report.truncated) {
+    hints.push("More rows matched than --limit allowed. Narrow the report or raise --limit (max 2000).");
+  }
+  hints.push(
+    "Conversions come from ChatGPT Ads' own pixel or Conversions API and take at least a day to appear; the most recent days are still filling in."
+  );
+  return hints;
+}
+function chatgptInsightsHints(report, request) {
+  const hints = insightsHints(report);
+  return request.segment ? hints : [...hints, syncedFirstHint("chatgpt", request.level)];
+}
+var insightsCommand = defineCommand({
+  meta: {
+    name: "insights",
+    description: `How a ChatGPT Ads account performs. Start here for "how are the ChatGPT campaigns doing".
+
+Examples:
+  baker ads chatgpt insights                                          # last 7 days, one row per campaign
+  baker ads chatgpt insights --days 30 --granularity daily --level account
+  baker ads chatgpt insights --campaign-id cmpn_123 --level ad --sort spend
+  baker ads chatgpt insights --segment country --metrics spend,clicks,conversions
+  baker ads chatgpt insights --since 2026-09-01 --until 2026-09-07 --metrics spend,order_created_roas`
+  },
+  args,
+  run: async ({ args: input }) => {
+    const parsed = chatgptAdsInsightsRequestSchema.safeParse(insightsRequestFromArgs(input));
+    if (!parsed.success) {
+      const message = parsed.error.issues[0]?.message ?? "Invalid report request";
+      writeJsonEnvelope({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message,
+          fix: { action: "retry_with_modified_query", explanation: message },
+          retryable: false
+        }
+      });
+      process.exit(1);
+    }
+    await runChatgptRead(
+      CHATGPT_ADS_REFERENCE.insights,
+      () => apiPost("/api/ads/chatgpt/insights", parsed.data),
+      (report) => chatgptInsightsHints(report, parsed.data)
+    );
+  }
+});
+export {
+  chatgptInsightsHints,
+  insightsCommand
+};
+//# sourceMappingURL=insights-DYCUSIPZ.js.map