rails_pulse 0.1.4 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d5eb9055acbfc951ef6874c484b10f0c4c9a02f4886148fd917ec1f83cdc386
-  data.tar.gz: fe1db6e87b0788868ab99a4c5ee2c818fb2720b8aaa88a59d86023a8a4bc0f92
+  metadata.gz: a8ed469f307dd71e912b46a4da0a0daa60abbdc262a8dbd12604db00a66335fe
+  data.tar.gz: 8af5a6bf946a86e1bc277c1d719100ace739bb429c07969fd1e4ec31887d6f70
 SHA512:
-  metadata.gz: 17141eaefe36c4ee6e857fe36ae3ee7c9e500cb6b3dc07ba79b2ba20248cb1a01920d5f0441c09279af0ab04efa020ffe144aeef1f4fb00036094378c1e2fc65
-  data.tar.gz: 8bf37d00fc3b161eb84587eef5562cebe493adb6a0729897f00aed9d38a69b1847ba82781473a8d2b3deb4ad1acea764b014460a758bc12ef686028096974355
+  metadata.gz: eceb3af7e713b6049688e50a8fd79af7b2f09c7720158c8d15257235b0c7488ebe7c0eccfaab3cd5dfb5923f80e9a8bd8693d0a9fb2f4e021aca8846c4ac435c
+  data.tar.gz: f982a50256d99968eb68fee89e6380d3f75511e6c3e8e878ddca375919f6a68a201f9ce46c6868e2425c127ae1862ca0d1895b0e01afea89a9af6a4e85d7f0f9

data/README.md

@@ -25,6 +25,10 @@
 - [Authentication](#authentication)
   - [Authentication Setup](#authentication-setup)
   - [Authentication Examples](#authentication-examples)
+- [Tagging System](#tagging-system)
+  - [Configuring Tags](#configuring-tags)
+  - [Using Tags](#using-tags)
+  - [Filtering by Tags](#filtering-by-tags)
 - [Data Management](#data-management)
   - [Cleanup Strategies](#cleanup-strategies)
   - [Cleanup Configuration](#cleanup-configuration)
@@ -58,6 +62,11 @@ Rails Pulse is a comprehensive performance monitoring and debugging gem that pro
 - Smart caching with minimal performance overhead
 - Multiple database support (SQLite, PostgreSQL, MySQL)
 
+### Organization & Filtering
+- Flexible tagging system for routes, requests, and queries
+- Filter performance data by custom tags
+- Organize monitoring data by environment, priority, or custom categories
+
 ## Screenshots
 
 <table>
@@ -176,6 +185,9 @@ RailsPulse.configure do |config|
   config.ignored_requests = []  # Array of request patterns to ignore
   config.ignored_queries = []   # Array of query patterns 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
@@ -243,6 +255,72 @@ 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.
+
+### Configuring Tags
+
+Define available tags in your Rails Pulse initializer:
+
+```ruby
+RailsPulse.configure do |config|
+  config.tags = [
+    "production",
+    "staging",
+    "critical",
+    "needs-optimization",
+    "high-traffic",
+    "background-job"
+  ]
+end
+```
+
+### Using Tags
+
+**Tag from the UI:**
+
+1. Navigate to any route, request, or query 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
+
+**Tag Programmatically:**
+
+```ruby
+# Tag a route
+route = RailsPulse::Route.find_by(path: "/api/users")
+route.add_tag("critical")
+route.add_tag("high-traffic")
+
+# Tag a query
+query = RailsPulse::Query.find_by(normalized_sql: "SELECT * FROM users WHERE id = ?")
+query.add_tag("needs-optimization")
+
+# Remove a tag
+route.remove_tag("critical")
+
+# Check if has tag
+route.has_tag?("production") # => true
+```
+
+### Filtering by Tags
+
+Use the global filters modal to filter performance data by tags:
+
+1. Click the filter icon in the top navigation
+2. Select one or more tags from the tag selector
+3. Apply filters to see only records with those tags
+4. Tags appear as badges in all data tables for quick visual identification
+
+**Common Tagging Strategies:**
+
+- **By Environment**: `production`, `staging`, `development`
+- **By Priority**: `critical`, `high`, `medium`, `low`
+- **By Status**: `needs-optimization`, `investigating`, `resolved`
+- **By Type**: `api`, `background-job`, `user-facing`, `admin`
+- **By Team**: `team-frontend`, `team-backend`, `team-data`
+
 ## Data Management
 
 Rails Pulse provides data cleanup to prevent your monitoring database from growing indefinitely while preserving essential performance insights.

data/Rakefile

@@ -85,7 +85,7 @@ task :test do
   puts "=" * 50
   puts
 
-  sh "rails test test/controllers test/helpers test/instrumentation test/jobs test/models test/services test/system"
+  sh "rails test test/controllers test/helpers test/instrumentation test/jobs test/models test/services"
 end
 
 desc "Setup database for specific Rails version and database"
@@ -137,10 +137,16 @@ task :test_matrix do
   total_combinations = databases.size * rails_versions.size
   current = 0
 
+  # Check if system tests should be included
+  include_system_tests = ENV['BROWSER'] == 'true'
+  test_paths = "test/controllers test/helpers test/instrumentation test/jobs test/models test/services"
+  test_paths += " test/system" if include_system_tests
+
   puts "\n" + "=" * 60
   puts "🚀 Rails Pulse Full Test Matrix"
   puts "=" * 60
   puts "Testing #{total_combinations} combinations..."
+  puts "System tests: #{include_system_tests ? 'ENABLED (BROWSER=true)' : 'DISABLED (headless mode)'}"
   puts "=" * 60
 
   databases.each do |database|
@@ -158,10 +164,10 @@ task :test_matrix do
         # Then run the tests
         if rails_version == "rails-8-0" && database == "sqlite3"
           # Current default setup
-          sh "bundle exec rake test"
+          sh "BROWSER=#{ENV['BROWSER']} rails test #{test_paths}"
         else
           # Use appraisal with specific database
-          sh "DB=#{database} bundle exec appraisal #{rails_version} rake test"
+          sh "DB=#{database} BROWSER=#{ENV['BROWSER']} bundle exec appraisal #{rails_version} rails test #{test_paths}"
         end
 
         puts "✅ PASSED: #{database} + #{rails_version}"
@@ -188,5 +194,148 @@ task :test_matrix do
   end
 end
 
+desc "Pre-release testing with comprehensive checks"
+task :test_release do
+  puts "\n" + "=" * 70
+  puts "🚀 Rails Pulse Pre-Release Validation"
+  puts "=" * 70
+  puts
+
+  failed_tasks = []
+  current_step = 0
+  total_steps = 7
+
+  # Step 1: Git status check
+  current_step += 1
+  begin
+    puts "\n[#{current_step}/#{total_steps}] Checking git status..."
+    puts "-" * 70
+
+    git_status = `git status --porcelain`.strip
+    if !git_status.empty?
+      puts "❌ Git working directory is not clean!"
+      puts "\nUncommitted changes:"
+      puts git_status
+      puts "\nPlease commit or stash your changes before running pre-release tests."
+      failed_tasks << "git_status_check"
+    else
+      puts "✅ Git working directory is clean"
+    end
+  rescue => e
+    puts "⚠️  Warning: Could not check git status (#{e.message})"
+  end
+
+  # Step 2: RuboCop linting
+  current_step += 1
+  begin
+    puts "\n[#{current_step}/#{total_steps}] Running RuboCop linting..."
+    puts "-" * 70
+    sh "bundle exec rubocop"
+    puts "✅ Code style checks passed!"
+  rescue => e
+    puts "❌ RuboCop linting failed!"
+    puts "   Error: #{e.message}"
+    failed_tasks << "rubocop"
+  end
+
+  # Step 3: Install Node dependencies
+  current_step += 1
+  begin
+    puts "\n[#{current_step}/#{total_steps}] Installing Node dependencies..."
+    puts "-" * 70
+    sh "npm install"
+    puts "✅ Node dependencies installed!"
+  rescue => e
+    puts "❌ npm install failed!"
+    puts "   Error: #{e.message}"
+    failed_tasks << "npm_install"
+  end
+
+  # Step 4: Build and verify assets
+  current_step += 1
+  begin
+    puts "\n[#{current_step}/#{total_steps}] Building production assets..."
+    puts "-" * 70
+    sh "npm run build"
+
+    # Verify assets were built
+    assets_dir = "public/rails-pulse-assets"
+    if Dir.exist?(assets_dir) && !Dir.empty?(assets_dir)
+      puts "✅ Assets built successfully!"
+      puts "   Location: #{assets_dir}"
+    else
+      puts "❌ Assets directory is missing or empty!"
+      failed_tasks << "asset_build_verification"
+    end
+  rescue => e
+    puts "❌ Asset building failed!"
+    puts "   Error: #{e.message}"
+    failed_tasks << "npm_build"
+  end
+
+  # Step 5: Verify gem builds
+  current_step += 1
+  begin
+    puts "\n[#{current_step}/#{total_steps}] Verifying gem builds correctly..."
+    puts "-" * 70
+    sh "gem build rails_pulse.gemspec"
+
+    # Clean up the built gem
+    built_gems = Dir.glob("rails_pulse-*.gem")
+    built_gems.each { |gem_file| File.delete(gem_file) }
+
+    puts "✅ Gem builds successfully!"
+  rescue => e
+    puts "❌ Gem build failed!"
+    puts "   Error: #{e.message}"
+    failed_tasks << "gem_build"
+  end
+
+  # Step 6: Run generator tests
+  current_step += 1
+  begin
+    puts "\n[#{current_step}/#{total_steps}] Running generator tests..."
+    puts "-" * 70
+    sh "./bin/test_generators"
+    puts "✅ Generator tests passed!"
+  rescue => e
+    puts "❌ Generator tests failed!"
+    puts "   Error: #{e.message}"
+    failed_tasks << "test_generators"
+  end
+
+  # Step 7: Run full test matrix with system tests
+  current_step += 1
+  begin
+    puts "\n[#{current_step}/#{total_steps}] Running full test matrix with system tests..."
+    puts "-" * 70
+    sh "BROWSER=true rake test_matrix"
+    puts "✅ Test matrix passed!"
+  rescue => e
+    puts "❌ Test matrix failed!"
+    puts "   Error: #{e.message}"
+    failed_tasks << "test_matrix"
+  end
+
+  # Print final results
+  puts "\n" + "=" * 70
+  puts "🏁 Pre-Release Validation Results"
+  puts "=" * 70
+
+  if failed_tasks.empty?
+    puts "🎉 All pre-release checks passed!"
+    puts "\n✅ Ready for release!"
+    puts "\nNext steps:"
+    puts "  1. Update version in lib/rails_pulse/version.rb"
+    puts "  2. Update Gemfile.lock files for all Rails versions"
+    puts "  3. Follow the release process in docs/releasing.md"
+  else
+    puts "❌ Failed checks (#{failed_tasks.size}/#{total_steps}):"
+    failed_tasks.each { |task| puts "   • #{task}" }
+    puts "\n⚠️  Fix these issues before releasing."
+    exit 1
+  end
+end
+
 
 task default: :test

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

@@ -0,0 +1,191 @@
+@import url("https://esm.sh/flatpickr@4.6.13/dist/flatpickr.min.css");
+
+.flatpickr-calendar {
+  --calendar-size: 250px;
+  --container-size: 220px;
+  --day-size: var(--size-8);
+
+  background: var(--color-bg);
+  border: 1px solid var(--color-border);
+  border-radius: var(--rounded-md);
+  box-shadow: var(--shadow-md);
+  font-size: var(--text-sm);
+  inline-size: var(--calendar-size);
+
+  .flatpickr-innerContainer {
+    justify-content: center;
+    padding-block-end: var(--size-3);
+  }
+
+  .flatpickr-days {
+    inline-size: var(--container-size);
+  }
+
+  .dayContainer {
+    inline-size: var(--container-size);
+    min-inline-size: var(--container-size);
+    max-inline-size: var(--container-size);
+  }
+
+  .dayContainer + .dayContainer {
+    box-shadow: -1px 0 0 var(--color-border);
+  }
+
+  .flatpickr-months {
+    .flatpickr-month {
+      color: var(--color-text);
+    }
+
+    span.cur-month {
+      font-size: var(--text-sm);
+      font-weight: var(--font-medium);
+    }
+
+    svg {
+      fill: var(--color-border-dark);
+    }
+
+    .flatpickr-prev-month:hover svg {
+      fill: var(--color-text);
+    }
+
+    .flatpickr-next-month:hover svg {
+      fill: var(--color-text);
+    }
+  }
+
+  .flatpickr-monthDropdown-months {
+    appearance: none;
+    border-radius: var(--rounded-md);
+    font-size: var(--text-sm);
+    font-weight: var(--font-medium);
+    line-height: var(--leading-normal);
+    padding: 0;
+    text-align: center;
+
+    &:hover {
+      background: var(--color-border-light);
+    }
+  }
+
+  .numInputWrapper {
+    input {
+      border-radius: var(--rounded-md);
+      color: var(--color-text);
+      font-size: var(--text-sm);
+      font-weight: var(--font-medium);
+      line-height: var(--leading-normal);
+      padding: 0;
+      text-align: center;
+    }
+
+    span {
+      border-color: var(--color-border);
+    }
+
+    span:hover {
+      background: transparent;
+    }
+
+    span.arrowUp::after {
+      border-bottom-color: var(--color-text);
+    }
+
+    span.arrowDown::after {
+      border-top-color: var(--color-text);
+    }
+
+    &:hover {
+      background: transparent;
+    }
+  }
+
+  .flatpickr-weekday {
+    color: var(--color-text-subtle);
+    font-weight: var(--font-normal);
+  }
+
+  .flatpickr-time {
+    .hasTime & {
+      border-top-color: var(--color-border);
+    }
+
+    .hasTime.noCalendar & {
+      border: 0;
+    }
+
+    .numInput {
+      background: transparent;
+      color: var(--color-text);
+    }
+
+    .flatpickr-time-separator {
+      color: var(--color-text);
+    }
+
+    .flatpickr-am-pm {
+      background: transparent;
+      color: var(--color-text);
+    }
+  }
+
+  .flatpickr-day {
+    border-radius: var(--rounded-md);
+    border-color: transparent !important;
+    box-shadow: none !important;
+    color: var(--color-text);
+    height: var(--day-size);
+    line-height: var(--day-size);
+    margin-block-start: var(--size-2);
+    max-width: var(--day-size);
+
+    &:is(.inRange) {
+      border-radius: 0;
+    }
+
+    &:is(.today, .inRange, :hover, :focus) {
+      background: var(--color-secondary);
+      color: var(--color-text);
+    }
+
+    &:is(
+      .flatpickr-disabled,
+      .flatpickr-disabled:hover,
+      .prevMonthDay,
+      .nextMonthDay,
+      .notAllowed,
+      .notAllowed.prevMonthDay,
+      .notAllowed.nextMonthDay
+    ) {
+      color: var(--color-text-subtle);
+    }
+
+    &:is(
+      .selected,
+      .startRange,
+      .endRange,
+      .selected.inRange,
+      .startRange.inRange,
+      .endRange.inRange,
+      .selected:focus,
+      .startRange:focus,
+      .endRange:focus,
+      .selected:hover,
+      .startRange:hover,
+      .endRange:hover,
+      .selected.prevMonthDay,
+      .startRange.prevMonthDay,
+      .endRange.prevMonthDay,
+      .selected.nextMonthDay,
+      .startRange.nextMonthDay,
+      .endRange.nextMonthDay
+    ) {
+      background: var(--color-primary);
+      color: var(--color-text-reversed);
+    }
+  }
+
+  &::before, &::after {
+    display: none;
+  }
+}

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

@@ -0,0 +1,36 @@
+.switch {
+  appearance: none;
+  background-color: var(--color-border);
+  border-color: transparent;
+  border-radius: var(--rounded-full);
+  border-width: var(--border-2);
+  block-size: var(--size-5);
+  inline-size: var(--size-9);
+  transition: background-color var(--time-150);
+
+  &:checked {
+    background-color: var(--color-primary);
+  }
+
+  &:checked::before {
+    margin-inline-start: var(--size-4);
+  }
+
+  &::before {
+    aspect-ratio: var(--aspect-square);
+    background-color: var(--color-text-reversed);
+    block-size: var(--size-full);
+    border-radius: var(--rounded-full);
+    content: "";
+    display: block;
+    transition: margin var(--time-150);
+  }
+
+  &:focus-visible {
+    outline: var(--border-2) solid var(--color-selected-dark);
+  }
+
+  &:disabled {
+    cursor: not-allowed; opacity: var(--opacity-50);
+  }
+}

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

@@ -0,0 +1,98 @@
+/* Tag Manager Container */
+.breadcrumb-container {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  flex-wrap: wrap;
+}
+
+.breadcrumb-tags {
+  display: flex;
+  align-items: center;
+}
+
+/* Tag Manager */
+.tag-manager {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.tag-list {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+}
+
+/* Individual Tag */
+.tag {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.25rem;
+  padding: 0.25rem 0.5rem;
+  background-color: var(--color-background-secondary);
+  border: 1px solid var(--color-border);
+  border-radius: 0.375rem;
+  font-size: 0.875rem;
+  line-height: 1.25;
+  white-space: nowrap;
+}
+
+/* Tag Remove Button */
+.tag-remove {
+  all: unset;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 1rem;
+  height: 1rem;
+  padding: 0;
+  margin: 0;
+  background: none;
+  border: none;
+  cursor: pointer;
+  color: currentColor;
+  opacity: 0.6;
+  transition: opacity 0.15s ease;
+}
+
+.tag-remove:hover {
+  opacity: 1;
+}
+
+.tag-remove span {
+  font-size: 1.25rem;
+  line-height: 1;
+  font-weight: bold;
+}
+
+/* Add Tag Container */
+.tag-add-container {
+  position: relative;
+  display: inline-block;
+}
+
+.tag-add-button {
+  padding: 0.25rem 0.5rem;
+  font-size: 0.875rem;
+  line-height: 1.25;
+  white-space: nowrap;
+}
+
+/* Responsive Design */
+@media (max-width: 768px) {
+  .breadcrumb-container {
+    flex-direction: column;
+    align-items: flex-start;
+  }
+
+  .breadcrumb-tags {
+    width: 100%;
+  }
+
+  .tag-manager {
+    width: 100%;
+  }
+}

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

@@ -34,3 +34,29 @@
 .max-w-md { max-width: 28rem; }
 .max-w-lg { max-width: 32rem; }
 .max-w-xl { max-width: 36rem; }
+
+/* Global filters active indicator */
+.global-filters-active {
+  position: relative;
+}
+
+.global-filters-active::after {
+  content: "";
+  position: absolute;
+  top: -2px;
+  right: -2px;
+  width: 8px;
+  height: 8px;
+  background-color: var(--color-primary);
+  border-radius: 50%;
+  border: 2px solid var(--color-bg);
+}
+
+/* Flatpickr z-index fix - ensure calendar appears above dialogs */
+.flatpickr-calendar,
+.flatpickr-calendar.open,
+.flatpickr-calendar.inline,
+.flatpickr-calendar.static,
+.flatpickr-calendar.static.open {
+  z-index: 999999 !important;
+}

data/app/controllers/concerns/response_range_concern.rb

@@ -5,9 +5,11 @@ module ResponseRangeConcern
     ransack_params = params[:q] || {}
     thresholds = RailsPulse.configuration.public_send("#{type}_thresholds")
 
-    # Check both avg_duration (for Summary) and duration (for Request/Operation)
-    duration_param = ransack_params[:avg_duration] || ransack_params[:duration]
+    # Check all duration-related parameters
+    # avg_duration for Summary, duration for Request/Operation, duration_gteq for direct Ransack filtering
+    duration_param = ransack_params[:avg_duration] || ransack_params[:duration] || ransack_params[:duration_gteq]
 
+    # Priority 1: Page-specific duration filter
     if duration_param.present?
       selected_range = duration_param
       start_duration =
@@ -17,6 +19,17 @@ module ResponseRangeConcern
         when :critical then thresholds[:critical]
         else 0
         end
+    # Priority 2: Global performance threshold filter
+    elsif (global_threshold = session_global_filters["performance_threshold"]).present?
+      selected_range = global_threshold.to_sym
+      start_duration =
+        case global_threshold.to_sym
+        when :slow then thresholds[:slow]
+        when :very_slow then thresholds[:very_slow]
+        when :critical then thresholds[:critical]
+        else 0
+        end
+    # Priority 3: No filter (show all)
     else
       start_duration = 0
       selected_range = :all