scenri 0.6.8 → 0.6.10

package/dist/serve.js

@@ -1310,6 +1310,28 @@ var EDIT_REFERENCE_ROLE_DIRECTIVE = {
   reference: "a reference for composition, lighting and treatment only"
 };
 var ASPECT_TOLERANCE = 0.15;
+var NAMED_RATIOS = [
+  ["1:1", 1],
+  ["4:5", 4 / 5],
+  ["5:4", 5 / 4],
+  ["2:3", 2 / 3],
+  ["3:2", 3 / 2],
+  ["3:4", 3 / 4],
+  ["4:3", 4 / 3],
+  ["9:16", 9 / 16],
+  ["16:9", 16 / 9],
+  ["2:1", 2],
+  ["1:2", 0.5]
+];
+function ratioLabel(width, height) {
+  const ratio = width / height;
+  for (const [label, value] of NAMED_RATIOS) {
+    if (Math.abs(ratio - value) / value < 0.02) return label;
+  }
+  const gcd = (a, b) => b ? gcd(b, a % b) : a;
+  const d = gcd(width, height) || 1;
+  return `${Math.round(width / d)}:${Math.round(height / d)}`;
+}
 
 // ../core/src/index.ts
 function defaultHome() {
@@ -1483,7 +1505,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);
@@ -2476,6 +2501,27 @@ var CODEX_POOL = 2;
 function codexNodeBudgetMs(count) {
   return Math.ceil(Math.max(1, count) / CODEX_POOL) * DEFAULT_TIMEOUT_MS2 + 6e4;
 }
+function orientationOf(width, height) {
+  return width === height ? "square" : width > height ? "landscape" : "portrait";
+}
+var CODEX_PIXEL_BUDGET = 1572864;
+function codexNativeSize(width, height) {
+  const ratio = width / height;
+  if (!(ratio > 0) || !Number.isFinite(ratio)) return { width, height };
+  return {
+    width: Math.round(Math.sqrt(CODEX_PIXEL_BUDGET * ratio)),
+    height: Math.round(Math.sqrt(CODEX_PIXEL_BUDGET / ratio))
+  };
+}
+function refFileNames(roles, count) {
+  const perRole = /* @__PURE__ */ new Map();
+  return Array.from({ length: count }, (_, i) => {
+    const role = roles[i] ?? "reference";
+    const n = (perRole.get(role) ?? 0) + 1;
+    perRole.set(role, n);
+    return `${role}-${n}.png`;
+  });
+}
 function createCodexEngine(opts) {
   const { saveImage } = opts;
   const platform = opts.platform ?? process.platform;
@@ -2508,7 +2554,9 @@ function createCodexEngine(opts) {
     }
     const hashes = [];
     for (const name of outFiles) {
-      hashes.push(saveImage(await readFile(join(dir, name))));
+      const buf = await readFile(join(dir, name));
+      if (buf.length === 0) throw new Error(`codex: ${name} is empty`);
+      hashes.push(saveImage(buf));
     }
     return hashes;
   }
@@ -2555,6 +2603,11 @@ function createCodexEngine(opts) {
          * attached — and on an edit the first one attached is `input.png`, the
          * shot being edited. A refine carrying a full identity payload was
          * silently editing nothing at all.
+         *
+         * That same backwards walk is why every reference is bound to its role
+         * by FILENAME (refFileNames) on both paths: the tool decides which
+         * pictures it surfaces and in what order, so an ordinal "Attached
+         * image N" binding pointed identity claims at the wrong picture.
          */
         maxReferenceImages: 5,
         /*
@@ -2586,8 +2639,9 @@ function createCodexEngine(opts) {
         (_, i) => async () => withWorkDir(async (dir) => {
           const args = execArgs(dir);
           let refBytes = 0;
+          const names = refFileNames(roles, refs.length);
           for (const [idx, ref] of refs.entries()) {
-            const dest = join(dir, `ref-${idx}.png`);
+            const dest = join(dir, names[idx]);
             await copyFile(ref, dest);
             refBytes += (await stat(dest)).size;
             args.splice(args.length - 1, 0, `--image=${dest}`);
@@ -2663,9 +2717,15 @@ function createCodexEngine(opts) {
           await copyFile(editRefs[i], join(dir, name));
           refLines.push(`${name} shows ${EDIT_REFERENCE_ROLE_DIRECTIVE[role]}`);
         }
-        const promptText = `Edit input.png using your image generation/editing tool: ${req.instruction}.` + (refLines.length ? ` ${refLines.join(". ")}.` : "") + ` Do not browse the web or explore files. Save the result in the current directory as out-1.png (you may run the commands needed to save and resize it).` + // sips is already licensed by the parenthesis above; an exact-size
-        // answer lets the caller's compositing pass skip its rescale.
-        (req.width && req.height ? ` Save the result at exactly ${req.width}x${req.height} pixels.` : "") + ` Nothing else.`;
+        const promptText = `Edit input.png using your image generation/editing tool: ${req.instruction}.` + (refLines.length ? ` ${refLines.join(". ")}.` : "") + // The old tail licensed "the commands needed to save and resize it"
+        // and then asked for exactly WxH pixels - which the model honoured
+        // with sips -z, a force-fit of BOTH axes. Every refine hop was a
+        // cheap-kernel shell resample of freshly generated pixels, and when
+        // the tool had drifted the shape it was a shear: the reported
+        // crushed faces and the deep-chain mush. The server's own canvas
+        // pass (enforceEditCanvas) owns size now, with one uniform lanczos
+        // only when actually needed.
+        (req.width && req.height ? ` Keep the edited frame at input.png's own ${ratioLabel(req.width, req.height)} shape, ${codexNativeSize(req.width, req.height).width}x${codexNativeSize(req.width, req.height).height}.` : "") + ` Do not browse the web or explore files. Save the tool's output in the current directory as out-1.png, byte-for-byte unchanged: you may run the commands needed to copy or move the file, but never resize, scale, stretch, pad, crop or re-encode it \u2014 deliver the tool's own pixels at the tool's own size. Nothing else.`;
         const args = execArgs(dir);
         for (const name of ["input.png", ...refLines.map((_, i) => `${editRoles[i] ?? "reference"}-${i + 1}.png`)]) {
           args.splice(args.length - 1, 0, `--image=${join(dir, name)}`);
@@ -2689,10 +2749,30 @@ function createCodexEngine(opts) {
   }
   function buildPrompt2(req, index, roles) {
     const roleDirective = REFERENCE_ROLE_DIRECTIVE;
-    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)` : "");
+    const names = refFileNames(roles, roles.length);
+    const refDirectives = roles.map((role, i) => `${names[i]} shows ${roleDirective[role]}.`).join(" ");
+    const count = Math.max(1, req.count);
+    const native = codexNativeSize(req.width, req.height);
+    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, composed as a ${native.width}x${native.height} frame (${ratioLabel(req.width, req.height)} ${orientationOf(req.width, req.height)}): ${req.prompt}.` + (refDirectives ? ` ${refDirectives}` : "") + // The save instruction bans what the old one licensed. "you may run the
+      // commands needed to save and resize it" invited sips -z, which
+      // force-fits BOTH axes: the model drew at one shape, sheared the pixels
+      // to the requested one, and the aspect check passed BECAUSE of the shear
+      // - the reported crushed faces. Copy/move stays licensed because the
+      // win32 recovery path moves files out of generated_images.
+      ` Do not browse the web or explore files. Save the tool's output in the current directory as out-1.png, byte-for-byte unchanged: you may run the commands needed to copy or move the file, but never resize, scale, stretch, pad, crop or re-encode it \u2014 deliver the tool's own pixels at the tool's own size. Nothing else.` + // Every take in a batch gets the SAME-shaped clause. Take 1 used to get
+      // nothing - so the first output was literally asked for the most
+      // reference-faithful decode - and later takes were licensed to a
+      // "different composition", which read as permission to drift from the
+      // directives. Reported as: output #1 copies the scene reference, output
+      // #2 mixes identities. A single generation stays byte-stable.
+      (count > 1 ? ` (take ${index + 1} of ${count} \u2014 same brief, same identities and constraints, a naturally different moment and framing of the same shoot)` : "")
+    );
   }
 }
 
@@ -2773,7 +2853,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 +3002,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 +3106,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 +3221,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 +3441,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 +3470,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 +3590,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 +3601,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 +6386,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 +6494,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." : "";
@@ -6367,28 +6512,6 @@ Continue: the same surface, the same light direction, the same colour temperatur
 Constraints: change only the blurred margin; keep the sharp photograph unchanged in position, scale and content.
 Avoid: new objects, products, people, text or watermarks.` + own;
 }
-var NAMED_RATIOS = [
-  ["1:1", 1],
-  ["4:5", 4 / 5],
-  ["5:4", 5 / 4],
-  ["2:3", 2 / 3],
-  ["3:2", 3 / 2],
-  ["3:4", 3 / 4],
-  ["4:3", 4 / 3],
-  ["9:16", 9 / 16],
-  ["16:9", 16 / 9],
-  ["2:1", 2],
-  ["1:2", 0.5]
-];
-function ratioLabel(width, height) {
-  const ratio = width / height;
-  for (const [label, value] of NAMED_RATIOS) {
-    if (Math.abs(ratio - value) / value < 0.02) return label;
-  }
-  const gcd = (a, b) => b ? gcd(b, a % b) : a;
-  const d = gcd(width, height) || 1;
-  return `${Math.round(width / d)}:${Math.round(height / d)}`;
-}
 function reframeInstruction(plan, source, direction) {
   const wider = plan.axis === "width";
   const where = wider ? "to the left and to the right" : "above and below";
@@ -6406,6 +6529,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 +8212,40 @@ function registerImageRoutes(app, deps) {
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.6.10",
+    date: "2026-08-29",
+    title: "Pictures keep their shape.",
+    sections: [
+      {
+        heading: "Create",
+        body: "Images can no longer come back crushed or stretched: Scenri now works with the exact frame sizes the Codex image tool actually produces, and an answer that drifts off the requested shape is trimmed to it rather than distorted or refused. The wave of failed shots saying the engine could not produce the requested aspect ratio is gone with it, and refining an image over and over keeps its full sharpness at every step."
+      },
+      {
+        heading: "Scenes",
+        body: "When a scene built from photographs of one person is used with a chosen presenter, every output now shows the chosen presenter. Each reference image travels with a name that says what it is, so a scene photograph can lend its world and its styling without lending anyone a face, and asking for several variations gives every variation the same instructions rather than letting the first one copy the reference."
+      }
+    ]
+  },
+  {
+    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",
@@ -8986,7 +9157,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))
     );
@@ -9010,6 +9182,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,
@@ -9020,6 +9214,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" } : {}
@@ -9032,23 +9227,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 {
@@ -9172,10 +9379,51 @@ function buildServer(opts) {
     const out = [];
     for (const h of images) {
       const buf = core.images.read(h);
-      out.push(buf.subarray(0, 8).equals(PNG_SIG) ? h : core.images.save(await sharp7(buf).png().toBuffer()));
+      const meta2 = await sharp7(buf).metadata().catch(() => null);
+      if (!meta2?.width || !meta2.height) throw new Error("engine returned an undecodable image");
+      const oriented = (meta2.orientation ?? 1) !== 1;
+      out.push(
+        buf.subarray(0, 8).equals(PNG_SIG) && !oriented ? h : core.images.save(await sharp7(buf).rotate().png().toBuffer())
+      );
     }
     return out;
   }
+  const CROPPABLE_DRIFT = 0.35;
+  function conformToCanvas(nodeId, want) {
+    return async (images) => {
+      const target = want.width / want.height;
+      const out = [];
+      for (const h of images) {
+        const buf = core.images.read(h);
+        const meta2 = await sharp7(buf).metadata();
+        if (!meta2.width || !meta2.height) {
+          out.push(h);
+          continue;
+        }
+        const got = meta2.width / meta2.height;
+        const drift = Math.abs(got - target) / target;
+        if (drift <= SAME_SHAPE_TOL || drift > CROPPABLE_DRIFT) {
+          out.push(h);
+          continue;
+        }
+        const w = got > target ? Math.round(meta2.height * target) : meta2.width;
+        const hpx = got > target ? meta2.height : Math.round(meta2.width / target);
+        const cropped = await sharp7(buf).resize(w, hpx, { fit: "cover", position: "attention" }).png().toBuffer();
+        app.log.info(
+          { nodeId, got: `${meta2.width}x${meta2.height}`, want: `${w}x${hpx}` },
+          "canvas: cropped a drifted frame to the asked ratio"
+        );
+        out.push(core.images.save(cropped));
+        try {
+          const fresh = core.store.getNode(nodeId);
+          const b = fresh?.brief ?? {};
+          core.store.setBrief(nodeId, { ...b, croppedFrom: [meta2.width, meta2.height] });
+        } catch {
+        }
+      }
+      return out;
+    };
+  }
   async function assertAspect(images, expect) {
     const want = expect.width / expect.height;
     for (const h of images) {
@@ -9219,7 +9467,13 @@ function buildServer(opts) {
           const brief = node.brief ?? {};
           const raw = result.raw;
           const survivors = typeof raw?.requested === "number" && Array.isArray(raw.variantIndexes) ? { requested: raw.requested, variantIndexes: raw.variantIndexes } : {};
-          core.store.setBrief(nodeId, { ...brief, rendered: { sizes, ...survivors } });
+          const asked = expect ? { requestedSize: [expect.width, expect.height] } : {};
+          core.store.setBrief(nodeId, { ...brief, rendered: { sizes, ...survivors, ...asked } });
+          if (node.kind === "generation" && engineId === "codex-cli" && expect && expect.width !== expect.height && sizes.some(([w, h]) => w === expect.width && h === expect.height))
+            app.log.warn(
+              { nodeId },
+              "codex delivered exactly the requested pixels; its image tool cannot pin size - suggests a forbidden shell resize"
+            );
         }
       } catch {
       }
@@ -9449,7 +9703,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)
@@ -9479,8 +9739,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 ? {
@@ -9581,6 +9845,43 @@ 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 ?? {};
+            const parentBrief = core.store.getNode(resolvedParentId)?.brief ?? {};
+            core.store.setBrief(node.id, {
+              ...b,
+              resizedFrom: [got.width, got.height],
+              resampledHops: (parentBrief.resampledHops ?? 0) + 1
+            });
+          } catch {
+          }
+        } else out.push(h);
+      }
+      return out;
+    };
     const post = plan ? expandMethod === "outpaint" ? async (images) => {
       const out = [];
       for (const h of images) {
@@ -9609,15 +9910,21 @@ 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;
+      } else if (expectShape) {
+        staged = await conformToCanvas(node.id, expectShape)(staged);
       }
-      return out;
-    } : void 0;
+      return enforceEditCanvas(staged);
+    } : kind === "generation" && compiled2?.width && compiled2?.height ? conformToCanvas(node.id, { width: compiled2.width, height: compiled2.height }) : 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(
       (err) => app.log.error({ err }, "node run failed")