feat(lockfile): add env field and local lockfile support

[jdx]

Summary

• Add env field to LockfileTool for environment-specific version tracking
• Environment configs (e.g., mise.test.toml) write entries with env = ["test"] to the same mise.lock
• Local configs (mise.local.toml) use separate mise.local.lock file (intended to be gitignored)
• Env-aware resolution prioritizes: env-specific match → base entry → fallback
• Add --local flag to mise lock command for explicit local lockfile generation

Test plan

• Added e2e/lockfile/test_lockfile_env - verifies env field is written when using MISE_ENV
• Added e2e/lockfile/test_lockfile_env_resolution - verifies correct version is selected based on MISE_ENV
• Added e2e/lockfile/test_lockfile_local - verifies separation of local vs base lockfiles
• All existing lockfile tests pass without regressions

🤖 Generated with Claude Code

---

Note

Adds env-aware lockfile entries and separate local lockfile support, introduces --local to mise lock, and updates docs, tests, completions, and CI refs.

• Lockfile (core):
  • Add env field to LockfileTool and env-aware resolution/prioritization in get_locked_version.
  • Support separate mise.local.lock with per-config lockfile path resolution and merging logic.
  • Preserve/merge env-specific entries; dedupe by version+options; cache lockfile reads.
• CLI (mise lock):
  • New --local flag to target mise.local.lock.
  • Determine lockfile path from config root; include platforms from target lockfile; collect tools from all config files.
• Docs/UX:
  • Update docs/cli/lock.md, man/man1/mise.1, and mise.usage.kdl with --local and examples.
  • Update Fig completion (xtasks/fig/src/mise.ts) to include --local.
• Tests:
  • Add e2e tests for env tagging, env resolution, and local lockfile separation.
  • Adjust lock CLI test to accept dynamic "Lockfile written to" path.
• CI:
  • Bump container digests and docker/metadata-action refs in workflows.

^{Written by Cursor Bugbot for commit 742525d. This will update automatically on new commits. Configure here.}

[Copilot]

Pull request overview

This PR adds environment-specific version tracking and local lockfile support to mise. When using environment-specific configs (e.g., mise.test.toml), tools are now marked with an env field in the lockfile. Local configs (mise.local.toml) use a separate mise.local.lock file to avoid committing local-only tools. Version resolution prioritizes environment-specific entries when MISE_ENV is set, falling back to base entries.

Key Changes

• Added env: Option<Vec<String>> field to LockfileTool for tracking which environments use a tool version
• Implemented lockfile_path_for_config() to determine lockfile path (main vs local) based on config filename
• Enhanced get_locked_version() with environment-aware resolution logic
• Added --local flag to mise lock command

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
src/lockfile.rs	Core implementation: added env field, config-to-lockfile mapping, env-aware resolution, and local lockfile support
src/cli/lock.rs	Added --local flag to target mise.local.lock instead of mise.lock
e2e/lockfile/test_lockfile_local	Test verifying local configs use separate lockfile
e2e/lockfile/test_lockfile_env_resolution	Test verifying correct version selection based on MISE_ENV
e2e/lockfile/test_lockfile_env	Test verifying env field is written when using MISE_ENV

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

This code sorts by version as strings, which will produce incorrect ordering for semantic versions (e.g., '10.0.0' will sort before '2.0.0'). Consider using semver comparison or a version-aware sorting function.

[Copilot]

[nitpick] The variable name current_envs is misleading since env::MISE_ENV is likely a single environment value, not multiple environments. Consider renaming to current_env_set or active_envs to clarify this is a set created from the environment value(s).

[Copilot]

Using string contains for pattern matching is fragile. This would match unintended filenames like 'mise.local.backup.toml' or 'not-local.toml'. Consider using a more precise pattern match or regex to ensure only configs with '.local.' in the expected position are matched.

Suggested change

	filename.contains(".local.")
	// Match: mise.local.toml, .mise.local.toml, config.local.toml
	let re = regex!(r"^(?:\.?mise|config)\.local\.toml$");
	re.is_match(filename)

[Copilot]

The regex pattern doesn't match against the actual filename variable. The pattern is defined but re.captures(filename) on line 280 may not work as intended if the pattern needs to account for different file extensions or naming conventions used in the codebase.

Suggested change

	let re = regex!(r"^(?:\.?mise|config)\.([^.]+)\.toml$");
	// Updated regex: allow env names with letters, numbers, dashes, and underscores
	let re = regex!(r"^(?:\.?mise|config)\.([a-zA-Z0-9_-]+)\.toml$");

[Copilot]

Calling sorted() on every tool entry during lockfile updates could be inefficient when processing many tools. Since envs is already a BTreeSet which maintains sorted order, convert it directly to a Vec without additional sorting.

Suggested change

	Some(envs.into_iter().sorted().collect())
	Some(envs.into_iter().collect())

[Copilot]

This linear search through existing tools for duplicates creates O(n²) complexity when merging lockfiles with many tools. Consider using a HashSet with a custom key (version, options, env) for O(1) duplicate detection.

Suggested change

	for (short, tools) in l.tools {
	let existing = acc.tools.entry(short).or_default();
	for tool in tools {
	// Avoid duplicates (same version+options+env)
	if !existing.iter().any(|t| {
	t.version == tool.version && t.options == tool.options && t.env == tool.env
	}) {
	use std::collections::HashSet;
	for (short, tools) in l.tools {
	let existing = acc.tools.entry(short).or_default();
	// Build a set of existing keys for O(1) duplicate detection
	let mut seen: HashSet<(String, Option<serde_json::Value>, Option<serde_json::Value>)> = existing
	.iter()
	.map(|t| (t.version.clone(), t.options.clone(), t.env.clone()))
	.collect();
	for tool in tools {
	let key = (tool.version.clone(), tool.options.clone(), tool.env.clone());
	if !seen.contains(&key) {
	seen.insert(key);

[github-actions]

Hyperfine Performance

mise x -- echo

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.11.10 x -- echo	19.6 ± 0.4	19.0	23.1	1.00 ± 0.04
mise x -- echo	19.5 ± 0.6	18.5	21.2	1.00

mise env

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.11.10 env	19.3 ± 0.5	18.6	25.7	1.02 ± 0.04
mise env	18.9 ± 0.5	18.1	23.3	1.00

mise hook-env

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.11.10 hook-env	19.2 ± 0.3	18.6	20.5	1.03 ± 0.03
mise hook-env	18.7 ± 0.4	18.1	22.3	1.00

mise ls

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.11.10 ls	16.5 ± 0.3	15.9	20.0	1.03 ± 0.03
mise ls	16.0 ± 0.3	15.5	18.0	1.00

xtasks/test/perf

Command	mise-2025.11.10	mise	Variance
install (cached)	107ms	108ms	+0%
ls (cached)	65ms	65ms	+0%
bin-paths (cached)	70ms	71ms	-1%
task-ls (cached)	424ms	423ms	+0%