feat(core): add afterRun hook

docs/pages/docs/plugins/configuration-hooks.mdx

@@ -139,3 +139,15 @@ auto.hooks.validateConfig.tapPromise("test", (name, options) => {
   }
 });
 ```
+
+## afterRun
+
+Happens after any command run.
+This is a great place to trigger post-actions.
+
+```ts
+auto.hooks.afterRun.tapPromise("afterCheck", async (config) => {
+    ...
+  }
+});
+```

packages/cli/src/run.ts

@@ -136,6 +136,8 @@ export async function execute(command: string, args: ApiOptions) {
     }
 
     process.exit(1);
+  } finally {
+    await auto.teardown();
   }
 }
 

packages/core/src/__tests__/auto.test.ts

@@ -1601,6 +1601,26 @@ describe("Auto", () => {
       expect(spy).not.toHaveBeenCalled();
     });
   });
+
+  describe("teardown", () => {
+    test("should throw when not initialized", async () => {
+      const auto = new Auto({ ...defaults, plugins: [] });
+      auto.logger = dummyLog();
+
+      await expect(auto.teardown()).rejects.not.toBeUndefined();
+    });
+
+    test("should call afterRun hooks", async () => {
+      const auto = new Auto({ ...defaults, plugins: [] });
+      auto.logger = dummyLog();
+
+      const afterRun = jest.fn();
+      auto.hooks.afterRun.tap("test", afterRun);
+      await auto.loadConfig();
+
+      await expect(auto.teardown()).resolves.toBeUndefined();
+    });
+  });
 });
 
 describe("hooks", () => {

packages/core/src/auto.ts

@@ -151,6 +151,8 @@ export interface IAutoHooks {
   validateConfig: ValidatePluginHook;
   /** Happens before anything is done. This is a great place to check for platform specific secrets. */
   beforeRun: AsyncSeriesHook<[LoadedAutoRc]>;
+  /** Happens after everything else is done. This is a great place to trigger post-actions. */
+  afterRun: AsyncSeriesHook<[LoadedAutoRc]>;
   /** Happens before `shipit` is run. This is a great way to throw an error if a token or key is not present. */
   beforeShipIt: AsyncSeriesHook<[BeforeShipitContext]>;
   /** Ran before the `changelog` command commits the new release notes to `CHANGELOG.md`. */
@@ -663,6 +665,18 @@ export default class Auto {
     return config;
   }
 
+  /**
+   * Gracefully teardown auto
+   */
+  async teardown() {
+    if (!this.config) {
+      throw this.createErrorMessage();
+    }
+
+    this.logger.verbose.success("Teardown `auto`");
+    await this.hooks.afterRun.promise(this.config);
+  }
+
   /** Determine the remote we have auth to push to. */
   private async getRemote(): Promise<string> {
     const [, configuredRemote = "origin"] = await on(

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

@@ -14,6 +14,7 @@ import { InteractiveInitHooks } from "../init";
 /** Make the hooks for "auto" */
 export const makeHooks = (): IAutoHooks => ({
   beforeRun: new AsyncSeriesHook(["config"]),
+  afterRun: new AsyncSeriesHook(["config"]),
   modifyConfig: new AsyncSeriesWaterfallHook(["config"]),
   validateConfig: new AsyncSeriesBailHook(["name", "options"]),
   beforeShipIt: new AsyncSeriesHook(["context"]),