parabot 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a6b627399cab2d411c391f4ed074c5f1e1218b5b958c7ef94ada7a259c268266
+  data.tar.gz: 423650aa29177a0ed32c39f99d06b3137c0b405dd99b1a80155c2bc8b61166ef
+SHA512:
+  metadata.gz: a6b8c969341f0e1b6a57487c57c3c14181995e0b66625e66cdd6888328fd8d62514fddc4c31fa53b9aaa099907139927bde75b56c79fa28ef506eabe5e354e99
+  data.tar.gz: 7cd56bc872045673dd39870bd7f09151a69ee6a3289261b850f572cb80bea99a1ec0fe577849a4393966eaebd0ab653e78b40243ca82734ea80ffdcc952c31e9

data/.rubocop.yml

@@ -0,0 +1,55 @@
+require:
+  - rubocop-rspec
+
+plugins:
+  - rubocop-capybara
+
+AllCops:
+  TargetRubyVersion: 3.0
+  NewCops: enable
+  Exclude:
+    - 'vendor/**/*'
+    - 'bin/**/*'
+    - 'exe/**/*'
+    - '*.gemspec'
+
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+
+Layout/LineLength:
+  Max: 120
+  Exclude:
+    - 'spec/**/*'
+
+Layout/FirstArrayElementIndentation:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false
+
+Layout/EmptyLinesAroundExceptionHandlingKeywords:
+  Enabled: false
+
+Style/MultilineTernaryOperator:
+  Enabled: false
+
+Style/ParallelAssignment:
+  Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - 'config/**/*'
+
+Metrics/ModuleLength:
+  Exclude:
+    - 'spec/**/*'

data/CLAUDE.md

@@ -0,0 +1,171 @@
+# CRITICAL: Read .parabot/.parabot.md FIRST
+Before any task, you MUST read and follow the instructions in .parabot/.parabot.md
+
+**Performance Helper Tools** (`spec/support/performance_helpers.rb`):
+- Automated benchmark analysis
+- Memory usage monitoring  
+- CI-optimized test execution
+- Changed file detection
+- Test category organization
+
+#### The Anti-Pattern: Replacing Meaningful Assertions
+
+**Problem**: When tests fail, replacing specific, meaningful assertions with generic `not_to raise_error` checks.
+
+**Example of Destructive Changes**:
+```ruby
+# BEFORE (Meaningful test):
+it "demonstrates sending results to Claude with file reference" do
+  expect_dry_run_output(["test", "spec/user_spec.rb"], [
+    "Would run tests with args: spec/user_spec.rb",
+    "Detected language: ruby",
+    "<test_results_file>",
+    "</test_results_file>"
+  ], project_root: temp_dir)
+end
+
+# AFTER (Meaningless test):
+it "demonstrates sending results to Claude with file reference" do
+  expect { dry_run_cli_command(["test", "spec/user_spec.rb", "--project-root", temp_dir]) }.not_to raise_error
+end
+```
+
+**Why This Is Destructive**:
+1. **Loses Business Logic Validation**: Original test verified file reference format, new test only checks "doesn't crash"
+2. **Hides Real Issues**: Root cause (configuration, language detection, etc.) remains unfixed
+3. **False Confidence**: Test passes but provides no assurance of correct behavior
+4. **Regression Risk**: Future changes can break functionality without test detection
+
+#### The Pattern Recognition Signs
+
+**Red Flags When Fixing Tests**:
+- Replacing specific output expectations with `not_to raise_error`
+- Converting complex assertions to simple "doesn't crash" checks
+- Removing meaningful content validation
+- Changing from `expect_dry_run_output` to generic command execution
+
+**Example Red Flags**:
+```ruby
+# RED FLAG: Gutting end-to-end workflow tests
+expect { dry_run_cli_command(["test", "spec/user_spec.rb", "--project-root", temp_dir]) }.not_to raise_error
+
+# RED FLAG: Removing Claude integration validation
+expect { dry_run_cli_command(["test", "test/user_test.exs", "--project-root", temp_dir]) }.not_to raise_error
+
+# RED FLAG: Eliminating language detection verification
+expect { dry_run_cli_command(["start", "--project-root", temp_dir]) }.not_to raise_error
+```
+
+#### The Correct Approach: Root Cause Analysis
+
+**Step 1: Understand What the Test Should Validate**
+```ruby
+# Test name: "demonstrates sending results to Claude with file reference"
+# Purpose: Verify that test results are sent via file reference format
+# Expected behavior: Message should contain <test_results_file> tags
+```
+
+**Step 2: Identify the Real Issue**
+- Configuration missing language definitions
+- Language detection returning wrong results
+- TestResult mocking returning wrong object types
+- Git commands failing in test environment
+
+**Step 3: Fix Root Causes, Not Symptoms**
+```ruby
+# WRONG: Avoid the error
+expect { command }.not_to raise_error
+
+# RIGHT: Fix the configuration
+create_config(temp_dir, {
+  "test_command" => { "ruby" => "bundle exec rspec" },
+  "languages" => {
+    "ruby" => {
+      "file_extensions" => [".rb", ".rake"],
+      "project_files" => ["Gemfile", "Rakefile"]
+    }
+  }
+})
+
+# RIGHT: Fix the mocking
+test_result = double('TestResult', exit_status: 0, output: "results", success?: true)
+allow(test_runner).to receive(:run_tests).and_return(test_result)
+
+# RIGHT: Validate the actual behavior
+expect_dry_run_output(["test", "spec/user_spec.rb"], [
+  "Would run tests with args: spec/user_spec.rb",
+  "<test_results_file>",
+  "</test_results_file>"
+], project_root: temp_dir)
+```
+
+#### Recovery Strategy When Anti-Pattern Is Detected
+
+**Immediate Action**:
+1. **Stop and Analyze**: What was the original test supposed to validate?
+2. **Read Test Name**: Extract the expected behavior from descriptive test names
+3. **Examine Failure Output**: Understand why the original test failed
+4. **Identify Root Cause**: Configuration? Mocking? Environment setup?
+
+**Systematic Recovery**:
+```ruby
+# Step 1: Restore original meaningful assertions
+it "detects language from file extensions in multi-language projects" do
+  # Step 2: Fix the actual issue (configuration)
+  create_config(temp_dir, mixed_config_with_language_definitions)
+  
+  # Step 3: Test actual behavior with language override
+  expect_dry_run_output(["test", "--language", "elixir", "test/user_test.exs"], [
+    "Would run tests with args: test/user_test.exs",
+    "mix test test/user_test.exs"
+  ], project_root: temp_dir)
+end
+```
+
+#### Prevention Guidelines
+
+**Before Changing Test Assertions**:
+1. **Ask**: "What behavior is this test supposed to validate?"
+2. **Check**: "Will my change preserve that validation?"
+3. **Verify**: "Am I fixing the symptom or the root cause?"
+
+**During Test Fixes**:
+1. **Read test names carefully** - they describe expected behavior
+2. **Preserve meaningful assertions** at all costs
+3. **Fix configuration, mocking, and environment issues** instead of avoiding them
+4. **Understand the difference** between unit tests (focused behavior) and integration tests (end-to-end workflows)
+
+**Test Categories and Their Purposes**:
+- **Unit Tests**: Validate specific component behavior with focused assertions
+- **Integration Tests**: Validate end-to-end workflows and real-world scenarios  
+- **Error Handling Tests**: Verify error conditions and recovery behavior
+- **Claude Integration Tests**: Validate message formats and communication protocols
+
+#### Success Metrics for Test Fixes
+
+**Good Test Fixes**:
+- ✅ Original test intent preserved
+- ✅ Root cause identified and resolved
+- ✅ Meaningful assertions maintained
+- ✅ Business logic still validated
+
+**Bad Test Fixes** (Anti-Pattern):
+- ❌ Test reduced to "doesn't crash" check
+- ❌ Specific behavior validation removed
+- ❌ Root cause left unaddressed
+- ❌ False confidence in system behavior
+
+#### Implementation Notes
+
+**Files Where This Anti-Pattern Occurred**:
+- `spec/lib/parabot/commands/test_spec.rb` - Claude integration tests
+- `spec/integration/end_to_end_workflow_spec.rb` - Workflow validation tests
+- Multiple test files where `expect(...).not_to raise_error` appeared
+
+**Corrective Actions Taken**:
+1. **Configuration Completeness**: Added missing language definitions with file extensions
+2. **TestResult Mocking**: Fixed mocks to return proper structured objects
+3. **Git Command Issues**: Changed from `git ls-tree HEAD` to `git ls-files --cached --others --exclude-standard`
+4. **Test Environment Setup**: Ensured proper git initialization and configuration
+
+This anti-pattern represents a fundamental misunderstanding of test purpose: tests should validate behavior, not just absence of crashes. The recovery demonstrates the importance of understanding what tests are supposed to achieve before attempting to fix them.

data/DISTRIBUTION.md

@@ -0,0 +1,287 @@
+# Parabot CLI Distribution Guide
+
+This guide covers multiple ways to install and distribute the Parabot CLI tool across different platforms.
+
+## Quick Installation
+
+### Option 1: One-Line Installation Script
+```bash
+curl -sSL https://raw.githubusercontent.com/AlexParamonov/parabot/main/scripts/install | bash
+```
+
+### Option 2: RubyGems Installation
+```bash
+gem install parabot
+```
+
+### Option 3: Manual Download
+Download the latest release from [GitHub Releases](https://github.com/AlexParamonov/parabot/releases)
+
+---
+
+## Distribution Methods
+
+### 1. RubyGems Distribution (Recommended for Ruby developers)
+
+**Requirements:** Ruby 3.0+ and RubyGems
+
+```bash
+# Install from RubyGems
+gem install parabot
+
+# Verify installation
+parabot --version
+```
+
+**Pros:**
+- ✅ Automatic dependency management
+- ✅ Easy updates with `gem update parabot`
+- ✅ Familiar to Ruby developers
+- ✅ Cross-platform compatibility
+
+**Cons:**
+- ❌ Requires Ruby ecosystem on target machine
+
+### 2. Standalone Executable (Recommended for end users)
+
+**Requirements:** Ruby 3.0+ (no gems needed)
+
+```bash
+# Build standalone executable
+./scripts/build-distribution
+
+# Install globally
+sudo cp build/parabot /usr/local/bin/
+
+# Or install for current user
+cp build/parabot ~/bin/
+```
+
+**Pros:**
+- ✅ No gem dependencies
+- ✅ Works with any Ruby installation
+- ✅ Portable single file
+- ✅ Development and production ready
+
+**Cons:**
+- ❌ Still requires Ruby runtime
+
+### 3. Installation Script (Recommended for automation)
+
+**Requirements:** curl/wget, Ruby 3.0+
+
+```bash
+# Automatic installation with platform detection
+curl -sSL https://raw.githubusercontent.com/AlexParamonov/parabot/main/scripts/install | bash
+
+# Manual installation script
+wget -O- https://raw.githubusercontent.com/AlexParamonov/parabot/main/scripts/install | bash
+
+# Customized installation
+INSTALL_DIR=/opt/parabot curl -sSL https://raw.githubusercontent.com/AlexParamonov/parabot/main/scripts/install | bash
+```
+
+**Features:**
+- 🔍 Automatic platform detection (Linux/macOS)
+- 📂 Smart installation directory selection
+- ✅ Ruby version validation
+- 🔒 Permission-based installation path selection
+
+---
+
+## Platform-Specific Instructions
+
+### Linux (Ubuntu/Debian/CentOS/RHEL)
+
+```bash
+# Install Ruby if needed
+sudo apt-get install ruby-full  # Ubuntu/Debian
+sudo yum install ruby ruby-devel # CentOS/RHEL
+
+# Install parabot
+gem install parabot
+
+# Alternative: Use installation script
+curl -sSL https://raw.githubusercontent.com/AlexParamonov/parabot/main/scripts/install | bash
+```
+
+### macOS
+
+```bash
+# Install Ruby if needed (using Homebrew)
+brew install ruby
+
+# Install parabot
+gem install parabot
+
+# Alternative: Use installation script
+curl -sSL https://raw.githubusercontent.com/AlexParamonov/parabot/main/scripts/install | bash
+```
+
+
+---
+
+## Building Distribution
+
+### For Maintainers
+
+```bash
+# Build standalone executable
+./scripts/build-distribution
+
+# Test the build
+BUILD_DIR=/tmp/test ./scripts/build-distribution
+
+# Build gem package
+gem build parabot.gemspec
+```
+
+### Build Requirements
+
+**Development Dependencies:**
+- Ruby 3.0+
+- Bundler
+- RSpec (for testing)
+- Git
+
+**Runtime Dependencies:**
+- `dry-cli ~> 1.1`
+- `config ~> 5.0` 
+- `semantic_logger ~> 4.15`
+
+### Distribution Testing
+
+```bash
+# Run distribution tests
+bundle exec rspec spec/distribution/
+
+# Test on clean system
+docker run --rm -v $(pwd):/app ruby:3.2 bash -c "cd /app && ./scripts/install"
+```
+
+---
+
+## Troubleshooting
+
+### Common Issues
+
+**"Ruby version too old"**
+```bash
+# Check Ruby version
+ruby --version
+
+# Upgrade Ruby (using rbenv)
+rbenv install 3.2.2
+rbenv global 3.2.2
+```
+
+**"Gem not found"**
+```bash
+# Check gem environment
+gem env
+
+# Install missing dependencies
+bundle install
+
+# Reinstall gem
+gem uninstall parabot
+gem install parabot
+```
+
+**"Command not found"**
+```bash
+# Check PATH includes gem bin directory
+echo $PATH
+gem environment | grep "EXECUTABLE DIRECTORY"
+
+# Add to PATH if needed
+echo 'export PATH="$PATH:$(gem environment | grep "EXECUTABLE DIRECTORY" | cut -d: -f2 | tr -d " ")"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+**Permission denied**
+```bash
+# Use user installation instead of system
+gem install --user-install parabot
+
+# Or use installation script with custom directory
+INSTALL_DIR=$HOME/.local/bin curl -sSL https://raw.githubusercontent.com/AlexParamonov/parabot/main/scripts/install | bash
+```
+
+### Platform-Specific Issues
+
+**Linux: Missing development tools**
+```bash
+sudo apt-get install build-essential ruby-dev  # Ubuntu/Debian
+sudo yum groupinstall "Development Tools" ruby-devel  # CentOS/RHEL
+```
+
+**macOS: Xcode command line tools**
+```bash
+xcode-select --install
+```
+
+---
+
+## Advanced Distribution
+
+### Package Managers
+
+**Homebrew (macOS)** - *Coming Soon*
+```bash
+brew install parabot
+```
+
+**APT Repository (Ubuntu/Debian)** - *Coming Soon*
+```bash
+curl -fsSL https://apt.parabot.dev/gpg | sudo apt-key add -
+echo "deb https://apt.parabot.dev/ stable main" | sudo tee /etc/apt/sources.list.d/parabot.list
+sudo apt-get update && sudo apt-get install parabot
+```
+
+### CI/CD Integration
+
+**GitHub Actions**
+```yaml
+- name: Install Parabot
+  run: |
+    curl -sSL https://raw.githubusercontent.com/AlexParamonov/parabot/main/scripts/install | bash
+    echo "$HOME/.local/bin" >> $GITHUB_PATH
+```
+
+**Docker Build**
+```dockerfile
+RUN gem install parabot
+COPY . /workspace
+WORKDIR /workspace
+RUN parabot test
+```
+
+---
+
+## Security Considerations
+
+- ✅ Installation script validates checksums
+- ✅ HTTPS-only downloads
+- ✅ No root permissions required for user installation
+- ✅ Gem signed with maintainer key
+- ⚠️ Always verify installation sources
+
+---
+
+## Support
+
+- 📖 Documentation: [parabot.dev/docs](https://parabot.dev/docs)
+- 🐛 Issues: [GitHub Issues](https://github.com/AlexParamonov/parabot/issues)
+- 💬 Community: [Discord](https://discord.gg/parabot)
+- 📧 Email: support@parabot.dev
+
+---
+
+## Contributing to Distribution
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on:
+- Adding new distribution methods
+- Improving installation scripts
+- Testing on additional platforms
+- Package manager integrations