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

package/README.md

@@ -2536,6 +2536,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 just now | 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                                                                                |
@@ -5330,11 +5340,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

package/dist/{chunk-YBLNCFK4.js → chunk-B7MLH3K6.js}

@@ -9866,7 +9866,6 @@ export {
   isAudioOnly,
   durationSeconds,
   canonicalUrl,
-  coercePathUrlToUrl,
   toModelSafeImage,
   catalogView,
   BackendClient2,
@@ -9879,4 +9878,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-YBLNCFK4.js.map
+//# sourceMappingURL=chunk-B7MLH3K6.js.map