railsforge 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a30814a978c1f6eae732253edaf8ebde7fb49b5761ef1927f180a5480f3f7921
+  data.tar.gz: 4dfd319836fd20dcc79ac23d0c5eeb644802b9f6d480956dbae89cfeb5ef39ed
+SHA512:
+  metadata.gz: eb2d18edddb6280e6b1eb954efb13a7acedc9e1fc429a7257e59282cbb2225293a0c028b5c34a3b1e1c18f3e7875c1868e4472a8b39b6b90ba6d7e24cd7803b9
+  data.tar.gz: a8fee69a296ec94b93aecbd6f89223c5fcda26ff37dd6fb96081394dbc7856dd92f5c4a445ac2cd1a7f549c0159ca712f0e0680ad1987dfd166f10bf7a908d1f

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Quinto
+
+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,528 @@
+# RailsForge
+
+<p align="center">
+  <a href="https://github.com/railsforge/railsforge/actions">
+    <img src="https://img.shields.io/github/actions/workflow/status/railsforge/railsforge/main.yml" alt="CI Status">
+  </a>
+  <a href="https://rubygems.org/gems/railsforge">
+    <img src="https://img.shields.io/gem/v/railsforge" alt="Gem Version">
+  </a>
+  <a href="https://rubygems.org/gems/railsforge">
+    <img src="https://img.shields.io/gem/dt/railsforge" alt="Gem Downloads">
+  </a>
+  <a href="https://github.com/railsforge/railsforge/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/railsforge/railsforge" alt="License">
+  </a>
+</p>
+
+RailsForge is a comprehensive command-line tool for automatically generating essential Rails application components, including monitoring configurations, DevOps setups, and security/performance analyzers.
+
+## Project Overview
+
+RailsForge streamlines Rails development by providing automated generators and analyzers for common tasks:
+
+- **Monitoring Configuration** - Sentry error tracking and Lograge structured logging
+- **DevOps Setup** - Docker containerization and CI/CD pipeline configuration
+- **Security Analysis** - Automated vulnerability detection
+- **Performance Analysis** - Performance optimization recommendations
+- **Code Generation** - Services, queries, jobs, and more with template versioning
+
+### Key Features
+
+- 🔧 **Automated Generators** - Generate services, queries, jobs, components with a single command
+- 📊 **Code Analyzers** - Security, performance, and architectural analysis
+- 🐳 **DevOps Ready** - Docker and CI/CD configuration out of the box
+- 📈 **Monitoring** - Sentry and Lograge integration
+- 🎨 **Template System** - v1, v2, and v3 template versions with advanced patterns
+- 🧩 **Plugin System** - Extensible architecture for custom functionality
+- ⚙️ **Configuration** - Customizable via `.railsforgerc` YAML file
+
+## Installation
+
+### Requirements
+
+- **Ruby** version 2.7 or higher
+- **Rails** version 5.0 or higher (for Rails-specific features)
+- **Bundler** for gem management
+
+### Setup Steps
+
+#### Option 1: Install from RubyGems (Recommended)
+
+```bash
+# Install the gem
+gem install railsforge
+
+# Verify installation
+railsforge --version
+```
+
+#### Option 2: Install from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/mfifth/railsforge.git
+cd railsforge
+
+# Install dependencies
+bundle install
+
+# Make the binary executable
+chmod +x bin/railsforge
+
+# Run locally
+./bin/railsforge --version
+```
+
+#### Option 3: Add to Gemfile
+
+```ruby
+# Add to your Rails project's Gemfile
+group :development do
+  gem 'railsforge', require: false
+end
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+## Usage Documentation
+
+### Getting Help
+
+```bash
+railsforge --help
+railsforge --version
+```
+
+### Generate Commands
+
+#### Monitoring Configuration
+
+Add Sentry error tracking and Lograge structured logging to your Rails application:
+
+```bash
+railsforge generate monitoring
+railsforge generate monitoring --sentry_dsn=your_dsn_here
+railsforge generate monitoring --environment=production
+```
+
+This creates:
+- `config/initializers/sentry.rb` - Sentry configuration
+- `config/initializers/lograge.rb` - Lograge setup
+- Updates environment configurations
+
+#### DevOps Configuration
+
+Generate Docker and CI/CD pipeline configurations:
+
+```bash
+railsforge generate devops
+railsforge generate devops --docker
+railsforge generate devops --ci=github
+railsforge generate devops --ci=gitlab
+```
+
+This creates:
+- `Dockerfile` - Container definition
+- `docker-compose.yml` - Multi-service setup
+- `.github/workflows/ci.yml` - GitHub Actions CI/CD
+- `.gitlab-ci.yml` - GitLab CI configuration
+- `config/kubernetes/` - Kubernetes manifests
+- `bin/deploy` - Deployment script
+
+#### Demo Project
+
+Create a sample Rails project for learning or prototyping:
+
+```bash
+railsforge generate demo my_demo
+railsforge generate demo my_demo --type=blog
+railsforge generate demo my_api --type=api
+```
+
+#### Test Files
+
+Generate comprehensive test files:
+
+```bash
+railsforge generate test User
+railsforge generate test PostsController --type=controller
+railsforge generate test UserService --type=service
+railsforge generate test SendEmailJob --type=job
+```
+
+#### Standard Generators
+
+Generate Rails components with template versioning:
+
+```bash
+# Service objects
+railsforge generate service user_creator
+railsforge generate service user_creator --template=v2
+railsforge generate service user_creator --template=v3
+
+# Query objects  
+railsforge generate query active_users
+railsforge generate query posts --template=v2
+
+# Jobs
+railsforge generate job send_email
+railsforge generate job process_data --template=v3
+
+# Form objects
+railsforge generate form contact_form
+
+# Presenters
+railsforge generate presenter user_presenter
+
+# Policies
+railsforge generate policy post_policy
+
+# Serializers
+railsforge generate serializer post_serializer
+
+# View Components
+railsforge generate component button
+railsforge generate component modal --template=v2
+
+# Stimulus Controllers
+railsforge generate stimulus dropdown
+
+# Mailers
+railsforge generate mailer user_mailer
+
+# Features
+railsforge generate feature user_signup
+
+# API Resources
+railsforge generate api posts
+```
+
+### Analyze Commands
+
+#### Security Analysis
+
+Run security vulnerability checks on your codebase:
+
+```bash
+railsforge analyze security
+railsforge analyze security --verbose
+```
+
+Checks for:
+- SQL injection vulnerabilities
+- Cross-site scripting (XSS) risks
+- Authentication/authorization issues
+- Insecure configuration patterns
+- Sensitive data exposure
+
+#### Performance Analysis
+
+Identify performance optimization opportunities:
+
+```bash
+railsforge analyze performance
+railsforge analyze performance --verbose
+```
+
+Checks for:
+- N+1 query patterns
+- Missing database indexes
+- Inefficient queries
+- Memory leak patterns
+- Unoptimized asset loading
+
+#### Other Analyzers
+
+```bash
+# Analyze controllers
+railsforge analyze controllers
+railsforge analyze c
+
+# Analyze models
+railsforge analyze models
+railsforge analyze m
+
+# Analyze specs
+railsforge analyze specs
+railsforge analyze spec
+
+# Analyze database
+railsforge analyze db
+railsforge analyze database
+
+# Analyze metrics
+railsforge analyze metrics
+
+# Run all analyzers
+railsforge analyze all
+railsforge analyze full
+```
+
+### Other Commands
+
+#### Doctor - Health Check
+
+Comprehensive project health report:
+
+```bash
+railsforge doctor
+```
+
+Combines all analyzers and calculates an architecture score (0-100).
+
+#### Dependency Graph
+
+Generate a Graphviz diagram of your Rails architecture:
+
+```bash
+railsforge graph
+```
+
+Outputs `.dot` and `.svg` files to `tmp/railsforge/`.
+
+#### Wizard - Interactive Setup
+
+Interactive project configuration:
+
+```bash
+railsforge wizard
+railsforge wizard --profile=blog
+```
+
+#### Plugin Management
+
+```bash
+# List available plugins
+railsforge plugins list
+
+# Load a specific plugin
+railsforge plugins load my_plugin
+```
+
+#### Configuration
+
+```bash
+# View current configuration
+railsforge config
+
+# Set configuration values
+railsforge config set default_template v2
+railsforge config set analyzer_threshold 10
+```
+
+#### Profiles
+
+List available project profiles:
+
+```bash
+railsforge profiles
+```
+
+Available profiles: blog, admin_app, api_only, standard
+
+## Configuration Options
+
+### .railsforgerc
+
+Create a `.railsforgerc` file in your project root to customize RailsForge behavior:
+
+```yaml
+# .railsforgerc
+default_template: v2
+analyzer_threshold: 10
+
+# Generator settings
+generators:
+  with_specs: true
+  template_version: v2
+
+# Analyzer settings  
+security:
+  strict_mode: true
+performance:
+  check_n_plus_queries: true
+```
+
+### Available Flags
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--sentry_dsn` | Sentry DSN for error tracking | - |
+| `--environment` | Rails environment | development |
+| `--template` | Template version (v1, v2, v3) | v1 |
+| `--dry-run` | Preview changes without executing | false |
+| `--no-spec` | Generate without spec files | false |
+
+## Template System
+
+RailsForge supports multiple template versions for each component:
+
+### v1 - Standard Templates
+
+Basic templates suitable for simple applications:
+
+```ruby
+class UserCreator
+  def initialize(params)
+    @params = params
+  end
+
+  def call
+    # Basic implementation
+  end
+end
+```
+
+### v2 - Enhanced Templates
+
+Enhanced templates with additional features:
+
+```ruby
+class UserCreator < BaseService
+  option :name
+  
+  def call
+    # Enhanced with Dry::Schema validation
+  end
+end
+```
+
+### v3 - Advanced Templates
+
+Advanced templates with best practices:
+
+```ruby
+class UserCreator
+  include Dry::Monads[:result, :do]
+
+  def call
+    yield validate!
+    yield process!
+    Success(result_data)
+  end
+end
+```
+
+## Examples
+
+### Complete Workflow Example
+
+```bash
+# 1. Create a new Rails app (optional)
+railsforge new my_app --profile=api
+
+# 2. Add monitoring
+cd my_app
+railsforge generate monitoring --sentry_dsn=https://key@sentry.io/123
+
+# 3. Add DevOps setup
+railsforge generate devops --ci=github
+
+# 4. Generate components
+railsforge generate service user_creator --template=v3
+railsforge generate job send_welcome_email --template=v3
+railsforge generate query active_users --template=v3
+
+# 5. Run analysis
+railsforge analyze all
+railsforge doctor
+
+# 6. Check architecture
+railsforge graph
+```
+
+### Output Examples
+
+```
+$ railsforge generate monitoring
+Generating Monitoring configurations...
+Created config/initializers/sentry.rb
+Created config/initializers/lograge.rb
+Updated production.rb
+
+$ railsforge analyze security
+Security Analysis
+==================================================
+✓ No security issues found
+
+$ railsforge analyze performance
+Performance Analysis
+==================================================
+✓ No performance issues found
+```
+
+## Contributing
+
+We welcome contributions! Please see our contributing guidelines:
+
+### Development Setup
+
+```bash
+# Fork the repository
+git clone https://github.com/your-username/railsforge.git
+cd railsforge
+
+# Install dependencies
+bundle install
+
+# Run tests
+bundle exec rake test
+
+# Run linter
+bundle exec rubocop
+```
+
+### Submitting Changes
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+### Code Style
+
+- Follow Ruby community style guides
+- Write tests for new features
+- Update documentation for any changes
+- Use meaningful commit messages
+
+## License
+
+RailsForge is released under the MIT License.
+
+Copyright (c) 2024 RailsForge Contributors
+
+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.
+
+## Support
+
+- 📖 [Documentation](https://github.com/railsforge/railsforge/wiki)
+- 🐛 [Issue Tracker](https://github.com/railsforge/railsforge/issues)
+- 💬 [Discussions](https://github.com/railsforge/railsforge/discussions)
+- ⭐ [Give us a star](https://github.com/railsforge/railsforge)
+
+---
+
+<p align="center">Built with ❤️ for the Rails community</p>

data/bin/railsforge

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# CLI entrypoint for RailsForge gem
+# This file is executable from the command line
+
+require_relative "../lib/railsforge"
+
+# Delegate to RailsForge::CLI
+RailsForge::CLI.start(ARGV)

data/lib/railsforge/analyzers/base_analyzer.rb

@@ -0,0 +1,41 @@
+# Base analyzer class for RailsForge
+# All analyzers inherit from this class
+
+module RailsForge
+  module Analyzers
+    # Base class for all analyzers
+    class BaseAnalyzer
+      # Find Rails app path (class method)
+      # @return [String, nil] Rails app root path
+      def self.find_rails_app_path
+        path = Dir.pwd
+        max_depth = 10
+
+        max_depth.times do
+          return path if File.exist?(File.join(path, "config", "application.rb"))
+          parent = File.dirname(path)
+          break if parent == path
+          path = parent
+        end
+
+        nil
+      end
+
+      # Find Rails app path (instance method)
+      # @return [String, nil] Rails app root path
+      def find_rails_app_path
+        self.class.find_rails_app_path
+      end
+
+      # Analyze - must be implemented by subclasses
+      def self.analyze(base_path = nil)
+        raise NotImplementedError, "Subclasses must implement #analyze"
+      end
+
+      # Instance analyze method
+      def analyze
+        self.class.analyze
+      end
+    end
+  end
+end

data/lib/railsforge/analyzers/controller_analyzer.rb

@@ -0,0 +1,83 @@
+# Controller analyzer for RailsForge
+# Scans controllers for code quality issues
+
+require_relative 'base_analyzer'
+
+module RailsForge
+  module Analyzers
+    # ControllerAnalyzer scans controllers for issues
+    class ControllerAnalyzer < BaseAnalyzer
+      # Configuration thresholds
+      MAX_LINES = 150
+      MAX_METHODS = 10
+
+      # Analyze controllers
+      # @param base_path [String] Rails app root
+      # @return [Array<Hash>] Analysis results
+      def self.analyze(base_path = nil)
+        base_path ||= find_rails_app_path
+        return [] unless base_path
+
+        controllers_dir = File.join(base_path, "app", "controllers")
+        return [] unless Dir.exist?(controllers_dir)
+
+        results = []
+        Dir.glob(File.join(controllers_dir, "**", "*_controller.rb")).each do |file|
+          next if file.end_with?("_application_controller.rb")
+
+          content = File.read(file)
+          lines = content.lines.count
+          methods = content.scan(/def \w+/).count
+
+          issues = []
+          issues << "Exceeds #{MAX_LINES} lines" if lines > MAX_LINES
+          issues << "Has #{methods} methods (max: #{MAX_METHODS})" if methods > MAX_METHODS
+
+          if issues.any?
+            results << {
+              file: File.basename(file),
+              path: file,
+              lines: lines,
+              methods: methods,
+              issues: issues
+            }
+          end
+        end
+
+        results
+      end
+
+      # Print results
+      def self.print_results(results)
+        puts "\nController Analysis"
+        puts "-" * 40
+
+        if results.empty?
+          puts "✓ No issues found"
+          return
+        end
+
+        results.each do |result|
+          puts "⚠ #{result[:file]}"
+          puts "  Lines: #{result[:lines]}, Methods: #{result[:methods]}"
+          result[:issues].each { |issue| puts "  - #{issue}" }
+        end
+      end
+
+      # Find Rails app path
+      def self.find_rails_app_path
+        path = Dir.pwd
+        max_depth = 10
+
+        max_depth.times do
+          return path if File.exist?(File.join(path, "config", "application.rb"))
+          parent = File.dirname(path)
+          break if parent == path
+          path = parent
+        end
+
+        nil
+      end
+    end
+  end
+end