squeez 1.11.2

Hook-based token compressor for 5 AI CLI hosts (Claude Code, Copilot CLI, OpenCode, Gemini CLI, Codex CLI). Up to 95% bash compression, signature-mode for code reads, cross-call dedup, MCP server, self-teaching protocol. Zero runtime deps.
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

// Caveman persona for prompt-side output compression.
// The text is injected by `init.rs` into the session banner (Claude Code)
// and into the <!-- squeez:start --> block in copilot-instructions.md
// (Copilot CLI). It nudges the agent to produce terser output —
// squeez can't intercept the model's response stream, only suggest.

#[derive(Copy, Clone, Debug, Eq, PartialEq)]
pub enum Persona {
    Off,
    Lite,
    Full,
    Ultra,
}

impl Default for Persona {
    fn default() -> Self {
        // User chose Ultra as the default during PR2 design.
        Persona::Ultra
    }
}

pub fn from_str(s: &str) -> Persona {
    match s.trim().to_lowercase().as_str() {
        "off" | "false" | "0" | "" => Persona::Off,
        "lite" => Persona::Lite,
        "full" => Persona::Full,
        "ultra" => Persona::Ultra,
        _ => Persona::default(),
    }
}

pub fn as_str(p: Persona) -> &'static str {
    match p {
        Persona::Off => "off",
        Persona::Lite => "lite",
        Persona::Full => "full",
        Persona::Ultra => "ultra",
    }
}

const LITE: &str = include_str!("../../assets/persona_lite.md");
const FULL: &str = include_str!("../../assets/persona_full.md");
const ULTRA: &str = include_str!("../../assets/persona_ultra.md");
const FULL_PT_BR: &str = include_str!("../../assets/persona_full_pt_br.md");
const ULTRA_PT_BR: &str = include_str!("../../assets/persona_ultra_pt_br.md");

pub fn text(p: Persona) -> &'static str {
    match p {
        Persona::Off => "",
        Persona::Lite => LITE,
        Persona::Full => FULL,
        Persona::Ultra => ULTRA,
    }
}

pub fn text_with_lang(p: Persona, lang: &str) -> &'static str {
    match (p, lang) {
        (Persona::Off, _) => "",
        (Persona::Lite, _) => LITE,
        (Persona::Full, "pt-BR") => FULL_PT_BR,
        (Persona::Full, _) => FULL,
        (Persona::Ultra, "pt-BR") => ULTRA_PT_BR,
        (Persona::Ultra, _) => ULTRA,
    }
}

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

    #[test]
    fn from_str_round_trip() {
        for p in [Persona::Off, Persona::Lite, Persona::Full, Persona::Ultra] {
            assert_eq!(from_str(as_str(p)), p);
        }
    }

    #[test]
    fn from_str_case_insensitive() {
        assert_eq!(from_str("ULTRA"), Persona::Ultra);
        assert_eq!(from_str("Lite"), Persona::Lite);
    }

    #[test]
    fn from_str_unknown_falls_back_to_default() {
        assert_eq!(from_str("nonsense"), Persona::default());
    }

    #[test]
    fn off_text_is_empty() {
        assert!(text(Persona::Off).is_empty());
    }

    #[test]
    fn ultra_text_contains_ultra_marker() {
        let t = text(Persona::Ultra);
        assert!(t.contains("ultra"));
        assert!(t.len() > 50);
    }

    #[test]
    fn default_is_ultra() {
        assert_eq!(Persona::default(), Persona::Ultra);
    }
}