Refactor: scheduler: best practices for native_action_flags()

Rename native_action_flags() to pcmk__primitive_action_flags(), declare in
library-private header, and add a doxygen block.