@koda-sl/baker-cli 0.496.0 → 0.497.0

package/dist/rules-add-VG7AT6EG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/rules-add.ts","../src/engine/creative-rules/admission.ts","../src/engine/creative-rules/compare.ts","../src/engine/creative-rules/write.ts"],"sourcesContent":["/**\n * `baker creatives rules add` and `retire`: a rule a person agreed to, saved for every ad from now\n * on as one file in src/content/creative-rules/ (staged in the Session and published with it), and\n * a rule retired, never deleted. A rule is saved only when it is not one the company already has,\n * contradicts none without the person picking the winner, catches the version it came from and\n * blocks none the person approved.\n */\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { CreativesFeedbackResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport sharp from \"sharp\";\nimport { apiPost } from \"../../client.ts\";\nimport { readAllRules } from \"../../engine/creative-context/index.ts\";\nimport {\n  type Admission,\n  admissionRefusal,\n  admissionTest,\n  type ReviewedVersion,\n} from \"../../engine/creative-rules/admission.ts\";\nimport { type Comparison, compareRule, jevPairs } from \"../../engine/creative-rules/compare.ts\";\nimport { parseRuleFile, RULES_DIR } from \"../../engine/creative-rules/read.ts\";\nimport {\n  type CreativeRule,\n  RULE_APPLIES,\n  RULE_KINDS,\n  RULE_STRENGTHS,\n  type RuleCheck,\n  type RuleScope,\n} from \"../../engine/creative-rules/schema.ts\";\nimport { ruleFileText, ruleSlug } from \"../../engine/creative-rules/write.ts\";\nimport { reviewAgainstRules } from \"../../engine/nodes/local/lib/rules-review.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { fetchRunRecord } from \"../canvas/run-history.ts\";\nimport { holdWorkspaceSpend } from \"../canvas/unbilled-spend.ts\";\nimport { loadCandidate, type SavedCandidate } from \"./rule-candidate.ts\";\nimport { rulesView } from \"./rules-view.ts\";\n\n/** What the flags say of the rule; each overrides the candidate's. */\nexport type RuleFlags = {\n  text?: string;\n  strength?: string;\n  applies?: string;\n  forbid?: string[];\n  require?: string[];\n  allow?: string[];\n  people?: string;\n  kinds?: string[];\n  products?: string[];\n  platforms?: string[];\n  language?: string;\n  quote?: string;\n  slug?: string;\n  run?: string;\n  why?: string;\n  id?: string;\n};\n\nconst oneOf = <T extends string>(values: readonly T[], value: string | undefined): T | undefined =>\n  value && (values as readonly string[]).includes(value) ? (value as T) : undefined;\n\nconst defined = <T extends object>(value: T): T =>\n  Object.fromEntries(\n    Object.entries(value).filter(([, v]) => v !== undefined && !(Array.isArray(v) && v.length === 0)),\n  ) as T;\n\n/** Where the rule holds: the flags over the candidate's. Pure. */\nfunction scopeOf(f: RuleFlags, c: SavedCandidate | undefined): RuleScope {\n  return defined<RuleScope>({\n    kinds: (f.kinds ?? c?.kinds)?.flatMap((k) => oneOf(RULE_KINDS, k) ?? []),\n    products: f.products,\n    platforms: f.platforms ?? c?.platforms,\n    language: f.language ?? c?.language,\n  });\n}\n\n/** What code decides of the rule: the flags over the candidate's. Pure. */\nfunction checkOf(f: RuleFlags, c: SavedCandidate | undefined): RuleCheck {\n  const realPeople = f.people === undefined ? c?.people === \"real\" : f.people === \"real\";\n  return defined<RuleCheck>({\n    forbid: f.forbid ?? c?.forbid,\n    require: f.require ?? c?.require,\n    allow: f.allow ?? c?.allow,\n    people: realPeople ? \"real\" : undefined,\n  });\n}\n\n/** The rule to save, from a drafted candidate and the flags over it; what is missing when there is none. Pure. */\nexport function ruleFromInputs(\n  inputs: { candidate?: SavedCandidate; flags?: RuleFlags },\n  at: { today: string; taken: readonly string[] },\n): CreativeRule | { error: string } {\n  const c = inputs.candidate;\n  const f = inputs.flags ?? {};\n  const text = (f.text ?? c?.text)?.trim();\n  if (!text) return { error: \"--text: the rule, in the person's words (or --candidate <id> from `feedback record`).\" };\n  const check = checkOf(f, c);\n  const source = defined({\n    kind: c ? (\"feedback\" as const) : (\"user\" as const),\n    slug: f.slug ?? c?.source.slug,\n    runId: f.run ?? c?.source.runId,\n    quote: f.quote ?? c?.source.quote,\n    date: at.today,\n  });\n  return {\n    id: ruleSlug(f.id ?? text, at.taken),\n    origin: \"learned\",\n    strength: oneOf(RULE_STRENGTHS, f.strength) ?? c?.strength ?? \"must\",\n    applies: oneOf(RULE_APPLIES, f.applies) ?? c?.applies ?? \"any\",\n    scope: scopeOf(f, c),\n    ...(Object.keys(check).length > 0 ? { check } : {}),\n    text,\n    ...(f.why ? { why: f.why } : {}),\n    source,\n    status: \"active\",\n  };\n}\n\n/** One version's finished sizes as review stills, from the run history; null when it has no picture. */\nasync function versionOf(runId: string): Promise<ReviewedVersion | null> {\n  const record = await fetchRunRecord(runId).catch(() => null);\n  const images = (record?.finalOutputs ?? []).filter((o) => o.kind === \"image\" && o.url);\n  const stills = await Promise.all(\n    images.map(async (o) => {\n      const response = await fetch(o.url as string).catch(() => null);\n      if (!response?.ok) return null;\n      const bytes = Buffer.from(await response.arrayBuffer());\n      return (await sharp(bytes).resize({ width: 1024 }).jpeg({ quality: 85 }).toBuffer()).toString(\"base64\");\n    }),\n  );\n  const kept = images.flatMap((o, i) =>\n    stills[i] ? [{ still: stills[i] as string, format: o.label ?? \"image\" }] : [],\n  );\n  return kept.length > 0 ? { runId, stills: kept.map((k) => k.still), formats: kept.map((k) => k.format) } : null;\n}\n\n/** How many approved versions a rule is tested against: a few, other creatives' first. */\nconst APPROVED_VERSIONS = 3;\n\n/** The company's approved versions to test a rule against, other creatives' first. */\nasync function approvedVersions(except: string | undefined, slug: string | undefined): Promise<ReviewedVersion[]> {\n  const feedback = await apiPost<CreativesFeedbackResponse>(\"/api/creatives/feedback\", { full: true }).catch(\n    () => null,\n  );\n  const approved = (feedback?.data.recent ?? []).filter((e) => e.verdict === \"approved\" && e.runId !== except);\n  const ordered = [...approved.filter((e) => e.creative !== slug), ...approved.filter((e) => e.creative === slug)];\n  const runIds = [...new Set(ordered.map((e) => e.runId))];\n  const versions: ReviewedVersion[] = [];\n  for (const runId of runIds) {\n    if (versions.length === APPROVED_VERSIONS) break;\n    const version = await versionOf(runId);\n    if (version) versions.push(version);\n  }\n  return versions;\n}\n\n/** The rule on the version it came from and on the company's approved ones (`admissionTest`). */\nasync function admit(rule: CreativeRule): Promise<Admission> {\n  const spent: Parameters<typeof holdWorkspaceSpend>[0][number][] = [];\n  const review = (version: ReviewedVersion, rules: CreativeRule[]) =>\n    reviewAgainstRules({ ...version, rules, onSpend: (u) => spent.push(u) });\n  const [origin, approved] = await Promise.all([\n    rule.source.runId ? versionOf(rule.source.runId) : Promise.resolve(null),\n    approvedVersions(rule.source.runId, rule.source.slug),\n  ]);\n  const admission = await admissionTest(rule, origin, approved, review);\n  await holdWorkspaceSpend(spent);\n  return admission;\n}\n\n/**\n * `rule` against the existing ones, what the decision model cost held for the workspace's next run\n * record: a duplicate or conflict refusal exits right after this, and the calls were still paid.\n */\nexport async function compareHoldingSpend(rule: CreativeRule, existing: readonly CreativeRule[]): Promise<Comparison> {\n  const spent: Parameters<typeof holdWorkspaceSpend>[0][number][] = [];\n  try {\n    return await compareRule(\n      rule,\n      existing,\n      jevPairs((u) => spent.push(u)),\n    );\n  } finally {\n    await holdWorkspaceSpend(spent);\n  }\n}\n\n/** A learned rule's file, retired by `by`; null when there is no such file. */\nasync function retireFile(root: string, id: string, by: string | undefined): Promise<CreativeRule | null> {\n  const file = path.join(root, RULES_DIR, `${id}.md`);\n  const rule = parseRuleFile(id, await readFile(file, \"utf8\").catch(() => \"\"));\n  if (!rule) return null;\n  const retired: CreativeRule = { ...rule, status: \"retired\", ...(by ? { retiredBy: by } : {}) };\n  await writeFile(file, ruleFileText(retired), \"utf8\");\n  return retired;\n}\n\nfunction fail(code: string, message: string, fix?: string, extra: Record<string, unknown> = {}): never {\n  writeJson({ ok: false, error: { code, message, ...(fix ? { fix } : {}), ...extra } });\n  process.exit(1);\n}\n\nconst list = (value: unknown): string[] | undefined =>\n  typeof value === \"string\" && value.trim()\n    ? value\n        .split(\",\")\n        .map((s) => s.trim())\n        .filter(Boolean)\n    : undefined;\nconst text = (value: unknown): string | undefined =>\n  typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n\nconst 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?\".\nStart here: baker creatives rules add --candidate rc-1a2b3c4d          # a rule \\`feedback record\\` drafted from their words\n  baker creatives rules add --text \"No AI-generated people.\" --strength never --applies cast --people real --quote \"<their words>\" --slug <ad> --run <r_…>\nIt 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.`;\n\nconst ADD_ARGS = {\n  candidate: {\n    type: \"string\",\n    description: \"A rule `feedback record` drafted (rc-…): the flags below override its parts\",\n    required: false,\n  },\n  text: {\n    type: \"string\",\n    description: \"The rule, one sentence, in the person's own language and words\",\n    required: false,\n  },\n  strength: {\n    type: \"string\",\n    description: `${RULE_STRENGTHS.join(\" | \")}: never and must are checked and block; prefer is a note`,\n    required: false,\n  },\n  applies: { type: \"string\", description: `What of the ad it is about: ${RULE_APPLIES.join(\", \")}`, required: false },\n  forbid: {\n    type: \"string\",\n    description: 'Words it bans, comma-separated, only when a word decides it (\"online\")',\n    required: false,\n  },\n  allow: { type: \"string\", description: 'The right phrase that holds a banned word (\"100 % online\")', required: false },\n  require: { type: \"string\", description: \"Words every ad must say, comma-separated (rare)\", required: false },\n  people: {\n    type: \"string\",\n    description: \"real: only real people appear (a real person's Avatar, a customer, footage or nobody)\",\n    required: false,\n  },\n  kinds: { type: \"string\", description: \"static,video: only ads of these kinds\", required: false },\n  products: { type: \"string\", description: \"Product slugs (a business unit): only ads of these\", required: false },\n  platforms: { type: \"string\", description: \"meta,linkedin,…: only ads for these\", required: false },\n  language: {\n    type: \"string\",\n    description: \"The language its words are in (es): its banned words are checked only in ads in it\",\n    required: false,\n  },\n  quote: { type: \"string\", description: \"The person's own words it came from, verbatim\", required: false },\n  slug: { type: \"string\", description: \"The creative they said it about\", required: false },\n  run: { type: \"string\", description: \"The version they said it about (r_…): the rule must catch it\", required: false },\n  why: { type: \"string\", description: \"Why, in a sentence, when the person said\", required: false },\n  id: { type: \"string\", description: \"The rule's id (its file name); default: from its words\", required: false },\n  replaces: {\n    type: \"string\",\n    description: \"A rule of the person's it contradicts and wins over: retired, never deleted\",\n    required: false,\n  },\n} as const;\n\nregisterSchema({ command: \"creatives.rules.add\", description: ADD_DESCRIPTION, args: ADD_ARGS });\n\n/**\n * What to do about a BRAND.md rule the new one repeats or contradicts. The rule a person taught lives\n * in its own file only: a copy in BRAND.md would stay in force after it is retired. Pure.\n */\nexport function brandMdHint(declared: Pick<CreativeRule, \"text\">, relation: \"same\" | \"conflict\"): string {\n  return relation === \"same\"\n    ? `BRAND.md states this too (\"${declared.text}\"): now the person confirmed it, every finished ad is checked against it.`\n    : `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.`;\n}\n\nexport const rulesAddCommand = defineCommand({\n  meta: { name: \"add\", description: ADD_DESCRIPTION },\n  args: ADD_ARGS,\n  async run({ args }) {\n    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();\n    const cacheDir = path.join(root, \"canvas\", \".cache\");\n    const candidateId = text(args.candidate);\n    const candidate = candidateId ? await loadCandidate(cacheDir, candidateId) : undefined;\n    if (candidateId && !candidate) {\n      fail(\n        \"VALIDATION_ERROR\",\n        `No drafted rule ${candidateId} here.`,\n        \"Use the id `feedback record` printed in this chat, or pass --text.\",\n      );\n    }\n    const all = await readAllRules(root);\n    const rule = ruleFromInputs(\n      {\n        ...(candidate ? { candidate } : {}),\n        flags: {\n          text: text(args.text),\n          strength: text(args.strength),\n          applies: text(args.applies),\n          forbid: list(args.forbid),\n          allow: list(args.allow),\n          require: list(args.require),\n          people: text(args.people),\n          kinds: list(args.kinds),\n          products: list(args.products),\n          platforms: list(args.platforms),\n          language: text(args.language),\n          quote: text(args.quote),\n          slug: text(args.slug),\n          run: text(args.run),\n          why: text(args.why),\n          id: text(args.id),\n        },\n      },\n      { today: new Date().toISOString().slice(0, 10), taken: all.map((r) => r.id) },\n    );\n    if (\"error\" in rule) fail(\"VALIDATION_ERROR\", rule.error);\n    const replaces = text(args.replaces);\n    const compared = await compareHoldingSpend(rule, all);\n    const sameTaught = compared.same.filter((r) => r.origin === \"learned\");\n    if (sameTaught.length > 0) {\n      fail(\n        \"DUPLICATE_RULE\",\n        `The company already has this rule: ${sameTaught.map((r) => `${r.id} (\"${r.text}\")`).join(\"; \")}.`,\n        \"Nothing to add. If the person wants it worded otherwise, retire that one and add this.\",\n      );\n    }\n    const conflicts = compared.conflicts.filter((r) => r.origin === \"learned\" && r.id !== replaces);\n    if (conflicts.length > 0) {\n      fail(\n        \"RULE_CONFLICT\",\n        `It contradicts ${conflicts.map((r) => `${r.id} (\"${r.text}\")`).join(\"; \")}.`,\n        \"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.\",\n      );\n    }\n    const admission = await admit(rule);\n    const refusal = admissionRefusal(rule, admission);\n    if (refusal) fail(refusal.code, refusal.message, refusal.fix, { admission });\n    await mkdir(path.join(root, RULES_DIR), { recursive: true });\n    const file = path.join(RULES_DIR, `${rule.id}.md`);\n    await writeFile(path.join(root, file), ruleFileText(rule), \"utf8\");\n    const retired = replaces ? await retireFile(root, replaces, rule.id) : null;\n    const declared = [...compared.same, ...compared.conflicts].filter((r) => r.origin === \"declared\");\n    writeJson({\n      ok: true,\n      data: {\n        rule: rulesView([rule], { full: true })[0],\n        file,\n        admission,\n        ...(retired ? { retired: retired.id } : {}),\n      },\n      hints: [\n        `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.`,\n        ...(compared.judged\n          ? []\n          : [\n              \"Whether it repeats or contradicts another rule could not be read (the decision model did not answer): look at `baker creatives rules list`.\",\n            ]),\n        ...declared.map((r) => brandMdHint(r, compared.same.includes(r) ? \"same\" : \"conflict\")),\n      ],\n    });\n  },\n});\n\nconst 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.\nStart here: baker creatives rules retire cien-por-cien-online [--by <rule id>|BRAND.md]\nA rule of BRAND.md is changed in BRAND.md (/brand-build).`;\n\nconst RETIRE_ARGS = {\n  id: { type: \"positional\", description: \"The rule's id (`baker creatives rules list`)\", required: true },\n  by: { type: \"string\", description: \"What replaces it: another rule's id, or BRAND.md\", required: false },\n} as const;\n\nregisterSchema({ command: \"creatives.rules.retire\", description: RETIRE_DESCRIPTION, args: RETIRE_ARGS });\n\nexport const rulesRetireCommand = defineCommand({\n  meta: { name: \"retire\", description: RETIRE_DESCRIPTION },\n  args: RETIRE_ARGS,\n  async run({ args }) {\n    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();\n    const id = String(args.id);\n    if (/^brand-[0-9a-f]{8}$/.test(id)) {\n      fail(\"VALIDATION_ERROR\", `${id} is a rule of BRAND.md.`, \"Change it in BRAND.md with /brand-build.\");\n    }\n    const retired = await retireFile(root, id, text(args.by));\n    if (!retired) fail(\"NOT_FOUND\", `No rule ${id} in ${RULES_DIR}.`, \"See `baker creatives rules list --all`.\");\n    writeJson({\n      ok: true,\n      data: { rule: rulesView([retired], { full: true })[0] },\n      hints: [\"Retired: no ad is held to it from now on.\"],\n    });\n  },\n});\n","/**\n * A rule's admission test, before it is saved for every ad: it must catch the version it came from\n * (the rejected one), and stay silent on versions of the company the person approved. A rule that\n * misses its own ad is worded for something else; one that would block approved ads is stricter\n * than the person. Either way the person is asked again, never the rule saved as drafted. Only the\n * rules the finished-ad review holds an ad to by eye are tested (`reviewedRules`); a voice or a\n * sound needs the video playing, and is saved untested, saying so.\n */\nimport type { RenderFinding } from \"../nodes/local/lib/render-review.ts\";\nimport { reviewedRules } from \"../nodes/local/lib/rules-findings.ts\";\nimport type { CreativeRule } from \"./schema.ts\";\n\n/** One version as the rules review looks at it: its sizes as base64 JPEG, in `formats` order. */\nexport type ReviewedVersion = { runId: string; stills: string[]; formats: string[] };\n\n/** The rules review on one version (`reviewAgainstRules`); null when nobody looked. */\nexport type ReviewVersion = (version: ReviewedVersion, rules: CreativeRule[]) => Promise<RenderFinding[] | null>;\n\nexport type Admission = {\n  origin: \"caught\" | \"missed\" | \"untested\";\n  approved: { checked: number; blocked: Array<{ runId: string; what: string }> };\n};\n\n/** The rule's blocking findings on a version; null when nobody looked. */\nasync function breaks(\n  rule: CreativeRule,\n  version: ReviewedVersion,\n  review: ReviewVersion,\n): Promise<RenderFinding[] | null> {\n  const found = await review(version, [rule]).catch(() => null);\n  return found === null ? null : found.filter((f) => f.kind?.rule === rule.id && f.severity === \"blocking\");\n}\n\n/** The rule on the version it came from and on up to a few the person approved. */\nexport async function admissionTest(\n  rule: CreativeRule,\n  origin: ReviewedVersion | null,\n  approved: readonly ReviewedVersion[],\n  review: ReviewVersion,\n): Promise<Admission> {\n  const untested: Admission = { origin: \"untested\", approved: { checked: 0, blocked: [] } };\n  // A prefer never blocks: it is tested as if it did, since the person reads it the same.\n  const tested = { ...rule, strength: rule.strength === \"prefer\" ? (\"must\" as const) : rule.strength };\n  if (reviewedRules([tested]).length === 0) return untested;\n  const own = origin ? await breaks(tested, origin, review) : null;\n  const results = await Promise.all(\n    approved.map(async (v) => ({ runId: v.runId, found: await breaks(tested, v, review) })),\n  );\n  const looked = results.filter((r) => r.found !== null);\n  return {\n    origin: own === null ? \"untested\" : own.length > 0 ? \"caught\" : \"missed\",\n    approved: {\n      checked: looked.length,\n      blocked: looked.flatMap((r) =>\n        r.found?.[0] ? [{ runId: r.runId, what: r.found[0].what.replace(/^.*?\\): /, \"\") }] : [],\n      ),\n    },\n  };\n}\n\n/** Why the rule is not saved as drafted, and what to ask the person; null when it passed or was not tested. Pure. */\nexport function admissionRefusal(\n  rule: CreativeRule,\n  admission: Admission,\n): { code: \"RULE_MISSES_ITS_AD\" | \"RULE_BLOCKS_APPROVED\"; message: string; fix: string } | null {\n  if (admission.origin === \"missed\") {\n    return {\n      code: \"RULE_MISSES_ITS_AD\",\n      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.`,\n      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.\",\n    };\n  }\n  const blocked = admission.approved.blocked;\n  if (blocked.length > 0) {\n    return {\n      code: \"RULE_BLOCKS_APPROVED\",\n      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(\"; \")}.`,\n      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.\",\n    };\n  }\n  return null;\n}\n","/**\n * A new rule against the ones the company already has, read by the decision model in any language:\n * which say the same (a duplicate), and which it contradicts (an ad could not keep both). `rules add`\n * refuses a duplicate of a rule a person taught, and a contradiction until the person picks the winner;\n * the loser is retired, never deleted.\n */\nimport { askJev } from \"../nodes/local/lib/jev.ts\";\nimport type { ReviewUsage } from \"../nodes/local/lib/render-review.ts\";\nimport type { CreativeRule } from \"./schema.ts\";\n\nconst SAME =\n  \"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?\";\nconst CONFLICT =\n  \"Do rules `a` and `b` contradict each other, so that no ad could keep both: following one breaks the other?\";\n\n/** Above these, two rules are the same or contradict: refusing a rule by mistake costs the person a rule. */\nconst SAME_BAND = 0.6;\nconst CONFLICT_BAND = 0.6;\n\nexport type RulePair = { a: string; b: string; question: \"same\" | \"conflict\" };\n\n/** Each pair's probability of yes, in order; null when the decision model did not answer. */\nexport type AskPairs = (pairs: readonly RulePair[]) => Promise<number[] | null>;\n\n/** The most questions one request carries. */\nconst BATCH = 40;\n\n/** The decision model asked about each pair, a batch at a time. */\nexport function jevPairs(onSpend?: (usage: ReviewUsage) => void): AskPairs {\n  return async (pairs) => {\n    const answers: number[] = [];\n    for (let i = 0; i < pairs.length; i += BATCH) {\n      const batch = pairs.slice(i, i + BATCH);\n      const got = await askJev(\n        batch.map((p) => ({ instructions: { a: p.a, b: p.b, question: p.question === \"same\" ? SAME : CONFLICT } })),\n        onSpend,\n      );\n      if (!got) return null;\n      answers.push(...got);\n    }\n    return answers;\n  };\n}\n\nexport type Comparison = { same: CreativeRule[]; conflicts: CreativeRule[]; judged: boolean };\n\n/** The active rules `candidate` duplicates and the ones it contradicts. */\nexport async function compareRule(\n  candidate: CreativeRule,\n  existing: readonly CreativeRule[],\n  ask: AskPairs,\n): Promise<Comparison> {\n  const active = existing.filter((r) => r.status === \"active\" && r.id !== candidate.id);\n  if (active.length === 0) return { same: [], conflicts: [], judged: true };\n  const pairs = active.flatMap((r): RulePair[] => [\n    { a: candidate.text, b: r.text, question: \"same\" },\n    { a: candidate.text, b: r.text, question: \"conflict\" },\n  ]);\n  const answers = await ask(pairs).catch(() => null);\n  if (!answers || answers.length !== pairs.length) return { same: [], conflicts: [], judged: false };\n  return {\n    same: active.filter((_, i) => (answers[2 * i] ?? 0) >= SAME_BAND),\n    conflicts: active.filter((_, i) => (answers[2 * i + 1] ?? 0) >= CONFLICT_BAND),\n    judged: true,\n  };\n}\n","/**\n * A rule a person agreed to, as the file it lives in (`src/content/creative-rules/<slug>.md`): its\n * frontmatter (what decides it, where it came from) and its words, then why. The reader\n * (`parseRuleFile`) reads it back the same. Pure.\n */\nimport { stringify as stringifyYaml } from \"yaml\";\nimport type { CreativeRule } from \"./schema.ts\";\n\n/** The rule's file: frontmatter, its words, then why. Pure. */\nexport function ruleFileText(rule: CreativeRule): string {\n  const frontmatter = {\n    strength: rule.strength,\n    applies: rule.applies,\n    ...(Object.keys(rule.scope).length > 0 ? { scope: rule.scope } : {}),\n    ...(rule.check && Object.keys(rule.check).length > 0 ? { check: rule.check } : {}),\n    source: rule.source,\n    status: rule.status,\n    ...(rule.retiredBy ? { retiredBy: rule.retiredBy } : {}),\n  };\n  // Every string quoted: a date stays a date's words, and a quote with a colon stays one value.\n  const yaml = stringifyYaml(frontmatter, { defaultStringType: \"QUOTE_DOUBLE\", defaultKeyType: \"PLAIN\", lineWidth: 0 });\n  return `---\\n${yaml}---\\n${rule.text.trim()}\\n${rule.why ? `\\nWhy: ${rule.why.trim()}\\n` : \"\"}`;\n}\n\nconst SLUG_WORDS = 8;\n\n/** A file name from the rule's words, not one of `taken`. Pure. */\nexport function ruleSlug(text: string, taken: readonly string[]): string {\n  const base =\n    text\n      .normalize(\"NFKD\")\n      .replace(/\\p{M}/gu, \"\")\n      .toLowerCase()\n      .replace(/[^a-z0-9]+/g, \" \")\n      .trim()\n      .split(/\\s+/)\n      .filter(Boolean)\n      .slice(0, SLUG_WORDS)\n      .join(\"-\") || \"rule\";\n  if (!taken.includes(base)) return base;\n  let n = 2;\n  while (taken.includes(`${base}-${n}`)) n++;\n  return `${base}-${n}`;\n}\n"],"mappings":"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","names":["text","text"]}

package/dist/run-DIDQSZU7.js

@@ -0,0 +1,67 @@
+import {
+  failApi,
+  failValidation,
+  isTempScheduledAgentId
+} from "./chunk-PYD6IGW6.js";
+import "./chunk-FALJQCWL.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,
+  validateConvexId
+} 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/scheduled-agents/run.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "scheduled-agents.run",
+  description: "Run a published scheduled agent now, whatever its trigger says. Opens a Session immediately and returns its chatId. Does not need BAKER_CHAT_ID, and refuses a temp_agent_* id \u2014 a staged item has to be published before it can run.",
+  args: {
+    id: { type: "string", description: "Published scheduled agent ID", required: true }
+  }
+});
+var runCommand = defineCommand({
+  meta: {
+    name: "run",
+    description: "Run a published scheduled agent now. Example: baker scheduled-agents run <id>"
+  },
+  args: {
+    id: { type: "positional", description: "Published scheduled agent ID", required: false },
+    "scheduled-agent-id": {
+      type: "string",
+      description: "Scheduled agent ID (alternative to positional)",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["scheduled-agent-id"];
+      if (!id) {
+        failValidation("Scheduled agent ID is required.");
+      }
+      if (isTempScheduledAgentId(id)) {
+        failValidation("run needs a published scheduled agent ID, not temp_agent_*. Publish this chat first.");
+      }
+      validateConvexId(id);
+      const response = await apiPost("/api/scheduled-agents/run", { id });
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  runCommand
+};
+//# sourceMappingURL=run-DIDQSZU7.js.map

package/dist/run-DIDQSZU7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/scheduled-agents/run.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiPost, validateConvexId } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi, failValidation, isTempScheduledAgentId } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"scheduled-agents.run\",\n  description:\n    \"Run a published scheduled agent now, whatever its trigger says. Opens a Session immediately and returns its chatId. Does not need BAKER_CHAT_ID, and refuses a temp_agent_* id — a staged item has to be published before it can run.\",\n  args: {\n    id: { type: \"string\", description: \"Published scheduled agent ID\", required: true },\n  },\n});\n\nexport const runCommand = defineCommand({\n  meta: {\n    name: \"run\",\n    description: \"Run a published scheduled agent now. Example: baker scheduled-agents run <id>\",\n  },\n  args: {\n    id: { type: \"positional\", description: \"Published scheduled agent ID\", required: false },\n    \"scheduled-agent-id\": {\n      type: \"string\",\n      description: \"Scheduled agent ID (alternative to positional)\",\n      required: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const id = (args.id as string | undefined) || (args[\"scheduled-agent-id\"] as string | undefined);\n      if (!id) {\n        failValidation(\"Scheduled agent ID is required.\");\n      }\n      if (isTempScheduledAgentId(id)) {\n        failValidation(\"run needs a published scheduled agent ID, not temp_agent_*. Publish this chat first.\");\n      }\n      validateConvexId(id);\n      const response = await apiPost<{ ok: true; data: { chatId: string } }>(\"/api/scheduled-agents/run\", { id });\n      writeJson(response);\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,UAAU,aAAa,gCAAgC,UAAU,KAAK;AAAA,EACpF;AACF,CAAC;AAEM,IAAM,aAAa,cAAc;AAAA,EACtC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,gCAAgC,UAAU,MAAM;AAAA,IACvF,sBAAsB;AAAA,MACpB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,KAAM,KAAK,MAA8B,KAAK,oBAAoB;AACxE,UAAI,CAAC,IAAI;AACP,uBAAe,iCAAiC;AAAA,MAClD;AACA,UAAI,uBAAuB,EAAE,GAAG;AAC9B,uBAAe,sFAAsF;AAAA,MACvG;AACA,uBAAiB,EAAE;AACnB,YAAM,WAAW,MAAM,QAAgD,6BAA6B,EAAE,GAAG,CAAC;AAC1G,gBAAU,QAAQ;AAAA,IACpB,SAAS,KAAK;AACZ,cAAQ,GAAG;AAAA,IACb;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/run-SR7DJ7M5.js

@@ -0,0 +1,66 @@
+import {
+  buildBackendClient,
+  executeCanvasRun,
+  runCommand,
+  stopBeforeKinds
+} from "./chunk-EONSZAZB.js";
+import "./chunk-RJZS4XDJ.js";
+import "./chunk-AV7ALENU.js";
+import "./chunk-WN4KX7GE.js";
+import "./chunk-EFWXYUSK.js";
+import "./chunk-IVIJJXXT.js";
+import "./chunk-IBTSIPYA.js";
+import "./chunk-Q6ULQMWG.js";
+import "./chunk-KKJ4KJCW.js";
+import "./chunk-3ACMDRSE.js";
+import "./chunk-LX6WC2XZ.js";
+import "./chunk-QRLTVJ6F.js";
+import "./chunk-I24YT2KG.js";
+import "./chunk-XXDF25BW.js";
+import "./chunk-7QGFO35A.js";
+import "./chunk-MOFMOYUA.js";
+import "./chunk-DJE7UXYT.js";
+import "./chunk-MMGTJBM6.js";
+import "./chunk-FG3MV2XM.js";
+import "./chunk-QG4MW2V4.js";
+import "./chunk-VNU2EYD4.js";
+import "./chunk-Y46FE75E.js";
+import "./chunk-JVVUI55M.js";
+import "./chunk-YJ3LSFMX.js";
+import "./chunk-3S274625.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-6UNOK7WV.js";
+import "./chunk-UFKO626N.js";
+import "./chunk-XRIM7NYV.js";
+import "./chunk-B7GF34FU.js";
+import "./chunk-OL7JS4NG.js";
+import "./chunk-7KHTJQGV.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-QMOYQJIN.js";
+import "./chunk-FKYPAGKK.js";
+import "./chunk-S4VLLGTW.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./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 "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  buildBackendClient,
+  executeCanvasRun,
+  runCommand,
+  stopBeforeKinds
+};
+//# sourceMappingURL=run-SR7DJ7M5.js.map