@kintsugi-ai/core 0.1.0

package/dist/benchmark.js.map

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

package/dist/capturer.d.ts

@@ -0,0 +1,14 @@
+import { type Browser } from 'playwright';
+import type { CaptureResult, FlowRecording } from './types.js';
+export declare function getBrowser(): Promise<Browser>;
+export declare function closeBrowser(): Promise<void>;
+export declare function captureCurrentState(options: {
+    url: string;
+    flow: FlowRecording;
+    outputDir: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}): Promise<CaptureResult>;
+//# sourceMappingURL=capturer.d.ts.map

package/dist/capturer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capturer.d.ts","sourceRoot":"","sources":["../src/capturer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI/D,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAKnD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAKlD;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C,GAAG,OAAO,CAAC,aAAa,CAAC,CA8EzB"}

package/dist/capturer.js

@@ -0,0 +1,92 @@
+import { chromium } from 'playwright';
+import { promises as fs } from 'fs';
+import path from 'path';
+let browserInstance = null;
+export async function getBrowser() {
+    if (!browserInstance) {
+        browserInstance = await chromium.launch({ headless: true });
+    }
+    return browserInstance;
+}
+export async function closeBrowser() {
+    if (browserInstance) {
+        await browserInstance.close();
+        browserInstance = null;
+    }
+}
+export async function captureCurrentState(options) {
+    const { url, flow, outputDir, viewport = { width: 1280, height: 720 } } = options;
+    const browser = await getBrowser();
+    const videoDir = path.join(outputDir, 'video');
+    await fs.mkdir(videoDir, { recursive: true });
+    const context = await browser.newContext({
+        viewport,
+        recordVideo: { dir: videoDir }
+    });
+    const page = await context.newPage();
+    const result = {
+        screenshots: [],
+        screenshotPaths: [],
+        ariaSnapshots: [],
+        completedSteps: 0,
+        totalSteps: flow.steps.length,
+        errors: []
+    };
+    await fs.mkdir(outputDir, { recursive: true });
+    try {
+        let navigated = false;
+        for (let i = 0; i < flow.steps.length; i++) {
+            const step = flow.steps[i];
+            try {
+                if (!navigated && page.url() === 'about:blank' && step.action !== 'navigate') {
+                    await page.goto(url, { waitUntil: 'networkidle' });
+                    navigated = true;
+                }
+                if (step.action === 'navigate') {
+                    await page.goto(step.url || url, { waitUntil: 'networkidle' });
+                    navigated = true;
+                }
+                else if (step.action === 'click' && step.selector) {
+                    await page.click(step.selector, { timeout: step.timeout || 5000 });
+                }
+                else if (step.action === 'type' && step.selector && step.value !== undefined) {
+                    await page.fill(step.selector, step.value, { timeout: step.timeout || 5000 });
+                }
+                else if (step.action === 'scroll' && step.position) {
+                    await page.mouse.wheel(step.position.x, step.position.y);
+                }
+                else if (step.action === 'wait') {
+                    await page.waitForTimeout(step.timeout || 1000);
+                }
+                await page.waitForTimeout(500);
+                const screenshotPath = path.join(outputDir, `step_${i}.png`);
+                const buffer = await page.screenshot({ path: screenshotPath });
+                // Semantic DOM state for the classifier tier (diffable as text)
+                let aria = '';
+                try {
+                    aria = await page.locator('body').ariaSnapshot();
+                }
+                catch {
+                    aria = '';
+                }
+                await fs.writeFile(path.join(outputDir, `aria_step_${i}.yml`), aria, 'utf-8');
+                result.screenshots.push(buffer);
+                result.screenshotPaths.push(screenshotPath);
+                result.ariaSnapshots.push(aria);
+                result.completedSteps++;
+            }
+            catch (err) {
+                result.errors.push(`Step ${i} (${step.action}) failed: ${err.message}`);
+                break;
+            }
+        }
+    }
+    finally {
+        const videoObj = await page.video();
+        const videoPath = videoObj ? await videoObj.path() : undefined;
+        result.videoPath = videoPath;
+        await context.close();
+    }
+    return result;
+}
+//# sourceMappingURL=capturer.js.map

package/dist/capturer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capturer.js","sourceRoot":"","sources":["../src/capturer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,IAAI,eAAe,GAAmB,IAAI,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC;QAC9B,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAKzC;IACC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAClF,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;QACvC,QAAQ;QACR,WAAW,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE;KAC/B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,MAAM,MAAM,GAAkB;QAC5B,WAAW,EAAE,EAAE;QACf,eAAe,EAAE,EAAE;QACnB,aAAa,EAAE,EAAE;QACjB,cAAc,EAAE,CAAC;QACjB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;QAC7B,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,IAAI,CAAC;QACH,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,KAAK,aAAa,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;oBAC7E,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;oBACnD,SAAS,GAAG,IAAI,CAAC;gBACnB,CAAC;gBAED,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;oBAC/B,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;oBAC/D,SAAS,GAAG,IAAI,CAAC;gBACnB,CAAC;qBAAM,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACpD,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;gBACrE,CAAC;qBAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC/E,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;gBAChF,CAAC;qBAAM,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACrD,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC3D,CAAC;qBAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBAClC,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;gBAClD,CAAC;gBAED,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;gBAE/B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;gBAE/D,gEAAgE;gBAChE,IAAI,IAAI,GAAG,EAAE,CAAC;gBACd,IAAI,CAAC;oBACH,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC;gBACnD,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,GAAG,EAAE,CAAC;gBACZ,CAAC;gBACD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;gBAE9E,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBAC5C,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACxE,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/D,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/classifier.d.ts

@@ -0,0 +1,62 @@
+import type { ClassifierConfig } from './types.js';
+export interface ClassifierVerdict {
+    intentional: boolean;
+    /** 0..1 certainty reported by the classifier */
+    confidence: number;
+    /** One sentence: what changed and — if not intentional — how to fix it */
+    reasoning: string;
+}
+/** Metadata about the flow being classified (the hosted API uses it for the flow gate + usage log) */
+export interface ClassifyMeta {
+    flowName?: string;
+    flowHash?: string;
+    step?: number;
+}
+/**
+ * Thrown when the hosted API returns 429 — either the free-plan flow limit
+ * (distinct flows) or the monthly abuse cap. Carries the payload surfaced
+ * in agent feedback and UI ("10 of 10 flows guarded — upgrade for unlimited").
+ */
+export declare class FlowLimitError extends Error {
+    readonly kind: 'flow_limit_reached' | 'monthly_cap_reached';
+    readonly flowsUsed?: number;
+    readonly flowLimit?: number;
+    readonly upgradeUrl?: string;
+    constructor(body: {
+        error?: string;
+        flowsUsed?: number;
+        flowLimit?: number;
+        upgradeUrl?: string;
+    });
+}
+/**
+ * Classifies a visual change as intentional or a regression. Provider
+ * 'kintsugi' POSTs to the hosted classifier API (which owns the model and
+ * the flow gate); 'openai-compatible' sends the chat-completions prompt
+ * below to any OpenAI-compatible endpoint.
+ */
+export declare function classifyChange(options: {
+    baselineAria: string;
+    currentAria: string;
+    context?: string;
+    config: ClassifierConfig;
+    apiToken: string;
+    meta?: ClassifyMeta;
+    logger?: {
+        info: (msg: string, data?: unknown) => void;
+        warn: (msg: string, data?: unknown) => void;
+    };
+}): Promise<ClassifierVerdict>;
+/** Robustly extracts {intentional, confidence, reasoning} from the model output. Fails safe to not-intentional. */
+export declare function parseVerdict(content: string): ClassifierVerdict;
+/**
+ * Resolves the API token: process env first, then the project's
+ * `<projectDir>/.kintsugi/.env`, then the machine-global `~/.kintsugi/.env`
+ * (so one key works across all projects).
+ */
+export declare function resolveApiToken(tokenEnvVar: string, projectDir?: string): string | undefined;
+/** Path of the machine-global kintsugi env file — where the hosted API key lives. */
+export declare function globalKintsugiEnvPath(): string;
+/** Loads KEY=VALUE pairs from <projectDir>/.kintsugi/.env into process.env (never overrides). */
+export declare function loadKintsugiEnv(projectDir: string): void;
+//# sourceMappingURL=classifier.d.ts.map

package/dist/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../src/classifier.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sGAAsG;AACtG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAAC;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAQlG;AAaD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAC;CACvG,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAK7B;AAgHD,mHAAmH;AACnH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAkC/D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK5F;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAExD"}

package/dist/classifier.js

@@ -0,0 +1,204 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { diffAriaSnapshots } from './domdiff.js';
+/**
+ * Thrown when the hosted API returns 429 — either the free-plan flow limit
+ * (distinct flows) or the monthly abuse cap. Carries the payload surfaced
+ * in agent feedback and UI ("10 of 10 flows guarded — upgrade for unlimited").
+ */
+export class FlowLimitError extends Error {
+    kind;
+    flowsUsed;
+    flowLimit;
+    upgradeUrl;
+    constructor(body) {
+        super(body.error ?? 'limit_reached');
+        this.name = 'FlowLimitError';
+        this.kind = body.error === 'monthly_cap_reached' ? 'monthly_cap_reached' : 'flow_limit_reached';
+        this.flowsUsed = body.flowsUsed;
+        this.flowLimit = body.flowLimit;
+        this.upgradeUrl = body.upgradeUrl;
+    }
+}
+const SYSTEM_PROMPT = [
+    'You are a strict UI regression classifier for an automated QA tool that guards AI coding agents.',
+    'You will be given: (1) a structural diff of the page accessibility tree between the accepted baseline and the current state after a code change, and (2) optional context about what the developer/agent was asked to do in the latest turn.',
+    'The baseline is the ACCEPTED, WORKING state. Removed or broken elements (buttons, forms, prices, text, navigation) are regressions even if the remaining page looks coherent.',
+    'If no context is provided, be conservative: significant structural changes should be classified as not intentional.',
+    'If context IS provided and the diff implements exactly what the context asked for, classify it as intentional with high confidence — a requested change is not a regression.',
+    'Benign changes (reordered identical items, minor text edits, added requested features) are intentional.',
+    'Answer with ONLY a JSON object, no other text:',
+    '{"intentional": <true|false>, "confidence": <number between 0 and 1>, "reasoning": "<exactly one sentence: what changed, and if not intentional, the specific fix>"}',
+].join('\n');
+/**
+ * Classifies a visual change as intentional or a regression. Provider
+ * 'kintsugi' POSTs to the hosted classifier API (which owns the model and
+ * the flow gate); 'openai-compatible' sends the chat-completions prompt
+ * below to any OpenAI-compatible endpoint.
+ */
+export async function classifyChange(options) {
+    if (options.config.provider === 'kintsugi') {
+        return classifyViaKintsugi(options);
+    }
+    return classifyViaOpenAiCompatible(options);
+}
+/** Hosted kintsugi API path — the server computes the diff, picks the model, and enforces the flow gate. */
+async function classifyViaKintsugi(options) {
+    const { baselineAria, currentAria, context, config, apiToken, meta } = options;
+    const url = `${config.endpoint.replace(/\/$/, '')}/classify`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), config.timeoutMs);
+    let response;
+    try {
+        response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${apiToken}`,
+            },
+            body: JSON.stringify({ baselineAria, currentAria, context: context ?? null, meta: meta ?? null }),
+            signal: controller.signal,
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (response.status === 429) {
+        const body = await response.json().catch(() => ({}));
+        throw new FlowLimitError(body);
+    }
+    if (!response.ok) {
+        const detail = await response.text().catch(() => '');
+        throw new Error(`kintsugi api ${response.status}: ${detail.slice(0, 300)}`);
+    }
+    const payload = (await response.json());
+    if (typeof payload.intentional !== 'boolean' || typeof payload.confidence !== 'number') {
+        throw new Error(`unexpected kintsugi api response: ${JSON.stringify(payload).slice(0, 200)}`);
+    }
+    return {
+        intentional: payload.intentional,
+        confidence: payload.confidence,
+        reasoning: payload.reasoning ?? '',
+    };
+}
+async function classifyViaOpenAiCompatible(options) {
+    const { baselineAria, currentAria, context, config, apiToken, logger } = options;
+    const diff = diffAriaSnapshots(baselineAria, currentAria);
+    const userText = [
+        'Accessibility-tree diff (baseline → current). Lines prefixed "REMOVED:" were removed from the page, "ADDED:" were added:',
+        diff,
+        '',
+        context
+            ? `Context from the latest turn (what the agent was asked to do):\n"${context}"`
+            : 'No context available about the intended change.',
+        '',
+        'Classify this change as intentional or not. Reply with ONLY the JSON object.',
+    ].join('\n');
+    const body = {
+        model: config.model,
+        temperature: 0,
+        max_tokens: 120,
+        messages: [
+            { role: 'system', content: SYSTEM_PROMPT },
+            { role: 'user', content: userText },
+        ],
+    };
+    const url = `${config.endpoint.replace(/\/$/, '')}/chat/completions`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), config.timeoutMs);
+    let response;
+    try {
+        response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${apiToken}`,
+            },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!response.ok) {
+        const detail = await response.text().catch(() => '');
+        throw new Error(`classifier endpoint ${response.status}: ${detail.slice(0, 300)}`);
+    }
+    const payload = JSON.parse(await response.text());
+    const content = payload.choices?.[0]?.message?.content ?? '';
+    logger?.info('classifier responded', { content: content.slice(0, 300) });
+    return parseVerdict(content);
+}
+/** Robustly extracts {intentional, confidence, reasoning} from the model output. Fails safe to not-intentional. */
+export function parseVerdict(content) {
+    const text = content.trim();
+    // Preferred: the JSON object we asked for
+    const jsonMatch = text.match(/\{[\s\S]*?\}/);
+    if (jsonMatch) {
+        try {
+            const parsed = JSON.parse(jsonMatch[0]);
+            if (typeof parsed.intentional === 'boolean') {
+                return {
+                    intentional: parsed.intentional,
+                    confidence: typeof parsed.confidence === 'number'
+                        ? Math.min(1, Math.max(0, parsed.confidence))
+                        : 0.5,
+                    reasoning: typeof parsed.reasoning === 'string' && parsed.reasoning.trim()
+                        ? parsed.reasoning.trim()
+                        : 'No reasoning provided by classifier.',
+                };
+            }
+        }
+        catch {
+            // fall through to fail-safe
+        }
+    }
+    // Unparseable — fail safe: treat as an unresolved regression
+    return {
+        intentional: false,
+        confidence: 0.5,
+        reasoning: 'Classifier output was unparseable; treat this change as a regression and inspect the aria diff manually.',
+    };
+}
+/**
+ * Resolves the API token: process env first, then the project's
+ * `<projectDir>/.kintsugi/.env`, then the machine-global `~/.kintsugi/.env`
+ * (so one key works across all projects).
+ */
+export function resolveApiToken(tokenEnvVar, projectDir) {
+    if (process.env[tokenEnvVar])
+        return process.env[tokenEnvVar];
+    if (projectDir)
+        loadKintsugiEnv(projectDir);
+    loadEnvFile(globalKintsugiEnvPath());
+    return process.env[tokenEnvVar];
+}
+/** Path of the machine-global kintsugi env file — where the hosted API key lives. */
+export function globalKintsugiEnvPath() {
+    return path.join(os.homedir(), '.kintsugi', '.env');
+}
+/** Loads KEY=VALUE pairs from <projectDir>/.kintsugi/.env into process.env (never overrides). */
+export function loadKintsugiEnv(projectDir) {
+    loadEnvFile(path.join(projectDir, '.kintsugi', '.env'));
+}
+function loadEnvFile(envPath) {
+    let content;
+    try {
+        content = fs.readFileSync(envPath, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    for (const line of content.split('\n')) {
+        const match = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)\s*$/);
+        if (!match)
+            continue;
+        const key = match[1];
+        const value = match[2].replace(/^["']|["']$/g, '');
+        if (!(key in process.env))
+            process.env[key] = value;
+    }
+}
+//# sourceMappingURL=classifier.js.map

package/dist/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../src/classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAkBjD;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAA+C;IACnD,SAAS,CAAU;IACnB,SAAS,CAAU;IACnB,UAAU,CAAU;IAE7B,YAAY,IAAqF;QAC/F,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,eAAe,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,KAAK,qBAAqB,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,oBAAoB,CAAC;QAChG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACpC,CAAC;CACF;AAED,MAAM,aAAa,GAAG;IACpB,kGAAkG;IAClG,8OAA8O;IAC9O,+KAA+K;IAC/K,qHAAqH;IACrH,8KAA8K;IAC9K,yGAAyG;IACzG,gDAAgD;IAChD,sKAAsK;CACvK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAQpC;IACC,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC3C,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,2BAA2B,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,4GAA4G;AAC5G,KAAK,UAAU,mBAAmB,CAAC,OAOlC;IACC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAC/E,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC;IAC7D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACrE,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC1B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,QAAQ,EAAE;aACpC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;YACjG,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,gBAAgB,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA+B,CAAC;IACtE,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;KACnC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,2BAA2B,CAAC,OAO1C;IACC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEjF,MAAM,IAAI,GAAG,iBAAiB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG;QACf,0HAA0H;QAC1H,IAAI;QACJ,EAAE;QACF,OAAO;YACL,CAAC,CAAC,oEAAoE,OAAO,GAAG;YAChF,CAAC,CAAC,iDAAiD;QACrD,EAAE;QACF,8EAA8E;KAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,IAAI,GAAG;QACX,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;YAC1C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;SACpC;KACF,CAAC;IAEF,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC;IACrE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACrE,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC1B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,QAAQ,EAAE;aACpC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAE/C,CAAC;IACF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IAC7D,MAAM,EAAE,IAAI,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACzE,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAE5B,0CAA0C;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7C,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAIrC,CAAC;YACF,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC5C,OAAO;oBACL,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;wBAC/C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;wBAC7C,CAAC,CAAC,GAAG;oBACP,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;wBACxE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;wBACzB,CAAC,CAAC,sCAAsC;iBAC3C,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,OAAO;QACL,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,GAAG;QACf,SAAS,EAAE,0GAA0G;KACtH,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,UAAmB;IACtE,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC9D,IAAI,UAAU;QAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IAC5C,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/comparator.d.ts

@@ -0,0 +1,28 @@
+import { type StepComparisonResult, type FlowRecording, type CaptureResult, type ComparisonResult, type ClassifierConfig } from './types.js';
+/** Everything the comparator needs to consult the classifier for large diffs */
+export interface ClassifierContext {
+    config: ClassifierConfig;
+    apiToken: string;
+    /** What the agent was asked to do in the latest turn (sharpens intentional-vs-regression) */
+    context?: string;
+    logger?: {
+        info: (msg: string, data?: unknown) => void;
+        warn: (msg: string, data?: unknown) => void;
+    };
+}
+export interface CompareOptions {
+    outputDir?: string;
+    classifier?: ClassifierContext;
+}
+export declare function computePixelDiff(img1: Buffer, img2: Buffer): Promise<{
+    diffPercent: number;
+    diffImage: Buffer;
+}>;
+/**
+ * Pixel-only verdict for one screenshot pair. Diff percentages above the
+ * classifier threshold are returned as a tentative CHANGED — compareFlow
+ * refines those with the classifier when one is configured.
+ */
+export declare function compareScreenshots(baseline: Buffer, current: Buffer, stepIndex?: number, options?: CompareOptions): Promise<StepComparisonResult>;
+export declare function compareFlow(baseline: FlowRecording, current: CaptureResult, options?: CompareOptions): Promise<ComparisonResult>;
+//# sourceMappingURL=comparator.d.ts.map

package/dist/comparator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparator.d.ts","sourceRoot":"","sources":["../src/comparator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,oBAAoB,EAA2B,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKlL,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAC;CACvG;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBtH;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2B1J;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+DtI"}

package/dist/comparator.js

@@ -0,0 +1,184 @@
+import pixelmatch from 'pixelmatch';
+import { PNG } from 'pngjs';
+import { promises as fs } from 'fs';
+import path from 'path';
+import { DiffResult } from './types.js';
+import { classifyChange, FlowLimitError } from './classifier.js';
+import { flowFingerprint } from './flowid.js';
+import { diffAriaSnapshots } from './domdiff.js';
+export async function computePixelDiff(img1, img2) {
+    const png1 = PNG.sync.read(img1);
+    const png2 = PNG.sync.read(img2);
+    if (png1.width !== png2.width || png1.height !== png2.height) {
+        return { diffPercent: 100, diffImage: Buffer.alloc(0) };
+    }
+    const { width, height } = png1;
+    const diff = new PNG({ width, height });
+    const numDiffPixels = pixelmatch(png1.data, png2.data, diff.data, width, height, { threshold: 0.1 });
+    const diffPercent = (numDiffPixels / (width * height)) * 100;
+    const diffImage = PNG.sync.write(diff);
+    return { diffPercent, diffImage };
+}
+/**
+ * Pixel-only verdict for one screenshot pair. Diff percentages above the
+ * classifier threshold are returned as a tentative CHANGED — compareFlow
+ * refines those with the classifier when one is configured.
+ */
+export async function compareScreenshots(baseline, current, stepIndex = 0, options) {
+    const outputDir = options?.outputDir;
+    const { diffPercent, diffImage } = await computePixelDiff(baseline, current);
+    let result;
+    if (diffPercent <= 0.05) {
+        result = DiffResult.IDENTICAL;
+    }
+    else if (diffPercent > (options?.classifier?.config.pixelDiffThreshold ?? 0.5)) {
+        result = DiffResult.CHANGED;
+    }
+    else {
+        // Sub-threshold change: benign (anti-aliasing, subpixel shifts, dynamic content)
+        result = DiffResult.MINOR;
+    }
+    let diffImagePath;
+    if (outputDir && result !== DiffResult.IDENTICAL) {
+        diffImagePath = path.join(outputDir, `diff_${stepIndex}.png`);
+        await fs.writeFile(diffImagePath, diffImage);
+    }
+    return {
+        step: stepIndex,
+        pixelDiffPercent: diffPercent,
+        ssimScore: 1, // deprecated field, kept for output compatibility
+        result,
+        diffImagePath,
+    };
+}
+export async function compareFlow(baseline, current, options) {
+    const stepResults = [];
+    const len = Math.min(baseline.screenshotPaths.length, current.screenshots.length);
+    // Pass 1: pixel diff every step (cheap, deterministic)
+    for (let i = 0; i < len; i++) {
+        const baselineBuffer = await fs.readFile(baseline.screenshotPaths[i]);
+        const currentBuffer = current.screenshots[i];
+        stepResults.push(await compareScreenshots(baselineBuffer, currentBuffer, i, options));
+    }
+    // Pass 2: classify every oversized step — all classifier calls in parallel
+    const threshold = options?.classifier?.config.pixelDiffThreshold ?? 0.5;
+    const candidates = stepResults.filter(s => s.pixelDiffPercent > threshold);
+    const classifications = options?.classifier
+        ? await classifySteps(candidates, baseline, current, options.classifier)
+        : [];
+    for (const c of classifications) {
+        const step = stepResults.find(s => s.step === c.step);
+        if (step) {
+            step.result = c.intentional && c.confidence > (options.classifier.config.confidenceThreshold)
+                ? DiffResult.INTENTIONAL
+                : DiffResult.CHANGED;
+        }
+    }
+    // Aggregate the worst verdict across steps
+    let worstResult = DiffResult.IDENTICAL;
+    let failedStep;
+    for (const comp of stepResults) {
+        if (comp.result === DiffResult.CHANGED || comp.result === DiffResult.BROKEN || comp.result === DiffResult.ERROR) {
+            if (worstResult !== DiffResult.CHANGED && worstResult !== DiffResult.BROKEN && worstResult !== DiffResult.ERROR) {
+                worstResult = comp.result;
+                failedStep = comp.step;
+            }
+        }
+        else if (comp.result === DiffResult.MINOR && worstResult === DiffResult.IDENTICAL) {
+            worstResult = DiffResult.MINOR;
+        }
+        else if (comp.result === DiffResult.INTENTIONAL && worstResult === DiffResult.IDENTICAL) {
+            worstResult = DiffResult.INTENTIONAL;
+        }
+    }
+    if (current.errors.length > 0) {
+        worstResult = DiffResult.BROKEN;
+        failedStep = current.completedSteps;
+    }
+    const worstStep = stepResults.find(s => s.step === failedStep) || stepResults[0];
+    // Surface the classifier's explanation in the escalation panel (semanticAnalysis
+    // is what the VS Code split-view displays).
+    const worstRegression = classifications.find(c => !c.intentional);
+    return {
+        result: worstResult,
+        pixelDiffPercent: worstStep?.pixelDiffPercent || 0,
+        ssimScore: worstStep?.ssimScore || 1,
+        diffImagePath: worstStep?.diffImagePath,
+        semanticAnalysis: worstRegression?.reasoning,
+        failedStep,
+        stepResults,
+        classifications: classifications.length > 0 ? classifications : undefined,
+    };
+}
+/**
+ * Classifies all oversized steps in parallel. Fail-safe: a missing aria
+ * snapshot or any classifier error yields a not-intentional classification
+ * so the step still escalates.
+ */
+async function classifySteps(candidates, baseline, current, classifier) {
+    return Promise.all(candidates.map(async (candidate) => {
+        const i = candidate.step;
+        const currentAria = current.ariaSnapshots?.[i];
+        let baselineAria;
+        if (baseline.ariaSnapshotPaths?.[i]) {
+            try {
+                baselineAria = await fs.readFile(baseline.ariaSnapshotPaths[i], 'utf-8');
+            }
+            catch {
+                baselineAria = undefined;
+            }
+        }
+        const base = {
+            step: i,
+            intentional: false,
+            confidence: 0.5,
+            reasoning: 'aria snapshots unavailable for this pair — inspect the diff image manually',
+            ariaDiff: '(aria snapshots unavailable — re-record the baseline to enable classification)',
+            oldImagePath: baseline.screenshotPaths[i],
+            newImagePath: current.screenshotPaths[i],
+        };
+        if (baselineAria === undefined || currentAria === undefined) {
+            classifier.logger?.warn('aria snapshots unavailable for step — escalating without classification', { step: i });
+            return base;
+        }
+        const ariaDiff = diffAriaSnapshots(baselineAria, currentAria);
+        try {
+            const verdict = await classifyChange({
+                baselineAria,
+                currentAria,
+                context: classifier.context,
+                config: classifier.config,
+                apiToken: classifier.apiToken,
+                meta: {
+                    flowName: baseline.metadata.name,
+                    flowHash: flowFingerprint(baseline.metadata.name, baseline.steps),
+                    step: i,
+                },
+                logger: classifier.logger,
+            });
+            classifier.logger?.info('classification', { step: i, ...verdict });
+            return { ...base, ...verdict, ariaDiff };
+        }
+        catch (err) {
+            if (err instanceof FlowLimitError) {
+                classifier.logger?.warn('flow limit reached — step escalates pixel-diff only', {
+                    step: i,
+                    kind: err.kind,
+                    flowsUsed: err.flowsUsed,
+                    flowLimit: err.flowLimit,
+                });
+                const where = err.kind === 'monthly_cap_reached'
+                    ? 'monthly classification cap reached on the free plan'
+                    : `free plan flow limit reached (${err.flowsUsed ?? '?'}/${err.flowLimit ?? '?'} flows guarded)`;
+                return {
+                    ...base,
+                    ariaDiff,
+                    reasoning: `${where} — this flow degrades to pixel-diff only and is treated as a change. Upgrade at ${err.upgradeUrl ?? 'https://kintsugi.dev/upgrade'} to guard it with the classifier.`,
+                };
+            }
+            classifier.logger?.warn('classifier failed — escalating step', { step: i, error: err.message });
+            return { ...base, ariaDiff, reasoning: `classifier failed (${err.message}) — inspect the aria diff manually` };
+        }
+    }));
+}
+//# sourceMappingURL=comparator.js.map