Function channelVersion

packages/bumpy/src/commands/version.ts:114–180

(
  rootDir: string,
  config: BumpyConfig,
  channel: ResolvedChannel,
  opts: { commit?: boolean } = {},
)

 * as shipped on this channel.
 */
export async function channelVersion(
  rootDir: string,
  config: BumpyConfig,
  channel: ResolvedChannel,
  opts: { commit?: boolean } = {},
): Promise<ChannelVersionResult | null> {
  const packages = await discoverPackages(rootDir, config);
  const depGraph = new DependencyGraph(packages);
  const { bumpFiles, errors: parseErrors } = await readBumpFiles(rootDir, { channels: channelNames(config) });

  if (parseErrors.length > 0) {
    for (const err of parseErrors) {
      log.error(err);
    }
    throw new Error('Bump file parse errors must be fixed before versioning.');
  }

  // A bump file is pending for this channel unless it's already in this channel's dir
  const pending = bumpFiles.filter((bf) => bf.channel !== channel.name);

  if (pending.length === 0) {
    log.info(`No pending bump files for channel "${channel.name}".`);
    return null;
  }

  // The full cycle (pending + shipped) determines the targets — show them, suffixed.
  // Counters come from the registry at publish time, so they render as ".?" here.
  const cyclePlan = assembleReleasePlan(bumpFiles, packages, depGraph, config, {
    prereleasePreid: channel.preid,
  });

  if (cyclePlan.warnings.length > 0) {
    for (const w of cyclePlan.warnings) {
      log.warn(w);
    }
    console.log();
  }

  log.step(`Channel "${channel.name}" — moving ${pending.length} bump file(s) into .bumpy/${channel.name}/:`);
  for (const bf of pending) {
    const from = bf.channel ? `.bumpy/${bf.channel}/` : '.bumpy/';
    console.log(`  ${from}${bf.id}.md → .bumpy/${channel.name}/${bf.id}.md`);
  }
  console.log();
  log.step('Cycle targets (counters are derived from the registry at publish time):');
  for (const r of cyclePlan.releases) {
    const tag = r.isDependencyBump ? ' (dep)' : r.isCascadeBump ? ' (cascade)' : '';
    console.log(`  ${r.name}: ${r.oldVersion} → ${colorize(`${r.newVersion}-${channel.preid}.x`, 'cyan')}${tag}`);
  }

  await moveBumpFilesToChannel(rootDir, pending, channel.name);
  log.success(`🐸 Moved ${pending.length} bump file(s) — no versions written (prereleases are derived, not committed)`);

  if (opts.commit) {
    try {
      runArgs(['git', 'add', '-A', '.bumpy/'], { cwd: rootDir });
      const summary = pending.map((bf) => `${bf.id}.md`).join(', ');
      const msg = `Version prerelease (${channel.name})\n\nShipped: ${summary}`;