@koda-sl/baker-cli 0.238.0 → 0.240.0

package/dist/cli.js

@@ -9763,11 +9763,11 @@ function rawTextEntries(value) {
   const values = Array.isArray(value) ? value : typeof value === "string" ? [value] : [];
   return values.filter((v) => typeof v === "string").flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
 }
-function rawFileEntries(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function rawFileEntries(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return [];
   }
-  return readFileSync2(path39, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  return readFileSync2(path40, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
 }
 function keywordEntries(args) {
   const defaultMatch = typeof args["match-type"] === "string" ? args["match-type"].toUpperCase() : void 0;
@@ -9790,19 +9790,19 @@ function keywordEntries(args) {
   }
   return entries;
 }
-function loadJsonFileArg(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function loadJsonFileArg(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync2(path39, "utf8"));
+    const parsed = JSON.parse(readFileSync2(path40, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation(`${path39} must contain a JSON object`);
+      failWriteValidation(`${path40} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation(`${path39} is not valid JSON: ${err.message}`);
+      failWriteValidation(`${path40} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -9932,10 +9932,10 @@ async function stageUpdate(kind, customerId, target, payload, hints) {
 async function stageTarget(kind, customerId, target, hints) {
   await stageGoogleOp({ kind, customerId, target }, hints);
 }
-async function draftAction(path39, body, chat) {
+async function draftAction(path40, body, chat) {
   try {
     const chatId = resolveChatId(chat);
-    const response = await apiPost(path39, { chatId, ...body });
+    const response = await apiPost(path40, { chatId, ...body });
     writeJsonEnvelope(response);
   } catch (err) {
     handleGoogleError(err);
@@ -12562,7 +12562,9 @@ var analyticsDimensionRowSchema = z24.object({
 var analyticsFunnelStepSchema = z24.object({
   stepId: z24.string(),
   stepIndex: z24.number().int().nonnegative(),
+  /** Visits that moved forward into this step. Never events — see `visits`. */
   views: z24.number().int().nonnegative(),
+  /** Visits that finished this step and moved on. */
   completions: z24.number().int().nonnegative(),
   /** Share of viewers who did not complete this step, 0–1. */
   dropRate: z24.number().min(0).max(1).nullable(),
@@ -12574,13 +12576,37 @@ var analyticsFunnelStepSchema = z24.object({
    * conversion, and knowing which step owns it is what stops a drop-off chart
    * treating the booking widget's "profile viewed" as a funnel stage.
    */
-  convertedSessions: z24.number().int().nonnegative()
+  convertedSessions: z24.number().int().nonnegative(),
+  /**
+   * This step is where the Form ends — a confirmation screen, not a loss.
+   *
+   * Stated rather than left to be inferred. The dashboard used to read it off
+   * `dropRate === null`, which is also how a step nobody viewed arrives, so a
+   * converting link node in the middle of a Form was labelled its ending.
+   */
+  isEnding: z24.boolean()
 });
 var analyticsFunnelSchema = z24.object({
   flowSlug: z24.string(),
+  /**
+   * Visits that saw the Form at all — the denominator for every share here.
+   *
+   * Read this, not `starts`, whenever the question is "out of how many". A
+   * start is recorded at the visitor's FIRST INTERACTION, so the two differ by
+   * exactly the people who looked at the Form and never touched it — usually
+   * most of them, and always the group a drop-off chart exists to find.
+   *
+   * Every count in this object is distinct visits, including each step's
+   * `views` and `completions`. That is load-bearing rather than incidental:
+   * the screen divides these by each other, and while the steps counted events
+   * a Form four people had opened reported one step reached fifteen times and
+   * fourteen people lost.
+   */
+  visits: z24.number().int().nonnegative(),
+  /** Visits that interacted with the Form at all — typed, picked, or advanced. */
   starts: z24.number().int().nonnegative(),
   submits: z24.number().int().nonnegative(),
-  /** Submits per start, 0–1. */
+  /** Conversions per visit that opened the Form, 0–1. */
   completionRate: z24.number().min(0).max(1).nullable(),
   /** The step losing the most people. The single most useful field here. */
   worstStep: analyticsFunnelStepSchema.nullable(),
@@ -14843,19 +14869,19 @@ function failWriteValidation2(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg2(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function loadJsonFileArg2(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync4(path39, "utf8"));
+    const parsed = JSON.parse(readFileSync4(path40, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation2(`${path39} must contain a JSON object`);
+      failWriteValidation2(`${path40} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation2(`${path39} is not valid JSON: ${err.message}`);
+      failWriteValidation2(`${path40} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -14940,15 +14966,15 @@ function parseLocaleFlag(value) {
   }
   return { language: match[1], country: match[2].toUpperCase() };
 }
-function loadTargetingFileArg(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function loadTargetingFileArg(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return void 0;
   }
-  const parsed = loadJsonFileArg2(path39);
+  const parsed = loadJsonFileArg2(path40);
   const criteria = parsed.targetingCriteria ?? parsed;
   if (!criteria.include) {
     failWriteValidation2(
-      `${path39} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
+      `${path40} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
     );
   }
   return criteria;
@@ -14983,14 +15009,14 @@ function parseCsvLine(line) {
   cells.push(current);
   return cells.map((cell2) => cell2.trim());
 }
-function parseListFileArg(path39, maxRows) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function parseListFileArg(path40, maxRows) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return void 0;
   }
-  const raw = readFileSync4(path39, "utf8");
+  const raw = readFileSync4(path40, "utf8");
   const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
   if (lines.length < 2) {
-    failWriteValidation2(`${path39} needs a header row and at least one data row`);
+    failWriteValidation2(`${path40} needs a header row and at least one data row`);
   }
   const columns = parseCsvLine(lines[0]).map((column) => column.trim());
   const rows = [];
@@ -15009,7 +15035,7 @@ function parseListFileArg(path39, maxRows) {
     }
   }
   if (rows.length > maxRows) {
-    failWriteValidation2(`${path39} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
+    failWriteValidation2(`${path40} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
   }
   return { columns, rows };
 }
@@ -15105,11 +15131,11 @@ function readPositionals(args) {
 function splitIdList(raw) {
   return raw.split(",").map((id) => id.trim()).filter(Boolean);
 }
-function idsFileEntries(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function idsFileEntries(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return [];
   }
-  return readFileSync4(path39, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
+  return readFileSync4(path40, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
 }
 function requireTargets(args, entity) {
   const positionals = readPositionals(args);
@@ -17730,9 +17756,9 @@ function compactRow(row) {
     ...destination.postUrn ? { postUrn: destination.postUrn } : {}
   };
 }
-function readPath(row, path39) {
+function readPath(row, path40) {
   let current = row;
-  for (const segment of path39.split(".")) {
+  for (const segment of path40.split(".")) {
     const record = asRecord2(current);
     if (!record) return void 0;
     current = record[segment];
@@ -17742,10 +17768,10 @@ function readPath(row, path39) {
 function projectFields(rows, paths) {
   return rows.map((row) => {
     const projected = {};
-    for (const path39 of paths) {
-      const value = readPath(row, path39);
+    for (const path40 of paths) {
+      const value = readPath(row, path40);
       if (value !== void 0) {
-        projected[path39] = value;
+        projected[path40] = value;
       }
     }
     return projected;
@@ -19045,11 +19071,11 @@ var updateStatusSchema = z25.enum(UPDATE_STATUSES);
 function currencyMinimums2(currencyCode) {
   return CURRENCY_MINIMUMS2[currencyCode] ?? DEFAULT_CURRENCY_MINIMUM2;
 }
-function validateDailyBudgetFloor(money, ctx, path39) {
+function validateDailyBudgetFloor(money, ctx, path40) {
   if (money?.currencyCode) {
     const min = currencyMinimums2(money.currencyCode).dailyBudgetMin;
     if (Number(money.amount) < min) {
-      ctx.addIssue({ code: "custom", path: path39, message: `below the ${min} ${money.currencyCode} daily minimum` });
+      ctx.addIssue({ code: "custom", path: path40, message: `below the ${min} ${money.currencyCode} daily minimum` });
     }
   }
 }
@@ -19711,19 +19737,19 @@ function failWriteValidation3(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg3(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function loadJsonFileArg3(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync8(path39, "utf8"));
+    const parsed = JSON.parse(readFileSync8(path40, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation3(`${path39} must contain a JSON object`);
+      failWriteValidation3(`${path40} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation3(`${path39} is not valid JSON: ${err.message}`);
+      failWriteValidation3(`${path40} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -23754,7 +23780,7 @@ var funnelCommand = presetCommand({
 var flowCommand = presetCommand({
   name: "flow",
   preset: "flow",
-  description: "One Form in depth: how many people it converted, where they went between steps, the per-step table, and every trigger it raised. Read `flowSummary.convertedSessions`, not `submits` \u2014 a Form that books a call on a scheduling node in the MIDDLE of the flow never emits a submit, so it reports zero submits and every one of its real bookings as conversions. `flowPaths` is the flow as edges between steps, bracketed by __flow_start__, __flow_converted__ and __flow_exit__, which is how a branching Form is read at all: a per-step table cannot say that of the people who left step two, forty went to the booking branch and ninety went nowhere.",
+  description: "One Form in depth: how many people it converted, where they went between steps, the per-step table, and every trigger it raised. Every count is DISTINCT VISITS, so quote shares against `funnels[].visits` \u2014 the visits that opened the Form \u2014 and never against `starts`, which is only the visits that touched it. The gap between the two is people who read the Form and left, and on most Forms it is the largest loss there is. Read `flowSummary.convertedSessions`, not `submits` \u2014 a Form that books a call on a scheduling node in the MIDDLE of the flow never emits a submit, so it reports zero submits and every one of its real bookings as conversions. `flowPaths` is the flow as edges between steps, bracketed by __flow_start__, __flow_converted__ and __flow_exit__, which is how a branching Form is read at all: a per-step table cannot say that of the people who left step two, forty went to the booking branch and ninety went nowhere.",
   extraArgs: { flow: { type: "string", description: "Form slug (default: every Form)", required: false } },
   resolve: (args) => ({ preset: "flow", flowSlug: args.flow ? String(args.flow) : void 0 })
 });
@@ -24301,11 +24327,11 @@ function unwrap(response) {
   }
   return response.data;
 }
-async function readAvatars(path39, params) {
-  return unwrap(await apiGet(path39, params));
+async function readAvatars(path40, params) {
+  return unwrap(await apiGet(path40, params));
 }
-async function writeAvatars(path39, body) {
-  return unwrap(await apiPost(path39, body));
+async function writeAvatars(path40, body) {
+  return unwrap(await apiPost(path40, body));
 }
 
 // src/commands/avatars/create.ts
@@ -25139,12 +25165,12 @@ function missingFontFiles(urls, available) {
 function planFontAdoption(sources, families) {
   const wanted = new Map(families.map((family) => [normalizeFamily(family), family]));
   const byFamily = /* @__PURE__ */ new Map();
-  for (const { path: path39, source } of sources) {
-    const dir = posix.dirname(path39);
+  for (const { path: path40, source } of sources) {
+    const dir = posix.dirname(path40);
     for (const face of declaredFontFaces(source)) {
       if (!wanted.has(face.family)) continue;
       const perFile = byFamily.get(face.family) ?? /* @__PURE__ */ new Map();
-      perFile.set(path39, [...perFile.get(path39) ?? [], rebaseFontFaceSrc(face.block, dir)]);
+      perFile.set(path40, [...perFile.get(path40) ?? [], rebaseFontFaceSrc(face.block, dir)]);
       byFamily.set(face.family, perFile);
     }
   }
@@ -33339,12 +33365,12 @@ function collectSideEffects(tree) {
   );
 }
 function readFlowTree(slug) {
-  const path39 = join3(flowsDir(), slug, "_data.json");
-  if (!existsSync5(path39)) {
+  const path40 = join3(flowsDir(), slug, "_data.json");
+  if (!existsSync5(path40)) {
     failLocal(`No form "${slug}". Run "baker flows list" to see the forms in this workspace.`);
   }
   try {
-    return JSON.parse(readFileSync9(path39, "utf-8"));
+    return JSON.parse(readFileSync9(path40, "utf-8"));
   } catch (error) {
     failLocal(`Could not read form "${slug}": ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -33736,10 +33762,10 @@ function parseValueExpression(raw) {
   return parts.map(parsePart);
 }
 function trackingFieldIds() {
-  const path39 = join4(flowsDir(), "..", "tracking.ts");
-  if (!existsSync6(path39)) return null;
+  const path40 = join4(flowsDir(), "..", "tracking.ts");
+  if (!existsSync6(path40)) return null;
   try {
-    const source = readFileSync10(path39, "utf-8");
+    const source = readFileSync10(path40, "utf-8");
     const block2 = source.match(/TRACKING_FIELD_IDS\s*=\s*\[([\s\S]*?)\]\s*as const/)?.[1];
     if (!block2) return null;
     const ids = [...block2.matchAll(/"(tracking\.[a-z0-9_]+)"/g)].map((match) => match[1]);
@@ -34291,13 +34317,13 @@ function specsFromFile(parsed) {
     return `${destField}${type}=${entry?.value ?? ""}`;
   });
 }
-function readSpecFile(path39) {
+function readSpecFile(path40) {
   let raw;
   try {
-    raw = path39 === "-" ? readFileSync11(0, "utf-8") : readFileSync11(path39, "utf-8");
+    raw = path40 === "-" ? readFileSync11(0, "utf-8") : readFileSync11(path40, "utf-8");
   } catch (error) {
     refuse(
-      `Could not read ${path39 === "-" ? "the mapping from stdin" : `"${path39}"`}: ${error instanceof Error ? error.message : String(error)}`
+      `Could not read ${path40 === "-" ? "the mapping from stdin" : `"${path40}"`}: ${error instanceof Error ? error.message : String(error)}`
     );
   }
   let parsed;
@@ -34305,7 +34331,7 @@ function readSpecFile(path39) {
     parsed = JSON.parse(raw);
   } catch (error) {
     refuse(
-      `${path39 === "-" ? "stdin" : `"${path39}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
+      `${path40 === "-" ? "stdin" : `"${path40}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
       'Expected { "map": { "<destField>": "<value>", \u2026 } }'
     );
   }
@@ -34559,18 +34585,18 @@ var ARRAY_FIELDS = [
   "tagIds"
 ];
 var ARRAY_OWNERS = ["", "body"];
-function dropUnsetOptionals(sideEffect, path39) {
+function dropUnsetOptionals(sideEffect, path40) {
   return OPTIONAL_STRINGS.flatMap((key) => {
     if (!(key in sideEffect) || sideEffect[key] !== null && sideEffect[key] !== "") return [];
     delete sideEffect[key];
-    return [{ path: path39, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
+    return [{ path: path40, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
   });
 }
-function fillNulledArrays(target, prefix, path39) {
+function fillNulledArrays(target, prefix, path40) {
   return ARRAY_FIELDS.flatMap((key) => {
     if (!(key in target) || target[key] !== null) return [];
     target[key] = [];
-    return [{ path: path39, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
+    return [{ path: path40, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
   });
 }
 function sideEffectsOf(node) {
@@ -34580,13 +34606,13 @@ function sideEffectsOf(node) {
   );
 }
 function normalizeSideEffect(sideEffect, where) {
-  const path39 = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
+  const path40 = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
   const arrays = ARRAY_OWNERS.flatMap((owner) => {
     const target = owner ? sideEffect[owner] : sideEffect;
     if (!target || typeof target !== "object") return [];
-    return fillNulledArrays(target, owner ? `${owner}.` : "", path39);
+    return fillNulledArrays(target, owner ? `${owner}.` : "", path40);
   });
-  return [...dropUnsetOptionals(sideEffect, path39), ...arrays];
+  return [...dropUnsetOptionals(sideEffect, path40), ...arrays];
 }
 function normalizeFlowTree(tree) {
   const changes = [];
@@ -35124,10 +35150,10 @@ async function stageOps(ops) {
     handleError2(err);
   }
 }
-async function draftAction2(path39, body, chat) {
+async function draftAction2(path40, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path39, { chatId, ...body });
+    const data = await apiPost(path40, { chatId, ...body });
     writeJsonEnvelope({ ok: true, data });
     return data;
   } catch (err) {
@@ -37559,9 +37585,9 @@ async function readImageBuffer(pathOrUrl) {
   }
   return readFile20(pathOrUrl);
 }
-async function isDirectory(path39) {
+async function isDirectory(path40) {
   try {
-    const s = await stat4(path39);
+    const s = await stat4(path40);
     return s.isDirectory();
   } catch {
     return false;
@@ -37863,13 +37889,13 @@ function resolveDownloadPath({ baseName, extension, out, outIsDirectory: outIsDi
 }
 function disambiguate(paths) {
   const taken = /* @__PURE__ */ new Set();
-  return paths.map((path39) => {
-    if (!taken.has(path39)) {
-      taken.add(path39);
-      return path39;
+  return paths.map((path40) => {
+    if (!taken.has(path40)) {
+      taken.add(path40);
+      return path40;
     }
-    const ext = extname3(path39);
-    const stem = path39.slice(0, path39.length - ext.length);
+    const ext = extname3(path40);
+    const stem = path40.slice(0, path40.length - ext.length);
     let n = 2;
     while (taken.has(`${stem}-${n}${ext}`)) n += 1;
     const unique = `${stem}-${n}${ext}`;
@@ -37996,10 +38022,10 @@ async function runDownloads(plan) {
   const paths = disambiguate(fetched.map((item) => item.path));
   const downloaded = [];
   for (const [index, item] of fetched.entries()) {
-    const path39 = paths[index] ?? item.path;
+    const path40 = paths[index] ?? item.path;
     try {
-      await atomicWrite(path39, item.buffer);
-      downloaded.push({ input: item.input, output: path39, bytes: item.buffer.length, contentType: item.contentType });
+      await atomicWrite(path40, item.buffer);
+      downloaded.push({ input: item.input, output: path40, bytes: item.buffer.length, contentType: item.contentType });
     } catch (err) {
       failed.push({ input: item.input, error: failureMessage(err, "Write failed") });
     }
@@ -42680,7 +42706,7 @@ var pageCommand2 = defineCommand160({
 
 // src/commands/landing/inspiration/scrape.ts
 import { readFile as readFile23 } from "fs/promises";
-import path33 from "path";
+import path34 from "path";
 import { defineCommand as defineCommand161 } from "citty";
 
 // src/engine/landing/lib/capturedReferences.ts
@@ -44747,6 +44773,44 @@ async function scrapeLanding(options) {
   }
 }
 
+// src/commands/landing/inspiration/captureOut.ts
+import { existsSync as existsSync9 } from "fs";
+import path33 from "path";
+var SCRATCH_DIR = ".baker";
+function isWithin(parent, target) {
+  const relative = path33.relative(parent, target);
+  return relative === "" || !relative.startsWith("..") && !path33.isAbsolute(relative);
+}
+function findRepoRoot(from) {
+  let dir = path33.resolve(from);
+  for (; ; ) {
+    if (existsSync9(path33.join(dir, ".git"))) return dir;
+    const parent = path33.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function checkCaptureOut(out, options) {
+  const { cwd, repoRoot } = options;
+  const resolved = path33.resolve(cwd, out);
+  if (repoRoot === null || !isWithin(repoRoot, resolved)) return { ok: true };
+  const scratch = path33.join(repoRoot, SCRATCH_DIR);
+  if (isWithin(scratch, resolved)) return { ok: true };
+  const suggestion = path33.posix.join(SCRATCH_DIR, "teardowns", path33.basename(resolved) || "capture");
+  return {
+    ok: false,
+    error: {
+      code: "CAPTURE_OUT_NOT_SCRATCH",
+      message: `A capture has to be written to ${SCRATCH_DIR}/ inside this workspace. It is reference material for this turn, and anywhere else it becomes a permanent part of the client's files.`,
+      fix: {
+        action: "retry_with_changes",
+        explanation: `Re-run with --out ${suggestion}.`
+      },
+      retryable: false
+    }
+  };
+}
+
 // src/commands/landing/inspiration/scrape.ts
 var RETRYABLE_FAILURES = /* @__PURE__ */ new Set([
   "SITE_TOO_SLOW",
@@ -44761,7 +44825,7 @@ async function recordCapture(manifest, outDir) {
   for (const section of manifest.sections) {
     if (!section.bundle) continue;
     try {
-      const markup = await readFile23(path33.join(outDir, section.bundle), "utf8");
+      const markup = await readFile23(path34.join(outDir, section.bundle), "utf8");
       const copyStrings = capturedCopyStrings(markup);
       if (copyStrings.length === 0) continue;
       references.push({
@@ -44807,7 +44871,7 @@ registerSchema({
   description: "Start here when the user points at a specific page and wants it now: capture one landing page into a directory of section screenshots, standalone HTML bundles, a whole-page reproduction and motion filmstrips. Returns when the capture is done, unlike `add`. Read the screenshots. Also records every captured section for the originality check.",
   args: {
     url: { type: "string", description: "Page to capture", required: true },
-    out: { type: "string", description: "Output directory", required: true },
+    out: { type: "string", description: "Output directory under .baker/", required: true },
     mobile: { type: "boolean", description: "Phone-viewport pass. `--no-mobile` to skip", required: false },
     code: {
       type: "boolean",
@@ -44829,7 +44893,7 @@ var scrapeCommand = defineCommand161({
   },
   args: {
     url: { type: "positional", description: "Page to capture", required: true },
-    out: { type: "string", description: "Output directory", required: true },
+    out: { type: "string", description: "Output directory, under .baker/", required: true },
     mobile: {
       type: "boolean",
       description: "Phone-viewport pass (--no-mobile to skip)",
@@ -44846,6 +44910,14 @@ var scrapeCommand = defineCommand161({
     report: { type: "boolean", description: "Write report.html (--no-report to skip)", required: false, default: true }
   },
   run: async ({ args }) => {
+    const location2 = checkCaptureOut(args.out, {
+      cwd: process.cwd(),
+      repoRoot: findRepoRoot(process.cwd())
+    });
+    if (!location2.ok) {
+      writeJson({ ok: false, error: location2.error });
+      process.exit(1);
+    }
     try {
       const manifest = await scrapeLanding({
         url: args.url,
@@ -44923,12 +44995,12 @@ var scrapeCommand = defineCommand161({
 });
 
 // src/commands/landing/inspiration/search.ts
-import path35 from "path";
+import path36 from "path";
 import { defineCommand as defineCommand162 } from "citty";
 
 // src/commands/landing/inspiration/shot.ts
 import { mkdir as mkdir12, writeFile as writeFile17 } from "fs/promises";
-import path34 from "path";
+import path35 from "path";
 import sharp6 from "sharp";
 var READABLE_SHOT = {
   maxWidth: 1440,
@@ -44954,9 +45026,9 @@ async function downloadReadableShot(url, file) {
     const response = await fetch(url);
     if (!response.ok) return null;
     const shot = await toReadableShot(Buffer.from(await response.arrayBuffer()));
-    await mkdir12(path34.dirname(file), { recursive: true });
+    await mkdir12(path35.dirname(file), { recursive: true });
     await writeFile17(file, shot);
-    return path34.relative(process.cwd(), file);
+    return path35.relative(process.cwd(), file);
   } catch {
     return null;
   }
@@ -45048,13 +45120,13 @@ function buildSearchBody(args) {
   return body;
 }
 async function downloadShots(results) {
-  const dir = path35.join(process.cwd(), ".baker", "inspiration");
+  const dir = path36.join(process.cwd(), ".baker", "inspiration");
   const saved = /* @__PURE__ */ new Map();
   await Promise.all(
     results.map(async (result) => {
       const file = await downloadReadableShot(
         result.desktopShotUrl,
-        path35.join(dir, `${result.id}.${READABLE_SHOT.extension}`)
+        path36.join(dir, `${result.id}.${READABLE_SHOT.extension}`)
       );
       if (file) saved.set(result.id, file);
     })
@@ -45282,7 +45354,7 @@ var sequencesCommand = defineCommand163({
 });
 
 // src/commands/landing/inspiration/view.ts
-import path36 from "path";
+import path37 from "path";
 import { defineCommand as defineCommand164 } from "citty";
 registerSchema({
   command: "landing.inspiration.view",
@@ -45315,12 +45387,12 @@ var viewCommand2 = defineCommand164({
       const id = args.id;
       const data = await apiGet("/api/landing-inspiration/section", { id });
       const section = data.section;
-      const dir = path36.join(process.cwd(), ".baker", "inspiration", id);
+      const dir = path37.join(process.cwd(), ".baker", "inspiration", id);
       const ext = READABLE_SHOT.extension;
       const [desktop, mobile, filmstrip] = await Promise.all([
-        downloadReadableShot(section.desktopShotUrl, path36.join(dir, `desktop.${ext}`)),
-        downloadReadableShot(section.mobileShotUrl, path36.join(dir, `mobile.${ext}`)),
-        downloadReadableShot(section.motionFilmstripUrl, path36.join(dir, `motion-filmstrip.${ext}`))
+        downloadReadableShot(section.desktopShotUrl, path37.join(dir, `desktop.${ext}`)),
+        downloadReadableShot(section.mobileShotUrl, path37.join(dir, `mobile.${ext}`)),
+        downloadReadableShot(section.motionFilmstripUrl, path37.join(dir, `motion-filmstrip.${ext}`))
       ]);
       const full = args.full;
       const hints = [INSPIRATION_HINTS.structureNotCopy, INSPIRATION_HINTS.adapt];
@@ -47170,7 +47242,7 @@ var listCommand15 = defineCommand183({
 
 // src/commands/scheduled-actions/templates.ts
 import { readFile as readFile24 } from "fs/promises";
-import path37 from "path";
+import path38 from "path";
 import { defineCommand as defineCommand184 } from "citty";
 registerSchema({
   command: "scheduled-actions.templates",
@@ -47273,7 +47345,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
       }
       if (save.length > 0) {
         const briefFile = flag("brief-file");
-        const brief = briefFile.length > 0 ? await readFile24(path37.resolve(briefFile), "utf8") : flag("brief");
+        const brief = briefFile.length > 0 ? await readFile24(path38.resolve(briefFile), "utf8") : flag("brief");
         if (brief.trim().length === 0) {
           failValidation4("--brief-file (preferred) or --brief is required: the brief is the recipe.");
         }
@@ -47744,7 +47816,7 @@ function parseImageRefs(spec) {
 }
 var defaultDeps = {
   ingest: (url) => apiPost("/api/images/ingest", { url, source: "uploaded" }),
-  upload: (path39) => uploadLocalImage({ file: path39, contentType: detectImageContentType(path39), source: "uploaded" })
+  upload: (path40) => uploadLocalImage({ file: path40, contentType: detectImageContentType(path40), source: "uploaded" })
 };
 async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
   const refs = parseImageRefs(spec);
@@ -47764,10 +47836,10 @@ async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
   }
   return { imageIds, added };
 }
-function uploadFailure(path39) {
+function uploadFailure(path40) {
   return (error) => {
     if (error instanceof ApiError) throw error;
-    throw new ApiError("VALIDATION_ERROR", `Could not read "${path39}" as an image.`);
+    throw new ApiError("VALIDATION_ERROR", `Could not read "${path40}" as an image.`);
   };
 }
 
@@ -48829,10 +48901,10 @@ async function stageOp4(op) {
     handleError5(err);
   }
 }
-async function draftAction3(path39, body, chat) {
+async function draftAction3(path40, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path39, { chatId, ...body });
+    const data = await apiPost(path40, { chatId, ...body });
     writeJsonEnvelope({ ok: true, data });
     return data;
   } catch (err) {
@@ -49939,7 +50011,7 @@ var groupCommand2 = defineCommand209({
 // src/commands/videos/ingest.ts
 import { mkdtemp as mkdtemp2, rm as rm7, stat as stat7 } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
-import path38 from "path";
+import path39 from "path";
 import { defineCommand as defineCommand210 } from "citty";
 
 // src/lib/streamUpload.ts
@@ -50290,7 +50362,7 @@ function ingestUrl(args) {
 }
 async function downloadThenIngest(args, country) {
   const vimeoCookie = captureVimeoCookie();
-  const workDir = await mkdtemp2(path38.join(tmpdir3(), "videos-ingest-"));
+  const workDir = await mkdtemp2(path39.join(tmpdir3(), "videos-ingest-"));
   try {
     const probe = await probeYtDlp({ url: args.url, country, vimeoCookie, cookieDir: workDir });
     if (isAudioOnly(probe.info)) {
@@ -51910,7 +51982,7 @@ function unknownFlagEnvelope(unknown, commandPath, suggestion) {
   };
 }
 function commandPathOf(root, argv) {
-  const path39 = [];
+  const path40 = [];
   let command = root;
   for (const token of argv) {
     if (token === "--" || token.startsWith("-")) {
@@ -51921,10 +51993,10 @@ function commandPathOf(root, argv) {
     if (next === void 0 || typeof next !== "object") {
       break;
     }
-    path39.push(token);
+    path40.push(token);
     command = next;
   }
-  return path39.join(" ");
+  return path40.join(" ");
 }
 function refuseUnknownFlags(root, argv) {
   const unknown = findUnknownFlags(root, argv);