Design notes

Goals: - deterministic tests - small public API surface - strict typing (mypy) - keep CLI thin, logic in modules