@koda-sl/baker-cli 0.542.0 → 0.544.0

package/dist/chunk-CBQMSX2T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/customers.ts","../../api/src/verbatim.ts"],"sourcesContent":["import { mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type {\n  ResearchFetchRequest,\n  ResearchFetchResponse,\n  ResearchRedditItem,\n  TestimonialsSearchRequest,\n} from \"@baker/api\";\nimport { findVerbatim, foldForComparison } from \"@baker/api/verbatim\";\nimport { CUSTOMER_INSIGHTS_MODEL } from \"@baker/canvas-contract\";\nimport { defineCommand } from \"citty\";\nimport { parse as parseYaml } from \"yaml\";\nimport { z } from \"zod\";\nimport { apiGet, apiPost } from \"../../client.ts\";\nimport { askAboutText, type ReviewUsage } from \"../../engine/nodes/local/lib/render-review.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { holdUnbilledSpend } from \"../canvas/unbilled-spend.ts\";\nimport { findSubreddits, searchReddit } from \"./reddit.ts\";\n\n/**\n * `baker research customers` — what real customers say, kept only where they said it.\n *\n * Ads start from a customer's own words. An agent asked for those words writes plausible ones,\n * and a plausible quote is the one thing an ad must never carry. So nothing here is written by\n * the agent or the model: the model only POINTS at a span of a fetched text, and the code keeps\n * that span only if it is in that text as written (`keepVerbatim`) and the model judged the text a\n * buyer talking about this company (`keepOnTopic`): a real quote from the wrong conversation is\n * as useless to an ad as an invented one. One Knowledge file per insight, `status: observed`.\n */\n\nexport const INSIGHT_TYPES = [\n  \"accommodation\",\n  \"failed_solution\",\n  \"nearly_didnt\",\n  \"word\",\n  \"moment\",\n  \"pain\",\n  \"objection\",\n  \"desire\",\n  \"proof\",\n  \"other\",\n] as const;\nexport type InsightType = (typeof INSIGHT_TYPES)[number];\n\nexport const FORCES = [\"push\", \"pull\", \"anxiety\", \"habit\"] as const;\nexport type Force = (typeof FORCES)[number];\n\nexport type SourceKind = \"review\" | \"testimonial\" | \"reddit\" | \"web\";\n\n/**\n * The model's verdict on a span's text. Verbatim is not enough: a real quote from a thread about\n * a mobile game, or from someone the product acts against, is still not this company's customer\n * talking (BAKER-2148, BAKER-2495). on_topic: a buyer or user of this company, its product, its\n * category or a named competitor, about the problem it solves. off_topic: about something else.\n * not_a_buyer: on the subject, but the speaker is not a buyer (someone the product acts against,\n * a seller or the company replying, a marketer).\n */\nexport const FITS = [\"on_topic\", \"off_topic\", \"not_a_buyer\"] as const;\nexport type Fit = (typeof FITS)[number];\n\n/** One text a customer wrote, as the model is shown it and the gate checks it. */\nexport type CustomerSource = {\n  /** What the insight cites: a URL, or `testimonials:<id>`. */\n  ref: string;\n  kind: SourceKind;\n  text: string;\n  /** One line: who said it, where. */\n  context: string;\n  /** When it was said, YYYY-MM-DD, when the source knows. */\n  saidOn?: string;\n};\n\n/** What the model points at: a span of source number `source` (1-based, as the prompt numbers them). */\nexport type Candidate = {\n  source: number;\n  quote: string;\n  type: InsightType;\n  force?: Force;\n  persona?: string;\n  fit?: Fit;\n  /** The model's one-line reason for `fit`. */\n  why?: string;\n};\n\n/** A candidate whose quote is in its source as written. */\nexport type VerbatimInsight = Omit<Candidate, \"source\"> & { source: CustomerSource };\n\nexport const MAX_QUOTE_CHARS = 280;\n\n/**\n * The gate: a candidate survives only if its quote is in the source it cites, and what is kept\n * is the source's own spelling of that span, not the model's copy of it. Everything else (a\n * paraphrase, a quote cited to the wrong text, a source that does not exist) is dropped and\n * counted, never repaired; a span longer than MAX_QUOTE_CHARS is counted apart. Pure.\n */\nexport function keepVerbatim(\n  candidates: readonly Candidate[],\n  sources: readonly CustomerSource[],\n): { kept: VerbatimInsight[]; dropped: number; tooLong: number } {\n  const kept: VerbatimInsight[] = [];\n  let dropped = 0;\n  let tooLong = 0;\n  for (const { source: index, ...rest } of candidates) {\n    const source = sources[index - 1];\n    const quote = source ? findVerbatim(rest.quote, source.text) : null;\n    if (!source || !quote) {\n      dropped++;\n      continue;\n    }\n    if (quote.length > MAX_QUOTE_CHARS) {\n      tooLong++;\n      continue;\n    }\n    kept.push({ ...rest, quote, source });\n  }\n  return { kept, dropped, tooLong };\n}\n\n/**\n * The second gate: a verbatim span is kept only when the model judged its text on topic AND\n * said why. A missing verdict or reason is off topic, never a pass, so a model that skips the\n * question writes nothing. Off-topic and wrong-speaker spans are counted apart. Pure.\n */\nexport function keepOnTopic(insights: readonly VerbatimInsight[]): {\n  kept: VerbatimInsight[];\n  offTopic: number;\n  notABuyer: number;\n} {\n  const kept: VerbatimInsight[] = [];\n  let offTopic = 0;\n  let notABuyer = 0;\n  for (const insight of insights) {\n    if (insight.fit === \"not_a_buyer\") notABuyer++;\n    else if (insight.fit === \"on_topic\" && insight.why?.trim()) kept.push(insight);\n    else offTopic++;\n  }\n  return { kept, offTopic, notABuyer };\n}\n\nconst SLUG_WORDS = 6;\n\n/** Lowercase ASCII words, accents dropped. */\nfunction asciiWords(text: string): string[] {\n  return text\n    .normalize(\"NFKD\")\n    .replace(/\\p{M}/gu, \"\")\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \" \")\n    .trim()\n    .split(\" \")\n    .filter(Boolean);\n}\n\n/** The file name an insight gets: its type, then the first words of its quote, kebab-case ASCII. Pure. */\nfunction insightSlug(type: InsightType, quote: string): string {\n  return [type.replace(/_/g, \"-\"), ...asciiWords(quote).slice(0, SLUG_WORDS)].join(\"-\");\n}\n\nexport type PlannedInsight = { id: string; insight: VerbatimInsight };\n\n/** An insight on file, as the planner compares it. `source` is absent on a file that names none. */\nexport type FiledInsight = { id: string; quote: string; source?: string };\n\n/**\n * Which insights to write and under what id. The first five types first (they write most of an\n * ad), at most `limit`. A quote already on file (or already planned) is skipped; so is a span\n * that contains, or is contained in, a quote filed from the same source (counted apart as an\n * overlap: the same customer statement filed twice double-counts it, BAKER-2198). An id held by a\n * different quote gets a `-2`, `-3`… so a file is never overwritten. Pure.\n */\nexport function planInsightWrites(\n  insights: readonly VerbatimInsight[],\n  existing: readonly FiledInsight[],\n  limit: number,\n): { writes: PlannedInsight[]; skippedExisting: number; skippedOverlap: number } {\n  const filed = existing.map((e) => ({ folded: foldForComparison(e.quote), source: e.source }));\n  const quotes = new Set(filed.map((e) => e.folded));\n  const ids = new Set(existing.map((e) => e.id));\n  const ranked = [...insights].sort((a, b) => INSIGHT_TYPES.indexOf(a.type) - INSIGHT_TYPES.indexOf(b.type));\n  const writes: PlannedInsight[] = [];\n  let skippedExisting = 0;\n  let skippedOverlap = 0;\n  for (const insight of ranked) {\n    const folded = foldForComparison(insight.quote);\n    if (quotes.has(folded)) {\n      skippedExisting++;\n      continue;\n    }\n    const overlaps = filed.some(\n      (e) => e.source === insight.source.ref && e.folded && (e.folded.includes(folded) || folded.includes(e.folded)),\n    );\n    if (overlaps) {\n      skippedOverlap++;\n      continue;\n    }\n    if (writes.length >= limit) continue;\n    const base = insightSlug(insight.type, insight.quote);\n    let id = base;\n    for (let n = 2; ids.has(id); n++) id = `${base}-${n}`;\n    quotes.add(folded);\n    filed.push({ folded, source: insight.source.ref });\n    ids.add(id);\n    writes.push({ id, insight });\n  }\n  return { writes, skippedExisting, skippedOverlap };\n}\n\n/** A frontmatter string, YAML-safe: a JSON string is a valid double-quoted YAML scalar. */\nfunction yamlScalar(value: string): string {\n  return JSON.stringify(value);\n}\n\nconst TITLE_CHARS = 70;\n\n/** The quote's opening words as the entry's title, in quote marks, so the Knowledge list reads as what was said. */\nfunction insightTitle(quote: string): string {\n  const text = quote.replace(/[\"“”]/g, \"\").replace(/\\s+/g, \" \").trim();\n  if (text.length <= TITLE_CHARS) return `“${text}”`;\n  const cut = text.slice(0, TITLE_CHARS);\n  return `“${cut.slice(0, cut.lastIndexOf(\" \")).replace(/[,;:.]$/, \"\")}…”`;\n}\n\n/**\n * The insight's Knowledge file (`src/content/insights/<id>.md`): frontmatter per the `insights`\n * collection, `status: observed`, and one line of context as the body. Pure.\n */\nexport function renderInsightFile(insight: VerbatimInsight, opts: { today: string; product?: string }): string {\n  const { source } = insight;\n  const lines = [\n    \"---\",\n    `title: ${yamlScalar(insightTitle(insight.quote))}`,\n    `type: ${insight.type}`,\n    `quote: ${yamlScalar(insight.quote)}`,\n    `source: ${yamlScalar(source.ref)}`,\n    `sourceKind: ${source.kind}`,\n    `seenAt: ${yamlScalar(source.saidOn ?? opts.today)}`,\n    \"status: observed\",\n  ];\n  if (insight.force) lines.push(`force: ${insight.force}`);\n  if (insight.persona?.trim()) lines.push(`persona: ${yamlScalar(insight.persona.trim())}`);\n  if (opts.product) lines.push(`product: ${yamlScalar(opts.product)}`);\n  lines.push(\"---\", \"\", source.context.replace(/\\s+/g, \" \").trim(), \"\");\n  return lines.join(\"\\n\");\n}\n\n/** How much of one review or comment the model reads (and the gate checks against). */\nconst MAX_SHORT_SOURCE_CHARS = 1_500;\n\nconst PLATFORM_NAMES: Record<string, string> = {\n  google: \"Google\",\n  trustpilot: \"Trustpilot\",\n  yelp: \"Yelp\",\n  tripadvisor: \"Tripadvisor\",\n  g2: \"G2\",\n  capterra: \"Capterra\",\n  amazon: \"Amazon\",\n  app_store: \"App Store\",\n  google_play: \"Google Play\",\n};\n\n/** One library review as `/api/testimonials` returns it, read loosely so a new field never empties the list. */\nconst LibraryReviewSchema = z.object({\n  _id: z.string().min(1),\n  reviewText: z.string(),\n  sourceType: z.string().optional(),\n  rating: z.number().optional(),\n  reviewDate: z.number().optional(),\n});\n\nfunction dayOf(ms: number | string): string | undefined {\n  const date = new Date(ms);\n  return Number.isNaN(date.getTime()) ? undefined : date.toISOString().slice(0, 10);\n}\n\n/** \"A …\" or \"An …\", ending in one full stop. */\nfunction sentence(rest: string): string {\n  const line = `${/^[aeiou]/i.test(rest) ? \"An\" : \"A\"} ${rest}`;\n  return line.endsWith(\".\") ? line : `${line}.`;\n}\n\n/**\n * \"A 4★ Trustpilot review.\" The kind of source and its rating, never the reviewer: this line is\n * committed to the client's repository and published as Knowledge, and whoever needs the person\n * follows `source` to the library (BAKER-2471).\n */\nfunction reviewContext(review: z.infer<typeof LibraryReviewSchema>): string {\n  const platform = review.sourceType ? `${PLATFORM_NAMES[review.sourceType] ?? review.sourceType} ` : \"\";\n  const rating = review.rating !== undefined ? `${review.rating}★ ` : \"\";\n  return sentence(`${rating}${platform}review`);\n}\n\n/** The company's reviews (a plain list from `/api/testimonials`) as sources, each cited `testimonials:<id>`. Pure. */\nexport function sourcesFromTestimonials(data: unknown): CustomerSource[] {\n  const list = Array.isArray(data) ? data : [];\n  return list.flatMap((item): CustomerSource[] => {\n    const parsed = LibraryReviewSchema.safeParse(item);\n    if (!parsed.success) return [];\n    const review = parsed.data;\n    const text = review.reviewText.trim().slice(0, MAX_SHORT_SOURCE_CHARS);\n    if (!text) return [];\n    const saidOn = review.reviewDate !== undefined ? dayOf(review.reviewDate) : undefined;\n    return [\n      {\n        ref: `testimonials:${review._id}`,\n        kind: \"review\",\n        text,\n        context: reviewContext(review),\n        ...(saidOn ? { saidOn } : {}),\n      },\n    ];\n  });\n}\n\n/** Reddit posts and comments as sources, each cited by its own permalink; a post's title counts as its words. Pure. */\nexport function sourcesFromReddit(items: readonly ResearchRedditItem[]): CustomerSource[] {\n  return items.flatMap((item): CustomerSource[] => {\n    const words = item.kind === \"post\" ? [item.title ?? \"\", item.text].filter((t) => t.trim()).join(\"\\n\\n\") : item.text;\n    const text = words.trim().slice(0, MAX_SHORT_SOURCE_CHARS);\n    if (!text) return [];\n    const under = item.kind === \"comment\" && item.title ? `, under ${JSON.stringify(item.title)}` : \"\";\n    const saidOn = dayOf(item.createdAt);\n    return [\n      {\n        ref: item.permalink,\n        kind: \"reddit\",\n        text,\n        context: `A Reddit ${item.kind} in r/${item.subreddit}${under}.`,\n        ...(saidOn ? { saidOn } : {}),\n      },\n    ];\n  });\n}\n\n/** How much of one web page the model reads (and the gate checks against). */\nconst MAX_PAGE_SOURCE_CHARS = 6_000;\n\n/** Pages read with `research fetch` as sources, each cited by where the read landed. Pure. */\nexport function sourcesFromPages(pages: readonly ResearchFetchResponse[]): CustomerSource[] {\n  return pages.flatMap((page): CustomerSource[] => {\n    const text = page.content.trim().slice(0, MAX_PAGE_SOURCE_CHARS);\n    if (!text) return [];\n    const host = URL.canParse(page.finalUrl) ? new URL(page.finalUrl).host : page.finalUrl;\n    const title = page.title?.trim() ? `, ${JSON.stringify(page.title.trim())}` : \"\";\n    return [{ ref: page.finalUrl, kind: \"web\", text, context: `A page on ${host}${title}.` }];\n  });\n}\n\n/** What the model judges relevance against: COMPANY.md as written, and the product entries' names. */\nexport type CompanyContext = { about?: string; products: readonly string[] };\n\n/** A source as the model reads it: its number, where it was said, then the text. */\nfunction promptLine(source: CustomerSource, n: number): string {\n  const where = source.context.replace(/\\s+/g, \" \").trim();\n  const ofCompany = source.kind === \"review\" ? \" A review of this company.\" : \"\";\n  return `[${n}] ${where || ofCompany ? `(${`${where}${ofCompany}`.trim()}) ` : \"\"}${source.text}`;\n}\n\n/**\n * The classification prompt: who the company is, numbered texts, and the instruction to point at\n * exact spans of them with a verdict on whether each is about this company's customers. What comes\n * back is only a pointer and a verdict; `keepVerbatim` and `keepOnTopic` decide what is kept. Pure.\n */\nexport function buildCustomersPrompt(\n  sources: readonly CustomerSource[],\n  opts: { focus?: string; company?: CompanyContext } = {},\n): string {\n  const { focus, company } = opts;\n  const about = company?.about?.trim();\n  const products = company?.products.length ? `Its products: ${company.products.join(\", \")}.` : \"\";\n  return [\n    `Below are ${sources.length} numbered texts (reviews, testimonials, forum posts and comments, web pages)${focus ? `, gathered about: ${focus}` : \"\"}.`,\n    \"Find what this company's customers say in them, the material its ads are written from.\",\n    \"\",\n    \"The company:\",\n    about ? about : \"(no company description on file: judge by the focus and the company's own reviews)\",\n    ...(products ? [products] : []),\n    \"\",\n    \"Rules:\",\n    \"- 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.\",\n    `- The shortest span that carries the truth, at most ${MAX_QUOTE_CHARS} characters.`,\n    \"- 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.\",\n    \"- 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.\",\n    \"- why: one short line on what makes it that fit (who is speaking, about what).\",\n    \"- 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.\",\n    \"- 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).\",\n    '- persona: a few words on who is speaking, only when the text says it (\"restaurant owner\", \"night-shift courier\"). Never a person\\'s name.',\n    \"\",\n    'Reply with only this JSON: {\"insights\":[{\"source\":1,\"quote\":\"\",\"fit\":\"\",\"why\":\"\",\"type\":\"\",\"force\":\"\",\"persona\":\"\"}]}',\n    \"\",\n    \"Texts:\",\n    ...sources.map((source, i) => promptLine(source, i + 1)),\n  ].join(\"\\n\");\n}\n\nconst AnswerSchema = z.object({ insights: z.array(z.unknown()) });\n\nconst CandidateSchema = z.object({\n  source: z.coerce.number().int().positive(),\n  quote: z.string().trim().min(1),\n  type: z.enum(INSIGHT_TYPES).catch(\"other\"),\n  force: z.enum(FORCES).optional().catch(undefined),\n  persona: z.string().trim().optional().catch(undefined),\n  fit: z.enum(FITS).optional().catch(undefined),\n  why: z.string().trim().optional().catch(undefined),\n});\n\n/** The model's spans, or null when the reply is not the asked shape. An item that is not a span is dropped. Pure. */\nexport function candidatesFrom(answer: unknown): Candidate[] | null {\n  const parsed = AnswerSchema.safeParse(answer);\n  if (!parsed.success) return null;\n  return parsed.data.insights.flatMap((item): Candidate[] => {\n    const candidate = CandidateSchema.safeParse(item);\n    if (!candidate.success) return [];\n    const { source, quote, type, force, persona, fit, why } = candidate.data;\n    return [\n      {\n        source,\n        quote,\n        type,\n        ...(force ? { force } : {}),\n        ...(persona ? { persona } : {}),\n        ...(fit ? { fit } : {}),\n        ...(why ? { why } : {}),\n      },\n    ];\n  });\n}\n\n/** Sources in batches of at most `budget` characters of text; a source is never split. Pure. */\nexport function batchSources(sources: readonly CustomerSource[], budget: number): CustomerSource[][] {\n  const batches: CustomerSource[][] = [];\n  let current: CustomerSource[] = [];\n  let size = 0;\n  for (const source of sources) {\n    if (current.length > 0 && size + source.text.length > budget) {\n      batches.push(current);\n      current = [];\n      size = 0;\n    }\n    current.push(source);\n    size += source.text.length;\n  }\n  if (current.length > 0) batches.push(current);\n  return batches;\n}\n\n/** How many insights answered per source; null when the source was not asked or did not answer. */\nexport type SourceCounts = { testimonials: number | null; reddit: number | null; web: number | null };\n\nconst FEW_OBSERVED = 5;\n\n/** What the agent does next. Pure. */\nexport function customersHints(input: {\n  written: number;\n  offTopic?: number;\n  notABuyer?: number;\n  sources: SourceCounts;\n}): string[] {\n  const { written, offTopic = 0, notABuyer = 0, sources } = input;\n  const widen =\n    'Search in the customers\\' own words with --query \"<the words they write>\" (their phrasing, not a category name), or add --web.';\n  const elsewhere =\n    offTopic > 0 && offTopic >= written\n      ? [\n          `${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.`,\n        ]\n      : [];\n  const notBuyers =\n    notABuyer > 0 && notABuyer >= written\n      ? [\n          `${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 — 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.`,\n        ]\n      : [];\n  const why = [...elsewhere, ...notBuyers];\n  if (written === 0) {\n    return [\n      ...why,\n      \"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…) brings their reviews into the library; then run this again.\",\n      ...(sources.reddit === null\n        ? ['Reddit was not read: pass --focus \"<product>\" or --query \"<their words>\".']\n        : [widen]),\n      \"Until there are observed truths, ad ideas go in as explore bets: an idea with an empty `evidence` list.\",\n    ];\n  }\n  const cite = `Cite these by id in an idea's \\`evidence\\` (src/creatives/_ideas/<idea>.md); write the ad from the quote as said.`;\n  return [...why, ...(written < FEW_OBSERVED ? [`Only ${written} observed. ${widen}`, cite] : [cite])];\n}\n\n// ---------------------------------------------------------------------------\n// The command: gather, classify, gate, write\n// ---------------------------------------------------------------------------\n\nconst INSIGHTS_DIR = path.join(\"src\", \"content\", \"insights\");\nconst BATCH_CHARS = 24_000;\nconst MAX_BATCHES = 5;\nconst WEB_PAGES = 3;\nconst DEFAULT_LIMIT = 20;\nconst SHOWN_QUOTE_CHARS = 120;\nconst READ_TIMEOUT_MS = 180_000;\n\nconst 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.\n\nStart here: baker research customers --focus \"<product or persona>\"\n\nReads 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.\n\nExamples:\n  baker research customers --focus \"payroll app for restaurants\"\n  baker research customers --query \"chasing invoices\" --web\n  baker research customers --dry-run`;\n\nconst ARGS = {\n  focus: {\n    type: \"string\",\n    required: false,\n    description:\n      'The product or persona to listen for, e.g. \"payroll for restaurants\". Also the Reddit search when --query is not given.',\n  },\n  query: {\n    type: \"string\",\n    required: false,\n    description: 'Search terms in the customers\\' own words, e.g. \"chasing invoices\". Used for Reddit and the web.',\n  },\n  limit: { type: \"string\", required: false, description: `Most insights written (default ${DEFAULT_LIMIT}).` },\n  web: {\n    type: \"boolean\",\n    required: false,\n    default: false,\n    description: `Also read up to ${WEB_PAGES} web pages where customers talk about it (slower).`,\n  },\n  \"dry-run\": {\n    type: \"boolean\",\n    required: false,\n    default: false,\n    description: \"Show what would be written; write nothing.\",\n  },\n  full: {\n    type: \"boolean\",\n    required: false,\n    default: false,\n    description: \"Add each insight's whole quote, source and context.\",\n  },\n} as const;\n\nregisterSchema({ command: \"research.customers\", description: DESCRIPTION, args: ARGS });\n\nconst InsightFrontmatter = z.object({ quote: z.string(), source: z.string().optional().catch(undefined) });\n\n/** An insight file's `quote` and `source`; quote \"\" when it has none that reads. */\nfunction filedOf(raw: string): { quote: string; source?: string } {\n  const front = raw.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---/)?.[1];\n  if (!front) return { quote: \"\" };\n  try {\n    const parsed = InsightFrontmatter.safeParse(parseYaml(front));\n    if (!parsed.success) return { quote: \"\" };\n    const { quote, source } = parsed.data;\n    return source ? { quote, source } : { quote };\n  } catch {\n    return { quote: \"\" };\n  }\n}\n\n/** The insights already on file: id, quote and source. Never throws. */\nasync function readExistingInsights(dir: string): Promise<FiledInsight[]> {\n  const files = (await readdir(dir).catch(() => [] as string[])).filter((f) => f.endsWith(\".md\"));\n  return await Promise.all(\n    files.map(async (file) => ({\n      id: file.slice(0, -3),\n      ...filedOf(await readFile(path.join(dir, file), \"utf8\").catch(() => \"\")),\n    })),\n  );\n}\n\n/** How much of COMPANY.md the model reads to judge relevance; the file is meant to stay ~40 lines. */\nconst MAX_COMPANY_CHARS = 4_000;\n\n/** COMPANY.md without its comments, or undefined when it is missing or still the unfilled stub. Never throws. */\nasync function companyAbout(root: string): Promise<string | undefined> {\n  const doc = await readFile(path.join(root, \"COMPANY.md\"), \"utf8\").catch(() => \"\");\n  const text = doc.replace(/<!--[\\s\\S]*?-->/g, \"\").trim();\n  if (!text || /^#\\s*Company\\s*\\n+TODO\\b/i.test(text)) return undefined;\n  return text.slice(0, MAX_COMPANY_CHARS);\n}\n\n/** The product entries' names (file slugs). Never throws. */\nasync function productSlugs(root: string): Promise<string[]> {\n  const files = await readdir(path.join(root, \"src\", \"content\", \"products\")).catch(() => [] as string[]);\n  return files.filter((f) => f.endsWith(\".md\")).map((f) => f.slice(0, -3));\n}\n\n/** The library's reviews: the ones about --focus when given, else the latest. Null when the library did not answer. */\nasync function gatherTestimonials(focus: string | undefined): Promise<CustomerSource[] | null> {\n  try {\n    const search: TestimonialsSearchRequest = { query: focus ?? \"\", limit: 40 };\n    const data = focus\n      ? await apiPost<unknown>(\"/api/testimonials/search\", search)\n      : await apiGet<unknown>(\"/api/testimonials\", { limit: \"50\" });\n    return sourcesFromTestimonials(data);\n  } catch {\n    return null;\n  }\n}\n\n/** Reddit posts and comments matching `query`, in the subreddits where it is talked about. Null when Reddit did not answer. */\nasync function gatherReddit(query: string): Promise<CustomerSource[] | null> {\n  const subreddits = await findSubreddits({ query: query.slice(0, 100), limit: 3 })\n    .then((r) => r.results.filter((s) => s.access !== \"private\").map((s) => s.name))\n    .catch(() => [] as string[]);\n  const answers = await Promise.allSettled([\n    searchReddit({ query, subreddits, kind: \"posts\", limit: 15 }),\n    ...(subreddits.length > 0 ? [searchReddit({ query, subreddits, kind: \"comments\", limit: 25 })] : []),\n  ]);\n  if (answers.every((a) => a.status === \"rejected\")) return null;\n  const seen = new Set<string>();\n  const items = answers\n    .flatMap((a) => (a.status === \"fulfilled\" ? a.value.results : []))\n    .filter((item) => !seen.has(item.id) && Boolean(seen.add(item.id)));\n  return sourcesFromReddit(items);\n}\n\nconst ExploreAnswer = z.object({ sources: z.array(z.object({ url: z.string(), resolved: z.boolean().optional() })) });\n\n/**\n * The pages web research named, in its order and once each. The backend follows Google's\n * grounding redirects itself; a link it could not follow (`resolved: false`) names no page a\n * quote could cite, and a Reddit page is read through `research reddit`, never as a web page.\n */\nexport function webPageUrls(sources: readonly { url: string; resolved?: boolean }[]): string[] {\n  return sources\n    .filter((source) => source.resolved !== false && !/reddit\\.com/i.test(source.url))\n    .map((source) => source.url)\n    .filter((url, i, all) => all.indexOf(url) === i);\n}\n\n/** A few web pages where customers talk about `topic`, each read whole. Null when the web did not answer. */\nasync function gatherWeb(topic: string): Promise<CustomerSource[] | null> {\n  let urls: string[];\n  try {\n    const found = ExploreAnswer.parse(\n      await apiPost<unknown>(\n        \"/api/research/explore\",\n        {\n          question: `Which pages carry first-hand customer comments about ${topic}, in the customers' own words: reviews, complaints, forum threads?`,\n          depth: \"medium\",\n        },\n        { timeoutMs: READ_TIMEOUT_MS },\n      ),\n    );\n    urls = webPageUrls(found.sources.slice(0, WEB_PAGES * 2));\n  } catch {\n    return null;\n  }\n  const pages = await Promise.allSettled(\n    urls.slice(0, WEB_PAGES).map((url) => {\n      const body: ResearchFetchRequest = { url };\n      return apiPost<ResearchFetchResponse>(\"/api/research/fetch\", body, { timeoutMs: READ_TIMEOUT_MS });\n    }),\n  );\n  return sourcesFromPages(pages.flatMap((p) => (p.status === \"fulfilled\" ? [p.value] : [])));\n}\n\n/**\n * Pointing at spans and judging each text's subject needs little thought: at the model's default\n * reasoning one 19k-character batch took 143s on dev (2026-10-26) and outran the 60s budget, at\n * low effort 7s with the same verdicts. An extraction asks for JSON at a fixed seed, so the same\n * texts read the same.\n */\nconst CLASSIFY_TIMEOUT_MS = 90_000;\nconst CLASSIFY_REQUEST = { seed: 0, response_format: { type: \"json_object\" }, reasoning: { effort: \"low\" } };\n\n/** One batch's spans, asked at most twice; null when the model never answered in shape. */\nasync function classifyBatch(\n  batch: CustomerSource[],\n  context: { focus?: string; company: CompanyContext },\n  onSpend: (usage: ReviewUsage) => void,\n): Promise<Candidate[] | null> {\n  const prompt = buildCustomersPrompt(batch, context);\n  for (let attempt = 0; attempt < 2; attempt++) {\n    const candidates = candidatesFrom(\n      await askAboutText(CUSTOMER_INSIGHTS_MODEL, prompt, onSpend, {\n        timeoutMs: CLASSIFY_TIMEOUT_MS,\n        request: CLASSIFY_REQUEST,\n      }),\n    );\n    if (candidates) return candidates;\n  }\n  return null;\n}\n\n/** Sources taken in turn from each list, so every kind reaches the model when there is more than it reads. */\nfunction interleave(lists: readonly CustomerSource[][]): CustomerSource[] {\n  const out: CustomerSource[] = [];\n  const longest = Math.max(0, ...lists.map((l) => l.length));\n  for (let i = 0; i < longest; i++) {\n    for (const list of lists) {\n      const source = list[i];\n      if (source) out.push(source);\n    }\n  }\n  return out;\n}\n\nfunction fail(code: string, message: string, fix: string): never {\n  writeJson({ ok: false, error: { code, message, fix } });\n  process.exit(1);\n}\n\n/** Every source asked at once; one that does not answer is null and never stops the rest. */\nasync function gatherSources(opts: { focus?: string; topic?: string; web: boolean }) {\n  const { focus, topic, web: withWeb } = opts;\n  const [testimonials, reddit, web] = await Promise.all([\n    gatherTestimonials(focus),\n    topic ? gatherReddit(topic) : Promise.resolve(null),\n    withWeb && topic ? gatherWeb(topic) : Promise.resolve(null),\n  ]);\n  const counts: SourceCounts = {\n    testimonials: testimonials?.length ?? null,\n    reddit: reddit?.length ?? null,\n    web: web?.length ?? null,\n  };\n  return { all: interleave([testimonials ?? [], reddit ?? [], web ?? []]), counts };\n}\n\n/**\n * Every batch classified and gated; null when the model answered no batch at all. The spend\n * waits in the workspace's canvas cache: no run record carries these calls, so the next render\n * of this workspace bills them.\n */\ntype Gated = { kept: VerbatimInsight[]; dropped: number; tooLong: number; offTopic: number; notABuyer: number };\n\nasync function classifyAll(\n  sources: readonly CustomerSource[],\n  context: { focus?: string; company: CompanyContext },\n  root: string,\n): Promise<Gated | null> {\n  const batches = batchSources(sources, BATCH_CHARS).slice(0, MAX_BATCHES);\n  const spent: ReviewUsage[] = [];\n  const answers = await Promise.all(batches.map((batch) => classifyBatch(batch, context, (u) => spent.push(u))));\n  await holdUnbilledSpend(path.join(root, \"canvas\", \".cache\"), spent);\n  if (batches.length > 0 && answers.every((a) => a === null)) return null;\n  const result: Gated = { kept: [], dropped: 0, tooLong: 0, offTopic: 0, notABuyer: 0 };\n  batches.forEach((batch, i) => {\n    const verbatim = keepVerbatim(answers[i] ?? [], batch);\n    const relevant = keepOnTopic(verbatim.kept);\n    result.kept.push(...relevant.kept);\n    result.dropped += verbatim.dropped;\n    result.tooLong += verbatim.tooLong;\n    result.offTopic += relevant.offTopic;\n    result.notABuyer += relevant.notABuyer;\n  });\n  return result;\n}\n\n/** Writes each planned file, never over one that appeared since the plan (`wx`); returns what was written. */\nasync function writeInsights(\n  dir: string,\n  writes: readonly PlannedInsight[],\n  opts: { today: string; product?: string },\n): Promise<PlannedInsight[]> {\n  if (writes.length === 0) return [];\n  await mkdir(dir, { recursive: true });\n  const written: PlannedInsight[] = [];\n  for (const entry of writes) {\n    const file = renderInsightFile(entry.insight, opts);\n    const ok = await writeFile(path.join(dir, `${entry.id}.md`), file, { encoding: \"utf8\", flag: \"wx\" }).then(\n      () => true,\n      () => false,\n    );\n    if (ok) written.push(entry);\n  }\n  return written;\n}\n\nfunction writtenRow({ id, insight }: PlannedInsight, full: boolean) {\n  const quote =\n    insight.quote.length > SHOWN_QUOTE_CHARS ? `${insight.quote.slice(0, SHOWN_QUOTE_CHARS)}…` : insight.quote;\n  if (!full) return { id, type: insight.type, quote };\n  return {\n    id,\n    type: insight.type,\n    quote,\n    full_quote: insight.quote,\n    source: insight.source.ref,\n    context: insight.source.context,\n    ...(insight.force ? { force: insight.force } : {}),\n    ...(insight.persona ? { persona: insight.persona } : {}),\n    ...(insight.why ? { why: insight.why } : {}),\n  };\n}\n\n/** What the run listens for: the product a --focus names, and the words Reddit and the web are searched with. */\nasync function resolveTopic(root: string, focus: string | undefined, query: string | undefined) {\n  const products = await productSlugs(root);\n  const product = focus ? products.find((slug) => slug === asciiWords(focus).join(\"-\")) : undefined;\n  const firstProduct = products[0];\n  const topic = query ?? focus ?? (firstProduct ? asciiWords(firstProduct).join(\" \") : undefined);\n  return { product, products, topic };\n}\n\n/**\n * Gathers, classifies, gates and writes customer truths into the workspace; null when the model\n * answered no batch. Shared with `baker creatives brief`, which runs it when few quotes are on file.\n */\nexport async function researchCustomers(\n  root: string,\n  opts: { focus?: string; query?: string; limit?: number; web?: boolean; dryRun?: boolean },\n) {\n  const { focus, query, limit = DEFAULT_LIMIT, web = false, dryRun = false } = opts;\n  const { product, products, topic } = await resolveTopic(root, focus, query);\n  const [{ all, counts }, about] = await Promise.all([gatherSources({ focus, topic, web }), companyAbout(root)]);\n  const company: CompanyContext = { products, ...(about ? { about } : {}) };\n  const gated = await classifyAll(all, { ...(focus ? { focus } : {}), company }, root);\n  if (!gated) return null;\n  const dir = path.join(root, INSIGHTS_DIR);\n  const plan = planInsightWrites(gated.kept, await readExistingInsights(dir), limit);\n  const today = new Date().toISOString().slice(0, 10);\n  const shown = dryRun\n    ? plan.writes\n    : await writeInsights(dir, plan.writes, { today, ...(product ? { product } : {}) });\n  return { shown, plan, gated, counts };\n}\n\nexport const customersCommand = defineCommand({\n  meta: { name: \"customers\", description: DESCRIPTION },\n  args: ARGS,\n  async run({ args }) {\n    const focus = args.focus?.trim() || undefined;\n    const query = args.query?.trim() || undefined;\n    const limit = args.limit === undefined ? DEFAULT_LIMIT : Number(args.limit);\n    if (!Number.isInteger(limit) || limit < 1 || limit > 100) {\n      fail(\"VALIDATION_ERROR\", \"--limit must be a whole number from 1 to 100.\", \"Run it again with --limit 20.\");\n    }\n    const dryRun = Boolean(args[\"dry-run\"]);\n    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();\n    const found = await researchCustomers(root, { focus, query, limit, web: Boolean(args.web), dryRun });\n    if (!found) {\n      fail(\n        \"UNAVAILABLE\",\n        \"The model that picks out customer words did not answer (no gateway key here, or it failed twice).\",\n        \"Run it again. Do not write insights by hand: an insight is only a quote this command found in its source.\",\n      );\n    }\n    const { shown, plan, gated, counts } = found;\n\n    writeJson({\n      ok: true,\n      data: {\n        ...(dryRun ? { dry_run: true } : {}),\n        written: shown.map((entry) => writtenRow(entry, Boolean(args.full))),\n        skipped_existing: plan.skippedExisting,\n        ...(plan.skippedOverlap > 0 ? { skipped_overlap: plan.skippedOverlap } : {}),\n        dropped_not_verbatim: gated.dropped,\n        dropped_off_topic: gated.offTopic,\n        ...(gated.notABuyer > 0 ? { dropped_not_a_buyer: gated.notABuyer } : {}),\n        ...(gated.tooLong > 0 ? { dropped_too_long: gated.tooLong } : {}),\n        sources: counts,\n      },\n      hints: customersHints({\n        written: shown.length,\n        offTopic: gated.offTopic,\n        notABuyer: gated.notABuyer,\n        sources: counts,\n      }),\n    });\n  },\n});\n","/**\n * Is this span on the page as written? The one comparison every verbatim gate\n * uses — `baker research customers` keeping a customer's words, `baker research\n * cite` proving a quote — so a span that passes one passes the other.\n *\n * \"As written\" forgives what a copy changes without changing the words:\n * curly vs straight quotes, dashes vs hyphens, runs of spacing, letter case and\n * compatibility forms (NFKC). Nothing else: a paraphrase is not the span.\n */\n\n/** Curly and prime quote marks, by code point: single ones read as ', double ones as \". */\nconst SINGLE_QUOTES = new Set([0x2018, 0x2019, 0x201a, 0x201b, 0x2032]);\nconst DOUBLE_QUOTES = new Set([0x201c, 0x201d, 0x201e, 0x201f, 0x2033]);\n/** Hyphen, non-breaking hyphen, figure/en/em dash, horizontal bar, minus: all read as -. */\nconst DASHES = new Set([0x2010, 0x2011, 0x2012, 0x2013, 0x2014, 0x2015, 0x2212]);\n\nfunction foldChar(char: string): string {\n  if (/\\s/.test(char)) return \" \";\n  const code = char.codePointAt(0) ?? 0;\n  if (SINGLE_QUOTES.has(code)) return \"'\";\n  if (DOUBLE_QUOTES.has(code)) return '\"';\n  if (DASHES.has(code)) return \"-\";\n  return char.normalize(\"NFKC\").toLowerCase();\n}\n\n/**\n * A text in the comparison form, with, for each folded character, where it\n * starts in the original.\n */\nfunction foldWithOffsets(text: string): { folded: string; offsets: number[] } {\n  let folded = \"\";\n  const offsets: number[] = [];\n  let at = 0;\n  for (const char of text) {\n    const out = foldChar(char);\n    const collapses = out === \" \" && (folded.length === 0 || folded.endsWith(\" \"));\n    if (!collapses) {\n      for (const piece of out) {\n        folded += piece;\n        offsets.push(at);\n      }\n    }\n    at += char.length;\n  }\n  if (folded.endsWith(\" \")) {\n    folded = folded.slice(0, -1);\n    offsets.pop();\n  }\n  return { folded, offsets };\n}\n\n/** A text in the comparison form alone — for comparing two quotes with each other. */\nexport function foldForComparison(text: string): string {\n  return foldWithOffsets(text).folded;\n}\n\n/** Where `quote` sits in `text` under the comparison form, as `[start, end)` of the original, or null. */\nexport function findVerbatimSpan(quote: string, text: string): { start: number; end: number } | null {\n  const needle = foldWithOffsets(quote).folded;\n  if (needle.length === 0) return null;\n  const { folded, offsets } = foldWithOffsets(text);\n  const at = folded.indexOf(needle);\n  if (at < 0) return null;\n  const start = offsets[at] ?? 0;\n  const last = offsets[at + needle.length - 1] ?? 0;\n  const end = last + (String.fromCodePoint(text.codePointAt(last) ?? 0).length || 1);\n  return { start, end };\n}\n\n/**\n * The text's own spelling of `quote` (spacing collapsed), or null when it is\n * not there. What a gate keeps is the source's words, never the caller's copy.\n */\nexport function findVerbatim(quote: string, text: string): string | null {\n  const span = findVerbatimSpan(quote, text);\n  return span ? text.slice(span.start, span.end).replace(/\\s+/g, \" \").trim() : null;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-CDKO55S4.js

@@ -0,0 +1,170 @@
+import {
+  storeProductReads
+} from "./chunk-6REXNFPV.js";
+import {
+  coverageOf,
+  readCreativeRecords,
+  readIdeas,
+  readInsights,
+  readKnowledgeCorpus,
+  readPersonaIds,
+  sameMessageRead,
+  workspaceIdeasJudge
+} from "./chunk-GN7K3NPI.js";
+import {
+  readAllRules
+} from "./chunk-Z7BNOHTY.js";
+import {
+  IDEA_ANGLES,
+  IDEA_FORMATS,
+  checkIdeas
+} from "./chunk-RHEWQB5O.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-BGT5ZA4L.js";
+import {
+  selectRules
+} from "./chunk-4D73PLXU.js";
+import {
+  marketFromCompanyDoc
+} from "./chunk-2WZI36D3.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+
+// src/commands/creatives/ideas.ts
+import { readFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+var BUILD_NEXT = 3;
+var DESCRIPTION = `Check and rank the ad ideas in src/creatives/_ideas/: is each backed by something a customer said (src/content/insights/), does it claim only what the Knowledge holds, is it a different ad from the others, does it fill a gap the live ads leave. Free and local.
+
+Start here, after writing 4-8 idea files (one per file: who, message, evidence, awareness, angle, shows, job, why; format only for a video or a container the person asked for; plus product: <handle> when the ad sells a store product, so the store's prices count as sourced):
+  baker creatives ideas            # ranked, with problems; build_next names the ones to make
+  baker creatives make <idea>      # then build each one in build_next
+An idea with a problem is not built until it is fixed. An idea with no evidence is an explore bet: it may be built, and says so.`;
+var ARGS = {
+  full: {
+    type: "boolean",
+    description: "Every idea with its warnings and gaps, and the allowed angle and format values",
+    required: false,
+    default: false
+  }
+};
+registerSchema({ command: "creatives.ideas", description: DESCRIPTION, args: ARGS });
+function ideasHints(report) {
+  const hints = [];
+  const toBuild = report.ideas.filter((i) => i.status === "idea");
+  if (toBuild.length === 0 && report.unreadable.length === 0) {
+    hints.push(
+      "No ideas yet. Write 4-8 files in src/creatives/_ideas/<idea>.md (who, message, evidence, awareness, angle, shows, job, why), then run this again."
+    );
+  }
+  if (report.unreadable.length > 0) {
+    hints.push(`Fix ${report.unreadable.map((u) => u.id).join(", ")}: each names what is missing or unknown.`);
+  }
+  const blocked = toBuild.filter((i) => i.problems.length > 0);
+  if (blocked.length > 0) hints.push(`Fix before building: ${blocked.map((i) => i.id).join(", ")}.`);
+  if (report.observedCount < 3) {
+    hints.push(
+      "Few customer quotes on file: run `baker research customers` so ideas stand on what customers said; until then they are explore bets."
+    );
+  } else if (toBuild.length > 0 && toBuild.every((i) => i.evidence === "explore")) {
+    hints.push("No idea cites an insight: put the insight ids that back each one in its `evidence`.");
+  }
+  const next = buildNext(report.ideas);
+  if (next.length === 1) hints.push(`Build: \`baker creatives make ${next[0]}\`.`);
+  if (next.length > 1)
+    hints.push(
+      `Build ${next.join(", ")} at once: one \`creative-producer\` per idea, all spawned in one message in the background, each given its idea id, and handle each as it returns. Never build them one after another: each render takes minutes. Edited an idea after this check? Run \`baker creatives ideas\` again first: a producer cannot build an idea with a problem.`
+    );
+  return hints;
+}
+function buildNext(ideas, count = BUILD_NEXT) {
+  const ready = ideas.filter((i) => i.status === "idea" && i.problems.length === 0);
+  const firstBet = ready.find((i) => i.evidence === "explore");
+  return ready.filter((i) => i.evidence !== "explore" || i === firstBet).slice(0, count).map((i) => i.id);
+}
+function compactIdea(check) {
+  return {
+    idea: check.id,
+    status: check.status,
+    evidence: check.evidence,
+    ...check.quote ? { quote: check.quote.length > 120 ? `${check.quote.slice(0, 117)}...` : check.quote } : {},
+    awareness: check.awareness,
+    angle: check.angle,
+    ...check.shows ? { shows: check.shows } : {},
+    ...check.format ? { format: check.format } : {},
+    platforms: check.platforms ?? "unset",
+    ...check.problems.length > 0 ? { problems: check.problems } : {},
+    ...check.warnings.length > 0 ? { warnings: check.warnings } : {}
+  };
+}
+async function ideasReport(root, opts = {}) {
+  const judge = opts.ask ? { ask: opts.ask, done: () => Promise.resolve() } : workspaceIdeasJudge(root);
+  const [{ ideas, unreadable }, insights, knowledge, personas, creatives, rules, companyDoc] = await Promise.all([
+    readIdeas(root),
+    readInsights(root, { ask: judge.ask }),
+    readKnowledgeCorpus(root),
+    readPersonaIds(root),
+    readCreativeRecords(root),
+    readAllRules(root).then((all) => selectRules(all, {})),
+    readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => null)
+  ]);
+  const language = marketFromCompanyDoc(companyDoc)?.language;
+  const [sameMessage, products] = await Promise.all([
+    sameMessageRead(ideas, judge.ask),
+    storeProductReads(
+      ideas.map((i) => i.product),
+      opts.readProduct
+    )
+  ]);
+  await judge.done();
+  const checked = checkIdeas({
+    ideas,
+    insights,
+    knowledge,
+    personas,
+    sameMessage,
+    products,
+    rules,
+    ...language ? { language } : {},
+    ...coverageOf(ideas, creatives)
+  });
+  return {
+    ideas: checked,
+    unreadable,
+    insightCount: insights.length,
+    observedCount: insights.filter((i) => i.status === "observed").length
+  };
+}
+var ideasCommand = defineCommand({
+  meta: { name: "ideas", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args }) {
+    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const report = await ideasReport(root);
+    const full = args.full === true;
+    writeJson({
+      ok: true,
+      data: {
+        build_next: buildNext(report.ideas),
+        ideas: full ? report.ideas : report.ideas.map(compactIdea),
+        ...report.unreadable.length > 0 ? { unreadable: report.unreadable } : {},
+        customer_quotes: { total: report.insightCount, observed: report.observedCount },
+        ...full ? { allowed: { angle: IDEA_ANGLES, format: IDEA_FORMATS } } : {}
+      },
+      hints: ideasHints(report)
+    });
+  }
+});
+
+export {
+  ideasHints,
+  buildNext,
+  compactIdea,
+  ideasReport,
+  ideasCommand
+};
+//# sourceMappingURL=chunk-CDKO55S4.js.map

package/dist/chunk-CMXG4X3S.js

@@ -0,0 +1,203 @@
+import {
+  ACTION_TEMP_ID_PREFIX
+} from "./chunk-NFXW6C6I.js";
+import {
+  ApiError
+} from "./chunk-B2OHCWYB.js";
+import {
+  MissingChatIdError
+} from "./chunk-E54435XT.js";
+import {
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+
+// src/commands/actions/tagError.ts
+var UNKNOWN_TAG_RE = /Unknown action tag\(s\): ([^.]+)\. Valid tags: ([^.]+)\./;
+function splitSlugs(list) {
+  return list.split(",").map((slug) => slug.trim()).filter((slug) => slug.length > 0);
+}
+function actionTagFix(message) {
+  const match = UNKNOWN_TAG_RE.exec(message);
+  if (!match) {
+    return null;
+  }
+  const [, unknownList, validList] = match;
+  const unknownTags = splitSlugs(unknownList ?? "");
+  const validTags = splitSlugs(validList ?? "");
+  const first = unknownTags[0];
+  if (first === void 0 || validTags.length === 0) {
+    return null;
+  }
+  return {
+    action: "retry_with_a_valid_tag",
+    explanation: `The tag(s) ${unknownTags.join(", ")} are not in this company's taxonomy. \`validTags\` below is the complete accepted set \u2014 pick from it and re-run the same command. Only mint a new tag when none of them names this work; a near-duplicate of an existing tag splits the backlog's filter instead of extending it.`,
+    unknownTags,
+    validTags,
+    mintCommand: `baker actions tags create --slug ${first} --description "<what ${first} groups>"`,
+    listCommand: "baker actions tags list"
+  };
+}
+
+// src/commands/actions/shared.ts
+function writeOk(data) {
+  writeJson({ ok: true, data: data ?? null });
+}
+function failValidation(message) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function apiFailure(err) {
+  if (err instanceof ApiError) {
+    const fix = err.fix ?? actionTagFix(err.message);
+    return { ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } };
+  }
+  if (err instanceof MissingChatIdError) {
+    const explanation = "This command stages its change on the chat this run belongs to, and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here.";
+    return { ok: false, error: { code: err.code, message: err.message, fix: { action: "reject", explanation } } };
+  }
+  return {
+    ok: false,
+    error: { code: "INTERNAL_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  };
+}
+function failApi(err) {
+  writeJson(apiFailure(err));
+  process.exit(1);
+}
+function generateTempId() {
+  return `${ACTION_TEMP_ID_PREFIX}${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function isTempId(id) {
+  return id.startsWith(ACTION_TEMP_ID_PREFIX);
+}
+function parseTagList(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const tags = value.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
+  return [...new Set(tags)];
+}
+var ACTION_PRIORITIES = ["urgent", "high", "medium", "low"];
+function parsePriority(value, { allowClear }) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    failValidation(
+      `--priority must be one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+    );
+  }
+  const trimmed = value.trim().toLowerCase();
+  if (trimmed === "") {
+    if (allowClear) {
+      return null;
+    }
+    return void 0;
+  }
+  if (allowClear && (trimmed === "none" || trimmed === "clear")) {
+    return null;
+  }
+  if (ACTION_PRIORITIES.includes(trimmed)) {
+    return trimmed;
+  }
+  failValidation(
+    `Unknown --priority "${value}". Expected one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+  );
+}
+var FAN_OUT_NUDGE_THRESHOLD = 2;
+var FAN_OUT_THRESHOLD = 3;
+function buildCreateHints({
+  advisory,
+  name,
+  description,
+  tempId,
+  tags,
+  prioritySet,
+  draftCreateCount
+}) {
+  const hints = [];
+  const expanded = shellExpandedIn(`${name}
+${description}`);
+  if (expanded) {
+    hints.push(
+      `The text says \u201C${expanded}\u201D: the shell replaced a $ amount (like $0) inside double quotes before Baker saw it. Fix it now: baker actions update ${tempId} --description '<the text, with the amounts as you read them>' (and --name '\u2026' if the name has it) \u2014 single quotes keep $ as written.`
+    );
+  }
+  if (advisory) {
+    hints.push(
+      `${advisory.hint} If nothing actually blocks it: baker actions draft remove ${tempId}, then do the work.`
+    );
+  }
+  if (draftCreateCount >= FAN_OUT_THRESHOLD) {
+    hints.push(
+      `${draftCreateCount} Tasks are staged in this chat. Re-read them with \`baker actions draft\`: can any be done now with a surface you already have, and do any two touch the same system (same container, same campaign, same page)? Those belong in ONE Task \u2014 fold them together with \`baker actions update\` and drop the extras with \`baker actions draft remove <tempId>\`.`
+    );
+  } else if (draftCreateCount === FAN_OUT_NUDGE_THRESHOLD) {
+    hints.push(
+      `Second Task staged in this chat. If these two land on the same system (same container, same campaign, same page) they are ONE Task \u2014 fold them with \`baker actions update\` and drop the extra with \`baker actions draft remove ${tempId}\`.`
+    );
+  }
+  hints.push(`Link dependencies: baker actions link --blocker <id> --blocked ${tempId}`);
+  if (!description) {
+    hints.push("Add description: baker actions update <tempId> --description '...' (what/why/where/done-when)");
+  }
+  if (!tags || tags.length === 0) {
+    hints.push(
+      "MISSING --tags. This action is invisible to the backlog's tag filter. Re-run with --tags <slug,...> (`baker actions tags list` for the taxonomy, `baker actions tags create --slug <slug>` to mint) \u2014 or `baker actions update <tempId> --tags <slug,...>`."
+    );
+  }
+  if (!prioritySet) {
+    hints.push(
+      `MISSING --priority. Without it this action ranks as 'normal' (medium) in the do-first ordering, so urgent/high client work won't surface first. Re-run with --priority ${ACTION_PRIORITIES.join("|")} \u2014 or \`baker actions update <tempId> --priority <level>\`.`
+    );
+  }
+  return hints;
+}
+var SHELL_PATH = /(?:^|[\s(])((?:\/usr)?\/bin\/(?:ba|z|da|k)?sh|-(?:ba|z|da|k)sh)\b/;
+var MONEY_WORD = "spend|spent|spending|budget|revenue|sales|cost|costs|cpa|cpc|cpm|cpl|roas|profit|paid|earned";
+var BARE_SHELL = new RegExp(
+  `(?:\\b(?:${MONEY_WORD}|at|to|from|was|were|is)\\s+(bash|zsh)\\b|(?:^|[\\s(])(bash|zsh)(?=\\.\\d|\\s+(?:${MONEY_WORD})\\b))`,
+  "gi"
+);
+function shellExpandedIn(text) {
+  const path = SHELL_PATH.exec(text)?.[1];
+  if (path) return path;
+  for (const match of text.matchAll(BARE_SHELL)) {
+    const name = match[1] ?? match[2];
+    if (name && name === name.toLowerCase()) return name;
+  }
+  return null;
+}
+var ACTIONS_LIST_DEFAULT_LIMIT = 500;
+function buildListHints({ returned, limit }) {
+  if (returned < limit) {
+    return [];
+  }
+  return [
+    `This list is capped at ${limit} Tasks and came back full, so older Tasks exist that are NOT shown. Do not treat it as the whole backlog \u2014 re-run with --limit ${limit * 2} (or narrow with --status / --search).`
+  ];
+}
+function buildGetHints(detail) {
+  if (detail?.action.status !== "pending" || detail.activeChat !== null) {
+    return [];
+  }
+  return [
+    `If you are working on this Task in this chat, claim it first so the Tasks page shows it in progress: baker actions claim ${detail.action._id}`
+  ];
+}
+
+export {
+  writeOk,
+  failValidation,
+  failApi,
+  generateTempId,
+  isTempId,
+  parseTagList,
+  ACTION_PRIORITIES,
+  parsePriority,
+  buildCreateHints,
+  ACTIONS_LIST_DEFAULT_LIMIT,
+  buildListHints,
+  buildGetHints
+};
+//# sourceMappingURL=chunk-CMXG4X3S.js.map

package/dist/chunk-D3LTHRZZ.js

@@ -0,0 +1,66 @@
+import {
+  recordIdeaLines
+} from "./chunk-GFBEO33K.js";
+import {
+  anchorLines,
+  readIdeaAnchor
+} from "./chunk-LUIV5R2Z.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-BGT5ZA4L.js";
+
+// src/commands/creatives/idea-hint.ts
+import path from "path";
+function present(fields) {
+  const said = Object.entries(fields).filter(([, v]) => v !== void 0 && !(Array.isArray(v) && v.length === 0));
+  return Object.fromEntries(said);
+}
+function anchorOut(view, full) {
+  const reference = view.reference ? {
+    ...present({ adId: view.reference.adId, advertiser: view.advertiser }),
+    carry: view.reference.carry,
+    mustKeep: view.reference.mustKeep
+  } : void 0;
+  const compact = present({
+    message: view.message,
+    language: view.language,
+    reference,
+    seriesLead: view.seriesLead,
+    accent: view.accent,
+    cast: view.cast,
+    who: view.who,
+    survives: view.survives
+  });
+  if (!full) return compact;
+  return {
+    ...compact,
+    ...present({ why: view.why, voices: view.voices, voiceIds: view.voiceIds, route: view.route }),
+    changes: view.changes
+  };
+}
+function ideaHint(view) {
+  return `Its idea: ${anchorLines(view).join(" \xB7 ").replace(
+    /[.!?…]+$/u,
+    ""
+  )}. An edit keeps it: change exactly what they named; a change of the idea they asked for is one line under "## Changes" in _definition.md, the reason after the dash.`;
+}
+function withAnchor(response, view, opts) {
+  return {
+    ...response,
+    data: { ...response.data, anchor: anchorOut(view, opts.full) },
+    hints: [ideaHint(view), ...response.hints ?? []]
+  };
+}
+async function readCreativeIdea(slug) {
+  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+  const read = await readIdeaAnchor(path.join(root, "src", "creatives", slug));
+  if (!read) return null;
+  await recordIdeaLines(path.join(root, "canvas"), slug, anchorLines(read.view)).catch(() => void 0);
+  return read.view;
+}
+
+export {
+  withAnchor,
+  readCreativeIdea
+};
+//# sourceMappingURL=chunk-D3LTHRZZ.js.map