prx 0.5.9

Praxis — agent-native Unix tools. Single binary replacing grep, cat, find, sed, diff for AI coding agents.
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

use clap::Args;

use crate::output::AgError;
use crate::runner;

#[derive(Args)]
pub struct RunArgs {
    /// Command to run
    #[arg(trailing_var_arg = true, required = true)]
    pub command: Vec<String>,

    /// Bypass parsing, return full output
    #[arg(long)]
    pub raw: bool,

    /// Return parsed summary AND full output
    #[arg(long)]
    pub full: bool,

    /// Auto-inject --json/-o json for tools that support structured output
    #[arg(long)]
    pub auto_json: bool,

    /// Command timeout in seconds
    #[arg(long, default_value = "300")]
    pub timeout: u64,
}

pub fn run(args: RunArgs) -> Result<serde_json::Value, AgError> {
    let command = if args.auto_json {
        runner::inject_json_flag(&args.command)
    } else {
        args.command.clone()
    };
    let raw = runner::execute(&command, args.timeout)?;

    if args.raw {
        let combined = format!("{}\n{}", raw.stdout, raw.stderr);
        let output = runner::RunOutput {
            exit_code: raw.exit_code,
            duration_ms: raw.duration_ms,
            tool: "raw".to_string(),
            summary: format!("exited {}", raw.exit_code),
            passed: 0,
            failed: if raw.exit_code != 0 { 1 } else { 0 },
            skipped: 0,
            failures: vec![],
            warnings: vec![],
            output_lines: combined.lines().count(),
            output_tokens_saved: 0,
            tail: Some(combined),
        };
        return serde_json::to_value(output).map_err(|e| AgError::Internal {
            message: e.to_string(),
        });
    }

    let tool = runner::detect_tool(&command);
    let mut output = runner::parse_output(tool, &raw);

    if args.full {
        let combined = format!("{}\n{}", raw.stdout, raw.stderr);
        output.tail = Some(combined);
    }

    serde_json::to_value(output).map_err(|e| AgError::Internal {
        message: e.to_string(),
    })
}

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

    #[test]
    fn run_echo() {
        let args = RunArgs {
            command: vec!["echo".into(), "hello".into()],
            raw: false,
            full: false,
            auto_json: false,
            timeout: 10,
        };
        let result = run(args).unwrap();
        let out: runner::RunOutput = serde_json::from_value(result).unwrap();
        assert_eq!(out.exit_code, 0);
        assert_eq!(out.tool, "unknown");
    }

    #[test]
    fn run_raw_mode() {
        let args = RunArgs {
            command: vec!["echo".into(), "hello".into()],
            raw: true,
            full: false,
            auto_json: false,
            timeout: 10,
        };
        let result = run(args).unwrap();
        let out: runner::RunOutput = serde_json::from_value(result).unwrap();
        assert_eq!(out.tool, "raw");
        assert!(out.tail.unwrap().contains("hello"));
    }

    #[test]
    fn run_failing_command() {
        let args = RunArgs {
            command: vec!["false".into()],
            raw: false,
            full: false,
            auto_json: false,
            timeout: 10,
        };
        let result = run(args).unwrap();
        let out: runner::RunOutput = serde_json::from_value(result).unwrap();
        assert_ne!(out.exit_code, 0);
    }

    #[test]
    fn run_nonexistent_command() {
        let args = RunArgs {
            command: vec!["ag_nonexistent_cmd_xyz".into()],
            raw: false,
            full: false,
            auto_json: false,
            timeout: 10,
        };
        assert!(run(args).is_err());
    }
}