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)