Skip to content

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Added

  • 📊 New Detectors for enhanced drift detection:
  • JensenShannonDetector — symmetric, bounded (0-1) divergence measure
  • AndersonDarlingDetector — tail-sensitive hypothesis test
  • CramerVonMisesDetector — overall distributional shape test
  • 📧 Email Alerting (EmailAlerter):
  • SMTP-based email notifications with HTML formatting
  • Throttling, custom subjects, and extra recipients support
  • Both plain text and rich HTML email templates
  • 📈 MLflow Integration (MLflowDriftTracker):
  • Log drift metrics and reports to MLflow experiments
  • Track drift over time with MLflow tracking
  • 📖 Updated detector guide with comparison table and decision tree
  • 📖 Email integration documentation

0.3.0 - 2026-02-09

Added

  • 🔍 Drift Explain module for understanding drift:
  • DriftExplainer class with detailed statistical analysis
  • Mean shift (absolute and percentage)
  • Standard deviation change
  • Quantile differences (configurable Q25, Q50, Q75)
  • Min/Max range changes
  • 📊 Visualization support:
  • DriftVisualizer class for histogram overlays
  • plot_feature() for single feature visualization
  • plot_all() for multi-feature grid
  • save() for exporting to PNG/PDF/SVG
  • 📓 Jupyter notebook tutorial for Colab
  • [viz] optional dependency for matplotlib

Changed

  • Export DriftExplainer and DriftVisualizer at package level

0.2.0 - 2026-02-04

Added

  • 🎉 First public release on PyPI
  • CLI with Typer/Rich (driftwatch check, driftwatch report)
  • FastAPI DriftMiddleware for API monitoring
  • Slack alerting via SlackAlerter
  • Wasserstein distance detector
  • MkDocs Material documentation site
  • GitHub Pages deployment
  • PyPI publishing workflow
  • Integration tests

Changed

  • Improved type hints across the codebase (now 100% typed)
  • Refactored detector registry to separate numerical and categorical detectors
  • Updated default thresholds for better out-of-the-box performance

Fixed

  • Fixed missing typer, rich, and httpx optional dependencies
  • Fixed flakey tests in registry and alerting modules

0.1.0 - 2026-02-03

Added

  • 🎉 Initial release
  • Core Monitor class for drift detection
  • DriftReport for structured results
  • Statistical tests:
  • Kolmogorov-Smirnov (KS) test
  • Population Stability Index (PSI)
  • Wasserstein distance
  • Chi-squared test
  • Simulation module for testing