Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 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

Checkpoint: File edits

rUv39ba81fb585b
diff --git a/README.md b/README.md
index 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>
+
+[![npm version](https://img.shields.io/npm/v/agentic-jujutsu?color=blue&label=npm)](https://www.npmjs.com/package/agentic-jujutsu)
+[![npm downloads](https://img.shields.io/npm/dm/agentic-jujutsu?color=green)](https://www.npmjs.com/package/agentic-jujutsu)
+[![GitHub](https://img.shields.io/badge/GitHub-ruvnet%2Fagentic--flow-blue?logo=github)](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.yaml
index 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.yaml
index 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.yaml
index 625a5baf30..f97ed842cc 100644
--- a/agents/reviewer.yaml
+++ b/agents/reviewer.yaml
@@ -7,4 +7,4 @@ capabilities:
- best-practices
optimizations:
- 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.yaml
index c8630ff9f2..0a03db4881 100644
--- a/agents/security-architect.yaml
+++ b/agents/security-architect.yaml
@@ -7,4 +7,4 @@ capabilities:
- security-review
optimizations:
- 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.yaml
index 7fc6973e9e..5962c59016 100644
--- a/agents/tester.yaml
+++ b/agents/tester.yaml
@@ -7,4 +7,4 @@ capabilities:
- coverage
optimizations:
- parallel-execution
-createdAt: "2026-01-15T22:53:01.602Z"
+createdAt: "2026-01-15T22:58:23.532Z"