@koda-sl/baker-cli 0.478.0 → 0.479.0

package/dist/chunk-L4LLNGJG.js

@@ -1,111 +0,0 @@
-import {
-  prepareCanvas,
-  unsuppliedPlaceholderAssets
-} from "./chunk-3YSLIBIM.js";
-import {
-  isSourceStale
-} from "./chunk-A5VAM472.js";
-
-// src/commands/canvas/render-state.ts
-import { mkdir, readdir, readFile, rm, writeFile } from "fs/promises";
-import path from "path";
-var RENDER_STATE_DIR = ".rendered";
-function statePath(canvasRoot, slug) {
-  return path.join(canvasRoot, RENDER_STATE_DIR, `${slug}.json`);
-}
-async function readRenderState(canvasRoot, slug) {
-  try {
-    const parsed = JSON.parse(await readFile(statePath(canvasRoot, slug), "utf8"));
-    return parsed && typeof parsed === "object" ? parsed : {};
-  } catch {
-    return {};
-  }
-}
-async function latestVersion(canvasRoot, slug) {
-  return (await readRenderState(canvasRoot, slug)).rendered?.runId ?? null;
-}
-async function updateRenderState(canvasRoot, slug, patch) {
-  try {
-    const next = { ...await readRenderState(canvasRoot, slug), ...patch };
-    await mkdir(path.join(canvasRoot, RENDER_STATE_DIR), { recursive: true });
-    await writeFile(statePath(canvasRoot, slug), `${JSON.stringify(next, null, 2)}
-`, "utf8");
-  } catch {
-  }
-}
-async function recordRenderAttempt(canvasRoot, slug, sourceSha) {
-  if (!sourceSha) return;
-  await updateRenderState(canvasRoot, slug, { attempted: { sourceSha, at: Date.now() } });
-}
-async function recordRendered(canvasRoot, slug, sourceSha, runId, drawn = {}) {
-  if (!sourceSha) return;
-  await updateRenderState(canvasRoot, slug, {
-    rendered: { sourceSha, runId, at: Date.now() },
-    ...drawn.prompt !== void 0 ? { prompt: drawn.prompt } : {},
-    lastFix: drawn.lastFix,
-    picture: drawn.picture,
-    ...drawn.seriesLeadRun ? { seriesLeadRun: drawn.seriesLeadRun } : {}
-  });
-}
-async function recordReviewOutcome(canvasRoot, slug, outcome) {
-  await updateRenderState(canvasRoot, slug, outcome);
-}
-async function recordSeriesLeadRun(canvasRoot, slug, leadRunId) {
-  await updateRenderState(canvasRoot, slug, { seriesLeadRun: leadRunId });
-}
-async function recordSnapshot(canvasRoot, slug, snapshot) {
-  await updateRenderState(canvasRoot, slug, { snapshot });
-}
-function isRenderStale(state, currentSourceSha) {
-  if (!state.rendered) return false;
-  if (!isSourceStale(currentSourceSha, state.rendered.sourceSha)) return false;
-  return state.attempted?.sourceSha !== currentSourceSha;
-}
-async function staleCreatives(workspaceRoot) {
-  const creativesDir = path.join(workspaceRoot, "src", "creatives");
-  const canvasRoot = path.join(workspaceRoot, "canvas");
-  let slugs;
-  try {
-    slugs = (await readdir(creativesDir, { withFileTypes: true })).filter((d) => d.isDirectory()).map((d) => d.name);
-  } catch {
-    return [];
-  }
-  const stale = [];
-  for (const slug of slugs.sort()) {
-    const state = await readRenderState(canvasRoot, slug);
-    if (!state.rendered) continue;
-    const canvasPath = path.join(creativesDir, slug, `${slug}.canvas.json`);
-    let prepared;
-    try {
-      prepared = await prepareCanvas(canvasPath, { write: false });
-    } catch {
-      continue;
-    }
-    if (unsuppliedPlaceholderAssets(prepared.fileGraph).length > 0) continue;
-    const current = prepared.sourceSha;
-    if (!current || !isRenderStale(state, current)) continue;
-    stale.push({
-      slug,
-      canvasPath: path.relative(workspaceRoot, canvasPath).split(path.sep).join("/"),
-      renderedRunId: state.rendered.runId,
-      sourceSha: current
-    });
-  }
-  return stale;
-}
-async function clearLegacyDirtyMarker(canvasRoot, slug) {
-  await rm(path.join(canvasRoot, ".dirty", `${slug}.json`), { force: true }).catch(() => void 0);
-}
-
-export {
-  readRenderState,
-  latestVersion,
-  recordRenderAttempt,
-  recordRendered,
-  recordReviewOutcome,
-  recordSeriesLeadRun,
-  recordSnapshot,
-  staleCreatives,
-  clearLegacyDirtyMarker
-};
-//# sourceMappingURL=chunk-L4LLNGJG.js.map

package/dist/chunk-L4LLNGJG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/canvas/render-state.ts"],"sourcesContent":["import { mkdir, readdir, readFile, rm, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { isSourceStale } from \"@baker/api\";\nimport type { LastFix } from \"./static-edit.ts\";\nimport type { PictureRecord } from \"./static-fix.ts\";\nimport { unsuppliedPlaceholderAssets } from \"./placeholders.ts\";\nimport { type PreparedCanvas, prepareCanvas } from \"./prepare-canvas.ts\";\n\n/**\n * What this workspace last rendered, per creative: `canvas/.rendered/<slug>.json`.\n *\n * \"Edited since its last render\" is the source fingerprint (`computeSourceSha`) now,\n * compared with the fingerprint the last completed render recorded here. It replaces the\n * `canvas/.dirty` marker a PostToolUse hook used to drop, which only saw the Write and\n * Edit tools touching `*.canvas.json` / `prompt.json`: an edit to a scene file, a\n * composition, or anything made through the shell slipped past it, and the Stop hook and\n * the `validate-creative-renders` gate let a stale preview ship.\n *\n * Two facts are kept apart:\n * - `rendered`: the source a COMPLETED render drew, and its run id;\n * - `attempted`: the source the last `baker canvas run` started on, whatever came of it.\n *   A render that fails on exactly this source is not asked for again until the source\n *   moves, so a canvas that cannot render never loops the agent.\n *\n * Lives under the gitignored `canvas/` outputs root of the workspace the canvas belongs\n * to (never `--outputs-dir`), so the CLI and the scaffold hooks always agree on the path.\n * A fresh workspace has no record, and a creative with none is not stale: there is no\n * preview of it in this workspace to be out of date.\n */\nexport const RENDER_STATE_DIR = \".rendered\";\n\nexport type RenderState = {\n  rendered?: { sourceSha: string; runId: string; at: number };\n  attempted?: { sourceSha: string; at: number };\n  /** The last portable run snapshot uploaded for this creative (see `run-snapshot.ts`). */\n  snapshot?: { identity: string; url: string };\n  /** A static ad's prompt.json as the completed render drew it: a later edit of only its words or colours renders as an edit of that version (`static-edit.ts`). */\n  prompt?: unknown;\n  /** The `--fix` (or edit) the completed render ran, and the blocking defects it left: the same fix is never run again. */\n  lastFix?: LastFix;\n  /** The blocking defects the review of the completed render named: what a fix of it is measured against. */\n  blocking?: string[];\n  /** How the completed render's picture came to be, where its canvas would not say (`static-fix.ts`). */\n  picture?: PictureRecord;\n  /**\n   * An ad of a series: the version of its lead its last registered run was made from, finished or not\n   * (`series-member.ts`). A run that fails after it is registered is not a new ask when retried.\n   */\n  seriesLeadRun?: string;\n};\n\nfunction statePath(canvasRoot: string, slug: string): string {\n  return path.join(canvasRoot, RENDER_STATE_DIR, `${slug}.json`);\n}\n\nexport async function readRenderState(canvasRoot: string, slug: string): Promise<RenderState> {\n  try {\n    const parsed = JSON.parse(await readFile(statePath(canvasRoot, slug), \"utf8\")) as RenderState;\n    return parsed && typeof parsed === \"object\" ? parsed : {};\n  } catch {\n    return {};\n  }\n}\n\n/** The version (run id) a creative shows in this workspace: its last completed render; null before one. */\nexport async function latestVersion(canvasRoot: string, slug: string): Promise<string | null> {\n  return (await readRenderState(canvasRoot, slug)).rendered?.runId ?? null;\n}\n\n/** Merge `patch` into the record. Best-effort: freshness is advisory, a render never fails over it. */\nasync function updateRenderState(canvasRoot: string, slug: string, patch: Partial<RenderState>): Promise<void> {\n  try {\n    const next = { ...(await readRenderState(canvasRoot, slug)), ...patch };\n    await mkdir(path.join(canvasRoot, RENDER_STATE_DIR), { recursive: true });\n    await writeFile(statePath(canvasRoot, slug), `${JSON.stringify(next, null, 2)}\\n`, \"utf8\");\n  } catch {\n    // Ignore: at worst the Stop hook asks for one render too many or too few.\n  }\n}\n\nexport async function recordRenderAttempt(canvasRoot: string, slug: string, sourceSha: string | undefined): Promise<void> {\n  if (!sourceSha) return;\n  await updateRenderState(canvasRoot, slug, { attempted: { sourceSha, at: Date.now() } });\n}\n\nexport async function recordRendered(\n  canvasRoot: string,\n  slug: string,\n  sourceSha: string | undefined,\n  runId: string,\n  drawn: { prompt?: unknown; lastFix?: LastFix; picture?: PictureRecord; seriesLeadRun?: string } = {},\n): Promise<void> {\n  if (!sourceSha) return;\n  await updateRenderState(canvasRoot, slug, {\n    rendered: { sourceSha, runId, at: Date.now() },\n    ...(drawn.prompt !== undefined ? { prompt: drawn.prompt } : {}),\n    lastFix: drawn.lastFix,\n    picture: drawn.picture,\n    ...(drawn.seriesLeadRun ? { seriesLeadRun: drawn.seriesLeadRun } : {}),\n  });\n}\n\n/** What the review of a completed render found blocking, and the fix the render ran, if one. */\nexport async function recordReviewOutcome(\n  canvasRoot: string,\n  slug: string,\n  outcome: { blocking: string[]; lastFix?: LastFix },\n): Promise<void> {\n  await updateRenderState(canvasRoot, slug, outcome);\n}\n\n/** The version of its lead a series ad's run was registered from: written before the run renders. */\nexport async function recordSeriesLeadRun(canvasRoot: string, slug: string, leadRunId: string): Promise<void> {\n  await updateRenderState(canvasRoot, slug, { seriesLeadRun: leadRunId });\n}\n\nexport async function recordSnapshot(canvasRoot: string, slug: string, snapshot: RenderState[\"snapshot\"]): Promise<void> {\n  await updateRenderState(canvasRoot, slug, { snapshot });\n}\n\n/**\n * Whether the preview in this workspace no longer shows the source: it was rendered, the\n * source has moved since (`isSourceStale`: a render fingerprinted by an older rule never\n * is), and no render of the source as it is now was attempted yet.\n */\nexport function isRenderStale(state: RenderState, currentSourceSha: string): boolean {\n  if (!state.rendered) return false;\n  if (!isSourceStale(currentSourceSha, state.rendered.sourceSha)) return false;\n  return state.attempted?.sourceSha !== currentSourceSha;\n}\n\n/** `sourceSha` is the source as it stands now: what a render of it would record. */\nexport type StaleCreative = { slug: string; canvasPath: string; renderedRunId: string; sourceSha: string };\n\n/**\n * Every renderable creative in the workspace whose preview is stale. A canvas that still\n * has an unfilled `[TODO]` asset slot is skipped: the agent is mid-build, and a half-built\n * creative must never be pushed to render. The source is fingerprinted the way a render\n * and the dashboard sync fingerprint it (`prepareCanvas`, read-only), so the three never\n * disagree about what is stale. `canvasPath` is workspace-relative.\n */\nexport async function staleCreatives(workspaceRoot: string): Promise<StaleCreative[]> {\n  const creativesDir = path.join(workspaceRoot, \"src\", \"creatives\");\n  const canvasRoot = path.join(workspaceRoot, \"canvas\");\n  let slugs: string[];\n  try {\n    slugs = (await readdir(creativesDir, { withFileTypes: true })).filter((d) => d.isDirectory()).map((d) => d.name);\n  } catch {\n    return [];\n  }\n  const stale: StaleCreative[] = [];\n  for (const slug of slugs.sort()) {\n    const state = await readRenderState(canvasRoot, slug);\n    if (!state.rendered) continue;\n    const canvasPath = path.join(creativesDir, slug, `${slug}.canvas.json`);\n    let prepared: PreparedCanvas;\n    try {\n      prepared = await prepareCanvas(canvasPath, { write: false });\n    } catch {\n      continue; // Gone, renamed, or mid-edit invalid JSON: the next check reads it again.\n    }\n    if (unsuppliedPlaceholderAssets(prepared.fileGraph).length > 0) continue;\n    const current = prepared.sourceSha;\n    if (!current || !isRenderStale(state, current)) continue;\n    stale.push({\n      slug,\n      canvasPath: path.relative(workspaceRoot, canvasPath).split(path.sep).join(\"/\"),\n      renderedRunId: state.rendered.runId,\n      sourceSha: current,\n    });\n  }\n  return stale;\n}\n\n/**\n * Remove the `canvas/.dirty/<slug>.json` marker an older scaffold's PostToolUse hook wrote.\n * Nothing in a current scaffold reads it, but a client repo can run this CLI before its\n * scaffold sync lands, and there the old Stop hook and verify gate still read the marker:\n * clearing it on a render attempt, as the CLI always did, keeps that gate from blocking\n * forever. Delete once every client runs a scaffold without `nudge-canvas-rerender`.\n */\nexport async function clearLegacyDirtyMarker(canvasRoot: string, slug: string): Promise<void> {\n  await rm(path.join(canvasRoot, \".dirty\", `${slug}.json`), { force: true }).catch(() => undefined);\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,OAAO,SAAS,UAAU,IAAI,iBAAiB;AACxD,OAAO,UAAU;AA4BV,IAAM,mBAAmB;AAsBhC,SAAS,UAAU,YAAoB,MAAsB;AAC3D,SAAO,KAAK,KAAK,YAAY,kBAAkB,GAAG,IAAI,OAAO;AAC/D;AAEA,eAAsB,gBAAgB,YAAoB,MAAoC;AAC5F,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,MAAM,SAAS,UAAU,YAAY,IAAI,GAAG,MAAM,CAAC;AAC7E,WAAO,UAAU,OAAO,WAAW,WAAW,SAAS,CAAC;AAAA,EAC1D,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAGA,eAAsB,cAAc,YAAoB,MAAsC;AAC5F,UAAQ,MAAM,gBAAgB,YAAY,IAAI,GAAG,UAAU,SAAS;AACtE;AAGA,eAAe,kBAAkB,YAAoB,MAAc,OAA4C;AAC7G,MAAI;AACF,UAAM,OAAO,EAAE,GAAI,MAAM,gBAAgB,YAAY,IAAI,GAAI,GAAG,MAAM;AACtE,UAAM,MAAM,KAAK,KAAK,YAAY,gBAAgB,GAAG,EAAE,WAAW,KAAK,CAAC;AACxE,UAAM,UAAU,UAAU,YAAY,IAAI,GAAG,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA,GAAM,MAAM;AAAA,EAC3F,QAAQ;AAAA,EAER;AACF;AAEA,eAAsB,oBAAoB,YAAoB,MAAc,WAA8C;AACxH,MAAI,CAAC,UAAW;AAChB,QAAM,kBAAkB,YAAY,MAAM,EAAE,WAAW,EAAE,WAAW,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;AACxF;AAEA,eAAsB,eACpB,YACA,MACA,WACA,OACA,QAAkG,CAAC,GACpF;AACf,MAAI,CAAC,UAAW;AAChB,QAAM,kBAAkB,YAAY,MAAM;AAAA,IACxC,UAAU,EAAE,WAAW,OAAO,IAAI,KAAK,IAAI,EAAE;AAAA,IAC7C,GAAI,MAAM,WAAW,SAAY,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;AAAA,IAC7D,SAAS,MAAM;AAAA,IACf,SAAS,MAAM;AAAA,IACf,GAAI,MAAM,gBAAgB,EAAE,eAAe,MAAM,cAAc,IAAI,CAAC;AAAA,EACtE,CAAC;AACH;AAGA,eAAsB,oBACpB,YACA,MACA,SACe;AACf,QAAM,kBAAkB,YAAY,MAAM,OAAO;AACnD;AAGA,eAAsB,oBAAoB,YAAoB,MAAc,WAAkC;AAC5G,QAAM,kBAAkB,YAAY,MAAM,EAAE,eAAe,UAAU,CAAC;AACxE;AAEA,eAAsB,eAAe,YAAoB,MAAc,UAAkD;AACvH,QAAM,kBAAkB,YAAY,MAAM,EAAE,SAAS,CAAC;AACxD;AAOO,SAAS,cAAc,OAAoB,kBAAmC;AACnF,MAAI,CAAC,MAAM,SAAU,QAAO;AAC5B,MAAI,CAAC,cAAc,kBAAkB,MAAM,SAAS,SAAS,EAAG,QAAO;AACvE,SAAO,MAAM,WAAW,cAAc;AACxC;AAYA,eAAsB,eAAe,eAAiD;AACpF,QAAM,eAAe,KAAK,KAAK,eAAe,OAAO,WAAW;AAChE,QAAM,aAAa,KAAK,KAAK,eAAe,QAAQ;AACpD,MAAI;AACJ,MAAI;AACF,aAAS,MAAM,QAAQ,cAAc,EAAE,eAAe,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI;AAAA,EACjH,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACA,QAAM,QAAyB,CAAC;AAChC,aAAW,QAAQ,MAAM,KAAK,GAAG;AAC/B,UAAM,QAAQ,MAAM,gBAAgB,YAAY,IAAI;AACpD,QAAI,CAAC,MAAM,SAAU;AACrB,UAAM,aAAa,KAAK,KAAK,cAAc,MAAM,GAAG,IAAI,cAAc;AACtE,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,cAAc,YAAY,EAAE,OAAO,MAAM,CAAC;AAAA,IAC7D,QAAQ;AACN;AAAA,IACF;AACA,QAAI,4BAA4B,SAAS,SAAS,EAAE,SAAS,EAAG;AAChE,UAAM,UAAU,SAAS;AACzB,QAAI,CAAC,WAAW,CAAC,cAAc,OAAO,OAAO,EAAG;AAChD,UAAM,KAAK;AAAA,MACT;AAAA,MACA,YAAY,KAAK,SAAS,eAAe,UAAU,EAAE,MAAM,KAAK,GAAG,EAAE,KAAK,GAAG;AAAA,MAC7E,eAAe,MAAM,SAAS;AAAA,MAC9B,WAAW;AAAA,IACb,CAAC;AAAA,EACH;AACA,SAAO;AACT;AASA,eAAsB,uBAAuB,YAAoB,MAA6B;AAC5F,QAAM,GAAG,KAAK,KAAK,YAAY,UAAU,GAAG,IAAI,OAAO,GAAG,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM,MAAM,MAAS;AAClG;","names":[]}

package/dist/chunk-LEGVJCL4.js

@@ -1,56 +0,0 @@
-import {
-  ApiError,
-  apiGet
-} from "./chunk-7ANWFQEA.js";
-import {
-  compactImage,
-  compactVideo,
-  writeJson
-} from "./chunk-ANYMWCST.js";
-
-// src/commands/mediaGroup.ts
-async function runMediaGroupLookup(input) {
-  if (!input.id && !input.groupKey) {
-    writeJson({
-      ok: false,
-      error: { code: "VALIDATION_ERROR", message: `Pass ${input.idLabel} or --group-key` }
-    });
-    process.exit(1);
-  }
-  try {
-    const query = new URLSearchParams();
-    if (input.id) query.set("id", input.id);
-    if (input.groupKey) query.set("groupKey", input.groupKey);
-    const data = await apiGet(`${input.path}?${query.toString()}`);
-    const images = data.images.map((image) => compactImage(image));
-    const videos = (data.videos ?? []).map((video) => compactVideo(video));
-    const count = images.length + videos.length;
-    writeJson({
-      ok: true,
-      data: {
-        groupKey: data.groupKey,
-        groupKind: data.groupKind ?? null,
-        // The caption or page title the whole set shares — often the only
-        // place the campaign is named.
-        groupTitle: data.groupTitle ?? null,
-        groupUrl: data.groupUrl ?? null,
-        count,
-        images,
-        videos
-      },
-      hints: count > 1 ? ["These arrived together and are ordered. Read them in sequence before using any one of them alone."] : void 0
-    });
-  } 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);
-  }
-}
-
-export {
-  runMediaGroupLookup
-};
-//# sourceMappingURL=chunk-LEGVJCL4.js.map

package/dist/chunk-LFMKBF6Q.js

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