rails_pulse 0.2.5.pre.11 → 0.2.5.pre.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ce571d5ae696930e4885ac654389e354ef235f0b071046b95bfbd1089b92015d
-  data.tar.gz: 1b77c49cc62356cc0faa30b641cde07998ce6252c6ef155386dbd2ac6dbbeea4
+  metadata.gz: 14471ad08eb69ba71cfa596ede0a58f1638a5d17cd6ff18c161ada4fc92524a8
+  data.tar.gz: d823c824b84c21b6b3b6b6eec433d1b7774b60c14e5ec6b1a4a54b32886499b4
 SHA512:
-  metadata.gz: 7f2c84081607cc389a4098c3bd70c1df2a396aa2c569befff183f13d8dceb2b6e884559df26ac49b7c2cd10b79490e9e6d0366eb582450f85fdb02e938e1f75b
-  data.tar.gz: 6d096ff11eca6bd80968118bcb041ffb4dbd13ff58bf1108a69dec4eaefef44e229dba5700039b43cb4f55532fc16f25ed6ca4eb96b7d3e2243f2bd038ca3279
+  metadata.gz: bb0ea2202d39365fe7a6751090a888909479336d7c3b1977b8095cb0cddae8f00d896be95d53c8c402e03ee34b477127192fc5f9873c008e8d4ca11944467fcc
+  data.tar.gz: c1db7e38744e0476a629be2d88e0e5adf66bbd23a2db93c0657512de19d7aefe003270eb39d53d61f7d9d9b72634afaf7de10e89d650a697e85d9abaed6a353f

data/README.md

@@ -43,7 +43,6 @@
   - [Database Configuration](#database-configuration)
   - [Schema Loading](#schema-loading)
 - [Performance Impact](#performance-impact)
-  - [Running Performance Benchmarks](#running-performance-benchmarks)
 - [Standalone Dashboard Deployment](#standalone-dashboard-deployment)
 - [Testing](#testing)
 - [Technology Stack](#technology-stack)
@@ -648,28 +647,6 @@ Rails Pulse uses **fiber-based async tracking** for minimal performance overhead
 
 This is handled automatically and requires no configuration.
 
-### Running Performance Benchmarks
-
-Rails Pulse includes built-in benchmarking tools. To use them:
-
-```ruby
-# Add to your Gemfile (development/test group)
-gem 'benchmark-ips'
-gem 'memory_profiler'
-```
-
-```bash
-bundle install
-
-# Run all benchmarks
-bundle exec rake rails_pulse:benchmark:all
-
-# Run specific benchmarks
-bundle exec rake rails_pulse:benchmark:memory
-bundle exec rake rails_pulse:benchmark:request_overhead
-bundle exec rake rails_pulse:benchmark:middleware
-```
-
 ## Standalone Dashboard Deployment
 
 For production environments, you can run the Rails Pulse dashboard as a standalone application, separate from your main Rails app. This provides several benefits:

data/Rakefile

@@ -261,9 +261,22 @@ task :test_release do
 
   failed_tasks = []
   current_step = 0
-  total_steps = 11
+  total_steps = 12
 
-  # Step 1: Sync test schema
+  # Step 1: Update appraisal gemfiles
+  current_step += 1
+  begin
+    puts "\n[#{current_step}/#{total_steps}] Updating appraisal gemfiles..."
+    puts "-" * 70
+    sh "bundle exec appraisal install"
+    puts "✅ Appraisal gemfiles updated!"
+  rescue => e
+    puts "❌ Appraisal update failed!"
+    puts "   Error: #{e.message}"
+    failed_tasks << "appraisal_install"
+  end
+
+  # Step 3: Sync test schema
   current_step += 1
   begin
     puts "\n[#{current_step}/#{total_steps}] Syncing test schema..."
@@ -275,7 +288,7 @@ task :test_release do
     failed_tasks << "sync_test_schema"
   end
 
-  # Step 2: Verify dummy migrations
+  # Step 4: Verify dummy migrations
   current_step += 1
   begin
     puts "\n[#{current_step}/#{total_steps}] Verifying dummy app migrations..."
@@ -287,7 +300,7 @@ task :test_release do
     failed_tasks << "verify_dummy_migrations"
   end
 
-  # Step 3: Git status check
+  # Step 5: Git status check
   current_step += 1
   begin
     puts "\n[#{current_step}/#{total_steps}] Checking git status..."
@@ -307,7 +320,7 @@ task :test_release do
     puts "⚠️  Warning: Could not check git status (#{e.message})"
   end
 
-  # Step 5: RuboCop linting
+  # Step 6: RuboCop linting
   current_step += 1
   begin
     puts "\n[#{current_step}/#{total_steps}] Running RuboCop linting..."

data/db/rails_pulse_schema.rb

@@ -1,6 +1,6 @@
 # Rails Pulse Database Schema
 # This file contains the complete schema for Rails Pulse tables
-# Load with: rails db:schema:load:rails_pulse or db:prepare
+# Load with: rails db:schema:load_rails_pulse or db:prepare
 
 RailsPulse::Schema = lambda do |connection|
   adapter = connection.adapter_name.downcase

data/lib/generators/rails_pulse/templates/db/rails_pulse_schema.rb

@@ -1,6 +1,6 @@
 # Rails Pulse Database Schema
 # This file contains the complete schema for Rails Pulse tables
-# Load with: rails db:schema:load:rails_pulse or db:prepare
+# Load with: rails db:schema:load_rails_pulse or db:prepare
 
 RailsPulse::Schema = lambda do |connection|
   adapter = connection.adapter_name.downcase

data/lib/rails_pulse/version.rb

@@ -1,3 +1,3 @@
 module RailsPulse
-  VERSION = "0.2.5.pre.11"
+  VERSION = "0.2.5.pre.12"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_pulse
 version: !ruby/object:Gem::Version
-  version: 0.2.5.pre.11
+  version: 0.2.5.pre.12
 platform: ruby
 authors:
 - Rails Pulse
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-18 00:00:00.000000000 Z
+date: 2026-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -370,7 +370,6 @@ files:
 - lib/rails_pulse/version.rb
 - lib/rails_pulse_server.ru
 - lib/tasks/rails_pulse.rake
-- lib/tasks/rails_pulse_benchmark.rake
 - lib/tasks/rails_pulse_tasks.rake
 - public/rails-pulse-assets/csp-test.js
 - public/rails-pulse-assets/rails-pulse-icons.js

data/lib/tasks/rails_pulse_benchmark.rake

@@ -1,382 +0,0 @@
-begin
-  require "benchmark"
-  require "benchmark/ips"
-  require "memory_profiler"
-rescue LoadError => e
-  # Benchmark gems not available - tasks will show error if run
-end
-
-namespace :rails_pulse do
-  namespace :benchmark do
-    desc "Run comprehensive performance benchmarks for Rails Pulse"
-    task all: :environment do
-      unless defined?(Benchmark::IPS) && defined?(MemoryProfiler)
-        puts "❌ Benchmark gems not installed. Add to your Gemfile:"
-        puts "  gem 'benchmark-ips'"
-        puts "  gem 'memory_profiler'"
-        puts "\nThen run: bundle install"
-        exit 1
-      end
-
-      puts "\n" + "=" * 80
-      puts "Rails Pulse Performance Benchmark Suite"
-      puts "=" * 80
-      puts "\nEnvironment:"
-      puts "  Ruby: #{RUBY_VERSION}"
-      puts "  Rails: #{Rails.version}"
-      puts "  Database: #{ActiveRecord::Base.connection.adapter_name}"
-      puts "  Rails Pulse: #{RailsPulse::VERSION}"
-      puts "\n"
-
-      # Run all benchmarks
-      Rake::Task["rails_pulse:benchmark:memory"].invoke
-      Rake::Task["rails_pulse:benchmark:request_overhead"].invoke
-      Rake::Task["rails_pulse:benchmark:middleware"].invoke
-      Rake::Task["rails_pulse:benchmark:job_tracking"].invoke
-      Rake::Task["rails_pulse:benchmark:database_queries"].invoke
-
-      puts "\n" + "=" * 80
-      puts "Benchmark suite completed!"
-      puts "=" * 80
-    end
-
-    desc "Benchmark memory usage with and without Rails Pulse"
-    task memory: :environment do
-      puts "\n" + "-" * 80
-      puts "Memory Usage Benchmark"
-      puts "-" * 80
-
-      # Ensure Rails Pulse is enabled
-      original_enabled = RailsPulse.configuration.enabled
-      RailsPulse.configuration.enabled = true
-
-      # Baseline memory (Rails Pulse disabled)
-      RailsPulse.configuration.enabled = false
-      GC.start
-      baseline_memory = GC.stat(:total_allocated_objects)
-
-      # Create some test data
-      route = RailsPulse::Route.find_or_create_by!(
-        method: "GET",
-        path: "/benchmark/test"
-      )
-
-      # Memory with Rails Pulse enabled
-      RailsPulse.configuration.enabled = true
-      GC.start
-      enabled_memory = GC.stat(:total_allocated_objects)
-
-      # Profile memory for creating a request
-      report = MemoryProfiler.report do
-        10.times do
-          RailsPulse::Request.create!(
-            route: route,
-            occurred_at: Time.current,
-            duration: rand(50..500),
-            status: 200,
-            request_uuid: SecureRandom.uuid
-          )
-        end
-      end
-
-      puts "\nMemory Allocation Summary:"
-      puts "  Total allocated: #{report.total_allocated_memsize / 1024.0} KB"
-      puts "  Total retained: #{report.total_retained_memsize / 1024.0} KB"
-      puts "  Allocated objects: #{report.total_allocated}"
-      puts "  Retained objects: #{report.total_retained}"
-
-      puts "\nPer-Request Memory Overhead:"
-      puts "  ~#{(report.total_allocated_memsize / 10.0 / 1024.0).round(2)} KB per request"
-
-      # Restore original state
-      RailsPulse.configuration.enabled = original_enabled
-    end
-
-    desc "Benchmark request processing overhead"
-    task request_overhead: :environment do
-      puts "\n" + "-" * 80
-      puts "Request Processing Overhead Benchmark"
-      puts "-" * 80
-
-      # Setup test data
-      route = RailsPulse::Route.find_or_create_by!(
-        method: "GET",
-        path: "/benchmark/test"
-      )
-
-      query = RailsPulse::Query.find_or_create_by!(
-        normalized_sql: "SELECT * FROM users WHERE id = ?"
-      )
-
-      puts "\nIterations per second (higher is better):\n"
-
-      Benchmark.ips do |x|
-        x.config(time: 5, warmup: 2)
-
-        x.report("Request creation (baseline)") do
-          RailsPulse::Request.new(
-            route: route,
-            occurred_at: Time.current,
-            duration: 100,
-            status: 200,
-            request_uuid: SecureRandom.uuid
-          )
-        end
-
-        x.report("Request creation + save") do
-          req = RailsPulse::Request.create!(
-            route: route,
-            occurred_at: Time.current,
-            duration: 100,
-            status: 200,
-            request_uuid: SecureRandom.uuid
-          )
-          req.destroy
-        end
-
-        x.report("Request + Operation") do
-          req = RailsPulse::Request.create!(
-            route: route,
-            occurred_at: Time.current,
-            duration: 100,
-            status: 200,
-            request_uuid: SecureRandom.uuid
-          )
-          RailsPulse::Operation.create!(
-            request: req,
-            query: query,
-            operation_type: "sql",
-            label: "User Load",
-            occurred_at: Time.current,
-            duration: 10
-          )
-          req.destroy
-        end
-
-        x.compare!
-      end
-
-      puts "\nAbsolute timing comparison:\n"
-      result = Benchmark.measure do
-        1000.times do
-          req = RailsPulse::Request.create!(
-            route: route,
-            occurred_at: Time.current,
-            duration: 100,
-            status: 200,
-            request_uuid: SecureRandom.uuid
-          )
-          req.destroy
-        end
-      end
-
-      puts "  1000 requests: #{(result.real * 1000).round(2)}ms total"
-      puts "  Average per request: #{result.real.round(5)}ms"
-    end
-
-    desc "Benchmark middleware overhead"
-    task middleware: :environment do
-      puts "\n" + "-" * 80
-      puts "Middleware Overhead Benchmark"
-      puts "-" * 80
-
-      # Create mock request environment
-      env = {
-        "REQUEST_METHOD" => "GET",
-        "PATH_INFO" => "/test",
-        "QUERY_STRING" => "",
-        "rack.input" => StringIO.new,
-        "rack.errors" => $stderr,
-        "action_dispatch.request_id" => SecureRandom.uuid
-      }
-
-      app = ->(env) { [ 200, { "Content-Type" => "text/plain" }, [ "OK" ] ] }
-      middleware = RailsPulse::Middleware::RequestCollector.new(app)
-
-      puts "\nMiddleware performance:\n"
-
-      # Benchmark with Rails Pulse enabled
-      RailsPulse.configuration.enabled = true
-      enabled_time = Benchmark.measure do
-        1000.times do
-          test_env = env.dup
-          test_env["action_dispatch.request_id"] = SecureRandom.uuid
-          middleware.call(test_env)
-        end
-      end
-
-      # Benchmark with Rails Pulse disabled
-      RailsPulse.configuration.enabled = false
-      disabled_time = Benchmark.measure do
-        1000.times do
-          test_env = env.dup
-          test_env["action_dispatch.request_id"] = SecureRandom.uuid
-          middleware.call(test_env)
-        end
-      end
-
-      # Benchmark without middleware
-      baseline_time = Benchmark.measure do
-        1000.times { app.call(env.dup) }
-      end
-
-      overhead_enabled = (enabled_time.real - baseline_time.real) * 1000 / 1000
-      overhead_disabled = (disabled_time.real - baseline_time.real) * 1000 / 1000
-
-      puts "  Baseline (no middleware): #{(baseline_time.real * 1000).round(2)}ms (1000 requests)"
-      puts "  With Rails Pulse enabled: #{(enabled_time.real * 1000).round(2)}ms (1000 requests)"
-      puts "  With Rails Pulse disabled: #{(disabled_time.real * 1000).round(2)}ms (1000 requests)"
-      puts "\n  Overhead per request (enabled): #{overhead_enabled.round(3)}ms"
-      puts "  Overhead per request (disabled): #{overhead_disabled.round(3)}ms"
-
-      # Restore
-      RailsPulse.configuration.enabled = true
-    end
-
-    desc "Benchmark job tracking overhead"
-    task job_tracking: :environment do
-      puts "\n" + "-" * 80
-      puts "Background Job Tracking Overhead Benchmark"
-      puts "-" * 80
-
-      # Skip if job tracking is disabled
-      unless RailsPulse.configuration.track_jobs
-        puts "\n  ⚠️  Job tracking is disabled - skipping benchmark"
-        next
-      end
-
-      # Create a simple test job
-      test_job_class = Class.new(ApplicationJob) do
-        def perform(value)
-          # Simulate some work
-          sleep(0.001)
-          value * 2
-        end
-      end
-
-      puts "\nJob execution overhead:\n"
-
-      # Benchmark with job tracking enabled
-      RailsPulse.configuration.track_jobs = true
-      enabled_time = Benchmark.measure do
-        100.times do |i|
-          test_job_class.new.perform(i)
-        end
-      end
-
-      # Benchmark with job tracking disabled
-      RailsPulse.configuration.track_jobs = false
-      disabled_time = Benchmark.measure do
-        100.times do |i|
-          test_job_class.new.perform(i)
-        end
-      end
-
-      overhead = (enabled_time.real - disabled_time.real) * 1000 / 100
-
-      puts "  With tracking enabled: #{(enabled_time.real * 1000).round(2)}ms (100 jobs)"
-      puts "  With tracking disabled: #{(disabled_time.real * 1000).round(2)}ms (100 jobs)"
-      puts "\n  Overhead per job: #{overhead.round(3)}ms"
-
-      # Restore
-      RailsPulse.configuration.track_jobs = true
-    end
-
-    desc "Benchmark database query overhead"
-    task database_queries: :environment do
-      puts "\n" + "-" * 80
-      puts "Database Query Overhead Benchmark"
-      puts "-" * 80
-
-      # Create test route for queries
-      route = RailsPulse::Route.find_or_create_by!(
-        method: "GET",
-        path: "/benchmark/queries"
-      )
-
-      puts "\nQuery performance comparison:\n"
-
-      # Test 1: Simple aggregation query
-      puts "  1. Average request duration calculation:"
-      time_enabled = Benchmark.measure do
-        100.times { RailsPulse::Request.average(:duration) }
-      end
-
-      RailsPulse.configuration.enabled = false
-      time_disabled = Benchmark.measure do
-        100.times { RailsPulse::Request.average(:duration) }
-      end
-      RailsPulse.configuration.enabled = true
-
-      puts "     Enabled: #{(time_enabled.real * 1000).round(2)}ms (100 queries)"
-      puts "     Disabled: #{(time_disabled.real * 1000).round(2)}ms (100 queries)"
-      puts "     Overhead: #{((time_enabled.real - time_disabled.real) * 10).round(3)}ms per query"
-
-      # Test 2: Complex joins and grouping
-      puts "\n  2. Requests grouped by hour with joins:"
-      time_complex = Benchmark.measure do
-        10.times do
-          RailsPulse::Request
-            .joins(:route)
-            .group("DATE_TRUNC('hour', occurred_at)")
-            .average(:duration)
-        end
-      end
-
-      puts "     Time: #{(time_complex.real * 1000).round(2)}ms (10 queries)"
-      puts "     Average: #{(time_complex.real * 100).round(3)}ms per query"
-
-      # Test 3: Summary aggregation
-      puts "\n  3. Summary data aggregation:"
-      time_summary = Benchmark.measure do
-        10.times do
-          RailsPulse::Summary
-            .where("period_start > ?", 24.hours.ago)
-            .group(:period_type)
-            .average(:avg_duration)
-        end
-      end
-
-      puts "     Time: #{(time_summary.real * 1000).round(2)}ms (10 queries)"
-      puts "     Average: #{(time_summary.real * 100).round(3)}ms per query"
-    end
-
-    desc "Generate benchmark report and save to docs"
-    task report: :environment do
-      require "fileutils"
-
-      puts "\n" + "=" * 80
-      puts "Generating Performance Benchmark Report"
-      puts "=" * 80
-
-      output_file = Rails.root.join("../../docs/benchmark_results.md")
-      FileUtils.mkdir_p(File.dirname(output_file))
-
-      File.open(output_file, "w") do |f|
-        f.puts "# Rails Pulse Performance Benchmark Results"
-        f.puts ""
-        f.puts "**Generated:** #{Time.current.strftime('%Y-%m-%d %H:%M:%S %Z')}"
-        f.puts ""
-        f.puts "## Environment"
-        f.puts ""
-        f.puts "- **Ruby:** #{RUBY_VERSION}"
-        f.puts "- **Rails:** #{Rails.version}"
-        f.puts "- **Database:** #{ActiveRecord::Base.connection.adapter_name}"
-        f.puts "- **Rails Pulse:** #{RailsPulse::VERSION}"
-        f.puts ""
-        f.puts "## Summary"
-        f.puts ""
-        f.puts "This report contains automated performance benchmarks measuring Rails Pulse's overhead."
-        f.puts ""
-        f.puts "---"
-        f.puts ""
-        f.puts "*For full benchmark output, run:* `rails rails_pulse:benchmark:all`"
-      end
-
-      puts "\n✅ Report saved to: #{output_file}"
-
-      # Run full benchmark suite
-      Rake::Task["rails_pulse:benchmark:all"].invoke
-    end
-  end
-end