oxi-cli 0.39.0

Terminal-based AI coding assistant — multi-provider, streaming-first, extensible
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

//! Compile-time embedded TTSR rules for Rust projects.
//!
//! Each `.md` file in this directory is a TTSR rule with YAML
//! frontmatter and markdown body. They are embedded at compile time
//! via `include_str!()`.

use oxi_agent::agent_loop::ttsr::{InterruptMode, Rule, RuleSource, ScopeToken};
use regex::Regex;
use serde::Deserialize;

/// Raw content of bundled rule files: (filename stem, content).
fn raw_bundled_rules() -> Vec<(&'static str, &'static str)> {
    vec![
        ("rs-future-prelude", include_str!("rs-future-prelude.md")),
        ("rs-box-leak", include_str!("rs-box-leak.md")),
        (
            "rs-match-ergonomics",
            include_str!("rs-match-ergonomics.md"),
        ),
        ("rs-parking-lot", include_str!("rs-parking-lot.md")),
        ("rs-result-type", include_str!("rs-result-type.md")),
        ("rs-lazylock", include_str!("rs-lazylock.md")),
        ("rs-tokio-mutex", include_str!("rs-tokio-mutex.md")),
    ]
}

/// YAML frontmatter parsed from a `.mdc` rule file.
#[derive(Debug, Deserialize)]
struct RuleFrontmatter {
    description: Option<String>,
    condition: String,
    scope: Option<String>,
    #[serde(rename = "interruptMode")]
    interrupt_mode: Option<String>,
    globs: Option<Vec<String>>,
    #[serde(rename = "alwaysApply")]
    always_apply: Option<bool>,
}

/// Map a frontmatter scope string to [`ScopeToken`] values.
fn parse_scope(s: &str) -> Vec<ScopeToken> {
    match s.trim().to_lowercase().as_str() {
        "text" => vec![ScopeToken::Text],
        "thinking" => vec![ScopeToken::Thinking],
        "tool" => vec![ScopeToken::Tool {
            name: String::new(),
            globs: vec![],
        }],
        _ => vec![ScopeToken::Text],
    }
}

/// Map a frontmatter interrupt-mode string to [`InterruptMode`].
fn parse_interrupt_mode(s: &str) -> InterruptMode {
    match s.trim().to_lowercase().as_str() {
        "never" => InterruptMode::Never,
        "prose-only" | "proseonly" => InterruptMode::ProseOnly,
        "tool-only" | "toolonly" => InterruptMode::ToolOnly,
        "always" => InterruptMode::Always,
        _ => InterruptMode::ProseOnly,
    }
}

/// Parse a single rule file from its raw content.
///
/// Returns `None` if the frontmatter is missing, malformed, or the
/// regex condition fails to compile.
pub(crate) fn parse_rule_file(content: &str, name: &str, source: RuleSource) -> Option<Rule> {
    // Split on the first two `---` separators (frontmatter delimiters).
    let parts: Vec<&str> = content.splitn(3, "---").collect();
    if parts.len() < 3 {
        return None;
    }

    let yaml_str = parts[1].trim();
    let body = parts[2].trim();

    let fm: RuleFrontmatter = serde_yaml::from_str(yaml_str).ok()?;
    let condition = Regex::new(&fm.condition).ok()?;

    let scope = parse_scope(fm.scope.as_deref().unwrap_or("text"));
    let interrupt_mode = parse_interrupt_mode(fm.interrupt_mode.as_deref().unwrap_or("prose-only"));

    Some(Rule {
        name: name.to_string(),
        content: body.to_string(),
        description: fm.description,
        condition: vec![condition],
        scope,
        interrupt_mode,
        globs: fm.globs.unwrap_or_default(),
        always_apply: fm.always_apply.unwrap_or(false),
        source,
    })
}

/// Load all bundled builtin rules.
///
/// These are the Rust-specific rules shipped with oxi-cli. They are
/// always available regardless of project configuration.
pub fn load_all() -> Vec<Rule> {
    raw_bundled_rules()
        .into_iter()
        .filter_map(|(name, content)| parse_rule_file(content, name, RuleSource::BuiltinDefaults))
        .collect()
}