@koda-sl/baker-cli 0.353.0-dev.8bdd8f915 → 0.353.0-dev.afbf521d7

package/README.md

@@ -3875,12 +3875,17 @@ 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.
 
 # 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
@@ -5330,11 +5335,6 @@ and the canvas file is saved, before anything else reads it. `normalized_paths`
 wrote it, so validate, run, and the preview all pass, and only the publish build — a different checkout
 root, a different session — ever sees the break.
 
-**A URL in an ingest's `path` is healed the same way.** A `source: "path"` ingest whose `path` is an
-http(s) URL already runs as `source: "url"`; `validate` and `run` rewrite the file to say so
-(`normalized_paths` lists it as `{ param: "source", from: "path", to: "url" }`), so the commit gate,
-which reads the file, agrees with what rendered.
-
 Two roots count as "this workspace": the current one, and `/home/user/repo` (`REPO_PATH`), the fixed path
 every Session's workspace is checked out at. A path under either names the same file in any checkout, so
 remapping it is a proof rather than a guess — which is what lets an already-committed canvas heal in the