ruvector/docs/adr
Reuven 8403d563df feat(ruvllm): implement ADR-090 Ultra-Low-Bit QAT & Pi-Quantization
Phase 1-4 implementation of ADR-090 with 114 tests passing.

## Core Quantization (src/quantize/)
- pi_quant.rs: PiQuantizer with π/k step sizes, Pi3BitBlock, Pi2BitBlock
- pi_quant_simd.rs: NEON/AVX2/scalar dequantization kernels (2.1x speedup)
- hadamard.rs: Fast Walsh-Hadamard O(n log n), INV-4 orthogonality verified
- incoherence.rs: IncoherenceTransform for QuIP-style decorrelation
- quip.rs: Q2_QuIP variant combining incoherence + 2-bit K-quant
- security.rs: WeightIntegrity, GGUF validation, bounds checking

## QAT Infrastructure (src/qat/)
- config.rs: QatConfig, SteVariant, QuantGranularity with builder pattern
- ste.rs: Straight-through estimator (Standard, Clipped, LSQ, EWGS)
- differentiable_quant.rs: DifferentiableQuantizer trait, PiQuantDifferentiable
- calibration.rs: CalibrationEngine with mixed-domain support
- distillation.rs: Teacher-student composite loss (L_task + L_KD + L_reasoning)
- reasoning_loss.rs: Chain-of-thought fidelity preservation
- training_loop.rs: QatTrainer orchestrator with checkpointing
- lora_qat.rs: Memory-efficient LoRA-QAT (50 MB vs 114 GB for full QAT)

## WASM Integration (ruvllm-wasm/)
- pi_quant_wasm.rs: PiQuantWasm with SIMD128 kernel, JSON serialization
- quant_bench_wasm.rs: QuantBenchWasm for in-browser benchmarking
- Feature flags: pi-quant, qat

## Tests (114 passing)
- pi_quant_tests.rs (35): Round-trip, block packing, bounds checking
- hadamard_tests.rs (23): Orthogonality, invertibility, energy preservation
- ste_tests.rs (24): Gradient correctness, PyTorch reference comparison
- simd_equivalence_tests.rs (19): SIMD ≈ scalar within 1 ULP (INV-8)
- acceptance_gates.rs (13): G1-G5 quality and security gates

## Benchmarks (benches/pi_quant_bench.rs)
- Hadamard 4096: 5.3 μs (target <50 μs) ✓
- NEON dequant: 2.54 GiB/s (2.1x over scalar)
- QAT backward: 7.3 Gelem/s

## Invariants Verified
- INV-1: STE gradient flow
- INV-2: Scale positivity (α > 0)
- INV-3: Step size constraint (π/k)
- INV-4: Hadamard orthogonality
- INV-5: Calibration provenance
- INV-8: SIMD ≈ scalar (≤1 ULP)

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-03-12 12:36:36 -04:00
..
coherence-engine feat(prime-radiant): Universal Coherence Engine with Sheaf Laplacian AI Safety (#131) 2026-01-22 21:27:27 -05:00
delta-behavior feat(delta-behavior): Complete Δ-behavior implementation with WASM 2026-01-28 04:18:34 +00:00
quantum-engine feat(ruqu): add quantum execution intelligence engine with 5 backends 2026-02-12 12:55:21 -05:00
temporal-tensor-store feat(rvf): RuVector Format — Universal Cognitive Container SDK (#166) 2026-02-14 13:14:49 -05:00
ADR-001-ruvector-core-architecture.md feat(rvf): RuVector Format — Universal Cognitive Container SDK (#166) 2026-02-14 13:14:49 -05:00
ADR-002-ruvllm-integration.md feat(training): RuvLTRA v2.4 Ecosystem Edition - 100% routing accuracy (#123) 2026-01-20 20:08:30 -05:00
ADR-003-simd-optimization-strategy.md feat(training): RuvLTRA v2.4 Ecosystem Edition - 100% routing accuracy (#123) 2026-01-20 20:08:30 -05:00
ADR-004-kv-cache-management.md feat(training): RuvLTRA v2.4 Ecosystem Edition - 100% routing accuracy (#123) 2026-01-20 20:08:30 -05:00
ADR-005-wasm-runtime-integration.md feat(rvf): RuVector Format — Universal Cognitive Container SDK (#166) 2026-02-14 13:14:49 -05:00
ADR-006-memory-management.md feat(rvf): RuVector Format — Universal Cognitive Container SDK (#166) 2026-02-14 13:14:49 -05:00
ADR-007-security-review-technical-debt.md feat(training): RuvLTRA v2.4 Ecosystem Edition - 100% routing accuracy (#123) 2026-01-20 20:08:30 -05:00
ADR-008-mistral-rs-integration.md feat(training): RuvLTRA v2.4 Ecosystem Edition - 100% routing accuracy (#123) 2026-01-20 20:08:30 -05:00
ADR-009-structured-output.md feat(training): RuvLTRA v2.4 Ecosystem Edition - 100% routing accuracy (#123) 2026-01-20 20:08:30 -05:00
ADR-010-function-calling.md feat(training): RuvLTRA v2.4 Ecosystem Edition - 100% routing accuracy (#123) 2026-01-20 20:08:30 -05:00
ADR-011-prefix-caching.md feat(training): RuvLTRA v2.4 Ecosystem Edition - 100% routing accuracy (#123) 2026-01-20 20:08:30 -05:00
ADR-012-security-remediation.md feat(training): RuvLTRA v2.4 Ecosystem Edition - 100% routing accuracy (#123) 2026-01-20 20:08:30 -05:00
ADR-013-huggingface-publishing.md feat(training): RuvLTRA v2.4 Ecosystem Edition - 100% routing accuracy (#123) 2026-01-20 20:08:30 -05:00
ADR-014-coherence-engine.md feat(prime-radiant): Universal Coherence Engine with Sheaf Laplacian AI Safety (#131) 2026-01-22 21:27:27 -05:00
ADR-015-coherence-gated-transformer.md feat(prime-radiant): Universal Coherence Engine with Sheaf Laplacian AI Safety (#131) 2026-01-22 21:27:27 -05:00
ADR-016-delta-behavior-ddd-architecture.md feat(delta-behavior): Complete Δ-behavior implementation with WASM 2026-01-28 04:18:34 +00:00
ADR-017-temporal-tensor-compression.md feat: Add ADR-017 temporal tensor compression with tiered quantization 2026-02-06 00:28:21 +00:00
ADR-024-craftsman-ultra-30b-1bit-bitnet-integration.md fix: ADR structural cleanup — resolve duplicates, fix filenames, enable Firestore persistence (#232) 2026-03-03 18:54:24 +00:00
ADR-025-exo-ai-multiparadigm-integration.md fix: ADR structural cleanup — resolve duplicates, fix filenames, enable Firestore persistence (#232) 2026-03-03 18:54:24 +00:00
ADR-026-rvcow-branching-and-real-cognitive-containers.md fix: ADR structural cleanup — resolve duplicates, fix filenames, enable Firestore persistence (#232) 2026-03-03 18:54:24 +00:00
ADR-027-hnsw-parameterized-query-fix.md fix: ADR structural cleanup — resolve duplicates, fix filenames, enable Firestore persistence (#232) 2026-03-03 18:54:24 +00:00
ADR-028-ehealth-platform-architecture.md feat: add package.json for rvdna example with WASM bindings and build scripts 2026-02-12 15:32:55 +00:00
ADR-029-rvf-canonical-format.md docs(adr): update ADRs with implementation details from rvf-types 2026-02-16 02:58:43 +00:00
ADR-030-rvf-cognitive-container.md docs(adr): update ADRs with implementation details from rvf-types 2026-02-16 02:58:43 +00:00
ADR-031-rvf-example-repository.md feat(rvf): RuVector Format — Universal Cognitive Container SDK (#166) 2026-02-14 13:14:49 -05:00
ADR-032-rvf-wasm-integration.md feat(rvf): expose AGI components via npm packages 2026-02-17 01:41:13 +00:00
ADR-033-progressive-indexing-hardening.md harden(adr-033): QualityEnvelope, triple budget caps, selective scan, fuzz benchmark 2026-02-15 16:00:16 +00:00
ADR-034-qr-cognitive-seed.md feat(adr-034): zero-dep QR cognitive seed with real crypto and mobile FFI 2026-02-15 17:54:26 +00:00
ADR-035-capability-report.md feat(adr-035): capability report — witness bundles, scorecards, governance 2026-02-15 18:22:15 +00:00
ADR-036-agi-cognitive-container.md feat(rvf): expose AGI components via npm packages 2026-02-17 01:41:13 +00:00
ADR-037-publishable-rvf-acceptance-test.md feat(rvf): expose AGI components via npm packages 2026-02-17 01:41:13 +00:00
ADR-038-npx-ruvector-rvlite-witness-integration.md docs(adr): ADR-038 npx ruvector & rvlite witness verification integration 2026-02-16 00:17:00 +00:00
ADR-039-rvf-solver-wasm-agi-integration.md feat(rvf): add Causal Atlas dashboard, solver fixes, and desktop app 2026-02-20 18:01:09 +00:00
ADR-040-causal-atlas-rvf-runtime-planet-detection.md fix: ADR structural cleanup — resolve duplicates, fix filenames, enable Firestore persistence (#232) 2026-03-03 18:54:24 +00:00
ADR-042-Security-RVF-AIDefence-TEE.md feat(security): Security Hardened RVF v3.0 — 30 capabilities verified 2026-02-21 17:39:58 +00:00
ADR-043-external-intelligence-providers.md feat(intelligence): ADR-043 External Intelligence Providers for SONA Learning 2026-02-21 18:00:06 +00:00
ADR-044-ruvector-postgres-v03-extension-upgrade.md feat: add 43 new SQL functions in ruvector-postgres v0.3.0 (ADR-044) 2026-02-21 20:38:43 +00:00
ADR-045-lean-agentic-integration.md feat: add formal verification layer with lean-agentic dependent types 2026-02-25 03:45:18 +00:00
ADR-046-graph-transformer-architecture.md feat: proof-gated graph transformer with 8 verified modules 2026-02-25 14:24:53 +00:00
ADR-047-proof-gated-mutation-protocol.md feat: proof-gated graph transformer with 8 verified modules 2026-02-25 14:24:53 +00:00
ADR-048-sublinear-graph-attention.md feat: proof-gated graph transformer with 8 verified modules 2026-02-25 14:24:53 +00:00
ADR-049-verified-training-pipeline.md feat: proof-gated graph transformer with 8 verified modules 2026-02-25 14:24:53 +00:00
ADR-050-graph-transformer-bindings.md feat: proof-gated graph transformer with 8 verified modules 2026-02-25 14:24:53 +00:00
ADR-051-physics-informed-graph-layers.md feat: proof-gated graph transformer with 8 verified modules 2026-02-25 14:24:53 +00:00
ADR-052-biological-graph-layers.md feat: proof-gated graph transformer with 8 verified modules 2026-02-25 14:24:53 +00:00
ADR-053-temporal-causal-graph-layers.md feat: proof-gated graph transformer with 8 verified modules 2026-02-25 14:24:53 +00:00
ADR-054-economic-graph-layers.md feat: proof-gated graph transformer with 8 verified modules 2026-02-25 14:24:53 +00:00
ADR-055-manifold-graph-layers.md feat: proof-gated graph transformer with 8 verified modules 2026-02-25 14:24:53 +00:00
ADR-056-rvf-knowledge-export.md Add developer quickstart guide and knowledge export JSON 2026-02-27 03:41:13 +00:00
ADR-057-federated-rvf-transfer-learning.md Add developer quickstart guide and knowledge export JSON 2026-02-27 03:41:13 +00:00
ADR-058-hash-security-optimization.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-059-shared-brain-google-cloud.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-060-shared-brain-capabilities.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-061-reasoning-kernel-architecture.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-062-brainpedia-architecture.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-063-wasm-executable-nodes.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-064-pi-brain-infrastructure.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-065-npm-publishing-strategy.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-066-sse-mcp-transport.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-067-mcp-gate-permit-system.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-068-domain-expansion-transfer-learning.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-069-google-edge-network-deployment.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-070-npx-ruvector-unified-integration.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-071-npx-ruvector-ecosystem-gap-analysis.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-072-rvf-example-management-downloads.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-073-pi-platform-security-optimization.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-074-ruvllm-neural-embeddings.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-075-rvf-agi-stack-brain-integration.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-076-agi-capability-wiring-architecture.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-077-midstream-brain-integration.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-078-npx-ruvector-midstream-integration.md fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 2026-03-03 12:53:10 -05:00
ADR-079-sql-audit-script-hardening.md fix: ruvector-postgres v0.3.2 — 100% audit pass (HNSW + hybrid fixes) (#230) 2026-03-03 13:21:48 -05:00
ADR-080-npx-ruvector-deep-capability-audit.md fix: correct ADR-080 audit discrepancies verified against source (#231) 2026-03-03 13:28:27 -05:00
ADR-081-brain-server-v028-deploy-cli-fixes.md feat: brain server v0.2.10 — bug fixes, GET /v1/pages, 9 MCP tools (#234) 2026-03-03 17:06:23 -05:00
ADR-082-brain-security-hardening.md feat: brain training loops — background SONA + Pareto, POST /v1/train, CLI + MCP (#236) 2026-03-06 08:35:50 -05:00
ADR-083-brain-training-loops.md feat: brain training loops — background SONA + Pareto, POST /v1/train, CLI + MCP (#236) 2026-03-06 08:35:50 -05:00
ADR-084-ruvllm-wasm-publish.md feat: ruvllm-wasm v2.0.0 — first functional WASM publish 2026-03-06 14:55:34 +00:00
ADR-085-neural-trader-ruvector.md fix: renumber ADR-084 → ADR-085, fix unused deps in neural-trader crates 2026-03-06 19:12:33 +00:00
ADR-086-neural-trader-wasm.md feat: add neural-trader-wasm crate with WASM bindings and ADR-086 2026-03-08 16:17:58 +00:00
ADR-087-ruvix-cognition-kernel.md security: harden ADR-087 with 6 security audit findings 2026-03-08 17:06:09 +00:00
ADR-088-cnn-contrastive-integration.md feat(ruvector-cnn): CNN contrastive learning + SIMD optimization fixes (#252) 2026-03-11 17:41:53 -04:00
ADR-089-cnn-browser-demo.md feat: add interactive CNN browser demo for GitHub Pages (#253) 2026-03-11 17:50:42 -04:00
ADR-090-implementation-checklist.md docs(adr): add governance improvements to ADR-090/091, create ADR-092, add implementation checklists 2026-03-12 10:47:00 -04:00
ADR-090-ultra-low-bit-qat-pi-quantization-ddd.md feat(ruvllm): implement ADR-090 Ultra-Low-Bit QAT & Pi-Quantization 2026-03-12 12:36:36 -04:00
ADR-091-implementation-checklist.md docs(adr): add governance improvements to ADR-090/091, create ADR-092, add implementation checklists 2026-03-12 10:47:00 -04:00
ADR-091-int8-cnn-quantization-ddd.md feat(ruvllm): implement ADR-090 Ultra-Low-Bit QAT & Pi-Quantization 2026-03-12 12:36:36 -04:00
ADR-092-moe-memory-aware-routing-ddd.md docs(adr): add governance improvements to ADR-090/091, create ADR-092, add implementation checklists 2026-03-12 10:47:00 -04:00