microclaw-engine 0.10.1

Channel-independent Agent Engine and default services for MicroClaw
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

use crate::internal::clawhub::types::LockFile;
use microclaw_core::error::MicroClawError;
use std::collections::HashMap;
use std::path::Path;

/// Read lockfile from disk
pub fn read_lockfile(path: &Path) -> Result<LockFile, MicroClawError> {
    if !path.exists() {
        return Ok(LockFile {
            version: 1,
            skills: HashMap::new(),
        });
    }
    let content = std::fs::read_to_string(path)
        .map_err(|e| MicroClawError::Config(format!("Failed to read lockfile: {}", e)))?;
    let lock: LockFile = serde_json::from_str(&content)
        .map_err(|e| MicroClawError::Config(format!("Failed to parse lockfile: {}", e)))?;
    Ok(lock)
}

/// Write lockfile to disk
pub fn write_lockfile(path: &Path, lock: &LockFile) -> Result<(), MicroClawError> {
    if let Some(parent) = path.parent() {
        std::fs::create_dir_all(parent)
            .map_err(|e| MicroClawError::Config(format!("Failed to create lockfile dir: {}", e)))?;
    }
    let content = serde_json::to_string_pretty(lock)
        .map_err(|e| MicroClawError::Config(format!("Failed to serialize lockfile: {}", e)))?;
    std::fs::write(path, content)
        .map_err(|e| MicroClawError::Config(format!("Failed to write lockfile: {}", e)))?;
    Ok(())
}

/// Check if a skill is managed by ClawHub (in lockfile)
pub fn is_clawhub_managed(lock: &LockFile, slug: &str) -> bool {
    lock.skills.contains_key(slug)
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::internal::clawhub::types::LockEntry;

    #[test]
    fn test_lockfile_missing_returns_empty() {
        let temp_path = std::env::temp_dir().join(format!("nonexistent_{}", uuid::Uuid::new_v4()));
        let lock = read_lockfile(&temp_path).unwrap();
        assert_eq!(lock.version, 1);
        assert!(lock.skills.is_empty());
    }

    #[test]
    fn test_lockfile_roundtrip() {
        let temp_dir = std::env::temp_dir().join(format!("clawhub_test_{}", uuid::Uuid::new_v4()));
        std::fs::create_dir_all(&temp_dir).unwrap();
        let lock_path = temp_dir.join("clawhub.lock.json");

        let mut lock = LockFile {
            version: 1,
            skills: HashMap::new(),
        };
        lock.skills.insert(
            "test-skill".into(),
            LockEntry {
                slug: "test-skill".into(),
                installed_version: "1.0.0".into(),
                installed_at: "2026-02-18T00:00:00Z".into(),
                content_hash: "sha256:abc".into(),
                tree_hash: None,
                local_path: "/tmp/test".into(),
            },
        );

        write_lockfile(&lock_path, &lock).unwrap();
        let read = read_lockfile(&lock_path).unwrap();
        assert_eq!(
            read.skills.get("test-skill").unwrap().installed_version,
            "1.0.0"
        );

        std::fs::remove_dir_all(&temp_dir).ok();
    }

    #[test]
    fn test_is_clawhub_managed() {
        let mut lock = LockFile {
            version: 1,
            skills: HashMap::new(),
        };
        lock.skills.insert(
            "my-skill".into(),
            LockEntry {
                slug: "my-skill".into(),
                installed_version: "1.0.0".into(),
                installed_at: "2026-02-18T00:00:00Z".into(),
                content_hash: "sha256:abc".into(),
                tree_hash: None,
                local_path: "/tmp/test".into(),
            },
        );

        assert!(is_clawhub_managed(&lock, "my-skill"));
        assert!(!is_clawhub_managed(&lock, "other-skill"));
    }
}