stigmergy 1.0.89 → 1.0.93

package/README.md

@@ -1,190 +1,203 @@
-# Stigmergy CLI - Multi-Agents Cross-AI CLI Tool Collaboration System
-
-> **Important: This is not a standalone CLI tool, but an enhancement system!**
->
-> Stigmergy CLI enables existing AI CLI tools to collaborate with each other through a plugin system, rather than replacing them.
-
-[![Node.js](https://img.shields.io/badge/node-16+-green.svg)](https://nodejs.org)
-[![NPM](https://img.shields.io/badge/npm-stigmergy-blue.svg)](https://www.npmjs.com/package/stigmergy)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]()
-
-## Quick Start
-
-### One-Click Deployment (Recommended)
-
-```bash
-# Install Stigmergy CLI globally
-npm install -g stigmergy
-
-# Run interactive setup
-stigmergy
-```
-
-This command will:
-- Scan your system for available AI CLI tools
-- Install missing tools with your permission
-- Configure automatic cross-tool collaboration
-- Set up hook integrations for seamless communication
-
-### Manual Installation
-
-```bash
-npm install -g stigmergy
-stigmergy --help
-```
-
-## Supported AI CLI Tools
-
-Stigmergy CLI enhances the following AI CLI tools:
-
-- **Claude CLI** - Anthropic's Claude assistant
-- **Gemini CLI** - Google's Gemini AI
-- **Qwen CLI** - Alibaba's Qwen model
-- **iFlow CLI** - Intelligent workflow automation
-- **Qoder CLI** - AI-powered code generation
-- **CodeBuddy CLI** - Programming assistant
-- **GitHub Copilot CLI** - Microsoft's Copilot
-- **OpenAI Codex CLI** - OpenAI's code completion
-
-## Usage
-
-### Basic Commands
-
-```bash
-# Show help
-stigmergy --help
-
-# Check version
-stigmergy --version
-
-# Scan for available AI CLI tools
-stigmergy scan
-
-# Check system status
-stigmergy status
-
-# Interactive installation mode
-stigmergy install
-
-# Deploy hooks to all tools
-stigmergy deploy
-
-# Complete setup (scan + install + deploy)
-stigmergy setup
-```
-
-### Cross-CLI Collaboration
-
-Once installed, you can use AI CLI tools to collaborate with each other:
-
-```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"
-
-# Use Copilot for code suggestions
-stigmergy call copilot "suggest improvements"
-```
-
-### Installation Workflow
-
-1. **Scan**: `stigmergy scan` - Detects installed AI CLI tools
-2. **Install**: `stigmergy install` - Interactive tool installation
-3. **Deploy**: `stigmergy deploy` - Sets up cross-tool communication
-4. **Use**: `stigmergy call <tool> <prompt>` - Start collaborating
-
-## Configuration
-
-### Global Configuration
-
-Configuration is stored in `~/.stigmergy/config.json`:
-
-```json
-{
-  "version": "1.0.76",
-  "installed": "2025-12-07T00:00:00.000Z",
-  "projectPath": "/path/to/project",
-  "availableTools": ["claude", "gemini", "qwen"],
-  "collaboration": {
-    "enabled": true,
-    "protocols": [
-      "Use {cli} to {task}",
-      "Call {cli} to {task}",
-      "Ask {cli} for {task}"
-    ]
-  }
-}
-```
-
-### Project Configuration
-
-Each project gets a `STIGMERGY.md` file with tool-specific usage instructions.
-
-## Features
-
-- **Automated Detection**: Scans for installed AI CLI tools
-- **Interactive Installation**: One-click installation of missing tools
-- **Cross-Tool Communication**: Enables AI CLI tools to work together
-- **Hook Integration**: Deploys integration hooks to each tool
-- **International Support**: Pure ANSI character output for global compatibility
-- **Auto-Setup**: Configures everything automatically on npm install
-
-## Development
-
-### Project Structure
-
-```
-stigmergy-CLI-Multi-Agents/
-├── src/
-│   ├── main.js          # Main CLI logic
-│   └── index.js         # Entry point
-├── package.json         # NPM configuration
-└── README.md           # This file
-```
-
-### Building from Source
-
-```bash
-# Clone the repository
-git clone https://github.com/ptreezh/stigmergy-CLI-Multi-Agents.git
-cd stigmergy-CLI-Multi-Agents
-
-# Install dependencies
-npm install
-
-# Install globally for testing
-npm install -g .
-```
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Test thoroughly
-5. Submit a pull request
-
-## License
-
-MIT License - see [LICENSE](LICENSE) file for details.
-
-## Support
-
-- **Documentation**: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents
-- **Issues**: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents/issues
-- **NPM**: https://www.npmjs.com/package/stigmergy
-
-## Changelog
-
-### Version 1.0.76
-- Unified international version with pure ANSI characters
-- Single source of truth for all CLI logic
-- Automated installation and deployment system
-- Enhanced error handling and validation
+# Stigmergy CLI - Multi-Agents Cross-AI CLI Tool Collaboration System
+
+> **Important: This is not a standalone CLI tool, but an enhancement system!**
+>
+> Stigmergy CLI enables existing AI CLI tools to collaborate with each other through a plugin system, rather than replacing them.
+
+[![Node.js](https://img.shields.io/badge/node-16+-green.svg)](https://nodejs.org)
+[![NPM](https://img.shields.io/badge/npm-stigmergy-blue.svg)](https://www.npmjs.com/package/stigmergy)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]()
+
+## Quick Start
+
+### One-Click Deployment (Recommended)
+
+```bash
+# Install Stigmergy CLI globally
+npm install -g stigmergy
+
+# Run interactive setup
+stigmergy
+```
+
+This command will:
+- Scan your system for available AI CLI tools
+- Install missing tools with your permission
+- Configure automatic cross-tool collaboration
+- Set up hook integrations for seamless communication
+
+### Manual Installation
+
+```bash
+npm install -g stigmergy
+stigmergy --help
+```
+
+## Supported AI CLI Tools
+
+Stigmergy CLI enhances the following AI CLI tools:
+
+- **Claude CLI** - Anthropic's Claude assistant
+- **Gemini CLI** - Google's Gemini AI
+- **Qwen CLI** - Alibaba's Qwen model
+- **iFlow CLI** - Intelligent workflow automation
+- **Qoder CLI** - AI-powered code generation
+- **CodeBuddy CLI** - Programming assistant
+- **GitHub Copilot CLI** - Microsoft's Copilot
+- **OpenAI Codex CLI** - OpenAI's code completion
+
+## Usage
+
+### Basic Commands
+
+```bash
+# Show help
+stigmergy --help
+
+# Check version
+stigmergy --version
+
+# Scan for available AI CLI tools
+stigmergy scan
+
+# Check system status
+stigmergy status
+
+# Interactive installation mode
+stigmergy install
+
+# Deploy hooks to all tools
+stigmergy deploy
+
+# Remove all Stigmergy hooks from tools
+stigmergy remove
+
+# Complete setup (scan + install + deploy)
+stigmergy setup
+```
+
+### Cross-CLI Collaboration
+
+Once installed, you can use AI CLI tools to collaborate with each other:
+
+```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"
+
+# Use Copilot for code suggestions
+stigmergy call copilot "suggest improvements"
+```
+
+### Installation Workflow
+
+1. **Scan**: `stigmergy scan` - Detects installed AI CLI tools
+2. **Install**: `stigmergy install` - Interactive tool installation
+3. **Deploy**: `stigmergy deploy` - Sets up cross-tool communication
+4. **Use**: `stigmergy call <tool> <prompt>` - Start collaborating
+
+## Safety and Conflict Prevention
+
+Stigmergy includes a comprehensive conflict prevention system to ensure it doesn't interfere with other CLI tools:
+
+- **Pre-installation checks** to prevent conflicts
+- **Runtime monitoring** for system integrity
+- **Automatic conflict resolution** tools
+- **Emergency recovery** procedures
+
+If you experience issues with other CLI tools:
+```bash
+npm run fix-node-conflict
+```
+
+For more information, see [Conflict Prevention System](docs/CONFLICT_PREVENTION.md).
+
+```json
+{
+  "version": "1.0.76",
+  "installed": "2025-12-07T00:00:00.000Z",
+  "projectPath": "/path/to/project",
+  "availableTools": ["claude", "gemini", "qwen"],
+  "collaboration": {
+    "enabled": true,
+    "protocols": [
+      "Use {cli} to {task}",
+      "Call {cli} to {task}",
+      "Ask {cli} for {task}"
+    ]
+  }
+}
+```
+
+### Project Configuration
+
+Each project gets a `STIGMERGY.md` file with tool-specific usage instructions.
+
+## Features
+
+- **Automated Detection**: Scans for installed AI CLI tools
+- **Interactive Installation**: One-click installation of missing tools
+- **Cross-Tool Communication**: Enables AI CLI tools to work together
+- **Hook Integration**: Deploys integration hooks to each tool
+- **International Support**: Pure ANSI character output for global compatibility
+- **Auto-Setup**: Configures everything automatically on npm install
+
+## Development
+
+### Project Structure
+
+```
+stigmergy-CLI-Multi-Agents/
+├── src/
+│   ├── main.js          # Main CLI logic
+│   └── index.js         # Entry point
+├── package.json         # NPM configuration
+└── README.md           # This file
+```
+
+### Building from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/ptreezh/stigmergy-CLI-Multi-Agents.git
+cd stigmergy-CLI-Multi-Agents
+
+# Install dependencies
+npm install
+
+# Install globally for testing
+npm install -g .
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Test thoroughly
+5. Submit a pull request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Support
+
+- **Documentation**: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents
+- **Issues**: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents/issues
+- **NPM**: https://www.npmjs.com/package/stigmergy
+
+## Changelog
+
+### Version 1.0.76
+- Unified international version with pure ANSI characters
+- Single source of truth for all CLI logic
+- Automated installation and deployment system
+- Enhanced error handling and validation
 - Removed all redundant scripts and configurations

package/bin/stigmergy

@@ -0,0 +1,12 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+exec node "$basedir/../src/main_english.js" "$@"

package/bin/stigmergy.cmd

@@ -0,0 +1,5 @@
+@ECHO OFF
+SETLOCAL
+SET "NODE_PATH=%~dp0\node_modules;%NODE_PATH%"
+SET "PATH=%~dp0;%PATH%"
+node "%~dp0..\src\main_english.js" %*

package/docs/CONFLICT_PREVENTION.md

@@ -0,0 +1,150 @@
+# Stigmergy CLI Conflict Prevention System
+
+This document describes the comprehensive system implemented to prevent conflicts with other CLI tools.
+
+## Problem Statement
+
+Stigmergy previously caused conflicts with other CLI tools by:
+1. Installing conflicting npm packages (like the "node" package)
+2. Creating broken executable files that interfered with normal CLI operation
+3. Modifying system PATH inappropriately
+
+## Solution Overview
+
+We have implemented a multi-layered protection system:
+
+### 1. Pre-installation Safety Checks
+
+**File**: `scripts/preinstall-check.js`
+**Purpose**: Prevent installation when conflicts are detected
+
+Checks performed:
+- Node.js version compatibility
+- npm availability and version
+- Existing conflicting "node" package installations
+- Previous Stigmergy installations
+
+### 2. Safe Installation Process
+
+**File**: `scripts/safe-install.js`
+**Purpose**: Ensure safe installation without side effects
+
+Features:
+- Backup of potentially conflicting files
+- Monitoring during installation
+- Automatic rollback on failure
+- Conflict detection during installation
+
+### 3. Runtime Safety Monitoring
+
+**File**: `src/main_english.js` (safetyCheck method)
+**Purpose**: Detect conflicts during normal operation
+
+Monitors:
+- Conflicting npm packages
+- Broken executable files
+- System integrity
+
+### 4. Conflict Resolution Tools
+
+**Files**: 
+- `fix-node-conflict.js` - Basic conflict fixer
+- `fix-node-conflict-enhanced.js` - Advanced conflict prevention
+
+Capabilities:
+- Detect and remove conflicting packages
+- Repair broken executables
+- Verify CLI tool functionality
+- Apply preventive measures
+
+### 5. Emergency Recovery
+
+**Files**:
+- `emergency-cleanup.js` - Complete system cleanup
+- `cleanup.js` - Standard cleanup
+- `diagnostic.js` - System diagnostics
+- `path-fixer.js` - PATH environment repair
+
+## Usage Instructions
+
+### For Users
+
+1. **Regular Maintenance**:
+   ```bash
+   npm run fix-node-conflict
+   ```
+
+2. **System Diagnostics**:
+   ```bash
+   npm run diagnostic
+   ```
+
+3. **Emergency Cleanup**:
+   ```bash
+   npm run emergency-clean
+   ```
+
+### For Developers
+
+1. **Add safety checks to new features**:
+   ```javascript
+   await this.safetyCheck(); // Call before critical operations
+   ```
+
+2. **Update dependency list carefully**:
+   - Avoid dependencies named "node" or similar to system executables
+   - Use exact versions instead of ranges when possible
+   - Regularly audit dependencies with `npm audit`
+
+3. **Test installation in clean environments**:
+   - Use Docker containers or VMs for testing
+   - Verify no conflicts with popular CLI tools
+   - Test on multiple operating systems
+
+## Best Practices
+
+### Dependency Management
+- Pin critical dependencies to specific versions
+- Avoid dependencies that might conflict with system tools
+- Regular security audits
+- Monitor for deprecated dependencies
+
+### Installation Process
+- Never modify system PATH directly
+- Use npm's standard installation mechanisms
+- Provide clear uninstallation procedures
+- Test installation/uninstallation cycles
+
+### Conflict Prevention
+- Unique naming for executables and packages
+- Comprehensive pre-flight checks
+- Graceful degradation when conflicts detected
+- Clear error messages with resolution steps
+
+## Future Improvements
+
+1. **Automated Testing**:
+   - Integration tests with popular CLI tools
+   - Cross-platform compatibility verification
+   - Regression testing for known conflicts
+
+2. **Enhanced Monitoring**:
+   - Real-time conflict detection
+   - Proactive notifications
+   - Automated recovery
+
+3. **Improved Documentation**:
+   - Detailed troubleshooting guides
+   - Platform-specific instructions
+   - Community contribution guidelines
+
+## Reporting Issues
+
+If you encounter conflicts:
+1. Run `npm run diagnostic`
+2. Save the output
+3. Report to the Stigmergy team with:
+   - Operating system and version
+   - Node.js and npm versions
+   - List of installed CLI tools
+   - Diagnostic output

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "stigmergy",
-  "version": "1.0.89",
-  "type": "commonjs",
+  "version": "1.0.93",
   "description": "Stigmergy CLI - Multi-Agents Cross-AI CLI Tools Collaboration System",
   "main": "src/main_english.js",
   "bin": {
-    "stigmergy": "src/main_english.js"
+    "stigmergy": "bin/stigmergy"
   },
   "scripts": {
     "start": "node src/main_english.js",
@@ -17,11 +16,18 @@
     "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",
-    "clean": "node src/index.js clean",
     "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",
+    "post-deployment-config": "node scripts/post-deployment-config.js",
+    "preinstall": "node scripts/preinstall-check.js",
     "postinstall": "echo \"[INFO] Stigmergy CLI is setting up...\" && node src/main_english.js auto-install && echo \"[INFO] Setup completed. Run 'stigmergy --help' to see available commands.\""
   },
   "keywords": [
@@ -55,7 +61,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/ptreezh/stigmergy-CLI-Multi-Agents.git"
+    "url": "git+https://github.com/ptreezh/stigmergy-CLI-Multi-Agents.git"
   },
   "author": "Stigmergy CLI Team",
   "license": "MIT",
@@ -101,4 +107,4 @@
   "bugs": {
     "url": "https://github.com/ptreezh/stigmergy-CLI-Multi-Agents/issues"
   }
-}
+}