stigmergy 1.1.4 → 1.1.6

package/STIGMERGY.md

@@ -4,30 +4,50 @@ This project is configured for Stigmergy-based multi-AI CLI collaboration.
 
 ## Available AI CLI Tools
 
-
-
-## Usage Examples
-
-### Cross-CLI Collaboration
+Cross-CLI communication is enabled between all supported AI tools:
+- Claude (Anthropic)
+- Qwen (Alibaba)
+- Gemini (Google)
+- iFlow (Intelligent Workflow)
+- Qoder CLI
+- CodeBuddy
+- GitHub Copilot
+- OpenAI Codex
+
+## Cross-CLI Collaboration
+
+Instead of using a central command, cross-CLI communication happens directly between tools through hooks:
+
+### How It Works
+1. Each CLI tool has hooks deployed by Stigmergy
+2. When one tool detects a request to use another tool, it triggers cross-CLI communication
+3. The target tool executes the requested task and returns results
+
+### Usage Pattern
+From any supported CLI tool, use natural language patterns:
 ```bash
-# Use Claude to analyze code
-stigmergy call claude "analyze this function"
-
-# Use Gemini for documentation
-stigmergy call gemini "generate docs for this file"
-
-# Use Qwen for translation
-stigmergy call qwen "translate to English"
+# Natural language patterns recognized by hooks
+"use qwen to translate this code to Python"
+"ask claude to review this algorithm"
+"call gemini to explain this concept"
 ```
 
-### Project Initialization
-```bash
-# Initialize with Claude as primary AI
-stigmergy init --primary claude
+## Project Memory and Documentation
 
-# Initialize with multiple AI tools
-stigmergy init --all-tools
-```
+This project automatically generates documentation for each CLI tool:
+- claude.md
+- qwen.md
+- gemini.md
+- iflow.md
+- qodercli.md
+- codebuddy.md
+- copilot.md
+- codex.md
+
+Each documentation file contains:
+- Tool configuration information
+- Usage patterns
+- Cross-CLI communication instructions
 
 ## Configuration
 
@@ -36,7 +56,7 @@ Global configuration: `~/.stigmergy/config.json`
 ## Getting Started
 
 1. Run `stigmergy status` to verify setup
-2. Use `stigmergy call <ai-tool> "<prompt>"` to collaborate with AI CLI tools
-3. Check project-specific configurations in individual CLI tool directories
+2. Check individual CLI documentation files for specific usage instructions
+3. Use natural language requests within any CLI tool to trigger cross-CLI communication
 
-For more information: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents
+For more information: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stigmergy",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "Stigmergy CLI - Multi-Agents Cross-AI CLI Tools Collaboration System",
   "main": "src/index.js",
   "bin": {

package/src/cli/router.js

@@ -60,7 +60,7 @@ async function main() {
     console.log(
       '  init            Initialize Stigmergy configuration (alias for setup)',
     );
-    console.log('  call "<prompt>" Execute prompt with auto-routed AI CLI');
+    
     console.log('  fibonacci <n>   Calculate the nth Fibonacci number');
     console.log('  fibonacci seq <n> Generate the first n Fibonacci numbers');
     console.log('  errors          Display error report and statistics');
@@ -71,7 +71,7 @@ async function main() {
       '  2. stigmergy install             # Auto-scan & install CLI tools',
     );
     console.log('  3. stigmergy setup               # Deploy hooks & config');
-    console.log('  4. stigmergy call "<prompt>"   # Start collaborating');
+    
     console.log('');
     console.log(
       'For more information, visit: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents',
@@ -281,118 +281,7 @@ async function main() {
     break;
   }
 
-  case 'call': {
-    if (args.length < 2) {
-      console.log('[ERROR] Please provide a prompt');
-      console.log('Usage: stigmergy call "<your prompt>"');
-      process.exit(1);
-    }
-
-    // Extract prompt from quotes or join remaining args
-    let prompt = '';
-    if (args[1].startsWith('"') && args[args.length - 1].endsWith('"')) {
-      // Quoted prompt
-      prompt = args.slice(1).join(' ').slice(1, -1);
-    } else {
-      // Unquoted prompt
-      prompt = args.slice(1).join(' ');
-    }
-
-    try {
-      console.log(`[ROUTE] Analyzing prompt: ${prompt}`);
-
-      // Route to appropriate AI CLI tool
-      const route = await router.smartRoute(prompt);
-      console.log(`[ROUTE] Selected tool: ${route.tool}`);
-
-      // Prepare tool arguments
-      let toolArgs = [];
-      
-      try {
-        // Get CLI pattern for this tool
-        const cliPattern = await router.analyzer.getCLIPattern(route.tool);
-
-        // Use the unified CLI parameter handler
-        const CLIParameterHandler = require('../core/cli_parameter_handler');
-        toolArgs = CLIParameterHandler.generateArguments(
-          route.tool,
-          route.prompt,
-          cliPattern,
-        );
-      } catch (patternError) {
-        // Fallback to original logic if pattern analysis fails
-        if (route.tool === 'claude') {
-          // Claude CLI expects the prompt with -p flag for non-interactive mode
-          toolArgs = ['-p', `"${route.prompt}"`];
-        } else if (route.tool === 'qodercli' || route.tool === 'iflow') {
-          // Qoder CLI and iFlow expect the prompt with -p flag
-          toolArgs = ['-p', `"${route.prompt}"`];
-        } else if (route.tool === 'codex') {
-          // Codex CLI needs 'exec' subcommand for non-interactive mode
-          toolArgs = ['exec', '-p', `"${route.prompt}"`];
-        } else {
-          // For other tools, pass the prompt with -p flag
-          toolArgs = ['-p', `"${route.prompt}"`];
-        }
-      }
-      
-      const toolPath = route.tool;
-
-      console.log(`[EXEC] Running: ${toolPath} ${toolArgs.join(' ')}`);
-
-      // Execute the AI CLI tool
-      const startTime = Date.now();
-      try {
-        const result = await executeCommand(toolPath, toolArgs);
-
-        if (result.success) {
-          console.log('[RESULT] Success!');
-          console.log(result.output);
-
-          // Save to memory
-          await memory.addInteraction(route.tool, prompt, result.output);
-
-          // Exit with the same code as the executed command
-          process.exit(result.code || 0);
-        }
-      } catch (executionError) {
-        const cliError = await errorHandler.handleCLIError(
-          route.tool,
-          executionError.error || executionError,
-          toolArgs.join(' '),
-        );
-
-        // Provide clear ANSI English error message
-        console.log('==================================================');
-        console.log('ERROR: Failed to execute AI CLI tool');
-        console.log('==================================================');
-        console.log(`Tool: ${route.tool}`);
-        console.log(`Error: ${cliError.message}`);
-        if (executionError.stderr) {
-          console.log(`Stderr: ${executionError.stderr}`);
-        }
-        console.log('');
-        console.log('Possible solutions:');
-        console.log('1. Check if the AI CLI tool is properly installed');
-        console.log('2. Verify the tool is in your system PATH');
-        console.log('3. Try reinstalling the tool with: stigmergy install');
-        console.log('4. Run stigmergy status to check tool availability');
-        console.log('');
-        console.log('For manual execution, you can run:');
-        console.log(`${toolPath} ${toolArgs.join(' ')}`);
-        console.log('==================================================');
-
-        process.exit(1);
-      }
-    } catch (error) {
-      console.log(
-        `[ERROR] Failed to route prompt:`,
-        error.message,
-      );
-      process.exit(1);
-    }
-    break;
-  }
+  
 
   case 'auto-install':
     // Auto-install mode for npm postinstall - NON-INTERACTIVE

package/src/core/coordination/nodejs/CLCommunication.js

@@ -14,16 +14,9 @@ class CLCommunication {
   async executeTask(sourceCLI, targetCLI, task, context) {
     console.log(`[CL_COMMUNICATION] Executing task from ${sourceCLI} to ${targetCLI}: ${task}`);
     
-    const targetAdapter = this.getAdapter(targetCLI);
-    if (!targetAdapter) {
-      throw new Error(`Adapter for ${targetCLI} not found`);
-    }
-
-    // For Node.js implementation, we simulate cross-CLI communication
-    // In a real implementation, this would interface with actual CLI tools
     try {
-      // Simulate CLI execution with a delay
-      const result = await this.simulateCLIExecution(targetCLI, task, context);
+      // Execute the target CLI with the task
+      const result = await this.executeCLICommand(targetCLI, task);
       return result;
     } catch (error) {
       console.error(`[CL_COMMUNICATION] Failed to execute task for ${targetCLI}:`, error);
@@ -31,26 +24,98 @@ class CLCommunication {
     }
   }
 
+  async executeCLICommand(cliName, task) {
+    return new Promise((resolve, reject) => {
+      // Prepare arguments based on the CLI type for non-interactive execution
+      const args = this.prepareCLIArguments(cliName, task);
+      
+      // Spawn the CLI command
+      const child = spawn(cliName, args, {
+        encoding: 'utf8',
+        timeout: this.executionTimeout,
+        shell: true
+      });
+
+      let stdout = '';
+      let stderr = '';
+
+      child.stdout.on('data', (data) => {
+        stdout += data.toString();
+      });
+
+      child.stderr.on('data', (data) => {
+        stderr += data.toString();
+      });
+
+      child.on('close', (code) => {
+        if (code === 0) {
+          resolve({
+            success: true,
+            output: stdout.trim(),
+            code: code
+          });
+        } else {
+          reject({
+            success: false,
+            error: stderr.trim() || stdout.trim() || `Process exited with code ${code}`,
+            code: code
+          });
+        }
+      });
+
+      child.on('error', (error) => {
+        reject({
+          success: false,
+          error: `Failed to spawn process: ${error.message}`,
+          code: null
+        });
+      });
+
+      child.on('timeout', () => {
+        child.kill();
+        reject({
+          success: false,
+          error: `Command timed out after ${this.executionTimeout}ms`,
+          code: null
+        });
+      });
+    });
+  }
+
+  prepareCLIArguments(cliName, task) {
+    // Prepare arguments based on the CLI type for non-interactive execution
+    const cliTypes = {
+      // CLIs that support -p flag for prompt
+      'claude': ['-p', task],
+      'qwen': ['-p', task],
+      'gemini': ['-p', task],
+      'iflow': ['-p', task],
+      // CLIs that support direct prompt as argument
+      'qodercli': [task],
+      'codebuddy': [task],
+      'copilot': [task],
+      'codex': [task]
+    };
+
+    const args = cliTypes[cliName];
+    return args || ['-p', task]; // Default to -p flag if not specified
+  }
+
   getAdapter(cliName) {
-    // In a real implementation, this would integrate with the adapter manager
-    // For now, we return a mock adapter
+    // Return a real adapter that can execute CLI commands
     return {
       name: cliName,
       executeTask: async (task, context) => {
-        return `[${cliName.toUpperCase()} NODE.JS SIMULATION] Executed: ${task}`;
+        try {
+          const result = await this.executeCLICommand(cliName, task);
+          return result.output;
+        } catch (error) {
+          return `[${cliName.toUpperCase()} ERROR] ${error.error || error.message}`;
+        }
       }
     };
   }
 
-  async simulateCLIExecution(cliName, task, context) {
-    // Simulate CLI execution with a promise that resolves after a short delay
-    return new Promise((resolve, reject) => {
-      setTimeout(() => {
-        resolve(`[${cliName.toUpperCase()} NODE.JS EXECUTION] Completed task: ${task}`);
-      }, Math.random() * 1000); // Random delay between 0-1000ms
-    });
-  }
-
   generateTaskId() {
     return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
   }

package/src/core/coordination/nodejs/HookDeploymentManager.js

@@ -122,20 +122,31 @@ class ${this.capitalize(cliName)}NodeJsHook {
   }
 
   detectCrossCLIRequest(prompt) {
-    // Simple pattern matching for cross-CLI requests
+    // Enhanced pattern matching for cross-CLI requests
     const patterns = [
-      /(?:use|call|ask)\\s+(\\w+)\\s+(?:to|for)\\s+(.+)$/i,
-      /(?:use|call|ask)\\s+(\\w+)\\s+(?:to|for)\\s+(.+)$/i  // English-only pattern
+      /(?:use|call|ask)\\\\s+(\\\\w+)\\\\s+(?:to|for)\\\\s+(.+)$/i,
+      /(?:please\\\\s+)?(?:use|call|ask)\\\\s+(\\\\w+)\\\\s+(.+)$/i,
+      /(\\\\w+)[,\\\\s]+(?:please\\\\s+)?(?:help\\\\s+me\\\\s+)?(.+)$/i
     ];
     
     for (const pattern of patterns) {
       const match = prompt.match(pattern);
-      if (match) {
-        return {
-          targetCLI: match[1].toLowerCase(),
-          task: match[2] || match[3],
-          source: this.cliName
-        };
+      if (match && match.length >= 3) {
+        const targetCLI = match[1].toLowerCase();
+        const task = match[2];
+        
+        // Validate that the target CLI is supported
+        const supportedCLIs = [
+          'claude', 'gemini', 'qwen', 'iflow', 'qodercli', 'codebuddy', 'codex', 'copilot'
+        ];
+        
+        if (supportedCLIs.includes(targetCLI)) {
+          return {
+            targetCLI: targetCLI,
+            task: task,
+            source: this.cliName
+          };
+        }
       }
     }
     
@@ -145,14 +156,46 @@ class ${this.capitalize(cliName)}NodeJsHook {
   async handleCrossCLIRequest(request, context) {
     this.log('INFO', \`Cross-CLI request detected: \${JSON.stringify(request)}\`);
     
-    // In a real implementation, this would communicate with the coordination layer
-    // For now, we simulate the response
-    return \`[NODE.JS HOOK] Simulated cross-CLI call to \${request.targetCLI}: \${request.task}\`;
+    // Validate the request
+    if (!request.targetCLI || !request.task) {
+      this.log('ERROR', 'Invalid cross-CLI request: missing targetCLI or task');
+      return \`[CROSS-CLI] Invalid request: missing targetCLI or task\`;
+    }
+    
+    // Check if the target CLI is the same as the source
+    if (request.targetCLI === this.cliName) {
+      this.log('WARN', 'Cross-CLI request to self ignored');
+      return \`[CROSS-CLI] Cannot call self (\${request.targetCLI})\`;
+    }
+    
+    // Communicate with the coordination layer to execute the cross-CLI call
+    try {
+      // Dynamically load the CLCommunication module
+      const modulePath = path.join(__dirname, '..', '..', '..', '..', 'src', 'core', 'coordination', 'nodejs', 'CLCommunication');
+      const CLCommunication = require(modulePath);
+      const communicator = new CLCommunication();
+      
+      const result = await communicator.executeTask(
+        request.source, 
+        request.targetCLI, 
+        request.task, 
+        context
+      );
+      
+      if (result.success) {
+        return \`[CROSS-CLI] Response from \${request.targetCLI}: \${result.output}\`;
+      } else {
+        return \`[CROSS-CLI] Error from \${request.targetCLI}: \${result.error}\`;
+      }
+    } catch (error) {
+      this.log('ERROR', \`Failed to handle cross-CLI request: \${error.message}\`);
+      return \`[CROSS-CLI] Failed to execute \${request.targetCLI}: \${error.message}\`;
+    }
   }
 
   log(level, message) {
     const timestamp = new Date().toISOString();
-    const logEntry = \`[\${timestamp}] [\${level}] [\${this.cliName.toUpperCase()}] \${message}\\n\`;
+    const logEntry = \`[\${timestamp}] [\${level}] [\${this.cliName.toUpperCase()}] \${message}\\\\n\`;
     
     try {
       fs.appendFileSync(this.logFile, logEntry);

package/src/core/installer.js

@@ -189,13 +189,20 @@ class StigmergyInstaller {
     console.log('\n[DEPLOY] Deploying project documentation...');
 
     try {
-      // Create standard project documentation files
-      const docs = {
+      // Create standard project documentation files for each CLI
+      const cliDocs = {
+        'claude.md': this.generateCLIDocumentation('claude'),
+        'gemini.md': this.generateCLIDocumentation('gemini'),
+        'qwen.md': this.generateCLIDocumentation('qwen'),
+        'iflow.md': this.generateCLIDocumentation('iflow'),
+        'qodercli.md': this.generateCLIDocumentation('qodercli'),
+        'codebuddy.md': this.generateCLIDocumentation('codebuddy'),
+        'copilot.md': this.generateCLIDocumentation('copilot'),
+        'codex.md': this.generateCLIDocumentation('codex'),
         'STIGMERGY.md': this.generateProjectMemoryTemplate(),
-        'README.md': this.generateProjectReadme(),
       };
 
-      for (const [filename, content] of Object.entries(docs)) {
+      for (const [filename, content] of Object.entries(cliDocs)) {
         const filepath = path.join(process.cwd(), filename);
         if (!(await this.fileExists(filepath))) {
           await fs.writeFile(filepath, content);
@@ -211,26 +218,45 @@ class StigmergyInstaller {
     }
   }
 
-  generateProjectMemoryTemplate() {
-    return `# Stigmergy Project Memory
-
-## Project Information
-- **Project Name**: ${path.basename(process.cwd())}
-- **Created**: ${new Date().toISOString()}
-- **Stigmergy Version**: 1.0.94
-
-## Usage Instructions
-This file automatically tracks all interactions with AI CLI tools through the Stigmergy system.
-
-## Recent Interactions
-No interactions recorded yet.
-
-## Collaboration History
-No collaboration history yet.
+  generateCLIDocumentation(cliName) {
+    const cliInfo = this.router.tools[cliName] || { name: cliName };
+    return `# ${cliInfo.name} CLI Documentation
+
+## Overview
+This document contains configuration and usage information for the ${cliInfo.name} CLI tool within the Stigmergy system.
+
+## Basic Information
+- **CLI Name**: ${cliName}
+- **Tool Name**: ${cliInfo.name}
+- **Installation Command**: \`${cliInfo.install || 'Not configured'}\`
+- **Version Check**: \`${cliInfo.version || cliName + ' --version'}\`
+
+## Usage Patterns
+The ${cliInfo.name} CLI can be invoked in several ways:
+1. Direct execution: \`${cliName} [arguments]\`
+2. Through Stigmergy coordination layer
+3. Cross-CLI calls from other tools
+
+## Cross-CLI Communication
+To call ${cliInfo.name} from another CLI tool:
+\`\`\`bash
+# From any other supported CLI
+use ${cliName} to [task description]
+# or
+call ${cliName} [task description]
+# or
+ask ${cliName} [task description]
+\`\`\`
+
+## Configuration
+This tool integrates with Stigmergy through hooks deployed to:
+\`${cliInfo.hooksDir || 'Not configured'}\`
+
+## Last Updated
+${new Date().toISOString()}
 
 ---
 *This file is automatically managed by Stigmergy CLI*
-*Last updated: ${new Date().toISOString()}*
 `;
   }
 
@@ -359,17 +385,87 @@ See [STIGMERGY.md](STIGMERGY.md) for interaction history and collaboration recor
     console.log('='.repeat(60));
     console.log('');
     console.log('Next steps:');
-    console.log('  ✅ Run `stigmergy call "<your prompt>"` to start collaborating');
-    console.log('  ✅ Or use `stigmergy --help` for more commands');
-    console.log('');
-    console.log('Example usage:');
-    console.log('  stigmergy call "Create a React component for a todo list"');
-    console.log('  stigmergy call "Refactor this Python code for better performance"');
-    console.log('  stigmergy call "Explain how this JavaScript function works"');
+    console.log('  ✅ Use `stigmergy --help` for available commands');
     console.log('');
     console.log('Happy coding with Stigmergy! 🚀');
     console.log('');
   }
+
+  generateProjectMemoryTemplate() {
+    return `# Stigmergy Project Memory
+
+## Project Information
+- **Project Name**: ${path.basename(process.cwd())}
+- **Created**: ${new Date().toISOString()}
+- **Stigmergy Version**: 1.0.94
+
+## Usage Instructions
+This file automatically tracks all interactions with AI CLI tools through the Stigmergy system.
+
+## Recent Interactions
+No interactions recorded yet.
+
+## Collaboration History
+No collaboration history yet.
+
+## Available CLI Tools
+See individual documentation files:
+- claude.md
+- gemini.md
+- qwen.md
+- iflow.md
+- qodercli.md
+- codebuddy.md
+- copilot.md
+- codex.md
+
+---
+*This file is automatically managed by Stigmergy CLI*
+*Last updated: ${new Date().toISOString()}*
+`;
+  }
+
+  generateCLIDocumentation(cliName) {
+    const cliInfo = this.router.tools[cliName] || { name: cliName };
+    return `# ${cliInfo.name} CLI Documentation
+
+## Overview
+This document contains configuration and usage information for the ${cliInfo.name} CLI tool within the Stigmergy system.
+
+## Basic Information
+- **CLI Name**: ${cliName}
+- **Tool Name**: ${cliInfo.name}
+- **Installation Command**: \`${cliInfo.install || 'Not configured'}\`
+- **Version Check**: \`${cliInfo.version || cliName + ' --version'}\`
+
+## Usage Patterns
+The ${cliInfo.name} CLI can be invoked in several ways:
+1. Direct execution: \`${cliName} [arguments]\`
+2. Through Stigmergy coordination layer
+3. Cross-CLI calls from other tools
+
+## Cross-CLI Communication
+To call ${cliInfo.name} from another CLI tool:
+\`\`\`bash
+# From any other supported CLI
+use ${cliName} to [task description]
+# or
+call ${cliName} [task description]
+# or
+ask ${cliName} [task description]
+\`\`\`
+
+## Configuration
+This tool integrates with Stigmergy through hooks deployed to:
+\`${cliInfo.hooksDir || 'Not configured'}\`
+
+## Last Updated
+${new Date().toISOString()}
+
+---
+*This file is automatically managed by Stigmergy CLI*
+`;
+  }
 }
 
 module.exports = StigmergyInstaller;