Function getHealthLevel

src/health/derive.ts:114–166

(fileMetrics: FileMetrics)

}

function getHealthLevel(fileMetrics: FileMetrics): CodebaseHealthFile {
  const reasons: string[] = [];
  let score = 0;

  if (fileMetrics.cycleCount > 0) {
    score += 3;
    reasons.push(
      `Participates in ${fileMetrics.cycleCount} circular dependenc${fileMetrics.cycleCount === 1 ? 'y' : 'ies'}`
    );
  }

  if (fileMetrics.importerCount >= 8) {
    score += 2;
    reasons.push(`High fan-in: ${fileMetrics.importerCount} files depend on it`);
  } else if (fileMetrics.importerCount >= 4) {
    score += 1;
    reasons.push(`Shared dependency for ${fileMetrics.importerCount} files`);
  }

  if (fileMetrics.hotspotRank && fileMetrics.hotspotRank <= 5) {
    score += 2;
    reasons.push(`Hotspot rank #${fileMetrics.hotspotRank} by graph centrality`);
  } else if (fileMetrics.hotspotRank && fileMetrics.hotspotRank <= 10) {
    score += 1;
    reasons.push(`Top-10 hotspot by graph centrality`);
  }

  if (fileMetrics.maxCyclomaticComplexity >= 18) {
    score += 2;
    reasons.push(`Complex implementation (cyclomatic ${fileMetrics.maxCyclomaticComplexity})`);
  } else if (fileMetrics.maxCyclomaticComplexity >= 10) {
    score += 1;
    reasons.push(`Moderate code complexity (cyclomatic ${fileMetrics.maxCyclomaticComplexity})`);
  }

  const level = score >= 4 ? 'high' : score >= 2 ? 'medium' : ('low' as const);

  return {
    file: '',
    level,
    score,
    reasons: reasons.slice(0, 3),
    signals: {
      ...(fileMetrics.hotspotRank ? { hotspotRank: fileMetrics.hotspotRank } : {}),
      ...(fileMetrics.importerCount > 0 ? { importerCount: fileMetrics.importerCount } : {}),
      ...(fileMetrics.importCount > 0 ? { importCount: fileMetrics.importCount } : {}),
      ...(fileMetrics.cycleCount > 0 ? { cycleCount: fileMetrics.cycleCount } : {}),
      ...(fileMetrics.maxCyclomaticComplexity > 0
        ? { maxCyclomaticComplexity: fileMetrics.maxCyclomaticComplexity }
        : {})
    }
  };
}

export function deriveCodebaseHealth({
  buildId,