borg-ai 0.5.0

Collective mind for coding-agent drones: CLI and harness hooks
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

//! The simulated harness, for the conformance suites (tests/conformance_cli.rs, docs/harnesses.md):
//! command hooks in `~/.sim/hooks.json`, under native event names of its own, and capabilities from
//! `BORG_SIM_CAPS`, so every capability branch of the core is reachable from one binary without any
//! third-party agent. Hidden: never in help, completions, `all`, status or doctor, and known by name
//! only to a process with `BORG_TEST_HARNESS` set (`TEST_ENV`), as the suites run it.

use std::path::{Path, PathBuf};

use super::{Caps, DroneWake, Harness, Probe, Transcript, Wiring};

/// Native names unlike any real harness's: the event table, not a name, decides the canonical event.
pub const EVENTS: [(&str, &str); 6] = [
    ("SimPrompt", "prompt"),
    ("SimPreTool", "pre_tool"),
    ("SimPostTool", "post_tool"),
    ("SimPostToolFailure", "post_tool_failure"),
    ("SimStop", "stop"),
    ("SimEnd", "end"),
];

pub const CAPS_ENV: &str = "BORG_SIM_CAPS";

/// Without `BORG_SIM_CAPS`: context at the prompt and after a tool call, denials captured, nothing else.
const DEFAULT_CAPS: &str = "prompt,tool,deny";

pub struct Sim;

/// The flags in a comma list: prompt, tool, early, dialog, transcript, deny, pid.
pub fn caps_of(list: &str) -> Caps {
    let on = |f: &str| list.split(',').any(|x| x.trim() == f);
    Caps {
        prompt_context: on("prompt"),
        tool_context: on("tool"),
        early_delivery: on("early"),
        question_dialog: on("dialog"),
        transcript: if on("transcript") { Transcript::Claude } else { Transcript::None },
        deny_capture: on("deny"),
        sends_pid: on("pid"),
        stop_budget: None,
        session_env: None,
        pid_env: None,
        drone_wake: DroneWake::Model,
    }
}

impl Harness for Sim {
    fn name(&self) -> &'static str {
        "sim"
    }

    fn caps(&self) -> Caps {
        caps_of(&std::env::var(CAPS_ENV).unwrap_or_else(|_| DEFAULT_CAPS.into()))
    }

    fn wiring(&self) -> Wiring {
        Wiring::CommandHooks { events: &EVENTS, timeouts: &[("stop", 90)], retired: &[], through_links: false }
    }

    fn target(&self, home: &Path, _var: &dyn Fn(&str) -> Option<PathBuf>) -> PathBuf {
        home.join(".sim/hooks.json")
    }

    fn probe(&self) -> Probe {
        Probe { cli: "sim", tested: "" }
    }

    fn hidden(&self) -> bool {
        true
    }
}

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

    #[test]
    fn caps_come_from_the_list() {
        let c = caps_of("early,transcript");
        assert!(c.early_delivery && !c.question_dialog && !c.prompt_context);
        assert_eq!(c.transcript, Transcript::Claude);
        let d = caps_of(DEFAULT_CAPS);
        assert!(d.prompt_context && d.tool_context && d.deny_capture && !d.early_delivery && !d.sends_pid);
    }
}