@koda-sl/baker-cli 0.489.0 → 0.491.0

package/dist/chunk-SGEPZB3D.js

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

package/dist/chunk-SVAB6KV5.js

@@ -0,0 +1,219 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  numberFlag,
+  requireTarget,
+  stageOp,
+  stageOps
+} from "./chunk-5C35OW7L.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  registerSchema
+} from "./chunk-WNSE7N75.js";
+
+// src/commands/ads/meta/asset-writes.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads meta draft`.";
+var accountArg = { type: "string", description: "Meta ad account ID (act_123)" };
+var schemaId = (what) => ({ type: "positional", description: what, required: true });
+function command(input) {
+  registerSchema({
+    command: input.schema,
+    description: input.schemaDescription,
+    args: Object.fromEntries(
+      Object.entries(input.args).map(([key, arg]) => [
+        key,
+        { type: arg.type, description: arg.description, required: arg.required === true }
+      ])
+    )
+  });
+  return defineCommand({
+    meta: { name: input.name, description: `${input.description} ${STAGED_NOTE}` },
+    args: input.args,
+    run: async ({ args, rawArgs }) => {
+      await input.run(args, rawArgs);
+    }
+  });
+}
+var creativesDeleteCommand = command({
+  schema: "ads.meta.creatives.delete",
+  name: "delete",
+  description: "Stage deleting an ad creative. Meta deletes only a creative no ad runs \u2014 repoint or delete the ad first. Permanent.",
+  schemaDescription: "Stage deleting a Meta ad creative (status DELETED) \u2014 applied at publish, permanent. Meta refuses a creative an ad still runs.",
+  args: { id: { type: "positional", description: "Creative id", required: true }, "account-id": accountArg },
+  run: async (args) => {
+    await stageOp({
+      kind: "adCreative.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "creative"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+var mediaDeleteCommand = command({
+  schema: "ads.meta.media.delete",
+  name: "delete",
+  description: "Stage taking an image out of the ad account's image library, by its hash (`baker ads meta images`), or one of its videos by id (`--video-id`, from `baker ads meta media`). Meta refuses an image a creative still uses.",
+  schemaDescription: "Stage deleting an image from a Meta ad account's image library by hash, or a video from its video library by id \u2014 applied at publish. Meta refuses an image a creative uses.",
+  args: {
+    "account-id": accountArg,
+    "image-hash": { type: "string", description: "The image's hash" },
+    "video-id": { type: "string", description: "Or a video of the ad account, by id" }
+  },
+  run: async (args) => {
+    const imageHash = typeof args["image-hash"] === "string" ? args["image-hash"] : void 0;
+    const videoId = typeof args["video-id"] === "string" ? args["video-id"] : void 0;
+    if (imageHash === void 0 === (videoId === void 0)) {
+      failWriteValidation("pass --image-hash (from `baker ads meta images`) or --video-id \u2014 one of them");
+    }
+    await stageOp({ kind: "media.delete", accountId: bareAccountId(args), payload: { imageHash, videoId } });
+  }
+});
+var customConversionsUpdateCommand = command({
+  schema: "ads.meta.custom-conversions.update",
+  name: "update",
+  description: "Stage renaming a Custom Conversion, its description or its value per conversion. Meta keeps a conversion's rule and event category for good \u2014 a conversion that counts something else is a new one.",
+  schemaDescription: "Stage a change to a Meta Custom Conversion: --name, --description, --value (value per conversion, account currency). The rule and event category cannot change (Meta accepts and ignores them).",
+  args: {
+    id: { type: "positional", description: "Custom conversion id", required: true },
+    "account-id": accountArg,
+    name: { type: "string", description: "New name" },
+    description: { type: "string", description: "New description" },
+    value: { type: "string", description: "Value of one conversion, in the account currency" }
+  },
+  run: async (args) => {
+    const payload = Object.fromEntries(
+      Object.entries({
+        name: args.name,
+        description: args.description,
+        default_conversion_value: numberFlag(args.value, "--value")
+      }).filter(([, value]) => value !== void 0)
+    );
+    await stageOp({
+      kind: "customConversion.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "custom conversion"),
+      payload
+    });
+  }
+});
+var customConversionsDeleteCommand = command({
+  schema: "ads.meta.custom-conversions.delete",
+  name: "delete",
+  description: "Stage deleting a Custom Conversion. Meta archives it: it stops counting and leaves the active list, and still uses one of the account's slots. Ad sets optimizing toward it stop finding conversions.",
+  schemaDescription: "Stage deleting (archiving) a Meta Custom Conversion \u2014 applied at publish. Not reversible; it keeps its slot in the account's cap.",
+  args: { id: schemaId("Custom conversion id"), "account-id": accountArg },
+  run: async (args) => {
+    await stageOp({
+      kind: "customConversion.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "custom conversion"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+var labelsCreateCommand = command({
+  schema: "ads.meta.labels.create",
+  name: "create",
+  description: 'Stage a new ad label. File things under it with `labels attach <ref> --campaigns \u2026` in the same chat. Example: baker ads meta labels create --name "Q4 launch"',
+  schemaDescription: "Stage a new Meta ad label (created at publish). Returns a meta_temp_* ref `labels attach` takes.",
+  args: { "account-id": accountArg, name: { type: "string", description: "Label name" } },
+  run: async (args) => {
+    await stageOp({ kind: "adLabel.create", accountId: bareAccountId(args), payload: { name: args.name } });
+  }
+});
+var labelsRenameCommand = command({
+  schema: "ads.meta.labels.rename",
+  name: "rename",
+  description: "Stage renaming an ad label.",
+  schemaDescription: "Stage renaming a Meta ad label.",
+  args: { id: schemaId("Label id"), "account-id": accountArg, name: { type: "string", description: "New name" } },
+  run: async (args) => {
+    await stageOp({
+      kind: "adLabel.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "label"),
+      payload: { name: args.name }
+    });
+  }
+});
+var labelsDeleteCommand = command({
+  schema: "ads.meta.labels.delete",
+  name: "delete",
+  description: "Stage deleting an ad label. Everything filed under it keeps running, unlabelled.",
+  schemaDescription: "Stage deleting a Meta ad label \u2014 applied at publish; labelled objects keep running.",
+  args: { id: schemaId("Label id"), "account-id": accountArg },
+  run: async (args) => {
+    await stageOp({
+      kind: "adLabel.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "label"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+var LABELLED = [
+  ["campaigns", "campaign.update"],
+  ["adsets", "adSet.update"],
+  ["ads", "ad.update"],
+  ["creatives", "adCreative.update"]
+];
+var targetArgs = {
+  campaigns: { type: "string", description: "Campaign ids (comma-separated or repeated)" },
+  adsets: { type: "string", description: "Ad set ids" },
+  ads: { type: "string", description: "Ad ids" },
+  creatives: {
+    type: "string",
+    description: "Creative ids (live ones \u2014 a creative created in this chat is labelled later)"
+  }
+};
+function idsOf(rawArgs, flag, parsed) {
+  return repeatedValues(rawArgs, flag, parsed).flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean);
+}
+async function stageLabelChange(verb, args, rawArgs) {
+  const accountId = bareAccountId(args);
+  const label = requireTarget(args, "label");
+  const targets = LABELLED.flatMap(([flag, kind]) => idsOf(rawArgs, flag, args[flag]).map((id) => ({ kind, id })));
+  if (targets.length === 0) {
+    failWriteValidation("name what to label: --campaigns, --adsets, --ads or --creatives");
+  }
+  await stageOps(
+    targets.map((target) => ({ kind: target.kind, accountId, target: target.id, payload: { [verb]: [label] } }))
+  );
+}
+var labelsAttachCommand = command({
+  schema: "ads.meta.labels.attach",
+  name: "attach",
+  description: "Stage filing campaigns, ad sets, ads or creatives under a label (a label id, or a meta_temp_* ref from `labels create`). Their other labels stay. Example: baker ads meta labels attach 120249 --campaigns 6123,6124",
+  schemaDescription: "Stage adding a Meta ad label to campaigns/ad sets/ads/creatives (--campaigns, --adsets, --ads, --creatives; comma-separated). One staged change per object; other labels kept.",
+  args: { id: schemaId("Label id or meta_temp_* ref"), "account-id": accountArg, ...targetArgs },
+  run: async (args, rawArgs) => {
+    await stageLabelChange("addLabels", args, rawArgs);
+  }
+});
+var labelsDetachCommand = command({
+  schema: "ads.meta.labels.detach",
+  name: "detach",
+  description: "Stage taking a label off campaigns, ad sets, ads or creatives. Their other labels stay.",
+  schemaDescription: "Stage removing a Meta ad label from campaigns/ad sets/ads/creatives (--campaigns, --adsets, --ads, --creatives). Other labels kept.",
+  args: { id: schemaId("Label id"), "account-id": accountArg, ...targetArgs },
+  run: async (args, rawArgs) => {
+    await stageLabelChange("removeLabels", args, rawArgs);
+  }
+});
+
+export {
+  command,
+  creativesDeleteCommand,
+  mediaDeleteCommand,
+  customConversionsUpdateCommand,
+  customConversionsDeleteCommand,
+  labelsCreateCommand,
+  labelsRenameCommand,
+  labelsDeleteCommand,
+  labelsAttachCommand,
+  labelsDetachCommand
+};
+//# sourceMappingURL=chunk-SVAB6KV5.js.map

package/dist/chunk-SVAB6KV5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/asset-writes.ts"],"sourcesContent":["import { type ArgsDef, type CommandDef, defineCommand } from \"citty\";\nimport { repeatedValues } from \"../../../lib/repeatedFlags.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { bareAccountId, failWriteValidation, numberFlag, requireTarget, stageOp, stageOps } from \"./write-shared.ts\";\n\n/**\n * Staged writes on the account's own assets: deleting a creative or an image,\n * changing or deleting a Custom Conversion, and ad labels — creating, renaming,\n * deleting them, and filing campaigns, ad sets, ads and creatives under them.\n * Nothing reaches Meta until the chat publishes.\n */\n\nconst STAGED_NOTE = \"Staged until publish — review with `baker ads meta draft`.\";\nconst accountArg = { type: \"string\", description: \"Meta ad account ID (act_123)\" } as const;\nconst schemaId = (what: string) => ({ type: \"positional\", description: what, required: true });\n\nexport function command(input: {\n  schema: string;\n  name: string;\n  description: string;\n  schemaDescription: string;\n  args: Record<string, { type: string; description: string; required?: boolean }>;\n  run: (args: Record<string, unknown>, rawArgs: readonly string[] | undefined) => Promise<void>;\n}): CommandDef<ArgsDef> {\n  registerSchema({\n    command: input.schema,\n    description: input.schemaDescription,\n    args: Object.fromEntries(\n      Object.entries(input.args).map(([key, arg]) => [\n        key,\n        { type: arg.type, description: arg.description, required: arg.required === true },\n      ]),\n    ),\n  });\n  return defineCommand<ArgsDef>({\n    meta: { name: input.name, description: `${input.description} ${STAGED_NOTE}` },\n    args: input.args as ArgsDef,\n    run: async ({ args, rawArgs }) => {\n      await input.run(args as Record<string, unknown>, rawArgs);\n    },\n  });\n}\n\n// --- Creatives ---\n\nexport const creativesDeleteCommand = command({\n  schema: \"ads.meta.creatives.delete\",\n  name: \"delete\",\n  description:\n    \"Stage deleting an ad creative. Meta deletes only a creative no ad runs — repoint or delete the ad first. Permanent.\",\n  schemaDescription:\n    \"Stage deleting a Meta ad creative (status DELETED) — applied at publish, permanent. Meta refuses a creative an ad still runs.\",\n  args: { id: { type: \"positional\", description: \"Creative id\", required: true }, \"account-id\": accountArg },\n  run: async (args) => {\n    await stageOp({\n      kind: \"adCreative.update\",\n      accountId: bareAccountId(args),\n      target: requireTarget(args, \"creative\"),\n      payload: { status: \"DELETED\" },\n    });\n  },\n});\n\n// --- Images ---\n\nexport const mediaDeleteCommand = command({\n  schema: \"ads.meta.media.delete\",\n  name: \"delete\",\n  description:\n    \"Stage taking an image out of the ad account's image library, by its hash (`baker ads meta images`), or one of its videos by id (`--video-id`, from `baker ads meta media`). Meta refuses an image a creative still uses.\",\n  schemaDescription:\n    \"Stage deleting an image from a Meta ad account's image library by hash, or a video from its video library by id — applied at publish. Meta refuses an image a creative uses.\",\n  args: {\n    \"account-id\": accountArg,\n    \"image-hash\": { type: \"string\", description: \"The image's hash\" },\n    \"video-id\": { type: \"string\", description: \"Or a video of the ad account, by id\" },\n  },\n  run: async (args) => {\n    const imageHash = typeof args[\"image-hash\"] === \"string\" ? args[\"image-hash\"] : undefined;\n    const videoId = typeof args[\"video-id\"] === \"string\" ? args[\"video-id\"] : undefined;\n    if ((imageHash === undefined) === (videoId === undefined)) {\n      failWriteValidation(\"pass --image-hash (from `baker ads meta images`) or --video-id — one of them\");\n    }\n    await stageOp({ kind: \"media.delete\", accountId: bareAccountId(args), payload: { imageHash, videoId } });\n  },\n});\n\n// --- Custom conversions ---\n\nexport const customConversionsUpdateCommand = command({\n  schema: \"ads.meta.custom-conversions.update\",\n  name: \"update\",\n  description:\n    \"Stage renaming a Custom Conversion, its description or its value per conversion. Meta keeps a conversion's rule and event category for good — a conversion that counts something else is a new one.\",\n  schemaDescription:\n    \"Stage a change to a Meta Custom Conversion: --name, --description, --value (value per conversion, account currency). The rule and event category cannot change (Meta accepts and ignores them).\",\n  args: {\n    id: { type: \"positional\", description: \"Custom conversion id\", required: true },\n    \"account-id\": accountArg,\n    name: { type: \"string\", description: \"New name\" },\n    description: { type: \"string\", description: \"New description\" },\n    value: { type: \"string\", description: \"Value of one conversion, in the account currency\" },\n  },\n  run: async (args) => {\n    const payload = Object.fromEntries(\n      Object.entries({\n        name: args.name,\n        description: args.description,\n        default_conversion_value: numberFlag(args.value, \"--value\"),\n      }).filter(([, value]) => value !== undefined),\n    );\n    await stageOp({\n      kind: \"customConversion.update\",\n      accountId: bareAccountId(args),\n      target: requireTarget(args, \"custom conversion\"),\n      payload,\n    });\n  },\n});\n\nexport const customConversionsDeleteCommand = command({\n  schema: \"ads.meta.custom-conversions.delete\",\n  name: \"delete\",\n  description:\n    \"Stage deleting a Custom Conversion. Meta archives it: it stops counting and leaves the active list, and still uses one of the account's slots. Ad sets optimizing toward it stop finding conversions.\",\n  schemaDescription:\n    \"Stage deleting (archiving) a Meta Custom Conversion — applied at publish. Not reversible; it keeps its slot in the account's cap.\",\n  args: { id: schemaId(\"Custom conversion id\"), \"account-id\": accountArg },\n  run: async (args) => {\n    await stageOp({\n      kind: \"customConversion.update\",\n      accountId: bareAccountId(args),\n      target: requireTarget(args, \"custom conversion\"),\n      payload: { status: \"DELETED\" },\n    });\n  },\n});\n\n// --- Labels ---\n\nexport const labelsCreateCommand = command({\n  schema: \"ads.meta.labels.create\",\n  name: \"create\",\n  description:\n    'Stage a new ad label. File things under it with `labels attach <ref> --campaigns …` in the same chat. Example: baker ads meta labels create --name \"Q4 launch\"',\n  schemaDescription: \"Stage a new Meta ad label (created at publish). Returns a meta_temp_* ref `labels attach` takes.\",\n  args: { \"account-id\": accountArg, name: { type: \"string\", description: \"Label name\" } },\n  run: async (args) => {\n    await stageOp({ kind: \"adLabel.create\", accountId: bareAccountId(args), payload: { name: args.name } });\n  },\n});\n\nexport const labelsRenameCommand = command({\n  schema: \"ads.meta.labels.rename\",\n  name: \"rename\",\n  description: \"Stage renaming an ad label.\",\n  schemaDescription: \"Stage renaming a Meta ad label.\",\n  args: { id: schemaId(\"Label id\"), \"account-id\": accountArg, name: { type: \"string\", description: \"New name\" } },\n  run: async (args) => {\n    await stageOp({\n      kind: \"adLabel.update\",\n      accountId: bareAccountId(args),\n      target: requireTarget(args, \"label\"),\n      payload: { name: args.name },\n    });\n  },\n});\n\nexport const labelsDeleteCommand = command({\n  schema: \"ads.meta.labels.delete\",\n  name: \"delete\",\n  description: \"Stage deleting an ad label. Everything filed under it keeps running, unlabelled.\",\n  schemaDescription: \"Stage deleting a Meta ad label — applied at publish; labelled objects keep running.\",\n  args: { id: schemaId(\"Label id\"), \"account-id\": accountArg },\n  run: async (args) => {\n    await stageOp({\n      kind: \"adLabel.update\",\n      accountId: bareAccountId(args),\n      target: requireTarget(args, \"label\"),\n      payload: { status: \"DELETED\" },\n    });\n  },\n});\n\nconst LABELLED = [\n  [\"campaigns\", \"campaign.update\"],\n  [\"adsets\", \"adSet.update\"],\n  [\"ads\", \"ad.update\"],\n  [\"creatives\", \"adCreative.update\"],\n] as const;\n\nconst targetArgs = {\n  campaigns: { type: \"string\", description: \"Campaign ids (comma-separated or repeated)\" },\n  adsets: { type: \"string\", description: \"Ad set ids\" },\n  ads: { type: \"string\", description: \"Ad ids\" },\n  creatives: {\n    type: \"string\",\n    description: \"Creative ids (live ones — a creative created in this chat is labelled later)\",\n  },\n} as const;\n\nfunction idsOf(rawArgs: readonly string[] | undefined, flag: string, parsed: unknown): string[] {\n  return repeatedValues(rawArgs, flag, parsed)\n    .flatMap((value) => value.split(\",\"))\n    .map((value) => value.trim())\n    .filter(Boolean);\n}\n\n/**\n * One staged update per object. Each names only the label to add or take\n * away; staging reads the labels the object has now and stages the whole set,\n * because Meta replaces an object's labels with the set it is sent.\n */\nasync function stageLabelChange(\n  verb: \"addLabels\" | \"removeLabels\",\n  args: Record<string, unknown>,\n  rawArgs: readonly string[] | undefined,\n): Promise<void> {\n  const accountId = bareAccountId(args);\n  const label = requireTarget(args, \"label\");\n  const targets = LABELLED.flatMap(([flag, kind]) => idsOf(rawArgs, flag, args[flag]).map((id) => ({ kind, id })));\n  if (targets.length === 0) {\n    failWriteValidation(\"name what to label: --campaigns, --adsets, --ads or --creatives\");\n  }\n  await stageOps(\n    targets.map((target) => ({ kind: target.kind, accountId, target: target.id, payload: { [verb]: [label] } })),\n  );\n}\n\nexport const labelsAttachCommand = command({\n  schema: \"ads.meta.labels.attach\",\n  name: \"attach\",\n  description:\n    \"Stage filing campaigns, ad sets, ads or creatives under a label (a label id, or a meta_temp_* ref from `labels create`). Their other labels stay. Example: baker ads meta labels attach 120249 --campaigns 6123,6124\",\n  schemaDescription:\n    \"Stage adding a Meta ad label to campaigns/ad sets/ads/creatives (--campaigns, --adsets, --ads, --creatives; comma-separated). One staged change per object; other labels kept.\",\n  args: { id: schemaId(\"Label id or meta_temp_* ref\"), \"account-id\": accountArg, ...targetArgs },\n  run: async (args, rawArgs) => {\n    await stageLabelChange(\"addLabels\", args, rawArgs);\n  },\n});\n\nexport const labelsDetachCommand = command({\n  schema: \"ads.meta.labels.detach\",\n  name: \"detach\",\n  description: \"Stage taking a label off campaigns, ad sets, ads or creatives. Their other labels stay.\",\n  schemaDescription:\n    \"Stage removing a Meta ad label from campaigns/ad sets/ads/creatives (--campaigns, --adsets, --ads, --creatives). Other labels kept.\",\n  args: { id: schemaId(\"Label id\"), \"account-id\": accountArg, ...targetArgs },\n  run: async (args, rawArgs) => {\n    await stageLabelChange(\"removeLabels\", args, rawArgs);\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/chunk-TFTZDWCX.js

@@ -0,0 +1,66 @@
+import {
+  recordIdeaLines
+} from "./chunk-ZEPUDYPL.js";
+import {
+  anchorLines,
+  readIdeaAnchor
+} from "./chunk-YLYXSJ6O.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-23H4ZJRP.js";
+
+// src/commands/creatives/idea-hint.ts
+import path from "path";
+function present(fields) {
+  const said = Object.entries(fields).filter(([, v]) => v !== void 0 && !(Array.isArray(v) && v.length === 0));
+  return Object.fromEntries(said);
+}
+function anchorOut(view, full) {
+  const reference = view.reference ? {
+    ...present({ adId: view.reference.adId, advertiser: view.advertiser }),
+    carry: view.reference.carry,
+    mustKeep: view.reference.mustKeep
+  } : void 0;
+  const compact = present({
+    message: view.message,
+    language: view.language,
+    reference,
+    seriesLead: view.seriesLead,
+    accent: view.accent,
+    cast: view.cast,
+    who: view.who,
+    survives: view.survives
+  });
+  if (!full) return compact;
+  return {
+    ...compact,
+    ...present({ why: view.why, voices: view.voices, voiceIds: view.voiceIds, route: view.route }),
+    changes: view.changes
+  };
+}
+function ideaHint(view) {
+  return `Its idea: ${anchorLines(view).join(" \xB7 ").replace(
+    /[.!?…]+$/u,
+    ""
+  )}. An edit keeps it: change exactly what they named; a change of the idea they asked for is one line under "## Changes" in _definition.md, the reason after the dash.`;
+}
+function withAnchor(response, view, opts) {
+  return {
+    ...response,
+    data: { ...response.data, anchor: anchorOut(view, opts.full) },
+    hints: [ideaHint(view), ...response.hints ?? []]
+  };
+}
+async function readCreativeIdea(slug) {
+  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+  const read = await readIdeaAnchor(path.join(root, "src", "creatives", slug));
+  if (!read) return null;
+  await recordIdeaLines(path.join(root, "canvas"), slug, anchorLines(read.view)).catch(() => void 0);
+  return read.view;
+}
+
+export {
+  withAnchor,
+  readCreativeIdea
+};
+//# sourceMappingURL=chunk-TFTZDWCX.js.map