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

package/dist/feedback-PQUM7UBT.js

@@ -0,0 +1,114 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-6IL7JFX5.js";
+import {
+  PLATFORM_REPORT_KINDS,
+  feedbackReportRequestSchema
+} from "./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/feedback/index.ts
+import { defineCommand } from "citty";
+var DOC = "__tooling__/docs/tools/baker/feedback.md";
+var ARGS = {
+  kind: {
+    type: "string",
+    description: "bug \u2014 something in Baker is broken (a command, check, hook, skill or doc does the wrong thing). feature \u2014 Baker has no way to do what the work needs.",
+    required: true
+  },
+  title: {
+    type: "string",
+    description: `One sentence, what is wrong or missing, in Baker's terms: "baker winning-ads has no way to read one country's ads".`,
+    required: true
+  },
+  body: {
+    type: "string",
+    description: "What you ran, what came back (the exact message), what you expected, and what you ruled out. Describe the problem, not the client: no names, emails or figures from their accounts.",
+    required: true
+  },
+  "user-asked": {
+    type: "boolean",
+    description: "Set when the user asked you to tell the Baker team. Leave it off when you are reporting on your own; the team reads which it was.",
+    required: false,
+    default: false
+  }
+};
+registerSchema({
+  command: "feedback.report",
+  description: `Start here when Baker itself is in the way: a command, check, hook, skill or doc that is broken, or a capability the work needs that Baker does not have. Example: baker feedback report --kind bug --title "verify fails on an archived test version" --body "\u2026" (add --user-asked when the user asked you to). Answers as soon as it is saved; it reaches the Baker team on its own, with the client's details taken out. Never a Task, never a message for the user to pass on. Then say one plain line to the user and keep going with what you can still do.`,
+  args: ARGS
+});
+var REPORT_HINTS = [
+  "The Baker team has it: once saved, the report reaches their tracker on its own, so a status of sending is the normal answer and there is nothing more to do or to tell the user about delivery. Tell the user in one plain line that you let the Baker team know \u2014 no ids, commands or file names \u2014 and never ask them to pass it on.",
+  "Then keep going: work around it with what this workspace still lets you change (the pages, Forms, Knowledge and Brand you own, a staged change instead of a blocked one), finish the rest of the job, and say plainly what is left undone. One broken piece should not stop the whole task.",
+  "It is not a Task: don't also file one for it."
+];
+function reportBody(args) {
+  if (!PLATFORM_REPORT_KINDS.includes(args.kind ?? "")) {
+    return { ok: false, error: `--kind is ${PLATFORM_REPORT_KINDS.join(" or ")}, got "${args.kind ?? ""}".` };
+  }
+  const parsed = feedbackReportRequestSchema.safeParse({
+    kind: args.kind,
+    title: args.title,
+    body: args.body,
+    askedByUser: args["user-asked"] === true
+  });
+  if (!parsed.success) {
+    return {
+      ok: false,
+      error: "A report needs a --title of at least 10 characters (one sentence, what is wrong or missing) and a --body of at least 20 (what you ran, what came back, what you expected)."
+    };
+  }
+  return { ok: true, body: parsed.data };
+}
+var reportCommand = defineCommand({
+  meta: {
+    name: "report",
+    description: `Tell the Baker team about a defect in Baker or a capability it lacks; sent to their tracker at once.
+Start here: baker feedback report --kind bug --title "<what is wrong, one sentence>" --body "<what you ran, what came back, what you expected>"`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const parsed = reportBody(args);
+    if (!parsed.ok) {
+      failValidation(parsed.error);
+    }
+    try {
+      const response = await apiPost("/api/feedback/report", parsed.body);
+      writeJson({ ok: true, data: response.data, hints: REPORT_HINTS });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var feedbackCommand = defineCommand({
+  meta: {
+    name: "feedback",
+    description: `Report a defect in Baker, or a capability it lacks, to the Baker team \u2014 never to the user, never as a Task. Subcommands: report.
+Full guide: ${DOC}`
+  },
+  subCommands: { report: reportCommand }
+});
+export {
+  REPORT_HINTS,
+  feedbackCommand,
+  reportBody
+};
+//# sourceMappingURL=feedback-PQUM7UBT.js.map

package/dist/feedback-record-4MVI4O3Q.js

@@ -0,0 +1,270 @@
+import {
+  readCreativeIdea,
+  withAnchor
+} from "./chunk-3BKESS5W.js";
+import {
+  modelRuleDrafter,
+  repeatedReasons,
+  ruleCandidateHints,
+  ruleCandidates,
+  saveCandidates
+} from "./chunk-CKIENAAO.js";
+import {
+  versionOf
+} from "./chunk-3X262BEG.js";
+import "./chunk-AYX7PB2L.js";
+import "./chunk-PSM3RI4B.js";
+import "./chunk-2W6DMVGH.js";
+import "./chunk-XPUQFPIU.js";
+import "./chunk-4JB556VC.js";
+import "./chunk-RYNN6UUF.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-ZPCZ4XDB.js";
+import "./chunk-J63TN3GR.js";
+import "./chunk-VK2VC6A2.js";
+import "./chunk-M3IXPK6U.js";
+import {
+  frontmatterOf
+} from "./chunk-KPVZ2CZA.js";
+import "./chunk-7CHPHER2.js";
+import "./chunk-UNLFRXST.js";
+import "./chunk-ESSA3AWR.js";
+import "./chunk-LGJIJVVH.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-VCDFBFPT.js";
+import {
+  holdWorkspaceSpend
+} from "./chunk-Q4O7ICAK.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-4CYB33V3.js";
+import "./chunk-EGZM35HT.js";
+import "./chunk-7Y3LKR4P.js";
+import "./chunk-HBXR26LB.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-4LZNCDHU.js";
+import "./chunk-R5NABIJ4.js";
+import "./chunk-OGWCLE4W.js";
+import "./chunk-F3CZFUXZ.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import {
+  askJev
+} from "./chunk-AGL7EWP2.js";
+import "./chunk-XQEHLDGP.js";
+import "./chunk-2B2JFTWI.js";
+import "./chunk-XKYFNMTB.js";
+import {
+  CREATIVE_FEEDBACK_REASONS,
+  creativesFeedbackRecordRequestSchema
+} from "./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 {
+  ApiError,
+  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/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 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-4MVI4O3Q.js.map

package/dist/feedback-record-4MVI4O3Q.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 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-3PWYTX4R.js

@@ -0,0 +1,139 @@
+import {
+  MAX_VIDEO_INGEST_SECONDS,
+  downloadTimeoutMs,
+  refuseByDuration
+} from "./chunk-FKOECEVC.js";
+import {
+  YtDlpError,
+  durationSeconds,
+  isAudioOnly,
+  probeYtDlp,
+  runYtDlp
+} from "./chunk-2B2JFTWI.js";
+import {
+  captureVimeoCookie
+} from "./chunk-6LUDG5AB.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-6V4UAC5I.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/fetch.ts
+import { constants } from "fs";
+import { copyFile, mkdir, mkdtemp, rm } from "fs/promises";
+import { tmpdir } from "os";
+import path from "path";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "videos.fetch",
+  description: "Download a video page (YouTube, TikTok, Vimeo, \u2026) to a local .mp4 without adding it to the library. For editing a clip locally; use `videos ingest` to add one to the library.",
+  args: {
+    url: { type: "string", description: "Video page URL", required: true },
+    out: { type: "string", description: "Directory to write the file into (created if missing)", required: true },
+    "max-seconds": {
+      type: "string",
+      description: `Refuse videos longer than this many seconds (default ${MAX_VIDEO_INGEST_SECONDS})`,
+      required: false
+    },
+    "timeout-ms": { type: "string", description: "Download time limit in milliseconds", required: false },
+    "max-height": {
+      type: "string",
+      description: "Keep a version whose shorter side is at most this many pixels (e.g. 1080 \u2014 a vertical Short keeps 1080\xD71920) when the site offers one",
+      required: false
+    }
+  }
+});
+function positiveInt(value) {
+  const parsed = typeof value === "string" ? Number.parseInt(value, 10) : Number.NaN;
+  return Number.isInteger(parsed) && parsed > 0 ? parsed : void 0;
+}
+var fetchCommand = defineCommand({
+  meta: {
+    name: "fetch",
+    description: "Download a video page to a local .mp4 without adding it to the library. Same downloader as `ingest` (proxy fallback, duration check).\n\nExample: baker videos fetch https://www.youtube.com/watch?v=abc123 --out ./clips"
+  },
+  args: {
+    url: { type: "positional", description: "Video page URL", required: true },
+    out: { type: "string", description: "Directory to write the file into", required: true },
+    "max-seconds": { type: "string", description: "Refuse videos longer than this", required: false },
+    "timeout-ms": { type: "string", description: "Download time limit in milliseconds", required: false },
+    "max-height": {
+      type: "string",
+      description: "Cap the shorter side at this many pixels (e.g. 1080)",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    const result = await fetchVideo({
+      url: String(args.url ?? ""),
+      out: String(args.out ?? ""),
+      maxSeconds: positiveInt(args["max-seconds"]),
+      timeoutMs: positiveInt(args["timeout-ms"]),
+      maxHeight: positiveInt(args["max-height"])
+    });
+    writeJson(result);
+    if (!result.ok) process.exit(1);
+  }
+});
+async function fetchVideo(args) {
+  const outDir = path.resolve(args.out);
+  const workDir = await mkdtemp(path.join(tmpdir(), "videos-fetch-"));
+  try {
+    await mkdir(outDir, { recursive: true });
+    const vimeoCookie = captureVimeoCookie();
+    const probe = await probeYtDlp({ url: args.url, vimeoCookie, cookieDir: workDir });
+    if (isAudioOnly(probe.info)) {
+      return { ok: false, error: { code: "VALIDATION_ERROR", message: "That link is audio, not video." } };
+    }
+    const seconds = durationSeconds(probe.info);
+    const tooLong = refuseByDuration(seconds, args.maxSeconds ?? MAX_VIDEO_INGEST_SECONDS);
+    if (tooLong) {
+      return { ok: false, error: { code: "VALIDATION_ERROR", message: tooLong } };
+    }
+    const { filePath, tier, reducedQuality } = await runYtDlp({
+      url: args.url,
+      audioOnly: false,
+      workDir,
+      vimeoCookie,
+      timeoutMs: args.timeoutMs ?? downloadTimeoutMs(seconds),
+      maxHeight: args.maxHeight
+    });
+    return {
+      ok: true,
+      data: {
+        file: await placeInto(outDir, filePath, fileStem(probe.info)),
+        durationSeconds: seconds,
+        egress: tier,
+        ...reducedQuality ? { reducedQuality: true } : {}
+      }
+    };
+  } catch (err) {
+    const message = err instanceof YtDlpError ? `${err.message}: ${err.stderrTail}`.trim() : err instanceof Error ? err.message : String(err);
+    return { ok: false, error: { code: "DOWNLOAD_FAILED", message } };
+  } finally {
+    await rm(workDir, { recursive: true, force: true }).catch(() => {
+    });
+  }
+}
+function fileStem(info) {
+  const parts = [info.extractor_key, info.id].filter((part) => typeof part === "string" && part !== "");
+  const stem = parts.join("-").toLowerCase().replace(/[^a-z0-9._-]+/g, "_").replace(/^[._-]+/, "");
+  return stem === "" ? "video" : stem;
+}
+async function placeInto(outDir, source, stem) {
+  for (let n = 1; ; n++) {
+    const target = path.join(outDir, `${stem}${n === 1 ? "" : `-${n}`}${path.extname(source)}`);
+    try {
+      await copyFile(source, target, constants.COPYFILE_EXCL);
+      return target;
+    } catch (err) {
+      if (!(err instanceof Error && "code" in err && err.code === "EEXIST")) throw err;
+    }
+  }
+}
+export {
+  fetchCommand,
+  fetchVideo
+};
+//# sourceMappingURL=fetch-3PWYTX4R.js.map