@aplaytest/flaky 0.1.0

package/dist/codemod.js

@@ -0,0 +1,322 @@
+/**
+ * The quarantine codemod.
+ *
+ * Writes `@quarantine` into a test's own tag array rather than maintaining a
+ * side-list of quarantined tests. A suite that already excludes that tag needs
+ * no new runtime machinery, the state is greppable, it travels with the code
+ * in review, and deleting the test deletes the quarantine.
+ *
+ * WHY THIS LIVES IN @aplaytest/flaky AND NOT @aplaytest/core: ts-morph bundles the
+ * TypeScript compiler. `core` is imported by the reporter, which runs inside
+ * every test worker — loading a compiler there would be exactly the overhead
+ * that makes people switch the tool off. `flaky` is never on that path. When
+ * the heal engine needs the same plumbing, extract it to its own package
+ * rather than pushing it down into core.
+ */
+import { Node, Project, SyntaxKind } from 'ts-morph';
+export const QUARANTINE_TAG = '@quarantine';
+/** `test(...)`, `test.only(...)`, `test.fail(...)` — but never `test.describe(...)`. */
+function isTestCall(call) {
+    const expression = call.getExpression();
+    if (Node.isIdentifier(expression))
+        return expression.getText() === 'test';
+    if (Node.isPropertyAccessExpression(expression)) {
+        const object = expression.getExpression().getText();
+        const property = expression.getName();
+        // describe/beforeEach/afterEach take a title too; tagging those would
+        // quarantine an entire suite from a request to quarantine one test.
+        const NON_TEST = new Set(['describe', 'beforeEach', 'afterEach', 'beforeAll', 'afterAll', 'step']);
+        return object === 'test' && !NON_TEST.has(property);
+    }
+    return false;
+}
+function titleOf(call) {
+    const first = call.getArguments()[0];
+    if (first === undefined)
+        return null;
+    if (Node.isStringLiteral(first) || Node.isNoSubstitutionTemplateLiteral(first)) {
+        return first.getLiteralText();
+    }
+    return null;
+}
+function findTestCalls(source, title) {
+    return source
+        .getDescendantsOfKind(SyntaxKind.CallExpression)
+        .filter(call => isTestCall(call) && titleOf(call) === title);
+}
+/**
+ * The static fragments of a template-literal title, in order.
+ *
+ * `` `…selects "${name}", then ${path} is opened` `` yields
+ * `['…selects "', '", then ', ' is opened']`.
+ */
+function templateQuasis(call) {
+    const first = call.getArguments()[0];
+    if (first === undefined || !Node.isTemplateExpression(first))
+        return null;
+    const parts = [first.getHead().getLiteralText()];
+    for (const span of first.getTemplateSpans()) {
+        parts.push(span.getLiteral().getLiteralText());
+    }
+    return parts;
+}
+/** Do the template's static fragments appear, in order, in this concrete title? */
+function templateMatches(quasis, title) {
+    let cursor = 0;
+    for (const part of quasis) {
+        if (part === '')
+            continue;
+        const index = title.indexOf(part, cursor);
+        if (index === -1)
+            return false;
+        cursor = index + part.length;
+    }
+    return true;
+}
+/**
+ * Find a loop-generated test whose runtime title would match.
+ *
+ * Real suites parameterise: one `test()` call inside a `for` produces N tests
+ * with computed titles. Reporting a plain "not found" for those reads as "your
+ * title is wrong" and sends someone hunting a typo that is not there — so this
+ * case gets its own status and its own explanation.
+ */
+function findParameterisedTest(source, title) {
+    for (const call of source.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+        if (!isTestCall(call))
+            continue;
+        const quasis = templateQuasis(call);
+        if (quasis !== null && templateMatches(quasis, title))
+            return call;
+    }
+    return null;
+}
+/**
+ * Add the tag to the test's options object, creating one if absent.
+ *
+ * Three shapes exist in the wild and all three must round-trip:
+ *   test('…', async () => {})                       → insert `{ tag: [...] }`
+ *   test('…', { tag: '@acceptance' }, async () => {}) → widen the string to an array
+ *   test('…', { tag: ['@smoke'] }, async () => {})    → push onto the array
+ */
+function addTagToCall(call, tag) {
+    const args = call.getArguments();
+    const options = args[1];
+    if (options !== undefined && Node.isObjectLiteralExpression(options)) {
+        const tagProperty = options.getProperty('tag');
+        if (tagProperty === undefined) {
+            options.addPropertyAssignment({ name: 'tag', initializer: `['${tag}']` });
+            return 'applied';
+        }
+        if (Node.isPropertyAssignment(tagProperty)) {
+            const initializer = tagProperty.getInitializer();
+            if (initializer !== undefined && Node.isArrayLiteralExpression(initializer)) {
+                const existing = initializer.getElements().map(e => e.getText().replace(/['"`]/g, ''));
+                if (existing.includes(tag))
+                    return 'already-tagged';
+                initializer.addElement(`'${tag}'`);
+                return 'applied';
+            }
+            if (initializer !== undefined &&
+                (Node.isStringLiteral(initializer) || Node.isNoSubstitutionTemplateLiteral(initializer))) {
+                const existing = initializer.getLiteralText();
+                if (existing === tag)
+                    return 'already-tagged';
+                tagProperty.setInitializer(`['${existing}', '${tag}']`);
+                return 'applied';
+            }
+        }
+        // A computed or spread tag value: append rather than rewrite, so we never
+        // discard an expression we do not understand.
+        options.addPropertyAssignment({ name: `/* atest */ tag`, initializer: `['${tag}']` });
+        return 'applied';
+    }
+    // No options object — insert one between the title and the body.
+    call.insertArgument(1, `{ tag: ['${tag}'] }`);
+    return 'applied';
+}
+function statementOf(call) {
+    return call.getFirstAncestorByKind(SyntaxKind.ExpressionStatement) ?? call;
+}
+/**
+ * Build the comment for insertion at `statement.getStart()`.
+ *
+ * That position sits AFTER the statement's existing leading whitespace, which
+ * drives both details here: the first line takes no indent prefix (the
+ * whitespace already in the file provides it), and the text ends with the
+ * indent so the statement it precedes keeps its own indentation instead of
+ * being left at column zero.
+ */
+function renderComment(lines, indent) {
+    const body = lines.map(line => `${indent} * ${line}`).join('\n');
+    return `/**\n${body}\n${indent} */\n${indent}`;
+}
+/**
+ * Apply the quarantine tag. Pure with respect to disk — the caller decides
+ * whether to write `result.after`, so a dry run and a real run take exactly
+ * the same code path.
+ */
+export function quarantineCodemod(sourceText, input) {
+    const tag = input.tag ?? QUARANTINE_TAG;
+    const project = new Project({ useInMemoryFileSystem: true });
+    const source = project.createSourceFile(input.file, sourceText, { overwrite: true });
+    let matches = findTestCalls(source, input.testTitle);
+    if (matches.length === 0) {
+        const parameterised = findParameterisedTest(source, input.testTitle);
+        if (parameterised !== null) {
+            const line = source.getLineAndColumnAtPos(parameterised.getStart()).line;
+            return {
+                status: 'parameterised',
+                file: input.file,
+                before: sourceText,
+                after: null,
+                line,
+                message: `"${input.testTitle}" is generated at runtime by the parameterised test at ` +
+                    `${input.file}:${line}. Its title does not exist as a literal in the source, and the ` +
+                    `single test() call there produces every case in the loop — tagging it would ` +
+                    `quarantine all of them, not just this one.\n` +
+                    `Narrow the loop's data, extract this case into its own test(), or fix it directly; ` +
+                    `quarantine is not the right lever here.`,
+            };
+        }
+        return {
+            status: 'not-found',
+            file: input.file,
+            before: sourceText,
+            after: null,
+            line: null,
+            message: `No test titled "${input.testTitle}" in ${input.file}.`,
+        };
+    }
+    if (matches.length > 1 && input.line !== undefined) {
+        const onLine = matches.filter(call => source.getLineAndColumnAtPos(call.getStart()).line === input.line);
+        if (onLine.length === 1)
+            matches = onLine;
+    }
+    if (matches.length > 1) {
+        return {
+            status: 'ambiguous',
+            file: input.file,
+            before: sourceText,
+            after: null,
+            line: null,
+            message: `${matches.length} tests in ${input.file} share the title "${input.testTitle}". ` +
+                'Pass the line number to disambiguate.',
+        };
+    }
+    const call = matches[0];
+    if (call === undefined) {
+        return {
+            status: 'not-found',
+            file: input.file,
+            before: sourceText,
+            after: null,
+            line: null,
+            message: `No test titled "${input.testTitle}" in ${input.file}.`,
+        };
+    }
+    const line = source.getLineAndColumnAtPos(call.getStart()).line;
+    const tagResult = addTagToCall(call, tag);
+    if (tagResult === 'already-tagged') {
+        return {
+            status: 'already-tagged',
+            file: input.file,
+            before: sourceText,
+            after: null,
+            line,
+            message: `"${input.testTitle}" already carries ${tag}.`,
+        };
+    }
+    // The comment is inserted LAST and by text position, because insertText
+    // invalidates every node handle obtained before it.
+    if (input.comment !== undefined && input.comment.length > 0) {
+        const statement = statementOf(call);
+        const start = statement.getStart();
+        const column = source.getLineAndColumnAtPos(start).column;
+        const indent = ' '.repeat(Math.max(0, column - 1));
+        source.insertText(start, renderComment(input.comment, indent));
+    }
+    return {
+        status: 'applied',
+        file: input.file,
+        before: sourceText,
+        after: source.getFullText(),
+        line,
+        message: `Tagged "${input.testTitle}" with ${tag}.`,
+    };
+}
+/** Remove the tag again — the release path. */
+export function releaseCodemod(sourceText, input) {
+    const tag = input.tag ?? QUARANTINE_TAG;
+    const project = new Project({ useInMemoryFileSystem: true });
+    const source = project.createSourceFile(input.file, sourceText, { overwrite: true });
+    const matches = findTestCalls(source, input.testTitle);
+    const call = matches[0];
+    if (call === undefined) {
+        return {
+            status: 'not-found',
+            file: input.file,
+            before: sourceText,
+            after: null,
+            line: null,
+            message: `No test titled "${input.testTitle}" in ${input.file}.`,
+        };
+    }
+    const line = source.getLineAndColumnAtPos(call.getStart()).line;
+    const options = call.getArguments()[1];
+    if (options === undefined || !Node.isObjectLiteralExpression(options)) {
+        return {
+            status: 'not-found',
+            file: input.file,
+            before: sourceText,
+            after: null,
+            line,
+            message: `"${input.testTitle}" has no tags to remove.`,
+        };
+    }
+    const tagProperty = options.getProperty('tag');
+    if (tagProperty === undefined || !Node.isPropertyAssignment(tagProperty)) {
+        return {
+            status: 'not-found',
+            file: input.file,
+            before: sourceText,
+            after: null,
+            line,
+            message: `"${input.testTitle}" has no tags to remove.`,
+        };
+    }
+    const initializer = tagProperty.getInitializer();
+    if (initializer === undefined || !Node.isArrayLiteralExpression(initializer)) {
+        return {
+            status: 'not-found',
+            file: input.file,
+            before: sourceText,
+            after: null,
+            line,
+            message: `"${input.testTitle}" does not carry ${tag}.`,
+        };
+    }
+    const index = initializer
+        .getElements()
+        .findIndex(e => e.getText().replace(/['"`]/g, '') === tag);
+    if (index === -1) {
+        return {
+            status: 'not-found',
+            file: input.file,
+            before: sourceText,
+            after: null,
+            line,
+            message: `"${input.testTitle}" does not carry ${tag}.`,
+        };
+    }
+    initializer.removeElement(index);
+    return {
+        status: 'applied',
+        file: input.file,
+        before: sourceText,
+        after: source.getFullText(),
+        line,
+        message: `Removed ${tag} from "${input.testTitle}".`,
+    };
+}
+//# sourceMappingURL=codemod.js.map

package/dist/codemod.js.map

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

package/dist/features.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Deterministic feature extraction.
+ *
+ * Every value here is measured from recorded attempts. Classification consumes
+ * these features; a model is invited only to write prose *after* the class has
+ * already been decided. That ordering is what makes a flake verdict
+ * reproducible and arguable rather than an opinion.
+ */
+import { type HistoricalAttempt } from '@aplaytest/core';
+export interface FlakeFeatures {
+    /** Share of this test's failures landing in its single worst project. */
+    readonly projectConcentration: number;
+    /**
+     * Point-biserial correlation between worker count and failing. −1..1.
+     *
+     * Reported for context, but NOT used as the load test: with a rare outcome
+     * its ceiling collapses. A test that never fails at one worker and fails a
+     * third of the time at eight — an unmistakable load dependency — scores only
+     * ~0.41, because a 20% base rate caps how high r can reach. Use
+     * `workerLoadDelta` to decide; use this to describe.
+     */
+    readonly workerCorrelation: number;
+    /**
+     * failureRate(above median workers) − failureRate(at or below).
+     *
+     * Directly measures "does load make this fail?", is bounded 0..1, and is
+     * interpretable without knowing what point-biserial means.
+     */
+    readonly workerLoadDelta: number;
+    /** False when every attempt ran at the same worker count — nothing to compare. */
+    readonly workerCountVaried: boolean;
+    /** max P(fail | X co-scheduled) / P(fail). >1 means co-scheduling hurts. */
+    readonly coScheduleLift: number;
+    readonly coScheduleSuspects: readonly string[];
+    /** Failing duration ÷ median passing duration. High implies waiting, then giving up. */
+    readonly durationRatio: number;
+    readonly failureKinds: Readonly<Record<string, number>>;
+    /** Failures begin sharply at one commit and persist — a regression, not flake. */
+    readonly commitBoundary: boolean;
+    /** Distinct commits observed; below 2 the boundary test cannot fire. */
+    readonly commitsObserved: number;
+    /** Failed then passed inside a single run at one commit. The strongest signal. */
+    readonly retryFlips: number;
+    readonly totalFailures: number;
+    readonly totalAttempts: number;
+}
+/** Pearson correlation; with a 0/1 second variable this is point-biserial. */
+export declare function correlation(xs: readonly number[], ys: readonly number[]): number;
+/**
+ * @param scoped   attempts for the (test, project) under analysis
+ * @param allProjects attempts for the same test across every project, used
+ *                 only for the concentration signal
+ */
+export declare function extractFeatures(scoped: readonly HistoricalAttempt[], allProjects?: readonly HistoricalAttempt[]): FlakeFeatures;
+//# sourceMappingURL=features.d.ts.map

package/dist/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../src/features.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,kFAAkF;IAClF,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,wFAAwF;IACxF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,kFAAkF;IAClF,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,wEAAwE;IACxE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AA0BD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAsBhF;AAkHD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,iBAAiB,EAAE,EACpC,WAAW,GAAE,SAAS,iBAAiB,EAAW,GACjD,aAAa,CAiDf"}

package/dist/features.js

@@ -0,0 +1,203 @@
+/**
+ * Deterministic feature extraction.
+ *
+ * Every value here is measured from recorded attempts. Classification consumes
+ * these features; a model is invited only to write prose *after* the class has
+ * already been decided. That ordering is what makes a flake verdict
+ * reproducible and arguable rather than an opinion.
+ */
+import { isFailure } from '@aplaytest/core';
+const EMPTY_FEATURES = {
+    projectConcentration: 0,
+    workerCorrelation: 0,
+    workerLoadDelta: 0,
+    workerCountVaried: false,
+    coScheduleLift: 1,
+    coScheduleSuspects: [],
+    durationRatio: 1,
+    failureKinds: {},
+    commitBoundary: false,
+    commitsObserved: 0,
+    retryFlips: 0,
+    totalFailures: 0,
+    totalAttempts: 0,
+};
+function median(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 1)
+        return sorted[mid] ?? 0;
+    return ((sorted[mid - 1] ?? 0) + (sorted[mid] ?? 0)) / 2;
+}
+/** Pearson correlation; with a 0/1 second variable this is point-biserial. */
+export function correlation(xs, ys) {
+    const n = Math.min(xs.length, ys.length);
+    if (n < 2)
+        return 0;
+    const meanX = xs.reduce((a, b) => a + b, 0) / n;
+    const meanY = ys.reduce((a, b) => a + b, 0) / n;
+    let covariance = 0;
+    let varianceX = 0;
+    let varianceY = 0;
+    for (let i = 0; i < n; i++) {
+        const dx = (xs[i] ?? 0) - meanX;
+        const dy = (ys[i] ?? 0) - meanY;
+        covariance += dx * dy;
+        varianceX += dx * dx;
+        varianceY += dy * dy;
+    }
+    // Zero variance means the variable never moved — no relationship is
+    // observable, which is honestly reported as 0 rather than NaN.
+    if (varianceX === 0 || varianceY === 0)
+        return 0;
+    return covariance / Math.sqrt(varianceX * varianceY);
+}
+/**
+ * Did failures start at a commit and stay?
+ *
+ * This is the guard that stops a genuine regression being filed as flake. It
+ * requires more than one commit in the window: with a single commit there is
+ * no boundary to detect, and treating that as a regression would silence every
+ * flake on a quiet branch.
+ */
+function detectCommitBoundary(ordered) {
+    const withCommit = ordered.filter(a => a.commit !== null && a.commit !== '');
+    const commits = new Set(withCommit.map(a => a.commit));
+    if (withCommit.length < 4 || commits.size < 2)
+        return false;
+    const firstFailureIndex = withCommit.findIndex(a => isFailure(a.outcome));
+    if (firstFailureIndex <= 0)
+        return false;
+    const before = withCommit.slice(0, firstFailureIndex);
+    const after = withCommit.slice(firstFailureIndex);
+    if (before.length === 0 || after.length < 2)
+        return false;
+    const beforeFailureRate = before.filter(a => isFailure(a.outcome)).length / before.length;
+    const afterFailureRate = after.filter(a => isFailure(a.outcome)).length / after.length;
+    return beforeFailureRate === 0 && afterFailureRate >= 0.7;
+}
+/** Failed then passed within the same run — non-determinism at one commit. */
+function countRetryFlips(attempts) {
+    const byRun = new Map();
+    for (const attempt of attempts) {
+        const existing = byRun.get(attempt.runId) ?? [];
+        existing.push(attempt);
+        byRun.set(attempt.runId, existing);
+    }
+    let flips = 0;
+    for (const group of byRun.values()) {
+        if (group.length < 2)
+            continue;
+        const sorted = [...group].sort((a, b) => a.retry - b.retry);
+        const failedEarly = sorted.slice(0, -1).some(a => isFailure(a.outcome));
+        const passedLast = sorted[sorted.length - 1]?.outcome === 'passed';
+        if (failedEarly && passedLast)
+            flips += 1;
+    }
+    return flips;
+}
+/**
+ * Compare the failure rate at the LOWEST observed worker count against the
+ * HIGHEST.
+ *
+ * Deliberately not a median split. Worker counts are heavily skewed in
+ * practice — a suite that mostly runs at full parallelism and occasionally in
+ * isolation puts the median at the top of the range, leaving the "high" group
+ * empty and the signal silently zero. Comparing the extremes answers the
+ * actual question ("does more parallelism make this fail?") and cannot be
+ * defeated by the shape of the distribution.
+ */
+function workerLoadSignal(attempts) {
+    const distinct = [...new Set(attempts.map(a => a.workers))].sort((a, b) => a - b);
+    if (distinct.length < 2)
+        return { delta: 0, varied: false };
+    const lowest = distinct[0];
+    const highest = distinct[distinct.length - 1];
+    if (lowest === undefined || highest === undefined)
+        return { delta: 0, varied: false };
+    const low = attempts.filter(a => a.workers === lowest);
+    const high = attempts.filter(a => a.workers === highest);
+    if (low.length === 0 || high.length === 0)
+        return { delta: 0, varied: false };
+    const rate = (group) => group.filter(a => isFailure(a.outcome)).length / group.length;
+    return { delta: rate(high) - rate(low), varied: true };
+}
+function coScheduleSignal(attempts) {
+    const total = attempts.length;
+    const failures = attempts.filter(a => isFailure(a.outcome)).length;
+    if (total === 0 || failures === 0)
+        return { lift: 1, suspects: [] };
+    const baseRate = failures / total;
+    const withPeer = new Map();
+    for (const attempt of attempts) {
+        for (const peer of attempt.coScheduled) {
+            const stat = withPeer.get(peer) ?? { runs: 0, failures: 0 };
+            stat.runs += 1;
+            if (isFailure(attempt.outcome))
+                stat.failures += 1;
+            withPeer.set(peer, stat);
+        }
+    }
+    let bestLift = 1;
+    const suspects = [];
+    for (const [peer, stat] of withPeer) {
+        // Require a few co-occurrences before believing a lift; two runs can make
+        // anything look causal.
+        if (stat.runs < 3)
+            continue;
+        const lift = stat.failures / stat.runs / baseRate;
+        if (lift > 1.5)
+            suspects.push(peer);
+        if (lift > bestLift)
+            bestLift = lift;
+    }
+    return { lift: bestLift, suspects: suspects.slice(0, 5) };
+}
+/**
+ * @param scoped   attempts for the (test, project) under analysis
+ * @param allProjects attempts for the same test across every project, used
+ *                 only for the concentration signal
+ */
+export function extractFeatures(scoped, allProjects = scoped) {
+    if (scoped.length === 0)
+        return EMPTY_FEATURES;
+    const ordered = [...scoped].sort((a, b) => Date.parse(a.startedAt) - Date.parse(b.startedAt));
+    const failures = ordered.filter(a => isFailure(a.outcome));
+    const passes = ordered.filter(a => a.outcome === 'passed');
+    const failuresByProject = new Map();
+    for (const attempt of allProjects.filter(a => isFailure(a.outcome))) {
+        failuresByProject.set(attempt.project, (failuresByProject.get(attempt.project) ?? 0) + 1);
+    }
+    const totalCrossProjectFailures = [...failuresByProject.values()].reduce((a, b) => a + b, 0);
+    const projectConcentration = totalCrossProjectFailures === 0
+        ? 0
+        : Math.max(...failuresByProject.values()) / totalCrossProjectFailures;
+    const failureKinds = {};
+    for (const attempt of failures) {
+        const kind = attempt.failureKind ?? 'unclassified';
+        failureKinds[kind] = (failureKinds[kind] ?? 0) + 1;
+    }
+    const medianPassDuration = median(passes.map(a => a.durationMs));
+    const medianFailDuration = median(failures.map(a => a.durationMs));
+    const durationRatio = medianPassDuration > 0 ? medianFailDuration / medianPassDuration : failures.length > 0 ? 2 : 1;
+    const { lift, suspects } = coScheduleSignal(ordered);
+    const load = workerLoadSignal(ordered);
+    return {
+        projectConcentration,
+        workerCorrelation: correlation(ordered.map(a => a.workers), ordered.map(a => (isFailure(a.outcome) ? 1 : 0))),
+        workerLoadDelta: load.delta,
+        workerCountVaried: load.varied,
+        coScheduleLift: lift,
+        coScheduleSuspects: suspects,
+        durationRatio,
+        failureKinds,
+        commitBoundary: detectCommitBoundary(ordered),
+        commitsObserved: new Set(ordered.map(a => a.commit).filter(c => c !== null && c !== '')).size,
+        retryFlips: countRetryFlips(ordered),
+        totalFailures: failures.length,
+        totalAttempts: ordered.length,
+    };
+}
+//# sourceMappingURL=features.js.map

package/dist/features.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @aplaytest/flaky — statistical flake detection and root-cause classification.
+ *
+ * Entirely deterministic. Every number here is measured from recorded
+ * attempts; no model is called anywhere in this package. A model may later be
+ * asked to phrase a verdict, never to reach one — a flake score that cannot be
+ * reproduced is a flake score nobody will act on.
+ */
+export { scoreTest, isFlaky, usableAttempts, wilsonLowerBound, DEFAULT_SCORE_CONFIG, } from './score.js';
+export type { FlakeScore, ScoreConfig, ScoreConfidence } from './score.js';
+export { extractFeatures, correlation } from './features.js';
+export type { FlakeFeatures } from './features.js';
+export { classifyFlake, shouldRetry, FLAKE_CLASSES } from './classify.js';
+export type { Classification, FlakeClass, Prescription } from './classify.js';
+export { analyzeTest, analyzeAll, groupByTestAndProject, DEFAULT_ANALYZE_CONFIG } from './analyze.js';
+export type { AnalyzeConfig, FlakyVerdict, FlakyReport } from './analyze.js';
+export { evaluateQuarantinePolicy, effectiveBudget, daysUntilExpiry, expiryFor, renderQuarantineComment, buildQuarantineEntry, DEFAULT_QUARANTINE_POLICY, DEFAULT_QUARANTINE_REASON, UNCLASSIFIED_CAUSE, } from './quarantine.js';
+export type { QuarantineEntry, QuarantinePolicy, PolicyResult, PolicyViolation, BuildQuarantineEntryInput, } from './quarantine.js';
+export { quarantineCodemod, releaseCodemod, QUARANTINE_TAG } from './codemod.js';
+export type { CodemodResult, CodemodStatus, QuarantineCodemodInput } from './codemod.js';
+export { bisect, interpret, DEFAULT_BISECT_OPTIONS } from './bisect.js';
+export type { BisectOptions, BisectResult, BisectProbe, BisectVerdict, BisectDimension } from './bisect.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtG,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE7E,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,SAAS,EACT,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}