common_reports
common-reports — domain-agnostic report build + deliver.
Two domains, one package (the agents_core “one package, many domains” shape):
builders/ fluent HtmlBuilder -> immutable Document tree -> Renderer views
(email / standalone-interactive / ghost). One canonical tree, many views.
emails/ EmailClient: read . monitor . write (SMTP / IMAP / Gmail-DWD).
Law (CONTEXT.md): contracts/ <- schemas/ <- domains/. contracts/ import
nothing but stdlib + pydantic. Heavy SDKs (plotly, google-api) are optional extras
loaded lazily — so import common_reports is light and never touches the network.
HtmlBuilder/col are eager (pure stdlib contracts). EmailClient and the
plotly-backed renderers are lazy (loaded on first attribute access).