Technical Debt Radar

Stop Node.js production crashes before merge.

Detects event-loop blockers, dangerous ORM patterns, and architecture drift in your PRs. 47 detection patterns across 5 categories. Works with NestJS, Express, Fastify, Koa, Hapi + 7 ORMs.

Quick Start

npx technical-debt-radar scan .

First scan is free. No account needed.

What It Finds

• Runtime risks — sync I/O, crypto, ReDoS in request handlers (11 patterns)
• Performance — N+1 queries, unbounded fetches, missing pagination (9 patterns, volume-aware)
• Reliability — unhandled promises, missing timeouts, empty catches (8 patterns)
• Architecture — layer violations, circular dependencies (4 rules)
• Maintainability — complexity, duplication, dead code, coverage drops (7 patterns)

Commands

| Command | Description | |---------|-------------| | radar scan . | Scan project, show violations | | radar check <file> | Check single file | | radar init | Auto-detect stack, generate config | | radar fix . | AI-powered fixes (requires login) | | radar login | Authenticate for unlimited scans | | radar whoami | Show account and usage | | radar validate | Validate radar.yml | | radar badge | Generate README badge | | radar pack list | Browse rule packs |

Output Formats

radar scan . --format text      # Human-readable (default)
radar scan . --format json      # Machine-readable
radar scan . --format table     # Compact table
radar scan . --format markdown  # Markdown report
radar scan . --format ai-prompt # Paste into Claude/Cursor for fixes

CI/CD (GitHub Action)

- uses: khalid-Elattar/technical_dept_radar@v1
  with:
    radar-token: ${{ secrets.RADAR_TOKEN }}

Pricing

• Free: Unlimited scans, PR comments (warn mode)
• Solo ($15/mo): PR merge blocking + 50 AI credits
• Pro ($49/mo): GitLab, cross-file AI, architecture graph

https://technicaldebtradar.com/pricing

Links

• Website: https://technicaldebtradar.com
• Dashboard: https://technicaldebtradar.com/dashboard
• GitHub: https://github.com/khalid-Elattar/technical_dept_radar