@koda-sl/baker-cli 0.384.0 → 0.385.0-dev.f7ef4c7e1

package/dist/chunk-42DF5DF3.js

@@ -0,0 +1,304 @@
+import {
+  languageTag
+} from "./chunk-MYURCD23.js";
+import {
+  parseRefExpr
+} from "./chunk-ZJ7TQUCU.js";
+import {
+  AWARENESS_VALUES
+} from "./chunk-5HYSKH77.js";
+import {
+  collectAssetRefLikes,
+  isPersistedAssetRef
+} from "./chunk-3VXQYDJN.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-42DF5DF3.js.map

package/dist/chunk-42DF5DF3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/creative-definition.ts","../src/commands/canvas/run-record.ts"],"sourcesContent":["import { parseDocument } from \"yaml\";\nimport { AWARENESS_VALUES, type ViewerProfile } from \"../../viewer-profile.ts\";\nimport { languageTag } from \"../../language.ts\";\n\n// The scaffold's `creatives` collection (src/collections/creatives.ts) accepts exactly these;\n// `creative-definition.parity.test.ts` fails when the two lists drift. An unknown platform or\n// format degrades to the default rather than emitting a definition the collection would reject.\nexport const PLATFORM_VALUES = [\"meta\", \"google\", \"linkedin\", \"tiktok\", \"youtube\", \"x\", \"other\"] as const;\nexport const FORMAT_VALUES = [\"1:1\", \"4:5\", \"9:16\", \"16:9\", \"1.91:1\"] as const;\nexport const CREATIVE_KIND_VALUES = [\"static\", \"video\"] as const;\nexport const CREATIVE_STATUS_VALUES = [\"draft\", \"rendered\", \"published\", \"archived\"] as const;\nexport const SOURCE_KIND_VALUES = [\"image\", \"video\"] as const;\nexport const EVIDENCE_VALUES = [\"observed\", \"interpreted\", \"hypothesized\", \"generated\"] as const;\n\n/** Frontmatter + body for a creative's `_definition.md`, mirroring the scaffold `creatives` collection schema. */\nexport type CreativeSourceKind = (typeof SOURCE_KIND_VALUES)[number];\n\nexport type CreativeDefinitionInput = {\n  title: string;\n  kind: (typeof CREATIVE_KIND_VALUES)[number];\n  platform: string;\n  formats: string[];\n  status?: (typeof CREATIVE_STATUS_VALUES)[number];\n  sourceReferenceUrl?: string;\n  sourceAdvertiser?: string;\n  /** The library ad it adapted (`baker winning-ads` ids): what `baker_uses` in reference search counts. */\n  sourceAdId?: string;\n  sourcePlatform?: string;\n  sourceAdvertiserId?: string;\n  sourceKind?: CreativeSourceKind;\n  /** Repo-relative path to the committed source asset (e.g. \"references/original.jpg\"). */\n  sourcePath?: string;\n  /** The Meta ad set the ad is made for (`baker ads meta adsets`). */\n  targetAdSet?: string;\n  /** Who that ad set reaches (`baker ads meta adsets --audience`), or the viewer read from the Knowledge. */\n  viewer?: ViewerProfile;\n  description?: string;\n};\n\n/** Title-case a slug: \"factorial-hr-4x5\" -> \"Factorial Hr 4x5\". Falls back to the slug when empty. */\nexport function titleFromSlug(slug: string): string {\n  const title = slug\n    .split(\"-\")\n    .filter(Boolean)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n  return title || slug;\n}\n\n/** Coerce a platform flag to a collection-valid value (default \"meta\"). */\nexport function resolvePlatform(platform: string | undefined): string {\n  const value = platform?.trim();\n  return value && (PLATFORM_VALUES as readonly string[]).includes(value) ? value : \"meta\";\n}\n\n/** A single-format array from the resolved aspect ratio (default [\"4:5\"] when unknown). */\nexport function resolveFormats(aspect: string | undefined): string[] {\n  const value = aspect?.trim();\n  return value && (FORMAT_VALUES as readonly string[]).includes(value) ? [value] : [\"4:5\"];\n}\n\n/** A deduped list of collection-valid formats (default [\"4:5\"] when none are recognized). */\nexport function resolveFormatList(formats: readonly string[]): string[] {\n  const valid = [...new Set(formats.map((f) => f.trim()))].filter((f) =>\n    (FORMAT_VALUES as readonly string[]).includes(f),\n  );\n  return valid.length > 0 ? valid : [\"4:5\"];\n}\n\n/** Best-effort human summary from an image_describe blueprint's ad_intent (for the definition body). */\nexport function describeBlueprintIntent(blueprint: unknown): string | undefined {\n  const intent = (blueprint as { ad_intent?: unknown } | null)?.ad_intent;\n  if (typeof intent === \"string\" && intent.trim()) return intent.trim();\n  if (intent && typeof intent === \"object\") {\n    const summary = (intent as { summary?: unknown }).summary ?? (intent as { feeling?: unknown }).feeling;\n    if (typeof summary === \"string\" && summary.trim()) return summary.trim();\n  }\n  return undefined;\n}\n\n// Double-quoted YAML scalar via JSON.stringify — valid YAML that survives colons, quotes, and unicode.\nfunction yamlScalar(value: string): string {\n  return JSON.stringify(value);\n}\n\n/** Render `_definition.md` (YAML frontmatter + body) for a creative. */\nexport function buildCreativeDefinition(input: CreativeDefinitionInput): string {\n  const lines = [\"---\", `title: ${yamlScalar(input.title)}`, `kind: ${input.kind}`, `platform: ${input.platform}`];\n  lines.push(`formats: [${input.formats.map(yamlScalar).join(\", \")}]`);\n  lines.push(`status: ${input.status ?? \"draft\"}`);\n  if (input.sourceReferenceUrl) lines.push(`sourceReferenceUrl: ${yamlScalar(input.sourceReferenceUrl)}`);\n  if (input.sourceAdvertiser) lines.push(`sourceAdvertiser: ${yamlScalar(input.sourceAdvertiser)}`);\n  if (input.sourceAdvertiserId) lines.push(`sourceAdvertiserId: ${yamlScalar(input.sourceAdvertiserId)}`);\n  if (input.sourceAdId) lines.push(`sourceAdId: ${yamlScalar(input.sourceAdId)}`);\n  if (input.sourcePlatform) lines.push(`sourcePlatform: ${input.sourcePlatform}`);\n  if (input.sourceKind) lines.push(`sourceKind: ${input.sourceKind}`);\n  if (input.sourcePath) lines.push(`sourcePath: ${yamlScalar(input.sourcePath)}`);\n  if (input.targetAdSet) lines.push(`targetAdSet: ${yamlScalar(input.targetAdSet)}`);\n  // A JSON object is a YAML flow mapping: one line, and every string in it quoted.\n  if (input.viewer) lines.push(`viewer: ${JSON.stringify(input.viewer)}`);\n  lines.push(\"---\", \"\");\n  lines.push(input.description?.trim() || `${input.title} — canvas-built ${input.kind} ad for ${input.platform}.`);\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n/** The library ids a `_definition.md` names, as `DefinitionSourceFields`. */\nexport type DefinitionSourceFields = {\n  sourceAdId?: string;\n  sourcePlatform?: string;\n  sourceAdvertiserId?: string;\n};\n\nconst SOURCE_FIELD_KEYS = [\"sourceAdId\", \"sourcePlatform\", \"sourceAdvertiserId\"] as const;\n\n/**\n * Read the library ids back out of a `_definition.md`, so a sync after the agent edited the\n * file still carries them. Tolerant: no frontmatter, a mid-edit parse error, or a non-string\n * value yields nothing for that field rather than a failed sync.\n */\nexport function parseDefinitionSourceFields(raw: string): DefinitionSourceFields {\n  const match = raw.match(/^---\\r?\\n([\\s\\S]*?\\r?\\n)?---/);\n  if (!match) return {};\n  const doc = parseDocument(match[1] ?? \"\");\n  if (doc.errors.length > 0) return {};\n  const fields: DefinitionSourceFields = {};\n  for (const key of SOURCE_FIELD_KEYS) {\n    const value = doc.get(key);\n    if (typeof value === \"string\" && value.trim()) fields[key] = value.trim();\n  }\n  return fields;\n}\n\n/** Why the creative exists, as a `_definition.md` states it (its `idea` sent as `ideaSlug`). */\nexport type DefinitionStrategyFields = {\n  ideaSlug?: string;\n  message?: string;\n  evidence?: (typeof EVIDENCE_VALUES)[number];\n  angle?: string;\n  persona?: string;\n  awareness?: (typeof AWARENESS_VALUES)[number];\n  hypothesis?: string;\n  /** The lead ad of the series this creative is one of (`series`): its picture is the lead's with other words. */\n  seriesLead?: string;\n  /** The language its words are in (`language`), as a canonical BCP-47 tag (`es-MX`): a translation's. */\n  language?: string;\n};\n\nfunction oneOf<T extends string>(values: readonly T[], value: string | undefined): T | undefined {\n  return values.find((allowed) => allowed === value);\n}\n\n/**\n * Read the creative's strategy back out of a `_definition.md`, so the dashboard holds it from the\n * first sync rather than from Publish. Tolerant like `parseDefinitionSourceFields`; an `evidence`\n * or `awareness` the collection would reject is dropped rather than sent.\n */\nexport function parseDefinitionStrategyFields(raw: string): DefinitionStrategyFields {\n  const match = raw.match(/^---\\r?\\n([\\s\\S]*?\\r?\\n)?---/);\n  if (!match) return {};\n  const doc = parseDocument(match[1] ?? \"\");\n  if (doc.errors.length > 0) return {};\n  const text = (key: string): string | undefined => {\n    const value = doc.get(key);\n    return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n  };\n  const ideaSlug = text(\"idea\");\n  const message = text(\"message\");\n  const evidence = oneOf(EVIDENCE_VALUES, text(\"evidence\"));\n  const angle = text(\"angle\");\n  const persona = text(\"persona\");\n  const awareness = oneOf(AWARENESS_VALUES, text(\"awareness\"));\n  const hypothesis = text(\"hypothesis\");\n  const seriesLead = text(\"series\");\n  const language = languageTag(text(\"language\") ?? \"\");\n  return {\n    ...(seriesLead ? { seriesLead } : {}),\n    ...(language ? { language } : {}),\n    ...(ideaSlug ? { ideaSlug } : {}),\n    ...(message ? { message } : {}),\n    ...(evidence ? { evidence } : {}),\n    ...(angle ? { angle } : {}),\n    ...(persona ? { persona } : {}),\n    ...(awareness ? { awareness } : {}),\n    ...(hypothesis ? { hypothesis } : {}),\n  };\n}\n\n/** Where a definition places its creative in a series: null for a field it does not name. */\nexport type DefinitionSeriesPlace = { seriesLead: string | null; language: string | null };\n\n/**\n * The series lead and language a `_definition.md` names, each null when it names none, so a\n * sync can tell the backend the creative left its series. Null when the front matter cannot be\n * read (none, or mid-edit invalid YAML): the sync then says nothing and the backend keeps what it has.\n */\nexport function parseDefinitionSeriesPlace(raw: string): DefinitionSeriesPlace | null {\n  const match = raw.match(/^---\\r?\\n([\\s\\S]*?\\r?\\n)?---/);\n  if (!match || parseDocument(match[1] ?? \"\").errors.length > 0) return null;\n  const { seriesLead, language } = parseDefinitionStrategyFields(raw);\n  return { seriesLead: seriesLead ?? null, language: language ?? null };\n}\n\n/** Who a `_definition.md` says the ad is for: its `targetAdSet` and its recorded `viewer`, unchecked. */\nexport type DefinitionViewerFields = { targetAdSet?: string; viewer?: unknown };\n\n/** Read `targetAdSet` and `viewer` back out of a `_definition.md`; tolerant like `parseDefinitionSourceFields`. */\nexport function parseDefinitionViewerFields(raw: string): DefinitionViewerFields {\n  const match = raw.match(/^---\\r?\\n([\\s\\S]*?\\r?\\n)?---/);\n  if (!match) return {};\n  const doc = parseDocument(match[1] ?? \"\");\n  if (doc.errors.length > 0) return {};\n  const data = doc.toJS() as { targetAdSet?: unknown; viewer?: unknown } | null;\n  const adSet = data?.targetAdSet;\n  const targetAdSet = typeof adSet === \"string\" || typeof adSet === \"number\" ? String(adSet).trim() : \"\";\n  return {\n    ...(targetAdSet ? { targetAdSet } : {}),\n    ...(data?.viewer !== undefined ? { viewer: data.viewer } : {}),\n  };\n}\n\n/**\n * Record the ad set an ad is for and the viewer it reaches in an existing `_definition.md`,\n * keeping every other field and the body. A file without frontmatter, or one mid-edit, is\n * returned as it is: the viewer is then read again from the ad set on the next run.\n */\nexport function setDefinitionViewer(raw: string, fields: { targetAdSet?: string; viewer?: ViewerProfile }): string {\n  const match = raw.match(/^---\\r?\\n([\\s\\S]*?\\r?\\n)?---/);\n  if (!match) return raw;\n  const doc = parseDocument(match[1] ?? \"\");\n  if (doc.errors.length > 0) return raw;\n  if (fields.targetAdSet) doc.set(\"targetAdSet\", fields.targetAdSet);\n  if (fields.viewer) doc.set(\"viewer\", doc.createNode(fields.viewer, { flow: true }));\n  return `---\\n${doc.toString()}---${raw.slice(match[0].length)}`;\n}\n","import path from \"node:path\";\nimport type { CanvasRunVerdict } from \"@baker/api\";\nimport type { NodeRunRecord, RunResult } from \"../../engine/engine/executor.ts\";\nimport { parseRefExpr } from \"../../engine/schema/canvas.ts\";\nimport { collectAssetRefLikes, isPersistedAssetRef } from \"../../engine/storage/remote-cache-store.ts\";\n\n// Mirrors of the backend intake caps (canvas/runRecords.ts) so an in-bounds\n// payload is sent even for pathological runs; the server re-caps defensively.\nconst MAX_RUN_NODES = 200;\nconst MAX_OUTPUTS_PER_NODE = 10;\nconst MAX_FINAL_OUTPUTS = 10;\n\nexport type RunRecordOutput = {\n  slot: string;\n  /** Variant identity from the collect terminal (branch/scene name) — slot stays the stable key. */\n  label?: string;\n  kind: \"image\" | \"video\" | \"audio\" | \"json\" | \"text\" | \"font\";\n  sha256: string;\n  url: string;\n  mime: string;\n  width?: number;\n  height?: number;\n  durationMs?: number;\n};\n\n/** Labels for a collect-terminated canvas: the collector's node id + one label per collected image. */\nexport type FinalOutputLabels = { nodeId: string; labels: (string | undefined)[] };\n\nexport type RunNodeStatus = \"pending\" | \"running\" | \"completed\" | \"failed\";\n\nexport type RunRecordNode = {\n  nodeId: string;\n  nodeType: string;\n  cached: boolean;\n  credits: number;\n  durationMs: number;\n  outputs: RunRecordOutput[];\n  /** Upstream node ids ($ref edges) — lets the dashboard render the workflow graph. */\n  deps?: string[];\n  status?: RunNodeStatus;\n  /** Compact params excerpt (prompt text preferred) for graph-node legibility. */\n  paramsPreview?: string;\n  /** Why this node failed — the real upstream status/provider — set only on `status: \"failed\"`. */\n  error?: RunNodeError;\n  /** The node's job, from its `tags.role` (e.g. `static_variants`), so readers never parse node ids. */\n  role?: string;\n};\n\n/** Display-ready per-node failure detail. Mirrors the engine's `NodeFailureDetail`. */\nexport type RunNodeError = {\n  message: string;\n  code?: string;\n  provider?: string;\n  retryable?: boolean;\n};\n\n/** Run attribution stamped on every record post (progress, terminal, initial). */\nexport type RunRecordMeta = {\n  creativeSlug?: string;\n  canvasPath?: string;\n  canvasSha?: string;\n  /** Content sha of the rendered source (canvas.json + prompt.json) — powers the dashboard staleness signal. */\n  sourceSha?: string;\n  chatId?: string;\n  /** R2 manifest of the executed canvas + its local file refs — first-write-wins server-side. */\n  canvasSnapshotUrl?: string;\n  /** R2 copy of the graph this run executes (every node's declaration): what a correction elsewhere grows on. */\n  graphUrl?: string;\n  /** What the render review found, so it outlives the terminal it was printed to. */\n  review?: { severity: \"blocking\" | \"warning\"; what: string; scene?: string }[];\n  /**\n   * What the review's own model calls cost, as the gateway reported them.\n   *\n   * The review calls OpenRouter from the Runtime — that is where the finished video is,\n   * and shipping 60MB through Convex to reach the same gateway would buy nothing — so\n   * this record is what carries the spend back to where it is billed. `costUsd` is\n   * OpenRouter's own `usage.cost`, relayed rather than computed: the sandbox never\n   * prices anything, which is what makes it safe for the model id to float.\n   */\n  reviewUsage?: { model: string; inputTokens: number; outputTokens: number; costUsd: number }[];\n  /** What the render review said (`@baker/api` CANVAS_RUN_VERDICTS), and whether the run may be shown as a version. */\n  verdict?: CanvasRunVerdict;\n  presentable?: boolean;\n  /** An ad of a series made again from a new version of its lead: a new version of the ad, not a retry. */\n  newAsk?: boolean;\n};\n\nexport type RunRecordPayload = {\n  runId: string;\n  /** `awaiting_approval`: stopped on purpose at a `--until` checkpoint, resumable with the same run id. */\n  status: \"running\" | \"completed\" | \"failed\" | \"awaiting_approval\";\n  errorMessage?: string;\n  stats: { totalNodes: number; cachedNodes: number; totalCredits: number; durationMs: number };\n  nodes: RunRecordNode[];\n  finalOutputs?: RunRecordOutput[];\n  /**\n   * What the render review found, sent with the run that produced it.\n   *\n   * Without this the findings existed only in the CLI's stdout — visible to the agent\n   * for one turn and to nobody afterwards. A check whose result leaves no trace cannot\n   * be read back, compared between runs, or shown to the person the ad is for, and is\n   * indistinguishable from a check that never ran.\n   */\n  review?: { severity: \"blocking\" | \"warning\"; what: string; scene?: string }[];\n  /** Graceful-abort flush (SIGINT/SIGTERM): terminal but resumable — the backend keeps the row adoptable. */\n  interrupted?: boolean;\n} & RunRecordMeta;\n\n/** Per-node plan facts (edges + params preview) captured from the engine's plan event. */\nexport type RunPlanInfo = Map<string, { deps: string[]; paramsPreview?: string; role?: string }>;\n\n// Mirrors the backend's CREATIVE_SLUG_MAX_LENGTH — an over-long slug would\n// 400 the whole run record, so attribution is dropped instead.\nconst MAX_CREATIVE_SLUG_LENGTH = 100;\n\n/**\n * A canvas under the repo convention `src/creatives/{slug}/` belongs to that\n * creative; its runs become the creative's generation history. Returns null\n * for canvases anywhere else (and for slugs the backend would reject).\n */\nexport function creativeSlugFromCanvasPath(filePath: string): string | null {\n  const normalized = filePath.split(path.sep).join(\"/\");\n  const match = normalized.match(/(?:^|\\/)src\\/creatives\\/([a-z0-9](?:[a-z0-9-]*[a-z0-9])?)\\//);\n  const slug = match?.[1] ?? null;\n  return slug && slug.length <= MAX_CREATIVE_SLUG_LENGTH ? slug : null;\n}\n\n/**\n * Best-effort variant labels from a not-yet-validated canvas: when the declared\n * output is a `collect` node, each final inherits the node's explicit\n * `params.labels[i]`, else the producer node id parsed from the raw `$ref` it\n * collects (`$ref:gen_billboard_03.images#0` → `gen_billboard_03`). Null for\n * every other canvas shape — single-output runs stay unlabeled.\n */\nexport function finalOutputLabelsFromCanvas(parsed: unknown): FinalOutputLabels | null {\n  const canvas = parsed as { nodes?: unknown; output?: { node?: unknown } } | null;\n  const outputNodeId = canvas?.output?.node;\n  if (typeof outputNodeId !== \"string\" || !Array.isArray(canvas?.nodes)) return null;\n  const node = canvas.nodes.find((n) => (n as { id?: unknown })?.id === outputNodeId) as\n    | { type?: unknown; inputs?: { images?: unknown }; params?: { labels?: unknown } }\n    | undefined;\n  if (node?.type !== \"collect\") return null;\n  const explicit = node.params?.labels;\n  if (Array.isArray(explicit) && explicit.every((l) => typeof l === \"string\")) {\n    return { nodeId: outputNodeId, labels: explicit };\n  }\n  const images = node.inputs?.images;\n  if (!Array.isArray(images)) return null;\n  const labels = images.map((entry) => {\n    if (typeof entry !== \"string\") return undefined;\n    return parseRefExpr(entry)?.nodeId;\n  });\n  return { nodeId: outputNodeId, labels };\n}\n\nconst OUTPUT_KINDS = new Set([\"image\", \"video\", \"audio\", \"json\", \"text\", \"font\"]);\n\nfunction toRecordOutput(slot: string, value: unknown, label?: string): RunRecordOutput | null {\n  const refs = collectAssetRefLikes(value);\n  const ref = refs.length === 1 ? refs[0] : null;\n  if (!ref || !isPersistedAssetRef(ref)) return null;\n  const kind = typeof ref.kind === \"string\" && OUTPUT_KINDS.has(ref.kind) ? ref.kind : null;\n  if (!kind) return null;\n  return {\n    slot,\n    label,\n    kind: kind as RunRecordOutput[\"kind\"],\n    sha256: ref.sha256,\n    url: ref.url,\n    mime: ref.mime,\n    width: typeof ref.width === \"number\" ? ref.width : undefined,\n    height: typeof ref.height === \"number\" ? ref.height : undefined,\n    durationMs: typeof ref.duration_ms === \"number\" ? ref.duration_ms : undefined,\n  };\n}\n\n/**\n * Flatten one node's outputs into record entries. Single refs keep their slot\n * name; arrays become `slot#i`. Values without a persisted ref (plain JSON\n * manifests, refs whose upload failed) are dropped — every stored output must\n * be renderable from R2.\n */\nexport function nodeOutputsToRecord(\n  nodeOutputs: Record<string, unknown>,\n  labels?: (string | undefined)[],\n): RunRecordOutput[] {\n  const out: RunRecordOutput[] = [];\n  for (const [slot, value] of Object.entries(nodeOutputs)) {\n    if (Array.isArray(value)) {\n      value.forEach((item, i) => {\n        const rec = toRecordOutput(`${slot}#${i}`, item, labels?.[i]);\n        if (rec) out.push(rec);\n      });\n    } else {\n      const rec = toRecordOutput(slot, value);\n      if (rec) out.push(rec);\n    }\n  }\n  return out.slice(0, MAX_OUTPUTS_PER_NODE);\n}\n\nfunction finalOutputsToRecord(output: unknown, labels?: (string | undefined)[]): RunRecordOutput[] {\n  if (Array.isArray(output)) {\n    return output\n      .map((item, i) => toRecordOutput(`final#${i}`, item, labels?.[i]))\n      .filter((rec): rec is RunRecordOutput => rec !== null)\n      .slice(0, MAX_FINAL_OUTPUTS);\n  }\n  const rec = toRecordOutput(\"final\", output);\n  return rec ? [rec] : [];\n}\n\n/** Each delivered size's local file, keyed by its label (or `final#i`), so the agent opens it with Read. */\nexport function finalFiles(output: unknown, labels?: (string | undefined)[]): Record<string, string> {\n  const items = Array.isArray(output) ? output : [output];\n  const files: Record<string, string> = {};\n  items.forEach((item, i) => {\n    const ref = collectAssetRefLikes(item)[0];\n    if (ref && typeof ref.path === \"string\") files[labels?.[i] ?? `final#${i}`] = ref.path;\n  });\n  return files;\n}\n\nexport function buildRunRecord(\n  result: Pick<RunResult, \"run_id\" | \"output\" | \"outputs_by_node\" | \"stats\"> & { node_runs: NodeRunRecord[] },\n  meta: RunRecordMeta,\n  plan?: RunPlanInfo,\n  finalLabels?: FinalOutputLabels,\n): RunRecordPayload {\n  const nodes = result.node_runs.slice(0, MAX_RUN_NODES).map((run): RunRecordNode => {\n    const planned = plan?.get(run.node_id);\n    return {\n      nodeId: run.node_id,\n      nodeType: run.node_type,\n      cached: run.cached,\n      credits: run.credits,\n      durationMs: run.duration_ms,\n      outputs: nodeOutputsToRecord(\n        result.outputs_by_node[run.node_id] ?? {},\n        run.node_id === finalLabels?.nodeId ? finalLabels.labels : undefined,\n      ),\n      deps: planned?.deps,\n      status: plan ? \"completed\" : undefined,\n      paramsPreview: planned?.paramsPreview,\n      ...(planned?.role !== undefined ? { role: planned.role } : {}),\n    };\n  });\n  const finalOutputs = finalOutputsToRecord(result.output, finalLabels?.labels);\n  return {\n    runId: result.run_id,\n    ...meta,\n    status: \"completed\",\n    stats: {\n      totalNodes: result.stats.total_nodes,\n      cachedNodes: result.stats.cached_nodes,\n      totalCredits: result.stats.total_credits,\n      durationMs: result.stats.duration_ms,\n    },\n    nodes,\n    finalOutputs: finalOutputs.length > 0 ? finalOutputs : undefined,\n    // Sent whenever the review RAN, empty list included. Sending it only when there\n    // were findings makes a clean render and an unreviewed one look identical in the\n    // record — which is the exact ambiguity this field was added to remove: proving a\n    // review had happened once meant re-running a cached canvas and reading raw JSON.\n    // Only the fields the backend keeps: a static review's typed fields (`kind`) stay in the CLI.\n    ...(meta.review\n      ? { review: meta.review.slice(0, 40).map(({ severity, what, scene }) => ({ severity, what, ...(scene ? { scene } : {}) })) }\n      : {}),\n  };\n}\n\n/**\n * The empty `running` record posted BEFORE layer 1 executes. This row is the\n * Convex-side in-flight marker: the reconciliation sweep and cross-sandbox\n * resume both key off it, so unlike the fire-and-forget progress stream it is\n * posted synchronously (with retries) at run start.\n */\nexport function buildInitialRunRecord(runId: string, meta: RunRecordMeta): RunRecordPayload {\n  return {\n    runId,\n    ...meta,\n    status: \"running\",\n    stats: { totalNodes: 0, cachedNodes: 0, totalCredits: 0, durationMs: 0 },\n    nodes: [],\n  };\n}\n\nexport function buildFailedRunRecord(runId: string, errorMessage: string, meta: RunRecordMeta): RunRecordPayload {\n  return {\n    runId,\n    ...meta,\n    status: \"failed\",\n    errorMessage: errorMessage.slice(0, 2000),\n    stats: { totalNodes: 0, cachedNodes: 0, totalCredits: 0, durationMs: 0 },\n    nodes: [],\n  };\n}\n"],"mappings":"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","names":["rec"]}

package/dist/chunk-44VXKO65.js

@@ -0,0 +1,106 @@
+import {
+  apiGet
+} from "./chunk-CUL3VB4L.js";
+
+// src/commands/testimonials/emptyCorpusHints.ts
+function resolveEmptyReason({
+  resultCount,
+  activeFilters,
+  sourceCount
+}) {
+  if (resultCount > 0) {
+    return null;
+  }
+  if (activeFilters.length > 0) {
+    return "filtered_out";
+  }
+  return sourceCount === 0 ? "no_corpus_connected" : "corpus_empty";
+}
+var NO_CORPUS_EXIT = "Testimonials are ingested from the client's public review pages \u2014 an agent cannot write one \u2014 so no rewording will find quotes. If the user named the client's own review page (Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store, Google Play), add it with `baker testimonials sources add <link>` \u2014 its reviews arrive over the next minutes, not in this turn. Stop searching and source proof another way: a result or case study the client already published, a named-customer logo (`baker images logo`), or a founder claim attributed as a claim. Otherwise ship without a testimonial block and file the gap: `baker actions create --name \"Collect customer quotes for <page>\" --priority medium --tags <slug>`. Never invent, paraphrase-into-existence, or pad with unrelated praise.";
+function emptyReasonDetail(reason, sourceCount, activeFilters) {
+  if (reason === "filtered_out") {
+    return `No rows matched, and ${activeFilters.join(", ")} narrowed this read. The corpus was not checked \u2014 drop every filter to see whether the library itself is empty.`;
+  }
+  if (reason === "no_corpus_connected") {
+    return "This company has no review source connected \u2014 checked against its source list, not inferred from the empty result.";
+  }
+  return `${sourceCount} review source${sourceCount === 1 ? " is" : "s are"} connected but hold no testimonials yet \u2014 the source is there, the rows are not. Ingestion may still be running.`;
+}
+function morePagesHint(resultCount, cursor) {
+  const found = resultCount === 0 ? "This page held no matches" : `This page held ${resultCount}`;
+  return `${found}, and the library continues past it \u2014 so this is one page, not the client's whole set. Do not report it as the corpus and do not conclude anything is missing from it. Read the next page with \`baker testimonials list --cursor ${cursor}\` (same filters), or go straight at the rows you want with \`baker testimonials search <query>\`.`;
+}
+function endOfWalkHint(command) {
+  const noun = command === "search" ? "results" : "rows";
+  return `That was the end of the library \u2014 no more ${noun} past the page before this one. Nothing here says the corpus is empty (the earlier pages held it), so answer from what those pages returned rather than re-reading.`;
+}
+async function measureEmptyCorpus({
+  command,
+  resultCount,
+  activeFilters,
+  nextCursor = null,
+  continued = false
+}) {
+  if (nextCursor) {
+    return { hints: [morePagesHint(resultCount, nextCursor)] };
+  }
+  if (resultCount > 0) {
+    return { hints: [] };
+  }
+  if (continued) {
+    return { hints: [endOfWalkHint(command)] };
+  }
+  if (activeFilters.length > 0) {
+    const reason2 = "filtered_out";
+    return {
+      hints: emptyCorpusHints({ command, reason: reason2, sourceCount: 0, activeFilters }),
+      empty: { reason: reason2, detail: emptyReasonDetail(reason2, 0, activeFilters) }
+    };
+  }
+  let sourceCount;
+  try {
+    const sources = await apiGet("/api/testimonials/sources");
+    sourceCount = Array.isArray(sources) ? sources.length : 0;
+  } catch {
+    return {
+      hints: [
+        "No rows, and the check for connected review sources failed \u2014 so this is NOT evidence that the client has no reviews. Do not record an absence you could not verify. Re-run once; if it fails again, say the library could not be read rather than that it is empty."
+      ]
+    };
+  }
+  const reason = resolveEmptyReason({ resultCount, activeFilters, sourceCount });
+  if (reason === null) {
+    return { hints: [] };
+  }
+  return {
+    hints: emptyCorpusHints({ command, reason, sourceCount, activeFilters }),
+    empty: { reason, detail: emptyReasonDetail(reason, sourceCount, activeFilters) }
+  };
+}
+function emptyCorpusHints({
+  command,
+  reason,
+  sourceCount,
+  activeFilters
+}) {
+  if (reason === null) {
+    return [];
+  }
+  if (reason === "filtered_out") {
+    return [
+      `No rows \u2014 ${activeFilters.join(", ")} narrowed this. Drop every filter and re-run once before touching the query; a filter combination and an empty library look identical from here.`
+    ];
+  }
+  const lead = command === "search" ? "No hits" : "No rows";
+  if (reason === "no_corpus_connected") {
+    return [`${lead}, and this company's source list is empty: there is no review corpus to search. ${NO_CORPUS_EXIT}`];
+  }
+  return [
+    `${lead}. ${sourceCount} review source${sourceCount === 1 ? " is" : "s are"} connected but no testimonials have landed yet \u2014 so this is a timing or ingestion gap, not a missing connection, and re-querying will not change it. Ingestion may still be running: say so rather than reporting the client has no reviews. ${NO_CORPUS_EXIT}`
+  ];
+}
+
+export {
+  measureEmptyCorpus
+};
+//# sourceMappingURL=chunk-44VXKO65.js.map

package/dist/chunk-44VXKO65.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/testimonials/emptyCorpusHints.ts"],"sourcesContent":["/**\n * Zero-result steering for the testimonial corpus.\n *\n * A bare `[]` reads as \"my query missed\" and the agent re-queries — three calls\n * to prove the same thing, in an audited run. It almost never means that here:\n * testimonials are ingested from the client's Google/Trustpilot reviews and an\n * agent cannot create one, so an empty library is a dead end no rewording opens.\n *\n * This module used to *assert* which of those it was, from `resultCount === 0`\n * alone: an unfiltered browse returning nothing was declared \"proof\" that the\n * company had no review corpus connected. It was never checked, and a company\n * with a connected source that simply holds no rows yet got told, confidently,\n * that it had no source at all. An agent then wrote that into the client's\n * knowledge vault as fact.\n *\n * So the reason is now measured against `GET /api/testimonials/sources` before\n * anything is claimed. `resolveEmptyReason` is the whole of that judgement and\n * is kept pure so it can be tested without a backend.\n */\n\nimport { apiGet } from \"../../client.ts\";\nimport type { EmptyEvidence } from \"../../output.ts\";\n\nexport type TestimonialQuery = \"search\" | \"list\";\n\n/**\n * Why a read came back empty.\n *\n * - `filtered_out`       — filters were applied; the corpus may be fine.\n * - `no_corpus_connected` — the company has no review source at all. Terminal.\n * - `corpus_empty`       — a source exists but holds no rows yet (still\n *                          ingesting, or the source genuinely has no reviews).\n */\nexport type EmptyCorpusReason = \"no_corpus_connected\" | \"corpus_empty\" | \"filtered_out\";\n\ninterface ResolveInput {\n  resultCount: number;\n  activeFilters: string[];\n  /** Rows from /api/testimonials/sources. */\n  sourceCount: number;\n}\n\nexport function resolveEmptyReason({\n  resultCount,\n  activeFilters,\n  sourceCount,\n}: ResolveInput): EmptyCorpusReason | null {\n  if (resultCount > 0) {\n    return null;\n  }\n  // Filters first: they explain the empty result without saying anything about\n  // the corpus, and a filter combination and an empty library look identical\n  // from the result set alone.\n  if (activeFilters.length > 0) {\n    return \"filtered_out\";\n  }\n  return sourceCount === 0 ? \"no_corpus_connected\" : \"corpus_empty\";\n}\n\nconst NO_CORPUS_EXIT =\n  \"Testimonials are ingested from the client's public review pages — an agent cannot write one — so no \" +\n  \"rewording will find quotes. If the user named the client's own review page (Google Maps, Trustpilot, Yelp, \" +\n  \"Tripadvisor, G2, Capterra, Amazon, App Store, Google Play), add it with `baker testimonials sources add <link>` \" +\n  \"— its reviews arrive over the next minutes, not in this turn. Stop searching and source proof another way: a result or case study the client \" +\n  \"already published, a named-customer logo (`baker images logo`), or a founder claim attributed as a claim. \" +\n  \"Otherwise ship without a testimonial block and file the gap: `baker actions create \" +\n  '--name \"Collect customer quotes for <page>\" --priority medium --tags <slug>`. ' +\n  \"Never invent, paraphrase-into-existence, or pad with unrelated praise.\";\n\n/**\n * `detail` is written to be quotable — it ends up in `meta.empty.detail`, and\n * an agent that repeats it verbatim should still be saying something true.\n */\nexport function emptyReasonDetail(reason: EmptyCorpusReason, sourceCount: number, activeFilters: string[]): string {\n  if (reason === \"filtered_out\") {\n    return `No rows matched, and ${activeFilters.join(\", \")} narrowed this read. The corpus was not checked — drop every filter to see whether the library itself is empty.`;\n  }\n  if (reason === \"no_corpus_connected\") {\n    return \"This company has no review source connected — checked against its source list, not inferred from the empty result.\";\n  }\n  return `${sourceCount} review source${sourceCount === 1 ? \" is\" : \"s are\"} connected but hold no testimonials yet — the source is there, the rows are not. Ingestion may still be running.`;\n}\n\n/**\n * What to say when the library did not end where this page did.\n *\n * `GET /api/testimonials` is paged — a testimonial row carries a 3072-float\n * embedding, so a listing reads an index page at a time and returns\n * `X-Baker-Next-Cursor` when rows remain unexamined. Until that cursor comes\n * back absent, every conclusion this module otherwise draws is off the table: an\n * empty page proves nothing about the corpus, and a short one is not \"all there\n * is\". The next call is a `--cursor` away, so the hint says exactly that.\n */\nexport function morePagesHint(resultCount: number, cursor: string): string {\n  const found = resultCount === 0 ? \"This page held no matches\" : `This page held ${resultCount}`;\n  return (\n    `${found}, and the library continues past it — so this is one page, not the client's whole set. ` +\n    \"Do not report it as the corpus and do not conclude anything is missing from it. Read the next page with \" +\n    `\\`baker testimonials list --cursor ${cursor}\\` (same filters), or go straight at the rows you want with ` +\n    \"`baker testimonials search <query>`.\"\n  );\n}\n\n/** The last page of a walk came back empty: the read is over, and it worked. */\nfunction endOfWalkHint(command: TestimonialQuery): string {\n  const noun = command === \"search\" ? \"results\" : \"rows\";\n  return (\n    `That was the end of the library — no more ${noun} past the page before this one. Nothing here says the ` +\n    \"corpus is empty (the earlier pages held it), so answer from what those pages returned rather than re-reading.\"\n  );\n}\n\n/**\n * Establishes why a read was empty, by asking the backend rather than inferring.\n *\n * Costs one extra round trip and only on the zero-result path, which is the\n * cheap half of the trade: the call it replaces was the agent re-querying two or\n * three times to convince itself, and the claim it replaces was sometimes wrong.\n *\n * If the source check itself fails we return nothing at all. That is the point\n * of the change — a read that did not happen must never become a confident\n * statement about the client's account, which is exactly the failure this\n * module previously shipped.\n */\nexport async function measureEmptyCorpus({\n  command,\n  resultCount,\n  activeFilters,\n  nextCursor = null,\n  continued = false,\n}: {\n  command: TestimonialQuery;\n  resultCount: number;\n  activeFilters: string[];\n  /** `X-Baker-Next-Cursor` from the response — see `morePagesHint`. */\n  nextCursor?: string | null;\n  /** This call passed a `--cursor`, so it is the tail of a walk, not a read. */\n  continued?: boolean;\n}): Promise<{ hints: string[]; empty?: EmptyEvidence }> {\n  // A page that is not the last page establishes nothing about the corpus, so\n  // it gets a hint and no `empty` evidence — the same rule as a failed source\n  // check below. It is also the one path that speaks when rows came back:\n  // \"here are 4\" is the misleading half.\n  if (nextCursor) {\n    return { hints: [morePagesHint(resultCount, nextCursor)] };\n  }\n  if (resultCount > 0) {\n    return { hints: [] };\n  }\n  // Zero rows at the end of a walk is the walk ending — the rows were on the\n  // pages already read. Measuring the corpus here would answer a question\n  // nobody asked and, worse, answer it wrongly: a page can end exactly on the\n  // last row (the page cap closes it with `isDone` still false), so a library\n  // that was fully read hands back one final empty page, and `corpus_empty`\n  // would report a company with reviews as having none.\n  if (continued) {\n    return { hints: [endOfWalkHint(command)] };\n  }\n  if (activeFilters.length > 0) {\n    // Filters alone explain it; no need to spend a call on the corpus.\n    const reason = \"filtered_out\" as const;\n    return {\n      hints: emptyCorpusHints({ command, reason, sourceCount: 0, activeFilters }),\n      empty: { reason, detail: emptyReasonDetail(reason, 0, activeFilters) },\n    };\n  }\n\n  let sourceCount: number;\n  try {\n    const sources = await apiGet<unknown[]>(\"/api/testimonials/sources\");\n    sourceCount = Array.isArray(sources) ? sources.length : 0;\n  } catch {\n    return {\n      hints: [\n        \"No rows, and the check for connected review sources failed — so this is NOT evidence that the client \" +\n          \"has no reviews. Do not record an absence you could not verify. Re-run once; if it fails again, say \" +\n          \"the library could not be read rather than that it is empty.\",\n      ],\n    };\n  }\n\n  const reason = resolveEmptyReason({ resultCount, activeFilters, sourceCount });\n  if (reason === null) {\n    return { hints: [] };\n  }\n  return {\n    hints: emptyCorpusHints({ command, reason, sourceCount, activeFilters }),\n    empty: { reason, detail: emptyReasonDetail(reason, sourceCount, activeFilters) },\n  };\n}\n\nexport function emptyCorpusHints({\n  command,\n  reason,\n  sourceCount,\n  activeFilters,\n}: {\n  command: TestimonialQuery;\n  reason: EmptyCorpusReason | null;\n  sourceCount: number;\n  activeFilters: string[];\n}): string[] {\n  if (reason === null) {\n    return [];\n  }\n  if (reason === \"filtered_out\") {\n    return [\n      `No rows — ${activeFilters.join(\", \")} narrowed this. Drop every filter and re-run once before touching ` +\n        \"the query; a filter combination and an empty library look identical from here.\",\n    ];\n  }\n  const lead = command === \"search\" ? \"No hits\" : \"No rows\";\n  if (reason === \"no_corpus_connected\") {\n    // Terminal, and now actually verified — so it is safe to tell the agent to\n    // stop, which is the whole point of saying it.\n    return [`${lead}, and this company's source list is empty: there is no review corpus to search. ${NO_CORPUS_EXIT}`];\n  }\n  return [\n    `${lead}. ${sourceCount} review source${sourceCount === 1 ? \" is\" : \"s are\"} connected but no testimonials ` +\n      \"have landed yet — so this is a timing or ingestion gap, not a missing connection, and re-querying will not \" +\n      `change it. Ingestion may still be running: say so rather than reporting the client has no reviews. ${NO_CORPUS_EXIT}`,\n  ];\n}\n"],"mappings":";;;;;AA0CO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AACF,GAA2C;AACzC,MAAI,cAAc,GAAG;AACnB,WAAO;AAAA,EACT;AAIA,MAAI,cAAc,SAAS,GAAG;AAC5B,WAAO;AAAA,EACT;AACA,SAAO,gBAAgB,IAAI,wBAAwB;AACrD;AAEA,IAAM,iBACJ;AAaK,SAAS,kBAAkB,QAA2B,aAAqB,eAAiC;AACjH,MAAI,WAAW,gBAAgB;AAC7B,WAAO,wBAAwB,cAAc,KAAK,IAAI,CAAC;AAAA,EACzD;AACA,MAAI,WAAW,uBAAuB;AACpC,WAAO;AAAA,EACT;AACA,SAAO,GAAG,WAAW,iBAAiB,gBAAgB,IAAI,QAAQ,OAAO;AAC3E;AAYO,SAAS,cAAc,aAAqB,QAAwB;AACzE,QAAM,QAAQ,gBAAgB,IAAI,8BAA8B,kBAAkB,WAAW;AAC7F,SACE,GAAG,KAAK,0OAE8B,MAAM;AAGhD;AAGA,SAAS,cAAc,SAAmC;AACxD,QAAM,OAAO,YAAY,WAAW,YAAY;AAChD,SACE,kDAA6C,IAAI;AAGrD;AAcA,eAAsB,mBAAmB;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb,YAAY;AACd,GAQwD;AAKtD,MAAI,YAAY;AACd,WAAO,EAAE,OAAO,CAAC,cAAc,aAAa,UAAU,CAAC,EAAE;AAAA,EAC3D;AACA,MAAI,cAAc,GAAG;AACnB,WAAO,EAAE,OAAO,CAAC,EAAE;AAAA,EACrB;AAOA,MAAI,WAAW;AACb,WAAO,EAAE,OAAO,CAAC,cAAc,OAAO,CAAC,EAAE;AAAA,EAC3C;AACA,MAAI,cAAc,SAAS,GAAG;AAE5B,UAAMA,UAAS;AACf,WAAO;AAAA,MACL,OAAO,iBAAiB,EAAE,SAAS,QAAAA,SAAQ,aAAa,GAAG,cAAc,CAAC;AAAA,MAC1E,OAAO,EAAE,QAAAA,SAAQ,QAAQ,kBAAkBA,SAAQ,GAAG,aAAa,EAAE;AAAA,IACvE;AAAA,EACF;AAEA,MAAI;AACJ,MAAI;AACF,UAAM,UAAU,MAAM,OAAkB,2BAA2B;AACnE,kBAAc,MAAM,QAAQ,OAAO,IAAI,QAAQ,SAAS;AAAA,EAC1D,QAAQ;AACN,WAAO;AAAA,MACL,OAAO;AAAA,QACL;AAAA,MAGF;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SAAS,mBAAmB,EAAE,aAAa,eAAe,YAAY,CAAC;AAC7E,MAAI,WAAW,MAAM;AACnB,WAAO,EAAE,OAAO,CAAC,EAAE;AAAA,EACrB;AACA,SAAO;AAAA,IACL,OAAO,iBAAiB,EAAE,SAAS,QAAQ,aAAa,cAAc,CAAC;AAAA,IACvE,OAAO,EAAE,QAAQ,QAAQ,kBAAkB,QAAQ,aAAa,aAAa,EAAE;AAAA,EACjF;AACF;AAEO,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKa;AACX,MAAI,WAAW,MAAM;AACnB,WAAO,CAAC;AAAA,EACV;AACA,MAAI,WAAW,gBAAgB;AAC7B,WAAO;AAAA,MACL,kBAAa,cAAc,KAAK,IAAI,CAAC;AAAA,IAEvC;AAAA,EACF;AACA,QAAM,OAAO,YAAY,WAAW,YAAY;AAChD,MAAI,WAAW,uBAAuB;AAGpC,WAAO,CAAC,GAAG,IAAI,mFAAmF,cAAc,EAAE;AAAA,EACpH;AACA,SAAO;AAAA,IACL,GAAG,IAAI,KAAK,WAAW,iBAAiB,gBAAgB,IAAI,QAAQ,OAAO,qPAE6B,cAAc;AAAA,EACxH;AACF;","names":["reason"]}

package/dist/chunk-4NZ47VXO.js

@@ -0,0 +1,137 @@
+// src/engine/copy-tells/questions.ts
+var ANY_LANGUAGE = "The copy may be in any language; judge the construction, not the words.";
+var TELL_QUESTIONS = [
+  {
+    id: "rhetorical-opener",
+    question: `Does \`sentence\` open with a fake-candid pause before an ordinary claim, such as "Honestly?", "Here's the thing:", "Look,", "Let's be real", "La verdad es que", "Seamos sinceros"? A sentence that simply starts with its claim does not count. ${ANY_LANGUAGE}`,
+    threshold: 0.75
+  },
+  {
+    id: "negation-pivot",
+    question: `Is \`sentence\` built as a negative parallelism that denies a smaller framing to assert a bigger one, such as "It's not just a CRM, it's a growth engine", "Not only X but also Y", "No se trata solo de X, sino de Y", or a short "Not a tool." answered by "A partner." (\`before\` is the sentence before it, for that two-sentence form)? A plain negative fact ("No setup fee", "We don't sell your data") does not count. ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  },
+  {
+    id: "participle-tail",
+    question: `Does \`sentence\` end with a participle or gerund phrase hung off a comma to add vague significance, such as ", ensuring nothing slips through", ", fostering growth", ", permitiendo cerrar el mes antes"? A sentence that opens with such a word does not count. ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  },
+  {
+    id: "copula-avoidance",
+    question: `Does \`sentence\` use an inflated verb where a plain "is" or "has" would do, such as "serves as", "stands as", "boasts", "se erige como", "cuenta con"? ${ANY_LANGUAGE}`,
+    threshold: 0.6
+  },
+  {
+    id: "authority-trope",
+    question: `Does \`sentence\` claim to reveal what is "really" at stake, with a phrase like "The real question is", "At its core", "What really matters is", "The heart of the matter", "En el fondo", "Lo que realmente importa"? Candid openers ("Honestly", "To be fair"), contrasts ("not just X, but Y") and filler words are other tells and do not count here. ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  },
+  {
+    id: "signposting",
+    question: `Does \`sentence\` announce what the text is about to explain instead of saying it, such as "Let's dive in", "Here's what you need to know", "Let's break it down", "Vamos a ver c\xF3mo funciona"? Presenting the offer itself ("Here is a plan for every team size", "Aqu\xED tienes nuestras tarifas") and an assistant handing over a summary are not this. ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  },
+  {
+    id: "chat-artifact",
+    question: `Is \`sentence\` an AI assistant talking to the person who asked it for the text, pasted into the page by mistake, such as "I hope this helps!", "Let me know if you want changes", "Here is an overview of the plan", "Would you like me to", "Aqu\xED tienes el resumen"? Copy that speaks to the page's own visitor ("Here are our three plans", "Tell us what you need") does not count. ${ANY_LANGUAGE}`,
+    threshold: 0.62
+  },
+  {
+    id: "vague-attribution",
+    question: `Does \`sentence\` credit a claim to unnamed authorities, such as "Experts agree", "Studies show", "Research shows", "Los expertos coinciden", without naming who? ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  },
+  {
+    id: "hollow-conclusion",
+    question: `Is \`sentence\` a vague upbeat ending that asserts nothing, such as "The future looks bright", "The possibilities are endless", "El cielo es el l\xEDmite"? ${ANY_LANGUAGE}`,
+    threshold: 0.65
+  },
+  {
+    id: "filler-phrase",
+    question: `Does \`sentence\` contain a wordy filler phrase that carries no meaning, such as "in order to", "due to the fact that", "it is worth noting that", "cabe destacar"? ${ANY_LANGUAGE}`,
+    threshold: 0.75
+  },
+  {
+    id: "aphorism-formula",
+    question: `Is \`sentence\` an aphorism of the form "X is the <abstract noun> of Y", such as "Trust is the currency of every deal", "Data is the language of growth", "Los datos son la columna vertebral de tu negocio"? Other contrasts and slogans do not count. ${ANY_LANGUAGE}`,
+    threshold: 0.7
+  },
+  {
+    id: "false-range",
+    question: `Does \`sentence\` use a "from X to Y" range whose two ends are not points on one scale, such as "from onboarding to retention", "from startups to enterprises", "desde la captaci\xF3n hasta la fidelizaci\xF3n"? A real range of numbers, prices or dates ("from $9 to $99") does not count. ${ANY_LANGUAGE}`,
+    threshold: 0.5
+  }
+];
+function tellQuestionsFor(sentence) {
+  return TELL_QUESTIONS.map((t) => ({
+    instructions: {
+      sentence: sentence.text,
+      ...t.id === "negation-pivot" && sentence.before ? { before: sentence.before } : {},
+      question: t.question
+    }
+  }));
+}
+var SAME_CLAIM_QUESTION = `\`a\` and \`b\` are two headlines of the same ad. Are they the same claim reworded, a synonym or a swapped verb apart ("Boost Your Sales Fast" and "Increase Your Sales Fast"), rather than two different claims (a price, a guarantee, a delivery time, a rating)? ${ANY_LANGUAGE}`;
+var SAME_CLAIM_HELD = 0.5;
+function sameClaimQuestion(a, b) {
+  return { instructions: { a, b, question: SAME_CLAIM_QUESTION } };
+}
+
+// src/engine/copy-tells/sentences.ts
+var SENTENCES = new Intl.Segmenter(void 0, { granularity: "sentence" });
+var WORDS = new Intl.Segmenter(void 0, { granularity: "word" });
+function wordCount(text) {
+  let n = 0;
+  for (const s of WORDS.segment(text)) if (s.isWordLike) n++;
+  return n;
+}
+function rawSentences(text) {
+  return [...SENTENCES.segment(text)].map((s) => s.segment.trim()).filter(Boolean);
+}
+function blockSentences(block, offset) {
+  const out = [];
+  let pending = null;
+  for (const segment of SENTENCES.segment(block)) {
+    const trimmed = segment.segment.trim().replace(/\s+/g, " ");
+    if (!trimmed) continue;
+    const start = offset + segment.index + (segment.segment.length - segment.segment.trimStart().length);
+    const joined = pending ? { text: `${pending.text} ${trimmed}`, start: pending.start } : { text: trimmed, start };
+    pending = wordCount(joined.text) < 2 ? joined : null;
+    if (!pending) out.push(joined);
+  }
+  if (pending && wordCount(pending.text) > 0) out.push(pending);
+  return out;
+}
+var BLOCK_END = /\n[^\S\n]*\n/g;
+function copySentences(copy) {
+  const out = [];
+  let offset = 0;
+  for (const end of [...copy.matchAll(BLOCK_END), null]) {
+    const to = end ? end.index : copy.length;
+    blockSentences(copy.slice(offset, to).replaceAll("\n", " "), offset).forEach((s, i, all) => {
+      const before = all[i - 1]?.text;
+      out.push({ ...s, ...before ? { before } : {} });
+    });
+    if (end) offset = end.index + end[0].length;
+  }
+  return out;
+}
+
+// src/engine/copy-tells/patterns.ts
+var STACCATO_MAX_WORDS = 4;
+var STACCATO_RUN = 3;
+var HEADLINE_SET_FLOOR = 3;
+
+export {
+  STACCATO_MAX_WORDS,
+  STACCATO_RUN,
+  HEADLINE_SET_FLOOR,
+  TELL_QUESTIONS,
+  tellQuestionsFor,
+  SAME_CLAIM_HELD,
+  sameClaimQuestion,
+  wordCount,
+  rawSentences,
+  copySentences
+};
+//# sourceMappingURL=chunk-4NZ47VXO.js.map