code_healer 0.1.12 → 0.1.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c3f51b2e61939becd7c68f57c2f70cb9dacf3b98f8ff62cfa2b3593dc745cfe
-  data.tar.gz: 8acbfcd6a4e3abae5cb96a2f451c01f6dc8ac40ada877fba4ed673962e87ab83
+  metadata.gz: a0eb37a96fca96ae0321a1ee24addb93e3dee8d0755ca5df8934c04420ef3548
+  data.tar.gz: b49f5a80ae6cc86b5bc0cd1ccd798a7279ea5d444be32894fb5514599cd13482
 SHA512:
-  metadata.gz: 892a29730e66d2e207460dd2ede2c93b42114760a509ff05b7e17b5a28545ecb7fe1be0078d16cf7ff1f88a106a99d9e20af8ffd0baa53b8442ce2898363e1e0
-  data.tar.gz: a89f5fccbc969fd0eccc468896c0ff0532868fb9ceb6a22a1e731319f2da2f602e2917f61add01424ea4c1fb869fef47d28b7e78e379d0c52d02e9666e65663e
+  metadata.gz: 98e5125e4f561073f31a8f263b5aba7b4ec62dba1d7a9c6b3dca818aa412c5f4578a55ff28dc95dd27768aa86dc61353050c43960ed29d8cc2499790bccef987
+  data.tar.gz: 52611005c0b0e47e16e86fb6f0d62ff0aea6a338e42de0b725e5de7a1d77713f3e89494db821d5f06c350283bf6027d629c859a3515e8dcb7cdb0cda113823f7

data/CHANGELOG.md

@@ -5,156 +5,126 @@ 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.15] - 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
+- **Dashboard Template Loading**: Fixed template loading issues by explicitly specifying view paths
+- **Engine Views Configuration**: Properly configured engine views path to resolve template missing errors
+- **Controller Template Rendering**: Updated render calls to use explicit template paths
 
-## [0.1.11] - 2025-01-14
+### Changed
+- **Template Rendering**: Changed from implicit template rendering to explicit template path specification
+- **View Path Configuration**: Enhanced engine configuration for proper view loading
 
-### 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.14] - 2025-08-21
 
-## [0.1.10] - 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
+- **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
+
+## [0.1.12] - 2025-08-20
 
 ### 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
+- **Duplicate PR Creation**: Prevented duplicate PR creation when evolution handler already creates PRs
+- **Workspace Cleanup**: Improved cleanup of healing workspaces
 
-## [0.1.6] - 2025-01-14
-
-### 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/config/routes.rb

@@ -0,0 +1,16 @@
+CodeHealer::Engine.routes.draw 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

data/lib/code_healer/controllers/dashboard_controller.rb

@@ -0,0 +1,89 @@
+module CodeHealer
+  class DashboardController < ActionController::Base
+    # Set the view path to look in the engine's views directory
+    self.view_paths = ["#{CodeHealer::Engine.root}/lib/code_healer/views"]
+    
+    def index
+      @summary = MetricsCollector.dashboard_summary
+      @recent_healings = HealingMetric.order(created_at: :desc).limit(10)
+      
+      respond_to do |format|
+        format.html { render template: "dashboard/index" }
+        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 template: "dashboard/metrics" }
+        format.json { render json: @metrics }
+      end
+    end
+    
+    def healing_details
+      @healing = HealingMetric.find_by(healing_id: params[:healing_id])
+      
+      respond_to do |format|
+        format.html { render template: "dashboard/healing_details" }
+        format.json do
+          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
+      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
+  end
+end

data/lib/code_healer/engine.rb

@@ -0,0 +1,31 @@
+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
+    
+    # Add views path to the main app
+    initializer "code_healer.add_views_path" do |app|
+      app.config.paths["app/views"] << "#{config.root}/lib/code_healer/views"
+    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
+    
+    # Ensure the engine is properly loaded
+    config.autoload_paths += %W(#{config.root}/lib)
+    config.eager_load_paths += %W(#{config.root}/lib)
+    
+    # Configure the engine's own paths
+    config.paths["app/views"] = ["#{config.root}/lib/code_healer/views"]
+  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