ares-server 0.7.5

//! Skills HTTP handlers — list and retrieve SKILL.md files via API.
//!
//! Requires the `skills` feature flag.

use axum::{
    extract::{Path, State},
    http::StatusCode,
    Json,
};
use serde::Serialize;

use crate::AppState;

#[derive(Serialize)]
pub struct SkillResponse {
    pub name: String,
    pub description: String,
    pub scope: String,
    pub path: String,
}

#[derive(Serialize)]
pub struct SkillDetailResponse {
    pub name: String,
    pub description: String,
    pub scope: String,
    pub path: String,
    pub content: String,
}

#[derive(Serialize)]
pub struct SkillsListResponse {
    pub skills: Vec<SkillResponse>,
    pub count: usize,
}

/// GET /api/skills — list all discovered skills with scope-based priority.
pub async fn list_skills(
    State(state): State<AppState>,
) -> Json<SkillsListResponse> {
    let config = skills_config_from_state(&state);
    let summaries = crate::skills::list_skills(&config);
    let count = summaries.len();
    let skills = summaries
        .into_iter()
        .map(|s| SkillResponse {
            name: s.name,
            description: s.description,
            scope: s.scope,
            path: s.path,
        })
        .collect();
    Json(SkillsListResponse { skills, count })
}

/// GET /api/skills/{name} — get a single skill by qualified name.
pub async fn get_skill(
    State(state): State<AppState>,
    Path(name): Path<String>,
) -> Result<Json<SkillDetailResponse>, StatusCode> {
    let config = skills_config_from_state(&state);
    match crate::skills::get_skill(&config, &name) {
        Some(skill) => {
            let fqn = skill.qualified_name();
            Ok(Json(SkillDetailResponse {
                name: fqn,
                description: skill.file.frontmatter.description.clone().unwrap_or_default(),
                scope: skill.scope.to_string(),
                path: skill.file.path.to_string_lossy().to_string(),
                content: skill.file.content.clone(),
            }))
        }
        None => Err(StatusCode::NOT_FOUND),
    }
}

/// Build SkillsConfig from AppState config manager.
fn skills_config_from_state(state: &AppState) -> crate::skills::SkillsConfig {
    let config = state.config_manager.config();
    match &config.skills {
        Some(skills_toml) => crate::skills::SkillsConfig {
            project_dir: skills_toml.project_dir.clone(),
            personal_dir: skills_toml.personal_dir.clone(),
            enterprise_dir: None,
            plugin_dirs: skills_toml.plugin_dirs.clone().unwrap_or_default(),
        },
        None => crate::skills::SkillsConfig::default(),
    }
}

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

    #[test]
    fn test_skill_response_serialization() {
        let resp = SkillResponse {
            name: "test-skill".to_string(),
            description: "A test".to_string(),
            scope: "project".to_string(),
            path: "/tmp/test/SKILL.md".to_string(),
        };
        let json = serde_json::to_string(&resp).unwrap();
        assert!(json.contains("test-skill"));
        assert!(json.contains("project"));
    }

    #[test]
    fn test_skill_detail_response_serialization() {
        let resp = SkillDetailResponse {
            name: "my-skill".to_string(),
            description: "Does things".to_string(),
            scope: "personal".to_string(),
            path: "/home/user/.claude/skills/my-skill/SKILL.md".to_string(),
            content: "# My Skill\n\nInstructions here.".to_string(),
        };
        let json = serde_json::to_string(&resp).unwrap();
        assert!(json.contains("my-skill"));
        assert!(json.contains("Instructions here"));
    }

    #[test]
    fn test_skills_list_response_serialization() {
        let resp = SkillsListResponse {
            skills: vec![],
            count: 0,
        };
        let json = serde_json::to_string(&resp).unwrap();
        assert!(json.contains("\"count\":0"));
        assert!(json.contains("\"skills\":[]"));
    }

    #[test]
    fn test_skills_list_with_items() {
        let resp = SkillsListResponse {
            skills: vec![
                SkillResponse {
                    name: "a".to_string(),
                    description: "first".to_string(),
                    scope: "project".to_string(),
                    path: "/a/SKILL.md".to_string(),
                },
                SkillResponse {
                    name: "b".to_string(),
                    description: "second".to_string(),
                    scope: "personal".to_string(),
                    path: "/b/SKILL.md".to_string(),
                },
            ],
            count: 2,
        };
        let json = serde_json::to_string(&resp).unwrap();
        assert!(json.contains("\"count\":2"));
        let parsed: serde_json::Value = serde_json::from_str(&json).unwrap();
        assert_eq!(parsed["skills"].as_array().unwrap().len(), 2);
    }
}