@invarn/cibuild 2.2.7 → 2.2.9

package/dist/src/yaml/steps/structural-facts.test.js

@@ -1156,6 +1156,139 @@ describe('buildAppearanceReferenceFromParams — union of geometry/text/color id
         ]);
     });
 });
+describe('buildStructuralBlock — design-frame anchor (composition runs)', () => {
+    // 686x384px at density 2 → a 343×192dp captured root.
+    const FRAME_DUMP = {
+        canvas: { left: 0, top: 0, right: 686, bottom: 384 },
+        nodes: [
+            { id: 'voucher', bounds: { left: 32, top: 48, right: 194, bottom: 210 }, parentId: null, clipsChildren: false },
+        ],
+    };
+    const GEOM = { voucher: { w: 81, h: 81, x: 16, y: 24 } };
+    test('root ≈ declared frame → no mismatch fact, placement is not withheld', () => {
+        const block = buildStructuralBlock(FRAME_DUMP, GEOM, 2, undefined, undefined, { w: 343, h: 192 });
+        expect(block.facts.filter((f) => f.kind === 'frame_mismatch')).toEqual([]);
+        expect(block.placement).toEqual({ withheld: false, facts: [] });
+    });
+    test('sub-tolerance drift (≤1dp) does not read as a mismatch', () => {
+        const block = buildStructuralBlock(FRAME_DUMP, GEOM, 2, undefined, undefined, { w: 342.5, h: 192.5 });
+        expect(block.facts.filter((f) => f.kind === 'frame_mismatch')).toEqual([]);
+        expect(block.placement).toEqual({ withheld: false, facts: [] });
+    });
+    test('a mis-sized root → frame_mismatch fact with declared/captured dims, placement withheld', () => {
+        const block = buildStructuralBlock(FRAME_DUMP, GEOM, 2, undefined, undefined, { w: 343, h: 100 });
+        const mismatches = block.facts.filter((f) => f.kind === 'frame_mismatch');
+        expect(mismatches).toEqual([
+            {
+                kind: 'frame_mismatch',
+                declared: { w: 343, h: 100 },
+                captured: { w: 343, h: 192 },
+                deltas: [{ dimension: 'h', delta: 92 }],
+            },
+        ]);
+        expect(block.placement).toEqual({ withheld: true, reason: 'frame_mismatch' });
+        // A mis-sized wrapper root is not a clean render.
+        expect(block.summary.clean).toBe(false);
+    });
+    test('the mismatch review row reads as a mis-sized wrapper root, never a screen defect', () => {
+        const block = buildStructuralBlock(FRAME_DUMP, GEOM, 2, undefined, undefined, { w: 343, h: 100 });
+        const scaffold = buildReviewScaffold(block);
+        const row = scaffold.rows.find((r) => r.fact.includes('wrapper root'));
+        expect(row).toBeDefined();
+        expect(row.fact).toContain('343×192');
+        expect(row.fact).toContain('343×100');
+        expect(row.fact.toLowerCase()).toContain('size the wrapper root');
+    });
+    test('no declared frame → no placement container, block unchanged from today', () => {
+        const withoutFrame = buildStructuralBlock(FRAME_DUMP, GEOM, 2);
+        expect(withoutFrame.placement).toBeUndefined();
+        expect(buildStructuralBlock(FRAME_DUMP, GEOM, 2, undefined, undefined, null)).toEqual(withoutFrame);
+    });
+    test('embedded stage matches the module for match and mismatch alike (parity)', () => {
+        const embedded = getGeometryStageInternals();
+        for (const frame of [{ w: 343, h: 192 }, { w: 343, h: 100 }, null]) {
+            expect(embedded.buildStructuralBlock(FRAME_DUMP, GEOM, 2, undefined, undefined, frame)).toEqual(buildStructuralBlock(FRAME_DUMP, GEOM, 2, undefined, undefined, frame));
+        }
+    });
+});
+describe('buildStructuralBlock — placement facts (composition runs)', () => {
+    // 686x384px at density 2 → a 343×192dp captured root; frame matches.
+    const FRAME = { w: 343, h: 192 };
+    // voucher: design places it at (16, 24); rendered root-space (unclipped)
+    // bounds put it at (16, 24) → in place, or shifted for the drift cases.
+    function dumpWithVoucherAt(leftPx, topPx) {
+        return {
+            canvas: { left: 0, top: 0, right: 686, bottom: 384 },
+            nodes: [
+                {
+                    id: 'voucher',
+                    bounds: { left: leftPx, top: topPx, right: leftPx + 162, bottom: topPx + 162 },
+                    unclippedBounds: { left: leftPx, top: topPx, right: leftPx + 162, bottom: topPx + 162 },
+                    parentId: null,
+                    clipsChildren: false,
+                },
+            ],
+        };
+    }
+    const GEOM = { voucher: { w: 81, h: 81, x: 16, y: 24 } };
+    test('a member root shifted beyond tolerance → a placement fact with expected/actual/delta', () => {
+        // Rendered at (20, 100)dp = (40, 200)px — design says (16, 24)dp.
+        const block = buildStructuralBlock(dumpWithVoucherAt(40, 200), GEOM, 2, undefined, undefined, FRAME);
+        expect(block.placement).toEqual({
+            withheld: false,
+            facts: [
+                {
+                    elementId: 'voucher',
+                    expected: { x: 16, y: 24 },
+                    actual: { x: 20, y: 100 },
+                    deltas: [
+                        { dimension: 'x', delta: 4 },
+                        { dimension: 'y', delta: 76 },
+                    ],
+                },
+            ],
+        });
+        // Placement drift is load-bearing on a composition State — not clean.
+        expect(block.summary.clean).toBe(false);
+    });
+    test('within tolerance (≤2dp) → measured but no fact, still clean', () => {
+        // Rendered at (17, 25)dp = (34, 50)px — 1dp off design (16, 24).
+        const block = buildStructuralBlock(dumpWithVoucherAt(34, 50), GEOM, 2, undefined, undefined, FRAME);
+        expect(block.placement).toEqual({ withheld: false, facts: [] });
+        expect(block.summary.clean).toBe(true);
+    });
+    test('an element without design x/y contributes no placement fact', () => {
+        const geomNoXY = { voucher: { w: 81, h: 81 } };
+        const block = buildStructuralBlock(dumpWithVoucherAt(40, 200), geomNoXY, 2, undefined, undefined, FRAME);
+        expect(block.placement).toEqual({ withheld: false, facts: [] });
+    });
+    test('frame mismatch → placement facts withheld with the reason, none computed', () => {
+        const block = buildStructuralBlock(dumpWithVoucherAt(40, 200), GEOM, 2, undefined, undefined, { w: 343, h: 100 });
+        expect(block.placement).toEqual({ withheld: true, reason: 'frame_mismatch' });
+        expect(block.placement && 'facts' in block.placement).toBe(false);
+    });
+    test('no declared frame (component runs) → no placement facts, identical deltas stay advisory', () => {
+        const block = buildStructuralBlock(dumpWithVoucherAt(40, 200), GEOM, 2);
+        expect(block.placement).toBeUndefined();
+        // x/y deltas still reported (advisory) on the geometry element, unflagged.
+        const el = block.geometry.elements.find((e) => e.id === 'voucher');
+        expect(el.deltas.some((d) => d.dimension === 'x' || d.dimension === 'y')).toBe(true);
+        expect(el.sizeFlag).toBe(false);
+        expect(block.summary.clean).toBe(true);
+    });
+    test('embedded stage matches the module for drift, clean, and withheld (parity)', () => {
+        const embedded = getGeometryStageInternals();
+        const cases = [
+            [dumpWithVoucherAt(40, 200), FRAME],
+            [dumpWithVoucherAt(34, 50), FRAME],
+            [dumpWithVoucherAt(40, 200), { w: 343, h: 100 }],
+            [dumpWithVoucherAt(40, 200), null],
+        ];
+        for (const [dump, frame] of cases) {
+            expect(embedded.buildStructuralBlock(dump, GEOM, 2, undefined, undefined, frame)).toEqual(buildStructuralBlock(dump, GEOM, 2, undefined, undefined, frame));
+        }
+    });
+});
 describe('embedded geometry stage parity', () => {
     // The render ships a JS-source port of the differ + assembler. It must produce
     // byte-identical blocks to the canonical typed module, or run-side structural

package/dist/src/yaml/steps/ui-fidelity-render-android.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-fidelity-render-android.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ui-fidelity-render-android.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAKpE,sDAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,iDAAiD;AACjD,eAAO,MAAM,eAAe,6BAA8B,CAAC;AAC3D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAAwB,CAAC;AAE9D,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAA0B,CAAC;AAElE,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAEzD,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAq5BD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAoBrF;AAED;;;GAGG;AACH,qBAAa,mCAAoC,SAAQ,gBAAgB;IACvE,yBAAyB,CACvB,OAAO,EAAE,6BAA6B,EACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAepB,OAAO,CACX,MAAM,EAAE,6BAA6B,EACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;CA0EpB"}
+{"version":3,"file":"ui-fidelity-render-android.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ui-fidelity-render-android.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAMpE,sDAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,iDAAiD;AACjD,eAAO,MAAM,eAAe,6BAA8B,CAAC;AAC3D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAAwB,CAAC;AAE9D,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAA0B,CAAC;AAElE,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAEzD,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AA47BD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAqBrF;AAED;;;GAGG;AACH,qBAAa,mCAAoC,SAAQ,gBAAgB;IACvE,yBAAyB,CACvB,OAAO,EAAE,6BAA6B,EACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,EAAE;IAepB,OAAO,CACX,MAAM,EAAE,6BAA6B,EACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;CA0EpB"}

package/dist/src/yaml/steps/ui-fidelity-render-android.js

@@ -51,6 +51,7 @@ import { BaseStepExecutor } from './base.js';
 import { parseScale, DEFAULT_SCALE } from './ui-fidelity-render.js';
 import { RENDER_SCRIPT_TRIM_STAGE } from './render-post-processor.js';
 import { RENDER_SCRIPT_FACTS_STAGE, RENDER_SCRIPT_GEOMETRY_STAGE } from './structural-facts.js';
+import { RENDER_SCRIPT_SOURCE_DIGEST_STAGE } from '../fidelity-input-digest.js';
 /**
  * Default Roborazzi record task. Run from the project root so Gradle resolves
  * it in whichever subproject declares it.
@@ -122,6 +123,14 @@ var referenceColor = null;
 // Marks whether the appearance reference is the design (divergences) or the
 // previous catalog render (regressions/drift, the no-Figma path).
 var referenceBaseline = null;
+// params.reference_frame (composition runs: the design frame's { w, h } per
+// screen, design px treated 1:1 with dp), set in main() and read by the
+// structural assembler, which asserts the captured root against it. Null when
+// none declared → no frame assertion, no placement gate.
+var referenceFrame = null;
+// params.proof_kind ('component' default | 'composition'), set in main(). The
+// frame assertion and the placement gate only apply to composition runs.
+var proofKind = 'component';
 
 function log(message) {
   console.log('[ui-fidelity-render-android] ' + message);
@@ -547,6 +556,14 @@ function findRoborazziDirs(root) {
 // screen — the analog of the iOS probe gate). A screen whose PNG is absent
 // after a successful build is RENDER_FAILED on its own.
 function renderScreens(renderable, projectRoot) {
+  // Snapshot the package's input files BEFORE the build runs, so the digest is
+  // over the pristine committed source and never perturbed by build outputs.
+  var packageFiles = __fidCollectPackageFiles(projectRoot);
+  // A package is safely cacheable only when it is hermetic — no Gradle script
+  // reaches outside its own root. Then the package IS its whole dependency
+  // closure, so the content key cannot miss an external change. A non-hermetic
+  // package emits no digest, so a later dispatch never skips it.
+  var packageHermetic = __fidIsHermetic(packageFiles);
   var gradle = runGradle(projectRoot, CONFIG.gradleTask);
   if (gradle.status !== 0) {
     var detail = outputTail(gradle);
@@ -606,6 +623,20 @@ function renderScreens(renderable, projectRoot) {
       entry.rendered_image_path = relative;
       entry.status = 'rendered';
       entry.error = null;
+      // Content key over the package source + this screen's reference: lets a
+      // consumer skip a re-render whose inputs are unchanged. Emitted only for a
+      // hermetic package; otherwise omitted so no stale verdict can be replayed.
+      if (packageHermetic) {
+        var referenceBytes = null;
+        try {
+          if (entry.reference_image_path) {
+            referenceBytes = fs.readFileSync(path.resolve(artifactsDir, entry.reference_image_path));
+          }
+        } catch (digestReferenceError) {
+          referenceBytes = null;
+        }
+        entry.source_digest = __fidSourceDigest(packageFiles, referenceBytes);
+      }
       log('rendered ' + entry.screen + ' -> ' + relative);
       trimRenderedImage(entry, outputPath, workDir);
       // Signal A: the render emits a per-node layout dump into a roborazzi
@@ -634,7 +665,7 @@ function renderScreens(renderable, projectRoot) {
         // geometry deltas vs reference_geometry) onto the screen entry, so the
         // judge reads the signals from protocol-result.json without fetching
         // artifacts. CONFIG.scale is the render density (dp = px / scale).
-        assembleStructural(entry, layoutSource, referenceGeometry, CONFIG.scale, referenceText, referenceColor, referenceBaseline);
+        assembleStructural(entry, layoutSource, referenceGeometry, CONFIG.scale, referenceText, referenceColor, referenceBaseline, referenceFrame, proofKind);
       }
     });
   } finally {
@@ -720,6 +751,15 @@ function main() {
   // sourced from the previous catalog render (no-Figma drift path), else 'figma'.
   referenceBaseline =
     params.reference_baseline === 'previous_render' ? 'previous_render' : 'figma';
+  // Composition-run inputs: the declared kind gates the frame assertion; the
+  // per-screen design frame is what the captured root is asserted against.
+  proofKind = params.proof_kind === 'composition' ? 'composition' : 'component';
+  referenceFrame =
+    params.reference_frame &&
+    typeof params.reference_frame === 'object' &&
+    !Array.isArray(params.reference_frame)
+      ? params.reference_frame
+      : null;
 
   var screens = Object.keys(params.screens);
   currentEntries = screens.map(function (screen) {
@@ -1003,6 +1043,7 @@ export function generateAndroidRenderScript(config) {
         RENDER_SCRIPT_TRIM_STAGE,
         RENDER_SCRIPT_FACTS_STAGE,
         RENDER_SCRIPT_GEOMETRY_STAGE,
+        RENDER_SCRIPT_SOURCE_DIGEST_STAGE,
         main,
     ].join('\n');
 }

package/dist/src/yaml/steps/ui-fidelity-render-android.test.js

@@ -360,6 +360,34 @@ describe('android render runtime — render + trim (happy path)', () => {
             ],
         });
     });
+    test('emits a source_digest content key on a rendered screen entry', async () => {
+        const project = makeProject({ screens: { XProof: 'x.png' } });
+        writeReference(project, 'x.png');
+        stageArchive(project, gradleProjectEntries());
+        const run = runScript(project, await buildScript(), {
+            FAKE_ROBORAZZI_SCREENS: 'XProof',
+        });
+        expect(run.status).toBe(0);
+        const screen = readResult(project).screens.find((s) => s.screen === 'XProof');
+        expect(screen?.status).toBe('rendered');
+        expect(screen?.source_digest).toMatch(/^[0-9a-f]{64}$/);
+    });
+    test('omits source_digest for a non-hermetic package (Gradle script escapes the root)', async () => {
+        const project = makeProject({ screens: { XProof: 'x.png' } });
+        writeReference(project, 'x.png');
+        // A settings script that pulls in a sibling build via a parent path — the
+        // package is no longer its own dependency closure, so it must not be
+        // cacheable: it still renders, but emits no content key.
+        const entries = gradleProjectEntries().map((e) => e.name.endsWith('settings.gradle.kts')
+            ? { ...e, content: 'rootProject.name = "p"\ninclude(":proof")\nincludeBuild("../design-system")\n' }
+            : e);
+        stageArchive(project, entries);
+        const run = runScript(project, await buildScript(), { FAKE_ROBORAZZI_SCREENS: 'XProof' });
+        expect(run.status).toBe(0);
+        const screen = readResult(project).screens.find((s) => s.screen === 'XProof');
+        expect(screen?.status).toBe('rendered');
+        expect(screen?.source_digest == null).toBe(true);
+    });
     test('assembles the inline structural block (facts) onto the screen entry', async () => {
         const project = makeProject({ screens: { XProof: 'x.png' } });
         writeReference(project, 'x.png');

package/dist/src/yaml/steps/ui-fidelity-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-fidelity-render.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ui-fidelity-render.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ui-fidelity-render.d.ts","sourceRoot":"","sources":["../../../../src/yaml/steps/ui-fidelity-render.ts"],"names":[],"mappings":"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"}

package/dist/src/yaml/steps/ui-fidelity-render.js

@@ -50,6 +50,7 @@
  */
 import { BaseStepExecutor } from './base.js';
 import { RENDER_SCRIPT_TRIM_STAGE } from './render-post-processor.js';
+import { RENDER_SCRIPT_SOURCE_DIGEST_STAGE } from '../fidelity-input-digest.js';
 /**
  * Default render size in device points. 393x852 is the iPhone-class portrait
  * canvas shared by the iPhone 14 Pro / 15 / 16 — the most common modern
@@ -339,6 +340,13 @@ function runSwift(args) {
 }
 
 function renderWithHarness(renderable, packagePath) {
+  // Snapshot the user package's input files BEFORE any Swift build, so build
+  // products (.build, DerivedData) never perturb the content key. A package is
+  // safely cacheable only when it is hermetic — its own files are its whole
+  // dependency closure; a non-hermetic one emits no digest and so is never
+  // skipped by a consumer.
+  var packageFiles = __fidCollectPackageFiles(packagePath);
+  var packageHermetic = __fidIsHermetic(packageFiles);
   var harnessDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ui-fidelity-harness-'));
   registerPathReplacement(harnessDir, '<harness>');
   log('harness package: ' + harnessDir);
@@ -420,6 +428,20 @@ function renderWithHarness(renderable, packagePath) {
       entry.rendered_image_path = relative;
       entry.status = 'rendered';
       entry.error = null;
+      // Content key over the package source + this screen's reference: lets a
+      // consumer skip a re-render whose inputs are unchanged. Emitted only for a
+      // hermetic package; otherwise omitted so no stale verdict can be replayed.
+      if (packageHermetic) {
+        var referenceBytes = null;
+        try {
+          if (entry.reference_image_path) {
+            referenceBytes = fs.readFileSync(path.resolve(artifactsDir, entry.reference_image_path));
+          }
+        } catch (digestReferenceError) {
+          referenceBytes = null;
+        }
+        entry.source_digest = __fidSourceDigest(packageFiles, referenceBytes);
+      }
       log('rendered ' + entry.screen + ' -> ' + relative);
     });
   } finally {
@@ -1185,6 +1207,7 @@ export function generateRenderScript(config) {
         '// ui-fidelity-render runtime script (generated by cibuild at YAML conversion time)',
         'var CONFIG = ' + JSON.stringify(config) + ';',
         RENDER_SCRIPT_GENERATORS,
+        RENDER_SCRIPT_SOURCE_DIGEST_STAGE,
         main,
     ].join('\n');
 }

package/dist/src/yaml/steps/ui-fidelity-render.test.js

@@ -531,6 +531,7 @@ describe('render script runtime', () => {
                     error: null,
                     reference_image_path: 'ui-fidelity/references/HomeView.png',
                     rendered_image_path: 'ui-fidelity/rendered/HomeView.png',
+                    source_digest: expect.stringMatching(/^[0-9a-f]{64}$/),
                 },
                 {
                     screen: 'SettingsView',
@@ -538,6 +539,7 @@ describe('render script runtime', () => {
                     error: null,
                     reference_image_path: 'ui-fidelity/references/SettingsView.png',
                     rendered_image_path: 'ui-fidelity/rendered/SettingsView.png',
+                    source_digest: expect.stringMatching(/^[0-9a-f]{64}$/),
                 },
             ],
         });
@@ -647,6 +649,17 @@ describe('render script runtime', () => {
         expect(settings.error).toBeNull();
         expect(isPng(artifact(project, 'ui-fidelity/rendered/SettingsView.png'))).toBe(true);
     });
+    test('emits a source_digest content key on a rendered screen entry', async () => {
+        const project = makeProject({ screens: { HomeView: 'home.png' } });
+        writeReference(project, 'home.png');
+        // A committed package file so the digest is over real package source.
+        writeFileSync(join(project.packageDir, 'Package.swift'), '// swift-tools-version:5.9\nimport PackageDescription\n');
+        const run = runScript(project, await buildScript(project));
+        expect(run.status).toBe(0);
+        const home = readResult(project).screens[0];
+        expect(home.status).toBe('rendered');
+        expect(home.source_digest).toMatch(/^[0-9a-f]{64}$/);
+    });
     test('a reference that is a directory fails only that screen', async () => {
         const project = makeProject({
             screens: { HomeView: 'home-dir.png', SettingsView: 'settings.png' },
@@ -916,6 +929,7 @@ describe('render script runtime (package_source: repo)', () => {
                     error: null,
                     reference_image_path: 'ui-fidelity/references/HomeView.png',
                     rendered_image_path: 'ui-fidelity/rendered/HomeView.png',
+                    source_digest: expect.stringMatching(/^[0-9a-f]{64}$/),
                     aligned_image_path: 'ui-fidelity/aligned/HomeView.png',
                     dimensions: {
                         rendered_px: [320, 640],
@@ -1095,6 +1109,7 @@ describe('render script runtime (package_source: inputs)', () => {
                     error: null,
                     reference_image_path: 'ui-fidelity/references/HomeView.png',
                     rendered_image_path: 'ui-fidelity/rendered/HomeView.png',
+                    source_digest: expect.stringMatching(/^[0-9a-f]{64}$/),
                     aligned_image_path: 'ui-fidelity/aligned/HomeView.png',
                     dimensions: {
                         rendered_px: [320, 640],
@@ -1108,6 +1123,7 @@ describe('render script runtime (package_source: inputs)', () => {
                     error: null,
                     reference_image_path: 'ui-fidelity/references/SettingsView.png',
                     rendered_image_path: 'ui-fidelity/rendered/SettingsView.png',
+                    source_digest: expect.stringMatching(/^[0-9a-f]{64}$/),
                     aligned_image_path: 'ui-fidelity/aligned/SettingsView.png',
                     dimensions: {
                         rendered_px: [320, 640],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invarn/cibuild",
-  "version": "2.2.7",
+  "version": "2.2.9",
   "description": "CI Build CLI — local pipeline orchestration and validation",
   "type": "module",
   "main": "dist/cli.cjs",