Function deriveCodebaseHealth

src/health/derive.ts:168–207

({
  buildId,
  formatVersion,
  generatedAt,
  chunks,
  graph
}: DeriveCodebaseHealthParams)

}

export function deriveCodebaseHealth({
  buildId,
  formatVersion,
  generatedAt,
  chunks,
  graph
}: DeriveCodebaseHealthParams): CodebaseHealthArtifact {
  const fileMetrics = collectFileMetrics(chunks, graph);
  const files = Array.from(fileMetrics.entries())
    .map(([file, metrics]) => {
      const health = getHealthLevel(metrics);
      return {
        ...health,
        file
      };
    })
    .sort((a, b) => {
      const priority = { high: 0, medium: 1, low: 2 };
      const levelDelta = priority[a.level] - priority[b.level];
      if (levelDelta !== 0) return levelDelta;
      if (b.score !== a.score) return b.score - a.score;
      return a.file.localeCompare(b.file);
    });

  const highRiskFiles = files.filter((file) => file.level === 'high').length;
  const mediumRiskFiles = files.filter((file) => file.level === 'medium').length;
  const lowRiskFiles = files.length - highRiskFiles - mediumRiskFiles;

  return {
    header: { buildId, formatVersion },
    generatedAt,
    summary: {
      files: files.length,
      highRiskFiles,
      mediumRiskFiles,
      lowRiskFiles
    },
    files
  };
}