v1.3.0 — AI-Powered Migration Explanation & Migrations Folder Support

Install

pip install --upgrade migradiff

What's New

AI-Powered Migration Explanation (--explain)

MigraDiff can now explain any migration in plain English — what
each change does, what risks it carries, and safer alternatives
for destructive operations.

pip install migradiff[ai]
migra --setup-ai
migra --explain postgres://db_a postgres://db_b

Powered by Claude Haiku (Anthropic). Bring your own API key —
no data is sent to MigraDiff servers. Works with --output json,
--from-file, --from-migrations-dir, and all existing flags.

Migrations Folder Input Mode (--from-migrations-dir)

Diff a directory of numbered migration files against a base
schema without requiring a live branch database.

migra --from-migrations-dir ./supabase/migrations \
  postgres://db_production

Supports Supabase timestamp format, Flyway versioned format,
and standard numeric prefixes. Files applied in correct numeric
sort order (9 before 10, not lexicographic).

Also in this release

• Naming clarification in README — CLI stays migra for backward
  compatibility, package is migradiff

Full changelog: https://github.com/migradiff/migra/blob/main/CHANGELOG.md

Upgrading

pip install --upgrade migradiff