railscope 0.1.0

data/app/helpers/railscope/dashboard_helper.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module Railscope
+  module DashboardHelper
+    def entry_title(entry)
+      case entry.entry_type
+      when "request"
+        "#{entry.payload["method"]} #{entry.payload["path"]}"
+      when "query"
+        entry.payload["name"] || entry.payload["sql"].to_s.truncate(50)
+      when "exception"
+        entry.payload["class"]
+      when "job_enqueue", "job_perform"
+        entry.payload["job_class"]
+      else
+        entry.entry_type.titleize
+      end
+    end
+
+    def timeline_summary(entry)
+      case entry.entry_type
+      when "request"
+        "#{entry.payload["method"]} #{entry.payload["path"]}"
+      when "query"
+        entry.payload["sql"].to_s.truncate(40)
+      when "exception"
+        entry.payload["class"]
+      when "job_enqueue", "job_perform"
+        entry.payload["job_class"]
+      else
+        entry.entry_type
+      end
+    end
+
+    def render_json(hash, indent: 0)
+      return content_tag(:span, "null", class: "json-null") if hash.nil?
+
+      content_tag(:div, class: "json-object") do
+        safe_join(hash.map do |key, value|
+          content_tag(:div, class: "json-row", style: "padding-left: #{indent * 16}px") do
+            key_tag = content_tag(:span, "#{key}:", class: "json-key")
+            value_tag = render_json_value(value, indent: indent)
+            safe_join([key_tag, value_tag], " ")
+          end
+        end)
+      end
+    end
+
+    def render_json_value(value, indent: 0)
+      case value
+      when nil
+        content_tag(:span, "null", class: "json-null")
+      when true, false
+        content_tag(:span, value.to_s, class: "json-boolean")
+      when Numeric
+        content_tag(:span, value.to_s, class: "json-number")
+      when String
+        if value.length > 100
+          content_tag(:span, class: "json-string long") do
+            content_tag(:code, value)
+          end
+        else
+          content_tag(:span, "\"#{value}\"", class: "json-string")
+        end
+      when Array
+        if value.empty?
+          content_tag(:span, "[]", class: "json-array-empty")
+        else
+          content_tag(:div, class: "json-array") do
+            safe_join([
+                        content_tag(:span, "[", class: "json-bracket"),
+                        content_tag(:div, class: "json-array-items") do
+                          safe_join(value.map { |v| render_json_value(v, indent: indent + 1) })
+                        end,
+                        content_tag(:span, "]", class: "json-bracket")
+                      ])
+          end
+        end
+      when Hash
+        if value.empty?
+          content_tag(:span, "{}", class: "json-object-empty")
+        else
+          render_json(value, indent: indent + 1)
+        end
+      else
+        content_tag(:span, value.to_s, class: "json-string")
+      end
+    end
+
+    def render_entry_summary(entry)
+      case entry.entry_type
+      when "request"
+        render_request_summary(entry.payload)
+      when "query"
+        render_query_summary(entry.payload)
+      when "exception"
+        render_exception_summary(entry.payload)
+      when "job_enqueue", "job_perform"
+        render_job_summary(entry.payload)
+      else
+        entry.payload.to_json.truncate(100)
+      end
+    end
+
+    private
+
+    def render_request_summary(payload)
+      status_class = case payload["status"].to_i
+                     when 200..299 then "success"
+                     when 300..399 then "redirect"
+                     when 400..499 then "client-error"
+                     when 500..599 then "server-error"
+                     else "unknown"
+                     end
+
+      content_tag(:span, class: "request-summary") do
+        safe_join([
+                    content_tag(:span, payload["method"], class: "method"),
+                    content_tag(:span, payload["path"], class: "path"),
+                    content_tag(:span, payload["status"], class: "status #{status_class}"),
+                    content_tag(:span, "#{payload["duration"]}ms", class: "duration")
+                  ], " ")
+      end
+    end
+
+    def render_query_summary(payload)
+      sql = payload["sql"].to_s.truncate(80)
+      duration = payload["duration"]
+
+      content_tag(:span, class: "query-summary") do
+        safe_join([
+                    content_tag(:code, sql, class: "sql"),
+                    content_tag(:span, "#{duration}ms", class: "duration")
+                  ], " ")
+      end
+    end
+
+    def render_exception_summary(payload)
+      content_tag(:span, class: "exception-summary") do
+        safe_join([
+                    content_tag(:span, payload["class"], class: "exception-class"),
+                    content_tag(:span, payload["message"].to_s.truncate(60), class: "exception-message")
+                  ], ": ")
+      end
+    end
+
+    def render_job_summary(payload)
+      content_tag(:span, class: "job-summary") do
+        safe_join([
+          content_tag(:span, payload["job_class"], class: "job-class"),
+          content_tag(:span, "[#{payload["queue_name"]}]", class: "queue-name"),
+          payload["duration"] ? content_tag(:span, "#{payload["duration"]}ms", class: "duration") : nil
+        ].compact, " ")
+      end
+    end
+  end
+end

data/app/jobs/railscope/application_job.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Railscope
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/jobs/railscope/purge_job.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Railscope
+  class PurgeJob < ApplicationJob
+    queue_as :default
+
+    def perform
+      return unless Railscope.enabled?
+
+      deleted_count = Railscope.storage.destroy_expired!
+      Rails.logger.info("[Railscope] Purged #{deleted_count} expired entries")
+      deleted_count
+    end
+  end
+end

data/app/models/railscope/application_record.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Railscope
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+
+    # Support for separate database connection when RAILSCOPE_DATABASE_URL is configured
+    # This isolates Railscope's writes from the main application database,
+    # preventing lock contention during high-traffic periods.
+    connects_to database: { writing: :railscope, reading: :railscope } if ENV["RAILSCOPE_DATABASE_URL"].present?
+  end
+end

data/app/models/railscope/entry.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Railscope
+  class Entry < ApplicationRecord
+    self.table_name = "railscope_entries"
+
+    validates :entry_type, presence: true
+    validates :occurred_at, presence: true
+
+    # Basic scopes
+    scope :by_type, ->(type) { where(entry_type: type) }
+    scope :recent, -> { order(occurred_at: :desc) }
+    scope :with_tag, ->(tag) { where("? = ANY(tags)", tag) }
+    scope :expired, -> { where("occurred_at < ?", Railscope.retention_days.days.ago) }
+
+    # Telescope-style scopes
+    scope :displayable, -> { where(should_display_on_index: true) }
+    scope :for_batch, ->(batch_id) { where(batch_id: batch_id) }
+    scope :for_family, ->(family_hash) { where(family_hash: family_hash) }
+
+    # Find by UUID (public identifier)
+    def self.find_by_uuid!(uuid)
+      find_by!(uuid: uuid)
+    end
+
+    def self.find_by_uuid(uuid)
+      find_by(uuid: uuid)
+    end
+
+    # Get all related entries in the same batch
+    def batch_entries
+      return self.class.none if batch_id.blank?
+
+      self.class.for_batch(batch_id).where.not(id: id).order(:occurred_at)
+    end
+
+    # Get all entries with the same family_hash
+    def family_entries
+      return self.class.none if family_hash.blank?
+
+      self.class.for_family(family_hash).where.not(id: id).recent
+    end
+
+    # Count of similar entries (same family_hash)
+    def family_count
+      return 0 if family_hash.blank?
+
+      self.class.for_family(family_hash).count
+    end
+  end
+end

data/app/views/layouts/railscope/application.html.erb

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en" class="dark">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Railscope</title>
+    <%= csrf_meta_tags %>
+    <link rel="stylesheet" href="<%= railscope.root_path %>assets/app.css">
+  </head>
+  <body class="bg-[#0d1117] text-[#c9d1d9]">
+    <%= yield %>
+    <script type="module" src="<%= railscope.root_path %>assets/app.js"></script>
+  </body>
+</html>

data/app/views/railscope/application/index.html.erb

@@ -0,0 +1 @@
+<div id="root"></div>

data/app/views/railscope/dashboard/index.html.erb

@@ -0,0 +1,70 @@
+<div class="railscope-container">
+  <header class="railscope-header">
+    <h1>Railscope</h1>
+    <p class="subtitle"><%= @total_count %> entries</p>
+  </header>
+
+  <nav class="railscope-filters">
+    <%= link_to "All", root_path, class: "filter-btn #{@current_type.nil? ? 'active' : ''}" %>
+    <% @entry_types.each do |type| %>
+      <%= link_to type.titleize, root_path(type: type), class: "filter-btn #{@current_type == type ? 'active' : ''}" %>
+    <% end %>
+  </nav>
+
+  <div class="railscope-entries">
+    <% if @entries.any? %>
+      <table class="entries-table">
+        <thead>
+          <tr>
+            <th>Type</th>
+            <th>Summary</th>
+            <th>Tags</th>
+            <th>Occurred</th>
+          </tr>
+        </thead>
+        <tbody>
+          <% @entries.each do |entry| %>
+            <tr class="entry-row entry-type-<%= entry.entry_type %>" onclick="window.location='<%= entry_path(entry) %>'" style="cursor: pointer;">
+              <td class="entry-type">
+                <span class="type-badge <%= entry.entry_type %>"><%= entry.entry_type %></span>
+              </td>
+              <td class="entry-summary">
+                <%= link_to entry_path(entry), class: "entry-link" do %>
+                  <%= render_entry_summary(entry) %>
+                <% end %>
+              </td>
+              <td class="entry-tags">
+                <div class="tags-wrapper">
+                  <% entry.tags.each do |tag| %>
+                    <%= link_to tag, root_path(tag: tag, type: @current_type), class: "tag", onclick: "event.stopPropagation();" %>
+                  <% end %>
+                </div>
+              </td>
+              <td class="entry-time">
+                <span title="<%= entry.occurred_at %>"><%= time_ago_in_words(entry.occurred_at) %> ago</span>
+              </td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    <% else %>
+      <div class="empty-state">
+        <p>No entries found.</p>
+      </div>
+    <% end %>
+  </div>
+
+  <% if @total_pages > 1 %>
+    <nav class="railscope-pagination">
+      <% if @current_page > 1 %>
+        <%= link_to "Previous", root_path(page: @current_page - 1, type: @current_type, tag: params[:tag]), class: "page-btn" %>
+      <% end %>
+
+      <span class="page-info">Page <%= @current_page %> of <%= @total_pages %></span>
+
+      <% if @current_page < @total_pages %>
+        <%= link_to "Next", root_path(page: @current_page + 1, type: @current_type, tag: params[:tag]), class: "page-btn" %>
+      <% end %>
+    </nav>
+  <% end %>
+</div>

data/app/views/railscope/entries/show.html.erb

@@ -0,0 +1,93 @@
+<div class="railscope-container">
+  <header class="railscope-header">
+    <nav class="breadcrumb">
+      <%= link_to "← Back to entries", root_path, class: "back-link" %>
+    </nav>
+    <div class="entry-header">
+      <span class="type-badge <%= @entry.entry_type %>"><%= @entry.entry_type %></span>
+      <h1><%= entry_title(@entry) %></h1>
+    </div>
+  </header>
+
+  <div class="entry-detail">
+    <div class="detail-grid">
+      <div class="detail-main">
+        <section class="detail-section">
+          <h2>Details</h2>
+          <div class="detail-meta">
+            <div class="meta-item">
+              <span class="meta-label">Occurred at</span>
+              <span class="meta-value"><%= @entry.occurred_at.strftime("%Y-%m-%d %H:%M:%S.%L") %></span>
+            </div>
+            <div class="meta-item">
+              <span class="meta-label">Entry ID</span>
+              <span class="meta-value mono"><%= @entry.id %></span>
+            </div>
+            <% if @entry.payload["request_id"] %>
+              <div class="meta-item">
+                <span class="meta-label">Request ID</span>
+                <span class="meta-value mono"><%= @entry.payload["request_id"] %></span>
+              </div>
+            <% end %>
+            <% if @entry.payload["duration"] %>
+              <div class="meta-item">
+                <span class="meta-label">Duration</span>
+                <span class="meta-value"><%= @entry.payload["duration"] %>ms</span>
+              </div>
+            <% end %>
+          </div>
+        </section>
+
+        <section class="detail-section">
+          <h2>Tags</h2>
+          <div class="tags-wrapper">
+            <% @entry.tags.each do |tag| %>
+              <%= link_to tag, root_path(tag: tag), class: "tag" %>
+            <% end %>
+          </div>
+        </section>
+
+        <section class="detail-section">
+          <h2>Payload</h2>
+          <div class="json-viewer">
+            <%= render_json(@entry.payload) %>
+          </div>
+        </section>
+
+        <% if @entry.entry_type == "exception" && @entry.payload["backtrace"].present? %>
+          <section class="detail-section">
+            <h2>Backtrace</h2>
+            <div class="backtrace">
+              <% @entry.payload["backtrace"].each_with_index do |line, i| %>
+                <div class="backtrace-line">
+                  <span class="line-number"><%= i + 1 %></span>
+                  <code><%= line %></code>
+                </div>
+              <% end %>
+            </div>
+          </section>
+        <% end %>
+      </div>
+
+      <div class="detail-sidebar">
+        <% if @related_entries.any? %>
+          <section class="detail-section">
+            <h2>Timeline</h2>
+            <p class="timeline-info">Events from the same request</p>
+            <div class="timeline">
+              <% @related_entries.each do |entry| %>
+                <div class="timeline-item <%= entry.id == @entry.id ? 'current' : '' %>">
+                  <%= link_to entry_path(entry), class: "timeline-link" do %>
+                    <span class="timeline-type type-badge <%= entry.entry_type %>"><%= entry.entry_type %></span>
+                    <span class="timeline-summary"><%= timeline_summary(entry) %></span>
+                    <span class="timeline-time"><%= entry.payload["duration"] ? "#{entry.payload['duration']}ms" : "" %></span>
+                  <% end %>
+                </div>
+              <% end %>
+            </div>
+          </section>
+        <% end %>
+      </div>
+    </div>
+  </div>
+</div>

data/client/.gitignore

@@ -0,0 +1 @@
+/node_modules

data/client/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en" class="dark">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Railscope</title>
+  </head>
+  <body class="bg-dark-bg text-dark-text">
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>