@koda-sl/baker-cli 0.461.0 → 0.462.0

package/dist/feed-YE337QRB.js

@@ -0,0 +1,177 @@
+import {
+  adFieldPlan,
+  adRows
+} from "./chunk-JQMYDSNZ.js";
+import {
+  reportError,
+  splitList
+} from "./chunk-POSV2BIJ.js";
+import {
+  apiGet
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  registerSchema,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/feed.ts
+import { defineCommand } from "citty";
+function buildFeedParams(input) {
+  const params = {};
+  const advertiser = splitList(input.advertiser);
+  if (advertiser.length > 0) {
+    params.advertiser = advertiser.join(",");
+  }
+  if (input.platform) {
+    params.platform = input.platform;
+  }
+  if (input.perAdvertiser !== void 0 && input.perAdvertiser !== "") {
+    params.per_advertiser = input.perAdvertiser;
+  }
+  if (input.limit !== void 0 && input.limit !== "") {
+    params.limit = input.limit;
+  }
+  const winnerCategory = splitList(input.winnerCategory);
+  if (winnerCategory.length > 0) {
+    params.winner_category = winnerCategory.join(",");
+  }
+  const format = splitList(input.format);
+  if (format.length > 0) {
+    params.format = format.join(",");
+  }
+  if (input.allKinds) {
+    params.all_kinds = "1";
+  }
+  return params;
+}
+registerSchema({
+  command: "winning-ads.feed",
+  description: "Winners across EVERY brand you follow, in one library. Start here to review your followed advertisers, then trim to specific ones with --advertiser. Capped per advertiser so no single brand floods the feed. Lean winner cards; add --full for DNA + longevity.",
+  args: {
+    advertiser: {
+      type: "string",
+      description: "Comma-separated followed advertiser ids to narrow to (from `following`). Omit for all follows.",
+      required: false
+    },
+    platform: {
+      type: "string",
+      description: "Filter to a single platform: meta|linkedin|tiktok|google",
+      required: false
+    },
+    "per-advertiser": {
+      type: "number",
+      description: "Spread per advertiser by default: each brand's best 3 first, the rest after, none dropped. Set 1-50 to keep at most N per brand, 0 for rank order",
+      required: false
+    },
+    limit: {
+      type: "number",
+      description: "Total winners across all follows 1-200 (default 40)",
+      required: false,
+      default: 40
+    },
+    "winner-category": { type: "string", description: "Comma-separated winner categories to include", required: false },
+    format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false },
+    "all-kinds": {
+      type: "boolean",
+      description: "Also return Google search text, Shopping and app ads. By default the feed shows designed pictures and videos only; --format text shows search ads alone.",
+      required: false,
+      default: false
+    }
+  }
+});
+var feedCommand = defineCommand({
+  meta: {
+    name: "feed",
+    description: "Winners across every brand you follow, each brand's best first. Example: baker winning-ads feed --output md"
+  },
+  args: {
+    advertiser: {
+      type: "string",
+      description: "Comma-separated followed advertiser ids to narrow to",
+      required: false
+    },
+    platform: {
+      type: "string",
+      description: "Filter to a single platform: meta|linkedin|tiktok|google",
+      required: false
+    },
+    "per-advertiser": {
+      type: "string",
+      description: "Spread per advertiser by default: each brand's best 3 first, the rest after, none dropped. Set 1-50 to keep at most N per brand, 0 for rank order",
+      required: false
+    },
+    limit: { type: "string", description: "Total winners 1-200 (default 40)", required: false },
+    "winner-category": { type: "string", description: "Comma-separated winner categories", required: false },
+    format: { type: "string", description: "Comma-separated formats", required: false },
+    "all-kinds": {
+      type: "boolean",
+      description: "Also return Google search text, Shopping and app ads (default: designed pictures and videos only)",
+      required: false,
+      default: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: {
+      type: "boolean",
+      description: "Include DNA detail (angle, persona, hook) + longevity",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = buildFeedParams({
+        advertiser: args.advertiser,
+        platform: args.platform,
+        perAdvertiser: args["per-advertiser"],
+        limit: args.limit,
+        winnerCategory: args["winner-category"],
+        format: args.format,
+        allKinds: args["all-kinds"]
+      });
+      const data = await apiGet("/api/ad-library/feed", params);
+      const output = args.output || "json";
+      const plan = adFieldPlan(args.fields, args.full);
+      const rawWinners = Array.isArray(data?.winners) ? data.winners : [];
+      const hints = [];
+      if ((data?.following_count ?? 0) === 0) {
+        hints.push('You don\'t follow any brands yet. Run `baker winning-ads follow "<domain>"` first.');
+      }
+      if (Array.isArray(data?.unknown_requested) && data.unknown_requested.length > 0) {
+        hints.push(
+          `Not in your follows (skipped): ${data.unknown_requested.join(", ")}. Check ids with \`baker winning-ads following\`.`
+        );
+      }
+      if (output === "json") {
+        const winners = adRows(rawWinners, plan);
+        writeJson({
+          ok: true,
+          data: {
+            winners,
+            following_count: data?.following_count ?? 0,
+            advertiser_ids: Array.isArray(data?.advertiser_ids) ? data.advertiser_ids : [],
+            ...hints.length > 0 ? { hints } : {}
+          }
+        });
+        return;
+      }
+      writeOutput({ ok: true, data: rawWinners }, output, plan.fields, plan.full, winningAdNormalizer);
+      for (const hint of hints) {
+        process.stderr.write(`${hint}
+`);
+      }
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  buildFeedParams,
+  feedCommand
+};
+//# sourceMappingURL=feed-YE337QRB.js.map

package/dist/feed-YE337QRB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/feed.ts"],"sourcesContent":["import type { FeedResponse } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../client.ts\";\nimport { type OutputFormat, winningAdNormalizer, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { adFieldPlan, adRows } from \"./adRows.ts\";\nimport { reportError, splitList } from \"./shared.ts\";\n\n/** Assemble the `/api/ad-library/feed` query params from CLI flags. Pure so the\n *  csv-splitting / numeric passthrough is unit-testable without the transport. */\nexport function buildFeedParams(input: {\n  advertiser?: string;\n  platform?: string;\n  perAdvertiser?: string;\n  limit?: string;\n  winnerCategory?: string;\n  format?: string;\n  allKinds?: boolean;\n}): Record<string, string> {\n  const params: Record<string, string> = {};\n  const advertiser = splitList(input.advertiser);\n  if (advertiser.length > 0) {\n    params.advertiser = advertiser.join(\",\");\n  }\n  if (input.platform) {\n    params.platform = input.platform;\n  }\n  if (input.perAdvertiser !== undefined && input.perAdvertiser !== \"\") {\n    params.per_advertiser = input.perAdvertiser;\n  }\n  if (input.limit !== undefined && input.limit !== \"\") {\n    params.limit = input.limit;\n  }\n  const winnerCategory = splitList(input.winnerCategory);\n  if (winnerCategory.length > 0) {\n    params.winner_category = winnerCategory.join(\",\");\n  }\n  const format = splitList(input.format);\n  if (format.length > 0) {\n    params.format = format.join(\",\");\n  }\n  if (input.allKinds) {\n    params.all_kinds = \"1\";\n  }\n  return params;\n}\n\nregisterSchema({\n  command: \"winning-ads.feed\",\n  description:\n    \"Winners across EVERY brand you follow, in one library. Start here to review your followed advertisers, then trim to specific ones with --advertiser. Capped per advertiser so no single brand floods the feed. Lean winner cards; add --full for DNA + longevity.\",\n  args: {\n    advertiser: {\n      type: \"string\",\n      description: \"Comma-separated followed advertiser ids to narrow to (from `following`). Omit for all follows.\",\n      required: false,\n    },\n    platform: {\n      type: \"string\",\n      description: \"Filter to a single platform: meta|linkedin|tiktok|google\",\n      required: false,\n    },\n    \"per-advertiser\": {\n      type: \"number\",\n      description:\n        \"Spread per advertiser by default: each brand's best 3 first, the rest after, none dropped. Set 1-50 to keep at most N per brand, 0 for rank order\",\n      required: false,\n    },\n    limit: {\n      type: \"number\",\n      description: \"Total winners across all follows 1-200 (default 40)\",\n      required: false,\n      default: 40,\n    },\n    \"winner-category\": { type: \"string\", description: \"Comma-separated winner categories to include\", required: false },\n    format: { type: \"string\", description: \"Comma-separated formats to include (e.g. static,video)\", required: false },\n    \"all-kinds\": {\n      type: \"boolean\",\n      description:\n        \"Also return Google search text, Shopping and app ads. By default the feed shows designed pictures and videos only; --format text shows search ads alone.\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nexport const feedCommand = defineCommand({\n  meta: {\n    name: \"feed\",\n    description:\n      \"Winners across every brand you follow, each brand's best first. Example: baker winning-ads feed --output md\",\n  },\n  args: {\n    advertiser: {\n      type: \"string\",\n      description: \"Comma-separated followed advertiser ids to narrow to\",\n      required: false,\n    },\n    platform: {\n      type: \"string\",\n      description: \"Filter to a single platform: meta|linkedin|tiktok|google\",\n      required: false,\n    },\n    \"per-advertiser\": {\n      type: \"string\",\n      description:\n        \"Spread per advertiser by default: each brand's best 3 first, the rest after, none dropped. Set 1-50 to keep at most N per brand, 0 for rank order\",\n      required: false,\n    },\n    limit: { type: \"string\", description: \"Total winners 1-200 (default 40)\", required: false },\n    \"winner-category\": { type: \"string\", description: \"Comma-separated winner categories\", required: false },\n    format: { type: \"string\", description: \"Comma-separated formats\", required: false },\n    \"all-kinds\": {\n      type: \"boolean\",\n      description: \"Also return Google search text, Shopping and app ads (default: designed pictures and videos only)\",\n      required: false,\n      default: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: {\n      type: \"boolean\",\n      description: \"Include DNA detail (angle, persona, hook) + longevity\",\n      required: false,\n      default: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const params = buildFeedParams({\n        advertiser: args.advertiser as string | undefined,\n        platform: args.platform as string | undefined,\n        perAdvertiser: args[\"per-advertiser\"] as string | undefined,\n        limit: args.limit as string | undefined,\n        winnerCategory: args[\"winner-category\"] as string | undefined,\n        format: args.format as string | undefined,\n        allKinds: args[\"all-kinds\"] as boolean,\n      });\n\n      const data = await apiGet<FeedResponse>(\"/api/ad-library/feed\", params);\n      const output = (args.output as OutputFormat) || \"json\";\n      const plan = adFieldPlan(args.fields, args.full);\n      const rawWinners = Array.isArray(data?.winners) ? data.winners : [];\n\n      const hints: string[] = [];\n      if ((data?.following_count ?? 0) === 0) {\n        hints.push('You don\\'t follow any brands yet. Run `baker winning-ads follow \"<domain>\"` first.');\n      }\n      if (Array.isArray(data?.unknown_requested) && data.unknown_requested.length > 0) {\n        hints.push(\n          `Not in your follows (skipped): ${data.unknown_requested.join(\", \")}. Check ids with \\`baker winning-ads following\\`.`,\n        );\n      }\n\n      if (output === \"json\") {\n        const winners = adRows(rawWinners, plan);\n        writeJson({\n          ok: true,\n          data: {\n            winners,\n            following_count: data?.following_count ?? 0,\n            advertiser_ids: Array.isArray(data?.advertiser_ids) ? data.advertiser_ids : [],\n            ...(hints.length > 0 ? { hints } : {}),\n          },\n        });\n        return;\n      }\n      writeOutput({ ok: true, data: rawWinners }, output, plan.fields, plan.full, winningAdNormalizer);\n      // md/files render only the table, so surface the steering hints (empty\n      // follows, skipped ids) on stderr — otherwise the primary `--output md`\n      // path shows a silent empty table with no explanation.\n      for (const hint of hints) {\n        process.stderr.write(`${hint}\\n`);\n      }\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/feedback-UWHZFFY5.js

@@ -0,0 +1,66 @@
+import {
+  ApiError,
+  apiPost
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/feedback.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = "Read what this company's reviewers said about creative versions: recent approved / rejected verdicts with reasons and notes, the top rejection reasons, what approved versions share (format, platform, option), and hints[] saying what to do differently. Start here before making or changing a creative: baker creatives feedback; then baker creatives feedback --slug <slug> for one creative's history. When the user reacts to a version in the chat, record it with baker creatives feedback record.";
+var SLUG_DESCRIPTION = "One creative's feedback (src/creatives/<slug>/). Left out, the whole company's.";
+var FULL_DESCRIPTION = "Every verdict as stored (up to 200), notes whole. Default is a summary plus the 8 latest.";
+registerSchema({
+  command: "creatives.feedback",
+  description: DESCRIPTION,
+  args: {
+    slug: { type: "string", description: SLUG_DESCRIPTION, required: false },
+    full: { type: "boolean", description: FULL_DESCRIPTION, required: false }
+  }
+});
+var readArgs = {
+  slug: { type: "string", description: SLUG_DESCRIPTION, required: false },
+  full: { type: "boolean", description: FULL_DESCRIPTION, required: false, default: false }
+};
+var feedbackReadCommand = defineCommand({
+  meta: { name: "read", description: `${DESCRIPTION} Runs by default when no subcommand is given.` },
+  args: readArgs,
+  run: async ({ args }) => {
+    try {
+      const body = {
+        ...typeof args.slug === "string" && args.slug.length > 0 ? { slug: args.slug } : {},
+        ...args.full === true ? { full: true } : {}
+      };
+      writeJson(await apiPost("/api/creatives/feedback", body));
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+var feedbackCommand = defineCommand({
+  meta: { name: "feedback", description: DESCRIPTION },
+  subCommands: {
+    read: feedbackReadCommand,
+    record: () => import("./feedback-record-3S25ZDRU.js").then((m) => m.feedbackRecordCommand)
+  },
+  // `args` stays although the parent has no `run`: citty finds the subcommand
+  // name with THIS command's arg defs, so without them `--slug spring-offer`
+  // would read `spring-offer` as a subcommand. `default` (not `run`) serves the
+  // bare invocation, since citty runs a parent's `run` after its subcommand too.
+  args: readArgs,
+  default: "read"
+});
+export {
+  feedbackCommand
+};
+//# sourceMappingURL=feedback-UWHZFFY5.js.map

package/dist/feedback-record-3S25ZDRU.js

@@ -0,0 +1,174 @@
+import {
+  versionOf
+} from "./chunk-JDD6S73P.js";
+import "./chunk-AT7KNODI.js";
+import "./chunk-XY3KCVRB.js";
+import "./chunk-BUMKMXSN.js";
+import "./chunk-N6PW6QWC.js";
+import "./chunk-4G6GXPAT.js";
+import "./chunk-KXRAAA6D.js";
+import {
+  holdWorkspaceSpend
+} from "./chunk-PXDISZSC.js";
+import "./chunk-LOOPAOSC.js";
+import "./chunk-3GJDEOZ2.js";
+import "./chunk-D6XXXHLA.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-3VHZC3TN.js";
+import "./chunk-CHSNHVYF.js";
+import "./chunk-G3VNK6DL.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import {
+  askJev
+} from "./chunk-VYERPVW7.js";
+import "./chunk-3GJKFY7A.js";
+import "./chunk-RO5ZC4J6.js";
+import "./chunk-PI3WJP6J.js";
+import {
+  CREATIVE_FEEDBACK_REASONS,
+  creativesFeedbackRecordRequestSchema
+} from "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/feedback-record.ts
+import { defineCommand } from "citty";
+
+// src/commands/creatives/agent-option-note.ts
+var NOTE_BANDS = { tagged: 0.5, bareFix: 0.45, namesProblem: 0.5 };
+var TAGGED = "Does `note` end with a tag marking it as the recommended option, like (Recommended), in any language?";
+var BARE_FIX = 'Is `note` a bare yes to an offer to fix things, like "fix everything" or "fix what is pending", naming no particular problem? A note that names what is wrong or what to change (the typos, the price, cut-off text, redo the pieces) is not.';
+var NAMES_PROBLEM = "Does `note` name a particular problem, element or part of an ad (a typo, the price, the logo, the audio, the text, the colours, a person), apart from a whole format or size?";
+var jevNoteJudge = async (note) => {
+  const spent = [];
+  const answers = await askJev(
+    [TAGGED, BARE_FIX, NAMES_PROBLEM].map((question) => ({ instructions: { note, question } })),
+    (usage) => spent.push(usage)
+  );
+  await holdWorkspaceSpend(spent);
+  if (answers === null) return null;
+  const [tagged = 0, bareFix = 0, namesProblem = 1] = answers;
+  return { tagged, bareFix, namesProblem };
+};
+function readsAsAgentOption(reading) {
+  if (reading.tagged >= NOTE_BANDS.tagged) return true;
+  return reading.bareFix >= NOTE_BANDS.bareFix && reading.namesProblem < NOTE_BANDS.namesProblem;
+}
+async function readNoteAuthor(note, judge) {
+  const text = note.trim();
+  if (!text) return "person";
+  const reading = await judge(text).catch(() => null);
+  if (reading === null) return "unconfirmed";
+  return readsAsAgentOption(reading) ? "agent_option" : "person";
+}
+
+// src/commands/creatives/feedback-record.ts
+var DESCRIPTION = `Record what the user said about one version of a creative in this chat: an approval, or a rejection with reasons. Saved as their verdict (the person who wrote the latest message here) and read back by baker creatives feedback. One verdict per person per version or option: a later one replaces it.
+Start here: baker creatives feedback record --slug spring-offer --verdict rejected --reasons text_mistakes --note "<their words>"
+Only record what the user said, never your own judgment. Picking one of several concepts is not a rejection of the others.`;
+var ARGS = {
+  slug: { type: "string", description: "The creative: its folder name under src/creatives/.", required: true },
+  run: {
+    type: "string",
+    description: "The version: its canvas run id (r_\u2026) Left out, the version the creative shows now (its last render).",
+    required: false
+  },
+  option: {
+    type: "string",
+    description: 'One option of a version that made several: its label ("ugc"), its number ("2") or its slot. Left out, the whole version.',
+    required: false
+  },
+  verdict: { type: "string", description: "approved | rejected", required: true },
+  reasons: {
+    type: "string",
+    description: `Why it was rejected, comma-separated: ${CREATIVE_FEEDBACK_REASONS.join(", ")}. Map the user's words to these; "other" when none fits. On a video, voice_or_sound covers the voiceover, music and mix ("the voice sounds robotic", "music too loud") and pacing covers the timing ("too slow", "the hook comes too late").`,
+    required: false
+  },
+  note: {
+    type: "string",
+    description: "The user's own words, verbatim (not your summary). Up to 1000 characters.",
+    required: false
+  }
+};
+registerSchema({ command: "creatives.feedback.record", description: DESCRIPTION, args: ARGS });
+function splitList(value) {
+  if (typeof value !== "string" || value.trim() === "") return void 0;
+  return value.split(",").map((item) => item.trim()).filter((item) => item.length > 0);
+}
+function fail(code, message) {
+  writeJson({ ok: false, error: { code, message } });
+  process.exit(1);
+}
+async function refuseNotFeedback(body) {
+  if (body.verdict === "rejected" && !body.reasons?.length && !body.note) {
+    fail(
+      "VALIDATION_ERROR",
+      "A rejection needs --reasons or --note (the user's words), so the next version knows what to change."
+    );
+  }
+  if (body.verdict !== "rejected" || !body.note) return false;
+  const author = await readNoteAuthor(body.note, jevNoteJudge);
+  if (author === "agent_option") {
+    fail(
+      "AGENT_OPTION_NOT_FEEDBACK",
+      `"${body.note}" is the answer to your own question, not the person's taste: a defect the checks found is yours to fix inside this version (\`baker canvas run --fix\`), never feedback to record. Record only what the person says about the ad in their own words.`
+    );
+  }
+  return author === "unconfirmed";
+}
+var feedbackRecordCommand = defineCommand({
+  meta: { name: "record", description: DESCRIPTION },
+  args: ARGS,
+  run: async ({ args }) => {
+    const reasons = splitList(args.reasons);
+    const unknown = (reasons ?? []).filter(
+      (reason) => !CREATIVE_FEEDBACK_REASONS.includes(reason)
+    );
+    if (unknown.length > 0) {
+      fail("VALIDATION_ERROR", `Unknown reason ${unknown.join(", ")}. Use: ${CREATIVE_FEEDBACK_REASONS.join(", ")}.`);
+    }
+    const parsed = creativesFeedbackRecordRequestSchema.safeParse({
+      slug: args.slug,
+      runId: await versionOf(String(args.slug), args.run).then(
+        (run) => run ?? fail("VALIDATION_ERROR", "--run: this creative has no rendered version here; name one (r_\u2026).")
+      ),
+      ...typeof args.option === "string" && args.option.trim() ? { option: args.option.trim() } : {},
+      verdict: args.verdict,
+      ...reasons ? { reasons } : {},
+      ...typeof args.note === "string" && args.note.trim() ? { note: args.note } : {}
+    });
+    if (!parsed.success) {
+      const issue = parsed.error.issues[0];
+      fail("VALIDATION_ERROR", `--${String(issue?.path[0] ?? "args")}: ${issue?.message ?? "invalid"}`);
+    }
+    const body = parsed.data;
+    const noteUnconfirmed = await refuseNotFeedback(body);
+    try {
+      const response = await apiPost(
+        "/api/creatives/feedback/record",
+        noteUnconfirmed ? { ...body, noteUnconfirmed } : body
+      );
+      writeJson(response);
+    } catch (err) {
+      if (err instanceof ApiError) fail(err.code, err.message);
+      fail("INTERNAL_ERROR", "Unexpected error");
+    }
+  }
+});
+export {
+  feedbackRecordCommand
+};
+//# sourceMappingURL=feedback-record-3S25ZDRU.js.map

package/dist/fetch-C43ZQKI2.js

@@ -0,0 +1,175 @@
+import {
+  fetchHints,
+  redditPageFix
+} from "./chunk-XX5DXKEI.js";
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-DN3FLZRQ.js";
+import "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-D4N5ZXEO.js";
+import "./chunk-QYDJJLEE.js";
+import "./chunk-NBPJBJJD.js";
+import {
+  registerSchema
+} from "./chunk-4TCMKTJG.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/fetch.ts
+import { defineCommand } from "citty";
+var CONTENT_PREVIEW_CHARS = 2e4;
+var TIMEOUT_MS = 18e4;
+registerSchema({
+  command: "research.fetch",
+  description: "Read a page an ordinary web fetch could not \u2014 bot walls and JavaScript-rendered pages are resolved for you. Use it when your normal page read came back with a security check, an error page, or an empty shell.",
+  args: {
+    url: { type: "string", description: "Full URL of the page to read", required: true },
+    format: {
+      type: "string",
+      description: "markdown (default, best for reading) or html (when you need the markup)",
+      required: false,
+      enum: ["markdown", "html"]
+    },
+    "wait-for": {
+      type: "number",
+      description: "Extra ms to let late content settle (0-30000). Only for pages that fill in after load",
+      required: false
+    },
+    "whole-page": {
+      type: "boolean",
+      description: "Include nav, footer and sidebars (default: main content only)",
+      required: false,
+      default: false
+    },
+    full: {
+      type: "boolean",
+      description: `Return the whole page instead of the first ${CONTENT_PREVIEW_CHARS} characters`,
+      required: false,
+      default: false
+    }
+  }
+});
+var FIELDS = {
+  url: "The URL as asked for",
+  final_url: "Where the read landed after redirects",
+  title: "Page title, or null when the page declares none",
+  content: "The page text (markdown by default)",
+  content_chars: "Length of the full page available on the server",
+  content_shown: "Characters in `content` \u2014 below content_chars unless --full",
+  truncated: "The page was longer than one read returns, so the tail is missing",
+  provider: "Who resolved the read"
+};
+function fetchFix(code) {
+  if (code === "VALIDATION_ERROR") {
+    return {
+      action: "retry_with_changes",
+      explanation: "Re-run with a complete address, including https://."
+    };
+  }
+  if (code === "TIMEOUT") {
+    return {
+      action: "retry_with_changes",
+      explanation: "The page never settled. Retry this URL once with `--wait-for 10000`; if that fails too, carry on with the rest of the job and say this page couldn't be read."
+    };
+  }
+  if (code === "RATE_LIMITED") {
+    return {
+      action: "continue_without",
+      explanation: "The page reader is busy. Do the rest of the job first and come back to this URL once, later \u2014 don't loop on it."
+    };
+  }
+  if (code === "FORBIDDEN" || code === "NOT_FOUND") {
+    return {
+      action: "continue_without",
+      explanation: "This page will not open for us, and retrying will not change that. Carry on with the sources you can reach and say plainly which page you couldn't read."
+    };
+  }
+  return {
+    action: "continue_without",
+    explanation: "This read failed. Don't build a retry ladder around it \u2014 finish the rest of the job with what you can reach and name this page as a gap."
+  };
+}
+var fetchCommand = defineCommand({
+  meta: {
+    name: "fetch",
+    description: `Read a page an ordinary web fetch could not. Bot walls and JavaScript-rendered pages are resolved for you \u2014 you never have to retry, wait, or drive a browser yourself.
+
+Reach for this the moment a normal page read comes back with a security check, an error page, or an empty shell. One call, no escalation ladder.
+
+Examples:
+  baker research fetch "https://competitor.com/pricing"
+  baker research fetch "https://competitor.com/pricing" --full
+  baker research fetch "https://app.competitor.com/blog/post" --wait-for 5000
+  baker research fetch "https://competitor.com" --format html --whole-page`
+  },
+  args: {
+    url: { type: "positional", description: "URL of the page to read", required: false },
+    format: { type: "string", description: "markdown (default) or html", required: false },
+    "wait-for": { type: "string", description: "Extra ms to let late content settle (0-30000)", required: false },
+    "whole-page": { type: "boolean", description: "Include nav, footer and sidebars", required: false },
+    full: { type: "boolean", description: "Return the whole page, not just the first chunk", required: false }
+  },
+  run: async ({ args }) => {
+    const url = args.url;
+    if (!url) {
+      writeResearchJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "A URL is required",
+          fix: fetchFix("VALIDATION_ERROR")
+        }
+      });
+      process.exit(1);
+    }
+    const format = args.format ?? "markdown";
+    if (format !== "markdown" && format !== "html") {
+      writeResearchJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Format must be markdown or html",
+          fix: { action: "retry_with_changes", explanation: "Re-run with --format markdown or --format html." }
+        }
+      });
+      process.exit(1);
+    }
+    const body = { url, format };
+    if (args["wait-for"]) body.waitFor = Number(args["wait-for"]);
+    if (args["whole-page"]) body.onlyMainContent = false;
+    try {
+      const page = await apiPost("/api/research/fetch", body, { timeoutMs: TIMEOUT_MS });
+      const content = args.full ? page.content : page.content.slice(0, CONTENT_PREVIEW_CHARS);
+      writeResearchJson({
+        ok: true,
+        data: {
+          url: page.url,
+          final_url: page.finalUrl,
+          title: page.title,
+          content_chars: page.contentChars,
+          content_shown: content.length,
+          truncated: page.truncated,
+          provider: page.provider,
+          content
+        },
+        fields: FIELDS,
+        hints: fetchHints({
+          truncated: page.truncated,
+          contentChars: page.contentChars,
+          shownChars: content.length
+        })
+      });
+    } catch (err) {
+      handleResearchError(err, (code) => redditPageFix(url, code) ?? fetchFix(code));
+    }
+  }
+});
+export {
+  fetchCommand
+};
+//# sourceMappingURL=fetch-C43ZQKI2.js.map