@koda-sl/baker-cli 0.447.0 → 0.448.0-dev.ccc3c9a37

package/dist/chunk-35XWJEWH.js

@@ -1,274 +0,0 @@
-import {
-  chatgptDraftOpInputSchema,
-  chatgptFailure
-} from "./chunk-KLBTXETO.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-VFIOJD5M.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import {
-  requireChatId
-} from "./chunk-NAWWC5I3.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.js";
-
-// src/commands/ads/chatgpt/write-shared.ts
-import { defineCommand } from "citty";
-function fail(envelope) {
-  writeJsonEnvelope({ ...envelope });
-  process.exit(1);
-}
-function failWriteValidation(message) {
-  fail({
-    ok: false,
-    error: {
-      code: "VALIDATION_ERROR",
-      message,
-      fix: { action: "add_required_field", explanation: `${message}. Nothing was staged.` },
-      retryable: false
-    }
-  });
-}
-function writeFailure(err, reference) {
-  if (!(err instanceof ApiError) && err instanceof Error && err.message.includes("BAKER_CHAT_ID")) {
-    return {
-      ok: false,
-      error: {
-        code: "NO_CHAT",
-        message: err.message,
-        fix: {
-          action: "reject",
-          explanation: "ChatGPT Ads changes are staged on a chat and apply when it is published; run this from the chat."
-        },
-        retryable: false
-      }
-    };
-  }
-  return chatgptFailure(err, reference);
-}
-function decimalPlaces(value) {
-  const [mantissa, exponent] = String(value).trim().split(/e/i);
-  const written = (mantissa?.split(".")[1] ?? "").length;
-  return Math.max(0, written - (exponent ? Number(exponent) : 0));
-}
-function parseChatgptMoney(value) {
-  if (value === void 0 || value === "") {
-    return { ok: true, micros: void 0 };
-  }
-  const amount = Number(value);
-  if (!Number.isFinite(amount) || amount <= 0) {
-    return { ok: false, reason: "must be a positive amount, for example 12.50" };
-  }
-  if (decimalPlaces(value) > 6) {
-    return { ok: false, reason: "is finer than ChatGPT Ads can express" };
-  }
-  return { ok: true, micros: Math.round(amount * 1e6) };
-}
-function microsFromArg(value, flag) {
-  const parsed = parseChatgptMoney(value);
-  if (!parsed.ok) {
-    failWriteValidation(`${flag} ${parsed.reason}`);
-  }
-  return parsed.micros;
-}
-function csvArg(value) {
-  if (typeof value !== "string" || value.trim().length === 0) {
-    return void 0;
-  }
-  const parts = value.split(",").map((part) => part.trim()).filter(Boolean);
-  return parts.length > 0 ? parts : void 0;
-}
-function schemaArgs(args) {
-  return Object.fromEntries(
-    Object.entries(args).map(([name, arg]) => [
-      name,
-      {
-        type: arg.type === "positional" ? "string" : arg.type,
-        description: arg.description,
-        required: arg.required === true
-      }
-    ])
-  );
-}
-function lowerArg(value) {
-  return typeof value === "string" && value.trim() !== "" ? value.trim().toLowerCase() : void 0;
-}
-function lowerCsvArg(value) {
-  return csvArg(value)?.map((part) => part.toLowerCase());
-}
-function compact(payload) {
-  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== void 0 && value !== ""));
-}
-function requireTarget(args, name) {
-  const value = args[name];
-  if (typeof value !== "string" || value.trim().length === 0) {
-    failWriteValidation(`${name} is required`);
-  }
-  return value.trim();
-}
-function requireTargets(args, name) {
-  const ids = csvArg(args[name]);
-  if (!ids) {
-    failWriteValidation(`${name} is required \u2014 pass one or more ids, comma-separated`);
-  }
-  return ids;
-}
-function preflight(raw) {
-  const parsed = chatgptDraftOpInputSchema.safeParse(raw);
-  if (parsed.success) {
-    return parsed.data;
-  }
-  const fields = parsed.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message }));
-  const message = fields.map((field) => field.path ? `${field.path}: ${field.message}` : field.message).join("; ");
-  return fail({
-    ok: false,
-    error: {
-      code: "VALIDATION_ERROR",
-      message,
-      fix: {
-        action: "retry_with_modified_query",
-        explanation: "Fix the named fields and stage again. Nothing was staged \u2014 the draft is as it was before this call."
-      },
-      retryable: false
-    }
-  });
-}
-async function postStage(chatId, op) {
-  return await apiPost("/api/ads/chatgpt/draft/stage", { chatId, op });
-}
-async function stageChatgptOp(raw, reference, hintsFor) {
-  const op = preflight(raw);
-  try {
-    const staged = await postStage(requireChatId(), op);
-    const hints = hintsFor?.(staged) ?? [];
-    writeJsonEnvelope({ ok: true, data: staged, ...hints.length > 0 ? { hints } : {} });
-  } catch (err) {
-    fail(writeFailure(err, reference));
-  }
-}
-async function stageChatgptOps(raws, reference) {
-  if (raws.length === 1 && raws[0]) {
-    await stageChatgptOp(raws[0], reference);
-    return;
-  }
-  const ops = raws.map(preflight);
-  const staged = [];
-  try {
-    const chatId = requireChatId();
-    for (const op of ops) {
-      staged.push(await postStage(chatId, op));
-    }
-    writeJsonEnvelope({ ok: true, data: staged });
-  } catch (err) {
-    const failure = writeFailure(err, reference);
-    if (staged.length > 0) {
-      failure.error.message = `${failure.error.message} (already staged: ${staged.map((s) => s.summary).join("; ")})`;
-    }
-    fail(failure);
-  }
-}
-function clearableCsvArg(value) {
-  return typeof value === "string" && value.trim().toLowerCase() === "none" ? [] : csvArg(value);
-}
-function clearableArg(value) {
-  if (typeof value !== "string" || value.trim() === "") {
-    return void 0;
-  }
-  return value.trim().toLowerCase() === "none" ? null : value.trim();
-}
-function cropArg(value, flag) {
-  const parts = csvArg(value);
-  if (!parts) {
-    return void 0;
-  }
-  const numbers = parts.map(Number);
-  const [x, y, width, height] = numbers;
-  if (numbers.length !== 4 || numbers.some(Number.isNaN) || x === void 0 || y === void 0 || width === void 0 || height === void 0) {
-    failWriteValidation(`${flag} takes four shares of the image, x,y,width,height \u2014 e.g. 0.1,0,0.8,0.8`);
-  }
-  return { x, y, width, height };
-}
-var STATUS_OF = {
-  pause: "paused",
-  resume: "active",
-  archive: "archived"
-};
-function statusOps(entity, ids, status) {
-  return ids.map((id) => ({ kind: `${entity}.update`, target: id, payload: { status } }));
-}
-var STATUS_NOUN = {
-  campaign: { command: "campaigns", plural: "campaigns", example: "cmpn_123,cmpn_456" },
-  adGroup: { command: "ad-groups", plural: "ad groups", example: "adgrp_123,adgrp_456" },
-  ad: { command: "ads", plural: "cards", example: "ad_123,ad_456" }
-};
-var STATUS_DOING = { pause: "pausing", resume: "resuming", archive: "archiving" };
-function statusCommand(entity, verb, reference) {
-  const noun = STATUS_NOUN[entity];
-  const args = {
-    ids: { type: "positional", description: `${noun.plural} ids, comma-separated`, required: true }
-  };
-  const forGood = verb === "archive" ? ` Archiving is for good: ChatGPT Ads cannot bring archived ${noun.plural} back, and their results stay in reports. Pause instead unless the user asked to archive.` : "";
-  registerSchema({
-    command: `ads.chatgpt.${noun.command}.${verb}`,
-    description: `Stage ${STATUS_DOING[verb]} one or more ChatGPT Ads ${noun.plural}. Pass every id in one call.${forGood}`,
-    args: schemaArgs(args)
-  });
-  return defineCommand({
-    meta: {
-      name: verb,
-      description: `Stage ${STATUS_DOING[verb]} ${noun.plural}.${forGood}
-
-Example:
-  baker ads chatgpt ${noun.command} ${verb} ${noun.example}`
-    },
-    args,
-    run: async ({ args: parsed }) => {
-      await stageChatgptOps(statusOps(entity, requireTargets(parsed, "ids"), STATUS_OF[verb]), reference);
-    }
-  });
-}
-function productFiltersArg(value) {
-  if (typeof value !== "string" || value.trim() === "") {
-    return void 0;
-  }
-  if (value.trim().toLowerCase() === "none") {
-    return [];
-  }
-  return value.split(";").map((condition) => condition.trim()).filter(Boolean).map((condition) => {
-    const match = /^(\S+)\s+(\S+)\s+(.+)$/.exec(condition);
-    if (!match?.[1] || !match[2] || !match[3]) {
-      failWriteValidation(
-        `"${condition}" is not a product filter \u2014 write field operator values, e.g. price lte 5000`
-      );
-    }
-    return {
-      field: match[1],
-      operator: match[2].toLowerCase(),
-      values: match[3].split("|").map((part) => part.trim()).filter(Boolean)
-    };
-  });
-}
-
-export {
-  failWriteValidation,
-  microsFromArg,
-  csvArg,
-  schemaArgs,
-  lowerArg,
-  lowerCsvArg,
-  compact,
-  requireTarget,
-  requireTargets,
-  stageChatgptOp,
-  stageChatgptOps,
-  clearableCsvArg,
-  clearableArg,
-  cropArg,
-  statusCommand,
-  productFiltersArg
-};
-//# sourceMappingURL=chunk-35XWJEWH.js.map

package/dist/chunk-3CWL2LY4.js

@@ -1,206 +0,0 @@
-import {
-  RESEARCH_GOOGLE_ADS_MAX_COPY
-} from "./chunk-NDXBU22S.js";
-
-// src/commands/research/hints.ts
-var AD_COPY_ROUTE = 'This returns competing domains and their SERP economics \u2014 no ad copy, no headlines, no creative. For a competitor\'s Google ads and their copy: `baker research google-ads <competitor.com> --copy` (Google\'s Ads Transparency Center: every ad, how long it has run, and the text ads\' headline and description). For Meta and LinkedIn: `baker winning-ads advertisers "<brand>"` \u2192 `baker winning-ads search "<brief>" --advertiser-id <id>` \u2192 `baker winning-ads content <adId>` (`primary_text` / `headline` / `cta`, plus the spoken transcript and on-screen text for video). Do not keep querying this command for copy.';
-function noSerpRowsHints(rowCount, queryContext) {
-  if (rowCount > 0) {
-    return [];
-  }
-  const defaulted = queryContext.location_is_default || queryContext.language_is_default;
-  if (defaulted) {
-    return [
-      `No rows for ${queryContext.location} / ${queryContext.language} \u2014 the market you did not set. Set --location and --language for the client's actual market and re-run once (\`baker research countries\` / \`baker research languages\` for the accepted codes) before you touch the keyword.`
-    ];
-  }
-  return [
-    `No rows for ${queryContext.location} / ${queryContext.language}, which you set explicitly. This term has no third-party SERP coverage in that market \u2014 move on rather than re-querying it. For demand signal try \`baker research autocomplete\`; for a competitor's actual terms, \`baker research keywords-for-site <domain>\`.`
-  ];
-}
-function advertisersHints(rowCount, queryContext) {
-  return [...noSerpRowsHints(rowCount, queryContext), AD_COPY_ROUTE];
-}
-function keywordsForSiteHints(rowCount, queryContext, typeFilter) {
-  if (rowCount > 0) {
-    return [];
-  }
-  if (typeFilter === "paid" || typeFilter === "organic") {
-    return [
-      `No rows with --type ${typeFilter} in ${queryContext.location} / ${queryContext.language}. A domain with zero ${typeFilter} keywords in a market is itself the finding \u2014 record it and move on. Confirm once with --type all (nothing at all there means the domain has no SERP coverage, not that it has no ads) instead of re-running with a different --sort or --limit.`
-    ];
-  }
-  return noSerpRowsHints(rowCount, queryContext);
-}
-var THIN_ANSWER_CHARS = 600;
-var THIN_SOURCE_COUNT = 2;
-var ESCALATION = {
-  medium: "`medium` is a quick lookup, not a search. Re-ask the SAME question once with `--depth high` before concluding the web has nothing on it.",
-  high: "`high` already thought hard about this. `--depth xhigh` is the only step left and it can run 15 minutes \u2014 take it only if this answer blocks a deliverable; otherwise record the gap and move on."
-};
-function fetchHints({
-  truncated,
-  contentChars,
-  shownChars
-}) {
-  const hints = [];
-  if (shownChars < contentChars) {
-    hints.push(
-      `Showing the first ${shownChars.toLocaleString("en-US")} of ${contentChars.toLocaleString("en-US")} characters. Re-run the same command with \`--full\` for the whole page \u2014 the read is cached for 24h, so it costs no extra time and no extra credit.`
-    );
-  }
-  if (truncated) {
-    hints.push(
-      "This page is longer than one read returns, so the end of it is missing. Don't present this as the complete page; if the part you need is further down, fetch the deeper URL directly."
-    );
-  }
-  return hints;
-}
-function webDepthHints({
-  answer,
-  sourceCount,
-  depth
-}) {
-  const thin = answer.length < THIN_ANSWER_CHARS || sourceCount <= THIN_SOURCE_COUNT;
-  const escalation = ESCALATION[depth];
-  if (!thin || !escalation) {
-    return [];
-  }
-  return [`Thin answer (${answer.length} chars, ${sourceCount} source(s)). ${escalation}`];
-}
-function keywordMetricsHints({
-  rows,
-  asked,
-  clickstream,
-  queryContext
-}) {
-  if (rows.length === 0) {
-    return noSerpRowsHints(0, queryContext);
-  }
-  const provenance = "DataForSEO resells Google's Keyword Planner volume \u2014 planner_search_volume here is the SAME number `baker ads google keywords metrics` returns, not an independent reading of it. Quoting the two as agreeing sources is not corroboration." + (clickstream ? " clickstream_search_volume IS independent (DataForSEO's own panels); when the two disagree, say which one you are quoting." : " For a genuinely independent estimate of demand, re-run with --clickstream (costs 2x), or use first-party data: `baker gsc query` for what already reaches the site, or the account's own search terms.");
-  const hints = [provenance];
-  const empty = rows.filter((row) => row.search_volume === null).map((row) => row.keyword);
-  if (empty.length > 0) {
-    hints.push(
-      `${empty.length} of ${asked.length} keywords came back with no data in ${queryContext.location} / ${queryContext.language}: ${empty.join(", ")}. That is missing coverage, NOT zero demand \u2014 do not report them as unsearched, and do not re-query them reworded. \`baker research autocomplete\` on the head term is the way to find the phrasing that market uses.`
-    );
-  }
-  return hints;
-}
-var ARCHIVE_NOTE = "Read from the Reddit archive: the words are as posted, but points and comment counts on anything under ~36h old are as first captured \u2014 don't quote those numbers as current.";
-function redditSearchHints({
-  resultCount,
-  kind,
-  source
-}) {
-  const hints = [];
-  if (resultCount === 0) {
-    hints.push(
-      'Nothing matched. Reddit search matches words, not meaning: try the audience\'s own phrasing (one distinctive word, or a seed from `baker research autocomplete`), a longer --since window, or other subreddits \u2014 `baker research reddit subreddits "<topic>"` finds where the audience actually talks' + (kind === "posts" ? ", and try --kind comments \u2014 most of the voice is in the replies." : ".")
-    );
-  } else if (kind === "posts") {
-    hints.push(
-      "Titles rarely carry the voice. Read the promising threads with `baker research reddit thread <permalink>` for the replies, or search the replies directly with --kind comments."
-    );
-  }
-  if (source === "archive" && resultCount > 0) hints.push(ARCHIVE_NOTE);
-  return hints;
-}
-function redditThreadHints({
-  commentsShown,
-  commentsAsked,
-  commentCount,
-  source
-}) {
-  const hints = [];
-  if (commentsAsked > 0 && commentsShown === 0 && (commentCount ?? 0) > 0) {
-    hints.push(
-      `This thread has ${commentCount} comments but none could be read just now. Quote the post only, and don't describe the replies.`
-    );
-  }
-  if (source === "archive") hints.push(ARCHIVE_NOTE);
-  return hints;
-}
-var REDDIT_HOST = /(^|\.)reddit\.com$|^redd\.it$/i;
-function redditSubredditsHints({ resultCount }) {
-  if (resultCount === 0) {
-    return [
-      'No subreddits matched. Try the audience\'s role or the platform they work on ("amazon flex", "deliveroo", "nurses"), one word at a time, or a web search for `site:reddit.com <topic>`.'
-    ];
-  }
-  return [
-    'Members say how big a subreddit is, not how active it is. Before mining one, run `baker research reddit search "<word>" --subreddit <name> --since <a recent date>`: nothing back means it is quiet, so pick another. `restricted` can still be read; `private` cannot.'
-  ];
-}
-var REDDIT_LINK_REJECTED = {
-  action: "reject",
-  explanation: "Do not quote anything attributed to this link \u2014 it does not lead to those words. Find the real thread with `baker research reddit search`, and if you already wrote a quote from it, remove it."
-};
-function redditPageFix(url, code) {
-  let host;
-  try {
-    host = new URL(url).hostname;
-  } catch {
-    return null;
-  }
-  if (!REDDIT_HOST.test(host)) return null;
-  if (code === "NOT_FOUND") return REDDIT_LINK_REJECTED;
-  if (code !== "FORBIDDEN") return null;
-  return {
-    action: "retry_with_changes",
-    explanation: 'Read Reddit with its own commands: `baker research reddit search "<words>" --subreddit <name>` to find what people said, `baker research reddit thread <url>` for one thread.'
-  };
-}
-function googleAdsHints({
-  target,
-  adCount,
-  located,
-  textWithoutCopy,
-  copyAsked,
-  copyUnread,
-  visual
-}) {
-  if (adCount === 0) {
-    return [
-      `No Google ads point to ${target}${located ? " in that region" : ""} \u2014 that is the answer, not a failed call: this competitor is not advertising on Google there, or its ads point to another domain. ` + (located ? "Re-run once without --location to see every region; then move on. " : "Move on. ") + `Its paid search terms, if any: \`baker research keywords-for-site ${target} --type paid\`.`
-    ];
-  }
-  const hints = [];
-  if (!copyAsked && textWithoutCopy > 0) {
-    hints.push(
-      `${textWithoutCopy} text ads came back without their words. Re-run with --copy to read the headline and description of up to ${RESEARCH_GOOGLE_ADS_MAX_COPY} (cached, so only the reading is new).`
-    );
-  }
-  const pastCap = copyAsked ? textWithoutCopy - copyUnread : 0;
-  if (pastCap > 0) {
-    hints.push(
-      `${pastCap} text ads past the first ${RESEARCH_GOOGLE_ADS_MAX_COPY} were not read \u2014 one request reads at most ${RESEARCH_GOOGLE_ADS_MAX_COPY}. Narrow with --since, --location or --platform google_search and re-run for their words.`
-    );
-  }
-  if (visual > 0 || copyUnread > 0) {
-    const without = [
-      visual > 0 ? `${visual} image or video ads (Google gives no text for those)` : "",
-      copyUnread > 0 ? `${copyUnread} text ads whose image could not be read` : ""
-    ].filter(Boolean);
-    hints.push(
-      `No copy for ${without.join(" and ")}: show those by their \`transparency_url\`. Do not open the Transparency Center in agent-browser to read them \u2014 it is the browser load this command exists to avoid.`
-    );
-  }
-  return hints;
-}
-
-export {
-  noSerpRowsHints,
-  advertisersHints,
-  keywordsForSiteHints,
-  fetchHints,
-  webDepthHints,
-  keywordMetricsHints,
-  redditSearchHints,
-  redditThreadHints,
-  redditSubredditsHints,
-  REDDIT_LINK_REJECTED,
-  redditPageFix,
-  googleAdsHints
-};
-//# sourceMappingURL=chunk-3CWL2LY4.js.map