Function createChannelReleasePr

packages/bumpy/src/commands/ci.ts:1053–1164

* Create or update the channel's release PR. Unlike the stable version PR, its diff * is pure file moves (pending bump files → `.bumpy/ /`) — no versions, no * changelogs. The PR title/body show targets with a wildcard counter (`1.2.0-rc.x`), * derived purely from committed state; the exa

(
  rootDir: string,
  config: BumpyConfig,
  channel: ResolvedChannel,
  packages: Map<string, import('../types.ts').WorkspacePackage>,
  branchOverride?: string,
)

 * derived purely from committed state; the exact counter is assigned at publish time.
 */
async function createChannelReleasePr(
  rootDir: string,
  config: BumpyConfig,
  channel: ResolvedChannel,
  packages: Map<string, import('../types.ts').WorkspacePackage>,
  branchOverride?: string,
): Promise<void> {
  const branch = validateBranchName(branchOverride || channel.versionPr.branch);
  const baseBranch = validateBranchName(channel.branch);

  // Check if a release PR already exists
  const existingPr = tryRunArgs(['gh', 'pr', 'list', '--head', branch, '--json', 'number', '--jq', '.[0].number'], {
    cwd: rootDir,
  });

  log.step(`Creating branch ${branch}...`);
  const branchExists = tryRunArgs(['git', 'rev-parse', '--verify', branch], { cwd: rootDir }) !== null;
  if (branchExists) {
    runArgs(['git', 'checkout', branch], { cwd: rootDir });
    runArgs(['git', 'reset', '--hard', baseBranch], { cwd: rootDir });
  } else {
    runArgs(['git', 'checkout', '-b', branch], { cwd: rootDir });
  }

  // Move pending bump files into the channel dir (the entire "version" step for a channel)
  const { channelVersion } = await import('./version.ts');
  const result = await channelVersion(rootDir, config, channel);
  if (!result) {
    log.info('No pending bump files to move.');
    runArgs(['git', 'checkout', baseBranch], { cwd: rootDir });
    return;
  }

  // Versions shown in the PR title/body/commit message are deterministic: targets
  // come from committed bump files; the counter is a wildcard (`-rc.x`) because the
  // real one is derived from the registry at publish time and could drift by merge.
  const displayPlan = channelDisplayPlan(result.cyclePlan, channel, packages);

  const versionSummary = formatChannelVersionSummary(displayPlan.releases);
  const prTitle = versionSummary ? `${channel.versionPr.title}: ${versionSummary}` : channel.versionPr.title;

  // Commit the moves — the version summary lives in the commit message, so
  // `git log` on the channel branch reads as a release history
  runArgs(['git', 'add', '-A', '.bumpy/'], { cwd: rootDir });
  const status = tryRunArgs(['git', 'status', '--porcelain'], { cwd: rootDir });
  if (!status) {
    log.info('No changes to commit.');
    runArgs(['git', 'checkout', baseBranch], { cwd: rootDir });
    return;
  }
  const commitMsg = `${prTitle}\n\nShipped: ${result.movedFiles.map((bf) => `${bf.id}.md`).join(', ')}`;
  runArgs(['git', 'commit', '-F', '-'], { cwd: rootDir, input: commitMsg });

  pushWithToken(rootDir, branch, config);

  const repo = process.env.GITHUB_REPOSITORY;
  const noPatWarning = !process.env.BUMPY_GH_TOKEN && !!repo;
  const packageDirs = new Map([...packages.values()].map((p) => [p.name, p.relativeDir]));