@koda-sl/baker-cli 0.465.0 → 0.467.0

package/dist/chunk-4TOE7NXN.js

@@ -1,188 +0,0 @@
-import {
-  analyticsErrorEnvelope
-} from "./chunk-T4RQKMGO.js";
-import {
-  PEOPLE_SEARCH_MAX_TERMS,
-  parsePeopleQuery,
-  peopleLookupRequestSchema
-} from "./chunk-SSJK7FEV.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-VAX5ITZ5.js";
-import {
-  apiPost
-} from "./chunk-T2MH5SCT.js";
-import {
-  registerSchema
-} from "./chunk-SHVQFDNY.js";
-
-// src/commands/analytics/lookup.ts
-import { readFileSync } from "fs";
-import { defineCommand } from "citty";
-function peopleArgs(args2) {
-  const parts = peopleParts(args2);
-  if (parts.length === 0) return {};
-  const people = parsePeopleQuery(parts).terms.map((term) => term.input);
-  return people.length === 0 ? {} : { people };
-}
-function peopleParts(args2) {
-  return [...args2.person ? [String(args2.person)] : [], ...args2["people-file"] ? [readPeopleFile(args2)] : []];
-}
-function readPeopleFile(args2) {
-  try {
-    return readFileSync(String(args2["people-file"]), "utf8");
-  } catch {
-    return "";
-  }
-}
-function unreadablePeopleFile(args2) {
-  if (!args2["people-file"]) return void 0;
-  const path = String(args2["people-file"]);
-  try {
-    readFileSync(path, "utf8");
-    return void 0;
-  } catch {
-    return `Couldn't read --people-file ${path}. Check the path, or pass the people inline with --person.`;
-  }
-}
-function peopleLimitError(args2) {
-  const unreadable = unreadablePeopleFile(args2);
-  if (unreadable !== void 0) return unreadable;
-  const { terms, dropped } = parsePeopleQuery(peopleParts(args2));
-  if (dropped === 0) return void 0;
-  return `${terms.length + dropped} people named; one search takes up to ${PEOPLE_SEARCH_MAX_TERMS}. Split the list and run each part.`;
-}
-function compactRow(row) {
-  const clicks = [...row.googleClick ? ["google"] : [], ...row.metaClick ? ["meta"] : []];
-  const candidates = {
-    input: row.input,
-    readAs: row.kind,
-    found: row.found,
-    problem: row.problem,
-    contacts: row.contacts,
-    events: row.events,
-    firstSeen: row.firstSeen,
-    lastSeen: row.lastSeen,
-    pageViews: row.pageViews,
-    landings: row.landings,
-    visits: row.visits,
-    formSubmits: row.formSubmits,
-    firstSource: row.firstSource,
-    systemEvents: row.systemEvents,
-    pageEvents: row.pageEvents,
-    uploads: row.uploads,
-    uploadedTo: row.uploadedTo,
-    clicks,
-    knownBy: row.knownBy
-  };
-  return Object.fromEntries(
-    Object.entries(candidates).filter(
-      ([key, value]) => key === "found" || !(value === 0 || value === "" || Array.isArray(value) && value.length === 0)
-    )
-  );
-}
-function lookupHints(data) {
-  const hints = [];
-  if (data.dropped > 0) {
-    hints.push(
-      `${data.dropped} lines past the limit of ${PEOPLE_SEARCH_MAX_TERMS} were not looked up. Run the rest separately.`
-    );
-  }
-  const unseen = data.people.filter((row) => !row.found && row.problem === "");
-  if (unseen.length > 0) {
-    hints.push(
-      `Not seen by Baker: ${unseen.map((row) => row.input).join(", ")}. Baker knows a person by what its pages, Forms and connected systems recorded \u2014 a lead that came in through a form or site Baker does not measure, or a source not connected, is not here.`
-    );
-  }
-  for (const row of data.people.filter((person) => person.problem !== "")) {
-    hints.push(`${row.input}: ${row.problem}`);
-  }
-  const found = data.people.filter((row) => row.found);
-  const neverVisited = found.filter((row) => row.pageViews === 0);
-  if (neverVisited.length > 0) {
-    hints.push(
-      `${neverVisited.length} of ${found.length} found never visited a page Baker publishes: Baker knows them only from what their systems reported, so no landing can be credited with them.`
-    );
-  }
-  if (found.length > 0) {
-    hints.push(
-      `\`baker analytics feed --person '${found[0]?.input}' --days 90\` lists everything one of them did, in order \u2014 add more, comma-separated, to follow several.`
-    );
-  }
-  return hints;
-}
-function lookupReport(data, full = false) {
-  const found = data.people.filter((row) => row.found);
-  return {
-    summary: {
-      searched: data.people.length,
-      found: found.length,
-      notFound: data.people.length - found.length,
-      visitedABakerPage: found.filter((row) => row.pageViews > 0).length
-    },
-    people: full ? data.people : data.people.map(compactRow),
-    hints: lookupHints(data)
-  };
-}
-var NO_PEOPLE = "Name at least one person: --person 'ana@empresa.com, deal:40001234567' or --people-file leads.txt.";
-var args = {
-  person: {
-    type: "string",
-    description: "The people, comma-separated: an email, a phone (+34\u2026), a HubSpot contact id, deal:<HubSpot deal id>, a gclid/fbclid, a browser id. Prefix to be exact: email:, phone:, hubspot:, deal:, gclid:, fbclid:, browser:",
-    required: false
-  },
-  "people-file": {
-    type: "string",
-    description: "A file with one person per line \u2014 a column pasted from a CRM export",
-    required: false
-  },
-  full: {
-    type: "boolean",
-    description: "Every field of every line, zeros included",
-    required: false
-  }
-};
-registerSchema({
-  command: "analytics.lookup",
-  description: "What Baker saw of each person in a list, by email, phone, CRM id, deal or click id",
-  args
-});
-var lookupCommand = defineCommand({
-  meta: {
-    name: "lookup",
-    description: `What Baker saw of each person in a list \u2014 all time, one line each \u2014 by whatever the client holds about them. The reconciliation question: "HubSpot says 26 leads yesterday, which of them does Baker have, and where did they come from".
-
-Start here:
-  baker analytics lookup --person 'ana@empresa.com, +34600111222, 90001234567'
-  baker analytics lookup --person 'deal:40001234567, deal:40001234568'   \u2014 HubSpot deal ids, looked up through the deal's contacts
-  baker analytics lookup --people-file leads.txt                           \u2014 one per line, up to ${PEOPLE_SEARCH_MAX_TERMS}
-
-Each line says whether Baker has them, when it first and last saw them, the pages and Forms they touched, what their systems reported (systemEvents: CRM stages, orders), what Baker uploaded for them to ad platforms, which ad click they carried, and every kind of key they are linked by. A bare number is read as a HubSpot contact id or a phone; prefix it to be exact. Emails and phones are hashed by Baker \u2014 say them to the client as they gave them, never as a hash. Follow one with \`baker analytics feed --person <same value>\`.`
-  },
-  args,
-  run: async ({ args: raw }) => {
-    const { people } = peopleArgs(raw);
-    const parsed = peopleLookupRequestSchema.safeParse({ people: people ?? [] });
-    const invalid = peopleLimitError(raw) ?? (parsed.success ? void 0 : NO_PEOPLE);
-    if (invalid !== void 0 || !parsed.success) {
-      writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message: invalid ?? NO_PEOPLE } });
-      process.exit(1);
-    }
-    try {
-      const response = await apiPost("/api/analytics/people", parsed.data);
-      const { hints, ...data } = lookupReport(response.data, raw.full === true);
-      writeJsonEnvelope({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
-    } catch (error) {
-      writeJsonEnvelope({ ok: false, error: analyticsErrorEnvelope(error) });
-      process.exit(1);
-    }
-  }
-});
-
-export {
-  peopleArgs,
-  peopleLimitError,
-  lookupReport,
-  lookupCommand
-};
-//# sourceMappingURL=chunk-4TOE7NXN.js.map

package/dist/chunk-4XVVTERH.js

@@ -1,149 +0,0 @@
-import {
-  hintLines,
-  splitHints
-} from "./chunk-D5FY4FAK.js";
-import {
-  isNotConnectedError,
-  writeJsonEnvelope
-} from "./chunk-VAX5ITZ5.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-T2MH5SCT.js";
-import {
-  requireChatId,
-  resolveChatId
-} from "./chunk-7DIIZUZO.js";
-
-// src/commands/tag-manager/shared.ts
-import { readFileSync } from "fs";
-function failValidation(message) {
-  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
-  process.exit(1);
-}
-function requireTarget(args, entity) {
-  const positional = Array.isArray(args._) ? args._[0] : void 0;
-  const target = args.id ?? args.target ?? positional;
-  if (typeof target !== "string" || target.length === 0) {
-    failValidation(`pass the ${entity} id or path as the positional argument`);
-  }
-  return target;
-}
-function loadJsonArg(args, flag = "json") {
-  const inline = args[flag];
-  const file = args.file;
-  const raw = typeof file === "string" && file.length > 0 ? readFileSync(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
-  if (raw === void 0) {
-    failValidation(`pass --${flag} with inline JSON or --file with a path to a JSON file`);
-  }
-  try {
-    const parsed = JSON.parse(raw);
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failValidation(`--${flag} must be a JSON object`);
-    }
-    return parsed;
-  } catch {
-    return failValidation(`--${flag} is not valid JSON`);
-  }
-}
-var RETRYABLE_CODES = /* @__PURE__ */ new Set(["RATE_LIMITED", "UNAVAILABLE", "INTERNAL_ERROR", "NETWORK_ERROR", "TIMEOUT"]);
-function handleError(err) {
-  if (err instanceof ApiError) {
-    writeJsonEnvelope({
-      ok: false,
-      error: {
-        code: err.code,
-        message: err.message,
-        ...err.code === "UNAUTHORIZED" || err.code === "FORBIDDEN" && isNotConnectedError(err.code, err.message) ? {
-          fix: {
-            action: "request_connection",
-            explanation: 'Tag Manager is not connected for this company yet, or no container has been picked. Don\'t send the user to Settings \u2014 call the `request_connection` tool with { platform: "google-tag-manager", reason } and they connect and pick their containers (they can pick more than one) from inside the chat. `request_tag_input` is not the route: that form manages the container snippet on the site, not what runs inside the container, and it cannot pick a container. If the `request_connection` call fails, say so plainly and give the exact route: dashboard \u2192 Brain \u2192 Integrations \u2192 Platforms \u2192 Google Tag Manager, where they also pick the container. Then carry on with the rest of the task.'
-          }
-        } : {},
-        retryable: RETRYABLE_CODES.has(err.code)
-      }
-    });
-    process.exit(1);
-  }
-  writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error", retryable: true } });
-  process.exit(1);
-}
-var TAG_MANAGER_TIMEOUT_MS = 18e4;
-var STAGE_HINTS = [
-  "Staged only \u2014 nothing has changed in Tag Manager yet. These apply when the chat completes, in dependency order, and close as a Tag Manager version that is then published, so they do go live on the user's site. Say the changes are ready and go live when they publish \u2014 not that they are live already."
-];
-async function stageOp(op) {
-  const chatId = requireChatId();
-  try {
-    const { data, hints } = splitHints(
-      await apiPost(
-        "/api/tag-manager/draft/stage",
-        { chatId, op },
-        { timeoutMs: TAG_MANAGER_TIMEOUT_MS }
-      )
-    );
-    writeJsonEnvelope({ ok: true, data, hints: [...hints, ...STAGE_HINTS] });
-  } catch (err) {
-    handleError(err);
-  }
-}
-async function draftAction(path, body, chat) {
-  const chatId = resolveChatId(chat);
-  try {
-    const { data, hints } = splitHints(
-      await apiPost(path, { chatId, ...body }, { timeoutMs: TAG_MANAGER_TIMEOUT_MS })
-    );
-    writeJsonEnvelope({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
-    return data;
-  } catch (err) {
-    handleError(err);
-  }
-}
-function renderDraft(response) {
-  if (response.count === 0) {
-    return "No Tag Manager changes staged on this chat.";
-  }
-  const lines = [
-    `${response.count} staged Tag Manager change(s)`,
-    ...response.ops.flatMap((op) => {
-      const status = op.result ? ` [${op.result.status}]` : "";
-      return [`  ${op.ref}  ${op.summary}${status}`, ...(op.warnings ?? []).map((warning) => `    \u26A0 ${warning}`)];
-    })
-  ];
-  if (response.versionId) {
-    lines.push(
-      "",
-      response.published ? `Applied and published as Tag Manager version ${response.versionId}. These changes are live on the site.` : `Applied into Tag Manager version ${response.versionId}. It is NOT published \u2014 publish it in Tag Manager to go live.`
-    );
-  }
-  if (response.compilerError) {
-    lines.push("", `Tag Manager reported a problem building the version: ${response.compilerError}`);
-  }
-  return lines.join("\n");
-}
-async function draftList(json, chat) {
-  const chatId = resolveChatId(chat);
-  try {
-    const response = await apiPost("/api/tag-manager/draft", { chatId });
-    const { data, hints } = splitHints(response);
-    if (json) {
-      writeJsonEnvelope({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
-      return;
-    }
-    process.stdout.write(`${renderDraft(data)}${hintLines(response)}
-`);
-  } catch (err) {
-    handleError(err);
-  }
-}
-
-export {
-  requireTarget,
-  loadJsonArg,
-  handleError,
-  TAG_MANAGER_TIMEOUT_MS,
-  stageOp,
-  draftAction,
-  draftList
-};
-//# sourceMappingURL=chunk-4XVVTERH.js.map

package/dist/chunk-5LHDRP5F.js

@@ -1,166 +0,0 @@
-import {
-  HEADLINE_SET_FLOOR,
-  SAME_CLAIM_HELD,
-  TELL_QUESTIONS,
-  copySentences,
-  sameClaimQuestion,
-  tellQuestionsFor
-} from "./chunk-4NZ47VXO.js";
-import {
-  rememberedJev
-} from "./chunk-PAE5XKKY.js";
-import {
-  holdUnbilledSpend
-} from "./chunk-DZD3XEBO.js";
-import {
-  findWorkspaceRoot
-} from "./chunk-YOFHPTWU.js";
-import {
-  CAPABILITY_SURFACE_SPECS
-} from "./chunk-XQIOCIDO.js";
-
-// src/commands/capabilities/fix.ts
-function capabilityFix(surface) {
-  const spec = CAPABILITY_SURFACE_SPECS[surface];
-  return {
-    action: `baker capabilities ${surface}`,
-    explanation: `Do not guess another field name. \`baker capabilities ${surface}\` lists every ${spec.label} change with its required and optional fields and the exact values each field accepts, plus what cannot be changed here at all and why. Read it, then either re-stage correctly or tell the user this part is out of reach \u2014 and carry on with the rest of the job either way.`
-  };
-}
-
-// src/commands/ads/boolean-word-positional.ts
-var BOOLEAN_WORD = /^(true|false)$/i;
-function booleanWordPositionalError(args, entity) {
-  const positionals = Array.isArray(args._) ? args._ : [];
-  const word = positionals.find((value2) => typeof value2 === "string" && BOOLEAN_WORD.test(value2));
-  if (word === void 0) {
-    return void 0;
-  }
-  const value = word.toLowerCase();
-  const raised = Object.keys(args).filter((key) => key !== "_" && args[key] === true);
-  const named = raised.length > 0 ? raised.map((flag) => `--${flag}`).join(" or ") : "a boolean flag";
-  const fix = raised.length > 0 ? raised.map((flag) => `--${flag}=${value}`).join(" or ") : `--<flag>=${value}`;
-  const negated = raised.length === 1 && value === "false" ? ` (or --no-${raised[0]})` : "";
-  return `"${word}" was read as the ${entity} target, not as a value for ${named}. A boolean flag written with a space is set to TRUE and the word is dropped \u2014 attach it instead: ${fix}${negated}.`;
-}
-
-// src/commands/ads/copy-hints.ts
-import path from "path";
-
-// src/engine/copy-tells/judge.ts
-var SAMPLE_MAX = 60;
-var sample = (text) => text.length <= SAMPLE_MAX ? text : `${text.slice(0, SAMPLE_MAX)}\u2026`;
-async function judgedCopyTells(input, ask) {
-  const sentences = input.texts.flatMap((t) => copySentences(t));
-  const pairs = (input.headlineSets ?? []).map((set) => set.map((h) => h.trim()).filter(Boolean)).filter((set) => set.length >= HEADLINE_SET_FLOOR).flatMap((set, s) => set.flatMap((a, i) => set.slice(i + 1).map((b) => ({ set: s, a, b }))));
-  const questions = [...sentences.flatMap(tellQuestionsFor), ...pairs.map(({ a, b }) => sameClaimQuestion(a, b))];
-  if (questions.length === 0) return [];
-  const answers = await ask(questions);
-  if (answers === null) return null;
-  const tells = [];
-  TELL_QUESTIONS.forEach((tell, t) => {
-    const hits = sentences.filter((_, s) => (answers[s * TELL_QUESTIONS.length + t] ?? 0) >= tell.threshold);
-    if (hits.length > 0) tells.push({ id: tell.id, count: hits.length, sample: sample(hits[0]?.text ?? "") });
-  });
-  const offset = sentences.length * TELL_QUESTIONS.length;
-  const cycled = pairs.filter((_, p) => (answers[offset + p] ?? 0) >= SAME_CLAIM_HELD);
-  for (const set of new Set(cycled.map((p) => p.set))) {
-    const inSet = cycled.filter((p) => p.set === set);
-    const { a, b } = inSet[0] ?? { a: "", b: "" };
-    tells.push({ id: "synonym-cycling", count: inSet.length, sample: sample(`"${a}" / "${b}"`) });
-  }
-  return tells;
-}
-
-// src/commands/ads/copy-hints.ts
-var COPY_KEYS = /* @__PURE__ */ new Set([
-  "headline",
-  "headlines",
-  "longheadline",
-  "longheadlines",
-  "shortheadline",
-  "shortheadlines",
-  "description",
-  "descriptions",
-  "primarytext",
-  "primarytexts",
-  "message",
-  "messages",
-  "commentary",
-  "body",
-  "bodies",
-  "text",
-  "calltoaction",
-  "linkdescription",
-  "sitelinktext",
-  "callout",
-  "callouts",
-  "introtext"
-]);
-var HEADLINE_SET_KEYS = /* @__PURE__ */ new Set(["headlines", "longheadlines", "shortheadlines"]);
-var MAX_HINTS = 5;
-var SYNONYM_PAIR_FLOOR = 2;
-function asStrings(value) {
-  const one = (v) => {
-    const text = typeof v === "string" ? v : v !== null && typeof v === "object" ? v.text : "";
-    return typeof text === "string" && text.trim() ? text : void 0;
-  };
-  const values = Array.isArray(value) ? value : [value];
-  return values.map(one).filter((v) => v !== void 0);
-}
-function collectCopy(value, depth = 0) {
-  const texts = [];
-  const headlineSets = [];
-  if (depth > 4 || value === null || typeof value !== "object") return { texts, headlineSets };
-  if (Array.isArray(value)) {
-    for (const item of value) {
-      const nested = collectCopy(item, depth + 1);
-      texts.push(...nested.texts);
-      headlineSets.push(...nested.headlineSets);
-    }
-    return { texts, headlineSets };
-  }
-  for (const [key, raw] of Object.entries(value)) {
-    const normalized = key.toLowerCase().replace(/[_-]/g, "");
-    const strings = COPY_KEYS.has(normalized) ? asStrings(raw) : [];
-    if (strings.length > 0) {
-      texts.push(...strings);
-      if (HEADLINE_SET_KEYS.has(normalized) && strings.length > 1) headlineSets.push(strings);
-      continue;
-    }
-    const nested = collectCopy(raw, depth + 1);
-    texts.push(...nested.texts);
-    headlineSets.push(...nested.headlineSets);
-  }
-  return { texts, headlineSets };
-}
-function hintFor(tell) {
-  if (tell.id === "synonym-cycling") {
-    return `AI COPY TELL \u2014 ${tell.count} headline pairs are the same claim reworded (${tell.sample}). A cycled set gives the auction nothing to choose between: make each headline a different claim, not a different verb.`;
-  }
-  return `AI COPY TELL (${tell.id}) \u2014 "${tell.sample}". This construction reads as machine-written; rewrite it as a plain, specific claim before publishing.`;
-}
-async function adCopyHints(payload, ask) {
-  const { texts, headlineSets } = collectCopy(payload);
-  if (texts.length === 0) return [];
-  const cacheDir = path.join(findWorkspaceRoot(process.cwd()) ?? process.cwd(), "canvas", ".cache");
-  const spent = [];
-  const judged = await judgedCopyTells(
-    { texts: texts.flatMap((t) => t.split("\n")), headlineSets },
-    ask ?? rememberedJev(path.join(cacheDir, "copy-tells.json"), (u) => spent.push(u))
-  ).catch(() => null);
-  await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
-  const cycled = (judged ?? []).filter((t) => t.id === "synonym-cycling" && t.count >= SYNONYM_PAIR_FLOOR).sort((a, b) => b.count - a.count).slice(0, 1);
-  const tells = [...cycled, ...(judged ?? []).filter((t) => t.id !== "synonym-cycling")];
-  tells.sort(
-    (a, b) => (b.id === "synonym-cycling" ? 1 : 0) - (a.id === "synonym-cycling" ? 1 : 0) || b.count - a.count
-  );
-  return tells.slice(0, MAX_HINTS).map(hintFor);
-}
-
-export {
-  capabilityFix,
-  booleanWordPositionalError,
-  adCopyHints
-};
-//# sourceMappingURL=chunk-5LHDRP5F.js.map

package/dist/chunk-5PFKCXTT.js

@@ -1,42 +0,0 @@
-import {
-  ApiError
-} from "./chunk-T2MH5SCT.js";
-import {
-  writeJson
-} from "./chunk-SHVQFDNY.js";
-
-// src/commands/studio/errors.ts
-var CREDIT_HINTS = ["credit", "top up", "billing", "quota"];
-function studioStartFix(message) {
-  const lower = message.toLowerCase();
-  if (CREDIT_HINTS.some((hint) => lower.includes(hint))) {
-    return {
-      action: "Stop generating and finish the task with assets that already exist",
-      explanation: "No generation will run until the plan is topped up, so retrying costs time and changes nothing. Source or reuse an image instead, complete the rest of the work, and tell the user the new artwork could not be produced."
-    };
-  }
-  return {
-    action: "Drop or correct the setting the message names, then run the command once more",
-    explanation: "The message says which model was chosen and what it accepts. If the setting is not essential to the brief, leave it out rather than switching model. Do not abort the wider job over one refused setting."
-  };
-}
-function failStudioCommand(error, opts = {}) {
-  if (error instanceof ApiError) {
-    writeJson({
-      ok: false,
-      error: {
-        code: error.code,
-        message: error.message,
-        ...opts.withFix ? { fix: studioStartFix(error.message) } : {}
-      }
-    });
-    process.exit(1);
-  }
-  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-  process.exit(1);
-}
-
-export {
-  failStudioCommand
-};
-//# sourceMappingURL=chunk-5PFKCXTT.js.map