@koda-sl/baker-cli 0.361.0-dev.a5e33d211 → 0.361.0-dev.d766dc120

package/README.md

@@ -110,6 +110,18 @@ question — and nothing in the output said so. Both spellings of an option work
 that lists every option: `baker schema <command>` (`check_schema`) when the command
 registers a schema, `baker <command> --help` (`check_help`) when it does not.
 
+### Narrowing a result: `--fields`
+
+`--fields a,b,c` works on every command that prints the JSON envelope. It keeps only
+those keys of each record in `data` — the rows when `data` is a list or wraps one
+(`baker chats list --fields id,title`), `data` itself when it is a single record
+(`baker experiment plan ... --fields traffic,warning`). `meta`, `hints` and warnings are
+kept, and a name no record carries is reported in `hints` alongside the keys that do
+exist. Commands that declare `--fields` themselves keep their own meaning
+(`ads meta insights` chooses which metrics to request; `ads linkedin creatives` takes dotted
+paths). A command whose default output is text needs `--output json` for there to be an
+envelope to narrow; without it a note on stderr says the flag changed nothing.
+
 ### Fresh reads: `--no-cache`
 
 Every command that caches takes `--no-cache`, and it skips **both** cache layers — the
@@ -5420,7 +5432,7 @@ Validate, then execute the graph. Blocks until done. Logs one line per node. Ret
 
 **Run history streams live.** The run posts its plan (every node + its dependency edges) the moment validation passes, then re-posts a progress snapshot as each node starts and settles — the dashboard's creative workflow graph shows nodes flipping pending → running → done in real time, with each node's outputs attached as they land. A failed run keeps its per-node trail (what completed, what died). All best-effort: an unreachable backend never changes the run's outcome.
 
-**Failures don't abandon sibling work.** Nodes in a layer run under the concurrency cap and every one **settles** — a failed clip no longer kills its in-flight siblings, whose finished results still land in the content-addressed cache. One failure re-throws as-is; several are reported together (each failed node named). Re-running `baker canvas run` resumes from the cache and re-executes **only** the failed nodes and their descendants — never hand-orchestrate per-node renders. **One render per canvas at a time:** a `run` of a canvas that another live process in the same workspace is still rendering (a backgrounded render, or a subagent's) is refused with `CONFLICT` instead of sharing its run — wait for it and use its result. Long `video_generate` clips execute as **backend jobs** (the CLI polls; a CDN/proxy timeout can no longer kill a generation mid-flight).
+**Failures don't abandon sibling work.** Nodes in a layer run under the concurrency cap and every one **settles** — a failed clip no longer kills its in-flight siblings, whose finished results still land in the content-addressed cache. One failure re-throws as-is; several are reported together (each failed node named). Re-running `baker canvas run` resumes from the cache and re-executes **only** the failed nodes and their descendants — never hand-orchestrate per-node renders. Long `video_generate` clips execute as **backend jobs** (the CLI polls; a CDN/proxy timeout can no longer kill a generation mid-flight).
 
 #### `baker canvas scaffold-video <video> [flags]`
 

package/dist/cli.js

@@ -40880,7 +40880,6 @@ async function clearCreativeDirty(slug, base) {
 }
 
 // src/commands/canvas/run-resume.ts
-import { readFileSync as readFileSync14 } from "fs";
 import { mkdir as mkdir4, readFile as readFile9, rm as rm4, writeFile as writeFile6 } from "fs/promises";
 import path13 from "path";
 function markerKey(canvasPath) {
@@ -40903,12 +40902,9 @@ function classifyRemoteRun(run, now) {
 }
 async function resolveRunId(opts) {
   if (opts.explicitRunId) return { runId: opts.explicitRunId, resumed: false };
-  const existing = await readMarker(opts.outputsDir, opts.canvasPath);
-  if (existing?.pid !== void 0 && existing.pid !== process.pid && (opts.isRendering ?? isRenderProcess)(existing.pid)) {
-    return { runId: existing.runId, resumed: false, rendering: { runId: existing.runId, pid: existing.pid } };
-  }
   if (!opts.fresh) {
-    if (existing) return { runId: existing.runId, resumed: true, source: "local" };
+    const existing = await readMarkerRunId(opts.outputsDir, opts.canvasPath);
+    if (existing) return { runId: existing, resumed: true, source: "local" };
     if (opts.remote) {
       try {
         const active = await opts.remote.getActiveRun(opts.remote.creativeSlug, opts.remote.canvasSha);
@@ -40928,31 +40924,22 @@ async function resolveRunId(opts) {
   }
   return { runId: `r_${ulid()}`, resumed: false };
 }
-async function readMarker(outputsDir, canvasPath) {
+async function readMarkerRunId(outputsDir, canvasPath) {
   for (const key of [markerKey(canvasPath), legacyMarkerKey(canvasPath)]) {
     try {
       const raw = await readFile9(markerFile(outputsDir, key), "utf8");
       const parsed = JSON.parse(raw);
-      if (typeof parsed.runId === "string" && parsed.runId.length > 0) {
-        return { runId: parsed.runId, ...Number.isInteger(parsed.pid) ? { pid: parsed.pid } : {} };
-      }
+      if (typeof parsed.runId === "string" && parsed.runId.length > 0) return parsed.runId;
     } catch {
     }
   }
   return null;
 }
-function isRenderProcess(pid) {
-  try {
-    return readFileSync14(`/proc/${pid}/cmdline`, "utf8").includes("canvas");
-  } catch {
-    return false;
-  }
-}
 async function markRunInFlight(outputsDir, canvasPath, runId) {
   try {
     const file = markerFile(outputsDir, markerKey(canvasPath));
     await mkdir4(path13.dirname(file), { recursive: true });
-    await writeFile6(file, JSON.stringify({ runId, pid: process.pid, canvasPath: path13.resolve(canvasPath), startedAt: Date.now() }));
+    await writeFile6(file, JSON.stringify({ runId, canvasPath: path13.resolve(canvasPath), startedAt: Date.now() }));
   } catch {
   }
 }
@@ -41910,31 +41897,13 @@ ${describeRewrites(healed.rewrites)}
   const creativeSlug = creativeSlugFromCanvasPath(filePath) ?? void 0;
   const client = opts.record === false ? null : buildBackendClient();
   const outputsDir = opts.outputsDir ? path16.resolve(opts.outputsDir) : path16.resolve("canvas");
-  const { runId, resumed, source, concurrentRunId, rendering } = await resolveRunId({
+  const { runId, resumed, source, concurrentRunId } = await resolveRunId({
     explicitRunId: opts.runId,
     fresh: opts.fresh === true,
     outputsDir,
     canvasPath: filePath,
     remote: client && creativeSlug ? { creativeSlug, canvasSha, getActiveRun: (slug, sha) => client.getActiveRun(slug, sha) } : void 0
   });
-  if (rendering) {
-    process.stderr.write(
-      `${JSON.stringify(
-        {
-          ok: false,
-          error: {
-            code: "CONFLICT",
-            message: `This canvas is already rendering in another process (run ${rendering.runId}, pid ${rendering.pid}).`,
-            fix: "Wait for that render to finish and use its result instead of starting a second one: two renders of one canvas share a run and overwrite each other. If you started it in the background, read its output when it completes."
-          }
-        },
-        null,
-        2
-      )}
-`
-    );
-    process.exit(2);
-  }
   if (resumed) {
     process.stdout.write(
       `[resume] continuing interrupted run ${runId}${source === "remote" ? " (adopted from run history)" : ""} \u2014 in-flight jobs re-attach, cached nodes skip
@@ -42872,12 +42841,12 @@ function fail3(code, message) {
   process.exit(2);
 }
 function resolveModels(args5) {
-  const pick = (flag, kind, fallback) => args5[flag] ? String(args5[flag]) : resolveModel(kind, fallback);
+  const pick2 = (flag, kind, fallback) => args5[flag] ? String(args5[flag]) : resolveModel(kind, fallback);
   return {
-    describeModel: pick("describe-model", "image_describe", "~google/gemini-pro-latest"),
-    selectModel: pick("select-model", "text_generate", "~google/gemini-flash-latest"),
-    layoutModel: pick("layout-model", "text_generate", "~google/gemini-flash-latest"),
-    genModel: pick("gen-model", "image_generate", "openai/gpt-image-2")
+    describeModel: pick2("describe-model", "image_describe", "~google/gemini-pro-latest"),
+    selectModel: pick2("select-model", "text_generate", "~google/gemini-flash-latest"),
+    layoutModel: pick2("layout-model", "text_generate", "~google/gemini-flash-latest"),
+    genModel: pick2("gen-model", "image_generate", "openai/gpt-image-2")
   };
 }
 var PLATFORM_PLACEMENTS = {
@@ -44897,18 +44866,18 @@ function parseBudget(raw) {
   throw new Error(`--budget must be one of ${VIDEO_BUDGETS.join(", ")} (got "${v}")`);
 }
 function resolveModels2(args5) {
-  const pick = (flag, kind, fallback) => args5[flag] ? String(args5[flag]) : resolveModel2(kind, fallback);
+  const pick2 = (flag, kind, fallback) => args5[flag] ? String(args5[flag]) : resolveModel2(kind, fallback);
   return {
     // Flash by default: ~2-3× faster per call than Pro, which keeps each
     // per-scene deconstruct step well inside the action time budget and turns a
     // ~9 min run into ~3-4 min. Override with --deconstruct-model
     // ~google/gemini-pro-latest for the densest extraction when speed matters less.
-    deconstructModel: pick("deconstruct-model", "video_deconstruct", "~google/gemini-flash-latest"),
-    selectModel: pick("select-model", "text_generate", "~google/gemini-flash-latest"),
+    deconstructModel: pick2("deconstruct-model", "video_deconstruct", "~google/gemini-flash-latest"),
+    selectModel: pick2("select-model", "text_generate", "~google/gemini-flash-latest"),
     // Default to the strongest image model (matches the static-ad scaffold); the
     // frame generators need the most faithful text/identity reproduction. Override
     // with --image-model for a cheaper/faster pass.
-    imageModel: pick("image-model", "image_generate", "openai/gpt-image-2.5-sunburst")
+    imageModel: pick2("image-model", "image_generate", "openai/gpt-image-2.5-sunburst")
   };
 }
 function hasPhotorealCast(elements) {
@@ -48288,11 +48257,11 @@ var addSideEffectCommand = defineCommand125({
 });
 
 // src/commands/flows/map.ts
-import { readFileSync as readFileSync16 } from "fs";
+import { readFileSync as readFileSync15 } from "fs";
 import { defineCommand as defineCommand126 } from "citty";
 
 // src/commands/flows/value-expression.ts
-import { existsSync as existsSync6, readFileSync as readFileSync15 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync14 } from "fs";
 import { join as join4 } from "path";
 var PREFIXES2 = ["field", "tracking", "global", "code"];
 function splitParts(raw) {
@@ -48379,7 +48348,7 @@ function trackingFieldIds() {
   const path48 = join4(flowsDir(), "..", "tracking.ts");
   if (!existsSync6(path48)) return null;
   try {
-    const source = readFileSync15(path48, "utf-8");
+    const source = readFileSync14(path48, "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]);
@@ -48956,7 +48925,7 @@ function specsFromFile(parsed) {
 function readSpecFile(path48) {
   let raw;
   try {
-    raw = path48 === "-" ? readFileSync16(0, "utf-8") : readFileSync16(path48, "utf-8");
+    raw = path48 === "-" ? readFileSync15(0, "utf-8") : readFileSync15(path48, "utf-8");
   } catch (error) {
     refuse(
       `Could not read ${path48 === "-" ? "the mapping from stdin" : `"${path48}"`}: ${error instanceof Error ? error.message : String(error)}`
@@ -49655,7 +49624,7 @@ Full guide: __tooling__/docs/tools/baker/flows.md`
 });
 
 // src/commands/funnel/index.ts
-import { readFileSync as readFileSync17 } from "fs";
+import { readFileSync as readFileSync16 } from "fs";
 import { defineCommand as defineCommand130 } from "citty";
 
 // src/commands/funnel/formMoments.ts
@@ -50451,7 +50420,7 @@ function workspaceForms() {
   const forms = [];
   for (const slug of listFlowSlugs()) {
     try {
-      forms.push({ slug, tree: JSON.parse(readFileSync17(flowDataPath(slug), "utf-8")) });
+      forms.push({ slug, tree: JSON.parse(readFileSync16(flowDataPath(slug), "utf-8")) });
     } catch {
     }
   }
@@ -50586,7 +50555,7 @@ Examples:
 import { defineCommand as defineCommand132 } from "citty";
 
 // src/commands/ga4/shared.ts
-import { readFileSync as readFileSync18 } from "fs";
+import { readFileSync as readFileSync17 } from "fs";
 function failValidation3(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
@@ -50602,7 +50571,7 @@ function requireTarget5(args5, entity) {
 function readJsonSource(args5, flag) {
   const inline = args5[flag];
   const file = args5.file;
-  const raw = typeof file === "string" && file.length > 0 ? readFileSync18(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
+  const raw = typeof file === "string" && file.length > 0 ? readFileSync17(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
   if (raw === void 0) {
     failValidation3(`pass --${flag} with inline JSON or --file with a path to a JSON file`);
   }
@@ -50953,7 +50922,7 @@ Examples:
 });
 
 // src/commands/ga4/query.ts
-import { appendFileSync as appendFileSync2, existsSync as existsSync7, readFileSync as readFileSync19, writeFileSync as writeFileSync4 } from "fs";
+import { appendFileSync as appendFileSync2, existsSync as existsSync7, readFileSync as readFileSync18, writeFileSync as writeFileSync4 } from "fs";
 import { resolve as resolve2 } from "path";
 import { defineCommand as defineCommand135 } from "citty";
 
@@ -51044,7 +51013,7 @@ function writeRowsToFile2(filePath, rows, append) {
       writeFileSync4(filePath, content, "utf-8");
     }
   } else if (append && existsSync7(filePath)) {
-    const existing = JSON.parse(readFileSync19(filePath, "utf-8"));
+    const existing = JSON.parse(readFileSync18(filePath, "utf-8"));
     writeFileSync4(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
   } else {
     writeFileSync4(filePath, JSON.stringify(rows, null, 2), "utf-8");
@@ -51896,7 +51865,7 @@ Full guide: __tooling__/docs/tools/baker/ga4.md`
 import { defineCommand as defineCommand141 } from "citty";
 
 // src/commands/gsc/query.ts
-import { appendFileSync as appendFileSync3, existsSync as existsSync8, readFileSync as readFileSync20, writeFileSync as writeFileSync5 } from "fs";
+import { appendFileSync as appendFileSync3, existsSync as existsSync8, readFileSync as readFileSync19, writeFileSync as writeFileSync5 } from "fs";
 import { resolve as resolve3 } from "path";
 import { defineCommand as defineCommand138 } from "citty";
 
@@ -52044,7 +52013,7 @@ function writeRowsToFile3(filePath, rows, append) {
       writeFileSync5(filePath, content, "utf-8");
     }
   } else if (append && existsSync8(filePath)) {
-    const existing = JSON.parse(readFileSync20(filePath, "utf-8"));
+    const existing = JSON.parse(readFileSync19(filePath, "utf-8"));
     writeFileSync5(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
   } else {
     writeFileSync5(filePath, JSON.stringify(rows, null, 2), "utf-8");
@@ -65678,7 +65647,7 @@ import { defineCommand as defineCommand221 } from "citty";
 import { defineCommand as defineCommand218 } from "citty";
 
 // src/commands/tag-manager/shared.ts
-import { readFileSync as readFileSync21 } from "fs";
+import { readFileSync as readFileSync20 } from "fs";
 function failValidation5(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
@@ -65694,7 +65663,7 @@ function requireTarget6(args5, entity) {
 function loadJsonArg2(args5, flag = "json") {
   const inline = args5[flag];
   const file = args5.file;
-  const raw = typeof file === "string" && file.length > 0 ? readFileSync21(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
+  const raw = typeof file === "string" && file.length > 0 ? readFileSync20(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
   if (raw === void 0) {
     failValidation5(`pass --${flag} with inline JSON or --file with a path to a JSON file`);
   }
@@ -69096,8 +69065,136 @@ function outputFlagForCommand(root, argv) {
   });
 }
 
+// src/field-mask.ts
+var FLAG2 = "--fields";
+function parseFields(value) {
+  return value.split(",").map((field) => field.trim()).filter((field) => field.length > 0);
+}
+function takeFieldsFlag(root, argv) {
+  const end = argv.indexOf("--");
+  const limit = end === -1 ? argv.length : end;
+  const taken = /* @__PURE__ */ new Set();
+  const fields = [];
+  for (let index = 0; index < limit; index++) {
+    const token = argv[index] ?? "";
+    if (token.startsWith(`${FLAG2}=`)) {
+      taken.add(index);
+      fields.push(...parseFields(token.slice(FLAG2.length + 1)));
+    } else if (token === FLAG2) {
+      const value = argv[index + 1];
+      if (value === void 0 || index + 1 >= limit || value.startsWith("-")) {
+        return { argv, fields: null };
+      }
+      taken.add(index).add(index + 1);
+      fields.push(...parseFields(value));
+      index++;
+    }
+  }
+  if (taken.size === 0 || fields.length === 0) {
+    return { argv, fields: null };
+  }
+  const command = commandFor(root, argv);
+  if (!command || declaredArg(command, "fields") || PRINTS_NO_ENVELOPE.has(commandPathOf(root, argv))) {
+    return { argv, fields: null };
+  }
+  return { argv: argv.filter((_, index) => !taken.has(index)), fields };
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pick(record, fields) {
+  return Object.fromEntries(fields.filter((field) => field in record).map((field) => [field, record[field]]));
+}
+function wrappedList(data, fields) {
+  if (fields.some((field) => field in data)) {
+    return null;
+  }
+  const lists = Object.entries(data).filter(
+    ([, value]) => Array.isArray(value) && value.every((item) => isRecord3(item))
+  );
+  return lists.length === 1 ? lists[0]?.[0] ?? null : null;
+}
+function recordsOf(data, fields) {
+  if (Array.isArray(data)) {
+    return data;
+  }
+  if (!isRecord3(data)) {
+    return [];
+  }
+  const list = wrappedList(data, fields);
+  return list === null ? [data] : data[list];
+}
+function maskData(data, fields) {
+  const mask = (item) => isRecord3(item) ? pick(item, fields) : item;
+  if (Array.isArray(data)) {
+    return data.map(mask);
+  }
+  if (!isRecord3(data)) {
+    return data;
+  }
+  const list = wrappedList(data, fields);
+  return list === null ? pick(data, fields) : { ...data, [list]: recordsOf(data, fields).map(mask) };
+}
+function unmatchedHint(data, fields) {
+  const records = recordsOf(data, fields).filter(isRecord3);
+  if (records.length === 0) {
+    return null;
+  }
+  const carried = new Set(records.flatMap((record) => Object.keys(record)));
+  const unmatched = fields.filter((field) => !carried.has(field));
+  if (unmatched.length === 0) {
+    return null;
+  }
+  return `--fields matched nothing for: ${unmatched.join(", ")}. The keys data carries are: ${[...carried].join(", ")}.`;
+}
+function maskPrintedEnvelope(text2, fields) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text2);
+  } catch {
+    return null;
+  }
+  if (!isRecord3(parsed) || typeof parsed.ok !== "boolean") {
+    return null;
+  }
+  if (parsed.ok !== true || !("data" in parsed) || "dryRun" in parsed) {
+    return text2;
+  }
+  const masked = { ...parsed, data: maskData(parsed.data, fields) };
+  const miss = unmatchedHint(parsed.data, fields);
+  if (miss) {
+    masked.hints = [...Array.isArray(parsed.hints) ? parsed.hints : [], miss];
+  }
+  const indent = text2.trimStart().startsWith("{\n") ? 2 : void 0;
+  return `${JSON.stringify(masked, null, indent)}${text2.endsWith("\n") ? "\n" : ""}`;
+}
+function maskWrites(stream, fields) {
+  let applied = false;
+  const write = stream.write.bind(stream);
+  stream.write = (chunk, ...rest) => {
+    const masked = typeof chunk === "string" ? maskPrintedEnvelope(chunk, fields) : null;
+    if (masked === null) {
+      return write(chunk, ...rest);
+    }
+    applied = true;
+    return write(masked, ...rest);
+  };
+  return { sawEnvelope: () => applied };
+}
+function installFieldMask(fields, commandPath) {
+  const mask = maskWrites(process.stdout, fields);
+  process.on("exit", () => {
+    if (!mask.sawEnvelope()) {
+      process.stderr.write(
+        `--fields was not applied: \`baker ${commandPath}\` printed no JSON envelope to narrow. Add --output json to get the envelope, or drop --fields.
+`
+      );
+    }
+  });
+}
+
 // src/version.ts
-import { readFileSync as readFileSync22 } from "fs";
+import { readFileSync as readFileSync21 } from "fs";
 function packageJsonUrl() {
   return new URL("../package.json", import.meta.url);
 }
@@ -69109,7 +69206,7 @@ function parsePackageVersion(raw) {
   throw new Error("Invalid CLI package.json: missing version");
 }
 function getCliVersion() {
-  return parsePackageVersion(readFileSync22(packageJsonUrl(), "utf8"));
+  return parsePackageVersion(readFileSync21(packageJsonUrl(), "utf8"));
 }
 
 // src/cli.ts
@@ -69122,6 +69219,7 @@ var main = defineCommand248({
 Auth: Set BAKER_API_KEY (starts with bk_) and BAKER_API_URL environment variables.
 Chat: Set BAKER_CHAT_ID for action and scheduled-agent commands that stage changes against a chat.
 Output: All commands return JSON envelopes: { ok: true, data: ... } or { ok: false, error: { code, message } }.
+Fields: --fields a,b,c keeps only those keys of each record in data, on every command that prints the envelope.
 Formats: --output json works on every command that prints the envelope. --output md|files only where 'baker schema <command>' lists output. (The research commands additionally accept csv and jsonl.)
 Introspection: Run 'baker schema <command>' to inspect argument schemas.`
   },
@@ -69161,6 +69259,11 @@ installStreamTaps();
 logInvocation(process.argv.slice(2));
 installExitRecord();
 process.argv = [...process.argv.slice(0, 2), ...outputFlagForCommand(main, process.argv.slice(2))];
+var fieldsFlag = takeFieldsFlag(main, process.argv.slice(2));
+if (fieldsFlag.fields) {
+  process.argv = [...process.argv.slice(0, 2), ...fieldsFlag.argv];
+  installFieldMask(fieldsFlag.fields, commandPathOf(main, fieldsFlag.argv));
+}
 refuseUnknownFlags(main, process.argv.slice(2));
 process.argv = [...process.argv.slice(0, 2), ...cacheFlagForParser(process.argv.slice(2))];
 runMain(main);