Refactor: scheduler: best practices for group_action_flags()

Rename group_action_flags() to pcmk__group_action_flags(), declare in
library-private header, add a doxygen block, and improve variable names,
comments, and formatting.