Initial commit

skills/ruby-bundler/scripts/README.md

@@ -0,0 +1,98 @@
+# Bundler Utility Scripts
+
+Executable shell scripts for common Bundler operations.
+
+## Scripts
+
+### bundle_install.sh
+Install Ruby dependencies with error handling.
+
+```bash
+# Basic install
+./bundle_install.sh
+
+# Install with options
+./bundle_install.sh --without production
+
+# Install for deployment
+./bundle_install.sh --deployment
+```
+
+**Features:**
+- Checks for Gemfile existence
+- Auto-installs bundler if missing
+- Shows helpful error messages
+- Lists installed gems
+
+### bundle_add.sh
+Add a gem to Gemfile and install it.
+
+```bash
+# Add to main section
+./bundle_add.sh pry-byebug '~> 3.10'
+
+# Add to development group
+./bundle_add.sh rubocop '~> 1.50' --group=development
+
+# Add to test group
+./bundle_add.sh rspec --group=test
+```
+
+**Features:**
+- Automatically detects/creates gem groups
+- Adds version constraints
+- Runs bundle install
+- Shows gem info after install
+
+### bundle_update.sh
+Update gems with safety levels.
+
+```bash
+# Show outdated gems (no changes)
+./bundle_update.sh conservative
+
+# Update patch versions only (safest)
+./bundle_update.sh patch
+
+# Update minor versions
+./bundle_update.sh minor
+
+# Update all gems
+./bundle_update.sh all
+
+# Update specific gem
+./bundle_update.sh nokogiri
+```
+
+**Features:**
+- Multiple safety modes
+- Shows git diff of Gemfile.lock changes
+- Conservative default (shows outdated only)
+
+### bundle_audit.sh
+Security audit for dependencies.
+
+```bash
+./bundle_audit.sh
+```
+
+**Features:**
+- Auto-installs bundler-audit if needed
+- Updates vulnerability database
+- Shows vulnerabilities with fix suggestions
+- Returns non-zero exit code if vulnerabilities found
+
+## Usage in Skills
+
+These scripts can be called by the ruby-bundler skill:
+
+```ruby
+# From skill
+system("#{PLUGIN_DIR}/skills/ruby-bundler/scripts/bundle_install.sh")
+```
+
+## Requirements
+
+- Ruby installed
+- Git (for bundle_update.sh diff)
+- bundler gem (auto-installed if missing)