brgr-cli 2.15.21

Let Codex or Claude Code hand work to other coding agents, each in its own Herdr pane: the brgr CLI and Herdr plugin.
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

use anyhow::{Result, bail};
use clap::ValueEnum;

#[derive(Clone, Copy, Debug, Default, Eq, PartialEq, ValueEnum)]
pub(crate) enum ModeRequest {
    #[default]
    Pane,
    Headless,
    Auto,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub(crate) enum ResolvedMode {
    Pane,
    Headless,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub(crate) struct Resolution {
    pub(crate) mode: ResolvedMode,
    pub(crate) reason: &'static str,
}

pub(crate) fn resolve(
    requested: ModeRequest,
    pane_available: bool,
    headless_available: bool,
) -> Result<Resolution> {
    match requested {
        ModeRequest::Pane => Ok(Resolution {
            mode: ResolvedMode::Pane,
            reason: "requested",
        }),
        ModeRequest::Headless => Ok(Resolution {
            mode: ResolvedMode::Headless,
            reason: "requested",
        }),
        ModeRequest::Auto if pane_available => Ok(Resolution {
            mode: ResolvedMode::Pane,
            reason: "herdr pane available",
        }),
        ModeRequest::Auto if headless_available => Ok(Resolution {
            mode: ResolvedMode::Headless,
            reason: "no herdr pane in this environment",
        }),
        ModeRequest::Auto => bail!(
            "cannot resolve --mode auto: no Herdr pane is available and the harness has no headless recipe"
        ),
    }
}

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

    #[test]
    fn explicit_modes_and_auto_resolve_from_only_the_two_route_facts() {
        for (pane_available, headless_available) in
            [(false, false), (false, true), (true, false), (true, true)]
        {
            assert_eq!(
                resolve(ModeRequest::Pane, pane_available, headless_available).unwrap(),
                Resolution {
                    mode: ResolvedMode::Pane,
                    reason: "requested"
                }
            );
            assert_eq!(
                resolve(ModeRequest::Headless, pane_available, headless_available).unwrap(),
                Resolution {
                    mode: ResolvedMode::Headless,
                    reason: "requested"
                }
            );
            if pane_available {
                assert_eq!(
                    resolve(ModeRequest::Auto, pane_available, headless_available).unwrap(),
                    Resolution {
                        mode: ResolvedMode::Pane,
                        reason: "herdr pane available"
                    }
                );
            } else if headless_available {
                assert_eq!(
                    resolve(ModeRequest::Auto, pane_available, headless_available).unwrap(),
                    Resolution {
                        mode: ResolvedMode::Headless,
                        reason: "no herdr pane in this environment"
                    }
                );
            } else {
                let error = resolve(ModeRequest::Auto, pane_available, headless_available)
                    .unwrap_err()
                    .to_string();
                assert!(error.contains("no Herdr pane"));
                assert!(error.contains("no headless recipe"));
            }
        }
    }
}