@invarn/cibuild 2.2.5 → 2.2.7

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

@@ -4,7 +4,10 @@ import { gzipSync } from 'node:zlib';
 import { tmpdir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { ANDROID_RENDERER, UiFidelityRenderAndroidStepExecutor, } from './ui-fidelity-render-android.js';
+import { ANDROID_RENDERER, DEFAULT_GRADLE_TASK, UiFidelityRenderAndroidStepExecutor, } from './ui-fidelity-render-android.js';
+import { DEFAULT_SCALE } from './ui-fidelity-render.js';
+import { clearRegistry, getStepMetadata, hasStep } from './registry.js';
+import { initializeStepRegistry } from './index.js';
 import { testConfig } from './test-config.js';
 const PNG_MAGIC = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
 const tempDirs = [];
@@ -166,6 +169,48 @@ function runScript(project, script, env = {}) {
 function readResult(project) {
     return JSON.parse(readFileSync(join(project.dir, '.ci', 'artifacts', 'protocol-result.json'), 'utf-8'));
 }
+describe('registry integration', () => {
+    test('ui-fidelity-render-android is registered with its input schema', () => {
+        clearRegistry();
+        initializeStepRegistry();
+        expect(hasStep('ui-fidelity-render-android')).toBe(true);
+        const metadata = getStepMetadata('ui-fidelity-render-android');
+        expect(metadata?.platform).toBe('android');
+        const inputs = metadata?.inputs ?? {};
+        expect(Object.keys(inputs).sort()).toEqual([
+            'gradle_task',
+            'package_path',
+            'package_source',
+            'reference_source',
+            'scale',
+        ]);
+        expect(inputs.package_source.required).toBe(false);
+        expect(inputs.package_source.default).toBe('inputs');
+        expect(inputs.reference_source.required).toBe(false);
+        expect(inputs.reference_source.default).toBe('inputs');
+        // package_path is enforced by the executor only in repo mode; the default
+        // (inputs) config is valid without it, so it is not unconditionally required.
+        expect(inputs.package_path.required).toBe(false);
+        expect(inputs.scale.required).toBe(false);
+        expect(inputs.scale.default).toBe(DEFAULT_SCALE);
+        expect(inputs.gradle_task.required).toBe(false);
+        expect(inputs.gradle_task.default).toBe(DEFAULT_GRADLE_TASK);
+    });
+});
+describe('default byte compatibility', () => {
+    // Snapshot of the script generated for the default inputs (no package_source,
+    // no reference_source), captured from the executor with everything else at its
+    // default. Omitting both *_source inputs must keep the generated script
+    // byte-identical to this snapshot, so existing protocols are provably
+    // untouched. Update the snapshot only for a deliberate, reviewed change to the
+    // default runtime.
+    const DEFAULT_SCRIPT_SNAPSHOT = resolve(dirname(fileURLToPath(import.meta.url)), '../../../test/fixtures/ui-fidelity-render-android-v1-script.txt');
+    test('omitting package_source and reference_source generates a byte-identical script', async () => {
+        const executor = new UiFidelityRenderAndroidStepExecutor();
+        const step = await executor.execute({}, {}, testConfig);
+        expect(step.script).toBe(readFileSync(DEFAULT_SCRIPT_SNAPSHOT, 'utf-8'));
+    });
+});
 describe('UiFidelityRenderAndroidStepExecutor', () => {
     test('returns a node StepDef named ui-fidelity-render-android', async () => {
         const executor = new UiFidelityRenderAndroidStepExecutor();
@@ -541,6 +586,139 @@ describe('android render runtime — error isolation', () => {
         expect(y?.error?.code).toBe('RENDER_FAILED');
     });
 });
+/** Materialize a well-formed Gradle render project (fake gradlew) on disk. */
+function writeGradleProjectDir(dir) {
+    mkdirSync(join(dir, 'proof'), { recursive: true });
+    writeFileSync(join(dir, 'settings.gradle.kts'), 'rootProject.name = "p"\ninclude(":proof")\n');
+    const gradlew = join(dir, 'gradlew');
+    writeFileSync(gradlew, FAKE_GRADLEW_LINES.join('\n') + '\n');
+    chmodSync(gradlew, 0o755);
+    writeFileSync(join(dir, 'proof', 'build.gradle.kts'), '// module\n');
+}
+describe('package_source: repo', () => {
+    test('rejects an unknown package_source value', async () => {
+        const executor = new UiFidelityRenderAndroidStepExecutor();
+        await expect(executor.execute({ package_source: 'cloud' }, {}, testConfig)).rejects.toThrow(/package_source/);
+    });
+    test('package_source repo requires package_path', async () => {
+        const executor = new UiFidelityRenderAndroidStepExecutor();
+        await expect(executor.execute({ package_source: 'repo' }, {}, testConfig)).rejects.toThrow(/package_path/);
+    });
+    test('omitting package_source bakes no packageSource/packagePath into the config', async () => {
+        const script = await buildScript();
+        const configLine = script.split('\n').find((l) => l.startsWith('var CONFIG = '));
+        expect(configLine).toBeDefined();
+        expect(configLine).not.toContain('packageSource');
+        expect(configLine).not.toContain('packagePath');
+    });
+    test('renders the checked-out Gradle project at package_path (no archive)', async () => {
+        const project = makeProject({ screens: { XProof: 'x.png' } });
+        writeReference(project, 'x.png');
+        // The committed project lives at a repo-relative path; no package.tar.gz.
+        writeGradleProjectDir(join(project.dir, 'android-app'));
+        const run = runScript(project, await buildScript({ package_source: 'repo', package_path: 'android-app' }), { FAKE_ROBORAZZI_SCREENS: 'XProof' });
+        expect(run.status).toBe(0);
+        const doc = readResult(project);
+        expect(doc.package_source).toBe('repo');
+        expect(doc.error).toBeNull();
+        const screen = doc.screens.find((s) => s.screen === 'XProof');
+        expect(screen?.status).toBe('rendered');
+        expect(screen?.rendered_image_path).toBe('ui-fidelity/rendered/XProof.png');
+        // The render came from the checkout, not an extracted tarball.
+        expect(existsSync(join(project.dir, '.ci', 'inputs', 'package.tar.gz'))).toBe(false);
+    });
+    test('a missing package_path directory fails cleanly with a per-build error', async () => {
+        const project = makeProject({ screens: { XProof: 'x.png' } });
+        writeReference(project, 'x.png');
+        // No project at the path.
+        const run = runScript(project, await buildScript({ package_source: 'repo', package_path: 'nope' }), { FAKE_ROBORAZZI_SCREENS: 'XProof' });
+        expect(run.status).toBe(1);
+        const doc = readResult(project);
+        expect(doc.package_source).toBe('repo');
+        expect(doc.error?.code).toBe('ANDROID_PROJECT_MISSING');
+    });
+    test('a package_path without a settings script fails cleanly', async () => {
+        const project = makeProject({ screens: { XProof: 'x.png' } });
+        writeReference(project, 'x.png');
+        // A directory that is not a Gradle project root.
+        mkdirSync(join(project.dir, 'not-a-project'), { recursive: true });
+        writeFileSync(join(project.dir, 'not-a-project', 'README.md'), '# nope\n');
+        const run = runScript(project, await buildScript({ package_source: 'repo', package_path: 'not-a-project' }), { FAKE_ROBORAZZI_SCREENS: 'XProof' });
+        expect(run.status).toBe(1);
+        expect(readResult(project).error?.code).toBe('ANDROID_PROJECT_ROOT_MISSING');
+    });
+    test('composes with reference_source repo (project + reference both from the checkout)', async () => {
+        const project = makeProject({ screens: { XProof: 'refs/x.png' } });
+        mkdirSync(join(project.dir, 'refs'), { recursive: true });
+        writeFileSync(join(project.dir, 'refs', 'x.png'), Buffer.concat([PNG_MAGIC, Buffer.from('ref:x')]));
+        writeGradleProjectDir(join(project.dir, 'android-app'));
+        const run = runScript(project, await buildScript({
+            package_source: 'repo',
+            package_path: 'android-app',
+            reference_source: 'repo',
+        }), { FAKE_ROBORAZZI_SCREENS: 'XProof' });
+        expect(run.status).toBe(0);
+        const doc = readResult(project);
+        expect(doc.package_source).toBe('repo');
+        const screen = doc.screens.find((s) => s.screen === 'XProof');
+        expect(screen?.status).toBe('rendered');
+        expect(screen?.reference_image_path).toBe('ui-fidelity/references/XProof.png');
+    });
+});
+describe('reference_source: repo', () => {
+    test('rejects an unknown reference_source value', async () => {
+        const executor = new UiFidelityRenderAndroidStepExecutor();
+        await expect(executor.execute({ reference_source: 'artifact' }, {}, testConfig)).rejects.toThrow(/reference_source/);
+    });
+    test('omitting reference_source bakes no referenceSource into the script config', async () => {
+        const script = await buildScript();
+        const configLine = script.split('\n').find((l) => l.startsWith('var CONFIG = '));
+        expect(configLine).toBeDefined();
+        expect(configLine).not.toContain('referenceSource');
+    });
+    test('reads each screen reference from its repo-relative path in the checkout', async () => {
+        const project = makeProject({
+            screens: { XProof: 'refs/x.png', YProof: 'design/y.png' },
+        });
+        // Committed references live at repo-relative paths (resolved against cwd),
+        // NOT in .ci/inputs.
+        mkdirSync(join(project.dir, 'refs'), { recursive: true });
+        mkdirSync(join(project.dir, 'design'), { recursive: true });
+        writeFileSync(join(project.dir, 'refs', 'x.png'), Buffer.concat([PNG_MAGIC, Buffer.from('ref:x')]));
+        writeFileSync(join(project.dir, 'design', 'y.png'), Buffer.concat([PNG_MAGIC, Buffer.from('ref:y')]));
+        stageArchive(project, gradleProjectEntries());
+        const run = runScript(project, await buildScript({ reference_source: 'repo' }), {
+            FAKE_ROBORAZZI_SCREENS: 'XProof,YProof',
+        });
+        expect(run.status).toBe(0);
+        const doc = readResult(project);
+        expect(doc.screens.map((s) => s.status)).toEqual(['rendered', 'rendered']);
+        expect(doc.screens.map((s) => s.reference_image_path)).toEqual([
+            'ui-fidelity/references/XProof.png',
+            'ui-fidelity/references/YProof.png',
+        ]);
+        expect(isPng(artifact(project, 'ui-fidelity/references/XProof.png'))).toBe(true);
+        expect(isPng(artifact(project, 'ui-fidelity/references/YProof.png'))).toBe(true);
+    });
+    test('fails one screen when its committed reference is missing, renders the rest', async () => {
+        const project = makeProject({
+            screens: { XProof: 'refs/x.png', GhostProof: 'refs/ghost.png' },
+        });
+        mkdirSync(join(project.dir, 'refs'), { recursive: true });
+        writeFileSync(join(project.dir, 'refs', 'x.png'), Buffer.concat([PNG_MAGIC, Buffer.from('ref:x')]));
+        // refs/ghost.png intentionally absent.
+        stageArchive(project, gradleProjectEntries());
+        const run = runScript(project, await buildScript({ reference_source: 'repo' }), {
+            FAKE_ROBORAZZI_SCREENS: 'XProof',
+        });
+        expect(run.status).not.toBe(0);
+        const doc = readResult(project);
+        expect(doc.screens.find((s) => s.screen === 'XProof')?.status).toBe('rendered');
+        const ghost = doc.screens.find((s) => s.screen === 'GhostProof');
+        expect(ghost?.status).toBe('render_failed');
+        expect(ghost?.error?.code).toBe('REFERENCE_MISSING');
+    });
+});
 // The fake gradlew/swift cannot exercise the real Roborazzi/Robolectric render
 // or the CoreGraphics trim. This end-to-end guard ships the committed Roborazzi
 // fixture as the render package and runs the whole step with the real

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

@@ -75,6 +75,16 @@ export interface UiFidelityRenderInputs {
      * product.
      */
     target?: string;
+    /**
+     * Where each screen's reference image comes from (default "inputs"):
+     * - "inputs" (default / v1): `params.screens[<Screen>]` is a plain file
+     *   basename read from `.ci/inputs/<basename>` (an agent-uploaded run input).
+     * - "repo": `params.screens[<Screen>]` is a repo-relative path to a COMMITTED
+     *   reference image, resolved against the checkout. Lets a triggered
+     *   (agent-less) run point at a reference that lives in the cloned repo.
+     *   Omitting reference_source generates a byte-identical v1 script.
+     */
+    reference_source?: 'repo' | 'inputs';
     /** Render size in device points, formatted "<width>x<height>" (default 393x852) */
     render_size?: string;
     /** Display scale factor applied to the render (default 2) */
@@ -94,6 +104,11 @@ export declare const PACKAGE_SOURCES: readonly ["repo", "inputs"];
 export type PackageSource = (typeof PACKAGE_SOURCES)[number];
 /** Default package source: the package lives in the repo checkout. */
 export declare const DEFAULT_PACKAGE_SOURCE: PackageSource;
+/** Valid values for the reference_source input. */
+export declare const REFERENCE_SOURCES: readonly ["repo", "inputs"];
+export type ReferenceSource = (typeof REFERENCE_SOURCES)[number];
+/** Default reference source: references arrive as run inputs (v1 behaviour). */
+export declare const DEFAULT_REFERENCE_SOURCE: ReferenceSource;
 /** Basename of the shipped package archive inside the run-inputs directory. */
 export declare const PACKAGE_ARCHIVE_BASENAME = "package.tar.gz";
 /**
@@ -140,6 +155,12 @@ export interface RenderScriptConfig {
     height: number;
     scale: number;
     packageSource?: PackageSource;
+    /**
+     * Only present (and only ever "repo") when reference_source was explicitly set
+     * to "repo". When absent, references are read from `.ci/inputs/<basename>` and
+     * the generated reference-sourcing code is byte-identical to v1.
+     */
+    referenceSource?: ReferenceSource;
 }
 /** Options consumed by the pure Swift-source generators. */
 export interface HarnessGeneratorOptions {

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

@@ -63,6 +63,10 @@ export const DEFAULT_SCALE = 2;
 export const PACKAGE_SOURCES = ['repo', 'inputs'];
 /** Default package source: the package lives in the repo checkout. */
 export const DEFAULT_PACKAGE_SOURCE = 'repo';
+/** Valid values for the reference_source input. */
+export const REFERENCE_SOURCES = ['repo', 'inputs'];
+/** Default reference source: references arrive as run inputs (v1 behaviour). */
+export const DEFAULT_REFERENCE_SOURCE = 'inputs';
 /** Basename of the shipped package archive inside the run-inputs directory. */
 export const PACKAGE_ARCHIVE_BASENAME = 'package.tar.gz';
 /**
@@ -1112,6 +1116,41 @@ function buildPackageSourceMain() {
     return main;
 }
 const RENDER_SCRIPT_MAIN_WITH_PACKAGE_SOURCE = buildPackageSourceMain();
+/**
+ * Patches the reference-sourcing block to read each screen's reference from a
+ * repo-relative path (resolved against the checkout) instead of a plain
+ * basename under `.ci/inputs/`. Applied on top of EITHER base main (v1 or the
+ * package_source variant) — the package patches never touch this block, so the
+ * anchor is present and unique in both. The downstream stat/copy logic is
+ * unchanged; only how `source` is computed differs.
+ */
+function buildReferenceRepoMain(base) {
+    return replaceOnce(base, 'var basename = params.screens[entry.screen];\n' +
+        '    if (\n' +
+        "      typeof basename !== 'string' || basename === '' ||\n" +
+        "      basename === '.' || basename === '..' ||\n" +
+        '      basename !== path.basename(basename)\n' +
+        '    ) {\n' +
+        '      setError(\n' +
+        '        entry,\n' +
+        "        'REFERENCE_MISSING',\n" +
+        "        'reference for ' + entry.screen + ' must be a plain file basename inside ' +\n" +
+        "          inputsDir + ', got: ' + JSON.stringify(basename)\n" +
+        '      );\n' +
+        '      return;\n' +
+        '    }\n' +
+        '    var source = path.join(inputsDir, basename);', 'var refPath = params.screens[entry.screen];\n' +
+        "    if (typeof refPath !== 'string' || refPath === '') {\n" +
+        '      setError(\n' +
+        '        entry,\n' +
+        "        'REFERENCE_MISSING',\n" +
+        "        'reference for ' + entry.screen + ' must be a non-empty repo-relative path, got: ' +\n" +
+        '          JSON.stringify(refPath)\n' +
+        '      );\n' +
+        '      return;\n' +
+        '    }\n' +
+        '    var source = path.resolve(refPath);');
+}
 /**
  * Evaluates the embedded generator source and returns the real functions, so
  * unit tests exercise exactly the code that ships inside the runtime script.
@@ -1133,14 +1172,20 @@ export function getRenderScriptInternals() {
  * unpatched v1 runtime is used).
  */
 export function generateRenderScript(config) {
+    let main = config.packageSource === undefined
+        ? RENDER_SCRIPT_MAIN
+        : RENDER_SCRIPT_MAIN_WITH_PACKAGE_SOURCE;
+    // Reference-from-repo is an independent dimension layered on top of whichever
+    // package base applies. Absent → byte-identical reference block (v1).
+    if (config.referenceSource === 'repo') {
+        main = buildReferenceRepoMain(main);
+    }
     return [
         "'use strict';",
         '// ui-fidelity-render runtime script (generated by cibuild at YAML conversion time)',
         'var CONFIG = ' + JSON.stringify(config) + ';',
         RENDER_SCRIPT_GENERATORS,
-        config.packageSource === undefined
-            ? RENDER_SCRIPT_MAIN
-            : RENDER_SCRIPT_MAIN_WITH_PACKAGE_SOURCE,
+        main,
     ].join('\n');
 }
 /**
@@ -1196,12 +1241,30 @@ export class UiFidelityRenderStepExecutor extends BaseStepExecutor {
             throw new Error(`Invalid target '${target}' for step '${stepName}': ` +
                 'must be a Swift module identifier (letters, digits, underscores)');
         }
+        // reference_source mirrors package_source: validate when provided, but only
+        // record (and patch the script for) the non-default "repo" so omitting it —
+        // or setting the default "inputs" — keeps the v1 reference block intact.
+        const rawReferenceSource = this.getInput(inputs, 'reference_source', undefined);
+        let referenceSource;
+        if (rawReferenceSource !== undefined) {
+            const value = String(rawReferenceSource);
+            if (!REFERENCE_SOURCES.includes(value)) {
+                throw new Error(`Invalid reference_source '${value}' for step '${stepName}': ` +
+                    `expected one of: ${REFERENCE_SOURCES.join(', ')}`);
+            }
+            if (value === 'repo') {
+                referenceSource = 'repo';
+            }
+        }
         const { width, height } = parseRenderSize(String(this.getInput(inputs, 'render_size', DEFAULT_RENDER_SIZE)));
         const scale = parseScale(this.getInput(inputs, 'scale', DEFAULT_SCALE));
         const config = { packagePath, target, width, height, scale };
         if (packageSource !== undefined) {
             config.packageSource = packageSource;
         }
+        if (referenceSource !== undefined) {
+            config.referenceSource = referenceSource;
+        }
         const script = generateRenderScript(config);
         return this.createNodeStep(script, stepName);
     }

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

@@ -319,10 +319,13 @@ describe('registry integration', () => {
         expect(Object.keys(inputs).sort()).toEqual([
             'package_path',
             'package_source',
+            'reference_source',
             'render_size',
             'scale',
             'target',
         ]);
+        expect(inputs.reference_source.required).toBe(false);
+        expect(inputs.reference_source.default).toBe('inputs');
         // package_path/target are enforced by the executor in repo mode (the
         // default); a package_source:inputs config is valid without either, so
         // neither is unconditionally required at the schema level.
@@ -1509,4 +1512,56 @@ describe('committed fixture package', () => {
         expectNoAbsolutePathLeaks(project, result);
     }, 600_000);
 });
+describe('reference_source: repo', () => {
+    test('rejects an unknown reference_source value', async () => {
+        const executor = new UiFidelityRenderStepExecutor();
+        await expect(executor.execute({ package_path: './pkg', target: 'MyViews', reference_source: 'artifact' }, {}, testConfig)).rejects.toThrow(/reference_source/);
+    });
+    test('omitting reference_source bakes no referenceSource into the script config', async () => {
+        const script = await buildScript(makeProject());
+        const configLine = script
+            .split('\n')
+            .find((l) => l.startsWith('var CONFIG = '));
+        expect(configLine).toBeDefined();
+        expect(configLine).not.toContain('referenceSource');
+    });
+    test('reads each screen reference from its repo-relative path in the checkout', async () => {
+        const project = makeProject({
+            screens: { HomeView: 'refs/home.png', SettingsView: 'design/settings.png' },
+        });
+        // Committed references live at repo-relative paths (resolved against cwd),
+        // NOT in .ci/inputs.
+        mkdirSync(join(project.dir, 'refs'), { recursive: true });
+        mkdirSync(join(project.dir, 'design'), { recursive: true });
+        writeFileSync(join(project.dir, 'refs', 'home.png'), Buffer.concat([PNG_MAGIC, Buffer.from('ref:home')]));
+        writeFileSync(join(project.dir, 'design', 'settings.png'), Buffer.concat([PNG_MAGIC, Buffer.from('ref:settings')]));
+        const script = await buildScript(project, { reference_source: 'repo' });
+        const run = runScript(project, script);
+        expect(run.status).toBe(0);
+        expect(isPng(artifact(project, 'ui-fidelity/references/HomeView.png'))).toBe(true);
+        expect(isPng(artifact(project, 'ui-fidelity/references/SettingsView.png'))).toBe(true);
+        const result = readResult(project);
+        expect(result.screens.map((s) => s.status)).toEqual(['rendered', 'rendered']);
+        expect(result.screens.map((s) => s.reference_image_path)).toEqual([
+            'ui-fidelity/references/HomeView.png',
+            'ui-fidelity/references/SettingsView.png',
+        ]);
+    });
+    test('fails one screen when its committed reference is missing, renders the rest', async () => {
+        const project = makeProject({
+            screens: { HomeView: 'refs/home.png', GhostView: 'refs/ghost.png' },
+        });
+        mkdirSync(join(project.dir, 'refs'), { recursive: true });
+        writeFileSync(join(project.dir, 'refs', 'home.png'), Buffer.concat([PNG_MAGIC, Buffer.from('ref:home')]));
+        // refs/ghost.png intentionally absent.
+        const run = runScript(project, await buildScript(project, { reference_source: 'repo' }));
+        expect(run.status).not.toBe(0);
+        const result = readResult(project);
+        const home = result.screens.find((s) => s.screen === 'HomeView');
+        const ghost = result.screens.find((s) => s.screen === 'GhostView');
+        expect(home?.status).toBe('rendered');
+        expect(ghost?.status).toBe('render_failed');
+        expect(ghost?.error?.code).toBe('REFERENCE_MISSING');
+    });
+});
 //# sourceMappingURL=ui-fidelity-render.test.js.map

package/package.json

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