agentty 0.12.5

Agentty is an ADE (Agentic Development Environment) for structured, controllable AI-assisted software development.
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

use std::path::{Path, PathBuf};

/// Persisted project metadata used for multi-project management.
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct Project {
    pub created_at: i64,
    pub display_name: Option<String>,
    pub git_branch: Option<String>,
    pub id: i64,
    pub is_favorite: bool,
    pub last_opened_at: Option<i64>,
    pub path: PathBuf,
    pub updated_at: i64,
}

impl Project {
    /// Returns the preferred project label for UI rendering.
    #[must_use]
    pub fn display_label(&self) -> String {
        if let Some(display_name) = self.display_name.as_deref()
            && !display_name.trim().is_empty()
        {
            return display_name.to_string();
        }

        project_name_from_path(self.path.as_path())
    }
}

/// Aggregated project snapshot for list and switcher views.
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct ProjectListItem {
    /// Number of sessions still in an active lifecycle state.
    pub active_session_count: u32,
    /// Total input tokens accumulated by sessions in this project.
    pub input_tokens: u64,
    /// Most recent session update timestamp for this project.
    pub last_session_updated_at: Option<i64>,
    /// Total output tokens accumulated by sessions in this project.
    pub output_tokens: u64,
    /// Persisted project metadata for display and selection.
    pub project: Project,
    /// Total number of sessions belonging to this project.
    pub session_count: u32,
}

/// Derives a readable project name from its filesystem path.
#[must_use]
pub fn project_name_from_path(path: &Path) -> String {
    path.file_name()
        .and_then(|name| name.to_str())
        .unwrap_or_default()
        .to_string()
}

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

    #[test]
    fn test_display_label_prefers_display_name() {
        // Arrange
        let project = Project {
            created_at: 0,
            display_name: Some("Agentty".to_string()),
            git_branch: Some("main".to_string()),
            id: 1,
            is_favorite: false,
            last_opened_at: None,
            path: PathBuf::from("/tmp/agentty"),
            updated_at: 0,
        };

        // Act
        let label = project.display_label();

        // Assert
        assert_eq!(label, "Agentty");
    }

    #[test]
    fn test_display_label_falls_back_to_path_folder_name() {
        // Arrange
        let project = Project {
            created_at: 0,
            display_name: None,
            git_branch: Some("main".to_string()),
            id: 1,
            is_favorite: false,
            last_opened_at: None,
            path: PathBuf::from("/tmp/agentty"),
            updated_at: 0,
        };

        // Act
        let label = project.display_label();

        // Assert
        assert_eq!(label, "agentty");
    }
}