code-refiner

What problem does it solve?

Long, tangled, or idiomatically inconsistent code that is hard to read, maintain, and review without changing its observable behavior; it reduces cognitive load and technical debt by applying targeted, behavior-preserving refinements.

Core Features & Use Cases

• Multi-pass analysis: Reconnaissance, structural analysis, refactoring execution, verification, and reporting to ensure safe, incremental changes.
• Language-agnostic guidance: Tailored idiom recommendations and tactics for Python, Go, TypeScript/JavaScript, and Rust using embedded references.
• Automated metrics & verification: Uses a builtin Python complexity_report tool and git-based scope detection to quantify complexity deltas and run verification steps (tests, linters, manual trace).
• Conservative behavioral constraints: Enforces strict rules to never change observable behavior, public APIs, or introduce new dependencies, with configurable aggressiveness modes (quick, standard, deep, surgical).
• Developer-facing report generation: Produces per-file change summaries, complexity deltas, and risk assessments to build trust before committing.

Quick Start

Refine the recent git changes to reduce nesting and improve readability while preserving exact behavior.