cmt 0.5.16

CLI tool that generates commit messages using AI
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

//! Default values for configuration

// General defaults
pub const MESSAGE_ONLY: bool = false;
pub const NO_DIFF_STATS: bool = false;
pub const SHOW_RAW_DIFF: bool = false;
pub const CONTEXT_LINES: u32 = 20; // Full function context - Gemini Flash supports 1M tokens
pub const MAX_LINES_PER_FILE: usize = 2000; // Allow large files - we have token budget
pub const MAX_LINE_WIDTH: usize = 500; // Allow wider lines for better context
pub const MAX_FILE_LINES: usize = 5000; // Threshold for prompting to add to .cmtignore

// Cmtignore defaults
pub const CMTIGNORE_FILENAME: &str = ".cmtignore";

// AI provider defaults
pub const DEFAULT_PROVIDER: &str = "gemini";

// Git defaults
pub const INCLUDE_RECENT_COMMITS: bool = true;
pub const RECENT_COMMITS_COUNT: usize = 10; // More history for better context

// File paths
pub const DEFAULT_CONFIG_FILENAME: &str = ".cmt.toml";
pub const GLOBAL_CONFIG_DIRNAME: &str = ".config/cmt";
pub const GLOBAL_CONFIG_FILENAME: &str = "config.toml";

// Template defaults
pub const DEFAULT_TEMPLATE: &str = "conventional";

// Available providers
pub const AVAILABLE_PROVIDERS: &[&str] = &["claude", "openai", "gemini"];

// Last Verified: 2025-12-29 (use dated version - Anthropic API doesn't accept -latest aliases)
pub const DEFAULT_CLAUDE_MODEL: &str = "claude-sonnet-4-5-20250929";
// Last Verified: 2025-12-29
pub const DEFAULT_OPENAI_MODEL: &str = "gpt-5.2";
// Last Verified: 2025-12-29 (use -preview suffix for Gemini 3 models)
pub const DEFAULT_GEMINI_MODEL: &str = "gemini-3-flash-preview";

// Available templates
pub const AVAILABLE_TEMPLATES: &[&str] = &["conventional", "simple", "detailed"];

/// Example configuration for initialization
pub fn example_config() -> String {
    format!(
        r#"# cmt configuration file

# General options
message_only = {}
no_diff_stats = {}
show_raw_diff = {}
context_lines = {}
max_lines_per_file = {}
max_line_width = {}
max_file_lines = {}

# AI provider options
provider = "{}"  # Options: {}
# model = "{}"  # Uncomment to set a specific model
# temperature = 0.3  # Uncomment to set a specific temperature

# Git options
include_recent_commits = {}
recent_commits_count = {}

# Template options
# template = "{}"  # Uncomment to use a specific template

# You can add a default hint that will be used for all commits
# hint = "Focus on the technical details"
"#,
        MESSAGE_ONLY,
        NO_DIFF_STATS,
        SHOW_RAW_DIFF,
        CONTEXT_LINES,
        MAX_LINES_PER_FILE,
        MAX_LINE_WIDTH,
        MAX_FILE_LINES,
        DEFAULT_PROVIDER,
        AVAILABLE_PROVIDERS.join(", "),
        DEFAULT_CLAUDE_MODEL,
        INCLUDE_RECENT_COMMITS,
        RECENT_COMMITS_COUNT,
        DEFAULT_TEMPLATE,
    )
}

/// Simple template
pub fn simple_template() -> String {
    r#"{{{subject}}}

{{{details}}}"#
        .to_string()
}

/// Conventional commits template (triple braces to avoid HTML escaping)
pub fn conventional_template() -> String {
    r#"{{type}}{{#if scope}}({{{scope}}}){{/if}}: {{{subject}}}

{{#if details}}
{{{details}}}
{{/if}}"#
        .to_string()
}

/// Detailed template (triple braces to avoid HTML escaping)
pub fn detailed_template() -> String {
    r#"{{type}}{{#if scope}}({{{scope}}}){{/if}}: {{{subject}}}

{{#if details}}
{{{details}}}
{{/if}}

{{#if issues}}
Fixes: {{{issues}}}
{{/if}}

{{#if breaking}}
BREAKING CHANGE: {{{breaking}}}
{{/if}}"#
        .to_string()
}