Squashed 'vendor/ruvector/' content from commit b64c2172

git-subtree-dir: vendor/ruvector
git-subtree-split: b64c21726f2bb37286d9ee36a7869fef60cc6900

crates/ruvector-attention/src/unified_report/mod.rs

@@ -0,0 +1,32 @@
+//! Unified Geometry Report
+//!
+//! Combines all geometric metrics into a single diagnostic surface.
+//!
+//! ## Metrics Included
+//!
+//! 1. **OT Distance**: Sliced Wasserstein mean absolute distance
+//! 2. **Topology Coherence**: k-NN boundary mass ratio
+//! 3. **H0 Persistence**: Sum of death times (structural complexity)
+//! 4. **IB KL**: Information bottleneck compression term
+//! 5. **Diffusion Energy**: Smoothness on key graph
+//!
+//! ## Use Cases
+//!
+//! - Routing decisions in MoE
+//! - Gating signals for attention modes
+//! - Monitoring attention health
+//! - Debugging attention patterns
+
+mod metrics;
+mod report;
+
+pub use metrics::{MetricType, MetricValue};
+pub use report::{AttentionRecommendation, GeometryReport, ReportBuilder, ReportConfig};
+
+#[cfg(test)]
+mod tests {
+    #[test]
+    fn test_module_exists() {
+        assert!(true);
+    }
+}