@koda-sl/baker-cli 0.525.0 → 0.527.0

package/dist/insights-IVW6W5CP.js

@@ -0,0 +1,439 @@
+import {
+  placementFormatNote,
+  previewFormatForPosition
+} from "./chunk-GC5P4KWY.js";
+import "./chunk-GDFJOCDO.js";
+import {
+  csvOrJson,
+  getDateRange,
+  handleMetaError
+} from "./chunk-BN4TDL5L.js";
+import {
+  metaBreakdownSyncedHint,
+  syncedFirstHint
+} from "./chunk-Y2FAUFWK.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-HPDGVK6R.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X3HPRECW.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/insights.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/meta/placement-delivery.ts
+var MIN_IMPRESSIONS = 20;
+var SILENT_FRACTION_OF_REFERENCE = 0.1;
+var PLAYING_REFERENCE_RATE = 0.5;
+function toNumber(value) {
+  const n = Number(value);
+  return Number.isFinite(n) ? n : 0;
+}
+function sumActionValues(value) {
+  if (!Array.isArray(value)) return 0;
+  return value.reduce((total, entry) => {
+    const item = entry;
+    return total + toNumber(item?.value);
+  }, 0);
+}
+function aggregate(rows) {
+  const byPlacement = /* @__PURE__ */ new Map();
+  let totalImpressions = 0;
+  for (const row of rows) {
+    const position = row.platform_position;
+    if (typeof position !== "string" || position.length === 0) continue;
+    const platform = typeof row.publisher_platform === "string" ? row.publisher_platform : "";
+    const impressions = toNumber(row.impressions);
+    totalImpressions += impressions;
+    const key = `${platform}/${position}`;
+    const current = byPlacement.get(key) ?? { platform, position, impressions: 0, plays: 0, playRate: 0, share: 0 };
+    current.impressions += impressions;
+    current.plays += sumActionValues(row.video_play_actions);
+    byPlacement.set(key, current);
+  }
+  return [...byPlacement.values()].map((placement) => ({
+    ...placement,
+    playRate: placement.impressions > 0 ? placement.plays / placement.impressions : 0,
+    share: totalImpressions > 0 ? placement.impressions / totalImpressions : 0
+  }));
+}
+function previewCommand(placement) {
+  const format = previewFormatForPosition(placement.position, placement.platform);
+  return format ? `\`baker ads meta preview --creative-id <id> --placement ${placement.position} --platform ${placement.platform}\`` : `no preview format is known for ${placement.position}, so Meta's renderer cannot confirm it \u2014 say the placement is unverified rather than filling the gap`;
+}
+function isSingleAdQuery(rows) {
+  const adIds = /* @__PURE__ */ new Set();
+  for (const row of rows) {
+    if (typeof row.ad_id !== "string" || row.ad_id.length === 0) return false;
+    adIds.add(row.ad_id);
+  }
+  return adIds.size === 1;
+}
+function placementDeliveryHints(rows) {
+  const carriesVideoMetrics = rows.some((row) => Array.isArray(row.video_play_actions));
+  if (!carriesVideoMetrics || !isSingleAdQuery(rows)) return [];
+  const placements = aggregate(rows);
+  const judgeable = placements.filter((p) => p.impressions >= MIN_IMPRESSIONS);
+  const impressions = judgeable.reduce((total, p) => total + p.impressions, 0);
+  const reference = impressions > 0 ? judgeable.reduce((total, p) => total + p.plays, 0) / impressions : 0;
+  if (reference < PLAYING_REFERENCE_RATE) return [];
+  const silent = judgeable.filter((p) => p.playRate < reference * SILENT_FRACTION_OF_REFERENCE).sort((a, b) => b.impressions - a.impressions);
+  if (silent.length === 0) {
+    const worst = [...judgeable].sort((a, b) => a.playRate - b.playRate)[0];
+    return [
+      `Checked every placement above ${MIN_IMPRESSIONS} impressions against this ad's own play rate (${(reference * 100).toFixed(0)}%): no placement is failing to play the video${worst ? `, the lowest being ${worst.platform}/${worst.position} at ${(worst.playRate * 100).toFixed(0)}%` : ""}. So placements do not explain a "it shows as a still image" report \u2014 rule out autoplay off or data saver in the viewer's own app, which renders every video as its cover frame account-wide.`
+    ];
+  }
+  const hints = silent.map((placement) => {
+    const note = placementFormatNote(placement.position);
+    const documented = note ? ` Meta documents this placement: ${note.note}` : "";
+    return `${placement.platform}/${placement.position} delivered ${placement.impressions.toLocaleString("en-US")} impressions (${(placement.share * 100).toFixed(1)}% of the total) and ${placement.plays.toLocaleString("en-US")} video plays \u2014 it may not be rendering the video. This is account evidence, not a rule: confirm what Meta renders there with ${previewCommand(placement)} before you say anything about it.${documented}`;
+  });
+  const combinedShare = silent.reduce((total, placement) => total + placement.share, 0) * 100;
+  hints.push(
+    `Those placements are ${combinedShare.toFixed(1)}% of delivery in this query. State that share before proposing to remove them \u2014 and note that removing placements from a live ad set is a targeting change, which Meta counts as a significant edit that re-enters the learning phase.`
+  );
+  return hints;
+}
+
+// src/commands/ads/meta/presets.ts
+var INSIGHTS_INTENTS = {
+  baseline: {
+    name: "baseline",
+    description: "Spend, impressions, clicks, CTR, CPC, CPM. The default question: 'how is delivery?'",
+    fields: ["impressions", "reach", "frequency", "spend", "clicks", "ctr", "cpc", "cpm"]
+  },
+  revenue: {
+    name: "revenue",
+    description: "Spend, conversions, action_values, purchase_roas. 'How much money are we making?'",
+    fields: ["spend", "actions", "action_values", "conversions", "conversion_values", "purchase_roas"],
+    actionBreakdowns: ["action_type"]
+  },
+  funnel: {
+    name: "funnel",
+    description: "Impression \u2192 click \u2192 landing page \u2192 action. 'Where do users drop off?'",
+    fields: ["impressions", "clicks", "inline_link_clicks", "outbound_clicks", "actions", "spend"],
+    actionBreakdowns: ["action_type"]
+  },
+  ranking: {
+    name: "ranking",
+    description: "Quality, engagement, conversion-rate rankings. 'Which creatives need a refresh?'",
+    fields: ["impressions", "spend", "ctr", "quality_ranking", "engagement_rate_ranking", "conversion_rate_ranking"]
+  },
+  video: {
+    name: "video",
+    description: "Watch funnel, thruplay cost. 'How are video creatives holding attention?'",
+    fields: [
+      "impressions",
+      "spend",
+      "video_play_actions",
+      "video_p25_watched_actions",
+      "video_p50_watched_actions",
+      "video_p75_watched_actions",
+      "video_p100_watched_actions",
+      "video_thruplay_watched_actions",
+      "cost_per_thruplay"
+    ]
+  },
+  identity: {
+    name: "identity",
+    description: "Just the names + spend \u2014 for cheap roll-up summaries.",
+    fields: ["spend", "impressions"]
+  }
+};
+var IDENTITY_FIELDS_BY_LEVEL = {
+  account: ["account_id", "account_name", "account_currency"],
+  campaign: ["campaign_id", "campaign_name", "objective"],
+  adset: ["adset_id", "adset_name", "campaign_id", "campaign_name"],
+  ad: ["ad_id", "ad_name", "adset_id", "adset_name", "campaign_id", "campaign_name"]
+};
+function composeFields(intent, level) {
+  const intentFields = INSIGHTS_INTENTS[intent].fields;
+  const identity = IDENTITY_FIELDS_BY_LEVEL[level];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const f of [...identity, ...intentFields]) {
+    if (!seen.has(f)) {
+      seen.add(f);
+      out.push(f);
+    }
+  }
+  return out;
+}
+function getIntent(name) {
+  return INSIGHTS_INTENTS[name];
+}
+function listIntents() {
+  return Object.values(INSIGHTS_INTENTS);
+}
+
+// src/commands/ads/meta/insights.ts
+var POLL_FIRST_MS = 5e3;
+var POLL_LONGEST_MS = 3e4;
+var POLL_MAX_MS = 10 * 6e4;
+function asyncPollDelayMs(attempt) {
+  return Math.min(Math.round(POLL_FIRST_MS * 1.5 ** attempt), POLL_LONGEST_MS);
+}
+var DEFAULT_ATTRIBUTION_WINDOWS = ["7d_click", "1d_view"];
+var DEFAULT_FILTERING = [{ field: "impressions", operator: "GREATER_THAN", value: 0 }];
+function commaSplit(input) {
+  if (!input) return void 0;
+  return input.split(",").map((s) => s.trim()).filter(Boolean);
+}
+function parseFiltering(raw) {
+  if (!raw) return void 0;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    handleMetaError(new Error("Invalid --filtering JSON"));
+  }
+}
+function pickIntent(name) {
+  if (!name) return "baseline";
+  const found = getIntent(name);
+  if (!found) {
+    handleMetaError(new Error(`Unknown --intent: ${name}. Use --list-intents to see options.`));
+  }
+  return found.name;
+}
+function pickLevel(args) {
+  const raw = args.level;
+  if (!raw) return "account";
+  if (raw !== "account" && raw !== "campaign" && raw !== "adset" && raw !== "ad") {
+    handleMetaError(new Error("--level must be one of: account|campaign|adset|ad"));
+  }
+  return raw;
+}
+function shouldAutoAsync(body) {
+  const breakdownCount = (body.breakdowns ?? []).length;
+  if (body.level === "ad" && breakdownCount > 0 && body.object.startsWith("act_")) {
+    return true;
+  }
+  if (breakdownCount > 2) {
+    return true;
+  }
+  if (body.since && body.until) {
+    const days = (Date.parse(body.until) - Date.parse(body.since)) / 864e5;
+    if (days > 90) {
+      return true;
+    }
+  }
+  return false;
+}
+function wantsAsync(asyncFlag, body) {
+  if (asyncFlag === true) return true;
+  if (asyncFlag === false) return false;
+  return shouldAutoAsync(body);
+}
+function applyDateRange(body, args) {
+  const range = getDateRange(args);
+  if (range.datePreset) body.datePreset = range.datePreset;
+  if (range.since) body.since = range.since;
+  if (range.until) body.until = range.until;
+  if (!body.datePreset && !(body.since && body.until)) {
+    body.datePreset = "last_7d";
+  }
+}
+function buildFiltering(args) {
+  const explicit = parseFiltering(args.filtering);
+  if (explicit) return explicit;
+  if (args["include-undelivered"]) return void 0;
+  return DEFAULT_FILTERING;
+}
+function buildAttributionWindows(args) {
+  const explicit = commaSplit(args["attribution-windows"]);
+  if (explicit) return explicit;
+  return DEFAULT_ATTRIBUTION_WINDOWS;
+}
+function buildBody(args) {
+  const intent = pickIntent(args.intent);
+  const level = pickLevel(args);
+  const intentDef = getIntent(intent);
+  const explicitFields = commaSplit(args.fields);
+  const fields = explicitFields ?? composeFields(intent, level);
+  const breakdowns = commaSplit(args.breakdowns);
+  const actionBreakdowns = commaSplit(args["action-breakdowns"]) ?? intentDef?.actionBreakdowns;
+  const body = {
+    object: args.object,
+    level,
+    fields,
+    timeIncrement: args["time-increment"],
+    breakdowns,
+    actionBreakdowns,
+    filtering: buildFiltering(args),
+    attributionWindows: buildAttributionWindows(args),
+    useAccountAttributionSetting: Boolean(args["use-account-attribution"]),
+    useUnifiedAttributionSetting: Boolean(args["use-unified-attribution"]),
+    limit: args.limit ? Number(args.limit) : 1e3,
+    skipCache: Boolean(args["no-cache"])
+  };
+  applyDateRange(body, args);
+  return body;
+}
+async function pollAsync(reportRunId) {
+  const start = Date.now();
+  for (let attempt = 0; Date.now() - start < POLL_MAX_MS; attempt++) {
+    const status = await apiGet(
+      "/api/ads/meta/insights/async/status",
+      { "report-run-id": reportRunId }
+    );
+    if (status.async_status === "Job Completed") return;
+    if (status.async_status === "Job Failed" || status.async_status === "Job Skipped") {
+      handleMetaError(new Error(`Async insights job ${status.async_status}`));
+    }
+    process.stderr.write(
+      `Async insights ${status.async_status ?? "queued"} (${Math.round(status.async_percent_completion ?? 0)}%)\u2026
+`
+    );
+    await new Promise((resolve) => setTimeout(resolve, asyncPollDelayMs(attempt)));
+  }
+  handleMetaError(new Error("Async insights polling timed out after 10 minutes"));
+}
+async function runAsync(body) {
+  const submit = await apiPost("/api/ads/meta/insights/async", body);
+  process.stderr.write(`Async insights job: ${submit.reportRunId}
+`);
+  await pollAsync(submit.reportRunId);
+  return apiPost("/api/ads/meta/insights/async/result", {
+    reportRunId: submit.reportRunId,
+    fields: body.fields,
+    limit: body.limit
+  });
+}
+function sortRowsBySpendDesc(rows) {
+  return [...rows].sort((a, b) => {
+    const sa = Number(a.spend ?? 0);
+    const sb = Number(b.spend ?? 0);
+    if (Number.isNaN(sa) || Number.isNaN(sb)) return 0;
+    return sb - sa;
+  });
+}
+function syncedHintOf(body) {
+  const breakdowns = body.breakdowns ?? [];
+  if (breakdowns.length > 0) return metaBreakdownSyncedHint(breakdowns);
+  const level = body.level === "adset" ? "ad_group" : body.level;
+  return syncedFirstHint("meta", level);
+}
+var insightsCommand = defineCommand({
+  meta: {
+    name: "insights",
+    description: `Performance reporting \u2014 the main Meta tool for AI agents.
+
+Smart defaults so the AI doesn't have to remember every flag:
+  --level account                       (set --level campaign|adset|ad to drill in)
+  --intent baseline                     (or revenue|funnel|ranking|video|identity)
+  --date-preset last_7d                 (override with --since/--until)
+  --attribution-windows 7d_click,1d_view  (the only ones still working post Jan 2026)
+  filter: impressions > 0               (skip undelivered rows; --include-undelivered to keep)
+  sort: spend descending                (when result fits in memory)
+  auto-async when query is heavy (level=ad + breakdowns, big date ranges, etc.)
+
+Identity fields (campaign_name, ad_name etc.) are appended automatically based on --level so rows
+are self-describing.
+
+Examples \u2014 common AI questions:
+  # "How is GreenLeaf doing this week?"
+  baker ads meta insights --object act_123
+
+  # "Which campaigns are profitable?"
+  baker ads meta insights --object act_123 --level campaign --intent revenue --date-preset last_28d
+
+  # "Which creatives need a refresh?"
+  baker ads meta insights --object act_123 --level ad --intent ranking --date-preset last_14d
+
+  # "Where do users drop off the funnel?"
+  baker ads meta insights --object act_123 --intent funnel
+
+  # "Should we shift budget to Instagram?"
+  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,platform_position
+
+  # Custom field set (escape hatch)
+  baker ads meta insights --object act_123 --fields impressions,spend,actions
+
+Async is automatic for heavy queries; pass --async to force it, or --no-async to refuse fallback.`
+  },
+  args: {
+    object: {
+      type: "string",
+      description: "Object ID \u2014 act_<id> for account, or a campaign/adset/ad ID"
+    },
+    level: { type: "string", description: "account|campaign|adset|ad (default: account)" },
+    intent: { type: "string", description: "baseline|revenue|funnel|ranking|video|identity (default: baseline)" },
+    fields: { type: "string", description: "Comma-separated field list (overrides --intent bundle)" },
+    "list-intents": { type: "boolean", description: "Print available intents and exit" },
+    "date-preset": { type: "string", description: "Meta date preset (last_7d, last_28d, today, ...)" },
+    since: { type: "string", description: "Custom start date YYYY-MM-DD" },
+    until: { type: "string", description: "Custom end date YYYY-MM-DD" },
+    "time-increment": { type: "string", description: "1 (day) | monthly | all_days" },
+    breakdowns: { type: "string", description: "Comma-separated breakdowns (e.g. publisher_platform,age)" },
+    "action-breakdowns": {
+      type: "string",
+      description: "Slice the actions[] array (default: action_type for revenue/funnel)"
+    },
+    filtering: { type: "string", description: "Override default filter \u2014 JSON array of {field,operator,value}" },
+    "include-undelivered": { type: "boolean", description: "Keep rows where impressions=0 (off by default)" },
+    "attribution-windows": {
+      type: "string",
+      description: "Override default 7d_click,1d_view (only 1d_view, 1d_click, 7d_click, 28d_click work post Jan 2026)"
+    },
+    "use-account-attribution": { type: "boolean", description: "Use account-saved attribution setting" },
+    "use-unified-attribution": { type: "boolean", description: "Use ad-set unified attribution setting" },
+    limit: { type: "string", description: "Max rows (default 1000)" },
+    // Declaring `no-async` too would be a trap: citty resolves it to `async: false`
+    // and never fills an arg of that name, so the declaration reads as supported
+    // while nothing consumes it.
+    async: { type: "boolean", description: "Force the async submit-and-poll path (--no-async refuses it)" },
+    "no-sort": { type: "boolean", description: "Skip default spend-desc sort" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "Output format", default: "json" }
+  },
+  run: async ({ args }) => {
+    if (args["list-intents"]) {
+      writeAdsJson({ ok: true, data: listIntents() });
+      return;
+    }
+    if (!args.object) {
+      writeAdsJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Missing required argument: --object" }
+      });
+      process.exit(1);
+    }
+    const body = buildBody(args);
+    const fmt = csvOrJson(args);
+    const wantAsync = wantsAsync(args.async, body);
+    try {
+      const rows = wantAsync ? await runAsync(body) : await apiPost("/api/ads/meta/insights", body);
+      const sorted = args["no-sort"] ? rows : sortRowsBySpendDesc(rows);
+      if (fmt !== "json") {
+        writeAdsOutput(sorted, fmt, body.fields);
+        return;
+      }
+      const synced = syncedHintOf(body);
+      const hints = [...placementDeliveryHints(sorted), ...synced === null ? [] : [synced]];
+      writeJsonEnvelope({ ok: true, data: sorted, hints });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  asyncPollDelayMs,
+  insightsCommand,
+  wantsAsync
+};
+//# sourceMappingURL=insights-IVW6W5CP.js.map

package/dist/inspect-25IVRU45.js

@@ -0,0 +1,192 @@
+import {
+  fetchRunRecord
+} from "./chunk-GT77XMOG.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-O37YK4P6.js";
+import "./chunk-ZVXKWLLE.js";
+import "./chunk-EHIISZYD.js";
+import "./chunk-SWNCS2OD.js";
+import "./chunk-HVJJEQDQ.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  ApiError
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import "./chunk-FSGJSREN.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-25IVRU45.js.map

package/dist/inspiration-KAXPRINY.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-MKVVMJ2Q.js").then((m) => m.searchCommand),
+    view: () => import("./view-IKKRJ5YD.js").then((m) => m.viewCommand),
+    code: () => import("./code-R4JOQ27J.js").then((m) => m.codeCommand),
+    page: () => import("./page-XVOUD4VV.js").then((m) => m.pageCommand),
+    sequences: () => import("./sequences-3CEVHGHB.js").then((m) => m.sequencesCommand),
+    add: () => import("./add-KB7O7NSB.js").then((m) => m.addCommand),
+    favorites: () => import("./favorites-R3JO4SJJ.js").then((m) => m.favoritesCommand),
+    favorite: () => import("./favorites-R3JO4SJJ.js").then((m) => m.favoriteCommand),
+    unfavorite: () => import("./favorites-R3JO4SJJ.js").then((m) => m.unfavoriteCommand),
+    "retry-failed": () => import("./retry-failed-OAH7JQKD.js").then((m) => m.retryFailedCommand),
+    scrape: () => import("./scrape-ZHL2BHS7.js").then((m) => m.scrapeCommand)
+  }
+});
+export {
+  inspirationCommand
+};
+//# sourceMappingURL=inspiration-KAXPRINY.js.map