plugins/vcs/github: ensureNewPull - docs, return the promise & tests