selfcheck when evaluating supaschema against an existing database or after upgrading the engine.
The command extracts a live catalog, re-renders the modeled SQL, re-extracts it, and reports identity normalization gaps.
Use this when
- You are validating catalog normalization.
- A provider-specific object shape may need investigation.
- An upgrade should be checked against a real database.
- You need diagnostics for engine parity work.
Run it
selfcheck is a diagnostic tool, not a deployment gate. Review mismatches before deciding whether they matter.
Flags
url
PostgreSQL URL to extract. Defaults to normal database URL resolution.
Exit codes
Related
Inspect
Print the extracted model directly.
Fingerprint
Compare normalized model hashes.
Corpus
Run dirty-real regression coverage.
Support matrix
Check modeled object coverage.

