Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector'

vendor/ruvector/crates/ruvector-cognitive-container/README.md

@@ -0,0 +1,34 @@
+# ruvector-cognitive-container
+
+Verifiable WASM cognitive container with canonical witness chains for the RuVector ecosystem.
+
+## Features
+
+- **Epoch Controller**: Phase-budgeted tick execution (ingest/mincut/spectral/evidence/witness)
+- **Memory Slab**: Arena-based allocation for graph data
+- **Witness Chain**: Hash-linked chain of `ContainerWitnessReceipt` for deterministic verification
+- **Cognitive Container**: Full orchestration with snapshot/restore support
+
+## Usage
+
+```rust
+use ruvector_cognitive_container::{CognitiveContainer, ContainerConfig, Delta};
+
+let config = ContainerConfig::default();
+let mut container = CognitiveContainer::new(config).unwrap();
+
+let deltas = vec![
+    Delta::EdgeAdd { u: 0, v: 1, weight: 1.0 },
+    Delta::Observation { node: 0, value: 0.8 },
+];
+
+let result = container.tick(&deltas).unwrap();
+println!("Min-cut: {}", result.min_cut_value);
+
+// Verify witness chain integrity
+let verification = container.verify_chain();
+```
+
+## License
+
+MIT