lazyspec 0.8.0

A little TUI & CLI for project documentation.
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
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

use anyhow::{bail, Result};
use std::path::Path;
use std::process::Command;

pub fn resolve_agent_id(root: &Path) -> Result<String> {
    resolve_agent_id_with_env(
        root,
        std::env::var("LAZYSPEC_AGENT_ID").ok(),
        std::env::var("CLAUDE_SESSION_ID").ok(),
    )
}

pub fn resolve_agent_id_with_env(
    root: &Path,
    lazyspec_agent_id: Option<String>,
    claude_session_id: Option<String>,
) -> Result<String> {
    if let Some(id) = lazyspec_agent_id.filter(|s| !s.is_empty()) {
        return Ok(id);
    }

    if let Some(id) = claude_session_id.filter(|s| !s.is_empty()) {
        return Ok(id);
    }

    let output = Command::new("git")
        .args(["config", "user.name"])
        .current_dir(root)
        .output()?;

    if !output.status.success() {
        bail!("git config user.name failed; set $LAZYSPEC_AGENT_ID or configure git user.name");
    }

    let user_name = String::from_utf8_lossy(&output.stdout).trim().to_string();
    if user_name.is_empty() {
        bail!("git config user.name is empty; set $LAZYSPEC_AGENT_ID or configure git user.name");
    }

    Ok(user_name)
}

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

    #[test]
    fn uses_lazyspec_agent_id_when_set() {
        let result =
            resolve_agent_id_with_env(Path::new("/tmp/fake"), Some("my-agent".into()), None)
                .unwrap();
        assert_eq!(result, "my-agent");
    }

    #[test]
    fn uses_claude_session_id_when_lazyspec_unset() {
        let result =
            resolve_agent_id_with_env(Path::new("/tmp/fake"), None, Some("sess-123".into()))
                .unwrap();
        assert_eq!(result, "sess-123");
    }

    #[test]
    fn lazyspec_agent_id_takes_priority_over_claude_session_id() {
        let result = resolve_agent_id_with_env(
            Path::new("/tmp/fake"),
            Some("agent-1".into()),
            Some("sess-123".into()),
        )
        .unwrap();
        assert_eq!(result, "agent-1");
    }

    #[test]
    fn empty_strings_treated_as_unset() {
        let result =
            resolve_agent_id_with_env(Path::new("/tmp/fake"), Some("".into()), Some("sess".into()))
                .unwrap();
        assert_eq!(result, "sess");
    }

    #[test]
    fn falls_back_to_git_config_username() {
        let dir = TempDir::new().unwrap();
        let root = dir.path();

        Command::new("git")
            .args(["init"])
            .current_dir(root)
            .output()
            .unwrap();
        Command::new("git")
            .args(["config", "user.name", "TestUser"])
            .current_dir(root)
            .output()
            .unwrap();

        let result = resolve_agent_id_with_env(root, None, None).unwrap();
        assert_eq!(result, "TestUser");
    }

    #[test]
    fn both_empty_strings_falls_back_to_git() {
        let dir = TempDir::new().unwrap();
        let root = dir.path();

        Command::new("git")
            .args(["init"])
            .current_dir(root)
            .output()
            .unwrap();
        Command::new("git")
            .args(["config", "user.name", "GitUser"])
            .current_dir(root)
            .output()
            .unwrap();

        let result = resolve_agent_id_with_env(root, Some("".into()), Some("".into())).unwrap();
        assert_eq!(result, "GitUser");
    }
}