feat: add in beforeVersion lifecycle hook

docs/pages/docs/plugins/release-lifecycle-hooks.mdx

@@ -95,6 +95,19 @@ _Other examples:_
 
 - [all-contributors](../generated/all-contributors) - Make a commit for new contributions
 
+## beforeVersion
+
+Ran before the package has been versioned. Useful for iterating through the list of
+commits that are going to be included in the current release, and applying/overriding
+the version bump (major/minor/patch) labels applied to the PRs corresponding to those commits.
+
+```ts
+auto.hooks.beforeVersion.tapPromise(
+  "NPM",
+  async ({ dryRun, commits, from }) => {}
+);
+```
+
 ## version
 
 Increment the version the package.

packages/core/src/auto.ts

@@ -238,6 +238,17 @@ export interface IAutoHooks {
       }
     ]
   >;
+  /** Ran before the package has been versioned. */
+  beforeVersion: AsyncSeriesHook<
+    [
+      DryRunOption & {
+        /** Commit to start calculating the version from */
+        from: string;
+        /** The commits included in the release */
+        commits: IExtendedCommit[];
+      }
+    ]
+  >;
   /** Version the package. This is a good opportunity to `git tag` the release also.  */
   version: AsyncSeriesHook<
     [
@@ -1713,6 +1724,18 @@ export default class Auto {
       throw this.createErrorMessage();
     }
 
+    const lastRelease = options.from || (await this.git.getLatestRelease());
+    const commitsInRelease = await this.release.getCommitsInRelease(
+      lastRelease
+    );
+
+    this.logger.verbose.info("Calling before version hook");
+    await this.hooks.beforeVersion.promise({
+      dryRun: options.dryRun,
+      commits: commitsInRelease,
+      from: lastRelease,
+    });
+
     const bump = await this.getVersion(options);
 
     this.logger.log.success(
@@ -1724,11 +1747,6 @@ export default class Auto {
       return;
     }
 
-    const lastRelease = options.from || (await this.git.getLatestRelease());
-    const commitsInRelease = await this.release.getCommitsInRelease(
-      lastRelease
-    );
-
     await this.makeChangelog({
       ...options,
       quiet: undefined,

packages/core/src/utils/make-hooks.ts

@@ -29,6 +29,7 @@ export const makeHooks = (): IAutoHooks => ({
   getPreviousVersion: new AsyncSeriesBailHook(),
   getRepository: new AsyncSeriesBailHook(),
   prCheck: new AsyncSeriesBailHook(["prInformation"]),
+  beforeVersion: new AsyncSeriesHook(["context"]),
   version: new AsyncSeriesHook(["version"]),
   afterVersion: new AsyncSeriesHook(["context"]),
   publish: new AsyncSeriesHook(["version"]),