@invarn/cibuild 2.3.6 → 2.3.8

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

@@ -529,6 +529,7 @@ describe('render script runtime', () => {
                     screen: 'HomeView',
                     status: 'rendered',
                     error: null,
+                    copy_advisory: 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}$/),
@@ -537,6 +538,7 @@ describe('render script runtime', () => {
                     screen: 'SettingsView',
                     status: 'rendered',
                     error: null,
+                    copy_advisory: 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}$/),
@@ -927,6 +929,7 @@ describe('render script runtime (package_source: repo)', () => {
                     screen: 'HomeView',
                     status: 'rendered',
                     error: null,
+                    copy_advisory: 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}$/),
@@ -1107,6 +1110,7 @@ describe('render script runtime (package_source: inputs)', () => {
                     screen: 'HomeView',
                     status: 'rendered',
                     error: null,
+                    copy_advisory: 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}$/),
@@ -1121,6 +1125,7 @@ describe('render script runtime (package_source: inputs)', () => {
                     screen: 'SettingsView',
                     status: 'rendered',
                     error: null,
+                    copy_advisory: 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}$/),
@@ -1580,4 +1585,121 @@ describe('reference_source: repo', () => {
         expect(ghost?.error?.code).toBe('REFERENCE_MISSING');
     });
 });
+describe('render script runtime — reference provenance', () => {
+    const GOOD_PROV = {
+        figmaNode: '12:345',
+        locale: 'en',
+        resolved: true,
+        exportedAt: '2026-06-18T10:00:00Z',
+    };
+    test('a placeholder reference (resolved=false) renders and downgrades only the copy channel', async () => {
+        const project = makeProject({
+            screens: { HomeView: 'home.png' },
+            render_locale: 'en',
+            provenance: { HomeView: { ...GOOD_PROV, resolved: false } },
+        });
+        writeReference(project, 'home.png');
+        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.error).toBeNull();
+        expect(home.copy_advisory?.code).toBe('copy_unverifiable');
+        expect(home.copy_advisory?.reason).toBe('unresolved_placeholders');
+    });
+    test('the placeholder downgrade is identical without a render_locale (same input, same verdict)', async () => {
+        const project = makeProject({
+            screens: { HomeView: 'home.png' },
+            provenance: { HomeView: { ...GOOD_PROV, resolved: false } },
+        });
+        writeReference(project, 'home.png');
+        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.copy_advisory?.reason).toBe('unresolved_placeholders');
+    });
+    test('an Italian reference against an English render downgrades the copy channel', async () => {
+        const project = makeProject({
+            screens: { HomeView: 'home.png' },
+            render_locale: 'en',
+            provenance: { HomeView: { ...GOOD_PROV, locale: 'it' } },
+        });
+        writeReference(project, 'home.png');
+        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.copy_advisory?.reason).toBe('locale_mismatch');
+    });
+    test('locale comparison requires a declared render_locale — its absence skips only that', async () => {
+        const project = makeProject({
+            screens: { HomeView: 'home.png' },
+            provenance: { HomeView: { ...GOOD_PROV, locale: 'it' } },
+        });
+        writeReference(project, 'home.png');
+        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.copy_advisory ?? null).toBeNull();
+    });
+    test('an absent reference with provenance is fatal (REFERENCE_ABSENT, unverifiable)', async () => {
+        const project = makeProject({
+            screens: { HomeView: 'home.png' },
+            provenance: { HomeView: GOOD_PROV },
+        });
+        // No writeReference — the file is absent.
+        const run = runScript(project, await buildScript(project));
+        expect(run.status).not.toBe(0);
+        const home = readResult(project).screens[0];
+        expect(home.status).toBe('unverifiable');
+        expect(home.error?.code).toBe('REFERENCE_ABSENT');
+    });
+    test('a clean provenanced reference renders with no copy advisory', async () => {
+        const project = makeProject({
+            screens: { HomeView: 'home.png' },
+            render_locale: 'en',
+            provenance: { HomeView: GOOD_PROV },
+        });
+        writeReference(project, 'home.png');
+        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.copy_advisory ?? null).toBeNull();
+    });
+    test('an unprovenanced screen keeps its legacy behaviour even with a render_locale (no NO_PROVENANCE arming on iOS)', async () => {
+        // NO_PROVENANCE hard-arming is Android-legacy only; the iOS step never
+        // refused unprovenanced screens and must not start now.
+        const project = makeProject({
+            screens: { HomeView: 'home.png' },
+            render_locale: 'en',
+            provenance: {},
+        });
+        writeReference(project, 'home.png');
+        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.copy_advisory ?? null).toBeNull();
+    });
+    test('independent verdicts: a clean sibling carries no advisory while the placeholder state does', async () => {
+        const project = makeProject({
+            screens: { HomeView: 'home.png', SettingsView: 'settings.png' },
+            provenance: {
+                HomeView: GOOD_PROV,
+                SettingsView: { ...GOOD_PROV, resolved: false },
+            },
+        });
+        writeReference(project, 'home.png');
+        writeReference(project, 'settings.png');
+        const run = runScript(project, await buildScript(project));
+        expect(run.status).toBe(0);
+        const [home, settings] = readResult(project).screens;
+        expect(home.copy_advisory ?? null).toBeNull();
+        expect(settings.status).toBe('rendered');
+        expect(settings.copy_advisory?.reason).toBe('unresolved_placeholders');
+    });
+});
 //# sourceMappingURL=ui-fidelity-render.test.js.map

package/package.json

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