@koda-sl/baker-cli 0.476.0 → 0.477.0

package/dist/chunk-DRPSJE62.js

@@ -1,216 +0,0 @@
-import {
-  nodeParamsPreview
-} from "./chunk-IMH2ZKKC.js";
-import {
-  creativeSlugFromCanvasPath,
-  parseDefinitionSeriesPlace,
-  parseDefinitionSourceFields,
-  parseDefinitionStrategyFields
-} from "./chunk-MSKB6I5E.js";
-import {
-  prepareCanvas
-} from "./chunk-WOLE67OJ.js";
-import {
-  BackendClient
-} from "./chunk-NDITGFPZ.js";
-import {
-  nodeDependencies
-} from "./chunk-WJOQ6IEK.js";
-import {
-  requireCredentialsFromEnv
-} from "./chunk-VPBCR6DT.js";
-
-// src/commands/canvas/sync-definition.ts
-import { readdir, readFile, stat } from "fs/promises";
-import path from "path";
-import { parseDocument } from "yaml";
-import { defineCommand } from "citty";
-
-// src/commands/canvas/definition-graph.ts
-var MAX_NODES = 300;
-var PREVIEWABLE_INGEST_EXPECTS = /* @__PURE__ */ new Set(["image"]);
-function nodeInputPreviewUrl(type, params) {
-  if (type !== "ingest" || !params || typeof params !== "object") return void 0;
-  const p = params;
-  if (p.source !== "url" || typeof p.url !== "string") return void 0;
-  if (!/^https?:\/\//i.test(p.url)) return void 0;
-  if (typeof p.expect === "string" && !PREVIEWABLE_INGEST_EXPECTS.has(p.expect)) return void 0;
-  return p.url;
-}
-function canvasToDefinitionGraph(canvas) {
-  const rawNodes = canvas?.nodes;
-  if (!Array.isArray(rawNodes)) return null;
-  const parsed = [];
-  for (const raw of rawNodes) {
-    const id = raw?.id;
-    const type = raw?.type;
-    if (typeof id !== "string" || typeof type !== "string") continue;
-    parsed.push({ id, type, inputs: raw.inputs, params: raw.params });
-    if (parsed.length >= MAX_NODES) break;
-  }
-  if (parsed.length === 0) return null;
-  const ids = new Set(parsed.map((n) => n.id));
-  const nodes = parsed.map(({ id, type, inputs, params }) => {
-    const deps = nodeDependencies({ id, inputs, params }, ids);
-    deps.delete(id);
-    const depList = [...deps];
-    const paramsPreview = nodeParamsPreview(params, depList);
-    const base = { id, type };
-    if (depList.length > 0) base.deps = depList;
-    if (paramsPreview) base.paramsPreview = paramsPreview;
-    const inputPreviewUrl = nodeInputPreviewUrl(type, params);
-    if (inputPreviewUrl) base.inputPreviewUrl = inputPreviewUrl;
-    return base;
-  });
-  const rawOutput = canvas?.output;
-  const outNode = rawOutput?.node;
-  const outSlot = rawOutput?.output;
-  const output = typeof outNode === "string" && typeof outSlot === "string" ? { node: outNode, output: outSlot } : void 0;
-  return { nodes, output };
-}
-
-// src/commands/canvas/sync-definition.ts
-function buildDefinitionSyncPayload(input, graph, chatId) {
-  const { canvas: _canvas, ...fields } = input;
-  return Object.fromEntries([
-    ...Object.entries(fields).filter(([, v]) => v !== void 0),
-    ["graph", graph],
-    ["chatId", chatId]
-  ]);
-}
-async function readDefinitionSourceFields(canvasPath) {
-  try {
-    return parseDefinitionSourceFields(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8"));
-  } catch {
-    return {};
-  }
-}
-async function readDefinitionBody(canvasPath) {
-  try {
-    return { definition: await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8") };
-  } catch {
-    return {};
-  }
-}
-async function readDefinitionTitle(canvasPath) {
-  try {
-    const raw = await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8");
-    const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
-    const doc = match ? parseDocument(match[1] ?? "") : null;
-    const title = doc && doc.errors.length === 0 ? doc.get("title") : void 0;
-    return typeof title === "string" && title.trim() ? title.trim() : void 0;
-  } catch {
-    return void 0;
-  }
-}
-async function readDefinitionStrategyFields(canvasPath) {
-  try {
-    return parseDefinitionStrategyFields(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8"));
-  } catch {
-    return {};
-  }
-}
-async function readDefinitionSeriesPlace(canvasPath) {
-  try {
-    return parseDefinitionSeriesPlace(await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8")) ?? {};
-  } catch {
-    return {};
-  }
-}
-async function syncCreativeDefinitionBestEffort(input) {
-  const chatId = process.env.BAKER_CHAT_ID;
-  if (!chatId) return;
-  const graph = canvasToDefinitionGraph(input.canvas);
-  if (!graph || graph.nodes.length === 0) return;
-  try {
-    const creds = requireCredentialsFromEnv();
-    const client = new BackendClient({ baseUrl: creds.url, apiKey: creds.apiKey });
-    await client.syncCreativeDefinition(buildDefinitionSyncPayload(input, graph, chatId));
-    process.stdout.write(`[definition] synced workflow graph (${graph.nodes.length} nodes) \u2014 view it in the dashboard
-`);
-  } catch (e) {
-    const msg = e instanceof Error ? e.message : String(e);
-    process.stderr.write(`[warn] workflow graph not synced (${msg})
-`);
-  }
-}
-async function resolveCanvasPath(inputPath) {
-  const resolved = path.resolve(inputPath);
-  let dir = resolved;
-  try {
-    if ((await stat(resolved)).isFile()) {
-      if (resolved.endsWith(".canvas.json")) return resolved;
-      dir = path.dirname(resolved);
-    }
-  } catch {
-    dir = resolved.endsWith(".canvas.json") ? path.dirname(resolved) : resolved;
-  }
-  let entries;
-  try {
-    entries = await readdir(dir);
-  } catch {
-    return null;
-  }
-  const canvases = entries.filter((name) => name.endsWith(".canvas.json"));
-  const slug = creativeSlugFromCanvasPath(`${dir}/x/`);
-  const chosen = (slug ? canvases.find((name) => name === `${slug}.canvas.json`) : void 0) ?? canvases[0];
-  return chosen ? path.join(dir, chosen) : null;
-}
-var syncDefinitionCommand = defineCommand({
-  meta: {
-    name: "sync-definition",
-    description: "Push a creative's current node-graph + input thumbnails to the dashboard without rendering. The graph has the creative's blueprint applied (prompt.json and scenes/*.json edits), exactly as `run` would render it, without changing any file. Runs automatically when you edit a creative's canvas.json or prompt.json."
-  },
-  args: {
-    file: {
-      type: "positional",
-      required: true,
-      description: "A path under src/creatives/<slug>/ (the .canvas.json, its prompt.json, or the folder)"
-    },
-    title: {
-      type: "boolean",
-      description: "Also record the title its _definition.md gives. Only for a creative just made from another (a series ad, a translation), never on an edit re-sync."
-    }
-  },
-  async run({ args }) {
-    const canvasPath = await resolveCanvasPath(String(args.file));
-    if (!canvasPath) {
-      return;
-    }
-    const slug = creativeSlugFromCanvasPath(canvasPath);
-    if (!slug) return;
-    let canvas;
-    let sourceSha;
-    try {
-      const prepared = await prepareCanvas(canvasPath, { write: false });
-      canvas = prepared.fileGraph;
-      sourceSha = prepared.sourceSha;
-    } catch {
-      return;
-    }
-    const title = args.title ? await readDefinitionTitle(canvasPath) : void 0;
-    await syncCreativeDefinitionBestEffort({
-      slug,
-      canvas,
-      sourceSha,
-      ...title ? { title } : {},
-      ...await readDefinitionSourceFields(canvasPath),
-      ...await readDefinitionStrategyFields(canvasPath),
-      ...await readDefinitionSeriesPlace(canvasPath),
-      ...await readDefinitionBody(canvasPath)
-    });
-  }
-});
-
-export {
-  buildDefinitionSyncPayload,
-  readDefinitionSourceFields,
-  readDefinitionBody,
-  readDefinitionTitle,
-  readDefinitionStrategyFields,
-  readDefinitionSeriesPlace,
-  syncCreativeDefinitionBestEffort,
-  resolveCanvasPath,
-  syncDefinitionCommand
-};
-//# sourceMappingURL=chunk-DRPSJE62.js.map

package/dist/chunk-EMDUW6QN.js

@@ -1,206 +0,0 @@
-import {
-  RESEARCH_GOOGLE_ADS_MAX_COPY
-} from "./chunk-PHY3AERY.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-EMDUW6QN.js.map

package/dist/chunk-ENY76SPM.js

@@ -1,74 +0,0 @@
-import {
-  writeOutput
-} from "./chunk-IWLWY2UD.js";
-
-// src/commands/images/providerHits.ts
-function asRecord(value) {
-  return value && typeof value === "object" ? value : {};
-}
-function str(value) {
-  return typeof value === "string" && value.length > 0 ? value : void 0;
-}
-function num(value) {
-  return typeof value === "number" ? value : void 0;
-}
-function compactHit(hit) {
-  return {
-    source: str(hit.source) ?? "",
-    url: str(hit.url) ?? "",
-    imageId: str(hit.imageId),
-    imageUrl: str(hit.imageUrl),
-    name: str(hit.name),
-    width: num(hit.width),
-    height: num(hit.height)
-  };
-}
-function providerHitNormalizer(record, full) {
-  const compact = compactHit(record);
-  if (!full) {
-    return compact;
-  }
-  const group = asRecord(record.group);
-  return {
-    ...compact,
-    externalUrl: str(record.externalUrl),
-    externalId: str(record.externalId),
-    description: str(record.description),
-    tags: Array.isArray(record.tags) ? record.tags : [],
-    aspectRatio: num(record.aspectRatio),
-    dominantColor: str(record.dominantColor),
-    score: num(record.score),
-    deduped: typeof record.deduped === "boolean" ? record.deduped : void 0,
-    alsoInLibrary: str(record.alsoInLibrary),
-    groupKey: str(group.key)
-  };
-}
-function readOutputFlags(args) {
-  const format = typeof args.output === "string" && args.output.length > 0 ? args.output : "json";
-  const rawFields = typeof args.fields === "string" && args.fields.length > 0 ? args.fields : void 0;
-  return {
-    format,
-    fields: rawFields ? rawFields.split(",").filter(Boolean) : void 0,
-    full: args.full === true
-  };
-}
-function writeProviderHits(data, hits, args, hints) {
-  const { format, fields, full } = readOutputFlags(args);
-  const envelope = {
-    ok: true,
-    data: format === "json" ? data : hits,
-    ...hints.length > 0 ? { hints } : {}
-  };
-  writeOutput(envelope, format, fields, full, providerHitNormalizer);
-}
-var OUTPUT_ARGS = {
-  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 full metadata", required: false, default: false }
-};
-
-export {
-  writeProviderHits,
-  OUTPUT_ARGS
-};
-//# sourceMappingURL=chunk-ENY76SPM.js.map