🔧 RefactorAIOperationsIDE: Bridging AI Intelligence with IDE Refactoring Power

🚀 Open-source solution that transforms AI-generated code suggestions into safe, semantic-aware IDE refactoring operations

📋 Table of Contents

🔴 The Problem
💡 The Solution
🎯 Key Features
🏗️ Architecture
🚀 Quick Start
📊 Refactoring Operations
🔌 IDE Support
💼 Use Cases
📄 License

The Fundamental Flaw: Generative vs Transformative

Approach	Method	Result	Risk Level
🔴 AI Generative	Creates new code from scratch	Loses all context, breaks dependencies	⚠️ HIGH
🟡 Text Replacement	Find & replace strings	Misses semantic meaning	⚠️ MEDIUM
🟢 IDE Refactoring	AST transformations	Preserves all relationships	✅ ZERO

Key Insight: Current AI assistants GENERATE code instead of TRANSFORMING it, making them fundamentally destructive rather than constructive.

💡 The Solution

RefactorAIOperationsIDE: Non-Destructive, Guaranteed-Safe Transformations

graph LR
    subgraph "✨ NON-DESTRUCTIVE Refactoring Flow"
        A[👤 Developer Intent] -->|"Natural Language"| B[🤖 AI Understanding]
        B -->|"Maps to Operations"| C[🔧 RefactorAI Engine]
        C -->|"IDE Commands"| D[💻 AST Transformations]
        D -->|"Atomic & Safe"| E[✅ Perfect Result]
        
        style A fill:#74c0fc,stroke:#339af0,color:#fff
        style B fill:#8ce99a,stroke:#51cf66,color:#fff
        style C fill:#ffd43b,stroke:#fab005,color:#000
        style D fill:#a5d8ff,stroke:#4dabf7,color:#000
        style E fill:#8ce99a,stroke:#51cf66,color:#fff
    end
    
    subgraph "🛡️ Safety Guarantees"
        G1[Compilation Success ✓]
        G2[All Tests Pass ✓]
        G3[References Updated ✓]
        G4[Rollback Available ✓]
        
        style G1 fill:#d3f9d8,stroke:#51cf66
        style G2 fill:#d3f9d8,stroke:#51cf66
        style G3 fill:#d3f9d8,stroke:#51cf66
        style G4 fill:#d3f9d8,stroke:#51cf66
    end

🎯 Core Principles

1. Always Working Code 🟢

Every refactoring operation MUST result in compilable, working code. No exceptions.

2. Non-Destructive Transformations 🛡️

We TRANSFORM existing code using IDE operations, never GENERATE replacements.

3. Semantic Awareness 🧠

Every operation understands the code's meaning, not just its text.

4. Atomic & Reversible ↩️

All operations can be undone with a single command.

5. Cross-File Consistency 🔗

Updates ALL references across the entire codebase automatically.

🔧 Supported Refactoring Operations

Complete Eclipse JDT Refactoring Mapping

mindmap
  root((🔧 IDE Operations))
    📝 Naming & References
      Rename Element
        Methods
        Fields
        Variables
        Types
        Packages
      Update References
        Same File
        Cross File
        JavaDoc
        Comments
    📦 Code Organization
      Extract Operations
        Extract Method
        Extract Variable
        Extract Constant
        Extract Class
        Extract Interface
        Extract Superclass
      Introduce Operations
        Parameter Object
        Factory Method
        Indirection
        Parameter
    🚀 Code Movement
      Move Operations
        Move Method
        Move Type
        Move Package
        Move Static Members
      Hierarchy Changes
        Pull Up
        Push Down
        Extract Interface
        Use Supertype
    🔄 Structural Changes
      Method Signature
        Add Parameter
        Remove Parameter
        Change Return Type
        Reorder Parameters
      Inline Operations
        Inline Method
        Inline Variable
        Inline Constant
      Encapsulation
        Encapsulate Field
        Generate Getters/Setters
    🎯 Advanced Patterns
      Dependency Breaking
        Extract Interface
        Dependency Inversion
        Introduce Facade
      Design Patterns
        Factory Pattern
        Builder Pattern
        Strategy Pattern
      Cycle Resolution
        Package Restructuring
        Layer Separation
        Module Extraction

Refactoring Safety Matrix

graph TB
    subgraph "🟢 SAFE Operations - Always Non-Destructive"
        S1[✅ Rename with References]
        S2[✅ Extract Method]
        S3[✅ Move with Updates]
        S4[✅ Change Signature]
        S5[✅ Extract Interface]
        
        style S1 fill:#8ce99a,stroke:#51cf66
        style S2 fill:#8ce99a,stroke:#51cf66
        style S3 fill:#8ce99a,stroke:#51cf66
        style S4 fill:#8ce99a,stroke:#51cf66
        style S5 fill:#8ce99a,stroke:#51cf66
    end
    
    subgraph "🟡 VALIDATED Operations - Checked Before Execution"
        V1[⚠️ Inline Method]
        V2[⚠️ Pull Up Method]
        V3[⚠️ Push Down Field]
        
        style V1 fill:#fff3bf,stroke:#fab005
        style V2 fill:#fff3bf,stroke:#fab005
        style V3 fill:#fff3bf,stroke:#fab005
    end
    
    subgraph "🔴 NEVER - Destructive Anti-Patterns"
        D1[❌ Delete & Recreate]
        D2[❌ String Replace]
        D3[❌ Manual Edit]
        
        style D1 fill:#ffe3e3,stroke:#ff6b6b
        style D2 fill:#ffe3e3,stroke:#ff6b6b
        style D3 fill:#ffe3e3,stroke:#ff6b6b
    end

🏗️ Architecture

System Components

graph TB
    subgraph "🎨 User Interface Layer"
        UI[IDE Plugin UI]
        CLI[CLI Interface]
        API[REST API]
    end
    
    subgraph "🧠 Intelligence Layer"
        INT[Intent Analyzer]
        MAP[Operation Mapper]
        VAL[Validation Engine]
    end
    
    subgraph "🔧 Execution Layer"
        MCP[MCP Server]
        ADAPT[IDE Adapters]
        EXEC[Refactoring Executor]
        ROLL[Rollback Manager]
    end
    
    subgraph "🛡️ Safety Layer"
        PRE[Pre-conditions Check]
        POST[Post-conditions Verify]
        TEST[Test Runner]
        COMP[Compiler Check]
    end
    
    UI --> INT
    INT --> MAP
    MAP --> VAL
    VAL --> PRE
    PRE --> MCP
    MCP --> ADAPT
    ADAPT --> EXEC
    EXEC --> POST
    POST --> TEST
    TEST --> COMP
    
    style UI fill:#ffd43b,stroke:#fab005
    style INT fill:#74c0fc,stroke:#339af0
    style PRE fill:#ff8cc3,stroke:#f06595
    style EXEC fill:#8ce99a,stroke:#51cf66

RefactorAI: Intelligence Meets Precision

graph LR
    subgraph "✨ RefactorAI Solution"
        A[👤 Developer Intent] -->|"Natural Language"| B[🤖 AI Analysis]
        B -->|"MCP Protocol"| C[🔧 RefactorAI Engine]
        C -->|"IDE Commands"| D[💻 Native IDE Operations]
        D -->|"Safe Refactoring"| E[✅ Clean Code]
        
        style A fill:#74c0fc,stroke:#339af0,color:#fff
        style B fill:#8ce99a,stroke:#51cf66,color:#fff
        style C fill:#ffd43b,stroke:#fab005,color:#000
        style D fill:#a5d8ff,stroke:#4dabf7,color:#000
        style E fill:#8ce99a,stroke:#51cf66,color:#fff
    end

Core Innovation

RefactorAI acts as an intelligent bridge between AI language models and IDE refactoring engines:

🧠 Understands Intent: AI interprets what you want to achieve
🎯 Maps to Operations: Translates intent to specific IDE refactoring commands
⚡ Executes Safely: Uses native IDE operations with full semantic awareness
✅ Guarantees Consistency: All references updated, no broken code

🎯 Key Features

Intelligent Refactoring Operations

mindmap
  root((🔧 RefactorAI))
    🎯 Core Refactorings
      📝 Rename
        Types
        Methods
        Variables
        Packages
      📦 Extract
        Method
        Interface
        Superclass
        Variable
      🚀 Move
        Class
        Method
        Package
      🔄 Transform
        Inline
        Pull Up
        Push Down
    🧠 Advanced Features
      🔍 Cycle Detection
        Package cycles
        Class dependencies
        Import analysis
      🏗️ Architecture
        Layer violations
        Pattern detection
        SOLID compliance
      📊 Analytics
        Tech debt scoring
        Complexity metrics
        Impact analysis
    🔌 Integrations
      💻 IDEs
        Eclipse
        IntelliJ
        VS Code
        Visual Studio
      🤖 AI Models
        GitHub Copilot
        Claude
        GPT-4
        Local LLMs
      🔧 Tools
        Git
        Maven/Gradle
        CI/CD

Supported Refactoring Operations

graph TB
    subgraph "🔧 Basic Refactorings"
        R1[🏷️ Rename]
        R2[📤 Extract Method]
        R3[📥 Inline]
        R4[🚚 Move]
        
        style R1 fill:#e3f2fd,stroke:#2196f3,color:#0d47a1
        style R2 fill:#e3f2fd,stroke:#2196f3,color:#0d47a1
        style R3 fill:#e3f2fd,stroke:#2196f3,color:#0d47a1
        style R4 fill:#e3f2fd,stroke:#2196f3,color:#0d47a1
    end
    
    subgraph "🏗️ Structural Refactorings"
        S1[🔺 Extract Superclass]
        S2[🔻 Extract Interface]
        S3[⬆️ Pull Up]
        S4[⬇️ Push Down]
        
        style S1 fill:#f3e5f5,stroke:#9c27b0,color:#4a148c
        style S2 fill:#f3e5f5,stroke:#9c27b0,color:#4a148c
        style S3 fill:#f3e5f5,stroke:#9c27b0,color:#4a148c
        style S4 fill:#f3e5f5,stroke:#9c27b0,color:#4a148c
    end
    
    subgraph "🎯 Advanced Refactorings"
        A1[🔄 Break Cycles]
        A2[📦 Parameter Object]
        A3[🏭 Introduce Factory]
        A4[🎭 Introduce Facade]
        
        style A1 fill:#e8f5e9,stroke:#4caf50,color:#1b5e20
        style A2 fill:#e8f5e9,stroke:#4caf50,color:#1b5e20
        style A3 fill:#e8f5e9,stroke:#4caf50,color:#1b5e20
        style A4 fill:#e8f5e9,stroke:#4caf50,color:#1b5e20
    end

🏗️ Architecture

System Components

graph TB
    subgraph "🎨 Frontend Layer"
        UI[IDE Plugin UI]
        CLI[CLI Interface]
        API[REST API]
    end
    
    subgraph "🧠 Intelligence Layer"
        INT[Intent Analyzer]
        SMELL[Code Smell Detector]
        PLAN[Refactoring Planner]
    end
    
    subgraph "🔧 Execution Layer"
        MCP[MCP Server]
        ADAPT[IDE Adapters]
        EXEC[Refactoring Executor]
    end
    
    subgraph "💾 Data Layer"
        HIST[History Store]
        METR[Metrics DB]
        CONF[Configuration]
    end
    
    UI --> INT
    CLI --> INT
    API --> INT
    INT --> SMELL
    SMELL --> PLAN
    PLAN --> MCP
    MCP --> ADAPT
    ADAPT --> EXEC
    EXEC --> HIST
    EXEC --> METR
    
    style UI fill:#ffd43b,stroke:#fab005
    style INT fill:#74c0fc,stroke:#339af0
    style MCP fill:#8ce99a,stroke:#51cf66
    style EXEC fill:#ff8cc3,stroke:#f06595

📊 Refactoring Operations

Operation Categories & Capabilities

graph LR
    subgraph "🎯 Scope & Naming"
        REN[Rename]
        REN --> REN1[Variables]
        REN --> REN2[Methods]
        REN --> REN3[Classes]
        REN --> REN4[Packages]
        
        style REN fill:#e1f5fe,stroke:#03a9f4
        style REN1 fill:#b3e5fc,stroke:#03a9f4
        style REN2 fill:#b3e5fc,stroke:#03a9f4
        style REN3 fill:#b3e5fc,stroke:#03a9f4
        style REN4 fill:#b3e5fc,stroke:#03a9f4
    end
    
    subgraph "📦 Code Organization"
        EXT[Extract]
        EXT --> EXT1[Method]
        EXT --> EXT2[Variable]
        EXT --> EXT3[Interface]
        EXT --> EXT4[Superclass]
        
        style EXT fill:#f3e5f5,stroke:#9c27b0
        style EXT1 fill:#e1bee7,stroke:#9c27b0
        style EXT2 fill:#e1bee7,stroke:#9c27b0
        style EXT3 fill:#e1bee7,stroke:#9c27b0
        style EXT4 fill:#e1bee7,stroke:#9c27b0
    end
    
    subgraph "🔄 Dependency Management"
        CYC[Break Cycles]
        CYC --> CYC1[Package Level]
        CYC --> CYC2[Class Level]
        CYC --> CYC3[Method Level]
        
        style CYC fill:#e8f5e9,stroke:#4caf50
        style CYC1 fill:#c8e6c9,stroke:#4caf50
        style CYC2 fill:#c8e6c9,stroke:#4caf50
        style CYC3 fill:#c8e6c9,stroke:#4caf50
    end

Complexity Reduction Strategies

Refactoring	Before Complexity	After Complexity	Impact
📤 Extract Method	CC: 15	CC: 3 × 5	-67% complexity
🏗️ Extract Class	LOC: 500	LOC: 200 + 150 + 150	Better cohesion
📦 Parameter Object	Params: 8	Params: 2	-75% parameters
🔄 Break Cycle	Circular: Yes	Circular: No	100% improvement
🎯 Move Method	Feature Envy: High	Feature Envy: None	Proper encapsulation

🔌 IDE Support

Feature Matrix

Feature	Eclipse	IntelliJ	VS Code	Visual Studio
Basic Refactorings	✅	✅	✅	✅
AI Integration	✅	✅	✅	✅

✅ Full Support | 🚧 In Development | ❌ Not Planned

💼 Use Cases

1. Breaking Circular Dependencies

graph TB
    subgraph "❌ Before: Circular Dependency"
        A1[Service A] --> B1[Service B]
        B1 --> C1[Service C]
        C1 --> A1
        
        style A1 fill:#ff6b6b,stroke:#c92a2a
        style B1 fill:#ff6b6b,stroke:#c92a2a
        style C1 fill:#ff6b6b,stroke:#c92a2a
    end
    
    subgraph "✅ After: Clean Architecture"
        A2[Service A] --> I[Interface]
        B2[Service B] --> I
        C2[Service C] --> I
        
        style A2 fill:#8ce99a,stroke:#51cf66
        style B2 fill:#8ce99a,stroke:#51cf66
        style C2 fill:#8ce99a,stroke:#51cf66
        style I fill:#74c0fc,stroke:#339af0
    end

Command: "Break the circular dependency between these services"

RefactorAI Actions:

Detects cycle using graph analysis
Suggests Extract Interface refactoring
Creates common interface
Updates all implementations
Verifies no cycles remain

2. Legacy Code Modernization

// Before: 500-line method with 15 parameters
public void processOrder(String id, String customer, String product, 
                        int quantity, double price, String address, 
                        String city, String zip, String country, 
                        boolean express, double discount, String coupon,
                        String payment, String card, Date delivery) {
    // 500 lines of spaghetti code...
}

// After: Clean, testable code
public void processOrder(OrderRequest request) {
    Order order = createOrder(request);
    validateOrder(order);
    applyDiscounts(order);
    processPayment(order);
    scheduleDelivery(order);
}

3. Microservice Extraction

graph LR
    subgraph "📦 Monolith"
        M[Monolithic App]
    end
    
    subgraph "🎯 Microservices"
        MS1[User Service]
        MS2[Order Service]
        MS3[Payment Service]
        MS4[Notification Service]
    end
    
    M -->|"RefactorAI"| MS1
    M -->|"Extraction"| MS2
    M -->|"Process"| MS3
    M -->|"✨"| MS4
    
    style M fill:#ffd43b,stroke:#fab005
    style MS1 fill:#74c0fc,stroke:#339af0
    style MS2 fill:#8ce99a,stroke:#51cf66
    style MS3 fill:#ff8cc3,stroke:#f06595
    style MS4 fill:#c5f6fa,stroke:#22b8cf

📄 License

MIT License - see LICENSE file for details.

🌟 Star us on GitHub to support the project!

Name		Name	Last commit message	Last commit date
Latest commit History 6 Commits
.github/ISSUE_TEMPLATE		.github/ISSUE_TEMPLATE
CHANGELOG.md		CHANGELOG.md
CODEOWNERS		CODEOWNERS
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE.md		LICENSE.md
PULL_REQUEST_TEMPLATE.md		PULL_REQUEST_TEMPLATE.md
README.md		README.md
SECURITY.md		SECURITY.md
standardlint.json		standardlint.json

License

Hack23/RefactorAIOperationsIDE

Folders and files

Latest commit

History

Repository files navigation

🔧 RefactorAIOperationsIDE: Bridging AI Intelligence with IDE Refactoring Power

📋 Table of Contents

The Fundamental Flaw: Generative vs Transformative

💡 The Solution

RefactorAIOperationsIDE: Non-Destructive, Guaranteed-Safe Transformations

🎯 Core Principles

1. Always Working Code 🟢

2. Non-Destructive Transformations 🛡️

3. Semantic Awareness 🧠

4. Atomic & Reversible ↩️

5. Cross-File Consistency 🔗

🔧 Supported Refactoring Operations

Complete Eclipse JDT Refactoring Mapping

Refactoring Safety Matrix

🏗️ Architecture

System Components

RefactorAI: Intelligence Meets Precision

Core Innovation

🎯 Key Features

Intelligent Refactoring Operations

Supported Refactoring Operations

🏗️ Architecture

System Components

📊 Refactoring Operations

Operation Categories & Capabilities

Complexity Reduction Strategies

🔌 IDE Support

Feature Matrix

💼 Use Cases

1. Breaking Circular Dependencies

2. Legacy Code Modernization

3. Microservice Extraction

📄 License

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Packages