tj_core/classifier/
mod.rs

1//! Event classifier: takes a chat chunk + recent task context,
2//! returns suggested event_type + task_id + confidence.
3
4use crate::event::{EventType, EvidenceStrength};
5use serde::{Deserialize, Serialize};
6
7#[derive(Debug, Clone, Serialize)]
8pub struct ClassifyInput {
9    pub text: String,
10    pub author_hint: String,
11    pub recent_tasks: Vec<TaskContext>,
12}
13
14#[derive(Debug, Clone, Serialize)]
15pub struct TaskContext {
16    pub task_id: String,
17    pub title: String,
18    pub last_events: Vec<String>,
19}
20
21#[derive(Debug, Clone, Deserialize, Serialize)]
22pub struct ClassifyOutput {
23    pub event_type: EventType,
24    pub task_id_guess: Option<String>,
25    pub confidence: f64,
26    pub evidence_strength: Option<EvidenceStrength>,
27    pub suggested_text: String,
28}
29
30pub trait Classifier: Send + Sync {
31    fn classify(&self, input: &ClassifyInput) -> anyhow::Result<ClassifyOutput>;
32}
33
34use crate::event::EventStatus;
35
36pub const CONFIDENCE_THRESHOLD: f64 = 0.85;
37
38pub fn decide_status(confidence: f64) -> EventStatus {
39    if confidence >= CONFIDENCE_THRESHOLD {
40        EventStatus::Confirmed
41    } else {
42        EventStatus::Suggested
43    }
44}
45
46pub mod cli;
47pub mod http;
48pub mod mock;
49pub mod prompt;
50pub mod telemetry;
51
52#[cfg(test)]
53mod tests {
54    use super::*;
55
56    /// Both classifiers must honour `TJ_CLASSIFIER_MODEL`. Combined into a
57    /// single test to avoid env-var races with other tests in this crate;
58    /// inside the test we serialize the read-set-restore steps.
59    #[test]
60    fn tj_classifier_model_env_var_overrides_defaults_for_both_backends() {
61        let prev_model = std::env::var("TJ_CLASSIFIER_MODEL").ok();
62        let prev_key = std::env::var("ANTHROPIC_API_KEY").ok();
63
64        // Unset → defaults.
65        // SAFETY: tests in this crate do not concurrently read these env vars.
66        unsafe {
67            std::env::remove_var("TJ_CLASSIFIER_MODEL");
68        }
69
70        let cli_default = cli::ClaudeCliClassifier::default();
71        assert_eq!(cli_default.model, cli::DEFAULT_MODEL);
72
73        unsafe {
74            std::env::set_var("ANTHROPIC_API_KEY", "test-key-do-not-use");
75        }
76        let http_default = http::AnthropicClassifier::from_env().unwrap();
77        assert_eq!(http_default.model, http::DEFAULT_MODEL);
78
79        // Set → override applied to both.
80        unsafe {
81            std::env::set_var("TJ_CLASSIFIER_MODEL", "sonnet-override");
82        }
83        let cli_override = cli::ClaudeCliClassifier::default();
84        assert_eq!(cli_override.model, "sonnet-override");
85
86        let http_override = http::AnthropicClassifier::from_env().unwrap();
87        assert_eq!(http_override.model, "sonnet-override");
88
89        // Restore.
90        unsafe {
91            match prev_model {
92                Some(v) => std::env::set_var("TJ_CLASSIFIER_MODEL", v),
93                None => std::env::remove_var("TJ_CLASSIFIER_MODEL"),
94            }
95            match prev_key {
96                Some(v) => std::env::set_var("ANTHROPIC_API_KEY", v),
97                None => std::env::remove_var("ANTHROPIC_API_KEY"),
98            }
99        }
100    }
101
102    #[test]
103    fn classify_input_serializes() {
104        let i = ClassifyInput {
105            text: "Adopted Rust for the journal".into(),
106            author_hint: "assistant".into(),
107            recent_tasks: vec![],
108        };
109        let s = serde_json::to_string(&i).unwrap();
110        assert!(s.contains("Adopted Rust"));
111    }
112
113    #[test]
114    fn decide_status_high_confidence_is_confirmed() {
115        assert_eq!(decide_status(0.95), EventStatus::Confirmed);
116        assert_eq!(decide_status(0.85), EventStatus::Confirmed);
117    }
118
119    #[test]
120    fn decide_status_low_confidence_is_suggested() {
121        assert_eq!(decide_status(0.84), EventStatus::Suggested);
122        assert_eq!(decide_status(0.0), EventStatus::Suggested);
123    }
124}
tj_core/classifier/mod.rs

tj_core/classifier/
mod.rs
