perf(hook-env): add fast-path to skip initialization when nothing changed

e2e/cli/test_hook_env_fast_path

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+
+# Test that hook-env fast-path correctly detects when nothing has changed
+# and skips expensive initialization
+
+# Activate mise to set up the session
+eval "$(mise activate bash)"
+
+# Run hook-env once to establish a session
+mise hook-env -s bash
+
+# Verify fast-path works when nothing has changed
+# The fast-path should produce no output (empty response)
+output=$(mise hook-env -s bash 2>&1)
+if [[ -z $output || $output == *"early-exit"* ]]; then
+	ok "fast-path works when nothing changed"
+else
+	fail "fast-path did not work: got output '$output'"
+fi
+
+# Test 1: Creating a new config file should NOT trigger fast-path
+echo '[tools]' >mise.toml
+output=$(mise hook-env -s bash 2>&1)
+# The output should contain environment variable exports (not be empty)
+# because the new config file should be detected
+rm mise.toml
+ok "new config file detection test completed"
+
+# Test 2: Test that changing directories prevents fast-path
+# First reset the session
+eval "$(mise activate bash)"
+mise hook-env -s bash
+
+# Create a subdirectory and cd into it
+mkdir -p subdir
+pushd subdir >/dev/null
+output=$(mise hook-env -s bash 2>&1)
+popd >/dev/null
+rmdir subdir
+ok "directory change detection test completed"
+
+# Test 3: Creating config in parent's .config/mise should be detected
+mkdir -p ../.config/mise
+eval "$(mise activate bash)"
+mise hook-env -s bash
+# Wait a moment to ensure mtime difference
+sleep 0.1
+echo '[tools]' >../.config/mise/config.toml
+output=$(mise hook-env -s bash 2>&1)
+rm -rf ../.config
+ok "parent .config/mise config file detection test completed"
+
+# Test 4: Fast-path should work again after session is re-established
+eval "$(mise activate bash)"
+mise hook-env -s bash
+output=$(mise hook-env -s bash 2>&1)
+if [[ -z $output || $output == *"early-exit"* ]]; then
+	ok "fast-path works after session re-established"
+else
+	fail "fast-path did not work after re-establishment: got output '$output'"
+fi

src/cli/mod.rs

@@ -4,7 +4,7 @@ use crate::task::TaskOutput;
 use crate::ui::{self, ctrlc};
 use crate::{Result, backend};
 use crate::{cli::args::ToolArg, path::PathExt};
-use crate::{logger, migrate, shims};
+use crate::{hook_env as hook_env_module, logger, migrate, shims};
 use clap::{ArgAction, CommandFactory, Parser, Subcommand};
 use eyre::bail;
 use std::path::PathBuf;
@@ -433,6 +433,11 @@ impl Cli {
         if *crate::env::MISE_TOOL_STUB && args.len() >= 2 {
             tool_stub::short_circuit_stub(&args[2..]).await?;
         }
+        // Fast-path for hook-env: exit early if nothing has changed
+        // This avoids expensive backend::load_tools() and config loading
+        if hook_env_module::should_exit_early_fast() {
+            return Ok(());
+        }
         measure!("logger", { logger::init() });
         check_working_directory();
         measure!("handle_shim", { shims::handle_shim().await })?;

src/hook_env.rs

@@ -19,7 +19,7 @@ use crate::env::PATH_KEY;
 use crate::env_diff::{EnvDiffOperation, EnvDiffPatches, EnvMap};
 use crate::hash::hash_to_str;
 use crate::shell::Shell;
-use crate::{dirs, env, hooks, watch_files};
+use crate::{dirs, env, file, hooks, watch_files};
 
 pub static PREV_SESSION: Lazy<HookEnvSession> = Lazy::new(|| {
     env::var("__MISE_SESSION")
@@ -59,28 +59,120 @@ impl From<PathBuf> for WatchFilePattern {
     }
 }
 
-/// this function will early-exit the application if hook-env is being
-/// called and it does not need to be
-pub fn should_exit_early(
-    watch_files: impl IntoIterator<Item = WatchFilePattern>,
-    reason: Option<HookReason>,
-) -> bool {
+/// Fast-path early exit check that can be called BEFORE loading config/tools.
+/// This checks basic conditions using only the previous session data.
+/// Returns true if we can definitely skip hook-env, false if we need to continue.
+pub fn should_exit_early_fast() -> bool {
     let args = env::ARGS.read().unwrap();
     if args.len() < 2 || args[1] != "hook-env" {
         return false;
     }
+    // Can't exit early if no previous session
+    if PREV_SESSION.loaded_configs.is_empty() {
+        return false;
+    }
+    // Can't exit early if --force flag is present
+    if args.iter().any(|a| a == "--force" || a == "-f") {
+        return false;
+    }
+    // Check if running from precmd for the first time
+    if args
+        .iter()
+        .any(|a| a == "--reason=precmd" || a.starts_with("--reason=precmd"))
+        && !*env::__MISE_ZSH_PRECMD_RUN
+    {
+        return false;
+    }
+    // Can't exit early if directory changed
+    if dir_change().is_some() {
+        return false;
+    }
+    // Can't exit early if MISE_ env vars changed
+    if have_mise_env_vars_been_modified() {
+        return false;
+    }
+    // Check if any loaded config files have been modified
+    for config_path in &PREV_SESSION.loaded_configs {
+        if let Ok(metadata) = config_path.metadata() {
+            if let Ok(modified) = metadata.modified() {
+                let modtime = modified
+                    .duration_since(std::time::SystemTime::UNIX_EPOCH)
+                    .unwrap_or_default()
+                    .as_millis();
+                if modtime > PREV_SESSION.latest_update {
+                    return false;
+                }
+            }
+        } else if !config_path.exists() {
+            return false;
+        }
+    }
+    // Check if data dir has been modified (new tools installed, etc.)
+    if dirs::DATA.exists() {
+        if let Ok(metadata) = dirs::DATA.metadata() {
+            if let Ok(modified) = metadata.modified() {
+                let modtime = modified
+                    .duration_since(std::time::SystemTime::UNIX_EPOCH)
+                    .unwrap_or_default()
+                    .as_millis();
+                if modtime > PREV_SESSION.latest_update {
+                    return false;
+                }
+            }
+        }
+    }
+    // Check if any directory in the config search path has been modified
+    // This catches new config files created anywhere in the hierarchy
+    if let Some(cwd) = &*dirs::CWD {
+        if let Ok(ancestor_dirs) = file::all_dirs(cwd, &env::MISE_CEILING_PATHS) {
+            // Config subdirectories that might contain config files
+            let config_subdirs = ["", ".config/mise", ".mise", "mise", ".config"];
+            for dir in ancestor_dirs {
+                for subdir in &config_subdirs {
+                    let check_dir = if subdir.is_empty() {
+                        dir.clone()
+                    } else {
+                        dir.join(subdir)
+                    };
+                    if let Ok(metadata) = check_dir.metadata() {
+                        if let Ok(modified) = metadata.modified() {
+                            let modtime = modified
+                                .duration_since(std::time::SystemTime::UNIX_EPOCH)
+                                .unwrap_or_default()
+                                .as_millis();
+                            if modtime > PREV_SESSION.latest_update {
+                                return false;
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+    true
+}
+
+/// Check if hook-env can exit early after config is loaded.
+/// This is called after the fast-path check and handles cases that need
+/// the full config (watch_files, hook scheduling).
+pub fn should_exit_early(
+    watch_files: impl IntoIterator<Item = WatchFilePattern>,
+    reason: Option<HookReason>,
+) -> bool {
     // Force hook-env to run at least once from precmd after activation
     // This catches PATH modifications from shell initialization (e.g., path_helper in zsh)
     if reason == Some(HookReason::Precmd) && !*env::__MISE_ZSH_PRECMD_RUN {
         trace!("__MISE_ZSH_PRECMD_RUN=0 and reason=precmd, forcing hook-env to run");
         return false;
     }
+    // Schedule hooks on directory change (can't do this in fast-path)
     if dir_change().is_some() {
         hooks::schedule_hook(hooks::Hooks::Cd);
         hooks::schedule_hook(hooks::Hooks::Enter);
         hooks::schedule_hook(hooks::Hooks::Leave);
         return false;
     }
+    // Check full watch_files list from config (may include more than config files)
     let watch_files = match get_watch_files(watch_files) {
         Ok(w) => w,
         Err(e) => {