@koda-sl/baker-cli 0.466.0 → 0.467.0

package/dist/screenshot-XFAYY4WW.js

@@ -0,0 +1,102 @@
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-ZBKBTTHD.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/screenshot.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.screenshot",
+  description: "Capture a website screenshot via ScreenshotOne. Auto-ingests on success.",
+  args: {
+    url: { type: "string", description: "URL to capture", required: true },
+    "full-page": { type: "boolean", description: "Full-page capture", required: false, default: false },
+    viewport: { type: "string", description: "WxH (e.g. 1440x900)", required: false },
+    format: { type: "string", description: "webp | png | jpg", required: false, default: "webp" },
+    context: {
+      type: "string",
+      description: "Free-text hint passed to Gemini describe (e.g. 'competitor pricing page screenshot')",
+      required: 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 full metadata", required: false, default: false }
+  }
+});
+var screenshotCommand = defineCommand({
+  meta: {
+    name: "screenshot",
+    description: "Screenshot a URL via ScreenshotOne. $0.009/capture. Auto-ingests to library.\n\nExample: baker images screenshot https://stripe.com --full-page"
+  },
+  args: {
+    url: { type: "positional", description: "URL to capture", required: false },
+    "full-page": { type: "boolean", description: "Full-page capture", required: false },
+    viewport: { type: "string", description: "WxH viewport (e.g. 1440x900)", required: false },
+    format: { type: "string", description: "webp|png|jpg", required: false },
+    context: { type: "string", description: "Description context hint", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const url = args.url;
+      if (!url) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "URL is required" } });
+        process.exit(1);
+      }
+      const body = { url };
+      if (args["full-page"]) body.fullPage = true;
+      if (args.format) body.format = args.format;
+      const viewport = args.viewport;
+      if (viewport) {
+        const match = viewport.match(/^(\d+)x(\d+)$/);
+        if (!match) {
+          writeJson({
+            ok: false,
+            error: { code: "VALIDATION_ERROR", message: "--viewport must be WxH (e.g. 1440x900)" }
+          });
+          process.exit(1);
+        }
+        body.viewportWidth = Number(match[1]);
+        body.viewportHeight = Number(match[2]);
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/screenshot", body);
+      writeProviderHits(data, data.hits, args, []);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        const isUrlProblem = err.code === "VALIDATION_ERROR" || err.code === "NOT_FOUND";
+        writeJson({
+          ok: false,
+          error: {
+            code: err.code,
+            message: err.message,
+            ...isUrlProblem ? {
+              fix: {
+                action: "reject",
+                explanation: "Verify the URL is correct and publicly reachable, then retry with a working address. If the page can't be captured, continue without this screenshot rather than stopping the job."
+              }
+            } : {}
+          }
+        });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  screenshotCommand
+};
+//# sourceMappingURL=screenshot-XFAYY4WW.js.map

package/dist/search-4HIOKYFR.js

@@ -0,0 +1,26 @@
+import {
+  buildSearchBody,
+  designedByDefault,
+  searchCommand,
+  searchErrorFix,
+  searchHints,
+  searchRejection,
+  unknownCountryFix
+} from "./chunk-P66JWKAL.js";
+import "./chunk-QTL4NJ5I.js";
+import "./chunk-G3KO2HFZ.js";
+import "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  buildSearchBody,
+  designedByDefault,
+  searchCommand,
+  searchErrorFix,
+  searchHints,
+  searchRejection,
+  unknownCountryFix
+};
+//# sourceMappingURL=search-4HIOKYFR.js.map

package/dist/search-D2IV7KFJ.js

@@ -0,0 +1,92 @@
+import {
+  ApiError,
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/search.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.search",
+  description: "Search images by text query. Only returns ready images.",
+  args: {
+    query: { type: "string", description: "Search query text", required: true },
+    limit: { type: "number", description: "Maximum results to return", required: false, default: 5 },
+    "min-score": { type: "number", description: "Minimum relevance score (0-1)", required: false },
+    "aspect-ratio": {
+      type: "string",
+      description: "Filter by aspect ratio (1:1, 16:9, 9:16, 2:3, 3:4, 1:2, 2:1, 4:5, 3:2, 4:3)",
+      required: false
+    },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
+  }
+});
+var searchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Semantic search images by text query. Uses hybrid BM25 + vector + reranking. Example: baker images search 'hero banner' --aspect-ratio 16:9 --tags logo"
+  },
+  args: {
+    query: { type: "positional", description: "Search query text", required: false },
+    limit: { type: "string", description: "Max results (default 5)", required: false },
+    "min-score": { type: "string", description: "Minimum relevance score (0-1)", required: false },
+    "aspect-ratio": {
+      type: "string",
+      description: "Filter by aspect ratio (1:1, 16:9, 9:16, 2:3, 3:4, 1:2, 2:1, 4:5, 3:2, 4:3)",
+      required: false
+    },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: 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 full metadata", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    process.stderr.write("[deprecated] `baker images search` \u2192 use `baker images library` (removed in next minor).\n");
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Search query is required" } });
+        process.exit(1);
+      }
+      const body = { query };
+      if (args.limit) {
+        body.limit = Number(args.limit);
+      }
+      if (args["aspect-ratio"]) {
+        body.aspectRatio = args["aspect-ratio"];
+      }
+      if (args.tags) {
+        body.tags = args.tags.split(",").filter(Boolean);
+      }
+      let data = await apiPost("/api/images/search", body);
+      const minScore = args["min-score"] ? Number(args["min-score"]) : void 0;
+      if (minScore !== void 0) {
+        data = data.filter((r) => typeof r.score === "number" && r.score >= minScore);
+      }
+      writeOutput(
+        { ok: true, data },
+        args.output || "json",
+        args.fields ? args.fields.split(",") : void 0,
+        args.full
+      );
+    } 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);
+    }
+  }
+});
+export {
+  searchCommand
+};
+//# sourceMappingURL=search-D2IV7KFJ.js.map

package/dist/search-IZPDHRJ4.js

@@ -0,0 +1,224 @@
+import {
+  READABLE_SHOT,
+  downloadReadableShot
+} from "./chunk-DNCLWSHO.js";
+import {
+  INSPIRATION_HINTS,
+  favoritesScopeHints,
+  parseNumber,
+  reportError,
+  splitList
+} from "./chunk-ZNNC6B75.js";
+import {
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/inspiration/search.ts
+import path from "path";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "landing.inspiration.search",
+  description: "Search the shared library of real landing-page sections for reference before you design. Start here: baker landing inspiration search 'pricing with a monthly/annual toggle'. Returns the idea behind each section plus a downloaded screenshot you can Read. Defaults to this company's saved sections; pass --scope all for the whole library.",
+  args: {
+    query: { type: "string", description: "What you want to see, in plain English", required: false },
+    type: {
+      type: "string",
+      description: "Comma list of section types: hero,pricing,faq,testimonials,\u2026",
+      required: false
+    },
+    composition: {
+      type: "string",
+      description: "Comma list of composition patterns (references/composition.md)",
+      required: false
+    },
+    register: {
+      type: "string",
+      description: "Comma list of visual registers: dev-tool-minimal,luxury-high-end,\u2026",
+      required: false
+    },
+    interaction: { type: "string", description: "Comma list of interaction patterns", required: false },
+    motion: {
+      type: "string",
+      description: "Comma list of motion kinds: scroll-reveal,marquee,parallax,\u2026",
+      required: false
+    },
+    media: { type: "string", description: "Comma list of media kinds", required: false },
+    device: { type: "string", description: "Comma list of content devices", required: false },
+    theme: { type: "string", description: "light | dark | mixed", required: false },
+    "max-rank": {
+      type: "number",
+      description: "Show>Tell rank ceiling 1-7; 3 means 'rank 3 or better'",
+      required: false
+    },
+    "min-craft": { type: "number", description: "Craft floor 0-1", required: false },
+    "min-fidelity": {
+      type: "number",
+      description: "Only sections whose markup reproduces this well (0-1)",
+      required: false
+    },
+    domain: { type: "string", description: "Restrict to one site", required: false },
+    "similar-to": {
+      type: "string",
+      description: "Section id \u2014 find sections that look like this one",
+      required: false
+    },
+    scope: { type: "string", description: "favorites (default) | all", required: false },
+    limit: { type: "number", description: "Max results (default 8)", required: false },
+    "no-images": { type: "boolean", description: "Skip downloading screenshots", required: false },
+    full: {
+      type: "boolean",
+      description: "Add every classification facet (theme, density, rank, interactions, media, devices, tags, headline)",
+      required: false
+    }
+  }
+});
+function buildSearchBody(args) {
+  const body = {};
+  const setList = (key, value) => {
+    const list = splitList(value);
+    if (list) Object.assign(body, { [key]: list });
+  };
+  if (args.query) body.query = String(args.query);
+  if (args["similar-to"]) body.similarToSectionId = String(args["similar-to"]);
+  setList("sectionType", args.type);
+  setList("composition", args.composition);
+  setList("visualRegister", args.register);
+  setList("interaction", args.interaction);
+  setList("motion", args.motion);
+  setList("mediaKind", args.media);
+  setList("contentDevice", args.device);
+  if (args.theme) body.theme = String(args.theme);
+  if (args.domain) body.domain = String(args.domain);
+  const maxRank = parseNumber(args["max-rank"]);
+  if (maxRank !== void 0) body.maxShowTellRank = maxRank;
+  const minCraft = parseNumber(args["min-craft"]);
+  if (minCraft !== void 0) body.minCraftScore = minCraft;
+  const minFidelity = parseNumber(args["min-fidelity"]);
+  if (minFidelity !== void 0) body.minFidelity = minFidelity;
+  const limit = parseNumber(args.limit);
+  body.limit = limit ?? 8;
+  body.scope = args.scope === "all" ? "all" : "favorites";
+  return body;
+}
+async function downloadShots(results) {
+  const dir = path.join(process.cwd(), ".baker", "inspiration");
+  const saved = /* @__PURE__ */ new Map();
+  await Promise.all(
+    results.map(async (result) => {
+      const file = await downloadReadableShot(
+        result.desktopShotUrl,
+        path.join(dir, `${result.id}.${READABLE_SHOT.extension}`)
+      );
+      if (file) saved.set(result.id, file);
+    })
+  );
+  return saved;
+}
+var searchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Search real landing-page sections for reference. Example: baker landing inspiration search 'dark developer hero with a terminal' --register dev-tool-minimal --scope all"
+  },
+  args: {
+    query: { type: "positional", description: "What you want to see, in plain English", required: false },
+    type: { type: "string", description: "Comma list of section types", required: false },
+    composition: { type: "string", description: "Comma list of composition patterns", required: false },
+    register: { type: "string", description: "Comma list of visual registers", required: false },
+    interaction: { type: "string", description: "Comma list of interaction patterns", required: false },
+    motion: { type: "string", description: "Comma list of motion kinds", required: false },
+    media: { type: "string", description: "Comma list of media kinds", required: false },
+    device: { type: "string", description: "Comma list of content devices", required: false },
+    theme: { type: "string", description: "light | dark | mixed", required: false },
+    "max-rank": { type: "string", description: "Show>Tell rank ceiling 1-7", required: false },
+    "min-craft": { type: "string", description: "Craft floor 0-1", required: false },
+    "min-fidelity": { type: "string", description: "Reproduction-fidelity floor 0-1", required: false },
+    domain: { type: "string", description: "Restrict to one site", required: false },
+    "similar-to": { type: "string", description: "Section id to find lookalikes of", required: false },
+    scope: { type: "string", description: "favorites (default) | all", required: false, default: "favorites" },
+    limit: { type: "string", description: "Max results (default 8)", required: false },
+    "no-images": { type: "boolean", description: "Skip downloading screenshots", required: false, default: false },
+    full: { type: "boolean", description: "Include every classification facet", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = buildSearchBody(args);
+      const data = await apiPost("/api/landing-inspiration/search", body);
+      const results = Array.isArray(data?.results) ? data.results : [];
+      const shots = args["no-images"] ? /* @__PURE__ */ new Map() : await downloadShots(results);
+      const full = args.full;
+      const rows = results.map((result) => ({
+        id: result.id,
+        // The id `page` takes. Its own schema says "from a search result's source
+        // id", and until this line no projection emitted one — so the ordering
+        // view could only be reached straight after `add`, never from a search.
+        page_id: result.sourceId,
+        section: result.sectionType,
+        composition: result.composition,
+        look: result.visualRegister,
+        motion: result.motionSummary,
+        why_it_works: result.whyItWorks,
+        craft: Number(result.craftScore?.toFixed?.(2) ?? result.craftScore),
+        fidelity: result.fidelity,
+        domain: result.domain,
+        // Only worth saying when it means something: >1 marks a section the site
+        // reuses across its pages, which is a stronger signal than a one-off.
+        ...result.pageCount > 1 ? { used_on_pages: result.pageCount } : {},
+        // With --no-images there is no file, so hand back the URL instead. A row
+        // with neither is a section the agent is asked to judge sight unseen,
+        // which is the one thing a visual library must never produce.
+        ...args["no-images"] ? { screenshot_url: result.desktopShotUrl ?? null } : { screenshot: shots.get(result.id) ?? null },
+        ...full ? {
+          theme: result.theme,
+          density: result.density,
+          show_tell_rank: result.showTellRank,
+          interactions: result.interactions,
+          media: result.mediaKinds,
+          devices: result.contentDevices,
+          tags: result.tags,
+          headline: result.headline,
+          source_url: result.sourceUrl
+        } : {}
+      }));
+      const hints = [INSPIRATION_HINTS.adapt];
+      const scopeHints = body.scope === "favorites" ? favoritesScopeHints(data.favoritesHealth, rows.length) : [];
+      if (scopeHints.length > 0) {
+        hints.push(...scopeHints);
+      } else if (rows.length === 0) {
+        hints.push(
+          body.scope === "favorites" ? "No matches in this company's saved sections. Retry with --scope all to search the whole library, or add a page with `baker landing inspiration add <url>`." : "No matches. Loosen the filters, or add reference pages with `baker landing inspiration add <url>`."
+        );
+      }
+      if (rows.length > 0 && data.moreInFullLibrary > 0) {
+        hints.push(`${data.moreInFullLibrary} more match in the full library \u2014 re-run with --scope all.`);
+      }
+      if (shots.size > 0) hints.push(`Screenshots saved to .baker/inspiration/ \u2014 Read them before deciding.`);
+      writeJson({
+        ok: true,
+        data: {
+          results: rows,
+          scope: data.scope,
+          more_in_full_library: data.moreInFullLibrary,
+          total: data.total,
+          // Only present when there was something to explain, so a healthy
+          // search pays nothing for it.
+          ...data.favoritesHealth ? { saved_pages: data.favoritesHealth } : {}
+        },
+        hints
+      });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+export {
+  buildSearchBody,
+  searchCommand
+};
+//# sourceMappingURL=search-IZPDHRJ4.js.map

package/dist/search-KFDL2IGG.js

@@ -0,0 +1,91 @@
+import {
+  ApiError,
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  videoNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/search.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "videos.search",
+  description: "Search videos by text query. Only returns ready videos.",
+  args: {
+    query: { type: "string", description: "Search query text", required: true },
+    limit: { type: "number", description: "Maximum results to return", required: false, default: 20 },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
+  }
+});
+function searchHints(results) {
+  const hints = [];
+  const parody = results.filter((r) => r.analysis?.tone === "parody").map((r) => r._id);
+  if (parody.length > 0) {
+    hints.push(
+      `tone: parody \u2014 ${parody.join(", ")}. These play the offer for laughs: fine for a social post, wrong as proof or on a landing page.`
+    );
+  }
+  const unchecked = results.filter((r) => r.analysis?.tone === void 0).map((r) => r._id);
+  if (unchecked.length > 0) {
+    hints.push(
+      `No format/tone/productClaims yet \u2014 ${unchecked.join(", ")}. Before putting one on a page, read its transcript, scenes and people (\`baker videos get <id> --full\`) and judge it yourself: is it about the offer, is it sincere, and who is speaking?`
+    );
+  }
+  return hints.length > 0 ? hints : void 0;
+}
+var searchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
+  },
+  args: {
+    query: { type: "positional", description: "Search query text", required: false },
+    limit: { type: "string", description: "Max results (default 20)", required: false },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: 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 full metadata", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Search query is required" } });
+        process.exit(1);
+      }
+      const body = { query };
+      if (args.limit) {
+        body.limit = Number(args.limit);
+      }
+      if (args.tags) {
+        body.tags = args.tags.split(",").filter(Boolean);
+      }
+      const data = await apiPost("/api/videos/search", body);
+      writeOutput(
+        { ok: true, data, hints: searchHints(data) },
+        args.output || "json",
+        args.fields ? args.fields.split(",") : void 0,
+        args.full,
+        videoNormalizer
+      );
+    } 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);
+    }
+  }
+});
+export {
+  searchCommand,
+  searchHints
+};
+//# sourceMappingURL=search-KFDL2IGG.js.map