@koda-sl/baker-cli 0.496.0 → 0.497.0

package/dist/feedback-record-GXPYXNT6.js

@@ -0,0 +1,261 @@
+import {
+  readCreativeIdea,
+  withAnchor
+} from "./chunk-QZF4BVKL.js";
+import {
+  modelRuleDrafter,
+  repeatedReasons,
+  ruleCandidateHints,
+  ruleCandidates,
+  saveCandidates
+} from "./chunk-WT4WDIXA.js";
+import {
+  versionOf
+} from "./chunk-LBRO4MTL.js";
+import "./chunk-I24YT2KG.js";
+import "./chunk-XXDF25BW.js";
+import "./chunk-MOFMOYUA.js";
+import "./chunk-MMGTJBM6.js";
+import "./chunk-FG3MV2XM.js";
+import "./chunk-QG4MW2V4.js";
+import "./chunk-VNU2EYD4.js";
+import {
+  frontmatterOf
+} from "./chunk-Y46FE75E.js";
+import "./chunk-JVVUI55M.js";
+import "./chunk-YJ3LSFMX.js";
+import "./chunk-3S274625.js";
+import "./chunk-6UNOK7WV.js";
+import {
+  holdWorkspaceSpend
+} from "./chunk-UFKO626N.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-XRIM7NYV.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 {
+  askJev
+} from "./chunk-A6WKCV3V.js";
+import "./chunk-U7YR5CZL.js";
+import "./chunk-VI5YQQ63.js";
+import "./chunk-JX7BX2NB.js";
+import {
+  CREATIVE_FEEDBACK_REASONS,
+  creativesFeedbackRecordRequestSchema
+} from "./chunk-O37VU7FG.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  ApiError,
+  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/feedback-record.ts
+import { readFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+
+// src/commands/creatives/agent-option-note.ts
+var NOTE_BANDS = { tagged: 0.5, bareFix: 0.45, namesProblem: 0.5 };
+var TAGGED = "Does `note` end with a tag marking it as the recommended option, like (Recommended), in any language?";
+var BARE_FIX = 'Is `note` a bare yes to an offer to fix things, like "fix everything" or "fix what is pending", naming no particular problem? A note that names what is wrong or what to change (the typos, the price, cut-off text, redo the pieces) is not.';
+var NAMES_PROBLEM = "Does `note` name a particular problem, element or part of an ad (a typo, the price, the logo, the audio, the text, the colours, a person), apart from a whole format or size?";
+var jevNoteJudge = async (note) => {
+  const spent = [];
+  const answers = await askJev(
+    [TAGGED, BARE_FIX, NAMES_PROBLEM].map((question) => ({ instructions: { note, question } })),
+    (usage) => spent.push(usage)
+  );
+  await holdWorkspaceSpend(spent);
+  if (answers === null) return null;
+  const [tagged = 0, bareFix = 0, namesProblem = 1] = answers;
+  return { tagged, bareFix, namesProblem };
+};
+function readsAsAgentOption(reading) {
+  if (reading.tagged >= NOTE_BANDS.tagged) return true;
+  return reading.bareFix >= NOTE_BANDS.bareFix && reading.namesProblem < NOTE_BANDS.namesProblem;
+}
+async function readNoteAuthor(note, judge) {
+  const text = note.trim();
+  if (!text) return "person";
+  const reading = await judge(text).catch(() => null);
+  if (reading === null) return "unconfirmed";
+  return readsAsAgentOption(reading) ? "agent_option" : "person";
+}
+
+// src/commands/creatives/feedback-record.ts
+var DESCRIPTION = `Record what the user said about one version of a creative in this chat: an approval, or a rejection with reasons. Saved as their verdict (the person who wrote the latest message here) and read back by baker creatives feedback. One verdict per person per version or option: a later one replaces it.
+Start here: baker creatives feedback record --slug spring-offer --verdict rejected --reasons text_mistakes --note "<their words>"
+Only record what the user said, never your own judgment. Picking one of several concepts is not a rejection of the others.
+When their words state a rule for every ad, the answer carries ruleCandidates: ask them once, and only on yes run baker creatives rules add --candidate <id>.
+A rejection's answer carries the creative's idea as data.anchor (its message, reference and language), restated first in hints: the edit keeps it, changing only what they named.`;
+var ARGS = {
+  slug: { type: "string", description: "The creative: its folder name under src/creatives/.", required: true },
+  run: {
+    type: "string",
+    description: "The version: its canvas run id (r_\u2026) Left out, the version the creative shows now (its last render).",
+    required: false
+  },
+  option: {
+    type: "string",
+    description: 'One option of a version that made several: its label ("ugc"), its number ("2") or its slot. Left out, the whole version.',
+    required: false
+  },
+  verdict: { type: "string", description: "approved | rejected", required: true },
+  reasons: {
+    type: "string",
+    description: `Why it was rejected, comma-separated: ${CREATIVE_FEEDBACK_REASONS.join(", ")}. Map the user's words to these; "other" when none fits. On a video, voice_or_sound covers the voiceover, music and mix ("the voice sounds robotic", "music too loud") and pacing covers the timing ("too slow", "the hook comes too late").`,
+    required: false
+  },
+  note: {
+    type: "string",
+    description: "The user's own words, verbatim (not your summary). Up to 1000 characters.",
+    required: false
+  }
+};
+registerSchema({ command: "creatives.feedback.record", description: DESCRIPTION, args: ARGS });
+function splitList(value) {
+  if (typeof value !== "string" || value.trim() === "") return void 0;
+  return value.split(",").map((item) => item.trim()).filter((item) => item.length > 0);
+}
+function fail(code, message) {
+  writeJson({ ok: false, error: { code, message } });
+  process.exit(1);
+}
+async function refuseNotFeedback(body) {
+  if (body.verdict === "rejected" && !body.reasons?.length && !body.note) {
+    fail(
+      "VALIDATION_ERROR",
+      "A rejection needs --reasons or --note (the user's words), so the next version knows what to change."
+    );
+  }
+  if (body.verdict !== "rejected" || !body.note) return false;
+  const author = await readNoteAuthor(body.note, jevNoteJudge);
+  if (author === "agent_option") {
+    fail(
+      "AGENT_OPTION_NOT_FEEDBACK",
+      `"${body.note}" is the answer to your own question, not the person's taste: a defect the checks found is yours to fix inside this version (\`baker canvas run --fix\`), never feedback to record. Record only what the person says about the ad in their own words.`
+    );
+  }
+  return author === "unconfirmed";
+}
+async function writeBack(body) {
+  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+  const cacheDir = path.join(root, "canvas", ".cache");
+  const definition = frontmatterOf(
+    await readFile(path.join(root, "src", "creatives", body.slug, "_definition.md"), "utf8").catch(() => "")
+  );
+  const kind = definition?.kind === "video" || definition?.kind === "static" ? definition.kind : void 0;
+  const platform = typeof definition?.platform === "string" ? definition.platform : void 0;
+  const [drafts, company] = await Promise.all([
+    ruleCandidates(
+      body.note,
+      { ...kind ? { kind } : {}, ...platform ? { platform } : {} },
+      modelRuleDrafter(cacheDir)
+    ),
+    // Every recent verdict, notes whole: the distinct-notes summary counts a note given on five ads once.
+    apiPost("/api/creatives/feedback", { full: true }).catch(() => null)
+  ]);
+  const saved = drafts.map((d) => ({
+    ...d,
+    source: { slug: body.slug, runId: body.runId, ...body.note ? { quote: body.note } : {} }
+  }));
+  const ids = await saveCandidates(cacheDir, saved).catch(() => []);
+  const offered = drafts.flatMap((d, i) => ids[i] ? [{ id: ids[i], draft: d }] : []);
+  const rejections = (company?.data.recent ?? []).flatMap(
+    (e) => e.verdict === "rejected" && e.note ? [{ creative: e.creative, reasons: e.reasons, note: e.note }] : []
+  );
+  const repeated = repeatedReasons(rejections, body.reasons ?? [], body.slug);
+  return {
+    candidates: offered.map(({ id, draft }) => ({
+      candidate: id,
+      rule: draft.text,
+      strength: draft.strength,
+      applies: draft.applies,
+      ...draft.forbid ? { forbid: draft.forbid } : {},
+      ...draft.platforms ? { platforms: draft.platforms } : {}
+    })),
+    hints: ruleCandidateHints(
+      offered.map(({ id, draft }) => ({ id, text: draft.text })),
+      repeated
+    )
+  };
+}
+async function withRules(response, body, noteUnconfirmed) {
+  if (body.verdict !== "rejected" || !body.note || noteUnconfirmed) return response;
+  const rule = await writeBack(body);
+  return {
+    ...response,
+    data: { ...response.data, ...rule.candidates.length > 0 ? { ruleCandidates: rule.candidates } : {} },
+    hints: [...response.hints ?? [], ...rule.hints]
+  };
+}
+function ideaToKeep(body) {
+  return body.verdict === "rejected" ? readCreativeIdea(body.slug).catch(() => null) : Promise.resolve(null);
+}
+async function withIdea(recorded, idea) {
+  const view = await idea;
+  return view ? withAnchor(recorded, view, { full: false }) : recorded;
+}
+var feedbackRecordCommand = defineCommand({
+  meta: { name: "record", description: DESCRIPTION },
+  args: ARGS,
+  run: async ({ args }) => {
+    const reasons = splitList(args.reasons);
+    const unknown = (reasons ?? []).filter(
+      (reason) => !CREATIVE_FEEDBACK_REASONS.includes(reason)
+    );
+    if (unknown.length > 0) {
+      fail("VALIDATION_ERROR", `Unknown reason ${unknown.join(", ")}. Use: ${CREATIVE_FEEDBACK_REASONS.join(", ")}.`);
+    }
+    const parsed = creativesFeedbackRecordRequestSchema.safeParse({
+      slug: args.slug,
+      runId: await versionOf(String(args.slug), args.run).then(
+        (run) => run ?? fail("VALIDATION_ERROR", "--run: this creative has no rendered version here; name one (r_\u2026).")
+      ),
+      ...typeof args.option === "string" && args.option.trim() ? { option: args.option.trim() } : {},
+      verdict: args.verdict,
+      ...reasons ? { reasons } : {},
+      ...typeof args.note === "string" && args.note.trim() ? { note: args.note } : {}
+    });
+    if (!parsed.success) {
+      const issue = parsed.error.issues[0];
+      fail("VALIDATION_ERROR", `--${String(issue?.path[0] ?? "args")}: ${issue?.message ?? "invalid"}`);
+    }
+    const body = parsed.data;
+    const noteUnconfirmed = await refuseNotFeedback(body);
+    const idea = ideaToKeep(body);
+    try {
+      const response = await apiPost(
+        "/api/creatives/feedback/record",
+        noteUnconfirmed ? { ...body, noteUnconfirmed } : body
+      );
+      writeJson(await withIdea(await withRules(response, body, noteUnconfirmed), idea));
+    } catch (err) {
+      if (err instanceof ApiError) fail(err.code, err.message);
+      fail("INTERNAL_ERROR", "Unexpected error");
+    }
+  }
+});
+export {
+  feedbackRecordCommand
+};
+//# sourceMappingURL=feedback-record-GXPYXNT6.js.map

package/dist/feedback-record-GXPYXNT6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/feedback-record.ts","../src/commands/creatives/agent-option-note.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport {\n  CREATIVE_FEEDBACK_REASONS,\n  type CreativeFeedbackReason,\n  type CreativesFeedbackRecordResponse,\n  type CreativesFeedbackResponse,\n  creativesFeedbackRecordRequestSchema,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport type { IdeaView } from \"../../engine/creative-context/anchor.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { jevNoteJudge, readNoteAuthor } from \"./agent-option-note.ts\";\nimport { readCreativeIdea, withAnchor } from \"./idea-hint.ts\";\nimport { frontmatterOf } from \"./ideas-model.ts\";\nimport {\n  modelRuleDrafter,\n  repeatedReasons,\n  ruleCandidateHints,\n  ruleCandidates,\n  type SavedCandidate,\n  saveCandidates,\n} from \"./rule-candidate.ts\";\nimport { versionOf } from \"./version-of.ts\";\n\nconst DESCRIPTION = `Record what the user said about one version of a creative in this chat: an approval, or a rejection with reasons. Saved as their verdict (the person who wrote the latest message here) and read back by baker creatives feedback. One verdict per person per version or option: a later one replaces it.\nStart here: baker creatives feedback record --slug spring-offer --verdict rejected --reasons text_mistakes --note \"<their words>\"\nOnly record what the user said, never your own judgment. Picking one of several concepts is not a rejection of the others.\nWhen their words state a rule for every ad, the answer carries ruleCandidates: ask them once, and only on yes run baker creatives rules add --candidate <id>.\nA rejection's answer carries the creative's idea as data.anchor (its message, reference and language), restated first in hints: the edit keeps it, changing only what they named.`;\n\nconst ARGS = {\n  slug: { type: \"string\", description: \"The creative: its folder name under src/creatives/.\", required: true },\n  run: {\n    type: \"string\",\n    description: \"The version: its canvas run id (r_…) Left out, the version the creative shows now (its last render).\",\n    required: false,\n  },\n  option: {\n    type: \"string\",\n    description:\n      'One option of a version that made several: its label (\"ugc\"), its number (\"2\") or its slot. Left out, the whole version.',\n    required: false,\n  },\n  verdict: { type: \"string\", description: \"approved | rejected\", required: true },\n  reasons: {\n    type: \"string\",\n    description: `Why it was rejected, comma-separated: ${CREATIVE_FEEDBACK_REASONS.join(\", \")}. Map the user's words to these; \"other\" when none fits. On a video, voice_or_sound covers the voiceover, music and mix (\"the voice sounds robotic\", \"music too loud\") and pacing covers the timing (\"too slow\", \"the hook comes too late\").`,\n    required: false,\n  },\n  note: {\n    type: \"string\",\n    description: \"The user's own words, verbatim (not your summary). Up to 1000 characters.\",\n    required: false,\n  },\n} as const;\n\nregisterSchema({ command: \"creatives.feedback.record\", description: DESCRIPTION, args: ARGS });\n\nfunction splitList(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\" || value.trim() === \"\") return undefined;\n  return value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter((item) => item.length > 0);\n}\n\nfunction fail(code: string, message: string): never {\n  writeJson({ ok: false, error: { code, message } });\n  process.exit(1);\n}\n\n/**\n * A rejection whose note only answers the agent's own question, or that says nothing, is not the\n * person's feedback. Returns whether the note could not be confirmed as the person's words.\n */\nasync function refuseNotFeedback(body: {\n  verdict: string;\n  reasons?: readonly string[];\n  note?: string;\n}): Promise<boolean> {\n  if (body.verdict === \"rejected\" && !body.reasons?.length && !body.note) {\n    fail(\n      \"VALIDATION_ERROR\",\n      \"A rejection needs --reasons or --note (the user's words), so the next version knows what to change.\",\n    );\n  }\n  if (body.verdict !== \"rejected\" || !body.note) return false;\n  const author = await readNoteAuthor(body.note, jevNoteJudge);\n  if (author === \"agent_option\") {\n    fail(\n      \"AGENT_OPTION_NOT_FEEDBACK\",\n      `\"${body.note}\" is the answer to your own question, not the person's taste: a defect the checks found is yours to fix inside this version (\\`baker canvas run --fix\\`), never feedback to record. Record only what the person says about the ad in their own words.`,\n    );\n  }\n  return author === \"unconfirmed\";\n}\n\n/**\n * The rules a rejection's note states for every ad (`ruleCandidates`), kept for `rules add\n * --candidate`, and the reasons the company already gave on other ads (`repeatedReasons`). Never\n * throws: a draft nobody could make is no candidate, and the verdict is recorded either way.\n */\nasync function writeBack(body: { slug: string; runId: string; note?: string; reasons?: CreativeFeedbackReason[] }) {\n  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();\n  const cacheDir = path.join(root, \"canvas\", \".cache\");\n  const definition = frontmatterOf(\n    await readFile(path.join(root, \"src\", \"creatives\", body.slug, \"_definition.md\"), \"utf8\").catch(() => \"\"),\n  );\n  const kind = definition?.kind === \"video\" || definition?.kind === \"static\" ? definition.kind : undefined;\n  const platform = typeof definition?.platform === \"string\" ? definition.platform : undefined;\n  const [drafts, company] = await Promise.all([\n    ruleCandidates(\n      body.note,\n      { ...(kind ? { kind } : {}), ...(platform ? { platform } : {}) },\n      modelRuleDrafter(cacheDir),\n    ),\n    // Every recent verdict, notes whole: the distinct-notes summary counts a note given on five ads once.\n    apiPost<CreativesFeedbackResponse>(\"/api/creatives/feedback\", { full: true }).catch(() => null),\n  ]);\n  const saved: SavedCandidate[] = drafts.map((d) => ({\n    ...d,\n    source: { slug: body.slug, runId: body.runId, ...(body.note ? { quote: body.note } : {}) },\n  }));\n  const ids = await saveCandidates(cacheDir, saved).catch(() => [] as string[]);\n  const offered = drafts.flatMap((d, i) => (ids[i] ? [{ id: ids[i] as string, draft: d }] : []));\n  const rejections = (company?.data.recent ?? []).flatMap((e) =>\n    e.verdict === \"rejected\" && e.note ? [{ creative: e.creative, reasons: e.reasons, note: e.note }] : [],\n  );\n  const repeated = repeatedReasons(rejections, body.reasons ?? [], body.slug);\n  return {\n    candidates: offered.map(({ id, draft }) => ({\n      candidate: id,\n      rule: draft.text,\n      strength: draft.strength,\n      applies: draft.applies,\n      ...(draft.forbid ? { forbid: draft.forbid } : {}),\n      ...(draft.platforms ? { platforms: draft.platforms } : {}),\n    })),\n    hints: ruleCandidateHints(\n      offered.map(({ id, draft }) => ({ id, text: draft.text })),\n      repeated,\n    ),\n  };\n}\n\n/** The recorded verdict, with the rules a rejection in the person's own words states for every ad. */\nasync function withRules(\n  response: CreativesFeedbackRecordResponse,\n  body: { verdict: string; slug: string; runId: string; note?: string; reasons?: CreativeFeedbackReason[] },\n  noteUnconfirmed: boolean,\n) {\n  if (body.verdict !== \"rejected\" || !body.note || noteUnconfirmed) return response;\n  const rule = await writeBack(body);\n  return {\n    ...response,\n    data: { ...response.data, ...(rule.candidates.length > 0 ? { ruleCandidates: rule.candidates } : {}) },\n    hints: [...(response.hints ?? []), ...rule.hints],\n  };\n}\n\n/** A rejection is followed by an edit: the idea it keeps, read while the verdict is recorded. */\nfunction ideaToKeep(body: { verdict: string; slug: string }): Promise<IdeaView | null> {\n  return body.verdict === \"rejected\" ? readCreativeIdea(body.slug).catch(() => null) : Promise.resolve(null);\n}\n\n/** The answer with the idea the edit keeps, restated first; as it is without one. */\nasync function withIdea<R extends { data: object; hints?: string[] }>(recorded: R, idea: Promise<IdeaView | null>) {\n  const view = await idea;\n  return view ? withAnchor(recorded, view, { full: false }) : recorded;\n}\n\nexport const feedbackRecordCommand = defineCommand({\n  meta: { name: \"record\", description: DESCRIPTION },\n  args: ARGS,\n  run: async ({ args }) => {\n    const reasons = splitList(args.reasons);\n    const unknown = (reasons ?? []).filter(\n      (reason) => !(CREATIVE_FEEDBACK_REASONS as readonly string[]).includes(reason),\n    );\n    if (unknown.length > 0) {\n      fail(\"VALIDATION_ERROR\", `Unknown reason ${unknown.join(\", \")}. Use: ${CREATIVE_FEEDBACK_REASONS.join(\", \")}.`);\n    }\n    const parsed = creativesFeedbackRecordRequestSchema.safeParse({\n      slug: args.slug,\n      runId: await versionOf(String(args.slug), args.run).then(\n        (run) => run ?? fail(\"VALIDATION_ERROR\", \"--run: this creative has no rendered version here; name one (r_…).\"),\n      ),\n      ...(typeof args.option === \"string\" && args.option.trim() ? { option: args.option.trim() } : {}),\n      verdict: args.verdict,\n      ...(reasons ? { reasons } : {}),\n      ...(typeof args.note === \"string\" && args.note.trim() ? { note: args.note } : {}),\n    });\n    if (!parsed.success) {\n      const issue = parsed.error.issues[0];\n      fail(\"VALIDATION_ERROR\", `--${String(issue?.path[0] ?? \"args\")}: ${issue?.message ?? \"invalid\"}`);\n    }\n    const body = parsed.data;\n    const noteUnconfirmed = await refuseNotFeedback(body);\n    const idea = ideaToKeep(body);\n    try {\n      const response = await apiPost<CreativesFeedbackRecordResponse>(\n        \"/api/creatives/feedback/record\",\n        noteUnconfirmed ? { ...body, noteUnconfirmed } : body,\n      );\n      writeJson(await withIdea(await withRules(response, body, noteUnconfirmed), idea));\n    } catch (err) {\n      if (err instanceof ApiError) fail(err.code, err.message);\n      fail(\"INTERNAL_ERROR\", \"Unexpected error\");\n    }\n  },\n});\n","/**\n * Whether a rejection's note is the agent's own words rather than the person's taste: the label\n * of an option the agent offered (\"Sí, corrige todo (Recomendado)\") or the answer to its own\n * \"fix what is pending?\" (\"Fix everything\"). Production Oct 2026: both were recorded as\n * rejections, so every fix became a new version and later chats read the agent's own defects as\n * the company's taste. The agent writes those options in the marketer's language, so the decision\n * model reads the note in whatever language it is in (docs/decision-model.md).\n */\nimport { askJev } from \"../../engine/nodes/local/lib/jev.ts\";\nimport type { ReviewUsage } from \"../../engine/nodes/local/lib/render-review.ts\";\nimport { holdWorkspaceSpend } from \"../canvas/unbilled-spend.ts\";\n\n/**\n * The bands, measured 2026-10-07 on 30 notes in 8 languages (scripts/agent-option-note-evals,\n * three runs). A recommended tag scored 0.92 or more on the agent's labels and 0.03 or less on\n * people's notes. A bare yes to fixing scored 0.59 or more on the agent's untagged answers and\n * 0.31 or less on people's, except \"fix all the typos\" (0.52-0.56), which names its problem\n * (0.86; the agent's answers 0.12 or less).\n */\nexport const NOTE_BANDS = { tagged: 0.5, bareFix: 0.45, namesProblem: 0.5 } as const;\n\nconst TAGGED = \"Does `note` end with a tag marking it as the recommended option, like (Recommended), in any language?\";\nconst BARE_FIX =\n  'Is `note` a bare yes to an offer to fix things, like \"fix everything\" or \"fix what is pending\", naming no particular problem? A note that names what is wrong or what to change (the typos, the price, cut-off text, redo the pieces) is not.';\nconst NAMES_PROBLEM =\n  \"Does `note` name a particular problem, element or part of an ad (a typo, the price, the logo, the audio, the text, the colours, a person), apart from a whole format or size?\";\n\n/** Three judgments about one note, each a probability; one judgment per question, combined in code. */\nexport type NoteReading = { tagged: number; bareFix: number; namesProblem: number };\n\n/** The decision model's reading of `note`; null when no judgment came back. */\nexport type NoteJudge = (note: string) => Promise<NoteReading | null>;\n\n/** The decision model as the judge: three Nouls in one request. */\nexport const jevNoteJudge: NoteJudge = async (note) => {\n  const spent: ReviewUsage[] = [];\n  const answers = await askJev(\n    [TAGGED, BARE_FIX, NAMES_PROBLEM].map((question) => ({ instructions: { note, question } })),\n    (usage) => spent.push(usage),\n  );\n  await holdWorkspaceSpend(spent);\n  if (answers === null) return null;\n  const [tagged = 0, bareFix = 0, namesProblem = 1] = answers;\n  return { tagged, bareFix, namesProblem };\n};\n\n/** The agent's option label, or its bare fix answer naming nothing of the ad. Pure. */\nexport function readsAsAgentOption(reading: NoteReading): boolean {\n  if (reading.tagged >= NOTE_BANDS.tagged) return true;\n  return reading.bareFix >= NOTE_BANDS.bareFix && reading.namesProblem < NOTE_BANDS.namesProblem;\n}\n\n/** Whose words a note is: the agent's own option, the person's, or unconfirmed when no judgment came back. */\nexport type NoteAuthor = \"agent_option\" | \"person\" | \"unconfirmed\";\n\n/**\n * Who wrote `note`, as the decision model reads it. No judgment (no key, a timeout, an outage) is\n * \"unconfirmed\", never the person's: Baker keeps that note but does not read it as taste (B5).\n */\nexport async function readNoteAuthor(note: string, judge: NoteJudge): Promise<NoteAuthor> {\n  const text = note.trim();\n  if (!text) return \"person\";\n  const reading = await judge(text).catch(() => null);\n  if (reading === null) return \"unconfirmed\";\n  return readsAsAgentOption(reading) ? \"agent_option\" : \"person\";\n}\n"],"mappings":"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","names":[]}

package/dist/fetch-HMUGSRE4.js

@@ -0,0 +1,177 @@
+import {
+  fetchHints,
+  redditPageFix
+} from "./chunk-SSTL3A7Z.js";
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-EGPYWJGZ.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
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/fetch.ts
+import { defineCommand } from "citty";
+var CONTENT_PREVIEW_CHARS = 2e4;
+var TIMEOUT_MS = 18e4;
+registerSchema({
+  command: "research.fetch",
+  description: "Read a page an ordinary web fetch could not \u2014 bot walls and JavaScript-rendered pages are resolved for you. Use it when your normal page read came back with a security check, an error page, or an empty shell.",
+  args: {
+    url: { type: "string", description: "Full URL of the page to read", required: true },
+    format: {
+      type: "string",
+      description: "markdown (default, best for reading) or html (when you need the markup)",
+      required: false,
+      enum: ["markdown", "html"]
+    },
+    "wait-for": {
+      type: "number",
+      description: "Extra ms to let late content settle (0-30000). Only for pages that fill in after load",
+      required: false
+    },
+    "whole-page": {
+      type: "boolean",
+      description: "Include nav, footer and sidebars (default: main content only)",
+      required: false,
+      default: false
+    },
+    full: {
+      type: "boolean",
+      description: `Return the whole page instead of the first ${CONTENT_PREVIEW_CHARS} characters`,
+      required: false,
+      default: false
+    }
+  }
+});
+var FIELDS = {
+  url: "The URL as asked for",
+  final_url: "Where the read landed after redirects",
+  title: "Page title, or null when the page declares none",
+  content: "The page text (markdown by default)",
+  content_chars: "Length of the full page available on the server",
+  content_shown: "Characters in `content` \u2014 below content_chars unless --full",
+  truncated: "The page was longer than one read returns, so the tail is missing",
+  provider: "Who resolved the read"
+};
+function fetchFix(code) {
+  if (code === "VALIDATION_ERROR") {
+    return {
+      action: "retry_with_changes",
+      explanation: "Re-run with a complete address, including https://."
+    };
+  }
+  if (code === "TIMEOUT") {
+    return {
+      action: "retry_with_changes",
+      explanation: "The page never settled. Retry this URL once with `--wait-for 10000`; if that fails too, carry on with the rest of the job and say this page couldn't be read."
+    };
+  }
+  if (code === "RATE_LIMITED") {
+    return {
+      action: "continue_without",
+      explanation: "The page reader is busy. Do the rest of the job first and come back to this URL once, later \u2014 don't loop on it."
+    };
+  }
+  if (code === "FORBIDDEN" || code === "NOT_FOUND") {
+    return {
+      action: "continue_without",
+      explanation: "This page will not open for us, and retrying will not change that. Carry on with the sources you can reach and say plainly which page you couldn't read."
+    };
+  }
+  return {
+    action: "continue_without",
+    explanation: "This read failed. Don't build a retry ladder around it \u2014 finish the rest of the job with what you can reach and name this page as a gap."
+  };
+}
+var fetchCommand = defineCommand({
+  meta: {
+    name: "fetch",
+    description: `Read a page an ordinary web fetch could not. Bot walls and JavaScript-rendered pages are resolved for you \u2014 you never have to retry, wait, or drive a browser yourself.
+
+Reach for this the moment a normal page read comes back with a security check, an error page, or an empty shell. One call, no escalation ladder.
+
+Examples:
+  baker research fetch "https://competitor.com/pricing"
+  baker research fetch "https://competitor.com/pricing" --full
+  baker research fetch "https://app.competitor.com/blog/post" --wait-for 5000
+  baker research fetch "https://competitor.com" --format html --whole-page`
+  },
+  args: {
+    url: { type: "positional", description: "URL of the page to read", required: false },
+    format: { type: "string", description: "markdown (default) or html", required: false },
+    "wait-for": { type: "string", description: "Extra ms to let late content settle (0-30000)", required: false },
+    "whole-page": { type: "boolean", description: "Include nav, footer and sidebars", required: false },
+    full: { type: "boolean", description: "Return the whole page, not just the first chunk", required: false }
+  },
+  run: async ({ args }) => {
+    const url = args.url;
+    if (!url) {
+      writeResearchJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "A URL is required",
+          fix: fetchFix("VALIDATION_ERROR")
+        }
+      });
+      process.exit(1);
+    }
+    const format = args.format ?? "markdown";
+    if (format !== "markdown" && format !== "html") {
+      writeResearchJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Format must be markdown or html",
+          fix: { action: "retry_with_changes", explanation: "Re-run with --format markdown or --format html." }
+        }
+      });
+      process.exit(1);
+    }
+    const body = { url, format };
+    if (args["wait-for"]) body.waitFor = Number(args["wait-for"]);
+    if (args["whole-page"]) body.onlyMainContent = false;
+    try {
+      const page = await apiPost("/api/research/fetch", body, { timeoutMs: TIMEOUT_MS });
+      const content = args.full ? page.content : page.content.slice(0, CONTENT_PREVIEW_CHARS);
+      writeResearchJson({
+        ok: true,
+        data: {
+          url: page.url,
+          final_url: page.finalUrl,
+          title: page.title,
+          content_chars: page.contentChars,
+          content_shown: content.length,
+          truncated: page.truncated,
+          provider: page.provider,
+          content
+        },
+        fields: FIELDS,
+        hints: fetchHints({
+          truncated: page.truncated,
+          contentChars: page.contentChars,
+          shownChars: content.length
+        })
+      });
+    } catch (err) {
+      handleResearchError(err, (code) => redditPageFix(url, code) ?? fetchFix(code));
+    }
+  }
+});
+export {
+  fetchCommand
+};
+//# sourceMappingURL=fetch-HMUGSRE4.js.map

package/dist/fetch-HMUGSRE4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/fetch.ts"],"sourcesContent":["import type { ResearchFetchRequest, ResearchFetchResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { fetchHints, redditPageFix } from \"./hints.ts\";\nimport { handleResearchError, type ResearchFix, writeResearchJson } from \"./output.ts\";\n\n/**\n * A page big enough to matter is bigger than a turn wants to carry, and the\n * read is cached — so the default shows the top of it and `--full` returns for\n * the rest at no extra cost.\n */\nconst CONTENT_PREVIEW_CHARS = 20_000;\n\n/** A page behind a bot wall can take a while to clear; the default 60s is not enough. */\nconst TIMEOUT_MS = 180_000;\n\nregisterSchema({\n  command: \"research.fetch\",\n  description:\n    \"Read a page an ordinary web fetch could not — bot walls and JavaScript-rendered pages are resolved for you. Use it when your normal page read came back with a security check, an error page, or an empty shell.\",\n  args: {\n    url: { type: \"string\", description: \"Full URL of the page to read\", required: true },\n    format: {\n      type: \"string\",\n      description: \"markdown (default, best for reading) or html (when you need the markup)\",\n      required: false,\n      enum: [\"markdown\", \"html\"],\n    },\n    \"wait-for\": {\n      type: \"number\",\n      description: \"Extra ms to let late content settle (0-30000). Only for pages that fill in after load\",\n      required: false,\n    },\n    \"whole-page\": {\n      type: \"boolean\",\n      description: \"Include nav, footer and sidebars (default: main content only)\",\n      required: false,\n      default: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: `Return the whole page instead of the first ${CONTENT_PREVIEW_CHARS} characters`,\n      required: false,\n      default: false,\n    },\n  },\n});\n\nconst FIELDS: Record<string, string> = {\n  url: \"The URL as asked for\",\n  final_url: \"Where the read landed after redirects\",\n  title: \"Page title, or null when the page declares none\",\n  content: \"The page text (markdown by default)\",\n  content_chars: \"Length of the full page available on the server\",\n  content_shown: \"Characters in `content` — below content_chars unless --full\",\n  truncated: \"The page was longer than one read returns, so the tail is missing\",\n  provider: \"Who resolved the read\",\n};\n\n/**\n * Every failure here is one source out of a larger job, so the remediation is\n * about finishing the job: name the gap, keep going. The only case worth a\n * second attempt is a page that never settled.\n */\nfunction fetchFix(code: string): ResearchFix {\n  if (code === \"VALIDATION_ERROR\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation: \"Re-run with a complete address, including https://.\",\n    };\n  }\n  if (code === \"TIMEOUT\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation:\n        \"The page never settled. Retry this URL once with `--wait-for 10000`; if that fails too, carry on with the rest of the job and say this page couldn't be read.\",\n    };\n  }\n  if (code === \"RATE_LIMITED\") {\n    return {\n      action: \"continue_without\",\n      explanation:\n        \"The page reader is busy. Do the rest of the job first and come back to this URL once, later — don't loop on it.\",\n    };\n  }\n  if (code === \"FORBIDDEN\" || code === \"NOT_FOUND\") {\n    return {\n      action: \"continue_without\",\n      explanation:\n        \"This page will not open for us, and retrying will not change that. Carry on with the sources you can reach and say plainly which page you couldn't read.\",\n    };\n  }\n  return {\n    action: \"continue_without\",\n    explanation:\n      \"This read failed. Don't build a retry ladder around it — finish the rest of the job with what you can reach and name this page as a gap.\",\n  };\n}\n\nexport const fetchCommand = defineCommand({\n  meta: {\n    name: \"fetch\",\n    description: `Read a page an ordinary web fetch could not. Bot walls and JavaScript-rendered pages are resolved for you — you never have to retry, wait, or drive a browser yourself.\n\nReach for this the moment a normal page read comes back with a security check, an error page, or an empty shell. One call, no escalation ladder.\n\nExamples:\n  baker research fetch \"https://competitor.com/pricing\"\n  baker research fetch \"https://competitor.com/pricing\" --full\n  baker research fetch \"https://app.competitor.com/blog/post\" --wait-for 5000\n  baker research fetch \"https://competitor.com\" --format html --whole-page`,\n  },\n  args: {\n    url: { type: \"positional\", description: \"URL of the page to read\", required: false },\n    format: { type: \"string\", description: \"markdown (default) or html\", required: false },\n    \"wait-for\": { type: \"string\", description: \"Extra ms to let late content settle (0-30000)\", required: false },\n    \"whole-page\": { type: \"boolean\", description: \"Include nav, footer and sidebars\", required: false },\n    full: { type: \"boolean\", description: \"Return the whole page, not just the first chunk\", required: false },\n  },\n  run: async ({ args }) => {\n    const url = args.url as string | undefined;\n    if (!url) {\n      writeResearchJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: \"A URL is required\",\n          fix: fetchFix(\"VALIDATION_ERROR\"),\n        },\n      });\n      process.exit(1);\n    }\n\n    const format = (args.format as string | undefined) ?? \"markdown\";\n    if (format !== \"markdown\" && format !== \"html\") {\n      writeResearchJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: \"Format must be markdown or html\",\n          fix: { action: \"retry_with_changes\", explanation: \"Re-run with --format markdown or --format html.\" },\n        },\n      });\n      process.exit(1);\n    }\n\n    const body: ResearchFetchRequest = { url, format };\n    if (args[\"wait-for\"]) body.waitFor = Number(args[\"wait-for\"]);\n    if (args[\"whole-page\"]) body.onlyMainContent = false;\n\n    try {\n      const page = await apiPost<ResearchFetchResponse>(\"/api/research/fetch\", body, { timeoutMs: TIMEOUT_MS });\n      const content = args.full ? page.content : page.content.slice(0, CONTENT_PREVIEW_CHARS);\n\n      writeResearchJson({\n        ok: true,\n        data: {\n          url: page.url,\n          final_url: page.finalUrl,\n          title: page.title,\n          content_chars: page.contentChars,\n          content_shown: content.length,\n          truncated: page.truncated,\n          provider: page.provider,\n          content,\n        },\n        fields: FIELDS,\n        hints: fetchHints({\n          truncated: page.truncated,\n          contentChars: page.contentChars,\n          shownChars: content.length,\n        }),\n      });\n    } catch (err) {\n      handleResearchError(err, (code) => redditPageFix(url, code) ?? fetchFix(code));\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAW9B,IAAM,wBAAwB;AAG9B,IAAM,aAAa;AAEnB,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,KAAK,EAAE,MAAM,UAAU,aAAa,gCAAgC,UAAU,KAAK;AAAA,IACnF,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,MAAM,CAAC,YAAY,MAAM;AAAA,IAC3B;AAAA,IACA,YAAY;AAAA,MACV,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,cAAc;AAAA,MACZ,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,IACA,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,aAAa,8CAA8C,qBAAqB;AAAA,MAChF,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,EACF;AACF,CAAC;AAED,IAAM,SAAiC;AAAA,EACrC,KAAK;AAAA,EACL,WAAW;AAAA,EACX,OAAO;AAAA,EACP,SAAS;AAAA,EACT,eAAe;AAAA,EACf,eAAe;AAAA,EACf,WAAW;AAAA,EACX,UAAU;AACZ;AAOA,SAAS,SAAS,MAA2B;AAC3C,MAAI,SAAS,oBAAoB;AAC/B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,aAAa;AAAA,IACf;AAAA,EACF;AACA,MAAI,SAAS,WAAW;AACtB,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,aACE;AAAA,IACJ;AAAA,EACF;AACA,MAAI,SAAS,gBAAgB;AAC3B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,aACE;AAAA,IACJ;AAAA,EACF;AACA,MAAI,SAAS,eAAe,SAAS,aAAa;AAChD,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,aACE;AAAA,IACJ;AAAA,EACF;AACA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,aACE;AAAA,EACJ;AACF;AAEO,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASf;AAAA,EACA,MAAM;AAAA,IACJ,KAAK,EAAE,MAAM,cAAc,aAAa,2BAA2B,UAAU,MAAM;AAAA,IACnF,QAAQ,EAAE,MAAM,UAAU,aAAa,8BAA8B,UAAU,MAAM;AAAA,IACrF,YAAY,EAAE,MAAM,UAAU,aAAa,iDAAiD,UAAU,MAAM;AAAA,IAC5G,cAAc,EAAE,MAAM,WAAW,aAAa,oCAAoC,UAAU,MAAM;AAAA,IAClG,MAAM,EAAE,MAAM,WAAW,aAAa,mDAAmD,UAAU,MAAM;AAAA,EAC3G;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,MAAM,KAAK;AACjB,QAAI,CAAC,KAAK;AACR,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ,OAAO;AAAA,UACL,MAAM;AAAA,UACN,SAAS;AAAA,UACT,KAAK,SAAS,kBAAkB;AAAA,QAClC;AAAA,MACF,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,SAAU,KAAK,UAAiC;AACtD,QAAI,WAAW,cAAc,WAAW,QAAQ;AAC9C,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ,OAAO;AAAA,UACL,MAAM;AAAA,UACN,SAAS;AAAA,UACT,KAAK,EAAE,QAAQ,sBAAsB,aAAa,kDAAkD;AAAA,QACtG;AAAA,MACF,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,OAA6B,EAAE,KAAK,OAAO;AACjD,QAAI,KAAK,UAAU,EAAG,MAAK,UAAU,OAAO,KAAK,UAAU,CAAC;AAC5D,QAAI,KAAK,YAAY,EAAG,MAAK,kBAAkB;AAE/C,QAAI;AACF,YAAM,OAAO,MAAM,QAA+B,uBAAuB,MAAM,EAAE,WAAW,WAAW,CAAC;AACxG,YAAM,UAAU,KAAK,OAAO,KAAK,UAAU,KAAK,QAAQ,MAAM,GAAG,qBAAqB;AAEtF,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ,MAAM;AAAA,UACJ,KAAK,KAAK;AAAA,UACV,WAAW,KAAK;AAAA,UAChB,OAAO,KAAK;AAAA,UACZ,eAAe,KAAK;AAAA,UACpB,eAAe,QAAQ;AAAA,UACvB,WAAW,KAAK;AAAA,UAChB,UAAU,KAAK;AAAA,UACf;AAAA,QACF;AAAA,QACA,QAAQ;AAAA,QACR,OAAO,WAAW;AAAA,UAChB,WAAW,KAAK;AAAA,UAChB,cAAc,KAAK;AAAA,UACnB,YAAY,QAAQ;AAAA,QACtB,CAAC;AAAA,MACH,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,KAAK,CAAC,SAAS,cAAc,KAAK,IAAI,KAAK,SAAS,IAAI,CAAC;AAAA,IAC/E;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/find-2EPXK5RF.js

@@ -0,0 +1,134 @@
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-IBTSIPYA.js";
+import {
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  ApiError,
+  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/images/find.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.find",
+  description: "Fanout image search: library first, then opted-in external providers.",
+  args: {
+    query: { type: "string", description: "Search query", required: true },
+    sources: {
+      type: "string",
+      description: "Comma-separated providers: library,pexels,pixabay,google,iconify,giphy,pinterest (brandfetch lives at `baker images logo`)",
+      required: false
+    },
+    limit: { type: "number", description: "Max results per group", required: false, default: 20 },
+    fallback: {
+      type: "boolean",
+      description: "Only cascade to externals when top library score < threshold",
+      required: false,
+      default: false
+    },
+    threshold: { type: "number", description: "Fallback threshold (0-1)", required: false, default: 0.6 },
+    "auto-ingest": {
+      type: "number",
+      description: `Auto-ingest top N external hits (0-${AUTO_INGEST_MAX.find}, default 0) and return Baker-owned URLs on ingested hits`,
+      required: false,
+      default: 0
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to every auto-ingested hit (overrides provider-derived context)",
+      required: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  }
+});
+var findCommand = defineCommand({
+  meta: {
+    name: "find",
+    description: "Library-first fanout image search. Opt in to providers with --sources. `--fallback` short-circuits to externals only when library is thin. With --auto-ingest, ingested external hits return Baker-owned URLs.\n\nExample: baker images find 'office' --sources library,pexels --limit 20"
+  },
+  args: {
+    query: { type: "positional", description: "Search query", required: false },
+    sources: { type: "string", description: "Comma-separated providers", required: false },
+    limit: { type: "string", description: "Max results per group (default 20)", required: false },
+    fallback: { type: "boolean", description: "Cascade to externals only when library thin", required: false },
+    threshold: { type: "string", description: "Fallback threshold (default 0.6)", required: false },
+    "auto-ingest": {
+      type: "string",
+      description: `Auto-ingest top N external hits (0-${AUTO_INGEST_MAX.find}) and return Baker-owned URLs on ingested hits`,
+      required: false
+    },
+    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
+        process.exit(1);
+      }
+      const body = { query };
+      if (args.sources) {
+        body.sources = args.sources.split(",").filter(Boolean);
+      }
+      if (args.limit) body.limit = Number(args.limit);
+      if (args.fallback) body.fallback = true;
+      if (args.threshold) body.threshold = Number(args.threshold);
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.find);
+        if (!parsed.ok) {
+          writeJson({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: parsed.message,
+              fix: {
+                action: "retry_with_changes",
+                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.find}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/find", body);
+      const hits = [...data.groups.library, ...data.groups.external];
+      const hints = emptyResultHints({
+        provider: "find",
+        hitCount: hits.length,
+        activeFilters: args.fallback ? ["--fallback"] : [],
+        subject: query
+      });
+      writeProviderHits(data, hits, args, hints);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  findCommand
+};
+//# sourceMappingURL=find-2EPXK5RF.js.map