QueryWise 0.2.3 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67032dac0dfc045a96109882a8ec023df8fe35b9f4a77c4be2e9cd2b962a4471
-  data.tar.gz: 26aa44b5dc1f87085ef5ab21d87e2b3125266b86d716570c9e2431a642366b25
+  metadata.gz: 1054fa9e712ee211b953b341da4a29183c85b3dd0aa4303818e6b300b15bde04
+  data.tar.gz: b08cacfd54a45d587e4ae6e0bdcb720f74359d96eb1dba9c9ad0c4f5ef245b89
 SHA512:
-  metadata.gz: c2fe0bc5a60b08fd76f6cdbe51c7b10cef31add0cc642451c39b202a7da096cfaf49b4ae63d1499c41aa1978f239632b6011b170c49a101102b687bca0f8602b
-  data.tar.gz: a4fd8daa5be4b26ccda0650eb5a25176838c2da0c553553258d164d1c6a1013f0bbb9f6d7258970642cb68bfdb12a6a73090383321bedf1b71adb307a2795a1e
+  metadata.gz: ba2c980bcd16e9bee22c30bb51e09674c0cd2d88d3c194aa9b7736f903e8278b9ba6e519052f5cd08fc77e5fe2e9bcef0720d86bef359e6c50f36cb13966ae22
+  data.tar.gz: a18e469a91d16e9e5923e7f75f67081a16bde822cfaa0828f56540685614a2a72260a4dafdac7c82a7b0cdf06d236a751540bf94d8dff451f0757e31dd23f863

data/INSTALLATION.md

@@ -0,0 +1,197 @@
+# QueryWise Installation Guide
+
+This guide provides step-by-step instructions for integrating QueryWise into your Rails application.
+
+## Quick Start
+
+### 1. Add to Gemfile
+
+Add QueryWise to your Rails application's Gemfile:
+
+```ruby
+gem 'QueryWise'
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+### 2. Run Installation Script
+
+QueryWise provides an easy installation script that sets up all necessary configuration files:
+
+```bash
+# Option 1: Using the bundled script
+bundle exec ruby -e "require 'query_optimizer_client/install'; QueryOptimizerClient::Install.run"
+
+# Option 2: Using rake task (if available)
+bundle exec rake query_optimizer:install
+
+# Option 3: Download and run the standalone script
+curl -fsSL https://raw.githubusercontent.com/your-username/QueryWise/main/bin/query_wise_install | ruby
+```
+
+### 3. Configure Your API Credentials
+
+Update the generated `.env` file with your API credentials:
+
+```bash
+# .env
+QUERY_OPTIMIZER_API_URL=https://your-api-endpoint.com/api/v1
+QUERY_OPTIMIZER_API_KEY=your_api_key_here
+QUERY_OPTIMIZER_ENABLED=true
+```
+
+### 4. Restart Your Rails Server
+
+```bash
+rails server
+```
+
+## What Gets Installed
+
+The installation script creates the following files:
+
+### Configuration Files
+
+1. **`config/initializers/query_optimizer_client.rb`** - Main configuration
+2. **`.env.example`** - Environment variables template
+3. **`.env`** - Your environment variables (if it doesn't exist)
+
+### Background Job
+
+4. **`app/jobs/query_optimizer_client/analysis_job.rb`** - Background job for query analysis
+
+## Manual Installation
+
+If you prefer to set up the files manually:
+
+### 1. Create Initializer
+
+Create `config/initializers/query_optimizer_client.rb`:
+
+```ruby
+# frozen_string_literal: true
+
+QueryOptimizerClient.configure do |config|
+  # API Configuration
+  config.api_url = ENV.fetch('QUERY_OPTIMIZER_API_URL', 'https://your-api-url.com/api/v1')
+  config.api_key = ENV.fetch('QUERY_OPTIMIZER_API_KEY', nil)
+  
+  # Feature toggles
+  config.enabled = ENV.fetch('QUERY_OPTIMIZER_ENABLED', 'true') == 'true'
+  config.auto_analyze = ENV.fetch('QUERY_OPTIMIZER_AUTO_ANALYZE', 'false') == 'true'
+  
+  # Performance thresholds
+  config.slow_query_threshold = ENV.fetch('QUERY_OPTIMIZER_THRESHOLD', '100').to_i
+  
+  # Logging
+  config.log_level = ENV.fetch('QUERY_OPTIMIZER_LOG_LEVEL', 'info').to_sym
+  
+  # Analysis settings
+  config.batch_size = ENV.fetch('QUERY_OPTIMIZER_BATCH_SIZE', '10').to_i
+  config.analysis_interval = ENV.fetch('QUERY_OPTIMIZER_ANALYSIS_INTERVAL', '300').to_i
+end
+```
+
+### 2. Create Background Job
+
+Create `app/jobs/query_optimizer_client/analysis_job.rb`:
+
+```ruby
+# frozen_string_literal: true
+
+module QueryOptimizerClient
+  class AnalysisJob < ApplicationJob
+    queue_as :default
+    
+    def perform(queries)
+      return unless QueryOptimizerClient.configuration.enabled?
+      
+      client = QueryOptimizerClient.client
+      
+      begin
+        result = client.analyze_queries(queries)
+        Rails.logger.info "Query analysis completed: #{result.inspect}"
+      rescue => e
+        Rails.logger.error "Query analysis failed: #{e.message}"
+        raise e
+      end
+    end
+  end
+end
+```
+
+### 3. Add Environment Variables
+
+Add to your `.env` file:
+
+```bash
+# Query Optimizer Client Configuration
+QUERY_OPTIMIZER_API_URL=https://your-api-url.com/api/v1
+QUERY_OPTIMIZER_API_KEY=your_api_key_here
+QUERY_OPTIMIZER_ENABLED=true
+QUERY_OPTIMIZER_AUTO_ANALYZE=false
+QUERY_OPTIMIZER_THRESHOLD=100
+QUERY_OPTIMIZER_LOG_LEVEL=info
+QUERY_OPTIMIZER_BATCH_SIZE=10
+QUERY_OPTIMIZER_ANALYSIS_INTERVAL=300
+```
+
+## Configuration Options
+
+| Environment Variable | Default | Description |
+|---------------------|---------|-------------|
+| `QUERY_OPTIMIZER_API_URL` | - | Your QueryWise API endpoint |
+| `QUERY_OPTIMIZER_API_KEY` | - | Your API key |
+| `QUERY_OPTIMIZER_ENABLED` | `true` | Enable/disable the client |
+| `QUERY_OPTIMIZER_AUTO_ANALYZE` | `false` | Automatically analyze queries |
+| `QUERY_OPTIMIZER_THRESHOLD` | `100` | Slow query threshold (ms) |
+| `QUERY_OPTIMIZER_LOG_LEVEL` | `info` | Logging level |
+| `QUERY_OPTIMIZER_BATCH_SIZE` | `10` | Batch size for analysis |
+| `QUERY_OPTIMIZER_ANALYSIS_INTERVAL` | `300` | Analysis interval (seconds) |
+
+## Verification
+
+After installation, you can verify everything is working:
+
+```bash
+# Check configuration status
+bundle exec rake query_optimizer:check
+
+# Test API connection
+bundle exec rake query_optimizer:analyze
+```
+
+## Troubleshooting
+
+### Installation Issues
+
+1. **Permission errors**: Make sure you have write permissions in your Rails app directory
+2. **Missing directories**: The script will create necessary directories automatically
+3. **Existing files**: The script won't overwrite existing configuration files
+
+### Configuration Issues
+
+1. **API connection fails**: Check your API URL and key
+2. **Queries not being analyzed**: Ensure `QUERY_OPTIMIZER_ENABLED=true`
+3. **Background jobs not running**: Check your job queue configuration
+
+## Next Steps
+
+After installation:
+
+1. [Configure your middleware](MIDDLEWARE.md)
+2. [Set up automatic analysis](ANALYSIS.md)
+3. [Customize optimization rules](CONFIGURATION.md)
+4. [Monitor performance](MONITORING.md)
+
+## Support
+
+If you encounter any issues during installation:
+
+1. Check the [troubleshooting guide](TROUBLESHOOTING.md)
+2. Review the [configuration documentation](CONFIGURATION.md)
+3. Open an issue on [GitHub](https://github.com/your-username/QueryWise/issues)

data/README.md

@@ -35,16 +35,26 @@ bundle install
 
 ### Step 2: Generate Configuration Files (1 minute)
 
-Run the installation generator:
+Run the installation command:
 
 ```bash
-rails generate QueryWise:install
+# Option 1: Ruby command (recommended)
+bundle exec ruby -e "require 'query_optimizer_client/install'; QueryOptimizerClient::Install.run"
+
+# Option 2: Rake task
+bundle exec rake query_optimizer:install
+
+# Option 3: Standalone script
+curl -fsSL https://raw.githubusercontent.com/your-username/QueryWise/main/bin/query_wise_install | ruby
 ```
 
 This creates:
 - `config/initializers/query_optimizer_client.rb` - Configuration file
 - `app/jobs/query_optimizer_client/analysis_job.rb` - Background job
-- `.env` file with configuration template
+- `.env.example` - Environment variables template
+- Updates your `.env` file with configuration options
+
+> **Note**: The `rails generate QueryWise:install` command is not currently supported due to Rails generator namespace complexities. Use the methods above instead. For detailed installation instructions, see [INSTALLATION.md](INSTALLATION.md).
 
 ### Step 3: Set Up API Connection (5 minutes)
 

data/lib/generators/query_wise/install_generator.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+
+module QueryWise
+  class InstallGenerator < Rails::Generators::Base
+      desc "Install QueryWise"
+      
+      source_root File.expand_path('templates', __dir__)
+      
+      def create_initializer
+        template 'initializer.rb', 'config/initializers/query_optimizer_client.rb'
+      end
+      
+      def create_job
+        template 'analysis_job.rb', 'app/jobs/query_optimizer_client/analysis_job.rb'
+      end
+      
+      def add_environment_variables
+        environment_template = <<~ENV
+          # Query Optimizer Client Configuration
+          # QUERY_OPTIMIZER_API_URL=http://localhost:3000/api/v1
+          # QUERY_OPTIMIZER_API_KEY=your_api_key_here
+          # QUERY_OPTIMIZER_ENABLED=true
+          # QUERY_OPTIMIZER_THRESHOLD=80
+        ENV
+
+        # Create or append to .env.example
+        if File.exist?('.env.example')
+          append_to_file '.env.example', environment_template
+        else
+          create_file '.env.example', environment_template
+        end
+
+        # Create or append to .env
+        if File.exist?('.env')
+          append_to_file '.env', environment_template
+        else
+          create_file '.env', environment_template
+        end
+      end
+      
+      def show_readme
+        readme 'README'
+      end
+    end
+  end

data/lib/generators/query_wise/templates/README

@@ -0,0 +1,46 @@
+===============================================================================
+
+  QueryWise has been installed!
+
+===============================================================================
+
+Next steps:
+
+1. Set up your environment variables:
+   
+   Add to your .env file:
+   QUERY_OPTIMIZER_API_URL=http://localhost:3000/api/v1
+   QUERY_OPTIMIZER_API_KEY=your_api_key_here
+   QUERY_OPTIMIZER_ENABLED=true
+
+2. Generate an API key (if you don't have one):
+   
+   rails query_optimizer:generate_key["My App Name"]
+
+3. Test your configuration:
+   
+   rails query_optimizer:check
+
+4. Run a sample analysis:
+   
+   rails query_optimizer:analyze
+
+5. Set up CI/CD integration:
+   
+   Add to your CI pipeline:
+   rails query_optimizer:ci[85]
+
+6. Customize the configuration in:
+   
+   config/initializers/query_optimizer_client.rb
+
+7. Optional: Customize the analysis job in:
+   
+   app/jobs/query_optimizer_client/analysis_job.rb
+
+===============================================================================
+
+For more information, visit:
+https://github.com/yourusername/query_optimizer_client
+
+===============================================================================

data/lib/generators/query_wise/templates/analysis_job.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module QueryOptimizerClient
+  class AnalysisJob < ApplicationJob
+    queue_as :default
+    
+    def perform(queries, endpoint = nil)
+      return unless QueryOptimizerClient.enabled?
+      
+      result = QueryOptimizerClient.analyze_queries(queries)
+      
+      return unless result&.dig('success')
+      
+      data = result['data']
+      score = data['summary']['optimization_score']
+      
+      # Log analysis results
+      log_analysis_results(data, endpoint)
+      
+      # Store results (optional - implement based on your needs)
+      store_analysis_results(data, endpoint) if respond_to?(:store_analysis_results, true)
+      
+      # Send alerts if performance is poor
+      send_alerts(data, endpoint, score) if score < 70
+      
+    rescue => e
+      Rails.logger.error "Query analysis failed: #{e.message}"
+      Rails.logger.error e.backtrace.join("\n") if Rails.env.development?
+    end
+    
+    private
+    
+    def log_analysis_results(data, endpoint)
+      endpoint_info = endpoint ? " on #{endpoint}" : ""
+      
+      Rails.logger.info "Query analysis completed#{endpoint_info}: Score #{data['summary']['optimization_score']}%, #{data['summary']['issues_found']} issues found"
+      
+      # Log N+1 queries
+      if data['n_plus_one']['detected']
+        Rails.logger.warn "N+1 queries detected#{endpoint_info}:"
+        data['n_plus_one']['patterns'].each do |pattern|
+          Rails.logger.warn "  - #{pattern['table']}.#{pattern['column']}: #{pattern['suggestion']}"
+        end
+      end
+      
+      # Log slow queries
+      data['slow_queries'].each do |query|
+        Rails.logger.warn "Slow query#{endpoint_info} (#{query['duration_ms']}ms): #{query['sql'][0..100]}..."
+        query['suggestions'].each do |suggestion|
+          Rails.logger.warn "  💡 #{suggestion}"
+        end
+      end
+      
+      # Log missing indexes
+      data['missing_indexes'].each do |index|
+        Rails.logger.info "Missing index suggestion#{endpoint_info}: #{index['sql']}"
+      end
+    end
+    
+    def send_alerts(data, endpoint, score)
+      endpoint_info = endpoint ? " on #{endpoint}" : ""
+      
+      if score < 50
+        Rails.logger.error "🚨 CRITICAL: Very low performance score (#{score}%)#{endpoint_info}"
+        # Add your critical alerting logic here (Slack, email, etc.)
+      elsif score < 70
+        Rails.logger.warn "⚠️ WARNING: Low performance score (#{score}%)#{endpoint_info}"
+        # Add your warning alerting logic here
+      end
+    end
+    
+    # Optional: Implement this method to store analysis results in your database
+    # def store_analysis_results(data, endpoint)
+    #   PerformanceAnalysis.create!(
+    #     endpoint: endpoint,
+    #     optimization_score: data['summary']['optimization_score'],
+    #     issues_found: data['summary']['issues_found'],
+    #     total_queries: data['summary']['total_queries'],
+    #     analysis_data: data,
+    #     analyzed_at: Time.current
+    #   )
+    # end
+  end
+end

data/lib/generators/query_wise/templates/initializer.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+QueryOptimizerClient.configure do |config|
+  # API Configuration
+  config.api_url = ENV.fetch('QUERY_OPTIMIZER_API_URL', 'http://localhost:3000/api/v1')
+  config.api_key = ENV['QUERY_OPTIMIZER_API_KEY']
+  config.enabled = ENV.fetch('QUERY_OPTIMIZER_ENABLED', 'false') == 'true'
+  
+  # Request Configuration
+  config.timeout = ENV.fetch('QUERY_OPTIMIZER_TIMEOUT', '30').to_i
+  config.retries = ENV.fetch('QUERY_OPTIMIZER_RETRIES', '3').to_i
+  config.batch_size = ENV.fetch('QUERY_OPTIMIZER_BATCH_SIZE', '50').to_i
+  
+  # Analysis Configuration
+  config.default_threshold = ENV.fetch('QUERY_OPTIMIZER_THRESHOLD', '80').to_i
+  config.rate_limit_retry = ENV.fetch('QUERY_OPTIMIZER_RATE_LIMIT_RETRY', 'true') == 'true'
+  
+  # Logging
+  config.logger = Rails.logger
+end
+
+# Optional: Configure Rails-specific settings
+Rails.application.configure do
+  # Middleware configuration
+  config.query_optimizer_client.min_queries = 3
+  config.query_optimizer_client.min_duration = 10
+  config.query_optimizer_client.skip_paths = ['/assets', '/health', '/api']
+  config.query_optimizer_client.async = true
+  config.query_optimizer_client.job_class = 'QueryOptimizerClient::AnalysisJob'
+end

data/lib/generators/query_wise_generator.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+
+class QueryWiseGenerator < Rails::Generators::Base
+  desc "Install QueryWise gem"
+  
+  source_root File.expand_path('query_optimizer_client/generators/templates', __dir__)
+  
+  def create_initializer
+    template 'initializer.rb', 'config/initializers/query_optimizer_client.rb'
+  end
+  
+  def create_job
+    template 'analysis_job.rb', 'app/jobs/query_optimizer_client/analysis_job.rb'
+  end
+  
+  def add_environment_variables
+    environment_template = <<~ENV
+      # Query Optimizer Client Configuration
+      # QUERY_OPTIMIZER_API_URL=http://localhost:3000/api/v1
+      # QUERY_OPTIMIZER_API_KEY=your_api_key_here
+      # QUERY_OPTIMIZER_ENABLED=true
+      # QUERY_OPTIMIZER_THRESHOLD=80
+    ENV
+    
+    # Create or append to .env.example
+    if File.exist?('.env.example')
+      append_to_file '.env.example', environment_template
+    else
+      create_file '.env.example', environment_template
+    end
+    
+    # Create or append to .env
+    if File.exist?('.env')
+      append_to_file '.env', environment_template
+    else
+      create_file '.env', environment_template
+    end
+  end
+  
+  def show_readme
+    readme 'README'
+  end
+end

data/lib/query_optimizer_client/generators/install_generator.rb

@@ -25,9 +25,15 @@ module QueryWise
           # QUERY_OPTIMIZER_ENABLED=true
           # QUERY_OPTIMIZER_THRESHOLD=80
         ENV
-        
-        append_to_file '.env.example', environment_template
-        
+
+        # Create or append to .env.example
+        if File.exist?('.env.example')
+          append_to_file '.env.example', environment_template
+        else
+          create_file '.env.example', environment_template
+        end
+
+        # Create or append to .env
         if File.exist?('.env')
           append_to_file '.env', environment_template
         else

data/lib/query_optimizer_client/install.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module QueryOptimizerClient
+  class Install
+    def self.run
+      new.run
+    end
+    
+    def run
+      puts "Installing QueryWise..."
+      
+      create_initializer
+      create_job
+      create_environment_files
+      
+      puts "\n✅ QueryWise installation complete!"
+      puts "\nNext steps:"
+      puts "1. Update your .env file with your API credentials"
+      puts "2. Configure the initializer in config/initializers/query_optimizer_client.rb"
+      puts "3. Restart your Rails server"
+      puts "\nFor more information, visit: https://github.com/your-username/QueryWise"
+    end
+    
+    private
+    
+    def create_initializer
+      initializer_path = 'config/initializers/query_optimizer_client.rb'
+      
+      if File.exist?(initializer_path)
+        puts "⚠️  Initializer already exists at #{initializer_path}"
+        return
+      end
+      
+      initializer_content = <<~RUBY
+        # frozen_string_literal: true
+        
+        QueryOptimizerClient.configure do |config|
+          # API Configuration
+          config.api_url = ENV.fetch('QUERY_OPTIMIZER_API_URL', 'https://your-api-url.com/api/v1')
+          config.api_key = ENV.fetch('QUERY_OPTIMIZER_API_KEY', nil)
+          
+          # Feature toggles
+          config.enabled = ENV.fetch('QUERY_OPTIMIZER_ENABLED', 'true') == 'true'
+          config.auto_analyze = ENV.fetch('QUERY_OPTIMIZER_AUTO_ANALYZE', 'false') == 'true'
+          
+          # Performance thresholds
+          config.slow_query_threshold = ENV.fetch('QUERY_OPTIMIZER_THRESHOLD', '100').to_i
+          
+          # Logging
+          config.log_level = ENV.fetch('QUERY_OPTIMIZER_LOG_LEVEL', 'info').to_sym
+          
+          # Analysis settings
+          config.batch_size = ENV.fetch('QUERY_OPTIMIZER_BATCH_SIZE', '10').to_i
+          config.analysis_interval = ENV.fetch('QUERY_OPTIMIZER_ANALYSIS_INTERVAL', '300').to_i
+        end
+      RUBY
+      
+      File.write(initializer_path, initializer_content)
+      puts "✅ Created initializer: #{initializer_path}"
+    end
+    
+    def create_job
+      job_dir = 'app/jobs/query_optimizer_client'
+      job_path = File.join(job_dir, 'analysis_job.rb')
+      
+      if File.exist?(job_path)
+        puts "⚠️  Job already exists at #{job_path}"
+        return
+      end
+      
+      FileUtils.mkdir_p(job_dir)
+      
+      job_content = <<~RUBY
+        # frozen_string_literal: true
+        
+        module QueryOptimizerClient
+          class AnalysisJob < ApplicationJob
+            queue_as :default
+            
+            def perform(queries)
+              return unless QueryOptimizerClient.configuration.enabled?
+              
+              client = QueryOptimizerClient.client
+              
+              begin
+                result = client.analyze_queries(queries)
+                Rails.logger.info "Query analysis completed: \#{result.inspect}"
+              rescue => e
+                Rails.logger.error "Query analysis failed: \#{e.message}"
+                raise e
+              end
+            end
+          end
+        end
+      RUBY
+      
+      File.write(job_path, job_content)
+      puts "✅ Created job: #{job_path}"
+    end
+    
+    def create_environment_files
+      env_content = <<~ENV
+        # Query Optimizer Client Configuration
+        QUERY_OPTIMIZER_API_URL=https://your-api-url.com/api/v1
+        QUERY_OPTIMIZER_API_KEY=your_api_key_here
+        QUERY_OPTIMIZER_ENABLED=true
+        QUERY_OPTIMIZER_AUTO_ANALYZE=false
+        QUERY_OPTIMIZER_THRESHOLD=100
+        QUERY_OPTIMIZER_LOG_LEVEL=info
+        QUERY_OPTIMIZER_BATCH_SIZE=10
+        QUERY_OPTIMIZER_ANALYSIS_INTERVAL=300
+      ENV
+      
+      # Create .env.example
+      if File.exist?('.env.example')
+        File.write('.env.example', File.read('.env.example') + "\n" + env_content)
+        puts "✅ Updated .env.example"
+      else
+        File.write('.env.example', env_content)
+        puts "✅ Created .env.example"
+      end
+      
+      # Create .env if it doesn't exist
+      unless File.exist?('.env')
+        File.write('.env', env_content)
+        puts "✅ Created .env"
+      else
+        puts "⚠️  .env already exists - please add the configuration manually"
+      end
+    end
+  end
+end

data/lib/query_optimizer_client/railtie.rb

@@ -31,7 +31,7 @@ module QueryOptimizerClient
     end
 
     generators do
-      require "query_optimizer_client/generators/install_generator"
+      require "generators/query_wise_generator"
     end
   end
 end

data/lib/query_optimizer_client/tasks.rake

@@ -1,6 +1,12 @@
 # frozen_string_literal: true
 
+require_relative 'install'
+
 namespace :query_optimizer do
+  desc "Install QueryWise configuration files"
+  task :install do
+    QueryOptimizerClient::Install.run
+  end
   desc "Check configuration and connectivity"
   task check: :environment do
     puts "🔍 Query Optimizer Client Configuration Check"

data/lib/query_optimizer_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module QueryOptimizerClient
-  VERSION = "0.2.3"
+  VERSION = "1.0.0"
 end

data/lib/query_optimizer_client.rb

@@ -4,8 +4,8 @@ require_relative "query_optimizer_client/version"
 require_relative "query_optimizer_client/client"
 require_relative "query_optimizer_client/configuration"
 require_relative "query_optimizer_client/middleware"
+require_relative "query_optimizer_client/install"
 require_relative "query_optimizer_client/railtie" if defined?(Rails)
-require_relative "query_optimizer_client/generators/install_generator" if defined?(Rails)
 
 module QueryOptimizerClient
   class Error < StandardError; end

data/query_optimizer_client.gemspec

@@ -54,6 +54,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "vcr", "~> 6.1"
   spec.add_development_dependency "rails", "~> 8.0"
   spec.add_development_dependency "sqlite3", "~> 1.4"
+  spec.add_development_dependency "generator_spec", "~> 0.10"
 
   # For more information and examples about making a new gem, check out our
   # guide at: https://bundler.io/guides/creating_gem.html

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: QueryWise
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 1.0.0
 platform: ruby
 authors:
 - Blair Lane
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
 date: 2025-08-30 00:00:00.000000000 Z
@@ -142,6 +142,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: generator_spec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
 description: QueryWise is a lightweight, developer-friendly tool that helps Ruby on
   Rails teams detect, analyze, and fix inefficient database queries. Automatically
   detect N+1 queries, slow queries, and missing indexes without needing heavy, expensive
@@ -162,6 +176,7 @@ files:
 - GEM_README.md
 - GEM_Rakefile
 - GEM_gitignore
+- INSTALLATION.md
 - LICENSE.txt
 - PUBLISHING_GUIDE.md
 - QUERYWISE_INSTALL.md
@@ -222,6 +237,11 @@ files:
 - db/schema.rb
 - db/seeds.rb
 - init.sql
+- lib/generators/query_wise/install_generator.rb
+- lib/generators/query_wise/templates/README
+- lib/generators/query_wise/templates/analysis_job.rb
+- lib/generators/query_wise/templates/initializer.rb
+- lib/generators/query_wise_generator.rb
 - lib/query_optimizer_client.rb
 - lib/query_optimizer_client/client.rb
 - lib/query_optimizer_client/configuration.rb
@@ -229,6 +249,7 @@ files:
 - lib/query_optimizer_client/generators/templates/README
 - lib/query_optimizer_client/generators/templates/analysis_job.rb
 - lib/query_optimizer_client/generators/templates/initializer.rb
+- lib/query_optimizer_client/install.rb
 - lib/query_optimizer_client/middleware.rb
 - lib/query_optimizer_client/railtie.rb
 - lib/query_optimizer_client/tasks.rake
@@ -250,7 +271,7 @@ metadata:
   source_code_uri: https://github.com/BlairLane22/QueryWise
   changelog_uri: https://github.com/BlairLane22/QueryWise/blob/main/CHANGELOG.md
   documentation_uri: https://github.com/BlairLane22/QueryWise/blob/main/README.md
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -265,8 +286,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 3.4.10
+signing_key:
 specification_version: 4
 summary: QueryWise - Rails Database Query Optimizer
 test_files: []