atman_runtime/
meta_commands.rs

1pub struct MetaCommand {
2    pub name: &'static str,
3    pub desc: &'static str,
4    pub usage: &'static str,
5    pub aliases: &'static [&'static str],
6}
7
8pub const META_COMMANDS: &[MetaCommand] = &[
9    MetaCommand {
10        name: "help",
11        desc: "show this help",
12        usage: ":help",
13        aliases: &[],
14    },
15    MetaCommand {
16        name: "exit",
17        desc: "leave repl",
18        usage: ":exit | :quit",
19        aliases: &["quit"],
20    },
21    MetaCommand {
22        name: "session",
23        desc: "print current session id",
24        usage: ":session",
25        aliases: &[],
26    },
27    MetaCommand {
28        name: "cost",
29        desc: "cost summary hint",
30        usage: ":cost",
31        aliases: &[],
32    },
33    MetaCommand {
34        name: "mode",
35        desc: "switch trust mode (calm/steady/eager/reckless)",
36        usage: ":mode",
37        aliases: &[],
38    },
39    MetaCommand {
40        name: "mode-theme",
41        desc: "switch display theme (default/wuxia/animal/weather/drink)",
42        usage: ":mode-theme",
43        aliases: &[],
44    },
45    MetaCommand {
46        name: "model",
47        desc: "switch active model",
48        usage: ":model",
49        aliases: &[],
50    },
51    MetaCommand {
52        name: "outside",
53        desc: "cycle outside behavior in eager (deny/approve/allow)",
54        usage: ":outside",
55        aliases: &[],
56    },
57    MetaCommand {
58        name: "attach",
59        desc: "attach file / list / clear",
60        usage: ":attach <path> | :attach clear | :attach list",
61        aliases: &[],
62    },
63    MetaCommand {
64        name: "suggest",
65        desc: "meta-LLM flow suggestion",
66        usage: ":suggest",
67        aliases: &[],
68    },
69    MetaCommand {
70        name: "goal",
71        desc: "get / set / clear session goal",
72        usage: ":goal | :goal <text> | :goal clear",
73        aliases: &[],
74    },
75    MetaCommand {
76        name: "sessions",
77        desc: "list recent sessions",
78        usage: ":sessions",
79        aliases: &[],
80    },
81    MetaCommand {
82        name: "sidebar",
83        desc: "sidebar on / off / auto",
84        usage: ":sidebar on | off | auto",
85        aliases: &[],
86    },
87    MetaCommand {
88        name: "todo",
89        desc: "list / done <id> / cancel <id> / clear",
90        usage: ":todo list | :todo done <id> | :todo cancel <id> | :todo clear",
91        aliases: &[],
92    },
93    MetaCommand {
94        name: "rename",
95        desc: "set / clear session title",
96        usage: ":rename <text> | :rename clear",
97        aliases: &[],
98    },
99    MetaCommand {
100        name: "copy",
101        desc: "push to clipboard (OSC 52)",
102        usage: ":copy last-message | :copy last-tool",
103        aliases: &[],
104    },
105    MetaCommand {
106        name: "compact",
107        desc: "compact transcript now",
108        usage: ":compact",
109        aliases: &[],
110    },
111];
112
113pub fn builtin_list() -> Vec<(&'static str, &'static str)> {
114    META_COMMANDS.iter().map(|c| (c.name, c.desc)).collect()
115}
116
117pub fn help_lines() -> Vec<&'static str> {
118    let mut lines: Vec<&'static str> = META_COMMANDS.iter().map(|c| c.usage).collect();
119    lines.push("");
120    lines.push("resume a prior session: exit, then run `atman --continue <session_id>`");
121    lines.push("@./path or @/abs     — inline attach in bare input");
122    lines
123}
124
125pub fn match_command(input: &str) -> Option<&'static MetaCommand> {
126    let name = input.split_whitespace().next().unwrap_or(input);
127    META_COMMANDS
128        .iter()
129        .find(|c| c.name == name || c.aliases.contains(&name))
130}
131
132#[cfg(test)]
133mod tests {
134    use super::*;
135
136    #[test]
137    fn all_commands_have_nonempty_fields() {
138        for c in META_COMMANDS {
139            assert!(!c.name.is_empty());
140            assert!(!c.desc.is_empty());
141            assert!(!c.usage.is_empty());
142        }
143    }
144
145    #[test]
146    fn match_by_name() {
147        assert_eq!(match_command("help").unwrap().name, "help");
148        assert_eq!(match_command("mode").unwrap().name, "mode");
149        assert_eq!(match_command("mode eager").unwrap().name, "mode");
150    }
151
152    #[test]
153    fn match_by_alias() {
154        assert_eq!(match_command("quit").unwrap().name, "exit");
155    }
156
157    #[test]
158    fn unknown_returns_none() {
159        assert!(match_command("nonexistent").is_none());
160    }
161
162    #[test]
163    fn builtin_list_matches_commands() {
164        let list = builtin_list();
165        assert_eq!(list.len(), META_COMMANDS.len());
166        assert!(list.iter().any(|(n, _)| *n == "mode"));
167    }
168
169    #[test]
170    fn help_lines_not_empty() {
171        let lines = help_lines();
172        assert!(!lines.is_empty());
173        assert!(lines.iter().any(|l| l.contains("resume")));
174    }
175}
atman_runtime/meta_commands.rs

atman_runtime/
meta_commands.rs
