aiseo 0.7.2

Agent-first CLI for SEO, GEO (generative engine optimisation), and AEO (answer engine optimisation) audits.
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

//! Verify the semantic exit-code contract (0-4).
//!
//! Uses the hidden `contract` command for deterministic triggers and
//! real commands for natural exit-code coverage.

use assert_cmd::Command;
use std::io::Write;

fn bin() -> Command {
    Command::cargo_bin(env!("CARGO_PKG_NAME")).unwrap()
}

fn fixture() -> tempfile::NamedTempFile {
    let mut f = tempfile::Builder::new()
        .suffix(".html")
        .tempfile()
        .unwrap();
    writeln!(f, "<html><body><h1>x</h1></body></html>").unwrap();
    f
}

// ── Contract command: deterministic 0-4 ────────────────────────────────────

#[test]
fn contract_exit_0() {
    bin().args(["contract", "0"]).assert().code(0);
}

#[test]
fn contract_exit_1_transient() {
    bin().args(["contract", "1"]).assert().code(1);
}

#[test]
fn contract_exit_2_config() {
    bin().args(["contract", "2"]).assert().code(2);
}

#[test]
fn contract_exit_3_bad_input() {
    bin().args(["contract", "3"]).assert().code(3);
}

#[test]
fn contract_exit_4_rate_limited() {
    bin().args(["contract", "4"]).assert().code(4);
}

// ── Real commands: natural exit codes ──────────────────────────────────────

#[test]
fn audit_success_exits_0() {
    let f = fixture();
    bin().args(["audit", f.path().to_str().unwrap()]).assert().code(0);
}

#[test]
fn help_exits_0() {
    bin().arg("--help").assert().code(0);
}

#[test]
fn version_exits_0() {
    bin().arg("--version").assert().code(0);
}

#[test]
fn agent_info_exits_0() {
    bin().arg("agent-info").assert().code(0);
}

#[test]
fn config_path_exits_0() {
    bin().args(["config", "path"]).assert().code(0);
}

#[test]
fn config_show_exits_0() {
    bin().args(["config", "show"]).assert().code(0);
}

#[test]
fn missing_subcommand_exits_3() {
    // No subcommand at all is a parse error.
    bin().assert().code(3);
}

#[test]
fn audit_missing_file_exits_3() {
    // `audit` requires a positional <file>.
    bin().arg("audit").assert().code(3);
}

#[test]
fn audit_nonexistent_file_exits_3() {
    bin()
        .args(["audit", "/tmp/aiseo-does-not-exist.html"])
        .assert()
        .code(3);
}