@koda-sl/baker-cli 0.496.0 → 0.497.0

package/dist/rules-VK7YA23Q.js

@@ -0,0 +1,97 @@
+import {
+  readCreativeSpecs,
+  rulesHints,
+  rulesView,
+  waiverCounts
+} from "./chunk-QVQKCVP7.js";
+import {
+  readAllRules
+} from "./chunk-VNU2EYD4.js";
+import "./chunk-Y46FE75E.js";
+import "./chunk-3S274625.js";
+import "./chunk-UFKO626N.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-XRIM7NYV.js";
+import {
+  selectRules
+} from "./chunk-S4VLLGTW.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-U7YR5CZL.js";
+import "./chunk-VI5YQQ63.js";
+import "./chunk-JX7BX2NB.js";
+import "./chunk-O37VU7FG.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/rules.ts
+import { defineCommand } from "citty";
+var LIST_DESCRIPTION = `The company's standing rules for every ad: the brand's own (BRAND.md) and the ones a person taught, each with its id, strength (never | must | prefer), what it is about, its words, the person's own words and where it came from. \`baker creatives brief\` carries them too.
+Start here: baker creatives rules list
+  baker creatives rules list --kind video --product cubbo-engage   # the rules one ad is held to
+  baker creatives rules list --all                                 # retired ones and every scope too`;
+var LIST_ARGS = {
+  kind: {
+    type: "string",
+    description: "static | video: only the rules an ad of this kind is held to",
+    required: false
+  },
+  product: {
+    type: "string",
+    description: "A product slug (src/content/products/<slug>.md): only the rules an ad of it is held to",
+    required: false
+  },
+  all: {
+    type: "boolean",
+    description: "Every rule, retired ones and every scope included",
+    required: false,
+    default: false
+  },
+  full: { type: "boolean", description: "Each rule and the person's words whole", required: false, default: false }
+};
+registerSchema({ command: "creatives.rules.list", description: LIST_DESCRIPTION, args: LIST_ARGS });
+var listCommand = defineCommand({
+  meta: { name: "list", description: LIST_DESCRIPTION },
+  args: LIST_ARGS,
+  async run({ args }) {
+    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const kind = args.kind === "static" || args.kind === "video" ? args.kind : void 0;
+    const product = typeof args.product === "string" && args.product ? args.product : void 0;
+    const [rules, specs] = await Promise.all([readAllRules(root), readCreativeSpecs(root)]);
+    const active = selectRules(rules, { ...kind ? { kind } : {}, ...product ? { product } : {} });
+    const shown = args.all === true ? rules : active;
+    const hints = rulesHints(active, waiverCounts(specs));
+    writeJson({
+      ok: true,
+      data: { rules: rulesView(shown, { full: args.full === true }), active: active.length, total: rules.length },
+      ...hints.length > 0 ? { hints } : {}
+    });
+  }
+});
+var rulesCommand = defineCommand({
+  meta: {
+    name: "rules",
+    description: "The company's standing rules for every ad: list them, add one the person agreed to, retire one."
+  },
+  subCommands: {
+    list: listCommand,
+    add: () => import("./rules-add-VG7AT6EG.js").then((m) => m.rulesAddCommand),
+    retire: () => import("./rules-add-VG7AT6EG.js").then((m) => m.rulesRetireCommand)
+  },
+  default: "list"
+});
+export {
+  rulesCommand
+};
+//# sourceMappingURL=rules-VK7YA23Q.js.map

package/dist/rules-VK7YA23Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/rules.ts"],"sourcesContent":["/**\n * `baker creatives rules`: the company's standing rules for every ad. The brand's own come from\n * BRAND.md; the learned ones are what a person taught in a chat, saved only after they said yes,\n * one file each in src/content/creative-rules/. Every ad is made and checked against them.\n */\nimport { defineCommand } from \"citty\";\nimport { readAllRules } from \"../../engine/creative-context/index.ts\";\nimport { selectRules } from \"../../engine/creative-rules/select.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { readCreativeSpecs, rulesHints, rulesView, waiverCounts } from \"./rules-view.ts\";\n\nconst LIST_DESCRIPTION = `The company's standing rules for every ad: the brand's own (BRAND.md) and the ones a person taught, each with its id, strength (never | must | prefer), what it is about, its words, the person's own words and where it came from. \\`baker creatives brief\\` carries them too.\nStart here: baker creatives rules list\n  baker creatives rules list --kind video --product cubbo-engage   # the rules one ad is held to\n  baker creatives rules list --all                                 # retired ones and every scope too`;\n\nconst LIST_ARGS = {\n  kind: {\n    type: \"string\",\n    description: \"static | video: only the rules an ad of this kind is held to\",\n    required: false,\n  },\n  product: {\n    type: \"string\",\n    description: \"A product slug (src/content/products/<slug>.md): only the rules an ad of it is held to\",\n    required: false,\n  },\n  all: {\n    type: \"boolean\",\n    description: \"Every rule, retired ones and every scope included\",\n    required: false,\n    default: false,\n  },\n  full: { type: \"boolean\", description: \"Each rule and the person's words whole\", required: false, default: false },\n} as const;\n\nregisterSchema({ command: \"creatives.rules.list\", description: LIST_DESCRIPTION, args: LIST_ARGS });\n\nconst listCommand = defineCommand({\n  meta: { name: \"list\", description: LIST_DESCRIPTION },\n  args: LIST_ARGS,\n  async run({ args }) {\n    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();\n    const kind = args.kind === \"static\" || args.kind === \"video\" ? args.kind : undefined;\n    const product = typeof args.product === \"string\" && args.product ? args.product : undefined;\n    const [rules, specs] = await Promise.all([readAllRules(root), readCreativeSpecs(root)]);\n    const active = selectRules(rules, { ...(kind ? { kind } : {}), ...(product ? { product } : {}) });\n    const shown = args.all === true ? rules : active;\n    const hints = rulesHints(active, waiverCounts(specs));\n    writeJson({\n      ok: true,\n      data: { rules: rulesView(shown, { full: args.full === true }), active: active.length, total: rules.length },\n      ...(hints.length > 0 ? { hints } : {}),\n    });\n  },\n});\n\nexport const rulesCommand = defineCommand({\n  meta: {\n    name: \"rules\",\n    description: \"The company's standing rules for every ad: list them, add one the person agreed to, retire one.\",\n  },\n  subCommands: {\n    list: listCommand,\n    add: () => import(\"./rules-add.ts\").then((m) => m.rulesAddCommand),\n    retire: () => import(\"./rules-add.ts\").then((m) => m.rulesRetireCommand),\n  },\n  default: \"list\",\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,SAAS,qBAAqB;AAQ9B,IAAM,mBAAmB;AAAA;AAAA;AAAA;AAKzB,IAAM,YAAY;AAAA,EAChB,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,KAAK;AAAA,IACH,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,SAAS;AAAA,EACX;AAAA,EACA,MAAM,EAAE,MAAM,WAAW,aAAa,0CAA0C,UAAU,OAAO,SAAS,MAAM;AAClH;AAEA,eAAe,EAAE,SAAS,wBAAwB,aAAa,kBAAkB,MAAM,UAAU,CAAC;AAElG,IAAM,cAAc,cAAc;AAAA,EAChC,MAAM,EAAE,MAAM,QAAQ,aAAa,iBAAiB;AAAA,EACpD,MAAM;AAAA,EACN,MAAM,IAAI,EAAE,KAAK,GAAG;AAClB,UAAM,OAAO,kBAAkB,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI;AAC7D,UAAM,OAAO,KAAK,SAAS,YAAY,KAAK,SAAS,UAAU,KAAK,OAAO;AAC3E,UAAM,UAAU,OAAO,KAAK,YAAY,YAAY,KAAK,UAAU,KAAK,UAAU;AAClF,UAAM,CAAC,OAAO,KAAK,IAAI,MAAM,QAAQ,IAAI,CAAC,aAAa,IAAI,GAAG,kBAAkB,IAAI,CAAC,CAAC;AACtF,UAAM,SAAS,YAAY,OAAO,EAAE,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC,GAAI,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC,EAAG,CAAC;AAChG,UAAM,QAAQ,KAAK,QAAQ,OAAO,QAAQ;AAC1C,UAAM,QAAQ,WAAW,QAAQ,aAAa,KAAK,CAAC;AACpD,cAAU;AAAA,MACR,IAAI;AAAA,MACJ,MAAM,EAAE,OAAO,UAAU,OAAO,EAAE,MAAM,KAAK,SAAS,KAAK,CAAC,GAAG,QAAQ,OAAO,QAAQ,OAAO,MAAM,OAAO;AAAA,MAC1G,GAAI,MAAM,SAAS,IAAI,EAAE,MAAM,IAAI,CAAC;AAAA,IACtC,CAAC;AAAA,EACH;AACF,CAAC;AAEM,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,KAAK,MAAM,OAAO,yBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACjE,QAAQ,MAAM,OAAO,yBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB;AAAA,EACzE;AAAA,EACA,SAAS;AACX,CAAC;","names":[]}

package/dist/rules-add-VG7AT6EG.js

@@ -0,0 +1,463 @@
+import {
+  loadCandidate
+} from "./chunk-WT4WDIXA.js";
+import {
+  rulesView
+} from "./chunk-QVQKCVP7.js";
+import {
+  fetchRunRecord
+} from "./chunk-7QGFO35A.js";
+import {
+  readAllRules
+} from "./chunk-VNU2EYD4.js";
+import {
+  RULES_DIR,
+  RULE_APPLIES,
+  RULE_KINDS,
+  RULE_STRENGTHS,
+  parseRuleFile
+} from "./chunk-Y46FE75E.js";
+import "./chunk-3S274625.js";
+import {
+  holdWorkspaceSpend
+} from "./chunk-UFKO626N.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-XRIM7NYV.js";
+import {
+  reviewAgainstRules
+} from "./chunk-QMOYQJIN.js";
+import {
+  reviewedRules
+} from "./chunk-S4VLLGTW.js";
+import "./chunk-MCJ5I5LR.js";
+import {
+  askJev
+} from "./chunk-A6WKCV3V.js";
+import "./chunk-U7YR5CZL.js";
+import "./chunk-VI5YQQ63.js";
+import "./chunk-JX7BX2NB.js";
+import "./chunk-O37VU7FG.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/rules-add.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+import sharp from "sharp";
+
+// src/engine/creative-rules/admission.ts
+async function breaks(rule, version, review) {
+  const found = await review(version, [rule]).catch(() => null);
+  return found === null ? null : found.filter((f) => f.kind?.rule === rule.id && f.severity === "blocking");
+}
+async function admissionTest(rule, origin, approved, review) {
+  const untested = { origin: "untested", approved: { checked: 0, blocked: [] } };
+  const tested = { ...rule, strength: rule.strength === "prefer" ? "must" : rule.strength };
+  if (reviewedRules([tested]).length === 0) return untested;
+  const own = origin ? await breaks(tested, origin, review) : null;
+  const results = await Promise.all(
+    approved.map(async (v) => ({ runId: v.runId, found: await breaks(tested, v, review) }))
+  );
+  const looked = results.filter((r) => r.found !== null);
+  return {
+    origin: own === null ? "untested" : own.length > 0 ? "caught" : "missed",
+    approved: {
+      checked: looked.length,
+      blocked: looked.flatMap(
+        (r) => r.found?.[0] ? [{ runId: r.runId, what: r.found[0].what.replace(/^.*?\): /, "") }] : []
+      )
+    }
+  };
+}
+function admissionRefusal(rule, admission) {
+  if (admission.origin === "missed") {
+    return {
+      code: "RULE_MISSES_ITS_AD",
+      message: `Not saved: "${rule.text}" does not catch the version it came from (${rule.source.runId ?? "the rejected one"}), so it is worded for something else.`,
+      fix: "Reword it to name exactly what was wrong on that version, in the person's words, and add it again; or ask the person what the rule is."
+    };
+  }
+  const blocked = admission.approved.blocked;
+  if (blocked.length > 0) {
+    return {
+      code: "RULE_BLOCKS_APPROVED",
+      message: `Not saved: "${rule.text}" would block ${blocked.length} version${blocked.length === 1 ? "" : "s"} the person approved: ${blocked.map((b) => `${b.runId} (${b.what})`).join("; ")}.`,
+      fix: "Ask the person whether those approved ads break it. If they do not, reword the rule so it names only what they reject, and add it again."
+    };
+  }
+  return null;
+}
+
+// src/engine/creative-rules/compare.ts
+var SAME = "Do rules `a` and `b` ask the same thing of an ad, in any words or language, so that an ad keeping one keeps the other?";
+var CONFLICT = "Do rules `a` and `b` contradict each other, so that no ad could keep both: following one breaks the other?";
+var SAME_BAND = 0.6;
+var CONFLICT_BAND = 0.6;
+var BATCH = 40;
+function jevPairs(onSpend) {
+  return async (pairs) => {
+    const answers = [];
+    for (let i = 0; i < pairs.length; i += BATCH) {
+      const batch = pairs.slice(i, i + BATCH);
+      const got = await askJev(
+        batch.map((p) => ({ instructions: { a: p.a, b: p.b, question: p.question === "same" ? SAME : CONFLICT } })),
+        onSpend
+      );
+      if (!got) return null;
+      answers.push(...got);
+    }
+    return answers;
+  };
+}
+async function compareRule(candidate, existing, ask) {
+  const active = existing.filter((r) => r.status === "active" && r.id !== candidate.id);
+  if (active.length === 0) return { same: [], conflicts: [], judged: true };
+  const pairs = active.flatMap((r) => [
+    { a: candidate.text, b: r.text, question: "same" },
+    { a: candidate.text, b: r.text, question: "conflict" }
+  ]);
+  const answers = await ask(pairs).catch(() => null);
+  if (!answers || answers.length !== pairs.length) return { same: [], conflicts: [], judged: false };
+  return {
+    same: active.filter((_, i) => (answers[2 * i] ?? 0) >= SAME_BAND),
+    conflicts: active.filter((_, i) => (answers[2 * i + 1] ?? 0) >= CONFLICT_BAND),
+    judged: true
+  };
+}
+
+// src/engine/creative-rules/write.ts
+import { stringify as stringifyYaml } from "yaml";
+function ruleFileText(rule) {
+  const frontmatter = {
+    strength: rule.strength,
+    applies: rule.applies,
+    ...Object.keys(rule.scope).length > 0 ? { scope: rule.scope } : {},
+    ...rule.check && Object.keys(rule.check).length > 0 ? { check: rule.check } : {},
+    source: rule.source,
+    status: rule.status,
+    ...rule.retiredBy ? { retiredBy: rule.retiredBy } : {}
+  };
+  const yaml = stringifyYaml(frontmatter, { defaultStringType: "QUOTE_DOUBLE", defaultKeyType: "PLAIN", lineWidth: 0 });
+  return `---
+${yaml}---
+${rule.text.trim()}
+${rule.why ? `
+Why: ${rule.why.trim()}
+` : ""}`;
+}
+var SLUG_WORDS = 8;
+function ruleSlug(text2, taken) {
+  const base = text2.normalize("NFKD").replace(new RegExp("\\p{M}", "gu"), "").toLowerCase().replace(/[^a-z0-9]+/g, " ").trim().split(/\s+/).filter(Boolean).slice(0, SLUG_WORDS).join("-") || "rule";
+  if (!taken.includes(base)) return base;
+  let n = 2;
+  while (taken.includes(`${base}-${n}`)) n++;
+  return `${base}-${n}`;
+}
+
+// src/commands/creatives/rules-add.ts
+var oneOf = (values, value) => value && values.includes(value) ? value : void 0;
+var defined = (value) => Object.fromEntries(
+  Object.entries(value).filter(([, v]) => v !== void 0 && !(Array.isArray(v) && v.length === 0))
+);
+function scopeOf(f, c) {
+  return defined({
+    kinds: (f.kinds ?? c?.kinds)?.flatMap((k) => oneOf(RULE_KINDS, k) ?? []),
+    products: f.products,
+    platforms: f.platforms ?? c?.platforms,
+    language: f.language ?? c?.language
+  });
+}
+function checkOf(f, c) {
+  const realPeople = f.people === void 0 ? c?.people === "real" : f.people === "real";
+  return defined({
+    forbid: f.forbid ?? c?.forbid,
+    require: f.require ?? c?.require,
+    allow: f.allow ?? c?.allow,
+    people: realPeople ? "real" : void 0
+  });
+}
+function ruleFromInputs(inputs, at) {
+  const c = inputs.candidate;
+  const f = inputs.flags ?? {};
+  const text2 = (f.text ?? c?.text)?.trim();
+  if (!text2) return { error: "--text: the rule, in the person's words (or --candidate <id> from `feedback record`)." };
+  const check = checkOf(f, c);
+  const source = defined({
+    kind: c ? "feedback" : "user",
+    slug: f.slug ?? c?.source.slug,
+    runId: f.run ?? c?.source.runId,
+    quote: f.quote ?? c?.source.quote,
+    date: at.today
+  });
+  return {
+    id: ruleSlug(f.id ?? text2, at.taken),
+    origin: "learned",
+    strength: oneOf(RULE_STRENGTHS, f.strength) ?? c?.strength ?? "must",
+    applies: oneOf(RULE_APPLIES, f.applies) ?? c?.applies ?? "any",
+    scope: scopeOf(f, c),
+    ...Object.keys(check).length > 0 ? { check } : {},
+    text: text2,
+    ...f.why ? { why: f.why } : {},
+    source,
+    status: "active"
+  };
+}
+async function versionOf(runId) {
+  const record = await fetchRunRecord(runId).catch(() => null);
+  const images = (record?.finalOutputs ?? []).filter((o) => o.kind === "image" && o.url);
+  const stills = await Promise.all(
+    images.map(async (o) => {
+      const response = await fetch(o.url).catch(() => null);
+      if (!response?.ok) return null;
+      const bytes = Buffer.from(await response.arrayBuffer());
+      return (await sharp(bytes).resize({ width: 1024 }).jpeg({ quality: 85 }).toBuffer()).toString("base64");
+    })
+  );
+  const kept = images.flatMap(
+    (o, i) => stills[i] ? [{ still: stills[i], format: o.label ?? "image" }] : []
+  );
+  return kept.length > 0 ? { runId, stills: kept.map((k) => k.still), formats: kept.map((k) => k.format) } : null;
+}
+var APPROVED_VERSIONS = 3;
+async function approvedVersions(except, slug) {
+  const feedback = await apiPost("/api/creatives/feedback", { full: true }).catch(
+    () => null
+  );
+  const approved = (feedback?.data.recent ?? []).filter((e) => e.verdict === "approved" && e.runId !== except);
+  const ordered = [...approved.filter((e) => e.creative !== slug), ...approved.filter((e) => e.creative === slug)];
+  const runIds = [...new Set(ordered.map((e) => e.runId))];
+  const versions = [];
+  for (const runId of runIds) {
+    if (versions.length === APPROVED_VERSIONS) break;
+    const version = await versionOf(runId);
+    if (version) versions.push(version);
+  }
+  return versions;
+}
+async function admit(rule) {
+  const spent = [];
+  const review = (version, rules) => reviewAgainstRules({ ...version, rules, onSpend: (u) => spent.push(u) });
+  const [origin, approved] = await Promise.all([
+    rule.source.runId ? versionOf(rule.source.runId) : Promise.resolve(null),
+    approvedVersions(rule.source.runId, rule.source.slug)
+  ]);
+  const admission = await admissionTest(rule, origin, approved, review);
+  await holdWorkspaceSpend(spent);
+  return admission;
+}
+async function compareHoldingSpend(rule, existing) {
+  const spent = [];
+  try {
+    return await compareRule(
+      rule,
+      existing,
+      jevPairs((u) => spent.push(u))
+    );
+  } finally {
+    await holdWorkspaceSpend(spent);
+  }
+}
+async function retireFile(root, id, by) {
+  const file = path.join(root, RULES_DIR, `${id}.md`);
+  const rule = parseRuleFile(id, await readFile(file, "utf8").catch(() => ""));
+  if (!rule) return null;
+  const retired = { ...rule, status: "retired", ...by ? { retiredBy: by } : {} };
+  await writeFile(file, ruleFileText(retired), "utf8");
+  return retired;
+}
+function fail(code, message, fix, extra = {}) {
+  writeJson({ ok: false, error: { code, message, ...fix ? { fix } : {}, ...extra } });
+  process.exit(1);
+}
+var list = (value) => typeof value === "string" && value.trim() ? value.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+var text = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
+var ADD_DESCRIPTION = `Save a rule the person agreed to, for every ad from now on: one file in src/content/creative-rules/, published with the Session. Only after they said yes to "make this a rule for every ad?".
+Start here: baker creatives rules add --candidate rc-1a2b3c4d          # a rule \`feedback record\` drafted from their words
+  baker creatives rules add --text "No AI-generated people." --strength never --applies cast --people real --quote "<their words>" --slug <ad> --run <r_\u2026>
+It is refused when the company already has it (DUPLICATE_RULE), when it contradicts one (RULE_CONFLICT: ask which wins, then --replaces <id>), when it does not catch the version it came from (RULE_MISSES_ITS_AD), or would block versions the person approved (RULE_BLOCKS_APPROVED): ask the person, never save it anyway.`;
+var ADD_ARGS = {
+  candidate: {
+    type: "string",
+    description: "A rule `feedback record` drafted (rc-\u2026): the flags below override its parts",
+    required: false
+  },
+  text: {
+    type: "string",
+    description: "The rule, one sentence, in the person's own language and words",
+    required: false
+  },
+  strength: {
+    type: "string",
+    description: `${RULE_STRENGTHS.join(" | ")}: never and must are checked and block; prefer is a note`,
+    required: false
+  },
+  applies: { type: "string", description: `What of the ad it is about: ${RULE_APPLIES.join(", ")}`, required: false },
+  forbid: {
+    type: "string",
+    description: 'Words it bans, comma-separated, only when a word decides it ("online")',
+    required: false
+  },
+  allow: { type: "string", description: 'The right phrase that holds a banned word ("100 % online")', required: false },
+  require: { type: "string", description: "Words every ad must say, comma-separated (rare)", required: false },
+  people: {
+    type: "string",
+    description: "real: only real people appear (a real person's Avatar, a customer, footage or nobody)",
+    required: false
+  },
+  kinds: { type: "string", description: "static,video: only ads of these kinds", required: false },
+  products: { type: "string", description: "Product slugs (a business unit): only ads of these", required: false },
+  platforms: { type: "string", description: "meta,linkedin,\u2026: only ads for these", required: false },
+  language: {
+    type: "string",
+    description: "The language its words are in (es): its banned words are checked only in ads in it",
+    required: false
+  },
+  quote: { type: "string", description: "The person's own words it came from, verbatim", required: false },
+  slug: { type: "string", description: "The creative they said it about", required: false },
+  run: { type: "string", description: "The version they said it about (r_\u2026): the rule must catch it", required: false },
+  why: { type: "string", description: "Why, in a sentence, when the person said", required: false },
+  id: { type: "string", description: "The rule's id (its file name); default: from its words", required: false },
+  replaces: {
+    type: "string",
+    description: "A rule of the person's it contradicts and wins over: retired, never deleted",
+    required: false
+  }
+};
+registerSchema({ command: "creatives.rules.add", description: ADD_DESCRIPTION, args: ADD_ARGS });
+function brandMdHint(declared, relation) {
+  return relation === "same" ? `BRAND.md states this too ("${declared.text}"): now the person confirmed it, every finished ad is checked against it.` : `BRAND.md says otherwise ("${declared.text}"): tell the person, and change only that line of BRAND.md (/brand-build) so it no longer says otherwise; never write the rule itself into BRAND.md, or retiring it would leave it in force.`;
+}
+var rulesAddCommand = defineCommand({
+  meta: { name: "add", description: ADD_DESCRIPTION },
+  args: ADD_ARGS,
+  async run({ args }) {
+    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const cacheDir = path.join(root, "canvas", ".cache");
+    const candidateId = text(args.candidate);
+    const candidate = candidateId ? await loadCandidate(cacheDir, candidateId) : void 0;
+    if (candidateId && !candidate) {
+      fail(
+        "VALIDATION_ERROR",
+        `No drafted rule ${candidateId} here.`,
+        "Use the id `feedback record` printed in this chat, or pass --text."
+      );
+    }
+    const all = await readAllRules(root);
+    const rule = ruleFromInputs(
+      {
+        ...candidate ? { candidate } : {},
+        flags: {
+          text: text(args.text),
+          strength: text(args.strength),
+          applies: text(args.applies),
+          forbid: list(args.forbid),
+          allow: list(args.allow),
+          require: list(args.require),
+          people: text(args.people),
+          kinds: list(args.kinds),
+          products: list(args.products),
+          platforms: list(args.platforms),
+          language: text(args.language),
+          quote: text(args.quote),
+          slug: text(args.slug),
+          run: text(args.run),
+          why: text(args.why),
+          id: text(args.id)
+        }
+      },
+      { today: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10), taken: all.map((r) => r.id) }
+    );
+    if ("error" in rule) fail("VALIDATION_ERROR", rule.error);
+    const replaces = text(args.replaces);
+    const compared = await compareHoldingSpend(rule, all);
+    const sameTaught = compared.same.filter((r) => r.origin === "learned");
+    if (sameTaught.length > 0) {
+      fail(
+        "DUPLICATE_RULE",
+        `The company already has this rule: ${sameTaught.map((r) => `${r.id} ("${r.text}")`).join("; ")}.`,
+        "Nothing to add. If the person wants it worded otherwise, retire that one and add this."
+      );
+    }
+    const conflicts = compared.conflicts.filter((r) => r.origin === "learned" && r.id !== replaces);
+    if (conflicts.length > 0) {
+      fail(
+        "RULE_CONFLICT",
+        `It contradicts ${conflicts.map((r) => `${r.id} ("${r.text}")`).join("; ")}.`,
+        "Ask the person which one wins. This one: add it again with --replaces <id> (that rule is retired, never deleted). The other: do not add this one."
+      );
+    }
+    const admission = await admit(rule);
+    const refusal = admissionRefusal(rule, admission);
+    if (refusal) fail(refusal.code, refusal.message, refusal.fix, { admission });
+    await mkdir(path.join(root, RULES_DIR), { recursive: true });
+    const file = path.join(RULES_DIR, `${rule.id}.md`);
+    await writeFile(path.join(root, file), ruleFileText(rule), "utf8");
+    const retired = replaces ? await retireFile(root, replaces, rule.id) : null;
+    const declared = [...compared.same, ...compared.conflicts].filter((r) => r.origin === "declared");
+    writeJson({
+      ok: true,
+      data: {
+        rule: rulesView([rule], { full: true })[0],
+        file,
+        admission,
+        ...retired ? { retired: retired.id } : {}
+      },
+      hints: [
+        `Saved for every ad from now on${admission.origin === "untested" ? " (not tested on a version: nothing a picture shows decides it, or the version had no picture)" : ""}. Tell the person in one line, then run \`baker creatives check\`: which ads already made break it.`,
+        ...compared.judged ? [] : [
+          "Whether it repeats or contradicts another rule could not be read (the decision model did not answer): look at `baker creatives rules list`."
+        ],
+        ...declared.map((r) => brandMdHint(r, compared.same.includes(r) ? "same" : "conflict"))
+      ]
+    });
+  }
+});
+var RETIRE_DESCRIPTION = `Retire a rule a person taught, when they say it no longer holds or another replaces it: it stays in its file as retired, never deleted, and no ad is held to it.
+Start here: baker creatives rules retire cien-por-cien-online [--by <rule id>|BRAND.md]
+A rule of BRAND.md is changed in BRAND.md (/brand-build).`;
+var RETIRE_ARGS = {
+  id: { type: "positional", description: "The rule's id (`baker creatives rules list`)", required: true },
+  by: { type: "string", description: "What replaces it: another rule's id, or BRAND.md", required: false }
+};
+registerSchema({ command: "creatives.rules.retire", description: RETIRE_DESCRIPTION, args: RETIRE_ARGS });
+var rulesRetireCommand = defineCommand({
+  meta: { name: "retire", description: RETIRE_DESCRIPTION },
+  args: RETIRE_ARGS,
+  async run({ args }) {
+    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const id = String(args.id);
+    if (/^brand-[0-9a-f]{8}$/.test(id)) {
+      fail("VALIDATION_ERROR", `${id} is a rule of BRAND.md.`, "Change it in BRAND.md with /brand-build.");
+    }
+    const retired = await retireFile(root, id, text(args.by));
+    if (!retired) fail("NOT_FOUND", `No rule ${id} in ${RULES_DIR}.`, "See `baker creatives rules list --all`.");
+    writeJson({
+      ok: true,
+      data: { rule: rulesView([retired], { full: true })[0] },
+      hints: ["Retired: no ad is held to it from now on."]
+    });
+  }
+});
+export {
+  brandMdHint,
+  compareHoldingSpend,
+  ruleFromInputs,
+  rulesAddCommand,
+  rulesRetireCommand
+};
+//# sourceMappingURL=rules-add-VG7AT6EG.js.map