stakpak 0.3.60

Stakpak: Your DevOps AI Agent. Generate infrastructure code, debug Kubernetes, configure CI/CD, automate deployments, without giving an LLM the keys to production.
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

use stakpak_api::{AgentProvider, models::ListRuleBook};

/// Capture startup project directory for server-side AGENTS.md/APPS.md discovery.
pub fn startup_project_dir() -> Option<String> {
    std::env::current_dir()
        .ok()
        .map(|path| path.to_string_lossy().to_string())
}

/// Convert remote skills metadata payload into typed server context files.
///
/// The current API shape is `list_rulebooks`, but we treat entries as remote
/// skill descriptors in the runtime context pipeline.
pub fn map_remote_skills_to_context_files(
    entries: &[ListRuleBook],
) -> Vec<stakpak_server::ContextFile> {
    entries
        .iter()
        .map(|entry| {
            stakpak_server::ContextFile::new(
                format!("remote_skill:{}", entry.uri),
                normalize_remote_skill_uri(&entry.uri),
                format!(
                    "<remote_skill>\nURI: {}\nDescription: {}\nTags: {}\n</remote_skill>",
                    entry.uri,
                    entry.description,
                    entry.tags.join(", ")
                ),
                stakpak_server::ContextPriority::High,
            )
        })
        .collect()
}

fn normalize_remote_skill_uri(uri: &str) -> String {
    if uri.starts_with("stakpak://") {
        uri.to_string()
    } else {
        format!("stakpak://{}", uri.trim_start_matches('/'))
    }
}

/// Load remote skills context for server sessions.
pub async fn load_remote_skills_context(
    client: &dyn AgentProvider,
) -> Result<Vec<stakpak_server::ContextFile>, String> {
    client
        .list_rulebooks()
        .await
        .map(|entries| map_remote_skills_to_context_files(&entries))
}

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

    #[test]
    fn maps_remote_skills_payload_to_context_file() {
        let files = map_remote_skills_to_context_files(&[ListRuleBook {
            id: "id_1".to_string(),
            uri: "stakpak://skills/k8s".to_string(),
            description: "Kubernetes ops".to_string(),
            visibility: RuleBookVisibility::Public,
            tags: vec!["kubernetes".to_string(), "ops".to_string()],
            created_at: None,
            updated_at: None,
        }]);

        assert_eq!(files.len(), 1);
        assert!(files[0].name.starts_with("remote_skill:"));
        assert_eq!(
            files[0].path, "stakpak://skills/k8s",
            "path must not double-prefix the stakpak:// scheme"
        );
        assert!(files[0].content.contains("<remote_skill>"));
        assert!(files[0].content.contains("Kubernetes ops"));
    }

    #[test]
    fn maps_remote_skills_payload_without_scheme_to_context_file() {
        let files = map_remote_skills_to_context_files(&[ListRuleBook {
            id: "id_2".to_string(),
            uri: "skills/terraform".to_string(),
            description: "Terraform workflows".to_string(),
            visibility: RuleBookVisibility::Public,
            tags: vec!["terraform".to_string()],
            created_at: None,
            updated_at: None,
        }]);

        assert_eq!(files.len(), 1);
        assert_eq!(files[0].path, "stakpak://skills/terraform");
    }

    #[test]
    fn normalize_remote_skill_uri_keeps_existing_scheme() {
        assert_eq!(
            normalize_remote_skill_uri("stakpak://skills/k8s"),
            "stakpak://skills/k8s"
        );
    }
}