skillcask 0.10.0

A lockfile-first package manager for AI agent skills (SKILL.md), backed by Composer repositories
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

//! Where skillcask reads its manifest and writes skills: a project, or the user's home.

use std::path::{Path, PathBuf};

use crate::bail;
use crate::error::{MANIFEST, Result};

#[derive(Clone, Debug)]
pub struct Scope {
    /// Base of the store and the agent targets: the project root, or home.
    pub root: PathBuf,
    /// Holds skills.toml, skills.lock and auth.json: the project root, or the config dir.
    pub config: PathBuf,
    pub global: bool,
}

impl Scope {
    pub fn project(root: PathBuf) -> Scope {
        Scope { config: root.clone(), root, global: false }
    }

    pub fn global() -> Result<Scope> {
        let Some(home) = home() else { bail!(MANIFEST, "--global needs HOME (or USERPROFILE) to be set") };
        Ok(Scope { config: config_dir_of(&home, |k| std::env::var_os(k)), root: home, global: true })
    }

    /// `rel` (a path under `root`) as the user should read it in messages.
    pub fn show(&self, rel: &str) -> String {
        if self.global { format!("~/{rel}") } else { rel.to_string() }
    }
}

pub fn home() -> Option<PathBuf> {
    std::env::var_os("HOME").or_else(|| std::env::var_os("USERPROFILE")).filter(|h| !h.is_empty()).map(PathBuf::from)
}

/// The user's config dir, home of the global manifest and `config.toml`; `None` without a home.
pub fn config_dir() -> Option<PathBuf> {
    home().map(|h| config_dir_of(&h, |k| std::env::var_os(k)))
}

/// `$SKILLCASK_HOME`, else `$XDG_CONFIG_HOME/skillcask`, else `~/.config/skillcask`.
fn config_dir_of(home: &Path, var: impl Fn(&str) -> Option<std::ffi::OsString>) -> PathBuf {
    let set = |k: &str| var(k).filter(|v| !v.is_empty()).map(PathBuf::from);
    set("SKILLCASK_HOME")
        .or_else(|| set("XDG_CONFIG_HOME").map(|x| x.join("skillcask")))
        .unwrap_or_else(|| home.join(".config").join("skillcask"))
}

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

    #[test]
    fn config_dir_precedence() {
        let home = Path::new("/h");
        let env =
            |pairs: &'static [(&'static str, &'static str)]| move |k: &str| pairs.iter().find(|(n, _)| *n == k).map(|(_, v)| v.into());
        assert_eq!(config_dir_of(home, env(&[])), Path::new("/h/.config/skillcask"));
        assert_eq!(config_dir_of(home, env(&[("XDG_CONFIG_HOME", "/x")])), Path::new("/x/skillcask"));
        assert_eq!(config_dir_of(home, env(&[("XDG_CONFIG_HOME", "/x"), ("SKILLCASK_HOME", "/s")])), Path::new("/s"));
        assert_eq!(config_dir_of(home, env(&[("SKILLCASK_HOME", "")])), Path::new("/h/.config/skillcask"));
    }
}