@koda-sl/baker-cli 0.559.0 → 0.561.0

package/dist/chunk-QLXVHWAC.js

@@ -0,0 +1,685 @@
+import {
+  findSubreddits,
+  searchReddit
+} from "./chunk-R2Z5L5CF.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-Y5PNLB24.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-N3PASNUA.js";
+import {
+  askAboutText
+} from "./chunk-DLM5OSHM.js";
+import {
+  CUSTOMER_INSIGHTS_MODEL
+} from "./chunk-MCJ5I5LR.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+
+// src/commands/research/customers.ts
+import { mkdir, readdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+
+// ../api/src/verbatim.ts
+var SINGLE_QUOTES = /* @__PURE__ */ new Set([8216, 8217, 8218, 8219, 8242]);
+var DOUBLE_QUOTES = /* @__PURE__ */ new Set([8220, 8221, 8222, 8223, 8243]);
+var DASHES = /* @__PURE__ */ new Set([8208, 8209, 8210, 8211, 8212, 8213, 8722]);
+function foldChar(char) {
+  if (/\s/.test(char)) return " ";
+  const code = char.codePointAt(0) ?? 0;
+  if (SINGLE_QUOTES.has(code)) return "'";
+  if (DOUBLE_QUOTES.has(code)) return '"';
+  if (DASHES.has(code)) return "-";
+  return char.normalize("NFKC").toLowerCase();
+}
+function foldWithOffsets(text) {
+  let folded = "";
+  const offsets = [];
+  let at = 0;
+  for (const char of text) {
+    const out = foldChar(char);
+    const collapses = out === " " && (folded.length === 0 || folded.endsWith(" "));
+    if (!collapses) {
+      for (const piece of out) {
+        folded += piece;
+        offsets.push(at);
+      }
+    }
+    at += char.length;
+  }
+  if (folded.endsWith(" ")) {
+    folded = folded.slice(0, -1);
+    offsets.pop();
+  }
+  return { folded, offsets };
+}
+function foldForComparison(text) {
+  return foldWithOffsets(text).folded;
+}
+function findVerbatimSpan(quote, text) {
+  const needle = foldWithOffsets(quote).folded;
+  if (needle.length === 0) return null;
+  const { folded, offsets } = foldWithOffsets(text);
+  const at = folded.indexOf(needle);
+  if (at < 0) return null;
+  const start = offsets[at] ?? 0;
+  const last = offsets[at + needle.length - 1] ?? 0;
+  const end = last + (String.fromCodePoint(text.codePointAt(last) ?? 0).length || 1);
+  return { start, end };
+}
+function findVerbatim(quote, text) {
+  const span = findVerbatimSpan(quote, text);
+  return span ? text.slice(span.start, span.end).replace(/\s+/g, " ").trim() : null;
+}
+
+// src/commands/research/customers.ts
+import { defineCommand } from "citty";
+import { parse as parseYaml } from "yaml";
+import { z } from "zod";
+var INSIGHT_TYPES = [
+  "accommodation",
+  "failed_solution",
+  "nearly_didnt",
+  "word",
+  "moment",
+  "pain",
+  "objection",
+  "desire",
+  "proof",
+  "other"
+];
+var FORCES = ["push", "pull", "anxiety", "habit"];
+var FITS = ["on_topic", "off_topic", "not_a_buyer"];
+var MAX_QUOTE_CHARS = 280;
+function keepVerbatim(candidates, sources) {
+  const kept = [];
+  let dropped = 0;
+  let tooLong = 0;
+  for (const { source: index, ...rest } of candidates) {
+    const source = sources[index - 1];
+    const quote = source ? findVerbatim(rest.quote, source.text) : null;
+    if (!source || !quote) {
+      dropped++;
+      continue;
+    }
+    if (quote.length > MAX_QUOTE_CHARS) {
+      tooLong++;
+      continue;
+    }
+    kept.push({ ...rest, quote, source });
+  }
+  return { kept, dropped, tooLong };
+}
+function keepOnTopic(insights) {
+  const kept = [];
+  let offTopic = 0;
+  let notABuyer = 0;
+  for (const insight of insights) {
+    if (insight.fit === "not_a_buyer") notABuyer++;
+    else if (insight.fit === "on_topic" && insight.why?.trim()) kept.push(insight);
+    else offTopic++;
+  }
+  return { kept, offTopic, notABuyer };
+}
+var SLUG_WORDS = 6;
+function asciiWords(text) {
+  return text.normalize("NFKD").replace(new RegExp("\\p{M}", "gu"), "").toLowerCase().replace(/[^a-z0-9]+/g, " ").trim().split(" ").filter(Boolean);
+}
+function insightSlug(type, quote) {
+  return [type.replace(/_/g, "-"), ...asciiWords(quote).slice(0, SLUG_WORDS)].join("-");
+}
+function planInsightWrites(insights, existing, limit) {
+  const filed = existing.map((e) => ({ folded: foldForComparison(e.quote), source: e.source }));
+  const quotes = new Set(filed.map((e) => e.folded));
+  const ids = new Set(existing.map((e) => e.id));
+  const ranked = [...insights].sort((a, b) => INSIGHT_TYPES.indexOf(a.type) - INSIGHT_TYPES.indexOf(b.type));
+  const writes = [];
+  let skippedExisting = 0;
+  let skippedOverlap = 0;
+  for (const insight of ranked) {
+    const folded = foldForComparison(insight.quote);
+    if (quotes.has(folded)) {
+      skippedExisting++;
+      continue;
+    }
+    const overlaps = filed.some(
+      (e) => e.source === insight.source.ref && e.folded && (e.folded.includes(folded) || folded.includes(e.folded))
+    );
+    if (overlaps) {
+      skippedOverlap++;
+      continue;
+    }
+    if (writes.length >= limit) continue;
+    const base = insightSlug(insight.type, insight.quote);
+    let id = base;
+    for (let n = 2; ids.has(id); n++) id = `${base}-${n}`;
+    quotes.add(folded);
+    filed.push({ folded, source: insight.source.ref });
+    ids.add(id);
+    writes.push({ id, insight });
+  }
+  return { writes, skippedExisting, skippedOverlap };
+}
+function yamlScalar(value) {
+  return JSON.stringify(value);
+}
+var TITLE_CHARS = 70;
+function insightTitle(quote) {
+  const text = quote.replace(/["“”]/g, "").replace(/\s+/g, " ").trim();
+  if (text.length <= TITLE_CHARS) return `\u201C${text}\u201D`;
+  const cut = text.slice(0, TITLE_CHARS);
+  return `\u201C${cut.slice(0, cut.lastIndexOf(" ")).replace(/[,;:.]$/, "")}\u2026\u201D`;
+}
+function renderInsightFile(insight, opts) {
+  const { source } = insight;
+  const lines = [
+    "---",
+    `title: ${yamlScalar(insightTitle(insight.quote))}`,
+    `type: ${insight.type}`,
+    `quote: ${yamlScalar(insight.quote)}`,
+    `source: ${yamlScalar(source.ref)}`,
+    `sourceKind: ${source.kind}`,
+    `seenAt: ${yamlScalar(source.saidOn ?? opts.today)}`,
+    "status: observed"
+  ];
+  if (insight.force) lines.push(`force: ${insight.force}`);
+  if (insight.persona?.trim()) lines.push(`persona: ${yamlScalar(insight.persona.trim())}`);
+  if (opts.product) lines.push(`product: ${yamlScalar(opts.product)}`);
+  lines.push("---", "", source.context.replace(/\s+/g, " ").trim(), "");
+  return lines.join("\n");
+}
+var MAX_SHORT_SOURCE_CHARS = 1500;
+var PLATFORM_NAMES = {
+  google: "Google",
+  trustpilot: "Trustpilot",
+  yelp: "Yelp",
+  tripadvisor: "Tripadvisor",
+  g2: "G2",
+  capterra: "Capterra",
+  amazon: "Amazon",
+  app_store: "App Store",
+  google_play: "Google Play"
+};
+var LibraryReviewSchema = z.object({
+  _id: z.string().min(1),
+  reviewText: z.string(),
+  sourceType: z.string().optional(),
+  rating: z.number().optional(),
+  reviewDate: z.number().optional()
+});
+function dayOf(ms) {
+  const date = new Date(ms);
+  return Number.isNaN(date.getTime()) ? void 0 : date.toISOString().slice(0, 10);
+}
+function sentence(rest) {
+  const line = `${/^[aeiou]/i.test(rest) ? "An" : "A"} ${rest}`;
+  return line.endsWith(".") ? line : `${line}.`;
+}
+function reviewContext(review) {
+  const platform = review.sourceType ? `${PLATFORM_NAMES[review.sourceType] ?? review.sourceType} ` : "";
+  const rating = review.rating !== void 0 ? `${review.rating}\u2605 ` : "";
+  return sentence(`${rating}${platform}review`);
+}
+function sourcesFromTestimonials(data) {
+  const list = Array.isArray(data) ? data : [];
+  return list.flatMap((item) => {
+    const parsed = LibraryReviewSchema.safeParse(item);
+    if (!parsed.success) return [];
+    const review = parsed.data;
+    const text = review.reviewText.trim().slice(0, MAX_SHORT_SOURCE_CHARS);
+    if (!text) return [];
+    const saidOn = review.reviewDate !== void 0 ? dayOf(review.reviewDate) : void 0;
+    return [
+      {
+        ref: `testimonials:${review._id}`,
+        kind: "review",
+        text,
+        context: reviewContext(review),
+        ...saidOn ? { saidOn } : {}
+      }
+    ];
+  });
+}
+function sourcesFromReddit(items) {
+  return items.flatMap((item) => {
+    const words = item.kind === "post" ? [item.title ?? "", item.text].filter((t) => t.trim()).join("\n\n") : item.text;
+    const text = words.trim().slice(0, MAX_SHORT_SOURCE_CHARS);
+    if (!text) return [];
+    const under = item.kind === "comment" && item.title ? `, under ${JSON.stringify(item.title)}` : "";
+    const saidOn = dayOf(item.createdAt);
+    return [
+      {
+        ref: item.permalink,
+        kind: "reddit",
+        text,
+        context: `A Reddit ${item.kind} in r/${item.subreddit}${under}.`,
+        ...saidOn ? { saidOn } : {}
+      }
+    ];
+  });
+}
+var MAX_PAGE_SOURCE_CHARS = 6e3;
+function sourcesFromPages(pages) {
+  return pages.flatMap((page) => {
+    const text = page.content.trim().slice(0, MAX_PAGE_SOURCE_CHARS);
+    if (!text) return [];
+    const host = URL.canParse(page.finalUrl) ? new URL(page.finalUrl).host : page.finalUrl;
+    const title = page.title?.trim() ? `, ${JSON.stringify(page.title.trim())}` : "";
+    return [{ ref: page.finalUrl, kind: "web", text, context: `A page on ${host}${title}.` }];
+  });
+}
+function promptLine(source, n) {
+  const where = source.context.replace(/\s+/g, " ").trim();
+  const ofCompany = source.kind === "review" ? " A review of this company." : "";
+  return `[${n}] ${where || ofCompany ? `(${`${where}${ofCompany}`.trim()}) ` : ""}${source.text}`;
+}
+function buildCustomersPrompt(sources, opts = {}) {
+  const { focus, company } = opts;
+  const about = company?.about?.trim();
+  const products = company?.products.length ? `Its products: ${company.products.join(", ")}.` : "";
+  return [
+    `Below are ${sources.length} numbered texts (reviews, testimonials, forum posts and comments, web pages)${focus ? `, gathered about: ${focus}` : ""}.`,
+    "Find what this company's customers say in them, the material its ads are written from.",
+    "",
+    "The company:",
+    about ? about : "(no company description on file: judge by the focus and the company's own reviews)",
+    ...products ? [products] : [],
+    "",
+    "Rules:",
+    "- Every quote must be an EXACT substring of the text it cites: the same words, in the same order, with the same spelling and typos. Copy, never paraphrase, translate, summarize, correct or join two passages. Never quote the part in parentheses before a text; that only says where it was said.",
+    `- The shortest span that carries the truth, at most ${MAX_QUOTE_CHARS} characters.`,
+    "- Only the customer's own words: skip a seller's reply, an ad, a page's marketing copy, and a text with no truth in it. Return fewer, or none, rather than invent.",
+    "- fit, for every quote: on_topic when the speaker is a buyer or user of this company, its product, its category or a named competitor, talking about the problem it solves, in a market it serves; off_topic when the text (or the forum or thread it was said in) is about something else, such as a game, another industry or another country's market; not_a_buyer when it is on the subject but the speaker is not a buyer: someone the product acts against, a seller or the company replying, a marketer. A real quote that is off_topic is worthless here, so judge strictly.",
+    "- why: one short line on what makes it that fit (who is speaking, about what).",
+    "- type: accommodation (a workaround they live with), failed_solution (what they tried before that failed them), nearly_didnt (what nearly stopped them buying), word (their own word or phrase for the problem), moment (the moment that started their search), pain, objection, desire, proof (a result they got), other.",
+    "- force, when it speaks to one: push (what pushes them off the old way), pull (what draws them to the new one), anxiety (what they fear about changing), habit (what keeps them where they are).",
+    `- persona: a few words on who is speaking, only when the text says it ("restaurant owner", "night-shift courier"). Never a person's name.`,
+    "",
+    'Reply with only this JSON: {"insights":[{"source":1,"quote":"","fit":"","why":"","type":"","force":"","persona":""}]}',
+    "",
+    "Texts:",
+    ...sources.map((source, i) => promptLine(source, i + 1))
+  ].join("\n");
+}
+var AnswerSchema = z.object({ insights: z.array(z.unknown()) });
+var CandidateSchema = z.object({
+  source: z.coerce.number().int().positive(),
+  quote: z.string().trim().min(1),
+  type: z.enum(INSIGHT_TYPES).catch("other"),
+  force: z.enum(FORCES).optional().catch(void 0),
+  persona: z.string().trim().optional().catch(void 0),
+  fit: z.enum(FITS).optional().catch(void 0),
+  why: z.string().trim().optional().catch(void 0)
+});
+function candidatesFrom(answer) {
+  const parsed = AnswerSchema.safeParse(answer);
+  if (!parsed.success) return null;
+  return parsed.data.insights.flatMap((item) => {
+    const candidate = CandidateSchema.safeParse(item);
+    if (!candidate.success) return [];
+    const { source, quote, type, force, persona, fit, why } = candidate.data;
+    return [
+      {
+        source,
+        quote,
+        type,
+        ...force ? { force } : {},
+        ...persona ? { persona } : {},
+        ...fit ? { fit } : {},
+        ...why ? { why } : {}
+      }
+    ];
+  });
+}
+function batchSources(sources, budget) {
+  const batches = [];
+  let current = [];
+  let size = 0;
+  for (const source of sources) {
+    if (current.length > 0 && size + source.text.length > budget) {
+      batches.push(current);
+      current = [];
+      size = 0;
+    }
+    current.push(source);
+    size += source.text.length;
+  }
+  if (current.length > 0) batches.push(current);
+  return batches;
+}
+var FEW_OBSERVED = 5;
+function customersHints(input) {
+  const { written, offTopic = 0, notABuyer = 0, sources } = input;
+  const widen = `Search in the customers' own words with --query "<the words they write>" (their phrasing, not a category name), or add --web.`;
+  const elsewhere = offTopic > 0 && offTopic >= written ? [
+    `${offTopic} real quotes were dropped as not about this company, its product, category or competitors (the forum or thread was about something else). Put the product or category in --query with the customers' words ("<category> <their words>"), and check where this company's customers actually talk with \`baker research reddit subreddits "<category>"\`. Never write the dropped quotes in by hand.`
+  ] : [];
+  const notBuyers = notABuyer > 0 && notABuyer >= written ? [
+    `${notABuyer} quotes on the subject were dropped because the speakers are not buyers (people the product acts against, sellers replying, marketers). The search reached the right conversations: look for the buyers' side of them \u2014 reviews of this company, or --query in a buyer's words ("I chose", "we switched", "before we signed"). Never write the dropped quotes in by hand.`
+  ] : [];
+  const why = [...elsewhere, ...notBuyers];
+  if (written === 0) {
+    return [
+      ...why,
+      "No customer words were found to keep, so nothing was written. Import where customers already talk: `baker testimonials sources add <review page link>` (Google, Trustpilot, G2, app stores\u2026) brings their reviews into the library; then run this again.",
+      ...sources.reddit === null ? ['Reddit was not read: pass --focus "<product>" or --query "<their words>".'] : [widen],
+      "Until there are observed truths, ad ideas go in as explore bets: an idea with an empty `evidence` list."
+    ];
+  }
+  const cite = `Cite these by id in an idea's \`evidence\` (src/creatives/_ideas/<idea>.md); write the ad from the quote as said.`;
+  return [...why, ...written < FEW_OBSERVED ? [`Only ${written} observed. ${widen}`, cite] : [cite]];
+}
+var INSIGHTS_DIR = path.join("src", "content", "insights");
+var BATCH_CHARS = 24e3;
+var MAX_BATCHES = 5;
+var WEB_PAGES = 3;
+var DEFAULT_LIMIT = 20;
+var SHOWN_QUOTE_CHARS = 120;
+var READ_TIMEOUT_MS = 18e4;
+var DESCRIPTION = `Gather what real customers say and keep it as Knowledge: one file per customer truth in src/content/insights/<id>.md, each a quote found word for word in its source (status: observed). Ads and ideas are written from these.
+
+Start here: baker research customers --focus "<product or persona>"
+
+Reads the company's review library, Reddit (with --focus or --query) and, with --web, a few web pages. A model only points at spans; a quote is kept only if it appears verbatim in the text it came from AND that text is a buyer talking about this company, its product, category or a competitor (judged against COMPANY.md). Everything else is dropped and counted: dropped_not_verbatim, dropped_off_topic, dropped_not_a_buyer. Never write an insight by hand, and never add back a dropped one.
+
+Examples:
+  baker research customers --focus "payroll app for restaurants"
+  baker research customers --query "chasing invoices" --web
+  baker research customers --dry-run`;
+var ARGS = {
+  focus: {
+    type: "string",
+    required: false,
+    description: 'The product or persona to listen for, e.g. "payroll for restaurants". Also the Reddit search when --query is not given.'
+  },
+  query: {
+    type: "string",
+    required: false,
+    description: `Search terms in the customers' own words, e.g. "chasing invoices". Used for Reddit and the web.`
+  },
+  limit: { type: "string", required: false, description: `Most insights written (default ${DEFAULT_LIMIT}).` },
+  web: {
+    type: "boolean",
+    required: false,
+    default: false,
+    description: `Also read up to ${WEB_PAGES} web pages where customers talk about it (slower).`
+  },
+  "dry-run": {
+    type: "boolean",
+    required: false,
+    default: false,
+    description: "Show what would be written; write nothing."
+  },
+  full: {
+    type: "boolean",
+    required: false,
+    default: false,
+    description: "Add each insight's whole quote, source and context."
+  }
+};
+registerSchema({ command: "research.customers", description: DESCRIPTION, args: ARGS });
+var InsightFrontmatter = z.object({ quote: z.string(), source: z.string().optional().catch(void 0) });
+function filedOf(raw) {
+  const front = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1];
+  if (!front) return { quote: "" };
+  try {
+    const parsed = InsightFrontmatter.safeParse(parseYaml(front));
+    if (!parsed.success) return { quote: "" };
+    const { quote, source } = parsed.data;
+    return source ? { quote, source } : { quote };
+  } catch {
+    return { quote: "" };
+  }
+}
+async function readExistingInsights(dir) {
+  const files = (await readdir(dir).catch(() => [])).filter((f) => f.endsWith(".md"));
+  return await Promise.all(
+    files.map(async (file) => ({
+      id: file.slice(0, -3),
+      ...filedOf(await readFile(path.join(dir, file), "utf8").catch(() => ""))
+    }))
+  );
+}
+var MAX_COMPANY_CHARS = 4e3;
+async function companyAbout(root) {
+  const doc = await readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => "");
+  const text = doc.replace(/<!--[\s\S]*?-->/g, "").trim();
+  if (!text || /^#\s*Company\s*\n+TODO\b/i.test(text)) return void 0;
+  return text.slice(0, MAX_COMPANY_CHARS);
+}
+async function productSlugs(root) {
+  const files = await readdir(path.join(root, "src", "content", "products")).catch(() => []);
+  return files.filter((f) => f.endsWith(".md")).map((f) => f.slice(0, -3));
+}
+async function gatherTestimonials(focus) {
+  try {
+    const search = { query: focus ?? "", limit: 40 };
+    const data = focus ? await apiPost("/api/testimonials/search", search) : await apiGet("/api/testimonials", { limit: "50" });
+    return sourcesFromTestimonials(data);
+  } catch {
+    return null;
+  }
+}
+async function gatherReddit(query) {
+  const subreddits = await findSubreddits({ query: query.slice(0, 100), limit: 3 }).then((r) => r.results.filter((s) => s.access !== "private").map((s) => s.name)).catch(() => []);
+  const answers = await Promise.allSettled([
+    searchReddit({ query, subreddits, kind: "posts", limit: 15 }),
+    ...subreddits.length > 0 ? [searchReddit({ query, subreddits, kind: "comments", limit: 25 })] : []
+  ]);
+  if (answers.every((a) => a.status === "rejected")) return null;
+  const seen = /* @__PURE__ */ new Set();
+  const items = answers.flatMap((a) => a.status === "fulfilled" ? a.value.results : []).filter((item) => !seen.has(item.id) && Boolean(seen.add(item.id)));
+  return sourcesFromReddit(items);
+}
+var ExploreAnswer = z.object({ sources: z.array(z.object({ url: z.string(), resolved: z.boolean().optional() })) });
+function webPageUrls(sources) {
+  return sources.filter((source) => source.resolved !== false && !/reddit\.com/i.test(source.url)).map((source) => source.url).filter((url, i, all) => all.indexOf(url) === i);
+}
+async function gatherWeb(topic) {
+  let urls;
+  try {
+    const found = ExploreAnswer.parse(
+      await apiPost(
+        "/api/research/explore",
+        {
+          question: `Which pages carry first-hand customer comments about ${topic}, in the customers' own words: reviews, complaints, forum threads?`,
+          depth: "medium"
+        },
+        { timeoutMs: READ_TIMEOUT_MS }
+      )
+    );
+    urls = webPageUrls(found.sources.slice(0, WEB_PAGES * 2));
+  } catch {
+    return null;
+  }
+  const pages = await Promise.allSettled(
+    urls.slice(0, WEB_PAGES).map((url) => {
+      const body = { url };
+      return apiPost("/api/research/fetch", body, { timeoutMs: READ_TIMEOUT_MS });
+    })
+  );
+  return sourcesFromPages(pages.flatMap((p) => p.status === "fulfilled" ? [p.value] : []));
+}
+var CLASSIFY_TIMEOUT_MS = 9e4;
+var CLASSIFY_REQUEST = { seed: 0, response_format: { type: "json_object" }, reasoning: { effort: "low" } };
+async function classifyBatch(batch, context, onSpend) {
+  const prompt = buildCustomersPrompt(batch, context);
+  for (let attempt = 0; attempt < 2; attempt++) {
+    const candidates = candidatesFrom(
+      await askAboutText(CUSTOMER_INSIGHTS_MODEL, prompt, onSpend, {
+        timeoutMs: CLASSIFY_TIMEOUT_MS,
+        request: CLASSIFY_REQUEST
+      })
+    );
+    if (candidates) return candidates;
+  }
+  return null;
+}
+function interleave(lists) {
+  const out = [];
+  const longest = Math.max(0, ...lists.map((l) => l.length));
+  for (let i = 0; i < longest; i++) {
+    for (const list of lists) {
+      const source = list[i];
+      if (source) out.push(source);
+    }
+  }
+  return out;
+}
+function fail(code, message, fix) {
+  writeJson({ ok: false, error: { code, message, fix } });
+  process.exit(1);
+}
+async function gatherSources(opts) {
+  const { focus, topic, web: withWeb } = opts;
+  const [testimonials, reddit, web] = await Promise.all([
+    gatherTestimonials(focus),
+    topic ? gatherReddit(topic) : Promise.resolve(null),
+    withWeb && topic ? gatherWeb(topic) : Promise.resolve(null)
+  ]);
+  const counts = {
+    testimonials: testimonials?.length ?? null,
+    reddit: reddit?.length ?? null,
+    web: web?.length ?? null
+  };
+  return { all: interleave([testimonials ?? [], reddit ?? [], web ?? []]), counts };
+}
+async function classifyAll(sources, context, root) {
+  const batches = batchSources(sources, BATCH_CHARS).slice(0, MAX_BATCHES);
+  const spent = [];
+  const answers = await Promise.all(batches.map((batch) => classifyBatch(batch, context, (u) => spent.push(u))));
+  await holdUnbilledSpend(path.join(root, "canvas", ".cache"), spent);
+  if (batches.length > 0 && answers.every((a) => a === null)) return null;
+  const result = { kept: [], dropped: 0, tooLong: 0, offTopic: 0, notABuyer: 0 };
+  batches.forEach((batch, i) => {
+    const verbatim = keepVerbatim(answers[i] ?? [], batch);
+    const relevant = keepOnTopic(verbatim.kept);
+    result.kept.push(...relevant.kept);
+    result.dropped += verbatim.dropped;
+    result.tooLong += verbatim.tooLong;
+    result.offTopic += relevant.offTopic;
+    result.notABuyer += relevant.notABuyer;
+  });
+  return result;
+}
+async function writeInsights(dir, writes, opts) {
+  if (writes.length === 0) return [];
+  await mkdir(dir, { recursive: true });
+  const written = [];
+  for (const entry of writes) {
+    const file = renderInsightFile(entry.insight, opts);
+    const ok = await writeFile(path.join(dir, `${entry.id}.md`), file, { encoding: "utf8", flag: "wx" }).then(
+      () => true,
+      () => false
+    );
+    if (ok) written.push(entry);
+  }
+  return written;
+}
+function writtenRow({ id, insight }, full) {
+  const quote = insight.quote.length > SHOWN_QUOTE_CHARS ? `${insight.quote.slice(0, SHOWN_QUOTE_CHARS)}\u2026` : insight.quote;
+  if (!full) return { id, type: insight.type, quote };
+  return {
+    id,
+    type: insight.type,
+    quote,
+    full_quote: insight.quote,
+    source: insight.source.ref,
+    context: insight.source.context,
+    ...insight.force ? { force: insight.force } : {},
+    ...insight.persona ? { persona: insight.persona } : {},
+    ...insight.why ? { why: insight.why } : {}
+  };
+}
+async function resolveTopic(root, focus, query) {
+  const products = await productSlugs(root);
+  const product = focus ? products.find((slug) => slug === asciiWords(focus).join("-")) : void 0;
+  const firstProduct = products[0];
+  const topic = query ?? focus ?? (firstProduct ? asciiWords(firstProduct).join(" ") : void 0);
+  return { product, products, topic };
+}
+async function researchCustomers(root, opts) {
+  const { focus, query, limit = DEFAULT_LIMIT, web = false, dryRun = false } = opts;
+  const { product, products, topic } = await resolveTopic(root, focus, query);
+  const [{ all, counts }, about] = await Promise.all([gatherSources({ focus, topic, web }), companyAbout(root)]);
+  const company = { products, ...about ? { about } : {} };
+  const gated = await classifyAll(all, { ...focus ? { focus } : {}, company }, root);
+  if (!gated) return null;
+  const dir = path.join(root, INSIGHTS_DIR);
+  const plan = planInsightWrites(gated.kept, await readExistingInsights(dir), limit);
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const shown = dryRun ? plan.writes : await writeInsights(dir, plan.writes, { today, ...product ? { product } : {} });
+  return { shown, plan, gated, counts };
+}
+var customersCommand = defineCommand({
+  meta: { name: "customers", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args }) {
+    const focus = args.focus?.trim() || void 0;
+    const query = args.query?.trim() || void 0;
+    const limit = args.limit === void 0 ? DEFAULT_LIMIT : Number(args.limit);
+    if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+      fail("VALIDATION_ERROR", "--limit must be a whole number from 1 to 100.", "Run it again with --limit 20.");
+    }
+    const dryRun = Boolean(args["dry-run"]);
+    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const found = await researchCustomers(root, { focus, query, limit, web: Boolean(args.web), dryRun });
+    if (!found) {
+      fail(
+        "UNAVAILABLE",
+        "The model that picks out customer words did not answer (no gateway key here, or it failed twice).",
+        "Run it again. Do not write insights by hand: an insight is only a quote this command found in its source."
+      );
+    }
+    const { shown, plan, gated, counts } = found;
+    writeJson({
+      ok: true,
+      data: {
+        ...dryRun ? { dry_run: true } : {},
+        written: shown.map((entry) => writtenRow(entry, Boolean(args.full))),
+        skipped_existing: plan.skippedExisting,
+        ...plan.skippedOverlap > 0 ? { skipped_overlap: plan.skippedOverlap } : {},
+        dropped_not_verbatim: gated.dropped,
+        dropped_off_topic: gated.offTopic,
+        ...gated.notABuyer > 0 ? { dropped_not_a_buyer: gated.notABuyer } : {},
+        ...gated.tooLong > 0 ? { dropped_too_long: gated.tooLong } : {},
+        sources: counts
+      },
+      hints: customersHints({
+        written: shown.length,
+        offTopic: gated.offTopic,
+        notABuyer: gated.notABuyer,
+        sources: counts
+      })
+    });
+  }
+});
+
+export {
+  INSIGHT_TYPES,
+  FORCES,
+  FITS,
+  MAX_QUOTE_CHARS,
+  keepVerbatim,
+  keepOnTopic,
+  planInsightWrites,
+  renderInsightFile,
+  sourcesFromTestimonials,
+  sourcesFromReddit,
+  sourcesFromPages,
+  buildCustomersPrompt,
+  candidatesFrom,
+  batchSources,
+  customersHints,
+  webPageUrls,
+  researchCustomers,
+  customersCommand
+};
+//# sourceMappingURL=chunk-QLXVHWAC.js.map