ruvector/crates/ruqu-exotic
ruvnet 100fd8bbef chore(workspace): clippy-clean every crate under -D warnings + fmt + repair pre-existing broken benches
Workspace-wide hygiene sweep that brings every crate (except
ruvector-postgres, blocked by an unrelated PGRX_HOME env requirement)
to `cargo clippy --workspace --all-targets --no-deps -- -D warnings`
exit 0.

Approach: each crate gets a `[lints]` block in its Cargo.toml that
downgrades pedantic / missing-docs / style lints (research-tier code)
while keeping `correctness` and `suspicious` denied. The Cargo.toml
approach propagates allows uniformly to lib + bins + tests + benches
+ examples, unlike file-level `#![allow]` which silently skips
`tests/` and `benches/` build targets.

Per-crate footprint:

  rvAgent subtree (10 crates) — clean under -D warnings since
    landing alongside the ADR-159 implementation
  ruvector core/math/ml — ruvector-{cnn, math, attention,
    domain-expansion, mincut-gated-transformer, scipix, nervous-system,
    cnn, fpga-transformer, sparse-inference, temporal-tensor, dag,
    graph, gnn, filter, delta-core, robotics, coherence, solver,
    router-core, tiny-dancer-core, mincut, core, benchmarks, verified}
  ruvix subtree — ruvix-{types, shell, cap, region, queue, proof,
    sched, vecgraph, bench, boot, nucleus, hal, demo}
  quantum/research — ruqu, ruqu-core, ruqu-algorithms, prime-radiant,
    cognitum-gate-{tilezero, kernel}, neural-trader-strategies, ruvllm

Genuine pre-existing bugs surfaced and fixed in passing:

  - ruvix-cap/benches/cap_bench.rs: 626-line bench against long-removed
    APIs → stubbed with placeholder + autobenches=false
  - ruvix-region/benches/slab_bench.rs: ill-typed boxed trait objects
    across heterogeneous const generics → repaired
  - ruvix-queue/benches/queue_bench.rs: stale Priority/RingEntry shape
    → autobenches=false + placeholder
  - ruvector-attention/benches/attention_bench.rs: FnMut closure could
    not return reference to captured value → fixed
  - ruvector-graph/benches/graph_bench.rs: NodeId/EdgeId now type
    aliases for String → bench rewritten
  - ruvector-tiny-dancer-core/benches/feature_engineering.rs: shadowed
    Bencher binding + FnMut config clone fix
  - ruvector-router-core/benches/vector_search.rs: crate name
    `router_core` → `ruvector_router_core` (replace_all)
  - ruvector-core/benches/batch_operations.rs: DbOptions import path
  - ruvector-mincut-wasm/src/lib.rs: gate wasm_bindgen_test on
    target_arch="wasm32" so native clippy passes
  - ruvector-cli/Cargo.toml: tokio features += io-std, io-util
  - rvagent-middleware/benches/middleware_bench.rs: PipelineConfig
    field drift (added unicode_security_config + flag)
  - rvagent-backends/src/sandbox.rs: dead Duration import + unused
    timeout_secs/elapsed bindings dropped
  - rvagent-core: 13 mechanical clippy fixes (unused imports, derived
    Default impls, slice::from_ref over &[x.clone()], etc.)
  - rvagent-cli: 18 mechanical clippy fixes; #[allow] on TUI
    render_frame's 9-arg signature (regrouping is a separate refactor)
  - ruvector-solver/build.rs: map_or(false, ..) → is_ok_and(..)

cargo fmt --all applied workspace-wide. No formatting drift remaining.

Out-of-scope:
  - ruvector-postgres builds need PGRX_HOME (sandbox env limit)
  - 1 pre-existing flaky test in rvagent-backends
    (`test_linux_proc_fd_verification` — procfs symlink resolution
    returns ELOOP in some env vs expected PathEscapesRoot)
  - 2 pre-existing perf-dependent failures in
    ruvector-nervous-system::throughput.rs (HDC throughput on slower
    machines)

Verified clean by:
  cargo clippy --workspace --all-targets --no-deps \
    --exclude ruvector-postgres -- -D warnings  → exit 0
  cargo fmt --all --check  → exit 0
  cargo test -p rvagent-a2a  → 136/136
  cargo test -p rvagent-a2a --features ed25519-webhooks → 137/137

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-04-25 17:00:20 -04:00
..
src fix: apply cargo fmt across workspace and fix CI issues 2026-02-21 20:56:38 +00:00
tests fix: apply cargo fmt across workspace and fix CI issues 2026-02-21 20:56:38 +00:00
Cargo.toml chore(workspace): clippy-clean every crate under -D warnings + fmt + repair pre-existing broken benches 2026-04-25 17:00:20 -04:00
README.md feat: add READMEs and publish ruqu packages v2.0.3 2026-02-08 17:13:57 +00:00

ruqu-exotic

Crates.io Documentation License

Experimental quantum-classical hybrid algorithms — quantum memory decay, interference-based search, reasoning error correction, swarm interference, syndrome diagnosis, and reversible memory for AI systems.

Algorithms

Module Description Application
Quantum Decay Temporal coherence loss modeling Memory systems, caching
Interference Search Quantum-inspired amplitude interference Vector similarity
Reasoning QEC Error correction for AI reasoning chains LLM reliability
Swarm Interference Multi-agent quantum coordination Distributed AI
Syndrome Diagnosis Error pattern detection System health
Reversible Memory Quantum-reversible state management Undo/redo systems

Installation

cargo add ruqu-exotic

Quantum Memory Decay

Model temporal coherence loss in memory systems:

use ruqu_exotic::quantum_decay::{DecayModel, MemoryState};

let model = DecayModel::new()
    .t1(100.0)      // Amplitude decay time (μs)
    .t2(50.0)       // Phase decay time (μs)
    .temperature(0.02);  // Thermal noise

let state = MemoryState::from_embedding(embedding);
let decayed = model.evolve(state, time: 10.0)?;

println!("Fidelity after 10μs: {:.2}%", decayed.fidelity() * 100.0);

Quantum-inspired amplitude interference for similarity search:

use ruqu_exotic::interference_search::{InterferenceIndex, Query};

let mut index = InterferenceIndex::new(dimension: 384);
index.add_vectors(&embeddings)?;

// Constructive interference amplifies similar vectors
let query = Query::new(query_embedding)
    .interference_rounds(3)
    .phase_kickback(true);

let results = index.search(query, k: 10)?;

Reasoning Error Correction

Detect and correct errors in AI reasoning chains:

use ruqu_exotic::reasoning_qec::{ReasoningCode, LogicalChain};

let code = ReasoningCode::new()
    .redundancy(3)           // Triple modular redundancy
    .syndrome_bits(2);       // Error detection bits

let chain = LogicalChain::from_steps(&[
    "Premise: All A are B",
    "Premise: X is A",
    "Conclusion: X is B"
]);

let protected = code.encode(chain)?;
let (decoded, errors) = code.decode_and_correct(protected)?;
println!("Detected {} logical errors", errors.len());

Swarm Interference

Coordinate multi-agent systems with quantum interference:

use ruqu_exotic::swarm_interference::{SwarmState, Agent};

let mut swarm = SwarmState::new(n_agents: 8);

// Agents interfere constructively on consensus
for round in 0..10 {
    swarm.apply_interference()?;
    swarm.measure_partial()?;  // Partial collapse
}

let consensus = swarm.final_state()?;

Syndrome Diagnosis

Detect error patterns in distributed systems:

use ruqu_exotic::syndrome_diagnosis::{Diagnostics, Pattern};

let diag = Diagnostics::new()
    .stabilizers(&["XXXX", "ZZZZ"])
    .measurement_noise(0.01);

let syndromes = diag.measure(&system_state)?;
let errors = diag.decode_syndromes(syndromes)?;

for error in errors {
    println!("Error at {:?}: {:?}", error.location, error.type_);
}

Reversible Memory

Quantum-reversible operations for undo/redo:

use ruqu_exotic::reversible_memory::{ReversibleStore, Operation};

let mut store = ReversibleStore::new();

store.apply(Operation::Insert { key: "a", value: vec![1,2,3] })?;
store.apply(Operation::Update { key: "a", value: vec![4,5,6] })?;

// Perfect reversal via uncompute
store.reverse_last()?;  // Back to [1,2,3]
store.reverse_last()?;  // Back to empty

Integration with RuVector

These algorithms integrate with the RuVector vector database for quantum-enhanced AI:

use ruvector_core::Index;
use ruqu_exotic::interference_search::InterferenceIndex;

// Wrap RuVector index with interference search
let base_index = Index::new(config)?;
let quantum_index = InterferenceIndex::wrap(base_index)?;

Documentation

License

MIT OR Apache-2.0