@koda-sl/baker-cli 0.481.0-dev.2d33e194f → 0.482.0-dev.a5555ab55

package/dist/chunk-QVQKCVP7.js

@@ -0,0 +1,85 @@
+// src/commands/creatives/rules-view.ts
+import { readdir, readFile } from "fs/promises";
+import path from "path";
+var RULE_CHARS = 200;
+var QUOTE_CHARS = 160;
+var RETIRE_AFTER = 3;
+var MANY_RULES = 40;
+var cut = (text, max) => text.length > max ? `${text.slice(0, max - 1)}\u2026` : text;
+function fromOf(rule) {
+  if (rule.origin === "declared") return "BRAND.md";
+  const when = rule.source.date ? ` ${rule.source.date}` : "";
+  const where = rule.source.slug ? ` on ${rule.source.slug}` : "";
+  return `taught${when}${where}`;
+}
+function checkView(check) {
+  return {
+    ...check?.forbid ? { bans: check.forbid } : {},
+    ...check?.allow ? { except: check.allow } : {},
+    ...check?.require ? { requires: check.require } : {},
+    ...check?.people ? { people: check.people } : {}
+  };
+}
+function rulesView(rules, opts = {}) {
+  const max = opts.full ? Number.POSITIVE_INFINITY : RULE_CHARS;
+  const quoteMax = opts.full ? Number.POSITIVE_INFINITY : QUOTE_CHARS;
+  return rules.map((r) => ({
+    id: r.id,
+    strength: r.strength,
+    applies: r.applies,
+    rule: cut(r.text, max),
+    ...r.source.quote ? { their_words: cut(r.source.quote, quoteMax) } : {},
+    from: fromOf(r),
+    ...checkView(r.check),
+    ...Object.keys(r.scope).length > 0 ? { scope: r.scope } : {},
+    ...r.status === "retired" ? { status: "retired" } : {},
+    ...r.retiredBy ? { retired_by: r.retiredBy } : {}
+  }));
+}
+function waiverCounts(specs) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const spec of specs) {
+    const waive = spec?.waive;
+    if (!Array.isArray(waive)) continue;
+    for (const entry of waive) {
+      const id = entry?.rule;
+      if (typeof id === "string" && id) counts.set(id, (counts.get(id) ?? 0) + 1);
+    }
+  }
+  return counts;
+}
+async function readCreativeSpecs(root) {
+  const dir = path.join(root, "src", "creatives");
+  const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+  const specs = await Promise.all(
+    entries.filter((e) => e.isDirectory() && !e.name.startsWith("_")).map(
+      (e) => readFile(path.join(dir, e.name, "prompt.json"), "utf8").then((raw) => JSON.parse(raw)).catch(() => null)
+    )
+  );
+  return specs.filter((s) => s !== null);
+}
+function rulesHints(active, waived) {
+  const hints = [];
+  for (const rule of active) {
+    const times = waived.get(rule.id) ?? 0;
+    if (times >= RETIRE_AFTER) {
+      hints.push(
+        `${rule.id} was waived by ${times} ads: ask the person whether it still holds, and \`baker creatives rules retire ${rule.id}\` if not.`
+      );
+    }
+  }
+  if (active.length > MANY_RULES) {
+    hints.push(
+      `${active.length} active rules: every prompt carries them all. Ask the person whether some can be retired or merged.`
+    );
+  }
+  return hints;
+}
+
+export {
+  rulesView,
+  waiverCounts,
+  readCreativeSpecs,
+  rulesHints
+};
+//# sourceMappingURL=chunk-QVQKCVP7.js.map

package/dist/chunk-QVQKCVP7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/rules-view.ts"],"sourcesContent":["/**\n * The company's creative rules as the agent reads them, in `baker creatives brief` and\n * `baker creatives rules list`: each one's id, strength and words, the person's own words when\n * they taught it, and where it came from; and which ones ads keep waiving. Pure, but for the read\n * of the ads' waivers.\n */\nimport { readdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { CreativeRule } from \"../../engine/creative-rules/schema.ts\";\n\n/** A rule cut to this in the compact view: the whole is behind `--full`. */\nconst RULE_CHARS = 200;\nconst QUOTE_CHARS = 160;\n/** Waived this often, a rule may no longer hold. */\nconst RETIRE_AFTER = 3;\n/** Past this many active rules, every prompt carries a long list: worth a look. */\nconst MANY_RULES = 40;\n\nconst cut = (text: string, max: number) => (text.length > max ? `${text.slice(0, max - 1)}…` : text);\n\n/** Where a rule came from, in a few words. */\nfunction fromOf(rule: CreativeRule): string {\n  if (rule.origin === \"declared\") return \"BRAND.md\";\n  const when = rule.source.date ? ` ${rule.source.date}` : \"\";\n  const where = rule.source.slug ? ` on ${rule.source.slug}` : \"\";\n  return `taught${when}${where}`;\n}\n\nexport type RuleView = {\n  id: string;\n  strength: CreativeRule[\"strength\"];\n  applies: CreativeRule[\"applies\"];\n  rule: string;\n  their_words?: string;\n  from: string;\n  /** The words it bans in an ad's words, and the phrases that may still hold them. */\n  bans?: string[];\n  except?: string[];\n  /** Words every ad must say. */\n  requires?: string[];\n  /** Only real people may appear. */\n  people?: \"real\";\n  scope?: CreativeRule[\"scope\"];\n  status?: \"retired\";\n  retired_by?: string;\n};\n\n/** What code checks of a rule, as the agent reads it. Pure. */\nfunction checkView(check: CreativeRule[\"check\"]): Pick<RuleView, \"bans\" | \"except\" | \"requires\" | \"people\"> {\n  return {\n    ...(check?.forbid ? { bans: check.forbid } : {}),\n    ...(check?.allow ? { except: check.allow } : {}),\n    ...(check?.require ? { requires: check.require } : {}),\n    ...(check?.people ? { people: check.people } : {}),\n  };\n}\n\n/** Each rule as the agent reads it. Pure. */\nexport function rulesView(rules: readonly CreativeRule[], opts: { full?: boolean } = {}): RuleView[] {\n  const max = opts.full ? Number.POSITIVE_INFINITY : RULE_CHARS;\n  const quoteMax = opts.full ? Number.POSITIVE_INFINITY : QUOTE_CHARS;\n  return rules.map((r) => ({\n    id: r.id,\n    strength: r.strength,\n    applies: r.applies,\n    rule: cut(r.text, max),\n    ...(r.source.quote ? { their_words: cut(r.source.quote, quoteMax) } : {}),\n    from: fromOf(r),\n    ...checkView(r.check),\n    ...(Object.keys(r.scope).length > 0 ? { scope: r.scope } : {}),\n    ...(r.status === \"retired\" ? { status: \"retired\" as const } : {}),\n    ...(r.retiredBy ? { retired_by: r.retiredBy } : {}),\n  }));\n}\n\n/** How many ads waive each rule (`waive: [{rule, why}]` in their prompt.json). Pure. */\nexport function waiverCounts(specs: readonly unknown[]): Map<string, number> {\n  const counts = new Map<string, number>();\n  for (const spec of specs) {\n    const waive = (spec as { waive?: unknown } | null)?.waive;\n    if (!Array.isArray(waive)) continue;\n    for (const entry of waive) {\n      const id = (entry as { rule?: unknown } | null)?.rule;\n      if (typeof id === \"string\" && id) counts.set(id, (counts.get(id) ?? 0) + 1);\n    }\n  }\n  return counts;\n}\n\n/** Every creative's prompt.json, parsed; one that cannot be read is left out. */\nexport async function readCreativeSpecs(root: string): Promise<unknown[]> {\n  const dir = path.join(root, \"src\", \"creatives\");\n  const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);\n  const specs = await Promise.all(\n    entries\n      .filter((e) => e.isDirectory() && !e.name.startsWith(\"_\"))\n      .map((e) =>\n        readFile(path.join(dir, e.name, \"prompt.json\"), \"utf8\")\n          .then((raw): unknown => JSON.parse(raw))\n          .catch(() => null),\n      ),\n  );\n  return specs.filter((s) => s !== null);\n}\n\n/** What the rules say to do next: retire one ads keep waiving, look at a list grown long. Pure. */\nexport function rulesHints(active: readonly CreativeRule[], waived: ReadonlyMap<string, number>): string[] {\n  const hints: string[] = [];\n  for (const rule of active) {\n    const times = waived.get(rule.id) ?? 0;\n    if (times >= RETIRE_AFTER) {\n      hints.push(\n        `${rule.id} was waived by ${times} ads: ask the person whether it still holds, and \\`baker creatives rules retire ${rule.id}\\` if not.`,\n      );\n    }\n  }\n  if (active.length > MANY_RULES) {\n    hints.push(\n      `${active.length} active rules: every prompt carries them all. Ask the person whether some can be retired or merged.`,\n    );\n  }\n  return hints;\n}\n"],"mappings":";AAMA,SAAS,SAAS,gBAAgB;AAClC,OAAO,UAAU;AAIjB,IAAM,aAAa;AACnB,IAAM,cAAc;AAEpB,IAAM,eAAe;AAErB,IAAM,aAAa;AAEnB,IAAM,MAAM,CAAC,MAAc,QAAiB,KAAK,SAAS,MAAM,GAAG,KAAK,MAAM,GAAG,MAAM,CAAC,CAAC,WAAM;AAG/F,SAAS,OAAO,MAA4B;AAC1C,MAAI,KAAK,WAAW,WAAY,QAAO;AACvC,QAAM,OAAO,KAAK,OAAO,OAAO,IAAI,KAAK,OAAO,IAAI,KAAK;AACzD,QAAM,QAAQ,KAAK,OAAO,OAAO,OAAO,KAAK,OAAO,IAAI,KAAK;AAC7D,SAAO,SAAS,IAAI,GAAG,KAAK;AAC9B;AAsBA,SAAS,UAAU,OAAyF;AAC1G,SAAO;AAAA,IACL,GAAI,OAAO,SAAS,EAAE,MAAM,MAAM,OAAO,IAAI,CAAC;AAAA,IAC9C,GAAI,OAAO,QAAQ,EAAE,QAAQ,MAAM,MAAM,IAAI,CAAC;AAAA,IAC9C,GAAI,OAAO,UAAU,EAAE,UAAU,MAAM,QAAQ,IAAI,CAAC;AAAA,IACpD,GAAI,OAAO,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;AAAA,EAClD;AACF;AAGO,SAAS,UAAU,OAAgC,OAA2B,CAAC,GAAe;AACnG,QAAM,MAAM,KAAK,OAAO,OAAO,oBAAoB;AACnD,QAAM,WAAW,KAAK,OAAO,OAAO,oBAAoB;AACxD,SAAO,MAAM,IAAI,CAAC,OAAO;AAAA,IACvB,IAAI,EAAE;AAAA,IACN,UAAU,EAAE;AAAA,IACZ,SAAS,EAAE;AAAA,IACX,MAAM,IAAI,EAAE,MAAM,GAAG;AAAA,IACrB,GAAI,EAAE,OAAO,QAAQ,EAAE,aAAa,IAAI,EAAE,OAAO,OAAO,QAAQ,EAAE,IAAI,CAAC;AAAA,IACvE,MAAM,OAAO,CAAC;AAAA,IACd,GAAG,UAAU,EAAE,KAAK;AAAA,IACpB,GAAI,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAAA,IAC5D,GAAI,EAAE,WAAW,YAAY,EAAE,QAAQ,UAAmB,IAAI,CAAC;AAAA,IAC/D,GAAI,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,IAAI,CAAC;AAAA,EACnD,EAAE;AACJ;AAGO,SAAS,aAAa,OAAgD;AAC3E,QAAM,SAAS,oBAAI,IAAoB;AACvC,aAAW,QAAQ,OAAO;AACxB,UAAM,QAAS,MAAqC;AACpD,QAAI,CAAC,MAAM,QAAQ,KAAK,EAAG;AAC3B,eAAW,SAAS,OAAO;AACzB,YAAM,KAAM,OAAqC;AACjD,UAAI,OAAO,OAAO,YAAY,GAAI,QAAO,IAAI,KAAK,OAAO,IAAI,EAAE,KAAK,KAAK,CAAC;AAAA,IAC5E;AAAA,EACF;AACA,SAAO;AACT;AAGA,eAAsB,kBAAkB,MAAkC;AACxE,QAAM,MAAM,KAAK,KAAK,MAAM,OAAO,WAAW;AAC9C,QAAM,UAAU,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC,CAAC;AAC1E,QAAM,QAAQ,MAAM,QAAQ;AAAA,IAC1B,QACG,OAAO,CAAC,MAAM,EAAE,YAAY,KAAK,CAAC,EAAE,KAAK,WAAW,GAAG,CAAC,EACxD;AAAA,MAAI,CAAC,MACJ,SAAS,KAAK,KAAK,KAAK,EAAE,MAAM,aAAa,GAAG,MAAM,EACnD,KAAK,CAAC,QAAiB,KAAK,MAAM,GAAG,CAAC,EACtC,MAAM,MAAM,IAAI;AAAA,IACrB;AAAA,EACJ;AACA,SAAO,MAAM,OAAO,CAAC,MAAM,MAAM,IAAI;AACvC;AAGO,SAAS,WAAW,QAAiC,QAA+C;AACzG,QAAM,QAAkB,CAAC;AACzB,aAAW,QAAQ,QAAQ;AACzB,UAAM,QAAQ,OAAO,IAAI,KAAK,EAAE,KAAK;AACrC,QAAI,SAAS,cAAc;AACzB,YAAM;AAAA,QACJ,GAAG,KAAK,EAAE,kBAAkB,KAAK,mFAAmF,KAAK,EAAE;AAAA,MAC7H;AAAA,IACF;AAAA,EACF;AACA,MAAI,OAAO,SAAS,YAAY;AAC9B,UAAM;AAAA,MACJ,GAAG,OAAO,MAAM;AAAA,IAClB;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/chunk-QYAI24PN.js

@@ -0,0 +1,172 @@
+import {
+  ACTION_TEMP_ID_PREFIX
+} from "./chunk-2QSPPWOU.js";
+import {
+  ApiError
+} from "./chunk-XDZVBX6L.js";
+import {
+  writeJson
+} from "./chunk-WNSE7N75.js";
+
+// src/commands/actions/tagError.ts
+var UNKNOWN_TAG_RE = /Unknown action tag\(s\): ([^.]+)\. Valid tags: ([^.]+)\./;
+function splitSlugs(list) {
+  return list.split(",").map((slug) => slug.trim()).filter((slug) => slug.length > 0);
+}
+function actionTagFix(message) {
+  const match = UNKNOWN_TAG_RE.exec(message);
+  if (!match) {
+    return null;
+  }
+  const [, unknownList, validList] = match;
+  const unknownTags = splitSlugs(unknownList ?? "");
+  const validTags = splitSlugs(validList ?? "");
+  const first = unknownTags[0];
+  if (first === void 0 || validTags.length === 0) {
+    return null;
+  }
+  return {
+    action: "retry_with_a_valid_tag",
+    explanation: `The tag(s) ${unknownTags.join(", ")} are not in this company's taxonomy. \`validTags\` below is the complete accepted set \u2014 pick from it and re-run the same command. Only mint a new tag when none of them names this work; a near-duplicate of an existing tag splits the backlog's filter instead of extending it.`,
+    unknownTags,
+    validTags,
+    mintCommand: `baker actions tags create --slug ${first} --description "<what ${first} groups>"`,
+    listCommand: "baker actions tags list"
+  };
+}
+
+// src/commands/actions/shared.ts
+function writeOk(data) {
+  writeJson({ ok: true, data: data ?? null });
+}
+function failValidation(message) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function failApi(err) {
+  if (err instanceof ApiError) {
+    const fix = actionTagFix(err.message);
+    writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
+    process.exit(1);
+  }
+  if (err instanceof Error) {
+    writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+function generateTempId() {
+  return `${ACTION_TEMP_ID_PREFIX}${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function isTempId(id) {
+  return id.startsWith(ACTION_TEMP_ID_PREFIX);
+}
+function parseTagList(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const tags = value.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
+  return [...new Set(tags)];
+}
+var ACTION_PRIORITIES = ["urgent", "high", "medium", "low"];
+function parsePriority(value, { allowClear }) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    failValidation(
+      `--priority must be one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+    );
+  }
+  const trimmed = value.trim().toLowerCase();
+  if (trimmed === "") {
+    if (allowClear) {
+      return null;
+    }
+    return void 0;
+  }
+  if (allowClear && (trimmed === "none" || trimmed === "clear")) {
+    return null;
+  }
+  if (ACTION_PRIORITIES.includes(trimmed)) {
+    return trimmed;
+  }
+  failValidation(
+    `Unknown --priority "${value}". Expected one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+  );
+}
+var FAN_OUT_NUDGE_THRESHOLD = 2;
+var FAN_OUT_THRESHOLD = 3;
+function buildCreateHints({
+  advisory,
+  description,
+  tempId,
+  tags,
+  prioritySet,
+  draftCreateCount
+}) {
+  const hints = [];
+  if (advisory) {
+    hints.push(
+      `${advisory.hint} If nothing actually blocks it: baker actions draft remove ${tempId}, then do the work.`
+    );
+  }
+  if (draftCreateCount >= FAN_OUT_THRESHOLD) {
+    hints.push(
+      `${draftCreateCount} Tasks are staged in this chat. Re-read them with \`baker actions draft\`: can any be done now with a surface you already have, and do any two touch the same system (same container, same campaign, same page)? Those belong in ONE Task \u2014 fold them together with \`baker actions update\` and drop the extras with \`baker actions draft remove <tempId>\`.`
+    );
+  } else if (draftCreateCount === FAN_OUT_NUDGE_THRESHOLD) {
+    hints.push(
+      `Second Task staged in this chat. If these two land on the same system (same container, same campaign, same page) they are ONE Task \u2014 fold them with \`baker actions update\` and drop the extra with \`baker actions draft remove ${tempId}\`.`
+    );
+  }
+  hints.push(`Link dependencies: baker actions link --blocker <id> --blocked ${tempId}`);
+  if (!description) {
+    hints.push("Add description: baker actions update <tempId> --description '...' (what/why/where/done-when)");
+  }
+  if (!tags || tags.length === 0) {
+    hints.push(
+      "MISSING --tags. This action is invisible to the backlog's tag filter. Re-run with --tags <slug,...> (`baker actions tags list` for the taxonomy, `baker actions tags create --slug <slug>` to mint) \u2014 or `baker actions update <tempId> --tags <slug,...>`."
+    );
+  }
+  if (!prioritySet) {
+    hints.push(
+      `MISSING --priority. Without it this action ranks as 'normal' (medium) in the do-first ordering, so urgent/high client work won't surface first. Re-run with --priority ${ACTION_PRIORITIES.join("|")} \u2014 or \`baker actions update <tempId> --priority <level>\`.`
+    );
+  }
+  return hints;
+}
+var ACTIONS_LIST_DEFAULT_LIMIT = 500;
+function buildListHints({ returned, limit }) {
+  if (returned < limit) {
+    return [];
+  }
+  return [
+    `This list is capped at ${limit} Tasks and came back full, so older Tasks exist that are NOT shown. Do not treat it as the whole backlog \u2014 re-run with --limit ${limit * 2} (or narrow with --status / --search).`
+  ];
+}
+function buildGetHints(detail) {
+  if (detail?.action.status !== "pending" || detail.activeChat !== null) {
+    return [];
+  }
+  return [
+    `If you are working on this Task in this chat, claim it first so the Tasks page shows it in progress: baker actions claim ${detail.action._id}`
+  ];
+}
+
+export {
+  writeOk,
+  failValidation,
+  failApi,
+  generateTempId,
+  isTempId,
+  parseTagList,
+  ACTION_PRIORITIES,
+  parsePriority,
+  buildCreateHints,
+  ACTIONS_LIST_DEFAULT_LIMIT,
+  buildListHints,
+  buildGetHints
+};
+//# sourceMappingURL=chunk-QYAI24PN.js.map

package/dist/chunk-QZHGIJOW.js

@@ -0,0 +1,51 @@
+import {
+  failApi
+} from "./chunk-QYAI24PN.js";
+import {
+  HUBSPOT_MISSING_GRANT_MARKER,
+  HUBSPOT_NOT_CONNECTED_MESSAGE
+} from "./chunk-2QSPPWOU.js";
+import {
+  ApiError
+} from "./chunk-XDZVBX6L.js";
+import {
+  writeJson
+} from "./chunk-WNSE7N75.js";
+
+// src/commands/hubspot/refusal.ts
+var CONTINUE = "Keep going with the wider task: say which part you could not read, skip it, and finish everything else. If the `request_connection` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Platforms \u2192 HubSpot.";
+function hubspotRefusal(code, message, reason = "so I can count a contact becoming a customer") {
+  if (code === "NOT_FOUND" && message.includes(HUBSPOT_NOT_CONNECTED_MESSAGE)) {
+    return {
+      code: "NO_HUBSPOT_CONNECTION",
+      fix: {
+        action: "request_connection",
+        explanation: `AGENT INSTRUCTION: HubSpot is not connected, and only the user can connect it. Call the \`request_connection\` tool with { platform: "hubspot", reason } \u2014 reason in their words, e.g. "${reason}" \u2014 and they connect it inside the chat; then run this command again. ` + CONTINUE
+      }
+    };
+  }
+  if (code === "FORBIDDEN" && message.includes(HUBSPOT_MISSING_GRANT_MARKER)) {
+    return {
+      code: "HUBSPOT_RECONNECT_REQUIRED",
+      fix: {
+        action: "request_connection",
+        explanation: 'AGENT INSTRUCTION: HubSpot is connected \u2014 do not tell the user it is missing, and do not retry. Its access does not cover this read (it was connected before Baker asked for it, or the access was withdrawn), and only the user can widen it. Call the `request_connection` tool with { platform: "hubspot", reason } naming what you need to read; the card offers them a Reconnect button. Run this command again once they have. ' + CONTINUE
+      }
+    };
+  }
+  return null;
+}
+function failNotConnected(err, reason) {
+  const refusal = err instanceof ApiError ? hubspotRefusal(err.code, err.message, reason) : null;
+  if (err instanceof ApiError && refusal !== null) {
+    writeJson({ ok: false, error: { code: refusal.code, message: err.message, fix: refusal.fix } });
+    process.exit(1);
+  }
+  failApi(err);
+}
+
+export {
+  hubspotRefusal,
+  failNotConnected
+};
+//# sourceMappingURL=chunk-QZHGIJOW.js.map

package/dist/chunk-REMR5FHD.js

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

package/dist/chunk-REMR5FHD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/scaffold-delivery.ts"],"sourcesContent":["/**\n * Where a scaffolded static ad runs, decided from the command's flags, the idea and the\n * creative's `_definition.md` before anything is billed (`resolveDelivery`), and what of it the\n * definition records. A refusal for a missing platform names the ad accounts connected, read\n * best-effort: they inform the agent's choice, the CLI never makes it.\n */\nimport { CAPABILITY_SURFACES, type CapabilitiesResponse } from \"@baker/api/capabilities\";\nimport { AD_PLACEMENTS } from \"@baker/canvas-contract\";\nimport { apiPost } from \"../../client.ts\";\nimport {\n  type DeliveryInput,\n  type DeliveryRefusal,\n  type DefinitionDelivery,\n  parseDefinitionDelivery,\n  type ResolvedDelivery,\n  resolveDelivery,\n  type StaticDelivery,\n} from \"../../engine/scaffold/static-delivery.ts\";\nimport { definitionPlatformOf, resolveFormatList } from \"./creative-definition.ts\";\n\n/** The scaffold flags that say where the ad runs, as citty hands them over. */\nexport type DeliveryFlags = {\n  platforms?: unknown;\n  platform?: unknown;\n  placements?: unknown;\n  aspect?: unknown;\n  formats?: unknown;\n  \"target-adset\"?: unknown;\n};\n\nconst flagText = (value: unknown) =>\n  typeof value === \"string\" || typeof value === \"number\" ? String(value).trim() || undefined : undefined;\n\n/** The flags, the idea and the definition as `resolveDelivery` reads them. Pure. */\nexport function deliveryInputOf(\n  flags: DeliveryFlags,\n  definition: DefinitionDelivery | null,\n  idea?: readonly string[],\n): DeliveryInput {\n  const platformsFlag = flagText(flags.platforms);\n  const legacyPlatform = flagText(flags.platform);\n  const legacyPlacements = flagText(flags.placements);\n  const aspect = flagText(flags.aspect);\n  const formatsFlag = flagText(flags.formats);\n  const targetAdSet = flagText(flags[\"target-adset\"]);\n  return {\n    ...(platformsFlag ? { platformsFlag } : {}),\n    ...(legacyPlatform ? { legacyPlatform } : {}),\n    ...(legacyPlacements ? { legacyPlacements } : {}),\n    ...(aspect ? { aspect } : {}),\n    ...(formatsFlag ? { formatsFlag } : {}),\n    ...(idea && idea.length > 0 ? { idea } : {}),\n    definition,\n    ...(targetAdSet ? { targetAdSet } : {}),\n  };\n}\n\n/** Whether any flag names where the ad runs: an ad-hoc canvas (no creative) is planned only then. */\nexport function namesDelivery(flags: DeliveryFlags): boolean {\n  return [flags.platforms, flags.platform, flags.placements, flags.formats].some((f) => flagText(f) !== undefined);\n}\n\n/** A connected ads surface as the catalog's platform names. */\nconst SURFACE_PLATFORMS: Record<string, string> = {\n  \"meta-ads\": \"meta\",\n  \"linkedin-ads\": \"linkedin\",\n  \"google-ads\": \"google_demandgen\",\n  \"x-ads\": \"x\",\n  \"chatgpt-ads\": \"chatgpt\",\n};\n\n/** The platforms of the ad accounts connected; empty when they cannot be read. Never decides anything. */\nexport async function connectedAdPlatforms(): Promise<string[]> {\n  try {\n    const response = await apiPost<CapabilitiesResponse>(\"/api/capabilities\", {}, { timeoutMs: 15_000 });\n    return response.data.surfaces\n      .filter((s) => s.connected && (CAPABILITY_SURFACES as readonly string[]).includes(s.surface))\n      .flatMap((s) => (SURFACE_PLATFORMS[s.surface] ? [SURFACE_PLATFORMS[s.surface] as string] : []));\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Where the ad runs, or the refusal to print. A missing platform's refusal names the connected\n * ad accounts (one free read, only when refusing).\n */\nexport async function scaffoldDelivery(\n  flags: DeliveryFlags,\n  definitionText: string | null,\n  idea?: readonly string[],\n): Promise<{ ok: true; delivery: ResolvedDelivery } | { ok: false; error: DeliveryRefusal }> {\n  const definition = definitionText === null ? null : parseDefinitionDelivery(definitionText);\n  const input = deliveryInputOf(flags, definition, idea);\n  const resolved = resolveDelivery(input);\n  if (resolved.ok || resolved.error.code !== \"platform_required\") return resolved;\n  return resolveDelivery({ ...input, connected: await connectedAdPlatforms() });\n}\n\n/** What the definition records of where the ad runs: the platforms, their family, the sizes. Pure. */\nexport function deliveryDefinitionFields(delivery: StaticDelivery): {\n  platforms: string[];\n  platform: string;\n  formats: string[];\n} {\n  const platforms = delivery.platforms.map((p) => p.trim());\n  return {\n    // The collection names whole platforms; a placement named alone records its platform.\n    platforms: [...new Set(platforms.map(platformOfName))],\n    platform: definitionPlatformOf(platforms[0] ?? \"\"),\n    formats: resolveFormatList(delivery.formats),\n  };\n}\n\n/** A placement id (`meta_stories`) as its platform (`meta`); a platform as itself. */\nfunction platformOfName(name: string): string {\n  return AD_PLACEMENTS.find((p) => p.id === name)?.platform ?? name;\n}\n\n/** How the output names where the ad runs and why: \"Made for LinkedIn (from the idea): delivers 1:1, …\". */\nexport function deliveryNote(delivery: ResolvedDelivery, renderRatio: string): string {\n  const from: Record<ResolvedDelivery[\"source\"], string> = {\n    flag: \"as asked\",\n    idea: \"from the idea\",\n    definition: \"from _definition.md\",\n    legacy_definition: \"from _definition.md's platform\",\n    adset: \"from its Meta ad set\",\n  };\n  return `Made for ${delivery.platforms.join(\", \")} (${from[delivery.source]}): delivers ${delivery.formats.join(\", \")}, the ${delivery.lead} designed first (rendered at ${renderRatio}) and every other size re-laid out from it.`;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-RGX7AQ2K.js

@@ -0,0 +1,131 @@
+import {
+  holdUnbilledSpend
+} from "./chunk-5WMTPYKT.js";
+import {
+  askAboutText
+} from "./chunk-B7FVPHCW.js";
+
+// src/engine/brand/brand-doc.ts
+import { createHash } from "crypto";
+import { mkdir, readdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { z } from "zod";
+var BRAND_DOC_MODEL = "google/gemini-3.5-flash-lite";
+var REQUEST = {
+  provider: { order: ["google-vertex"], allow_fallbacks: false },
+  seed: 0,
+  response_format: { type: "json_object" }
+};
+var PROMPT_VERSION = 3;
+var TIMEOUT_MS = 3e4;
+var BRAND_MD_CHARS = 32e3;
+var NOTE_CHARS = 600;
+var COMPANY_MD_CHARS = 4e3;
+var Font = z.object({
+  family: z.string().trim().min(1).max(60),
+  role: z.enum(["heading", "body", "any"]).catch("any"),
+  use: z.boolean()
+});
+var Color = z.object({
+  hex: z.string().trim().regex(/^#?[0-9a-fA-F]{6}$/).transform((h) => `#${h.replace(/^#/, "").toLowerCase()}`),
+  use: z.boolean()
+});
+var note = z.string().trim().min(1).max(NOTE_CHARS).nullable().optional().catch(null);
+var Reading = z.object({
+  name: z.string().trim().min(1).max(80).nullable().catch(null),
+  wordmark: z.array(z.string().trim().min(1).max(40)).catch([]),
+  logoNames: z.array(z.string().trim().min(1).max(40)).catch([]),
+  fonts: z.array(z.unknown()).catch([]),
+  colors: z.array(z.unknown()).catch([]),
+  voice: note,
+  imagery: note,
+  logoUsage: note
+});
+function brandDocPrompt(docs) {
+  return [
+    "You read a company's brand guidelines (BRAND.md), the start of its company profile (COMPANY.md) and the file names of its logos. They may be written in any language, or several. Extract only what they state; never invent a value.",
+    "",
+    "Return JSON only, in this shape:",
+    '{"name": string | null, "wordmark": string[], "logoNames": string[], "fonts": [{"family": string, "role": "heading" | "body" | "any", "use": boolean}], "colors": [{"hex": "#rrggbb", "use": boolean}], "voice": string | null, "imagery": string | null, "logoUsage": string | null}',
+    "",
+    `- name: the brand's name exactly as written ("# Zernio Brand Guidelines" names Zernio). null when neither document states one, as in an unfilled template ("# Brand Guidelines", "# Company", TODO).`,
+    `- wordmark: every word the documents say the logo prints, as they quote it ("Wordmark: \\"permut\\"" gives "permut"; 'symbol plus "Cubbo" wordmark' gives "Cubbo"), even when it is also the name. [] when they quote none.`,
+    '- logoNames: a product or brand name a logo file name carries ("logo-engage-blue.png" gives "Engage"). Colours, variants, sizes and formats (dark, white, icon, isotype, png) are not names. [] when none.',
+    `- fonts: every typeface the guidelines name, by its family name exactly, the banned ones included. role is heading, body, or any when they do not say. use is false when the guidelines ban it, forbid it or say to avoid it or never use it, in any wording or language; true when the brand uses it. Only a named typeface counts: a generic family (sans-serif, serif, monospace, system-ui) or the operating system's own fonts ("system stack", "system fonts") is not one, so leave it out.`,
+    "- colors: every hex colour the guidelines give. use is false when they ban it or say to avoid it, true when it is a brand colour.",
+    "- voice: how the brand speaks, as the guidelines put it, at most two sentences in their language. null when they do not say.",
+    "- imagery: what the brand's pictures look like and never look like (photography, illustration, people; a ```generation-style block says it too), at most two sentences in their language. null when they do not say.",
+    "- logoUsage: which logo file an ad uses and how it must appear (which file for which product, line or background, what never to do to it), at most two sentences in their language. null when they do not say.",
+    "",
+    "<brand_md>",
+    (docs.brandMd ?? "").slice(0, BRAND_MD_CHARS),
+    "</brand_md>",
+    "<company_md>",
+    (docs.companyMd ?? "").slice(0, COMPANY_MD_CHARS),
+    "</company_md>",
+    "<logo_files>",
+    (docs.logoFiles ?? []).join("\n"),
+    "</logo_files>"
+  ].join("\n");
+}
+function parseBrandDoc(answer) {
+  const parsed = Reading.safeParse(answer);
+  if (!parsed.success) return null;
+  const fonts = parsed.data.fonts.flatMap((f) => {
+    const font = Font.safeParse(f);
+    return font.success ? [font.data] : [];
+  });
+  const colors = parsed.data.colors.flatMap((c) => {
+    const color = Color.safeParse(c);
+    return color.success ? [color.data] : [];
+  });
+  const { voice, imagery, logoUsage } = parsed.data;
+  return {
+    ...parsed.data.name ? { name: parsed.data.name } : {},
+    wordmark: [.../* @__PURE__ */ new Set([...parsed.data.wordmark, ...parsed.data.logoNames])],
+    fonts,
+    colors,
+    ...voice ? { voice } : {},
+    ...imagery ? { imagery } : {},
+    ...logoUsage ? { logoUsage } : {}
+  };
+}
+function brandDocReader(cacheDir, onSpend) {
+  return async (docs) => {
+    const prompt = brandDocPrompt(docs);
+    const key = createHash("sha256").update(JSON.stringify([PROMPT_VERSION, BRAND_DOC_MODEL, prompt])).digest("hex");
+    const file = path.join(cacheDir, "brand-doc", `${key}.json`);
+    const cached = parseBrandDoc(await readFile(file, "utf8").then(JSON.parse, () => null));
+    if (cached) return cached;
+    const spent = [];
+    const answer = await askAboutText(BRAND_DOC_MODEL, prompt, (u) => onSpend ? onSpend(u) : spent.push(u), {
+      timeoutMs: TIMEOUT_MS,
+      request: REQUEST
+    }).catch(() => null);
+    await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
+    const reading = parseBrandDoc(answer);
+    if (reading) {
+      await mkdir(path.dirname(file), { recursive: true }).catch(() => void 0);
+      await writeFile(file, JSON.stringify(reading), "utf8").catch(() => void 0);
+    }
+    return reading;
+  };
+}
+var LOGO_FILE = /logo|lockup|wordmark|isotype|isologo/i;
+async function workspaceBrandDocs(root) {
+  const read = (rel) => readFile(path.join(root, rel), "utf8").catch(() => null);
+  const logoFiles = (await readdir(path.join(root, "src", "brand", "logos")).catch(() => [])).filter((f) => /\.(png|jpe?g|webp|svg)$/i.test(f) && LOGO_FILE.test(f)).sort();
+  return { brandMd: await read("src/brand/BRAND.md"), companyMd: await read("COMPANY.md"), logoFiles };
+}
+async function readWorkspaceBrandDoc(root, opts = {}) {
+  const docs = await workspaceBrandDocs(root);
+  if (!docs.brandMd?.trim() && !docs.companyMd?.trim()) return null;
+  const read = opts.read ?? brandDocReader(path.join(root, "canvas", ".cache"), opts.onSpend);
+  return await read(docs).catch(() => null);
+}
+
+export {
+  LOGO_FILE,
+  readWorkspaceBrandDoc
+};
+//# sourceMappingURL=chunk-RGX7AQ2K.js.map

package/dist/chunk-RGX7AQ2K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engine/brand/brand-doc.ts"],"sourcesContent":["/**\n * What the brand's own documents state about it, read by a text model in whatever language they\n * are written: its name, the words its logo prints, the typefaces and colours it uses and the ones\n * it bans, how it speaks, what its pictures look like and how its logo is used. Its rules for ads\n * are read apart (`brand-rules.ts`). BRAND.md is prose, and every reader that scraped it with English words got it wrong\n * the moment it was written otherwise: \"nunca uses Inter\" read as a face to use.\n *\n * `src/brand/tokens.json` stays the canonical machine source; this is what the documents add or\n * what a workspace that predates tokens.json has. The model only extracts, pinned to one provider\n * and a seed, and each reading is kept by the documents' content, so the same documents\n * read the same on every run and cost one call per edit. Measured on scripts/brand-doc-evals.\n */\nimport { createHash } from \"node:crypto\";\nimport { mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { z } from \"zod\";\nimport { holdUnbilledSpend } from \"../../commands/canvas/unbilled-spend.ts\";\nimport { askAboutText, type ReviewUsage } from \"../nodes/local/lib/render-review.ts\";\n\n/**\n * Measured 2026-10-11 with scripts/brand-doc-evals: 21/21 on each of nine runs, p50 about 0.65 s\n * (2.5 Flash-Lite, which it replaces: 21/21, 0.5 s). Vertex takes no temperature for this model\n * and AI Studio, which does, fails the key's zero-data-retention guardrail, so the seed pins the draw.\n */\nexport const BRAND_DOC_MODEL = \"google/gemini-3.5-flash-lite\";\nconst REQUEST = {\n  provider: { order: [\"google-vertex\"], allow_fallbacks: false },\n  seed: 0,\n  response_format: { type: \"json_object\" },\n};\nconst PROMPT_VERSION = 3;\nconst TIMEOUT_MS = 30_000;\n/** About 8k tokens of guidelines: a brand document is shorter, and a runaway one is cut. */\nconst BRAND_MD_CHARS = 32_000;\nconst NOTE_CHARS = 600;\n/** A company profile states its name at the top. */\nconst COMPANY_MD_CHARS = 4_000;\n\nconst Font = z.object({\n  family: z.string().trim().min(1).max(60),\n  role: z.enum([\"heading\", \"body\", \"any\"]).catch(\"any\"),\n  use: z.boolean(),\n});\nconst Color = z.object({\n  hex: z\n    .string()\n    .trim()\n    .regex(/^#?[0-9a-fA-F]{6}$/)\n    .transform((h) => `#${h.replace(/^#/, \"\").toLowerCase()}`),\n  use: z.boolean(),\n});\nconst note = z.string().trim().min(1).max(NOTE_CHARS).nullable().optional().catch(null);\nconst Reading = z.object({\n  name: z.string().trim().min(1).max(80).nullable().catch(null),\n  wordmark: z.array(z.string().trim().min(1).max(40)).catch([]),\n  logoNames: z.array(z.string().trim().min(1).max(40)).catch([]),\n  fonts: z.array(z.unknown()).catch([]),\n  colors: z.array(z.unknown()).catch([]),\n  voice: note,\n  imagery: note,\n  logoUsage: note,\n});\n\nexport type BrandDocReading = {\n  name?: string;\n  /** The words the brand's logo prints, as the documents quote them or a logo file names a product. */\n  wordmark: string[];\n  fonts: Array<z.infer<typeof Font>>;\n  colors: Array<z.infer<typeof Color>>;\n  /** How the brand speaks, in the documents' words. */\n  voice?: string;\n  /** What its pictures look like and never look like. */\n  imagery?: string;\n  /** Which logo an ad uses and how it must appear. */\n  logoUsage?: string;\n};\n\nexport type BrandDocs = { brandMd?: string | null; companyMd?: string | null; logoFiles?: readonly string[] };\n\nfunction brandDocPrompt(docs: BrandDocs): string {\n  return [\n    \"You read a company's brand guidelines (BRAND.md), the start of its company profile (COMPANY.md) and the file names of its logos. They may be written in any language, or several. Extract only what they state; never invent a value.\",\n    \"\",\n    \"Return JSON only, in this shape:\",\n    '{\"name\": string | null, \"wordmark\": string[], \"logoNames\": string[], \"fonts\": [{\"family\": string, \"role\": \"heading\" | \"body\" | \"any\", \"use\": boolean}], \"colors\": [{\"hex\": \"#rrggbb\", \"use\": boolean}], \"voice\": string | null, \"imagery\": string | null, \"logoUsage\": string | null}',\n    \"\",\n    '- name: the brand\\'s name exactly as written (\"# Zernio Brand Guidelines\" names Zernio). null when neither document states one, as in an unfilled template (\"# Brand Guidelines\", \"# Company\", TODO).',\n    '- wordmark: every word the documents say the logo prints, as they quote it (\"Wordmark: \\\\\"permut\\\\\"\" gives \"permut\"; \\'symbol plus \"Cubbo\" wordmark\\' gives \"Cubbo\"), even when it is also the name. [] when they quote none.',\n    '- logoNames: a product or brand name a logo file name carries (\"logo-engage-blue.png\" gives \"Engage\"). Colours, variants, sizes and formats (dark, white, icon, isotype, png) are not names. [] when none.',\n    '- fonts: every typeface the guidelines name, by its family name exactly, the banned ones included. role is heading, body, or any when they do not say. use is false when the guidelines ban it, forbid it or say to avoid it or never use it, in any wording or language; true when the brand uses it. Only a named typeface counts: a generic family (sans-serif, serif, monospace, system-ui) or the operating system\\'s own fonts (\"system stack\", \"system fonts\") is not one, so leave it out.',\n    \"- colors: every hex colour the guidelines give. use is false when they ban it or say to avoid it, true when it is a brand colour.\",\n    \"- voice: how the brand speaks, as the guidelines put it, at most two sentences in their language. null when they do not say.\",\n    \"- imagery: what the brand's pictures look like and never look like (photography, illustration, people; a ```generation-style block says it too), at most two sentences in their language. null when they do not say.\",\n    \"- logoUsage: which logo file an ad uses and how it must appear (which file for which product, line or background, what never to do to it), at most two sentences in their language. null when they do not say.\",\n    \"\",\n    \"<brand_md>\",\n    (docs.brandMd ?? \"\").slice(0, BRAND_MD_CHARS),\n    \"</brand_md>\",\n    \"<company_md>\",\n    (docs.companyMd ?? \"\").slice(0, COMPANY_MD_CHARS),\n    \"</company_md>\",\n    \"<logo_files>\",\n    (docs.logoFiles ?? []).join(\"\\n\"),\n    \"</logo_files>\",\n  ].join(\"\\n\");\n}\n\n/** The model's answer as a reading, every entry it got wrong dropped; null when it is not one. Pure. */\nexport function parseBrandDoc(answer: unknown): BrandDocReading | null {\n  const parsed = Reading.safeParse(answer);\n  if (!parsed.success) return null;\n  const fonts = parsed.data.fonts.flatMap((f) => {\n    const font = Font.safeParse(f);\n    return font.success ? [font.data] : [];\n  });\n  const colors = parsed.data.colors.flatMap((c) => {\n    const color = Color.safeParse(c);\n    return color.success ? [color.data] : [];\n  });\n  const { voice, imagery, logoUsage } = parsed.data;\n  return {\n    ...(parsed.data.name ? { name: parsed.data.name } : {}),\n    wordmark: [...new Set([...parsed.data.wordmark, ...parsed.data.logoNames])],\n    fonts,\n    colors,\n    ...(voice ? { voice } : {}),\n    ...(imagery ? { imagery } : {}),\n    ...(logoUsage ? { logoUsage } : {}),\n  };\n}\n\n/** Reads the documents with the model, or null when it could not answer. */\nexport type ReadBrandDocs = (docs: BrandDocs) => Promise<BrandDocReading | null>;\n\n/**\n * The real reader: each reading kept in `cacheDir` by the documents, the model and the prompt.\n * Spend goes to `onSpend`, or, without one, waits in `cacheDir` for the workspace's next run\n * record to bill it.\n */\nexport function brandDocReader(cacheDir: string, onSpend?: (usage: ReviewUsage) => void): ReadBrandDocs {\n  return async (docs) => {\n    const prompt = brandDocPrompt(docs);\n    const key = createHash(\"sha256\")\n      .update(JSON.stringify([PROMPT_VERSION, BRAND_DOC_MODEL, prompt]))\n      .digest(\"hex\");\n    const file = path.join(cacheDir, \"brand-doc\", `${key}.json`);\n    const cached = parseBrandDoc(await readFile(file, \"utf8\").then(JSON.parse, () => null));\n    if (cached) return cached;\n    const spent: ReviewUsage[] = [];\n    const answer = await askAboutText(BRAND_DOC_MODEL, prompt, (u) => (onSpend ? onSpend(u) : spent.push(u)), {\n      timeoutMs: TIMEOUT_MS,\n      request: REQUEST,\n    }).catch(() => null);\n    await holdUnbilledSpend(cacheDir, spent).catch(() => undefined);\n    const reading = parseBrandDoc(answer);\n    if (reading) {\n      await mkdir(path.dirname(file), { recursive: true }).catch(() => undefined);\n      await writeFile(file, JSON.stringify(reading), \"utf8\").catch(() => undefined);\n    }\n    return reading;\n  };\n}\n\n/** A file named as the brand's own logo; a partner's or a tool's icon (`python-icon.png`) is not. */\nexport const LOGO_FILE = /logo|lockup|wordmark|isotype|isologo/i;\n\n/** BRAND.md, COMPANY.md and the brand's own logo file names in a workspace. Never throws. */\nasync function workspaceBrandDocs(root: string): Promise<BrandDocs> {\n  const read = (rel: string) => readFile(path.join(root, rel), \"utf8\").catch(() => null);\n  const logoFiles = ((await readdir(path.join(root, \"src\", \"brand\", \"logos\")).catch(() => [])) as string[])\n    .filter((f) => /\\.(png|jpe?g|webp|svg)$/i.test(f) && LOGO_FILE.test(f))\n    .sort();\n  return { brandMd: await read(\"src/brand/BRAND.md\"), companyMd: await read(\"COMPANY.md\"), logoFiles };\n}\n\n/**\n * What the workspace's brand documents state, read once per edit. Null when there is nothing to\n * read, or no model could read it: every caller then uses what code can read without one.\n */\nexport async function readWorkspaceBrandDoc(\n  root: string,\n  opts: { read?: ReadBrandDocs; onSpend?: (usage: ReviewUsage) => void } = {},\n): Promise<BrandDocReading | null> {\n  const docs = await workspaceBrandDocs(root);\n  if (!docs.brandMd?.trim() && !docs.companyMd?.trim()) return null;\n  const read = opts.read ?? brandDocReader(path.join(root, \"canvas\", \".cache\"), opts.onSpend);\n  return await read(docs).catch(() => null);\n}\n"],"mappings":"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","names":[]}