@koda-sl/baker-cli 0.386.0 → 0.387.0-dev.3bafd569e

package/dist/screenshot-ZHBSG3SI.js

@@ -0,0 +1,102 @@
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-5OVOLYY3.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WOTDHRNF.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-ZHBSG3SI.js.map

package/dist/screenshot-ZHBSG3SI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/screenshot.ts"],"sourcesContent":["import type { ImagesScreenshotRequest, ImagesScreenshotResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { OUTPUT_ARGS, writeProviderHits } from \"./providerHits.ts\";\n\nregisterSchema({\n  command: \"images.screenshot\",\n  description: \"Capture a website screenshot via ScreenshotOne. Auto-ingests on success.\",\n  args: {\n    url: { type: \"string\", description: \"URL to capture\", required: true },\n    \"full-page\": { type: \"boolean\", description: \"Full-page capture\", required: false, default: false },\n    viewport: { type: \"string\", description: \"WxH (e.g. 1440x900)\", required: false },\n    format: { type: \"string\", description: \"webp | png | jpg\", required: false, default: \"webp\" },\n    context: {\n      type: \"string\",\n      description: \"Free-text hint passed to Gemini describe (e.g. 'competitor pricing page screenshot')\",\n      required: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include full metadata\", required: false, default: false },\n  },\n});\n\nexport const screenshotCommand = defineCommand({\n  meta: {\n    name: \"screenshot\",\n    description:\n      \"Screenshot a URL via ScreenshotOne. $0.009/capture. Auto-ingests to library.\\n\\nExample: baker images screenshot https://stripe.com --full-page\",\n  },\n  args: {\n    url: { type: \"positional\", description: \"URL to capture\", required: false },\n    \"full-page\": { type: \"boolean\", description: \"Full-page capture\", required: false },\n    viewport: { type: \"string\", description: \"WxH viewport (e.g. 1440x900)\", required: false },\n    format: { type: \"string\", description: \"webp|png|jpg\", required: false },\n    context: { type: \"string\", description: \"Description context hint\", required: false },\n    ...OUTPUT_ARGS,\n  },\n  run: async ({ args }) => {\n    try {\n      const url = args.url as string | undefined;\n      if (!url) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"URL is required\" } });\n        process.exit(1);\n      }\n      const body: ImagesScreenshotRequest = { url };\n      if (args[\"full-page\"]) body.fullPage = true;\n      if (args.format) body.format = args.format as ImagesScreenshotRequest[\"format\"];\n      const viewport = args.viewport as string | undefined;\n      if (viewport) {\n        const match = viewport.match(/^(\\d+)x(\\d+)$/);\n        if (!match) {\n          writeJson({\n            ok: false,\n            error: { code: \"VALIDATION_ERROR\", message: \"--viewport must be WxH (e.g. 1440x900)\" },\n          });\n          process.exit(1);\n        }\n        body.viewportWidth = Number(match[1]);\n        body.viewportHeight = Number(match[2]);\n      }\n      if (args.context) body.descriptionContext = args.context as string;\n\n      const data = await apiPost<ImagesScreenshotResponse>(\"/api/images/screenshot\", body);\n      writeProviderHits(data, data.hits, args as Record<string, unknown>, []);\n    } catch (err) {\n      if (err instanceof ApiError) {\n        // A bad/unreachable URL comes back as a 4xx (VALIDATION_ERROR / NOT_FOUND).\n        // Tell the agent how to recover and to keep going rather than aborting the job.\n        const isUrlProblem = err.code === \"VALIDATION_ERROR\" || err.code === \"NOT_FOUND\";\n        writeJson({\n          ok: false,\n          error: {\n            code: err.code,\n            message: err.message,\n            ...(isUrlProblem\n              ? {\n                  fix: {\n                    action: \"reject\",\n                    explanation:\n                      \"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.\",\n                  },\n                }\n              : {}),\n          },\n        });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/search-332KFYZ6.js

@@ -0,0 +1,224 @@
+import {
+  READABLE_SHOT,
+  downloadReadableShot
+} from "./chunk-DNCLWSHO.js";
+import {
+  INSPIRATION_HINTS,
+  favoritesScopeHints,
+  parseNumber,
+  reportError,
+  splitList
+} from "./chunk-H7MLHG2I.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WOTDHRNF.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-332KFYZ6.js.map

package/dist/search-332KFYZ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/landing/inspiration/search.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { InspirationSearchRequest, InspirationSearchResponse } from \"@baker/api/landing-library\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeJson } from \"../../../output.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { favoritesScopeHints, INSPIRATION_HINTS, parseNumber, reportError, splitList } from \"./shared.ts\";\nimport { downloadReadableShot, READABLE_SHOT } from \"./shot.ts\";\n\nregisterSchema({\n  command: \"landing.inspiration.search\",\n  description:\n    \"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.\",\n  args: {\n    query: { type: \"string\", description: \"What you want to see, in plain English\", required: false },\n    type: {\n      type: \"string\",\n      description: \"Comma list of section types: hero,pricing,faq,testimonials,…\",\n      required: false,\n    },\n    composition: {\n      type: \"string\",\n      description: \"Comma list of composition patterns (references/composition.md)\",\n      required: false,\n    },\n    register: {\n      type: \"string\",\n      description: \"Comma list of visual registers: dev-tool-minimal,luxury-high-end,…\",\n      required: false,\n    },\n    interaction: { type: \"string\", description: \"Comma list of interaction patterns\", required: false },\n    motion: {\n      type: \"string\",\n      description: \"Comma list of motion kinds: scroll-reveal,marquee,parallax,…\",\n      required: false,\n    },\n    media: { type: \"string\", description: \"Comma list of media kinds\", required: false },\n    device: { type: \"string\", description: \"Comma list of content devices\", required: false },\n    theme: { type: \"string\", description: \"light | dark | mixed\", required: false },\n    \"max-rank\": {\n      type: \"number\",\n      description: \"Show>Tell rank ceiling 1-7; 3 means 'rank 3 or better'\",\n      required: false,\n    },\n    \"min-craft\": { type: \"number\", description: \"Craft floor 0-1\", required: false },\n    \"min-fidelity\": {\n      type: \"number\",\n      description: \"Only sections whose markup reproduces this well (0-1)\",\n      required: false,\n    },\n    domain: { type: \"string\", description: \"Restrict to one site\", required: false },\n    \"similar-to\": {\n      type: \"string\",\n      description: \"Section id — find sections that look like this one\",\n      required: false,\n    },\n    scope: { type: \"string\", description: \"favorites (default) | all\", required: false },\n    limit: { type: \"number\", description: \"Max results (default 8)\", required: false },\n    \"no-images\": { type: \"boolean\", description: \"Skip downloading screenshots\", required: false },\n    full: {\n      type: \"boolean\",\n      description:\n        \"Add every classification facet (theme, density, rank, interactions, media, devices, tags, headline)\",\n      required: false,\n    },\n  },\n});\n\nexport function buildSearchBody(args: Record<string, unknown>): InspirationSearchRequest {\n  const body: InspirationSearchRequest = {};\n  const setList = (key: keyof InspirationSearchRequest, value: unknown) => {\n    const list = splitList(value as string | undefined);\n    if (list) Object.assign(body, { [key]: list });\n  };\n\n  if (args.query) body.query = String(args.query);\n  if (args[\"similar-to\"]) body.similarToSectionId = String(args[\"similar-to\"]);\n  setList(\"sectionType\", args.type);\n  setList(\"composition\", args.composition);\n  setList(\"visualRegister\", args.register);\n  setList(\"interaction\", args.interaction);\n  setList(\"motion\", args.motion);\n  setList(\"mediaKind\", args.media);\n  setList(\"contentDevice\", args.device);\n  if (args.theme) body.theme = String(args.theme) as InspirationSearchRequest[\"theme\"];\n  if (args.domain) body.domain = String(args.domain);\n\n  const maxRank = parseNumber(args[\"max-rank\"] as string | undefined);\n  if (maxRank !== undefined) body.maxShowTellRank = maxRank;\n  const minCraft = parseNumber(args[\"min-craft\"] as string | undefined);\n  if (minCraft !== undefined) body.minCraftScore = minCraft;\n  const minFidelity = parseNumber(args[\"min-fidelity\"] as string | undefined);\n  if (minFidelity !== undefined) body.minFidelity = minFidelity;\n  const limit = parseNumber(args.limit as string | undefined);\n  body.limit = limit ?? 8;\n  body.scope = args.scope === \"all\" ? \"all\" : \"favorites\";\n  return body;\n}\n\n/**\n * Put the screenshots on disk.\n *\n * The whole library is a visual one, and an agent that can only read a text\n * description of a section is working from exactly the second-hand doctrine this\n * was built to replace. Downloading each hit so it can be `Read` is the point.\n *\n * At the readable size, not the archive size — see `shot.ts`. This runs at the\n * default limit of eight hits, so the difference is eight 2x PNGs of context\n * against eight design-width renditions.\n */\nasync function downloadShots(results: InspirationSearchResponse[\"results\"]): Promise<Map<string, string>> {\n  const dir = path.join(process.cwd(), \".baker\", \"inspiration\");\n  const saved = new Map<string, string>();\n  await Promise.all(\n    results.map(async (result) => {\n      const file = await downloadReadableShot(\n        result.desktopShotUrl,\n        path.join(dir, `${result.id}.${READABLE_SHOT.extension}`),\n      );\n      if (file) saved.set(result.id, file);\n    }),\n  );\n  return saved;\n}\n\nexport const searchCommand = defineCommand({\n  meta: {\n    name: \"search\",\n    description:\n      \"Search real landing-page sections for reference. Example: baker landing inspiration search 'dark developer hero with a terminal' --register dev-tool-minimal --scope all\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"What you want to see, in plain English\", required: false },\n    type: { type: \"string\", description: \"Comma list of section types\", required: false },\n    composition: { type: \"string\", description: \"Comma list of composition patterns\", required: false },\n    register: { type: \"string\", description: \"Comma list of visual registers\", required: false },\n    interaction: { type: \"string\", description: \"Comma list of interaction patterns\", required: false },\n    motion: { type: \"string\", description: \"Comma list of motion kinds\", required: false },\n    media: { type: \"string\", description: \"Comma list of media kinds\", required: false },\n    device: { type: \"string\", description: \"Comma list of content devices\", required: false },\n    theme: { type: \"string\", description: \"light | dark | mixed\", required: false },\n    \"max-rank\": { type: \"string\", description: \"Show>Tell rank ceiling 1-7\", required: false },\n    \"min-craft\": { type: \"string\", description: \"Craft floor 0-1\", required: false },\n    \"min-fidelity\": { type: \"string\", description: \"Reproduction-fidelity floor 0-1\", required: false },\n    domain: { type: \"string\", description: \"Restrict to one site\", required: false },\n    \"similar-to\": { type: \"string\", description: \"Section id to find lookalikes of\", required: false },\n    scope: { type: \"string\", description: \"favorites (default) | all\", required: false, default: \"favorites\" },\n    limit: { type: \"string\", description: \"Max results (default 8)\", required: false },\n    \"no-images\": { type: \"boolean\", description: \"Skip downloading screenshots\", required: false, default: false },\n    full: { type: \"boolean\", description: \"Include every classification facet\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const body = buildSearchBody(args as Record<string, unknown>);\n      const data = await apiPost<InspirationSearchResponse>(\"/api/landing-inspiration/search\", body);\n      const results = Array.isArray(data?.results) ? data.results : [];\n      const shots = (args[\"no-images\"] as boolean) ? new Map<string, string>() : await downloadShots(results);\n\n      const full = args.full as boolean;\n      const rows = results.map((result) => ({\n        id: result.id,\n        // The id `page` takes. Its own schema says \"from a search result's source\n        // id\", and until this line no projection emitted one — so the ordering\n        // view could only be reached straight after `add`, never from a search.\n        page_id: result.sourceId,\n        section: result.sectionType,\n        composition: result.composition,\n        look: result.visualRegister,\n        motion: result.motionSummary,\n        why_it_works: result.whyItWorks,\n        craft: Number(result.craftScore?.toFixed?.(2) ?? result.craftScore),\n        fidelity: result.fidelity,\n        domain: result.domain,\n        // Only worth saying when it means something: >1 marks a section the site\n        // reuses across its pages, which is a stronger signal than a one-off.\n        ...(result.pageCount > 1 ? { used_on_pages: result.pageCount } : {}),\n        // With --no-images there is no file, so hand back the URL instead. A row\n        // with neither is a section the agent is asked to judge sight unseen,\n        // which is the one thing a visual library must never produce.\n        ...((args[\"no-images\"] as boolean)\n          ? { screenshot_url: result.desktopShotUrl ?? null }\n          : { screenshot: shots.get(result.id) ?? null }),\n        ...(full\n          ? {\n              theme: result.theme,\n              density: result.density,\n              show_tell_rank: result.showTellRank,\n              interactions: result.interactions,\n              media: result.mediaKinds,\n              devices: result.contentDevices,\n              tags: result.tags,\n              headline: result.headline,\n              source_url: result.sourceUrl,\n            }\n          : {}),\n      }));\n\n      const hints = [INSPIRATION_HINTS.adapt];\n      // A thin favorites result is explained by the state of the saved set, not\n      // by the search — and the three states it can be in call for opposite\n      // next moves. The scope is never widened here; it is only made legible.\n      const scopeHints = body.scope === \"favorites\" ? favoritesScopeHints(data.favoritesHealth, rows.length) : [];\n      if (scopeHints.length > 0) {\n        hints.push(...scopeHints);\n      } else if (rows.length === 0) {\n        hints.push(\n          body.scope === \"favorites\"\n            ? \"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>`.\"\n            : \"No matches. Loosen the filters, or add reference pages with `baker landing inspiration add <url>`.\",\n        );\n      }\n      if (rows.length > 0 && data.moreInFullLibrary > 0) {\n        hints.push(`${data.moreInFullLibrary} more match in the full library — re-run with --scope all.`);\n      }\n      if (shots.size > 0) hints.push(`Screenshots saved to .baker/inspiration/ — Read them before deciding.`);\n\n      writeJson({\n        ok: true,\n        data: {\n          results: rows,\n          scope: data.scope,\n          more_in_full_library: data.moreInFullLibrary,\n          total: data.total,\n          // Only present when there was something to explain, so a healthy\n          // search pays nothing for it.\n          ...(data.favoritesHealth ? { saved_pages: data.favoritesHealth } : {}),\n        },\n        hints,\n      });\n    } catch (error) {\n      reportError(error);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/search-4PBMXXUY.js

@@ -0,0 +1,91 @@
+import {
+  ApiError,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema,
+  videoNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-WOTDHRNF.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-4PBMXXUY.js.map

package/dist/search-4PBMXXUY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/videos/search.ts"],"sourcesContent":["import type { VideosSearchRequest, VideosSearchResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { type OutputFormat, videoNormalizer, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\n\nregisterSchema({\n  command: \"videos.search\",\n  description: \"Search videos by text query. Only returns ready videos.\",\n  args: {\n    query: { type: \"string\", description: \"Search query text\", required: true },\n    limit: { type: \"number\", description: \"Maximum results to return\", required: false, default: 20 },\n    tags: { type: \"string\", description: \"Comma-separated tags to filter by\", required: false },\n  },\n});\n\n/**\n * A parody clip reads like any other hit — on-brand, phone-shot, often naming\n * the offer — and was put on a landing's reviews section as if it were one.\n * Named here because the pick is made from this list.\n */\nexport function searchHints(results: VideosSearchResponse): string[] | undefined {\n  const hints: string[] = [];\n  const parody = results.filter((r) => r.analysis?.tone === \"parody\").map((r) => r._id);\n  if (parody.length > 0) {\n    hints.push(\n      `tone: parody — ${parody.join(\", \")}. These play the offer for laughs: fine for a social post, wrong as proof or on a landing page.`,\n    );\n  }\n  // Catalogued before format/tone/productClaims existed. A missing tone is\n  // unknown, not sincere — the same tests apply, read from the clip itself.\n  const unchecked = results.filter((r) => r.analysis?.tone === undefined).map((r) => r._id);\n  if (unchecked.length > 0) {\n    hints.push(\n      `No format/tone/productClaims yet — ${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?`,\n    );\n  }\n  return hints.length > 0 ? hints : undefined;\n}\n\nexport const searchCommand = defineCommand({\n  meta: {\n    name: \"search\",\n    description:\n      \"Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"Search query text\", required: false },\n    limit: { type: \"string\", description: \"Max results (default 20)\", required: false },\n    tags: { type: \"string\", description: \"Comma-separated tags to filter by\", required: false },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include full metadata\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const query = args.query as string | undefined;\n      if (!query) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Search query is required\" } });\n        process.exit(1);\n      }\n\n      const body: VideosSearchRequest = { query };\n      if (args.limit) {\n        body.limit = Number(args.limit);\n      }\n      if (args.tags) {\n        body.tags = (args.tags as string).split(\",\").filter(Boolean);\n      }\n\n      const data = await apiPost<VideosSearchResponse>(\"/api/videos/search\", body);\n      writeOutput(\n        { ok: true, data, hints: searchHints(data) },\n        (args.output as OutputFormat) || \"json\",\n        args.fields ? args.fields.split(\",\") : undefined,\n        args.full as boolean,\n        videoNormalizer,\n      );\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAK9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,OAAO,EAAE,MAAM,UAAU,aAAa,qBAAqB,UAAU,KAAK;AAAA,IAC1E,OAAO,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,OAAO,SAAS,GAAG;AAAA,IAChG,MAAM,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,MAAM;AAAA,EAC5F;AACF,CAAC;AAOM,SAAS,YAAY,SAAqD;AAC/E,QAAM,QAAkB,CAAC;AACzB,QAAM,SAAS,QAAQ,OAAO,CAAC,MAAM,EAAE,UAAU,SAAS,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG;AACpF,MAAI,OAAO,SAAS,GAAG;AACrB,UAAM;AAAA,MACJ,uBAAkB,OAAO,KAAK,IAAI,CAAC;AAAA,IACrC;AAAA,EACF;AAGA,QAAM,YAAY,QAAQ,OAAO,CAAC,MAAM,EAAE,UAAU,SAAS,MAAS,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG;AACxF,MAAI,UAAU,SAAS,GAAG;AACxB,UAAM;AAAA,MACJ,2CAAsC,UAAU,KAAK,IAAI,CAAC;AAAA,IAC5D;AAAA,EACF;AACA,SAAO,MAAM,SAAS,IAAI,QAAQ;AACpC;AAEO,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,OAAO,EAAE,MAAM,cAAc,aAAa,qBAAqB,UAAU,MAAM;AAAA,IAC/E,OAAO,EAAE,MAAM,UAAU,aAAa,4BAA4B,UAAU,MAAM;AAAA,IAClF,MAAM,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,MAAM;AAAA,IAC1F,QAAQ,EAAE,MAAM,UAAU,aAAa,gCAAgC,UAAU,OAAO,SAAS,OAAO;AAAA,IACxG,QAAQ,EAAE,MAAM,UAAU,aAAa,0CAA0C,UAAU,MAAM;AAAA,IACjG,MAAM,EAAE,MAAM,WAAW,aAAa,yBAAyB,UAAU,OAAO,SAAS,MAAM;AAAA,EACjG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,QAAQ,KAAK;AACnB,UAAI,CAAC,OAAO;AACV,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,oBAAoB,SAAS,2BAA2B,EAAE,CAAC;AACjG,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,YAAM,OAA4B,EAAE,MAAM;AAC1C,UAAI,KAAK,OAAO;AACd,aAAK,QAAQ,OAAO,KAAK,KAAK;AAAA,MAChC;AACA,UAAI,KAAK,MAAM;AACb,aAAK,OAAQ,KAAK,KAAgB,MAAM,GAAG,EAAE,OAAO,OAAO;AAAA,MAC7D;AAEA,YAAM,OAAO,MAAM,QAA8B,sBAAsB,IAAI;AAC3E;AAAA,QACE,EAAE,IAAI,MAAM,MAAM,OAAO,YAAY,IAAI,EAAE;AAAA,QAC1C,KAAK,UAA2B;AAAA,QACjC,KAAK,SAAS,KAAK,OAAO,MAAM,GAAG,IAAI;AAAA,QACvC,KAAK;AAAA,QACL;AAAA,MACF;AAAA,IACF,SAAS,KAAK;AACZ,UAAI,eAAe,UAAU;AAC3B,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,gBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,mBAAmB,EAAE,CAAC;AACvF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;","names":[]}