agents-skills 0.28.1

//! add: install one skill (local directory or the GitHub id `owner/repo/slug`).
//!
//! Renders the [`Manager::add`] outcome; no business logic lives here.

use crate::cli::{AddArgs, CYAN, DIM, GREEN, RESET, YELLOW};
use crate::commands::{fail_agents, shorten_path};
use agents_skills::error::Result;
use agents_skills::{AddOutcome, AddRequest, Env, Manager, SkillsError, SourceType};

pub fn run(manager: &Manager, args: AddArgs) -> Result<()> {
    let req = AddRequest {
        source: args.source,
        reference: args.reference,
        force: args.force,
    };

    let outcome = match manager.add(&req) {
        Ok(o) => o,
        Err(e) => return fail_add(e),
    };
    render(manager.env(), &req, &outcome);

    println!();
    println!(
        "{GREEN}Done!{RESET}{DIM}  Review skills before use; they run with full agent permissions.{RESET}"
    );
    Ok(())
}

fn fail_add(e: SkillsError) -> Result<()> {
    match e {
        SkillsError::Message(msg) => {
            eprintln!("\x1b[31m{msg}\x1b[0m");
            std::process::exit(1);
        }
        other => fail_agents(other),
    }
}

fn render(env: &Env, req: &AddRequest, outcome: &AddOutcome) {
    print_source(env, req, &outcome.source);

    // The slug is the skill's identity — what `remove`/`enable` address it by;
    // the raw frontmatter name is shown alongside when it differs.
    let slug = agents_skills::slugify(&outcome.skill.name);
    let name_suffix = if outcome.skill.name.eq_ignore_ascii_case(&slug) {
        String::new()
    } else {
        format!(" {DIM}(name: {}){RESET}", outcome.skill.name)
    };
    println!("Skill: {CYAN}{slug}{RESET}{name_suffix}");
    println!("{DIM}{}{RESET}", outcome.skill.description);

    println!();
    if outcome.skipped {
        println!("{YELLOW}•{RESET} {slug} {DIM}skipped (already installed){RESET}");
        println!(
            "{DIM}To replace an installed skill: remove it first, then add again (or use --force).{RESET}"
        );
    } else {
        println!(
            "{GREEN}✓{RESET} {}",
            shorten_path(&outcome.canonical_path, env)
        );
        println!();
        println!("{GREEN}Installed 1 skill{RESET}");
    }
}

fn print_source(env: &Env, req: &AddRequest, parsed: &agents_skills::Source) {
    let main = match parsed.ty {
        SourceType::Local => parsed
            .local_path
            .as_ref()
            .map(|p| shorten_path(p, env))
            .unwrap_or_default(),
        SourceType::Github => {
            let repo = format!("{}/{}", parsed.owner, parsed.repo);
            format!("{repo}/{CYAN}{}{RESET}", parsed.slug)
        }
    };
    let mut line = format!("Source: {main}");
    if let Some(r) = &req.reference {
        line.push_str(&format!(" {DIM}@ {YELLOW}{r}{RESET}"));
    }
    println!("{line}");
}