flakelab 0.1.0 → 0.1.2

package/dist/discovery/startup-event.js

@@ -0,0 +1,84 @@
+import { createCausalEvaluator } from "./evaluate.js";
+const MINIMUM_CONFIRMATION_TRIALS = 12;
+async function confirmBoundary(experiments, minimumDelayMs, evaluateDelay, confirmationTrials) {
+    const candidates = [...new Set(experiments
+            .filter((entry) => entry.delayMs >= minimumDelayMs && entry.result.confirmed)
+            .map((entry) => entry.delayMs))]
+        .sort((left, right) => left - right);
+    for (const delayMs of candidates) {
+        const result = await evaluateDelay(delayMs, confirmationTrials);
+        if (result.confirmed) {
+            return { delayMs, result };
+        }
+    }
+    throw new Error("No startup event delay reproduced the failure in two independent batches");
+}
+async function confirmStableTrigger(minimumDelayMs, maximumDelayMs, evaluateDelay, confirmationTrials) {
+    const delayMs = Math.ceil((minimumDelayMs + maximumDelayMs) / 2);
+    const result = await evaluateDelay(delayMs, confirmationTrials);
+    if (result.confirmed) {
+        return { delayMs, result };
+    }
+    if (delayMs === maximumDelayMs) {
+        throw new Error("No stable startup event reproducer was found within the configured bound");
+    }
+    const maximumResult = await evaluateDelay(maximumDelayMs, confirmationTrials);
+    if (!maximumResult.confirmed) {
+        throw new Error("No stable startup event reproducer was found within the configured bound");
+    }
+    return { delayMs: maximumDelayMs, result: maximumResult };
+}
+export async function discoverStartupEventDelay(execute, options) {
+    const common = {
+        concurrency: options.concurrency,
+        minimumFailureRate: options.minimumFailureRate,
+        seed: options.seed,
+        signal: options.signal,
+        trials: options.trials,
+    };
+    const evaluator = createCausalEvaluator(execute, common);
+    const experiments = [];
+    const evaluateDelay = async (delayMs, trials = options.trials) => {
+        const fault = {
+            kind: "startup-event-delay",
+            delayMs,
+            event: options.event,
+            pattern: options.pattern,
+        };
+        const result = await evaluator.evaluate([fault], trials);
+        experiments.push({ delayMs, result });
+        return result;
+    };
+    const maximum = await evaluateDelay(options.maximumDelayMs);
+    if (!maximum.confirmed) {
+        throw new Error("Maximum startup event delay did not reproduce the failure confidently");
+    }
+    let passingDelayMs = 0;
+    let failingDelayMs = options.maximumDelayMs;
+    while (failingDelayMs - passingDelayMs > 1) {
+        const candidate = Math.floor((passingDelayMs + failingDelayMs) / 2);
+        const result = await evaluateDelay(candidate);
+        if (result.confirmed) {
+            failingDelayMs = candidate;
+        }
+        else {
+            passingDelayMs = candidate;
+        }
+    }
+    const confirmationTrials = Math.max(options.trials, MINIMUM_CONFIRMATION_TRIALS);
+    const minimum = await confirmBoundary(experiments, failingDelayMs, evaluateDelay, confirmationTrials);
+    const stable = await confirmStableTrigger(minimum.delayMs, options.maximumDelayMs, evaluateDelay, confirmationTrials);
+    return {
+        baseline: evaluator.baseline(),
+        experiments,
+        minimumDelayMs: minimum.delayMs,
+        trigger: {
+            kind: "startup-event-delay",
+            delayMs: stable.delayMs,
+            event: options.event,
+            pattern: options.pattern,
+        },
+        triggerResult: stable.result,
+    };
+}
+//# sourceMappingURL=startup-event.js.map

package/dist/discovery/startup-event.js.map

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

package/dist/discovery/storage-state.d.ts

@@ -0,0 +1,26 @@
+import type { BrowserStorageArea, StorageStateDelayFault } from "../domain/schema.js";
+import type { TrialExecutor } from "../runner/playwright-executor.js";
+import type { ExperimentResult } from "./evaluate.js";
+export interface StorageStateDiscoveryOptions {
+    concurrency: number;
+    key: string;
+    maximumDelayMs: number;
+    minimumFailureRate: number;
+    pattern: string;
+    seed: number;
+    signal?: AbortSignal;
+    storage: BrowserStorageArea;
+    trials: number;
+}
+export interface StorageStateExperiment {
+    delayMs: number;
+    result: ExperimentResult;
+}
+export interface StorageStateDiscoveryResult {
+    baseline: ExperimentResult;
+    experiments: StorageStateExperiment[];
+    minimumDelayMs: number;
+    trigger: StorageStateDelayFault;
+    triggerResult: ExperimentResult;
+}
+export declare function discoverStorageStateDelay(execute: TrialExecutor, options: StorageStateDiscoveryOptions): Promise<StorageStateDiscoveryResult>;

package/dist/discovery/storage-state.js

@@ -0,0 +1,86 @@
+import { createCausalEvaluator } from "./evaluate.js";
+const MINIMUM_CONFIRMATION_TRIALS = 12;
+async function confirmBoundary(experiments, minimumDelayMs, evaluateDelay, confirmationTrials) {
+    const candidates = [...new Set(experiments
+            .filter((entry) => entry.delayMs >= minimumDelayMs && entry.result.confirmed)
+            .map((entry) => entry.delayMs))]
+        .sort((left, right) => left - right);
+    for (const delayMs of candidates) {
+        const result = await evaluateDelay(delayMs, confirmationTrials);
+        if (result.confirmed) {
+            return { delayMs, result };
+        }
+    }
+    throw new Error("No storage-state delay reproduced the failure in two independent batches");
+}
+async function confirmStableTrigger(minimumDelayMs, maximumDelayMs, evaluateDelay, confirmationTrials) {
+    const delayMs = Math.ceil((minimumDelayMs + maximumDelayMs) / 2);
+    const result = await evaluateDelay(delayMs, confirmationTrials);
+    if (result.confirmed) {
+        return { delayMs, result };
+    }
+    if (delayMs === maximumDelayMs) {
+        throw new Error("No stable storage-state delay reproducer was found within the configured bound");
+    }
+    const maximumResult = await evaluateDelay(maximumDelayMs, confirmationTrials);
+    if (!maximumResult.confirmed) {
+        throw new Error("No stable storage-state delay reproducer was found within the configured bound");
+    }
+    return { delayMs: maximumDelayMs, result: maximumResult };
+}
+export async function discoverStorageStateDelay(execute, options) {
+    const common = {
+        concurrency: options.concurrency,
+        minimumFailureRate: options.minimumFailureRate,
+        seed: options.seed,
+        signal: options.signal,
+        trials: options.trials,
+    };
+    const evaluator = createCausalEvaluator(execute, common);
+    const experiments = [];
+    const evaluateDelay = async (delayMs, trials = options.trials) => {
+        const fault = {
+            kind: "storage-state-delay",
+            delayMs,
+            key: options.key,
+            pattern: options.pattern,
+            storage: options.storage,
+        };
+        const result = await evaluator.evaluate([fault], trials);
+        experiments.push({ delayMs, result });
+        return result;
+    };
+    const maximum = await evaluateDelay(options.maximumDelayMs);
+    if (!maximum.confirmed) {
+        throw new Error("Maximum storage-state delay did not reproduce the failure confidently");
+    }
+    let passingDelayMs = 0;
+    let failingDelayMs = options.maximumDelayMs;
+    while (failingDelayMs - passingDelayMs > 1) {
+        const candidate = Math.floor((passingDelayMs + failingDelayMs) / 2);
+        const result = await evaluateDelay(candidate);
+        if (result.confirmed) {
+            failingDelayMs = candidate;
+        }
+        else {
+            passingDelayMs = candidate;
+        }
+    }
+    const confirmationTrials = Math.max(options.trials, MINIMUM_CONFIRMATION_TRIALS);
+    const minimum = await confirmBoundary(experiments, failingDelayMs, evaluateDelay, confirmationTrials);
+    const stable = await confirmStableTrigger(minimum.delayMs, options.maximumDelayMs, evaluateDelay, confirmationTrials);
+    return {
+        baseline: evaluator.baseline(),
+        experiments,
+        minimumDelayMs: minimum.delayMs,
+        trigger: {
+            kind: "storage-state-delay",
+            delayMs: stable.delayMs,
+            key: options.key,
+            pattern: options.pattern,
+            storage: options.storage,
+        },
+        triggerResult: stable.result,
+    };
+}
+//# sourceMappingURL=storage-state.js.map

package/dist/discovery/storage-state.js.map

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

package/dist/discovery/temporal-environment.d.ts

@@ -0,0 +1,31 @@
+import type { ClockJumpFault, Fault, LocaleFault, TimezoneFault } from "../domain/schema.js";
+import type { TrialExecutor } from "../runner/playwright-executor.js";
+import type { ExperimentResult } from "./evaluate.js";
+interface TemporalDiscoveryOptions {
+    concurrency: number;
+    minimumFailureRate: number;
+    pattern: string;
+    seed: number;
+    signal?: AbortSignal;
+    trials: number;
+}
+export interface ClockJumpDiscoveryOptions extends TemporalDiscoveryOptions {
+    jumpAfterMs: number;
+    offsetMs: number;
+}
+export interface LocaleDiscoveryOptions extends TemporalDiscoveryOptions {
+    locale: string;
+}
+export interface TimezoneDiscoveryOptions extends TemporalDiscoveryOptions {
+    timezoneId: string;
+}
+export interface TemporalDiscoveryResult<T extends Fault> {
+    baseline: ExperimentResult;
+    experiments: ExperimentResult[];
+    trigger: T;
+    triggerResult: ExperimentResult;
+}
+export declare function discoverClockJump(execute: TrialExecutor, options: ClockJumpDiscoveryOptions): Promise<TemporalDiscoveryResult<ClockJumpFault>>;
+export declare function discoverLocale(execute: TrialExecutor, options: LocaleDiscoveryOptions): Promise<TemporalDiscoveryResult<LocaleFault>>;
+export declare function discoverTimezone(execute: TrialExecutor, options: TimezoneDiscoveryOptions): Promise<TemporalDiscoveryResult<TimezoneFault>>;
+export {};

package/dist/discovery/temporal-environment.js

@@ -0,0 +1,43 @@
+import { createCausalEvaluator } from "./evaluate.js";
+const MINIMUM_CONFIRMATION_TRIALS = 12;
+async function confirmTemporalFault(execute, options, trigger, label) {
+    const common = {
+        concurrency: options.concurrency,
+        minimumFailureRate: options.minimumFailureRate,
+        seed: options.seed,
+        signal: options.signal,
+    };
+    const evaluator = createCausalEvaluator(execute, { ...common, trials: options.trials });
+    const first = await evaluator.evaluate([trigger]);
+    if (!first.confirmed) {
+        throw new Error(`${label} did not reproduce the failure confidently`);
+    }
+    const triggerResult = await evaluator.evaluate([trigger], Math.max(options.trials, MINIMUM_CONFIRMATION_TRIALS));
+    if (!triggerResult.confirmed) {
+        throw new Error(`${label} did not reproduce in an independent confirmation batch`);
+    }
+    return { baseline: evaluator.baseline(), experiments: [first, triggerResult], trigger, triggerResult };
+}
+export function discoverClockJump(execute, options) {
+    return confirmTemporalFault(execute, options, {
+        kind: "clock-jump",
+        jumpAfterMs: options.jumpAfterMs,
+        offsetMs: options.offsetMs,
+        pattern: options.pattern,
+    }, "Clock jump");
+}
+export function discoverLocale(execute, options) {
+    return confirmTemporalFault(execute, options, {
+        kind: "locale",
+        locale: options.locale,
+        pattern: options.pattern,
+    }, "Locale change");
+}
+export function discoverTimezone(execute, options) {
+    return confirmTemporalFault(execute, options, {
+        kind: "timezone",
+        pattern: options.pattern,
+        timezoneId: options.timezoneId,
+    }, "Timezone change");
+}
+//# sourceMappingURL=temporal-environment.js.map

package/dist/discovery/temporal-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-environment.js","sourceRoot":"","sources":["../../src/discovery/temporal-environment.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAErD,MAAM,2BAA2B,GAAG,EAAE,CAAA;AA+BtC,KAAK,UAAU,oBAAoB,CACjC,OAAsB,EACtB,OAAiC,EACjC,OAAU,EACV,KAAa;IAEb,MAAM,MAAM,GAAG;QACb,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAA;IACD,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACvF,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IACjD,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,4CAA4C,CAAC,CAAA;IACvE,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,QAAQ,CAC5C,CAAC,OAAO,CAAC,EACT,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,CAAC,CACtD,CAAA;IACD,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,yDAAyD,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAA;AACxG,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAsB,EACtB,OAAkC;IAElC,OAAO,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE;QAC5C,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,EAAE,YAAY,CAAC,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAsB,EACtB,OAA+B;IAE/B,OAAO,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE;QAC5C,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,EAAE,eAAe,CAAC,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAsB,EACtB,OAAiC;IAEjC,OAAO,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE;QAC5C,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,EAAE,iBAAiB,CAAC,CAAA;AACvB,CAAC"}

package/dist/discovery/visual-environment.d.ts

@@ -0,0 +1,28 @@
+import type { AnimationSpeedFault, Fault, ReducedMotionFault, ViewportFault } from "../domain/schema.js";
+import type { TrialExecutor } from "../runner/playwright-executor.js";
+import type { ExperimentResult } from "./evaluate.js";
+interface VisualDiscoveryOptions {
+    concurrency: number;
+    minimumFailureRate: number;
+    pattern: string;
+    seed: number;
+    signal?: AbortSignal;
+    trials: number;
+}
+export interface AnimationSpeedDiscoveryOptions extends VisualDiscoveryOptions {
+    rate: number;
+}
+export interface ViewportDiscoveryOptions extends VisualDiscoveryOptions {
+    height: number;
+    width: number;
+}
+export interface VisualDiscoveryResult<T extends Fault> {
+    baseline: ExperimentResult;
+    experiments: ExperimentResult[];
+    trigger: T;
+    triggerResult: ExperimentResult;
+}
+export declare function discoverAnimationSpeed(execute: TrialExecutor, options: AnimationSpeedDiscoveryOptions): Promise<VisualDiscoveryResult<AnimationSpeedFault>>;
+export declare function discoverReducedMotion(execute: TrialExecutor, options: VisualDiscoveryOptions): Promise<VisualDiscoveryResult<ReducedMotionFault>>;
+export declare function discoverViewport(execute: TrialExecutor, options: ViewportDiscoveryOptions): Promise<VisualDiscoveryResult<ViewportFault>>;
+export {};

package/dist/discovery/visual-environment.js

@@ -0,0 +1,42 @@
+import { createCausalEvaluator } from "./evaluate.js";
+const MINIMUM_CONFIRMATION_TRIALS = 12;
+async function confirmVisualFault(execute, options, trigger, label) {
+    const common = {
+        concurrency: options.concurrency,
+        minimumFailureRate: options.minimumFailureRate,
+        seed: options.seed,
+        signal: options.signal,
+    };
+    const evaluator = createCausalEvaluator(execute, { ...common, trials: options.trials });
+    const first = await evaluator.evaluate([trigger]);
+    if (!first.confirmed) {
+        throw new Error(`${label} did not reproduce the failure confidently`);
+    }
+    const triggerResult = await evaluator.evaluate([trigger], Math.max(options.trials, MINIMUM_CONFIRMATION_TRIALS));
+    if (!triggerResult.confirmed) {
+        throw new Error(`${label} did not reproduce in an independent confirmation batch`);
+    }
+    return { baseline: evaluator.baseline(), experiments: [first, triggerResult], trigger, triggerResult };
+}
+export function discoverAnimationSpeed(execute, options) {
+    return confirmVisualFault(execute, options, {
+        kind: "animation-speed",
+        pattern: options.pattern,
+        rate: options.rate,
+    }, "Animation speed");
+}
+export function discoverReducedMotion(execute, options) {
+    return confirmVisualFault(execute, options, {
+        kind: "reduced-motion",
+        pattern: options.pattern,
+    }, "Reduced motion");
+}
+export function discoverViewport(execute, options) {
+    return confirmVisualFault(execute, options, {
+        height: options.height,
+        kind: "viewport",
+        pattern: options.pattern,
+        width: options.width,
+    }, "Viewport change");
+}
+//# sourceMappingURL=visual-environment.js.map

package/dist/discovery/visual-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-environment.js","sourceRoot":"","sources":["../../src/discovery/visual-environment.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAErD,MAAM,2BAA2B,GAAG,EAAE,CAAA;AA2BtC,KAAK,UAAU,kBAAkB,CAC/B,OAAsB,EACtB,OAA+B,EAC/B,OAAU,EACV,KAAa;IAEb,MAAM,MAAM,GAAG;QACb,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAA;IACD,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACvF,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IACjD,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,4CAA4C,CAAC,CAAA;IACvE,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,QAAQ,CAC5C,CAAC,OAAO,CAAC,EACT,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,CAAC,CACtD,CAAA;IACD,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,yDAAyD,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAA;AACxG,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAsB,EACtB,OAAuC;IAEvC,OAAO,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE;QAC1C,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,EAAE,iBAAiB,CAAC,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAAsB,EACtB,OAA+B;IAE/B,OAAO,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE;QAC1C,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,EAAE,gBAAgB,CAAC,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAsB,EACtB,OAAiC;IAEjC,OAAO,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE;QAC1C,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,EAAE,iBAAiB,CAAC,CAAA;AACvB,CAAC"}