@koda-sl/baker-cli 0.476.0 → 0.481.0-dev.2d33e194f

package/dist/chunk-FE7T32YL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/performance.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  CREATIVE_PERFORMANCE_DEFAULT_DAYS,\n  CREATIVE_PERFORMANCE_MAX_DAYS,\n  type CreativePerformance,\n  type CreativesPerformanceRequest,\n  type CreativesPerformanceResponse,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { parse as parseYaml } from \"yaml\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi } from \"../actions/shared.ts\";\n\nconst 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.\n\nStart here:\n  baker creatives performance                      # every creative in an ad, last 30 days\n  baker creatives performance --slug spring-offer  # one creative\n  baker creatives performance --days 14 --full     # ids, last-7-day figures, a video's watch funnel, one row per ad\n\nFatigue 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.`;\n\nconst ARGS = {\n  slug: { type: \"string\", description: \"Only this creative (src/creatives/<slug>/)\", required: false },\n  days: {\n    type: \"string\",\n    description: `Reporting window in days, ending today (1-${CREATIVE_PERFORMANCE_MAX_DAYS}, default ${CREATIVE_PERFORMANCE_DEFAULT_DAYS})`,\n    required: false,\n  },\n  full: {\n    type: \"boolean\",\n    description: \"Add ids, last-7-day CTR and cost per result, and one row per ad\",\n    required: false,\n    default: false,\n  },\n} as const;\n\nregisterSchema({ command: \"creatives.performance\", description: DESCRIPTION, args: ARGS });\n\n/**\n * Frontmatter keys that say what a creative set out to test (angle, hook, the\n * mechanism it uses and the slot it leads with) and which reference\n * ad it adapted. Anything named `source…` or `reference…` is kept too, so\n * reference fields added to the collection later come through without a CLI\n * release.\n */\nconst INSIGHT_KEYS = [\n  \"idea\",\n  \"message\",\n  \"evidence\",\n  \"angle\",\n  \"hook\",\n  \"mechanism\",\n  \"dominantSlot\",\n  \"persona\",\n  \"awareness\",\n  \"hypothesis\",\n];\nconst FRONTMATTER = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/;\n\nfunction insightValue(value: unknown): string | null {\n  if (typeof value === \"string\") return value.trim() || null;\n  if (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n  return null;\n}\n\n/** The insight fields of a `_definition.md`, or null when it names none. */\nexport function definitionInsights(markdown: string): Record<string, string> | null {\n  const block = FRONTMATTER.exec(markdown)?.[1];\n  if (!block) return null;\n  let parsed: unknown;\n  try {\n    parsed = parseYaml(block);\n  } catch {\n    return null;\n  }\n  if (parsed === null || typeof parsed !== \"object\") return null;\n  const insights: Record<string, string> = {};\n  for (const [key, raw] of Object.entries(parsed as Record<string, unknown>)) {\n    if (!(INSIGHT_KEYS.includes(key) || key.startsWith(\"source\") || key.startsWith(\"reference\"))) continue;\n    const value = insightValue(raw);\n    if (value !== null) insights[key] = value;\n  }\n  return Object.keys(insights).length > 0 ? insights : null;\n}\n\nfunction readLocalDefinition(slug: string): string | null {\n  try {\n    return readFileSync(path.join(process.cwd(), \"src\", \"creatives\", slug, \"_definition.md\"), \"utf8\");\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Definition fields whose values are compared by cost per result, each with\n * the advice its hint closes on. `label` is how the hint names the field.\n */\nconst COMPARED_FIELDS = [\n  { key: \"angle\", label: \"angle\", advice: \"Brief the next creative on the cheapest angle with a new hook.\" },\n  { key: \"mechanism\", label: \"mechanism\", advice: \"Brief the next creative on the cheapest mechanism.\" },\n  { key: \"dominantSlot\", label: \"dominant slot\", advice: \"Lead the next creative with the cheapest dominant slot.\" },\n] as const;\n\nfunction cheapestHint(\n  creatives: readonly CreativePerformance[],\n  { key, label, advice }: (typeof COMPARED_FIELDS)[number],\n): string | null {\n  const byValue = new Map<string, CreativePerformance>();\n  for (const creative of creatives) {\n    const value = creative.definition?.[key];\n    if (!value || creative.costPerResult === null) continue;\n    const best = byValue.get(value);\n    if (!best || (best.costPerResult ?? Number.POSITIVE_INFINITY) > creative.costPerResult)\n      byValue.set(value, creative);\n  }\n  if (byValue.size < 2) return null;\n  const ranked = [...byValue.entries()]\n    .sort(([, a], [, b]) => (a.costPerResult ?? 0) - (b.costPerResult ?? 0))\n    .map(\n      ([value, creative]) =>\n        `\"${value}\" ${creative.costPerResult}${creative.currency ? ` ${creative.currency}` : \"\"} (${creative.slug ?? creative.title})`,\n    );\n  return `Cost per result by ${label}: ${ranked.join(\", \")}. ${advice}`;\n}\n\n/**\n * Adds each creative's definition (read from the local repo, where the agent\n * works) and the hints that need it: which angle, mechanism and dominant slot\n * are cheapest, and which creatives say nothing about what they test.\n */\nexport function withDefinitions(\n  response: CreativesPerformanceResponse,\n  readDefinition: (slug: string) => string | null,\n): CreativesPerformanceResponse {\n  const creatives = response.data.creatives.map((creative) => {\n    const markdown = creative.slug ? readDefinition(creative.slug) : null;\n    const definition = markdown ? definitionInsights(markdown) : null;\n    return definition ? { ...creative, definition } : creative;\n  });\n  const hints = [...(response.hints ?? [])];\n  for (const field of COMPARED_FIELDS) {\n    const hint = cheapestHint(creatives, field);\n    if (hint) hints.push(hint);\n  }\n  const unnamed = creatives.filter((creative) => !creative.definition?.angle).map((c) => c.slug ?? c.title);\n  if (unnamed.length > 0) {\n    hints.push(\n      `No angle recorded for: ${unnamed.join(\", \")}. Add angle and hook to src/creatives/<slug>/_definition.md so results show which angle works.`,\n    );\n  }\n  return { ...response, data: { ...response.data, creatives }, ...(hints.length > 0 ? { hints } : {}) };\n}\n\n/** This read is live Meta only; the synced copy ranks every platform's creatives and says where each runs. */\nfunction syncedCreativesHint(slug: string | undefined): string {\n  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.`;\n}\n\nexport function parseDays(raw: string | undefined): number | undefined {\n  if (raw === undefined) return undefined;\n  const days = Number(raw);\n  if (!Number.isInteger(days) || days < 1 || days > CREATIVE_PERFORMANCE_MAX_DAYS) {\n    throw new Error(`--days must be a whole number from 1 to ${CREATIVE_PERFORMANCE_MAX_DAYS}`);\n  }\n  return days;\n}\n\nexport const performanceCommand = defineCommand({\n  meta: { name: \"performance\", description: DESCRIPTION },\n  args: ARGS,\n  run: async ({ args }) => {\n    try {\n      const body: CreativesPerformanceRequest = {};\n      const slug = args.slug as string | undefined;\n      if (slug) body.slug = slug;\n      const days = parseDays(args.days as string | undefined);\n      if (days !== undefined) body.days = days;\n      if (args.full) body.full = true;\n      const response = await apiPost<CreativesPerformanceResponse>(\"/api/creatives/performance\", body);\n      const out = withDefinitions(response, readLocalDefinition);\n      writeJson({ ...out, hints: [...(out.hints ?? []), syncedCreativesHint(slug)] });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/chunk-FIN4ZXGJ.js

@@ -0,0 +1,70 @@
+// src/commands/ads/x/error-parser.ts
+function mapXErrorCode(message) {
+  if (/UNAUTHORIZED_ACCESS|authentication/i.test(message)) return "AUTH_ERROR";
+  if (/UNAUTHORIZED_CLIENT_APPLICATION/i.test(message)) return "PERMISSION_DENIED";
+  if (/ACCOUNT_NOT_FOUND|NOT_FOUND/i.test(message)) return "ACCOUNT_NOT_FOUND";
+  if (/CAMPAIGN_NOT_FOUND/i.test(message)) return "CAMPAIGN_NOT_FOUND";
+  if (/LINE_ITEM_NOT_FOUND/i.test(message)) return "LINE_ITEM_NOT_FOUND";
+  if (/MEDIA_NOT_FOUND|TWEET_NOT_FOUND|TAILORED_AUDIENCE_NOT_FOUND/i.test(message)) return "RESOURCE_NOT_FOUND";
+  if (/TOO_MANY_REQUESTS|TWEET_RATE_LIMIT_EXCEEDED|rate.*limit/i.test(message)) return "QUOTA_EXCEEDED";
+  if (/SPEND_EXCEEDS_BUDGET/i.test(message)) return "BUDGET_EXCEEDED";
+  if (/INVALID_PARAMETER|MISSING_PARAMETER|EXCLUSIVE_PARAMETERS|INCLUSIVE_PARAMETERS/i.test(message))
+    return "INVALID_PARAMETER";
+  if (/SERVICE_UNAVAILABLE|OVER_CAPACITY|INTERNAL_ERROR/i.test(message)) return "SERVICE_UNAVAILABLE";
+  if (/CANCELLED_REQUEST|timeout|DEADLINE_EXCEEDED/i.test(message)) return "TIMEOUT";
+  return "API_ERROR";
+}
+function isRetryable(code) {
+  return code === "QUOTA_EXCEEDED" || code === "TIMEOUT" || code === "SERVICE_UNAVAILABLE";
+}
+function namedWaitMs(message) {
+  const seconds = /\bin (\d+)s\b/.exec(message)?.[1];
+  return seconds === void 0 ? void 0 : Number(seconds) * 1e3;
+}
+function getRetryDelay(code, message) {
+  if (code === "QUOTA_EXCEEDED") return namedWaitMs(message) ?? 6e4;
+  if (code === "SERVICE_UNAVAILABLE") return 15e3;
+  if (code === "TIMEOUT") return 5e3;
+  return void 0;
+}
+function parseXApiError(errorMessage, accountId) {
+  const code = mapXErrorCode(errorMessage);
+  return {
+    ok: false,
+    error: {
+      code,
+      message: errorMessage,
+      fix: {
+        action: code === "AUTH_ERROR" ? "authenticate" : code === "PERMISSION_DENIED" ? "authenticate" : isRetryable(code) ? "wait_and_retry" : "reject",
+        explanation: explainFix(code, accountId, errorMessage)
+      },
+      retryable: isRetryable(code),
+      retryAfterMs: getRetryDelay(code, errorMessage)
+    }
+  };
+}
+function explainFix(code, accountId, message) {
+  switch (code) {
+    case "AUTH_ERROR":
+      return "Token rejected by X. Reconnect the X Ads provider in Baker dashboard settings.";
+    case "PERMISSION_DENIED":
+      return "App not authorized for this resource. Verify Ads API access at ads.x.com/help and reconnect the provider.";
+    case "ACCOUNT_NOT_FOUND":
+      return `Account ${accountId} not accessible. Run 'baker ads x accounts' to list visible accounts.`;
+    case "QUOTA_EXCEEDED":
+      return "X Ads rate limit reached. Wait for retryAfterMs before asking X again; asking earlier is refused again and can get access throttled.";
+    case "INVALID_PARAMETER":
+      return `Invalid parameter sent to X Ads API: ${message}`;
+    case "BUDGET_EXCEEDED":
+      return "Spend exceeds available budget on the funding instrument.";
+    case "SERVICE_UNAVAILABLE":
+      return "X Ads API is temporarily unavailable. Retry after a short backoff.";
+    default:
+      return `Unrecognized X Ads error \u2014 verify request shape against X Ads API docs (${code}).`;
+  }
+}
+
+export {
+  parseXApiError
+};
+//# sourceMappingURL=chunk-FIN4ZXGJ.js.map

package/dist/chunk-FIN4ZXGJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/error-parser.ts"],"sourcesContent":["import type { AdsErrorEnvelope } from \"../types.ts\";\n\nfunction mapXErrorCode(message: string): string {\n  if (/UNAUTHORIZED_ACCESS|authentication/i.test(message)) return \"AUTH_ERROR\";\n  if (/UNAUTHORIZED_CLIENT_APPLICATION/i.test(message)) return \"PERMISSION_DENIED\";\n  if (/ACCOUNT_NOT_FOUND|NOT_FOUND/i.test(message)) return \"ACCOUNT_NOT_FOUND\";\n  if (/CAMPAIGN_NOT_FOUND/i.test(message)) return \"CAMPAIGN_NOT_FOUND\";\n  if (/LINE_ITEM_NOT_FOUND/i.test(message)) return \"LINE_ITEM_NOT_FOUND\";\n  if (/MEDIA_NOT_FOUND|TWEET_NOT_FOUND|TAILORED_AUDIENCE_NOT_FOUND/i.test(message)) return \"RESOURCE_NOT_FOUND\";\n  if (/TOO_MANY_REQUESTS|TWEET_RATE_LIMIT_EXCEEDED|rate.*limit/i.test(message)) return \"QUOTA_EXCEEDED\";\n  if (/SPEND_EXCEEDS_BUDGET/i.test(message)) return \"BUDGET_EXCEEDED\";\n  if (/INVALID_PARAMETER|MISSING_PARAMETER|EXCLUSIVE_PARAMETERS|INCLUSIVE_PARAMETERS/i.test(message))\n    return \"INVALID_PARAMETER\";\n  if (/SERVICE_UNAVAILABLE|OVER_CAPACITY|INTERNAL_ERROR/i.test(message)) return \"SERVICE_UNAVAILABLE\";\n  if (/CANCELLED_REQUEST|timeout|DEADLINE_EXCEEDED/i.test(message)) return \"TIMEOUT\";\n  return \"API_ERROR\";\n}\n\nfunction isRetryable(code: string): boolean {\n  return code === \"QUOTA_EXCEEDED\" || code === \"TIMEOUT\" || code === \"SERVICE_UNAVAILABLE\";\n}\n\n/** The wait Baker read off X's reset (\"… in 840s.\"), so a quota refusal is retried no earlier than X allows. */\nfunction namedWaitMs(message: string): number | undefined {\n  const seconds = /\\bin (\\d+)s\\b/.exec(message)?.[1];\n  return seconds === undefined ? undefined : Number(seconds) * 1000;\n}\n\nfunction getRetryDelay(code: string, message: string): number | undefined {\n  if (code === \"QUOTA_EXCEEDED\") return namedWaitMs(message) ?? 60_000;\n  if (code === \"SERVICE_UNAVAILABLE\") return 15_000;\n  if (code === \"TIMEOUT\") return 5_000;\n  return undefined;\n}\n\nexport function parseXApiError(errorMessage: string, accountId: string): AdsErrorEnvelope {\n  const code = mapXErrorCode(errorMessage);\n  return {\n    ok: false,\n    error: {\n      code,\n      message: errorMessage,\n      fix: {\n        action:\n          code === \"AUTH_ERROR\"\n            ? \"authenticate\"\n            : code === \"PERMISSION_DENIED\"\n              ? \"authenticate\"\n              : isRetryable(code)\n                ? \"wait_and_retry\"\n                : \"reject\",\n        explanation: explainFix(code, accountId, errorMessage),\n      },\n      retryable: isRetryable(code),\n      retryAfterMs: getRetryDelay(code, errorMessage),\n    },\n  };\n}\n\nfunction explainFix(code: string, accountId: string, message: string): string {\n  switch (code) {\n    case \"AUTH_ERROR\":\n      return \"Token rejected by X. Reconnect the X Ads provider in Baker dashboard settings.\";\n    case \"PERMISSION_DENIED\":\n      return \"App not authorized for this resource. Verify Ads API access at ads.x.com/help and reconnect the provider.\";\n    case \"ACCOUNT_NOT_FOUND\":\n      return `Account ${accountId} not accessible. Run 'baker ads x accounts' to list visible accounts.`;\n    case \"QUOTA_EXCEEDED\":\n      return \"X Ads rate limit reached. Wait for retryAfterMs before asking X again; asking earlier is refused again and can get access throttled.\";\n    case \"INVALID_PARAMETER\":\n      return `Invalid parameter sent to X Ads API: ${message}`;\n    case \"BUDGET_EXCEEDED\":\n      return \"Spend exceeds available budget on the funding instrument.\";\n    case \"SERVICE_UNAVAILABLE\":\n      return \"X Ads API is temporarily unavailable. Retry after a short backoff.\";\n    default:\n      return `Unrecognized X Ads error — verify request shape against X Ads API docs (${code}).`;\n  }\n}\n"],"mappings":";AAEA,SAAS,cAAc,SAAyB;AAC9C,MAAI,sCAAsC,KAAK,OAAO,EAAG,QAAO;AAChE,MAAI,mCAAmC,KAAK,OAAO,EAAG,QAAO;AAC7D,MAAI,+BAA+B,KAAK,OAAO,EAAG,QAAO;AACzD,MAAI,sBAAsB,KAAK,OAAO,EAAG,QAAO;AAChD,MAAI,uBAAuB,KAAK,OAAO,EAAG,QAAO;AACjD,MAAI,+DAA+D,KAAK,OAAO,EAAG,QAAO;AACzF,MAAI,2DAA2D,KAAK,OAAO,EAAG,QAAO;AACrF,MAAI,wBAAwB,KAAK,OAAO,EAAG,QAAO;AAClD,MAAI,iFAAiF,KAAK,OAAO;AAC/F,WAAO;AACT,MAAI,oDAAoD,KAAK,OAAO,EAAG,QAAO;AAC9E,MAAI,+CAA+C,KAAK,OAAO,EAAG,QAAO;AACzE,SAAO;AACT;AAEA,SAAS,YAAY,MAAuB;AAC1C,SAAO,SAAS,oBAAoB,SAAS,aAAa,SAAS;AACrE;AAGA,SAAS,YAAY,SAAqC;AACxD,QAAM,UAAU,gBAAgB,KAAK,OAAO,IAAI,CAAC;AACjD,SAAO,YAAY,SAAY,SAAY,OAAO,OAAO,IAAI;AAC/D;AAEA,SAAS,cAAc,MAAc,SAAqC;AACxE,MAAI,SAAS,iBAAkB,QAAO,YAAY,OAAO,KAAK;AAC9D,MAAI,SAAS,sBAAuB,QAAO;AAC3C,MAAI,SAAS,UAAW,QAAO;AAC/B,SAAO;AACT;AAEO,SAAS,eAAe,cAAsB,WAAqC;AACxF,QAAM,OAAO,cAAc,YAAY;AACvC,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL;AAAA,MACA,SAAS;AAAA,MACT,KAAK;AAAA,QACH,QACE,SAAS,eACL,iBACA,SAAS,sBACP,iBACA,YAAY,IAAI,IACd,mBACA;AAAA,QACV,aAAa,WAAW,MAAM,WAAW,YAAY;AAAA,MACvD;AAAA,MACA,WAAW,YAAY,IAAI;AAAA,MAC3B,cAAc,cAAc,MAAM,YAAY;AAAA,IAChD;AAAA,EACF;AACF;AAEA,SAAS,WAAW,MAAc,WAAmB,SAAyB;AAC5E,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,WAAW,SAAS;AAAA,IAC7B,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,wCAAwC,OAAO;AAAA,IACxD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO,gFAA2E,IAAI;AAAA,EAC1F;AACF;","names":[]}