@koda-sl/baker-cli 0.571.0-dev.6a3439a0a → 0.572.0-dev.61ba69c66

package/dist/add-KHY3H54G.js

@@ -0,0 +1,81 @@
+import {
+  PLATFORM_NAMES,
+  reportError
+} from "./chunk-6LNCKT6S.js";
+import {
+  apiPost
+} from "./chunk-UUDWZIDC.js";
+import "./chunk-S4V2GOKV.js";
+import "./chunk-6LUDG5AB.js";
+import {
+  brandAccountInput,
+  registerSchema,
+  writeJson
+} from "./chunk-6V4UAC5I.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/add.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.add",
+  description: "Add a brand to Baker's ads library WITHOUT following it: every account its website links, on every platform (Meta, LinkedIn, TikTok, Google Ads) and in every country, collected into the library so `profile`, `ads` and `landings` can read it. Nobody follows it and it never shows in anyone's feed. For a brand you study rather than track \u2014 above all a client being set up, from an organization's workspace. Start here: baker winning-ads advertisers \"<domain>\"; when the brand is not there, baker winning-ads add \"<domain>\". A company's own competitor is `follow`, not this.",
+  args: {
+    input: {
+      type: "string",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    }
+  }
+});
+function readNext(advertiserId) {
+  return `baker winning-ads profile ${advertiserId} (the platforms it runs on, how many ads, its estimated spend, its landing pages), then baker winning-ads ads ${advertiserId} --running running for the creatives and baker winning-ads landings ${advertiserId} --analyse for what each landing sells and how`;
+}
+function addHints(data) {
+  const names = data.suggestions.map((s) => `${s.name} (${PLATFORM_NAMES[s.platform]})`).join(", ");
+  if (data.status === "unconfirmed") {
+    const [first] = data.suggestions;
+    return [
+      `Nothing added: we found no account we're sure is this brand's, only accounts named like it: ${names}. Check each one's ad library, then add the brand's own by its link, e.g. baker winning-ads add "${first ? brandAccountInput(first) : ""}". Or retry with the brand's website.`
+    ];
+  }
+  if (data.status === "ambiguous" || data.advertiser_id === null) {
+    return [
+      "These accounts belong to more than one brand already in the library. Read the one in `candidates` that is this brand (its name and website), with baker winning-ads profile <advertiser_id>."
+    ];
+  }
+  const hints = data.collecting > 0 ? [
+    `Its ads are being collected from ${data.collecting} account${data.collecting === 1 ? "" : "s"}: a few minutes, longer for a big advertiser. Read the other sources meanwhile, then ${readNext(data.advertiser_id)}. An empty profile means they are still arriving.`
+  ] : [`Already in the library. Read ${readNext(data.advertiser_id)}.`];
+  if (data.suggestions.length > 0) {
+    hints.push(
+      `Also found accounts only named like this brand, not added: ${names}. Add one that is its own (another country's page) with baker winning-ads add "<its link>".`
+    );
+  }
+  return hints;
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: `Add a brand's ads to Baker's library without following it, so profile, ads and landings can read them. Example: baker winning-ads add "barkibu.com"`
+  },
+  args: {
+    input: {
+      type: "positional",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiPost("/api/ad-library/add", { input: String(args.input) });
+      writeJson({ ok: true, data, hints: addHints(data) });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addCommand,
+  addHints
+};
+//# sourceMappingURL=add-KHY3H54G.js.map

package/dist/add-MZZLFU3M.js

@@ -0,0 +1,513 @@
+import {
+  loadCandidate
+} from "./chunk-CKIENAAO.js";
+import {
+  rulesView
+} from "./chunk-OW3D63SI.js";
+import {
+  fetchRunRecord
+} from "./chunk-2O5CCKV7.js";
+import {
+  readAllRules
+} from "./chunk-M3IXPK6U.js";
+import {
+  RULES_DIR,
+  RULE_APPLIES,
+  RULE_FOR,
+  RULE_KINDS,
+  RULE_STRENGTHS,
+  parseRuleFile
+} from "./chunk-KPVZ2CZA.js";
+import "./chunk-LGJIJVVH.js";
+import {
+  holdWorkspaceSpend
+} from "./chunk-Q4O7ICAK.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-4CYB33V3.js";
+import {
+  reviewAgainstRules
+} from "./chunk-4LZNCDHU.js";
+import {
+  covers,
+  meetsOn,
+  reviewedRules
+} from "./chunk-OGWCLE4W.js";
+import "./chunk-F3CZFUXZ.js";
+import {
+  askJev
+} from "./chunk-AGL7EWP2.js";
+import "./chunk-XQEHLDGP.js";
+import "./chunk-2B2JFTWI.js";
+import "./chunk-XKYFNMTB.js";
+import "./chunk-YOHGEF2N.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-IMS53EQU.js";
+import {
+  apiPost
+} from "./chunk-UUDWZIDC.js";
+import "./chunk-S4V2GOKV.js";
+import "./chunk-6LUDG5AB.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-6V4UAC5I.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/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,
+    ...rule.for ? { for: rule.for } : {},
+    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/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 reachOf(value) {
+  if (value === void 0) return {};
+  const reach = oneOf(RULE_FOR, value);
+  if (!reach) return null;
+  return reach === "ads" ? {} : { for: reach };
+}
+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 reach = reachOf(f.for);
+  if (!reach) return { error: "--for: ads, landings or all (what the rule holds for)." };
+  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",
+    ...reach,
+    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, every landing, or both, 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?" (or landing).
+Start here: baker rules add --candidate rc-1a2b3c4d          # a rule \`feedback record\` drafted from their words
+  baker rules add --text "No AI-generated people." --strength never --applies cast --people real --quote "<their words>" --slug <ad> --run <r_\u2026>
+  baker rules add --for landings --text "No prices on landings: they go to the sales call." --strength never --applies copy --quote "<their words>"
+The same words as a rule for less (one for ads, now --for all) widen it: that one is retired (data.widens). It is refused when the company already has it where this one would hold (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
+  },
+  for: {
+    type: "string",
+    description: `${RULE_FOR.join(" | ")}: what it holds for (default ads). landings: every page in src/pages/; all: every ad and page`,
+    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: "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.`;
+}
+function savedHint(rule, admission) {
+  if (rule.for === "landings") {
+    return "Saved for every landing from now on: an edit to a page shows it. Tell the person in one line, then run `baker rules check --for landings`: which pages already break it.";
+  }
+  const untested = admission.origin === "untested" ? " (not tested on a version: nothing a picture shows decides it, or the version had no picture)" : "";
+  const check = rule.for === "all" ? "`baker rules check` and `baker rules check --for landings`: which ads and pages already made break it" : "`baker rules check`: which ads already made break it";
+  return `Saved for every ad${rule.for === "all" ? " and every landing" : ""} from now on${untested}. Tell the person in one line, then run ${check}.`;
+}
+function sameTaught(rule, same) {
+  const taught = same.filter((r) => r.origin === "learned");
+  return { repeats: taught.filter((r) => covers(r, rule)), widens: taught.filter((r) => !covers(r, rule)) };
+}
+var admitted = (rule) => rule.for === "landings" ? Promise.resolve({ origin: "untested", approved: { checked: 0, blocked: [] } }) : admit(rule);
+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),
+          for: text(args.for),
+          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.filter((r) => meetsOn(rule, r))
+    );
+    const { repeats, widens } = sameTaught(rule, compared.same);
+    if (repeats.length > 0) {
+      fail(
+        "DUPLICATE_RULE",
+        `The company already has this rule: ${repeats.map((r) => `${r.id} ("${r.text}")`).join("; ")}.`,
+        "Nothing to add. If the person wants it worded otherwise, retire that one and add this."
+      );
+    }
+    const widening = new Set(widens.map((r) => r.id));
+    const conflicts = compared.conflicts.filter(
+      (r) => r.origin === "learned" && r.id !== replaces && !widening.has(r.id)
+    );
+    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 admitted(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 widened = (await Promise.all(widens.map((r) => retireFile(root, r.id, rule.id)))).flatMap(
+      (r) => r ? [r.id] : []
+    );
+    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 } : {},
+        ...widened.length > 0 ? { widens: widened } : {}
+      },
+      hints: [
+        savedHint(rule, admission),
+        ...widened.length > 0 ? [
+          `It widens ${widened.join(", ")} (the same rule, for less): retired, never deleted; this one holds there now.`
+        ] : [],
+        ...compared.judged ? [] : [
+          "Whether it repeats or contradicts another rule could not be read (the decision model did not answer): look at `baker 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 or landing is held to it.
+Start here: baker 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 rules list`)", required: true },
+  by: { type: "string", description: "What replaces it: another rule's id, or BRAND.md", required: false }
+};
+registerSchema({ command: "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 rules list --all`.");
+    writeJson({
+      ok: true,
+      data: { rule: rulesView([retired], { full: true })[0] },
+      hints: ["Retired: no ad or landing is held to it from now on."]
+    });
+  }
+});
+export {
+  brandMdHint,
+  compareHoldingSpend,
+  ruleFromInputs,
+  rulesAddCommand,
+  rulesRetireCommand,
+  sameTaught,
+  savedHint
+};
+//# sourceMappingURL=add-MZZLFU3M.js.map