parabot 1.0.0

data/INSTALL.md

@@ -0,0 +1,242 @@
+# Parabot CLI Installation Guide
+
+The Parabot CLI is a standalone executable that can be distributed to Linux and macOS systems with Ruby installed.
+
+## Requirements
+
+- **Ruby 3.1.0 or higher**
+- **tmux** (for Claude AI integration)
+- **git** (recommended, but not required)
+
+### Checking Requirements
+
+```bash
+# Check Ruby version
+ruby --version
+
+# Check if tmux is installed
+tmux -V
+
+# Check if git is available
+git --version
+```
+
+## Installation Methods
+
+### Method 1: System-wide Installation (Recommended)
+
+Install for all users (requires sudo):
+
+```bash
+sudo cp build/parabot /usr/local/bin/parabot
+```
+
+Verify installation:
+```bash
+parabot --version
+```
+
+### Method 2: User Installation
+
+Install for current user only (requires `~/bin` in PATH):
+
+```bash
+# Create ~/bin if it doesn't exist
+mkdir -p ~/bin
+
+# Copy executable
+cp build/parabot ~/bin/parabot
+
+# Add ~/bin to PATH if not already there
+echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### Method 3: Direct Usage
+
+Use without installation:
+
+```bash
+./build/parabot --help
+```
+
+## Verification
+
+Test that all core functionality works:
+
+```bash
+# Show help
+parabot --help
+
+# Show version
+parabot version
+
+# Test basic commands (dry-run mode)
+parabot test --dry-run
+parabot start --dry-run
+parabot --version
+parabot list
+```
+
+## Configuration
+
+Create a configuration file to customize behavior:
+
+```bash
+# Project-specific configuration
+echo "commands:" > .parabot.yml
+echo "  testhelp: 'help me understand why my tests are failing'" >> .parabot.yml
+echo "  review: 'review my recent code changes'" >> .parabot.yml
+
+# Test custom commands
+parabot commands
+```
+
+## Usage Examples
+
+### Basic Test Running
+```bash
+# Run all tests
+parabot test
+
+# Run specific test files
+parabot test spec/user_spec.rb spec/admin_spec.rb
+
+# Run tests with language override
+parabot test --language ruby
+
+# Preview what would run (dry-run)
+parabot test --dry-run
+```
+
+### Claude AI Integration
+```bash
+# Start Claude session
+parabot start
+
+# Check installation
+parabot --version
+
+# Send a message to Claude
+parabot message "help me debug this test failure"
+
+# Use custom commands (if configured)
+parabot testhelp
+parabot review
+```
+
+### Multi-language Projects
+```bash
+# Force language detection
+parabot test --language ruby
+parabot test --language elixir
+
+# Let parabot detect automatically
+parabot test test/integration_test.exs  # Detects Elixir
+parabot test spec/user_spec.rb          # Detects Ruby
+```
+
+## Troubleshooting
+
+### Ruby Version Issues
+```bash
+# Error: "Parabot requires Ruby 3.1.0 or higher"
+# Solution: Update Ruby using rbenv, RVM, or system package manager
+
+# Using rbenv
+rbenv install 3.1.0
+rbenv global 3.1.0
+
+# Using RVM  
+rvm install 3.1.0
+rvm use 3.1.0 --default
+```
+
+### Permission Issues
+```bash
+# Error: "Permission denied"
+# Solution: Make executable or use sudo
+
+chmod +x ./parabot
+# or
+sudo cp ./parabot /usr/local/bin/
+```
+
+### tmux Integration Issues
+```bash
+# Error: "tmux: command not found"
+# Solution: Install tmux
+
+# Ubuntu/Debian
+sudo apt-get install tmux
+
+# macOS with Homebrew
+brew install tmux
+
+# CentOS/RHEL
+sudo yum install tmux
+```
+
+### Configuration Issues
+```bash
+# Error: "Configuration error: Failed to load configuration"
+# Solution: Check YAML syntax
+
+# Validate YAML file
+ruby -e "require 'yaml'; puts YAML.load_file('.parabot.yml')"
+```
+
+## System Compatibility
+
+### User-specific Configuration
+```bash
+# Create user config directory
+mkdir -p ~/.config/parabot
+
+# User configuration
+tee ~/.config/parabot/config.yml << EOF
+log_level: debug
+language_prompts:
+  ruby:
+    system_prompt: "Ruby expert focused on Rails best practices"
+  elixir:
+    system_prompt: "Elixir expert focused on OTP design patterns"
+EOF
+```
+
+## Distribution Notes
+
+### For Distributors
+- The executable is self-contained with embedded dependencies
+- No gem installation required on target systems
+- Size: ~16KB (very lightweight)
+- Dependencies: Only Ruby standard library + system Ruby
+
+### Security Considerations
+- Executable uses only standard Ruby libraries
+- No network connections except tmux communication
+- Configuration files are standard YAML (no code execution)
+- All file operations are in current directory or user home
+
+## Support
+
+### Getting Help
+```bash
+# Show all available commands
+parabot --help
+
+# Show available custom commands
+parabot commands
+
+# Test with dry-run for debugging
+parabot test --dry-run
+```
+
+### Common Issues
+1. **Ruby version too old**: Update to Ruby 3.1+
+2. **tmux not found**: Install tmux package
+3. **Permission denied**: Use `chmod +x` or `sudo cp`
+4. **Configuration errors**: Validate YAML syntax
+5. **Git repository warnings**: Normal when not in a git repo
+
+The Parabot CLI is designed to work smoothly across different environments while providing helpful error messages and warnings when issues occur.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alexander Paramonov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,371 @@
+# 🤖 Parabot Ruby CLI
+
+**AI-powered Test-Driven Development assistant with seamless tmux integration**
+
+Parabot is a modern Ruby CLI tool that connects your development workflow with Claude AI, providing intelligent test execution, project analysis, and TDD guidance across multiple programming languages.
+
+## 🤖 **Why "Parabot"?**
+
+**"Para" + "bot"** = **Parallel** + **Robot/Bot**
+
+Parabot's core function as an AI assistant that works **alongside** (parallel to) your development workflow:
+
+**Key aspects of the "parallel" concept:**
+- **Parallel Terminal Sessions** - Runs Claude in a separate tmux pane alongside your coding
+- **Parallel Workflow** - Works with your existing TDD process without interrupting it  
+- **Parallel Analysis** - Analyzes test results while you continue coding
+- **Parallel Intelligence** - Provides AI assistance that complements your development skills
+
+## ✨ **What Parabot Does**
+
+- 🔄 **Runs your tests** and sends results to Claude for analysis
+- 🧠 **Provides AI guidance** for test-driven development 
+- 🖥️ **Integrates with tmux** for seamless terminal workflow
+- 🌐 **Supports multiple languages** (Ruby, Elixir, JavaScript, TypeScript, Kotlin, Shell)
+- ⚙️  **Highly configurable** with YAML configuration files you can add new and customize existing languages
+- 🚀 **Works anywhere** - various installation methods
+
+---
+
+## 🚀 **Quick Installation**
+
+### **Option 1: RubyGems Install (Recommended)**
+```bash
+gem install parabot
+```
+
+### **Option 2: Installation Script**
+```bash
+curl -sSL https://raw.githubusercontent.com/AlexParamonov/parabot/main/scripts/install | bash
+```
+
+### **Option 3: Manual Download**
+```bash
+curl -L https://github.com/AlexParamonov/parabot/releases/latest/download/parabot -o parabot
+chmod +x parabot && sudo mv parabot /usr/local/bin/
+```
+
+**Requirements:** Ruby 3.0+ on Linux or macOS
+
+---
+
+## ⚡ **Quick Start**
+
+```bash
+# Initialize parabot in your project
+parabot init
+
+# Start Claude AI session in tmux
+parabot start
+
+# Run tests with AI analysis
+parabot test
+
+# Send custom message to Claude
+parabot "analyze this code for potential issues"
+
+# Check version
+parabot --version
+```
+
+---
+
+## 🎯 **Core Features**
+
+### **🔬 Intelligent Test Execution**
+```bash
+parabot test                    # Run all tests
+parabot test spec/user_spec.rb  # Run specific file
+parabot test --language ruby    # Force language detection
+```
+
+### **🤖 AI Integration**
+```bash
+parabot start                   # Launch Claude session
+parabot message "analyze this"  # Send custom messages
+parabot commands                # List custom commands
+```
+
+### **📋 Custom Commands**
+Define shortcuts in `.parabot.yml`:
+```yaml
+commands:
+  review: "review my latest changes and provide suggestions"
+  debug: "help me debug this failing test"
+  optimize: "suggest performance improvements"
+```
+
+Use them directly:
+```bash
+parabot review    # Sends review message to Claude
+parabot debug     # Sends debug message to Claude
+```
+
+Add more context to your commands:
+```bash
+parabot review spec/user_spec.rb
+parabot review and analyze changes in the last commit
+parabot review "let's review the last 5 commits"
+```
+
+---
+
+## 🛠️ **Installation Details**
+
+### **Installation Script Features**
+- ✅ **Automatic platform detection** (Linux/macOS)
+- ✅ **Smart installation paths** (`/usr/local/bin`, `~/bin`, `~/.local/bin`)
+- ✅ **Ruby version validation** (ensures 3.0+)
+- ✅ **Permission handling** (chooses location based on access)
+
+### **Manual Installation Options**
+
+**System-wide installation:**
+```bash
+sudo cp parabot /usr/local/bin/
+```
+
+**User installation:**
+```bash
+mkdir -p ~/.local/bin
+cp parabot ~/.local/bin/
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+**Verify installation:**
+```bash
+parabot --version
+```
+
+### **For Ruby Developers**
+If you have Ruby and want gem management:
+```bash
+gem install parabot
+parabot --version
+```
+
+**Works in any Ruby project** - no bundler conflicts!
+
+---
+
+## ⚙️ **Configuration**
+
+### **Initialize Configuration**
+```bash
+parabot init  # Creates .parabot.yml with sensible defaults
+```
+
+If you want to specify project languages instead of reling on auto-detection, you can use the -l or --language option:
+```bash
+parabot init -l ruby,typescript
+```
+
+### **Configuration Hierarchy**
+1. `./.parabot.yml` (project-specific)
+2. `~/.config/parabot/.parabot.yml` (user-wide)
+3. `~/.parabot.yml` (global)
+
+### **Example Configuration**
+```yaml
+# Test commands per language
+test_command:
+  ruby: bundle exec rspec
+  elixir: mix test --trace
+  javascript: npm test
+
+# Custom AI commands
+commands:
+  review: "review my latest changes and provide suggestions"
+  debug: "help me debug this failing test"
+  commit: "create a logical git commit message"
+
+# Language-specific settings
+languages:
+  ruby:
+    file_extensions: [".rb", ".rake"]
+    project_files: ["Gemfile", "Rakefile"]
+  elixir:
+    file_extensions: [".ex", ".exs"]
+    project_files: ["mix.exs"]
+```
+
+---
+
+## 🌐 **Multi-Language Support**
+
+| Language | Auto-Detection | Default Test Command |
+|----------|----------------|---------------------|
+| **Ruby** | `Gemfile`, `*.rb` | `bundle exec rspec` |
+| **Elixir** | `mix.exs`, `*.ex` | `mix test --trace` |
+| **JavaScript** | `package.json`, `*.js` | `npm test` |
+| **TypeScript** | `tsconfig.json`, `*.ts` | `npm test` |
+| **Kotlin** | `build.gradle.kts`, `*.kt` | `./gradlew test` |
+| **Shell** | `*.sh`, `*.bash` | `bats` |
+
+### **Language Detection Process**
+Parabot detects the programming language of your project using multiple methods:
+**Auto-detection**: 
+- Based on test command parameters like test flies, directories, and glob patterns.
+- Based on project files like `Gemfile`, `mix.exs`, `package.json`, etc.
+
+**User forced**: 
+- `parabot test --language ruby`
+- `language` option in `.parabot.yml`
+
+---
+
+## 🖥️ **Tmux Integration**
+
+### **How It Works**
+Parabot automatically finds Claude sessions by:
+1. Looking for sessions named "claude" (case-insensitive)
+2. Scanning for Claude processes in any tmux session
+3. Creating new sessions if needed
+
+### **Session Management**
+```bash
+parabot start     # Start Claude in new tmux pane
+parabot message   # Send message to active Claude session
+```
+
+**No tmux?** Parabot allows you to add own adapters and reference them in configuration file. You can also use `--dry-run` mode to see what would happen without needing tmux.
+
+---
+
+## 🔧 **Command Reference**
+
+### **Core Commands**
+```bash
+parabot init                    # Initialize project configuration
+parabot start                   # Start Claude AI session
+parabot test [files...]         # Run tests with AI analysis
+parabot message "text"          # Send message to Claude
+parabot commands                # List available custom commands
+parabot doctor                  # Diagnose configuration issues
+parabot version                 # Show version information
+```
+
+### **Global Options**
+```bash
+--dry-run                       # Show what would happen
+--language, -l LANG             # Force language detection
+--config, -c FILE               # Use specific config file
+--help, -h                      # Show help
+```
+
+### **Examples**
+```bash
+# Test specific files with language override
+parabot test --language ruby spec/user_spec.rb spec/auth_spec.rb
+
+# Dry-run to see what would happen
+parabot --dry-run test
+
+# Dry-run to see what would happen
+parabot --dry-run start
+
+# Custom configuration file
+parabot --config ~/.custom-parabot.yml test
+```
+
+---
+
+## 🐛 **Troubleshooting**
+
+### **Common Issues**
+
+**"Ruby version too old"**
+```bash
+ruby --version  # Check current version
+# Install Ruby 3.0+ using rbenv, asdf, or system package manager
+```
+
+**"Command not found"**
+```bash
+# Check if installation directory is in PATH
+echo $PATH
+# Add to PATH if needed:
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+**"Tmux not found"**
+```bash
+# Install tmux
+sudo apt install tmux    # Ubuntu/Debian
+brew install tmux        # macOS
+# Or use dry-run mode: parabot --dry-run test
+```
+
+**Bundler conflicts in Ruby projects**
+✅ **Fixed!** Parabot v1.0.0+ isolates its dependencies from your project's Gemfile.
+
+---
+
+## 🏗️ **Development**
+
+### **Setup**
+```bash
+git clone https://github.com/AlexParamonov/parabot.git
+cd parabot
+bundle install
+```
+
+### **Testing**
+```bash
+bundle exec rspec              # Run all tests
+bundle exec rake fast          # Fast test subsets
+```
+
+### **Building & Distribution**
+```bash
+gem build parabot.gemspec                # Build gem
+./scripts/build-distribution             # Build standalone executable
+./scripts/install                       # Test installation script
+```
+
+---
+
+## 🤝 **Contributing**
+
+1. Fork the repository
+2. Create feature branch: `git checkout -b feature/amazing-feature`
+3. Add tests for new functionality
+4. Ensure all tests pass: `bundle exec rspec`
+5. Submit pull request
+
+---
+
+## 📄 **License**
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+---
+
+## 🆚 **Why Parabot Ruby CLI?**
+
+**vs Manual Testing:**
+- ✅ Automatic AI analysis of test results
+- ✅ Contextual guidance for failures
+- ✅ Multi-language support
+
+**vs Shell Scripts:**
+- ✅ Robust error handling
+- ✅ Cross-platform compatibility
+- ✅ Extensible architecture
+- ✅ Comprehensive testing
+
+**vs Other AI Tools:**
+- ✅ TDD-focused workflow
+- ✅ Seamless terminal integration
+- ✅ Project-aware context
+- ✅ No bundler conflicts
+
+---
+
+**Ready to supercharge your TDD workflow? Install parabot and start building better software with AI assistance!** 🚀
+
+```bash
+gem install parabot
+parabot init && parabot start
+```

data/Rakefile

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+
+desc "Run tests"
+task test: :spec
+
+desc "Run tests and linting"
+task default: %i[test rubocop]
+
+desc "Console with parabot loaded"
+task :console do
+  require "bundler/setup"
+  require_relative "lib/parabot"
+  require "pry"
+  Pry.start
+end
+
+desc "Install the gem locally"
+task :install_local do
+  sh "gem build parabot.gemspec"
+  sh "gem install parabot-*.gem"
+  sh "rm parabot-*.gem"
+end
+
+desc "Fast test runner with intelligent selection"
+task :fast, [:options] do |t, args|
+  require_relative 'spec/support/performance_helpers'
+
+  options = (args[:options] || "").split
+
+  if options.include?("--benchmark")
+    include PerformanceHelpers
+    benchmark_test_suite
+  elsif options.include?("--unit")
+    sh "bundle exec rspec --format documentation --pattern 'spec/lib/**/*_spec.rb'"
+  elsif options.include?("--integration")
+    sh "bundle exec rspec --format documentation --pattern 'spec/integration/**/*_spec.rb'"
+  elsif options.include?("--changed")
+    # Run tests for changed files (simplified version)
+    sh "bundle exec rspec --format documentation"
+  else
+    sh "bundle exec rspec --format documentation"
+  end
+end

data/config/base.yml

@@ -0,0 +1,12 @@
+# Core Parabot configuration settings
+# This file contains infrastructure settings that apply to all projects
+
+# Logging configuration
+log_level: info           # debug, info, warn, error
+log_file: stderr          # stderr or path to log file (e.g., .parabot/parabot.log)
+
+# Language detection
+language: auto            # auto or specific language (elixir, ruby, etc.)
+
+# Messaging adapter
+adapter: tmux