solidstats 3.0.0.beta.1 → 3.0.0

data/app/services/solidstats/my_todo_service.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
-require 'find'
-require 'json'
+require "find"
+require "json"
 
 module Solidstats
   # Enhanced TODO service for comprehensive project scanning
   class MyTodoService
-    CACHE_FILE = Rails.root.join('solidstats', 'todos.json')
+    CACHE_FILE = Rails.root.join("solidstats", "todos.json")
     CACHE_DURATION = 24.hours
-    
+
     TODO_PATTERNS = [
       /TODO:?\s*(.+)/i,
       /FIXME:?\s*(.+)/i,
@@ -16,19 +16,19 @@ module Solidstats
       /NOTE:?\s*(.+)/i,
       /BUG:?\s*(.+)/i
     ].freeze
-    
+
     SCAN_EXTENSIONS = %w[.rb .js .html .erb .yml .yaml .json .css .scss .vue .jsx .tsx .ts].freeze
     EXCLUDE_DIRS = %w[node_modules vendor tmp log public/assets .git coverage pkg app/assets/builds solidstats].freeze
-    
+
     def self.collect_todos(force_refresh: false)
       return cached_todos unless force_refresh || cache_expired?
-      
+
       todos = scan_project_files
       cache_todos(todos)
       update_summary_json(todos)
       todos
     end
-    
+
     def self.get_summary
       todos = collect_todos
       {
@@ -44,31 +44,31 @@ module Solidstats
         last_updated: Time.current.iso8601
       }
     end
-    
+
     private
-    
+
     def self.scan_project_files
       todos = []
       exclude_patterns = load_gitignore_patterns
-      
+
       Find.find(Rails.root) do |path|
         if File.directory?(path)
           Find.prune if should_exclude_directory?(path, exclude_patterns)
           next
         end
-        
+
         next unless should_scan_file?(path)
         next if excluded_by_gitignore?(path, exclude_patterns)
-        
+
         scan_file_for_todos(path, todos)
       end
-      
-      todos.sort_by { |todo| [todo[:file], todo[:line_number]] }
+
+      todos.sort_by { |todo| [ todo[:file], todo[:line_number] ] }
     end
-    
+
     def self.scan_file_for_todos(file_path, todos)
-      relative_path = file_path.sub("#{Rails.root}/", '')
-      
+      relative_path = file_path.sub("#{Rails.root}/", "")
+
       File.readlines(file_path, chomp: true).each_with_index do |line, index|
         TODO_PATTERNS.each do |pattern|
           if match = line.match(pattern)
@@ -87,117 +87,117 @@ module Solidstats
     rescue => e
       Rails.logger.warn "Error scanning file #{file_path}: #{e.message}"
     end
-    
+
     def self.extract_todo_type(line)
       case line.upcase
-      when /TODO/ then 'todo'
-      when /FIXME/ then 'fixme'
-      when /HACK/ then 'hack'
-      when /NOTE/ then 'note'
-      when /BUG/ then 'bug'
-      else 'todo'
+      when /TODO/ then "todo"
+      when /FIXME/ then "fixme"
+      when /HACK/ then "hack"
+      when /NOTE/ then "note"
+      when /BUG/ then "bug"
+      else "todo"
       end
     end
-    
+
     def self.should_exclude_directory?(path, exclude_patterns)
-      relative_path = path.sub("#{Rails.root}/", '')
-      
+      relative_path = path.sub("#{Rails.root}/", "")
+
       # Check standard exclude directories
       EXCLUDE_DIRS.each do |dir|
         # Check if this directory or any parent directory matches
-        path_parts = relative_path.split('/')
+        path_parts = relative_path.split("/")
         return true if path_parts.include?(dir)
         return true if relative_path == dir
         return true if relative_path.start_with?("#{dir}/")
       end
-      
+
       # Check gitignore patterns
       return true if exclude_patterns.any? { |pattern| File.fnmatch(pattern, relative_path, File::FNM_PATHNAME) }
-      
+
       false
     end
-    
+
     def self.should_scan_file?(path)
       SCAN_EXTENSIONS.any? { |ext| path.end_with?(ext) }
     end
-    
+
     def self.excluded_by_gitignore?(file_path, exclude_patterns)
-      relative_path = file_path.sub("#{Rails.root}/", '')
+      relative_path = file_path.sub("#{Rails.root}/", "")
       exclude_patterns.any? { |pattern| File.fnmatch(pattern, relative_path, File::FNM_PATHNAME) }
     end
-    
+
     def self.load_gitignore_patterns
-      gitignore_path = Rails.root.join('.gitignore')
+      gitignore_path = Rails.root.join(".gitignore")
       return [] unless File.exist?(gitignore_path)
-      
+
       patterns = []
       File.readlines(gitignore_path, chomp: true).each do |line|
         line = line.strip
-        next if line.empty? || line.start_with?('#')
-        
+        next if line.empty? || line.start_with?("#")
+
         # Convert gitignore patterns to fnmatch patterns
-        pattern = line.gsub(/\*\*/, '*')
-        pattern = pattern.chomp('/')
+        pattern = line.gsub(/\*\*/, "*")
+        pattern = pattern.chomp("/")
         patterns << pattern
-        patterns << "#{pattern}/*" if !pattern.include?('*')
+        patterns << "#{pattern}/*" if !pattern.include?("*")
       end
-      
+
       patterns
     end
-    
+
     def self.cached_todos
       return [] unless File.exist?(CACHE_FILE)
-      
+
       JSON.parse(File.read(CACHE_FILE), symbolize_names: true)
     rescue JSON::ParserError
       []
     end
-    
+
     def self.cache_todos(todos)
       FileUtils.mkdir_p(File.dirname(CACHE_FILE))
       File.write(CACHE_FILE, todos.to_json)
     end
-    
+
     def self.cache_expired?
       return true unless File.exist?(CACHE_FILE)
-      
+
       File.mtime(CACHE_FILE) < CACHE_DURATION.ago
     end
-    
+
     def self.update_summary_json(todos)
-      summary_file_path = Rails.root.join('solidstats', 'summary.json')
-      
+      summary_file_path = Rails.root.join("solidstats", "summary.json")
+
       # Ensure directory exists
       FileUtils.mkdir_p(File.dirname(summary_file_path))
-      
+
       # Read existing summary or create new one
       begin
         existing_summary = File.exist?(summary_file_path) ? JSON.parse(File.read(summary_file_path)) : {}
       rescue JSON::ParserError
         existing_summary = {}
       end
-      
+
       # Calculate TODO statistics
       todo_count = todos.length
       status = determine_status(todos)
       type_counts = todos.group_by { |t| t[:type] }.transform_values(&:count)
-      
+
       # Create badges based on TODO types and counts
       badges = []
       badges << { "text" => "#{todo_count} Items", "color" => "info" }
-      
+
       %w[todo fixme hack note bug].each do |type|
         count = type_counts[type] || 0
         if count > 0
           color = case type
-                  when 'fixme' then 'warning'
-                  when 'hack', 'bug' then 'error'
-                  else 'info'
-                  end
+          when "fixme" then "warning"
+          when "hack", "bug" then "error"
+          else "info"
+          end
           badges << { "text" => "#{type.upcase}: #{count}", "color" => color }
         end
       end
-      
+
       # Update the TODO items entry
       existing_summary["TODO Items"] = {
         "icon" => "list-todo",
@@ -207,21 +207,21 @@ module Solidstats
         "url" => "/solidstats/productivity/my_todos",
         "badges" => badges
       }
-      
+
       # Write updated summary
       File.write(summary_file_path, JSON.pretty_generate(existing_summary))
       Rails.logger.info("Updated summary.json with TODO items")
     rescue => e
       Rails.logger.error("Failed to update summary.json: #{e.message}")
     end
-    
+
     def self.determine_status(todos)
       return "success" if todos.empty?
-      
-      fixme_count = todos.count { |t| t[:type] == 'fixme' }
-      hack_count = todos.count { |t| t[:type] == 'hack' }
-      bug_count = todos.count { |t| t[:type] == 'bug' }
-      
+
+      fixme_count = todos.count { |t| t[:type] == "fixme" }
+      hack_count = todos.count { |t| t[:type] == "hack" }
+      bug_count = todos.count { |t| t[:type] == "bug" }
+
       if bug_count > 0 || hack_count > 0
         "error"
       elsif fixme_count > 0 || todos.length > 20
@@ -230,7 +230,7 @@ module Solidstats
         "success"
       end
     end
-    
+
     def self.generate_message(count)
       case count
       when 0 then "No items found"

data/app/services/solidstats/style_patrol_service.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
-require 'fileutils'
-require 'json'
+require "fileutils"
+require "json"
 
 module Solidstats
   class StylePatrolService
     CACHE_KEY = "style_patrol_data"
     CACHE_DURATION = 6.hours
-    STANDARD_JSON_FILE = Rails.root.join('solidstats', 'standard.json')
+    STANDARD_JSON_FILE = Rails.root.join("solidstats", "standard.json")
 
     def self.collect_data(force_refresh: false)
       return cached_data unless force_refresh || cache_expired?
-      
+
       analysis_data = analyze_code_quality
       cache_data(analysis_data)
       save_to_standard_json(analysis_data)
@@ -40,10 +40,10 @@ module Solidstats
 
     def self.analyze_code_quality
       result = `standardrb --format json 2>&1`
-      
+
       # Extract JSON from output (may contain debug info or other text)
       json_content = extract_json_from_output(result)
-      
+
       if json_content.nil?
         # No JSON found - could be clean result or error
         if $?.success?
@@ -51,9 +51,9 @@ module Solidstats
           {
             status: "clean",
             issues: [],
-            summary: { 
-              total_files: 0, 
-              total_offenses: 0, 
+            summary: {
+              total_files: 0,
+              total_offenses: 0,
               correctable_count: 0,
               target_file_count: 0,
               inspected_file_count: 0
@@ -90,10 +90,10 @@ module Solidstats
 
     def self.process_standard_output(json_data)
       issues = []
-      
+
       # Handle StandardRB JSON format
       files = json_data["files"] || []
-      
+
       files.each do |file_data|
         file_data["offenses"]&.each do |offense|
           issues << {
@@ -110,7 +110,7 @@ module Solidstats
 
       # Get summary from StandardRB output
       summary_data = json_data["summary"] || {}
-      
+
       {
         status: issues.any? ? "issues_found" : "clean",
         issues: issues,
@@ -140,7 +140,7 @@ module Solidstats
     def self.cache_expired?
       cached_entry = Rails.cache.read(CACHE_KEY)
       return true if cached_entry.nil?
-      
+
       cached_time = Time.parse(cached_entry[:analyzed_at])
       Time.current > cached_time + CACHE_DURATION
     rescue
@@ -150,46 +150,46 @@ module Solidstats
     def self.calculate_health_score(data)
       return 100 if data[:status] == "clean"
       return 0 if data[:status] == "error"
-      
+
       total_offenses = data.dig(:summary, :total_offenses) || 0
       total_files = data.dig(:summary, :total_files) || 1
-      
+
       # Health score: 100 - (offenses per file * 10), minimum 0
       score = 100 - ((total_offenses.to_f / total_files) * 10).round
-      [score, 0].max
+      [ score, 0 ].max
     end
 
     def self.update_summary_json(data)
-      summary_file_path = Rails.root.join('solidstats', 'summary.json')
-      
+      summary_file_path = Rails.root.join("solidstats", "summary.json")
+
       # Ensure directory exists
       FileUtils.mkdir_p(File.dirname(summary_file_path))
-      
+
       # Read existing summary or create new one
       begin
         existing_summary = File.exist?(summary_file_path) ? JSON.parse(File.read(summary_file_path)) : {}
       rescue JSON::ParserError
         existing_summary = {}
       end
-      
+
       # Calculate style patrol statistics
       total_offenses = data.dig(:summary, :total_offenses) || 0
       correctable_count = data.dig(:summary, :correctable_count) || 0
       status = determine_dashboard_status(data[:status], total_offenses)
       health_score = calculate_health_score(data)
-      
+
       # Create badges based on code quality metrics
       badges = []
       badges << { "text" => "Health: #{health_score}%", "color" => health_badge_color(health_score) }
-      
+
       if total_offenses > 0
         badges << { "text" => "#{total_offenses} Issues", "color" => "warning" }
-        
+
         if correctable_count > 0
           badges << { "text" => "#{correctable_count} Auto-fixable", "color" => "info" }
         end
       end
-      
+
       # Update the StylePatrol entry
       existing_summary["StylePatrol"] = {
         "icon" => "code",
@@ -199,7 +199,7 @@ module Solidstats
         "url" => "/solidstats/quality/style_patrol",
         "badges" => badges
       }
-      
+
       # Write updated summary
       File.write(summary_file_path, JSON.pretty_generate(existing_summary))
       Rails.logger.info("Updated summary.json with StylePatrol data")
@@ -246,7 +246,7 @@ module Solidstats
     def self.save_to_standard_json(data)
       # Ensure directory exists
       FileUtils.mkdir_p(File.dirname(STANDARD_JSON_FILE))
-      
+
       # Prepare data for standard.json file
       standard_data = {
         last_updated: data[:analyzed_at],
@@ -257,7 +257,7 @@ module Solidstats
         processed_summary: data[:summary] || {},
         issues_count: data[:issues]&.count || 0
       }
-      
+
       # Write to standard.json file
       File.write(STANDARD_JSON_FILE, JSON.pretty_generate(standard_data))
       Rails.logger.info("Saved StandardRB data to #{STANDARD_JSON_FILE}")
@@ -268,47 +268,47 @@ module Solidstats
     def self.extract_json_from_output(output)
       # Look for JSON content - should start with { and end with }
       # Handle cases where debug info or other text appears before/after JSON
-      
+
       return nil if output.nil? || output.strip.empty?
-      
+
       # Split by lines and look for the line that starts with JSON
       lines = output.split("\n")
       json_lines = []
       json_started = false
       brace_count = 0
-      
+
       lines.each do |line|
         # Skip debug lines that mention "Subprocess Debugger", "ruby-debug-ide", etc.
-        next if line.include?("Subprocess Debugger") || 
-                line.include?("ruby-debug-ide") || 
+        next if line.include?("Subprocess Debugger") ||
+                line.include?("ruby-debug-ide") ||
                 line.include?("debase") ||
                 line.include?("listens on")
-        
+
         # Look for the start of JSON (line starting with {)
-        if !json_started && line.strip.start_with?('{')
+        if !json_started && line.strip.start_with?("{")
           json_started = true
         end
-        
+
         if json_started
           json_lines << line
-          
+
           # Count braces to know when JSON ends
-          brace_count += line.count('{') - line.count('}')
-          
+          brace_count += line.count("{") - line.count("}")
+
           # If we've closed all braces, we've reached the end of JSON
           break if brace_count == 0
         end
       end
-      
+
       return nil if json_lines.empty?
-      
+
       json_content = json_lines.join("\n")
-      
+
       # Validate that it looks like StandardRB JSON by checking for expected structure
-      return nil unless json_content.include?('"metadata"') || 
-                        json_content.include?('"files"') || 
+      return nil unless json_content.include?('"metadata"') ||
+                        json_content.include?('"files"') ||
                         json_content.include?('"summary"')
-      
+
       json_content
     rescue => e
       Rails.logger.error("Error extracting JSON from StandardRB output: #{e.message}")

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

@@ -4,7 +4,7 @@
   <title>Solidstats</title>
   <%= csrf_meta_tags %>
   <%= csp_meta_tag %>
-  
+
   <!-- Solidstats CDN Dependencies -->
   <%= solidstats_cdn_dependencies %>
 

data/app/views/solidstats/shared/_quick_actions.html.erb

@@ -10,7 +10,7 @@
     <div class="grid grid-cols-2 md:grid-cols-4 gap-4">
       <% quick_actions.each do |action| %>
         <button class="btn btn-outline btn-sm group flex flex-col items-center p-4 h-auto min-h-16 
-                       hover:btn-<%= action[:color] %> transition-all duration-200" disabled>
+                       hover:btn-<%= action[:color] %> transition-all duration-200">
           <div class="w-10 h-10 bg-gradient-to-r from-<%= action[:color] %>-500 to-<%= action[:color] %>-600 
                       rounded-lg flex items-center justify-center mb-2 
                       group-hover:scale-110 transition-transform duration-200 shadow-lg">

data/config/routes.rb

@@ -7,17 +7,17 @@ Solidstats::Engine.routes.draw do
   get "logs/size", to: "logs#logs_size", as: :logs_size
   post "logs/truncate/:filename", to: "logs#truncate", as: :truncate_log, constraints: { filename: /.+/ }
   post "logs/refresh", to: "logs#refresh", as: :refresh_logs
-  
+
   # Security-related routes
   get "securities/bundler_audit", to: "securities#bundler_audit", as: :securities_bundler_audit
   post "securities/refresh_bundler_audit", to: "securities#refresh_bundler_audit", as: :refresh_securities_bundler_audit
-  
+
   # Quality-related routes
   get "quality/style_patrol", to: "quality#style_patrol", as: :quality_style_patrol
   post "quality/refresh_style_patrol", to: "quality#refresh_style_patrol", as: :refresh_quality_style_patrol
   get "quality/coverage_compass", to: "quality#coverage_compass", as: :quality_coverage_compass
   post "quality/refresh_coverage_compass", to: "quality#refresh_coverage_compass", as: :refresh_quality_coverage_compass
-  
+
   # Productivity-related routes
   resources :productivity, only: [] do
     collection do
@@ -25,7 +25,7 @@ Solidstats::Engine.routes.draw do
       post :refresh_todos
     end
   end
-  
+
   # Performance-related routes
   resources :performance, only: [] do
     collection do

data/lib/generators/solidstats/clean/clean_generator.rb

@@ -0,0 +1,24 @@
+require "rails/generators/base"
+
+module Solidstats
+  module Generators
+    # This generator cleans up Solidstats data by invoking the Rake task
+    #
+    # @example
+    #   $ rails generate solidstats:clean
+    #   or
+    #   $ rake solidstats:clean
+    class CleanGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+      desc "Cleans up Solidstats data in your Rails application"
+
+      def run_clean_task
+        rake "solidstats:clean"
+      end
+
+      def show_readme
+        readme "README" if behavior == :invoke
+      end
+    end
+  end
+end

data/lib/generators/solidstats/clean/templates/README

@@ -0,0 +1,8 @@
+The Solidstats cleanup task has been executed.
+
+All generated data, including JSON files and caches in the 'solidstats' directory, have been removed.
+
+You can run this task again at any time by executing:
+  `rails generate solidstats:clean`
+or
+  `rake solidstats:clean`

data/lib/generators/solidstats/install/install_generator.rb

@@ -2,7 +2,7 @@ require "rails/generators/base"
 
 module Solidstats
   module Generators
-    # This generator installs Solidstats routes in the host application
+    # This generator installs Solidstats in the host application
     #
     # @example
     #   $ rails generate solidstats:install
@@ -17,13 +17,19 @@ module Solidstats
       desc "Installs Solidstats in your Rails application"
 
       def add_routes
-        route_code = <<-RUBY
+        route_string = %Q(mount Solidstats::Engine => "/solidstats")
+        route_code = %Q(
   # Solidstats Routes (development only)
-  mount Solidstats::Engine => "/solidstats" if Rails.env.development?
-        RUBY
+  #{route_string} if Rails.env.development?
+        )
 
-        route route_code
-        say_status :routes, "Mounting Solidstats engine at /solidstats (development environment only)", :green
+        # Check if the route already exists
+        if File.read(File.join(destination_root, "config", "routes.rb")).include?(route_string)
+          say_status :skip, "Solidstats route already exists", :yellow
+        else
+          route route_code.strip
+          say_status :routes, "Mounting Solidstats engine at /solidstats (development only)", :green
+        end
       end
 
       def create_solidstats_directory
@@ -35,23 +41,32 @@ module Solidstats
       def add_to_gitignore
         gitignore_path = File.join(destination_root, ".gitignore")
         gitignore_content = "\n# Solidstats data directory\nsolidstats/\n"
-        
+
         if File.exist?(gitignore_path)
-          existing_content = File.read(gitignore_path)
-          unless existing_content.include?("solidstats/")
-            append_to_file ".gitignore", gitignore_content
-            say_status :update, ".gitignore to exclude solidstats directory", :green
-          else
-            say_status :skip, ".gitignore already contains solidstats exclusion", :yellow
-          end
+          append_to_file ".gitignore", gitignore_content unless File.read(gitignore_path).include?("solidstats/")
         else
           create_file ".gitignore", gitignore_content.strip
-          say_status :create, ".gitignore with solidstats exclusion", :green
         end
+        say_status :update, ".gitignore to exclude solidstats directory", :green
       end
 
-      def show_readme
-        readme "README" if behavior == :invoke
+      def show_next_steps
+        say ""
+        say "✅ Solidstats has been installed successfully!", :green
+        say ""
+        say "To get started, you need to prime the data for the dashboard."
+        say "You can prime data for all services at once by running:", :yellow
+        say "  rake solidstats:prime:all", :cyan
+        say ""
+        say "Or, you can run them individually:", :yellow
+        say "  rake solidstats:prime:log_size"
+        say "  rake solidstats:prime:bundler_audit"
+        say "  rake solidstats:prime:todos"
+        say "  rake solidstats:prime:style_patrol"
+        say "  rake solidstats:prime:coverage"
+        say "  rake solidstats:prime:load_lens"
+        say ""
+        say "After the tasks complete, start your server and visit http://localhost:3000/solidstats to see the dashboard."
       end
     end
   end