@koda-sl/baker-cli 0.471.0 → 0.473.0

package/dist/critique-QNWUTSWL.js

@@ -0,0 +1,213 @@
+import {
+  FRAME_PLACEHOLDER_NOTE,
+  exitOnPrepareError,
+  prepareCanvas
+} from "./chunk-Y47Y7OB4.js";
+import "./chunk-P4UQBJNY.js";
+import "./chunk-7PTOGEUN.js";
+import "./chunk-47SKT3VY.js";
+import "./chunk-L66QWXPF.js";
+import "./chunk-KMMVQ2MR.js";
+import "./chunk-JQUPL6IQ.js";
+import {
+  briefCopyLines,
+  frameDescriptionOf,
+  nativeDialogueOf
+} from "./chunk-O7J4OAC7.js";
+import "./chunk-UCVUZD4S.js";
+import "./chunk-DGCUPJZD.js";
+import {
+  COPY_DIRECTIVE_HEADER
+} from "./chunk-3J3C6OMU.js";
+import "./chunk-CHSNHVYF.js";
+import "./chunk-X3PVW3RM.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-3YNHIJCI.js";
+import "./chunk-VPBCR6DT.js";
+import "./chunk-6DE3EHEF.js";
+import "./chunk-XLZMKMKD.js";
+import "./chunk-XABVEMC3.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-F4H6VVPE.js";
+import "./chunk-G3UCXCC2.js";
+import "./chunk-IWLWY2UD.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/critique.ts
+import path from "path";
+import { defineCommand } from "citty";
+
+// src/engine/scaffold/lib/critique.ts
+var VIBE_CUE = /\b(light|lighting|golden|moody|warm|cool|tone|grade|contrast|shadow|glow|rim|backlit|neon|soft)\b/i;
+var MECHANISM_CUE = /\b(because|works by|so that|mechanism|proof|guarantee|clinically|backed by|the reason|that's why)\b/i;
+function promptOf(node) {
+  const p = node?.params?.prompt;
+  return typeof p === "string" ? p : "";
+}
+function round(n) {
+  return Math.round(n * 100) / 100;
+}
+function frameLook(node) {
+  const description = frameDescriptionOf(promptOf(node)).trim();
+  return description.endsWith(FRAME_PLACEHOLDER_NOTE) ? "" : description;
+}
+function creativeText(nodes) {
+  return nodes.flatMap((n) => {
+    if (n.type === "image_generate") return [frameLook(n)];
+    if (n.type === "video_generate") return [nativeDialogueOf(promptOf(n)) ?? ""];
+    if (n.type === "tts" && typeof n.params?.text === "string") return [n.params.text];
+    return [];
+  }).join("\n");
+}
+function scoreHookStrength(nodes, scene0, hasOverlay) {
+  const scene0Text = scene0.map((n) => promptOf(n)).join("\n");
+  const frames = scene0.filter((n) => n.type === "image_generate");
+  const look = (frames.length > 0 ? frames.map(frameLook) : scene0.map((n) => promptOf(n))).join("\n");
+  const hookClip = scene0.find((n) => n.type === "video_generate");
+  const hasSound = hookClip?.params?.generate_audio === true || /Dialogue:|Audio:/.test(scene0Text) || nodes.some((n) => n.type === "tts" || n.type === "dialogue");
+  const layers = [hasOverlay, hasSound, look.trim().length > 40, VIBE_CUE.test(look)];
+  const layerCount = layers.filter(Boolean).length;
+  return {
+    dimension: "hook_strength",
+    score: round(hookClip ? layerCount / 4 : 0.5),
+    note: hookClip ? `hook works on ${layerCount}/4 layers (text/sound/visual/vibe)` : "no scene-0 clip found \u2014 is this a video creative?"
+  };
+}
+function scoreFirstFrameLegibility(hasOverlay) {
+  return {
+    dimension: "first_frame_legibility",
+    score: hasOverlay ? 1 : 0.4,
+    note: hasOverlay ? "a designed overlay layer carries the sound-off message" : "footage-only \u2014 the first frame may not read with sound off; consider an overlay hook"
+  };
+}
+function scoreRetentionRisk(videoNodes) {
+  let saggy = 0;
+  for (const n of videoNodes) {
+    const dur = typeof n.params?.duration === "number" ? n.params.duration : 0;
+    const spoken = /Dialogue:/.test(promptOf(n)) || n.params?.generate_audio === true;
+    if (dur >= 8 && !spoken) saggy += 1;
+  }
+  return {
+    dimension: "retention_risk",
+    score: round(videoNodes.length > 0 ? 1 - Math.min(1, saggy / videoNodes.length) : 0.7),
+    note: saggy > 0 ? `${saggy} long clip(s) with no spoken line may sag` : "no obvious sag points"
+  };
+}
+function scoreMechanismClarity(allPromptText) {
+  const clear = MECHANISM_CUE.test(allPromptText);
+  return {
+    dimension: "mechanism_clarity",
+    score: clear ? 1 : 0.4,
+    note: clear ? "states a mechanism/proof" : "no clear 'why it works' \u2014 add the mechanism"
+  };
+}
+function clamp01(n) {
+  return Math.max(0, Math.min(1, n));
+}
+function staticCopyLines(nodes) {
+  const gen = nodes.find((n) => n.type === "image_generate");
+  const prompt = promptOf(gen);
+  const compiled = briefCopyLines(prompt);
+  if (compiled.length > 0) return compiled;
+  const start = prompt.indexOf(COPY_DIRECTIVE_HEADER);
+  if (start === -1) return [];
+  const bodyStart = start + COPY_DIRECTIVE_HEADER.length;
+  const end = prompt.indexOf("\n\n", bodyStart);
+  const block = prompt.slice(bodyStart, end === -1 ? void 0 : end);
+  const quoted = block.match(/"[^"]+"/g);
+  return quoted ? quoted.map((s) => s.slice(1, -1)) : [];
+}
+function scoreTextLegibilityRisk(copy) {
+  const lines = copy.length;
+  return {
+    dimension: "text_legibility_risk",
+    score: round(clamp01(1 - Math.max(0, lines - 6) / 12)),
+    note: lines > 6 ? `${lines} copy blocks \u2014 dense; trim or split so type stays legible` : `${lines} copy block(s) \u2014 reads cleanly`
+  };
+}
+function scoreIdentityGrounding(nodes) {
+  const grounded = nodes.filter((n) => n.type === "image_reference_sheet").length + nodes.filter((n) => n.type === "ingest" && typeof n.id === "string" && /^el_/.test(n.id)).length;
+  return {
+    dimension: "identity_grounding",
+    // 0 grounded is fine for a pure-type ad, so it's a soft nudge, not a failure.
+    score: grounded > 0 ? 1 : 0.6,
+    note: grounded > 0 ? `${grounded} subject(s) grounded in a real reference` : "no grounded subject \u2014 fine for a type-only ad; otherwise ground the hero in a real reference"
+  };
+}
+function scoreTypeFidelity(nodes) {
+  const hasSpecimen = nodes.some((n) => n.type === "font_specimen");
+  return {
+    dimension: "type_fidelity",
+    score: hasSpecimen ? 1 : 0.5,
+    note: hasSpecimen ? "brand type biased by a font specimen" : "no font specimen \u2014 brand type may drift; wire the brand font"
+  };
+}
+function critiqueVideo(nodes, videoNodes) {
+  const scene0 = nodes.filter((n) => typeof n.id === "string" && /^s0(?:[_a-z0-9])*_/.test(n.id));
+  const hasOverlay = nodes.some((n) => typeof n.type === "string" && /hyperframe/.test(n.type));
+  return [
+    scoreHookStrength(nodes, scene0, hasOverlay),
+    scoreFirstFrameLegibility(hasOverlay),
+    scoreRetentionRisk(videoNodes),
+    scoreMechanismClarity(creativeText(nodes))
+  ];
+}
+function critiqueStatic(nodes) {
+  const copy = staticCopyLines(nodes);
+  const copyText = copy.join("\n");
+  return [
+    scoreTextLegibilityRisk(copy),
+    scoreIdentityGrounding(nodes),
+    scoreTypeFidelity(nodes),
+    scoreMechanismClarity(copyText)
+  ];
+}
+function critiqueCanvas(canvas) {
+  const nodes = Array.isArray(canvas.nodes) ? canvas.nodes : [];
+  const videoNodes = nodes.filter((n) => n.type === "video_generate");
+  const dimensions = videoNodes.length > 0 ? critiqueVideo(nodes, videoNodes) : critiqueStatic(nodes);
+  const overall = round(dimensions.reduce((s, d) => s + d.score, 0) / dimensions.length);
+  return { advisory: true, overall, dimensions };
+}
+
+// src/commands/canvas/critique.ts
+var critiqueCommand = defineCommand({
+  meta: {
+    name: "critique",
+    description: "Pre-spend creative critic (ADVISORY \u2014 never blocks). Scores a scaffolded creative BEFORE the billed render, so weak spots get fixed for free. It scores what will render: prompt.json and scenes/*.json edits are brought into the canvas first, exactly as `run` does. A VIDEO creative is scored on hook strength, sound-off first-frame legibility, retention risk, and mechanism clarity; a STATIC ad on baked-text legibility risk, identity grounding, brand-type fidelity, and mechanism clarity. Ground a video hook against `baker winning-ads hooks` for a proven pattern."
+  },
+  args: { file: { type: "positional", required: true, description: "Path to canvas JSON" } },
+  async run({ args }) {
+    const filePath = path.resolve(String(args.file));
+    let prepared;
+    try {
+      prepared = await prepareCanvas(filePath, { log: (line) => process.stderr.write(`${line}
+`) });
+    } catch (e) {
+      exitOnPrepareError(e);
+    }
+    const report = critiqueCanvas(prepared.canvas);
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          ok: true,
+          advisory: true,
+          overall: report.overall,
+          dimensions: report.dimensions,
+          hint: "Scores are 0\u20131 (higher is better). This never blocks a render \u2014 strengthen weak dimensions or proceed."
+        },
+        null,
+        2
+      )}
+`
+    );
+  }
+});
+export {
+  critiqueCommand
+};
+//# sourceMappingURL=critique-QNWUTSWL.js.map

package/dist/crm-D7PDFSFN.js

@@ -0,0 +1,224 @@
+import {
+  failNotConnected
+} from "./chunk-LXLRKZVM.js";
+import {
+  writeAdsOutput
+} from "./chunk-CGOVXSSY.js";
+import "./chunk-FAB3BWE2.js";
+import {
+  hubspotCompaniesSearchRequestSchema,
+  hubspotDealsListRequestSchema
+} from "./chunk-XABVEMC3.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-JLCK7K6Y.js";
+import "./chunk-F4H6VVPE.js";
+import "./chunk-G3UCXCC2.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-IWLWY2UD.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/hubspot/crm.ts
+import { defineCommand } from "citty";
+function dealsListHints(data, request) {
+  const hints = [];
+  if (data.deals.length === 0 && (request.pipelineIds.length > 0 || request.modifiedSince !== void 0)) {
+    hints.push(
+      "No deals matched. Widen the read: drop --pipeline, or pass an earlier --modified-since (`baker hubspot pipelines list` shows the pipeline ids)."
+    );
+  }
+  if (data.next !== null) {
+    hints.push(`More deals follow: run it again with --after ${data.next}.`);
+  }
+  if (data.restartFrom !== null) {
+    hints.push(
+      `HubSpot stops one search at 10,000 deals. Read on with --modified-since ${data.restartFrom} (no --after); the first deal repeats the last one here.`
+    );
+  }
+  if (!data.companiesReadable) {
+    hints.push(
+      "Deals came back without their companies: this HubSpot connection cannot read companies. Do not report a deal as having no company \u2014 you cannot tell. The user can enable it by reconnecting HubSpot."
+    );
+  }
+  return hints;
+}
+function companiesSearchHints(data, request) {
+  const hints = [];
+  if (data.notFound.length > 0) {
+    hints.push(
+      `${data.notFound.length} domain(s) are not in HubSpot: ${data.notFound.join(", ")}. Those companies are new to the CRM \u2014 not in pipeline \u2014 which is a finding, not a failed search.`
+    );
+  }
+  if (!request.withDeals && data.companies.length > 0) {
+    hints.push("Add --with-deals to see each company's deals: amount, stage, and whether it closed won.");
+  }
+  if (data.truncated) {
+    hints.push(
+      "More companies matched than --limit, so the search stopped before checking every domain: a domain with no row here may still be in HubSpot, and notFound leaves it out. Do not report a domain without a row as new to the CRM until a search returns every match: raise --limit (up to 500) or search fewer domains at a time."
+    );
+  }
+  return hints;
+}
+function list(raw, separator) {
+  if (typeof raw !== "string") return void 0;
+  const items = raw.split(separator).map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : void 0;
+}
+function optionalNumber(raw) {
+  return typeof raw === "string" && raw.trim() !== "" ? Number(raw) : void 0;
+}
+function failInvalid(issues) {
+  writeJson({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: issues.map((issue) => `${issue.path.map(String).join(".") || "args"}: ${issue.message}`).join("; ")
+    }
+  });
+  process.exit(1);
+}
+var OUTPUT_ARG = {
+  type: "string",
+  description: "json|csv|jsonl|md (default json). csv/jsonl/md print the rows only; hints go to stderr",
+  required: false,
+  default: "json"
+};
+var COMPANIES_SEARCH_ARGS = {
+  domains: {
+    type: "string",
+    description: "Comma-separated website domains, up to 100 (acme.com,globex.io). URLs and www. are fine",
+    required: false
+  },
+  names: {
+    type: "string",
+    description: "Semicolon-separated exact company names (names contain commas): 'Acme, Inc.;Globex'",
+    required: false
+  },
+  "with-deals": {
+    type: "boolean",
+    description: "Add each company's deals: amount, currency, pipeline, stage, closed/won, dates",
+    required: false,
+    default: false
+  },
+  limit: { type: "string", description: "Most companies to return, 1-500 (default 100)", required: false },
+  output: OUTPUT_ARG
+};
+registerSchema({
+  command: "hubspot.companies.search",
+  description: "Find the client's CRM companies (accounts) by website domain or name \u2014 start here to match an outside list of companies against HubSpot, e.g. the companies `baker ads linkedin companies --with-domains` says the ads reached: which are already accounts, which have deals, which are new. Rows: {id, name, domain, linkedinPage}; --with-deals adds each company's deals. `notFound` lists the domains no CRM company carries \u2014 new to the CRM, a finding; when `truncated`, it leaves out the domains the search did not reach. Reads records only; changes nothing in HubSpot.",
+  args: COMPANIES_SEARCH_ARGS
+});
+var COMPANY_CSV_FIELDS = ["id", "name", "domain", "linkedinPage", "deals"];
+var companiesSearchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Find CRM companies by domain or name, optionally with their deals. Example: baker hubspot companies search --domains acme.com,globex.io --with-deals"
+  },
+  args: COMPANIES_SEARCH_ARGS,
+  run: async ({ args }) => {
+    const input = {
+      domains: list(args.domains, ","),
+      names: list(args.names, ";"),
+      withDeals: Boolean(args["with-deals"]),
+      limit: optionalNumber(args.limit)
+    };
+    const parsed = hubspotCompaniesSearchRequestSchema.safeParse(input);
+    if (!parsed.success) failInvalid(parsed.error.issues);
+    try {
+      const response = await apiPost("/api/hubspot/companies/search", parsed.data);
+      const hints = companiesSearchHints(response.data, { withDeals: parsed.data.withDeals === true });
+      const format = String(args.output ?? "json");
+      if (format !== "json") {
+        writeAdsOutput(response.data.companies, format, COMPANY_CSV_FIELDS, hints);
+        return;
+      }
+      writeJson({
+        ...response,
+        meta: { count: response.data.companies.length },
+        ...hints.length > 0 ? { hints } : {}
+      });
+    } catch (err) {
+      failNotConnected(err, "so I can see which of your companies and deals the ads reached");
+    }
+  }
+});
+var DEALS_LIST_ARGS = {
+  pipeline: {
+    type: "string",
+    description: "Comma-separated pipeline ids, from `baker hubspot pipelines list` (default: every pipeline)",
+    required: false
+  },
+  "modified-since": {
+    type: "string",
+    description: "Only deals changed on or after this date (YYYY-MM-DD or ISO date-time)",
+    required: false
+  },
+  limit: { type: "string", description: "Most deals to return, 1-1000 (default 200)", required: false },
+  after: { type: "string", description: "Cursor from the previous page's `next`", required: false },
+  output: OUTPUT_ARG
+};
+registerSchema({
+  command: "hubspot.deals.list",
+  description: "The client's deals, oldest change first: {id, name, amount, currency, pipelineId, stageId, stageLabel, isClosed, isWon, createdAt, closedAt, modifiedAt, companyIds}. Start here for pipeline and revenue questions \u2014 which deals closed won, what is open, which companies they belong to (`companyIds` are HubSpot company ids, the same as `hubspot companies search` returns). Page with --after <next> until it is null. `amount: null` means no amount was entered, not zero.",
+  args: DEALS_LIST_ARGS
+});
+var DEAL_CSV_FIELDS = [
+  "id",
+  "name",
+  "amount",
+  "currency",
+  "pipelineId",
+  "stageId",
+  "stageLabel",
+  "isClosed",
+  "isWon",
+  "createdAt",
+  "closedAt",
+  "modifiedAt",
+  "companyIds"
+];
+var dealsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List deals with amount, stage and whether they closed won. Example: baker hubspot deals list --pipeline default --modified-since 2026-01-01"
+  },
+  args: DEALS_LIST_ARGS,
+  run: async ({ args }) => {
+    const input = {
+      pipelineIds: list(args.pipeline, ","),
+      modifiedSince: typeof args["modified-since"] === "string" ? args["modified-since"] : void 0,
+      limit: optionalNumber(args.limit),
+      after: typeof args.after === "string" && args.after !== "" ? args.after : void 0
+    };
+    const parsed = hubspotDealsListRequestSchema.safeParse(input);
+    if (!parsed.success) failInvalid(parsed.error.issues);
+    try {
+      const response = await apiPost("/api/hubspot/deals/list", parsed.data);
+      const hints = dealsListHints(response.data, {
+        pipelineIds: parsed.data.pipelineIds ?? [],
+        modifiedSince: parsed.data.modifiedSince
+      });
+      const format = String(args.output ?? "json");
+      if (format !== "json") {
+        writeAdsOutput(response.data.deals, format, DEAL_CSV_FIELDS, hints);
+        return;
+      }
+      writeJson({ ...response, meta: { count: response.data.deals.length }, ...hints.length > 0 ? { hints } : {} });
+    } catch (err) {
+      failNotConnected(err, "so I can see which of your companies and deals the ads reached");
+    }
+  }
+});
+export {
+  companiesSearchCommand,
+  companiesSearchHints,
+  dealsListCommand,
+  dealsListHints
+};
+//# sourceMappingURL=crm-D7PDFSFN.js.map