refactor(xatu): return structured reports

src/xatu/rules.rs

@@ -4,17 +4,37 @@ use crate::rules::empty_inherit::EmptyInherit;
 
 pub mod empty_inherit;
 
+#[derive(Debug)]
 pub struct Finding {
+    /// Identifies the rule that produced this finding.
     pub rule_id: &'static str,
+    /// Identifies the source range that triggered this finding.
     pub range: ast::SourceRange,
+    /// Describes the finding for human-readable output.
     pub message: &'static str,
 }
 
+#[derive(Debug)]
 pub struct Diagnostic {
+    /// Identifies the file that contains this diagnostic.
     pub file_id: FileId,
+    /// Contains the node-local rule finding.
     pub finding: Finding,
 }
 
+impl std::fmt::Display for Diagnostic {
+    fn fmt(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        write!(
+            formatter,
+            "{}..{}: {}: {}",
+            self.finding.range.start,
+            self.finding.range.end,
+            self.finding.rule_id,
+            self.finding.message,
+        )
+    }
+}
+
 pub trait NodeRule {
     type Node;