tech-debt-hunt

Technical Debt Assessment

Please help me identify and prioritize technical debt in ${FOCUS_AREA:-the entire codebase}.

Thresholds:

• File size: ${MAX_FILE_SIZE:-500} lines
• Complexity: ${MAX_COMPLEXITY:-15}
• TODO age: ${TODO_AGE_DAYS:-30} days

Debt Discovery

1. Find TODOs and FIXMEs:

   # Get all TODOs with context
   ch cq todos --with-context
   
   # Find old TODOs (using git blame)
   chs find-code "TODO|FIXME|HACK|XXX" 2>/dev/null | while IFS= read -r file; do
     if [ -f "$file" ]; then
       echo "=== $file ==="
       git blame "$file" 2>/dev/null | grep -E "TODO|FIXME|HACK|XXX" || true
     fi
   done
   

2. Identify large files:

   # Find files exceeding threshold
   ch cq large-files ${MAX_FILE_SIZE:-500}
   
   # Show largest files first
   find . -name "*.${FILE_EXT:-js|ts|py}" -exec wc -l {} + | sort -rn | head -20
   

3. Find complex code:

   # High cyclomatic complexity
   ch cq complexity ${MAX_COMPLEXITY:-15}
   
   # Deeply nested code
   chs find-code "^\\s{16,}" --files-with-matches
   
   # Long functions (multiple patterns)
   chs find-code "function.*\\{[^}]{500,}" 
   

4. Check for outdated patterns:

   # Find deprecated usage
   chs find-code "@deprecated|DEPRECATED"
   
   # Old library usage
   chs find-code "${OLD_PATTERNS:-callback\\(err\\)|var\\s+\\w+\\s*=\\s*require}"
   

5. Dependency debt:

   # Check for outdated packages
   ch ts deps --outdated
   
   # Find security vulnerabilities
   ch ts audit
   
   # Look for multiple versions
   ch ts deps --duplicates
   

6. Code duplication:

   # Find similar patterns
   for pattern in "${DUPLICATE_PATTERNS[@]:-"function.*{" "class.*{" "interface.*{"}"; do
     echo "=== Checking pattern: $pattern ==="
     chs find-code "$pattern" --count | sort -rn | head -10
   done
   

7. Missing tests:

   # Find untested files
   comm -23 \
     <(find . -name "*.${FILE_EXT:-js}" | grep -v test | sort) \
     <(chs find-file "*.test.*" | xargs grep -l "import\|require" | sort -u)