@koda-sl/baker-cli 0.490.0 → 0.492.0

package/dist/audiences-X3RLGOVM.js

@@ -1,84 +0,0 @@
-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/audit-YEGQU474.js

@@ -1,88 +0,0 @@
-import {
-  resolvePropertyId
-} from "./chunk-MPACDBH5.js";
-import {
-  cacheGet,
-  cacheSet,
-  handleConnectionError,
-  isNotConnectedError,
-  writeJsonEnvelope
-} from "./chunk-SWL4AAPP.js";
-import {
-  ApiError,
-  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/ga4/audit.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "ga4.audit",
-  description: "Run all GA4 admin health checks at once. Checks data retention, Google Ads linkage, phantom conversions, audience defaults, data streams, and attribution settings. Returns raw data plus playbook-aligned warnings.",
-  args: {
-    "property-id": { type: "string", description: "GA4 property ID (auto-resolved if not provided)", required: false },
-    "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
-  }
-});
-var auditCommand = defineCommand({
-  meta: {
-    name: "audit",
-    description: `Run all GA4 admin health checks. Returns property config with playbook warnings.
-
-Checks:
-  - Data retention (should be FOURTEEN_MONTHS)
-  - Google Ads linkage (must match audited account)
-  - Phantom conversions (page_view, scroll as conversions)
-  - Audience membership defaults (30-day B2B traps)
-  - Data streams and filters
-  - Attribution settings
-
-Examples:
-  baker ga4 audit
-  baker ga4 audit --property-id properties/123456789`
-  },
-  args: {
-    "property-id": { type: "string", description: "GA4 property ID", required: false },
-    "no-cache": { type: "boolean", description: "Skip cache", required: false }
-  },
-  run: async ({ args }) => {
-    const propertyId = await resolvePropertyId(args);
-    const useCache = !args["no-cache"];
-    const cacheKey = `audit:${propertyId}`;
-    if (useCache) {
-      const cached = cacheGet("ga4-audit", cacheKey);
-      if (cached) {
-        writeJsonEnvelope({ ...cached.data, cached: true });
-        return;
-      }
-    }
-    try {
-      const body = { propertyId };
-      if (!useCache) body.skipCache = true;
-      const data = await apiPost("/api/ga4/audit", body);
-      if (useCache) {
-        cacheSet("ga4-audit", cacheKey, data, 6 * 60 * 60 * 1e3);
-      }
-      writeJsonEnvelope(data);
-    } catch (err) {
-      if (err instanceof ApiError) {
-        if (isNotConnectedError(err.code, err.message)) {
-          handleConnectionError("ga4", err.message);
-        }
-        writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
-        process.exit(1);
-      }
-      writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
-      process.exit(1);
-    }
-  }
-});
-export {
-  auditCommand
-};
-//# sourceMappingURL=audit-YEGQU474.js.map

package/dist/audit-YY6X2MPA.js

@@ -1,151 +0,0 @@
-import {
-  handleLinkedinError,
-  resolveAccountIdArg
-} from "./chunk-5HJRZFMW.js";
-import {
-  writeAdsJson
-} from "./chunk-SWL4AAPP.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-K3TNTBZJ.js";
-import "./chunk-66QHX566.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-YY6X2MPA.js.map

package/dist/autocomplete-SAWJK4NF.js

@@ -1,111 +0,0 @@
-import {
-  noSerpRowsHints
-} from "./chunk-NEIUVSDK.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-66QHX566.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-SAWJK4NF.js.map

package/dist/avatars-YSFFRHDK.js

@@ -1,38 +0,0 @@
-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-KYBMFD32.js").then((m) => m.createCommand),
-    research: () => import("./research-U7RQXMYH.js").then((m) => m.researchCommand),
-    update: () => import("./update-GZFKHA3A.js").then((m) => m.updateCommand),
-    delete: () => import("./delete-2GIIUPA3.js").then((m) => m.deleteCommand)
-  }
-});
-export {
-  avatarsCommand
-};
-//# sourceMappingURL=avatars-YSFFRHDK.js.map

package/dist/bid-pricing-HZ74SLEB.js

@@ -1,100 +0,0 @@
-import {
-  linkedinBidPricingRequestSchema
-} from "./chunk-SISA4HQR.js";
-import {
-  exitOnInvalidArgs,
-  handleLinkedinError,
-  loadTargetingArg,
-  resolveAccountIdArg
-} from "./chunk-5HJRZFMW.js";
-import {
-  writeAdsJson
-} from "./chunk-SWL4AAPP.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-K3TNTBZJ.js";
-import "./chunk-66QHX566.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/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-HZ74SLEB.js.map

package/dist/brand-T3OACVQX.js

@@ -1,22 +0,0 @@
-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-7VWBQPJF.js").then((m) => m.fontsCommand)
-  }
-});
-export {
-  brandCommand
-};
-//# sourceMappingURL=brand-T3OACVQX.js.map