ADR 0008: Hard public API replacement#
Context#
The 0.x surface encoded provider routes, mutable modes, source columns, and inconsistent errors.
Decision#
Version 1.0 replaces it entirely with a small capability-oriented API and no compatibility tree.
Alternatives#
A deprecation period, aliases, and adapters were considered.
Consequences#
Existing callers must rewrite imports and column use; the new design has no legacy constraints.
Rejected shortcuts#
Deprecated wrappers, old exception emulation, and duplicated column aliases are rejected.
Operational implications#
The major version and changelog communicate the break; wheel audits enforce the small surface.