stigmergy 1.1.5 → 1.2.0

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.5",
+  "version": "1.2.0",
   "description": "Stigmergy CLI - Multi-Agents Cross-AI CLI Tools Collaboration System",
   "main": "src/index.js",
   "bin": {
@@ -12,28 +12,20 @@
     "test:unit": "jest tests/unit",
     "test:integration": "jest tests/integration",
     "test:e2e": "jest tests/e2e",
-    "test:rest-client": "node test/rest_client.test.js",
-    "test:nodejs-coordination": "jest tests/unit/nodejs-coordination-layer.test.js",
-    "test:nodejs-hooks": "jest tests/unit/nodejs-hook-deployment.test.js",
-    "test:nodejs-integration": "jest tests/unit/nodejs-cli-integration.test.js",
-    "example:rest-client": "node examples/rest_client_example.js",
     "coverage": "jest --coverage",
-    "test:watch": "jest --watch",
     "build": "node scripts/build.js",
     "deploy": "node src/index.js deploy",
     "status": "node src/index.js status",
     "scan": "node src/index.js scan",
     "init": "node src/index.js init",
-    "clean": "node cleanup.js",
     "validate": "node src/index.js validate",
     "dev": "node --watch src/index.js",
     "lint": "eslint src/",
     "format": "prettier --write src/",
-    "fix-node-conflict": "node fix-node-conflict.js",
-    "diagnostic": "node diagnostic.js",
-    "path-fixer": "node path-fixer.js",
-    "emergency-clean": "node emergency-cleanup.js",
-    "test:conflict-prevention": "node test/conflict-prevention-test.js",
+    "clean": "node src/index.js clean",
+    "diagnostic": "node src/index.js diagnostic",
+    "uninstall": "node -e \"const EU=require('./src/core/enhanced_uninstaller'); new EU({dryRun:true,verbose:true}).completeUninstall()\"",
+    "uninstall-force": "node -e \"const EU=require('./src/core/enhanced_uninstaller'); new EU({force:true,verbose:true}).completeUninstall()\"",
     "post-deployment-config": "node scripts/post-deployment-config.js",
     "preinstall": "node scripts/preinstall-check.js",
     "postinstall": "node src/index.js auto-install"
@@ -78,27 +70,22 @@
   },
   "dependencies": {
     "chalk": "^4.1.2",
-    "child_process": "^1.0.2",
     "chokidar": "^3.5.3",
-    "commander": "^12.0.0",
-    "events": "^3.3.0",
+    "commander": "^9.5.0",
     "figures": "^3.2.0",
-    "fs-extra": "^11.1.1",
-    "glob": "^10.3.10",
+    "fs-extra": "^11.2.0",
+    "glob": "^8.1.0",
     "inquirer": "^8.2.6",
     "js-yaml": "^4.1.0",
     "ora": "^5.4.1",
-    "os": "^0.1.2",
-    "path": "^0.12.7",
-    "semver": "^7.5.4",
-    "table": "^6.8.1",
-    "util": "^0.12.5"
+    "semver": "^7.6.3",
+    "table": "^6.8.2"
   },
   "devDependencies": {
-    "eslint": "^8.50.0",
-    "jest": "^30.2.0",
-    "nodemon": "^3.0.1",
-    "prettier": "^3.0.3"
+    "eslint": "^8.57.1",
+    "jest": "^29.7.0",
+    "nodemon": "^3.1.7",
+    "prettier": "^3.3.3"
   },
   "config": {
     "encoding": "ansi",

package/scripts/preinstall-check.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 
 /**
- * Stigmergy Pre-installation Safety Check
- * This script prevents installation conflicts by checking for potential issues
+ * Enhanced Stigmergy Pre-installation Check
+ * This script prevents installation conflicts and cleans historical caches
  */
 
 const fs = require('fs');
 const path = require('path');
 const { spawnSync } = require('child_process');
 
-console.log('[PRE-INSTALL] Running safety checks...');
+console.log('[PRE-INSTALL] Running enhanced installation preparation...');
 
 // Check 1: Verify no conflicting "node" package is already installed
 function checkConflictingNodePackage() {
@@ -96,16 +96,78 @@ function checkExistingInstallation() {
     console.log('[OK] No conflicting Stigmergy installation found.');
 }
 
-// Run all checks
-try {
-    checkSystemNode();
-    checkNpm();
-    checkConflictingNodePackage();
-    checkExistingInstallation();
-    
-    console.log('[SUCCESS] All safety checks passed. Proceeding with installation.');
-    process.exit(0);
-} catch (error) {
-    console.error('[FATAL] Safety check failed:', error.message);
-    process.exit(1);
-}
+// Check 5: Clean historical caches (NEW FUNCTION)
+function cleanHistoricalCaches() {
+    console.log('[CLEAN] Cleaning historical caches to prevent conflicts...');
+
+    try {
+        // Import and use our enhanced cache cleaner
+        const CacheCleaner = require('../src/core/cache_cleaner');
+        const cleaner = new CacheCleaner({
+            dryRun: false,
+            force: true,
+            verbose: false,
+            preserveRecent: 60 * 60 * 1000 // Preserve files from last hour
+        });
+
+        // Clean only safe items before installation
+        cleaner.cleanAllCaches({
+            cleanStigmergy: false,  // Don't clean main config during install
+            cleanNPX: true,          // Clean NPX cache (safe)
+            cleanNPM: false,         // Don't clean NPM cache during install
+            cleanCLI: false,         // Don't clean CLI configs during install
+            cleanTemp: true          // Clean temporary files (safe)
+        }).then(results => {
+            if (results.filesRemoved > 0) {
+                console.log(`[CLEAN] Removed ${results.filesRemoved} cache files`);
+                console.log(`[CLEAN] Freed ${formatBytes(results.bytesFreed)} space`);
+            } else {
+                console.log('[CLEAN] No cache files needed cleaning');
+            }
+        }).catch(error => {
+            console.log(`[WARN] Cache cleaning failed: ${error.message}`);
+            console.log('[INFO] Continuing with installation...');
+        });
+
+    } catch (error) {
+        console.log(`[WARN] Could not initialize cache cleaner: ${error.message}`);
+        console.log('[INFO] Continuing with installation...');
+    }
+}
+
+// Helper function to format bytes
+function formatBytes(bytes) {
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    if (bytes === 0) return '0 Bytes';
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    return Math.round(bytes / Math.pow(1024, i) * 100) / 100 + ' ' + sizes[i];
+}
+
+// Run all checks and preparation
+async function runInstallationPreparation() {
+    try {
+        // System requirements first
+        checkSystemNode();
+        checkNpm();
+        checkConflictingNodePackage();
+        checkExistingInstallation();
+
+        // Clean caches (async, but don't wait for completion to avoid blocking npm install)
+        cleanHistoricalCaches();
+
+        console.log('[SUCCESS] Enhanced installation preparation completed.');
+        console.log('[INFO] Proceeding with package installation...');
+
+        // Give cache cleaning a moment to start
+        setTimeout(() => {
+            process.exit(0);
+        }, 1000);
+
+    } catch (error) {
+        console.error('[FATAL] Installation preparation failed:', error.message);
+        process.exit(1);
+    }
+}
+
+// Run the enhanced preparation
+runInstallationPreparation();