Refactor: scheduler: best practices for pcmk__bundle_allocate()

Rename to pcmk__bundle_assign(), declare in library-private header,
and improve error checking, log messages, comments, and formatting.