Refactor: libpacemaker: expose fail count injection within library

Rename update_failcounts() to pcmk__inject_failcount() and expose within
library, to prepare for moving stuff around.

Also add a doxygen block.