stigmergy 1.3.77 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stigmergy",
-  "version": "1.3.77",
+  "version": "1.4.0",
   "description": "Stigmergy CLI - Multi-Agents Cross-AI CLI Tools Collaboration System",
   "main": "src/index.js",
   "bin": {
@@ -53,6 +53,7 @@
     "gemini-cli",
     "qwen-cli",
     "iflow-cli",
+    "kilocode-cli",
     "real-testing",
     "python-free"
   ],
@@ -92,6 +93,7 @@
     "iFlow",
     "QoderCLI",
     "GLM4.5",
+    "KiloCode",
     "Other AI Systems"
   ],
   "license": "MIT"

package/scripts/postinstall-deploy.js

@@ -2,77 +2,75 @@
  * Stigmergy Post-install 部署脚本
  * 在 npm install -g stigmergy 后自动：
  * 1. 运行 auto-install（安装 CLI tools）
- * 2. 部署 iflow 的 agents 和 skills 到各 CLI
+ * 2. 部署 hooks 和 skills
+ * 3. 自动进入交互模式
  */
 
-const { spawn } = require('child_process');
-const path = require('path');
-const fs = require('fs').promises;
+const { spawn } = require("child_process");
+const path = require("path");
+const fs = require("fs").promises;
 
 async function postInstallDeploy() {
-  console.log('\n🚀 Stigmergy 安装后配置...');
-  console.log('=' .repeat(60));
+  console.log("\n🚀 Stigmergy 安装后配置...");
+  console.log("=".repeat(60));
 
-  // 步骤1: 运行 auto-install
-  console.log('\n📦 步骤 1/2: 自动安装 CLI tools...\n');
+  // 步骤1: 运行 auto-install（安装 CLI tools）
+  console.log("\n📦 步骤 1/3: 自动安装 CLI tools...\n");
 
   try {
-    await runCommand('node', ['src/index.js', 'auto-install']);
+    await runCommand("node", ["src/index.js", "auto-install"]);
+    console.log("\n✅ CLI tools 安装完成\n");
   } catch (error) {
-    console.log('  ⚠️  Auto-install 遇到问题（这是正常的）');
+    console.log("  ⚠️  Auto-install 遇到问题，继续部署...\n");
   }
 
-  // 步骤2: 部署 iflow 资源
-  console.log('\n📦 步骤 2/2: 部署 iflow 的 agents 和 skills...\n');
+  // 步骤2: 部署 hooks 和 skills
+  console.log("📦 步骤 2/3: 部署 hooks 和 skills...\n");
 
-  const bundleDir = path.join(__dirname, '..', 'config', 'bundle', 'iflow-bundle');
-
-  // 检查 bundle 是否存在
   try {
-    await fs.access(bundleDir);
+    const ConfigDeployer = require("../src/core/config/ConfigDeployer");
+    const deployer = new ConfigDeployer({
+      packageDir: path.join(
+        __dirname,
+        "..",
+        "config",
+        "bundle",
+        "iflow-bundle",
+      ),
+      force: false,
+      verbose: false,
+      dryRun: false,
+    });
+    await deployer.run();
   } catch (error) {
-    console.log('  ⚠️  未找到 iflow 资源包（这是正常的）');
-    console.log('  💡 如需部署，请先运行: node scripts/bundle-iflow-resources.js');
-    return;
+    console.log("  ⚠️  资源包部署跳过（可稍后手动运行: stigmergy deploy）\n");
   }
 
-  // 检查 config-bundle.json 是否存在
-  const bundlePath = path.join(bundleDir, 'config-bundle.json');
   try {
-    await fs.access(bundlePath);
+    await runCommand("node", ["src/index.js", "deploy"]);
   } catch (error) {
-    console.log('  ⚠️  config-bundle.json 不存在');
-    console.log('  💡 请先运行: node scripts/bundle-iflow-resources.js');
-    return;
+    console.log("  ⚠️  Hooks 部署遇到问题（这是正常的）");
   }
 
-  try {
-    const ConfigDeployer = require('../src/core/config/ConfigDeployer');
-
-    // 创建 deployer 实例
-    const deployer = new ConfigDeployer({
-      packageDir: bundleDir,
-      force: true,  // 强制覆盖，确保首次安装时正确部署
-      verbose: false,  // 静默模式，不干扰安装
-      dryRun: false
-    });
-
-    // 执行部署
-    const result = await deployer.run();
+  console.log("\n✅ 部署完成！");
 
-    if (result.success) {
-      console.log('\n✅ 部署完成！');
-      console.log(`📊 统计: ${result.summary.totalSuccess} 项成功, ${result.summary.totalSkip} 项跳过`);
-    }
+  // 步骤3: 自动进入交互模式
+  console.log("\n📦 步骤 3/3: 启动交互模式...\n");
+  console.log("=".repeat(60));
+  console.log("✅ Stigmergy 安装配置完成！");
+  console.log("🚀 正在进入交互模式...\n");
 
-  } catch (error) {
-    console.log('  ⚠️  资源部署遇到问题（这是正常的）');
-    console.log(`  💡 可以稍后手动运行: stigmergy deploy`);
-  }
+  const interactiveProcess = spawn("node", ["src/index.js", "interactive"], {
+    stdio: "inherit",
+    shell: true,
+    detached: true,
+  });
 
-  console.log('\n' + '=' .repeat(60));
-  console.log('✅ Stigmergy 安装完成！');
-  console.log('💡 运行: stigmergy status\n');
+  interactiveProcess.on("error", (error) => {
+    console.log(
+      "  ⚠️  无法自动进入交互模式，请手动运行: stigmergy interactive",
+    );
+  });
 }
 
 /**
@@ -81,11 +79,19 @@ async function postInstallDeploy() {
 function runCommand(cmd, args) {
   return new Promise((resolve, reject) => {
     const child = spawn(cmd, args, {
-      stdio: 'inherit',
-      shell: true
+      stdio: "pipe",
+      shell: true,
+    });
+
+    child.stdout.on("data", (data) => {
+      process.stdout.write(data.toString());
+    });
+
+    child.stderr.on("data", (data) => {
+      process.stderr.write(data.toString());
     });
 
-    child.on('close', (code) => {
+    child.on("close", (code) => {
       if (code === 0) {
         resolve();
       } else {
@@ -93,7 +99,7 @@ function runCommand(cmd, args) {
       }
     });
 
-    child.on('error', (error) => {
+    child.on("error", (error) => {
       reject(error);
     });
   });
@@ -101,6 +107,5 @@ function runCommand(cmd, args) {
 
 // 运行部署（异步，不阻塞安装）
 postInstallDeploy().catch(() => {
-  // 静默失败，不干扰 npm install
   process.exit(0);
 });

package/skills/cli-integration-sop/SKILL.md

@@ -0,0 +1,340 @@
+# CLI Integration SOP for Stigmergy
+
+## Overview
+
+This document provides a standardized Standard Operating Procedure (SOP) for integrating a new CLI tool into the Stigmergy Multi-Agents CLI Collaboration System.
+
+## CLI Integration Checklist
+
+### Phase 1: Basic Configuration (Files to Modify)
+
+#### 1.1 Add to `src/core/cli_tools.js`
+
+```javascript
+// Add new CLI entry to CLI_TOOLS object
+<CLI_NAME>: {
+  name: '<CLI Full Name>',
+  version: '<CLI_NAME> --version',
+  install: 'npm install -g <NPM_PACKAGE>',
+  hooksDir: path.join(os.homedir(), '.<CLI_NAME>', 'hooks'),
+  config: path.join(os.homedir(), '.<CLI_NAME>', 'config.json'),
+  autoInstall: true/false, // Set to true for auto-install during postinstall
+},
+```
+
+#### 1.2 Add to `src/core/cli_path_detector.js`
+
+```javascript
+// Add to cliNameMap
+this.cliNameMap = {
+  // ... existing entries
+  "<CLI_NAME>": ["<CLI_COMMAND>"], // Command to detect (e.g., 'kilo' for kilocode)
+};
+```
+
+### Phase 2: CLI Adapters (src/core/cli_adapters.js)
+
+#### 2.1 Add adapter configuration
+
+```javascript
+<CLI_NAME>: {
+  // Interactive mode: prompt -> CLI args for interactive execution
+  interactive: (prompt) => {
+    return prompt ? ['-i', prompt] : [];
+  },
+
+  // One-time mode: prompt -> CLI args for non-interactive execution
+  oneTime: (prompt) => {
+    return ['-p', prompt];
+  },
+
+  // Auto mode: args for concurrent/routing modes
+  autoMode: () => ['--yolo', '--print'],
+
+  supportsInteractive: true,
+  supportsOneTime: true,
+  defaultMode: 'interactive',
+  verified: false // Set to true after testing
+}
+```
+
+### Phase 3: Help Analyzer (src/core/cli_help_analyzer.js)
+
+#### 3.1 Add to enhancedPatterns
+
+```javascript
+enhancedPatterns: {
+  // ... existing entries
+  '<CLI_NAME>': {
+    commandFormat: '<CLI_COMMAND> -p "{prompt}"',
+    agentDetection: true,
+    skillDetection: true,
+    naturalLanguageSupport: true,
+    positionalArgs: true/false,
+    agentTypes: ['expert', 'skill', 'analysis', 'agent'],
+    skillKeywords: ['技能', '智能体', '分析', '工具', '方法'],
+    examples: [
+      '<CLI_COMMAND> -p "请使用分析技能分析问题"',
+      '<CLI_COMMAND> -p "执行某个任务"'
+    ]
+  }
+}
+```
+
+#### 3.2 Add to skillMapping (for cross-CLI skill translation)
+
+```javascript
+skillMapping: {
+  '<SKILL_NAME>': {
+    // ... existing CLI entries
+    '<CLI_NAME>': '<SKILL_NAME_IN_CLI>'
+  }
+}
+```
+
+### Phase 4: Concurrent Execution (src/cli/commands/concurrent.js)
+
+#### 4.1 Add to availableCLIs array
+
+```javascript
+const availableCLIs = ["claude", "qwen", "gemini", "iflow", "<CLI_NAME>"];
+```
+
+#### 4.2 Add switch case for command arguments
+
+```javascript
+case '<CLI_NAME>':
+  // Determine correct argument format
+  args = ['-p', prompt]; // or positional args
+  break;
+```
+
+### Phase 5: Interactive Mode (src/interactive/InteractiveModeController.js)
+
+#### 5.1 Add to fallback registry in \_scanInstalledCLITools
+
+```javascript
+<CLI_NAME>: { name: '<CLI_NAME>', available: false }
+```
+
+### Phase 6: Hook Deployment (src/core/coordination/nodejs/HookDeploymentManager.js)
+
+#### 6.1 Add to supportedCLIs array
+
+```javascript
+this.supportedCLIs = [
+  // ... existing CLIs
+  "<CLI_NAME>",
+];
+```
+
+### Phase 7: Resume Session (src/core/coordination/nodejs/generators/ResumeSessionGenerator.js)
+
+#### 7.1 Add to supportedCLIs
+
+```javascript
+this.supportedCLIs = [
+  // ... existing CLIs
+  "<CLI_NAME>",
+];
+```
+
+#### 7.2 Add session path configuration
+
+```javascript
+getAllCLISessionPaths = () => ({
+  // ... existing paths
+  <CLI_NAME>: [path.join(homeDir, '.<CLI_NAME>', 'projects')]
+});
+```
+
+#### 7.3 Add CLI registration code case
+
+```javascript
+generateCLIRegistrationCode(cliName) {
+  switch(cliName.toLowerCase()) {
+    // ... existing cases
+    case '<CLI_NAME>':
+      // Add CLI-specific registration logic
+      break;
+  }
+}
+```
+
+### Phase 8: Skills Sync (src/core/skills/StigmergySkillManager.js)
+
+#### 8.1 Add CLI skill directory
+
+```javascript
+const cliSkillDirs = [
+  // ... existing dirs
+  {
+    name: "<CLI Display Name>",
+    path: path.join(os.homedir(), ".<CLI_NAME>", "skills"),
+  },
+];
+```
+
+### Phase 9: Adapter Installation Script
+
+#### 9.1 Create `src/adapters/<CLI_NAME>/install_<CLI_NAME>_integration.js`
+
+```javascript
+const fs = require('fs').promises;
+const path = require('path');
+const os = require('os');
+
+class <CLI_NAME>Installer {
+  constructor() {
+    this.toolName = '<CLI_NAME>';
+    this.configDir = path.join(os.homedir(), '.<CLI_NAME>');
+    this.configFile = path.join(this.configDir, 'config.json');
+    this.hooksFile = path.join(this.configDir, 'hooks.json');
+  }
+
+  async install() {
+    // Create config directory
+    await fs.mkdir(this.configDir, { recursive: true });
+
+    // Install configuration
+    await this.installConfig();
+
+    // Install hooks
+    await this.installHooks();
+
+    // Create documentation
+    await this.createCrossCliDocumentation();
+  }
+
+  async installConfig() {
+    // Create cross-CLI configuration
+    const config = {
+      cross_cli_enabled: true,
+      supported_clis: ['claude', 'gemini', 'qwen', 'iflow', 'qodercli', 'codebuddy', 'copilot', 'codex', '<CLI_NAME>'],
+      stigmergy_integration: true
+    };
+    await fs.writeFile(this.configFile, JSON.stringify(config, null, 2));
+  }
+
+  async installHooks() {
+    const hooks = {
+      cross_cli_adapter: {
+        enabled: true,
+        supported_tools: ['claude', 'gemini', 'qwen', 'iflow', 'qodercli', 'codebuddy', 'copilot', 'codex', '<CLI_NAME>']
+      }
+    };
+    await fs.writeFile(this.hooksFile, JSON.stringify(hooks, null, 2));
+  }
+
+  async createCrossCliDocumentation() {
+    const docPath = path.join(this.configDir, 'CROSS_CLI_GUIDE.md');
+    const content = `# <CLI_NAME> CLI Cross-CLI Communication Guide
+
+Cross-CLI communication: <<<Execute: stigmergy distcli "Prompt">>>
+
+Available tools: claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex, <CLI_NAME>
+`;
+    await fs.writeFile(docPath, content);
+  }
+}
+
+module.exports = <CLI_NAME>Installer;
+```
+
+### Phase 10: Update Documentation
+
+#### 10.1 Update AGENTS.md
+
+- Add CLI to `stigmergy install <tool>` command documentation
+- Update any relevant sections
+
+## Verification Steps
+
+After integration, verify:
+
+### 1. Path Detection
+
+```bash
+node -e "
+const detector = require('./src/core/cli_path_detector');
+detector.detectCLIPath('<CLI_NAME>').then(console.log);
+"
+```
+
+### 2. CLI Adapter
+
+```bash
+node -e "
+const { CLI_ADAPTERS } = require('./src/core/cli_adapters');
+console.log(CLI_ADAPTERS['<CLI_NAME>']);
+"
+```
+
+### 3. Concurrent Execution
+
+```bash
+stigmergy concurrent --concurrency 1 "test prompt"
+```
+
+### 4. Interactive Mode
+
+```bash
+stigmergy interactive
+# Then type: use <CLI_NAME>
+```
+
+### 5. Skill Sync
+
+```bash
+stigmergy skill install <SOME_SKILL>
+# Verify skill appears in ~.<CLI_NAME>/skills/
+```
+
+### 6. Resume Session
+
+```bash
+stigmergy resume --cli <CLI_NAME>
+```
+
+## Rollback Plan
+
+If integration causes issues:
+
+1. Remove from `cli_tools.js`: Comment out or set `autoInstall: false`
+2. Remove from `cli_path_detector.js`: Remove from `cliNameMap`
+3. Remove adapter: Comment out in `cli_adapters.js`
+4. Remove help patterns: Comment out in `cli_help_analyzer.js`
+5. Re-run: `stigmergy deploy`
+
+## Common Issues
+
+### CLI Not Detected
+
+- Check npm global path: `npm config get prefix`
+- Verify command exists: `which <CLI_COMMAND>` or `where <CLI_COMMAND>`
+- Check PATH includes npm global bin directory
+
+### Hook Deployment Fails
+
+- Ensure CLI config directory exists: `~/.CLI_NAME/`
+- Check file permissions
+- Verify JSON format is valid
+
+### Skills Not Syncing
+
+- Check CLI skills directory exists
+- Verify write permissions
+- Check skill format compatibility
+
+## Related Files
+
+- `src/core/cli_tools.js` - CLI configuration
+- `src/core/cli_path_detector.js` - Path detection
+- `src/core/cli_adapters.js` - Execution adapters
+- `src/core/cli_help_analyzer.js` - Help pattern analysis
+- `src/cli/commands/concurrent.js` - Concurrent execution
+- `src/interactive/InteractiveModeController.js` - Interactive mode
+- `src/core/coordination/nodejs/HookDeploymentManager.js` - Hook deployment
+- `src/core/coordination/nodejs/generators/ResumeSessionGenerator.js` - Resume session
+- `src/core/skills/StigmergySkillManager.js` - Skills sync
+- `src/adapters/<CLI_NAME>/install_<CLI_NAME>_integration.js` - Installation script