Function ciCheckCommand

packages/bumpy/src/commands/ci.ts:118–286

(rootDir: string, opts: CheckOptions)

 * Designed for PR workflows — shows what would be released and optionally comments on the PR.
 */
export async function ciCheckCommand(rootDir: string, opts: CheckOptions): Promise<void> {
  // Seed an empty artifact first so it always exists for the workflow_run poster,
  // regardless of which branch below we return from.
  if (opts.emitComment) initCommentArtifact(opts.emitComment);

  const config = await loadConfig(rootDir);
  const { packages } = await discoverWorkspace(rootDir, config);
  const depGraph = new DependencyGraph(packages);
  // Read channel dirs too: on promotion (channel → main) and graduation (channel →
  // channel) PRs, the pending bump files live in `.bumpy/<channel>/`. Feature PRs
  // never have shipped channel files in their diff vs the PR base, so this only
  // surfaces files where they're genuinely pending.
  const { bumpFiles: allBumpFiles, errors: parseErrors } = await readBumpFiles(rootDir, {
    channels: channelNames(config),
  });

  // Skip on the version PR branch (and channel release PR branches) — they move/consume
  // bump files by design
  const prBranchName = detectPrBranch(rootDir);
  const channels = resolveChannels(config);
  const releasePrBranches = new Set([
    config.versionPr.branch,
    ...[...channels.values()].map((c) => c.versionPr.branch),
  ]);
  if (prBranchName && releasePrBranches.has(prBranchName)) {
    log.dim('  Skipping — this is a release PR branch.');
    return;
  }

  const inCI = !!process.env.CI;
  const shouldComment = opts.comment ?? inCI;
  const prNumber = detectPrNumber();
  const pm = await detectPackageManager(rootDir);

  // Filter to only bump files added/modified in this PR.
  // For PRs targeting a channel branch, compare against that branch (GITHUB_BASE_REF),
  // not baseBranch — otherwise the whole cycle's changes would show up.
  const compareBranch = process.env.GITHUB_BASE_REF || config.baseBranch;
  // If this PR targets a channel branch, the comment makes that explicit (prerelease,
  // dist-tag) rather than implying a normal stable release.
  const prChannel = matchChannelByBranch(config, process.env.GITHUB_BASE_REF || null);
  const changedFiles = getChangedFiles(rootDir, compareBranch);
  const { branchBumpFiles: prBumpFiles, emptyBumpFileIds } = filterBranchBumpFiles(
    allBumpFiles,
    changedFiles,
    rootDir,
    parseErrors,
  );

  // Surface any parse errors
  if (parseErrors.length > 0) {
    for (const err of parseErrors) {
      log.error(err);
    }
  }

  if (prBumpFiles.length === 0) {
    // An empty bump file signals intentionally no releases needed