Schema Overrides

This directory is reserved for rare driver-specific SQL that cannot be represented by schema/logical/*.toml yet.

It is not a normal schema source tree. Leave it with this README only until a real override exists.

Use overrides for:

Postgres-only indexes such as GIN/GiST expression indexes
views
custom trigger/function SQL
dialect-specific bootstrap details
temporary compatibility SQL while a domain is being moved to logical schema

Do not place ordinary table/column/index definitions here when the logical schema generator can express them.

Do not add .gitkeep placeholder directories. When an override is introduced, create only the directory and SQL file that are actually needed, then add that file to the relevant source manifest so compose_schema.sh check covers it.