claude-on-rails 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 206459b18615aaa1771feb47da932334667c0576743720f62b5bd250fb54382f
-  data.tar.gz: 9b9248f8d69d7a58675c3fcaa8d995768a07064291bce46449839be9c66b6ed9
+  metadata.gz: de4a3fb293d60b83ed1f58dbaac8d0884d4febdf37acf2adb18d93de025858c2
+  data.tar.gz: 7c180d4eb24f642107e6029c9f2502b2a4707a52debf87cd5f672b88738d9c83
 SHA512:
-  metadata.gz: b87b26d3fcbc85c25e275f57b4db1d10a44d6305bddba12fd430d1898ba8d3f33f07c4bc76a04bec1b51210aa136bde95a27c8936f90724fbdd32ee2d64ddb2e
-  data.tar.gz: be29ca3b7717455d29dd3c64b6e4d21e5d041698b2604d1c308b861c9b24f99fc462607eb5f5bf7b0ed6a1cbe40b5100a9f1a13c9f840863500e2739cbc6f92a
+  metadata.gz: 5d853f53d8ff33753d9db0f3386ecabecb58e816711e0eaa57b8e3fad35c3d99284d3a101101bdf52f0f3010d83df95b1866ac9e8069e6bd40a55d6181d0cbf2
+  data.tar.gz: 9e44356c815d9f0bd3338e49ab12e2e134eae9e9a5ab1519ec69ef6ca4e32ad2cd9d7ccae63cbd6504130adc845a383953231adfe5ed2d73a53ad5360546e355

data/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2025-01-26
+
+### Fixed
+- Only create swarm agents for directories that actually exist
+- Changed model from full model name to claude-swarm compatible names (opus/haiku/sonnet)
+- Fixed controllers connections to only include services if directory exists
+
+### Changed
+- Default model is now "opus" for all agents
+- Generator now shows which agents will be created during analysis
+
+### Improved
+- Swarm configuration template now checks for directory existence before creating agents
+- Better handling of optional directories like app/services, app/jobs, etc.
+
+## [0.1.2] - 2025-01-26
+
+### Fixed
+- Fixed generator requiring claude_on_rails module
+- Changed generated filename from swarm.yml to claude-swarm.yml (expected by claude-swarm CLI)
+- Removed incorrect "orchestrate" command from documentation
+- Fixed installation instructions (removed redundant gem install step)
+- Added missing prompt templates for all agent types
+- Corrected prompt syntax examples to use > prefix
+
+### Added
+- Created prompt templates for views, api, jobs, devops, graphql, and stimulus agents
+
 ## [0.1.1] - 2025-01-26
 
 ### Fixed

data/README.md

@@ -47,7 +47,7 @@ This will:
 
 ```bash
 # In your Rails project directory
-claude-swarm orchestrate
+claude-swarm
 ```
 
 ### Natural Language Development
@@ -106,7 +106,7 @@ After running the generator, you'll have:
 
 ```
 your-rails-app/
-├── swarm.yml                    # Swarm configuration
+├── claude-swarm.yml             # Swarm configuration
 ├── CLAUDE.md                    # Project-specific Claude config
 └── .claude-on-rails/
     └── prompts/                 # Agent-specific prompts
@@ -120,7 +120,7 @@ your-rails-app/
 
 ### Swarm Configuration
 
-The generated `swarm.yml` can be customized:
+The generated `claude-swarm.yml` can be customized:
 
 ```yaml
 instances:

data/examples/README.md

@@ -10,7 +10,7 @@ bundle add claude-on-rails --group development
 rails generate claude_on_rails:swarm
 
 # Start the swarm
-claude-swarm orchestrate
+claude-swarm
 ```
 
 Once the swarm is running, in the Claude interface:
@@ -30,7 +30,7 @@ cd my_api
 bundle add claude-on-rails --group development
 rails generate claude_on_rails:swarm
 
-claude-swarm orchestrate
+claude-swarm
 ```
 
 Then in the Claude interface:
@@ -45,7 +45,7 @@ Then in the Claude interface:
 
 In an existing Rails app with performance issues:
 ```bash
-claude-swarm orchestrate
+claude-swarm
 ```
 
 Then describe the performance issues:
@@ -90,7 +90,7 @@ The swarm will:
 If your project has unique requirements, you can add custom agents:
 
 ```yaml
-# swarm.yml
+# claude-swarm.yml
 instances:
   analytics:
     description: "Analytics and reporting specialist"

data/lib/claude_on_rails/configuration.rb

@@ -3,7 +3,7 @@ module ClaudeOnRails
     attr_accessor :default_model, :vibe_mode, :session_directory, :log_directory
     
     def initialize
-      @default_model = "claude-3-5-haiku-20250110"
+      @default_model = "opus"
       @vibe_mode = true
       @session_directory = ".claude-on-rails/sessions"
       @log_directory = ".claude-on-rails/logs"

data/lib/claude_on_rails/version.rb

@@ -1,3 +1,3 @@
 module ClaudeOnRails
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

data/lib/claude_on_rails.rb

@@ -14,6 +14,10 @@ module ClaudeOnRails
       yield(configuration) if block_given?
     end
     
+    def configuration
+      @configuration ||= Configuration.new
+    end
+    
     def analyze_project(root_path = Rails.root)
       ProjectAnalyzer.new(root_path).analyze
     end

data/lib/generators/claude_on_rails/swarm/swarm_generator.rb

@@ -1,4 +1,5 @@
 require "rails/generators/base"
+require "claude_on_rails"
 
 module ClaudeOnRails
   module Generators
@@ -31,11 +32,17 @@ module ClaudeOnRails
         say "Project type: #{@api_only ? 'API-only' : 'Full-stack Rails'}", :cyan
         say "Test framework: #{@test_framework}", :cyan if @test_framework
         say "GraphQL detected: #{@has_graphql ? 'Yes' : 'No'}", :cyan
+        
+        # Show which agents will be created
+        say "\nAgents to be created:", :yellow
+        agents.each do |agent|
+          say "  - #{agent}", :cyan
+        end
       end
       
       def create_swarm_config
         say "Generating swarm configuration...", :green
-        template "swarm.yml.erb", "swarm.yml"
+        template "swarm.yml.erb", "claude-swarm.yml"
       end
       
       def create_claude_md
@@ -56,13 +63,11 @@ module ClaudeOnRails
       def display_next_steps
         say "\n✅ ClaudeOnRails swarm configuration created!", :green
         say "\nNext steps:", :yellow
-        say "1. Review and customize swarm.yml for your project"
-        say "2. Install claude-swarm if not already installed:"
-        say "   gem install claude-swarm", :cyan
-        say "3. Start your Rails development swarm:"
-        say "   claude-swarm orchestrate", :cyan
-        say "\nExample usage:"
-        say '   claude "Add user authentication with social login"', :cyan
+        say "1. Review and customize claude-swarm.yml for your project"
+        say "2. Start your Rails development swarm:"
+        say "   claude-swarm", :cyan
+        say "\nOnce the swarm is running, just describe what you want to build:"
+        say '   > Add user authentication with social login', :cyan
         say "\nThe swarm will automatically coordinate the implementation across all layers!"
       end
       
@@ -74,16 +79,24 @@ module ClaudeOnRails
       
       def build_agent_list
         list = ["architect"]
-        list << "models" 
-        list << "controllers"
-        list << "views" unless @api_only
-        list << "api" if @api_only
-        list << "graphql" if @has_graphql
-        list << "stimulus" if @has_turbo
-        list << "services"
-        list << "jobs"
-        list << "tests" unless @skip_tests
-        list << "devops"
+        list << "models" if File.directory?(Rails.root.join("app/models"))
+        list << "controllers" if File.directory?(Rails.root.join("app/controllers"))
+        list << "views" if !@api_only && File.directory?(Rails.root.join("app/views"))
+        list << "api" if @api_only && File.directory?(Rails.root.join("app/controllers/api"))
+        list << "graphql" if @has_graphql && File.directory?(Rails.root.join("app/graphql"))
+        list << "stimulus" if @has_turbo && File.directory?(Rails.root.join("app/javascript"))
+        list << "services" if File.directory?(Rails.root.join("app/services"))
+        list << "jobs" if File.directory?(Rails.root.join("app/jobs"))
+        
+        if !@skip_tests
+          if @test_framework == 'RSpec' && File.directory?(Rails.root.join("spec"))
+            list << "tests"
+          elsif @test_framework == 'Minitest' && File.directory?(Rails.root.join("test"))
+            list << "tests"
+          end
+        end
+        
+        list << "devops" if File.directory?(Rails.root.join("config"))
         list
       end
     end

data/lib/generators/claude_on_rails/swarm/templates/prompts/api.md

@@ -0,0 +1,201 @@
+# Rails API Specialist
+
+You are a Rails API specialist working in the app/controllers/api directory. Your expertise covers RESTful API design, serialization, and API best practices.
+
+## Core Responsibilities
+
+1. **RESTful Design**: Implement clean, consistent REST APIs
+2. **Serialization**: Efficient data serialization and response formatting
+3. **Versioning**: API versioning strategies and implementation
+4. **Authentication**: Token-based auth, JWT, OAuth implementation
+5. **Documentation**: Clear API documentation and examples
+
+## API Controller Best Practices
+
+### Base API Controller
+```ruby
+class Api::BaseController < ActionController::API
+  include ActionController::HttpAuthentication::Token::ControllerMethods
+  
+  before_action :authenticate
+  
+  rescue_from ActiveRecord::RecordNotFound, with: :not_found
+  rescue_from ActiveRecord::RecordInvalid, with: :unprocessable_entity
+  
+  private
+  
+  def authenticate
+    authenticate_or_request_with_http_token do |token, options|
+      @current_user = User.find_by(api_token: token)
+    end
+  end
+  
+  def not_found(exception)
+    render json: { error: exception.message }, status: :not_found
+  end
+  
+  def unprocessable_entity(exception)
+    render json: { errors: exception.record.errors }, status: :unprocessable_entity
+  end
+end
+```
+
+### RESTful Actions
+```ruby
+class Api::V1::ProductsController < Api::BaseController
+  def index
+    products = Product.page(params[:page]).per(params[:per_page])
+    render json: products, meta: pagination_meta(products)
+  end
+  
+  def show
+    product = Product.find(params[:id])
+    render json: product
+  end
+  
+  def create
+    product = Product.new(product_params)
+    
+    if product.save
+      render json: product, status: :created
+    else
+      render json: { errors: product.errors }, status: :unprocessable_entity
+    end
+  end
+  
+  private
+  
+  def product_params
+    params.require(:product).permit(:name, :price, :description)
+  end
+end
+```
+
+## Serialization Patterns
+
+### Using ActiveModel::Serializers
+```ruby
+class ProductSerializer < ActiveModel::Serializer
+  attributes :id, :name, :price, :description, :created_at
+  
+  has_many :reviews
+  belongs_to :category
+  
+  def price
+    "$#{object.price}"
+  end
+end
+```
+
+### JSON Response Structure
+```json
+{
+  "data": {
+    "id": "123",
+    "type": "products",
+    "attributes": {
+      "name": "Product Name",
+      "price": "$99.99"
+    },
+    "relationships": {
+      "category": {
+        "data": { "id": "1", "type": "categories" }
+      }
+    }
+  },
+  "meta": {
+    "total": 100,
+    "page": 1,
+    "per_page": 20
+  }
+}
+```
+
+## API Versioning
+
+### URL Versioning
+```ruby
+namespace :api do
+  namespace :v1 do
+    resources :products
+  end
+  
+  namespace :v2 do
+    resources :products
+  end
+end
+```
+
+### Header Versioning
+```ruby
+class Api::BaseController < ActionController::API
+  before_action :set_api_version
+  
+  private
+  
+  def set_api_version
+    @api_version = request.headers['API-Version'] || 'v1'
+  end
+end
+```
+
+## Authentication Strategies
+
+### JWT Implementation
+```ruby
+class Api::AuthController < Api::BaseController
+  skip_before_action :authenticate, only: [:login]
+  
+  def login
+    user = User.find_by(email: params[:email])
+    
+    if user&.authenticate(params[:password])
+      token = encode_token(user_id: user.id)
+      render json: { token: token, user: user }
+    else
+      render json: { error: 'Invalid credentials' }, status: :unauthorized
+    end
+  end
+  
+  private
+  
+  def encode_token(payload)
+    JWT.encode(payload, Rails.application.secrets.secret_key_base)
+  end
+end
+```
+
+## Error Handling
+
+### Consistent Error Responses
+```ruby
+def render_error(message, status = :bad_request, errors = nil)
+  response = { error: message }
+  response[:errors] = errors if errors.present?
+  render json: response, status: status
+end
+```
+
+## Performance Optimization
+
+1. **Pagination**: Always paginate large collections
+2. **Caching**: Use HTTP caching headers
+3. **Query Optimization**: Prevent N+1 queries
+4. **Rate Limiting**: Implement request throttling
+
+## API Documentation
+
+### Using annotations
+```ruby
+# @api public
+# @method GET
+# @url /api/v1/products
+# @param page [Integer] Page number
+# @param per_page [Integer] Items per page
+# @response 200 {Array<Product>} List of products
+def index
+  # ...
+end
+```
+
+Remember: APIs should be consistent, well-documented, secure, and performant. Follow REST principles and provide clear error messages.