ailint-core 1.0.1

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

//! 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 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 mut v = Violation::new(
                AIL105,
                ctx.severity,
                doc.path.clone(),
                "Anthropic-hosted agents perform best with explicit XML tags (like <conventions>). No XML tags found.",
            );
            v.fix_hint = Some("Wrap your rules in <conventions>...</conventions> or similar XML tags based on Anthropic best practices.".to_string());
            vec![v]
        } else {
            Vec::new()
        }
    }
}