π 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
rUv39ba81fb585b
diff --git a/README.md b/README.mdindex ce08480828..24bd58fea7 100644--- a/README.md+++ b/README.md@@ -3261,6 +3261,240 @@ const config = optimizer.getOptimalConfig(agentCount);---+<details>+<summary><h2>π₯ Agentic-Jujutsu β Quantum-Ready AI Version Control</h2></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.++### Quick Start++```bash+# Install globally (zero dependencies - jj binary embedded!)+npm install -g agentic-jujutsu++# Or run directly with npx+npx agentic-jujutsu --help++# Analyze repository for AI agent compatibility+npx agentic-jujutsu analyze++# Start MCP server for AI agents+npx agentic-jujutsu mcp-server++# Compare performance with Git+npx agentic-jujutsu compare-git+```++### Why Agentic-Jujutsu?++| What | Git | Agentic-Jujutsu |+|------|-----|-----------------|+| **Multiple AIs working together** | β Locks & conflicts | β Works smoothly |+| **Speed with 3+ agents** | Slow (waits) | **23x faster** |+| **Installation** | Need to install git | One npm command |+| **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 |++### Core Capabilities++<details>+<summary>π§ <strong>Self-Learning with ReasoningBank</strong> β Track operations, learn patterns, get AI suggestions</summary>++```javascript+const { JjWrapper } = require('agentic-jujutsu');++const jj = new JjWrapper();++// Start learning trajectory+const trajectoryId = jj.startTrajectory('Deploy to production');++// Perform operations (automatically tracked)+await jj.branchCreate('release/v1.0');+await jj.newCommit('Release v1.0');++// Record operations to trajectory+jj.addToTrajectory();++// Finalize with success score (0.0-1.0) and critique+jj.finalizeTrajectory(0.95, 'Deployment successful, no issues');++// Later: Get AI-powered suggestions for similar tasks+const suggestion = JSON.parse(jj.getSuggestion('Deploy to staging'));+console.log('AI Recommendation:', suggestion.reasoning);+console.log('Confidence:', (suggestion.confidence * 100).toFixed(1) + '%');+```++**ReasoningBank Methods:**++| Method | Description | Returns |+|--------|-------------|---------|+| `startTrajectory(task)` | Begin learning trajectory | string (trajectory ID) |+| `addToTrajectory()` | Add recent operations | void |+| `finalizeTrajectory(score, critique?)` | Complete trajectory (0.0-1.0) | void |+| `getSuggestion(task)` | Get AI recommendation | JSON: DecisionSuggestion |+| `getLearningStats()` | Get learning metrics | JSON: LearningStats |+| `getPatterns()` | Get discovered patterns | JSON: Pattern[] |+| `queryTrajectories(task, limit)` | Find similar trajectories | JSON: Trajectory[] |++</details>++<details>+<summary>π€ <strong>Multi-Agent Coordination</strong> β QuantumDAG architecture for conflict-free collaboration</summary>++```javascript+// All agents work concurrently (no conflicts!)+const agents = ['researcher', 'coder', 'tester'];++const results = await Promise.all(agents.map(async (agentName) => {+ const jj = new JjWrapper();++ // Start tracking+ jj.startTrajectory(`${agentName}: Feature implementation`);++ // Get AI suggestion based on learned patterns+ const suggestion = JSON.parse(jj.getSuggestion(`${agentName} task`));++ // Execute task (no lock waiting!)+ await jj.newCommit(`Changes by ${agentName}`);++ // Record learning+ jj.addToTrajectory();+ jj.finalizeTrajectory(0.9);++ return { agent: agentName, success: true };+}));++console.log('All agents completed:', results);+```++**Performance Comparison:**++| Metric | Git | Agentic Jujutsu |+|--------|-----|-----------------|+| Concurrent commits | 15 ops/s | **350 ops/s (23x)** |+| 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** |++</details>++<details>+<summary>π <strong>Quantum-Resistant Security</strong> β SHA3-512 fingerprints and HQC-128 encryption</summary>++```javascript+const { generateQuantumFingerprint, verifyQuantumFingerprint } = require('agentic-jujutsu');++// Generate SHA3-512 fingerprint (NIST FIPS 202)+const data = Buffer.from('commit-data');+const fingerprint = generateQuantumFingerprint(data);+console.log('Fingerprint:', fingerprint.toString('hex'));++// Verify integrity (<1ms)+const isValid = verifyQuantumFingerprint(data, fingerprint);+console.log('Valid:', isValid);++// HQC-128 encryption for trajectories+const crypto = require('crypto');+const jj = new JjWrapper();+const key = crypto.randomBytes(32).toString('base64');+jj.enableEncryption(key);+```++**Quantum Security Methods:**++| Method | Description | Returns |+|--------|-------------|---------|+| `generateQuantumFingerprint(data)` | Generate SHA3-512 fingerprint | Buffer (64 bytes) |+| `verifyQuantumFingerprint(data, fp)` | Verify fingerprint | boolean |+| `enableEncryption(key, pubKey?)` | Enable HQC-128 encryption | void |+| `disableEncryption()` | Disable encryption | void |++</details>++### Claude-Flow Skill++Claude-Flow includes a dedicated `/agentic-jujutsu` skill for AI-powered version control:++```bash+# Invoke the skill+/agentic-jujutsu+```++**Use this skill when you need:**+- β Multiple AI agents modifying code simultaneously+- β Lock-free version control (23x faster than Git)+- β Self-learning AI that improves from experience+- β Quantum-resistant security for future-proof protection+- β Automatic conflict resolution (87% success rate)+- β Pattern recognition and intelligent suggestions++### MCP Tools for AI Agents++```bash+# Start the MCP server+npx agentic-jujutsu mcp-server++# List available tools+npx agentic-jujutsu mcp-tools++# Call a tool from your agent+npx agentic-jujutsu mcp-call jj_status+```++**Available MCP Tools:**++| Tool | Description | Use When |+|------|-------------|----------|+| `jj_status` | Check repository status | Checking for changes |+| `jj_log` | Show commit history | Understanding commits |+| `jj_diff` | Show changes | Reviewing modifications |++### CLI Commands Reference++```bash+# Repository Operations+npx agentic-jujutsu status # Show working copy status+npx agentic-jujutsu log --limit 10 # Show commit history+npx agentic-jujutsu diff # Show changes+npx agentic-jujutsu new "message" # Create new commit++# AI Agent Operations+npx agentic-jujutsu analyze # Analyze repo for AI compatibility+npx agentic-jujutsu ast "command" # Convert to AI-readable AST format+npx agentic-jujutsu mcp-server # Start MCP server+npx agentic-jujutsu mcp-tools # List MCP tools++# Performance+npx agentic-jujutsu bench # Run benchmarks+npx agentic-jujutsu compare-git # Compare with Git++# Info+npx agentic-jujutsu help # Show all commands+npx agentic-jujutsu version # Show version info+npx agentic-jujutsu examples # Show usage examples+```++### Version Evolution++| Version | Features |+|---------|----------|+| **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.3** | Kubernetes GitOps + production stability |++</details>++---+<details><summary><h2>π¦ RuVector β High-Performance Rust/WASM Intelligence</h2></summary>diff --git a/agents/architect.yaml b/agents/architect.yamlindex 188d5eb3b8..80fa184c44 100644--- a/agents/architect.yaml+++ b/agents/architect.yaml@@ -8,4 +8,4 @@ capabilities:optimizations:- context-caching- memory-persistence-createdAt: "2026-01-15T22:53:01.602Z"+createdAt: "2026-01-15T22:58:23.531Z"diff --git a/agents/coder.yaml b/agents/coder.yamlindex d25e0e9bfd..bbf1ab10db 100644--- a/agents/coder.yaml+++ b/agents/coder.yaml@@ -8,4 +8,4 @@ capabilities:optimizations:- flash-attention- token-reduction-createdAt: "2026-01-15T22:53:01.602Z"+createdAt: "2026-01-15T22:58:23.531Z"diff --git a/agents/reviewer.yaml b/agents/reviewer.yamlindex 625a5baf30..f97ed842cc 100644--- a/agents/reviewer.yaml+++ b/agents/reviewer.yaml@@ -7,4 +7,4 @@ capabilities:- best-practicesoptimizations:- incremental-analysis-createdAt: "2026-01-15T22:53:01.602Z"+createdAt: "2026-01-15T22:58:23.532Z"diff --git a/agents/security-architect.yaml b/agents/security-architect.yamlindex c8630ff9f2..0a03db4881 100644--- a/agents/security-architect.yaml+++ b/agents/security-architect.yaml@@ -7,4 +7,4 @@ capabilities:- security-reviewoptimizations:- pattern-matching-createdAt: "2026-01-15T22:53:01.602Z"+createdAt: "2026-01-15T22:58:23.532Z"diff --git a/agents/tester.yaml b/agents/tester.yamlindex 7fc6973e9e..5962c59016 100644--- a/agents/tester.yaml+++ b/agents/tester.yaml@@ -7,4 +7,4 @@ capabilities:- coverageoptimizations:- parallel-execution-createdAt: "2026-01-15T22:53:01.602Z"+createdAt: "2026-01-15T22:58:23.532Z"