@koda-sl/baker-cli 0.386.0-dev.4e118c09a → 0.386.0-dev.d6e55699d

package/dist/chunk-6I7SYEYN.js

@@ -0,0 +1,166 @@
+import {
+  HEADLINE_SET_FLOOR,
+  SAME_CLAIM_HELD,
+  TELL_QUESTIONS,
+  copySentences,
+  sameClaimQuestion,
+  tellQuestionsFor
+} from "./chunk-4NZ47VXO.js";
+import {
+  rememberedJev
+} from "./chunk-I3DIZWN5.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-AUSKKFVH.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-HDHWIEJJ.js";
+import {
+  CAPABILITY_SURFACE_SPECS
+} from "./chunk-UI6BKYQD.js";
+
+// src/commands/capabilities/fix.ts
+function capabilityFix(surface) {
+  const spec = CAPABILITY_SURFACE_SPECS[surface];
+  return {
+    action: `baker capabilities ${surface}`,
+    explanation: `Do not guess another field name. \`baker capabilities ${surface}\` lists every ${spec.label} change with its required and optional fields and the exact values each field accepts, plus what cannot be changed here at all and why. Read it, then either re-stage correctly or tell the user this part is out of reach \u2014 and carry on with the rest of the job either way.`
+  };
+}
+
+// src/commands/ads/boolean-word-positional.ts
+var BOOLEAN_WORD = /^(true|false)$/i;
+function booleanWordPositionalError(args, entity) {
+  const positionals = Array.isArray(args._) ? args._ : [];
+  const word = positionals.find((value2) => typeof value2 === "string" && BOOLEAN_WORD.test(value2));
+  if (word === void 0) {
+    return void 0;
+  }
+  const value = word.toLowerCase();
+  const raised = Object.keys(args).filter((key) => key !== "_" && args[key] === true);
+  const named = raised.length > 0 ? raised.map((flag) => `--${flag}`).join(" or ") : "a boolean flag";
+  const fix = raised.length > 0 ? raised.map((flag) => `--${flag}=${value}`).join(" or ") : `--<flag>=${value}`;
+  const negated = raised.length === 1 && value === "false" ? ` (or --no-${raised[0]})` : "";
+  return `"${word}" was read as the ${entity} target, not as a value for ${named}. A boolean flag written with a space is set to TRUE and the word is dropped \u2014 attach it instead: ${fix}${negated}.`;
+}
+
+// src/commands/ads/copy-hints.ts
+import path from "path";
+
+// src/engine/copy-tells/judge.ts
+var SAMPLE_MAX = 60;
+var sample = (text) => text.length <= SAMPLE_MAX ? text : `${text.slice(0, SAMPLE_MAX)}\u2026`;
+async function judgedCopyTells(input, ask) {
+  const sentences = input.texts.flatMap((t) => copySentences(t));
+  const pairs = (input.headlineSets ?? []).map((set) => set.map((h) => h.trim()).filter(Boolean)).filter((set) => set.length >= HEADLINE_SET_FLOOR).flatMap((set, s) => set.flatMap((a, i) => set.slice(i + 1).map((b) => ({ set: s, a, b }))));
+  const questions = [...sentences.flatMap(tellQuestionsFor), ...pairs.map(({ a, b }) => sameClaimQuestion(a, b))];
+  if (questions.length === 0) return [];
+  const answers = await ask(questions);
+  if (answers === null) return null;
+  const tells = [];
+  TELL_QUESTIONS.forEach((tell, t) => {
+    const hits = sentences.filter((_, s) => (answers[s * TELL_QUESTIONS.length + t] ?? 0) >= tell.threshold);
+    if (hits.length > 0) tells.push({ id: tell.id, count: hits.length, sample: sample(hits[0]?.text ?? "") });
+  });
+  const offset = sentences.length * TELL_QUESTIONS.length;
+  const cycled = pairs.filter((_, p) => (answers[offset + p] ?? 0) >= SAME_CLAIM_HELD);
+  for (const set of new Set(cycled.map((p) => p.set))) {
+    const inSet = cycled.filter((p) => p.set === set);
+    const { a, b } = inSet[0] ?? { a: "", b: "" };
+    tells.push({ id: "synonym-cycling", count: inSet.length, sample: sample(`"${a}" / "${b}"`) });
+  }
+  return tells;
+}
+
+// src/commands/ads/copy-hints.ts
+var COPY_KEYS = /* @__PURE__ */ new Set([
+  "headline",
+  "headlines",
+  "longheadline",
+  "longheadlines",
+  "shortheadline",
+  "shortheadlines",
+  "description",
+  "descriptions",
+  "primarytext",
+  "primarytexts",
+  "message",
+  "messages",
+  "commentary",
+  "body",
+  "bodies",
+  "text",
+  "calltoaction",
+  "linkdescription",
+  "sitelinktext",
+  "callout",
+  "callouts",
+  "introtext"
+]);
+var HEADLINE_SET_KEYS = /* @__PURE__ */ new Set(["headlines", "longheadlines", "shortheadlines"]);
+var MAX_HINTS = 5;
+var SYNONYM_PAIR_FLOOR = 2;
+function asStrings(value) {
+  const one = (v) => {
+    const text = typeof v === "string" ? v : v !== null && typeof v === "object" ? v.text : "";
+    return typeof text === "string" && text.trim() ? text : void 0;
+  };
+  const values = Array.isArray(value) ? value : [value];
+  return values.map(one).filter((v) => v !== void 0);
+}
+function collectCopy(value, depth = 0) {
+  const texts = [];
+  const headlineSets = [];
+  if (depth > 4 || value === null || typeof value !== "object") return { texts, headlineSets };
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      const nested = collectCopy(item, depth + 1);
+      texts.push(...nested.texts);
+      headlineSets.push(...nested.headlineSets);
+    }
+    return { texts, headlineSets };
+  }
+  for (const [key, raw] of Object.entries(value)) {
+    const normalized = key.toLowerCase().replace(/[_-]/g, "");
+    const strings = COPY_KEYS.has(normalized) ? asStrings(raw) : [];
+    if (strings.length > 0) {
+      texts.push(...strings);
+      if (HEADLINE_SET_KEYS.has(normalized) && strings.length > 1) headlineSets.push(strings);
+      continue;
+    }
+    const nested = collectCopy(raw, depth + 1);
+    texts.push(...nested.texts);
+    headlineSets.push(...nested.headlineSets);
+  }
+  return { texts, headlineSets };
+}
+function hintFor(tell) {
+  if (tell.id === "synonym-cycling") {
+    return `AI COPY TELL \u2014 ${tell.count} headline pairs are the same claim reworded (${tell.sample}). A cycled set gives the auction nothing to choose between: make each headline a different claim, not a different verb.`;
+  }
+  return `AI COPY TELL (${tell.id}) \u2014 "${tell.sample}". This construction reads as machine-written; rewrite it as a plain, specific claim before publishing.`;
+}
+async function adCopyHints(payload, ask) {
+  const { texts, headlineSets } = collectCopy(payload);
+  if (texts.length === 0) return [];
+  const cacheDir = path.join(findWorkspaceRoot(process.cwd()) ?? process.cwd(), "canvas", ".cache");
+  const spent = [];
+  const judged = await judgedCopyTells(
+    { texts: texts.flatMap((t) => t.split("\n")), headlineSets },
+    ask ?? rememberedJev(path.join(cacheDir, "copy-tells.json"), (u) => spent.push(u))
+  ).catch(() => null);
+  await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
+  const cycled = (judged ?? []).filter((t) => t.id === "synonym-cycling" && t.count >= SYNONYM_PAIR_FLOOR).sort((a, b) => b.count - a.count).slice(0, 1);
+  const tells = [...cycled, ...(judged ?? []).filter((t) => t.id !== "synonym-cycling")];
+  tells.sort(
+    (a, b) => (b.id === "synonym-cycling" ? 1 : 0) - (a.id === "synonym-cycling" ? 1 : 0) || b.count - a.count
+  );
+  return tells.slice(0, MAX_HINTS).map(hintFor);
+}
+
+export {
+  capabilityFix,
+  booleanWordPositionalError,
+  adCopyHints
+};
+//# sourceMappingURL=chunk-6I7SYEYN.js.map

package/dist/chunk-6I7SYEYN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/capabilities/fix.ts","../src/commands/ads/boolean-word-positional.ts","../src/commands/ads/copy-hints.ts","../src/engine/copy-tells/judge.ts"],"sourcesContent":["import type { CapabilitySurfaceId } from \"@baker/api/capabilities\";\nimport { CAPABILITY_SURFACE_SPECS } from \"@baker/api/capabilities\";\n\n/**\n * A rejected change should say where the real contract is.\n *\n * The expensive version of \"this field is not valid\" is an agent trying four\n * spellings of a field that never existed, staging a bogus op, and cleaning it\n * up again — several turns, none of them work. The validation message already\n * names what was wrong with THIS attempt; this names the one call that lists\n * every field the change accepts and every value each one takes, so the next\n * attempt is informed rather than another guess.\n */\nexport function capabilityFix(surface: CapabilitySurfaceId): { action: string; explanation: string } {\n  const spec = CAPABILITY_SURFACE_SPECS[surface];\n  return {\n    action: `baker capabilities ${surface}`,\n    explanation:\n      `Do not guess another field name. \\`baker capabilities ${surface}\\` lists every ${spec.label} change with its ` +\n      \"required and optional fields and the exact values each field accepts, plus what cannot be changed here at all \" +\n      \"and why. Read it, then either re-stage correctly or tell the user this part is out of reach — and carry on \" +\n      \"with the rest of the job either way.\",\n  };\n}\n","/**\n * `--flag false` — the natural way to type a negation — is a citty trap, not a typo we can honour:\n * a boolean flag written with a space parses as the flag set to **TRUE** plus a stray positional\n * nobody consumes. The word does the OPPOSITE of what was typed and nothing fails, because the\n * target still resolves and the command still reports \"staged\". No layer downstream can catch it —\n * an inverted boolean is a valid op — so it has to be caught where the positionals are read.\n *\n * This is the same rule on every ad surface (it is citty's parse, not a platform's), but each\n * surface owns its own error envelope, so this returns the message and the caller fails with it.\n */\n\nconst BOOLEAN_WORD = /^(true|false)$/i;\n\n/**\n * The refusal message for a bare `true`/`false` sitting in the positionals, or `undefined` when\n * there is none. `entity` is the surface's own noun for what the positional addresses (\"campaign\",\n * \"ad set\", …), so the message reads as that command's vocabulary.\n */\nexport function booleanWordPositionalError(args: Record<string, unknown>, entity: string): string | undefined {\n  const positionals = Array.isArray(args._) ? args._ : [];\n  const word = positionals.find((value): value is string => typeof value === \"string\" && BOOLEAN_WORD.test(value));\n  if (word === undefined) {\n    return undefined;\n  }\n  const value = word.toLowerCase();\n  // Every flag citty just set to true, so the fix is copy-pasteable. Which one the word was meant for\n  // is unknowable from parsed args — it need not even follow that flag on the command line — so with\n  // several raised we list them all rather than inventing a single culprit the user never typed.\n  const raised = Object.keys(args).filter((key) => key !== \"_\" && args[key] === true);\n  const named = raised.length > 0 ? raised.map((flag) => `--${flag}`).join(\" or \") : \"a boolean flag\";\n  const fix = raised.length > 0 ? raised.map((flag) => `--${flag}=${value}`).join(\" or \") : `--<flag>=${value}`;\n  const negated = raised.length === 1 && value === \"false\" ? ` (or --no-${raised[0]})` : \"\";\n  return `\"${word}\" was read as the ${entity} target, not as a value for ${named}. A boolean flag written with a space is set to TRUE and the word is dropped — attach it instead: ${fix}${negated}.`;\n}\n","/**\n * AI copy tells on staged ad copy → `hints[]`.\n *\n * Ad text is the surface where a tell costs real money and the one place we had\n * no copy check at all: staging validated character limits and policy, never\n * whether the words read like a model wrote them.\n *\n * ADVISORY BY CONSTRUCTION. These are hints, never errors — an ad refused over a\n * fallible prose heuristic costs more than a tell that ships, and the agent can\n * act on a hint in the same turn. Nothing here can fail a staged write.\n *\n * Thresholds differ from the landing gate on purpose. A landing needs a CLUSTER\n * before a tell means anything (`COPY_TELL_GATES`); a 30-character headline has\n * no room for a cluster, so one occurrence is the signal. The exclusion list\n * below is where most of the judgment lives.\n *\n * The tells that read the words are asked of the decision model, in whatever\n * language the ad is written; when it cannot answer, nothing is reported rather\n * than a guess.\n */\n\nimport path from \"node:path\";\nimport type { CopyTell } from \"../../engine/copy-tells/detect.ts\";\nimport { judgedCopyTells } from \"../../engine/copy-tells/judge.ts\";\nimport { type AskNouls, rememberedJev } from \"../../engine/lib/remembered-nouls.ts\";\nimport type { ReviewUsage } from \"../../engine/nodes/local/lib/render-review.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { holdUnbilledSpend } from \"../canvas/unbilled-spend.ts\";\n\n/*\n * The tells that are a shape (`structuralCopyTells`) do not apply to ad copy, and\n * none is hinted. Each is a real convention in this medium, so reporting it would\n * train the agent to ignore hints:\n *   - `title-case-heading` — English search ads are conventionally Title Case.\n *   - `staccato-drama` — \"Compara. Ahorra. Cambia.\" is ad rhythm, not drama.\n *   - `emoji` — deliberate and effective in Meta and LinkedIn primary text.\n *   - `curly-quote` — inserted automatically by every editor copy is pasted from.\n *   - `inline-header-list` — a markdown shape that ad fields cannot hold.\n */\n\n/**\n * Payload keys whose values are copy a human will read in the ad. Every platform\n * names its primary text differently in `@baker/api` — Meta stages it as\n * `message`, LinkedIn as `commentary` — so the concept appears here under each\n * of its contract names, not under one invented one.\n */\nconst COPY_KEYS = new Set([\n  \"headline\",\n  \"headlines\",\n  \"longheadline\",\n  \"longheadlines\",\n  \"shortheadline\",\n  \"shortheadlines\",\n  \"description\",\n  \"descriptions\",\n  \"primarytext\",\n  \"primarytexts\",\n  \"message\",\n  \"messages\",\n  \"commentary\",\n  \"body\",\n  \"bodies\",\n  \"text\",\n  \"calltoaction\",\n  \"linkdescription\",\n  \"sitelinktext\",\n  \"callout\",\n  \"callouts\",\n  \"introtext\",\n]);\n\n/** Keys holding a SET of headlines, where synonym cycling is meaningful. */\nconst HEADLINE_SET_KEYS = new Set([\"headlines\", \"longheadlines\", \"shortheadlines\"]);\n\n/**\n * At most this many hints, so copy advice never crowds out the staging result.\n *\n * Five, not three: a heavily model-written ad routinely carries six tells, and a\n * cap of three showed the agent half the diagnosis. Since it already has the copy\n * in front of it, fixing six constructions in one pass is cheaper than three\n * re-stagings that each reveal the next batch.\n */\nconst MAX_HINTS = 5;\n/** Two near-duplicate pairs; one pair in a 15-headline RSA is not a pattern. */\nconst SYNONYM_PAIR_FLOOR = 2;\n\n/**\n * The copy under a copy key, whether it is a plain string or a Google text\n * asset. Google stages EVERY ad text as `{ text, pinnedField? }`\n * (`adTextAssetSchema` in `@baker/api/ads-google`), so reading only strings here\n * would skip the whole Google surface — headlines, descriptions, long headline.\n */\nfunction asStrings(value: unknown): string[] {\n  const one = (v: unknown): string | undefined => {\n    const text = typeof v === \"string\" ? v : v !== null && typeof v === \"object\" ? (v as { text?: unknown }).text : \"\";\n    return typeof text === \"string\" && text.trim() ? text : undefined;\n  };\n  const values = Array.isArray(value) ? value : [value];\n  return values.map(one).filter((v): v is string => v !== undefined);\n}\n\n/** Walk a staged-op payload of unknown shape and pull out the human-readable\n * copy fields plus any headline sets. Depth-limited — payloads are shallow, and\n * an unbounded walk on a hostile shape is a hang, not a hint. */\nfunction collectCopy(value: unknown, depth = 0): { texts: string[]; headlineSets: string[][] } {\n  const texts: string[] = [];\n  const headlineSets: string[][] = [];\n  if (depth > 4 || value === null || typeof value !== \"object\") return { texts, headlineSets };\n\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      const nested = collectCopy(item, depth + 1);\n      texts.push(...nested.texts);\n      headlineSets.push(...nested.headlineSets);\n    }\n    return { texts, headlineSets };\n  }\n\n  for (const [key, raw] of Object.entries(value as Record<string, unknown>)) {\n    const normalized = key.toLowerCase().replace(/[_-]/g, \"\");\n    const strings = COPY_KEYS.has(normalized) ? asStrings(raw) : [];\n    if (strings.length > 0) {\n      texts.push(...strings);\n      if (HEADLINE_SET_KEYS.has(normalized) && strings.length > 1) headlineSets.push(strings);\n      continue;\n    }\n    // A copy key holding neither a string nor a text asset (`call_to_action`)\n    // still gets walked — a matched key must never swallow the subtree.\n    const nested = collectCopy(raw, depth + 1);\n    texts.push(...nested.texts);\n    headlineSets.push(...nested.headlineSets);\n  }\n  return { texts, headlineSets };\n}\n\nfunction hintFor(tell: CopyTell): string {\n  if (tell.id === \"synonym-cycling\") {\n    return `AI COPY TELL — ${tell.count} headline pairs are the same claim reworded (${tell.sample}). A cycled set gives the auction nothing to choose between: make each headline a different claim, not a different verb.`;\n  }\n  return `AI COPY TELL (${tell.id}) — \"${tell.sample}\". This construction reads as machine-written; rewrite it as a plain, specific claim before publishing.`;\n}\n\n/**\n * Inspect a staged ad-copy payload and return advisory hints about AI writing\n * tells. Never throws; returns `[]` when the copy reads clean or the payload\n * carries no copy at all. `ask` is the decision model (the real one, its answers\n * kept in the workspace's canvas cache and its spend billed with the next run,\n * unless given).\n */\nexport async function adCopyHints(payload: unknown, ask?: AskNouls): Promise<string[]> {\n  const { texts, headlineSets } = collectCopy(payload);\n  if (texts.length === 0) return [];\n\n  const cacheDir = path.join(findWorkspaceRoot(process.cwd()) ?? process.cwd(), \"canvas\", \".cache\");\n  const spent: ReviewUsage[] = [];\n  // A line break in ad text is the author's, never a wrap: each line is read on its own.\n  const judged = await judgedCopyTells(\n    { texts: texts.flatMap((t) => t.split(\"\\n\")), headlineSets },\n    ask ?? rememberedJev(path.join(cacheDir, \"copy-tells.json\"), (u) => spent.push(u)),\n  ).catch(() => null);\n  await holdUnbilledSpend(cacheDir, spent).catch(() => undefined);\n\n  // The floor is per headline set (one per ad); only the most cycled set is hinted.\n  const cycled = (judged ?? [])\n    .filter((t) => t.id === \"synonym-cycling\" && t.count >= SYNONYM_PAIR_FLOOR)\n    .sort((a, b) => b.count - a.count)\n    .slice(0, 1);\n  const tells: CopyTell[] = [...cycled, ...(judged ?? []).filter((t) => t.id !== \"synonym-cycling\")];\n\n  // Loudest first: the cycled-headline finding is a set-level defect, and the\n  // rest sort by how often the tell fired.\n  tells.sort(\n    (a, b) => (b.id === \"synonym-cycling\" ? 1 : 0) - (a.id === \"synonym-cycling\" ? 1 : 0) || b.count - a.count,\n  );\n  return tells.slice(0, MAX_HINTS).map(hintFor);\n}\n","/**\n * The AI copy tells in a piece of copy that are a reading of its words, and synonym cycling in a\n * set of headlines, asked of the decision model (Jev) in one fanned-out set of requests, in\n * whatever language the copy is written. Raw counts, like `structuralCopyTells`: the caller gates.\n */\nimport type { AskNouls } from \"../lib/remembered-nouls.ts\";\nimport type { CopyTell } from \"./detect.ts\";\nimport { HEADLINE_SET_FLOOR } from \"./patterns.ts\";\nimport { SAME_CLAIM_HELD, sameClaimQuestion, TELL_QUESTIONS, tellQuestionsFor } from \"./questions.ts\";\nimport { copySentences } from \"./sentences.ts\";\n\nconst SAMPLE_MAX = 60;\nconst sample = (text: string) => (text.length <= SAMPLE_MAX ? text : `${text.slice(0, SAMPLE_MAX)}…`);\n\n/**\n * Every judged tell in `texts` (one count per sentence that carries it) and, for each headline set\n * of at least `HEADLINE_SET_FLOOR`, one `synonym-cycling` tell counting that set's pairs that are\n * one claim reworded. Null when the model could not answer: the caller reports nothing rather than\n * guess.\n */\nexport async function judgedCopyTells(\n  input: { texts: readonly string[]; headlineSets?: ReadonlyArray<readonly string[]> },\n  ask: AskNouls,\n): Promise<CopyTell[] | null> {\n  const sentences = input.texts.flatMap((t) => copySentences(t));\n  const pairs = (input.headlineSets ?? [])\n    .map((set) => set.map((h) => h.trim()).filter(Boolean))\n    .filter((set) => set.length >= HEADLINE_SET_FLOOR)\n    .flatMap((set, s) => set.flatMap((a, i) => set.slice(i + 1).map((b) => ({ set: s, a, b }))));\n  const questions = [...sentences.flatMap(tellQuestionsFor), ...pairs.map(({ a, b }) => sameClaimQuestion(a, b))];\n  if (questions.length === 0) return [];\n  const answers = await ask(questions);\n  if (answers === null) return null;\n\n  const tells: CopyTell[] = [];\n  TELL_QUESTIONS.forEach((tell, t) => {\n    const hits = sentences.filter((_, s) => (answers[s * TELL_QUESTIONS.length + t] ?? 0) >= tell.threshold);\n    if (hits.length > 0) tells.push({ id: tell.id, count: hits.length, sample: sample(hits[0]?.text ?? \"\") });\n  });\n  const offset = sentences.length * TELL_QUESTIONS.length;\n  const cycled = pairs.filter((_, p) => (answers[offset + p] ?? 0) >= SAME_CLAIM_HELD);\n  for (const set of new Set(cycled.map((p) => p.set))) {\n    const inSet = cycled.filter((p) => p.set === set);\n    const { a, b } = inSet[0] ?? { a: \"\", b: \"\" };\n    tells.push({ id: \"synonym-cycling\", count: inSet.length, sample: sample(`\"${a}\" / \"${b}\"`) });\n  }\n  return tells;\n}\n"],"mappings":"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","names":["value"]}

package/dist/chunk-6O7ISBC7.js

@@ -0,0 +1,65 @@
+import {
+  applyFieldMask,
+  compactWinningAd,
+  fullWinningAd,
+  winningAdNormalizer,
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+
+// src/commands/winning-ads/adRows.ts
+var EVERY_SIGNAL = {
+  dna: {
+    visual: "-",
+    container: "-",
+    mechanism: "-",
+    audience_temperature: "-",
+    funnel_stage: "-",
+    advertiser_size: "-",
+    presumes_brand_knowledge: true,
+    brand_knowledge_reason: "-"
+  },
+  baker_uses: { companies: 1, ours: true, approved: 1, rejected: 1 },
+  source: "followed",
+  stage: "-",
+  survived_test: true
+};
+var COMPACT_FIELDS = new Set(Object.keys(compactWinningAd(EVERY_SIGNAL)));
+var ALL_FIELDS = Object.keys(fullWinningAd(EVERY_SIGNAL));
+function adFields(requested, full) {
+  if (!requested) return { fields: void 0, full };
+  const fields = requested.map((f) => f.trim()).filter(Boolean);
+  const invalid = fields.filter((f) => !ALL_FIELDS.includes(f));
+  if (invalid.length > 0) return { invalid, valid: ALL_FIELDS };
+  return { fields, full: full || fields.some((f) => !COMPACT_FIELDS.has(f)) };
+}
+function adFieldPlan(fields, full) {
+  const plan = adFields(fields ? String(fields).split(",") : void 0, Boolean(full));
+  if (!("invalid" in plan)) return plan;
+  writeJson({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: `Unknown --fields: ${plan.invalid.join(", ")}`,
+      fix: {
+        action: "retry_with_valid_values",
+        explanation: "Pass only fields an ad row carries.",
+        flag: "--fields",
+        invalidValues: plan.invalid,
+        validValues: plan.valid
+      }
+    }
+  });
+  process.exit(1);
+}
+function adRows(raw, plan) {
+  return raw.map((r) => {
+    const row = winningAdNormalizer(r, plan.full);
+    return plan.fields ? applyFieldMask(row, plan.fields) : row;
+  });
+}
+
+export {
+  adFieldPlan,
+  adRows
+};
+//# sourceMappingURL=chunk-6O7ISBC7.js.map

package/dist/chunk-6O7ISBC7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/adRows.ts"],"sourcesContent":["import { applyFieldMask, compactWinningAd, fullWinningAd, winningAdNormalizer, writeJson } from \"../../output.ts\";\n\n/**\n * The rows `search`, `feed`, `winners` and `ads` print: one ad each, compact\n * unless `--full`, cut to `--fields` in every output. Before, the JSON a\n * `feed`, `winners` or `ads` call prints ignored `--fields`, so an agent that\n * asked for three columns still read every row whole.\n */\n\nexport type AdFieldPlan = { fields: string[] | undefined; full: boolean };\n\n// A row with every optional signal set: its keys are every field an ad row can carry.\nconst EVERY_SIGNAL: Record<string, unknown> = {\n  dna: {\n    visual: \"-\",\n    container: \"-\",\n    mechanism: \"-\",\n    audience_temperature: \"-\",\n    funnel_stage: \"-\",\n    advertiser_size: \"-\",\n    presumes_brand_knowledge: true,\n    brand_knowledge_reason: \"-\",\n  },\n  baker_uses: { companies: 1, ours: true, approved: 1, rejected: 1 },\n  source: \"followed\",\n  stage: \"-\",\n  survived_test: true,\n};\nconst COMPACT_FIELDS = new Set(Object.keys(compactWinningAd(EVERY_SIGNAL)));\nconst ALL_FIELDS = Object.keys(fullWinningAd(EVERY_SIGNAL));\n\n/**\n * The `--fields` asked for, read the way an agent types them: names trimmed,\n * the full row when a name only `--full` carries is asked for, and a name no\n * row carries refused with the ones that exist. Before, each of those printed\n * an empty column.\n */\nexport function adFields(\n  requested: string[] | undefined,\n  full: boolean,\n): AdFieldPlan | { invalid: string[]; valid: string[] } {\n  if (!requested) return { fields: undefined, full };\n  const fields = requested.map((f) => f.trim()).filter(Boolean);\n  const invalid = fields.filter((f) => !ALL_FIELDS.includes(f));\n  if (invalid.length > 0) return { invalid, valid: ALL_FIELDS };\n  return { fields, full: full || fields.some((f) => !COMPACT_FIELDS.has(f)) };\n}\n\n/** The `--fields` plan of a command, or the refusal of a name no row carries (exits). */\nexport function adFieldPlan(fields: unknown, full: unknown): AdFieldPlan {\n  const plan = adFields(fields ? String(fields).split(\",\") : undefined, Boolean(full));\n  if (!(\"invalid\" in plan)) return plan;\n  writeJson({\n    ok: false,\n    error: {\n      code: \"VALIDATION_ERROR\",\n      message: `Unknown --fields: ${plan.invalid.join(\", \")}`,\n      fix: {\n        action: \"retry_with_valid_values\",\n        explanation: \"Pass only fields an ad row carries.\",\n        flag: \"--fields\",\n        invalidValues: plan.invalid,\n        validValues: plan.valid,\n      },\n    },\n  });\n  process.exit(1);\n}\n\nexport function adRows(raw: readonly unknown[], plan: AdFieldPlan): Record<string, unknown>[] {\n  return raw.map((r) => {\n    const row = winningAdNormalizer(r as Record<string, unknown>, plan.full);\n    return plan.fields ? applyFieldMask(row, plan.fields) : row;\n  });\n}\n"],"mappings":";;;;;;;;;AAYA,IAAM,eAAwC;AAAA,EAC5C,KAAK;AAAA,IACH,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX,sBAAsB;AAAA,IACtB,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,0BAA0B;AAAA,IAC1B,wBAAwB;AAAA,EAC1B;AAAA,EACA,YAAY,EAAE,WAAW,GAAG,MAAM,MAAM,UAAU,GAAG,UAAU,EAAE;AAAA,EACjE,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,eAAe;AACjB;AACA,IAAM,iBAAiB,IAAI,IAAI,OAAO,KAAK,iBAAiB,YAAY,CAAC,CAAC;AAC1E,IAAM,aAAa,OAAO,KAAK,cAAc,YAAY,CAAC;AAQnD,SAAS,SACd,WACA,MACsD;AACtD,MAAI,CAAC,UAAW,QAAO,EAAE,QAAQ,QAAW,KAAK;AACjD,QAAM,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,OAAO;AAC5D,QAAM,UAAU,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,SAAS,CAAC,CAAC;AAC5D,MAAI,QAAQ,SAAS,EAAG,QAAO,EAAE,SAAS,OAAO,WAAW;AAC5D,SAAO,EAAE,QAAQ,MAAM,QAAQ,OAAO,KAAK,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC,EAAE;AAC5E;AAGO,SAAS,YAAY,QAAiB,MAA4B;AACvE,QAAM,OAAO,SAAS,SAAS,OAAO,MAAM,EAAE,MAAM,GAAG,IAAI,QAAW,QAAQ,IAAI,CAAC;AACnF,MAAI,EAAE,aAAa,MAAO,QAAO;AACjC,YAAU;AAAA,IACR,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS,qBAAqB,KAAK,QAAQ,KAAK,IAAI,CAAC;AAAA,MACrD,KAAK;AAAA,QACH,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,MAAM;AAAA,QACN,eAAe,KAAK;AAAA,QACpB,aAAa,KAAK;AAAA,MACpB;AAAA,IACF;AAAA,EACF,CAAC;AACD,UAAQ,KAAK,CAAC;AAChB;AAEO,SAAS,OAAO,KAAyB,MAA8C;AAC5F,SAAO,IAAI,IAAI,CAAC,MAAM;AACpB,UAAM,MAAM,oBAAoB,GAA8B,KAAK,IAAI;AACvE,WAAO,KAAK,SAAS,eAAe,KAAK,KAAK,MAAM,IAAI;AAAA,EAC1D,CAAC;AACH;","names":[]}

package/dist/chunk-752S7JF6.js

@@ -0,0 +1,35 @@
+import {
+  ApiError
+} from "./chunk-HREWXNTO.js";
+import {
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+
+// src/commands/winning-ads/shared.ts
+function splitList(value) {
+  if (!value) {
+    return [];
+  }
+  return value.split(",").map((v) => v.trim()).filter(Boolean);
+}
+function reportError(err) {
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var PLATFORM_NAMES = {
+  meta: "Meta",
+  linkedin: "LinkedIn",
+  tiktok: "TikTok",
+  google: "Google Ads"
+};
+
+export {
+  splitList,
+  reportError,
+  PLATFORM_NAMES
+};
+//# sourceMappingURL=chunk-752S7JF6.js.map

package/dist/chunk-752S7JF6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/shared.ts"],"sourcesContent":["import type { AdLibraryPlatform } from \"@baker/api/ad-library\";\nimport { ApiError } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\n\n/** Split a comma list into trimmed, non-empty tokens. */\nexport function splitList(value: string | undefined): string[] {\n  if (!value) {\n    return [];\n  }\n  return value\n    .split(\",\")\n    .map((v) => v.trim())\n    .filter(Boolean);\n}\n\n/** Emit the `{ ok: false, error }` envelope and exit non-zero. */\nexport function reportError(err: unknown): never {\n  if (err instanceof ApiError) {\n    writeJson({ ok: false, error: { code: err.code, message: err.message } });\n    process.exit(1);\n  }\n  writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n\n/** Each platform as people name it, for hints. */\nexport const PLATFORM_NAMES: Record<AdLibraryPlatform, string> = {\n  meta: \"Meta\",\n  linkedin: \"LinkedIn\",\n  tiktok: \"TikTok\",\n  google: \"Google Ads\",\n};\n"],"mappings":";;;;;;;;AAKO,SAAS,UAAU,OAAqC;AAC7D,MAAI,CAAC,OAAO;AACV,WAAO,CAAC;AAAA,EACV;AACA,SAAO,MACJ,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AACnB;AAGO,SAAS,YAAY,KAAqB;AAC/C,MAAI,eAAe,UAAU;AAC3B,cAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,YAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,mBAAmB,EAAE,CAAC;AACvF,UAAQ,KAAK,CAAC;AAChB;AAGO,IAAM,iBAAoD;AAAA,EAC/D,MAAM;AAAA,EACN,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,QAAQ;AACV;","names":[]}

package/dist/chunk-AFJGYJ7Z.js

@@ -0,0 +1,45 @@
+import {
+  ANALYTICS_BUSY_FIX,
+  isAnalyticsBusy
+} from "./chunk-FYWWTMXP.js";
+import {
+  ApiError
+} from "./chunk-HREWXNTO.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-AFJGYJ7Z.js.map

package/dist/chunk-AFJGYJ7Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/analytics/errorEnvelope.ts"],"sourcesContent":["import { ANALYTICS_BUSY_FIX, isAnalyticsBusy } from \"@baker/api/analytics\";\nimport { z } from \"zod\";\nimport { ApiError, type ErrorCode } from \"../../client.ts\";\n\n/**\n * A failed analytics read, as the agent reads it.\n *\n * Separate from `handleError` — which writes it and exits — so the one decision\n * in it can be checked without a process to kill.\n *\n * ## The one decision\n *\n * Whether the failure is worth stopping for. Almost all of them are: a bad\n * preset, an unmapped role, a window outside retention. One is not — the store\n * refusing a read because a burst spent its per-minute compute allowance. That\n * refusal clears in seconds, loses nothing, and is answered correctly by\n * waiting; an agent that treats it like the others abandons a multi-step report\n * over a hiccup, which is the expensive outcome and the reason this carries a\n * `fix` at all.\n */\nexport function analyticsErrorEnvelope(err: unknown): { code: ErrorCode; message: string; fix?: string } {\n  if (err instanceof ApiError) {\n    return isAnalyticsBusy(err.message)\n      ? { code: err.code, message: err.message, fix: ANALYTICS_BUSY_FIX }\n      : { code: err.code, message: err.message };\n  }\n  return { code: \"NETWORK_ERROR\", message: err instanceof Error ? err.message : \"Unexpected error\" };\n}\n\ntype CommandErrorEnvelope = { code: ErrorCode; message: string; fix?: string };\n\n/**\n * A refused request, with `fix` only where it applies: a rejected request gets\n * the command's correction, and anything else (busy, unavailable, unreachable)\n * keeps its own code, so an agent waits rather than rewriting a valid request.\n */\nfunction requestErrorEnvelope(err: unknown, correction: string, correctsLocalInput: boolean): CommandErrorEnvelope {\n  if (err instanceof z.ZodError || err instanceof SyntaxError) {\n    const message = err instanceof z.ZodError ? z.prettifyError(err) : err.message;\n    return { code: \"VALIDATION_ERROR\", message, ...(correctsLocalInput ? { fix: correction } : {}) };\n  }\n  const envelope = analyticsErrorEnvelope(err);\n  return envelope.code === \"VALIDATION_ERROR\" ? { ...envelope, fix: correction } : envelope;\n}\n\n/** A failed question report: the contract remedy only when the events themselves were refused. */\nexport function questionnaireErrorEnvelope(err: unknown): CommandErrorEnvelope {\n  return requestErrorEnvelope(\n    err,\n    \"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.\",\n    false,\n  );\n}\n\n/** A failed plan read or preparation. */\nexport function trackingPlanErrorEnvelope(err: unknown): CommandErrorEnvelope {\n  return requestErrorEnvelope(\n    err,\n    \"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.\",\n    true,\n  );\n}\n"],"mappings":";;;;;;;;;AACA,SAAS,SAAS;AAmBX,SAAS,uBAAuB,KAAkE;AACvG,MAAI,eAAe,UAAU;AAC3B,WAAO,gBAAgB,IAAI,OAAO,IAC9B,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,SAAS,KAAK,mBAAmB,IAChE,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ;AAAA,EAC7C;AACA,SAAO,EAAE,MAAM,iBAAiB,SAAS,eAAe,QAAQ,IAAI,UAAU,mBAAmB;AACnG;AASA,SAAS,qBAAqB,KAAc,YAAoB,oBAAmD;AACjH,MAAI,eAAe,EAAE,YAAY,eAAe,aAAa;AAC3D,UAAM,UAAU,eAAe,EAAE,WAAW,EAAE,cAAc,GAAG,IAAI,IAAI;AACvE,WAAO,EAAE,MAAM,oBAAoB,SAAS,GAAI,qBAAqB,EAAE,KAAK,WAAW,IAAI,CAAC,EAAG;AAAA,EACjG;AACA,QAAM,WAAW,uBAAuB,GAAG;AAC3C,SAAO,SAAS,SAAS,qBAAqB,EAAE,GAAG,UAAU,KAAK,WAAW,IAAI;AACnF;AAGO,SAAS,2BAA2B,KAAoC;AAC7E,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAGO,SAAS,0BAA0B,KAAoC;AAC5E,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-AR7PU7BB.js

@@ -0,0 +1,76 @@
+import {
+  MODEL_REGISTRY,
+  isRegisteredModel
+} from "./chunk-CAMX6OHF.js";
+
+// src/commands/canvas/scaffold-common.ts
+import { access, readFile } from "fs/promises";
+
+// src/commands/canvas/composition-path.ts
+import { existsSync } from "fs";
+import path from "path";
+function resolveShippedCanvasDir(name, startDir, exists = existsSync, maxDepth = 8) {
+  const rel = path.join("canvas", name);
+  let dir = startDir;
+  for (let i = 0; i < maxDepth; i++) {
+    const candidate = path.join(dir, rel);
+    if (exists(path.join(candidate, "meta.json"))) return candidate;
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return path.resolve(startDir, "../../../", rel);
+}
+
+// src/commands/canvas/scaffold-common.ts
+var SHIPPED_OVERLAY_COMPOSITION_DIR = resolveShippedCanvasDir(
+  "video-overlay-composition",
+  import.meta.dirname
+);
+var SHIPPED_CAPTIONS_DIR = resolveShippedCanvasDir("tiktok-captions-composition", import.meta.dirname);
+function resolveModel(kind, requested, fallback) {
+  const model = requested ? String(requested) : fallback;
+  if (isRegisteredModel(kind, model)) return model;
+  const known = Object.keys(MODEL_REGISTRY[kind]).join(", ");
+  throw new Error(`"${model}" is not a ${kind} model. Use one of: ${known}`);
+}
+async function loadAssetText(ref, label) {
+  const r = ref;
+  if (typeof r?.path === "string") return readFile(r.path, "utf8");
+  if (typeof r?.url === "string") {
+    const res = await fetch(r.url);
+    if (!res.ok) throw new Error(`failed to fetch ${label} (${res.status})`);
+    return res.text();
+  }
+  throw new Error(`${label}: output had no readable path or url`);
+}
+function parseElements(raw) {
+  const parsed = JSON.parse(raw);
+  if (Array.isArray(parsed)) return parsed;
+  if (parsed && typeof parsed === "object" && Array.isArray(parsed.elements)) {
+    return parsed.elements;
+  }
+  return [];
+}
+function fail(code, message, fix) {
+  process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message, ...fix ? { fix } : {} } }, null, 2)}
+`);
+  process.exit(2);
+}
+function fileExists(target) {
+  return access(target).then(
+    () => true,
+    () => false
+  );
+}
+
+export {
+  SHIPPED_OVERLAY_COMPOSITION_DIR,
+  SHIPPED_CAPTIONS_DIR,
+  resolveModel,
+  loadAssetText,
+  parseElements,
+  fail,
+  fileExists
+};
+//# sourceMappingURL=chunk-AR7PU7BB.js.map

package/dist/chunk-AR7PU7BB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/scaffold-common.ts","../src/commands/canvas/composition-path.ts"],"sourcesContent":["// What the three scaffold commands (`scaffold-video`, `scaffold-static-ad`,\n// `scaffold-ad`) share: the compositions they ship, how a model flag resolves, and\n// how an analysis pass's output is read back.\n\nimport { access, readFile } from \"node:fs/promises\";\nimport { isRegisteredModel, MODEL_REGISTRY, type NodeKind } from \"@baker/canvas-contract\";\nimport { resolveShippedCanvasDir } from \"./composition-path.ts\";\n\n// The composition templates that ship with the CLI, resolved by walking up to the\n// package's `canvas/` dir so they work in both the dev (tsx) and bundled dist layout.\n/** The ad's text and brand overlay. */\nexport const SHIPPED_OVERLAY_COMPOSITION_DIR = resolveShippedCanvasDir(\n  \"video-overlay-composition\",\n  import.meta.dirname,\n);\n/** The TikTok-style word-by-word caption track (sound-off feeds). */\nexport const SHIPPED_CAPTIONS_DIR = resolveShippedCanvasDir(\"tiktok-captions-composition\", import.meta.dirname);\n\n/**\n * The model a scaffold node runs on: the one the caller named, else the role default.\n *\n * Either must be registered for `kind`, and an unknown one is an error naming what\n * the registry does have. This used to fall back to the registry's first id, so a\n * typo in a model flag rendered every node on a model nobody chose.\n */\nexport function resolveModel(kind: NodeKind, requested: unknown, fallback: string): string {\n  const model = requested ? String(requested) : fallback;\n  if (isRegisteredModel(kind, model)) return model;\n  const known = Object.keys(MODEL_REGISTRY[kind]).join(\", \");\n  throw new Error(`\"${model}\" is not a ${kind} model. Use one of: ${known}`);\n}\n\ntype LoadableRef = { path?: unknown; url?: unknown };\n\n/** Read an asset's content as text: the locally-ingested file first, else its URL. */\nexport async function loadAssetText(ref: unknown, label: string): Promise<string> {\n  const r = ref as LoadableRef;\n  if (typeof r?.path === \"string\") return readFile(r.path, \"utf8\");\n  if (typeof r?.url === \"string\") {\n    const res = await fetch(r.url);\n    if (!res.ok) throw new Error(`failed to fetch ${label} (${res.status})`);\n    return res.text();\n  }\n  throw new Error(`${label}: output had no readable path or url`);\n}\n\n/** Parse the selection pass output into the elements array ({elements:[...]} or a bare array). */\nexport function parseElements(raw: string): unknown[] {\n  const parsed = JSON.parse(raw) as unknown;\n  if (Array.isArray(parsed)) return parsed;\n  if (parsed && typeof parsed === \"object\" && Array.isArray((parsed as { elements?: unknown }).elements)) {\n    return (parsed as { elements: unknown[] }).elements;\n  }\n  return [];\n}\n\n/** Print the `{ ok: false, error }` envelope and exit 2. */\nexport function fail(code: string, message: string, fix?: string): never {\n  process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message, ...(fix ? { fix } : {}) } }, null, 2)}\\n`);\n  process.exit(2);\n}\n\nexport function fileExists(target: string): Promise<boolean> {\n  return access(target).then(\n    () => true,\n    () => false,\n  );\n}\n","import { existsSync } from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Resolve a shipped `canvas/<name>` asset dir, robust to BOTH module layouts:\n *  - dev (tsx): this code lives at `src/commands/canvas/`, so the asset is at\n *    `<package root>/canvas/<name>` — three levels up.\n *  - published (tsup): `src/**` is flattened into a single `dist/cli.js`, so the\n *    same code now lives at `<package root>/dist/`, and the asset is `../canvas/<name>`.\n *\n * A single hardcoded relative path cannot satisfy both layouts (the previous\n * `../../../canvas` worked from src but overshot the package entirely from the\n * bundled dist, throwing ENOENT after the billed deconstruct already ran). So\n * instead of guessing the nesting, walk UP from the module dir until we find a\n * `canvas/<name>` that actually exists on disk. `canvas` must stay in\n * package.json `files` for the published build to ship the asset at all.\n */\nexport function resolveShippedCanvasDir(\n  name: string,\n  startDir: string,\n  exists: (p: string) => boolean = existsSync,\n  maxDepth = 8,\n): string {\n  const rel = path.join(\"canvas\", name);\n  let dir = startDir;\n  for (let i = 0; i < maxDepth; i++) {\n    const candidate = path.join(dir, rel);\n    // `meta.json` is the composition's manifest — its presence proves we found\n    // the real asset dir, not an empty `canvas/` that happens to exist higher up.\n    if (exists(path.join(candidate, \"meta.json\"))) return candidate;\n    const parent = path.dirname(dir);\n    if (parent === dir) break; // reached filesystem root\n    dir = parent;\n  }\n  // Fall back to the dev src-relative location so a missing asset still produces\n  // a clear \"no such file\" at copy time rather than a silently-wrong path.\n  return path.resolve(startDir, \"../../../\", rel);\n}\n"],"mappings":";;;;;;AAIA,SAAS,QAAQ,gBAAgB;;;ACJjC,SAAS,kBAAkB;AAC3B,OAAO,UAAU;AAgBV,SAAS,wBACd,MACA,UACA,SAAiC,YACjC,WAAW,GACH;AACR,QAAM,MAAM,KAAK,KAAK,UAAU,IAAI;AACpC,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,UAAU,KAAK;AACjC,UAAM,YAAY,KAAK,KAAK,KAAK,GAAG;AAGpC,QAAI,OAAO,KAAK,KAAK,WAAW,WAAW,CAAC,EAAG,QAAO;AACtD,UAAM,SAAS,KAAK,QAAQ,GAAG;AAC/B,QAAI,WAAW,IAAK;AACpB,UAAM;AAAA,EACR;AAGA,SAAO,KAAK,QAAQ,UAAU,aAAa,GAAG;AAChD;;;AD1BO,IAAM,kCAAkC;AAAA,EAC7C;AAAA,EACA,YAAY;AACd;AAEO,IAAM,uBAAuB,wBAAwB,+BAA+B,YAAY,OAAO;AASvG,SAAS,aAAa,MAAgB,WAAoB,UAA0B;AACzF,QAAM,QAAQ,YAAY,OAAO,SAAS,IAAI;AAC9C,MAAI,kBAAkB,MAAM,KAAK,EAAG,QAAO;AAC3C,QAAM,QAAQ,OAAO,KAAK,eAAe,IAAI,CAAC,EAAE,KAAK,IAAI;AACzD,QAAM,IAAI,MAAM,IAAI,KAAK,cAAc,IAAI,uBAAuB,KAAK,EAAE;AAC3E;AAKA,eAAsB,cAAc,KAAc,OAAgC;AAChF,QAAM,IAAI;AACV,MAAI,OAAO,GAAG,SAAS,SAAU,QAAO,SAAS,EAAE,MAAM,MAAM;AAC/D,MAAI,OAAO,GAAG,QAAQ,UAAU;AAC9B,UAAM,MAAM,MAAM,MAAM,EAAE,GAAG;AAC7B,QAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,mBAAmB,KAAK,KAAK,IAAI,MAAM,GAAG;AACvE,WAAO,IAAI,KAAK;AAAA,EAClB;AACA,QAAM,IAAI,MAAM,GAAG,KAAK,sCAAsC;AAChE;AAGO,SAAS,cAAc,KAAwB;AACpD,QAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,MAAI,MAAM,QAAQ,MAAM,EAAG,QAAO;AAClC,MAAI,UAAU,OAAO,WAAW,YAAY,MAAM,QAAS,OAAkC,QAAQ,GAAG;AACtG,WAAQ,OAAmC;AAAA,EAC7C;AACA,SAAO,CAAC;AACV;AAGO,SAAS,KAAK,MAAc,SAAiB,KAAqB;AACvE,UAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,SAAS,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC,EAAG,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA,CAAI;AACrH,UAAQ,KAAK,CAAC;AAChB;AAEO,SAAS,WAAW,QAAkC;AAC3D,SAAO,OAAO,MAAM,EAAE;AAAA,IACpB,MAAM;AAAA,IACN,MAAM;AAAA,EACR;AACF;","names":[]}

package/dist/chunk-ASL7JFBD.js

@@ -0,0 +1,96 @@
+import {
+  loadCompositionMeta
+} from "./chunk-KZUHRZ2C.js";
+import {
+  parseRefExpr
+} from "./chunk-66USKCVY.js";
+import {
+  resolveAdaptFormats
+} from "./chunk-CAMX6OHF.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));
+}
+
+export {
+  outputRatioWarningsFor
+};
+//# sourceMappingURL=chunk-ASL7JFBD.js.map

package/dist/chunk-ASL7JFBD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/output-ratio.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"],"mappings":";;;;;;;;;;;AAAA,SAAS,gBAAgB;AACzB,OAAO,UAAU;AAgBV,SAAS,kBAAkB,UAA4B;AAC5D,QAAM,QAAQ,SAAS,MAAM,uBAAuB,IAAI,CAAC;AACzD,MAAI,CAAC,MAAO,QAAO,CAAC;AACpB,QAAM,QAAQ,CAAC,MAAc,EAAE,KAAK,EAAE,QAAQ,gBAAgB,EAAE;AAChE,QAAM,OAAO,MAAM,MAAM,2BAA2B;AACpD,MAAI,KAAM,SAAQ,KAAK,CAAC,KAAK,IAAI,MAAM,GAAG,EAAE,IAAI,KAAK,EAAE,OAAO,OAAO;AACrE,QAAM,QAAQ,MAAM,MAAM,oCAAoC;AAC9D,MAAI,CAAC,MAAO,QAAO,CAAC;AACpB,UAAQ,MAAM,CAAC,KAAK,IACjB,MAAM,IAAI,EACV,IAAI,CAAC,MAAM,EAAE,QAAQ,YAAY,EAAE,CAAC,EACpC,IAAI,KAAK,EACT,OAAO,OAAO;AACnB;AAIA,SAAS,OAAO,OAAe,QAAwB;AACrD,QAAM,MAAM,CAAC,GAAW,MAAuB,MAAM,IAAI,IAAI,IAAI,GAAG,IAAI,CAAC;AACzE,QAAM,IAAI,IAAI,OAAO,MAAM;AAC3B,SAAO,GAAG,QAAQ,CAAC,IAAI,SAAS,CAAC;AACnC;AAGA,eAAe,SAAS,OAA0B,IAAY,MAA6C;AACzG,QAAM,OAAO,MAAM,IAAI,EAAE;AACzB,MAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,EAAG,QAAO;AAClC,OAAK,IAAI,EAAE;AACX,QAAM,IAAI,KAAK,UAAU,CAAC;AAC1B,UAAQ,KAAK,MAAM;AAAA,IACjB,KAAK;AACH,aAAO,OAAO,EAAE,iBAAiB,WAAW,CAAC,EAAE,YAAY,IAAI;AAAA,IACjE,KAAK;AACH,aAAO,CAAC,GAAG,oBAAoB,CAA8C,CAAC;AAAA,IAChF,KAAK,uBAAuB;AAC1B,UAAI,OAAO,EAAE,gBAAgB,SAAU,QAAO;AAC9C,YAAM,OAAO,MAAM,oBAAoB,EAAE,WAAW,EAAE,MAAM,MAAM,IAAI;AACtE,aAAO,OAAO,CAAC,OAAO,KAAK,OAAO,KAAK,MAAM,CAAC,IAAI;AAAA,IACpD;AAAA,IACA,KAAK,WAAW;AACd,YAAM,SAAS,KAAK,QAAQ;AAC5B,UAAI,CAAC,MAAM,QAAQ,MAAM,EAAG,QAAO;AACnC,YAAM,MAAgB,CAAC;AACvB,iBAAW,SAAS,QAAQ;AAC1B,cAAM,MAAM,OAAO,UAAU,WAAW,aAAa,KAAK,IAAI;AAC9D,YAAI,CAAC,OAAO,IAAI,SAAS,MAAO,QAAO;AACvC,cAAM,WAAW,MAAM,SAAS,OAAO,IAAI,QAAQ,IAAI;AACvD,YAAI,CAAC,SAAU,QAAO;AACtB,YAAI,KAAK,IAAI,UAAU,UAAa,SAAS,SAAS,IAAK,SAAS,IAAI,KAAK,KAAK,KAAO,SAAS,CAAC,KAAK,EAAG;AAAA,MAC7G;AACA,aAAO,IAAI,OAAO,OAAO;AAAA,IAC3B;AAAA,IACA;AACE,aAAO;AAAA,EACX;AACF;AAOA,eAAsB,eAAe,QAA2C;AAC9E,QAAM,IAAI;AACV,MAAI,CAAC,MAAM,QAAQ,GAAG,KAAK,KAAK,OAAO,GAAG,QAAQ,SAAS,SAAU,QAAO;AAC5E,QAAM,QAAQ,IAAI,IAAK,EAAE,MAAiB,QAAQ,CAAC,MAAO,OAAO,EAAE,OAAO,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAU,IAAI,CAAC,CAAE,CAAC;AAChH,SAAO,SAAS,OAAO,EAAE,OAAO,MAAM,oBAAI,IAAI,CAAC;AACjD;AAEA,SAAS,MAAM,OAA8B;AAC3C,QAAM,CAAC,GAAG,CAAC,IAAI,MAAM,MAAM,GAAG,EAAE,IAAI,MAAM;AAC1C,SAAO,KAAK,IAAI,IAAI,IAAI;AAC1B;AAGO,SAAS,oBAAoB,UAAoB,UAA8C;AACpG,MAAI,CAAC,YAAY,SAAS,WAAW,EAAG,QAAO,CAAC;AAChD,QAAM,SAAS,SAAS,QAAQ,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;AACrD,SAAO,SAAS,QAAQ,CAAC,WAAW;AAClC,UAAM,OAAO,MAAM,MAAM;AACzB,QAAI,SAAS,QAAQ,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,IAAI,EAAG,QAAO,CAAC;AACjF,WAAO;AAAA,MACL;AAAA,QACE,MAAM;AAAA,QACN,MAAM;AAAA,QACN,UAAU;AAAA,QACV,SAAS,2BAA2B,MAAM,8BAA8B,SAAS,KAAK,IAAI,CAAC,OAAO,MAAM;AAAA,MAC1G;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAGA,eAAsB,uBAAuB,QAAiB,YAAgD;AAC5G,QAAM,aAAa,MAAM,SAAS,KAAK,KAAK,KAAK,QAAQ,UAAU,GAAG,gBAAgB,GAAG,MAAM,EAAE,MAAM,MAAM,IAAI;AACjH,MAAI,CAAC,WAAY,QAAO,CAAC;AACzB,SAAO,oBAAoB,kBAAkB,UAAU,GAAG,MAAM,eAAe,MAAM,CAAC;AACxF;","names":[]}