view release on metacpan or  search on metacpan

docs/adr/0005-native-rdb-introspection-and-model-shape.md  view on Meta::CPAN

- All Firebird introspection reads `rdb$*` directly; do not reach for DBI
  metadata methods to "simplify" a helper — it would lose the detail the diff
  depends on.
- The per-helper subdir layout matches every other DBIO driver
  (`Introspect/{Tables,Columns,Indexes,Uniques,ForeignKeys}`); new
  introspected facts go in the matching helper.
- `THE INTROSPECTED MODEL` POD is the contract; any change to a section's shape
  must be made there and in Diff/Generate consumers together.
- `NAME_lc` is set for the whole `_build_model`; helpers may rely on lower-case
  `rdb$` keys and must not also case-fold result-column names themselves.
- The constraint/index split must be preserved: `Uniques` owns constraints,
  `Indexes` excludes constraint-backed indexes.