ruvnet / ruvnet/RuVector

Release: Neural Trader crates (core, coherence, replay, wasm)

Open
#247 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Rust
Stars
4.5k
Forks
603
Avg merge
23h 32m
Merged PRs (30d)
59

Description

Release Summary

PR #244 merged the Neural Trader feature branch into main, adding 4 new crates and 2 ADRs.

New Crates
Crate Version Tests Publishable
neural-trader-core 0.1.0 2 publish = false
neural-trader-coherence 0.1.0 8 publish = false
neural-trader-replay 0.1.0 2 publish = false
neural-trader-wasm 0.1.1 10 Rust + 43 Node.js publish = false (npm: @ruvector/neural-trader-wasm)
Architecture

Six-layer pipeline treating the limit order book as a dynamic heterogeneous typed graph (10 node types, 12 edge types, 17 property keys) with MinCut coherence gating, CUSUM drift detection, and proof-gated replay memory.

L1 Ingest → L2 Graph → L3 GNN+Attention → L4 Memory → L5 Coherence → L6 Policy

Layers L1 (core), L4 (replay), L5 (coherence), and WASM bindings are implemented. L2, L3, L6 are planned.

Key Features
  • Coherence Gate — tiered permissions (retrieve/write/learn/act) based on MinCut value, CUSUM score, drift score, and regime label
  • Regime-Adaptive Thresholds — Calm (floor=12), Normal (floor=9), Volatile (floor=6)
  • Reservoir Replay Store — bounded O(1) eviction, gated writes, 7 segment classification kinds
  • WASM Bindings — BigInt-safe serialization, hex ID helpers, full coherence gate + replay store in browser
  • Dot-matrix visuals — animated billboard squares and mouse-reactive grid on π.ruv.io landing pages
ADRs
  • ADR-085 — Neural Trader architecture
  • ADR-086 — WASM bindings type mapping strategy
CI Results

All 14 CI checks passed: clippy, 7 feature-flag checks, wasm dedup, test, bench, 4 cross-platform builds (darwin-arm64, darwin-x64, linux-x64-gnu, linux-arm64-gnu).

Publish Checklist
  • Build WASM: CARGO_PROFILE_RELEASE_CODEGEN_UNITS=256 CARGO_PROFILE_RELEASE_LTO=off wasm-pack build --target web --scope ruvector --release
  • Run Node.js smoke tests: node crates/neural-trader-wasm/tests/node-smoke.mjs
  • Publish to npm: cd crates/neural-trader-wasm/pkg && npm publish --access public
  • Deploy π.ruv.io: gcloud builds submit --config=crates/mcp-brain-server/cloudbuild.yaml --project=ruv-dev .
  • Verify dot-matrix visuals on https://pi.ruv.io
Related
  • PR: #244
  • Commits: 5 (feat + fixes + docs + wasm)

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review PR #244, the four crate manifests, and the publish checklist in this issue first. Run the listed wasm-pack and Node.js smoke-test commands, then verify the npm publication and π.ruv.io deployment steps; done means all checklist items are completed and the deployed visuals are verified.

Written by the indexing model from the issue text.

Assessment

Tech stack
node.js, rust, wasm
Domain
cloud, devops, release
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.