tga 2.15.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
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

//! Linear issue enrichment for the Stage 1 collection pipeline.
//!
//! Why: this was inline in [`crate::collect::collector::CollectionPipeline::run`],
//! which sits over the 500-SLOC production cap on a frozen ratchet budget.
//! Lifting it out mirrors the existing `github_pipeline` split and keeps
//! `collector.rs` shrinking rather than growing (#5197).
//! What: [`fetch_and_store_linear_issues`] — reads every commit message, asks
//! the Linear client which referenced issues exist, and persists them. Behavior
//! is unchanged from the inline version: every failure is non-fatal and lands
//! in `stats.errors`.
//! Test: covered by `linear`'s own client tests; the orchestration here is
//! exercised end-to-end by the gated integration tests.

use tracing::info;

use crate::collect::collector::CollectionStats;
use crate::collect::linear::LinearClient;
use crate::core::config::Config;
use crate::core::db::Database;

/// Fetch and persist the Linear issues referenced by collected commits.
///
/// Why: Linear identifiers appear in commit messages, and the issue's state and
/// team are what turn a bare `ENG-123` into something a report can group by.
/// What: no-ops unless `linear.fetch_on_reference` is set. Otherwise collects
/// every commit message, calls `fetch_referenced_issues`, and stores the result
/// into `linear_issues`. Every failure — client init, query, store — is pushed
/// into `stats.errors` and returns without aborting the surrounding run.
/// Test: exercised by the gated integration tests; the client half is unit-tested
/// in `crate::collect::linear`.
pub(super) async fn fetch_and_store_linear_issues(
    db: &mut Database,
    config: &Config,
    stats: &mut CollectionStats,
) {
    // Optional: Linear issue enrichment.
    if let Some(linear_cfg) = &config.linear {
        if linear_cfg.fetch_on_reference {
            match LinearClient::new(linear_cfg) {
                Ok(client) => {
                    // Collect commit messages from DB.
                    let messages: Vec<String> = {
                        let conn = db.connection();
                        let mut stmt = match conn.prepare("SELECT message FROM commits") {
                            Ok(s) => s,
                            Err(e) => {
                                stats
                                    .errors
                                    .push(format!("Linear: query commits failed: {e}"));
                                return;
                            }
                        };
                        let rows = match stmt.query_map([], |row| row.get::<_, String>(0)) {
                            Ok(r) => r,
                            Err(e) => {
                                stats
                                    .errors
                                    .push(format!("Linear: read commits failed: {e}"));
                                return;
                            }
                        };
                        let mut out = Vec::new();
                        for r in rows.flatten() {
                            out.push(r);
                        }
                        out
                    };

                    let msg_refs: Vec<&str> = messages.iter().map(String::as_str).collect();
                    let issues = client
                        .fetch_referenced_issues(&msg_refs, &linear_cfg.team_keys)
                        .await;
                    for issue in &issues {
                        info!(
                            id = %issue.identifier,
                            state = %issue.state,
                            team = %issue.team,
                            "Linear issue fetched"
                        );
                    }
                    match client.store_issues(db, &issues) {
                        Ok(n) => {
                            info!(stored = n, "persisted linear_issues rows");
                            stats.linear_issues_fetched += n;
                        }
                        Err(e) => {
                            stats
                                .errors
                                .push(format!("Linear: store issues failed: {e}"));
                        }
                    }
                }
                Err(e) => {
                    stats.errors.push(format!("Linear client init failed: {e}"));
                }
            }
        }
    }
}