pixelkiln 0.21.0 → 0.23.0

package/dist/cli.js

@@ -3,7 +3,7 @@
 // src/cli.ts
 import path26 from "path";
 import { existsSync as existsSync21 } from "fs";
-import { readFile as readFile21 } from "fs/promises";
+import { readFile as readFile22 } from "fs/promises";
 
 // src/env.ts
 import { readFileSync, existsSync } from "fs";
@@ -7790,7 +7790,7 @@ async function runPicker(provider, lock, lockPath, opts = {}) {
 // src/gallery/snapshot.ts
 import { createHash as createHash3 } from "crypto";
 import { existsSync as existsSync16 } from "fs";
-import { stat as stat3 } from "fs/promises";
+import { readFile as readFile15, stat as stat3 } from "fs/promises";
 import path20 from "path";
 
 // src/workspace.ts
@@ -7980,8 +7980,17 @@ var ManifestEditSchema = z5.discriminatedUnion("action", [
     expectedSha256: HexSha,
     patch: z5.object({
       /** Candidates per generation, written to the provider's own option. */
-      candidates: z5.number().int().min(1).max(64)
-    }).strict()
+      candidates: z5.number().int().min(1).max(64).optional(),
+      /** Empty clears the style's own value (inherit, or the default). */
+      promptPrefix: z5.string().optional(),
+      promptSuffix: z5.string().optional(),
+      /** `#rrggbb` values; null or empty clears the style's own palette. */
+      palette: z5.array(z5.string().regex(/^#?[0-9a-f]{6}$/i, "expected a six-digit hex colour")).max(256).nullable().optional(),
+      /** Provider view name (PixelLab: low top-down, high top-down, side); empty clears. */
+      view: z5.string().max(64).nullable().optional(),
+      /** pixflux only; null clears the style's own value. */
+      noBackground: z5.boolean().nullable().optional()
+    }).strict().refine((patch) => Object.keys(patch).length > 0, { message: "nothing to change" })
   }).strict()
 ]);
 var ManifestDriftError = class extends Error {
@@ -8019,16 +8028,27 @@ function applyEdit(raw, edit) {
   if (edit.action === "patch-style") {
     const style = raw.styles && Object.hasOwn(raw.styles, edit.styleId) ? raw.styles[edit.styleId] : void 0;
     if (!style) throw new ManifestEditError(`style "${edit.styleId}" is not declared by the manifest`);
-    const provider = styleProvider(raw, edit.styleId);
-    const option = CANDIDATE_OPTION[provider];
-    if (!option) {
-      throw new ManifestEditError(
-        provider === "pixellab" ? "PixelLab's candidate count follows the generator and size: map and pixflux return one image; a 1dir style returns 4\u201364 for its size" : `provider "${provider}" has no candidate-count option`
-      );
+    const { patch: patch2 } = edit;
+    if (patch2.candidates !== void 0) {
+      const provider = styleProvider(raw, edit.styleId);
+      const option = CANDIDATE_OPTION[provider];
+      if (!option) {
+        throw new ManifestEditError(
+          provider === "pixellab" ? "PixelLab's candidate count follows the generator and size: map and pixflux return one image; a 1dir style returns 4\u201364 for its size" : `provider "${provider}" has no candidate-count option`
+        );
+      }
+      const options = { ...style.providerOptions ?? {} };
+      options[provider] = { ...options[provider] ?? {}, [option]: patch2.candidates };
+      style.providerOptions = options;
     }
-    const options = { ...style.providerOptions ?? {} };
-    options[provider] = { ...options[provider] ?? {}, [option]: edit.patch.candidates };
-    style.providerOptions = options;
+    if (patch2.promptPrefix !== void 0) setOrDelete(style, "promptPrefix", patch2.promptPrefix || null);
+    if (patch2.promptSuffix !== void 0) setOrDelete(style, "promptSuffix", patch2.promptSuffix || null);
+    if (patch2.palette !== void 0) {
+      const colors = (patch2.palette ?? []).map((color) => "#" + color.replace(/^#/, "").toLowerCase());
+      setOrDelete(style, "palette", colors.length ? colors : null);
+    }
+    if (patch2.view !== void 0) setOrDelete(style, "view", patch2.view?.trim() || null);
+    if (patch2.noBackground !== void 0) setOrDelete(style, "noBackground", patch2.noBackground);
     return;
   }
   if (edit.action === "add-asset") {
@@ -8253,6 +8273,14 @@ async function buildGallerySnapshot(opts) {
   const media = /* @__PURE__ */ new Map();
   const plan = await buildPlan(specs, lock);
   const items = [];
+  const manifestText = await readFile15(loaded.path, "utf8");
+  const manifestSha256 = sha256(manifestText);
+  let rawStyles = {};
+  try {
+    const raw = JSON.parse(manifestText);
+    if (raw && typeof raw === "object" && raw.styles && typeof raw.styles === "object") rawStyles = raw.styles;
+  } catch {
+  }
   for (const planItem of plan.items) {
     const { spec, key } = planItem;
     const entry = lock.entries[key];
@@ -8387,6 +8415,8 @@ async function buildGallerySnapshot(opts) {
     const counts = new Set(styleItems.filter((item) => item.declared && item.candidates !== null).map((item) => item.candidates));
     const provider = style ? style.provider ?? loaded.manifest.provider : styleItems[0]?.provider ?? loaded.manifest.provider;
     const actionableItems = styleItems.filter((item) => item.declared && (item.state === "missing" || item.state === "stale" || item.state === "failed"));
+    const declaredItems = styleItems.filter((item) => item.declared);
+    const rawStyle = Object.hasOwn(rawStyles, id) ? rawStyles[id] : void 0;
     return {
       id,
       project: null,
@@ -8395,11 +8425,22 @@ async function buildGallerySnapshot(opts) {
       provider,
       generator: style?.generator ?? styleItems[0]?.generator ?? "map",
       outDir: style?.outDir ?? "",
+      promptPrefix: style?.promptPrefix ?? "",
+      promptSuffix: style?.promptSuffix ?? "",
       palette: style?.palette ?? [],
+      view: style?.view ?? null,
+      noBackground: style?.noBackground ?? true,
       quality: Boolean(style?.quality),
       tags: style?.tags ?? [],
+      extends: typeof rawStyle?.extends === "string" ? rawStyle.extends : null,
+      ownFields: rawStyle ? Object.keys(rawStyle).filter((key) => key !== "extends") : [],
       items: styleItems.length,
       spendByUnit: spend,
+      regenerate: {
+        assets: declaredItems.length,
+        cost: declaredItems.reduce((sum, item) => sum + (item.estimatedCost ?? 0), 0),
+        costUnit: declaredItems[0]?.costUnit ?? styleItems[0]?.costUnit ?? "generations"
+      },
       candidates: counts.size === 1 ? [...counts][0] : null,
       candidatesEditable: Boolean(style) && Object.hasOwn(CANDIDATE_OPTION, provider),
       actionable: {
@@ -8420,7 +8461,7 @@ async function buildGallerySnapshot(opts) {
       root,
       provider: loaded.manifest.provider,
       account: null,
-      manifestSha256: await sha256File(loaded.path),
+      manifestSha256,
       entries: Object.keys(lock.entries).length,
       items: items.length,
       spendByUnit: spendByUnit(lock),
@@ -8457,6 +8498,7 @@ async function buildWorkspaceGallerySnapshot(opts) {
       const lock = await loadLock(lockPath);
       let projectItems = [];
       let projectStyles = [];
+      let manifestSha256 = null;
       if (!excluded) {
         const specs = await resolveSpecs(loaded, { styles: styleFilter, assets: assetFilter });
         normalizeLockOutputPaths(lock, specs);
@@ -8469,6 +8511,7 @@ async function buildWorkspaceGallerySnapshot(opts) {
           now: opts.now
         });
         for (const [id, file] of build.media) media.set(id, file);
+        manifestSha256 = build.snapshot.project?.manifestSha256 ?? null;
         projectItems = build.snapshot.items.map((item) => ({
           ...item,
           id: `${project.id}:${item.key}`,
@@ -8486,7 +8529,7 @@ async function buildWorkspaceGallerySnapshot(opts) {
         root: loaded.root,
         provider: loaded.manifest.provider,
         account: project.account ?? null,
-        manifestSha256: await sha256File(manifestPath),
+        manifestSha256: manifestSha256 ?? sha256(await readFile15(manifestPath, "utf8")),
         entries: Object.keys(lock.entries).length,
         items: projectItems.length,
         spendByUnit: spendByUnit(lock),
@@ -8544,7 +8587,7 @@ async function buildWorkspaceGallerySnapshot(opts) {
 import { spawn as spawn2 } from "child_process";
 import { randomBytes } from "crypto";
 import { createServer as createServer2 } from "http";
-import { readFile as readFile15 } from "fs/promises";
+import { readFile as readFile16 } from "fs/promises";
 
 // src/gallery/page.ts
 function renderGallery(snapshot, opts = {}) {
@@ -8741,6 +8784,12 @@ function renderGallery(snapshot, opts = {}) {
   .shead .cand { display:inline-flex; align-items:center; gap:6px; font-size:12px; color:var(--dim); }
   .shead .cand input { width:56px; background:var(--panel-deep); border:1px solid var(--line); color:var(--text);
     padding:2px 6px; font:12px/1.4 inherit; border-radius:0; }
+  form.edit.style-form { margin:0 0 14px; }
+  form.edit .blast { padding:8px 10px; border:1px solid var(--line); font-size:12.5px; color:var(--dim); }
+  form.edit .blast.hot { border-color:var(--warn); color:var(--text); }
+  form.edit .blast b { color:var(--warn); font-weight:600; }
+  form.edit .pal { margin-top:4px; }
+  .style .notice { margin:0 0 14px; }
   #jobs { width:min(100%,var(--content)); margin:0 auto; padding:0 22px 12px; display:grid; gap:6px; }
   #jobs:empty { display:none; }
   .job { border:1px solid var(--line); background:var(--panel-deep); padding:8px 12px; display:grid;
@@ -8861,6 +8910,7 @@ function renderGallery(snapshot, opts = {}) {
 </footer>
 <div id="drawer-host"></div>
 <div id="dialog-host"></div>
+<datalist id="view-options"><option value="low top-down"><option value="high top-down"><option value="side"><option value="sidescroller"></datalist>
 <script>
 const INITIAL = ${data};
 const SESSION = ${session};
@@ -9192,7 +9242,8 @@ function renderHeader() {
   t.lastChild.append(el('b', null, n), document.createTextNode(' lock ' + (n === 1 ? 'entry' : 'entries')));
   const declared = snap.items.filter((i) => i.declared).length;
   t.append(el('span', null, declared + ' declared by ' + (snap.workspace ? 'a manifest' : 'the manifest')));
-  t.append(el('span', null, fmtSpend(snap.totals.spendByUnit) + ' recorded'));
+  const recorded = fmtSpend(snap.totals.spendByUnit);
+  t.append(el('span', null, recorded === 'no spend recorded' ? recorded : recorded + ' recorded'));
   if (snap.filter.styles.length || snap.filter.assets.length) {
     t.append(el('span', 'state-warn', 'filtered: ' +
       [snap.filter.styles.length ? '--style ' + snap.filter.styles.join(',') : '',
@@ -9386,7 +9437,12 @@ function renderMain(items) {
         g.onclick = () => generateDialog(snap.items.filter((i) => i.project === s.project && s.actionable.keys.includes(i.key)), { project: s.project });
         tools.append(g);
       }
+      const styleKey = 'style:' + (s.project || '') + ':' + s.id;
       if (EDITABLE && s.outDir) {
+        const es = el('button', null, ui.editing === styleKey ? 'Cancel' : 'Edit style');
+        es.type = 'button';
+        es.onclick = () => { ui.editing = ui.editing === styleKey ? null : styleKey; ui.notice = null; render(); };
+        tools.append(es);
         const add = el('button', 'add', ui.editing === addKey ? 'Cancel' : '+ Add asset');
         add.type = 'button';
         add.onclick = () => { ui.editing = ui.editing === addKey ? null : addKey; render(); };
@@ -9394,6 +9450,8 @@ function renderMain(items) {
       }
       if (tools.childNodes.length) head.append(tools);
       wrap.append(head);
+      if (ui.notice && ui.notice.id === styleKey) wrap.append(el('div', 'notice', ui.notice.text));
+      if (ui.editing === styleKey) wrap.append(styleForm(s));
       if (ui.editing === addKey) wrap.append(addAssetForm(s));
     }
     const grid = el('div', 'grid');
@@ -9627,6 +9685,156 @@ function openCompare() {
 
 // ---- editing (only when the server minted a session) ---------------------
 
+// Styles a parent edit reaches: every descendant (via extends) that does not
+// declare the field itself. Child-wins means an omitted field is inherited,
+// so the count follows the manifest's own rule rather than guessing.
+function inheritorsOf(style, field) {
+  const byId = new Map(snap.styles.filter((x) => x.project === style.project).map((x) => [x.id, x]));
+  const out = [];
+  for (const other of byId.values()) {
+    if (other.id === style.id) continue;
+    let cur = other, blocked = false, hops = 0;
+    while (cur && cur.id !== style.id && hops++ < 32) {
+      if (cur.ownFields.includes(field)) { blocked = true; break; }
+      cur = cur.extends ? byId.get(cur.extends) : null;
+    }
+    if (cur && cur.id === style.id && !blocked) out.push(other.id);
+  }
+  return out;
+}
+// noBackground reaches the request only for pixflux and non-PixelLab
+// providers; elsewhere a change is recorded but alters nothing.
+const fieldReaches = (field, style) =>
+  field !== 'noBackground' || style.generator === 'pixflux' || style.provider !== 'pixellab';
+function blastRadius(style, fields) {
+  const byId = new Map(snap.styles.filter((x) => x.project === style.project).map((x) => [x.id, x]));
+  const styleIds = new Set();
+  for (const field of fields) {
+    for (const id of [style.id, ...inheritorsOf(style, field)]) {
+      if (fieldReaches(field, byId.get(id) || style)) styleIds.add(id);
+    }
+  }
+  const affected = snap.items.filter((i) => i.project === style.project && i.declared && styleIds.has(i.styleId));
+  const units = new Map();
+  for (const i of affected) if (i.estimatedCost !== null) units.set(i.costUnit, (units.get(i.costUnit) || 0) + i.estimatedCost);
+  return {
+    styles: [...styleIds],
+    assets: affected.length,
+    cost: [...units].map(([unit, n]) => fmtCost(unit, Math.round(n * 100) / 100)).join(' + '),
+  };
+}
+const parsePalette = (value) => value.split(/[s,]+/).map((c) => c.trim()).filter(Boolean)
+  .map((c) => '#' + c.replace(/^#/, '').toLowerCase());
+const paletteValid = (colors) => colors.every((c) => /^#[0-9a-f]{6}$/.test(c));
+
+function styleForm(style) {
+  const pr = snap.workspace ? snap.workspace.projects.find((x) => x.id === style.project) : snap.project;
+  const own = (field) => style.ownFields.includes(field);
+  const provenance = (field) => own(field) ? 'set on this style'
+    : style.extends ? 'inherited from ' + style.extends + ' \u2014 saving sets a value on this style itself; ' + style.extends + ' is unchanged'
+    : 'default \u2014 saving sets a value on this style itself';
+  const form = el('form', 'edit style-form');
+  form.append(el('h3', null, 'Edit style ' + style.id));
+  const prefix = el('input'); prefix.type = 'text'; prefix.value = style.promptPrefix; prefix.placeholder = 'none';
+  const suffix = el('input'); suffix.type = 'text'; suffix.value = style.promptSuffix; suffix.placeholder = 'none';
+  const palette = el('input'); palette.type = 'text'; palette.value = style.palette.join(', '); palette.placeholder = '#rrggbb, #rrggbb \u2014 leave empty for no forced palette';
+  const view = el('input'); view.type = 'text'; view.value = style.view || ''; view.placeholder = 'provider default';
+  view.setAttribute('list', 'view-options');
+  const noBg = el('select');
+  noBg.append(new Option(style.extends ? 'inherit from ' + style.extends : 'default (on)', 'default'), new Option('on \u2014 strip the generated background', 'on'), new Option('off \u2014 keep the background (scenes, banners)', 'off'));
+  noBg.value = own('noBackground') ? (style.noBackground ? 'on' : 'off') : 'default';
+  const swatches = el('div', 'pal');
+  const drawSwatches = () => {
+    swatches.textContent = '';
+    for (const c of parsePalette(palette.value)) { const i = el('i'); i.style.background = c; i.title = c; swatches.append(i); }
+  };
+  drawSwatches();
+  form.append(
+    field('prompt prefix', prefix, 'Prepended to every asset prompt in this style. ' + provenance('promptPrefix')),
+    field('prompt suffix', suffix, 'Appended to every asset prompt in this style. ' + provenance('promptSuffix')),
+    field('palette', palette, 'Forced colours where the provider supports them (pixflux). ' + provenance('palette')),
+    swatches,
+  );
+  const row = el('div', 'row');
+  row.append(
+    field('view', view, 'PixelLab accepts low top-down, high top-down, side; Retro Diffusion reads sidescroller. ' + provenance('view')),
+    field('background', noBg, (fieldReaches('noBackground', style) ? 'Sent for this style. ' : 'Not sent for ' + style.provider + ' ' + style.generator + '; recorded only. ') + provenance('noBackground')),
+  );
+  form.append(row);
+  const blast = el('div', 'blast');
+  const changed = () => {
+    const out = [];
+    if (prefix.value !== style.promptPrefix) out.push('promptPrefix');
+    if (suffix.value !== style.promptSuffix) out.push('promptSuffix');
+    if (parsePalette(palette.value).join(',') !== style.palette.map((c) => c.toLowerCase()).join(',')) out.push('palette');
+    if (view.value.trim() !== (style.view || '')) out.push('view');
+    const bgNow = own('noBackground') ? (style.noBackground ? 'on' : 'off') : 'default';
+    if (noBg.value !== bgNow) out.push('noBackground');
+    return out;
+  };
+  const updateBlast = () => {
+    const fields = changed();
+    drawSwatches();
+    if (!fields.length) { blast.className = 'blast'; blast.textContent = 'No changes yet. A style change alters the request for every asset that uses it.'; return; }
+    const r = blastRadius(style, fields);
+    if (!r.assets) {
+      blast.className = 'blast';
+      blast.textContent = 'Recorded in the manifest only: nothing in ' + style.id + ' sends this field, so no request changes.';
+      return;
+    }
+    blast.className = 'blast hot';
+    blast.textContent = '';
+    const others = r.styles.filter((id) => id !== style.id);
+    blast.append(el('b', null, 'Affects ' + r.assets + (r.assets === 1 ? ' asset' : ' assets')));
+    blast.append(document.createTextNode(others.length
+      ? ' in ' + style.id + ' and ' + others.length + (others.length === 1 ? ' style that inherits it (' : ' styles that inherit it (') + others.join(', ') + ').'
+      : ' in ' + style.id + '.'));
+    blast.append(document.createTextNode(' Generated ones become stale; regenerating all of them is about ' + (r.cost || 'nothing') + '. Nothing is spent until you generate.'));
+  };
+  for (const input of [prefix, suffix, palette, view]) input.addEventListener('input', updateBlast);
+  noBg.addEventListener('change', updateBlast);
+  updateBlast();
+  form.append(blast);
+  const actions = el('div', 'actions');
+  const save = el('button', 'primary', 'Save to manifest'); save.type = 'submit';
+  const cancel = el('button', null, 'Cancel'); cancel.type = 'button'; cancel.onclick = () => { ui.editing = null; render(); };
+  const msg = el('span', 'msg');
+  actions.append(save, cancel, msg);
+  form.append(actions);
+  form.onsubmit = async (e) => {
+    e.preventDefault();
+    const fields = changed();
+    if (!fields.length) { ui.editing = null; render(); return; }
+    const colors = parsePalette(palette.value);
+    if (fields.includes('palette') && !paletteValid(colors)) { msg.className = 'msg bad'; msg.textContent = 'palette must be six-digit hex colours'; return; }
+    const patch = {};
+    if (fields.includes('promptPrefix')) patch.promptPrefix = prefix.value;
+    if (fields.includes('promptSuffix')) patch.promptSuffix = suffix.value;
+    if (fields.includes('palette')) patch.palette = colors;
+    if (fields.includes('view')) patch.view = view.value.trim();
+    if (fields.includes('noBackground')) patch.noBackground = noBg.value === 'default' ? null : noBg.value === 'on';
+    save.disabled = true; msg.className = 'msg'; msg.textContent = 'saving\u2026';
+    const r = blastRadius(style, fields);
+    try {
+      const body = { action: 'patch-style', styleId: style.id, expectedSha256: pr.manifestSha256, patch };
+      if (style.project) body.project = style.project;
+      snap = await postEdit(body);
+      ui.editing = null;
+      ui.notice = { id: 'style:' + (style.project || '') + ':' + style.id,
+        text: r.assets
+          ? 'Saved. The request for ' + r.assets + (r.assets === 1 ? ' asset' : ' assets') + ' changed' + (r.cost ? ' \u2014 about ' + r.cost + ' to regenerate.' : '.') + ' Nothing is spent until you generate.'
+          : 'Saved. Recorded in the manifest; no request changed.' };
+      render();
+    } catch (err) {
+      save.disabled = false;
+      msg.className = 'msg bad';
+      msg.textContent = err.message + (err.status === 409 ? ' \u2014 press Refresh.' : '');
+    }
+  };
+  setTimeout(() => prefix.focus(), 0);
+  return form;
+}
+
 function addAssetForm(style) {
   const pr = snap.workspace ? snap.workspace.projects.find((x) => x.id === style.project) : snap.project;
   const siblings = snap.styles.filter((x) => x.project === style.project);
@@ -10352,7 +10560,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 readFile15(asset.path);
+          const bytes = await readFile16(asset.path);
           res.writeHead(200, {
             "Content-Type": asset.contentType,
             "Cache-Control": "no-store",
@@ -10401,7 +10609,7 @@ async function serveGallery(opts) {
         if (!asset) return fail(404, "no such gallery media");
         let bytes;
         try {
-          bytes = await readFile15(asset.path);
+          bytes = await readFile16(asset.path);
         } catch {
           return fail(404, "gallery media is no longer on disk; refresh the page");
         }
@@ -10691,7 +10899,7 @@ function createGenerateHandlers(opts) {
 }
 
 // src/pipeline/salvage.ts
-import { readFile as readFile16 } from "fs/promises";
+import { readFile as readFile17 } from "fs/promises";
 import { existsSync as existsSync17 } from "fs";
 import path21 from "path";
 function providerClaimId(provider, objectId) {
@@ -10703,7 +10911,7 @@ async function loadClaims(lockPaths, opts = {}) {
     if (!existsSync17(p)) throw new Error(`Claim lockfile not found: ${p}`);
     let parsed;
     try {
-      parsed = parseLock(JSON.parse(await readFile16(p, "utf8")));
+      parsed = parseLock(JSON.parse(await readFile17(p, "utf8")));
     } catch {
       throw new Error(`Claim lockfile is malformed: ${p}`);
     }
@@ -10984,7 +11192,7 @@ async function workspaceStatus(ws, dir) {
 
 // src/pipeline/cache-health.ts
 import { existsSync as existsSync18 } from "fs";
-import { readFile as readFile17, readdir as readdir2, rm as rm8 } from "fs/promises";
+import { readFile as readFile18, readdir as readdir2, rm as rm8 } from "fs/promises";
 import path22 from "path";
 async function inspectCaches(lock, lockPath, options = {}) {
   if (options.prune && !existsSync18(lockPath)) {
@@ -11014,7 +11222,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 readFile17(remotePath, "utf8")));
+      const cache = parseCache(JSON.parse(await readFile18(remotePath, "utf8")));
       for (const id of remoteHashes.invalidIds) delete cache.hashes[id];
       removed.remoteHashEntries = remoteHashes.invalidIds.length;
       await saveCache(remotePath, cache);
@@ -11058,7 +11266,7 @@ async function inspectContentCache(contentDir, referenced) {
     const expected = mediaType ? entry.name.slice(0, -4) : "";
     let bytes;
     try {
-      bytes = await readFile17(file);
+      bytes = await readFile18(file);
       report.bytes += bytes.length;
     } catch (err) {
       report.invalid.push({
@@ -11105,7 +11313,7 @@ async function inspectRemoteHashCache(remotePath) {
   if (!report.exists) return report;
   let cache;
   try {
-    cache = parseCache(JSON.parse(await readFile17(remotePath, "utf8")));
+    cache = parseCache(JSON.parse(await readFile18(remotePath, "utf8")));
   } catch (err) {
     report.error = err instanceof Error ? err.message : String(err);
     return report;
@@ -11376,7 +11584,7 @@ function isRecord2(value) {
 }
 
 // src/pick/salvage-server.ts
-import { mkdir as mkdir6, writeFile as writeFile9, readFile as readFile18 } from "fs/promises";
+import { mkdir as mkdir6, writeFile as writeFile9, readFile as readFile19 } from "fs/promises";
 import path23 from "path";
 
 // src/pick/salvage-sheet.ts
@@ -11629,7 +11837,7 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
         }
       }
       await applyTags(provider, decisions, existingTags, { onProgress: log2 });
-      const raw = JSON.parse(await readFile18(ctx.manifestPath, "utf8"));
+      const raw = JSON.parse(await readFile19(ctx.manifestPath, "utf8"));
       for (const id of importedAssetIds) raw.assets[id] = ctx.manifest.assets[id];
       await writeFile9(ctx.manifestPath, JSON.stringify(raw, null, 2) + "\n");
       await saveLock(ctx.lockPath, ctx.lock);
@@ -11641,7 +11849,7 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
 // src/recipes.ts
 import path24 from "path";
 import { existsSync as existsSync19 } from "fs";
-import { readdir as readdir3, readFile as readFile19 } from "fs/promises";
+import { readdir as readdir3, readFile as readFile20 } from "fs/promises";
 import { fileURLToPath } from "url";
 import { z as z7 } from "zod";
 var SHA256_RE = /^[0-9a-f]{64}$/;
@@ -11829,7 +12037,7 @@ async function readRecipeFile(recipePath, bundled) {
   const absolute = path24.resolve(recipePath);
   let raw;
   try {
-    raw = JSON.parse(await readFile19(absolute, "utf8"));
+    raw = JSON.parse(await readFile20(absolute, "utf8"));
   } catch (error) {
     throw new Error(`Could not read recipe ${absolute}: ${message4(error)}`, { cause: error });
   }
@@ -11971,12 +12179,12 @@ async function installRecipe(target, options = {}) {
   ];
   const files = await Promise.all(sources.map(async (file) => ({
     path: path24.join(destination, ...file.path.split("/")),
-    data: await readFile19(file.source)
+    data: await readFile20(file.source)
   })));
   if (!options.force) {
     for (const file of files) {
       if (!existsSync19(file.path)) continue;
-      const current = await readFile19(file.path);
+      const current = await readFile20(file.path);
       if (!current.equals(file.data)) {
         throw new Error(
           `Recipe destination has local changes: ${file.path}. Choose another --out or pass --force to replace declared recipe files.`
@@ -12001,7 +12209,7 @@ async function installRecipe(target, options = {}) {
 // src/pipeline/quality-regression.ts
 import path25 from "path";
 import { existsSync as existsSync20 } from "fs";
-import { readFile as readFile20 } from "fs/promises";
+import { readFile as readFile21 } from "fs/promises";
 import { z as z8 } from "zod";
 var SHA256_RE2 = /^[0-9a-f]{64}$/;
 var HEX_RE = /^#[0-9a-f]{6}$/;
@@ -12157,7 +12365,7 @@ async function measureImageQuality(file) {
   const absolute = path25.resolve(file);
   let bytes;
   try {
-    bytes = await readFile20(absolute);
+    bytes = await readFile21(absolute);
   } catch (error) {
     throw new Error(`Cannot read quality image ${absolute}: ${message5(error)}`, { cause: error });
   }
@@ -12244,7 +12452,7 @@ async function snapshotQualityBaseline(inputs, baselinePath, options = {}) {
   });
   const data = Buffer.from(JSON.stringify(baseline, null, 2) + "\n");
   if (existsSync20(absolute) && !options.force) {
-    const current = await readFile20(absolute);
+    const current = await readFile21(absolute);
     if (!current.equals(data)) {
       throw new Error(`Quality baseline already exists with different content: ${absolute}. Pass --force to replace it.`);
     }
@@ -12256,7 +12464,7 @@ async function readQualityBaseline(baselinePath) {
   const absolute = path25.resolve(baselinePath);
   let raw;
   try {
-    raw = JSON.parse(await readFile20(absolute, "utf8"));
+    raw = JSON.parse(await readFile21(absolute, "utf8"));
   } catch (error) {
     throw new Error(`Could not read quality baseline ${absolute}: ${message5(error)}`, { cause: error });
   }
@@ -13054,7 +13262,7 @@ async function main() {
   }
   if (args.command === "--version" || args.command === "-v") {
     const pkg = JSON.parse(
-      await readFile21(new URL("../package.json", import.meta.url), "utf8")
+      await readFile22(new URL("../package.json", import.meta.url), "utf8")
     );
     log(`${pkg.name} ${pkg.version}`);
     return;
@@ -13065,7 +13273,7 @@ async function main() {
       if (!args.out) throw new Error("quality snapshot needs --out <pixelkiln.quality.json>.");
       let raw;
       try {
-        raw = JSON.parse(await readFile21(path26.resolve(args.inputs), "utf8"));
+        raw = JSON.parse(await readFile22(path26.resolve(args.inputs), "utf8"));
       } catch (error) {
         throw new Error(
           `Could not read quality inputs ${path26.resolve(args.inputs)}: ${error instanceof Error ? error.message : String(error)}`,
@@ -13356,7 +13564,7 @@ async function main() {
     if (args.primaryOnly || args.outputRoles.length) {
       throw new Error("--primary-only and --output-role require manifest-driven pack");
     }
-    const raw = JSON.parse(await readFile21(path26.resolve(args.inputs), "utf8"));
+    const raw = JSON.parse(await readFile22(path26.resolve(args.inputs), "utf8"));
     const inputs = resolvePackInputs(raw, args.inputs);
     const { png, atlas, skipped, sources } = packSprites(inputs, { columns: args.columns });
     const base = path26.resolve(args.out.replace(/\.png$/, ""));