Function formatHelperClusters

src/codegraph/helper-extract.ts:309–318

(clusters: HelperCluster[])

/** A concise, agent-readable report of extraction opportunities. PURE. */
export function formatHelperClusters(clusters: HelperCluster[]): string {
  if (!clusters.length) return 'No near-duplicate helper clusters found — nothing worth extracting.';
  const lines = [`Found ${clusters.length} near-duplicate helper cluster(s) — candidates to extract into a shared helper:`, ''];
  clusters.forEach((c, i) => {
    lines.push(`${i + 1}. ~${Math.round(c.avgSimilarity * 100)}% similar${c.exact ? ' (EXACT — use consolidate-dupes)' : ''} · ${c.members.length} copies · ~${c.estLinesSaved} lines saved → helper \`${c.suggestedName}()\``);
    for (const m of c.members) lines.push(`   - ${m.name}  (${m.file}:${m.startLine}-${m.endLine})`);
  });
  lines.push('', 'Detection only — extracting changes call sites. Review, then extract with a verified PR.');
  return lines.join('\n');
}