mise 2026.4.18

The front-end to your dev env
use color_eyre::eyre::{Result, bail};

use crate::cli::args::ToolArg;
use crate::config::Config;
use crate::duration::parse_into_timestamp;
use crate::toolset::ToolRequest;
use crate::ui::multi_progress_report::MultiProgressReport;

/// Gets the latest available version for a plugin
///
/// Supports prefixes such as `node@20` to get the latest version of node 20.
#[derive(Debug, clap::Args)]
#[clap(verbatim_doc_comment, after_long_help = AFTER_LONG_HELP)]
pub struct Latest {
    /// Tool to get the latest version of
    #[clap(value_name = "TOOL@VERSION")]
    tool: ToolArg,

    /// The version prefix to use when querying the latest version
    /// same as the first argument after the "@"
    /// used for asdf compatibility
    #[clap(hide = true)]
    asdf_version: Option<String>,

    /// Show latest installed instead of available version
    #[clap(short, long)]
    installed: bool,

    /// Only consider versions released before this date
    ///
    /// Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y".
    /// Overrides per-tool `install_before` options and the global `install_before` setting.
    #[clap(long, verbatim_doc_comment, conflicts_with = "installed")]
    before: Option<String>,
}

impl Latest {
    pub async fn run(self) -> Result<()> {
        let config = Config::get().await?;
        let Self {
            tool,
            asdf_version,
            installed,
            before,
        } = self;
        let before_date = before.as_deref().map(parse_into_timestamp).transpose()?;
        let mut prefix = match &tool.tvr {
            None => asdf_version,
            Some(ToolRequest::Version { version, .. }) => Some(version.clone()),
            _ => bail!("invalid version: {}", tool.style()),
        };

        let backend = tool.ba.backend()?;
        let mpr = MultiProgressReport::get();
        if let Some(plugin) = backend.plugin() {
            plugin.ensure_installed(&config, &mpr, false, false).await?;
        }
        if let Some(v) = prefix {
            prefix = Some(config.resolve_alias(&backend, &v).await?);
        }

        let latest_version = if installed {
            backend.latest_installed_version(prefix)?
        } else {
            backend.latest_version(&config, prefix, before_date).await?
        };
        if let Some(version) = latest_version {
            miseprintln!("{}", version);
        }
        Ok(())
    }
}

static AFTER_LONG_HELP: &str = color_print::cstr!(
    r#"<bold><underline>Examples:</underline></bold>

    $ <bold>mise latest node@20</bold>  # get the latest version of node 20
    20.0.0

    $ <bold>mise latest node</bold>     # get the latest stable version of node
    20.0.0

    $ <bold>mise latest node --before 2024-01-01</bold>  # latest stable node released before 2024-01-01
"#
);