llman 0.0.46

A tool for managing LLM application rules(prompts) ...
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

use super::config::{SddConfig, load_or_create_config, write_default_config};
use super::fs_utils::update_file_with_markers;
use super::templates::root_stub_content;
use super::update_skills;
use crate::sdd::shared::constants::{LLMANSPEC_DIR_NAME, LLMANSPEC_MARKERS};
use anyhow::{Result, anyhow};
use std::fs;
use std::path::Path;

pub fn run(target: &Path, locale: Option<&str>, update: bool) -> Result<()> {
    ensure_directory(target)?;
    let llmanspec_path = target.join(LLMANSPEC_DIR_NAME);

    if update {
        if !llmanspec_path.exists() {
            return Err(anyhow!(
                "No llmanspec directory found. Run 'llman sdd init' first."
            ));
        }
    } else {
        if llmanspec_path.exists() {
            return Err(anyhow!("llmanspec directory already exists"));
        }
        create_structure(&llmanspec_path)?;
        write_default_config(&llmanspec_path, locale.unwrap_or("en"))?;
    }

    let config = load_or_create_config(&llmanspec_path)?;
    write_root_agents_file(target, &config)?;
    update_skills::run_with_root(target)?;

    Ok(())
}

fn ensure_directory(target: &Path) -> Result<()> {
    if target.exists() {
        if !target.is_dir() {
            return Err(anyhow!("Target path is not a directory"));
        }
        return Ok(());
    }
    fs::create_dir_all(target)?;
    Ok(())
}

fn create_structure(llmanspec_path: &Path) -> Result<()> {
    let specs = llmanspec_path.join("specs");
    fs::create_dir_all(&specs)?;
    fs::write(specs.join(".gitkeep"), "")?;

    let archive = llmanspec_path.join("changes").join("archive");
    fs::create_dir_all(&archive)?;
    fs::write(archive.join(".gitkeep"), "")?;

    Ok(())
}

fn write_root_agents_file(target: &Path, config: &SddConfig) -> Result<()> {
    let agents_path = target.join("AGENTS.md");
    let content = root_stub_content(config, target)?;
    update_file_with_markers(
        &agents_path,
        &content,
        LLMANSPEC_MARKERS.start,
        LLMANSPEC_MARKERS.end,
    )?;
    Ok(())
}