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
47
48
49
50
51
52
53
54
55
56
57
58
59
60

//! AIL001 `no-frontmatter-schema-error` — YAML frontmatter fails to parse.
//!
//! See: `docs/rules/structural/AIL001.md`

use crate::parser::{DocumentContent, ParsedDocument};
use crate::rules::structural::AIL001;
use crate::rules::{Rule, RuleContext, RuleId, Severity, Violation};

/// AIL001 no-frontmatter-schema-error: frontmatter must match the file type's schema.
#[derive(Debug, Default)]
pub struct FrontmatterSchemaRule;

impl Rule for FrontmatterSchemaRule {
    fn id(&self) -> RuleId {
        AIL001
    }

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

    fn description(&self) -> &'static str {
        "YAML frontmatter fails to parse."
    }

    fn fix_hint(&self) -> &'static str {
        "Check indentation, quote strings containing colons, and align list items."
    }

    fn run(&self, doc: &ParsedDocument, _ctx: &RuleContext<'_>) -> Vec<Violation> {
        let DocumentContent::Markdown(md) = &doc.content else {
            return Vec::new();
        };
        let Some(fm) = md.frontmatter.as_ref() else {
            return Vec::new();
        };
        let Err(err) = serde_yaml::from_str::<serde_yaml::Value>(&fm.raw) else {
            return Vec::new();
        };
        let line = line_at_offset(&doc.raw, fm.byte_range.start);
        let v = Violation::new(
            AIL001,
            self.default_severity(),
            doc.path.clone(),
            "invalid YAML frontmatter",
        )
        .at(line, 1)
        .with_detail(err.to_string());
        vec![v]
    }
}

fn line_at_offset(raw: &str, offset: usize) -> usize {
    let end = offset.min(raw.len());
    raw.as_bytes()[..end]
        .iter()
        .filter(|&&b| b == b'\n')
        .count()
        + 1
}