agentty 0.7.2

Agentty is an ADE (Agentic Development Environment) for structured, controllable AI-assisted software development.
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

//! Confirmation dialog E2E tests: quit-confirm-yes exits, quit-confirm
//! dismiss via `n` and `Esc` returns to the app.

use std::time::Duration;

use testty::assertion;
use testty::region::Region;
use testty::scenario::Scenario;

use crate::common;
use crate::common::BuilderEnv;

/// Verify that confirming quit with `y` causes the process to exit with
/// code 0.
///
/// Opens the quit dialog, presses `y`, and asserts that the PTY child
/// process terminates successfully.
#[test]
fn quit_confirm_yes_exits() {
    // Arrange
    let temp = tempfile::TempDir::new().expect("failed to create temp dir");
    let env = BuilderEnv::new(temp.path()).expect("failed to create builder env");
    let mut session = env.builder().spawn().expect("failed to spawn session");

    let scenario = Scenario::new("quit_yes")
        .compose(&common::wait_for_agentty_startup())
        .compose(&common::open_quit_dialog())
        .press_key("y")
        .sleep(Duration::from_millis(500));

    // Act
    scenario
        .execute_in_pty(&mut session)
        .expect("scenario execution failed");

    // Assert — process should exit with code 0.
    let exited_successfully = session
        .wait_for_exit(Duration::from_secs(5))
        .expect("process did not exit within timeout");

    assert!(exited_successfully, "Process should exit with code 0");
}

/// Verify that dismissing the quit dialog with `n` and `Esc` returns to
/// the normal app view.
///
/// Opens the quit dialog twice: first dismisses with `n`, then with `Esc`.
/// After each dismissal, asserts that the app is back on the Projects tab.
#[test]
fn quit_confirm_dismiss_returns() {
    // Arrange
    let temp = tempfile::TempDir::new().expect("failed to create temp dir");
    let env = BuilderEnv::new(temp.path()).expect("failed to create builder env");

    let scenario = Scenario::new("quit_dismiss")
        .compose(&common::wait_for_agentty_startup())
        .viewing_pause_ms(1500)
        // First: open quit dialog and dismiss with 'n'.
        .compose(&common::open_quit_dialog())
        .viewing_pause_ms(1500)
        .capture_labeled("dialog_n", "Quit dialog before n")
        .press_key("n")
        .wait_for_stable_frame(300, 3000)
        .viewing_pause_ms(1000)
        .capture_labeled("after_n", "App restored after n")
        // Second: open quit dialog and dismiss with Esc.
        .compose(&common::open_quit_dialog())
        .viewing_pause_ms(1500)
        .capture_labeled("dialog_esc", "Quit dialog before Esc")
        .press_key("Escape")
        .wait_for_stable_frame(300, 3000)
        .viewing_pause_ms(1000)
        .capture_labeled("after_esc", "App restored after Esc");

    // Act
    let (frame, report) = scenario
        .run_with_proof(env.builder())
        .expect("scenario execution failed");

    // Assert — quit dialog was shown both times.
    let dialog_n_frame = common::frame_from_capture(&report.captures[0]);
    let full = Region::full(dialog_n_frame.cols(), dialog_n_frame.rows());
    assertion::assert_text_in_region(&dialog_n_frame, "Confirm Quit", &full);

    let dialog_esc_frame = common::frame_from_capture(&report.captures[2]);
    let full_esc = Region::full(dialog_esc_frame.cols(), dialog_esc_frame.rows());
    assertion::assert_text_in_region(&dialog_esc_frame, "Confirm Quit", &full_esc);

    // Assert — after 'n' dismissal, Projects tab is restored.
    let after_n_frame = common::frame_from_capture(&report.captures[1]);
    let restored_full = Region::full(after_n_frame.cols(), after_n_frame.rows());
    assertion::assert_text_in_region(&after_n_frame, "test-project", &restored_full);

    // Assert — after Esc dismissal, Projects tab is restored (final frame).
    let final_full = Region::full(frame.cols(), frame.rows());
    assertion::assert_text_in_region(&frame, "test-project", &final_full);

    // Assert — no quit dialog visible in either restored view.
    let after_n_text = after_n_frame.text_in_region(&full);
    assert!(
        !after_n_text.contains("Confirm Quit"),
        "Quit dialog should be dismissed after 'n'"
    );

    let final_text = frame.text_in_region(&final_full);
    assert!(
        !final_text.contains("Confirm Quit"),
        "Quit dialog should be dismissed after Esc"
    );

    common::save_feature_gif(&scenario, &report, &env, "quit_dismiss");
}