flakelab 0.1.0 → 0.1.2

package/dist/runner/process-tree.d.ts

@@ -0,0 +1,7 @@
+import { spawn } from "node:child_process";
+export interface CapturedProcessResult {
+    diagnostic: string;
+    exitCode: number | null;
+    spawnError?: string;
+}
+export declare function waitForProcessTree(child: ReturnType<typeof spawn>, signal?: AbortSignal): Promise<CapturedProcessResult>;

package/dist/runner/process-tree.js

@@ -0,0 +1,62 @@
+import { spawnSync } from "node:child_process";
+import { resolve } from "node:path";
+const MAX_DIAGNOSTIC_BYTES = 64 * 1024;
+const TASKKILL_PATH = resolve(process.env.SystemRoot ?? "C:\\Windows", "System32", "taskkill.exe");
+function appendBounded(current, chunk) {
+    return `${current}${chunk.toString("utf8")}`.slice(-MAX_DIAGNOSTIC_BYTES);
+}
+function terminateProcessTree(child) {
+    const processId = child.pid;
+    if (!processId) {
+        return;
+    }
+    if (process.platform === "win32") {
+        const termination = spawnSync(TASKKILL_PATH, ["/pid", String(processId), "/t", "/f"], { shell: false, stdio: "ignore", windowsHide: true });
+        if (termination.error || termination.status !== 0) {
+            child.kill();
+        }
+        return;
+    }
+    try {
+        process.kill(-processId, "SIGTERM");
+    }
+    catch {
+        child.kill();
+    }
+}
+export function waitForProcessTree(child, signal) {
+    return new Promise((complete) => {
+        let diagnostic = "";
+        let settled = false;
+        const finish = (result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            signal?.removeEventListener("abort", abort);
+            complete(result);
+        };
+        const abort = () => {
+            terminateProcessTree(child);
+        };
+        if (signal?.aborted) {
+            abort();
+        }
+        else {
+            signal?.addEventListener("abort", abort, { once: true });
+        }
+        child.stdout?.on("data", (chunk) => {
+            diagnostic = appendBounded(diagnostic, chunk);
+        });
+        child.stderr?.on("data", (chunk) => {
+            diagnostic = appendBounded(diagnostic, chunk);
+        });
+        child.on("error", (error) => {
+            finish({ diagnostic, exitCode: null, spawnError: error.message });
+        });
+        child.on("close", (exitCode) => {
+            finish({ diagnostic, exitCode });
+        });
+    });
+}
+//# sourceMappingURL=process-tree.js.map

package/dist/runner/process-tree.js.map

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

package/dist/runner/project-bridge.d.ts

@@ -0,0 +1,7 @@
+import type { Fault } from "../domain/schema.js";
+export interface TemporaryProjectBridge {
+    configPath: string;
+    remove: () => Promise<void>;
+}
+export declare function findPlaywrightConfig(projectRoot: string): Promise<string | undefined>;
+export declare function createTemporaryProjectBridge(projectRoot: string, reporterPath: string, faults?: readonly Fault[], captureTrace?: boolean): Promise<TemporaryProjectBridge>;

package/dist/runner/project-bridge.js

@@ -0,0 +1,83 @@
+import { lstat, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { browserContextFaultOptions } from "../faults/browser-context.js";
+const CONFIG_NAMES = [
+    "playwright.config.ts",
+    "playwright.config.mts",
+    "playwright.config.cts",
+    "playwright.config.js",
+    "playwright.config.mjs",
+    "playwright.config.cjs",
+];
+async function regularFile(path) {
+    try {
+        return (await lstat(path)).isFile();
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function findPlaywrightConfig(projectRoot) {
+    for (const name of CONFIG_NAMES) {
+        const candidate = join(projectRoot, name);
+        if (await regularFile(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+function bridgeSource(configPath, reporterPath, faults, captureTrace) {
+    const configImportPath = configPath
+        ? JSON.stringify(`./${basename(configPath)}`)
+        : undefined;
+    const configImport = configPath
+        ? `import userConfig from ${configImportPath}\n`
+        : "const userConfig = {}\n";
+    const contextFaults = JSON.stringify(browserContextFaultOptions(faults));
+    return `${configImport}
+const proxyServer = process.env.FLAKELAB_PROXY_URL
+const proxy = proxyServer ? { server: proxyServer } : undefined
+const contextFaults = ${contextFaults}
+const withFaults = (use = {}) => ({
+  ...use,
+  ...contextFaults,
+  ${captureTrace ? 'trace: "on",' : ""}
+  contextOptions: { ...use.contextOptions, ...contextFaults },
+  ...(proxy ? { proxy } : {}),
+})
+const configuredReporters = userConfig.reporter
+const reporters = configuredReporters === undefined
+  ? [["line"]]
+  : typeof configuredReporters === "string"
+    ? [[configuredReporters]]
+    : configuredReporters
+const projects = Array.isArray(userConfig.projects)
+  ? userConfig.projects.map((project) => ({ ...project, use: withFaults(project.use) }))
+  : userConfig.projects
+
+export default {
+  ...userConfig,
+  use: withFaults(userConfig.use),
+  ...(projects ? { projects } : {}),
+  reporter: [...reporters, [${JSON.stringify(reporterPath)}]],
+}
+`;
+}
+export async function createTemporaryProjectBridge(projectRoot, reporterPath, faults = [], captureTrace = false) {
+    const userConfigPath = await findPlaywrightConfig(projectRoot);
+    const configDirectory = userConfigPath ? dirname(userConfigPath) : projectRoot;
+    const configPath = join(configDirectory, `.flakelab-${randomUUID()}.config.ts`);
+    await writeFile(configPath, bridgeSource(userConfigPath, reporterPath, faults, captureTrace), {
+        encoding: "utf8",
+        flag: "wx",
+    });
+    return {
+        configPath,
+        remove: async () => rm(configPath, { force: true }),
+    };
+}
+//# sourceMappingURL=project-bridge.js.map

package/dist/runner/project-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-bridge.js","sourceRoot":"","sources":["../../src/runner/project-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAEzE,MAAM,YAAY,GAAG;IACnB,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;IACvB,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;CACxB,CAAA;AAOD,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzE,OAAO,KAAK,CAAA;QACd,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB;IAC5D,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;QACzC,IAAI,MAAM,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,YAAY,CACnB,UAA8B,EAC9B,YAAoB,EACpB,MAAwB,EACxB,YAAqB;IAErB,MAAM,gBAAgB,GAAG,UAAU;QACjC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,YAAY,GAAG,UAAU;QAC7B,CAAC,CAAC,0BAA0B,gBAAgB,IAAI;QAChD,CAAC,CAAC,yBAAyB,CAAA;IAC7B,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAA;IACxE,OAAO,GAAG,YAAY;;;wBAGA,aAAa;;;;IAIjC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;8BAkBR,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;;CAEzD,CAAA;AACD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,WAAmB,EACnB,YAAoB,EACpB,SAA2B,EAAE,EAC7B,YAAY,GAAG,KAAK;IAEpB,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAA;IAC9D,MAAM,eAAe,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,WAAW,CAAA;IAC9E,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,aAAa,UAAU,EAAE,YAAY,CAAC,CAAA;IAC/E,MAAM,SAAS,CAAC,UAAU,EAAE,YAAY,CACtC,cAAc,EACd,YAAY,EACZ,MAAM,EACN,YAAY,CACb,EAAE;QACD,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,IAAI;KACX,CAAC,CAAA;IACF,OAAO;QACL,UAAU;QACV,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACpD,CAAA;AACH,CAAC"}

package/dist/runner/trial-reporter.d.ts

@@ -0,0 +1,7 @@
+import type { FullResult, Reporter, TestCase, TestResult } from "@playwright/test/reporter";
+export default class FlakeLabTrialReporter implements Reporter {
+    private readonly artifacts;
+    private readonly failures;
+    onTestEnd(test: TestCase, result: TestResult): void;
+    onEnd(result: FullResult): Promise<void>;
+}

package/dist/runner/trial-reporter.js

@@ -0,0 +1,47 @@
+import { writeFile } from "node:fs/promises";
+import { relative } from "node:path";
+const MAX_FAILURE_LENGTH = 2_000;
+function failureText(test, result) {
+    const message = result.error?.message?.trim();
+    if (!message) {
+        return undefined;
+    }
+    const file = relative(process.cwd(), test.location.file).replaceAll("\\", "/");
+    const location = `${file}:${test.location.line}:${test.location.column}`;
+    const identity = [test.parent.project()?.name, location, test.title]
+        .filter((part) => part)
+        .join(" › ");
+    return `${identity}\n${message}`.slice(0, MAX_FAILURE_LENGTH);
+}
+export default class FlakeLabTrialReporter {
+    artifacts = [];
+    failures = [];
+    onTestEnd(test, result) {
+        const failure = failureText(test, result);
+        if (failure) {
+            this.failures.push(failure);
+        }
+        for (const attachment of result.attachments) {
+            if (attachment.path && this.artifacts.length < 5) {
+                this.artifacts.push({
+                    contentType: attachment.contentType,
+                    name: attachment.name,
+                    path: attachment.path,
+                });
+            }
+        }
+    }
+    async onEnd(result) {
+        const path = process.env.FLAKELAB_TRIAL_REPORT_PATH;
+        if (!path) {
+            return;
+        }
+        const output = {
+            artifacts: this.artifacts,
+            failures: this.failures.slice(0, 10),
+            status: result.status,
+        };
+        await writeFile(path, `${JSON.stringify(output)}\n`, "utf8");
+    }
+}
+//# sourceMappingURL=trial-reporter.js.map

package/dist/runner/trial-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trial-reporter.js","sourceRoot":"","sources":["../../src/runner/trial-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AASpC,MAAM,kBAAkB,GAAG,KAAK,CAAA;AAQhC,SAAS,WAAW,CAAC,IAAc,EAAE,MAAkB;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC9E,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAA;IACxE,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC;SACjE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;SACtB,IAAI,CAAC,KAAK,CAAC,CAAA;IACd,OAAO,GAAG,QAAQ,KAAK,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAA;AAC/D,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,qBAAqB;IACvB,SAAS,GAAqC,EAAE,CAAA;IAChD,QAAQ,GAAa,EAAE,CAAA;IAExC,SAAS,CAAC,IAAc,EAAE,MAAkB;QAC1C,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC7B,CAAC;QACD,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAClB,WAAW,EAAE,UAAU,CAAC,WAAW;oBACnC,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;iBACtB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAkB;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAA;QACnD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAwB;YAClC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAA;QACD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC9D,CAAC;CACF"}

package/dist/scan/failure-clusters.d.ts

@@ -0,0 +1,24 @@
+import type { ScanAttachment, ScanFailureCluster } from "./schema.js";
+interface MutableFailureCluster {
+    firstObservedAttempt: number;
+    lastObservedAttempt: number;
+    occurrences: number;
+    representativeArtifacts: Map<string, ScanAttachment>;
+    representativeReason: string;
+    signature: string;
+}
+export type FailureClusterMap = Map<string, MutableFailureCluster>;
+export interface FailureObservation {
+    artifacts: ScanAttachment[];
+    attempt: number;
+    reason: string;
+}
+export interface FinalizedFailureClusters {
+    failureClusters: ScanFailureCluster[];
+    multipleFailureModes: boolean;
+    omittedFailureModes: number;
+}
+export declare function failureSignature(reason: string): string;
+export declare function recordFailureObservation(clusters: FailureClusterMap, observation: FailureObservation): void;
+export declare function finalizeFailureClusters(clusters: FailureClusterMap, measuredTrials: number): FinalizedFailureClusters;
+export {};

package/dist/scan/failure-clusters.js

@@ -0,0 +1,74 @@
+import { createHash } from "node:crypto";
+const MAX_FAILURE_CLUSTERS = 5;
+const MAX_REPRESENTATIVE_ARTIFACTS = 3;
+export function failureSignature(reason) {
+    return createHash("sha256").update(reason).digest("hex").slice(0, 16);
+}
+function isUsefulFailureArtifact(artifact) {
+    const name = artifact.name.toLowerCase();
+    return name.includes("trace")
+        || name.includes("screenshot")
+        || name.includes("video")
+        || artifact.contentType.startsWith("image/")
+        || artifact.contentType.startsWith("video/");
+}
+function artifactKey(artifact) {
+    return `${artifact.name}:${artifact.contentType}`;
+}
+function createCluster(observation, signature) {
+    return {
+        firstObservedAttempt: observation.attempt,
+        lastObservedAttempt: observation.attempt,
+        occurrences: 0,
+        representativeArtifacts: new Map(),
+        representativeReason: observation.reason,
+        signature,
+    };
+}
+export function recordFailureObservation(clusters, observation) {
+    const signature = failureSignature(observation.reason);
+    const cluster = clusters.get(signature) ?? createCluster(observation, signature);
+    cluster.occurrences += 1;
+    cluster.lastObservedAttempt = observation.attempt;
+    for (const artifact of observation.artifacts) {
+        if (!isUsefulFailureArtifact(artifact)) {
+            continue;
+        }
+        if (cluster.representativeArtifacts.size >= MAX_REPRESENTATIVE_ARTIFACTS) {
+            break;
+        }
+        cluster.representativeArtifacts.set(artifactKey(artifact), artifact);
+    }
+    clusters.set(signature, cluster);
+}
+function compareClusters(left, right) {
+    const occurrenceOrder = right.occurrences - left.occurrences;
+    if (occurrenceOrder !== 0) {
+        return occurrenceOrder;
+    }
+    const attemptOrder = left.firstObservedAttempt - right.firstObservedAttempt;
+    return attemptOrder !== 0 ? attemptOrder : left.signature.localeCompare(right.signature);
+}
+function finalizeCluster(cluster, measuredTrials) {
+    return {
+        firstObservedAttempt: cluster.firstObservedAttempt,
+        lastObservedAttempt: cluster.lastObservedAttempt,
+        observedRate: measuredTrials === 0 ? 0 : cluster.occurrences / measuredTrials,
+        occurrences: cluster.occurrences,
+        representativeArtifacts: [...cluster.representativeArtifacts.values()],
+        representativeReason: cluster.representativeReason,
+        signature: cluster.signature,
+    };
+}
+export function finalizeFailureClusters(clusters, measuredTrials) {
+    const failureClusters = [...clusters.values()]
+        .sort(compareClusters)
+        .slice(0, MAX_FAILURE_CLUSTERS)
+        .map((cluster) => finalizeCluster(cluster, measuredTrials));
+    return {
+        failureClusters,
+        multipleFailureModes: clusters.size > 1,
+        omittedFailureModes: Math.max(0, clusters.size - failureClusters.length),
+    };
+}
+//# sourceMappingURL=failure-clusters.js.map

package/dist/scan/failure-clusters.js.map

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

package/dist/scan/schema.d.ts

@@ -0,0 +1,170 @@
+import { z } from "zod";
+export declare const scanStatusSchema: z.ZodEnum<{
+    inconclusive: "inconclusive";
+    "failed-every-run": "failed-every-run";
+    "mixed-outcomes": "mixed-outcomes";
+    "no-failure-observed": "no-failure-observed";
+}>;
+export declare const scanTestStatusSchema: z.ZodEnum<{
+    "failed-every-run": "failed-every-run";
+    "mixed-outcomes": "mixed-outcomes";
+    "no-failure-observed": "no-failure-observed";
+    errored: "errored";
+    skipped: "skipped";
+}>;
+declare const scanCountsSchema: z.ZodObject<{
+    errors: z.ZodNumber;
+    failed: z.ZodNumber;
+    passed: z.ZodNumber;
+    skipped: z.ZodNumber;
+}, z.core.$strip>;
+export declare const scanTotalsSchema: z.ZodObject<{
+    errors: z.ZodNumber;
+    failed: z.ZodNumber;
+    passed: z.ZodNumber;
+    skipped: z.ZodNumber;
+    executions: z.ZodNumber;
+    failureRate: z.ZodNumber;
+    lowerBound80: z.ZodNumber;
+    upperBound80: z.ZodNumber;
+}, z.core.$strip>;
+export declare const scanTestIdentitySchema: z.ZodObject<{
+    column: z.ZodNumber;
+    file: z.ZodString;
+    line: z.ZodNumber;
+    project: z.ZodString;
+    titlePath: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const scanAttachmentSchema: z.ZodObject<{
+    contentType: z.ZodString;
+    name: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strip>;
+export declare const scanFailureClusterSchema: z.ZodObject<{
+    firstObservedAttempt: z.ZodNumber;
+    lastObservedAttempt: z.ZodNumber;
+    observedRate: z.ZodNumber;
+    occurrences: z.ZodNumber;
+    representativeArtifacts: z.ZodArray<z.ZodObject<{
+        contentType: z.ZodString;
+        name: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strip>>;
+    representativeReason: z.ZodString;
+    signature: z.ZodString;
+}, z.core.$strip>;
+export declare const scanTestResultSchema: z.ZodObject<{
+    counts: z.ZodObject<{
+        errors: z.ZodNumber;
+        failed: z.ZodNumber;
+        passed: z.ZodNumber;
+        skipped: z.ZodNumber;
+    }, z.core.$strip>;
+    failureClusters: z.ZodArray<z.ZodObject<{
+        firstObservedAttempt: z.ZodNumber;
+        lastObservedAttempt: z.ZodNumber;
+        observedRate: z.ZodNumber;
+        occurrences: z.ZodNumber;
+        representativeArtifacts: z.ZodArray<z.ZodObject<{
+            contentType: z.ZodString;
+            name: z.ZodString;
+            path: z.ZodString;
+        }, z.core.$strip>>;
+        representativeReason: z.ZodString;
+        signature: z.ZodString;
+    }, z.core.$strip>>;
+    failureRate: z.ZodNumber;
+    identity: z.ZodObject<{
+        column: z.ZodNumber;
+        file: z.ZodString;
+        line: z.ZodNumber;
+        project: z.ZodString;
+        titlePath: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    lowerBound80: z.ZodNumber;
+    multipleFailureModes: z.ZodBoolean;
+    omittedFailureModes: z.ZodNumber;
+    status: z.ZodEnum<{
+        "failed-every-run": "failed-every-run";
+        "mixed-outcomes": "mixed-outcomes";
+        "no-failure-observed": "no-failure-observed";
+        errored: "errored";
+        skipped: "skipped";
+    }>;
+    trials: z.ZodNumber;
+    upperBound80: z.ZodNumber;
+}, z.core.$strip>;
+export declare const scanArtifactSchema: z.ZodObject<{
+    generatedAt: z.ZodISODateTime;
+    playwrightOutputDirectory: z.ZodNullable<z.ZodString>;
+    runs: z.ZodNumber;
+    runnerErrors: z.ZodArray<z.ZodString>;
+    status: z.ZodEnum<{
+        inconclusive: "inconclusive";
+        "failed-every-run": "failed-every-run";
+        "mixed-outcomes": "mixed-outcomes";
+        "no-failure-observed": "no-failure-observed";
+    }>;
+    target: z.ZodString;
+    tests: z.ZodArray<z.ZodObject<{
+        counts: z.ZodObject<{
+            errors: z.ZodNumber;
+            failed: z.ZodNumber;
+            passed: z.ZodNumber;
+            skipped: z.ZodNumber;
+        }, z.core.$strip>;
+        failureClusters: z.ZodArray<z.ZodObject<{
+            firstObservedAttempt: z.ZodNumber;
+            lastObservedAttempt: z.ZodNumber;
+            observedRate: z.ZodNumber;
+            occurrences: z.ZodNumber;
+            representativeArtifacts: z.ZodArray<z.ZodObject<{
+                contentType: z.ZodString;
+                name: z.ZodString;
+                path: z.ZodString;
+            }, z.core.$strip>>;
+            representativeReason: z.ZodString;
+            signature: z.ZodString;
+        }, z.core.$strip>>;
+        failureRate: z.ZodNumber;
+        identity: z.ZodObject<{
+            column: z.ZodNumber;
+            file: z.ZodString;
+            line: z.ZodNumber;
+            project: z.ZodString;
+            titlePath: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        lowerBound80: z.ZodNumber;
+        multipleFailureModes: z.ZodBoolean;
+        omittedFailureModes: z.ZodNumber;
+        status: z.ZodEnum<{
+            "failed-every-run": "failed-every-run";
+            "mixed-outcomes": "mixed-outcomes";
+            "no-failure-observed": "no-failure-observed";
+            errored: "errored";
+            skipped: "skipped";
+        }>;
+        trials: z.ZodNumber;
+        upperBound80: z.ZodNumber;
+    }, z.core.$strip>>;
+    totals: z.ZodObject<{
+        errors: z.ZodNumber;
+        failed: z.ZodNumber;
+        passed: z.ZodNumber;
+        skipped: z.ZodNumber;
+        executions: z.ZodNumber;
+        failureRate: z.ZodNumber;
+        lowerBound80: z.ZodNumber;
+        upperBound80: z.ZodNumber;
+    }, z.core.$strip>;
+    workers: z.ZodNumber;
+}, z.core.$strip>;
+export type ScanArtifact = z.infer<typeof scanArtifactSchema>;
+export type ScanAttachment = z.infer<typeof scanAttachmentSchema>;
+export type ScanCounts = z.infer<typeof scanCountsSchema>;
+export type ScanFailureCluster = z.infer<typeof scanFailureClusterSchema>;
+export type ScanStatus = z.infer<typeof scanStatusSchema>;
+export type ScanTestResult = z.infer<typeof scanTestResultSchema>;
+export type ScanTestStatus = z.infer<typeof scanTestStatusSchema>;
+export type ScanTotals = z.infer<typeof scanTotalsSchema>;
+export {};

package/dist/scan/schema.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+export const scanStatusSchema = z.enum([
+    "failed-every-run",
+    "inconclusive",
+    "mixed-outcomes",
+    "no-failure-observed",
+]);
+export const scanTestStatusSchema = z.enum([
+    "errored",
+    "failed-every-run",
+    "mixed-outcomes",
+    "no-failure-observed",
+    "skipped",
+]);
+const scanCountsSchema = z.object({
+    errors: z.number().int().nonnegative(),
+    failed: z.number().int().nonnegative(),
+    passed: z.number().int().nonnegative(),
+    skipped: z.number().int().nonnegative(),
+});
+export const scanTotalsSchema = scanCountsSchema.extend({
+    executions: z.number().int().nonnegative(),
+    failureRate: z.number().min(0).max(1),
+    lowerBound80: z.number().min(0).max(1),
+    upperBound80: z.number().min(0).max(1),
+});
+export const scanTestIdentitySchema = z.object({
+    column: z.number().int().positive(),
+    file: z.string().min(1),
+    line: z.number().int().positive(),
+    project: z.string(),
+    titlePath: z.array(z.string().min(1)).min(1),
+});
+export const scanAttachmentSchema = z.object({
+    contentType: z.string().min(1),
+    name: z.string().min(1),
+    path: z.string().min(1),
+});
+export const scanFailureClusterSchema = z.object({
+    firstObservedAttempt: z.number().int().positive(),
+    lastObservedAttempt: z.number().int().positive(),
+    observedRate: z.number().min(0).max(1),
+    occurrences: z.number().int().positive(),
+    representativeArtifacts: z.array(scanAttachmentSchema).max(3),
+    representativeReason: z.string().min(1).max(2_000),
+    signature: z.string().regex(/^[a-f0-9]{16}$/u),
+});
+export const scanTestResultSchema = z.object({
+    counts: scanCountsSchema,
+    failureClusters: z.array(scanFailureClusterSchema).max(5),
+    failureRate: z.number().min(0).max(1),
+    identity: scanTestIdentitySchema,
+    lowerBound80: z.number().min(0).max(1),
+    multipleFailureModes: z.boolean(),
+    omittedFailureModes: z.number().int().nonnegative(),
+    status: scanTestStatusSchema,
+    trials: z.number().int().nonnegative(),
+    upperBound80: z.number().min(0).max(1),
+});
+export const scanArtifactSchema = z.object({
+    generatedAt: z.iso.datetime(),
+    playwrightOutputDirectory: z.string().min(1).nullable(),
+    runs: z.number().int().min(2).max(100),
+    runnerErrors: z.array(z.string().min(1).max(2_000)),
+    status: scanStatusSchema,
+    target: z.string().min(1),
+    tests: z.array(scanTestResultSchema),
+    totals: scanTotalsSchema,
+    workers: z.number().int().min(1).max(32),
+});
+//# sourceMappingURL=schema.js.map

package/dist/scan/schema.js.map

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

package/dist/solari/executor.d.ts

@@ -1,10 +1,14 @@
 import type { TrialExecutor } from "../runner/playwright-executor.js";
 import type { ResourceUsage } from "./usage.js";
+export declare const SOLARI_SANDBOX_TEMPLATE = "base";
+export declare const SOLARI_SANDBOX_TIMEOUT_MS: number;
+export declare const CHECKOUT_START_SHELL = "sh";
+export declare const CHECKOUT_START_COMMAND = "cd /opt/flakelab-checkout && nohup python3 server.py >server.log 2>&1 &";
 export interface SolariExecutorOptions {
     apiKey: string;
     baseUrl: string;
     signal?: AbortSignal;
-    snapshotName: string;
+    snapshotKey: string;
 }
 export declare class SolariParallelExecutor {
     #private;