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

package/dist/leads-MXUQISOC.js

@@ -1,293 +0,0 @@
-import {
-  bareAccountId,
-  loadJsonFileArg,
-  mergePayload,
-  stageOp
-} from "./chunk-QNEX7FEC.js";
-import {
-  isMetaLeadAdsRefusal
-} from "./chunk-GOJXKIFQ.js";
-import {
-  csvOrJson,
-  handleMetaError
-} from "./chunk-O3LHCQ7Q.js";
-import "./chunk-GKXMIXEV.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-D5MF337I.js";
-import {
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-LHNL6JM2.js";
-import "./chunk-VHMNSO2B.js";
-import "./chunk-65BQAJMH.js";
-import "./chunk-6GFJFTG6.js";
-import "./chunk-NAMEFVWL.js";
-import "./chunk-GT4UFORX.js";
-import "./chunk-CECS3DHZ.js";
-import "./chunk-XQIOCIDO.js";
-import {
-  ApiError,
-  apiGet
-} from "./chunk-KB5XJHQX.js";
-import "./chunk-YONSWWCF.js";
-import "./chunk-QXDEZKAR.js";
-import {
-  registerSchema
-} from "./chunk-4DM6OAQ6.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/leads.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "ads.meta.lead-forms",
-  description: "List the instant (lead) forms on a Facebook Page, with how many leads each has collected. Start here: a lead is fetched by form id. Use a Page from `baker ads meta pages` with hasPageAccessToken: true.",
-  args: {
-    "page-id": {
-      type: "string",
-      description: "Facebook Page ID \u2014 from `baker ads meta pages` with hasPageAccessToken: true",
-      required: true
-    },
-    full: { type: "boolean", description: "Include each form's questions", required: false },
-    output: { type: "string", description: "json|csv", required: false, default: "json" }
-  }
-});
-registerSchema({
-  command: "ads.meta.lead-forms.create",
-  description: "Start here to stage a Page-owned Meta Instant Form. The form is created only when this Session publishes. Use the returned meta_temp_* ref as --lead-form on a creative in the same Session.",
-  args: {
-    "account-id": { type: "string", description: "Selected Meta ad account, act_<id>", required: true },
-    "page-id": {
-      type: "string",
-      description: "Facebook Page that owns the form \u2014 choose one with this account in promotingAccountIds and hasPageAccessToken: true from `baker ads meta pages`",
-      required: true
-    },
-    name: { type: "string", description: "Form name", required: true },
-    questions: {
-      type: "string",
-      description: "Comma-separated Meta fields, e.g. FULL_NAME,EMAIL,PHONE",
-      required: true
-    },
-    "privacy-policy-url": { type: "string", description: "Public HTTPS privacy policy", required: true },
-    "follow-up-url": { type: "string", description: "Public HTTPS link after submission", required: true },
-    "optimized-for-quality": {
-      type: "boolean",
-      description: "Ask Meta to optimize form leads for quality",
-      required: false
-    },
-    file: {
-      type: "string",
-      description: "JSON file with full form payload, including thankYou and custom questions",
-      required: false
-    }
-  }
-});
-registerSchema({
-  command: "ads.meta.leads",
-  description: "Read the leads an instant form collected. Contact details (email, phone) come back masked; pass --full only when the raw values are genuinely needed, e.g. handing them to a CRM.",
-  args: {
-    "form-id": { type: "string", description: "Instant form ID \u2014 from `baker ads meta lead-forms`", required: false },
-    "ad-id": { type: "string", description: "Read the leads of one ad instead of a whole form", required: false },
-    since: { type: "string", description: "Earliest submission date, YYYY-MM-DD", required: false },
-    until: { type: "string", description: "Latest submission date, YYYY-MM-DD (inclusive)", required: false },
-    limit: { type: "string", description: "Leads per page (default 100, max 500)", required: false },
-    after: {
-      type: "string",
-      description: "Cursor from a previous call's nextCursor \u2014 fetches the following page",
-      required: false
-    },
-    full: { type: "boolean", description: "Return raw contact details instead of masked ones", required: false },
-    output: { type: "string", description: "json|csv", required: false, default: "json" }
-  }
-});
-var LEAD_FORMS_CAP = 500;
-function leadFormHints(forms) {
-  if (forms.length === 0) {
-    return ["This Page has NO instant forms. Nothing to read leads from \u2014 the form has to be created first."];
-  }
-  if (forms.length >= LEAD_FORMS_CAP) {
-    return [
-      `PARTIAL LIST \u2014 this Page has at least ${LEAD_FORMS_CAP} instant forms and only the first ${LEAD_FORMS_CAP} came back. Do not describe this as every form on the Page.`
-    ];
-  }
-  const empty = forms.filter((form) => (form.leads_count ?? 0) === 0);
-  if (empty.length === forms.length) {
-    return [
-      "Every form on this Page has collected 0 leads. That is a real, readable answer \u2014 the connection works. Do not retry and do not report it as a permissions problem."
-    ];
-  }
-  return [];
-}
-function handleLeadsError(err) {
-  if (err instanceof ApiError && err.code === "FORBIDDEN" && isMetaLeadAdsRefusal(err.message)) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        fix: { action: "reject", explanation: err.message },
-        retryable: false
-      }
-    });
-    process.exit(1);
-  }
-  handleMetaError(err);
-}
-function leadPageHints(page, full) {
-  const hints = [];
-  if (page.nextCursor) {
-    hints.push(
-      `PARTIAL PAGE \u2014 more leads exist. This is ${page.leads.length} of an unknown larger number; do NOT report it as a total. Fetch the next page with \`--after ${page.nextCursor}\` (repeat until no nextCursor), or narrow the window with --since/--until.`
-    );
-  }
-  if (!full) {
-    hints.push(
-      "Answers that give contact details (email, phone, any question asking for one) are masked. Report on them as they are; pass --full only when the raw values have to leave Baker (a CRM hand-off), and never paste them into the chat otherwise."
-    );
-  }
-  hints.push(...page.hints ?? []);
-  return hints;
-}
-var leadFormsCreateCommand = defineCommand({
-  meta: {
-    name: "create",
-    description: `Stage a Meta Instant Form on a Facebook Page. The form appears in review and is created only when the Session publishes.
-Choose a Page with this account in promotingAccountIds and hasPageAccessToken: true from \`baker ads meta pages\`.
-Example: baker ads meta lead-forms create --account-id act_123 --page-id 456 --name "Free audit" --questions FULL_NAME,EMAIL,PHONE --privacy-policy-url https://example.com/privacy --follow-up-url https://example.com`
-  },
-  args: {
-    "account-id": { type: "string", description: "Selected Meta ad account" },
-    "page-id": { type: "string", description: "Facebook Page ID" },
-    name: { type: "string", description: "Form name" },
-    questions: { type: "string", description: "FULL_NAME,EMAIL,PHONE or other Meta fields" },
-    "privacy-policy-url": { type: "string", description: "HTTPS privacy policy" },
-    "follow-up-url": { type: "string", description: "HTTPS thank-you link" },
-    "optimized-for-quality": { type: "boolean", description: "Optimize form leads for quality" },
-    file: { type: "string", description: "JSON form payload; flags override file keys" }
-  },
-  run: async ({ args }) => {
-    const accountId = bareAccountId(args);
-    const payload = mergePayload(loadJsonFileArg(args.file), {
-      page_id: args["page-id"],
-      name: args.name,
-      questions: typeof args.questions === "string" ? args.questions.split(",").map((type) => ({ type: type.trim().toUpperCase() })) : void 0,
-      privacyPolicyUrl: args["privacy-policy-url"],
-      followUpActionUrl: args["follow-up-url"],
-      optimizedForQuality: args["optimized-for-quality"]
-    });
-    await stageOp({ kind: "leadForm.create", accountId, payload });
-  }
-});
-var leadFormsListArgs = {
-  "page-id": { type: "string", description: "Facebook Page ID" },
-  full: { type: "boolean", description: "Include each form's questions" },
-  output: { type: "string", description: "Output format", default: "json" }
-};
-var leadFormsListCommand = defineCommand({
-  meta: {
-    name: "list",
-    description: "List the Instant Forms on a Facebook Page, with lead counts. Choose a Page with hasPageAccessToken: true from `baker ads meta pages`. Pass --full to include questions."
-  },
-  args: leadFormsListArgs,
-  run: async ({ args }) => {
-    try {
-      const pageId = args["page-id"];
-      if (!pageId) {
-        handleLeadsError(
-          new Error(
-            "--page-id is required. Run `baker ads meta pages` and choose a Page with hasPageAccessToken: true."
-          )
-        );
-      }
-      const params = { "page-id": pageId };
-      if (args.full) params.full = "true";
-      const data = await apiGet("/api/ads/meta/lead-forms", params);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        writeAdsOutput(data, fmt);
-        return;
-      }
-      const hints = leadFormHints(data);
-      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
-    } catch (err) {
-      handleLeadsError(err);
-    }
-  }
-});
-var leadFormsCommand = defineCommand({
-  meta: {
-    name: "lead-forms",
-    description: `List Instant Forms on a Facebook Page or stage a new one.
-Examples:
-  baker ads meta lead-forms --page-id 100635183117758
-  baker ads meta lead-forms --page-id 100635183117758 --full
-  baker ads meta lead-forms create --account-id act_123 --page-id 555 --file form.json`
-  },
-  args: leadFormsListArgs,
-  subCommands: { list: leadFormsListCommand, create: leadFormsCreateCommand },
-  default: "list"
-});
-var leadsCommand = defineCommand({
-  meta: {
-    name: "leads",
-    description: `Read the leads an instant form collected. Every question comes back; email and phone answers are MASKED unless you pass --full, so you can report on what a form is collecting without moving contact details around.
-
-Examples:
-  baker ads meta leads --form-id 987654321
-  baker ads meta leads --form-id 987654321 --since 2026-08-01 --until 2026-08-31
-  baker ads meta leads --ad-id 6123456789 --limit 50
-  baker ads meta leads --form-id 987654321 --after <nextCursor>   # the next page
-  baker ads meta leads --form-id 987654321 --full            # raw contact details \u2014 only when handing leads over
-
-Results are PAGED. A response carrying \`nextCursor\` is not the whole set \u2014 follow it before reporting any total.`
-  },
-  args: {
-    "form-id": { type: "string", description: "Instant form ID (from `baker ads meta lead-forms`)" },
-    "ad-id": { type: "string", description: "Read one ad's leads instead of a whole form" },
-    since: { type: "string", description: "Earliest submission date, YYYY-MM-DD" },
-    until: { type: "string", description: "Latest submission date, YYYY-MM-DD (inclusive)" },
-    limit: { type: "string", description: "Leads per page (default 100, max 500)" },
-    after: { type: "string", description: "Cursor from a previous call's nextCursor" },
-    full: { type: "boolean", description: "Return raw contact details instead of masked ones" },
-    output: { type: "string", description: "Output format", default: "json" }
-  },
-  run: async ({ args }) => {
-    try {
-      const formId = args["form-id"];
-      const adId = args["ad-id"];
-      if (!formId && !adId) {
-        handleLeadsError(new Error("Pass --form-id (from `baker ads meta lead-forms`) or --ad-id."));
-      }
-      const params = {};
-      if (formId) params["form-id"] = formId;
-      if (adId) params["ad-id"] = adId;
-      if (args.since) params.since = args.since;
-      if (args.until) params.until = args.until;
-      if (args.limit) params.limit = String(args.limit);
-      if (args.after) params.after = String(args.after);
-      if (args.full) params.full = "true";
-      const page = await apiGet("/api/ads/meta/leads", params);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        writeAdsOutput(page.leads, fmt);
-        return;
-      }
-      writeJsonEnvelope({
-        ok: true,
-        data: page.leads,
-        ...page.nextCursor ? { nextCursor: page.nextCursor } : {},
-        hints: leadPageHints(page, args.full === true)
-      });
-    } catch (err) {
-      handleLeadsError(err);
-    }
-  }
-});
-export {
-  leadFormHints,
-  leadFormsCommand,
-  leadPageHints,
-  leadsCommand
-};
-//# sourceMappingURL=leads-MXUQISOC.js.map

package/dist/leads-UJVKPRXX.js

@@ -1,90 +0,0 @@
-import {
-  csvOrJson,
-  handleLinkedinError,
-  resolveAccountIdArg
-} from "./chunk-LMHVLUD4.js";
-import {
-  writeAdsJson,
-  writeAdsOutput
-} from "./chunk-LHNL6JM2.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-DL2W4N7J.js";
-import "./chunk-OI7KSXZM.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-I2DNBEV6.js";
-import {
-  apiGet
-} from "./chunk-KB5XJHQX.js";
-import "./chunk-YONSWWCF.js";
-import "./chunk-QXDEZKAR.js";
-import "./chunk-4DM6OAQ6.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/linkedin/leads.ts
-import { defineCommand } from "citty";
-var DAY_MS = 864e5;
-var leadsCommand = defineCommand({
-  meta: {
-    name: "leads",
-    description: `List Lead Gen Form responses (playbook \xA707).
-
-LinkedIn retains LGF responses for 90 days only \u2014 sync to your CRM via this
-endpoint or you'll lose them.
-
-Examples:
-  baker ads linkedin leads --account-id 503001492
-  baker ads linkedin leads --account-id 503001492 --campaign-id 1234
-  baker ads linkedin leads --account-id 503001492 --form-id 5678 --since-days 7
-  baker ads linkedin leads --account-id 503001492 --output csv`
-  },
-  args: {
-    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
-    "account-urn": { type: "string", description: "Alias for --account-id" },
-    "form-id": { type: "string", description: "Filter by Lead Gen Form ID" },
-    "campaign-id": { type: "string", description: "Filter by campaign ID" },
-    "since-days": { type: "string", description: "Only responses submitted in the last N days" },
-    "since-ms": {
-      type: "string",
-      description: "Only responses submitted at or after this epoch ms (alternative to --since-days)"
-    },
-    limit: { type: "string", description: "Max rows (default: 500)" },
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
-  },
-  run: async ({ args }) => {
-    const accountId = resolveAccountIdArg(args);
-    try {
-      const params = { "account-id": accountId };
-      if (args["form-id"]) params["form-id"] = String(args["form-id"]);
-      if (args["campaign-id"]) params["campaign-id"] = String(args["campaign-id"]);
-      const sinceDays = args["since-days"] ? Number(args["since-days"]) : void 0;
-      const sinceMs = args["since-ms"] ? Number(args["since-ms"]) : sinceDays ? Date.now() - sinceDays * DAY_MS : void 0;
-      if (sinceMs) params["since-ms"] = String(sinceMs);
-      if (args.limit) params.limit = String(args.limit);
-      if (args["no-cache"]) params["skip-cache"] = "true";
-      const data = await apiGet("/api/ads/linkedin/leads", params);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        const flat = data.map((r) => ({
-          id: r.id,
-          formId: r.formId,
-          campaignUrn: r.campaignUrn,
-          submittedAt: r.submittedAt ? new Date(r.submittedAt).toISOString() : "",
-          answers: (r.answers ?? []).map((a) => `${a.question}: ${a.answer}`).join(" | ")
-        }));
-        writeAdsOutput(flat, fmt);
-        return;
-      }
-      writeAdsJson({ ok: true, data });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-export {
-  leadsCommand
-};
-//# sourceMappingURL=leads-UJVKPRXX.js.map

package/dist/learn-XTEU4K66.js

@@ -1,203 +0,0 @@
-import {
-  parseDays,
-  withDefinitions
-} from "./chunk-FE7T32YL.js";
-import {
-  setDefinitionFields
-} from "./chunk-BBBZR7MF.js";
-import {
-  IDEAS_DIR,
-  readIdeas
-} from "./chunk-ZLU5QDLU.js";
-import "./chunk-D5MF337I.js";
-import "./chunk-VHMNSO2B.js";
-import {
-  findWorkspaceRoot
-} from "./chunk-65BQAJMH.js";
-import "./chunk-FYAWA3FO.js";
-import "./chunk-CAMX6OHF.js";
-import "./chunk-6GFJFTG6.js";
-import "./chunk-NAMEFVWL.js";
-import "./chunk-GT4UFORX.js";
-import "./chunk-CECS3DHZ.js";
-import {
-  failApi
-} from "./chunk-NORAJYUI.js";
-import "./chunk-OI7KSXZM.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-I2DNBEV6.js";
-import {
-  apiPost
-} from "./chunk-KB5XJHQX.js";
-import "./chunk-YONSWWCF.js";
-import "./chunk-QXDEZKAR.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-4DM6OAQ6.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/creatives/learn.ts
-import { readFileSync } from "fs";
-import { readFile, writeFile } from "fs/promises";
-import path from "path";
-import { defineCommand } from "citty";
-
-// src/commands/creatives/learn-model.ts
-var MIN_IMPRESSIONS = 1e3;
-var SEEN_ENOUGH = 5e3;
-var WINNER_RATIO = 0.8;
-var WINNER_MIN_RESULTS = 3;
-var FAILED_RATIO = 1.5;
-var SILENT_SPEND = 2;
-var SETTLED = /* @__PURE__ */ new Set(["winner", "failed", "inconclusive"]);
-var round = (n) => Math.round(n * 100) / 100;
-function totals(creatives) {
-  const spend = creatives.reduce((sum, c) => sum + c.spend, 0);
-  const impressions = creatives.reduce((sum, c) => sum + c.impressions, 0);
-  const results = creatives.reduce((sum, c) => sum + (c.results ?? 0), 0);
-  const clicks = creatives.reduce((sum, c) => sum + (c.ctr ?? 0) * c.impressions, 0);
-  return { spend, impressions, results, ctr: impressions > 0 ? round(clicks / impressions) : null };
-}
-function verdict(result, usual) {
-  if (result.impressions < MIN_IMPRESSIONS) return "testing";
-  if (usual !== null) {
-    if (result.results === 0 && result.spend >= SILENT_SPEND * usual) return "failed";
-    const ratio = result.vsAccount;
-    if (ratio !== null && result.results >= WINNER_MIN_RESULTS && ratio <= WINNER_RATIO) return "winner";
-    if (ratio !== null && ratio >= FAILED_RATIO) return "failed";
-  }
-  return result.impressions >= SEEN_ENOUGH ? "inconclusive" : "testing";
-}
-function ideaResult(own, usual, asOf) {
-  const mine = totals(own);
-  const costPerResult = mine.results > 0 ? round(mine.spend / mine.results) : null;
-  return {
-    asOf,
-    creatives: own.length,
-    ...own[0]?.currency ? { currency: own[0].currency } : {},
-    spend: round(mine.spend),
-    impressions: mine.impressions,
-    results: mine.results,
-    costPerResult,
-    ctr: mine.ctr,
-    vsAccount: usual !== null && costPerResult !== null ? round(costPerResult / usual) : null
-  };
-}
-function learnFromResults(ideas, creatives, asOf) {
-  const ideaOf = (c) => c.definition?.idea ?? null;
-  return ideas.flatMap((idea) => {
-    if (idea.status === "idea" || idea.status === "retired") return [];
-    const own = creatives.filter((c) => ideaOf(c) === idea.id);
-    if (own.length === 0) return [];
-    const rest = totals(creatives.filter((c) => ideaOf(c) !== idea.id));
-    const usual = rest.results > 0 ? rest.spend / rest.results : null;
-    const result = ideaResult(own, usual, asOf);
-    const to = verdict(result, usual);
-    if (to === "testing" && SETTLED.has(idea.status)) return [];
-    return [{ idea: idea.id, from: idea.status, to, result }];
-  });
-}
-
-// src/commands/creatives/learn.ts
-var DESCRIPTION = `Write back what each built idea's ads did in the live Meta account: every creative of the idea pooled, judged against the rest of the account's cost per result, and the verdict (winner, failed, inconclusive, testing) and frozen numbers written onto src/creatives/_ideas/<idea>.md. Run it before writing new ideas, and weekly.
-
-Start here:
-  baker creatives learn               # last 30 days, written onto the ideas
-  baker creatives learn --days 60
-  baker creatives learn --dry-run     # show the verdicts, write nothing
-
-A winner gets results at 0.8x the usual cost or less (3+ results); failed is 1.5x or more, or spend worth two usual results with none; under 1,000 impressions it is still testing.`;
-var ARGS = {
-  days: { type: "string", required: false, description: "Reporting window in days (default 30)" },
-  "dry-run": { type: "boolean", required: false, default: false, description: "Show the verdicts; write nothing" }
-};
-registerSchema({ command: "creatives.learn", description: DESCRIPTION, args: ARGS });
-function learnEnvelope(learnings, written, unreadable = []) {
-  const winners = learnings.filter((l) => l.to === "winner").map((l) => l.idea);
-  const failed = learnings.filter((l) => l.to === "failed").map((l) => l.idea);
-  const hints = [];
-  if (unreadable.length > 0) {
-    hints.push(
-      `Could not read ${unreadable.join(", ")}, so their results were not written: fix what \`baker creatives ideas\` names, then run this again.`
-    );
-  }
-  if (learnings.length === 0) {
-    hints.push(
-      "No built idea has ads delivering yet: nothing to learn. Ideas count once a published ad shows their creative."
-    );
-  }
-  if (winners.length > 0) {
-    hints.push(
-      `Build on ${winners.join(", ")}: keep the message and make it in a new format or for a new persona before any new idea.`
-    );
-  }
-  if (failed.length > 0) {
-    hints.push(
-      `${failed.join(", ")} lost: never repeat their message; \`baker creatives ideas\` flags an idea that does.`
-    );
-  }
-  return {
-    ok: true,
-    data: {
-      written,
-      ideas: learnings.map((l) => ({
-        idea: l.idea,
-        status: l.from === l.to ? l.to : `${l.from} \u2192 ${l.to}`,
-        ...l.result
-      }))
-    },
-    hints
-  };
-}
-async function writeBack(root, learnings) {
-  for (const learning of learnings) {
-    const file = path.join(root, IDEAS_DIR, `${learning.idea}.md`);
-    const raw = await readFile(file, "utf8");
-    await writeFile(file, setDefinitionFields(raw, { status: learning.to, result: learning.result }), "utf8");
-  }
-}
-function readDefinition(root, slug) {
-  try {
-    return readFileSync(path.join(root, "src", "creatives", slug, "_definition.md"), "utf8");
-  } catch {
-    return null;
-  }
-}
-function today() {
-  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-}
-var learnCommand = defineCommand({
-  meta: { name: "learn", description: DESCRIPTION },
-  args: ARGS,
-  async run({ args }) {
-    try {
-      const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
-      const days = parseDays(args.days);
-      const performance = withDefinitions(
-        await apiPost("/api/creatives/performance", days ? { days } : {}),
-        (slug) => readDefinition(root, slug)
-      );
-      const { ideas, unreadable } = await readIdeas(root);
-      const learnings = learnFromResults(ideas, performance.data.creatives, today());
-      const dryRun = args["dry-run"] === true;
-      if (!dryRun) await writeBack(root, learnings);
-      writeJson(
-        learnEnvelope(
-          learnings,
-          !dryRun && learnings.length > 0,
-          unreadable.map((u) => u.id)
-        )
-      );
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-export {
-  learnCommand,
-  learnEnvelope
-};
-//# sourceMappingURL=learn-XTEU4K66.js.map

package/dist/learn-XTEU4K66.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/creatives/learn.ts","../src/commands/creatives/learn-model.ts"],"sourcesContent":["/**\n * `baker creatives learn`: what the ads each idea became did in the live account, written back\n * onto the idea (its `status` and a frozen `result`), so the next chat builds on winners and\n * never repeats a message that lost.\n */\nimport { readFileSync } from \"node:fs\";\nimport { readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { CreativesPerformanceResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi } from \"../actions/shared.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { IDEAS_DIR, readIdeas } from \"./ideas-workspace.ts\";\nimport { type IdeaLearning, learnFromResults } from \"./learn-model.ts\";\nimport { setDefinitionFields } from \"./make-model.ts\";\nimport { parseDays, withDefinitions } from \"./performance.ts\";\n\nconst DESCRIPTION = `Write back what each built idea's ads did in the live Meta account: every creative of the idea pooled, judged against the rest of the account's cost per result, and the verdict (winner, failed, inconclusive, testing) and frozen numbers written onto src/creatives/_ideas/<idea>.md. Run it before writing new ideas, and weekly.\n\nStart here:\n  baker creatives learn               # last 30 days, written onto the ideas\n  baker creatives learn --days 60\n  baker creatives learn --dry-run     # show the verdicts, write nothing\n\nA winner gets results at 0.8x the usual cost or less (3+ results); failed is 1.5x or more, or spend worth two usual results with none; under 1,000 impressions it is still testing.`;\n\nconst ARGS = {\n  days: { type: \"string\", required: false, description: \"Reporting window in days (default 30)\" },\n  \"dry-run\": { type: \"boolean\", required: false, default: false, description: \"Show the verdicts; write nothing\" },\n} as const;\n\nregisterSchema({ command: \"creatives.learn\", description: DESCRIPTION, args: ARGS });\n\n/** What the agent reads, and what to do with winners and losers. Pure. */\nexport function learnEnvelope(\n  learnings: readonly IdeaLearning[],\n  written: boolean,\n  unreadable: readonly string[] = [],\n) {\n  const winners = learnings.filter((l) => l.to === \"winner\").map((l) => l.idea);\n  const failed = learnings.filter((l) => l.to === \"failed\").map((l) => l.idea);\n  const hints: string[] = [];\n  if (unreadable.length > 0) {\n    hints.push(\n      `Could not read ${unreadable.join(\", \")}, so their results were not written: fix what \\`baker creatives ideas\\` names, then run this again.`,\n    );\n  }\n  if (learnings.length === 0) {\n    hints.push(\n      \"No built idea has ads delivering yet: nothing to learn. Ideas count once a published ad shows their creative.\",\n    );\n  }\n  if (winners.length > 0) {\n    hints.push(\n      `Build on ${winners.join(\", \")}: keep the message and make it in a new format or for a new persona before any new idea.`,\n    );\n  }\n  if (failed.length > 0) {\n    hints.push(\n      `${failed.join(\", \")} lost: never repeat their message; \\`baker creatives ideas\\` flags an idea that does.`,\n    );\n  }\n  return {\n    ok: true as const,\n    data: {\n      written,\n      ideas: learnings.map((l) => ({\n        idea: l.idea,\n        status: l.from === l.to ? l.to : `${l.from} → ${l.to}`,\n        ...l.result,\n      })),\n    },\n    hints,\n  };\n}\n\nasync function writeBack(root: string, learnings: readonly IdeaLearning[]): Promise<void> {\n  for (const learning of learnings) {\n    const file = path.join(root, IDEAS_DIR, `${learning.idea}.md`);\n    const raw = await readFile(file, \"utf8\");\n    await writeFile(file, setDefinitionFields(raw, { status: learning.to, result: learning.result }), \"utf8\");\n  }\n}\n\nfunction readDefinition(root: string, slug: string): string | null {\n  try {\n    return readFileSync(path.join(root, \"src\", \"creatives\", slug, \"_definition.md\"), \"utf8\");\n  } catch {\n    return null;\n  }\n}\n\nfunction today(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n\nexport const learnCommand = defineCommand({\n  meta: { name: \"learn\", description: DESCRIPTION },\n  args: ARGS,\n  async run({ args }) {\n    try {\n      const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();\n      const days = parseDays(args.days as string | undefined);\n      const performance = withDefinitions(\n        await apiPost<CreativesPerformanceResponse>(\"/api/creatives/performance\", days ? { days } : {}),\n        (slug) => readDefinition(root, slug),\n      );\n      const { ideas, unreadable } = await readIdeas(root);\n      const learnings = learnFromResults(ideas, performance.data.creatives, today());\n      const dryRun = args[\"dry-run\"] === true;\n      if (!dryRun) await writeBack(root, learnings);\n      writeJson(\n        learnEnvelope(\n          learnings,\n          !dryRun && learnings.length > 0,\n          unreadable.map((u) => u.id),\n        ),\n      );\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n","/**\n * What the ads an idea became did, written back onto the idea: `baker creatives learn` turns\n * performance into a verdict per idea, so the next chat starts from what won and what lost\n * instead of from zero. Pure.\n */\nimport type { CreativePerformance } from \"@baker/api\";\nimport type { Idea, IdeaStatus } from \"./ideas-model.ts\";\n\n/** Below this many impressions an idea has not been seen enough to call. */\nconst MIN_IMPRESSIONS = 1000;\n/** Seen this much with no clear verdict, an idea is inconclusive rather than still testing. */\nconst SEEN_ENOUGH = 5000;\n/** At or under this share of the account's usual cost per result, with enough results: a winner. */\nconst WINNER_RATIO = 0.8;\nconst WINNER_MIN_RESULTS = 3;\n/** At or over this share of the usual cost per result: failed. */\nconst FAILED_RATIO = 1.5;\n/** Spending this many usual results' worth with none: failed. */\nconst SILENT_SPEND = 2;\n/** Verdicts a thin window never takes back: too little delivery says nothing new about them. */\nconst SETTLED: ReadonlySet<IdeaStatus> = new Set([\"winner\", \"failed\", \"inconclusive\"]);\n\nexport type IdeaResult = {\n  asOf: string;\n  creatives: number;\n  currency?: string;\n  spend: number;\n  impressions: number;\n  results: number;\n  costPerResult: number | null;\n  ctr: number | null;\n  /** Cost per result over the rest of the account's: 0.5 is half the usual cost. */\n  vsAccount: number | null;\n};\n\nexport type IdeaLearning = { idea: string; from: IdeaStatus; to: IdeaStatus; result: IdeaResult };\n\nconst round = (n: number) => Math.round(n * 100) / 100;\n\nfunction totals(creatives: readonly CreativePerformance[]) {\n  const spend = creatives.reduce((sum, c) => sum + c.spend, 0);\n  const impressions = creatives.reduce((sum, c) => sum + c.impressions, 0);\n  const results = creatives.reduce((sum, c) => sum + (c.results ?? 0), 0);\n  const clicks = creatives.reduce((sum, c) => sum + (c.ctr ?? 0) * c.impressions, 0);\n  return { spend, impressions, results, ctr: impressions > 0 ? round(clicks / impressions) : null };\n}\n\nfunction verdict(result: IdeaResult, usual: number | null): IdeaStatus {\n  if (result.impressions < MIN_IMPRESSIONS) return \"testing\";\n  if (usual !== null) {\n    if (result.results === 0 && result.spend >= SILENT_SPEND * usual) return \"failed\";\n    const ratio = result.vsAccount;\n    if (ratio !== null && result.results >= WINNER_MIN_RESULTS && ratio <= WINNER_RATIO) return \"winner\";\n    if (ratio !== null && ratio >= FAILED_RATIO) return \"failed\";\n  }\n  return result.impressions >= SEEN_ENOUGH ? \"inconclusive\" : \"testing\";\n}\n\n/** One idea's ads pooled into the numbers frozen on it, against the account's usual cost per result. */\nfunction ideaResult(own: readonly CreativePerformance[], usual: number | null, asOf: string): IdeaResult {\n  const mine = totals(own);\n  const costPerResult = mine.results > 0 ? round(mine.spend / mine.results) : null;\n  return {\n    asOf,\n    creatives: own.length,\n    ...(own[0]?.currency ? { currency: own[0].currency } : {}),\n    spend: round(mine.spend),\n    impressions: mine.impressions,\n    results: mine.results,\n    costPerResult,\n    ctr: mine.ctr,\n    vsAccount: usual !== null && costPerResult !== null ? round(costPerResult / usual) : null,\n  };\n}\n\n/**\n * Each built idea's ads, pooled and judged against the rest of the account: cheaper results than\n * usual win, far dearer ones (or spend with none) fail. Ideas still to build, retired, with no\n * ad delivering, or already judged and seen too little since, are left alone.\n */\nexport function learnFromResults(\n  ideas: readonly Idea[],\n  creatives: readonly CreativePerformance[],\n  asOf: string,\n): IdeaLearning[] {\n  const ideaOf = (c: CreativePerformance) => c.definition?.idea ?? null;\n  return ideas.flatMap((idea): IdeaLearning[] => {\n    if (idea.status === \"idea\" || idea.status === \"retired\") return [];\n    const own = creatives.filter((c) => ideaOf(c) === idea.id);\n    if (own.length === 0) return [];\n    const rest = totals(creatives.filter((c) => ideaOf(c) !== idea.id));\n    const usual = rest.results > 0 ? rest.spend / rest.results : null;\n    const result = ideaResult(own, usual, asOf);\n    const to = verdict(result, usual);\n    if (to === \"testing\" && SETTLED.has(idea.status)) return [];\n    return [{ idea: idea.id, from: idea.status, to, result }];\n  });\n}\n"],"mappings":"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","names":[]}