feat(withVersionHead): fetch git tags prior to trying to unshallow

Fetching tags is likely pointless when running on CI since it's assumed
that the repo has just been cloned (implying up-to-date tags). However,
when running locally (e.g. `--dry-run`), it's not uncommon that tags
are out of sync with origin, which is why we include this step.

src/git-utils.js

@@ -32,14 +32,13 @@ const getRoot = () => git(['rev-parse', '--show-toplevel']);
  * @param {string} tagName Tag name for which to retrieve the commit sha.
  * @return {string} The commit sha of the tag in parameter or `null`.
  */
-const getTagHead = async tagName => {
-  try {
-    return await git(['rev-list', '-1', tagName]);
-  } catch (err) {
-    debug(err);
-    return null;
-  }
-};
+const getTagHead = tagName =>
+  git(['rev-list', '-1', tagName], { reject: false });
+
+/**
+ * Fetch tags from the repository's origin.
+ */
+const fetchTags = () => git(['fetch', '--tags']);
 
 /**
  * Unshallow the git repository (retrieving every commit and tags).
@@ -52,5 +51,6 @@ module.exports = {
   getCommitFiles,
   getRoot,
   getTagHead,
+  fetchTags,
   unshallow,
 };

src/with-version-head.js

@@ -1,29 +1,42 @@
-const {
-  always,
-  curryN,
-  equals,
-  isNil,
-  pipeP,
-  tap,
-  unless,
-  when,
-} = require('ramda');
+const { curryN, isEmpty, pipeP, tap, unless, when } = require('ramda');
 
 const debug = require('debug')('semantic-release:monorepo');
 const gitTag = require('./version-to-git-tag');
-const { getTagHead, unshallow } = require('./git-utils');
+const { getTagHead, fetchTags, unshallow } = require('./git-utils');
+
+const debugTap = message => tap(curryN(2, debug)(message));
+const whenIsEmpty = when(isEmpty);
+const unlessIsEmpty = unless(isEmpty);
 
 /**
  * Attempt to find the git tag for the given tag name.
- * Will "unshallow" the repo and try again if not successful.
+ * If necessary, will fetch git tags and "unshallow".
  * Adapted from: https://github.com/semantic-release/npm/blob/cf039fdafda1a5ce43c2a5f033160cd46487f102/lib/get-version-head.js
  */
 const findTagHead = tagName =>
   pipeP(
     getTagHead,
-    when(isNil, pipeP(unshallow, always(tagName))),
-    when(equals(tagName), getTagHead),
-    unless(isNil, tap(curryN(2, debug)('Use tagHead: %s')))
+    whenIsEmpty(
+      // Fetching tags is likely pointless when running on CI since it's assumed
+      // that the repo has just been cloned (implying up-to-date tags).
+      // However, when running locally (e.g. `--dry-run`), it's not uncommon that
+      // tags are out of sync with origin, which is why we include this step.
+      pipeP(
+        fetchTags,
+        debugTap('Unable to find tagHead. Fetching tags and re-trying.'),
+        () => getTagHead(tagName)
+      )
+    ),
+    whenIsEmpty(
+      // Unshallowing is likely only relevant on CI, where using a shallow clone
+      // is more performant than downloading the entire repo.
+      pipeP(
+        unshallow,
+        debugTap('Unable to find tagHead. Unshallowing and re-trying.'),
+        () => getTagHead(tagName)
+      )
+    ),
+    unlessIsEmpty(debugTap('Use tagHead: %o'))
   )(tagName);
 
 /**
@@ -36,8 +49,8 @@ const findTagHead = tagName =>
  * 2. We can use `semantic-release`'s fallback strategy, searching for a matching git tag,
  *    but we must update the git tag format to be compatible with the monorepo workflow.
  **/
-const withVersionHead = plugin => async (pluginConfig, options) => {
-  const release = await plugin(pluginConfig, options);
+const withVersionHead = plugin => async (pluginConfig, config) => {
+  const release = await plugin(pluginConfig, config);
 
   if (release) {
     return {