ailint-core 1.1.0

Core library for ailint: discovery, parsing, rule engine, and reporters for AI agent guidance 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

//! AIL105 `vendor-optimization-syntax` — Enforce XML `<conventions>` tags for Anthropic-hosted agents.
//!
//! See: `docs/rules/semantic/AIL105.md`

use crate::file_type::FileType;
use crate::parser::ParsedDocument;
use crate::rules::semantic::AIL105;
use crate::rules::{Rule, RuleContext, RuleId, Severity, Violation};

/// AIL105 vendor-optimization-syntax: Claude/Cline files should use XML tags.
#[derive(Debug, Default)]
pub struct VendorOptimizationSyntaxRule;

impl Rule for VendorOptimizationSyntaxRule {
    fn id(&self) -> RuleId {
        AIL105
    }

    fn default_severity(&self) -> Severity {
        Severity::Warning
    }

    fn description(&self) -> &'static str {
        "Anthropic-hosted agents perform best with explicit XML tags (e.g. <conventions>)."
    }

    fn fix_hint(&self) -> &'static str {
        "Wrap sections in <conventions>...</conventions> or similar XML tags."
    }

    fn applies_to(&self, file_type: FileType) -> bool {
        matches!(file_type, FileType::ClaudeMd | FileType::ClineRules)
    }

    fn run(&self, doc: &ParsedDocument, ctx: &RuleContext<'_>) -> Vec<Violation> {
        if !doc.raw.contains("<conventions>")
            && !doc.raw.contains("<rules>")
            && !doc.raw.contains("</")
        {
            let v = Violation::new(AIL105, ctx.severity, doc.path.clone(), "no XML tags found");
            vec![v]
        } else {
            Vec::new()
        }
    }
}