Skip to content

Failure Types

GitWire categorizes CI failures into 9 types. 5 of these are auto-healable.

All Failure Types

TypeKeyAuto-Healable?Description
Lint Errorlint_errorESLint, Pylint, RuboCop violations
Type Errortype_errorTypeScript tsc, mypy, pyright errors
Format Errorformat_errorPrettier, Black, gofmt mismatches
Dependency Missingdependency_missingMissing npm packages, pip modules
Flaky Testtest_flakyTests that fail intermittently
Permanent Test Failuretest_permanentTests with genuine logic bugs
Build Errorbuild_errorCompilation, bundling, webpack errors
Infrastructure Errorinfra_errorOut of memory, network, service down
UnknownunknownCannot determine root cause

HEALABLE_TYPES

The @gitwire/core package exports the set of healable types:

js
import { HEALABLE_TYPES } from "@gitwire/core";

// Set {
//   'lint_error',
//   'type_error',
//   'test_flaky',
//   'dependency_missing',
//   'format_error'
// }

How Claude Determines the Type

Claude is prompted with the failure logs and asked to:

  1. Read the last 100 lines of the log
  2. Identify the specific error category
  3. Determine if it's auto-fixable
  4. Provide a root cause explanation

The diagnosis uses the ANTHROPIC_API_KEY configured in your environment.

Heal Status

StatusMeaning
pendingNewly detected, not yet processed
attemptedHealing in progress
healedFix PR opened successfully
failedHealing attempted but failed
skippedFailure type not healable

Constants Reference

See Failure Types Configuration for the full enum definitions.

Auto Patch PRs

Released under the MIT License.