code_healer 0.1.12 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c3f51b2e61939becd7c68f57c2f70cb9dacf3b98f8ff62cfa2b3593dc745cfe
-  data.tar.gz: 8acbfcd6a4e3abae5cb96a2f451c01f6dc8ac40ada877fba4ed673962e87ab83
+  metadata.gz: f357d294ca82a2aaed146acf5f716b20c3839d2cd64ec72345589a794f5b32eb
+  data.tar.gz: e4b6fff984ed96c58bf693b5252aa9747e87213cc97e80972a7cd4bbb0c1a488
 SHA512:
-  metadata.gz: 892a29730e66d2e207460dd2ede2c93b42114760a509ff05b7e17b5a28545ecb7fe1be0078d16cf7ff1f88a106a99d9e20af8ffd0baa53b8442ce2898363e1e0
-  data.tar.gz: a89f5fccbc969fd0eccc468896c0ff0532868fb9ceb6a22a1e731319f2da2f602e2917f61add01424ea4c1fb869fef47d28b7e78e379d0c52d02e9666e65663e
+  metadata.gz: 2d5f0ee58ddf888178218cf6f06dfc98ca72548938c452a31acf7fc6e59c7a22041c3c2c08a44e8e8dd28eb8406952211d78219b9ec057679a1d5fb808cf4f0c
+  data.tar.gz: 63e2cac8eceda44157e6c7afa12fbe4406ca9a5c39994298028662f1752cbf74d1be8aba566950646eeb2f4af0b9d2798e08f8f1931c328e21d9a137e0fb26e5

data/CHANGELOG.md

@@ -5,156 +5,115 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.1.12] - 2025-01-14
+## [0.1.14] - 2025-08-21
 
-### Fixed
-- **Duplicate PR creation** - Prevents duplicate pull requests when evolution handler already creates one
-- **PR workflow optimization** - Skips redundant PR creation in healing workspace manager
-
-## [0.1.11] - 2025-01-14
+### Added
+- **Dashboard UI Improvements**: Enhanced dashboard with proper HTML layout and styling
+- **Charts and Visualizations**: Added Chart.js integration for data visualization
+- **Detailed Views**: Enhanced healing details and performance metrics views
+- **Responsive Design**: Mobile-friendly dashboard interface
 
 ### Fixed
-- **Repository cloning** - Now clones from GitHub remote URL instead of local path
-- **Git remote configuration** - Ensures workspace has correct GitHub remote for PR creation
-- **Debug information** - Added Git remote and branch debugging in workspace operations
-
-## [0.1.10] - 2025-01-14
+- **SQL Compatibility**: Replaced raw SQL with Rails-native methods for better database compatibility
+- **Dashboard Controller**: Fixed controller loading and routing issues
+- **Engine Integration**: Simplified engine structure to avoid conflicts
 
 ### Changed
-- **Complete workspace isolation** - All Git operations now happen in isolated workspace only
-- **No file copying** - Removed file copying between workspace and main repo
-- **Direct PR creation** - Pull requests are created directly from the isolated workspace
-- **Main repo protection** - Main repository is never touched, only the isolated workspace
+- **Metrics Collection**: Improved performance of dashboard metrics queries
+- **UI Rendering**: Replaced plain text dashboard with proper HTML views
 
-### Fixed
-- **Git commit workflow** - Added proper change detection before committing
-- **Empty branch prevention** - Delete healing branches when no changes are detected
-- **Enhanced debugging** - Added Git status and diff logging throughout the process
+## [0.1.13] - 2025-08-21
+
+### Added
+- **Automatic Dashboard Integration**: Rails Engine automatically mounts dashboard routes
+- **Database Migrations**: Automatic migration copying and execution
+- **Dashboard Components**: Complete dashboard system with metrics, trends, and performance views
+- **API Endpoints**: JSON API for dashboard data integration
 
-## [0.1.8] - 2025-01-14
+### Fixed
+- **Git Operations**: All Git operations now occur within isolated healing workspaces
+- **PR Creation**: Fixed duplicate PR creation and repository targeting issues
+- **Workspace Management**: Improved isolated healing environment with proper cleanup
 
 ### Changed
-- **Production safety** - Healing workspace no longer modifies main directory directly
-- **Git workflow** - Changes are applied to isolated healing branches only
-- **Pull request automation** - Automatic PR creation when configured
-- **Method renaming** - `merge_fixes_back` → `create_healing_branch` for clarity
+- **Healing Workflow**: Complete isolation of healing operations from main repository
+- **Dashboard Installation**: Fully automatic dashboard setup via Rails Engine
 
-### Fixed
-- **Git operations in isolated healing workspace** - Preserved .git directory during cloning for proper Git operations
-- **Branch creation and commit operations** now work correctly in the isolated workspace
-- **Workspace cleanup** properly removes .git directory to prevent conflicts
+## [0.1.12] - 2025-08-20
 
-## [0.1.6] - 2025-01-14
+### Fixed
+- **Duplicate PR Creation**: Prevented duplicate PR creation when evolution handler already creates PRs
+- **Workspace Cleanup**: Improved cleanup of healing workspaces
 
-### Added
-- **Code heal directory permission validation** during interactive setup
-- **Repository access testing** to ensure the directory can clone and push to the target repo
-- **Write permission verification** for the code heal directory
-- **Automatic directory creation** if it doesn't exist
-- **Comprehensive error messages** with troubleshooting tips for permission issues
+## [0.1.11] - 2025-08-20
 
 ### Fixed
-- **Duplicate HealingJob class definition** that was preventing isolated healing workspace system from working
-- **Class loading conflict** between old and new healing logic
-- **Isolated healing workspace system** now properly activated
+- **Repository Cloning**: Fixed incorrect repository cloning by using GitHub remote URL instead of local path
+- **Git Remote**: Ensured workspace has correct remote origin for proper Git operations
 
-## [0.1.4] - 2025-01-14
+## [0.1.10] - 2025-08-20
 
-### Added
-- **Comprehensive logging** for isolated healing workspace system
-- **Detailed workspace creation logs** showing each step of the process
-- **Clone operation logging** with success/failure status
-- **Fix application logging** in isolated environment
-- **Workspace cleanup logging** for debugging
+### Changed
+- **Git Operations**: All Git operations (branching, committing, pushing, PR creation) now occur strictly within isolated workspace
+- **File Operations**: Removed direct file copying to main repository for complete isolation
+
+## [0.1.9] - 2025-08-20
 
 ### Fixed
-- **Workspace configuration reading** to handle both string and symbol keys
-- **Branch name sanitization** to prevent invalid Git branch names
+- **Git Commit Issues**: Added proper change detection before committing in isolated workspace
+- **File Comparison**: Enhanced file comparison logic to only copy changed files
 
-## [0.1.3] - 2025-01-14
+## [0.1.8] - 2025-08-20
 
-### Added
-- **Future Plans & Roadmap section** to README
-- Jira integration plans for business context automation
-- Confluence docs integration for domain knowledge extraction
-- PRD parsing capabilities for feature specifications
-- Git commit message analysis for business context learning
-- Slack/Teams integration for business discussions capture
-- Intelligent context discovery from existing code patterns
+### Fixed
+- **Workspace Cleanup**: Improved cleanup process to prevent Git conflicts
 
-## [0.1.2] - 2025-01-14
+## [0.1.7] - 2025-08-20
 
-### Changed
-- **Final README improvements and personalization**
-- Updated contact email to deepan.ppgit@gmail.com
-- Added LinkedIn profile link for professional networking
-- Enhanced acknowledgments to include Claude AI
-- Personalized team references to Deepan Kumar
-- Added personal signature with LinkedIn link
+### Fixed
+- **Git Working Tree**: Preserved .git directory during cloning and only removed during cleanup
 
-## [0.1.1] - 2025-01-14
+## [0.1.6] - 2025-08-20
 
-### Changed
-- **Significantly improved README documentation**
-- Enhanced setup instructions with interactive bash script guidance
-- Added comprehensive configuration explanations for all 50+ options
-- Included detailed markdown file creation guide for business context
-- Added best practices and troubleshooting sections
-- Improved installation and configuration examples
-- Enhanced advanced configuration strategies documentation
+### Fixed
+- **Branch Name Sanitization**: Improved branch name handling for Git operations
+
+## [0.1.5] - 2025-08-20
 
 ### Fixed
-- Updated repository URLs in gemspec to point to correct GitHub repo
-- Fixed executable path configuration in gemspec
+- **Duplicate Class Definition**: Removed duplicate HealingJob class definition causing Sidekiq errors
 
-## [Unreleased]
+## [0.1.4] - 2025-08-20
 
-### Added
-- Initial gem release
-- AI-powered error analysis and code generation
-- Multiple healing strategies (API, Claude Code, Hybrid)
-- Business context awareness and integration
-- Automated Git operations and PR creation
-- Background job processing with Sidekiq
-- Comprehensive YAML configuration
-- Business requirements integration from markdown files
-- Rails integration via Railtie
+### Fixed
+- **Workspace Logging**: Added comprehensive logging to isolated healing workspace system
 
-### Changed
-- Converted from standalone Rails application to gem
-- Refactored for modular architecture
-- Improved error handling and logging
-- Renamed from CodeHealer to CodeHealer
+## [0.1.3] - 2025-08-20
 
-### Deprecated
-- None
+### Fixed
+- **Configuration Keys**: Updated HealingWorkspaceManager to handle both string and symbol keys
 
-### Removed
-- None
+## [0.1.2] - 2025-08-20
 
 ### Fixed
-- Business context loading from markdown files
-- Template placeholder substitution in PR creation
-- Sidekiq job serialization issues
+- **Git Operations**: Fixed Git operations in isolated healing workspaces
+
+## [0.1.1] - 2025-08-20
 
-### Security
-- Class restriction system for security
-- Environment variable support for sensitive data
-- Business rule validation
+### Fixed
+- **Production Safety**: Enhanced production safety with isolated healing workspaces
+- **Git Integration**: Improved Git integration within isolated environments
 
-## [0.1.0] - 2025-01-13
+## [0.1.0] - 2025-08-20
 
 ### Added
-- Initial release of CodeHealer gem
-- Core healing engine
-- OpenAI API integration
-- Claude Code terminal integration
-- Business context management
-- Git operations automation
-- Sidekiq background processing
-- Comprehensive documentation
-- Example configurations
-- Test suite setup
+- **AI-Powered Code Healing**: Automatic code error detection and repair
+- **Multiple AI Providers**: Support for OpenAI API and Claude Code Terminal
+- **Business Context Integration**: MCP-powered intelligent healing with business rules
+- **Git Integration**: Automatic branch creation, commits, and pull requests
+- **Isolated Healing**: Safe code modification in isolated workspaces
+- **Dashboard System**: Metrics collection and visualization
+- **Rails Integration**: Automatic Rails application integration via Railtie
 
 ---
 

data/DASHBOARD_README.md

@@ -0,0 +1,157 @@
+# 🎯 CodeHealer Dashboard - Core Metrics & Analytics
+
+## 🚀 **Phase 1: Core Dashboard Implementation**
+
+The CodeHealer Dashboard provides real-time insights into your intelligent code healing system. This is the foundation for comprehensive analytics and monitoring.
+
+## 📊 **What's Included**
+
+### **Core Metrics Dashboard**
+- **Total Healings**: Count of all successful code fixes
+- **Success Rate**: Percentage of successful vs failed healings  
+- **Daily/Weekly/Monthly Counts**: Healing activity over time
+- **Average Resolution Time**: How long fixes take to complete
+- **AI Performance**: Success rates by evolution method and AI provider
+
+### **Real-Time Analytics**
+- **Daily Healing Trends**: Line charts showing healing activity
+- **Evolution Method Distribution**: Doughnut charts for AI strategy usage
+- **Recent Healings**: Detailed list of latest healing operations
+- **Performance Metrics**: System health and efficiency indicators
+
+## 🛠 **Setup Instructions**
+
+### **1. Database Migration**
+```bash
+# Run the migration to create the healing_metrics table
+rails generate migration CreateHealingMetrics
+# Copy the migration content from db/migrate/001_create_healing_metrics.rb
+rails db:migrate
+```
+
+### **2. Routes Integration**
+Add to your `config/routes.rb`:
+```ruby
+# CodeHealer Dashboard Routes
+namespace :code_healer do
+  get '/dashboard', to: 'dashboard#index'
+  get '/dashboard/metrics', to: 'dashboard#metrics'
+  get '/dashboard/trends', to: 'dashboard#trends'
+  get '/dashboard/performance', to: 'dashboard#performance'
+  get '/dashboard/healing/:healing_id', to: 'dashboard#healing_details'
+  
+  # API endpoints (JSON only)
+  namespace :api do
+    get '/dashboard/summary', to: 'dashboard#summary'
+    get '/dashboard/metrics', to: 'dashboard#metrics'
+    get '/dashboard/trends', to: 'dashboard#trends'
+    get '/dashboard/performance', to: 'dashboard#performance'
+    get '/dashboard/healing/:healing_id', to: 'dashboard#healing_details'
+  end
+end
+```
+
+### **3. Access the Dashboard**
+Visit: `http://your-app.com/code_healer/dashboard`
+
+## 📈 **Dashboard Features**
+
+### **Metrics Cards**
+- **Total Healings**: All-time count with visual indicators
+- **Success Rate**: Color-coded (Green: ≥80%, Yellow: 60-79%, Red: <60%)
+- **Activity Counts**: Today, this week, this month
+- **Performance**: Average resolution time in seconds
+
+### **Interactive Charts**
+- **Daily Trend Chart**: Line chart showing healing activity over 7 days
+- **Evolution Methods**: Doughnut chart showing AI strategy distribution
+- **Real-time Updates**: Charts refresh with latest data
+
+### **Recent Healings List**
+- **Class & Method**: Which code was healed
+- **Error Details**: Error class and message
+- **Status Information**: Success/failure, AI method, provider
+- **Timestamps**: When the healing occurred
+
+## 🔌 **API Endpoints**
+
+### **Dashboard Summary**
+```bash
+GET /code_healer/api/dashboard/summary
+# Returns: total_healings, success_rate, daily_counts, etc.
+```
+
+### **Detailed Metrics**
+```bash
+GET /code_healer/api/dashboard/metrics
+# Returns: filtered healing metrics with pagination
+```
+
+### **Trends & Analytics**
+```bash
+GET /code_healer/api/dashboard/trends
+# Returns: daily trends, hourly distribution, top errors
+```
+
+### **Performance Data**
+```bash
+GET /code_healer/api/dashboard/performance
+# Returns: success rates, resolution times, AI performance
+```
+
+### **Individual Healing Details**
+```bash
+GET /code_healer/api/dashboard/healing/{healing_id}
+# Returns: complete healing information with timing breakdown
+```
+
+## 🎨 **Customization**
+
+### **Styling**
+The dashboard uses a clean, modern design with:
+- Responsive grid layout
+- Card-based metric display
+- Chart.js for visualizations
+- Color-coded success indicators
+
+### **Adding New Metrics**
+Extend the `MetricsCollector` service to track additional data:
+```ruby
+def self.track_custom_metric(healing_id, metric_name, value)
+  metric = HealingMetric.find_by(healing_id: healing_id)
+  metric.update!(additional_metadata: metric.additional_metadata.merge(metric_name => value))
+end
+```
+
+## 🔮 **Future Enhancements (Phase 2+)**
+
+- **Advanced Analytics**: ML-powered insights and predictions
+- **Team Performance**: Developer-specific metrics
+- **Business Impact**: Cost savings and productivity metrics
+- **Real-time Alerts**: Notifications for critical issues
+- **Export & Reporting**: PDF reports and scheduled exports
+
+## 🐛 **Troubleshooting**
+
+### **Common Issues**
+1. **Migration Errors**: Ensure Rails version compatibility
+2. **Route Conflicts**: Check for existing `/dashboard` routes
+3. **Database Connection**: Verify database connectivity
+4. **Asset Loading**: Ensure Chart.js loads correctly
+
+### **Debug Mode**
+Enable detailed logging:
+```ruby
+# In your environment
+ENV['CODE_HEALER_DEBUG'] = 'true'
+```
+
+## 📚 **Next Steps**
+
+This core dashboard provides the foundation for:
+- **Performance Monitoring**: Track healing efficiency
+- **AI Optimization**: Improve success rates
+- **Resource Planning**: Understand system usage
+- **Business Reporting**: Demonstrate ROI
+
+The dashboard transforms CodeHealer from a **tool** into a **strategic asset** with data-driven insights! 🎯

data/lib/code_healer/controllers/dashboard_controller.rb

@@ -0,0 +1,92 @@
+module CodeHealer
+  class DashboardController < ActionController::Base
+    def index
+      @summary = MetricsCollector.dashboard_summary
+      @recent_healings = HealingMetric.order(created_at: :desc).limit(10)
+      
+      respond_to do |format|
+        format.html { render_dashboard }
+        format.json { render json: @summary }
+      end
+    end
+    
+    def metrics
+      @metrics = HealingMetric.order(created_at: :desc)
+      
+      # Apply filters
+      @metrics = @metrics.by_class(params[:class_name]) if params[:class_name].present?
+      @metrics = @metrics.by_evolution_method(params[:evolution_method]) if params[:evolution_method].present?
+      @metrics = @metrics.by_ai_provider(params[:ai_provider]) if params[:ai_provider].present?
+      @metrics = @metrics.recent(params[:days].to_i) if params[:days].present?
+      
+      respond_to do |format|
+        format.html { render :metrics }
+        format.json { render json: @metrics }
+      end
+    end
+    
+    def healing_details
+      @healing = HealingMetric.find_by(healing_id: params[:healing_id])
+      
+      if @healing
+        render json: {
+          healing: @healing,
+          timing: {
+            total_duration: @healing.duration_seconds,
+            ai_processing: @healing.ai_processing_seconds,
+            git_operations: @healing.git_operations_seconds
+          },
+          status: {
+            success: @healing.success_status,
+            evolution_method: @healing.evolution_method_display,
+            ai_provider: @healing.ai_provider_display
+          }
+        }
+      else
+        render json: { error: 'Healing not found' }, status: :not_found
+      end
+    end
+    
+    def trends
+      days = params[:days]&.to_i || 30
+      
+      trends = {
+        daily: HealingMetric.daily_healing_trend(days),
+        hourly: HealingMetric.hourly_healing_distribution,
+        evolution_methods: HealingMetric.evolution_method_distribution,
+        ai_providers: HealingMetric.ai_provider_distribution,
+        error_classes: HealingMetric.top_error_classes(10),
+        classes_healed: HealingMetric.top_classes_healed(10)
+      }
+      
+      render json: trends
+    end
+    
+    def performance
+      performance_data = {
+        average_resolution_time: HealingMetric.average_resolution_time,
+        success_rate: HealingMetric.success_rate,
+        ai_success_rate: HealingMetric.where(ai_success: true).count.to_f / HealingMetric.count * 100,
+        test_pass_rate: HealingMetric.where(tests_passed: true).count.to_f / HealingMetric.count * 100,
+        syntax_valid_rate: HealingMetric.where(syntax_valid: true).count.to_f / HealingMetric.count * 100
+      }
+      
+      render json: performance_data
+    end
+    
+    def summary
+      render json: MetricsCollector.dashboard_summary
+    end
+    
+    private
+    
+    def render_dashboard
+      # This will be replaced with actual dashboard view
+      render plain: "CodeHealer Dashboard - Coming Soon!\n\n" \
+                    "Total Healings: #{@summary[:total_healing]}\n" \
+                    "Success Rate: #{@summary[:success_rate]}%\n" \
+                    "Healings Today: #{@summary[:healings_today]}\n" \
+                    "Healings This Week: #{@summary[:healings_this_week]}"
+    end
+  end
+end

data/lib/code_healer/engine.rb

@@ -0,0 +1,19 @@
+module CodeHealer
+  class Engine < ::Rails::Engine
+    isolate_namespace CodeHealer
+    
+    # Load dashboard components
+    initializer "code_healer.load_dashboard" do |app|
+      app.config.autoload_paths += %W(#{config.root}/lib/code_healer)
+    end
+    
+    # Copy migrations
+    initializer "code_healer.copy_migrations" do |app|
+      if app.root.to_s.match root.to_s
+        config.paths["db/migrate"].expanded.each do |expanded_path|
+          app.config.paths["db/migrate"] << expanded_path
+        end
+      end
+    end
+  end
+end

data/lib/code_healer/installer.rb

@@ -0,0 +1,51 @@
+module CodeHealer
+  class Installer
+    def self.install_dashboard
+      puts "🏥 CodeHealer Dashboard Installation"
+      puts "=================================="
+      
+      # Check if we're in a Rails app
+      unless defined?(Rails)
+        puts "❌ This command must be run from within a Rails application"
+        return false
+      end
+      
+      # Check if dashboard is already installed
+      if dashboard_installed?
+        puts "✅ Dashboard is already installed!"
+        puts "🌐 Access it at: /code_healer/dashboard"
+        return true
+      end
+      
+      puts "🚀 Installing CodeHealer Dashboard..."
+      
+      # The engine will automatically handle:
+      # - Routes mounting
+      # - Migration copying
+      # - Asset loading
+      
+      puts "✅ Dashboard installation completed!"
+      puts "🚀 Run 'rails db:migrate' to create the database tables"
+      puts "🌐 Access your dashboard at: /code_healer/dashboard"
+      puts ""
+      puts "📊 Dashboard Features:"
+      puts "   - Real-time healing metrics"
+      puts "   - AI performance analytics"
+      puts "   - Success rate tracking"
+      puts "   - Interactive charts and graphs"
+      
+      true
+    end
+    
+    private
+    
+    def self.dashboard_installed?
+      # Check if the routes are already mounted
+      Rails.application.routes.routes.any? do |route|
+        route.path.spec.to_s.include?('code_healer')
+      end
+    rescue
+      false
+    end
+  end
+end

data/lib/code_healer/models/healing_metric.rb

@@ -0,0 +1,116 @@
+module CodeHealer
+  class HealingMetric < ActiveRecord::Base
+    self.table_name = 'healing_metrics'
+    
+    # Validations
+    validates :healing_id, presence: true, uniqueness: true
+    validates :class_name, presence: true
+    validates :method_name, presence: true
+    validates :error_class, presence: true
+    
+    # Scopes for common queries
+    scope :successful, -> { where(healing_successful: true) }
+    scope :failed, -> { where(healing_successful: false) }
+    scope :recent, ->(days = 30) { where('created_at >= ?', days.days.ago) }
+    scope :by_evolution_method, ->(method) { where(evolution_method: method) }
+    scope :by_ai_provider, ->(provider) { where(ai_provider: provider) }
+    scope :by_class, ->(class_name) { where(class_name: class_name) }
+    
+    # Class methods for dashboard metrics
+    class << self
+      def total_healings
+        count
+      end
+      
+      def success_rate
+        return 0 if count.zero?
+        (successful.count.to_f / count * 100).round(2)
+      end
+      
+      def healings_today
+        where('created_at >= ?', Date.current.beginning_of_day).count
+      end
+      
+      def healings_this_week
+        where('created_at >= ?', Date.current.beginning_of_week).count
+      end
+      
+      def healings_this_month
+        where('created_at >= ?', Date.current.beginning_of_month).count
+      end
+      
+      def average_resolution_time
+        successful.where.not(total_duration_ms: nil).average(:total_duration_ms)&.round(2)
+      end
+      
+      def evolution_method_distribution
+        group(:evolution_method).count
+      end
+      
+      def ai_provider_distribution
+        group(:ai_provider).count
+      end
+      
+      def top_error_classes(limit = 10)
+        group(:error_class).order('count_all DESC').limit(limit).count
+      end
+      
+      def top_classes_healed(limit = 10)
+        group(:class_name).order('count_all DESC').limit(limit).count
+      end
+      
+      def daily_healing_trend(days = 30)
+        # Use Rails date methods instead of raw SQL
+        start_date = days.days.ago.to_date
+        end_date = Date.current
+        
+        trend_data = {}
+        (start_date..end_date).each do |date|
+          count = where('DATE(created_at) = ?', date).count
+          trend_data[date.strftime('%Y-%m-%d')] = count
+        end
+        trend_data
+      end
+      
+      def hourly_healing_distribution
+        # Use Rails to group by hour without raw SQL
+        distribution = {}
+        (0..23).each do |hour|
+          start_time = Time.current.beginning_of_day + hour.hours
+          end_time = start_time + 1.hour
+          count = where(created_at: start_time..end_time).count
+          distribution[hour.to_s.rjust(2, '0')] = count
+        end
+        distribution
+      end
+    end
+    
+    # Instance methods
+    def duration_seconds
+      return nil unless total_duration_ms
+      (total_duration_ms / 1000.0).round(2)
+    end
+    
+    def ai_processing_seconds
+      return nil unless ai_processing_time_ms
+      (ai_processing_time_ms / 1000.0).round(2)
+    end
+    
+    def git_operations_seconds
+      return nil unless git_operations_time_ms
+      (git_operations_time_ms / 1000.0).round(2)
+    end
+    
+    def success_status
+      healing_successful ? '✅ Success' : '❌ Failed'
+    end
+    
+    def evolution_method_display
+      evolution_method&.titleize || 'Unknown'
+    end
+    
+    def ai_provider_display
+      ai_provider&.titleize || 'Unknown'
+    end
+  end
+end

data/lib/code_healer/routes.rb

@@ -0,0 +1,20 @@
+# CodeHealer Dashboard Routes
+Rails.application.routes.draw do
+  namespace :code_healer do
+    # Dashboard
+    get '/dashboard', to: 'dashboard#index'
+    get '/dashboard/metrics', to: 'dashboard#metrics'
+    get '/dashboard/trends', to: 'dashboard#trends'
+    get '/dashboard/performance', to: 'dashboard#performance'
+    get '/dashboard/healing/:healing_id', to: 'dashboard#healing_details'
+    
+    # API endpoints (JSON only)
+    namespace :api do
+      get '/dashboard/summary', to: 'dashboard#summary'
+      get '/dashboard/metrics', to: 'dashboard#metrics'
+      get '/dashboard/trends', to: 'dashboard#trends'
+      get '/dashboard/performance', to: 'dashboard#performance'
+      get '/dashboard/healing/:healing_id', to: 'dashboard#healing_details'
+    end
+  end
+end

data/lib/code_healer/services/metrics_collector.rb

@@ -0,0 +1,135 @@
+module CodeHealer
+  class MetricsCollector
+    def self.track_healing_start(healing_id, class_name, method_name, error_class, error_message, file_path)
+      metric = HealingMetric.find_or_initialize_by(healing_id: healing_id)
+      
+      metric.assign_attributes(
+        class_name: class_name,
+        method_name: method_name,
+        error_class: error_class,
+        error_message: error_message,
+        file_path: file_path,
+        healing_started_at: Time.current
+      )
+      
+      metric.save!
+      metric
+    end
+    
+    def self.track_ai_processing(healing_id, evolution_method, ai_provider, ai_response, tokens_used = nil, cost = nil)
+      metric = HealingMetric.find_by(healing_id: healing_id)
+      return unless metric
+      
+      metric.update!(
+        evolution_method: evolution_method,
+        ai_provider: ai_provider,
+        ai_response: ai_response,
+        ai_tokens_used: tokens_used,
+        ai_cost: cost,
+        ai_success: true
+      )
+    end
+    
+    def self.track_ai_failure(healing_id, evolution_method, ai_provider, failure_reason)
+      metric = HealingMetric.find_by(healing_id: healing_id)
+      return unless metric
+      
+      metric.update!(
+        evolution_method: evolution_method,
+        ai_provider: ai_provider,
+        ai_success: false,
+        failure_reason: failure_reason
+      )
+    end
+    
+    def self.track_workspace_creation(healing_id, workspace_path)
+      metric = HealingMetric.find_by(healing_id: healing_id)
+      return unless metric
+      
+      metric.update!(workspace_path: workspace_path)
+    end
+    
+    def self.track_git_operations(healing_id, healing_branch, pull_request_url, pr_created)
+      metric = HealingMetric.find_by(healing_id: healing_id)
+      return unless metric
+      
+      metric.update!(
+        healing_branch: healing_branch,
+        pull_request_url: pull_request_url,
+        pr_created: pr_created
+      )
+    end
+    
+    def self.track_healing_completion(healing_id, success, tests_passed, syntax_valid, failure_reason = nil)
+      metric = HealingMetric.find_by(healing_id: healing_id)
+      return unless metric
+      
+      # Calculate timing
+      total_duration = if metric.healing_started_at
+        ((Time.current - metric.healing_started_at) * 1000).round
+      else
+        nil
+      end
+      
+      metric.update!(
+        healing_completed_at: Time.current,
+        total_duration_ms: total_duration,
+        healing_successful: success,
+        tests_passed: tests_passed,
+        syntax_valid: syntax_valid,
+        failure_reason: failure_reason
+      )
+    end
+    
+    def self.track_timing(healing_id, ai_processing_time_ms, git_operations_time_ms)
+      metric = HealingMetric.find_by(healing_id: healing_id)
+      return unless metric
+      
+      metric.update!(
+        ai_processing_time_ms: ai_processing_time_ms,
+        git_operations_time_ms: git_operations_time_ms
+      )
+    end
+    
+    def self.track_business_context(healing_id, business_context, jira_issue_id = nil, confluence_page_id = nil)
+      metric = HealingMetric.find_by(healing_id: healing_id)
+      return unless metric
+      
+      metric.update!(
+        business_context_used: business_context,
+        jira_issue_id: jira_issue_id,
+        confluence_page_id: confluence_page_id
+      )
+    end
+    
+    def self.track_error_occurrence(healing_id, error_occurred_at)
+      metric = HealingMetric.find_by(healing_id: healing_id)
+      return unless metric
+      
+      metric.update!(error_occurred_at: error_occurred_at)
+    end
+    
+    # Generate unique healing ID
+    def self.generate_healing_id
+      "healing_#{Time.current.to_i}_#{SecureRandom.hex(8)}"
+    end
+    
+    # Get dashboard summary
+    def self.dashboard_summary
+      {
+        total_healings: HealingMetric.total_healings,
+        success_rate: HealingMetric.success_rate,
+        healings_today: HealingMetric.healings_today,
+        healings_this_week: HealingMetric.healings_this_week,
+        healings_this_month: HealingMetric.healings_this_month,
+        average_resolution_time: HealingMetric.average_resolution_time,
+        evolution_methods: HealingMetric.evolution_method_distribution,
+        ai_providers: HealingMetric.ai_provider_distribution,
+        top_error_classes: HealingMetric.top_error_classes(5),
+        top_classes_healed: HealingMetric.top_classes_healed(5),
+        daily_trend: HealingMetric.daily_healing_trend(7),
+        hourly_distribution: HealingMetric.hourly_healing_distribution
+      }
+    end
+  end
+end

data/lib/code_healer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CodeHealer
-  VERSION = "0.1.12"
+  VERSION = "0.1.14"
 end

data/lib/code_healer/views/dashboard/index.html.erb

@@ -0,0 +1,161 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>CodeHealer Dashboard</title>
+  <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+  <style>
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; margin: 0; padding: 20px; background: #f5f5f5; }
+    .container { max-width: 1200px; margin: 0 auto; }
+    .header { background: white; padding: 20px; border-radius: 8px; margin-bottom: 20px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
+    .header h1 { margin: 0; color: #2c3e50; }
+    .header p { margin: 10px 0 0 0; color: #7f8c8d; }
+    
+    .metrics-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(250px, 1fr)); gap: 20px; margin-bottom: 20px; }
+    .metric-card { background: white; padding: 20px; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
+    .metric-card h3 { margin: 0 0 10px 0; color: #2c3e50; font-size: 14px; text-transform: uppercase; letter-spacing: 0.5px; }
+    .metric-card .value { font-size: 32px; font-weight: bold; color: #3498db; margin: 0; }
+    .metric-card .label { color: #7f8c8d; font-size: 12px; margin: 5px 0 0 0; }
+    
+    .charts-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; margin-bottom: 20px; }
+    .chart-card { background: white; padding: 20px; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
+    .chart-card h3 { margin: 0 0 20px 0; color: #2c3e50; }
+    
+    .recent-healings { background: white; padding: 20px; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
+    .recent-healings h3 { margin: 0 0 20px 0; color: #2c3e50; }
+    .healing-item { padding: 15px; border-bottom: 1px solid #ecf0f1; }
+    .healing-item:last-child { border-bottom: none; }
+    .healing-item .class-method { font-weight: bold; color: #2c3e50; }
+    .healing-item .error { color: #e74c3c; font-size: 14px; }
+    .healing-item .status { color: #27ae60; font-size: 12px; }
+    .healing-item .time { color: #7f8c8d; font-size: 12px; }
+    
+    .success { color: #27ae60; }
+    .warning { color: #f39c12; }
+    .danger { color: #e74c3c; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <h1>🏥 CodeHealer Dashboard</h1>
+      <p>Intelligent Code Healing Analytics & Insights</p>
+    </div>
+    
+    <div class="metrics-grid">
+      <div class="metric-card">
+        <h3>Total Healings</h3>
+        <div class="value"><%= @summary[:total_healings] %></div>
+        <div class="label">All time</div>
+      </div>
+      
+      <div class="metric-card">
+        <h3>Success Rate</h3>
+        <div class="value <%= @summary[:success_rate] >= 80 ? 'success' : (@summary[:success_rate] >= 60 ? 'warning' : 'danger') %>">
+          <%= @summary[:success_rate] %>%
+        </div>
+        <div class="label">Healing success</div>
+      </div>
+      
+      <div class="metric-card">
+        <h3>Today</h3>
+        <div class="value"><%= @summary[:healings_today] %></div>
+        <div class="label">Healings today</div>
+      </div>
+      
+      <div class="metric-card">
+        <h3>This Week</h3>
+        <div class="value"><%= @summary[:healings_this_week] %></div>
+        <div class="label">Healings this week</div>
+      </div>
+      
+      <div class="metric-card">
+        <h3>This Month</h3>
+        <div class="value"><%= @summary[:healings_this_month] %></div>
+        <div class="label">Healings this month</div>
+      </div>
+      
+      <div class="metric-card">
+        <h3>Avg Resolution</h3>
+        <div class="value">
+          <%= @summary[:average_resolution_time] ? "#{(@summary[:average_resolution_time] / 1000.0).round(2)}s" : "N/A" %>
+        </div>
+        <div class="label">Average time to fix</div>
+      </div>
+    </div>
+    
+    <div class="charts-grid">
+      <div class="chart-card">
+        <h3>Daily Healing Trend (Last 7 Days)</h3>
+        <canvas id="dailyTrendChart"></canvas>
+      </div>
+      
+      <div class="chart-card">
+        <h3>Evolution Method Distribution</h3>
+        <canvas id="evolutionMethodsChart"></canvas>
+      </div>
+    </div>
+    
+    <div class="recent-healings">
+      <h3>Recent Healings</h3>
+      <% @recent_healings.each do |healing| %>
+        <div class="healing-item">
+          <div class="class-method"><%= healing.class_name %>#<%= healing.method_name %></div>
+          <div class="error"><%= healing.error_class %>: <%= healing.error_message&.truncate(100) %></div>
+          <div class="status">
+            <%= healing.success_status %> | 
+            <%= healing.evolution_method_display %> | 
+            <%= healing.ai_provider_display %>
+          </div>
+          <div class="time"><%= healing.created_at.strftime("%Y-%m-%d %H:%M:%S") %></div>
+        </div>
+      <% end %>
+    </div>
+  </div>
+  
+  <script>
+    // Daily Trend Chart
+    const dailyTrendCtx = document.getElementById('dailyTrendChart').getContext('2d');
+    new Chart(dailyTrendCtx, {
+      type: 'line',
+      data: {
+        labels: <%= raw @summary[:daily_trend].keys.map { |date| Date.parse(date).strftime("%m/%d") }.to_json %>,
+        datasets: [{
+          label: 'Healings',
+          data: <%= raw @summary[:daily_trend].values.to_json %>,
+          borderColor: '#3498db',
+          backgroundColor: 'rgba(52, 152, 219, 0.1)',
+          tension: 0.4
+        }]
+      },
+      options: {
+        responsive: true,
+        plugins: {
+          legend: { display: false }
+        },
+        scales: {
+          y: { beginAtZero: true, ticks: { stepSize: 1 } }
+        }
+      }
+    });
+    
+    // Evolution Methods Chart
+    const evolutionMethodsCtx = document.getElementById('evolutionMethodsChart').getContext('2d');
+    new Chart(evolutionMethodsCtx, {
+      type: 'doughnut',
+      data: {
+        labels: <%= raw @summary[:evolution_methods].keys.map(&:titleize).to_json %>,
+        datasets: [{
+          data: <%= raw @summary[:evolution_methods].values.to_json %>,
+          backgroundColor: ['#3498db', '#e74c3c', '#2ecc71', '#f39c12', '#9b59b6']
+        }]
+      },
+      options: {
+        responsive: true,
+        plugins: {
+          legend: { position: 'bottom' }
+        }
+      }
+    });
+  </script>
+</body>
+</html>

data/lib/code_healer.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "code_healer/version"
+require_relative "code_healer/engine"
 
 # Require external gems explicitly
 require 'openai'
@@ -28,6 +29,12 @@ autoload :McpTools, "code_healer/mcp_tools"
 autoload :McpPrompts, "code_healer/mcp_prompts"
 autoload :MCP, "code_healer/mcp"
 
+# Dashboard components - load them explicitly to avoid autoload issues
+require_relative "code_healer/models/healing_metric"
+require_relative "code_healer/services/metrics_collector"
+require_relative "code_healer/controllers/dashboard_controller"
+autoload :Installer, "code_healer/installer"
+
 # Rails integration
 if defined?(Rails)
   require "rails"
@@ -64,5 +71,34 @@ if defined?(Rails)
         puts "   Run 'code_healer-setup' to configure CodeHealer"
       end
     end
+    
+    # Mount the engine to provide dashboard routes
+    initializer "code_healer.mount_engine" do |app|
+      app.routes.prepend do
+        mount CodeHealer::Engine => "/code_healer"
+      end
+    end
+    
+    # Add dashboard routes directly to the host app
+    initializer "code_healer.add_dashboard_routes" do |app|
+      app.routes.prepend do
+        namespace :code_healer do
+          get '/dashboard', to: 'dashboard#index'
+          get '/dashboard/metrics', to: 'dashboard#metrics'
+          get '/dashboard/trends', to: 'dashboard#trends'
+          get '/dashboard/performance', to: 'dashboard#performance'
+          get '/dashboard/healing/:healing_id', to: 'dashboard#healing_details'
+          
+          # API endpoints (JSON only)
+          namespace :api do
+            get '/dashboard/summary', to: 'dashboard#summary'
+            get '/dashboard/metrics', to: 'dashboard#metrics'
+            get '/dashboard/trends', to: 'dashboard#trends'
+            get '/dashboard/performance', to: 'dashboard#performance'
+            get '/dashboard/healing/:healing_id', to: 'dashboard#healing_details'
+          end
+        end
+      end
+    end
   end
 end

data/lib/generators/code_healer/install_generator.rb

@@ -0,0 +1,48 @@
+module CodeHealer
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+      
+      desc "Installs CodeHealer dashboard and required components"
+      
+      def install_dashboard
+        # Generate migration
+        generate_migration
+        
+        # Add routes
+        inject_routes
+        
+        # Create initializer
+        create_initializer
+        
+        # Copy dashboard assets
+        copy_dashboard_assets
+        
+        puts "✅ CodeHealer dashboard installed successfully!"
+        puts "🚀 Run 'rails db:migrate' to create the database tables"
+        puts "🌐 Access your dashboard at: /code_healer/dashboard"
+      end
+      
+      private
+      
+      def generate_migration
+        migration_template "create_healing_metrics.rb", "db/migrate/create_healing_metrics.rb"
+      end
+      
+      def inject_routes
+        route "mount CodeHealer::Engine => '/code_healer'"
+      end
+      
+      def create_initializer
+        copy_file "code_healer.rb", "config/initializers/code_healer.rb"
+      end
+      
+      def copy_dashboard_assets
+        copy_file "dashboard_controller.rb", "app/controllers/code_healer/dashboard_controller.rb"
+        copy_file "healing_metric.rb", "app/models/code_healer/healing_metric.rb"
+        copy_file "metrics_collector.rb", "app/services/code_healer/metrics_collector.rb"
+        copy_file "dashboard_index.html.erb", "app/views/code_healer/dashboard/index.html.erb"
+      end
+    end
+  end
+end

data/lib/generators/code_healer/templates/create_healing_metrics.rb

@@ -0,0 +1,56 @@
+class CreateHealingMetrics < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :healing_metrics do |t|
+      # Basic healing info
+      t.string :healing_id, null: false, index: true
+      t.string :class_name, null: false
+      t.string :method_name, null: false
+      t.string :error_class, null: false
+      t.text :error_message
+      t.string :file_path
+      
+      # AI and evolution details
+      t.string :evolution_method # claude_code_terminal, api, hybrid
+      t.string :ai_provider # claude, openai
+      t.boolean :ai_success, default: false
+      t.text :ai_response
+      t.integer :ai_tokens_used
+      t.decimal :ai_cost, precision: 10, scale: 4
+      
+      # Workspace and Git details
+      t.string :workspace_path
+      t.string :healing_branch
+      t.string :pull_request_url
+      t.boolean :pr_created, default: false
+      
+      # Timing and performance
+      t.datetime :error_occurred_at
+      t.datetime :healing_started_at
+      t.datetime :healing_completed_at
+      t.integer :total_duration_ms
+      t.integer :ai_processing_time_ms
+      t.integer :git_operations_time_ms
+      
+      # Success metrics
+      t.boolean :healing_successful, default: false
+      t.boolean :tests_passed, default: false
+      t.boolean :syntax_valid, default: false
+      t.text :failure_reason
+      
+      # Business context
+      t.text :business_context_used
+      t.string :jira_issue_id
+      t.string :confluence_page_id
+      
+      # Metadata
+      t.json :additional_metadata
+      t.timestamps
+    end
+    
+    # Indexes for performance
+    add_index :healing_metrics, [:class_name, :method_name]
+    add_index :healing_metrics, [:evolution_method, :ai_provider]
+    add_index :healing_metrics, [:healing_successful, :created_at]
+    add_index :healing_metrics, :created_at
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: code_healer
 version: !ruby/object:Gem::Version
-  version: 0.1.12
+  version: 0.1.14
 platform: ruby
 authors:
 - Deepan Kumar
@@ -345,6 +345,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
+- DASHBOARD_README.md
 - GEM_SUMMARY.md
 - README.md
 - code_healer.gemspec
@@ -363,17 +364,23 @@ files:
 - lib/code_healer/claude_error_monitor.rb
 - lib/code_healer/config_manager.rb
 - lib/code_healer/context_aware_prompt_builder.rb
+- lib/code_healer/controllers/dashboard_controller.rb
 - lib/code_healer/core.rb
+- lib/code_healer/engine.rb
 - lib/code_healer/error_handler.rb
 - lib/code_healer/evolution_job.rb
 - lib/code_healer/global_handler.rb
 - lib/code_healer/healing_job.rb
 - lib/code_healer/healing_workspace_manager.rb
+- lib/code_healer/installer.rb
 - lib/code_healer/mcp.rb
 - lib/code_healer/mcp_prompts.rb
 - lib/code_healer/mcp_server.rb
 - lib/code_healer/mcp_tools.rb
+- lib/code_healer/models/healing_metric.rb
 - lib/code_healer/pull_request_creator.rb
+- lib/code_healer/routes.rb
+- lib/code_healer/services/metrics_collector.rb
 - lib/code_healer/setup.rb
 - lib/code_healer/simple_evolution.rb
 - lib/code_healer/simple_global_handler.rb
@@ -381,6 +388,9 @@ files:
 - lib/code_healer/terminal_integration.rb
 - lib/code_healer/usage_analyzer.rb
 - lib/code_healer/version.rb
+- lib/code_healer/views/dashboard/index.html.erb
+- lib/generators/code_healer/install_generator.rb
+- lib/generators/code_healer/templates/create_healing_metrics.rb
 homepage: https://github.com/deepan-g2/code-healer
 licenses:
 - MIT