cueloop 0.5.0

A Rust CLI for managing AI agent loops with a structured JSON task queue
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

//! Release script help output contract tests.
//!
//! Purpose:
//! - Release script help output contract tests.
//!
//! Responsibilities:
//! - Assert that scripts/release.sh --help exits successfully.
//! - Verify help output contains the explicit transaction command model and reconcile flow.
//!
//! Not handled here:
//! - Full validation of release process behavior.
//! - Testing actual release creation (requires git/credentials).
//!
//!
//! Usage:
//! - Used through the crate module tree or integration test harness.
//!
//! Invariants/assumptions:
//! - The release.sh script exists at scripts/release.sh relative to repo root.
//! - Bash is available to execute the script.

use std::path::PathBuf;
use std::process::{Command, ExitStatus};

fn repo_root() -> PathBuf {
    let crate_dir = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
    crate_dir
        .parent()
        .expect("crate directory should have a parent")
        .parent()
        .expect("crates directory should have a parent repo root")
        .to_path_buf()
}

fn release_script() -> PathBuf {
    repo_root().join("scripts").join("release.sh")
}

fn run_help(args: &[&str]) -> (ExitStatus, String, String) {
    let script = release_script();
    let output = Command::new("bash")
        .arg(&script)
        .args(args)
        .output()
        .expect("failed to execute release.sh script");
    (
        output.status,
        String::from_utf8_lossy(&output.stdout).to_string(),
        String::from_utf8_lossy(&output.stderr).to_string(),
    )
}

fn assert_contains(haystack: &str, needle: &str) {
    assert!(
        haystack.contains(needle),
        "expected output to contain {needle:?}\n--- output ---\n{haystack}\n--- end ---"
    );
}

#[test]
fn release_script_help_exits_successfully() {
    let (status, stdout, stderr) = run_help(&["--help"]);
    assert!(
        status.success(),
        "expected `release.sh --help` to succeed\nstdout:\n{stdout}\nstderr:\n{stderr}"
    );

    let combined = format!("{stdout}\n{stderr}");

    // Verify key sections are present
    assert_contains(&combined, "verify <version>");
    assert_contains(&combined, "execute <version>");
    assert_contains(&combined, "reconcile <version>");
    assert_contains(&combined, "GitHub draft release");
    assert_contains(&combined, "crates.io");
    assert_contains(&combined, "Usage:");
    assert_contains(&combined, "Commands:");
    assert_contains(&combined, "Release model:");
}

#[test]
fn release_script_short_help_exits_successfully() {
    let (status, stdout, stderr) = run_help(&["-h"]);
    assert!(
        status.success(),
        "expected `release.sh -h` to succeed\nstdout:\n{stdout}\nstderr:\n{stderr}"
    );

    let combined = format!("{stdout}\n{stderr}");

    assert_contains(&combined, "verify <version>");
    assert_contains(&combined, "reconcile <version>");
}

#[test]
fn release_script_no_args_shows_usage_and_exits_error() {
    let (status, stdout, stderr) = run_help(&[]);
    assert!(!status.success(), "expected `release.sh` (no args) to fail");

    let combined = format!("{stdout}\n{stderr}");

    // Should show usage information
    assert_contains(&combined, "Usage:");
    assert_contains(&combined, "VERSION is required");
}

#[test]
fn release_script_help_contains_examples() {
    let (status, stdout, stderr) = run_help(&["--help"]);
    assert!(status.success(), "expected `release.sh --help` to succeed");

    let combined = format!("{stdout}\n{stderr}");

    assert_contains(&combined, "scripts/release.sh verify 0.2.0");
    assert_contains(&combined, "scripts/release.sh execute 0.2.0");
    assert_contains(&combined, "scripts/release.sh reconcile 0.2.0");
}

#[test]
fn release_script_help_contains_version_format() {
    let (status, stdout, stderr) = run_help(&["--help"]);
    assert!(status.success(), "expected `release.sh --help` to succeed");

    let combined = format!("{stdout}\n{stderr}");

    // Verify version format is documented
    assert_contains(&combined, "verify 0.2.0");
    assert_contains(&combined, "0.2.0");
}