Skip to main content

Drift Guard

Available in: Professional, Business, Enterprise tiers

CI helper to catch breaking changes in generated outputs (schema/API drift).

What It Does​

  • Compares generated output between --base and --head branches
  • Detects breaking changes in schemas, types, and APIs
  • Produces GitHub-formatted reports for PR comments

Prerequisites​

# PZG Pro license required

Generate & Run​

pzg-pro guard --schema=./prisma/schema.prisma --base=origin/main --head=HEAD --format=github

Command Options​

  • --schema <path> – Path to your Prisma schema (defaults to ./prisma/schema.prisma).
  • --base <ref> – Git reference to compare from (defaults to origin/main).
  • --head <ref> – Git reference to compare to (defaults to HEAD).
  • --format <github|json|text> – Output format (defaults to github).
  • --json, --text, --github – Shortcut flags for --format.
  • --strict – Treat warnings as breaking changes.
  • --allowed-break <identifier> – Whitelist specific breaking change identifiers (repeatable).
  • --help – Show usage and exit.

The command runs entirely on the command line—no custom scripts required. Make sure you execute it inside a git repo (so the base ref can be resolved) and with a valid PZG Pro license available (PZG_LICENSE_KEY).

Under the hood the CLI loads the DMMF for the base and head schemas, runs validateDriftFromDMMF, and prints a GitHub-friendly report. A non-zero exit code indicates breaking changes.

Git history

Fetch the full history (fetch-depth: 0) before running the command in CI so the base ref’s schema can be read.

Programmatic API​

Prefer to orchestrate things yourself? Import validateDriftFromDMMF from prisma-zod-generator/pro and feed it the base/head DMMF documents alongside your generator configuration. The CLI is thin sugar over that helper.

GitHub Actions​

name: PZG Drift Guard
on: [pull_request]
jobs:
  guard:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
        with: { version: 9 }
      - run: pnpm i --frozen-lockfile
      - run: pnpm tsx scripts/run-drift-guard.ts

In scripts you can check result.changes for the change identifiers used by --allowed-break (e.g., model.User.field_removed).

See Also​