pixelkiln 0.80.0 → 0.82.0

package/dist/cli.js

@@ -68,7 +68,7 @@ function exitCodeFor(err) {
 
 // src/cli/main.ts
 import { existsSync as existsSync37 } from "fs";
-import { readFile as readFile32 } from "fs/promises";
+import { readFile as readFile33 } from "fs/promises";
 
 // src/cli/args.ts
 import path from "path";
@@ -14628,10 +14628,11 @@ import { existsSync as existsSync26 } from "fs";
 // src/gallery/snapshot.ts
 import { createHash as createHash3 } from "crypto";
 import { existsSync as existsSync21 } from "fs";
-import { readFile as readFile18, stat as stat2 } from "fs/promises";
+import { readFile as readFile19, stat as stat2 } from "fs/promises";
 import path30 from "path";
 
 // src/gallery/edit.ts
+import { readFile as readFile18, rename as rename9, writeFile as writeFile14 } from "fs/promises";
 import path28 from "path";
 import { z as z10 } from "zod";
 
@@ -14876,9 +14877,62 @@ var HandEditRequestSchema = z10.discriminatedUnion("action", [
     protocol: z10.number().int().positive()
   }).strict()
 ]);
+var UNDO_DEPTH = 20;
+var UndoRequestSchema = z10.object({
+  action: z10.literal("undo-edit"),
+  project: z10.string().min(1).optional(),
+  /** The manifest as the page last saw it; undo refuses a manifest someone else has changed since. */
+  expectedSha256: z10.string().regex(/^[0-9a-f]{64}$/)
+}).strict();
 function createGalleryEditHandler(opts) {
   const log2 = opts.onProgress ?? (() => {
   });
+  const apply = createEditApplier(opts, log2);
+  const history = /* @__PURE__ */ new Map();
+  const manifestOf = async (project) => {
+    try {
+      return path28.resolve(await opts.manifestFor(typeof project === "string" ? project : void 0));
+    } catch {
+      return null;
+    }
+  };
+  return async (body) => {
+    const undo = UndoRequestSchema.safeParse(body);
+    if (undo.success) {
+      const manifestPath2 = await manifestOf(undo.data.project);
+      if (!manifestPath2) throw new ManifestEditError("no manifest to undo an edit in");
+      const current = await readFile18(manifestPath2, "utf8");
+      if (sha256(current) !== undo.data.expectedSha256) throw new ManifestDriftError(manifestPath2);
+      const stack = history.get(manifestPath2) ?? [];
+      const last = stack[stack.length - 1];
+      if (!last) throw new ManifestEditError("nothing to undo: this gallery has not changed the manifest");
+      if (last.afterSha !== sha256(current)) {
+        history.delete(manifestPath2);
+        throw Object.assign(new Error("the manifest changed outside the gallery since its last edit; undo would discard that change"), { status: 409 });
+      }
+      const tmp = manifestPath2 + ".pixelkiln-undo";
+      await writeFile14(tmp, last.before);
+      await rename9(tmp, manifestPath2);
+      stack.pop();
+      log2(`  manifest edit undone in ${path28.relative(process.cwd(), manifestPath2) || manifestPath2}`);
+      return opts.reload();
+    }
+    const manifestPath = await manifestOf(body?.project);
+    const before = manifestPath ? await readFile18(manifestPath, "utf8").catch(() => null) : null;
+    const build = await apply(body);
+    if (manifestPath && before !== null) {
+      const after = await readFile18(manifestPath, "utf8").catch(() => null);
+      if (after !== null && after !== before) {
+        const stack = history.get(manifestPath) ?? [];
+        stack.push({ before, afterSha: sha256(after) });
+        if (stack.length > UNDO_DEPTH) stack.shift();
+        history.set(manifestPath, stack);
+      }
+    }
+    return build;
+  };
+}
+function createEditApplier(opts, log2) {
   return async (body) => {
     const handEdit = HandEditRequestSchema.safeParse(body);
     if (handEdit.success) {
@@ -15220,7 +15274,7 @@ function describeHistory(media, entry, cacheDir) {
 var MAX_COMPARED_BYTES = 8 * 1024 * 1024;
 async function samePixels(a, b) {
   try {
-    const [left, right] = await Promise.all([readFile18(a), readFile18(b)]);
+    const [left, right] = await Promise.all([readFile19(a), readFile19(b)]);
     if (left.length > MAX_COMPARED_BYTES || right.length > MAX_COMPARED_BYTES) return false;
     const x = decodePng(left);
     const y = decodePng(right);
@@ -15378,7 +15432,7 @@ async function buildGallerySnapshot(opts) {
   const media = /* @__PURE__ */ new Map();
   const plan = await buildPlan(specs, lock);
   const items = [];
-  const manifestText = await readFile18(loaded.path, "utf8");
+  const manifestText = await readFile19(loaded.path, "utf8");
   const manifestSha256 = sha256(manifestText);
   const cacheDir = path30.resolve(path30.dirname(opts.lockPath), ".pixelkiln", "cache");
   let rawStyles = {};
@@ -15730,7 +15784,7 @@ async function buildWorkspaceGallerySnapshot(opts) {
         root: loaded.root,
         provider: loaded.manifest.provider,
         account: project.account ?? null,
-        manifestSha256: manifestSha256 ?? sha256(await readFile18(manifestPath, "utf8")),
+        manifestSha256: manifestSha256 ?? sha256(await readFile19(manifestPath, "utf8")),
         historyLimit: historyLimit(loaded.manifest),
         entries: Object.keys(lock.entries).length,
         items: projectItems.length,
@@ -15789,7 +15843,7 @@ async function buildWorkspaceGallerySnapshot(opts) {
 // src/gallery/server.ts
 import { randomBytes } from "crypto";
 import { createServer as createServer2 } from "http";
-import { readFile as readFile19 } from "fs/promises";
+import { readFile as readFile20 } from "fs/promises";
 
 // src/gallery/page.ts
 import { existsSync as existsSync22, readFileSync as readFileSync4 } from "fs";
@@ -15863,26 +15917,35 @@ ${css}</style>
     <span class="project" id="project"></span>
     <span class="grow"></span>
     <label class="search"><input id="q" type="search" placeholder="Search assets, prompts, ids, hashes" autocomplete="off"><kbd>/</kbd></label>
-    <select id="sort" aria-label="Sort">
-      <option value="key">Sort: style / asset</option>
-      <option value="newest">Sort: newest first</option>
-      <option value="oldest">Sort: oldest first</option>
-      <option value="cost">Sort: cost</option>
-      <option value="size">Sort: size</option>
-    </select>
-    <select id="group" aria-label="Group">
-      <option value="style">Group: by style</option>
-      <option value="family">Group: by family</option>
-      <option value="none">Group: none</option>
-    </select>
+    <details class="menu" id="view-menu">
+      <summary title="Sort, group, card size, backdrop, and playback">View</summary>
+      <div class="menu-panel">
+        <label class="menu-row"><span>Sort</span><select id="sort" aria-label="Sort">
+          <option value="key">style / asset</option>
+          <option value="newest">newest first</option>
+          <option value="oldest">oldest first</option>
+          <option value="cost">cost</option>
+          <option value="size">size</option>
+        </select></label>
+        <label class="menu-row"><span>Group</span><select id="group" aria-label="Group">
+          <option value="style">by style</option>
+          <option value="family">by family</option>
+          <option value="none">none</option>
+        </select></label>
+        <div class="menu-row"><span>Cards</span><span class="seg" id="size" role="group" aria-label="Card size">
+          <button type="button" data-size="s" title="Small cards: more on screen">S</button><button type="button" data-size="m" title="Medium cards">M</button><button type="button" data-size="l" title="Large cards: sprites drawn bigger">L</button>
+        </span></div>
+        <div class="menu-row"><span>Backdrop</span><span id="backdrop-slot"></span></div>
+        <label class="menu-row check" title="Play every loop on the grid; without this, a loop plays while the pointer is over it"><input id="playloops" type="checkbox"> Play every loop</label>
+        <label class="menu-row check" title="Refresh every 5 seconds while this tab is visible"><input id="auto" type="checkbox"> Refresh every 5 seconds</label>
+        <label class="menu-row check" id="notify-chip" hidden title="A system notification when a job finishes while this tab is in the background"><input id="notify" type="checkbox"> Notify when a job finishes</label>
+      </div>
+    </details>
     <span id="editing" class="editing" hidden title="This gallery can write the manifest. It never contacts a provider.">editing</span>
     <button id="select" type="button" title="Pick several records to generate, regenerate, compare, or tag together (or ctrl/\u2318-click a card)">Select</button>
     <button id="studio" type="button" hidden title="Draft a new character: its style, base, loops, and portrait, priced as you go">+ New character</button>
     <button id="refresh" type="button" title="Re-read the manifest, lockfile, and disk">Refresh</button>
-    <label class="chip" title="Refresh every 5 seconds while this tab is visible"><input id="auto" type="checkbox"> auto</label>
-    <label class="chip" title="Play every loop on the grid; without this, a loop plays while the pointer is over it"><input id="playloops" type="checkbox"> play loops</label>
-    <span id="backdrop-slot"></span>
-    <label class="chip" id="notify-chip" hidden title="A system notification when a job finishes while this tab is in the background"><input id="notify" type="checkbox"> notify</label>
+    <button id="keys" type="button" title="Keyboard shortcuts (?)" aria-label="Keyboard shortcuts">?</button>
   </div>
   <div class="totals" id="totals"></div>
   <div class="chips" id="chips"></div>
@@ -15891,9 +15954,9 @@ ${css}</style>
 </header>
 <main id="root"></main>
 <div id="selbar" class="selbar" hidden></div>
+<div id="toast" class="toast" role="status" aria-live="polite" hidden></div>
 <footer>
-  Click a sprite for its full record; <kbd>shift</kbd>-click adds it to a side-by-side comparison. <kbd>\u2190</kbd>/<kbd>\u2192</kbd> step through the visible set while a record
-  is open, <kbd>,</kbd>/<kbd>.</kbd> step a loop's frames and <kbd>space</kbd> plays it, <kbd>Esc</kbd> closes it, and <kbd>/</kbd> jumps to search. This page reads the manifest, lockfile,
+  Click a sprite for its full record; press <kbd>?</kbd> for every keyboard shortcut. This page reads the manifest, lockfile,
   and disk only. It never contacts a provider<span id="foot-edit"> and never writes anything</span><span id="foot-editing" hidden>.
   Editing is on: saving rewrites the manifest and nothing else</span><span id="foot-gen" hidden>.
   Generation is on under the session budget shown above; every run is the same submit, poll, and fetch as <code>pixelkiln gen</code></span>.
@@ -16095,7 +16158,7 @@ async function serveGallery(opts) {
         const asset = reviewAssets.get(jobId)?.get(url2.pathname);
         if (!asset) return fail(404, "no such review asset");
         try {
-          const bytes = await readFile19(asset.path);
+          const bytes = await readFile20(asset.path);
           res.writeHead(200, {
             "Content-Type": asset.contentType,
             "Cache-Control": "no-store",
@@ -16178,7 +16241,7 @@ async function serveGallery(opts) {
         if (!asset) return fail(404, "no such gallery media");
         let bytes;
         try {
-          bytes = await readFile19(asset.path);
+          bytes = await readFile20(asset.path);
         } catch {
           return fail(404, "gallery media is no longer on disk; refresh the page");
         }
@@ -16634,10 +16697,10 @@ function ownedReferenceImageId(spec, lock, providerId) {
 
 // src/pick/server.ts
 import { existsSync as existsSync24 } from "fs";
-import { readFile as readFile21 } from "fs/promises";
+import { readFile as readFile22 } from "fs/promises";
 
 // src/pipeline/init.ts
-import { readdir, readFile as readFile20, writeFile as writeFile14 } from "fs/promises";
+import { readdir, readFile as readFile21, writeFile as writeFile15 } from "fs/promises";
 import { existsSync as existsSync23 } from "fs";
 import path31 from "path";
 function pngSize(buf) {
@@ -16667,7 +16730,7 @@ async function scanAssets(root, opts = {}) {
   const skipped = [];
   const seen = /* @__PURE__ */ new Map();
   for (const file of files.sort()) {
-    const size = pngSize(await readFile20(file));
+    const size = pngSize(await readFile21(file));
     if (!size) {
       skipped.push(`${file} (not a readable PNG)`);
       continue;
@@ -16735,7 +16798,7 @@ async function writeManifestFile(target, manifest) {
   if (existsSync23(target)) {
     throw new Error(`${target} already exists; refusing to overwrite an existing manifest.`);
   }
-  await writeFile14(target, JSON.stringify(manifest, null, 2) + "\n");
+  await writeFile15(target, JSON.stringify(manifest, null, 2) + "\n");
 }
 
 // src/pick/sheet.ts
@@ -17154,7 +17217,7 @@ async function currentArt(entry, spec) {
   let width = entry.width;
   let height = entry.height;
   if (contentType === "image/png") {
-    const size = pngSize(await readFile21(file));
+    const size = pngSize(await readFile22(file));
     if (size) ({ width, height } = size);
   }
   return { path: file, contentType, width, height };
@@ -17687,13 +17750,13 @@ function createGenerateHandlers(opts) {
 }
 
 // src/gallery/editor.ts
-import { readFile as readFile23 } from "fs/promises";
+import { readFile as readFile24 } from "fs/promises";
 import path33 from "path";
 
 // src/editor/install.ts
 import { createHash as createHash4 } from "crypto";
 import { existsSync as existsSync25 } from "fs";
-import { mkdir as mkdir12, readFile as readFile22, rename as rename9, rm as rm10, stat as stat3, writeFile as writeFile15 } from "fs/promises";
+import { mkdir as mkdir12, readFile as readFile23, rename as rename10, rm as rm10, stat as stat3, writeFile as writeFile16 } from "fs/promises";
 import os2 from "os";
 import path32 from "path";
 
@@ -17777,7 +17840,7 @@ function editorBaseUrl(pin = EDITOR_PIN) {
 }
 async function sha256Of(file) {
   try {
-    return createHash4("sha256").update(await readFile22(file)).digest("hex");
+    return createHash4("sha256").update(await readFile23(file)).digest("hex");
   } catch {
     return null;
   }
@@ -17851,8 +17914,8 @@ async function installEditor(opts = {}) {
     const final = path32.join(dir, name);
     const tmp = `${final}.${process.pid}.part`;
     try {
-      await writeFile15(tmp, bytes);
-      await rename9(tmp, final);
+      await writeFile16(tmp, bytes);
+      await rename10(tmp, final);
     } finally {
       await rm10(tmp, { force: true });
     }
@@ -17970,7 +18033,7 @@ function createGalleryEditorHandlers(opts = {}) {
       if (!status.installed) return null;
       let bytes;
       try {
-        bytes = await readFile23(path33.join(dir, name));
+        bytes = await readFile24(path33.join(dir, name));
       } catch {
         verified = null;
         return null;
@@ -18437,7 +18500,7 @@ import { existsSync as existsSync28 } from "fs";
 
 // src/pipeline/cache-health.ts
 import { existsSync as existsSync27 } from "fs";
-import { readFile as readFile24, readdir as readdir2, rm as rm11 } from "fs/promises";
+import { readFile as readFile25, readdir as readdir2, rm as rm11 } from "fs/promises";
 import path35 from "path";
 async function inspectCaches(lock, lockPath, options = {}) {
   if (options.prune && !existsSync27(lockPath)) {
@@ -18465,7 +18528,7 @@ async function inspectCaches(lock, lockPath, options = {}) {
       await saveCache(remotePath, { version: 1, hashes: {} });
       removed.resetRemoteHashCache = true;
     } else if (remoteHashes.invalidIds.length) {
-      const cache = parseCache(JSON.parse(await readFile24(remotePath, "utf8")));
+      const cache = parseCache(JSON.parse(await readFile25(remotePath, "utf8")));
       for (const id of remoteHashes.invalidIds) delete cache.hashes[id];
       removed.remoteHashEntries = remoteHashes.invalidIds.length;
       await saveCache(remotePath, cache);
@@ -18509,7 +18572,7 @@ async function inspectContentCache(contentDir, referenced) {
     const expected = mediaType ? entry.name.slice(0, -4) : "";
     let bytes;
     try {
-      bytes = await readFile24(file);
+      bytes = await readFile25(file);
       report.bytes += bytes.length;
     } catch (err) {
       report.invalid.push({
@@ -18556,7 +18619,7 @@ async function inspectRemoteHashCache(remotePath) {
   if (!report.exists) return report;
   let cache;
   try {
-    cache = parseCache(JSON.parse(await readFile24(remotePath, "utf8")));
+    cache = parseCache(JSON.parse(await readFile25(remotePath, "utf8")));
   } catch (err) {
     report.error = err instanceof Error ? err.message : String(err);
     return report;
@@ -18883,7 +18946,7 @@ async function nearestExistingDirectory(start) {
 }
 
 // src/pipeline/audit.ts
-import { readFile as readFile25 } from "fs/promises";
+import { readFile as readFile26 } from "fs/promises";
 import { existsSync as existsSync31 } from "fs";
 import path38 from "path";
 function paletteDistance(asset, reference) {
@@ -18926,7 +18989,7 @@ async function auditStyle(loaded, specs, styleId, lock) {
         continue;
       }
       try {
-        const png = decodePng(await readFile25(output.absolutePath));
+        const png = decodePng(await readFile26(output.absolutePath));
         const palette = extractPalette(png, 12);
         assets.push({
           assetId: spec.assetId,
@@ -18953,7 +19016,7 @@ async function auditStyle(loaded, specs, styleId, lock) {
     const abs = path38.resolve(loaded.root, img.path);
     if (!existsSync31(abs)) continue;
     try {
-      refPalettes.push(extractPalette(decodePng(await readFile25(abs)), 12));
+      refPalettes.push(extractPalette(decodePng(await readFile26(abs)), 12));
     } catch {
     }
   }
@@ -19182,7 +19245,7 @@ async function runAudit(args) {
 
 // src/cli/commands/pack.ts
 import path40 from "path";
-import { readFile as readFile26 } from "fs/promises";
+import { readFile as readFile27 } from "fs/promises";
 
 // src/pipeline/pack.ts
 import { readFileSync as readFileSync5 } from "fs";
@@ -19895,7 +19958,7 @@ async function runPack(args) {
     if (args.primaryOnly || args.outputRoles.length) {
       throw new Error("--primary-only and --output-role require manifest-driven pack");
     }
-    const raw = JSON.parse(await readFile26(path40.resolve(args.inputs), "utf8"));
+    const raw = JSON.parse(await readFile27(path40.resolve(args.inputs), "utf8"));
     const inputs = resolvePackInputs(raw, args.inputs);
     const { png, atlas, skipped, sources } = packSprites(inputs, { columns: args.columns });
     const format = sheetFormat(args);
@@ -20124,7 +20187,7 @@ import path42 from "path";
 
 // src/pixellab-utils.ts
 import { existsSync as existsSync32 } from "fs";
-import { mkdir as mkdir13, readFile as readFile27, writeFile as writeFile16 } from "fs/promises";
+import { mkdir as mkdir13, readFile as readFile28, writeFile as writeFile17 } from "fs/promises";
 import path41 from "path";
 var UNZOOM_MIN_SIDE = 256;
 var UNZOOM_MAX_AREA = 2048 * 2048;
@@ -20136,7 +20199,7 @@ async function unzoomFile(client2, input, opts = {}) {
   const out = path41.resolve(opts.out ?? defaultUnzoomOut(input));
   if (path41.resolve(input) === out) throw new Error("unzoom will not overwrite its own input; pass a different --out");
   if (existsSync32(out) && !opts.force) throw new Error(`${out} already exists; pass --force to replace it`);
-  const bytes = await readFile27(input);
+  const bytes = await readFile28(input);
   const metadata = imageMetadata(bytes);
   if (!metadata) throw new Error(`${input} is not a readable PNG or JPEG`);
   const { width, height, format } = metadata;
@@ -20150,7 +20213,7 @@ async function unzoomFile(client2, input, opts = {}) {
   }
   const res = await client2.unzoom({ image: { base64: bytes.toString("base64"), format }, quantize: opts.quantize });
   await mkdir13(path41.dirname(out), { recursive: true });
-  await writeFile16(out, res.png);
+  await writeFile17(out, res.png);
   return { out, original: res.originalSize, unzoomed: res.unzoomedSize, zoomFactor: res.zoomFactor, usage: res.usage };
 }
 var FONT_WEIGHTS = ["Bold", "Regular"];
@@ -20192,8 +20255,8 @@ async function generateFont(client2, opts) {
         client2.download(job.download_atlas_url)
       ]);
       await mkdir13(path41.dirname(ttf), { recursive: true });
-      await writeFile16(ttf, ttfBytes);
-      await writeFile16(atlas, atlasBytes);
+      await writeFile17(ttf, ttfBytes);
+      await writeFile17(atlas, atlasBytes);
       return { jobId, ttf, atlas, glyphPx: job.glyph_px ?? null, usage: job.usage };
     }
     if (Date.now() - started > timeout) {
@@ -20274,12 +20337,12 @@ async function runFont(args) {
 
 // src/cli/commands/quality.ts
 import path44 from "path";
-import { readFile as readFile29 } from "fs/promises";
+import { readFile as readFile30 } from "fs/promises";
 
 // src/pipeline/quality-regression.ts
 import path43 from "path";
 import { existsSync as existsSync33 } from "fs";
-import { readFile as readFile28 } from "fs/promises";
+import { readFile as readFile29 } from "fs/promises";
 import { z as z12 } from "zod";
 var SHA256_RE = /^[0-9a-f]{64}$/;
 var HEX_RE = /^#[0-9a-f]{6}$/;
@@ -20435,7 +20498,7 @@ async function measureImageQuality(file) {
   const absolute = path43.resolve(file);
   let bytes;
   try {
-    bytes = await readFile28(absolute);
+    bytes = await readFile29(absolute);
   } catch (error) {
     throw new Error(`Cannot read quality image ${absolute}: ${message4(error)}`, { cause: error });
   }
@@ -20522,7 +20585,7 @@ async function snapshotQualityBaseline(inputs, baselinePath, options = {}) {
   });
   const data = Buffer.from(JSON.stringify(baseline, null, 2) + "\n");
   if (existsSync33(absolute) && !options.force) {
-    const current = await readFile28(absolute);
+    const current = await readFile29(absolute);
     if (!current.equals(data)) {
       throw new OverwriteRefusedError(
         `Quality baseline already exists with different content: ${absolute}. Pass --force to replace it.`,
@@ -20537,7 +20600,7 @@ async function readQualityBaseline(baselinePath) {
   const absolute = path43.resolve(baselinePath);
   let raw;
   try {
-    raw = JSON.parse(await readFile28(absolute, "utf8"));
+    raw = JSON.parse(await readFile29(absolute, "utf8"));
   } catch (error) {
     throw new Error(`Could not read quality baseline ${absolute}: ${message4(error)}`, { cause: error });
   }
@@ -20667,7 +20730,7 @@ async function runQuality(args) {
     if (!args.out) throw new Error("quality snapshot needs --out <pixelkiln.quality.json>.");
     let raw;
     try {
-      raw = JSON.parse(await readFile29(path44.resolve(args.inputs), "utf8"));
+      raw = JSON.parse(await readFile30(path44.resolve(args.inputs), "utf8"));
     } catch (error) {
       throw new Error(
         `Could not read quality inputs ${path44.resolve(args.inputs)}: ${error instanceof Error ? error.message : String(error)}`,
@@ -20719,7 +20782,7 @@ import path46 from "path";
 // src/recipes.ts
 import path45 from "path";
 import { existsSync as existsSync34 } from "fs";
-import { readdir as readdir3, readFile as readFile30 } from "fs/promises";
+import { readdir as readdir3, readFile as readFile31 } from "fs/promises";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { z as z13 } from "zod";
 var SHA256_RE2 = /^[0-9a-f]{64}$/;
@@ -20907,7 +20970,7 @@ async function readRecipeFile(recipePath, bundled) {
   const absolute = path45.resolve(recipePath);
   let raw;
   try {
-    raw = JSON.parse(await readFile30(absolute, "utf8"));
+    raw = JSON.parse(await readFile31(absolute, "utf8"));
   } catch (error) {
     throw new Error(`Could not read recipe ${absolute}: ${message5(error)}`, { cause: error });
   }
@@ -21049,12 +21112,12 @@ async function installRecipe(target, options = {}) {
   ];
   const files = await Promise.all(sources.map(async (file) => ({
     path: path45.join(destination, ...file.path.split("/")),
-    data: await readFile30(file.source)
+    data: await readFile31(file.source)
   })));
   if (!options.force) {
     for (const file of files) {
       if (!existsSync34(file.path)) continue;
-      const current = await readFile30(file.path);
+      const current = await readFile31(file.path);
       if (!current.equals(file.data)) {
         throw new OverwriteRefusedError(
           `Recipe destination has local changes: ${file.path}. Choose another --out or pass --force to replace declared recipe files.`,
@@ -21294,7 +21357,7 @@ async function runRefine(args) {
 // src/cli/commands/skeleton.ts
 import path48 from "path";
 import { existsSync as existsSync35 } from "fs";
-import { readFile as readFile31, writeFile as writeFile17 } from "fs/promises";
+import { readFile as readFile32, writeFile as writeFile18 } from "fs/promises";
 
 // src/skeleton-preview.ts
 var RIGHT = [255, 140, 40, 255];
@@ -21410,7 +21473,7 @@ async function runEstimateSkeleton(args) {
   }
   loadEnvFiles(path48.dirname(path48.resolve(args.manifest)));
   loadEnvFiles(process.cwd());
-  const bytes = await readFile31(path48.resolve(image));
+  const bytes = await readFile32(path48.resolve(image));
   const metadata = imageMetadata(bytes);
   if (!metadata) throw new UsageError(`${image} is not a readable PNG or JPEG`);
   const sizeProblem = estimateSkeletonSizeProblem(metadata.width, metadata.height);
@@ -21422,7 +21485,7 @@ async function runEstimateSkeleton(args) {
   const frames = args.frames ?? DEFAULT_SCAFFOLD_FRAMES;
   const json = JSON.stringify(scaffoldSkeletonSet(res.keypoints, frames), null, 2);
   if (args.out) {
-    await writeFile17(path48.resolve(args.out), json + "\n");
+    await writeFile18(path48.resolve(args.out), json + "\n");
     log(`  wrote ${args.out}: the estimated pose and ${frames} frames to edit`);
     log(`  preview it with: pixelkiln skeleton-preview ${args.out} --from ${image}`);
   } else {
@@ -21454,7 +21517,7 @@ async function runSkeletonPreview(args) {
   if (!existsSync35(keypointsFile)) throw new UsageError(`Keypoints file does not exist yet: ${keypointsFile}`);
   let json;
   try {
-    json = JSON.parse(await readFile31(keypointsFile, "utf8"));
+    json = JSON.parse(await readFile32(keypointsFile, "utf8"));
   } catch (error) {
     throw new UsageError(`${keypointsFile} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -21464,13 +21527,13 @@ async function runSkeletonPreview(args) {
     if (!existsSync35(sourceFile)) {
       log(`  source image does not exist yet, drawing on a plain ground: ${sourceFile}`);
     } else {
-      const bytes = await readFile31(sourceFile);
+      const bytes = await readFile32(sourceFile);
       if (imageMetadata(bytes)?.format !== "png") throw new UsageError(`${sourceFile} must be a PNG to preview over`);
       source = decodePng(bytes);
     }
   }
   const out = path48.resolve(args.out ?? keypointsFile.replace(/\.json$/, "") + ".preview.png");
-  await writeFile17(out, renderSkeletonSheet(set, { source }));
+  await writeFile18(out, renderSkeletonSheet(set, { source }));
   log(`  ${label}: ${set.frames.length} frames after the starting pose`);
   const shown = path48.relative(process.cwd(), out);
   log(`  wrote ${shown.startsWith("..") ? out : shown}`);
@@ -21656,7 +21719,7 @@ async function runVersion() {
   for (const up of ["../package.json", "../../package.json"]) {
     const url = new URL(up, import.meta.url);
     if (!existsSync37(url)) continue;
-    const pkg = JSON.parse(await readFile32(url, "utf8"));
+    const pkg = JSON.parse(await readFile33(url, "utf8"));
     if (pkg.name === "pixelkiln") {
       log(`${pkg.name} ${pkg.version}`);
       return;