@koda-sl/baker-cli 0.500.0 → 0.503.0

package/dist/chunk-ZNH45NXP.js

@@ -1,91 +0,0 @@
-import {
-  definitionPlatformOf,
-  parseDefinitionDelivery,
-  resolveDelivery,
-  resolveFormatList
-} from "./chunk-VOAWBGRQ.js";
-import {
-  AD_PLACEMENTS
-} from "./chunk-MCJ5I5LR.js";
-import {
-  CAPABILITY_SURFACES
-} from "./chunk-UI6BKYQD.js";
-import {
-  apiPost
-} from "./chunk-X7VQFLHI.js";
-
-// src/commands/canvas/scaffold-delivery.ts
-var flagText = (value) => typeof value === "string" || typeof value === "number" ? String(value).trim() || void 0 : void 0;
-function deliveryInputOf(flags, definition, idea) {
-  const platformsFlag = flagText(flags.platforms);
-  const legacyPlatform = flagText(flags.platform);
-  const legacyPlacements = flagText(flags.placements);
-  const aspect = flagText(flags.aspect);
-  const formatsFlag = flagText(flags.formats);
-  const targetAdSet = flagText(flags["target-adset"]);
-  return {
-    ...platformsFlag ? { platformsFlag } : {},
-    ...legacyPlatform ? { legacyPlatform } : {},
-    ...legacyPlacements ? { legacyPlacements } : {},
-    ...aspect ? { aspect } : {},
-    ...formatsFlag ? { formatsFlag } : {},
-    ...idea && idea.length > 0 ? { idea } : {},
-    definition,
-    ...targetAdSet ? { targetAdSet } : {}
-  };
-}
-function namesDelivery(flags) {
-  return [flags.platforms, flags.platform, flags.placements, flags.formats].some((f) => flagText(f) !== void 0);
-}
-var SURFACE_PLATFORMS = {
-  "meta-ads": "meta",
-  "linkedin-ads": "linkedin",
-  "google-ads": "google_demandgen",
-  "x-ads": "x",
-  "chatgpt-ads": "chatgpt"
-};
-async function connectedAdPlatforms() {
-  try {
-    const response = await apiPost("/api/capabilities", {}, { timeoutMs: 15e3 });
-    return response.data.surfaces.filter((s) => s.connected && CAPABILITY_SURFACES.includes(s.surface)).flatMap((s) => SURFACE_PLATFORMS[s.surface] ? [SURFACE_PLATFORMS[s.surface]] : []);
-  } catch {
-    return [];
-  }
-}
-async function scaffoldDelivery(flags, definitionText, idea) {
-  const definition = definitionText === null ? null : parseDefinitionDelivery(definitionText);
-  const input = deliveryInputOf(flags, definition, idea);
-  const resolved = resolveDelivery(input);
-  if (resolved.ok || resolved.error.code !== "platform_required") return resolved;
-  return resolveDelivery({ ...input, connected: await connectedAdPlatforms() });
-}
-function deliveryDefinitionFields(delivery) {
-  const platforms = delivery.platforms.map((p) => p.trim());
-  return {
-    // The collection names whole platforms; a placement named alone records its platform.
-    platforms: [...new Set(platforms.map(platformOfName))],
-    platform: definitionPlatformOf(platforms[0] ?? ""),
-    formats: resolveFormatList(delivery.formats)
-  };
-}
-function platformOfName(name) {
-  return AD_PLACEMENTS.find((p) => p.id === name)?.platform ?? name;
-}
-function deliveryNote(delivery, renderRatio) {
-  const from = {
-    flag: "as asked",
-    idea: "from the idea",
-    definition: "from _definition.md",
-    legacy_definition: "from _definition.md's platform",
-    adset: "from its Meta ad set"
-  };
-  return `Made for ${delivery.platforms.join(", ")} (${from[delivery.source]}): delivers ${delivery.formats.join(", ")}, the ${delivery.lead} designed first (rendered at ${renderRatio}) and every other size re-laid out from it.`;
-}
-
-export {
-  namesDelivery,
-  scaffoldDelivery,
-  deliveryDefinitionFields,
-  deliveryNote
-};
-//# sourceMappingURL=chunk-ZNH45NXP.js.map

package/dist/claim-CIUU5QEZ.js

@@ -1,198 +0,0 @@
-import {
-  failApi,
-  failValidation
-} from "./chunk-XYBSTW3P.js";
-import "./chunk-5MSRVAUZ.js";
-import "./chunk-CAZGM2NX.js";
-import "./chunk-NZS3KEQ2.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-UI6BKYQD.js";
-import "./chunk-ERSL4WZT.js";
-import {
-  apiPost,
-  validateConvexId
-} from "./chunk-X7VQFLHI.js";
-import "./chunk-LU4HI4KI.js";
-import {
-  requireChatId
-} from "./chunk-LGK7UWBN.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-Q7US4OOA.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-CIUU5QEZ.js.map

package/dist/companies-VV5XD3BP.js

@@ -1,196 +0,0 @@
-import {
-  csvOrJson,
-  handleLinkedinError
-} from "./chunk-I46D7YXI.js";
-import {
-  TABLE_OUTPUT_FORMATS,
-  outputFormatRefusal,
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-ZRP7Y2DM.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-AGBBTTKA.js";
-import {
-  linkedinCompaniesRequestSchema
-} from "./chunk-5MSRVAUZ.js";
-import "./chunk-CAZGM2NX.js";
-import "./chunk-NZS3KEQ2.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-UI6BKYQD.js";
-import "./chunk-ERSL4WZT.js";
-import {
-  apiPost
-} from "./chunk-X7VQFLHI.js";
-import "./chunk-LU4HI4KI.js";
-import {
-  getEnv
-} from "./chunk-LGK7UWBN.js";
-import "./chunk-Q7US4OOA.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-VV5XD3BP.js.map