agnix-lsp 0.18.0

Language Server Protocol implementation for agnix
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

use super::*;
use std::path::{Component, Path, PathBuf};

pub(crate) fn create_error_diagnostic(code: &str, message: String) -> Diagnostic {
    Diagnostic {
        range: Range {
            start: Position {
                line: 0,
                character: 0,
            },
            end: Position {
                line: 0,
                character: 0,
            },
        },
        severity: Some(DiagnosticSeverity::ERROR),
        code: Some(NumberOrString::String(code.to_string())),
        code_description: None,
        source: Some("agnix".to_string()),
        message,
        related_information: None,
        tags: None,
        data: None,
    }
}

/// Normalize path components without filesystem access.
/// Resolves `.` and `..` logically - used when `canonicalize()` fails.
/// Expects absolute paths (LSP URIs always produce absolute paths).
pub(crate) fn normalize_path(path: &Path) -> PathBuf {
    let mut components: Vec<Component<'_>> = Vec::new();
    for component in path.components() {
        match component {
            Component::CurDir => {}
            Component::ParentDir => {
                match components.last() {
                    Some(Component::Normal(_)) => {
                        components.pop();
                    }
                    // Cannot traverse above root or prefix - silently drop
                    Some(Component::RootDir) | Some(Component::Prefix(_)) => {}
                    _ => components.push(component),
                }
            }
            _ => components.push(component),
        }
    }
    components.iter().collect()
}

impl Backend {
    /// Check if a file path is relevant to project-level rules.
    ///
    /// Returns true for instruction files (CLAUDE.md, AGENTS.md, .clinerules,
    /// .cursorrules, copilot-instructions.md, etc.) and .agnix.toml config.
    pub(crate) fn is_project_level_trigger(path: &Path) -> bool {
        let file_name = match path.file_name().and_then(|n| n.to_str()) {
            Some(name) => name,
            None => return false,
        };

        // .agnix.toml config changes affect all rules
        if file_name.eq_ignore_ascii_case(".agnix.toml") {
            return true;
        }

        // Instruction files that affect project-level cross-file checks
        file_name.eq_ignore_ascii_case("claude.md")
            || file_name.eq_ignore_ascii_case("claude.local.md")
            || file_name.eq_ignore_ascii_case("agents.md")
            || file_name.eq_ignore_ascii_case("agents.local.md")
            || file_name.eq_ignore_ascii_case("agents.override.md")
            || file_name.eq_ignore_ascii_case("gemini.md")
            || file_name.eq_ignore_ascii_case("gemini.local.md")
            || file_name.eq_ignore_ascii_case(".clinerules")
            || file_name.eq_ignore_ascii_case(".cursorrules")
            || file_name.eq_ignore_ascii_case(".cursorrules.md")
            || file_name.eq_ignore_ascii_case("copilot-instructions.md")
            || file_name.to_lowercase().ends_with(".instructions.md")
            || file_name.to_lowercase().ends_with(".mdc")
            || file_name.eq_ignore_ascii_case("opencode.json")
    }

    /// Get cached document content for a URI.
    pub(crate) async fn get_document_content(&self, uri: &Url) -> Option<Arc<String>> {
        self.documents.read().await.get(uri).cloned()
    }

    /// Get the latest document version reported by the client for a URI.
    ///
    /// Returns `None` if the document has not been opened or has been closed.
    pub(crate) async fn get_document_version(&self, uri: &Url) -> Option<i32> {
        self.document_versions.read().await.get(uri).copied()
    }
}