@koda-sl/baker-cli 0.530.0 → 0.532.0

package/dist/favorites-NSQX6HKB.js

@@ -0,0 +1,178 @@
+import {
+  INSPIRATION_HINTS,
+  favoritesScopeHints,
+  parseNumber,
+  reportError,
+  splitList
+} from "./chunk-JNSRQQDP.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/inspiration/favorites.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "landing.inspiration.favorites",
+  description: "List the reference sections this company has saved. This is what `search` looks at by default, so it is the client's own taste profile \u2014 read it before proposing a direction.",
+  args: {
+    type: { type: "string", description: "Comma list of section types to filter by", required: false },
+    limit: { type: "number", description: "Max results (default 30, capped at 100)", required: false },
+    full: {
+      type: "boolean",
+      description: "Add the transferable idea behind each saved section. Costs roughly 60% more; read the list first",
+      required: false
+    }
+  }
+});
+var favoritesCommand = defineCommand({
+  meta: {
+    name: "favorites",
+    description: "List this company's saved reference sections. Example: baker landing inspiration favorites --type hero,pricing"
+  },
+  args: {
+    type: { type: "string", description: "Comma list of section types", required: false },
+    limit: { type: "string", description: "Max results (default 30, capped at 100)", required: false },
+    full: { type: "boolean", description: "Include why_it_works per section", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = {};
+      const types = splitList(args.type);
+      if (types) params.type = types.join(",");
+      const limit = parseNumber(args.limit);
+      if (limit !== void 0) params.limit = String(limit);
+      const data = await apiGet("/api/landing-inspiration/favorites", params);
+      const sections = Array.isArray(data?.sections) ? data.sections : [];
+      const full = args.full;
+      const saved = data.savedPages ?? void 0;
+      writeJson({
+        ok: true,
+        data: {
+          // The pages the client actually saved, alongside the sections those
+          // pages yielded. These are different numbers, and conflating them is
+          // how a company with 234 saved pages was told it had saved nothing:
+          // 211 of them failed to be read, so they contribute no sections, and
+          // the section list alone made a broken library look like an unused one.
+          ...saved ? {
+            saved_pages: {
+              total: saved.savedPages,
+              usable: saved.usablePages,
+              studying: saved.studyingPages,
+              unreadable: saved.failedPages,
+              ...saved.failedExamples.length > 0 ? { unreadable_examples: saved.failedExamples } : {}
+            }
+          } : {},
+          sections: sections.map((section) => ({
+            id: section.id,
+            page_id: section.sourceId,
+            section: section.sectionType,
+            composition: section.composition,
+            look: section.visualRegister,
+            domain: section.domain,
+            // Behind --full: this is a 600-character paragraph, and at the
+            // default 30 rows it was about 60% of the response. Reading a taste
+            // profile is a question about *what* the client keeps saving —
+            // types, compositions, which sites — and the essay per row answers
+            // a question you only have once you have picked a row.
+            ...full ? { why_it_works: section.whyItWorks } : {}
+          }))
+        },
+        hints: [
+          // What the saved set is actually in — an empty profile, a broken one,
+          // or a healthy one — before anything is said about the sections.
+          ...favoritesScopeHints(saved, sections.length),
+          ...sections.length === 0 ? saved && saved.savedPages > 0 ? [] : [
+            "Nothing saved yet. Add a page the client admires with `baker landing inspiration add <url>`, or browse the whole library with `baker landing inspiration search --scope all`."
+          ] : [
+            "These are the client's taste signals \u2014 read them as direction, not as a component library.",
+            ...full ? [] : ["Add --full for the transferable idea behind each one."],
+            INSPIRATION_HINTS.adapt
+          ]
+        ]
+      });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+registerSchema({
+  command: "landing.inspiration.favorite",
+  description: "Save a reference section (or a whole page) to this company, so it shows up in the default search scope.",
+  args: {
+    id: { type: "string", description: "Section id, or page id with --page", required: true },
+    page: { type: "boolean", description: "Treat the id as a page rather than a section", required: false },
+    note: { type: "string", description: "Why this is worth keeping", required: false }
+  }
+});
+var favoriteCommand = defineCommand({
+  meta: {
+    name: "favorite",
+    description: "Save a reference section to this company. Example: baker landing inspiration favorite k57abc\u2026"
+  },
+  args: {
+    id: { type: "positional", description: "Section id (or page id with --page)", required: true },
+    page: { type: "boolean", description: "Treat the id as a page", required: false, default: false },
+    note: { type: "string", description: "Why this is worth keeping", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id;
+      const body = args.page ? { sourceId: id } : { sectionId: id };
+      const data = await apiPost("/api/landing-inspiration/favorite", {
+        ...body,
+        note: args.note
+      });
+      writeJson({
+        ok: true,
+        data: { id, favorited: data.favorited },
+        hints: [
+          "Saved. `search` looks at this company's saved sections by default, so this now shows up without --scope all."
+        ]
+      });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+registerSchema({
+  command: "landing.inspiration.unfavorite",
+  description: "Remove a reference section (or page) from this company's saved set.",
+  args: {
+    id: { type: "string", description: "Section id, or page id with --page", required: true },
+    page: { type: "boolean", description: "Treat the id as a page rather than a section", required: false }
+  }
+});
+var unfavoriteCommand = defineCommand({
+  meta: {
+    name: "unfavorite",
+    description: "Remove a reference section from this company's saved set. Example: baker landing inspiration unfavorite k57abc\u2026"
+  },
+  args: {
+    id: { type: "positional", description: "Section id (or page id with --page)", required: true },
+    page: { type: "boolean", description: "Treat the id as a page", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id;
+      const body = args.page ? { sourceId: id } : { sectionId: id };
+      const data = await apiPost("/api/landing-inspiration/unfavorite", body);
+      writeJson({ ok: true, data: { id, favorited: data.favorited } });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+export {
+  favoriteCommand,
+  favoritesCommand,
+  unfavoriteCommand
+};
+//# sourceMappingURL=favorites-NSQX6HKB.js.map

package/dist/feed-TKMMYAEH.js

@@ -0,0 +1,177 @@
+import {
+  adFieldPlan,
+  adRows
+} from "./chunk-D7Y3UNWO.js";
+import {
+  reportError,
+  splitList
+} from "./chunk-E34YYDCE.js";
+import {
+  apiGet
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/feed.ts
+import { defineCommand } from "citty";
+function buildFeedParams(input) {
+  const params = {};
+  const advertiser = splitList(input.advertiser);
+  if (advertiser.length > 0) {
+    params.advertiser = advertiser.join(",");
+  }
+  if (input.platform) {
+    params.platform = input.platform;
+  }
+  if (input.perAdvertiser !== void 0 && input.perAdvertiser !== "") {
+    params.per_advertiser = input.perAdvertiser;
+  }
+  if (input.limit !== void 0 && input.limit !== "") {
+    params.limit = input.limit;
+  }
+  const winnerCategory = splitList(input.winnerCategory);
+  if (winnerCategory.length > 0) {
+    params.winner_category = winnerCategory.join(",");
+  }
+  const format = splitList(input.format);
+  if (format.length > 0) {
+    params.format = format.join(",");
+  }
+  if (input.allKinds) {
+    params.all_kinds = "1";
+  }
+  return params;
+}
+registerSchema({
+  command: "winning-ads.feed",
+  description: "Winners across EVERY brand you follow, in one library. Start here to review your followed advertisers, then trim to specific ones with --advertiser. Capped per advertiser so no single brand floods the feed. Lean winner cards; add --full for DNA + longevity.",
+  args: {
+    advertiser: {
+      type: "string",
+      description: "Comma-separated followed advertiser ids to narrow to (from `following`). Omit for all follows.",
+      required: false
+    },
+    platform: {
+      type: "string",
+      description: "Filter to a single platform: meta|linkedin|tiktok|google",
+      required: false
+    },
+    "per-advertiser": {
+      type: "number",
+      description: "Spread per advertiser by default: each brand's best 3 first, the rest after, none dropped. Set 1-50 to keep at most N per brand, 0 for rank order",
+      required: false
+    },
+    limit: {
+      type: "number",
+      description: "Total winners across all follows 1-200 (default 40)",
+      required: false,
+      default: 40
+    },
+    "winner-category": { type: "string", description: "Comma-separated winner categories to include", required: false },
+    format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false },
+    "all-kinds": {
+      type: "boolean",
+      description: "Also return Google search text, Shopping and app ads. By default the feed shows designed pictures and videos only; --format text shows search ads alone.",
+      required: false,
+      default: false
+    }
+  }
+});
+var feedCommand = defineCommand({
+  meta: {
+    name: "feed",
+    description: "Winners across every brand you follow, each brand's best first. Example: baker winning-ads feed --output md"
+  },
+  args: {
+    advertiser: {
+      type: "string",
+      description: "Comma-separated followed advertiser ids to narrow to",
+      required: false
+    },
+    platform: {
+      type: "string",
+      description: "Filter to a single platform: meta|linkedin|tiktok|google",
+      required: false
+    },
+    "per-advertiser": {
+      type: "string",
+      description: "Spread per advertiser by default: each brand's best 3 first, the rest after, none dropped. Set 1-50 to keep at most N per brand, 0 for rank order",
+      required: false
+    },
+    limit: { type: "string", description: "Total winners 1-200 (default 40)", required: false },
+    "winner-category": { type: "string", description: "Comma-separated winner categories", required: false },
+    format: { type: "string", description: "Comma-separated formats", required: false },
+    "all-kinds": {
+      type: "boolean",
+      description: "Also return Google search text, Shopping and app ads (default: designed pictures and videos only)",
+      required: false,
+      default: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: {
+      type: "boolean",
+      description: "Include DNA detail (angle, persona, hook) + longevity",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = buildFeedParams({
+        advertiser: args.advertiser,
+        platform: args.platform,
+        perAdvertiser: args["per-advertiser"],
+        limit: args.limit,
+        winnerCategory: args["winner-category"],
+        format: args.format,
+        allKinds: args["all-kinds"]
+      });
+      const data = await apiGet("/api/ad-library/feed", params);
+      const output = args.output || "json";
+      const plan = adFieldPlan(args.fields, args.full);
+      const rawWinners = Array.isArray(data?.winners) ? data.winners : [];
+      const hints = [];
+      if ((data?.following_count ?? 0) === 0) {
+        hints.push('You don\'t follow any brands yet. Run `baker winning-ads follow "<domain>"` first.');
+      }
+      if (Array.isArray(data?.unknown_requested) && data.unknown_requested.length > 0) {
+        hints.push(
+          `Not in your follows (skipped): ${data.unknown_requested.join(", ")}. Check ids with \`baker winning-ads following\`.`
+        );
+      }
+      if (output === "json") {
+        const winners = adRows(rawWinners, plan);
+        writeJson({
+          ok: true,
+          data: {
+            winners,
+            following_count: data?.following_count ?? 0,
+            advertiser_ids: Array.isArray(data?.advertiser_ids) ? data.advertiser_ids : [],
+            ...hints.length > 0 ? { hints } : {}
+          }
+        });
+        return;
+      }
+      writeOutput({ ok: true, data: rawWinners }, output, plan.fields, plan.full, winningAdNormalizer);
+      for (const hint of hints) {
+        process.stderr.write(`${hint}
+`);
+      }
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  buildFeedParams,
+  feedCommand
+};
+//# sourceMappingURL=feed-TKMMYAEH.js.map

package/dist/feedback-MORAVN52.js

@@ -0,0 +1,111 @@
+import {
+  readCreativeIdea,
+  withAnchor
+} from "./chunk-JARRF5VX.js";
+import "./chunk-OPUEQSKM.js";
+import "./chunk-3OSBCYKA.js";
+import "./chunk-3JV4T6XW.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-ENUCJ6AO.js";
+import "./chunk-UROKPFIS.js";
+import "./chunk-3QQHPRRB.js";
+import "./chunk-ZOH672S6.js";
+import "./chunk-UFUYTWEF.js";
+import "./chunk-DWW5QSUF.js";
+import "./chunk-FSTDWVXG.js";
+import "./chunk-FUR7R4D7.js";
+import "./chunk-QOBA6PHB.js";
+import "./chunk-GYMZCJX6.js";
+import "./chunk-AGU4KGT6.js";
+import "./chunk-R5LRBDEM.js";
+import "./chunk-4Y7IJ2PU.js";
+import "./chunk-3WTCMBDC.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-BXUUKRMM.js";
+import "./chunk-RRC7F3QQ.js";
+import "./chunk-KITVYLEX.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-CNPYG4F3.js";
+import "./chunk-SVNH6P7O.js";
+import "./chunk-YJYKSMLF.js";
+import "./chunk-L763CNKH.js";
+import "./chunk-HVJJEQDQ.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-46YLDIQG.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/feedback.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = "Read what this company's reviewers said about creative versions: recent approved / rejected verdicts with reasons and notes, the top rejection reasons, what approved versions share (format, platform, option), and hints[] saying what to do differently. Start here before making or changing a creative: baker creatives feedback; then baker creatives feedback --slug <slug> for one creative's history and its idea (data.anchor: the message, the reference and what we take from it, the language; what an edit keeps). When the user reacts to a version in the chat, record it with baker creatives feedback record.";
+var SLUG_DESCRIPTION = "One creative's feedback (src/creatives/<slug>/), with its idea as data.anchor. Left out, the whole company's.";
+var FULL_DESCRIPTION = "Every verdict as stored (up to 200), notes whole. Default is a summary plus the 8 latest.";
+registerSchema({
+  command: "creatives.feedback",
+  description: DESCRIPTION,
+  args: {
+    slug: { type: "string", description: SLUG_DESCRIPTION, required: false },
+    full: { type: "boolean", description: FULL_DESCRIPTION, required: false }
+  }
+});
+var readArgs = {
+  slug: { type: "string", description: SLUG_DESCRIPTION, required: false },
+  full: { type: "boolean", description: FULL_DESCRIPTION, required: false, default: false }
+};
+var feedbackReadCommand = defineCommand({
+  meta: { name: "read", description: `${DESCRIPTION} Runs by default when no subcommand is given.` },
+  args: readArgs,
+  run: async ({ args }) => {
+    try {
+      const body = {
+        ...typeof args.slug === "string" && args.slug.length > 0 ? { slug: args.slug } : {},
+        ...args.full === true ? { full: true } : {}
+      };
+      const [response, idea] = await Promise.all([
+        apiPost("/api/creatives/feedback", body),
+        body.slug ? readCreativeIdea(body.slug) : Promise.resolve(null)
+      ]);
+      writeJson(idea ? withAnchor(response, idea, { full: body.full === true }) : response);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+var feedbackCommand = defineCommand({
+  meta: { name: "feedback", description: DESCRIPTION },
+  subCommands: {
+    read: feedbackReadCommand,
+    record: () => import("./feedback-record-M3RB7H2C.js").then((m) => m.feedbackRecordCommand)
+  },
+  // `args` stays although the parent has no `run`: citty finds the subcommand
+  // name with THIS command's arg defs, so without them `--slug spring-offer`
+  // would read `spring-offer` as a subcommand. `default` (not `run`) serves the
+  // bare invocation, since citty runs a parent's `run` after its subcommand too.
+  args: readArgs,
+  default: "read"
+});
+export {
+  feedbackCommand
+};
+//# sourceMappingURL=feedback-MORAVN52.js.map