mirror of https://github.com/ruvnet/RuVector.git synced 2026-05-22 19:56:25 +00:00

History

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
..
benches	fix: format all files, add EXO crate READMEs, convert path deps to version deps	2026-02-27 16:21:14 +00:00
src	fix: format all files, add EXO crate READMEs, convert path deps to version deps	2026-02-27 16:21:14 +00:00
tests	fix: format all files, add EXO crate READMEs, convert path deps to version deps	2026-02-27 16:21:14 +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	docs: add README files for ruvector-dither and thermorust crates	2026-02-27 16:14:34 +00:00

README.md

thermorust

A minimal thermodynamic neural-motif engine for Rust. Treats computation as energy-driven state transitions with Landauer-style dissipation tracking and Langevin/Metropolis noise baked in.

Features

Ising and soft-spin Hamiltonians with configurable coupling matrices and local fields.
Metropolis-Hastings (discrete) and overdamped Langevin (continuous) dynamics.
Landauer dissipation accounting -- every accepted irreversible transition charges kT ln 2 of heat, giving a physical energy audit of your computation.
Langevin and Poisson spike noise sources satisfying the fluctuation-dissipation theorem.
Thermodynamic observables -- magnetisation, pattern overlap, binary entropy, free energy, and running energy/dissipation traces.
Pre-wired motif factories -- ring, fully-connected, Hopfield memory, and random soft-spin networks ready to simulate out of the box.
Simulated annealing helpers for both discrete and continuous models.

Quick start

use thermorust::{motifs::IsingMotif, dynamics::{Params, anneal_discrete}};
use rand::SeedableRng;

let mut motif = IsingMotif::ring(16, 0.2);
let params    = Params::default_n(16);
let mut rng   = rand::rngs::StdRng::seed_from_u64(42);

let trace = anneal_discrete(
    &motif.model, &mut motif.state, &params, 10_000, 100, &mut rng,
);
println!("Mean energy: {:.3}", trace.mean_energy());
println!("Heat shed:   {:.3e} J", trace.total_dissipation());

Continuous soft-spin simulation

use thermorust::{motifs::SoftSpinMotif, dynamics::{Params, anneal_continuous}};
use rand::SeedableRng;

let mut motif = SoftSpinMotif::random(32, 1.0, 0.5, 42);
let params    = Params::default_n(32);
let mut rng   = rand::rngs::StdRng::seed_from_u64(7);

let trace = anneal_continuous(
    &motif.model, &mut motif.state, &params, 5_000, 50, &mut rng,
);

Modules

Module	Description
`state`	`State` -- activation vector with cumulative dissipation counter
`energy`	`EnergyModel` trait, `Ising`, `SoftSpin`, `Couplings`
`dynamics`	`step_discrete` (MH), `step_continuous` (Langevin), annealers
`noise`	Langevin Gaussian and Poisson spike noise sources
`metrics`	Magnetisation, overlap, entropy, free energy, `Trace`
`motifs`	Pre-wired ring, fully-connected, Hopfield, and soft-spin motifs

Dependencies

rand 0.8 (with small_rng)
rand_distr 0.4

License

Licensed under either of Apache License, Version 2.0 or MIT License at your option.