Refactoring Recommendations

Refactoring Recommendations (breaking)

refactoring_recommendations synthesizes upstream architecture metrics into deterministic, evidence-first refactor actions.

What Changed

• Breaking key namespace: refactoring_recommendations.*
• Deterministic ranking and dedup pipeline
• Explicit confidence per recommendation
• Optional SARIF findings for P1/P2 outputs

Keys

• refactoring_recommendations.total
• refactoring_recommendations.by_type.{break_cycle|split_hub|move_module|fix_layer|fix_unstable|refactor_hotspot}
• refactoring_recommendations.by_priority.{p1|p2|p3}
• refactoring_recommendations.by_impact.{critical|high|medium|low}
• refactoring_recommendations.mean_confidence
• refactoring_recommendations.coverage_ratio
• refactoring_recommendations.duplicates_removed

JSON payload entries:

• refactoring_recommendations.recommendations
• refactoring_recommendations.summary
• refactoring_recommendations.normalization

Config

metrics:
  - id: refactoring_recommendations
    enabled: true
    config:
      max_recommendations: 30
      max_priority: 3
      min_confidence: 0.60
      types_allowlist: []
      types_denylist: []
      enable_findings: true
      dedup_strategy: structural
      ranking_profile: balanced

Migration

Legacy legacy keys were removed. Migrate dashboards/policies to refactoring_recommendations.*.