Initial commit

skills/ruby-test-analyzer/scripts/README.md

@@ -0,0 +1,131 @@
+# Test Analyzer Scripts
+
+Executable shell scripts for running and analyzing RSpec tests.
+
+## Scripts
+
+### run_tests.sh
+Run RSpec tests with intelligent filtering.
+
+```bash
+# Run all tests
+./run_tests.sh all
+
+# Run only fast tests (exclude slow)
+./run_tests.sh fast
+
+# Run only previously failed tests
+./run_tests.sh failures
+
+# Run tests for changed files
+./run_tests.sh changed
+
+# Profile slowest tests
+./run_tests.sh profile
+
+# Run specific file
+./run_tests.sh spec/models/user_spec.rb
+```
+
+**Modes:**
+- `all` - All tests with documentation format
+- `fast` - Exclude tests tagged with :slow
+- `failures` - Only re-run failed tests (uses .rspec_status)
+- `changed` - Auto-detect changed files via git diff
+- `profile` - Show 10 slowest examples
+- `<file_path>` - Run specific test file
+
+**Features:**
+- Auto-detects RSpec availability
+- Helpful error messages
+- Smart test file detection from lib/ files
+- Documentation format for readability
+
+### analyze_failures.sh
+Analyze test failures and provide debugging hints.
+
+```bash
+./analyze_failures.sh
+```
+
+**Output:**
+```
+Results: 3 failures out of 47 tests
+
+Failed examples:
+
+User#full_name returns first and last name
+  File: spec/user_spec.rb:23
+  Error: RSpec::Expectations::ExpectationNotMetError
+  Message: Expected "John Doe" but got "John"
+
+...
+
+Common fixes:
+  - Check for typos in method names
+  - Verify test data setup (factories, fixtures)
+  - Check for nil objects
+  - Review recent code changes
+```
+
+**Features:**
+- Parses JSON test results
+- Groups failures by type
+- Provides file:line references
+- Suggests common fixes
+- Shows debugging commands
+
+**Requires:**
+- jq (JSON processor)
+- RSpec with JSON formatter
+
+## Usage Examples
+
+### Quick Test Run
+```bash
+# Run changed tests
+./run_tests.sh changed
+
+# If failures, analyze
+./analyze_failures.sh
+```
+
+### TDD Workflow
+```bash
+# Run all tests
+./run_tests.sh all
+
+# Profile to find slow tests
+./run_tests.sh profile
+
+# Tag slow tests, then run fast
+./run_tests.sh fast
+```
+
+### CI/CD
+```bash
+# In CI pipeline
+./run_tests.sh all || ./analyze_failures.sh
+```
+
+## RSpec Configuration
+
+For best results, add to `.rspec`:
+```
+--format progress
+--require spec_helper
+--example-status-persistence-file-path .rspec_status
+```
+
+And in `spec/spec_helper.rb`:
+```ruby
+RSpec.configure do |config|
+  config.example_status_persistence_file_path = ".rspec_status"
+end
+```
+
+## Requirements
+
+- RSpec gem
+- jq (for analyze_failures.sh)
+- git (for changed mode)

skills/ruby-test-analyzer/scripts/analyze_failures.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# Analyze RSpec failures and provide debugging hints
+
+set -e
+
+echo "🔍 Analyzing test failures..."
+
+# Run tests and capture output
+OUTPUT=$(bundle exec rspec --format json --out tmp/rspec_results.json --format progress 2>&1) || true
+
+if [ ! -f "tmp/rspec_results.json" ]; then
+  echo "No test results found. Run tests first."
+  exit 1
+fi
+
+# Parse JSON results
+FAILURES=$(jq '.summary.failure_count' tmp/rspec_results.json)
+TOTAL=$(jq '.summary.example_count' tmp/rspec_results.json)
+
+echo ""
+echo "Results: $FAILURES failures out of $TOTAL tests"
+echo ""
+
+if [ "$FAILURES" -eq 0 ]; then
+  echo "✅ All tests passing!"
+  exit 0
+fi
+
+echo "Failed examples:"
+echo ""
+
+jq -r '.examples[] | select(.status == "failed") | "\(.full_description)\n  File: \(.file_path):\(.line_number)\n  Error: \(.exception.class)\n  Message: \(.exception.message)\n"' tmp/rspec_results.json
+
+echo ""
+echo "Common fixes:"
+echo "  - Check for typos in method names"
+echo "  - Verify test data setup (factories, fixtures)"
+echo "  - Check for nil objects"
+echo "  - Review recent code changes"
+echo ""
+echo "To debug specific test:"
+echo "  bundle exec rspec <file_path>:<line_number> --format documentation"

skills/ruby-test-analyzer/scripts/run_tests.sh

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+# Run RSpec tests with intelligent filtering
+
+set -e
+
+MODE=${1:-all}
+
+echo "🧪 Running RSpec tests (mode: $MODE)..."
+
+# Check if RSpec is available
+if ! bundle exec rspec --version &> /dev/null; then
+  echo "❌ RSpec not found. Add to Gemfile:"
+  echo "  gem 'rspec', '~> 3.12'"
+  exit 1
+fi
+
+case "$MODE" in
+  all)
+    echo "Running all tests..."
+    bundle exec rspec --format documentation
+    ;;
+  fast)
+    echo "Running tests without slow examples..."
+    bundle exec rspec --tag ~slow --format progress
+    ;;
+  failures)
+    echo "Running only previously failed tests..."
+    bundle exec rspec --only-failures --format documentation
+    ;;
+  changed)
+    echo "Running tests for changed files..."
+    CHANGED_FILES=$(git diff --name-only --diff-filter=AM | grep '\.rb$' | grep -v '_spec\.rb$' || true)
+    if [ -z "$CHANGED_FILES" ]; then
+      echo "No changed Ruby files found"
+      exit 0
+    fi
+    
+    for file in $CHANGED_FILES; do
+      # Convert lib/foo/bar.rb to spec/foo/bar_spec.rb
+      spec_file=$(echo "$file" | sed 's/^lib/spec/;s/\.rb$/_spec.rb/')
+      if [ -f "$spec_file" ]; then
+        echo "Testing: $spec_file"
+        bundle exec rspec "$spec_file" --format documentation
+      fi
+    done
+    ;;
+  profile)
+    echo "Running tests with profiling..."
+    bundle exec rspec --profile 10 --format documentation
+    ;;
+  *)
+    # Treat as file path
+    if [ -f "$MODE" ]; then
+      echo "Running test file: $MODE"
+      bundle exec rspec "$MODE" --format documentation
+    else
+      echo "Unknown mode: $MODE"
+      echo "Available modes: all, fast, failures, changed, profile, <file_path>"
+      exit 1
+    fi
+    ;;
+esac
+
+echo ""
+echo "✅ Test run complete"