@koda-sl/baker-cli 0.509.0 → 0.511.0-dev.2d26314a2

package/dist/keywords-for-site-4AGYZ265.js

@@ -1,129 +0,0 @@
-import {
-  keywordsForSiteHints
-} from "./chunk-ZQXHOHSC.js";
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-GSKZ3ZDO.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-ZNRGH4NS.js";
-import "./chunk-4GAEB6NK.js";
-import "./chunk-EXELLNQS.js";
-import "./chunk-CAZGM2NX.js";
-import "./chunk-NZS3KEQ2.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-2TOIY2WN.js";
-import {
-  apiPost
-} from "./chunk-X7VQFLHI.js";
-import "./chunk-LU4HI4KI.js";
-import "./chunk-LGK7UWBN.js";
-import {
-  registerSchema
-} from "./chunk-Q7US4OOA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/research/keywords-for-site.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "research.keywords-for-site",
-  description: "Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
-  args: {
-    target: { type: "string", description: "Domain or URL to analyze (positional)", required: true },
-    location: {
-      type: "string",
-      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted \u2014 always set this for non-US markets",
-      required: false
-    },
-    language: {
-      type: "string",
-      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English markets",
-      required: false
-    },
-    sort: {
-      type: "string",
-      description: "Sort: search_volume, competition, cpc (default: search_volume)",
-      required: false
-    },
-    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
-    limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  }
-});
-var FIELDS = {
-  keyword: "Keyword the site targets",
-  search_volume: "Monthly search volume",
-  cpc: "Cost per click in USD",
-  competition: "LOW, MEDIUM, or HIGH",
-  competition_index: "Competition score 0-100"
-};
-var keywordsForSiteCommand = defineCommand({
-  meta: {
-    name: "keywords-for-site",
-    description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
-
-Examples:
-  baker research keywords-for-site "competitor.com"
-  baker research keywords-for-site "competitor.com" --type paid --limit 20
-  baker research keywords-for-site "competitor.com" --type organic --location uk`
-  },
-  args: {
-    target: { type: "positional", description: "Domain or URL to analyze", required: true },
-    location: { type: "string", description: "Country code or location code (default: us)", required: false },
-    language: { type: "string", description: "Language code or name (default: en)", required: false },
-    sort: { type: "string", description: "Sort: search_volume, competition, cpc", required: false },
-    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
-    limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
-    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  },
-  run: async ({ args }) => {
-    const target = args.target;
-    const location = args.location || void 0;
-    const language = args.language || void 0;
-    const sort = args.sort || void 0;
-    const type = args.type || void 0;
-    const limit = args.limit ? Number(args.limit) : void 0;
-    const skipCache = args["no-cache"] ? true : void 0;
-    const queryContext = buildResearchQueryContext(location, language);
-    try {
-      const data = await apiPost("/api/research/keywords-for-site", {
-        target,
-        location,
-        language,
-        sort,
-        type,
-        limit,
-        skipCache
-      });
-      warnDefaults(queryContext);
-      const format = args.output || "json";
-      const hints = keywordsForSiteHints(data.length, queryContext, type);
-      if (format !== "json") {
-        writeResearchOutput(data, format);
-        writeResearchHints(hints, format);
-        return;
-      }
-      writeResearchJson({
-        ok: true,
-        data,
-        fields: FIELDS,
-        note: RESEARCH_DATA_NOTE,
-        query_context: queryContext,
-        hints
-      });
-    } catch (err) {
-      handleResearchError(err);
-    }
-  }
-});
-export {
-  keywordsForSiteCommand
-};
-//# sourceMappingURL=keywords-for-site-4AGYZ265.js.map

package/dist/landing-F4RB6L3I.js

@@ -1,28 +0,0 @@
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/landing/index.ts
-import { defineCommand } from "citty";
-var landingCommand = defineCommand({
-  meta: {
-    name: "landing",
-    description: `Design-quality tools for landing pages (src/pages/<slug>/), and downloading the published ones.
-
-Start here: \`baker landing critique <slug>\` after building or editing a landing.
-
-Subcommands:
-  baker landing inspiration      \u2014 reference library of real landing-page sections; search it during research, BEFORE writing the Direction Contract. Inspiration only: take the mechanism, never the words.
-  baker landing variant <control> <slug> \u2014 the alternative version of a page for an A/B test: shares the control's sections, forks only the component you name, so the two arms differ by exactly your hypothesis. Run \`baker experiment plan\` first.
-  baker landing critique <slug>   \u2014 design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, broken images) and reads the copy in any language for buzzwords, AI copy tells and a rival named in a comparison, tiered block/warn/advisory, respecting the client's brand. Records the critique the publish quality gate requires \u2014 run it before finishing a landing.
-  baker landing export start      \u2014 download the PUBLISHED landings as a ZIP of plain HTML ("download my landings", "send me the HTML"); \`baker landing export status <id>\` gives the link.`
-  },
-  subCommands: {
-    inspiration: () => import("./inspiration-QJNUFRNH.js").then((m) => m.inspirationCommand),
-    critique: () => import("./critique-MG7EUWWV.js").then((m) => m.critiqueCommand),
-    variant: () => import("./variant-NZL2ZMYM.js").then((m) => m.variantCommand),
-    export: () => import("./export-T5WPU75G.js").then((m) => m.exportCommand)
-  }
-});
-export {
-  landingCommand
-};
-//# sourceMappingURL=landing-F4RB6L3I.js.map

package/dist/languages-MEFQQBJ2.js

@@ -1,40 +0,0 @@
-import {
-  GOOGLE_ADS_LANGUAGES
-} from "./chunk-ZNRGH4NS.js";
-import "./chunk-4GAEB6NK.js";
-import {
-  writeAdsJson
-} from "./chunk-ZRP7Y2DM.js";
-import "./chunk-2TOIY2WN.js";
-import "./chunk-X7VQFLHI.js";
-import "./chunk-LU4HI4KI.js";
-import "./chunk-LGK7UWBN.js";
-import {
-  registerSchema
-} from "./chunk-Q7US4OOA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/google/keywords/languages.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "ads.google.keywords.languages",
-  description: "List all supported language IDs for --language flag in Google Ads keyword commands.",
-  args: {}
-});
-var FIELDS = {
-  id: "Language ID to pass as --language",
-  name: "Language name"
-};
-var languagesCommand = defineCommand({
-  meta: {
-    name: "languages",
-    description: "List all supported language IDs for --language flag."
-  },
-  run: () => {
-    writeAdsJson({ ok: true, data: GOOGLE_ADS_LANGUAGES, fields: FIELDS });
-  }
-});
-export {
-  languagesCommand
-};
-//# sourceMappingURL=languages-MEFQQBJ2.js.map

package/dist/leads-GZX36YYH.js

@@ -1,113 +0,0 @@
-import {
-  csvOrJson,
-  handleLinkedinError,
-  resolveAccountIdArg
-} from "./chunk-CLUJWAQE.js";
-import {
-  writeAdsJson,
-  writeAdsOutput
-} from "./chunk-ZRP7Y2DM.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-AGBBTTKA.js";
-import "./chunk-EXELLNQS.js";
-import "./chunk-CAZGM2NX.js";
-import "./chunk-NZS3KEQ2.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-2TOIY2WN.js";
-import {
-  apiGet
-} from "./chunk-X7VQFLHI.js";
-import "./chunk-LU4HI4KI.js";
-import "./chunk-LGK7UWBN.js";
-import "./chunk-Q7US4OOA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/linkedin/leads.ts
-import { defineCommand } from "citty";
-var DAY_MS = 864e5;
-function epochMs(value, flag) {
-  const text = String(value);
-  const ms = /^\d+$/.test(text) ? Number(text) : Date.parse(text);
-  if (Number.isNaN(ms)) {
-    throw new Error(`${flag} must be YYYY-MM-DD or epoch ms, got ${text}`);
-  }
-  return ms;
-}
-function leadsParams(args, accountId) {
-  const params = { "account-id": accountId };
-  if (args["form-id"]) params["form-id"] = String(args["form-id"]);
-  if (args["campaign-id"]) params["campaign-id"] = String(args["campaign-id"]);
-  const sinceMs = args["since-ms"] ? epochMs(args["since-ms"], "--since-ms") : args["since-days"] ? Date.now() - Number(args["since-days"]) * DAY_MS : void 0;
-  if (sinceMs) params["since-ms"] = String(sinceMs);
-  if (args.until) params["until-ms"] = String(epochMs(args.until, "--until"));
-  if (args["test-leads"]) params["test-leads"] = "true";
-  if (args.limit) params.limit = String(args.limit);
-  if (args["no-cache"]) params["skip-cache"] = "true";
-  return params;
-}
-var leadsCommand = defineCommand({
-  meta: {
-    name: "leads",
-    description: `List Lead Gen Form responses (playbook \xA707).
-
-LinkedIn retains LGF responses for 90 days only \u2014 sync to your CRM via this
-endpoint or you'll lose them.
-
-Examples:
-  baker ads linkedin leads --account-id 503001492
-  baker ads linkedin leads --account-id 503001492 --campaign-id 1234
-  baker ads linkedin leads --account-id 503001492 --form-id 5678 --since-days 7
-  baker ads linkedin leads --account-id 503001492 --output csv
-  baker ads linkedin leads --test-leads          # only the test leads Campaign Manager's preview submitted
-
-Answers come back with their question's label, and a multiple-choice answer as
-the option chosen. Form ids are the ones \`baker ads linkedin lead-forms\` lists.`
-  },
-  args: {
-    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
-    "account-urn": { type: "string", description: "Alias for --account-id" },
-    "form-id": { type: "string", description: "Filter by Lead Gen Form ID" },
-    "campaign-id": { type: "string", description: "Filter by campaign ID" },
-    "since-days": { type: "string", description: "Only responses submitted in the last N days" },
-    "since-ms": {
-      type: "string",
-      description: "Only responses submitted at or after this epoch ms (alternative to --since-days)"
-    },
-    until: { type: "string", description: "Only responses submitted before this date (YYYY-MM-DD or epoch ms)" },
-    "test-leads": { type: "boolean", description: "Only test leads (submitted from a form preview)" },
-    limit: { type: "string", description: "Max rows (default: 500)" },
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
-  },
-  run: async ({ args }) => {
-    const accountId = resolveAccountIdArg(args);
-    try {
-      const params = leadsParams(args, accountId);
-      const data = await apiGet("/api/ads/linkedin/leads", params);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        const flat = data.map((r) => ({
-          id: r.id,
-          formId: r.formId,
-          formName: r.formName ?? "",
-          campaignUrn: r.campaignUrn,
-          campaignName: r.campaignName ?? "",
-          testLead: r.testLead ?? false,
-          submittedAt: r.submittedAt ? new Date(r.submittedAt).toISOString() : "",
-          answers: (r.answers ?? []).map((a) => `${a.question}: ${a.answer}`).join(" | ")
-        }));
-        writeAdsOutput(flat, fmt);
-        return;
-      }
-      writeAdsJson({ ok: true, data });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-export {
-  leadsCommand
-};
-//# sourceMappingURL=leads-GZX36YYH.js.map

package/dist/learn-FWFTBWWN.js

@@ -1,205 +0,0 @@
-import {
-  setDefinitionFields
-} from "./chunk-YNYAT2TZ.js";
-import {
-  IDEAS_DIR,
-  readIdeas
-} from "./chunk-SWN6OHXG.js";
-import "./chunk-A3IQAONL.js";
-import {
-  parseDays,
-  withDefinitions
-} from "./chunk-FM6RRYJB.js";
-import "./chunk-QPESDKZC.js";
-import "./chunk-E44NXCTL.js";
-import {
-  findWorkspaceRoot
-} from "./chunk-EJGAJHLB.js";
-import "./chunk-LRV6M2WB.js";
-import "./chunk-MCJ5I5LR.js";
-import "./chunk-LNNTHEL7.js";
-import "./chunk-FOMFU2RX.js";
-import "./chunk-PSGIHSNC.js";
-import "./chunk-PONLPYD7.js";
-import {
-  failApi
-} from "./chunk-36MUCC42.js";
-import "./chunk-EXELLNQS.js";
-import "./chunk-CAZGM2NX.js";
-import "./chunk-NZS3KEQ2.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-2TOIY2WN.js";
-import {
-  apiPost
-} from "./chunk-X7VQFLHI.js";
-import "./chunk-LU4HI4KI.js";
-import "./chunk-LGK7UWBN.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-Q7US4OOA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/creatives/learn.ts
-import { readFileSync } from "fs";
-import { readFile, writeFile } from "fs/promises";
-import path from "path";
-import { defineCommand } from "citty";
-
-// src/commands/creatives/learn-model.ts
-var MIN_IMPRESSIONS = 1e3;
-var SEEN_ENOUGH = 5e3;
-var WINNER_RATIO = 0.8;
-var WINNER_MIN_RESULTS = 3;
-var FAILED_RATIO = 1.5;
-var SILENT_SPEND = 2;
-var SETTLED = /* @__PURE__ */ new Set(["winner", "failed", "inconclusive"]);
-var round = (n) => Math.round(n * 100) / 100;
-function totals(creatives) {
-  const spend = creatives.reduce((sum, c) => sum + c.spend, 0);
-  const impressions = creatives.reduce((sum, c) => sum + c.impressions, 0);
-  const results = creatives.reduce((sum, c) => sum + (c.results ?? 0), 0);
-  const clicks = creatives.reduce((sum, c) => sum + (c.ctr ?? 0) * c.impressions, 0);
-  return { spend, impressions, results, ctr: impressions > 0 ? round(clicks / impressions) : null };
-}
-function verdict(result, usual) {
-  if (result.impressions < MIN_IMPRESSIONS) return "testing";
-  if (usual !== null) {
-    if (result.results === 0 && result.spend >= SILENT_SPEND * usual) return "failed";
-    const ratio = result.vsAccount;
-    if (ratio !== null && result.results >= WINNER_MIN_RESULTS && ratio <= WINNER_RATIO) return "winner";
-    if (ratio !== null && ratio >= FAILED_RATIO) return "failed";
-  }
-  return result.impressions >= SEEN_ENOUGH ? "inconclusive" : "testing";
-}
-function ideaResult(own, usual, asOf) {
-  const mine = totals(own);
-  const costPerResult = mine.results > 0 ? round(mine.spend / mine.results) : null;
-  return {
-    asOf,
-    creatives: own.length,
-    ...own[0]?.currency ? { currency: own[0].currency } : {},
-    spend: round(mine.spend),
-    impressions: mine.impressions,
-    results: mine.results,
-    costPerResult,
-    ctr: mine.ctr,
-    vsAccount: usual !== null && costPerResult !== null ? round(costPerResult / usual) : null
-  };
-}
-function learnFromResults(ideas, creatives, asOf) {
-  const ideaOf = (c) => c.definition?.idea ?? null;
-  return ideas.flatMap((idea) => {
-    if (idea.status === "idea" || idea.status === "retired") return [];
-    const own = creatives.filter((c) => ideaOf(c) === idea.id);
-    if (own.length === 0) return [];
-    const rest = totals(creatives.filter((c) => ideaOf(c) !== idea.id));
-    const usual = rest.results > 0 ? rest.spend / rest.results : null;
-    const result = ideaResult(own, usual, asOf);
-    const to = verdict(result, usual);
-    if (to === "testing" && SETTLED.has(idea.status)) return [];
-    return [{ idea: idea.id, from: idea.status, to, result }];
-  });
-}
-
-// src/commands/creatives/learn.ts
-var DESCRIPTION = `Write back what each built idea's ads did in the live Meta account: every creative of the idea pooled, judged against the rest of the account's cost per result, and the verdict (winner, failed, inconclusive, testing) and frozen numbers written onto src/creatives/_ideas/<idea>.md. Run it before writing new ideas, and weekly.
-
-Start here:
-  baker creatives learn               # last 30 days, written onto the ideas
-  baker creatives learn --days 60
-  baker creatives learn --dry-run     # show the verdicts, write nothing
-
-A winner gets results at 0.8x the usual cost or less (3+ results); failed is 1.5x or more, or spend worth two usual results with none; under 1,000 impressions it is still testing.`;
-var ARGS = {
-  days: { type: "string", required: false, description: "Reporting window in days (default 30)" },
-  "dry-run": { type: "boolean", required: false, default: false, description: "Show the verdicts; write nothing" }
-};
-registerSchema({ command: "creatives.learn", description: DESCRIPTION, args: ARGS });
-function learnEnvelope(learnings, written, unreadable = []) {
-  const winners = learnings.filter((l) => l.to === "winner").map((l) => l.idea);
-  const failed = learnings.filter((l) => l.to === "failed").map((l) => l.idea);
-  const hints = [];
-  if (unreadable.length > 0) {
-    hints.push(
-      `Could not read ${unreadable.join(", ")}, so their results were not written: fix what \`baker creatives ideas\` names, then run this again.`
-    );
-  }
-  if (learnings.length === 0) {
-    hints.push(
-      "No built idea has ads delivering yet: nothing to learn. Ideas count once a published ad shows their creative."
-    );
-  }
-  if (winners.length > 0) {
-    hints.push(
-      `Build on ${winners.join(", ")}: keep the message and make it in a new format or for a new persona before any new idea.`
-    );
-  }
-  if (failed.length > 0) {
-    hints.push(
-      `${failed.join(", ")} lost: never repeat their message; \`baker creatives ideas\` flags an idea that does.`
-    );
-  }
-  return {
-    ok: true,
-    data: {
-      written,
-      ideas: learnings.map((l) => ({
-        idea: l.idea,
-        status: l.from === l.to ? l.to : `${l.from} \u2192 ${l.to}`,
-        ...l.result
-      }))
-    },
-    hints
-  };
-}
-async function writeBack(root, learnings) {
-  for (const learning of learnings) {
-    const file = path.join(root, IDEAS_DIR, `${learning.idea}.md`);
-    const raw = await readFile(file, "utf8");
-    await writeFile(file, setDefinitionFields(raw, { status: learning.to, result: learning.result }), "utf8");
-  }
-}
-function readDefinition(root, slug) {
-  try {
-    return readFileSync(path.join(root, "src", "creatives", slug, "_definition.md"), "utf8");
-  } catch {
-    return null;
-  }
-}
-function today() {
-  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-}
-var learnCommand = defineCommand({
-  meta: { name: "learn", description: DESCRIPTION },
-  args: ARGS,
-  async run({ args }) {
-    try {
-      const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
-      const days = parseDays(args.days);
-      const performance = withDefinitions(
-        await apiPost("/api/creatives/performance", days ? { days } : {}),
-        (slug) => readDefinition(root, slug)
-      );
-      const { ideas, unreadable } = await readIdeas(root);
-      const learnings = learnFromResults(ideas, performance.data.creatives, today());
-      const dryRun = args["dry-run"] === true;
-      if (!dryRun) await writeBack(root, learnings);
-      writeJson(
-        learnEnvelope(
-          learnings,
-          !dryRun && learnings.length > 0,
-          unreadable.map((u) => u.id)
-        )
-      );
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-export {
-  learnCommand,
-  learnEnvelope
-};
-//# sourceMappingURL=learn-FWFTBWWN.js.map