agentty 0.12.9

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

//! Process-management utilities for agent subprocess lifecycle.

use rustix::process::{self, Pid, Signal};

/// Sends `SIGTERM` to the process identified by `pid`.
///
/// Best-effort: failures (no such process, permission denied) are silently
/// ignored because the calling code treats process termination as advisory.
/// Uses `rustix::process::kill_process` for a direct syscall instead of
/// shelling out to the `kill` binary.
pub(crate) fn send_terminate_signal(pid: u32) {
    if let Ok(raw_pid) = i32::try_from(pid)
        && let Some(pid) = Pid::from_raw(raw_pid)
    {
        let _ = process::kill_process(pid, Signal::TERM);
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_send_terminate_signal_kills_owned_child() {
        // Arrange — spawn a long-running child whose PID we control.
        let mut child = std::process::Command::new("sleep")
            .arg("60")
            .spawn()
            .expect("failed to spawn sleep");
        let child_pid = child.id();

        // Act
        send_terminate_signal(child_pid);

        // Assert — the child should have been terminated by SIGTERM.
        let exit_status = child.wait().expect("failed to wait on child");
        assert!(
            !exit_status.success(),
            "child should have been killed, not exited normally"
        );
    }

    #[test]
    fn test_send_terminate_signal_ignores_overflow_pid() {
        // Arrange — PID exceeding i32::MAX cannot be converted and is
        // silently skipped.
        let overflow_pid = u32::MAX;

        // Act
        send_terminate_signal(overflow_pid);

        // Assert — no panic, no signal sent.
    }
}