mise 2026.5.15

Dev tools, env vars, and tasks in one CLI
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

//! Shared helpers for `mise oci` subcommands.

use eyre::{Result, bail};

use crate::config::{Config, ConfigMap};
use crate::oci::{BuildOptions, BuildOutput, Builder, OciConfig};
use crate::toolset::{ConfigScope, ToolsetBuilder};

/// Merge `[oci]` sections from the given config files, with more specific
/// (closer to the current directory) configs winning per-field.
///
/// Uses "first-Some-wins" semantics via `OciConfig::fill_defaults_from`, so
/// the result is correct as long as the iteration order is most-specific-first
/// — the convention at the time of writing. If that convention ever inverts,
/// this logic still picks the first value it sees and just changes which
/// config wins; it won't silently drop fields or return garbage.
pub fn merged_oci_config_from<'a>(
    config_files: impl IntoIterator<
        Item = &'a std::sync::Arc<dyn crate::config::config_file::ConfigFile>,
    >,
) -> OciConfig {
    let mut out = OciConfig::default();
    for cf in config_files {
        if let Some(oci) = cf.oci_config() {
            out.fill_defaults_from(oci);
        }
    }
    out
}

/// Convenience wrapper that merges `[oci]` across *all* loaded configs.
/// Used when the caller has explicitly opted into global/system scope.
pub fn merged_oci_config(config: &Config) -> OciConfig {
    merged_oci_config_from(config.config_files.values())
}

/// Load config + toolset, merge the `[oci]` section, and build the image.
/// Used by `mise oci build`, `mise oci run`, and `mise oci push`.
///
/// By default both the toolset and the `[oci]` section are scoped to configs
/// at-or-below the project root — i.e. the user's global config, system
/// config, and parent-directory configs above the project (e.g. a `~/mise.toml`
/// setting personal Node defaults) are excluded. Rationale: `mise oci build`
/// is conceptually "package *this project's* tools into a deployable image" —
/// personal dev tools (neovim, ripgrep, …) sitting in
/// `~/.config/mise/config.toml` have no business in a project image, and
/// several of them (asdf/vfox plugins) would in fact be rejected by the v1
/// builder. See discussion #9690.
///
/// Set `include_global = true` to revert to the merge-everything behavior.
pub async fn perform_build(opts: BuildOptions, include_global: bool) -> Result<BuildOutput> {
    let config = Config::get().await?;
    if include_global {
        let ts = ToolsetBuilder::new().build(&config).await?;
        let oci = merged_oci_config(&config);
        return Builder::new(config.clone(), ts, oci, opts).build().await;
    }
    let project_files = project_config_files(&config)?;
    let ts = build_project_toolset(&config, project_files.clone()).await?;
    let oci = merged_oci_config_from(project_files.values());
    Builder::new(config.clone(), ts, oci, opts).build().await
}

/// Configs at-or-below the project root.
///
/// `cf.project_root().is_some()` is the right scope: it's None for the global
/// config, the system config, and parent-dir configs that live directly under
/// $HOME (e.g. `~/mise.toml` someone uses to set their default Node). It's
/// Some for any project config, including those walked up from CWD into a
/// monorepo root — which we *do* want included (sub-project + monorepo root
/// share the toolset of the deployable).
fn project_config_files(config: &Config) -> Result<ConfigMap> {
    let project_files: ConfigMap = config
        .config_files
        .iter()
        .filter(|(_, cf)| cf.project_root().is_some())
        .map(|(p, cf)| (p.clone(), cf.clone()))
        .collect();
    if project_files.is_empty() {
        bail!(
            "mise oci: no project mise config found in the current directory or any parent. \
             Add a `mise.toml` to the project, or pass `--include-global` to use tools and \
             [oci] settings from your global config (note: asdf/vfox plugins remain \
             unsupported)."
        );
    }
    Ok(project_files)
}

async fn build_project_toolset(
    config: &std::sync::Arc<Config>,
    project_files: ConfigMap,
) -> Result<crate::toolset::Toolset> {
    // ConfigScope::LocalOnly belt-and-suspenders: the project-files filter
    // already drops global/system, but LocalOnly *also* drops MISE_*_VERSION
    // ad-hoc overrides from the environment, which shouldn't bake into an
    // image either.
    ToolsetBuilder::new()
        .with_config_files(project_files)
        .with_scope(ConfigScope::LocalOnly)
        .build(config)
        .await
}

pub fn short_digest(d: &str) -> String {
    let hex = d.trim_start_matches("sha256:");
    if hex.len() >= 12 {
        format!("sha256:{}", &hex[..12])
    } else {
        d.to_string()
    }
}