@invarn/cibuild 2.9.5 → 2.9.7

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

@@ -1,1871 +0,0 @@
-/**
- * Tests for the ui-fidelity-render step.
- *
- * The runtime tests execute the generated node script for real inside a temp
- * project directory, with a PATH-shimmed fake `swift` binary so harness
- * builds and renders are deterministic. Fake swift behavior is driven by env
- * vars (FAKE_SWIFT_PROBE_FAIL, FAKE_SWIFT_COMPILE_FAIL, FAKE_SWIFT_RUN_FAIL,
- * FAKE_SWIFT_RUN_SILENT). Like the real toolchain, its failure diagnostics
- * embed the absolute harness package path, so the suite can prove those
- * paths never reach protocol-result.json.
- *
- * The committed SwiftPM fixture (test/fixtures/ui-fidelity-package) is wired
- * through the harness with the fake toolchain in every run; set
- * CIBUILD_UI_FIDELITY_REAL_SWIFT=1 to also build and render it with the real
- * Swift toolchain (macOS with Xcode required, slow).
- */
-import { describe, test, expect, afterAll } from '@jest/globals';
-import { spawn, spawnSync } from 'node:child_process';
-import { gzipSync } from 'node:zlib';
-import { chmodSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, realpathSync, rmSync, writeFileSync, } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { DEFAULT_RENDER_SIZE, DEFAULT_SCALE, UiFidelityRenderStepExecutor, generateRenderScript, getRenderScriptInternals, parseRenderSize, parseScale, } 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]);
-/** The committed SwiftPM fixture used by examples/ui-fidelity-render.yml. */
-const FIXTURE_PACKAGE = resolve(dirname(fileURLToPath(import.meta.url)), '../../../test/fixtures/ui-fidelity-package');
-/**
- * Fake `swift` CLI. Mirrors the exact invocations the render script makes:
- *   swift package --package-path <dir> dump-package
- *   swift build --package-path <dir> --target RenderProbe
- *   swift build --package-path <dir> --product Render_<Screen>
- *   swift run --package-path <dir> --skip-build Render_<Screen> <output.png>
- * dump-package output is driven by FAKE_SWIFT_DUMP_PRODUCTS (comma-separated
- * library product names; unset = "FixtureViews", empty = no products) and
- * FAKE_SWIFT_DUMP_FAIL.
- */
-const FAKE_SWIFT_LINES = [
-    '#!/bin/bash',
-    '[ -n "$FAKE_SWIFT_LOG" ] && echo "$*" >> "$FAKE_SWIFT_LOG"',
-    'cmd="$1"; shift',
-    'case "$cmd" in',
-    '  package)',
-    '    if [ -n "$FAKE_SWIFT_DUMP_FAIL" ]; then',
-    '      echo "error: malformed Package.swift manifest" >&2',
-    '      exit 1',
-    '    fi',
-    '    products="${FAKE_SWIFT_DUMP_PRODUCTS-FixtureViews}"',
-    '    json=""',
-    '    IFS=","',
-    '    for p in $products; do',
-    '      [ -n "$json" ] && json="$json,"',
-    '      json="$json{\\"name\\":\\"$p\\",\\"type\\":{\\"library\\":[\\"automatic\\"]}}"',
-    '    done',
-    '    printf \'{"name":"shipped-package","products":[%s]}\\n\' "$json"',
-    '    exit 0 ;;',
-    '  build)',
-    '    product=""; target=""; pkg=""; showbin=""',
-    '    while [ $# -gt 0 ]; do',
-    '      case "$1" in',
-    '        --product) product="$2"; shift 2 ;;',
-    '        --target) target="$2"; shift 2 ;;',
-    '        --package-path) pkg="$2"; shift 2 ;;',
-    '        --show-bin-path) showbin=1; shift ;;',
-    '        *) shift ;;',
-    '      esac',
-    '    done',
-    '    if [ -n "$showbin" ]; then',
-    '      bp="$pkg/.build/debug"',
-    '      [ -n "$FAKE_SWIFT_MODULE_CATALOG" ] && mkdir -p "$bp/$FAKE_SWIFT_MODULE_CATALOG.bundle/Media.xcassets"',
-    '      echo "$bp"; exit 0',
-    '    fi',
-    '    name="${product:-$target}"',
-    '    if [ "$name" = "RenderProbe" ]; then',
-    '      if [ -n "$FAKE_SWIFT_PROBE_FAIL" ]; then',
-    '        echo "$pkg/Sources/RenderProbe/Probe.swift:1:8: error: could not resolve package dependencies" >&2',
-    '        exit 1',
-    '      fi',
-    '      exit 0',
-    '    fi',
-    '    screen="${name#Render_}"',
-    '    case ",$FAKE_SWIFT_COMPILE_FAIL," in',
-    '      *",$screen,"*)',
-    '        echo "$pkg/Sources/Render_$screen/Render.swift:7:20: error: cannot find $screen in scope" >&2',
-    '        exit 1 ;;',
-    '    esac',
-    '    exit 0 ;;',
-    '  run)',
-    '    pos=()',
-    '    while [ $# -gt 0 ]; do',
-    '      case "$1" in',
-    '        --package-path) shift 2 ;;',
-    '        --skip-build) shift ;;',
-    '        *) pos+=("$1"); shift ;;',
-    '      esac',
-    '    done',
-    '    name="${pos[0]}"; out="${pos[1]}"',
-    '    screen="${name#Render_}"',
-    '    case ",$FAKE_SWIFT_RUN_FAIL," in',
-    '      *",$screen,"*)',
-    '        echo "Fatal error: render failed for $screen" >&2',
-    '        exit 1 ;;',
-    '    esac',
-    '    case ",$FAKE_SWIFT_RUN_SILENT," in',
-    '      *",$screen,"*)',
-    '        exit 0 ;;',
-    '    esac',
-    "    printf '\\x89PNG\\r\\n\\x1a\\n' > \"$out\"",
-    '    printf \'fake-render:%s\' "$screen" >> "$out"',
-    '    exit 0 ;;',
-    '  *)',
-    '    exit 0 ;;',
-    'esac',
-];
-/**
- * PATH-shimmed fake `ci`, providing only the branch the shared trim stage
- * uses: `ci fidelity-trim <in> <out> <aligned> <ref>`. Overwrites <out> with a
- * PNG marked "trimmed:<in basename>" and writes an "aligned:<in basename>" PNG
- * so tests can prove both outputs. Emits a fixed TRIMDIMS line (rendered
- * 320x640, reference 160x320, source 400x800). FAKE_TRIM_FAIL exercises
- * warn-and-continue.
- */
-const FAKE_CI_LINES = [
-    '#!/bin/bash',
-    'case "$1" in',
-    '  fidelity-trim)',
-    '    if [ -n "$FAKE_TRIM_FAIL" ]; then echo "trim: simulated failure" >&2; exit 1; fi',
-    '    in_png="$2"; out_png="$3"; aligned_png="$4"',
-    "    printf '\\x89PNG\\r\\n\\x1a\\n' > \"$out_png\"",
-    '    printf \'trimmed:%s\' "$(basename "$in_png")" >> "$out_png"',
-    '    if [ -n "$aligned_png" ]; then',
-    "      printf '\\x89PNG\\r\\n\\x1a\\n' > \"$aligned_png\"",
-    '      printf \'aligned:%s\' "$(basename "$in_png")" >> "$aligned_png"',
-    '    fi',
-    '    echo "TRIMDIMS 320 640 160 320 400 800"',
-    '    exit 0 ;;',
-    '  *) exit 0 ;;',
-    'esac',
-];
-/**
- * PATH-shimmed fake `xcrun` covering `xcrun actool`. Logs its args to
- * $FAKE_XCRUN_LOG, writes a stub Assets.car into the --compile directory,
- * and fails (exit 1) when FAKE_ACTOOL_FAIL is set so the warn-and-continue
- * path is exercisable.
- */
-const FAKE_XCRUN_LINES = [
-    '#!/bin/bash',
-    '[ -n "$FAKE_XCRUN_LOG" ] && echo "$*" >> "$FAKE_XCRUN_LOG"',
-    'sub="$1"; shift',
-    'case "$sub" in',
-    '  actool)',
-    '    out=""',
-    '    while [ $# -gt 0 ]; do',
-    '      case "$1" in',
-    '        --compile) out="$2"; shift 2 ;;',
-    '        *) shift ;;',
-    '      esac',
-    '    done',
-    '    if [ -n "$FAKE_ACTOOL_FAIL" ]; then',
-    '      echo "error: actool: malformed asset catalog" >&2',
-    '      exit 1',
-    '    fi',
-    '    [ -n "$out" ] && mkdir -p "$out" && printf \'fake-car\' > "$out/Assets.car"',
-    '    exit 0 ;;',
-    '  *)',
-    '    exit 0 ;;',
-    'esac',
-];
-const tempDirs = [];
-afterAll(() => {
-    for (const dir of tempDirs) {
-        try {
-            rmSync(dir, { recursive: true, force: true });
-        }
-        catch {
-            // best effort
-        }
-    }
-});
-function makeProject(params) {
-    const dir = mkdtempSync(join(tmpdir(), 'ui-fidelity-test-'));
-    tempDirs.push(dir);
-    mkdirSync(join(dir, '.ci', 'inputs'), { recursive: true });
-    const packageDir = join(dir, 'user-package');
-    mkdirSync(packageDir, { recursive: true });
-    const binDir = join(dir, 'bin');
-    mkdirSync(binDir, { recursive: true });
-    const swiftPath = join(binDir, 'swift');
-    writeFileSync(swiftPath, FAKE_SWIFT_LINES.join('\n') + '\n');
-    chmodSync(swiftPath, 0o755);
-    const xcrunPath = join(binDir, 'xcrun');
-    writeFileSync(xcrunPath, FAKE_XCRUN_LINES.join('\n') + '\n');
-    chmodSync(xcrunPath, 0o755);
-    const ciPath = join(binDir, 'ci');
-    writeFileSync(ciPath, FAKE_CI_LINES.join('\n') + '\n');
-    chmodSync(ciPath, 0o755);
-    if (params !== undefined) {
-        writeFileSync(join(dir, '.ci', 'inputs', 'params.json'), typeof params === 'string' ? params : JSON.stringify(params));
-    }
-    return { dir, packageDir, binDir };
-}
-function writeReference(project, basename, label = basename) {
-    writeFileSync(join(project.dir, '.ci', 'inputs', basename), Buffer.concat([PNG_MAGIC, Buffer.from('ref:' + label)]));
-}
-async function buildScript(project, inputs = {}) {
-    const executor = new UiFidelityRenderStepExecutor();
-    const step = await executor.execute({ package_path: project.packageDir, target: 'FixtureViews', ...inputs }, {}, testConfig);
-    return step.script;
-}
-function runScript(project, script, env = {}) {
-    return spawnSync('node', ['-e', script], {
-        cwd: project.dir,
-        encoding: 'utf-8',
-        env: {
-            ...process.env,
-            PATH: project.binDir + ':' + (process.env.PATH ?? ''),
-            ...env,
-        },
-    });
-}
-function tarHeader(name, size, typeflag) {
-    const header = Buffer.alloc(512);
-    header.write(name, 0, 100, 'utf-8');
-    header.write('0000755\0', 100, 8, 'ascii'); // mode
-    header.write('0000000\0', 108, 8, 'ascii'); // uid
-    header.write('0000000\0', 116, 8, 'ascii'); // gid
-    header.write(size.toString(8).padStart(11, '0') + '\0', 124, 12, 'ascii');
-    header.write('00000000000\0', 136, 12, 'ascii'); // mtime
-    header.write('        ', 148, 8, 'ascii'); // checksum placeholder
-    header.write(typeflag, 156, 1, 'ascii');
-    header.write('ustar\0' + '00', 257, 8, 'ascii');
-    let checksum = 0;
-    for (const byte of header)
-        checksum += byte;
-    header.write(checksum.toString(8).padStart(6, '0') + '\0 ', 148, 8, 'ascii');
-    return header;
-}
-function makeTarGz(entries) {
-    const blocks = [];
-    for (const entry of entries) {
-        const isDir = entry.name.endsWith('/');
-        const content = Buffer.isBuffer(entry.content)
-            ? entry.content
-            : Buffer.from(entry.content ?? '', 'utf-8');
-        blocks.push(tarHeader(entry.name, isDir ? 0 : content.length, isDir ? '5' : '0'));
-        if (!isDir && content.length > 0) {
-            const padded = Buffer.alloc(Math.ceil(content.length / 512) * 512);
-            content.copy(padded);
-            blocks.push(padded);
-        }
-    }
-    blocks.push(Buffer.alloc(1024)); // end-of-archive
-    return gzipSync(Buffer.concat(blocks));
-}
-const SHIPPED_MANIFEST = [
-    '// swift-tools-version:5.9',
-    'import PackageDescription',
-    'let package = Package(',
-    '    name: "shipped-package",',
-    '    platforms: [.macOS(.v13)],',
-    '    products: [.library(name: "FixtureViews", targets: ["FixtureViews"])],',
-    '    targets: [.target(name: "FixtureViews")]',
-    ')',
-].join('\n');
-/** Entries for a well-formed shipped package under the given root dir ('' = flat). */
-function shippedPackageEntries(root = 'pkg') {
-    const prefix = root === '' ? '' : root + '/';
-    const entries = root === '' ? [] : [{ name: prefix }];
-    entries.push({ name: prefix + 'Package.swift', content: SHIPPED_MANIFEST }, {
-        name: prefix + 'Sources/FixtureViews/HomeView.swift',
-        content: 'import SwiftUI\npublic struct HomeView: View { public init() {} public var body: some View { Text("home") } }\n',
-    });
-    return entries;
-}
-function stageArchive(project, archive) {
-    writeFileSync(join(project.dir, '.ci', 'inputs', 'package.tar.gz'), Buffer.isBuffer(archive) ? archive : makeTarGz(archive));
-}
-async function buildInputsScript(extra = {}) {
-    const executor = new UiFidelityRenderStepExecutor();
-    const step = await executor.execute({ package_source: 'inputs', ...extra }, {}, testConfig);
-    return step.script;
-}
-function readResult(project) {
-    const resultPath = join(project.dir, '.ci', 'artifacts', 'protocol-result.json');
-    expect(existsSync(resultPath)).toBe(true);
-    return JSON.parse(readFileSync(resultPath, 'utf-8'));
-}
-function artifact(project, relative) {
-    return join(project.dir, '.ci', 'artifacts', relative);
-}
-function isPng(filePath) {
-    const head = readFileSync(filePath).subarray(0, PNG_MAGIC.length);
-    return head.equals(PNG_MAGIC);
-}
-/**
- * Asserts that no error message in the result document contains an absolute
- * runner-filesystem path: not the project dir (the script's cwd), not the OS
- * temp dir (where harness packages and extracted shipped packages live), in
- * either symlinked (/var/folders/...) or resolved (/private/var/...) form.
- * Covers both per-screen errors and the build-level error object.
- */
-function expectNoAbsolutePathLeaks(project, result) {
-    const forbidden = new Set();
-    for (const dir of [project.dir, tmpdir()]) {
-        forbidden.add(dir);
-        try {
-            forbidden.add(realpathSync(dir));
-        }
-        catch {
-            // nonexistent — literal form only
-        }
-    }
-    const messages = result.screens.map((screen) => screen.error?.message ?? '');
-    messages.push(result.error?.message ?? '');
-    for (const message of messages) {
-        for (const dir of forbidden) {
-            expect(message).not.toContain(dir);
-        }
-    }
-}
-describe('registry integration', () => {
-    test('ui-fidelity-render is registered with its input schema', () => {
-        clearRegistry();
-        initializeStepRegistry();
-        expect(hasStep('ui-fidelity-render')).toBe(true);
-        const metadata = getStepMetadata('ui-fidelity-render');
-        expect(metadata?.platform).toBe('ios');
-        const inputs = metadata?.inputs ?? {};
-        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.
-        expect(inputs.package_path.required).toBe(false);
-        expect(inputs.target.required).toBe(false);
-        expect(inputs.package_source.required).toBe(false);
-        expect(inputs.package_source.default).toBe('repo');
-        expect(inputs.render_size.required).toBe(false);
-        expect(inputs.render_size.default).toBe(DEFAULT_RENDER_SIZE);
-        expect(inputs.scale.required).toBe(false);
-        expect(inputs.scale.default).toBe(DEFAULT_SCALE);
-    });
-});
-describe('v1 byte compatibility', () => {
-    // Snapshot of the script generated before package_source existed, captured
-    // from the executor with package_path './MyAppPackage' and target
-    // 'MyAppViews' (defaults for everything else). Omitting package_source must
-    // keep the generated script byte-identical to that snapshot, so existing
-    // protocols are provably untouched. Update the snapshot only for a
-    // deliberate, reviewed change to the v1 runtime.
-    const V1_SCRIPT_SNAPSHOT = resolve(dirname(fileURLToPath(import.meta.url)), '../../../test/fixtures/ui-fidelity-render-v1-script.txt');
-    test('omitting package_source generates a byte-identical script', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        const step = await executor.execute({ package_path: './MyAppPackage', target: 'MyAppViews' }, {}, testConfig);
-        expect(step.script).toBe(readFileSync(V1_SCRIPT_SNAPSHOT, 'utf-8'));
-    });
-});
-describe('UiFidelityRenderStepExecutor', () => {
-    test('returns a node StepDef', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        const step = await executor.execute({ package_path: './pkg', target: 'MyViews' }, {}, testConfig);
-        expect(step.kind).toBe('node');
-        expect(step.name).toBe('ui-fidelity-render');
-        expect(step.script.length).toBeGreaterThan(0);
-    });
-    test('bakes resolved defaults into the script config', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        const step = await executor.execute({ package_path: './pkg', target: 'MyViews' }, {}, testConfig);
-        expect(step.script).toContain('"width":393');
-        expect(step.script).toContain('"height":852');
-        expect(step.script).toContain('"scale":2');
-        expect(step.script).toContain('"target":"MyViews"');
-    });
-    test('honors explicit render_size and scale', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        const step = await executor.execute({ package_path: './pkg', target: 'MyViews', render_size: '430x932', scale: 3 }, {}, testConfig);
-        expect(step.script).toContain('"width":430');
-        expect(step.script).toContain('"height":932');
-        expect(step.script).toContain('"scale":3');
-    });
-    test('throws when package_path is missing', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        await expect(executor.execute({ target: 'MyViews' }, {}, testConfig)).rejects.toThrow("Missing required input 'package_path'");
-    });
-    test('throws when target is missing', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        await expect(executor.execute({ package_path: './pkg' }, {}, testConfig)).rejects.toThrow("Missing required input 'target'");
-    });
-    test('rejects a target that is not a Swift module identifier', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        await expect(executor.execute({ package_path: './pkg', target: 'My Views' }, {}, testConfig)).rejects.toThrow(/target/i);
-    });
-    test('rejects malformed render_size', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        await expect(executor.execute({ package_path: './pkg', target: 'MyViews', render_size: 'huge' }, {}, testConfig)).rejects.toThrow(/render_size/);
-    });
-});
-describe('package_source input', () => {
-    test('rejects an unknown package_source value', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        await expect(executor.execute({ package_path: './pkg', target: 'MyViews', package_source: 'artifact' }, {}, testConfig)).rejects.toThrow(/package_source/);
-    });
-    test('omitting package_source bakes no packageSource into the script config', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        const step = await executor.execute({ package_path: './pkg', target: 'MyViews' }, {}, testConfig);
-        expect(step.script).not.toContain('packageSource');
-    });
-    test('explicit repo keeps the v1 inputs required and records the source', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        const step = await executor.execute({ package_path: './pkg', target: 'MyViews', package_source: 'repo' }, {}, testConfig);
-        expect(step.kind).toBe('node');
-        expect(step.script).toContain('"packageSource":"repo"');
-        expect(step.script).toContain('"packagePath":"./pkg"');
-        await expect(executor.execute({ target: 'MyViews', package_source: 'repo' }, {}, testConfig)).rejects.toThrow("Missing required input 'package_path'");
-        await expect(executor.execute({ package_path: './pkg', package_source: 'repo' }, {}, testConfig)).rejects.toThrow("Missing required input 'target'");
-    });
-    test('inputs mode requires neither package_path nor target', async () => {
-        const script = await buildInputsScript();
-        expect(script).toContain('"packageSource":"inputs"');
-        expect(script).toContain('"packagePath":null');
-        expect(script).toContain('"target":null');
-    });
-    test('inputs mode ignores package_path and honors an explicit target', async () => {
-        const script = await buildInputsScript({ package_path: './pkg', target: 'MyViews' });
-        expect(script).toContain('"packagePath":null');
-        expect(script).toContain('"target":"MyViews"');
-    });
-    test('inputs mode still rejects a malformed target', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        await expect(executor.execute({ package_source: 'inputs', target: 'My Views' }, {}, testConfig)).rejects.toThrow(/target/i);
-    });
-    test('validation requirements branch on the package source', () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        const v1Names = executor
-            .getValidationRequirements({ package_path: './pkg', target: 'MyViews' }, {}, testConfig)
-            .map((requirement) => requirement.name);
-        expect(v1Names).toEqual(['package_path', 'target', 'swift']);
-        const inputsNames = executor
-            .getValidationRequirements({ package_source: 'inputs' }, {}, testConfig)
-            .map((requirement) => requirement.name);
-        expect(inputsNames).toEqual(['swift', 'tar']);
-    });
-});
-// Clone-free package delivery (fidelity-linux 03): the dispatched YAML carries
-// a signed package_url; the runtime downloads it to .ci/inputs/package.tar.gz
-// and proceeds like inputs mode, resolving each screen's committed reference
-// INSIDE the extracted package (repo-relative path minus the package_path
-// prefix) — there is no checkout on a clone-free worker. Mirrors the Android
-// step's url mode so both platform kinds accept the same dispatched inputs.
-describe('package_source: url', () => {
-    /**
-     * Serve one tar.gz (or a 404) from a loopback HTTP server IN A CHILD
-     * PROCESS. runScript executes the generated script via spawnSync, which
-     * blocks this process's event loop — an in-process server would deadlock
-     * against the script's curl.
-     */
-    const SERVE_PACKAGE_SRC = [
-        "var http = require('http');",
-        "var fs = require('fs');",
-        'var filePath = process.argv[1];',
-        'var server = http.createServer(function (req, res) {',
-        "  if (filePath === '-') { res.statusCode = 404; res.end('gone'); return; }",
-        "  res.setHeader('content-type', 'application/gzip');",
-        '  res.end(fs.readFileSync(filePath));',
-        '});',
-        "server.listen(0, '127.0.0.1', function () {",
-        "  console.log('PORT ' + server.address().port);",
-        '});',
-    ].join('\n');
-    async function servePackage(archive) {
-        let filePath = '-';
-        if (archive !== null) {
-            const dir = mkdtempSync(join(tmpdir(), 'ui-fidelity-url-serve-'));
-            tempDirs.push(dir);
-            filePath = join(dir, 'package.tar.gz');
-            writeFileSync(filePath, archive);
-        }
-        const child = spawn('node', ['-e', SERVE_PACKAGE_SRC, filePath], {
-            stdio: ['ignore', 'pipe', 'inherit'],
-        });
-        const port = await new Promise((resolvePort, rejectPort) => {
-            let buffered = '';
-            const timer = setTimeout(() => rejectPort(new Error('package server did not start')), 10_000);
-            child.stdout.on('data', (chunk) => {
-                buffered += chunk.toString();
-                const match = /PORT (\d+)/.exec(buffered);
-                if (match) {
-                    clearTimeout(timer);
-                    resolvePort(Number(match[1]));
-                }
-            });
-            child.on('exit', () => rejectPort(new Error('package server exited early')));
-        });
-        return {
-            url: `http://127.0.0.1:${port}/api/fidelity/packages/blob1?exp=1&sig=ab`,
-            close: () => new Promise((resolveClose) => {
-                child.once('exit', () => resolveClose(undefined));
-                child.kill('SIGKILL');
-            }),
-        };
-    }
-    /** Archive shaped like the dashboard's assembly: package-dir contents at the
-     *  archive root, committed references under references/. */
-    function packagedProjectWithReference() {
-        return makeTarGz([
-            ...shippedPackageEntries(''),
-            {
-                name: 'references/home.png',
-                content: Buffer.concat([PNG_MAGIC, Buffer.from('ref:url-home')]),
-            },
-        ]);
-    }
-    test('package_source url requires package_url and package_path', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        await expect(executor.execute({ package_source: 'url', package_path: 'ios-pkg' }, {}, testConfig)).rejects.toThrow(/package_url/);
-        await expect(executor.execute({ package_source: 'url', package_url: 'https://x.test/p' }, {}, testConfig)).rejects.toThrow(/package_path/);
-    });
-    test('rejects reference_source alongside package_source url', async () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        await expect(executor.execute({
-            package_source: 'url',
-            package_url: 'https://x.test/p',
-            package_path: 'ios-pkg',
-            reference_source: 'repo',
-        }, {}, testConfig)).rejects.toThrow(/reference_source/);
-    });
-    test('url mode requires swift, tar, and curl', () => {
-        const executor = new UiFidelityRenderStepExecutor();
-        const names = executor
-            .getValidationRequirements({ package_source: 'url' }, {}, testConfig)
-            .map((requirement) => requirement.name);
-        expect(names).toEqual(['swift', 'tar', 'curl']);
-    });
-    test('downloads the package, renders, and resolves references inside it', async () => {
-        const project = makeProject({ screens: { HomeView: 'ios-pkg/references/home.png' } });
-        const served = await servePackage(packagedProjectWithReference());
-        try {
-            const executor = new UiFidelityRenderStepExecutor();
-            const step = await executor.execute({ package_source: 'url', package_url: served.url, package_path: 'ios-pkg' }, {}, testConfig);
-            const run = runScript(project, step.script);
-            expect(run.status).toBe(0);
-            const doc = readResult(project);
-            expect(doc.package_source).toBe('url');
-            const screen = doc.screens.find((s) => s.screen === 'HomeView');
-            expect(screen?.status).toBe('rendered');
-            expect(screen?.reference_image_path).toBe('ui-fidelity/references/HomeView.png');
-            expect(isPng(artifact(project, 'ui-fidelity/references/HomeView.png'))).toBe(true);
-        }
-        finally {
-            await served.close();
-        }
-    });
-    test('a failed download is one structured build error, not per-screen noise', async () => {
-        const project = makeProject({ screens: { HomeView: 'ios-pkg/references/home.png' } });
-        const served = await servePackage(null); // 404
-        try {
-            const executor = new UiFidelityRenderStepExecutor();
-            const step = await executor.execute({ package_source: 'url', package_url: served.url, package_path: 'ios-pkg' }, {}, testConfig);
-            const run = runScript(project, step.script);
-            expect(run.status).not.toBe(0);
-            const doc = readResult(project);
-            expect(doc.error?.code).toBe('PACKAGE_DOWNLOAD_FAILED');
-            const screen = doc.screens.find((s) => s.screen === 'HomeView');
-            expect(screen?.error).toBeNull();
-            expectNoAbsolutePathLeaks(project, doc);
-        }
-        finally {
-            await served.close();
-        }
-    });
-    test('a reference outside the package directory fails that screen only', async () => {
-        const project = makeProject({
-            screens: {
-                HomeView: 'ios-pkg/references/home.png',
-                Stray: 'design/elsewhere/stray.png',
-            },
-        });
-        const served = await servePackage(packagedProjectWithReference());
-        try {
-            const executor = new UiFidelityRenderStepExecutor();
-            const step = await executor.execute({ package_source: 'url', package_url: served.url, package_path: 'ios-pkg' }, {}, testConfig);
-            const run = runScript(project, step.script, { FAKE_SWIFT_RUN_SILENT: 'Stray' });
-            expect(run.status).not.toBe(0);
-            const doc = readResult(project);
-            expect(doc.screens.find((s) => s.screen === 'HomeView')?.status).toBe('rendered');
-            const stray = doc.screens.find((s) => s.screen === 'Stray');
-            expect(stray?.status).toBe('render_failed');
-            expect(stray?.error?.code).toBe('REFERENCE_MISSING');
-        }
-        finally {
-            await served.close();
-        }
-    });
-});
-describe('render size and scale parsing', () => {
-    test('default render size is 393x852 device points', () => {
-        expect(DEFAULT_RENDER_SIZE).toBe('393x852');
-        expect(parseRenderSize(DEFAULT_RENDER_SIZE)).toEqual({ width: 393, height: 852 });
-    });
-    test('default scale is 2', () => {
-        expect(DEFAULT_SCALE).toBe(2);
-        expect(parseScale(DEFAULT_SCALE)).toBe(2);
-    });
-    test('parses explicit sizes and string scales', () => {
-        expect(parseRenderSize('430x932')).toEqual({ width: 430, height: 932 });
-        expect(parseScale('3')).toBe(3);
-    });
-    test('rejects zero or malformed values', () => {
-        expect(() => parseRenderSize('0x852')).toThrow(/render_size/);
-        expect(() => parseRenderSize('393by852')).toThrow(/render_size/);
-        expect(() => parseScale('-1')).toThrow(/scale/);
-        expect(() => parseScale('big')).toThrow(/scale/);
-    });
-});
-describe('harness source generation', () => {
-    const internals = getRenderScriptInternals();
-    const options = {
-        packagePath: '/abs/path/to/user-package',
-        packageRef: 'user-package',
-        target: 'FixtureViews',
-        width: 393,
-        height: 852,
-        scale: 2,
-    };
-    test('Package.swift declares one executable target and product per screen', () => {
-        const manifest = internals.generateHarnessPackageSwift(['HomeView', 'SettingsView'], options);
-        expect(manifest).toContain('.executableTarget(name: "Render_HomeView"');
-        expect(manifest).toContain('.executableTarget(name: "Render_SettingsView"');
-        expect(manifest).toContain('.executable(name: "Render_HomeView", targets: ["Render_HomeView"])');
-        expect(manifest).toContain('.executable(name: "Render_SettingsView", targets: ["Render_SettingsView"])');
-        expect(manifest).toContain('.executableTarget(name: "RenderProbe"');
-        expect(manifest).toContain('.package(path: "/abs/path/to/user-package")');
-        expect(manifest).toContain('.product(name: "FixtureViews", package: "user-package")');
-        expect(manifest).toContain('platforms: [.macOS(.v13)]');
-    });
-    test('screen source constructs the view with a parameterless init', () => {
-        const source = internals.generateScreenSwift('HomeView', options);
-        expect(source).toContain('import FixtureViews');
-        expect(source).toContain('import SwiftUI');
-        expect(source).toContain('let view = HomeView().frame(width: width, height: height)');
-        expect(source).toContain('let width: CGFloat = 393');
-        expect(source).toContain('let height: CGFloat = 852');
-        expect(source).toContain('renderer.scale = 2');
-        expect(source).toContain('ImageRenderer(content: view)');
-        expect(source).toContain('@main');
-        expect(source).toContain('@MainActor');
-        expect(source).toContain('CGImageDestinationFinalize');
-        // Regression: .utf8 must apply to the concatenated message, not the
-        // trailing variable (caught by a real swift build).
-        expect(source).toContain('Data(("could not write PNG to " + outputPath).utf8)');
-        expect(source).not.toContain('outputPath.utf8');
-    });
-    test('probe source imports the target without referencing screens', () => {
-        const source = internals.generateProbeSwift(options);
-        expect(source).toContain('import FixtureViews');
-        expect(source).not.toContain('HomeView');
-    });
-    test('swift string literals escape quotes and backslashes', () => {
-        expect(internals.swiftStringLiteral('plain')).toBe('"plain"');
-        expect(internals.swiftStringLiteral('a"b')).toBe('"a\\"b"');
-        expect(internals.swiftStringLiteral('a\\b')).toBe('"a\\\\b"');
-    });
-});
-describe('render script runtime', () => {
-    test('happy path renders every screen and exits 0', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', SettingsView: 'settings.png' },
-        });
-        writeReference(project, 'home.png');
-        writeReference(project, 'settings.png');
-        const script = await buildScript(project);
-        const run = runScript(project, script);
-        expect(run.status).toBe(0);
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/HomeView.png'))).toBe(true);
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/SettingsView.png'))).toBe(true);
-        expect(isPng(artifact(project, 'ui-fidelity/references/HomeView.png'))).toBe(true);
-        expect(isPng(artifact(project, 'ui-fidelity/references/SettingsView.png'))).toBe(true);
-        expect(readResult(project)).toEqual({
-            renderer: 'imagerenderer-spm',
-            screens: [
-                {
-                    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}$/),
-                },
-                {
-                    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}$/),
-                },
-            ],
-        });
-    });
-    test('result entries follow params.json order and use relative paths', async () => {
-        const project = makeProject({
-            screens: { ZetaView: 'zeta.png', AlphaView: 'alpha.png' },
-        });
-        writeReference(project, 'zeta.png');
-        writeReference(project, 'alpha.png');
-        const run = runScript(project, await buildScript(project));
-        expect(run.status).toBe(0);
-        const result = readResult(project);
-        expect(result.screens.map((s) => s.screen)).toEqual(['ZetaView', 'AlphaView']);
-        for (const screen of result.screens) {
-            expect(screen.reference_image_path).not.toMatch(/^\//);
-            expect(screen.rendered_image_path).not.toMatch(/^\//);
-        }
-    });
-    test('a broken screen fails alone; other screens still render', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', MissingView: 'missing-view.png' },
-        });
-        writeReference(project, 'home.png');
-        writeReference(project, 'missing-view.png');
-        const run = runScript(project, await buildScript(project), {
-            FAKE_SWIFT_COMPILE_FAIL: 'MissingView',
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.screens).toHaveLength(2);
-        const [home, missing] = result.screens;
-        expect(home.screen).toBe('HomeView');
-        expect(home.status).toBe('rendered');
-        expect(home.error).toBeNull();
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/HomeView.png'))).toBe(true);
-        expect(missing.screen).toBe('MissingView');
-        expect(missing.status).toBe('render_failed');
-        expect(missing.error?.code).toBe('VIEW_COMPILE_FAILED');
-        expect(missing.error?.message).toContain('cannot find MissingView in scope');
-        expect(missing.rendered_image_path).toBeNull();
-        expect(existsSync(artifact(project, 'ui-fidelity/rendered/MissingView.png'))).toBe(false);
-    });
-    test('a render-time crash marks only that screen RENDER_FAILED', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', SettingsView: 'settings.png' },
-        });
-        writeReference(project, 'home.png');
-        writeReference(project, 'settings.png');
-        const run = runScript(project, await buildScript(project), {
-            FAKE_SWIFT_RUN_FAIL: 'SettingsView',
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        const [home, settings] = result.screens;
-        expect(home.status).toBe('rendered');
-        expect(settings.status).toBe('render_failed');
-        expect(settings.error?.code).toBe('RENDER_FAILED');
-        expect(settings.error?.message).toContain('render failed for SettingsView');
-    });
-    test('two screens sharing one reference get two distinct copies', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'shared.png', SettingsView: 'shared.png' },
-        });
-        writeReference(project, 'shared.png');
-        const run = runScript(project, await buildScript(project));
-        expect(run.status).toBe(0);
-        const homeRef = artifact(project, 'ui-fidelity/references/HomeView.png');
-        const settingsRef = artifact(project, 'ui-fidelity/references/SettingsView.png');
-        expect(existsSync(homeRef)).toBe(true);
-        expect(existsSync(settingsRef)).toBe(true);
-        expect(readFileSync(homeRef).equals(readFileSync(settingsRef))).toBe(true);
-        const result = readResult(project);
-        expect(result.screens[0].reference_image_path).toBe('ui-fidelity/references/HomeView.png');
-        expect(result.screens[1].reference_image_path).toBe('ui-fidelity/references/SettingsView.png');
-    });
-    test('a missing reference fails that screen with REFERENCE_MISSING', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', SettingsView: 'nonexistent.png' },
-        });
-        writeReference(project, 'home.png');
-        const run = runScript(project, await buildScript(project));
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        const [home, settings] = result.screens;
-        expect(home.status).toBe('rendered');
-        expect(settings.status).toBe('render_failed');
-        expect(settings.error?.code).toBe('REFERENCE_MISSING');
-        expect(settings.reference_image_path).toBeNull();
-        expect(settings.rendered_image_path).toBeNull();
-        expect(existsSync(artifact(project, 'ui-fidelity/references/SettingsView.png'))).toBe(false);
-    });
-    test("a reference of '..' or '.' fails only that screen with REFERENCE_MISSING", async () => {
-        const project = makeProject({
-            screens: { HomeView: '..', AboutView: '.', SettingsView: 'settings.png' },
-        });
-        writeReference(project, 'settings.png');
-        const run = runScript(project, await buildScript(project));
-        expect(run.status).not.toBe(0);
-        const [home, about, settings] = readResult(project).screens;
-        expect(home.status).toBe('render_failed');
-        expect(home.error?.code).toBe('REFERENCE_MISSING');
-        expect(about.status).toBe('render_failed');
-        expect(about.error?.code).toBe('REFERENCE_MISSING');
-        // Per-screen isolation: the valid screen still renders.
-        expect(settings.status).toBe('rendered');
-        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' },
-        });
-        mkdirSync(join(project.dir, '.ci', 'inputs', 'home-dir.png'));
-        writeReference(project, 'settings.png');
-        const run = runScript(project, await buildScript(project));
-        expect(run.status).not.toBe(0);
-        const [home, settings] = readResult(project).screens;
-        expect(home.status).toBe('render_failed');
-        expect(home.error?.code).toBe('REFERENCE_MISSING');
-        expect(home.reference_image_path).toBeNull();
-        expect(settings.status).toBe('rendered');
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/SettingsView.png'))).toBe(true);
-    });
-    test('a harness-level failure marks every screen RENDER_UNSUPPORTED', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', SettingsView: 'settings.png' },
-        });
-        writeReference(project, 'home.png');
-        writeReference(project, 'settings.png');
-        const run = runScript(project, await buildScript(project), {
-            FAKE_SWIFT_PROBE_FAIL: '1',
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.screens).toHaveLength(2);
-        for (const screen of result.screens) {
-            expect(screen.status).toBe('render_failed');
-            expect(screen.error?.code).toBe('RENDER_UNSUPPORTED');
-            expect(screen.error?.message).toContain('could not resolve package dependencies');
-            expect(screen.rendered_image_path).toBeNull();
-        }
-    });
-    test('a nonexistent package path marks every screen RENDER_UNSUPPORTED', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const script = await buildScript(project, {
-            package_path: join(project.dir, 'no-such-package'),
-        });
-        const run = runScript(project, script);
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.screens[0].error?.code).toBe('RENDER_UNSUPPORTED');
-    });
-    test('absent params.json fails with an empty-screens result document', async () => {
-        const project = makeProject();
-        const run = runScript(project, await buildScript(project));
-        expect(run.status).not.toBe(0);
-        expect(run.stderr).toContain('params.json');
-        expect(readResult(project)).toEqual({ renderer: 'imagerenderer-spm', screens: [] });
-    });
-    test('malformed params.json fails with an empty-screens result document', async () => {
-        const project = makeProject('{ not json');
-        const run = runScript(project, await buildScript(project));
-        expect(run.status).not.toBe(0);
-        expect(run.stderr).toContain('params.json');
-        expect(readResult(project)).toEqual({ renderer: 'imagerenderer-spm', screens: [] });
-    });
-    test('params.json without a screens object fails the same way', async () => {
-        const project = makeProject({ views: { HomeView: 'home.png' } });
-        const run = runScript(project, await buildScript(project));
-        expect(run.status).not.toBe(0);
-        expect(readResult(project)).toEqual({ renderer: 'imagerenderer-spm', screens: [] });
-    });
-    test('screens given as an array fails like malformed params', async () => {
-        const project = makeProject({ screens: ['HomeView'] });
-        const run = runScript(project, await buildScript(project));
-        expect(run.status).not.toBe(0);
-        expect(readResult(project)).toEqual({ renderer: 'imagerenderer-spm', screens: [] });
-    });
-    test('an empty screens object succeeds with an empty result document', async () => {
-        const project = makeProject({ screens: {} });
-        const logPath = join(project.dir, 'swift-invocations.log');
-        const run = runScript(project, await buildScript(project), { FAKE_SWIFT_LOG: logPath });
-        expect(run.status).toBe(0);
-        expect(readResult(project)).toEqual({ renderer: 'imagerenderer-spm', screens: [] });
-        // No screens means the harness is never built: swift is never invoked.
-        expect(existsSync(logPath)).toBe(false);
-    });
-    test('a screen name that is not a Swift identifier never reaches generated Swift', async () => {
-        const injection = 'HomeView()); }; import Foundation //';
-        const project = makeProject({
-            screens: { [injection]: 'evil.png', SettingsView: 'settings.png' },
-        });
-        writeReference(project, 'evil.png');
-        writeReference(project, 'settings.png');
-        const logPath = join(project.dir, 'swift-invocations.log');
-        const run = runScript(project, await buildScript(project), {
-            FAKE_SWIFT_LOG: logPath,
-            UI_FIDELITY_KEEP_HARNESS: '1',
-        });
-        expect(run.status).not.toBe(0);
-        const [bad, good] = readResult(project).screens;
-        expect(bad.screen).toBe(injection);
-        expect(bad.status).toBe('render_failed');
-        expect(bad.error?.code).toBe('INVALID_SCREEN_NAME');
-        expect(bad.rendered_image_path).toBeNull();
-        expect(good.status).toBe('rendered');
-        // The injected name never appears in any swift invocation, and the
-        // synthesized harness contains sources only for the valid screen.
-        const invocations = readFileSync(logPath, 'utf-8');
-        expect(invocations).not.toContain('import Foundation //');
-        const probeArgs = invocations.trim().split('\n')[0].split(' ');
-        const harnessDir = probeArgs[probeArgs.indexOf('--package-path') + 1];
-        tempDirs.push(harnessDir);
-        expect(readdirSync(join(harnessDir, 'Sources')).sort()).toEqual([
-            'RenderProbe',
-            'Render_SettingsView',
-        ]);
-        expect(readFileSync(join(harnessDir, 'Package.swift'), 'utf-8')).not.toContain('import Foundation //');
-    });
-    test('respects CIBUILD_ARTIFACTS_DIR', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const run = runScript(project, await buildScript(project), {
-            CIBUILD_ARTIFACTS_DIR: 'custom-artifacts',
-        });
-        expect(run.status).toBe(0);
-        const resultPath = join(project.dir, 'custom-artifacts', 'protocol-result.json');
-        expect(existsSync(resultPath)).toBe(true);
-        expect(isPng(join(project.dir, 'custom-artifacts', 'ui-fidelity', 'rendered', 'HomeView.png'))).toBe(true);
-    });
-    test('synthesizes the harness on disk: probe first, then per-screen build and run', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', SettingsView: 'settings.png' },
-        });
-        writeReference(project, 'home.png');
-        writeReference(project, 'settings.png');
-        const logPath = join(project.dir, 'swift-invocations.log');
-        const run = runScript(project, await buildScript(project), {
-            FAKE_SWIFT_LOG: logPath,
-            UI_FIDELITY_KEEP_HARNESS: '1',
-        });
-        expect(run.status).toBe(0);
-        const invocations = readFileSync(logPath, 'utf-8').trim().split('\n');
-        expect(invocations[0]).toContain('--target RenderProbe');
-        expect(invocations[1]).toContain('--product Render_HomeView');
-        expect(invocations[2]).toMatch(/^run /);
-        expect(invocations[2]).toContain('Render_HomeView');
-        expect(invocations[3]).toContain('--product Render_SettingsView');
-        expect(invocations[4]).toContain('Render_SettingsView');
-        const probeArgs = invocations[0].split(' ');
-        const harnessDir = probeArgs[probeArgs.indexOf('--package-path') + 1];
-        tempDirs.push(harnessDir);
-        expect(existsSync(join(harnessDir, 'Package.swift'))).toBe(true);
-        const manifest = readFileSync(join(harnessDir, 'Package.swift'), 'utf-8');
-        expect(manifest).toContain('.executableTarget(name: "Render_HomeView"');
-        expect(manifest).toContain('.executableTarget(name: "Render_SettingsView"');
-        const homeSource = readFileSync(join(harnessDir, 'Sources', 'Render_HomeView', 'Render.swift'), 'utf-8');
-        expect(homeSource).toContain('HomeView().frame(width: width, height: height)');
-        expect(existsSync(join(harnessDir, 'Sources', 'RenderProbe', 'Probe.swift'))).toBe(true);
-    });
-    test('a nonexistent relative package path is reported as configured, never resolved', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const script = await buildScript(project, { package_path: 'no-such-package' });
-        const run = runScript(project, script);
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.screens[0].error?.code).toBe('RENDER_UNSUPPORTED');
-        expect(result.screens[0].error?.message).toContain('no-such-package');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('an absolute package path is replaced by a placeholder in error messages', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const script = await buildScript(project, {
-            package_path: join(project.dir, 'no-such-package'),
-        });
-        const run = runScript(project, script);
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.screens[0].error?.code).toBe('RENDER_UNSUPPORTED');
-        expect(result.screens[0].error?.message).toContain('<package_path>');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('probe-failure diagnostics are scrubbed of absolute harness and package paths', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const script = await buildScript(project, { package_path: 'user-package' });
-        const run = runScript(project, script, { FAKE_SWIFT_PROBE_FAIL: '1' });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        const message = result.screens[0].error?.message ?? '';
-        expect(result.screens[0].error?.code).toBe('RENDER_UNSUPPORTED');
-        expect(message).toContain('the package at user-package does not build');
-        expect(message).toContain('<harness>/Sources/RenderProbe/Probe.swift');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('compiler diagnostics for a broken screen are scrubbed of absolute paths', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', MissingView: 'missing-view.png' },
-        });
-        writeReference(project, 'home.png');
-        writeReference(project, 'missing-view.png');
-        const run = runScript(project, await buildScript(project), {
-            FAKE_SWIFT_COMPILE_FAIL: 'MissingView',
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        const missing = result.screens[1];
-        expect(missing.error?.code).toBe('VIEW_COMPILE_FAILED');
-        expect(missing.error?.message).toContain('<harness>/Sources/Render_MissingView/Render.swift');
-        expect(missing.error?.message).toContain('cannot find MissingView in scope');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('a renderer that exits 0 without a PNG reports the artifacts-relative path', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const run = runScript(project, await buildScript(project), {
-            FAKE_SWIFT_RUN_SILENT: 'HomeView',
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.screens[0].error?.code).toBe('RENDER_FAILED');
-        expect(result.screens[0].error?.message).toContain('.ci/artifacts/ui-fidelity/rendered/HomeView.png');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('an absolute CIBUILD_ARTIFACTS_DIR is replaced by a placeholder in error messages', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const artifactsDir = join(project.dir, 'abs-artifacts');
-        const run = runScript(project, await buildScript(project), {
-            CIBUILD_ARTIFACTS_DIR: artifactsDir,
-            FAKE_SWIFT_RUN_SILENT: 'HomeView',
-        });
-        expect(run.status).not.toBe(0);
-        const resultPath = join(artifactsDir, 'protocol-result.json');
-        expect(existsSync(resultPath)).toBe(true);
-        const result = JSON.parse(readFileSync(resultPath, 'utf-8'));
-        expect(result.screens[0].error?.code).toBe('RENDER_FAILED');
-        expect(result.screens[0].error?.message).toContain('<artifacts>/ui-fidelity/rendered/HomeView.png');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('generateRenderScript output is directly executable', () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const script = generateRenderScript({
-            packagePath: project.packageDir,
-            target: 'FixtureViews',
-            width: 393,
-            height: 852,
-            scale: 2,
-        });
-        const run = runScript(project, script);
-        expect(run.status).toBe(0);
-        expect(readResult(project).screens[0].status).toBe('rendered');
-    });
-});
-describe('render script runtime (package_source: repo)', () => {
-    test('explicit repo renders like v1 and records the package source', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const script = await buildScript(project, { package_source: 'repo' });
-        const run = runScript(project, script);
-        expect(run.status).toBe(0);
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/HomeView.png'))).toBe(true);
-        expect(readResult(project)).toEqual({
-            renderer: 'imagerenderer-spm',
-            package_source: 'repo',
-            error: null,
-            screens: [
-                {
-                    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}$/),
-                    aligned_image_path: 'ui-fidelity/aligned/HomeView.png',
-                    dimensions: {
-                        rendered_px: [320, 640],
-                        logical_pt: [160, 320],
-                        reference_px: [160, 320],
-                        // the fake helper's TRIMDIMS pre-trim source px (fields 5-6)
-                        source_px: [400, 800],
-                    },
-                },
-            ],
-        });
-    });
-    test('compiles asset catalogs found in the package before rendering', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        // A catalog at the package root: SwiftPM ignores it, so the renderer must
-        // compile it with actool for Image("name") to resolve at render time.
-        const catalog = join(project.packageDir, 'Assets', 'Media.xcassets');
-        mkdirSync(catalog, { recursive: true });
-        writeFileSync(join(catalog, 'Contents.json'), '{}');
-        const script = await buildScript(project, { package_source: 'repo' });
-        const xcrunLog = join(project.dir, 'xcrun-invocations.log');
-        const run = runScript(project, script, { FAKE_XCRUN_LOG: xcrunLog });
-        expect(run.status).toBe(0);
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/HomeView.png'))).toBe(true);
-        const xcrunCalls = readFileSync(xcrunLog, 'utf-8');
-        expect(xcrunCalls).toContain('actool');
-        expect(xcrunCalls).toContain('Media.xcassets');
-        expect(xcrunCalls).toContain('--compile');
-        expect(xcrunCalls).toContain('--platform macosx');
-    });
-    test('also compiles catalogs in module bundles for Bundle.module references', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        // Source catalog drives the main-bundle (Bundle.main) compile. The module
-        // bundle — which the fake toolchain materializes to mimic `swift build`
-        // copying a .process resource — must ALSO be compiled in place, or an
-        // Image("name", bundle: .module) reference finds only the raw catalog.
-        const catalog = join(project.packageDir, 'Assets', 'Media.xcassets');
-        mkdirSync(catalog, { recursive: true });
-        writeFileSync(join(catalog, 'Contents.json'), '{}');
-        const script = await buildScript(project, { package_source: 'repo' });
-        const xcrunLog = join(project.dir, 'xcrun-invocations.log');
-        const run = runScript(project, script, {
-            FAKE_XCRUN_LOG: xcrunLog,
-            FAKE_SWIFT_MODULE_CATALOG: 'FixtureViews',
-        });
-        expect(run.status).toBe(0);
-        const calls = readFileSync(xcrunLog, 'utf-8').trim().split('\n');
-        // The module bundle's own catalog is compiled into the bundle directory.
-        const moduleCompile = calls.find((c) => c.includes('.bundle/Media.xcassets'));
-        expect(moduleCompile).toBeTruthy();
-        expect(moduleCompile).toMatch(/--compile \S+\.bundle(\s|$)/);
-    });
-    test('does not invoke actool when the package has no asset catalogs', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const script = await buildScript(project, { package_source: 'repo' });
-        const xcrunLog = join(project.dir, 'xcrun-invocations.log');
-        const run = runScript(project, script, { FAKE_XCRUN_LOG: xcrunLog });
-        expect(run.status).toBe(0);
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/HomeView.png'))).toBe(true);
-        expect(existsSync(xcrunLog)).toBe(false);
-    });
-    test('a failing asset-catalog compile warns but still renders (warn-and-continue)', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const catalog = join(project.packageDir, 'Media.xcassets');
-        mkdirSync(catalog, { recursive: true });
-        writeFileSync(join(catalog, 'Contents.json'), '{}');
-        const script = await buildScript(project, { package_source: 'repo' });
-        const run = runScript(project, script, { FAKE_ACTOOL_FAIL: '1' });
-        expect(run.status).toBe(0);
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/HomeView.png'))).toBe(true);
-        expect(run.stderr).toContain('asset-catalog compile failed');
-    });
-});
-describe('render output trimming (package_source variants)', () => {
-    // The renderer forces the view into a fixed device-sized frame, so a small
-    // component lands in a large canvas with transparent margins. After each
-    // screen renders, the trim helper crops the PNG in place to its content
-    // bounding box so the rendered artifact IS the component, tight.
-    function readArtifact(project, relative) {
-        return readFileSync(artifact(project, relative), 'utf-8');
-    }
-    test('trims the rendered PNG in place via the ci fidelity-trim helper', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const script = await buildScript(project, { package_source: 'repo' });
-        const run = runScript(project, script);
-        expect(run.status).toBe(0);
-        // The rendered file now holds the trim helper's output, not the raw render
-        // (the fake ci overwrites in place, proving the in/out in-place contract).
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/HomeView.png'))).toBe(true);
-        expect(readArtifact(project, 'ui-fidelity/rendered/HomeView.png')).toContain('trimmed:HomeView.png');
-    });
-    test('writes an aligned image and records rendered/logical/reference dimensions', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const run = runScript(project, await buildScript(project, { package_source: 'repo' }));
-        expect(run.status).toBe(0);
-        // The aligned (reference-sized) image is a separate artifact.
-        expect(isPng(artifact(project, 'ui-fidelity/aligned/HomeView.png'))).toBe(true);
-        expect(readArtifact(project, 'ui-fidelity/aligned/HomeView.png')).toContain('aligned:HomeView.png');
-        // Dimensions are explicit: rendered px from the helper, logical points
-        // derived from the scale (320/2, 640/2), reference px from the helper.
-        const screen = readResult(project).screens[0];
-        expect(screen.aligned_image_path).toBe('ui-fidelity/aligned/HomeView.png');
-        expect(screen.dimensions).toEqual({
-            rendered_px: [320, 640],
-            logical_pt: [160, 320],
-            reference_px: [160, 320],
-            // the fake helper's TRIMDIMS pre-trim source px (fields 5-6)
-            source_px: [400, 800],
-        });
-    });
-    test('logs how much margin the trim removed (source -> rendered)', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const run = runScript(project, await buildScript(project, { package_source: 'repo' }));
-        expect(run.status).toBe(0);
-        // The pre-trim source size and the trimmed size are both surfaced, so a
-        // no-op trim (an opaque-canvas wrapper) is visible in the build log.
-        expect(run.stdout).toContain('trimmed HomeView: 400x800 -> 320x640');
-    });
-    test('a failing trim warns but still renders (warn-and-continue)', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const script = await buildScript(project, { package_source: 'repo' });
-        const run = runScript(project, script, { FAKE_TRIM_FAIL: '1' });
-        // A trim failure never fails the step: the untrimmed render survives, with
-        // no aligned image and no dimensions.
-        expect(run.status).toBe(0);
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/HomeView.png'))).toBe(true);
-        const screen = readResult(project).screens[0];
-        expect(screen.status).toBe('rendered');
-        expect(screen.aligned_image_path).toBeNull();
-        expect(screen.dimensions).toBeNull();
-        expect(run.stderr).toContain('trim failed');
-    });
-    test('trims renders shipped via package_source: inputs too', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }));
-        expect(run.status).toBe(0);
-        expect(readArtifact(project, 'ui-fidelity/rendered/HomeView.png')).toContain('trimmed:HomeView.png');
-    });
-});
-describe('render script runtime (package_source: inputs)', () => {
-    test('renders every screen from a shipped archive with a single package root', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', SettingsView: 'settings.png' },
-        });
-        writeReference(project, 'home.png');
-        writeReference(project, 'settings.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const script = await buildInputsScript({ target: 'FixtureViews' });
-        const logPath = join(project.dir, 'swift-invocations.log');
-        const run = runScript(project, script, {
-            FAKE_SWIFT_LOG: logPath,
-            UI_FIDELITY_KEEP_HARNESS: '1',
-        });
-        expect(run.status).toBe(0);
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/HomeView.png'))).toBe(true);
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/SettingsView.png'))).toBe(true);
-        expect(readResult(project)).toEqual({
-            renderer: 'imagerenderer-spm',
-            package_source: 'inputs',
-            error: null,
-            screens: [
-                {
-                    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}$/),
-                    aligned_image_path: 'ui-fidelity/aligned/HomeView.png',
-                    dimensions: {
-                        rendered_px: [320, 640],
-                        logical_pt: [160, 320],
-                        reference_px: [160, 320],
-                        // the fake helper's TRIMDIMS pre-trim source px (fields 5-6)
-                        source_px: [400, 800],
-                    },
-                },
-                {
-                    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}$/),
-                    aligned_image_path: 'ui-fidelity/aligned/SettingsView.png',
-                    dimensions: {
-                        rendered_px: [320, 640],
-                        logical_pt: [160, 320],
-                        reference_px: [160, 320],
-                        // the fake helper's TRIMDIMS pre-trim source px (fields 5-6)
-                        source_px: [400, 800],
-                    },
-                },
-            ],
-        });
-        // The synthesized harness depends on the EXTRACTED package, not on any
-        // path in the repo checkout.
-        const probeArgs = readFileSync(logPath, 'utf-8').trim().split('\n')[0].split(' ');
-        const harnessDir = probeArgs[probeArgs.indexOf('--package-path') + 1];
-        tempDirs.push(harnessDir);
-        const manifest = readFileSync(join(harnessDir, 'Package.swift'), 'utf-8');
-        expect(manifest).toMatch(/\.package\(path: "[^"]*ui-fidelity-package-[^"]*\/pkg"\)/);
-        expect(manifest).toContain('.product(name: "FixtureViews", package: "pkg")');
-        const extracted = manifest.match(/\.package\(path: "([^"]*)\/pkg"\)/);
-        if (extracted)
-            tempDirs.push(extracted[1]);
-    });
-    test('accepts Package.swift at the archive root', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, shippedPackageEntries(''));
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }));
-        expect(run.status).toBe(0);
-        const result = readResult(project);
-        expect(result.error).toBeNull();
-        expect(result.screens[0].status).toBe('rendered');
-    });
-    test('ignores macOS junk entries when locating the package root', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, [
-            { name: '.DS_Store', content: 'junk' },
-            { name: '._pkg', content: 'apple-double junk' },
-            ...shippedPackageEntries('pkg'),
-        ]);
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }));
-        expect(run.status).toBe(0);
-        expect(readResult(project).screens[0].status).toBe('rendered');
-    });
-    test('discovers the target from a single library product', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const logPath = join(project.dir, 'swift-invocations.log');
-        const run = runScript(project, await buildInputsScript(), {
-            FAKE_SWIFT_LOG: logPath,
-            UI_FIDELITY_KEEP_HARNESS: '1',
-        });
-        expect(run.status).toBe(0);
-        expect(readResult(project).screens[0].status).toBe('rendered');
-        const invocations = readFileSync(logPath, 'utf-8').trim().split('\n');
-        expect(invocations[0]).toContain('dump-package');
-        const dumpArgs = invocations[0].split(' ');
-        tempDirs.push(dumpArgs[dumpArgs.indexOf('--package-path') + 1]);
-        // The discovered product is what the harness imports.
-        const probeArgs = invocations[1].split(' ');
-        const harnessDir = probeArgs[probeArgs.indexOf('--package-path') + 1];
-        tempDirs.push(harnessDir);
-        expect(readFileSync(join(harnessDir, 'Sources', 'Render_HomeView', 'Render.swift'), 'utf-8')).toContain('import FixtureViews');
-    });
-    test('an explicit target skips manifest discovery', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const logPath = join(project.dir, 'swift-invocations.log');
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }), { FAKE_SWIFT_LOG: logPath });
-        expect(run.status).toBe(0);
-        expect(readFileSync(logPath, 'utf-8')).not.toContain('dump-package');
-    });
-    test('cleans up the extraction scratch directory after rendering', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const logPath = join(project.dir, 'swift-invocations.log');
-        const run = runScript(project, await buildInputsScript(), { FAKE_SWIFT_LOG: logPath });
-        expect(run.status).toBe(0);
-        // The dump-package invocation names the extracted package root.
-        const dumpArgs = readFileSync(logPath, 'utf-8').trim().split('\n')[0].split(' ');
-        const extractedRoot = dumpArgs[dumpArgs.indexOf('--package-path') + 1];
-        expect(extractedRoot).toContain('ui-fidelity-package-');
-        expect(existsSync(extractedRoot)).toBe(false);
-    });
-    test('missing archive yields PACKAGE_ARCHIVE_MISSING with every screen entry present', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', SettingsView: 'settings.png' },
-        });
-        writeReference(project, 'home.png');
-        writeReference(project, 'settings.png');
-        const logPath = join(project.dir, 'swift-invocations.log');
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }), {
-            FAKE_SWIFT_LOG: logPath,
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.package_source).toBe('inputs');
-        expect(result.error?.code).toBe('PACKAGE_ARCHIVE_MISSING');
-        expect(result.error?.message).toContain('package.tar.gz');
-        // v1 invariant: every screen entry is present even on build-level
-        // failure, with the build error kept distinct from per-screen errors.
-        expect(result.screens).toHaveLength(2);
-        for (const screen of result.screens) {
-            expect(screen.status).toBe('render_failed');
-            expect(screen.error).toBeNull();
-            expect(screen.reference_image_path).not.toBeNull();
-            expect(screen.rendered_image_path).toBeNull();
-        }
-        // The harness never builds: swift is never invoked.
-        expect(existsSync(logPath)).toBe(false);
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('a corrupt archive yields PACKAGE_ARCHIVE_INVALID', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, Buffer.from('definitely not a gzipped tarball'));
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }));
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.error?.code).toBe('PACKAGE_ARCHIVE_INVALID');
-        expect(result.screens).toHaveLength(1);
-        expect(result.screens[0].error).toBeNull();
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('an archive with dot-dot or absolute members yields PACKAGE_ARCHIVE_INVALID', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        const script = await buildInputsScript({ target: 'FixtureViews' });
-        stageArchive(project, [
-            ...shippedPackageEntries('pkg'),
-            { name: 'pkg/../escape.swift', content: '// escape' },
-        ]);
-        let run = runScript(project, script);
-        expect(run.status).not.toBe(0);
-        let result = readResult(project);
-        expect(result.error?.code).toBe('PACKAGE_ARCHIVE_INVALID');
-        expect(result.error?.message).toContain('escape.swift');
-        stageArchive(project, [
-            ...shippedPackageEntries('pkg'),
-            { name: '/abs/escape.swift', content: '// escape' },
-        ]);
-        run = runScript(project, script);
-        expect(run.status).not.toBe(0);
-        result = readResult(project);
-        expect(result.error?.code).toBe('PACKAGE_ARCHIVE_INVALID');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('an empty archive yields PACKAGE_ARCHIVE_INVALID', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, []);
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }));
-        expect(run.status).not.toBe(0);
-        expect(readResult(project).error?.code).toBe('PACKAGE_ARCHIVE_INVALID');
-    });
-    test('multiple top-level roots yield PACKAGE_ARCHIVE_INVALID', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, [
-            ...shippedPackageEntries('pkg-one'),
-            ...shippedPackageEntries('pkg-two'),
-        ]);
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }));
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.error?.code).toBe('PACKAGE_ARCHIVE_INVALID');
-        expect(result.error?.message).toContain('pkg-one');
-        expect(result.error?.message).toContain('pkg-two');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('a single top-level file yields PACKAGE_ARCHIVE_INVALID', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, [{ name: 'HomeView.swift', content: 'import SwiftUI\n' }]);
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }));
-        expect(run.status).not.toBe(0);
-        expect(readResult(project).error?.code).toBe('PACKAGE_ARCHIVE_INVALID');
-    });
-    test('a package root without Package.swift yields PACKAGE_MANIFEST_MISSING', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        // The manifest exists, but only deeper than the single top-level root.
-        stageArchive(project, [
-            { name: 'pkg/' },
-            { name: 'pkg/Nested/Package.swift', content: SHIPPED_MANIFEST },
-            { name: 'pkg/Nested/Sources/FixtureViews/HomeView.swift', content: 'import SwiftUI\n' },
-        ]);
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }));
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.error?.code).toBe('PACKAGE_MANIFEST_MISSING');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('an extraction larger than the size bound yields PACKAGE_ARCHIVE_TOO_LARGE', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }), {
-            UI_FIDELITY_MAX_PACKAGE_BYTES: '64',
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.error?.code).toBe('PACKAGE_ARCHIVE_TOO_LARGE');
-        expect(result.error?.message).toContain('64');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('the default extraction bound is 32 MiB', async () => {
-        const script = await buildInputsScript({ target: 'FixtureViews' });
-        expect(script).toContain('32 * 1024 * 1024');
-    });
-    test('archive validation failures fail the step even with zero screens', async () => {
-        const project = makeProject({ screens: {} });
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }));
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.error?.code).toBe('PACKAGE_ARCHIVE_MISSING');
-        expect(result.screens).toEqual([]);
-    });
-    test('an empty screens object with a valid archive still exits zero', async () => {
-        const project = makeProject({ screens: {} });
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }));
-        expect(run.status).toBe(0);
-        expect(readResult(project)).toEqual({
-            renderer: 'imagerenderer-spm',
-            package_source: 'inputs',
-            error: null,
-            screens: [],
-        });
-    });
-    test('absent params.json still records the package source with empty screens', async () => {
-        const project = makeProject();
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }));
-        expect(run.status).not.toBe(0);
-        expect(readResult(project)).toEqual({
-            renderer: 'imagerenderer-spm',
-            package_source: 'inputs',
-            error: null,
-            screens: [],
-        });
-    });
-    test('zero library products yield PACKAGE_TARGET_UNRESOLVED', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const run = runScript(project, await buildInputsScript(), {
-            FAKE_SWIFT_DUMP_PRODUCTS: '',
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.error?.code).toBe('PACKAGE_TARGET_UNRESOLVED');
-        expect(result.error?.message).toContain('no library products');
-    });
-    test('multiple library products yield PACKAGE_TARGET_UNRESOLVED naming the candidates', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const run = runScript(project, await buildInputsScript(), {
-            FAKE_SWIFT_DUMP_PRODUCTS: 'AlphaViews,BetaViews',
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.error?.code).toBe('PACKAGE_TARGET_UNRESOLVED');
-        expect(result.error?.message).toContain('AlphaViews');
-        expect(result.error?.message).toContain('BetaViews');
-    });
-    test('a failing dump-package yields PACKAGE_TARGET_UNRESOLVED', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const run = runScript(project, await buildInputsScript(), {
-            FAKE_SWIFT_DUMP_FAIL: '1',
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.error?.code).toBe('PACKAGE_TARGET_UNRESOLVED');
-        expect(result.error?.message).toContain('malformed Package.swift manifest');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('a discovered product that is not a Swift identifier yields PACKAGE_TARGET_UNRESOLVED', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const run = runScript(project, await buildInputsScript(), {
-            FAKE_SWIFT_DUMP_PRODUCTS: 'My-Views',
-        });
-        expect(run.status).not.toBe(0);
-        expect(readResult(project).error?.code).toBe('PACKAGE_TARGET_UNRESOLVED');
-    });
-    test('a broken screen fails alone in inputs mode', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', MissingView: 'missing-view.png' },
-        });
-        writeReference(project, 'home.png');
-        writeReference(project, 'missing-view.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }), {
-            FAKE_SWIFT_COMPILE_FAIL: 'MissingView',
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        // Per-screen isolation is unchanged: the break is per-screen, the
-        // build-level error stays null.
-        expect(result.error).toBeNull();
-        const [home, missing] = result.screens;
-        expect(home.status).toBe('rendered');
-        expect(isPng(artifact(project, 'ui-fidelity/rendered/HomeView.png'))).toBe(true);
-        expect(missing.status).toBe('render_failed');
-        expect(missing.error?.code).toBe('VIEW_COMPILE_FAILED');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-    test('a shipped package that does not build for macOS is sanitized to <package>', async () => {
-        const project = makeProject({ screens: { HomeView: 'home.png' } });
-        writeReference(project, 'home.png');
-        stageArchive(project, shippedPackageEntries('pkg'));
-        const run = runScript(project, await buildInputsScript({ target: 'FixtureViews' }), {
-            FAKE_SWIFT_PROBE_FAIL: '1',
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        expect(result.error).toBeNull();
-        expect(result.screens[0].error?.code).toBe('RENDER_UNSUPPORTED');
-        expect(result.screens[0].error?.message).toContain('<package>/pkg');
-        expectNoAbsolutePathLeaks(project, result);
-    });
-});
-describe('committed fixture package', () => {
-    test('declares the FixtureViews library with the screens the example pipeline uses', () => {
-        const manifest = readFileSync(join(FIXTURE_PACKAGE, 'Package.swift'), 'utf-8');
-        expect(manifest).toContain('name: "ui-fidelity-package"');
-        expect(manifest).toContain('.library(name: "FixtureViews", targets: ["FixtureViews"])');
-        expect(manifest).toContain('.macOS(.v13)');
-        const sourcesDir = join(FIXTURE_PACKAGE, 'Sources', 'FixtureViews');
-        const home = readFileSync(join(sourcesDir, 'HomeView.swift'), 'utf-8');
-        expect(home).toContain('public struct HomeView: View');
-        expect(home).toContain('public init()');
-        const settings = readFileSync(join(sourcesDir, 'SettingsView.swift'), 'utf-8');
-        expect(settings).toContain('public struct SettingsView: View');
-        // BrokenView exists to prove per-screen isolation: its parameterless
-        // init is deliberately unavailable, so its harness target cannot compile.
-        const broken = readFileSync(join(sourcesDir, 'BrokenView.swift'), 'utf-8');
-        expect(broken).toContain('public struct BrokenView: View');
-        expect(broken).toContain('@available(*, unavailable');
-    });
-    test('wires through the harness as package_path (fake toolchain)', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', SettingsView: 'settings.png' },
-        });
-        writeReference(project, 'home.png');
-        writeReference(project, 'settings.png');
-        const script = await buildScript(project, { package_path: FIXTURE_PACKAGE });
-        const logPath = join(project.dir, 'swift-invocations.log');
-        const run = runScript(project, script, {
-            FAKE_SWIFT_LOG: logPath,
-            UI_FIDELITY_KEEP_HARNESS: '1',
-        });
-        expect(run.status).toBe(0);
-        const result = readResult(project);
-        expect(result.screens.map((s) => s.status)).toEqual(['rendered', 'rendered']);
-        // The synthesized harness depends on the real fixture package on disk.
-        const probeArgs = readFileSync(logPath, 'utf-8').trim().split('\n')[0].split(' ');
-        const harnessDir = probeArgs[probeArgs.indexOf('--package-path') + 1];
-        tempDirs.push(harnessDir);
-        const manifest = readFileSync(join(harnessDir, 'Package.swift'), 'utf-8');
-        expect(manifest).toContain('.package(path: "' + FIXTURE_PACKAGE + '")');
-        expect(manifest).toContain('.product(name: "FixtureViews", package: "ui-fidelity-package")');
-    });
-    // Opt-in: builds the fixture with the real Swift toolchain and renders
-    // through ImageRenderer. Requires macOS with Xcode; takes a SwiftPM
-    // build, so it is skipped unless explicitly requested.
-    const realSwiftTest = process.env.CIBUILD_UI_FIDELITY_REAL_SWIFT === '1' ? test : test.skip;
-    realSwiftTest('real toolchain: renders HomeView and isolates BrokenView with sanitized diagnostics', async () => {
-        const project = makeProject({
-            screens: { HomeView: 'home.png', BrokenView: 'broken.png' },
-        });
-        writeReference(project, 'home.png');
-        writeReference(project, 'broken.png');
-        const script = await buildScript(project, { package_path: FIXTURE_PACKAGE });
-        // No PATH shim: the real `swift` binary does the work.
-        const run = spawnSync('node', ['-e', script], {
-            cwd: project.dir,
-            encoding: 'utf-8',
-            maxBuffer: 32 * 1024 * 1024,
-        });
-        expect(run.status).not.toBe(0);
-        const result = readResult(project);
-        const [home, broken] = result.screens;
-        expect(home.status).toBe('rendered');
-        expect(home.error).toBeNull();
-        const rendered = artifact(project, 'ui-fidelity/rendered/HomeView.png');
-        expect(isPng(rendered)).toBe(true);
-        expect(readFileSync(rendered).length).toBeGreaterThan(1000);
-        expect(broken.status).toBe('render_failed');
-        expect(broken.error?.code).toBe('VIEW_COMPILE_FAILED');
-        expect(broken.error?.message).toContain('BrokenView');
-        expect(broken.rendered_image_path).toBeNull();
-        // Real compiler diagnostics reference the harness temp dir; none of
-        // those absolute paths may reach the result document.
-        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');
-    });
-});
-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