@koda-sl/baker-cli 0.472.0 → 0.474.0

package/dist/chunk-TLOFNP4Q.js

@@ -0,0 +1,45 @@
+import {
+  ANALYTICS_BUSY_FIX,
+  isAnalyticsBusy
+} from "./chunk-BC2BXRXY.js";
+import {
+  ApiError
+} from "./chunk-JLCK7K6Y.js";
+
+// src/commands/analytics/errorEnvelope.ts
+import { z } from "zod";
+function analyticsErrorEnvelope(err) {
+  if (err instanceof ApiError) {
+    return isAnalyticsBusy(err.message) ? { code: err.code, message: err.message, fix: ANALYTICS_BUSY_FIX } : { code: err.code, message: err.message };
+  }
+  return { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" };
+}
+function requestErrorEnvelope(err, correction, correctsLocalInput) {
+  if (err instanceof z.ZodError || err instanceof SyntaxError) {
+    const message = err instanceof z.ZodError ? z.prettifyError(err) : err.message;
+    return { code: "VALIDATION_ERROR", message, ...correctsLocalInput ? { fix: correction } : {} };
+  }
+  const envelope = analyticsErrorEnvelope(err);
+  return envelope.code === "VALIDATION_ERROR" ? { ...envelope, fix: correction } : envelope;
+}
+function questionnaireErrorEnvelope(err) {
+  return requestErrorEnvelope(
+    err,
+    "Check baker analytics plan --full for missing app events. Resolve the named contract issue or narrow the observation window; never infer abandonment from completion totals.",
+    false
+  );
+}
+function trackingPlanErrorEnvelope(err) {
+  return requestErrorEnvelope(
+    err,
+    "Read baker analytics plan --full and baker tag-manager draft list to see what is prepared. Correct the request and repeat; do not publish until every requested installation is staged.",
+    true
+  );
+}
+
+export {
+  analyticsErrorEnvelope,
+  questionnaireErrorEnvelope,
+  trackingPlanErrorEnvelope
+};
+//# sourceMappingURL=chunk-TLOFNP4Q.js.map

package/dist/chunk-TMAZYRCW.js

@@ -0,0 +1,175 @@
+import {
+  handleConnectionError,
+  needsConnectionFix,
+  writeAdsJson
+} from "./chunk-CGOVXSSY.js";
+import {
+  LINKEDIN_SEARCH_STATUSES,
+  unsupportedLinkedinSearchStatuses
+} from "./chunk-RF5X37JC.js";
+import {
+  ApiError
+} from "./chunk-JLCK7K6Y.js";
+import {
+  MissingChatIdError,
+  getEnv
+} from "./chunk-G3UCXCC2.js";
+
+// src/commands/ads/linkedin/shared.ts
+var DAY_MS = 864e5;
+function handleLinkedinError(err) {
+  if (err instanceof ApiError) {
+    if (needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("linkedin_ads", err.message);
+    }
+    if (isNoAccountsSelectedError(err.code, err.message)) {
+      handleConnectionError("linkedin_ads", err.message);
+    }
+    const explanation = explainLinkedinError(err);
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: {
+          action: explanation.action,
+          explanation: explanation.message,
+          correctedCommand: explanation.correctedCommand
+        },
+        retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE" || err.code === "INTERNAL_ERROR"
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
+  }
+  writeAdsJson(unexpectedErrorEnvelope(err));
+  process.exit(1);
+}
+function unexpectedErrorEnvelope(err) {
+  if (err instanceof MissingChatIdError) {
+    return {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: {
+          action: "reject",
+          explanation: "LinkedIn changes are staged in a chat and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here."
+        },
+        retryable: false
+      }
+    };
+  }
+  const message = err instanceof Error ? err.message : "Unexpected error";
+  return { ok: false, error: { code: "NETWORK_ERROR", message } };
+}
+function isNoAccountsSelectedError(code, message) {
+  return code === "VALIDATION_ERROR" && /no linkedin ad accounts selected/i.test(message);
+}
+function explainLinkedinError(err) {
+  const lower = err.message.toLowerCase();
+  if (err.code === "VALIDATION_ERROR" && lower.includes("granularity") && lower.includes("daily")) {
+    return {
+      action: "retry_with_flag",
+      message: "LinkedIn rejects DAILY granularity when pivoting on demographic dims (job-title, company, etc.). Re-run with --granularity ALL or MONTHLY.",
+      correctedCommand: void 0
+    };
+  }
+  if (err.code === "RATE_LIMITED") {
+    return {
+      action: "wait_and_retry",
+      message: "Hit a LinkedIn throttle. The CLI already backs off automatically \u2014 if you see this you've exhausted the retry budget. Wait ~60s and retry."
+    };
+  }
+  if (err.code === "INTERNAL_ERROR" && lower.includes("deprecat")) {
+    return {
+      action: "reject",
+      message: "LinkedIn-Version header is deprecated. The backend constant LINKEDIN_API_VERSION needs to be bumped \u2014 file an issue or update the constant."
+    };
+  }
+  return { action: "reject", message: err.message };
+}
+var LI_ACCOUNT_ID_RE = /^(urn:li:sponsoredAccount:)?\d+$/;
+function resolveAccountIdArg(args) {
+  const fromArgs = args["account-id"] ?? args["account-urn"];
+  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;
+  if (!id) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "MISSING_ACCOUNT_ID",
+        message: "Pass --account-id (numeric) or --account-urn (urn:li:sponsoredAccount:N), or set BAKER_LINKEDIN_AD_ACCOUNT_ID. Run `baker ads linkedin accounts` to find IDs."
+      }
+    });
+    process.exit(1);
+  }
+  if (!LI_ACCOUNT_ID_RE.test(id)) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "INVALID_ACCOUNT_ID",
+        message: `Invalid LinkedIn account ID "${id}". Expected numeric or urn:li:sponsoredAccount:N.`
+      }
+    });
+    process.exit(1);
+  }
+  return id.startsWith("urn:") ? id.split(":").pop() ?? id : id;
+}
+function todayIso() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+function daysAgoIso(days) {
+  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);
+}
+function csvOrJson(args) {
+  return args.output ?? "json";
+}
+function statusesArgDescription(level) {
+  return `CSV of statuses (${LINKEDIN_SEARCH_STATUSES[level].join(",")})`;
+}
+function statusFilterError(level, statuses) {
+  const unsupported = unsupportedLinkedinSearchStatuses(level, statuses);
+  if (unsupported.length === 0) {
+    return null;
+  }
+  const accepted = LINKEDIN_SEARCH_STATUSES[level].join(",");
+  return {
+    ok: false,
+    error: {
+      code: "INVALID_STATUS",
+      message: `LinkedIn does not accept status ${unsupported.join(", ")} for this listing.`,
+      fix: {
+        action: "retry_with_flag",
+        explanation: `Re-run with --statuses from ${accepted}, or --all-statuses to drop the filter.`
+      },
+      retryable: false
+    }
+  };
+}
+function resolveStatusFilter(args, level) {
+  if (args["all-statuses"]) {
+    return void 0;
+  }
+  const explicit = args.statuses;
+  if (!explicit) {
+    return ["ACTIVE"];
+  }
+  const statuses = explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
+  const error = statusFilterError(level, statuses);
+  if (error) {
+    writeAdsJson(error);
+    process.exit(1);
+  }
+  return statuses;
+}
+
+export {
+  handleLinkedinError,
+  resolveAccountIdArg,
+  todayIso,
+  daysAgoIso,
+  csvOrJson,
+  statusesArgDescription,
+  resolveStatusFilter
+};
+//# sourceMappingURL=chunk-TMAZYRCW.js.map

package/dist/chunk-TUVS5SPF.js

@@ -0,0 +1,133 @@
+import {
+  IDEA_ANGLES,
+  IDEA_FORMATS,
+  checkIdeas,
+  coverageOf,
+  readCreativeRecords,
+  readIdeas,
+  readInsights,
+  readKnowledgeCorpus,
+  readPersonaIds,
+  sameMessageRead,
+  workspaceIdeasJudge
+} from "./chunk-P4UQBJNY.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-JQUPL6IQ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-IWLWY2UD.js";
+
+// src/commands/creatives/ideas.ts
+import { defineCommand } from "citty";
+var BUILD_NEXT = 3;
+var DESCRIPTION = `Check and rank the ad ideas in src/creatives/_ideas/: is each backed by something a customer said (src/content/insights/), does it claim only what the Knowledge holds, is it a different ad from the others, does it fill a gap the live ads leave. Free and local.
+
+Start here, after writing 4-8 idea files (one per file, eight fields: who, message, evidence, awareness, angle, format, job, why):
+  baker creatives ideas            # ranked, with problems; build_next names the ones to make
+  baker creatives make <idea>      # then build each one in build_next
+An idea with a problem is not built until it is fixed. An idea with no evidence is an explore bet: it may be built, and says so.`;
+var ARGS = {
+  full: {
+    type: "boolean",
+    description: "Every idea with its warnings and gaps, and the allowed angle and format values",
+    required: false,
+    default: false
+  }
+};
+registerSchema({ command: "creatives.ideas", description: DESCRIPTION, args: ARGS });
+function ideasHints(report) {
+  const hints = [];
+  const toBuild = report.ideas.filter((i) => i.status === "idea");
+  if (toBuild.length === 0 && report.unreadable.length === 0) {
+    hints.push(
+      "No ideas yet. Write 4-8 files in src/creatives/_ideas/<idea>.md (who, message, evidence, awareness, angle, format, job, why), then run this again."
+    );
+  }
+  if (report.unreadable.length > 0) {
+    hints.push(`Fix ${report.unreadable.map((u) => u.id).join(", ")}: each names what is missing or unknown.`);
+  }
+  const blocked = toBuild.filter((i) => i.problems.length > 0);
+  if (blocked.length > 0) hints.push(`Fix before building: ${blocked.map((i) => i.id).join(", ")}.`);
+  if (report.observedCount < 3) {
+    hints.push(
+      "Few customer quotes on file: run `baker research customers` so ideas stand on what customers said; until then they are explore bets."
+    );
+  } else if (toBuild.length > 0 && toBuild.every((i) => i.evidence === "explore")) {
+    hints.push("No idea cites an insight: put the insight ids that back each one in its `evidence`.");
+  }
+  const next = buildNext(report.ideas);
+  if (next.length === 1) hints.push(`Build: \`baker creatives make ${next[0]}\`.`);
+  if (next.length > 1)
+    hints.push(
+      `Build ${next.join(", ")} at once: one \`creative-producer\` per idea, all spawned in one message in the background, each given its idea id, and handle each as it returns. Never build them one after another: each render takes minutes. Edited an idea after this check? Run \`baker creatives ideas\` again first: a producer cannot build an idea with a problem.`
+    );
+  return hints;
+}
+function buildNext(ideas, count = BUILD_NEXT) {
+  const ready = ideas.filter((i) => i.status === "idea" && i.problems.length === 0);
+  const firstBet = ready.find((i) => i.evidence === "explore");
+  return ready.filter((i) => i.evidence !== "explore" || i === firstBet).slice(0, count).map((i) => i.id);
+}
+function compactIdea(check) {
+  return {
+    idea: check.id,
+    status: check.status,
+    evidence: check.evidence,
+    ...check.quote ? { quote: check.quote.length > 120 ? `${check.quote.slice(0, 117)}...` : check.quote } : {},
+    awareness: check.awareness,
+    angle: check.angle,
+    format: check.format,
+    ...check.problems.length > 0 ? { problems: check.problems } : {},
+    ...check.warnings.length > 0 ? { warnings: check.warnings } : {}
+  };
+}
+async function ideasReport(root, opts = {}) {
+  const judge = opts.ask ? { ask: opts.ask, done: () => Promise.resolve() } : workspaceIdeasJudge(root);
+  const [{ ideas, unreadable }, insights, knowledge, personas, creatives] = await Promise.all([
+    readIdeas(root),
+    readInsights(root, { ask: judge.ask }),
+    readKnowledgeCorpus(root),
+    readPersonaIds(root),
+    readCreativeRecords(root)
+  ]);
+  const sameMessage = await sameMessageRead(ideas, judge.ask);
+  await judge.done();
+  const checked = checkIdeas({ ideas, insights, knowledge, personas, sameMessage, ...coverageOf(ideas, creatives) });
+  return {
+    ideas: checked,
+    unreadable,
+    insightCount: insights.length,
+    observedCount: insights.filter((i) => i.status === "observed").length
+  };
+}
+var ideasCommand = defineCommand({
+  meta: { name: "ideas", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args }) {
+    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const report = await ideasReport(root);
+    const full = args.full === true;
+    writeJson({
+      ok: true,
+      data: {
+        build_next: buildNext(report.ideas),
+        ideas: full ? report.ideas : report.ideas.map(compactIdea),
+        ...report.unreadable.length > 0 ? { unreadable: report.unreadable } : {},
+        customer_quotes: { total: report.insightCount, observed: report.observedCount },
+        ...full ? { allowed: { angle: IDEA_ANGLES, format: IDEA_FORMATS } } : {}
+      },
+      hints: ideasHints(report)
+    });
+  }
+});
+
+export {
+  ideasHints,
+  buildNext,
+  compactIdea,
+  ideasReport,
+  ideasCommand
+};
+//# sourceMappingURL=chunk-TUVS5SPF.js.map

package/dist/chunk-TVKE3OXR.js

@@ -0,0 +1,76 @@
+import {
+  handleConnectionError,
+  isNotConnectedError,
+  writeAdsJson
+} from "./chunk-CGOVXSSY.js";
+import {
+  ApiError
+} from "./chunk-JLCK7K6Y.js";
+
+// src/commands/ads/google/service-read-errors.ts
+var KNOWN_REFUSALS = [
+  {
+    match: /BILLING_SETUP_NOT_ON_MONTHLY_INVOICING/,
+    code: "NOT_INVOICED",
+    message: "This account is not billed by monthly invoicing, so Google issues no invoices through the API.",
+    explanation: "Degrade, don't abort: the account pays automatically (card or bank), and its receipts are in Google Ads \u2192 Billing \u2192 Documents for the user to download. Spend itself is readable with `query --preset account-summary`. Carry on with the rest of the job."
+  },
+  {
+    match: /no approved billing setup/i,
+    code: "NO_BILLING_SETUP",
+    message: "This account has no approved billing setup, so it has no invoices.",
+    explanation: "Degrade, don't abort: nothing is billed to this account yet (or a manager account pays). Carry on with the rest of the job."
+  },
+  {
+    match: /BILLING_NOT_ON_MONTHLY_INVOICING|verification is only open to customers with billing setup for monthly invoicing/,
+    code: "VERIFICATION_NOT_READABLE",
+    message: "Google only reports advertiser verification through the API for accounts on monthly invoicing.",
+    explanation: "Degrade, don't abort: the status is in Google Ads \u2192 Billing \u2192 Advertiser verification, where the user can read it. Say that, and carry on with the rest of the job."
+  },
+  {
+    match: /UNSUPPORTED_AD_TYPE/,
+    code: "NO_PREVIEW_FOR_AD_TYPE",
+    message: "Google has no shareable preview for this ad type: --ads previews only video ads of Video campaigns, live on YouTube (search, display and Demand Gen ads answer unsupported).",
+    explanation: "Degrade, don't abort: preview a Performance Max campaign with --asset-groups, and describe any other ad from its copy (`ads list`, `query --preset ad-copy-performance`). Carry on with the rest of the job."
+  }
+];
+function serviceReadRefusal(message) {
+  const known = KNOWN_REFUSALS.find((refusal) => refusal.match.test(message));
+  if (!known) return null;
+  return {
+    ok: false,
+    error: {
+      code: known.code,
+      message: known.message,
+      fix: { action: "reject", explanation: known.explanation },
+      retryable: false
+    }
+  };
+}
+function exitWithServiceReadError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) handleConnectionError("google_ads", err.message);
+    writeAdsJson(
+      serviceReadRefusal(err.message) ?? {
+        ok: false,
+        error: {
+          code: err.code,
+          message: err.message,
+          fix: { action: "reject", explanation: err.message },
+          retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE"
+        }
+      }
+    );
+    process.exit(1);
+  }
+  writeAdsJson({
+    ok: false,
+    error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  });
+  process.exit(1);
+}
+
+export {
+  exitWithServiceReadError
+};
+//# sourceMappingURL=chunk-TVKE3OXR.js.map

package/dist/chunk-U6RTBCU7.js

@@ -0,0 +1,26 @@
+import {
+  DEFAULT_VIDEO_GENERATE_MODEL,
+  clipAudioMode,
+  spokenWordsIn
+} from "./chunk-2XQ5HU6D.js";
+
+// src/commands/studio/avatarModel.ts
+function pinnedModelHint(input) {
+  if (!input.avatar || !input.model) return null;
+  if (input.model === DEFAULT_VIDEO_GENERATE_MODEL) return null;
+  const speaks = input.generateAudio ?? true;
+  if (!speaks) return null;
+  return `You pinned --model ${input.model} on a speaking avatar. Without it this clip routes to ${DEFAULT_VIDEO_GENERATE_MODEL}, which was chosen for exactly this case: the better picture, both orientations, and audio always on. Drop --model unless the user asked for a specific one \u2014 and note ${input.model} may not take the length or the reference you are counting on.`;
+}
+function silentModelHint(model, prompt) {
+  if (!model || !prompt) return null;
+  if (clipAudioMode(model) !== "never") return null;
+  if (spokenWordsIn(prompt) === 0) return null;
+  return `${model} renders no audio \u2014 the line in this prompt will be mouthed and never heard. For a shot where someone speaks use ${DEFAULT_VIDEO_GENERATE_MODEL} (audio always on), or alibaba/wan-3.0 past 10 seconds. Keep this model for shots with no voice in them.`;
+}
+
+export {
+  pinnedModelHint,
+  silentModelHint
+};
+//# sourceMappingURL=chunk-U6RTBCU7.js.map

package/dist/chunk-UNHCWWAI.js

@@ -0,0 +1,111 @@
+import {
+  reportError,
+  splitList
+} from "./chunk-G3AOJ5FE.js";
+import {
+  apiGet
+} from "./chunk-JLCK7K6Y.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-IWLWY2UD.js";
+
+// src/commands/winning-ads/launches.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.launches",
+  description: 'What the brands you follow (or the ones named) launched in the last N days and which of those ads still run, each with its stage (new, testing, killed_early\u2026), and the tests each brand decided in that window (the version kept, what differed). The "what did competitors launch last week" report. Compact by default; --full lists every launch.',
+  args: {
+    since: { type: "number", description: "Days to look back, 1-90 (default 7)", required: false, default: 7 },
+    advertiser: {
+      type: "string",
+      description: "Comma list of advertiser ids instead of every followed brand",
+      required: false
+    },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    full: { type: "boolean", description: "List every launch", required: false, default: false }
+  }
+});
+var COMPACT_LAUNCHES = 10;
+function compactLaunches(report, full) {
+  return {
+    since_days: report.since_days,
+    advertisers: report.advertisers.map((b) => ({
+      advertiser_id: b.advertiser_id,
+      label: b.label,
+      launched: b.launched,
+      still_running: b.still_running,
+      launches: (full ? b.launches : b.launches.slice(0, COMPACT_LAUNCHES)).map((l) => ({
+        ad_id: l.ad_id,
+        platform: l.platform,
+        format: l.format,
+        headline: l.headline,
+        first_seen_at: l.first_seen_at,
+        stage: l.stage,
+        idea: l.idea ?? null,
+        ...full ? { media_url: l.media_url } : {}
+      })),
+      tests_decided: (b.tests_decided ?? []).map((t) => ({
+        concept: t.concept,
+        versions: t.versions,
+        kept_ad_id: t.winner_ad_id,
+        decided_at: t.decided_at ?? null,
+        what_differed: t.what_differed
+      }))
+    }))
+  };
+}
+var IDEA_HINT = "Idea: whether each launch was a `new` idea (the first day of its concept), another version of one the brand was still `testing`, or a version built on a `winner` it had already kept. Many launches and no new idea means the brand is iterating on what works, not testing new directions: say so.";
+function launchesHints(report, named) {
+  if (!named && report.following_count === 0) {
+    return ["You follow no brands yet: `baker winning-ads follow <domain>` adds one, or pass --advertiser <id>."];
+  }
+  if (report.advertisers.length === 0) {
+    return [`No launches in the last ${report.since_days} days. Widen the window with --since 30.`];
+  }
+  const withIdeas = report.advertisers.some((b) => b.launches.some((l) => l.idea));
+  return [
+    ...withIdeas ? [IDEA_HINT] : [],
+    "Stages: new \u22647 days, testing \u226421 days, proven \u226460 days, evergreen beyond, killed_early = stopped within 2 weeks (a lost test). tests_decided is what each brand learned in the window: the version it kept (kept_ad_id) and what differed. `baker winning-ads search --survived-test` finds the versions brands kept across the library."
+  ];
+}
+var launchesCommand = defineCommand({
+  meta: {
+    name: "launches",
+    description: "What competitors launched lately and what still runs. Start here: baker winning-ads launches --since 7 (every followed brand), or --advertiser adv_1,adv_2"
+  },
+  args: {
+    since: { type: "string", description: "Days to look back, 1-90 (default 7)", required: false },
+    advertiser: { type: "string", description: "Comma list of advertiser ids", required: false },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    full: { type: "boolean", description: "List every launch", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const named = splitList(args.advertiser);
+      const params = { since_days: String(args.since ?? 7) };
+      if (named.length > 0) {
+        params.advertiser = named.join(",");
+      }
+      if (args.platform) {
+        params.platform = String(args.platform);
+      }
+      const report = await apiGet("/api/ad-library/launches", params);
+      writeJson({
+        ok: true,
+        data: compactLaunches(report, Boolean(args.full)),
+        hints: launchesHints(report, named.length > 0)
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+
+export {
+  compactLaunches,
+  IDEA_HINT,
+  launchesHints,
+  launchesCommand
+};
+//# sourceMappingURL=chunk-UNHCWWAI.js.map