fix(self-update): add missing functions to self_update stub

[jdx]

Summary

• Add upgrade_instructions_text() and append_self_update_instructions() to the self_update stub module
• Fixes compilation errors when building without the self_update feature

Problem

MacPorts builds mise with:

cargo install mise --no-default-features --features native-tls,vfox/vendored-lua

This fails with compilation errors because the stub file src/cli/self_update_stub.rs was missing functions that are called from other parts of the codebase:

• src/cli/doctor/mod.rs:192
• src/cli/version.rs:129
• src/config/mod.rs:489
• src/config/mod.rs:498

Solution

Added the missing functions to the stub implementation:

• upgrade_instructions_text() - returns None (no upgrade instructions)
• append_self_update_instructions() - returns the message unchanged (no-op)

Test plan

• Verified compilation succeeds with cargo check --no-default-features --features native-tls,vfox/vendored-lua
• Build completes successfully (only warnings about unused statics, which is expected)

🤖 Generated with Claude Code

---

Note

Adds upgrade_instructions_text and append_self_update_instructions to the self-update stub, including TOML-based instruction parsing from env::MISE_SELF_UPDATE_INSTRUCTIONS.

• CLI — src/cli/self_update_stub.rs:
  • Add upgrade_instructions_text() to read upgrade instructions from env::MISE_SELF_UPDATE_INSTRUCTIONS (TOML parsed via read_instructions_file).
    • Introduce InstructionsToml and read_instructions_file() to parse message or first command from the TOML.
  • Add append_self_update_instructions(message) to append retrieved instructions to a message.
  • Keep SelfUpdate::is_available() returning false.

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

[Copilot]

Pull Request Overview

Fixes compilation errors when building mise without the self_update feature by adding missing function stubs. This ensures MacPorts and other builds that exclude self-update functionality can compile successfully.

• Add upgrade_instructions_text() stub function that returns None
• Add append_self_update_instructions() stub function that returns the input message unchanged

---

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

[cursor]

Bug: Stub Function Performs Unnecessary I/O Operations

The upgrade_instructions_text() function in the self_update_stub module reads and parses a TOML file. As a stub for a disabled feature, it's expected to be a no-op and return None directly. This current behavior introduces unnecessary file I/O and TOML parsing dependencies, potentially leading to runtime errors when the self_update feature is not enabled.

 

[github-actions]

Hyperfine Performance

mise x -- echo

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.9.25 x -- echo	19.4 ± 0.2	19.0	21.8	1.11 ± 0.02
mise x -- echo	17.5 ± 0.3	17.1	19.1	1.00
✅ Performance improvement for x -- echo is 11%

mise env

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.9.25 env	18.9 ± 0.3	18.4	21.4	1.11 ± 0.03
mise env	17.1 ± 0.4	16.5	21.1	1.00
✅ Performance improvement for env is 11%

mise hook-env

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.9.25 hook-env	18.5 ± 0.2	18.1	19.4	1.11 ± 0.03
mise hook-env	16.7 ± 0.4	16.2	21.1	1.00
✅ Performance improvement for hook-env is 11%

mise ls

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2025.9.25 ls	16.6 ± 0.2	16.1	17.6	1.13 ± 0.04
mise ls	14.7 ± 0.5	14.1	21.1	1.00
✅ Performance improvement for ls is 13%

xtasks/test/perf

Command	mise-2025.9.25	mise	Variance
install (cached)	166ms	✅ 102ms	+62%
ls (cached)	64ms	63ms	+1%
bin-paths (cached)	70ms	69ms	+1%
task-ls (cached)	463ms	474ms	-2%

✅ Performance improvement: install cached is 62%