@koda-sl/baker-cli 0.461.0 → 0.462.0

package/dist/add-accounts-5YM444GS.js

@@ -0,0 +1,91 @@
+import {
+  PLATFORM_NAMES,
+  reportError,
+  splitList
+} from "./chunk-POSV2BIJ.js";
+import {
+  apiPost
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  BRAND_ACCOUNTS_MAX,
+  registerSchema,
+  writeJson
+} from "./chunk-4TCMKTJG.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-5YM444GS.js.map

package/dist/add-accounts-5YM444GS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/add-accounts.ts"],"sourcesContent":["import { type AddBrandAccountsResponse, BRAND_ACCOUNTS_MAX, type ResolvePreview } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { PLATFORM_NAMES, reportError, splitList } from \"./shared.ts\";\n\n// One resolve per input, then an add upstream — slower than a single follow.\nconst ADD_TIMEOUT_MS = 120_000;\n\nconst named = (accounts: ResolvePreview[]) =>\n  accounts.map((a) => `${a.name} (${PLATFORM_NAMES[a.platform]})`).join(\", \");\n\n/** What the agent reads back: what is now collecting, what was there already, and why an input wasn't added. */\nexport function addAccountsHints(data: AddBrandAccountsResponse): string[] {\n  const hints: string[] = [];\n  if (data.added.length > 0) {\n    hints.push(\n      `Now tracking ${named(data.added)} — its ads arrive over the next minutes; check \\`baker winning-ads following\\`.`,\n    );\n  }\n  if (data.already_tracked.length > 0) {\n    hints.push(`Already tracked under this brand: ${named(data.already_tracked)}.`);\n  }\n  for (const failure of data.failed) {\n    hints.push(`Not added: \"${failure.input}\" — ${failure.error}`);\n  }\n  return hints;\n}\n\nregisterSchema({\n  command: \"winning-ads.add-accounts\",\n  description:\n    \"Track more accounts under a brand you already follow — 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…), or a website. `follow` returns ready-made calls for the look-alike accounts it found.\",\n  args: {\n    advertiser: { type: \"string\", description: \"Advertiser id of a followed brand (from `following`)\", required: true },\n    inputs: {\n      type: \"string\",\n      description: `Comma-separated links, advertiser ids or websites — up to ${BRAND_ACCOUNTS_MAX}`,\n      required: true,\n    },\n  },\n});\n\nexport const addAccountsCommand = defineCommand({\n  meta: {\n    name: \"add-accounts\",\n    description:\n      \"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\\\"\",\n  },\n  args: {\n    advertiser: { type: \"positional\", description: \"Advertiser id of a followed brand\", required: true },\n    inputs: {\n      type: \"positional\",\n      description: \"Comma-separated links, advertiser ids or websites\",\n      required: true,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const inputs = [...new Set(splitList(String(args.inputs ?? \"\")))];\n      if (inputs.length === 0 || inputs.length > BRAND_ACCOUNTS_MAX) {\n        writeJson({\n          ok: false,\n          error: {\n            code: \"VALIDATION_ERROR\",\n            message: `Pass between 1 and ${BRAND_ACCOUNTS_MAX} comma-separated links.`,\n          },\n        });\n        process.exit(1);\n      }\n      const data = await apiPost<AddBrandAccountsResponse>(\n        \"/api/ad-library/accounts/add\",\n        { advertiser_id: String(args.advertiser), inputs },\n        { timeoutMs: ADD_TIMEOUT_MS },\n      );\n      const hints = addAccountsHints(data);\n      writeJson({ ok: true, data, hints: hints.length > 0 ? hints : undefined });\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAO9B,IAAM,iBAAiB;AAEvB,IAAM,QAAQ,CAAC,aACb,SAAS,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,KAAK,eAAe,EAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,IAAI;AAGrE,SAAS,iBAAiB,MAA0C;AACzE,QAAM,QAAkB,CAAC;AACzB,MAAI,KAAK,MAAM,SAAS,GAAG;AACzB,UAAM;AAAA,MACJ,gBAAgB,MAAM,KAAK,KAAK,CAAC;AAAA,IACnC;AAAA,EACF;AACA,MAAI,KAAK,gBAAgB,SAAS,GAAG;AACnC,UAAM,KAAK,qCAAqC,MAAM,KAAK,eAAe,CAAC,GAAG;AAAA,EAChF;AACA,aAAW,WAAW,KAAK,QAAQ;AACjC,UAAM,KAAK,eAAe,QAAQ,KAAK,YAAO,QAAQ,KAAK,EAAE;AAAA,EAC/D;AACA,SAAO;AACT;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,YAAY,EAAE,MAAM,UAAU,aAAa,wDAAwD,UAAU,KAAK;AAAA,IAClH,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,aAAa,kEAA6D,kBAAkB;AAAA,MAC5F,UAAU;AAAA,IACZ;AAAA,EACF;AACF,CAAC;AAEM,IAAM,qBAAqB,cAAc;AAAA,EAC9C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,YAAY,EAAE,MAAM,cAAc,aAAa,qCAAqC,UAAU,KAAK;AAAA,IACnG,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,SAAS,CAAC,GAAG,IAAI,IAAI,UAAU,OAAO,KAAK,UAAU,EAAE,CAAC,CAAC,CAAC;AAChE,UAAI,OAAO,WAAW,KAAK,OAAO,SAAS,oBAAoB;AAC7D,kBAAU;AAAA,UACR,IAAI;AAAA,UACJ,OAAO;AAAA,YACL,MAAM;AAAA,YACN,SAAS,sBAAsB,kBAAkB;AAAA,UACnD;AAAA,QACF,CAAC;AACD,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,YAAM,OAAO,MAAM;AAAA,QACjB;AAAA,QACA,EAAE,eAAe,OAAO,KAAK,UAAU,GAAG,OAAO;AAAA,QACjD,EAAE,WAAW,eAAe;AAAA,MAC9B;AACA,YAAM,QAAQ,iBAAiB,IAAI;AACnC,gBAAU,EAAE,IAAI,MAAM,MAAM,OAAO,MAAM,SAAS,IAAI,QAAQ,OAAU,CAAC;AAAA,IAC3E,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/ads-7I5RBARI.js

@@ -0,0 +1,40 @@
+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)
+
+Examples:
+  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)`
+  },
+  subCommands: {
+    google: () => import("./google-BJGFJPJC.js").then((m) => m.googleCommand),
+    meta: () => import("./meta-AA5TZVOR.js").then((m) => m.metaCommand),
+    linkedin: () => import("./linkedin-NZGQSJHC.js").then((m) => m.linkedinCommand),
+    x: () => import("./x-ASICBXWJ.js").then((m) => m.xCommand),
+    chatgpt: () => import("./chatgpt-DSNGN7UW.js").then((m) => m.chatgptCommand)
+  }
+});
+export {
+  adsCommand
+};
+//# sourceMappingURL=ads-7I5RBARI.js.map

package/dist/ads-A3RV4X3L.js

@@ -0,0 +1,77 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-OATXWQPB.js";
+import "./chunk-V44SLD5J.js";
+import "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  registerSchema
+} from "./chunk-4TCMKTJG.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-UGKKVCRT.js").then((m) => m.adsCreateCommand),
+    update: () => import("./ad-writes-UGKKVCRT.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./ad-writes-UGKKVCRT.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./ad-writes-UGKKVCRT.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./ad-writes-UGKKVCRT.js").then((m) => m.adsArchiveCommand),
+    "create-product": () => import("./ad-writes-UGKKVCRT.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-A3RV4X3L.js.map

package/dist/ads-FP2UK4GW.js

@@ -0,0 +1,128 @@
+import {
+  adFieldPlan,
+  adRows
+} from "./chunk-JQMYDSNZ.js";
+import {
+  reportError
+} from "./chunk-POSV2BIJ.js";
+import {
+  apiGet
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  advertiserAdsRequestSchema,
+  registerSchema,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-4TCMKTJG.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-FP2UK4GW.js.map

package/dist/ads-TQD66AD5.js

@@ -0,0 +1,113 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-DGA7Q7DN.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-OI4NFLZM.js";
+import "./chunk-V44SLD5J.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import "./chunk-KIGGMKAE.js";
+import {
+  apiGet
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import "./chunk-4TCMKTJG.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-DPJ2Z7HP.js").then((m) => m.adsCreateCommand),
+    update: () => import("./write-commands-DPJ2Z7HP.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./write-commands-DPJ2Z7HP.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./write-commands-DPJ2Z7HP.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./write-commands-DPJ2Z7HP.js").then((m) => m.adsArchiveCommand),
+    delete: () => import("./write-commands-DPJ2Z7HP.js").then((m) => m.adsDeleteCommand),
+    duplicate: () => import("./write-commands-DPJ2Z7HP.js").then((m) => m.adsDuplicateCommand),
+    retag: () => import("./write-commands-DPJ2Z7HP.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-TQD66AD5.js.map

package/dist/adsets-GXPDMZ7L.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-DGA7Q7DN.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-OI4NFLZM.js";
+import {
+  rememberedJev
+} from "./chunk-KXRAAA6D.js";
+import {
+  writeAdsOutput
+} from "./chunk-V44SLD5J.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-PXDISZSC.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-LOOPAOSC.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-VYERPVW7.js";
+import "./chunk-3GJKFY7A.js";
+import "./chunk-RO5ZC4J6.js";
+import "./chunk-PI3WJP6J.js";
+import {
+  apiGet
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import "./chunk-4TCMKTJG.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-DPJ2Z7HP.js").then((m) => m.adSetsCreateCommand),
+    update: () => import("./write-commands-DPJ2Z7HP.js").then((m) => m.adSetsUpdateCommand),
+    pause: () => import("./write-commands-DPJ2Z7HP.js").then((m) => m.adSetsPauseCommand),
+    resume: () => import("./write-commands-DPJ2Z7HP.js").then((m) => m.adSetsResumeCommand),
+    archive: () => import("./write-commands-DPJ2Z7HP.js").then((m) => m.adSetsArchiveCommand),
+    delete: () => import("./write-commands-DPJ2Z7HP.js").then((m) => m.adSetsDeleteCommand),
+    duplicate: () => import("./write-commands-DPJ2Z7HP.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-GXPDMZ7L.js.map