@koda-sl/baker-cli 0.384.0 → 0.385.0-dev.f7ef4c7e1

package/dist/chunk-TTVKI54A.js

@@ -0,0 +1,160 @@
+import {
+  IDEA_VIDEO_FORMATS,
+  figuresIn,
+  unsourcedClaims
+} from "./chunk-BIPIL4QA.js";
+import {
+  AD_SPEC_SCHEMA
+} from "./chunk-YMBB4JBD.js";
+
+// src/commands/creatives/make-model.ts
+import { parse, parseDocument, Scalar, visit } from "yaml";
+var REFERENCE_CANDIDATES = 6;
+function isVideoIdea(idea) {
+  return IDEA_VIDEO_FORMATS.includes(idea.format);
+}
+var BY_TEMPERATURE = {
+  cold: { audienceTemperature: "0_cold", excludeBrandReliant: true },
+  warm: { audienceTemperature: "1_warm_engaged,2_hot_visited", excludeBrandReliant: true },
+  hot: { audienceTemperature: "3_customer" }
+};
+function referenceSearchFor(idea, temperature, excludeAdvertiser) {
+  return {
+    query: idea.message,
+    scope: "followed-first",
+    platform: "meta",
+    format: "static",
+    formatPattern: idea.format,
+    awareness: idea.awareness,
+    ...BY_TEMPERATURE[temperature],
+    ...excludeAdvertiser ? { excludeAdvertiser } : {},
+    maxPerAdvertiser: 1,
+    limit: REFERENCE_CANDIDATES,
+    diverse: true
+  };
+}
+function referenceSearchesFor(idea, temperature, excludeAdvertiser) {
+  const strict = referenceSearchFor(idea, temperature, excludeAdvertiser);
+  const { awareness: _awareness, ...anyStage } = strict;
+  const { audienceTemperature: _temperature, excludeBrandReliant: _reliant, ...anyViewer } = anyStage;
+  const { query: _query, ...winners } = anyStage;
+  const { query: _anyQuery, ...anyWinners } = anyViewer;
+  return [
+    strict,
+    anyStage,
+    { ...anyViewer, scope: "all" },
+    { ...winners, sort: "winner" },
+    { ...anyWinners, scope: "all", sort: "winner" }
+  ];
+}
+function pooledCandidates(searches, limit) {
+  const seen = /* @__PURE__ */ new Set();
+  const pooled = [];
+  for (const candidate of searches.flat()) {
+    if (!candidate.ad_id || seen.has(candidate.ad_id)) continue;
+    seen.add(candidate.ad_id);
+    pooled.push(candidate);
+  }
+  return pooled.slice(0, limit);
+}
+function fitsIdea(fit) {
+  return fit.verdict !== "reject" && missingElements(fit).length === 0;
+}
+function missingElements(fit) {
+  return fit.load_bearing.filter((l) => l.have === "missing" && !l.ours?.trim()).map((l) => l.element);
+}
+function definitionFieldsOf(idea, evidence) {
+  return {
+    idea: idea.id,
+    message: idea.message,
+    ...evidence !== "explore" ? { evidence } : {},
+    angle: idea.angle,
+    persona: idea.who,
+    awareness: idea.awareness,
+    hypothesis: idea.why
+  };
+}
+var FRONTMATTER = /^---\r?\n([\s\S]*?\r?\n)?---/;
+function readsAsText11(text) {
+  try {
+    return parse(text, { version: "1.1" }) === text;
+  } catch {
+    return false;
+  }
+}
+function setDefinitionFields(raw, fields) {
+  const match = raw.match(FRONTMATTER);
+  if (!match) return raw;
+  const doc = parseDocument(match[1] ?? "");
+  if (doc.errors.length > 0) return raw;
+  for (const [key, value] of Object.entries(fields)) {
+    if (value === void 0) continue;
+    const node = doc.createNode(value);
+    visit(node, {
+      Scalar(_, scalar) {
+        if (typeof scalar.value === "string" && !readsAsText11(scalar.value)) {
+          scalar.type = Scalar.QUOTE_DOUBLE;
+        }
+      }
+    });
+    doc.set(key, node);
+  }
+  return `---
+${doc.toString()}---${raw.slice(match[0].length)}`;
+}
+function setSpecMessage(specJson, message) {
+  const spec = JSON.parse(specJson);
+  return `${JSON.stringify({ ...spec, message }, null, 2)}
+`;
+}
+function withFitConcept(specJson, seeded) {
+  const spec = JSON.parse(specJson);
+  const held = spec.concept;
+  if (held?.reference_ad_id) return specJson;
+  return `${JSON.stringify({ ...spec, ...seeded }, null, 2)}
+`;
+}
+function unsourcedCopyLines(specJson, corpus) {
+  const spec = JSON.parse(specJson);
+  const figures = figuresIn(corpus);
+  const lines = Array.isArray(spec.copy) ? spec.copy : [];
+  return lines.flatMap((line) => {
+    const text = typeof line === "object" && line !== null ? line.text : void 0;
+    return typeof text === "string" && unsourcedClaims(text, figures).length > 0 ? [text] : [];
+  });
+}
+var PHOTO_FORMATS = /photo|lifestyle|before_after|ugc|product|selfie|street/;
+function ideaSpec(idea, who) {
+  const container = idea.format.replace(/_/g, " ");
+  return {
+    schema: AD_SPEC_SCHEMA,
+    viewer: { who },
+    message: idea.message,
+    copy: [{ text: "[TODO: the headline, in the customer's words]", lettering: "designed", role: "headline" }],
+    scene: {
+      description: `[TODO: what the viewer sees, as a ${container}, that shows: ${idea.message}]`,
+      look: PHOTO_FORMATS.test(idea.format) ? "photo" : "designed"
+    },
+    colors: [],
+    references: [],
+    logo: false,
+    third_party_brands: [],
+    scene_text: [],
+    mechanism: []
+  };
+}
+
+export {
+  isVideoIdea,
+  referenceSearchesFor,
+  pooledCandidates,
+  fitsIdea,
+  missingElements,
+  definitionFieldsOf,
+  setDefinitionFields,
+  setSpecMessage,
+  withFitConcept,
+  unsourcedCopyLines,
+  ideaSpec
+};
+//# sourceMappingURL=chunk-TTVKI54A.js.map

package/dist/chunk-TTVKI54A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/make-model.ts"],"sourcesContent":["/**\n * The rules `baker creatives make` applies to turn an idea into a creative: which reference to\n * look for, which one fits, and what the creative records about the idea it carries. Pure.\n */\nimport { parse, parseDocument, Scalar, visit } from \"yaml\";\nimport { AD_SPEC_SCHEMA, type AdSpec } from \"../../engine/scaffold/static-ad-spec.ts\";\nimport type { ViewerTemperature } from \"../../viewer-profile.ts\";\nimport type { FitAnswer } from \"../winning-ads/fit.ts\";\nimport type { WinningAdsSearchArgs } from \"../winning-ads/search.ts\";\nimport { type EvidenceLevel, figuresIn, IDEA_VIDEO_FORMATS, type Idea, unsourcedClaims } from \"./ideas-model.ts\";\n\nexport const REFERENCE_CANDIDATES = 6;\n\n/** Whether the idea is a video, built from beats, rather than a static from a reference. */\nexport function isVideoIdea(idea: Pick<Idea, \"format\">): boolean {\n  return (IDEA_VIDEO_FORMATS as readonly string[]).includes(idea.format);\n}\n\n/** Who a reference was made for, by our viewer: a stranger's ad never leans on its own brand. */\nconst BY_TEMPERATURE: Record<ViewerTemperature, { audienceTemperature: string; excludeBrandReliant?: true }> = {\n  cold: { audienceTemperature: \"0_cold\", excludeBrandReliant: true },\n  warm: { audienceTemperature: \"1_warm_engaged,2_hot_visited\", excludeBrandReliant: true },\n  hot: { audienceTemperature: \"3_customer\" },\n};\n\n/** The library search for a static idea's reference: its container, made for our viewer. */\nexport function referenceSearchFor(\n  idea: Idea,\n  temperature: ViewerTemperature,\n  excludeAdvertiser?: string,\n): WinningAdsSearchArgs {\n  return {\n    query: idea.message,\n    scope: \"followed-first\",\n    platform: \"meta\",\n    format: \"static\",\n    formatPattern: idea.format,\n    awareness: idea.awareness,\n    ...BY_TEMPERATURE[temperature],\n    ...(excludeAdvertiser ? { excludeAdvertiser } : {}),\n    maxPerAdvertiser: 1,\n    limit: REFERENCE_CANDIDATES,\n    diverse: true,\n  };\n}\n\n/**\n * The searches whose candidates are tried, best first: the idea's format always holds, since the\n * format is part of the idea. First the idea's message (awareness, then who the ad was made for,\n * then the company's own market loosened in turn), then the container's proven winners with no\n * query, for our viewer and then for anyone. Prod, Oct 2026: the library's judge scores an ad\n * against the query, so a customer's sentence about one product matched no ad of another category\n * and 13 of 15 ideas found nothing, while every container held proven winners whose move transfers.\n */\nexport function referenceSearchesFor(\n  idea: Idea,\n  temperature: ViewerTemperature,\n  excludeAdvertiser?: string,\n): WinningAdsSearchArgs[] {\n  const strict = referenceSearchFor(idea, temperature, excludeAdvertiser);\n  const { awareness: _awareness, ...anyStage } = strict;\n  const { audienceTemperature: _temperature, excludeBrandReliant: _reliant, ...anyViewer } = anyStage;\n  const { query: _query, ...winners } = anyStage;\n  const { query: _anyQuery, ...anyWinners } = anyViewer;\n  return [\n    strict,\n    anyStage,\n    { ...anyViewer, scope: \"all\" },\n    { ...winners, sort: \"winner\" },\n    { ...anyWinners, scope: \"all\", sort: \"winner\" },\n  ];\n}\n\n/** Every search's candidates in one list, the better search's first, each ad once, at most `limit`. Pure. */\nexport function pooledCandidates<T extends { ad_id?: string | null }>(searches: readonly T[][], limit: number): T[] {\n  const seen = new Set<string>();\n  const pooled: T[] = [];\n  for (const candidate of searches.flat()) {\n    if (!candidate.ad_id || seen.has(candidate.ad_id)) continue;\n    seen.add(candidate.ad_id);\n    pooled.push(candidate);\n  }\n  return pooled.slice(0, limit);\n}\n\n/** A reference fits when what it wins on is something we can supply. */\nexport function fitsIdea(fit: Pick<FitAnswer, \"verdict\" | \"load_bearing\">): boolean {\n  return fit.verdict !== \"reject\" && missingElements(fit).length === 0;\n}\n\n/** The load-bearing elements a reference wins on that we have nothing for. Pure. */\nexport function missingElements(fit: Pick<FitAnswer, \"load_bearing\">): string[] {\n  return fit.load_bearing.filter((l) => l.have === \"missing\" && !l.ours?.trim()).map((l) => l.element);\n}\n\nexport type DefinitionStrategyFields = {\n  idea: string;\n  message: string;\n  evidence?: EvidenceLevel;\n  angle: string;\n  persona: string;\n  awareness: string;\n  hypothesis: string;\n};\n\n/** What a creative records about the idea it executes. */\nexport function definitionFieldsOf(idea: Idea, evidence: EvidenceLevel | \"explore\"): DefinitionStrategyFields {\n  return {\n    idea: idea.id,\n    message: idea.message,\n    ...(evidence !== \"explore\" ? { evidence } : {}),\n    angle: idea.angle,\n    persona: idea.who,\n    awareness: idea.awareness,\n    hypothesis: idea.why,\n  };\n}\n\nconst FRONTMATTER = /^---\\r?\\n([\\s\\S]*?\\r?\\n)?---/;\n\n/** Whether a bare string reads back as the same text under YAML 1.1. */\nfunction readsAsText11(text: string): boolean {\n  try {\n    return parse(text, { version: \"1.1\" }) === text;\n  } catch {\n    return false;\n  }\n}\n\n/** Set fields in a markdown file's frontmatter, keeping every other field and the body. */\nexport function setDefinitionFields(raw: string, fields: Record<string, unknown>): string {\n  const match = raw.match(FRONTMATTER);\n  if (!match) return raw;\n  const doc = parseDocument(match[1] ?? \"\");\n  if (doc.errors.length > 0) return raw;\n  for (const [key, value] of Object.entries(fields)) {\n    if (value === undefined) continue;\n    const node = doc.createNode(value);\n    // The site reads frontmatter as YAML 1.1, where a bare 2026-10-04 is a date, not text.\n    visit(node, {\n      Scalar(_, scalar) {\n        if (typeof scalar.value === \"string\" && !readsAsText11(scalar.value)) {\n          scalar.type = Scalar.QUOTE_DOUBLE;\n        }\n      },\n    });\n    doc.set(key, node);\n  }\n  return `---\\n${doc.toString()}---${raw.slice(match[0].length)}`;\n}\n\n/** The ad spec with the idea's message as the one thing it tells the viewer. */\nexport function setSpecMessage(specJson: string, message: string): string {\n  const spec = JSON.parse(specJson) as Record<string, unknown>;\n  return `${JSON.stringify({ ...spec, message }, null, 2)}\\n`;\n}\n\n/**\n * The ad spec with the concept the reference's fit read (`conceptFromFit`): a build started before\n * the fit answered has none, or only the one the scaffold drafted from its describe, which names no\n * reference and nothing of what we have; without the fit's, the render never sees the reference at\n * the level that won. A concept a fit already seeded (it names its reference) stays. Pure.\n */\nexport function withFitConcept(specJson: string, seeded: Record<string, unknown>): string {\n  const spec = JSON.parse(specJson) as Record<string, unknown>;\n  const held = spec.concept as { reference_ad_id?: unknown } | undefined;\n  if (held?.reference_ad_id) return specJson;\n  return `${JSON.stringify({ ...spec, ...seeded }, null, 2)}\\n`;\n}\n\n/**\n * The copy lines the scaffold drafted that claim a figure the company never wrote: a draft written\n * beside a competitor's ad can carry the competitor's promise. `corpus` is what the company wrote.\n */\nexport function unsourcedCopyLines(specJson: string, corpus: string): string[] {\n  const spec = JSON.parse(specJson) as { copy?: unknown };\n  const figures = figuresIn(corpus);\n  const lines = Array.isArray(spec.copy) ? spec.copy : [];\n  return lines.flatMap((line) => {\n    const text = typeof line === \"object\" && line !== null ? (line as { text?: unknown }).text : undefined;\n    return typeof text === \"string\" && unsourcedClaims(text, figures).length > 0 ? [text] : [];\n  });\n}\n\n/** Containers shown as a photograph; every other container is a designed graphic or a screen. */\nconst PHOTO_FORMATS = /photo|lifestyle|before_after|ugc|product|selfie|street/;\n\n/**\n * The ad spec an idea starts from when no proven ad fits it: the message and who it is for are\n * the idea's; the scene and the copy are placeholders the agent writes before anything renders\n * (`canvas run` refuses a placeholder). Pure.\n */\nexport function ideaSpec(idea: Idea, who: string): AdSpec {\n  const container = idea.format.replace(/_/g, \" \");\n  return {\n    schema: AD_SPEC_SCHEMA,\n    viewer: { who },\n    message: idea.message,\n    copy: [{ text: \"[TODO: the headline, in the customer's words]\", lettering: \"designed\", role: \"headline\" }],\n    scene: {\n      description: `[TODO: what the viewer sees, as a ${container}, that shows: ${idea.message}]`,\n      look: PHOTO_FORMATS.test(idea.format) ? \"photo\" : \"designed\",\n    },\n    colors: [],\n    references: [],\n    logo: false,\n    third_party_brands: [],\n    scene_text: [],\n    mechanism: [],\n  };\n}\n"],"mappings":"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","names":[]}