@koda-sl/baker-cli 0.477.0-dev.55c09e3e8 → 0.495.0-dev.c2b64ccca

package/dist/chunk-EJH2JOVG.js

@@ -0,0 +1,98 @@
+import {
+  ApiError
+} from "./chunk-OSWCEDFE.js";
+
+// src/commands/research/output.ts
+var RESEARCH_DATA_NOTE = "Estimates based on third-party SERP data \u2014 not exact figures. Use for directional insights, not precise measurement.";
+function writeResearchJson(envelope) {
+  process.stdout.write(`${JSON.stringify(envelope, null, 2)}
+`);
+}
+function toCsvRow(values) {
+  return values.map((v) => {
+    if (v.includes(",") || v.includes('"') || v.includes("\n")) {
+      return `"${v.replace(/"/g, '""')}"`;
+    }
+    return v;
+  }).join(",");
+}
+function flattenRow(row) {
+  const flat = {};
+  for (const [key, val] of Object.entries(row)) {
+    flat[key] = typeof val === "object" && val !== null ? JSON.stringify(val) : String(val ?? "");
+  }
+  return flat;
+}
+function writeCsv(data, fields) {
+  if (data.length === 0) return;
+  const cols = fields ?? Object.keys(data[0] ?? {});
+  process.stdout.write(`${toCsvRow(cols)}
+`);
+  for (const row of data) {
+    const flat = flattenRow(row);
+    process.stdout.write(`${toCsvRow(cols.map((f) => flat[f] ?? ""))}
+`);
+  }
+}
+function writeJsonl(data) {
+  for (const row of data) {
+    process.stdout.write(`${JSON.stringify(row)}
+`);
+  }
+}
+function writeMd(data, fields) {
+  if (data.length === 0) return;
+  const cols = fields ?? Object.keys(data[0] ?? {});
+  process.stdout.write(`| ${cols.join(" | ")} |
+`);
+  process.stdout.write(`| ${cols.map(() => "---").join(" | ")} |
+`);
+  for (const row of data) {
+    const flat = flattenRow(row);
+    process.stdout.write(`| ${cols.map((f) => markdownCell(flat[f] ?? "")).join(" | ")} |
+`);
+  }
+}
+function markdownCell(value) {
+  return value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+}
+function writeResearchOutput(data, format, fields) {
+  switch (format) {
+    case "csv":
+      writeCsv(data, fields);
+      break;
+    case "jsonl":
+      writeJsonl(data);
+      break;
+    case "md":
+      writeMd(data, fields);
+      break;
+    default:
+      writeResearchJson({ ok: true, data });
+  }
+}
+function writeResearchHints(hints, format) {
+  if (format === "json") {
+    return;
+  }
+  for (const hint of hints) {
+    process.stderr.write(`${hint}
+`);
+  }
+}
+function handleResearchError(err, fixFor) {
+  const code = err instanceof ApiError ? err.code : "NETWORK_ERROR";
+  const message = err instanceof ApiError ? err.message : err instanceof Error ? err.message : "Unexpected error";
+  const fix = fixFor?.(code);
+  writeResearchJson({ ok: false, error: { code, message, ...fix ? { fix } : {} } });
+  process.exit(1);
+}
+
+export {
+  RESEARCH_DATA_NOTE,
+  writeResearchJson,
+  writeResearchOutput,
+  writeResearchHints,
+  handleResearchError
+};
+//# sourceMappingURL=chunk-EJH2JOVG.js.map

package/dist/chunk-EJWFD6T3.js

@@ -0,0 +1,188 @@
+import {
+  analyticsErrorEnvelope
+} from "./chunk-G373L4GL.js";
+import {
+  PEOPLE_SEARCH_MAX_TERMS,
+  parsePeopleQuery,
+  peopleLookupRequestSchema
+} from "./chunk-BC2BXRXY.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-OTNGMKI6.js";
+import {
+  apiPost
+} from "./chunk-OSWCEDFE.js";
+import {
+  registerSchema
+} from "./chunk-4WYEGE4N.js";
+
+// src/commands/analytics/lookup.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+function peopleArgs(args2) {
+  const parts = peopleParts(args2);
+  if (parts.length === 0) return {};
+  const people = parsePeopleQuery(parts).terms.map((term) => term.input);
+  return people.length === 0 ? {} : { people };
+}
+function peopleParts(args2) {
+  return [...args2.person ? [String(args2.person)] : [], ...args2["people-file"] ? [readPeopleFile(args2)] : []];
+}
+function readPeopleFile(args2) {
+  try {
+    return readFileSync(String(args2["people-file"]), "utf8");
+  } catch {
+    return "";
+  }
+}
+function unreadablePeopleFile(args2) {
+  if (!args2["people-file"]) return void 0;
+  const path = String(args2["people-file"]);
+  try {
+    readFileSync(path, "utf8");
+    return void 0;
+  } catch {
+    return `Couldn't read --people-file ${path}. Check the path, or pass the people inline with --person.`;
+  }
+}
+function peopleLimitError(args2) {
+  const unreadable = unreadablePeopleFile(args2);
+  if (unreadable !== void 0) return unreadable;
+  const { terms, dropped } = parsePeopleQuery(peopleParts(args2));
+  if (dropped === 0) return void 0;
+  return `${terms.length + dropped} people named; one search takes up to ${PEOPLE_SEARCH_MAX_TERMS}. Split the list and run each part.`;
+}
+function compactRow(row) {
+  const clicks = [...row.googleClick ? ["google"] : [], ...row.metaClick ? ["meta"] : []];
+  const candidates = {
+    input: row.input,
+    readAs: row.kind,
+    found: row.found,
+    problem: row.problem,
+    contacts: row.contacts,
+    events: row.events,
+    firstSeen: row.firstSeen,
+    lastSeen: row.lastSeen,
+    pageViews: row.pageViews,
+    landings: row.landings,
+    visits: row.visits,
+    formSubmits: row.formSubmits,
+    firstSource: row.firstSource,
+    systemEvents: row.systemEvents,
+    pageEvents: row.pageEvents,
+    uploads: row.uploads,
+    uploadedTo: row.uploadedTo,
+    clicks,
+    knownBy: row.knownBy
+  };
+  return Object.fromEntries(
+    Object.entries(candidates).filter(
+      ([key, value]) => key === "found" || !(value === 0 || value === "" || Array.isArray(value) && value.length === 0)
+    )
+  );
+}
+function lookupHints(data) {
+  const hints = [];
+  if (data.dropped > 0) {
+    hints.push(
+      `${data.dropped} lines past the limit of ${PEOPLE_SEARCH_MAX_TERMS} were not looked up. Run the rest separately.`
+    );
+  }
+  const unseen = data.people.filter((row) => !row.found && row.problem === "");
+  if (unseen.length > 0) {
+    hints.push(
+      `Not seen by Baker: ${unseen.map((row) => row.input).join(", ")}. Baker knows a person by what its pages, Forms and connected systems recorded \u2014 a lead that came in through a form or site Baker does not measure, or a source not connected, is not here.`
+    );
+  }
+  for (const row of data.people.filter((person) => person.problem !== "")) {
+    hints.push(`${row.input}: ${row.problem}`);
+  }
+  const found = data.people.filter((row) => row.found);
+  const neverVisited = found.filter((row) => row.pageViews === 0);
+  if (neverVisited.length > 0) {
+    hints.push(
+      `${neverVisited.length} of ${found.length} found never visited a page Baker publishes: Baker knows them only from what their systems reported, so no landing can be credited with them.`
+    );
+  }
+  if (found.length > 0) {
+    hints.push(
+      `\`baker analytics feed --person '${found[0]?.input}' --days 90\` lists everything one of them did, in order \u2014 add more, comma-separated, to follow several.`
+    );
+  }
+  return hints;
+}
+function lookupReport(data, full = false) {
+  const found = data.people.filter((row) => row.found);
+  return {
+    summary: {
+      searched: data.people.length,
+      found: found.length,
+      notFound: data.people.length - found.length,
+      visitedABakerPage: found.filter((row) => row.pageViews > 0).length
+    },
+    people: full ? data.people : data.people.map(compactRow),
+    hints: lookupHints(data)
+  };
+}
+var NO_PEOPLE = "Name at least one person: --person 'ana@empresa.com, deal:40001234567' or --people-file leads.txt.";
+var args = {
+  person: {
+    type: "string",
+    description: "The people, comma-separated: an email, a phone (+34\u2026), a HubSpot contact id, deal:<HubSpot deal id>, a gclid/fbclid, a browser id. Prefix to be exact: email:, phone:, hubspot:, deal:, gclid:, fbclid:, browser:",
+    required: false
+  },
+  "people-file": {
+    type: "string",
+    description: "A file with one person per line \u2014 a column pasted from a CRM export",
+    required: false
+  },
+  full: {
+    type: "boolean",
+    description: "Every field of every line, zeros included",
+    required: false
+  }
+};
+registerSchema({
+  command: "analytics.lookup",
+  description: "What Baker saw of each person in a list, by email, phone, CRM id, deal or click id",
+  args
+});
+var lookupCommand = defineCommand({
+  meta: {
+    name: "lookup",
+    description: `What Baker saw of each person in a list \u2014 all time, one line each \u2014 by whatever the client holds about them. The reconciliation question: "HubSpot says 26 leads yesterday, which of them does Baker have, and where did they come from".
+
+Start here:
+  baker analytics lookup --person 'ana@empresa.com, +34600111222, 90001234567'
+  baker analytics lookup --person 'deal:40001234567, deal:40001234568'   \u2014 HubSpot deal ids, looked up through the deal's contacts
+  baker analytics lookup --people-file leads.txt                           \u2014 one per line, up to ${PEOPLE_SEARCH_MAX_TERMS}
+
+Each line says whether Baker has them, when it first and last saw them, the pages and Forms they touched, what their systems reported (systemEvents: CRM stages, orders), what Baker uploaded for them to ad platforms, which ad click they carried, and every kind of key they are linked by. A bare number is read as a HubSpot contact id or a phone; prefix it to be exact. Emails and phones are hashed by Baker \u2014 say them to the client as they gave them, never as a hash. Follow one with \`baker analytics feed --person <same value>\`.`
+  },
+  args,
+  run: async ({ args: raw }) => {
+    const { people } = peopleArgs(raw);
+    const parsed = peopleLookupRequestSchema.safeParse({ people: people ?? [] });
+    const invalid = peopleLimitError(raw) ?? (parsed.success ? void 0 : NO_PEOPLE);
+    if (invalid !== void 0 || !parsed.success) {
+      writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message: invalid ?? NO_PEOPLE } });
+      process.exit(1);
+    }
+    try {
+      const response = await apiPost("/api/analytics/people", parsed.data);
+      const { hints, ...data } = lookupReport(response.data, raw.full === true);
+      writeJsonEnvelope({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
+    } catch (error) {
+      writeJsonEnvelope({ ok: false, error: analyticsErrorEnvelope(error) });
+      process.exit(1);
+    }
+  }
+});
+
+export {
+  peopleArgs,
+  peopleLimitError,
+  lookupReport,
+  lookupCommand
+};
+//# sourceMappingURL=chunk-EJWFD6T3.js.map

package/dist/chunk-ELNN4SNW.js

@@ -0,0 +1,52 @@
+import {
+  commandFor,
+  declaredArg
+} from "./chunk-4WYEGE4N.js";
+
+// src/cache-flag.ts
+var NO_CACHE_ARG = {
+  type: "boolean",
+  description: "Skip cached results and read live from the platform (slower)",
+  required: false
+};
+var LEGACY = "--skip-cache";
+var CANONICAL = "--no-cache";
+var PARSEABLE = "--noCache";
+function respell(token, from, to) {
+  if (token === from) {
+    return [to];
+  }
+  if (!token.startsWith(`${from}=`)) {
+    return [token];
+  }
+  return token.slice(from.length + 1) === "false" ? [] : [to];
+}
+function normalizeCacheFlag(argv) {
+  return rewriteBeforeDoubleDash(argv, (token) => respell(token, LEGACY, CANONICAL));
+}
+function cacheFlagForCommand(root, argv) {
+  if (!argv.includes(CANONICAL)) {
+    return argv;
+  }
+  const command = commandFor(root, argv);
+  if (!command || declaredArg(command, "no-cache")) {
+    return argv;
+  }
+  return rewriteBeforeDoubleDash(argv, (token) => token === CANONICAL ? [] : [token]);
+}
+function cacheFlagForParser(argv) {
+  return rewriteBeforeDoubleDash(argv, (token) => respell(token, CANONICAL, PARSEABLE));
+}
+function rewriteBeforeDoubleDash(argv, rewrite) {
+  const end = argv.indexOf("--");
+  const limit = end === -1 ? argv.length : end;
+  return argv.flatMap((token, index) => index >= limit ? [token] : rewrite(token));
+}
+
+export {
+  NO_CACHE_ARG,
+  normalizeCacheFlag,
+  cacheFlagForCommand,
+  cacheFlagForParser
+};
+//# sourceMappingURL=chunk-ELNN4SNW.js.map

package/dist/chunk-ELYP6BOS.js

@@ -0,0 +1,156 @@
+import {
+  Phrases,
+  RULE_APPLIES,
+  RULE_KINDS,
+  RULE_STRENGTHS
+} from "./chunk-S4ROJTDY.js";
+import {
+  holdWorkspaceSpend
+} from "./chunk-6FHP2HIK.js";
+import {
+  askAboutText
+} from "./chunk-QEW64BBR.js";
+import {
+  CREATIVE_FEEDBACK_REASON_LABELS
+} from "./chunk-MV2J73HP.js";
+
+// src/commands/creatives/rule-candidate.ts
+import { createHash } from "crypto";
+import { mkdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { z } from "zod";
+var optionalPhrases = Phrases.optional().catch(void 0);
+var Draft = z.object({
+  because: z.string().trim().min(3).max(400),
+  text: z.string().trim().min(1).max(300),
+  strength: z.enum(RULE_STRENGTHS).catch("must"),
+  applies: z.enum(RULE_APPLIES).catch("any"),
+  language: z.string().trim().regex(/^[a-z]{2,3}$/).optional().catch(void 0),
+  kinds: z.array(z.enum(RULE_KINDS)).optional().catch(void 0),
+  platforms: optionalPhrases,
+  forbid: optionalPhrases,
+  require: optionalPhrases,
+  allow: optionalPhrases,
+  people: z.literal("real").optional().catch(void 0)
+});
+function parseDrafts(answer) {
+  const rules = answer?.rules;
+  if (!Array.isArray(rules)) return [];
+  return rules.slice(0, MAX_DRAFTS).flatMap((raw) => {
+    const draft = Draft.safeParse(raw);
+    if (!draft.success) return [];
+    const { because: _because, ...rule } = draft.data;
+    return [
+      Object.fromEntries(
+        Object.entries(rule).filter(([, v]) => v !== void 0 && !(Array.isArray(v) && v.length === 0))
+      )
+    ];
+  });
+}
+var MAX_DRAFTS = 3;
+function draftRulesPrompt(note, ad) {
+  const where = [ad.kind ? `a ${ad.kind} ad` : "an ad", ad.platform ? `for ${ad.platform}` : ""].filter(Boolean).join(" ");
+  return [
+    `A person rejected ${where} and said, in their own words:`,
+    `"""${note}"""`,
+    "",
+    "List only the standing rules this note states for EVERY future ad of the company (at most 3). Most notes state none: they ask for changes to this ad (fix a word, move the logo, speed up a scene, redo the pieces), and a change to this ad is never a rule, however it is phrased. A rule is standing only when the note itself says it holds beyond this ad (always, never, in every video, in these creatives, these mistakes keep happening, it is the format of the programme, the rule of the other pieces), or it corrects how the company or what it sells must always be named.",
+    "For each rule, quote in `because` the note's own words that make it hold beyond this ad; a rule you cannot quote that for is not a rule. Return JSON only:",
+    '{"rules": [{"because": string, "text": string, "strength": "never" | "must" | "prefer", "applies": "copy" | "picture" | "cast" | "logo" | "voice" | "sound" | "subtitles" | "any", "language": string, "kinds": ["static" | "video"], "platforms": string[], "forbid": string[], "require": string[], "allow": string[], "people": "real" | null}]}',
+    "- text: the rule in one short sentence, in the note's own language and close to its words.",
+    '- strength: "never" for a ban, "must" for something every ad has to do, "prefer" for a taste.',
+    '- applies: what of the ad it is about ("copy" for its words, "picture", "cast" for who appears, "logo", "voice", "sound", "subtitles"), else "any".',
+    `- language: the note's language as a two-letter code ("es").`,
+    '- kinds and platforms: only when the note limits the rule to them ("en estos creativos de linkedin" gives platforms ["linkedin"]); else [].',
+    `- forbid: the exact words the rule bans in the ad's words, only when a word or phrase decides it ("100 % online", not "online" gives forbid ["online"], allow ["100 % online"]); else []. require: words every ad must say; usually []. allow: the right phrase that contains a banned word.`,
+    '- people: "real" only when the rule is that no AI-made or invented people appear; else null.',
+    'Return {"rules": []} when the note states no standing rule.'
+  ].join("\n");
+}
+var RULE_DRAFT_MODEL = "google/gemini-3.5-flash";
+var DRAFT_REQUEST = {
+  provider: { order: ["google-vertex"], allow_fallbacks: false },
+  seed: 0,
+  reasoning: { effort: "low" },
+  response_format: { type: "json_object" }
+};
+var DRAFT_TIMEOUT_MS = 3e4;
+function modelRuleDrafter(cacheDir) {
+  return async (note, ad) => {
+    const prompt = draftRulesPrompt(note, ad);
+    const key = createHash("sha256").update(JSON.stringify([RULE_DRAFT_MODEL, prompt])).digest("hex").slice(0, 16);
+    const file = path.join(cacheDir, "rule-drafts", `${key}.json`);
+    const cached = await readFile(file, "utf8").then(
+      (raw) => parseDrafts(JSON.parse(raw)),
+      () => null
+    );
+    if (cached) return cached;
+    const spent = [];
+    const answer = await askAboutText(RULE_DRAFT_MODEL, prompt, (u) => spent.push(u), {
+      timeoutMs: DRAFT_TIMEOUT_MS,
+      request: DRAFT_REQUEST
+    }).catch(() => null);
+    await holdWorkspaceSpend(spent);
+    if (answer === null) return [];
+    await mkdir(path.dirname(file), { recursive: true }).catch(() => void 0);
+    await writeFile(file, JSON.stringify(answer), "utf8").catch(() => void 0);
+    return parseDrafts(answer);
+  };
+}
+async function ruleCandidates(note, ad, draft) {
+  const text = note?.trim();
+  if (!text) return [];
+  return await draft(text, ad).catch(() => []);
+}
+var candidatesDir = (cacheDir) => path.join(cacheDir, "rule-candidates");
+async function saveCandidates(cacheDir, candidates) {
+  await mkdir(candidatesDir(cacheDir), { recursive: true });
+  return await Promise.all(
+    candidates.map(async (c) => {
+      const id = `rc-${createHash("sha256").update(JSON.stringify(c)).digest("hex").slice(0, 8)}`;
+      await writeFile(path.join(candidatesDir(cacheDir), `${id}.json`), JSON.stringify(c), "utf8");
+      return id;
+    })
+  );
+}
+async function loadCandidate(cacheDir, id) {
+  if (!/^rc-[0-9a-f]{8}$/.test(id)) return null;
+  return await readFile(path.join(candidatesDir(cacheDir), `${id}.json`), "utf8").then(
+    (raw) => JSON.parse(raw),
+    () => null
+  );
+}
+var REPEATED_ON = 2;
+var REPEATED_NOTES = 3;
+function repeatedReasons(notes, reasons, slug) {
+  return reasons.flatMap((reason) => {
+    const others = notes.filter((n) => n.creative !== slug && n.reasons.includes(reason));
+    const creatives = new Set(others.map((n) => n.creative)).size;
+    return creatives >= REPEATED_ON ? [
+      {
+        label: CREATIVE_FEEDBACK_REASON_LABELS[reason],
+        creatives,
+        notes: [...new Set(others.map((n) => n.note))].slice(0, REPEATED_NOTES)
+      }
+    ] : [];
+  });
+}
+function ruleCandidateHints(drafted, repeated) {
+  const asks = drafted.map(
+    (d) => `Their words state a rule for every ad: "${d.text}". Ask them once, in their language: make this a rule for every ad from now on? Only on yes: \`baker creatives rules add --candidate ${d.id}\` (reword it with --text if they correct it). On no, never ask again in this chat.`
+  );
+  const patterns = repeated.map(
+    (r) => `"${r.label}" was also the reason on ${r.creatives} other ads (their words: ${r.notes.map((n) => `"${n}"`).join("; ")}). ${drafted.length > 0 ? "Say so when you ask." : 'Ask them once whether there is a rule for every ad behind it; on yes, `baker creatives rules add --text "<the rule, in their words>" \u2026`.'}`
+  );
+  return [...asks, ...patterns];
+}
+
+export {
+  modelRuleDrafter,
+  ruleCandidates,
+  saveCandidates,
+  loadCandidate,
+  repeatedReasons,
+  ruleCandidateHints
+};
+//# sourceMappingURL=chunk-ELYP6BOS.js.map

package/dist/chunk-ELYP6BOS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/rule-candidate.ts"],"sourcesContent":["/**\n * Whether what a person said about one ad is a standing rule for every ad, and the rule it states.\n * One angry note never becomes a rule by itself: a model drafts a rule only where it can quote the\n * note's own words that make it hold beyond this ad (`draftRules`), the person is asked once and says\n * yes, and `baker creatives rules add` tests it against the version it came from and the company's\n * approved ones before it is saved. Measured on the 65 production notes of\n * scripts/creative-rules-evals/cases.json (standing.mts): precision 0.92, recall 0.55; the decision\n * model's yes/no on the note never passed 0.83 at a useful recall, a long note mixing one-off fixes\n * with a rule reading as a fix.\n *\n * Prod, Oct 2026: most of the company's rules lived only as rejection notes (\"100 % online\", no AI\n * people, the business unit's logo, no dates, one voice per video) and nothing turned them into one.\n */\nimport { createHash } from \"node:crypto\";\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { CREATIVE_FEEDBACK_REASON_LABELS, type CreativeFeedbackNote, type CreativeFeedbackReason } from \"@baker/api\";\nimport { z } from \"zod\";\nimport { Phrases, RULE_APPLIES, RULE_KINDS, RULE_STRENGTHS } from \"../../engine/creative-rules/schema.ts\";\nimport { askAboutText, type ReviewUsage } from \"../../engine/nodes/local/lib/render-review.ts\";\nimport { holdWorkspaceSpend } from \"../canvas/unbilled-spend.ts\";\n\n/** A rule as a model drafts it from a note, before the person says yes. */\nexport type RuleDraft = {\n  /** The rule, in the person's own language, one sentence. */\n  text: string;\n  strength: (typeof RULE_STRENGTHS)[number];\n  applies: (typeof RULE_APPLIES)[number];\n  /** The language the note is in (BCP-47 primary tag): its phrases are checked only in ads in it. */\n  language?: string;\n  kinds?: Array<(typeof RULE_KINDS)[number]>;\n  platforms?: string[];\n  forbid?: string[];\n  require?: string[];\n  allow?: string[];\n  people?: \"real\";\n};\n\nconst optionalPhrases = Phrases.optional().catch(undefined);\nconst Draft = z.object({\n  because: z.string().trim().min(3).max(400),\n  text: z.string().trim().min(1).max(300),\n  strength: z.enum(RULE_STRENGTHS).catch(\"must\"),\n  applies: z.enum(RULE_APPLIES).catch(\"any\"),\n  language: z\n    .string()\n    .trim()\n    .regex(/^[a-z]{2,3}$/)\n    .optional()\n    .catch(undefined),\n  kinds: z.array(z.enum(RULE_KINDS)).optional().catch(undefined),\n  platforms: optionalPhrases,\n  forbid: optionalPhrases,\n  require: optionalPhrases,\n  allow: optionalPhrases,\n  people: z.literal(\"real\").optional().catch(undefined),\n});\n\n/** The model's drafts, every malformed one dropped, the empty lists left out. Pure. */\nexport function parseDrafts(answer: unknown): RuleDraft[] {\n  const rules = (answer as { rules?: unknown } | null)?.rules;\n  if (!Array.isArray(rules)) return [];\n  return rules.slice(0, MAX_DRAFTS).flatMap((raw) => {\n    const draft = Draft.safeParse(raw);\n    if (!draft.success) return [];\n    const { because: _because, ...rule } = draft.data;\n    return [\n      Object.fromEntries(\n        Object.entries(rule).filter(([, v]) => v !== undefined && !(Array.isArray(v) && v.length === 0)),\n      ) as RuleDraft,\n    ];\n  });\n}\n\n/** A note states a few rules at most; more is a note that lists one-off changes. */\nconst MAX_DRAFTS = 3;\n\n/** The question the drafting model answers. Pure. */\nexport function draftRulesPrompt(note: string, ad: { kind?: \"static\" | \"video\"; platform?: string }): string {\n  const where = [ad.kind ? `a ${ad.kind} ad` : \"an ad\", ad.platform ? `for ${ad.platform}` : \"\"]\n    .filter(Boolean)\n    .join(\" \");\n  return [\n    `A person rejected ${where} and said, in their own words:`,\n    `\"\"\"${note}\"\"\"`,\n    \"\",\n    \"List only the standing rules this note states for EVERY future ad of the company (at most 3). Most notes state none: they ask for changes to this ad (fix a word, move the logo, speed up a scene, redo the pieces), and a change to this ad is never a rule, however it is phrased. A rule is standing only when the note itself says it holds beyond this ad (always, never, in every video, in these creatives, these mistakes keep happening, it is the format of the programme, the rule of the other pieces), or it corrects how the company or what it sells must always be named.\",\n    \"For each rule, quote in `because` the note's own words that make it hold beyond this ad; a rule you cannot quote that for is not a rule. Return JSON only:\",\n    '{\"rules\": [{\"because\": string, \"text\": string, \"strength\": \"never\" | \"must\" | \"prefer\", \"applies\": \"copy\" | \"picture\" | \"cast\" | \"logo\" | \"voice\" | \"sound\" | \"subtitles\" | \"any\", \"language\": string, \"kinds\": [\"static\" | \"video\"], \"platforms\": string[], \"forbid\": string[], \"require\": string[], \"allow\": string[], \"people\": \"real\" | null}]}',\n    \"- text: the rule in one short sentence, in the note's own language and close to its words.\",\n    '- strength: \"never\" for a ban, \"must\" for something every ad has to do, \"prefer\" for a taste.',\n    '- applies: what of the ad it is about (\"copy\" for its words, \"picture\", \"cast\" for who appears, \"logo\", \"voice\", \"sound\", \"subtitles\"), else \"any\".',\n    '- language: the note\\'s language as a two-letter code (\"es\").',\n    '- kinds and platforms: only when the note limits the rule to them (\"en estos creativos de linkedin\" gives platforms [\"linkedin\"]); else [].',\n    '- forbid: the exact words the rule bans in the ad\\'s words, only when a word or phrase decides it (\"100 % online\", not \"online\" gives forbid [\"online\"], allow [\"100 % online\"]); else []. require: words every ad must say; usually []. allow: the right phrase that contains a banned word.',\n    '- people: \"real\" only when the rule is that no AI-made or invented people appear; else null.',\n    'Return {\"rules\": []} when the note states no standing rule.',\n  ].join(\"\\n\");\n}\n\n/** Drafts the rules a note states, or none when it states none or no model answered. */\nexport type DraftRules = (note: string, ad: { kind?: \"static\" | \"video\"; platform?: string }) => Promise<RuleDraft[]>;\n\n/** Pinned and kept by the note, so the same note drafts the same rule. */\nexport const RULE_DRAFT_MODEL = \"google/gemini-3.5-flash\";\nconst DRAFT_REQUEST = {\n  provider: { order: [\"google-vertex\"], allow_fallbacks: false },\n  seed: 0,\n  reasoning: { effort: \"low\" },\n  response_format: { type: \"json_object\" },\n};\nconst DRAFT_TIMEOUT_MS = 30_000;\n\n/** The live drafting model, its answers kept in `cacheDir` by the prompt and its spend held for the next bill. */\nexport function modelRuleDrafter(cacheDir: string): DraftRules {\n  return async (note, ad) => {\n    const prompt = draftRulesPrompt(note, ad);\n    const key = createHash(\"sha256\")\n      .update(JSON.stringify([RULE_DRAFT_MODEL, prompt]))\n      .digest(\"hex\")\n      .slice(0, 16);\n    const file = path.join(cacheDir, \"rule-drafts\", `${key}.json`);\n    const cached = await readFile(file, \"utf8\").then(\n      (raw) => parseDrafts(JSON.parse(raw)),\n      () => null,\n    );\n    if (cached) return cached;\n    const spent: ReviewUsage[] = [];\n    const answer = await askAboutText(RULE_DRAFT_MODEL, prompt, (u) => spent.push(u), {\n      timeoutMs: DRAFT_TIMEOUT_MS,\n      request: DRAFT_REQUEST,\n    }).catch(() => null);\n    await holdWorkspaceSpend(spent);\n    if (answer === null) return [];\n    await mkdir(path.dirname(file), { recursive: true }).catch(() => undefined);\n    await writeFile(file, JSON.stringify(answer), \"utf8\").catch(() => undefined);\n    return parseDrafts(answer);\n  };\n}\n\n/** The rules a rejection's note states for every ad, drafted for the person to confirm; none when it states none. */\nexport async function ruleCandidates(\n  note: string | undefined,\n  ad: { kind?: \"static\" | \"video\"; platform?: string },\n  draft: DraftRules,\n): Promise<RuleDraft[]> {\n  const text = note?.trim();\n  if (!text) return [];\n  return await draft(text, ad).catch(() => []);\n}\n\n/** A drafted rule kept for `baker creatives rules add --candidate <id>`, with the words and version it came from. */\nexport type SavedCandidate = RuleDraft & { source: { slug?: string; runId?: string; quote?: string } };\n\nconst candidatesDir = (cacheDir: string) => path.join(cacheDir, \"rule-candidates\");\n\n/** Keeps each candidate under a short id its words decide, and returns the ids, in order. */\nexport async function saveCandidates(cacheDir: string, candidates: readonly SavedCandidate[]): Promise<string[]> {\n  await mkdir(candidatesDir(cacheDir), { recursive: true });\n  return await Promise.all(\n    candidates.map(async (c) => {\n      const id = `rc-${createHash(\"sha256\").update(JSON.stringify(c)).digest(\"hex\").slice(0, 8)}`;\n      await writeFile(path.join(candidatesDir(cacheDir), `${id}.json`), JSON.stringify(c), \"utf8\");\n      return id;\n    }),\n  );\n}\n\n/** A kept candidate, or null when there is none by that id. */\nexport async function loadCandidate(cacheDir: string, id: string): Promise<SavedCandidate | null> {\n  if (!/^rc-[0-9a-f]{8}$/.test(id)) return null;\n  return await readFile(path.join(candidatesDir(cacheDir), `${id}.json`), \"utf8\").then(\n    (raw) => JSON.parse(raw) as SavedCandidate,\n    () => null,\n  );\n}\n\n/** A reason the company gave on this many other ads is a pattern, not one person's bad day. */\nconst REPEATED_ON = 2;\nconst REPEATED_NOTES = 3;\n\nexport type RepeatedReason = { label: string; creatives: number; notes: string[] };\n\n/**\n * Each reason of this rejection the company already gave on two or more other ads, with their\n * words: a rule proposed first, even when no one note states it. Pure.\n */\nexport function repeatedReasons(\n  notes: ReadonlyArray<Pick<CreativeFeedbackNote, \"creative\" | \"reasons\" | \"note\">>,\n  reasons: readonly CreativeFeedbackReason[],\n  slug: string,\n): RepeatedReason[] {\n  return reasons.flatMap((reason) => {\n    const others = notes.filter((n) => n.creative !== slug && n.reasons.includes(reason));\n    const creatives = new Set(others.map((n) => n.creative)).size;\n    return creatives >= REPEATED_ON\n      ? [\n          {\n            label: CREATIVE_FEEDBACK_REASON_LABELS[reason],\n            creatives,\n            notes: [...new Set(others.map((n) => n.note))].slice(0, REPEATED_NOTES),\n          },\n        ]\n      : [];\n  });\n}\n\n/** What the agent does with the rules a note states: ask the person once, save only on yes. Pure. */\nexport function ruleCandidateHints(\n  drafted: ReadonlyArray<{ id: string; text: string }>,\n  repeated: readonly RepeatedReason[],\n): string[] {\n  const asks = drafted.map(\n    (d) =>\n      `Their words state a rule for every ad: \"${d.text}\". Ask them once, in their language: make this a rule for every ad from now on? Only on yes: \\`baker creatives rules add --candidate ${d.id}\\` (reword it with --text if they correct it). On no, never ask again in this chat.`,\n  );\n  const patterns = repeated.map(\n    (r) =>\n      `\"${r.label}\" was also the reason on ${r.creatives} other ads (their words: ${r.notes.map((n) => `\"${n}\"`).join(\"; \")}). ${drafted.length > 0 ? \"Say so when you ask.\" : 'Ask them once whether there is a rule for every ad behind it; on yes, `baker creatives rules add --text \"<the rule, in their words>\" …`.'}`,\n  );\n  return [...asks, ...patterns];\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-EUB327FC.js

@@ -0,0 +1,57 @@
+import {
+  formEventKey
+} from "./chunk-BC2BXRXY.js";
+import {
+  flowNodeTriggers
+} from "./chunk-MV2J73HP.js";
+
+// ../api/src/analytics/flowEventKeys.ts
+function flowNodes(node, acc = []) {
+  if (!node || typeof node !== "object") return acc;
+  const record = node;
+  acc.push(record);
+  if (Array.isArray(record.children)) for (const child of record.children) flowNodes(child, acc);
+  return acc;
+}
+function flowEventKeys(tree, slug) {
+  const primary = [];
+  const secondary = [];
+  const nodes = flowNodes(tree).filter((node) => typeof node.id === "string" && node.id !== "");
+  if (nodes.length === 0) return [];
+  for (const node of nodes) {
+    const id = node.id;
+    const triggers = flowNodeTriggers(node.nodeData);
+    for (const triggerId of triggers.available) {
+      const candidate = {
+        eventKey: formEventKey(slug, id, triggerId),
+        nodeId: id,
+        nodeName: typeof node.name === "string" ? node.name : id,
+        nodeType: triggers.type,
+        triggerId,
+        isCompletion: triggers.completion === triggerId
+      };
+      (candidate.isCompletion ? primary : secondary).push(candidate);
+    }
+  }
+  return [
+    ...primary,
+    ...secondary,
+    {
+      eventKey: `submit:${slug}`,
+      nodeId: null,
+      nodeName: "the Form ran out of steps",
+      nodeType: null,
+      triggerId: null,
+      // A Form reaching its last node is as primary as an outcome gets for a
+      // Form with no widget in it — but it never fires on one that ends in a
+      // booking widget or a redirect, so it does not lead the list.
+      isCompletion: false
+    }
+  ];
+}
+
+export {
+  flowNodes,
+  flowEventKeys
+};
+//# sourceMappingURL=chunk-EUB327FC.js.map