Function formatReleasePlanComment

packages/bumpy/src/commands/ci.ts:1320–1451

(
  plan: ReleasePlan,
  bumpFiles: BumpFile[],
  prNumber: string,
  prBranch: string | null,
  pm: PackageManager,
  warnings: string[] = [],
  parseErrors: string[] = [],
  emptyBumpFileIds: string[] = [],
  channel: ResolvedChannel | null = null,
  allChannels: Map<string, ResolvedChannel> | null = null,
)

  published: { name: string; version: string }[],
  pm: PackageManager,
): string {
  const lines: string[] = [
    `<a href="https://bumpy.varlock.dev"><img src="${FROG_IMG_BASE}/frog-clipboard.png" alt="bumpy-frog" width="60" align="left" style="image-rendering: pixelated;" title="Hi! I'm bumpy!" /></a>`,
    '',
    `**Snapshot published** to the \`@${snapshot.tag}\` dist-tag — a throwaway preview of this PR, not a stable release.`,
    '<br clear="left" />',
    '',
    '#### Published packages',
    '',
  ];
  for (const p of published) {
    lines.push(`- \`${p.name}@${p.version}\``);
  }
  lines.push('');
  lines.push('Install the latest snapshot for this PR:');
  lines.push('');
  lines.push('```bash');
  for (const p of published) {
    lines.push(pmInstallCommand(pm, `${p.name}@${snapshot.tag}`));
  }
  lines.push('```');
  lines.push('');
  lines.push(
    `> The \`@${snapshot.tag}\` tag always points at the newest snapshot from this PR — pushing new commits republishes it. ` +
      `Exact versions above are pinned to each other so they install as a coherent set.`,
  );
  lines.push('');
  lines.push('---');
  lines.push(`_This comment is maintained by [bumpy](https://bumpy.varlock.dev)._`);
  return lines.join('\n');
}

export function formatReleasePlanComment(
  plan: ReleasePlan,
  bumpFiles: BumpFile[],
  prNumber: string,
  prBranch: string | null,
  pm: PackageManager,
  warnings: string[] = [],
  parseErrors: string[] = [],
  emptyBumpFileIds: string[] = [],
  channel: ResolvedChannel | null = null,
  allChannels: Map<string, ResolvedChannel> | null = null,
): string {
  const repo = process.env.GITHUB_REPOSITORY;
  const lines: string[] = [];

  // When targeting a prerelease channel, the version display carries a wildcard
  // `-<preid>.x` suffix (the exact counter is derived from the registry at publish time).
  const versionSuffix = channel ? `-${channel.preid}.x` : '';

  // Promotion PR: stable-targeted, carrying bump files that already shipped on a
  // channel (e.g. `next` → `main`). Merging it ends the cycle and ships stable.
  const promotedChannels = channel ? [] : [...new Set(bumpFiles.map((bf) => bf.channel))].filter((c) => c != null);
  const channelTag = (name: string) => `\`@${allChannels?.get(name)?.tag ?? name}\``;

  const headline = channel
    ? `**This PR targets the \`${channel.name}\` prerelease channel** — merging it ships these packages as a **prerelease** to the \`@${channel.tag}\` dist-tag, not a stable release.`