@koda-sl/baker-cli 0.489.0 → 0.491.0

package/dist/audiences-AAZH56WD.js

@@ -0,0 +1,268 @@
+import {
+  csvArg,
+  failWriteValidation,
+  requireTarget,
+  requireTargets,
+  schemaArgs,
+  stageChatgptOp,
+  stageChatgptOps
+} from "./chunk-AQM4JH62.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  CHATGPT_AUDIENCE_USES,
+  CHATGPT_MAX_STAGED_MEMBERS,
+  runChatgptListRead
+} from "./chunk-IG627WWY.js";
+import "./chunk-SWL4AAPP.js";
+import "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import {
+  registerSchema
+} from "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/audiences.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+
+// src/commands/ads/chatgpt/audience-members.ts
+import { createHash } from "crypto";
+import { parse } from "csv-parse/sync";
+import { isSupportedCountry, parsePhoneNumberFromString } from "libphonenumber-js";
+function sha256(value) {
+  return createHash("sha256").update(value, "utf8").digest("hex");
+}
+function normalizedEmail(value) {
+  const email = value.trim().toLowerCase();
+  return /^[^@\s;,|]+@[^@\s;,|]+\.[^@\s;,|]+$/.test(email) ? email : void 0;
+}
+function normalizedPhone(value, defaultCountry) {
+  const country = defaultCountry && isSupportedCountry(defaultCountry) ? defaultCountry : void 0;
+  const phone = parsePhoneNumberFromString(value.trim(), country);
+  return phone?.isValid() ? phone.number : void 0;
+}
+function hashedMembers(input) {
+  const rejected = [];
+  const emailHashes = /* @__PURE__ */ new Set();
+  const phoneHashes = /* @__PURE__ */ new Set();
+  for (const value of input.emails) {
+    const email = normalizedEmail(value);
+    email ? emailHashes.add(sha256(email)) : rejected.push(value.trim());
+  }
+  for (const value of input.phones) {
+    const phone = normalizedPhone(value, input.defaultCountry);
+    phone ? phoneHashes.add(sha256(phone)) : rejected.push(value.trim());
+  }
+  return { emailHashes: [...emailHashes], phoneHashes: [...phoneHashes], rejected };
+}
+function headerWords(cell) {
+  return cell.normalize("NFD").replace(new RegExp("\\p{Diacritic}", "gu"), "").toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
+}
+var EMAIL_HEADER = /\b(e ?mail|correo|mail)\b/;
+var PHONE_HEADER = /\b(phone|telefono|movil|mobile|tel|celular)\b/;
+function membersFromFile(content) {
+  const rows = parse(content, {
+    bom: true,
+    skip_empty_lines: true,
+    relax_column_count: true,
+    trim: true,
+    delimiter: [",", ";", "	"]
+  });
+  const header = (rows[0] ?? []).map(headerWords);
+  const emailColumn = header.findIndex((cell) => EMAIL_HEADER.test(cell));
+  const phoneColumn = header.findIndex((cell) => !EMAIL_HEADER.test(cell) && PHONE_HEADER.test(cell));
+  if (emailColumn >= 0 || phoneColumn >= 0) {
+    const cells = (column) => column < 0 ? [] : rows.slice(1).flatMap((row) => row[column] ? [row[column]] : []);
+    return { emails: cells(emailColumn), phones: cells(phoneColumn) };
+  }
+  const values = rows.flatMap((row) => row[0] ? [row[0]] : []);
+  return values.some((value) => value.includes("@")) ? { emails: values, phones: [] } : { emails: [], phones: values };
+}
+
+// src/commands/ads/chatgpt/audiences.ts
+var REFERENCE = CHATGPT_ADS_REFERENCE.audiences;
+var MEMBER_ARGS = {
+  emails: { type: "string", description: "Emails, comma-separated" },
+  phones: { type: "string", description: "Phones, comma-separated \u2014 E.164 (+34\u2026), or local with --country" },
+  file: {
+    type: "string",
+    description: "A CSV with an email and/or phone column, or one email or phone per line \u2014 the company's own customers"
+  },
+  country: { type: "string", description: "Country of phones written without a +code, e.g. ES" }
+};
+function membersFromArgs(args, readFile = (path) => readFileSync(path, "utf8")) {
+  const fromFile = typeof args.file === "string" && args.file ? membersFromFile(readFile(args.file)) : { emails: [], phones: [] };
+  const given = [...csvArg(args.emails) ?? [], ...fromFile.emails];
+  const givenPhones = [...csvArg(args.phones) ?? [], ...fromFile.phones];
+  const members = hashedMembers({
+    emails: given,
+    phones: givenPhones,
+    defaultCountry: typeof args.country === "string" ? args.country.toUpperCase() : void 0
+  });
+  const count = members.emailHashes.length + members.phoneHashes.length;
+  const offered = given.length + givenPhones.length + (typeof args.file === "string" && args.file ? 1 : 0);
+  const refusal = count > CHATGPT_MAX_STAGED_MEMBERS ? `${count} members \u2014 at most ${CHATGPT_MAX_STAGED_MEMBERS} per change; split the file` : count === 0 && offered > 0 ? "none of the values was an email or a valid phone \u2014 name the columns email and phone, and give phones a +country code or --country" : void 0;
+  return {
+    payload: {
+      ...members.emailHashes.length > 0 ? { emailHashes: members.emailHashes } : {},
+      ...members.phoneHashes.length > 0 ? { phoneHashes: members.phoneHashes } : {}
+    },
+    rejected: members.rejected.length,
+    ...refusal ? { refusal } : {}
+  };
+}
+function rejectedHint(rejected) {
+  return rejected > 0 ? [
+    `${rejected} value(s) were neither an email nor a valid phone and were left out \u2014 phones need a +country code, or --country.`
+  ] : [];
+}
+var LIST_ARGS = {
+  "eligible-for": {
+    type: "string",
+    description: `Only audiences ChatGPT Ads lets serve this use: ${CHATGPT_AUDIENCE_USES.join("|")}`
+  }
+};
+registerSchema({
+  command: "ads.chatgpt.audiences.list",
+  description: "The account's custom audiences: status, and matched people as a privacy range (under_25k\u2026). `ready` is not eligibility \u2014 pass --eligible-for to list only those a use accepts.",
+  args: schemaArgs(LIST_ARGS)
+});
+var audiencesListCommand = defineCommand({
+  meta: { name: "list", description: "List the account's custom audiences." },
+  args: LIST_ARGS,
+  run: async ({ args }) => {
+    const use = typeof args["eligible-for"] === "string" ? args["eligible-for"] : void 0;
+    await runChatgptListRead(
+      REFERENCE,
+      "/api/ads/chatgpt/audiences",
+      use ? { eligible_for: use } : void 0,
+      (rows) => rows.length === 0 ? ["No audience. Stage one with `baker ads chatgpt audiences create --name \u2026 --file customers.csv`."] : [
+        "Including an audience needs about 25,000 matched people; excluding works at any size. Custom audiences do not work in campaigns serving the EEA or Switzerland."
+      ]
+    );
+  }
+});
+var CREATE_ARGS = {
+  name: { type: "string", description: "Audience name (3+ characters)", required: true },
+  description: { type: "string", description: "What the list is" },
+  ...MEMBER_ARGS
+};
+registerSchema({
+  command: "ads.chatgpt.audiences.create",
+  description: "Stage a custom audience from the company's own customers (emails and/or phones, hashed on this machine), or an empty one. Created when the chat is published; only first-party data the company may use for ads.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var audiencesCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a custom audience (applies when the chat is published). Members are hashed here; nothing raw is sent.
+
+Examples:
+  baker ads chatgpt audiences create --name "Customers 2026" --file customers.csv --country ES
+  baker ads chatgpt audiences create --name "Recent buyers"   # empty, fill it later with add`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    const { payload, rejected, refusal } = membersFromArgs(args);
+    if (refusal) {
+      failWriteValidation(refusal);
+    }
+    await stageChatgptOp(
+      {
+        kind: "audience.create",
+        payload: { name: args.name, ...args.description ? { description: args.description } : {}, ...payload }
+      },
+      REFERENCE,
+      (staged) => [
+        ...rejectedHint(rejected),
+        `Use it on a campaign after the publish, once \`audiences\` shows it ready: campaigns update <cmpn_id> --excluded-audience-ids <caud_id>. (${staged.ref} is its ref in this chat.)`
+      ]
+    );
+  }
+});
+function membersCommand(verb) {
+  const args = {
+    id: { type: "positional", description: "Audience id (caud_\u2026)", required: true },
+    ...MEMBER_ARGS
+  };
+  registerSchema({
+    command: `ads.chatgpt.audiences.${verb}`,
+    description: `Stage ${verb === "add" ? "adding" : "removing"} members ${verb === "add" ? "to" : "from"} a live custom audience, hashed on this machine. Applies when the chat is published.`,
+    args: schemaArgs(args)
+  });
+  return defineCommand({
+    meta: {
+      name: verb,
+      description: `Stage ${verb === "add" ? "adding" : "removing"} members.
+
+Example:
+  baker ads chatgpt audiences ${verb} caud_123 --emails ana@example.com,luis@example.com`
+    },
+    args,
+    run: async ({ args: parsed }) => {
+      const { payload, rejected, refusal } = membersFromArgs(parsed);
+      if (refusal) {
+        failWriteValidation(refusal);
+      }
+      if (!payload.emailHashes && !payload.phoneHashes) {
+        failWriteValidation("name at least one email or phone with --emails, --phones or --file");
+      }
+      await stageChatgptOp(
+        { kind: `audience.${verb}`, target: requireTarget(parsed, "id"), payload },
+        REFERENCE,
+        () => rejectedHint(rejected)
+      );
+    }
+  });
+}
+var ARCHIVE_ARGS = {
+  ids: { type: "positional", description: "Audience ids, comma-separated", required: true }
+};
+registerSchema({
+  command: "ads.chatgpt.audiences.archive",
+  description: "Stage archiving custom audiences \u2014 for good: ChatGPT Ads cannot bring one back. Pass every id in one call.",
+  args: schemaArgs(ARCHIVE_ARGS)
+});
+var audiencesArchiveCommand = defineCommand({
+  meta: {
+    name: "archive",
+    description: `Stage archiving audiences, for good.
+
+Example:
+  baker ads chatgpt audiences archive caud_123`
+  },
+  args: ARCHIVE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOps(
+      requireTargets(args, "ids").map((id) => ({ kind: "audience.archive", target: id, payload: {} })),
+      REFERENCE
+    );
+  }
+});
+var audiencesCommand = defineCommand({
+  meta: {
+    name: "audiences",
+    description: `Custom audiences \u2014 the company's own customer lists a campaign serves to or leaves out.
+
+Examples:
+  baker ads chatgpt audiences
+  baker ads chatgpt audiences create --name "Customers 2026" --file customers.csv --country ES
+  baker ads chatgpt audiences add caud_123 --emails ana@example.com`
+  },
+  subCommands: {
+    list: audiencesListCommand,
+    create: audiencesCreateCommand,
+    add: membersCommand("add"),
+    remove: membersCommand("remove"),
+    archive: audiencesArchiveCommand
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args: {},
+  default: "list"
+});
+export {
+  audiencesCommand,
+  membersFromArgs
+};
+//# sourceMappingURL=audiences-AAZH56WD.js.map

package/dist/audiences-X3RLGOVM.js

@@ -0,0 +1,84 @@
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-QTOZ32SU.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-SWL4AAPP.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-K3TNTBZJ.js";
+import {
+  apiGet
+} from "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/audiences.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  limit: { type: "string", description: "Max rows" },
+  "no-cache": NO_CACHE_ARG,
+  output: { type: "string", description: "Output format", default: "json" }
+};
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List custom audiences. Runs by default when no subcommand is given. Example: baker ads meta audiences --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/audiences", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var audiencesCommand = defineCommand({
+  meta: {
+    name: "audiences",
+    description: `List custom audiences, or stage writes (create/update/delete, members add|remove|replace). Write subcommands stage ops on this chat's draft.
+Includes lookalikes, website-pixel audiences, customer-file audiences. Meta hides exact size when count < 1000.
+
+Examples:
+  baker ads meta audiences --account-id act_123
+  baker ads meta audiences create --name "Site 30d" --subtype WEBSITE --file rule.json
+  baker ads meta audiences create --name "Customers" --subtype CUSTOM --customer-file-source USER_PROVIDED_ONLY
+  baker ads meta audiences members add meta_temp_ab12 --file customers.csv --country ES
+  baker ads meta audiences saved --account-id act_123            \u2014 saved audiences (read-only)`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-PEJBTME6.js").then((m) => m.audiencesCreateCommand),
+    update: () => import("./write-commands-PEJBTME6.js").then((m) => m.audiencesUpdateCommand),
+    delete: () => import("./audience-writes-X52VG35Y.js").then((m) => m.audiencesDeleteCommand),
+    members: () => import("./audience-writes-X52VG35Y.js").then((m) => m.audiencesMembersCommand),
+    saved: () => import("./audience-writes-X52VG35Y.js").then((m) => m.savedAudiencesCommand)
+  },
+  // `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 {
+  audiencesCommand
+};
+//# sourceMappingURL=audiences-X3RLGOVM.js.map

package/dist/audiences-X3RLGOVM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/audiences.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport { csvOrJson, handleMetaError, resolveAccountIdArg } from \"./shared.ts\";\n\nconst listArgs = {\n  \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n  limit: { type: \"string\", description: \"Max rows\" },\n  \"no-cache\": NO_CACHE_ARG,\n  output: { type: \"string\", description: \"Output format\", default: \"json\" },\n} as const;\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"List custom audiences. Runs by default when no subcommand is given. Example: baker ads meta audiences --account-id act_123\",\n  },\n  args: listArgs,\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args.limit) params.limit = args.limit as string;\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n      const data = await apiGet<Array<Record<string, unknown>>>(\"/api/ads/meta/audiences\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(data, fmt);\n        return;\n      }\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nexport const audiencesCommand = defineCommand({\n  meta: {\n    name: \"audiences\",\n    description: `List custom audiences, or stage writes (create/update/delete, members add|remove|replace). Write subcommands stage ops on this chat's draft.\nIncludes lookalikes, website-pixel audiences, customer-file audiences. Meta hides exact size when count < 1000.\n\nExamples:\n  baker ads meta audiences --account-id act_123\n  baker ads meta audiences create --name \"Site 30d\" --subtype WEBSITE --file rule.json\n  baker ads meta audiences create --name \"Customers\" --subtype CUSTOM --customer-file-source USER_PROVIDED_ONLY\n  baker ads meta audiences members add meta_temp_ab12 --file customers.csv --country ES\n  baker ads meta audiences saved --account-id act_123            — saved audiences (read-only)`,\n  },\n  subCommands: {\n    list: listCommand,\n    create: () => import(\"./write-commands.ts\").then((m) => m.audiencesCreateCommand),\n    update: () => import(\"./write-commands.ts\").then((m) => m.audiencesUpdateCommand),\n    delete: () => import(\"./audience-writes.ts\").then((m) => m.audiencesDeleteCommand),\n    members: () => import(\"./audience-writes.ts\").then((m) => m.audiencesMembersCommand),\n    saved: () => import(\"./audience-writes.ts\").then((m) => m.savedAudiencesCommand),\n  },\n  // `args` stays even though the parent has no `run`: citty scans rawArgs for the\n  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`\n  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare\n  // invocation — citty falls through to `run` after a subcommand, double-executing it.\n  args: listArgs,\n  default: \"list\",\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAM9B,IAAM,WAAW;AAAA,EACf,cAAc,EAAE,MAAM,UAAU,aAAa,qBAAqB;AAAA,EAClE,OAAO,EAAE,MAAM,UAAU,aAAa,WAAW;AAAA,EACjD,YAAY;AAAA,EACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,iBAAiB,SAAS,OAAO;AAC1E;AAEA,IAAM,cAAc,cAAc;AAAA,EAChC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,oBAAoB,IAAI;AAC1C,QAAI;AACF,YAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,UAAI,KAAK,MAAO,QAAO,QAAQ,KAAK;AACpC,UAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,YAAM,OAAO,MAAM,OAAuC,2BAA2B,MAAM;AAC3F,YAAM,MAAM,UAAU,IAAI;AAC1B,UAAI,QAAQ,QAAQ;AAClB,uBAAe,MAAM,GAAG;AACxB;AAAA,MACF;AACA,mBAAa,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACjC,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAEM,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASf;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,sBAAsB;AAAA,IAChF,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,sBAAsB;AAAA,IAChF,QAAQ,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,sBAAsB;AAAA,IACjF,SAAS,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,uBAAuB;AAAA,IACnF,OAAO,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,qBAAqB;AAAA,EACjF;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM;AAAA,EACN,SAAS;AACX,CAAC;","names":[]}

package/dist/audit-AEENRVGD.js

@@ -0,0 +1,151 @@
+import {
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-TTHM66TA.js";
+import {
+  writeAdsJson
+} from "./chunk-SWL4AAPP.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-K3TNTBZJ.js";
+import "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/audit.ts
+import { defineCommand } from "citty";
+var SEVERITY_RANK = {
+  critical: 0,
+  high: 1,
+  medium: 2,
+  low: 3
+};
+var STATUS_RANK = {
+  fail: 0,
+  warn: 1,
+  partial: 2,
+  pass: 3,
+  n_a: 4
+};
+function filterFindings(findings, severity, area) {
+  return findings.filter((f) => {
+    if (severity && !severity.includes(f.severity)) return false;
+    if (area && !area.includes(f.area)) return false;
+    return true;
+  });
+}
+function sortFindings(findings) {
+  return [...findings].sort((a, b) => {
+    const sa = STATUS_RANK[a.status] - STATUS_RANK[b.status];
+    if (sa !== 0) return sa;
+    return SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity];
+  });
+}
+function renderMarkdown(result) {
+  const lines = [];
+  lines.push(`# LinkedIn Ads Audit \u2014 ${result.account.name} (${result.account.id})`);
+  lines.push("");
+  lines.push(
+    `**Scope:** ${result.scope.campaigns} campaigns, ${result.scope.creatives} creatives, last ${result.scope.windowDays}d`
+  );
+  lines.push("");
+  lines.push(
+    `**Summary:** ${result.summary.pass} pass \u2022 ${result.summary.critical} critical \u2022 ${result.summary.high} high \u2022 ${result.summary.medium} medium \u2022 ${result.summary.low} low \u2022 ${result.summary.n_a} n/a (${result.summary.totalChecks} total)`
+  );
+  lines.push("");
+  lines.push("| # | Area | Check | Status | Severity | Notes |");
+  lines.push("|---|------|-------|--------|----------|-------|");
+  result.findings.forEach((f, idx) => {
+    const note = noteOf(f);
+    lines.push(
+      `| ${idx + 1} | ${f.area} | ${escapeMd(f.check)} | ${f.status.toUpperCase()} | ${f.severity} | ${escapeMd(note)} |`
+    );
+  });
+  return lines.join("\n");
+}
+function escapeMd(text) {
+  return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
+}
+function noteOf(f) {
+  if (f.status === "pass") return "";
+  const ev = f.evidence ? JSON.stringify(f.evidence) : "";
+  const fix = f.fix?.explanation ?? "";
+  return [fix, ev].filter(Boolean).join(" \u2014 ");
+}
+var auditCommand = defineCommand({
+  meta: {
+    name: "audit",
+    description: `Run a LinkedIn Ads playbook audit \u2014 30+ checks across Settings, Tracking,
+Audience, Campaigns, Creative, Performance, Bidding, and Compliance.
+
+Each finding has {id, area, check, status, severity, evidence, fix} fields with
+playbook citations. The default JSON output is agent-friendly; --format md
+renders a deliverable-ready table that mirrors the google-ads-playbook
+10-audit-summary.md style.
+
+Exit code 0 always. Use the JSON 'summary' counts to decide if action is needed.
+
+Examples:
+  baker ads linkedin audit --account-id 503001492
+  baker ads linkedin audit --account-id 503001492 --campaign-id 1234        # narrow scope
+  baker ads linkedin audit --account-id 503001492 --window-days 90
+  baker ads linkedin audit --account-id 503001492 --severity critical,high
+  baker ads linkedin audit --account-id 503001492 --area Settings,Tracking
+  baker ads linkedin audit --account-id 503001492 --format md`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "campaign-id": { type: "string", description: "Narrow scope to a single campaign" },
+    "window-days": { type: "string", description: "Lookback window for performance checks (default: 30)" },
+    severity: { type: "string", description: "CSV severity filter: critical,high,medium,low" },
+    area: {
+      type: "string",
+      description: "CSV area filter: Settings,Tracking,Audience,Campaigns,Creative,Performance,Bidding,Compliance,Hygiene"
+    },
+    format: { type: "string", description: "Output format: json | md (default: json)" },
+    "no-cache": NO_CACHE_ARG
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const windowDays = args["window-days"] ? Number(args["window-days"]) : 30;
+    if (!Number.isFinite(windowDays) || windowDays < 1 || windowDays > 365) {
+      handleLinkedinError(new Error("--window-days must be 1..365"));
+    }
+    try {
+      const data = await apiPost("/api/ads/linkedin/audit", {
+        accountId,
+        campaignId: args["campaign-id"] ? String(args["campaign-id"]) : void 0,
+        windowDays,
+        skipCache: Boolean(args["no-cache"])
+      });
+      const severityFilter = args.severity?.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+      const areaFilter = args.area?.split(",").map((s) => s.trim()).filter(Boolean);
+      const filtered = filterFindings(data.findings, severityFilter, areaFilter);
+      const sorted = sortFindings(filtered);
+      const result = { ...data, findings: sorted };
+      const fmt = args.format ?? "json";
+      if (fmt === "md") {
+        process.stdout.write(`${renderMarkdown(result)}
+`);
+        return;
+      }
+      writeAdsJson({ ok: true, data: result });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  auditCommand
+};
+//# sourceMappingURL=audit-AEENRVGD.js.map

package/dist/autocomplete-AAGTJHVL.js

@@ -0,0 +1,111 @@
+import {
+  noSerpRowsHints
+} from "./chunk-JH2L5CQD.js";
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-BFRIRZRZ.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-BDYLILMW.js";
+import "./chunk-SVM3DGAQ.js";
+import "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import {
+  registerSchema
+} from "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/autocomplete.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.autocomplete",
+  description: "Get Google Autocomplete suggestions for a seed keyword. Useful for keyword expansion and discovering what people actually search for. If --location and --language are omitted, defaults to United States (us) and English (en).",
+  args: {
+    keyword: { type: "string", description: "Seed keyword (positional)", required: true },
+    location: {
+      type: "string",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language code or name. Defaults to en (English) if omitted",
+      required: false
+    },
+    limit: { type: "string", description: "Max suggestions (default: 10, max: 20)", required: false },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  suggestion: "Autocomplete suggestion from Google"
+};
+var autocompleteCommand = defineCommand({
+  meta: {
+    name: "autocomplete",
+    description: `Get Google Autocomplete suggestions for keyword expansion.
+
+Examples:
+  baker research autocomplete "running shoes"
+  baker research autocomplete "crm" --location uk --limit 5`
+  },
+  args: {
+    keyword: { type: "positional", description: "Seed keyword", required: true },
+    location: { type: "string", description: "Country code or location code (default: us)", required: false },
+    language: { type: "string", description: "Language code or name (default: en)", required: false },
+    limit: { type: "string", description: "Max suggestions (default: 10, max: 20)", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  },
+  run: async ({ args }) => {
+    const keyword = args.keyword;
+    const location = args.location || void 0;
+    const language = args.language || void 0;
+    const limit = args.limit ? Number(args.limit) : void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    const queryContext = buildResearchQueryContext(location, language);
+    try {
+      const data = await apiPost("/api/research/autocomplete", {
+        keyword,
+        location,
+        language,
+        limit,
+        skipCache
+      });
+      warnDefaults(queryContext);
+      const format = args.output || "json";
+      const hints = noSerpRowsHints(data.length, queryContext);
+      if (format !== "json") {
+        writeResearchOutput(data, format);
+        writeResearchHints(hints, format);
+        return;
+      }
+      writeResearchJson({
+        ok: true,
+        data,
+        fields: FIELDS,
+        note: RESEARCH_DATA_NOTE,
+        query_context: queryContext,
+        hints
+      });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  autocompleteCommand
+};
+//# sourceMappingURL=autocomplete-AAGTJHVL.js.map

package/dist/avatars-VEATUUKU.js

@@ -0,0 +1,38 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/index.ts
+import { defineCommand } from "citty";
+var avatarsCommand = defineCommand({
+  meta: {
+    name: "avatars",
+    description: `Reusable AI presenters this company can cast into images and video. An avatar holds one settled identity, so the same face can carry a whole campaign. Subcommands: list, get, create, research, update, delete.
+
+How casting works:
+  1. baker avatars list                       See who this company already has (reuse before you create)
+  2. baker avatars get <handle>               Status, identity sheet URL, subject description
+  3. baker images generate "<scene>" --reference <sheetUrl>
+                                              Ground the render on the identity sheet, never on a source photo,
+                                              and copy the subject description into the prompt verbatim
+
+Examples:
+  baker avatars list --status ready --output md
+  baker avatars get marta --full
+  baker avatars create --name "Marta" --subject "woman in her early 40s, shoulder-length dark hair, light olive skin"
+  baker avatars research "Lautaro Suarez, CTO at Vibiz" --create   A real, named person, from their public photos
+  baker avatars update marta --subject "\u2026" --regenerate-sheet
+  baker avatars delete marta --archive
+Full guide: __tooling__/docs/tools/baker/avatars.md`
+  },
+  subCommands: {
+    list: () => import("./list-GK6LNWIW.js").then((m) => m.listCommand),
+    get: () => import("./get-7GCEJ6KG.js").then((m) => m.getCommand),
+    create: () => import("./create-VR7RXKL7.js").then((m) => m.createCommand),
+    research: () => import("./research-4YTFPGH7.js").then((m) => m.researchCommand),
+    update: () => import("./update-NOWC3ICD.js").then((m) => m.updateCommand),
+    delete: () => import("./delete-2GIIUPA3.js").then((m) => m.deleteCommand)
+  }
+});
+export {
+  avatarsCommand
+};
+//# sourceMappingURL=avatars-VEATUUKU.js.map