nwiizo Explain Issue
Explain the specified issue type with overview, detection conditions, code examples, and solution approaches.
Issue Types
Global Complexity
- Condition: Strong coupling + far distance
- Formula:
STRENGTH >= 0.5 AND DISTANCE >= 0.5 - Fix: Introduce traits, move modules, facade pattern
Cascading Change Risk
- Condition: Strong coupling + high volatility
- Formula:
STRENGTH >= 0.5 AND VOLATILITY >= 0.5 - Fix: Stable interface layer, dependency inversion
Inappropriate Intimacy
- Condition: Intrusive coupling across boundaries
- Formula:
STRENGTH = 1.0 AND DISTANCE > 0.0 - Fix: Encapsulation,
pub(crate)usage
High Efferent Coupling
- Condition: Module has too many outgoing dependencies
- Threshold: Default 15
- Fix: Module splitting, facade pattern
High Afferent Coupling
- Condition: Module has too many incoming dependencies
- Threshold: Default 20
- Fix: Interface introduction, responsibility distribution
Unnecessary Abstraction
- Condition: Weak coupling + near distance + low volatility
- Formula:
STRENGTH < 0.3 AND DISTANCE < 0.3 AND VOLATILITY < 0.3 - Fix: Remove abstraction, use direct implementation
Explanation Structure
For each issue type, include:
- Overview: Concise description
- Why problematic: Concrete negative impacts
- Detection conditions: Formula and thresholds
- Code examples: Before/After Rust code
- Solution approaches: Multiple resolution methods
- Design principles: SOLID, Khononov Balance, Rust idioms
Reference
- Balancing Coupling in Software Design
- Khononov Balance:
(STRENGTH XOR DISTANCE) OR NOT VOLATILITY