@koda-sl/baker-cli 0.359.0-dev.d2f320fd3 → 0.360.0

package/README.md

@@ -2541,6 +2541,16 @@ baker images extract https://example.com --wait-for 1500 --limit 20
 
 Every image extracted from a page shares the scraped-page URL as `externalUrl`. Big pages can return 100+ images — cap auto-ingest at 20.
 
+A failed extract says which kind of failure it was, with `retryable` and a `fix`:
+
+| Code | Meaning | Next move |
+|------|---------|-----------|
+| `UNAVAILABLE` | The page reader did not answer or timed out, or the site asked us to slow down | Retry once, then fall back |
+| `VALIDATION_ERROR` | The page itself refused (e.g. HTTP 404) or is too large to read | Do not retry; fall back |
+| `INTERNAL_ERROR` | A fault on Baker's side | Do not retry; fall back |
+
+The fallback is `baker images screenshot <url>` for the page as one image, or `baker images logo <domain>` for the brand's mark. A `503` from any command now maps to `UNAVAILABLE` instead of `INTERNAL_ERROR`.
+
 **Flags:**
 
 | Flag             | Description                                                                                |
@@ -5292,7 +5302,7 @@ Every run gets its own directory:
 - Naming: `<node_id>__<slot>[__<index>].<ext>`.
 - `_final.<ext>` is a copy of whichever node the top-level `output` points at.
 - `manifest.json` is what `baker canvas inspect` reads — duration, cache hit/miss, asset refs, errors.
-- Default root is `canvas/` at the workspace root (the nearest folder with a `package.json` above the canvas file), whichever directory you run from. Override with `--outputs-dir`.
+- Default root is `./canvas/`. Override with `--outputs-dir`.
 
 ---
 
@@ -5304,7 +5314,7 @@ Cache key:
 sha256(canonical({ node_id, node_version, params, input_hashes, cache_salt, extras }))
 ```
 
-- Entries live in `canvas/.cache/` at the workspace root (index + content-addressed blobs).
+- Entries live in `./canvas/.cache/` (index + content-addressed blobs).
 - Cache hits re-materialize asset files into the new run dir instantly; misses execute the node and write a new entry atomically.
 - `hyperframe_*` folds a recursive sha256 of the composition directory into `extras` — edit any file in `my-composition/` and the cache busts automatically. No version bump needed.
 - If computing `extras` fails (e.g. the composition directory is unreadable), the node fails with that error — it never falls back to a partial cache key, so stale results can't be served silently.
@@ -5399,8 +5409,8 @@ Validate, then execute the graph. Blocks until done. Logs one line per node. Ret
 
 | Flag | Default | Effect |
 |---|---|---|
-| `--cache-dir <path>` | `<workspace root>/canvas/.cache` | Where content-addressed bytes + cache index live. |
-| `--outputs-dir <path>` | `<workspace root>/canvas` | Root for per-run output directories. |
+| `--cache-dir <path>` | `./canvas/.cache` | Where content-addressed bytes + cache index live. |
+| `--outputs-dir <path>` | `./canvas` | Root for per-run output directories. |
 | `--run-id <id>` | auto ULID | Override the generated run id. |
 | `--cache-policy <policy>` | `read_write` | `read_write`, `bypass`, or `read_only`. |
 | `--concurrency <n>` | `5` (or `BAKER_CANVAS_CONCURRENCY`) | Max nodes executing at once within a layer. |

package/canvas/avocado-tutorial.json

@@ -74,7 +74,7 @@
         "transcript": "$ref:transcribe.transcript"
       },
       "params": {
-        "composition": "./tiktok-captions-composition",
+        "composition": "./packages/cli/canvas/tiktok-captions-composition",
         "words_per_group": 3,
         "font_size": 72,
         "text_color": "#ffffff",

package/canvas/hello-world-overlay.json

@@ -22,7 +22,7 @@
         "background": "$ref:person_image.images#0"
       },
       "params": {
-        "composition": "./hello-world-composition",
+        "composition": "./packages/cli/canvas/hello-world-composition",
         "text": "HELLO WORLD!!",
         "font_size": 128,
         "text_color": "#ffffff",

package/dist/{chunk-K2IKLMCM.js → chunk-AI4HWQVN.js}

@@ -20,9 +20,9 @@ import {
   shouldEscalate
 } from "./chunk-2OKSJNLA.js";
 
-// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js
+// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js
 var require_safe_stable_stringify = __commonJS({
-  "../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js"(exports, module) {
+  "../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js"(exports, module) {
     "use strict";
     var { hasOwnProperty } = Object.prototype;
     var stringify = configure2();
@@ -1114,7 +1114,7 @@ function resolveAdaptFormats(params) {
   return params.formats ?? [];
 }
 
-// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/esm/wrapper.js
+// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/esm/wrapper.js
 var import__ = __toESM(require_safe_stable_stringify(), 1);
 var configure = import__.default.configure;
 var wrapper_default = import__.default;
@@ -9904,4 +9904,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-K2IKLMCM.js.map
+//# sourceMappingURL=chunk-AI4HWQVN.js.map