ljos 0.41.2

Memory, a work tracker and a shell-command gate for coding runners (Claude Code, Codex, Grok Build, agy, opencode) over MCP and 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
85
86
87
88
89
90
91
92
93
94
95
96

//! `ljos --help` groups commands. Hidden ones still run.

ljos_test_boot::harness!();
use std::process::Command;

fn run(args: &[&str]) -> std::process::Output {
    Command::new(env!("CARGO_BIN_EXE_ljos"))
        .args(args)
        .env("LJOS_OFF", "1")
        .output()
        .unwrap()
}

fn text(out: &std::process::Output) -> String {
    format!(
        "status {}\n{}{}",
        out.status,
        String::from_utf8_lossy(&out.stdout),
        String::from_utf8_lossy(&out.stderr)
    )
}

fn command_names(help: &str) -> Vec<&str> {
    help.lines()
        .filter_map(|line| {
            let rest = line.strip_prefix("  ")?;
            if rest.starts_with('-') || rest.starts_with(' ') {
                return None;
            }
            rest.split_whitespace().next()
        })
        .collect()
}

#[test]
fn help_groups_the_short_list_and_all_lists_the_rest() {
    let out = run(&["--help"]);
    assert!(out.status.success(), "{}", text(&out));
    let help = String::from_utf8(out.stdout).unwrap();
    let mut at = 0;
    for heading in [
        "Start:",
        "Daily:",
        "Tracker:",
        "Memory:",
        "Coordination:",
        "Admin:",
    ] {
        let found = help
            .find(heading)
            .unwrap_or_else(|| panic!("missing {heading}\n{help}"));
        assert!(found >= at, "{heading} is out of order");
        at = found;
    }
    let names = command_names(&help);
    assert_eq!(names.first().copied(), Some("doctor"), "{names:?}");
    let start = help.find("Start:").expect("Start");
    let daily = help.find("Daily:").expect("Daily");
    let admin = help.find("Admin:").expect("Admin");
    assert_eq!(
        command_names(&help[start..daily]),
        [
            "doctor", "onboard", "protocol", "prefer", "remember", "search", "sitting", "finish",
            "due", "help",
        ]
    );
    assert_eq!(
        command_names(&help[admin..]).first().copied(),
        Some("policy")
    );
    for hidden in ["merge-org", "hook", "bump-plan", "retire-notes", "slot"] {
        assert!(!names.contains(&hidden), "{hidden} is on the short list");
    }
    assert!(help.contains("`ljos help --all` lists every command."));

    let out = run(&["help", "--all"]);
    assert!(out.status.success(), "{}", text(&out));
    let all = String::from_utf8(out.stdout).unwrap();
    let all_names = command_names(&all);
    for hidden in ["merge-org", "hook", "bump-plan", "retire-notes", "slot"] {
        assert!(
            all_names.contains(&hidden),
            "{hidden} missing from help --all"
        );
    }

    for args in [
        &["merge-org", "--help"][..],
        &["hook", "--help"][..],
        &["help", "merge-org"][..],
        &["help", "hook"][..],
    ] {
        let out = run(args);
        assert!(out.status.success(), "{}: {}", args.join(" "), text(&out));
    }
}