Function ciReleaseCommand

packages/bumpy/src/commands/ci.ts:547–622

(rootDir: string, opts: ReleaseOptions)

 * when the detected state doesn't match expectations (used by split-job workflows).
 */
export async function ciReleaseCommand(rootDir: string, opts: ReleaseOptions): Promise<void> {
  const config = await loadConfig(rootDir);
  ensureGitIdentity(rootDir, config);

  // Snapshots are a one-shot transient release that can run from any branch (typically a
  // feature PR), so they bypass the base/channel branch routing entirely.
  if (opts.snapshot !== undefined) {
    await ciSnapshotRelease(rootDir, opts);
    return;
  }

  // Channel branches get the channel flow; unknown branches are refused (when channels
  // are configured) so a misconfigured workflow can't publish from a feature branch.
  const releaseBranch = detectReleaseBranch(rootDir);
  const channel = matchChannelByBranch(config, releaseBranch);
  if (channel) {
    await ciChannelRelease(rootDir, config, channel, opts);
    return;
  }
  if (Object.keys(config.channels || {}).length > 0 && releaseBranch && releaseBranch !== config.baseBranch) {
    throw new Error(
      `"bumpy ci release" ran on branch "${releaseBranch}", which is neither the base branch ` +
        `("${config.baseBranch}") nor a configured channel branch. Refusing to release — ` +
        'add the branch to "channels" in .bumpy/_config.json or fix the workflow trigger.',
    );
  }

  const { packages } = await discoverWorkspace(rootDir, config);
  const depGraph = new DependencyGraph(packages);
  // Channel-dir bump files count as pending on the base branch — merging a channel
  // into main brings its shipped files along, and the stable release consumes them
  // (promotion). No special mode needed.
  const { bumpFiles, errors: releaseParseErrors } = await readBumpFiles(rootDir, { channels: channelNames(config) });

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

  // Determine detected mode. "version-pr" = bump files exist with real releases.
  // "publish" = no bump files, or only none-only files (version PR just merged).
  const plan = bumpFiles.length > 0 ? assembleReleasePlan(bumpFiles, packages, depGraph, config) : null;
  const detectedMode: 'version-pr' | 'publish' = plan && plan.releases.length > 0 ? 'version-pr' : 'publish';

  if (opts.assertMode && opts.assertMode !== detectedMode) {
    throw new Error(
      `Expected mode "${opts.assertMode}" but detected "${detectedMode}". ` +
        `Either remove --expect-mode, or gate this step on the output of "bumpy ci plan".`,
    );
  }

  if (detectedMode === 'publish') {
    // No bump files (or only none-only) — check for unpublished packages.
    // Recover bump files deleted in the version commit so the formatter
    // can generate proper GitHub release bodies.
    const msg =