π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
Checkpoint: File edits
rUv80cde575871e
diff --git a/README.md b/README.mdindex dc86001b54..a72442a91a 100644--- a/README.md+++ b/README.md@@ -769,8 +769,12 @@ echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env<details><summary><h2>π¦ Features β 54+ Agents, Swarm Topologies, MCP Tools & Security</h2></summary>+Comprehensive feature set for enterprise-grade AI agent orchestration.-### Agent Ecosystem+<details open>+<summary>π€ <strong>Agent Ecosystem</strong> β 54+ specialized agents across 8 categories</summary>++Pre-built agents for every development task, from coding to security audits.| Category | Agent Count | Key Agents | Purpose ||----------|-------------|------------|---------|@@ -783,7 +787,12 @@ echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env| **SPARC Methodology** | 6 | sparc-coord, specification, pseudocode, architecture | Structured development || **Specialized Dev** | 8 | backend-dev, mobile-dev, ml-developer, cicd-engineer | Domain expertise |-### Swarm Topologies+</details>++<details>+<summary>π <strong>Swarm Topologies</strong> β 6 coordination patterns for any workload</summary>++Choose the right topology for your task complexity and team size.| Topology | Recommended Agents | Best For | Execution Time | Memory/Agent ||----------|-------------------|----------|----------------|--------------|@@ -794,7 +803,12 @@ echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env| **Hybrid (Hierarchical-Mesh)** | 7+ | Complex multi-domain tasks | 0.18s | 320 MB || **Adaptive** | 2+ | Dynamic workloads, auto-scaling | Variable | Dynamic |-### MCP Tools & Integration+</details>++<details>+<summary>π§ <strong>MCP Tools & Integration</strong> β 31+ tools across 7 categories</summary>++Full MCP server with tools for coordination, monitoring, memory, and GitHub integration.| Category | Tools | Description ||----------|-------|-------------|@@ -803,10 +817,15 @@ echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env| **Memory & Neural** | `memory_usage`, `neural_status`, `neural_train`, `neural_patterns` | Memory operations and learning || **GitHub** | `github_swarm`, `repo_analyze`, `pr_enhance`, `issue_triage`, `code_review` | Repository integration || **Workers** | `worker/run`, `worker/status`, `worker/alerts`, `worker/history` | Background task management |-| **Hooks** | `hooks/pre-*`, `hooks/post-*`, `hooks/route`, `hooks/session-*`, `hooks/intelligence/*`, `hooks/worker/*` | 31 lifecycle hooks |+| **Hooks** | `hooks/pre-*`, `hooks/post-*`, `hooks/route`, `hooks/session-*`, `hooks/intelligence/*` | 31 lifecycle hooks || **Progress** | `progress/check`, `progress/sync`, `progress/summary`, `progress/watch` | V3 implementation tracking |-### Security Features+</details>++<details>+<summary>π <strong>Security Features</strong> β CVE-hardened with 7 protection layers</summary>++Enterprise-grade security with input validation, sandboxing, and active CVE monitoring.| Feature | Protection | Implementation ||---------|------------|----------------|@@ -818,7 +837,12 @@ echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env| **Information Disclosure** | Data leakage | Error message sanitization || **CVE Monitoring** | Known vulnerabilities | Active scanning and patching |-### Advanced Capabilities+</details>++<details>+<summary>β‘ <strong>Advanced Capabilities</strong> β Self-healing, auto-scaling, event sourcing</summary>++Production-ready features for high availability and continuous learning.| Feature | Description | Benefit ||---------|-------------|---------|@@ -830,61 +854,49 @@ echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env| **Self-Healing Workflows** | Automatic error recovery and task retry | High availability || **Cross-Session Memory** | Persistent pattern storage across sessions | Continuous learning || **Event Sourcing** | Complete audit trail with replay capability | Debugging and compliance |-| **Background Workers** | 12 auto-triggered workers for analysis and optimization | Automated maintenance |-| **GitHub Integration** | PR management, issue triage, code review automation | Repository workflow |-### Plugin System (`@claude-flow/plugins`)+</details>++<details>+<summary>π§© <strong>Plugin System</strong> β Extend with custom tools, hooks, workers</summary>++Build custom plugins with the fluent builder API. Create MCP tools, hooks, workers, and providers.| Component | Description | Key Features ||-----------|-------------|--------------|| **PluginBuilder** | Fluent builder for creating plugins | MCP tools, hooks, workers, providers || **MCPToolBuilder** | Build MCP tools with typed parameters | String, number, boolean, enum params |-| **HookBuilder** | Build hooks with conditions and transformers | Priorities, conditional execution, data transformation |-| **WorkerPool** | Managed worker pool with auto-scaling | Min/max workers, task queuing, graceful shutdown |+| **HookBuilder** | Build hooks with conditions and transformers | Priorities, conditional execution |+| **WorkerPool** | Managed worker pool with auto-scaling | Min/max workers, task queuing || **ProviderRegistry** | LLM provider management with fallback | Cost optimization, automatic failover |-| **AgenticFlowBridge** | agentic-flow@alpha integration | Swarm coordination, agent spawning || **AgentDBBridge** | Vector storage with HNSW indexing | 150x faster search, batch operations |-| **Security Utilities** | Input validation and protection | Path traversal, injection, rate limiting |-### Plugin Hook Events+**Plugin Performance:** Load <20ms, Hook execution <0.5ms, Worker spawn <50ms++</details>++<details>+<summary>πͺ <strong>Plugin Hook Events</strong> β 25+ lifecycle hooks for full control</summary>++Intercept and extend any operation with pre/post hooks.| Category | Events | Description ||----------|--------|-------------|| **Session** | `session:start`, `session:end` | Session lifecycle management |-| **Agent** | `agent:pre-spawn`, `agent:post-spawn`, `agent:pre-terminate`, `agent:post-terminate` | Agent lifecycle hooks |+| **Agent** | `agent:pre-spawn`, `agent:post-spawn`, `agent:pre-terminate` | Agent lifecycle hooks || **Task** | `task:pre-execute`, `task:post-complete`, `task:error` | Task execution hooks || **Tool** | `tool:pre-call`, `tool:post-call` | MCP tool invocation hooks |-| **Memory** | `memory:pre-store`, `memory:post-store`, `memory:pre-retrieve`, `memory:post-retrieve` | Memory operation hooks |+| **Memory** | `memory:pre-store`, `memory:post-store`, `memory:pre-retrieve` | Memory operation hooks || **Swarm** | `swarm:initialized`, `swarm:shutdown`, `swarm:consensus-reached` | Swarm coordination hooks |-| **File** | `file:pre-read`, `file:post-read`, `file:pre-write`, `file:post-write` | File operation hooks |-| **Command** | `command:pre-execute`, `command:post-execute` | Shell command hooks |+| **File** | `file:pre-read`, `file:post-read`, `file:pre-write` | File operation hooks || **Learning** | `learning:pattern-learned`, `learning:pattern-applied` | Pattern learning hooks |-### Plugin Worker Types--| Worker Type | Purpose | Capabilities |-|-------------|---------|--------------|-| `coder` | Code implementation | Code generation, refactoring |-| `reviewer` | Code review | Quality analysis, suggestions |-| `tester` | Test generation/execution | Unit tests, integration tests |-| `researcher` | Information gathering | Web search, documentation |-| `planner` | Task planning | Decomposition, scheduling |-| `coordinator` | Multi-agent coordination | Orchestration, consensus |-| `security` | Security analysis | Vulnerability scanning, audit |-| `performance` | Performance optimization | Profiling, benchmarking |-| `specialized` | Custom capabilities | Domain-specific tasks |-| `long-running` | Background tasks | Async processing, polling |--### Plugin Performance+</details>-| Metric | Target | Achieved |-|--------|--------|----------|-| Plugin load time | <50ms | ~20ms |-| Hook execution | <1ms | ~0.5ms |-| Worker spawn | <100ms | ~50ms |-| Vector search (10K) | <10ms | ~5ms |+<details>+<summary>π <strong>RuVector WASM Plugins</strong> β High-performance WebAssembly extensions</summary>-### RuVector WASM Plugins+Pre-built WASM plugins for semantic search, intent routing, and pattern storage.| Plugin | Description | Performance ||--------|-------------|-------------|@@ -895,38 +907,35 @@ echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env| **ReasoningBankPlugin** | Vector-backed pattern storage with HNSW | 150x faster search || **AgentConfigGeneratorPlugin** | Generates optimized agent configurations | From pretrain data |-### Background Workers (12 Auto-Triggered)+</details>-Workers run automatically in the background based on context, or can be dispatched manually via MCP tools.+<details>+<summary>βοΈ <strong>Background Workers</strong> β 12 auto-triggered workers for automation</summary>++Workers run automatically based on context, or dispatch manually via MCP tools.| Worker | Trigger | Purpose | Auto-Triggers On ||--------|---------|---------|------------------|-| **UltraLearn** | `ultralearn` | Deep knowledge acquisition from codebase | New project, major refactors |-| **Optimize** | `optimize` | Performance optimization suggestions | Slow operations detected |-| **Consolidate** | `consolidate` | Memory pattern consolidation | Session end, memory threshold |-| **Predict** | `predict` | Predictive resource preloading | Usage patterns detected |+| **UltraLearn** | `ultralearn` | Deep knowledge acquisition | New project, major refactors |+| **Optimize** | `optimize` | Performance suggestions | Slow operations detected |+| **Consolidate** | `consolidate` | Memory consolidation | Session end, memory threshold || **Audit** | `audit` | Security vulnerability analysis | Security-related file changes || **Map** | `map` | Codebase structure mapping | New directories, large changes |-| **Preload** | `preload` | Resource and dependency preloading | Project initialization |-| **DeepDive** | `deepdive` | Deep code analysis and understanding | Complex file edits |-| **Document** | `document` | Auto-documentation generation | New functions/classes created |-| **Refactor** | `refactor` | Refactoring opportunity detection | Code smell patterns |+| **DeepDive** | `deepdive` | Deep code analysis | Complex file edits |+| **Document** | `document` | Auto-documentation | New functions/classes created |+| **Refactor** | `refactor` | Refactoring detection | Code smell patterns || **Benchmark** | `benchmark` | Performance benchmarking | Performance-critical changes |-| **TestGaps** | `testgaps` | Test coverage gap analysis | Code changes without tests |+| **TestGaps** | `testgaps` | Test coverage analysis | Code changes without tests |-**Worker Commands:**```bash-# Dispatch a worker manuallynpx claude-flow@v3alpha worker dispatch --trigger audit --context "./src"--# Check worker statusnpx claude-flow@v3alpha worker status--# View completed results-npx claude-flow@v3alpha worker results --limit 10```-### LLM Providers (`@claude-flow/providers`)+</details>++<details>+<summary>βοΈ <strong>LLM Providers</strong> β 6 providers with automatic failover</summary>| Provider | Models (2025-2026) | Features | Cost ||----------|--------|----------|------|