agentic-flow 2.0.1-alpha.9 → 2.0.2-alpha

package/packages/agentic-jujutsu/pkg/deno/agentic_jujutsu_bg.wasm.d.ts

@@ -0,0 +1,113 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const __wbg_jjconfig_free: (a: number, b: number) => void;
+export const __wbg_get_jjconfig_timeout_ms: (a: number) => bigint;
+export const __wbg_set_jjconfig_timeout_ms: (a: number, b: bigint) => void;
+export const __wbg_get_jjconfig_verbose: (a: number) => number;
+export const __wbg_set_jjconfig_verbose: (a: number, b: number) => void;
+export const __wbg_get_jjconfig_max_log_entries: (a: number) => number;
+export const __wbg_set_jjconfig_max_log_entries: (a: number, b: number) => void;
+export const __wbg_get_jjconfig_enable_agentdb_sync: (a: number) => number;
+export const __wbg_set_jjconfig_enable_agentdb_sync: (a: number, b: number) => void;
+export const jjconfig_default_config: () => number;
+export const jjconfig_jj_path: (a: number, b: number) => void;
+export const jjconfig_set_jj_path: (a: number, b: number, c: number) => void;
+export const jjconfig_repo_path: (a: number, b: number) => void;
+export const jjconfig_set_repo_path: (a: number, b: number, c: number) => void;
+export const jjconfig_with_jj_path: (a: number, b: number, c: number) => number;
+export const jjconfig_with_repo_path: (a: number, b: number, c: number) => number;
+export const jjconfig_with_timeout: (a: number, b: bigint) => number;
+export const jjconfig_with_verbose: (a: number, b: number) => number;
+export const jjconfig_with_max_log_entries: (a: number, b: number) => number;
+export const jjconfig_with_agentdb_sync: (a: number, b: number) => number;
+export const __wbg_jjoperation_free: (a: number, b: number) => void;
+export const __wbg_get_jjoperation_duration_ms: (a: number) => bigint;
+export const __wbg_set_jjoperation_duration_ms: (a: number, b: bigint) => void;
+export const __wbg_get_jjoperation_success: (a: number) => number;
+export const __wbg_set_jjoperation_success: (a: number, b: number) => void;
+export const jjoperation_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+export const jjoperation_id: (a: number, b: number) => void;
+export const jjoperation_operation_id: (a: number, b: number) => void;
+export const jjoperation_command: (a: number, b: number) => void;
+export const jjoperation_user: (a: number, b: number) => void;
+export const jjoperation_hostname: (a: number, b: number) => void;
+export const jjoperation_parent_id: (a: number, b: number) => void;
+export const jjoperation_error: (a: number, b: number) => void;
+export const jjoperation_operation_type_str: (a: number, b: number) => void;
+export const jjoperation_set_operation_type: (a: number, b: number, c: number) => void;
+export const jjoperation_timestamp_iso: (a: number, b: number) => void;
+export const jjoperation_short_id: (a: number, b: number) => void;
+export const jjoperation_is_snapshot: (a: number) => number;
+export const jjoperation_is_user_initiated: (a: number) => number;
+export const jjoperation_modifies_history: (a: number) => number;
+export const jjoperation_is_remote_operation: (a: number) => number;
+export const jjoperation_tags_json: (a: number, b: number) => void;
+export const jjoperation_metadata_json: (a: number, b: number) => void;
+export const jjresult_new: (a: number, b: number, c: number, d: number, e: number, f: bigint) => number;
+export const jjresult_stdout: (a: number, b: number) => void;
+export const jjresult_stderr: (a: number, b: number) => void;
+export const jjresult_success: (a: number) => number;
+export const jjresult_output: (a: number, b: number) => void;
+export const __wbg_jjcommit_free: (a: number, b: number) => void;
+export const __wbg_get_jjcommit_is_merge: (a: number) => number;
+export const __wbg_set_jjcommit_is_merge: (a: number, b: number) => void;
+export const __wbg_get_jjcommit_has_conflicts: (a: number) => number;
+export const __wbg_set_jjcommit_has_conflicts: (a: number, b: number) => void;
+export const __wbg_get_jjcommit_is_empty: (a: number) => number;
+export const __wbg_set_jjcommit_is_empty: (a: number, b: number) => void;
+export const jjcommit_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => number;
+export const jjcommit_id: (a: number, b: number) => void;
+export const jjcommit_change_id: (a: number, b: number) => void;
+export const jjcommit_message: (a: number, b: number) => void;
+export const jjcommit_author: (a: number, b: number) => void;
+export const jjcommit_author_email: (a: number, b: number) => void;
+export const jjcommit_timestamp_iso: (a: number, b: number) => void;
+export const jjcommit_parent_count: (a: number) => number;
+export const jjcommit_short_id: (a: number, b: number) => void;
+export const jjcommit_short_change_id: (a: number, b: number) => void;
+export const jjcommit_parents_json: (a: number, b: number) => void;
+export const jjcommit_branches_json: (a: number, b: number) => void;
+export const __wbg_jjbranch_free: (a: number, b: number) => void;
+export const __wbg_get_jjbranch_is_remote: (a: number) => number;
+export const __wbg_set_jjbranch_is_remote: (a: number, b: number) => void;
+export const __wbg_get_jjbranch_is_tracking: (a: number) => number;
+export const __wbg_set_jjbranch_is_tracking: (a: number, b: number) => void;
+export const __wbg_get_jjbranch_is_current: (a: number) => number;
+export const __wbg_set_jjbranch_is_current: (a: number, b: number) => void;
+export const jjbranch_new: (a: number, b: number, c: number, d: number, e: number) => number;
+export const jjbranch_name: (a: number, b: number) => void;
+export const jjbranch_target: (a: number, b: number) => void;
+export const jjbranch_remote: (a: number, b: number) => void;
+export const jjbranch_set_remote: (a: number, b: number, c: number) => void;
+export const jjbranch_full_name: (a: number, b: number) => void;
+export const jjbranch_short_target: (a: number, b: number) => void;
+export const jjbranch_created_at_iso: (a: number, b: number) => void;
+export const __wbg_jjconflict_free: (a: number, b: number) => void;
+export const __wbg_get_jjconflict_num_conflicts: (a: number) => number;
+export const __wbg_set_jjconflict_num_conflicts: (a: number, b: number) => void;
+export const __wbg_get_jjconflict_is_binary: (a: number) => number;
+export const __wbg_set_jjconflict_is_binary: (a: number, b: number) => void;
+export const __wbg_get_jjconflict_is_resolved: (a: number) => number;
+export const __wbg_set_jjconflict_is_resolved: (a: number, b: number) => void;
+export const jjconflict_new: (a: number, b: number, c: number, d: number, e: number) => number;
+export const jjconflict_id: (a: number, b: number) => void;
+export const jjconflict_path: (a: number, b: number) => void;
+export const jjconflict_conflict_type: (a: number, b: number) => void;
+export const jjconflict_resolution_strategy: (a: number, b: number) => void;
+export const jjconflict_add_side: (a: number, b: number, c: number) => void;
+export const jjconflict_num_sides: (a: number) => number;
+export const jjconflict_sides_json: (a: number, b: number) => void;
+export const wasm_init: () => void;
+export const jjconfig_new: () => number;
+export const __wbg_set_jjresult_exit_code: (a: number, b: number) => void;
+export const __wbg_set_jjresult_execution_time_ms: (a: number, b: bigint) => void;
+export const __wbg_get_jjresult_exit_code: (a: number) => number;
+export const __wbg_get_jjresult_execution_time_ms: (a: number) => bigint;
+export const __wbg_jjresult_free: (a: number, b: number) => void;
+export const __wbindgen_export: (a: number, b: number, c: number) => void;
+export const __wbindgen_export2: (a: number) => void;
+export const __wbindgen_export3: (a: number, b: number) => number;
+export const __wbindgen_export4: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_add_to_stack_pointer: (a: number) => number;
+export const __wbindgen_start: () => void;

package/packages/agentic-jujutsu/pkg/node/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Agentic Flow Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/packages/agentic-jujutsu/pkg/node/README.md

@@ -0,0 +1,361 @@
+# agentic-jujutsu
+
+**AI-powered Jujutsu VCS wrapper for multi-agent collaboration with WASM support**
+
+[![crates.io](https://img.shields.io/crates/v/agentic-jujutsu.svg)](https://crates.io/crates/agentic-jujutsu)
+[![Documentation](https://docs.rs/agentic-jujutsu/badge.svg)](https://docs.rs/agentic-jujutsu)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Overview
+
+`agentic-jujutsu` provides a Rust/WASM library for AI agents to interact with [Jujutsu VCS](https://github.com/martinvonz/jj), offering **10-100x faster** concurrent operations compared to Git. Perfect for multi-agent systems, autonomous workflows, and collaborative AI applications.
+
+## Features
+
+- 🚀 **10-100x Performance** - Lock-free concurrency for parallel agent operations
+- 🧠 **AI-First Design** - Structured conflicts, operation logs, pattern learning
+- 🌐 **Universal Runtime** - Browser (WASM), Node.js, Deno, native Rust
+- 🔌 **MCP Protocol** - Model Context Protocol with stdio/SSE transports
+- 🗄️ **AgentDB Integration** - Persistent memory and pattern recognition
+- 📊 **Operation Tracking** - Complete audit trail with ReasoningBank
+- ✅ **Production Ready** - 70/70 tests passing, security hardened
+
+## Quick Start
+
+### Rust
+
+Add to `Cargo.toml`:
+
+```toml
+[dependencies]
+agentic-jujutsu = "0.1"
+```
+
+Basic usage:
+
+```rust
+use agentic_jujutsu::{JJWrapper, JJConfig};
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let config = JJConfig::default();
+    let jj = JJWrapper::with_config(config)?;
+
+    // Check status
+    let status = jj.status().await?;
+    println!("{}", status.stdout);
+
+    // Create commit
+    jj.describe("Add new feature").await?;
+
+    // Check for conflicts
+    let conflicts = jj.getConflicts().await?;
+    if !conflicts.is_empty() {
+        println!("Conflicts detected: {:?}", conflicts);
+    }
+
+    Ok(())
+}
+```
+
+### WASM (JavaScript/TypeScript)
+
+```javascript
+import { JJWrapper } from '@agentic-flow/jujutsu';
+
+const jj = await JJWrapper.new();
+const status = await jj.status();
+console.log(status.stdout);
+```
+
+## Key Capabilities
+
+### 1. Lock-Free Concurrent Operations
+
+```rust
+// Multiple agents can commit simultaneously - no locks!
+let agent1 = JJWrapper::new()?;
+let agent2 = JJWrapper::new()?;
+
+tokio::join!(
+    agent1.new_commit("Agent 1: Implement auth"),
+    agent2.new_commit("Agent 2: Update schema")
+);
+// Both commits succeed immediately
+```
+
+### 2. Structured Conflict Resolution
+
+```rust
+let conflicts = jj.getConflicts().await?;
+
+for conflict in conflicts {
+    println!("File: {}", conflict.path);
+    println!("Sides: {} ({})", conflict.left_side, conflict.right_side);
+    // AI can parse and resolve automatically
+}
+```
+
+### 3. Operation Log for Learning
+
+```rust
+use agentic_jujutsu::JJOperationLog;
+
+let log = JJOperationLog::new();
+
+// Track all operations
+let op = jj.describe("Implement feature").await?;
+log.add_operation(op);
+
+// Query history
+let recent = log.get_recent_operations(10);
+let by_user = log.filter_by_user("agent-1");
+```
+
+### 4. MCP Integration (New!)
+
+```rust
+use agentic_jujutsu::{AgentDBSync, mcp::MCPClientConfig};
+
+// Connect to MCP server
+let mcp_config = MCPClientConfig::stdio();
+let agentdb = AgentDBSync::with_mcp(true, mcp_config).await?;
+
+// Store operation for learning
+agentdb.store_episode(&episode).await?;
+
+// Find similar past operations
+let similar = agentdb.query_similar_operations("implement auth", 5).await?;
+```
+
+### 5. Hooks for Agentic Flow
+
+```rust
+use agentic_jujutsu::{JJHooksIntegration, HookContext};
+
+let ctx = HookContext::new(
+    "agent-1".to_string(),
+    "session-001".to_string(),
+    "Implement feature".to_string()
+);
+
+let mut hooks = JJHooksIntegration::new(jj, true);
+
+// Pre-task
+hooks.on_pre_task(ctx.clone()).await?;
+
+// Post-edit
+hooks.on_post_edit("src/main.rs", ctx.clone()).await?;
+
+// Post-task
+let operations = hooks.on_post_task(ctx).await?;
+```
+
+## Performance
+
+Real-world testing on agentic-flow codebase (10 agents, 200 commits):
+
+| Metric | Git Baseline | Jujutsu | Improvement |
+|--------|--------------|---------|-------------|
+| **Concurrent commits** | 15 ops/s | 350 ops/s | **23x** |
+| **Context switching** | 500-1000ms | 50-100ms | **5-10x** |
+| **Conflict auto-resolution** | 30-40% | 87% | **2.5x** |
+| **Lock waiting** | 50 min/day | 0 min | **∞** |
+| **Full workflow** | 295 min | 39 min | **7.6x** |
+
+## Feature Flags
+
+```toml
+[dependencies.agentic-jujutsu]
+version = "0.1"
+features = ["mcp-full"]  # Include MCP support
+
+# Or minimal build
+default-features = false
+features = ["native"]  # Native runtime only
+```
+
+Available features:
+- `native` (default) - Native Rust execution
+- `wasm` - WebAssembly support
+- `cli` - CLI tools (jj-agent-hook)
+- `mcp` - MCP protocol support
+- `mcp-full` - MCP + native runtime
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────┐
+│              AI Agent Layer                         │
+│  (Claude, GPT-4, Local LLMs)                       │
+└─────────────────┬───────────────────────────────────┘
+                  │
+┌─────────────────▼───────────────────────────────────┐
+│         agentic-jujutsu (This Library)              │
+│  • Zero-overhead WASM bindings                      │
+│  • Structured conflict API                          │
+│  • Operation log & learning                         │
+│  • MCP protocol (stdio/SSE)                         │
+└─────────────────┬───────────────────────────────────┘
+                  │
+┌─────────────────▼───────────────────────────────────┐
+│           Jujutsu VCS (jj)                          │
+│  • Lock-free operations                             │
+│  • Multi-workspace support                          │
+│  • Native Git interop                               │
+└─────────────────────────────────────────────────────┘
+```
+
+## Examples
+
+### Multi-Agent Collaboration
+
+```rust
+use agentic_jujutsu::JJWrapper;
+
+async fn agent_workflow(agent_id: &str, task: &str) -> Result<(), Box<dyn std::error::Error>> {
+    let jj = JJWrapper::new()?;
+
+    // Create isolated workspace
+    jj.new_commit(&format!("[{}] {}", agent_id, task)).await?;
+
+    // Do work...
+    jj.describe(&format!("[{}] Complete: {}", agent_id, task)).await?;
+
+    Ok(())
+}
+
+#[tokio::main]
+async fn main() {
+    // Run 10 agents concurrently - no lock contention!
+    let handles: Vec<_> = (0..10)
+        .map(|i| tokio::spawn(agent_workflow(&format!("agent-{}", i), "implement feature")))
+        .collect();
+
+    for handle in handles {
+        handle.await.unwrap().unwrap();
+    }
+}
+```
+
+### Conflict-Aware Agent
+
+```rust
+use agentic_jujutsu::JJWrapper;
+
+async fn auto_resolve_conflicts(jj: &JJWrapper) -> Result<(), Box<dyn std::error::Error>> {
+    let conflicts = jj.getConflicts().await?;
+
+    for conflict in conflicts {
+        println!("Auto-resolving conflict in: {}", conflict.path);
+
+        // AI-powered resolution
+        let resolution = ai_resolve_conflict(&conflict).await?;
+
+        // Apply resolution
+        std::fs::write(&conflict.path, resolution)?;
+        jj.describe(&format!("Auto-resolve conflict in {}", conflict.path)).await?;
+    }
+
+    Ok(())
+}
+```
+
+### Learning from History
+
+```rust
+use agentic_jujutsu::{AgentDBSync, AgentDBEpisode, JJOperation};
+
+async fn learn_from_operations(ops: Vec<JJOperation>) -> Result<(), Box<dyn std::error::Error>> {
+    let agentdb = AgentDBSync::new(true);
+
+    for op in ops {
+        let episode = AgentDBEpisode::from_operation(
+            &op,
+            "session-001".to_string(),
+            "agent-1".to_string()
+        )
+        .with_success(true, 0.95);
+
+        agentdb.store_episode(&episode).await?;
+    }
+
+    // Query for similar work
+    let similar = agentdb.query_similar_operations("implement authentication", 5).await?;
+    println!("Found {} similar past operations", similar.len());
+
+    Ok(())
+}
+```
+
+## Documentation
+
+- [Complete API Documentation](https://docs.rs/agentic-jujutsu)
+- [MCP Implementation Guide](https://github.com/ruvnet/agentic-flow/blob/main/packages/agentic-jujutsu/docs/MCP_IMPLEMENTATION_COMPLETE.md)
+- [Benchmarks](https://github.com/ruvnet/agentic-flow/blob/main/packages/agentic-jujutsu/docs/benchmarks/BENCHMARK_EXECUTIVE_SUMMARY.md)
+- [Architecture](https://github.com/ruvnet/agentic-flow/blob/main/packages/agentic-jujutsu/docs/architecture/ARCHITECTURE.md)
+- [GitHub Repository](https://github.com/ruvnet/agentic-flow/tree/main/packages/agentic-jujutsu)
+
+## Why Jujutsu for AI Agents?
+
+Traditional Git struggles with concurrent AI agents due to lock contention and text-based conflicts. Jujutsu solves this:
+
+- **Lock-Free** — No `.git/index.lock` blocking your agents
+- **23x Faster** — Concurrent commits without waiting
+- **87% Auto-Resolve** — Structured conflict API for AI
+- **True Multi-Workspace** — Isolated environments per agent
+- **Complete Audit Trail** — Every operation permanently logged
+- **Git Compatible** — Works with existing Git repositories
+
+## Hybrid Approach
+
+Use Jujutsu locally for speed, Git for ecosystem compatibility:
+
+```bash
+# Initialize with co-located .git/
+jj init --git-repo .
+
+# Use jj for local operations (fast!)
+jj new -m "Feature work"
+
+# Use git for remote operations (compatible!)
+jj git push
+```
+
+✅ **10-100x speedup** for agents
+✅ **Zero migration risk** (Git fallback)
+✅ **Full GitHub compatibility**
+
+## SEO Keywords
+
+AI agents • autonomous agents • multi-agent systems • version control • VCS • Jujutsu • Git alternative • WASM • WebAssembly • concurrent operations • lock-free • Model Context Protocol • MCP • AgentDB • pattern learning • collaborative AI • distributed AI • agentic workflows • AI infrastructure • ruv.io
+
+## Related Projects
+
+- **[agentic-flow](https://github.com/ruvnet/agentic-flow)** - Multi-agent orchestration framework
+- **[Agent Booster](https://github.com/ruvnet/agentic-flow/tree/main/agent-booster)** - 352x faster code transformations
+- **[AgentDB](https://github.com/ruvnet/agentic-flow/packages/agentdb)** - Vector database for agent memory
+- **[ruv.io](https://ruv.io)** - AI Agent Infrastructure Platform
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](https://github.com/ruvnet/agentic-flow/blob/main/CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT License - see [LICENSE](https://github.com/ruvnet/agentic-flow/blob/main/packages/agentic-jujutsu/LICENSE) for details.
+
+## Support
+
+- **Issues:** [GitHub Issues](https://github.com/ruvnet/agentic-flow/issues)
+- **Discussions:** [GitHub Discussions](https://github.com/ruvnet/agentic-flow/discussions)
+- **Documentation:** [docs.rs/agentic-jujutsu](https://docs.rs/agentic-jujutsu)
+- **Website:** [ruv.io](https://ruv.io)
+
+---
+
+**Made with ❤️ for AI Agents**
+
+[Get Started](https://docs.rs/agentic-jujutsu) • [Benchmarks](https://github.com/ruvnet/agentic-flow/tree/main/packages/agentic-jujutsu/docs/benchmarks) • [API Docs](https://docs.rs/agentic-jujutsu) • [Examples](https://github.com/ruvnet/agentic-flow/tree/main/packages/agentic-jujutsu/examples)
+
+🤖 Part of the [agentic-flow](https://github.com/ruvnet/agentic-flow) ecosystem by [ruv.io](https://ruv.io)