@koda-sl/baker-cli 0.560.0 → 0.561.0

package/dist/favorites-536I3GZD.js

@@ -0,0 +1,178 @@
+import {
+  INSPIRATION_HINTS,
+  favoritesScopeHints,
+  parseNumber,
+  reportError,
+  splitList
+} from "./chunk-ZZ5B2ZRM.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.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-536I3GZD.js.map

package/dist/feed-W3ECHUEX.js

@@ -0,0 +1,177 @@
+import {
+  adFieldPlan,
+  adRows
+} from "./chunk-DEZBCK5P.js";
+import {
+  reportError,
+  splitList
+} from "./chunk-KDVYI4LC.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-CCYZJMZ7.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-W3ECHUEX.js.map

package/dist/feedback-36TL4GPS.js

@@ -0,0 +1,115 @@
+import {
+  readCreativeIdea,
+  withAnchor
+} from "./chunk-GUH2A5R5.js";
+import "./chunk-RHSKKWPO.js";
+import "./chunk-EJBLF2LI.js";
+import "./chunk-GQ4DMO5Q.js";
+import "./chunk-SJIEU3VG.js";
+import "./chunk-QPTYTM2X.js";
+import "./chunk-CP6RFWLW.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-Q5DFEVLE.js";
+import "./chunk-Y43FKOED.js";
+import "./chunk-OFMFBRSL.js";
+import "./chunk-3FLSRUID.js";
+import "./chunk-UKZKLXTE.js";
+import "./chunk-72VH4FPY.js";
+import "./chunk-N34A56X7.js";
+import "./chunk-KDAINT54.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-4H6XLX7E.js";
+import "./chunk-Y5PNLB24.js";
+import "./chunk-N3PASNUA.js";
+import "./chunk-HBRXFQQV.js";
+import "./chunk-X3GWGFZP.js";
+import "./chunk-GWLP45WQ.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-6QINKM6T.js";
+import "./chunk-H3HA22Z3.js";
+import "./chunk-DLM5OSHM.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-TK7VRZKM.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.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-QGAP4HA4.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-36TL4GPS.js.map

package/dist/feedback-VCYIVDO2.js

@@ -0,0 +1,136 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-PXLBPOI3.js";
+import {
+  PLATFORM_REPORT_KINDS,
+  feedbackReportRequestSchema
+} from "./chunk-TK7VRZKM.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/feedback/index.ts
+import { defineCommand } from "citty";
+var DOC = "__tooling__/docs/tools/baker/feedback.md";
+var ARGS = {
+  kind: {
+    type: "string",
+    description: "bug \u2014 something in Baker is broken (a command, check, hook, skill or doc does the wrong thing). feature \u2014 Baker has no way to do what the work needs.",
+    required: true
+  },
+  title: {
+    type: "string",
+    description: `One sentence, what is wrong or missing, in Baker's terms: "baker winning-ads has no way to read one country's ads".`,
+    required: true
+  },
+  body: {
+    type: "string",
+    description: "What you ran, what came back (the exact message), what you expected, and what you ruled out. Describe the problem, not the client: no names, emails or figures from their accounts.",
+    required: true
+  },
+  "user-asked": {
+    type: "boolean",
+    description: "Set when the user asked you to tell the Baker team. Leave it off when you are reporting on your own; the team reads which it was.",
+    required: false,
+    default: false
+  }
+};
+registerSchema({
+  command: "feedback.report",
+  description: `Start here when Baker itself is in the way: a command, check, hook, skill or doc that is broken, or a capability the work needs that Baker does not have. Example: baker feedback report --kind bug --title "verify fails on an archived test version" --body "\u2026" (add --user-asked when the user asked you to). Sent to the Baker team at once, with the client's details taken out; the answer names the issue it is on. Never a Task, never a message for the user to pass on. Then say one plain line to the user and keep going with what you can still do.`,
+  args: ARGS
+});
+var REPORT_HINTS = [
+  "The Baker team has it (or will within minutes, if it is still sending \u2014 nothing more to do). Tell the user in one plain line that you let the Baker team know \u2014 no ids, commands or file names \u2014 and never ask them to pass it on.",
+  "Then keep going: work around it with what this workspace still lets you change (the pages, Forms, Knowledge and Brand you own, a staged change instead of a blocked one), finish the rest of the job, and say plainly what is left undone. One broken piece should not stop the whole task.",
+  "It is not a Task: don't also file one for it."
+];
+function reportBody(args) {
+  if (!PLATFORM_REPORT_KINDS.includes(args.kind ?? "")) {
+    return { ok: false, error: `--kind is ${PLATFORM_REPORT_KINDS.join(" or ")}, got "${args.kind ?? ""}".` };
+  }
+  const parsed = feedbackReportRequestSchema.safeParse({
+    kind: args.kind,
+    title: args.title,
+    body: args.body,
+    askedByUser: args["user-asked"] === true
+  });
+  if (!parsed.success) {
+    return {
+      ok: false,
+      error: "A report needs a --title of at least 10 characters (one sentence, what is wrong or missing) and a --body of at least 20 (what you ran, what came back, what you expected)."
+    };
+  }
+  return { ok: true, body: parsed.data };
+}
+var ISSUE_WAIT_MS = 2e4;
+var ISSUE_POLL_MS = 2e3;
+async function waitForIssue(sent, read, sleep, budgetMs = ISSUE_WAIT_MS) {
+  let state = sent;
+  for (let waited = 0; state.status === "sending" && waited < budgetMs; waited += ISSUE_POLL_MS) {
+    await sleep(ISSUE_POLL_MS);
+    try {
+      state = await read();
+    } catch {
+      return state;
+    }
+  }
+  return state;
+}
+var reportCommand = defineCommand({
+  meta: {
+    name: "report",
+    description: `Tell the Baker team about a defect in Baker or a capability it lacks; sent to their tracker at once.
+Start here: baker feedback report --kind bug --title "<what is wrong, one sentence>" --body "<what you ran, what came back, what you expected>"`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const parsed = reportBody(args);
+    if (!parsed.ok) {
+      failValidation(parsed.error);
+    }
+    try {
+      const response = await apiPost("/api/feedback/report", parsed.body);
+      const data = await waitForIssue(
+        response.data,
+        async () => (await apiGet("/api/feedback/report", { id: response.data.id })).data,
+        (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+      );
+      writeJson({ ok: true, data, hints: REPORT_HINTS });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var feedbackCommand = defineCommand({
+  meta: {
+    name: "feedback",
+    description: `Report a defect in Baker, or a capability it lacks, to the Baker team \u2014 never to the user, never as a Task. Subcommands: report.
+Full guide: ${DOC}`
+  },
+  subCommands: { report: reportCommand }
+});
+export {
+  ISSUE_WAIT_MS,
+  REPORT_HINTS,
+  feedbackCommand,
+  reportBody,
+  waitForIssue
+};
+//# sourceMappingURL=feedback-VCYIVDO2.js.map