fix: use config_root for env._.path

[jdx]

The behavior and docs for env..path predates config_root as well as config files outside of the root like .config/mise.toml. This has been a bug and should have been fixed when support was added for files outside the project root but was not. This change modifies the behavior of env..path to behave the same as other parts of mise that are relative to config_root and not the parent directory of the config file making mise behave consistently in regards to relative paths.

Fixes #6203

BREAKING CHANGE: env..path directories are now relative to the config_root and not the parent directory of the config file. This only affects config files that use env..path that are outside the config_root (e.g.: .config/mise.toml will use . and not .config like before). To retain compatibility with earlier mise releases, be explicit with env._.path = "{{config_root}}/bin" which will behave the same in old and new releases.

[Copilot]

Pull Request Overview

This PR fixes path resolution inconsistency in environment directives by ensuring env._.path uses the same config_root logic as other directives. The main change extracts the config_root function into its own module with caching and updates all references to use the centralized implementation.

• Moves config_root function to dedicated module with caching for performance
• Updates env._.path resolution to use config_root instead of simple parent directory
• Adds comprehensive test coverage and documentation for config root behavior

Reviewed Changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/config/config_file/config_root.rs	New module containing extracted config_root function with caching
src/config/env_directive/mod.rs	Updates path resolution to use config_root for consistency
src/config/config_file/mod.rs	Removes old config_root function and updates references
src/config/config_file/mise_toml.rs	Updates import to use new config_root module
src/config/settings.rs	Adds cache reset when settings are reset
e2e/env/test_env_path_resolution	New test demonstrating path resolution behavior
docs/environments/index.md	Documents config_root concept and updated path resolution

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

These closures use .unwrap() which will panic if any parent directory doesn't exist. Consider using proper error handling or returning a Result type to handle cases where the path hierarchy is incomplete.

Suggested change

	let parent_path = || path.parent().unwrap().to_path_buf();
	let grandparent_path = || parent_path().parent().unwrap().to_path_buf();
	let great_grandparent_path = || grandparent_path().parent().unwrap().to_path_buf();
	let great_great_grandparent_path = || great_grandparent_path().parent().unwrap().to_path_buf();
	let is_mise_dir = |d: &str| d == "mise" || d == ".mise";
	let is_config_filename = |f: &str| {
	f == "config.toml" || f == "config.local.toml" || regex!(r"config\..+\.toml").is_match(f)
	};
	if parent == "conf.d" && is_mise_dir(grandparent) {
	if great_grandparent == ".config" {
	let out = great_great_grandparent_path();
	CONFIG_ROOT_CACHE.lock().unwrap().insert(path, out.clone());
	return out;
	} else {
	let out = great_grandparent_path();
	CONFIG_ROOT_CACHE.lock().unwrap().insert(path, out.clone());
	return out;
	}
	} else if is_mise_dir(parent) && is_config_filename(filename) {
	if grandparent == ".config" {
	let out = great_grandparent_path();
	CONFIG_ROOT_CACHE.lock().unwrap().insert(path, out.clone());
	return out;
	} else {
	let out = grandparent_path();
	CONFIG_ROOT_CACHE.lock().unwrap().insert(path, out.clone());
	return out;
	let parent_path = || path.parent().map(|p| p.to_path_buf());
	let grandparent_path = || parent_path().and_then(|p| p.parent().map(|gp| gp.to_path_buf()));
	let great_grandparent_path = || grandparent_path().and_then(|p| p.parent().map(|ggp| ggp.to_path_buf()));
	let great_great_grandparent_path = || great_grandparent_path().and_then(|p| p.parent().map(|gggp| gggp.to_path_buf()));
	let is_mise_dir = |d: &str| d == "mise" || d == ".mise";
	let is_config_filename = |f: &str| {
	f == "config.toml" || f == "config.local.toml" || regex!(r"config\..+\.toml").is_match(f)
	};
	if parent == "conf.d" && is_mise_dir(grandparent) {
	if great_grandparent == ".config" {
	if let Some(out) = great_great_grandparent_path() {
	CONFIG_ROOT_CACHE.lock().unwrap().insert(path, out.clone());
	return out;
	} else {
	// fallback: return original path if hierarchy is incomplete
	return path.clone();
	}
	} else {
	if let Some(out) = great_grandparent_path() {
	CONFIG_ROOT_CACHE.lock().unwrap().insert(path, out.clone());
	return out;
	} else {
	return path.clone();
	}
	}
	} else if is_mise_dir(parent) && is_config_filename(filename) {
	if grandparent == ".config" {
	if let Some(out) = great_grandparent_path() {
	CONFIG_ROOT_CACHE.lock().unwrap().insert(path, out.clone());
	return out;
	} else {
	return path.clone();
	}
	} else {
	if let Some(out) = grandparent_path() {
	CONFIG_ROOT_CACHE.lock().unwrap().insert(path, out.clone());
	return out;
	} else {
	return path.clone();
	}

[Copilot]

[nitpick] The cache insertion logic is duplicated across multiple branches. Consider extracting this into a helper function that takes the computed path and handles both the cache insertion and return.

[github-actions]

Hyperfine Performance

mise x -- echo

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.9.2 x -- echo	18.4 ± 0.3	17.9	22.1	1.00 ± 0.02
mise x -- echo	18.4 ± 0.2	17.9	20.0	1.00

mise env

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.9.2 env	17.8 ± 0.2	17.3	18.5	1.00
mise env	18.2 ± 0.6	17.4	22.0	1.02 ± 0.03

mise hook-env

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.9.2 hook-env	17.7 ± 0.4	17.1	18.9	1.01 ± 0.04
mise hook-env	17.6 ± 0.6	17.1	25.4	1.00

mise ls

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.9.2 ls	15.9 ± 0.2	15.5	17.5	1.00
mise ls	15.9 ± 0.2	15.4	18.0	1.01 ± 0.02

xtasks/test/perf

Command	mise-2025.9.2	mise	Variance
install (cached)	163ms	✅ 100ms	+63%
ls (cached)	61ms	60ms	+1%
bin-paths (cached)	65ms	64ms	+1%
task-ls (cached)	478ms	465ms	+2%

✅ Performance improvement: install cached is 63%