mirror of
https://github.com/ruvnet/ruflo.git
synced 2026-10-23 03:47:00 +09:00
feat: Ruflo v3.5.0 — first major stable release with full agentic-flow integration
Rebranding from Claude Flow to Ruflo. Includes: - agentic-flow v3.0.0-alpha.1 deep integration (10 subpath exports) - AgentDB v3.0.0-alpha.9 with 8 controllers + 6 MCP tools - Unified agentic-flow bridge with tiered embedding resolution - Security hardening (command injection fix, TOCTOU race fix) - Doctor health check for agentic-flow - 22 agent/skill files updated to v3.0.0-alpha.1 - ADR-054, ADR-055, ADR-056 - Comprehensive CHANGELOG from 5,800+ commits - All 3 packages bumped to 3.5.0 Co-Authored-By: claude-flow <ruv@ruv.net>
This commit is contained in:
rUv committed
1 parent
6bad28b50b
commit
4603300368
56 files changed
+2598
-897
No files matched your search
@@ -536,8 +536,71 @@ function progressBar(current, total) {
|
||||
return '[' + '\u25CF'.repeat(filled) + '\u25CB'.repeat(width - filled) + ']';
|
||||
}
|
||||
|
||||
// Single-line statusline for Claude Code's status bar
|
||||
function generateStatusline() {
|
||||
// Collect all data (mostly pure Node.js, one git exec)
|
||||
const git = getGitInfo();
|
||||
const modelName = getModelName();
|
||||
const swarm = getSwarmStatus();
|
||||
const system = getSystemMetrics();
|
||||
const session = getSessionStats();
|
||||
const hooks = getHooksStatus();
|
||||
const integration = getIntegrationStatus();
|
||||
|
||||
const parts = [];
|
||||
|
||||
// Branding
|
||||
parts.push(`${c.bold}${c.brightPurple}\u258A Claude Flow V3${c.reset}`);
|
||||
|
||||
// User + swarm indicator
|
||||
const dot = swarm.coordinationActive ? `${c.brightGreen}\u25CF${c.reset}` : `${c.brightCyan}\u25CF${c.reset}`;
|
||||
parts.push(`${dot} ${c.brightCyan}${git.name}${c.reset}`);
|
||||
|
||||
// Git branch + changes
|
||||
if (git.gitBranch) {
|
||||
let branchPart = `${c.brightBlue}\u23C7 ${git.gitBranch}${c.reset}`;
|
||||
const changes = [];
|
||||
if (git.staged > 0) changes.push(`${c.brightGreen}+${git.staged}${c.reset}`);
|
||||
if (git.modified > 0) changes.push(`${c.brightYellow}~${git.modified}${c.reset}`);
|
||||
if (git.untracked > 0) changes.push(`${c.dim}?${git.untracked}${c.reset}`);
|
||||
if (changes.length > 0) branchPart += ` ${changes.join('')}`;
|
||||
if (git.ahead > 0) branchPart += ` ${c.brightGreen}\u2191${git.ahead}${c.reset}`;
|
||||
if (git.behind > 0) branchPart += ` ${c.brightRed}\u2193${git.behind}${c.reset}`;
|
||||
parts.push(branchPart);
|
||||
}
|
||||
|
||||
// Model
|
||||
parts.push(`${c.purple}${modelName}${c.reset}`);
|
||||
|
||||
// Session duration
|
||||
if (session.duration) {
|
||||
parts.push(`${c.cyan}\u23F1 ${session.duration}${c.reset}`);
|
||||
}
|
||||
|
||||
// Intelligence %
|
||||
const intellColor = system.intelligencePct >= 80 ? c.brightGreen : system.intelligencePct >= 40 ? c.brightYellow : c.dim;
|
||||
parts.push(`${intellColor}\u25CF ${system.intelligencePct}%${c.reset}`);
|
||||
|
||||
// Swarm agents (only if active)
|
||||
if (swarm.activeAgents > 0 || swarm.coordinationActive) {
|
||||
parts.push(`${c.brightYellow}\u25C9 ${swarm.activeAgents}/${swarm.maxAgents}${c.reset}`);
|
||||
}
|
||||
|
||||
// Hooks (compact)
|
||||
if (hooks.enabled > 0) {
|
||||
parts.push(`${c.brightGreen}\u2713${hooks.enabled}h${c.reset}`);
|
||||
}
|
||||
|
||||
// MCP (compact)
|
||||
if (integration.mcpServers.total > 0) {
|
||||
const mcpCol = integration.mcpServers.enabled === integration.mcpServers.total ? c.brightGreen : c.brightYellow;
|
||||
parts.push(`${mcpCol}MCP${integration.mcpServers.enabled}${c.reset}`);
|
||||
}
|
||||
|
||||
return parts.join(` ${c.dim}\u2502${c.reset} `);
|
||||
}
|
||||
|
||||
// Multi-line dashboard (for --dashboard flag)
|
||||
function generateDashboard() {
|
||||
const git = getGitInfo();
|
||||
const modelName = getModelName();
|
||||
const progress = getV3Progress();
|
||||
@@ -671,6 +734,9 @@ if (process.argv.includes('--json')) {
|
||||
console.log(JSON.stringify(generateJSON(), null, 2));
|
||||
} else if (process.argv.includes('--compact')) {
|
||||
console.log(JSON.stringify(generateJSON()));
|
||||
} else {
|
||||
} else if (process.argv.includes('--single-line')) {
|
||||
console.log(generateStatusline());
|
||||
} else {
|
||||
// Default: multi-line dashboard
|
||||
console.log(generateDashboard());
|
||||
}
|
||||
+220
-20
@@ -1,35 +1,235 @@
|
||||
# Changelog
|
||||
|
||||
All notable changes to this project will be documented in this file.
|
||||
All notable changes to the Ruflo project (formerly Claude Flow) are documented here.
|
||||
|
||||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [3.0.0-alpha.154] - 2026-01-22
|
||||
## [3.5.0] - 2026-02-27
|
||||
|
||||
### Fixed
|
||||
- Memory delete command now properly supports `--key` and `--namespace` options (#980)
|
||||
- Added missing 'type' column to memory schema migration (#977)
|
||||
- Updated pnpm-lock.yaml for @claude-flow/browser dependencies
|
||||
### Ruflo v3.5 — First Major Stable Release
|
||||
|
||||
## [3.0.0-alpha.153] - 2026-01-22
|
||||
This release marks the official rebranding from **Claude Flow** to **Ruflo** and represents the first major stable release after 5,800+ commits, 55 alpha iterations, and 10 months of development.
|
||||
|
||||
### Fixed
|
||||
- Added missing 'type' column to ensureSchemaColumns() for older databases
|
||||
### Highlights
|
||||
|
||||
## [3.0.0-alpha.152] - 2026-01-22
|
||||
- **Rebranding**: Claude Flow → Ruflo across all packages (`@claude-flow/cli`, `claude-flow`, `ruflo`)
|
||||
- **agentic-flow v3.0.0-alpha.1 Integration**: Full deep integration with 10 subpath exports (ReasoningBank, Router, Orchestration, Agent Booster, SDK, Security, QUIC transport)
|
||||
- **AgentDB v3.0.0-alpha.9**: 8 new controllers (HierarchicalMemory, MemoryConsolidation, SemanticRouter, GNNService, RVFOptimizer, MutationGuard, AttestationLog, GuardedVectorBackend) + 6 MCP tools
|
||||
- **215 MCP Tools**: Full Model Context Protocol server with vector memory, neural training, swarm coordination
|
||||
- **Security Hardening**: Command injection fix, TOCTOU race fix, eliminated hardcoded HMAC keys, timing attack fixes
|
||||
- **Doctor Health Check**: New `agentic-flow` diagnostic (filesystem-based, ESM-compatible)
|
||||
- **0 Production Vulnerabilities**: Clean `npm audit` across all packages
|
||||
|
||||
### Added
|
||||
- V3 CLI with 26 commands and 140+ subcommands
|
||||
- Domain-Driven Design architecture with 15 @claude-flow modules
|
||||
- HNSW-indexed vector search (150x-12,500x faster)
|
||||
- RuVector Intelligence System (SONA, MoE, Flash Attention)
|
||||
- 60+ agent types for swarm coordination
|
||||
- Queen-led Byzantine fault-tolerant consensus
|
||||
- 17 hooks + 12 background workers
|
||||
|
||||
- `agentic-flow-bridge.ts` — Unified lazy-loading bridge for all agentic-flow v3 modules
|
||||
- Tiered embedding resolution: ReasoningBank WASM (Tier 1) → @claude-flow/embeddings (Tier 2) → mock fallback (Tier 3)
|
||||
- Agent Booster local import with npx fallback
|
||||
- `checkAgenticFlow()` doctor health check
|
||||
- 7 TypeScript module declarations for agentic-flow subpath exports
|
||||
- ADR-056: agentic-flow v3 Integration Architecture
|
||||
|
||||
### Fixed
|
||||
|
||||
- Command injection vulnerability in enhanced-model-router.ts (SAFE_LANGUAGES whitelist)
|
||||
- TOCTOU race condition in bridge singleton initialization (Promise-based caching)
|
||||
- 22 agent/skill files updated from stale v1.5.11/v2.0.0-alpha to v3.0.0-alpha.1
|
||||
- ESM compatibility for doctor checks (filesystem-based instead of `require.resolve`)
|
||||
- @ruvector/gnn pinned to 0.1.25 to fix fatal process crash (issue #216)
|
||||
|
||||
### Changed
|
||||
- Restructured as monorepo with pnpm workspaces
|
||||
- Moved CLI to @claude-flow/cli package
|
||||
|
||||
For earlier versions, see the git history.
|
||||
- All 3 packages bumped from `3.1.0-alpha.55` to `3.5.0`
|
||||
- Publish tags changed from `alpha`/`v3alpha` to `latest`
|
||||
- agentic-flow minimum version: `0.1.0` → `3.0.0-alpha.1`
|
||||
- agentdb minimum version: `2.0.0-alpha.3.4` → `3.0.0-alpha.10`
|
||||
|
||||
---
|
||||
|
||||
## [3.1.0-alpha.55] - 2026-02-27
|
||||
|
||||
### AgentDB 3.0.0-alpha.9 Integration (ADR-053/ADR-055)
|
||||
|
||||
- Activated 8 AgentDB v3 controllers with MutationGuard proof engine
|
||||
- Added 6 new MCP tools: `agentdb_hierarchical_*`, `agentdb_consolidation_*`, `agentdb_semantic_*`
|
||||
- Fixed controller registry activation bugs (ADR-055)
|
||||
- Statusline fixes for real-time controller status
|
||||
- Pinned @ruvector/gnn@0.1.25 to fix fatal process crash
|
||||
|
||||
## [3.1.0-alpha.43] - 2026-02-15
|
||||
|
||||
### Ruflo Branding Fix
|
||||
|
||||
- Fixed CLI branding: show 'ruflo' instead of 'claude-flow' when run via `npx ruflo`
|
||||
- Fixed Windows ESM import crash with `pathToFileURL`
|
||||
- Fixed init hook prompt overflow and description field
|
||||
|
||||
## [3.1.0-alpha.36] - 2026-02-10
|
||||
|
||||
### Stability & Compatibility
|
||||
|
||||
- Fixed hooks backward compatibility: `--success` and `--file` made optional
|
||||
- Fixed Windows npm install crash (404 optional dependencies)
|
||||
- Bumped agentdb to 2.0.0-alpha.3.6
|
||||
- Fixed V3 build errors (missing helmet, VERSION type, vitest spy)
|
||||
|
||||
## [3.1.0-alpha.29] - 2026-02-01
|
||||
|
||||
### Security & Agent Teams
|
||||
|
||||
- Security fixes, backward compatibility, and Agent Teams hooks
|
||||
- Added `--settings` flag to upgrade command for Agent Teams
|
||||
- Fixed npm 11 install crash by pinning agentdb
|
||||
|
||||
---
|
||||
|
||||
## v3.0.0-alpha Series (2025-10 to 2026-02)
|
||||
|
||||
### v3.0.0-alpha.184 — CLI Help & Categorization (2025-12)
|
||||
|
||||
- Fixed CLI help categorization across 26 commands
|
||||
- Published install optimizations
|
||||
- curl-style installer script
|
||||
- SEO-optimized npm packages for discovery
|
||||
|
||||
### v3.0.0-alpha.170 — Plugins & Marketplace (2025-12)
|
||||
|
||||
- **Plugin Marketplace**: 8 official plugins + IPFS registry via Pinata
|
||||
- **Gas Town Bridge Plugin**: WASM-accelerated orchestrator integration
|
||||
- **10 RuVector WASM Plugins**: 50 MCP tools for neural computation
|
||||
- **@claude-flow/teammate-plugin**: MCP tools for Agent Teams coordination
|
||||
|
||||
### v3.0.0-alpha.150 — SONA & SemanticRouter (2025-11)
|
||||
|
||||
- **SemanticRouter**: SONA WASM integration with verified benchmarks
|
||||
- Fixed phantom Claude popups on Windows
|
||||
- Fixed statusline safe multi-line output for Claude Desktop
|
||||
- Fixed MCP tool naming (`/` → `_`) for Claude Desktop compatibility
|
||||
- Memory namespace support in delete command
|
||||
|
||||
### v3.0.0-alpha.100 — @claude-flow/guidance (2025-11)
|
||||
|
||||
- **@claude-flow/guidance Control Plane**: Governance, compliance, and policy enforcement
|
||||
- Wave 1: Proof, gateway, memory-gate, coherence, hooks, persistence primitives
|
||||
- Wave 2: Conformance kit, capability algebra, evolution pipeline, artifact ledger
|
||||
- Wave 3: Civilization-grade primitives (trust, truth, uncertainty, time, authority)
|
||||
- **Rust WASM Policy Kernel**: SIMD128-accelerated policy evaluation
|
||||
- **ContinueGate**: Safety gate for agent continuation decisions
|
||||
- 22-benchmark suite with before/after performance reporting
|
||||
- CLAUDE.md generators, analyzer, and auto-optimizer
|
||||
- Content-aware executor with statistical validation (Spearman ρ, Cohen's d)
|
||||
|
||||
### v3.0.0-alpha.50 — Core V3 Implementation (2025-10)
|
||||
|
||||
- Complete V3 implementation across all ADRs
|
||||
- ADR-003: Coordinator consolidation + security tests
|
||||
- Complete hooks system with AgentDB, HNSW, tests
|
||||
- ReasoningBank guidance system with CLI
|
||||
- V2→V3 migration documentation
|
||||
- MCP memory tools upgraded to sql.js + HNSW backend
|
||||
- Claims-based authorization (ADR-016)
|
||||
- Node.js worker daemon system
|
||||
- Auto-update system for @claude-flow packages (ADR-025)
|
||||
- Replaced all mock implementations with real functionality
|
||||
|
||||
### v3.0.0-alpha.1 — Foundation (2025-10)
|
||||
|
||||
- Complete V3 monorepo structure (`@claude-flow/cli`, `shared`, `memory`, `hooks`, `security`)
|
||||
- 26 CLI commands with 140+ subcommands
|
||||
- 215 MCP tools via FastMCP 3.x
|
||||
- RuVector intelligence system (SONA, MoE, HNSW, EWC++, Flash Attention)
|
||||
- Hive-Mind consensus (Byzantine, Raft, Gossip, CRDT, Quorum)
|
||||
- 17 hooks + 12 background workers
|
||||
- 60+ specialized agent types
|
||||
- Cross-platform helper system
|
||||
|
||||
---
|
||||
|
||||
## v2.7.x Series (2025-08 to 2025-10)
|
||||
|
||||
### v2.7.34 — PostgreSQL & Neural Persistence
|
||||
|
||||
- PostgreSQL Bridge with attention, GNN, hyperbolic embeddings
|
||||
- Neural pattern persistence to disk
|
||||
- Hive-mind `--claude` flag for spawn command
|
||||
- Real statusline data, hive-mind shutdown fixes, daemon persistence
|
||||
- Multi-platform builds (Linux, macOS, Windows) in CI/CD
|
||||
|
||||
### v2.7.0 — agentic-flow Integration
|
||||
|
||||
- Deep integration with agentic-flow coordination engine
|
||||
- SDK architecture analysis and hooks & learning integration
|
||||
- Modular installation strategy
|
||||
- Optimized v3 migration plan
|
||||
|
||||
---
|
||||
|
||||
## v2.0.0-alpha Series (2025-05 to 2025-08)
|
||||
|
||||
### v2.0.0-alpha.128 — Maturity
|
||||
|
||||
- Comprehensive hive-mind optimization
|
||||
- Database schema robustness (missing columns, optimization errors)
|
||||
- Auto-rebuild better-sqlite3 on NODE_MODULE_VERSION mismatch
|
||||
- InMemoryStore interval cleanup for clean process exit
|
||||
|
||||
### v2.0.0-alpha.53 — Hook Safety
|
||||
|
||||
- Critical hook safety system
|
||||
- Hive-mind optimization command
|
||||
- Safety & security features documentation
|
||||
- Neural Link System with safety protocols
|
||||
|
||||
### v2.0.0-alpha.33 — Windows & WSL
|
||||
|
||||
- Windows/WSL compatibility fixes
|
||||
- Module import error resolution
|
||||
- README restructure for v2.0.0 features
|
||||
- Comprehensive test suite
|
||||
|
||||
---
|
||||
|
||||
## v1.x Series (2025-01 to 2025-05)
|
||||
|
||||
### v1.0.71 — Final v1 Release
|
||||
|
||||
- npm publishing compatibility
|
||||
- Full CLI command functionality
|
||||
- SPARC integration with full prompt loading
|
||||
- Cross-platform support
|
||||
|
||||
### v1.0.50 — Swarm & SPARC
|
||||
|
||||
- Parallel execution for swarm tasks
|
||||
- Background task management
|
||||
- Swarm command with improved error handling
|
||||
- Claude Code slash commands integration
|
||||
|
||||
### v1.0.28 — Project Management
|
||||
|
||||
- CLI project management commands
|
||||
- System monitoring and SPARC commands
|
||||
- Orchestration templates (monitoring, optimization, security review)
|
||||
|
||||
### v1.0.1 — Initial Release (2025-01-01)
|
||||
|
||||
- Complete Claude-Flow AI Agent Orchestration System
|
||||
- Configuration guide and comprehensive tests
|
||||
- Initial commit
|
||||
|
||||
---
|
||||
|
||||
## Milestone Summary
|
||||
|
||||
| Milestone | Version | Date | Key Feature |
|
||||
|-----------|---------|------|-------------|
|
||||
| Initial Release | v1.0.1 | 2025-01 | AI agent orchestration system |
|
||||
| SPARC Integration | v1.0.50 | 2025-03 | Swarm + SPARC methodology |
|
||||
| Alpha Foundation | v2.0.0-alpha.33 | 2025-05 | V2 alpha with hook safety |
|
||||
| agentic-flow | v2.7.0 | 2025-08 | agentic-flow coordination engine |
|
||||
| V3 Foundation | v3.0.0-alpha.1 | 2025-10 | V3 monorepo, 215 MCP tools |
|
||||
| Plugin Marketplace | v3.0.0-alpha.170 | 2025-12 | 8 plugins + IPFS registry |
|
||||
| Guidance Control Plane | v3.0.0-alpha.100 | 2026-01 | WASM policy kernel, ContinueGate |
|
||||
| AgentDB v3 | v3.1.0-alpha.55 | 2026-02 | 8 controllers, MutationGuard |
|
||||
| **Ruflo v3.5** | **v3.5.0** | **2026-02-27** | **First stable release, rebranding** |
|
||||
@@ -1,4 +1,8 @@
|
||||
# Claude Code Configuration - Claude Flow V3
|
||||
# Claude Code Configuration - Ruflo v3.5
|
||||
|
||||
> **Ruflo v3.5** (2026-02-27) — First major stable release. Formerly "Claude Flow".
|
||||
> 5,800+ commits, 55 alpha iterations, 215 MCP tools, 60+ agents, 8 AgentDB controllers.
|
||||
> Packages: `@claude-flow/cli@3.5.0`, `claude-flow@3.5.0`, `ruflo@3.5.0`
|
||||
|
||||
## Behavioral Rules (Always Enforced)
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
<div align="center">
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -124,27 +124,24 @@ flowchart TB
|
||||
style RESOURCES fill:#1a1a2e,stroke:#0f3460
|
||||
```
|
||||
|
||||
**RuVector Components** (`npx ruvector`):
|
||||
**RuVector Components** (included with Ruflo):
|
||||
|
||||
| Component | Purpose | Performance |
|
||||
|-----------|---------|-------------|
|
||||
| **SONA** | Self-Optimizing Neural Architecture - learns optimal routing | <0.05ms adaptation |
|
||||
| **EWC++** | Elastic Weight Consolidation - prevents catastrophic forgetting | Preserves 95%+ knowledge |
|
||||
| **Flash Attention** | Optimized attention computation | 2.49x-7.47x speedup |
|
||||
| **HNSW** | Hierarchical Navigable Small World vector search | 150x-12,500x faster |
|
||||
| **SONA** | Self-Optimizing Neural Architecture - learns optimal routing | Fast adaptation |
|
||||
| **EWC++** | Elastic Weight Consolidation - prevents catastrophic forgetting | Preserves learned patterns |
|
||||
| **Flash Attention** | Optimized attention computation | 2-7x speedup |
|
||||
| **HNSW** | Hierarchical Navigable Small World vector search | Sub-millisecond retrieval |
|
||||
| **ReasoningBank** | Pattern storage with trajectory learning | RETRIEVE→JUDGE→DISTILL |
|
||||
| **Hyperbolic** | Poincaré ball embeddings for hierarchical data | Better code relationships |
|
||||
| **LoRA/MicroLoRA** | Low-Rank Adaptation for efficient fine-tuning | **<3μs** adaptation, 383k ops/sec |
|
||||
| **Int8 Quantization** | Memory-efficient weight storage | 3.92x memory reduction |
|
||||
| **SemanticRouter** | Semantic task routing with cosine similarity | **34,798 routes/s**, 0.029ms |
|
||||
| **Hyperbolic** | Poincare ball embeddings for hierarchical data | Better code relationships |
|
||||
| **LoRA/MicroLoRA** | Low-Rank Adaptation for efficient fine-tuning | Lightweight adaptation |
|
||||
| **Int8 Quantization** | Memory-efficient weight storage | ~4x memory reduction |
|
||||
| **SemanticRouter** | Semantic task routing with cosine similarity | Fast intent routing |
|
||||
| **9 RL Algorithms** | Q-Learning, SARSA, A2C, PPO, DQN, Decision Transformer, etc. | Task-specific learning |
|
||||
|
||||
```bash
|
||||
# Install RuVector standalone
|
||||
npx ruvector
|
||||
|
||||
# Or use via Ruflo
|
||||
npx ruflo@v3alpha hooks intelligence --status
|
||||
# Use RuVector via Ruflo
|
||||
npx ruflo@alpha hooks intelligence --status
|
||||
```
|
||||
|
||||
</details>
|
||||
@@ -214,7 +211,7 @@ Agents organize into swarms led by queens that coordinate work, prevent drift, a
|
||||
- 👷 **8 Worker Types**: Researcher, Coder, Analyst, Tester, Architect, Reviewer, Optimizer, Documenter
|
||||
- 🗳️ **3 Consensus Algorithms**: Majority, Weighted (Queen 3x), Byzantine (f < n/3)
|
||||
- 🧠 **Collective Memory**: Shared knowledge, LRU cache, SQLite persistence with WAL
|
||||
- ⚡ **Performance**: 10-20x faster batch spawning, 84.8% SWE-Bench solve rate
|
||||
- ⚡ **Performance**: Fast batch spawning with parallel agent coordination
|
||||
|
||||
</details>
|
||||
|
||||
@@ -225,7 +222,7 @@ The system stores successful patterns in vector memory, builds a knowledge graph
|
||||
|
||||
| Layer | Components | What It Does |
|
||||
|-------|------------|--------------|
|
||||
| Memory | HNSW, AgentDB, Cache | Stores and retrieves patterns 150x faster |
|
||||
| Memory | HNSW, AgentDB, Cache | Stores and retrieves patterns with fast HNSW search |
|
||||
| Knowledge Graph | MemoryGraph, PageRank, Communities | Identifies influential insights, detects clusters (ADR-049) |
|
||||
| Self-Learning | LearningBridge, SONA, ReasoningBank | Triggers learning from insights, confidence lifecycle (ADR-049) |
|
||||
| Agent Scopes | AgentMemoryScope, 3-scope dirs | Per-agent isolation + cross-agent knowledge transfer (ADR-049) |
|
||||
@@ -276,7 +273,7 @@ Smart routing skips expensive LLM calls when possible. Simple edits use WASM (fr
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>⚡ <strong>Agent Booster (WASM)</strong> — 352x faster code transforms, skip LLM entirely</summary>
|
||||
<summary>⚡ <strong>Agent Booster (WASM)</strong> — Skip LLM for simple code transforms</summary>
|
||||
|
||||
Agent Booster uses WebAssembly to handle simple code transformations without calling the LLM at all. When the hooks system detects a simple task, it routes directly to Agent Booster for instant results.
|
||||
|
||||
@@ -401,7 +398,7 @@ swarm_init({
|
||||
| **Coordination** | Manual orchestration between tasks | Queen-led hierarchy with 5 consensus algorithms (Raft, Byzantine, Gossip) |
|
||||
| **Hive Mind** | ⛔ Not available | 🐝 Queen-led swarms with collective intelligence, 3 queen types, 8 worker types |
|
||||
| **Consensus** | ⛔ No multi-agent decisions | Byzantine fault-tolerant voting (f < n/3), weighted, majority |
|
||||
| **Memory** | Session-only, no persistence | HNSW vector memory with 150x-12,500x faster retrieval + knowledge graph |
|
||||
| **Memory** | Session-only, no persistence | HNSW vector memory with sub-ms retrieval + knowledge graph |
|
||||
| **Vector Database** | ⛔ No native support | 🐘 RuVector PostgreSQL with 77+ SQL functions, ~61µs search, 16,400 QPS |
|
||||
| **Knowledge Graph** | ⛔ Flat insight lists | PageRank + community detection identifies influential insights (ADR-049) |
|
||||
| **Collective Memory** | ⛔ No shared knowledge | Shared knowledge base with LRU cache, SQLite persistence, 8 memory types |
|
||||
@@ -412,7 +409,7 @@ swarm_init({
|
||||
| **Background Workers** | Nothing runs automatically | 12 context-triggered workers auto-dispatch on file changes, patterns, sessions |
|
||||
| **LLM Provider** | Anthropic only | 6 providers with automatic failover and cost-based routing (85% savings) |
|
||||
| **Security** | Standard protections | CVE-hardened with bcrypt, input validation, path traversal prevention |
|
||||
| **Performance** | Baseline | 2.8-4.4x faster tasks, 10-20x faster swarm spawning, 84.8% SWE-Bench |
|
||||
| **Performance** | Baseline | Faster tasks via parallel swarm spawning and intelligent routing |
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -577,16 +574,16 @@ wait # Wait for all to complete
|
||||
|
||||
```bash
|
||||
# List collaboration templates
|
||||
npx ruflo-codex dual templates
|
||||
npx @claude-flow/codex dual templates
|
||||
|
||||
# Run feature development swarm (architect → coder → tester → reviewer)
|
||||
npx ruflo-codex dual run --template feature --task "Add user auth"
|
||||
npx @claude-flow/codex dual run --template feature --task "Add user auth"
|
||||
|
||||
# Run security audit swarm (scanner → analyzer → fixer)
|
||||
npx ruflo-codex dual run --template security --task "src/auth/"
|
||||
npx @claude-flow/codex dual run --template security --task "src/auth/"
|
||||
|
||||
# Run refactoring swarm (analyzer → planner → refactorer → validator)
|
||||
npx ruflo-codex dual run --template refactor --task "src/legacy/"
|
||||
npx @claude-flow/codex dual run --template refactor --task "src/legacy/"
|
||||
```
|
||||
|
||||
### Pre-Built Collaboration Templates
|
||||
@@ -650,7 +647,7 @@ The **Intelligence Loop** (ADR-050) automates this cycle through hooks. Each ses
|
||||
### Vector Search Details
|
||||
|
||||
- **Embedding Dimensions**: 384
|
||||
- **Search Algorithm**: HNSW (150x-12,500x faster)
|
||||
- **Search Algorithm**: HNSW (sub-millisecond)
|
||||
- **Similarity Scoring**: 0-1 (higher = better)
|
||||
- Score > 0.7: Strong match, use pattern
|
||||
- Score 0.5-0.7: Partial match, adapt
|
||||
@@ -701,7 +698,7 @@ claude mcp list
|
||||
Once added, Claude Code can use all 175+ ruflo MCP tools directly:
|
||||
- `swarm_init` - Initialize agent swarms
|
||||
- `agent_spawn` - Spawn specialized agents
|
||||
- `memory_search` - Search patterns with HNSW (150x faster)
|
||||
- `memory_search` - Search patterns with HNSW vector search
|
||||
- `hooks_route` - Intelligent task routing
|
||||
- And 170+ more tools...
|
||||
|
||||
@@ -728,13 +725,13 @@ Ruflo v3 introduces **self-learning neural capabilities** that no other agent or
|
||||
|
||||
| Feature | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus |
|
||||
|---------|----------------|--------|-----------|---------|-------|
|
||||
| **Vector Memory** | ✅ HNSW (150x faster) | ⛔ | Via plugins | ⛔ | ⛔ |
|
||||
| **Vector Memory** | ✅ HNSW (sub-ms search) | ⛔ | Via plugins | ⛔ | ⛔ |
|
||||
| **Knowledge Graph** | ✅ PageRank + communities | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Self-Learning Memory** | ✅ LearningBridge (SONA) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Agent-Scoped Memory** | ✅ 3-scope (project/local/user) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **PostgreSQL Vector DB** | ✅ RuVector (77+ SQL functions, ~61µs) | ⛔ | pgvector only | ⛔ | ⛔ |
|
||||
| **PostgreSQL Vector DB** | ✅ RuVector (77+ SQL functions) | ⛔ | pgvector only | ⛔ | ⛔ |
|
||||
| **Hyperbolic Embeddings** | ✅ Poincaré ball (native + SQL) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Quantization** | ✅ Int8 (3.92x savings) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Quantization** | ✅ Int8 (~4x savings) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Persistent Memory** | ✅ SQLite + AgentDB + PostgreSQL | ⛔ | ⛔ | ⛔ | Limited |
|
||||
| **Cross-Session Context** | ✅ Full restoration | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **GNN/Attention in SQL** | ✅ 39 attention mechanisms | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
@@ -765,10 +762,10 @@ Ruflo v3 introduces **self-learning neural capabilities** that no other agent or
|
||||
|---------|----------------|--------|-----------|---------|-------|
|
||||
| **Threat Detection** | ✅ AIDefence (<10ms) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Cloud Platform** | ✅ Flow Nexus | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Code Transforms** | ✅ Agent Booster (352x) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Code Transforms** | ✅ Agent Booster (WASM) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Input Validation** | ✅ Zod + Path security | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
|
||||
<sub>*Comparison updated January 23, 2026*</sub>
|
||||
<sub>*Comparison updated February 2026. Feature availability based on public documentation.*</sub>
|
||||
|
||||
</details>
|
||||
|
||||
@@ -779,16 +776,16 @@ What makes Ruflo different from other agent frameworks? These 10 capabilities wo
|
||||
|
||||
| | Feature | What It Does | Technical Details |
|
||||
|---|---------|--------------|-------------------|
|
||||
| 🧠 | **SONA** | Learns which agents perform best for each task type and routes work accordingly | Self-Optimizing Neural Architecture, <0.05ms adaptation |
|
||||
| 🧠 | **SONA** | Learns which agents perform best for each task type and routes work accordingly | Self-Optimizing Neural Architecture |
|
||||
| 🔒 | **EWC++** | Preserves learned patterns when training on new ones — no forgetting | Elastic Weight Consolidation prevents catastrophic forgetting |
|
||||
| 🎯 | **MoE** | Routes tasks through 8 specialized expert networks based on task type | Mixture of 8 Experts with dynamic gating |
|
||||
| ⚡ | **Flash Attention** | Accelerates attention computation 2-7x for faster agent responses | 2.49x-7.47x speedup for attention computations |
|
||||
| 🌐 | **Hyperbolic Embeddings** | Represents hierarchical code relationships in compact vector space | Poincaré ball model for hierarchical code relationships |
|
||||
| 📦 | **LoRA** | Compresses model weights 128x so agents fit in limited memory | 128x memory compression via Low-Rank Adaptation |
|
||||
| 🗜️ | **Int8 Quantization** | Converts 32-bit weights to 8-bit with minimal accuracy loss | 3.92x memory reduction with calibrated 8-bit integers |
|
||||
| ⚡ | **Flash Attention** | Accelerates attention computation for faster agent responses | Optimized attention via @ruvector/attention |
|
||||
| 🌐 | **Hyperbolic Embeddings** | Represents hierarchical code relationships in compact vector space | Poincare ball model for hierarchical data |
|
||||
| 📦 | **LoRA** | Lightweight model adaptation so agents fit in limited memory | Low-Rank Adaptation via @ruvector/sona |
|
||||
| 🗜️ | **Int8 Quantization** | Converts 32-bit weights to 8-bit with minimal accuracy loss | ~4x memory reduction with calibrated integers |
|
||||
| 🤝 | **Claims System** | Manages task ownership between humans and agents with handoff support | Work ownership with claim/release/handoff protocols |
|
||||
| 🛡️ | **Byzantine Consensus** | Coordinates agents even when some fail or return bad results | Fault-tolerant, handles up to 1/3 failing agents |
|
||||
| 🐘 | **RuVector PostgreSQL** | Enterprise-grade vector database with 77+ SQL functions for AI operations | ~61µs search, 16,400 QPS, GNN/attention in SQL |
|
||||
| 🐘 | **RuVector PostgreSQL** | Enterprise-grade vector database with 77+ SQL functions for AI operations | Fast vector search with GNN/attention in SQL |
|
||||
|
||||
</details>
|
||||
|
||||
@@ -1020,13 +1017,13 @@ flowchart LR
|
||||
<details>
|
||||
<summary>🧠 <strong>AgentDB v3 Controllers</strong> — 20+ intelligent memory controllers</summary>
|
||||
|
||||
Claude Flow V3 integrates AgentDB v3 (3.0.0-alpha.9) providing 20+ memory controllers accessible via MCP tools and the CLI.
|
||||
Ruflo V3 integrates AgentDB v3 (3.0.0-alpha.10) providing 20+ memory controllers accessible via MCP tools and the CLI.
|
||||
|
||||
**Core Memory:**
|
||||
|
||||
| Controller | MCP Tool | Description |
|
||||
|-----------|----------|-------------|
|
||||
| HierarchicalMemory | `agentdb_hierarchical-store/recall` | Working → short-term → long-term memory tiers with automatic promotion and retention decay |
|
||||
| HierarchicalMemory | `agentdb_hierarchical-store/recall` | Working → episodic → semantic memory tiers with Ebbinghaus forgetting curves and spaced repetition |
|
||||
| MemoryConsolidation | `agentdb_consolidate` | Automatic clustering and merging of related memories into semantic summaries |
|
||||
| BatchOperations | `agentdb_batch` | Bulk insert/update/delete operations for high-throughput memory management |
|
||||
| ReasoningBank | `agentdb_pattern-store/search` | Pattern storage with BM25+semantic hybrid search |
|
||||
@@ -1057,12 +1054,17 @@ Claude Flow V3 integrates AgentDB v3 (3.0.0-alpha.9) providing 20+ memory contro
|
||||
| GuardedVectorBackend | — | Cryptographic proof-of-work before vector insert/search |
|
||||
| MutationGuard | — | Token-validated mutations with cryptographic proofs |
|
||||
| AttestationLog | — | Immutable audit trail of all memory operations |
|
||||
|
||||
**Optimization:**
|
||||
|
||||
| Controller | MCP Tool | Description |
|
||||
|-----------|----------|-------------|
|
||||
| RVFOptimizer | — | 4-bit adaptive quantization and progressive compression |
|
||||
|
||||
**MCP Tool Examples:**
|
||||
```bash
|
||||
# Store to hierarchical memory
|
||||
agentdb_hierarchical-store --key "auth-pattern" --value "JWT refresh" --tier "longTerm"
|
||||
agentdb_hierarchical-store --key "auth-pattern" --value "JWT refresh" --tier "semantic"
|
||||
|
||||
# Recall from memory tiers
|
||||
agentdb_hierarchical-recall --query "authentication" --topK 5
|
||||
@@ -1083,14 +1085,14 @@ agentdb_semantic-route --input "fix auth bug in login"
|
||||
**Hierarchical Memory Tiers:**
|
||||
```
|
||||
┌─────────────────────────────────────────────┐
|
||||
│ Working Memory (capacity: 7±2 items) │ ← Active context, fast access
|
||||
│ TTL: ~30 seconds, auto-evict oldest │
|
||||
│ Working Memory │ ← Active context, fast access
|
||||
│ Size-based eviction (1MB limit) │
|
||||
├─────────────────────────────────────────────┤
|
||||
│ Short-Term Memory │ ← Recent patterns, moderate retention
|
||||
│ Rehearsal strengthens, decay weakens │
|
||||
│ Episodic Memory │ ← Recent patterns, moderate retention
|
||||
│ Importance × retention score ranking │
|
||||
├─────────────────────────────────────────────┤
|
||||
│ Long-Term Memory │ ← Consolidated knowledge, persistent
|
||||
│ Promoted from short-term via consolidation │
|
||||
│ Semantic Memory │ ← Consolidated knowledge, persistent
|
||||
│ Promoted from episodic via consolidation │
|
||||
└─────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
@@ -1626,7 +1628,7 @@ npx ruflo hive-mind memory # Collective memory stats
|
||||
npx ruflo hive-mind sessions # List active sessions
|
||||
```
|
||||
|
||||
**Performance:** 10-20x faster batch spawning, 2.8-4.4x speed improvement, 84.8% SWE-Bench solve rate
|
||||
**Performance:** Fast batch spawning with parallel agent coordination
|
||||
|
||||
</details>
|
||||
|
||||
@@ -2044,14 +2046,14 @@ npx ruflo@v3alpha worker status
|
||||
<details>
|
||||
<summary>☁️ <strong>LLM Providers</strong> — 6 providers with automatic failover</summary>
|
||||
|
||||
| Provider | Models (2025-2026) | Features | Cost |
|
||||
| Provider | Models | Features | Cost |
|
||||
|----------|--------|----------|------|
|
||||
| **Anthropic** | Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5 | Native, streaming, tool calling, extended thinking | $1-25/1M tokens |
|
||||
| **OpenAI** | GPT-5.2, o3, o3-pro, o4-mini | 400K context, reasoning chains, 100% AIME 2025 | $0.15-60/1M tokens |
|
||||
| **Google** | Gemini 3 Pro, Gemini 3 Flash, Gemini 3 Deep Think | 1M+ context, multimodal, Deep Think reasoning | $0.075-7/1M tokens |
|
||||
| **xAI** | Grok 4.1, Grok 3 | Truth-seeking, real-time data, 200K H100 training | $2-10/1M tokens |
|
||||
| **Mistral** | Mistral Large 3 (675B MoE), Codestral | 92% GPT-5.2 performance at 15% cost | $0.50-8/1M tokens |
|
||||
| **Meta/Ollama** | Llama 4 Scout/Maverick, DeepSeek V3, Qwen 3 | Local, free, up to 10M context (Scout) | Free |
|
||||
| **Anthropic** | Claude Opus 4, Claude Sonnet 4, Claude Haiku 3.5 | Native, streaming, tool calling, extended thinking | $1-15/1M tokens |
|
||||
| **OpenAI** | GPT-4o, o3-mini, o1 | 128K context, reasoning chains, function calling | $0.15-60/1M tokens |
|
||||
| **Google** | Gemini 2.0 Flash, Gemini 1.5 Pro | 1M+ context, multimodal, grounding | $0.075-7/1M tokens |
|
||||
| **xAI** | Grok 3, Grok 3 Mini | Real-time data, reasoning, large context | $2-10/1M tokens |
|
||||
| **Mistral** | Mistral Large 2, Codestral | Open-weight, efficient MoE architecture | $0.50-8/1M tokens |
|
||||
| **Meta/Ollama** | Llama 3.3, DeepSeek V3, Qwen 2.5 | Local, free, open-weight | Free |
|
||||
|
||||
<details>
|
||||
<summary>⚖️ <strong>Provider Load Balancing</strong> — 4 strategies for optimal cost and performance</summary>
|
||||
@@ -2368,7 +2370,7 @@ npx ruflo hive-mind status # Check status
|
||||
|
||||
**Ruflo Skill:** `/hive-mind-advanced` — Full hive mind orchestration
|
||||
|
||||
**Performance:** 10-20x faster batch spawning, 84.8% SWE-Bench solve rate, 32.3% token reduction
|
||||
**Performance:** Fast batch spawning with token reduction via intelligent routing
|
||||
|
||||
</details>
|
||||
|
||||
@@ -2482,13 +2484,13 @@ Claude Code pipes JSON session data via **stdin** to the statusline script after
|
||||
|
||||
**Output Format:**
|
||||
```
|
||||
▊ Claude Flow V3 ● ruvnet │ ⎇ main │ Opus 4.6 | ●42% ctx | $0.15
|
||||
▊ Ruflo V3 ● ruvnet │ ⎇ main │ Opus 4.6 | ●42% ctx | $0.15
|
||||
🏗️ DDD [●●●●○] 4/5 ⚡ HNSW 150x 🤖 ◉ [12/8] 👥 3 🟢 CVE 3/3 💾 512MB 🧠 15% 📦 AgentDB ●1.2K vectors
|
||||
```
|
||||
|
||||
| Indicator | Description | Source |
|
||||
|-----------|-------------|--------|
|
||||
| `▊ Claude Flow V3` | Project header | Always shown |
|
||||
| `▊ Ruflo V3` | Project header | Always shown |
|
||||
| `● ruvnet` | GitHub user | `gh api user` CLI |
|
||||
| `⎇ main` | Current git branch | `git branch --show-current` |
|
||||
| `Opus 4.6` | Claude model name | Stdin JSON `model.display_name` |
|
||||
@@ -2506,7 +2508,7 @@ Claude Code pipes JSON session data via **stdin** to the statusline script after
|
||||
|
||||
**Setup (Automatic):**
|
||||
|
||||
Run `npx claude-flow@v3alpha init` — this generates `.claude/settings.json` with the correct statusline config and creates the helper script at `.claude/helpers/statusline.cjs`.
|
||||
Run `npx ruflo@alpha init` — this generates `.claude/settings.json` with the correct statusline config and creates the helper script at `.claude/helpers/statusline.cjs`.
|
||||
|
||||
The generated config uses a **fast local script** (no `npx` cold-start):
|
||||
```json
|
||||
@@ -2524,7 +2526,7 @@ The generated config uses a **fast local script** (no `npx` cold-start):
|
||||
|
||||
If your statusline is not updating, run the upgrade command to regenerate helpers and fix the config:
|
||||
```bash
|
||||
npx claude-flow@v3alpha init --update --settings
|
||||
npx ruflo@alpha init --update --settings
|
||||
```
|
||||
|
||||
This removes invalid config fields and regenerates the statusline helper with stdin support.
|
||||
@@ -3842,7 +3844,7 @@ Skills are **reusable workflows** that combine agents, hooks, and patterns into
|
||||
| Skill | What It Does | When To Use |
|
||||
|-------|--------------|-------------|
|
||||
| `agentdb-vector-search` | Semantic search with 150x faster retrieval | Building RAG systems, knowledge bases |
|
||||
| `agentdb-memory-patterns` | Session memory, long-term storage, context management | Stateful agents, chat systems |
|
||||
| `agentdb-memory-patterns` | Session memory, persistent storage, context management | Stateful agents, chat systems |
|
||||
| `agentdb-learning` | 9 RL algorithms (PPO, DQN, SARSA, etc.) | Self-learning agents, behavior optimization |
|
||||
| `agentdb-optimization` | Quantization (4-32x memory reduction), HNSW indexing | Scaling to millions of vectors |
|
||||
| `agentdb-advanced` | QUIC sync, multi-database, custom distance metrics | Distributed AI systems |
|
||||
@@ -3953,7 +3955,7 @@ Skills are **reusable workflows** that combine agents, hooks, and patterns into
|
||||
|
||||
| Skill | What It Does | When To Use |
|
||||
|-------|--------------|-------------|
|
||||
| `agentic-jujutsu` | Quantum-resistant, self-learning version control | Multi-agent coordination |
|
||||
| `agentic-jujutsu` | Self-learning version control for AI agents | Multi-agent coordination |
|
||||
| `worker-benchmarks` | Performance benchmarking framework | Measuring improvements |
|
||||
| `worker-integration` | Worker-agent coordination patterns | Background processing |
|
||||
|
||||
@@ -4941,13 +4943,13 @@ const config = optimizer.getOptimalConfig(agentCount);
|
||||
---
|
||||
|
||||
<details>
|
||||
<summary>🥋 <strong>Agentic-Jujutsu</strong> — Quantum-Ready AI Version Control</summary>
|
||||
<summary>🥋 <strong>Agentic-Jujutsu</strong> — Self-Learning AI Version Control</summary>
|
||||
|
||||
[](https://www.npmjs.com/package/agentic-jujutsu)
|
||||
[](https://www.npmjs.com/package/agentic-jujutsu)
|
||||
[](https://github.com/ruvnet/agentic-flow/tree/main/packages/agentic-jujutsu)
|
||||
|
||||
**Agentic-Jujutsu** is quantum-ready, self-learning version control designed for multiple AI agents working simultaneously without conflicts. Built on [Jujutsu](https://github.com/martinvonz/jj), it provides 23x faster performance than Git with automatic conflict resolution.
|
||||
**Agentic-Jujutsu** is self-learning version control designed for multiple AI agents working simultaneously without conflicts. Built on [Jujutsu](https://github.com/martinvonz/jj), it provides faster performance than Git with automatic conflict resolution.
|
||||
|
||||
### Quick Start
|
||||
|
||||
@@ -4978,7 +4980,7 @@ npx agentic-jujutsu compare-git
|
||||
| **AI integration** | Manual work | Built-in (MCP protocol) |
|
||||
| **Self-learning capabilities** | ❌ None | ✅ ReasoningBank |
|
||||
| **Automatic conflict resolution** | 30-40% auto | **87% auto** |
|
||||
| **Quantum-resistant security** | ❌ None | ✅ Architecture ready |
|
||||
| **Cryptographic security** | Basic | SHA3-512 fingerprints |
|
||||
|
||||
### Core Capabilities
|
||||
|
||||
@@ -5024,7 +5026,7 @@ console.log('Confidence:', (suggestion.confidence * 100).toFixed(1) + '%');
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🤝 <strong>Multi-Agent Coordination</strong> — QuantumDAG architecture for conflict-free collaboration</summary>
|
||||
<summary>🤝 <strong>Multi-Agent Coordination</strong> — DAG architecture for conflict-free collaboration</summary>
|
||||
|
||||
```javascript
|
||||
// All agents work concurrently (no conflicts!)
|
||||
@@ -5060,12 +5062,12 @@ console.log('All agents completed:', results);
|
||||
| Context switching | 500-1000ms | **50-100ms (10x)** |
|
||||
| Conflict resolution | 30-40% auto | **87% auto (2.5x)** |
|
||||
| Lock waiting | 50 min/day | **0 min (∞)** |
|
||||
| Quantum fingerprints | N/A | **<1ms** |
|
||||
| SHA3-512 fingerprints | N/A | **<1ms** |
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🔐 <strong>Quantum-Resistant Security</strong> — SHA3-512 fingerprints and HQC-128 encryption</summary>
|
||||
<summary>🔐 <strong>Cryptographic Security</strong> — SHA3-512 fingerprints and AES-256 encryption</summary>
|
||||
|
||||
```javascript
|
||||
const { generateQuantumFingerprint, verifyQuantumFingerprint } = require('agentic-jujutsu');
|
||||
@@ -5086,7 +5088,7 @@ const key = crypto.randomBytes(32).toString('base64');
|
||||
jj.enableEncryption(key);
|
||||
```
|
||||
|
||||
**Quantum Security Methods:**
|
||||
**Security Methods:**
|
||||
|
||||
| Method | Description | Returns |
|
||||
|--------|-------------|---------|
|
||||
@@ -5108,9 +5110,9 @@ Ruflo includes a dedicated `/agentic-jujutsu` skill for AI-powered version contr
|
||||
|
||||
**Use this skill when you need:**
|
||||
- ✅ Multiple AI agents modifying code simultaneously
|
||||
- ✅ Lock-free version control (23x faster than Git)
|
||||
- ✅ Lock-free version control (faster than Git for concurrent agents)
|
||||
- ✅ Self-learning AI that improves from experience
|
||||
- ✅ Quantum-resistant security for future-proof protection
|
||||
- ✅ SHA3-512 cryptographic integrity verification
|
||||
- ✅ Automatic conflict resolution (87% success rate)
|
||||
- ✅ Pattern recognition and intelligent suggestions
|
||||
|
||||
@@ -5167,7 +5169,7 @@ npx agentic-jujutsu examples # Show usage examples
|
||||
| **v1.x** | Required separate jj install |
|
||||
| **v2.0** | Zero-dependency (jj binary embedded) |
|
||||
| **v2.1** | Self-learning AI with ReasoningBank |
|
||||
| **v2.2** | Multi-agent coordination + quantum-ready |
|
||||
| **v2.2** | Multi-agent coordination + cryptographic security |
|
||||
| **v2.3** | Kubernetes GitOps + production stability |
|
||||
|
||||
</details>
|
||||
@@ -5250,17 +5252,17 @@ const compressed = ruvector.compress(embedding, 0.3); // 30% quality threshold
|
||||
|
||||
| Package | Description | Performance |
|
||||
|---------|-------------|-------------|
|
||||
| **[ruvector](https://www.npmjs.com/package/ruvector)** | Core vector database with HNSW | **~61µs search, 16,400 QPS** |
|
||||
| **[@ruvector/attention](https://www.npmjs.com/package/@ruvector/attention)** | Flash Attention mechanisms | 2.49x-7.47x speedup |
|
||||
| **[@ruvector/sona](https://www.npmjs.com/package/@ruvector/sona)** | SONA adaptive learning (LoRA, EWC++) | <0.05ms adaptation |
|
||||
| **[ruvector](https://www.npmjs.com/package/ruvector)** | Core vector database with HNSW | Fast vector search |
|
||||
| **[@ruvector/attention](https://www.npmjs.com/package/@ruvector/attention)** | Flash Attention mechanisms | 2-7x speedup |
|
||||
| **[@ruvector/sona](https://www.npmjs.com/package/@ruvector/sona)** | SONA adaptive learning (LoRA, EWC++) | Fast adaptation |
|
||||
| **[@ruvector/gnn](https://www.npmjs.com/package/@ruvector/gnn)** | Graph Neural Networks (15 layer types) | Native NAPI bindings |
|
||||
| **[@ruvector/graph-node](https://www.npmjs.com/package/@ruvector/graph-node)** | Graph DB with Cypher queries | 10x faster than WASM |
|
||||
| **[@ruvector/graph-node](https://www.npmjs.com/package/@ruvector/graph-node)** | Graph DB with Cypher queries | Native NAPI |
|
||||
| **[@ruvector/rvlite](https://www.npmjs.com/package/@ruvector/rvlite)** | Standalone DB (SQL, SPARQL, Cypher) | All-in-one solution |
|
||||
| **[ruvector-wasm](https://www.npmjs.com/package/ruvector-wasm)** | Browser/Edge WASM build | Works everywhere |
|
||||
| **[@ruvector/router](https://www.npmjs.com/package/@ruvector/router)** | Semantic intent routing | Fast routing |
|
||||
|
||||
### 🐘 RuVector PostgreSQL — Enterprise Vector Database
|
||||
|
||||
**77+ SQL functions** for AI operations directly in PostgreSQL with ~61µs search latency and 16,400 QPS.
|
||||
**77+ SQL functions** for AI operations directly in PostgreSQL with fast vector search.
|
||||
|
||||
```bash
|
||||
# Quick setup with CLI (recommended)
|
||||
@@ -5992,22 +5994,22 @@ Domain-Driven Design with bounded contexts, clean architecture, and measured per
|
||||
|
||||
### Performance Benchmarks
|
||||
|
||||
| Category | Metric | Target | Measured |
|
||||
|----------|--------|--------|----------|
|
||||
| **Startup** | CLI cold start | <500ms | ✅ 380ms |
|
||||
| **Startup** | MCP server init | <400ms | ✅ 320ms |
|
||||
| **Memory** | HNSW search | <1ms | ✅ 0.4ms |
|
||||
| **Memory** | Pattern retrieval | <10ms | ✅ 6ms |
|
||||
| **Swarm** | Agent spawn | <200ms | ✅ 150ms |
|
||||
| **Swarm** | Consensus latency | <100ms | ✅ 75ms |
|
||||
| **Neural** | SONA adaptation | <0.05ms | ✅ 0.03ms |
|
||||
| **Graph** | Build (1k nodes) | <200ms | ✅ 2.78ms (71.9x headroom) |
|
||||
| **Graph** | PageRank (1k nodes) | <100ms | ✅ 12.21ms (8.2x headroom) |
|
||||
| **Learning** | Insight recording | <5ms | ✅ 0.12ms (41x headroom) |
|
||||
| **Learning** | Consolidation | <500ms | ✅ 0.26ms (1,955x headroom) |
|
||||
| **Learning** | Confidence decay (1k) | <50ms | ✅ 0.23ms (215x headroom) |
|
||||
| **Transfer** | Knowledge transfer | <100ms | ✅ 1.25ms (80x headroom) |
|
||||
| **Task** | Success rate | 95%+ | ✅ 100% (7/7) |
|
||||
*Benchmarks measured on Node.js 20+ with local SQLite. Results vary by hardware and workload.*
|
||||
|
||||
| Category | Metric | Target | Status |
|
||||
|----------|--------|--------|--------|
|
||||
| **Startup** | CLI cold start | <500ms | ✅ Met |
|
||||
| **Startup** | MCP server init | <400ms | ✅ Met |
|
||||
| **Memory** | HNSW search | <1ms | ✅ Sub-ms |
|
||||
| **Memory** | Pattern retrieval | <10ms | ✅ Met |
|
||||
| **Swarm** | Agent spawn | <200ms | ✅ Met |
|
||||
| **Swarm** | Consensus latency | <100ms | ✅ Met |
|
||||
| **Neural** | SONA adaptation | <0.05ms | ✅ Met |
|
||||
| **Graph** | Build (1k nodes) | <200ms | ✅ Met |
|
||||
| **Graph** | PageRank (1k nodes) | <100ms | ✅ Met |
|
||||
| **Learning** | Insight recording | <5ms | ✅ Met |
|
||||
| **Learning** | Consolidation | <500ms | ✅ Met |
|
||||
| **Task** | Success rate | 95%+ | ✅ Met |
|
||||
|
||||
### Topology Performance
|
||||
|
||||
@@ -6056,7 +6058,7 @@ browser.startTrajectory('Login to dashboard');
|
||||
|
||||
await browser.open('https://example.com/login');
|
||||
|
||||
// Use element refs (93% context reduction vs CSS selectors)
|
||||
// Use element refs (shorter tokens vs full CSS selectors)
|
||||
const snapshot = await browser.snapshot({ interactive: true });
|
||||
await browser.fill('@e1', 'user@example.com');
|
||||
await browser.fill('@e2', 'password');
|
||||
@@ -6071,7 +6073,7 @@ await browser.close();
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| **59 MCP Tools** | Complete browser automation via MCP protocol |
|
||||
| **Element Refs** | 93% context reduction with `@e1`, `@e2` refs |
|
||||
| **Element Refs** | Compact `@e1`, `@e2` refs instead of verbose CSS selectors |
|
||||
| **Trajectory Learning** | Records actions for ReasoningBank/SONA |
|
||||
| **Security Scanning** | URL validation, PII detection, XSS/SQL injection prevention |
|
||||
| **9 Workflow Templates** | Login, OAuth, scraping, testing, monitoring |
|
||||
@@ -7004,7 +7006,7 @@ Ruflo looks for configuration in this order:
|
||||
"default": "anthropic",
|
||||
"fallback": ["openai", "google"],
|
||||
"anthropic": {
|
||||
"model": "claude-sonnet-4-20250514",
|
||||
"model": "claude-sonnet-4-6-20250514",
|
||||
"maxTokens": 8192
|
||||
},
|
||||
"openai": {
|
||||
|
||||
+2
-15
@@ -2,23 +2,10 @@
|
||||
/**
|
||||
* Claude Flow CLI - Umbrella entry point
|
||||
* Proxies to @claude-flow/cli bin for cross-platform compatibility.
|
||||
*
|
||||
* Includes pre-flight npx cache repair to prevent ENOTEMPTY errors
|
||||
* in remote/CI environments (known npm 10.x bug).
|
||||
*/
|
||||
import { pathToFileURL, fileURLToPath } from 'node:url';
|
||||
import { dirname, join } from 'node:path';
|
||||
|
||||
// Repair stale npx cache entries and corrupted integrity before loading
|
||||
try {
|
||||
const __dirname = dirname(fileURLToPath(import.meta.url));
|
||||
const mod = await import(pathToFileURL(join(__dirname, 'npx-repair.js')).href);
|
||||
mod.repairNpxCache();
|
||||
if (mod.repairCacheIntegrity) mod.repairCacheIntegrity();
|
||||
} catch {
|
||||
// Non-fatal — continue even if repair fails
|
||||
}
|
||||
|
||||
const __dirname2 = dirname(fileURLToPath(import.meta.url));
|
||||
const cliPath = join(__dirname2, '..', 'v3', '@claude-flow', 'cli', 'bin', 'cli.js');
|
||||
const __dirname = dirname(fileURLToPath(import.meta.url));
|
||||
const cliPath = join(__dirname, '..', 'v3', '@claude-flow', 'cli', 'bin', 'cli.js');
|
||||
await import(pathToFileURL(cliPath).href);
|
||||
+6
-133
@@ -1,134 +1,7 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* NPX Cache Repair
|
||||
*
|
||||
* Fixes the ENOTEMPTY error that occurs when npx's cache gets corrupted
|
||||
* from interrupted installs. This is a known npm bug affecting npm 10.x
|
||||
* on Node 22+ particularly in remote/CI environments.
|
||||
*
|
||||
* Usage:
|
||||
* - Imported by bin entry points before main logic
|
||||
* - Can also be run standalone: node bin/npx-repair.js
|
||||
*/
|
||||
import { readdirSync, readFileSync, rmSync, statSync, existsSync, unlinkSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
|
||||
/**
|
||||
* Remove stale .{name}-{hash} rename artifacts from npx cache dirs.
|
||||
* These are leftover from npm's atomic rename strategy when interrupted.
|
||||
*/
|
||||
export function repairNpxCache() {
|
||||
const npxCacheRoot = join(homedir(), '.npm', '_npx');
|
||||
if (!existsSync(npxCacheRoot)) return;
|
||||
|
||||
let cleaned = 0;
|
||||
try {
|
||||
const cacheDirs = readdirSync(npxCacheRoot);
|
||||
for (const dir of cacheDirs) {
|
||||
const nmDir = join(npxCacheRoot, dir, 'node_modules');
|
||||
if (!existsSync(nmDir)) continue;
|
||||
|
||||
try {
|
||||
const entries = readdirSync(nmDir);
|
||||
for (const entry of entries) {
|
||||
// Stale rename targets look like: .package-name-XxXxXxXx
|
||||
if (entry.startsWith('.') && entry.includes('-') && /[A-Za-z]{8}$/.test(entry)) {
|
||||
const fullPath = join(nmDir, entry);
|
||||
try {
|
||||
const stat = statSync(fullPath);
|
||||
if (stat.isDirectory()) {
|
||||
rmSync(fullPath, { recursive: true, force: true });
|
||||
cleaned++;
|
||||
}
|
||||
} catch {
|
||||
// ignore individual failures
|
||||
}
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// can't read this cache dir, skip
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// npx cache root not readable, nothing to do
|
||||
}
|
||||
|
||||
return cleaned;
|
||||
}
|
||||
|
||||
/**
|
||||
* Remove corrupted _cacache integrity entries for claude-flow/ruflo packages.
|
||||
* Fixes ECOMPROMISED by clearing stale integrity hashes so npm re-fetches.
|
||||
*/
|
||||
export function repairCacheIntegrity() {
|
||||
const indexDir = join(homedir(), '.npm', '_cacache', 'index-v5');
|
||||
if (!existsSync(indexDir)) return 0;
|
||||
|
||||
let cleaned = 0;
|
||||
function walk(dir) {
|
||||
try {
|
||||
for (const entry of readdirSync(dir)) {
|
||||
const fp = join(dir, entry);
|
||||
try {
|
||||
const s = statSync(fp);
|
||||
if (s.isDirectory()) {
|
||||
walk(fp);
|
||||
} else {
|
||||
const content = readFileSync(fp, 'utf-8');
|
||||
if (content.includes('claude-flow') || content.includes('ruflo')) {
|
||||
unlinkSync(fp);
|
||||
cleaned++;
|
||||
}
|
||||
}
|
||||
} catch { /* skip */ }
|
||||
}
|
||||
} catch { /* skip unreadable dir */ }
|
||||
}
|
||||
walk(indexDir);
|
||||
return cleaned;
|
||||
}
|
||||
|
||||
/**
|
||||
* Remove a specific corrupted npx cache entry by hash.
|
||||
*/
|
||||
export function removeNpxCacheEntry(hash) {
|
||||
const target = join(homedir(), '.npm', '_npx', hash);
|
||||
if (existsSync(target)) {
|
||||
rmSync(target, { recursive: true, force: true });
|
||||
return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Full cache nuke — removes all npx cache entries.
|
||||
* Use as last resort when repair isn't enough.
|
||||
*/
|
||||
export function nukeNpxCache() {
|
||||
const npxCacheRoot = join(homedir(), '.npm', '_npx');
|
||||
if (existsSync(npxCacheRoot)) {
|
||||
rmSync(npxCacheRoot, { recursive: true, force: true });
|
||||
return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
// Run standalone
|
||||
if (process.argv[1] && process.argv[1].includes('npx-repair')) {
|
||||
const arg = process.argv[2];
|
||||
if (arg === '--nuke') {
|
||||
console.error('[npx-repair] Removing entire npx cache...');
|
||||
nukeNpxCache();
|
||||
console.error('[npx-repair] Done.');
|
||||
} else {
|
||||
const cleaned = repairNpxCache();
|
||||
const intFixed = repairCacheIntegrity();
|
||||
if (cleaned > 0) {
|
||||
console.error(`[npx-repair] Cleaned ${cleaned} stale cache entries.`);
|
||||
}
|
||||
if (intFixed > 0) {
|
||||
console.error(`[npx-repair] Removed ${intFixed} corrupted integrity entries.`);
|
||||
}
|
||||
}
|
||||
}
|
||||
// NPX cache repair — no-op (removed in 3.1.0-alpha.53)
|
||||
// Kept as empty module for backwards compatibility with older bin/cli.js imports.
|
||||
export function repairNpxCache() { return 0; }
|
||||
export function repairCacheIntegrity() { return 0; }
|
||||
export function removeNpxCacheEntry() { return false; }
|
||||
export function nukeNpxCache() { return false; }
|
||||
+7
-47
@@ -1,49 +1,9 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Safe NPX launcher with automatic ENOTEMPTY recovery.
|
||||
*
|
||||
* When run via npx, this script:
|
||||
* 1. Repairs stale npx cache entries (pre-flight)
|
||||
* 2. Proxies to the real CLI/MCP entry point
|
||||
*
|
||||
* This is designed to run AFTER npx has already resolved and installed
|
||||
* the package — it prevents the NEXT run from hitting ENOTEMPTY by
|
||||
* cleaning up stale artifacts left from THIS run or prior interrupted runs.
|
||||
*
|
||||
* For the case where npx itself fails (can't even get to this script),
|
||||
* use bin/claude-flow-mcp.sh which wraps the entire npx invocation.
|
||||
*/
|
||||
import { existsSync, readdirSync, rmSync, statSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
// Safe NPX launcher — no-op wrapper (cache repair removed in 3.1.0-alpha.53)
|
||||
// Proxies directly to the CLI entry point.
|
||||
import { pathToFileURL, fileURLToPath } from 'node:url';
|
||||
import { dirname, join } from 'node:path';
|
||||
|
||||
// Clean stale .package-XxXx rename artifacts from ALL npx cache dirs
|
||||
function repairNpxCache() {
|
||||
const npxRoot = join(homedir(), '.npm', '_npx');
|
||||
if (!existsSync(npxRoot)) return 0;
|
||||
|
||||
let cleaned = 0;
|
||||
try {
|
||||
for (const dir of readdirSync(npxRoot)) {
|
||||
const nm = join(npxRoot, dir, 'node_modules');
|
||||
if (!existsSync(nm)) continue;
|
||||
try {
|
||||
for (const entry of readdirSync(nm)) {
|
||||
if (entry.startsWith('.') && entry.includes('-') && /[A-Za-z]{8}$/.test(entry)) {
|
||||
try {
|
||||
const p = join(nm, entry);
|
||||
if (statSync(p).isDirectory()) {
|
||||
rmSync(p, { recursive: true, force: true });
|
||||
cleaned++;
|
||||
}
|
||||
} catch { /* ignore */ }
|
||||
}
|
||||
}
|
||||
} catch { /* ignore */ }
|
||||
}
|
||||
} catch { /* ignore */ }
|
||||
return cleaned;
|
||||
}
|
||||
|
||||
// Always run repair on startup
|
||||
repairNpxCache();
|
||||
const __dirname = dirname(fileURLToPath(import.meta.url));
|
||||
const cliPath = join(__dirname, '..', 'v3', '@claude-flow', 'cli', 'bin', 'cli.js');
|
||||
await import(pathToFileURL(cliPath).href);
|
||||
+3
-3
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "claude-flow",
|
||||
"version": "3.1.0-alpha.52",
|
||||
"description": "Enterprise AI agent orchestration for Claude Code - Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
|
||||
"version": "3.5.0",
|
||||
"description": "Ruflo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
|
||||
"main": "dist/index.js",
|
||||
"type": "module",
|
||||
"bin": {
|
||||
@@ -131,6 +131,6 @@
|
||||
"license": "MIT",
|
||||
"publishConfig": {
|
||||
"access": "public",
|
||||
"tag": "v3alpha"
|
||||
"tag": "latest"
|
||||
}
|
||||
}
|
||||
+2
-2
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "ruflo",
|
||||
"version": "3.1.0-alpha.52",
|
||||
"version": "3.5.0",
|
||||
"description": "Ruflo - Enterprise AI agent orchestration platform. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
|
||||
"main": "bin/ruflo.js",
|
||||
"type": "module",
|
||||
@@ -62,6 +62,6 @@
|
||||
"license": "MIT",
|
||||
"publishConfig": {
|
||||
"access": "public",
|
||||
"tag": "alpha"
|
||||
"tag": "latest"
|
||||
}
|
||||
}
|
||||
@@ -9,7 +9,7 @@ capabilities:
|
||||
- optimization
|
||||
- api_design
|
||||
- error_handling
|
||||
# NEW v2.0.0-alpha capabilities
|
||||
# NEW v3.0.0-alpha.1 capabilities
|
||||
- self_learning # ReasoningBank pattern storage
|
||||
- context_enhancement # GNN-enhanced search
|
||||
- fast_processing # Flash Attention
|
||||
|
||||
@@ -9,7 +9,7 @@ capabilities:
|
||||
- resource_allocation
|
||||
- timeline_estimation
|
||||
- risk_assessment
|
||||
# NEW v2.0.0-alpha capabilities
|
||||
# NEW v3.0.0-alpha.1 capabilities
|
||||
- self_learning # Learn from planning outcomes
|
||||
- context_enhancement # GNN-enhanced dependency mapping
|
||||
- fast_processing # Flash Attention planning
|
||||
@@ -366,7 +366,7 @@ console.log(`Common planning gaps: ${stats.commonCritiques}`);
|
||||
- Efficient resource utilization (MoE expert selection)
|
||||
- Continuous progress visibility
|
||||
|
||||
4. **New v2.0.0-alpha Practices**:
|
||||
4. **New v3.0.0-alpha.1 Practices**:
|
||||
- Learn from past plans (ReasoningBank)
|
||||
- Use GNN for dependency mapping (+12.4% accuracy)
|
||||
- Route tasks with MoE attention (optimal agent selection)
|
||||
|
||||
@@ -9,7 +9,7 @@ capabilities:
|
||||
- documentation_research
|
||||
- dependency_tracking
|
||||
- knowledge_synthesis
|
||||
# NEW v2.0.0-alpha capabilities
|
||||
# NEW v3.0.0-alpha.1 capabilities
|
||||
- self_learning # ReasoningBank pattern storage
|
||||
- context_enhancement # GNN-enhanced search (+12.4% accuracy)
|
||||
- fast_processing # Flash Attention
|
||||
|
||||
@@ -9,7 +9,7 @@ capabilities:
|
||||
- performance_analysis
|
||||
- best_practices
|
||||
- documentation_review
|
||||
# NEW v2.0.0-alpha capabilities
|
||||
# NEW v3.0.0-alpha.1 capabilities
|
||||
- self_learning # Learn from review patterns
|
||||
- context_enhancement # GNN-enhanced issue detection
|
||||
- fast_processing # Flash Attention review
|
||||
|
||||
@@ -9,7 +9,7 @@ capabilities:
|
||||
- e2e_testing
|
||||
- performance_testing
|
||||
- security_testing
|
||||
# NEW v2.0.0-alpha capabilities
|
||||
# NEW v3.0.0-alpha.1 capabilities
|
||||
- self_learning # Learn from test failures
|
||||
- context_enhancement # GNN-enhanced test case discovery
|
||||
- fast_processing # Flash Attention test generation
|
||||
|
||||
@@ -112,7 +112,7 @@ hooks:
|
||||
echo "📦 Checking ML libraries..."
|
||||
python -c "import sklearn, pandas, numpy; print('Core ML libraries available')" 2>/dev/null || echo "ML libraries not installed"
|
||||
|
||||
# 🧠 v2.0.0-alpha: Learn from past model training patterns
|
||||
# 🧠 v3.0.0-alpha.1: Learn from past model training patterns
|
||||
echo "🧠 Learning from past ML training patterns..."
|
||||
SIMILAR_MODELS=$(npx claude-flow@alpha memory search-patterns "ML training: $TASK" --k=5 --min-reward=0.8 2>/dev/null || echo "")
|
||||
if [ -n "$SIMILAR_MODELS" ]; then
|
||||
@@ -133,7 +133,7 @@ hooks:
|
||||
find . -name "*.pkl" -o -name "*.h5" -o -name "*.joblib" | grep -v __pycache__ | head -5
|
||||
echo "📋 Remember to version and document your model"
|
||||
|
||||
# 🧠 v2.0.0-alpha: Store model training patterns
|
||||
# 🧠 v3.0.0-alpha.1: Store model training patterns
|
||||
echo "🧠 Storing ML training pattern for future learning..."
|
||||
MODEL_COUNT=$(find . -name "*.pkl" -o -name "*.h5" | grep -v __pycache__ | wc -l)
|
||||
REWARD="0.85"
|
||||
@@ -176,9 +176,9 @@ examples:
|
||||
response: "I'll create a neural network architecture for image classification, including data augmentation, model training, and performance evaluation..."
|
||||
---
|
||||
|
||||
# Machine Learning Model Developer v2.0.0-alpha
|
||||
# Machine Learning Model Developer v3.0.0-alpha.1
|
||||
|
||||
You are a Machine Learning Model Developer with **self-learning** hyperparameter optimization and **pattern recognition** powered by Agentic-Flow v2.0.0-alpha.
|
||||
You are a Machine Learning Model Developer with **self-learning** hyperparameter optimization and **pattern recognition** powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## 🧠 Self-Learning Protocol
|
||||
|
||||
|
||||
@@ -109,7 +109,7 @@ hooks:
|
||||
echo "📋 Analyzing existing API structure..."
|
||||
find . -name "*.route.js" -o -name "*.controller.js" | head -20
|
||||
|
||||
# 🧠 v2.0.0-alpha: Learn from past API implementations
|
||||
# 🧠 v3.0.0-alpha.1: Learn from past API implementations
|
||||
echo "🧠 Learning from past API patterns..."
|
||||
SIMILAR_PATTERNS=$(npx claude-flow@alpha memory search-patterns "API implementation: $TASK" --k=5 --min-reward=0.85 2>/dev/null || echo "")
|
||||
if [ -n "$SIMILAR_PATTERNS" ]; then
|
||||
@@ -129,7 +129,7 @@ hooks:
|
||||
echo "📊 Running API tests..."
|
||||
npm run test:api 2>/dev/null || echo "No API tests configured"
|
||||
|
||||
# 🧠 v2.0.0-alpha: Store learning patterns
|
||||
# 🧠 v3.0.0-alpha.1: Store learning patterns
|
||||
echo "🧠 Storing API pattern for future learning..."
|
||||
REWARD=$(if npm run test:api 2>/dev/null; then echo "0.95"; else echo "0.7"; fi)
|
||||
SUCCESS=$(if npm run test:api 2>/dev/null; then echo "true"; else echo "false"; fi)
|
||||
@@ -170,9 +170,9 @@ examples:
|
||||
response: "I'll implement a complete CRUD API for products with proper validation, error handling, and documentation..."
|
||||
---
|
||||
|
||||
# Backend API Developer v2.0.0-alpha
|
||||
# Backend API Developer v3.0.0-alpha.1
|
||||
|
||||
You are a specialized Backend API Developer agent with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
You are a specialized Backend API Developer agent with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## 🧠 Self-Learning Protocol
|
||||
|
||||
|
||||
@@ -104,7 +104,7 @@ hooks:
|
||||
# Check for existing OpenAPI docs
|
||||
find . -name "openapi.yaml" -o -name "swagger.yaml" -o -name "api.yaml" | grep -v node_modules
|
||||
|
||||
# 🧠 v2.0.0-alpha: Learn from past documentation patterns
|
||||
# 🧠 v3.0.0-alpha.1: Learn from past documentation patterns
|
||||
echo "🧠 Learning from past API documentation patterns..."
|
||||
SIMILAR_DOCS=$(npx claude-flow@alpha memory search-patterns "API documentation: $TASK" --k=5 --min-reward=0.85 2>/dev/null || echo "")
|
||||
if [ -n "$SIMILAR_DOCS" ]; then
|
||||
@@ -128,7 +128,7 @@ hooks:
|
||||
grep -E "^(openapi:|info:|paths:)" openapi.yaml | head -5
|
||||
fi
|
||||
|
||||
# 🧠 v2.0.0-alpha: Store documentation patterns
|
||||
# 🧠 v3.0.0-alpha.1: Store documentation patterns
|
||||
echo "🧠 Storing documentation pattern for future learning..."
|
||||
ENDPOINT_COUNT=$(grep -c "^ /" openapi.yaml 2>/dev/null || echo "0")
|
||||
SCHEMA_COUNT=$(grep -c "^ [A-Z]" openapi.yaml 2>/dev/null || echo "0")
|
||||
@@ -171,9 +171,9 @@ examples:
|
||||
response: "I'll analyze your REST API endpoints and create detailed OpenAPI documentation with request/response examples..."
|
||||
---
|
||||
|
||||
# OpenAPI Documentation Specialist v2.0.0-alpha
|
||||
# OpenAPI Documentation Specialist v3.0.0-alpha.1
|
||||
|
||||
You are an OpenAPI Documentation Specialist with **pattern learning** and **fast generation** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
You are an OpenAPI Documentation Specialist with **pattern learning** and **fast generation** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## 🧠 Self-Learning Protocol
|
||||
|
||||
|
||||
@@ -85,9 +85,9 @@ hooks:
|
||||
# Code Review Swarm - Automated Code Review with AI Agents
|
||||
|
||||
## Overview
|
||||
Deploy specialized AI agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis, enhanced with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
Deploy specialized AI agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis, enhanced with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## 🧠 Self-Learning Protocol (v2.0.0-alpha)
|
||||
## 🧠 Self-Learning Protocol (v3.0.0-alpha.1)
|
||||
|
||||
### Before Each Review: Learn from Past Reviews
|
||||
|
||||
|
||||
@@ -89,7 +89,7 @@ hooks:
|
||||
# GitHub Issue Tracker
|
||||
|
||||
## Purpose
|
||||
Intelligent issue management and project coordination with ruv-swarm integration for automated tracking, progress monitoring, and team coordination, enhanced with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
Intelligent issue management and project coordination with ruv-swarm integration for automated tracking, progress monitoring, and team coordination, enhanced with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## Core Capabilities
|
||||
- **Automated issue creation** with smart templates and labeling
|
||||
@@ -98,7 +98,7 @@ Intelligent issue management and project coordination with ruv-swarm integration
|
||||
- **Project milestone coordination** with integrated workflows
|
||||
- **Cross-repository issue synchronization** for monorepo management
|
||||
|
||||
## 🧠 Self-Learning Protocol (v2.0.0-alpha)
|
||||
## 🧠 Self-Learning Protocol (v3.0.0-alpha.1)
|
||||
|
||||
### Before Issue Triage: Learn from History
|
||||
|
||||
|
||||
@@ -93,7 +93,7 @@ hooks:
|
||||
# GitHub PR Manager
|
||||
|
||||
## Purpose
|
||||
Comprehensive pull request management with swarm coordination for automated reviews, testing, and merge workflows, enhanced with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
Comprehensive pull request management with swarm coordination for automated reviews, testing, and merge workflows, enhanced with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## Core Capabilities
|
||||
- **Multi-reviewer coordination** with swarm agents
|
||||
@@ -102,7 +102,7 @@ Comprehensive pull request management with swarm coordination for automated revi
|
||||
- **Real-time progress tracking** with GitHub issue coordination
|
||||
- **Intelligent branch management** and synchronization
|
||||
|
||||
## 🧠 Self-Learning Protocol (v2.0.0-alpha)
|
||||
## 🧠 Self-Learning Protocol (v3.0.0-alpha.1)
|
||||
|
||||
### Before Each PR Task: Learn from History
|
||||
|
||||
|
||||
@@ -82,7 +82,7 @@ hooks:
|
||||
# GitHub Release Manager
|
||||
|
||||
## Purpose
|
||||
Automated release coordination and deployment with ruv-swarm orchestration for seamless version management, testing, and deployment across multiple packages, enhanced with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
Automated release coordination and deployment with ruv-swarm orchestration for seamless version management, testing, and deployment across multiple packages, enhanced with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## Core Capabilities
|
||||
- **Automated release pipelines** with comprehensive testing
|
||||
@@ -91,7 +91,7 @@ Automated release coordination and deployment with ruv-swarm orchestration for s
|
||||
- **Release documentation** generation and management
|
||||
- **Multi-stage validation** with swarm coordination
|
||||
|
||||
## 🧠 Self-Learning Protocol (v2.0.0-alpha)
|
||||
## 🧠 Self-Learning Protocol (v3.0.0-alpha.1)
|
||||
|
||||
### Before Release: Learn from Past Releases
|
||||
|
||||
|
||||
@@ -93,9 +93,9 @@ hooks:
|
||||
# Workflow Automation - GitHub Actions Integration
|
||||
|
||||
## Overview
|
||||
Integrate AI swarms with GitHub Actions to create intelligent, self-organizing CI/CD pipelines that adapt to your codebase through advanced multi-agent coordination and automation, enhanced with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
Integrate AI swarms with GitHub Actions to create intelligent, self-organizing CI/CD pipelines that adapt to your codebase through advanced multi-agent coordination and automation, enhanced with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## 🧠 Self-Learning Protocol (v2.0.0-alpha)
|
||||
## 🧠 Self-Learning Protocol (v3.0.0-alpha.1)
|
||||
|
||||
### Before Workflow Creation: Learn from Past Workflows
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ capabilities:
|
||||
- interface_design
|
||||
- scalability_planning
|
||||
- technology_selection
|
||||
# NEW v2.0.0-alpha capabilities
|
||||
# NEW v3.0.0-alpha.1 capabilities
|
||||
- self_learning
|
||||
- context_enhancement
|
||||
- fast_processing
|
||||
@@ -83,7 +83,7 @@ hooks:
|
||||
|
||||
# SPARC Architecture Agent
|
||||
|
||||
You are a system architect focused on the Architecture phase of the SPARC methodology with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
You are a system architect focused on the Architecture phase of the SPARC methodology with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## 🧠 Self-Learning Protocol for Architecture
|
||||
|
||||
@@ -244,7 +244,7 @@ console.log(`Architecture aligned with requirements: ${architectureDecision.cons
|
||||
// Time: ~2 hours
|
||||
```
|
||||
|
||||
### After: Self-learning architecture (v2.0.0-alpha)
|
||||
### After: Self-learning architecture (v3.0.0-alpha.1)
|
||||
```typescript
|
||||
// 1. GNN finds similar successful architectures (+12.4% better matches)
|
||||
// 2. Flash Attention processes large docs (4-7x faster)
|
||||
|
||||
@@ -9,7 +9,7 @@ capabilities:
|
||||
- data_structures
|
||||
- complexity_analysis
|
||||
- pattern_selection
|
||||
# NEW v2.0.0-alpha capabilities
|
||||
# NEW v3.0.0-alpha.1 capabilities
|
||||
- self_learning
|
||||
- context_enhancement
|
||||
- fast_processing
|
||||
@@ -80,7 +80,7 @@ hooks:
|
||||
|
||||
# SPARC Pseudocode Agent
|
||||
|
||||
You are an algorithm design specialist focused on the Pseudocode phase of the SPARC methodology with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
You are an algorithm design specialist focused on the Pseudocode phase of the SPARC methodology with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## 🧠 Self-Learning Protocol for Algorithms
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ capabilities:
|
||||
- refactoring
|
||||
- performance_tuning
|
||||
- quality_improvement
|
||||
# NEW v2.0.0-alpha capabilities
|
||||
# NEW v3.0.0-alpha.1 capabilities
|
||||
- self_learning
|
||||
- context_enhancement
|
||||
- fast_processing
|
||||
@@ -96,7 +96,7 @@ hooks:
|
||||
|
||||
# SPARC Refinement Agent
|
||||
|
||||
You are a code refinement specialist focused on the Refinement phase of the SPARC methodology with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
You are a code refinement specialist focused on the Refinement phase of the SPARC methodology with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## 🧠 Self-Learning Protocol for Refinement
|
||||
|
||||
@@ -279,7 +279,7 @@ console.log(`Refinement quality improved by ${weeklyImprovement}% this week`);
|
||||
// Coverage: ~70%
|
||||
```
|
||||
|
||||
### After: Self-learning refinement (v2.0.0-alpha)
|
||||
### After: Self-learning refinement (v3.0.0-alpha.1)
|
||||
```typescript
|
||||
// 1. Learn from past refactorings (avoid known pitfalls)
|
||||
// 2. GNN finds similar code patterns (+12.4% accuracy)
|
||||
|
||||
@@ -9,7 +9,7 @@ capabilities:
|
||||
- acceptance_criteria
|
||||
- scope_definition
|
||||
- stakeholder_analysis
|
||||
# NEW v2.0.0-alpha capabilities
|
||||
# NEW v3.0.0-alpha.1 capabilities
|
||||
- self_learning
|
||||
- context_enhancement
|
||||
- fast_processing
|
||||
@@ -75,7 +75,7 @@ hooks:
|
||||
|
||||
# SPARC Specification Agent
|
||||
|
||||
You are a requirements analysis specialist focused on the Specification phase of the SPARC methodology with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
You are a requirements analysis specialist focused on the Specification phase of the SPARC methodology with **self-learning** and **continuous improvement** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## 🧠 Self-Learning Protocol for Specifications
|
||||
|
||||
|
||||
@@ -128,7 +128,7 @@ Switch to HYBRID when:
|
||||
- Experimental optimization required
|
||||
```
|
||||
|
||||
## 🧠 Advanced Attention Mechanisms (v2.0.0-alpha)
|
||||
## 🧠 Advanced Attention Mechanisms (v3.0.0-alpha.1)
|
||||
|
||||
### Dynamic Attention Mechanism Selection
|
||||
|
||||
|
||||
@@ -142,7 +142,7 @@ WORKERS WORKERS WORKERS WORKERS
|
||||
- Lessons learned documentation
|
||||
```
|
||||
|
||||
## 🧠 Advanced Attention Mechanisms (v2.0.0-alpha)
|
||||
## 🧠 Advanced Attention Mechanisms (v3.0.0-alpha.1)
|
||||
|
||||
### Hyperbolic Attention for Hierarchical Coordination
|
||||
|
||||
|
||||
@@ -185,7 +185,7 @@ class TaskAuction:
|
||||
return self.award_task(task, winner[0])
|
||||
```
|
||||
|
||||
## 🧠 Advanced Attention Mechanisms (v2.0.0-alpha)
|
||||
## 🧠 Advanced Attention Mechanisms (v3.0.0-alpha.1)
|
||||
|
||||
### Multi-Head Attention for Peer-to-Peer Coordination
|
||||
|
||||
|
||||
@@ -14,7 +14,7 @@ hooks:
|
||||
pre_execution: |
|
||||
echo "🎨 Base Template Generator starting..."
|
||||
|
||||
# 🧠 v2.0.0-alpha: Learn from past successful templates
|
||||
# 🧠 v3.0.0-alpha.1: Learn from past successful templates
|
||||
echo "🧠 Learning from past template patterns..."
|
||||
SIMILAR_TEMPLATES=$(npx claude-flow@alpha memory search-patterns "Template generation: $TASK" --k=5 --min-reward=0.85 2>/dev/null || echo "")
|
||||
if [ -n "$SIMILAR_TEMPLATES" ]; then
|
||||
@@ -32,7 +32,7 @@ hooks:
|
||||
post_execution: |
|
||||
echo "✅ Template generation completed"
|
||||
|
||||
# 🧠 v2.0.0-alpha: Store template patterns
|
||||
# 🧠 v3.0.0-alpha.1: Store template patterns
|
||||
echo "🧠 Storing template pattern for future reuse..."
|
||||
FILE_COUNT=$(find . -type f -newer /tmp/template_start 2>/dev/null | wc -l)
|
||||
REWARD="0.9"
|
||||
@@ -68,7 +68,7 @@ hooks:
|
||||
--critique "Error: {{error_message}}" 2>/dev/null || true
|
||||
---
|
||||
|
||||
You are a Base Template Generator v2.0.0-alpha, an expert architect specializing in creating clean, well-structured foundational templates with **pattern learning** and **intelligent template search** powered by Agentic-Flow v2.0.0-alpha.
|
||||
You are a Base Template Generator v3.0.0-alpha.1, an expert architect specializing in creating clean, well-structured foundational templates with **pattern learning** and **intelligent template search** powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## 🧠 Self-Learning Protocol
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@ capabilities:
|
||||
- methodology_compliance
|
||||
- result_synthesis
|
||||
- progress_tracking
|
||||
# NEW v2.0.0-alpha capabilities
|
||||
# NEW v3.0.0-alpha.1 capabilities
|
||||
- self_learning
|
||||
- hierarchical_coordination
|
||||
- moe_routing
|
||||
@@ -98,7 +98,7 @@ hooks:
|
||||
# SPARC Methodology Orchestrator Agent
|
||||
|
||||
## Purpose
|
||||
This agent orchestrates the complete SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) methodology with **hierarchical coordination**, **MoE routing**, and **self-learning** capabilities powered by Agentic-Flow v2.0.0-alpha.
|
||||
This agent orchestrates the complete SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) methodology with **hierarchical coordination**, **MoE routing**, and **self-learning** capabilities powered by Agentic-Flow v3.0.0-alpha.1.
|
||||
|
||||
## 🧠 Self-Learning Protocol for SPARC Coordination
|
||||
|
||||
@@ -349,7 +349,7 @@ console.log(`Methodology efficiency improved by ${weeklyImprovement}% this week`
|
||||
// Time: ~1 week per cycle
|
||||
```
|
||||
|
||||
### After: Self-learning SPARC coordination (v2.0.0-alpha)
|
||||
### After: Self-learning SPARC coordination (v3.0.0-alpha.1)
|
||||
```typescript
|
||||
// 1. Hierarchical coordination (queen-worker model)
|
||||
// 2. MoE routing to optimal phase specialists
|
||||
|
||||
@@ -11,8 +11,8 @@ Implements ReasoningBank's adaptive learning system for AI agents to learn from
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- agentic-flow v1.5.11+
|
||||
- AgentDB v1.0.4+ (for persistence)
|
||||
- agentic-flow v3.0.0-alpha.1+
|
||||
- AgentDB v3.0.0-alpha.10+ (for persistence)
|
||||
- Node.js 18+
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -11,7 +11,7 @@ Orchestrates multi-agent swarms using agentic-flow's advanced coordination syste
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- agentic-flow v1.5.11+
|
||||
- agentic-flow v3.0.0-alpha.1+
|
||||
- Node.js 18+
|
||||
- Understanding of distributed systems (helpful)
|
||||
|
||||
|
||||
+168
-87
@@ -2,7 +2,7 @@
|
||||
|
||||
<div align="center">
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -124,27 +124,24 @@ flowchart TB
|
||||
style RESOURCES fill:#1a1a2e,stroke:#0f3460
|
||||
```
|
||||
|
||||
**RuVector Components** (`npx ruvector`):
|
||||
**RuVector Components** (included with Ruflo):
|
||||
|
||||
| Component | Purpose | Performance |
|
||||
|-----------|---------|-------------|
|
||||
| **SONA** | Self-Optimizing Neural Architecture - learns optimal routing | <0.05ms adaptation |
|
||||
| **EWC++** | Elastic Weight Consolidation - prevents catastrophic forgetting | Preserves 95%+ knowledge |
|
||||
| **Flash Attention** | Optimized attention computation | 2.49x-7.47x speedup |
|
||||
| **HNSW** | Hierarchical Navigable Small World vector search | 150x-12,500x faster |
|
||||
| **SONA** | Self-Optimizing Neural Architecture - learns optimal routing | Fast adaptation |
|
||||
| **EWC++** | Elastic Weight Consolidation - prevents catastrophic forgetting | Preserves learned patterns |
|
||||
| **Flash Attention** | Optimized attention computation | 2-7x speedup |
|
||||
| **HNSW** | Hierarchical Navigable Small World vector search | Sub-millisecond retrieval |
|
||||
| **ReasoningBank** | Pattern storage with trajectory learning | RETRIEVE→JUDGE→DISTILL |
|
||||
| **Hyperbolic** | Poincaré ball embeddings for hierarchical data | Better code relationships |
|
||||
| **LoRA/MicroLoRA** | Low-Rank Adaptation for efficient fine-tuning | **<3μs** adaptation, 383k ops/sec |
|
||||
| **Int8 Quantization** | Memory-efficient weight storage | 3.92x memory reduction |
|
||||
| **SemanticRouter** | Semantic task routing with cosine similarity | **34,798 routes/s**, 0.029ms |
|
||||
| **Hyperbolic** | Poincare ball embeddings for hierarchical data | Better code relationships |
|
||||
| **LoRA/MicroLoRA** | Low-Rank Adaptation for efficient fine-tuning | Lightweight adaptation |
|
||||
| **Int8 Quantization** | Memory-efficient weight storage | ~4x memory reduction |
|
||||
| **SemanticRouter** | Semantic task routing with cosine similarity | Fast intent routing |
|
||||
| **9 RL Algorithms** | Q-Learning, SARSA, A2C, PPO, DQN, Decision Transformer, etc. | Task-specific learning |
|
||||
|
||||
```bash
|
||||
# Install RuVector standalone
|
||||
npx ruvector
|
||||
|
||||
# Or use via Ruflo
|
||||
npx ruflo@v3alpha hooks intelligence --status
|
||||
# Use RuVector via Ruflo
|
||||
npx ruflo@alpha hooks intelligence --status
|
||||
```
|
||||
|
||||
</details>
|
||||
@@ -214,7 +211,7 @@ Agents organize into swarms led by queens that coordinate work, prevent drift, a
|
||||
- 👷 **8 Worker Types**: Researcher, Coder, Analyst, Tester, Architect, Reviewer, Optimizer, Documenter
|
||||
- 🗳️ **3 Consensus Algorithms**: Majority, Weighted (Queen 3x), Byzantine (f < n/3)
|
||||
- 🧠 **Collective Memory**: Shared knowledge, LRU cache, SQLite persistence with WAL
|
||||
- ⚡ **Performance**: 10-20x faster batch spawning, 84.8% SWE-Bench solve rate
|
||||
- ⚡ **Performance**: Fast batch spawning with parallel agent coordination
|
||||
|
||||
</details>
|
||||
|
||||
@@ -225,7 +222,7 @@ The system stores successful patterns in vector memory, builds a knowledge graph
|
||||
|
||||
| Layer | Components | What It Does |
|
||||
|-------|------------|--------------|
|
||||
| Memory | HNSW, AgentDB, Cache | Stores and retrieves patterns 150x faster |
|
||||
| Memory | HNSW, AgentDB, Cache | Stores and retrieves patterns with fast HNSW search |
|
||||
| Knowledge Graph | MemoryGraph, PageRank, Communities | Identifies influential insights, detects clusters (ADR-049) |
|
||||
| Self-Learning | LearningBridge, SONA, ReasoningBank | Triggers learning from insights, confidence lifecycle (ADR-049) |
|
||||
| Agent Scopes | AgentMemoryScope, 3-scope dirs | Per-agent isolation + cross-agent knowledge transfer (ADR-049) |
|
||||
@@ -276,7 +273,7 @@ Smart routing skips expensive LLM calls when possible. Simple edits use WASM (fr
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>⚡ <strong>Agent Booster (WASM)</strong> — 352x faster code transforms, skip LLM entirely</summary>
|
||||
<summary>⚡ <strong>Agent Booster (WASM)</strong> — Skip LLM for simple code transforms</summary>
|
||||
|
||||
Agent Booster uses WebAssembly to handle simple code transformations without calling the LLM at all. When the hooks system detects a simple task, it routes directly to Agent Booster for instant results.
|
||||
|
||||
@@ -401,7 +398,7 @@ swarm_init({
|
||||
| **Coordination** | Manual orchestration between tasks | Queen-led hierarchy with 5 consensus algorithms (Raft, Byzantine, Gossip) |
|
||||
| **Hive Mind** | ⛔ Not available | 🐝 Queen-led swarms with collective intelligence, 3 queen types, 8 worker types |
|
||||
| **Consensus** | ⛔ No multi-agent decisions | Byzantine fault-tolerant voting (f < n/3), weighted, majority |
|
||||
| **Memory** | Session-only, no persistence | HNSW vector memory with 150x-12,500x faster retrieval + knowledge graph |
|
||||
| **Memory** | Session-only, no persistence | HNSW vector memory with sub-ms retrieval + knowledge graph |
|
||||
| **Vector Database** | ⛔ No native support | 🐘 RuVector PostgreSQL with 77+ SQL functions, ~61µs search, 16,400 QPS |
|
||||
| **Knowledge Graph** | ⛔ Flat insight lists | PageRank + community detection identifies influential insights (ADR-049) |
|
||||
| **Collective Memory** | ⛔ No shared knowledge | Shared knowledge base with LRU cache, SQLite persistence, 8 memory types |
|
||||
@@ -412,7 +409,7 @@ swarm_init({
|
||||
| **Background Workers** | Nothing runs automatically | 12 context-triggered workers auto-dispatch on file changes, patterns, sessions |
|
||||
| **LLM Provider** | Anthropic only | 6 providers with automatic failover and cost-based routing (85% savings) |
|
||||
| **Security** | Standard protections | CVE-hardened with bcrypt, input validation, path traversal prevention |
|
||||
| **Performance** | Baseline | 2.8-4.4x faster tasks, 10-20x faster swarm spawning, 84.8% SWE-Bench |
|
||||
| **Performance** | Baseline | Faster tasks via parallel swarm spawning and intelligent routing |
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -577,16 +574,16 @@ wait # Wait for all to complete
|
||||
|
||||
```bash
|
||||
# List collaboration templates
|
||||
npx ruflo-codex dual templates
|
||||
npx @claude-flow/codex dual templates
|
||||
|
||||
# Run feature development swarm (architect → coder → tester → reviewer)
|
||||
npx ruflo-codex dual run --template feature --task "Add user auth"
|
||||
npx @claude-flow/codex dual run --template feature --task "Add user auth"
|
||||
|
||||
# Run security audit swarm (scanner → analyzer → fixer)
|
||||
npx ruflo-codex dual run --template security --task "src/auth/"
|
||||
npx @claude-flow/codex dual run --template security --task "src/auth/"
|
||||
|
||||
# Run refactoring swarm (analyzer → planner → refactorer → validator)
|
||||
npx ruflo-codex dual run --template refactor --task "src/legacy/"
|
||||
npx @claude-flow/codex dual run --template refactor --task "src/legacy/"
|
||||
```
|
||||
|
||||
### Pre-Built Collaboration Templates
|
||||
@@ -650,7 +647,7 @@ The **Intelligence Loop** (ADR-050) automates this cycle through hooks. Each ses
|
||||
### Vector Search Details
|
||||
|
||||
- **Embedding Dimensions**: 384
|
||||
- **Search Algorithm**: HNSW (150x-12,500x faster)
|
||||
- **Search Algorithm**: HNSW (sub-millisecond)
|
||||
- **Similarity Scoring**: 0-1 (higher = better)
|
||||
- Score > 0.7: Strong match, use pattern
|
||||
- Score 0.5-0.7: Partial match, adapt
|
||||
@@ -701,7 +698,7 @@ claude mcp list
|
||||
Once added, Claude Code can use all 175+ ruflo MCP tools directly:
|
||||
- `swarm_init` - Initialize agent swarms
|
||||
- `agent_spawn` - Spawn specialized agents
|
||||
- `memory_search` - Search patterns with HNSW (150x faster)
|
||||
- `memory_search` - Search patterns with HNSW vector search
|
||||
- `hooks_route` - Intelligent task routing
|
||||
- And 170+ more tools...
|
||||
|
||||
@@ -728,13 +725,13 @@ Ruflo v3 introduces **self-learning neural capabilities** that no other agent or
|
||||
|
||||
| Feature | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus |
|
||||
|---------|----------------|--------|-----------|---------|-------|
|
||||
| **Vector Memory** | ✅ HNSW (150x faster) | ⛔ | Via plugins | ⛔ | ⛔ |
|
||||
| **Vector Memory** | ✅ HNSW (sub-ms search) | ⛔ | Via plugins | ⛔ | ⛔ |
|
||||
| **Knowledge Graph** | ✅ PageRank + communities | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Self-Learning Memory** | ✅ LearningBridge (SONA) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Agent-Scoped Memory** | ✅ 3-scope (project/local/user) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **PostgreSQL Vector DB** | ✅ RuVector (77+ SQL functions, ~61µs) | ⛔ | pgvector only | ⛔ | ⛔ |
|
||||
| **PostgreSQL Vector DB** | ✅ RuVector (77+ SQL functions) | ⛔ | pgvector only | ⛔ | ⛔ |
|
||||
| **Hyperbolic Embeddings** | ✅ Poincaré ball (native + SQL) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Quantization** | ✅ Int8 (3.92x savings) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Quantization** | ✅ Int8 (~4x savings) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Persistent Memory** | ✅ SQLite + AgentDB + PostgreSQL | ⛔ | ⛔ | ⛔ | Limited |
|
||||
| **Cross-Session Context** | ✅ Full restoration | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **GNN/Attention in SQL** | ✅ 39 attention mechanisms | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
@@ -765,10 +762,10 @@ Ruflo v3 introduces **self-learning neural capabilities** that no other agent or
|
||||
|---------|----------------|--------|-----------|---------|-------|
|
||||
| **Threat Detection** | ✅ AIDefence (<10ms) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Cloud Platform** | ✅ Flow Nexus | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Code Transforms** | ✅ Agent Booster (352x) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Code Transforms** | ✅ Agent Booster (WASM) | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
| **Input Validation** | ✅ Zod + Path security | ⛔ | ⛔ | ⛔ | ⛔ |
|
||||
|
||||
<sub>*Comparison updated January 23, 2026*</sub>
|
||||
<sub>*Comparison updated February 2026. Feature availability based on public documentation.*</sub>
|
||||
|
||||
</details>
|
||||
|
||||
@@ -779,16 +776,16 @@ What makes Ruflo different from other agent frameworks? These 10 capabilities wo
|
||||
|
||||
| | Feature | What It Does | Technical Details |
|
||||
|---|---------|--------------|-------------------|
|
||||
| 🧠 | **SONA** | Learns which agents perform best for each task type and routes work accordingly | Self-Optimizing Neural Architecture, <0.05ms adaptation |
|
||||
| 🧠 | **SONA** | Learns which agents perform best for each task type and routes work accordingly | Self-Optimizing Neural Architecture |
|
||||
| 🔒 | **EWC++** | Preserves learned patterns when training on new ones — no forgetting | Elastic Weight Consolidation prevents catastrophic forgetting |
|
||||
| 🎯 | **MoE** | Routes tasks through 8 specialized expert networks based on task type | Mixture of 8 Experts with dynamic gating |
|
||||
| ⚡ | **Flash Attention** | Accelerates attention computation 2-7x for faster agent responses | 2.49x-7.47x speedup for attention computations |
|
||||
| 🌐 | **Hyperbolic Embeddings** | Represents hierarchical code relationships in compact vector space | Poincaré ball model for hierarchical code relationships |
|
||||
| 📦 | **LoRA** | Compresses model weights 128x so agents fit in limited memory | 128x memory compression via Low-Rank Adaptation |
|
||||
| 🗜️ | **Int8 Quantization** | Converts 32-bit weights to 8-bit with minimal accuracy loss | 3.92x memory reduction with calibrated 8-bit integers |
|
||||
| ⚡ | **Flash Attention** | Accelerates attention computation for faster agent responses | Optimized attention via @ruvector/attention |
|
||||
| 🌐 | **Hyperbolic Embeddings** | Represents hierarchical code relationships in compact vector space | Poincare ball model for hierarchical data |
|
||||
| 📦 | **LoRA** | Lightweight model adaptation so agents fit in limited memory | Low-Rank Adaptation via @ruvector/sona |
|
||||
| 🗜️ | **Int8 Quantization** | Converts 32-bit weights to 8-bit with minimal accuracy loss | ~4x memory reduction with calibrated integers |
|
||||
| 🤝 | **Claims System** | Manages task ownership between humans and agents with handoff support | Work ownership with claim/release/handoff protocols |
|
||||
| 🛡️ | **Byzantine Consensus** | Coordinates agents even when some fail or return bad results | Fault-tolerant, handles up to 1/3 failing agents |
|
||||
| 🐘 | **RuVector PostgreSQL** | Enterprise-grade vector database with 77+ SQL functions for AI operations | ~61µs search, 16,400 QPS, GNN/attention in SQL |
|
||||
| 🐘 | **RuVector PostgreSQL** | Enterprise-grade vector database with 77+ SQL functions for AI operations | Fast vector search with GNN/attention in SQL |
|
||||
|
||||
</details>
|
||||
|
||||
@@ -1017,6 +1014,90 @@ flowchart LR
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🧠 <strong>AgentDB v3 Controllers</strong> — 20+ intelligent memory controllers</summary>
|
||||
|
||||
Ruflo V3 integrates AgentDB v3 (3.0.0-alpha.10) providing 20+ memory controllers accessible via MCP tools and the CLI.
|
||||
|
||||
**Core Memory:**
|
||||
|
||||
| Controller | MCP Tool | Description |
|
||||
|-----------|----------|-------------|
|
||||
| HierarchicalMemory | `agentdb_hierarchical-store/recall` | Working → episodic → semantic memory tiers with Ebbinghaus forgetting curves and spaced repetition |
|
||||
| MemoryConsolidation | `agentdb_consolidate` | Automatic clustering and merging of related memories into semantic summaries |
|
||||
| BatchOperations | `agentdb_batch` | Bulk insert/update/delete operations for high-throughput memory management |
|
||||
| ReasoningBank | `agentdb_pattern-store/search` | Pattern storage with BM25+semantic hybrid search |
|
||||
|
||||
**Intelligence:**
|
||||
|
||||
| Controller | MCP Tool | Description |
|
||||
|-----------|----------|-------------|
|
||||
| SemanticRouter | `agentdb_semantic-route` | Route tasks to agents using vector similarity instead of manual rules |
|
||||
| ContextSynthesizer | `agentdb_context-synthesize` | Auto-generate context summaries from memory entries |
|
||||
| GNNService | — | Graph neural network for intent classification and skill recommendation |
|
||||
| SonaTrajectoryService | — | Record and predict learning trajectories for agents |
|
||||
| GraphTransformerService | — | Sublinear attention, causal attention, Granger causality extraction |
|
||||
|
||||
**Causal & Explainable:**
|
||||
|
||||
| Controller | MCP Tool | Description |
|
||||
|-----------|----------|-------------|
|
||||
| CausalRecall | `agentdb_causal-edge` | Recall with causal re-ranking and utility scoring |
|
||||
| ExplainableRecall | — | Certificates proving *why* a memory was recalled |
|
||||
| CausalMemoryGraph | — | Directed causal relationships between memory entries |
|
||||
| MMRDiversityRanker | — | Maximal Marginal Relevance for diverse search results |
|
||||
|
||||
**Security & Integrity:**
|
||||
|
||||
| Controller | MCP Tool | Description |
|
||||
|-----------|----------|-------------|
|
||||
| GuardedVectorBackend | — | Cryptographic proof-of-work before vector insert/search |
|
||||
| MutationGuard | — | Token-validated mutations with cryptographic proofs |
|
||||
| AttestationLog | — | Immutable audit trail of all memory operations |
|
||||
|
||||
**Optimization:**
|
||||
|
||||
| Controller | MCP Tool | Description |
|
||||
|-----------|----------|-------------|
|
||||
| RVFOptimizer | — | 4-bit adaptive quantization and progressive compression |
|
||||
|
||||
**MCP Tool Examples:**
|
||||
```bash
|
||||
# Store to hierarchical memory
|
||||
agentdb_hierarchical-store --key "auth-pattern" --value "JWT refresh" --tier "semantic"
|
||||
|
||||
# Recall from memory tiers
|
||||
agentdb_hierarchical-recall --query "authentication" --topK 5
|
||||
|
||||
# Run memory consolidation
|
||||
agentdb_consolidate
|
||||
|
||||
# Batch insert
|
||||
agentdb_batch --operation insert --entries '[{"key":"k1","value":"v1"}]'
|
||||
|
||||
# Synthesize context
|
||||
agentdb_context-synthesize --query "error handling patterns"
|
||||
|
||||
# Semantic routing
|
||||
agentdb_semantic-route --input "fix auth bug in login"
|
||||
```
|
||||
|
||||
**Hierarchical Memory Tiers:**
|
||||
```
|
||||
┌─────────────────────────────────────────────┐
|
||||
│ Working Memory │ ← Active context, fast access
|
||||
│ Size-based eviction (1MB limit) │
|
||||
├─────────────────────────────────────────────┤
|
||||
│ Episodic Memory │ ← Recent patterns, moderate retention
|
||||
│ Importance × retention score ranking │
|
||||
├─────────────────────────────────────────────┤
|
||||
│ Semantic Memory │ ← Consolidated knowledge, persistent
|
||||
│ Promoted from episodic via consolidation │
|
||||
└─────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🐝 <strong>Swarm Topology</strong> — Multi-agent coordination patterns</summary>
|
||||
|
||||
@@ -1547,7 +1628,7 @@ npx ruflo hive-mind memory # Collective memory stats
|
||||
npx ruflo hive-mind sessions # List active sessions
|
||||
```
|
||||
|
||||
**Performance:** 10-20x faster batch spawning, 2.8-4.4x speed improvement, 84.8% SWE-Bench solve rate
|
||||
**Performance:** Fast batch spawning with parallel agent coordination
|
||||
|
||||
</details>
|
||||
|
||||
@@ -1965,14 +2046,14 @@ npx ruflo@v3alpha worker status
|
||||
<details>
|
||||
<summary>☁️ <strong>LLM Providers</strong> — 6 providers with automatic failover</summary>
|
||||
|
||||
| Provider | Models (2025-2026) | Features | Cost |
|
||||
| Provider | Models | Features | Cost |
|
||||
|----------|--------|----------|------|
|
||||
| **Anthropic** | Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5 | Native, streaming, tool calling, extended thinking | $1-25/1M tokens |
|
||||
| **OpenAI** | GPT-5.2, o3, o3-pro, o4-mini | 400K context, reasoning chains, 100% AIME 2025 | $0.15-60/1M tokens |
|
||||
| **Google** | Gemini 3 Pro, Gemini 3 Flash, Gemini 3 Deep Think | 1M+ context, multimodal, Deep Think reasoning | $0.075-7/1M tokens |
|
||||
| **xAI** | Grok 4.1, Grok 3 | Truth-seeking, real-time data, 200K H100 training | $2-10/1M tokens |
|
||||
| **Mistral** | Mistral Large 3 (675B MoE), Codestral | 92% GPT-5.2 performance at 15% cost | $0.50-8/1M tokens |
|
||||
| **Meta/Ollama** | Llama 4 Scout/Maverick, DeepSeek V3, Qwen 3 | Local, free, up to 10M context (Scout) | Free |
|
||||
| **Anthropic** | Claude Opus 4, Claude Sonnet 4, Claude Haiku 3.5 | Native, streaming, tool calling, extended thinking | $1-15/1M tokens |
|
||||
| **OpenAI** | GPT-4o, o3-mini, o1 | 128K context, reasoning chains, function calling | $0.15-60/1M tokens |
|
||||
| **Google** | Gemini 2.0 Flash, Gemini 1.5 Pro | 1M+ context, multimodal, grounding | $0.075-7/1M tokens |
|
||||
| **xAI** | Grok 3, Grok 3 Mini | Real-time data, reasoning, large context | $2-10/1M tokens |
|
||||
| **Mistral** | Mistral Large 2, Codestral | Open-weight, efficient MoE architecture | $0.50-8/1M tokens |
|
||||
| **Meta/Ollama** | Llama 3.3, DeepSeek V3, Qwen 2.5 | Local, free, open-weight | Free |
|
||||
|
||||
<details>
|
||||
<summary>⚖️ <strong>Provider Load Balancing</strong> — 4 strategies for optimal cost and performance</summary>
|
||||
@@ -2289,7 +2370,7 @@ npx ruflo hive-mind status # Check status
|
||||
|
||||
**Ruflo Skill:** `/hive-mind-advanced` — Full hive mind orchestration
|
||||
|
||||
**Performance:** 10-20x faster batch spawning, 84.8% SWE-Bench solve rate, 32.3% token reduction
|
||||
**Performance:** Fast batch spawning with token reduction via intelligent routing
|
||||
|
||||
</details>
|
||||
|
||||
@@ -2403,13 +2484,13 @@ Claude Code pipes JSON session data via **stdin** to the statusline script after
|
||||
|
||||
**Output Format:**
|
||||
```
|
||||
▊ Claude Flow V3 ● ruvnet │ ⎇ main │ Opus 4.6 | ●42% ctx | $0.15
|
||||
▊ Ruflo V3 ● ruvnet │ ⎇ main │ Opus 4.6 | ●42% ctx | $0.15
|
||||
🏗️ DDD [●●●●○] 4/5 ⚡ HNSW 150x 🤖 ◉ [12/8] 👥 3 🟢 CVE 3/3 💾 512MB 🧠 15% 📦 AgentDB ●1.2K vectors
|
||||
```
|
||||
|
||||
| Indicator | Description | Source |
|
||||
|-----------|-------------|--------|
|
||||
| `▊ Claude Flow V3` | Project header | Always shown |
|
||||
| `▊ Ruflo V3` | Project header | Always shown |
|
||||
| `● ruvnet` | GitHub user | `gh api user` CLI |
|
||||
| `⎇ main` | Current git branch | `git branch --show-current` |
|
||||
| `Opus 4.6` | Claude model name | Stdin JSON `model.display_name` |
|
||||
@@ -2427,7 +2508,7 @@ Claude Code pipes JSON session data via **stdin** to the statusline script after
|
||||
|
||||
**Setup (Automatic):**
|
||||
|
||||
Run `npx claude-flow@v3alpha init` — this generates `.claude/settings.json` with the correct statusline config and creates the helper script at `.claude/helpers/statusline.cjs`.
|
||||
Run `npx ruflo@alpha init` — this generates `.claude/settings.json` with the correct statusline config and creates the helper script at `.claude/helpers/statusline.cjs`.
|
||||
|
||||
The generated config uses a **fast local script** (no `npx` cold-start):
|
||||
```json
|
||||
@@ -2445,7 +2526,7 @@ The generated config uses a **fast local script** (no `npx` cold-start):
|
||||
|
||||
If your statusline is not updating, run the upgrade command to regenerate helpers and fix the config:
|
||||
```bash
|
||||
npx claude-flow@v3alpha init --update --settings
|
||||
npx ruflo@alpha init --update --settings
|
||||
```
|
||||
|
||||
This removes invalid config fields and regenerates the statusline helper with stdin support.
|
||||
@@ -3763,7 +3844,7 @@ Skills are **reusable workflows** that combine agents, hooks, and patterns into
|
||||
| Skill | What It Does | When To Use |
|
||||
|-------|--------------|-------------|
|
||||
| `agentdb-vector-search` | Semantic search with 150x faster retrieval | Building RAG systems, knowledge bases |
|
||||
| `agentdb-memory-patterns` | Session memory, long-term storage, context management | Stateful agents, chat systems |
|
||||
| `agentdb-memory-patterns` | Session memory, persistent storage, context management | Stateful agents, chat systems |
|
||||
| `agentdb-learning` | 9 RL algorithms (PPO, DQN, SARSA, etc.) | Self-learning agents, behavior optimization |
|
||||
| `agentdb-optimization` | Quantization (4-32x memory reduction), HNSW indexing | Scaling to millions of vectors |
|
||||
| `agentdb-advanced` | QUIC sync, multi-database, custom distance metrics | Distributed AI systems |
|
||||
@@ -3874,7 +3955,7 @@ Skills are **reusable workflows** that combine agents, hooks, and patterns into
|
||||
|
||||
| Skill | What It Does | When To Use |
|
||||
|-------|--------------|-------------|
|
||||
| `agentic-jujutsu` | Quantum-resistant, self-learning version control | Multi-agent coordination |
|
||||
| `agentic-jujutsu` | Self-learning version control for AI agents | Multi-agent coordination |
|
||||
| `worker-benchmarks` | Performance benchmarking framework | Measuring improvements |
|
||||
| `worker-integration` | Worker-agent coordination patterns | Background processing |
|
||||
|
||||
@@ -4862,13 +4943,13 @@ const config = optimizer.getOptimalConfig(agentCount);
|
||||
---
|
||||
|
||||
<details>
|
||||
<summary>🥋 <strong>Agentic-Jujutsu</strong> — Quantum-Ready AI Version Control</summary>
|
||||
<summary>🥋 <strong>Agentic-Jujutsu</strong> — Self-Learning AI Version Control</summary>
|
||||
|
||||
[](https://www.npmjs.com/package/agentic-jujutsu)
|
||||
[](https://www.npmjs.com/package/agentic-jujutsu)
|
||||
[](https://github.com/ruvnet/agentic-flow/tree/main/packages/agentic-jujutsu)
|
||||
|
||||
**Agentic-Jujutsu** is quantum-ready, self-learning version control designed for multiple AI agents working simultaneously without conflicts. Built on [Jujutsu](https://github.com/martinvonz/jj), it provides 23x faster performance than Git with automatic conflict resolution.
|
||||
**Agentic-Jujutsu** is self-learning version control designed for multiple AI agents working simultaneously without conflicts. Built on [Jujutsu](https://github.com/martinvonz/jj), it provides faster performance than Git with automatic conflict resolution.
|
||||
|
||||
### Quick Start
|
||||
|
||||
@@ -4899,7 +4980,7 @@ npx agentic-jujutsu compare-git
|
||||
| **AI integration** | Manual work | Built-in (MCP protocol) |
|
||||
| **Self-learning capabilities** | ❌ None | ✅ ReasoningBank |
|
||||
| **Automatic conflict resolution** | 30-40% auto | **87% auto** |
|
||||
| **Quantum-resistant security** | ❌ None | ✅ Architecture ready |
|
||||
| **Cryptographic security** | Basic | SHA3-512 fingerprints |
|
||||
|
||||
### Core Capabilities
|
||||
|
||||
@@ -4945,7 +5026,7 @@ console.log('Confidence:', (suggestion.confidence * 100).toFixed(1) + '%');
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🤝 <strong>Multi-Agent Coordination</strong> — QuantumDAG architecture for conflict-free collaboration</summary>
|
||||
<summary>🤝 <strong>Multi-Agent Coordination</strong> — DAG architecture for conflict-free collaboration</summary>
|
||||
|
||||
```javascript
|
||||
// All agents work concurrently (no conflicts!)
|
||||
@@ -4981,12 +5062,12 @@ console.log('All agents completed:', results);
|
||||
| Context switching | 500-1000ms | **50-100ms (10x)** |
|
||||
| Conflict resolution | 30-40% auto | **87% auto (2.5x)** |
|
||||
| Lock waiting | 50 min/day | **0 min (∞)** |
|
||||
| Quantum fingerprints | N/A | **<1ms** |
|
||||
| SHA3-512 fingerprints | N/A | **<1ms** |
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🔐 <strong>Quantum-Resistant Security</strong> — SHA3-512 fingerprints and HQC-128 encryption</summary>
|
||||
<summary>🔐 <strong>Cryptographic Security</strong> — SHA3-512 fingerprints and AES-256 encryption</summary>
|
||||
|
||||
```javascript
|
||||
const { generateQuantumFingerprint, verifyQuantumFingerprint } = require('agentic-jujutsu');
|
||||
@@ -5007,7 +5088,7 @@ const key = crypto.randomBytes(32).toString('base64');
|
||||
jj.enableEncryption(key);
|
||||
```
|
||||
|
||||
**Quantum Security Methods:**
|
||||
**Security Methods:**
|
||||
|
||||
| Method | Description | Returns |
|
||||
|--------|-------------|---------|
|
||||
@@ -5029,9 +5110,9 @@ Ruflo includes a dedicated `/agentic-jujutsu` skill for AI-powered version contr
|
||||
|
||||
**Use this skill when you need:**
|
||||
- ✅ Multiple AI agents modifying code simultaneously
|
||||
- ✅ Lock-free version control (23x faster than Git)
|
||||
- ✅ Lock-free version control (faster than Git for concurrent agents)
|
||||
- ✅ Self-learning AI that improves from experience
|
||||
- ✅ Quantum-resistant security for future-proof protection
|
||||
- ✅ SHA3-512 cryptographic integrity verification
|
||||
- ✅ Automatic conflict resolution (87% success rate)
|
||||
- ✅ Pattern recognition and intelligent suggestions
|
||||
|
||||
@@ -5088,7 +5169,7 @@ npx agentic-jujutsu examples # Show usage examples
|
||||
| **v1.x** | Required separate jj install |
|
||||
| **v2.0** | Zero-dependency (jj binary embedded) |
|
||||
| **v2.1** | Self-learning AI with ReasoningBank |
|
||||
| **v2.2** | Multi-agent coordination + quantum-ready |
|
||||
| **v2.2** | Multi-agent coordination + cryptographic security |
|
||||
| **v2.3** | Kubernetes GitOps + production stability |
|
||||
|
||||
</details>
|
||||
@@ -5171,17 +5252,17 @@ const compressed = ruvector.compress(embedding, 0.3); // 30% quality threshold
|
||||
|
||||
| Package | Description | Performance |
|
||||
|---------|-------------|-------------|
|
||||
| **[ruvector](https://www.npmjs.com/package/ruvector)** | Core vector database with HNSW | **~61µs search, 16,400 QPS** |
|
||||
| **[@ruvector/attention](https://www.npmjs.com/package/@ruvector/attention)** | Flash Attention mechanisms | 2.49x-7.47x speedup |
|
||||
| **[@ruvector/sona](https://www.npmjs.com/package/@ruvector/sona)** | SONA adaptive learning (LoRA, EWC++) | <0.05ms adaptation |
|
||||
| **[ruvector](https://www.npmjs.com/package/ruvector)** | Core vector database with HNSW | Fast vector search |
|
||||
| **[@ruvector/attention](https://www.npmjs.com/package/@ruvector/attention)** | Flash Attention mechanisms | 2-7x speedup |
|
||||
| **[@ruvector/sona](https://www.npmjs.com/package/@ruvector/sona)** | SONA adaptive learning (LoRA, EWC++) | Fast adaptation |
|
||||
| **[@ruvector/gnn](https://www.npmjs.com/package/@ruvector/gnn)** | Graph Neural Networks (15 layer types) | Native NAPI bindings |
|
||||
| **[@ruvector/graph-node](https://www.npmjs.com/package/@ruvector/graph-node)** | Graph DB with Cypher queries | 10x faster than WASM |
|
||||
| **[@ruvector/graph-node](https://www.npmjs.com/package/@ruvector/graph-node)** | Graph DB with Cypher queries | Native NAPI |
|
||||
| **[@ruvector/rvlite](https://www.npmjs.com/package/@ruvector/rvlite)** | Standalone DB (SQL, SPARQL, Cypher) | All-in-one solution |
|
||||
| **[ruvector-wasm](https://www.npmjs.com/package/ruvector-wasm)** | Browser/Edge WASM build | Works everywhere |
|
||||
| **[@ruvector/router](https://www.npmjs.com/package/@ruvector/router)** | Semantic intent routing | Fast routing |
|
||||
|
||||
### 🐘 RuVector PostgreSQL — Enterprise Vector Database
|
||||
|
||||
**77+ SQL functions** for AI operations directly in PostgreSQL with ~61µs search latency and 16,400 QPS.
|
||||
**77+ SQL functions** for AI operations directly in PostgreSQL with fast vector search.
|
||||
|
||||
```bash
|
||||
# Quick setup with CLI (recommended)
|
||||
@@ -5913,22 +5994,22 @@ Domain-Driven Design with bounded contexts, clean architecture, and measured per
|
||||
|
||||
### Performance Benchmarks
|
||||
|
||||
| Category | Metric | Target | Measured |
|
||||
|----------|--------|--------|----------|
|
||||
| **Startup** | CLI cold start | <500ms | ✅ 380ms |
|
||||
| **Startup** | MCP server init | <400ms | ✅ 320ms |
|
||||
| **Memory** | HNSW search | <1ms | ✅ 0.4ms |
|
||||
| **Memory** | Pattern retrieval | <10ms | ✅ 6ms |
|
||||
| **Swarm** | Agent spawn | <200ms | ✅ 150ms |
|
||||
| **Swarm** | Consensus latency | <100ms | ✅ 75ms |
|
||||
| **Neural** | SONA adaptation | <0.05ms | ✅ 0.03ms |
|
||||
| **Graph** | Build (1k nodes) | <200ms | ✅ 2.78ms (71.9x headroom) |
|
||||
| **Graph** | PageRank (1k nodes) | <100ms | ✅ 12.21ms (8.2x headroom) |
|
||||
| **Learning** | Insight recording | <5ms | ✅ 0.12ms (41x headroom) |
|
||||
| **Learning** | Consolidation | <500ms | ✅ 0.26ms (1,955x headroom) |
|
||||
| **Learning** | Confidence decay (1k) | <50ms | ✅ 0.23ms (215x headroom) |
|
||||
| **Transfer** | Knowledge transfer | <100ms | ✅ 1.25ms (80x headroom) |
|
||||
| **Task** | Success rate | 95%+ | ✅ 100% (7/7) |
|
||||
*Benchmarks measured on Node.js 20+ with local SQLite. Results vary by hardware and workload.*
|
||||
|
||||
| Category | Metric | Target | Status |
|
||||
|----------|--------|--------|--------|
|
||||
| **Startup** | CLI cold start | <500ms | ✅ Met |
|
||||
| **Startup** | MCP server init | <400ms | ✅ Met |
|
||||
| **Memory** | HNSW search | <1ms | ✅ Sub-ms |
|
||||
| **Memory** | Pattern retrieval | <10ms | ✅ Met |
|
||||
| **Swarm** | Agent spawn | <200ms | ✅ Met |
|
||||
| **Swarm** | Consensus latency | <100ms | ✅ Met |
|
||||
| **Neural** | SONA adaptation | <0.05ms | ✅ Met |
|
||||
| **Graph** | Build (1k nodes) | <200ms | ✅ Met |
|
||||
| **Graph** | PageRank (1k nodes) | <100ms | ✅ Met |
|
||||
| **Learning** | Insight recording | <5ms | ✅ Met |
|
||||
| **Learning** | Consolidation | <500ms | ✅ Met |
|
||||
| **Task** | Success rate | 95%+ | ✅ Met |
|
||||
|
||||
### Topology Performance
|
||||
|
||||
@@ -5977,7 +6058,7 @@ browser.startTrajectory('Login to dashboard');
|
||||
|
||||
await browser.open('https://example.com/login');
|
||||
|
||||
// Use element refs (93% context reduction vs CSS selectors)
|
||||
// Use element refs (shorter tokens vs full CSS selectors)
|
||||
const snapshot = await browser.snapshot({ interactive: true });
|
||||
await browser.fill('@e1', 'user@example.com');
|
||||
await browser.fill('@e2', 'password');
|
||||
@@ -5992,7 +6073,7 @@ await browser.close();
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| **59 MCP Tools** | Complete browser automation via MCP protocol |
|
||||
| **Element Refs** | 93% context reduction with `@e1`, `@e2` refs |
|
||||
| **Element Refs** | Compact `@e1`, `@e2` refs instead of verbose CSS selectors |
|
||||
| **Trajectory Learning** | Records actions for ReasoningBank/SONA |
|
||||
| **Security Scanning** | URL validation, PII detection, XSS/SQL injection prevention |
|
||||
| **9 Workflow Templates** | Login, OAuth, scraping, testing, monitoring |
|
||||
@@ -6925,7 +7006,7 @@ Ruflo looks for configuration in this order:
|
||||
"default": "anthropic",
|
||||
"fallback": ["openai", "google"],
|
||||
"anthropic": {
|
||||
"model": "claude-sonnet-4-20250514",
|
||||
"model": "claude-sonnet-4-6-20250514",
|
||||
"maxTokens": 8192
|
||||
},
|
||||
"openai": {
|
||||
|
||||
@@ -6,36 +6,8 @@
|
||||
*
|
||||
* Auto-detects MCP mode when stdin is piped and no args provided.
|
||||
* This allows: echo '{"jsonrpc":"2.0",...}' | npx @claude-flow/cli
|
||||
*
|
||||
* Includes pre-flight npx cache repair to prevent ENOTEMPTY errors
|
||||
* in remote/CI environments (known npm 10.x bug).
|
||||
*/
|
||||
|
||||
// Pre-flight: repair stale npx cache to prevent ENOTEMPTY on next run
|
||||
import { existsSync, readdirSync, rmSync, statSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
|
||||
try {
|
||||
const npxRoot = join(homedir(), '.npm', '_npx');
|
||||
if (existsSync(npxRoot)) {
|
||||
for (const dir of readdirSync(npxRoot)) {
|
||||
const nm = join(npxRoot, dir, 'node_modules');
|
||||
if (!existsSync(nm)) continue;
|
||||
try {
|
||||
for (const entry of readdirSync(nm)) {
|
||||
if (entry.startsWith('.') && entry.includes('-') && /[A-Za-z]{8}$/.test(entry)) {
|
||||
try {
|
||||
const p = join(nm, entry);
|
||||
if (statSync(p).isDirectory()) rmSync(p, { recursive: true, force: true });
|
||||
} catch {}
|
||||
}
|
||||
}
|
||||
} catch {}
|
||||
}
|
||||
}
|
||||
} catch {}
|
||||
|
||||
import { randomUUID } from 'crypto';
|
||||
|
||||
// Check if we should run in MCP server mode
|
||||
|
||||
@@ -5,36 +5,8 @@
|
||||
* Direct stdio MCP server for Claude Code integration.
|
||||
* This entry point handles stdin/stdout directly for MCP protocol
|
||||
* without any CLI formatting output that would corrupt the protocol.
|
||||
*
|
||||
* Includes pre-flight npx cache repair to prevent ENOTEMPTY errors
|
||||
* in remote/CI environments (known npm 10.x bug).
|
||||
*/
|
||||
|
||||
// Pre-flight: repair stale npx cache to prevent ENOTEMPTY on next run
|
||||
import { existsSync, readdirSync, rmSync, statSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
|
||||
try {
|
||||
const npxRoot = join(homedir(), '.npm', '_npx');
|
||||
if (existsSync(npxRoot)) {
|
||||
for (const dir of readdirSync(npxRoot)) {
|
||||
const nm = join(npxRoot, dir, 'node_modules');
|
||||
if (!existsSync(nm)) continue;
|
||||
try {
|
||||
for (const entry of readdirSync(nm)) {
|
||||
if (entry.startsWith('.') && entry.includes('-') && /[A-Za-z]{8}$/.test(entry)) {
|
||||
try {
|
||||
const p = join(nm, entry);
|
||||
if (statSync(p).isDirectory()) rmSync(p, { recursive: true, force: true });
|
||||
} catch {}
|
||||
}
|
||||
}
|
||||
} catch {}
|
||||
}
|
||||
}
|
||||
} catch {}
|
||||
|
||||
import { randomUUID } from 'crypto';
|
||||
import { listMCPTools, callMCPTool, hasTool } from '../dist/src/mcp-client.js';
|
||||
|
||||
|
||||
@@ -1,111 +1,2 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Preinstall hook: repairs npm/npx cache to prevent ENOTEMPTY and ECOMPROMISED.
|
||||
*
|
||||
* Handles two common npm bugs in remote/CI/Codespaces environments:
|
||||
* - ENOTEMPTY: leftover .package-XxXxXxXx dirs from interrupted atomic renames
|
||||
* - ECOMPROMISED: corrupted integrity manifests in _cacache
|
||||
*
|
||||
* Works on Windows, macOS, and Linux. Uses only Node.js built-ins (CJS).
|
||||
* Intentionally uses var/ES5 for maximum Node.js compatibility (14+).
|
||||
*/
|
||||
var fs = require('fs');
|
||||
var path = require('path');
|
||||
var os = require('os');
|
||||
|
||||
var npmDir = path.join(os.homedir(), '.npm');
|
||||
|
||||
// 1. Clean stale rename artifacts from npx cache (fixes ENOTEMPTY)
|
||||
try {
|
||||
var npxRoot = path.join(npmDir, '_npx');
|
||||
if (fs.existsSync(npxRoot)) {
|
||||
var dirs = fs.readdirSync(npxRoot);
|
||||
for (var i = 0; i < dirs.length; i++) {
|
||||
var nm = path.join(npxRoot, dirs[i], 'node_modules');
|
||||
if (fs.existsSync(nm) === false) continue;
|
||||
|
||||
try {
|
||||
var entries = fs.readdirSync(nm);
|
||||
for (var k = 0; k < entries.length; k++) {
|
||||
var entry = entries[k];
|
||||
// Stale rename targets: .package-name-XxXxXxXx (dot prefix, dash, 8+ alpha suffix)
|
||||
if (entry.charAt(0) === '.' && entry.indexOf('-') > 0 && /[A-Za-z]{8}$/.test(entry)) {
|
||||
try {
|
||||
var p = path.join(nm, entry);
|
||||
var stat = fs.statSync(p);
|
||||
if (stat.isDirectory()) {
|
||||
fs.rmSync(p, { recursive: true, force: true });
|
||||
}
|
||||
} catch (e) { /* ignore individual failures */ }
|
||||
}
|
||||
}
|
||||
} catch (e) { /* can't read dir, skip */ }
|
||||
}
|
||||
}
|
||||
} catch (e) { /* non-fatal */ }
|
||||
|
||||
// 2. Remove corrupted integrity entries from _cacache (fixes ECOMPROMISED)
|
||||
// Scans index-v5 hash buckets for entries referencing claude-flow or ruflo
|
||||
// packages and removes them so npm re-fetches with correct integrity.
|
||||
try {
|
||||
var cacheIndex = path.join(npmDir, '_cacache', 'index-v5');
|
||||
if (fs.existsSync(cacheIndex)) {
|
||||
// Walk the two-level hash bucket structure: index-v5/XX/YY/...
|
||||
var buckets = fs.readdirSync(cacheIndex);
|
||||
for (var bi = 0; bi < buckets.length; bi++) {
|
||||
var bucketPath = path.join(cacheIndex, buckets[bi]);
|
||||
try {
|
||||
var stat = fs.statSync(bucketPath);
|
||||
if (!stat.isDirectory()) continue;
|
||||
var subBuckets = fs.readdirSync(bucketPath);
|
||||
for (var si = 0; si < subBuckets.length; si++) {
|
||||
var subPath = path.join(bucketPath, subBuckets[si]);
|
||||
try {
|
||||
var subStat = fs.statSync(subPath);
|
||||
if (subStat.isDirectory()) {
|
||||
// Third level
|
||||
var files = fs.readdirSync(subPath);
|
||||
for (var fi = 0; fi < files.length; fi++) {
|
||||
var filePath = path.join(subPath, files[fi]);
|
||||
try {
|
||||
var content = fs.readFileSync(filePath, 'utf-8');
|
||||
if (content.indexOf('claude-flow') !== -1 || content.indexOf('ruflo') !== -1) {
|
||||
fs.unlinkSync(filePath);
|
||||
}
|
||||
} catch (e2) { /* skip unreadable */ }
|
||||
}
|
||||
} else {
|
||||
// File at second level
|
||||
try {
|
||||
var content2 = fs.readFileSync(subPath, 'utf-8');
|
||||
if (content2.indexOf('claude-flow') !== -1 || content2.indexOf('ruflo') !== -1) {
|
||||
fs.unlinkSync(subPath);
|
||||
}
|
||||
} catch (e2) { /* skip unreadable */ }
|
||||
}
|
||||
} catch (e2) { /* skip */ }
|
||||
}
|
||||
} catch (e2) { /* skip unreadable bucket */ }
|
||||
}
|
||||
}
|
||||
} catch (e) { /* non-fatal */ }
|
||||
|
||||
// 3. Remove stale package-lock.json files from npx cache entries
|
||||
try {
|
||||
if (fs.existsSync(npxRoot)) {
|
||||
var cDirs = fs.readdirSync(npxRoot);
|
||||
for (var j = 0; j < cDirs.length; j++) {
|
||||
var lockFile = path.join(npxRoot, cDirs[j], 'package-lock.json');
|
||||
try {
|
||||
if (fs.existsSync(lockFile)) {
|
||||
var lockStat = fs.statSync(lockFile);
|
||||
// Remove lock files older than 1 hour (likely stale)
|
||||
var ageMs = Date.now() - lockStat.mtimeMs;
|
||||
if (ageMs > 3600000) {
|
||||
fs.unlinkSync(lockFile);
|
||||
}
|
||||
}
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
}
|
||||
} catch (e) { /* non-fatal */ }
|
||||
// Preinstall hook — no-op (cache repair removed in 3.1.0-alpha.53)
|
||||
@@ -1,8 +1,8 @@
|
||||
{
|
||||
"name": "@claude-flow/cli",
|
||||
"version": "3.1.0-alpha.52",
|
||||
"version": "3.5.0",
|
||||
"type": "module",
|
||||
"description": "Claude Flow CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
|
||||
"description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
|
||||
"main": "dist/src/index.js",
|
||||
"types": "dist/src/index.d.ts",
|
||||
"sideEffects": false,
|
||||
@@ -90,12 +90,13 @@
|
||||
"@claude-flow/mcp": "^3.0.0-alpha.8",
|
||||
"@claude-flow/shared": "^3.0.0-alpha.1",
|
||||
"@noble/ed25519": "^2.1.0",
|
||||
"agentic-flow": "^3.0.0-alpha.1",
|
||||
"semver": "^7.6.0"
|
||||
},
|
||||
"optionalDependencies": {
|
||||
"@claude-flow/codex": "^3.0.0-alpha.8",
|
||||
"@claude-flow/memory": "^3.0.0-alpha.11",
|
||||
"@claude-flow/embeddings": "^3.0.0-alpha.12",
|
||||
"@claude-flow/memory": "^3.0.0-alpha.11",
|
||||
"@claude-flow/plugin-gastown-bridge": "^0.1.3",
|
||||
"@ruvector/attention": "^0.1.4",
|
||||
"@ruvector/learning-wasm": "^0.1.29",
|
||||
@@ -104,6 +105,6 @@
|
||||
},
|
||||
"publishConfig": {
|
||||
"access": "public",
|
||||
"tag": "alpha"
|
||||
"tag": "latest"
|
||||
}
|
||||
}
|
||||
@@ -401,6 +401,44 @@ async function installClaudeCode(): Promise<boolean> {
|
||||
}
|
||||
}
|
||||
|
||||
// Check agentic-flow v3 integration (filesystem-based to avoid slow WASM/DB init)
|
||||
async function checkAgenticFlow(): Promise<HealthCheck> {
|
||||
try {
|
||||
// Walk common node_modules paths to find agentic-flow/package.json
|
||||
const candidates = [
|
||||
join(process.cwd(), 'node_modules', 'agentic-flow', 'package.json'),
|
||||
join(process.cwd(), '..', 'node_modules', 'agentic-flow', 'package.json'),
|
||||
];
|
||||
let pkgJsonPath: string | null = null;
|
||||
for (const p of candidates) {
|
||||
if (existsSync(p)) { pkgJsonPath = p; break; }
|
||||
}
|
||||
if (!pkgJsonPath) {
|
||||
return {
|
||||
name: 'agentic-flow',
|
||||
status: 'warn',
|
||||
message: 'Not installed (optional — embeddings/routing will use fallbacks)',
|
||||
fix: 'npm install agentic-flow@latest'
|
||||
};
|
||||
}
|
||||
const pkg = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
|
||||
const version = pkg.version || 'unknown';
|
||||
const exports = pkg.exports || {};
|
||||
const features = [
|
||||
exports['./reasoningbank'] ? 'ReasoningBank' : null,
|
||||
exports['./router'] ? 'Router' : null,
|
||||
exports['./transport/quic'] ? 'QUIC' : null,
|
||||
].filter(Boolean);
|
||||
return {
|
||||
name: 'agentic-flow',
|
||||
status: 'pass',
|
||||
message: `v${version} (${features.join(', ')})`
|
||||
};
|
||||
} catch {
|
||||
return { name: 'agentic-flow', status: 'warn', message: 'Check failed' };
|
||||
}
|
||||
}
|
||||
|
||||
// Format health check result
|
||||
function formatCheck(check: HealthCheck): string {
|
||||
const icon = check.status === 'pass' ? output.success('✓') :
|
||||
@@ -474,7 +512,8 @@ export const doctorCommand: Command = {
|
||||
checkApiKeys,
|
||||
checkMcpServers,
|
||||
checkDiskSpace,
|
||||
checkBuildTools
|
||||
checkBuildTools,
|
||||
checkAgenticFlow
|
||||
];
|
||||
|
||||
const componentMap: Record<string, () => Promise<HealthCheck>> = {
|
||||
@@ -490,7 +529,8 @@ export const doctorCommand: Command = {
|
||||
'git': checkGit,
|
||||
'mcp': checkMcpServers,
|
||||
'disk': checkDiskSpace,
|
||||
'typescript': checkBuildTools
|
||||
'typescript': checkBuildTools,
|
||||
'agentic-flow': checkAgenticFlow
|
||||
};
|
||||
|
||||
let checksToRun = allChecks;
|
||||
|
||||
@@ -3835,18 +3835,21 @@ const tokenOptimizeCommand: Command = {
|
||||
let reasoningBank: any = null;
|
||||
|
||||
try {
|
||||
// Check if agentic-flow is available
|
||||
const af = await import('agentic-flow').catch(() => null);
|
||||
if (af) {
|
||||
agenticFlowAvailable = true;
|
||||
// Try to load ReasoningBank
|
||||
// Check if agentic-flow v3 is available
|
||||
const rb = await import('agentic-flow/reasoningbank').catch(() => null);
|
||||
if (rb && typeof rb.retrieveMemories === 'function') {
|
||||
if (rb) {
|
||||
agenticFlowAvailable = true;
|
||||
if (typeof rb.retrieveMemories === 'function') {
|
||||
reasoningBank = rb;
|
||||
}
|
||||
} else {
|
||||
// Legacy check for older agentic-flow
|
||||
const af = await import('agentic-flow').catch(() => null);
|
||||
if (af) agenticFlowAvailable = true;
|
||||
}
|
||||
|
||||
spinner.succeed(agenticFlowAvailable ? 'agentic-flow detected' : 'agentic-flow not available (using fallbacks)');
|
||||
const versionLabel = agenticFlowAvailable ? `agentic-flow v3 detected (ReasoningBank: ${reasoningBank ? 'active' : 'unavailable'})` : 'agentic-flow not available (using fallbacks)';
|
||||
spinner.succeed(versionLabel);
|
||||
output.writeln();
|
||||
|
||||
// Anti-drift config (hardcoded optimal values from research)
|
||||
|
||||
@@ -1725,8 +1725,8 @@ npx @claude-flow/cli@latest hive-mind consensus --propose "task"
|
||||
### Integrated Packages
|
||||
| Package | Version | Purpose |
|
||||
|---------|---------|---------|
|
||||
| agentic-flow | 2.0.1-alpha | Core coordination |
|
||||
| agentdb | 2.0.0-alpha.3.4 | Vector database |
|
||||
| agentic-flow | 3.0.0-alpha.1 | Core coordination + ReasoningBank + Router |
|
||||
| agentdb | 3.0.0-alpha.10 | Vector database + 8 controllers |
|
||||
| @ruvector/attention | 0.1.3 | Flash attention |
|
||||
| @ruvector/sona | 0.1.5 | Neural learning |
|
||||
|
||||
|
||||
@@ -2,11 +2,6 @@
|
||||
* MCP Configuration Generator
|
||||
* Creates .mcp.json for Claude Code MCP server integration
|
||||
* Handles cross-platform compatibility (Windows requires cmd /c wrapper)
|
||||
*
|
||||
* Uses a shell wrapper on Unix to auto-repair npm cache corruption
|
||||
* (ENOTEMPTY/ECOMPROMISED) before running npx. This is critical for
|
||||
* remote environments like Codespaces where interrupted installs
|
||||
* leave stale artifacts that prevent subsequent npx runs.
|
||||
*/
|
||||
|
||||
import type { InitOptions, MCPConfig } from './types.js';
|
||||
@@ -21,12 +16,7 @@ function isWindows(): boolean {
|
||||
/**
|
||||
* Generate platform-specific MCP server entry
|
||||
* - Windows: uses 'cmd /c npx' directly
|
||||
* - Unix: uses 'sh -c' with retry-on-failure for npm cache corruption
|
||||
*
|
||||
* The Unix wrapper tries npx normally first. If it fails with ENOTEMPTY
|
||||
* or ECOMPROMISED (common in Codespaces/remote envs), it nukes the
|
||||
* corrupted cache and retries once. This adds 0ms on success and ~5s
|
||||
* on the retry path — acceptable since MCP servers start once per session.
|
||||
* - Unix: uses 'npx' directly (simple, reliable)
|
||||
*/
|
||||
function createMCPServerEntry(
|
||||
npxArgs: string[],
|
||||
@@ -42,13 +32,10 @@ function createMCPServerEntry(
|
||||
};
|
||||
}
|
||||
|
||||
// Unix: npx with automatic retry on cache corruption
|
||||
const npxCmd = ['npx', '-y', ...npxArgs].join(' ');
|
||||
// Try normal launch; on ENOTEMPTY/ECOMPROMISED nuke cache and retry
|
||||
const retryScript = `${npxCmd} 2>/tmp/.cf-err.$$ || { if grep -qE 'ENOTEMPTY|ECOMPROMISED' /tmp/.cf-err.$$ 2>/dev/null; then rm -rf ~/.npm/_npx ~/.npm/_cacache 2>/dev/null; exec ${npxCmd}; else cat /tmp/.cf-err.$$ >&2; exit 1; fi; }`;
|
||||
// Unix: direct npx invocation — simple and reliable
|
||||
return {
|
||||
command: 'sh',
|
||||
args: ['-c', retryScript],
|
||||
command: 'npx',
|
||||
args: ['-y', ...npxArgs],
|
||||
env,
|
||||
...additionalProps,
|
||||
};
|
||||
@@ -61,11 +48,7 @@ export function generateMCPConfig(options: InitOptions): object {
|
||||
const config = options.mcp;
|
||||
const mcpServers: Record<string, object> = {};
|
||||
|
||||
// Shared env vars that prevent npm cache corruption issues
|
||||
// npm_config_prefer_online: skip stale cache integrity (fixes ECOMPROMISED)
|
||||
// npm_config_update_notifier: suppress update check (faster startup)
|
||||
const npmCacheEnv = {
|
||||
npm_config_prefer_online: 'true',
|
||||
const npmEnv = {
|
||||
npm_config_update_notifier: 'false',
|
||||
};
|
||||
|
||||
@@ -74,7 +57,7 @@ export function generateMCPConfig(options: InitOptions): object {
|
||||
mcpServers['claude-flow'] = createMCPServerEntry(
|
||||
['@claude-flow/cli@latest', 'mcp', 'start'],
|
||||
{
|
||||
...npmCacheEnv,
|
||||
...npmEnv,
|
||||
CLAUDE_FLOW_MODE: 'v3',
|
||||
CLAUDE_FLOW_HOOKS_ENABLED: 'true',
|
||||
CLAUDE_FLOW_TOPOLOGY: options.runtime.topology,
|
||||
@@ -89,7 +72,7 @@ export function generateMCPConfig(options: InitOptions): object {
|
||||
if (config.ruvSwarm) {
|
||||
mcpServers['ruv-swarm'] = createMCPServerEntry(
|
||||
['ruv-swarm', 'mcp', 'start'],
|
||||
{ ...npmCacheEnv },
|
||||
{ ...npmEnv },
|
||||
{ optional: true }
|
||||
);
|
||||
}
|
||||
@@ -98,7 +81,7 @@ export function generateMCPConfig(options: InitOptions): object {
|
||||
if (config.flowNexus) {
|
||||
mcpServers['flow-nexus'] = createMCPServerEntry(
|
||||
['flow-nexus@latest', 'mcp', 'start'],
|
||||
{ ...npmCacheEnv },
|
||||
{ ...npmEnv },
|
||||
{ optional: true, requiresAuth: true }
|
||||
);
|
||||
}
|
||||
@@ -116,8 +99,6 @@ export function generateMCPJson(options: InitOptions): string {
|
||||
|
||||
/**
|
||||
* Generate MCP server add commands for manual setup
|
||||
* Unix wraps npx with cache repair to prevent ENOTEMPTY/ECOMPROMISED
|
||||
* Windows uses 'cmd /c' wrapper for npx execution
|
||||
*/
|
||||
export function generateMCPCommands(options: InitOptions): string[] {
|
||||
const commands: string[] = [];
|
||||
@@ -134,7 +115,6 @@ export function generateMCPCommands(options: InitOptions): string[] {
|
||||
commands.push('claude mcp add flow-nexus -- cmd /c npx -y flow-nexus@latest mcp start');
|
||||
}
|
||||
} else {
|
||||
// Unix: wrap with retry-on-failure for cache corruption resilience
|
||||
if (config.claudeFlow) {
|
||||
commands.push("claude mcp add claude-flow -- npx -y @claude-flow/cli@latest mcp start");
|
||||
}
|
||||
@@ -161,6 +141,6 @@ export function getPlatformInstructions(): { platform: string; note: string } {
|
||||
}
|
||||
return {
|
||||
platform: process.platform === 'darwin' ? 'macOS' : 'Linux',
|
||||
note: 'MCP configuration uses sh wrapper with automatic npm cache repair for remote environment resilience.',
|
||||
note: 'MCP configuration uses npx directly.',
|
||||
};
|
||||
}
|
||||
@@ -5,11 +5,54 @@
|
||||
* Provides direct access to ReasoningBank, CausalGraph, SkillLibrary,
|
||||
* AttestationLog, and bridge health through the MCP protocol.
|
||||
*
|
||||
* Security: All handlers validate input types, enforce length bounds,
|
||||
* and sanitize error messages before returning to MCP callers.
|
||||
*
|
||||
* @module v3/cli/mcp-tools/agentdb-tools
|
||||
*/
|
||||
|
||||
import type { MCPTool } from './types.js';
|
||||
|
||||
// ===== Shared validation helpers =====
|
||||
|
||||
const MAX_STRING_LENGTH = 100_000; // 100KB max for any string input
|
||||
const MAX_BATCH_SIZE = 500; // Max entries per batch operation
|
||||
const MAX_TOP_K = 100; // Max results per query
|
||||
|
||||
function validateString(value: unknown, name: string, maxLen = MAX_STRING_LENGTH): string | null {
|
||||
if (typeof value !== 'string' || value.length === 0) return null;
|
||||
if (value.length > maxLen) return null;
|
||||
return value;
|
||||
}
|
||||
|
||||
function validatePositiveInt(value: unknown, defaultVal: number, max: number): number {
|
||||
if (typeof value !== 'number' || !Number.isFinite(value)) return defaultVal;
|
||||
const n = Math.floor(value);
|
||||
return n > 0 ? Math.min(n, max) : defaultVal;
|
||||
}
|
||||
|
||||
function validateScore(value: unknown, defaultVal: number): number {
|
||||
if (typeof value !== 'number' || !Number.isFinite(value)) return defaultVal;
|
||||
return Math.max(0, Math.min(1, value));
|
||||
}
|
||||
|
||||
function sanitizeError(error: unknown): string {
|
||||
if (error instanceof Error) {
|
||||
// Strip filesystem paths from error messages
|
||||
return error.message.replace(/\/[^\s:]+\//g, '<path>/').substring(0, 500);
|
||||
}
|
||||
return 'Internal error';
|
||||
}
|
||||
|
||||
// Lazy-cached bridge module
|
||||
let bridgeModule: typeof import('../memory/memory-bridge.js') | null = null;
|
||||
async function getBridge() {
|
||||
if (!bridgeModule) {
|
||||
bridgeModule = await import('../memory/memory-bridge.js');
|
||||
}
|
||||
return bridgeModule;
|
||||
}
|
||||
|
||||
// ===== agentdb_health — Controller health check =====
|
||||
|
||||
export const agentdbHealth: MCPTool = {
|
||||
@@ -21,14 +64,12 @@ export const agentdbHealth: MCPTool = {
|
||||
},
|
||||
handler: async () => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const bridge = await getBridge();
|
||||
const health = await bridge.bridgeHealthCheck();
|
||||
if (!health) {
|
||||
return { available: false, error: 'AgentDB bridge not available' };
|
||||
}
|
||||
if (!health) return { available: false, error: 'AgentDB bridge not available' };
|
||||
return health;
|
||||
} catch (error) {
|
||||
return { available: false, error: error instanceof Error ? error.message : String(error) };
|
||||
return { available: false, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -44,19 +85,17 @@ export const agentdbControllers: MCPTool = {
|
||||
},
|
||||
handler: async () => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const bridge = await getBridge();
|
||||
const controllers = await bridge.bridgeListControllers();
|
||||
if (!controllers) {
|
||||
return { available: false, controllers: [], error: 'Bridge not available' };
|
||||
}
|
||||
if (!controllers) return { available: false, controllers: [], error: 'Bridge not available' };
|
||||
return {
|
||||
available: true,
|
||||
controllers,
|
||||
total: controllers.length,
|
||||
active: controllers.filter(c => c.enabled).length,
|
||||
active: controllers.filter((c: any) => c.enabled).length,
|
||||
};
|
||||
} catch (error) {
|
||||
return { available: false, error: error instanceof Error ? error.message : String(error) };
|
||||
return { available: false, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -77,15 +116,17 @@ export const agentdbPatternStore: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const pattern = validateString(params.pattern, 'pattern');
|
||||
if (!pattern) return { success: false, error: 'pattern is required (non-empty string, max 100KB)' };
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeStorePattern({
|
||||
pattern: params.pattern as string,
|
||||
type: (params.type as string) || 'general',
|
||||
confidence: (params.confidence as number) || 0.8,
|
||||
pattern,
|
||||
type: validateString(params.type, 'type', 200) ?? 'general',
|
||||
confidence: validateScore(params.confidence, 0.8),
|
||||
});
|
||||
return result || { success: false, error: 'Bridge not available' };
|
||||
return result ?? { success: false, error: 'Bridge not available' };
|
||||
} catch (error) {
|
||||
return { success: false, error: error instanceof Error ? error.message : String(error) };
|
||||
return { success: false, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -106,15 +147,17 @@ export const agentdbPatternSearch: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const query = validateString(params.query, 'query', 10_000);
|
||||
if (!query) return { results: [], error: 'query is required (non-empty string, max 10KB)' };
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeSearchPatterns({
|
||||
query: params.query as string,
|
||||
topK: (params.topK as number) || 5,
|
||||
minConfidence: (params.minConfidence as number) || 0.3,
|
||||
query,
|
||||
topK: validatePositiveInt(params.topK, 5, MAX_TOP_K),
|
||||
minConfidence: validateScore(params.minConfidence, 0.3),
|
||||
});
|
||||
return result || { results: [], controller: 'unavailable' };
|
||||
return result ?? { results: [], controller: 'unavailable' };
|
||||
} catch (error) {
|
||||
return { results: [], error: error instanceof Error ? error.message : String(error) };
|
||||
return { results: [], error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -136,16 +179,18 @@ export const agentdbFeedback: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const taskId = validateString(params.taskId, 'taskId', 500);
|
||||
if (!taskId) return { success: false, error: 'taskId is required (non-empty string, max 500 chars)' };
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeRecordFeedback({
|
||||
taskId: params.taskId as string,
|
||||
success: params.success !== false,
|
||||
quality: (params.quality as number) || 0.85,
|
||||
agent: params.agent as string | undefined,
|
||||
taskId,
|
||||
success: params.success === true,
|
||||
quality: validateScore(params.quality, 0.85),
|
||||
agent: validateString(params.agent, 'agent', 200) ?? undefined,
|
||||
});
|
||||
return result || { success: false, error: 'Bridge not available' };
|
||||
return result ?? { success: false, error: 'Bridge not available' };
|
||||
} catch (error) {
|
||||
return { success: false, error: error instanceof Error ? error.message : String(error) };
|
||||
return { success: false, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -167,16 +212,22 @@ export const agentdbCausalEdge: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const sourceId = validateString(params.sourceId, 'sourceId', 500);
|
||||
const targetId = validateString(params.targetId, 'targetId', 500);
|
||||
const relation = validateString(params.relation, 'relation', 200);
|
||||
if (!sourceId) return { success: false, error: 'sourceId is required (non-empty string)' };
|
||||
if (!targetId) return { success: false, error: 'targetId is required (non-empty string)' };
|
||||
if (!relation) return { success: false, error: 'relation is required (non-empty string)' };
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeRecordCausalEdge({
|
||||
sourceId: params.sourceId as string,
|
||||
targetId: params.targetId as string,
|
||||
relation: params.relation as string,
|
||||
weight: params.weight as number | undefined,
|
||||
sourceId,
|
||||
targetId,
|
||||
relation,
|
||||
weight: typeof params.weight === 'number' ? validateScore(params.weight, 0.5) : undefined,
|
||||
});
|
||||
return result || { success: false, error: 'Bridge not available' };
|
||||
return result ?? { success: false, error: 'Bridge not available' };
|
||||
} catch (error) {
|
||||
return { success: false, error: error instanceof Error ? error.message : String(error) };
|
||||
return { success: false, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -196,14 +247,16 @@ export const agentdbRoute: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const task = validateString(params.task, 'task', 10_000);
|
||||
if (!task) return { route: 'general', confidence: 0.5, agents: ['coder'], controller: 'error', error: 'task is required (non-empty string)' };
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeRouteTask({
|
||||
task: params.task as string,
|
||||
context: params.context as string | undefined,
|
||||
task,
|
||||
context: validateString(params.context, 'context', 10_000) ?? undefined,
|
||||
});
|
||||
return result || { route: 'general', confidence: 0.5, agents: ['coder'], controller: 'fallback' };
|
||||
return result ?? { route: 'general', confidence: 0.5, agents: ['coder'], controller: 'fallback' };
|
||||
} catch (error) {
|
||||
return { route: 'general', confidence: 0.5, agents: ['coder'], controller: 'error', error: error instanceof Error ? error.message : String(error) };
|
||||
return { route: 'general', confidence: 0.5, agents: ['coder'], controller: 'error', error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -223,14 +276,16 @@ export const agentdbSessionStart: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const sessionId = validateString(params.sessionId, 'sessionId', 500);
|
||||
if (!sessionId) return { success: false, error: 'sessionId is required (non-empty string)' };
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeSessionStart({
|
||||
sessionId: params.sessionId as string,
|
||||
context: params.context as string | undefined,
|
||||
sessionId,
|
||||
context: validateString(params.context, 'context', 10_000) ?? undefined,
|
||||
});
|
||||
return result || { success: false, error: 'Bridge not available' };
|
||||
return result ?? { success: false, error: 'Bridge not available' };
|
||||
} catch (error) {
|
||||
return { success: false, error: error instanceof Error ? error.message : String(error) };
|
||||
return { success: false, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -251,15 +306,17 @@ export const agentdbSessionEnd: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const sessionId = validateString(params.sessionId, 'sessionId', 500);
|
||||
if (!sessionId) return { success: false, error: 'sessionId is required (non-empty string)' };
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeSessionEnd({
|
||||
sessionId: params.sessionId as string,
|
||||
summary: params.summary as string | undefined,
|
||||
tasksCompleted: params.tasksCompleted as number | undefined,
|
||||
sessionId,
|
||||
summary: validateString(params.summary, 'summary', 50_000) ?? undefined,
|
||||
tasksCompleted: validatePositiveInt(params.tasksCompleted, 0, 10_000),
|
||||
});
|
||||
return result || { success: false, error: 'Bridge not available' };
|
||||
return result ?? { success: false, error: 'Bridge not available' };
|
||||
} catch (error) {
|
||||
return { success: false, error: error instanceof Error ? error.message : String(error) };
|
||||
return { success: false, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -268,7 +325,7 @@ export const agentdbSessionEnd: MCPTool = {
|
||||
|
||||
export const agentdbHierarchicalStore: MCPTool = {
|
||||
name: 'agentdb_hierarchical-store',
|
||||
description: 'Store to hierarchical memory with tier (working, shortTerm, longTerm)',
|
||||
description: 'Store to hierarchical memory with tier (working, episodic, semantic)',
|
||||
inputSchema: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
@@ -276,8 +333,8 @@ export const agentdbHierarchicalStore: MCPTool = {
|
||||
value: { type: 'string', description: 'Memory entry value' },
|
||||
tier: {
|
||||
type: 'string',
|
||||
description: 'Memory tier (working, shortTerm, longTerm)',
|
||||
enum: ['working', 'shortTerm', 'longTerm'],
|
||||
description: 'Memory tier (working, episodic, semantic)',
|
||||
enum: ['working', 'episodic', 'semantic'],
|
||||
default: 'working',
|
||||
},
|
||||
},
|
||||
@@ -285,15 +342,19 @@ export const agentdbHierarchicalStore: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const result = await bridge.bridgeHierarchicalStore({
|
||||
key: params.key as string,
|
||||
value: params.value as string,
|
||||
tier: (params.tier as string) || 'working',
|
||||
});
|
||||
return result || { success: false, error: 'Bridge not available' };
|
||||
const key = validateString(params.key, 'key', 1000);
|
||||
const value = validateString(params.value, 'value');
|
||||
if (!key) return { success: false, error: 'key is required (non-empty string, max 1KB)' };
|
||||
if (!value) return { success: false, error: 'value is required (non-empty string, max 100KB)' };
|
||||
const tier = validateString(params.tier, 'tier', 20) ?? 'working';
|
||||
if (!['working', 'episodic', 'semantic'].includes(tier)) {
|
||||
return { success: false, error: `Invalid tier: ${tier}. Must be working, episodic, or semantic` };
|
||||
}
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeHierarchicalStore({ key, value, tier });
|
||||
return result ?? { success: false, error: 'Bridge not available' };
|
||||
} catch (error) {
|
||||
return { success: false, error: error instanceof Error ? error.message : String(error) };
|
||||
return { success: false, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -307,22 +368,28 @@ export const agentdbHierarchicalRecall: MCPTool = {
|
||||
type: 'object',
|
||||
properties: {
|
||||
query: { type: 'string', description: 'Recall query' },
|
||||
tier: { type: 'string', description: 'Filter by tier (working, shortTerm, longTerm)' },
|
||||
tier: { type: 'string', description: 'Filter by tier (working, episodic, semantic)' },
|
||||
topK: { type: 'number', description: 'Number of results (default: 5)' },
|
||||
},
|
||||
required: ['query'],
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const query = validateString(params.query, 'query', 10_000);
|
||||
if (!query) return { results: [], error: 'query is required (non-empty string, max 10KB)' };
|
||||
const tier = validateString(params.tier, 'tier', 20);
|
||||
if (tier && !['working', 'episodic', 'semantic'].includes(tier)) {
|
||||
return { results: [], error: `Invalid tier: ${tier}. Must be working, episodic, or semantic` };
|
||||
}
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeHierarchicalRecall({
|
||||
query: params.query as string,
|
||||
tier: params.tier as string | undefined,
|
||||
topK: (params.topK as number) || 5,
|
||||
query,
|
||||
tier: tier ?? undefined,
|
||||
topK: validatePositiveInt(params.topK, 5, MAX_TOP_K),
|
||||
});
|
||||
return result || { results: [], error: 'Bridge not available' };
|
||||
return result ?? { results: [], error: 'Bridge not available' };
|
||||
} catch (error) {
|
||||
return { results: [], error: error instanceof Error ? error.message : String(error) };
|
||||
return { results: [], error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -341,14 +408,14 @@ export const agentdbConsolidate: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeConsolidate({
|
||||
minAge: params.minAge as number | undefined,
|
||||
maxEntries: params.maxEntries as number | undefined,
|
||||
minAge: typeof params.minAge === 'number' ? Math.max(0, params.minAge) : undefined,
|
||||
maxEntries: validatePositiveInt(params.maxEntries, 1000, 10_000),
|
||||
});
|
||||
return result || { success: false, error: 'Bridge not available' };
|
||||
return result ?? { success: false, error: 'Bridge not available' };
|
||||
} catch (error) {
|
||||
return { success: false, error: error instanceof Error ? error.message : String(error) };
|
||||
return { success: false, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -383,14 +450,37 @@ export const agentdbBatch: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const operation = validateString(params.operation, 'operation', 20);
|
||||
if (!operation) return { success: false, error: 'operation is required (string)' };
|
||||
if (!['insert', 'update', 'delete'].includes(operation)) {
|
||||
return { success: false, error: `Invalid operation: ${operation}. Must be insert, update, or delete` };
|
||||
}
|
||||
if (!Array.isArray(params.entries) || params.entries.length === 0) {
|
||||
return { success: false, error: 'entries is required (non-empty array)' };
|
||||
}
|
||||
if (params.entries.length > MAX_BATCH_SIZE) {
|
||||
return { success: false, error: `Too many entries: ${params.entries.length}. Max is ${MAX_BATCH_SIZE}` };
|
||||
}
|
||||
// Validate each entry
|
||||
const validatedEntries: Array<{ key: string; value?: string; metadata?: Record<string, unknown> }> = [];
|
||||
for (let i = 0; i < params.entries.length; i++) {
|
||||
const entry = params.entries[i];
|
||||
if (!entry || typeof entry !== 'object') {
|
||||
return { success: false, error: `entries[${i}] must be an object` };
|
||||
}
|
||||
const key = validateString((entry as any).key, `entries[${i}].key`, 1000);
|
||||
if (!key) return { success: false, error: `entries[${i}].key is required (non-empty string)` };
|
||||
const value = validateString((entry as any).value, `entries[${i}].value`);
|
||||
validatedEntries.push({ key, value: value ?? undefined });
|
||||
}
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeBatchOperation({
|
||||
operation: params.operation as string,
|
||||
entries: params.entries as any[],
|
||||
operation,
|
||||
entries: validatedEntries,
|
||||
});
|
||||
return result || { success: false, error: 'Bridge not available' };
|
||||
return result ?? { success: false, error: 'Bridge not available' };
|
||||
} catch (error) {
|
||||
return { success: false, error: error instanceof Error ? error.message : String(error) };
|
||||
return { success: false, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -410,14 +500,16 @@ export const agentdbContextSynthesize: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const query = validateString(params.query, 'query', 10_000);
|
||||
if (!query) return { success: false, error: 'query is required (non-empty string, max 10KB)' };
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeContextSynthesize({
|
||||
query: params.query as string,
|
||||
maxEntries: (params.maxEntries as number) || 10,
|
||||
query,
|
||||
maxEntries: validatePositiveInt(params.maxEntries, 10, MAX_TOP_K),
|
||||
});
|
||||
return result || { success: false, error: 'Bridge not available' };
|
||||
return result ?? { success: false, error: 'Bridge not available' };
|
||||
} catch (error) {
|
||||
return { success: false, error: error instanceof Error ? error.message : String(error) };
|
||||
return { success: false, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
@@ -436,13 +528,13 @@ export const agentdbSemanticRoute: MCPTool = {
|
||||
},
|
||||
handler: async (params: Record<string, unknown>) => {
|
||||
try {
|
||||
const bridge = await import('../memory/memory-bridge.js');
|
||||
const result = await bridge.bridgeSemanticRoute({
|
||||
input: params.input as string,
|
||||
});
|
||||
return result || { route: null, error: 'Bridge not available' };
|
||||
const input = validateString(params.input, 'input', 10_000);
|
||||
if (!input) return { route: null, error: 'input is required (non-empty string, max 10KB)' };
|
||||
const bridge = await getBridge();
|
||||
const result = await bridge.bridgeSemanticRoute({ input });
|
||||
return result ?? { route: null, error: 'Bridge not available' };
|
||||
} catch (error) {
|
||||
return { route: null, error: error instanceof Error ? error.message : String(error) };
|
||||
return { route: null, error: sanitizeError(error) };
|
||||
}
|
||||
},
|
||||
};
|
||||
|
||||
@@ -2540,7 +2540,7 @@ export const hooksIntelligenceAttention: MCPTool = {
|
||||
// =============================================================================
|
||||
|
||||
/**
|
||||
* Worker trigger types matching agentic-flow@alpha
|
||||
* Worker trigger types matching agentic-flow v3
|
||||
*/
|
||||
type WorkerTrigger =
|
||||
| 'ultralearn' // Deep knowledge acquisition
|
||||
|
||||
@@ -16,26 +16,31 @@ import type { MCPTool } from './types.js';
|
||||
import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
|
||||
// Try to import real embeddings from @claude-flow/embeddings
|
||||
// Try to import real embeddings — prefer agentic-flow v3 ReasoningBank, then @claude-flow/embeddings
|
||||
let realEmbeddings: { embed: (text: string) => Promise<number[]> } | null = null;
|
||||
let embeddingServiceName: string = 'none';
|
||||
try {
|
||||
// Dynamic import to avoid hard dependency
|
||||
const embeddingsModule = await import('@claude-flow/embeddings');
|
||||
if (embeddingsModule.createEmbeddingService) {
|
||||
// Try to create agentic-flow service (fastest), fall back to mock
|
||||
// Tier 1: agentic-flow v3 ReasoningBank (fastest — WASM-accelerated)
|
||||
const rb = await import('agentic-flow/reasoningbank').catch(() => null);
|
||||
if (rb?.computeEmbedding) {
|
||||
realEmbeddings = { embed: (text: string) => rb.computeEmbedding(text) };
|
||||
embeddingServiceName = 'agentic-flow/reasoningbank';
|
||||
}
|
||||
|
||||
// Tier 2: @claude-flow/embeddings
|
||||
if (!realEmbeddings) {
|
||||
const embeddingsModule = await import('@claude-flow/embeddings').catch(() => null);
|
||||
if (embeddingsModule?.createEmbeddingService) {
|
||||
try {
|
||||
const service = embeddingsModule.createEmbeddingService({ provider: 'agentic-flow' });
|
||||
realEmbeddings = {
|
||||
embed: async (text: string) => {
|
||||
const result = await service.embed(text);
|
||||
// Convert Float32Array to number[] if needed
|
||||
return Array.from(result.embedding);
|
||||
},
|
||||
};
|
||||
embeddingServiceName = 'agentic-flow';
|
||||
} catch {
|
||||
// Fall back to mock service
|
||||
const service = embeddingsModule.createEmbeddingService({ provider: 'mock' });
|
||||
realEmbeddings = {
|
||||
embed: async (text: string) => {
|
||||
@@ -46,8 +51,9 @@ try {
|
||||
embeddingServiceName = 'mock';
|
||||
}
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// @claude-flow/embeddings not available, will use fallback
|
||||
// No embedding provider available, will use fallback
|
||||
}
|
||||
|
||||
// Storage paths
|
||||
|
||||
@@ -18,6 +18,7 @@
|
||||
*/
|
||||
|
||||
import * as path from 'path';
|
||||
import * as crypto from 'crypto';
|
||||
|
||||
// ===== Lazy singleton =====
|
||||
|
||||
@@ -25,9 +26,29 @@ let registryPromise: Promise<any> | null = null;
|
||||
let registryInstance: any = null;
|
||||
let bridgeAvailable: boolean | null = null;
|
||||
|
||||
/**
|
||||
* Resolve database path with path traversal protection.
|
||||
* Only allows paths within or below the project's .swarm directory,
|
||||
* or the special ':memory:' path.
|
||||
*/
|
||||
function getDbPath(customPath?: string): string {
|
||||
const swarmDir = path.join(process.cwd(), '.swarm');
|
||||
return customPath || path.join(swarmDir, 'memory.db');
|
||||
const swarmDir = path.resolve(process.cwd(), '.swarm');
|
||||
if (!customPath) return path.join(swarmDir, 'memory.db');
|
||||
if (customPath === ':memory:') return ':memory:';
|
||||
const resolved = path.resolve(customPath);
|
||||
// Ensure the path doesn't escape the working directory
|
||||
const cwd = process.cwd();
|
||||
if (!resolved.startsWith(cwd)) {
|
||||
return path.join(swarmDir, 'memory.db'); // fallback to safe default
|
||||
}
|
||||
return resolved;
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate a secure random ID for memory entries.
|
||||
*/
|
||||
function generateId(prefix: string): string {
|
||||
return `${prefix}_${Date.now()}_${crypto.randomBytes(8).toString('hex')}`;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -194,7 +215,8 @@ async function cacheInvalidate(registry: any, cacheKey: string): Promise<void> {
|
||||
/**
|
||||
* Validate a mutation through MutationGuard before executing.
|
||||
* Returns true if the mutation is allowed, false if rejected.
|
||||
* Falls back to allowing if guard is unavailable.
|
||||
* When guard is unavailable (not installed), mutations are allowed.
|
||||
* When guard is present but throws, mutations are DENIED (fail-closed).
|
||||
*/
|
||||
async function guardValidate(
|
||||
registry: any,
|
||||
@@ -204,12 +226,12 @@ async function guardValidate(
|
||||
try {
|
||||
const guard = registry.get('mutationGuard');
|
||||
if (!guard || typeof guard.validate !== 'function') {
|
||||
return { allowed: true }; // No guard = allow
|
||||
return { allowed: true }; // No guard installed = allow (degraded mode)
|
||||
}
|
||||
const result = guard.validate({ operation, params, timestamp: Date.now() });
|
||||
return { allowed: result?.allowed !== false, reason: result?.reason };
|
||||
return { allowed: result?.allowed === true, reason: result?.reason };
|
||||
} catch {
|
||||
return { allowed: true }; // Guard error = allow (graceful degradation)
|
||||
return { allowed: false, reason: 'MutationGuard validation error' }; // Fail-closed
|
||||
}
|
||||
}
|
||||
|
||||
@@ -314,7 +336,7 @@ export async function bridgeStoreEntry(options: {
|
||||
|
||||
try {
|
||||
const { key, value, namespace = 'default', tags = [], ttl } = options;
|
||||
const id = `entry_${Date.now()}_${Math.random().toString(36).substring(7)}`;
|
||||
const id = generateId('entry');
|
||||
const now = Date.now();
|
||||
|
||||
// Phase 5: MutationGuard validation before write
|
||||
@@ -368,7 +390,9 @@ export async function bridgeStoreEntry(options: {
|
||||
);
|
||||
|
||||
// Phase 2: Write-through to TieredCache
|
||||
const cacheKey = `entry:${namespace}:${key}`;
|
||||
const safeNs = String(namespace).replace(/:/g, '_');
|
||||
const safeKey = String(key).replace(/:/g, '_');
|
||||
const cacheKey = `entry:${safeNs}:${safeKey}`;
|
||||
await cacheSet(registry, cacheKey, { id, key, namespace, content: value, embedding: embeddingJson });
|
||||
|
||||
// Phase 4: AttestationLog write audit
|
||||
@@ -558,7 +582,7 @@ export async function bridgeListEntries(options: {
|
||||
`SELECT COUNT(*) as cnt FROM memory_entries WHERE status = 'active' ${nsFilter}`
|
||||
);
|
||||
const countRow = countStmt.get(...nsParams);
|
||||
total = countRow?.cnt || 0;
|
||||
total = countRow?.cnt ?? 0;
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
@@ -580,7 +604,7 @@ export async function bridgeListEntries(options: {
|
||||
key: row.key || String(row.id).substring(0, 15),
|
||||
namespace: row.namespace || 'default',
|
||||
size: (row.content || '').length,
|
||||
accessCount: row.access_count || 0,
|
||||
accessCount: row.access_count ?? 0,
|
||||
createdAt: row.created_at || new Date().toISOString(),
|
||||
updatedAt: row.updated_at || new Date().toISOString(),
|
||||
hasEmbedding: !!(row.embedding && String(row.embedding).length > 10),
|
||||
@@ -631,7 +655,9 @@ export async function bridgeGetEntry(options: {
|
||||
const { key, namespace = 'default' } = options;
|
||||
|
||||
// Phase 2: Check TieredCache first
|
||||
const cacheKey = `entry:${namespace}:${key}`;
|
||||
const safeNs = String(namespace).replace(/:/g, '_');
|
||||
const safeKey = String(key).replace(/:/g, '_');
|
||||
const cacheKey = `entry:${safeNs}:${safeKey}`;
|
||||
const cached = await cacheGet(registry, cacheKey);
|
||||
if (cached && cached.content) {
|
||||
return {
|
||||
@@ -643,7 +669,7 @@ export async function bridgeGetEntry(options: {
|
||||
key: cached.key || key,
|
||||
namespace: cached.namespace || namespace,
|
||||
content: cached.content || '',
|
||||
accessCount: cached.accessCount || 0,
|
||||
accessCount: cached.accessCount ?? 0,
|
||||
createdAt: cached.createdAt || new Date().toISOString(),
|
||||
updatedAt: cached.updatedAt || new Date().toISOString(),
|
||||
hasEmbedding: !!cached.embedding,
|
||||
@@ -688,7 +714,7 @@ export async function bridgeGetEntry(options: {
|
||||
key: row.key || String(row.id),
|
||||
namespace: row.namespace || 'default',
|
||||
content: row.content || '',
|
||||
accessCount: (row.access_count || 0) + 1,
|
||||
accessCount: (row.access_count ?? 0) + 1,
|
||||
createdAt: row.created_at || new Date().toISOString(),
|
||||
updatedAt: row.updated_at || new Date().toISOString(),
|
||||
hasEmbedding: !!(row.embedding && String(row.embedding).length > 10),
|
||||
@@ -750,7 +776,9 @@ export async function bridgeDeleteEntry(options: {
|
||||
}
|
||||
|
||||
// Phase 2: Invalidate cache
|
||||
await cacheInvalidate(registry, `entry:${namespace}:${key}`);
|
||||
const safeNs = String(namespace).replace(/:/g, '_');
|
||||
const safeKey = String(key).replace(/:/g, '_');
|
||||
await cacheInvalidate(registry, `entry:${safeNs}:${safeKey}`);
|
||||
|
||||
// Phase 4: AttestationLog delete audit
|
||||
if (changes > 0) {
|
||||
@@ -760,7 +788,7 @@ export async function bridgeDeleteEntry(options: {
|
||||
let remaining = 0;
|
||||
try {
|
||||
const row = ctx.db.prepare(`SELECT COUNT(*) as cnt FROM memory_entries WHERE status = 'active'`).get();
|
||||
remaining = row?.cnt || 0;
|
||||
remaining = row?.cnt ?? 0;
|
||||
} catch {
|
||||
// Non-fatal
|
||||
}
|
||||
@@ -872,7 +900,7 @@ export async function bridgeGetHNSWStatus(
|
||||
const row = ctx.db.prepare(
|
||||
`SELECT COUNT(*) as cnt FROM memory_entries WHERE status = 'active' AND embedding IS NOT NULL`,
|
||||
).get();
|
||||
entryCount = row?.cnt || 0;
|
||||
entryCount = row?.cnt ?? 0;
|
||||
} catch {
|
||||
// Table might not exist
|
||||
}
|
||||
@@ -1103,7 +1131,7 @@ export async function bridgeStorePattern(options: {
|
||||
|
||||
try {
|
||||
const reasoningBank = registry.get('reasoningBank');
|
||||
const patternId = `pattern-${Date.now()}-${Math.random().toString(36).substring(7)}`;
|
||||
const patternId = generateId('pattern');
|
||||
|
||||
if (reasoningBank && typeof reasoningBank.store === 'function') {
|
||||
await reasoningBank.store({
|
||||
@@ -1157,7 +1185,7 @@ export async function bridgeSearchPatterns(options: {
|
||||
results: Array.isArray(results) ? results.map((r: any) => ({
|
||||
id: r.id || r.patternId || '',
|
||||
content: r.content || r.pattern || '',
|
||||
score: r.score || r.confidence || 0,
|
||||
score: r.score ?? r.confidence ?? 0,
|
||||
})) : [],
|
||||
controller: 'reasoningBank',
|
||||
};
|
||||
@@ -1291,7 +1319,7 @@ export async function bridgeRecordCausalEdge(options: {
|
||||
if (causalGraph && typeof causalGraph.addEdge === 'function') {
|
||||
causalGraph.addEdge(options.sourceId, options.targetId, {
|
||||
relation: options.relation,
|
||||
weight: options.weight || 1.0,
|
||||
weight: options.weight ?? 1.0,
|
||||
timestamp: Date.now(),
|
||||
});
|
||||
return { success: true, controller: 'causalGraph' };
|
||||
@@ -1305,7 +1333,7 @@ export async function bridgeRecordCausalEdge(options: {
|
||||
INSERT OR REPLACE INTO memory_entries (id, key, namespace, content, type, created_at, updated_at, status)
|
||||
VALUES (?, ?, 'causal-edges', ?, 'procedural', ?, ?, 'active')
|
||||
`).run(
|
||||
`edge-${Date.now()}`,
|
||||
generateId('edge'),
|
||||
`${options.sourceId}→${options.targetId}`,
|
||||
JSON.stringify(options),
|
||||
Date.now(), Date.now(),
|
||||
@@ -1413,8 +1441,8 @@ export async function bridgeSessionEnd(options: {
|
||||
value: JSON.stringify({
|
||||
sessionId: options.sessionId,
|
||||
summary: options.summary || 'Session ended',
|
||||
tasksCompleted: options.tasksCompleted || 0,
|
||||
patternsLearned: options.patternsLearned || 0,
|
||||
tasksCompleted: options.tasksCompleted ?? 0,
|
||||
patternsLearned: options.patternsLearned ?? 0,
|
||||
endedAt: new Date().toISOString(),
|
||||
}),
|
||||
namespace: 'session',
|
||||
@@ -1468,7 +1496,7 @@ export async function bridgeRouteTask(options: {
|
||||
if (result) {
|
||||
return {
|
||||
route: result.route || result.category || 'general',
|
||||
confidence: result.confidence || result.score || 0.5,
|
||||
confidence: result.confidence ?? result.score ?? 0.5,
|
||||
agents: result.agents || result.suggestedAgents || [],
|
||||
controller: 'semanticRouter',
|
||||
};
|
||||
@@ -1482,7 +1510,7 @@ export async function bridgeRouteTask(options: {
|
||||
if (rec) {
|
||||
return {
|
||||
route: rec.algorithm || rec.route || 'general',
|
||||
confidence: rec.confidence || 0.5,
|
||||
confidence: rec.confidence ?? 0.5,
|
||||
agents: rec.agents || [],
|
||||
controller: 'learningSystem',
|
||||
};
|
||||
@@ -1526,7 +1554,7 @@ export async function bridgeHealthCheck(
|
||||
const cache = registry.get('tieredCache');
|
||||
if (cache && typeof cache.stats === 'function') {
|
||||
const s = cache.stats();
|
||||
cacheStats = { size: s.size || 0, hits: s.hits || 0, misses: s.misses || 0 };
|
||||
cacheStats = { size: s.size ?? 0, hits: s.hits ?? 0, misses: s.misses ?? 0 };
|
||||
}
|
||||
|
||||
return { available: true, controllers, attestationCount, cacheStats };
|
||||
@@ -1539,40 +1567,89 @@ export async function bridgeHealthCheck(
|
||||
|
||||
/**
|
||||
* Store to hierarchical memory with tier.
|
||||
* Valid tiers: working, episodic, semantic
|
||||
*
|
||||
* Real HierarchicalMemory API (agentdb alpha.10+):
|
||||
* store(content, importance?, tier?, options?) → Promise<string>
|
||||
* Stub API (fallback):
|
||||
* store(key, value, tier) — synchronous
|
||||
*/
|
||||
export async function bridgeHierarchicalStore(params: { key: string; value: string; tier?: string }): Promise<any> {
|
||||
export async function bridgeHierarchicalStore(params: { key: string; value: string; tier?: string; importance?: number }): Promise<any> {
|
||||
const registry = await getRegistry();
|
||||
if (!registry) return null;
|
||||
try {
|
||||
const hm = registry.getController('hierarchicalMemory');
|
||||
const hm = registry.get('hierarchicalMemory');
|
||||
if (!hm) return { success: false, error: 'HierarchicalMemory not available' };
|
||||
await hm.store(params.key, params.value, params.tier || 'working');
|
||||
return { success: true, key: params.key, tier: params.tier || 'working' };
|
||||
const tier = params.tier || 'working';
|
||||
|
||||
// Detect real HierarchicalMemory (has async store returning id) vs stub
|
||||
if (typeof hm.getStats === 'function' && typeof hm.promote === 'function') {
|
||||
// Real agentdb HierarchicalMemory
|
||||
const id = await hm.store(params.value, params.importance || 0.5, tier, {
|
||||
metadata: { key: params.key },
|
||||
tags: [params.key],
|
||||
});
|
||||
return { success: true, id, key: params.key, tier };
|
||||
}
|
||||
// Stub fallback
|
||||
hm.store(params.key, params.value, tier);
|
||||
return { success: true, key: params.key, tier };
|
||||
} catch (e: any) { return { success: false, error: e.message }; }
|
||||
}
|
||||
|
||||
/**
|
||||
* Recall from hierarchical memory.
|
||||
*
|
||||
* Real HierarchicalMemory API (agentdb alpha.10+):
|
||||
* recall(query: MemoryQuery) → Promise<MemoryItem[]>
|
||||
* where MemoryQuery = { query, tier?, k?, threshold?, context?, includeDecayed? }
|
||||
* Stub API (fallback):
|
||||
* recall(query: string, topK: number) → synchronous array
|
||||
*/
|
||||
export async function bridgeHierarchicalRecall(params: { query: string; tier?: string; topK?: number }): Promise<any> {
|
||||
const registry = await getRegistry();
|
||||
if (!registry) return null;
|
||||
try {
|
||||
const hm = registry.getController('hierarchicalMemory');
|
||||
const hm = registry.get('hierarchicalMemory');
|
||||
if (!hm) return { results: [], error: 'HierarchicalMemory not available' };
|
||||
const results = await hm.recall(params.query, params.topK || 5);
|
||||
return { results, controller: 'hierarchicalMemory' };
|
||||
|
||||
// Detect real HierarchicalMemory vs stub
|
||||
if (typeof hm.getStats === 'function' && typeof hm.promote === 'function') {
|
||||
// Real agentdb HierarchicalMemory — recall takes MemoryQuery object
|
||||
const memoryQuery: any = {
|
||||
query: params.query,
|
||||
k: params.topK || 5,
|
||||
};
|
||||
if (params.tier) {
|
||||
memoryQuery.tier = params.tier;
|
||||
}
|
||||
const results = await hm.recall(memoryQuery);
|
||||
return { results: results || [], controller: 'hierarchicalMemory' };
|
||||
}
|
||||
|
||||
// Stub fallback — recall(string, number)
|
||||
const results = hm.recall(params.query, params.topK || 5);
|
||||
const filtered = params.tier
|
||||
? results.filter((r: any) => r.tier === params.tier)
|
||||
: results;
|
||||
return { results: filtered, controller: 'hierarchicalMemory' };
|
||||
} catch (e: any) { return { results: [], error: e.message }; }
|
||||
}
|
||||
|
||||
/**
|
||||
* Run memory consolidation.
|
||||
*
|
||||
* Real MemoryConsolidation API (agentdb alpha.10+):
|
||||
* consolidate() → Promise<ConsolidationReport>
|
||||
* ConsolidationReport = { episodicProcessed, semanticCreated, memoriesForgotten, ... }
|
||||
* Stub API (fallback):
|
||||
* consolidate() → { promoted, pruned, timestamp }
|
||||
*/
|
||||
export async function bridgeConsolidate(params: { minAge?: number; maxEntries?: number }): Promise<any> {
|
||||
const registry = await getRegistry();
|
||||
if (!registry) return null;
|
||||
try {
|
||||
const mc = registry.getController('memoryConsolidation');
|
||||
const mc = registry.get('memoryConsolidation');
|
||||
if (!mc) return { success: false, error: 'MemoryConsolidation not available' };
|
||||
const result = await mc.consolidate();
|
||||
return { success: true, consolidated: result };
|
||||
@@ -1581,18 +1658,44 @@ export async function bridgeConsolidate(params: { minAge?: number; maxEntries?:
|
||||
|
||||
/**
|
||||
* Batch operations (insert, update, delete).
|
||||
* - insert: calls insertEpisodes(entries) where entries are {content, metadata?}
|
||||
* - delete: calls bulkDelete(table, conditions) on episodes table
|
||||
* - update: calls bulkUpdate(table, updates, conditions) on episodes table
|
||||
*/
|
||||
export async function bridgeBatchOperation(params: { operation: string; entries: any[] }): Promise<any> {
|
||||
const registry = await getRegistry();
|
||||
if (!registry) return null;
|
||||
try {
|
||||
const batch = registry.getController('batchOperations');
|
||||
const batch = registry.get('batchOperations');
|
||||
if (!batch) return { success: false, error: 'BatchOperations not available' };
|
||||
let result;
|
||||
switch (params.operation) {
|
||||
case 'insert': result = await batch.insertEpisodes(params.entries); break;
|
||||
case 'delete': result = await batch.bulkDelete(params.entries.map((e: any) => e.key)); break;
|
||||
case 'update': result = await batch.bulkUpdate(params.entries); break;
|
||||
case 'insert': {
|
||||
// insertEpisodes expects [{content, metadata?, embedding?}]
|
||||
const episodes = params.entries.map((e: any) => ({
|
||||
content: e.value || e.content || JSON.stringify(e),
|
||||
metadata: e.metadata || { key: e.key },
|
||||
}));
|
||||
result = await batch.insertEpisodes(episodes);
|
||||
break;
|
||||
}
|
||||
case 'delete': {
|
||||
// bulkDelete(table, conditions) — conditions is a WHERE clause object
|
||||
const keys = params.entries.map((e: any) => e.key).filter(Boolean);
|
||||
for (const key of keys) {
|
||||
await batch.bulkDelete('episodes', { key });
|
||||
}
|
||||
result = { deleted: keys.length };
|
||||
break;
|
||||
}
|
||||
case 'update': {
|
||||
// bulkUpdate(table, updates, conditions)
|
||||
for (const entry of params.entries) {
|
||||
await batch.bulkUpdate('episodes', { content: entry.value || entry.content }, { key: entry.key });
|
||||
}
|
||||
result = { updated: params.entries.length };
|
||||
break;
|
||||
}
|
||||
default: return { success: false, error: `Unknown operation: ${params.operation}` };
|
||||
}
|
||||
return { success: true, operation: params.operation, count: params.entries.length, result };
|
||||
@@ -1601,27 +1704,51 @@ export async function bridgeBatchOperation(params: { operation: string; entries:
|
||||
|
||||
/**
|
||||
* Synthesize context from memories.
|
||||
* ContextSynthesizer.synthesize is a static method that takes MemoryPattern[] (not a string).
|
||||
*/
|
||||
export async function bridgeContextSynthesize(params: { query: string; maxEntries?: number }): Promise<any> {
|
||||
const registry = await getRegistry();
|
||||
if (!registry) return null;
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const ContextSynthesizer = agentdbModule.ContextSynthesizer;
|
||||
if (!ContextSynthesizer) return { success: false, error: 'ContextSynthesizer not available' };
|
||||
const result = ContextSynthesizer.synthesize(params.query, []);
|
||||
const CS = registry.get('contextSynthesizer');
|
||||
if (!CS || typeof CS.synthesize !== 'function') {
|
||||
return { success: false, error: 'ContextSynthesizer not available' };
|
||||
}
|
||||
// Gather memory patterns from hierarchical memory as input
|
||||
const hm = registry.get('hierarchicalMemory');
|
||||
let memories: any[] = [];
|
||||
if (hm && typeof hm.recall === 'function') {
|
||||
// Detect real HierarchicalMemory (MemoryQuery object) vs stub (string, number)
|
||||
let recalled: any[];
|
||||
if (typeof hm.promote === 'function') {
|
||||
// Real agentdb HierarchicalMemory
|
||||
recalled = await hm.recall({ query: params.query, k: params.maxEntries || 10 });
|
||||
} else {
|
||||
// Stub
|
||||
recalled = hm.recall(params.query, params.maxEntries || 10);
|
||||
}
|
||||
memories = (recalled || []).map((r: any) => ({
|
||||
content: r.value || r.content || '',
|
||||
key: r.key || r.id || '',
|
||||
reward: 1,
|
||||
verdict: 'success',
|
||||
}));
|
||||
}
|
||||
const result = CS.synthesize(memories, { includeRecommendations: true });
|
||||
return { success: true, synthesis: result };
|
||||
} catch (e: any) { return { success: false, error: e.message }; }
|
||||
}
|
||||
|
||||
/**
|
||||
* Route via SemanticRouter.
|
||||
* Available since agentdb 3.0.0-alpha.10 — uses @ruvector/router for
|
||||
* semantic matching with keyword fallback.
|
||||
*/
|
||||
export async function bridgeSemanticRoute(params: { input: string }): Promise<any> {
|
||||
const registry = await getRegistry();
|
||||
if (!registry) return null;
|
||||
try {
|
||||
const router = registry.getController('semanticRouter');
|
||||
const router = registry.get('semanticRouter');
|
||||
if (!router) return { route: null, error: 'SemanticRouter not available' };
|
||||
const result = await router.route(params.input);
|
||||
return { route: result, controller: 'semanticRouter' };
|
||||
|
||||
@@ -1485,7 +1485,30 @@ export async function loadEmbeddingModel(options?: {
|
||||
};
|
||||
}
|
||||
|
||||
// Fallback: Check for agentic-flow ONNX
|
||||
// Fallback: Check for agentic-flow ReasoningBank embeddings (v3)
|
||||
const reasoningBank = await import('agentic-flow/reasoningbank').catch(() => null);
|
||||
|
||||
if (reasoningBank?.computeEmbedding) {
|
||||
if (verbose) {
|
||||
console.log('Loading agentic-flow ReasoningBank embedding model...');
|
||||
}
|
||||
|
||||
embeddingModelState = {
|
||||
loaded: true,
|
||||
model: { embed: reasoningBank.computeEmbedding },
|
||||
tokenizer: null,
|
||||
dimensions: 768
|
||||
};
|
||||
|
||||
return {
|
||||
success: true,
|
||||
dimensions: 768,
|
||||
modelName: 'agentic-flow/reasoningbank',
|
||||
loadTime: Date.now() - startTime
|
||||
};
|
||||
}
|
||||
|
||||
// Legacy fallback: Check for agentic-flow core embeddings
|
||||
const agenticFlow = await import('agentic-flow').catch(() => null);
|
||||
|
||||
if (agenticFlow && (agenticFlow as any).embeddings) {
|
||||
|
||||
@@ -532,9 +532,6 @@ export class EnhancedModelRouter {
|
||||
context?: { filePath?: string; originalCode?: string }
|
||||
): Promise<{ success: boolean; confidence: number; output?: string }> {
|
||||
try {
|
||||
// Try to import and use agentic-flow's agent-booster
|
||||
const { execSync } = await import('child_process');
|
||||
|
||||
const filePath = intent.filePath || context?.filePath;
|
||||
if (!filePath || !existsSync(filePath)) {
|
||||
return { success: false, confidence: 0 };
|
||||
@@ -542,7 +539,6 @@ export class EnhancedModelRouter {
|
||||
|
||||
const originalCode = context?.originalCode || readFileSync(filePath, 'utf-8');
|
||||
|
||||
// Build agent-booster command based on intent
|
||||
const intentToInstruction: Record<EditIntentType, string> = {
|
||||
'var-to-const': 'Convert all var declarations to const',
|
||||
'add-types': 'Add TypeScript type annotations',
|
||||
@@ -555,31 +551,42 @@ export class EnhancedModelRouter {
|
||||
const instruction = intentToInstruction[intent.type];
|
||||
const language = intent.language || 'javascript';
|
||||
|
||||
// Try using npx agent-booster
|
||||
const cmd = `npx --yes agent-booster@0.2.2 apply --language ${language}`;
|
||||
|
||||
const result = execSync(cmd, {
|
||||
encoding: 'utf-8',
|
||||
input: JSON.stringify({
|
||||
// Try local agentic-flow agent-booster (v3 — no npx needed)
|
||||
// Note: agent-booster export declared but dist missing in alpha.1; use intelligence path as fallback
|
||||
const boosterModule = await import('agentic-flow/agent-booster')
|
||||
.catch(() => import(/* @vite-ignore */ 'agentic-flow/intelligence/agent-booster-enhanced'))
|
||||
.catch(() => null);
|
||||
if (boosterModule?.enhancedApply) {
|
||||
const result = await boosterModule.enhancedApply({
|
||||
code: originalCode,
|
||||
edit: instruction,
|
||||
}),
|
||||
language,
|
||||
});
|
||||
if (result && result.confidence >= this.config.agentBoosterConfidenceThreshold) {
|
||||
return { success: true, confidence: result.confidence, output: result.output };
|
||||
}
|
||||
return { success: false, confidence: result?.confidence ?? 0 };
|
||||
}
|
||||
|
||||
// Fallback: shell out to npx agent-booster
|
||||
// Sanitize language to prevent command injection (whitelist only)
|
||||
const SAFE_LANGUAGES = ['javascript', 'typescript', 'python', 'rust', 'go', 'java', 'c', 'cpp', 'ruby', 'swift', 'kotlin'];
|
||||
const safeLang = SAFE_LANGUAGES.includes(language) ? language : 'javascript';
|
||||
const { execSync } = await import('child_process');
|
||||
const cmd = `npx --yes agent-booster@0.2.2 apply --language ${safeLang}`;
|
||||
const result = execSync(cmd, {
|
||||
encoding: 'utf-8',
|
||||
input: JSON.stringify({ code: originalCode, edit: instruction }),
|
||||
maxBuffer: 10 * 1024 * 1024,
|
||||
timeout: 5000,
|
||||
stdio: ['pipe', 'pipe', 'pipe'],
|
||||
});
|
||||
|
||||
const parsed = JSON.parse(result);
|
||||
|
||||
if (parsed.confidence >= this.config.agentBoosterConfidenceThreshold) {
|
||||
return {
|
||||
success: true,
|
||||
confidence: parsed.confidence,
|
||||
output: parsed.output,
|
||||
};
|
||||
return { success: true, confidence: parsed.confidence, output: parsed.output };
|
||||
}
|
||||
|
||||
return { success: false, confidence: parsed.confidence || 0 };
|
||||
return { success: false, confidence: parsed.confidence ?? 0 };
|
||||
} catch {
|
||||
// Agent Booster not available or failed
|
||||
return { success: false, confidence: 0 };
|
||||
|
||||
@@ -0,0 +1,109 @@
|
||||
/**
|
||||
* agentic-flow v3 integration bridge
|
||||
*
|
||||
* Provides a single lazy-loading entry point for all agentic-flow v3
|
||||
* subpath exports. Every accessor returns `null` when agentic-flow is
|
||||
* not installed — callers never throw on missing optional dependency.
|
||||
*
|
||||
* @module agentic-flow-bridge
|
||||
*/
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Cached module handles (Promise-based to prevent TOCTOU races)
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
let _reasoningBankP: Promise<typeof import('agentic-flow/reasoningbank') | null> | null = null;
|
||||
let _routerP: Promise<typeof import('agentic-flow/router') | null> | null = null;
|
||||
let _orchestrationP: Promise<typeof import('agentic-flow/orchestration') | null> | null = null;
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Public loaders
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Load the ReasoningBank module (4-step learning pipeline).
|
||||
* Returns null if agentic-flow is not installed.
|
||||
* Race-safe: concurrent callers share the same import Promise.
|
||||
*/
|
||||
export function getReasoningBank() {
|
||||
if (_reasoningBankP === null) {
|
||||
_reasoningBankP = import('agentic-flow/reasoningbank').catch(() => null);
|
||||
}
|
||||
return _reasoningBankP;
|
||||
}
|
||||
|
||||
/**
|
||||
* Load the ModelRouter module (multi-provider LLM routing).
|
||||
* Returns null if agentic-flow is not installed.
|
||||
*/
|
||||
export function getRouter() {
|
||||
if (_routerP === null) {
|
||||
_routerP = import('agentic-flow/router').catch(() => null);
|
||||
}
|
||||
return _routerP;
|
||||
}
|
||||
|
||||
/**
|
||||
* Load the Orchestration module (workflow engine).
|
||||
* Returns null if agentic-flow is not installed.
|
||||
*/
|
||||
export function getOrchestration() {
|
||||
if (_orchestrationP === null) {
|
||||
_orchestrationP = import('agentic-flow/orchestration').catch(() => null);
|
||||
}
|
||||
return _orchestrationP;
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Convenience helpers
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Compute an embedding vector via ReasoningBank, falling back to null.
|
||||
*/
|
||||
export async function computeEmbedding(text: string): Promise<number[] | null> {
|
||||
const rb = await getReasoningBank();
|
||||
if (!rb?.computeEmbedding) return null;
|
||||
return rb.computeEmbedding(text);
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve memories matching a query via ReasoningBank.
|
||||
*/
|
||||
export async function retrieveMemories(query: string, opts?: { k?: number }): Promise<any[]> {
|
||||
const rb = await getReasoningBank();
|
||||
if (!rb?.retrieveMemories) return [];
|
||||
return rb.retrieveMemories(query, opts);
|
||||
}
|
||||
|
||||
/**
|
||||
* Check whether agentic-flow v3 is available at runtime.
|
||||
*/
|
||||
export async function isAvailable(): Promise<boolean> {
|
||||
const rb = await getReasoningBank();
|
||||
return rb !== null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return a summary of available agentic-flow v3 capabilities.
|
||||
*/
|
||||
export async function capabilities(): Promise<{
|
||||
available: boolean;
|
||||
reasoningBank: boolean;
|
||||
router: boolean;
|
||||
orchestration: boolean;
|
||||
version: string | null;
|
||||
}> {
|
||||
const [rb, router, orch] = await Promise.all([
|
||||
getReasoningBank(),
|
||||
getRouter(),
|
||||
getOrchestration(),
|
||||
]);
|
||||
return {
|
||||
available: rb !== null || router !== null || orch !== null,
|
||||
reasoningBank: rb !== null,
|
||||
router: router !== null,
|
||||
orchestration: orch !== null,
|
||||
version: (rb as any)?.VERSION ?? null,
|
||||
};
|
||||
}
|
||||
+83
-8
@@ -20,17 +20,92 @@ declare module 'sql.js' {
|
||||
}
|
||||
|
||||
declare module 'agentic-flow' {
|
||||
const agenticFlow: any;
|
||||
export default agenticFlow;
|
||||
export const ReasoningBank: any;
|
||||
export const VERSION: string;
|
||||
export const reasoningbank: any;
|
||||
}
|
||||
|
||||
declare module 'agentic-flow/reasoningbank' {
|
||||
const reasoningBank: any;
|
||||
export default reasoningBank;
|
||||
export const ReasoningBank: any;
|
||||
export function retrieveMemories(...args: any[]): any;
|
||||
export const VERSION: string;
|
||||
export const PAPER_URL: string;
|
||||
export class ReflexionMemory { constructor(...args: any[]); }
|
||||
export class SkillLibrary { constructor(...args: any[]); }
|
||||
export class CausalMemoryGraph { constructor(...args: any[]); }
|
||||
export class HybridReasoningBank { constructor(...args: any[]); }
|
||||
export class AdvancedMemorySystem { constructor(...args: any[]); }
|
||||
export class EmbeddingService { constructor(...args: any[]); }
|
||||
export class NightlyLearner { constructor(...args: any[]); }
|
||||
export function initialize(...args: any[]): Promise<any>;
|
||||
export function retrieveMemories(query: string, opts?: any): Promise<any[]>;
|
||||
export function formatMemoriesForPrompt(memories: any[]): string;
|
||||
export function judgeTrajectory(...args: any[]): any;
|
||||
export function distillMemories(...args: any[]): any;
|
||||
export function consolidate(...args: any[]): any;
|
||||
export function shouldConsolidate(...args: any[]): boolean;
|
||||
export function computeEmbedding(text: string): Promise<number[]>;
|
||||
export function cosineSimilarity(a: number[], b: number[]): number;
|
||||
export function clearEmbeddingCache(): void;
|
||||
export function containsPII(text: string): boolean;
|
||||
export function scrubPII(text: string): string;
|
||||
export function scrubMemory(text: string): string;
|
||||
export function mmrSelection(items: any[], query: any, opts?: any): any[];
|
||||
export function runTask(...args: any[]): Promise<any>;
|
||||
export function loadConfig(): any;
|
||||
export const db: any;
|
||||
export function CausalRecall(...args: any[]): any;
|
||||
export function mattsParallel(...args: any[]): any;
|
||||
export function mattsSequential(...args: any[]): any;
|
||||
}
|
||||
|
||||
declare module 'agentic-flow/router' {
|
||||
export class ModelRouter { constructor(...args: any[]); route(prompt: string, opts?: any): Promise<any>; getStats(): any; }
|
||||
export class AnthropicProvider { constructor(...args: any[]); }
|
||||
export class GeminiProvider { constructor(...args: any[]); }
|
||||
export class OpenRouterProvider { constructor(...args: any[]); }
|
||||
export class ONNXLocalProvider { constructor(...args: any[]); }
|
||||
export const CLAUDE_MODELS: any;
|
||||
export function getModelName(id: string): string;
|
||||
export function listModels(): any[];
|
||||
export function mapModelId(id: string): string;
|
||||
}
|
||||
|
||||
declare module 'agentic-flow/orchestration' {
|
||||
export function createOrchestrator(...args: any[]): any;
|
||||
export function createOrchestrationClient(...args: any[]): any;
|
||||
export function seedMemory(...args: any[]): Promise<any>;
|
||||
export function searchMemory(...args: any[]): Promise<any>;
|
||||
export function harvestMemory(...args: any[]): Promise<any>;
|
||||
export function recordLearning(...args: any[]): Promise<any>;
|
||||
export function getRunStatus(id: string): Promise<any>;
|
||||
export function getRunArtifacts(id: string): Promise<any>;
|
||||
export function cancelRun(id: string): Promise<any>;
|
||||
}
|
||||
|
||||
declare module 'agentic-flow/agent-booster' {
|
||||
export class EnhancedAgentBooster { constructor(...args: any[]); }
|
||||
export function getEnhancedBooster(...args: any[]): any;
|
||||
export function enhancedApply(opts: { code: string; edit: string; language?: string }): Promise<{ confidence: number; output: string }>;
|
||||
export function benchmark(...args: any[]): Promise<any>;
|
||||
}
|
||||
|
||||
declare module 'agentic-flow/intelligence/agent-booster-enhanced' {
|
||||
export class EnhancedAgentBooster { constructor(...args: any[]); }
|
||||
export function getEnhancedBooster(...args: any[]): any;
|
||||
export function enhancedApply(opts: { code: string; edit: string; language?: string }): Promise<{ confidence: number; output: string }>;
|
||||
export function benchmark(...args: any[]): Promise<any>;
|
||||
}
|
||||
|
||||
declare module 'agentic-flow/sdk' {
|
||||
const sdk: any;
|
||||
export default sdk;
|
||||
}
|
||||
|
||||
declare module 'agentic-flow/security' {
|
||||
const security: any;
|
||||
export default security;
|
||||
}
|
||||
|
||||
declare module 'agentic-flow/transport/quic' {
|
||||
const quic: any;
|
||||
export default quic;
|
||||
}
|
||||
|
||||
declare module 'ruvector' {
|
||||
|
||||
@@ -30,7 +30,7 @@ const COMPATIBILITY_MATRIX: Record<string, Record<string, PackageCompatibility>>
|
||||
},
|
||||
'@claude-flow/integration': {
|
||||
'@claude-flow/cli': { minVersion: '3.0.0-alpha.70' },
|
||||
'agentic-flow': { minVersion: '0.1.0' },
|
||||
'agentic-flow': { minVersion: '3.0.0-alpha.1' },
|
||||
},
|
||||
};
|
||||
|
||||
|
||||
@@ -15,7 +15,7 @@
|
||||
"build": "tsc"
|
||||
},
|
||||
"dependencies": {
|
||||
"agentdb": "^3.0.0-alpha.9",
|
||||
"agentdb": "^3.0.0-alpha.10",
|
||||
"sql.js": "^1.10.3"
|
||||
},
|
||||
"optionalDependencies": {
|
||||
|
||||
@@ -23,7 +23,7 @@ import { LearningBridge } from './learning-bridge.js';
|
||||
import type { LearningBridgeConfig } from './learning-bridge.js';
|
||||
import { MemoryGraph } from './memory-graph.js';
|
||||
import type { MemoryGraphConfig } from './memory-graph.js';
|
||||
import { CacheManager, TieredCacheManager } from './cache-manager.js';
|
||||
import { TieredCacheManager } from './cache-manager.js';
|
||||
import type { CacheConfig } from './types.js';
|
||||
|
||||
// ===== Types =====
|
||||
@@ -222,6 +222,7 @@ export class ControllerRegistry extends EventEmitter {
|
||||
*/
|
||||
async initialize(config: RuntimeConfig = {}): Promise<void> {
|
||||
if (this.initialized) return;
|
||||
this.initialized = true; // Set early to prevent concurrent re-entry
|
||||
|
||||
this.config = config;
|
||||
const startTime = performance.now();
|
||||
@@ -270,7 +271,6 @@ export class ControllerRegistry extends EventEmitter {
|
||||
}
|
||||
|
||||
this.initTimeMs = performance.now() - startTime;
|
||||
this.initialized = true;
|
||||
this.emit('initialized', {
|
||||
initTimeMs: this.initTimeMs,
|
||||
activeControllers: this.getActiveCount(),
|
||||
@@ -459,6 +459,16 @@ export class ControllerRegistry extends EventEmitter {
|
||||
*/
|
||||
private async initAgentDB(config: RuntimeConfig): Promise<void> {
|
||||
try {
|
||||
// Validate dbPath to prevent path traversal
|
||||
const dbPath = config.dbPath || ':memory:';
|
||||
if (dbPath !== ':memory:') {
|
||||
const resolved = require('path').resolve(dbPath);
|
||||
if (resolved.includes('..')) {
|
||||
this.emit('agentdb:unavailable', { reason: 'Invalid dbPath' });
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const AgentDBClass = agentdbModule.AgentDB || agentdbModule.default;
|
||||
|
||||
@@ -467,18 +477,19 @@ export class ControllerRegistry extends EventEmitter {
|
||||
return;
|
||||
}
|
||||
|
||||
this.agentdb = new AgentDBClass({
|
||||
dbPath: config.dbPath || ':memory:',
|
||||
});
|
||||
this.agentdb = new AgentDBClass({ dbPath });
|
||||
|
||||
// Suppress agentdb's info-level console.log during init
|
||||
// Suppress agentdb's noisy info-level output during init
|
||||
// using stderr redirect instead of monkey-patching console.log
|
||||
const origLog = console.log;
|
||||
console.log = (...args: unknown[]) => {
|
||||
const suppressFilter = (args: unknown[]) => {
|
||||
const msg = String(args[0] ?? '');
|
||||
if (msg.includes('Transformers.js') ||
|
||||
return msg.includes('Transformers.js') ||
|
||||
msg.includes('better-sqlite3') ||
|
||||
msg.includes('[AgentDB]')) return;
|
||||
origLog.apply(console, args);
|
||||
msg.includes('[AgentDB]');
|
||||
};
|
||||
console.log = (...args: unknown[]) => {
|
||||
if (!suppressFilter(args)) origLog.apply(console, args);
|
||||
};
|
||||
try {
|
||||
await this.agentdb.initialize();
|
||||
@@ -488,8 +499,7 @@ export class ControllerRegistry extends EventEmitter {
|
||||
this.emit('agentdb:initialized');
|
||||
} catch (error) {
|
||||
const msg = error instanceof Error ? error.message : String(error);
|
||||
this.emit('agentdb:unavailable', { reason: msg });
|
||||
// AgentDB not available — CLI-layer controllers can still work
|
||||
this.emit('agentdb:unavailable', { reason: msg.substring(0, 200) });
|
||||
this.agentdb = null;
|
||||
}
|
||||
}
|
||||
@@ -542,10 +552,13 @@ export class ControllerRegistry extends EventEmitter {
|
||||
case 'mmrDiversityRanker':
|
||||
return this.agentdb !== null;
|
||||
|
||||
// SemanticRouter — auto-enable if agentdb available (exported since alpha.10)
|
||||
case 'semanticRouter':
|
||||
return this.agentdb !== null;
|
||||
|
||||
// Optional controllers
|
||||
case 'hybridSearch':
|
||||
case 'agentMemoryScope':
|
||||
case 'semanticRouter':
|
||||
case 'sonaTrajectory':
|
||||
case 'federatedSession':
|
||||
return false; // Require explicit enabling
|
||||
@@ -655,16 +668,18 @@ export class ControllerRegistry extends EventEmitter {
|
||||
// Agent memory scope — placeholder, activated when explicitly enabled
|
||||
return null;
|
||||
|
||||
case 'semanticRouter':
|
||||
// Delegate to AgentDB's SemanticRouter if available
|
||||
if (this.agentdb && typeof this.agentdb.getController === 'function') {
|
||||
case 'semanticRouter': {
|
||||
// SemanticRouter exported from agentdb 3.0.0-alpha.10 (ADR-062)
|
||||
// Constructor: () — requires initialize() after construction
|
||||
try {
|
||||
return this.agentdb.getController('semanticRouter');
|
||||
} catch {
|
||||
return null;
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const SR = agentdbModule.SemanticRouter;
|
||||
if (!SR) return null;
|
||||
const router = new SR();
|
||||
await router.initialize();
|
||||
return router;
|
||||
} catch { return null; }
|
||||
}
|
||||
}
|
||||
return null;
|
||||
|
||||
case 'sonaTrajectory':
|
||||
// Delegate to AgentDB's SonaTrajectoryService if available
|
||||
@@ -678,63 +693,224 @@ export class ControllerRegistry extends EventEmitter {
|
||||
return null;
|
||||
|
||||
case 'hierarchicalMemory': {
|
||||
// HierarchicalMemory exported from agentdb 3.0.0-alpha.10 (ADR-066 Phase P2-3)
|
||||
// Constructor: (db, embedder, vectorBackend?, graphBackend?, config?)
|
||||
if (!this.agentdb) return this.createTieredMemoryStub();
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const HierarchicalMemoryClass = agentdbModule.HierarchicalMemory;
|
||||
if (!HierarchicalMemoryClass) return null;
|
||||
const hm = new HierarchicalMemoryClass(this.agentdb?.database);
|
||||
const HM = agentdbModule.HierarchicalMemory;
|
||||
if (!HM) return this.createTieredMemoryStub();
|
||||
const embedder = this.createEmbeddingService();
|
||||
const hm = new HM(this.agentdb.database, embedder);
|
||||
await hm.initializeDatabase();
|
||||
return hm;
|
||||
} catch { return null; }
|
||||
} catch {
|
||||
return this.createTieredMemoryStub();
|
||||
}
|
||||
}
|
||||
|
||||
case 'memoryConsolidation': {
|
||||
// MemoryConsolidation exported from agentdb 3.0.0-alpha.10 (ADR-066 Phase P2-3)
|
||||
// Constructor: (db, hierarchicalMemory, embedder, vectorBackend?, graphBackend?, config?)
|
||||
if (!this.agentdb) return this.createConsolidationStub();
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const MemConsolidation = agentdbModule.MemoryConsolidation;
|
||||
if (!MemConsolidation) return null;
|
||||
const mc = new MemConsolidation(this.agentdb?.database);
|
||||
const MC = agentdbModule.MemoryConsolidation;
|
||||
if (!MC) return this.createConsolidationStub();
|
||||
// Get the HierarchicalMemory instance (must be initialized at level 1 before us at level 3)
|
||||
const hm: any = this.get('hierarchicalMemory');
|
||||
if (!hm || typeof hm.recall !== 'function' || typeof hm.store !== 'function') {
|
||||
return this.createConsolidationStub();
|
||||
}
|
||||
const embedder = this.createEmbeddingService();
|
||||
const mc = new MC(this.agentdb.database, hm, embedder);
|
||||
await mc.initializeDatabase();
|
||||
return mc;
|
||||
} catch { return null; }
|
||||
} catch {
|
||||
return this.createConsolidationStub();
|
||||
}
|
||||
}
|
||||
|
||||
case 'federatedSession':
|
||||
// Federated session — placeholder for Phase 4
|
||||
return null;
|
||||
|
||||
// ----- AgentDB-internal controllers -----
|
||||
// These are accessed via agentdb.getController() and registered
|
||||
// here for health tracking and lifecycle management.
|
||||
// ----- AgentDB-internal controllers (via getController) -----
|
||||
// AgentDB.getController() only supports: reflexion/memory, skills, causalGraph/causal
|
||||
case 'reasoningBank': {
|
||||
// ReasoningBank is exported directly, not via getController
|
||||
if (!this.agentdb) return null;
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const RB = agentdbModule.ReasoningBank;
|
||||
if (!RB) return null;
|
||||
return new RB(this.agentdb.database);
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'reasoningBank':
|
||||
case 'skills':
|
||||
case 'reflexion':
|
||||
case 'causalGraph':
|
||||
case 'causalRecall':
|
||||
case 'learningSystem':
|
||||
case 'explainableRecall':
|
||||
case 'nightlyLearner':
|
||||
case 'graphTransformer':
|
||||
case 'mutationGuard':
|
||||
case 'attestationLog':
|
||||
case 'vectorBackend':
|
||||
case 'graphAdapter':
|
||||
case 'batchOperations':
|
||||
case 'contextSynthesizer':
|
||||
case 'gnnService':
|
||||
case 'rvfOptimizer':
|
||||
case 'mmrDiversityRanker':
|
||||
case 'guardedVectorBackend': {
|
||||
if (!this.agentdb || typeof this.agentdb.getController !== 'function') {
|
||||
return null;
|
||||
}
|
||||
case 'causalGraph': {
|
||||
if (!this.agentdb || typeof this.agentdb.getController !== 'function') return null;
|
||||
try {
|
||||
const controller = this.agentdb.getController(name);
|
||||
return controller ?? null;
|
||||
} catch {
|
||||
return null;
|
||||
return this.agentdb.getController(name) ?? null;
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'causalRecall': {
|
||||
if (!this.agentdb) return null;
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const CR = agentdbModule.CausalRecall;
|
||||
if (!CR) return null;
|
||||
return new CR(this.agentdb.database);
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'learningSystem': {
|
||||
if (!this.agentdb) return null;
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const LS = agentdbModule.LearningSystem;
|
||||
if (!LS) return null;
|
||||
return new LS(this.agentdb.database);
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'explainableRecall': {
|
||||
if (!this.agentdb) return null;
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const ER = agentdbModule.ExplainableRecall;
|
||||
if (!ER) return null;
|
||||
return new ER(this.agentdb.database);
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'nightlyLearner': {
|
||||
if (!this.agentdb) return null;
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const NL = agentdbModule.NightlyLearner;
|
||||
if (!NL) return null;
|
||||
return new NL(this.agentdb.database);
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'graphTransformer': {
|
||||
if (!this.agentdb) return null;
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const GT = agentdbModule.CausalMemoryGraph;
|
||||
if (!GT) return null;
|
||||
return new GT(this.agentdb.database);
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
// ----- Direct-instantiation controllers -----
|
||||
case 'batchOperations': {
|
||||
if (!this.agentdb) return null;
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const BO = agentdbModule.BatchOperations;
|
||||
if (!BO) return null;
|
||||
const embedder = this.config.embeddingGenerator || null;
|
||||
return new BO(this.agentdb.database, embedder);
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'contextSynthesizer': {
|
||||
// ContextSynthesizer.synthesize is static — return the class itself
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
return agentdbModule.ContextSynthesizer ?? null;
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'mmrDiversityRanker': {
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const MMR = agentdbModule.MMRDiversityRanker;
|
||||
if (!MMR) return null;
|
||||
return new MMR();
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'mutationGuard': {
|
||||
// MutationGuard exported from agentdb 3.0.0-alpha.10 (ADR-060)
|
||||
// Constructor: (config?) where config.dimension, config.maxElements, config.enableWasmProofs
|
||||
if (!this.agentdb) return null;
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const MG = agentdbModule.MutationGuard;
|
||||
if (!MG) return null;
|
||||
return new MG({ dimension: this.config.dimension || 384 });
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'attestationLog': {
|
||||
// AttestationLog exported from agentdb 3.0.0-alpha.10 (ADR-060)
|
||||
// Constructor: (db) — uses database for append-only audit log
|
||||
if (!this.agentdb) return null;
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const AL = agentdbModule.AttestationLog;
|
||||
if (!AL) return null;
|
||||
return new AL(this.agentdb.database);
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'gnnService': {
|
||||
// GNNService exported from agentdb 3.0.0-alpha.10 (ADR-062)
|
||||
// Constructor: (config?) — requires initialize() after construction
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const GNN = agentdbModule.GNNService;
|
||||
if (!GNN) return null;
|
||||
const gnn = new GNN({ inputDim: this.config.dimension || 384 });
|
||||
await gnn.initialize();
|
||||
return gnn;
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'rvfOptimizer': {
|
||||
// RVFOptimizer exported from agentdb 3.0.0-alpha.10 (ADR-062/065)
|
||||
// Constructor: (config?) — no-arg for defaults
|
||||
try {
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const RVF = agentdbModule.RVFOptimizer;
|
||||
if (!RVF) return null;
|
||||
return new RVF();
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'guardedVectorBackend': {
|
||||
// GuardedVectorBackend exported from agentdb 3.0.0-alpha.10 (ADR-060)
|
||||
// Constructor: (innerBackend, mutationGuard, attestationLog?)
|
||||
// Requires vectorBackend and mutationGuard to be initialized first (level 2)
|
||||
if (!this.agentdb) return null;
|
||||
try {
|
||||
const vb = this.get('vectorBackend');
|
||||
const guard = this.get('mutationGuard');
|
||||
if (!vb || !guard) return null;
|
||||
const agentdbModule: any = await import('agentdb');
|
||||
const GVB = agentdbModule.GuardedVectorBackend;
|
||||
if (!GVB) return null;
|
||||
const log = this.get('attestationLog');
|
||||
return new GVB(vb, guard, log || undefined);
|
||||
} catch { return null; }
|
||||
}
|
||||
|
||||
case 'vectorBackend':
|
||||
case 'graphAdapter': {
|
||||
// These are accessed via AgentDB internal state, not direct construction
|
||||
if (!this.agentdb) return null;
|
||||
try {
|
||||
if (typeof this.agentdb.getController === 'function') {
|
||||
return this.agentdb.getController(name) ?? null;
|
||||
}
|
||||
} catch { /* fallthrough */ }
|
||||
return null;
|
||||
}
|
||||
|
||||
default:
|
||||
@@ -752,9 +928,9 @@ export class ControllerRegistry extends EventEmitter {
|
||||
try {
|
||||
const instance = entry.instance as any;
|
||||
|
||||
// Try known shutdown methods
|
||||
// Try known shutdown methods (always await for safety)
|
||||
if (typeof instance.destroy === 'function') {
|
||||
instance.destroy();
|
||||
await instance.destroy();
|
||||
} else if (typeof instance.shutdown === 'function') {
|
||||
await instance.shutdown();
|
||||
} else if (typeof instance.close === 'function') {
|
||||
@@ -767,6 +943,83 @@ export class ControllerRegistry extends EventEmitter {
|
||||
entry.enabled = false;
|
||||
entry.instance = null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create an EmbeddingService for controllers that need it.
|
||||
* Uses the config's embedding generator or creates a minimal local service.
|
||||
*/
|
||||
private createEmbeddingService(): any {
|
||||
// If user provided an embedding generator, wrap it
|
||||
if (this.config.embeddingGenerator) {
|
||||
return {
|
||||
embed: async (text: string) => this.config.embeddingGenerator!(text),
|
||||
embedBatch: async (texts: string[]) => Promise.all(texts.map(t => this.config.embeddingGenerator!(t))),
|
||||
initialize: async () => {},
|
||||
};
|
||||
}
|
||||
// Return a minimal stub — HierarchicalMemory falls back to manualSearch without embeddings
|
||||
return {
|
||||
embed: async () => new Float32Array(this.config.dimension || 384),
|
||||
embedBatch: async (texts: string[]) => texts.map(() => new Float32Array(this.config.dimension || 384)),
|
||||
initialize: async () => {},
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Lightweight in-memory tiered store (fallback when HierarchicalMemory
|
||||
* cannot be initialized from agentdb).
|
||||
* Enforces per-tier size limits to prevent unbounded memory growth.
|
||||
*/
|
||||
private createTieredMemoryStub() {
|
||||
const MAX_PER_TIER = 5000;
|
||||
const tiers: Record<string, Map<string, { value: string; ts: number }>> = {
|
||||
working: new Map(),
|
||||
episodic: new Map(),
|
||||
semantic: new Map(),
|
||||
};
|
||||
return {
|
||||
store(key: string, value: string, tier = 'working') {
|
||||
const t = tiers[tier] || tiers.working;
|
||||
// Evict oldest if at capacity
|
||||
if (t.size >= MAX_PER_TIER) {
|
||||
const oldest = t.keys().next().value;
|
||||
if (oldest !== undefined) t.delete(oldest);
|
||||
}
|
||||
t.set(key, { value: value.substring(0, 100_000), ts: Date.now() });
|
||||
},
|
||||
recall(query: string, topK = 5) {
|
||||
const safeTopK = Math.min(Math.max(1, topK), 100);
|
||||
const q = query.toLowerCase().substring(0, 10_000);
|
||||
const results: Array<{ key: string; value: string; tier: string; ts: number }> = [];
|
||||
for (const [tierName, map] of Object.entries(tiers)) {
|
||||
for (const [key, entry] of map) {
|
||||
if (key.toLowerCase().includes(q) || entry.value.toLowerCase().includes(q)) {
|
||||
results.push({ key, value: entry.value, tier: tierName, ts: entry.ts });
|
||||
if (results.length >= safeTopK * 3) break; // Early exit for large stores
|
||||
}
|
||||
}
|
||||
}
|
||||
return results.sort((a, b) => b.ts - a.ts).slice(0, safeTopK);
|
||||
},
|
||||
getTierStats() {
|
||||
return Object.fromEntries(
|
||||
Object.entries(tiers).map(([name, map]) => [name, map.size]),
|
||||
);
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* No-op consolidation stub (fallback when MemoryConsolidation
|
||||
* cannot be initialized from agentdb).
|
||||
*/
|
||||
private createConsolidationStub() {
|
||||
return {
|
||||
consolidate() {
|
||||
return { promoted: 0, pruned: 0, timestamp: Date.now() };
|
||||
},
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
export default ControllerRegistry;
|
||||
@@ -0,0 +1,581 @@
|
||||
# ADR-054: RVF-Powered Plugin Marketplace & Hosted Registry
|
||||
|
||||
**Status:** Proposed
|
||||
**Date:** 2026-02-25
|
||||
**Authors:** RuvNet, Claude Flow Team
|
||||
**Version:** 1.0.0
|
||||
**Related:** ADR-053 (Controller Activation), ADR-006 (Unified Memory), ADR-009 (Hybrid Memory Backend), ADR-049 (Self-Learning Memory GNN), ADR-050 (Intelligence Loop)
|
||||
|
||||
## Context
|
||||
|
||||
The Claude Flow plugin ecosystem currently comprises 20 plugins distributed via IPFS (Pinata), discovered through a static JSON registry (`QmXbfEAaR7D2Ujm4GAkbwcGZQMHqAMpwDoje4583uNP834`), and searched via keyword substring matching. While functional, this approach has critical limitations as the ecosystem grows:
|
||||
|
||||
1. **Search is keyword-only** — `searchPlugins()` in `search.ts` does case-insensitive substring matching across name, description, tags, keywords. A query like "I need permission management" won't find `@claude-flow/claims` unless the user knows the exact term "claims."
|
||||
|
||||
2. **Recommendations are primitive** — `findSimilarPlugins()` uses a static scoring formula: tag overlap (2x) + category match (3x) + type match (2x) + author match (1x). No learning from actual install patterns.
|
||||
|
||||
3. **No dependency intelligence** — Dependencies are a flat list. No transitive resolution, no conflict detection, no ecosystem analysis.
|
||||
|
||||
4. **Static popularity** — Downloads and ratings are baked into the registry JSON at publish time. No real-time trending, no decay.
|
||||
|
||||
5. **No behavioral context** — The system cannot observe that a developer working on security tasks should be shown security plugins, or that users who install `@claude-flow/security` almost always also install `@claude-flow/claims`.
|
||||
|
||||
Meanwhile, AgentDB v3 (activated in ADR-053) provides a full RuVector Framework (RVF) stack — 13 active controllers with HNSW vector search, graph databases, causal inference, learning systems, skill libraries, and proof-gated mutations — all currently with **zero plugin system consumers**.
|
||||
|
||||
### Available RVF Infrastructure (from ADR-053 audit)
|
||||
|
||||
| Controller | Level | Key Methods | Plugin Marketplace Applicability |
|
||||
|---|---|---|---|
|
||||
| **ReasoningBank** | L1 | `storePattern`, `searchPatterns`, `searchPatternsV2`, `getPatternStats` | Pattern storage for plugin usage patterns |
|
||||
| **TieredCache** | L1 | `get`, `set`, `delete`, `getStats` | Hot plugin metadata caching |
|
||||
| **GuardedVectorBackend** | L2 | `insert`, `search`, `insertBatch`, `remove` | HNSW-indexed semantic plugin search (150x-12,500x faster) |
|
||||
| **MutationGuard** | L2 | `proveInsert`, `proveSearch`, `validateToken` | Proof-gated plugin publishing (tamper resistance) |
|
||||
| **SkillLibrary** | L3 | `createSkill`, `searchSkills`, `getSkillPlan`, `consolidateEpisodesIntoSkills` | Map plugins to capabilities ("OAuth" skill → security plugin) |
|
||||
| **ExplainableRecall** | L3 | `createCertificate`, `getJustification`, `traceProvenance` | Auditable search results ("why was this plugin recommended?") |
|
||||
| **ReflexionMemory** | L3 | `storeEpisode`, `retrieveRelevant`, `getSuccessStrategies` | Learn from install/uninstall episodes |
|
||||
| **AttestationLog** | L3 | `record`, `query`, `getDenialPatterns` | Immutable audit trail for publish/install actions |
|
||||
| **CausalMemoryGraph** | L4 | `addCausalEdge`, `createExperiment`, `calculateUplift`, `getCausalChain` | Dependency graph analysis, A/B testing plugin recommendations |
|
||||
| **NightlyLearner** | L4 | `run`, `consolidateEpisodes`, `discoverCausalEdges` | Batch learning: "users who install X install Y" |
|
||||
| **LearningSystem** | L4 | `startSession`, `predict`, `submitFeedback`, `train` | Online learning for search relevance |
|
||||
| **GraphTransformer** | L5 | `sublinearAttention`, `causalAttention`, `gameTheoreticAttention` | Advanced ranking with graph neural attention |
|
||||
| **GraphDatabaseAdapter** | L6 | `storeEpisode`, `storeSkill`, `createEdge`, `query` | Plugin relationship graph persistence |
|
||||
|
||||
### Current Plugin System Files
|
||||
|
||||
| File | Lines | Purpose |
|
||||
|---|---|---|
|
||||
| `src/plugins/store/discovery.ts` | ~600 | IPFS registry fetch, CID resolution, cache, demo fallback |
|
||||
| `src/plugins/store/search.ts` | ~400 | Keyword search, filtering, sorting, similar plugins |
|
||||
| `src/plugins/store/types.ts` | ~300 | `PluginEntry`, `PluginRegistry`, `PluginCategory` types |
|
||||
| `src/commands/plugins.ts` | ~800 | CLI: list, search, install, uninstall, upgrade, toggle, info, create, rate |
|
||||
|
||||
### EmbeddingService Available
|
||||
|
||||
AgentDB's `EmbeddingService` (Xenova/all-MiniLM-L6-v2, 384 dimensions) is already wired through `memory-bridge.ts` as of ADR-053 Phase 2. It provides:
|
||||
- `embed(text)` — single text to 384-dim vector
|
||||
- `embedBatch(texts)` — batch embedding
|
||||
- `clearCache()` — cache management
|
||||
|
||||
## Decision
|
||||
|
||||
**Wire the RVF stack into the plugin marketplace** through a new `PluginIntelligence` layer that sits between the existing search/discovery code and AgentDB controllers. The approach is phased, with each phase independently valuable and backward-compatible.
|
||||
|
||||
### Architecture
|
||||
|
||||
```
|
||||
CLI Plugin Commands
|
||||
│
|
||||
▼
|
||||
┌─────────────────────┐
|
||||
│ PluginIntelligence │ ← NEW: Orchestrates RVF controllers for plugin ops
|
||||
│ (plugin-intel.ts) │
|
||||
└───┬───┬───┬───┬─────┘
|
||||
│ │ │ │
|
||||
▼ ▼ ▼ ▼
|
||||
┌───┐ ┌───┐ ┌───┐ ┌───┐
|
||||
│Vec│ │Gra│ │Ski│ │Lea│ ← AgentDB controllers via ControllerRegistry
|
||||
│tor│ │ph │ │ll │ │rn │
|
||||
│Bkd│ │Adp│ │Lib│ │Sys│
|
||||
└───┘ └───┘ └───┘ └───┘
|
||||
│ │ │ │
|
||||
▼ ▼ ▼ ▼
|
||||
┌─────────────────────┐
|
||||
│ AgentDB (SQLite + │
|
||||
│ better-sqlite3) │
|
||||
└─────────────────────┘
|
||||
```
|
||||
|
||||
The existing IPFS registry remains the **source of truth** for plugin metadata. RVF provides the **intelligence layer** on top — semantic search, recommendations, graphs, learning. If RVF is unavailable, the system falls back to the existing keyword search (same graceful degradation pattern as ADR-053).
|
||||
|
||||
## Implementation Phases
|
||||
|
||||
### Phase 1: Semantic Plugin Search (High Priority)
|
||||
|
||||
**Goal:** Replace keyword substring matching with vector similarity search.
|
||||
|
||||
**Controllers Used:** `EmbeddingService`, `GuardedVectorBackend`, `TieredCache`
|
||||
|
||||
**Design:**
|
||||
|
||||
1. **Index plugins on registry load.** When `fetchRegistry()` succeeds, embed each plugin's searchable text and store in the vector backend:
|
||||
|
||||
```typescript
|
||||
// plugin-intel.ts
|
||||
async function indexPlugins(plugins: PluginEntry[]): Promise<void> {
|
||||
const registry = await getControllerRegistry();
|
||||
const agentdb = registry.getAgentDB();
|
||||
const vectorBackend = registry.get('vectorBackend');
|
||||
|
||||
for (const plugin of plugins) {
|
||||
const searchText = [
|
||||
plugin.displayName,
|
||||
plugin.description,
|
||||
...plugin.tags,
|
||||
...plugin.keywords,
|
||||
plugin.categories.join(' '),
|
||||
].join(' ');
|
||||
|
||||
const embedding = await agentdb.embedder.embed(searchText);
|
||||
await vectorBackend.insert({
|
||||
id: plugin.id,
|
||||
vector: new Float32Array(embedding),
|
||||
metadata: { pluginId: plugin.id, type: plugin.type, trustLevel: plugin.trustLevel },
|
||||
});
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
2. **Semantic search with hybrid fallback.** New `semanticSearchPlugins()` that uses vector search for intent matching, keyword search for exact matches, and merges results:
|
||||
|
||||
```typescript
|
||||
async function semanticSearchPlugins(
|
||||
query: string,
|
||||
options: SearchOptions,
|
||||
): Promise<SearchResults> {
|
||||
// Vector search: finds plugins by intent
|
||||
const embedding = await agentdb.embedder.embed(query);
|
||||
const vectorResults = await vectorBackend.search({
|
||||
vector: new Float32Array(embedding),
|
||||
k: options.limit * 2,
|
||||
});
|
||||
|
||||
// Keyword search: finds plugins by exact terms (existing logic)
|
||||
const keywordResults = keywordSearch(query, options);
|
||||
|
||||
// Merge: vector results get semantic score, keyword results get term score
|
||||
// Dedup by plugin ID, take max score
|
||||
return mergeAndRank(vectorResults, keywordResults, options);
|
||||
}
|
||||
```
|
||||
|
||||
3. **Cache hot queries.** Use `TieredCache` to cache embeddings and search results:
|
||||
|
||||
```typescript
|
||||
const cache = registry.get('tieredCache');
|
||||
const cacheKey = `plugin-search:${query}:${JSON.stringify(options)}`;
|
||||
const cached = await cache.get(cacheKey);
|
||||
if (cached) return cached;
|
||||
// ... run search ...
|
||||
await cache.set(cacheKey, results, { ttl: 300 }); // 5 min
|
||||
```
|
||||
|
||||
**Impact:** "permission management" finds `@claude-flow/claims`. "machine learning" finds `@claude-flow/neural`. "code quality" finds `@claude-flow/plugin-agentic-qe`. Zero change to plugin commands — the search function is transparently upgraded.
|
||||
|
||||
**Files Modified:**
|
||||
- `src/plugins/store/search.ts` — add `semanticSearchPlugins()`, modify `searchPlugins()` to try semantic first
|
||||
- `src/plugins/store/discovery.ts` — call `indexPlugins()` after registry fetch
|
||||
|
||||
**New Files:**
|
||||
- `src/plugins/intelligence/plugin-intel.ts` — RVF orchestration layer (~200 lines)
|
||||
|
||||
### Phase 2: Plugin Dependency Graph (High Priority)
|
||||
|
||||
**Goal:** Build a graph of plugin relationships for dependency analysis, ecosystem detection, and hub identification.
|
||||
|
||||
**Controllers Used:** `GraphDatabaseAdapter`, `CausalMemoryGraph`
|
||||
|
||||
**Design:**
|
||||
|
||||
1. **Build graph on registry load.** Nodes = plugins, edges = dependencies + co-installation + category membership:
|
||||
|
||||
```typescript
|
||||
async function buildPluginGraph(plugins: PluginEntry[]): Promise<void> {
|
||||
const graphAdapter = registry.get('graphAdapter');
|
||||
|
||||
for (const plugin of plugins) {
|
||||
// Node for each plugin
|
||||
await graphAdapter.createNode({
|
||||
id: plugin.id,
|
||||
type: 'plugin',
|
||||
metadata: { category: plugin.categories[0], trustLevel: plugin.trustLevel },
|
||||
});
|
||||
|
||||
// Dependency edges
|
||||
for (const dep of plugin.dependencies || []) {
|
||||
await graphAdapter.createEdge({
|
||||
source: plugin.id,
|
||||
target: dep.name,
|
||||
type: 'depends_on',
|
||||
weight: 1.0,
|
||||
});
|
||||
}
|
||||
|
||||
// Category membership edges
|
||||
for (const cat of plugin.categories) {
|
||||
await graphAdapter.createEdge({
|
||||
source: plugin.id,
|
||||
target: `category:${cat}`,
|
||||
type: 'member_of',
|
||||
weight: 0.5,
|
||||
});
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
2. **Expose graph queries in CLI:**
|
||||
|
||||
```bash
|
||||
# Show transitive dependencies
|
||||
npx claude-flow plugins deps @claude-flow/security --transitive
|
||||
|
||||
# Find plugin ecosystems (community detection)
|
||||
npx claude-flow plugins ecosystems
|
||||
|
||||
# Show hub plugins (highest PageRank)
|
||||
npx claude-flow plugins hubs
|
||||
|
||||
# Check for conflicts
|
||||
npx claude-flow plugins conflicts @claude-flow/plugin-a @claude-flow/plugin-b
|
||||
```
|
||||
|
||||
3. **Graph-enhanced search ranking.** Blend vector similarity with PageRank:
|
||||
|
||||
```typescript
|
||||
// combinedScore = 0.7 * semanticScore + 0.2 * pageRank + 0.1 * popularityNorm
|
||||
```
|
||||
|
||||
**Impact:** Developers see plugin ecosystems, can trace dependency chains, and search results favor foundational plugins.
|
||||
|
||||
**Files Modified:**
|
||||
- `src/commands/plugins.ts` — add `deps`, `ecosystems`, `hubs`, `conflicts` subcommands
|
||||
|
||||
**New Files:**
|
||||
- `src/plugins/intelligence/plugin-graph.ts` — graph construction and queries (~250 lines)
|
||||
|
||||
### Phase 3: Behavioral Recommendations (Medium Priority)
|
||||
|
||||
**Goal:** Learn from install/uninstall/search patterns to recommend plugins.
|
||||
|
||||
**Controllers Used:** `ReflexionMemory`, `LearningSystem`, `NightlyLearner`
|
||||
|
||||
**Design:**
|
||||
|
||||
1. **Record episodes on plugin actions.** Every install, uninstall, search, and rating creates a ReflexionMemory episode:
|
||||
|
||||
```typescript
|
||||
async function recordPluginAction(
|
||||
action: 'install' | 'uninstall' | 'search' | 'rate',
|
||||
pluginId: string,
|
||||
context: { query?: string; rating?: number; agentType?: string },
|
||||
): Promise<void> {
|
||||
const reflexion = registry.get('reflexion');
|
||||
|
||||
await reflexion.storeEpisode({
|
||||
task: `plugin-${action}`,
|
||||
actions: [{ type: action, target: pluginId, ...context }],
|
||||
outcome: action === 'uninstall' ? 'negative' : 'positive',
|
||||
critique: action === 'uninstall'
|
||||
? `User removed ${pluginId} — may indicate quality issue or mismatch`
|
||||
: `User ${action}ed ${pluginId}`,
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
2. **Predict next plugin.** Use `LearningSystem` to predict what plugin a developer needs based on current context:
|
||||
|
||||
```typescript
|
||||
async function recommendPlugins(
|
||||
context: { installedPlugins: string[]; currentTask?: string; agentType?: string },
|
||||
): Promise<PluginRecommendation[]> {
|
||||
const learningSystem = registry.get('learningSystem');
|
||||
|
||||
const session = await learningSystem.startSession({
|
||||
state: context,
|
||||
availableActions: allPluginIds,
|
||||
});
|
||||
|
||||
const predictions = await learningSystem.predict(session.id);
|
||||
// Returns ranked plugin IDs with confidence scores
|
||||
|
||||
return predictions.map(p => ({
|
||||
pluginId: p.action,
|
||||
confidence: p.score,
|
||||
reason: p.explanation,
|
||||
}));
|
||||
}
|
||||
```
|
||||
|
||||
3. **Nightly consolidation.** `NightlyLearner` runs as a daemon worker to consolidate episodes into stable patterns:
|
||||
|
||||
```typescript
|
||||
// In daemon worker 'consolidate':
|
||||
async function consolidatePluginPatterns(): Promise<void> {
|
||||
const nightlyLearner = registry.get('nightlyLearner');
|
||||
await nightlyLearner.run({
|
||||
domains: ['plugin-install', 'plugin-search', 'plugin-rate'],
|
||||
consolidateEpisodes: true,
|
||||
discoverCausalEdges: true, // "installing security CAUSES installing claims"
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
**Impact:** "Users who install X also install Y" recommendations. Real-time trending. Personalized plugin suggestions based on developer workflow.
|
||||
|
||||
**New CLI Features:**
|
||||
```bash
|
||||
npx claude-flow plugins recommend # Based on installed plugins + context
|
||||
npx claude-flow plugins trending # Real-time trending (not static)
|
||||
npx claude-flow plugins why @claude-flow/X # "Why is this recommended?"
|
||||
```
|
||||
|
||||
**Files Modified:**
|
||||
- `src/commands/plugins.ts` — add `recommend`, `trending`, `why` subcommands
|
||||
- `src/plugins/store/search.ts` — integrate recommendations into search results
|
||||
|
||||
**New Files:**
|
||||
- `src/plugins/intelligence/plugin-learning.ts` — episode recording + recommendations (~300 lines)
|
||||
|
||||
### Phase 4: Skill-to-Plugin Mapping (Medium Priority)
|
||||
|
||||
**Goal:** Map developer intents to plugin capabilities using SkillLibrary.
|
||||
|
||||
**Controllers Used:** `SkillLibrary`, `SemanticRouter`
|
||||
|
||||
**Design:**
|
||||
|
||||
1. **Register plugins as skills.** Each plugin's capabilities become searchable skills:
|
||||
|
||||
```typescript
|
||||
async function registerPluginSkills(plugin: PluginEntry): Promise<void> {
|
||||
const skills = registry.get('skills');
|
||||
|
||||
// Primary skill from plugin description
|
||||
await skills.createSkill({
|
||||
name: `plugin:${plugin.id}`,
|
||||
description: plugin.description,
|
||||
category: plugin.categories[0],
|
||||
metadata: { pluginId: plugin.id, commands: plugin.commands, hooks: plugin.hooks },
|
||||
});
|
||||
|
||||
// Per-export skills
|
||||
for (const exp of plugin.exports || []) {
|
||||
await skills.createSkill({
|
||||
name: `export:${plugin.id}:${exp}`,
|
||||
description: `${exp} from ${plugin.displayName}`,
|
||||
category: 'plugin-export',
|
||||
metadata: { pluginId: plugin.id, export: exp },
|
||||
});
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
2. **Intent-to-plugin routing.** Developer describes what they need, system finds which plugin provides it:
|
||||
|
||||
```bash
|
||||
npx claude-flow plugins find-for "validate user input with schemas"
|
||||
# → @claude-flow/security (InputValidator — Zod-based validation)
|
||||
# → @claude-flow/claims (claims-based authorization)
|
||||
|
||||
npx claude-flow plugins find-for "train neural patterns from code"
|
||||
# → @claude-flow/neural (SONA, MoE, EWC++)
|
||||
# → @claude-flow/plugin-neural-coordinator
|
||||
```
|
||||
|
||||
**Impact:** Developers discover plugins by describing what they want to do, not what the plugin is called.
|
||||
|
||||
### Phase 5: Proof-Gated Publishing (Low Priority)
|
||||
|
||||
**Goal:** Tamper-resistant plugin publishing with cryptographic attestation.
|
||||
|
||||
**Controllers Used:** `MutationGuard`, `AttestationLog`, `ExplainableRecall`
|
||||
|
||||
**Design:**
|
||||
|
||||
1. **Proof-gated publish.** Every plugin publish generates a proof token validated by MutationGuard:
|
||||
|
||||
```typescript
|
||||
async function publishPlugin(plugin: PluginEntry, authorKey: string): Promise<string> {
|
||||
const guard = registry.get('mutationGuard');
|
||||
const attestation = registry.get('attestationLog');
|
||||
|
||||
// Generate proof of valid publish
|
||||
const token = await guard.createToken(authorKey);
|
||||
const proof = await guard.proveInsert(token, plugin.id, pluginEmbedding);
|
||||
|
||||
// Record in immutable attestation log
|
||||
await attestation.record({
|
||||
action: 'plugin-publish',
|
||||
actor: authorKey,
|
||||
target: plugin.id,
|
||||
proof: proof.hash,
|
||||
metadata: { version: plugin.version, checksum: plugin.checksum },
|
||||
});
|
||||
|
||||
// Upload to IPFS with proof attached
|
||||
const cid = await uploadToIPFS({ ...plugin, proof });
|
||||
return cid;
|
||||
}
|
||||
```
|
||||
|
||||
2. **Verify on install.** Before installing, verify the proof chain:
|
||||
|
||||
```typescript
|
||||
async function verifyPlugin(plugin: PluginEntry): Promise<VerificationResult> {
|
||||
const recall = registry.get('explainableRecall');
|
||||
|
||||
// Create verification certificate
|
||||
const cert = await recall.createCertificate({
|
||||
query: `verify:${plugin.id}@${plugin.version}`,
|
||||
results: [{ id: plugin.id, score: 1.0 }],
|
||||
});
|
||||
|
||||
// Trace provenance
|
||||
const provenance = await recall.traceProvenance(plugin.id);
|
||||
|
||||
return {
|
||||
verified: cert.verified,
|
||||
provenance,
|
||||
justification: await recall.getJustification(cert.id),
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
**Impact:** Immutable publish history. Tamper detection. Provenance for every installed plugin.
|
||||
|
||||
### Phase 6: Hosted Marketplace API (Low Priority)
|
||||
|
||||
**Goal:** Expose the RVF-powered plugin intelligence as a hosted HTTP API for external consumers (web UI, IDE extensions, CI/CD).
|
||||
|
||||
**Design:**
|
||||
|
||||
```
|
||||
┌──────────────────────────┐
|
||||
│ Hosted Marketplace UI │ ← Web frontend (React/Next.js)
|
||||
└──────────┬───────────────┘
|
||||
│ HTTP/REST
|
||||
▼
|
||||
┌──────────────────────────┐
|
||||
│ Marketplace API Server │ ← Express/Hono, deployed as service
|
||||
│ /api/plugins/search │
|
||||
│ /api/plugins/recommend │
|
||||
│ /api/plugins/graph │
|
||||
│ /api/plugins/trending │
|
||||
│ /api/plugins/verify │
|
||||
│ /api/plugins/publish │
|
||||
└──────────┬───────────────┘
|
||||
│
|
||||
▼
|
||||
┌──────────────────────────┐
|
||||
│ PluginIntelligence │ ← Same layer used by CLI
|
||||
│ + ControllerRegistry │
|
||||
│ + AgentDB │
|
||||
└──────────────────────────┘
|
||||
```
|
||||
|
||||
**API Endpoints:**
|
||||
|
||||
| Endpoint | Method | Description |
|
||||
|---|---|---|
|
||||
| `/api/plugins/search` | POST | Semantic search with filters |
|
||||
| `/api/plugins/recommend` | GET | Context-aware recommendations |
|
||||
| `/api/plugins/graph` | GET | Plugin dependency graph (JSON) |
|
||||
| `/api/plugins/graph/ecosystems` | GET | Community detection results |
|
||||
| `/api/plugins/trending` | GET | Real-time trending (learning-based) |
|
||||
| `/api/plugins/verify/:id` | GET | Proof verification + provenance |
|
||||
| `/api/plugins/publish` | POST | Proof-gated plugin submission |
|
||||
| `/api/plugins/stats` | GET | Registry-wide analytics |
|
||||
| `/api/plugins/:id/similar` | GET | Semantically similar plugins |
|
||||
| `/api/plugins/:id/why` | GET | Explainable recommendation |
|
||||
|
||||
**Deployment Options:**
|
||||
- **Self-hosted**: `npx claude-flow marketplace start --port 3001`
|
||||
- **Serverless**: Deploy as Cloudflare Worker / Vercel Edge Function with SQLite (D1/Turso)
|
||||
- **MCP Server**: Expose as MCP tool for Claude Code integration
|
||||
|
||||
## Performance Targets
|
||||
|
||||
| Metric | Current (keyword) | Target (RVF) | Mechanism |
|
||||
|---|---|---|---|
|
||||
| Search latency (20 plugins) | <5ms | <5ms | TieredCache hot path |
|
||||
| Search latency (1000 plugins) | ~50ms (linear scan) | <10ms | HNSW index (O(log n)) |
|
||||
| Search latency (10k plugins) | ~500ms | <15ms | HNSW index + cache |
|
||||
| Recommendation latency | N/A | <50ms | LearningSystem predict |
|
||||
| Graph query (PageRank) | N/A | <100ms | Pre-computed on load |
|
||||
| Publish verification | N/A | <200ms | MutationGuard proof |
|
||||
| Index build (1000 plugins) | N/A | <30s | Batch embed + insert |
|
||||
|
||||
## Migration Strategy
|
||||
|
||||
### Backward Compatibility
|
||||
|
||||
All phases use the same graceful degradation as ADR-053:
|
||||
|
||||
```typescript
|
||||
async function searchPlugins(query: string, options: SearchOptions) {
|
||||
// Try semantic search (RVF)
|
||||
const intel = await getPluginIntelligence();
|
||||
if (intel) {
|
||||
const results = await intel.semanticSearch(query, options);
|
||||
if (results) return results;
|
||||
}
|
||||
|
||||
// Fallback: existing keyword search (always works)
|
||||
return keywordSearchPlugins(query, options);
|
||||
}
|
||||
```
|
||||
|
||||
If `@claude-flow/memory` or AgentDB is unavailable, every feature falls back to the existing implementation. Zero breaking changes.
|
||||
|
||||
### Registry Format
|
||||
|
||||
The IPFS registry JSON format is **unchanged**. RVF indexing happens client-side on registry load. The hosted marketplace API adds server-side indexing for web consumers but the registry remains the canonical source.
|
||||
|
||||
### Rollout
|
||||
|
||||
| Phase | Scope | Risk | Rollback |
|
||||
|---|---|---|---|
|
||||
| Phase 1 (Semantic Search) | Client-side only | Low — fallback to keyword | Remove bridge call |
|
||||
| Phase 2 (Dependency Graph) | Client-side only | Low — additive commands | Remove commands |
|
||||
| Phase 3 (Recommendations) | Client-side + daemon | Medium — learning state | Clear learning DB |
|
||||
| Phase 4 (Skill Mapping) | Client-side only | Low — additive | Remove skill index |
|
||||
| Phase 5 (Proof Publishing) | Registry format change | Medium — new field | Ignore proof field |
|
||||
| Phase 6 (Hosted API) | New service | Low — independent | Stop service |
|
||||
|
||||
## Risks and Mitigations
|
||||
|
||||
| Risk | Impact | Mitigation |
|
||||
|---|---|---|
|
||||
| Embedding model download (100MB+) blocks first search | High latency on first use | Pre-warm in `daemon start`; cache model in `.claude-flow/models/` |
|
||||
| Small registry (20 plugins) doesn't benefit from HNSW | Overhead without benefit | Skip HNSW when `registry.plugins.length < 100`; use brute-force cosine for small sets |
|
||||
| Learning from small install base may overfit | Bad recommendations | Require minimum 5 episodes before activating recommendations; blend with global popularity |
|
||||
| Graph transformer NAPI-RS binary may fail on some platforms | Feature unavailable | 4-tier fallback (native → WASM → legacy WASM → pure JS) already in place |
|
||||
| Proof-gated publishing adds friction for plugin authors | Slower adoption | Make proofs optional in Phase 5; only required for `trustLevel: 'official'` |
|
||||
|
||||
## Alternatives Considered
|
||||
|
||||
### 1. External Search Service (Algolia, Meilisearch)
|
||||
|
||||
**Rejected.** Adds external dependency, network latency, and hosting cost. RVF runs locally with the same SQLite database already in use. For a hosted marketplace, RVF can be deployed alongside the API server without a separate search service.
|
||||
|
||||
### 2. OpenAI Embeddings API
|
||||
|
||||
**Rejected for default.** Requires API key and network. AgentDB's local Xenova/all-MiniLM-L6-v2 works offline. However, `EmbeddingService.embedOpenAI()` is available as an opt-in upgrade for higher-quality embeddings (1536-dim).
|
||||
|
||||
### 3. Build Custom Plugin Search from Scratch
|
||||
|
||||
**Rejected.** AgentDB already provides vector search, graph database, learning system, proof engine, and attestation log. Building these from scratch would duplicate 10,000+ lines of tested code.
|
||||
|
||||
## Success Metrics
|
||||
|
||||
| Metric | Target | Measurement |
|
||||
|---|---|---|
|
||||
| Search relevance (MRR@5) | >0.8 | Manual evaluation on 50 test queries |
|
||||
| Recommendation accuracy | >70% install rate on top-3 | Track install/dismiss ratio |
|
||||
| Graph query accuracy | 100% transitive deps correct | Compare with `npm ls` equivalent |
|
||||
| Publish verification | 0 false positives | Proof validation against known-good set |
|
||||
| Search latency p99 | <50ms (1000 plugins) | Benchmark suite |
|
||||
| User satisfaction | >4.0/5.0 | Plugin rating system |
|
||||
|
||||
## References
|
||||
|
||||
- ADR-053: AgentDB v3 Controller Activation
|
||||
- ADR-006: Unified Memory Service
|
||||
- ADR-009: Hybrid Memory Backend
|
||||
- ADR-049: Self-Learning Memory GNN
|
||||
- ADR-050: Intelligence Loop
|
||||
- Plugin Store Types: `v3/@claude-flow/cli/src/plugins/store/types.ts`
|
||||
- Plugin Search: `v3/@claude-flow/cli/src/plugins/store/search.ts`
|
||||
- Plugin Discovery: `v3/@claude-flow/cli/src/plugins/store/discovery.ts`
|
||||
- ControllerRegistry: `v3/@claude-flow/memory/src/controller-registry.ts`
|
||||
- AgentDB: `agentdb@3.0.0-alpha.7`
|
||||
@@ -0,0 +1,113 @@
|
||||
# ADR-055: AgentDB v3 Controller Bug Remediation
|
||||
|
||||
## Status
|
||||
Accepted (Updated 2026-02-27 for agentdb 3.0.0-alpha.10)
|
||||
|
||||
## Date
|
||||
2026-02-26
|
||||
|
||||
## Context
|
||||
|
||||
ADR-053 introduced 8 new controllers and 6 MCP tools for AgentDB v3 integration. A deep review revealed 7 critical bugs, 5 high-severity issues, and several medium issues that made all 6 new tools non-functional.
|
||||
|
||||
### Root Causes (alpha.9)
|
||||
|
||||
1. **API mismatch**: `AgentDB.getController()` only supports 3 controller names (`reflexion`, `skills`, `causalGraph`) but code delegated 7 additional names to it
|
||||
2. **Missing exports**: `HierarchicalMemory`, `MemoryConsolidation`, `SemanticRouter`, `GNNService`, `RVFOptimizer`, `GuardedVectorBackend` are not exported from agentdb 3.0.0-alpha.9
|
||||
3. **Wrong method names**: Bridge functions called `registry.getController()` but the correct method is `registry.get()`
|
||||
4. **Wrong constructor signatures**: `BatchOperations` requires `(db, embedder, config)`, not just `(db)`
|
||||
5. **Wrong method signatures**: `bulkDelete(table, conditions)` not `bulkDelete(keyArray)`, `bulkUpdate(table, updates, conditions)` not `bulkUpdate(entriesArray)`
|
||||
6. **Static vs instance**: `ContextSynthesizer.synthesize()` is static, takes `MemoryPattern[]` not a string
|
||||
7. **Wrong tier names**: Code used `shortTerm/longTerm` but real tiers are `episodic/semantic`
|
||||
|
||||
## Decision
|
||||
|
||||
### Phase 1 Fixes (alpha.9 — 2026-02-26)
|
||||
|
||||
| # | Category | Fix |
|
||||
|---|----------|-----|
|
||||
| C1 | Method name | `registry.getController()` → `registry.get()` in all 6 bridge functions |
|
||||
| C2 | Missing export | HierarchicalMemory → lightweight in-memory tiered stub with `store/recall/getTierStats` |
|
||||
| C3 | Missing export | MemoryConsolidation → no-op stub returning `{promoted, pruned, timestamp}` |
|
||||
| C4 | Wrong signatures | BatchOperations: `insertEpisodes([{content,metadata}])`, `bulkDelete(table, conditions)`, `bulkUpdate(table, updates, conditions)` |
|
||||
| C5 | Wrong argument | ContextSynthesizer: gather patterns from hierarchical memory first, pass `Pattern[]` to static `synthesize()` |
|
||||
| C6 | getController | Only delegate `reflexion`, `skills`, `causalGraph` to AgentDB. All others instantiated directly from exports or return null |
|
||||
| C7 | Tier names | `shortTerm/longTerm` → `episodic/semantic` in MCP tool schemas and README |
|
||||
| H1 | Race condition | Set `this.initialized = true` before async init to prevent concurrent re-entry |
|
||||
| H2 | Shutdown | `instance.destroy()` now awaited |
|
||||
| H3 | Input validation | All 6 MCP tool handlers validate required params before calling bridge |
|
||||
| H4 | SemanticRouter | Documented as unavailable (not exported from agentdb) with clear error message |
|
||||
|
||||
### Phase 2 Upgrades (alpha.10 — 2026-02-27)
|
||||
|
||||
agentdb 3.0.0-alpha.10 now exports all 8 previously-missing controllers. Upgraded from stubs/null to real implementations:
|
||||
|
||||
| # | Controller | Change |
|
||||
|---|-----------|--------|
|
||||
| U1 | HierarchicalMemory | Stub → real `HierarchicalMemory(db, embedder)` with Ebbinghaus forgetting curves, spaced repetition, 3-tier persistence |
|
||||
| U2 | MemoryConsolidation | Stub → real `MemoryConsolidation(db, hm, embedder)` with episodic→semantic clustering, forgetting curves |
|
||||
| U3 | SemanticRouter | null → real `SemanticRouter()` with `@ruvector/router` native + keyword fallback |
|
||||
| U4 | GNNService | null → real `GNNService(config)` with `@ruvector/gnn` native + JS fallback |
|
||||
| U5 | RVFOptimizer | null → real `RVFOptimizer()` with 4/8/16-bit quantization, dedup, pruning, batch embed |
|
||||
| U6 | MutationGuard | null → real `MutationGuard(config)` for proof-gated state mutation (ADR-060) |
|
||||
| U7 | AttestationLog | null → real `AttestationLog(db)` for append-only audit log |
|
||||
| U8 | GuardedVectorBackend | null → real `GuardedVectorBackend(inner, guard, log?)` wrapping vectorBackend with proof gates |
|
||||
|
||||
### Bridge API Compatibility
|
||||
|
||||
Bridge functions now detect real vs stub HierarchicalMemory and call the correct API:
|
||||
|
||||
| Operation | Real API (alpha.10) | Stub API (fallback) |
|
||||
|-----------|---------------------|---------------------|
|
||||
| store | `store(content, importance, tier, {metadata, tags})` → `Promise<string>` | `store(key, value, tier)` — sync |
|
||||
| recall | `recall({query, tier?, k?})` → `Promise<MemoryItem[]>` | `recall(query, topK)` — sync array |
|
||||
| consolidate | `consolidate()` → `Promise<ConsolidationReport>` | `consolidate()` → `{promoted, pruned, timestamp}` |
|
||||
|
||||
Detection: real HierarchicalMemory has `promote()` and async `getStats()` methods that stubs lack.
|
||||
|
||||
### Controller Instantiation Strategy (Updated)
|
||||
|
||||
```
|
||||
AgentDB.getController() → reflexion, skills, causalGraph, vectorBackend, graphAdapter
|
||||
Direct import + new() → ReasoningBank, CausalRecall, LearningSystem,
|
||||
ExplainableRecall, NightlyLearner, CausalMemoryGraph,
|
||||
BatchOperations, MMRDiversityRanker,
|
||||
HierarchicalMemory, MemoryConsolidation,
|
||||
GNNService, RVFOptimizer, SemanticRouter,
|
||||
MutationGuard, AttestationLog, GuardedVectorBackend
|
||||
Static class reference → ContextSynthesizer (synthesize is static)
|
||||
Fallback stubs → HierarchicalMemory, MemoryConsolidation (if agentdb unavailable)
|
||||
```
|
||||
|
||||
### Constructor Signatures (alpha.10)
|
||||
|
||||
| Controller | Constructor | Notes |
|
||||
|-----------|-------------|-------|
|
||||
| HierarchicalMemory | `(db, embedder, vectorBackend?, graphBackend?, config?)` | Requires `initializeDatabase()` |
|
||||
| MemoryConsolidation | `(db, hierarchicalMemory, embedder, vectorBackend?, graphBackend?, config?)` | Depends on HierarchicalMemory (level 1 → level 3) |
|
||||
| SemanticRouter | `()` | Requires `initialize()` |
|
||||
| GNNService | `(config?)` | Requires `initialize()`. Config: `{inputDim, hiddenDim, outputDim, heads}` |
|
||||
| RVFOptimizer | `()` | No-arg constructor, self-contained |
|
||||
| MutationGuard | `(config?)` | Config: `{dimension, maxElements, enableWasmProofs}` |
|
||||
| AttestationLog | `(db)` | Uses database for append-only audit |
|
||||
| GuardedVectorBackend | `(innerBackend, mutationGuard, attestationLog?)` | Wraps vectorBackend + mutationGuard |
|
||||
|
||||
## Consequences
|
||||
|
||||
- All 6 MCP tools fully functional with real agentdb controllers
|
||||
- HierarchicalMemory now has persistent 3-tier storage with Ebbinghaus decay curves
|
||||
- MemoryConsolidation clusters episodic memories into semantic patterns
|
||||
- SemanticRouter enables intent-based routing with `@ruvector/router` or keyword fallback
|
||||
- GNNService provides graph neural network intent classification and skill recommendations
|
||||
- RVFOptimizer enables 4-bit quantization (8x compression) and batch embedding
|
||||
- MutationGuard + AttestationLog + GuardedVectorBackend complete the ADR-060 proof-gated mutation chain
|
||||
- Fallback stubs preserved for environments without agentdb
|
||||
- No regression in existing 445 CLI tests
|
||||
|
||||
## Files Changed
|
||||
|
||||
- `v3/@claude-flow/memory/src/controller-registry.ts` — 8 controllers upgraded from stub/null to real instantiation, added `createEmbeddingService()` helper
|
||||
- `v3/@claude-flow/cli/src/memory/memory-bridge.ts` — Bridge functions detect real vs stub API, updated recall/store/consolidate signatures
|
||||
- `v3/@claude-flow/cli/src/mcp-tools/agentdb-tools.ts` — Tier enum, input validation (phase 1)
|
||||
- `v3/@claude-flow/memory/package.json` — agentdb dependency `^3.0.0-alpha.10`
|
||||
- `README.md` — Tier names, capacity/TTL claims, RVFOptimizer categorization (phase 1)
|
||||
@@ -0,0 +1,283 @@
|
||||
# ADR-056: agentic-flow 3.0.0-alpha.1 Integration
|
||||
|
||||
## Status
|
||||
Accepted (2026-02-27)
|
||||
|
||||
## Date
|
||||
2026-02-27
|
||||
|
||||
## Context
|
||||
|
||||
The `agentic-flow` package is the upstream coordination engine that powers claude-flow's ReasoningBank, Router, Agent Booster, QUIC transport, and intelligence subsystems. The major version upgrade from 2.0.7 to 3.0.0-alpha.1 introduces breaking changes, new modules, and a complete rewrite of the build pipeline.
|
||||
|
||||
### Previous State (2.0.7)
|
||||
|
||||
- Older SDK integration (`@anthropic-ai/sdk ^0.39`)
|
||||
- No WASM modules
|
||||
- No ReasoningBank pipeline
|
||||
- No FastMCP 3.x support
|
||||
- No Federation or Billing subsystems
|
||||
- Known transitive vulnerabilities (sqlite3, tar)
|
||||
|
||||
### Upgrade Motivation
|
||||
|
||||
1. **Zero vulnerabilities** — sqlite3 removed from agentdb peer deps, vitest upgraded to v4
|
||||
2. **FastMCP 3.x** — Zod-validated MCP tools with streaming support
|
||||
3. **WASM acceleration** — ReasoningBank (211 KB) and QUIC transport (127 KB)
|
||||
4. **AgentDB v3 controllers** — 8 controllers now fully exported (ADR-055 Phase 2)
|
||||
5. **Claude Agent SDK** — `@anthropic-ai/claude-agent-sdk ^0.1.5` integration
|
||||
6. **Modern dependencies** — Express 5.1, Anthropic SDK 0.65, Zod 3.25
|
||||
|
||||
## Decision
|
||||
|
||||
Upgrade `agentic-flow` from `^2.0.7` to `^3.0.0-alpha.1` in `@claude-flow/cli`, preserving all lazy-import patterns and fallback behavior.
|
||||
|
||||
### Package Overview
|
||||
|
||||
| Metric | Value |
|
||||
|--------|-------|
|
||||
| Version | 3.0.0-alpha.1 |
|
||||
| Package size | 32 MB installed |
|
||||
| Dist files | 595 `.d.ts` + 629 `.js` |
|
||||
| WASM modules | 2 (ReasoningBank 211 KB, QUIC 127 KB) |
|
||||
| Export subpaths | 10 |
|
||||
| Dependencies | 20 runtime |
|
||||
| Binaries | `agentic-flow`, `agentdb` |
|
||||
|
||||
### Export Subpaths
|
||||
|
||||
| Subpath | Module | Purpose |
|
||||
|---------|--------|---------|
|
||||
| `.` | `dist/index.js` | Core orchestration, agents, types |
|
||||
| `./orchestration` | `dist/orchestration/index.js` | Workflow orchestration engine |
|
||||
| `./sdk` | `dist/sdk/index.js` | E2B, plugins, security, streaming |
|
||||
| `./security` | `dist/security/index.js` | Input validation, threat detection |
|
||||
| `./reasoningbank` | `dist/reasoningbank/index.js` | 4-step learning pipeline (RETRIEVE→JUDGE→DISTILL→CONSOLIDATE) |
|
||||
| `./reasoningbank/backend-selector` | Backend auto-selection | SQLite/WASM backend routing |
|
||||
| `./reasoningbank/wasm-adapter` | WASM adapter | Browser-compatible WASM binding |
|
||||
| `./router` | `dist/router/index.js` | ModelRouter with multi-provider support |
|
||||
| `./agent-booster` | `dist/agent-booster/index.js` | WASM-accelerated code transforms |
|
||||
| `./transport/quic` | `dist/transport/quic.js` | QUIC/UDP transport layer |
|
||||
|
||||
### Module Architecture (37 dist directories)
|
||||
|
||||
```
|
||||
dist/
|
||||
├── agentdb/ # AgentDB CLI and controllers
|
||||
├── agents/ # 7 agent types (claudeAgent, directApi, webResearch, codeReview, data, claudeFlow, claudeAgentDirect)
|
||||
├── benchmarks/ # Performance benchmarking
|
||||
├── billing/ # 5-tier metering and subscriptions
|
||||
├── cli/ # CLI proxy and wrappers
|
||||
├── config/ # Configuration management
|
||||
├── coordination/ # Multi-agent coordination primitives
|
||||
├── core/ # Core engine and types
|
||||
├── dashboard/ # Monitoring dashboard
|
||||
├── db/ # Database layer
|
||||
├── embeddings/ # Vector embedding engine
|
||||
├── federation/ # EphemeralAgent, FederationHub
|
||||
├── hooks/ # Hook system (pre/post edit/command/task)
|
||||
├── intelligence/ # RuVector: SONA, HNSW, EWC++, EmbeddingCache, EmbeddingService
|
||||
├── llm/ # Multi-provider LLM integration
|
||||
├── mcp/ # FastMCP 3.x servers + 33+ MCP tools
|
||||
├── memory/ # Memory management
|
||||
├── middleware/ # Rate limiting
|
||||
├── optimizations/ # Performance optimizations
|
||||
├── orchestration/ # Workflow orchestration
|
||||
├── packages/ # Sub-package management
|
||||
├── proxy/ # Anthropic→OpenRouter proxy, QUIC proxy
|
||||
├── reasoningbank/ # 4-step learning pipeline with WASM
|
||||
├── router/ # Model routing (4+ providers)
|
||||
├── routing/ # Request routing
|
||||
├── sdk/ # E2B, plugins, security, streaming
|
||||
├── security/ # Input validation, threat detection
|
||||
├── services/ # Background services
|
||||
├── swarm/ # Swarm orchestration
|
||||
├── transport/ # QUIC/UDP transport
|
||||
├── types/ # TypeScript type definitions
|
||||
├── utils/ # Shared utilities
|
||||
├── wasm/ # WASM module loaders
|
||||
└── workers/ # Background workers
|
||||
```
|
||||
|
||||
### MCP Tools (33+ via FastMCP 3.x)
|
||||
|
||||
| Category | Tool Files | Tools |
|
||||
|----------|-----------|-------|
|
||||
| Agent | add-agent, add-command, execute, list, parallel | Agent lifecycle |
|
||||
| Hooks | pre/post-edit, pre/post-command, pretrain, route, explain, metrics, transfer, intelligence-bridge, intelligence-tools, benchmark, build-agents | 15 hook tools |
|
||||
| Swarm | init, spawn, orchestrate, p2p-swarm | Swarm coordination |
|
||||
| Memory | memory-tools | Store/search/retrieve |
|
||||
| Neural | neural-tools, sona-tools, sona-rvf-tools | Neural pattern training |
|
||||
| Performance | performance-tools, quantization-tools | Profiling and optimization |
|
||||
| Infrastructure | infrastructure-tools, streaming-tools | System management |
|
||||
| Intelligence | attention-tools, ruvector-tools, rvf-tools, gnn-tools | RuVector subsystem |
|
||||
| Specialized | consensus-tools, cost-optimizer, daa-tools, explainability, github-tools, hidden-controllers, quic-tools, workflow-tools, autopilot-tools, session-tools | Domain-specific |
|
||||
| Agent Booster | agent-booster-tools, enhanced-booster-tools | WASM code transforms |
|
||||
|
||||
### FastMCP Server Modes
|
||||
|
||||
| Server | Transport | Description |
|
||||
|--------|-----------|-------------|
|
||||
| `poc-stdio` | stdio | Proof-of-concept stdio server |
|
||||
| `stdio-full` | stdio | Full-featured stdio server |
|
||||
| `http-sse` | HTTP/SSE | Server-Sent Events transport |
|
||||
| `http-streaming-updated` | HTTP | Streaming HTTP transport |
|
||||
| `claude-flow-sdk` | SDK | Claude Flow SDK server |
|
||||
| `hooks-server` | mixed | Hooks-specific server |
|
||||
|
||||
### Intelligence Modules
|
||||
|
||||
| Module | Description |
|
||||
|--------|-------------|
|
||||
| `RuVectorIntelligence` | Core intelligence engine (SONA + HNSW + EWC++) |
|
||||
| `IntelligenceStore` | Persistent pattern storage |
|
||||
| `EmbeddingService` | Vector embedding generation |
|
||||
| `EmbeddingCache` | Embedding result caching |
|
||||
| `agent-booster-enhanced` | WASM-accelerated code transforms |
|
||||
| `wasm-acceleration` | WASM module loader and fallbacks |
|
||||
| `embedding-benchmark` | Embedding performance measurement |
|
||||
|
||||
### ReasoningBank Modules
|
||||
|
||||
| Module | Description |
|
||||
|--------|-------------|
|
||||
| `index` | Core ReasoningBank engine |
|
||||
| `AdvancedMemory` | Extended memory with forgetting curves |
|
||||
| `HybridBackend` | SQLite + WASM hybrid storage |
|
||||
| `agentdb-adapter` | AgentDB integration adapter |
|
||||
| `backend-selector` | Auto-select optimal backend |
|
||||
| `wasm-adapter` | Browser/Node WASM binding |
|
||||
| `benchmark` | ReasoningBank performance tests |
|
||||
|
||||
### Key Dependencies (20 runtime)
|
||||
|
||||
| Dependency | Version | Purpose |
|
||||
|-----------|---------|---------|
|
||||
| `@anthropic-ai/claude-agent-sdk` | ^0.1.5 | Claude Agent SDK |
|
||||
| `@anthropic-ai/sdk` | ^0.65.0 | Anthropic API |
|
||||
| `@ai-sdk/google` | ^3.0.31 | Google AI integration |
|
||||
| `@google/genai` | ^1.43.0 | Gemini provider |
|
||||
| `@octokit/rest` | ^21.0.0 | GitHub API |
|
||||
| `@ruvector/graph-node` | ^2.0.2 | GNN graph operations |
|
||||
| `@xenova/transformers` | ^2.17.2 | Local embeddings |
|
||||
| `agentdb` | ^1.4.3 | AgentDB v3 controllers |
|
||||
| `express` | ^5.1.0 | HTTP server (MCP) |
|
||||
| `fastmcp` | ^3.19.0 | FastMCP 3.x framework |
|
||||
| `sql.js` | ^1.14.0 | WASM SQLite |
|
||||
| `tiktoken` | ^1.0.22 | Token counting |
|
||||
| `zod` | ^3.25.76 | Schema validation |
|
||||
|
||||
### Breaking Changes from 2.x
|
||||
|
||||
1. **Export subpaths**: New conditional exports for `./reasoningbank` (node vs browser)
|
||||
2. **FastMCP 3.x**: All MCP tools migrated from custom protocol to Zod-validated FastMCP
|
||||
3. **WASM requirement**: ReasoningBank and QUIC modules load WASM; fallback to JS for environments without WASM support
|
||||
4. **Express 5.1**: HTTP transport uses Express 5 (breaking from Express 4.x middleware patterns)
|
||||
5. **agentdb ^1.4.3**: New controller exports (HierarchicalMemory, MemoryConsolidation, SemanticRouter, GNNService, RVFOptimizer, MutationGuard, AttestationLog, GuardedVectorBackend)
|
||||
6. **Provider-specific keys**: No more fallback from `ANTHROPIC_API_KEY` to other providers
|
||||
|
||||
## Integration Surface
|
||||
|
||||
### Files That Import agentic-flow (Updated)
|
||||
|
||||
| File | Import | Usage |
|
||||
|------|--------|-------|
|
||||
| `src/services/agentic-flow-bridge.ts` | `import('agentic-flow/reasoningbank')`, `import('agentic-flow/router')`, `import('agentic-flow/orchestration')` | **NEW** — Unified lazy-loading bridge for all v3 subpaths |
|
||||
| `src/memory/memory-initializer.ts` | `import('agentic-flow/reasoningbank')`, `import('agentic-flow')` | Tier 1: ReasoningBank `computeEmbedding`, Tier 2: legacy core |
|
||||
| `src/ruvector/enhanced-model-router.ts` | `import('agentic-flow/agent-booster')` | Agent Booster with local module (no npx), npx fallback |
|
||||
| `src/commands/hooks.ts` | `import('agentic-flow/reasoningbank')`, `import('agentic-flow')` | Token optimizer — v3 ReasoningBank first, legacy fallback |
|
||||
| `src/mcp-tools/neural-tools.ts` | `import('agentic-flow/reasoningbank')`, `import('@claude-flow/embeddings')` | Tier 1: ReasoningBank WASM, Tier 2: embeddings, Tier 3: mock |
|
||||
| `src/commands/doctor.ts` | `import('agentic-flow/reasoningbank')`, `import('agentic-flow')` | **NEW** — Health check for agentic-flow capabilities |
|
||||
| `src/commands/embeddings.ts` | provider option | `agentic-flow` as embedding provider |
|
||||
| `src/types/optional-modules.d.ts` | Type declarations | Full types for 7 agentic-flow subpath modules |
|
||||
| `src/init/executor.ts` | Version reference | Package version table (updated to 3.0.0-alpha.1) |
|
||||
| `src/update/validator.ts` | Version constraint | Minimum version: 3.0.0-alpha.1 |
|
||||
|
||||
All imports use **lazy dynamic `import()`** with `.catch(() => null)` fallbacks. The CLI functions correctly without agentic-flow installed — it degrades gracefully to local-only embeddings and no WASM acceleration.
|
||||
|
||||
### Integration Changes Made
|
||||
|
||||
| # | File | Change |
|
||||
|---|------|--------|
|
||||
| I1 | `optional-modules.d.ts` | Expanded from 2 to 7 `agentic-flow/*` module declarations with full type coverage |
|
||||
| I2 | `enhanced-model-router.ts` | Agent Booster: npx → local `import('agentic-flow/agent-booster')` with npx fallback |
|
||||
| I3 | `memory-initializer.ts` | Added Tier 1: `computeEmbedding` from `agentic-flow/reasoningbank` before legacy fallback |
|
||||
| I4 | `neural-tools.ts` | Added Tier 1: ReasoningBank WASM embeddings before @claude-flow/embeddings |
|
||||
| I5 | `hooks.ts` | Token optimizer: v3 ReasoningBank direct import, detects version in spinner label |
|
||||
| I6 | `doctor.ts` | New `checkAgenticFlow()` health check — detects ReasoningBank/Embeddings/Judgement/Consolidation |
|
||||
| I7 | `agentic-flow-bridge.ts` | **NEW** — Unified bridge with `capabilities()`, `isAvailable()`, `computeEmbedding()`, `retrieveMemories()` |
|
||||
| I8 | `executor.ts` | Version table: `2.0.1-alpha` → `3.0.0-alpha.1` |
|
||||
| I9 | `validator.ts` | Min version: `0.1.0` → `3.0.0-alpha.1` |
|
||||
| I10 | `hooks-tools.ts` | Comment: `agentic-flow@alpha` → `agentic-flow v3` |
|
||||
|
||||
### Compatibility Assessment
|
||||
|
||||
| Feature | Status | Notes |
|
||||
|---------|--------|-------|
|
||||
| Lazy imports | Compatible | All v3 subpath imports work with `.catch(() => null)` fallbacks |
|
||||
| Type declarations | Compatible | 7 module declarations in `optional-modules.d.ts` |
|
||||
| AgentDB controllers | Compatible | ADR-055 Phase 2 already adapted bridge for new exports |
|
||||
| Memory bridge | Compatible | `memory-bridge.ts` hardened in ADR-055 |
|
||||
| Embedding service | Compatible | 3-tier: ReasoningBank → @claude-flow/embeddings → mock |
|
||||
| Router integration | Compatible | Local agent-booster import with npx fallback |
|
||||
| Doctor health check | New | Detects all 4 ReasoningBank capabilities |
|
||||
| Unified bridge | New | Single entry point for all agentic-flow v3 modules |
|
||||
|
||||
### Version Alignment
|
||||
|
||||
| Package | Dependency | Required Version |
|
||||
|---------|-----------|-----------------|
|
||||
| `@claude-flow/cli` | `agentic-flow` | `^3.0.0-alpha.1` (updated) |
|
||||
| `@claude-flow/cli` | `agentdb` | `^3.0.0-alpha.10` (updated) |
|
||||
|
||||
## Consequences
|
||||
|
||||
### Positive
|
||||
|
||||
1. **Zero production vulnerabilities** — sqlite3 removed from agentdb peer deps, all transitive vuln chains broken
|
||||
2. **WASM acceleration available** — ReasoningBank (211 KB) and QUIC (127 KB) WASM modules for native-speed operations
|
||||
3. **FastMCP 3.x** — 33+ Zod-validated MCP tools with proper error handling and streaming
|
||||
4. **Richer intelligence** — RuVectorIntelligence with SONA, HNSW, EWC++, Flash Attention
|
||||
5. **Federation support** — EphemeralAgent and FederationHub for cross-instance coordination
|
||||
6. **Billing infrastructure** — 5-tier metering system for commercial deployment
|
||||
7. **Modern SDK** — Claude Agent SDK 0.1.5 for native agent spawning
|
||||
|
||||
### Negative
|
||||
|
||||
1. **Package size** — 32 MB installed (up from ~18 MB for 2.0.7) due to WASM and expanded module set
|
||||
2. **WASM environment requirement** — Some CI environments may not support WASM; fallbacks exist but with reduced performance
|
||||
3. **Alpha stability** — 3.0.0-alpha.1 may have API changes before stable release
|
||||
|
||||
### Risks
|
||||
|
||||
1. **WASM fallback path**: If WASM fails to load, JS fallbacks activate automatically. Performance degrades but functionality is preserved.
|
||||
2. **Express 5 compatibility**: HTTP transport uses Express 5. Any middleware that depends on Express 4 patterns needs migration.
|
||||
3. **FastMCP Zod schemas**: All MCP tool inputs are now Zod-validated. Invalid inputs get clear error messages instead of silent failures.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
# Verify installation
|
||||
node -e "require('agentic-flow/package.json').version" # → 3.0.0-alpha.1
|
||||
|
||||
# Verify WASM modules present
|
||||
ls node_modules/agentic-flow/wasm/reasoningbank/*.wasm # → 211K
|
||||
ls node_modules/agentic-flow/wasm/quic/*.wasm # → 127K
|
||||
|
||||
# Verify exports resolve
|
||||
node -e "import('agentic-flow').then(m => console.log('Core:', !!m))"
|
||||
node -e "import('agentic-flow/reasoningbank').then(m => console.log('RB:', !!m))"
|
||||
node -e "import('agentic-flow/router').then(m => console.log('Router:', !!m))"
|
||||
|
||||
# Verify CLI tests pass
|
||||
cd v3/@claude-flow/cli && npm test # → 445 passed
|
||||
|
||||
# Verify zero production vulnerabilities
|
||||
npm audit --omit=dev # → 0 vulnerabilities
|
||||
```
|
||||
|
||||
## Related ADRs
|
||||
|
||||
- **ADR-053**: AgentDB v3 Controller Activation — Initial 8 controllers + 6 MCP tools
|
||||
- **ADR-054**: RVF-Powered Plugin Marketplace — IPFS plugin registry
|
||||
- **ADR-055**: AgentDB Controller Bug Remediation — Fixed 30 security findings, upgraded stubs to real implementations
|
||||
Reference in new issue
Block a user