@koda-sl/baker-cli 0.445.0 → 0.446.0-dev.918a09305

package/dist/feedback-NZDBN3MD.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/creatives/feedback.ts"],"sourcesContent":["import type { CreativesFeedbackRequest, CreativesFeedbackResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\n\nconst DESCRIPTION =\n  \"Read what this company's reviewers said about creative versions: recent approved / rejected verdicts with reasons and notes, the top rejection reasons, what approved versions share (format, platform, option), and hints[] saying what to do differently. Start here before making or changing a creative: baker creatives feedback; then baker creatives feedback --slug <slug> for one creative's history. When the user reacts to a version in the chat, record it with baker creatives feedback record.\";\n\nconst SLUG_DESCRIPTION = \"One creative's feedback (src/creatives/<slug>/). Left out, the whole company's.\";\nconst FULL_DESCRIPTION = \"Every verdict as stored (up to 200), notes whole. Default is a summary plus the 8 latest.\";\n\nregisterSchema({\n  command: \"creatives.feedback\",\n  description: DESCRIPTION,\n  args: {\n    slug: { type: \"string\", description: SLUG_DESCRIPTION, required: false },\n    full: { type: \"boolean\", description: FULL_DESCRIPTION, required: false },\n  },\n});\n\nconst readArgs = {\n  slug: { type: \"string\", description: SLUG_DESCRIPTION, required: false },\n  full: { type: \"boolean\", description: FULL_DESCRIPTION, required: false, default: false },\n} as const;\n\nconst feedbackReadCommand = defineCommand({\n  meta: { name: \"read\", description: `${DESCRIPTION} Runs by default when no subcommand is given.` },\n  args: readArgs,\n  run: async ({ args }) => {\n    try {\n      const body: CreativesFeedbackRequest = {\n        ...(typeof args.slug === \"string\" && args.slug.length > 0 ? { slug: args.slug } : {}),\n        ...(args.full === true ? { full: true } : {}),\n      };\n      writeJson(await apiPost<CreativesFeedbackResponse>(\"/api/creatives/feedback\", body));\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n\nexport const feedbackCommand = defineCommand({\n  meta: { name: \"feedback\", description: DESCRIPTION },\n  subCommands: {\n    read: feedbackReadCommand,\n    record: () => import(\"./feedback-record.ts\").then((m) => m.feedbackRecordCommand),\n  },\n  // `args` stays although the parent has no `run`: citty finds the subcommand\n  // name with THIS command's arg defs, so without them `--slug spring-offer`\n  // would read `spring-offer` as a subcommand. `default` (not `run`) serves the\n  // bare invocation, since citty runs a parent's `run` after its subcommand too.\n  args: readArgs,\n  default: \"read\",\n});\n"],"mappings":";;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAK9B,IAAM,cACJ;AAEF,IAAM,mBAAmB;AACzB,IAAM,mBAAmB;AAEzB,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,UAAU,aAAa,kBAAkB,UAAU,MAAM;AAAA,IACvE,MAAM,EAAE,MAAM,WAAW,aAAa,kBAAkB,UAAU,MAAM;AAAA,EAC1E;AACF,CAAC;AAED,IAAM,WAAW;AAAA,EACf,MAAM,EAAE,MAAM,UAAU,aAAa,kBAAkB,UAAU,MAAM;AAAA,EACvE,MAAM,EAAE,MAAM,WAAW,aAAa,kBAAkB,UAAU,OAAO,SAAS,MAAM;AAC1F;AAEA,IAAM,sBAAsB,cAAc;AAAA,EACxC,MAAM,EAAE,MAAM,QAAQ,aAAa,GAAG,WAAW,gDAAgD;AAAA,EACjG,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,OAAiC;AAAA,QACrC,GAAI,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,SAAS,IAAI,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;AAAA,QACnF,GAAI,KAAK,SAAS,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAAA,MAC7C;AACA,gBAAU,MAAM,QAAmC,2BAA2B,IAAI,CAAC;AAAA,IACrF,SAAS,KAAK;AACZ,UAAI,eAAe,UAAU;AAC3B,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,gBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,mBAAmB,EAAE,CAAC;AACvF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;AAEM,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM,EAAE,MAAM,YAAY,aAAa,YAAY;AAAA,EACnD,aAAa;AAAA,IACX,MAAM;AAAA,IACN,QAAQ,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,qBAAqB;AAAA,EAClF;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM;AAAA,EACN,SAAS;AACX,CAAC;","names":[]}

package/dist/feedback-record-3ZLSSBOI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/creatives/feedback-record.ts","../src/commands/creatives/agent-option-note.ts"],"sourcesContent":["import {\n  CREATIVE_FEEDBACK_REASONS,\n  type CreativesFeedbackRecordResponse,\n  creativesFeedbackRecordRequestSchema,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { jevNoteJudge, readNoteAuthor } from \"./agent-option-note.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.`;\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\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    try {\n      const response = await apiPost<CreativesFeedbackRecordResponse>(\n        \"/api/creatives/feedback/record\",\n        noteUnconfirmed ? { ...body, noteUnconfirmed } : body,\n      );\n      writeJson(response);\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,SAAS,qBAAqB;;;ACcvB,IAAM,aAAa,EAAE,QAAQ,KAAK,SAAS,MAAM,cAAc,IAAI;AAE1E,IAAM,SAAS;AACf,IAAM,WACJ;AACF,IAAM,gBACJ;AASK,IAAM,eAA0B,OAAO,SAAS;AACrD,QAAM,QAAuB,CAAC;AAC9B,QAAM,UAAU,MAAM;AAAA,IACpB,CAAC,QAAQ,UAAU,aAAa,EAAE,IAAI,CAAC,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,EAAE,EAAE;AAAA,IAC1F,CAAC,UAAU,MAAM,KAAK,KAAK;AAAA,EAC7B;AACA,QAAM,mBAAmB,KAAK;AAC9B,MAAI,YAAY,KAAM,QAAO;AAC7B,QAAM,CAAC,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC,IAAI;AACpD,SAAO,EAAE,QAAQ,SAAS,aAAa;AACzC;AAGO,SAAS,mBAAmB,SAA+B;AAChE,MAAI,QAAQ,UAAU,WAAW,OAAQ,QAAO;AAChD,SAAO,QAAQ,WAAW,WAAW,WAAW,QAAQ,eAAe,WAAW;AACpF;AASA,eAAsB,eAAe,MAAc,OAAuC;AACxF,QAAM,OAAO,KAAK,KAAK;AACvB,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,UAAU,MAAM,MAAM,IAAI,EAAE,MAAM,MAAM,IAAI;AAClD,MAAI,YAAY,KAAM,QAAO;AAC7B,SAAO,mBAAmB,OAAO,IAAI,iBAAiB;AACxD;;;ADrDA,IAAM,cAAc;AAAA;AAAA;AAIpB,IAAM,OAAO;AAAA,EACX,MAAM,EAAE,MAAM,UAAU,aAAa,uDAAuD,UAAU,KAAK;AAAA,EAC3G,KAAK;AAAA,IACH,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,aACE;AAAA,IACF,UAAU;AAAA,EACZ;AAAA,EACA,SAAS,EAAE,MAAM,UAAU,aAAa,uBAAuB,UAAU,KAAK;AAAA,EAC9E,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa,yCAAyC,0BAA0B,KAAK,IAAI,CAAC;AAAA,IAC1F,UAAU;AAAA,EACZ;AAAA,EACA,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AACF;AAEA,eAAe,EAAE,SAAS,6BAA6B,aAAa,aAAa,MAAM,KAAK,CAAC;AAE7F,SAAS,UAAU,OAAsC;AACvD,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,GAAI,QAAO;AAC7D,SAAO,MACJ,MAAM,GAAG,EACT,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,EACzB,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC;AACrC;AAEA,SAAS,KAAK,MAAc,SAAwB;AAClD,YAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,QAAQ,EAAE,CAAC;AACjD,UAAQ,KAAK,CAAC;AAChB;AAMA,eAAe,kBAAkB,MAIZ;AACnB,MAAI,KAAK,YAAY,cAAc,CAAC,KAAK,SAAS,UAAU,CAAC,KAAK,MAAM;AACtE;AAAA,MACE;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,MAAI,KAAK,YAAY,cAAc,CAAC,KAAK,KAAM,QAAO;AACtD,QAAM,SAAS,MAAM,eAAe,KAAK,MAAM,YAAY;AAC3D,MAAI,WAAW,gBAAgB;AAC7B;AAAA,MACE;AAAA,MACA,IAAI,KAAK,IAAI;AAAA,IACf;AAAA,EACF;AACA,SAAO,WAAW;AACpB;AAEO,IAAM,wBAAwB,cAAc;AAAA,EACjD,MAAM,EAAE,MAAM,UAAU,aAAa,YAAY;AAAA,EACjD,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,UAAU,UAAU,KAAK,OAAO;AACtC,UAAM,WAAW,WAAW,CAAC,GAAG;AAAA,MAC9B,CAAC,WAAW,CAAE,0BAAgD,SAAS,MAAM;AAAA,IAC/E;AACA,QAAI,QAAQ,SAAS,GAAG;AACtB,WAAK,oBAAoB,kBAAkB,QAAQ,KAAK,IAAI,CAAC,UAAU,0BAA0B,KAAK,IAAI,CAAC,GAAG;AAAA,IAChH;AACA,UAAM,SAAS,qCAAqC,UAAU;AAAA,MAC5D,MAAM,KAAK;AAAA,MACX,OAAO,MAAM,UAAU,OAAO,KAAK,IAAI,GAAG,KAAK,GAAG,EAAE;AAAA,QAClD,CAAC,QAAQ,OAAO,KAAK,oBAAoB,yEAAoE;AAAA,MAC/G;AAAA,MACA,GAAI,OAAO,KAAK,WAAW,YAAY,KAAK,OAAO,KAAK,IAAI,EAAE,QAAQ,KAAK,OAAO,KAAK,EAAE,IAAI,CAAC;AAAA,MAC9F,SAAS,KAAK;AAAA,MACd,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,MAC7B,GAAI,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,KAAK,IAAI,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;AAAA,IACjF,CAAC;AACD,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,QAAQ,OAAO,MAAM,OAAO,CAAC;AACnC,WAAK,oBAAoB,KAAK,OAAO,OAAO,KAAK,CAAC,KAAK,MAAM,CAAC,KAAK,OAAO,WAAW,SAAS,EAAE;AAAA,IAClG;AACA,UAAM,OAAO,OAAO;AACpB,UAAM,kBAAkB,MAAM,kBAAkB,IAAI;AACpD,QAAI;AACF,YAAM,WAAW,MAAM;AAAA,QACrB;AAAA,QACA,kBAAkB,EAAE,GAAG,MAAM,gBAAgB,IAAI;AAAA,MACnD;AACA,gBAAU,QAAQ;AAAA,IACpB,SAAS,KAAK;AACZ,UAAI,eAAe,SAAU,MAAK,IAAI,MAAM,IAAI,OAAO;AACvD,WAAK,kBAAkB,kBAAkB;AAAA,IAC3C;AAAA,EACF;AACF,CAAC;","names":[]}