@koda-sl/baker-cli 0.525.0 → 0.527.0

package/dist/chunk-3N4SIGSG.js

@@ -1,111 +0,0 @@
-import {
-  reportError,
-  splitList
-} from "./chunk-6JACV223.js";
-import {
-  apiGet
-} from "./chunk-DPPV45D5.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-UCI6ZGUF.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-3N4SIGSG.js.map

package/dist/chunk-3VNW4CZF.js

@@ -1,76 +0,0 @@
-import {
-  MAX_REMOTE_IMAGE_BYTES,
-  fetchExternalBytes
-} from "./chunk-OMORXBRN.js";
-
-// src/lib/image/io.ts
-import { randomBytes } from "crypto";
-import { glob as fsGlob, readFile, rename, stat, writeFile } from "fs/promises";
-import { dirname, extname, join, resolve } from "path";
-var REMOTE_RE = /^https?:\/\//i;
-var GLOB_RE = /[*?[\]{}]/;
-function isRemoteUrl(value) {
-  return REMOTE_RE.test(value);
-}
-function looksLikeGlob(value) {
-  return GLOB_RE.test(value);
-}
-async function expandInputs(spec) {
-  const parts = spec.split(",").map((p) => p.trim()).filter(Boolean);
-  const out = [];
-  for (const part of parts) {
-    if (isRemoteUrl(part)) {
-      out.push(part);
-      continue;
-    }
-    if (looksLikeGlob(part)) {
-      for await (const match of fsGlob(part)) {
-        if (typeof match === "string") out.push(match);
-      }
-    } else {
-      out.push(part);
-    }
-  }
-  return out;
-}
-async function readImageBuffer(pathOrUrl) {
-  if (isRemoteUrl(pathOrUrl)) {
-    const { buffer } = await fetchExternalBytes(pathOrUrl, { maxBytes: MAX_REMOTE_IMAGE_BYTES });
-    return buffer;
-  }
-  return readFile(pathOrUrl);
-}
-async function isDirectory(path) {
-  try {
-    const s = await stat(path);
-    return s.isDirectory();
-  } catch {
-    return false;
-  }
-}
-async function resolveOutputPath(inputPath, outputArg, options) {
-  const base = options.newExtension ? inputPath.slice(0, -extname(inputPath).length) + options.newExtension : inputPath;
-  if (!outputArg) return base;
-  if (options.multipleInputs || await isDirectory(outputArg)) {
-    const filename = base.split("/").pop() ?? "out.png";
-    return join(outputArg, filename);
-  }
-  return outputArg;
-}
-async function atomicWrite(targetPath, data) {
-  const absolute = resolve(targetPath);
-  const dir = dirname(absolute);
-  const tmp = join(dir, `.baker-image-${randomBytes(8).toString("hex")}.tmp`);
-  await writeFile(tmp, data);
-  await rename(tmp, absolute);
-}
-
-export {
-  isRemoteUrl,
-  expandInputs,
-  readImageBuffer,
-  isDirectory,
-  resolveOutputPath,
-  atomicWrite
-};
-//# sourceMappingURL=chunk-3VNW4CZF.js.map

package/dist/chunk-42YZYRDP.js

@@ -1,163 +0,0 @@
-import {
-  failApi
-} from "./chunk-VFDV7VH3.js";
-import {
-  CREATIVE_PERFORMANCE_DEFAULT_DAYS,
-  CREATIVE_PERFORMANCE_MAX_DAYS
-} from "./chunk-HVJJEQDQ.js";
-import {
-  apiPost
-} from "./chunk-DPPV45D5.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-UCI6ZGUF.js";
-
-// src/commands/creatives/performance.ts
-import { readFileSync } from "fs";
-import path from "path";
-import { defineCommand } from "citty";
-import { parse as parseYaml } from "yaml";
-var DESCRIPTION = `How each Baker creative is doing in the live Meta ads that show it: spend, impressions, CTR, CPC, results, cost per result, frequency and a fatigue verdict, next to the angle, hook, mechanism and dominant slot its definition set out to test. Video creatives add hookRate (percent of impressions that watched 3 seconds) and holdRate (percent of those that reached a ThruPlay). Use it before briefing new creatives, to learn which angle and mechanism to make next and which creatives to replace.
-
-Start here:
-  baker creatives performance                      # every creative in an ad, last 30 days
-  baker creatives performance --slug spring-offer  # one creative
-  baker creatives performance --days 14 --full     # ids, last-7-day figures, a video's watch funnel, one row per ad
-
-Fatigue follows the Meta playbook (07-creative-audit.md): fresh, fading, fatigued, dead, or too_early (under 14 days or 1,000 impressions) and no_delivery. A low hook rate means the first 3 seconds need new hooks; a working hook with a low hold rate means the body loses people. A creative counts once a Session's publish created an ad with it.`;
-var ARGS = {
-  slug: { type: "string", description: "Only this creative (src/creatives/<slug>/)", required: false },
-  days: {
-    type: "string",
-    description: `Reporting window in days, ending today (1-${CREATIVE_PERFORMANCE_MAX_DAYS}, default ${CREATIVE_PERFORMANCE_DEFAULT_DAYS})`,
-    required: false
-  },
-  full: {
-    type: "boolean",
-    description: "Add ids, last-7-day CTR and cost per result, and one row per ad",
-    required: false,
-    default: false
-  }
-};
-registerSchema({ command: "creatives.performance", description: DESCRIPTION, args: ARGS });
-var INSIGHT_KEYS = [
-  "idea",
-  "message",
-  "evidence",
-  "angle",
-  "hook",
-  "mechanism",
-  "dominantSlot",
-  "persona",
-  "awareness",
-  "hypothesis"
-];
-var FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---/;
-function insightValue(value) {
-  if (typeof value === "string") return value.trim() || null;
-  if (typeof value === "number" || typeof value === "boolean") return String(value);
-  return null;
-}
-function definitionInsights(markdown) {
-  const block = FRONTMATTER.exec(markdown)?.[1];
-  if (!block) return null;
-  let parsed;
-  try {
-    parsed = parseYaml(block);
-  } catch {
-    return null;
-  }
-  if (parsed === null || typeof parsed !== "object") return null;
-  const insights = {};
-  for (const [key, raw] of Object.entries(parsed)) {
-    if (!(INSIGHT_KEYS.includes(key) || key.startsWith("source") || key.startsWith("reference"))) continue;
-    const value = insightValue(raw);
-    if (value !== null) insights[key] = value;
-  }
-  return Object.keys(insights).length > 0 ? insights : null;
-}
-function readLocalDefinition(slug) {
-  try {
-    return readFileSync(path.join(process.cwd(), "src", "creatives", slug, "_definition.md"), "utf8");
-  } catch {
-    return null;
-  }
-}
-var COMPARED_FIELDS = [
-  { key: "angle", label: "angle", advice: "Brief the next creative on the cheapest angle with a new hook." },
-  { key: "mechanism", label: "mechanism", advice: "Brief the next creative on the cheapest mechanism." },
-  { key: "dominantSlot", label: "dominant slot", advice: "Lead the next creative with the cheapest dominant slot." }
-];
-function cheapestHint(creatives, { key, label, advice }) {
-  const byValue = /* @__PURE__ */ new Map();
-  for (const creative of creatives) {
-    const value = creative.definition?.[key];
-    if (!value || creative.costPerResult === null) continue;
-    const best = byValue.get(value);
-    if (!best || (best.costPerResult ?? Number.POSITIVE_INFINITY) > creative.costPerResult)
-      byValue.set(value, creative);
-  }
-  if (byValue.size < 2) return null;
-  const ranked = [...byValue.entries()].sort(([, a], [, b]) => (a.costPerResult ?? 0) - (b.costPerResult ?? 0)).map(
-    ([value, creative]) => `"${value}" ${creative.costPerResult}${creative.currency ? ` ${creative.currency}` : ""} (${creative.slug ?? creative.title})`
-  );
-  return `Cost per result by ${label}: ${ranked.join(", ")}. ${advice}`;
-}
-function withDefinitions(response, readDefinition) {
-  const creatives = response.data.creatives.map((creative) => {
-    const markdown = creative.slug ? readDefinition(creative.slug) : null;
-    const definition = markdown ? definitionInsights(markdown) : null;
-    return definition ? { ...creative, definition } : creative;
-  });
-  const hints = [...response.hints ?? []];
-  for (const field of COMPARED_FIELDS) {
-    const hint = cheapestHint(creatives, field);
-    if (hint) hints.push(hint);
-  }
-  const unnamed = creatives.filter((creative) => !creative.definition?.angle).map((c) => c.slug ?? c.title);
-  if (unnamed.length > 0) {
-    hints.push(
-      `No angle recorded for: ${unnamed.join(", ")}. Add angle and hook to src/creatives/<slug>/_definition.md so results show which angle works.`
-    );
-  }
-  return { ...response, data: { ...response.data, creatives }, ...hints.length > 0 ? { hints } : {} };
-}
-function syncedCreativesHint(slug) {
-  return `Live Meta read. Across every platform, from the synced copy (no rate limit, full history): baker ads performance creatives ranks them against their ad-group peers (madeInBaker names this creative), and baker ads performance live-in --creative ${slug ?? "<slug>"} lists the live campaigns showing it.`;
-}
-function parseDays(raw) {
-  if (raw === void 0) return void 0;
-  const days = Number(raw);
-  if (!Number.isInteger(days) || days < 1 || days > CREATIVE_PERFORMANCE_MAX_DAYS) {
-    throw new Error(`--days must be a whole number from 1 to ${CREATIVE_PERFORMANCE_MAX_DAYS}`);
-  }
-  return days;
-}
-var performanceCommand = defineCommand({
-  meta: { name: "performance", description: DESCRIPTION },
-  args: ARGS,
-  run: async ({ args }) => {
-    try {
-      const body = {};
-      const slug = args.slug;
-      if (slug) body.slug = slug;
-      const days = parseDays(args.days);
-      if (days !== void 0) body.days = days;
-      if (args.full) body.full = true;
-      const response = await apiPost("/api/creatives/performance", body);
-      const out = withDefinitions(response, readLocalDefinition);
-      writeJson({ ...out, hints: [...out.hints ?? [], syncedCreativesHint(slug)] });
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-
-export {
-  definitionInsights,
-  withDefinitions,
-  parseDays,
-  performanceCommand
-};
-//# sourceMappingURL=chunk-42YZYRDP.js.map

package/dist/chunk-47A4XF27.js

@@ -1,175 +0,0 @@
-import {
-  termsRefusalFix
-} from "./chunk-QALAJNBG.js";
-import {
-  handleConnectionError,
-  isOrganizationReadRefusal,
-  needsConnectionFix,
-  writeAdsJson,
-  writeJsonEnvelope
-} from "./chunk-OJQBHX5Z.js";
-import {
-  ApiError
-} from "./chunk-DPPV45D5.js";
-import {
-  getEnv
-} from "./chunk-ABXVFHTG.js";
-
-// ../api/src/ads-meta/permissionGates.ts
-var META_PERMISSION_NOT_ENABLED_MESSAGE = {
-  catalog: "Catalog changes need the Catalog permission for Meta \u2014 ask a Baker admin to turn it on, then reconnect Meta. Everything else on Meta keeps working: tell the user, and carry on with the rest of the job.",
-  pagePosts: "Facebook Page posts need the Page posts permission for Meta \u2014 ask a Baker admin to turn it on, then reconnect Meta. Everything else on Meta keeps working: tell the user, and carry on with the rest of the job."
-};
-var META_PERMISSION_RECONNECT_MESSAGE = {
-  catalog: "Catalog changes need the Catalog permission for Meta. It is turned on for this company, but this Meta connection was made before, so it does not hold it \u2014 ask the user to reconnect Meta in the dashboard, then try again. Everything else on Meta keeps working meanwhile.",
-  pagePosts: "Facebook Page posts need the Page posts permission for Meta. It is turned on for this company, but this Meta connection was made before, so it does not hold it \u2014 ask the user to reconnect Meta in the dashboard, then try again. Everything else on Meta keeps working meanwhile."
-};
-var META_UNREQUESTED_PERMISSION_MESSAGE = {
-  comments: "Reading and moderating comments on ads needs Meta permissions Baker's Meta connection does not ask for yet (reading people's comments and managing them on the Page). Tell the user that comment moderation happens in Meta Business Suite for now, and carry on with the rest of the job.",
-  instagramMedia: "Listing an Instagram account's posts needs a Meta permission Baker's Meta connection does not ask for yet. Ask the user for the post's link or id instead, or boost it from Meta Business Suite, and carry on."
-};
-var META_PAGE_ADS_PERMISSION_REMEDY = "A Baker admin turns it on with the lead ads switch for this company; then the user reconnects Meta in the dashboard. Tell the user, and carry on with the rest of the job.";
-function isMetaPermissionGateRefusal(message) {
-  return [
-    ...Object.values(META_PERMISSION_NOT_ENABLED_MESSAGE),
-    ...Object.values(META_PERMISSION_RECONNECT_MESSAGE),
-    ...Object.values(META_UNREQUESTED_PERMISSION_MESSAGE),
-    META_PAGE_ADS_PERMISSION_REMEDY
-  ].some((refusal) => message.includes(refusal));
-}
-
-// src/commands/ads/meta/shared.ts
-var DAY_MS = 864e5;
-function metaForbiddenFix(message) {
-  if (isMetaPermissionGateRefusal(message)) {
-    return { action: "reject", explanation: message };
-  }
-  if (message.includes("has not accepted Meta's Lead Generation Terms")) {
-    return {
-      action: "reject",
-      explanation: `${message}
-
-Meta confirmed the Page's terms status using its Page access. Give the Page owner the terms link in the error and ask them to accept it before trying the form or lead ad set again. Do not suggest reconnecting Meta for this refusal; continue with other work that does not require the form or ad set.`
-    };
-  }
-  return {
-    action: "reject",
-    explanation: [
-      message,
-      "This is a permission refusal, not a dead connection, and Meta returns the same code for two causes with opposite remedies. Tell them apart by how much else works before you answer.",
-      "If other reads on this account are ALSO refused (campaigns, ad sets, insights), the connection is short a permission it was never granted. Only the user can widen it, by reconnecting Meta from the dashboard.",
-      "If those reads work and only this object is refused, the asset (pixel/dataset, Page, or catalog) belongs to a Business the connected user holds no role in. Ad-account access does not carry asset access and reconnecting cannot grant it \u2014 the client assigns that asset to the connected user or partner in Meta Business settings, under the asset's own section (Data sources \u2192 Datasets for a pixel).",
-      "Either way do not retry the same call, and do not abort the wider job. Continue with what you can read, and state in your answer that this specific check could not run and why \u2014 never present the task as verified when this step was skipped."
-    ].join("\n\n")
-  };
-}
-function handleMetaError(err) {
-  if (err instanceof ApiError) {
-    if (needsConnectionFix(err.code, err.message)) {
-      handleConnectionError("meta_ads", err.message);
-    }
-    const terms = termsRefusalFix(err.code, err.message);
-    if (terms) {
-      writeJsonEnvelope({
-        ok: false,
-        error: { code: terms.code, message: err.message, fix: terms.fix, retryable: false }
-      });
-      process.exit(1);
-    }
-    const envelope = {
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        fix: err.code === "FORBIDDEN" && !isOrganizationReadRefusal(err.message) ? metaForbiddenFix(err.message) : { action: "reject", explanation: err.message },
-        retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE" || err.code === "INTERNAL_ERROR"
-      }
-    };
-    writeAdsJson(envelope);
-    process.exit(1);
-  }
-  const message = err instanceof Error ? err.message : "Unexpected error";
-  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message } });
-  process.exit(1);
-}
-var ACCOUNT_ID_RE = /^(act_)?[0-9]+$/;
-function resolveAccountIdArg(args) {
-  const fromArgs = args["account-id"];
-  const id = fromArgs || getEnv().BAKER_META_AD_ACCOUNT_ID;
-  if (!id) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "MISSING_ACCOUNT_ID",
-        message: "Pass --account-id or set BAKER_META_AD_ACCOUNT_ID. Run `baker ads meta accounts` to find IDs."
-      }
-    });
-    process.exit(1);
-  }
-  if (!ACCOUNT_ID_RE.test(id)) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "INVALID_ACCOUNT_ID",
-        message: `Invalid account ID "${id}". Expected numeric ID, optionally prefixed with "act_".`
-      }
-    });
-    process.exit(1);
-  }
-  return id.startsWith("act_") ? id : `act_${id}`;
-}
-function getDateRange(args) {
-  const datePreset = args["date-preset"];
-  const since = args.since;
-  const until = args.until;
-  if (since && until) return { since, until };
-  return { datePreset: datePreset ?? "last_7d" };
-}
-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";
-}
-var NAME_CONTAINS_ARG = {
-  type: "string",
-  description: "Only rows whose name contains this text, matched by Meta before anything is returned. Start here to find one entity by name: --name-contains octubre --all-statuses"
-};
-function resolveEffectiveStatus(args) {
-  if (args["all-statuses"]) {
-    return void 0;
-  }
-  const explicit = args["effective-status"];
-  if (explicit) {
-    return explicit;
-  }
-  return "ACTIVE";
-}
-function statusFilterHints(rows, effectiveStatus, noun) {
-  if (rows.length > 0 || effectiveStatus === void 0) return [];
-  if (effectiveStatus === "ACTIVE") {
-    return [
-      `No ACTIVE ${noun}. The ACTIVE filter hides paused, archived and in-review ones (under a paused campaign or ad set that is all of them), so this does NOT mean none exist. Re-run with --all-statuses before concluding there are none.`
-    ];
-  }
-  return [
-    `No ${noun} with effective_status ${effectiveStatus}. Re-run with --all-statuses to see every status before concluding there are none.`
-  ];
-}
-
-export {
-  metaForbiddenFix,
-  handleMetaError,
-  resolveAccountIdArg,
-  getDateRange,
-  todayIso,
-  daysAgoIso,
-  csvOrJson,
-  NAME_CONTAINS_ARG,
-  resolveEffectiveStatus,
-  statusFilterHints
-};
-//# sourceMappingURL=chunk-47A4XF27.js.map

package/dist/chunk-47A4XF27.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../api/src/ads-meta/permissionGates.ts","../src/commands/ads/meta/shared.ts"],"sourcesContent":["/**\n * The refusals Baker writes for Meta work that needs a permission the baseline\n * connection does not ask for — managing catalogs (`catalog_management`) and\n * posting to a Facebook Page (`pages_manage_posts`). Shared verbatim by the\n * backend that throws them and the CLI that explains them, for the same reason\n * as `leadAds.ts`: these name their own cause and remedy, so the CLI must not\n * append Meta's ambiguous \"maybe reconnect, maybe an unassigned asset\" advice.\n */\n\nexport type MetaPermissionGate = \"catalog\" | \"pagePosts\";\n\n/** Everything a person or the agent can see about one per-company Meta permission. */\nexport interface MetaPermissionState {\n  /** A Baker admin switched it on for this company, so the consent screen asks for it. */\n  enabled: boolean;\n  /** The current Meta connection holds it. */\n  granted: boolean;\n  /** Switched on, but the connection predates it — reconnecting Meta is the fix. */\n  reconnectNeeded: boolean;\n}\n\nexport type MetaPermissionStates = Record<\"leadAds\" | MetaPermissionGate, MetaPermissionState>;\n\nexport const META_PERMISSION_NOT_ENABLED_MESSAGE: Record<MetaPermissionGate, string> = {\n  catalog:\n    \"Catalog changes need the Catalog permission for Meta — ask a Baker admin to turn it on, then reconnect Meta. \" +\n    \"Everything else on Meta keeps working: tell the user, and carry on with the rest of the job.\",\n  pagePosts:\n    \"Facebook Page posts need the Page posts permission for Meta — ask a Baker admin to turn it on, then reconnect \" +\n    \"Meta. Everything else on Meta keeps working: tell the user, and carry on with the rest of the job.\",\n};\n\nexport const META_PERMISSION_RECONNECT_MESSAGE: Record<MetaPermissionGate, string> = {\n  catalog:\n    \"Catalog changes need the Catalog permission for Meta. It is turned on for this company, but this Meta \" +\n    \"connection was made before, so it does not hold it — ask the user to reconnect Meta in the dashboard, then \" +\n    \"try again. Everything else on Meta keeps working meanwhile.\",\n  pagePosts:\n    \"Facebook Page posts need the Page posts permission for Meta. It is turned on for this company, but this Meta \" +\n    \"connection was made before, so it does not hold it — ask the user to reconnect Meta in the dashboard, then \" +\n    \"try again. Everything else on Meta keeps working meanwhile.\",\n};\n\n/**\n * Work that needs a Meta permission Baker's connection does not ask for at all\n * (no switch turns it on): reading and moderating comments on ads\n * (`pages_read_user_content`, `pages_manage_engagement`) and listing an\n * Instagram account's posts (`instagram_basic`). Live on v26.0 (2026-10-15)\n * Meta refused both with code 10.\n */\nexport const META_UNREQUESTED_PERMISSION_MESSAGE = {\n  comments:\n    \"Reading and moderating comments on ads needs Meta permissions Baker's Meta connection does not ask for yet \" +\n    \"(reading people's comments and managing them on the Page). Tell the user that comment moderation happens in \" +\n    \"Meta Business Suite for now, and carry on with the rest of the job.\",\n  instagramMedia:\n    \"Listing an Instagram account's posts needs a Meta permission Baker's Meta connection does not ask for yet. \" +\n    \"Ask the user for the post's link or id instead, or boost it from Meta Business Suite, and carry on.\",\n} as const;\n\nconst META_PAGE_ADS_PERMISSION_REMEDY =\n  \"A Baker admin turns it on with the lead ads switch for this company; then the user reconnects Meta in the dashboard. \" +\n  \"Tell the user, and carry on with the rest of the job.\";\n\n/**\n * Click-to-message ads and Instant Experiences need Meta's Page ads permission\n * (`pages_manage_ads`), which only the lead ads switch adds to the consent\n * screen. `work` names what was refused (\"Click-to-message ads\").\n */\nexport function metaPageAdsPermissionMessage(work: string): string {\n  return `${work} need Meta's Page ads permission, and this Meta connection does not have it. ${META_PAGE_ADS_PERMISSION_REMEDY}`;\n}\n\n/**\n * Whether a `FORBIDDEN` message carries one of these refusals. `includes`, not\n * equality: a stage-time refusal may lead with what the op was trying to do.\n */\nexport function isMetaPermissionGateRefusal(message: string): boolean {\n  return [\n    ...Object.values(META_PERMISSION_NOT_ENABLED_MESSAGE),\n    ...Object.values(META_PERMISSION_RECONNECT_MESSAGE),\n    ...Object.values(META_UNREQUESTED_PERMISSION_MESSAGE),\n    META_PAGE_ADS_PERMISSION_REMEDY,\n  ].some((refusal) => message.includes(refusal));\n}\n","import { isMetaPermissionGateRefusal } from \"@baker/api/ads-meta/permissionGates\";\nimport { ApiError } from \"../../../client.ts\";\nimport { getEnv } from \"../../../env.ts\";\nimport { handleConnectionError, isOrganizationReadRefusal, needsConnectionFix } from \"../../../error-handler.ts\";\nimport { writeAdsJson, writeJsonEnvelope } from \"../output.ts\";\nimport { termsRefusalFix } from \"../terms-output.ts\";\nimport type { AdsErrorEnvelope, QueryFix } from \"../types.ts\";\n\nconst DAY_MS = 86_400_000;\n\n/**\n * Meta answers a permission refusal (Graph codes 200/10/294) with a bare\n * \"Permissions error\" that covers two causes needing opposite remedies: a\n * consent grant the connection never got — nothing validates Meta's granted\n * scopes after connect, unlike HubSpot's `requireCapability` — or a role the\n * user lacks on one asset, since a Pixel/Dataset, Page or catalog lives in a\n * Business and is assigned separately from the ad account. Only the blast radius\n * separates them, so hand the agent that test rather than a verdict: guessing\n * \"reconnect\" wastes the user's time on an unassigned asset, and ruling it out\n * strands a connection that really is short a scope.\n */\nexport function metaForbiddenFix(message: string): QueryFix {\n  // Baker's own refusal already names the switch or the reconnect; Meta's\n  // two-cause advice under it would contradict it.\n  if (isMetaPermissionGateRefusal(message)) {\n    return { action: \"reject\", explanation: message };\n  }\n  if (message.includes(\"has not accepted Meta's Lead Generation Terms\")) {\n    return {\n      action: \"reject\",\n      explanation: `${message}\\n\\nMeta confirmed the Page's terms status using its Page access. Give the Page owner the terms link in the error and ask them to accept it before trying the form or lead ad set again. Do not suggest reconnecting Meta for this refusal; continue with other work that does not require the form or ad set.`,\n    };\n  }\n  return {\n    action: \"reject\",\n    explanation: [\n      message,\n      \"This is a permission refusal, not a dead connection, and Meta returns the same code for two causes with opposite remedies. Tell them apart by how much else works before you answer.\",\n      \"If other reads on this account are ALSO refused (campaigns, ad sets, insights), the connection is short a permission it was never granted. Only the user can widen it, by reconnecting Meta from the dashboard.\",\n      \"If those reads work and only this object is refused, the asset (pixel/dataset, Page, or catalog) belongs to a Business the connected user holds no role in. Ad-account access does not carry asset access and reconnecting cannot grant it — the client assigns that asset to the connected user or partner in Meta Business settings, under the asset's own section (Data sources → Datasets for a pixel).\",\n      \"Either way do not retry the same call, and do not abort the wider job. Continue with what you can read, and state in your answer that this specific check could not run and why — never present the task as verified when this step was skipped.\",\n    ].join(\"\\n\\n\"),\n  };\n}\n\nexport function handleMetaError(err: unknown): never {\n  if (err instanceof ApiError) {\n    if (needsConnectionFix(err.code, err.message)) {\n      handleConnectionError(\"meta_ads\", err.message);\n    }\n    const terms = termsRefusalFix(err.code, err.message);\n    if (terms) {\n      writeJsonEnvelope({\n        ok: false,\n        error: { code: terms.code, message: err.message, fix: terms.fix, retryable: false },\n      });\n      process.exit(1);\n    }\n    const envelope: AdsErrorEnvelope = {\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix:\n          err.code === \"FORBIDDEN\" && !isOrganizationReadRefusal(err.message)\n            ? metaForbiddenFix(err.message)\n            : { action: \"reject\", explanation: err.message },\n        retryable: err.code === \"RATE_LIMITED\" || err.code === \"UNAVAILABLE\" || err.code === \"INTERNAL_ERROR\",\n      },\n    };\n    writeAdsJson(envelope);\n    process.exit(1);\n  }\n  const message = err instanceof Error ? err.message : \"Unexpected error\";\n  writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message } });\n  process.exit(1);\n}\n\nconst ACCOUNT_ID_RE = /^(act_)?[0-9]+$/;\n\n/** Pull the default Meta ad account ID from `--account-id` arg or `BAKER_META_AD_ACCOUNT_ID` env. */\nexport function resolveAccountIdArg(args: Record<string, unknown>): string {\n  const fromArgs = args[\"account-id\"] as string | undefined;\n  const id = fromArgs || getEnv().BAKER_META_AD_ACCOUNT_ID;\n  if (!id) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"MISSING_ACCOUNT_ID\",\n        message: \"Pass --account-id or set BAKER_META_AD_ACCOUNT_ID. Run `baker ads meta accounts` to find IDs.\",\n      },\n    });\n    process.exit(1);\n  }\n  if (!ACCOUNT_ID_RE.test(id)) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"INVALID_ACCOUNT_ID\",\n        message: `Invalid account ID \"${id}\". Expected numeric ID, optionally prefixed with \"act_\".`,\n      },\n    });\n    process.exit(1);\n  }\n  return id.startsWith(\"act_\") ? id : `act_${id}`;\n}\n\nexport function getDateRange(args: Record<string, unknown>): { datePreset?: string; since?: string; until?: string } {\n  const datePreset = args[\"date-preset\"] as string | undefined;\n  const since = args.since as string | undefined;\n  const until = args.until as string | undefined;\n  if (since && until) return { since, until };\n  return { datePreset: datePreset ?? \"last_7d\" };\n}\n\nexport function todayIso(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n\nexport function daysAgoIso(days: number): string {\n  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);\n}\n\nexport function csvOrJson(args: Record<string, unknown>): string {\n  return (args.output as string | undefined) ?? \"json\";\n}\n\n/**\n * Matched by Meta itself, so finding one entity by name reads only the rows that\n * match instead of the whole account.\n */\nexport const NAME_CONTAINS_ARG = {\n  type: \"string\",\n  description:\n    \"Only rows whose name contains this text, matched by Meta before anything is returned. Start here to find one entity by name: --name-contains octubre --all-statuses\",\n} as const;\n\n/**\n * Default to ACTIVE-only on listings — that's almost always what an AI agent or\n * a human glance wants. Pass `--effective-status ACTIVE,PAUSED` to override, or\n * `--all-statuses` to drop the filter entirely.\n */\nexport function resolveEffectiveStatus(args: Record<string, unknown>): string | undefined {\n  if (args[\"all-statuses\"]) {\n    return undefined;\n  }\n  const explicit = args[\"effective-status\"] as string | undefined;\n  if (explicit) {\n    return explicit;\n  }\n  return \"ACTIVE\";\n}\n\n/**\n * An empty listing under a status filter reads exactly like \"nothing exists\":\n * a paused campaign's ad sets are CAMPAIGN_PAUSED, so the ACTIVE default hides\n * every one of them. Say which filter produced the empty list and how to widen it.\n */\nexport function statusFilterHints(\n  rows: ReadonlyArray<unknown>,\n  effectiveStatus: string | undefined,\n  noun: string,\n): string[] {\n  if (rows.length > 0 || effectiveStatus === undefined) return [];\n  if (effectiveStatus === \"ACTIVE\") {\n    return [\n      `No ACTIVE ${noun}. The ACTIVE filter hides paused, archived and in-review ones (under a paused campaign or ad set that is all of them), so this does NOT mean none exist. Re-run with --all-statuses before concluding there are none.`,\n    ];\n  }\n  return [\n    `No ${noun} with effective_status ${effectiveStatus}. Re-run with --all-statuses to see every status before concluding there are none.`,\n  ];\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-4E5FSFXV.js

@@ -1,97 +0,0 @@
-import {
-  JEV_MODEL,
-  askJev
-} from "./chunk-DGWSMAKI.js";
-
-// src/engine/lib/remembered-nouls.ts
-import { createHash } from "crypto";
-import { readFile } from "fs/promises";
-
-// src/engine/lib/file-lock.ts
-import { randomUUID } from "crypto";
-import { mkdir, rename, rm, stat, writeFile } from "fs/promises";
-import path from "path";
-var LOCK_STALE_MS = 1e4;
-var LOCK_WAIT_MS = 20;
-async function updateLockedFile(file, change) {
-  await mkdir(path.dirname(file), { recursive: true });
-  const lock = `${file}.lock`;
-  await acquireLock(lock);
-  try {
-    const temp = `${file}.${process.pid}.${randomUUID()}.tmp`;
-    await writeFile(temp, await change(), "utf8");
-    await rename(temp, file);
-  } finally {
-    await rm(lock, { force: true });
-  }
-}
-async function acquireLock(lock) {
-  for (; ; ) {
-    try {
-      await writeFile(lock, String(process.pid), { flag: "wx" });
-      return;
-    } catch (e) {
-      if (e.code !== "EEXIST") throw e;
-    }
-    const held = await stat(lock).catch(() => null);
-    if (held && Date.now() - held.mtimeMs > LOCK_STALE_MS) await rm(lock, { force: true });
-    await new Promise((resolve) => setTimeout(resolve, LOCK_WAIT_MS));
-  }
-}
-
-// src/engine/lib/remembered-nouls.ts
-var PER_REQUEST = 200;
-var MAX_REMEMBERED = 2e4;
-function keyOf(question) {
-  return createHash("sha256").update(JSON.stringify([JEV_MODEL, question.instructions])).digest("hex").slice(0, 32);
-}
-async function remembered(file) {
-  const parsed = await readFile(file, "utf8").then(JSON.parse, () => ({}));
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
-  return Object.fromEntries(
-    Object.entries(parsed).filter((e) => typeof e[1] === "number")
-  );
-}
-async function rememberedNouls(questions, opts) {
-  if (questions.length === 0) return [];
-  const keys = questions.map(keyOf);
-  const known = opts.file ? await remembered(opts.file) : {};
-  const missing = [...new Set(keys.filter((k) => known[k] === void 0))];
-  const byKey = new Map(questions.map((q, i) => [keys[i], q]));
-  const batches = [];
-  for (let i = 0; i < missing.length; i += PER_REQUEST) batches.push(missing.slice(i, i + PER_REQUEST));
-  const answered = await Promise.all(
-    batches.map((batch) => opts.ask(batch.flatMap((k) => byKey.get(k) ?? [])).catch(() => null))
-  );
-  if (answered.some((a) => a === null || a.length === 0)) return null;
-  const fresh = {};
-  batches.forEach((batch, b) => {
-    batch.forEach((k, i) => {
-      const answer = answered[b]?.[i];
-      if (answer !== void 0) fresh[k] = answer;
-    });
-  });
-  const all = { ...known, ...fresh };
-  const file = opts.file;
-  if (file && missing.length > 0) {
-    await updateLockedFile(file, async () => {
-      const kept = Object.entries({ ...await remembered(file), ...fresh }).slice(-MAX_REMEMBERED);
-      return JSON.stringify(Object.fromEntries(kept));
-    }).catch(() => void 0);
-  }
-  const answers = keys.map((k) => all[k]);
-  return answers.every((a) => a !== void 0) ? answers : null;
-}
-function jevAsker(onSpend) {
-  return (questions) => askJev(questions, onSpend);
-}
-function rememberedJev(file, onSpend) {
-  const ask = jevAsker(onSpend);
-  return (questions) => rememberedNouls(questions, { ask, file });
-}
-
-export {
-  updateLockedFile,
-  rememberedJev
-};
-//# sourceMappingURL=chunk-4E5FSFXV.js.map