@magicpixelart/cli 0.5.5 → 0.5.6

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.5.6] — 2026-08-21
+
+### Changed
+
+- **README positioning.** Lead with generation, reskins/variants, the full
+  browser editor, and MCP/CLI instead of sprites/tilesets/direction sheets.
+
+### Fixed
+
+- **Transient Supabase 546 (edge worker recycle).** Friendly error copy for
+  status 546, five retry attempts with a longer backoff (~7.5s coverage), and
+  546s are no longer reported as telemetry noise. Persistent 5xx still reports.
+  Shape-guard tests that exhaust those retries now use a 15s budget so CI
+  matches the new backoff.
+
 ## [0.5.5] — 2026-07-12
 
 ### Added

package/README.md

@@ -1,6 +1,8 @@
 # @magicpixelart/cli
 
-Sync MagicPixel pixel-art assets to your local project as flattened PNGs. Zero runtime — just files on disk that your bundler picks up.
+Sync your [MagicPixel](https://magicpixel.art) pixel-art assets to your local project as flattened PNGs. Zero runtime — just files on disk that your bundler picks up.
+
+MagicPixel is an [AI pixel art generator](https://magicpixel.art) for game developers: generate new pixel art, reskin and remix the assets you already have, and finish them in a full browser editor — then pull them straight into your repo with this CLI. It also exposes a [Model Context Protocol server](https://magicpixel.art/guides/connect) so Claude, ChatGPT, and Cursor can generate assets for you, and a [Vite plugin](https://www.npmjs.com/package/@magicpixelart/vite) that syncs on save with no second terminal.
 
 ## Install
 
@@ -205,6 +207,14 @@ at a non-canonical host.
 - A runtime JS SDK (your bundler already handles PNG imports)
 - Cross-user asset sharing
 
+## More about MagicPixel
+
+- [AI pixel art generator](https://magicpixel.art) — generate new pixel art, and reskin or remix the assets you already have.
+- [Pixel art editor](https://magicpixel.art/pixel-art-editor) — palette remapping, components, pixel-accurate cleanup, and animation frames.
+- [Generating game sprites with AI](https://magicpixel.art/guides/generating-sprites) — the workflow for game-ready assets.
+- [Editing AI pixel art](https://magicpixel.art/guides/editing-ai-art) — cleaning up and iterating on generated sprites.
+- [Connect an AI agent over MCP](https://magicpixel.art/guides/connect) — Claude, ChatGPT, and Cursor.
+
 ## License
 
 MIT

package/dist/api.js

@@ -47,6 +47,11 @@ function friendly(status, body, context) {
     if (status === 429) {
         return `${context}: 429 — rate limited. Retry shortly.`;
     }
+    if (status === 546) {
+        // Supabase Edge Runtime platform code — worker boot / CPU / wall-time.
+        // Not one of ours; typically clears in seconds.
+        return `${context}: 546 — MagicPixel edge worker restarting. Retried automatically; if this persists, retry in ~30s.`;
+    }
     if (status >= 500) {
         return `${context}: ${status} — MagicPixel server error. Retry shortly; status at https://magicpixel.art.`;
     }
@@ -140,7 +145,10 @@ export async function fetchManifestPage(opts) {
  *   request-id of the most recent attempt.
  */
 export async function retryTransient(context, fn) {
-    const maxAttempts = 3;
+    // 5 attempts × (500ms, 1s, 2s, 4s) = ~7.5s of coverage. Enough to ride out
+    // a Supabase edge worker recycle (546) or a brief 5xx without surfacing to
+    // the user; short enough that a real outage still fails within one sync tick.
+    const maxAttempts = 5;
     let lastErr = null;
     let nextDelayMs = 0;
     for (let attempt = 1; attempt <= maxAttempts; attempt++) {
@@ -164,7 +172,7 @@ export async function retryTransient(context, fn) {
                 nextDelayMs = 0;
             }
             if (attempt < maxAttempts) {
-                const backoffMs = 250 * 2 ** (attempt - 1);
+                const backoffMs = 500 * 2 ** (attempt - 1);
                 await new Promise((r) => setTimeout(r, Math.max(nextDelayMs, backoffMs)));
             }
         }

package/dist/util/telemetry.js

@@ -41,6 +41,13 @@ export function shouldReportCliError(err) {
     if (!(err instanceof Error))
         return false;
     if (err instanceof ApiError) {
+        // 546 is a Supabase Edge Runtime platform code (worker boot / CPU /
+        // wall-time). It bypasses our function's try/catch and is almost always
+        // transient. Retries usually absorb it; a leaked-to-user 546 is still
+        // unactionable noise on /admin/errors. Persistent worker failures still
+        // surface as 500/502/503, which remain reported.
+        if (err.status === 546)
+            return false;
         // User/config issues have actionable fix hints already; don't add noise.
         return err.status >= 500;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicpixelart/cli",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "description": "Sync MagicPixel pixel-art assets to your local project.",
   "type": "module",
   "bin": {