heddle-mount 0.5.0

An AI-native version control system
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
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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139

// SPDX-License-Identifier: Apache-2.0
//! macOS FSKit extension readiness probe.
//!
//! Used by the CLI's mount lifecycle to decide whether to attempt
//! an FSKit mount or fall through to the NFS fallback. The probe
//! shells out to `pluginkit -m` and looks for the Heddle bundle
//! identifier; the `+` / `-` prefix indicates enabled / disabled.
//!
//! When the extension is disabled or missing, the caller is
//! expected to print a one-line setup hint and open
//! System Settings to the File System Extensions pane. This
//! module exposes `open_settings()` to do that consistently.

use std::process::Command;

const MIN_NATIVE_FSKIT_MAJOR_VERSION: u32 = 26;

/// Bundle identifier of the embedded FSKit extension. Must match
/// the `PRODUCT_BUNDLE_IDENTIFIER` on the `HeddleFSModule` target
/// in `crates/mount/swift/HeddleHost/HeddleHost.xcodeproj`.
pub const EXTENSION_BUNDLE_ID: &str = "sh.heddle.HeddleHost.HeddleFSModule";

/// What the readiness probe found.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Readiness {
    /// The extension is installed and enabled. Mounts via
    /// `mount -t heddle` will succeed.
    Ready,
    /// The host app is installed (extension is discoverable) but
    /// the user hasn't toggled it on. Caller should open System
    /// Settings and ask for one click.
    NeedsApproval,
    /// The extension isn't installed at all. Either the host app
    /// isn't in `/Applications` yet, or this isn't a build with
    /// the System Extension distribution piece. Caller should
    /// fall through to NFS.
    NotInstalled,
    /// The host is below Heddle's native FSKit deployment floor.
    /// Caller should tell the user and fall through to NFS.
    UnsupportedMacOS,
    /// `sw_vers` or `pluginkit` failed for some other reason.
    /// Treat as NotInstalled.
    Unknown,
}

/// Probe the system for our FSKit extension's state. Synchronous
/// — `pluginkit` returns in <100ms on a warm system.
pub fn probe() -> Readiness {
    match macos_major_version() {
        Some(major) if major < MIN_NATIVE_FSKIT_MAJOR_VERSION => {
            return Readiness::UnsupportedMacOS;
        }
        Some(_) => {}
        None => return Readiness::Unknown,
    }

    // `pluginkit -m -p com.apple.fskit.fsmodule` lists every
    // registered FSKit extension, one per line. Format:
    //     +    sh.heddle.HeddleHost.HeddleFSModule(1.0)
    //     -    com.example.other(2.0)
    // First char: `+` = enabled, `-` = disabled.
    let output = match Command::new("pluginkit")
        .args(["-m", "-p", "com.apple.fskit.fsmodule"])
        .output()
    {
        Ok(o) => o,
        Err(_) => return Readiness::Unknown,
    };
    if !output.status.success() {
        return Readiness::Unknown;
    }
    let stdout = String::from_utf8_lossy(&output.stdout);
    for line in stdout.lines() {
        // Lines look like:  "+    sh.heddle.HeddleHost.HeddleFSModule(1.0)"
        let trimmed = line.trim_start();
        if !trimmed.contains(EXTENSION_BUNDLE_ID) {
            continue;
        }
        let enabled = line.trim_start().starts_with('+');
        return if enabled {
            Readiness::Ready
        } else {
            Readiness::NeedsApproval
        };
    }
    Readiness::NotInstalled
}

/// Open System Settings → General → Login Items & Extensions →
/// File System Extensions. Best-effort; logs and returns on
/// failure rather than propagating the error.
pub fn open_settings() {
    let url = "x-apple.systempreferences:com.apple.LoginItems-Settings.extension?Extensions";
    let _ = Command::new("open").arg(url).status();
}

/// One-line setup hint to print to stderr when the extension
/// isn't ready. The CLI's full approval flow expands this into the
/// System Settings path, the By Category / Extension Type instruction,
/// and a wait spinner.
pub fn setup_hint() -> &'static str {
    "Heddle FSKit extension is installed, but macOS has not enabled it yet."
}

/// One-line notice when a Mac is too old for Heddle's native FSKit
/// path-resource mount, but can still use the universal NFS fallback.
pub fn unsupported_macos_hint() -> &'static str {
    "Heddle native FSKit mounts require macOS 26.0 or newer.\n\
     Using the NFS fallback for this virtualized workspace."
}

fn macos_major_version() -> Option<u32> {
    let output = Command::new("sw_vers")
        .arg("-productVersion")
        .output()
        .ok()?;
    if !output.status.success() {
        return None;
    }
    let version = String::from_utf8(output.stdout).ok()?;
    parse_macos_major_version(&version)
}

fn parse_macos_major_version(version: &str) -> Option<u32> {
    version.trim().split('.').next()?.parse().ok()
}

#[cfg(test)]
mod tests {
    use super::parse_macos_major_version;

    #[test]
    fn parses_macos_major_versions() {
        assert_eq!(parse_macos_major_version("15.4"), Some(15));
        assert_eq!(parse_macos_major_version("26.0.1"), Some(26));
        assert_eq!(parse_macos_major_version(""), None);
        assert_eq!(parse_macos_major_version("not-a-version"), None);
    }
}