@kintsugi-ai/core 0.1.0

package/dist/auth.d.ts

@@ -0,0 +1,57 @@
+import type { ClassifierContext } from './comparator.js';
+import type { KintsugiConfig } from './types.js';
+type Logger = {
+    info: (msg: string, data?: unknown) => void;
+    warn: (msg: string, data?: unknown) => void;
+};
+/** Stable per-machine fingerprint used to issue anonymous keys. */
+export declare function computeDeviceHash(): string;
+/** Writes (or replaces) one KEY=VALUE line in ~/.kintsugi/.env, preserving other lines. */
+export declare function writeGlobalEnvValue(key: string, value: string): string;
+/**
+ * Returns the hosted-API key, bootstrapping an anonymous free key (written to
+ * ~/.kintsugi/.env) when none exists. Returns undefined on network failure —
+ * callers degrade to classifier-off, never crash.
+ */
+export declare function ensureApiKey(options: {
+    endpoint: string;
+    tokenEnvVar: string;
+    projectDir?: string;
+    fetchImpl?: typeof fetch;
+    logger?: Logger;
+}): Promise<string | undefined>;
+export interface ApiAccountStatus {
+    plan: string;
+    flowsUsed: number;
+    flowLimit: number | null;
+    upgradeUrl?: string;
+}
+export declare function getAccountStatus(apiKey: string, endpoint: string, fetchImpl?: typeof fetch): Promise<ApiAccountStatus | undefined>;
+/** Stripe Payment Link URL for the $29/mo Pro upgrade, or undefined when billing is unavailable. */
+export declare function createCheckoutUrl(apiKey: string, endpoint: string, fetchImpl?: typeof fetch): Promise<string | undefined>;
+/**
+ * Polls account status until the plan becomes 'pro' (the Stripe webhook flips
+ * it server-side shortly after payment) or the timeout elapses. Called from
+ * the CLI and the VS Code extension after the payment link is opened.
+ */
+export declare function waitForPlanUpgrade(apiKey: string, endpoint: string, options?: {
+    intervalMs?: number;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    shouldContinue?: () => boolean;
+    onPoll?: (status: ApiAccountStatus | undefined) => void;
+}): Promise<ApiAccountStatus | undefined>;
+/**
+ * Shared classifier-context builder used by the hook, `kintsugi check`, and
+ * the MCP server — one code path decides when classification is active.
+ * With bootstrapKey, an anonymous hosted key is auto-issued on first use.
+ */
+export declare function buildClassifierContext(config: KintsugiConfig, options?: {
+    context?: string;
+    logger?: Logger;
+    bootstrapKey?: boolean;
+    projectDir?: string;
+    fetchImpl?: typeof fetch;
+}): Promise<ClassifierContext | undefined>;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,KAAK,MAAM,GAAG;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,CAAC;AAE3G,mEAAmE;AACnE,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAmBtE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuB9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,OAAO,KAAK,GACvB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAUvC;AAED,oGAAoG;AACpG,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,OAAO,KAAK,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,KAAK,IAAI,CAAC;CACpD,GACL,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAUvC;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB,GACL,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAkCxC"}

package/dist/auth.js

@@ -0,0 +1,151 @@
+/**
+ * Hosted-API client lifecycle: anonymous key bootstrap, account status, and
+ * checkout — shared by the hook, the CLI, and the VS Code extension.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { createHash } from 'node:crypto';
+import { resolveApiToken, globalKintsugiEnvPath } from './classifier.js';
+/** Stable per-machine fingerprint used to issue anonymous keys. */
+export function computeDeviceHash() {
+    return createHash('sha256').update(`${os.hostname()}|${os.homedir()}`).digest('hex').slice(0, 32);
+}
+/** Writes (or replaces) one KEY=VALUE line in ~/.kintsugi/.env, preserving other lines. */
+export function writeGlobalEnvValue(key, value) {
+    const envPath = globalKintsugiEnvPath();
+    fs.mkdirSync(path.dirname(envPath), { recursive: true });
+    let content = '';
+    try {
+        content = fs.readFileSync(envPath, 'utf-8');
+    }
+    catch {
+        // no file yet
+    }
+    const line = `${key}=${value}`;
+    const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const re = new RegExp(`^${escapedKey}=.*$`, 'm');
+    const updated = re.test(content)
+        ? content.replace(re, line)
+        : content === '' || content.endsWith('\n')
+            ? content + line
+            : content + '\n' + line;
+    fs.writeFileSync(envPath, updated.endsWith('\n') ? updated : updated + '\n');
+    return envPath;
+}
+/**
+ * Returns the hosted-API key, bootstrapping an anonymous free key (written to
+ * ~/.kintsugi/.env) when none exists. Returns undefined on network failure —
+ * callers degrade to classifier-off, never crash.
+ */
+export async function ensureApiKey(options) {
+    const existing = resolveApiToken(options.tokenEnvVar, options.projectDir);
+    if (existing)
+        return existing;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    try {
+        const res = await fetchImpl(`${options.endpoint.replace(/\/$/, '')}/keys`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ deviceHash: computeDeviceHash() }),
+        });
+        if (!res.ok)
+            throw new Error(`key issuance ${res.status}`);
+        const body = (await res.json());
+        if (typeof body.key !== 'string' || !body.key.startsWith('knt_')) {
+            throw new Error('key issuance returned no key');
+        }
+        writeGlobalEnvValue(options.tokenEnvVar, body.key);
+        options.logger?.info('issued anonymous kintsugi api key', { envFile: globalKintsugiEnvPath() });
+        return body.key;
+    }
+    catch (err) {
+        options.logger?.warn(`could not obtain a kintsugi api key: ${err.message}`);
+        return undefined;
+    }
+}
+export async function getAccountStatus(apiKey, endpoint, fetchImpl) {
+    try {
+        const res = await (fetchImpl ?? fetch)(`${endpoint.replace(/\/$/, '')}/keys/me`, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!res.ok)
+            return undefined;
+        return (await res.json());
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Stripe Payment Link URL for the $29/mo Pro upgrade, or undefined when billing is unavailable. */
+export async function createCheckoutUrl(apiKey, endpoint, fetchImpl) {
+    try {
+        const res = await (fetchImpl ?? fetch)(`${endpoint.replace(/\/$/, '')}/billing/checkout`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!res.ok)
+            return undefined;
+        const body = (await res.json());
+        return body.url;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Polls account status until the plan becomes 'pro' (the Stripe webhook flips
+ * it server-side shortly after payment) or the timeout elapses. Called from
+ * the CLI and the VS Code extension after the payment link is opened.
+ */
+export async function waitForPlanUpgrade(apiKey, endpoint, options = {}) {
+    const interval = options.intervalMs ?? 3000;
+    const deadline = Date.now() + (options.timeoutMs ?? 180_000);
+    while (Date.now() < deadline && (options.shouldContinue?.() ?? true)) {
+        const status = await getAccountStatus(apiKey, endpoint, options.fetchImpl);
+        if (status?.plan === 'pro')
+            return status;
+        options.onPoll?.(status);
+        await new Promise(resolve => setTimeout(resolve, interval));
+    }
+    return undefined;
+}
+/**
+ * Shared classifier-context builder used by the hook, `kintsugi check`, and
+ * the MCP server — one code path decides when classification is active.
+ * With bootstrapKey, an anonymous hosted key is auto-issued on first use.
+ */
+export async function buildClassifierContext(config, options = {}) {
+    const log = options.logger;
+    if (!config.classifier?.enabled) {
+        log?.info('classifier disabled in config');
+        return undefined;
+    }
+    let apiToken = resolveApiToken(config.classifier.tokenEnvVar, options.projectDir);
+    if (!apiToken && options.bootstrapKey && config.classifier.provider === 'kintsugi') {
+        apiToken = await ensureApiKey({
+            endpoint: config.classifier.endpoint,
+            tokenEnvVar: config.classifier.tokenEnvVar,
+            projectDir: options.projectDir,
+            fetchImpl: options.fetchImpl,
+            logger: log,
+        });
+    }
+    if (!apiToken) {
+        log?.warn(`no API token found (env ${config.classifier.tokenEnvVar}, <project>/.kintsugi/.env, or ~/.kintsugi/.env) — classifier disabled, large diffs will escalate without classification`);
+        return undefined;
+    }
+    log?.info('classifier active', {
+        provider: config.classifier.provider,
+        model: config.classifier.model,
+        endpoint: config.classifier.endpoint,
+        turnContext: options.context || '(none)',
+    });
+    return {
+        config: config.classifier,
+        apiToken,
+        context: options.context,
+        logger: log,
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/baseline.d.ts

@@ -0,0 +1,8 @@
+import type { FlowMetadata, FlowRecording, CaptureResult } from './types.js';
+export declare function getFlowDir(projectDir: string, name: string): string;
+export declare function listFlows(projectDir: string): Promise<FlowMetadata[]>;
+export declare function loadFlow(projectDir: string, name: string): Promise<FlowRecording>;
+export declare function saveFlow(projectDir: string, recording: FlowRecording): Promise<void>;
+export declare function deleteFlow(projectDir: string, name: string): Promise<void>;
+export declare function updateBaseline(projectDir: string, name: string, capture: CaptureResult): Promise<void>;
+//# sourceMappingURL=baseline.d.ts.map

package/dist/baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../src/baseline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7E,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAoB3E;AAED,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA8DvF;AAED,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1F;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5G"}

package/dist/baseline.js

@@ -0,0 +1,114 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+export function getFlowDir(projectDir, name) {
+    return path.join(projectDir, '.kintsugi', 'flows', name);
+}
+export async function listFlows(projectDir) {
+    const flowsDir = path.join(projectDir, '.kintsugi', 'flows');
+    try {
+        const entries = await fs.readdir(flowsDir, { withFileTypes: true });
+        const flows = [];
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const metaPath = path.join(flowsDir, entry.name, 'metadata.json');
+                try {
+                    const data = await fs.readFile(metaPath, 'utf-8');
+                    flows.push(JSON.parse(data));
+                }
+                catch (e) {
+                    // Ignore invalid directories
+                }
+            }
+        }
+        return flows;
+    }
+    catch (e) {
+        return [];
+    }
+}
+export async function loadFlow(projectDir, name) {
+    const flowDir = getFlowDir(projectDir, name);
+    const metaPath = path.join(flowDir, 'metadata.json');
+    const stepsPath = path.join(flowDir, 'steps.json');
+    const [metaData, stepsData] = await Promise.all([
+        fs.readFile(metaPath, 'utf-8'),
+        fs.readFile(stepsPath, 'utf-8'),
+    ]);
+    const metadata = JSON.parse(metaData);
+    const steps = JSON.parse(stepsData);
+    const screenshotsDir = path.join(flowDir, 'screenshots');
+    let screenshotPaths = [];
+    try {
+        const files = await fs.readdir(screenshotsDir);
+        // Explicitly match step screenshots for each step in order
+        const stepFiles = [];
+        let allStepsFound = true;
+        for (let i = 0; i < steps.length; i++) {
+            const candidates = [`step_${i}.png`, `step-${String(i).padStart(3, '0')}.png`, `step-${i}.png`];
+            const match = candidates.find(c => files.includes(c));
+            if (match) {
+                stepFiles.push(path.join(screenshotsDir, match));
+            }
+            else {
+                allStepsFound = false;
+                break;
+            }
+        }
+        if (allStepsFound && stepFiles.length > 0) {
+            screenshotPaths = stepFiles;
+        }
+        else {
+            screenshotPaths = files
+                .filter((f) => f.endsWith('.png'))
+                .sort()
+                .map((f) => path.join(screenshotsDir, f));
+        }
+    }
+    catch (e) {
+        // No screenshots directory
+    }
+    const videoPath = path.join(flowDir, 'video.webm');
+    const videoExists = await fs.stat(videoPath).then(() => true).catch(() => false);
+    // Baseline aria snapshots (semantic DOM state per step)
+    const ariaDir = path.join(flowDir, 'aria');
+    const ariaSnapshotPaths = [];
+    for (let i = 0; i < steps.length; i++) {
+        const ariaPath = path.join(ariaDir, `step_${i}.yml`);
+        const exists = await fs.stat(ariaPath).then(() => true).catch(() => false);
+        ariaSnapshotPaths.push(exists ? ariaPath : undefined);
+    }
+    return {
+        metadata,
+        steps,
+        screenshotPaths,
+        ariaSnapshotPaths: ariaSnapshotPaths.some(p => p !== undefined) ? ariaSnapshotPaths : undefined,
+        videoPath: videoExists ? videoPath : undefined,
+    };
+}
+export async function saveFlow(projectDir, recording) {
+    const flowDir = getFlowDir(projectDir, recording.metadata.name);
+    await fs.mkdir(flowDir, { recursive: true });
+    await fs.mkdir(path.join(flowDir, 'screenshots'), { recursive: true });
+    await fs.writeFile(path.join(flowDir, 'metadata.json'), JSON.stringify(recording.metadata, null, 2));
+    await fs.writeFile(path.join(flowDir, 'steps.json'), JSON.stringify(recording.steps, null, 2));
+}
+export async function deleteFlow(projectDir, name) {
+    const flowDir = getFlowDir(projectDir, name);
+    await fs.rm(flowDir, { recursive: true, force: true });
+}
+export async function updateBaseline(projectDir, name, capture) {
+    const flowDir = getFlowDir(projectDir, name);
+    const screenshotsDir = path.join(flowDir, 'screenshots');
+    const ariaDir = path.join(flowDir, 'aria');
+    await fs.mkdir(screenshotsDir, { recursive: true });
+    await fs.mkdir(ariaDir, { recursive: true });
+    for (let i = 0; i < capture.screenshots.length; i++) {
+        const screenshot = capture.screenshots[i];
+        await fs.writeFile(path.join(screenshotsDir, `step_${i}.png`), screenshot);
+        const aria = capture.ariaSnapshots?.[i];
+        if (aria !== undefined) {
+            await fs.writeFile(path.join(ariaDir, `step_${i}.yml`), aria, 'utf-8');
+        }
+    }
+}
+//# sourceMappingURL=baseline.js.map

package/dist/baseline.js.map

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

package/dist/benchmark.d.ts

@@ -0,0 +1,65 @@
+export interface LatencyMetric {
+    name: string;
+    targetMs: number;
+    actualMeanMs: number;
+    p50Ms: number;
+    p95Ms: number;
+    passed: boolean;
+}
+export interface AccuracyMetric {
+    name: string;
+    targetPercent: number;
+    actualPercent: number;
+    description: string;
+    passed: boolean;
+}
+export interface BenchmarkReport {
+    timestamp: string;
+    performance: {
+        metrics: LatencyMetric[];
+        allPassed: boolean;
+    };
+    accuracy: {
+        metrics: AccuracyMetric[];
+        truePositiveRate: number;
+        falsePositiveRate: number;
+        allPassed: boolean;
+    };
+    summary: {
+        totalBenchmarks: number;
+        passedBenchmarks: number;
+        launchReady: boolean;
+    };
+}
+/**
+ * Creates a synthetic UI PNG buffer of the given width and height.
+ */
+export declare function createSyntheticUiPng(options?: {
+    width?: number;
+    height?: number;
+    removeButton?: boolean;
+    shiftLayout?: boolean;
+    addNoise?: boolean;
+    noiseAmount?: number;
+}): Buffer;
+/**
+ * Runs the performance latency benchmark suite.
+ */
+export declare function runPerformanceBenchmark(iterations?: number): Promise<{
+    metrics: LatencyMetric[];
+    allPassed: boolean;
+}>;
+/**
+ * Runs the accuracy benchmark suite checking True Positive Rate and False Positive Rate.
+ */
+export declare function runAccuracyBenchmark(sampleSize?: number): Promise<{
+    metrics: AccuracyMetric[];
+    truePositiveRate: number;
+    falsePositiveRate: number;
+    allPassed: boolean;
+}>;
+/**
+ * Runs the complete benchmark suite (performance and accuracy).
+ */
+export declare function runAllBenchmarks(): Promise<BenchmarkReport>;
+//# sourceMappingURL=benchmark.d.ts.map

package/dist/benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../src/benchmark.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE;QACX,OAAO,EAAE,aAAa,EAAE,CAAC;QACzB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,OAAO,EAAE,cAAc,EAAE,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,OAAO,EAAE;QACP,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CA2ET;AAUD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,UAAU,SAAK,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CA8DxH;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,SAAK,GAAG,OAAO,CAAC;IACnE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC,CAwED;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,eAAe,CAAC,CAmBjE"}

package/dist/benchmark.js

@@ -0,0 +1,232 @@
+import { PNG } from 'pngjs';
+import { computePixelDiff, compareScreenshots } from './comparator.js';
+import { DiffResult } from './types.js';
+/**
+ * Creates a synthetic UI PNG buffer of the given width and height.
+ */
+export function createSyntheticUiPng(options) {
+    const width = options?.width || 1280;
+    const height = options?.height || 720;
+    const png = new PNG({ width, height });
+    // Background - light gray #F8FAFC
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const idx = (y * width + x) * 4;
+            png.data[idx] = 248;
+            png.data[idx + 1] = 250;
+            png.data[idx + 2] = 252;
+            png.data[idx + 3] = 255;
+        }
+    }
+    // Draw Navbar (0 to 60px height) - #1E293B
+    for (let y = 0; y < 60; y++) {
+        for (let x = 0; x < width; x++) {
+            const idx = (y * width + x) * 4;
+            png.data[idx] = 30;
+            png.data[idx + 1] = 41;
+            png.data[idx + 2] = 59;
+        }
+    }
+    // Draw Card Container
+    const cardTop = options?.shiftLayout ? 120 : 100;
+    const cardLeft = 100;
+    const cardWidth = width - 200;
+    const cardHeight = 400;
+    for (let y = cardTop; y < cardTop + cardHeight; y++) {
+        for (let x = cardLeft; x < cardLeft + cardWidth; x++) {
+            const idx = (y * width + x) * 4;
+            png.data[idx] = 255;
+            png.data[idx + 1] = 255;
+            png.data[idx + 2] = 255;
+        }
+    }
+    // Draw Button (e.g. checkout button) inside card if not removed
+    if (!options?.removeButton) {
+        const btnTop = cardTop + 300;
+        const btnLeft = cardLeft + 50;
+        const btnWidth = 200;
+        const btnHeight = 48;
+        for (let y = btnTop; y < btnTop + btnHeight; y++) {
+            for (let x = btnLeft; x < btnLeft + btnWidth; x++) {
+                const idx = (y * width + x) * 4;
+                png.data[idx] = 37;
+                png.data[idx + 1] = 99;
+                png.data[idx + 2] = 235; // Blue #2563EB
+            }
+        }
+    }
+    // Add subtle subpixel/anti-aliasing noise if requested
+    if (options?.addNoise) {
+        const amount = options.noiseAmount || 0.0005; // 0.05% of pixels
+        const totalPixels = width * height;
+        const noisePixels = Math.floor(totalPixels * amount);
+        for (let i = 0; i < noisePixels; i++) {
+            const px = Math.floor(Math.random() * totalPixels);
+            const idx = px * 4;
+            // Slight luminance jitter (+/- 3 in color value)
+            png.data[idx] = Math.max(0, Math.min(255, png.data[idx] + (Math.random() > 0.5 ? 2 : -2)));
+            png.data[idx + 1] = Math.max(0, Math.min(255, png.data[idx + 1] + (Math.random() > 0.5 ? 2 : -2)));
+            png.data[idx + 2] = Math.max(0, Math.min(255, png.data[idx + 2] + (Math.random() > 0.5 ? 2 : -2)));
+        }
+    }
+    return PNG.sync.write(png);
+}
+function calculatePercentiles(values) {
+    const sorted = [...values].sort((a, b) => a - b);
+    const p50 = sorted[Math.floor(sorted.length * 0.5)] || 0;
+    const p95 = sorted[Math.floor(sorted.length * 0.95)] || sorted[sorted.length - 1] || 0;
+    const mean = values.reduce((sum, v) => sum + v, 0) / (values.length || 1);
+    return { p50, p95, mean };
+}
+/**
+ * Runs the performance latency benchmark suite.
+ */
+export async function runPerformanceBenchmark(iterations = 10) {
+    const baseImg = createSyntheticUiPng();
+    const minorImg = createSyntheticUiPng({ addNoise: true, noiseAmount: 0.001 });
+    // 1. Benchmark pixelmatch on 1280x720
+    const pixelDiffTimes = [];
+    for (let i = 0; i < iterations; i++) {
+        const t0 = performance.now();
+        await computePixelDiff(baseImg, baseImg);
+        pixelDiffTimes.push(performance.now() - t0);
+    }
+    const pixelStats = calculatePercentiles(pixelDiffTimes);
+    // 2. Fast-path comparison latency (identical)
+    const fastPathTimes = [];
+    for (let i = 0; i < iterations; i++) {
+        const t0 = performance.now();
+        await compareScreenshots(baseImg, baseImg);
+        fastPathTimes.push(performance.now() - t0);
+    }
+    const fastPathStats = calculatePercentiles(fastPathTimes);
+    // 3. Minor-band comparison latency (sub-threshold noise)
+    const tier2Times = [];
+    for (let i = 0; i < iterations; i++) {
+        const t0 = performance.now();
+        await compareScreenshots(baseImg, minorImg);
+        tier2Times.push(performance.now() - t0);
+    }
+    const tier2Stats = calculatePercentiles(tier2Times);
+    const metrics = [
+        {
+            name: 'Pixel Diff Latency (1280x720)',
+            targetMs: 50,
+            actualMeanMs: pixelStats.mean,
+            p50Ms: pixelStats.p50,
+            p95Ms: pixelStats.p95,
+            passed: pixelStats.p95 <= 75,
+        },
+        {
+            name: 'Fast-Path Hook Latency (Identical)',
+            targetMs: 50,
+            actualMeanMs: fastPathStats.mean,
+            p50Ms: fastPathStats.p50,
+            p95Ms: fastPathStats.p95,
+            passed: fastPathStats.p95 <= 75,
+        },
+        {
+            name: 'Minor-Band Hook Latency (Sub-threshold Noise)',
+            targetMs: 250,
+            actualMeanMs: tier2Stats.mean,
+            p50Ms: tier2Stats.p50,
+            p95Ms: tier2Stats.p95,
+            passed: tier2Stats.p95 <= 300,
+        },
+    ];
+    return {
+        metrics,
+        allPassed: metrics.every(m => m.passed),
+    };
+}
+/**
+ * Runs the accuracy benchmark suite checking True Positive Rate and False Positive Rate.
+ */
+export async function runAccuracyBenchmark(sampleSize = 20) {
+    const baseImg = createSyntheticUiPng();
+    let truePositives = 0;
+    let falseNegatives = 0;
+    let trueNegatives = 0;
+    let falsePositives = 0;
+    // Test True Positive: Actual Regressions (missing button, layout shift)
+    for (let i = 0; i < sampleSize; i++) {
+        const isShift = i % 2 === 0;
+        const brokenImg = createSyntheticUiPng({
+            removeButton: !isShift,
+            shiftLayout: isShift,
+        });
+        const result = await compareScreenshots(baseImg, brokenImg);
+        if (result.result === DiffResult.CHANGED || result.result === DiffResult.BROKEN) {
+            truePositives++;
+        }
+        else {
+            falseNegatives++;
+        }
+    }
+    // Test False Positive: Benign changes (identical or sub-pixel noise)
+    for (let i = 0; i < sampleSize; i++) {
+        const isNoise = i % 2 === 0;
+        const benignImg = isNoise
+            ? createSyntheticUiPng({ addNoise: true, noiseAmount: 0.0003 })
+            : createSyntheticUiPng();
+        const result = await compareScreenshots(baseImg, benignImg);
+        if (result.result === DiffResult.IDENTICAL || result.result === DiffResult.MINOR) {
+            trueNegatives++;
+        }
+        else {
+            falsePositives++;
+        }
+    }
+    const tpr = (truePositives / (truePositives + falseNegatives)) * 100;
+    const fpr = (falsePositives / (falsePositives + trueNegatives)) * 100;
+    const metrics = [
+        {
+            name: 'True Positive Rate (Catches Real Regressions)',
+            targetPercent: 95.0,
+            actualPercent: tpr,
+            description: 'Percentage of genuine visual UI defects successfully caught',
+            passed: tpr >= 95.0,
+        },
+        {
+            name: 'False Positive Rate (Filters Benign Shifts)',
+            targetPercent: 5.0,
+            actualPercent: fpr,
+            description: 'Percentage of benign subpixel/anti-aliasing changes wrongly flagged',
+            passed: fpr <= 5.0,
+        },
+        {
+            name: 'Identical Match Precision',
+            targetPercent: 100.0,
+            actualPercent: ((trueNegatives / sampleSize) * 100),
+            description: 'Accuracy when comparing completely unchanged views',
+            passed: ((trueNegatives / sampleSize) * 100) >= 95.0,
+        },
+    ];
+    return {
+        metrics,
+        truePositiveRate: tpr,
+        falsePositiveRate: fpr,
+        allPassed: metrics.every(m => m.passed),
+    };
+}
+/**
+ * Runs the complete benchmark suite (performance and accuracy).
+ */
+export async function runAllBenchmarks() {
+    const perf = await runPerformanceBenchmark(10);
+    const acc = await runAccuracyBenchmark(20);
+    const totalBenchmarks = perf.metrics.length + acc.metrics.length;
+    const passedBenchmarks = perf.metrics.filter(m => m.passed).length +
+        acc.metrics.filter(m => m.passed).length;
+    return {
+        timestamp: new Date().toISOString(),
+        performance: perf,
+        accuracy: acc,
+        summary: {
+            totalBenchmarks,
+            passedBenchmarks,
+            launchReady: perf.allPassed && acc.allPassed,
+        },
+    };
+}
+//# sourceMappingURL=benchmark.js.map