Add tool quality report contract

crates/crank-core/src/tool_quality.rs

@@ -0,0 +1,40 @@
+use serde::{Deserialize, Serialize};
+
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum ToolQualitySeverity {
+    Info,
+    Warning,
+    Error,
+}
+
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct ToolQualityFinding {
+    pub severity: ToolQualitySeverity,
+    pub code: String,
+    pub message: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub suggested_action: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub field_path: Option<String>,
+}
+
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct ToolQualityReport {
+    pub blocking: bool,
+    pub findings: Vec<ToolQualityFinding>,
+}
+
+impl ToolQualityReport {
+    pub fn new(findings: Vec<ToolQualityFinding>) -> Self {
+        let blocking = findings
+            .iter()
+            .any(|finding| finding.severity == ToolQualitySeverity::Error);
+
+        Self { blocking, findings }
+    }
+
+    pub fn empty() -> Self {
+        Self::new(Vec::new())
+    }
+}