1. 1//! The scorecard types the deterministic gates report through: a named
2. 2//! metric with a threshold and a direction, and the card that prints and
3. 3//! passes/fails them. The context-engine gate itself lives in
4. 4//! `context_engine_gate` (docs/design/68-context-engine.md "Verification").
5. 5
6. 6#[derive(Debug, Clone, Copy, PartialEq, Eq)]
7. 7pub enum MetricDirection {
8. 8 Min,
9. 9 Max,
10. 10}
11. 11
12. 12#[derive(Debug, Clone)]
13. 13pub struct QualityMetric {
14. 14 pub name: &'static str,
15. 15 pub value: f64,
16. 16 pub threshold: f64,
17. 17 pub direction: MetricDirection,
18. 18}
19. 19
20. 20impl QualityMetric {
21. 21 fn passed(&self) -> bool {
22. 22 match self.direction {
23. 23 MetricDirection::Min => self.value >= self.threshold,
24. 24 MetricDirection::Max => self.value <= self.threshold,
25. 25 }
26. 26 }
27. 27}
28. 28
29. 29#[derive(Debug, Clone)]
30. 30pub struct ContextScorecard {
31. 31 pub metrics: Vec<QualityMetric>,
32. 32}
33. 33
34. 34impl ContextScorecard {
35. 35 pub fn passed(&self) -> bool {
36. 36 self.metrics.iter().all(|m| m.passed())
37. 37 }
38. 38}
39. 39
40. 40impl std::fmt::Display for ContextScorecard {
41. 41 fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
42. 42 writeln!(f, "Context quality scorecard:")?;
43. 43 for m in &self.metrics {
44. 44 let mark = if m.passed() { "PASS" } else { "FAIL" };
45. 45 let op = match m.direction {
46. 46 MetricDirection::Min => "≥",
47. 47 MetricDirection::Max => "≤",
48. 48 };
49. 49 writeln!(
50. 50 f,
51. 51 " [{mark}] {} = {:.3} ({} {})",
52. 52 m.name, m.value, op, m.threshold
53. 53 )?;
54. 54 }
55. 55 Ok(())
56. 56 }
57. 57}
58. 58