Coderot — Refactor Priority Engine

Know what to fix. Fix it first.

coderot analyzes your TypeScript and JavaScript codebase and produces a prioritized refactor roadmap — every file scored by impact, sorted by risk. Stop guessing. Start with the file that matters most.

What it does

Most tools tell you what is wrong. coderot tells you which wrong thing to fix first.

It combines three signals into a single Impact Score (0–100) per file:

Signal	Weight	What it measures
Dependency graph	30%	How many files import this one
Git churn	25%	Commit frequency over the last 90 days
Static complexity	20%	Cyclomatic complexity, nesting depth, function length
Issue severity	15%	Weighted count of detected code issues
File size	10%	Lines of non-comment code

A file with a score of 78 is complex, changes frequently, and is imported by many other files. Fix it before it causes an incident.

How to use

1. Install the CLI

The extension requires the coderot-engine CLI to be installed globally:

npm install -g coderot-engine

2. Run the analysis

Open any TypeScript or JavaScript project, then:

Command Palette: Cmd+Shift+P → Coderot: Analyze Workspace
Activity Bar: click the coderot icon in the sidebar and press the analyze button
Status Bar: click the $(bug) Coderot item at the bottom of the window

3. Read the results

The analysis runs locally and produces three outputs simultaneously:

Refactor Roadmap sidebar — files sorted by impact score, highest risk first. Each item shows the score and opens the file on click.

Inline diagnostics (squiggles) — every detected issue appears as a squiggle in the editor and in the Problems panel:

Severity	Appears as
CRITICAL	Error (red squiggle)
HIGH	Warning (yellow squiggle)
MEDIUM	Information (blue squiggle)
LOW	Hint

Status bar — updates after each scan to show the number of critical-risk files at a glance.

Screenshot

coderot sidebar and diagnostics

Requirements

Node.js 18 or higher
coderot-engine CLI installed globally:
```
npm install -g coderot-engine
```

The extension will show a clear error message if coderot-engine is not found in your PATH.

What gets detected

Complexity issues

Cyclomatic complexity > 10 (HIGH) or > 20 (CRITICAL)
Functions longer than 50 lines (MEDIUM) or 100 lines (HIGH)
Nesting depth > 3 (MEDIUM) or > 5 (HIGH)

Size issues

Files over 500 LOC (HIGH) or 1000 LOC (CRITICAL)
Files with more than 15 imports (MEDIUM — coupling warning)

Type issues

Function parameters missing TypeScript type annotations (LOW)

Privacy & Security

Runs 100% locally — no data leaves your machine
Zero network calls — no telemetry, no analytics, no outbound connections
Uses execFile (never exec) — shell injection is structurally impossible

Coderot

coderot-engine