@koda-sl/baker-cli 0.573.0 → 0.574.0

package/dist/rerun-LSWO6K7O.js

@@ -0,0 +1,97 @@
+import {
+  executeCanvasRun
+} from "./chunk-XGTZ3WQX.js";
+import "./chunk-VUG7DFVI.js";
+import "./chunk-Z3KRNKEA.js";
+import "./chunk-WN4KX7GE.js";
+import "./chunk-UYVMINV2.js";
+import "./chunk-IVIJJXXT.js";
+import "./chunk-KKJ4KJCW.js";
+import "./chunk-Q6ULQMWG.js";
+import "./chunk-6AMN346B.js";
+import "./chunk-3ACMDRSE.js";
+import "./chunk-I7OJZ7QE.js";
+import "./chunk-O5K5EKJC.js";
+import "./chunk-P7OX5Y75.js";
+import "./chunk-M7BSXJNL.js";
+import "./chunk-MVDMMSXS.js";
+import "./chunk-M27HR7YD.js";
+import "./chunk-BXR45CRI.js";
+import "./chunk-WB4FNMSI.js";
+import "./chunk-WUNWVQAI.js";
+import "./chunk-DN6EMVA4.js";
+import "./chunk-SO7NANAH.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-YP5SD6O2.js";
+import "./chunk-KSBXVA4K.js";
+import "./chunk-BNEWJXKU.js";
+import "./chunk-FUFLMP4B.js";
+import "./chunk-L6UZM3ZN.js";
+import "./chunk-6PJGHPXG.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-HZ7QUFUW.js";
+import "./chunk-T4HIFVNK.js";
+import "./chunk-CGLNCFAG.js";
+import "./chunk-BYV4VS5E.js";
+import "./chunk-7LFOSBF4.js";
+import "./chunk-LRIP2J5S.js";
+import "./chunk-AYOTYURE.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-MQU4LNYG.js";
+import "./chunk-NEALLMDP.js";
+import "./chunk-37QNC344.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-E2G2USTA.js";
+import "./chunk-EFZVDV7F.js";
+import "./chunk-U3LO5TDH.js";
+import "./chunk-TJTCHTR4.js";
+import "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/rerun.ts
+import { defineCommand } from "citty";
+var rerunCommand = defineCommand({
+  meta: {
+    name: "rerun",
+    hidden: true,
+    description: "Deprecated: use `baker canvas run --slug <slug>`, which does the same."
+  },
+  args: {
+    slug: { type: "positional", required: true, description: "Creative slug (src/creatives/<slug>)" },
+    "force-remote": {
+      type: "boolean",
+      default: false,
+      description: "Overwrite local files whose content differs from the recorded snapshot"
+    },
+    fresh: { type: "boolean", default: false, description: "Start a new run id instead of resuming an interrupted one" },
+    regenerate: { type: "string", description: "Comma-separated node ids to force fresh this run" },
+    concurrency: { type: "string", description: "Max nodes running at once" }
+  },
+  async run({ args }) {
+    process.stderr.write("[deprecated] `baker canvas rerun <slug>` is now `baker canvas run --slug <slug>`.\n");
+    await executeCanvasRun({
+      slug: String(args.slug),
+      forceRemote: args["force-remote"] === true,
+      fresh: args.fresh === true,
+      regenerate: args.regenerate !== void 0 ? String(args.regenerate) : void 0,
+      concurrency: args.concurrency !== void 0 ? String(args.concurrency) : void 0
+    });
+  }
+});
+export {
+  rerunCommand
+};
+//# sourceMappingURL=rerun-LSWO6K7O.js.map

package/dist/research-YKP5MEEQ.js

@@ -0,0 +1,78 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/index.ts
+import { defineCommand } from "citty";
+var researchCommand = defineCommand({
+  meta: {
+    name: "research",
+    description: `Competitive intelligence and AI-powered research commands.
+
+Commands:
+  web                \u2014 Search the web with AI (ask any question)
+  fetch              \u2014 Read a page an ordinary web fetch could not
+  cite               \u2014 Prove a quote word for word against its page, and record the evidence
+  linkedin-person    \u2014 One person's public LinkedIn, read once for 1:1 messaging
+  people             \u2014 Who likely holds a role at a company (public LinkedIn, checked)
+  transcript         \u2014 The words of a keynote, earnings call or podcast
+  company            \u2014 A company's size, industry, HQ, tech and hiring; --search to size a market
+  reddit             \u2014 Read Reddit verbatim: search posts/comments, read a thread
+  customers          \u2014 Gather real customer words into Knowledge (src/content/insights), verbatim only
+  google-ads         \u2014 A competitor's Google ads and their copy (Ads Transparency Center)
+  advertisers        \u2014 Who's bidding on a keyword?
+  autocomplete       \u2014 Google Autocomplete suggestions
+  intent             \u2014 Google Search intent classification
+  keyword-metrics    \u2014 Volume/CPC/competition for keywords you name (no domain)
+  keywords-for-site  \u2014 Keywords a domain bids on
+  keyword-gap        \u2014 Keywords they have that we don't
+  relevant-pages     \u2014 Top pages of a competitor domain
+  lighthouse         \u2014 Landing page performance audit
+  countries          \u2014 List supported country codes
+  languages          \u2014 List supported language codes
+
+Examples:
+  baker research web "Who are the main competitors of HubSpot?"
+  baker research web "What is the ICP for CRM buyers?" --depth high
+  baker research fetch "https://competitor.com/pricing"
+  baker research cite "https://competitor.com/pricing" "Plans start at $10 per month"
+  baker research linkedin-person https://www.linkedin.com/in/jane-doe
+  baker research people acme.com --title "Chief Technology Officer,CTO"
+  baker research transcript "https://www.youtube.com/watch?v=<id>" --out keynote.txt
+  baker research company acme.es
+  baker research company --search --industry computer-software --size 50-200 --country es
+  baker research reddit search "agency never paid" --subreddit AmazonFlexUK --kind comments
+  baker research customers --focus "payroll app for restaurants"
+  baker research google-ads competitor.com --location es --copy
+  baker research advertisers "running shoes"
+  baker research intent "buy running shoes,best running shoes 2026"
+  baker research keyword-metrics "chatbot whatsapp,crm whatsapp" --location mx --language es
+  baker research keywords-for-site "competitor.com"
+  baker research keyword-gap "them.com" "us.com"
+Full guide: __tooling__/docs/tools/baker/research.md`
+  },
+  subCommands: {
+    web: () => import("./web-CV3VMSDO.js").then((m) => m.webCommand),
+    fetch: () => import("./fetch-M5KGRBEI.js").then((m) => m.fetchCommand),
+    cite: () => import("./cite-I5UV5SKS.js").then((m) => m.citeCommand),
+    "linkedin-person": () => import("./linkedin-person-EFBNRT7A.js").then((m) => m.linkedinPersonCommand),
+    people: () => import("./people-5A6NEDEU.js").then((m) => m.peopleCommand),
+    transcript: () => import("./transcript-JHGN7KW7.js").then((m) => m.transcriptCommand),
+    company: () => import("./company-IQ4LMS24.js").then((m) => m.companyCommand),
+    "google-ads": () => import("./google-ads-AKIWTLR4.js").then((m) => m.googleAdsCommand),
+    reddit: () => import("./reddit-CTAWHQ6K.js").then((m) => m.redditCommand),
+    customers: () => import("./customers-7NG2IPJK.js").then((m) => m.customersCommand),
+    advertisers: () => import("./advertisers-RVTUZ53M.js").then((m) => m.advertisersCommand),
+    autocomplete: () => import("./autocomplete-CBBFRPJZ.js").then((m) => m.autocompleteCommand),
+    countries: () => import("./countries-OJZQQYFT.js").then((m) => m.countriesCommand),
+    intent: () => import("./intent-TKFH57DZ.js").then((m) => m.intentCommand),
+    "keyword-metrics": () => import("./keyword-metrics-K7L6CVTZ.js").then((m) => m.keywordMetricsCommand),
+    "keywords-for-site": () => import("./keywords-for-site-HBQBMVFS.js").then((m) => m.keywordsForSiteCommand),
+    "keyword-gap": () => import("./keyword-gap-7I2CIUTK.js").then((m) => m.keywordGapCommand),
+    languages: () => import("./languages-22VMY7JN.js").then((m) => m.languagesCommand),
+    lighthouse: () => import("./lighthouse-EQZFYGFL.js").then((m) => m.lighthouseCommand),
+    "relevant-pages": () => import("./relevant-pages-QIF35NBQ.js").then((m) => m.relevantPagesCommand)
+  }
+});
+export {
+  researchCommand
+};
+//# sourceMappingURL=research-YKP5MEEQ.js.map

package/dist/research-YKP5MEEQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\nexport const researchCommand = defineCommand({\n  meta: {\n    name: \"research\",\n    description: `Competitive intelligence and AI-powered research commands.\n\nCommands:\n  web                — Search the web with AI (ask any question)\n  fetch              — Read a page an ordinary web fetch could not\n  cite               — Prove a quote word for word against its page, and record the evidence\n  linkedin-person    — One person's public LinkedIn, read once for 1:1 messaging\n  people             — Who likely holds a role at a company (public LinkedIn, checked)\n  transcript         — The words of a keynote, earnings call or podcast\n  company            — A company's size, industry, HQ, tech and hiring; --search to size a market\n  reddit             — Read Reddit verbatim: search posts/comments, read a thread\n  customers          — Gather real customer words into Knowledge (src/content/insights), verbatim only\n  google-ads         — A competitor's Google ads and their copy (Ads Transparency Center)\n  advertisers        — Who's bidding on a keyword?\n  autocomplete       — Google Autocomplete suggestions\n  intent             — Google Search intent classification\n  keyword-metrics    — Volume/CPC/competition for keywords you name (no domain)\n  keywords-for-site  — Keywords a domain bids on\n  keyword-gap        — Keywords they have that we don't\n  relevant-pages     — Top pages of a competitor domain\n  lighthouse         — Landing page performance audit\n  countries          — List supported country codes\n  languages          — List supported language codes\n\nExamples:\n  baker research web \"Who are the main competitors of HubSpot?\"\n  baker research web \"What is the ICP for CRM buyers?\" --depth high\n  baker research fetch \"https://competitor.com/pricing\"\n  baker research cite \"https://competitor.com/pricing\" \"Plans start at $10 per month\"\n  baker research linkedin-person https://www.linkedin.com/in/jane-doe\n  baker research people acme.com --title \"Chief Technology Officer,CTO\"\n  baker research transcript \"https://www.youtube.com/watch?v=<id>\" --out keynote.txt\n  baker research company acme.es\n  baker research company --search --industry computer-software --size 50-200 --country es\n  baker research reddit search \"agency never paid\" --subreddit AmazonFlexUK --kind comments\n  baker research customers --focus \"payroll app for restaurants\"\n  baker research google-ads competitor.com --location es --copy\n  baker research advertisers \"running shoes\"\n  baker research intent \"buy running shoes,best running shoes 2026\"\n  baker research keyword-metrics \"chatbot whatsapp,crm whatsapp\" --location mx --language es\n  baker research keywords-for-site \"competitor.com\"\n  baker research keyword-gap \"them.com\" \"us.com\"\nFull guide: __tooling__/docs/tools/baker/research.md`,\n  },\n  subCommands: {\n    web: () => import(\"./web.ts\").then((m) => m.webCommand),\n    fetch: () => import(\"./fetch.ts\").then((m) => m.fetchCommand),\n    cite: () => import(\"./cite.ts\").then((m) => m.citeCommand),\n    \"linkedin-person\": () => import(\"./linkedin-person.ts\").then((m) => m.linkedinPersonCommand),\n    people: () => import(\"./people.ts\").then((m) => m.peopleCommand),\n    transcript: () => import(\"./transcript.ts\").then((m) => m.transcriptCommand),\n    company: () => import(\"./company.ts\").then((m) => m.companyCommand),\n    \"google-ads\": () => import(\"./google-ads.ts\").then((m) => m.googleAdsCommand),\n    reddit: () => import(\"./reddit.ts\").then((m) => m.redditCommand),\n    customers: () => import(\"./customers.ts\").then((m) => m.customersCommand),\n    advertisers: () => import(\"./advertisers.ts\").then((m) => m.advertisersCommand),\n    autocomplete: () => import(\"./autocomplete.ts\").then((m) => m.autocompleteCommand),\n    countries: () => import(\"./countries.ts\").then((m) => m.countriesCommand),\n    intent: () => import(\"./intent.ts\").then((m) => m.intentCommand),\n    \"keyword-metrics\": () => import(\"./keyword-metrics.ts\").then((m) => m.keywordMetricsCommand),\n    \"keywords-for-site\": () => import(\"./keywords-for-site.ts\").then((m) => m.keywordsForSiteCommand),\n    \"keyword-gap\": () => import(\"./keyword-gap.ts\").then((m) => m.keywordGapCommand),\n    languages: () => import(\"./languages.ts\").then((m) => m.languagesCommand),\n    lighthouse: () => import(\"./lighthouse.ts\").then((m) => m.lighthouseCommand),\n    \"relevant-pages\": () => import(\"./relevant-pages.ts\").then((m) => m.relevantPagesCommand),\n  },\n});\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAEvB,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA2Cf;AAAA,EACA,aAAa;AAAA,IACX,KAAK,MAAM,OAAO,mBAAU,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU;AAAA,IACtD,OAAO,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;AAAA,IAC5D,MAAM,MAAM,OAAO,oBAAW,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW;AAAA,IACzD,mBAAmB,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,qBAAqB;AAAA,IAC3F,QAAQ,MAAM,OAAO,sBAAa,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,IAC/D,YAAY,MAAM,OAAO,0BAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,iBAAiB;AAAA,IAC3E,SAAS,MAAM,OAAO,uBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IAClE,cAAc,MAAM,OAAO,0BAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IAC5E,QAAQ,MAAM,OAAO,sBAAa,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,IAC/D,WAAW,MAAM,OAAO,yBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IACxE,aAAa,MAAM,OAAO,2BAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB;AAAA,IAC9E,cAAc,MAAM,OAAO,4BAAmB,EAAE,KAAK,CAAC,MAAM,EAAE,mBAAmB;AAAA,IACjF,WAAW,MAAM,OAAO,yBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IACxE,QAAQ,MAAM,OAAO,sBAAa,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,IAC/D,mBAAmB,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,qBAAqB;AAAA,IAC3F,qBAAqB,MAAM,OAAO,iCAAwB,EAAE,KAAK,CAAC,MAAM,EAAE,sBAAsB;AAAA,IAChG,eAAe,MAAM,OAAO,2BAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,iBAAiB;AAAA,IAC/E,WAAW,MAAM,OAAO,yBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IACxE,YAAY,MAAM,OAAO,0BAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,iBAAiB;AAAA,IAC3E,kBAAkB,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,oBAAoB;AAAA,EAC1F;AACF,CAAC;","names":[]}

package/dist/research-ZARG4TUX.js

@@ -0,0 +1,265 @@
+import {
+  chatIdFromEnv,
+  failAvatarApi,
+  failValidation
+} from "./chunk-DFE77XT5.js";
+import {
+  writeAvatars
+} from "./chunk-DN6EMVA4.js";
+import {
+  AVATAR_HANDLE_PATTERN
+} from "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/research.ts
+import { defineCommand } from "citty";
+
+// src/commands/avatars/researchHints.ts
+function described(call) {
+  return call.who ?? [call.name, call.role, call.company].filter(Boolean).join(", ");
+}
+function rerunOf(call) {
+  return [
+    "baker avatars research",
+    call.who ? quoted(call.who) : void 0,
+    call.name ? `--name ${quoted(call.name)}` : void 0,
+    call.role ? `--role ${quoted(call.role)}` : void 0,
+    call.company ? `--company ${quoted(call.company)}` : void 0,
+    call.context ? `--context ${quoted(call.context)}` : void 0,
+    call.site ? `--site ${call.site}` : void 0,
+    call.handle ? `--handle ${call.handle}` : void 0,
+    call.profile ? `--profile ${call.profile}` : void 0
+  ].filter(Boolean).join(" ");
+}
+function quoted(text) {
+  return `"${text.replaceAll('"', '\\"')}"`;
+}
+function possibleHints(data, rerun, create) {
+  const lines = (data.candidates ?? []).map(
+    (candidate) => [candidate.name, candidate.headline, candidate.profile].filter(Boolean).join(" \u2014 ")
+  );
+  const example = data.candidates?.[0]?.profile ?? "<profile url>";
+  return [
+    `Not sure it is them: these profiles matched only in part, so no photo was taken.
+${lines.map((line) => `  - ${line}`).join("\n")}`,
+    `If the copy makes clear which one is the person (same company, same role, what else you know of them), take it: \`${rerun} --profile ${example}${create}\`. If none of them clearly is, treat this as not found \u2014 never put a face in an ad on a guess.`
+  ];
+}
+function notFoundHints(data, rerun, create) {
+  const searched = data.searched.map((query) => `"${query}"`).join(", ");
+  const company = data.query.company;
+  const sites = (data.possibleSites ?? []).map(
+    (site) => `${site} may be ${company ?? "the company"}'s own website (its domain spells part of the name). If it is \u2014 you know it, or a quick look confirms it \u2014 run again on it: \`${rerun} --site ${site}${create}\`. Never name a site that is not theirs.`
+  );
+  return [
+    `No public profile could be tied to this person${searched ? ` (searched ${searched})` : ""}, so no photo was taken. Carry on with an invented one-off person drawn from the description, exactly as for anyone unnamed \u2014 never a photo of somebody else, and never stall the job over it.`,
+    ...sites,
+    'If you know more than was searched, run it again with it: their exact name or company (`--name`, `--company`), the company\'s own website (`--site <domain>`), what else is known of them (`--context "Spanish, banking"`: where they are from or based, their field), or their LinkedIn profile once you have checked it is them (`--profile <url>`).'
+  ];
+}
+function avatarHints(avatar, name) {
+  const where = avatar.reused ? `@${avatar.handle} is already ${name}'s avatar \u2014 reused, not built again.` : `@${avatar.handle} is ${name}'s avatar, built from their real photos. Its sheet settles in about 30s: if the next thing you do needs it, \`baker avatars get ${avatar.handle} --wait\`.`;
+  return [
+    where,
+    `Use it everywhere ${name} appears: \`--avatar ${avatar.handle}\` on static ads, video and Studio renders; on a landing, their photo is the avatar's \`coverUrl\` from \`baker avatars get ${avatar.handle}\` (upscale it when it is shown large). Never invent another face for them.`
+  ];
+}
+function foundHints(data, call, rerun) {
+  const name = data.person?.name ?? described(call);
+  if (data.avatar) return avatarHints(data.avatar, name);
+  const photoIds = (data.photos ?? []).map((photo) => photo.imageId).join(",");
+  if (!photoIds) {
+    return [
+      `Found ${name}, but no usable photo of them was public${call.create ? ", so no avatar was built" : ""}. Carry on with an invented one-off person drawn from the description.`
+    ];
+  }
+  if (call.create) {
+    return [
+      `Found ${name}, but their avatar could not be built automatically. Build it from the photos yourself: \`baker avatars create --name ${quoted(name)} --subject "<one person, plainly: age, build, hair, skin, face>" --source-image ${photoIds} --likeness-confirmed\`.`
+    ];
+  }
+  return [
+    `Found ${name}; their photos are in the image library (${photoIds}). Build their avatar from them: \`${rerun} --create\`.`
+  ];
+}
+function researchHints(data, call) {
+  const rerun = rerunOf(call);
+  if (data.status === "possible") {
+    return possibleHints(data, rerunOf({ ...call, profile: void 0 }), call.create ? " --create" : "");
+  }
+  if (data.status === "not_found") return notFoundHints(data, rerun, call.create ? " --create" : "");
+  return foundHints(data, call, rerun);
+}
+
+// src/commands/avatars/research.ts
+var RESEARCH_TIMEOUT_MS = 18e4;
+registerSchema({
+  command: "avatars.research",
+  description: 'Find a REAL, named person from a description and gather their public photos \u2014 and, with --create, build their avatar from them. Start here: `baker avatars research "Lautaro Suarez, CTO at Vibiz" --create`. Use it whenever copy shows a real person by name: a testimonial author with their role and company, the company\'s founder or CEO, a named team member. Describe them: "<name>, <role> at <company>", or "the CEO of <company>" when the copy names a role, and add what else you know: --site <the company\'s own website> when its domain is not its name spelled out (santander.com for Banco Santander), --context "<where they are from or based, their field>" for someone with no company. Identity is checked in code (the name AND the company \u2014 or, with no company, the role and the context \u2014 must match a public profile): `found` returns their photos (now in the image library) and a subject description; `possible` returns the half-matches to pick from with --profile <their link> (or a LinkedIn you found and checked yourself); `not_found` lists any site that may be the company\'s (possibleSites) and means fall back to an invented one-off person. The company naming them in its copy is the go-ahead to use their likeness \u2014 no confirmation question. A person who already has an avatar comes back with it (`reused: true`) \u2014 nothing searched, nothing billed \u2014 so run it every time copy names someone.',
+  args: {
+    who: {
+      type: "string",
+      description: 'How the copy names them, e.g. "Lautaro Suarez, CTO at Vibiz" or "the CEO of Vibiz"',
+      required: true
+    },
+    name: {
+      type: "string",
+      description: "Their full name, when the description leaves it out or reads it wrong",
+      required: false
+    },
+    role: { type: "string", description: 'Their role, e.g. "CTO", "Founder"', required: false },
+    company: { type: "string", description: "The company they are at", required: false },
+    context: {
+      type: "string",
+      description: 'What else you know of them, in a few words: where they are from or based, their field, e.g. "Spanish, banking". Narrows the search; with no company, name + role + context on one profile is enough to find them',
+      required: false
+    },
+    site: {
+      type: "string",
+      description: "The company's own website, e.g. \"santander.com\" for Banco Santander: its pages are searched for them however the domain spells the name. Use it when the domain is not the company's name spelled out, or when a `not_found` lists it in possibleSites and it is theirs",
+      required: false
+    },
+    profile: {
+      type: "string",
+      description: "The profile to take, by its link: one of the candidates a `possible` answer listed (a LinkedIn, or a public record), or a LinkedIn you found and checked is them (same person, role and company). The name on it must match",
+      required: false
+    },
+    linkedin: { type: "string", description: "Same as --profile", required: false },
+    create: {
+      type: "boolean",
+      description: "Build their avatar from the photos right away (likeness `licensed`, no face picker)",
+      required: false
+    },
+    handle: {
+      type: "string",
+      description: "Mention handle for the avatar --create builds (derived from the name when omitted)",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Include their about text, location and every search that was run",
+      required: false
+    }
+  }
+});
+function compact(data, full) {
+  if (full) return data;
+  const { searched, person, ...rest } = data;
+  const { about: _about, location: _location, ...who } = person ?? { socials: {} };
+  return {
+    ...rest,
+    ...person ? { person: who } : {},
+    // A `not_found` is only useful with what was tried.
+    ...data.status === "not_found" ? { searched } : {}
+  };
+}
+var researchCommand = defineCommand({
+  meta: {
+    name: "research",
+    description: 'Find a real, named person from a description and build their avatar from their public photos. Example: baker avatars research "Lautaro Suarez, CTO at Vibiz" --create'
+  },
+  args: {
+    who: {
+      type: "positional",
+      description: 'Who: "<name>, <role> at <company>" or "the CEO of <company>"',
+      required: false
+    },
+    name: { type: "string", description: "Their full name (overrides the description)", required: false },
+    role: { type: "string", description: "Their role (overrides the description)", required: false },
+    company: { type: "string", description: "Their company (overrides the description)", required: false },
+    context: {
+      type: "string",
+      description: 'What else you know of them: "Spanish, banking" (where they are from or based, their field)',
+      required: false
+    },
+    site: { type: "string", description: `The company's own website, e.g. "santander.com"`, required: false },
+    profile: {
+      type: "string",
+      description: "The profile to take: a candidate's link from a `possible` answer, or a LinkedIn you checked is them",
+      required: false
+    },
+    linkedin: { type: "string", description: "Same as --profile", required: false },
+    create: { type: "boolean", description: "Build their avatar from the photos", required: false, default: false },
+    handle: { type: "string", description: "Mention handle for the new avatar", required: false },
+    full: {
+      type: "boolean",
+      description: "Include about, location and the searches run",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    const text = (key) => {
+      const value = args[key];
+      return typeof value === "string" && value.trim() ? value.trim() : void 0;
+    };
+    const call = callOf(text, Boolean(args.create));
+    const { who, name, company, handle } = call;
+    if (!who && !name && !company) {
+      failValidation(
+        'Say who to research, e.g. `baker avatars research "Lautaro Suarez, CTO at Vibiz"` or `baker avatars research "the CEO of Vibiz"`.'
+      );
+    }
+    if (handle && !AVATAR_HANDLE_PATTERN.test(handle)) {
+      failValidation(
+        `--handle "${handle}" is not usable. Use lowercase letters, numbers and dashes, starting with a letter \u2014 "lautaro-suarez". Leave it off to have one derived from the name.`
+      );
+    }
+    const chatId = chatIdFromEnv();
+    const { profile: profileUrl, ...asked } = call;
+    const body = {
+      ...asked,
+      ...profileUrl ? { profileUrl } : {},
+      // A backend from before --profile reads a picked LinkedIn only here.
+      ...profileUrl && /linkedin\.com\//i.test(profileUrl) ? { linkedinUrl: profileUrl } : {},
+      ...chatId ? { chatId } : {}
+    };
+    try {
+      const data = await writeAvatars("/api/avatars/research", body, {
+        timeoutMs: RESEARCH_TIMEOUT_MS
+      });
+      writeJson({ ok: true, data: compact(data, Boolean(args.full)), hints: researchHints(data, call) });
+    } catch (err) {
+      failAvatarApi(err, handle);
+    }
+  }
+});
+function callOf(text, create) {
+  const who = text("who");
+  const name = text("name");
+  const role = text("role");
+  const company = text("company");
+  const context = text("context");
+  const site = text("site");
+  const handle = text("handle")?.toLowerCase();
+  const profile = text("profile") ?? text("linkedin");
+  return {
+    ...who ? { who } : {},
+    ...name ? { name } : {},
+    ...role ? { role } : {},
+    ...company ? { company } : {},
+    ...context ? { context } : {},
+    ...site ? { site } : {},
+    ...handle ? { handle } : {},
+    ...profile ? { profile } : {},
+    create
+  };
+}
+export {
+  researchCommand
+};
+//# sourceMappingURL=research-ZARG4TUX.js.map

package/dist/reset-LO2WLWSF.js

@@ -0,0 +1,57 @@
+import {
+  reportError,
+  reportInvalid
+} from "./chunk-MUT2BPDM.js";
+import {
+  testimonialSourcesResetRequestSchema
+} from "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/reset.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "testimonials.sources.reset",
+  description: "Unstick a review source whose import failed or has not moved for an hour, so it can be imported again. Refused while an import is still running. Keeps its reviews.",
+  args: { id: { type: "string", description: "Source id from `testimonials sources list`", required: true } }
+});
+var resetCommand = defineCommand({
+  meta: {
+    name: "reset",
+    description: "Unstick a review source whose import failed or has not moved for an hour, so it can be imported again. Refused while an import is still running. Keeps its reviews.\n\nExample: baker testimonials sources reset <source-id>"
+  },
+  args: { id: { type: "positional", description: "Source id from `testimonials sources list`", required: true } },
+  run: async ({ args }) => {
+    const parsed = testimonialSourcesResetRequestSchema.safeParse({ id: String(args.id ?? "") });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/reset", parsed.data);
+      writeJson({
+        ok: true,
+        data,
+        hints: [`Run \`baker testimonials sources sync ${data.id}\` to import its reviews again.`]
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  resetCommand
+};
+//# sourceMappingURL=reset-LO2WLWSF.js.map

package/dist/reset-PDQTEM2J.js

@@ -0,0 +1,57 @@
+import {
+  reportError
+} from "./chunk-YB2UVOAD.js";
+import {
+  mediaSourcesResetRequestSchema
+} from "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/media-sources/reset.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "media-sources.reset",
+  description: "Unstick a connected source whose import failed, or has not moved for an hour, so it can import again. Keeps what it already imported. Refused while an import is still moving.",
+  args: {
+    key: { type: "string", description: "Source key from `media-sources list`, e.g. tiktok:acme", required: true }
+  }
+});
+var resetCommand = defineCommand({
+  meta: {
+    name: "reset",
+    description: "Unstick a source whose import failed or has not moved for an hour, so it can import again. Keeps what it already imported; refused while an import is still moving.\n\nExample: baker media-sources reset tiktok:acme"
+  },
+  args: { key: { type: "positional", description: "Source key, e.g. tiktok:acme", required: true } },
+  run: async ({ args }) => {
+    const parsed = mediaSourcesResetRequestSchema.safeParse({ key: String(args.key ?? "") });
+    if (!parsed.success) {
+      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: parsed.error.issues[0]?.message ?? "" } });
+      process.exit(1);
+    }
+    try {
+      const data = await apiPost("/api/media-sources/reset", parsed.data);
+      writeJson({ ok: true, data, hints: [`Run \`baker media-sources sync ${data.key}\` to import its new posts.`] });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  resetCommand
+};
+//# sourceMappingURL=reset-PDQTEM2J.js.map