linear-tui 0.8.0

A TUI client for Linear.app — manage issues, projects, and cycles from your terminal
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

//! herdr agents and the issues they work on, as the plugin reports them.

use super::*;
use crate::herdr::{AgentLink, Handoff};

impl App {
    /// Take the plugin's latest list of agents.
    pub fn set_agents(&mut self, agents: Vec<AgentLink>) {
        self.agents = agents;
    }

    /// The agent working on `identifier`: the one waiting for you first,
    /// then the one at work.
    pub fn agent_for(&self, identifier: &str) -> Option<&AgentLink> {
        self.agents
            .iter()
            .filter(|a| {
                a.issue
                    .as_deref()
                    .is_some_and(|i| i.eq_ignore_ascii_case(identifier))
            })
            .min_by_key(|a| a.status.rank())
    }

    /// `g w`: bring the pane of the agent working on the focused issue to
    /// the front.
    pub fn jump_to_agent(&mut self) {
        if !self.herdr {
            self.set_status("Jumping to an agent needs herdr");
            return;
        }
        let Some(identifier) = self.focused_issue().map(|i| i.identifier.clone()) else {
            return;
        };
        match self.agent_for(&identifier).map(|a| a.pane.clone()) {
            Some(pane) => self.request(Request::Herdr(Handoff::Focus { pane })),
            None => self.set_status(format!("No herdr agent is working on {identifier}")),
        }
    }
}

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

    fn app() -> App {
        let mut app = App::new(&Config::default());
        app.store.teams =
            vec![serde_json::from_str(r#"{"id":"t","name":"Engineering","key":"ENG"}"#).unwrap()];
        app.store.issues[IssueSource::Team].items = vec![
            serde_json::from_str(r#"{"id":"i1","identifier":"ENG-42","title":"t","priority":0}"#)
                .unwrap(),
        ];
        app.outbox.requests.clear();
        app
    }

    #[test]
    fn the_agent_that_needs_you_is_the_one_shown() {
        let mut app = app();
        app.set_agents(
            parse_agents(
                r#"{"version":1,"agents":[
                {"pane":"w1:p1","agent":"claude","status":"working","issue":"ENG-42"},
                {"pane":"w2:p1","agent":"codex","status":"blocked","issue":"eng-42"},
                {"pane":"w3:p1","agent":"claude","status":"idle"}]}"#,
            )
            .unwrap(),
        );
        assert_eq!(app.agent_for("ENG-42").unwrap().pane, "w2:p1");
        assert!(app.agent_for("ENG-7").is_none());
    }

    #[test]
    fn jumping_asks_the_plugin_to_focus_the_agents_pane() {
        let mut app = app();
        app.herdr = true;
        app.jump_to_agent();
        assert!(app.outbox.requests.is_empty());
        assert_eq!(
            app.view.status_message.as_deref(),
            Some("No herdr agent is working on ENG-42")
        );

        app.set_agents(
            parse_agents(
                r#"{"version":1,"agents":[{"pane":"w1:p1","agent":"claude","status":"working","issue":"ENG-42"}]}"#,
            )
            .unwrap(),
        );
        app.jump_to_agent();
        assert_eq!(
            app.outbox.requests.front(),
            Some(&Request::Herdr(Handoff::Focus {
                pane: "w1:p1".into()
            }))
        );
    }
}