stigmergy 1.0.73 → 1.0.79

package/README.md

@@ -1,469 +1,190 @@
-# 🔧 Stigmergy CLI - Multi-Agents Cross-AI CLI Tool Collaboration System
-
-> **⚠️ Important Clarification: 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
-# One-click deployment of the complete collaboration system (detection + installation + configuration)
-npx -y git+https://github.com/ptreezh/stigmergy-CLI-Multi-Agents.git#main quick-deploy
-```
-
-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
-
-**How It Works:** After deployment, each AI CLI tool gets a hook adapter that enables natural language cross-tool collaboration. Simply say "use [tool] to [task]" in any supported CLI.
-
-### Manual Installation
-
-```bash
-# Install globally via NPM
-npm install -g stigmergy
-
-# Initialize project
-stigmergy init
-
-# Intelligent deployment (scan environment + prompt + auto-install)
-stigmergy deploy
-
-# Or use npx (no installation required)
-npx stigmergy init
-npx stigmergy deploy
-```
-
-## ✨ Core Features
-
-### Direct Cross-CLI Collaboration
-- **Natural Language Invocation**: Simply say "use gemini to translate" in any supported CLI
-- **Hook-Based Integration**: Each AI CLI gets transparent cross-tool capabilities
-- **Smart Intent Detection**: Automatically recognizes collaboration requests and routes them appropriately
-- **No Special Commands**: Collaboration happens naturally within normal CLI usage
-
-### Enhanced CLI Help Information Parsing
-- **Real-time Extraction**: Dynamically parses actual CLI `--help` output to get latest command specifications
-- **Smart Options Detection**: Automatically identifies global options, subcommands, and parameters
-- **Graceful Fallback**: Falls back to preset templates when real-time parsing fails
-- **Persistent Updates**: Stores parsed results for future use, continuously improving accuracy
-
-### Supported CLI Tools
-
-#### Core Tools (Required)
-- **Claude CLI** - Anthropic Claude CLI Tool
-- **Gemini CLI** - Google Gemini CLI Tool
-
-#### Extension Tools (Optional)
-- **QwenCode CLI** - Alibaba Cloud QwenCode CLI Tool
-- **iFlow CLI** - iFlow Workflow CLI Tool
-- **Qoder CLI** - Qoder Code Generation CLI Tool
-- **CodeBuddy CLI** - CodeBuddy Programming Assistant CLI Tool
-- **GitHub Copilot CLI** - GitHub Copilot CLI Tool
-- **Codex CLI** - OpenAI Codex Code Analysis CLI Tool
-- **Cline CLI** - Cline AI Assistant CLI Tool - Supports task lifecycle hooks and multi-agent orchestration
-
-### Intelligent Deployment System
-
-```bash
-# Intelligent deployment (recommended)
-stigmergy deploy
-
-# Sample output:
-🔍 Scanning system CLI tool status...
-
-  🔴 ❌ Claude CLI           | CLI: Not installed | Integration: Not installed
-  🟢 ✅ Gemini CLI          | CLI: Available | Integration: Installed
-  🔴 ❌ QwenCode CLI       | CLI: Not installed | Integration: Not installed
-
-📋 Detected the following tools not installed:
-
-🔴 CLI Tools Not Installed:
-  - Claude CLI (Required) - Anthropic Claude CLI Tool
-  - QwenCode CLI (Optional) - Alibaba Cloud QwenCode CLI Tool
-
-Would you like to try automatically installing 2 CLI tools? (Y/n): Y
-```
-
-## 🎯 Cross-CLI Collaboration Examples
-
-After installation, you can directly call other tools within any supported CLI:
-
-### In Claude CLI
-```bash
-# Cross-AI tool collaboration (natural language)
-Please use gemini to translate this code to Python
-Call qwen to analyze this requirement
-Use iflow to create a development workflow
-Ask qoder to generate Python code
-Have codebuddy assist with debugging
-```
-
-### In Gemini CLI
-```bash
-# Natural language cross-CLI collaboration
-Use claude to review this code for security issues
-Call qwen for Chinese localization
-Let copilot suggest performance improvements
-Ask codex for architectural analysis
-```
-
-### In QwenCode CLI
-```bash
-# Multi-tool orchestration with natural language
-Let claude check for security vulnerabilities
-Use gemini to optimize this algorithm
-Call iflow to automate the deployment process
-Ask copilot to improve code completion
-```
-
-## 🔧 Advanced Features
-
-### Real-time CLI Help Parsing
-The system now includes advanced real-time CLI help parsing capabilities:
-
-```python
-# Example of real-time help parsing
-specs = _parse_cli_help(cli_name)
-# Automatically extracts:
-# - Global options (--help, --version, --verbose, etc.)
-# - Subcommands (chat, file, config, auth, etc.)
-# - Parameters (input, output, model, temperature, etc.)
-# - Usage patterns and examples
-```
-
-### Persistent Storage Mechanism
-- **Dynamic Templates**: Updated CLI command specifications are stored persistently
-- **Continuous Improvement**: Each successful parse improves future accuracy
-- **Fallback Support**: Preset templates ensure functionality even when real-time parsing fails
-
-### Internationalization
-- **Global Design**: Fully English-based interface for international users
-- **Multi-language Support**: Ready for expansion to multiple languages
-- **Cross-platform Compatibility**: Works seamlessly across Windows, Linux, and macOS
-
-## 📊 Global Memory Documents
-
-The system generates comprehensive memory documents for each CLI tool:
-
-### JSON Format
-```json
-{
-  "cli_name": "claude",
-  "display_name": "Claude CLI",
-  "command": "claude",
-  "description": "Anthropic Claude CLI Tool",
-  "version_info": "...",
-  "command_specs": {
-    "global_options": {
-      "--help": "Show help information",
-      "--version": "Show version information",
-      "--verbose": "Detailed output"
-    },
-    "subcommands": {
-      "chat": "Chat mode",
-      "file": "File processing mode",
-      "config": "Configuration management"
-    },
-    "parameters": {
-      "input": "Input file or prompt",
-      "output": "Output file path",
-      "model": "Model selection",
-      "temperature": "Creativity parameter (0.0-1.0)",
-      "max_tokens": "Maximum tokens",
-      "timeout": "Timeout (seconds)"
-    }
-  }
-}
-```
-
-### Markdown Documentation
-- **Comprehensive Guides**: Detailed documentation for each CLI tool
-- **Usage Examples**: Practical examples for common use cases
-- **Integration Patterns**: Best practices for cross-CLI collaboration
-- **Command Reference**: Complete command specifications and parameters
-
-## 🛠️ Local Generation and Management
-
-### Generate Global Memory Documents
-```bash
-# Generate comprehensive memory documents for all tools
-python generate_global_memory.py
-
-# Creates:
-# - global_memory/claude_global_memory.json
-# - global_memory/claude_global_memory.md
-# - global_memory/gemini_global_memory.json
-# - global_memory/gemini_global_memory.md
-# ... and more for all supported CLIs
-```
-
-### Advanced Command Specification Generation
-The enhanced `generate_global_memory.py` script now includes:
-
-1. **Real-time CLI Parsing**: Directly calls `--help` commands to extract accurate specifications
-2. **Smart Pattern Recognition**: Uses regex and intelligent parsing to extract options, subcommands, and parameters
-3. **Fallback Templates**: Provides comprehensive default templates when live parsing isn't available
-4. **Dynamic Updates**: Continuously improves templates based on real-world CLI behavior
-5. **Persistent Storage**: Saves parsed specifications for improved future accuracy
-
-## 🌐 Cross-Platform Support
-
-### Windows
-```bash
-# Windows deployment
-npx stigmergy-cli deploy
-```
-
-### Linux/macOS
-```bash
-# Unix-like systems
-npx stigmergy-cli deploy
-```
-
-## 📄 Global Memory Documentation
-
-### CLI Command Specifications
-Each CLI tool gets detailed command specifications including:
-- **Global Options**: Common flags like `--help`, `--version`, `--verbose`
-- **Subcommands**: Specific modes like `chat`, `file`, `config`, `auth`
-- **Parameters**: Detailed parameter definitions with descriptions
-- **Usage Examples**: Practical usage patterns and best practices
-
-### Collaboration Patterns
-- **Automatic Recognition**: Detects cross-CLI collaboration patterns
-- **Template Matching**: Matches natural language patterns to CLI commands
-- **Intelligent Routing**: Routes requests to the most appropriate CLI tool
-
-## Complete Command List
-
-```bash
-# Basic commands
-stigmergy init              # Initialize project in current directory
-stigmergy status            # Check system and adapter status
-stigmergy scan              # Scan environment for available AI CLI tools
-
-# Project management
-stigmergy check-project     # Check project configuration
-stigmergy validate [scope]  # Validate configuration (project/global)
-stigmergy clean [options]   # Clean cache and temporary files
-
-# Testing/debugging
-stigmergy call <cli> [args] # Direct CLI tool invocation (for testing)
-
-# Development commands
-npm run build               # Build project
-npm run publish-to-npm      # Publish to NPM
-npm run test                # Run tests
-```
-
-## Project Structure
-
-```
-stigmergy-CLI-Multi-Agents/
-├── package.json          # NPM Package Configuration
-├── src/
-│   ├── main.js          # Main Entry Point
-│   ├── deploy.js        # Smart Deployment Script
-│   ├── adapters/        # CLI Adapters
-│   │   ├── claude/
-│   │   ├── gemini/
-│   │   ├── qwencode/
-│   │   └── ...
-│   └── core/            # Core Modules
-├── adapters/            # CLI Installation Scripts
-│   ├── claude/install_claude_integration.py
-│   ├── gemini/install_gemini_integration.py
-│   └── ...
-└── templates/           # Configuration Templates
-```
-
-## 🔧 Automated CLI Tool Installation
-
-The smart deployment script supports automatic installation of all CLI tools:
-
-### Core Tools
-```bash
-npm install -g @anthropic-ai/claude-code
-npm install -g @google/gemini-cli
-```
-
-### Extension Tools
-```bash
-npm install -g @qwen-code/qwen-code@latest
-npm install -g @iflow-ai/iflow-cli@latest
-npm install -g @qoder-ai/qodercli
-npm install -g @tencent-ai/codebuddy-code
-npm install -g @github/copilot
-npm i -g @openai/codex --registry=https://registry.npmmirror.com
-```
-
-## 🎯 Use Cases
-
-### Case 1: Personal Developer Environment
-```bash
-# Quick configuration for new development environment
-git clone my-project
-cd my-project
-stigmergy deploy
-
-# Now you can cross-CLI collaboration in any CLI
-claude "Please use gemini to help me optimize this code's performance"
-```
-
-### Case 2: Team Collaboration
-```bash
-# Team shared project configuration
-git clone team-project
-cd team-project
-stigmergy init
-
-# All team members use the same collaboration context
-gemini "Use claude to check the design patterns of this module"
-```
-
-### Case 3: Multi-language Development
-```bash
-# Different AI tools complement each other's strengths
-qwen "Use copilot to generate frontend components"
-iflow "Let gemini create API documentation"
-```
-
-## 🔧 Development Environment Setup
-
-```bash
-# Clone project
-git clone https://github.com/ptreezh/stigmergy-CLI-Multi-Agents.git
-cd stigmergy-CLI-Multi-Agents
-
-# Install dependencies
-npm install
-
-# Development mode execution
-npm run start
-npm run status
-npm run scan
-
-# Build and publish
-npm run build
-npm run publish-to-npm
-```
-
-## 🚀 Publishing New Versions
-
-```bash
-# Update version number
-npm version patch    # Patch version
-npm version minor    # Minor version
-npm version major    # Major version
-
-# Publish to NPM
-npm run publish-to-npm
-
-# Validate publication
-npx stigmergy --version
-```
-
-## 🛠️ Troubleshooting
-
-### Common Issues
-
-1. **Node.js version incompatible**
-   ```bash
-   # Ensure using Node.js 16+
-   node --version
-   ```
-
-2. **Permission errors**
-   ```bash
-   # Use administrator privileges
-   sudo npm install -g stigmergy
-   ```
-
-3. **Network connection issues**
-   ```bash
-   # Set NPM mirror
-   npm config set registry https://registry.npmmirror.com
-   ```
-
-4. **CLI tool installation failure**
-   ```bash
-   # Manually install specific tool
-   npm install -g @anthropic-ai/claude-code
-   ```
-
-### Debug Mode
-
-```bash
-# Verbose debug output
-DEBUG=stigmergy:* stigmergy deploy
-
-# Scan status only
-stigmergy scan
-```
-
-## 📚 More Information
-
-- **GitHub**: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents
-- **NPM**: https://www.npmjs.com/package/stigmergy
-- **Documentation**: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents#readme
-- **Issue Tracking**: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents/issues
-
-## 🚀 Getting Started
-
-### Prerequisites
-- Node.js 16+ (for deployment scripts)
-- Python 3.8+ (for advanced features)
-- Git (for installation)
-
-### Quick Setup
-1. **Install the system**
-   ```bash
-   npm install -g stigmergy
-   ```
-
-2. **Initialize project**
-   ```bash
-   stigmergy init
-   ```
-
-3. **Deploy integrations**
-   ```bash
-   stigmergy deploy
-   ```
-
-4. **Start collaborating**
-   ```bash
-   claude "Please use gemini to help me analyze this code"
-   gemini "Ask claude to review the security aspects"
-   ```
-
-## 🤝 Contributing
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Make your changes
-4. Commit your changes (`git commit -m 'Add amazing feature'`)
-5. Push to the branch (`git push origin feature/amazing-feature`)
-6. Open a Pull Request
-
-## 📄 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## 📞 Support
-
-For support, please open an issue in the GitHub repository or contact the maintainers.
-
----
-
-**🎯 Stigmergy CLI - True Cross-CLI Collaboration, Making Every AI Tool Deliver Maximum Value!**
+# 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
+- Removed all redundant scripts and configurations