vallum 0.3.1

A Rust CLI proxy between AI agents and your shell — sanitizes secrets, flags prompt injections, strips ANSI, compresses output, audits commands.
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

// src/optimizer/git_diff.rs
use super::{collapse_noise_runs, CommandOptimizer};

pub struct GitDiffOptimizer;

impl CommandOptimizer for GitDiffOptimizer {
    fn name(&self) -> &'static str {
        "git_diff"
    }

    fn matches(&self, cmd: &str, args: &[String]) -> bool {
        cmd == "git" && args.iter().any(|a| a == "diff")
    }

    fn optimize(&self, input: &str) -> Option<String> {
        // Noise = unchanged context lines (leading space) and blank lines.
        // Kept = headers (diff --git, @@, +++, ---, index ...) and changed
        // lines (start with '+' or '-'; +++/--- also start with +/-).
        collapse_noise_runs(
            input,
            15,
            |line| line.is_empty() || line.starts_with(' '),
            "unchanged lines",
        )
    }
}

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

    fn args(items: &[&str]) -> Vec<String> {
        items.iter().map(|s| s.to_string()).collect()
    }

    #[test]
    fn matches_git_diff() {
        assert!(GitDiffOptimizer.matches("git", &args(&["diff"])));
        assert!(GitDiffOptimizer.matches("git", &args(&["diff", "--cached"])));
        assert!(!GitDiffOptimizer.matches("git", &args(&["status"])));
        assert!(!GitDiffOptimizer.matches("cargo", &args(&["diff"])));
    }

    #[test]
    fn collapses_context_keeps_changes() {
        let mut input = String::from("diff --git a/f.rs b/f.rs\n@@ -1,30 +1,30 @@\n");
        for i in 0..25 {
            input.push_str(&format!(" context line {}\n", i)); // unchanged
        }
        input.push_str("-old line\n+new line\n");
        let out = GitDiffOptimizer.optimize(&input).unwrap();
        assert!(out.contains("diff --git a/f.rs b/f.rs"));
        assert!(out.contains("@@ -1,30 +1,30 @@"));
        assert!(out.contains("-old line"));
        assert!(out.contains("+new line"));
        assert!(out.contains("unchanged lines hidden"));
        assert!(out.lines().count() < input.lines().count());
    }

    #[test]
    fn passthrough_small_diff() {
        let input = "diff --git a/f b/f\n@@ -1 +1 @@\n-a\n+b\n";
        assert!(GitDiffOptimizer.optimize(input).is_none());
    }

    use proptest::prelude::*;

    proptest! {
        #[test]
        fn prop_optimize_does_not_panic(s in "[\\s\\S]{0,500}") {
            let _ = GitDiffOptimizer.optimize(&s);
        }
    }
}