@koda-sl/baker-cli 0.476.0 → 0.481.0-dev.2d33e194f

package/dist/icon-BMCDFGMN.js

@@ -0,0 +1,137 @@
+import {
+  brandVerificationHints
+} from "./chunk-IVIJJXXT.js";
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-ZBKBTTHD.js";
+import {
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.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-BMCDFGMN.js.map

package/dist/ideas-7UQMXLI5.js

@@ -0,0 +1,32 @@
+import {
+  buildNext,
+  compactIdea,
+  ideasCommand,
+  ideasHints,
+  ideasReport
+} from "./chunk-WESRVXFS.js";
+import "./chunk-ZLU5QDLU.js";
+import "./chunk-D5MF337I.js";
+import "./chunk-VHMNSO2B.js";
+import "./chunk-65BQAJMH.js";
+import "./chunk-6GFJFTG6.js";
+import "./chunk-NAMEFVWL.js";
+import "./chunk-GT4UFORX.js";
+import "./chunk-CECS3DHZ.js";
+import "./chunk-OI7KSXZM.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  buildNext,
+  compactIdea,
+  ideasCommand,
+  ideasHints,
+  ideasReport
+};
+//# sourceMappingURL=ideas-7UQMXLI5.js.map

package/dist/images-OFR3S2U4.js

@@ -0,0 +1,90 @@
+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 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-FJB3X44Z.js").then((m) => m.getCommand),
+    group: () => import("./group-TZJCKHKS.js").then((m) => m.groupCommand),
+    library: () => import("./library-RPFXNER4.js").then((m) => m.libraryCommand),
+    find: () => import("./find-Y22AANDE.js").then((m) => m.findCommand),
+    stock: () => import("./stock-B7LKMKUK.js").then((m) => m.stockCommand),
+    google: () => import("./google-XRAMIES5.js").then((m) => m.googleCommand),
+    pinterest: () => import("./pinterest-UETS7U7U.js").then((m) => m.pinterestCommand),
+    logo: () => import("./logo-4JOWGJ5A.js").then((m) => m.logoCommand),
+    icon: () => import("./icon-BMCDFGMN.js").then((m) => m.iconCommand),
+    gif: () => import("./gif-SFYVDLCU.js").then((m) => m.gifCommand),
+    sticker: () => import("./sticker-MC2IAIQB.js").then((m) => m.stickerCommand),
+    extract: () => import("./extract-OQP3TSQG.js").then((m) => m.extractCommand),
+    screenshot: () => import("./screenshot-XFAYY4WW.js").then((m) => m.screenshotCommand),
+    ingest: () => import("./ingest-HGR7KSG4.js").then((m) => m.ingestCommand),
+    use: () => import("./use-MHPNS4V4.js").then((m) => m.useCommand),
+    search: () => import("./search-D2IV7KFJ.js").then((m) => m.searchCommand),
+    upload: () => import("./upload-NA62W5RS.js").then((m) => m.uploadCommand),
+    delete: () => import("./delete-ZGBBWFAW.js").then((m) => m.deleteCommand),
+    retry: () => import("./retry-WRBGLB7O.js").then((m) => m.retryCommand),
+    describe: () => import("./describe-FCTM53MM.js").then((m) => m.describeCommand),
+    download: () => import("./download-IE6XLFHM.js").then((m) => m.downloadCommand),
+    normalize: () => import("./normalize-P5Q3F7FU.js").then((m) => m.normalizeCommand),
+    crop: () => import("./crop-3ZV5BFCA.js").then((m) => m.cropCommand),
+    dimensions: () => import("./dimensions-AD4VS5AH.js").then((m) => m.dimensionsCommand),
+    layerize: () => import("./layerize-U672AXED.js").then((m) => m.layerizeCommand),
+    layers: () => import("./layerize-U672AXED.js").then((m) => m.layersCommand),
+    upscale: () => import("./upscale-RXJUBHXN.js").then((m) => m.upscaleCommand),
+    tags: () => import("./tags-EB4RE3ML.js").then((m) => m.tagsCommand)
+  }
+});
+export {
+  imagesCommand
+};
+//# sourceMappingURL=images-OFR3S2U4.js.map

package/dist/improve-P6F2HXYQ.js

@@ -0,0 +1,86 @@
+import {
+  failStudioCommand
+} from "./chunk-VFSLIDXA.js";
+import {
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/improve.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = "Sharpen a rough brief into directed art direction \u2014 the same rewrite the client gets from the wand in the Studio prompt bar. Reach for it when you are relaying the CLIENT's own words and want them shaped without substituting your voice; when you are writing the art direction yourself, just write it, because you will do a better job than this does.";
+registerSchema({
+  command: "studio.improve",
+  description: DESCRIPTION,
+  args: {
+    prompt: { type: "string", description: "The rough brief to sharpen", required: true },
+    kind: {
+      type: "string",
+      description: "image (default) sharpens a still brief; video sharpens a MOTION brief",
+      required: false,
+      enum: ["image", "video"]
+    },
+    skill: {
+      type: "string",
+      description: "Sharpen it for a specific craft direction (`baker studio skills`)",
+      required: false
+    },
+    "has-reference": {
+      type: "boolean",
+      description: "Tell it a reference image is wired, so it describes the CHANGE rather than the whole scene",
+      required: false
+    }
+  }
+});
+var improveCommand = defineCommand({
+  meta: {
+    name: "improve",
+    description: `${DESCRIPTION}
+
+Both the rewrite and the original come back, so you can show the client what changed rather than silently replacing their words. Nothing is generated \u2014 feed the result to \`baker studio generate\` yourself.
+
+Examples:
+  baker studio improve 'make it look premium'
+  baker studio improve 'zoom in a bit' --kind video --has-reference`
+  },
+  args: {
+    prompt: { type: "positional", description: "The rough brief to sharpen", required: false },
+    kind: { type: "string", description: "image (default) | video", required: false },
+    skill: { type: "string", description: "Craft direction id", required: false },
+    "has-reference": { type: "boolean", description: "A reference image is wired", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const prompt = args.prompt;
+      if (!prompt) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "A prompt is required" } });
+        process.exit(1);
+      }
+      const body = { prompt };
+      if (args.kind === "video") body.kind = "video";
+      if (args.skill) body.skillId = args.skill;
+      if (args["has-reference"]) body.hasReference = true;
+      const data = await apiPost("/api/studio/improve", body);
+      writeJson({
+        ok: true,
+        data,
+        hints: [
+          "Nothing was generated. Pass the sharpened text to `baker studio generate` when you are happy with it.",
+          ...data.prompt === data.original ? ["It came back unchanged \u2014 the brief was already specific enough."] : []
+        ]
+      });
+    } catch (error) {
+      failStudioCommand(error);
+    }
+  }
+});
+export {
+  improveCommand
+};
+//# sourceMappingURL=improve-P6F2HXYQ.js.map

package/dist/ingest-HGR7KSG4.js

@@ -0,0 +1,107 @@
+import {
+  imageSourceSchema
+} from "./chunk-OI7KSXZM.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-4DM6OAQ6.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-HGR7KSG4.js.map

package/dist/ingest-XU4WXE4U.js

@@ -0,0 +1,23 @@
+import {
+  ingestCommand,
+  ingestHints,
+  runVideoIngest
+} from "./chunk-QHIUJXU7.js";
+import "./chunk-FKOECEVC.js";
+import "./chunk-GT4UFORX.js";
+import "./chunk-OI7KSXZM.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  ingestCommand,
+  ingestHints,
+  runVideoIngest
+};
+//# sourceMappingURL=ingest-XU4WXE4U.js.map

package/dist/insights-7SI2TB72.js

@@ -0,0 +1,128 @@
+import {
+  CHATGPT_ADS_GRANULARITIES,
+  CHATGPT_ADS_LEVELS,
+  CHATGPT_ADS_METRICS,
+  CHATGPT_ADS_REFERENCE,
+  CHATGPT_ADS_SEGMENTS,
+  chatgptAdsInsightsRequestSchema,
+  insightsRequestFromArgs,
+  runChatgptRead
+} from "./chunk-FO5EP6DA.js";
+import {
+  syncedFirstHint
+} from "./chunk-OO67YTPM.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-LHNL6JM2.js";
+import {
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema
+} from "./chunk-4DM6OAQ6.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;
+}
+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) => [
+        ...insightsHints(report),
+        syncedFirstHint("chatgpt", parsed.data.segment ? "breakdown" : parsed.data.level)
+      ]
+    );
+  }
+});
+export {
+  insightsCommand
+};
+//# sourceMappingURL=insights-7SI2TB72.js.map

package/dist/insights-7SI2TB72.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/insights.ts"],"sourcesContent":["import {\n  CHATGPT_ADS_GRANULARITIES,\n  CHATGPT_ADS_LEVELS,\n  CHATGPT_ADS_METRICS,\n  CHATGPT_ADS_SEGMENTS,\n  type ChatgptAdsInsightsResponse,\n  chatgptAdsInsightsRequestSchema,\n} from \"@baker/api/ads-chatgpt\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { syncedFirstHint } from \"../synced-first.ts\";\nimport { CHATGPT_ADS_REFERENCE, insightsRequestFromArgs, runChatgptRead } from \"./shared.ts\";\n\nconst args = {\n  level: {\n    type: \"string\",\n    description: `What one row is: ${CHATGPT_ADS_LEVELS.join(\"|\")} (default campaign)`,\n    required: false,\n  },\n  \"campaign-id\": { type: \"string\", description: \"Report on one campaign (cmpn_…)\", required: false },\n  \"ad-group-id\": { type: \"string\", description: \"Report on one ad group (adgrp_…)\", required: false },\n  \"ad-id\": { type: \"string\", description: \"Report on one ad (ad_…)\", required: false },\n  days: {\n    type: \"string\",\n    description: \"Last N complete days, ending the account's yesterday (default 7)\",\n    required: false,\n  },\n  since: {\n    type: \"string\",\n    description: \"First day, YYYY-MM-DD, account timezone (instead of --days)\",\n    required: false,\n  },\n  until: { type: \"string\", description: \"Last day, inclusive, YYYY-MM-DD\", required: false },\n  granularity: {\n    type: \"string\",\n    description: `${CHATGPT_ADS_GRANULARITIES.join(\"|\")} (default none: one total per row)`,\n    required: false,\n  },\n  segment: {\n    type: \"string\",\n    description: `Break rows down by one of ${CHATGPT_ADS_SEGMENTS.join(\"|\")}`,\n    required: false,\n  },\n  metrics: {\n    type: \"string\",\n    description: `CSV of ${CHATGPT_ADS_METRICS.join(\",\")} (default impressions,clicks,spend,ctr,cpc,conversions,cpa)`,\n    required: false,\n  },\n  sort: { type: \"string\", description: \"Metric to rank rows by, highest first\", required: false },\n  limit: { type: \"string\", description: \"Rows, 1-2000 (default 200)\", required: false },\n} as const;\n\nregisterSchema({\n  command: \"ads.chatgpt.insights\",\n  description:\n    \"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.\",\n  args,\n});\n\nfunction insightsHints(report: ChatgptAdsInsightsResponse): string[] {\n  const hints: string[] = [];\n  if (report.rows.length === 0) {\n    hints.push(\n      \"No delivery in this window. Check `baker ads chatgpt campaigns` for serving issues before concluding the ads do not work.\",\n    );\n  }\n  if (report.truncated) {\n    hints.push(\"More rows matched than --limit allowed. Narrow the report or raise --limit (max 2000).\");\n  }\n  hints.push(\n    \"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.\",\n  );\n  return hints;\n}\n\nexport const insightsCommand = defineCommand({\n  meta: {\n    name: \"insights\",\n    description: `How a ChatGPT Ads account performs. Start here for \"how are the ChatGPT campaigns doing\".\n\nExamples:\n  baker ads chatgpt insights                                          # last 7 days, one row per campaign\n  baker ads chatgpt insights --days 30 --granularity daily --level account\n  baker ads chatgpt insights --campaign-id cmpn_123 --level ad --sort spend\n  baker ads chatgpt insights --segment country --metrics spend,clicks,conversions\n  baker ads chatgpt insights --since 2026-09-01 --until 2026-09-07 --metrics spend,order_created_roas`,\n  },\n  args,\n  run: async ({ args: input }) => {\n    const parsed = chatgptAdsInsightsRequestSchema.safeParse(insightsRequestFromArgs(input));\n    if (!parsed.success) {\n      const message = parsed.error.issues[0]?.message ?? \"Invalid report request\";\n      writeJsonEnvelope({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message,\n          fix: { action: \"retry_with_modified_query\", explanation: message },\n          retryable: false,\n        },\n      });\n      process.exit(1);\n    }\n    await runChatgptRead(\n      CHATGPT_ADS_REFERENCE.insights,\n      () => apiPost<ChatgptAdsInsightsResponse>(\"/api/ads/chatgpt/insights\", parsed.data),\n      (report) => [\n        ...insightsHints(report),\n        syncedFirstHint(\"chatgpt\", parsed.data.segment ? \"breakdown\" : parsed.data.level),\n      ],\n    );\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,SAAS,qBAAqB;AAO9B,IAAM,OAAO;AAAA,EACX,OAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa,oBAAoB,mBAAmB,KAAK,GAAG,CAAC;AAAA,IAC7D,UAAU;AAAA,EACZ;AAAA,EACA,eAAe,EAAE,MAAM,UAAU,aAAa,wCAAmC,UAAU,MAAM;AAAA,EACjG,eAAe,EAAE,MAAM,UAAU,aAAa,yCAAoC,UAAU,MAAM;AAAA,EAClG,SAAS,EAAE,MAAM,UAAU,aAAa,gCAA2B,UAAU,MAAM;AAAA,EACnF,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,OAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,OAAO,EAAE,MAAM,UAAU,aAAa,mCAAmC,UAAU,MAAM;AAAA,EACzF,aAAa;AAAA,IACX,MAAM;AAAA,IACN,aAAa,GAAG,0BAA0B,KAAK,GAAG,CAAC;AAAA,IACnD,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa,6BAA6B,qBAAqB,KAAK,GAAG,CAAC;AAAA,IACxE,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa,UAAU,oBAAoB,KAAK,GAAG,CAAC;AAAA,IACpD,UAAU;AAAA,EACZ;AAAA,EACA,MAAM,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,EAC9F,OAAO,EAAE,MAAM,UAAU,aAAa,8BAA8B,UAAU,MAAM;AACtF;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF;AACF,CAAC;AAED,SAAS,cAAc,QAA8C;AACnE,QAAM,QAAkB,CAAC;AACzB,MAAI,OAAO,KAAK,WAAW,GAAG;AAC5B,UAAM;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AACA,MAAI,OAAO,WAAW;AACpB,UAAM,KAAK,wFAAwF;AAAA,EACrG;AACA,QAAM;AAAA,IACJ;AAAA,EACF;AACA,SAAO;AACT;AAEO,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQf;AAAA,EACA;AAAA,EACA,KAAK,OAAO,EAAE,MAAM,MAAM,MAAM;AAC9B,UAAM,SAAS,gCAAgC,UAAU,wBAAwB,KAAK,CAAC;AACvF,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,UAAU,OAAO,MAAM,OAAO,CAAC,GAAG,WAAW;AACnD,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ,OAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA,KAAK,EAAE,QAAQ,6BAA6B,aAAa,QAAQ;AAAA,UACjE,WAAW;AAAA,QACb;AAAA,MACF,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,UAAM;AAAA,MACJ,sBAAsB;AAAA,MACtB,MAAM,QAAoC,6BAA6B,OAAO,IAAI;AAAA,MAClF,CAAC,WAAW;AAAA,QACV,GAAG,cAAc,MAAM;AAAA,QACvB,gBAAgB,WAAW,OAAO,KAAK,UAAU,cAAc,OAAO,KAAK,KAAK;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AACF,CAAC;","names":[]}