rtango 0.3.0

Package manager for AI agent skills, agents, and system instruction files
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
106

use rtango::agent::ClaudeCodeParser;
use rtango::agent::frontmatter::FrontMatterMapper;
use rtango::agent::permission::Permission;

fn parser() -> ClaudeCodeParser {
    ClaudeCodeParser
}

// ── parse_permission ───────────────────────────────────────────

#[test]
fn known_permissions() {
    let p = parser();
    assert_eq!(p.parse_permission("Read"), Permission::Read);
    assert_eq!(p.parse_permission("Write"), Permission::Write);
    assert_eq!(p.parse_permission("Edit"), Permission::Edit);
    assert_eq!(p.parse_permission("MultiEdit"), Permission::Edit);
    assert_eq!(p.parse_permission("Bash"), Permission::Shell(None));
    assert_eq!(p.parse_permission("Grep"), Permission::Grep);
    assert_eq!(p.parse_permission("Glob"), Permission::Glob);
    assert_eq!(p.parse_permission("WebFetch"), Permission::WebFetch);
    assert_eq!(p.parse_permission("WebSearch"), Permission::WebSearch);
    assert_eq!(p.parse_permission("NotebookEdit"), Permission::NotebookEdit);
    assert_eq!(p.parse_permission("TodoWrite"), Permission::TodoWrite);
}

#[test]
fn obsolete_tokens_fall_through() {
    // LS, NotebookRead, TodoRead, MultiEdit are no longer valid Claude Code tools.
    // Legacy frontmatter still round-trips via Other (except MultiEdit, which is
    // remapped to Edit because the ergonomic intent is the same).
    let p = parser();
    assert_eq!(
        p.parse_permission("LS"),
        Permission::Other("LS".into()),
        "LS was removed from Claude Code (use Bash/Glob)"
    );
    assert_eq!(
        p.parse_permission("NotebookRead"),
        Permission::Other("NotebookRead".into()),
        "NotebookRead was merged into Read"
    );
    assert_eq!(
        p.parse_permission("TodoRead"),
        Permission::Other("TodoRead".into()),
        "TodoRead was removed; only TodoWrite remains"
    );
}

#[test]
fn bash_with_pattern() {
    assert_eq!(
        parser().parse_permission("Bash(npm*)"),
        Permission::Shell(Some("npm*".into())),
    );
}

#[test]
fn bash_with_complex_pattern() {
    assert_eq!(
        parser().parse_permission("Bash(cd /tmp && ls)"),
        Permission::Shell(Some("cd /tmp && ls".into())),
    );
}

#[test]
fn unknown_permission() {
    assert_eq!(
        parser().parse_permission("CustomTool"),
        Permission::Other("CustomTool".into()),
    );
}

// ── parse_frontmatter ──────────────────────────────────────────

#[test]
fn parse_full_frontmatter() {
    let yaml =
        "name: code-review\ndescription: reviews code\nallowed-tools: Read Bash(npm*) Grep\n";
    let fm = parser().parse_frontmatter(yaml).unwrap();
    assert_eq!(fm.name.as_deref(), Some("code-review"));
    assert_eq!(fm.description.as_deref(), Some("reviews code"));
    assert_eq!(
        fm.allowed_tools,
        vec![
            Permission::Read,
            Permission::Shell(Some("npm*".into())),
            Permission::Grep,
        ]
    );
}

#[test]
fn parse_frontmatter_preserves_extras() {
    let yaml = "name: s\nversion: 2\n";
    let fm = parser().parse_frontmatter(yaml).unwrap();
    assert!(fm.extra.contains_key("version"));
}

#[test]
fn parse_frontmatter_empty_tools() {
    let yaml = "description: no tools\n";
    let fm = parser().parse_frontmatter(yaml).unwrap();
    assert!(fm.allowed_tools.is_empty());
    assert!(fm.name.is_none());
}