Tech Debt Calculator from GitHub

Analyze GitHub repositories for technical debt. Calculate complexity, detect outdated dependencies, identify code smells, and estimate refactoring effort. Free SonarQube alternative for quick analysis.

Features

• Repository Analysis: Comprehensive codebase scanning
• Debt Scoring: 0-100 debt score based on multiple metrics
• Effort Estimation: Calculate refactoring time and cost
• Issue Prioritization: Rank issues by impact and severity
• Full Reports: Complete technical debt assessment

Operations

1. Analyze Repository

Scan GitHub repository for:

• Cyclomatic complexity
• Code smells
• Outdated dependencies
• TODO/FIXME comments
• File and line counts

2. Score Tech Debt

Calculate 0-100 debt score based on:

• Complexity (30%): Cyclomatic complexity metrics
• Code Smells (25%): Long functions, deep nesting, duplicates
• Outdated Dependencies (25%): Package version analysis
• TODOs/FIXMEs (20%): Technical debt markers

3. Estimate Effort

Calculate refactoring effort in:

• Hours and days
• Estimated cost
• Breakdown by issue type

4. Prioritize Issues

Rank issues by:

• Severity (critical, high, medium, low)
• Impact on codebase quality
• Effort required
• Business value

5. Generate Full Report

Comprehensive analysis including:

• Debt score and metrics
• Effort estimation
• Prioritized issue list
• Actionable recommendations

Input Parameters

• operation: Operation to perform (required)
• repositoryUrl: GitHub repository URL (required)
• githubToken: GitHub token for private repos (optional)
• branch: Branch to analyze (default: main)
• includeTests: Include test files (default: false)
• checkDependencies: Analyze dependencies (default: true)
• checkComplexity: Check code complexity (default: true)
• checkCodeSmells: Detect code smells (default: true)
• checkTodos: Count TODOs/FIXMEs (default: true)
• filePatterns: Patterns to include (default: common source files)
• excludePatterns: Patterns to exclude (default: node_modules, dist, etc.)

Use Cases

1. Pre-Refactoring: Assess debt before planning refactoring sprints
2. Code Reviews: Quick quality check for pull requests
3. Legacy Systems: Evaluate inherited codebases
4. Migration Planning: Estimate effort for modernization
5. Technical Due Diligence: Assess code quality for acquisitions

Example

{
  "operation": "generateReport",
  "repositoryUrl": "https://github.com/facebook/react",
  "branch": "main",
  "checkDependencies": true,
  "checkComplexity": true,
  "checkCodeSmells": true,
  "checkTodos": true
}

Output

Returns debt score (0-100), estimated refactoring effort, prioritized issues, and actionable recommendations.

Scoring Interpretation

• 0-30 (Low): Maintain current quality
• 30-50 (Medium): Address issues incrementally
• 50-70 (High): Schedule refactoring sprint
• 70-100 (Critical): Immediate action required

Market Gap

Free alternative to SonarQube for quick analysis. No installation or configuration required. Perfect for one-time assessments and continuous monitoring.

Target MAU: 600