rUv
|
a10f527566
|
docs: update CLAUDE.md with RuVector hooks config, add hooks to npm README
- Update CLAUDE.md to reflect actual hooks configuration from settings.json
- Document all 7 hook event types (PreToolUse, PostToolUse, SessionStart, etc.)
- Add RuVector environment variables documentation
- Update agent coordination protocol to use ruvector hooks CLI
- Add self-learning hooks section to npm ruvector README
- Bump ruvector to v0.1.38 with hooks documentation
- Fix sync-lockfile.sh to handle platform-specific optional deps
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
|
2025-12-29 22:31:11 +00:00 |
|
Claude
|
ebf06be2d8
|
Merge origin/main into claude/implement-hooks-docs-FXQ35
Resolves merge conflicts in .claude/intelligence/data/ files by keeping
feature branch changes (auto-generated learning data).
Brings in new features from main:
- ruvector-nervous-system crate (HDC, Hopfield, plasticity)
- Dendritic computation modules
- Event bus implementation
- Pattern separation algorithms
- Workspace routing
|
2025-12-28 20:39:25 +00:00 |
|
rUv
|
e3cef7d5f1
|
Feat/ruvector postgres v2 (#82)
* feat(postgres): Add RuVector Postgres v2 implementation plan
Complete specification for RuVector Postgres v2 with:
Architecture:
- PostgreSQL extension (pgrx) with hybrid architecture
- SQL handles ACID/joins, RuVector engine handles vectors/graphs/learning
- Backward compatible with pgvector SQL surface
- Shared memory IPC with bounded contracts (64KB inline, 16MB shared)
4-Phase Implementation:
- Phase 1: pgvector-compatible search (1a: function-based, 1b: Index AM)
- Phase 2: Tiered storage with compression and exactness GUC
- Phase 3: Graph engine with Cypher and SQL join keys
- Phase 4: Dynamic mincut integrity gating (key differentiator)
Key Technical Details:
- lambda_cut: Minimum cut value via Stoer-Wagner (PRIMARY integrity metric)
- lambda2: Algebraic connectivity (OPTIONAL drift signal) - DIFFERENT from mincut!
- Contracted operational graph (~1000 nodes) - never compute on full similarity graph
- Hysteresis model with consecutive samples and cooldown
- Operation risk classification (Low/Medium/High)
- MVCC visibility with incremental paging API
- WAL replay with idempotency and LSN ordering
- Partition map versioning and epoch fencing for cluster mode
Files:
- 00-overview.md: Architecture, consistency contract, benchmark spec
- 01-sql-schema.md: SQL schema and types
- 02-background-workers.md: IPC contract, mincut worker
- 03-index-access-methods.md: Index AM specification
- 04-integrity-events.md: Events, hysteresis, operation classes
- 05-phase1-pgvector-compat.md: Phase 1a/1b incremental path
- 06-phase2-tiered-storage.md: Tiered storage with GUC exactness
- 07-phase3-graph-cypher.md: Graph engine with SQL joins
- 08-phase4-integrity-control.md: Mincut gating with Stoer-Wagner
- 09-migration-guide.md: Migration from pgvector
- 10-consistency-replication.md: Consistency and replication model
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs(postgres): Rewrite v2 overview with compelling framing
Replace technical executive summary with clear explanation of why
RuVector matters:
- From symptom monitoring to causal monitoring
- Mincut as leading indicator, not metric
- Algorithm becomes control signal (control plane, not analytics)
- Failure mode class change: cascading → graceful degradation
- Explainable operations via witness edges
Key message: "We're not making vector search faster.
We're making vector infrastructure survivable."
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(postgres): Add hybrid search, multi-tenancy, and self-healing specs
Three high-impact additions to RuVector Postgres v2:
## 11-hybrid-search.md - BM25 + Vector Fusion
- Single query combines semantic and keyword search
- Proper BM25 implementation (not just ts_rank)
- Fusion algorithms: RRF (default), linear, learned
- Integrity-aware degradation (stress → single branch)
- Parallel branch execution
- GUC configuration
## 12-multi-tenancy.md - First-Class Tenant Isolation
- SET ruvector.tenant_id for transparent scoping
- Isolation levels: shared, partition, dedicated
- Automatic promotion based on vector count
- Per-tenant integrity (stress in one doesn't affect others)
- Per-tenant contracted graphs
- Resource quotas and rate limiting
- Fair scheduling (no noisy neighbors)
- RLS integration for defense in depth
## 13-self-healing.md - Automated Remediation
- Completes the control loop: sensor → actuator
- Problem classification from witness edges:
- Hotspot congestion
- Centroid skew
- Replication lag
- Maintenance contention
- Index fragmentation
- Memory pressure
- Built-in strategies:
- Rebalance partitions
- Pause maintenance jobs
- Throttle ingestion
- Scale read replicas (K8s)
- Compact fragmented indexes
- Safety: reversible actions, blast radius limits
- Learning: outcome tracking, strategy weight updates
- The key insight: "We built the sensor. Now we build the actuator."
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(intelligence): Add self-learning intelligence layer with v3 features
Comprehensive intelligence system for Claude Code hooks:
Core Features (v2):
- VectorMemory with @ruvector/core native HNSW (150x faster)
- Hyperbolic distance (Poincaré ball) for hierarchical embeddings
- ReasoningBank with Q-learning and pattern decay (7-day half-life)
- Confidence Calibration tracking (predicted vs actual accuracy)
- A/B Testing with 10% holdout for measuring intelligence lift
- Feedback Loop for tracking suggestion follow-through
- Active Learning for identifying uncertain states
v3 Improvements:
- Error Pattern Learning (Rust E0xxx, TypeScript TSxxxx, npm errors)
- File Sequence Learning (tracks which files are edited together)
- Test Suggestion Triggers (suggests cargo test after source edits)
- Hive-Mind swarm coordination (11 agents, 38 edges)
Pretrained from memory.db:
- 7,697 commands processed
- 4,023 vector memories
- 117 Q-table states with decay metadata
- 8,520 calibration samples
Anti-overfitting measures:
- Q-values capped at 0.8, floored at -0.5
- Decaying learning rate: 0.3/sqrt(count)
- Pattern decay with timestamps
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(intelligence): Fix Q-table lookups - learning now has real effect
Three critical bugs were preventing the intelligence layer from using
learned patterns:
1. State format mismatch: CLI used spaces ("editing rs in project")
but Q-table used underscores ("edit_rs_in_project")
- Fixed in cli.js: all states now use underscore format
2. stateKey() hyphen normalization: Function converted hyphens to
underscores, but Q-table keys had hyphens (e.g. "ruvector-core")
- Fixed regex: /[^a-z0-9-]+/g preserves hyphens
3. A/B testing control group: 10% random sessions ignored learning
- Reduced holdout to 5% with persistent session assignment
- Added INTELLIGENCE_MODE=treatment env override for development
Result: Agent recommendations now show 80% confidence for Rust files
using learned Q-values, instead of 0% with random selection.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(hooks): Display intelligence guidance to Claude in foreground
Critical fix: PreToolUse hooks were running in background (&) which
meant Claude never saw the intelligence output. Now:
- PreToolUse: Foreground execution (Claude sees guidance)
- pre-edit: Shows recommended agent + confidence + similar edits
- pre-command: Shows command patterns + suggestions
- Added 3s timeout to prevent blocking
- PostToolUse: Background execution (async learning)
- post-edit: Records success/failure, learns patterns
- post-command: Captures errors, updates Q-values
- SessionStart: New hook shows learned patterns at session start
- Displays pattern count, memory stats
- Shows top 3 learned state-action pairs with Q-values
Claude now receives self-learning guidance like:
"🧠 Intelligence Analysis:
📁 ruvector-core/lib.rs
🤖 Recommended: rust-developer (80% confidence)
📚 3 similar past edits found"
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
|
2025-12-25 17:02:55 -05:00 |
|