@koda-sl/baker-cli 0.571.0-dev.6a3439a0a → 0.571.0

package/dist/chunk-JLAFNORO.js

@@ -1,285 +0,0 @@
-import {
-  IDEA_VIDEO_FORMATS,
-  figuresIn,
-  unsourcedClaims
-} from "./chunk-NOCBNING.js";
-import {
-  AD_SPEC_SCHEMA,
-  unfitReasons
-} from "./chunk-J4AWNWKN.js";
-import {
-  proofStrength
-} from "./chunk-NXNOXZGB.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, where = {}) {
-  return {
-    query: where.category || idea.message,
-    scope: "followed-first",
-    platform: "meta",
-    format: "static",
-    formatPattern: idea.format,
-    awareness: idea.awareness,
-    ...BY_TEMPERATURE[temperature],
-    ...where.country ? { country: where.country } : {},
-    maxPerAdvertiser: 1,
-    limit: REFERENCE_CANDIDATES,
-    diverse: true
-  };
-}
-function referenceSearchesFor(idea, temperature, where = {}) {
-  const strict = referenceSearchFor(idea, temperature, where);
-  const { awareness: _awareness, ...anyStage } = strict;
-  const { audienceTemperature: _temperature, excludeBrandReliant: _reliant, ...viewerAny } = anyStage;
-  const anyViewer = { ...viewerAny, scope: "all" };
-  const { formatPattern: _pattern, ...anyContainer } = anyViewer;
-  const { country: _country, ...anywhere } = anyViewer;
-  const { country: _anyCountry, ...anyContainerAnywhere } = anyContainer;
-  const { query: _query, ...winners } = anyStage;
-  const { query: _anyQuery, country: _winnersCountry, ...winnersAnywhere } = anyViewer;
-  const inMarket = (steps) => where.country ? steps : [];
-  const shows = idea.shows?.trim();
-  const { formatPattern: _shownPattern, ...anyCategory } = { ...anyStage, scope: "all" };
-  const { country: _shownCountry, ...anyCategoryAnywhere } = anyCategory;
-  const { country: _viewerCountry, ...anyViewerAnywhere } = anyViewer;
-  const { formatPattern: _anyPattern, ...shownAnyViewer } = anyViewerAnywhere;
-  const kinds = (where.shows ?? []).flatMap((q) => q.trim() ? [{ ...anyCategoryAnywhere, query: q.trim() }] : []);
-  const shown = shows ? [
-    ...inMarket([{ ...anyCategory, query: shows }]),
-    ...kinds,
-    { ...anyCategoryAnywhere, query: shows },
-    { ...shownAnyViewer, query: shows },
-    ...idea.format ? [{ ...anyViewerAnywhere, query: shows }] : []
-  ] : [];
-  const anyAd = (query) => query?.trim() ? [...inMarket([{ ...anyContainer, query: query.trim() }]), { ...anyContainerAnywhere, query: query.trim() }] : [];
-  if (shows) {
-    return [
-      ...shown,
-      ...where.category ? [anyContainerAnywhere] : [],
-      ...where.audience?.trim() ? [{ ...anyContainerAnywhere, query: where.audience.trim() }] : [],
-      { ...winnersAnywhere, sort: "winner" }
-    ];
-  }
-  return [
-    ...where.country ? [strict, anyStage, anyContainer] : [strict, anyStage],
-    anywhere,
-    anyContainerAnywhere,
-    ...anyAd(where.audience),
-    ...(where.wider ?? []).flatMap((q) => q.trim() ? [{ ...anyContainerAnywhere, query: q.trim() }] : []),
-    ...anyAd(where.industry),
-    ...where.category ? [{ ...anyContainerAnywhere, query: idea.message }] : [],
-    ...inMarket([{ ...winners, sort: "winner" }]),
-    { ...winnersAnywhere, sort: "winner" }
-  ];
-}
-function referenceWhereOf(brief, fallback) {
-  if (!brief) return fallback;
-  const country = brief.country === null ? void 0 : brief.country ?? fallback.country;
-  const audience = brief.audience ?? fallback.audience;
-  return {
-    ...country ? { country } : {},
-    category: brief.category,
-    ...brief.industry ? { industry: brief.industry } : {},
-    ...audience ? { audience } : {},
-    ...brief.wider.length ? { wider: brief.wider } : {},
-    ...brief.shows?.length ? { shows: brief.shows } : {}
-  };
-}
-function rankedForOf(brief, where, bet) {
-  return {
-    category: brief?.category ?? where.category ?? bet.message,
-    ...brief?.industry ? { industry: brief.industry } : {},
-    ...brief?.buyer ? { buyer: brief.buyer } : {},
-    ...brief?.humour ? { humour: brief.humour } : {},
-    ...brief?.memes ? { memes: brief.memes } : {},
-    ...brief?.memesWhy ? { memesWhy: brief.memesWhy } : {},
-    ...brief?.avoid.length ? { avoid: brief.avoid } : {},
-    message: bet.message,
-    who: bet.who,
-    ...bet.shows ? { shows: bet.shows } : {}
-  };
-}
-var brandKey = (name) => name.normalize("NFD").replace(new RegExp("\\p{M}", "gu"), "").toLowerCase().replace(/[^\p{L}\p{N}]/gu, "");
-function isOwnBrand(advertiser, brands) {
-  const page = brandKey(advertiser ?? "");
-  return page !== "" && brands.some((b) => brandKey(b).length >= 3 && page.includes(brandKey(b)));
-}
-function pooledCandidates(searches, limit) {
-  const seen = /* @__PURE__ */ new Set();
-  const pooled = [];
-  for (const candidate of searches.flat()) {
-    const brand = candidate.advertiser_id ? `brand:${candidate.advertiser_id}` : null;
-    if (!candidate.ad_id || seen.has(candidate.ad_id) || brand && seen.has(brand)) continue;
-    seen.add(candidate.ad_id);
-    if (brand) seen.add(brand);
-    pooled.push(candidate);
-  }
-  const proven = (c) => proofStrength(c.winner_score) !== "little";
-  return [...pooled.filter(proven), ...pooled.filter((c) => !proven(c))].slice(0, limit);
-}
-function freshReferencesFirst(candidates, taken) {
-  return [
-    ...candidates.filter((c) => !isTakenReference(c, taken)),
-    ...candidates.filter((c) => isTakenReference(c, taken))
-  ];
-}
-function isTakenReference(c, taken) {
-  return c.ad_id != null && taken.adIds.has(c.ad_id) || c.advertiser_id != null && taken.advertiserIds.has(c.advertiser_id);
-}
-function fitsIdea(fit) {
-  return fit.verdict !== "reject" && missingElements(fit).length === 0 && fit.our_viewer?.stops !== "no";
-}
-function missingElements(fit) {
-  return fit.load_bearing.filter((l) => l.have === "missing" && !l.ours?.trim()).map((l) => l.element);
-}
-function whyUnfit(fit) {
-  const reasons = unfitReasons(fit);
-  if (reasons.length > 0) return reasons.join("; ");
-  if (fit.our_viewer?.stops === "no") {
-    return `our viewer would not stop for it${fit.our_viewer.why ? `: ${fit.our_viewer.why}` : ""}`;
-  }
-  return fit.transfer_note?.trim() || "the check found it does not carry this ad";
-}
-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 setSpecViewer(specJson, idea, personas) {
-  const spec = JSON.parse(specJson);
-  const viewer = spec.viewer ?? {};
-  return `${JSON.stringify({ ...spec, viewer: { ...viewer, who: personaWho(idea, personas) } }, null, 2)}
-`;
-}
-function personaWho(idea, personas) {
-  const persona = personas.find((p) => p.slug === idea.who);
-  if (persona?.title) return `${persona.title}${persona.segment ? ` (${persona.segment})` : ""}`;
-  return persona?.segment ?? idea.who.replace(/[-_]/g, " ");
-}
-var AUDIENCE_QUERY_WORDS = 9;
-function audienceQuery(idea, personas) {
-  return personaWho(idea, personas).replace(/\(/g, " ").replace(/\)/g, "").split(/\s+/).filter(Boolean).slice(0, AUDIENCE_QUERY_WORDS).join(" ").replace(/[\s,;:.–—-]+$/, "");
-}
-function fitBetOf(idea, personas, insights, market) {
-  const quotes = insights.filter((i) => idea.evidence.includes(i.id)).map((i) => i.quote);
-  return {
-    who: personaWho(idea, personas),
-    message: idea.message,
-    awareness: idea.awareness,
-    angle: idea.angle,
-    ...idea.shows ? { shows: idea.shows } : {},
-    ...quotes.length > 0 ? { quotes } : {},
-    ...market ? { market } : {}
-  };
-}
-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 ? `, as a ${idea.format.replace(/_/g, " ")}` : "";
-  const shows = idea.shows ? ` (${idea.shows})` : "";
-  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 first${shows}${container}, that shows: ${idea.message}]`,
-      look: PHOTO_FORMATS.test(idea.format ?? idea.shows ?? "") ? "photo" : "designed"
-    },
-    colors: [],
-    references: [],
-    logo: true,
-    third_party_brands: [],
-    scene_text: [],
-    mechanism: []
-  };
-}
-
-export {
-  isVideoIdea,
-  referenceSearchesFor,
-  referenceWhereOf,
-  rankedForOf,
-  isOwnBrand,
-  pooledCandidates,
-  freshReferencesFirst,
-  isTakenReference,
-  fitsIdea,
-  missingElements,
-  whyUnfit,
-  definitionFieldsOf,
-  setDefinitionFields,
-  setSpecMessage,
-  setSpecViewer,
-  personaWho,
-  audienceQuery,
-  fitBetOf,
-  withFitConcept,
-  unsourcedCopyLines,
-  ideaSpec
-};
-//# sourceMappingURL=chunk-JLAFNORO.js.map

package/dist/chunk-KG5VNPKU.js

@@ -1,91 +0,0 @@
-import {
-  definitionPlatformOf,
-  parseDefinitionDelivery,
-  resolveDelivery,
-  resolveFormatList
-} from "./chunk-MZLPOYCC.js";
-import {
-  AD_PLACEMENTS
-} from "./chunk-F3CZFUXZ.js";
-import {
-  CAPABILITY_SURFACES
-} from "./chunk-R7XDGNZD.js";
-import {
-  apiPost
-} from "./chunk-LJEJCIHR.js";
-
-// src/commands/canvas/scaffold-delivery.ts
-var flagText = (value) => typeof value === "string" || typeof value === "number" ? String(value).trim() || void 0 : void 0;
-function deliveryInputOf(flags, definition, idea) {
-  const platformsFlag = flagText(flags.platforms);
-  const legacyPlatform = flagText(flags.platform);
-  const legacyPlacements = flagText(flags.placements);
-  const aspect = flagText(flags.aspect);
-  const formatsFlag = flagText(flags.formats);
-  const targetAdSet = flagText(flags["target-adset"]);
-  return {
-    ...platformsFlag ? { platformsFlag } : {},
-    ...legacyPlatform ? { legacyPlatform } : {},
-    ...legacyPlacements ? { legacyPlacements } : {},
-    ...aspect ? { aspect } : {},
-    ...formatsFlag ? { formatsFlag } : {},
-    ...idea && idea.length > 0 ? { idea } : {},
-    definition,
-    ...targetAdSet ? { targetAdSet } : {}
-  };
-}
-function namesDelivery(flags) {
-  return [flags.platforms, flags.platform, flags.placements, flags.formats].some((f) => flagText(f) !== void 0);
-}
-var SURFACE_PLATFORMS = {
-  "meta-ads": "meta",
-  "linkedin-ads": "linkedin",
-  "google-ads": "google_demandgen",
-  "x-ads": "x",
-  "chatgpt-ads": "chatgpt"
-};
-async function connectedAdPlatforms() {
-  try {
-    const response = await apiPost("/api/capabilities", {}, { timeoutMs: 15e3 });
-    return response.data.surfaces.filter((s) => s.connected && CAPABILITY_SURFACES.includes(s.surface)).flatMap((s) => SURFACE_PLATFORMS[s.surface] ? [SURFACE_PLATFORMS[s.surface]] : []);
-  } catch {
-    return [];
-  }
-}
-async function scaffoldDelivery(flags, definitionText, idea) {
-  const definition = definitionText === null ? null : parseDefinitionDelivery(definitionText);
-  const input = deliveryInputOf(flags, definition, idea);
-  const resolved = resolveDelivery(input);
-  if (resolved.ok || resolved.error.code !== "platform_required") return resolved;
-  return resolveDelivery({ ...input, connected: await connectedAdPlatforms() });
-}
-function deliveryDefinitionFields(delivery) {
-  const platforms = delivery.platforms.map((p) => p.trim());
-  return {
-    // The collection names whole platforms; a placement named alone records its platform.
-    platforms: [...new Set(platforms.map(platformOfName))],
-    platform: definitionPlatformOf(platforms[0] ?? ""),
-    formats: resolveFormatList(delivery.formats)
-  };
-}
-function platformOfName(name) {
-  return AD_PLACEMENTS.find((p) => p.id === name)?.platform ?? name;
-}
-function deliveryNote(delivery, renderRatio) {
-  const from = {
-    flag: "as asked",
-    idea: "from the idea",
-    definition: "from _definition.md",
-    legacy_definition: "from _definition.md's platform",
-    adset: "from its Meta ad set"
-  };
-  return `Made for ${delivery.platforms.join(", ")} (${from[delivery.source]}): delivers ${delivery.formats.join(", ")}, the ${delivery.lead} designed first (rendered at ${renderRatio}) and every other size re-laid out from it.`;
-}
-
-export {
-  namesDelivery,
-  scaffoldDelivery,
-  deliveryDefinitionFields,
-  deliveryNote
-};
-//# sourceMappingURL=chunk-KG5VNPKU.js.map

package/dist/chunk-KJHG2DWS.js

@@ -1,170 +0,0 @@
-import {
-  storeProductReads
-} from "./chunk-CF5I4Q5M.js";
-import {
-  coverageOf,
-  readCreativeRecords,
-  readIdeas,
-  readInsights,
-  readKnowledgeCorpus,
-  readPersonaIds,
-  sameMessageRead,
-  workspaceIdeasJudge
-} from "./chunk-QGAUDVMR.js";
-import {
-  readAllRules
-} from "./chunk-Z7ICQKC2.js";
-import {
-  IDEA_ANGLES,
-  IDEA_FORMATS,
-  checkIdeas
-} from "./chunk-NOCBNING.js";
-import {
-  findWorkspaceRoot
-} from "./chunk-DGHSXHZR.js";
-import {
-  selectRules
-} from "./chunk-GRX3JXSR.js";
-import {
-  marketFromCompanyDoc
-} from "./chunk-2WZI36D3.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-NXNOXZGB.js";
-
-// src/commands/creatives/ideas.ts
-import { readFile } from "fs/promises";
-import path from "path";
-import { defineCommand } from "citty";
-var BUILD_NEXT = 3;
-var DESCRIPTION = `Check and rank the ad ideas in src/creatives/_ideas/: is each backed by something a customer said (src/content/insights/), does it claim only what the Knowledge holds, is it a different ad from the others, does it fill a gap the live ads leave. Free and local.
-
-Start here, after writing 4-8 idea files (one per file: who, message, evidence, awareness, angle, shows, job, why; format only for a video or a container the person asked for; plus product: <handle> when the ad sells a store product, so the store's prices count as sourced):
-  baker creatives ideas            # ranked, with problems; build_next names the ones to make
-  baker creatives make <idea>      # then build each one in build_next
-An idea with a problem is not built until it is fixed. An idea with no evidence is an explore bet: it may be built, and says so.`;
-var ARGS = {
-  full: {
-    type: "boolean",
-    description: "Every idea with its warnings and gaps, and the allowed angle and format values",
-    required: false,
-    default: false
-  }
-};
-registerSchema({ command: "creatives.ideas", description: DESCRIPTION, args: ARGS });
-function ideasHints(report) {
-  const hints = [];
-  const toBuild = report.ideas.filter((i) => i.status === "idea");
-  if (toBuild.length === 0 && report.unreadable.length === 0) {
-    hints.push(
-      "No ideas yet. Write 4-8 files in src/creatives/_ideas/<idea>.md (who, message, evidence, awareness, angle, shows, job, why), then run this again."
-    );
-  }
-  if (report.unreadable.length > 0) {
-    hints.push(`Fix ${report.unreadable.map((u) => u.id).join(", ")}: each names what is missing or unknown.`);
-  }
-  const blocked = toBuild.filter((i) => i.problems.length > 0);
-  if (blocked.length > 0) hints.push(`Fix before building: ${blocked.map((i) => i.id).join(", ")}.`);
-  if (report.observedCount < 3) {
-    hints.push(
-      "Few customer quotes on file: run `baker research customers` so ideas stand on what customers said; until then they are explore bets."
-    );
-  } else if (toBuild.length > 0 && toBuild.every((i) => i.evidence === "explore")) {
-    hints.push("No idea cites an insight: put the insight ids that back each one in its `evidence`.");
-  }
-  const next = buildNext(report.ideas);
-  if (next.length === 1) hints.push(`Build: \`baker creatives make ${next[0]}\`.`);
-  if (next.length > 1)
-    hints.push(
-      `Build ${next.join(", ")} at once: one \`creative-producer\` per idea, all spawned in one message in the background, each given its idea id, and handle each as it returns. Never build them one after another: each render takes minutes. Edited an idea after this check? Run \`baker creatives ideas\` again first: a producer cannot build an idea with a problem.`
-    );
-  return hints;
-}
-function buildNext(ideas, count = BUILD_NEXT) {
-  const ready = ideas.filter((i) => i.status === "idea" && i.problems.length === 0);
-  const firstBet = ready.find((i) => i.evidence === "explore");
-  return ready.filter((i) => i.evidence !== "explore" || i === firstBet).slice(0, count).map((i) => i.id);
-}
-function compactIdea(check) {
-  return {
-    idea: check.id,
-    status: check.status,
-    evidence: check.evidence,
-    ...check.quote ? { quote: check.quote.length > 120 ? `${check.quote.slice(0, 117)}...` : check.quote } : {},
-    awareness: check.awareness,
-    angle: check.angle,
-    ...check.shows ? { shows: check.shows } : {},
-    ...check.format ? { format: check.format } : {},
-    platforms: check.platforms ?? "unset",
-    ...check.problems.length > 0 ? { problems: check.problems } : {},
-    ...check.warnings.length > 0 ? { warnings: check.warnings } : {}
-  };
-}
-async function ideasReport(root, opts = {}) {
-  const judge = opts.ask ? { ask: opts.ask, done: () => Promise.resolve() } : workspaceIdeasJudge(root);
-  const [{ ideas, unreadable }, insights, knowledge, personas, creatives, rules, companyDoc] = await Promise.all([
-    readIdeas(root),
-    readInsights(root, { ask: judge.ask }),
-    readKnowledgeCorpus(root),
-    readPersonaIds(root),
-    readCreativeRecords(root),
-    readAllRules(root).then((all) => selectRules(all, {})),
-    readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => null)
-  ]);
-  const language = marketFromCompanyDoc(companyDoc)?.language;
-  const [sameMessage, products] = await Promise.all([
-    sameMessageRead(ideas, judge.ask),
-    storeProductReads(
-      ideas.map((i) => i.product),
-      opts.readProduct
-    )
-  ]);
-  await judge.done();
-  const checked = checkIdeas({
-    ideas,
-    insights,
-    knowledge,
-    personas,
-    sameMessage,
-    products,
-    rules,
-    ...language ? { language } : {},
-    ...coverageOf(ideas, creatives)
-  });
-  return {
-    ideas: checked,
-    unreadable,
-    insightCount: insights.length,
-    observedCount: insights.filter((i) => i.status === "observed").length
-  };
-}
-var ideasCommand = defineCommand({
-  meta: { name: "ideas", description: DESCRIPTION },
-  args: ARGS,
-  async run({ args }) {
-    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
-    const report = await ideasReport(root);
-    const full = args.full === true;
-    writeJson({
-      ok: true,
-      data: {
-        build_next: buildNext(report.ideas),
-        ideas: full ? report.ideas : report.ideas.map(compactIdea),
-        ...report.unreadable.length > 0 ? { unreadable: report.unreadable } : {},
-        customer_quotes: { total: report.insightCount, observed: report.observedCount },
-        ...full ? { allowed: { angle: IDEA_ANGLES, format: IDEA_FORMATS } } : {}
-      },
-      hints: ideasHints(report)
-    });
-  }
-});
-
-export {
-  ideasHints,
-  buildNext,
-  compactIdea,
-  ideasReport,
-  ideasCommand
-};
-//# sourceMappingURL=chunk-KJHG2DWS.js.map