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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

//! Init command tests.
//!
//! Purpose:
//! - Init command tests.
//!
//! Responsibilities:
//! - Provide focused implementation or regression coverage for this file's owning feature.
//!
//! Scope:
//! - Limited to this file's owning feature boundary.
//!
//!
//! Usage:
//! - Used through the crate module tree or integration test harness.
//!
//! Invariants/Assumptions:
//! - Keep behavior aligned with CueLoop's canonical CLI, machine-contract, and queue semantics.

use super::*;

#[test]
fn init_creates_agents_md() -> Result<()> {
    let dir = TempDir::new()?;
    let resolved = create_test_resolved(&dir);
    fs::create_dir_all(resolved.repo_root.join("src"))?;

    let output_path = resolved.repo_root.join("AGENTS.md");
    let report = run_context_init(
        &resolved,
        ContextInitOptions {
            force: false,
            project_type_hint: None,
            output_path: output_path.clone(),
            interactive: false,
        },
    )?;

    assert_eq!(report.status, FileInitStatus::Created);
    assert!(output_path.exists());

    let content = fs::read_to_string(&output_path)?;
    assert!(content.contains("# Repository Guidelines"));
    assert!(content.contains("Non-Negotiables"));
    assert!(content.contains("Repository Map"));

    Ok(())
}

#[test]
fn init_skips_existing_without_force() -> Result<()> {
    let dir = TempDir::new()?;
    let resolved = create_test_resolved(&dir);

    let output_path = resolved.repo_root.join("AGENTS.md");
    fs::write(&output_path, "existing content")?;

    let report = run_context_init(
        &resolved,
        ContextInitOptions {
            force: false,
            project_type_hint: None,
            output_path: output_path.clone(),
            interactive: false,
        },
    )?;

    assert_eq!(report.status, FileInitStatus::Valid);
    let content = fs::read_to_string(&output_path)?;
    assert_eq!(content, "existing content");

    Ok(())
}

#[test]
fn init_overwrites_with_force() -> Result<()> {
    let dir = TempDir::new()?;
    let resolved = create_test_resolved(&dir);

    let output_path = resolved.repo_root.join("AGENTS.md");
    fs::write(&output_path, "existing content")?;

    let report = run_context_init(
        &resolved,
        ContextInitOptions {
            force: true,
            project_type_hint: None,
            output_path: output_path.clone(),
            interactive: false,
        },
    )?;

    assert_eq!(report.status, FileInitStatus::Created);
    let content = fs::read_to_string(&output_path)?;
    assert!(content.contains("# Repository Guidelines"));

    Ok(())
}

#[test]
fn init_templates_avoid_blanket_source_doc_claims() -> Result<()> {
    for (project_type, seed_file, seed_contents) in [
        (DetectedProjectType::Generic, None, None),
        (
            DetectedProjectType::Rust,
            Some("Cargo.toml"),
            Some("[package]\nname = \"test-project\"\nversion = \"0.1.0\"\n"),
        ),
        (
            DetectedProjectType::Python,
            Some("pyproject.toml"),
            Some("[project]\nname = \"test-project\"\nversion = \"0.1.0\"\n"),
        ),
        (
            DetectedProjectType::TypeScript,
            Some("package.json"),
            Some("{\"name\":\"test-project\"}"),
        ),
        (
            DetectedProjectType::Go,
            Some("go.mod"),
            Some("module test-project\n\ngo 1.21\n"),
        ),
    ] {
        let dir = TempDir::new()?;
        let resolved = create_test_resolved(&dir);
        if let (Some(seed_file), Some(seed_contents)) = (seed_file, seed_contents) {
            fs::write(resolved.repo_root.join(seed_file), seed_contents)?;
        }

        let output_path = resolved.repo_root.join("AGENTS.md");
        run_context_init(
            &resolved,
            ContextInitOptions {
                force: false,
                project_type_hint: None,
                output_path: output_path.clone(),
                interactive: false,
            },
        )?;

        let content = fs::read_to_string(&output_path)?;
        assert!(
            !content.contains("every new/changed source file MUST start"),
            "blanket source-doc claim returned for {project_type:?}"
        );
    }

    Ok(())
}