@invarn/cibuild 2.9.4 → 2.9.7

package/dist/src/yaml/fidelity-manifest.js

@@ -1,134 +0,0 @@
-/**
- * Multi-state UI-fidelity manifest parser/validator.
- *
- * The manifest lives at the app-repo root as `.invarn/fidelity.yml` and is the
- * single seam the android-ui-fidelity skill and any orchestrator share. It
- * declares each **Surface** (one app screen) and that surface's first-class
- * **States** (guest vs logged-in; empty vs progress vs complete). Each State is
- * one named proof composable paired with one **Reference**, and the Reference
- * carries export-time **provenance** so the gate can assert validity by
- * metadata rather than by reading pixels.
- *
- * This module owns the schema (the TypeScript types below) and a validator that
- * rejects malformed entries with a clear, distinct message — the shared
- * contract the reference-provenance (UNVERIFIABLE) and baseline-filter slices
- * key on.
- */
-import * as yaml from 'js-yaml';
-import { readFileSync, existsSync } from 'fs';
-/** Thrown when a manifest is absent, unparseable, or schema-invalid. */
-export class FidelityManifestError extends Error {
-    filePath;
-    constructor(message, filePath) {
-        super(message);
-        this.filePath = filePath;
-        this.name = 'FidelityManifestError';
-    }
-}
-/** Reads and parses a manifest from disk. */
-export function loadFidelityManifest(filePath) {
-    if (!existsSync(filePath)) {
-        throw new FidelityManifestError(`Fidelity manifest not found: ${filePath}`, filePath);
-    }
-    return parseFidelityManifest(readFileSync(filePath, 'utf-8'), filePath);
-}
-/** Parses and validates manifest YAML text. */
-export function parseFidelityManifest(text, filePath) {
-    let doc;
-    try {
-        doc = yaml.load(text);
-    }
-    catch (err) {
-        throw new FidelityManifestError(`Invalid YAML in fidelity manifest: ${err.message}`, filePath);
-    }
-    const root = doc;
-    const surfaces = root.surfaces ?? [];
-    validateSurfaces(surfaces, filePath);
-    return {
-        version: Number(root.version),
-        surfaces,
-    };
-}
-/** The provenance fields every Reference must carry to be verifiable. */
-const REQUIRED_PROVENANCE_FIELDS = [
-    'figmaNode',
-    'locale',
-    'resolved',
-    'exportedAt',
-];
-function validateSurfaces(surfaces, filePath) {
-    for (const surface of surfaces) {
-        const seenStateNames = new Set();
-        for (const state of surface.states ?? []) {
-            if (seenStateNames.has(state.name)) {
-                throw new FidelityManifestError(`surface "${surface.name}": duplicate state name "${state.name}" — state names must be unique within a surface.`, filePath);
-            }
-            seenStateNames.add(state.name);
-            const where = `surface "${surface.name}" state "${state.name}"`;
-            const provenance = state.reference?.provenance;
-            for (const field of REQUIRED_PROVENANCE_FIELDS) {
-                if (provenance == null || provenance[field] === undefined) {
-                    throw new FidelityManifestError(`${where}: reference provenance is missing required field "${field}".`, filePath);
-                }
-            }
-            for (const entry of state.accepted ?? []) {
-                if (entry.actual === undefined ||
-                    entry.actual === null ||
-                    entry.actual === '') {
-                    throw new FidelityManifestError(`${where}: accepted[] entry for element "${entry.element}" is missing a pinned "actual" value.`, filePath);
-                }
-            }
-        }
-    }
-}
-/** POSIX basename of a repo-relative path (manifest paths are POSIX). */
-function posixBasename(p) {
-    const parts = p.split('/');
-    return parts[parts.length - 1];
-}
-/**
- * Build the per-dispatch inputs for one surface: one run carries all of the
- * surface's states, each paired with its own reference and provenance. The
- * render locale defaults to the references' shared locale (they must agree);
- * pass `renderLocale` to override (a deliberate mismatch then surfaces as
- * UNVERIFIABLE at the gate). Reference basenames must be unique, since the
- * upload layer addresses files by basename.
- */
-export function buildSurfaceDispatchInputs(surface, opts = {}) {
-    const screens = {};
-    const provenance = {};
-    const references = [];
-    const accepted = {};
-    const basenameToPath = new Map();
-    for (const state of surface.states ?? []) {
-        const path = state.reference.path;
-        const base = posixBasename(path);
-        const existing = basenameToPath.get(base);
-        if (existing !== undefined && existing !== path) {
-            throw new FidelityManifestError(`surface "${surface.name}": states resolve to the same reference basename "${base}" ` +
-                `(${existing} vs ${path}); references are uploaded by basename, so they must be unique.`);
-        }
-        basenameToPath.set(base, path);
-        screens[state.proof] = base;
-        provenance[state.proof] = state.reference.provenance;
-        references.push({ proof: state.proof, path });
-        if (state.accepted && state.accepted.length > 0) {
-            accepted[state.proof] = state.accepted;
-        }
-    }
-    const renderLocale = opts.renderLocale ?? deriveRenderLocale(surface);
-    return { screens, render_locale: renderLocale, provenance, references, accepted };
-}
-/**
- * The render locale a surface's references share. Throws when they disagree and
- * no explicit locale was given — a coherent surface renders in one locale.
- */
-function deriveRenderLocale(surface) {
-    const locales = new Set((surface.states ?? []).map((s) => s.reference.provenance.locale));
-    if (locales.size > 1) {
-        throw new FidelityManifestError(`surface "${surface.name}": references span multiple locales ` +
-            `(${[...locales].join(', ')}); pass an explicit renderLocale to disambiguate.`);
-    }
-    return locales.values().next().value ?? '';
-}
-//# sourceMappingURL=fidelity-manifest.js.map

package/dist/src/yaml/fidelity-manifest.test.d.ts

@@ -1,12 +0,0 @@
-/**
- * Unit tests for the multi-state UI-fidelity manifest parser/validator.
- *
- * The manifest (`.invarn/fidelity.yml`) declares each Surface's States
- * first-class: one named proof composable per State, each paired with its own
- * Reference (carrying export-time provenance), plus a per-State `accepted[]`
- * baseline of allowlisted divergences. These tests pin the schema and the
- * validator's distinct rejections; fixtures are written to a temp dir and
- * loaded by path, mirroring the YAML pipeline parser tests.
- */
-export {};
-//# sourceMappingURL=fidelity-manifest.test.d.ts.map

package/dist/src/yaml/fidelity-manifest.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fidelity-manifest.test.d.ts","sourceRoot":"","sources":["../../../src/yaml/fidelity-manifest.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/src/yaml/fidelity-manifest.test.js

@@ -1,251 +0,0 @@
-/**
- * Unit tests for the multi-state UI-fidelity manifest parser/validator.
- *
- * The manifest (`.invarn/fidelity.yml`) declares each Surface's States
- * first-class: one named proof composable per State, each paired with its own
- * Reference (carrying export-time provenance), plus a per-State `accepted[]`
- * baseline of allowlisted divergences. These tests pin the schema and the
- * validator's distinct rejections; fixtures are written to a temp dir and
- * loaded by path, mirroring the YAML pipeline parser tests.
- */
-import { describe, test, expect, beforeEach, afterEach } from '@jest/globals';
-import { writeFileSync, mkdtempSync, rmSync } from 'fs';
-import { tmpdir } from 'os';
-import { join } from 'path';
-import { loadFidelityManifest, parseFidelityManifest, buildSurfaceDispatchInputs, FidelityManifestError, } from './fidelity-manifest.js';
-describe('fidelity manifest — parser/validator', () => {
-    let workDir;
-    beforeEach(() => {
-        workDir = mkdtempSync(join(tmpdir(), 'cibuild-fidelity-manifest-'));
-    });
-    afterEach(() => {
-        rmSync(workDir, { recursive: true, force: true });
-    });
-    function writeManifest(content) {
-        const path = join(workDir, 'fidelity.yml');
-        writeFileSync(path, content, 'utf-8');
-        return path;
-    }
-    // A well-formed two-state surface modelling the canonical promo banner
-    // (guest + logged-in), with provenance on each reference and one accepted
-    // baseline entry on the logged-in state.
-    const TWO_STATE_BANNER = `version: 1
-surfaces:
-  - name: PromoBanner
-    platform: android
-    module: fidelity/promo-banner
-    source:
-      - feature/hub/**/PromoBanner.kt
-    touchedBy:
-      - feature/hub/**/PromoBanner*.kt
-    states:
-      - name: Guest
-        proof: PromoBannerGuestProof
-        reference:
-          path: fidelity/refs/promo_banner_guest.png
-          provenance:
-            figmaNode: "12:345"
-            locale: en
-            resolved: true
-            exportedAt: "2026-06-18T10:00:00Z"
-      - name: LoggedIn
-        proof: PromoBannerLoggedInProof
-        reference:
-          path: fidelity/refs/promo_banner_logged_in.png
-          provenance:
-            figmaNode: "12:346"
-            locale: en
-            resolved: true
-            exportedAt: "2026-06-18T10:00:00Z"
-        accepted:
-          - category: copy
-            element: banner_subtitle
-            expected: "Get 5 off when you spend 20,00"
-            actual: "Get 5 off your first order placed by {date}"
-`;
-    test('parses a well-formed two-state surface into addressable states', () => {
-        const manifest = loadFidelityManifest(writeManifest(TWO_STATE_BANNER));
-        expect(manifest.version).toBe(1);
-        expect(manifest.surfaces).toHaveLength(1);
-        const surface = manifest.surfaces[0];
-        expect(surface.name).toBe('PromoBanner');
-        expect(surface.platform).toBe('android');
-        expect(surface.states.map((s) => s.name)).toEqual(['Guest', 'LoggedIn']);
-        const [guest, loggedIn] = surface.states;
-        expect(guest.proof).toBe('PromoBannerGuestProof');
-        expect(guest.reference.path).toBe('fidelity/refs/promo_banner_guest.png');
-        expect(guest.reference.provenance).toEqual({
-            figmaNode: '12:345',
-            locale: 'en',
-            resolved: true,
-            exportedAt: '2026-06-18T10:00:00Z',
-        });
-        expect(loggedIn.proof).toBe('PromoBannerLoggedInProof');
-        expect(loggedIn.accepted).toEqual([
-            {
-                category: 'copy',
-                element: 'banner_subtitle',
-                expected: 'Get 5 off when you spend 20,00',
-                actual: 'Get 5 off your first order placed by {date}',
-            },
-        ]);
-    });
-    test('rejects a reference missing a provenance field', () => {
-        // `exportedAt` omitted from the guest reference's provenance.
-        const yaml = `version: 1
-surfaces:
-  - name: PromoBanner
-    platform: android
-    states:
-      - name: Guest
-        proof: PromoBannerGuestProof
-        reference:
-          path: fidelity/refs/promo_banner_guest.png
-          provenance:
-            figmaNode: "12:345"
-            locale: en
-            resolved: true
-`;
-        expect(() => loadFidelityManifest(writeManifest(yaml))).toThrow(FidelityManifestError);
-        expect(() => loadFidelityManifest(writeManifest(yaml))).toThrow(/provenance.*exportedAt|exportedAt.*provenance/i);
-    });
-    test('rejects an accepted[] entry with no pinned actual', () => {
-        // The baseline entry omits `actual` — it cannot pin the render value, so a
-        // changed value could never re-flag. Reject loud.
-        const yaml = `version: 1
-surfaces:
-  - name: PromoBanner
-    platform: android
-    states:
-      - name: LoggedIn
-        proof: PromoBannerLoggedInProof
-        reference:
-          path: fidelity/refs/promo_banner_logged_in.png
-          provenance:
-            figmaNode: "12:346"
-            locale: en
-            resolved: true
-            exportedAt: "2026-06-18T10:00:00Z"
-        accepted:
-          - category: copy
-            element: banner_subtitle
-            expected: "Get 5 off when you spend 20,00"
-`;
-        expect(() => loadFidelityManifest(writeManifest(yaml))).toThrow(FidelityManifestError);
-        expect(() => loadFidelityManifest(writeManifest(yaml))).toThrow(/accepted.*actual|actual/i);
-    });
-    test('rejects duplicate state names within a surface', () => {
-        // Two states both named "Guest" — their proofs would collide on one
-        // params.screens key.
-        const yaml = `version: 1
-surfaces:
-  - name: PromoBanner
-    platform: android
-    states:
-      - name: Guest
-        proof: PromoBannerGuestProof
-        reference:
-          path: fidelity/refs/promo_banner_guest.png
-          provenance:
-            figmaNode: "12:345"
-            locale: en
-            resolved: true
-            exportedAt: "2026-06-18T10:00:00Z"
-      - name: Guest
-        proof: PromoBannerGuestAltProof
-        reference:
-          path: fidelity/refs/promo_banner_guest_alt.png
-          provenance:
-            figmaNode: "12:347"
-            locale: en
-            resolved: true
-            exportedAt: "2026-06-18T10:00:00Z"
-`;
-        expect(() => loadFidelityManifest(writeManifest(yaml))).toThrow(FidelityManifestError);
-        expect(() => loadFidelityManifest(writeManifest(yaml))).toThrow(/duplicate state.*Guest|state name "Guest"/i);
-    });
-});
-describe('buildSurfaceDispatchInputs', () => {
-    const BANNER = `version: 1
-surfaces:
-  - name: PromoBanner
-    platform: android
-    module: fidelity/promo-banner
-    states:
-      - name: Guest
-        proof: PromoBannerGuestProof
-        reference:
-          path: fidelity/refs/promo_banner_guest.png
-          provenance:
-            figmaNode: "12:345"
-            locale: en
-            resolved: true
-            exportedAt: "2026-06-18T10:00:00Z"
-      - name: LoggedIn
-        proof: PromoBannerLoggedInProof
-        reference:
-          path: fidelity/refs/promo_banner_logged_in.png
-          provenance:
-            figmaNode: "12:346"
-            locale: en
-            resolved: true
-            exportedAt: "2026-06-18T10:00:00Z"
-        accepted:
-          - category: copy
-            element: banner_subtitle
-            expected: "A"
-            actual: "B"
-`;
-    function bannerSurface(extra = '') {
-        return parseFidelityManifest(BANNER + extra).surfaces[0];
-    }
-    test('maps each state proof to its reference basename in screens', () => {
-        const inputs = buildSurfaceDispatchInputs(bannerSurface());
-        expect(inputs.screens).toEqual({
-            PromoBannerGuestProof: 'promo_banner_guest.png',
-            PromoBannerLoggedInProof: 'promo_banner_logged_in.png',
-        });
-    });
-    test('keys provenance by proof and derives the render locale from the references', () => {
-        const inputs = buildSurfaceDispatchInputs(bannerSurface());
-        expect(inputs.render_locale).toBe('en');
-        expect(inputs.provenance.PromoBannerGuestProof).toEqual({
-            figmaNode: '12:345',
-            locale: 'en',
-            resolved: true,
-            exportedAt: '2026-06-18T10:00:00Z',
-        });
-    });
-    test('lists the reference files to upload, one per state, by repo path', () => {
-        const inputs = buildSurfaceDispatchInputs(bannerSurface());
-        expect(inputs.references).toEqual([
-            { proof: 'PromoBannerGuestProof', path: 'fidelity/refs/promo_banner_guest.png' },
-            { proof: 'PromoBannerLoggedInProof', path: 'fidelity/refs/promo_banner_logged_in.png' },
-        ]);
-    });
-    test('carries each state baseline keyed by proof for the post-judgment filter', () => {
-        const inputs = buildSurfaceDispatchInputs(bannerSurface());
-        expect(inputs.accepted.PromoBannerLoggedInProof).toEqual([
-            { category: 'copy', element: 'banner_subtitle', expected: 'A', actual: 'B' },
-        ]);
-        // States with no accepted[] don't appear.
-        expect(inputs.accepted.PromoBannerGuestProof).toBeUndefined();
-    });
-    test('honours an explicit render locale override', () => {
-        const inputs = buildSurfaceDispatchInputs(bannerSurface(), { renderLocale: 'it' });
-        expect(inputs.render_locale).toBe('it');
-    });
-    test('throws when references disagree on locale and none is given', () => {
-        // Flip the logged-in reference to Italian.
-        const surface = bannerSurface();
-        surface.states[1].reference.provenance.locale = 'it';
-        expect(() => buildSurfaceDispatchInputs(surface)).toThrow(/locale/i);
-    });
-    test('throws when two states resolve to the same reference basename', () => {
-        const surface = bannerSurface();
-        // Same basename, different dirs → upload-layer collision.
-        surface.states[1].reference.path = 'other/promo_banner_guest.png';
-        expect(() => buildSurfaceDispatchInputs(surface)).toThrow(/basename/i);
-    });
-});
-//# sourceMappingURL=fidelity-manifest.test.js.map

package/dist/src/yaml/interactive-prompts.d.ts

@@ -1,71 +0,0 @@
-/**
- * Interactive prompts for missing environment variables
- * Allows users to fill in missing values or cancel the build
- */
-import { SecretsManager } from './secrets-manager.js';
-/**
- * Result of prompting for a missing environment variable
- */
-export interface PromptResult {
-    value: string;
-    cancelled: boolean;
-    copiedToAI?: boolean;
-}
-/**
- * Interactive prompt manager for collecting missing environment variables
- */
-export declare class InteractivePrompts {
-    private secretsManager;
-    private workflow?;
-    constructor(secretsManager: SecretsManager, workflow?: string);
-    /**
-     * Prompt user for a missing environment variable
-     * @param varName Variable name
-     * @param stepName Optional step name that requires this variable
-     * @param hint Optional hint describing what the variable is for and expected format
-     * @returns Promise with the entered value or cancellation
-     */
-    promptForVariable(varName: string, stepName?: string, hint?: string): Promise<PromptResult>;
-    /**
-     * Determine if a variable name suggests it's sensitive
-     * @param varName Variable name
-     * @returns True if variable appears to be sensitive
-     */
-    private isSensitiveVariable;
-    /**
-     * Prompt for yes/no confirmation
-     * @param message Prompt message
-     * @returns Promise with true for yes, false for no
-     */
-    private promptYesNo;
-    /**
-     * Process hint text to preserve formatting while wrapping plain text
-     * @param hint Hint text (may contain newlines and formatted sections)
-     * @param maxWidth Maximum width for wrapping plain text lines
-     * @returns Array of processed lines ready for display
-     */
-    private processHintText;
-    /**
-     * Wrap text to fit within a specified width
-     * @param text Text to wrap
-     * @param maxWidth Maximum width per line
-     * @returns Array of wrapped lines
-     */
-    private wrapText;
-    /**
-     * Generate AI prompt with hint for getting guidance
-     * @param hint Hint text from the step
-     * @returns Formatted AI prompt
-     */
-    private generateAIPrompt;
-    /**
-     * Copy text to system clipboard
-     * @param text Text to copy
-     */
-    private copyToClipboard;
-    /**
-     * Close the prompts interface (no-op with prompts library)
-     */
-    close(): void;
-}
-//# sourceMappingURL=interactive-prompts.d.ts.map

package/dist/src/yaml/interactive-prompts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"interactive-prompts.d.ts","sourceRoot":"","sources":["../../../src/yaml/interactive-prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEd,cAAc,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM;IAK7D;;;;;;OAMG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;IA4FxB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;;;OAIG;YACW,WAAW;IAWzB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IA0BvB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAyBhB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;OAGG;YACW,eAAe;IAqC7B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}