style: format all files with prettier

2026-03-18 17:47:16 +00:00 · 2026-01-19 17:07:03 -05:00
parent 8d37048deb
commit 56848874a2
355 changed files with 15215 additions and 10241 deletions
--- a/plugins/code-refactoring/commands/context-restore.md
+++ b/plugins/code-refactoring/commands/context-restore.md
@@ -7,6 +7,7 @@ Expert Context Restoration Specialist focused on intelligent, semantic-aware con
 ## Context Overview

 The Context Restoration tool is a sophisticated memory management system designed to:
+
 - Recover and reconstruct project context across distributed AI workflows
 - Enable seamless continuity in complex, long-running projects
 - Provide intelligent, semantically-aware context rehydration
@@ -15,6 +16,7 @@ The Context Restoration tool is a sophisticated memory management system designe
 ## Core Requirements and Arguments

 ### Input Parameters
+
 - `context_source`: Primary context storage location (vector database, file system)
 - `project_identifier`: Unique project namespace
 - `restoration_mode`:
@@ -27,6 +29,7 @@ The Context Restoration tool is a sophisticated memory management system designe
 ## Advanced Context Retrieval Strategies

 ### 1. Semantic Vector Search
+
 - Utilize multi-dimensional embedding models for context retrieval
 - Employ cosine similarity and vector clustering techniques
 - Support multi-modal embedding (text, code, architectural diagrams)
@@ -44,6 +47,7 @@ def semantic_context_retrieve(project_id, query_vector, top_k=5):
 ```

 ### 2. Relevance Filtering and Ranking
+
 - Implement multi-stage relevance scoring
 - Consider temporal decay, semantic similarity, and historical impact
 - Dynamic weighting of context components
@@ -64,6 +68,7 @@ def rank_context_components(contexts, current_state):
 ```

 ### 3. Context Rehydration Patterns
+
 - Implement incremental context loading
 - Support partial and full context reconstruction
 - Manage token budgets dynamically
@@ -93,26 +98,31 @@ def rehydrate_context(project_context, token_budget=8192):
 ```

 ### 4. Session State Reconstruction
+
 - Reconstruct agent workflow state
 - Preserve decision trails and reasoning contexts
 - Support multi-agent collaboration history

 ### 5. Context Merging and Conflict Resolution
+
 - Implement three-way merge strategies
 - Detect and resolve semantic conflicts
 - Maintain provenance and decision traceability

 ### 6. Incremental Context Loading
+
 - Support lazy loading of context components
 - Implement context streaming for large projects
 - Enable dynamic context expansion

 ### 7. Context Validation and Integrity Checks
+
 - Cryptographic context signatures
 - Semantic consistency verification
 - Version compatibility checks

 ### 8. Performance Optimization
+
 - Implement efficient caching mechanisms
 - Use probabilistic data structures for context indexing
 - Optimize vector search algorithms
@@ -120,12 +130,14 @@ def rehydrate_context(project_context, token_budget=8192):
 ## Reference Workflows

 ### Workflow 1: Project Resumption
+
 1. Retrieve most recent project context
 2. Validate context against current codebase
 3. Selectively restore relevant components
 4. Generate resumption summary

 ### Workflow 2: Cross-Project Knowledge Transfer
+
 1. Extract semantic vectors from source project
 2. Map and transfer relevant knowledge
 3. Adapt context to target project's domain
@@ -145,13 +157,15 @@ context-restore project:ml-pipeline --query "model training strategy"
 ```

 ## Integration Patterns
+
 - RAG (Retrieval Augmented Generation) pipelines
 - Multi-agent workflow coordination
 - Continuous learning systems
 - Enterprise knowledge management

 ## Future Roadmap
+
 - Enhanced multi-modal embedding support
 - Quantum-inspired vector search algorithms
 - Self-healing context reconstruction
- Adaptive learning context strategies
+- Adaptive learning context strategies
--- a/plugins/code-refactoring/commands/refactor-clean.md
+++ b/plugins/code-refactoring/commands/refactor-clean.md
@@ -3,15 +3,19 @@
 You are a code refactoring expert specializing in clean code principles, SOLID design patterns, and modern software engineering best practices. Analyze and refactor the provided code to improve its quality, maintainability, and performance.

 ## Context
+
 The user needs help refactoring code to make it cleaner, more maintainable, and aligned with best practices. Focus on practical improvements that enhance code quality without over-engineering.

 ## Requirements
+
 $ARGUMENTS

 ## Instructions

 ### 1. Code Analysis
+
 First, analyze the current code for:
+
 - **Code Smells**
  - Long methods/functions (>20 lines)
  - Large classes (>200 lines)
@@ -42,6 +46,7 @@ First, analyze the current code for:
 Create a prioritized refactoring plan:

 **Immediate Fixes (High Impact, Low Effort)**
+
 - Extract magic numbers to constants
 - Improve variable and function names
 - Remove dead code
@@ -49,6 +54,7 @@ Create a prioritized refactoring plan:
 - Extract duplicate code to functions

 **Method Extraction**
+
 ```
 # Before
 def process_order(order):
@@ -64,12 +70,14 @@ def process_order(order):
 ```

 **Class Decomposition**
+
 - Extract responsibilities to separate classes
 - Create interfaces for dependencies
 - Implement dependency injection
 - Use composition over inheritance

 **Pattern Application**
+
 - Factory pattern for object creation
 - Strategy pattern for algorithm variants
 - Observer pattern for event handling
@@ -81,6 +89,7 @@ def process_order(order):
 Provide concrete examples of applying each SOLID principle:

 **Single Responsibility Principle (SRP)**
+
 ```python
 # BEFORE: Multiple responsibilities in one class
 class UserManager:
@@ -121,6 +130,7 @@ class UserService:
 ```

 **Open/Closed Principle (OCP)**
+
 ```python
 # BEFORE: Modification required for new discount types
 class DiscountCalculator:
@@ -166,44 +176,62 @@ class DiscountCalculator:
 ```

 **Liskov Substitution Principle (LSP)**
+
 ```typescript
 // BEFORE: Violates LSP - Square changes Rectangle behavior
 class Rectangle {
-    constructor(protected width: number, protected height: number) {}
+  constructor(
+    protected width: number,
+    protected height: number,
+  ) {}

-    setWidth(width: number) { this.width = width; }
-    setHeight(height: number) { this.height = height; }
-    area(): number { return this.width * this.height; }
+  setWidth(width: number) {
+    this.width = width;
+  }
+  setHeight(height: number) {
+    this.height = height;
+  }
+  area(): number {
+    return this.width * this.height;
+  }
 }

 class Square extends Rectangle {
-    setWidth(width: number) {
-        this.width = width;
-        this.height = width; // Breaks LSP
-    }
-    setHeight(height: number) {
-        this.width = height;
-        this.height = height; // Breaks LSP
-    }
+  setWidth(width: number) {
+    this.width = width;
+    this.height = width; // Breaks LSP
+  }
+  setHeight(height: number) {
+    this.width = height;
+    this.height = height; // Breaks LSP
+  }
 }

 // AFTER: Proper abstraction respects LSP
 interface Shape {
-    area(): number;
+  area(): number;
 }

 class Rectangle implements Shape {
-    constructor(private width: number, private height: number) {}
-    area(): number { return this.width * this.height; }
+  constructor(
+    private width: number,
+    private height: number,
+  ) {}
+  area(): number {
+    return this.width * this.height;
+  }
 }

 class Square implements Shape {
-    constructor(private side: number) {}
-    area(): number { return this.side * this.side; }
+  constructor(private side: number) {}
+  area(): number {
+    return this.side * this.side;
+  }
 }
 ```

 **Interface Segregation Principle (ISP)**
+
 ```java
 // BEFORE: Fat interface forces unnecessary implementations
 interface Worker {
@@ -243,6 +271,7 @@ class Robot implements Workable {
 ```

 **Dependency Inversion Principle (DIP)**
+
 ```go
 // BEFORE: High-level module depends on low-level module
 type MySQLDatabase struct{}
@@ -392,30 +421,30 @@ class OrderService:
 // SMELL: Long Parameter List
 // BEFORE
 function createUser(
-    firstName: string,
-    lastName: string,
-    email: string,
-    phone: string,
-    address: string,
-    city: string,
-    state: string,
-    zipCode: string
+  firstName: string,
+  lastName: string,
+  email: string,
+  phone: string,
+  address: string,
+  city: string,
+  state: string,
+  zipCode: string,
 ) {}

 // AFTER: Parameter Object
 interface UserData {
-    firstName: string;
-    lastName: string;
-    email: string;
-    phone: string;
-    address: Address;
+  firstName: string;
+  lastName: string;
+  email: string;
+  phone: string;
+  address: Address;
 }

 interface Address {
-    street: string;
-    city: string;
-    state: string;
-    zipCode: string;
+  street: string;
+  city: string;
+  state: string;
+  zipCode: string;
 }

 function createUser(userData: UserData) {}
@@ -423,56 +452,56 @@ function createUser(userData: UserData) {}
 // SMELL: Feature Envy (method uses another class's data more than its own)
 // BEFORE
 class Order {
-    calculateShipping(customer: Customer): number {
-        if (customer.isPremium) {
-            return customer.address.isInternational ? 0 : 5;
-        }
-        return customer.address.isInternational ? 20 : 10;
+  calculateShipping(customer: Customer): number {
+    if (customer.isPremium) {
+      return customer.address.isInternational ? 0 : 5;
    }
+    return customer.address.isInternational ? 20 : 10;
+  }
 }

 // AFTER: Move method to the class it envies
 class Customer {
-    calculateShippingCost(): number {
-        if (this.isPremium) {
-            return this.address.isInternational ? 0 : 5;
-        }
-        return this.address.isInternational ? 20 : 10;
+  calculateShippingCost(): number {
+    if (this.isPremium) {
+      return this.address.isInternational ? 0 : 5;
    }
+    return this.address.isInternational ? 20 : 10;
+  }
 }

 class Order {
-    calculateShipping(customer: Customer): number {
-        return customer.calculateShippingCost();
-    }
+  calculateShipping(customer: Customer): number {
+    return customer.calculateShippingCost();
+  }
 }

 // SMELL: Primitive Obsession
 // BEFORE
 function validateEmail(email: string): boolean {
-    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
 }

 let userEmail: string = "test@example.com";

 // AFTER: Value Object
 class Email {
-    private readonly value: string;
+  private readonly value: string;

-    constructor(email: string) {
-        if (!this.isValid(email)) {
-            throw new Error("Invalid email format");
-        }
-        this.value = email;
+  constructor(email: string) {
+    if (!this.isValid(email)) {
+      throw new Error("Invalid email format");
    }
+    this.value = email;
+  }

-    private isValid(email: string): boolean {
-        return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
-    }
+  private isValid(email: string): boolean {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+  }

-    toString(): string {
-        return this.value;
-    }
+  toString(): string {
+    return this.value;
+  }
 }

 let userEmail = new Email("test@example.com"); // Validation automatic
@@ -482,15 +511,15 @@ let userEmail = new Email("test@example.com"); // Validation automatic

 **Code Quality Metrics Interpretation Matrix**

-| Metric | Good | Warning | Critical | Action |
-|--------|------|---------|----------|--------|
-| Cyclomatic Complexity | <10 | 10-15 | >15 | Split into smaller methods |
-| Method Lines | <20 | 20-50 | >50 | Extract methods, apply SRP |
-| Class Lines | <200 | 200-500 | >500 | Decompose into multiple classes |
-| Test Coverage | >80% | 60-80% | <60% | Add unit tests immediately |
-| Code Duplication | <3% | 3-5% | >5% | Extract common code |
-| Comment Ratio | 10-30% | <10% or >50% | N/A | Improve naming or reduce noise |
-| Dependency Count | <5 | 5-10 | >10 | Apply DIP, use facades |
+| Metric                | Good   | Warning      | Critical | Action                          |
+| --------------------- | ------ | ------------ | -------- | ------------------------------- |
+| Cyclomatic Complexity | <10    | 10-15        | >15      | Split into smaller methods      |
+| Method Lines          | <20    | 20-50        | >50      | Extract methods, apply SRP      |
+| Class Lines           | <200   | 200-500      | >500     | Decompose into multiple classes |
+| Test Coverage         | >80%   | 60-80%       | <60%     | Add unit tests immediately      |
+| Code Duplication      | <3%    | 3-5%         | >5%      | Extract common code             |
+| Comment Ratio         | 10-30% | <10% or >50% | N/A      | Improve naming or reduce noise  |
+| Dependency Count      | <5     | 5-10         | >10      | Apply DIP, use facades          |

 **Refactoring ROI Analysis**

@@ -554,18 +583,18 @@ jobs:
      # GitHub Copilot Autofix
      - uses: github/copilot-autofix@v1
        with:
-          languages: 'python,typescript,go'
+          languages: "python,typescript,go"

      # CodeRabbit AI Review
      - uses: coderabbitai/action@v1
        with:
-          review_type: 'comprehensive'
-          focus: 'security,performance,maintainability'
+          review_type: "comprehensive"
+          focus: "security,performance,maintainability"

      # Codium AI PR-Agent
      - uses: codiumai/pr-agent@v1
        with:
-          commands: '/review --pr_reviewer.num_code_suggestions=5'
+          commands: "/review --pr_reviewer.num_code_suggestions=5"
 ```

 **Static Analysis Toolchain**
@@ -693,6 +722,7 @@ rules:
 Provide the complete refactored code with:

 **Clean Code Principles**
+
 - Meaningful names (searchable, pronounceable, no abbreviations)
 - Functions do one thing well
 - No side effects
@@ -701,6 +731,7 @@ Provide the complete refactored code with:
 - YAGNI (You Aren't Gonna Need It)

 **Error Handling**
+
 ```python
 # Use specific exceptions
 class OrderValidationError(Exception):
@@ -720,6 +751,7 @@ def validate_order(order):
 ```

 **Documentation**
+
 ```python
 def calculate_discount(order: Order, customer: Customer) -> Decimal:
    """
@@ -742,6 +774,7 @@ def calculate_discount(order: Order, customer: Customer) -> Decimal:
 Generate comprehensive tests for the refactored code:

 **Unit Tests**
+
 ```python
 class TestOrderProcessor:
    def test_validate_order_empty_items(self):
@@ -757,6 +790,7 @@ class TestOrderProcessor:
 ```

 **Test Coverage**
+
 - All public methods tested
 - Edge cases covered
 - Error conditions verified
@@ -767,12 +801,14 @@ class TestOrderProcessor:
 Provide clear comparisons showing improvements:

 **Metrics**
+
 - Cyclomatic complexity reduction
 - Lines of code per method
 - Test coverage increase
 - Performance improvements

 **Example**
+
 ```
 Before:
 - processData(): 150 lines, complexity: 25
@@ -792,6 +828,7 @@ After:
 If breaking changes are introduced:

 **Step-by-Step Migration**
+
 1. Install new dependencies
 2. Update import statements
 3. Replace deprecated methods
@@ -799,6 +836,7 @@ If breaking changes are introduced:
 5. Execute test suite

 **Backward Compatibility**
+
 ```python
 # Temporary adapter for smooth migration
 class LegacyOrderProcessor:
@@ -816,6 +854,7 @@ class LegacyOrderProcessor:
 Include specific optimizations:

 **Algorithm Improvements**
+
 ```python
 # Before: O(n²)
 for item in items:
@@ -830,6 +869,7 @@ for item_id, item in item_map.items():
 ```

 **Caching Strategy**
+
 ```python
 from functools import lru_cache

--- a/plugins/code-refactoring/commands/tech-debt.md
+++ b/plugins/code-refactoring/commands/tech-debt.md
@@ -3,9 +3,11 @@
 You are a technical debt expert specializing in identifying, quantifying, and prioritizing technical debt in software projects. Analyze the codebase to uncover debt, assess its impact, and create actionable remediation plans.

 ## Context
+
 The user needs a comprehensive technical debt analysis to understand what's slowing down development, increasing bugs, and creating maintenance challenges. Focus on practical, measurable improvements with clear ROI.

 ## Requirements
+
 $ARGUMENTS

 ## Instructions
@@ -15,12 +17,12 @@ $ARGUMENTS
 Conduct a thorough scan for all types of technical debt:

 **Code Debt**
+
 - **Duplicated Code**
  - Exact duplicates (copy-paste)
  - Similar logic patterns
  - Repeated business rules
  - Quantify: Lines duplicated, locations
-  
 - **Complex Code**
  - High cyclomatic complexity (>10)
  - Deeply nested conditionals (>3 levels)
@@ -36,6 +38,7 @@ Conduct a thorough scan for all types of technical debt:
  - Quantify: Coupling metrics, change frequency

 **Architecture Debt**
+
 - **Design Flaws**
  - Missing abstractions
  - Leaky abstractions
@@ -51,6 +54,7 @@ Conduct a thorough scan for all types of technical debt:
  - Quantify: Version lag, security vulnerabilities

 **Testing Debt**
+
 - **Coverage Gaps**
  - Untested code paths
  - Missing edge cases
@@ -66,6 +70,7 @@ Conduct a thorough scan for all types of technical debt:
  - Quantify: Test runtime, failure rate

 **Documentation Debt**
+
 - **Missing Documentation**
  - No API documentation
  - Undocumented complex logic
@@ -74,6 +79,7 @@ Conduct a thorough scan for all types of technical debt:
  - Quantify: Undocumented public APIs

 **Infrastructure Debt**
+
 - **Deployment Issues**
  - Manual deployment steps
  - No rollback procedures
@@ -86,10 +92,11 @@ Conduct a thorough scan for all types of technical debt:
 Calculate the real cost of each debt item:

 **Development Velocity Impact**
+
 ```
 Debt Item: Duplicate user validation logic
 Locations: 5 files
-Time Impact: 
+Time Impact:
 - 2 hours per bug fix (must fix in 5 places)
 - 4 hours per feature change
 - Monthly impact: ~20 hours
@@ -97,12 +104,13 @@ Annual Cost: 240 hours × $150/hour = $36,000
 ```

 **Quality Impact**
+
 ```
 Debt Item: No integration tests for payment flow
 Bug Rate: 3 production bugs/month
 Average Bug Cost:
 - Investigation: 4 hours
- Fix: 2 hours  
+- Fix: 2 hours
 - Testing: 2 hours
 - Deployment: 1 hour
 Monthly Cost: 3 bugs × 9 hours × $150 = $4,050
@@ -110,6 +118,7 @@ Annual Cost: $48,600
 ```

 **Risk Assessment**
+
 - **Critical**: Security vulnerabilities, data loss risk
 - **High**: Performance degradation, frequent outages
 - **Medium**: Developer frustration, slow feature delivery
@@ -120,26 +129,27 @@ Annual Cost: $48,600
 Create measurable KPIs:

 **Code Quality Metrics**
+
 ```yaml
 Metrics:
  cyclomatic_complexity:
    current: 15.2
    target: 10.0
    files_above_threshold: 45
-    
+
  code_duplication:
    percentage: 23%
    target: 5%
    duplication_hotspots:
      - src/validation: 850 lines
      - src/api/handlers: 620 lines
-      
+
  test_coverage:
    unit: 45%
    integration: 12%
    e2e: 5%
    target: 80% / 60% / 30%
-    
+
  dependency_health:
    outdated_major: 12
    outdated_minor: 34
@@ -148,6 +158,7 @@ Metrics:
 ```

 **Trend Analysis**
+
 ```python
 debt_trends = {
    "2024_Q1": {"score": 750, "items": 125},
@@ -164,6 +175,7 @@ Create an actionable roadmap based on ROI:

 **Quick Wins (High Value, Low Effort)**
 Week 1-2:
+
 ```
 1. Extract duplicate validation logic to shared module
   Effort: 8 hours
@@ -182,6 +194,7 @@ Week 1-2:
 ```

 **Medium-Term Improvements (Month 1-3)**
+
 ```
 1. Refactor OrderService (God class)
   - Split into 4 focused services
@@ -195,12 +208,13 @@ Week 1-2:
   - Update component patterns
   - Migrate to hooks
   - Fix breaking changes
-   Effort: 80 hours  
+   Effort: 80 hours
   Benefits: Performance +30%, Better DX
   ROI: Positive after 3 months
 ```

 **Long-Term Initiatives (Quarter 2-4)**
+
 ```
 1. Implement Domain-Driven Design
   - Define bounded contexts
@@ -222,12 +236,13 @@ Week 1-2:
 ### 5. Implementation Strategy

 **Incremental Refactoring**
+
 ```python
 # Phase 1: Add facade over legacy code
 class PaymentFacade:
    def __init__(self):
        self.legacy_processor = LegacyPaymentProcessor()
-    
+
    def process_payment(self, order):
        # New clean interface
        return self.legacy_processor.doPayment(order.to_legacy())
@@ -243,7 +258,7 @@ class PaymentFacade:
    def __init__(self):
        self.new_service = PaymentService()
        self.legacy = LegacyPaymentProcessor()
-        
+
    def process_payment(self, order):
        if feature_flag("use_new_payment"):
            return self.new_service.process_payment(order)
@@ -251,15 +266,16 @@ class PaymentFacade:
 ```

 **Team Allocation**
+
 ```yaml
 Debt_Reduction_Team:
  dedicated_time: "20% sprint capacity"
-  
+
  roles:
    - tech_lead: "Architecture decisions"
-    - senior_dev: "Complex refactoring"  
+    - senior_dev: "Complex refactoring"
    - dev: "Testing and documentation"
-    
+
  sprint_goals:
    - sprint_1: "Quick wins completed"
    - sprint_2: "God class refactoring started"
@@ -271,17 +287,18 @@ Debt_Reduction_Team:
 Implement gates to prevent new debt:

 **Automated Quality Gates**
+
 ```yaml
 pre_commit_hooks:
  - complexity_check: "max 10"
  - duplication_check: "max 5%"
  - test_coverage: "min 80% for new code"
-  
+
 ci_pipeline:
  - dependency_audit: "no high vulnerabilities"
  - performance_test: "no regression >10%"
  - architecture_check: "no new violations"
-  
+
 code_review:
  - requires_two_approvals: true
  - must_include_tests: true
@@ -289,6 +306,7 @@ code_review:
 ```

 **Debt Budget**
+
 ```python
 debt_budget = {
    "allowed_monthly_increase": "2%",
@@ -304,8 +322,10 @@ debt_budget = {
 ### 7. Communication Plan

 **Stakeholder Reports**
+
 ```markdown
 ## Executive Summary
+
 - Current debt score: 890 (High)
 - Monthly velocity loss: 35%
 - Bug rate increase: 45%
@@ -313,19 +333,23 @@ debt_budget = {
 - Expected ROI: 280% over 12 months

 ## Key Risks
+
 1. Payment system: 3 critical vulnerabilities
 2. Data layer: No backup strategy
 3. API: Rate limiting not implemented

 ## Proposed Actions
+
 1. Immediate: Security patches (this week)
 2. Short-term: Core refactoring (1 month)
 3. Long-term: Architecture modernization (6 months)
 ```

 **Developer Documentation**
+
 ```markdown
 ## Refactoring Guide
+
 1. Always maintain backward compatibility
 2. Write tests before refactoring
 3. Use feature flags for gradual rollout
@@ -333,6 +357,7 @@ debt_budget = {
 5. Measure impact with metrics

 ## Code Standards
+
 - Complexity limit: 10
 - Method length: 20 lines
 - Class length: 200 lines
@@ -345,6 +370,7 @@ debt_budget = {
 Track progress with clear KPIs:

 **Monthly Metrics**
+
 - Debt score reduction: Target -5%
 - New bug rate: Target -20%
 - Deployment frequency: Target +50%
@@ -352,6 +378,7 @@ Track progress with clear KPIs:
 - Test coverage: Target +10%

 **Quarterly Reviews**
+
 - Architecture health score
 - Developer satisfaction survey
 - Performance benchmarks
@@ -368,4 +395,4 @@ Track progress with clear KPIs:
 6. **Prevention Plan**: Processes to avoid accumulating new debt
 7. **ROI Projections**: Expected returns on debt reduction investment

-Focus on delivering measurable improvements that directly impact development velocity, system reliability, and team morale.
+Focus on delivering measurable improvements that directly impact development velocity, system reliability, and team morale.