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

package/dist/add-accounts-M5Y4DQFM.js

@@ -0,0 +1,91 @@
+import {
+  PLATFORM_NAMES,
+  reportError,
+  splitList
+} from "./chunk-G3KO2HFZ.js";
+import {
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  BRAND_ACCOUNTS_MAX,
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/add-accounts.ts
+import { defineCommand } from "citty";
+var ADD_TIMEOUT_MS = 12e4;
+var named = (accounts) => accounts.map((a) => `${a.name} (${PLATFORM_NAMES[a.platform]})`).join(", ");
+function addAccountsHints(data) {
+  const hints = [];
+  if (data.added.length > 0) {
+    hints.push(
+      `Now tracking ${named(data.added)} \u2014 its ads arrive over the next minutes; check \`baker winning-ads following\`.`
+    );
+  }
+  if (data.already_tracked.length > 0) {
+    hints.push(`Already tracked under this brand: ${named(data.already_tracked)}.`);
+  }
+  for (const failure of data.failed) {
+    hints.push(`Not added: "${failure.input}" \u2014 ${failure.error}`);
+  }
+  return hints;
+}
+registerSchema({
+  command: "winning-ads.add-accounts",
+  description: "Track more accounts under a brand you already follow \u2014 another country's or language's Facebook page, a second LinkedIn company, another Google Ads entity. Pass the brand's advertiser id and one or more links (comma-separated): profile or ad-library links, Google advertiser ids (AR\u2026), or a website. `follow` returns ready-made calls for the look-alike accounts it found.",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id of a followed brand (from `following`)", required: true },
+    inputs: {
+      type: "string",
+      description: `Comma-separated links, advertiser ids or websites \u2014 up to ${BRAND_ACCOUNTS_MAX}`,
+      required: true
+    }
+  }
+});
+var addAccountsCommand = defineCommand({
+  meta: {
+    name: "add-accounts",
+    description: `Add more of a followed brand's accounts (another market's Facebook page, a second LinkedIn company). Example: baker winning-ads add-accounts adv_123 "https://www.facebook.com/barkibu.it,AR01614014350098432001"`
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id of a followed brand", required: true },
+    inputs: {
+      type: "positional",
+      description: "Comma-separated links, advertiser ids or websites",
+      required: true
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const inputs = [...new Set(splitList(String(args.inputs ?? "")))];
+      if (inputs.length === 0 || inputs.length > BRAND_ACCOUNTS_MAX) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: `Pass between 1 and ${BRAND_ACCOUNTS_MAX} comma-separated links.`
+          }
+        });
+        process.exit(1);
+      }
+      const data = await apiPost(
+        "/api/ad-library/accounts/add",
+        { advertiser_id: String(args.advertiser), inputs },
+        { timeoutMs: ADD_TIMEOUT_MS }
+      );
+      const hints = addAccountsHints(data);
+      writeJson({ ok: true, data, hints: hints.length > 0 ? hints : void 0 });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addAccountsCommand,
+  addAccountsHints
+};
+//# sourceMappingURL=add-accounts-M5Y4DQFM.js.map

package/dist/ads-DB5NDHX5.js

@@ -0,0 +1,128 @@
+import {
+  adFieldPlan,
+  adRows
+} from "./chunk-QTL4NJ5I.js";
+import {
+  reportError
+} from "./chunk-G3KO2HFZ.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  advertiserAdsRequestSchema,
+  registerSchema,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/ads.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.ads",
+  description: "Every ad one advertiser has run (one row per distinct ad, strongest first), on every platform or one, running, stopped or both, of every format or the ones in --format (`--platform google --format text`: its Google search ads). The brand page's All ads; `winners` is its top winners. Pages with --offset; `next_offset` is null on the last page. Rows are compact; --fields ad_id,summary,days_active,active keeps a long listing small.",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id (from `advertisers` or `following`)", required: true },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    running: { type: "string", description: "all|running|stopped (default all)", required: false, default: "all" },
+    format: {
+      type: "string",
+      description: "Comma list: video,static,carousel,text (text = Google search ads); every format when omitted",
+      required: false
+    },
+    limit: { type: "number", description: "Ads per page 1-100 (default 24)", required: false, default: 24 },
+    offset: { type: "number", description: "Skip this many ads (from `next_offset`)", required: false, default: 0 },
+    full: { type: "boolean", description: "Include DNA detail + longevity", required: false, default: false }
+  }
+});
+function nextOffset(page, offset) {
+  const reached = offset + page.returned;
+  if (page.returned === 0) return null;
+  if (page.total === null) return page.returned === page.limit ? reached : null;
+  return reached < page.total ? reached : null;
+}
+function adsHints(request, returned, next) {
+  if (next !== null) return [`More ads: run again with --offset ${next}.`];
+  if (returned === 0 && request.offset === 0 && request.running === "running") {
+    return [
+      `No ad counts as running unless the brand was checked in the last 35 days: read last_checked_at in \`baker winning-ads profile ${request.id}\` before saying it runs nothing.`
+    ];
+  }
+  return [];
+}
+var adsCommand = defineCommand({
+  meta: {
+    name: "ads",
+    description: "Every ad an advertiser has run, per platform and format or all together. Example: baker winning-ads ads adv_123 --platform google --format text --running running --output md"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id", required: true },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    running: { type: "string", description: "all|running|stopped (default all)", required: false },
+    format: { type: "string", description: "Comma list: video,static,carousel,text", required: false },
+    limit: { type: "string", description: "Ads per page 1-100 (default 24)", required: false },
+    offset: { type: "string", description: "Skip this many ads (from next_offset)", 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 DNA detail + longevity", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const parsed = advertiserAdsRequestSchema.safeParse({
+        id: String(args.advertiser),
+        platform: args.platform || void 0,
+        running: args.running || void 0,
+        format: args.format || void 0,
+        limit: args.limit || void 0,
+        offset: args.offset || void 0
+      });
+      if (!parsed.success) {
+        const issue = parsed.error.issues[0];
+        writeJson({
+          ok: false,
+          error: { code: "BAD_REQUEST", message: `--${issue?.path.join(".") ?? "args"}: ${issue?.message}` }
+        });
+        process.exit(1);
+      }
+      const request = parsed.data;
+      const params = {
+        id: request.id,
+        running: request.running,
+        limit: String(request.limit),
+        offset: String(request.offset)
+      };
+      if (request.platform) params.platform = request.platform;
+      if (request.format) params.format = request.format.join(",");
+      const data = await apiGet("/api/ad-library/advertiser-ads", params);
+      const plan = adFieldPlan(args.fields, args.full);
+      const next = nextOffset({ returned: data.ads.length, total: data.total, limit: request.limit }, request.offset);
+      const hints = adsHints(request, data.ads.length, next);
+      const output = args.output || "json";
+      if (output === "json") {
+        writeJson({
+          ok: true,
+          data: {
+            advertiser_id: data.advertiser_id,
+            total: data.total,
+            next_offset: next,
+            ads: adRows(data.ads, plan)
+          },
+          ...hints.length > 0 ? { hints } : {}
+        });
+        return;
+      }
+      writeOutput({ ok: true, data: data.ads }, output, plan.fields, plan.full, winningAdNormalizer);
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  adsCommand,
+  adsHints,
+  nextOffset
+};
+//# sourceMappingURL=ads-DB5NDHX5.js.map

package/dist/ads-J2F7BSHR.js

@@ -0,0 +1,45 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/index.ts
+import { defineCommand } from "citty";
+var adsCommand = defineCommand({
+  meta: {
+    name: "ads",
+    description: `Ad platform commands. Each platform exposes its own native command surface \u2014 no forced parity.
+
+Platforms:
+  google    \u2014 Google Ads (GAQL queries, keywords, accounts, ad library)
+  meta      \u2014 Meta Ads (campaigns, adsets, ads, insights, previews)
+  linkedin  \u2014 LinkedIn Ads (firmographic analytics \u2014 job-title \xD7 company \xD7 industry \xD7 seniority pivots)
+  x         \u2014 X (Twitter) Ads (campaigns, line items, promoted tweets, analytics)
+  chatgpt   \u2014 ChatGPT Ads (account, campaigns, ad groups, ads, insights \u2014 read-only)
+
+Across platforms:
+  performance \u2014 Baker's stored copy of every connected platform's results, changes and alerts (no platform call). Start here for "how are the ads doing".
+
+Examples:
+  baker ads performance overview
+  baker ads google accounts
+  baker ads google query --preset campaign-performance --customer-id 1234567890
+  baker ads meta accounts
+  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE
+  baker ads meta insights --object act_123 --level ad --date-preset last_7d --fields impressions,spend,ctr
+  baker ads linkedin accounts
+  baker ads x accounts
+  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
+  baker ads chatgpt insights --days 30 --granularity daily
+Full guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedin|x|chatgpt|performance)`
+  },
+  subCommands: {
+    google: () => import("./google-THWFDDHJ.js").then((m) => m.googleCommand),
+    meta: () => import("./meta-RBHF2RG3.js").then((m) => m.metaCommand),
+    linkedin: () => import("./linkedin-EZJJBKY3.js").then((m) => m.linkedinCommand),
+    x: () => import("./x-VNRVGVLI.js").then((m) => m.xCommand),
+    chatgpt: () => import("./chatgpt-3NS2R442.js").then((m) => m.chatgptCommand),
+    performance: () => import("./performance-VYEANYQ5.js").then((m) => m.performanceCommand)
+  }
+});
+export {
+  adsCommand
+};
+//# sourceMappingURL=ads-J2F7BSHR.js.map

package/dist/ads-J2F7BSHR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\nexport const adsCommand = defineCommand({\n  meta: {\n    name: \"ads\",\n    description: `Ad platform commands. Each platform exposes its own native command surface — no forced parity.\n\nPlatforms:\n  google    — Google Ads (GAQL queries, keywords, accounts, ad library)\n  meta      — Meta Ads (campaigns, adsets, ads, insights, previews)\n  linkedin  — LinkedIn Ads (firmographic analytics — job-title × company × industry × seniority pivots)\n  x         — X (Twitter) Ads (campaigns, line items, promoted tweets, analytics)\n  chatgpt   — ChatGPT Ads (account, campaigns, ad groups, ads, insights — read-only)\n\nAcross platforms:\n  performance — Baker's stored copy of every connected platform's results, changes and alerts (no platform call). Start here for \"how are the ads doing\".\n\nExamples:\n  baker ads performance overview\n  baker ads google accounts\n  baker ads google query --preset campaign-performance --customer-id 1234567890\n  baker ads meta accounts\n  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE\n  baker ads meta insights --object act_123 --level ad --date-preset last_7d --fields impressions,spend,ctr\n  baker ads linkedin accounts\n  baker ads x accounts\n  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def\n  baker ads chatgpt insights --days 30 --granularity daily\nFull guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedin|x|chatgpt|performance)`,\n  },\n  subCommands: {\n    google: () => import(\"./google/index.ts\").then((m) => m.googleCommand),\n    meta: () => import(\"./meta/index.ts\").then((m) => m.metaCommand),\n    linkedin: () => import(\"./linkedin/index.ts\").then((m) => m.linkedinCommand),\n    x: () => import(\"./x/index.ts\").then((m) => m.xCommand),\n    chatgpt: () => import(\"./chatgpt/index.ts\").then((m) => m.chatgptCommand),\n    performance: () => import(\"./performance/index.ts\").then((m) => m.performanceCommand),\n  },\n});\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAEvB,IAAM,aAAa,cAAc;AAAA,EACtC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBf;AAAA,EACA,aAAa;AAAA,IACX,QAAQ,MAAM,OAAO,sBAAmB,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,IACrE,MAAM,MAAM,OAAO,oBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW;AAAA,IAC/D,UAAU,MAAM,OAAO,wBAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IAC3E,GAAG,MAAM,OAAO,iBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ;AAAA,IACtD,SAAS,MAAM,OAAO,uBAAoB,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IACxE,aAAa,MAAM,OAAO,2BAAwB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB;AAAA,EACtF;AACF,CAAC;","names":[]}

package/dist/ads-LYNA2I7B.js

@@ -0,0 +1,77 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-FO5EP6DA.js";
+import "./chunk-LHNL6JM2.js";
+import "./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/ads.ts
+import { defineCommand } from "citty";
+var args = {
+  "ad-group-id": { type: "string", description: "Only this ad group's ads (adgrp_\u2026)", required: false },
+  full: { type: "boolean", description: "Return ChatGPT Ads' own ad objects", required: false }
+};
+registerSchema({
+  command: "ads.chatgpt.ads",
+  description: "Ads in the connected ChatGPT Ads account, or in one ad group: the card's title, body, image and destination, its review outcome and reason, and serving issues.",
+  args
+});
+function adHints(ads) {
+  const rejected = ads.filter((ad) => ad.review === "rejected");
+  return rejected.length > 0 ? [
+    `${rejected.length} ad(s) were rejected in review; reviewReason says why. Editing the creative sends it back to review.`
+  ] : [];
+}
+var adsListCommand = defineCommand({
+  meta: { name: "list", description: "ChatGPT Ads chat cards. Example: baker ads chatgpt ads --ad-group-id adgrp_123" },
+  args,
+  run: async ({ args: input }) => {
+    const params = {};
+    if (input["ad-group-id"]) {
+      params["ad-group-id"] = input["ad-group-id"];
+    }
+    if (input.full) {
+      params.full = "true";
+    }
+    await runChatgptListRead(
+      CHATGPT_ADS_REFERENCE.ads,
+      "/api/ads/chatgpt/ads",
+      params,
+      (ads) => input.full ? [] : adHints(ads)
+    );
+  }
+});
+var adsCommand = defineCommand({
+  meta: {
+    name: "ads",
+    description: `ChatGPT Ads ads (chat cards): copy, image, destination and review status \u2014 or stage a change that applies when the chat is published.
+
+Examples:
+  baker ads chatgpt ads --ad-group-id adgrp_123
+  baker ads chatgpt ads create --ad-group-id adgrp_123 --name "Card A" --title "\u2026" --body "\u2026" --target-url https://\u2026 --image-url https://\u2026
+  baker ads chatgpt ads update ad_123 --title "Solar with no upfront cost"
+  baker ads chatgpt ads pause ad_123`
+  },
+  subCommands: {
+    list: adsListCommand,
+    create: () => import("./ad-writes-77FVHJTS.js").then((m) => m.adsCreateCommand),
+    update: () => import("./ad-writes-77FVHJTS.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./ad-writes-77FVHJTS.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./ad-writes-77FVHJTS.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./ad-writes-77FVHJTS.js").then((m) => m.adsArchiveCommand),
+    "create-product": () => import("./ad-writes-77FVHJTS.js").then((m) => m.adsCreateProductCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args,
+  default: "list"
+});
+export {
+  adsCommand
+};
+//# sourceMappingURL=ads-LYNA2I7B.js.map

package/dist/ads-W2IPUWHQ.js

@@ -0,0 +1,113 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-INJHF7AF.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-O3LHCQ7Q.js";
+import "./chunk-LHNL6JM2.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-DL2W4N7J.js";
+import "./chunk-KIGGMKAE.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/ads.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  "adset-id": { type: "string", description: "Filter to one adset" },
+  "campaign-id": { type: "string", description: "Filter to one campaign" },
+  "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  "name-contains": NAME_CONTAINS_ARG,
+  limit: { type: "string", description: "Max rows (default 1000)" },
+  "no-cache": NO_CACHE_ARG,
+  ...META_LIST_SHAPE_ARGS
+};
+registerMetaListSchema(
+  "ads",
+  "List ads in a Meta ad account, as a table by default: id, name, adset_id, campaign_id, effective_status, creative_id, issues (why an ad is WITH_ISSUES), created_time. Start here: baker ads meta ads --adset-id 6123. --fields takes dotted paths (e.g. id,tracking_specs); --full returns every field Meta sent; --output json returns the rows in the envelope.",
+  listArgs
+);
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List ads in a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta ads --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const effectiveStatus = resolveEffectiveStatus(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["adset-id"]) params["adset-id"] = args["adset-id"];
+      if (args["campaign-id"]) params["campaign-id"] = args["campaign-id"];
+      if (effectiveStatus) params["effective-status"] = effectiveStatus;
+      if (args["name-contains"]) params["name-contains"] = args["name-contains"];
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/ads", params);
+      const shaped = shapeMetaListRows("ads", data, args);
+      writeMetaListRows("ads", shaped, csvOrJson(args), statusFilterHints(data, effectiveStatus, "ads"));
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var adsListCommand = defineCommand({
+  meta: {
+    name: "ads",
+    description: `List ads in a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate/retag).
+Defaults to ACTIVE only \u2014 pass --all-statuses to widen. Write subcommands stage ops on this chat's draft.
+
+The dashboard shows effective_status (e.g. WITH_ISSUES, PENDING_REVIEW, DISAPPROVED, ADSET_PAUSED), not status.
+
+Listings print a table by default: id, name, adset_id, campaign_id, effective_status, creative_id, issues
+(why an ad is WITH_ISSUES), created_time. --fields takes dotted paths (e.g. tracking_specs,
+preview_shareable_link); --full returns every field; --output json returns the rows as JSON.
+
+Examples:
+  baker ads meta ads --account-id act_123
+  baker ads meta ads --adset-id 6123
+  baker ads meta ads --account-id act_123 --all-statuses --name-contains octubre --fields id,name,adset_id,creative_id   \u2014 find one ad by name
+  baker ads meta ads --adset-id 6123 --fields id,name,preview_shareable_link
+  baker ads meta ads create --name "Ad 1" --adset meta_temp_as01 --creative meta_temp_cr01
+  baker ads meta ads pause 6123 --account-id act_123
+  baker ads meta ads retag 6123 --set "utm_medium=paid-social"      \u2014 fix tracking on a LIVE ad, keeping everything else`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adsCreateCommand),
+    update: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adsArchiveCommand),
+    delete: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adsDeleteCommand),
+    duplicate: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adsDuplicateCommand),
+    retag: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adsRetagCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for the
+  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
+  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare
+  // invocation — citty falls through to `run` after a subcommand, double-executing it.
+  args: listArgs,
+  default: "list"
+});
+export {
+  adsListCommand
+};
+//# sourceMappingURL=ads-W2IPUWHQ.js.map

package/dist/adsets-PY5ZKGBO.js

@@ -0,0 +1,176 @@
+import {
+  VIEWER_TABLE_COLUMNS,
+  adSetViewerRows,
+  audienceNamesOf,
+  flattenViewerRows,
+  readAudienceNames
+} from "./chunk-NFSLRRIE.js";
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-INJHF7AF.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-O3LHCQ7Q.js";
+import {
+  rememberedJev
+} from "./chunk-D5MF337I.js";
+import {
+  writeAdsOutput
+} from "./chunk-LHNL6JM2.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-VHMNSO2B.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-65BQAJMH.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-DL2W4N7J.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-6GFJFTG6.js";
+import "./chunk-NAMEFVWL.js";
+import "./chunk-GT4UFORX.js";
+import "./chunk-CECS3DHZ.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/adsets.ts
+import path from "path";
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  "campaign-id": { type: "string", description: "Filter to one campaign" },
+  "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  "name-contains": NAME_CONTAINS_ARG,
+  limit: { type: "string", description: "Max rows (default 1000)" },
+  "no-cache": NO_CACHE_ARG,
+  audience: {
+    type: "boolean",
+    description: "Who each ad set reaches, instead of the compact row: a viewer per ad set \u2014 temperature (cold|warm|hot), what they already know (brand/offer/product), placements, and the reasons, read from its targeting, the account's audiences and the campaign objective. Start here before writing an ad for an ad set: baker ads meta adsets --campaign-id 6123 --audience --output json"
+  },
+  ...META_LIST_SHAPE_ARGS
+};
+async function readOrEmpty(path2, params, label, hints) {
+  try {
+    return await apiGet(path2, params);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "unknown error";
+    hints.push(`Could not read the account's ${label} (${message}); the viewer was read without them.`);
+    return [];
+  }
+}
+async function writeAdSetViewers(adSets, accountParams, format, hints) {
+  const [audiences, campaigns] = await Promise.all([
+    readOrEmpty("/api/ads/meta/audiences", accountParams, "audiences", hints),
+    readOrEmpty("/api/ads/meta/campaigns", accountParams, "campaigns", hints)
+  ]);
+  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+  const cacheDir = path.join(root, "canvas", ".cache");
+  const spent = [];
+  const readName = await readAudienceNames(
+    audienceNamesOf(adSets, audiences),
+    rememberedJev(path.join(cacheDir, "audience-names.json"), (u) => spent.push(u))
+  );
+  await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
+  const rows = adSetViewerRows(adSets, audiences, campaigns, readName);
+  if (rows.length > 0) {
+    hints.push(
+      `Write each ad for the viewer of the ad set it will run in, then record it in the creative's _definition.md: targetAdSet: "<ad set id>" and viewer: { temperature, knows, placements, source }.`
+    );
+  }
+  if (format === "md" || format === "csv") {
+    writeAdsOutput(flattenViewerRows(rows), format, [...VIEWER_TABLE_COLUMNS], hints);
+    return;
+  }
+  writeAdsOutput(rows, format, void 0, hints);
+}
+registerMetaListSchema(
+  "adsets",
+  "List ad sets in a Meta ad account, as a table by default: id, name, campaign_id, effective_status, optimization_goal, billing_event, bid_strategy, budgets, destination_type, is_dynamic_creative, learning_stage, end_time, created_time. Targeting is not in the compact row \u2014 ask for it with --fields id,name,targeting (or --full). --audience replaces the row with who each ad set reaches (a viewer: temperature, what they already know, placements, reasons) \u2014 read it before writing an ad for an ad set. Start here: baker ads meta adsets --campaign-id 6123 --all-statuses. --output json returns the rows in the envelope.",
+  listArgs
+);
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List ad sets in a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta adsets --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const effectiveStatus = resolveEffectiveStatus(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["campaign-id"]) params["campaign-id"] = args["campaign-id"];
+      if (effectiveStatus) params["effective-status"] = effectiveStatus;
+      if (args["name-contains"]) params["name-contains"] = args["name-contains"];
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/adsets", params);
+      if (args.audience) {
+        const hints = statusFilterHints(data, effectiveStatus, "ad sets");
+        const accountParams = { "account-id": accountId };
+        if (args["no-cache"]) accountParams["skip-cache"] = "true";
+        await writeAdSetViewers(data, accountParams, csvOrJson(args), hints);
+        return;
+      }
+      const shaped = shapeMetaListRows("adsets", data, args);
+      writeMetaListRows("adsets", shaped, csvOrJson(args), statusFilterHints(data, effectiveStatus, "ad sets"));
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var adsetsCommand = defineCommand({
+  meta: {
+    name: "adsets",
+    description: `List ad sets in a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate).
+Defaults to ACTIVE only. Write subcommands stage ops on this chat's draft.
+
+Listings print a table by default: id, name, campaign_id, effective_status, optimization_goal, billing_event,
+bid_strategy, budgets, destination_type, is_dynamic_creative, learning_stage, end_time, created_time. Targeting
+is not in the compact row \u2014 ask for it with --fields (dotted paths) or --full. --output json returns the rows as JSON.
+
+Examples:
+  baker ads meta adsets --account-id act_123
+  baker ads meta adsets --campaign-id 6123456789
+  baker ads meta adsets --account-id act_123 --all-statuses --name-contains retargeting   \u2014 find one ad set by name
+  baker ads meta adsets --campaign-id 6123456789 --fields id,name,targeting.geo_locations
+  baker ads meta adsets --campaign-id 6123456789 --audience --output json   \u2014 who each ad set reaches (viewer per ad set)
+  baker ads meta adsets create --campaign meta_temp_ab12 --name "US 25-54" --optimization-goal LINK_CLICKS --billing-event IMPRESSIONS --daily-budget 50 --targeting-file t.json`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adSetsCreateCommand),
+    update: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adSetsUpdateCommand),
+    pause: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adSetsPauseCommand),
+    resume: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adSetsResumeCommand),
+    archive: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adSetsArchiveCommand),
+    delete: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adSetsDeleteCommand),
+    duplicate: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.adSetsDuplicateCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for the
+  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
+  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare
+  // invocation — citty falls through to `run` after a subcommand, double-executing it.
+  args: listArgs,
+  default: "list"
+});
+export {
+  adsetsCommand
+};
+//# sourceMappingURL=adsets-PY5ZKGBO.js.map