vrr/ruvector
2
0
Fork 0
mirror of https://github.com/ruvnet/RuVector.git synced 2026-05-25 15:03:46 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
2341 commits 177 branches 48 tags 582 MiB
Commit graph

76 commits

Author SHA1 Message Date
Reuven
0af0ffe8ca feat(rvagent-learning): add Daily Learning Loop with GOAP reasoning (ADR-115) 
Implements a complete daily learning and optimization loop for RuVector:

## GOAP Planner
- A* search-based Goal-Oriented Action Planning
- 8 default actions: scan_codebase, analyze_patterns, compute_novelty,
  log_discovery, submit_to_pi, consolidate_sona, refresh_connection,
  reason_with_gemini
- LearningWorldState with 20+ state variables
- Goal conditions: Equal, GreaterOrEqual, LessThan

## Discovery System
- CodebaseScanner for pattern discovery across multiple languages
- PatternAnalyzer with signature matching for common patterns
- DiscoveryLog with full method provenance and tool attribution
- QualityAssessment with novelty, usefulness, clarity, correctness,
  generalizability scores

## Integration
- PiRuvIoClient for π.ruv.io cloud brain submission with retry logic
- GeminiGoapReasoner for GOAP planning using Gemini 2.5 Flash
- SecretManager for Google Cloud secrets (via gcloud CLI)
- Submission queue with exponential backoff

## Scheduler
- DailyLearningScheduler with scheduled and opportunistic triggers
- Trigger detection: idle period, git commits, trajectory buffer
- Configurable quality thresholds and scan parameters

## Consolidation
- SonaConsolidator with EWC++ integration
- Pattern pruning and memory pressure management
- Cosine similarity for pattern search

## ADR & Design
- ADR-115: Daily Learning and Optimization Loop architecture
- Comprehensive GOAP design document with milestones

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-16 20:27:31 -04:00
rUv
2b6c9c57d6
feat(ruvector-core): add OnnxEmbedding for real semantic embeddings (#265) 
Add native ONNX Runtime integration for production-ready semantic embeddings.

## New Features
- `OnnxEmbedding` struct with `from_pretrained()` and `from_files()` methods
- Feature flag: `onnx-embeddings` (optional, not default)
- Auto-downloads models from HuggingFace Hub (~90MB for all-MiniLM-L6-v2)
- Supports sentence-transformers, BGE, E5 model families
- Thread-safe inference via RwLock<Session>
- Mean pooling and L2 normalization for sentence transformers

## Dependencies (optional)
- ort 2.0.0-rc.9 (ONNX Runtime)
- tokenizers 0.20 (HuggingFace tokenizers)
- hf-hub 0.3 (model downloads)

## Documentation
- Updated ADR-114 with implementation details
- Updated lib.rs deprecation warning to reference OnnxEmbedding

Closes #263

Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
 2026-03-16 11:46:47 -04:00
rUv
7de65cc1af
feat(rvAgent): Complete DeepAgents Rust Conversion (ADR-093 → ADR-103) (#262) 
* feat: ADR-093 through ADR-102 — DeepAgents complete Rust conversion planning

10 Architecture Decision Records for 100% fidelity port of
langchain-ai/deepagents (Python) to Rust within the RuVector workspace:

- ADR-093: Master overview and architecture mapping
- ADR-094: Backend protocol traits and 5 implementations
- ADR-095: Middleware pipeline with 9 middleware types
- ADR-096: Tool system with 8 tool implementations
- ADR-097: SubAgent orchestration and state isolation
- ADR-098: Memory, Skills & Summarization middleware
- ADR-099: CLI (ratatui) & ACP server (axum) conversion
- ADR-100: RVF integration and 9-crate workspace structure
- ADR-101: Testing strategy with 80+ test file mappings
- ADR-102: 10-phase, 20-week implementation roadmap (~26k LoC)

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat: ADR-103 review amendments + security audit for DeepAgents conversion

Synthesizes findings from three parallel review agents:
- Performance: 25 findings (7 P0) — typed AgentState, parallel tools, arena allocators
- RVF Capability: 17 integration points — witness chains, SONA, HNSW, COW state
- Security: 30 findings (5 Critical) — TOCTOU, shell hardening, prompt injection

Key amendments: typed AgentState replaces HashMap<String,Value>, parallel tool
execution via JoinSet, atomic path resolution, env sanitization, ACP auth,
witness chain middleware, resource budget enforcement, SONA adaptive learning.

Timeline extended from 20 to 22 weeks with new Phase 11 (Adaptive).

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat: rvAgent scaffold — 8 crates with initial source files (swarm WIP)

Rebrand DeepAgents to rvAgent under crates/rvAgent/ subfolder.
15-agent swarm implementing in parallel:
- rvagent-core: typed AgentState, config, models, graph, messages
- rvagent-backends: protocol, filesystem, shell, composite, state, unicode security
- rvagent-middleware: pipeline with 11 middlewares
- rvagent-tools: 9 tools with enum dispatch
- rvagent-subagents: spec, builder, orchestration
- rvagent-cli: TUI terminal agent
- rvagent-acp: ACP server with auth
- rvagent-wasm: WASM bindings

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): 82 source files from 15-agent swarm — core + backends + middleware + tools + CLI + ACP + WASM

Swarm progress:
- rvagent-core: 12 src files (state, config, graph, messages, models, arena, parallel, metrics, string_pool, prompt, error)
- rvagent-backends: 8 src files (protocol, filesystem, shell, composite, state, utils, unicode_security, security)
- rvagent-middleware: 12 src files (lib, todolist, filesystem, subagents, summarization, memory, skills, patch_tool_calls, prompt_caching, hitl, tool_sanitizer, witness, utils)
- rvagent-tools: 10 src files (lib, ls, read_file, write_file, edit_file, glob, grep, execute, write_todos, task)
- rvagent-subagents: 5 src files (lib, builder, prompts, orchestrator, validator)
- rvagent-cli: 6 src files (main, app, session, tui, display, mcp)
- rvagent-acp: 6 src files (main, server, auth, agent, types, lib)
- rvagent-wasm: 4 src files (lib, backends, tools, bridge)
- Tests: 14 test files across crates
- Benchmarks: 4 criterion bench files

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): additional files from swarm agents — store backend, model fixes, bench updates

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): test suites + security tests + tool refinements from swarm

- 38 unit/integration tests for core+backends (all passing)
- Security test suite for backends
- Tool bench and lib refinements

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* fix(rvAgent): agent refinements — ACP server, backend bench, lib exports

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): core crate finalized (83 tests), tool refinements, middleware bench

- rvagent-core: 83 tests passing, typed AgentState with Arc, SystemPromptBuilder
- Tool implementations refined (ls, read, write, edit, grep, execute)
- Middleware bench updated
- ACP server refinements

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* fix(rvAgent): swarm agent refinements — auth, filesystem, prompt caching

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): integration tests (23 passing) + agent refinements

- Core integration: 8 tests (graph flow, tool calls, parallel, COW state)
- Subagents integration: 8 tests (spawn, isolation, rate limits, parallel)
- ACP integration: 7 tests (health, auth, session lifecycle)
- CLI integration: 9 tests (help, version, session roundtrip)
- Refinements to ACP agent/types, composite backend, HITL, WASM

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): subagents finalized (55 tests), witness middleware, composite fixes

- Subagent orchestrator with JoinSet parallel execution
- Prompt injection detector with 25 patterns across 5 categories
- Result validator with configurable limits (ADR-103 C8)
- Witness middleware, ACP server, composite backend refinements

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): middleware tests, tool sanitizer, ACP lib, utils refinements

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): criterion benchmarks finalized, backend lib + CLI TUI refinements

- 4 criterion benchmark suites (state, backends, tools, middleware)
- Benchmarks cover: Arc clone vs deep clone, line formatting, grep perf,
  unicode detection, tool dispatch, parallel vs sequential, middleware pipeline
- Backend lib.rs and CLI TUI refinements from remaining agents

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): security tests, tool tests, middleware filesystem, TUI updates

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): ACP server finalized (65 tests), tool tests, middleware subagents

- ACP: auth middleware, rate limiter, session management, 6 routes
- New read_file test suite
- Middleware subagents and CLI TUI refinements

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): edit_file tests, CLI display + TUI refinements

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): backends finalized (123 tests), grep/execute tests, summarization

- Backends: 94 unit + 29 integration tests, all passing
- Full security hardening: O_NOFOLLOW, env sanitization, virtual_mode=true
- Unicode security with 36 confusable pairs, BiDi detection
- New grep and execute test suites
- Summarization middleware refinements

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* fix(rvAgent): CLI TUI + tools lib refinements from agents

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): security hardening finalized (77 tests), memory + ls refinements

- Security module: env sanitization, path validation, injection detection,
  YAML bomb protection, rate tracking, heredoc safety, tool call ID validation
- 42 backend security tests + 25 middleware security tests
- All SEC-001 through SEC-022 findings addressed
- Memory middleware and ls tool refinements

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): middleware pipeline tests, write_file refinements

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): CLI finalized (39 tests), edit_file refinements

- CLI: clap args, TUI with ratatui, session management with encryption
- MCP client integration stubs
- Display with markdown rendering, tool call formatting
- 11-middleware pipeline ordering per ADR-103

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): documentation, execute tool refinement, glob_tool cleanup

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): documentation complete, tool + middleware refinements

- README, architecture, security, API reference, getting started guides
- All docs derived from ADR-093 through ADR-103 and source code
- Middleware bench, execute tool, grep tool refinements

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): build verified — 679 tests passing across all 8 crates

All crates compile cleanly, all tests pass:
- rvagent-core: 105 tests (state, config, graph, messages, models, arena, parallel, metrics)
- rvagent-backends: 132 tests (filesystem, shell, composite, state, store, unicode, security)
- rvagent-middleware: 55 tests (pipeline, security, summarization)
- rvagent-tools: 25 tests (dispatch, ls, read, edit, grep, execute)
- rvagent-subagents: 30 tests (compile, isolation, orchestrator, validator)
- rvagent-cli: 39 tests (args, session, display, MCP, TUI)
- rvagent-acp: 65 tests (auth, rate limit, sessions, types)
- rvagent-wasm: 34 tests (agent, backends, tools, bridge)

Fixed subagent integration test state isolation expectations.

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): summarization middleware tests from late agent completion

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): final test suites — orchestrator, security, summarization tests

All 15 swarm agents complete. Final integration tests:
- Orchestrator: compile, isolation, validation, injection detection, parallel spawn
- Security middleware: sanitizer, witness, skill validation, memory trust
- Summarization: compaction triggers, UUID filenames, permissions

688+ tests passing, 0 failures across all 8 crates.

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* perf(rvAgent): deep review — eliminate warnings, optimize hot paths

- Fix 19 compiler warnings across rvagent-cli and rvagent-subagents
  (dead code annotations, unused imports, unused variables)
- Optimize witness hash: pre-allocated hex buffer (no 32 intermediate Strings)
- Optimize injection detection: pre-lowercased markers (no per-call allocation)
- Add #[inline] to hot-path functions: Message::content, has_tool_calls,
  AgentState::message_count, is_image_file
- Zero warnings, 688+ tests passing across all 8 crates

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* perf(rvagent-middleware): optimize SHA3-256 hex encoding

Use pre-allocated buffer with fmt::Write instead of 32 intermediate
String allocations via iterator map/collect.

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): add MCP tools/resources, topology routing, skills bridge

New rvagent-mcp crate (9th crate) with full MCP implementation:
- McpToolRegistry: exposes all 9 built-in tools as MCP tools
- McpResourceProvider: agent state, skills catalog, topology as resources
- TopologyRouter: hierarchical, mesh, adaptive, standalone strategies
- SkillsBridge: cross-platform skills (Claude Code + Codex compatibility)
- McpServer: JSON-RPC 2.0 request dispatch
- Transport layer: stdio, SSE, memory transports

MCP bridge middleware in rvagent-middleware for pipeline integration.

ADR-104: Architecture for MCP tools, resources, and topology routing
ADR-105: Implementation details and protocol specification

893 tests passing across all 9 crates (up from 235).
60+ new MCP/topology/stress tests including:
- Topology routing across all 4 strategies
- 100-node stress tests with churn patterns
- Property-based serde roundtrip validation
- Cross-architecture consistency tests

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* test(rvagent-mcp): update stress tests with topology and skills coverage

Add topology scaling, skills roundtrip, and resource stress tests
alongside the existing registry and protocol stress tests.

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* test(rvagent-mcp): add 96 integration tests across all topologies

Deep integration tests covering MCP protocol, topology routing
(hierarchical, mesh, adaptive, standalone), skills bridge, transport,
and cross-architecture consistency.

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvagent-middleware): add McpToolCallOrigin for transport tracking

Adds origin tracking struct to MCP bridge middleware for identifying
which transport and client initiated each tool call.

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* Add ADR-106: RuVix kernel integration with RVF

Documents the current uni-directional dependency between ruvix and rvf,
identifies type divergence and duplicate implementations, and proposes a
shared-types bridge architecture with feature-gated integration layers.

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): deep ADR-106 RuVix/RVF integration across all layers

Implements the shared-types bridge architecture from ADR-106:

Layer 1 (rvagent-core/rvf_bridge.rs):
- Shared wire types: RvfMountHandle, RvfComponentId, RvfVerifyStatus, WitTypeId
- RVF witness header with 64-byte wire-format serialization
- RvfManifest/RvfManifestEntry for package discovery
- MountTable for tracking mounted RVF packages
- RvfBridgeConfig integrated into RvAgentConfig

Layer 2 (rvagent-middleware/rvf_manifest.rs):
- RvfManifestMiddleware for package discovery and tool injection
- Manifest-driven tool registration (rvf:<tool_name> namespace)
- Package state injection into agent extensions
- Signature verification delegation point (rvf-crypto ready)

Layer 3 (rvagent-backends/rvf_store.rs):
- RvfStoreBackend wrapping any Backend with rvf:// path routing
- Read-only RVF package access via mount table
- Shared mount table across backend instances
- Fallthrough to inner backend for non-RVF operations

Phase 4 (rvagent-middleware/witness.rs):
- WitnessBuilder.with_rvf() for RVF wire-format witness bundles
- add_rvf_tool_call() with latency, policy check, cost tracking
- build_rvf_header() producing rvf-types-compatible WitnessHeader
- to_rvf_entries() converting to RvfToolCallEntry format
- Full backward compatibility with existing witness chain

53 new tests, all 160 tests passing.

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* perf(rvAgent): benchmark suite and optimizations for ADR-106 integration

Add Criterion benchmarks for rvf_bridge (witness header serialization,
mount table operations, manifest filtering, tool call entry serde) and
witness middleware (hash computation, builder throughput, RVF entry
conversion).

Optimizations:
- MountTable: O(1) lookups via HashMap indices by handle ID and package
  name (was O(n) linear scan). New get_by_name() method.
- compute_arguments_hash: LUT-based hex encoding (eliminates 32 write!
  calls per hash invocation)
- truncate_hash_to_8: zero-allocation inline hex decoder (was allocating
  intermediate Vec)
- RvfStoreBackend: ls_info/read_file use O(1) get_by_name instead of
  linear scan through mount table entries
- all_tools: filter entries inline instead of calling manifest.tools()
  which allocates an intermediate Vec

Benchmark results:
- Witness header wire-format roundtrip: 6.5ns (215x faster than serde JSON)
- MountTable get by handle: 12ns (O(1))
- MountTable find by name: 2.8ns (O(1))
- Hash computation (small args): 511ns
- 50 RVF entries + header build: 155µs

All 348 tests pass across rvagent-core, rvagent-backends, rvagent-middleware.

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* feat(rvAgent): implement all critical improvements — 825 tests passing

Major improvements across all 8 crates:

1. Anthropic LLM backend (rvagent-backends/src/anthropic.rs)
   - Real HTTP client calling Anthropic Messages API via reqwest
   - Message conversion between rvAgent types and API format
   - Retry with exponential backoff (3 retries on 429/500/502/503)
   - API key resolution from env vars or files

2. CLI real agent execution (rvagent-cli/src/app.rs)
   - invoke_agent() now uses AgentGraph with real model calls
   - CliToolExecutor dispatches to rvagent-tools
   - Falls back to StubModel when no API key is configured
   - System prompt integration

3. MCP stdio transport (rvagent-cli/src/mcp.rs)
   - Real subprocess spawning via tokio::process::Command
   - JSON-RPC initialize handshake and tools/list discovery
   - Real tool call execution via JSON-RPC

4. Re-enabled disabled dependencies
   - rvagent-subagents now links backends, middleware, tools
   - rvagent-acp now links all sister crates

5. AES-256-GCM session encryption (rvagent-cli/src/session.rs)
   - Real encryption replacing plaintext stub
   - V1 format backward compatibility
   - Key derivation from RVAGENT_SESSION_KEY env var

6. ACP server real prompt handling (rvagent-acp/src/agent.rs)
   - Wired to AgentGraph for real execution

7. Retry middleware (rvagent-middleware/src/retry.rs)
   - Exponential backoff with configurable retries
   - Integrates into middleware pipeline

8. Streaming support (rvagent-core/src/models.rs)
   - StreamChunk, StreamUsage types
   - StreamingChatModel trait

9. Error handling fixes
   - Poisoned mutex handling in auth.rs
   - Witness policy_hash computed from governance mode

10. Test coverage: 148 → 825 tests (+677)
    - New test files for WriteFile, WriteTodos, Glob tools
    - New tests for MCP bridge, prompt caching, HITL middleware
    - Anthropic client mock server tests

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* test(rvAgent): add live Anthropic API integration test

Skips automatically when ANTHROPIC_API_KEY is not set.
Run with: ANTHROPIC_API_KEY=sk-... cargo test -p rvagent-backends --test live_anthropic_test

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* Add RuVector V2 research series: 50-year forward vision from Cognitum.one

8 research documents exploring how the existing RuVector/rvAgent stack
extends from coherence-gated AI agents to planetary-scale infrastructure:

- 00: Master vision — the Cognitum thesis (coherence > intelligence)
- 01: Cognitive infrastructure — planetary nervous system
- 02: Autonomous systems — robotics to deep space
- 03: Scientific discovery — materials, medicine, physics
- 04: Economic systems — finance, supply chains, governance
- 05: Human augmentation — BCI, prosthetics, education
- 06: Planetary defense — climate, security, resilience
- 07: Implementation roadmap — 12-month sprint to 2075

Every claim traces to existing crates: prime-radiant, cognitum-gate-kernel,
ruvector-nervous-system, ruvector-hyperbolic-hnsw, ruvector-gnn, rvAgent,
ruqu-core, ruvector-mincut, and 90+ others.

https://claude.ai/code/session_014KXn8m21w3WDih3xpTY1Tr

* fix(ruvllm-cli): add PiQ3/PiQ2 memory estimate support

Add missing match arms for PiQ3 and PiQ2 quantization formats in
print_memory_estimates function. These pi-constant quantization formats
from ADR-090 were missing in the TargetFormat match statement.

- PiQ3: 3.0625 bits/weight (~75% of Q4_K_M storage)
- PiQ2: 2.0625 bits/weight (~50% of Q4_K_M storage)
- Add MemoryEstimate import for explicit type annotation

Co-Authored-By: claude-flow <ruv@ruv.net>

* docs: add collapsed sections to ruvllm and mcp-brain READMEs

- ruvllm: Wrap Performance, ANE, mistral-rs, LoRA, and Evaluation sections in <details>
- mcp-brain: Wrap REST API, Feature Flags, and Deployment sections in <details>
- mcp-brain: Add Quick Start section with npx ruvector brain examples

Matches root README style with progressive disclosure.

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(rvAgent): add .ruv RVF-integrated agent framework

- Add 4 specialized agent templates (queen, coder, tester, security)
- Add RVF manifest with cognitive container configuration
- Add hooks integration (pre-task, post-task, security-scan)
- Add manifest loader script for environment initialization
- Configure 3-tier model routing (WASM → Haiku → Sonnet/Opus)
- Enable SONA learning with 0.05ms adaptation threshold
- All 725 rvAgent tests passing

Agent capabilities:
- rvagent-queen: Swarm orchestration, consensus, resource allocation
- rvagent-coder: Code generation, refactoring, witness attestation
- rvagent-tester: TDD London School, coverage analysis, mock generation
- rvagent-security: AIMD threat detection, PII scanning, CVE auditing

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(rvAgent): wire AnthropicClient and enable live API calls

- Add CliModel enum to support multiple model backends (Stub, Anthropic)
- Wire AnthropicClient in app.rs for real API calls when key is available
- Add native-tls feature to reqwest for HTTPS support
- Fix request body serialization with explicit JSON stringify
- Add example demo scripts for coder, tester, security agents

Verified working:
- Code generation (Fibonacci with memoization)
- TDD test generation
- Security audit with vulnerability detection
- Architecture design

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat: RuVocal UI thinking blocks + MCP brain delta fixes + rvAgent security

UI/RuVocal:
- Add thinking block collapse regex (THINK_BLOCK_REGEX) to ChatMessage.svelte
- Integrate FoundationBackground animated canvas
- Default to dark mode across app
- Update mcpExamples to RuVector/π Brain focused queries

MCP Brain Server:
- Fix brain_page_delta: add witness_hash field with server-side fallback
- Fix evidence_links: transform simple strings to EvidenceLink structs
- Add voice.rs, optimizer.rs, symbolic.rs modules
- Deploy to Cloud Run (ruvbrain-00092-npp)

rvAgent:
- Enhanced sandbox path security and restrictions
- Add unicode_security middleware
- Add CRDT merge and result validator
- Add AGI container, budget, session crypto modules
- Add swarm examples and Gemini backend
- Security tests and validation

Docs:
- ADR-107 through ADR-111
- Security docs (sandbox, session encryption)
- Implementation summaries

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ruvocal): add WASM MCP tools with server-side virtual filesystem

- Add default WASM file tools (read_file, write_file, list_files, delete_file, edit_file)
  that are always available without client-side WASM setup
- Implement server-side in-memory virtual filesystem for tool execution
- Update toolInvocation.ts to actually execute WASM tools instead of returning placeholder
- Add hasActiveToolsSelection check for WASM tools in toolsRoute.ts
- Force MCP flow when WASM tools are present regardless of router decision
- Add WASM MCP server store with IndexedDB persistence
- Add GalleryPanel component for RVF template selection
- Clean up excessive debug logging

The WASM file tools now execute on an in-memory virtual filesystem
on the server, enabling file operations within conversations without
requiring any client-side WASM module setup.

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ruvocal): implement complete rvAgent WASM MCP toolset

- Add full rvAgent implementation with 15 server-side tools:
  - File operations (5): read, write, list, delete, edit
  - Search tools (2): grep, glob
  - Task management (3): todo_add, todo_list, todo_complete
  - Memory tools (2): memory_store, memory_search (HNSW-indexed)
  - Witness chain (2): witness_log, witness_verify (cryptographic audit)
  - RVF Gallery (3): gallery_list, gallery_load, gallery_search

- Enhance wasm/index.ts with 8 comprehensive agent templates:
  - Development Agent: Full-featured with 8 tools and 4 skills
  - Research Agent: Memory-enhanced with HNSW search
  - Security Agent: 15 built-in security controls
  - Multi-Agent Orchestrator: CRDT-based state merging
  - SONA Learning Agent: 3-loop self-improvement
  - AGI Container Builder: SHA3-256 verified packages
  - Witness Chain Auditor: Cryptographic compliance
  - Minimal Agent: Lightweight file operations

- Each template includes tools, prompts, skills, MCP tools, and capabilities
- Witness chain provides immutable audit trail for all tool calls
- Server-side state persists across conversation turns

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ruvocal): enhance MCP tool descriptions and sidebar sorting

- Improve all 15 WASM MCP tool descriptions with comprehensive guidance
  - Add WHEN TO USE sections for clear usage context
  - Add detailed PARAMETERS documentation with examples
  - Add RETURNS section documenting output format
  - Add EXAMPLES showing typical usage patterns
  - Add IMPORTANT notes and TIPS for edge cases

- Fix NavMenu sidebar conversation sorting
  - Sort conversations by newest first within each group (today/week/month/older)
  - Apply sorting to paginated results when loading more conversations

- Add comprehensive test suite (48 tests)
  - File operations: read, write, list, delete, edit
  - Search tools: grep, glob with pattern matching
  - Task management: todo_add, todo_list, todo_complete
  - Memory tools: memory_store, memory_search with tags
  - Witness chain: witness_log, witness_verify with hash verification
  - RVF gallery: gallery_list, gallery_load, gallery_search

Co-Authored-By: claude-flow <ruv@ruv.net>

* fix(ruvocal): improve WASM MCP tool descriptions for LLM guidance

- Add REQUIRED/OPTIONAL labels to all parameters
- Include concrete examples for every tool
- Clear parameter descriptions with expected formats
- Better guidance on when to use each tool

Tools updated:
- File ops: read_file, write_file, list_files, delete_file, edit_file
- Search: grep, glob
- Tasks: todo_add, todo_list, todo_complete
- Memory: memory_store, memory_search
- Audit: witness_log, witness_verify
- Gallery: gallery_list, gallery_load, gallery_search

Co-Authored-By: claude-flow <ruv@ruv.net>

* fix(ruvocal): add explicit parameter guidance to prevent empty tool calls

- Add TOOL PARAMETERS guidance to system prompt
  - NEVER call tools with empty {} if parameters required
  - Check inputSchema for required fields
  - Use example values as guidance

- Improve error messages with examples
  - Every validation error now includes correct usage example
  - File not found errors show available files
  - Template not found errors list available options
  - Task not found errors show available task IDs

- Updated all 15 WASM tools:
  - read_file, write_file, delete_file, edit_file
  - grep, glob
  - todo_add, todo_complete
  - memory_store, memory_search
  - witness_log
  - gallery_load, gallery_search

Co-Authored-By: claude-flow <ruv@ruv.net>

* fix(ruvocal): intercept empty tool args and auto-fill sensible defaults

- Add autoFillMissingParams() to intercept empty {} requests
- Auto-fill gallery_load with "development-agent" when id missing
- Auto-fill read_file with first available file when path missing
- Auto-fill todo_complete with first incomplete task when id missing
- Auto-fill memory_search with "*" wildcard for empty queries
- Simplify tool descriptions to ultra-concise copyable examples
- Add enum constraints for gallery template IDs
- Add additionalProperties: false to all schemas

This prevents LLM from failing on empty argument calls by providing
reasonable defaults based on available context.

Co-Authored-By: claude-flow <ruv@ruv.net>

* fix(ruvocal): add auto-fill feedback to teach LLM proper arg passing

When parameters are auto-filled, include feedback in the result:
"[AUTO-FILLED: id="development-agent". Next time pass your own values,
 e.g. gallery_load({id: "development-agent"})]"

This teaches the LLM to pass arguments correctly on subsequent calls.

Co-Authored-By: claude-flow <ruv@ruv.net>

* fix(ruvocal): use function signature format for tool descriptions

Change tool descriptions to function signature style that models
understand better:

  gallery_search(query: string) → Search templates by keyword.
  Arguments: {"query": "search_term"}
  Example: {"query": "security"}

This format:
- Shows parameter names and types in signature
- Labels the arguments JSON clearly
- Provides concrete example
- Removes verbose instructions

Also adds feedback notice when parameters are auto-filled so model
learns correct format from results.

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ruvocal): add rvf_help guidance tool and RVF context

- Add rvf_help() tool that explains the RVF agent environment
- Supports topic filter: files, memory, tasks, witness, gallery
- Add RVF context to system prompt when WASM tools present
- Explains what "run in RVF" means
- Lists available gallery templates with descriptions

Model can now call rvf_help() first to understand capabilities.

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ruvocal): add comprehensive system_guidance tool for all MCP tools

- Rename rvf_help to system_guidance (kept alias for compatibility)
- Documents ALL available tools including π Brain and search tools
- Filter by category: files, memory, tasks, witness, gallery, brain, search
- Get specific tool help: system_guidance({"tool": "brain_search"})
- Shows exact JSON format examples for each tool
- Includes tips on proper parameter passing

Model should call system_guidance() first when unsure about capabilities.

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ruvocal): add system_guidance tool to WASM UI panel

- Add system_guidance as first tool in tools/list response
- Shows 🔮 emoji to make it prominent
- Supports tool and category filters
- Add handler with comprehensive documentation for all tools
- Groups by category: files, memory, tasks, gallery, witness, brain

Now visible in Available Tools panel for user guidance.

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ruvocal): add anti-repetition rules and comprehensive tool examples

- Add CRITICAL RULES - AVOID REPETITION section to system prompt
- Add TOOL SEQUENCING patterns (list_files → read_file → analyze)
- Add AVOID THESE PATTERNS with explicit ❌ examples
- Expand system_guidance with practical/advanced/exotic examples for each tool
- Add workflows category showing multi-tool patterns
- Improve tool documentation with required/optional parameter clarity

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(rvAgent): MCP server, WASM gallery, and RVF tools integration

rvagent-mcp:
- Add groups.rs for tool group management
- Add main.rs for standalone MCP server binary
- Update transport and integration tests

rvagent-wasm:
- Add gallery.rs for RVF app gallery support
- Add mcp.rs for MCP tool handlers
- Add rvf.rs for RuVector Format operations
- Update backends for WASM compatibility

Documentation:
- Update ADR-107 through ADR-111
- Add ADR-112: rvAgent MCP Server
- Add ADR-113: RVF App Gallery (RuVix Applications)
- Add ADR-114: RuVector Core Hash Placeholders

RuVocal:
- Add compiled WASM artifacts for browser integration

Co-Authored-By: claude-flow <ruv@ruv.net>

* fix(ruvocal): add wasmTools and autopilotMaxSteps to MessageUpdateRequestOptions

Co-Authored-By: claude-flow <ruv@ruv.net>

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
 2026-03-16 09:52:32 -04:00
rUv
614b9a2872
feat(ruvix): implement CLI, kernel shell, and PBFT consensus (#261) 
* feat(ruvix): implement ADR-087 RuVix Cognition Kernel Phase A

Implements the complete Phase A (Linux-hosted) RuVix Cognition Kernel
with 9 crates, 760 tests, and comprehensive documentation.

## Core Crates (9)
- ruvix-types: 6 kernel primitives (Task, Capability, Region, Queue, Timer, Proof)
- ruvix-cap: seL4-inspired capability management with derivation trees
- ruvix-region: Memory regions (Immutable, AppendOnly, Slab policies)
- ruvix-queue: io_uring-style lock-free IPC with zero-copy semantics
- ruvix-proof: 3-tier proof engine (Reflex <100ns, Standard <100us, Deep <10ms)
- ruvix-sched: Coherence-aware scheduler with priority computation
- ruvix-boot: 5-stage RVF boot loader with ML-DSA-65 signatures
- ruvix-vecgraph: Kernel-resident vector/graph stores with HNSW
- ruvix-nucleus: Unified kernel entry point with 12 syscalls

## Security (SEC-001, SEC-002)
- Boot signature failure: PANIC immediately, no fallback path
- Proof cache: 100ms TTL, single-use nonces, max 64 entries
- Capability delegation depth: max 8 levels with audit warnings

## Architecture
- no_std compatible for Phase B bare metal port
- Proof-gated mutation: every state change requires cryptographic proof
- Capability-based access control: no syscall without valid capability
- Zero-copy IPC via region descriptors (TOCTOU protected)

## Documentation
- Main README with architecture diagrams
- Individual crate READMEs with usage examples
- Architecture decision records

Co-Authored-By: claude-flow <ruv@ruv.net>

* docs: update ADR-087 status and add RuVix to root README

- Update ADR-087 status from Proposed to Accepted (Phase A Implemented)
- Add implementation status table with all 9 crates and 760 tests
- Document security invariants implemented (SEC-001 through SEC-004)
- Add collapsed RuVix section to root README with architecture diagram

Co-Authored-By: claude-flow <ruv@ruv.net>

* chore: update ruvector-coherence dependency to 2.0.4 for crates.io publish

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ruvix): implement ADR-087 Phase B bare metal AArch64 support

Phase B adds bare metal AArch64 support for the RuVix Cognition Kernel:

New crates:
- ruvix-hal: Hardware Abstraction Layer traits (~500 lines)
  - Console, InterruptController, Timer, Mmu, PowerManagement traits
  - Platform-agnostic design for ARM64/RISC-V/x86_64
  - 15 unit tests passing

- ruvix-aarch64: AArch64 boot and MMU support (~2,000 lines)
  - _start assembly entry, exception vectors
  - 4-level page tables with capability metadata
  - System register accessors (SCTLR_EL1, TCR_EL1, TTBR0/1)
  - Implements ruvix_hal::Mmu trait

- ruvix-drivers: Device drivers for QEMU virt (~1,500 lines)
  - PL011 UART driver (115200 8N1, FIFO, interrupts)
  - GIC-400 interrupt controller (256 IRQs, 16 priorities)
  - ARM Generic Timer (deadline scheduling)
  - Volatile MMIO with memory barriers (DMB, DSB, ISB)

Build infrastructure:
- aarch64-boot/ with linker script and custom Rust target
- QEMU virt runner integration (Cortex-A72, 128MB RAM)
- Makefile with build/run/debug targets

ADR-087 updated with:
- Phase B objectives and new crate specifications
- QEMU virt memory map (128MB RAM at 0x40000000)
- 5-stage boot sequence documentation
- Security enhancements and testing strategy
- Raspberry Pi 4/5 platform differences

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ruvix): implement Phases C/D/E and QEMU swarm simulation

This adds full bare metal OS capabilities to the RuVix Cognition Kernel:

## Phase C: Multi-Core & DMA Support
- ruvix-smp: Symmetric multi-processing (256 cores, spinlocks, IPIs)
- ruvix-dma: DMA controller with scatter-gather
- ruvix-dtb: Device tree blob parser
- ruvix-physmem: Buddy allocator for physical memory

## Phase D: Raspberry Pi 4/5 Support
- ruvix-bcm2711: BCM2711/2712 SoC drivers (GPIO, mailbox, UART)
- ruvix-rpi-boot: RPi boot support (spin table, early UART)

## Phase E: Networking & Filesystem
- ruvix-net: Full network stack (Ethernet/ARP/IPv4/UDP/ICMP)
- ruvix-fs: Filesystem layer (VFS, FAT32, RamFS)

## QEMU Swarm Simulation
- qemu-swarm: Multi-QEMU cluster for distributed testing
- Network topologies: mesh, ring, star, tree
- Fault injection and chaos testing scenarios

## Summary
- 10 new crates, ~27,000 lines of code
- 400+ new tests passing
- ADR-087 updated with Phases C/D/E documentation
- Main README updated with all phases

Co-Authored-By: claude-flow <ruv@ruv.net>

* fix(ruvix): address critical security vulnerabilities CVE-001 through CVE-005

Security fixes applied from deep review audit:

- CVE-001 (CRITICAL): Add compile-time protection preventing
  `disable-boot-verify` feature in release builds. This closes
  a boot signature bypass vulnerability.

- CVE-002 (HIGH): Add MMIO address validation to GIC driver.
  `Gic::new()` now returns `Result<Self, GicError>` and validates
  addresses against known platform ranges. Added `new_unchecked()`
  for trusted callers.

- CVE-003 (HIGH): Add integer overflow protection in DTB parser.
  All offset calculations now use `checked_add()` to prevent
  buffer overflow via crafted DTB files.

- CVE-005 (HIGH): Add IPv4 header validation ensuring
  `total_length >= header_len` per RFC 791.

Also includes test fixes:
- Mark hardware-dependent tests as `#[ignore]` (MMIO, ARM timer)
- Fix swap32 test assertion in rpi-boot
- Update doctests for new GIC API

All 259 tests pass across affected crates.

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ruvix): implement CLI, kernel shell, and PBFT consensus

Implements Phase F features for the RuVix Cognition Kernel:

CLI (ruvix-cli):
- build: Cross-compile kernel for AArch64 targets
- config: Manage kernel configuration files
- dtb: Device tree blob operations (validate, dump, compile, compare, search)
- flash: UART/serial flash operations with progress reporting
- keys: Ed25519 key management with secure storage
- monitor: Real-time kernel metrics dashboard
- security: Security audit and vulnerability scanning

Kernel Shell (ruvix-shell):
- Interactive command parser with history support
- Commands: help, info, mem, tasks, caps, vectors, witness, proofs,
  queues, perf, cpu, trace, reboot
- Configurable prompt with trace mode indication
- Shell backend integration with nucleus kernel

PBFT Consensus (qemu-swarm):
- Full PBFT implementation (pre-prepare, prepare, commit phases)
- View change protocol for leader recovery
- Checkpoint mechanism for state synchronization
- Custom serde wrappers for fixed-size byte arrays (Signature, HashDigest)
- Byzantine fault tolerance (f < n/3)

Additional:
- Example RVF swarm consensus demo
- Nucleus shell backend for kernel introspection
- Fixed chrono DateTime type annotation in keys.rs

Co-Authored-By: claude-flow <ruv@ruv.net>

* chore(ruvix): add version specs for crates.io publishing

- Add version = "0.1.0" to ruvix-dtb dependency in CLI
- Add README.md for ruvix-shell crate

Co-Authored-By: claude-flow <ruv@ruv.net>

---------

Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
 2026-03-14 16:25:03 -04:00
Reuven
7c4a8d36bc 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
Reuven
6c1a674a6c docs(adr): add governance improvements to ADR-090/091, create ADR-092, add implementation checklists 
ADR-090 (Ultra-Low-Bit QAT):
- Changed status to "Accepted (Staged Implementation)"
- Added decision statement choosing LoRA-QAT as first path
- Added staged implementation phases (4 phases, explicit gates)
- Added validation plan defining "better" (MSE, spectral, cosine, outlier retention)
- Added reasoning preservation metrics (PPL, GSM8K, HumanEval, tool use, long context)
- Added system invariants (INV-1 through INV-8)
- Added acceptance gates (G1-G6) with rollback triggers
- Restructured success criteria into correctness/performance/quality/rollout

ADR-091 (INT8 CNN Quantization):
- Changed status to "Accepted"
- Added decision statement with acceptance benchmark
- Added system invariants (INV-1 through INV-8)
- Added operator coverage table (11 operators)
- Added graph rewrite passes section (4 passes)
- Added deployment policy matrix
- Added acceptance gates (7 gates) with rollback conditions

ADR-092 (MoE Memory-Aware Routing):
- Split from ADR-090 as routing affects scheduling/cache, not representation
- Added decision statement with acceptance benchmark (≥70% cache hit rate)
- Added system invariants (INV-1 through INV-6)
- Added acceptance gates (G1-G5) with rollback conditions
- Added domain analysis with bounded context

Implementation Checklists:
- ADR-090: 6 phases, ~28 files, 16 new + 12 extended
- ADR-091: 6 phases, acceptance gate verification commands

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-12 10:47:00 -04:00
Reuven
e683eb4b4b docs(adr): add ADR-091 INT8 CNN Quantization DDD Architecture 
Formalizes INT8 quantization for ruvector-cnn with DDD bounded contexts:
- Quantization Core: params, tensors, scale computation
- Calibration: statistics, histograms, MinMax/Percentile methods
- Inference: QuantizedConv2d, fused BatchNorm, INT8 ReLU
- SIMD Kernels: AVX2, NEON, WASM INT8 implementations
- Observability: benchmarks, accuracy validation

Targets 2-4x speedup over FP32 with <1% accuracy loss.
Related to ADR-090 (ultra-low-bit QAT for LLMs).

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-12 10:28:54 -04:00
rUv
aee77babaf
docs(research): add ultra-low-bit quantization & edge deployment research (#255) 
* docs(research): add ultra-low-bit quantization & edge deployment research

Comprehensive research collection on 2-bit/3-bit quantization for ruvLLM:

- 01: Ultra-low-bit quantization survey (ICLR'26, QuIP, BitNet, I-quants)
- 02: Quantization-aware training (QAT) with reasoning preservation
- 03: QuIP 2-bit framework analysis (incoherence processing, E8 lattice)
- 04: MoE memory-aware routing for edge SRAM budgets
- 05: ruvLLM quantization architecture deep review and gap analysis
- 06: Rust implementation plan for 2-bit QAT pipeline (14-week roadmap)
- 07: Novel 3-int pi-constant quantization using irrational scaling

Key findings: ruvLLM has strong foundations (BitNet, K-quants, GGUF, KV cache)
but needs QAT training loop and differentiable quantization primitives.
Pi-constant scaling provides ~0.5 bit effective precision gain at 3-bit.

https://claude.ai/code/session_01E4pmfETYzknb1xq2dzCCaj

* docs(adr): add ADR-090 ultra-low-bit QAT & pi-quantization DDD architecture

Comprehensive architecture decision record for implementing 2-bit/3-bit
quantization-aware training in ruvLLM using Domain-Driven Design:

- 5 bounded contexts: Quantization Core, Training, MoE Routing, WASM Runtime, Observability
- Pi-constant quantization with irrational scaling (pi/k step sizes)
- QAT training loop with STE variants and LoRA-QAT lightweight path
- QuIP incoherence via fast Walsh-Hadamard (O(n log n))
- Memory-aware MoE routing with expert precision allocation
- WASM SIMD128 kernels reusing existing tl1_wasm.rs LUT pattern
- Security: weight integrity, GGUF validation, WASM sandbox
- Benchmarking: criterion suite with throughput/quality targets
- 14-week timeline, maps to 18 existing files for extension

Placed in docs/adr/ddd/ per DDD architectural pattern organization.

https://claude.ai/code/session_01E4pmfETYzknb1xq2dzCCaj

---------

Co-authored-by: Claude <noreply@anthropic.com>
 2026-03-12 10:21:30 -04:00
rUv
42522e2128
feat: add interactive CNN browser demo for GitHub Pages (#253) 
- Single-file HTML demo with modern dark theme UI
- Drag & drop image upload + camera capture
- Real-time embedding extraction and visualization
- Similarity matrix comparing multiple images
- Performance metrics display (~5ms per image)
- Falls back to demo mode if WASM fails to load
- ADR-089 documenting the approach

Deploy to: https://ruvnet.github.io/ruvector/demo/cnn/

Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
 2026-03-11 17:50:42 -04:00
rUv
d172324e42
feat(ruvector-cnn): CNN contrastive learning + SIMD optimization fixes (#252) 
* feat: add CNN contrastive learning crate with SIMD optimization

- Add ruvector-cnn crate with SIMD-optimized convolutions and contrastive losses
- Implement InfoNCE (SimCLR) and TripletLoss for contrastive learning
- Add MobileNet-V3 inspired backbone architecture
- Include AVX2, NEON, WASM SIMD support with scalar fallback
- Add WASM bindings (ruvector-cnn-wasm) for browser/Node.js
- Add npm package with TypeScript definitions
- Include comprehensive research docs and ADR-088
- 36 tests passing

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat: add npm package JavaScript wrapper and TypeScript definitions

Co-Authored-By: claude-flow <ruv@ruv.net>

* fix(ruvector-cnn): implement real SIMD and fix stubbed code

## SIMD Implementations (was using scalar fallbacks)
- AVX2: conv_3x3_avx2, conv_3x3_avx2_fma, depthwise_conv_3x3_avx2
- AVX2: global_avg_pool_avx2, max_pool_2x2_avx2
- WASM: conv_3x3_wasm, depthwise_conv_3x3_wasm

All now use real SIMD intrinsics processing 8 (AVX2) or 4 (WASM)
channels simultaneously with scalar fallback for remainders.

## Backbone Fixes
- Deprecated MobileNetV3Small/Large (use unified MobileNetV3 instead)
- Implemented actual block processing in forward() methods
- Fixed hardcoded channel counts in global_avg_pool calls

## Dead Code Fixes
- Added #[allow(dead_code)] for momentum field (used in training)
- Added #[allow(dead_code)] for rng field (feature-gated)
- Added #[cfg(feature = "augmentation")] for rand::Rng import
- Commented out undefined "parallel" feature reference

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat(ruvector-cnn): add Winograd F(2,3) and π-calibrated INT8 quantization

- Add Winograd F(2,3) transforms for 2.25x faster 3x3 convolutions
- Implement π-calibrated INT8 quantization with anti-resonance offsets
- Apply 4x loop unrolling with 4 accumulators to AVX2 convolutions
- Update README with practical intro, capabilities table, benchmarks
- Update npm README with simpler language and examples
- Add CNN image embeddings to root README capabilities

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat: publish @ruvector/cnn v0.1.0 WASM npm package

- Add unsafe blocks for WASM SIMD intrinsics (v128_load/v128_store)
- Disable wasm-opt to avoid SIMD validation issues
- Build and include WASM bindings in npm package
- Update npm package.json with all WASM files
- Published to npm as @ruvector/cnn@0.1.0

Co-Authored-By: claude-flow <ruv@ruv.net>

---------

Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
 2026-03-11 17:41:53 -04:00
rUv
7c0a8dbb1a security: harden ADR-087 with 6 security audit findings 
Adds Section 20 (Security Hardening Notes) addressing: root task
privilege attenuation post-boot, capability delegation depth limits,
boot RVF proof bootstrap resolution, Reflex proof cache scoping,
zero-copy IPC TOCTOU mitigation, and boot signature failure behavior.
All findings are specification clarifications, not structural flaws.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-08 17:06:09 +00:00
rUv
f91bc77861 feat: add ADR-087 RuVix Cognition Kernel architecture 
Defines a cognition kernel for the Agentic Age with 6 primitives
(task, capability, region, queue, timer, proof), 12 syscalls, and
RVF as the native boot object. Includes coherence-aware scheduler,
proof-gated mutation as kernel invariant, seL4-inspired capabilities,
io_uring-style queue IPC, 8 demo applications, and a two-phase build
path (Linux-hosted nucleus → bare metal AArch64).

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-08 16:34:48 +00:00
rUv
c47a706b52 feat: add neural-trader-wasm crate with WASM bindings and ADR-086 
Adds browser WASM bindings for neural-trader-core, coherence, and replay
crates using the established wasm-bindgen pattern. Includes BigInt-safe
serialization, hex ID helpers, 10 unit tests, 43 Node.js smoke tests,
comprehensive README, and animated dot-matrix visuals for π.ruv.io.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-08 16:17:58 +00:00
rUv
f8b766c65b fix: renumber ADR-084 → ADR-085, fix unused deps in neural-trader crates 
- Rename ADR-084-neural-trader to ADR-085 (ADR-084 is taken by ruvllm-wasm-publish)
- Move serde_json to dev-dependencies in neural-trader-core (only used in tests)
- Remove unused neural-trader-core dependency from neural-trader-coherence

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-06 19:12:33 +00:00
Claude
a76a0b2af9 fix: optimize ADR-084 and harden neural-trader crates 
ADR:
- Add SQL indexes on (symbol_id, ts_ns) for all tables
- Add HNSW index on nt_embeddings.embedding
- Range-partition nt_event_log and nt_segments by timestamp
- Add retention config (hot/warm/cold TTL) to example YAML
- Add retrieval weight normalization constraint (α+β+γ+δ=1)
- Cross-reference existing examples/neural-trader/

Code:
- core: Replace String property keys with PropertyKey enum (zero alloc)
- core: Add PartialEq on MarketEvent for test assertions
- coherence: Fix redundant drift check — learning now requires half
  drift margin (stricter than act/write)
- coherence: Add boundary_stable_count to GateContext and enforce
  boundary stability window threshold from ADR gate policy
- coherence: Add PartialEq on CoherenceDecision
- coherence: Add 2 new tests (high_drift, boundary_instability)
- replay: Switch ReservoirStore from Vec to VecDeque for O(1) eviction
- replay: Use RegimeLabel enum instead of Option<String> in MemoryQuery

12 tests pass (was 10).

https://claude.ai/code/session_01EExDkEDv4eejvfgqUWnSks
 2026-03-06 19:11:37 +00:00
Claude
f091a02950 feat: Add ADR-084 Neural Trader and three starter crates 
ADR-084 defines the RuVector-native Neural Trader architecture using
dynamic market graphs, mincut coherence gating, and proof-gated mutation.
Includes three starter crates (neural-trader-core, neural-trader-coherence,
neural-trader-replay) with canonical types, threshold gate, reservoir
memory store, and 10 passing tests.

https://claude.ai/code/session_01EExDkEDv4eejvfgqUWnSks
 2026-03-06 19:11:37 +00:00
rUv
377871f9bf feat: ruvllm-wasm v2.0.0 — first functional WASM publish 
- Gate WebGPU web-sys features behind `webgpu` Cargo feature flag
- Remove unused bytemuck, gpu_map_mode, GpuSupportedLimits dependencies
- Add wasm-opt=false workaround for Rust 1.91 codegen bug
- Published @ruvector/ruvllm-wasm@2.0.0 with compiled WASM binary (435KB)
- ADR-084 documenting build workarounds and known limitations

Closes #240

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-06 14:55:34 +00:00
rUv
27401ff412
feat: brain training loops — background SONA + Pareto, POST /v1/train, CLI + MCP (#236) 
Bridge the gap between "stores knowledge" and "learns from knowledge":

- Background training loop (tokio::spawn, 5 min interval) runs SONA
  force_learn + domain evolve_population when new data arrives
- POST /v1/train endpoint for on-demand training cycles
- `ruvector brain train` CLI command with --json support
- `brain_train` MCP tool for agent-triggered training
- Vote dedup: 24h TTL on ip_votes entries, author exemption from IP check
- ADR-082 updated, ADR-083 created

Results: Pareto frontier grew 0→24 after 3 cycles. SONA activates
after 100+ trajectory threshold (natural search/share usage).

Publish ruvector@0.2.11.
 2026-03-06 08:35:50 -05:00
rUv
5d51e0b4fe
fix: brain security hardening — PII phone/SSN/CC, IP rate limit, anti-Sybil votes (#235) 
Expand PiiStripper from 12 to 15 regex rules: add phone number,
SSN, and credit card detection/redaction. Add IP-based rate limiting
(1500 writes/hr per IP) to prevent Sybil key rotation bypass. Add
per-IP vote deduplication (one vote per IP per memory) to prevent
quality score manipulation.

63 server tests + 16 PII tests pass. Deployed to Cloud Run.
 2026-03-03 17:52:30 -05:00
rUv
3208afad13
feat: brain server v0.2.10 — bug fixes, GET /v1/pages, 9 MCP tools (#234) 
* feat: proxy-aware fetch + brain API improvements — publish v0.2.7

Add proxyFetch() wrapper to cli.js and mcp-server.js that detects
HTTPS_PROXY/HTTP_PROXY/ALL_PROXY env vars, uses undici ProxyAgent
(Node 18+) or falls back to curl. Handles NO_PROXY patterns.
Replaced all 17 fetch() call sites with timeouts (15-30s).

Brain server API:
- Search returns similarity scores via ScoredBrainMemory
- List supports pagination (offset/limit), sorting (updated_at/quality/votes), tag filtering
- Transfer response includes warnings, source/target memory counts
- New POST /v1/verify endpoint with 4 verification methods

Co-Authored-By: claude-flow <ruv@ruv.net>

* feat: brain server bug fixes, GET /v1/pages, 9 MCP page/node tools — v0.2.10

Fix proxyFetch curl fallback to capture real HTTP status instead of
hardcoding 200, add 204 guards to brainFetch/fetchBrainEndpoint/MCP
handler, fix brain_list schema (missing offset/sort/tags), fix
brain_sync direction passthrough, add --json to share/vote/delete/sync.

Add GET /v1/pages route with pagination, status filter, sort.
Add 9 MCP tools: brain_page_list/get/create/update/delete,
brain_node_list/get/publish/revoke (previously SSE-only).

Polish: delete --json returns {deleted:true,id} not {}, page get
unwraps .memory wrapper for formatted display.

112 MCP tools, 69/69 tests pass. Published v0.2.10 to npm.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-03-03 17:06:23 -05:00
rUv
c47d877d35
fix: ADR structural cleanup — resolve duplicates, fix filenames, enable Firestore persistence (#232) 
ADR file renames:
- ADR-0027 → ADR-027 (fix 4-digit numbering to standard 3-digit)
- ADR-040 filename sanitized (removed spaces, em dash, ampersand)
- ADR-017 duplicate (craftsman) → ADR-024 (temporal-tensor keeps 017)
- ADR-029 duplicate (exo-ai) → ADR-025 (rvf-canonical keeps 029)
- ADR-031 duplicate (rvcow) → ADR-026 (rvf-example keeps 031)

Cloud Run fix (pi.ruv.io):
- Added FIRESTORE_URL env var — enables persistent storage
- Fixed env var packing bug (all flags were in BRAIN_SYSTEM_KEY)
- Dashboard now shows actual data: 240 memories, 30 contributors, 1096 edges
 2026-03-03 18:54:24 +00:00
rUv
2bcc7adc8f
fix: correct ADR-080 audit discrepancies verified against source (#231) 
- MCP entry line count: ~3,816 → 3,815 (verified with wc -l)
- Command groups: 14 → 15 (midstream group was missed)
- CLI test count: 63 → 64 active tests (verified grep -c)
- Dead code → conditionally unreachable (line 1807 runs when @ruvector/router installed)
 2026-03-03 13:28:27 -05:00
rUv
5f0a2c2cc0
fix: ruvector-postgres v0.3.2 — 100% audit pass (HNSW + hybrid fixes) (#230) 
HNSW k-NN fix:
- Search beam width (k) increased from 10 to 100 — previous value
  starved the beam search, causing 0 rows on index scan
- Added ruvector_hnsw_debug() diagnostic function for troubleshooting
- Added warning log when entry_point is InvalidBlockNumber

Hybrid search fix:
- ruvector_hybrid_search() now returns success=true with empty results
  and helpful message on unregistered collections (was success=false)

Audit script fix:
- Corrected hybrid_search argument order in sql-audit-v3.sql Section 9b
- Added HNSW debug diagnostics on 0-row failure

Results: 17 PASS / 0 PARTIAL / 0 FAIL → 100% (up from 88%)
Published: docker.io/ruvnet/ruvector-postgres:0.3.2
 2026-03-03 13:21:48 -05:00
rUv
b6e45eb57f
docs: update ADR-079 with v0.3.1 audit scorecard (88% pass rate) (#229) 
Add full v0.3.1 audit scorecard showing 15 PASS / 1 PARTIAL / 1 FAIL
(up from 47% in v0.3.0). Document function count discrepancies between
audit script pg_proc detection and SQL schema registrations. Add issue
#6 for hybrid search collection setup requirement.
 2026-03-03 13:07:43 -05:00
rUv
82827c876d
docs: add ADR-080 npx ruvector deep capability audit (#228) 
Comprehensive audit of the ruvector npm package (v0.2.5):
- CLI: 179 commands across 14 groups, 4 stubs, lazy loading
- MCP server: 91+12=103 tools, stdio+SSE transports
- Security: 10 findings (Pi key logging, no fetch timeouts, 51% tools lack validation)
- Tests: core database ops (create/insert/search/stats) have zero coverage
- Prioritized fix plan: P0 security, P1 tests, P2 code quality, P3 docs
 2026-03-03 13:06:05 -05:00
rUv
77fa901e6e
fix: ruvector-postgres v0.3.1 — audit bug fixes, 46 SQL functions, Docker publish (#227) 
Fixes #226
 2026-03-03 12:53:10 -05:00
rUv
c2db75d6be Merge remote-tracking branch 'origin/main' into claude/exo-ai-capability-review-LjcVx 
# Conflicts:
#	Cargo.toml
 2026-02-27 16:27:34 +00:00
rUv
1b633bf8d1 Add developer quickstart guide and knowledge export JSON 
- Introduced QUICKSTART.md for RuVector, detailing setup, usage, and architecture.
- Added ruvector-knowledge.rvf.json for comprehensive project metadata, including architecture overview, crate taxonomy, and critical decisions.
 2026-02-27 03:41:13 +00:00
Claude
11e2390c76
docs(adr): ADR-029 EXO-AI multi-paradigm integration architecture 
Comprehensive architectural decision record synthesized from deep swarm
research across all 100+ ruvector crates and examples (~830K lines).

Key findings documented:
- 7 convergent evolution clusters (EWC implemented 4x, coherence gating
  5x, cryptographic witnesses 6x, sheaf theory 3x, spike-driven compute
  4x, Byzantine consensus 4x, free energy solvers 4x)
- 11 EXO-AI research frontiers (all stub directories) have working
  implementations elsewhere in the ecosystem
- Complete integration architecture wiring quantum (ruQu), genomic
  (ruDNA), neuromorphic (ruvector-nervous-system), and consciousness
  (EXO-AI) substrates

Proposes:
- CoherenceRouter: canonical gate over prime-radiant + ruQu + cognitum
- PlasticityEngine: unified EWC++ via SONA + BTSP/E-prop from nervous-system
- CrossParadigmWitness: unified audit chain (RVF SHAKE-256 root)
- 4-phase roadmap (20 weeks) to first quantum-genomic-neuromorphic
  consciousness substrate with formal proofs of consistency

References 30+ peer-reviewed papers including Dec 2025 subpolynomial
dynamic min-cut breakthrough (arXiv:2512.13105).

https://claude.ai/code/session_019Lt11HYsW1265X7jB7haoC
 2026-02-27 02:37:18 +00:00
rUv
e9c8681a22 feat: proof-gated graph transformer with 8 verified modules 
Add ruvector-graph-transformer crate with 8 feature-gated modules,
each backed by an Architecture Decision Record (ADR-046 through ADR-055):

- Proof-gated mutation: ProofGate<T>, MutationLedger, ProofScope, EpochBoundary
- Sublinear attention: O(n log n) via LSH buckets, PPR sampling, spectral sparsification
- Physics-informed: Hamiltonian dynamics, gauge equivariant MP, Lagrangian attention
- Biological: Spiking networks, Hebbian/STDP learning, dendritic branching
- Self-organizing: Morphogenetic fields, developmental programs, graph coarsening
- Verified training: Certificates, delta-apply rollback, fail-closed invariants
- Manifold: Product manifolds S^n x H^m x R^k, Riemannian Adam, Lie groups
- Temporal-causal: Causal masking, Granger causality, continuous-time ODE
- Economic: Nash equilibrium attention, Shapley attribution, incentive-aligned MPNN

Includes:
- 186 tests (163 unit + 23 integration), all passing
- WASM bindings (ruvector-graph-transformer-wasm) - published to crates.io
- Node.js NAPI-RS bindings (@ruvector/graph-transformer) - published to npm
- CI workflow for cross-platform binary builds (7 platforms)
- 10 ADRs (046-055) + 22 research documents
- Fix for #195: add commit-binaries job to build-gnn.yml
- Updated root README with graph transformer section

Published:
- crates.io: ruvector-graph-transformer v2.0.4
- crates.io: ruvector-graph-transformer-wasm v2.0.4
- npm: @ruvector/graph-transformer v2.0.4
- npm: @ruvector/graph-transformer-linux-x64-gnu v2.0.4

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-25 14:24:53 +00:00
rUv
221891295e feat: add formal verification layer with lean-agentic dependent types 
Introduces ruvector-verified and ruvector-verified-wasm crates providing
proof-carrying vector operations with sub-microsecond overhead. Includes
ADR-045, 10 exotic application examples (weapons filter, medical diagnostics,
financial routing, agent contracts, sensor swarm, quantization proof,
verified memory, vector signatures, simulation integrity, legal forensics),
rvf-kernel-optimized example, CI workflow, and root README integration.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-25 03:45:18 +00:00
rUv
b3b2120d63 feat: add 43 new SQL functions in ruvector-postgres v0.3.0 (ADR-044) 
Integrate 5 workspace crates (ruvector-solver, ruvector-math,
ruvector-attention, sona, ruvector-domain-expansion) as 6 feature-gated
modules exposing solver, math distances, TDA, extended attention, Sona
learning, and domain expansion — bringing total to 143 SQL functions.
Docker image verified with all functions passing.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-21 20:38:43 +00:00
rUv
b2aa29aba1 feat(intelligence): ADR-043 External Intelligence Providers for SONA Learning 
Implement trait-based IntelligenceProvider extension point for external
quality signals. Addresses PR #190 proposal (renumbered from ADR-029 to
avoid collision with existing ADR-029-rvf-canonical-format).

- IntelligenceProvider trait with load_signals() and quality_weights()
- FileSignalProvider built-in for JSON file-based signal exchange
- IntelligenceLoader for multi-provider registration and aggregation
- QualitySignal, QualityFactors, ProviderQualityWeights types
- calibration_bias() on TaskComplexityAnalyzer for router feedback
- 12 unit tests (all passing)

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-21 18:00:06 +00:00
rUv
55a968aabe feat(security): Security Hardened RVF v3.0 — 30 capabilities verified 
Upgrade from 22 to 30 capabilities exercising every major RVF API:
- KernelBinding anti-tamper (manifest_root + policy_hash binding)
- Dual WASM modules (Interpreter + Microkernel, self-bootstrapping)
- DASHBOARD_SEG embedded security monitoring UI
- Scalar quantization (int8, 4x compression) via rvf-quant
- Binary quantization (1-bit, 32x compression) + Hamming distance
- Filter deletion + compaction lifecycle
- QEMU requirements check via rvf-launch
- Freeze/seal permanent immutability
- Additional kernel flags: VIRTIO_NET, VSOCK, INGEST_API
- RvfOptions: signing=true, profile=3, m=32, ef_construction=400

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-21 17:39:58 +00:00
rUv
55bc38cd77 docs: add Security Hardened RVF to README and update ADR-042 to v2.0 
- Add security_hardened.rvf entry to RVF Cognitive Containers section
- Add to examples table as top entry
- Link ADR-042 alongside ADR-030 and ADR-031
- Update capabilities table from 20 to 22 (COW branching, audited queries, exfil detection)

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-21 17:00:41 +00:00
rUv
98b2d332f2 feat(security): ADR-042 Security RVF — AIDefence + TEE hardened container 
6-layer defense-in-depth in a single sealed RVF file:
  1. TEE attestation (SGX, SEV-SNP, TDX, ARM CCA) with bound keys
  2. Hardened Linux microkernel (16 security configs, REQUIRES_TEE)
  3. eBPF packet filter (XDP) + syscall enforcer (Seccomp)
  4. AIDefence WASM engine (injection, jailbreak, PII, behavioral)
  5. Ed25519 signing + SHAKE-256 content hashes + Paranoid policy
  6. 6-role RBAC + Coherence Gate authorization

20 capabilities verified, 10/10 AIDefence tests, 3/3 tamper rejections,
30-entry witness chain, 1000 threat signatures (512-dim), 3 tenant stores.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-21 00:45:25 +00:00
rUv
8750b59944 feat(rvf): add Causal Atlas dashboard, solver fixes, and desktop app 
ADR-040 Causal Atlas implementation with full Three.js dashboard:
- Planet detection, life candidate scoring, Dyson sphere 3D views
- WASM solver with fixed acceptance test (evaluate-before-train,
  conservative Thompson sampling, non-contradictory noise injection)
- wry-based desktop app embedding the full dashboard (1.6 MB binary)
- WebSocket live updates, docs view, download page, status dashboard
- 10/10 seed acceptance pass rate (was ~40% before fixes)

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-20 18:01:09 +00:00
rUv
f4da3693c6 feat(rvf): expose AGI components via npm packages 
- Create @ruvector/rvf-solver npm package (TypeScript SDK wrapping
  rvf-solver-wasm WASM module with RvfSolver class, Thompson Sampling,
  ReasoningBank, witness chains)
- Add AGI NAPI methods to rvf-node: indexStats, verifyWitness, freeze, metric
- Add store accessors to rvf-runtime: options(), metric(), epoch()
- Update @ruvector/rvf unified SDK to v0.1.8 with solver re-exports
- Update ADRs 032, 036, 037, 039 with AGI npm package details

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-02-17 01:41:13 +00:00
Claude
c811d4c181 docs(adr): update ADRs with implementation details from rvf-types 
- ADR-029: Add complete segment type registry (23 variants) with source references
- ADR-030: Phase 1 complete — KernelHeader (128B), EbpfHeader (64B), WasmHeader (64B),
  all enums and flag constants implemented with 32+ tests. Updated GOAP world state.
- ADR-032: Add WASM bootstrap types implementation section (WasmHeader, WasmRole,
  WasmTarget, 8 feature flags, 10 tests)
- ADR-036: Status updated to Partially Implemented. Documented AGI container
  implementation (972 lines, 24 tests) including AgiContainerHeader, ExecutionMode,
  AuthorityLevel, ResourceBudget, CoherenceThresholds, ContainerSegments, and
  22 TLV tags with domain expansion integration (0x0112-0x0115)

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-16 02:58:43 +00:00
Claude
608179d2b1 feat(rvf): rvf-solver-wasm — self-learning AGI engine compiled to WASM 
Compiles the complete three-loop adaptive solver to wasm32-unknown-unknown
(160 KB, no_std + alloc). Preserves all AGI capabilities:

- Thompson Sampling two-signal model (safety Beta + cost EMA)
- 18 context buckets with per-arm bandit stats
- Speculative dual-path execution
- KnowledgeCompiler with signature-based pattern cache
- Three-loop architecture (fast/medium/slow)
- SHAKE-256 witness chain via rvf-crypto

12 WASM exports: create/destroy/train/acceptance/result/policy/witness.
Handle-based API supports 8 concurrent solver instances.

ADR-039 documents the integration architecture.
Benchmark binary validates WASM against native solver.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-16 00:43:12 +00:00
Claude
29091e9f2b docs(adr): ADR-038 npx ruvector & rvlite witness verification integration 
Plans the integration path for .rvf acceptance test verification into
the npm ecosystem:

- npx ruvector rvf verify-witness <file.rvf> (N-API + WASM fallback)
- npx rvlite verify-witness <file.rvf> (WASM via cli-rvf.ts)
- rvlite SDK verifyWitnessChain() for browser-side verification
- MCP tool rvf_verify_witness for Claude Code agents
- 5-phase implementation plan, each independently shippable

Bridges the rvf_witness_verify WASM export (ADR-037) to end users
without requiring the Rust toolchain.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-16 00:17:00 +00:00
Claude
e83ed7eb8d feat(rvf): integrate publishable acceptance test with native SHAKE-256 witness chain 
Replace standalone SHA-256 chain with rvf-crypto SHAKE-256, add native .rvf
binary output (WITNESS_SEG + META_SEG), and wire witness verification into
rvf-wasm microkernel.

Key changes:
- Feature-gate ed25519 in rvf-crypto for WASM compatibility (sha3 no_std)
- Rewrite WitnessChainBuilder to use shake256_256 + parallel rvf_crypto::WitnessEntry
- Add export_rvf_binary() with WITNESS_SEG (0x0A) + META_SEG (0x07) segments
- Add rvf_witness_verify/rvf_witness_count exports to rvf-wasm
- Add verify-rvf subcommand to acceptance-rvf CLI
- Write ADR-037 documenting architecture and AGI benchmark integration
- Update rvf-crypto, rvf-wasm, and rvf READMEs

86 tests pass (66 lib + 20 integration). rvf-crypto 49 tests pass.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-16 00:13:44 +00:00
Claude
7ac9005386 refactor(adr-036): optimize AGI container architecture 
- Resolve open questions: repo automation as first domain, four-level
  AuthorityLevel enum, per-task ResourceBudget with hard caps,
  CoherenceThresholds with validation
- Add AGI_MAX_CONTAINER_SIZE (16 GiB) with enforcement in validation
- Tighten ContainerSegments::validate: Verify/Live modes now require
  world model data (VEC or INDEX segments), not just kernel/WASM
- Add ContainerError variants: InsufficientAuthority, BudgetExhausted
- Add to_flags support for orchestrator_present and world_model_present
- Add wire format section and cross-references to ADRs 029-033 in doc
- Add 2 new TLV tags: AUTHORITY_CONFIG (0x0110), DOMAIN_PROFILE (0x0111)
- Re-export new types from lib.rs
- Update rvf-runtime tests for tightened validation
- All 222 rvf-types + all rvf-runtime tests pass

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 19:10:00 +00:00
Claude
ec09c05309 docs(adr-036): AGI cognitive container with Claude Code orchestration 
Defines the full system boundary for portable intelligence:
- RuVector as existential substrate (world model, coherence signals)
- RVF as cognitive container format (packaging, witness chains, replay)
- Claude Code as control plane orchestrator (planning, tool use)
- Claude Flow as swarm coordinator (routing, shared memory, learning)

Key mechanisms:
- Structural health gates (min-cut coherence, contradiction pressure)
- Skill promotion with counterexample requirements
- Two execution modes: Replay (bit-identical) and Verify (same grades)
- 10 node types, 9 edge types, 4 invariants for the world model schema
- MCP tools: ruvector_query, ruvector_cypher, rvf_snapshot, eval_run

Acceptance test: same RVF artifact, two machines, 100 tasks,
95+ passing in verify mode, zero policy violations.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 18:41:08 +00:00
Claude
45b6ff5734 feat(adr-035): capability report — witness bundles, scorecards, governance 
Proof infrastructure for repeatable capability evidence:

- WitnessHeader: 64-byte repr(C) header with task ID, policy hash,
  outcome, governance mode, cost/latency/tokens, HMAC-SHA256 signature
- WitnessBuilder: fluent API to record tool calls, enforce governance
  policy (restricted/approved/autonomous), and build signed bundles
- ParsedWitness: zero-copy parser with verify_all(), parse_trace(),
  evidence_complete() checks
- GovernancePolicy: three enforcement modes with deny/allow lists,
  cost caps, tool call budgets, and deterministic policy hashing
- ScorecardBuilder: aggregate bundles into solve rate, cost/solve,
  median/p95 latency, evidence coverage, policy violations
- ToolCallEntry: per-call trace with hashed args/results, latency,
  cost, tokens, and policy check result

Acceptance criteria from ADR-035:
- solve_rate >= 0.60, policy_violations == 0, evidence_coverage == 1.0

Test counts:
- rvf-types witness: 10 unit tests
- rvf-runtime witness: 14 unit tests
- witness_e2e: 10 integration tests
- Total across all RVF crates: 451 tests passing

Zero external dependencies. Real HMAC-SHA256 signatures.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 18:22:15 +00:00
Claude
260d96cd30 feat(adr-034): zero-dep QR cognitive seed with real crypto and mobile FFI 
Complete the QR Cognitive Seed pipeline with zero external dependencies:

- Pure SHA-256 (FIPS 180-4) verified against NIST test vectors
- HMAC-SHA256 (RFC 2104) verified against RFC 4231 test cases
- LZ77 compression (SCF-1 format) with 4KB sliding window
- Seed crypto: content hashing, signing, layer verification
- C FFI (5 extern "C" functions) for App Clip / mobile integration
- SeedBuilder.build_and_sign() with automatic hashing and signing
- ParsedSeed.verify_all() with full integrity and signature checks
- ParsedSeed.decompress_microkernel() using built-in LZ
- 11 end-to-end integration tests with real cryptography
- Updated ADR-034 with App Clip, PWA, Android delivery paths
- Example updated with full real-crypto round-trip demo

Total: 381 tests passing (183 types + 154 runtime + 11 e2e + 33 manifest)

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 17:54:26 +00:00
Claude
eef3fc21a1 feat(adr-034): QR Cognitive Seed — a world inside a world 
Implement ADR-034: RVQS binary format for embedding intelligence
in a single QR code (≤2,953 bytes). Scan printed ink to mount a
portable brain with progressive download to full intelligence.

New types (rvf-types/qr_seed.rs):
- SeedHeader (64 bytes, compile-time assertion)
- HostEntry, LayerEntry (28 bytes), 8 seed flag constants
- 8 TLV tag constants, well-known layer identifiers
- Round-trip serialization, 9 unit tests

New runtime (rvf-runtime/qr_seed.rs):
- SeedBuilder: fluent API for constructing RVQS payloads
- ParsedSeed: zero-copy parser with manifest TLV decoding
- DownloadManifest: structured host/layer/token parsing
- BootstrapProgress: phase tracking with recall estimation
- QR capacity enforcement, 12 unit tests

Example (qr_seed_bootstrap.rs):
- Full demo: build → parse → manifest → progressive bootstrap
- Shows 2,724-byte seed with 229 bytes headroom

All 399 tests pass (172 types + 160 runtime + 33 manifest + 34 integration).

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 17:13:01 +00:00
Claude
933e4495ef harden(adr-033): QualityEnvelope, triple budget caps, selective scan, fuzz benchmark 
- QualityEnvelope as mandatory outer return type (not nestable, not droppable)
- SearchEvidenceSummary, BudgetReport, DegradationReport structs
- QualityPreference enum (Auto/PreferQuality/PreferLatency/AcceptDegraded)
- Triple budget caps: max_scan_time_us, max_scan_candidates, max_distance_ops
- Selective safety net: multi-centroid union + HNSW neighbor expansion + recency
- DoS hardening: budget tokens, negative caching, proof-of-work option
- Three mandatory acceptance tests: schema enforcement, budget cap enforcement,
  graceful degradation under degenerate conditions
- Fuzz benchmark: 4000 queries across 4 classes must respect p95 ceiling and
  preserve monotonic recall improvement across progressive load stages

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 16:00:16 +00:00
Claude
2384087f6c fix(adr-033): extend ResultQuality to API boundary, cap brute-force, add malicious manifest test 
Three fixes to ADR-033:

1. ResultQuality split into RetrievalQuality (per-candidate) and
   ResponseQuality (per-response at API boundary). ResponseQuality
   survives serialization across JSON/gRPC/MCP. DegradationReason
   provides structured, inspectable evidence for why quality dropped.

2. Brute-force safety net dual-budgeted: max 5ms wall-clock AND max
   50K candidates, whichever hits first. Both configurable via
   QueryOptions. Budget=0 disables fallback entirely. Prevents O(N)
   DoS from adversarial queries on large hot caches.

3. Mandatory acceptance test: malicious tail manifest with valid CRC
   but redirected hotset pointers must fail deterministically under
   Strict policy with a logged, stable error code. Separate test for
   re-signed forgery (wrong signer vs no signature distinction).

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 15:54:39 +00:00
Claude
718f5c00d1 docs(adr): ADR-033 progressive indexing hardening 
Addresses four structural weaknesses in the progressive indexing system:

1. Content-addressed centroid stability — hotset pointers verified by
   SHAKE-256 content hashes, not just byte offsets. Compaction becomes
   physically destructive but logically stable.

2. Adversarial distribution resilience — distance entropy detection
   with adaptive n_probe widening. Silent recall collapse replaced by
   detected degradation with ResultQuality signaling.

3. Honest recall framing — empirical targets scoped to distribution
   classes (natural/synthetic/adversarial). Monotonic recall improvement
   property proven from append-only invariant. Brute-force safety net
   when candidate count is insufficient.

4. Mandatory manifest signatures — SecurityPolicy defaults to Strict.
   No signature = no mount in production. Prevents segment-swap attacks
   on hotset pointers. CRC32C catches corruption; ML-DSA-65 catches
   adversaries.

https://claude.ai/code/session_01RnwD4x5cbpB7FPvoyYQz8G
 2026-02-15 15:50:17 +00:00