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

package/dist/chunk-Z7ICQKC2.js

@@ -0,0 +1,344 @@
+import {
+  Phrases,
+  RULE_APPLIES,
+  RULE_STRENGTHS,
+  declaredRules,
+  readLearnedRules
+} from "./chunk-NOCBNING.js";
+import {
+  readWorkspaceBrandDoc
+} from "./chunk-EM5R3BYC.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-Q3G4ZI2U.js";
+import {
+  askAboutText,
+  rulesDigest,
+  selectRules
+} from "./chunk-GRX3JXSR.js";
+import {
+  CREATIVE_FEEDBACK_REASON_LABELS
+} from "./chunk-6DSPB6YA.js";
+import {
+  apiPost
+} from "./chunk-LJEJCIHR.js";
+
+// src/engine/creative-context/company.ts
+import { createHash } from "crypto";
+import { mkdir, readdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { z } from "zod";
+var text = z.string().transform((s) => s.trim()).pipe(z.string().min(1).max(300)).optional().catch(void 0);
+var Answer = z.object({
+  sells: text,
+  category: text,
+  industry: text,
+  buyer: z.enum(["consumer", "small_business", "enterprise"]).optional().catch(void 0),
+  country: z.string().transform((s) => s.trim().toUpperCase()).pipe(z.union([z.literal("").transform(() => null), z.string().regex(/^[A-Z]{2}$/)])).optional().catch(void 0),
+  humour: z.enum(["fits", "risky", "off_brand"]).optional().catch(void 0),
+  voice: z.enum(["playful", "peer", "neutral", "reassuring", "formal"]).optional().catch(void 0),
+  memes: z.enum(["fits", "off_brand"]).optional().catch(void 0),
+  memes_why: text,
+  brands: z.array(z.string()).transform(
+    (list) => list.map((s) => s.trim()).filter(Boolean).slice(0, 4)
+  ).catch([])
+});
+function parseCompanyReading(answer) {
+  const parsed = Answer.safeParse(answer);
+  if (!parsed.success || !parsed.data.category) return null;
+  const { brands, ...rest } = parsed.data;
+  return { ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== void 0)), brands };
+}
+var COMPANY_READING_MODEL = "google/gemini-3.5-flash-lite";
+var REQUEST = {
+  provider: { order: ["google-vertex"], allow_fallbacks: false },
+  seed: 0,
+  temperature: 0,
+  response_format: { type: "json_object" }
+};
+var PROMPT_VERSION = 5;
+var TIMEOUT_MS = 2e4;
+var COMPANY_CHARS = 12e3;
+function companyReadingPrompt(companyDoc, audience) {
+  const notes = [
+    audience?.personas ? `Its personas (who buys):
+${audience.personas}` : "",
+    audience?.voice ? `BRAND.md, how the brand speaks:
+${audience.voice}` : ""
+  ].filter(Boolean);
+  return `You read a company's own notes (COMPANY.md), in whatever language they are written, for the people who make its ads. Extract only what they say; never invent.
+
+"""
+${companyDoc.slice(0, COMPANY_CHARS)}
+"""
+${notes.length > 0 ? `
+${notes.join("\n\n")}
+` : ""}
+Answer only JSON:
+{
+ "sells": "what the company sells and to whom, one plain sentence of at most 20 words in the notes' own language, no brand names (e.g. 'Cursos de electricidad y fontaner\xEDa para desempleados que buscan un oficio estable')",
+ "category": "what it sells, 2-6 plain English words an ads library would file it under, no brand names (e.g. 'electrician training course', 'pet health insurance', 'ecommerce customer service AI'); for a company selling several lines, the line its notes lead with",
+ "industry": "the broader industry, 1-3 English words (e.g. 'vocational education', 'insurance', 'customer service software')",
+ "buyer": "consumer" | "small_business" | "enterprise",
+ "country": "the ISO country code it sells in, or '' when several",
+ "humour": "fits" | "risky" | "off_brand",
+ "voice": "playful" | "peer" | "neutral" | "reassuring" | "formal" (how the brand talks, from the BRAND.md voice and how it speaks on its site, ads and social, never from who buys: playful = witty, casual, irreverent, internet-native; peer = talks as an insider to its own crowd, developer-to-developer, builder to builder; neutral = plain, direct, informative with no personality signal; reassuring = warm, caring, guaranteeing, protecting, calming a fear about money, time or risk; formal = premium, institutional, solemn, corporate-confident),
+ "memes": "fits" | "off_brand" (does that voice run a meme or a reaction-face ad? playful and peer fit, enterprise included; neutral, reassuring and formal are off_brand, consumer brands included),
+ "memes_why": "the voice line that decides it, at most 20 words, quoting it (e.g. 'voice: "playful, a little irreverent"' or 'voice: "formal, premium, understated"')",
+ "brands": ["the company's own brand and product names, as an advertiser name would show them, at most 4"]
+}`;
+}
+var RUNS_MEMES = /* @__PURE__ */ new Set(["playful", "peer"]);
+function memeRegister(reading3) {
+  const memes = reading3?.voice ? RUNS_MEMES.has(reading3.voice) ? "fits" : "off_brand" : reading3?.memes;
+  if (!memes) return void 0;
+  const why = reading3?.memes_why;
+  return { memes, ...why ? { why } : {} };
+}
+function companyLine(reading3) {
+  if (!reading3) return "";
+  const what = reading3.sells ?? reading3.category ?? "";
+  return reading3.industry && what ? `${what} (${reading3.industry})` : what;
+}
+function firstLineSells(companyDoc) {
+  const first = companyDoc.split("\n").find((line) => line.trim() && !line.trim().startsWith("#")) ?? "";
+  if (/^\s*TODO\b/.test(first)) return "";
+  const what = first.replace(/^\s*[-*]\s+/, "").replace(/^\*\*[^*]+\*\*\s*[—–:-]?\s*/, "").split(/\s+for\s+|[,.;:(]|\s[—–-]\s/)[0];
+  return (what ?? "").trim().split(/\s+/).filter(Boolean).slice(0, SELLS_WORDS).join(" ");
+}
+var SELLS_WORDS = 6;
+var askModel = (root) => async (prompt) => {
+  const spent = [];
+  const answer = await askAboutText(COMPANY_READING_MODEL, prompt, (u) => spent.push(u), {
+    timeoutMs: TIMEOUT_MS,
+    request: REQUEST
+  }).catch(() => null);
+  await holdUnbilledSpend(path.join(root, "canvas", ".cache"), spent).catch(() => void 0);
+  return answer;
+};
+async function readCompanyReading(root, ask = askModel(root)) {
+  const doc = await readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => "");
+  const fallback = firstLineSells(doc);
+  if (!fallback) return null;
+  const prompt = companyReadingPrompt(doc, await audienceNotes(root));
+  const key = createHash("sha256").update(JSON.stringify([PROMPT_VERSION, COMPANY_READING_MODEL, prompt])).digest("hex").slice(0, 16);
+  const file = path.join(root, "canvas", ".cache", "company-reading", `${key}.json`);
+  const inFlight = reading.get(file);
+  if (inFlight) return await inFlight;
+  const read = readOrAsk(file, prompt, ask, fallback).finally(() => reading.delete(file));
+  reading.set(file, read);
+  return await read;
+}
+var PERSONA_CHARS = 600;
+var VOICE_CHARS = 800;
+async function audienceNotes(root) {
+  const dir = path.join(root, "src", "content", "personas");
+  const files = (await readdir(dir).catch(() => [])).filter((f) => f.endsWith(".md")).sort();
+  const personas = [];
+  for (const file of files.slice(0, 8)) {
+    const raw = await readFile(path.join(dir, file), "utf8").catch(() => "");
+    const front = /^---\n([\s\S]*?)\n---/.exec(raw)?.[1] ?? raw.slice(0, 300);
+    const lines = front.split("\n").filter((l) => /^\s*(title|name|role|job|description)\s*:/i.test(l));
+    const line = (lines.length > 0 ? lines.join("; ") : file.replace(/\.md$/, "")).slice(0, PERSONA_CHARS);
+    personas.push(`- ${line}`);
+  }
+  const brand = await readFile(path.join(root, "src", "brand", "BRAND.md"), "utf8").catch(() => "");
+  const section = /^##\s+[^\n]*\b(?:tone|voice)\b[^\n]*\n([\s\S]*?)(?=^##\s|(?![\s\S]))/im.exec(brand)?.[1] ?? "";
+  return { personas: personas.join("\n"), voice: section.trim().slice(0, VOICE_CHARS) };
+}
+var reading = /* @__PURE__ */ new Map();
+async function readOrAsk(file, prompt, ask, fallback) {
+  const cached = await readFile(file, "utf8").then((raw) => parseCompanyReading(JSON.parse(raw))).catch(() => null);
+  if (cached) return cached;
+  const answer = parseCompanyReading(await ask(prompt).catch(() => null));
+  if (!answer) return { sells: fallback, brands: [] };
+  await mkdir(path.dirname(file), { recursive: true });
+  await writeFile(file, `${JSON.stringify(answer, null, 2)}
+`, "utf8");
+  return answer;
+}
+
+// src/engine/creative-context/case-file.ts
+var CASE_FILE_CHARS = 3e3;
+function caseFileNotes(entries) {
+  const seen = /* @__PURE__ */ new Set();
+  const lines = [];
+  let used = 0;
+  for (const entry of entries) {
+    if (entry.verdict !== "rejected") continue;
+    const note = entry.note?.trim();
+    const reasons = entry.reasons.map((r) => CREATIVE_FEEDBACK_REASON_LABELS[r].toLowerCase()).join(", ");
+    const key = note ?? reasons;
+    if (!key || seen.has(key)) continue;
+    seen.add(key);
+    const line = `Rejected${reasons ? ` (${reasons})` : ""}${note ? `: "${note}"` : ""}`;
+    if (used + line.length > CASE_FILE_CHARS && lines.length > 0) break;
+    used += line.length;
+    lines.push(line);
+  }
+  return lines;
+}
+async function readCaseFile(slug, read = (body) => apiPost("/api/creatives/feedback", body)) {
+  const response = await read({ slug }).catch(() => null);
+  return response?.ok ? caseFileNotes(response.data.recent) : [];
+}
+
+// src/engine/creative-context/index.ts
+import path3 from "path";
+
+// src/engine/brand/brand-rules.ts
+import { createHash as createHash2 } from "crypto";
+import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
+import path2 from "path";
+import { z as z2 } from "zod";
+var BRAND_RULES_MODEL = "google/gemini-3.5-flash";
+var REQUEST2 = {
+  provider: { order: ["google-vertex"], allow_fallbacks: false },
+  seed: 0,
+  reasoning: { effort: "low" },
+  response_format: { type: "json_object" }
+};
+var PROMPT_VERSION2 = 2;
+var TIMEOUT_MS2 = 6e4;
+var BRAND_MD_CHARS = 6e4;
+var MAX_RULES = 60;
+var RULE_CHARS = 400;
+var optionalPhrases = Phrases.optional().catch(void 0);
+var Rule = z2.object({
+  text: z2.string().trim().min(1).max(RULE_CHARS),
+  strength: z2.enum(RULE_STRENGTHS).catch("must"),
+  applies: z2.enum(RULE_APPLIES).catch("any"),
+  forbid: optionalPhrases,
+  require: optionalPhrases,
+  allow: optionalPhrases
+});
+var Answer2 = z2.object({ rules: z2.array(z2.unknown()) });
+function parseBrandRules(answer) {
+  const parsed = Answer2.safeParse(answer);
+  if (!parsed.success) return null;
+  return parsed.data.rules.flatMap((raw) => {
+    const rule = Rule.safeParse(raw);
+    if (!rule.success) return [];
+    const { forbid, require: require2, allow, ...rest } = rule.data;
+    return [
+      {
+        ...rest,
+        ...forbid?.length ? { forbid } : {},
+        ...require2?.length ? { require: require2 } : {},
+        ...allow?.length ? { allow } : {}
+      }
+    ];
+  }).slice(0, MAX_RULES);
+}
+var RULE_HEADING = /rule|never|copy|voice|tone|logo|imag|photo|illustrat|legal|claim|checklist|reflex|prohibit|say|regla|nunca|voz|tono|imagen|foto|prohib|decir|règle|jamais|regel|stimme|bild|regra|imagem/i;
+function ruleSections(brandMd) {
+  const headings = [...brandMd.slice(0, BRAND_MD_CHARS).matchAll(/^#{2,4}\s+(.+)$/gm)].map((m) => (m[1] ?? "").trim()).filter((h) => RULE_HEADING.test(h));
+  const fence = /```generation-style/.test(brandMd) ? ["the ```generation-style block"] : [];
+  return [.../* @__PURE__ */ new Set([...headings, ...fence])];
+}
+var PRIVATE_QUOTE_LINE = "Never publish a customer quote or an identifiable customer conversation.";
+var PRIVATE_QUOTE_MEANT = "Never publish what a customer said in a private call, chat or note, nor a conversation that identifies them. A testimonial, review or case study the customer published or agreed to is not a private call: an ad may quote it.";
+function brandRulesPrompt(document) {
+  const brandMd = document.replaceAll(PRIVATE_QUOTE_LINE, PRIVATE_QUOTE_MEANT);
+  const sections = ruleSections(brandMd);
+  return [
+    "You read a company's brand guidelines (BRAND.md), written in any language, for the people who make its ads. List every standing rule they set that an ad, its words, its pictures, its people or its logo must follow. Extract only what they state; never invent a rule.",
+    "",
+    "Go through the document section by section: every bullet or sentence of a section about copy or wording, voice, what the brand never says, things to reject, legal risk or claims it may not make, a checklist before publishing, how its name, numbers or prices are written, which logo to use and what never to do to it, photography, illustration, imagery or a generation-style block is one rule; keep each, a style taste included (as a prefer), whatever language the section is in. Leave out only rules about web pages, components, code, spacing, typefaces, colours' hex values and where a colour goes on a page.",
+    ...sections.length > 0 ? [
+      "",
+      `Sections that most likely hold rules, each to be read to its end: ${sections.map((h) => `"${h}"`).join(", ")}.`
+    ] : [],
+    "",
+    `Return JSON only: {"rules": [{"text": string, "strength": "never" | "must" | "prefer", "applies": "copy" | "picture" | "cast" | "logo" | "voice" | "sound" | "subtitles" | "any", "forbid": string[], "require": string[], "allow": string[]}]}, at most ${MAX_RULES}, each rule once.`,
+    `- text: the rule quoted from the document in its own language, whole but short (one bullet, at most one sentence of why). It must make sense read alone, as an ad's reviewer reads it: when a bullet leans on its heading or table, name what it is about ("Brand red: never for text or buttons", not "Never text, never a button").`,
+    '- strength: "never" for a ban, "must" for something every ad has to do, "prefer" for a taste or a default.',
+    `- applies: "copy" for words, "picture" for what is shown, "cast" for who appears, "logo", "voice" or "sound" for a video's voice and audio, "subtitles", else "any".`,
+    '- forbid: the exact words the rule bans in every case, as the document quotes them ("\u2014" for em-dashes, "usted"); [] when the ban depends on the context or names no words. allow: the right spelling when the rule is about how a word is written or capitalised ("ZentIA"). require: words every ad must say; usually [].',
+    "",
+    "<brand_md>",
+    brandMd.slice(0, BRAND_MD_CHARS),
+    "</brand_md>"
+  ].join("\n");
+}
+function brandRulesReader(cacheDir, onSpend) {
+  return async (brandMd) => {
+    const prompt = brandRulesPrompt(brandMd);
+    const key = createHash2("sha256").update(JSON.stringify([PROMPT_VERSION2, BRAND_RULES_MODEL, prompt])).digest("hex");
+    const file = path2.join(cacheDir, "brand-rules", `${key}.json`);
+    const inFlight = reading2.get(file);
+    if (inFlight) return await inFlight;
+    if (failed.has(file)) return null;
+    const read = readOrAsk2(file, prompt, onSpend, cacheDir).then((rules) => {
+      if (rules === null) failed.add(file);
+      return rules;
+    }).finally(() => reading2.delete(file));
+    reading2.set(file, read);
+    return await read;
+  };
+}
+var reading2 = /* @__PURE__ */ new Map();
+var failed = /* @__PURE__ */ new Set();
+async function readOrAsk2(file, prompt, onSpend, cacheDir) {
+  const cached = parseBrandRules(await readFile2(file, "utf8").then(JSON.parse, () => null));
+  if (cached) return cached;
+  const spent = [];
+  const answer = await askAboutText(BRAND_RULES_MODEL, prompt, (u) => onSpend ? onSpend(u) : spent.push(u), {
+    timeoutMs: TIMEOUT_MS2,
+    request: REQUEST2
+  }).catch(() => null);
+  await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
+  const rules = parseBrandRules(answer);
+  if (rules) {
+    await mkdir2(path2.dirname(file), { recursive: true }).catch(() => void 0);
+    await writeFile2(file, JSON.stringify({ rules }), "utf8").catch(() => void 0);
+  }
+  return rules;
+}
+async function readWorkspaceBrandRules(root, opts = {}) {
+  const brandMd = await readFile2(path2.join(root, "src", "brand", "BRAND.md"), "utf8").catch(() => "");
+  if (!brandMd.trim()) return [];
+  const read = opts.read ?? brandRulesReader(path2.join(root, "canvas", ".cache"), opts.onSpend);
+  return await read(brandMd).catch(() => null) ?? [];
+}
+
+// src/engine/creative-context/index.ts
+async function readAllRules(root, readers = {}) {
+  const [declared, learned] = await Promise.all([
+    readWorkspaceBrandRules(root, {
+      ...readers.brandRules ? { read: readers.brandRules } : {},
+      ...readers.onSpend ? { onSpend: readers.onSpend } : {}
+    }),
+    readLearnedRules(root)
+  ]);
+  return [...learned, ...declaredRules(declared)];
+}
+async function readCreativeContext(root, target = {}, opts = {}) {
+  const readers = opts.readers ?? {};
+  const [company, brand, rules] = await Promise.all([
+    readCompanyReading(root, ...readers.company ? [readers.company] : []).catch(() => null),
+    readWorkspaceBrandDoc(root, {
+      ...readers.brand ? { read: readers.brand } : {},
+      ...readers.onSpend ? { onSpend: readers.onSpend } : {}
+    }).catch(() => null),
+    readAllRules(root, readers).catch(() => [])
+  ]);
+  const held = selectRules(rules, target, opts.waived);
+  return { company, brand, rules: held, rulesDigest: rulesDigest(held), caseFile: (slug) => readCaseFile(slug) };
+}
+var workspaceOfCreative = (creativeDir) => path3.resolve(creativeDir, "../../..");
+function avoidOf(rules, max = 5) {
+  return rules.filter((r) => r.strength === "never" && r.applies !== "voice" && r.applies !== "sound").slice(0, max).map((r) => r.text.length > 90 ? `${r.text.slice(0, 89)}\u2026` : r.text);
+}
+
+export {
+  memeRegister,
+  companyLine,
+  readCompanyReading,
+  readCaseFile,
+  readAllRules,
+  readCreativeContext,
+  workspaceOfCreative,
+  avoidOf
+};
+//# sourceMappingURL=chunk-Z7ICQKC2.js.map

package/dist/chunk-ZBXV2KOQ.js

@@ -0,0 +1,220 @@
+import {
+  readRenderState,
+  recordSeen
+} from "./chunk-3UNMVVSI.js";
+import {
+  GLOBAL_PROMPT_FILE,
+  ideaBaseline,
+  isVideoBlueprint,
+  readIdeaAnchor,
+  recordedChanges
+} from "./chunk-MZLPOYCC.js";
+import {
+  loadCompositionMeta
+} from "./chunk-HQDNDKNR.js";
+import {
+  parseRefExpr
+} from "./chunk-Z5BG47PO.js";
+import {
+  resolveAdaptFormats
+} from "./chunk-F3CZFUXZ.js";
+import {
+  apiPost
+} from "./chunk-LJEJCIHR.js";
+
+// src/commands/canvas/output-ratio.ts
+import { readFile } from "fs/promises";
+import path from "path";
+function definitionFormats(markdown) {
+  const front = markdown.match(/^---\n([\s\S]*?)\n---/)?.[1];
+  if (!front) return [];
+  const clean = (s) => s.trim().replace(/^["']|["']$/g, "");
+  const flow = front.match(/^formats:\s*\[([^\]]*)\]/m);
+  if (flow) return (flow[1] ?? "").split(",").map(clean).filter(Boolean);
+  const block = front.match(/^formats:\s*\n((?:\s+-\s+.*\n?)+)/m);
+  if (!block) return [];
+  return (block[1] ?? "").split("\n").map((l) => l.replace(/^\s+-\s+/, "")).map(clean).filter(Boolean);
+}
+function reduce(width, height) {
+  const gcd = (a, b) => b === 0 ? a : gcd(b, a % b);
+  const d = gcd(width, height);
+  return `${width / d}:${height / d}`;
+}
+async function ratiosOf(nodes, id, seen) {
+  const node = nodes.get(id);
+  if (!node || seen.has(id)) return null;
+  seen.add(id);
+  const p = node.params ?? {};
+  switch (node.type) {
+    case "image_generate":
+      return typeof p.aspect_ratio === "string" ? [p.aspect_ratio] : null;
+    case "image_aspect_adapt":
+      return [...resolveAdaptFormats(p)];
+    case "hyperframe_snapshot": {
+      if (typeof p.composition !== "string") return null;
+      const meta = await loadCompositionMeta(p.composition).catch(() => null);
+      return meta ? [reduce(meta.width, meta.height)] : null;
+    }
+    case "collect": {
+      const images = node.inputs?.images;
+      if (!Array.isArray(images)) return null;
+      const out = [];
+      for (const entry of images) {
+        const ref = typeof entry === "string" ? parseRefExpr(entry) : null;
+        if (!ref || ref.kind !== "ref") return null;
+        const upstream = await ratiosOf(nodes, ref.nodeId, seen);
+        if (!upstream) return null;
+        out.push(ref.index !== void 0 && upstream.length > 1 ? upstream[ref.index] ?? "" : upstream[0] ?? "");
+      }
+      return out.filter(Boolean);
+    }
+    default:
+      return null;
+  }
+}
+async function producedRatios(canvas) {
+  const c = canvas;
+  if (!Array.isArray(c?.nodes) || typeof c?.output?.node !== "string") return null;
+  const nodes = new Map(c.nodes.flatMap((n) => typeof n.id === "string" ? [[n.id, n]] : []));
+  return ratiosOf(nodes, c.output.node, /* @__PURE__ */ new Set());
+}
+function value(ratio) {
+  const [w, h] = ratio.split(":").map(Number);
+  return w && h ? w / h : null;
+}
+function outputRatioWarnings(declared, produced) {
+  if (!produced || produced.length === 0) return [];
+  const shapes = produced.flatMap((r) => value(r) ?? []);
+  return declared.flatMap((format) => {
+    const want = value(format);
+    if (want === null || shapes.some((s) => Math.abs(s / want - 1) <= 0.02)) return [];
+    return [
+      {
+        path: "output",
+        code: "OUTPUT_RATIO_MISMATCH",
+        severity: "warning",
+        message: `_definition.md declares ${format}, but this canvas delivers ${produced.join(", ")}. A ${format} placement would get the wrong shape: re-scaffold with that format, or fix the formats the creative declares.`
+      }
+    ];
+  });
+}
+async function outputRatioWarningsFor(canvas, canvasPath) {
+  const definition = await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8").catch(() => null);
+  if (!definition) return [];
+  return outputRatioWarnings(definitionFormats(definition), await producedRatios(canvas));
+}
+
+// src/commands/canvas/printed-result.ts
+var FULL_GUIDE = "The full guide: the `[hint]` lines on stderr, or `--full`.";
+function runResult(fields, opts) {
+  const hints = opts.full || !fields.brief ? fields.hints : [...fields.brief, FULL_GUIDE];
+  return {
+    ok: true,
+    ...opts.full ? { outputs_dir: fields.outputs_dir, output: fields.output, stats: fields.stats } : {},
+    ...fields.review ? { review: fields.review } : {},
+    ...opts.full && fields.judge?.length ? { judge: fields.judge } : {},
+    ...fields.definition_status ? { definition_status: fields.definition_status } : {},
+    ...hints?.length ? { hints } : {},
+    ...fields.verdict ? { verdict: fields.verdict } : {},
+    run_id: fields.run_id,
+    files: fields.files
+  };
+}
+function validateResult(fields, opts) {
+  if (opts.full) return { ok: true, ...fields };
+  return {
+    ok: true,
+    total_nodes: fields.total_nodes,
+    estimated_credits: fields.estimated_credits,
+    canvas_updated: fields.canvas_updated,
+    warnings: fields.warnings
+  };
+}
+
+// src/commands/canvas/shown-version.ts
+import { z } from "zod";
+var ShownResponse = z.object({
+  data: z.object({
+    runId: z.string(),
+    sourceSha: z.string().optional(),
+    createdAt: z.number(),
+    canvasSnapshotUrl: z.string().optional()
+  })
+});
+var SnapshotEntry = z.object({ path: z.string(), url: z.string() });
+var SnapshotFiles = z.object({ canvas: SnapshotEntry.optional(), files: z.array(SnapshotEntry) });
+var HISTORY = {
+  shown: async (slug) => ShownResponse.parse(await apiPost("/api/creatives/run", { slug })).data,
+  file: async (url) => {
+    const res = await fetch(url);
+    return res.ok ? res.json() : null;
+  },
+  text: async (url) => {
+    const res = await fetch(url);
+    return res.ok ? res.text() : null;
+  }
+};
+async function shownVersion(canvasRoot, slug, sources = HISTORY) {
+  const here = await readRenderState(canvasRoot, slug);
+  if (here.rendered) return here;
+  const run = await sources.shown(slug).catch(() => null);
+  if (!run) return here;
+  const drawn = run.canvasSnapshotUrl ? await drawnFiles(run.canvasSnapshotUrl, sources) : {};
+  return {
+    ...here,
+    rendered: { sourceSha: run.sourceSha ?? "", runId: run.runId, at: run.createdAt },
+    ...drawn.prompt !== void 0 ? { prompt: drawn.prompt } : {},
+    ...drawn.definition !== void 0 ? { definition: drawn.definition } : {},
+    ...drawn.video ? { video: drawn.video } : {}
+  };
+}
+async function drawnFiles(manifestUrl, sources) {
+  const manifest = SnapshotFiles.safeParse(await sources.file(manifestUrl).catch(() => null));
+  const files = manifest.success ? manifest.data.files : [];
+  const urlOf = (file) => files.find((f) => f.path === file)?.url;
+  const promptUrl = urlOf(GLOBAL_PROMPT_FILE);
+  const definitionUrl = urlOf("_definition.md");
+  const read = (url) => url ? sources.file(url).catch(() => null) : Promise.resolve(null);
+  const sceneEntries = files.filter((f) => /^scenes\/[^/]+\.json$/.test(f.path)).sort((a, b) => a.path.localeCompare(b.path));
+  const [prompt, definition, scenes, canvas, adSpec] = await Promise.all([
+    read(promptUrl),
+    definitionUrl ? sources.text(definitionUrl).catch(() => null) : null,
+    Promise.all(sceneEntries.map((f) => read(f.url))),
+    read(manifest.success ? manifest.data.canvas?.url : void 0),
+    read(urlOf("ad.spec.json"))
+  ]);
+  return {
+    ...prompt !== null && prompt !== void 0 ? { prompt } : {},
+    ...typeof definition === "string" ? { definition } : {},
+    video: { scenes: scenes.filter((s) => s !== null), canvas, adSpec }
+  };
+}
+
+// src/commands/canvas/shown-anchor.ts
+async function shownBaseline(opts) {
+  const state = await readRenderState(opts.canvasRoot, opts.slug);
+  const known = opts.turnId !== void 0 && state.seen?.turnId === opts.turnId;
+  let fallback;
+  if (!known && !state.anchor) {
+    const shown = opts.shown ?? await shownVersion(opts.canvasRoot, opts.slug, opts.sources);
+    if (shown.rendered && shown.prompt !== void 0) {
+      const video = typeof shown.prompt === "object" && shown.prompt !== null && isVideoBlueprint(shown.prompt);
+      const recorded = shown.video;
+      const unrecorded = video && (!recorded || recorded.canvas === null || recorded.canvas === void 0);
+      const anchor = unrecorded ? void 0 : (await readIdeaAnchor(opts.creativeDir, { spec: shown.prompt, ...video && recorded ? { recorded } : {} }))?.anchor;
+      if (anchor) fallback = { ...anchor, changes: shown.definition ? recordedChanges(shown.definition) : [] };
+    }
+  }
+  const { baseline, seen } = ideaBaseline(state, opts.turnId, fallback);
+  if (seen && opts.record) await recordSeen(opts.canvasRoot, opts.slug, seen);
+  return baseline ? { baseline } : {};
+}
+
+export {
+  outputRatioWarningsFor,
+  runResult,
+  validateResult,
+  shownVersion,
+  shownBaseline
+};
+//# sourceMappingURL=chunk-ZBXV2KOQ.js.map

package/dist/chunk-ZBXV2KOQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/output-ratio.ts","../src/commands/canvas/printed-result.ts","../src/commands/canvas/shown-version.ts","../src/commands/canvas/shown-anchor.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { resolveAdaptFormats } from \"@baker/canvas-contract\";\nimport type { ValidationIssue } from \"../../engine/engine/errors.ts\";\nimport { loadCompositionMeta } from \"../../engine/engine/composition-meta.ts\";\nimport { parseRefExpr } from \"../../engine/schema/canvas.ts\";\n\n/**\n * Does the canvas deliver the formats its creative says it delivers?\n *\n * A creative declared `formats: [\"4:5\"]` shipped a 1024x1536 image into a staged Meta ad:\n * its hero was generated at 3:4 (gpt-image has no 4:5) and nothing converted it, and\n * `validate` answered `warnings: []`. This compares the shapes the canvas's output is\n * rendered at with the formats `_definition.md` declares, and warns before anything bills.\n */\n\n/** The `formats` a `_definition.md` frontmatter declares (flow or block list). */\nexport function definitionFormats(markdown: string): string[] {\n  const front = markdown.match(/^---\\n([\\s\\S]*?)\\n---/)?.[1];\n  if (!front) return [];\n  const clean = (s: string) => s.trim().replace(/^[\"']|[\"']$/g, \"\");\n  const flow = front.match(/^formats:\\s*\\[([^\\]]*)\\]/m);\n  if (flow) return (flow[1] ?? \"\").split(\",\").map(clean).filter(Boolean);\n  const block = front.match(/^formats:\\s*\\n((?:\\s+-\\s+.*\\n?)+)/m);\n  if (!block) return [];\n  return (block[1] ?? \"\")\n    .split(\"\\n\")\n    .map((l) => l.replace(/^\\s+-\\s+/, \"\"))\n    .map(clean)\n    .filter(Boolean);\n}\n\ntype Node = { id?: unknown; type?: unknown; params?: Record<string, unknown>; inputs?: Record<string, unknown> };\n\nfunction reduce(width: number, height: number): string {\n  const gcd = (a: number, b: number): number => (b === 0 ? a : gcd(b, a % b));\n  const d = gcd(width, height);\n  return `${width / d}:${height / d}`;\n}\n\n/** The ratios one node renders at, or null when its shape cannot be known before the run. */\nasync function ratiosOf(nodes: Map<string, Node>, id: string, seen: Set<string>): Promise<string[] | null> {\n  const node = nodes.get(id);\n  if (!node || seen.has(id)) return null;\n  seen.add(id);\n  const p = node.params ?? {};\n  switch (node.type) {\n    case \"image_generate\":\n      return typeof p.aspect_ratio === \"string\" ? [p.aspect_ratio] : null;\n    case \"image_aspect_adapt\":\n      return [...resolveAdaptFormats(p as Parameters<typeof resolveAdaptFormats>[0])];\n    case \"hyperframe_snapshot\": {\n      if (typeof p.composition !== \"string\") return null;\n      const meta = await loadCompositionMeta(p.composition).catch(() => null);\n      return meta ? [reduce(meta.width, meta.height)] : null;\n    }\n    case \"collect\": {\n      const images = node.inputs?.images;\n      if (!Array.isArray(images)) return null;\n      const out: string[] = [];\n      for (const entry of images) {\n        const ref = typeof entry === \"string\" ? parseRefExpr(entry) : null;\n        if (!ref || ref.kind !== \"ref\") return null;\n        const upstream = await ratiosOf(nodes, ref.nodeId, seen);\n        if (!upstream) return null;\n        out.push(ref.index !== undefined && upstream.length > 1 ? (upstream[ref.index] ?? \"\") : (upstream[0] ?? \"\"));\n      }\n      return out.filter(Boolean);\n    }\n    default:\n      return null;\n  }\n}\n\n/**\n * The ratios the canvas's output is rendered at, in order, or null when any of them\n * cannot be known before the run (a local transform, a hand-built node). Composition\n * paths must already be resolved.\n */\nexport async function producedRatios(canvas: unknown): Promise<string[] | null> {\n  const c = canvas as { nodes?: unknown; output?: { node?: unknown } } | null;\n  if (!Array.isArray(c?.nodes) || typeof c?.output?.node !== \"string\") return null;\n  const nodes = new Map((c.nodes as Node[]).flatMap((n) => (typeof n.id === \"string\" ? [[n.id, n] as const] : [])));\n  return ratiosOf(nodes, c.output.node, new Set());\n}\n\nfunction value(ratio: string): number | null {\n  const [w, h] = ratio.split(\":\").map(Number);\n  return w && h ? w / h : null;\n}\n\n/** One warning per declared format no output is within 2% of. Pure. */\nexport function outputRatioWarnings(declared: string[], produced: string[] | null): ValidationIssue[] {\n  if (!produced || produced.length === 0) return [];\n  const shapes = produced.flatMap((r) => value(r) ?? []);\n  return declared.flatMap((format) => {\n    const want = value(format);\n    if (want === null || shapes.some((s) => Math.abs(s / want - 1) <= 0.02)) return [];\n    return [\n      {\n        path: \"output\",\n        code: \"OUTPUT_RATIO_MISMATCH\",\n        severity: \"warning\" as const,\n        message: `_definition.md declares ${format}, but this canvas delivers ${produced.join(\", \")}. A ${format} placement would get the wrong shape: re-scaffold with that format, or fix the formats the creative declares.`,\n      },\n    ];\n  });\n}\n\n/** The warnings for the canvas at `canvasPath`, read against its own `_definition.md`. */\nexport async function outputRatioWarningsFor(canvas: unknown, canvasPath: string): Promise<ValidationIssue[]> {\n  const definition = await readFile(path.join(path.dirname(canvasPath), \"_definition.md\"), \"utf8\").catch(() => null);\n  if (!definition) return [];\n  return outputRatioWarnings(definitionFormats(definition), await producedRatios(canvas));\n}\n","/**\n * What `canvas run` and `canvas validate` print on success. By default only what the agent decides on;\n * `--full` adds the rest. Ten of eleven runs were piped through `tail` to reach the verdict past the\n * per-node output, stats and judge scores, and validate's per-node price list (BAKER-993).\n */\n\ntype RunFields = {\n  outputs_dir: string;\n  output: unknown;\n  stats: unknown;\n  review?: unknown[];\n  judge?: unknown[];\n  definition_status?: \"rendered\";\n  /** The full guide: printed with `--full`, and in place of `brief` when there is none. */\n  hints?: string[];\n  /** The next step alone, printed by default in place of `hints`. */\n  brief?: string[];\n  verdict?: string;\n  run_id: string;\n  files: Record<string, string>;\n};\n\n/** Where the full guide is when the default printed only the next step. */\nexport const FULL_GUIDE = \"The full guide: the `[hint]` lines on stderr, or `--full`.\";\n\n/** The run's envelope: `verdict`, `run_id` and `files` last, so a cut output still keeps them. Pure. */\nexport function runResult(fields: RunFields, opts: { full: boolean }): Record<string, unknown> {\n  const hints = opts.full || !fields.brief ? fields.hints : [...fields.brief, FULL_GUIDE];\n  return {\n    ok: true,\n    ...(opts.full ? { outputs_dir: fields.outputs_dir, output: fields.output, stats: fields.stats } : {}),\n    ...(fields.review ? { review: fields.review } : {}),\n    ...(opts.full && fields.judge?.length ? { judge: fields.judge } : {}),\n    ...(fields.definition_status ? { definition_status: fields.definition_status } : {}),\n    ...(hints?.length ? { hints } : {}),\n    ...(fields.verdict ? { verdict: fields.verdict } : {}),\n    run_id: fields.run_id,\n    files: fields.files,\n  };\n}\n\ntype ValidateFields = {\n  total_nodes: number;\n  estimated_credits: unknown;\n  cost_preview: unknown[];\n  style_projection: unknown;\n  scene_projection: unknown;\n  canvas_updated: boolean;\n  normalized_paths: unknown[];\n  warnings: unknown[];\n};\n\n/** The validate envelope: the per-node price and what the projections did only with `--full`. Pure. */\nexport function validateResult(fields: ValidateFields, opts: { full: boolean }): Record<string, unknown> {\n  if (opts.full) return { ok: true, ...fields };\n  return {\n    ok: true,\n    total_nodes: fields.total_nodes,\n    estimated_credits: fields.estimated_credits,\n    canvas_updated: fields.canvas_updated,\n    warnings: fields.warnings,\n  };\n}\n","import { z } from \"zod\";\nimport { apiPost } from \"../../client.ts\";\nimport { type RenderState, readRenderState } from \"./render-state.ts\";\nimport { GLOBAL_PROMPT_FILE } from \"./scene-files.ts\";\n\n/**\n * The version a creative shows, as a render in this workspace starts from it.\n *\n * What a workspace rendered lives in its gitignored `canvas/` (`render-state.ts`), which a chat's\n * Runtime keeps while it is paused but a new chat's Runtime starts without. There the version was\n * unknown: a colour change rendered three new options, a `--fix` had nothing to correct, and a\n * plain run brought back the pictures from before a regeneration. So with no render of its own,\n * the workspace takes the version the company's run history shows (the one chosen, else the\n * newest) and the prompt.json that version drew, from the snapshot its run kept. Never fatal: a\n * history that cannot be reached leaves the workspace's own record as it is.\n */\n\ntype ShownRun = { runId: string; sourceSha?: string; createdAt: number; canvasSnapshotUrl?: string };\n\nexport type ShownSources = {\n  /** The run of the version the creative shows, or null when it has none. */\n  shown: (slug: string) => Promise<ShownRun | null>;\n  /** A JSON file from the durable store. */\n  file: (url: string) => Promise<unknown>;\n  /** A text file from the durable store, or null. */\n  text: (url: string) => Promise<string | null>;\n};\n\n/** The version shown, with the `_definition.md` its run drew when it came from the run history. */\nexport type ShownVersion = RenderState & {\n  definition?: string;\n  /** A video's scene files, canvas and ad.spec.json as that run kept them; canvas is null when it kept none. */\n  video?: { scenes: unknown[]; canvas: unknown; adSpec: unknown };\n};\n\nconst ShownResponse = z.object({\n  data: z.object({\n    runId: z.string(),\n    sourceSha: z.string().optional(),\n    createdAt: z.number(),\n    canvasSnapshotUrl: z.string().optional(),\n  }),\n});\n\nconst SnapshotEntry = z.object({ path: z.string(), url: z.string() });\nconst SnapshotFiles = z.object({ canvas: SnapshotEntry.optional(), files: z.array(SnapshotEntry) });\n\nconst HISTORY: ShownSources = {\n  shown: async (slug) => ShownResponse.parse(await apiPost(\"/api/creatives/run\", { slug })).data,\n  file: async (url) => {\n    const res = await fetch(url);\n    return res.ok ? res.json() : null;\n  },\n  text: async (url) => {\n    const res = await fetch(url);\n    return res.ok ? res.text() : null;\n  },\n};\n\nexport async function shownVersion(\n  canvasRoot: string,\n  slug: string,\n  sources: ShownSources = HISTORY,\n): Promise<ShownVersion> {\n  const here = await readRenderState(canvasRoot, slug);\n  if (here.rendered) return here;\n  const run = await sources.shown(slug).catch(() => null);\n  if (!run) return here;\n  const drawn = run.canvasSnapshotUrl ? await drawnFiles(run.canvasSnapshotUrl, sources) : {};\n  return {\n    ...here,\n    rendered: { sourceSha: run.sourceSha ?? \"\", runId: run.runId, at: run.createdAt },\n    ...(drawn.prompt !== undefined ? { prompt: drawn.prompt } : {}),\n    ...(drawn.definition !== undefined ? { definition: drawn.definition } : {}),\n    ...(drawn.video ? { video: drawn.video } : {}),\n  };\n}\n\n/** The prompt.json, `_definition.md` and video sources a run drew, from the snapshot of its files; each absent when it kept none. */\nasync function drawnFiles(\n  manifestUrl: string,\n  sources: ShownSources,\n): Promise<{ prompt?: unknown; definition?: string; video?: ShownVersion[\"video\"] }> {\n  const manifest = SnapshotFiles.safeParse(await sources.file(manifestUrl).catch(() => null));\n  const files = manifest.success ? manifest.data.files : [];\n  const urlOf = (file: string) => files.find((f) => f.path === file)?.url;\n  const promptUrl = urlOf(GLOBAL_PROMPT_FILE);\n  const definitionUrl = urlOf(\"_definition.md\");\n  const read = (url: string | undefined) => (url ? sources.file(url).catch(() => null) : Promise.resolve(null));\n  const sceneEntries = files.filter((f) => /^scenes\\/[^/]+\\.json$/.test(f.path)).sort((a, b) => a.path.localeCompare(b.path));\n  const [prompt, definition, scenes, canvas, adSpec] = await Promise.all([\n    read(promptUrl),\n    definitionUrl ? sources.text(definitionUrl).catch(() => null) : null,\n    Promise.all(sceneEntries.map((f) => read(f.url))),\n    read(manifest.success ? manifest.data.canvas?.url : undefined),\n    read(urlOf(\"ad.spec.json\")),\n  ]);\n  return {\n    ...(prompt !== null && prompt !== undefined ? { prompt } : {}),\n    ...(typeof definition === \"string\" ? { definition } : {}),\n    video: { scenes: scenes.filter((s) => s !== null), canvas, adSpec },\n  };\n}\n","/**\n * The idea a run or a validate is held to (`idea-gate.ts` `ideaBaseline`), read where it lives: what\n * the turn saw, else this workspace's last render, else (a new chat's Runtime) the version the run\n * history shows, read with the prompt.json it drew (a video's scenes, canvas and ad.spec.json as its run recorded them; no baseline when it kept no canvas) and the definition as it is now. The definition's\n * own fields then equal the current ones and cannot drift there: the price of a version rendered\n * elsewhere. Its `## Changes` lines are the ones that version's own definition held (none when its\n * run kept no copy), never the ones on disk: a line added since is what records a change.\n */\nimport { type IdeaAnchor, isVideoBlueprint, readIdeaAnchor, recordedChanges } from \"../../engine/creative-context/anchor.ts\";\nimport { ideaBaseline } from \"./idea-gate.ts\";\nimport { readRenderState, recordSeen } from \"./render-state.ts\";\nimport { type ShownSources, type ShownVersion, shownVersion } from \"./shown-version.ts\";\n\nexport async function shownBaseline(opts: {\n  canvasRoot: string;\n  slug: string;\n  creativeDir: string;\n  turnId: string | undefined;\n  /** The version shown, when the caller already read it. */\n  shown?: ShownVersion;\n  sources?: ShownSources;\n  /** Whether to keep what a new turn saw (a run); a validate only reads. */\n  record: boolean;\n}): Promise<{ baseline?: IdeaAnchor }> {\n  const state = await readRenderState(opts.canvasRoot, opts.slug);\n  const known = opts.turnId !== undefined && state.seen?.turnId === opts.turnId;\n  let fallback: IdeaAnchor | undefined;\n  if (!known && !state.anchor) {\n    const shown = opts.shown ?? (await shownVersion(opts.canvasRoot, opts.slug, opts.sources));\n    if (shown.rendered && shown.prompt !== undefined) {\n      // A video's voices live in its scenes and canvas: the run's own copies, never this workspace's\n      // edited ones; a run that kept no canvas leaves no baseline to hold the video to.\n      const video = typeof shown.prompt === \"object\" && shown.prompt !== null && isVideoBlueprint(shown.prompt as Record<string, unknown>);\n      const recorded = shown.video;\n      const unrecorded = video && (!recorded || recorded.canvas === null || recorded.canvas === undefined);\n      const anchor = unrecorded\n        ? undefined\n        : (await readIdeaAnchor(opts.creativeDir, { spec: shown.prompt, ...(video && recorded ? { recorded } : {}) }))?.anchor;\n      if (anchor) fallback = { ...anchor, changes: shown.definition ? recordedChanges(shown.definition) : [] };\n    }\n  }\n  const { baseline, seen } = ideaBaseline(state, opts.turnId, fallback);\n  if (seen && opts.record) await recordSeen(opts.canvasRoot, opts.slug, seen);\n  return baseline ? { baseline } : {};\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-ZCGM7ZWM.js

@@ -0,0 +1,45 @@
+import {
+  ANALYTICS_BUSY_FIX,
+  isAnalyticsBusy
+} from "./chunk-PILLZPNC.js";
+import {
+  ApiError
+} from "./chunk-LJEJCIHR.js";
+
+// src/commands/analytics/errorEnvelope.ts
+import { z } from "zod";
+function analyticsErrorEnvelope(err) {
+  if (err instanceof ApiError) {
+    return isAnalyticsBusy(err.message) ? { code: err.code, message: err.message, fix: ANALYTICS_BUSY_FIX } : { code: err.code, message: err.message };
+  }
+  return { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" };
+}
+function requestErrorEnvelope(err, correction, correctsLocalInput) {
+  if (err instanceof z.ZodError || err instanceof SyntaxError) {
+    const message = err instanceof z.ZodError ? z.prettifyError(err) : err.message;
+    return { code: "VALIDATION_ERROR", message, ...correctsLocalInput ? { fix: correction } : {} };
+  }
+  const envelope = analyticsErrorEnvelope(err);
+  return envelope.code === "VALIDATION_ERROR" ? { ...envelope, fix: correction } : envelope;
+}
+function questionnaireErrorEnvelope(err) {
+  return requestErrorEnvelope(
+    err,
+    "Check baker analytics plan --full for missing app events. Resolve the named contract issue or narrow the observation window; never infer abandonment from completion totals.",
+    false
+  );
+}
+function trackingPlanErrorEnvelope(err) {
+  return requestErrorEnvelope(
+    err,
+    "Read baker analytics plan --full and baker tag-manager draft list to see what is prepared. Correct the request and repeat; do not publish until every requested installation is staged.",
+    true
+  );
+}
+
+export {
+  analyticsErrorEnvelope,
+  questionnaireErrorEnvelope,
+  trackingPlanErrorEnvelope
+};
+//# sourceMappingURL=chunk-ZCGM7ZWM.js.map