magellan-cli 0.2.0

Deterministic presentation engine for AI-generated technical walkthroughs
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

use std::fs;

use assert_cmd::Command;
use predicates::prelude::*;

#[test]
fn prompt_question_flow_works_end_to_end_with_real_binary() {
    let temp_dir = tempfile::tempdir().expect("temp dir should be created");
    let prompt_path = temp_dir.path().join("prompt.txt");

    let output = Command::cargo_bin("magellan")
        .expect("binary should build")
        .args([
            "prompt",
            "--agent-type",
            "codex",
            "--source",
            "diff",
            "--goal",
            "followup",
            "--question",
            "why did this validation path change?",
            "--artifact",
            "/tmp/question-flow.json",
            "--render-format",
            "markdown",
        ])
        .assert()
        .success()
        .get_output()
        .stdout
        .clone();

    fs::write(&prompt_path, &output).expect("prompt output should be saved");
    let prompt = fs::read_to_string(&prompt_path).expect("prompt output should be readable");

    assert!(prompt.contains("why did this validation path change?"));
    assert!(prompt.contains("magellan go --input /tmp/question-flow.json"));
    assert!(prompt.contains("inspect the current diff or commit range"));
    assert!(
        prompt.contains(
            "Each section becomes a page in HTML book view, so keep one idea per section."
        )
    );
}

#[test]
fn prompt_help_examples_include_question_flow() {
    Command::cargo_bin("magellan")
        .expect("binary should build")
        .args(["prompt", "--help"])
        .assert()
        .success()
        .stdout(predicate::str::contains(
            "--question \"why did this API flow change?\"",
        ))
        .stdout(predicate::str::contains("followup"));
}

#[test]
fn prompt_scope_flow_works_end_to_end_with_real_binary() {
    let temp_dir = tempfile::tempdir().expect("temp dir should be created");
    let prompt_path = temp_dir.path().join("scope-prompt.txt");

    let output = Command::cargo_bin("magellan")
        .expect("binary should build")
        .args([
            "prompt",
            "--agent-type",
            "claude",
            "--source",
            "branch",
            "--goal",
            "handoff",
            "--scope",
            "backend",
            "--scope",
            "tests",
            "--artifact",
            "/tmp/scope-flow.json",
        ])
        .assert()
        .success()
        .get_output()
        .stdout
        .clone();

    fs::write(&prompt_path, &output).expect("prompt output should be saved");
    let prompt = fs::read_to_string(&prompt_path).expect("prompt output should be readable");

    assert!(prompt.contains("keep the walkthrough centered on this scope: backend"));
    assert!(prompt.contains("keep the walkthrough centered on this scope: tests"));
    assert!(prompt.contains("magellan go --input /tmp/scope-flow.json"));
    assert!(prompt.contains("optimize for another engineer picking up the work quickly"));
}

#[test]
fn prompt_handoff_flow_recommends_timeline_and_component_graph_end_to_end() {
    let temp_dir = tempfile::tempdir().expect("temp dir should be created");
    let prompt_path = temp_dir.path().join("handoff-prompt.txt");

    let output = Command::cargo_bin("magellan")
        .expect("binary should build")
        .args([
            "prompt",
            "--agent-type",
            "codex",
            "--source",
            "branch",
            "--goal",
            "handoff",
            "--focus",
            "timeline",
            "--focus",
            "architecture",
            "--artifact",
            "/tmp/handoff-flow.json",
        ])
        .assert()
        .success()
        .get_output()
        .stdout
        .clone();

    fs::write(&prompt_path, &output).expect("prompt output should be saved");
    let prompt = fs::read_to_string(&prompt_path).expect("prompt output should be readable");

    assert!(prompt.contains(
        "for this artifact, include a `timeline` section when implementation order helps another engineer pick up the work"
    ));
    assert!(prompt.contains(
        "architecture-focused explanations usually benefit from a `component_graph` section"
    ));
    assert!(prompt.contains("magellan go --input /tmp/handoff-flow.json"));
}