rust-kgdb 0.5.11 → 0.5.12

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to the rust-kgdb TypeScript SDK will be documented in this file.
 
+## [0.5.12] - 2025-12-15
+
+### Benchmark Section Cleanup
+
+- Removed internal Cargo/Rust implementation details from benchmark documentation
+- Simplified to focus on WHAT (metrics), WHY (value), and HOW (user-facing commands)
+- Kept key numbers: 2.78µs lookups, 24 bytes/triple, 86.4% accuracy
+- Removed: rustc commands, cargo bench paths, crate paths
+- User-facing: `node hypermind-benchmark.js` for accuracy comparison
+
 ## [0.5.11] - 2025-12-15
 
 ### Documentation Clarification

package/README.md

@@ -131,68 +131,25 @@ We don't make claims we can't prove. All measurements use **publicly available,
 - **SP2Bench** - DBLP-based SPARQL performance benchmark
 - **W3C SPARQL 1.1 Conformance Suite** - Official W3C test cases
 
-**Test Environment:**
-- Hardware: Apple Silicon M-series (ARM64), Intel x64
-- Dataset: LUBM(1) - 3,272 triples, LUBM(10) - 32K triples, LUBM(100) - 327K triples
-- Tool: Criterion.rs statistical benchmarking (10,000+ iterations per measurement)
-- Comparison: Apache Jena 4.x, RDFox 7.x under identical conditions
-
-| Metric | Value | Context |
-|--------|-------|---------|
+| Metric | Value | Why It Matters |
+|--------|-------|----------------|
 | **Lookup Latency** | 2.78 µs | 35x faster than RDFox |
 | **Memory per Triple** | 24 bytes | 25% more efficient than RDFox |
-| **Bulk Insert** | 146K triples/sec | Competitive with commercial systems |
-| **SPARQL Accuracy** | 86.4% | vs 0% vanilla LLM (LUBM Q1-Q14) |
+| **Bulk Insert** | 146K triples/sec | Production-ready throughput |
+| **SPARQL Accuracy** | 86.4% | vs 0% vanilla LLM (LUBM benchmark) |
 | **W3C Compliance** | 100% | Full SPARQL 1.1 + RDF 1.2 |
-| **SIMD Speedup** | 44.5% avg | Range: 9-77% depending on query |
-| **WCOJ Joins** | O(N^(ρ/2)) | Worst-case optimal guaranteed |
-| **Ontology Support** | RDFS + OWL 2 RL | Full reasoning engine |
-| **Test Coverage** | 945+ tests | Production certified |
-
-**Reproducibility:** All benchmarks at `crates/storage/benches/` and `crates/hypergraph/benches/`. Run with `cargo bench --workspace`.
-
-### Benchmark Methodology
-
-**How we measure performance:**
-
-1. **LUBM Data Generation**
-   ```bash
-   # Generate test data (matches official Java UBA generator)
-   rustc tools/lubm_generator.rs -O -o tools/lubm_generator
-   ./tools/lubm_generator 1 /tmp/lubm_1.nt    # 3,272 triples
-   ./tools/lubm_generator 10 /tmp/lubm_10.nt  # ~32K triples
-   ```
-
-2. **Storage Benchmarks**
-   ```bash
-   # Run Criterion benchmarks (statistical analysis, 10K+ samples)
-   cargo bench --package storage --bench triple_store_benchmark
-
-   # Results include:
-   # - Mean, median, standard deviation
-   # - Outlier detection
-   # - Comparison vs baseline
-   ```
-
-3. **HyperMind Agent Accuracy**
-   ```bash
-   # Run LUBM benchmark comparing Vanilla LLM vs HyperMind
-   node hypermind-benchmark.js
-
-   # Tests 12 queries (Easy: 3, Medium: 5, Hard: 4)
-   # Measures: Syntax validity, execution success, latency
-   ```
-
-4. **Hardware Requirements**
-   - Minimum: 4GB RAM, any x64/ARM64 CPU
-   - Recommended: 8GB+ RAM, Apple Silicon or modern x64
-   - Benchmarks run on: M2 MacBook Pro (baseline measurements)
-
-5. **Fair Comparison Conditions**
-   - All systems tested with identical LUBM datasets
-   - Same SPARQL queries across all systems
-   - Cold-start measurements (no warm cache)
-   - 10,000+ iterations per measurement for statistical significance
+
+### How We Measured
+
+- **Dataset**: LUBM benchmark (industry standard since 2005)
+- **Hardware**: Apple Silicon M2 MacBook Pro
+- **Methodology**: 10,000+ iterations, cold-start, statistical analysis
+- **Comparison**: Apache Jena 4.x, RDFox 7.x under identical conditions
+
+**Try it yourself:**
+```bash
+node hypermind-benchmark.js  # Compare HyperMind vs Vanilla LLM accuracy
+```
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rust-kgdb",
-  "version": "0.5.11",
+  "version": "0.5.12",
   "description": "Production-grade Neuro-Symbolic AI Framework: +86.4% accuracy improvement over vanilla LLMs. High-performance knowledge graph (2.78µs lookups, 35x faster than RDFox). Features fraud detection, underwriting agents, WASM sandbox, type/category/proof theory, and W3C SPARQL 1.1 compliance.",
   "main": "index.js",
   "types": "index.d.ts",