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

package/dist/chunk-NECTN6N7.js

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

package/dist/chunk-NIJSXVFT.js

@@ -1,304 +0,0 @@
-import {
-  languageTag
-} from "./chunk-EAEOPERX.js";
-import {
-  parseRefExpr
-} from "./chunk-6Y7SIP2D.js";
-import {
-  AWARENESS_VALUES
-} from "./chunk-5HYSKH77.js";
-import {
-  collectAssetRefLikes,
-  isPersistedAssetRef
-} from "./chunk-HRYOZUSK.js";
-
-// src/commands/canvas/creative-definition.ts
-import { parseDocument } from "yaml";
-var PLATFORM_VALUES = ["meta", "google", "linkedin", "tiktok", "youtube", "x", "other"];
-var FORMAT_VALUES = ["1:1", "4:5", "9:16", "16:9", "1.91:1"];
-var EVIDENCE_VALUES = ["observed", "interpreted", "hypothesized", "generated"];
-function titleFromSlug(slug) {
-  const title = slug.split("-").filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-  return title || slug;
-}
-function resolvePlatform(platform) {
-  const value = platform?.trim();
-  return value && PLATFORM_VALUES.includes(value) ? value : "meta";
-}
-function resolveFormats(aspect) {
-  const value = aspect?.trim();
-  return value && FORMAT_VALUES.includes(value) ? [value] : ["4:5"];
-}
-function resolveFormatList(formats) {
-  const valid = [...new Set(formats.map((f) => f.trim()))].filter(
-    (f) => FORMAT_VALUES.includes(f)
-  );
-  return valid.length > 0 ? valid : ["4:5"];
-}
-function describeBlueprintIntent(blueprint) {
-  const intent = blueprint?.ad_intent;
-  if (typeof intent === "string" && intent.trim()) return intent.trim();
-  if (intent && typeof intent === "object") {
-    const summary = intent.summary ?? intent.feeling;
-    if (typeof summary === "string" && summary.trim()) return summary.trim();
-  }
-  return void 0;
-}
-function yamlScalar(value) {
-  return JSON.stringify(value);
-}
-function buildCreativeDefinition(input) {
-  const lines = ["---", `title: ${yamlScalar(input.title)}`, `kind: ${input.kind}`, `platform: ${input.platform}`];
-  lines.push(`formats: [${input.formats.map(yamlScalar).join(", ")}]`);
-  lines.push(`status: ${input.status ?? "draft"}`);
-  if (input.sourceReferenceUrl) lines.push(`sourceReferenceUrl: ${yamlScalar(input.sourceReferenceUrl)}`);
-  if (input.sourceAdvertiser) lines.push(`sourceAdvertiser: ${yamlScalar(input.sourceAdvertiser)}`);
-  if (input.sourceAdvertiserId) lines.push(`sourceAdvertiserId: ${yamlScalar(input.sourceAdvertiserId)}`);
-  if (input.sourceAdId) lines.push(`sourceAdId: ${yamlScalar(input.sourceAdId)}`);
-  if (input.sourcePlatform) lines.push(`sourcePlatform: ${input.sourcePlatform}`);
-  if (input.sourceKind) lines.push(`sourceKind: ${input.sourceKind}`);
-  if (input.sourcePath) lines.push(`sourcePath: ${yamlScalar(input.sourcePath)}`);
-  if (input.targetAdSet) lines.push(`targetAdSet: ${yamlScalar(input.targetAdSet)}`);
-  if (input.viewer) lines.push(`viewer: ${JSON.stringify(input.viewer)}`);
-  lines.push("---", "");
-  lines.push(input.description?.trim() || `${input.title} \u2014 canvas-built ${input.kind} ad for ${input.platform}.`);
-  lines.push("");
-  return lines.join("\n");
-}
-var SOURCE_FIELD_KEYS = ["sourceAdId", "sourcePlatform", "sourceAdvertiserId"];
-function parseDefinitionSourceFields(raw) {
-  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
-  if (!match) return {};
-  const doc = parseDocument(match[1] ?? "");
-  if (doc.errors.length > 0) return {};
-  const fields = {};
-  for (const key of SOURCE_FIELD_KEYS) {
-    const value = doc.get(key);
-    if (typeof value === "string" && value.trim()) fields[key] = value.trim();
-  }
-  return fields;
-}
-function oneOf(values, value) {
-  return values.find((allowed) => allowed === value);
-}
-function parseDefinitionStrategyFields(raw) {
-  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
-  if (!match) return {};
-  const doc = parseDocument(match[1] ?? "");
-  if (doc.errors.length > 0) return {};
-  const text = (key) => {
-    const value = doc.get(key);
-    return typeof value === "string" && value.trim() ? value.trim() : void 0;
-  };
-  const ideaSlug = text("idea");
-  const message = text("message");
-  const evidence = oneOf(EVIDENCE_VALUES, text("evidence"));
-  const angle = text("angle");
-  const persona = text("persona");
-  const awareness = oneOf(AWARENESS_VALUES, text("awareness"));
-  const hypothesis = text("hypothesis");
-  const seriesLead = text("series");
-  const language = languageTag(text("language") ?? "");
-  return {
-    ...seriesLead ? { seriesLead } : {},
-    ...language ? { language } : {},
-    ...ideaSlug ? { ideaSlug } : {},
-    ...message ? { message } : {},
-    ...evidence ? { evidence } : {},
-    ...angle ? { angle } : {},
-    ...persona ? { persona } : {},
-    ...awareness ? { awareness } : {},
-    ...hypothesis ? { hypothesis } : {}
-  };
-}
-function parseDefinitionSeriesPlace(raw) {
-  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
-  if (!match || parseDocument(match[1] ?? "").errors.length > 0) return null;
-  const { seriesLead, language } = parseDefinitionStrategyFields(raw);
-  return { seriesLead: seriesLead ?? null, language: language ?? null };
-}
-function parseDefinitionViewerFields(raw) {
-  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
-  if (!match) return {};
-  const doc = parseDocument(match[1] ?? "");
-  if (doc.errors.length > 0) return {};
-  const data = doc.toJS();
-  const adSet = data?.targetAdSet;
-  const targetAdSet = typeof adSet === "string" || typeof adSet === "number" ? String(adSet).trim() : "";
-  return {
-    ...targetAdSet ? { targetAdSet } : {},
-    ...data?.viewer !== void 0 ? { viewer: data.viewer } : {}
-  };
-}
-function setDefinitionViewer(raw, fields) {
-  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
-  if (!match) return raw;
-  const doc = parseDocument(match[1] ?? "");
-  if (doc.errors.length > 0) return raw;
-  if (fields.targetAdSet) doc.set("targetAdSet", fields.targetAdSet);
-  if (fields.viewer) doc.set("viewer", doc.createNode(fields.viewer, { flow: true }));
-  return `---
-${doc.toString()}---${raw.slice(match[0].length)}`;
-}
-
-// src/commands/canvas/run-record.ts
-import path from "path";
-var MAX_RUN_NODES = 200;
-var MAX_OUTPUTS_PER_NODE = 10;
-var MAX_FINAL_OUTPUTS = 10;
-var MAX_CREATIVE_SLUG_LENGTH = 100;
-function creativeSlugFromCanvasPath(filePath) {
-  const normalized = filePath.split(path.sep).join("/");
-  const match = normalized.match(/(?:^|\/)src\/creatives\/([a-z0-9](?:[a-z0-9-]*[a-z0-9])?)\//);
-  const slug = match?.[1] ?? null;
-  return slug && slug.length <= MAX_CREATIVE_SLUG_LENGTH ? slug : null;
-}
-function finalOutputLabelsFromCanvas(parsed) {
-  const canvas = parsed;
-  const outputNodeId = canvas?.output?.node;
-  if (typeof outputNodeId !== "string" || !Array.isArray(canvas?.nodes)) return null;
-  const node = canvas.nodes.find((n) => n?.id === outputNodeId);
-  if (node?.type !== "collect") return null;
-  const explicit = node.params?.labels;
-  if (Array.isArray(explicit) && explicit.every((l) => typeof l === "string")) {
-    return { nodeId: outputNodeId, labels: explicit };
-  }
-  const images = node.inputs?.images;
-  if (!Array.isArray(images)) return null;
-  const labels = images.map((entry) => {
-    if (typeof entry !== "string") return void 0;
-    return parseRefExpr(entry)?.nodeId;
-  });
-  return { nodeId: outputNodeId, labels };
-}
-var OUTPUT_KINDS = /* @__PURE__ */ new Set(["image", "video", "audio", "json", "text", "font"]);
-function toRecordOutput(slot, value, label) {
-  const refs = collectAssetRefLikes(value);
-  const ref = refs.length === 1 ? refs[0] : null;
-  if (!ref || !isPersistedAssetRef(ref)) return null;
-  const kind = typeof ref.kind === "string" && OUTPUT_KINDS.has(ref.kind) ? ref.kind : null;
-  if (!kind) return null;
-  return {
-    slot,
-    label,
-    kind,
-    sha256: ref.sha256,
-    url: ref.url,
-    mime: ref.mime,
-    width: typeof ref.width === "number" ? ref.width : void 0,
-    height: typeof ref.height === "number" ? ref.height : void 0,
-    durationMs: typeof ref.duration_ms === "number" ? ref.duration_ms : void 0
-  };
-}
-function nodeOutputsToRecord(nodeOutputs, labels) {
-  const out = [];
-  for (const [slot, value] of Object.entries(nodeOutputs)) {
-    if (Array.isArray(value)) {
-      value.forEach((item, i) => {
-        const rec = toRecordOutput(`${slot}#${i}`, item, labels?.[i]);
-        if (rec) out.push(rec);
-      });
-    } else {
-      const rec = toRecordOutput(slot, value);
-      if (rec) out.push(rec);
-    }
-  }
-  return out.slice(0, MAX_OUTPUTS_PER_NODE);
-}
-function finalOutputsToRecord(output, labels) {
-  if (Array.isArray(output)) {
-    return output.map((item, i) => toRecordOutput(`final#${i}`, item, labels?.[i])).filter((rec2) => rec2 !== null).slice(0, MAX_FINAL_OUTPUTS);
-  }
-  const rec = toRecordOutput("final", output);
-  return rec ? [rec] : [];
-}
-function finalFiles(output, labels) {
-  const items = Array.isArray(output) ? output : [output];
-  const files = {};
-  items.forEach((item, i) => {
-    const ref = collectAssetRefLikes(item)[0];
-    if (ref && typeof ref.path === "string") files[labels?.[i] ?? `final#${i}`] = ref.path;
-  });
-  return files;
-}
-function buildRunRecord(result, meta, plan, finalLabels) {
-  const nodes = result.node_runs.slice(0, MAX_RUN_NODES).map((run) => {
-    const planned = plan?.get(run.node_id);
-    return {
-      nodeId: run.node_id,
-      nodeType: run.node_type,
-      cached: run.cached,
-      credits: run.credits,
-      durationMs: run.duration_ms,
-      outputs: nodeOutputsToRecord(
-        result.outputs_by_node[run.node_id] ?? {},
-        run.node_id === finalLabels?.nodeId ? finalLabels.labels : void 0
-      ),
-      deps: planned?.deps,
-      status: plan ? "completed" : void 0,
-      paramsPreview: planned?.paramsPreview,
-      ...planned?.role !== void 0 ? { role: planned.role } : {}
-    };
-  });
-  const finalOutputs = finalOutputsToRecord(result.output, finalLabels?.labels);
-  return {
-    runId: result.run_id,
-    ...meta,
-    status: "completed",
-    stats: {
-      totalNodes: result.stats.total_nodes,
-      cachedNodes: result.stats.cached_nodes,
-      totalCredits: result.stats.total_credits,
-      durationMs: result.stats.duration_ms
-    },
-    nodes,
-    finalOutputs: finalOutputs.length > 0 ? finalOutputs : void 0,
-    // Sent whenever the review RAN, empty list included. Sending it only when there
-    // were findings makes a clean render and an unreviewed one look identical in the
-    // record — which is the exact ambiguity this field was added to remove: proving a
-    // review had happened once meant re-running a cached canvas and reading raw JSON.
-    // Only the fields the backend keeps: a static review's typed fields (`kind`) stay in the CLI.
-    ...meta.review ? { review: meta.review.slice(0, 40).map(({ severity, what, scene }) => ({ severity, what, ...scene ? { scene } : {} })) } : {}
-  };
-}
-function buildInitialRunRecord(runId, meta) {
-  return {
-    runId,
-    ...meta,
-    status: "running",
-    stats: { totalNodes: 0, cachedNodes: 0, totalCredits: 0, durationMs: 0 },
-    nodes: []
-  };
-}
-function buildFailedRunRecord(runId, errorMessage, meta) {
-  return {
-    runId,
-    ...meta,
-    status: "failed",
-    errorMessage: errorMessage.slice(0, 2e3),
-    stats: { totalNodes: 0, cachedNodes: 0, totalCredits: 0, durationMs: 0 },
-    nodes: []
-  };
-}
-
-export {
-  titleFromSlug,
-  resolvePlatform,
-  resolveFormats,
-  resolveFormatList,
-  describeBlueprintIntent,
-  buildCreativeDefinition,
-  parseDefinitionSourceFields,
-  parseDefinitionStrategyFields,
-  parseDefinitionSeriesPlace,
-  parseDefinitionViewerFields,
-  setDefinitionViewer,
-  creativeSlugFromCanvasPath,
-  finalOutputLabelsFromCanvas,
-  nodeOutputsToRecord,
-  finalFiles,
-  buildRunRecord,
-  buildInitialRunRecord,
-  buildFailedRunRecord
-};
-//# sourceMappingURL=chunk-NIJSXVFT.js.map