devformance 0.1.0

data/app/assets/stylesheets/devmetrics/dashboard.css

@@ -0,0 +1,476 @@
+/* ============================================================
+   DevMetrics — File Panel UI
+   ============================================================ */
+
+/* ── File row wrapper ────────────────────────────────────── */
+.dm-file-row {
+  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
+}
+
+.dm-file-row:last-child {
+  border-bottom: none;
+}
+
+/* ── Collapsed header ────────────────────────────────────── */
+.dm-file-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 16px;
+  cursor: pointer;
+  user-select: none;
+  transition: background 0.1s;
+  min-height: 42px;
+}
+
+.dm-file-header:hover {
+  background: rgba(255, 255, 255, 0.025);
+}
+
+/* ── Chevron ─────────────────────────────────────────────── */
+.dm-chevron {
+  font-size: 9px;
+  color: #4b5563;
+  width: 12px;
+  flex-shrink: 0;
+  transition: transform 0.15s ease;
+  line-height: 1;
+}
+
+.dm-chevron--open {
+  transform: rotate(90deg);
+}
+
+/* ── Status dot ──────────────────────────────────────────── */
+.dm-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  flex-shrink: 0;
+}
+
+.dm-dot--pending {
+  background: #2d3748;
+  border: 1px solid #4a5568;
+}
+
+.dm-dot--running {
+  background: #f59e0b;
+  animation: dm-pulse 1.2s ease infinite;
+}
+
+.dm-dot--passed {
+  background: #10b981;
+}
+
+.dm-dot--failed {
+  background: #ef4444;
+}
+
+.dm-dot--error {
+  background: #ef4444;
+}
+
+@keyframes dm-pulse {
+
+  0%,
+  100% {
+    opacity: 1;
+  }
+
+  50% {
+    opacity: 0.3;
+  }
+}
+
+/* ── File name ───────────────────────────────────────────── */
+.dm-file-name {
+  flex: 1;
+  font-family: "JetBrains Mono", "SF Mono", "Fira Code", monospace;
+  font-size: 12.5px;
+  color: #cbd5e1;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+/* ── Header right meta (duration + badges) ───────────────── */
+.dm-file-meta {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  flex-shrink: 0;
+}
+
+/* ── File loader / spinner ───────────────────────────────── */
+.dm-file-loader {
+  display: inline-flex;
+  align-items: center;
+  margin-left: 4px;
+  flex-shrink: 0;
+}
+
+.dm-spinner--xs {
+  width: 12px;
+  height: 12px;
+  border: 1.5px solid rgba(255, 255, 255, 0.1);
+  border-top-color: #f59e0b;
+  border-radius: 50%;
+  animation: dm-spin 0.7s linear infinite;
+}
+
+@keyframes dm-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+/* ── Progress bar ────────────────────────────────────────── */
+.dm-progress-bar {
+  height: 2px;
+  background: rgba(255, 255, 255, 0.04);
+}
+
+.dm-progress-fill {
+  height: 100%;
+  background: #f59e0b;
+  transition: width 0.3s ease-out;
+}
+
+.dm-progress-fill--passed {
+  background: #10b981;
+}
+
+.dm-progress-fill--failed {
+  background: #ef4444;
+}
+
+/* ── Expanded panel ──────────────────────────────────────── */
+.dm-panel {
+  display: none;
+  border-top: 1px solid rgba(255, 255, 255, 0.06);
+  height: 260px;
+  overflow: hidden;
+}
+
+.dm-panel--open {
+  display: flex;
+}
+
+/* ── Terminal (left pane) ────────────────────────────────── */
+.dm-terminal {
+  flex: 1;
+  min-width: 0;
+  padding: 10px 14px;
+  overflow-y: auto;
+  background: #080d14;
+  font-family: "JetBrains Mono", "SF Mono", "Fira Code", monospace;
+  font-size: 11.5px;
+  line-height: 1.75;
+}
+
+.dm-terminal::-webkit-scrollbar {
+  width: 4px;
+}
+
+.dm-terminal::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+.dm-terminal::-webkit-scrollbar-thumb {
+  background: #2d3748;
+  border-radius: 2px;
+}
+
+/* Terminal line types */
+.dm-term-line {
+  white-space: pre-wrap;
+  word-break: break-all;
+}
+
+.dm-term-line--command {
+  color: #4b5563;
+  font-size: 10.5px;
+  margin-bottom: 5px;
+}
+
+.dm-term-line--pass {
+  color: #4ade80;
+}
+
+.dm-term-line--fail {
+  color: #f87171;
+}
+
+.dm-term-line--error {
+  color: #f87171;
+}
+
+.dm-term-line--pending {
+  color: #fbbf24;
+}
+
+.dm-term-line--slow {
+  color: #fbbf24;
+}
+
+.dm-term-line--n1 {
+  color: #fb7185;
+}
+
+.dm-term-line--summary {
+  color: #e2e8f0;
+  font-weight: 600;
+  margin-top: 4px;
+}
+
+.dm-term-line--info {
+  color: #374151;
+}
+
+.dm-term-separator {
+  border-top: 1px solid rgba(255, 255, 255, 0.07);
+  margin: 8px 0 4px;
+}
+
+/* ── Sidebar (right pane) ────────────────────────────────── */
+.dm-sidebar {
+  width: 188px;
+  flex-shrink: 0;
+  border-left: 1px solid rgba(255, 255, 255, 0.06);
+  background: #060b12;
+  padding: 10px 10px 8px;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  overflow-y: auto;
+  font-size: 11px;
+}
+
+.dm-sidebar::-webkit-scrollbar {
+  width: 3px;
+}
+
+.dm-sidebar::-webkit-scrollbar-thumb {
+  background: #1e293b;
+  border-radius: 2px;
+}
+
+/* ── Stat card ───────────────────────────────────────────── */
+.dm-sidebar-stat {
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+  background: rgba(255, 255, 255, 0.025);
+  border: 1px solid rgba(255, 255, 255, 0.05);
+  border-radius: 6px;
+  padding: 7px 8px 6px;
+}
+
+.dm-sidebar-stat-hd {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+
+.dm-sidebar-icon {
+  width: 14px;
+  height: 14px;
+  flex-shrink: 0;
+  opacity: 0.55;
+}
+
+.dm-sidebar-icon--slow {
+  color: #f59e0b;
+}
+
+.dm-sidebar-icon--n1 {
+  color: #fb7185;
+}
+
+.dm-sidebar-icon--cov {
+  color: #34d399;
+}
+
+.dm-sidebar-label {
+  flex: 1;
+  font-size: 9px;
+  font-weight: 700;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: #4b5563;
+  white-space: nowrap;
+}
+
+.dm-sidebar-value {
+  font-family: "JetBrains Mono", monospace;
+  font-size: 13px;
+  font-weight: 700;
+  color: #475569;
+  line-height: 1;
+  min-width: 20px;
+  text-align: right;
+}
+
+.dm-sidebar-value--slow {
+  color: #d97706;
+}
+
+.dm-sidebar-value--n1 {
+  color: #fb7185;
+}
+
+.dm-sidebar-value--cov {
+  color: #34d399;
+  font-size: 14px;
+}
+
+/* ── Item list (below stat header) ──────────────────────── */
+.dm-sidebar-items {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  max-height: 52px;
+  overflow-y: auto;
+}
+
+.dm-sidebar-items:empty {
+  display: none;
+}
+
+.dm-sidebar-items::-webkit-scrollbar {
+  width: 2px;
+}
+
+.dm-sidebar-items::-webkit-scrollbar-thumb {
+  background: #1e293b;
+  border-radius: 1px;
+}
+
+.dm-sidebar-item {
+  font-family: "JetBrains Mono", monospace;
+  font-size: 9.5px;
+  color: #374151;
+  line-height: 1.4;
+  word-break: break-all;
+  border-top: 1px solid rgba(255, 255, 255, 0.04);
+  padding-top: 2px;
+}
+
+.dm-sidebar-item--slow {
+  color: #92400e;
+}
+
+.dm-sidebar-item--n1 {
+  color: #9f1239;
+}
+
+/* ── Download log link ───────────────────────────────────── */
+.dm-sidebar-log {
+  margin-top: auto;
+  padding-top: 4px;
+}
+
+.dm-log-link {
+  display: none;
+  align-items: center;
+  gap: 5px;
+  color: #3b82f6;
+  font-size: 10px;
+  text-decoration: none;
+  opacity: 0.65;
+  transition: opacity 0.15s;
+  width: 100%;
+}
+
+.dm-log-link:hover {
+  opacity: 1;
+}
+
+/* ── Header badges ───────────────────────────────────────── */
+.dm-badge {
+  display: inline-flex;
+  align-items: center;
+  font-family: "JetBrains Mono", monospace;
+  font-size: 10px;
+  font-weight: 500;
+  padding: 2px 6px;
+  border-radius: 4px;
+  white-space: nowrap;
+  line-height: 16px;
+  letter-spacing: 0.01em;
+}
+
+.dm-badge--time {
+  background: rgba(255, 255, 255, 0.05);
+  color: #6b7280;
+}
+
+.dm-badge--n1 {
+  background: rgba(239, 68, 68, 0.12);
+  color: #f87171;
+  border: 1px solid rgba(239, 68, 68, 0.25);
+}
+
+.dm-badge--slow {
+  background: rgba(245, 158, 11, 0.12);
+  color: #fbbf24;
+  border: 1px solid rgba(245, 158, 11, 0.25);
+}
+
+.dm-badge--cov {
+  background: rgba(52, 211, 153, 0.12);
+  color: #34d399;
+  border: 1px solid rgba(52, 211, 153, 0.25);
+}
+
+/* ── Mode Indicator ────────────────────────────────────────── */
+.dm-mode-indicator {
+  position: fixed;
+  bottom: 16px;
+  right: 16px;
+  background: #1a1a2e;
+  border: 1px solid #fbbf24;
+  color: #fbbf24;
+  padding: 8px 16px;
+  border-radius: 8px;
+  font-size: 12px;
+  font-weight: 600;
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  z-index: 9999;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
+}
+
+.dm-mode-indicator--realtime {
+  background: #0a1929;
+  border-color: #10b981;
+  color: #10b981;
+}
+
+.dm-mode-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: currentColor;
+}
+
+.dm-mode-indicator--realtime .dm-mode-dot {
+  animation: dm-pulse 1.5s ease infinite;
+}
+
+.dm-retry-btn {
+  background: transparent;
+  border: 1px solid currentColor;
+  color: inherit;
+  padding: 4px 10px;
+  border-radius: 4px;
+  font-size: 11px;
+  cursor: pointer;
+  transition: background 0.2s;
+}
+
+.dm-retry-btn:hover {
+  background: rgba(255, 255, 255, 0.1);
+}

data/app/assets/stylesheets/devmetrics_live/application.css

@@ -0,0 +1,10 @@
+/*
+ * This is a manifest file that'll be compiled into application.css.
+ *
+ * With Propshaft, assets are served efficiently without preprocessing steps. You can still include
+ * application-wide styles in this file, but keep in mind that CSS precedence will follow the standard
+ * cascading order, meaning styles declared later in the document or manifest will override earlier ones,
+ * depending on specificity.
+ *
+ * Consider organizing styles into separate files for maintainability.
+ */

data/app/assets/tailwind/application.css

@@ -0,0 +1 @@
+@import "tailwindcss";

data/app/channels/application_cable/channel.rb

@@ -0,0 +1,4 @@
+module ApplicationCable
+  class Channel < ActionCable::Channel::Base
+  end
+end

data/app/channels/application_cable/connection.rb

@@ -0,0 +1,4 @@
+module ApplicationCable
+  class Connection < ActionCable::Connection::Base
+  end
+end

data/app/channels/devformance/metrics_channel.rb

@@ -0,0 +1,25 @@
+module Devformance
+  class MetricsChannel < ApplicationCable::Channel
+    def subscribed
+      case params[:stream_type]
+      when "run"
+        run_id = params[:run_id]
+        stream_from "devformance:run:#{run_id}" if run_id.present?
+      when "file"
+        file_key = params[:file_key]
+        run_id   = params[:run_id]
+        if file_key.present? && run_id.present?
+          stream_from "devformance:file:#{file_key}:#{run_id}"
+        end
+      else
+        stream_from "devformance:metrics"
+      end
+    end
+
+    def unsubscribed
+      stop_all_streams
+    end
+  end
+
+  DevformanceChannel = MetricsChannel
+end

data/app/controllers/application_controller.rb

@@ -0,0 +1,4 @@
+class ApplicationController < ActionController::Base
+  protect_from_forgery with: :exception
+  allow_browser versions: :modern
+end

data/app/controllers/devformance/application_controller.rb

@@ -0,0 +1,19 @@
+module Devformance
+  class ApplicationController < ActionController::Base
+    helper ::Importmap::ImportmapTagsHelper if defined?(::Importmap::ImportmapTagsHelper)
+    helper ::Turbo::FramesHelper if defined?(::Turbo::FramesHelper)
+
+    allow_browser versions: :modern if respond_to?(:allow_browser)
+    protect_from_forgery with: :exception
+
+    def icon_svg_path
+      "/devformance/icon.svg"
+    end
+    helper_method :icon_svg_path
+
+    def icon_png_path
+      "/devformance/icon.png"
+    end
+    helper_method :icon_png_path
+  end
+end

data/app/controllers/devformance/icons_controller.rb

@@ -0,0 +1,21 @@
+module Devformance
+  class IconsController < ApplicationController
+    skip_before_action :verify_authenticity_token
+
+    def svg
+      send_file(
+        Devformance::Engine.root.join("app/assets/images/icon.svg"),
+        type: "image/svg+xml",
+        disposition: "inline"
+      )
+    end
+
+    def png
+      send_file(
+        Devformance::Engine.root.join("app/assets/images/icon.png"),
+        type: "image/png",
+        disposition: "inline"
+      )
+    end
+  end
+end

data/app/controllers/devformance/metrics_controller.rb

@@ -0,0 +1,41 @@
+module Devformance
+  class MetricsController < ApplicationController
+    skip_before_action :verify_authenticity_token, only: [ :run_tests, :run_status ]
+
+    def index
+    end
+
+    def run_tests
+      result = ::Devformance::RunOrchestrator.call
+      if result[:error]
+        render json: { error: result[:error] }, status: :unprocessable_entity
+      else
+        render json: result, status: :accepted
+      end
+    end
+
+    def run_status
+      run = ::Devformance::Run.find_by(run_id: params[:run_id])
+      return render json: { error: "Not found" }, status: :not_found unless run
+
+      render json: {
+        run_id: run.run_id,
+        status: run.status,
+        files:  run.file_results.map { |r|
+          { file_key: r.file_key, file_path: r.file_path, status: r.status,
+            coverage: r.coverage, slow_query_count: r.slow_query_count, n1_count: r.n1_count }
+        }
+      }
+    end
+
+    def download_log
+      result = ::Devformance::FileResult.find_by(
+        run_id: params[:run_id], file_key: params[:file_key]
+      )
+      return render plain: "Not found", status: :not_found unless result&.log_path
+      return render plain: "Log not ready", status: :not_found unless File.exist?(result.log_path)
+
+      send_file result.log_path, type: "text/plain", disposition: "attachment"
+    end
+  end
+end

data/app/controllers/devformance/playground_controller.rb

@@ -0,0 +1,89 @@
+module Devformance
+  class PlaygroundController < ApplicationController
+    def run
+      query_string = params[:query]
+
+      unless query_string.present?
+        return render json: { status: "error", output: "Empty query" }, status: :unprocessable_entity
+      end
+
+      result = nil
+      duration = 0
+      slow_queries_detected = []
+
+      begin
+        # Enable bullet specifically for this block if possible, or track via notifications
+        ActiveSupport::Notifications.subscribe("sql.active_record") do |name, start, finish, id, payload|
+          # Only log SELECT/UPDATE/INSERT/DELETE that aren't schema
+          if payload[:sql] !~ /SCHEMA/
+            Rails.logger.debug "SQL: #{payload[:sql]}"
+          end
+        end
+
+        Bullet.start_request if defined?(Bullet)
+
+        duration = Benchmark.ms do
+          # Evaluate safely (MVP risk assumed acceptable for demo playground)
+          # Using a restricted binding or at least catching standard errors
+          # In a real app we'd build an AST or not allow eval, but for this devformance demo it's requested
+          result = eval(query_string)
+
+          # Force execution if it's an ActiveRecord::Relation
+          result = result.to_a if result.is_a?(ActiveRecord::Relation)
+        end
+
+        if defined?(Bullet) && Bullet.notification_collector.notifications_present?
+          Bullet.notification_collector.collection.each do |notification|
+            next unless notification.is_a?(Bullet::Notification::NPlusOneQuery)
+
+            # We parse out the model and association
+            model = notification.base_class rescue "Unknown"
+            suggestion = notification.body
+
+            sq = Devformance::SlowQuery.create!(
+              model_class: model,
+              line_number: caller.first.match(/:(\d+):/)&.captures&.first&.to_i || 0,
+              fix_suggestion: suggestion
+            )
+
+            slow_queries_detected << sq
+
+            ActionCable.server.broadcast("devformance:metrics", {
+              type: "new_slow_query",
+              payload: {
+                id: sq.id,
+                model_class: sq.model_class,
+                line_number: sq.line_number,
+                fix_suggestion: sq.fix_suggestion,
+                duration: duration.round(2)
+              }
+            })
+          end
+        end
+
+        Bullet.end_request if defined?(Bullet)
+
+        QueryLog.create(query: query_string, duration: duration) rescue nil
+
+        render json: {
+          status: "success",
+          duration: duration.round(2),
+          output: result.inspect.truncate(1000)
+        }
+      rescue Exception => e
+        Bullet.end_request if defined?(Bullet)
+        # Also log failed queries
+        QueryLog.create(query: query_string, duration: 0) rescue nil
+
+        render json: {
+          status: "error",
+          duration: duration.round(2),
+          output: "#{e.class}: #{e.message}\n#{e.backtrace.first(3).join("\n")}"
+        }
+      ensure
+        # Unsubscribe if we did
+        ActiveSupport::Notifications.unsubscribe("sql.active_record") rescue nil
+      end
+    end
+  end
+end

data/app/helpers/application_helper.rb

@@ -0,0 +1,9 @@
+module ApplicationHelper
+  def icon_svg_path
+    Devformance::Engine.routes.url_helpers.icon_svg_path
+  end
+
+  def icon_png_path
+    Devformance::Engine.routes.url_helpers.icon_png_path
+  end
+end