@koda-sl/baker-cli 0.465.0 → 0.467.0

package/dist/chunk-6ZCYWVKZ.js

@@ -1,486 +0,0 @@
-import {
-  rememberedJev
-} from "./chunk-PAE5XKKY.js";
-import {
-  holdUnbilledSpend
-} from "./chunk-DZD3XEBO.js";
-import {
-  staticFormatPatternSchema
-} from "./chunk-SHVQFDNY.js";
-
-// src/commands/creatives/ideas-model.ts
-import { parse as parseYaml, YAMLParseError } from "yaml";
-var IDEA_ANGLES = [
-  "pain_relief",
-  "aspiration",
-  "status",
-  "fear",
-  "FOMO",
-  "identity",
-  "contrarian",
-  "education",
-  "novelty",
-  "authority",
-  "community",
-  "transformation",
-  "convenience",
-  "save_money",
-  "save_time",
-  "save_effort",
-  "named_enemy",
-  "objection_crusher",
-  "villain_democratization",
-  "commiseration",
-  "recognition_mirror",
-  "flipped_idiom"
-];
-var IDEA_VIDEO_FORMATS = [
-  "video_ugc",
-  "video_founder",
-  "video_testimonial",
-  "video_demo",
-  "video_screen_recording",
-  "video_explainer",
-  "video_motion_graphics"
-];
-var IDEA_FORMATS = [...staticFormatPatternSchema.options, ...IDEA_VIDEO_FORMATS];
-var AWARENESS_STAGES = ["unaware", "problem_aware", "solution_aware", "product_aware", "most_aware"];
-var EVIDENCE_LEVELS = ["observed", "interpreted", "hypothesized", "generated"];
-var IDEA_STATUSES = ["idea", "built", "testing", "winner", "failed", "inconclusive", "retired"];
-var FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---/;
-function frontmatterOf(markdown) {
-  const block = FRONTMATTER.exec(markdown)?.[1];
-  if (block === void 0) return null;
-  try {
-    const parsed = parseYaml(block);
-    return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
-  } catch {
-    return null;
-  }
-}
-function frontmatterError(markdown) {
-  const block = FRONTMATTER.exec(markdown)?.[1];
-  if (block === void 0) return null;
-  try {
-    parseYaml(block);
-    return null;
-  } catch (e) {
-    const line = e instanceof YAMLParseError ? e.linePos?.[0]?.line : void 0;
-    const at = line ? ` at line ${line} (\`${block.split(/\r?\n/)[line - 1]?.trim() ?? ""}\`)` : "";
-    return `the frontmatter is not valid YAML${at}: put each text value wholly in double quotes, with any quote inside it as \\" or as single quotes`;
-  }
-}
-function text(value) {
-  if (typeof value === "string") return value.trim() || void 0;
-  if (typeof value === "number") return String(value);
-  return void 0;
-}
-function oneOf(values, value) {
-  return typeof value === "string" && values.includes(value) ? value : void 0;
-}
-var CHECKABLE_SOURCE = /^(?:https?:\/\/\S+|[a-z_]+:[\w-]+)$/i;
-function evidenceStatus(stated, source) {
-  if (stated !== "observed") return stated;
-  return CHECKABLE_SOURCE.test(source) ? "observed" : "interpreted";
-}
-function parseInsight(id, markdown) {
-  const fm = frontmatterOf(markdown);
-  const quote = text(fm?.quote);
-  const source = text(fm?.source);
-  if (!fm || !quote || !source) return null;
-  const force = text(fm.force);
-  const persona = text(fm.persona);
-  const sourceKind = text(fm.sourceKind);
-  const author = markdown.replace(/^---[\s\S]*?\n---/, "").match(/\bby ([\p{Lu}][\p{L}'’-]*\.?(?: [\p{Lu}][\p{L}'’-]*\.?)?)/u)?.[1]?.replace(new RegExp("(\\p{L}{2,})\\.$", "u"), "$1");
-  return {
-    id,
-    type: text(fm.type) ?? "other",
-    quote,
-    source,
-    status: evidenceStatus(oneOf(EVIDENCE_LEVELS, fm.status) ?? "observed", source),
-    ...sourceKind ? { sourceKind } : {},
-    ...force ? { force } : {},
-    ...persona ? { persona } : {},
-    ...author ? { author } : {}
-  };
-}
-function evidenceList(value) {
-  if (Array.isArray(value)) return value.flatMap((e) => text(e) ? [String(text(e))] : []);
-  const single = text(value);
-  return single ? [single] : [];
-}
-function fieldProblems(f) {
-  const problems = [];
-  if (!f.who) problems.push("who is missing: the persona it is for");
-  if (!f.message)
-    problems.push(
-      "message is missing: the one promise a stranger should get, what is offered and what changes for them"
-    );
-  if (!f.why) problems.push("why is missing: the brief finding it answers");
-  if (!f.awareness) {
-    const written = f.awarenessWritten ? `"${f.awarenessWritten}" ` : "";
-    problems.push(`awareness ${written}must be one of ${AWARENESS_STAGES.join(", ")}`);
-  }
-  if (!(f.angle && IDEA_ANGLES.includes(f.angle)))
-    problems.push(`angle ${f.angle ? `"${f.angle}" ` : ""}must be one of ${IDEA_ANGLES.join(", ")}`);
-  if (!(f.format && IDEA_FORMATS.includes(f.format)))
-    problems.push(`format ${f.format ? `"${f.format}" ` : ""}must be one of ${IDEA_FORMATS.join(", ")}`);
-  return problems;
-}
-function parseIdea(id, markdown) {
-  const unparsable = frontmatterError(markdown);
-  if (unparsable) return { problems: [unparsable] };
-  const fm = frontmatterOf(markdown) ?? {};
-  const f = {
-    who: text(fm.who),
-    message: text(fm.message),
-    why: text(fm.why),
-    angle: text(fm.angle),
-    format: text(fm.format),
-    awareness: oneOf(AWARENESS_STAGES, fm.awareness),
-    awarenessWritten: text(fm.awareness)
-  };
-  const problems = fieldProblems(f);
-  const { who, message, why, angle, format, awareness } = f;
-  if (problems.length > 0 || !who || !message || !why || !awareness || !angle || !format) return { problems };
-  return {
-    idea: {
-      id,
-      who,
-      message,
-      evidence: evidenceList(fm.evidence),
-      awareness,
-      angle,
-      format,
-      job: fm.job === "closer" ? "closer" : "opener",
-      why,
-      status: oneOf(IDEA_STATUSES, fm.status) ?? "idea"
-    },
-    problems
-  };
-}
-var EVIDENCE_WEIGHT = {
-  observed: 3,
-  interpreted: 2,
-  hypothesized: 1,
-  generated: 0,
-  explore: 0
-};
-var LIVE_STATUSES = ["built", "testing", "winner"];
-function claimsOf(message) {
-  return [...message.matchAll(/\d[\d.,]*\s?(?:%|€|\$|£|x\b|k\b)?/gi)].map((m) => m[0].trim());
-}
-function figureOf(claim) {
-  return claim.replace(/[^\d]/g, "");
-}
-function figuresIn(text2) {
-  return new Set([...text2.matchAll(/\d(?:[\d.,]*\d)?/g)].map((m) => figureOf(m[0])));
-}
-function normalize(value) {
-  return value.toLowerCase().replace(/\s+/g, " ").trim();
-}
-function sentencesOf(message) {
-  return message.split(/[.!?]+(?:\s|$)/).filter((s) => s.trim().length > 0).length;
-}
-var SAME_WORDS = (a, b) => normalize(a) === normalize(b);
-function repeatedFailure(idea, failed, sameMessage) {
-  const lost = failed.find(
-    (f) => f.id !== idea.id && (sameMessage(f.message, idea.message) || f.angle === idea.angle && f.format === idea.format)
-  );
-  return lost ? [`says what "${lost.id}" said, and that idea failed in the account: change the message, not just the picture`] : [];
-}
-function likelyMeant(id, insights) {
-  const words = (text2) => new Set(
-    text2.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter((w) => w.length >= 3)
-  );
-  const wanted = words(id);
-  let best;
-  for (const insight of insights.values()) {
-    const said = words(`${insight.id} ${insight.quote}`);
-    const shared = [...wanted].filter((w) => said.has(w)).length;
-    if (shared > 0 && shared > (best?.shared ?? 0)) best = { id: insight.id, shared };
-  }
-  return best?.id;
-}
-function backingOf(idea, insights, problems) {
-  const backing = idea.evidence.flatMap((id) => {
-    const insight = insights.get(id);
-    if (!insight) {
-      const meant = likelyMeant(id, insights);
-      problems.push(
-        `evidence "${id}" is not in src/content/insights/: ${meant ? `did you mean "${meant}"? ` : ""}name an insight on file by its id, or leave it out`
-      );
-    }
-    return insight ? [insight] : [];
-  });
-  return [...backing].sort((a, b) => EVIDENCE_WEIGHT[b.status] - EVIDENCE_WEIGHT[a.status])[0];
-}
-function unsourcedClaims(text2, corpusFigures) {
-  return claimsOf(text2).filter((claim) => {
-    const figure = figureOf(claim);
-    return figure !== "" && !corpusFigures.has(figure);
-  });
-}
-function claimProblems(message, corpusFigures) {
-  return unsourcedClaims(message, corpusFigures).map(
-    (claim) => `"${claim}" is in no customer quote, COMPANY.md or Knowledge entry: source it or drop it`
-  );
-}
-var MARKET_SOURCES = ["reddit", "forum", "web"];
-var TESTIMONIAL_FORMATS = ["review_screenshot", "testimonial_quote", "video_testimonial"];
-function fromMarket(insight) {
-  return insight?.sourceKind !== void 0 && MARKET_SOURCES.includes(insight.sourceKind);
-}
-function sourcesClaims(insight) {
-  return insight.status === "observed" && !fromMarket(insight);
-}
-function borrowedProof(idea, insights) {
-  return idea.evidence.find((id) => {
-    const insight = insights.get(id);
-    return fromMarket(insight) && insight?.type === "proof";
-  });
-}
-function fakeReviewProblem(idea, insights) {
-  if (!TESTIMONIAL_FORMATS.includes(idea.format)) return [];
-  const cited = idea.evidence.flatMap((id) => insights.get(id) ?? []);
-  if (cited.length === 0 || !cited.every(fromMarket)) return [];
-  return [
-    `${idea.format} needs a quote from our own customer (a review, testimonial, call or survey); every one cited was said by someone in the market. Pick another format, or cite our own customer`
-  ];
-}
-function warningsOf(idea, evidence, personas, insights) {
-  const warnings = [];
-  const borrowed = borrowedProof(idea, insights);
-  if (borrowed) {
-    warnings.push(
-      `"${borrowed}" was said by someone in the market, not a customer of ours: use their words for the problem, never show it as our review, testimonial or result`
-    );
-  }
-  if (sentencesOf(idea.message) > 1 || idea.message.split(/\s+/).length > 25) {
-    warnings.push(
-      'the message says more than one thing: keep one promise that still names what is offered ("a free roof survey that shows your real saving", never a slogan like "the numbers, explained"), the rest goes to the ad text'
-    );
-  }
-  if (personas.length > 0 && !personas.includes(idea.who)) {
-    warnings.push(`who "${idea.who}" is not a persona in the Knowledge (${personas.join(", ")})`);
-  }
-  if (evidence === "explore") {
-    warnings.push("no customer evidence: an explore bet. `baker research customers` may find some");
-  }
-  return warnings;
-}
-function checkOne(idea, ctx) {
-  const problems = [];
-  const best = backingOf(idea, ctx.insights, problems);
-  const evidence = best?.status ?? "explore";
-  problems.push(...claimProblems(idea.message, ctx.corpusFigures), ...fakeReviewProblem(idea, ctx.insights));
-  const duplicate = ctx.duplicateOf.get(idea.id);
-  if (duplicate) {
-    problems.push(
-      `same angle and format, or the same message, as "${duplicate}": to the platform it is the same ad. Change the angle or the format`
-    );
-  }
-  const gaps = [];
-  if (!ctx.covered.has(idea.awareness)) gaps.push(`no live ad speaks to ${idea.awareness} people`);
-  if (idea.job === "closer" && ctx.closersLive === 0) gaps.push("no live ad closes warm people");
-  return {
-    id: idea.id,
-    status: idea.status,
-    message: idea.message,
-    evidence,
-    ...best ? { quote: best.quote } : {},
-    awareness: idea.awareness,
-    angle: idea.angle,
-    format: idea.format,
-    problems,
-    warnings: [
-      ...warningsOf(idea, evidence, ctx.personas, ctx.insights),
-      ...repeatedFailure(idea, ctx.failed, ctx.sameMessage)
-    ],
-    gaps,
-    score: EVIDENCE_WEIGHT[evidence] + gaps.length - (problems.length > 0 ? 10 : 0)
-  };
-}
-function duplicatesOf(ideas, insights) {
-  const active = ideas.filter((i) => i.status !== "retired" && i.status !== "failed");
-  const strength = (idea) => Math.max(0, ...idea.evidence.map((id) => EVIDENCE_WEIGHT[insights.get(id)?.status ?? "explore"]));
-  const position = new Map(ideas.map((idea, index) => [idea.id, index]));
-  const order = [...active].sort(
-    (a, b) => Number(LIVE_STATUSES.includes(b.status)) - Number(LIVE_STATUSES.includes(a.status)) || strength(b) - strength(a) || (position.get(a.id) ?? 0) - (position.get(b.id) ?? 0)
-  );
-  const seenPairs = /* @__PURE__ */ new Map();
-  const seenMessages = /* @__PURE__ */ new Map();
-  const duplicateOf = /* @__PURE__ */ new Map();
-  for (const idea of order) {
-    const pair = `${idea.angle}\xD7${idea.format}`;
-    const message = normalize(idea.message);
-    const earlier = seenPairs.get(pair) ?? seenMessages.get(message);
-    if (earlier) duplicateOf.set(idea.id, earlier);
-    if (!seenPairs.has(pair)) seenPairs.set(pair, idea.id);
-    if (!seenMessages.has(message)) seenMessages.set(message, idea.id);
-  }
-  return duplicateOf;
-}
-function checkIdeas(input) {
-  const insights = new Map(input.insights.map((insight) => [insight.id, insight]));
-  const ownQuotes = input.insights.filter(sourcesClaims).map((i) => i.quote);
-  const corpusFigures = figuresIn(`${input.knowledge}
-${ownQuotes.join("\n")}`);
-  const covered = new Set(input.coveredAwareness);
-  const duplicateOf = duplicatesOf(input.ideas, insights);
-  const checks = input.ideas.map(
-    (idea) => checkOne(idea, {
-      insights,
-      corpusFigures,
-      covered,
-      duplicateOf,
-      personas: input.personas,
-      closersLive: input.closersLive,
-      failed: input.ideas.filter((i) => i.status === "failed"),
-      sameMessage: input.sameMessage ?? SAME_WORDS
-    })
-  );
-  const toBuild = (c) => c.status === "idea";
-  return checks.sort(
-    (a, b) => Number(toBuild(b)) - Number(toBuild(a)) || b.score - a.score || a.id.localeCompare(b.id)
-  );
-}
-
-// src/commands/creatives/ideas-judgments.ts
-var STATISTIC_QUESTION = `\`quote\` was filed as something a customer said. Is it instead a statistic about a group of people, a share or a figure from a survey, a study or an article ("39% of UK homeowners say\u2026", "a quarter of buyers\u2026", "1 in 3 owners\u2026"), rather than one person's own words about their own experience? A person giving their own number ("My bill dropped 40%") is their own words. The quote may be in any language.`;
-var STATISTIC_HELD = 0.65;
-var SAME_MESSAGE_QUESTION = `\`a\` and \`b\` are the messages of two ads. Do they make the same core promise to the viewer (the same benefit, the same reason to act), even when one adds a detail or a few words, says it in other words, or is in another language? Two messages that promise different things about the same product are not the same.`;
-var SAME_MESSAGE_HELD = 0.42;
-async function withStatisticsRead(insights, ask) {
-  const observed = insights.filter((i) => i.status === "observed");
-  if (observed.length === 0) return [...insights];
-  const answers = await ask(observed.map((i) => ({ instructions: { quote: i.quote, question: STATISTIC_QUESTION } })));
-  if (answers === null) return [...insights];
-  const statistics = new Set(observed.filter((_, i) => (answers[i] ?? 0) >= STATISTIC_HELD).map((i) => i.id));
-  return insights.map((i) => statistics.has(i.id) ? { ...i, status: "interpreted" } : i);
-}
-async function sameMessageRead(ideas, ask) {
-  const failed = ideas.filter((i) => i.status === "failed");
-  const pairs = failed.flatMap(
-    (f) => ideas.filter((i) => i.id !== f.id && !SAME_WORDS(i.message, f.message)).map((i) => [f.message, i.message])
-  );
-  if (pairs.length === 0) return SAME_WORDS;
-  const answers = await ask(pairs.map(([a, b]) => ({ instructions: { a, b, question: SAME_MESSAGE_QUESTION } })));
-  if (answers === null) return SAME_WORDS;
-  const same = new Set(
-    pairs.filter((_, i) => (answers[i] ?? 0) >= SAME_MESSAGE_HELD).map(([a, b]) => `${a}\0${b}`)
-  );
-  return (a, b) => SAME_WORDS(a, b) || same.has(`${a}\0${b}`) || same.has(`${b}\0${a}`);
-}
-
-// src/commands/creatives/ideas-workspace.ts
-import { readdir, readFile } from "fs/promises";
-import path from "path";
-var IDEAS_DIR = path.join("src", "creatives", "_ideas");
-var INSIGHTS_DIR = path.join("src", "content", "insights");
-async function markdownFiles(dir, recursive = false) {
-  const entries = await readdir(dir, { recursive }).catch(() => []);
-  return entries.filter((f) => f.endsWith(".md")).sort();
-}
-var idOf = (file) => file.replace(/\\/g, "/").replace(/\.md$/, "");
-function workspaceIdeasJudge(root) {
-  const cacheDir = path.join(root, "canvas", ".cache");
-  const spent = [];
-  return {
-    ask: rememberedJev(path.join(cacheDir, "ideas-answers.json"), (u) => spent.push(u)),
-    done: () => holdUnbilledSpend(cacheDir, spent.splice(0)).catch(() => void 0)
-  };
-}
-async function readInsights(root, opts = {}) {
-  const dir = path.join(root, INSIGHTS_DIR);
-  const insights = [];
-  for (const file of await markdownFiles(dir, true)) {
-    const insight = parseInsight(idOf(file), await readFile(path.join(dir, file), "utf8").catch(() => ""));
-    if (insight) insights.push(insight);
-  }
-  if (opts.ask) return withStatisticsRead(insights, opts.ask);
-  const judge = workspaceIdeasJudge(root);
-  const read = await withStatisticsRead(insights, judge.ask);
-  await judge.done();
-  return read;
-}
-async function readIdeas(root) {
-  const dir = path.join(root, IDEAS_DIR);
-  const ideas = [];
-  const unreadable = [];
-  for (const file of await markdownFiles(dir)) {
-    const id = idOf(file);
-    const parsed = parseIdea(id, await readFile(path.join(dir, file), "utf8").catch(() => ""));
-    if (parsed.idea) ideas.push(parsed.idea);
-    else unreadable.push({ id, problems: parsed.problems });
-  }
-  return { ideas, unreadable };
-}
-async function readPersonaIds(root) {
-  return (await markdownFiles(path.join(root, "src", "content", "personas"), true)).map(idOf);
-}
-var MAX_KNOWLEDGE_CHARS = 2e5;
-async function readKnowledgeCorpus(root) {
-  const parts = [];
-  const company = await readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => "");
-  if (company) parts.push(company);
-  const content = path.join(root, "src", "content");
-  const insights = path.relative(content, path.join(root, INSIGHTS_DIR));
-  const files = (await markdownFiles(content, true)).filter((f) => !f.replace(/\\/g, "/").startsWith(`${insights}/`));
-  for (const file of files) {
-    parts.push(await readFile(path.join(content, file), "utf8").catch(() => ""));
-    if (parts.join("").length > MAX_KNOWLEDGE_CHARS) break;
-  }
-  return parts.join("\n").slice(0, MAX_KNOWLEDGE_CHARS);
-}
-async function readCreativeRecords(root) {
-  const dir = path.join(root, "src", "creatives");
-  const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
-  const records = [];
-  for (const entry of entries) {
-    if (!entry.isDirectory() || entry.name.startsWith("_")) continue;
-    const raw = await readFile(path.join(dir, entry.name, "_definition.md"), "utf8").catch(() => null);
-    if (raw === null) continue;
-    const fm = frontmatterOf(raw) ?? {};
-    const pick = (key) => typeof fm[key] === "string" && fm[key] ? { [key]: fm[key] } : {};
-    records.push({
-      slug: entry.name,
-      ...pick("status"),
-      ...pick("idea"),
-      ...pick("awareness"),
-      ...pick("angle"),
-      ...pick("kind")
-    });
-  }
-  return records;
-}
-var SHOWN_STATUSES = /* @__PURE__ */ new Set(["rendered", "published"]);
-function coverageOf(ideas, creatives) {
-  const live = ideas.filter((i) => i.status === "built" || i.status === "testing" || i.status === "winner");
-  const awareness = new Set(live.map((i) => i.awareness));
-  for (const creative of creatives) {
-    if (creative.awareness && SHOWN_STATUSES.has(creative.status ?? "")) awareness.add(creative.awareness);
-  }
-  return { coveredAwareness: [...awareness].sort(), closersLive: live.filter((i) => i.job === "closer").length };
-}
-
-export {
-  IDEA_ANGLES,
-  IDEA_VIDEO_FORMATS,
-  IDEA_FORMATS,
-  AWARENESS_STAGES,
-  figuresIn,
-  unsourcedClaims,
-  sourcesClaims,
-  checkIdeas,
-  sameMessageRead,
-  IDEAS_DIR,
-  workspaceIdeasJudge,
-  readInsights,
-  readIdeas,
-  readPersonaIds,
-  readKnowledgeCorpus,
-  readCreativeRecords,
-  coverageOf
-};
-//# sourceMappingURL=chunk-6ZCYWVKZ.js.map