Function ciReleaseCommand

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

(rootDir: string, opts: ReleaseOptions)

  if (pkgConfig.publishCommand) {
    targets.push({ type: 'custom' });
  }
  if (!pkgConfig.publishCommand && !pkgConfig.skipNpmPublish) {
    targets.push({ type: 'npm' });
  }
  return targets;
}

/** Write a key=value pair to $GITHUB_OUTPUT if available */
function writeGitHubOutput(key: string, value: string): void {
  const outputFile = process.env.GITHUB_OUTPUT;
  if (!outputFile) return;
  // Use delimiter protocol for multiline values
  const delimiter = `ghadelimiter_${Date.now()}`;
  appendFileSync(outputFile, `${key}<<${delimiter}\n${value}\n${delimiter}\n`);
}

// ---- ci release ----

interface ReleaseOptions {
  autoPublish?: boolean; // skip the version-PR step and version+publish in one shot
  assertMode?: 'version-pr' | 'publish'; // refuse to run if detected mode doesn't match — see CiPlanMode
  tag?: string; // npm dist-tag for auto-publish (or the snapshot dist-tag)
  branch?: string; // branch name for version PR (default: "bumpy/version-packages")
  snapshot?: string; // publish a transient snapshot under this name + comment install instructions on the PR
}

/**
 * CI release: either create a version PR (bump files present) or publish unpublished
 * packages (no bump files — i.e. a version PR was just merged). Pass `autoPublish` to
 * collapse both steps into a single push-to-main, or `assertMode` to refuse running
 * 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.',
    );
  }