@koda-sl/baker-cli 0.350.0 → 0.352.0-dev.09c54d90c

package/dist/cli.js

@@ -23,6 +23,7 @@ import {
   YtDlpError,
   bestSupportedQuality,
   canonicalUrl,
+  catalogView,
   clipAudioMode,
   clipDurationsFor,
   clipParamRecipe,
@@ -67,7 +68,7 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-YBD3W4M7.js";
+} from "./chunk-B7MLH3K6.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -24816,7 +24817,12 @@ var metaDraftAdvisorySchema = z34.object({
   message: z34.string()
 });
 var metaDraftListResponseSchema = z34.object({
-  status: z34.enum(["active", "publishing", "applied", "discarded", "none"]),
+  /**
+   * `applied` means the publish finished with no op failed or skipped — when `mode` is `simulated`
+   * nothing reached Meta. `partial` means the publish finished but at least one op failed or was
+   * skipped — read each op's `result` for which one and why.
+   */
+  status: z34.enum(["active", "publishing", "applied", "partial", "discarded", "none"]),
   mode: metaWriteModeSchema,
   count: z34.number(),
   ops: z34.array(metaDraftOpViewSchema),
@@ -35525,15 +35531,38 @@ import { defineCommand as defineCommand119 } from "citty";
 
 // src/commands/canvas/catalog.ts
 import { defineCommand as defineCommand108 } from "citty";
-var catalogCommand = defineCommand108({
-  meta: {
-    name: "catalog",
-    description: "Print the agent-facing node catalog (JSON Schema). Includes every registered node grouped by category."
+var DESCRIPTION = "The canvas node catalog. Start here: `baker canvas catalog` lists every node by category with one line each (a few KB). Then `--node video_generate` prints that node's full JSON Schema \u2014 params, inputs, outputs, models, when to use it. `--category image` narrows the list; add `--full` for that category's schemas. `--full` alone prints every schema (~160 KB) \u2014 prefer `--node`.";
+var ARGS = {
+  node: {
+    type: "string",
+    required: false,
+    description: "Node id(s) whose full schema to print, comma-separated. Example: --node video_generate,tts"
   },
-  async run() {
-    const cat = await generateCatalog(defaultRegistry());
-    process.stdout.write(`${JSON.stringify(cat, null, 2)}
+  category: {
+    type: "string",
+    required: false,
+    description: "Only this category (audio, video, image, \u2026). Listed with one line per node unless --full."
+  },
+  full: {
+    type: "boolean",
+    required: false,
+    default: false,
+    description: "Print full JSON Schemas instead of the one-line index (every node, or the --category)."
+  }
+};
+registerSchema({ command: "canvas.catalog", description: DESCRIPTION, args: ARGS });
+var catalogCommand = defineCommand108({
+  meta: { name: "catalog", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args: args5 }) {
+    const view = catalogView(generateCatalog(defaultRegistry()), {
+      node: typeof args5.node === "string" ? args5.node : void 0,
+      category: typeof args5.category === "string" ? args5.category : void 0,
+      full: args5.full === true
+    });
+    process.stdout.write(`${JSON.stringify(view, null, 2)}
 `);
+    if (!view.ok) process.exit(1);
   }
 });
 
@@ -41301,7 +41330,6 @@ import { z as z40 } from "zod";
 var GEN_ASPECT_RATIOS = /* @__PURE__ */ new Set(["1:1", "4:5", "9:16", "16:9", "4:3", "3:4", "2:3", "3:2", "21:9"]);
 var DEFAULT_ASPECT_RATIO = "9:16";
 var SHEET_SUBJECT_TYPE2 = {
-  person: "person",
   animal: "character"
 };
 var ACTOR_SHEET_MODEL2 = "google/gemini-3-pro-image-preview";
@@ -41311,7 +41339,8 @@ var ADAPT_IMAGE_SIZE = "2K";
 var ADAPT_GUIDANCE = "Keep the headline, logo, CTA, and hero subject fully visible in every ratio. Reproduce every text string verbatim \u2014 no dropped, added, or altered characters \u2014 and preserve the exact brand-color treatment (e.g. a black\u2192red word pivot), never flattening it.";
 var Blueprint = z40.object({
   meta: z40.object({ estimated_aspect_ratio: z40.string().optional() }).loose().optional(),
-  text_content: z40.array(z40.object({ text: z40.string().optional() }).loose()).optional()
+  text_content: z40.array(z40.object({ text: z40.string().optional() }).loose()).optional(),
+  people: z40.array(z40.unknown()).optional()
 }).loose();
 var ElementLocator = z40.object({
   collection: z40.enum(["subjects", "people", "brands_logos"]),
@@ -41367,6 +41396,7 @@ function roleForType2(type) {
     case "product":
       return "the showcased product; keep this exact product identity. Ignore any caption text printed on this reference.";
     case "person":
+      return "the emotional hero \u2014 the brand's cast person: a company Avatar's identity sheet, a multi-view turnaround of ONE person the brand may show. Keep this exact face, hair and build, and render them once in the pose, gaze, wardrobe and expression the blueprint specifies \u2014 never as a grid. Ignore the cell labels printed on the sheet.";
     case "animal":
       return "the emotional hero \u2014 the face/muzzle/eyes the viewer locks onto and exactly where AI artifacts (malformed mouths, teeth, foam, extra fingers) betray a fake. It MUST be grounded in this real reference, never invented from prose. Keep this identity AND the expression the blueprint specifies. Ignore any caption text printed on this reference.";
     default:
@@ -41377,7 +41407,10 @@ function todoPath2(el, label) {
   const desc = el.description ? ` \u2014 ${el.description}` : "";
   const expr = el.expression ? `, with a ${el.expression} expression` : "";
   const t = el.type.toLowerCase();
-  const lock = t === "person" || t === "animal" ? " \u2014 REQUIRED: this is the emotional hero; ground it in a real reference (image-library / video-library / Pinterest), do not delete this slot and free-generate" : "";
+  if (t === "person") {
+    return `[TODO: drop the identity sheet of a company Avatar for ${label}${desc}${expr} \u2014 REQUIRED: this is the emotional hero and the render keeps this face, so use \`baker avatars list\` or cast one with \`baker avatars create\`, then put its sheetUrl here; never a found photo of a real person (web search, the source ad), who never agreed to appear in this ad]`;
+  }
+  const lock = t === "animal" ? " \u2014 REQUIRED: this is the emotional hero; ground it in a real reference (image-library / video-library / Pinterest), do not delete this slot and free-generate" : "";
   return `[TODO: drop a real image for ${label} (${el.type})${desc}${expr}${lock} \u2014 replace with a path relative to this canvas file, never an absolute path]`;
 }
 function sheetSubjectDescription(el) {
@@ -41417,6 +41450,9 @@ function textFidelityDirective(blueprint, hasFont) {
     "Keep all type crisp, legible, and large enough to read cleanly; no garbled, warped, or duplicated characters, and no unreadable microtext."
   ].join("\n");
 }
+function showsPerson(blueprint, elements) {
+  return (blueprint.people?.length ?? 0) > 0 || elements.some((el) => el.type.toLowerCase() === "person");
+}
 function scaffoldStaticAd(input, elementsInput, opts) {
   const blueprint = Blueprint.parse(input);
   const elements = MainElements.parse(elementsInput);
@@ -41482,15 +41518,18 @@ function scaffoldStaticAd(input, elementsInput, opts) {
       params: { text: specimenText(blueprint), font_size: 72, line_height: 1.2, max_width: 1600 }
     });
   }
+  const originalAsReference = !showsPerson(blueprint, elements);
   const reference = [
     ...elementSlots.map((s) => s.ref),
     ...hasFont ? ["$ref:type_ref.image"] : [],
-    "$ref:original.asset"
+    ...originalAsReference ? ["$ref:original.asset"] : []
   ];
   const legend = [
     ...elementSlots.map((s) => `- ${s.label} \u2014 ${roleForType2(s.type)}`),
     ...hasFont ? ["- TYPE SPECIMEN \u2014 render every text string in this exact typeface; ignore its color and layout."] : [],
-    "- ORIGINAL \u2014 use ONLY for composition, layout, and proportions. IGNORE its text, its logo, its brand name, and its colors entirely \u2014 they belong to a different brand."
+    ...originalAsReference ? [
+      "- ORIGINAL \u2014 use ONLY for composition, layout, and proportions. IGNORE its text, its logo, its brand name, and its colors entirely \u2014 they belong to a different brand."
+    ] : []
   ].join("\n");
   const exclusionsLast = imageProfileFor(opts.genModel)?.constraintPlacement === "last";
   const exclusionsBlock = "Exclusions: no invented badges, icons, or seals; render exactly the subjects the blueprint names and no others; no competitor branding; no watermark.";
@@ -41554,7 +41593,7 @@ function scaffoldStaticAd(input, elementsInput, opts) {
     schema: "baker-canvas/1",
     metadata: {
       name: "static ad reproduction",
-      description: "Scaffolded by `baker canvas scaffold-static-ad`. Edit `prompt.json` (the blueprint generated from the source image) into the ad you want, drop a real asset at each [TODO] ingest path (logo/product/subject/badge + brand font), then `baker canvas run`. The original is wired for composition only."
+      description: "Scaffolded by `baker canvas scaffold-static-ad`. Edit `prompt.json` (the blueprint generated from the source image) into the ad you want, drop a real asset at each [TODO] ingest path (logo/product/subject/badge + brand font), then `baker canvas run`. The original is wired for composition only, and left out of the render when it shows a person, whose face the generator would copy."
     },
     nodes,
     output: fanOut ? { node: "adapt", output: "images" } : { node: "gen", output: "images" }
@@ -42024,7 +42063,7 @@ var scaffoldStaticAdCommand = defineCommand114({
     "skip-font": { type: "boolean", description: "Skip the brand-font \u2192 type-specimen slot" },
     "skip-actor-sheets": {
       type: "boolean",
-      description: "Ground each person/animal on its lone dropped photo instead of a generated multi-view sheet"
+      description: "Ground each animal hero on its lone dropped photo instead of a generated multi-view sheet (a person hero always grounds on the company Avatar sheet dropped at its slot)"
     }
   },
   async run({ args: args5 }) {
@@ -42165,7 +42204,7 @@ var scaffoldStaticAdCommand = defineCommand114({
             edit_prompt: `Edit ${path21.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 (the describe pass recorded the ad's typefaces under `fonts` in prompt.json \u2014 match those). The font is wired into the render as a TYPE SPECIMEN reference so generated text takes the brand letterforms. Delete the brandfont + type_ref nodes to skip it." : "skipped (--skip-font)",
-            actor_sheets: report.actor_sheets.length > 0 ? `Each living hero (${report.actor_sheets.join(", ")}) is fused into a generated multi-view reference sheet (image_reference_sheet) that the render grounds on \u2014 so drop ONE clean photo at that hero's ingest and the sheet builds the consistent turnaround. Pass --skip-actor-sheets to ground on the lone photo instead.` : "none (no person/animal heroes detected, or --skip-actor-sheets)",
+            actor_sheets: report.actor_sheets.length > 0 ? `Each animal hero (${report.actor_sheets.join(", ")}) is fused into a generated multi-view reference sheet (image_reference_sheet) that the render grounds on \u2014 so drop ONE clean photo at that hero's ingest and the sheet builds the consistent turnaround. Pass --skip-actor-sheets to ground on the lone photo instead. A person hero takes a company Avatar's identity sheet at its slot (baker avatars), never a found photo.` : "none (no animal heroes detected, or --skip-actor-sheets). A person hero takes a company Avatar's identity sheet at its slot (baker avatars), never a found photo.",
             placements: report.placements === null ? `Single format (${report.aspect_ratio}). Pass --placements meta_feed_stories|meta_all|linkedin|\u2026 to auto-fan-out to a platform's set.` : `Auto-fans the approved hero out to ${report.placements} \u2192 ${report.output_formats.join(", ")}. The hero ratio (${report.aspect_ratio}) passes through free; each other ratio is a billed render, AI-recomposed (not cropped). Re-read the copy and confirm the brand-color treatment on EVERY ratio before publishing \u2014 adaptation re-generates and can silently mangle text or flatten a color device. Pass --placements none for a single base ad.`,
             note: "Populate as you go: for each [TODO] ingest slot, source its real asset and wire it into the slot right away \u2014 one at a time, not all sourced first then reconciled at the end. For any LOGO slot, use the company's committed brand logo from `src/brand/logos/` (per BRAND.md's Logos map) \u2014 do NOT re-fetch it with `baker images logo <domain>` when a brand logo exists, because the Brandfetch CDN often serves an OUTDATED mark and that is how an old logo ships on a live ad. When every slot is filled, `baker canvas validate` then `baker canvas run`. Running generates a billed image \u2014 it is not free."
           }
@@ -43135,7 +43174,7 @@ var scaffoldAdCommand = defineCommand115({
     "video-model": {
       type: "string",
       required: false,
-      description: "Which curated video model renders the shots. Defaults to the one the lane picks; pass this only to compare models on the same brief, because mixing models across a campaign changes how the same face reads. `baker canvas catalog` lists what each one takes."
+      description: "Which curated video model renders the shots. Defaults to the one the lane picks; pass this only to compare models on the same brief, because mixing models across a campaign changes how the same face reads. `baker canvas catalog --node video_generate` lists what each one takes."
     },
     "no-brand": {
       type: "boolean",
@@ -44501,7 +44540,7 @@ Subcommands:
   baker canvas run <file.json>        \u2014 execute the canvas, write outputs to ./canvas/<run_id>/
   baker canvas rerun <slug>           \u2014 restore a creative's latest recorded canvas from run history and run it (works in a fresh workspace)
   baker canvas sync-definition <path> \u2014 push a creative's current node-graph + input thumbnails to the dashboard without rendering (runs automatically on canvas/prompt edits)
-  baker canvas catalog                \u2014 print the agent-facing node + composition catalog (JSON Schema)
+  baker canvas catalog                \u2014 one line per node; --node <id> for its full schema
   baker canvas inspect <run_id>       \u2014 one-page summary of a completed run
   baker canvas scaffold-ad --spec <spec.json>        \u2014 DEFAULT for a new ad: write beats (one spoken line + one shot each), get the whole runnable canvas
   baker canvas scaffold-video <video>                \u2014 reproduce a video the USER gave you (an ad you found is inspiration, not a copy target)
@@ -63837,10 +63876,10 @@ var getCommand5 = defineCommand208({
 
 // src/commands/studio/improve.ts
 import { defineCommand as defineCommand209 } from "citty";
-var DESCRIPTION = "Sharpen a rough brief into directed art direction \u2014 the same rewrite the client gets from the wand in the Studio prompt bar. Reach for it when you are relaying the CLIENT's own words and want them shaped without substituting your voice; when you are writing the art direction yourself, just write it, because you will do a better job than this does.";
+var DESCRIPTION2 = "Sharpen a rough brief into directed art direction \u2014 the same rewrite the client gets from the wand in the Studio prompt bar. Reach for it when you are relaying the CLIENT's own words and want them shaped without substituting your voice; when you are writing the art direction yourself, just write it, because you will do a better job than this does.";
 registerSchema({
   command: "studio.improve",
-  description: DESCRIPTION,
+  description: DESCRIPTION2,
   args: {
     prompt: { type: "string", description: "The rough brief to sharpen", required: true },
     kind: {
@@ -63864,7 +63903,7 @@ registerSchema({
 var improveCommand = defineCommand209({
   meta: {
     name: "improve",
-    description: `${DESCRIPTION}
+    description: `${DESCRIPTION2}
 
 Both the rewrite and the original come back, so you can show the client what changed rather than silently replacing their words. Nothing is generated \u2014 feed the result to \`baker studio generate\` yourself.
 
@@ -64012,10 +64051,10 @@ var listCommand18 = defineCommand211({
 
 // src/commands/studio/models.ts
 import { defineCommand as defineCommand212 } from "citty";
-var DESCRIPTION2 = "What each Studio model actually accepts: its shapes, resolutions, clip lengths, prompt character cap, how many reference images it takes, and which knobs it has. Read this before a batch you care about \u2014 the models disagree far more than they look like they do, and a setting the chosen model does not have is REFUSED, not ignored.";
+var DESCRIPTION3 = "What each Studio model actually accepts: its shapes, resolutions, clip lengths, prompt character cap, how many reference images it takes, and which knobs it has. Read this before a batch you care about \u2014 the models disagree far more than they look like they do, and a setting the chosen model does not have is REFUSED, not ignored.";
 registerSchema({
   command: "studio.models",
-  description: DESCRIPTION2,
+  description: DESCRIPTION3,
   args: {
     kind: {
       type: "string",
@@ -64101,7 +64140,7 @@ function buildModelCards(kind, model) {
 var modelsCommand = defineCommand212({
   meta: {
     name: "models",
-    description: `${DESCRIPTION2}
+    description: `${DESCRIPTION3}
 
 Everything here is read from the same table the backend validates against, so it cannot drift from what a request will actually be allowed to do.