zad-cli 0.9.4

Command-line interface for zad — connects AI agents to external services (Discord, Slack, Google Calendar, Spotify, Telegram, YouTube Music, 1Password) via scoped service configurations.
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
97
98

//! Tests for the top-level `zad --help-agent` flag mandated by
//! `OSS_SPEC.md` §12.1: compact, prompt-injectable plain text that lists
//! the CLI's commands, its most important flags and env vars, and points
//! an agent at the discovery surfaces (`commands`, `man`, `docs`).

use assert_cmd::Command;
use predicates::str::contains;

fn bin() -> Command {
    let mut c = Command::cargo_bin("zad").expect("zad binary built");
    c.env("ZAD_SECRETS_MEMORY", "1");
    c
}

#[test]
fn help_agent_succeeds_without_a_subcommand() {
    bin().arg("--help-agent").assert().success();
}

#[test]
fn help_agent_emits_plain_ascii_no_escape_sequences() {
    let out = bin()
        .arg("--help-agent")
        .assert()
        .success()
        .get_output()
        .stdout
        .clone();
    let body = String::from_utf8(out).expect("utf8 stdout");

    // Spliceable into a prompt: no ANSI escape byte.
    assert!(
        !body.contains('\u{1b}'),
        "help-agent output must contain no ANSI escapes"
    );
    // Short enough to not dominate a prompt — spec says 50-200 lines
    // typical. Give a generous ceiling so tiny copy tweaks don't fail
    // the test, but catch runaway output.
    let lines = body.lines().count();
    assert!(
        (5..=250).contains(&lines),
        "help-agent output was {lines} lines; expected 5..=250"
    );
}

#[test]
fn help_agent_names_the_binary_and_version() {
    let out = bin()
        .arg("--help-agent")
        .assert()
        .success()
        .get_output()
        .stdout
        .clone();
    let body = String::from_utf8(out).expect("utf8 stdout");

    assert!(body.contains("zad"), "binary name must appear");
    let version = env!("CARGO_PKG_VERSION");
    assert!(
        body.contains(version),
        "version `{version}` must appear in help-agent output"
    );
}

#[test]
fn help_agent_lists_top_level_commands() {
    bin()
        .arg("--help-agent")
        .assert()
        .success()
        .stdout(contains("service"))
        .stdout(contains("discord"));
}

#[test]
fn help_agent_points_at_discovery_surfaces() {
    // Per §12.1 requirements 4 & 5: must point at `commands`,
    // `commands <name>`, `docs`, `man`.
    bin()
        .arg("--help-agent")
        .assert()
        .success()
        .stdout(contains("zad commands"))
        .stdout(contains("zad man"))
        .stdout(contains("zad docs"));
}

#[test]
fn help_agent_documents_important_flags_and_env_vars() {
    bin()
        .arg("--help-agent")
        .assert()
        .success()
        .stdout(contains("--debug"))
        .stdout(contains("--help-agent"))
        .stdout(contains("ZAD_HOME_OVERRIDE"))
        .stdout(contains("ZAD_SECRETS_MEMORY"));
}