agentty 0.11.1

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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

//! Domain model for persisted application setting keys.

use std::fmt;

/// Stable keys used in the `setting` and `project_setting` tables.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub(crate) enum SettingName {
    /// Persists the active project selection.
    ActiveProjectId,
    /// Persists the selected reasoning-effort level.
    ReasoningLevel,
    /// Persists the provider that owns the fast-model default.
    DefaultFastAgent,
    /// Persists the project or global fast-model selection.
    DefaultFastModel,
    /// Persists the provider that owns the review-model default.
    DefaultReviewAgent,
    /// Persists the project or global review-model selection.
    DefaultReviewModel,
    /// Persists the provider that owns the smart-model default.
    DefaultSmartAgent,
    /// Persists the project or global smart-model selection.
    DefaultSmartModel,
    /// Persists whether generated session commits append the Agentty coauthor
    /// trailer.
    IncludeCoauthoredByAgentty,
    /// Persists the configured open-command override.
    OpenCommand,
    /// Persists whether the last used model should become the default.
    LastUsedModelAsDefault,
    /// Persists the active terminal color theme.
    Theme,
}

impl SettingName {
    /// Returns the persisted key string for one setting.
    pub(crate) fn as_str(self) -> &'static str {
        match self {
            Self::ActiveProjectId => "ActiveProjectId",
            Self::ReasoningLevel => "ReasoningLevel",
            Self::DefaultFastAgent => "DefaultFastAgent",
            Self::DefaultFastModel => "DefaultFastModel",
            Self::DefaultReviewAgent => "DefaultReviewAgent",
            Self::DefaultReviewModel => "DefaultReviewModel",
            Self::DefaultSmartAgent => "DefaultSmartAgent",
            Self::DefaultSmartModel => "DefaultSmartModel",
            Self::IncludeCoauthoredByAgentty => "IncludeCoauthoredByAgentty",
            Self::OpenCommand => "OpenCommand",
            Self::LastUsedModelAsDefault => "LastUsedModelAsDefault",
            Self::Theme => "Theme",
        }
    }
}

impl fmt::Display for SettingName {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        formatter.write_str(self.as_str())
    }
}

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

    /// Ensures every setting key keeps its persisted wire value.
    #[test]
    fn test_as_str_returns_persisted_keys() {
        // Arrange
        let settings = [
            (SettingName::ActiveProjectId, "ActiveProjectId"),
            (SettingName::ReasoningLevel, "ReasoningLevel"),
            (SettingName::DefaultFastAgent, "DefaultFastAgent"),
            (SettingName::DefaultFastModel, "DefaultFastModel"),
            (SettingName::DefaultReviewAgent, "DefaultReviewAgent"),
            (SettingName::DefaultReviewModel, "DefaultReviewModel"),
            (SettingName::DefaultSmartAgent, "DefaultSmartAgent"),
            (SettingName::DefaultSmartModel, "DefaultSmartModel"),
            (
                SettingName::IncludeCoauthoredByAgentty,
                "IncludeCoauthoredByAgentty",
            ),
            (SettingName::OpenCommand, "OpenCommand"),
            (
                SettingName::LastUsedModelAsDefault,
                "LastUsedModelAsDefault",
            ),
            (SettingName::Theme, "Theme"),
        ];

        // Act & Assert
        for (setting_name, expected_key) in settings {
            assert_eq!(setting_name.as_str(), expected_key);
        }
    }

    /// Ensures the display output stays aligned with the persisted key.
    #[test]
    fn test_display_matches_as_str() {
        // Arrange
        let settings = [
            SettingName::ActiveProjectId,
            SettingName::ReasoningLevel,
            SettingName::DefaultFastAgent,
            SettingName::DefaultFastModel,
            SettingName::DefaultReviewAgent,
            SettingName::DefaultReviewModel,
            SettingName::DefaultSmartAgent,
            SettingName::DefaultSmartModel,
            SettingName::IncludeCoauthoredByAgentty,
            SettingName::OpenCommand,
            SettingName::LastUsedModelAsDefault,
            SettingName::Theme,
        ];

        // Act & Assert
        for setting_name in settings {
            assert_eq!(setting_name.to_string(), setting_name.as_str());
        }
    }
}