Function setupApp

packages/bumpy/src/commands/ci-setup.ts:119–175

(rootDir: string, repo: string, pm: PackageManager)

// ---- GitHub App flow ----

async function setupApp(rootDir: string, repo: string, pm: PackageManager): Promise<void> {
  const owner = repo.split('/')[0]!;
  const appUrl = `https://github.com/organizations/${owner}/settings/apps/new`;
  const personalAppUrl = `https://github.com/settings/apps/new`;

  const isOrg = unwrap(await p.confirm({ message: `Is ${pc.cyan(owner)} a GitHub organization?`, initialValue: true }));

  const createUrl = isOrg ? appUrl : personalAppUrl;

  p.log.info('');
  p.note(
    [
      'If you already have a GitHub App, skip to step 2.',
      '',
      pc.bold('Step 1: Create a GitHub App'),
      '',
      `1. Open: ${pc.cyan(createUrl)}`,
      `2. Set the name, e.g. ${pc.dim(`"${owner}-bumpy-ci"`)}`,
      '3. Uncheck "Active" under Webhooks (not needed)',
      '4. Under Permissions → Repository permissions, grant:',
      ...PAT_PERMISSIONS.map((perm) => `   • ${pc.bold(perm)}`),
      '5. Under "Where can this app be installed?" select "Only on this account"',
      '6. Click "Create GitHub App"',
      '7. Note the App ID shown on the settings page',
      '8. Generate a private key and download the .pem file',
      '',
      pc.bold('Step 2: Install the App'),
      '',
      `Install the app on ${pc.cyan(repo)} from the app's "Install App" tab.`,
      '',
      pc.bold('Step 3: Add secrets'),
      '',
      "You'll need to add two repository secrets:",
      `  • ${pc.bold('BUMPY_APP_ID')} — the App ID`,
      `  • ${pc.bold('BUMPY_APP_PRIVATE_KEY')} — contents of the .pem file`,
    ].join('\n'),
    'GitHub App setup',
  );

  const shouldOpen = unwrap(await p.confirm({ message: 'Open the app creation page in your browser?' }));
  if (shouldOpen) {
    openBrowser(createUrl);
  }

  const hasSecrets = unwrap(
    await p.confirm({ message: 'Have you added the BUMPY_APP_ID and BUMPY_APP_PRIVATE_KEY secrets?' }),
  );

  if (hasSecrets) {
    printAppWorkflowSnippet(pm);
  } else {
    p.log.info('You can add them later. Once ready, update your release workflow:');
    printAppWorkflowSnippet(pm);
  }

  p.outro(pc.green('GitHub App setup complete!'));
}