pixelkiln 0.22.0 → 0.24.0

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import path26 from "path";
-import { existsSync as existsSync21 } from "fs";
+import path28 from "path";
+import { existsSync as existsSync22 } from "fs";
 import { readFile as readFile22 } from "fs/promises";
 
 // src/env.ts
@@ -134,10 +134,10 @@ import { createReadStream } from "fs";
 function sha256(data) {
   return createHash("sha256").update(data).digest("hex");
 }
-async function sha256File(path27) {
+async function sha256File(path29) {
   return new Promise((resolve, reject) => {
     const hash = createHash("sha256");
-    const stream = createReadStream(path27);
+    const stream = createReadStream(path29);
     stream.on("data", (chunk2) => hash.update(chunk2));
     stream.on("error", reject);
     stream.on("end", () => resolve(hash.digest("hex")));
@@ -1617,11 +1617,11 @@ var PixelLabClient = class {
    * common than the failure mode of retrying (a duplicate object), and a
    * duplicate is visible and free to delete whereas a silent gap is neither.
    */
-  async request(path27, init, attempt = 0) {
+  async request(path29, init, attempt = 0) {
     const auth = this.apiKey.startsWith("Bearer ") ? this.apiKey : `Bearer ${this.apiKey}`;
     let res;
     try {
-      res = await fetch(`${BASE}${path27}`, {
+      res = await fetch(`${BASE}${path29}`, {
         ...init,
         signal: init?.signal ?? AbortSignal.timeout(this.timeoutMs),
         headers: {
@@ -1633,24 +1633,24 @@ var PixelLabClient = class {
     } catch (err) {
       if (attempt < MAX_RETRIES) {
         await sleep(backoffMs(attempt));
-        return this.request(path27, init, attempt + 1);
+        return this.request(path29, init, attempt + 1);
       }
       throw err;
     }
     if (!res.ok && shouldRetry(res.status) && attempt < MAX_RETRIES) {
       const waitMs = retryAfterMs(res.headers.get("retry-after")) ?? backoffMs(attempt);
       await sleep(waitMs);
-      return this.request(path27, init, attempt + 1);
+      return this.request(path29, init, attempt + 1);
     }
     const text = await res.text();
     if (!res.ok) {
-      throw new PixelLabError(`${init?.method ?? "GET"} ${path27} \u2192 ${res.status}`, res.status, text);
+      throw new PixelLabError(`${init?.method ?? "GET"} ${path29} \u2192 ${res.status}`, res.status, text);
     }
     if (!text) return {};
     try {
       return JSON.parse(text);
     } catch {
-      throw new Error(`${init?.method ?? "GET"} ${path27} returned invalid JSON`);
+      throw new Error(`${init?.method ?? "GET"} ${path29} returned invalid JSON`);
     }
   }
   async balance() {
@@ -2112,6 +2112,15 @@ var AssetSchema = z2.object({
    * that wasn't. `prompt` still records what was asked for.
    */
   source: z2.string().optional(),
+  /**
+   * Per-style replacement for `source`, keyed by style id.
+   *
+   * A hand edit belongs to one generation: the same asset generated in two
+   * styles is two different pictures, so the touch-up of one must not be
+   * placed for the other. `pixelkiln edit` writes here when an asset is in
+   * more than one style, and to `source` when it is in exactly one.
+   */
+  sourceByStyle: z2.record(z2.string().min(1)).default({}),
   /** Controlled generation derived from another asset in the same style. */
   revision: RevisionSchema.optional(),
   /**
@@ -2146,7 +2155,7 @@ var AssetSchema = z2.object({
     z2.array(z2.union([z2.string(), z2.number().finite(), z2.boolean()])).min(2).max(64)
   ])).default({})
 }).strict().superRefine((asset, context) => {
-  if (asset.source && asset.revision) {
+  if ((asset.source || Object.keys(asset.sourceByStyle).length) && asset.revision) {
     context.addIssue({
       code: z2.ZodIssueCode.custom,
       message: "source and revision are mutually exclusive",
@@ -2613,9 +2622,9 @@ var RetroDiffusionClient = class {
     }
     return balance;
   }
-  async call(path27, init = {}) {
+  async call(path29, init = {}) {
     if (!this.token) throw new Error("RD_API_KEY is not set");
-    const response = await this.request(`${this.baseUrl}${path27}`, {
+    const response = await this.request(`${this.baseUrl}${path29}`, {
       ...init,
       headers: {
         "Content-Type": "application/json",
@@ -3784,6 +3793,11 @@ ${issues}`);
         unknownReferences.push(`assets.${assetId}.promptByStyle: unknown style "${styleId}"`);
       }
     }
+    for (const styleId of Object.keys(asset.sourceByStyle)) {
+      if (!styleIds.has(styleId)) {
+        unknownReferences.push(`assets.${assetId}.sourceByStyle: unknown style "${styleId}"`);
+      }
+    }
     if (asset.revision) {
       if (!parsed.data.assets[asset.revision.from]) {
         unknownReferences.push(
@@ -4048,7 +4062,7 @@ async function resolveSpecs(loaded, filter) {
           }
         } : {},
         tags,
-        source: asset.source,
+        source: asset.sourceByStyle[styleId] ?? asset.source,
         // Revision identity is attached after every dependency in this style
         // has a concrete output target. Finalization below computes the hash.
         specHash: ""
@@ -4306,16 +4320,24 @@ function packStyle(lock, styleId, manifestDir, options = {}) {
   }
   const prefix = `${styleId}/`;
   const entries = Object.entries(lock.entries).filter(([key]) => key.startsWith(prefix));
-  if (!entries.length) {
+  const sources = options.sources ?? {};
+  if (!entries.length && !Object.keys(sources).length) {
     throw new Error(
       `No locked assets for style "${styleId}". Run \`pixelkiln gen --style ${styleId}\` first.`
     );
   }
   const inputs = [];
   const noOutput = [];
+  const locked = /* @__PURE__ */ new Set();
   for (const [key, entry] of entries) {
     const id = key.slice(prefix.length);
+    locked.add(id);
     const outputs = resolveEntryOutputs(entry, id, manifestDir);
+    const source = sources[id];
+    if (source && outputs.length <= 1) {
+      inputs.push({ id, path: path7.resolve(manifestDir, source) });
+      continue;
+    }
     let selected = outputs;
     if (options.outputRoles?.length) {
       selected = outputs.filter(
@@ -4332,6 +4354,9 @@ function packStyle(lock, styleId, manifestDir, options = {}) {
     }
     for (const output of selected) inputs.push({ id: output.id, path: output.absolutePath });
   }
+  for (const [id, source] of Object.entries(sources)) {
+    if (!locked.has(id)) inputs.push({ id, path: path7.resolve(manifestDir, source) });
+  }
   if (!inputs.length) {
     throw new Error(`No readable sprites for style "${styleId}" \u2014 ${noOutput.length} skipped.`);
   }
@@ -6821,10 +6846,10 @@ function isSha256Hash(value) {
 function parseCache(value) {
   return HashCacheSchema.parse(value);
 }
-async function loadCache(path27) {
-  if (!existsSync11(path27)) return { version: 1, hashes: {} };
+async function loadCache(path29) {
+  if (!existsSync11(path29)) return { version: 1, hashes: {} };
   try {
-    const parsed = HashCacheSchema.safeParse(JSON.parse(await readFile8(path27, "utf8")));
+    const parsed = HashCacheSchema.safeParse(JSON.parse(await readFile8(path29, "utf8")));
     if (!parsed.success) return { version: 1, hashes: {} };
     return {
       version: 1,
@@ -6836,18 +6861,18 @@ async function loadCache(path27) {
     return { version: 1, hashes: {} };
   }
 }
-async function saveCache(path27, cache) {
+async function saveCache(path29, cache) {
   const sorted = {};
   for (const key of Object.keys(cache.hashes).sort()) {
     const hash = cache.hashes[key];
     if (!isSha256Hash(hash)) throw new Error(`Refusing to cache invalid SHA-256 for ${key}`);
     sorted[key] = hash;
   }
-  await mkdir4(pathModule.dirname(pathModule.resolve(path27)), { recursive: true });
-  const tmp = `${path27}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
+  await mkdir4(pathModule.dirname(pathModule.resolve(path29)), { recursive: true });
+  const tmp = `${path29}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
   try {
     await writeFile4(tmp, JSON.stringify({ version: 1, hashes: sorted }, null, 2) + "\n");
-    await rename4(tmp, path27);
+    await rename4(tmp, path29);
   } finally {
     await rm5(tmp, { force: true });
   }
@@ -7096,6 +7121,7 @@ function buildManifest(name, styleId, generator, outDir, scanned) {
     assets[asset.id] = {
       prompt: "",
       promptByStyle: {},
+      sourceByStyle: {},
       category: asset.category || void 0,
       file: asset.file,
       tags: [],
@@ -7789,9 +7815,9 @@ async function runPicker(provider, lock, lockPath, opts = {}) {
 
 // src/gallery/snapshot.ts
 import { createHash as createHash3 } from "crypto";
-import { existsSync as existsSync16 } from "fs";
+import { existsSync as existsSync17 } from "fs";
 import { readFile as readFile15, stat as stat3 } from "fs/promises";
-import path20 from "path";
+import path22 from "path";
 
 // src/workspace.ts
 import { mkdir as mkdir5, readFile as readFile13, rename as rename5, rm as rm6, writeFile as writeFile7 } from "fs/promises";
@@ -7927,6 +7953,10 @@ function validateWorkspace(ws, dir) {
 }
 
 // src/gallery/edit.ts
+import path21 from "path";
+import { z as z6 } from "zod";
+
+// src/manifest-edit.ts
 import { readFile as readFile14, rename as rename6, rm as rm7, writeFile as writeFile8 } from "fs/promises";
 import path19 from "path";
 import { z as z5 } from "zod";
@@ -7973,6 +8003,22 @@ var ManifestEditSchema = z5.discriminatedUnion("action", [
     expectedSha256: HexSha,
     asset: NewAssetSchema
   }).strict(),
+  z5.object({
+    action: z5.literal("set-source"),
+    project: z5.string().min(1).optional(),
+    assetId: z5.string().min(1),
+    styleId: z5.string().min(1),
+    /** Manifest-relative path of the art that stands in for this asset in this style. */
+    source: z5.string().min(1),
+    expectedSha256: HexSha
+  }).strict(),
+  z5.object({
+    action: z5.literal("clear-source"),
+    project: z5.string().min(1).optional(),
+    assetId: z5.string().min(1),
+    styleId: z5.string().min(1),
+    expectedSha256: HexSha
+  }).strict(),
   z5.object({
     action: z5.literal("patch-style"),
     project: z5.string().min(1).optional(),
@@ -7985,7 +8031,11 @@ var ManifestEditSchema = z5.discriminatedUnion("action", [
       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()
+      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()
 ]);
@@ -8019,8 +8069,38 @@ function setOrDelete(target, key, value) {
   if (value === null || value === void 0) delete target[key];
   else target[key] = value;
 }
+function assetStyles(raw, asset) {
+  const own = Array.isArray(asset.styles) ? asset.styles : [];
+  return own.length ? own : Object.keys(raw.styles ?? {});
+}
 function applyEdit(raw, edit) {
   raw.assets ??= {};
+  if (edit.action === "set-source" || edit.action === "clear-source") {
+    const asset2 = Object.hasOwn(raw.assets, edit.assetId) ? raw.assets[edit.assetId] : void 0;
+    if (!asset2) throw new ManifestEditError(`asset "${edit.assetId}" is not declared by the manifest`);
+    if (!raw.styles || !Object.hasOwn(raw.styles, edit.styleId)) {
+      throw new ManifestEditError(`unknown style "${edit.styleId}"`);
+    }
+    if (!assetStyles(raw, asset2).includes(edit.styleId)) {
+      throw new ManifestEditError(`asset "${edit.assetId}" is not in style "${edit.styleId}"`);
+    }
+    const single = assetStyles(raw, asset2).length === 1;
+    const byStyle = { ...asset2.sourceByStyle ?? {} };
+    if (edit.action === "set-source") {
+      if (single) {
+        asset2.source = edit.source;
+        delete byStyle[edit.styleId];
+      } else {
+        byStyle[edit.styleId] = edit.source;
+      }
+    } else {
+      delete byStyle[edit.styleId];
+      if (single) delete asset2.source;
+    }
+    if (Object.keys(byStyle).length) asset2.sourceByStyle = byStyle;
+    else delete asset2.sourceByStyle;
+    return;
+  }
   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`);
@@ -8043,6 +8123,8 @@ function applyEdit(raw, edit) {
       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") {
@@ -8122,10 +8204,134 @@ async function applyManifestEdit(manifestPath, edit) {
   }
   return { manifestPath: absolute, sha256: sha256(next), changed: true };
 }
+
+// src/pipeline/hand-edit.ts
+import { spawn as spawn2 } from "child_process";
+import { existsSync as existsSync16 } from "fs";
+import { copyFile, mkdir as mkdir6 } from "fs/promises";
+import path20 from "path";
+var HAND_EDIT_DIR = "edits";
+function handEditPath(loaded, spec) {
+  const style = loaded.manifest.styles[spec.styleId];
+  const outDir = path20.resolve(loaded.root, style?.outDir ?? ".");
+  const relative = path20.relative(outDir, spec.outFile);
+  const inside = relative && !relative.startsWith("..") && !path20.isAbsolute(relative);
+  const file = inside ? relative : path20.basename(spec.outFile);
+  return path20.join(outDir, HAND_EDIT_DIR, file.replace(/\.gif$/i, ".png"));
+}
+function handEditBase(spec, lock) {
+  const entry = lock.entries[lockKey(spec.styleId, spec.assetId)];
+  if (entry) {
+    if (entry.outputs.length !== 1) return null;
+    const primary = primaryOutput(entry);
+    if (!primary || primary.mediaType && primary.mediaType !== "image/png") return null;
+    const file = currentEntryOutputPath(entry, spec, 0);
+    return existsSync16(file) ? file : null;
+  }
+  return existsSync16(spec.outFile) ? spec.outFile : null;
+}
+async function startHandEdit(loaded, lock, spec, opts = {}) {
+  const entry = lock.entries[lockKey(spec.styleId, spec.assetId)];
+  if (entry && entry.outputs.length > 1) {
+    throw new ManifestEditError(
+      `${spec.styleId}/${spec.assetId} has ${entry.outputs.length} outputs; hand edits currently cover single-image assets`
+    );
+  }
+  const existing = spec.source ? path20.resolve(loaded.root, spec.source) : null;
+  const editPath = existing ?? handEditPath(loaded, spec);
+  let created = false;
+  if (!existsSync16(editPath)) {
+    const base = handEditBase(spec, lock);
+    if (!base) {
+      throw new ManifestEditError(
+        `${spec.styleId}/${spec.assetId} has no generated PNG on disk to start from; generate or restore it first`
+      );
+    }
+    await mkdir6(path20.dirname(editPath), { recursive: true });
+    await copyFile(base, editPath);
+    created = true;
+  }
+  const source = portableOutputPath(editPath, loaded.root);
+  let declared = false;
+  let manifestSha256 = opts.expectedSha256 ?? await sha256File(loaded.path);
+  if (spec.source !== source) {
+    const result = await applyManifestEdit(loaded.path, {
+      action: "set-source",
+      assetId: spec.assetId,
+      styleId: spec.styleId,
+      source,
+      expectedSha256: manifestSha256
+    });
+    declared = result.changed;
+    manifestSha256 = result.sha256;
+  }
+  return { editPath, source, created, declared, manifestSha256 };
+}
+async function detachHandEdit(loaded, spec, opts = {}) {
+  if (!spec.source) {
+    return { manifestSha256: opts.expectedSha256 ?? await sha256File(loaded.path), changed: false };
+  }
+  const result = await applyManifestEdit(loaded.path, {
+    action: "clear-source",
+    assetId: spec.assetId,
+    styleId: spec.styleId,
+    expectedSha256: opts.expectedSha256 ?? await sha256File(loaded.path)
+  });
+  return { manifestSha256: result.sha256, changed: result.changed };
+}
+function openInEditor(file, editor = process.env.PIXELKILN_EDITOR) {
+  const command = editor?.trim() ? editor.trim().split(/\s+/) : process.platform === "darwin" ? ["open"] : process.platform === "win32" ? ["cmd", "/c", "start", ""] : ["xdg-open"];
+  const [program, ...args] = command;
+  const child = spawn2(program, [...args, file], { stdio: "ignore", detached: true });
+  child.on("error", () => {
+  });
+  child.unref();
+  return command.join(" ");
+}
+
+// src/gallery/edit.ts
+var HandEditRequestSchema = z6.discriminatedUnion("action", [
+  z6.object({
+    action: z6.literal("start-edit"),
+    project: z6.string().min(1).optional(),
+    assetId: z6.string().min(1),
+    styleId: z6.string().min(1),
+    expectedSha256: z6.string().regex(/^[0-9a-f]{64}$/),
+    /** Also launch the author's editor on the file. */
+    open: z6.boolean().optional()
+  }).strict(),
+  z6.object({
+    action: z6.literal("detach-edit"),
+    project: z6.string().min(1).optional(),
+    assetId: z6.string().min(1),
+    styleId: z6.string().min(1),
+    expectedSha256: z6.string().regex(/^[0-9a-f]{64}$/)
+  }).strict()
+]);
 function createGalleryEditHandler(opts) {
   const log2 = opts.onProgress ?? (() => {
   });
   return async (body) => {
+    const handEdit = HandEditRequestSchema.safeParse(body);
+    if (handEdit.success) {
+      if (!opts.loadProject) throw new ManifestEditError("hand edits are not available in this gallery");
+      const request = handEdit.data;
+      const ctx = await opts.loadProject(request.project);
+      const spec = ctx.specs.find((candidate) => lockKey(candidate.styleId, candidate.assetId) === lockKey(request.styleId, request.assetId));
+      if (!spec) throw new ManifestEditError(`"${request.styleId}/${request.assetId}" is not declared by the manifest`);
+      if (request.action === "start-edit") {
+        const started = await startHandEdit(ctx.loaded, ctx.lock, spec, { expectedSha256: request.expectedSha256 });
+        log2(`  hand edit ${started.created ? "created" : "found"}: ${started.source}${started.declared ? " (declared in the manifest)" : ""}`);
+        if (request.open) {
+          const command = (opts.openEditor ?? openInEditor)(started.editPath);
+          log2(`  opened with: ${command}`);
+        }
+      } else {
+        const result2 = await detachHandEdit(ctx.loaded, spec, { expectedSha256: request.expectedSha256 });
+        if (result2.changed) log2(`  hand edit detached: ${request.styleId}/${request.assetId} (file kept)`);
+      }
+      return opts.reload();
+    }
     const parsed = ManifestEditSchema.safeParse(body);
     if (!parsed.success) {
       throw new ManifestEditError(
@@ -8140,9 +8346,9 @@ function createGalleryEditHandler(opts) {
     }
     const result = await applyManifestEdit(manifestPath, parsed.data);
     if (result.changed) {
-      const relative = path19.relative(process.cwd(), result.manifestPath);
+      const relative = path21.relative(process.cwd(), result.manifestPath);
       const shown = !relative || relative.startsWith("..") ? result.manifestPath : relative;
-      const subject = parsed.data.action === "patch-style" ? `style ${parsed.data.styleId}` : parsed.data.assetId;
+      const subject = parsed.data.action === "patch-style" ? `style ${parsed.data.styleId}` : parsed.data.action === "set-source" || parsed.data.action === "clear-source" ? `${parsed.data.styleId}/${parsed.data.assetId} source` : parsed.data.assetId;
       log2(`  manifest edited: ${parsed.data.action === "add-asset" ? "added" : "changed"} ${subject} in ${shown}`);
     }
     return opts.reload();
@@ -8151,7 +8357,7 @@ function createGalleryEditHandler(opts) {
 
 // src/gallery/snapshot.ts
 function galleryMediaId(absolutePath) {
-  return createHash3("sha256").update(path20.resolve(absolutePath)).digest("hex").slice(0, 24);
+  return createHash3("sha256").update(path22.resolve(absolutePath)).digest("hex").slice(0, 24);
 }
 function galleryMediaRoute(id) {
   return `/media/${id}`;
@@ -8176,23 +8382,24 @@ function metadataFps(entry) {
   }
   return null;
 }
-async function fileBytes(absolutePath) {
+async function fileInfo(absolutePath) {
   try {
     const info = await stat3(absolutePath);
-    return info.isFile() ? info.size : null;
+    return info.isFile() ? { bytes: info.size, modifiedAt: info.mtime.toISOString() } : null;
   } catch {
     return null;
   }
 }
 async function describeOutput(media, root, absolutePath, recorded = {}) {
-  const bytes = await fileBytes(absolutePath);
-  const exists = bytes !== null;
+  const info = await fileInfo(absolutePath);
+  const exists = info !== null;
   const mediaType = recorded.mediaType ?? mediaTypeFromExtension(absolutePath);
   let url = null;
   if (exists && mediaType) {
     const id = galleryMediaId(absolutePath);
     media.set(id, { path: absolutePath, contentType: mediaType });
-    url = `${galleryMediaRoute(id)}?v=${(recorded.sha256 ?? String(bytes)).slice(0, 16)}`;
+    const version = recorded.sha256 ?? `${info.bytes}-${Date.parse(info.modifiedAt).toString(36)}`;
+    url = `${galleryMediaRoute(id)}?v=${version.slice(0, 24)}`;
   }
   return {
     path: portableOutputPath(absolutePath, root),
@@ -8201,17 +8408,18 @@ async function describeOutput(media, root, absolutePath, recorded = {}) {
     role: recorded.role ?? null,
     mediaType,
     exists,
-    bytes,
+    bytes: info?.bytes ?? null,
+    modifiedAt: info?.modifiedAt ?? null,
     url
   };
 }
 async function describeQuality(media, root, inspection) {
   const outputPaths = inspection.outputs ?? [inspection.output];
   const outputs = await Promise.all(
-    outputPaths.map((file) => describeOutput(media, root, path20.resolve(root, file)))
+    outputPaths.map((file) => describeOutput(media, root, path22.resolve(root, file)))
   );
-  const recordPath = path20.resolve(root, inspection.record);
-  const recordExists = existsSync16(recordPath);
+  const recordPath = path22.resolve(root, inspection.record);
+  const recordExists = existsSync17(recordPath);
   let options = null;
   let check = null;
   if (recordExists) {
@@ -8230,7 +8438,7 @@ async function describeQuality(media, root, inspection) {
   return {
     state: inspection.state,
     reason: inspection.reason,
-    output: portableOutputPath(path20.resolve(root, inspection.output), root),
+    output: portableOutputPath(path22.resolve(root, inspection.output), root),
     record: portableOutputPath(recordPath, root),
     recordExists,
     outputs,
@@ -8280,15 +8488,24 @@ async function buildGallerySnapshot(opts) {
     const entry = lock.entries[key];
     const asset = loaded.manifest.assets[spec.assetId] ?? null;
     let outputs;
+    let edit = null;
+    let editStatus = null;
     if (entry && entry.outputs.length) {
       outputs = await Promise.all(
         entry.outputs.map(
           (output, index) => describeOutput(media, root, currentEntryOutputPath(entry, spec, index), output)
         )
       );
+      if (spec.source) {
+        const editPath = path22.resolve(root, spec.source);
+        const editSha = existsSync17(editPath) ? await sha256File(editPath) : null;
+        edit = await describeOutput(media, root, editPath, { sha256: editSha });
+        const generated = outputs[0];
+        editStatus = !edit.exists ? "missing" : generated && editSha === generated.sha256 ? "same" : generated?.modifiedAt && edit.modifiedAt && generated.modifiedAt > edit.modifiedAt && generated.exists ? "regenerated-since" : "edited";
+      }
     } else if (spec.source) {
-      outputs = [await describeOutput(media, root, path20.resolve(root, spec.source))];
-    } else if (!entry && existsSync16(spec.outFile)) {
+      outputs = [await describeOutput(media, root, path22.resolve(root, spec.source))];
+    } else if (!entry && existsSync17(spec.outFile)) {
       outputs = [await describeOutput(media, root, spec.outFile)];
     } else {
       outputs = [];
@@ -8332,6 +8549,8 @@ async function buildGallerySnapshot(opts) {
       providerMetadata: entry?.providerMetadata ?? {},
       asset,
       source: spec.source ?? null,
+      edit,
+      editStatus,
       tags: spec.tags,
       category: asset?.category ?? null
     });
@@ -8384,6 +8603,8 @@ async function buildGallerySnapshot(opts) {
       providerMetadata: entry.providerMetadata ?? {},
       asset: null,
       source: null,
+      edit: null,
+      editStatus: null,
       tags: [],
       category: null
     });
@@ -8422,6 +8643,8 @@ async function buildGallerySnapshot(opts) {
       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,
@@ -8449,7 +8672,7 @@ async function buildGallerySnapshot(opts) {
       id: loaded.manifest.name,
       name: loaded.manifest.name,
       manifest: loaded.path,
-      lock: path20.resolve(opts.lockPath),
+      lock: path22.resolve(opts.lockPath),
       root,
       provider: loaded.manifest.provider,
       account: null,
@@ -8474,7 +8697,7 @@ async function buildGallerySnapshot(opts) {
   return { snapshot, media };
 }
 async function buildWorkspaceGallerySnapshot(opts) {
-  const dir = path20.dirname(path20.resolve(opts.workspacePath));
+  const dir = path22.dirname(path22.resolve(opts.workspacePath));
   const media = /* @__PURE__ */ new Map();
   const projects = [];
   const items = [];
@@ -8517,7 +8740,7 @@ async function buildWorkspaceGallerySnapshot(opts) {
         id: project.id,
         name: loaded.manifest.name,
         manifest: manifestPath,
-        lock: path20.resolve(lockPath),
+        lock: path22.resolve(lockPath),
         root: loaded.root,
         provider: loaded.manifest.provider,
         account: project.account ?? null,
@@ -8532,8 +8755,8 @@ async function buildWorkspaceGallerySnapshot(opts) {
         id: project.id,
         name: project.id,
         manifest: manifestPath,
-        lock: path20.resolve(lockPath),
-        root: path20.dirname(manifestPath),
+        lock: path22.resolve(lockPath),
+        root: path22.dirname(manifestPath),
         provider: project.provider,
         account: project.account ?? null,
         manifestSha256: null,
@@ -8559,7 +8782,7 @@ async function buildWorkspaceGallerySnapshot(opts) {
       version: 1,
       generatedAt: (opts.now ?? (() => /* @__PURE__ */ new Date()))().toISOString(),
       project: null,
-      workspace: { path: path20.resolve(opts.workspacePath), dir, projects },
+      workspace: { path: path22.resolve(opts.workspacePath), dir, projects },
       filter,
       totals: {
         entries: projects.reduce((sum, project) => sum + project.entries, 0),
@@ -8576,7 +8799,7 @@ async function buildWorkspaceGallerySnapshot(opts) {
 }
 
 // src/gallery/server.ts
-import { spawn as spawn2 } from "child_process";
+import { spawn as spawn3 } from "child_process";
 import { randomBytes } from "crypto";
 import { createServer as createServer2 } from "http";
 import { readFile as readFile16 } from "fs/promises";
@@ -8852,6 +9075,14 @@ function renderGallery(snapshot, opts = {}) {
   .tray > button { padding:5px 11px; font-size:12.5px; }
   @media (max-width: 900px) { .sheet.review-host, .sheet.compare-host { width:100vw; } }
   .drawer .gen { display:flex; gap:8px; flex-wrap:wrap; margin-top:12px; }
+  .pair { display:grid; grid-template-columns:1fr 1fr; gap:8px; margin:8px 0 10px; }
+  .pair figure { margin:0; border:1px solid var(--line); background:var(--panel-deep); background-image:var(--checker);
+    background-size:12px 12px; background-position:0 0,6px 6px; display:grid; place-items:center; padding:8px; min-height:96px; }
+  .pair figure img { image-rendering:pixelated; display:block; max-width:100%; }
+  .pair figcaption { font:11px/1.4 var(--mono); color:var(--dim); background:var(--panel); padding:2px 6px; margin-top:6px; }
+  .card .pen { position:absolute; right:6px; top:6px; background:var(--panel); color:var(--accent-soft); border:1px solid var(--accent);
+    font:700 11px/1 var(--mono); padding:3px 5px; }
+  .hand-actions { display:flex; gap:8px; flex-wrap:wrap; margin-top:8px; }
   .drawer .gen button.primary { padding:7px 14px; }
   @media (max-width: 720px) {
     .bar, .totals, .chips, .style, footer { padding-inline:14px; }
@@ -8902,6 +9133,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};
@@ -9297,7 +9529,8 @@ function clearFilters() {
 
 function thumb(item) {
   const cell = el('div', 'cell');
-  const shown = item.outputs.filter((o) => o.url);
+  // A hand edit is what ships, so it is what the card shows.
+  const shown = item.edit && item.edit.url && item.editStatus === 'edited' ? [item.edit] : item.outputs.filter((o) => o.url);
   if (!shown.length) {
     cell.classList.add('none');
     cell.append(el('span', null, item.state === 'missing' ? 'not generated yet'
@@ -9348,6 +9581,9 @@ function card(item) {
   body.append(meta);
   const cell = thumb(item);
   if (slot >= 0) cell.append(el('span', 'slot', String(slot + 1)));
+  if (item.editStatus === 'edited' || item.editStatus === 'regenerated-since') {
+    const pen = el('span', 'pen', '\u270E'); pen.title = 'hand-edited'; cell.append(pen);
+  }
   c.append(cell, body);
   c.onclick = (e) => { if (e.shiftKey) toggleCompare(item.id); else openItem(item.id); };
   return c;
@@ -9674,6 +9910,78 @@ function openCompare() {
   close.focus({ preventScroll: true });
 }
 
+// ---- hand edits -------------------------------------------------------------
+
+const EDIT_STATUS_TEXT = {
+  same: 'A copy of the generated art, not changed yet. Open it in your editor and save.',
+  edited: 'Differs from the generated art. mount and pack place this file; the generated file stays as the record.',
+  'regenerated-since': 'The generated art changed after this edit was saved \u2014 the edit is based on an older generation.',
+  missing: 'The declared file is not on disk.',
+};
+async function postHandEdit(item, action, extra) {
+  const pr = projectOf(item);
+  const body = { action, assetId: item.assetId, styleId: item.styleId, expectedSha256: pr.manifestSha256, ...extra };
+  if (item.project) body.project = item.project;
+  snap = await postEdit(body);
+}
+function handEditSection(item) {
+  const canStart = EDITABLE && item.declared && item.asset && projectOf(item)?.manifestSha256 &&
+    item.outputs.length === 1 && item.outputs[0].exists && item.outputs[0].mediaType === 'image/png';
+  if (!item.edit && !canStart) return null;
+  const s = el('section', 'meta');
+  s.append(el('h3', null, 'Hand edit'));
+  if (item.edit) {
+    const pair = el('div', 'pair');
+    const shared = displayScale(item.width, item.height, 200, 160);
+    const fig = (out, label) => {
+      const f = el('figure');
+      if (out && out.url) {
+        const img = el('img'); img.src = out.url; img.alt = label;
+        if (shared >= 1) { img.width = item.width * shared; img.height = item.height * shared; }
+        f.append(img);
+      } else f.append(el('span', 'state-dim', 'not on disk'));
+      f.append(el('figcaption', null, label));
+      return f;
+    };
+    pair.append(fig(item.outputs[0], 'generated'), fig(item.edit, 'edit'));
+    s.append(pair);
+    const dl = el('dl');
+    const tone = item.editStatus === 'edited' ? 'ok' : item.editStatus === 'same' ? 'dim' : 'warn';
+    const st = el('span', 'state-' + tone); st.append(el('i', 'dot ' + tone), document.createTextNode(' ' + item.editStatus));
+    row(dl, 'status', st);
+    row(dl, 'why', EDIT_STATUS_TEXT[item.editStatus] || '');
+    row(dl, 'file', item.edit.path, { mono: true, copy: item.edit.absolutePath });
+    if (item.edit.sha256) row(dl, 'sha256', item.edit.sha256.slice(0, 16) + '\u2026', { mono: true, copy: item.edit.sha256 });
+    row(dl, 'saved', fmtWhen(item.edit.modifiedAt));
+    s.append(dl);
+  } else {
+    s.append(el('div', 'state-dim', 'Touch it up in your own editor. The generated file stays untouched; the edit is a sibling file the manifest points at, and mount and pack place that instead.'));
+  }
+  if (EDITABLE && item.declared && projectOf(item)?.manifestSha256) {
+    const acts = el('div', 'hand-actions');
+    const msg = el('span', 'msg');
+    const go = async (label, action, extra, done) => {
+      const b = el('button', label === 'Detach edit' ? null : 'primary', label); b.type = 'button';
+      b.onclick = async () => {
+        b.disabled = true; msg.className = 'msg'; msg.textContent = '\u2026';
+        try { await postHandEdit(item, action, extra); ui.notice = { id: item.id, text: done }; render(); }
+        catch (err) { b.disabled = false; msg.className = 'msg bad'; msg.textContent = err.message + (err.status === 409 ? ' \u2014 press Refresh.' : ''); }
+      };
+      acts.append(b);
+    };
+    if (item.edit) {
+      go('Open in editor', 'start-edit', { open: true }, 'Opened ' + item.edit.path + ' in your editor. Save there, then Refresh.');
+      go('Detach edit', 'detach-edit', {}, 'Detached. The file is still at ' + item.edit.path + '; the generated art is placed again.');
+    } else if (canStart) {
+      go('Edit by hand', 'start-edit', { open: true }, 'Created the edit file and opened it in your editor. Save there, then Refresh to see it here.');
+      go('Create edit file only', 'start-edit', { open: false }, 'Created the edit file and declared it in the manifest.');
+    }
+    acts.append(msg);
+    s.append(acts);
+  }
+  return s;
+}
+
 // ---- editing (only when the server minted a session) ---------------------
 
 // Styles a parent edit reaches: every descendant (via extends) that does not
@@ -9693,9 +10001,18 @@ function inheritorsOf(style, field) {
   }
   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 styleIds = new Set([style.id]);
-  for (const field of fields) for (const id of inheritorsOf(style, field)) styleIds.add(id);
+  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);
@@ -9720,6 +10037,11 @@ function styleForm(style) {
   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 = '';
@@ -9732,12 +10054,21 @@ function styleForm(style) {
     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 = () => {
@@ -9745,6 +10076,11 @@ function styleForm(style) {
     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);
@@ -9754,7 +10090,8 @@ function styleForm(style) {
       : ' 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]) input.addEventListener('input', updateBlast);
+  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');
@@ -9773,6 +10110,8 @@ function styleForm(style) {
     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 {
@@ -9781,7 +10120,9 @@ function styleForm(style) {
       snap = await postEdit(body);
       ui.editing = null;
       ui.notice = { id: 'style:' + (style.project || '') + ':' + style.id,
-        text: '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.' };
+        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;
@@ -10132,6 +10473,9 @@ function renderDrawer() {
     body.append(s);
   }
 
+  const hand = handEditSection(item);
+  if (hand) body.append(hand);
+
   if (item.revision || item.revisionParentKey) {
     const { s, dl } = section('Lineage');
     row(dl, 'mode', item.revision ? item.revision.mode : (item.asset && item.asset.revision && item.asset.revision.mode));
@@ -10599,7 +10943,7 @@ async function serveGallery(opts) {
   });
   opts.onReady?.(url);
   if (opts.open !== false && process.platform === "darwin") {
-    spawn2("open", [url], { stdio: "ignore", detached: true }).unref();
+    spawn3("open", [url], { stdio: "ignore", detached: true }).unref();
   }
   return {
     url,
@@ -10613,14 +10957,14 @@ async function serveGallery(opts) {
 
 // src/gallery/generate.ts
 import { randomBytes as randomBytes2 } from "crypto";
-import { z as z6 } from "zod";
-var GenerateRequestSchema = z6.object({
-  project: z6.string().min(1).optional(),
-  keys: z6.array(z6.string().min(1)).min(1).max(500),
+import { z as z7 } from "zod";
+var GenerateRequestSchema = z7.object({
+  project: z7.string().min(1).optional(),
+  keys: z7.array(z7.string().min(1)).min(1).max(500),
   /** Regenerate work that is up to date, as `gen --force` does. */
-  force: z6.boolean().optional(),
+  force: z7.boolean().optional(),
   /** Advance in-flight, review, or selected work without submitting anything. */
-  resume: z6.boolean().optional()
+  resume: z7.boolean().optional()
 }).strict();
 var GenerateRequestError = class extends Error {
   constructor(message6, status = 400) {
@@ -10858,15 +11202,15 @@ function createGenerateHandlers(opts) {
 
 // src/pipeline/salvage.ts
 import { readFile as readFile17 } from "fs/promises";
-import { existsSync as existsSync17 } from "fs";
-import path21 from "path";
+import { existsSync as existsSync18 } from "fs";
+import path23 from "path";
 function providerClaimId(provider, objectId) {
   return `${encodeURIComponent(provider)}:${encodeURIComponent(objectId)}`;
 }
 async function loadClaims(lockPaths, opts = {}) {
   const claimed = /* @__PURE__ */ new Set();
   for (const p of lockPaths) {
-    if (!existsSync17(p)) throw new Error(`Claim lockfile not found: ${p}`);
+    if (!existsSync18(p)) throw new Error(`Claim lockfile not found: ${p}`);
     let parsed;
     try {
       parsed = parseLock(JSON.parse(await readFile17(p, "utf8")));
@@ -10917,20 +11261,20 @@ function matchStyleByPattern(prompt, manifest) {
   return null;
 }
 async function loadSiblingManifests(ownManifestPath, workspaceManifestPaths, claimPaths) {
-  const own = path21.resolve(ownManifestPath);
+  const own = path23.resolve(ownManifestPath);
   const siblingManifestPaths = [
     .../* @__PURE__ */ new Set([
       ...workspaceManifestPaths,
-      ...claimPaths.map((c) => path21.join(path21.dirname(path21.resolve(c)), "pixelkiln.manifest.json"))
+      ...claimPaths.map((c) => path23.join(path23.dirname(path23.resolve(c)), "pixelkiln.manifest.json"))
     ])
   ];
   const siblings = [];
   for (const siblingManifestPath of siblingManifestPaths) {
-    if (path21.resolve(siblingManifestPath) === own) continue;
-    if (!existsSync17(siblingManifestPath)) continue;
+    if (path23.resolve(siblingManifestPath) === own) continue;
+    if (!existsSync18(siblingManifestPath)) continue;
     try {
       const { manifest } = await loadManifest(siblingManifestPath);
-      siblings.push({ label: path21.basename(path21.dirname(siblingManifestPath)), manifest });
+      siblings.push({ label: path23.basename(path23.dirname(siblingManifestPath)), manifest });
     } catch {
     }
   }
@@ -11149,15 +11493,15 @@ async function workspaceStatus(ws, dir) {
 }
 
 // src/pipeline/cache-health.ts
-import { existsSync as existsSync18 } from "fs";
+import { existsSync as existsSync19 } from "fs";
 import { readFile as readFile18, readdir as readdir2, rm as rm8 } from "fs/promises";
-import path22 from "path";
+import path24 from "path";
 async function inspectCaches(lock, lockPath, options = {}) {
-  if (options.prune && !existsSync18(lockPath)) {
-    throw new Error(`Refusing to prune without an existing lockfile at ${path22.resolve(lockPath)}`);
+  if (options.prune && !existsSync19(lockPath)) {
+    throw new Error(`Refusing to prune without an existing lockfile at ${path24.resolve(lockPath)}`);
   }
-  const contentDir = path22.resolve(path22.dirname(lockPath), ".pixelkiln", "cache");
-  const remotePath = path22.resolve(cachePathFor(lockPath));
+  const contentDir = path24.resolve(path24.dirname(lockPath), ".pixelkiln", "cache");
+  const remotePath = path24.resolve(cachePathFor(lockPath));
   const referenced = new Set(
     Object.values(lock.entries).flatMap((entry) => entry.outputs.map((output) => output.sha256))
   );
@@ -11171,7 +11515,7 @@ async function inspectCaches(lock, lockPath, options = {}) {
     ]);
     for (const name of names) {
       try {
-        await rm8(path22.join(contentDir, name), { force: true });
+        await rm8(path24.join(contentDir, name), { force: true });
         removed.contentFiles++;
       } catch {
       }
@@ -11198,7 +11542,7 @@ async function inspectCaches(lock, lockPath, options = {}) {
 async function inspectContentCache(contentDir, referenced) {
   const report = {
     path: contentDir,
-    exists: existsSync18(contentDir),
+    exists: existsSync19(contentDir),
     files: 0,
     bytes: 0,
     valid: 0,
@@ -11219,7 +11563,7 @@ async function inspectContentCache(contentDir, referenced) {
       continue;
     }
     report.files++;
-    const file = path22.join(contentDir, entry.name);
+    const file = path24.join(contentDir, entry.name);
     const mediaType = mediaTypeFromExtension(entry.name);
     const expected = mediaType ? entry.name.slice(0, -4) : "";
     let bytes;
@@ -11262,7 +11606,7 @@ async function inspectContentCache(contentDir, referenced) {
 async function inspectRemoteHashCache(remotePath) {
   const report = {
     path: remotePath,
-    exists: existsSync18(remotePath),
+    exists: existsSync19(remotePath),
     entries: 0,
     valid: 0,
     invalidIds: [],
@@ -11542,8 +11886,8 @@ function isRecord2(value) {
 }
 
 // src/pick/salvage-server.ts
-import { mkdir as mkdir6, writeFile as writeFile9, readFile as readFile19 } from "fs/promises";
-import path23 from "path";
+import { mkdir as mkdir7, writeFile as writeFile9, readFile as readFile19 } from "fs/promises";
+import path25 from "path";
 
 // src/pick/salvage-sheet.ts
 var escapeHtml3 = (s) => s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]);
@@ -11708,7 +12052,7 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
   });
   const html = renderSalvageSheet(orphans, {
     styleId: ctx.styleId,
-    importDir: path23.relative(process.cwd(), ctx.importDir) || "."
+    importDir: path25.relative(process.cwd(), ctx.importDir) || "."
   });
   const byId = new Map(orphans.map((o) => [o.id, o]));
   const existingTags = new Map(orphans.map((o) => [o.id, o.tags]));
@@ -11737,13 +12081,14 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
             if (!buf.subarray(0, 8).equals(PNG_SIGNATURE2)) throw new Error("not a PNG");
             decodePng(buf);
             const assetId = idFromPrompt(orphan.prompt, taken);
-            const rel = path23.join("_salvaged", `${assetId}.png`);
-            const outFile = path23.resolve(ctx.importDir, rel);
-            await mkdir6(path23.dirname(outFile), { recursive: true });
+            const rel = path25.join("_salvaged", `${assetId}.png`);
+            const outFile = path25.resolve(ctx.importDir, rel);
+            await mkdir7(path25.dirname(outFile), { recursive: true });
             await writeFile9(outFile, buf);
             ctx.manifest.assets[assetId] = {
               prompt: orphan.prompt,
               promptByStyle: {},
+              sourceByStyle: {},
               category: "_salvaged",
               file: rel,
               tags: ["salvaged"],
@@ -11771,7 +12116,7 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
               sourceUrl: durableSource,
               sourceUrls: durableSource ? [{ url: durableSource }] : [],
               outputs: [{
-                path: portableOutputPath(outFile, path23.dirname(ctx.manifestPath)),
+                path: portableOutputPath(outFile, path25.dirname(ctx.manifestPath)),
                 sha256: sha256(buf)
               }],
               submittedAt: orphan.createdAt,
@@ -11805,51 +12150,51 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
 }
 
 // src/recipes.ts
-import path24 from "path";
-import { existsSync as existsSync19 } from "fs";
+import path26 from "path";
+import { existsSync as existsSync20 } from "fs";
 import { readdir as readdir3, readFile as readFile20 } from "fs/promises";
 import { fileURLToPath } from "url";
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 var SHA256_RE = /^[0-9a-f]{64}$/;
 var RECIPE_ID_RE = /^[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/;
 var VERSION_RE = /^\d+\.\d+\.\d+$/;
 var RECIPE_FILE = "pixelkiln.recipe.json";
 var RECIPE_DIR_TOKEN = "{{recipeDir}}";
-var PortablePathSchema = z7.string().min(1).refine((value) => {
-  if (value.includes("\\") || path24.posix.isAbsolute(value)) return false;
+var PortablePathSchema = z8.string().min(1).refine((value) => {
+  if (value.includes("\\") || path26.posix.isAbsolute(value)) return false;
   const parts = value.split("/");
   return !parts.includes("") && !parts.includes(".") && !parts.includes("..");
 }, "expected a portable relative path without '.', '..', or backslashes");
-var RecipeBindingSchema = z7.object({
-  nodeId: z7.string().min(1),
-  input: z7.string().min(1)
+var RecipeBindingSchema = z8.object({
+  nodeId: z8.string().min(1),
+  input: z8.string().min(1)
 }).strict();
-var RecipeSchema = z7.object({
-  $schema: z7.string().url().optional(),
-  format: z7.literal("pixelkiln-recipe"),
-  schemaVersion: z7.literal(1),
-  id: z7.string().regex(RECIPE_ID_RE, "expected provider/name"),
-  version: z7.string().regex(VERSION_RE, "expected x.y.z"),
-  provider: z7.string().regex(/^[a-z0-9][a-z0-9-]*$/),
-  summary: z7.string().min(1).max(240),
-  files: z7.array(z7.object({
+var RecipeSchema = z8.object({
+  $schema: z8.string().url().optional(),
+  format: z8.literal("pixelkiln-recipe"),
+  schemaVersion: z8.literal(1),
+  id: z8.string().regex(RECIPE_ID_RE, "expected provider/name"),
+  version: z8.string().regex(VERSION_RE, "expected x.y.z"),
+  provider: z8.string().regex(/^[a-z0-9][a-z0-9-]*$/),
+  summary: z8.string().min(1).max(240),
+  files: z8.array(z8.object({
     path: PortablePathSchema,
-    role: z7.enum(["workflow", "reference"]),
-    sha256: z7.string().regex(SHA256_RE)
+    role: z8.enum(["workflow", "reference"]),
+    sha256: z8.string().regex(SHA256_RE)
   }).strict()).default([]),
-  models: z7.array(z7.object({
+  models: z8.array(z8.object({
     path: PortablePathSchema,
-    sha256: z7.string().regex(SHA256_RE),
-    source: z7.string().url(),
-    license: z7.string().min(1)
+    sha256: z8.string().regex(SHA256_RE),
+    source: z8.string().url(),
+    license: z8.string().min(1)
   }).strict()).default([]),
-  styleId: z7.string().regex(/^[a-z0-9][a-z0-9-]*$/),
+  styleId: z8.string().regex(/^[a-z0-9][a-z0-9-]*$/),
   style: StyleSchema,
-  workflow: z7.object({
+  workflow: z8.object({
     path: PortablePathSchema,
-    outputNodeId: z7.string().min(1),
-    numImages: z7.number().int().min(1).max(16),
-    bindings: z7.object({
+    outputNodeId: z8.string().min(1),
+    numImages: z8.number().int().min(1).max(16),
+    bindings: z8.object({
       prompt: RecipeBindingSchema,
       width: RecipeBindingSchema.optional(),
       height: RecipeBindingSchema.optional(),
@@ -11860,67 +12205,67 @@ var RecipeSchema = z7.object({
       strength: RecipeBindingSchema.optional()
     }).strict()
   }).strict().optional(),
-  quality: z7.object({
-    stage: z7.enum(["composition-source", "production-candidate"]),
-    workingCanvas: z7.object({
-      width: z7.number().int().min(16),
-      height: z7.number().int().min(16)
+  quality: z8.object({
+    stage: z8.enum(["composition-source", "production-candidate"]),
+    workingCanvas: z8.object({
+      width: z8.number().int().min(16),
+      height: z8.number().int().min(16)
     }).strict(),
-    recommendedNativeSize: z7.object({
-      min: z7.number().int().min(1),
-      max: z7.number().int().min(1)
+    recommendedNativeSize: z8.object({
+      min: z8.number().int().min(1),
+      max: z8.number().int().min(1)
     }).strict(),
-    paletteColors: z7.object({
-      min: z7.number().int().min(1),
-      max: z7.number().int().min(1)
+    paletteColors: z8.object({
+      min: z8.number().int().min(1),
+      max: z8.number().int().min(1)
     }).strict(),
-    background: z7.enum(["opaque", "transparent", "full-bleed"]),
-    checks: z7.array(z7.enum([
+    background: z8.enum(["opaque", "transparent", "full-bleed"]),
+    checks: z8.array(z8.enum([
       "prompt-coverage",
       "native-grid",
       "final-palette",
       "alpha-edge",
       "human-1x"
     ])).min(1),
-    notes: z7.array(z7.string().min(1)).default([])
+    notes: z8.array(z8.string().min(1)).default([])
   }).strict(),
-  integrity: z7.object({
-    algorithm: z7.literal("sha256"),
-    digest: z7.string().regex(SHA256_RE)
+  integrity: z8.object({
+    algorithm: z8.literal("sha256"),
+    digest: z8.string().regex(SHA256_RE)
   }).strict()
 }).strict().superRefine((recipe, context) => {
   if (recipe.style.provider && recipe.style.provider !== recipe.provider) {
     context.addIssue({
-      code: z7.ZodIssueCode.custom,
+      code: z8.ZodIssueCode.custom,
       path: ["style", "provider"],
       message: "must match the recipe provider"
     });
   }
   const filePaths = recipe.files.map((file) => file.path);
   if (new Set(filePaths).size !== filePaths.length) {
-    context.addIssue({ code: z7.ZodIssueCode.custom, path: ["files"], message: "duplicate file path" });
+    context.addIssue({ code: z8.ZodIssueCode.custom, path: ["files"], message: "duplicate file path" });
   }
   const modelPaths = recipe.models.map((model) => model.path);
   if (new Set(modelPaths).size !== modelPaths.length) {
-    context.addIssue({ code: z7.ZodIssueCode.custom, path: ["models"], message: "duplicate model path" });
+    context.addIssue({ code: z8.ZodIssueCode.custom, path: ["models"], message: "duplicate model path" });
   }
   if (filePaths.includes(RECIPE_FILE)) {
     context.addIssue({
-      code: z7.ZodIssueCode.custom,
+      code: z8.ZodIssueCode.custom,
       path: ["files"],
       message: `${RECIPE_FILE} cannot hash itself`
     });
   }
   if (recipe.quality.recommendedNativeSize.min > recipe.quality.recommendedNativeSize.max) {
     context.addIssue({
-      code: z7.ZodIssueCode.custom,
+      code: z8.ZodIssueCode.custom,
       path: ["quality", "recommendedNativeSize"],
       message: "min cannot exceed max"
     });
   }
   if (recipe.quality.paletteColors.min > recipe.quality.paletteColors.max) {
     context.addIssue({
-      code: z7.ZodIssueCode.custom,
+      code: z8.ZodIssueCode.custom,
       path: ["quality", "paletteColors"],
       message: "min cannot exceed max"
     });
@@ -11929,7 +12274,7 @@ var RecipeSchema = z7.object({
     (file) => file.path === recipe.workflow.path && file.role === "workflow"
   )) {
     context.addIssue({
-      code: z7.ZodIssueCode.custom,
+      code: z8.ZodIssueCode.custom,
       path: ["workflow", "path"],
       message: "must name a file whose role is workflow"
     });
@@ -11937,7 +12282,7 @@ var RecipeSchema = z7.object({
   if (recipe.provider === "comfyui") {
     if (!recipe.workflow) {
       context.addIssue({
-        code: z7.ZodIssueCode.custom,
+        code: z8.ZodIssueCode.custom,
         path: ["workflow"],
         message: "ComfyUI recipes require workflow metadata"
       });
@@ -11946,7 +12291,7 @@ var RecipeSchema = z7.object({
     const options = recipe.style.providerOptions.comfyui;
     if (!options || typeof options !== "object" || Array.isArray(options)) {
       context.addIssue({
-        code: z7.ZodIssueCode.custom,
+        code: z8.ZodIssueCode.custom,
         path: ["style", "providerOptions", "comfyui"],
         message: "ComfyUI recipes require ComfyUI provider options"
       });
@@ -11960,7 +12305,7 @@ var RecipeSchema = z7.object({
     };
     if (JSON.stringify(canonical3(options)) !== JSON.stringify(canonical3(expected))) {
       context.addIssue({
-        code: z7.ZodIssueCode.custom,
+        code: z8.ZodIssueCode.custom,
         path: ["style", "providerOptions", "comfyui"],
         message: "must match workflow metadata and use {{recipeDir}} for workflowFile"
       });
@@ -11992,7 +12337,7 @@ function message4(error) {
   return error instanceof Error ? error.message : String(error);
 }
 async function readRecipeFile(recipePath, bundled) {
-  const absolute = path24.resolve(recipePath);
+  const absolute = path26.resolve(recipePath);
   let raw;
   try {
     raw = JSON.parse(await readFile20(absolute, "utf8"));
@@ -12006,13 +12351,13 @@ async function readRecipeFile(recipePath, bundled) {
 ` + parsed.error.issues.map((issue) => `  ${issue.path.join(".") || "$"}: ${issue.message}`).join("\n")
     );
   }
-  return { recipe: parsed.data, path: absolute, dir: path24.dirname(absolute), bundled };
+  return { recipe: parsed.data, path: absolute, dir: path26.dirname(absolute), bundled };
 }
 async function walkRecipeFiles(root) {
-  if (!existsSync19(root)) return [];
+  if (!existsSync20(root)) return [];
   const out = [];
   for (const entry of await readdir3(root, { withFileTypes: true })) {
-    const resolved = path24.join(root, entry.name);
+    const resolved = path26.join(root, entry.name);
     if (entry.isDirectory()) out.push(...await walkRecipeFiles(resolved));
     else if (entry.isFile() && entry.name === RECIPE_FILE) out.push(resolved);
   }
@@ -12023,7 +12368,7 @@ function bundledRecipeRoot() {
 }
 async function listBundledRecipes(root = bundledRecipeRoot()) {
   const recipes = await Promise.all(
-    (await walkRecipeFiles(path24.resolve(root))).map((file) => readRecipeFile(file, true))
+    (await walkRecipeFiles(path26.resolve(root))).map((file) => readRecipeFile(file, true))
   );
   return recipes.sort(
     (a, b) => a.recipe.id.localeCompare(b.recipe.id) || compareVersions(b.recipe.version, a.recipe.version)
@@ -12046,9 +12391,9 @@ function parseSelector(selector) {
   return { id: match[1], version: match[2] };
 }
 async function resolveRecipe(target, bundledRoot = bundledRecipeRoot()) {
-  const local = path24.resolve(target);
-  if (existsSync19(local)) {
-    const recipePath = path24.basename(local) === RECIPE_FILE ? local : path24.join(local, RECIPE_FILE);
+  const local = path26.resolve(target);
+  if (existsSync20(local)) {
+    const recipePath = path26.basename(local) === RECIPE_FILE ? local : path26.join(local, RECIPE_FILE);
     return readRecipeFile(recipePath, false);
   }
   if (target.startsWith(".") || target.startsWith("/") || target.includes("\\")) {
@@ -12062,8 +12407,8 @@ async function resolveRecipe(target, bundledRoot = bundledRecipeRoot()) {
   return matches[0];
 }
 async function verifyFile(root, file) {
-  const absolute = path24.resolve(root, ...file.path.split("/"));
-  if (!existsSync19(absolute)) {
+  const absolute = path26.resolve(root, ...file.path.split("/"));
+  if (!existsSync20(absolute)) {
     return { path: file.path, expectedSha256: file.sha256, actualSha256: null, status: "missing" };
   }
   const actualSha256 = await sha256File(absolute);
@@ -12078,7 +12423,7 @@ async function verifyRecipe(target, options = {}) {
   const loaded = await resolveRecipe(target, options.bundledRoot);
   const actualIntegrity = recipeDigest(loaded.recipe);
   const files = await Promise.all(loaded.recipe.files.map((file) => verifyFile(loaded.dir, file)));
-  const modelRoot = options.modelRoot ? path24.resolve(options.modelRoot) : null;
+  const modelRoot = options.modelRoot ? path26.resolve(options.modelRoot) : null;
   const models = modelRoot ? await Promise.all(loaded.recipe.models.map(async (model) => ({
     ...await verifyFile(modelRoot, model),
     source: model.source,
@@ -12112,7 +12457,7 @@ async function verifyRecipe(target, options = {}) {
   };
 }
 function renderStyle(style, destination, cwd) {
-  const portableDir = path24.relative(cwd, destination).split(path24.sep).join("/") || ".";
+  const portableDir = path26.relative(cwd, destination).split(path26.sep).join("/") || ".";
   const replace = (value) => {
     if (typeof value === "string") return value.replaceAll(RECIPE_DIR_TOKEN, portableDir);
     if (Array.isArray(value)) return value.map(replace);
@@ -12124,24 +12469,24 @@ function renderStyle(style, destination, cwd) {
   return replace(style);
 }
 async function installRecipe(target, options = {}) {
-  const cwd = path24.resolve(options.cwd ?? process.cwd());
+  const cwd = path26.resolve(options.cwd ?? process.cwd());
   const loaded = await resolveRecipe(target, options.bundledRoot);
   const verification = await verifyRecipe(loaded.path);
   if (!verification.ok) {
     throw new Error(`Recipe ${loaded.recipe.id}@${loaded.recipe.version} failed integrity verification.`);
   }
-  const destination = options.out ? path24.resolve(cwd, options.out) : path24.join(cwd, "pixelkiln-recipes", ...loaded.recipe.id.split("/"), loaded.recipe.version);
+  const destination = options.out ? path26.resolve(cwd, options.out) : path26.join(cwd, "pixelkiln-recipes", ...loaded.recipe.id.split("/"), loaded.recipe.version);
   const sources = [
     { path: RECIPE_FILE, source: loaded.path },
-    ...loaded.recipe.files.map((file) => ({ path: file.path, source: path24.join(loaded.dir, ...file.path.split("/")) }))
+    ...loaded.recipe.files.map((file) => ({ path: file.path, source: path26.join(loaded.dir, ...file.path.split("/")) }))
   ];
   const files = await Promise.all(sources.map(async (file) => ({
-    path: path24.join(destination, ...file.path.split("/")),
+    path: path26.join(destination, ...file.path.split("/")),
     data: await readFile20(file.source)
   })));
   if (!options.force) {
     for (const file of files) {
-      if (!existsSync19(file.path)) continue;
+      if (!existsSync20(file.path)) continue;
       const current = await readFile20(file.path);
       if (!current.equals(file.data)) {
         throw new Error(
@@ -12165,15 +12510,15 @@ async function installRecipe(target, options = {}) {
 }
 
 // src/pipeline/quality-regression.ts
-import path25 from "path";
-import { existsSync as existsSync20 } from "fs";
+import path27 from "path";
+import { existsSync as existsSync21 } from "fs";
 import { readFile as readFile21 } from "fs/promises";
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 var SHA256_RE2 = /^[0-9a-f]{64}$/;
 var HEX_RE = /^#[0-9a-f]{6}$/;
 var MAX_REDMEAN_DISTANCE = 765;
-var QualityPathSchema = z8.string().min(1).refine(
-  (value) => !path25.posix.isAbsolute(value) && !value.includes("\\"),
+var QualityPathSchema = z9.string().min(1).refine(
+  (value) => !path27.posix.isAbsolute(value) && !value.includes("\\"),
   "expected a portable relative path"
 );
 var DEFAULT_QUALITY_TOLERANCES = {
@@ -12186,53 +12531,53 @@ var DEFAULT_QUALITY_TOLERANCES = {
   maxEdgeContrastDrop: 0.03,
   maxIsolatedPixelIncrease: 5e-3
 };
-var QualityToleranceSchema = z8.object({
-  requireExactHash: z8.boolean(),
-  maxColorCountIncrease: z8.number().int().min(0),
-  maxNewColors: z8.number().int().min(0),
-  maxTransparencyDelta: z8.number().min(0).max(1),
-  maxPartialAlphaIncrease: z8.number().min(0).max(1),
-  maxEdgeDensityDelta: z8.number().min(0).max(1),
-  maxEdgeContrastDrop: z8.number().min(0).max(1),
-  maxIsolatedPixelIncrease: z8.number().min(0).max(1)
+var QualityToleranceSchema = z9.object({
+  requireExactHash: z9.boolean(),
+  maxColorCountIncrease: z9.number().int().min(0),
+  maxNewColors: z9.number().int().min(0),
+  maxTransparencyDelta: z9.number().min(0).max(1),
+  maxPartialAlphaIncrease: z9.number().min(0).max(1),
+  maxEdgeDensityDelta: z9.number().min(0).max(1),
+  maxEdgeContrastDrop: z9.number().min(0).max(1),
+  maxIsolatedPixelIncrease: z9.number().min(0).max(1)
 }).strict();
-var ImageQualityMetricsSchema = z8.object({
-  sha256: z8.string().regex(SHA256_RE2),
-  width: z8.number().int().min(1),
-  height: z8.number().int().min(1),
-  colorCount: z8.number().int().min(0),
-  colors: z8.array(z8.string().regex(HEX_RE)),
-  transparency: z8.number().min(0).max(1),
-  partialAlpha: z8.number().min(0).max(1),
-  edgeDensity: z8.number().min(0).max(1),
-  meanEdgeContrast: z8.number().min(0).max(1),
-  isolatedPixelRatio: z8.number().min(0).max(1)
+var ImageQualityMetricsSchema = z9.object({
+  sha256: z9.string().regex(SHA256_RE2),
+  width: z9.number().int().min(1),
+  height: z9.number().int().min(1),
+  colorCount: z9.number().int().min(0),
+  colors: z9.array(z9.string().regex(HEX_RE)),
+  transparency: z9.number().min(0).max(1),
+  partialAlpha: z9.number().min(0).max(1),
+  edgeDensity: z9.number().min(0).max(1),
+  meanEdgeContrast: z9.number().min(0).max(1),
+  isolatedPixelRatio: z9.number().min(0).max(1)
 }).strict();
-var QualityBaselineCaseSchema = z8.object({
-  id: z8.string().regex(/^[a-z0-9][a-z0-9/_-]*$/),
+var QualityBaselineCaseSchema = z9.object({
+  id: z9.string().regex(/^[a-z0-9][a-z0-9/_-]*$/),
   file: QualityPathSchema,
-  record: z8.object({
+  record: z9.object({
     path: QualityPathSchema,
-    sha256: z8.string().regex(SHA256_RE2)
+    sha256: z9.string().regex(SHA256_RE2)
   }).strict().optional(),
   expected: ImageQualityMetricsSchema,
   tolerances: QualityToleranceSchema
 }).strict();
-var QualityBaselineSchema = z8.object({
-  $schema: z8.string().url().optional(),
-  format: z8.literal("pixelkiln-quality-baseline"),
-  schemaVersion: z8.literal(1),
-  cases: z8.array(QualityBaselineCaseSchema).min(1)
+var QualityBaselineSchema = z9.object({
+  $schema: z9.string().url().optional(),
+  format: z9.literal("pixelkiln-quality-baseline"),
+  schemaVersion: z9.literal(1),
+  cases: z9.array(QualityBaselineCaseSchema).min(1)
 }).strict().superRefine((baseline, context) => {
   const ids = baseline.cases.map((entry) => entry.id);
   if (new Set(ids).size !== ids.length) {
-    context.addIssue({ code: z8.ZodIssueCode.custom, path: ["cases"], message: "duplicate case id" });
+    context.addIssue({ code: z9.ZodIssueCode.custom, path: ["cases"], message: "duplicate case id" });
   }
 });
-var QualityInputSchema = z8.object({
-  id: z8.string().regex(/^[a-z0-9][a-z0-9/_-]*$/),
-  path: z8.string().min(1),
-  record: z8.string().min(1).optional(),
+var QualityInputSchema = z9.object({
+  id: z9.string().regex(/^[a-z0-9][a-z0-9/_-]*$/),
+  path: z9.string().min(1),
+  record: z9.string().min(1).optional(),
   tolerances: QualityToleranceSchema.partial().optional()
 }).strict();
 function message5(error) {
@@ -12320,7 +12665,7 @@ function measureDecodedImageQuality(png, digest2) {
   };
 }
 async function measureImageQuality(file) {
-  const absolute = path25.resolve(file);
+  const absolute = path27.resolve(file);
   let bytes;
   try {
     bytes = await readFile21(absolute);
@@ -12334,7 +12679,7 @@ async function measureImageQuality(file) {
   }
 }
 function resolveQualityInputs(raw, inputsFilePath) {
-  const parsed = z8.array(QualityInputSchema).min(1).safeParse(raw);
+  const parsed = z9.array(QualityInputSchema).min(1).safeParse(raw);
   if (!parsed.success) {
     throw new Error(
       "--inputs must be a non-empty JSON array of quality cases:\n" + parsed.error.issues.map((issue) => `  ${issue.path.join(".") || "$"}: ${issue.message}`).join("\n")
@@ -12342,11 +12687,11 @@ function resolveQualityInputs(raw, inputsFilePath) {
   }
   const ids = parsed.data.map((entry) => entry.id);
   if (new Set(ids).size !== ids.length) throw new Error("--inputs contains a duplicate quality case id.");
-  const root = path25.dirname(path25.resolve(inputsFilePath));
+  const root = path27.dirname(path27.resolve(inputsFilePath));
   return parsed.data.map((entry) => ({
     id: entry.id,
-    file: path25.resolve(root, entry.path),
-    ...entry.record ? { record: path25.resolve(root, entry.record) } : {},
+    file: path27.resolve(root, entry.path),
+    ...entry.record ? { record: path27.resolve(root, entry.record) } : {},
     tolerances: QualityToleranceSchema.parse({
       ...DEFAULT_QUALITY_TOLERANCES,
       ...entry.tolerances
@@ -12354,7 +12699,7 @@ function resolveQualityInputs(raw, inputsFilePath) {
   }));
 }
 function portableRelative2(from, to) {
-  return path25.relative(from, path25.resolve(to)).split(path25.sep).join("/") || ".";
+  return path27.relative(from, path27.resolve(to)).split(path27.sep).join("/") || ".";
 }
 async function verifyRecordForImage(recordPath, imagePath) {
   const verification = await verifyArtifactBundle(recordPath);
@@ -12369,20 +12714,20 @@ async function verifyRecordForImage(recordPath, imagePath) {
   if (record.kind !== "refine" || options === null || typeof options !== "object" || options.schema !== "pixelkiln-quality") {
     throw new Error(`Quality record ${recordPath} is not a PixelKiln refinement record.`);
   }
-  const outputs = record.outputs.map((output) => path25.resolve(path25.dirname(recordPath), output.path));
-  if (!outputs.includes(path25.resolve(imagePath))) {
+  const outputs = record.outputs.map((output) => path27.resolve(path27.dirname(recordPath), output.path));
+  if (!outputs.includes(path27.resolve(imagePath))) {
     throw new Error(`Quality record ${recordPath} does not own ${imagePath}.`);
   }
 }
 async function snapshotQualityBaseline(inputs, baselinePath, options = {}) {
   if (!inputs.length) throw new Error("Cannot snapshot an empty quality baseline.");
-  const absolute = path25.resolve(baselinePath);
+  const absolute = path27.resolve(baselinePath);
   for (const input of inputs) {
-    if (path25.resolve(input.file) === absolute || input.record && path25.resolve(input.record) === absolute) {
+    if (path27.resolve(input.file) === absolute || input.record && path27.resolve(input.record) === absolute) {
       throw new Error(`Quality baseline output would overwrite an input: ${absolute}.`);
     }
   }
-  const root = path25.dirname(absolute);
+  const root = path27.dirname(absolute);
   const cases = [];
   for (const input of [...inputs].sort((a, b) => a.id.localeCompare(b.id))) {
     const expected = await measureImageQuality(input.file);
@@ -12409,7 +12754,7 @@ async function snapshotQualityBaseline(inputs, baselinePath, options = {}) {
     cases
   });
   const data = Buffer.from(JSON.stringify(baseline, null, 2) + "\n");
-  if (existsSync20(absolute) && !options.force) {
+  if (existsSync21(absolute) && !options.force) {
     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.`);
@@ -12419,7 +12764,7 @@ async function snapshotQualityBaseline(inputs, baselinePath, options = {}) {
   return { baseline, path: absolute, changed: result.changed.length > 0 };
 }
 async function readQualityBaseline(baselinePath) {
-  const absolute = path25.resolve(baselinePath);
+  const absolute = path27.resolve(baselinePath);
   let raw;
   try {
     raw = JSON.parse(await readFile21(absolute, "utf8"));
@@ -12492,12 +12837,12 @@ function regressionViolations(expected, actual, tolerances) {
   return { violations, warnings };
 }
 async function checkQualityBaseline(baselinePath) {
-  const absolute = path25.resolve(baselinePath);
+  const absolute = path27.resolve(baselinePath);
   const baseline = await readQualityBaseline(absolute);
-  const root = path25.dirname(absolute);
+  const root = path27.dirname(absolute);
   const cases = [];
   for (const entry of baseline.cases) {
-    const file = path25.resolve(root, entry.file);
+    const file = path27.resolve(root, entry.file);
     let actual = null;
     const violations = [];
     const warnings = [];
@@ -12510,7 +12855,7 @@ async function checkQualityBaseline(baselinePath) {
       violations.push(message5(error));
     }
     if (entry.record) {
-      const recordPath = path25.resolve(root, entry.record.path);
+      const recordPath = path27.resolve(root, entry.record.path);
       try {
         const recordHash = await sha256File(recordPath);
         if (recordHash !== entry.record.sha256) violations.push("quality record hash changed");
@@ -12596,13 +12941,13 @@ async function runGallery(initial, reload, args, access2) {
   };
   const loadProject = async (project) => {
     const ctx = await access2.loadProject(project);
-    const dir = path26.dirname(ctx.loaded.path);
+    const dir = path28.dirname(ctx.loaded.path);
     const declared = readEnvFiles(dir);
     const credentialNames = new Set(availableProviders().flatMap((id) => providerCredentialEnvs(providerFactory(id))));
     for (const [name, value] of Object.entries(declared)) {
       if (credentialNames.has(name) && name in process.env && process.env[name] !== value) {
         throw new Error(
-          `${path26.relative(process.cwd(), dir) || "."} sets ${name} to a different value than the one this gallery already loaded; run a separate gallery for that project so its work uses its own account.`
+          `${path28.relative(process.cwd(), dir) || "."} sets ${name} to a different value than the one this gallery already loaded; run a separate gallery for that project so its work uses its own account.`
         );
       }
     }
@@ -12628,7 +12973,7 @@ async function runGallery(initial, reload, args, access2) {
       args.edit,
       budget ? describeBudget(budget) : null
     ),
-    ...args.edit ? { edit: createGalleryEditHandler({ manifestFor: access2.manifestFor, reload, onProgress: log }) } : {},
+    ...args.edit ? { edit: createGalleryEditHandler({ manifestFor: access2.manifestFor, loadProject: access2.loadProject, reload, onProgress: log }) } : {},
     ...budget ? { generate: createGenerateHandlers({ loadProject, providerFor, budget, reload, onProgress: log }) } : {}
   });
   await new Promise((resolve) => {
@@ -12644,11 +12989,11 @@ async function runGallery(initial, reload, args, access2) {
   log("\n  gallery closed");
 }
 async function provenanceFile(id, file) {
-  const absolute = path26.resolve(file);
+  const absolute = path28.resolve(file);
   return {
     id,
     path: absolute,
-    sha256: existsSync21(absolute) ? await sha256File(absolute) : null,
+    sha256: existsSync22(absolute) ? await sha256File(absolute) : null,
     included: true
   };
 }
@@ -12723,6 +13068,7 @@ var COMMANDS = [
   "balance",
   "status",
   "gallery",
+  "edit",
   "quality",
   "refine",
   "recipe",
@@ -12737,6 +13083,7 @@ var WORKSPACE_SUBCOMMANDS = ["add", "remove", "list", "status", "claims"];
 var REFINE_SUBCOMMANDS = ["run", "approve", "check"];
 var RECIPE_SUBCOMMANDS = ["list", "inspect", "install", "verify"];
 var QUALITY_SUBCOMMANDS = ["snapshot", "check"];
+var EDIT_SUBCOMMANDS = ["start", "detach"];
 function parseArgs(argv) {
   const [command = "help"] = argv;
   if (!COMMANDS.includes(command)) {
@@ -12794,6 +13141,12 @@ function parseArgs(argv) {
       }
       rest = rest.slice(1);
     }
+  } else if (command === "edit") {
+    subcommand = rest[0]?.startsWith("-") || rest[0] === void 0 ? "start" : rest[0];
+    if (!EDIT_SUBCOMMANDS.includes(subcommand)) {
+      throw new Error(`Unknown edit subcommand "${subcommand}". Known: ${EDIT_SUBCOMMANDS.join(", ")}`);
+    }
+    if (rest[0] === subcommand) rest = rest.slice(1);
   } else if (command === "refine") {
     subcommand = rest[0]?.startsWith("-") || rest[0] === void 0 ? "run" : rest[0];
     if (!REFINE_SUBCOMMANDS.includes(subcommand)) {
@@ -12907,7 +13260,7 @@ function parseArgs(argv) {
   return {
     command,
     manifest,
-    lock: get("--lock") ?? path26.join(path26.dirname(path26.resolve(manifest)), "pixelkiln.lock.json"),
+    lock: get("--lock") ?? path28.join(path28.dirname(path28.resolve(manifest)), "pixelkiln.lock.json"),
     explicitLock: get("--lock"),
     styles: list("--style"),
     assets: list("--only"),
@@ -12988,6 +13341,9 @@ Commands
   tag       Push manifest tags to the objects upstream (free).
   balance   Show the provider's remaining balance.
   status    Summarise the lockfile.
+  edit      Hand-edit an asset in your own editor: copies the generated PNG to
+            <outDir>/edits/, declares it as the asset's source, and opens it.
+            edit detach places the generated art again (the file is kept).
   gallery   Open a local read-only gallery of every generation and its
             provenance: prompt, provider, cost, outputs, lineage, quality.
             --workspace <catalog> shows every registered project at once;
@@ -13030,7 +13386,7 @@ Options
                       and the gallery snapshot (no server)
   --check             plan/audit/cache: exit nonzero when the selected state is unsafe
   --yes, -y           Skip the confirmation prompt
-  --no-open           Do not auto-open the browser during pick, salvage, or gallery
+  --no-open           Do not auto-open the browser (pick, salvage, gallery) or editor (edit)
   --edit              gallery: allow manifest edits from the page (never spends)
   --tag               Also push tags upstream after fetch
   --claims a.json,b   Other projects' lockfiles (salvage; required if account is shared)
@@ -13047,6 +13403,8 @@ Examples
   pixelkiln gallery --style heybud-premium
   pixelkiln gallery --workspace pixelkiln.workspace.json
   pixelkiln gallery --edit --budget 80
+  pixelkiln edit --style base --only anvil
+  PIXELKILN_EDITOR="open -a Aseprite" pixelkiln edit --only anvil --style base
   pixelkiln adopt --tag
   pixelkiln pack --style heybud-premium
   pixelkiln pack --inputs sprites.json --out dist/sheet   # no manifest needed
@@ -13123,6 +13481,15 @@ function printResumeActions(specs, lock) {
   }
   return actions.length;
 }
+function manifestSources(manifest, styleId) {
+  const sources = {};
+  for (const [assetId, asset] of Object.entries(manifest.assets)) {
+    if (asset.styles.length && !asset.styles.includes(styleId)) continue;
+    const source = asset.sourceByStyle[styleId] ?? asset.source;
+    if (source) sources[assetId] = source;
+  }
+  return sources;
+}
 function manifestProviderIds(manifest) {
   return [...new Set(
     Object.values(manifest.styles).map((style) => style.provider ?? manifest.provider)
@@ -13196,10 +13563,10 @@ async function confirm(question, auto) {
   return answer === "y" || answer === "yes";
 }
 async function requireCompleteWorkspaceClaims(workspacePath) {
-  if (!existsSync21(workspacePath)) {
+  if (!existsSync22(workspacePath)) {
     throw new Error(`Workspace catalog not found: ${workspacePath}`);
   }
-  const dir = path26.dirname(path26.resolve(workspacePath));
+  const dir = path28.dirname(path28.resolve(workspacePath));
   const ws = await loadWorkspace(workspacePath);
   const diagnostics = validateWorkspace(ws, dir);
   const errors = diagnostics.filter((d) => d.level === "error");
@@ -13231,15 +13598,15 @@ async function main() {
       if (!args.out) throw new Error("quality snapshot needs --out <pixelkiln.quality.json>.");
       let raw;
       try {
-        raw = JSON.parse(await readFile22(path26.resolve(args.inputs), "utf8"));
+        raw = JSON.parse(await readFile22(path28.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)}`,
+          `Could not read quality inputs ${path28.resolve(args.inputs)}: ${error instanceof Error ? error.message : String(error)}`,
           { cause: error }
         );
       }
       const inputs = resolveQualityInputs(raw, args.inputs);
-      if (path26.resolve(args.inputs) === path26.resolve(args.out)) {
+      if (path28.resolve(args.inputs) === path28.resolve(args.out)) {
         throw new Error("quality snapshot --out must not overwrite its --inputs file.");
       }
       const result = await snapshotQualityBaseline(inputs, args.out, { force: args.force });
@@ -13252,7 +13619,7 @@ async function main() {
         }, null, 2));
       } else {
         log(
-          `  ${result.changed ? "wrote" : "unchanged"} ${path26.relative(process.cwd(), result.path)} (${result.baseline.cases.length} case(s))`
+          `  ${result.changed ? "wrote" : "unchanged"} ${path28.relative(process.cwd(), result.path)} (${result.baseline.cases.length} case(s))`
         );
         log(`  Review the tolerances, commit the baseline, then run quality check in CI.`);
       }
@@ -13347,14 +13714,14 @@ async function main() {
         }, null, 2));
       } else {
         log(`  installed ${result.recipe.id}@${result.recipe.version}`);
-        log(`  ${path26.relative(process.cwd(), result.destination) || "."}`);
+        log(`  ${path28.relative(process.cwd(), result.destination) || "."}`);
         log(`
   Add this entry under your manifest's styles object:`);
         log(JSON.stringify({ [result.styleId]: result.style }, null, 2));
         if (result.recipe.models.length) {
           log(`
   Models are not downloaded automatically. Verify them with:`);
-          log(`  pixelkiln recipe verify ${path26.relative(process.cwd(), result.destination)} --model-root <ComfyUI/models>`);
+          log(`  pixelkiln recipe verify ${path28.relative(process.cwd(), result.destination)} --model-root <ComfyUI/models>`);
         }
       }
       return;
@@ -13388,12 +13755,12 @@ async function main() {
           `  recovered ${result2.detection.columns}x${result2.detection.rows} native grid (${result2.detection.confidence}: ${result2.detection.consensus})`
         );
         log(`  enforced ${result2.palette.length}-color palette without dithering`);
-        log(`  wrote ${path26.relative(process.cwd(), result2.output)}`);
-        log(`  quality record: ${path26.relative(process.cwd(), result2.record)}`);
+        log(`  wrote ${path28.relative(process.cwd(), result2.output)}`);
+        log(`  quality record: ${path28.relative(process.cwd(), result2.record)}`);
         log(`
   Automated checks passed. Human 1\xD7 review is still required:`);
         log(
-          `    pixelkiln refine approve --from ${path26.relative(process.cwd(), result2.record)} --reviewer "Your Name"`
+          `    pixelkiln refine approve --from ${path28.relative(process.cwd(), result2.record)} --reviewer "Your Name"`
         );
       }
       return;
@@ -13421,7 +13788,7 @@ async function main() {
       if (args.json) log(JSON.stringify(result2, null, 2));
       else {
         log(
-          result2.options.frameSet ? `  approved ${result2.outputs.length} frames in ${path26.relative(process.cwd(), result2.record)} by ${args.reviewer.trim()}` : `  approved ${path26.relative(process.cwd(), result2.output)} by ${args.reviewer.trim()}`
+          result2.options.frameSet ? `  approved ${result2.outputs.length} frames in ${path28.relative(process.cwd(), result2.record)} by ${args.reviewer.trim()}` : `  approved ${path28.relative(process.cwd(), result2.output)} by ${args.reviewer.trim()}`
         );
       }
       return;
@@ -13430,14 +13797,14 @@ async function main() {
     if (args.json) {
       log(JSON.stringify(result, null, 2));
     } else {
-      log(`  ${result.safe ? "release-ready" : "not release-ready"}: ${path26.relative(process.cwd(), result.output || result.record)}`);
+      log(`  ${result.safe ? "release-ready" : "not release-ready"}: ${path28.relative(process.cwd(), result.output || result.record)}`);
       for (const reason of result.reasons) log(`    ${reason}`);
     }
     if (!result.safe) process.exitCode = 1;
     return;
   }
   if (args.command === "balance") {
-    loadEnvFiles(path26.dirname(path26.resolve(args.manifest)));
+    loadEnvFiles(path28.dirname(path28.resolve(args.manifest)));
     loadEnvFiles(process.cwd());
     const loaded2 = await loadManifest(args.manifest);
     const selectedProvider = accountProviderId(loaded2.manifest, args.provider, "balance");
@@ -13450,31 +13817,31 @@ async function main() {
   }
   if (args.command === "init") {
     if (!args.from) throw new Error("init needs --from <dir> pointing at your existing PNGs.");
-    const root = path26.resolve(args.from);
-    if (!existsSync21(root)) throw new Error(`No directory at ${root}`);
+    const root = path28.resolve(args.from);
+    if (!existsSync22(root)) throw new Error(`No directory at ${root}`);
     const generator = args.generator ?? "map";
     if (generator !== "1dir" && generator !== "map") {
       throw new Error(`--generator must be "1dir" or "map", got "${args.generator}".`);
     }
-    const target = path26.resolve(args.out ?? "pixelkiln.manifest.json");
+    const target = path28.resolve(args.out ?? "pixelkiln.manifest.json");
     const { assets, skipped } = await scanAssets(root, { exclude: args.exclude });
     if (!assets.length) throw new Error(`No PNGs found under ${root}`);
     const manifest = buildManifest(
-      args.name ?? path26.basename(path26.dirname(target)),
+      args.name ?? path28.basename(path28.dirname(target)),
       args.styles[0] ?? "base",
       generator,
-      path26.relative(path26.dirname(target), root) || ".",
+      path28.relative(path28.dirname(target), root) || ".",
       assets
     );
     await writeManifestFile(target, manifest);
-    log(`  scanned ${assets.length} PNG(s) under ${path26.relative(process.cwd(), root)}`);
+    log(`  scanned ${assets.length} PNG(s) under ${path28.relative(process.cwd(), root)}`);
     if (skipped.length) log(`  skipped ${skipped.length} unreadable file(s)`);
-    log(`  wrote ${path26.relative(process.cwd(), target)}`);
+    log(`  wrote ${path28.relative(process.cwd(), target)}`);
     log(`
   Prompts are intentionally empty. To recover the real ones from your`);
     log(`  PixelLab account instead of inventing them:`);
     log(`
-    pixelkiln adopt --manifest ${path26.relative(process.cwd(), target)} --write-prompts
+    pixelkiln adopt --manifest ${path28.relative(process.cwd(), target)} --write-prompts
 `);
     return;
   }
@@ -13522,10 +13889,10 @@ 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 readFile22(path26.resolve(args.inputs), "utf8"));
+    const raw = JSON.parse(await readFile22(path28.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$/, ""));
+    const base = path28.resolve(args.out.replace(/\.png$/, ""));
     const outputs = [
       { path: `${base}.png`, data: png },
       { path: `${base}.json`, data: JSON.stringify(atlas, null, 2) + "\n" }
@@ -13538,17 +13905,17 @@ async function main() {
     log(
       `  ${atlas.frames.length} sprite(s), ${atlas.sheet.width}x${atlas.sheet.height} in ${atlas.columns} column(s) \u2014 ${(png.length / 1024).toFixed(1)} KB`
     );
-    log(`    ${path26.relative(process.cwd(), base)}.png + .json + .pixelkiln.json`);
+    log(`    ${path28.relative(process.cwd(), base)}.png + .json + .pixelkiln.json`);
     for (const s of skipped) log(`    skipped ${s.id}: ${s.reason}`);
     return;
   }
   if (args.command === "workspace") {
-    const workspacePath = path26.resolve(args.workspace ?? "pixelkiln.workspace.json");
-    const dir = path26.dirname(workspacePath);
+    const workspacePath = path28.resolve(args.workspace ?? "pixelkiln.workspace.json");
+    const dir = path28.dirname(workspacePath);
     if (args.subcommand === "add") {
-      const manifestPath = path26.resolve(args.target);
+      const manifestPath = path28.resolve(args.target);
       const loadedTarget = await loadManifest(manifestPath);
-      const lockPath = args.explicitLock ? path26.resolve(args.explicitLock) : path26.join(path26.dirname(manifestPath), "pixelkiln.lock.json");
+      const lockPath = args.explicitLock ? path28.resolve(args.explicitLock) : path28.join(path28.dirname(manifestPath), "pixelkiln.lock.json");
       const ws = await loadWorkspace(workspacePath);
       const id = args.name ?? loadedTarget.manifest.name;
       if (ws.projects.some((p) => p.id === id)) {
@@ -13568,10 +13935,10 @@ async function main() {
         ...args.account ? { account: args.account } : {}
       };
       await saveWorkspace(workspacePath, { version: 1, projects: [...ws.projects, project] });
-      log(`  registered "${id}" in ${path26.relative(process.cwd(), workspacePath)}`);
+      log(`  registered "${id}" in ${path28.relative(process.cwd(), workspacePath)}`);
       log(`    manifest: ${project.manifest}`);
       log(`    lock:     ${project.lock}`);
-      if (!existsSync21(lockPath)) {
+      if (!existsSync22(lockPath)) {
         log(
           `  warning: no lockfile there yet \u2014 this project contributes no claims until one is generated`
         );
@@ -13580,7 +13947,7 @@ async function main() {
     }
     if (args.subcommand === "remove") {
       const ws = await loadWorkspace(workspacePath);
-      const resolvedTarget = path26.resolve(args.target);
+      const resolvedTarget = path28.resolve(args.target);
       const match = ws.projects.find(
         (p) => p.id === args.target || resolveProject(dir, p).manifestPath === resolvedTarget
       );
@@ -13591,11 +13958,11 @@ async function main() {
         version: 1,
         projects: ws.projects.filter((p) => p !== match)
       });
-      log(`  removed "${match.id}" from ${path26.relative(process.cwd(), workspacePath)}`);
+      log(`  removed "${match.id}" from ${path28.relative(process.cwd(), workspacePath)}`);
       return;
     }
     if (args.subcommand === "list") {
-      if (!existsSync21(workspacePath)) {
+      if (!existsSync22(workspacePath)) {
         throw new Error(`Workspace catalog not found: ${workspacePath}`);
       }
       const ws = await loadWorkspace(workspacePath);
@@ -13603,9 +13970,9 @@ async function main() {
       if (args.json) {
         log(JSON.stringify({ version: 1, workspace: workspacePath, projects: ws.projects, diagnostics }, null, 2));
       } else if (!ws.projects.length) {
-        log(`  no projects registered in ${path26.relative(process.cwd(), workspacePath)}`);
+        log(`  no projects registered in ${path28.relative(process.cwd(), workspacePath)}`);
       } else {
-        log(`  ${ws.projects.length} project(s) in ${path26.relative(process.cwd(), workspacePath)}:`);
+        log(`  ${ws.projects.length} project(s) in ${path28.relative(process.cwd(), workspacePath)}:`);
         for (const p of ws.projects) {
           log(`    ${p.id.padEnd(24)} ${p.manifest.padEnd(40)} (${p.provider}${p.account ? `, ${p.account}` : ""})`);
         }
@@ -13615,7 +13982,7 @@ async function main() {
       return;
     }
     if (args.subcommand === "status") {
-      if (!existsSync21(workspacePath)) {
+      if (!existsSync22(workspacePath)) {
         throw new Error(`Workspace catalog not found: ${workspacePath}`);
       }
       const ws = await loadWorkspace(workspacePath);
@@ -13623,7 +13990,7 @@ async function main() {
       if (args.json) {
         log(JSON.stringify({ ...report, workspace: workspacePath }, null, 2));
       } else {
-        log(`  workspace: ${path26.relative(process.cwd(), workspacePath)}`);
+        log(`  workspace: ${path28.relative(process.cwd(), workspacePath)}`);
         for (const p of report.projects) {
           if (p.error) {
             log(`
@@ -13670,8 +14037,8 @@ async function main() {
     }
   }
   if (args.command === "gallery" && args.workspace) {
-    const workspacePath = path26.resolve(args.workspace);
-    if (!existsSync21(workspacePath)) {
+    const workspacePath = path28.resolve(args.workspace);
+    if (!existsSync22(workspacePath)) {
       throw new Error(`Workspace catalog not found: ${workspacePath}`);
     }
     const filter = { styles: args.styles, assets: args.assets };
@@ -13691,7 +14058,7 @@ async function main() {
     const registered = async (projectId) => {
       const project = (await loadWorkspace(workspacePath)).projects.find((candidate) => candidate.id === projectId);
       if (!projectId || !project) throw new Error(`unknown workspace project "${projectId ?? ""}"`);
-      return resolveProject(path26.dirname(workspacePath), project);
+      return resolveProject(path28.dirname(workspacePath), project);
     };
     await runGallery(initial, build, args, {
       manifestFor: async (projectId) => (await registered(projectId)).manifestPath,
@@ -13706,14 +14073,14 @@ async function main() {
     });
     return;
   }
-  if (!existsSync21(path26.resolve(args.manifest))) {
+  if (!existsSync22(path28.resolve(args.manifest))) {
     throw new Error(
-      `No manifest at ${path26.resolve(args.manifest)}. Pass --manifest, or run \`pixelkiln init --from <dir>\`.`
+      `No manifest at ${path28.resolve(args.manifest)}. Pass --manifest, or run \`pixelkiln init --from <dir>\`.`
     );
   }
-  const manifestDir = path26.dirname(path26.resolve(args.manifest));
+  const manifestDir = path28.dirname(path28.resolve(args.manifest));
   const envFiles2 = [...loadEnvFiles(manifestDir)];
-  if (path26.resolve(process.cwd()) !== manifestDir) envFiles2.push(...loadEnvFiles(process.cwd()));
+  if (path28.resolve(process.cwd()) !== manifestDir) envFiles2.push(...loadEnvFiles(process.cwd()));
   const loaded = await loadManifest(args.manifest);
   let specs = await resolveSpecs(loaded, {
     styles: args.styles,
@@ -13786,7 +14153,7 @@ async function main() {
       });
     };
     await runGallery(await build(), reload, args, {
-      manifestFor: () => path26.resolve(args.manifest),
+      manifestFor: () => path28.resolve(args.manifest),
       loadProject: async () => {
         const freshLoaded = await loadManifest(args.manifest);
         const freshSpecs = await resolveSpecs(freshLoaded);
@@ -13797,6 +14164,29 @@ async function main() {
     });
     return;
   }
+  if (args.command === "edit") {
+    if (!args.assets.length) throw new Error("edit needs --only <asset id> (and --style when the asset is in several styles).");
+    if (specs.length !== 1) {
+      throw new Error(
+        specs.length ? `edit works on one asset in one style; --only ${args.assets.join(",")} resolves to ${specs.length}: ` + specs.map((spec2) => `${spec2.styleId}/${spec2.assetId}`).join(", ") + ". Add --style." : "edit matched no asset."
+      );
+    }
+    const spec = specs[0];
+    if (args.subcommand === "detach") {
+      const result = await detachHandEdit(loaded, spec);
+      log(result.changed ? `  detached the hand edit for ${spec.styleId}/${spec.assetId}; the generated art is placed again (the edit file is kept)` : `  ${spec.styleId}/${spec.assetId} has no hand edit`);
+      return;
+    }
+    const started = await startHandEdit(loaded, lock, spec);
+    log(`  ${started.created ? "created" : "found"} ${started.source}${started.declared ? " and declared it as the asset's source" : ""}`);
+    if (args.noOpen) {
+      log(`  edit it with your own tool, then run pixelkiln plan; mount and pack place it in place of the generated art`);
+    } else {
+      const command = openInEditor(started.editPath);
+      log(`  opened with: ${command}${process.env.PIXELKILN_EDITOR ? "" : " (set PIXELKILN_EDITOR to choose the program)"}`);
+    }
+    return;
+  }
   const plan = await buildPlan(specs, lock, { force: args.force });
   if (args.command === "refine") {
     const pathOwnedFlags = [
@@ -13838,7 +14228,7 @@ async function main() {
         log(`  ${item.state.padEnd(16)} ${item.key}  ${item.reason}`);
         if (item.state === "needs-approval") {
           log(
-            `    pixelkiln refine approve --from ${path26.relative(process.cwd(), item.record)} --reviewer "Your Name"`
+            `    pixelkiln refine approve --from ${path28.relative(process.cwd(), item.record)} --reviewer "Your Name"`
           );
         }
       }
@@ -13929,7 +14319,7 @@ async function main() {
       let intact = true;
       for (const output of entry.outputs) {
         const file = resolveOutputPath(output.path, item.spec.root);
-        if (!existsSync21(file) || await sha256File(file) !== output.sha256) {
+        if (!existsSync22(file) || await sha256File(file) !== output.sha256) {
           intact = false;
           break;
         }
@@ -13987,7 +14377,7 @@ async function main() {
     if (args.primaryOnly && args.outputRoles.length) {
       throw new Error("pack accepts either --primary-only or --output-role, not both");
     }
-    const manifestDir2 = path26.dirname(path26.resolve(args.manifest));
+    const manifestDir2 = path28.dirname(path28.resolve(args.manifest));
     const styleIds = args.styles.length ? args.styles : Object.keys(loaded.manifest.styles);
     for (const styleId of styleIds) {
       const packagingSpecs = await resolveSpecs(loaded, { styles: [styleId] });
@@ -13996,10 +14386,11 @@ async function main() {
         columns: args.columns,
         outputRoles: args.outputRoles,
         primaryOnly: args.primaryOnly,
-        sourceOverrides: qualitySources
+        sourceOverrides: qualitySources,
+        sources: manifestSources(loaded.manifest, styleId)
       });
       const style = loaded.manifest.styles[styleId];
-      const base = args.out ? path26.resolve(args.out.replace(/\.png$/, "")) : path26.resolve(manifestDir2, style.outDir, `${styleId}-sheet`);
+      const base = args.out ? path28.resolve(args.out.replace(/\.png$/, "")) : path28.resolve(manifestDir2, style.outDir, `${styleId}-sheet`);
       const outputs = [
         { path: `${base}.png`, data: png },
         { path: `${base}.json`, data: JSON.stringify(atlas, null, 2) + "\n" }
@@ -14029,13 +14420,13 @@ async function main() {
       log(
         `  ${styleId} \u2014 ${atlas.frames.length} sprite(s), ${atlas.sheet.width}x${atlas.sheet.height} in ${atlas.columns} column(s)`
       );
-      log(`    ${path26.relative(process.cwd(), base)}.png + .json + .pixelkiln.json`);
+      log(`    ${path28.relative(process.cwd(), base)}.png + .json + .pixelkiln.json`);
       for (const s of skipped) log(`    skipped ${s.id}: ${s.reason}`);
     }
     return;
   }
   if (args.command === "mount") {
-    const manifestDir2 = path26.dirname(path26.resolve(args.manifest));
+    const manifestDir2 = path28.dirname(path28.resolve(args.manifest));
     const styleIds = args.styles.length ? args.styles : Object.keys(loaded.manifest.styles);
     for (const styleId of styleIds) {
       const style = loaded.manifest.styles[styleId];
@@ -14050,10 +14441,11 @@ async function main() {
       const cells = {};
       const sources = {};
       const outputRoles = {};
+      const styleSources = manifestSources(loaded.manifest, styleId);
       for (const [assetId, asset] of Object.entries(loaded.manifest.assets)) {
         if (!asset.cell) continue;
         cells[assetId] = asset.cell;
-        if (asset.source) sources[assetId] = asset.source;
+        if (styleSources[assetId]) sources[assetId] = styleSources[assetId];
         if (asset.outputRole) outputRoles[assetId] = asset.outputRole;
       }
       const packagingSpecs = await resolveSpecs(loaded, { styles: [styleId] });
@@ -14073,7 +14465,7 @@ async function main() {
         sources,
         outputRoles
       );
-      const out = path26.resolve(manifestDir2, style.mount.out);
+      const out = path28.resolve(manifestDir2, style.mount.out);
       const metadata = out.replace(/\.png$/, "") + ".json";
       const companion = out.replace(/\.png$/, "") + ".pixelkiln.json";
       const outputs = [
@@ -14093,7 +14485,7 @@ async function main() {
           await provenanceFile("$lock", args.lock),
           ...qualityRecords,
           ...artifactSources.filter(
-            (source) => source.id !== "$base" || path26.resolve(source.path) !== out
+            (source) => source.id !== "$base" || path28.resolve(source.path) !== out
           )
         ],
         options: {
@@ -14106,7 +14498,7 @@ async function main() {
       log(
         `  ${styleId} \u2014 ${atlas.frames.length} cell(s) into ${atlas.sheet.width}x${atlas.sheet.height}` + (overBase ? ` over ${style.mount.base}` : " (new sheet)")
       );
-      log(`    ${path26.relative(process.cwd(), out)} + atlas/provenance JSON`);
+      log(`    ${path28.relative(process.cwd(), out)} + atlas/provenance JSON`);
       for (const s of skipped) log(`    skipped ${s.id}: ${s.reason}`);
     }
     return;
@@ -14162,7 +14554,7 @@ async function main() {
   }
   if (args.command === "export") {
     const format = args.format ?? "generic";
-    const manifestDir2 = path26.dirname(path26.resolve(args.manifest));
+    const manifestDir2 = path28.dirname(path28.resolve(args.manifest));
     const selected = specs.filter((spec) => {
       if (spec.generator !== "tiles") return false;
       if (args.styles.length && !args.styles.includes(spec.styleId)) return false;
@@ -14178,12 +14570,12 @@ async function main() {
     for (const spec of selected) {
       const entry = lock.entries[lockKey(spec.styleId, spec.assetId)];
       const style = loaded.manifest.styles[spec.styleId];
-      const defaultBase = path26.resolve(manifestDir2, style.outDir, `${spec.assetId}-tileset`);
-      const base = args.out ? path26.resolve(args.out.replace(/\.(?:png|json|tsj|tres)$/i, "")) : defaultBase;
+      const defaultBase = path28.resolve(manifestDir2, style.outDir, `${spec.assetId}-tileset`);
+      const base = args.out ? path28.resolve(args.out.replace(/\.(?:png|json|tsj|tres)$/i, "")) : defaultBase;
       const result = exportTileset(entry, spec, {
         format,
         manifestDir: manifestDir2,
-        imageName: path26.basename(`${base}.png`),
+        imageName: path28.basename(`${base}.png`),
         columns: args.columns
       });
       const outputs = [
@@ -14201,7 +14593,7 @@ async function main() {
           asset: spec.assetId,
           columns: args.columns ?? null,
           format,
-          image: path26.basename(`${base}.png`),
+          image: path28.basename(`${base}.png`),
           providerRules: result.generic.providerRules,
           style: spec.styleId,
           tileType: spec.tileType ?? null
@@ -14211,7 +14603,7 @@ async function main() {
         `  ${spec.styleId}/${spec.assetId} \u2014 ${result.generic.tiles.length} tile(s), ${result.generic.sheet.width}x${result.generic.sheet.height} (${format})`
       );
       log(
-        `    ${path26.relative(process.cwd(), base)}.png + ${path26.basename(base)}${result.extension} + .pixelkiln.json`
+        `    ${path28.relative(process.cwd(), base)}.png + ${path28.basename(base)}${result.extension} + .pixelkiln.json`
       );
     }
     return;
@@ -14261,12 +14653,12 @@ async function main() {
   tagged ${n} object(s) upstream`);
     }
     if (args.writePrompts) {
-      const { filled, stillEmpty } = await writePromptsBack(path26.resolve(args.manifest), lock, {
+      const { filled, stillEmpty } = await writePromptsBack(path28.resolve(args.manifest), lock, {
         onProgress: log,
         provider: provider.id,
         assetIds: specs.map((spec) => spec.assetId)
       });
-      log(`  recovered ${filled} prompt(s) into ${path26.relative(process.cwd(), args.manifest)}`);
+      log(`  recovered ${filled} prompt(s) into ${path28.relative(process.cwd(), args.manifest)}`);
       const reloaded = await loadManifest(args.manifest);
       const rebased = (await resolveSpecs(reloaded, {
         styles: args.styles,
@@ -14295,12 +14687,12 @@ async function main() {
     const provider = providerFor(selectedAccountProvider);
     const jsonMode = args.dryRun && args.json;
     const diag = jsonMode ? (msg = "") => console.error(msg) : log;
-    const ownLock = path26.resolve(args.lock);
+    const ownLock = path28.resolve(args.lock);
     let workspaceProjects = [];
     let workspaceDir = "";
     if (args.workspace) {
-      const workspacePath = path26.resolve(args.workspace);
-      workspaceDir = path26.dirname(workspacePath);
+      const workspacePath = path28.resolve(args.workspace);
+      workspaceDir = path28.dirname(workspacePath);
       const complete = await requireCompleteWorkspaceClaims(workspacePath);
       workspaceProjects = complete.ws.projects;
       for (const d of complete.diagnostics) diag(`  WARN  ${d.id}: ${d.message}`);
@@ -14309,12 +14701,12 @@ async function main() {
     const lockPaths = [
       .../* @__PURE__ */ new Set([
         ...workspaceLockPaths,
-        ...existsSync21(ownLock) ? [ownLock] : [],
-        ...args.claims.map((c) => path26.resolve(c))
+        ...existsSync22(ownLock) ? [ownLock] : [],
+        ...args.claims.map((c) => path28.resolve(c))
       ])
     ];
     diag(`  claim set (${lockPaths.length} lockfile(s)):`);
-    for (const p of lockPaths) diag(`    ${path26.relative(process.cwd(), p)}`);
+    for (const p of lockPaths) diag(`    ${path28.relative(process.cwd(), p)}`);
     if (!args.claims.length && !args.workspace) {
       diag(
         `
@@ -14322,7 +14714,7 @@ async function main() {
   pass every other project's lockfile via --claims a.json,b.json, or
   register every project in a workspace catalog and pass --workspace.`
       );
-    } else if (args.workspace && !workspaceProjects.some((p) => resolveProject(workspaceDir, p).manifestPath === path26.resolve(args.manifest))) {
+    } else if (args.workspace && !workspaceProjects.some((p) => resolveProject(workspaceDir, p).manifestPath === path28.resolve(args.manifest))) {
       diag(
         `
   This project's manifest is not registered in the workspace catalog. Its own
@@ -14406,7 +14798,7 @@ async function main() {
           manifestPath: loaded.path,
           manifest: accountManifest,
           styleId,
-          importDir: path26.resolve(loaded.root, style.outDir),
+          importDir: path28.resolve(loaded.root, style.outDir),
           lock,
           lockPath: args.lock
         },