@koda-sl/baker-cli 0.386.0 → 0.387.0-dev.3bafd569e

package/dist/chunk-LERWCRY5.js

@@ -0,0 +1,297 @@
+import {
+  REDDIT_LINK_REJECTED,
+  redditSearchHints,
+  redditSubredditsHints,
+  redditThreadHints
+} from "./chunk-H7XVKLIY.js";
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-Y362QH54.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS
+} from "./chunk-SMIENBNX.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.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-LERWCRY5.js.map

package/dist/chunk-LERWCRY5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/reddit.ts"],"sourcesContent":["import {\n  RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS,\n  type ResearchRedditItem,\n  type ResearchRedditSearchRequest,\n  type ResearchRedditSearchResponse,\n  type ResearchRedditSubredditsRequest,\n  type ResearchRedditSubredditsResponse,\n  type ResearchRedditThreadRequest,\n  type ResearchRedditThreadResponse,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { repeatedValues } from \"../../lib/repeatedFlags.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { REDDIT_LINK_REJECTED, redditSearchHints, redditSubredditsHints, redditThreadHints } from \"./hints.ts\";\nimport { handleResearchError, type ResearchFix, writeResearchJson } from \"./output.ts\";\n\n/**\n * Up to three sources may be asked in turn, and the archive waits out its own\n * rate limit before giving up — so a read can legitimately take a minute.\n */\nconst TIMEOUT_MS = 180_000;\n\n/** Long enough for almost every comment; a longer one says it was cut, so a partial quote is never mistaken for a whole one. */\nconst TEXT_PREVIEW_CHARS = 1_500;\n\nconst ITEM_FIELDS: Record<string, string> = {\n  kind: \"post or comment\",\n  subreddit: \"Where it was said\",\n  title: \"The post's title (on a comment: the post it answers)\",\n  text: \"Verbatim — quote this, exactly\",\n  text_truncated: \"The text was cut; re-run with --full before quoting the end of it\",\n  author: \"Reddit username, or null once the account is deleted\",\n  score: \"Points\",\n  comment_count: \"Posts only\",\n  created: \"Date written (UTC)\",\n  permalink: \"Cite THIS link — it is built from where the words actually are\",\n  depth: \"Thread comments: 0 answers the post, 1 answers a comment\",\n  source: \"reddit_api / reddit_web = live Reddit; archive = the Arctic Shift archive of Reddit\",\n};\n\nregisterSchema({\n  command: \"research.reddit.search\",\n  description:\n    \"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.\",\n  args: {\n    query: {\n      type: \"string\",\n      description: \"Words to match — the audience's phrasing, not a description of it\",\n      required: true,\n    },\n    subreddit: {\n      type: \"string\",\n      description:\n        \"Subreddits to search (up to 10): comma-separated (couriersofreddit,AmazonFlexUK) or the flag repeated. Needed for --kind comments\",\n      required: false,\n    },\n    kind: {\n      type: \"string\",\n      description: \"posts (default) or comments — the replies are where most of the voice is\",\n      required: false,\n      enum: [\"posts\", \"comments\"],\n    },\n    since: { type: \"string\", description: \"Only things written on or after this day, YYYY-MM-DD\", required: false },\n    limit: { type: \"number\", description: \"Results to return (1-50, default 25)\", required: false },\n    full: {\n      type: \"boolean\",\n      description: \"Return every text whole instead of a preview\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nregisterSchema({\n  command: \"research.reddit.thread\",\n  description:\n    \"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 — it also exposes links that point somewhere other than they claim.\",\n  args: {\n    target: {\n      type: \"string\",\n      description: \"The thread's link (any Reddit form, including share links) or post id\",\n      required: true,\n    },\n    comments: { type: \"number\", description: \"Comments to return, best first (0-200, default 40)\", required: false },\n    full: {\n      type: \"boolean\",\n      description: \"Return every text whole instead of a preview\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nregisterSchema({\n  command: \"research.reddit.subreddits\",\n  description:\n    \"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.\",\n  args: {\n    query: { type: \"string\", description: 'The audience or topic, e.g. \"amazon flex uk\", \"deliveroo\"', required: true },\n    limit: { type: \"number\", description: \"Subreddits to return (1-25, default 10)\", required: false },\n  },\n});\n\n/** One Reddit search, as `reddit search` and `research customers` both ask it. */\nexport function searchReddit(body: ResearchRedditSearchRequest): Promise<ResearchRedditSearchResponse> {\n  return apiPost<ResearchRedditSearchResponse>(\"/api/research/reddit/search\", body, { timeoutMs: TIMEOUT_MS });\n}\n\n/** Where an audience talks, as `reddit subreddits` and `research customers` both ask it. */\nexport function findSubreddits(body: ResearchRedditSubredditsRequest): Promise<ResearchRedditSubredditsResponse> {\n  return apiPost<ResearchRedditSubredditsResponse>(\"/api/research/reddit/subreddits\", body, { timeoutMs: TIMEOUT_MS });\n}\n\nfunction row(item: ResearchRedditItem, full: boolean) {\n  const cut = !full && item.text.length > TEXT_PREVIEW_CHARS;\n  return {\n    kind: item.kind,\n    subreddit: item.subreddit,\n    title: item.title,\n    text: cut ? `${item.text.slice(0, TEXT_PREVIEW_CHARS)}…` : item.text,\n    ...(cut ? { text_truncated: true } : {}),\n    author: item.author,\n    score: item.score,\n    ...(item.kind === \"post\" ? { comment_count: item.commentCount } : {}),\n    created: item.createdAt.slice(0, 10),\n    permalink: item.permalink,\n    ...(item.depth !== null ? { depth: item.depth } : {}),\n  };\n}\n\n/**\n * The failures split three ways, and the split is the whole point: a link that\n * leads nowhere real must never be quoted, a question asked the wrong way should\n * be asked again, and a Reddit nobody will serve today is a named gap, not a\n * reason to stop the job.\n */\nfunction redditFix(code: string): ResearchFix {\n  if (code === \"NOT_FOUND\") return REDDIT_LINK_REJECTED;\n  if (code === \"BAD_REQUEST\" || code === \"VALIDATION_ERROR\") {\n    return { action: \"retry_with_changes\", explanation: \"Follow the message above and run the command again.\" };\n  }\n  return {\n    action: \"continue_without\",\n    explanation:\n      \"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.\",\n  };\n}\n\nfunction failValidation(message: string): never {\n  writeResearchJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message, fix: redditFix(\"VALIDATION_ERROR\") } });\n  process.exit(1);\n}\n\n/** `--subreddit a,b` and `--subreddit a --subreddit b` both name every subreddit given. */\nexport function subredditsFromArgs(rawArgs: readonly string[] | undefined, parsed: unknown): string[] {\n  return repeatedValues(rawArgs, \"subreddit\", parsed)\n    .flatMap((value) => value.split(\",\"))\n    .map((name) => name.trim())\n    .filter(Boolean);\n}\n\nconst searchCommand = defineCommand({\n  meta: {\n    name: \"search\",\n    description: `Search Reddit for the audience's own words, verbatim, each with a permalink you can cite.\n\nStart here for Reddit voice-of-customer. Matches words, not meaning — search the way the audience writes, and quote a phrase to keep it together ('\"right to work\"').\n\nExamples:\n  baker research reddit search \"agency never paid\" --subreddit couriersofreddit,AmazonFlexUK\n  baker research reddit search '\"right to work\"' --subreddit UKJobs,AmazonFlexUK\n  baker research reddit search \"visa\" --subreddit UberEATS --kind comments --since 2025-01-01\n  baker research reddit search \"side hustle student deliveries\"`,\n  },\n  args: {\n    query: { type: \"positional\", description: \"Words to match\", required: false },\n    subreddit: {\n      type: \"string\",\n      description: \"Subreddits (up to 10): comma-separated, or repeat the flag\",\n      required: false,\n    },\n    kind: { type: \"string\", description: \"posts (default) or comments\", required: false },\n    since: { type: \"string\", description: \"YYYY-MM-DD\", required: false },\n    limit: { type: \"string\", description: \"1-50, default 25\", required: false },\n    full: { type: \"boolean\", description: \"Whole texts, not previews\", required: false },\n  },\n  run: async ({ args, rawArgs }) => {\n    const query = (args.query as string | undefined)?.trim();\n    if (!query) failValidation('Say what to search for: baker research reddit search \"<words>\"');\n    const kind = (args.kind as string | undefined) ?? \"posts\";\n    if (kind !== \"posts\" && kind !== \"comments\") failValidation(\"--kind must be posts or comments\");\n\n    const body: ResearchRedditSearchRequest = {\n      query,\n      kind,\n      subreddits: subredditsFromArgs(rawArgs, args.subreddit),\n    };\n    if (args.since) body.since = args.since as string;\n    if (args.limit) body.limit = Number(args.limit);\n\n    try {\n      const data = await searchReddit(body);\n      writeResearchJson({\n        ok: true,\n        data: data.results.map((item) => row(item, Boolean(args.full))),\n        source: data.source,\n        fields: ITEM_FIELDS,\n        hints: redditSearchHints({ resultCount: data.results.length, kind, source: data.source }),\n      });\n    } catch (err) {\n      handleResearchError(err, redditFix);\n    }\n  },\n});\n\nconst threadCommand = defineCommand({\n  meta: {\n    name: \"thread\",\n    description: `Read one Reddit thread verbatim — the post and its best comments, each with its own permalink.\n\nRun 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.\n\nExamples:\n  baker research reddit thread \"https://www.reddit.com/r/AmazonFlexUK/comments/1abc2de/agency_still_hasnt_paid_me/\"\n  baker research reddit thread \"https://www.reddit.com/r/UberEATS/s/3TzXiyxaMD\" --comments 100\n  baker research reddit thread 1abc2de --full`,\n  },\n  args: {\n    target: { type: \"positional\", description: \"Thread link or post id\", required: false },\n    comments: { type: \"string\", description: \"0-200, default 40\", required: false },\n    full: { type: \"boolean\", description: \"Whole texts, not previews\", required: false },\n  },\n  run: async ({ args }) => {\n    const target = (args.target as string | undefined)?.trim();\n    if (!target) failValidation(\"Pass the thread's link or post id: baker research reddit thread <url>\");\n\n    const commentsAsked = args.comments ? Number(args.comments) : RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS;\n    const body: ResearchRedditThreadRequest = { target, comments: commentsAsked };\n\n    try {\n      const data = await apiPost<ResearchRedditThreadResponse>(\"/api/research/reddit/thread\", body, {\n        timeoutMs: TIMEOUT_MS,\n      });\n      const full = Boolean(args.full);\n      writeResearchJson({\n        ok: true,\n        data: { post: row(data.post, full), comments: data.comments.map((item) => row(item, full)) },\n        source: data.source,\n        fields: ITEM_FIELDS,\n        hints: redditThreadHints({\n          commentsShown: data.comments.length,\n          commentsAsked,\n          commentCount: data.post.commentCount,\n          source: data.source,\n        }),\n      });\n    } catch (err) {\n      handleResearchError(err, redditFix);\n    }\n  },\n});\n\nconst subredditsCommand = defineCommand({\n  meta: {\n    name: \"subreddits\",\n    description: `Find the subreddits where an audience talks — name, members, and whether it can be read.\n\nRun 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.\n\nExamples:\n  baker research reddit subreddits \"amazon flex uk\"\n  baker research reddit subreddits \"deliveroo\" --limit 5`,\n  },\n  args: {\n    query: { type: \"positional\", description: \"Audience or topic\", required: false },\n    limit: { type: \"string\", description: \"1-25, default 10\", required: false },\n  },\n  run: async ({ args }) => {\n    const query = (args.query as string | undefined)?.trim();\n    if (!query) failValidation('Say what to look for: baker research reddit subreddits \"<audience or topic>\"');\n    const body: ResearchRedditSubredditsRequest = { query };\n    if (args.limit) body.limit = Number(args.limit);\n\n    try {\n      const data = await findSubreddits(body);\n      writeResearchJson({\n        ok: true,\n        data: data.results,\n        source: data.source,\n        fields: {\n          name: \"Pass this to --subreddit\",\n          subscribers: \"Members — size, not activity\",\n          access:\n            \"public / restricted (readable, members post) / private (unreadable) / null when the source doesn't say\",\n          description: \"The subreddit's own summary\",\n          url: \"The subreddit\",\n        },\n        hints: redditSubredditsHints({ resultCount: data.results.length }),\n      });\n    } catch (err) {\n      handleResearchError(err, redditFix);\n    }\n  },\n});\n\nexport const redditCommand = defineCommand({\n  meta: {\n    name: \"reddit\",\n    description: `Read Reddit verbatim — the one site no page reader will open for us.\n\nCommands:\n  subreddits — Find where the audience talks (start here)\n  search     — Find posts or comments in the audience's own words\n  thread     — Read one thread: the post and its best comments\n\nExamples:\n  baker research reddit subreddits \"amazon flex uk\"\n  baker research reddit search \"agency never paid\" --subreddit couriersofreddit,AmazonFlexUK --kind comments\n  baker research reddit thread \"https://www.reddit.com/r/AmazonFlexUK/comments/1abc2de/\"\nFull guide: __tooling__/docs/tools/baker/research.md`,\n  },\n  subCommands: { subreddits: subredditsCommand, search: searchCommand, thread: threadCommand },\n});\n"],"mappings":"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","names":[]}

package/dist/chunk-M6UNISGO.js

@@ -0,0 +1,66 @@
+// src/commands/ads/x/error-parser.ts
+function mapXErrorCode(message) {
+  if (/UNAUTHORIZED_ACCESS|authentication/i.test(message)) return "AUTH_ERROR";
+  if (/UNAUTHORIZED_CLIENT_APPLICATION/i.test(message)) return "PERMISSION_DENIED";
+  if (/ACCOUNT_NOT_FOUND|NOT_FOUND/i.test(message)) return "ACCOUNT_NOT_FOUND";
+  if (/CAMPAIGN_NOT_FOUND/i.test(message)) return "CAMPAIGN_NOT_FOUND";
+  if (/LINE_ITEM_NOT_FOUND/i.test(message)) return "LINE_ITEM_NOT_FOUND";
+  if (/MEDIA_NOT_FOUND|TWEET_NOT_FOUND|TAILORED_AUDIENCE_NOT_FOUND/i.test(message)) return "RESOURCE_NOT_FOUND";
+  if (/TOO_MANY_REQUESTS|TWEET_RATE_LIMIT_EXCEEDED|rate.*limit/i.test(message)) return "QUOTA_EXCEEDED";
+  if (/SPEND_EXCEEDS_BUDGET/i.test(message)) return "BUDGET_EXCEEDED";
+  if (/INVALID_PARAMETER|MISSING_PARAMETER|EXCLUSIVE_PARAMETERS|INCLUSIVE_PARAMETERS/i.test(message))
+    return "INVALID_PARAMETER";
+  if (/SERVICE_UNAVAILABLE|OVER_CAPACITY|INTERNAL_ERROR/i.test(message)) return "SERVICE_UNAVAILABLE";
+  if (/CANCELLED_REQUEST|timeout|DEADLINE_EXCEEDED/i.test(message)) return "TIMEOUT";
+  return "API_ERROR";
+}
+function isRetryable(code) {
+  return code === "QUOTA_EXCEEDED" || code === "TIMEOUT" || code === "SERVICE_UNAVAILABLE";
+}
+function getRetryDelay(code) {
+  if (code === "QUOTA_EXCEEDED") return 6e4;
+  if (code === "SERVICE_UNAVAILABLE") return 15e3;
+  if (code === "TIMEOUT") return 5e3;
+  return void 0;
+}
+function parseXApiError(errorMessage, accountId) {
+  const code = mapXErrorCode(errorMessage);
+  return {
+    ok: false,
+    error: {
+      code,
+      message: errorMessage,
+      fix: {
+        action: code === "AUTH_ERROR" ? "authenticate" : code === "PERMISSION_DENIED" ? "authenticate" : isRetryable(code) ? "wait_and_retry" : "reject",
+        explanation: explainFix(code, accountId, errorMessage)
+      },
+      retryable: isRetryable(code),
+      retryAfterMs: getRetryDelay(code)
+    }
+  };
+}
+function explainFix(code, accountId, message) {
+  switch (code) {
+    case "AUTH_ERROR":
+      return "Token rejected by X. Reconnect the X Ads provider in Baker dashboard settings.";
+    case "PERMISSION_DENIED":
+      return "App not authorized for this resource. Verify Ads API access at ads.x.com/help and reconnect the provider.";
+    case "ACCOUNT_NOT_FOUND":
+      return `Account ${accountId} not accessible. Run 'baker ads x accounts' to list visible accounts.`;
+    case "QUOTA_EXCEEDED":
+      return "X Ads rate limit exceeded. Wait until the x-rate-limit-reset window passes and retry.";
+    case "INVALID_PARAMETER":
+      return `Invalid parameter sent to X Ads API: ${message}`;
+    case "BUDGET_EXCEEDED":
+      return "Spend exceeds available budget on the funding instrument.";
+    case "SERVICE_UNAVAILABLE":
+      return "X Ads API is temporarily unavailable. Retry after a short backoff.";
+    default:
+      return `Unrecognized X Ads error \u2014 verify request shape against X Ads API docs (${code}).`;
+  }
+}
+
+export {
+  parseXApiError
+};
+//# sourceMappingURL=chunk-M6UNISGO.js.map

package/dist/chunk-M6UNISGO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/error-parser.ts"],"sourcesContent":["import type { AdsErrorEnvelope } from \"../types.ts\";\n\nfunction mapXErrorCode(message: string): string {\n  if (/UNAUTHORIZED_ACCESS|authentication/i.test(message)) return \"AUTH_ERROR\";\n  if (/UNAUTHORIZED_CLIENT_APPLICATION/i.test(message)) return \"PERMISSION_DENIED\";\n  if (/ACCOUNT_NOT_FOUND|NOT_FOUND/i.test(message)) return \"ACCOUNT_NOT_FOUND\";\n  if (/CAMPAIGN_NOT_FOUND/i.test(message)) return \"CAMPAIGN_NOT_FOUND\";\n  if (/LINE_ITEM_NOT_FOUND/i.test(message)) return \"LINE_ITEM_NOT_FOUND\";\n  if (/MEDIA_NOT_FOUND|TWEET_NOT_FOUND|TAILORED_AUDIENCE_NOT_FOUND/i.test(message)) return \"RESOURCE_NOT_FOUND\";\n  if (/TOO_MANY_REQUESTS|TWEET_RATE_LIMIT_EXCEEDED|rate.*limit/i.test(message)) return \"QUOTA_EXCEEDED\";\n  if (/SPEND_EXCEEDS_BUDGET/i.test(message)) return \"BUDGET_EXCEEDED\";\n  if (/INVALID_PARAMETER|MISSING_PARAMETER|EXCLUSIVE_PARAMETERS|INCLUSIVE_PARAMETERS/i.test(message))\n    return \"INVALID_PARAMETER\";\n  if (/SERVICE_UNAVAILABLE|OVER_CAPACITY|INTERNAL_ERROR/i.test(message)) return \"SERVICE_UNAVAILABLE\";\n  if (/CANCELLED_REQUEST|timeout|DEADLINE_EXCEEDED/i.test(message)) return \"TIMEOUT\";\n  return \"API_ERROR\";\n}\n\nfunction isRetryable(code: string): boolean {\n  return code === \"QUOTA_EXCEEDED\" || code === \"TIMEOUT\" || code === \"SERVICE_UNAVAILABLE\";\n}\n\nfunction getRetryDelay(code: string): number | undefined {\n  if (code === \"QUOTA_EXCEEDED\") return 60_000;\n  if (code === \"SERVICE_UNAVAILABLE\") return 15_000;\n  if (code === \"TIMEOUT\") return 5_000;\n  return undefined;\n}\n\nexport function parseXApiError(errorMessage: string, accountId: string): AdsErrorEnvelope {\n  const code = mapXErrorCode(errorMessage);\n  return {\n    ok: false,\n    error: {\n      code,\n      message: errorMessage,\n      fix: {\n        action:\n          code === \"AUTH_ERROR\"\n            ? \"authenticate\"\n            : code === \"PERMISSION_DENIED\"\n              ? \"authenticate\"\n              : isRetryable(code)\n                ? \"wait_and_retry\"\n                : \"reject\",\n        explanation: explainFix(code, accountId, errorMessage),\n      },\n      retryable: isRetryable(code),\n      retryAfterMs: getRetryDelay(code),\n    },\n  };\n}\n\nfunction explainFix(code: string, accountId: string, message: string): string {\n  switch (code) {\n    case \"AUTH_ERROR\":\n      return \"Token rejected by X. Reconnect the X Ads provider in Baker dashboard settings.\";\n    case \"PERMISSION_DENIED\":\n      return \"App not authorized for this resource. Verify Ads API access at ads.x.com/help and reconnect the provider.\";\n    case \"ACCOUNT_NOT_FOUND\":\n      return `Account ${accountId} not accessible. Run 'baker ads x accounts' to list visible accounts.`;\n    case \"QUOTA_EXCEEDED\":\n      return \"X Ads rate limit exceeded. Wait until the x-rate-limit-reset window passes and retry.\";\n    case \"INVALID_PARAMETER\":\n      return `Invalid parameter sent to X Ads API: ${message}`;\n    case \"BUDGET_EXCEEDED\":\n      return \"Spend exceeds available budget on the funding instrument.\";\n    case \"SERVICE_UNAVAILABLE\":\n      return \"X Ads API is temporarily unavailable. Retry after a short backoff.\";\n    default:\n      return `Unrecognized X Ads error — verify request shape against X Ads API docs (${code}).`;\n  }\n}\n"],"mappings":";AAEA,SAAS,cAAc,SAAyB;AAC9C,MAAI,sCAAsC,KAAK,OAAO,EAAG,QAAO;AAChE,MAAI,mCAAmC,KAAK,OAAO,EAAG,QAAO;AAC7D,MAAI,+BAA+B,KAAK,OAAO,EAAG,QAAO;AACzD,MAAI,sBAAsB,KAAK,OAAO,EAAG,QAAO;AAChD,MAAI,uBAAuB,KAAK,OAAO,EAAG,QAAO;AACjD,MAAI,+DAA+D,KAAK,OAAO,EAAG,QAAO;AACzF,MAAI,2DAA2D,KAAK,OAAO,EAAG,QAAO;AACrF,MAAI,wBAAwB,KAAK,OAAO,EAAG,QAAO;AAClD,MAAI,iFAAiF,KAAK,OAAO;AAC/F,WAAO;AACT,MAAI,oDAAoD,KAAK,OAAO,EAAG,QAAO;AAC9E,MAAI,+CAA+C,KAAK,OAAO,EAAG,QAAO;AACzE,SAAO;AACT;AAEA,SAAS,YAAY,MAAuB;AAC1C,SAAO,SAAS,oBAAoB,SAAS,aAAa,SAAS;AACrE;AAEA,SAAS,cAAc,MAAkC;AACvD,MAAI,SAAS,iBAAkB,QAAO;AACtC,MAAI,SAAS,sBAAuB,QAAO;AAC3C,MAAI,SAAS,UAAW,QAAO;AAC/B,SAAO;AACT;AAEO,SAAS,eAAe,cAAsB,WAAqC;AACxF,QAAM,OAAO,cAAc,YAAY;AACvC,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL;AAAA,MACA,SAAS;AAAA,MACT,KAAK;AAAA,QACH,QACE,SAAS,eACL,iBACA,SAAS,sBACP,iBACA,YAAY,IAAI,IACd,mBACA;AAAA,QACV,aAAa,WAAW,MAAM,WAAW,YAAY;AAAA,MACvD;AAAA,MACA,WAAW,YAAY,IAAI;AAAA,MAC3B,cAAc,cAAc,IAAI;AAAA,IAClC;AAAA,EACF;AACF;AAEA,SAAS,WAAW,MAAc,WAAmB,SAAyB;AAC5E,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,WAAW,SAAS;AAAA,IAC7B,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,wCAAwC,OAAO;AAAA,IACxD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO,gFAA2E,IAAI;AAAA,EAC1F;AACF;","names":[]}

package/dist/chunk-MGKHFGLV.js

@@ -0,0 +1,75 @@
+import {
+  openRouterKey
+} from "./chunk-O6QKCJE4.js";
+
+// src/engine/nodes/local/lib/jev.ts
+import { z } from "zod";
+var JEV_MODEL = "typesafe/jev-1.13";
+var ENDPOINT = "https://openrouter.ai/api/v1/systemone";
+var TIMEOUT_MS = 2500;
+var Reply = z.object({
+  answers: z.record(z.string(), z.object({ noul: z.number() })),
+  usage: z.object({ cost: z.number() }).optional()
+});
+var Answer = z.union([
+  z.object({ choice: z.string(), probabilities: z.record(z.string(), z.number()), confidence: z.number() }),
+  z.object({ noul: z.number() })
+]);
+var AnswersReply = z.object({
+  answers: z.record(z.string(), z.unknown()),
+  usage: z.object({ cost: z.number() }).optional()
+});
+function readAnswers(body, ids) {
+  const parsed = AnswersReply.safeParse(body);
+  if (!parsed.success) return null;
+  const answers = [];
+  for (const id of ids) {
+    const answer = Answer.safeParse(parsed.data.answers[id]);
+    if (!answer.success) return null;
+    answers.push(
+      "choice" in answer.data ? { choice: answer.data.choice, probabilities: answer.data.probabilities, confidence: answer.data.confidence } : { noul: answer.data.noul }
+    );
+  }
+  return { answers, costUsd: parsed.data.usage?.cost ?? 0 };
+}
+async function askJevQuestions(questions, onSpend) {
+  const key = openRouterKey();
+  if (questions.length === 0) return [];
+  if (!key) return null;
+  const ids = questions.map((_, i) => `q${i}`);
+  try {
+    const response = await fetch(ENDPOINT, {
+      method: "POST",
+      headers: { authorization: `Bearer ${key}`, "content-type": "application/json" },
+      body: JSON.stringify({
+        model: JEV_MODEL,
+        state: {},
+        questions: Object.fromEntries(questions.map((q, i) => [ids[i], q]))
+      }),
+      signal: AbortSignal.timeout(TIMEOUT_MS)
+    });
+    if (!response.ok) return null;
+    const read = readAnswers(await response.json(), ids);
+    if (!read) return null;
+    onSpend?.({ model: JEV_MODEL, inputTokens: 0, outputTokens: 0, costUsd: read.costUsd });
+    return read.answers;
+  } catch {
+    return null;
+  }
+}
+async function askJev(questions, onSpend) {
+  const answers = await askJevQuestions(
+    questions.map((q) => ({ type: "noul", instructions: q.instructions })),
+    onSpend
+  );
+  if (!answers) return null;
+  const nouls = answers.flatMap((a) => "noul" in a ? [a.noul] : []);
+  return nouls.length === answers.length ? nouls : null;
+}
+
+export {
+  JEV_MODEL,
+  askJevQuestions,
+  askJev
+};
+//# sourceMappingURL=chunk-MGKHFGLV.js.map

package/dist/chunk-MGKHFGLV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engine/nodes/local/lib/jev.ts"],"sourcesContent":["/**\n * Jev, the decision model (TypeSafe's, served by OpenRouter at `/api/v1/systemone`): the CLI's\n * one boundary module for it. It reads text and answers typed questions with a probability;\n * it writes nothing. See docs/decision-model.md for when it is the right tool and the call shape.\n */\nimport { z } from \"zod\";\nimport { openRouterKey } from \"../../../../env.ts\";\nimport type { ReviewUsage } from \"./render-review.ts\";\n\n/** Pinned: the thresholds its callers act on were measured against this version. */\nexport const JEV_MODEL = \"typesafe/jev-1.13\";\nconst ENDPOINT = \"https://openrouter.ai/api/v1/systemone\";\n/** Several times its p50 (about 0.3 s): a decision that cannot come back this fast is the caller's fallback. */\nconst TIMEOUT_MS = 2_500;\n\nconst Reply = z.object({\n  answers: z.record(z.string(), z.object({ noul: z.number() })),\n  usage: z.object({ cost: z.number() }).optional(),\n});\n\n/** Each yes/no answer to `ids`, in order, and the call's cost; null when the reply does not answer them all. Pure. */\nexport function readNouls(body: unknown, ids: readonly string[]): { answers: number[]; costUsd: number } | null {\n  const parsed = Reply.safeParse(body);\n  if (!parsed.success) return null;\n  const answers = ids.map((id) => parsed.data.answers[id]?.noul);\n  if (answers.some((a) => a === undefined)) return null;\n  return { answers: answers as number[], costUsd: parsed.data.usage?.cost ?? 0 };\n}\n\n/** One question: a yes/no statement (Noul), or one option of `criteria`, keyed by option (Choice). */\nexport type JevQuestion =\n  | { type: \"noul\"; instructions: Record<string, string> }\n  | { type: \"choice\"; instructions: Record<string, string>; criteria: Record<string, string> };\n\n/** A Noul's probability of yes, or a Choice's pick with the probability of every option. */\nexport type JevAnswer =\n  | { noul: number }\n  | { choice: string; probabilities: Record<string, number>; confidence: number };\n\nconst Answer = z.union([\n  z.object({ choice: z.string(), probabilities: z.record(z.string(), z.number()), confidence: z.number() }),\n  z.object({ noul: z.number() }),\n]);\nconst AnswersReply = z.object({\n  answers: z.record(z.string(), z.unknown()),\n  usage: z.object({ cost: z.number() }).optional(),\n});\n\n/** Each answer to `ids`, in order, and the call's cost; null when the reply does not answer them all. Pure. */\nexport function readAnswers(body: unknown, ids: readonly string[]): { answers: JevAnswer[]; costUsd: number } | null {\n  const parsed = AnswersReply.safeParse(body);\n  if (!parsed.success) return null;\n  const answers: JevAnswer[] = [];\n  for (const id of ids) {\n    const answer = Answer.safeParse(parsed.data.answers[id]);\n    if (!answer.success) return null;\n    answers.push(\n      \"choice\" in answer.data\n        ? { choice: answer.data.choice, probabilities: answer.data.probabilities, confidence: answer.data.confidence }\n        : { noul: answer.data.noul },\n    );\n  }\n  return { answers, costUsd: parsed.data.usage?.cost ?? 0 };\n}\n\n/**\n * Every answer, in order (one request, whatever the mix of Nouls and Choices), or null when Jev\n * could not answer: no key, a timeout, an outage. There is no route to fall back to, so the\n * caller decides what null means.\n */\nexport async function askJevQuestions(\n  questions: readonly JevQuestion[],\n  onSpend?: (usage: ReviewUsage) => void,\n): Promise<JevAnswer[] | null> {\n  const key = openRouterKey();\n  if (questions.length === 0) return [];\n  if (!key) return null;\n  const ids = questions.map((_, i) => `q${i}`);\n  try {\n    const response = await fetch(ENDPOINT, {\n      method: \"POST\",\n      headers: { authorization: `Bearer ${key}`, \"content-type\": \"application/json\" },\n      body: JSON.stringify({\n        model: JEV_MODEL,\n        state: {},\n        questions: Object.fromEntries(questions.map((q, i) => [ids[i], q])),\n      }),\n      signal: AbortSignal.timeout(TIMEOUT_MS),\n    });\n    if (!response.ok) return null;\n    const read = readAnswers(await response.json(), ids);\n    if (!read) return null;\n    onSpend?.({ model: JEV_MODEL, inputTokens: 0, outputTokens: 0, costUsd: read.costUsd });\n    return read.answers;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * The probability that each statement is true, in order (a Noul each, one request), or null when\n * Jev could not answer: no key, a timeout, an outage. There is no route to fall back to, so the\n * caller decides what null means.\n */\nexport async function askJev(\n  questions: ReadonlyArray<{ instructions: Record<string, string> }>,\n  onSpend?: (usage: ReviewUsage) => void,\n): Promise<number[] | null> {\n  const answers = await askJevQuestions(\n    questions.map((q) => ({ type: \"noul\", instructions: q.instructions })),\n    onSpend,\n  );\n  if (!answers) return null;\n  const nouls = answers.flatMap((a) => (\"noul\" in a ? [a.noul] : []));\n  return nouls.length === answers.length ? nouls : null;\n}\n"],"mappings":"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","names":[]}