Public API surface: stable exports

[brothercorvo]

Goals:

• Define minimal exports in init.py.
• Docstrings with param and return types.
  Acceptance:
• from package import * exposes only documented classes.