@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/variant-FLZJYGYL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/landing/variant.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { Dirent } from \"node:fs\";\nimport { mkdir, readdir, readFile, stat, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { ExperimentStatusResponse } from \"@baker/api/experiments\";\nimport { nextVariantNumber, variantNumberOf, variantOfSlug, variantSlug } from \"@baker/api/experiments/variants\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { repeatedValues } from \"../../lib/repeatedFlags.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { repointFile } from \"./repoint.ts\";\n\nregisterSchema({\n  command: \"landing.variant\",\n  description:\n    \"Create a new variant of a page, for an A/B test. The variant shares the page's sections instead of copying them, so the only difference between the two is the one you fork — which is the only way the test measures what you think it measures. Run `baker experiment plan` FIRST: most pages cannot settle most questions.\",\n  args: {\n    page: { type: \"string\", description: \"The page to make a variant of, by slug\", required: true },\n    fork: {\n      type: \"string\",\n      description:\n        \"The component the variant owns its own copy of, named as it appears under _components/ (`Hero.astro`, or `hero/Card.astro`). Repeat for several. Everything else is shared with the control, so a later edit to the control reaches both arms and cannot skew the test.\",\n      required: false,\n    },\n    because: {\n      type: \"string\",\n      description:\n        \"What you SAW that makes this worth building — the observation, not the change. Required here, before the page exists, because a reason written afterwards is a caption for a page rather than the reason for one.\",\n      required: true,\n    },\n    change: {\n      type: \"string\",\n      description: \"What is different about this version, in the client's words — “put the booking form in the hero”.\",\n      required: true,\n    },\n  },\n});\n\n/** One path segment, no traversal, not a `_`-private folder. */\nconst SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;\n\n/** The page's own identity, which is what its archive directory is keyed on. */\nasync function readInternalId(definitionPath: string): Promise<string | null> {\n  try {\n    const text = await readFile(definitionPath, \"utf8\");\n    return /^internalId:\\s*\"?([^\"\\s]+)\"?\\s*$/m.exec(text)?.[1] ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Variant numbers this page has already used up, including the archived ones.\n *\n * The archives matter as much as the live folders: reusing a number would\n * collide with a snapshot of an earlier version AND with every analytics row\n * recorded against it, which is a merge nothing downstream could detect.\n */\nasync function archivedVariantNumbers(root: string, internalId: string | null): Promise<number[]> {\n  if (!internalId) return [];\n  try {\n    const entries = await readdir(path.resolve(root, \"src/_variants\", internalId), { withFileTypes: true });\n    return entries\n      .filter((entry) => entry.isDirectory())\n      .map((entry) => Number(entry.name))\n      .filter((n) => Number.isInteger(n) && n > 0);\n  } catch {\n    return [];\n  }\n}\n\nfunction fail(code: string, message: string, fix?: Record<string, unknown>): never {\n  process.stderr.write(\n    `${JSON.stringify({ ok: false, error: { code, message, ...(fix ? { fix } : {}) } }, null, 2)}\\n`,\n  );\n  process.exit(2);\n}\n\nasync function isDir(p: string): Promise<boolean> {\n  try {\n    return (await stat(p)).isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nasync function exists(p: string): Promise<boolean> {\n  try {\n    await stat(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** Landing folders under src/pages/, for `error.fix` on a wrong slug. */\nasync function listLandingSlugs(root: string): Promise<string[]> {\n  try {\n    const entries = await readdir(path.resolve(root, \"src\", \"pages\"), { withFileTypes: true });\n    return entries\n      .filter((e) => e.isDirectory() && !e.name.startsWith(\"_\") && !e.name.startsWith(\".\"))\n      .map((e) => e.name)\n      .sort();\n  } catch {\n    return [];\n  }\n}\n\n/** Every `.astro` under a landing's `_components/`, as `_components/`-relative POSIX paths. */\nasync function listComponents(componentsDir: string, prefix = \"\"): Promise<string[]> {\n  let entries: Dirent[];\n  try {\n    entries = await readdir(componentsDir, { withFileTypes: true });\n  } catch {\n    return [];\n  }\n  const out: string[] = [];\n  for (const entry of entries) {\n    const rel = prefix ? `${prefix}/${entry.name}` : entry.name;\n    if (entry.isDirectory()) out.push(...(await listComponents(path.join(componentsDir, entry.name), rel)));\n    else if (entry.name.endsWith(\".astro\")) out.push(rel);\n  }\n  return out.sort();\n}\n\n/**\n * Match what the caller typed against the control's real components.\n *\n * Tolerant on purpose — `Hero`, `Hero.astro`, `_components/Hero.astro` and\n * `hero/Card.astro` all name something real, and refusing three of the four\n * would be a lookup the agent has to do by hand before every call.\n */\nexport function resolveForkName(requested: string, available: string[]): string | null {\n  const cleaned = requested.replace(/^\\.?\\/?(_components\\/)?/, \"\");\n  for (const candidate of [cleaned, `${cleaned}.astro`]) {\n    if (available.includes(candidate)) return candidate;\n  }\n  // Fall back to a unique basename match, so `Hero` finds `hero/Hero.astro`.\n  // Only when unambiguous: two `Card.astro` in different folders is a question,\n  // not a guess to make on the agent's behalf.\n  const basename = (p: string) => p.slice(p.lastIndexOf(\"/\") + 1);\n  const matches = available.filter((a) => basename(a) === cleaned || basename(a) === `${cleaned}.astro`);\n  return matches.length === 1 ? (matches[0] ?? null) : null;\n}\n\n/**\n * The components to fork, from repeated `--fork` flags or one comma-separated\n * list. Both, because a comma-separated list is what anyone types first.\n *\n * Read from `rawArgs` rather than from the parsed arg, and that is the whole\n * point of the parameter: citty declares no array arg type, so a repeated flag\n * collapses to its LAST value and arrives as a plain string —\n * `--fork Hero.astro --fork Cta.astro` reaches the handler as `\"Cta.astro\"`,\n * `Array.isArray` never fires, and the variant silently shares the control's\n * Hero while the hint tells the agent to edit only the Cta. The test then\n * measures a change that was never made, or one made in a shared section that\n * moves both arms. Nothing in the parsed args records that it happened.\n */\nexport function parseForks(fork: unknown, rawArgs?: readonly string[]): string[] {\n  const names = repeatedValues(rawArgs, \"fork\", fork)\n    .flatMap((s) => s.split(\",\"))\n    .map((s) => s.trim())\n    .filter((s) => s.length > 0);\n  return [...new Set(names)];\n}\n\n/**\n * Why the page cannot take a new version today, or null.\n *\n * Asked of Baker before a folder is written, because a variant of a page that\n * is already in a test is a folder nothing can use: `start` refuses it, and\n * until then it sits in the workspace looking like the version under test. One\n * page has one test at a time, and this is where that rule meets the agent —\n * before the work, with the test it would collide with named. A page whose\n * last test was won by a new version is taken too, until the fold lands.\n */\nexport function pageInTest(status: ExperimentStatusResponse, page: string): string | null {\n  for (const test of status.experiments) {\n    if (test.landingSlug !== page) continue;\n    if (test.status !== \"finished\") {\n      return `${page} is already in a test (${test.experimentId}, against ${test.variantSlug}, ${test.status}). One page has one test at a time — read it with \\`baker experiment status --landing ${page}\\`, and end it with \\`baker experiment finish\\` before building the next version.`;\n    }\n    if (test.fold === \"owed\" || test.fold === \"landing\") {\n      return `The last test on ${page} was won by ${test.variantSlug}, and the page is still being updated to match — run \\`baker experiment fold\\` and publish before building the next version.`;\n    }\n  }\n  return null;\n}\n\n/**\n * The variant's `_definition.md`: the page's identity, and a note saying what\n * this version changes. Nothing else.\n *\n * The frontmatter is the control's, because the collection schema and the\n * build need it and the two versions are one page: `metaTitle` and\n * `metaDescription` are deliberately identical, since the variant is served\n * under the control's URL and a different title would mean the visitor's tab\n * says something different depending on which version they landed in. Two\n * things differ — the `internalId` (it keys the version in Baker) and the\n * `internalTitle` (what a person reads in a list).\n *\n * The body is NOT the control's. The brief — campaign, audience, offer, proof —\n * was answered once and lives in the page's own `_definition.md`; a copy here\n * was a second place for it to be edited and go stale, and made the variant\n * look like a page of its own. What this body says is the one thing the page's\n * definition cannot: what is different in this version, and why.\n */\nexport function buildVariantDefinition(\n  controlDefinition: string,\n  opts: {\n    internalId: string;\n    variantSlug: string;\n    controlSlug: string;\n    forks: string[];\n    because?: string;\n    change?: string;\n  },\n): string {\n  const frontmatter = controlDefinition.match(/^---\\n[\\s\\S]*?\\n---/)?.[0] ?? \"---\\n---\";\n  let out = frontmatter;\n  // Quoted: eight hex characters can parse as a number, and the collection\n  // schema types internalId as a string.\n  out = out.replace(/^internalId:.*$/m, `internalId: \"${opts.internalId}\"`);\n  out = out.replace(/^internalTitle:\\s*(.*)$/m, (_m, title: string) => `internalTitle: ${title.trim()} (variant)`);\n\n  const shared = opts.forks.length > 0 ? opts.forks.join(\", \") : \"nothing yet\";\n  const note = [\n    \"\",\n    `# Version ${variantNumberOf(opts.variantSlug) ?? \"?\"} of \\`${opts.controlSlug}\\` — for an A/B test`,\n    \"\",\n    `This is not a page. It is one version of \\`${opts.controlSlug}\\`, shown to half of that page's visitors while a test runs; the address bar keeps saying \\`/${opts.controlSlug}/\\` and this folder has no address of its own. Everything about the page — the campaign, the audience, the offer, the proof — is in \\`src/pages/${opts.controlSlug}/_definition.md\\`, and that is where it is edited. This file only says what is different here.`,\n    \"\",\n    `**Only this differs:** ${shared}. Every other section is imported from \\`${opts.controlSlug}\\`, on purpose — an edit to the page reaches both versions, so the test keeps measuring the one difference rather than a drift between two copies. Edit only the files under \\`src/pages/${opts.variantSlug}/_components/\\`.`,\n    ...(opts.because ? [\"\", `**Because:** ${opts.because}`] : []),\n    ...(opts.change ? [\"\", `**We changed:** ${opts.change}`] : []),\n    \"\",\n    `Run \\`baker experiment start --landing ${opts.controlSlug} --variant ${opts.variantSlug} --because \"…\" --change \"…\"\\` to begin, and read the result with \\`baker experiment status\\`. When the test ends, \\`baker experiment fold\\` moves the version that won into the page and removes this folder.`,\n    \"\",\n  ].join(\"\\n\");\n\n  return `${out.trimEnd()}\\n${note}`;\n}\n\n/**\n * Everything the write step needs, or a refusal that says how to retry.\n *\n * Separate from the writing because these are the only two failure modes worth\n * distinguishing: a call that was never going to work (and should say what the\n * workspace does contain), and one that did work.\n */\nasync function resolveTargets(\n  projectRoot: string,\n  opts: { controlSlug: string; fork: unknown; rawArgs?: readonly string[] },\n): Promise<{\n  controlDir: string;\n  variantDir: string;\n  variantSlug: string;\n  available: string[];\n  forks: string[];\n}> {\n  const { controlSlug } = opts;\n\n  if (!SLUG_RE.test(controlSlug)) {\n    fail(\n      \"INVALID_SLUG\",\n      `\"${controlSlug}\" is not a page slug — use the folder name directly under src/pages/ (lowercase letters, digits and dashes).`,\n      { argument: \"page\", availableSlugs: await listLandingSlugs(projectRoot) },\n    );\n  }\n  if (variantOfSlug(controlSlug) !== null) {\n    // A variant of a variant is not a thing. A page has variants; a variant is\n    // one version of that page, and a test compares two versions of ONE page.\n    fail(\n      \"INVALID_SLUG\",\n      `\"${controlSlug}\" is already a variant of \"${variantOfSlug(controlSlug)}\". Make the next variant of the page itself: \\`baker landing variant ${variantOfSlug(controlSlug)}\\`.`,\n    );\n  }\n\n  const controlDir = path.resolve(projectRoot, \"src\", \"pages\", controlSlug);\n\n  if (!(await isDir(controlDir))) {\n    fail(\"NOT_FOUND\", `No page at src/pages/${controlSlug}/`, {\n      availableSlugs: await listLandingSlugs(projectRoot),\n    });\n  }\n  if (!(await exists(path.join(controlDir, \"index.astro\")))) {\n    fail(\"NOT_FOUND\", `src/pages/${controlSlug}/index.astro is missing, so there is no page to make a variant of.`);\n  }\n\n  // The slug is computed, never chosen. `n` is monotonic per page and never\n  // reused, so it cannot collide with an archived snapshot or merge with the\n  // analytics history of an earlier variant of the same name — and a page whose\n  // own name happens to end in `-b` or `-v2` (nine of them live today) can\n  // never be mistaken for one.\n  const internalId = await readInternalId(path.join(controlDir, \"_definition.md\"));\n  const variantSlugValue = variantSlug(\n    controlSlug,\n    nextVariantNumber(\n      controlSlug,\n      await listLandingSlugs(projectRoot),\n      await archivedVariantNumbers(projectRoot, internalId),\n    ),\n  );\n  const variantDir = path.resolve(projectRoot, \"src\", \"pages\", variantSlugValue);\n\n  const available = await listComponents(path.join(controlDir, \"_components\"));\n  const forks: string[] = [];\n  for (const name of parseForks(opts.fork, opts.rawArgs)) {\n    const resolved = resolveForkName(name, available);\n    if (resolved === null) {\n      fail(\"NOT_FOUND\", `\"${name}\" is not a component of ${controlSlug}.`, {\n        availableComponents: available,\n        hint: \"Name it as it appears under _components/ — `Hero.astro`, or `hero/Card.astro`.\",\n      });\n    }\n    forks.push(resolved);\n  }\n\n  return { controlDir, variantDir, variantSlug: variantSlugValue, available, forks };\n}\n\n/** Write the variant's files, returning the repo-relative paths written. */\nasync function writeVariant(opts: {\n  controlDir: string;\n  variantDir: string;\n  controlSlug: string;\n  variantSlug: string;\n  forks: string[];\n  because?: string;\n  change?: string;\n}): Promise<string[]> {\n  const { controlDir, variantDir, controlSlug, variantSlug, forks } = opts;\n  const forkedTargets = new Set(forks.map((f) => path.join(controlDir, \"_components\", f)));\n  const written: string[] = [];\n\n  // index.astro — the control's, with every path re-aimed. Sections stay\n  // pointed at the control; forks point at the variant's own copies.\n  const indexText = await readFile(path.join(controlDir, \"index.astro\"), \"utf8\");\n  await mkdir(variantDir, { recursive: true });\n  await writeFile(\n    path.join(variantDir, \"index.astro\"),\n    repointFile(indexText, { fromDir: controlDir, toDir: variantDir, controlDir, variantDir, forkedTargets }),\n    \"utf8\",\n  );\n  written.push(`src/pages/${variantSlug}/index.astro`);\n\n  // The forked components, each re-aimed from its own depth so what it pulls\n  // in — a sibling section, one of the control's images — still resolves.\n  for (const fork of forks) {\n    const fromFile = path.join(controlDir, \"_components\", fork);\n    const toFile = path.join(variantDir, \"_components\", fork);\n    const text = await readFile(fromFile, \"utf8\");\n    await mkdir(path.dirname(toFile), { recursive: true });\n    await writeFile(\n      toFile,\n      repointFile(text, {\n        fromDir: path.dirname(fromFile),\n        toDir: path.dirname(toFile),\n        controlDir,\n        variantDir,\n        forkedTargets,\n      }),\n      \"utf8\",\n    );\n    written.push(`src/pages/${variantSlug}/_components/${fork}`);\n  }\n\n  // _definition.md — the same campaign, its own identity.\n  const controlDefinitionPath = path.join(controlDir, \"_definition.md\");\n  if (await exists(controlDefinitionPath)) {\n    const definition = buildVariantDefinition(await readFile(controlDefinitionPath, \"utf8\"), {\n      internalId: randomUUID().replace(/-/g, \"\").slice(0, 8),\n      variantSlug,\n      controlSlug,\n      forks,\n      ...(opts.because ? { because: opts.because } : {}),\n      ...(opts.change ? { change: opts.change } : {}),\n    });\n    await writeFile(path.join(variantDir, \"_definition.md\"), definition, \"utf8\");\n    written.push(`src/pages/${variantSlug}/_definition.md`);\n  }\n\n  // Somewhere for the variant's own imagery, if the fork brings any.\n  await mkdir(path.join(variantDir, \"_images\"), { recursive: true });\n  await writeFile(path.join(variantDir, \"_images\", \".gitkeep\"), \"\", \"utf8\");\n\n  return written;\n}\n\nexport const variantCommand = defineCommand({\n  meta: {\n    name: \"variant\",\n    description:\n      \"Create a new variant of a page, for an A/B test. The variant SHARES the page's sections and forks only the component you name, so the two versions differ by exactly the thing you are testing. It is a version of that page, not a page of its own: it is never indexed, never listed, and has no public URL — both versions answer at the page's own address. Run `baker experiment plan` first — most pages do not have the traffic to settle most questions.\",\n  },\n  args: {\n    page: { type: \"positional\", required: true, description: \"The page to make a variant of, by slug\" },\n    fork: {\n      type: \"string\",\n      description: \"Component the variant owns its own copy of (`Hero.astro`). Repeat for several.\",\n    },\n    because: {\n      type: \"string\",\n      required: true,\n      description:\n        \"What you SAW that makes this worth building — the observation, not the change. Required here, before the page exists, because a reason written afterwards is a caption for a page rather than the reason for one, and a test with no stated belief teaches nothing whichever way it lands. Recorded in the page's notes and passed to `baker experiment start`.\",\n    },\n    change: {\n      type: \"string\",\n      required: true,\n      description: \"What is different about this version, in the client's words — “put the booking form in the hero”.\",\n    },\n  },\n  async run({ args, rawArgs }) {\n    const projectRoot = process.cwd();\n    const controlSlug = String(args.page);\n\n    const { controlDir, variantDir, variantSlug, available, forks } = await resolveTargets(projectRoot, {\n      controlSlug,\n      fork: args.fork,\n      rawArgs,\n    });\n\n    // Before a file is written: a page in a test cannot take another version.\n    // Fail closed — a variant built against a page that turns out to be in a\n    // test is exactly the folder this check exists to prevent.\n    let status: ExperimentStatusResponse;\n    try {\n      const response = await apiPost<{ ok: true; data: ExperimentStatusResponse }>(\"/api/experiments/status\", {\n        landingSlug: controlSlug,\n      });\n      status = response.data;\n    } catch (error) {\n      fail(\n        \"UNAVAILABLE\",\n        `Could not check whether ${controlSlug} is already in a test (${error instanceof Error ? error.message : String(error)}). Nothing was written — run \\`baker experiment status --landing ${controlSlug}\\` and try again.`,\n      );\n    }\n    const taken = pageInTest(status, controlSlug);\n    if (taken) fail(\"CONFLICT\", taken, { landing: controlSlug });\n\n    const written = await writeVariant({\n      controlDir,\n      variantDir,\n      controlSlug,\n      variantSlug,\n      forks,\n      because: String(args.because),\n      change: String(args.change),\n    });\n\n    const hints = [\n      forks.length === 0\n        ? `MISSING --fork: ${variantSlug} currently renders exactly ${controlSlug}, so a test between them cannot conclude anything. Re-run with --fork <Component>, or copy the one section your change touches into src/pages/${variantSlug}/_components/ and repoint that import.`\n        : `Edit only src/pages/${variantSlug}/_components/${forks.join(\", \")} — every other section is shared with ${controlSlug}, and editing a shared one changes both arms at once.`,\n      `Preview both at http://localhost:4321/${controlSlug}/ and http://localhost:4321/${variantSlug}/ and check they differ only where you meant. Once it is live, only the first of those two answers — a variant has no public address of its own, and \\`/${controlSlug}/?_bkr_preview=b\\` is how anyone looks at it.`,\n      `Then: baker experiment start --landing ${controlSlug} --variant ${variantSlug} --because \"${String(args.because)}\" --change \"${String(args.change)}\". Nothing is split until the session is published — the person publishing is the review of this page.`,\n    ];\n\n    process.stdout.write(\n      `${JSON.stringify(\n        {\n          ok: true,\n          data: {\n            page: controlSlug,\n            slug: variantSlug,\n            forked: forks,\n            shared: available.filter((c) => !forks.includes(c)),\n            written,\n          },\n          hints,\n        },\n        null,\n        2,\n      )}\\n`,\n    );\n  },\n});\n"],"mappings":"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","names":["variantSlug"]}

package/dist/videos-GIYDCCKR.js

@@ -0,0 +1,39 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/index.ts
+import { defineCommand } from "citty";
+var videosCommand = defineCommand({
+  meta: {
+    name: "videos",
+    description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, fetch, describe, delete, retry, tags.
+
+Examples:
+  baker videos search "product demo" --limit 5
+  baker videos search "tutorial" --tags explainer
+  baker videos get <video-id>
+  baker videos upload ./demo.mp4
+  baker videos ingest https://www.youtube.com/watch?v=abc123
+  baker videos fetch https://www.youtube.com/watch?v=abc123 --out ./clips
+  baker videos describe <video-id> --description "Customer testimonial, 30s"
+  baker videos delete <video-id> --dry-run
+  baker videos retry <video-id>                    # process a failed video again
+  baker videos tags                                # list; tags create|update|delete for custom tags
+Full guide: __tooling__/docs/tools/baker/videos.md`
+  },
+  subCommands: {
+    get: () => import("./get-6WEYKOY6.js").then((m) => m.getCommand),
+    group: () => import("./group-EFZ3AJIE.js").then((m) => m.groupCommand),
+    search: () => import("./search-OQNGSMUH.js").then((m) => m.searchCommand),
+    upload: () => import("./upload-SSOPA7ZT.js").then((m) => m.uploadCommand),
+    ingest: () => import("./ingest-BYJNFOOT.js").then((m) => m.ingestCommand),
+    fetch: () => import("./fetch-XF76JABV.js").then((m) => m.fetchCommand),
+    describe: () => import("./describe-6NVOWIBE.js").then((m) => m.describeCommand),
+    delete: () => import("./delete-MRM2S4Z5.js").then((m) => m.deleteCommand),
+    retry: () => import("./retry-WLVMR7XP.js").then((m) => m.retryCommand),
+    tags: () => import("./tags-GFFQLLG2.js").then((m) => m.tagsCommand)
+  }
+});
+export {
+  videosCommand
+};
+//# sourceMappingURL=videos-GIYDCCKR.js.map

package/dist/view-NPAG66QK.js

@@ -0,0 +1,121 @@
+import {
+  READABLE_SHOT,
+  downloadReadableShot
+} from "./chunk-DNCLWSHO.js";
+import {
+  INSPIRATION_HINTS,
+  fidelityHint,
+  reportError
+} from "./chunk-EFSYTROP.js";
+import {
+  apiGet
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/inspiration/view.ts
+import path from "path";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "landing.inspiration.view",
+  description: "Everything known about one section: composition, motion, design tokens, the copy it uses, why it works, and what must change to make it yours. Downloads the desktop and mobile screenshots plus the motion filmstrip so you can look at them.",
+  args: {
+    id: { type: "string", description: "Section id from search", required: true },
+    full: {
+      type: "boolean",
+      description: "Add the classification facets (theme, density, rank, interactions, media, devices, tags) and the reproduction notes",
+      required: false
+    }
+  }
+});
+var viewCommand = defineCommand({
+  meta: {
+    name: "view",
+    description: "Full detail for one reference section. Example: baker landing inspiration view k57abc\u2026 \u2014 read the screenshots it saves before you build."
+  },
+  args: {
+    id: { type: "positional", description: "Section id from search", required: true },
+    full: {
+      type: "boolean",
+      description: "Include classification facets and reproduction notes",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id;
+      const data = await apiGet("/api/landing-inspiration/section", { id });
+      const section = data.section;
+      const dir = path.join(process.cwd(), ".baker", "inspiration", id);
+      const ext = READABLE_SHOT.extension;
+      const [desktop, mobile, filmstrip] = await Promise.all([
+        downloadReadableShot(section.desktopShotUrl, path.join(dir, `desktop.${ext}`)),
+        downloadReadableShot(section.mobileShotUrl, path.join(dir, `mobile.${ext}`)),
+        downloadReadableShot(section.motionFilmstripUrl, path.join(dir, `motion-filmstrip.${ext}`))
+      ]);
+      const full = args.full;
+      const hints = [INSPIRATION_HINTS.structureNotCopy, INSPIRATION_HINTS.adapt];
+      if (desktop) hints.push(`Read ${desktop} before you build \u2014 the description is not the section.`);
+      hints.push("Need the mechanics? `baker landing inspiration code <id>` writes the standalone HTML+CSS to disk.");
+      const fidelity = fidelityHint(section.fidelity);
+      if (fidelity) hints.push(fidelity);
+      if (filmstrip) {
+        hints.push(
+          `${filmstrip} shows this section animating in, six frames left-to-right then top-to-bottom, with the elapsed time on each. Read it if you want the motion, not just the layout.`
+        );
+      }
+      writeJson({
+        ok: true,
+        data: {
+          id: section.id,
+          page_id: section.sourceId,
+          section: section.sectionType,
+          composition: section.composition,
+          look: section.visualRegister,
+          motion: section.motionSummary,
+          design_tokens: section.designTokens,
+          size: section.boundingBox,
+          copy: {
+            headline: section.headline,
+            subhead: section.subhead,
+            ctas: section.ctaLabels,
+            proof: section.proofSignals
+          },
+          why_it_works: section.whyItWorks,
+          adaptation_notes: section.adaptationNotes,
+          craft: section.craftScore,
+          fidelity: section.fidelity,
+          source_url: section.sourceUrl,
+          screenshots: { desktop, mobile, motion_filmstrip: filmstrip },
+          // Behind --full: exactly the block `search` already gates, plus the
+          // reproduction notes, which `code` returns again for the one caller
+          // that acts on them. Everything above is what you design *from*;
+          // these are how the section was filed and how it rebuilds.
+          ...full ? {
+            theme: section.theme,
+            density: section.density,
+            show_tell_rank: section.showTellRank,
+            interactions: section.interactions,
+            media: section.mediaKinds,
+            devices: section.contentDevices,
+            tags: section.tags,
+            reproduction_notes: section.reproductionNotes
+          } : {}
+        },
+        hints
+      });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+export {
+  viewCommand
+};
+//# sourceMappingURL=view-NPAG66QK.js.map

package/dist/view-NPAG66QK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/landing/inspiration/view.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { InspirationSectionResponse } from \"@baker/api/landing-library\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeJson } from \"../../../output.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { fidelityHint, INSPIRATION_HINTS, reportError } from \"./shared.ts\";\nimport { downloadReadableShot, READABLE_SHOT } from \"./shot.ts\";\n\nregisterSchema({\n  command: \"landing.inspiration.view\",\n  description:\n    \"Everything known about one section: composition, motion, design tokens, the copy it uses, why it works, and what must change to make it yours. Downloads the desktop and mobile screenshots plus the motion filmstrip so you can look at them.\",\n  args: {\n    id: { type: \"string\", description: \"Section id from search\", required: true },\n    full: {\n      type: \"boolean\",\n      description:\n        \"Add the classification facets (theme, density, rank, interactions, media, devices, tags) and the reproduction notes\",\n      required: false,\n    },\n  },\n});\n\nexport const viewCommand = defineCommand({\n  meta: {\n    name: \"view\",\n    description:\n      \"Full detail for one reference section. Example: baker landing inspiration view k57abc… — read the screenshots it saves before you build.\",\n  },\n  args: {\n    id: { type: \"positional\", description: \"Section id from search\", required: true },\n    full: {\n      type: \"boolean\",\n      description: \"Include classification facets and reproduction notes\",\n      required: false,\n      default: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const id = args.id as string;\n      const data = await apiGet<InspirationSectionResponse>(\"/api/landing-inspiration/section\", { id });\n      const section = data.section;\n      const dir = path.join(process.cwd(), \".baker\", \"inspiration\", id);\n\n      const ext = READABLE_SHOT.extension;\n      const [desktop, mobile, filmstrip] = await Promise.all([\n        downloadReadableShot(section.desktopShotUrl, path.join(dir, `desktop.${ext}`)),\n        downloadReadableShot(section.mobileShotUrl, path.join(dir, `mobile.${ext}`)),\n        downloadReadableShot(section.motionFilmstripUrl, path.join(dir, `motion-filmstrip.${ext}`)),\n      ]);\n\n      const full = args.full as boolean;\n      const hints = [INSPIRATION_HINTS.structureNotCopy, INSPIRATION_HINTS.adapt];\n      if (desktop) hints.push(`Read ${desktop} before you build — the description is not the section.`);\n      hints.push(\"Need the mechanics? `baker landing inspiration code <id>` writes the standalone HTML+CSS to disk.\");\n      const fidelity = fidelityHint(section.fidelity);\n      if (fidelity) hints.push(fidelity);\n      if (filmstrip) {\n        hints.push(\n          `${filmstrip} shows this section animating in, six frames left-to-right then top-to-bottom, with the elapsed time on each. Read it if you want the motion, not just the layout.`,\n        );\n      }\n\n      writeJson({\n        ok: true,\n        data: {\n          id: section.id,\n          page_id: section.sourceId,\n          section: section.sectionType,\n          composition: section.composition,\n          look: section.visualRegister,\n          motion: section.motionSummary,\n          design_tokens: section.designTokens,\n          size: section.boundingBox,\n          copy: {\n            headline: section.headline,\n            subhead: section.subhead,\n            ctas: section.ctaLabels,\n            proof: section.proofSignals,\n          },\n          why_it_works: section.whyItWorks,\n          adaptation_notes: section.adaptationNotes,\n          craft: section.craftScore,\n          fidelity: section.fidelity,\n          source_url: section.sourceUrl,\n          screenshots: { desktop, mobile, motion_filmstrip: filmstrip },\n          // Behind --full: exactly the block `search` already gates, plus the\n          // reproduction notes, which `code` returns again for the one caller\n          // that acts on them. Everything above is what you design *from*;\n          // these are how the section was filed and how it rebuilds.\n          ...(full\n            ? {\n                theme: section.theme,\n                density: section.density,\n                show_tell_rank: section.showTellRank,\n                interactions: section.interactions,\n                media: section.mediaKinds,\n                devices: section.contentDevices,\n                tags: section.tags,\n                reproduction_notes: section.reproductionNotes,\n              }\n            : {}),\n        },\n        hints,\n      });\n    } catch (error) {\n      reportError(error);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/viewer-check-VN2JK2LW.js

@@ -0,0 +1,70 @@
+import {
+  OFFER_READ,
+  VIEWER_CLARITY,
+  VIEWER_QUESTIONS,
+  VIEWER_REQUIRED_CLARITY,
+  ViewerAnswerSchema,
+  buildViewerPrompt,
+  checkViewer,
+  describeViewer,
+  gatewayViewerModel,
+  jevReadJudge,
+  judgeViewerAnswer,
+  liveViewerLookups,
+  misreadings,
+  personaSegments,
+  readCreativeForViewerCheck,
+  readPersonas,
+  resolveViewer,
+  sureEnough,
+  viewerCheckBeforeRender,
+  viewerCheckCacheKey,
+  viewerCheckCommand,
+  viewerCheckFailure,
+  viewerCheckSkip
+} from "./chunk-HXTGYOQC.js";
+import "./chunk-NFSLRRIE.js";
+import "./chunk-F2S5BLPE.js";
+import "./chunk-K3PN7TN5.js";
+import "./chunk-HIPDMQZ6.js";
+import "./chunk-W3B4BHQU.js";
+import "./chunk-CLMM6P6B.js";
+import "./chunk-HO3IUJ4K.js";
+import "./chunk-OBDAYP2P.js";
+import "./chunk-RX6F3GEA.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-VAJBWA2U.js";
+import "./chunk-OTFHEHIU.js";
+import "./chunk-VVZBBKRC.js";
+import "./chunk-YBMVHGY3.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  OFFER_READ,
+  VIEWER_CLARITY,
+  VIEWER_QUESTIONS,
+  VIEWER_REQUIRED_CLARITY,
+  ViewerAnswerSchema,
+  buildViewerPrompt,
+  checkViewer,
+  describeViewer,
+  gatewayViewerModel,
+  jevReadJudge,
+  judgeViewerAnswer,
+  liveViewerLookups,
+  misreadings,
+  personaSegments,
+  readCreativeForViewerCheck,
+  readPersonas,
+  resolveViewer,
+  sureEnough,
+  viewerCheckBeforeRender,
+  viewerCheckCacheKey,
+  viewerCheckCommand,
+  viewerCheckFailure,
+  viewerCheckSkip
+};
+//# sourceMappingURL=viewer-check-VN2JK2LW.js.map

package/dist/web-WUGLSULO.js

@@ -0,0 +1,135 @@
+import {
+  webDepthHints
+} from "./chunk-PIWMNKWI.js";
+import {
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson
+} from "./chunk-TBEUMOEL.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/web.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.web",
+  description: "Search the web with AI to answer marketing questions \u2014 competitors, ICP, pricing, pain points, market trends. Three depth levels: medium (quick, default), high (thorough), xhigh (exhaustive deep research).",
+  args: {
+    question: {
+      type: "string",
+      description: "The research question to answer using live web data",
+      required: true
+    },
+    depth: {
+      type: "string",
+      description: "Research depth: medium (quick), high (thorough), xhigh (exhaustive). Default: medium",
+      required: false,
+      enum: ["medium", "high", "xhigh"]
+    }
+  }
+});
+var TIMEOUT_MS = {
+  medium: 18e4,
+  high: 36e4,
+  xhigh: 9e5
+};
+var FIELDS = {
+  answer: "AI-generated research answer (markdown)",
+  sources: "Array of {title, url} sources used for grounding"
+};
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function runDeepResearch(question) {
+  const { interactionId } = await apiPost("/api/research/deep-research/start", { question });
+  process.stderr.write(`Deep research started (${interactionId}). Polling...
+`);
+  const deadline = Date.now() + TIMEOUT_MS.xhigh;
+  while (Date.now() < deadline) {
+    await sleep(1e4);
+    const poll = await apiGet("/api/research/deep-research/poll", {
+      id: interactionId
+    });
+    if (poll.status === "completed" && poll.result) {
+      return poll.result;
+    }
+    if (poll.status === "failed" || poll.status === "cancelled") {
+      throw new Error(`Deep research ${poll.status}`);
+    }
+    process.stderr.write(`  status: ${poll.status}
+`);
+  }
+  throw new Error("Deep research timed out");
+}
+var webCommand = defineCommand({
+  meta: {
+    name: "web",
+    description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
+
+Depth levels:
+  medium  \u2014 Quick lookup using Gemini Flash with minimal thinking (default)
+  high    \u2014 Thorough answer using Gemini Flash with deep thinking
+  xhigh   \u2014 Exhaustive deep research using Gemini Deep Research (slow, use sparingly)
+
+Examples:
+  baker research web "Who are the main competitors of HubSpot CRM?"
+  baker research web "What are the top pain points for SMB CRM buyers?" --depth high
+  baker research web "Full competitive analysis of project management SaaS" --depth xhigh`
+  },
+  args: {
+    question: { type: "positional", description: "The research question", required: true },
+    depth: { type: "string", description: "Research depth: medium|high|xhigh (default: medium)", required: false },
+    output: { type: "string", description: "Format: json|md (default: json)", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const question = args.question;
+    if (question.length < 5) {
+      writeResearchJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Question must be at least 5 characters" }
+      });
+      process.exit(1);
+    }
+    const depth = args.depth || "medium";
+    if (!["medium", "high", "xhigh"].includes(depth)) {
+      writeResearchJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Depth must be one of: medium, high, xhigh" }
+      });
+      process.exit(1);
+    }
+    try {
+      const data = depth === "xhigh" ? await runDeepResearch(question) : await apiPost("/api/research/explore", { question, depth }, { timeoutMs: TIMEOUT_MS[depth] });
+      const format = args.output || "json";
+      const hints = webDepthHints({ answer: data.answer, sourceCount: data.sources.length, depth });
+      if (format === "md") {
+        process.stdout.write(`${data.answer}
+`);
+        if (data.sources.length > 0) {
+          process.stdout.write("\n## Sources\n");
+          for (const s of data.sources) {
+            process.stdout.write(`- [${s.title}](${s.url})
+`);
+          }
+        }
+        writeResearchHints(hints, format);
+        return;
+      }
+      writeResearchJson({ ok: true, data, fields: FIELDS, hints });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  webCommand
+};
+//# sourceMappingURL=web-WUGLSULO.js.map

package/dist/web-WUGLSULO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/web.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiGet, apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { webDepthHints } from \"./hints.ts\";\nimport { handleResearchError, writeResearchHints, writeResearchJson } from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.web\",\n  description:\n    \"Search the web with AI to answer marketing questions — competitors, ICP, pricing, pain points, market trends. Three depth levels: medium (quick, default), high (thorough), xhigh (exhaustive deep research).\",\n  args: {\n    question: {\n      type: \"string\",\n      description: \"The research question to answer using live web data\",\n      required: true,\n    },\n    depth: {\n      type: \"string\",\n      description: \"Research depth: medium (quick), high (thorough), xhigh (exhaustive). Default: medium\",\n      required: false,\n      enum: [\"medium\", \"high\", \"xhigh\"],\n    },\n  },\n});\n\ntype Depth = \"medium\" | \"high\" | \"xhigh\";\n\nconst TIMEOUT_MS: Record<Depth, number> = {\n  medium: 180_000,\n  high: 360_000,\n  xhigh: 900_000,\n};\n\ninterface WebResult {\n  answer: string;\n  sources: Array<{ title: string; url: string }>;\n}\n\nconst FIELDS: Record<string, string> = {\n  answer: \"AI-generated research answer (markdown)\",\n  sources: \"Array of {title, url} sources used for grounding\",\n};\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nasync function runDeepResearch(question: string): Promise<WebResult> {\n  const { interactionId } = await apiPost<{ interactionId: string }>(\"/api/research/deep-research/start\", { question });\n\n  process.stderr.write(`Deep research started (${interactionId}). Polling...\\n`);\n\n  const deadline = Date.now() + TIMEOUT_MS.xhigh;\n  while (Date.now() < deadline) {\n    await sleep(10_000);\n    const poll = await apiGet<{ status: string; result?: WebResult }>(\"/api/research/deep-research/poll\", {\n      id: interactionId,\n    });\n\n    if (poll.status === \"completed\" && poll.result) {\n      return poll.result;\n    }\n    if (poll.status === \"failed\" || poll.status === \"cancelled\") {\n      throw new Error(`Deep research ${poll.status}`);\n    }\n    process.stderr.write(`  status: ${poll.status}\\n`);\n  }\n\n  throw new Error(\"Deep research timed out\");\n}\n\nexport const webCommand = defineCommand({\n  meta: {\n    name: \"web\",\n    description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.\n\nDepth levels:\n  medium  — Quick lookup using Gemini Flash with minimal thinking (default)\n  high    — Thorough answer using Gemini Flash with deep thinking\n  xhigh   — Exhaustive deep research using Gemini Deep Research (slow, use sparingly)\n\nExamples:\n  baker research web \"Who are the main competitors of HubSpot CRM?\"\n  baker research web \"What are the top pain points for SMB CRM buyers?\" --depth high\n  baker research web \"Full competitive analysis of project management SaaS\" --depth xhigh`,\n  },\n  args: {\n    question: { type: \"positional\", description: \"The research question\", required: true },\n    depth: { type: \"string\", description: \"Research depth: medium|high|xhigh (default: medium)\", required: false },\n    output: { type: \"string\", description: \"Format: json|md (default: json)\", required: false, default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const question = args.question as string;\n    if (question.length < 5) {\n      writeResearchJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: \"Question must be at least 5 characters\" },\n      });\n      process.exit(1);\n    }\n\n    const depth = ((args.depth as string) || \"medium\") as Depth;\n    if (![\"medium\", \"high\", \"xhigh\"].includes(depth)) {\n      writeResearchJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: \"Depth must be one of: medium, high, xhigh\" },\n      });\n      process.exit(1);\n    }\n\n    try {\n      const data =\n        depth === \"xhigh\"\n          ? await runDeepResearch(question)\n          : await apiPost<WebResult>(\"/api/research/explore\", { question, depth }, { timeoutMs: TIMEOUT_MS[depth] });\n\n      const format = (args.output as string) || \"json\";\n      const hints = webDepthHints({ answer: data.answer, sourceCount: data.sources.length, depth });\n      if (format === \"md\") {\n        process.stdout.write(`${data.answer}\\n`);\n        if (data.sources.length > 0) {\n          process.stdout.write(\"\\n## Sources\\n\");\n          for (const s of data.sources) {\n            process.stdout.write(`- [${s.title}](${s.url})\\n`);\n          }\n        }\n        writeResearchHints(hints, format);\n        return;\n      }\n      writeResearchJson({ ok: true, data, fields: FIELDS, hints });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/winners-I5BMATJZ.js

@@ -0,0 +1,79 @@
+import {
+  reportError
+} from "./chunk-LERTEZST.js";
+import {
+  apiGet
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/winners.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.winners",
+  description: "Top winning ads for one advertiser id (from `advertisers` or `following`). Returns lean winner cards; add --full for DNA + longevity.",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id to browse", required: true },
+    top: { type: "number", description: "Max winners 1-100 (default 10)", required: false, default: 10 },
+    platform: { type: "string", description: "Filter to a single platform: meta|linkedin|tiktok", required: false }
+  }
+});
+var winnersCommand = defineCommand({
+  meta: {
+    name: "winners",
+    description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id", required: true },
+    top: { type: "string", description: "Max winners 1-100 (default 10)", required: false },
+    platform: { type: "string", description: "Filter to a single platform: meta|linkedin|tiktok", 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 DNA detail (angle, persona, hook) + longevity",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = { id: String(args.advertiser) };
+      if (args.top) {
+        params.top = String(args.top);
+      }
+      if (args.platform) {
+        params.platform = String(args.platform);
+      }
+      const data = await apiGet("/api/ad-library/advertiser-winners", params);
+      const output = args.output || "json";
+      const full = args.full;
+      const rawWinners = Array.isArray(data?.winners) ? data.winners : [];
+      if (output === "json") {
+        const winners = rawWinners.map((w) => winningAdNormalizer(w, full));
+        writeJson({ ok: true, data: { advertiser_id: data?.advertiser_id ?? String(args.advertiser), winners } });
+        return;
+      }
+      writeOutput(
+        { ok: true, data: rawWinners },
+        output,
+        args.fields ? args.fields.split(",") : void 0,
+        full,
+        winningAdNormalizer
+      );
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  winnersCommand
+};
+//# sourceMappingURL=winners-I5BMATJZ.js.map

package/dist/winners-I5BMATJZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/winners.ts"],"sourcesContent":["import type { AdvertiserWinnersResponse } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../client.ts\";\nimport { type OutputFormat, winningAdNormalizer, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { reportError } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"winning-ads.winners\",\n  description:\n    \"Top winning ads for one advertiser id (from `advertisers` or `following`). Returns lean winner cards; add --full for DNA + longevity.\",\n  args: {\n    advertiser: { type: \"string\", description: \"Advertiser id to browse\", required: true },\n    top: { type: \"number\", description: \"Max winners 1-100 (default 10)\", required: false, default: 10 },\n    platform: { type: \"string\", description: \"Filter to a single platform: meta|linkedin|tiktok\", required: false },\n  },\n});\n\nexport const winnersCommand = defineCommand({\n  meta: {\n    name: \"winners\",\n    description:\n      \"Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md\",\n  },\n  args: {\n    advertiser: { type: \"positional\", description: \"Advertiser id\", required: true },\n    top: { type: \"string\", description: \"Max winners 1-100 (default 10)\", required: false },\n    platform: { type: \"string\", description: \"Filter to a single platform: meta|linkedin|tiktok\", 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: {\n      type: \"boolean\",\n      description: \"Include DNA detail (angle, persona, hook) + longevity\",\n      required: false,\n      default: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const params: Record<string, string> = { id: String(args.advertiser) };\n      if (args.top) {\n        params.top = String(args.top);\n      }\n      if (args.platform) {\n        params.platform = String(args.platform);\n      }\n\n      const data = await apiGet<AdvertiserWinnersResponse>(\"/api/ad-library/advertiser-winners\", params);\n      const output = (args.output as OutputFormat) || \"json\";\n      const full = args.full as boolean;\n      const rawWinners = Array.isArray(data?.winners) ? data.winners : [];\n\n      if (output === \"json\") {\n        const winners = rawWinners.map((w) => winningAdNormalizer(w as unknown as Record<string, unknown>, full));\n        writeJson({ ok: true, data: { advertiser_id: data?.advertiser_id ?? String(args.advertiser), winners } });\n        return;\n      }\n      writeOutput(\n        { ok: true, data: rawWinners },\n        output,\n        args.fields ? (args.fields as string).split(\",\") : undefined,\n        full,\n        winningAdNormalizer,\n      );\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,YAAY,EAAE,MAAM,UAAU,aAAa,2BAA2B,UAAU,KAAK;AAAA,IACrF,KAAK,EAAE,MAAM,UAAU,aAAa,kCAAkC,UAAU,OAAO,SAAS,GAAG;AAAA,IACnG,UAAU,EAAE,MAAM,UAAU,aAAa,qDAAqD,UAAU,MAAM;AAAA,EAChH;AACF,CAAC;AAEM,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,YAAY,EAAE,MAAM,cAAc,aAAa,iBAAiB,UAAU,KAAK;AAAA,IAC/E,KAAK,EAAE,MAAM,UAAU,aAAa,kCAAkC,UAAU,MAAM;AAAA,IACtF,UAAU,EAAE,MAAM,UAAU,aAAa,qDAAqD,UAAU,MAAM;AAAA,IAC9G,QAAQ,EAAE,MAAM,UAAU,aAAa,gCAAgC,UAAU,OAAO,SAAS,OAAO;AAAA,IACxG,QAAQ,EAAE,MAAM,UAAU,aAAa,0CAA0C,UAAU,MAAM;AAAA,IACjG,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,EACF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,SAAiC,EAAE,IAAI,OAAO,KAAK,UAAU,EAAE;AACrE,UAAI,KAAK,KAAK;AACZ,eAAO,MAAM,OAAO,KAAK,GAAG;AAAA,MAC9B;AACA,UAAI,KAAK,UAAU;AACjB,eAAO,WAAW,OAAO,KAAK,QAAQ;AAAA,MACxC;AAEA,YAAM,OAAO,MAAM,OAAkC,sCAAsC,MAAM;AACjG,YAAM,SAAU,KAAK,UAA2B;AAChD,YAAM,OAAO,KAAK;AAClB,YAAM,aAAa,MAAM,QAAQ,MAAM,OAAO,IAAI,KAAK,UAAU,CAAC;AAElE,UAAI,WAAW,QAAQ;AACrB,cAAM,UAAU,WAAW,IAAI,CAAC,MAAM,oBAAoB,GAAyC,IAAI,CAAC;AACxG,kBAAU,EAAE,IAAI,MAAM,MAAM,EAAE,eAAe,MAAM,iBAAiB,OAAO,KAAK,UAAU,GAAG,QAAQ,EAAE,CAAC;AACxG;AAAA,MACF;AACA;AAAA,QACE,EAAE,IAAI,MAAM,MAAM,WAAW;AAAA,QAC7B;AAAA,QACA,KAAK,SAAU,KAAK,OAAkB,MAAM,GAAG,IAAI;AAAA,QACnD;AAAA,QACA;AAAA,MACF;AAAA,IACF,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/winning-ads-7QWEIMRU.js

@@ -0,0 +1,62 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/index.ts
+import { defineCommand } from "citty";
+var winningAdsCommand = defineCommand({
+  meta: {
+    name: "winning-ads",
+    description: `Search the ad-dna corpus of scored "winning" ads for reference creatives to reproduce, and manage the brands your library tracks. Proxied through the Baker backend (BAKER_API_KEY) \u2014 no separate token needed.
+
+Auth: BAKER_API_KEY (bk_ or bkr_) + BAKER_API_URL (your Convex .convex.site URL).
+
+Subcommands:
+  baker winning-ads search "<free text>"      \u2014 semantic search, followed brands first; lean shortlist (advertiser, summary, scores, proof, media_url)
+  baker winning-ads advertisers "<brand>"     \u2014 list corpus brands \u2192 advertiser ids (for --exclude-advertiser / --advertiser-id)
+  baker winning-ads follow "<domain|url|brand>" --platform meta|linkedin|tiktok \u2014 add a brand's ads to your library
+  baker winning-ads follow-competitors "<domain,domain,...>"   \u2014 add MANY brands at once (every competitor by domain)
+  baker winning-ads following                 \u2014 list brands you follow (status + counts)
+  baker winning-ads feed                      \u2014 winners across EVERY brand you follow; trim with --advertiser
+  baker winning-ads winners <advertiser>      \u2014 top winners for one advertiser id
+  baker winning-ads content <ad-id>           \u2014 read ONE ad's transcript + on-screen text + copy (understand a reference before reproducing it)
+  baker winning-ads fit <ad-id>               \u2014 does this winner fit OUR company? why it wins, what it needs, what we have, use|adapt|reject
+  baker winning-ads unfollow <advertiser>     \u2014 stop following a brand
+  baker winning-ads refresh <advertiser>      \u2014 re-scrape a followed brand for its newest ads (max once per 6h)
+  baker winning-ads hooks                     \u2014 top winner-weighted HOOK seeds for a segment (feed the seed to search --hook-archetype)
+  baker winning-ads mechanisms                \u2014 top winner-weighted PRODUCT mechanism seeds (how the product claims to work)
+  baker winning-ads formats                   \u2014 top winner-weighted static FORMAT patterns for a segment
+
+Examples:
+  baker winning-ads search "B2B SaaS before/after AI automation" --platform meta --format static --output md
+  baker winning-ads advertisers "Acme" --output md
+  baker winning-ads follow "deel.com" --platform meta
+  baker winning-ads follow-competitors "deel.com,notion.so,hubspot.com"
+  baker winning-ads feed --output md
+  baker winning-ads feed --advertiser adv_123,adv_456 --platform meta --output md
+  baker winning-ads winners adv_123 --top 15 --output md
+  baker winning-ads content adg_123 --full --output md
+  baker winning-ads hooks --platform meta --awareness problem_aware --industry saas --output md
+  baker winning-ads search "fintech onboarding" --hook-archetype callout --winner-category winner --output md
+  baker winning-ads search --format-pattern comparison_table --sort longest_running --output md
+Full guide: __tooling__/docs/tools/baker/winning-ads.md`
+  },
+  subCommands: {
+    search: () => import("./search-XUIVHGAY.js").then((m) => m.searchCommand),
+    advertisers: () => import("./advertisers-YMHPZYNF.js").then((m) => m.advertisersCommand),
+    follow: () => import("./follow-DUIEGDVK.js").then((m) => m.followCommand),
+    "follow-competitors": () => import("./follow-competitors-IT5ZVJPE.js").then((m) => m.followCompetitorsCommand),
+    following: () => import("./following-RKC2FLHI.js").then((m) => m.followingCommand),
+    feed: () => import("./feed-RV4KPPXM.js").then((m) => m.feedCommand),
+    winners: () => import("./winners-I5BMATJZ.js").then((m) => m.winnersCommand),
+    content: () => import("./content-3ZPP4SW2.js").then((m) => m.contentCommand),
+    fit: () => import("./fit-KXHYKIA4.js").then((m) => m.fitCommand),
+    unfollow: () => import("./unfollow-CBVPGPF7.js").then((m) => m.unfollowCommand),
+    refresh: () => import("./refresh-MKSKISPX.js").then((m) => m.refreshCommand),
+    hooks: () => import("./seeds-N6FF5S4T.js").then((m) => m.hooksCommand),
+    mechanisms: () => import("./seeds-N6FF5S4T.js").then((m) => m.mechanismsCommand),
+    formats: () => import("./seeds-N6FF5S4T.js").then((m) => m.formatsCommand)
+  }
+});
+export {
+  winningAdsCommand
+};
+//# sourceMappingURL=winning-ads-7QWEIMRU.js.map