Refactor: libpacemaker: best practices when simulating transition

Rename run_simulation() to pcmk__simulate_transition(), move declaration to
pcmki_simulate.h with a doxygen block, and improve comments, formatting, and
variable names.