@koda-sl/baker-cli 0.496.0 → 0.497.0

package/dist/audit-IYGRU7LD.js

@@ -0,0 +1,152 @@
+import {
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-2YTBPRRG.js";
+import {
+  writeAdsJson
+} from "./chunk-2VIZ4UUZ.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-U6RONIJC.js";
+import "./chunk-O37VU7FG.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import "./chunk-QANGHND7.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-IYGRU7LD.js.map

package/dist/audit-IYGRU7LD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/audit.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport { handleLinkedinError, resolveAccountIdArg } from \"./shared.ts\";\n\ninterface AuditFinding {\n  id: string;\n  area: string;\n  check: string;\n  status: \"pass\" | \"fail\" | \"partial\" | \"warn\" | \"n_a\";\n  severity: \"critical\" | \"high\" | \"medium\" | \"low\";\n  evidence?: Record<string, unknown>;\n  fix?: { explanation: string; playbookRef?: string; correctedCommand?: string };\n}\n\ninterface AuditResult {\n  account: { urn: string; id: string; name: string };\n  scope: { campaigns: number; creatives: number; windowDays: number };\n  summary: {\n    critical: number;\n    high: number;\n    medium: number;\n    low: number;\n    pass: number;\n    n_a: number;\n    totalChecks: number;\n  };\n  findings: AuditFinding[];\n}\n\nconst SEVERITY_RANK: Record<AuditFinding[\"severity\"], number> = {\n  critical: 0,\n  high: 1,\n  medium: 2,\n  low: 3,\n};\n\nconst STATUS_RANK: Record<AuditFinding[\"status\"], number> = {\n  fail: 0,\n  warn: 1,\n  partial: 2,\n  pass: 3,\n  n_a: 4,\n};\n\nfunction filterFindings(\n  findings: AuditFinding[],\n  severity: string[] | undefined,\n  area: string[] | undefined,\n): AuditFinding[] {\n  return findings.filter((f) => {\n    if (severity && !severity.includes(f.severity)) return false;\n    if (area && !area.includes(f.area)) return false;\n    return true;\n  });\n}\n\nfunction sortFindings(findings: AuditFinding[]): AuditFinding[] {\n  return [...findings].sort((a, b) => {\n    const sa = STATUS_RANK[a.status] - STATUS_RANK[b.status];\n    if (sa !== 0) return sa;\n    return SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity];\n  });\n}\n\n/**\n * Render the audit as a markdown table that mirrors\n * google-ads-playbook/10-audit-summary.md so the agent can drop it into a\n * client deliverable as-is.\n */\nfunction renderMarkdown(result: AuditResult): string {\n  const lines: string[] = [];\n  lines.push(`# LinkedIn Ads Audit — ${result.account.name} (${result.account.id})`);\n  lines.push(\"\");\n  lines.push(\n    `**Scope:** ${result.scope.campaigns} campaigns, ${result.scope.creatives} creatives, last ${result.scope.windowDays}d`,\n  );\n  lines.push(\"\");\n  lines.push(\n    `**Summary:** ${result.summary.pass} pass • ${result.summary.critical} critical • ${result.summary.high} high • ${result.summary.medium} medium • ${result.summary.low} low • ${result.summary.n_a} n/a (${result.summary.totalChecks} total)`,\n  );\n  lines.push(\"\");\n  lines.push(\"| # | Area | Check | Status | Severity | Notes |\");\n  lines.push(\"|---|------|-------|--------|----------|-------|\");\n  result.findings.forEach((f, idx) => {\n    const note = noteOf(f);\n    lines.push(\n      `| ${idx + 1} | ${f.area} | ${escapeMd(f.check)} | ${f.status.toUpperCase()} | ${f.severity} | ${escapeMd(note)} |`,\n    );\n  });\n  return lines.join(\"\\n\");\n}\n\nfunction escapeMd(text: string): string {\n  return text.replace(/\\|/g, \"\\\\|\").replace(/\\n/g, \" \");\n}\n\nfunction noteOf(f: AuditFinding): string {\n  if (f.status === \"pass\") return \"\";\n  const ev = f.evidence ? JSON.stringify(f.evidence) : \"\";\n  const fix = f.fix?.explanation ?? \"\";\n  return [fix, ev].filter(Boolean).join(\" — \");\n}\n\nexport const auditCommand = defineCommand({\n  meta: {\n    name: \"audit\",\n    description: `Run a LinkedIn Ads playbook audit — 30+ checks across Settings, Tracking,\nAudience, Campaigns, Creative, Performance, Bidding, and Compliance.\n\nEach finding has {id, area, check, status, severity, evidence, fix} fields with\nplaybook citations. The default JSON output is agent-friendly; --format md\nrenders a deliverable-ready table that mirrors the google-ads-playbook\n10-audit-summary.md style.\n\nExit code 0 always. Use the JSON 'summary' counts to decide if action is needed.\n\nExamples:\n  baker ads linkedin audit --account-id 503001492\n  baker ads linkedin audit --account-id 503001492 --campaign-id 1234        # narrow scope\n  baker ads linkedin audit --account-id 503001492 --window-days 90\n  baker ads linkedin audit --account-id 503001492 --severity critical,high\n  baker ads linkedin audit --account-id 503001492 --area Settings,Tracking\n  baker ads linkedin audit --account-id 503001492 --format md`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n    \"campaign-id\": { type: \"string\", description: \"Narrow scope to a single campaign\" },\n    \"window-days\": { type: \"string\", description: \"Lookback window for performance checks (default: 30)\" },\n    severity: { type: \"string\", description: \"CSV severity filter: critical,high,medium,low\" },\n    area: {\n      type: \"string\",\n      description:\n        \"CSV area filter: Settings,Tracking,Audience,Campaigns,Creative,Performance,Bidding,Compliance,Hygiene\",\n    },\n    format: { type: \"string\", description: \"Output format: json | md (default: json)\" },\n    \"no-cache\": NO_CACHE_ARG,\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    const windowDays = args[\"window-days\"] ? Number(args[\"window-days\"]) : 30;\n    if (!Number.isFinite(windowDays) || windowDays < 1 || windowDays > 365) {\n      handleLinkedinError(new Error(\"--window-days must be 1..365\"));\n    }\n    try {\n      const data = await apiPost<AuditResult>(\"/api/ads/linkedin/audit\", {\n        accountId,\n        campaignId: args[\"campaign-id\"] ? String(args[\"campaign-id\"]) : undefined,\n        windowDays,\n        skipCache: Boolean(args[\"no-cache\"]),\n      });\n\n      const severityFilter = (args.severity as string | undefined)\n        ?.split(\",\")\n        .map((s) => s.trim().toLowerCase())\n        .filter(Boolean);\n      const areaFilter = (args.area as string | undefined)\n        ?.split(\",\")\n        .map((s) => s.trim())\n        .filter(Boolean);\n      const filtered = filterFindings(data.findings, severityFilter, areaFilter);\n      const sorted = sortFindings(filtered);\n      const result: AuditResult = { ...data, findings: sorted };\n\n      const fmt = (args.format as string | undefined) ?? \"json\";\n      if (fmt === \"md\") {\n        process.stdout.write(`${renderMarkdown(result)}\\n`);\n        return;\n      }\n      writeAdsJson({ ok: true, data: result });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/autocomplete-SDDSJTAF.js

@@ -0,0 +1,112 @@
+import {
+  noSerpRowsHints
+} from "./chunk-SSTL3A7Z.js";
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-EGPYWJGZ.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-BDYLILMW.js";
+import "./chunk-SVM3DGAQ.js";
+import "./chunk-O37VU7FG.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema
+} from "./chunk-QANGHND7.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-SDDSJTAF.js.map

package/dist/autocomplete-SDDSJTAF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/autocomplete.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { buildResearchQueryContext, warnDefaults } from \"../../geo-context.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { noSerpRowsHints } from \"./hints.ts\";\nimport {\n  handleResearchError,\n  RESEARCH_DATA_NOTE,\n  writeResearchHints,\n  writeResearchJson,\n  writeResearchOutput,\n} from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.autocomplete\",\n  description:\n    \"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).\",\n  args: {\n    keyword: { type: \"string\", description: \"Seed keyword (positional)\", required: true },\n    location: {\n      type: \"string\",\n      description:\n        \"Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted\",\n      required: false,\n    },\n    language: {\n      type: \"string\",\n      description: \"Language code or name. Defaults to en (English) if omitted\",\n      required: false,\n    },\n    limit: { type: \"string\", description: \"Max suggestions (default: 10, max: 20)\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n});\n\ninterface AutocompleteResult {\n  suggestion: string;\n}\n\nconst FIELDS: Record<string, string> = {\n  suggestion: \"Autocomplete suggestion from Google\",\n};\n\nexport const autocompleteCommand = defineCommand({\n  meta: {\n    name: \"autocomplete\",\n    description: `Get Google Autocomplete suggestions for keyword expansion.\n\nExamples:\n  baker research autocomplete \"running shoes\"\n  baker research autocomplete \"crm\" --location uk --limit 5`,\n  },\n  args: {\n    keyword: { type: \"positional\", description: \"Seed keyword\", required: true },\n    location: { type: \"string\", description: \"Country code or location code (default: us)\", required: false },\n    language: { type: \"string\", description: \"Language code or name (default: en)\", required: false },\n    limit: { type: \"string\", description: \"Max suggestions (default: 10, max: 20)\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n  run: async ({ args }) => {\n    const keyword = args.keyword as string;\n    const location = (args.location as string) || undefined;\n    const language = (args.language as string) || undefined;\n    const limit = args.limit ? Number(args.limit) : undefined;\n    const skipCache = args[\"no-cache\"] ? true : undefined;\n    const queryContext = buildResearchQueryContext(location, language);\n\n    try {\n      const data = await apiPost<AutocompleteResult[]>(\"/api/research/autocomplete\", {\n        keyword,\n        location,\n        language,\n        limit,\n        skipCache,\n      });\n\n      warnDefaults(queryContext);\n      const format = (args.output as string) || \"json\";\n      const hints = noSerpRowsHints(data.length, queryContext);\n      if (format !== \"json\") {\n        writeResearchOutput(data as unknown as Array<Record<string, unknown>>, format);\n        writeResearchHints(hints, format);\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        data,\n        fields: FIELDS,\n        note: RESEARCH_DATA_NOTE,\n        query_context: queryContext,\n        hints,\n      });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAa9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,SAAS,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,KAAK;AAAA,IACpF,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,EAAE,MAAM,UAAU,aAAa,0CAA0C,UAAU,MAAM;AAAA,IAChG,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AACF,CAAC;AAMD,IAAM,SAAiC;AAAA,EACrC,YAAY;AACd;AAEO,IAAM,sBAAsB,cAAc;AAAA,EAC/C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,MAAM;AAAA,IACJ,SAAS,EAAE,MAAM,cAAc,aAAa,gBAAgB,UAAU,KAAK;AAAA,IAC3E,UAAU,EAAE,MAAM,UAAU,aAAa,+CAA+C,UAAU,MAAM;AAAA,IACxG,UAAU,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAChG,OAAO,EAAE,MAAM,UAAU,aAAa,0CAA0C,UAAU,MAAM;AAAA,IAChG,QAAQ,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,OAAO,SAAS,OAAO;AAAA,IACrG,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,UAAU,KAAK;AACrB,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,QAAQ,KAAK,QAAQ,OAAO,KAAK,KAAK,IAAI;AAChD,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO;AAC5C,UAAM,eAAe,0BAA0B,UAAU,QAAQ;AAEjE,QAAI;AACF,YAAM,OAAO,MAAM,QAA8B,8BAA8B;AAAA,QAC7E;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,mBAAa,YAAY;AACzB,YAAM,SAAU,KAAK,UAAqB;AAC1C,YAAM,QAAQ,gBAAgB,KAAK,QAAQ,YAAY;AACvD,UAAI,WAAW,QAAQ;AACrB,4BAAoB,MAAmD,MAAM;AAC7E,2BAAmB,OAAO,MAAM;AAChC;AAAA,MACF;AACA,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,QACA,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,eAAe;AAAA,QACf;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/avatars-I4H3NMEJ.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-G3E4NIKR.js").then((m) => m.listCommand),
+    get: () => import("./get-GDI2MOAU.js").then((m) => m.getCommand),
+    create: () => import("./create-DPQRYQXK.js").then((m) => m.createCommand),
+    research: () => import("./research-L25D4WHQ.js").then((m) => m.researchCommand),
+    update: () => import("./update-DOKS7ATM.js").then((m) => m.updateCommand),
+    delete: () => import("./delete-XBIME2H4.js").then((m) => m.deleteCommand)
+  }
+});
+export {
+  avatarsCommand
+};
+//# sourceMappingURL=avatars-I4H3NMEJ.js.map

package/dist/bid-pricing-OVYBDRMV.js

@@ -0,0 +1,101 @@
+import {
+  linkedinBidPricingRequestSchema
+} from "./chunk-RITUSBYO.js";
+import {
+  exitOnInvalidArgs,
+  handleLinkedinError,
+  loadTargetingArg,
+  resolveAccountIdArg
+} from "./chunk-2YTBPRRG.js";
+import {
+  writeAdsJson
+} from "./chunk-2VIZ4UUZ.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-U6RONIJC.js";
+import "./chunk-O37VU7FG.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/bid-pricing.ts
+import { defineCommand } from "citty";
+var FLAG_OF_FIELD = {
+  objectiveType: "--objective",
+  costType: "--cost-type",
+  campaignType: "--campaign-type",
+  targetingCriteria: "--targeting"
+};
+var bidPricingCommand = defineCommand({
+  meta: {
+    name: "bid-pricing",
+    description: `LinkedIn's suggested bid (min / default / max) for a targeting + objective + bid type \u2014 the same range Campaign Manager shows while building a campaign. Amounts are in the ad account's currency.
+
+Also returns the bid limits, LinkedIn's daily budget range, and the playbook \xA706 floor (2/3 of the suggested bid \u2014 the recommended manual CPC starting point). Feed the suggested bid into \`forecast --bid\` for the expected results.
+
+Objective types: BRAND_AWARENESS | WEBSITE_VISIT | ENGAGEMENT | VIDEO_VIEW |
+                 LEAD_GENERATION | WEBSITE_CONVERSION | JOB_APPLICANT | TALENT_LEAD
+Cost types:      CPC (default) | CPM | CPV
+
+Start here:
+  baker ads linkedin bid-pricing --account-id 503001492 --objective LEAD_GENERATION --targeting-file targeting.json
+  baker ads linkedin bid-pricing --account-id 503001492 --objective WEBSITE_VISIT --cost-type CPM --targeting '{"include":...}'`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    objective: {
+      type: "string",
+      description: "Objective type (e.g. LEAD_GENERATION, WEBSITE_VISIT)",
+      required: true
+    },
+    "cost-type": { type: "string", description: "CPC (default) | CPM | CPV", default: "CPC" },
+    "campaign-type": {
+      type: "string",
+      description: "SPONSORED_UPDATES (default, sponsored content) | SPONSORED_INMAILS | TEXT_AD",
+      default: "SPONSORED_UPDATES"
+    },
+    "audience-expansion": {
+      type: "boolean",
+      description: "Price with audience expansion on (default off, the playbook setting)",
+      default: false
+    },
+    targeting: { type: "string", description: "Inline JSON targetingCriteria" },
+    "targeting-file": { type: "string", description: "Path to JSON file with targetingCriteria" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const targetingCriteria = loadTargetingArg(args);
+    const parsed = linkedinBidPricingRequestSchema.safeParse({
+      accountId,
+      objectiveType: String(args.objective).toUpperCase(),
+      costType: String(args["cost-type"]).toUpperCase(),
+      campaignType: String(args["campaign-type"]).toUpperCase(),
+      matchType: args["audience-expansion"] ? "AUDIENCE_EXPANDED" : "EXACT",
+      targetingCriteria,
+      skipCache: Boolean(args["no-cache"])
+    });
+    if (!parsed.success) exitOnInvalidArgs(parsed.error.issues, FLAG_OF_FIELD);
+    try {
+      const data = await apiPost("/api/ads/linkedin/bid-pricing", parsed.data);
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  bidPricingCommand
+};
+//# sourceMappingURL=bid-pricing-OVYBDRMV.js.map

package/dist/bid-pricing-OVYBDRMV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/bid-pricing.ts"],"sourcesContent":["import { linkedinBidPricingRequestSchema } from \"@baker/api/ads-linkedin/planning\";\nimport { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport { exitOnInvalidArgs, handleLinkedinError, loadTargetingArg, resolveAccountIdArg } from \"./shared.ts\";\n\nconst FLAG_OF_FIELD: Record<string, string> = {\n  objectiveType: \"--objective\",\n  costType: \"--cost-type\",\n  campaignType: \"--campaign-type\",\n  targetingCriteria: \"--targeting\",\n};\n\ntype Money = { amount?: string; currencyCode?: string };\n\ninterface BidPricingResult {\n  bidLimits?: { min?: Money; max?: Money };\n  suggestedBid?: { min?: Money; default?: Money; max?: Money };\n  dailyBudgetLimits?: { min?: Money; default?: Money; max?: Money };\n  costType: string;\n  objectiveType: string;\n  campaignType: string;\n  matchType: string;\n  playbookFloor?: { amount: string; currencyCode: string };\n  playbookNote: string;\n}\n\nexport const bidPricingCommand = defineCommand({\n  meta: {\n    name: \"bid-pricing\",\n    description: `LinkedIn's suggested bid (min / default / max) for a targeting + objective + bid type — the same range Campaign Manager shows while building a campaign. Amounts are in the ad account's currency.\n\nAlso returns the bid limits, LinkedIn's daily budget range, and the playbook §06 floor (2/3 of the suggested bid — the recommended manual CPC starting point). Feed the suggested bid into \\`forecast --bid\\` for the expected results.\n\nObjective types: BRAND_AWARENESS | WEBSITE_VISIT | ENGAGEMENT | VIDEO_VIEW |\n                 LEAD_GENERATION | WEBSITE_CONVERSION | JOB_APPLICANT | TALENT_LEAD\nCost types:      CPC (default) | CPM | CPV\n\nStart here:\n  baker ads linkedin bid-pricing --account-id 503001492 --objective LEAD_GENERATION --targeting-file targeting.json\n  baker ads linkedin bid-pricing --account-id 503001492 --objective WEBSITE_VISIT --cost-type CPM --targeting '{\"include\":...}'`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n    objective: {\n      type: \"string\",\n      description: \"Objective type (e.g. LEAD_GENERATION, WEBSITE_VISIT)\",\n      required: true,\n    },\n    \"cost-type\": { type: \"string\", description: \"CPC (default) | CPM | CPV\", default: \"CPC\" },\n    \"campaign-type\": {\n      type: \"string\",\n      description: \"SPONSORED_UPDATES (default, sponsored content) | SPONSORED_INMAILS | TEXT_AD\",\n      default: \"SPONSORED_UPDATES\",\n    },\n    \"audience-expansion\": {\n      type: \"boolean\",\n      description: \"Price with audience expansion on (default off, the playbook setting)\",\n      default: false,\n    },\n    targeting: { type: \"string\", description: \"Inline JSON targetingCriteria\" },\n    \"targeting-file\": { type: \"string\", description: \"Path to JSON file with targetingCriteria\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"json\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    const targetingCriteria = loadTargetingArg(args);\n    const parsed = linkedinBidPricingRequestSchema.safeParse({\n      accountId,\n      objectiveType: String(args.objective).toUpperCase(),\n      costType: String(args[\"cost-type\"]).toUpperCase(),\n      campaignType: String(args[\"campaign-type\"]).toUpperCase(),\n      matchType: args[\"audience-expansion\"] ? \"AUDIENCE_EXPANDED\" : \"EXACT\",\n      targetingCriteria,\n      skipCache: Boolean(args[\"no-cache\"]),\n    });\n    if (!parsed.success) exitOnInvalidArgs(parsed.error.issues, FLAG_OF_FIELD);\n    try {\n      const data = await apiPost<BidPricingResult>(\"/api/ads/linkedin/bid-pricing\", parsed.data);\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,IAAM,gBAAwC;AAAA,EAC5C,eAAe;AAAA,EACf,UAAU;AAAA,EACV,cAAc;AAAA,EACd,mBAAmB;AACrB;AAgBO,IAAM,oBAAoB,cAAc;AAAA,EAC7C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,kDAAkD;AAAA,IAC/F,eAAe,EAAE,MAAM,UAAU,aAAa,yBAAyB;AAAA,IACvE,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,aAAa,EAAE,MAAM,UAAU,aAAa,6BAA6B,SAAS,MAAM;AAAA,IACxF,iBAAiB;AAAA,MACf,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA,sBAAsB;AAAA,MACpB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA,WAAW,EAAE,MAAM,UAAU,aAAa,gCAAgC;AAAA,IAC1E,kBAAkB,EAAE,MAAM,UAAU,aAAa,2CAA2C;AAAA,IAC5F,YAAY;AAAA,IACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,QAAQ,SAAS,OAAO;AAAA,EACjE;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,oBAAoB,IAAI;AAC1C,UAAM,oBAAoB,iBAAiB,IAAI;AAC/C,UAAM,SAAS,gCAAgC,UAAU;AAAA,MACvD;AAAA,MACA,eAAe,OAAO,KAAK,SAAS,EAAE,YAAY;AAAA,MAClD,UAAU,OAAO,KAAK,WAAW,CAAC,EAAE,YAAY;AAAA,MAChD,cAAc,OAAO,KAAK,eAAe,CAAC,EAAE,YAAY;AAAA,MACxD,WAAW,KAAK,oBAAoB,IAAI,sBAAsB;AAAA,MAC9D;AAAA,MACA,WAAW,QAAQ,KAAK,UAAU,CAAC;AAAA,IACrC,CAAC;AACD,QAAI,CAAC,OAAO,QAAS,mBAAkB,OAAO,MAAM,QAAQ,aAAa;AACzE,QAAI;AACF,YAAM,OAAO,MAAM,QAA0B,iCAAiC,OAAO,IAAI;AACzF,mBAAa,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACjC,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/brand-3V7ECY7D.js

@@ -0,0 +1,22 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/brand/index.ts
+import { defineCommand } from "citty";
+var brandCommand = defineCommand({
+  meta: {
+    name: "brand",
+    description: `Brand asset verification for src/brand/.
+
+Start here: \`baker brand fonts check\` after defining or editing the brand's typography.
+
+Subcommands:
+  baker brand fonts   \u2014 verify the brand's typefaces really load, and self-host them into src/brand/fonts/`
+  },
+  subCommands: {
+    fonts: () => import("./fonts-N42UYWTX.js").then((m) => m.fontsCommand)
+  }
+});
+export {
+  brandCommand
+};
+//# sourceMappingURL=brand-3V7ECY7D.js.map