rails_pulse 0.2.4 → 0.2.5.pre.pre.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 943ab1e08e81dbe5ede71b7d3c9ca526a65c9a0ce1767c7f9c37cee8883925cf
-  data.tar.gz: b3661c728215dc4759e6a3e04dd49dc113d13155972ed30f6ff35d0a2a07b10c
+  metadata.gz: 534617e370c257d7fd5947149d59a73a8fd988d3898605a1b8f2a61c38340b10
+  data.tar.gz: c82d0e9acbed69e4c8d602c21204da8da165805506c0d57568762883ea2f7aab
 SHA512:
-  metadata.gz: db5d711b9d8931c6aa489b9069f05d16514a997b9798c743f2c2998611797dbc3dbdcfdcd12e69f65b2b3459292d1e7558075c02805aa0f49a398b85716736ea
-  data.tar.gz: 55ccd02b5a9bb13ba46e36e0051c2440d8026956743e02660968209c66e61fe25f4ed8c3dd04a77b08a6209df9e13c922f42e481ade7cf53447d89a93976e680
+  metadata.gz: 7dd8507f19548fe4be681e07b5d9128779344528e4d7ebdc5ac4f820e175656568fed1f76255e048657c8da50333a443f257ec5f847c5c56fbab9084d2a02094
+  data.tar.gz: 5546a5fd09af8c73a921e784b7e347ec5c1ac6cd1f36b5246290154e315c68f0245bfff5ddb62bbfc1631d248c164dc6122d3634962bc93b36f848f26a1b588a

data/README.md

@@ -22,6 +22,11 @@
   - [Installation](#installation)
   - [Quick Setup](#quick-setup)
   - [Basic Configuration](#basic-configuration)
+- [Background Job Monitoring](#background-job-monitoring)
+  - [Overview](#overview)
+  - [Supported Adapters](#supported-adapters)
+  - [Job Tracking Configuration](#job-tracking-configuration)
+  - [Privacy & Security](#privacy--security)
 - [Authentication](#authentication)
   - [Authentication Setup](#authentication-setup)
   - [Authentication Examples](#authentication-examples)
@@ -37,6 +42,9 @@
   - [Configuration](#configuration)
   - [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)
 - [Advantages Over Other Solutions](#advantages-over-other-solutions)
@@ -54,8 +62,16 @@ Rails Pulse is a comprehensive performance monitoring and debugging gem that pro
 - Interactive dashboard with response time charts and request analytics
 - SQL query performance tracking with slow query identification
 - Route-specific metrics with configurable performance thresholds
+- **Background job monitoring** with execution tracking and failure analysis
 - Week-over-week trend analysis with visual indicators
 
+### Background Job Tracking
+- **Universal job tracking** compatible with all ActiveJob adapters
+- Monitor job performance, failures, and retries
+- Track individual job executions with detailed metrics
+- View operations and SQL queries executed during jobs
+- Configurable privacy controls for job arguments
+
 ### Developer Experience
 - Zero configuration setup with sensible defaults
 - Beautiful responsive interface with dark/light mode
@@ -63,7 +79,7 @@ Rails Pulse is a comprehensive performance monitoring and debugging gem that pro
 - Multiple database support (SQLite, PostgreSQL, MySQL)
 
 ### Organization & Filtering
-- Flexible tagging system for routes, requests, and queries
+- Flexible tagging system for routes, requests, queries, and jobs
 - Filter performance data by custom tags
 - Organize monitoring data by environment, priority, or custom categories
 
@@ -172,10 +188,21 @@ RailsPulse.configure do |config|
     critical: 1000
   }
 
+  # Set performance thresholds for background jobs (in milliseconds)
+  config.job_thresholds = {
+    slow: 5_000,      # 5 seconds
+    very_slow: 30_000, # 30 seconds
+    critical: 60_000   # 1 minute
+  }
+
   # Asset tracking configuration
   config.track_assets = false       # Ignore asset requests by default
   config.custom_asset_patterns = [] # Additional asset patterns to ignore
 
+  # Job tracking configuration
+  config.track_jobs = true          # Enable background job tracking
+  config.capture_job_arguments = false # Disable argument capture for privacy
+
   # Rails Pulse mount path (optional)
   # Specify if Rails Pulse is mounted at a custom path to prevent self-tracking
   config.mount_path = nil  # e.g., "/admin/monitoring"
@@ -184,18 +211,22 @@ RailsPulse.configure do |config|
   config.ignored_routes = []    # Array of strings or regex patterns
   config.ignored_requests = []  # Array of request patterns to ignore
   config.ignored_queries = []   # Array of query patterns to ignore
+  config.ignored_jobs = []      # Array of job class names to ignore
+  config.ignored_queues = []    # Array of queue names to ignore
 
   # Tagging system - define available tags for categorizing performance data
   config.tags = ["production", "staging", "critical", "needs-optimization"]
 
   # Data cleanup
-  config.archiving_enabled = true        # Enable automatic cleanup
-  config.full_retention_period = 2.weeks # Delete records older than this
-  config.max_table_records = {           # Maximum records per table
-    rails_pulse_requests: 10000,
-    rails_pulse_operations: 50000,
-    rails_pulse_routes: 1000,
-    rails_pulse_queries: 500
+  config.archiving_enabled = true         # Enable automatic cleanup
+  config.full_retention_period = 30.days  # Delete records older than this
+  config.max_table_records = {            # Maximum records per table
+    rails_pulse_operations: 100_000,
+    rails_pulse_requests: 50_000,
+    rails_pulse_job_runs: 50_000,
+    rails_pulse_queries: 10_000,
+    rails_pulse_routes: 1_000,
+    rails_pulse_jobs: 1_000
   }
 
   # Multiple database support (optional)
@@ -206,6 +237,117 @@ RailsPulse.configure do |config|
 end
 ```
 
+## Background Job Monitoring
+
+Rails Pulse provides comprehensive monitoring for ActiveJob background jobs, tracking performance, failures, and execution details across all major job adapters.
+
+### Overview
+
+Background job monitoring is **enabled by default** and works automatically with any ActiveJob adapter. Rails Pulse captures:
+
+- **Job execution metrics**: Duration, status, retry attempts
+- **Failure tracking**: Error class, error message, failure rates
+- **Performance analysis**: Slow jobs, aggregate metrics by job class
+- **Operation timeline**: SQL queries and operations during job execution
+- **Job arguments**: Optional capture for debugging (disabled by default for privacy)
+
+Access the jobs dashboard at `/rails_pulse/jobs` to view:
+- All job classes with aggregate metrics (total runs, failure rate, average duration)
+- Individual job executions with detailed performance data
+- Filtering by time range, status, queue, and performance thresholds
+- Tagging support for organizing jobs by team, priority, or category
+
+### Supported Adapters
+
+Rails Pulse works with all ActiveJob adapters through universal tracking:
+
+- **Sidekiq** - Enhanced tracking via custom middleware
+- **Solid Queue** - Universal ActiveJob tracking
+- **Good Job** - Universal ActiveJob tracking
+- **Delayed Job** - Enhanced tracking via custom plugin
+- **Resque** - Universal ActiveJob tracking
+- **Any ActiveJob adapter** - Falls back to universal tracking
+
+No additional configuration needed - job tracking works out of the box with your existing setup.
+
+### Job Tracking Configuration
+
+Customize job tracking in your Rails Pulse initializer:
+
+```ruby
+RailsPulse.configure do |config|
+  # Enable or disable job tracking (default: true)
+  config.track_jobs = true
+
+  # Set performance thresholds for jobs (in milliseconds)
+  config.job_thresholds = {
+    slow: 5_000,        # 5 seconds
+    very_slow: 30_000,  # 30 seconds
+    critical: 60_000    # 1 minute
+  }
+
+  # Ignore specific job classes from tracking
+  config.ignored_jobs = [
+    "ActiveStorage::AnalyzeJob",
+    "ActiveStorage::PurgeJob"
+  ]
+
+  # Ignore specific queues from tracking
+  config.ignored_queues = ["low_priority", "mailers"]
+
+  # Capture job arguments for debugging (default: false)
+  # WARNING: May expose sensitive data - use with caution
+  config.capture_job_arguments = false
+
+  # Configure adapter-specific settings
+  config.job_adapters = {
+    sidekiq: { enabled: true, track_queue_depth: false },
+    solid_queue: { enabled: true, track_recurring: false },
+    good_job: { enabled: true, track_cron: false },
+    delayed_job: { enabled: true },
+    resque: { enabled: true }
+  }
+end
+```
+
+**Disabling job tracking for specific jobs:**
+
+```ruby
+class MyBackgroundJob < ApplicationJob
+  # Skip Rails Pulse tracking for this job
+  def perform(*args)
+    RailsPulse.with_tracking_disabled do
+      # Job logic here
+    end
+  end
+end
+```
+
+### Privacy & Security
+
+**Job argument capture is disabled by default** to protect sensitive information. Job arguments may contain:
+- User credentials or tokens
+- Personal identifiable information (PII)
+- API keys or secrets
+- Sensitive business data
+
+Only enable `capture_job_arguments` in development or when explicitly needed for debugging. Consider using parameter filtering if you need to capture arguments:
+
+```ruby
+# In your job class
+class SensitiveJob < ApplicationJob
+  def perform(user_id:, api_key:)
+    # Rails Pulse will track execution but not arguments by default
+  end
+end
+```
+
+**Performance impact:**
+- Minimal overhead: ~1-2ms per job execution
+- No blocking of job processing
+- Configurable cleanup prevents database growth
+- Can be disabled per-job or globally
+
 ## Authentication
 
 Rails Pulse supports flexible authentication to secure access to your monitoring dashboard.
@@ -257,7 +399,7 @@ config.authentication_method = proc {
 
 ## Tagging System
 
-Rails Pulse includes a flexible tagging system that allows you to categorize and organize your performance data. Tag routes, requests, and queries with custom labels to better organize and filter your monitoring data.
+Rails Pulse includes a flexible tagging system that allows you to categorize and organize your performance data. Tag routes, requests, queries, jobs, and job runs with custom labels to better organize and filter your monitoring data.
 
 ### Configuring Tags
 
@@ -280,7 +422,7 @@ end
 
 **Tag from the UI:**
 
-1. Navigate to any route, request, or query detail page
+1. Navigate to any route, request, query, job, or job run detail page
 2. Click the "+ tag" button next to the record
 3. Select from your configured tags
 4. Remove tags by clicking the × button on any tag badge
@@ -297,6 +439,15 @@ route.add_tag("high-traffic")
 query = RailsPulse::Query.find_by(normalized_sql: "SELECT * FROM users WHERE id = ?")
 query.add_tag("needs-optimization")
 
+# Tag a job
+job = RailsPulse::Job.find_by(name: "UserNotificationJob")
+job.add_tag("high-priority")
+job.add_tag("user-facing")
+
+# Tag a specific job run
+job_run = RailsPulse::JobRun.find_by(run_id: "abc123")
+job_run.add_tag("investigated")
+
 # Remove a tag
 route.remove_tag("critical")
 
@@ -486,6 +637,113 @@ The schema file `db/rails_pulse_schema.rb` serves as your single source of truth
 - Should not be deleted or modified
 - Future updates will provide migrations in `db/rails_pulse_migrate/`
 
+## Performance Impact
+
+Rails Pulse uses **fiber-based async tracking** for minimal performance overhead:
+
+- **Request overhead:** ~0.1ms per request (data collection only)
+- **Database writes:** Non-blocking, handled in background fibers
+- **Memory allocation:** Minimal, ~200 KB per request (temporary)
+- **Thread safety:** Proper connection pooling with isolated database connections
+
+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:
+
+- **Dashboard remains accessible when main app is under heavy load**
+- **Separate resource allocation** for monitoring vs application
+- **Enhanced security** - isolate dashboard access from public app
+- **Independent scaling** - dashboard doesn't scale with app instances
+
+**Quick Setup:**
+
+```bash
+# Option 1: Set DATABASE_URL environment variable (recommended for production)
+export DATABASE_URL="postgresql://user:pass@host/db"
+bundle exec rackup lib/rails_pulse_server.ru -p 3001
+
+# Option 2: Use config/database.yml (recommended for development)
+# Looks for 'rails_pulse' connection, falls back to primary
+# No environment variable needed - automatically reads from config/database.yml
+bundle exec rackup lib/rails_pulse_server.ru -p 3001
+```
+
+**Healthcheck Endpoint:**
+
+The standalone server includes a `/health` endpoint that verifies database connectivity:
+
+```bash
+curl http://localhost:3001/health
+# Returns: {"status":"ok","mode":"dashboard","database":"connected","timestamp":"..."}
+```
+
+**Deployment Options:**
+
+1. **Separate subdomain (recommended):**
+   ```nginx
+   server {
+       server_name pulse.myapp.com;
+       location / {
+           proxy_pass http://localhost:3001;
+           proxy_set_header Host $host;
+           proxy_set_header X-Real-IP $remote_addr;
+           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+           proxy_set_header X-Forwarded-Proto $scheme;
+       }
+   }
+   ```
+
+2. **Kamal Deployment:**
+   Deploy the dashboard as an accessory
+
+   ```yaml
+   # config/deploy.yml
+   accessories:
+     rails_pulse:
+       image: your-app-image  # Same image as your main app
+       host: your-server
+       cmd: bundle exec rackup lib/rails_pulse_server.ru -p 3001
+       env:
+         clear:
+           DATABASE_URL: "postgresql://user:pass@host/db"
+           RAILS_ENV: production
+           SECRET_KEY_BASE: <%= ENV.fetch("SECRET_KEY_BASE") %>
+       port: "3001:3001"
+       healthcheck:
+         path: /health
+         port: 3001
+         interval: 10s
+         timeout: 5s
+   ```
+
+**Note:** When running standalone, the dashboard is read-only and doesn't track its own requests (tracking is automatically disabled).
+
+For detailed deployment instructions, see [docs/deployment-modes.md](docs/deployment-modes.md).
+
 ## Testing
 
 Rails Pulse includes a comprehensive test suite designed for speed and reliability across multiple databases and Rails versions.
@@ -652,7 +910,6 @@ The gem is available as open source under the terms of the [MIT License](https:/
 <div align="center">
   <strong>Built with ❤️ for the Rails community</strong>
 
-  [Documentation](https://github.com/railspulse/rails_pulse/wiki) •
   [Issues](https://github.com/railspulse/rails_pulse/issues) •
-  [Contributing](CONTRIBUTING.md)
+  [Discussions](https://github.com/railspulse/rails_pulse/discussions)
 </div>

data/Rakefile

@@ -7,6 +7,57 @@ require "dotenv/load" if File.exist?(".env")
 APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
 load "rails/tasks/engine.rake"
 
+desc "Verify dummy app migrations are in sync with gem migrations"
+task :verify_dummy_migrations do
+  # Check if db/rails_pulse_migrate directory exists (separate database setup)
+  if Dir.exist?("db/rails_pulse_migrate")
+    gem_migrations = Dir["db/rails_pulse_migrate/*.rb"].map { |f| File.basename(f) }.sort
+
+    # Get all RailsPulse migrations from dummy app (exclude dummy app's own migrations)
+    all_dummy_migrations = Dir["test/dummy/db/migrate/*.rb"].map { |f| File.basename(f) }
+
+    # Filter to only RailsPulse migrations (contain "rails_pulse" in name or match known patterns)
+    dummy_migrations = all_dummy_migrations.select do |m|
+      m.include?("rails_pulse") ||
+      m.include?("jobs") ||
+      m.include?("query") ||
+      m.include?("request_uuid")
+    end.sort
+
+    missing = gem_migrations - dummy_migrations
+
+    if missing.any?
+      puts "\n❌ Dummy app is missing Rails Pulse migrations:"
+      missing.each { |m| puts "   • #{m}" }
+      puts "\nTo fix this, run:"
+      puts "  cd test/dummy"
+      puts "  rails generate rails_pulse:upgrade"
+      puts "  rails db:migrate RAILS_ENV=test"
+      puts "\nThen commit the new migration files."
+      exit 1
+    else
+      puts "✅ Dummy app migrations are in sync with gem migrations"
+    end
+  else
+    puts "✅ Dummy app migrations check skipped (single database setup)"
+  end
+end
+
+desc "Sync Rails Pulse schema to test/dummy app"
+task :sync_test_schema do
+  require "fileutils"
+
+  source = "db/rails_pulse_schema.rb"
+  dest = "test/dummy/db/rails_pulse_schema.rb"
+
+  if File.exist?(source)
+    FileUtils.cp(source, dest)
+    puts "✅ Synced schema: #{source} → #{dest}"
+  else
+    puts "⚠️  Source schema not found: #{source}"
+  end
+end
+
 desc "Setup database for testing"
 task :test_setup do
   database = ENV['DB'] || 'sqlite3'
@@ -19,6 +70,9 @@ task :test_setup do
   puts
 
   begin
+    # Sync schema file from gem to test/dummy
+    Rake::Task[:sync_test_schema].invoke
+
     # Remove schema.rb to ensure clean migration
     schema_file = "test/dummy/db/schema.rb"
     if File.exist?(schema_file)
@@ -102,6 +156,10 @@ task :test_setup_for_version, [ :database, :rails_version ] do |t, args|
   puts
 
   begin
+    # Sync schema file from gem to test/dummy
+    Rake::Task[:sync_test_schema].reenable
+    Rake::Task[:sync_test_schema].invoke
+
     # Remove schema.rb to ensure clean migration
     schema_file = "test/dummy/db/schema.rb"
     if File.exist?(schema_file)
@@ -203,9 +261,33 @@ task :test_release do
 
   failed_tasks = []
   current_step = 0
-  total_steps = 7
+  total_steps = 11
+
+  # Step 1: Sync test schema
+  current_step += 1
+  begin
+    puts "\n[#{current_step}/#{total_steps}] Syncing test schema..."
+    puts "-" * 70
+    Rake::Task[:sync_test_schema].invoke
+  rescue => e
+    puts "❌ Schema sync failed!"
+    puts "   Error: #{e.message}"
+    failed_tasks << "sync_test_schema"
+  end
+
+  # Step 2: Verify dummy migrations
+  current_step += 1
+  begin
+    puts "\n[#{current_step}/#{total_steps}] Verifying dummy app migrations..."
+    puts "-" * 70
+    Rake::Task[:verify_dummy_migrations].invoke
+  rescue => e
+    puts "❌ Dummy app migration verification failed!"
+    puts "   Error: #{e.message}"
+    failed_tasks << "verify_dummy_migrations"
+  end
 
-  # Step 1: Git status check
+  # Step 3: Git status check
   current_step += 1
   begin
     puts "\n[#{current_step}/#{total_steps}] Checking git status..."
@@ -225,7 +307,7 @@ task :test_release do
     puts "⚠️  Warning: Could not check git status (#{e.message})"
   end
 
-  # Step 2: RuboCop linting
+  # Step 5: RuboCop linting
   current_step += 1
   begin
     puts "\n[#{current_step}/#{total_steps}] Running RuboCop linting..."
@@ -238,7 +320,19 @@ task :test_release do
     failed_tasks << "rubocop"
   end
 
-  # Step 3: Install Node dependencies
+  # Step 6: Brakeman security scan
+  current_step += 1
+  begin
+    puts "\n[#{current_step}/#{total_steps}] Running Brakeman security scanner..."
+    puts "-" * 70
+    Rake::Task[:brakeman].invoke
+  rescue => e
+    puts "❌ Brakeman security scan failed!"
+    puts "   Error: #{e.message}"
+    failed_tasks << "brakeman"
+  end
+
+  # Step 7: Install Node dependencies
   current_step += 1
   begin
     puts "\n[#{current_step}/#{total_steps}] Installing Node dependencies..."
@@ -251,7 +345,7 @@ task :test_release do
     failed_tasks << "npm_install"
   end
 
-  # Step 4: Build and verify assets
+  # Step 8: Build and verify assets
   current_step += 1
   begin
     puts "\n[#{current_step}/#{total_steps}] Building production assets..."
@@ -273,7 +367,7 @@ task :test_release do
     failed_tasks << "npm_build"
   end
 
-  # Step 5: Verify gem builds
+  # Step 9: Verify gem builds
   current_step += 1
   begin
     puts "\n[#{current_step}/#{total_steps}] Verifying gem builds correctly..."
@@ -291,7 +385,7 @@ task :test_release do
     failed_tasks << "gem_build"
   end
 
-  # Step 6: Run generator tests
+  # Step 10: Run generator tests
   current_step += 1
   begin
     puts "\n[#{current_step}/#{total_steps}] Running generator tests..."
@@ -304,7 +398,7 @@ task :test_release do
     failed_tasks << "test_generators"
   end
 
-  # Step 7: Run full test matrix with system tests
+  # Step 11: Run full test matrix with system tests
   current_step += 1
   begin
     puts "\n[#{current_step}/#{total_steps}] Running full test matrix with system tests..."
@@ -337,5 +431,45 @@ task :test_release do
   end
 end
 
+desc "Run Brakeman security scanner"
+task :brakeman do
+  require "brakeman"
+
+  puts "\n" + "=" * 50
+  puts "🔒 Running Brakeman Security Scanner"
+  puts "=" * 50
+  puts
+
+  begin
+    # Run Brakeman with the configuration file
+    result = Brakeman.run(
+      app_path: ".",
+      config_file: "config/brakeman.yml",
+      print_report: true,
+      pager: false
+    )
+
+    # Check if any unignored warnings were found
+    # result.filtered_warnings only includes warnings that aren't ignored
+    unignored_warnings = result.filtered_warnings
+    total_warnings = result.warnings.count
+    ignored_count = total_warnings - unignored_warnings.count
+
+    if unignored_warnings.any? || result.errors.any?
+      puts "\n❌ Security issues found!"
+      puts "   Warnings: #{unignored_warnings.count}"
+      puts "   Ignored: #{ignored_count}" if ignored_count > 0
+      puts "   Errors: #{result.errors.count}"
+      exit 1
+    else
+      puts "\n✅ No security issues found!"
+      puts "   (#{ignored_count} warnings reviewed and ignored)" if ignored_count > 0
+    end
+  rescue => e
+    puts "\n❌ Brakeman scan failed!"
+    puts "   Error: #{e.message}"
+    exit 1
+  end
+end
 
 task default: :test

data/app/assets/stylesheets/rails_pulse/components/table.css

@@ -25,10 +25,25 @@
     text-align: start;
   }
 
-  th, td {
+  th,
+  td {
     padding: var(--size-2);
   }
 
+  /* Truncated cell styles */
+  td.truncate-cell {
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  td.truncate-cell a {
+    display: block;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
   tfoot {
     background-color: rgb(from var(--color-border-light) r g b / .5);
     border-block-start-width: var(--border);

data/app/assets/stylesheets/rails_pulse/components/tags.css

@@ -26,6 +26,10 @@
   flex-wrap: wrap;
 }
 
+.tag-list span {
+  padding-right: 3px !important;
+}
+
 /* Individual Tag */
 .tag {
   display: inline-flex;
@@ -63,9 +67,10 @@
 }
 
 .tag-remove span {
-  font-size: 1.25rem;
   line-height: 1;
-  font-weight: bold;
+  font-weight: inherit;
+  margin-left: 6px;
+  font-size: 17px;
 }
 
 /* Add Tag Container */

data/app/assets/stylesheets/rails_pulse/components/utilities.css

@@ -35,6 +35,9 @@
 .max-w-lg { max-width: 32rem; }
 .max-w-xl { max-width: 36rem; }
 
+/* Table layout utilities */
+.table-fixed { table-layout: fixed; }
+
 /* Global filters active indicator */
 .global-filters-active {
   position: relative;

data/app/controllers/concerns/chart_table_concern.rb

@@ -51,7 +51,8 @@ module ChartTableConcern
     table_results = build_table_results
     handle_pagination
 
-    @pagy, @table_data = pagy(table_results, items: session_pagination_limit)
+    # Use pagy_options for version compatibility
+    @pagy, @table_data = pagy(table_results, **pagy_options(session_pagination_limit))
   end
 
   def setup_zoom_range_data