@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/chunk-PDJZMQ7F.js

@@ -1,316 +0,0 @@
-import {
-  asRecord
-} from "./chunk-KIGGMKAE.js";
-
-// src/viewer-profile.ts
-var VIEWER_TEMPERATURE_VALUES = ["cold", "warm", "hot"];
-var VIEWER_KNOWS_VALUES = ["brand", "offer", "product"];
-var VIEWER_SOURCE_VALUES = ["targeting", "knowledge"];
-var MARKETS = {
-  ES: {
-    name: "Spain",
-    names: /(?<![\p{L}\d])(spain|españa|espana)(?![\p{L}\d])/iu,
-    language: "es-ES",
-    languageName: "Spanish from Spain",
-    currency: "EUR",
-    address: "t\xFA"
-  },
-  MX: {
-    name: "Mexico",
-    names: /(?<![\p{L}\d])(mexico|méxico)(?![\p{L}\d])/iu,
-    language: "es-MX",
-    languageName: "Mexican Spanish",
-    currency: "MXN",
-    address: "t\xFA"
-  },
-  AR: {
-    name: "Argentina",
-    names: /(?<![\p{L}\d])(argentina)(?![\p{L}\d])/iu,
-    language: "es-AR",
-    languageName: "Argentinian Spanish",
-    currency: "ARS",
-    address: "vos"
-  },
-  CO: {
-    name: "Colombia",
-    names: /(?<![\p{L}\d])(colombia)(?![\p{L}\d])/iu,
-    language: "es-CO",
-    languageName: "Colombian Spanish",
-    currency: "COP",
-    address: "t\xFA"
-  },
-  CL: {
-    name: "Chile",
-    names: /(?<![\p{L}\d])(chile)(?![\p{L}\d])/iu,
-    language: "es-CL",
-    languageName: "Chilean Spanish",
-    currency: "CLP",
-    address: "t\xFA"
-  },
-  PE: {
-    name: "Peru",
-    names: /(?<![\p{L}\d])(peru|perú)(?![\p{L}\d])/iu,
-    language: "es-PE",
-    languageName: "Peruvian Spanish",
-    currency: "PEN",
-    address: "t\xFA"
-  },
-  BR: {
-    name: "Brazil",
-    names: /(?<![\p{L}\d])(brazil|brasil)(?![\p{L}\d])/iu,
-    language: "pt-BR",
-    languageName: "Brazilian Portuguese",
-    currency: "BRL",
-    address: "voc\xEA"
-  },
-  PT: {
-    name: "Portugal",
-    names: /(?<![\p{L}\d])(portugal)(?![\p{L}\d])/iu,
-    language: "pt-PT",
-    languageName: "European Portuguese",
-    currency: "EUR",
-    address: "tu"
-  },
-  GB: {
-    name: "the United Kingdom",
-    names: /(?<![\p{L}\d])(united kingdom|uk|britain|england)(?![\p{L}\d])/iu,
-    language: "en-GB",
-    languageName: "British English",
-    currency: "GBP",
-    address: "you"
-  },
-  IE: {
-    name: "Ireland",
-    names: /(?<![\p{L}\d])(ireland)(?![\p{L}\d])/iu,
-    language: "en-IE",
-    languageName: "Irish English",
-    currency: "EUR",
-    address: "you"
-  },
-  US: {
-    name: "the United States",
-    names: /(?<![\p{L}\d])(united states|usa|u\.s\.)(?![\p{L}\d])/iu,
-    language: "en-US",
-    languageName: "American English",
-    currency: "USD",
-    address: "you"
-  },
-  DE: {
-    name: "Germany",
-    names: /(?<![\p{L}\d])(germany|deutschland)(?![\p{L}\d])/iu,
-    language: "de-DE",
-    languageName: "German",
-    currency: "EUR",
-    address: "du"
-  },
-  FR: {
-    name: "France",
-    names: /(?<![\p{L}\d])(france)(?![\p{L}\d])/iu,
-    language: "fr-FR",
-    languageName: "French",
-    currency: "EUR",
-    address: "vous"
-  },
-  IT: {
-    name: "Italy",
-    names: /(?<![\p{L}\d])(italy|italia)(?![\p{L}\d])/iu,
-    language: "it-IT",
-    languageName: "Italian",
-    currency: "EUR",
-    address: "tu"
-  }
-};
-function marketOfCountries(countries) {
-  const codes = [...new Set(countries.map((c) => c.trim().toUpperCase()).filter(Boolean))];
-  if (codes.length === 0) return void 0;
-  if (codes.length > 1) return { country: "global" };
-  const code = codes[0];
-  const facts = MARKETS[code];
-  return facts ? { country: code, language: facts.language, currency: facts.currency, address: facts.address } : { country: code };
-}
-function marketFromCompanyDoc(doc) {
-  const line = (doc ?? "").split("\n").find(
-    (l) => /(?<![\p{L}\d])(markets?|geo|geograph\w*|country|countries|país|paises|países|mercados?)(?![\p{L}\d])/iu.test(l)
-  );
-  if (!line) return void 0;
-  const found = Object.entries(MARKETS).filter(([, facts]) => facts.names.test(line)).map(([code]) => code);
-  return marketOfCountries(found);
-}
-function describeMarket(market) {
-  if (market.country === "global") return "a person in any of the countries the ad runs in";
-  const facts = MARKETS[market.country];
-  const where = facts?.name ?? market.country;
-  const language = facts && market.language === facts.language ? facts.languageName : market.language;
-  return [
-    `a person living in ${where}`,
-    language ? ` who reads ${language} natively` : "",
-    market.currency ? `, pays in ${market.currency}` : "",
-    market.address ? ` and is spoken to as ${market.address}` : ""
-  ].join("");
-}
-function marketCountryName(market) {
-  return market.country === "global" ? null : MARKETS[market.country]?.name ?? market.country;
-}
-function text(value) {
-  return typeof value === "string" ? value : "";
-}
-function audienceRefs(value) {
-  if (!Array.isArray(value)) return [];
-  return value.flatMap((entry) => {
-    const ref = asRecord(entry);
-    const id = text(ref?.id);
-    return id ? [{ id, name: text(ref?.name) }] : [];
-  });
-}
-var BUYERS = /purchas|buyer|customer|client|compra|cliente|achat|acheteur|kunde|käufer/i;
-var LOOKALIKE_NAME = /lookalike|\blal\b|similar|parecid/i;
-var COLD = { temperature: "cold", knows: [] };
-function tierOf(audience, ref) {
-  const subtype = text(audience?.subtype).toUpperCase();
-  const name = text(audience?.name) || ref.name;
-  if (subtype === "LOOKALIKE" || !subtype && LOOKALIKE_NAME.test(name)) {
-    return { ...COLD, who: "a lookalike: strangers who resemble the seed" };
-  }
-  if (BUYERS.test(name)) return { temperature: "hot", knows: ["brand", "offer", "product"], who: "buyers" };
-  if (subtype === "WEBSITE") return { temperature: "warm", knows: ["brand", "offer"], who: "site visitors" };
-  if (subtype === "CUSTOM") {
-    return { temperature: "hot", knows: ["brand", "offer", "product"], who: "an uploaded customer list" };
-  }
-  return { temperature: "warm", knows: ["brand"], who: "people who engaged with the brand" };
-}
-function classifyAudience(adSet, audiences, campaign) {
-  const targeting = asRecord(adSet.targeting) ?? {};
-  const byId = new Map(audiences.map((audience) => [text(audience.id), audience]));
-  const includedRefs = audienceRefs(targeting.custom_audiences);
-  const included = includedRefs.map((ref) => tierOf(byId.get(ref.id), ref));
-  const reasons = [
-    includedRefs.length === 0 ? "No custom audience: Meta finds new people from age, place and interests, so every viewer is a stranger." : `Reaches ${includedRefs.map((ref, i) => `"${ref.name || ref.id}" (${included[i]?.who})`).join(", ")}.`
-  ];
-  const unlisted = includedRefs.filter((ref) => !byId.has(ref.id));
-  if (unlisted.length > 0) {
-    reasons.push(`${quoteNames(unlisted)} is not in this account's audience list, so it was read from its name alone.`);
-  }
-  let reached = coldestOf(included);
-  if (asRecord(targeting.targeting_automation)?.advantage_audience === 1 && included.length > 0) {
-    reached = belowHot(reached);
-    reasons.push(
-      "Advantage+ audience treats the chosen audiences as suggestions and reaches past them, so part of the delivery goes to people who have never bought."
-    );
-  }
-  const excludedRefs = audienceRefs(targeting.excluded_custom_audiences);
-  if (excludedRefs.length > 0) reasons.push(`Keeps out ${quoteNames(excludedRefs)}.`);
-  if (excludedRefs.some((ref) => tierOf(byId.get(ref.id), ref).temperature === "hot")) {
-    reached = belowHot(reached);
-    reasons.push("Buyers are excluded, so nobody reached has used the product.");
-  }
-  const objective = text(campaign?.objective);
-  if (reached.temperature === "cold" && ASKS_TO_ACT.test(objective)) {
-    reasons.push(
-      `Campaign objective ${objective} asks a stranger to act on first contact, so the ad alone must say what is offered and to whom.`
-    );
-  }
-  const countries = strings(asRecord(targeting.geo_locations)?.countries);
-  const market = marketOfCountries(countries);
-  if (market?.country === "global") {
-    reasons.push(
-      `Runs in ${countries.join(", ")}: one version for every market, with no country's places, money or faces.`
-    );
-  }
-  const placements = placementsOf(targeting);
-  if (placements.length === 0) {
-    reasons.push(
-      "Advantage+ placements: Meta picks the surface, so the ad must also work full-screen in Stories and Reels, not only in the feed."
-    );
-  }
-  return {
-    temperature: reached.temperature,
-    knows: reached.knows,
-    placements: placements.length > 0 ? placements : ["automatic"],
-    source: "targeting",
-    reasons,
-    ...market ? { market } : {}
-  };
-}
-var ASKS_TO_ACT = /^(OUTCOME_SALES|OUTCOME_LEADS|OUTCOME_APP_PROMOTION|CONVERSIONS|LEAD_GENERATION|PRODUCT_CATALOG_SALES)$/;
-function strings(value) {
-  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
-}
-function placementsOf(targeting) {
-  return strings(targeting.publisher_platforms).flatMap((platform) => {
-    const positions = strings(targeting[`${platform}_positions`]);
-    if (positions.length === 0) return [platform];
-    return positions.map((position) => {
-      const surface = platform === "instagram" && position === "stream" ? "feed" : position;
-      return surface.startsWith(`${platform}_`) ? surface : `${platform}_${surface}`;
-    });
-  });
-}
-function quoteNames(refs) {
-  return refs.map((ref) => `"${ref.name || ref.id}"`).join(", ");
-}
-function belowHot(tier) {
-  if (tier.temperature !== "hot") return tier;
-  return { temperature: "warm", knows: tier.knows.filter((known) => known !== "product") };
-}
-var WARMTH = { cold: 0, warm: 1, hot: 2 };
-function coldestOf(tiers) {
-  const [first, ...rest] = tiers;
-  if (!first) return COLD;
-  return rest.reduce(
-    (acc, tier) => ({
-      temperature: WARMTH[tier.temperature] < WARMTH[acc.temperature] ? tier.temperature : acc.temperature,
-      knows: acc.knows.filter((known) => tier.knows.includes(known))
-    }),
-    first
-  );
-}
-var AWARENESS_VALUES = ["unaware", "problem_aware", "solution_aware", "product_aware", "most_aware"];
-var BY_AWARENESS = {
-  unaware: COLD,
-  problem_aware: COLD,
-  solution_aware: COLD,
-  product_aware: { temperature: "warm", knows: ["brand", "offer"] },
-  most_aware: { temperature: "hot", knows: ["brand", "offer", "product"] }
-};
-var CUSTOMER_SEGMENT = /\b(existing|current|past|former|returning|repeat)\s+(customers?|clients?|buyers?|members?|subscribers?|users?)\b|\bclientes\s+(actuales|existentes)\b|\bantiguos\s+clientes\b/i;
-var CONTACT_SEGMENT = /\b(leads?|prospects?)\s+(who|that)\b|\b(site|website|web)\s+visitors\b|\babandon(ed|s)?\s+(carts?|checkouts?|forms?)\b|\btrial\s+users\b|\bvisitantes\b/i;
-function tierOfSegment(segment) {
-  if (CUSTOMER_SEGMENT.test(segment)) return { temperature: "hot", knows: ["brand", "offer", "product"] };
-  if (CONTACT_SEGMENT.test(segment)) return { temperature: "warm", knows: ["brand", "offer"] };
-  return void 0;
-}
-function viewerFromKnowledge(input) {
-  const reasons = ["No ad set to read, so this viewer comes from the Knowledge and the brief, not from targeting."];
-  let tier = COLD;
-  if (input.awareness) {
-    tier = BY_AWARENESS[input.awareness];
-    reasons.push(`The concept is written for a ${input.awareness.replace("_", "-")} viewer.`);
-  } else {
-    const warmed = input.personas.flatMap((segment) => {
-      const read = tierOfSegment(segment);
-      return read ? [{ segment, read }] : [];
-    });
-    if (warmed.length > 0 && warmed.length === input.personas.length) {
-      tier = coldestOf(warmed.map((entry) => entry.read));
-      reasons.push(
-        `The persona is defined by what they already did with the brand: ${warmed.map((entry) => `"${entry.segment}"`).join(", ")}.`
-      );
-    } else {
-      reasons.push("Nothing on file says the viewer knows the brand: design for a stranger.");
-    }
-  }
-  return { temperature: tier.temperature, knows: tier.knows, placements: ["automatic"], source: "knowledge", reasons };
-}
-
-export {
-  VIEWER_TEMPERATURE_VALUES,
-  VIEWER_KNOWS_VALUES,
-  VIEWER_SOURCE_VALUES,
-  marketFromCompanyDoc,
-  describeMarket,
-  marketCountryName,
-  classifyAudience,
-  AWARENESS_VALUES,
-  viewerFromKnowledge
-};
-//# sourceMappingURL=chunk-PDJZMQ7F.js.map

package/dist/chunk-PDJZMQ7F.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/viewer-profile.ts"],"sourcesContent":["import { asRecord } from \"./commands/ads/list-rows.ts\";\n\n/**\n * Who will see an ad, read off what the ad set actually targets rather than what\n * anyone hopes it targets — or, with no ad set, off the Knowledge and the brief.\n * `baker ads meta adsets --audience` prints it; a creative records it in its\n * `_definition.md` (`viewer`), and the viewer check plays it.\n */\n\nexport const VIEWER_TEMPERATURE_VALUES = [\"cold\", \"warm\", \"hot\"] as const;\nexport const VIEWER_KNOWS_VALUES = [\"brand\", \"offer\", \"product\"] as const;\nexport const VIEWER_SOURCE_VALUES = [\"targeting\", \"knowledge\"] as const;\n\nexport type ViewerTemperature = (typeof VIEWER_TEMPERATURE_VALUES)[number];\nexport type ViewerKnows = (typeof VIEWER_KNOWS_VALUES)[number];\n\n/**\n * Where the viewer lives and how they are spoken to (D1): the country (`global` for a version\n * that runs in several), the language variant, the currency and the form of address.\n */\nexport interface ViewerMarket {\n  country: string;\n  language?: string;\n  currency?: string;\n  address?: string;\n}\n\nexport interface ViewerProfile {\n  temperature: ViewerTemperature;\n  knows: ViewerKnows[];\n  placements: string[];\n  source: (typeof VIEWER_SOURCE_VALUES)[number];\n  reasons: string[];\n  /** Where they live: read off the ad set's countries, else COMPANY.md. */\n  market?: ViewerMarket;\n}\n\ntype MarketFacts = {\n  name: string;\n  names: RegExp;\n  language: string;\n  languageName: string;\n  currency: string;\n  address: string;\n};\n\n/** The markets our ads run in, with how an ad speaks there. A country not listed keeps its code alone. */\nconst MARKETS: Readonly<Record<string, MarketFacts>> = {\n  ES: {\n    name: \"Spain\",\n    names: /(?<![\\p{L}\\d])(spain|españa|espana)(?![\\p{L}\\d])/iu,\n    language: \"es-ES\",\n    languageName: \"Spanish from Spain\",\n    currency: \"EUR\",\n    address: \"tú\",\n  },\n  MX: {\n    name: \"Mexico\",\n    names: /(?<![\\p{L}\\d])(mexico|méxico)(?![\\p{L}\\d])/iu,\n    language: \"es-MX\",\n    languageName: \"Mexican Spanish\",\n    currency: \"MXN\",\n    address: \"tú\",\n  },\n  AR: {\n    name: \"Argentina\",\n    names: /(?<![\\p{L}\\d])(argentina)(?![\\p{L}\\d])/iu,\n    language: \"es-AR\",\n    languageName: \"Argentinian Spanish\",\n    currency: \"ARS\",\n    address: \"vos\",\n  },\n  CO: {\n    name: \"Colombia\",\n    names: /(?<![\\p{L}\\d])(colombia)(?![\\p{L}\\d])/iu,\n    language: \"es-CO\",\n    languageName: \"Colombian Spanish\",\n    currency: \"COP\",\n    address: \"tú\",\n  },\n  CL: {\n    name: \"Chile\",\n    names: /(?<![\\p{L}\\d])(chile)(?![\\p{L}\\d])/iu,\n    language: \"es-CL\",\n    languageName: \"Chilean Spanish\",\n    currency: \"CLP\",\n    address: \"tú\",\n  },\n  PE: {\n    name: \"Peru\",\n    names: /(?<![\\p{L}\\d])(peru|perú)(?![\\p{L}\\d])/iu,\n    language: \"es-PE\",\n    languageName: \"Peruvian Spanish\",\n    currency: \"PEN\",\n    address: \"tú\",\n  },\n  BR: {\n    name: \"Brazil\",\n    names: /(?<![\\p{L}\\d])(brazil|brasil)(?![\\p{L}\\d])/iu,\n    language: \"pt-BR\",\n    languageName: \"Brazilian Portuguese\",\n    currency: \"BRL\",\n    address: \"você\",\n  },\n  PT: {\n    name: \"Portugal\",\n    names: /(?<![\\p{L}\\d])(portugal)(?![\\p{L}\\d])/iu,\n    language: \"pt-PT\",\n    languageName: \"European Portuguese\",\n    currency: \"EUR\",\n    address: \"tu\",\n  },\n  GB: {\n    name: \"the United Kingdom\",\n    names: /(?<![\\p{L}\\d])(united kingdom|uk|britain|england)(?![\\p{L}\\d])/iu,\n    language: \"en-GB\",\n    languageName: \"British English\",\n    currency: \"GBP\",\n    address: \"you\",\n  },\n  IE: {\n    name: \"Ireland\",\n    names: /(?<![\\p{L}\\d])(ireland)(?![\\p{L}\\d])/iu,\n    language: \"en-IE\",\n    languageName: \"Irish English\",\n    currency: \"EUR\",\n    address: \"you\",\n  },\n  US: {\n    name: \"the United States\",\n    names: /(?<![\\p{L}\\d])(united states|usa|u\\.s\\.)(?![\\p{L}\\d])/iu,\n    language: \"en-US\",\n    languageName: \"American English\",\n    currency: \"USD\",\n    address: \"you\",\n  },\n  DE: {\n    name: \"Germany\",\n    names: /(?<![\\p{L}\\d])(germany|deutschland)(?![\\p{L}\\d])/iu,\n    language: \"de-DE\",\n    languageName: \"German\",\n    currency: \"EUR\",\n    address: \"du\",\n  },\n  FR: {\n    name: \"France\",\n    names: /(?<![\\p{L}\\d])(france)(?![\\p{L}\\d])/iu,\n    language: \"fr-FR\",\n    languageName: \"French\",\n    currency: \"EUR\",\n    address: \"vous\",\n  },\n  IT: {\n    name: \"Italy\",\n    names: /(?<![\\p{L}\\d])(italy|italia)(?![\\p{L}\\d])/iu,\n    language: \"it-IT\",\n    languageName: \"Italian\",\n    currency: \"EUR\",\n    address: \"tu\",\n  },\n};\n\n/**\n * The market an ad set's countries make: one country is its own market; several are one global\n * version in the campaign's language, with market-neutral people, places and money. Pure.\n */\nexport function marketOfCountries(countries: readonly string[]): ViewerMarket | undefined {\n  const codes = [...new Set(countries.map((c) => c.trim().toUpperCase()).filter(Boolean))];\n  if (codes.length === 0) return undefined;\n  if (codes.length > 1) return { country: \"global\" };\n  const code = codes[0] as string;\n  const facts = MARKETS[code];\n  return facts\n    ? { country: code, language: facts.language, currency: facts.currency, address: facts.address }\n    : { country: code };\n}\n\n/** The market COMPANY.md names on its market or geography line, when it names one. Pure. */\nexport function marketFromCompanyDoc(doc: string | null | undefined): ViewerMarket | undefined {\n  const line = (doc ?? \"\")\n    .split(\"\\n\")\n    .find((l) =>\n      /(?<![\\p{L}\\d])(markets?|geo|geograph\\w*|country|countries|país|paises|países|mercados?)(?![\\p{L}\\d])/iu.test(l),\n    );\n  if (!line) return undefined;\n  const found = Object.entries(MARKETS)\n    .filter(([, facts]) => facts.names.test(line))\n    .map(([code]) => code);\n  return marketOfCountries(found);\n}\n\n/** The market in the viewer's own terms, for a model that plays them. Pure. */\nexport function describeMarket(market: ViewerMarket): string {\n  if (market.country === \"global\") return \"a person in any of the countries the ad runs in\";\n  const facts = MARKETS[market.country];\n  const where = facts?.name ?? market.country;\n  const language = facts && market.language === facts.language ? facts.languageName : market.language;\n  return [\n    `a person living in ${where}`,\n    language ? ` who reads ${language} natively` : \"\",\n    market.currency ? `, pays in ${market.currency}` : \"\",\n    market.address ? ` and is spoken to as ${market.address}` : \"\",\n  ].join(\"\");\n}\n\n/** The country a market names, in words (\"Mexico\"); null for a global version. */\nexport function marketCountryName(market: ViewerMarket): string | null {\n  return market.country === \"global\" ? null : (MARKETS[market.country]?.name ?? market.country);\n}\n\nexport interface AdSetTargetingInput {\n  targeting?: unknown;\n}\n\nexport interface CustomAudienceInput {\n  id?: unknown;\n  name?: unknown;\n  subtype?: unknown;\n}\n\nexport interface CampaignInput {\n  objective?: unknown;\n}\n\nfunction text(value: unknown): string {\n  return typeof value === \"string\" ? value : \"\";\n}\n\n/** The `{ id, name }` entries of a targeting list such as `custom_audiences`. */\nfunction audienceRefs(value: unknown): Array<{ id: string; name: string }> {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    const ref = asRecord(entry);\n    const id = text(ref?.id);\n    return id ? [{ id, name: text(ref?.name) }] : [];\n  });\n}\n\n/** What one custom audience's members have already been through with the brand. */\ninterface AudienceTier {\n  temperature: ViewerTemperature;\n  knows: ViewerKnows[];\n}\n\ninterface AudienceRead extends AudienceTier {\n  /** Who its members are, in the words a reason prints. */\n  who: string;\n}\n\n/**\n * A pixel or event audience's subtype says where its members came from, not what they did:\n * \"Purchasers 180d\" and \"All visitors 30d\" are both WEBSITE. The name is the one place an\n * account records the event, in the advertiser's own language.\n */\nconst BUYERS = /purchas|buyer|customer|client|compra|cliente|achat|acheteur|kunde|käufer/i;\nconst LOOKALIKE_NAME = /lookalike|\\blal\\b|similar|parecid/i;\n\nconst COLD: AudienceTier = { temperature: \"cold\", knows: [] };\n\nfunction tierOf(audience: CustomAudienceInput | undefined, ref: { name: string }): AudienceRead {\n  const subtype = text(audience?.subtype).toUpperCase();\n  const name = text(audience?.name) || ref.name;\n  // Meta names a lookalike after its seed (\"Lookalike (GB, 1%) - Purchasers\"), so it is ruled out before the name is read.\n  if (subtype === \"LOOKALIKE\" || (!subtype && LOOKALIKE_NAME.test(name))) {\n    return { ...COLD, who: \"a lookalike: strangers who resemble the seed\" };\n  }\n  if (BUYERS.test(name)) return { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"], who: \"buyers\" };\n  if (subtype === \"WEBSITE\") return { temperature: \"warm\", knows: [\"brand\", \"offer\"], who: \"site visitors\" };\n  if (subtype === \"CUSTOM\") {\n    return { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"], who: \"an uploaded customer list\" };\n  }\n  // Every other custom audience is people who met the brand somewhere: a Page, a profile, a video, the app.\n  return { temperature: \"warm\", knows: [\"brand\"], who: \"people who engaged with the brand\" };\n}\n\nexport function classifyAudience(\n  adSet: AdSetTargetingInput,\n  audiences: readonly CustomAudienceInput[],\n  campaign: CampaignInput | undefined,\n): ViewerProfile {\n  const targeting = asRecord(adSet.targeting) ?? {};\n  const byId = new Map(audiences.map((audience) => [text(audience.id), audience]));\n  const includedRefs = audienceRefs(targeting.custom_audiences);\n  const included = includedRefs.map((ref) => tierOf(byId.get(ref.id), ref));\n  const reasons: string[] = [\n    includedRefs.length === 0\n      ? \"No custom audience: Meta finds new people from age, place and interests, so every viewer is a stranger.\"\n      : `Reaches ${includedRefs.map((ref, i) => `\"${ref.name || ref.id}\" (${included[i]?.who})`).join(\", \")}.`,\n  ];\n  const unlisted = includedRefs.filter((ref) => !byId.has(ref.id));\n  if (unlisted.length > 0) {\n    reasons.push(`${quoteNames(unlisted)} is not in this account's audience list, so it was read from its name alone.`);\n  }\n  let reached = coldestOf(included);\n  if (asRecord(targeting.targeting_automation)?.advantage_audience === 1 && included.length > 0) {\n    reached = belowHot(reached);\n    reasons.push(\n      \"Advantage+ audience treats the chosen audiences as suggestions and reaches past them, so part of the delivery goes to people who have never bought.\",\n    );\n  }\n  const excludedRefs = audienceRefs(targeting.excluded_custom_audiences);\n  if (excludedRefs.length > 0) reasons.push(`Keeps out ${quoteNames(excludedRefs)}.`);\n  if (excludedRefs.some((ref) => tierOf(byId.get(ref.id), ref).temperature === \"hot\")) {\n    reached = belowHot(reached);\n    reasons.push(\"Buyers are excluded, so nobody reached has used the product.\");\n  }\n  const objective = text(campaign?.objective);\n  if (reached.temperature === \"cold\" && ASKS_TO_ACT.test(objective)) {\n    reasons.push(\n      `Campaign objective ${objective} asks a stranger to act on first contact, so the ad alone must say what is offered and to whom.`,\n    );\n  }\n  const countries = strings(asRecord(targeting.geo_locations)?.countries);\n  const market = marketOfCountries(countries);\n  if (market?.country === \"global\") {\n    reasons.push(\n      `Runs in ${countries.join(\", \")}: one version for every market, with no country's places, money or faces.`,\n    );\n  }\n  const placements = placementsOf(targeting);\n  if (placements.length === 0) {\n    reasons.push(\n      \"Advantage+ placements: Meta picks the surface, so the ad must also work full-screen in Stories and Reels, not only in the feed.\",\n    );\n  }\n  return {\n    temperature: reached.temperature,\n    knows: reached.knows,\n    placements: placements.length > 0 ? placements : [\"automatic\"],\n    source: \"targeting\",\n    reasons,\n    ...(market ? { market } : {}),\n  };\n}\n\n/**\n * The objective says what the campaign wants from a viewer, never who the viewer is:\n * a conversion campaign on broad targeting still meets strangers. So it adds a reason\n * and never moves the temperature.\n */\nconst ASKS_TO_ACT =\n  /^(OUTCOME_SALES|OUTCOME_LEADS|OUTCOME_APP_PROMOTION|CONVERSIONS|LEAD_GENERATION|PRODUCT_CATALOG_SALES)$/;\n\nfunction strings(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === \"string\") : [];\n}\n\n/**\n * `instagram_positions` calls the feed `stream` and Facebook's Reels are already\n * `facebook_reels`; one `<platform>_<surface>` spelling reads the same for both.\n */\nfunction placementsOf(targeting: Record<string, unknown>): string[] {\n  return strings(targeting.publisher_platforms).flatMap((platform) => {\n    const positions = strings(targeting[`${platform}_positions`]);\n    // A platform with no positions of its own is every surface on it.\n    if (positions.length === 0) return [platform];\n    return positions.map((position) => {\n      const surface = platform === \"instagram\" && position === \"stream\" ? \"feed\" : position;\n      return surface.startsWith(`${platform}_`) ? surface : `${platform}_${surface}`;\n    });\n  });\n}\n\nfunction quoteNames(refs: ReadonlyArray<{ id: string; name: string }>): string {\n  return refs.map((ref) => `\"${ref.name || ref.id}\"`).join(\", \");\n}\n\n/** Only buyers know the product itself; anyone short of that knows at most the brand and its offer. */\nfunction belowHot(tier: AudienceTier): AudienceTier {\n  if (tier.temperature !== \"hot\") return tier;\n  return { temperature: \"warm\", knows: tier.knows.filter((known) => known !== \"product\") };\n}\n\nconst WARMTH: Record<ViewerTemperature, number> = { cold: 0, warm: 1, hot: 2 };\n\n/**\n * Meta delivers to anyone in ANY included audience, so the ad has to work on the\n * coldest of them, and it can only lean on what every one of them already knows.\n */\nfunction coldestOf(tiers: readonly AudienceTier[]): AudienceTier {\n  const [first, ...rest] = tiers;\n  if (!first) return COLD;\n  return rest.reduce<AudienceTier>(\n    (acc, tier) => ({\n      temperature: WARMTH[tier.temperature] < WARMTH[acc.temperature] ? tier.temperature : acc.temperature,\n      knows: acc.knows.filter((known) => tier.knows.includes(known)),\n    }),\n    first,\n  );\n}\n\n/** The awareness stages a creative's `awareness` field takes (the scaffold `creatives` collection). */\nexport const AWARENESS_VALUES = [\"unaware\", \"problem_aware\", \"solution_aware\", \"product_aware\", \"most_aware\"] as const;\n\nexport type Awareness = (typeof AWARENESS_VALUES)[number];\n\n/** Until a viewer is aware of the product, they know nothing of the brand behind it either. */\nconst BY_AWARENESS: Record<Awareness, AudienceTier> = {\n  unaware: COLD,\n  problem_aware: COLD,\n  solution_aware: COLD,\n  product_aware: { temperature: \"warm\", knows: [\"brand\", \"offer\"] },\n  most_aware: { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"] },\n};\n\n/**\n * A persona segment says what the viewer already did with the brand only when it is\n * defined by it (\"Existing customers up for renewal\", \"Leads who went quiet\"). Phrases,\n * not words: \"Marketing leads at SaaS firms\" are job titles, not leads.\n */\nconst CUSTOMER_SEGMENT =\n  /\\b(existing|current|past|former|returning|repeat)\\s+(customers?|clients?|buyers?|members?|subscribers?|users?)\\b|\\bclientes\\s+(actuales|existentes)\\b|\\bantiguos\\s+clientes\\b/i;\nconst CONTACT_SEGMENT =\n  /\\b(leads?|prospects?)\\s+(who|that)\\b|\\b(site|website|web)\\s+visitors\\b|\\babandon(ed|s)?\\s+(carts?|checkouts?|forms?)\\b|\\btrial\\s+users\\b|\\bvisitantes\\b/i;\n\nfunction tierOfSegment(segment: string): AudienceTier | undefined {\n  if (CUSTOMER_SEGMENT.test(segment)) return { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"] };\n  if (CONTACT_SEGMENT.test(segment)) return { temperature: \"warm\", knows: [\"brand\", \"offer\"] };\n  return undefined;\n}\n\nexport interface KnowledgeViewerInput {\n  /** The segment line (frontmatter `segment`, else the title) of each persona the ad is for. */\n  personas: readonly string[];\n  /** The awareness stage the concept was written for, when the brief set one. */\n  awareness?: Awareness;\n}\n\n/**\n * The viewer when there is no ad set to read. The Knowledge describes who a persona\n * is, almost never what they already know about the brand, so the stranger is the\n * default and only an explicit signal warms it.\n */\nexport function viewerFromKnowledge(input: KnowledgeViewerInput): ViewerProfile {\n  const reasons = [\"No ad set to read, so this viewer comes from the Knowledge and the brief, not from targeting.\"];\n  let tier = COLD;\n  if (input.awareness) {\n    tier = BY_AWARENESS[input.awareness];\n    reasons.push(`The concept is written for a ${input.awareness.replace(\"_\", \"-\")} viewer.`);\n  } else {\n    const warmed = input.personas.flatMap((segment) => {\n      const read = tierOfSegment(segment);\n      return read ? [{ segment, read }] : [];\n    });\n    if (warmed.length > 0 && warmed.length === input.personas.length) {\n      tier = coldestOf(warmed.map((entry) => entry.read));\n      reasons.push(\n        `The persona is defined by what they already did with the brand: ${warmed.map((entry) => `\"${entry.segment}\"`).join(\", \")}.`,\n      );\n    } else {\n      reasons.push(\"Nothing on file says the viewer knows the brand: design for a stranger.\");\n    }\n  }\n  return { temperature: tier.temperature, knows: tier.knows, placements: [\"automatic\"], source: \"knowledge\", reasons };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-PNHDM76R.js

@@ -1,74 +0,0 @@
-// src/commands/canvas/unbilled-spend.ts
-import { randomUUID } from "crypto";
-import { mkdir, readdir, readFile, rename, unlink, writeFile } from "fs/promises";
-import path from "path";
-import { z } from "zod";
-var DIR = "unbilled-spend";
-var Held = z.array(
-  z.object({ model: z.string(), inputTokens: z.number(), outputTokens: z.number(), costUsd: z.number() })
-);
-async function holdUnbilledSpend(cacheDir, usage) {
-  if (usage.length === 0) return;
-  const dir = path.join(cacheDir, DIR);
-  await mkdir(dir, { recursive: true });
-  await writeFile(path.join(dir, `${Date.now()}-${randomUUID()}.json`), JSON.stringify(usage), "utf8");
-}
-async function takeUnbilledSpend(cacheDir) {
-  const dir = path.join(cacheDir, DIR);
-  const files = await readdir(dir).catch(() => []);
-  const byModel = /* @__PURE__ */ new Map();
-  for (const file of files.filter((f) => f.endsWith(".json"))) {
-    const claimed = path.join(dir, `${file}.${randomUUID()}.taken`);
-    try {
-      await rename(path.join(dir, file), claimed);
-    } catch {
-      continue;
-    }
-    const parsed = Held.safeParse(await readFile(claimed, "utf8").then(JSON.parse, () => null).catch(() => null));
-    await unlink(claimed).catch(() => {
-    });
-    for (const call of parsed.success ? parsed.data : []) {
-      const sum = byModel.get(call.model);
-      byModel.set(
-        call.model,
-        sum ? {
-          model: call.model,
-          inputTokens: sum.inputTokens + call.inputTokens,
-          outputTokens: sum.outputTokens + call.outputTokens,
-          costUsd: sum.costUsd + call.costUsd
-        } : { ...call }
-      );
-    }
-  }
-  return [...byModel.values()];
-}
-async function sendBillingSpend(cacheDir, usage, send) {
-  try {
-    await send();
-    return null;
-  } catch (e) {
-    await holdUnbilledSpend(cacheDir, usage).catch(() => {
-    });
-    return e instanceof Error ? e.message : String(e);
-  }
-}
-function holdWhenSettled(cacheDir, spendOf) {
-  const pending = [];
-  return {
-    settled: (run, outputs) => {
-      pending.push(holdUnbilledSpend(cacheDir, spendOf(run, outputs)).catch(() => {
-      }));
-    },
-    drained: async () => {
-      await Promise.all(pending);
-    }
-  };
-}
-
-export {
-  holdUnbilledSpend,
-  takeUnbilledSpend,
-  sendBillingSpend,
-  holdWhenSettled
-};
-//# sourceMappingURL=chunk-PNHDM76R.js.map

package/dist/chunk-PNHDM76R.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/canvas/unbilled-spend.ts"],"sourcesContent":["/**\n * Gateway spend the CLI made with no run record to carry it: the viewer check run on its\n * own (`baker canvas viewer-check`) or one that refused the render before any run existed.\n *\n * The run record's `reviewUsage` is how a call made in the Runtime reaches the credits\n * ledger (`POST /api/canvas/runs` bills it once, when the terminal record is accepted). So\n * the spend waits here, in the workspace's canvas cache, and the next run record of this\n * workspace takes it. One file per hold and a rename to claim it: two processes never take\n * the same call, and a hold never overwrites another.\n */\nimport { randomUUID } from \"node:crypto\";\nimport { mkdir, readdir, readFile, rename, unlink, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { z } from \"zod\";\nimport type { NodeRunRecord } from \"../../engine/engine/executor.ts\";\nimport type { ReviewUsage } from \"../../engine/nodes/local/lib/render-review.ts\";\n\nconst DIR = \"unbilled-spend\";\n\nconst Held = z.array(\n  z.object({ model: z.string(), inputTokens: z.number(), outputTokens: z.number(), costUsd: z.number() }),\n);\n\n/** Keep `usage` for the next run record of this workspace; nothing is written when it is empty. */\nexport async function holdUnbilledSpend(cacheDir: string, usage: readonly ReviewUsage[]): Promise<void> {\n  if (usage.length === 0) return;\n  const dir = path.join(cacheDir, DIR);\n  await mkdir(dir, { recursive: true });\n  await writeFile(path.join(dir, `${Date.now()}-${randomUUID()}.json`), JSON.stringify(usage), \"utf8\");\n}\n\n/** Every held call, claimed and removed, summed per model (one record entry each). */\nexport async function takeUnbilledSpend(cacheDir: string): Promise<ReviewUsage[]> {\n  const dir = path.join(cacheDir, DIR);\n  const files = await readdir(dir).catch(() => [] as string[]);\n  const byModel = new Map<string, ReviewUsage>();\n  for (const file of files.filter((f) => f.endsWith(\".json\"))) {\n    const claimed = path.join(dir, `${file}.${randomUUID()}.taken`);\n    try {\n      await rename(path.join(dir, file), claimed);\n    } catch {\n      continue;\n    }\n    const parsed = Held.safeParse(await readFile(claimed, \"utf8\").then(JSON.parse, () => null).catch(() => null));\n    await unlink(claimed).catch(() => {});\n    for (const call of parsed.success ? parsed.data : []) {\n      const sum = byModel.get(call.model);\n      byModel.set(\n        call.model,\n        sum\n          ? {\n              model: call.model,\n              inputTokens: sum.inputTokens + call.inputTokens,\n              outputTokens: sum.outputTokens + call.outputTokens,\n              costUsd: sum.costUsd + call.costUsd,\n            }\n          : { ...call },\n      );\n    }\n  }\n  return [...byModel.values()];\n}\n\n/**\n * Send the record that carries `usage`: null when it landed, else why not. When it never does, the\n * spend is held again for the next one; the failure is reported, never thrown, because a\n * record that did not land must not turn a finished render into a failed one.\n */\nexport async function sendBillingSpend(\n  cacheDir: string,\n  usage: readonly ReviewUsage[],\n  send: () => Promise<void>,\n): Promise<string | null> {\n  try {\n    await send();\n    return null;\n  } catch (e) {\n    await holdUnbilledSpend(cacheDir, usage).catch(() => {});\n    return e instanceof Error ? e.message : String(e);\n  }\n}\n\n/**\n * Hold what a node's own gateway calls cost the moment it settles, so the spend survives the\n * run failing or being stopped after it: the resumed run takes that node from the cache and\n * bills nothing for it. `spendOf` returns [] for a cached node or one that calls nothing.\n */\nexport function holdWhenSettled(\n  cacheDir: string,\n  spendOf: (run: NodeRunRecord, outputs: Record<string, unknown>) => readonly ReviewUsage[],\n): { settled: (run: NodeRunRecord, outputs: Record<string, unknown>) => void; drained: () => Promise<void> } {\n  const pending: Promise<void>[] = [];\n  return {\n    settled: (run, outputs) => {\n      pending.push(holdUnbilledSpend(cacheDir, spendOf(run, outputs)).catch(() => {}));\n    },\n    drained: async () => {\n      await Promise.all(pending);\n    },\n  };\n}\n"],"mappings":";AAUA,SAAS,kBAAkB;AAC3B,SAAS,OAAO,SAAS,UAAU,QAAQ,QAAQ,iBAAiB;AACpE,OAAO,UAAU;AACjB,SAAS,SAAS;AAIlB,IAAM,MAAM;AAEZ,IAAM,OAAO,EAAE;AAAA,EACb,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,OAAO,GAAG,cAAc,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC;AACxG;AAGA,eAAsB,kBAAkB,UAAkB,OAA8C;AACtG,MAAI,MAAM,WAAW,EAAG;AACxB,QAAM,MAAM,KAAK,KAAK,UAAU,GAAG;AACnC,QAAM,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AACpC,QAAM,UAAU,KAAK,KAAK,KAAK,GAAG,KAAK,IAAI,CAAC,IAAI,WAAW,CAAC,OAAO,GAAG,KAAK,UAAU,KAAK,GAAG,MAAM;AACrG;AAGA,eAAsB,kBAAkB,UAA0C;AAChF,QAAM,MAAM,KAAK,KAAK,UAAU,GAAG;AACnC,QAAM,QAAQ,MAAM,QAAQ,GAAG,EAAE,MAAM,MAAM,CAAC,CAAa;AAC3D,QAAM,UAAU,oBAAI,IAAyB;AAC7C,aAAW,QAAQ,MAAM,OAAO,CAAC,MAAM,EAAE,SAAS,OAAO,CAAC,GAAG;AAC3D,UAAM,UAAU,KAAK,KAAK,KAAK,GAAG,IAAI,IAAI,WAAW,CAAC,QAAQ;AAC9D,QAAI;AACF,YAAM,OAAO,KAAK,KAAK,KAAK,IAAI,GAAG,OAAO;AAAA,IAC5C,QAAQ;AACN;AAAA,IACF;AACA,UAAM,SAAS,KAAK,UAAU,MAAM,SAAS,SAAS,MAAM,EAAE,KAAK,KAAK,OAAO,MAAM,IAAI,EAAE,MAAM,MAAM,IAAI,CAAC;AAC5G,UAAM,OAAO,OAAO,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AACpC,eAAW,QAAQ,OAAO,UAAU,OAAO,OAAO,CAAC,GAAG;AACpD,YAAM,MAAM,QAAQ,IAAI,KAAK,KAAK;AAClC,cAAQ;AAAA,QACN,KAAK;AAAA,QACL,MACI;AAAA,UACE,OAAO,KAAK;AAAA,UACZ,aAAa,IAAI,cAAc,KAAK;AAAA,UACpC,cAAc,IAAI,eAAe,KAAK;AAAA,UACtC,SAAS,IAAI,UAAU,KAAK;AAAA,QAC9B,IACA,EAAE,GAAG,KAAK;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACA,SAAO,CAAC,GAAG,QAAQ,OAAO,CAAC;AAC7B;AAOA,eAAsB,iBACpB,UACA,OACA,MACwB;AACxB,MAAI;AACF,UAAM,KAAK;AACX,WAAO;AAAA,EACT,SAAS,GAAG;AACV,UAAM,kBAAkB,UAAU,KAAK,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AACvD,WAAO,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;AAAA,EAClD;AACF;AAOO,SAAS,gBACd,UACA,SAC2G;AAC3G,QAAM,UAA2B,CAAC;AAClC,SAAO;AAAA,IACL,SAAS,CAAC,KAAK,YAAY;AACzB,cAAQ,KAAK,kBAAkB,UAAU,QAAQ,KAAK,OAAO,CAAC,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC,CAAC;AAAA,IACjF;AAAA,IACA,SAAS,YAAY;AACnB,YAAM,QAAQ,IAAI,OAAO;AAAA,IAC3B;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-Q7UF4ERB.js

@@ -1,74 +0,0 @@
-import {
-  writeOutput
-} from "./chunk-O4AXPEOE.js";
-
-// src/commands/images/providerHits.ts
-function asRecord(value) {
-  return value && typeof value === "object" ? value : {};
-}
-function str(value) {
-  return typeof value === "string" && value.length > 0 ? value : void 0;
-}
-function num(value) {
-  return typeof value === "number" ? value : void 0;
-}
-function compactHit(hit) {
-  return {
-    source: str(hit.source) ?? "",
-    url: str(hit.url) ?? "",
-    imageId: str(hit.imageId),
-    imageUrl: str(hit.imageUrl),
-    name: str(hit.name),
-    width: num(hit.width),
-    height: num(hit.height)
-  };
-}
-function providerHitNormalizer(record, full) {
-  const compact = compactHit(record);
-  if (!full) {
-    return compact;
-  }
-  const group = asRecord(record.group);
-  return {
-    ...compact,
-    externalUrl: str(record.externalUrl),
-    externalId: str(record.externalId),
-    description: str(record.description),
-    tags: Array.isArray(record.tags) ? record.tags : [],
-    aspectRatio: num(record.aspectRatio),
-    dominantColor: str(record.dominantColor),
-    score: num(record.score),
-    deduped: typeof record.deduped === "boolean" ? record.deduped : void 0,
-    alsoInLibrary: str(record.alsoInLibrary),
-    groupKey: str(group.key)
-  };
-}
-function readOutputFlags(args) {
-  const format = typeof args.output === "string" && args.output.length > 0 ? args.output : "json";
-  const rawFields = typeof args.fields === "string" && args.fields.length > 0 ? args.fields : void 0;
-  return {
-    format,
-    fields: rawFields ? rawFields.split(",").filter(Boolean) : void 0,
-    full: args.full === true
-  };
-}
-function writeProviderHits(data, hits, args, hints) {
-  const { format, fields, full } = readOutputFlags(args);
-  const envelope = {
-    ok: true,
-    data: format === "json" ? data : hits,
-    ...hints.length > 0 ? { hints } : {}
-  };
-  writeOutput(envelope, format, fields, full, providerHitNormalizer);
-}
-var OUTPUT_ARGS = {
-  output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
-  fields: { type: "string", description: "Comma-separated field names to include", required: false },
-  full: { type: "boolean", description: "Include full metadata", required: false, default: false }
-};
-
-export {
-  writeProviderHits,
-  OUTPUT_ARGS
-};
-//# sourceMappingURL=chunk-Q7UF4ERB.js.map

package/dist/chunk-QRXTDXMX.js

@@ -1,129 +0,0 @@
-import {
-  detectCopyTells,
-  detectHeadlineSetTells
-} from "./chunk-T5RKIWPQ.js";
-import {
-  CAPABILITY_SURFACE_SPECS
-} from "./chunk-ZJWUBJYQ.js";
-
-// src/commands/ads/boolean-word-positional.ts
-var BOOLEAN_WORD = /^(true|false)$/i;
-function booleanWordPositionalError(args, entity) {
-  const positionals = Array.isArray(args._) ? args._ : [];
-  const word = positionals.find((value2) => typeof value2 === "string" && BOOLEAN_WORD.test(value2));
-  if (word === void 0) {
-    return void 0;
-  }
-  const value = word.toLowerCase();
-  const raised = Object.keys(args).filter((key) => key !== "_" && args[key] === true);
-  const named = raised.length > 0 ? raised.map((flag) => `--${flag}`).join(" or ") : "a boolean flag";
-  const fix = raised.length > 0 ? raised.map((flag) => `--${flag}=${value}`).join(" or ") : `--<flag>=${value}`;
-  const negated = raised.length === 1 && value === "false" ? ` (or --no-${raised[0]})` : "";
-  return `"${word}" was read as the ${entity} target, not as a value for ${named}. A boolean flag written with a space is set to TRUE and the word is dropped \u2014 attach it instead: ${fix}${negated}.`;
-}
-
-// src/commands/capabilities/fix.ts
-function capabilityFix(surface) {
-  const spec = CAPABILITY_SURFACE_SPECS[surface];
-  return {
-    action: `baker capabilities ${surface}`,
-    explanation: `Do not guess another field name. \`baker capabilities ${surface}\` lists every ${spec.label} change with its required and optional fields and the exact values each field accepts, plus what cannot be changed here at all and why. Read it, then either re-stage correctly or tell the user this part is out of reach \u2014 and carry on with the rest of the job either way.`
-  };
-}
-
-// src/commands/ads/copy-hints.ts
-var NOT_APPLICABLE_TO_ADS = /* @__PURE__ */ new Set([
-  "title-case-heading",
-  "staccato-drama",
-  "emoji",
-  "curly-quote",
-  "inline-header-list"
-]);
-var COPY_KEYS = /* @__PURE__ */ new Set([
-  "headline",
-  "headlines",
-  "longheadline",
-  "longheadlines",
-  "shortheadline",
-  "shortheadlines",
-  "description",
-  "descriptions",
-  "primarytext",
-  "primarytexts",
-  "message",
-  "messages",
-  "commentary",
-  "body",
-  "bodies",
-  "text",
-  "calltoaction",
-  "linkdescription",
-  "sitelinktext",
-  "callout",
-  "callouts",
-  "introtext"
-]);
-var HEADLINE_SET_KEYS = /* @__PURE__ */ new Set(["headlines", "longheadlines", "shortheadlines"]);
-var MAX_HINTS = 5;
-var SYNONYM_PAIR_FLOOR = 2;
-function asStrings(value) {
-  const one = (v) => {
-    const text = typeof v === "string" ? v : v !== null && typeof v === "object" ? v.text : "";
-    return typeof text === "string" && text.trim() ? text : void 0;
-  };
-  const values = Array.isArray(value) ? value : [value];
-  return values.map(one).filter((v) => v !== void 0);
-}
-function collectCopy(value, depth = 0) {
-  const texts = [];
-  const headlineSets = [];
-  if (depth > 4 || value === null || typeof value !== "object") return { texts, headlineSets };
-  if (Array.isArray(value)) {
-    for (const item of value) {
-      const nested = collectCopy(item, depth + 1);
-      texts.push(...nested.texts);
-      headlineSets.push(...nested.headlineSets);
-    }
-    return { texts, headlineSets };
-  }
-  for (const [key, raw] of Object.entries(value)) {
-    const normalized = key.toLowerCase().replace(/[_-]/g, "");
-    const strings = COPY_KEYS.has(normalized) ? asStrings(raw) : [];
-    if (strings.length > 0) {
-      texts.push(...strings);
-      if (HEADLINE_SET_KEYS.has(normalized) && strings.length > 1) headlineSets.push(strings);
-      continue;
-    }
-    const nested = collectCopy(raw, depth + 1);
-    texts.push(...nested.texts);
-    headlineSets.push(...nested.headlineSets);
-  }
-  return { texts, headlineSets };
-}
-function hintFor(tell) {
-  if (tell.id === "synonym-cycling") {
-    return `AI COPY TELL \u2014 ${tell.count} headline pairs are the same claim reworded (${tell.sample}). A cycled set gives the auction nothing to choose between: make each headline a different claim, not a different verb.`;
-  }
-  return `AI COPY TELL (${tell.id}) \u2014 "${tell.sample}". This construction reads as machine-written; rewrite it as a plain, specific claim before publishing.`;
-}
-function adCopyHints(payload) {
-  const { texts, headlineSets } = collectCopy(payload);
-  if (texts.length === 0) return [];
-  const tells = detectCopyTells(texts.join("\n")).filter((t) => !NOT_APPLICABLE_TO_ADS.has(t.id));
-  for (const set of headlineSets) {
-    for (const tell of detectHeadlineSetTells(set)) {
-      if (tell.count >= SYNONYM_PAIR_FLOOR) tells.push(tell);
-    }
-  }
-  tells.sort(
-    (a, b) => (b.id === "synonym-cycling" ? 1 : 0) - (a.id === "synonym-cycling" ? 1 : 0) || b.count - a.count
-  );
-  return tells.slice(0, MAX_HINTS).map(hintFor);
-}
-
-export {
-  booleanWordPositionalError,
-  capabilityFix,
-  adCopyHints
-};
-//# sourceMappingURL=chunk-QRXTDXMX.js.map