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

package/dist/inspect-CQH55Q6G.js

@@ -0,0 +1,189 @@
+import {
+  fetchRunRecord
+} from "./chunk-73QKIIIR.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-HIPDMQZ6.js";
+import "./chunk-OTFHEHIU.js";
+import "./chunk-VVZBBKRC.js";
+import "./chunk-YBMVHGY3.js";
+import "./chunk-XWH7CCBL.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-WYCVJIHD.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-XML7AJM3.js";
+import {
+  ApiError
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/inspect.ts
+import { execFile } from "child_process";
+import { readdir, readFile, stat } from "fs/promises";
+import path from "path";
+import { promisify } from "util";
+import { defineCommand } from "citty";
+var execFileAsync = promisify(execFile);
+var inspectCommand = defineCommand({
+  meta: {
+    name: "inspect",
+    description: "Dump a one-page summary of a canvas run: per-node duration + cache status, the run's outputs, and optionally three thumbnail frames per video output. Pass a run_id (r_\u2026) or an absolute run directory. A run whose folder is not in this workspace (an older version, or one rendered in another chat) is read from the company's run history instead: its status, stats, per-node results and the durable URL of every output."
+  },
+  args: {
+    run: { type: "positional", required: true, description: "Run id (e.g. r_01K...) or absolute run directory" },
+    "outputs-dir": { type: "string", description: "Per-run outputs root (default <workspace root>/canvas, where `canvas run` writes)" },
+    thumbnails: {
+      type: "boolean",
+      description: "Extract start/middle/end frames from every video output in the local run folder (requires ffmpeg)"
+    }
+  },
+  async run({ args }) {
+    const cwd = process.cwd();
+    const outputsDir = args["outputs-dir"] ? path.resolve(String(args["outputs-dir"])) : path.join(findWorkspaceRoot(cwd) ?? cwd, "canvas");
+    const runArg = String(args.run);
+    const runDir = await localRunDir(runArg, outputsDir);
+    if (!runDir) {
+      if (path.isAbsolute(runArg)) fail("not_found", `${runArg} is not a run directory`);
+      await inspectFromHistory(runArg, path.join(outputsDir, runArg));
+      return;
+    }
+    const manifest = await loadManifest(runDir);
+    const files = await listRunFiles(runDir);
+    const videos = files.filter((f) => isVideoFile(f.path));
+    let thumbnails = [];
+    if (args.thumbnails) {
+      thumbnails = await extractThumbnails(videos.map((v) => v.path));
+    }
+    const summary = {
+      ok: true,
+      source: "local",
+      run_id: manifest.run_id ?? path.basename(runDir),
+      run_dir: runDir,
+      stats: manifest.stats ?? null,
+      output: manifest.output ?? null,
+      node_runs: manifest.node_runs ?? [],
+      files: files.map((f) => ({ name: f.name, path: f.path, size_bytes: f.size })),
+      thumbnails
+    };
+    process.stdout.write(`${JSON.stringify(summary, null, 2)}
+`);
+  }
+});
+async function localRunDir(run, outputsDir) {
+  const candidate = path.isAbsolute(run) ? run : path.join(outputsDir, run);
+  const s = await stat(candidate).catch(() => null);
+  return s?.isDirectory() ? candidate : null;
+}
+async function inspectFromHistory(runId, expectedDir) {
+  let run;
+  try {
+    run = await fetchRunRecord(runId);
+  } catch (e) {
+    const reason = e instanceof ApiError ? e.message : e instanceof Error ? e.message : String(e);
+    fail("unavailable", `No run folder at ${expectedDir}, and the run history could not be read (${reason}).`);
+  }
+  if (!run) {
+    fail(
+      "not_found",
+      `No run "${runId}": there is no folder at ${expectedDir} and the company's run history has no run by that id.`
+    );
+  }
+  const summary = {
+    ok: true,
+    source: "run_history",
+    run_id: run.runId,
+    creative: run.creativeSlug ?? null,
+    status: run.status,
+    ...run.errorMessage ? { error: run.errorMessage } : {},
+    stats: {
+      total_nodes: run.stats.totalNodes,
+      cached_nodes: run.stats.cachedNodes,
+      total_credits: run.stats.totalCredits,
+      duration_ms: run.stats.durationMs
+    },
+    outputs: run.finalOutputs,
+    node_runs: run.nodes.map((node) => ({
+      node_id: node.nodeId,
+      node_type: node.nodeType,
+      cached: node.cached,
+      duration_ms: node.durationMs,
+      credits: node.credits,
+      ...node.status ? { status: node.status } : {},
+      outputs: node.outputs
+    })),
+    ...run.review ? { review: run.review } : {},
+    hints: [
+      "This run's folder is not in this workspace, so there are no local files: every output above is a durable URL. To render it again here, run `baker canvas run --slug <creative>`."
+    ]
+  };
+  process.stdout.write(`${JSON.stringify(summary, null, 2)}
+`);
+}
+function fail(code, message) {
+  process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message } }, null, 2)}
+`);
+  process.exit(2);
+}
+async function loadManifest(runDir) {
+  const manifestPath = path.join(runDir, "manifest.json");
+  try {
+    const raw = await readFile(manifestPath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+async function listRunFiles(runDir) {
+  const out = [];
+  const names = await readdir(runDir);
+  for (const name of names) {
+    const abs = path.join(runDir, name);
+    const s = await stat(abs).catch(() => null);
+    if (!s?.isFile()) continue;
+    out.push({ name, path: abs, size: s.size });
+  }
+  out.sort((a, b) => a.name.localeCompare(b.name));
+  return out;
+}
+function isVideoFile(p) {
+  return /\.(mp4|webm|mov)$/i.test(p);
+}
+async function extractThumbnails(videoPaths) {
+  const out = [];
+  for (const v of videoPaths) {
+    const duration = await probeDuration(v).catch(() => null);
+    if (duration === null) {
+      out.push({ video: v, frames: [] });
+      continue;
+    }
+    const frames = [];
+    const checkpoints = [0.05, 0.5, 0.95];
+    const base = v.replace(/\.[^.]+$/, "");
+    for (const ratio of checkpoints) {
+      const at = Math.max(0, Math.min(duration * ratio, duration - 0.01));
+      const dest = `${base}__frame_${Math.round(ratio * 100).toString().padStart(2, "0")}.png`;
+      try {
+        await execFileAsync("ffmpeg", ["-ss", at.toFixed(3), "-i", v, "-frames:v", "1", "-y", dest]);
+        frames.push(dest);
+      } catch {
+      }
+    }
+    out.push({ video: v, frames });
+  }
+  return out;
+}
+async function probeDuration(filePath) {
+  const { stdout } = await execFileAsync(
+    "ffprobe",
+    ["-v", "error", "-show_entries", "format=duration", "-of", "csv=p=0", filePath],
+    { encoding: "utf-8" }
+  );
+  return Number.parseFloat(stdout.trim());
+}
+export {
+  inspectCommand
+};
+//# sourceMappingURL=inspect-CQH55Q6G.js.map

package/dist/inspect-CQH55Q6G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/inspect.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { readdir, readFile, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { promisify } from \"node:util\";\nimport { defineCommand } from \"citty\";\nimport { ApiError } from \"../../client.ts\";\nimport { findWorkspaceRoot } from \"./normalize-paths.ts\";\nimport { fetchRunRecord } from \"./run-history.ts\";\n\nconst execFileAsync = promisify(execFile);\n\ntype ManifestNodeRun = {\n  node_id: string;\n  node_type: string;\n  cached: boolean;\n  duration_ms: number;\n  credits: number;\n};\n\ntype Manifest = {\n  run_id: string;\n  output?: unknown;\n  stats?: { total_nodes: number; cached_nodes: number; total_credits: number; duration_ms: number };\n  node_runs?: ManifestNodeRun[];\n};\n\nexport const inspectCommand = defineCommand({\n  meta: {\n    name: \"inspect\",\n    description:\n      \"Dump a one-page summary of a canvas run: per-node duration + cache status, the run's outputs, and optionally three thumbnail frames per video output. Pass a run_id (r_…) or an absolute run directory. A run whose folder is not in this workspace (an older version, or one rendered in another chat) is read from the company's run history instead: its status, stats, per-node results and the durable URL of every output.\",\n  },\n  args: {\n    run: { type: \"positional\", required: true, description: \"Run id (e.g. r_01K...) or absolute run directory\" },\n    \"outputs-dir\": { type: \"string\", description: \"Per-run outputs root (default <workspace root>/canvas, where `canvas run` writes)\" },\n    thumbnails: {\n      type: \"boolean\",\n      description: \"Extract start/middle/end frames from every video output in the local run folder (requires ffmpeg)\",\n    },\n  },\n  async run({ args }) {\n    const cwd = process.cwd();\n    const outputsDir = args[\"outputs-dir\"]\n      ? path.resolve(String(args[\"outputs-dir\"]))\n      : path.join(findWorkspaceRoot(cwd) ?? cwd, \"canvas\");\n    const runArg = String(args.run);\n    const runDir = await localRunDir(runArg, outputsDir);\n    if (!runDir) {\n      if (path.isAbsolute(runArg)) fail(\"not_found\", `${runArg} is not a run directory`);\n      await inspectFromHistory(runArg, path.join(outputsDir, runArg));\n      return;\n    }\n\n    const manifest = await loadManifest(runDir);\n    const files = await listRunFiles(runDir);\n    const videos = files.filter((f) => isVideoFile(f.path));\n    let thumbnails: Array<{ video: string; frames: string[] }> = [];\n    if (args.thumbnails) {\n      thumbnails = await extractThumbnails(videos.map((v) => v.path));\n    }\n\n    const summary = {\n      ok: true,\n      source: \"local\",\n      run_id: manifest.run_id ?? path.basename(runDir),\n      run_dir: runDir,\n      stats: manifest.stats ?? null,\n      output: manifest.output ?? null,\n      node_runs: manifest.node_runs ?? [],\n      files: files.map((f) => ({ name: f.name, path: f.path, size_bytes: f.size })),\n      thumbnails,\n    };\n\n    process.stdout.write(`${JSON.stringify(summary, null, 2)}\\n`);\n  },\n});\n\n/** The run's local folder, or null when this workspace does not have it. */\nasync function localRunDir(run: string, outputsDir: string): Promise<string | null> {\n  const candidate = path.isAbsolute(run) ? run : path.join(outputsDir, run);\n  const s = await stat(candidate).catch(() => null);\n  return s?.isDirectory() ? candidate : null;\n}\n\n/** The run as the company's run history keeps it: no local files, durable output URLs. */\nasync function inspectFromHistory(runId: string, expectedDir: string): Promise<void> {\n  let run: Awaited<ReturnType<typeof fetchRunRecord>>;\n  try {\n    run = await fetchRunRecord(runId);\n  } catch (e) {\n    const reason = e instanceof ApiError ? e.message : e instanceof Error ? e.message : String(e);\n    fail(\"unavailable\", `No run folder at ${expectedDir}, and the run history could not be read (${reason}).`);\n  }\n  if (!run) {\n    fail(\n      \"not_found\",\n      `No run \"${runId}\": there is no folder at ${expectedDir} and the company's run history has no run by that id.`,\n    );\n  }\n  const summary = {\n    ok: true,\n    source: \"run_history\",\n    run_id: run.runId,\n    creative: run.creativeSlug ?? null,\n    status: run.status,\n    ...(run.errorMessage ? { error: run.errorMessage } : {}),\n    stats: {\n      total_nodes: run.stats.totalNodes,\n      cached_nodes: run.stats.cachedNodes,\n      total_credits: run.stats.totalCredits,\n      duration_ms: run.stats.durationMs,\n    },\n    outputs: run.finalOutputs,\n    node_runs: run.nodes.map((node) => ({\n      node_id: node.nodeId,\n      node_type: node.nodeType,\n      cached: node.cached,\n      duration_ms: node.durationMs,\n      credits: node.credits,\n      ...(node.status ? { status: node.status } : {}),\n      outputs: node.outputs,\n    })),\n    ...(run.review ? { review: run.review } : {}),\n    hints: [\n      \"This run's folder is not in this workspace, so there are no local files: every output above is a durable URL. To render it again here, run `baker canvas run --slug <creative>`.\",\n    ],\n  };\n  process.stdout.write(`${JSON.stringify(summary, null, 2)}\\n`);\n}\n\nfunction fail(code: string, message: string): never {\n  process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message } }, null, 2)}\\n`);\n  process.exit(2);\n}\n\nasync function loadManifest(runDir: string): Promise<Manifest> {\n  const manifestPath = path.join(runDir, \"manifest.json\");\n  try {\n    const raw = await readFile(manifestPath, \"utf-8\");\n    return JSON.parse(raw) as Manifest;\n  } catch {\n    return {} as Manifest;\n  }\n}\n\ntype RunFile = { name: string; path: string; size: number };\nasync function listRunFiles(runDir: string): Promise<RunFile[]> {\n  const out: RunFile[] = [];\n  const names = await readdir(runDir);\n  for (const name of names) {\n    const abs = path.join(runDir, name);\n    const s = await stat(abs).catch(() => null);\n    if (!s?.isFile()) continue;\n    out.push({ name, path: abs, size: s.size });\n  }\n  out.sort((a, b) => a.name.localeCompare(b.name));\n  return out;\n}\n\nfunction isVideoFile(p: string): boolean {\n  return /\\.(mp4|webm|mov)$/i.test(p);\n}\n\nasync function extractThumbnails(videoPaths: string[]): Promise<Array<{ video: string; frames: string[] }>> {\n  const out: Array<{ video: string; frames: string[] }> = [];\n  for (const v of videoPaths) {\n    const duration = await probeDuration(v).catch(() => null);\n    if (duration === null) {\n      out.push({ video: v, frames: [] });\n      continue;\n    }\n    const frames: string[] = [];\n    const checkpoints = [0.05, 0.5, 0.95];\n    const base = v.replace(/\\.[^.]+$/, \"\");\n    for (const ratio of checkpoints) {\n      const at = Math.max(0, Math.min(duration * ratio, duration - 0.01));\n      const dest = `${base}__frame_${Math.round(ratio * 100)\n        .toString()\n        .padStart(2, \"0\")}.png`;\n      try {\n        await execFileAsync(\"ffmpeg\", [\"-ss\", at.toFixed(3), \"-i\", v, \"-frames:v\", \"1\", \"-y\", dest]);\n        frames.push(dest);\n      } catch {\n        // skip — best-effort; thumbnail extraction is non-fatal.\n      }\n    }\n    out.push({ video: v, frames });\n  }\n  return out;\n}\n\nasync function probeDuration(filePath: string): Promise<number> {\n  const { stdout } = await execFileAsync(\n    \"ffprobe\",\n    [\"-v\", \"error\", \"-show_entries\", \"format=duration\", \"-of\", \"csv=p=0\", filePath],\n    { encoding: \"utf-8\" },\n  );\n  return Number.parseFloat(stdout.trim());\n}\n"],"mappings":"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","names":[]}

package/dist/inspiration-I4MMKAWA.js

@@ -0,0 +1,53 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/inspiration/index.ts
+import { defineCommand } from "citty";
+var inspirationCommand = defineCommand({
+  meta: {
+    name: "inspiration",
+    description: `Reference library of real landing-page sections \u2014 look at how good pages actually solve a problem before you design one.
+
+Start here: \`baker landing inspiration search "<what you want to see>"\` during research, BEFORE you write the Direction Contract.
+
+This is inspiration, never a clipboard. Take the mechanism \u2014 what the eye hits first, what proof arrives before the ask, how the grid is split. The words are never yours to reuse: shipping a reference's headline is a Tier 0 message-match failure.
+
+Subcommands:
+  baker landing inspiration search "<query>"  \u2014 search by look, section type, composition, register or motion; saves screenshots you can Read
+  baker landing inspiration view <id>         \u2014 one section in full: tokens, motion filmstrip, why it works, what to change
+  baker landing inspiration code <id>         \u2014 its standalone HTML+CSS, for structure only
+  baker landing inspiration page <id>         \u2014 a whole page as a sequence: how it orders its sections
+  baker landing inspiration sequences "<q>"   \u2014 what follows what across MANY pages: openers, transitions, closers
+  baker landing inspiration add <url>         \u2014 add a page to the library and save it to this company (returns immediately); --refresh re-studies a page that changed
+  baker landing inspiration favorites         \u2014 what this company has saved; the default search scope
+  baker landing inspiration favorite <id>     \u2014 save a section
+  baker landing inspiration unfavorite <id>   \u2014 unsave a section
+  baker landing inspiration retry-failed      \u2014 study again every saved page that failed
+  baker landing inspiration scrape <url>      \u2014 internal/ops: run the capture locally
+
+Examples:
+  baker landing inspiration search "pricing with a monthly/annual toggle" --max-rank 3
+  baker landing inspiration search "dark developer hero with a terminal" --register dev-tool-minimal --scope all
+  baker landing inspiration search "testimonial wall with faces and company logos" --motion scroll-reveal
+  baker landing inspiration sequences "b2b saas pricing page" --scope all
+  baker landing inspiration add https://linear.app
+
+Full guide: __tooling__/docs/tools/baker/landing.md`
+  },
+  subCommands: {
+    search: () => import("./search-742XSULP.js").then((m) => m.searchCommand),
+    view: () => import("./view-NPAG66QK.js").then((m) => m.viewCommand),
+    code: () => import("./code-YS6ZMGX3.js").then((m) => m.codeCommand),
+    page: () => import("./page-GS3WLT2C.js").then((m) => m.pageCommand),
+    sequences: () => import("./sequences-OIPVR7JL.js").then((m) => m.sequencesCommand),
+    add: () => import("./add-577QWMCF.js").then((m) => m.addCommand),
+    favorites: () => import("./favorites-NSGF4OV5.js").then((m) => m.favoritesCommand),
+    favorite: () => import("./favorites-NSGF4OV5.js").then((m) => m.favoriteCommand),
+    unfavorite: () => import("./favorites-NSGF4OV5.js").then((m) => m.unfavoriteCommand),
+    "retry-failed": () => import("./retry-failed-6HXPUVXJ.js").then((m) => m.retryFailedCommand),
+    scrape: () => import("./scrape-ETAMW43A.js").then((m) => m.scrapeCommand)
+  }
+});
+export {
+  inspirationCommand
+};
+//# sourceMappingURL=inspiration-I4MMKAWA.js.map

package/dist/intent-ICKFJRT2.js

@@ -0,0 +1,95 @@
+import {
+  handleResearchError,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-TBEUMOEL.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-2SCPDSFN.js";
+import "./chunk-EVYXTT7V.js";
+import "./chunk-XML7AJM3.js";
+import {
+  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/intent.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.intent",
+  description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
+  args: {
+    keywords: {
+      type: "string",
+      description: "Comma-separated keywords (min 3 chars each, max 1000 keywords)",
+      required: true
+    },
+    language: {
+      type: "string",
+      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English keywords",
+      required: false
+    },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  keyword: "The keyword analyzed",
+  intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
+  probability: "Confidence score 0.0-1.0"
+};
+var intentCommand = defineCommand({
+  meta: {
+    name: "intent",
+    description: `Classify Google Search intent for keywords. Returns intent type and confidence.
+
+Examples:
+  baker research intent "buy running shoes,best running shoes 2026,how to tie running shoes"
+  baker research intent "crm software" --language spanish`
+  },
+  args: {
+    keywords: { type: "positional", description: "Comma-separated keywords", required: true },
+    language: { type: "string", description: "Language code or name (default: en)", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  },
+  run: async ({ args }) => {
+    const rawKeywords = args.keywords;
+    const keywords = rawKeywords.split(",").map((k) => k.trim()).filter((k) => k.length >= 3);
+    if (keywords.length === 0) {
+      writeResearchJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Provide at least one keyword (min 3 chars each)" }
+      });
+      process.exit(1);
+    }
+    const language = args.language || void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    const queryContext = buildResearchQueryContext(void 0, language, { skipLocation: true });
+    try {
+      const data = await apiPost("/api/research/intent", {
+        keywords,
+        language,
+        skipCache
+      });
+      warnDefaults(queryContext);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeResearchOutput(data, format);
+        return;
+      }
+      writeResearchJson({ ok: true, data, fields: FIELDS, query_context: queryContext });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  intentCommand
+};
+//# sourceMappingURL=intent-ICKFJRT2.js.map

package/dist/intent-ICKFJRT2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/intent.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { buildResearchQueryContext, warnDefaults } from \"../../geo-context.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { handleResearchError, writeResearchJson, writeResearchOutput } from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.intent\",\n  description:\n    \"Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.\",\n  args: {\n    keywords: {\n      type: \"string\",\n      description: \"Comma-separated keywords (min 3 chars each, max 1000 keywords)\",\n      required: true,\n    },\n    language: {\n      type: \"string\",\n      description:\n        \"Language code or name. Defaults to en (English) if omitted — always set this for non-English keywords\",\n      required: false,\n    },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n});\n\ninterface IntentResult {\n  keyword: string;\n  intent: string;\n  probability: number;\n}\n\nconst FIELDS: Record<string, string> = {\n  keyword: \"The keyword analyzed\",\n  intent: \"Primary Google Search intent: informational, navigational, commercial, transactional\",\n  probability: \"Confidence score 0.0-1.0\",\n};\n\nexport const intentCommand = defineCommand({\n  meta: {\n    name: \"intent\",\n    description: `Classify Google Search intent for keywords. Returns intent type and confidence.\n\nExamples:\n  baker research intent \"buy running shoes,best running shoes 2026,how to tie running shoes\"\n  baker research intent \"crm software\" --language spanish`,\n  },\n  args: {\n    keywords: { type: \"positional\", description: \"Comma-separated keywords\", required: true },\n    language: { type: \"string\", description: \"Language code or name (default: en)\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n  run: async ({ args }) => {\n    const rawKeywords = args.keywords as string;\n    const keywords = rawKeywords\n      .split(\",\")\n      .map((k) => k.trim())\n      .filter((k) => k.length >= 3);\n\n    if (keywords.length === 0) {\n      writeResearchJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: \"Provide at least one keyword (min 3 chars each)\" },\n      });\n      process.exit(1);\n    }\n\n    const language = (args.language as string) || undefined;\n    const skipCache = args[\"no-cache\"] ? true : undefined;\n    const queryContext = buildResearchQueryContext(undefined, language, { skipLocation: true });\n\n    try {\n      const data = await apiPost<IntentResult[]>(\"/api/research/intent\", {\n        keywords,\n        language,\n        skipCache,\n      });\n\n      warnDefaults(queryContext);\n      const format = (args.output as string) || \"json\";\n      if (format !== \"json\") {\n        writeResearchOutput(data as unknown as Array<Record<string, unknown>>, format);\n        return;\n      }\n      writeResearchJson({ ok: true, data, fields: FIELDS, query_context: queryContext });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AACF,CAAC;AAQD,IAAM,SAAiC;AAAA,EACrC,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,aAAa;AACf;AAEO,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,MAAM;AAAA,IACJ,UAAU,EAAE,MAAM,cAAc,aAAa,4BAA4B,UAAU,KAAK;AAAA,IACxF,UAAU,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAChG,QAAQ,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,OAAO,SAAS,OAAO;AAAA,IACrG,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,cAAc,KAAK;AACzB,UAAM,WAAW,YACd,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC;AAE9B,QAAI,SAAS,WAAW,GAAG;AACzB,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ,OAAO,EAAE,MAAM,oBAAoB,SAAS,kDAAkD;AAAA,MAChG,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO;AAC5C,UAAM,eAAe,0BAA0B,QAAW,UAAU,EAAE,cAAc,KAAK,CAAC;AAE1F,QAAI;AACF,YAAM,OAAO,MAAM,QAAwB,wBAAwB;AAAA,QACjE;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,mBAAa,YAAY;AACzB,YAAM,SAAU,KAAK,UAAqB;AAC1C,UAAI,WAAW,QAAQ;AACrB,4BAAoB,MAAmD,MAAM;AAC7E;AAAA,MACF;AACA,wBAAkB,EAAE,IAAI,MAAM,MAAM,QAAQ,QAAQ,eAAe,aAAa,CAAC;AAAA,IACnF,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/job-L7RJZMSG.js

@@ -0,0 +1,202 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-C6U6UDHJ.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson
+} from "./chunk-VFIOJD5M.js";
+import {
+  ApiError,
+  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/ads/x/stats/job.ts
+import { gunzipSync } from "zlib";
+import { defineCommand } from "citty";
+var POLL_INTERVAL_MS = 1e4;
+var DEADLINE_MS = 12 * 60 * 1e3;
+var RESULT_CACHE_TTL_MS = 6 * 60 * 60 * 1e3;
+registerSchema({
+  command: "ads.x.statsJob",
+  description: "Asynchronous X Ads stats job, fully synchronous from the CLI's perspective. Creates the job, polls every 10s, downloads + decompresses the gzip result, returns inline JSON. Hard deadline 12 min \u2014 must run in the background. Use this for ranges >7 days, segmented stats, or any query that hits sync limits. For fine-grained control, use `stats job-create` + `stats job-status` separately.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "CAMPAIGN | LINE_ITEM | PROMOTED_TWEET | ...", required: true },
+    "entity-ids": { type: "string", description: "CSV of entity IDs (max 20)", required: true },
+    "start-time": { type: "string", description: "ISO 8601 hour-aligned start", required: true },
+    "end-time": { type: "string", description: "ISO 8601 hour-aligned end", required: true },
+    granularity: { type: "string", description: "TOTAL | DAY | HOUR", required: false },
+    "metric-groups": { type: "string", description: "CSV of metric groups", required: true },
+    placement: { type: "string", description: "ALL_ON_TWITTER | PUBLISHER_NETWORK", required: false },
+    "segmentation-type": { type: "string", description: "Segmentation (e.g. AGE, GENDER, LOCATIONS)", required: false },
+    country: { type: "string", description: "Country filter", required: false },
+    platform: { type: "string", description: "Platform filter", required: false },
+    "no-cache": { type: "boolean", description: "Skip result cache (still does the live job)", required: false }
+  }
+});
+function parseCsv(v) {
+  if (typeof v !== "string" || v.length === 0) return void 0;
+  const parts = v.split(",").map((s) => s.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function downloadAndDecompress(url) {
+  const res = await fetch(url, { signal: AbortSignal.timeout(6e4) });
+  if (!res.ok) {
+    throw new ApiError("INTERNAL_ERROR", `Stats job download failed (${res.status})`);
+  }
+  const buf = Buffer.from(await res.arrayBuffer());
+  const decompressed = gunzipSync(buf);
+  return JSON.parse(decompressed.toString("utf-8"));
+}
+async function pollUntilDone(accountId, jobId) {
+  const deadline = Date.now() + DEADLINE_MS;
+  let lastLog = 0;
+  while (Date.now() < deadline) {
+    await sleep(POLL_INTERVAL_MS);
+    const jobs = await apiGet("/api/ads/x/stats/jobs", {
+      "account-id": accountId,
+      "job-id": jobId
+    });
+    const job = jobs[0];
+    if (!job) {
+      throw new ApiError("NOT_FOUND", `Stats job ${jobId} not found`);
+    }
+    if (job.status === "SUCCESS") {
+      return job;
+    }
+    if (job.status === "FAILED" || job.status === "CANCELLED") {
+      throw new ApiError("INTERNAL_ERROR", `Stats job ${jobId} ended in status ${job.status}`);
+    }
+    const elapsed = DEADLINE_MS - (deadline - Date.now());
+    if (elapsed - lastLog > 3e4) {
+      process.stderr.write(`  polling... (${job.status}, ${Math.round(elapsed / 1e3)}s elapsed)
+`);
+      lastLog = elapsed;
+    }
+  }
+  throw new ApiError("TIMEOUT", `Stats job ${jobId} did not complete within ${DEADLINE_MS / 6e4} minutes`);
+}
+function buildCacheKey(body) {
+  return `stats-job:${JSON.stringify(body)}`;
+}
+var statsJobCommand = defineCommand({
+  meta: {
+    name: "job",
+    description: `Async X Ads stats job, sync from the CLI's perspective. Creates \u2192 polls \u2192 downloads \u2192 returns.
+
+Must run in the background (the harness enforces this).
+
+Use this when:
+  \u2022 Date range > 7 days
+  \u2022 Need segmentation (AGE, GENDER, LOCATIONS, ...)
+  \u2022 Sync stats hit a limit
+
+Examples:
+  baker ads x stats job --account-id 18ce53xyz --entity CAMPAIGN \\
+    --entity-ids abc,def --start-time 2026-04-01T00:00:00Z \\
+    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT,BILLING
+
+  baker ads x stats job --account-id 18ce53xyz --entity LINE_ITEM \\
+    --entity-ids abc --start-time 2026-04-01T00:00:00Z \\
+    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT \\
+    --segmentation-type LOCATIONS
+
+For fine-grained control (don't wait, poll yourself), use:
+  baker ads x stats job-create   \u2014 create + return job ID immediately
+  baker ads x stats job-status   \u2014 poll job status / get download URL`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "Entity type", required: true },
+    "entity-ids": { type: "string", description: "CSV of entity IDs", required: true },
+    "start-time": { type: "string", description: "ISO start", required: true },
+    "end-time": { type: "string", description: "ISO end", required: true },
+    granularity: { type: "string", description: "Granularity", required: false },
+    "metric-groups": { type: "string", description: "Metric groups CSV", required: true },
+    placement: { type: "string", description: "Placement", required: false },
+    "segmentation-type": { type: "string", description: "Segmentation type", required: false },
+    country: { type: "string", description: "Country filter", required: false },
+    platform: { type: "string", description: "Platform filter", required: false },
+    "no-cache": { type: "boolean", description: "Skip result cache", required: false }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const entityIds = parseCsv(args["entity-ids"]);
+    const metricGroups = parseCsv(args["metric-groups"]);
+    if (!entityIds || !metricGroups) {
+      writeAdsJson({
+        ok: false,
+        error: { code: "MISSING_PARAMETER", message: "entity-ids and metric-groups are required" }
+      });
+      process.exit(1);
+    }
+    const body = {
+      accountId,
+      entity: args.entity,
+      entityIds,
+      startTime: args["start-time"],
+      endTime: args["end-time"],
+      granularity: args.granularity ?? "DAY",
+      metricGroups,
+      placement: args.placement ?? "ALL_ON_TWITTER",
+      segmentationType: args["segmentation-type"],
+      country: args.country,
+      platform: args.platform
+    };
+    const useCache = !args["no-cache"];
+    const cacheKey = buildCacheKey(body);
+    if (useCache) {
+      const cached = cacheGet("x-stats", cacheKey);
+      if (cached) {
+        process.stderr.write("Result served from cache.\n");
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      process.stderr.write(`Creating X Ads stats job for entity=${body.entity}, ${entityIds.length} IDs...
+`);
+      const job = await apiPost("/api/ads/x/stats/jobs", body);
+      process.stderr.write(`Job ${job.id} queued. Polling every ${POLL_INTERVAL_MS / 1e3}s...
+`);
+      const finished = await pollUntilDone(accountId, job.id);
+      if (!finished.url) {
+        throw new ApiError("INTERNAL_ERROR", `Stats job ${job.id} succeeded but returned no download URL`);
+      }
+      process.stderr.write("Job complete. Downloading + decompressing results...\n");
+      const data = await downloadAndDecompress(finished.url);
+      if (useCache) {
+        cacheSet("x-stats", cacheKey, data, RESULT_CACHE_TTL_MS);
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({
+        ok: false,
+        error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+      });
+      process.exit(1);
+    }
+  }
+});
+export {
+  statsJobCommand
+};
+//# sourceMappingURL=job-L7RJZMSG.js.map

package/dist/job-L7RJZMSG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/stats/job.ts"],"sourcesContent":["import { gunzipSync } from \"node:zlib\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiGet, apiPost } from \"../../../../client.ts\";\nimport { registerSchema } from \"../../../../schemas.ts\";\nimport { cacheGet, cacheSet } from \"../../cache.ts\";\nimport { writeAdsJson } from \"../../output.ts\";\nimport { parseXApiError } from \"../error-parser.ts\";\nimport { resolveXAccountId } from \"../output.ts\";\n\nconst POLL_INTERVAL_MS = 10_000;\nconst DEADLINE_MS = 12 * 60 * 1000;\nconst RESULT_CACHE_TTL_MS = 6 * 60 * 60 * 1000;\n\nregisterSchema({\n  command: \"ads.x.statsJob\",\n  description:\n    \"Asynchronous X Ads stats job, fully synchronous from the CLI's perspective. Creates the job, polls every 10s, downloads + decompresses the gzip result, returns inline JSON. Hard deadline 12 min — must run in the background. Use this for ranges >7 days, segmented stats, or any query that hits sync limits. For fine-grained control, use `stats job-create` + `stats job-status` separately.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    entity: { type: \"string\", description: \"CAMPAIGN | LINE_ITEM | PROMOTED_TWEET | ...\", required: true },\n    \"entity-ids\": { type: \"string\", description: \"CSV of entity IDs (max 20)\", required: true },\n    \"start-time\": { type: \"string\", description: \"ISO 8601 hour-aligned start\", required: true },\n    \"end-time\": { type: \"string\", description: \"ISO 8601 hour-aligned end\", required: true },\n    granularity: { type: \"string\", description: \"TOTAL | DAY | HOUR\", required: false },\n    \"metric-groups\": { type: \"string\", description: \"CSV of metric groups\", required: true },\n    placement: { type: \"string\", description: \"ALL_ON_TWITTER | PUBLISHER_NETWORK\", required: false },\n    \"segmentation-type\": { type: \"string\", description: \"Segmentation (e.g. AGE, GENDER, LOCATIONS)\", required: false },\n    country: { type: \"string\", description: \"Country filter\", required: false },\n    platform: { type: \"string\", description: \"Platform filter\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip result cache (still does the live job)\", required: false },\n  },\n});\n\ninterface XStatsJobShape {\n  id: string;\n  status: string;\n  url?: string;\n  expires_at?: string;\n}\n\nfunction parseCsv(v: unknown): string[] | undefined {\n  if (typeof v !== \"string\" || v.length === 0) return undefined;\n  const parts = v\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean);\n  return parts.length > 0 ? parts : undefined;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nasync function downloadAndDecompress(url: string): Promise<unknown> {\n  const res = await fetch(url, { signal: AbortSignal.timeout(60_000) });\n  if (!res.ok) {\n    throw new ApiError(\"INTERNAL_ERROR\", `Stats job download failed (${res.status})`);\n  }\n  const buf = Buffer.from(await res.arrayBuffer());\n  const decompressed = gunzipSync(buf);\n  return JSON.parse(decompressed.toString(\"utf-8\"));\n}\n\nasync function pollUntilDone(accountId: string, jobId: string): Promise<XStatsJobShape> {\n  const deadline = Date.now() + DEADLINE_MS;\n  let lastLog = 0;\n  while (Date.now() < deadline) {\n    await sleep(POLL_INTERVAL_MS);\n    const jobs = await apiGet<XStatsJobShape[]>(\"/api/ads/x/stats/jobs\", {\n      \"account-id\": accountId,\n      \"job-id\": jobId,\n    });\n    const job = jobs[0];\n    if (!job) {\n      throw new ApiError(\"NOT_FOUND\", `Stats job ${jobId} not found`);\n    }\n    if (job.status === \"SUCCESS\") {\n      return job;\n    }\n    if (job.status === \"FAILED\" || job.status === \"CANCELLED\") {\n      throw new ApiError(\"INTERNAL_ERROR\", `Stats job ${jobId} ended in status ${job.status}`);\n    }\n    const elapsed = DEADLINE_MS - (deadline - Date.now());\n    if (elapsed - lastLog > 30_000) {\n      process.stderr.write(`  polling... (${job.status}, ${Math.round(elapsed / 1000)}s elapsed)\\n`);\n      lastLog = elapsed;\n    }\n  }\n  throw new ApiError(\"TIMEOUT\", `Stats job ${jobId} did not complete within ${DEADLINE_MS / 60_000} minutes`);\n}\n\nfunction buildCacheKey(body: Record<string, unknown>): string {\n  return `stats-job:${JSON.stringify(body)}`;\n}\n\nexport const statsJobCommand = defineCommand({\n  meta: {\n    name: \"job\",\n    description: `Async X Ads stats job, sync from the CLI's perspective. Creates → polls → downloads → returns.\n\nMust run in the background (the harness enforces this).\n\nUse this when:\n  • Date range > 7 days\n  • Need segmentation (AGE, GENDER, LOCATIONS, ...)\n  • Sync stats hit a limit\n\nExamples:\n  baker ads x stats job --account-id 18ce53xyz --entity CAMPAIGN \\\\\n    --entity-ids abc,def --start-time 2026-04-01T00:00:00Z \\\\\n    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT,BILLING\n\n  baker ads x stats job --account-id 18ce53xyz --entity LINE_ITEM \\\\\n    --entity-ids abc --start-time 2026-04-01T00:00:00Z \\\\\n    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT \\\\\n    --segmentation-type LOCATIONS\n\nFor fine-grained control (don't wait, poll yourself), use:\n  baker ads x stats job-create   — create + return job ID immediately\n  baker ads x stats job-status   — poll job status / get download URL`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    entity: { type: \"string\", description: \"Entity type\", required: true },\n    \"entity-ids\": { type: \"string\", description: \"CSV of entity IDs\", required: true },\n    \"start-time\": { type: \"string\", description: \"ISO start\", required: true },\n    \"end-time\": { type: \"string\", description: \"ISO end\", required: true },\n    granularity: { type: \"string\", description: \"Granularity\", required: false },\n    \"metric-groups\": { type: \"string\", description: \"Metric groups CSV\", required: true },\n    placement: { type: \"string\", description: \"Placement\", required: false },\n    \"segmentation-type\": { type: \"string\", description: \"Segmentation type\", required: false },\n    country: { type: \"string\", description: \"Country filter\", required: false },\n    platform: { type: \"string\", description: \"Platform filter\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip result cache\", required: false },\n  },\n  run: async ({ args }) => {\n    const accountId = await resolveXAccountId(args);\n    const entityIds = parseCsv(args[\"entity-ids\"]);\n    const metricGroups = parseCsv(args[\"metric-groups\"]);\n    if (!entityIds || !metricGroups) {\n      writeAdsJson({\n        ok: false,\n        error: { code: \"MISSING_PARAMETER\", message: \"entity-ids and metric-groups are required\" },\n      });\n      process.exit(1);\n    }\n\n    const body = {\n      accountId,\n      entity: args.entity as string,\n      entityIds,\n      startTime: args[\"start-time\"] as string,\n      endTime: args[\"end-time\"] as string,\n      granularity: (args.granularity as string | undefined) ?? \"DAY\",\n      metricGroups,\n      placement: (args.placement as string | undefined) ?? \"ALL_ON_TWITTER\",\n      segmentationType: args[\"segmentation-type\"] as string | undefined,\n      country: args.country as string | undefined,\n      platform: args.platform as string | undefined,\n    };\n\n    const useCache = !args[\"no-cache\"];\n    const cacheKey = buildCacheKey(body);\n    if (useCache) {\n      const cached = cacheGet<unknown>(\"x-stats\", cacheKey);\n      if (cached) {\n        process.stderr.write(\"Result served from cache.\\n\");\n        writeAdsJson({ ok: true, data: cached.data, cached: true });\n        return;\n      }\n    }\n\n    try {\n      process.stderr.write(`Creating X Ads stats job for entity=${body.entity}, ${entityIds.length} IDs...\\n`);\n      const job = await apiPost<XStatsJobShape>(\"/api/ads/x/stats/jobs\", body);\n      process.stderr.write(`Job ${job.id} queued. Polling every ${POLL_INTERVAL_MS / 1000}s...\\n`);\n\n      const finished = await pollUntilDone(accountId, job.id);\n      if (!finished.url) {\n        throw new ApiError(\"INTERNAL_ERROR\", `Stats job ${job.id} succeeded but returned no download URL`);\n      }\n\n      process.stderr.write(\"Job complete. Downloading + decompressing results...\\n\");\n      const data = await downloadAndDecompress(finished.url);\n\n      if (useCache) {\n        cacheSet(\"x-stats\", cacheKey, data, RESULT_CACHE_TTL_MS);\n      }\n\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeAdsJson(parseXApiError(err.message, accountId));\n        process.exit(1);\n      }\n      writeAdsJson({\n        ok: false,\n        error: { code: \"NETWORK_ERROR\", message: err instanceof Error ? err.message : \"Unexpected error\" },\n      });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}