stigmergy 1.2.8 → 1.2.10

package/README.md

@@ -13,14 +13,26 @@ A comprehensive system for collaboration between multiple AI CLI tools. This sys
 
 ## Quick Start
 
-```bash
-# Install the core system
+### Installation (One Command)
+
+**Windows:**
+```powershell
+# Method 1: Right-click PowerShell and "Run as Administrator"
 npm install -g stigmergy
 
-# Scan for available AI CLI tools
-stigmergy scan
+# Method 2: Start PowerShell as Administrator from command line
+Start-Process PowerShell -Verb RunAs -ArgumentList "npm install -g stigmergy"
+```
+
+**macOS/Linux:**
+```bash
+sudo npm install -g stigmergy
+```
 
-# Install missing tools
+### Setup and Use
+
+```bash
+# Install all AI CLI tools
 stigmergy install
 
 # Deploy hooks for cross-CLI integration
@@ -32,6 +44,20 @@ stigmergy gemini "translate this text"
 stigmergy qwen "analyze this code"
 ```
 
+### Permission Issues?
+
+**Windows:**
+```powershell
+# If you get permission errors:
+npm install -g stigmergy --force
+```
+
+**macOS/Linux:**
+```bash
+# If you get permission errors:
+sudo npm install -g stigmergy --unsafe-perm=true --allow-root
+```
+
 ## Cross-CLI Communication
 
 When you need to call other AI tools, use the following format:
@@ -57,4 +83,12 @@ Available tools: claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, code
 
 ## Contributing
 
-This project follows the MIT License. Contributions are welcome!
+This project is a collaboration between multiple AI systems:
+- Claude (Anthropic)
+- Qwen (Alibaba)
+- iFlow (Intelligent Workflow)
+- QoderCLI
+- GLM4.5 (Zhipu AI)
+- And other AI systems
+
+Contributions are welcome!

package/STIGMERGY.md

@@ -14,6 +14,16 @@ Cross-CLI communication is enabled between all supported AI tools:
 - GitHub Copilot
 - OpenAI Codex
 
+## Project Contributors
+
+This project is made possible through the contribution of various AI systems:
+- Claude (Anthropic)
+- Qwen (Alibaba)
+- iFlow (Intelligent Workflow)
+- QoderCLI
+- GLM4.5 (Zhipu AI)
+- And other AI systems
+
 ## Cross-CLI Collaboration
 
 Stigmergy provides a unified command interface for cross-CLI communication:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stigmergy",
-  "version": "1.2.8",
+  "version": "1.2.10",
   "description": "Stigmergy CLI - Multi-Agents Cross-AI CLI Tools Collaboration System",
   "main": "src/index.js",
   "bin": {
@@ -49,7 +49,13 @@
     "postinstall": "node src/index.js auto-install",
     "preuninstall": "node scripts/preuninstall.js",
     "postuninstall": "node scripts/postuninstall.js",
-    "docs:update": "node scripts/generate-cli-docs.js"
+    "docs:update": "node scripts/generate-cli-docs.js",
+    "install": "node src/index.js install",
+    "install:check": "node src/index.js status",
+    "install:verbose": "node src/index.js install --verbose",
+    "install:force": "node src/index.js install --force",
+    "fix-perms": "node fix-permissions.js --auto",
+    "fix-perms:check": "node fix-permissions.js --check"
   },
   "keywords": [
     "ai",
@@ -88,20 +94,28 @@
     "url": "git+https://github.com/ptreezh/stigmergy-CLI-Multi-Agents.git"
   },
   "author": "Stigmergy CLI Team",
+  "contributors": [
+    "Claude",
+    "Qwen",
+    "iFlow",
+    "QoderCLI",
+    "GLM4.5",
+    "Other AI Systems"
+  ],
   "license": "MIT",
   "engines": {
     "node": ">=16.0.0"
   },
   "dependencies": {
     "chalk": "^4.1.2",
-    "commander": "^14.0.2",
+    "commander": "^11.1.0",
     "inquirer": "^8.2.6",
     "js-yaml": "^4.1.1",
     "semver": "^7.7.3"
   },
   "devDependencies": {
-    "eslint": "^8.50.0",
-    "jest": "^30.2.0",
+    "eslint": "^8.57.1",
+    "jest": "^29.7.0",
     "prettier": "^3.7.4",
     "rimraf": "^6.1.2"
   },

package/scripts/preuninstall.js

@@ -8,6 +8,15 @@
 const path = require('path');
 const { spawnSync } = require('child_process');
 
+// Detect npm environment for better output visibility
+const isNpmUninstall = process.env.npm_lifecycle_event === 'preuninstall' || 
+                      process.env.npm_lifecycle_event === 'uninstall';
+const criticalLog = isNpmUninstall ? console.error : console.log;
+
+criticalLog('🔄 STIGMERGY CLI PRE-UNINSTALL CLEANUP');
+criticalLog('='.repeat(50));
+criticalLog('Cleaning up configuration files and hooks...');
+criticalLog('='.repeat(50));
 console.log('🔄 Running pre-uninstall cleanup for Stigmergy CLI...');
 
 try {
@@ -18,6 +27,7 @@ try {
     verbose: true   // Show detailed output
   });
 
+  criticalLog('🗑️ Starting enhanced uninstallation process...\n');
   console.log('🗑️ Starting enhanced uninstallation process...\n');
 
   // Execute the uninstallation asynchronously 

package/src/adapters/claude/install_claude_integration.js

@@ -127,20 +127,20 @@ class ClaudeInstaller {
 
   async createGlobalCrossCliDocumentation(configDir) {
     try {
-      const docContent = `# Claude CLI Cross-CLI 通信指南
+      const docContent = `# Claude CLI Cross-CLI Communication Guide
 
 ## Cross-CLI Communication
-当您需要调用其他AI工具时，请使用以下提示<<<在shell中执行以下命令：stigmergy distcli "Prompt">>>
+When you need to call other AI tools, use the following prompt<<<Execute the following command in shell: stigmergy distcli "Prompt">>>
 
-示例：
-- 在shell中运行：stigmergy claude "写一个Python函数"
-- 在shell中运行：stigmergy gemini "翻译这段文字"
-- 在shell中运行：stigmergy qwen "分析这段代码"
+Examples:
+- Run in shell: stigmergy claude "Write a Python function"
+- Run in shell: stigmergy gemini "Translate this text"
+- Run in shell: stigmergy qwen "Analyze this code"
 
-可用工具：claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex
+Available tools: claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex
 
 ---
-*本文档由Stigmergy CLI自动生成和维护*
+*This document is automatically generated and maintained by Stigmergy CLI*
 `;
       
       const docPath = path.join(configDir, 'CROSS_CLI_GUIDE.md');
@@ -154,17 +154,17 @@ class ClaudeInstaller {
         const crossCliContent = `
 
 ## Cross-CLI Communication
-当您需要调用其他AI工具时，请使用以下提示<<<在shell中执行以下命令：stigmergy distcli "Prompt">>>
+When you need to call other AI tools, use the following prompt<<<Execute the following command in shell: stigmergy distcli "Prompt">>>
 
-示例：
-- 在shell中运行：stigmergy claude "写一个Python函数"
-- 在shell中运行：stigmergy gemini "翻译这段文字"
-- 在shell中运行：stigmergy qwen "分析这段代码"
+Examples:
+- Run in shell: stigmergy claude "Write a Python function"
+- Run in shell: stigmergy gemini "Translate this text"
+- Run in shell: stigmergy qwen "Analyze this code"
 
-可用工具：claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex
+Available tools: claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex
 `;
         await fs.appendFile(claudeMdPath, crossCliContent);
-        console.log('[OK] 在CLAUDE.md末尾追加Cross-CLI通信提示');
+        console.log('[OK] Append Cross-CLI communication prompt to CLAUDE.md');
       } catch (e) {
         // File doesn't exist, that's ok
       }
@@ -177,7 +177,7 @@ class ClaudeInstaller {
   }
 
   async verifyInstallation() {
-    console.log('\n验证Claude CLI集成安装...');
+    console.log('\nVerifying Claude CLI integration installation...');
 
     // Check config directory
     if (!await fs.access(this.configDir).then(() => true).catch(() => false)) {
@@ -243,19 +243,19 @@ class ClaudeInstaller {
     console.log('==========================================');
 
     // Execute installation
-    console.log('Step 1. 创建配置目录...');
+    console.log('Step 1. Creating config directory...');
     await this.createConfigDirectory();
 
-    console.log('\nStep 2. 安装配置...');
+    console.log('\nStep 2. Installing configuration...');
     const configSuccess = await this.installConfig();
 
-    console.log('\nStep 3. 安装钩子...');
+    console.log('\nStep 3. Installing hooks...');
     const hooksSuccess = await this.installHooks();
 
-    console.log('\nStep 4. 复制适配器文件...');
+    console.log('\nStep 4. Copying adapter files...');
     const adapterSuccess = await this.copyAdapterFiles();
 
-    console.log('\nStep 5. 验证安装...');
+    console.log('\nStep 5. Verifying installation...');
     const verificationSuccess = await this.verifyInstallation();
 
     const overallSuccess = configSuccess && hooksSuccess && adapterSuccess && verificationSuccess;

package/src/adapters/codebuddy/install_codebuddy_integration.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 
 /**
- * CodeBuddy CLI Skills集成安装脚本
- * 为CodeBuddy CLI安装跨CLI协作感知能力
+ * CodeBuddy CLI Skills Integration Installation Script
+ * Install cross-CLI collaboration awareness capability for CodeBuddy CLI
  * 
- * 使用方法：
+ * Usage:
  * node install_codebuddy_integration.js [--verify|--uninstall]
  */
 
@@ -12,7 +12,7 @@ const fs = require('fs').promises;
 const path = require('path');
 const os = require('os');
 
-// CodeBuddy CLI配置路径
+// CodeBuddy CLI configuration paths
 const CODEBUDDY_CONFIG_DIR = path.join(os.homedir(), '.codebuddy');
 const CODEBUDDY_CONFIG_FILE = path.join(CODEBUDDY_CONFIG_DIR, 'buddy_config.json');
 
@@ -22,39 +22,39 @@ class CodeBuddyIntegrationInstaller {
   }
 
   /**
-   * 创建CodeBuddy配置目录
+   * Create CodeBuddy configuration directory
    */
   async createCodeBuddyConfigDirectory() {
     try {
       await fs.mkdir(CODEBUDDY_CONFIG_DIR, { recursive: true });
-      console.log(`[OK] 创建CodeBuddy配置目录: ${CODEBUDDY_CONFIG_DIR}`);
+      console.log(`[OK] Created CodeBuddy config directory: ${CODEBUDDY_CONFIG_DIR}`);
       return true;
     } catch (error) {
-      console.log(`[ERROR] 创建CodeBuddy配置目录失败: ${error.message}`);
+      console.log(`[ERROR] Failed to create CodeBuddy config directory: ${error.message}`);
       return false;
     }
   }
 
   /**
-   * 安装CodeBuddy Skills配置
+   * Install CodeBuddy Skills configuration
    */
   async installCodeBuddySkills() {
     try {
-      // 读取现有buddy_config配置
+      // Read existing buddy_config configuration
       let existingConfig = {};
       try {
         const data = await fs.readFile(CODEBUDDY_CONFIG_FILE, 'utf8');
         existingConfig = JSON.parse(data);
       } catch (error) {
-        console.log(`[WARN] 读取现有buddy_config配置失败: ${error.message}`);
+        console.log(`[WARN] Failed to read existing buddy_config: ${error.message}`);
         existingConfig = {};
       }
 
-      // 定义跨CLI协作的Skills配置
+      // Define cross-CLI collaboration Skills configuration
       const crossCliSkills = {
         cross_cli_skill: {
           name: 'CrossCLICoordinationSkill',
-          description: 'Cross-CLI工具协调技能',
+          description: 'Cross-CLI tool coordination skill',
           module: 'src.adapters.codebuddy.skills_hook_adapter',
           class: 'CodeBuddySkillsHookAdapter',
           enabled: true,
@@ -73,13 +73,13 @@ class CodeBuddyIntegrationInstaller {
         }
       };
 
-      // 合并配置（保留现有skills，添加协作功能）
+      // Merge configurations (keep existing skills, add collaboration functionality)
       const mergedConfig = { ...existingConfig };
-      if (!mergedConfig.skills) {
+      if (!mergedConfig.skills || !Array.isArray(mergedConfig.skills)) {
         mergedConfig.skills = [];
       }
 
-      // 检查是否已存在跨CLI协调技能
+      // Check if cross-CLI coordination skill already exists
       const existingSkillNames = mergedConfig.skills.map(skill => skill.name);
       const crossCliSkillName = 'CrossCLICoordinationSkill';
 
@@ -87,11 +87,11 @@ class CodeBuddyIntegrationInstaller {
         mergedConfig.skills.push(crossCliSkills.cross_cli_skill);
       }
 
-      // 写入配置文件
+      // Write configuration file
       await fs.writeFile(CODEBUDDY_CONFIG_FILE, JSON.stringify(mergedConfig, null, 2), 'utf8');
 
-      console.log(`[OK] CodeBuddy配置已安装: ${CODEBUDDY_CONFIG_FILE}`);
-      console.log('已安装的Skills:');
+      console.log(`[OK] CodeBuddy configuration installed: ${CODEBUDDY_CONFIG_FILE}`);
+      console.log('Installed Skills:');
       mergedConfig.skills.forEach(skill => {
         const status = skill.enabled ? '[OK]' : '[DISABLED]';
         console.log(`   - ${skill.name}: ${status}`);
@@ -99,7 +99,7 @@ class CodeBuddyIntegrationInstaller {
 
       return true;
     } catch (error) {
-      console.log(`[ERROR] 安装CodeBuddy配置失败: ${error.message}`);
+      console.log(`[ERROR] Failed to install CodeBuddy configuration: ${error.message}`);
       return false;
     }
   }
@@ -146,30 +146,33 @@ class CodeBuddyIntegrationInstaller {
    * 验证安装是否成功
    */
   async verifyInstallation() {
-    console.log('\n验证CodeBuddy CLI集成安装...');
+    console.log('\nVerifying CodeBuddy CLI integration installation...');
 
     try {
-      // 检查配置文件
+      // Check configuration file
       await fs.access(CODEBUDDY_CONFIG_FILE);
       
-      // 检查配置文件内容
+      // Check configuration file content
       const data = await fs.readFile(CODEBUDDY_CONFIG_FILE, 'utf8');
       const config = JSON.parse(data);
       
-      // 检查是否存在跨CLI技能
-      const skills = config.skills || [];
+      // Check if cross-CLI skill exists
+      let skills = config.skills;
+      if (!Array.isArray(skills)) {
+        skills = [];
+      }
       const crossCliSkillFound = skills.some(skill => skill.name === 'CrossCLICoordinationSkill');
       
       if (crossCliSkillFound) {
-        console.log('[OK] 跨CLI协调技能已安装');
+        console.log('[OK] Cross-CLI coordination skill installed');
       } else {
-        console.log('[WARN] 未找到跨CLI协调技能');
+        console.log('[WARN] Cross-CLI coordination skill not found');
       }
         
-      console.log('[OK] CodeBuddy配置文件验证通过');
+      console.log('[OK] CodeBuddy configuration file verification passed');
       return true;
     } catch (error) {
-      console.log(`[ERROR] 配置文件验证失败: ${error.message}`);
+      console.log(`[ERROR] Configuration file verification failed: ${error.message}`);
       return false;
     }
   }
@@ -226,20 +229,20 @@ class CodeBuddyIntegrationInstaller {
    */
   async createGlobalCrossCliDocumentation() {
     try {
-      const docContent = `# CodeBuddy CLI 跨CLI通信指南
+      const docContent = `# CodeBuddy CLI Cross-CLI Communication Guide
 
 ## Cross-CLI Communication
-当您需要调用其他AI工具时，请使用以下提示<<<在shell中执行以下命令：stigmergy <工具名> <任务描述>>>>
+When you need to call other AI tools, use the following prompt<<<Execute the following command in shell: stigmergy <tool_name> <task_description>>>>>
 
-示例：
-- 在shell中运行：stigmergy claude "写一个Python函数"
-- 在shell中运行：stigmergy gemini "翻译这段文字"
-- 在shell中运行：stigmergy qwen "分析这段代码"
+Examples:
+- Run in shell: stigmergy claude "Write a Python function"
+- Run in shell: stigmergy gemini "Translate this text"
+- Run in shell: stigmergy qwen "Analyze this code"
 
-可用工具：claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex
+Available tools: claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex
 
 ---
-*本文档由Stigmergy CLI自动生成和维护*
+*This document is automatically generated and maintained by Stigmergy CLI*
 `;
       
       const docPath = path.join(CODEBUDDY_CONFIG_DIR, 'CROSS_CLI_GUIDE.md');
@@ -254,17 +257,17 @@ class CodeBuddyIntegrationInstaller {
         const crossCliContent = `
 
 ## Cross-CLI Communication
-当您需要调用其他AI工具时，请使用以下提示<<<在shell中执行以下命令：stigmergy <工具名> <任务描述>>>>
+When you need to call other AI tools, use the following prompt<<<Execute the following command in shell: stigmergy <tool_name> <task_description>>>>>
 
-示例：
-- 在shell中运行：stigmergy claude "写一个Python函数"
-- 在shell中运行：stigmergy gemini "翻译这段文字"
-- 在shell中运行：stigmergy qwen "分析这段代码"
+Examples:
+- Run in shell: stigmergy claude "Write a Python function"
+- Run in shell: stigmergy gemini "Translate this text"
+- Run in shell: stigmergy qwen "Analyze this code"
 
-可用工具：claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex
+Available tools: claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex
 `;
         await fs.appendFile(codebuddyMdPath, crossCliContent, 'utf8');
-        console.log('[OK] 在CODEBUDDY.md末尾追加Cross-CLI通信提示');
+        console.log('[OK] Append Cross-CLI communication prompt to CODEBUDDY.md');
       } catch (error) {
         // 文件可能不存在，忽略
       }
@@ -299,26 +302,26 @@ class CodeBuddyIntegrationInstaller {
     console.log('\n步骤4. 创建Cross-CLI通信指南...');
     const guideSuccess = await this.createGlobalCrossCliDocumentation();
 
-    // 步骤5. 验证安装
-    console.log('\n步骤5. 验证安装...');
+    // Step 5. Verify installation
+    console.log('\nStep 5. Verifying installation...');
     const verificationSuccess = await this.verifyInstallation();
 
     const overallSuccess = configDirSuccess && skillsSuccess && adapterSuccess && guideSuccess && verificationSuccess;
     
     const duration = Date.now() - this.startTime;
-    console.log(`\n[INFO] 安装耗时: ${duration}ms`);
+    console.log(`\n[INFO] Installation took: ${duration}ms`);
     
     if (overallSuccess) {
-      console.log('\n[SUCCESS] CodeBuddy CLI跨CLI集成安装成功!');
+      console.log('\n[SUCCESS] CodeBuddy CLI cross-CLI integration installed successfully!');
     } else {
-      console.log('\n[WARNING] 安装过程中出现警告，请检查上述输出');
+      console.log('\n[WARNING] Warnings occurred during installation, please check above output');
     }
 
     return overallSuccess;
   }
 }
 
-// 主函数
+// Main function
 async function main() {
   const args = process.argv.slice(2);
   const verify = args.includes('--verify');
@@ -335,10 +338,10 @@ async function main() {
   }
 }
 
-// 导出模块
+// Export module
 module.exports = CodeBuddyIntegrationInstaller;
 
-// 如果直接运行此脚本
+// If running this script directly
 if (require.main === module) {
   main().then(success => {
     process.exit(success ? 0 : 1);

package/src/adapters/codex/install_codex_integration.js

@@ -273,12 +273,12 @@ class CodexIntegrationInstaller {
       const docContent = `# Codex CLI Cross-CLI Communication Guide
 
 ## Cross-CLI Communication
-When you need to call other AI tools, please use the following prompt <<<Execute the following command in shell: stigmergy <tool_name> <task_description>>>>
+When you need to call other AI tools, please use the following prompt<<<Execute the following command in shell: stigmergy <tool_name> <task_description>>>>
 
 Examples:
-- Run in shell: stigmergy claude "write a Python function"
-- Run in shell: stigmergy gemini "translate this text"
-- Run in shell: stigmergy qwen "analyze this code"
+- Run in shell: stigmergy claude "Write a Python function"
+- Run in shell: stigmergy gemini "Translate this text"
+- Run in shell: stigmergy qwen "Analyze this code"
 
 Available tools: claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex
 
@@ -309,7 +309,7 @@ Examples:
 Available tools: claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex
 `;
         await fs.appendFile(codexMdPath, crossCliContent);
-        console.log('[OK] 在CODEX.md末尾追加Cross-CLI通信提示');
+        console.log('[OK] Append Cross-CLI communication prompt to CODEX.md');
       } catch (error) {
         // 文件可能不存在，忽略
       }
@@ -328,31 +328,30 @@ Available tools: claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, code
     console.log('Codex CLI Cross-CLI Integration Installer');
     console.log('='.repeat(50));
 
-    // 步骤1. 创建配置目录
-    console.log('\n步骤1. 创建配置目录...');
-    const configDirSuccess = await this.createCodexConfigDirectory();
-
-    // 步骤2. 安装Slash Commands配置
-    console.log('\n步骤2. 安装Slash Commands配置...');
-    const slashCommandsSuccess = await this.installCodexSlashCommands(true);
-
-    // 步骤3. 复制适配器文件
-    console.log('\n步骤3. 复制适配器文件...');
-    const adapterSuccess = await this.copyAdapterFile();
-
-    // 步骤4. 创建Cross-CLI通信指南
-    console.log('\n步骤4. 创建Cross-CLI通信指南...');
-    const guideSuccess = await this.createGlobalCrossCliDocumentation();
-
-    // 步骤5. 验证安装
-    console.log('\n步骤5. 验证安装...');
-    const verificationSuccess = await this.verifyInstallation();
-
-    const overallSuccess = configDirSuccess && slashCommandsSuccess && adapterSuccess && guideSuccess && verificationSuccess;
+          // Step 1. Create config directory
+          console.log('\nStep 1. Creating config directory...');
+          const configDirSuccess = await this.createCodexConfigDirectory();
+    
+          // Step 2. Install Slash Commands config
+          console.log('\nStep 2. Installing Slash Commands config...');
+          const slashCommandsSuccess = await this.installCodexSlashCommands(true);
+    
+          // Step 3. Copy adapter files
+          console.log('\nStep 3. Copying adapter files...');
+          const adapterSuccess = await this.copyAdapterFile();
+    
+          // Step 4. Create Cross-CLI communication guide
+          console.log('\nStep 4. Creating Cross-CLI communication guide...');
+          const guideSuccess = await this.createGlobalCrossCliDocumentation();
     
-    const duration = Date.now() - this.startTime;
-    console.log(`\n[INFO] 安装耗时: ${duration}ms`);
+          // Step 5. Verify installation
+          console.log('\nStep 5. Verifying installation...');
+          const verificationSuccess = await this.verifyInstallation();
     
+          const overallSuccess = configDirSuccess && slashCommandsSuccess && adapterSuccess && guideSuccess && verificationSuccess;
+          
+          const duration = Date.now() - this.startTime;
+          console.log(`\n[INFO] Installation took: ${duration}ms`);    
     if (overallSuccess) {
       console.log('\n[SUCCESS] Codex CLI cross-CLI integration installed successfully!');
     } else {