@koda-sl/baker-cli 0.369.0 → 0.371.0

package/README.md

@@ -3914,12 +3914,19 @@ baker canvas validate my-canvas.json
 #    or the same ad rendered once per aspect ratio instead of one hero + a terminal
 #    image_aspect_adapt (IMAGE_PARALLEL_FORMAT_RENDERS — separate renders drift in type,
 #    crop, and color, so the sizes stop matching).
+#    A generator prompt is measured with its {{slots}} filled from text nodes and local
+#    prompt.json/text ingests: past the model's character cap it is refused as
+#    PROMPT_OVER_MODEL_LIMIT, naming the node and the overshoot, before anything bills.
+#    `scaffold-static-ad` runs the same check on the prompt.json it writes and, when it is over,
+#    still writes the canvas and returns the overshoot in `hints[]` — trim prompt.json, then validate.
 
 # 2. Run (executes nodes, writes files to ./canvas/<run_id>/)
 baker canvas run my-canvas.json
 #    Advisory warnings print as `[warn] <CODE>: …` before anything bills.
 #    Only nodes reachable from the declared output execute (orphaned nodes are skipped,
 #    not billed). Add --keep-runs N to prune old r_* run dirs, keeping the N newest.
+#    A failed run reports `error.code: "input_invalid"` when the backend refused a node's
+#    own input (it fails the same way until the input changes), `"runtime"` otherwise.
 
 # 2b. Independent nodes ALREADY fan out in parallel — every node in the same
 #     topological layer (e.g. all the per-clip video_generate nodes) runs concurrently