Refactor: scheduler: best practices for is_recurring_action()

Rename to pcmk__action_is_recurring(), move from pcmk_sched_remote.c to
pcmk_sched_recurring.c, add a doxygen block, and return bool instead of int.