dsh-refactor-insight

Inheriting a codebase that has been running for years without anyone daring to touch it is rarely about finding problems—it is about knowing what to fix first, how much to change, and which refactors will trigger cascade failures. dsh-refactor-insight turns that judgment call into an executable, priority-ordered refactoring plan with line-level location, severity ranking, and dependency sequence. It is a structural health check, not a line-by-line diff review.

The plugin ships six deterministic code-smell rules: oversized files, deep nesting, TODO/FIXME density, long functions, god objects, and tightly coupled modules (including Tarjan cycle detection). Every threshold is overridable via CLI parameters, and the scanning layer is dependency-free and fully deterministic. An LLM refinement layer then trims false positives and annotates each finding with severity, estimated cost, and a recommended action. The deliverable is a structured REFACTOR-PLAN.md generated from a documented template; the plugin never modifies source code on its own, and high-risk refactors require explicit human sign-off. Language recognition covers Python indentation blocks, JavaScript/TypeScript brace pairing, and Go receiver methods, and the diagnostic scripts also run standalone on Node.js without the DSH runtime.

If you are maintaining a legacy system that is slowly bloating, inheriting a third-party repository with sparse documentation, or need to communicate to stakeholders which modules will be touched and in what order, this plugin consolidates scattered code smells into a single, actionable refactoring roadmap.