fix(backend): use runtime paths for backend bin dirs

[risu729]

Summary

• map backend-discovered bin paths from concrete install dirs onto ToolVersion::runtime_path()
• align aqua, GitHub/GitLab/Forgejo, HTTP, S3, UBI, vfox, conda, and Windows npm bin-paths with runtime symlink labels for fuzzy versions
• centralize the .mise-bins directory name behind MISE_BINS_DIR
• add regression coverage for GitHub, HTTP, and aqua runtime-path bin-paths

Why this matters

mise keeps a concrete install dir for the resolved version and, for fuzzy requests, a runtime path for the requested label. For example, latest might resolve to 1.0.0, and 1.46 might resolve to 1.46.0. The runtime path is the stable symlink users expect on PATH.

Before this PR, several backend bin-paths implementations could report bins from the concrete install path instead of the runtime path:

• GitHub alias example: tiny = { version = "latest", bin_path = "hello-world-1.0.0/bin" } resolved to 1.0.0, but mise bin-paths tiny used the concrete .../installs/tiny/1.0.0/.../bin path instead of .../installs/tiny/latest/.../bin.
• HTTP example: http:hello-upgrade-latest resolved latest to 2.0.0, but bin-paths could expose the concrete resolved install/cache path rather than .../installs/http-hello-upgrade-latest/latest/.../bin.
• Aqua prefix example: aqua:casey/just with version 1.46 resolves to 1.46.0; with symlink_bins = true, bin-paths should use .../installs/aqua-casey-just/1.46/.mise-bins, not the concrete 1.46.0 directory.

runtime_path_for_install_path is needed for backend-discovered absolute paths: it strips the concrete install prefix and reattaches the same relative subpath under tv.runtime_path(). Explicit relative bin_path values can join runtime_path() directly; the helper covers paths found by scanning extracted archives while leaving unrelated paths unchanged.

Tests

• cargo fmt --all -- --check
• git diff --check
• cargo test test_runtime_path_for_install_path_remaps_install_subpath
• mise run test:e2e e2e/backend/test_github_alias_versions e2e/backend/test_http_upgrade e2e/backend/test_aqua_symlink_bins
• after AI-review follow-up: mise run test:e2e e2e/backend/test_http_upgrade e2e/backend/test_aqua_symlink_bins (the preceding rerun passed test_github_alias_versions, then hit a transient test_http_upgrade server-port setup race before assertions)
• after const/re-review follow-up: cargo fmt --all -- --check, git diff --check, cargo test test_runtime_path_for_install_path_remaps_install_subpath, mise run test:e2e e2e/backend/test_github_alias_versions e2e/backend/test_http_upgrade e2e/backend/test_aqua_symlink_bins

Project item: https://github.com/users/risu729/projects/3/views/1?pane=issue&itemId=182730541

This PR was generated by an AI coding assistant.

[gemini-code-assist]

Code Review

This pull request introduces a mechanism to remap tool installation paths to runtime paths, ensuring that commands like mise bin-paths return paths relative to symlinks like 'latest' rather than physical version directories. It adds a runtime_path_for_install_path helper and updates the Aqua, GitHub, and HTTP backends, supported by new E2E tests. Feedback recommends simplifying the helper function by removing an unnecessary check and directly using tv.runtime_path() in backend implementations where the subpath is already known, rather than relying on the remapping helper.

[greptile-apps]

Greptile Summary

This PR fixes several backends (aqua, github/gitlab/forgejo, http, s3, ubi, vfox, conda, Windows npm) that could expose the concrete resolved-version install path instead of the fuzzy-label runtime symlink path when bin-paths or PATH entries are queried for tools installed with labels like latest or 1.46.

• Centralises the .mise-bins directory name behind a MISE_BINS_DIR constant and introduces a runtime_path_for_install_path helper that strips the concrete install prefix from a backend-discovered path and reattaches the same relative subpath under tv.runtime_path(), falling back unchanged for paths outside the install dir.
• Updates every affected backend's list_bin_paths to join explicit bin_path values and discovered archive subpaths onto tv.runtime_path() rather than tv.install_path(), and replaces the rebuild call in rebuild_shims_and_runtime_symlinks with rebuild_for_toolset so that project-local backends not in the global backend::list() also have their symlinks refreshed.
• Adds a unit test covering both the remap and the no-symlink fallback paths, plus e2e regression tests for the GitHub alias, HTTP fuzzy-latest, and aqua symlink-bins scenarios.

Confidence Score: 5/5

Safe to merge — the fallback in runtime_path_for_install_path (return path unchanged when no runtime symlink exists) prevents any regression for exact-version pinned tools.

The helper is straightforward and both code paths are covered by new unit tests. rebuild_for_toolset is a strict superset of the previous rebuild call, so no previously-rebuilt symlinks are skipped. Each backend change follows the same pattern uniformly, and e2e tests lock in the expected runtime-path shape.

No files require special attention.

Important Files Changed

Filename	Overview
src/backend/mod.rs	Adds MISE_BINS_DIR constant, the runtime_path_for_install_path helper, and two unit tests covering the remap and the no-symlink fallback; helper logic is correct.
src/runtime_symlinks.rs	Adds rebuild_for_toolset which is a strict superset of rebuild — starts from the full backend::list() then includes any toolset-only backends; safe change.
src/backend/github.rs	Applies runtime_path_for_install_path to discovered bin paths and uses tv.runtime_path() for the .mise-bins fast path; MISE_BINS_DIR constant adoption is consistent.
src/backend/http.rs	Explicit bin_path and bin/ checks now join onto tv.runtime_path() directly; subdirectory scan paths are remapped via runtime_path_for_install_path.
src/backend/aqua.rs	Switches .mise-bins check to use MISE_BINS_DIR constant and uses runtime_path for archive-scanned paths; create_symlink_bin_dir constant adoption is correct.
src/backend/conda.rs	Both the .mise-bins fast path and the Windows/Unix fallback bin paths are remapped via runtime_path_for_install_path; refactoring to avoid early returns is clean.
src/backend/s3.rs	All three bin-path discovery paths (explicit, bin/, subdirectory scan) remapped via runtime_path_for_install_path; empty-path fallback switches to tv.runtime_path().
src/backend/ubi.rs	Relative bin_path and bin/ cases remapped via runtime_path_for_install_path; extract_all and empty fallbacks switch to tv.runtime_path().
src/backend/vfox.rs	PATH entries from the vfox plugin are remapped via runtime_path_for_install_path; fallback uses tv.runtime_path().
src/backend/npm.rs	Windows-only list_bin_paths applies runtime_path_for_install_path to each discovered path; #[cfg(windows)] import guard is correct.
src/config/mod.rs	Switches rebuild call to rebuild_for_toolset which is a strict superset, ensuring project-local backends also get their symlinks rebuilt.
e2e/backend/test_aqua_symlink_bins	Adds a fuzzy-version (1.46) test block that asserts bin-paths and which resolve through the runtime symlink rather than the concrete 1.46.0 directory.
e2e/backend/test_github_alias_versions	Adds assertions for both the runtime-symlink (unlocked) and the locked concrete-path bin-paths results for the tiny alias tool.
e2e/backend/test_http_upgrade	Adds a fuzzy latest HTTP tool and asserts that bin-paths uses the latest runtime symlink path, not the concrete resolved cache path.

_{Reviews (15): Last reviewed commit: "fix(backend): respect locked runtime pat..." | Re-trigger Greptile}

[risu729]

CI completed. The current failures look unrelated to this PR's runtime bin-path changes:

• e2e-0: shell/test_xonsh failed while installing aqua:astral-sh/uv@latest because GitHub artifact attestation verification failed (expected 'astral-sh/uv/.github/workflows/release.yml', found certificate: None, provenance: None).
• e2e-3: cli/test_activate_multiple_xonsh failed with the same uv attestation verification error; sync/test_sync_python_uv is also in the failing shard.
• e2e-4: cli/test_deactivate_xonsh failed with the same uv attestation verification error.
• benchmark: failed because mise x -- echo measured 18% slower than the mise-2026.5.0 baseline. The other benchmarked commands were within threshold, and this command does not exercise the aqua/github/http runtime bin-path mapping changed here.
• test-ci: aggregate failure from the failed jobs above.

The relevant build/lint/unit checks passed, as did the other Linux e2e shards and Windows e2e. I am leaving these CI failures as unrelated.

This comment was generated by an AI coding assistant.