Function formatMarkdown

src/tools/git/classify-commits.ts:124–148

(
  buckets: CategoryBuckets,
  opts: { scope: 'user' | 'all'; heading: string; range: string },
)

};

export function formatMarkdown(
  buckets: CategoryBuckets,
  opts: { scope: 'user' | 'all'; heading: string; range: string },
): string {
  const showInternal = opts.scope === 'all';
  const order: ReleaseCategory[] = showInternal
    ? ['breaking', 'features', 'fixes', 'perf', 'docs', 'internal', 'other']
    : ['breaking', 'features', 'fixes', 'perf'];

  const lines: string[] = [`## ${opts.heading}`, '', `_Range: \`${opts.range}\`_`, ''];
  let any = false;
  for (const cat of order) {
    const items = buckets[cat];
    if (items.length === 0) continue;
    any = true;
    lines.push(`### ${SECTION_LABELS[cat]}`);
    for (const it of items) {
      const scopeTag = it.scope ? `**${it.scope}:** ` : '';
      lines.push(`- ${scopeTag}${stripConvPrefix(it.subject)} (\`${it.sha}\`)`);
    }
    lines.push('');
  }
  if (!any) lines.push('_No user-facing changes in this range._', '');
  return lines.join('\n').replace(/\n{3,}/g, '\n\n').trimEnd() + '\n';
}

function stripConvPrefix(subject: string): string {
  return subject.replace(CONV_RE, (_, ..._args) => {