scenri 0.6.7 → 0.6.9

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [0.6.9](https://github.com/tonygorb/Scenri/compare/v0.6.8...v0.6.9) (2026-08-29)
+
+
+### Bug Fixes
+
+* a chip click with text selected still opens the picker ([34ea025](https://github.com/tonygorb/Scenri/commit/34ea0257d59920ed0a3abe93771329d75217162b))
+* a chip click with text selected still opens the picker ([1f85306](https://github.com/tonygorb/Scenri/commit/1f85306ef4f19734208921e7c3167acb8596b89b))
+* a refine target never follows you into a fresh Create ([43d32d5](https://github.com/tonygorb/Scenri/commit/43d32d58c3ab679015d800bdbb5b0c02c0444013))
+* a refine target never follows you into a fresh Create ([7e15714](https://github.com/tonygorb/Scenri/commit/7e157141f820ae86a0281f3b949262797baed96a))
+* a refinement chain carries the whole identity record ([4688f0f](https://github.com/tonygorb/Scenri/commit/4688f0f934294789f8fa9222fdc39becba4f0ce8))
+* a refinement chain carries the whole identity record ([f174480](https://github.com/tonygorb/Scenri/commit/f174480c552347d20e110ad2dfc206f70d800aa9))
+* a refinement edits at the source's real shape and holds its resolution ([ccd9be1](https://github.com/tonygorb/Scenri/commit/ccd9be16b2fd609824b5332335c66cf5cc7c06bb))
+* a refinement edits at the source's real shape and holds its resolution ([d2b56af](https://github.com/tonygorb/Scenri/commit/d2b56affead40c51fe7f57bd073b07e8f1e7088d))
+* **codex:** drop 'flawless' from the generation wrapper ([3190495](https://github.com/tonygorb/Scenri/commit/319049580bc97f07d85ddb9cb298451c247cf339))
+* **codex:** drop 'flawless' from the generation wrapper ([7e07836](https://github.com/tonygorb/Scenri/commit/7e078363a0298972944e3b2f2877b6fcc36b992a))
+* photographic skin, real product scale, real hands ([96b8729](https://github.com/tonygorb/Scenri/commit/96b87290a711f0ab250473e116e728493790e155))
+* photographic skin, real product scale, real hands ([51ff91e](https://github.com/tonygorb/Scenri/commit/51ff91e9a71740ab93301a3a4a76216a4734f916))
+* two portrait scenes stop commanding retouch ([58c6542](https://github.com/tonygorb/Scenri/commit/58c6542aeb1bba3e7ca73366a9ed60ecc788bbf3))
+* two portrait scenes stop commanding retouch ([ca92794](https://github.com/tonygorb/Scenri/commit/ca92794636bc7bbe74454d6c37122a16989ed784))
+
+## [0.6.8](https://github.com/tonygorb/Scenri/compare/v0.6.7...v0.6.8) (2026-08-29)
+
+
+### Bug Fixes
+
+* a created scene never refills the next one, and text stays selected ([10d518f](https://github.com/tonygorb/Scenri/commit/10d518f8cc8ba8600f2ad31f72a0c2aea196a530))
+* a created scene never refills the next one, and text stays selected ([3707774](https://github.com/tonygorb/Scenri/commit/3707774dbd1f981919ed96dbf2788f4dc5a316d5))
+* closing a creation ends it, and one Undo brings it back ([24f43ba](https://github.com/tonygorb/Scenri/commit/24f43ba5bcfeb5359e99b5e82a806e5224765462))
+
 ## [0.6.7](https://github.com/tonygorb/Scenri/compare/v0.6.6...v0.6.7) (2026-08-29)
 
 

package/dist/serve.js

@@ -1483,7 +1483,10 @@ function createOpenRouterEngine(opts) {
               ...editRefs.map((p) => ({ type: "image_url", image_url: { url: dataUrl(p) } }))
             ]
           }
-        ]
+        ],
+        // Mirrors generate: an edit given no shape answered at whatever ratio
+        // the model felt like, and the drift compounded down refine chains.
+        ...req.width && req.height ? { image_config: { aspect_ratio: aspectRatioFor(req.width, req.height) } } : {}
       };
       const json = await post(key, body, signal);
       const [buf] = extractImages(json);
@@ -2692,7 +2695,14 @@ function createCodexEngine(opts) {
     const refDirectives = roles.map(
       (role, i) => roles.length > 1 ? `Attached image ${i + 1} is ${roleDirective[role]}.` : `The attached image is ${roleDirective[role]}.`
     ).join(" ");
-    return `Generate one flawless, professional-grade image immediately using your image generation tool, ${req.width}x${req.height}: ${req.prompt}.` + (refDirectives ? ` ${refDirectives}` : "") + ` Do not browse the web or explore files. Save the image in the current directory as out-1.png (you may run the commands needed to save and resize it). Nothing else.` + (index > 0 ? ` (variant ${index + 1} \u2014 same brief, different composition)` : "");
+    return (
+      // "professional-grade", not "flawless": the audit of the waxy-presenter
+      // report traced part of the plastic, over-perfected rendering to that
+      // one unconditional word. Still "image", never "photograph" - this
+      // wrapper also generates graphic assets. Independently revertible on
+      // render evidence.
+      `Generate one professional-grade image immediately using your image generation tool, ${req.width}x${req.height}: ${req.prompt}.` + (refDirectives ? ` ${refDirectives}` : "") + ` Do not browse the web or explore files. Save the image in the current directory as out-1.png (you may run the commands needed to save and resize it). Nothing else.` + (index > 0 ? ` (variant ${index + 1} \u2014 same brief, different composition)` : "")
+    );
   }
 }
 
@@ -2773,7 +2783,13 @@ function createDemoEngine(saveImage) {
     },
     async edit(req) {
       const colors = paletteOf(req);
-      const buf = await render(colors, `edit: ${req.instruction}`, 1024, 1024, req.instruction.length);
+      const buf = await render(
+        colors,
+        `edit: ${req.instruction}`,
+        req.width ?? 1024,
+        req.height ?? 1024,
+        req.instruction.length
+      );
       return { images: [saveImage(buf)], costUsd: 0 };
     }
   };
@@ -2916,6 +2932,7 @@ async function resolvePresenterImages(core, templatesRoot, presenter) {
     name: presenter.name,
     ...presenter.identityNotes ? { identityNotes: presenter.identityNotes } : {},
     ...presenter.negativeConstraints?.length ? { negativeConstraints: presenter.negativeConstraints } : {},
+    ...presenter.skin ? { skin: presenter.skin } : {},
     shots
   };
 }
@@ -3019,7 +3036,14 @@ async function resolveDemoProductImages(core, templatesRoot, product) {
     // brushed steel case read as steel rather than plastic. They were being
     // dropped here, so the compiler never saw them.
     ...product.materials ? { materials: product.materials } : {},
-    ...product.primaryColors ? { primaryColors: product.primaryColors } : {}
+    ...product.primaryColors ? { primaryColors: product.primaryColors } : {},
+    // The description is the only text a demo product has that carries scale
+    // ("sized for a facial serum or treatment oil") - dropping it here is why
+    // a cream jar could render the size of a basketball. And category is what
+    // arms the compiler's apparel guard; without it no demo garment ever
+    // earned the "present it as a product" line.
+    ...product.description ? { description: product.description } : {},
+    ...product.category ? { category: product.category } : {}
   };
 }
 async function brandJsonWithResolvedDemoProducts(core, templatesRoot, demoProducts, brandJson, tokens) {
@@ -3127,6 +3151,38 @@ function editPreservationDirective(scope, opts) {
 function inheritedIdentityDirective() {
   return "The extra attached references are the same product and the same person that are already in this picture. Use them to hold that identity exact while you make the change, not as a reason to re-stage the shot.";
 }
+function productFactDirectives(p) {
+  const out = [];
+  if (p.preservationNotes) out.push(String(p.preservationNotes));
+  if (p.negativeConstraints) out.push(`Avoid: ${p.negativeConstraints}`);
+  const materials = p.materials ?? p.material;
+  if (materials) out.push(`Its materials and finish: ${materials}.`);
+  if (p.primaryColors) out.push(`Its actual colors: ${p.primaryColors}.`);
+  if (p.dimensions)
+    out.push(`Its real-world size is ${p.dimensions} \u2014 keep it at true scale relative to everything else in frame.`);
+  return out;
+}
+function characterFactDirectives(c) {
+  const out = [];
+  if (c.identityNotes) out.push(String(c.identityNotes));
+  if (c.negativeConstraints?.length) out.push(`Avoid: ${[].concat(c.negativeConstraints).join(", ")}`);
+  return out;
+}
+function productEditFidelityDirective(name) {
+  return `Every attached product reference shows ${name}, the exact product already in this photograph: hold its label, shape, colours and proportions to what the references and the photograph agree on while you make the change, and never treat an extra angle as a second product. Any face of it no reference shows stays exactly as the photograph already has it.`;
+}
+function characterEditIdentityDirective(name) {
+  return `${name} is the person in this photograph: keep them present and clearly visible. Match their face, facial structure, skin, hair and build to the attached person reference exactly. The reference's plain outfit and studio backdrop are capture conditions, not direction: keep the styling this photograph already has unless the instruction itself changes it, and never return them to the plain base layers they were photographed in.`;
+}
+function markEditDirective() {
+  return "The attached brand mark is this brand's own mark: wherever the logo appears or the instruction asks for it, reproduce it exactly as drawn \u2014 same colours, letterforms and proportions \u2014 never redrawn or re-lettered.";
+}
+function personSkinDirective() {
+  return "Every person in this photograph has real photographed skin: fine natural texture at pore scale, faint lines and natural asymmetry left intact, true-to-life proportions, never airbrushed, waxy, plastic or synthetic-looking. Light behaves physically on it: a hard flash or a specular key may genuinely shine on skin, but the surface underneath stays living skin in a photograph, never gloss, never a render. Any retouch, clarity or sharpness language in the direction above is about finish and focus, never a licence to smooth skin beyond what a professional photograph holds; if the direction above explicitly asks for a stylised or non-photographic treatment of the person, that explicit request wins.";
+}
+function productHandlingDirective() {
+  return "Where the presenter touches the product, they handle it the way a real person handles an object of exactly that size and weight: a natural grip, fingers wrapping in genuine contact with its surface, hand and wrist at anatomically real angles, the product supported by that grip rather than floating. If the direction above explicitly stages the product away from their hands or in an impossible way, that explicit direction wins.";
+}
 function garmentDisplayDirective() {
   return "No person is part of this brief. Present the garment as a product, laid, hung, folded or dressed on a plain form, never on a person, a partial figure or an invisible body, unless the direction above explicitly asks for it worn.";
 }
@@ -3315,14 +3371,10 @@ function compileBrief(brief, ctx) {
             attachments.push({ role: "product", id: p.id, label: p.name, hash: h, essential: i === 0 });
           });
           productDirectives.push(productFidelityDirective(phashes.length));
-          if (p.preservationNotes) productDirectives.push(String(p.preservationNotes));
-          if (p.negativeConstraints) productDirectives.push(`Avoid: ${p.negativeConstraints}`);
-          const materials = p.materials ?? p.material;
-          if (materials) productDirectives.push(`Its materials and finish: ${materials}.`);
-          if (p.primaryColors) productDirectives.push(`Its actual colors: ${p.primaryColors}.`);
-          if (p.dimensions)
+          productDirectives.push(...productFactDirectives(p));
+          if (p.description && !p.dimensions)
             productDirectives.push(
-              `Its real-world size is ${p.dimensions} \u2014 keep it at true scale relative to everything else in frame.`
+              `What this object physically is: ${String(p.description).replace(/\.\s*$/, "")}. Keep it at that real size relative to hands, faces, furniture and everything else in frame.`
             );
         } else {
           warnings.push(`${p.name} has no usable photo, so it is named but not attached.`);
@@ -3348,9 +3400,11 @@ function compileBrief(brief, ctx) {
           personDirectives.push(
             "The attached person reference is the same person every time: match their face, facial structure, skin, hair and build exactly. Their outfit, pose, background and lighting are neutral studio capture conditions, not styling direction: dress and style them for this shot, to a commercial standard, following any wardrobe the direction itself specifies. Where the direction specifies none, dress them for the place and the occasion the frame shows, and never return them to the plain base layers they were photographed in."
           );
-          if (c.identityNotes) personDirectives.push(String(c.identityNotes));
-          if (c.negativeConstraints?.length)
-            personDirectives.push(`Avoid: ${[].concat(c.negativeConstraints).join(", ")}`);
+          personDirectives.push(...characterFactDirectives(c));
+          if (c.skin)
+            personDirectives.push(
+              `${c.promptName ?? c.name}'s skin, exactly as the reference photographs show it: ${c.skin}.`
+            );
         } else {
           warnings.push(`${c.name} has no usable photo, so they are named but not attached.`);
         }
@@ -3466,7 +3520,8 @@ function compileBrief(brief, ctx) {
     // the compiler: fired only when a person is attached, worded like
     // the mark exception — the ban stays for invented people, the
     // attached one is deliberate.
-    "Any earlier instruction that bans props, hands, people, or a presenter from the frame is a solo-packshot rule for this product and does not apply to this shot: the attached presenter is deliberate and must appear as directed."
+    "Any earlier instruction that bans props, hands, people, or a presenter from the frame is a solo-packshot rule for this product and does not apply to this shot: the attached presenter is deliberate and must appear as directed.",
+    productHandlingDirective()
   ] : [];
   const figureDirectives = scene?.figure ? sceneFigureDirectives({
     figure: scene.figure,
@@ -3476,13 +3531,15 @@ function compileBrief(brief, ctx) {
     // deliberately in play; attachments are fully collected by this point.
     hasMark: attachments.some((a) => a.role === "brand")
   }) : [];
+  if (hasPerson) personDirectives.push(personSkinDirective());
   const closeUpDirectives = hasPerson && /\bclose[- ]?up\b|\bmacro\b|\bzoom(?:ed)?\b|\bDOF\b|\bdepth of field\b/i.test(sentence) ? [
     "The tight framing includes the presenter: keep at least their hand in genuine contact with the product, and as much more of them as the crop allows. A close-up is never a reason to leave the person out of the photograph."
   ] : [];
   const brandLines = brandRuleDirectives(ctx.brand);
   const preservation = ctx.mode === "edit" ? [
     ...ctx.editReshape === "extend" ? [] : [editPreservationDirective(ctx.editScope ?? "global", { removal: ctx.editRemoval })],
-    ...ctx.inheritedIdentity ? [inheritedIdentityDirective()] : []
+    ...ctx.inheritedIdentity ? [inheritedIdentityDirective()] : [],
+    ...ctx.inheritedDirectives ?? []
   ] : [];
   const apparelUnworn = ctx.mode !== "edit" && !hasPerson && attachments.some((a) => {
     if (a.role !== "product" || !a.id) return false;
@@ -6259,23 +6316,34 @@ function registerAccessGuard(app, opts = {}) {
 }
 
 // src/editIdentity.ts
-var MAX_HOPS = 8;
-var tokensOf = (node) => {
-  const t = node?.brief?.tokens;
-  return Array.isArray(t) ? t : [];
-};
+var MAX_HOPS = 64;
+var IDENTITY_KINDS = /* @__PURE__ */ new Set(["product", "character", "mark", "ref"]);
+var identityOf = (list2) => Array.isArray(list2) ? list2.filter((t) => IDENTITY_KINDS.has(t?.t)) : [];
 function inheritedIdentityTokens(parentId, getNode) {
   let id = parentId;
+  const visited = /* @__PURE__ */ new Set();
   for (let hop = 0; hop < MAX_HOPS && id; hop++) {
+    if (visited.has(id)) return { tokens: [], truncated: false };
+    visited.add(id);
     const node = getNode(id);
-    if (!node || node.kind === "root") return [];
-    const identity = tokensOf(node).filter(
-      (t) => t.t === "product" || t.t === "character" || t.t === "mark" || t.t === "ref"
-    );
-    if (identity.length) return identity;
+    if (!node || node.kind === "root") return { tokens: [], truncated: false };
+    const brief = node.brief;
+    const own = identityOf(brief?.tokens);
+    const carried = identityOf(brief?.inherited);
+    if (own.length || carried.length) {
+      const seen = /* @__PURE__ */ new Set();
+      const tokens = [];
+      for (const t of [...own, ...carried]) {
+        const key = JSON.stringify(t);
+        if (seen.has(key)) continue;
+        seen.add(key);
+        tokens.push(t);
+      }
+      return { tokens, truncated: false };
+    }
     id = node.parentId;
   }
-  return [];
+  return { tokens: [], truncated: id !== null };
 }
 
 // src/editScopeRules.ts
@@ -6356,6 +6424,13 @@ function planExpand(source, targetRatio) {
     axis: "height"
   };
 }
+function wantsImplicitReshape(requested, parentNominal, sourcePixels) {
+  const base = parentNominal ?? sourcePixels;
+  if (!(requested.width > 0 && requested.height > 0 && base.width > 0 && base.height > 0)) return false;
+  const want = requested.width / requested.height;
+  const have = base.width / base.height;
+  return Math.abs(want - have) / have > 0.01;
+}
 function expandInstruction(plan, direction) {
   const where = plan.axis === "width" ? "left and right" : "top and bottom";
   const nearEdge = plan.axis === "height" ? "\nDepth: the bottom edge of the frame is the part of the surface nearest the camera; the top edge is the furthest away." : "";
@@ -6406,6 +6481,20 @@ Keep: every object in the same place at the same size, the same camera position
 Avoid: new objects, products, people, text or watermarks; do not recompose, recentre, crop or resize anything already visible.` + own;
 }
 
+// src/editSizeRules.ts
+var SAME_SHAPE_TOL = 0.01;
+var SHRINK_FLOOR = 0.8;
+function judgeEditSize(src, got) {
+  if (!(src.width > 0 && src.height > 0 && got.width > 0 && got.height > 0)) return { action: "keep" };
+  if (got.width === src.width && got.height === src.height) return { action: "keep" };
+  const want = src.width / src.height;
+  const have = got.width / got.height;
+  if (Math.abs(have - want) / want > SAME_SHAPE_TOL) return { action: "keep" };
+  const scale = Math.max(got.width, got.height) / Math.max(src.width, src.height);
+  if (scale < SHRINK_FLOOR) return { action: "reject", scale };
+  return { action: "resize", scale };
+}
+
 // src/cropRules.ts
 function planCrop(source, targetRatio) {
   if (!(source.width > 0 && source.height > 0 && targetRatio > 0)) return null;
@@ -8075,6 +8164,39 @@ function registerImageRoutes(app, deps) {
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.6.9",
+    date: "2026-08-29",
+    title: "Refinements keep the shot.",
+    sections: [
+      {
+        heading: "Refine",
+        body: "Refining a shot no longer wears it down. Every refinement keeps the original resolution, an answer that comes back too small is restored to the frame or refused rather than quietly shrinking the thread, and a plain refinement stays a plain refinement instead of silently rebuilding the frame when an engine drifted its shape. The product, the presenter, the brand mark and your references now travel down the whole chain, together with what must hold about each of them, so the tenth refinement knows the shot as well as the first."
+      },
+      {
+        heading: "Presenters",
+        body: "People render with real photographed skin: natural texture and fine lines stay, and the waxy, over-retouched gloss goes. Light still behaves like light, so a hard flash can genuinely shine. Products hold their real-world size in the frame, and a held product sits in a real grip instead of floating beside the hand. Asking for something surreal still wins."
+      },
+      {
+        heading: "Create",
+        body: "Starting a fresh shot always starts fresh: a refinement you left open days ago can no longer greet you as the thing you are about to make. Refining any older shot still works exactly as before, whenever you come back to it. Around the chips, text selects, double-clicks and keyboard selection behave like any editor, and clicking a chip while text is selected opens its picker."
+      }
+    ]
+  },
+  {
+    version: "0.6.8",
+    date: "2026-08-29",
+    sections: [
+      {
+        heading: "Create dialogs",
+        body: "A new product, presenter or scene starts from an empty form, every time. Closing one now ends it rather than keeping what you typed for later, so nothing you walked away from can turn up in the next one, and the message that says so offers Undo if you did not mean to close it. A build that fails still hands everything back, photographs included, so trying again never asks for them twice. A reference you remove stays removed, even when another upload was still running, and a scene that was built while the app was restarting no longer leaves its references waiting in the next form."
+      },
+      {
+        heading: "Create",
+        body: "Selecting text in the brief with the mouse holds, instead of clearing the moment you let go."
+      }
+    ]
+  },
   {
     version: "0.6.7",
     date: "2026-08-29",
@@ -8972,7 +9094,8 @@ function buildServer(opts) {
   registerShowcaseRoutes(app, { templatesRoot });
   app.get("/api/formats", async () => FORMATS);
   async function compileEditBrief(brandId, parentId, brief, engineCaps, opts2) {
-    const borrowed = inheritedIdentityTokens(parentId, (id) => core.store.getNode(id));
+    const inherited = inheritedIdentityTokens(parentId, (id) => core.store.getNode(id));
+    const borrowed = inherited.tokens;
     const already = new Set(
       brief.tokens.filter((t) => t.t === "product" || t.t === "character" || t.t === "mark" || t.t === "ref").map((t) => JSON.stringify(t))
     );
@@ -8996,6 +9119,28 @@ function buildServer(opts) {
     const verdict = scopeOfInstruction(
       brief.tokens.filter((t) => t.t === "text").map((t) => t.v).join(" ")
     );
+    const inheritedDirectives = [];
+    let inheritedMark = false;
+    for (const tok of inheritedTokens) {
+      if (tok.t === "product") {
+        const rec = (brandJson?.products ?? []).find((x) => x?.id === tok.id);
+        if (rec)
+          inheritedDirectives.push(
+            productEditFidelityDirective(rec.promptName ?? rec.name),
+            ...productFactDirectives(rec)
+          );
+      } else if (tok.t === "character") {
+        const rec = (brandJson?.characters ?? []).find((x) => x?.id === tok.id);
+        if (rec)
+          inheritedDirectives.push(
+            characterEditIdentityDirective(rec.promptName ?? rec.name),
+            ...characterFactDirectives(rec)
+          );
+      } else if (tok.t === "mark" && !inheritedMark) {
+        inheritedMark = true;
+        inheritedDirectives.push(markEditDirective());
+      }
+    }
     const compiled2 = compileBrief(brief, {
       brand: brandJson,
       images: core.images,
@@ -9006,6 +9151,7 @@ function buildServer(opts) {
       editScope: verdict.scope,
       editRemoval: verdict.removal ?? false,
       inheritedIdentity: inheritedTokens.length > 0,
+      inheritedDirectives,
       // Only the explicit op drops the dimension promise: an implicit legacy
       // expansion keeps its historical prompt byte for byte.
       ...opts2?.reshape === "extend" ? { editReshape: "extend" } : {}
@@ -9018,23 +9164,35 @@ function buildServer(opts) {
         { brand: brandJson, images: core.images, engineCaps: uncapped, templateById: sceneById }
       );
       identityWarnings = identity.warnings;
-      inheritedAttachments = identity.attachments.filter((a) => a.essential || a.role === "brand" || a.role === "reference").map((a) => ({ ...a, inherited: true }));
+      const productAngles = /* @__PURE__ */ new Map();
+      inheritedAttachments = identity.attachments.filter((a) => {
+        if (a.role === "product") {
+          const n = (productAngles.get(String(a.id ?? a.hash)) ?? 0) + 1;
+          productAngles.set(String(a.id ?? a.hash), n);
+          return n <= 2;
+        }
+        return a.essential || a.role === "brand" || a.role === "reference";
+      }).map((a) => ({ ...a, inherited: true }));
     }
     const cap2 = Math.max(0, engineCaps.maxReferenceImages - 1);
     const merged = mergeEditAttachments(compiled2.attachments, inheritedAttachments, cap2);
     const warnings = [...compiled2.warnings, ...identityWarnings.filter((w) => !compiled2.warnings.includes(w))];
+    if (inherited.truncated)
+      warnings.push("This thread is deeper than 64 steps, so identity attached before that could not be carried.");
     if (merged.dropped.length) {
       if (engineCaps.maxReferenceImages <= 1) {
         warnings.push(
           `${engineCaps.displayName} cannot carry reference images, so the identity rides on the source frame alone.`
         );
       } else {
-        const names = [...new Set(merged.dropped.map((d) => d.label))];
-        warnings.push(
-          `${engineCaps.displayName} reads ${engineCaps.maxReferenceImages} reference images and the frame being refined keeps one, so ${names.join(
-            " and "
-          )} ${names.length === 1 ? "was" : "were"} left out.`
-        );
+        const keptLabels = new Set(merged.kept.map((a) => a.label));
+        const names = [...new Set(merged.dropped.map((d) => d.label))].filter((l) => !keptLabels.has(l));
+        if (names.length)
+          warnings.push(
+            `${engineCaps.displayName} reads ${engineCaps.maxReferenceImages} reference images and the frame being refined keeps one, so ${names.join(
+              " and "
+            )} ${names.length === 1 ? "was" : "were"} left out.`
+          );
       }
     }
     return {
@@ -9435,7 +9593,13 @@ function buildServer(opts) {
       const srcBuf = core.images.read(String(srcHash));
       const srcMeta = await sharp7(srcBuf).metadata();
       if (srcMeta.width && srcMeta.height) expectShape = { width: srcMeta.width, height: srcMeta.height };
-      if (srcMeta.width && srcMeta.height && compiled2?.width && compiled2?.height) {
+      const parentFormat = parent?.brief?.tokens?.find((t) => t?.t === "format");
+      const parentNominal = parentFormat && Number(parentFormat.w) > 0 && Number(parentFormat.h) > 0 ? { width: Number(parentFormat.w), height: Number(parentFormat.h) } : null;
+      const reshapeIntended = reshape === "extend" || reshape === void 0 && !!srcMeta.width && !!srcMeta.height && !!compiled2?.width && !!compiled2?.height && wantsImplicitReshape({ width: compiled2.width, height: compiled2.height }, parentNominal, {
+        width: srcMeta.width,
+        height: srcMeta.height
+      });
+      if (reshapeIntended && srcMeta.width && srcMeta.height && compiled2?.width && compiled2?.height) {
         expandPlan = planExpand({ width: srcMeta.width, height: srcMeta.height }, compiled2.width / compiled2.height);
       }
       if (reshape === "extend" && !expandPlan)
@@ -9465,8 +9629,12 @@ function buildServer(opts) {
         ...editRefs.length ? { referenceImages: editRefs.map((r) => r.path) } : {},
         ...editRefs.length ? { referenceRoles: editRefs.map((r) => r.role ?? "reference") } : {},
         // An answer at the planned size lets compositeExpand skip its rescale,
-        // which is one whole class of seam misalignment gone when honored.
-        ...expandPlan ? { width: expandPlan.width, height: expandPlan.height } : {},
+        // which is one whole class of seam misalignment gone when honored. A
+        // plain refine states the source's own pixels for the same reason:
+        // engines given no size answered at whatever size they liked, the
+        // shrunken answer was stored, and the next refinement inherited it —
+        // the chain that walked shots down to thumbnails.
+        ...expandPlan ? { width: expandPlan.width, height: expandPlan.height } : srcMeta.width && srcMeta.height ? { width: srcMeta.width, height: srcMeta.height } : {},
         // Only an engine that can genuinely paint a margin is told where the
         // picture sits; the rest would ignore it anyway.
         ...expandPlan && canOutpaint2 ? {
@@ -9567,6 +9735,38 @@ function buildServer(opts) {
     const plan = expandPlan;
     const original = editedFrom ? core.images.read(editedFrom) : null;
     const localScope = kind === "edit" && !plan && editScope === "local" && original;
+    const enforceEditCanvas = async (images) => {
+      const srcMeta = await sharp7(original).metadata();
+      if (!srcMeta.width || !srcMeta.height) return images;
+      const out = [];
+      for (const h of images) {
+        const meta2 = await sharp7(core.images.read(h)).metadata();
+        const got = { width: meta2.width ?? 0, height: meta2.height ?? 0 };
+        const verdict = judgeEditSize({ width: srcMeta.width, height: srcMeta.height }, got);
+        if (verdict.action === "reject")
+          throw new Error(
+            `engine returned ${got.width}x${got.height} for a ${srcMeta.width}x${srcMeta.height} frame: too little of the picture came back to keep at this resolution`
+          );
+        if (verdict.action === "resize") {
+          app.log.info(
+            { nodeId: node.id, got: `${got.width}x${got.height}`, want: `${srcMeta.width}x${srcMeta.height}` },
+            "edit: normalized the answer to the source canvas"
+          );
+          out.push(
+            core.images.save(
+              await sharp7(core.images.read(h)).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).png().toBuffer()
+            )
+          );
+          try {
+            const fresh = core.store.getNode(node.id);
+            const b = fresh?.brief ?? {};
+            core.store.setBrief(node.id, { ...b, resizedFrom: [got.width, got.height] });
+          } catch {
+          }
+        } else out.push(h);
+      }
+      return out;
+    };
     const post = plan ? expandMethod === "outpaint" ? async (images) => {
       const out = [];
       for (const h of images) {
@@ -9595,14 +9795,18 @@ function buildServer(opts) {
           "expand: chose which frame to keep"
         );
       return images;
-    } : localScope ? async (images) => {
-      const out = [];
-      for (const h of images) {
-        const { image, outcome, changed } = await preserveOutsideChange(original, core.images.read(h));
-        app.log.info({ nodeId: node.id, outcome, changed }, "local edit");
-        out.push(outcome === "composited" ? core.images.save(image) : h);
+    } : kind === "edit" && original ? async (images) => {
+      let staged = images;
+      if (localScope) {
+        const out = [];
+        for (const h of staged) {
+          const { image, outcome, changed } = await preserveOutsideChange(original, core.images.read(h));
+          app.log.info({ nodeId: node.id, outcome, changed }, "local edit");
+          out.push(outcome === "composited" ? core.images.save(image) : h);
+        }
+        staged = out;
       }
-      return out;
+      return enforceEditCanvas(staged);
     } : void 0;
     const nodeBudgetMs = kind === "generation" && runEngine.capabilities().id === "codex-cli" ? codexNodeBudgetMs(Math.min(Math.max(1, Number(count)), 8)) : void 0;
     void runNode(node.id, runEngine, estimate, work, expectShape, post, nodeBudgetMs).catch(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scenri",
-  "version": "0.6.7",
+  "version": "0.6.9",
   "author": "Tony Gorb <hello@scenri.co>",
   "license": "AGPL-3.0-only",
   "type": "module",