Refactor: best practices for pcmk__bundle_action_flags()

Declare in library-private header, add a doxygen block, improve error checking,
and avoid an unnecessary variable.