@koda-sl/baker-cli 0.449.0 → 0.450.0-dev.b454c3dd2

package/dist/chunk-RPUSTYHL.js

@@ -1,170 +0,0 @@
-import {
-  CONVERSION_COUNT_MODES,
-  findNameCollision,
-  isLandingViewKey,
-  parseEventKey
-} from "./chunk-SSJK7FEV.js";
-
-// src/commands/analytics/conversionArgs.ts
-var ConversionArgsError = class extends Error {
-};
-function allValues(flag, argv) {
-  const values = [];
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg === flag) {
-      const next = argv[i + 1];
-      if (next !== void 0 && !next.startsWith("--")) values.push(next);
-      continue;
-    }
-    if (arg.startsWith(`${flag}=`)) values.push(arg.slice(flag.length + 1));
-  }
-  return values.map((value) => value.trim()).filter((value) => value !== "");
-}
-function onlyOnce(value, flag, argv) {
-  if (value === void 0) return void 0;
-  const given = argv.filter((arg) => arg === flag || arg.startsWith(`${flag}=`)).length;
-  if (given > 1) {
-    throw new ConversionArgsError(
-      `${flag} was given ${given} times and only the last would have been used. It takes one value.`
-    );
-  }
-  const trimmed = String(value).trim();
-  return trimmed === "" ? void 0 : trimmed;
-}
-function repeatable(flag, cittyValue, argv) {
-  const fromArgv = allValues(flag, argv);
-  if (fromArgv.length > 0) return fromArgv;
-  if (cittyValue === void 0) return [];
-  const trimmed = String(cittyValue).trim();
-  return trimmed === "" ? [] : [trimmed];
-}
-function checkFlagShape(args) {
-  if (args.eventKeys.length > 0 && args.name === void 0 && args.countMode === void 0) {
-    throw new ConversionArgsError(
-      "--event needs --name: a conversion nobody named is a row labelled with a UUID. (--event with only --count-mode changes how an event already counted is counted.)"
-    );
-  }
-  if (args.name !== void 0 && args.eventKeys.length === 0 && args.renameTo === void 0) {
-    throw new ConversionArgsError("--name needs --event, naming which event to count.");
-  }
-  if (args.renameFrom !== void 0 && args.renameTo === void 0) {
-    throw new ConversionArgsError('--rename needs --to: `--rename "Lead form" --to "Lead"`.');
-  }
-  if (args.renameTo !== void 0 && args.renameFrom === void 0) {
-    throw new ConversionArgsError(
-      '--to needs --rename, naming which outcome to rename: `--rename "Lead form" --to "Lead"`.'
-    );
-  }
-}
-function checkEventKeys(eventKeys) {
-  for (const eventKey of eventKeys) {
-    if (parseEventKey(eventKey) === null) {
-      throw new ConversionArgsError(
-        `"${eventKey}" is not an event key. Run with --candidates (or --flow <slug> for one Form) and copy one; they look like form:<form>:<step>:<trigger>, submit:<form>, page:<name> or exit:<host>.`
-      );
-    }
-    if (isLandingViewKey(eventKey)) {
-      throw new ConversionArgsError(
-        `"${eventKey}" is a landing being viewed \u2014 a funnel step, never a conversion. Add it as a step with \`baker funnel\` instead.`
-      );
-    }
-  }
-}
-function readDays(raw) {
-  if (raw === void 0) return void 0;
-  const days = Number(raw);
-  if (!Number.isFinite(days) || days <= 0) {
-    throw new ConversionArgsError("--days must be a positive number of days.");
-  }
-  return days;
-}
-function parseConversionsArgs(raw, argv) {
-  const countMode = onlyOnce(raw["count-mode"], "--count-mode", argv);
-  if (countMode !== void 0 && !CONVERSION_COUNT_MODES.includes(countMode)) {
-    throw new ConversionArgsError(`--count-mode must be one of ${CONVERSION_COUNT_MODES.join(", ")}.`);
-  }
-  const args = {
-    eventKeys: repeatable("--event", raw.event, argv),
-    removeKeys: repeatable("--remove", raw.remove, argv),
-    name: onlyOnce(raw.name, "--name", argv),
-    countMode,
-    renameFrom: onlyOnce(raw.rename, "--rename", argv),
-    renameTo: onlyOnce(raw.to, "--to", argv),
-    removeName: onlyOnce(raw["remove-name"], "--remove-name", argv),
-    flowSlug: onlyOnce(raw.flow, "--flow", argv),
-    candidates: raw.candidates === true,
-    full: raw.full === true,
-    days: readDays(raw.days)
-  };
-  checkFlagShape(args);
-  checkEventKeys(args.eventKeys);
-  return args;
-}
-function existingNames(existing) {
-  return [...new Set(existing.map((row) => row.name))];
-}
-function checkNameCollision(name, existing) {
-  const collision = findNameCollision(name, existingNames(existing));
-  if (collision === null) return;
-  throw new ConversionArgsError(
-    `This company already counts "${collision}", and "${name}" would be a second row for the same outcome \u2014 Baker groups by exact name, so the number would be split in two. Use "${collision}" to make them one number, or pick a name that means something different.`
-  );
-}
-function under(name, existing) {
-  const rows = existing.filter((row) => row.name === name);
-  if (rows.length === 0) {
-    throw new ConversionArgsError(
-      `Nothing is counted under "${name}". This company counts: ${existingNames(existing).join(", ") || "nothing yet"}.`
-    );
-  }
-  return rows;
-}
-function setFromEvents(args, existing) {
-  if (args.eventKeys.length === 0) return [];
-  if (args.name !== void 0) {
-    checkNameCollision(args.name, existing);
-    const name = args.name;
-    return args.eventKeys.map((eventKey) => ({
-      eventKey,
-      name,
-      ...args.countMode ? { countMode: args.countMode } : {}
-    }));
-  }
-  return args.eventKeys.map((eventKey) => {
-    const current = existing.find((row) => row.eventKey === eventKey);
-    if (!current) {
-      throw new ConversionArgsError(
-        `"${eventKey}" is not counted, so there is no count mode to change. Add it with --event "${eventKey}" --name "<what a person calls it>" --count-mode ${args.countMode}.`
-      );
-    }
-    return { eventKey, name: current.name, countMode: args.countMode };
-  });
-}
-function setFromRename(args, existing) {
-  if (args.renameFrom === void 0 || args.renameTo === void 0) return [];
-  const renameTo = args.renameTo;
-  checkNameCollision(renameTo, existing);
-  return under(args.renameFrom, existing).map((row) => ({
-    eventKey: row.eventKey,
-    name: renameTo,
-    countMode: row.countMode
-  }));
-}
-function conversionsWrite(args, existing) {
-  const set = [...setFromEvents(args, existing), ...setFromRename(args, existing)];
-  const remove = [
-    ...args.removeKeys,
-    ...args.removeName === void 0 ? [] : under(args.removeName, existing).map((row) => row.eventKey)
-  ];
-  if (set.length === 0 && remove.length === 0) return null;
-  return { ...set.length > 0 ? { set } : {}, ...remove.length > 0 ? { remove } : {} };
-}
-
-export {
-  ConversionArgsError,
-  onlyOnce,
-  parseConversionsArgs,
-  conversionsWrite
-};
-//# sourceMappingURL=chunk-RPUSTYHL.js.map

package/dist/chunk-RPUSTYHL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/analytics/conversionArgs.ts"],"sourcesContent":["/**\n * Reading the flags of `baker analytics conversions`, and refusing the shapes\n * that would otherwise count the wrong thing in silence.\n *\n * Its own module because every refusal here is cheap and every one it misses is\n * expensive: a conversion definition that never matches anything does not\n * error, it counts zero forever, and the company reports a rate that is quietly\n * too low. The same is true of the other direction — a name that splits one\n * outcome into two rows makes both numbers too low and neither of them wrong\n * enough to notice.\n *\n * The write is built against what the company **already counts**, which is why\n * `conversionsWrite` takes the current definitions: renaming, re-moding and the\n * near-duplicate refusal are all questions about the existing set, and a CLI\n * that could not see it could only add.\n */\n\nimport { CONVERSION_COUNT_MODES, findNameCollision, isLandingViewKey, parseEventKey } from \"@baker/api/analytics\";\n\nexport interface ConversionsArgs {\n  /** Every `--event` given. Several under one `--name` is how they become one number. */\n  eventKeys: string[];\n  name?: string;\n  countMode?: string;\n  /** Every `--remove` given. */\n  removeKeys: string[];\n  renameFrom?: string;\n  renameTo?: string;\n  removeName?: string;\n  /** A Form to read its own endings from, whether or not any of them has fired. */\n  flowSlug?: string;\n  candidates: boolean;\n  /** Every field of every candidate, instead of one short line each. */\n  full: boolean;\n  days?: number;\n}\n\n/** One definition as this module needs to read it. */\nexport interface ExistingConversion {\n  eventKey: string;\n  name: string;\n  countMode: string;\n}\n\n/** Thrown for anything the caller can fix by re-running with different flags. */\nexport class ConversionArgsError extends Error {}\n\n/**\n * Every value given for a flag, in the order they were typed.\n *\n * Read out of the raw argv rather than out of citty's parsed args, because\n * citty keeps only the LAST value of a repeated flag and hands it over as a\n * plain string: `--event a --event b` arrives as `\"b\"` with nothing recording\n * that `a` was ever there. By the time the handler runs, the evidence is gone.\n *\n * The identical shape has cost this repo before: `--param a=1 --param b=2`\n * staged only `b=2` against a write that replaces an entity's whole set, and\n * two of three UTM parameters were silently deleted on publish. Here the flags\n * that can legitimately repeat are collected, and the ones that cannot are\n * refused by {@link onlyOnce} — never quietly resolved to one of them.\n */\nexport function allValues(flag: string, argv: readonly string[]): string[] {\n  const values: string[] = [];\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i] as string;\n    if (arg === flag) {\n      const next = argv[i + 1];\n      if (next !== undefined && !next.startsWith(\"--\")) values.push(next);\n      continue;\n    }\n    if (arg.startsWith(`${flag}=`)) values.push(arg.slice(flag.length + 1));\n  }\n  return values.map((value) => value.trim()).filter((value) => value !== \"\");\n}\n\n/** One value for a flag, or a refusal — never the last of several. */\nexport function onlyOnce(value: unknown, flag: string, argv: readonly string[]): string | undefined {\n  if (value === undefined) return undefined;\n  const given = argv.filter((arg) => arg === flag || arg.startsWith(`${flag}=`)).length;\n  if (given > 1) {\n    throw new ConversionArgsError(\n      `${flag} was given ${given} times and only the last would have been used. It takes one value.`,\n    );\n  }\n  const trimmed = String(value).trim();\n  return trimmed === \"\" ? undefined : trimmed;\n}\n\n/**\n * The repeatable flags, read from argv with citty's value as the fallback.\n *\n * The fallback matters for the single-value case: a test — and any caller that\n * builds the args itself — passes the parsed object without an argv, and\n * dropping the value there would make every one of those calls a silent read.\n */\nfunction repeatable(flag: string, cittyValue: unknown, argv: readonly string[]): string[] {\n  const fromArgv = allValues(flag, argv);\n  if (fromArgv.length > 0) return fromArgv;\n  if (cittyValue === undefined) return [];\n  const trimmed = String(cittyValue).trim();\n  return trimmed === \"\" ? [] : [trimmed];\n}\n\n/**\n * The four ways a set of flags can fail to say anything, each named.\n *\n * Split out of the parser for the reason the linter gives: a run of unrelated\n * refusals is the shape that grows one branch per flag until nobody can see\n * which combinations are legal.\n */\nfunction checkFlagShape(args: {\n  eventKeys: string[];\n  name?: string;\n  countMode?: string;\n  renameFrom?: string;\n  renameTo?: string;\n}): void {\n  // An event with no name and no mode change says which event and nothing about\n  // it; a name with no event names an outcome with nothing to count.\n  if (args.eventKeys.length > 0 && args.name === undefined && args.countMode === undefined) {\n    throw new ConversionArgsError(\n      \"--event needs --name: a conversion nobody named is a row labelled with a UUID. (--event with only --count-mode changes how an event already counted is counted.)\",\n    );\n  }\n  if (args.name !== undefined && args.eventKeys.length === 0 && args.renameTo === undefined) {\n    throw new ConversionArgsError(\"--name needs --event, naming which event to count.\");\n  }\n  if (args.renameFrom !== undefined && args.renameTo === undefined) {\n    throw new ConversionArgsError('--rename needs --to: `--rename \"Lead form\" --to \"Lead\"`.');\n  }\n  if (args.renameTo !== undefined && args.renameFrom === undefined) {\n    throw new ConversionArgsError(\n      '--to needs --rename, naming which outcome to rename: `--rename \"Lead form\" --to \"Lead\"`.',\n    );\n  }\n}\n\n/**\n * Refuse a key that cannot parse, here rather than at the backend.\n *\n * This is the mistake that costs a turn: an event key nothing can produce never\n * matches anything, so it does not error — it counts zero forever.\n */\nfunction checkEventKeys(eventKeys: readonly string[]): void {\n  for (const eventKey of eventKeys) {\n    if (parseEventKey(eventKey) === null) {\n      throw new ConversionArgsError(\n        `\"${eventKey}\" is not an event key. Run with --candidates (or --flow <slug> for one Form) and copy one; they look like form:<form>:<step>:<trigger>, submit:<form>, page:<name> or exit:<host>.`,\n      );\n    }\n    // The one readable key that is not an outcome. It exists so a funnel can\n    // begin at \"saw the page\"; marked as a conversion it would make the rate a\n    // ratio of the traffic to itself.\n    if (isLandingViewKey(eventKey)) {\n      throw new ConversionArgsError(\n        `\"${eventKey}\" is a landing being viewed — a funnel step, never a conversion. Add it as a step with \\`baker funnel\\` instead.`,\n      );\n    }\n  }\n}\n\nfunction readDays(raw: unknown): number | undefined {\n  if (raw === undefined) return undefined;\n  const days = Number(raw);\n  if (!Number.isFinite(days) || days <= 0) {\n    throw new ConversionArgsError(\"--days must be a positive number of days.\");\n  }\n  return days;\n}\n\nexport function parseConversionsArgs(raw: Record<string, unknown>, argv: readonly string[]): ConversionsArgs {\n  const countMode = onlyOnce(raw[\"count-mode\"], \"--count-mode\", argv);\n  if (countMode !== undefined && !(CONVERSION_COUNT_MODES as readonly string[]).includes(countMode)) {\n    throw new ConversionArgsError(`--count-mode must be one of ${CONVERSION_COUNT_MODES.join(\", \")}.`);\n  }\n\n  const args: ConversionsArgs = {\n    eventKeys: repeatable(\"--event\", raw.event, argv),\n    removeKeys: repeatable(\"--remove\", raw.remove, argv),\n    name: onlyOnce(raw.name, \"--name\", argv),\n    countMode,\n    renameFrom: onlyOnce(raw.rename, \"--rename\", argv),\n    renameTo: onlyOnce(raw.to, \"--to\", argv),\n    removeName: onlyOnce(raw[\"remove-name\"], \"--remove-name\", argv),\n    flowSlug: onlyOnce(raw.flow, \"--flow\", argv),\n    candidates: raw.candidates === true,\n    full: raw.full === true,\n    days: readDays(raw.days),\n  };\n\n  checkFlagShape(args);\n  checkEventKeys(args.eventKeys);\n  return args;\n}\n\nexport interface ConversionsWrite {\n  set?: { eventKey: string; name: string; countMode?: string }[];\n  remove?: string[];\n}\n\n/**\n * The names this company already counts, in the order they were defined.\n *\n * Exported because it is what every hint about reuse is built from: the first\n * thing an agent naming an outcome should see is what this company calls its\n * outcomes already.\n */\nexport function existingNames(existing: readonly ExistingConversion[]): string[] {\n  return [...new Set(existing.map((row) => row.name))];\n}\n\n/**\n * Refuse a name that reads the same as one already counted but stores\n * differently.\n *\n * Baker groups by exact name, so \"Booked a call\" and \"Booked a Call\" are two\n * rows and two numbers — a headline quietly split in half, with both halves\n * plausible. Nothing else in the system can catch it: both names are valid,\n * both keys are real, and every report is correct about the wrong grouping.\n *\n * A refusal rather than a hint because the fix is one character and the damage\n * is permanent-looking: nobody re-reads a conversion list to check for two rows\n * that mean the same thing.\n */\nfunction checkNameCollision(name: string, existing: readonly ExistingConversion[]): void {\n  const collision = findNameCollision(name, existingNames(existing));\n  if (collision === null) return;\n  throw new ConversionArgsError(\n    `This company already counts \"${collision}\", and \"${name}\" would be a second row for the same outcome — Baker groups by exact name, so the number would be split in two. Use \"${collision}\" to make them one number, or pick a name that means something different.`,\n  );\n}\n\n/** The definitions counted under a name, or a refusal naming what is. */\nfunction under(name: string, existing: readonly ExistingConversion[]): ExistingConversion[] {\n  const rows = existing.filter((row) => row.name === name);\n  if (rows.length === 0) {\n    throw new ConversionArgsError(\n      `Nothing is counted under \"${name}\". This company counts: ${existingNames(existing).join(\", \") || \"nothing yet\"}.`,\n    );\n  }\n  return rows;\n}\n\n/** `--event …` — each key set to the given name, or re-moded keeping the one it has. */\nfunction setFromEvents(args: ConversionsArgs, existing: readonly ExistingConversion[]) {\n  if (args.eventKeys.length === 0) return [];\n  if (args.name !== undefined) {\n    checkNameCollision(args.name, existing);\n    const name = args.name;\n    return args.eventKeys.map((eventKey) => ({\n      eventKey,\n      name,\n      ...(args.countMode ? { countMode: args.countMode } : {}),\n    }));\n  }\n  // `--count-mode` alone. The store needs a name on every write, and the only\n  // honest one is the name it already has: inventing one here would rename an\n  // outcome somebody chose, as a side effect of changing how it counts.\n  return args.eventKeys.map((eventKey) => {\n    const current = existing.find((row) => row.eventKey === eventKey);\n    if (!current) {\n      throw new ConversionArgsError(\n        `\"${eventKey}\" is not counted, so there is no count mode to change. Add it with --event \"${eventKey}\" --name \"<what a person calls it>\" --count-mode ${args.countMode}.`,\n      );\n    }\n    return { eventKey, name: current.name, countMode: args.countMode };\n  });\n}\n\n/**\n * `--rename … --to …` — every event under one name moved to another.\n *\n * Collision-checked like every other name, and that is not in tension with the\n * merge: renaming ONTO an existing name is the main thing the flag is for, and\n * `findNameCollision` returns `null` for an exact match precisely so that stays\n * free. What it refuses is the near-miss — renaming onto \"Booked a Call\" when\n * the company counts \"Booked a call\" — which is the split the whole rule exists\n * to prevent, arriving through the one flag that used to be exempt.\n */\nfunction setFromRename(args: ConversionsArgs, existing: readonly ExistingConversion[]) {\n  if (args.renameFrom === undefined || args.renameTo === undefined) return [];\n  const renameTo = args.renameTo;\n  checkNameCollision(renameTo, existing);\n  return under(args.renameFrom, existing).map((row) => ({\n    eventKey: row.eventKey,\n    name: renameTo,\n    countMode: row.countMode,\n  }));\n}\n\n/**\n * The write this call makes, or `null` when it is only a read. *\n * Every operation is expressed as `set` / `remove` over event keys, because\n * that is the only vocabulary the store has: a name is a property of a\n * definition, not a row of its own, so renaming an outcome is re-setting every\n * key underneath it and dropping one is removing them all.\n */\nexport function conversionsWrite(\n  args: ConversionsArgs,\n  existing: readonly ExistingConversion[],\n): ConversionsWrite | null {\n  const set = [...setFromEvents(args, existing), ...setFromRename(args, existing)];\n  const remove = [\n    ...args.removeKeys,\n    ...(args.removeName === undefined ? [] : under(args.removeName, existing).map((row) => row.eventKey)),\n  ];\n\n  if (set.length === 0 && remove.length === 0) return null;\n  return { ...(set.length > 0 ? { set } : {}), ...(remove.length > 0 ? { remove } : {}) };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-S77PZVYM.js

@@ -1,297 +0,0 @@
-import {
-  REDDIT_LINK_REJECTED,
-  redditSearchHints,
-  redditSubredditsHints,
-  redditThreadHints
-} from "./chunk-OZRUJVIQ.js";
-import {
-  handleResearchError,
-  writeResearchJson
-} from "./chunk-WNFIJAUO.js";
-import {
-  repeatedValues
-} from "./chunk-ERSX3MKH.js";
-import {
-  RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS
-} from "./chunk-XF4JUKVF.js";
-import {
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.js";
-
-// src/commands/research/reddit.ts
-import { defineCommand } from "citty";
-var TIMEOUT_MS = 18e4;
-var TEXT_PREVIEW_CHARS = 1500;
-var ITEM_FIELDS = {
-  kind: "post or comment",
-  subreddit: "Where it was said",
-  title: "The post's title (on a comment: the post it answers)",
-  text: "Verbatim \u2014 quote this, exactly",
-  text_truncated: "The text was cut; re-run with --full before quoting the end of it",
-  author: "Reddit username, or null once the account is deleted",
-  score: "Points",
-  comment_count: "Posts only",
-  created: "Date written (UTC)",
-  permalink: "Cite THIS link \u2014 it is built from where the words actually are",
-  depth: "Thread comments: 0 answers the post, 1 answers a comment",
-  source: "reddit_api / reddit_web = live Reddit; archive = the Arctic Shift archive of Reddit"
-};
-registerSchema({
-  command: "research.reddit.search",
-  description: "Search Reddit posts or comments for the audience's own words. Returns verbatim text with a real permalink for each hit. Start here for voice-of-customer work on Reddit.",
-  args: {
-    query: {
-      type: "string",
-      description: "Words to match \u2014 the audience's phrasing, not a description of it",
-      required: true
-    },
-    subreddit: {
-      type: "string",
-      description: "Subreddits to search (up to 10): comma-separated (couriersofreddit,AmazonFlexUK) or the flag repeated. Needed for --kind comments",
-      required: false
-    },
-    kind: {
-      type: "string",
-      description: "posts (default) or comments \u2014 the replies are where most of the voice is",
-      required: false,
-      enum: ["posts", "comments"]
-    },
-    since: { type: "string", description: "Only things written on or after this day, YYYY-MM-DD", required: false },
-    limit: { type: "number", description: "Results to return (1-50, default 25)", required: false },
-    full: {
-      type: "boolean",
-      description: "Return every text whole instead of a preview",
-      required: false,
-      default: false
-    }
-  }
-});
-registerSchema({
-  command: "research.reddit.thread",
-  description: "Read one Reddit thread verbatim: the post and its best comments, each with its own permalink. Use it on any Reddit link before quoting it \u2014 it also exposes links that point somewhere other than they claim.",
-  args: {
-    target: {
-      type: "string",
-      description: "The thread's link (any Reddit form, including share links) or post id",
-      required: true
-    },
-    comments: { type: "number", description: "Comments to return, best first (0-200, default 40)", required: false },
-    full: {
-      type: "boolean",
-      description: "Return every text whole instead of a preview",
-      required: false,
-      default: false
-    }
-  }
-});
-registerSchema({
-  command: "research.reddit.subreddits",
-  description: "Find the subreddits where an audience talks about a topic, with member counts and whether they can be read. Run it before searching, instead of guessing subreddit names.",
-  args: {
-    query: { type: "string", description: 'The audience or topic, e.g. "amazon flex uk", "deliveroo"', required: true },
-    limit: { type: "number", description: "Subreddits to return (1-25, default 10)", required: false }
-  }
-});
-function searchReddit(body) {
-  return apiPost("/api/research/reddit/search", body, { timeoutMs: TIMEOUT_MS });
-}
-function findSubreddits(body) {
-  return apiPost("/api/research/reddit/subreddits", body, { timeoutMs: TIMEOUT_MS });
-}
-function row(item, full) {
-  const cut = !full && item.text.length > TEXT_PREVIEW_CHARS;
-  return {
-    kind: item.kind,
-    subreddit: item.subreddit,
-    title: item.title,
-    text: cut ? `${item.text.slice(0, TEXT_PREVIEW_CHARS)}\u2026` : item.text,
-    ...cut ? { text_truncated: true } : {},
-    author: item.author,
-    score: item.score,
-    ...item.kind === "post" ? { comment_count: item.commentCount } : {},
-    created: item.createdAt.slice(0, 10),
-    permalink: item.permalink,
-    ...item.depth !== null ? { depth: item.depth } : {}
-  };
-}
-function redditFix(code) {
-  if (code === "NOT_FOUND") return REDDIT_LINK_REJECTED;
-  if (code === "BAD_REQUEST" || code === "VALIDATION_ERROR") {
-    return { action: "retry_with_changes", explanation: "Follow the message above and run the command again." };
-  }
-  return {
-    action: "continue_without",
-    explanation: "Don't loop on it. Finish the job with the other sources, say plainly that Reddit is a gap in this research, and never stand in a summary's paraphrase for a Reddit quote."
-  };
-}
-function failValidation(message) {
-  writeResearchJson({ ok: false, error: { code: "VALIDATION_ERROR", message, fix: redditFix("VALIDATION_ERROR") } });
-  process.exit(1);
-}
-function subredditsFromArgs(rawArgs, parsed) {
-  return repeatedValues(rawArgs, "subreddit", parsed).flatMap((value) => value.split(",")).map((name) => name.trim()).filter(Boolean);
-}
-var searchCommand = defineCommand({
-  meta: {
-    name: "search",
-    description: `Search Reddit for the audience's own words, verbatim, each with a permalink you can cite.
-
-Start here for Reddit voice-of-customer. Matches words, not meaning \u2014 search the way the audience writes, and quote a phrase to keep it together ('"right to work"').
-
-Examples:
-  baker research reddit search "agency never paid" --subreddit couriersofreddit,AmazonFlexUK
-  baker research reddit search '"right to work"' --subreddit UKJobs,AmazonFlexUK
-  baker research reddit search "visa" --subreddit UberEATS --kind comments --since 2025-01-01
-  baker research reddit search "side hustle student deliveries"`
-  },
-  args: {
-    query: { type: "positional", description: "Words to match", required: false },
-    subreddit: {
-      type: "string",
-      description: "Subreddits (up to 10): comma-separated, or repeat the flag",
-      required: false
-    },
-    kind: { type: "string", description: "posts (default) or comments", required: false },
-    since: { type: "string", description: "YYYY-MM-DD", required: false },
-    limit: { type: "string", description: "1-50, default 25", required: false },
-    full: { type: "boolean", description: "Whole texts, not previews", required: false }
-  },
-  run: async ({ args, rawArgs }) => {
-    const query = args.query?.trim();
-    if (!query) failValidation('Say what to search for: baker research reddit search "<words>"');
-    const kind = args.kind ?? "posts";
-    if (kind !== "posts" && kind !== "comments") failValidation("--kind must be posts or comments");
-    const body = {
-      query,
-      kind,
-      subreddits: subredditsFromArgs(rawArgs, args.subreddit)
-    };
-    if (args.since) body.since = args.since;
-    if (args.limit) body.limit = Number(args.limit);
-    try {
-      const data = await searchReddit(body);
-      writeResearchJson({
-        ok: true,
-        data: data.results.map((item) => row(item, Boolean(args.full))),
-        source: data.source,
-        fields: ITEM_FIELDS,
-        hints: redditSearchHints({ resultCount: data.results.length, kind, source: data.source })
-      });
-    } catch (err) {
-      handleResearchError(err, redditFix);
-    }
-  }
-});
-var threadCommand = defineCommand({
-  meta: {
-    name: "thread",
-    description: `Read one Reddit thread verbatim \u2014 the post and its best comments, each with its own permalink.
-
-Run it on every Reddit link before you quote from it, including links a research summary gave you: it refuses a link whose post is somewhere other than the link claims.
-
-Examples:
-  baker research reddit thread "https://www.reddit.com/r/AmazonFlexUK/comments/1abc2de/agency_still_hasnt_paid_me/"
-  baker research reddit thread "https://www.reddit.com/r/UberEATS/s/3TzXiyxaMD" --comments 100
-  baker research reddit thread 1abc2de --full`
-  },
-  args: {
-    target: { type: "positional", description: "Thread link or post id", required: false },
-    comments: { type: "string", description: "0-200, default 40", required: false },
-    full: { type: "boolean", description: "Whole texts, not previews", required: false }
-  },
-  run: async ({ args }) => {
-    const target = args.target?.trim();
-    if (!target) failValidation("Pass the thread's link or post id: baker research reddit thread <url>");
-    const commentsAsked = args.comments ? Number(args.comments) : RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS;
-    const body = { target, comments: commentsAsked };
-    try {
-      const data = await apiPost("/api/research/reddit/thread", body, {
-        timeoutMs: TIMEOUT_MS
-      });
-      const full = Boolean(args.full);
-      writeResearchJson({
-        ok: true,
-        data: { post: row(data.post, full), comments: data.comments.map((item) => row(item, full)) },
-        source: data.source,
-        fields: ITEM_FIELDS,
-        hints: redditThreadHints({
-          commentsShown: data.comments.length,
-          commentsAsked,
-          commentCount: data.post.commentCount,
-          source: data.source
-        })
-      });
-    } catch (err) {
-      handleResearchError(err, redditFix);
-    }
-  }
-});
-var subredditsCommand = defineCommand({
-  meta: {
-    name: "subreddits",
-    description: `Find the subreddits where an audience talks \u2014 name, members, and whether it can be read.
-
-Run it before \`reddit search\` instead of guessing names: a plausible-sounding subreddit can be dead (r/CouriersUK has one post), while the conversation sits in r/AmazonFlexUK or r/deliveroos.
-
-Examples:
-  baker research reddit subreddits "amazon flex uk"
-  baker research reddit subreddits "deliveroo" --limit 5`
-  },
-  args: {
-    query: { type: "positional", description: "Audience or topic", required: false },
-    limit: { type: "string", description: "1-25, default 10", required: false }
-  },
-  run: async ({ args }) => {
-    const query = args.query?.trim();
-    if (!query) failValidation('Say what to look for: baker research reddit subreddits "<audience or topic>"');
-    const body = { query };
-    if (args.limit) body.limit = Number(args.limit);
-    try {
-      const data = await findSubreddits(body);
-      writeResearchJson({
-        ok: true,
-        data: data.results,
-        source: data.source,
-        fields: {
-          name: "Pass this to --subreddit",
-          subscribers: "Members \u2014 size, not activity",
-          access: "public / restricted (readable, members post) / private (unreadable) / null when the source doesn't say",
-          description: "The subreddit's own summary",
-          url: "The subreddit"
-        },
-        hints: redditSubredditsHints({ resultCount: data.results.length })
-      });
-    } catch (err) {
-      handleResearchError(err, redditFix);
-    }
-  }
-});
-var redditCommand = defineCommand({
-  meta: {
-    name: "reddit",
-    description: `Read Reddit verbatim \u2014 the one site no page reader will open for us.
-
-Commands:
-  subreddits \u2014 Find where the audience talks (start here)
-  search     \u2014 Find posts or comments in the audience's own words
-  thread     \u2014 Read one thread: the post and its best comments
-
-Examples:
-  baker research reddit subreddits "amazon flex uk"
-  baker research reddit search "agency never paid" --subreddit couriersofreddit,AmazonFlexUK --kind comments
-  baker research reddit thread "https://www.reddit.com/r/AmazonFlexUK/comments/1abc2de/"
-Full guide: __tooling__/docs/tools/baker/research.md`
-  },
-  subCommands: { subreddits: subredditsCommand, search: searchCommand, thread: threadCommand }
-});
-
-export {
-  searchReddit,
-  findSubreddits,
-  subredditsFromArgs,
-  redditCommand
-};
-//# sourceMappingURL=chunk-S77PZVYM.js.map

package/dist/chunk-SHL7LOC3.js

@@ -1,51 +0,0 @@
-import {
-  failApi
-} from "./chunk-3HJLHTWP.js";
-import {
-  HUBSPOT_MISSING_GRANT_MARKER,
-  HUBSPOT_NOT_CONNECTED_MESSAGE
-} from "./chunk-XF4JUKVF.js";
-import {
-  ApiError
-} from "./chunk-XBOK23HI.js";
-import {
-  writeJson
-} from "./chunk-NU7JSWVA.js";
-
-// src/commands/hubspot/refusal.ts
-var CONTINUE = "Keep going with the wider task: say which part you could not read, skip it, and finish everything else. If the `request_connection` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Platforms \u2192 HubSpot.";
-function hubspotRefusal(code, message, reason = "so I can count a contact becoming a customer") {
-  if (code === "NOT_FOUND" && message.includes(HUBSPOT_NOT_CONNECTED_MESSAGE)) {
-    return {
-      code: "NO_HUBSPOT_CONNECTION",
-      fix: {
-        action: "request_connection",
-        explanation: `AGENT INSTRUCTION: HubSpot is not connected, and only the user can connect it. Call the \`request_connection\` tool with { platform: "hubspot", reason } \u2014 reason in their words, e.g. "${reason}" \u2014 and they connect it inside the chat; then run this command again. ` + CONTINUE
-      }
-    };
-  }
-  if (code === "FORBIDDEN" && message.includes(HUBSPOT_MISSING_GRANT_MARKER)) {
-    return {
-      code: "HUBSPOT_RECONNECT_REQUIRED",
-      fix: {
-        action: "request_connection",
-        explanation: 'AGENT INSTRUCTION: HubSpot is connected \u2014 do not tell the user it is missing, and do not retry. Its access does not cover this read (it was connected before Baker asked for it, or the access was withdrawn), and only the user can widen it. Call the `request_connection` tool with { platform: "hubspot", reason } naming what you need to read; the card offers them a Reconnect button. Run this command again once they have. ' + CONTINUE
-      }
-    };
-  }
-  return null;
-}
-function failNotConnected(err, reason) {
-  const refusal = err instanceof ApiError ? hubspotRefusal(err.code, err.message, reason) : null;
-  if (err instanceof ApiError && refusal !== null) {
-    writeJson({ ok: false, error: { code: refusal.code, message: err.message, fix: refusal.fix } });
-    process.exit(1);
-  }
-  failApi(err);
-}
-
-export {
-  hubspotRefusal,
-  failNotConnected
-};
-//# sourceMappingURL=chunk-SHL7LOC3.js.map