AutoMax
Guides

Insights and flaky management

The signals AutoMax collects, the scores it derives, and the actions those scores trigger.

What you'll learn

Which signals every run contributes, how flakiness, locator fragility, environment stability and suite health are computed, and which automations they trigger.

Signals

Durations, retries and outcomes per attempt, heal events, locator failures parsed from errors, visual diff ratios, API latency per endpoint, accessibility violations, environment, browser, worker and commit.

Scores

ScoreFormula (window of 30 runs)Threshold
Flakiness per scenario(passed on retry + outcome flips) / runsquarantine candidate at ≥ 0.2 with ≥ 10 runs
Locator fragility(failures + 0.5 × heals) / uses over 30 dayshot at ≥ 0.1 with ≥ 3 heals
Environment stability1 − env-attributed failures / runsnetwork, 5xx and timeouts across ≥ 3 unrelated scenarios in one run
Suite health0.5 × pass rate + 0.2 × (1 − mean flaky) + 0.2 × (1 − mean fragility) + 0.1 × duration budget7-run moving average
bun run automax insights compute -p demo-shop --window 30
bun run automax insights show -p demo-shop

Triggers

All triggers are CLI commands; the server's scheduler only spawns them. Nothing is applied without review.

Quarantine

A quarantined scenario keeps running but no longer blocks gates; its status is visible on the dashboard until the fix lands. Toggle it in the UI or with insights quarantine <fingerprint>.

Next steps

On this page