@koda-sl/baker-cli 0.538.0-dev.fc2958a1d → 0.538.0

package/dist/chunk-ZPHHJPDG.js

@@ -1,131 +0,0 @@
-import {
-  holdUnbilledSpend
-} from "./chunk-W3PJ7V4W.js";
-import {
-  askAboutText
-} from "./chunk-KAUW3OFC.js";
-
-// src/engine/brand/brand-doc.ts
-import { createHash } from "crypto";
-import { mkdir, readdir, readFile, writeFile } from "fs/promises";
-import path from "path";
-import { z } from "zod";
-var BRAND_DOC_MODEL = "google/gemini-3.5-flash-lite";
-var REQUEST = {
-  provider: { order: ["google-vertex"], allow_fallbacks: false },
-  seed: 0,
-  response_format: { type: "json_object" }
-};
-var PROMPT_VERSION = 3;
-var TIMEOUT_MS = 3e4;
-var BRAND_MD_CHARS = 32e3;
-var NOTE_CHARS = 600;
-var COMPANY_MD_CHARS = 4e3;
-var Font = z.object({
-  family: z.string().trim().min(1).max(60),
-  role: z.enum(["heading", "body", "any"]).catch("any"),
-  use: z.boolean()
-});
-var Color = z.object({
-  hex: z.string().trim().regex(/^#?[0-9a-fA-F]{6}$/).transform((h) => `#${h.replace(/^#/, "").toLowerCase()}`),
-  use: z.boolean()
-});
-var note = z.string().trim().min(1).max(NOTE_CHARS).nullable().optional().catch(null);
-var Reading = z.object({
-  name: z.string().trim().min(1).max(80).nullable().catch(null),
-  wordmark: z.array(z.string().trim().min(1).max(40)).catch([]),
-  logoNames: z.array(z.string().trim().min(1).max(40)).catch([]),
-  fonts: z.array(z.unknown()).catch([]),
-  colors: z.array(z.unknown()).catch([]),
-  voice: note,
-  imagery: note,
-  logoUsage: note
-});
-function brandDocPrompt(docs) {
-  return [
-    "You read a company's brand guidelines (BRAND.md), the start of its company profile (COMPANY.md) and the file names of its logos. They may be written in any language, or several. Extract only what they state; never invent a value.",
-    "",
-    "Return JSON only, in this shape:",
-    '{"name": string | null, "wordmark": string[], "logoNames": string[], "fonts": [{"family": string, "role": "heading" | "body" | "any", "use": boolean}], "colors": [{"hex": "#rrggbb", "use": boolean}], "voice": string | null, "imagery": string | null, "logoUsage": string | null}',
-    "",
-    `- name: the brand's name exactly as written ("# Zernio Brand Guidelines" names Zernio). null when neither document states one, as in an unfilled template ("# Brand Guidelines", "# Company", TODO).`,
-    `- wordmark: every word the documents say the logo prints, as they quote it ("Wordmark: \\"permut\\"" gives "permut"; 'symbol plus "Cubbo" wordmark' gives "Cubbo"), even when it is also the name. [] when they quote none.`,
-    '- logoNames: a product or brand name a logo file name carries ("logo-engage-blue.png" gives "Engage"). Colours, variants, sizes and formats (dark, white, icon, isotype, png) are not names. [] when none.',
-    `- fonts: every typeface the guidelines name, by its family name exactly, the banned ones included. role is heading, body, or any when they do not say. use is false when the guidelines ban it, forbid it or say to avoid it or never use it, in any wording or language; true when the brand uses it. Only a named typeface counts: a generic family (sans-serif, serif, monospace, system-ui) or the operating system's own fonts ("system stack", "system fonts") is not one, so leave it out.`,
-    "- colors: every hex colour the guidelines give. use is false when they ban it or say to avoid it, true when it is a brand colour.",
-    "- voice: how the brand speaks, as the guidelines put it, at most two sentences in their language. null when they do not say.",
-    "- imagery: what the brand's pictures look like and never look like (photography, illustration, people; a ```generation-style block says it too), at most two sentences in their language. null when they do not say.",
-    "- logoUsage: which logo file an ad uses and how it must appear (which file for which product, line or background, what never to do to it), at most two sentences in their language. null when they do not say.",
-    "",
-    "<brand_md>",
-    (docs.brandMd ?? "").slice(0, BRAND_MD_CHARS),
-    "</brand_md>",
-    "<company_md>",
-    (docs.companyMd ?? "").slice(0, COMPANY_MD_CHARS),
-    "</company_md>",
-    "<logo_files>",
-    (docs.logoFiles ?? []).join("\n"),
-    "</logo_files>"
-  ].join("\n");
-}
-function parseBrandDoc(answer) {
-  const parsed = Reading.safeParse(answer);
-  if (!parsed.success) return null;
-  const fonts = parsed.data.fonts.flatMap((f) => {
-    const font = Font.safeParse(f);
-    return font.success ? [font.data] : [];
-  });
-  const colors = parsed.data.colors.flatMap((c) => {
-    const color = Color.safeParse(c);
-    return color.success ? [color.data] : [];
-  });
-  const { voice, imagery, logoUsage } = parsed.data;
-  return {
-    ...parsed.data.name ? { name: parsed.data.name } : {},
-    wordmark: [.../* @__PURE__ */ new Set([...parsed.data.wordmark, ...parsed.data.logoNames])],
-    fonts,
-    colors,
-    ...voice ? { voice } : {},
-    ...imagery ? { imagery } : {},
-    ...logoUsage ? { logoUsage } : {}
-  };
-}
-function brandDocReader(cacheDir, onSpend) {
-  return async (docs) => {
-    const prompt = brandDocPrompt(docs);
-    const key = createHash("sha256").update(JSON.stringify([PROMPT_VERSION, BRAND_DOC_MODEL, prompt])).digest("hex");
-    const file = path.join(cacheDir, "brand-doc", `${key}.json`);
-    const cached = parseBrandDoc(await readFile(file, "utf8").then(JSON.parse, () => null));
-    if (cached) return cached;
-    const spent = [];
-    const answer = await askAboutText(BRAND_DOC_MODEL, prompt, (u) => onSpend ? onSpend(u) : spent.push(u), {
-      timeoutMs: TIMEOUT_MS,
-      request: REQUEST
-    }).catch(() => null);
-    await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
-    const reading = parseBrandDoc(answer);
-    if (reading) {
-      await mkdir(path.dirname(file), { recursive: true }).catch(() => void 0);
-      await writeFile(file, JSON.stringify(reading), "utf8").catch(() => void 0);
-    }
-    return reading;
-  };
-}
-var LOGO_FILE = /logo|lockup|wordmark|isotype|isologo/i;
-async function workspaceBrandDocs(root) {
-  const read = (rel) => readFile(path.join(root, rel), "utf8").catch(() => null);
-  const logoFiles = (await readdir(path.join(root, "src", "brand", "logos")).catch(() => [])).filter((f) => /\.(png|jpe?g|webp|svg)$/i.test(f) && LOGO_FILE.test(f)).sort();
-  return { brandMd: await read("src/brand/BRAND.md"), companyMd: await read("COMPANY.md"), logoFiles };
-}
-async function readWorkspaceBrandDoc(root, opts = {}) {
-  const docs = await workspaceBrandDocs(root);
-  if (!docs.brandMd?.trim() && !docs.companyMd?.trim()) return null;
-  const read = opts.read ?? brandDocReader(path.join(root, "canvas", ".cache"), opts.onSpend);
-  return await read(docs).catch(() => null);
-}
-
-export {
-  LOGO_FILE,
-  readWorkspaceBrandDoc
-};
-//# sourceMappingURL=chunk-ZPHHJPDG.js.map

package/dist/claim-NM5T33W6.js

@@ -1,200 +0,0 @@
-import {
-  failApi,
-  failValidation
-} from "./chunk-XBMZNFN7.js";
-import "./chunk-XXS6SUVM.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-BNO3EFGR.js";
-import {
-  apiPost,
-  validateConvexId
-} from "./chunk-C35UMKYG.js";
-import "./chunk-ELAYD7O3.js";
-import {
-  requireChatId
-} from "./chunk-LBIF6FJY.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-TRXGJZDL.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/actions/claim.ts
-import { defineCommand } from "citty";
-
-// src/commands/actions/skillCatalog.ts
-import { existsSync, readdirSync, readFileSync } from "fs";
-import { dirname, join } from "path";
-var DESCRIPTION_MAX = 600;
-var SKILLS_SUBPATH = join(".claude", "skills");
-var EXCLUDED_SKILLS = /* @__PURE__ */ new Set(["actions"]);
-function stripQuotes(value) {
-  const trimmed = value.trim();
-  if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
-    return trimmed.slice(1, -1).replace(/\\"/g, '"').replace(/\\n/g, "\n");
-  }
-  if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
-    return trimmed.slice(1, -1).replace(/''/g, "'");
-  }
-  return trimmed;
-}
-function extractFrontmatterLines(md) {
-  if (!md.startsWith("---")) return null;
-  const end = md.indexOf("\n---", 3);
-  if (end === -1) return null;
-  return md.slice(md.indexOf("\n", 3) + 1, end).split("\n");
-}
-var BLOCK_SCALAR = /^([|>])[+-]?$/;
-function collectBlockLines(lines, start) {
-  const collected = [];
-  for (let i = start; i < lines.length; i++) {
-    const line = lines[i] ?? "";
-    if (line.trim() === "") {
-      collected.push("");
-    } else if (/^\s/.test(line)) {
-      collected.push(line.trim());
-    } else {
-      break;
-    }
-  }
-  while (collected.length > 0 && collected.at(-1) === "") collected.pop();
-  return collected;
-}
-function foldLines(collected) {
-  const paragraphs = [];
-  let buffer = [];
-  for (const line of collected) {
-    if (line === "") {
-      if (buffer.length > 0) paragraphs.push(buffer.join(" "));
-      buffer = [];
-    } else {
-      buffer.push(line);
-    }
-  }
-  if (buffer.length > 0) paragraphs.push(buffer.join(" "));
-  return paragraphs.join("\n");
-}
-function readBlockScalar(lines, start, style) {
-  const collected = collectBlockLines(lines, start);
-  return style === "|" ? collected.join("\n") : foldLines(collected);
-}
-function readField(lines, field) {
-  for (let i = 0; i < lines.length; i++) {
-    const match = (lines[i] ?? "").match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
-    if (!match || match[1] !== field) continue;
-    const inline = (match[2] ?? "").trim();
-    const scalar = inline.match(BLOCK_SCALAR);
-    if (scalar) {
-      return readBlockScalar(lines, i + 1, scalar[1]);
-    }
-    return stripQuotes(inline);
-  }
-  return null;
-}
-function parseSkillFrontmatter(md) {
-  const lines = extractFrontmatterLines(md);
-  if (!lines) return null;
-  const name = readField(lines, "name");
-  const description = readField(lines, "description");
-  if (!name || !description) return null;
-  const trimmed = description.length > DESCRIPTION_MAX ? `${description.slice(0, DESCRIPTION_MAX)}\u2026` : description;
-  return { name, description: trimmed };
-}
-function findSkillsDir(startDir) {
-  let dir = startDir;
-  for (; ; ) {
-    const candidate = join(dir, SKILLS_SUBPATH);
-    if (existsSync(candidate)) return candidate;
-    const parent = dirname(dir);
-    if (parent === dir) return null;
-    dir = parent;
-  }
-}
-function readSkillCatalog(startDir) {
-  const skillsDir = findSkillsDir(startDir);
-  if (!skillsDir) return [];
-  const entries = [];
-  for (const dirent of readdirSync(skillsDir, { withFileTypes: true })) {
-    if (!dirent.isDirectory() || EXCLUDED_SKILLS.has(dirent.name)) continue;
-    const skillFile = join(skillsDir, dirent.name, "SKILL.md");
-    if (!existsSync(skillFile)) continue;
-    try {
-      const parsed = parseSkillFrontmatter(readFileSync(skillFile, "utf8"));
-      if (parsed) entries.push(parsed);
-    } catch {
-    }
-  }
-  return entries.sort((a, b) => a.name.localeCompare(b.name));
-}
-
-// src/commands/actions/claim.ts
-registerSchema({
-  command: "actions.claim",
-  description: "Claim an action for the current chat (live \u2014 visible to other chats immediately). Claim only what you're actively working on now: it's required before `complete`, but NOT for `update` or `discard` (those stage without a claim). Returns action details plus a fast-model recommendation of which skills to load for the work (`recommendedSkills`) and a routing hint: load every skill that owns part of the work and the tool doc for each baker CLI family you'll use.",
-  args: {
-    id: { type: "string", description: "Action ID", required: true }
-  }
-});
-async function recommendSkills(actionId) {
-  const skills = readSkillCatalog(process.cwd());
-  if (skills.length === 0) return [];
-  const response = await apiPost("/api/actions/recommend-skills", {
-    actionId,
-    skills
-  });
-  return response.data.recommendations;
-}
-var ROUTING_HINT = "Actions often span several surfaces (a landing page plus a Google Ads change, a sheet pull plus an audience upload). Before starting, load EVERY skill that owns part of the work and read the tool doc (__tooling__/docs/tools/baker/<family>.md) for each baker CLI family you'll use. If the action references source material living in a connected tool (an email attachment, a call, a CRM record, a spreadsheet), reach for that tool too. If it describes recurring or future-dated work, it belongs on a schedule \u2014 see __tooling__/docs/tools/baker/scheduled-agents.md.";
-function buildHints(recommendations) {
-  if (recommendations.length === 0) {
-    return ["Review the action name, description, and tags above.", ROUTING_HINT];
-  }
-  return [
-    "Recommended skills for this action (load the ones you'll use):",
-    ...recommendations.map((r) => `  /${r.name} \u2014 ${r.reason}`),
-    "Suggestions come from the action's name/description/tags only \u2014 the work may need more.",
-    ROUTING_HINT
-  ];
-}
-var claimCommand = defineCommand({
-  meta: {
-    name: "claim",
-    description: "Claim an action so other chats see you're working on it. Required before `complete` (update and discard don't need a claim). Example: baker actions claim <action-id>"
-  },
-  args: {
-    id: { type: "positional", description: "Action ID", required: false },
-    "action-id": { type: "string", description: "Action ID", required: false }
-  },
-  run: async ({ args }) => {
-    try {
-      const id = args.id || args["action-id"];
-      if (!id) {
-        failValidation("Action ID is required.");
-      }
-      validateConvexId(id);
-      const chatId = requireChatId();
-      const response = await apiPost("/api/actions/claim", {
-        actionId: id,
-        chatId
-      });
-      let recommendedSkills = [];
-      try {
-        recommendedSkills = await recommendSkills(id);
-      } catch {
-      }
-      const data = response.data ? { ...response.data, recommendedSkills } : response.data;
-      writeJson({ ok: response.ok, data, hints: buildHints(recommendedSkills) });
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-export {
-  claimCommand
-};
-//# sourceMappingURL=claim-NM5T33W6.js.map

package/dist/companies-VBNBS6LR.js

@@ -1,198 +0,0 @@
-import {
-  csvOrJson,
-  handleLinkedinError
-} from "./chunk-GQ4D3BT6.js";
-import {
-  TABLE_OUTPUT_FORMATS,
-  outputFormatRefusal,
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-EAHBTBVR.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-3PG7O3ZW.js";
-import {
-  linkedinCompaniesRequestSchema
-} from "./chunk-XXS6SUVM.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-BNO3EFGR.js";
-import {
-  apiPost
-} from "./chunk-C35UMKYG.js";
-import "./chunk-ELAYD7O3.js";
-import {
-  getEnv
-} from "./chunk-LBIF6FJY.js";
-import "./chunk-TRXGJZDL.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/linkedin/companies.ts
-import { defineCommand } from "citty";
-var COMPANIES_PAGE_SIZE = 100;
-var COMPANIES_TIMEOUT_MS = 18e4;
-var CSV_FIELDS = [
-  "org",
-  "name",
-  "domain",
-  "domainSource",
-  "impressions",
-  "clicks",
-  "engagements",
-  "costLocal",
-  "videoViews",
-  "months",
-  "campaigns"
-];
-function companiesHints(data, request) {
-  const hints = [];
-  if (data.rows.length === 0) {
-    hints.push(
-      `No company shows up for ${data.query.start} to ${data.query.end}${data.query.minImpressions > 0 ? ` at --min-impressions ${data.query.minImpressions}` : ""}. LinkedIn reports companies 12-24h late and leaves out any with fewer than 3 events in a month, so a small or new campaign can have none yet. Try a longer period (--last-months 24), drop --min-impressions, or check the campaigns delivered with \`baker ads linkedin analytics\`.`
-    );
-    return hints;
-  }
-  const withDomain = data.rows.filter((row) => row.domain !== void 0).length;
-  if (withDomain > 0) {
-    hints.push(
-      `${withDomain} companies came back with a website domain \u2014 if HubSpot is connected, \`baker hubspot companies search --domains <domain,domain,\u2026> --with-deals\` (up to 100 per call) shows which are already accounts and which have deals.`
-    );
-  } else if (!request.withDomains && data.rows.length > 0) {
-    hints.push(
-      "Add --with-domains to get each company's website domain, ready for matching against your customer list."
-    );
-  }
-  if (data.totalCompanies > data.rows.length) {
-    const page = data.page ?? 1;
-    const first = (page - 1) * COMPANIES_PAGE_SIZE + 1;
-    const last = first + data.rows.length - 1;
-    const next = last < data.totalCompanies ? ` \u2014 --page ${page + 1} for the next ${COMPANIES_PAGE_SIZE}, ` : " \u2014 ";
-    hints.push(
-      `Showing companies ${first}-${last} of ${data.totalCompanies.toLocaleString("en")}, most engaged first${next}--full for all, or --min-impressions to trim the tail.`
-    );
-  }
-  if (data.query.by === "none" && data.rows.length > 0) {
-    hints.push("--by month shows when each company warmed up; --by campaign shows which campaigns reached it.");
-  }
-  return hints;
-}
-function csvList(raw) {
-  if (typeof raw !== "string") return void 0;
-  const items = raw.split(",").map((s) => s.trim()).filter(Boolean);
-  return items.length > 0 ? items : void 0;
-}
-var FLAG_OF_FIELD = {
-  accountId: "--account-id",
-  campaignIds: "--campaign-id",
-  lastMonths: "--last-months",
-  start: "--start",
-  end: "--end",
-  by: "--by",
-  minImpressions: "--min-impressions",
-  page: "--page"
-};
-function flagOf(field) {
-  return FLAG_OF_FIELD[field.split(".")[0] ?? ""] ?? (field || "args");
-}
-function optionalNumber(raw) {
-  return typeof raw === "string" && raw.trim() !== "" ? Number(raw) : void 0;
-}
-function bareAccountId(raw) {
-  return raw?.startsWith("urn:") ? raw.split(":").pop() : raw;
-}
-var companiesCommand = defineCommand({
-  meta: {
-    name: "companies",
-    description: `Which companies your LinkedIn ads reached \u2014 one row per company over the whole period, most engaged first.
-
-Start here for "which companies are our ads warming", ABM reporting, or building a warm-account list.
-Rows: {org, name, impressions, clicks, engagements, costLocal}. Defaults: the last 12 calendar
-months, the only selected ad account, 100 companies a page (--page 2 for the next, --full for all).
-
-Examples:
-  baker ads linkedin companies                                          # last 12 months, whole account
-  baker ads linkedin companies --page 2                                 # the next 100 companies
-  baker ads linkedin companies --by month --min-impressions 50          # when each company warmed up
-  baker ads linkedin companies --campaign-id 333728193,810055513 --by campaign
-  baker ads linkedin companies --with-domains --output csv              # + website domain, for CRM matching
-  baker ads linkedin companies --last-months 3 --stats                  # + how complete LinkedIn's data is
-
-LinkedIn reports companies 12-24h late and leaves out any company with fewer than 3 events in a month,
-so small companies are undercounted. engagements = LinkedIn's totalEngagements.`
-  },
-  args: {
-    "account-id": {
-      type: "string",
-      description: "Ad account id (numeric or urn:li:sponsoredAccount:N). Default: the only selected account"
-    },
-    "campaign-id": { type: "string", description: "Comma-separated campaign ids \u2014 read only these campaigns" },
-    "last-months": { type: "string", description: "Calendar months back, including this one (1-24, default 12)" },
-    start: { type: "string", description: "Start date YYYY-MM-DD (instead of --last-months)" },
-    end: { type: "string", description: "End date YYYY-MM-DD (default today)" },
-    by: { type: "string", description: "none | month | campaign \u2014 break each company down (default none)" },
-    "with-domains": { type: "boolean", description: "Add each company's website domain and domainSource" },
-    "min-impressions": { type: "string", description: "Leave out companies under N impressions over the period" },
-    full: { type: "boolean", description: "Every company (not just a page of 100), plus videoViews" },
-    page: {
-      type: "string",
-      description: "Which page of 100 companies, most engaged first (default 1); totalCompanies counts them all"
-    },
-    stats: { type: "boolean", description: "Add read-quality stats: row counts, cost/reach/domain coverage" },
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
-  },
-  run: async ({ args }) => {
-    const input = {
-      accountId: bareAccountId(args["account-id"] || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID),
-      campaignIds: csvList(args["campaign-id"]),
-      lastMonths: optionalNumber(args["last-months"]),
-      start: args.start,
-      end: args.end,
-      by: args.by,
-      withDomains: Boolean(args["with-domains"]),
-      minImpressions: optionalNumber(args["min-impressions"]),
-      full: Boolean(args.full),
-      page: optionalNumber(args.page),
-      stats: Boolean(args.stats),
-      skipCache: Boolean(args["no-cache"])
-    };
-    const parsed = linkedinCompaniesRequestSchema.safeParse(input);
-    const formatRefusal = outputFormatRefusal(csvOrJson(args), TABLE_OUTPUT_FORMATS);
-    if (!parsed.success || formatRefusal !== null) {
-      const issues = parsed.success ? [] : parsed.error.issues;
-      const messages = issues.map((issue) => `${flagOf(issue.path.join("."))}: ${issue.message}`);
-      writeAdsJson({
-        ok: false,
-        error: { code: "INVALID_ARGS", message: [...messages, ...formatRefusal ? [formatRefusal] : []].join("; ") }
-      });
-      process.exit(1);
-    }
-    try {
-      const { data } = await apiPost(
-        "/api/ads/linkedin/companies",
-        input,
-        { timeoutMs: COMPANIES_TIMEOUT_MS }
-      );
-      const hints = companiesHints(data, parsed.data);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        const notes = [...data.warnings.map((w) => `${w.code}: ${w.message}`), ...hints];
-        writeAdsOutput(data.rows, fmt, CSV_FIELDS, notes);
-        return;
-      }
-      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-export {
-  companiesCommand,
-  companiesHints
-};
-//# sourceMappingURL=companies-VBNBS6LR.js.map