some type signatures
cli, report & raw options cleanups