@koda-sl/baker-cli 0.447.0-dev.f5788a631 → 0.447.0

package/dist/chunk-EVYXTT7V.js

@@ -1,417 +0,0 @@
-import {
-  NUMERIC_ID_REGEX
-} from "./chunk-XML7AJM3.js";
-
-// ../api/src/ads-google/change-history.ts
-var CHANGE_SCOPES = ["detail", "summary"];
-var CHANGE_SCOPE_MAX_DAYS = {
-  detail: 30,
-  summary: 90
-};
-var DEFAULT_CHANGE_DAYS = 7;
-var MAX_CHANGE_DAYS = CHANGE_SCOPE_MAX_DAYS.summary;
-function isChangeLookbackWithinReach(days, scope) {
-  return days <= CHANGE_SCOPE_MAX_DAYS[scope];
-}
-
-// ../api/src/ads-google/url-options.ts
-import { z } from "zod";
-var URL_OPTION_LEVELS = ["account", "campaign", "ad_group", "ad"];
-var googleUrlOptionValueSchema = z.discriminatedUnion("state", [
-  z.object({ state: z.literal("set"), value: z.string() }),
-  z.object({ state: z.literal("not_set") }),
-  z.object({ state: z.literal("not_read"), reason: z.string() })
-]);
-var googleUrlOptionsRequestSchema = z.object({
-  customerId: z.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
-  managerId: z.string().optional(),
-  /** Compact by default: only campaigns that actually override the account. `full` lists every campaign. */
-  full: z.boolean().optional(),
-  skipCache: z.boolean().optional()
-});
-var googleUrlOptionsCampaignSchema = z.object({
-  id: z.string(),
-  name: z.string(),
-  status: z.string(),
-  final_url_suffix: googleUrlOptionValueSchema,
-  tracking_url_template: googleUrlOptionValueSchema
-});
-var googleUrlOptionsResponseSchema = z.object({
-  customer_id: z.string(),
-  account: z.object({
-    level: z.literal("account"),
-    read: z.boolean(),
-    final_url_suffix: googleUrlOptionValueSchema,
-    tracking_url_template: googleUrlOptionValueSchema
-  }),
-  campaigns: z.object({
-    level: z.literal("campaign"),
-    read: z.boolean(),
-    /** Campaigns actually observed. 0 with `read: true` means the account has no non-removed campaigns. */
-    campaigns_read: z.number().int().nonnegative(),
-    /** Campaigns observed to carry no override of their own — an explicit finding, not an omission. */
-    campaigns_without_override: z.number().int().nonnegative(),
-    overrides: z.array(googleUrlOptionsCampaignSchema),
-    /** Compact mode only: campaigns read but not listed because they carry no override. */
-    omitted: z.number().int().nonnegative()
-  }),
-  /** Levels this command never queried. Nothing here may be reported as "not configured". */
-  levels_not_read: z.array(z.object({ level: z.enum(URL_OPTION_LEVELS), reason: z.string() }))
-});
-var ACCOUNT_URL_OPTIONS_LOCATION = "Google Ads UI \u2192 Admin \u2192 Account settings \u2192 Tracking (account-level tracking template and final URL suffix)";
-var ACCOUNT_URL_OPTIONS_NOT_STAGEABLE = "Account-level URL options are written by a different Google service than the one Baker's staged changes apply through, so they can't be staged or published from here.";
-function isSet(value) {
-  return value.state === "set";
-}
-function urlOptionsHints(report) {
-  const hints = [];
-  const { account, campaigns } = report;
-  if (!account.read) {
-    hints.push(
-      "The account level did NOT read \u2014 its URL options are unknown, not empty. Re-run before telling the user anything about account-wide tagging."
-    );
-  } else if (account.final_url_suffix.state === "not_set") {
-    hints.push(
-      `No account-level final URL suffix is set. An account-wide parameter (agency/partner tagging such as utm_agency=\u2026) belongs at the account level so it reaches every ad \u2014 set it in ${ACCOUNT_URL_OPTIONS_LOCATION}. ${ACCOUNT_URL_OPTIONS_NOT_STAGEABLE}`
-    );
-  }
-  if (!campaigns.read) {
-    hints.push(
-      "Campaign-level URL options did NOT read \u2014 do not report that no campaign overrides exist. Re-run before concluding."
-    );
-  } else {
-    const overriding = campaigns.overrides.filter((c) => isSet(c.final_url_suffix));
-    if (overriding.length > 0) {
-      const named = overriding.slice(0, 5).map((c) => c.name || c.id).join(", ");
-      hints.push(
-        `A campaign's final URL suffix REPLACES the account-level one for that campaign \u2014 it does not merge. ${overriding.length} campaign(s) set their own (${named}${overriding.length > 5 ? ", \u2026" : ""}) and will not pick up an account-wide parameter until their own suffix carries it too. Every other campaign read here inherits the account level normally.`
-      );
-    }
-  }
-  const overridingLevelsNotRead = report.levels_not_read.filter((level) => level.level !== "account");
-  if (overridingLevelsNotRead.length > 0) {
-    hints.push(
-      `Not read at this level: ${overridingLevelsNotRead.map((l) => l.level).join(", ")}. A suffix set there still wins over the levels above it.`
-    );
-  }
-  if (campaigns.omitted > 0) {
-    hints.push(`${campaigns.omitted} campaign(s) read with no override of their own are not listed \u2014 pass --full.`);
-  }
-  return hints;
-}
-
-// ../api/src/ads-google/geo-constants.ts
-var GEO_TARGET_COUNTRIES = {
-  "2004": "Afghanistan",
-  "2008": "Albania",
-  "2010": "Antarctica",
-  "2012": "Algeria",
-  "2016": "American Samoa",
-  "2020": "Andorra",
-  "2024": "Angola",
-  "2028": "Antigua and Barbuda",
-  "2031": "Azerbaijan",
-  "2032": "Argentina",
-  "2036": "Australia",
-  "2040": "Austria",
-  "2044": "The Bahamas",
-  "2048": "Bahrain",
-  "2050": "Bangladesh",
-  "2051": "Armenia",
-  "2052": "Barbados",
-  "2056": "Belgium",
-  "2060": "Bermuda",
-  "2064": "Bhutan",
-  "2068": "Bolivia",
-  "2070": "Bosnia and Herzegovina",
-  "2072": "Botswana",
-  "2074": "Bouvet Island",
-  "2076": "Brazil",
-  "2084": "Belize",
-  "2086": "British Indian Ocean Territory",
-  "2090": "Solomon Islands",
-  "2092": "British Virgin Islands",
-  "2096": "Brunei",
-  "2100": "Bulgaria",
-  "2104": "Myanmar (Burma)",
-  "2108": "Burundi",
-  "2112": "Belarus",
-  "2116": "Cambodia",
-  "2120": "Cameroon",
-  "2124": "Canada",
-  "2132": "Cabo Verde",
-  "2136": "Cayman Islands",
-  "2140": "Central African Republic",
-  "2144": "Sri Lanka",
-  "2148": "Chad",
-  "2152": "Chile",
-  "2156": "China",
-  "2158": "Taiwan",
-  "2162": "Christmas Island",
-  "2166": "Cocos (Keeling) Islands",
-  "2170": "Colombia",
-  "2174": "Comoros",
-  "2175": "Mayotte",
-  "2178": "Republic of the Congo",
-  "2180": "Democratic Republic of the Congo",
-  "2184": "Cook Islands",
-  "2188": "Costa Rica",
-  "2191": "Croatia",
-  "2196": "Cyprus",
-  "2203": "Czechia",
-  "2204": "Benin",
-  "2208": "Denmark",
-  "2212": "Dominica",
-  "2214": "Dominican Republic",
-  "2218": "Ecuador",
-  "2222": "El Salvador",
-  "2226": "Equatorial Guinea",
-  "2231": "Ethiopia",
-  "2232": "Eritrea",
-  "2233": "Estonia",
-  "2234": "Faroe Islands",
-  "2238": "Falkland Islands (Islas Malvinas)",
-  "2239": "South Georgia and the South Sandwich Islands",
-  "2242": "Fiji",
-  "2246": "Finland",
-  "2250": "France",
-  "2254": "French Guiana",
-  "2258": "French Polynesia",
-  "2260": "French Southern and Antarctic Lands",
-  "2262": "Djibouti",
-  "2266": "Gabon",
-  "2268": "Georgia",
-  "2270": "The Gambia",
-  "2275": "Palestine",
-  "2276": "Germany",
-  "2288": "Ghana",
-  "2292": "Gibraltar",
-  "2296": "Kiribati",
-  "2300": "Greece",
-  "2304": "Greenland",
-  "2308": "Grenada",
-  "2312": "Guadeloupe",
-  "2316": "Guam",
-  "2320": "Guatemala",
-  "2324": "Guinea",
-  "2328": "Guyana",
-  "2332": "Haiti",
-  "2334": "Heard Island and McDonald Islands",
-  "2336": "Vatican City",
-  "2340": "Honduras",
-  "2344": "Hong Kong",
-  "2348": "Hungary",
-  "2352": "Iceland",
-  "2356": "India",
-  "2360": "Indonesia",
-  "2368": "Iraq",
-  "2372": "Ireland",
-  "2376": "Israel",
-  "2380": "Italy",
-  "2384": "Cote d'Ivoire",
-  "2388": "Jamaica",
-  "2392": "Japan",
-  "2398": "Kazakhstan",
-  "2400": "Jordan",
-  "2404": "Kenya",
-  "2410": "South Korea",
-  "2414": "Kuwait",
-  "2417": "Kyrgyzstan",
-  "2418": "Laos",
-  "2422": "Lebanon",
-  "2426": "Lesotho",
-  "2428": "Latvia",
-  "2430": "Liberia",
-  "2434": "Libya",
-  "2438": "Liechtenstein",
-  "2440": "Lithuania",
-  "2442": "Luxembourg",
-  "2446": "Macao",
-  "2450": "Madagascar",
-  "2454": "Malawi",
-  "2458": "Malaysia",
-  "2462": "Maldives",
-  "2466": "Mali",
-  "2470": "Malta",
-  "2474": "Martinique",
-  "2478": "Mauritania",
-  "2480": "Mauritius",
-  "2484": "Mexico",
-  "2492": "Monaco",
-  "2496": "Mongolia",
-  "2498": "Moldova",
-  "2499": "Montenegro",
-  "2500": "Montserrat",
-  "2504": "Morocco",
-  "2508": "Mozambique",
-  "2512": "Oman",
-  "2516": "Namibia",
-  "2520": "Nauru",
-  "2524": "Nepal",
-  "2528": "Netherlands",
-  "2531": "Curacao",
-  "2533": "Aruba",
-  "2534": "Sint Maarten",
-  "2535": "Caribbean Netherlands",
-  "2540": "New Caledonia",
-  "2548": "Vanuatu",
-  "2554": "New Zealand",
-  "2558": "Nicaragua",
-  "2562": "Niger",
-  "2566": "Nigeria",
-  "2570": "Niue",
-  "2574": "Norfolk Island",
-  "2578": "Norway",
-  "2580": "Northern Mariana Islands",
-  "2581": "United States Minor Outlying Islands",
-  "2583": "Micronesia",
-  "2584": "Marshall Islands",
-  "2585": "Palau",
-  "2586": "Pakistan",
-  "2591": "Panama",
-  "2598": "Papua New Guinea",
-  "2600": "Paraguay",
-  "2604": "Peru",
-  "2608": "Philippines",
-  "2612": "Pitcairn Islands",
-  "2616": "Poland",
-  "2620": "Portugal",
-  "2624": "Guinea-Bissau",
-  "2626": "Timor-Leste",
-  "2630": "Puerto Rico",
-  "2634": "Qatar",
-  "2638": "Reunion",
-  "2642": "Romania",
-  "2643": "Russia",
-  "2646": "Rwanda",
-  "2652": "Saint Barthelemy",
-  "2654": "Saint Helena, Ascension and Tristan da Cunha",
-  "2659": "Saint Kitts and Nevis",
-  "2660": "Anguilla",
-  "2662": "Saint Lucia",
-  "2663": "Saint Martin",
-  "2666": "Saint Pierre and Miquelon",
-  "2670": "Saint Vincent and the Grenadines",
-  "2674": "San Marino",
-  "2678": "Sao Tome and Principe",
-  "2682": "Saudi Arabia",
-  "2686": "Senegal",
-  "2688": "Serbia",
-  "2690": "Seychelles",
-  "2694": "Sierra Leone",
-  "2702": "Singapore",
-  "2703": "Slovakia",
-  "2704": "Vietnam",
-  "2705": "Slovenia",
-  "2706": "Somalia",
-  "2710": "South Africa",
-  "2716": "Zimbabwe",
-  "2724": "Spain",
-  "2728": "South Sudan",
-  "2732": "Western Sahara",
-  "2736": "Sudan",
-  "2740": "Suriname",
-  "2744": "Svalbard and Jan Mayen",
-  "2748": "Eswatini",
-  "2752": "Sweden",
-  "2756": "Switzerland",
-  "2760": "Syria",
-  "2762": "Tajikistan",
-  "2764": "Thailand",
-  "2768": "Togo",
-  "2772": "Tokelau",
-  "2776": "Tonga",
-  "2780": "Trinidad and Tobago",
-  "2784": "United Arab Emirates",
-  "2788": "Tunisia",
-  "2792": "Turkiye",
-  "2795": "Turkmenistan",
-  "2796": "Turks and Caicos Islands",
-  "2798": "Tuvalu",
-  "2800": "Uganda",
-  "2804": "Ukraine",
-  "2807": "North Macedonia",
-  "2818": "Egypt",
-  "2826": "United Kingdom",
-  "2831": "Guernsey",
-  "2832": "Jersey",
-  "2833": "Isle of Man",
-  "2834": "Tanzania",
-  "2840": "United States",
-  "2850": "U.S. Virgin Islands",
-  "2854": "Burkina Faso",
-  "2858": "Uruguay",
-  "2860": "Uzbekistan",
-  "2862": "Venezuela",
-  "2876": "Wallis and Futuna",
-  "2882": "Samoa",
-  "2887": "Yemen",
-  "2894": "Zambia",
-  "2900": "Kosovo"
-};
-var LANGUAGE_CONSTANTS = {
-  "1000": "English",
-  "1001": "German",
-  "1002": "French",
-  "1003": "Spanish",
-  "1004": "Italian",
-  "1005": "Japanese",
-  "1009": "Danish",
-  "1010": "Dutch",
-  "1011": "Finnish",
-  "1012": "Korean",
-  "1013": "Norwegian",
-  "1014": "Portuguese",
-  "1015": "Swedish",
-  "1017": "Chinese (simplified)",
-  "1018": "Chinese (traditional)",
-  "1019": "Arabic",
-  "1020": "Bulgarian",
-  "1021": "Czech",
-  "1022": "Greek",
-  "1023": "Hindi",
-  "1024": "Hungarian",
-  "1025": "Indonesian",
-  "1026": "Icelandic",
-  "1027": "Hebrew",
-  "1028": "Latvian",
-  "1029": "Lithuanian",
-  "1030": "Polish",
-  "1031": "Russian",
-  "1032": "Romanian",
-  "1033": "Slovak",
-  "1034": "Slovenian",
-  "1035": "Serbian",
-  "1036": "Ukrainian",
-  "1037": "Turkish",
-  "1038": "Catalan",
-  "1039": "Croatian",
-  "1040": "Vietnamese",
-  "1041": "Urdu",
-  "1042": "Filipino",
-  "1043": "Estonian",
-  "1044": "Thai",
-  "1056": "Bengali",
-  "1064": "Persian",
-  "1072": "Gujarati",
-  "1086": "Kannada",
-  "1098": "Malayalam",
-  "1101": "Marathi",
-  "1102": "Malay",
-  "1110": "Punjabi",
-  "1130": "Tamil",
-  "1131": "Telugu"
-};
-
-export {
-  CHANGE_SCOPES,
-  CHANGE_SCOPE_MAX_DAYS,
-  DEFAULT_CHANGE_DAYS,
-  isChangeLookbackWithinReach,
-  GEO_TARGET_COUNTRIES,
-  LANGUAGE_CONSTANTS,
-  ACCOUNT_URL_OPTIONS_LOCATION,
-  ACCOUNT_URL_OPTIONS_NOT_STAGEABLE,
-  urlOptionsHints
-};
-//# sourceMappingURL=chunk-EVYXTT7V.js.map

package/dist/chunk-F46KAIBS.js

@@ -1,159 +0,0 @@
-import {
-  failApi
-} from "./chunk-NTPXZU3V.js";
-import {
-  CREATIVE_PERFORMANCE_DEFAULT_DAYS,
-  CREATIVE_PERFORMANCE_MAX_DAYS
-} from "./chunk-6HJAHLLA.js";
-import {
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-NU7JSWVA.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 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);
-      writeJson(withDefinitions(response, readLocalDefinition));
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-
-export {
-  definitionInsights,
-  withDefinitions,
-  parseDays,
-  performanceCommand
-};
-//# sourceMappingURL=chunk-F46KAIBS.js.map