Reorder plugin event definitions chronologically

Arrange events.rb by actual firing order so the file reads as a
timeline of bundler's lifecycle: Gemfile eval, install-all bracket
(with per-gem fetch, git fetch, and install nested inside), then
require-all bracket (with per-gem require nested inside).

Also clarify the git fetch hook docstrings: the hook fires around
both remote fetch and checkout, not only fetch.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: hsbt

bundler/lib/bundler/plugin/events.rb

@@ -31,19 +31,22 @@ def self.defined_event?(event)
       end
 
       # @!parse
-      #   A hook called before each individual gem is installed
-      #   Includes a Bundler::ParallelInstaller::SpecInstallation.
-      #   No state, error, post_install_message will be present as nothing has installed yet
-      #   GEM_BEFORE_INSTALL = "before-install"
-      define :GEM_BEFORE_INSTALL, "before-install"
+      #   A hook called before the Gemfile is evaluated
+      #   Includes the Gemfile path and the Lockfile path
+      #   GEM_BEFORE_EVAL = "before-eval"
+      define :GEM_BEFORE_EVAL, "before-eval"
 
       # @!parse
-      #   A hook called after each individual gem is installed
-      #   Includes a Bundler::ParallelInstaller::SpecInstallation.
-      #     - If state is failed, an error will be present.
-      #     - If state is success, a post_install_message may be present.
-      #   GEM_AFTER_INSTALL = "after-install"
-      define :GEM_AFTER_INSTALL,  "after-install"
+      #   A hook called after the Gemfile is evaluated
+      #   Includes a Bundler::Definition
+      #   GEM_AFTER_EVAL = "after-eval"
+      define :GEM_AFTER_EVAL, "after-eval"
+
+      # @!parse
+      #   A hook called before any gems install
+      #   Includes an Array of Bundler::Dependency objects
+      #   GEM_BEFORE_INSTALL_ALL = "before-install-all"
+      define :GEM_BEFORE_INSTALL_ALL, "before-install-all"
 
       # @!parse
       #   A hook called before each individual gem is downloaded from a remote source.
@@ -58,29 +61,44 @@ def self.defined_event?(event)
       define :GEM_AFTER_FETCH, "after-fetch"
 
       # @!parse
-      #   A hook called before a git source is fetched.
+      #   A hook called before a git source is fetched or checked out.
       #   Includes a Bundler::Source::Git reference.
       #   GIT_BEFORE_FETCH = "before-git-fetch"
       define :GIT_BEFORE_FETCH, "before-git-fetch"
 
       # @!parse
-      #   A hook called after a git source is fetched.
+      #   A hook called after a git source is fetched or checked out.
       #   Includes a Bundler::Source::Git reference.
       #   GIT_AFTER_FETCH = "after-git-fetch"
       define :GIT_AFTER_FETCH, "after-git-fetch"
 
       # @!parse
-      #   A hook called before any gems install
-      #   Includes an Array of Bundler::Dependency objects
-      #   GEM_BEFORE_INSTALL_ALL = "before-install-all"
-      define :GEM_BEFORE_INSTALL_ALL, "before-install-all"
+      #   A hook called before each individual gem is installed
+      #   Includes a Bundler::ParallelInstaller::SpecInstallation.
+      #   No state, error, post_install_message will be present as nothing has installed yet
+      #   GEM_BEFORE_INSTALL = "before-install"
+      define :GEM_BEFORE_INSTALL, "before-install"
+
+      # @!parse
+      #   A hook called after each individual gem is installed
+      #   Includes a Bundler::ParallelInstaller::SpecInstallation.
+      #     - If state is failed, an error will be present.
+      #     - If state is success, a post_install_message may be present.
+      #   GEM_AFTER_INSTALL = "after-install"
+      define :GEM_AFTER_INSTALL,  "after-install"
 
       # @!parse
       #   A hook called after any gems install
       #   Includes an Array of Bundler::Dependency objects
       #   GEM_AFTER_INSTALL_ALL = "after-install-all"
       define :GEM_AFTER_INSTALL_ALL,  "after-install-all"
 
+      # @!parse
+      #   A hook called before any gems require
+      #   Includes an Array of Bundler::Dependency objects.
+      #   GEM_BEFORE_REQUIRE_ALL = "before-require-all"
+      define :GEM_BEFORE_REQUIRE_ALL, "before-require-all"
+
       # @!parse
       #   A hook called before each individual gem is required
       #   Includes a Bundler::Dependency.
@@ -93,29 +111,11 @@ def self.defined_event?(event)
       #   GEM_AFTER_REQUIRE = "after-require"
       define :GEM_AFTER_REQUIRE,  "after-require"
 
-      # @!parse
-      #   A hook called before any gems require
-      #   Includes an Array of Bundler::Dependency objects.
-      #   GEM_BEFORE_REQUIRE_ALL = "before-require-all"
-      define :GEM_BEFORE_REQUIRE_ALL, "before-require-all"
-
       # @!parse
       #   A hook called after all gems required
       #   Includes an Array of Bundler::Dependency objects.
       #   GEM_AFTER_REQUIRE_ALL = "after-require-all"
-      define :GEM_AFTER_REQUIRE_ALL,  "after-require-all"
-
-      # @!parse
-      #   A hook called before the Gemfile is evaluated
-      #   Includes the Gemfile path and the Lockfile path
-      #   GEM_BEFORE_EVAL = "before-eval"
-      define :GEM_BEFORE_EVAL, "before-eval"
-
-      # @!parse
-      #   A hook called after the Gemfile is evaluated
-      #   Includes a Bundler::Definition
-      #   GEM_AFTER_EVAL = "after-eval"
-      define :GEM_AFTER_EVAL, "after-eval"
+      define :GEM_AFTER_REQUIRE_ALL, "after-require-all"
     end
   end
 end