tga 2.7.0

Developer productivity analytics — git commit collection, classification, and reporting
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

//! Error types for the `classify` module.

use thiserror::Error;

/// Top-level error type for classification operations.
///
/// Why: classification touches the core layer (DB), the local filesystem
/// (rule files), regex compilation, and remote LLM calls — a single
/// uniform error keeps the cascade signatures clean.
/// What: `thiserror` enum with `From` impls for the common sources plus
/// domain variants for rule-load and provider-config failures.
/// Test: covered indirectly — any test that loads a malformed rule file
/// or exercises the LLM tier without an API key produces these variants.
#[derive(Debug, Error)]
pub enum ClassifyError {
    /// Wraps a core error (DB, config, etc.).
    #[error("core error: {0}")]
    Core(#[from] crate::core::TgaError),

    /// Failed to load or parse a rules file.
    #[error("rule load error: {0}")]
    RuleLoad(String),

    /// A regex pattern in the ruleset failed to compile.
    #[error("regex error: {0}")]
    Regex(#[from] regex::Error),

    /// HTTP request to an LLM provider failed.
    #[error("HTTP error: {0}")]
    Http(#[from] reqwest::Error),

    /// JSON serialization/deserialization failed.
    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),

    /// YAML deserialization failed (rule files).
    #[error("YAML error: {0}")]
    Yaml(#[from] serde_yaml::Error),

    /// Filesystem I/O failed.
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    /// A configuration value required for this operation was missing or
    /// invalid (e.g. unbuildable LLM provider).
    #[error("configuration error: {0}")]
    Config(String),
}

/// Module-wide `Result` alias.
///
/// Why: keeps signatures compact; matches the `Result<T>` pattern from
/// `core::errors::Result`.
/// What: alias for `std::result::Result<T, ClassifyError>`.
/// Test: exercised by every fallible function in `classify`.
pub type Result<T> = std::result::Result<T, ClassifyError>;