@invariant-ai/cli 0.1.0

package/dist/lib/sync.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncRun = syncRun;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const api_client_js_1 = require("./api-client.js");
+function collectImageKeys(runDir, relativeDir = '') {
+    const currentDir = relativeDir ? (0, path_1.join)(runDir, relativeDir) : runDir;
+    const keys = [];
+    try {
+        const entries = (0, fs_1.readdirSync)(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const relativePath = relativeDir
+                ? `${relativeDir}/${entry.name}`
+                : entry.name;
+            if (entry.isDirectory()) {
+                keys.push(...collectImageKeys(runDir, relativePath));
+                continue;
+            }
+            const ext = (0, path_1.extname)(entry.name).toLowerCase();
+            if (ext === '.png' || ext === '.jpg' || ext === '.jpeg' || ext === '.webp') {
+                keys.push(relativePath);
+            }
+        }
+    }
+    catch {
+        // Best-effort collection; ignore unreadable folders/files
+    }
+    return keys;
+}
+/**
+ * Sync a single run to the cloud.
+ * Returns true if successful, false if skipped.
+ */
+async function syncRun(token, projectId, runDir, localRunId) {
+    // Read the proof report
+    const reportPath = (0, path_1.join)(runDir, 'proof-report.json');
+    if (!(0, fs_1.existsSync)(reportPath))
+        return false;
+    const report = JSON.parse((0, fs_1.readFileSync)(reportPath, 'utf-8'));
+    // Collect image artifacts from run dir recursively.
+    // This captures root files plus nested folders such as visual/, visual/diffs/, artifacts/, etc.
+    const screenshotKeys = Array.from(new Set(collectImageKeys(runDir)));
+    // Determine run status from report
+    const status = report.passed
+        ? (report.visualRegression?.hasChanges || report.visual?.hasChanges ? 'warn' : 'pass')
+        : 'fail';
+    // Upload the run
+    const response = await (0, api_client_js_1.uploadRun)(token, {
+        project_id: projectId,
+        local_run_id: localRunId,
+        timestamp: report.timestamp || localRunId,
+        status,
+        duration: report.duration || null,
+        report,
+        screenshot_keys: screenshotKeys,
+    });
+    if (!response.ok)
+        return false;
+    // Upload screenshots to presigned URLs
+    const uploadUrls = response.data.upload_urls || {};
+    for (const [key, url] of Object.entries(uploadUrls)) {
+        const filePath = (0, path_1.join)(runDir, key);
+        if (!(0, fs_1.existsSync)(filePath))
+            continue;
+        const buffer = (0, fs_1.readFileSync)(filePath);
+        // Retry up to 3 times
+        for (let attempt = 0; attempt < 3; attempt++) {
+            const ok = await (0, api_client_js_1.uploadScreenshot)(url, buffer);
+            if (ok)
+                break;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=sync.js.map

package/dist/lib/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/lib/sync.ts"],"names":[],"mappings":"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"}

package/dist/lib/templates.d.ts

@@ -0,0 +1,23 @@
+import { ProjectInfo } from './detect.js';
+/**
+ * Generate playwright.config.ts content based on project info
+ */
+export declare function getPlaywrightConfig(project: ProjectInfo): string;
+/**
+ * Generate sample test file content
+ */
+export declare function getSampleTest(project: ProjectInfo): string;
+/**
+ * Generate Claude Code hooks configuration
+ * NOTE: Hooks track edits only - tests run on-demand via `invariant run`
+ *
+ * Schema requires:
+ * - matcher: string (tool name like "Edit" or "Write")
+ * - async: true (for background execution, not run_in_background)
+ */
+export declare function getClaudeHooksConfig(project: ProjectInfo): any;
+/**
+ * Generate Invariant config file
+ */
+export declare function getInvariantConfig(project: ProjectInfo): any;
+//# sourceMappingURL=templates.d.ts.map

package/dist/lib/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA+EhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAoD1D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,GAAG,CA8B9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,GAAG,CAgB5D"}

package/dist/lib/templates.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPlaywrightConfig = getPlaywrightConfig;
+exports.getSampleTest = getSampleTest;
+exports.getClaudeHooksConfig = getClaudeHooksConfig;
+exports.getInvariantConfig = getInvariantConfig;
+/**
+ * Generate playwright.config.ts content based on project info
+ */
+function getPlaywrightConfig(project) {
+    const baseUrl = project.frameworks.includes('Next.js')
+        ? 'http://localhost:3000'
+        : 'http://localhost:3000';
+    const webServerCommand = project.frameworks.includes('Next.js')
+        ? 'npm run dev'
+        : 'npm start';
+    return `import { defineConfig, devices } from '@playwright/test';
+
+/**
+ * Playwright Configuration
+ * Generated by Invariant - https://invariant.ai
+ *
+ * Artifact capture settings:
+ * - Screenshots: Always captured (for proof)
+ * - Videos: Captured on failure
+ * - Traces: Captured on failure (for debugging)
+ */
+
+export default defineConfig({
+  // Test directory
+  testDir: './tests/e2e',
+
+  // Output directory for artifacts
+  outputDir: './test-results',
+
+  // Run tests in parallel
+  fullyParallel: true,
+
+  // Fail the build on CI if test.only is left in code
+  forbidOnly: !!process.env.CI,
+
+  // Retry on CI only
+  retries: process.env.CI ? 2 : 0,
+
+  // Workers
+  workers: process.env.CI ? 1 : undefined,
+
+  // Reporter configuration
+  reporter: [
+    ['list'],
+    ['html', { outputFolder: './playwright-report', open: 'never' }],
+    ['json', { outputFile: './test-results/report.json' }]
+  ],
+
+  // Shared settings for all projects
+  use: {
+    // Base URL
+    baseURL: '${baseUrl}',
+
+    // ARTIFACT CAPTURE (key for Invariant proof)
+    screenshot: 'on',           // Always capture screenshots
+    video: 'retain-on-failure', // Video on failure
+    trace: 'retain-on-failure', // Trace on failure
+
+    // Timeouts
+    actionTimeout: 10000,
+    navigationTimeout: 30000,
+  },
+
+  // Browser projects
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+  ],
+
+  // Web server configuration
+  webServer: {
+    command: '${webServerCommand}',
+    url: '${baseUrl}',
+    reuseExistingServer: true,
+    timeout: 120000,
+  },
+});
+`;
+}
+/**
+ * Generate sample test file content
+ */
+function getSampleTest(project) {
+    return `import { test, expect } from '@invariant-ai/cli/visual';
+
+/**
+ * Sample E2E Test
+ * Generated by Invariant
+ *
+ * This is a starter test. Replace it with tests for your actual features.
+ *
+ * How to write tests for Invariant:
+ * 1. Tell your AI agent what feature you want
+ * 2. Ask it to write a test that verifies the feature works
+ * 3. Ask it to implement the feature
+ * 4. Invariant will run the test and capture proof
+ */
+
+test.describe('Application', () => {
+  test('homepage loads successfully', async ({ page }) => {
+    // Navigate to the homepage
+    await page.goto('/');
+
+    // Verify the page loaded (customize this for your app)
+    await expect(page).toHaveTitle(/.+/);
+
+    // Screenshot is captured automatically by Invariant
+  });
+
+  test('can navigate the application', async ({ page }) => {
+    // Navigate to homepage
+    await page.goto('/');
+
+    // Wait for the page to be interactive
+    await page.waitForLoadState('networkidle');
+
+    // Verify page has content
+    const body = page.locator('body');
+    await expect(body).toBeVisible();
+  });
+});
+
+/**
+ * Example: How to test a specific feature
+ *
+ * test('user can submit contact form', async ({ page }) => {
+ *   await page.goto('/contact');
+ *   await page.fill('input[name="email"]', 'test@example.com');
+ *   await page.fill('textarea[name="message"]', 'Hello!');
+ *   await page.click('button[type="submit"]');
+ *   await expect(page.locator('.success-message')).toBeVisible();
+ * });
+ */
+`;
+}
+/**
+ * Generate Claude Code hooks configuration
+ * NOTE: Hooks track edits only - tests run on-demand via `invariant run`
+ *
+ * Schema requires:
+ * - matcher: string (tool name like "Edit" or "Write")
+ * - async: true (for background execution, not run_in_background)
+ */
+function getClaudeHooksConfig(project) {
+    // Track command is lightweight - just logs the edit
+    const trackCommand = project.frontendPath
+        ? `cd ${project.frontendPath} && npx invariant track`
+        : 'npx invariant track';
+    return {
+        PostToolUse: [
+            {
+                matcher: 'Edit',
+                hooks: [
+                    {
+                        type: 'command',
+                        command: trackCommand,
+                        async: true
+                    }
+                ]
+            },
+            {
+                matcher: 'Write',
+                hooks: [
+                    {
+                        type: 'command',
+                        command: trackCommand,
+                        async: true
+                    }
+                ]
+            }
+        ]
+    };
+}
+/**
+ * Generate Invariant config file
+ */
+function getInvariantConfig(project) {
+    return {
+        version: '0.1.0',
+        project: {
+            type: project.type,
+            frameworks: project.frameworks,
+            frontendPath: project.frontendPath,
+            backendPath: project.backendPath
+        },
+        settings: {
+            autoRun: true,
+            captureScreenshots: true,
+            captureVideosOnFailure: true,
+            captureTracesOnFailure: true
+        }
+    };
+}
+//# sourceMappingURL=templates.js.map

package/dist/lib/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":";;AAKA,kDA+EC;AAKD,sCAoDC;AAUD,oDA8BC;AAKD,gDAgBC;AAxMD;;GAEG;AACH,SAAgB,mBAAmB,CAAC,OAAoB;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QACpD,CAAC,CAAC,uBAAuB;QACzB,CAAC,CAAC,uBAAuB,CAAC;IAE5B,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC7D,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,WAAW,CAAC;IAEhB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAyCO,OAAO;;;;;;;;;;;;;;;;;;;;;;gBAsBP,gBAAgB;YACpB,OAAO;;;;;CAKlB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,OAAoB;IAChD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDR,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAAC,OAAoB;IACvD,oDAAoD;IACpD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY;QACvC,CAAC,CAAC,MAAM,OAAO,CAAC,YAAY,yBAAyB;QACrD,CAAC,CAAC,qBAAqB,CAAC;IAE1B,OAAO;QACL,WAAW,EAAE;YACX;gBACE,OAAO,EAAE,MAAM;gBACf,KAAK,EAAE;oBACL;wBACE,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,YAAY;wBACrB,KAAK,EAAE,IAAI;qBACZ;iBACF;aACF;YACD;gBACE,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE;oBACL;wBACE,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,YAAY;wBACrB,KAAK,EAAE,IAAI;qBACZ;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,OAAoB;IACrD,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE;YACP,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,IAAI;YACb,kBAAkB,EAAE,IAAI;YACxB,sBAAsB,EAAE,IAAI;YAC5B,sBAAsB,EAAE,IAAI;SAC7B;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/visual-diff.d.ts

@@ -0,0 +1,9 @@
+import { VisualResult } from './visual.js';
+/**
+ * Process visual regression for a completed test run.
+ *
+ * This is the main entry point called from run.ts after E2E tests complete.
+ * All paths in the returned VisualResult.changes are relative to runDir.
+ */
+export declare function processVisualRegression(projectDir: string, runDir: string): VisualResult;
+//# sourceMappingURL=visual-diff.d.ts.map

package/dist/lib/visual-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-diff.d.ts","sourceRoot":"","sources":["../../src/lib/visual-diff.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,YAAY,EAUb,MAAM,aAAa,CAAC;AA+GrB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAqOxF"}

package/dist/lib/visual-diff.js

@@ -0,0 +1,301 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processVisualRegression = processVisualRegression;
+const pixelmatch_1 = __importDefault(require("pixelmatch"));
+const pngjs_1 = require("pngjs");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const visual_js_1 = require("./visual.js");
+// ============================================================================
+// Pixel Comparison
+// ============================================================================
+/**
+ * Compare two PNG screenshots pixel-by-pixel.
+ *
+ * Two different threshold concepts:
+ * - pixelmatchSensitivity: per-pixel matching sensitivity (how different a single
+ *   pixel must be to count as "different"). Lower = more sensitive. 0.1 is standard.
+ * - acceptPercent / acceptPixels: acceptance thresholds for the overall diff.
+ *   If EITHER is met (diff% <= acceptPercent OR diffPixels <= acceptPixels),
+ *   we consider it a match (no warning).
+ */
+function compareScreenshots(baselinePath, actualPath, diffOutputPath) {
+    let baseline;
+    let actual;
+    // Safely parse PNGs - corrupt files treated as full diff
+    try {
+        baseline = pngjs_1.PNG.sync.read((0, fs_1.readFileSync)(baselinePath));
+    }
+    catch {
+        // Corrupt or invalid baseline PNG - treat as full diff
+        return {
+            match: false,
+            diffPixels: 1,
+            diffPercent: 100,
+            totalPixels: 1,
+        };
+    }
+    try {
+        actual = pngjs_1.PNG.sync.read((0, fs_1.readFileSync)(actualPath));
+    }
+    catch {
+        // Corrupt or invalid actual PNG - treat as full diff
+        return {
+            match: false,
+            diffPixels: 1,
+            diffPercent: 100,
+            totalPixels: 1,
+        };
+    }
+    // Handle size mismatch - treat as full diff
+    if (baseline.width !== actual.width || baseline.height !== actual.height) {
+        return {
+            match: false,
+            diffPixels: Math.max(baseline.width * baseline.height, actual.width * actual.height),
+            diffPercent: 100,
+            totalPixels: Math.max(baseline.width * baseline.height, actual.width * actual.height),
+        };
+    }
+    const { width, height } = baseline;
+    const totalPixels = width * height;
+    const diff = new pngjs_1.PNG({ width, height });
+    // pixelmatchSensitivity: per-pixel matching sensitivity
+    const diffPixels = (0, pixelmatch_1.default)(baseline.data, actual.data, diff.data, width, height, { threshold: visual_js_1.DEFAULT_THRESHOLDS.pixelmatchSensitivity });
+    const diffPercent = (diffPixels / totalPixels) * 100;
+    // Acceptance: match if within EITHER threshold
+    const match = diffPercent <= visual_js_1.DEFAULT_THRESHOLDS.acceptPercent
+        || diffPixels <= visual_js_1.DEFAULT_THRESHOLDS.acceptPixels;
+    // Save diff image only if there are visible differences
+    if (!match) {
+        const diffDir = (0, path_1.dirname)(diffOutputPath);
+        if (!(0, fs_1.existsSync)(diffDir)) {
+            (0, fs_1.mkdirSync)(diffDir, { recursive: true });
+        }
+        (0, fs_1.writeFileSync)(diffOutputPath, pngjs_1.PNG.sync.write(diff));
+    }
+    return {
+        match,
+        diffPixels,
+        diffPercent: Math.round(diffPercent * 1000) / 1000,
+        totalPixels,
+    };
+}
+// ============================================================================
+// Full Visual Regression Processing
+// ============================================================================
+/**
+ * Process visual regression for a completed test run.
+ *
+ * This is the main entry point called from run.ts after E2E tests complete.
+ * All paths in the returned VisualResult.changes are relative to runDir.
+ */
+function processVisualRegression(projectDir, runDir) {
+    // Ensure visual directories exist
+    (0, visual_js_1.ensureVisualDirs)(projectDir);
+    const capturedScreenshots = (0, visual_js_1.loadCapturedScreenshots)(runDir);
+    // No screenshots captured - visual not enabled (fixture not used)
+    if (capturedScreenshots.length === 0) {
+        return {
+            enabled: false,
+            status: 'pass',
+            baseline: { sha: null },
+            capture: {
+                count: 0,
+                platform: process.platform,
+                browser: 'chromium',
+                viewport: { width: 1280, height: 720 },
+            },
+            comparison: {
+                performed: false,
+                thresholds: visual_js_1.DEFAULT_THRESHOLDS,
+                diffs: 0,
+                added: 0,
+                removed: 0,
+                unchanged: 0,
+            },
+            changes: [],
+        };
+    }
+    const action = (0, visual_js_1.getBaselineAction)(projectDir);
+    const currentHead = (0, visual_js_1.getCurrentHead)(projectDir) || 'local';
+    const captureDir = (0, path_1.join)(runDir, 'visual');
+    // ── Create Baseline ──────────────────────────────────────────────────────
+    if (action === 'create') {
+        (0, visual_js_1.createBaseline)(projectDir, currentHead, capturedScreenshots, captureDir);
+        // Cleanup old baselines
+        (0, visual_js_1.cleanupBaselines)(projectDir, 20);
+        return {
+            enabled: true,
+            status: 'baseline_created',
+            baseline: { sha: currentHead, createdAt: new Date().toISOString() },
+            capture: {
+                count: capturedScreenshots.length,
+                platform: process.platform,
+                browser: 'chromium',
+                viewport: { width: 1280, height: 720 },
+            },
+            comparison: {
+                performed: false,
+                thresholds: visual_js_1.DEFAULT_THRESHOLDS,
+                diffs: 0,
+                added: 0,
+                removed: 0,
+                unchanged: 0,
+            },
+            changes: [],
+        };
+    }
+    // ── Compare Against Baseline ─────────────────────────────────────────────
+    const baselineSha = (0, visual_js_1.getBaselineSha)(projectDir);
+    const baselineManifest = (0, visual_js_1.loadBaselineManifest)(projectDir, baselineSha);
+    if (!baselineManifest) {
+        // Baseline manifest missing - treat as error
+        return {
+            enabled: true,
+            status: 'error',
+            baseline: { sha: baselineSha },
+            capture: {
+                count: capturedScreenshots.length,
+                platform: process.platform,
+                browser: 'chromium',
+                viewport: { width: 1280, height: 720 },
+            },
+            comparison: {
+                performed: false,
+                thresholds: visual_js_1.DEFAULT_THRESHOLDS,
+                diffs: 0,
+                added: 0,
+                removed: 0,
+                unchanged: 0,
+            },
+            changes: [],
+        };
+    }
+    // Build lookup of baseline screenshots by ID
+    const baselineById = new Map();
+    for (const s of baselineManifest.screenshots) {
+        baselineById.set(s.id, s);
+    }
+    // Build lookup of captured screenshots by ID
+    const capturedById = new Map();
+    for (const s of capturedScreenshots) {
+        capturedById.set(s.id, s);
+    }
+    const changes = [];
+    let diffsCount = 0;
+    let addedCount = 0;
+    let removedCount = 0;
+    let unchangedCount = 0;
+    // Create diffs directory in run
+    const diffsDir = (0, path_1.join)(runDir, 'visual', 'diffs');
+    if (!(0, fs_1.existsSync)(diffsDir)) {
+        (0, fs_1.mkdirSync)(diffsDir, { recursive: true });
+    }
+    // Also create a baselines reference directory in run (for dashboard access)
+    const runBaselinesDir = (0, path_1.join)(runDir, 'visual', 'baselines');
+    if (!(0, fs_1.existsSync)(runBaselinesDir)) {
+        (0, fs_1.mkdirSync)(runBaselinesDir, { recursive: true });
+    }
+    // Compare each captured screenshot against baseline
+    for (const captured of capturedScreenshots) {
+        const baselineEntry = baselineById.get(captured.id);
+        if (!baselineEntry) {
+            // New screenshot - no baseline to compare
+            addedCount++;
+            changes.push({
+                id: captured.id,
+                testFile: captured.testFile,
+                testTitle: captured.testTitle,
+                type: 'added',
+                // Path relative to runDir
+                actualPath: (0, path_1.join)('visual', captured.filename),
+            });
+            continue;
+        }
+        // Compare against baseline
+        const baselinePath = (0, visual_js_1.getBaselineScreenshotPath)(projectDir, baselineSha, baselineEntry.filename);
+        const actualPath = (0, path_1.join)(captureDir, captured.filename);
+        const diffPath = (0, path_1.join)(diffsDir, `${captured.id}-diff.png`);
+        if (!(0, fs_1.existsSync)(baselinePath) || !(0, fs_1.existsSync)(actualPath)) {
+            // Missing file - treat as diff
+            diffsCount++;
+            changes.push({
+                id: captured.id,
+                testFile: captured.testFile,
+                testTitle: captured.testTitle,
+                type: 'diff',
+                actualPath: (0, path_1.join)('visual', captured.filename),
+            });
+            continue;
+        }
+        const result = compareScreenshots(baselinePath, actualPath, diffPath);
+        if (result.match) {
+            unchangedCount++;
+        }
+        else {
+            diffsCount++;
+            // Copy baseline to run dir for dashboard side-by-side viewing
+            const runBaselinePath = (0, path_1.join)(runBaselinesDir, `${captured.id}-baseline.png`);
+            try {
+                (0, fs_1.copyFileSync)(baselinePath, runBaselinePath);
+            }
+            catch {
+                // Ignore copy errors
+            }
+            changes.push({
+                id: captured.id,
+                testFile: captured.testFile,
+                testTitle: captured.testTitle,
+                type: 'diff',
+                diffPercent: result.diffPercent,
+                diffPixels: result.diffPixels,
+                // All paths relative to runDir
+                baselinePath: (0, path_1.join)('visual', 'baselines', `${captured.id}-baseline.png`),
+                actualPath: (0, path_1.join)('visual', captured.filename),
+                diffPath: (0, path_1.join)('visual', 'diffs', `${captured.id}-diff.png`),
+            });
+        }
+        // Remove from baseline lookup (to detect removed screenshots later)
+        baselineById.delete(captured.id);
+    }
+    // Detect removed screenshots (in baseline but not in current capture)
+    for (const [id, entry] of baselineById) {
+        removedCount++;
+        changes.push({
+            id,
+            testFile: entry.testFile,
+            testTitle: entry.testTitle,
+            type: 'removed',
+        });
+    }
+    // Cleanup old baselines
+    (0, visual_js_1.cleanupBaselines)(projectDir, 20);
+    const hasChanges = changes.length > 0;
+    return {
+        enabled: true,
+        status: hasChanges ? 'warn' : 'pass',
+        baseline: {
+            sha: baselineSha,
+            createdAt: baselineManifest.createdAt,
+        },
+        capture: {
+            count: capturedScreenshots.length,
+            platform: process.platform,
+            browser: 'chromium',
+            viewport: { width: 1280, height: 720 },
+        },
+        comparison: {
+            performed: true,
+            thresholds: visual_js_1.DEFAULT_THRESHOLDS,
+            diffs: diffsCount,
+            added: addedCount,
+            removed: removedCount,
+            unchanged: unchangedCount,
+        },
+        changes,
+    };
+}
+//# sourceMappingURL=visual-diff.js.map

package/dist/lib/visual-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-diff.js","sourceRoot":"","sources":["../../src/lib/visual-diff.ts"],"names":[],"mappings":"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"}

package/dist/lib/visual-fixture.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Invariant Visual Regression Auto-Capture Fixture
+ *
+ * Usage: In your test files, import from this fixture instead of @playwright/test:
+ *
+ *   import { test, expect } from '@invariant-ai/cli/visual';
+ *
+ * This automatically captures a screenshot at the end of each test
+ * with stabilization (fixed viewport, animations disabled, settle delay).
+ *
+ * v1 Limitations:
+ * - Chromium only (other browsers skipped to avoid font rendering differences)
+ * - One screenshot per test (at end of test)
+ * - No auto-masking (timestamps, avatars may cause noise)
+ * - Renaming tests regenerates baselines (ID is based on test file + title)
+ */
+import { expect } from '@playwright/test';
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export { expect };
+//# sourceMappingURL=visual-fixture.d.ts.map

package/dist/lib/visual-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-fixture.d.ts","sourceRoot":"","sources":["../../src/lib/visual-fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAgB,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA2CxD,eAAO,MAAM,IAAI,6OAuFf,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC"}