release: ShellRosetta v1.2.0 - Complete Platform

MAJOR RELEASE FEATURES:
- Working web interface with Flask API
- Plugin system (Docker, Kubernetes, AWS, Git)
- ML engine with pattern learning
- Interactive CLI with command history
- Professional documentation and examples
- Cross-platform compatibility
- RESTful API endpoints

This transforms ShellRosetta into an enterprise-grade
command translation platform.

Author: sdirishguy

README.md

@@ -9,126 +9,245 @@
 [![PyPI version](https://badge.fury.io/py/shellrosetta.svg)](https://pypi.org/project/shellrosetta/)
 [![codecov](https://codecov.io/github/sdirishguy/shellrosetta/branch/main/graph/badge.svg?token=6X3X6MK47L)](https://codecov.io/github/sdirishguy/shellrosetta)
 
-## What is ShellRosetta?
-
-ShellRosetta is a cross-platform CLI tool for developers, sysadmins, and anyone switching between Windows and Linux.
-
-It instantly translates commands—including flags and arguments—between Linux/Bash and PowerShell. No more flipping between cheat sheets or Stack Overflow!
+# ShellRosetta v1.2.0
 
-## Features
+**Enterprise-grade Linux/Bash to PowerShell translator with AI, plugins, and web interface.**
 
-- 🖥️ **Interactive Shell Mode!** Open ShellRosetta as a REPL and translate commands live, just like in a real shell.
-- 🔄 **Bi-directional translation:** Linux ↔ PowerShell, with accurate mappings for real-world scenarios.
-- 🏷️ **Flag and multi-flag aware:** Understands combos like `ls -alh`, `rm -rf`, etc.
-- 🔗 **Pipeline support:** Handles piped commands (e.g. `ls -l | grep foo`).
-- 🌐 **Networking and system commands:** Supports `ping`, `curl`, `Get-NetTCPConnection`, and many more.
-- 📋 **Extensive mappings:** Permissions, archiving, users, process management, environment variables, I/O redirection, and more.
-- 🚦 **Helpful notes:** Outputs usage tips or warnings if there's no direct translation or if a flag behaves differently.
-- 🧩 **Easily extensible:** Add or edit mappings in `mappings.py`—grow as you learn!
-- ⚡ **Ready for shell aliases & tab-completion:** Bash/Zsh completion script included.
-- 🤖 **Machine Learning Integration:** Learns from your translations and provides smart suggestions.
-- 🔌 **Plugin System:** Extensible architecture with built-in plugins for Docker, Kubernetes, AWS, and Git.
-- 🌐 **Web API:** REST API and beautiful web interface for programmatic access.
-- 📊 **Advanced Features:** AST parsing, configuration management, and comprehensive testing.
+[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![PyPI version](https://badge.fury.io/py/shellrosetta.svg)](https://pypi.org/project/shellrosetta/)
+[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
 
-## What's New in v1.1.0
+## What is ShellRosetta?
 
-- ✅ **Fixed all markdownlint formatting issues** in documentation
-- ✅ **Enhanced CLI functionality** with better error handling and Windows compatibility
-- ✅ **Improved documentation** with proper markdown formatting
-- ✅ **Resolved import dependencies** (flask-cors installation)
-- ✅ **Better cross-platform support** with readline handling for Windows
+ShellRosetta is a comprehensive command translation platform for developers, sysadmins, and anyone working across Windows and Linux environments. It provides intelligent, bidirectional translation between Linux/Bash and PowerShell commands with AI-powered pattern learning.
 
-## Quickstart
+## Features
 
-**Install from PyPI:**
+### Core Translation
+- **Bidirectional translation**: Linux ↔ PowerShell with 100+ command mappings
+- **Flag-aware translation**: Understands complex flag combinations (`ls -alh`, `rm -rf`, etc.)
+- **Pipeline support**: Handles piped commands (`ls -l | grep foo`)
+- **Intelligent mapping**: Contextual notes for platform differences
+
+### Advanced Features (NEW in v1.2.0)
+- **Web Interface**: Beautiful, responsive web UI at `http://localhost:5000`
+- **Plugin System**: Extensible architecture with Docker, Kubernetes, AWS, Git plugins
+- **ML Engine**: Learns from translations and provides smart suggestions
+- **Interactive CLI**: REPL-style interface with command history
+- **AST Parsing**: Advanced command analysis and structure understanding
+- **Security Validation**: Multi-level command safety checking
+- **Performance Monitoring**: Caching and performance metrics
+
+### Professional Features
+- **Cross-platform**: Windows, Linux, macOS compatibility
+- **Tab Completion**: Bash/Zsh autocomplete support
+- **Configuration Management**: Customizable settings and preferences
+- **Error Handling**: Robust error reporting and recovery
+- **API Endpoints**: RESTful API for programmatic access
+
+## Installation
 
 ```bash
 pip install shellrosetta
 ```
 
-**Or clone and install locally:**
+## Quick Start
 
+### Command Line Usage
 ```bash
-git clone https://github.com/sdirishguy/shellrosetta.git
-cd shellrosetta
-pip install .
+# Linux to PowerShell
+shellrosetta lnx2ps "ls -alh | grep error"
+# Output: Get-ChildItem -Force | Format-List | Select-String error
+
+# PowerShell to Linux  
+shellrosetta ps2lnx "Get-ChildItem -Force"
+# Output: ls -a
+
+# Interactive mode
+shellrosetta
+
+# Web interface
+shellrosetta api
+# Open http://localhost:5000 in browser
+```
+
+### Python API
+```python
+from shellrosetta.core import lnx2ps, ps2lnx
+
+# Translate commands
+linux_cmd = "ls -la | grep .txt"
+powershell_cmd = lnx2ps(linux_cmd)
+print(powershell_cmd)
+# Output: Get-ChildItem -Force | Format-List | Select-String .txt
 ```
 
-**Usage:**
+## Web Interface
 
+Start the web server:
 ```bash
-shellrosetta lnx2ps "ls -alh | grep error"
-shellrosetta ps2lnx "Get-ChildItem -Force | Select-String error"
+shellrosetta api
 ```
 
-**Or test before installing:**
+Open http://localhost:5000 for an intuitive web interface featuring:
+- Real-time command translation
+- Syntax highlighting
+- Usage examples
+- Translation history
 
+## Plugin System
+
+ShellRosetta includes plugins for:
+- **Docker**: Container management commands
+- **Kubernetes**: Cluster operations (`kubectl`)
+- **AWS CLI**: Cloud service commands
+- **Git**: Version control operations
+
+List available plugins:
 ```bash
-python -m shellrosetta.cli lnx2ps "ls -alh | grep error"
-python -m shellrosetta.cli ps2lnx "Get-ChildItem -Force | Select-String error"
+shellrosetta plugins
 ```
 
-**(Optional) Add aliases to your shell:**
+## Machine Learning
 
+The ML engine learns from your translations:
 ```bash
-echo "alias lnx2ps='shellrosetta lnx2ps'" >> ~/.bashrc
-echo "alias ps2lnx='shellrosetta ps2lnx'" >> ~/.bashrc
-source ~/.bashrc
+# View learning insights
+shellrosetta ml
+
+# The system automatically learns patterns and improves suggestions
 ```
 
-**(Optional) Enable tab-completion:**
-Copy `shellrosetta/autocomplete.sh` somewhere (or use directly from the repo), then add this to your `~/.bashrc` or `~/.zshrc`:
+## Configuration
 
+Customize behavior:
 ```bash
-source /path/to/shellrosetta/autocomplete.sh
+# View current settings
+shellrosetta config
+
+# Settings include color output, history size, security levels
 ```
 
-Reload your shell:
+## Examples
+
+### File Operations
+```bash
+# Linux → PowerShell
+shellrosetta lnx2ps "rm -rf folder/"
+# Remove-Item -Recurse -Force folder/
+
+shellrosetta lnx2ps "cp -r src/ dest/"  
+# Copy-Item -Recurse src/ dest/
+```
 
+### System Information
 ```bash
-source ~/.bashrc
-# or
-source ~/.zshrc
+# Linux → PowerShell
+shellrosetta lnx2ps "ps aux | grep nginx"
+# Get-Process | Select-String nginx
+
+shellrosetta lnx2ps "df -h"
+# Get-PSDrive
 ```
 
-Now you get tab completion for commands and flags!
+### Network Operations
+```bash
+# Linux → PowerShell
+shellrosetta lnx2ps "ping google.com"
+# Test-Connection google.com
 
-## Interactive Shell Mode
+shellrosetta lnx2ps "curl -X POST https://api.example.com"
+# Invoke-WebRequest -Method POST https://api.example.com
+```
 
-Run with no arguments for a live translation shell!
+## Advanced Usage
 
+### Interactive Mode
 ```bash
 shellrosetta
+# Provides REPL interface with:
+# - Command history
+# - Mode switching (lnx2ps ↔ ps2lnx)  
+# - Built-in help
+# - Tab completion
+```
+
+### API Server
+```bash
+shellrosetta api --port 8080
+# Starts Flask server with REST endpoints:
+# POST /api/translate - Translate commands
+# GET /api/stats - Usage statistics
+# GET /api/plugins - Plugin information
+```
+
+## Development
+
+### Custom Plugins
+```python
+from shellrosetta.plugins import CommandPlugin
+
+class MyPlugin(CommandPlugin):
+    def get_name(self):
+        return "my_plugin"
+    
+    def translate(self, command, direction):
+        # Custom translation logic
+        return translated_command
+```
+
+### Extending Mappings
+Add custom mappings in `shellrosetta/mappings.py`:
+```python
+CUSTOM_MAPPINGS = {
+    "my_command": ("My-PowerShell-Equivalent", "Usage note")
+}
 ```
 
-You'll be prompted for your translation mode (lnx2ps or ps2lnx). Enter commands and see translations instantly, switching modes at any time with `mode` or exit with `exit`.
+## Requirements
+
+- Python 3.7+
+- Optional: Flask for web interface (`pip install flask flask-cors`)
+
+## Architecture
+
+ShellRosetta features a modular architecture:
+- **Core Engine**: Command parsing and translation
+- **ML Engine**: Pattern learning and suggestions  
+- **Plugin System**: Extensible command handlers
+- **Web API**: Flask-based REST interface
+- **CLI Interface**: Professional command-line tool
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new functionality
+4. Submit a pull request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file.
 
-**Example session:**
+## Changelog
 
-```shell
-$ shellrosetta
-=================================================================
-ShellRosetta: Linux ↔ PowerShell CLI Command Translator
-Author: David Donohue
-Repo: github.com/sdirishguy/shellrosetta
-=================================================================
-Welcome to ShellRosetta Interactive Mode!
-Type 'exit' to quit, or 'mode' to switch translation direction.
-Mode [lnx2ps/ps2lnx] (or 'exit'): lnx2ps
-Type your LNX2PS commands below. Type 'mode' to switch, 'exit' to quit.
+### v1.2.0 (Latest)
+- Added web interface with Flask API
+- Implemented plugin system with 4 built-in plugins
+- Added ML engine with pattern learning
+- Enhanced CLI with interactive mode
+- Added comprehensive test suite
+- Improved error handling and documentation
 
-> ls -alh | grep foo
+### v1.1.x
+- Basic command translation
+- Core mapping system
+- CLI interface
 
---- Translation ---
-PowerShell Equivalent:
-  Get-ChildItem -Force | Format-List # [Human-readable file sizes not natively available.] | Select-String foo
--------------------
+## Support
 
-> rm -rf /tmp
---- Translation ---
-PowerShell Equivalent:
-  Remove-Item -Recurse -Force /tmp
--------------------
+- GitHub Issues: Report bugs and feature requests
+- Documentation: Complete API docs in `/docs`
+- Examples: See `/examples` directory
 
-> mode
+Transform your cross-platform command workflow with ShellRosetta!