origin-mcp 0.8.4

MCP server for Origin, the local-first personal agent memory layer
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

use semver::Version;

#[derive(Debug, PartialEq)]
pub enum VersionStatus {
    Compatible,
    McpOutdated { mcp: Version, daemon: Version },
    DaemonOutdated { mcp: Version, daemon: Version },
}

/// Compare origin-mcp's compiled version against the daemon's reported version.
/// Treats the daemon being minor/major AHEAD as `McpOutdated` (a patch-ahead
/// daemon is ignored: release-please bumps patches frequently and they're
/// API-compatible). Flags `DaemonOutdated` when the running daemon is strictly
/// OLDER than origin-mcp at any level, including patch (it was not restarted
/// after an upgrade). Unparseable daemon versions are treated as Compatible
/// (handshake never blocks).
pub fn compare(mcp_version: &str, daemon_version: &str) -> VersionStatus {
    // Defensive on both sides: if either version fails to parse, fall back to
    // Compatible. Never panic at startup over a malformed version string.
    let mcp = match Version::parse(mcp_version) {
        Ok(v) => v,
        Err(_) => return VersionStatus::Compatible,
    };
    let daemon = match Version::parse(daemon_version) {
        Ok(v) => v,
        Err(_) => return VersionStatus::Compatible,
    };
    if daemon.major > mcp.major || (daemon.major == mcp.major && daemon.minor > mcp.minor) {
        VersionStatus::McpOutdated { mcp, daemon }
    } else if mcp > daemon {
        // mcp strictly newer than the running daemon (any level, incl. patch):
        // the daemon binary on disk may already be new, but the running PROCESS
        // is stale — it was not restarted after an upgrade.
        VersionStatus::DaemonOutdated { mcp, daemon }
    } else {
        VersionStatus::Compatible
    }
}

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

    #[test]
    fn mcp_minor_ahead_daemon_outdated() {
        // Was previously "Compatible"; now the daemon is flagged as stale.
        assert!(matches!(
            compare("0.2.0", "0.1.5"),
            VersionStatus::DaemonOutdated { .. }
        ));
    }

    #[test]
    fn daemon_patch_behind_outdated() {
        // The common post-upgrade case: new mcp, daemon not restarted.
        assert!(matches!(
            compare("0.8.3", "0.8.2"),
            VersionStatus::DaemonOutdated { .. }
        ));
    }

    #[test]
    fn daemon_patch_ahead_compatible() {
        // mcp slightly behind daemon by patch is fine (unchanged).
        assert_eq!(compare("0.8.2", "0.8.3"), VersionStatus::Compatible);
    }

    #[test]
    fn equal_versions_compatible() {
        assert_eq!(compare("0.8.3", "0.8.3"), VersionStatus::Compatible);
    }

    #[test]
    fn daemon_minor_ahead_outdated() {
        assert!(matches!(
            compare("0.1.2", "0.2.0"),
            VersionStatus::McpOutdated { .. }
        ));
    }

    #[test]
    fn daemon_major_ahead_outdated() {
        assert!(matches!(
            compare("0.1.2", "1.0.0"),
            VersionStatus::McpOutdated { .. }
        ));
    }

    #[test]
    fn patch_drift_compatible() {
        assert_eq!(compare("0.1.2", "0.1.5"), VersionStatus::Compatible);
    }

    #[test]
    fn unparseable_daemon_version_compatible() {
        assert_eq!(compare("0.1.2", "garbage"), VersionStatus::Compatible);
    }

    #[test]
    fn build_metadata_ignored_in_ordering() {
        // SemVer 2.0.0: build metadata after `+` is ignored when ordering versions.
        assert_eq!(compare("0.1.2", "0.1.2+abc"), VersionStatus::Compatible);
    }

    #[test]
    fn prerelease_daemon_same_minor_daemon_outdated() {
        // Daemon on a 0.2.0 pre-release while MCP is on stable 0.2.0:
        // semver ordering: 0.2.0 > 0.2.0-beta.1 (pre-releases rank lower),
        // so mcp > daemon triggers DaemonOutdated — the daemon binary is stale.
        assert!(matches!(
            compare("0.2.0", "0.2.0-beta.1"),
            VersionStatus::DaemonOutdated { .. }
        ));
    }
}