bijux-cli 0.3.5

Command-line runtime for automation, plugin-driven tools, and interactive workflows with structured output.
Documentation 
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

#![forbid(unsafe_code)]
//! Installation diagnostics and health reporting.

use std::fs;
use std::path::Path;

use super::paths::{
    detect_stale_wrapper_scripts, discover_path_binaries, legacy_installer_conflicts,
    resolve_active_binary,
};

/// Installation diagnostics report used by `bijux cli paths` and `bijux doctor`.
#[derive(Debug, Clone, PartialEq, Eq)]
#[allow(clippy::struct_excessive_bools)]
pub struct InstallHealthReport {
    /// Active binary used for invocation.
    pub active_binary: Option<String>,
    /// All discovered binaries named `bijux` in PATH order.
    pub path_binaries: Vec<String>,
    /// Whether multiple binaries are discovered in PATH order.
    pub has_path_shadowing: bool,
    /// Whether installs appear to exist across multiple ecosystems.
    pub has_duplicate_installs: bool,
    /// Wrapper scripts that no longer point to an existing runtime.
    pub stale_wrapper_scripts: Vec<String>,
    /// Whether wheel and runtime binary versions differ.
    pub has_mismatched_wheel_binary_versions: bool,
    /// Legacy installer wrappers that could shadow canonical runtime.
    pub legacy_installer_conflicts: Vec<String>,
    /// Whether configured active binary path is missing from disk.
    pub active_binary_missing: bool,
    /// Whether configured active binary path is a broken symlink.
    pub broken_symlink_active_binary: bool,
}

/// Build installation diagnostics for binary resolution and ecosystem overlap checks.
#[must_use]
pub fn install_health_report(
    path_value: &str,
    bin_override: Option<&str>,
    wheel_version: Option<&str>,
    runtime_version: &str,
) -> InstallHealthReport {
    let mut path_binaries = discover_path_binaries(path_value);
    path_binaries.dedup();
    let active_binary = resolve_active_binary(path_value, bin_override);
    let has_path_shadowing = path_binaries.len() > 1;
    let has_duplicate_installs = path_binaries.iter().any(|path| path.contains(".cargo"))
        && path_binaries.iter().any(|path| path.contains("site-packages"));
    let stale_wrapper_scripts = detect_stale_wrapper_scripts(path_value);
    let has_mismatched_wheel_binary_versions =
        wheel_version.is_some_and(|version| version != runtime_version);
    let legacy_installer_conflicts = legacy_installer_conflicts(path_value);
    let active_binary_missing =
        active_binary.as_deref().is_some_and(|path| !Path::new(path).exists());
    let broken_symlink_active_binary = active_binary.as_deref().is_some_and(|path| {
        let p = Path::new(path);
        fs::symlink_metadata(p).map(|meta| meta.file_type().is_symlink()).unwrap_or(false)
            && fs::metadata(p).is_err()
    });

    InstallHealthReport {
        active_binary,
        path_binaries,
        has_path_shadowing,
        has_duplicate_installs,
        stale_wrapper_scripts,
        has_mismatched_wheel_binary_versions,
        legacy_installer_conflicts,
        active_binary_missing,
        broken_symlink_active_binary,
    }
}