@koda-sl/baker-cli 0.115.0 → 0.116.0-dev.3bcc79f9c

package/dist/cli.js

@@ -1,18 +1,24 @@
 #!/usr/bin/env node
 import {
+  BackendClient,
   ELEVENLABS_MAX_MUSIC_LENGTH_MS,
   IMAGE_GENERATE_MODELS,
   LayerExecutionError,
   MODEL_REGISTRY,
   SEEDANCE_DURATIONS,
   ValidationError,
+  collectAssetRefLikes,
   createEngineFromEnv,
   defaultRegistry,
   describeFailureReason,
   generateCatalog,
+  isPersistedAssetRef,
+  requireCredentialsFromEnv,
   resolveConcurrency,
+  sha256Hex,
+  ulid,
   validateCanvasDeep
-} from "./chunk-ZWMMCLJ4.js";
+} from "./chunk-OCMOQOIJ.js";
 
 // src/cli.ts
 import { defineCommand as defineCommand157, runMain } from "citty";
@@ -151,9 +157,9 @@ async function handleResponse(response) {
     throw new ApiError("INTERNAL_ERROR", "Failed to parse API response as JSON");
   }
 }
-async function apiGet(path12, params) {
+async function apiGet(path13, params) {
   const env = getEnv();
-  const url = new URL(path12, env.BAKER_API_URL);
+  const url = new URL(path13, env.BAKER_API_URL);
   if (params) {
     const clean = sanitizeParams(params);
     for (const [key, value] of Object.entries(clean)) {
@@ -178,12 +184,12 @@ async function apiGet(path12, params) {
   }
   return handleResponse(response);
 }
-async function apiPost(path12, body, opts) {
+async function apiPost(path13, body, opts) {
   const env = getEnv();
   const timeoutMs = opts?.timeoutMs ?? 6e4;
   let response;
   try {
-    response = await fetchWithRateLimitRetry(new URL(path12, env.BAKER_API_URL).toString(), {
+    response = await fetchWithRateLimitRetry(new URL(path13, env.BAKER_API_URL).toString(), {
       method: "POST",
       headers: {
         Authorization: `Bearer ${env.BAKER_API_KEY}`,
@@ -2875,31 +2881,31 @@ function cachePath(category, key) {
   return join2(dir, `${hashKey(key)}.json`);
 }
 function cacheGet(category, key) {
-  const path12 = cachePath(category, key);
-  if (!existsSync2(path12)) {
+  const path13 = cachePath(category, key);
+  if (!existsSync2(path13)) {
     return null;
   }
   try {
-    const raw = readFileSync2(path12, "utf-8");
+    const raw = readFileSync2(path13, "utf-8");
     const entry = JSON.parse(raw);
     if (entry.expiresAt < Date.now()) {
-      rmSync(path12, { force: true });
+      rmSync(path13, { force: true });
       return null;
     }
     return entry;
   } catch {
-    rmSync(path12, { force: true });
+    rmSync(path13, { force: true });
     return null;
   }
 }
 function cacheSet(category, key, data, ttlMs, fields) {
-  const path12 = cachePath(category, key);
+  const path13 = cachePath(category, key);
   const entry = {
     expiresAt: Date.now() + ttlMs,
     data,
     fields
   };
-  writeFileSync(path12, JSON.stringify(entry), "utf-8");
+  writeFileSync(path13, JSON.stringify(entry), "utf-8");
 }
 var HOUR = 60 * 60 * 1e3;
 var MINUTE = 60 * 1e3;
@@ -4812,11 +4818,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(path12) {
-  if (typeof path12 !== "string" || path12.length === 0) {
+function rawFileEntries(path13) {
+  if (typeof path13 !== "string" || path13.length === 0) {
     return [];
   }
-  return readFileSync3(path12, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  return readFileSync3(path13, "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;
@@ -4839,19 +4845,19 @@ function keywordEntries(args) {
   }
   return entries;
 }
-function loadJsonFileArg(path12) {
-  if (typeof path12 !== "string" || path12.length === 0) {
+function loadJsonFileArg(path13) {
+  if (typeof path13 !== "string" || path13.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync3(path12, "utf8"));
+    const parsed = JSON.parse(readFileSync3(path13, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation(`${path12} must contain a JSON object`);
+      failWriteValidation(`${path13} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation(`${path12} is not valid JSON: ${err.message}`);
+      failWriteValidation(`${path13} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -4940,10 +4946,10 @@ async function stageUpdate(kind, customerId, target, payload) {
 async function stageTarget(kind, customerId, target) {
   await stageGoogleOp({ kind, customerId, target });
 }
-async function draftAction(path12, body) {
+async function draftAction(path13, body) {
   try {
     const chatId = requireChatId();
-    const response = await apiPost(path12, { chatId, ...body });
+    const response = await apiPost(path13, { chatId, ...body });
     writeJsonEnvelope(response);
   } catch (err) {
     handleGoogleError(err);
@@ -8484,19 +8490,19 @@ function failWriteValidation2(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg2(path12) {
-  if (typeof path12 !== "string" || path12.length === 0) {
+function loadJsonFileArg2(path13) {
+  if (typeof path13 !== "string" || path13.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync7(path12, "utf8"));
+    const parsed = JSON.parse(readFileSync7(path13, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation2(`${path12} must contain a JSON object`);
+      failWriteValidation2(`${path13} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation2(`${path12} is not valid JSON: ${err.message}`);
+      failWriteValidation2(`${path13} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -8559,15 +8565,15 @@ function parseLocaleFlag(value) {
   }
   return { language: match[1], country: match[2].toUpperCase() };
 }
-function loadTargetingFileArg(path12) {
-  if (typeof path12 !== "string" || path12.length === 0) {
+function loadTargetingFileArg(path13) {
+  if (typeof path13 !== "string" || path13.length === 0) {
     return void 0;
   }
-  const parsed = loadJsonFileArg2(path12);
+  const parsed = loadJsonFileArg2(path13);
   const criteria = parsed.targetingCriteria ?? parsed;
   if (!criteria.include) {
     failWriteValidation2(
-      `${path12} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
+      `${path13} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
     );
   }
   return criteria;
@@ -8602,14 +8608,14 @@ function parseCsvLine(line) {
   cells.push(current);
   return cells.map((cell) => cell.trim());
 }
-function parseListFileArg(path12, maxRows) {
-  if (typeof path12 !== "string" || path12.length === 0) {
+function parseListFileArg(path13, maxRows) {
+  if (typeof path13 !== "string" || path13.length === 0) {
     return void 0;
   }
-  const raw = readFileSync7(path12, "utf8");
+  const raw = readFileSync7(path13, "utf8");
   const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
   if (lines.length < 2) {
-    failWriteValidation2(`${path12} needs a header row and at least one data row`);
+    failWriteValidation2(`${path13} needs a header row and at least one data row`);
   }
   const columns = parseCsvLine(lines[0]).map((column) => column.trim());
   const rows = [];
@@ -8628,7 +8634,7 @@ function parseListFileArg(path12, maxRows) {
     }
   }
   if (rows.length > maxRows) {
-    failWriteValidation2(`${path12} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
+    failWriteValidation2(`${path13} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
   }
   return { columns, rows };
 }
@@ -12831,7 +12837,7 @@ async function probeDuration(filePath) {
 
 // src/commands/canvas/run.ts
 import { readFile as readFile2 } from "fs/promises";
-import path4 from "path";
+import path5 from "path";
 import { defineCommand as defineCommand85 } from "citty";
 
 // src/commands/canvas/placeholders.ts
@@ -12875,9 +12881,102 @@ function isResolvableRelative(value) {
   return typeof value === "string" && value.length > 0 && !value.includes("[TODO") && !path2.isAbsolute(value);
 }
 
+// src/commands/canvas/run-record.ts
+import path3 from "path";
+var MAX_RUN_NODES = 200;
+var MAX_OUTPUTS_PER_NODE = 10;
+var MAX_FINAL_OUTPUTS = 10;
+var MAX_CREATIVE_SLUG_LENGTH = 100;
+function creativeSlugFromCanvasPath(filePath) {
+  const normalized = filePath.split(path3.sep).join("/");
+  const match = normalized.match(/(?:^|\/)src\/creatives\/([a-z0-9](?:[a-z0-9-]*[a-z0-9])?)\//);
+  const slug = match?.[1] ?? null;
+  return slug && slug.length <= MAX_CREATIVE_SLUG_LENGTH ? slug : null;
+}
+var OUTPUT_KINDS = /* @__PURE__ */ new Set(["image", "video", "audio", "json", "text", "font"]);
+function toRecordOutput(slot, value) {
+  const refs = collectAssetRefLikes(value);
+  const ref = refs.length === 1 ? refs[0] : null;
+  if (!ref || !isPersistedAssetRef(ref)) return null;
+  const kind = typeof ref.kind === "string" && OUTPUT_KINDS.has(ref.kind) ? ref.kind : null;
+  if (!kind) return null;
+  return {
+    slot,
+    kind,
+    sha256: ref.sha256,
+    url: ref.url,
+    mime: ref.mime,
+    width: typeof ref.width === "number" ? ref.width : void 0,
+    height: typeof ref.height === "number" ? ref.height : void 0,
+    durationMs: typeof ref.duration_ms === "number" ? ref.duration_ms : void 0
+  };
+}
+function nodeOutputsToRecord(nodeOutputs) {
+  const out = [];
+  for (const [slot, value] of Object.entries(nodeOutputs)) {
+    if (Array.isArray(value)) {
+      value.forEach((item, i) => {
+        const rec = toRecordOutput(`${slot}#${i}`, item);
+        if (rec) out.push(rec);
+      });
+    } else {
+      const rec = toRecordOutput(slot, value);
+      if (rec) out.push(rec);
+    }
+  }
+  return out.slice(0, MAX_OUTPUTS_PER_NODE);
+}
+function finalOutputsToRecord(output) {
+  if (Array.isArray(output)) {
+    return output.map((item, i) => toRecordOutput(`final#${i}`, item)).filter((rec2) => rec2 !== null).slice(0, MAX_FINAL_OUTPUTS);
+  }
+  const rec = toRecordOutput("final", output);
+  return rec ? [rec] : [];
+}
+function buildRunRecord(result, meta) {
+  const nodes = result.node_runs.slice(0, MAX_RUN_NODES).map((run) => ({
+    nodeId: run.node_id,
+    nodeType: run.node_type,
+    cached: run.cached,
+    credits: run.credits,
+    durationMs: run.duration_ms,
+    outputs: nodeOutputsToRecord(result.outputs_by_node[run.node_id] ?? {})
+  }));
+  const finalOutputs = finalOutputsToRecord(result.output);
+  return {
+    runId: result.run_id,
+    creativeSlug: meta.creativeSlug,
+    canvasPath: meta.canvasPath,
+    canvasSha: meta.canvasSha,
+    chatId: meta.chatId,
+    status: "completed",
+    stats: {
+      totalNodes: result.stats.total_nodes,
+      cachedNodes: result.stats.cached_nodes,
+      totalCredits: result.stats.total_credits,
+      durationMs: result.stats.duration_ms
+    },
+    nodes,
+    finalOutputs: finalOutputs.length > 0 ? finalOutputs : void 0
+  };
+}
+function buildFailedRunRecord(runId, errorMessage, meta) {
+  return {
+    runId,
+    creativeSlug: meta.creativeSlug,
+    canvasPath: meta.canvasPath,
+    canvasSha: meta.canvasSha,
+    chatId: meta.chatId,
+    status: "failed",
+    errorMessage: errorMessage.slice(0, 2e3),
+    stats: { totalNodes: 0, cachedNodes: 0, totalCredits: 0, durationMs: 0 },
+    nodes: []
+  };
+}
+
 // src/commands/canvas/run-retention.ts
 import { rm } from "fs/promises";
-import path3 from "path";
+import path4 from "path";
 function runDirsToPrune(entries, keep, currentRunId) {
   const runs = entries.filter((e) => /^r_[0-9A-Za-z]+$/.test(e) && e !== currentRunId).sort();
   if (keep <= 0) return runs;
@@ -12894,7 +12993,7 @@ async function pruneOldRuns(outputsDir, keep, currentRunId, log) {
   const toPrune = runDirsToPrune(entries, keep, currentRunId);
   if (toPrune.length === 0) return;
   for (const dir of toPrune) {
-    await rm(path3.join(outputsDir, dir), { recursive: true, force: true }).catch(
+    await rm(path4.join(outputsDir, dir), { recursive: true, force: true }).catch(
       (e) => log(`[prune   ] could not remove ${dir}: ${e.message}`)
     );
   }
@@ -12921,10 +13020,22 @@ var runCommand = defineCommand85({
     "keep-runs": {
       type: "string",
       description: "After the run, prune old r_* run dirs, keeping the N newest (off by default)"
+    },
+    "remote-cache": {
+      type: "string",
+      description: "on | off \u2014 company-scoped remote cache + durable asset persistence (default on; env BAKER_CANVAS_REMOTE_CACHE)"
+    },
+    // citty consumes any `--no-<flag>` as a negation of `<flag>`, so the
+    // opt-out spelling `--no-record` requires the flag to be named `record`
+    // (a literal "no-record" arg would never receive a value).
+    record: {
+      type: "boolean",
+      default: true,
+      description: "Post the durable run-history record to Baker (disable with --no-record)"
     }
   },
   async run({ args }) {
-    const filePath = path4.resolve(String(args.file));
+    const filePath = path5.resolve(String(args.file));
     const raw = await readFile2(filePath, "utf8");
     let parsed;
     try {
@@ -12935,7 +13046,7 @@ var runCommand = defineCommand85({
 `);
       process.exit(2);
     }
-    parsed = resolveRelativeCanvasPaths(parsed, path4.dirname(filePath));
+    parsed = resolveRelativeCanvasPaths(parsed, path5.dirname(filePath));
     const pending = unsuppliedPlaceholderAssets(parsed);
     if (pending.length > 0) {
       process.stderr.write(
@@ -12955,16 +13066,26 @@ var runCommand = defineCommand85({
       );
       process.exit(2);
     }
+    const remoteCache = args["remote-cache"] !== void 0 ? String(args["remote-cache"]) !== "off" : void 0;
     const engine = createEngineFromEnv({
       cacheDir: args["cache-dir"] ? String(args["cache-dir"]) : void 0,
       outputsDir: args["outputs-dir"] ? String(args["outputs-dir"]) : void 0,
       log: (line) => process.stdout.write(`${line}
-`)
+`),
+      remoteCache
     });
+    const runId = args["run-id"] ? String(args["run-id"]) : `r_${ulid()}`;
+    const recordMeta = {
+      creativeSlug: creativeSlugFromCanvasPath(filePath) ?? void 0,
+      canvasPath: path5.relative(process.cwd(), filePath) || void 0,
+      canvasSha: sha256Hex(Buffer.from(raw)),
+      chatId: getEnv().BAKER_CHAT_ID || void 0
+    };
+    const record = args.record === false ? null : buildRecorder();
     try {
       const policy = args["cache-policy"] ?? "read_write";
       const result = await engine.run(parsed, {
-        run_id: args["run-id"] ? String(args["run-id"]) : void 0,
+        run_id: runId,
         cache_policy: policy,
         concurrency: resolveConcurrency(
           // --concurrency wins; --parallel is the discoverable alias for the same bound.
@@ -12972,9 +13093,10 @@ var runCommand = defineCommand85({
           process.env.BAKER_CANVAS_CONCURRENCY
         )
       });
+      if (record) await record(buildRunRecord(result, recordMeta));
       const keepRuns = args["keep-runs"] !== void 0 ? Number(args["keep-runs"]) : void 0;
       if (keepRuns !== void 0 && Number.isFinite(keepRuns)) {
-        const outputsDir = args["outputs-dir"] ? path4.resolve(String(args["outputs-dir"])) : path4.resolve("canvas");
+        const outputsDir = args["outputs-dir"] ? path5.resolve(String(args["outputs-dir"])) : path5.resolve("canvas");
         await pruneOldRuns(outputsDir, keepRuns, result.run_id, (line) => process.stdout.write(`${line}
 `));
       }
@@ -13002,6 +13124,7 @@ var runCommand = defineCommand85({
       }
       if (e instanceof LayerExecutionError) {
         const failures = e.failures.map((f) => ({ node_id: f.nodeId, message: describeFailureReason(f.reason) }));
+        if (record) await record(buildFailedRunRecord(runId, e.message, recordMeta));
         process.stderr.write(
           `${JSON.stringify({ ok: false, error: { code: "runtime", message: e.message, failures } }, null, 2)}
 `
@@ -13009,16 +13132,30 @@ var runCommand = defineCommand85({
         process.exit(1);
       }
       const msg = e instanceof Error ? e.message : String(e);
+      if (record) await record(buildFailedRunRecord(runId, msg, recordMeta));
       process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "runtime", message: msg } }, null, 2)}
 `);
       process.exit(1);
     }
   }
 });
+function buildRecorder() {
+  return async (payload) => {
+    try {
+      const creds = requireCredentialsFromEnv();
+      const client = new BackendClient({ baseUrl: creds.url, apiKey: creds.apiKey });
+      await client.recordRun(payload);
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      process.stderr.write(`[warn] run record not persisted (${msg})
+`);
+    }
+  };
+}
 
 // src/commands/canvas/scaffold-static-ad.ts
 import { readFile as readFile3, writeFile } from "fs/promises";
-import path6 from "path";
+import path7 from "path";
 import { defineCommand as defineCommand86 } from "citty";
 
 // src/engine/scaffold/staticAd.ts
@@ -13205,15 +13342,20 @@ function staticAdReport(input, elementsInput, opts) {
 }
 
 // src/commands/canvas/scaffold-static-ad-paths.ts
-import path5 from "path";
-function resolveScaffoldStaticAdPaths(rawFile, out, cwd = process.cwd()) {
+import path6 from "path";
+function resolveScaffoldStaticAdPaths(rawFile, out, cwd = process.cwd(), slug) {
   const file = rawFile.trim();
   const imageIsUrl = /^https?:\/\//i.test(file);
-  const imageSource = imageIsUrl ? file : path5.resolve(cwd, file);
-  const outPath = out ? path5.resolve(cwd, out) : imageIsUrl ? path5.join(cwd, "static-ad.canvas.json") : path5.join(path5.dirname(imageSource), "static-ad.canvas.json");
-  const blueprintPath = path5.join(path5.dirname(outPath), "prompt.json");
+  const imageSource = imageIsUrl ? file : path6.resolve(cwd, file);
+  const outPath = out ? path6.resolve(cwd, out) : slug ? path6.join(cwd, "src", "creatives", slug, `${slug}.canvas.json`) : imageIsUrl ? path6.join(cwd, "static-ad.canvas.json") : path6.join(path6.dirname(imageSource), "static-ad.canvas.json");
+  const blueprintPath = path6.join(path6.dirname(outPath), "prompt.json");
   return { imageIsUrl, imageSource, outPath, blueprintPath };
 }
+var SCAFFOLD_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+var SCAFFOLD_SLUG_MAX_LENGTH = 100;
+function isValidScaffoldSlug(slug) {
+  return slug.length <= SCAFFOLD_SLUG_MAX_LENGTH && SCAFFOLD_SLUG_PATTERN.test(slug);
+}
 
 // src/commands/canvas/scaffold-static-ad.ts
 function resolveModel(kind, preferred) {
@@ -13375,6 +13517,10 @@ var scaffoldStaticAdCommand = defineCommand86({
     file: { type: "positional", required: true, description: "Path or http(s) URL to the source/inspiration image" },
     context: { type: "string", description: "Known provenance (advertiser, category, market) to ground the describe" },
     out: { type: "string", description: "Output canvas path (default <image-dir>/static-ad.canvas.json)" },
+    slug: {
+      type: "string",
+      description: "Creative slug \u2014 writes the canvas to src/creatives/<slug>/<slug>.canvas.json (repo convention)"
+    },
     "describe-model": { type: "string", description: "Override the image_describe model id" },
     "select-model": { type: "string", description: "Override the text_generate model id for element selection" },
     "layout-model": { type: "string", description: "Override the text_generate model id for the layout pass" },
@@ -13383,9 +13529,19 @@ var scaffoldStaticAdCommand = defineCommand86({
     "skip-font": { type: "boolean", description: "Skip the brand-font \u2192 type-specimen slot" }
   },
   async run({ args }) {
+    const slug = args.slug ? String(args.slug) : void 0;
+    if (slug && !isValidScaffoldSlug(slug)) {
+      process.stderr.write(
+        `${JSON.stringify({ ok: false, error: { code: "invalid_slug", message: "--slug must be lowercase kebab (a-z, 0-9, hyphens), max 100 chars" } }, null, 2)}
+`
+      );
+      process.exit(2);
+    }
     const { imageIsUrl, imageSource, outPath, blueprintPath } = resolveScaffoldStaticAdPaths(
       String(args.file),
-      args.out ? String(args.out) : void 0
+      args.out ? String(args.out) : void 0,
+      process.cwd(),
+      slug
     );
     const { describeModel, selectModel, layoutModel, genModel } = resolveModels(args);
     const describeCanvas = buildDescribeCanvas(
@@ -13445,7 +13601,7 @@ var scaffoldStaticAdCommand = defineCommand86({
             run_estimated_credits: validation.estimatedCredits
           },
           checklist: {
-            edit_prompt: `Edit ${path6.basename(blueprintPath)} \u2014 it is the blueprint generated from your image; rewrite it into the ad you want (palette, copy, claims, subjects). It feeds the generator directly.`,
+            edit_prompt: `Edit ${path7.basename(blueprintPath)} \u2014 it is the blueprint generated from your image; rewrite it into the ad you want (palette, copy, claims, subjects). It feeds the generator directly.`,
             assets_to_supply: report.elements,
             font_slot: report.includes_font ? "Drop a brand font at the [TODO] brandfont path, or delete the brandfont + type_ref nodes to skip it." : "skipped (--skip-font)",
             note: "Replace every [TODO] ingest path with a real file, then `baker canvas validate` and `baker canvas run`. Running generates a billed image \u2014 it is not free."
@@ -13461,7 +13617,7 @@ var scaffoldStaticAdCommand = defineCommand86({
 
 // src/commands/canvas/scaffold-video.ts
 import { cp, mkdir, readFile as readFile6, writeFile as writeFile2 } from "fs/promises";
-import path9 from "path";
+import path10 from "path";
 import { defineCommand as defineCommand87 } from "citty";
 
 // src/engine/nodes/local/lib/sceneDetect.ts
@@ -16245,23 +16401,23 @@ function videoReport(input, elementsInput) {
 
 // src/commands/canvas/composition-path.ts
 import { existsSync as existsSync4 } from "fs";
-import path7 from "path";
+import path8 from "path";
 function resolveShippedCanvasDir(name, startDir, exists = existsSync4, maxDepth = 8) {
-  const rel = path7.join("canvas", name);
+  const rel = path8.join("canvas", name);
   let dir = startDir;
   for (let i = 0; i < maxDepth; i++) {
-    const candidate = path7.join(dir, rel);
-    if (exists(path7.join(candidate, "meta.json"))) return candidate;
-    const parent = path7.dirname(dir);
+    const candidate = path8.join(dir, rel);
+    if (exists(path8.join(candidate, "meta.json"))) return candidate;
+    const parent = path8.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return path7.resolve(startDir, "../../../", rel);
+  return path8.resolve(startDir, "../../../", rel);
 }
 
 // src/commands/canvas/gitignore.ts
 import { appendFile, readFile as readFile5 } from "fs/promises";
-import path8 from "path";
+import path9 from "path";
 function missingGitignoreEntries(existing, entries) {
   const present = new Set(
     existing.split("\n").map((l) => l.trim().replace(/\/+$/, "")).filter((l) => l.length > 0 && !l.startsWith("#"))
@@ -16269,7 +16425,7 @@ function missingGitignoreEntries(existing, entries) {
   return entries.filter((e) => !present.has(e.trim().replace(/\/+$/, "")));
 }
 async function ensureGitignore(dir, entries) {
-  const file = path8.join(dir, ".gitignore");
+  const file = path9.join(dir, ".gitignore");
   let existing;
   try {
     existing = await readFile5(file, "utf8");
@@ -16330,7 +16486,7 @@ async function loadTranscriptBestEffort(ref) {
 async function stageCaptions(outDir, transcript) {
   const text = transcript?.trim();
   if (!text || text === "[]") return {};
-  const compositionPath = path9.join(outDir, "tiktok-captions-composition");
+  const compositionPath = path10.join(outDir, "tiktok-captions-composition");
   await cp(SHIPPED_CAPTIONS_DIR, compositionPath, { recursive: true });
   return { compositionPath };
 }
@@ -16348,10 +16504,10 @@ function patchCompositionHtml(html, dims) {
   return html.replace(/(<meta\s+name="viewport"\s+content="width=)\d+(,\s*height=)\d+(")/i, `$1${dims.w}$2${dims.h}$3`).replace(/(width:\s*)\d+(px;\s*height:\s*)\d+(px;)/i, `$1${dims.w}$2${dims.h}$3`).replace(/(data-width=")\d+(")/i, `$1${dims.w}$2`).replace(/(data-height=")\d+(")/i, `$1${dims.h}$2`);
 }
 async function stampCompositionDims(compositionDir, dims) {
-  const metaPath = path9.join(compositionDir, "meta.json");
+  const metaPath = path10.join(compositionDir, "meta.json");
   const rawMeta = await readFile6(metaPath, "utf8");
   await writeFile2(metaPath, patchCompositionMeta(rawMeta, dims), "utf8");
-  const htmlPath = path9.join(compositionDir, "index.html");
+  const htmlPath = path10.join(compositionDir, "index.html");
   const rawHtml = await readFile6(htmlPath, "utf8");
   await writeFile2(htmlPath, patchCompositionHtml(rawHtml, dims), "utf8");
 }
@@ -16491,6 +16647,10 @@ var scaffoldVideoCommand = defineCommand87({
   args: {
     file: { type: "positional", required: true, description: "Path to the reference video" },
     out: { type: "string", description: "Output canvas path (default <video-dir>/<name>.video.canvas.json)" },
+    slug: {
+      type: "string",
+      description: "Creative slug \u2014 writes the canvas to src/creatives/<slug>/<slug>.canvas.json (repo convention)"
+    },
     frames: { type: "string", description: '"generate" (default, anchored regen) or "reuse" (wire real frames in)' },
     ambient: {
       type: "boolean",
@@ -16517,11 +16677,19 @@ var scaffoldVideoCommand = defineCommand87({
     }
   },
   async run({ args }) {
-    const videoPath = path9.resolve(String(args.file));
-    const base = path9.basename(videoPath, path9.extname(videoPath));
-    const outPath = args.out ? path9.resolve(String(args.out)) : path9.join(path9.dirname(videoPath), `${base}.video.canvas.json`);
-    const outDir = path9.dirname(outPath);
-    const blueprintPath = path9.join(outDir, "prompt.json");
+    const videoPath = path10.resolve(String(args.file));
+    const base = path10.basename(videoPath, path10.extname(videoPath));
+    const slug = args.slug ? String(args.slug) : void 0;
+    if (slug && !isValidScaffoldSlug(slug)) {
+      process.stderr.write(
+        `${JSON.stringify({ ok: false, error: { code: "invalid_slug", message: "--slug must be lowercase kebab (a-z, 0-9, hyphens), max 100 chars" } }, null, 2)}
+`
+      );
+      process.exit(2);
+    }
+    const outPath = args.out ? path10.resolve(String(args.out)) : slug ? path10.join(process.cwd(), "src", "creatives", slug, `${slug}.canvas.json`) : path10.join(path10.dirname(videoPath), `${base}.video.canvas.json`);
+    const outDir = path10.dirname(outPath);
+    const blueprintPath = path10.join(outDir, "prompt.json");
     const frames = args.frames === "reuse" ? "reuse" : "generate";
     const maxScenes = args["max-scenes"] ? Number(args["max-scenes"]) : void 0;
     if (Number.isFinite(maxScenes)) {
@@ -16561,10 +16729,10 @@ var scaffoldVideoCommand = defineCommand87({
 `
       );
     }
-    const compositionDest = path9.join(outDir, "video-overlay-composition");
+    const compositionDest = path10.join(outDir, "video-overlay-composition");
     await cp(SHIPPED_COMPOSITION_DIR, compositionDest, { recursive: true });
     await stampCompositionDims(compositionDest, outDims);
-    const indexPath = path9.join(compositionDest, "index.html");
+    const indexPath = path10.join(compositionDest, "index.html");
     const overlayHtml = buildOverlayHtml(blueprint);
     const indexHtml = await readFile6(indexPath, "utf8");
     const injected = indexHtml.replace("<!--OVERLAYS-->", () => overlayHtml);
@@ -16580,9 +16748,9 @@ var scaffoldVideoCommand = defineCommand87({
     const opts = {
       imageModel,
       videoModel,
-      overlayCompositionPath: path9.relative(outDir, compositionDest),
-      captionsCompositionPath: captions.compositionPath ? path9.relative(outDir, captions.compositionPath) : void 0,
-      blueprintPath: path9.relative(outDir, blueprintPath),
+      overlayCompositionPath: path10.relative(outDir, compositionDest),
+      captionsCompositionPath: captions.compositionPath ? path10.relative(outDir, captions.compositionPath) : void 0,
+      blueprintPath: path10.relative(outDir, blueprintPath),
       frames,
       ambient: Boolean(args.ambient),
       ...args.aspect ? { aspect: String(args.aspect) } : {},
@@ -16624,7 +16792,7 @@ var scaffoldVideoCommand = defineCommand87({
             run_estimated_credits: validation.estimatedCredits
           },
           checklist: {
-            edit_prompt: `Edit ${path9.basename(blueprintPath)} \u2014 the blueprint deconstructed from your video; rewrite it into the ad you want (cast, palette, copy, claims). Every scene frame reads it via target_blueprint.`,
+            edit_prompt: `Edit ${path10.basename(blueprintPath)} \u2014 the blueprint deconstructed from your video; rewrite it into the ad you want (cast, palette, copy, claims). Every scene frame reads it via target_blueprint.`,
             recurring_elements_to_supply: report.elements,
             voices_to_confirm: report.dialogue.map((d) => ({
               scene: d.scene,
@@ -16651,7 +16819,7 @@ var scaffoldVideoCommand = defineCommand87({
 
 // src/commands/canvas/set-prompt.ts
 import { readFile as readFile7, writeFile as writeFile3 } from "fs/promises";
-import path10 from "path";
+import path11 from "path";
 import { defineCommand as defineCommand88 } from "citty";
 function setNodePrompt(canvas, nodeId, text) {
   const nodes = canvas?.nodes;
@@ -16679,7 +16847,7 @@ var setPromptCommand = defineCommand88({
     "text-file": { type: "string", description: "Read the new prompt from a UTF-8 file (preserves accents/newlines)" }
   },
   async run({ args }) {
-    const filePath = path10.resolve(String(args.file));
+    const filePath = path11.resolve(String(args.file));
     let canvas;
     try {
       canvas = JSON.parse(await readFile7(filePath, "utf8"));
@@ -16689,7 +16857,7 @@ var setPromptCommand = defineCommand88({
       process.exit(2);
     }
     let text;
-    if (args["text-file"]) text = await readFile7(path10.resolve(String(args["text-file"])), "utf8");
+    if (args["text-file"]) text = await readFile7(path11.resolve(String(args["text-file"])), "utf8");
     else if (args.text !== void 0) text = String(args.text);
     else {
       process.stderr.write(
@@ -16710,7 +16878,7 @@ var setPromptCommand = defineCommand88({
       process.exit(2);
       return;
     }
-    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(updated, path10.dirname(filePath)), defaultRegistry());
+    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(updated, path11.dirname(filePath)), defaultRegistry());
     if (!validation.ok) {
       process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "validation", issues: validation.issues } }, null, 2)}
 `);
@@ -16726,7 +16894,7 @@ var setPromptCommand = defineCommand88({
 
 // src/commands/canvas/validate.ts
 import { readFile as readFile8 } from "fs/promises";
-import path11 from "path";
+import path12 from "path";
 import { defineCommand as defineCommand89 } from "citty";
 var validateCommand = defineCommand89({
   meta: {
@@ -16735,7 +16903,7 @@ var validateCommand = defineCommand89({
   },
   args: { file: { type: "positional", required: true, description: "Path to canvas JSON" } },
   async run({ args }) {
-    const filePath = path11.resolve(String(args.file));
+    const filePath = path12.resolve(String(args.file));
     const raw = await readFile8(filePath, "utf8");
     let parsed;
     try {
@@ -16746,7 +16914,7 @@ var validateCommand = defineCommand89({
 `);
       process.exit(2);
     }
-    parsed = resolveRelativeCanvasPaths(parsed, path11.dirname(filePath));
+    parsed = resolveRelativeCanvasPaths(parsed, path12.dirname(filePath));
     const result = await validateCanvasDeep(parsed, defaultRegistry());
     if (!result.ok) {
       process.stderr.write(`${JSON.stringify({ ok: false, issues: result.issues }, null, 2)}
@@ -16883,6 +17051,16 @@ registerSchema({
       type: "string",
       description: "Optional URL of the original reference ad",
       required: false
+    },
+    slug: {
+      type: "string",
+      description: "Creative slug (src/creatives/<slug>/) \u2014 attaches the image to that creative's row",
+      required: false
+    },
+    runId: {
+      type: "string",
+      description: "Canvas run id (r_\u2026) of the approved generation to pin as published",
+      required: false
     }
   }
 });
@@ -16892,6 +17070,13 @@ function detectCreativeContentType(filePath) {
     unsupportedMessage: "Unsupported creative image extension. Use PNG, JPG, or WebP."
   });
 }
+function chatIdFromEnv() {
+  try {
+    return getEnv().BAKER_CHAT_ID || void 0;
+  } catch {
+    return void 0;
+  }
+}
 function parseOptionalUrl(value) {
   if (value === void 0 || value.trim() === "") {
     return void 0;
@@ -16922,7 +17107,11 @@ async function publishCreative(args, deps = defaultImageApiDeps) {
   return publishImageAsCreative(deps, {
     imageId: upload.imageId,
     title,
-    sourceReferenceUrl
+    sourceReferenceUrl,
+    slug: args.slug,
+    runId: args.runId,
+    // Attribute the publish to the driving chat (injected by the bridge).
+    chatId: chatIdFromEnv()
   });
 }
 var publishCommand = defineCommand91({
@@ -16938,6 +17127,16 @@ var publishCommand = defineCommand91({
       type: "string",
       description: "Optional URL of the original reference ad",
       required: false
+    },
+    slug: {
+      type: "string",
+      description: "Creative slug (src/creatives/<slug>/) \u2014 attaches the image to that creative's row",
+      required: false
+    },
+    runId: {
+      type: "string",
+      description: "Canvas run id (r_\u2026) of the approved generation to pin as published",
+      required: false
     }
   },
   run: async ({ args }) => {
@@ -16956,7 +17155,9 @@ var publishCommand = defineCommand91({
         file,
         title,
         context: args.context,
-        sourceReferenceUrl: args.sourceReferenceUrl
+        sourceReferenceUrl: args.sourceReferenceUrl,
+        slug: args.slug,
+        runId: args.runId
       });
       writeJson({ ok: true, data });
     } catch (err) {
@@ -17854,9 +18055,9 @@ async function readImageBuffer(pathOrUrl) {
   }
   return readFile10(pathOrUrl);
 }
-async function isDirectory(path12) {
+async function isDirectory(path13) {
   try {
-    const s = await stat2(path12);
+    const s = await stat2(path13);
     return s.isDirectory();
   } catch {
     return false;