Know when your codebase drifts before it breaks

Not a linter. Not a scanner. A structural drift detector for teams using AI coding tools.

Cross-correlate signals from git, CI, dependencies, and deployments. Local-first, zero-config, evidence-based.

$ pip install evolution-engine
$ evo analyze .
 
Detected: git, pip, GitHub Actions, GitHub Releases
Phase 1: 247 events ingested (4 families)
Phase 2: 12 signals computed
Phase 3: Explanations generated
Phase 4: 3 patterns matched (44 universal)
Phase 5: Advisory generated
 
ADVISORY 2 significant changes detected
HIGH File dispersion spiked after CI failure (3.2x above baseline)
MEDIUM Dependency count grew 18% in 7 days
 
Saved to .evo/phase5/advisory.json

Why Evolution Engine

One command gives you visibility that no single tool can provide.

🔒

Local-first

Your code never leaves your machine. All analysis runs locally. Only opt-in telemetry (anonymous usage stats) ever phones home.

Zero-config

Auto-detects your tools from configs, lockfiles, and imports. No YAML, no dashboards, no setup. Just evo analyze .

📊

Evidence-based

Statistical deviation from your repo's own baseline. Modified z-scores, not arbitrary thresholds. Calibrated across 48 open-source repos.

🔗

Cross-signal

Correlates git + CI + deps + deploys. "CI fails after big dependency updates" is a pattern no single tool sees.

🔌

Extensible

Open adapter ecosystem. EE discovers available adapters for your tools, notifies you about updates, and auto-pulls community patterns.

How it works

Three steps. No configuration needed.

1

Install

One pip install. Works with Python 3.10+.

pip install evolution-engineCopied!
2

Analyze

Run in any git repo. EE auto-detects your tools and computes signals.

evo analyze .Copied!
3

Act

Read the advisory, investigate with AI, or set up the GitHub Action for continuous monitoring.

evo investigate .Copied!

Signal Families

EE ingests events from multiple data sources and computes deviation metrics for each.

Family Source Metrics Tier
Git Local git history files_touched, dispersion, change_locality, cochange_novelty Free
Dependency pip, npm, go, cargo, bundler lockfiles dependency_count, max_depth Free
CI GitHub Actions, GitLab CI, CircleCI run_duration, run_failed Pro
Deployment GitHub Releases, GitLab Releases release_cadence_hours, is_prerelease, asset_count Pro
Testing JUnit XML reports total_tests, failure_rate, skip_rate, suite_duration Pro
Coverage Cobertura XML reports line_rate, branch_rate Pro
Error Tracking Sentry event_count, user_count, is_unhandled Pro
Security Dependabot vulnerability_count, severity_score Pro
Monitoring Datadog, New Relic, Grafana error_rate, latency_p99 Planned
Incidents PagerDuty, OpsGenie incident_frequency, mttr Planned
Work Items Jira, Linear cycle_time, wip_count Planned

Adapter Catalog

Built-in adapters plus a growing plugin ecosystem. Each adapter reads from a data source and feeds it into the EE pipeline.

Git

Free
version_control

Local git history analysis — commits, file changes, co-change patterns.

pip

Free
dependency

Python dependency tracking from requirements.txt and Pipfile.lock.

npm

Free
dependency

Node.js dependency tracking from package-lock.json with depth analysis.

go modules

Free
dependency

Go module tracking from go.sum with dependency depth.

cargo

Free
dependency

Rust crate tracking from Cargo.lock with depth analysis.

bundler

Free
dependency

Ruby gem tracking from Gemfile.lock.

GitHub Actions

Pro
ci

CI pipeline monitoring — run duration, failure rates, workflow trends.

GitLab CI

Pro
ci

GitLab CI/CD pipeline monitoring and job analysis.

CircleCI

Pro
ci

CircleCI pipeline and workflow monitoring.

GitHub Releases

Pro
deployment

Release cadence tracking, pre-release detection, asset monitoring.

Sentry

Pro
error_tracking

Error tracking — event count, user impact, unhandled errors.

JUnit XML

Pro
testing

Test results — total tests, failure rate, skip rate, suite duration.

Cobertura XML

Pro
coverage

Code coverage — line rate, branch rate from Cobertura XML reports.

Dependabot

Pro
security

Reads security advisory data from repos that use Dependabot alerts.

Build Your Own

Community
any family

Create a custom adapter with our scaffold tool and step-by-step guide. Ship it as a pip package.

evo adapter new myapp --family ci
Explore the full adapter ecosystem →

Don't see your tool? We prioritize by community demand.

Simple, transparent pricing

Start free. Upgrade when you need CI, deployment, and security signals.

Free

$0
Forever free for git + dependency analysis
  • 11 built-in adapters (git + dependency)
  • 44 universal patterns
  • Local knowledge base
  • HTML reports
  • CI, deployment & security adapters
  • Git hooks & CI workflow actions
  • AI investigation & fix
  • Community KB sync
pip install evolution-engine