Rego API: Provide a stable and well-documented Rego API

[charlieegan3]

This is particularly important for custom rule authors, including a clear list of available rules and helper functions. This is am important component of #979