feat(core/onboarding): support manual rebase/retry

docs/usage/self-hosted-configuration.md

@@ -511,6 +511,8 @@ Otherwise, Renovate skips onboarding a repository if it finds no dependencies in
 
 Similarly to `onboardingBranch`, if you have an existing Renovate installation and you change `onboardingPrTitle` then it's possible that you'll get onboarding PRs for repositories that had previously closed the onboarding PR unmerged.
 
+## onboardingRebaseCheckbox
+
 ## optimizeForDisabled
 
 ## password

lib/config/options/index.ts

@@ -400,6 +400,17 @@ const options: RenovateOptions[] = [
     globalOnly: true,
     mergeable: true,
   },
+  {
+    name: 'onboardingRebaseCheckbox',
+    description:
+      'Set to enable rebase/retry markdown checkbox for onboarding PRs.',
+    type: 'boolean',
+    default: false,
+    supportedPlatforms: ['github', 'gitlab', 'gitea'],
+    globalOnly: true,
+    experimental: true,
+    experimentalIssues: [17633],
+  },
   {
     name: 'includeForks',
     description:

lib/config/types.ts

@@ -142,6 +142,7 @@ export interface LegacyAdminConfig {
   onboardingBranch?: string;
   onboardingCommitMessage?: string;
   onboardingNoDeps?: boolean;
+  onboardingRebaseCheckbox?: boolean;
   onboardingPrTitle?: string;
   onboardingConfig?: RenovateSharedConfig;
   onboardingConfigFileName?: string;

lib/util/hasha.ts

@@ -0,0 +1,5 @@
+import hasha from 'hasha';
+
+export function toSha256(input: string): string {
+  return hasha(input, { algorithm: 'sha256' });
+}

lib/workers/repository/index.ts

@@ -18,8 +18,10 @@ import { ensureDependencyDashboard } from './dependency-dashboard';
 import handleError from './error';
 import { finaliseRepo } from './finalise';
 import { initRepo } from './init';
+import { OnboardingState } from './onboarding/common';
 import { ensureOnboardingPr } from './onboarding/pr';
 import { extractDependencies, updateRepo } from './process';
+import type { ExtractResult } from './process/extract-update';
 import { ProcessResult, processResult } from './result';
 import { printRequestStats } from './stats';
 
@@ -45,10 +47,13 @@ export async function renovateRepository(
     logger.debug('Using localDir: ' + localDir);
     config = await initRepo(config);
     addSplit('init');
-    const { branches, branchList, packageFiles } = await instrument(
-      'extract',
-      () => extractDependencies(config)
-    );
+    const performExtract =
+      config.repoIsOnboarded! ||
+      !config.onboardingRebaseCheckbox ||
+      OnboardingState.prUpdateRequested;
+    const { branches, branchList, packageFiles } = performExtract
+      ? await instrument('extract', () => extractDependencies(config))
+      : emptyExtract(config);
     if (
       GlobalConfig.get('dryRun') !== 'lookup' &&
       GlobalConfig.get('dryRun') !== 'extract'
@@ -63,7 +68,9 @@ export async function renovateRepository(
       );
       setMeta({ repository: config.repository });
       addSplit('update');
-      await setBranchCache(branches);
+      if (performExtract) {
+        await setBranchCache(branches); // update branch cache if performed extraction
+      }
       if (res === 'automerged') {
         if (canRetry) {
           logger.info('Renovating repository again after automerge result');
@@ -105,3 +112,12 @@ export async function renovateRepository(
   logger.info({ cloned, durationMs: splits.total }, 'Repository finished');
   return repoResult;
 }
+
+// istanbul ignore next: renovateRepository is ignored
+function emptyExtract(config: RenovateConfig): ExtractResult {
+  return {
+    branches: [],
+    branchList: [config.onboardingBranch!], // to prevent auto closing
+    packageFiles: {},
+  };
+}

lib/workers/repository/onboarding/branch/index.spec.ts

@@ -8,14 +8,17 @@ import {
   platform,
 } from '../../../../../test/util';
 import { configFileNames } from '../../../../config/app-strings';
+import { GlobalConfig } from '../../../../config/global';
 import {
   REPOSITORY_FORKED,
   REPOSITORY_NO_PACKAGE_FILES,
 } from '../../../../constants/error-messages';
 import { logger } from '../../../../logger';
 import type { Pr } from '../../../../modules/platform';
+import * as memCache from '../../../../util/cache/memory';
 import * as _cache from '../../../../util/cache/repository';
 import type { FileAddition } from '../../../../util/git/types';
+import { OnboardingState } from '../common';
 import * as _config from './config';
 import * as _rebase from './rebase';
 import { checkOnboardingBranch } from '.';
@@ -36,9 +39,11 @@ describe('workers/repository/onboarding/branch/index', () => {
     let config: RenovateConfig;
 
     beforeEach(() => {
+      memCache.init();
       jest.resetAllMocks();
       config = getConfig();
       config.repository = 'some/repo';
+      OnboardingState.prUpdateRequested = false;
       git.getFileList.mockResolvedValue([]);
       cache.getCache.mockReturnValue({});
     });
@@ -63,26 +68,36 @@ describe('workers/repository/onboarding/branch/index', () => {
       );
     });
 
-    it('has default onboarding config', async () => {
-      configModule.getOnboardingConfig.mockResolvedValue(
-        config.onboardingConfig
-      );
-      configModule.getOnboardingConfigContents.mockResolvedValue(
-        '{\n' +
-          '  "$schema": "https://docs.renovatebot.com/renovate-schema.json"\n' +
-          '}\n'
-      );
-      git.getFileList.mockResolvedValue(['package.json']);
-      fs.readLocalFile.mockResolvedValue('{}');
-      await checkOnboardingBranch(config);
-      const file = git.commitFiles.mock.calls[0][0].files[0] as FileAddition;
-      const contents = file.contents?.toString();
-      expect(contents).toBeJsonString();
-      // TODO #7154
-      expect(JSON.parse(contents!)).toEqual({
-        $schema: 'https://docs.renovatebot.com/renovate-schema.json',
-      });
-    });
+    it.each`
+      checkboxEnabled | expected
+      ${true}         | ${true}
+      ${false}        | ${false}
+    `(
+      'has default onboarding config' +
+        '(config.onboardingRebaseCheckbox="$checkboxEnabled")',
+      async ({ checkboxEnabled, expected }) => {
+        config.onboardingRebaseCheckbox = checkboxEnabled;
+        configModule.getOnboardingConfig.mockResolvedValue(
+          config.onboardingConfig
+        );
+        configModule.getOnboardingConfigContents.mockResolvedValue(
+          '{\n' +
+            '  "$schema": "https://docs.renovatebot.com/renovate-schema.json"\n' +
+            '}\n'
+        );
+        git.getFileList.mockResolvedValue(['package.json']);
+        fs.readLocalFile.mockResolvedValue('{}');
+        await checkOnboardingBranch(config);
+        const file = git.commitFiles.mock.calls[0][0].files[0] as FileAddition;
+        const contents = file.contents?.toString();
+        expect(contents).toBeJsonString();
+        // TODO #7154
+        expect(JSON.parse(contents!)).toEqual({
+          $schema: 'https://docs.renovatebot.com/renovate-schema.json',
+        });
+        expect(OnboardingState.prUpdateRequested).toBe(expected);
+      }
+    );
 
     it('uses discovered onboarding config', async () => {
       configModule.getOnboardingConfig.mockResolvedValue({
@@ -244,5 +259,71 @@ describe('workers/repository/onboarding/branch/index', () => {
       expect(git.checkoutBranch).toHaveBeenCalledTimes(1);
       expect(git.commitFiles).toHaveBeenCalledTimes(0);
     });
+
+    describe('tests onboarding rebase/retry checkbox handling', () => {
+      beforeEach(() => {
+        GlobalConfig.set({ platform: 'github' });
+        config.onboardingRebaseCheckbox = true;
+        OnboardingState.prUpdateRequested = false;
+        git.getFileList.mockResolvedValueOnce(['package.json']);
+        platform.findPr.mockResolvedValueOnce(null);
+        rebase.rebaseOnboardingBranch.mockResolvedValueOnce(null);
+      });
+
+      it('detects unsupported platfom', async () => {
+        const pl = 'bitbucket';
+        GlobalConfig.set({ platform: pl });
+        platform.getBranchPr.mockResolvedValueOnce(mock<Pr>({}));
+
+        await checkOnboardingBranch(config);
+
+        expect(logger.trace).toHaveBeenCalledWith(
+          `Platform '${pl}' does not support extended markdown`
+        );
+        expect(OnboardingState.prUpdateRequested).toBeTrue();
+        expect(git.checkoutBranch).toHaveBeenCalledTimes(1);
+        expect(git.commitFiles).toHaveBeenCalledTimes(0);
+      });
+
+      it('detects missing rebase checkbox', async () => {
+        const pr = { bodyStruct: { rebaseRequested: undefined } };
+        platform.getBranchPr.mockResolvedValueOnce(mock<Pr>(pr));
+
+        await checkOnboardingBranch(config);
+
+        expect(logger.debug).toHaveBeenCalledWith(
+          `No rebase checkbox was found in the onboarding PR`
+        );
+        expect(OnboardingState.prUpdateRequested).toBeTrue();
+        expect(git.checkoutBranch).toHaveBeenCalledTimes(1);
+        expect(git.commitFiles).toHaveBeenCalledTimes(0);
+      });
+
+      it('detects manual pr update requested', async () => {
+        const pr = { bodyStruct: { rebaseRequested: true } };
+        platform.getBranchPr.mockResolvedValueOnce(mock<Pr>(pr));
+
+        await checkOnboardingBranch(config);
+
+        expect(logger.debug).toHaveBeenCalledWith(
+          `Manual onboarding PR update requested`
+        );
+        expect(OnboardingState.prUpdateRequested).toBeTrue();
+        ``;
+        expect(git.checkoutBranch).toHaveBeenCalledTimes(1);
+        expect(git.commitFiles).toHaveBeenCalledTimes(0);
+      });
+
+      it('handles unchecked rebase checkbox', async () => {
+        const pr = { bodyStruct: { rebaseRequested: false } };
+        platform.getBranchPr.mockResolvedValueOnce(mock<Pr>(pr));
+
+        await checkOnboardingBranch(config);
+
+        expect(OnboardingState.prUpdateRequested).toBeFalse();
+        expect(git.checkoutBranch).toHaveBeenCalledTimes(1);
+        expect(git.commitFiles).toHaveBeenCalledTimes(0);
+      });
+    });
   });
 });

lib/workers/repository/onboarding/branch/index.ts

@@ -1,3 +1,4 @@
+import is from '@sindresorhus/is';
 import { mergeChildConfig } from '../../../../config';
 import { GlobalConfig } from '../../../../config/global';
 import type { RenovateConfig } from '../../../../config/types';
@@ -6,10 +7,11 @@ import {
   REPOSITORY_NO_PACKAGE_FILES,
 } from '../../../../constants/error-messages';
 import { logger } from '../../../../logger';
-import { platform } from '../../../../modules/platform';
+import { Pr, platform } from '../../../../modules/platform';
 import { checkoutBranch, setGitAuthor } from '../../../../util/git';
 import { extractAllDependencies } from '../../extract';
 import { mergeRenovateConfig } from '../../init/merge';
+import { OnboardingState } from '../common';
 import { getOnboardingPr, isOnboarded } from './check';
 import { getOnboardingConfig } from './config';
 import { createOnboardingBranch } from './create';
@@ -34,8 +36,12 @@ export async function checkOnboardingBranch(
   setGitAuthor(config.gitAuthor);
   const onboardingPr = await getOnboardingPr(config);
   if (onboardingPr) {
+    if (config.onboardingRebaseCheckbox) {
+      handleOnboardingManualRebase(onboardingPr);
+    }
     logger.debug('Onboarding PR already exists');
-    const commit = await rebaseOnboardingBranch(config);
+    const { rawConfigHash } = onboardingPr.bodyStruct ?? {};
+    const commit = await rebaseOnboardingBranch(config, rawConfigHash);
     if (commit) {
       logger.info(
         { branch: config.onboardingBranch, commit, onboarding: true },
@@ -44,7 +50,6 @@ export async function checkOnboardingBranch(
     }
     // istanbul ignore if
     if (platform.refreshPr) {
-      // TODO #7154
       await platform.refreshPr(onboardingPr.number);
     }
   } else {
@@ -62,6 +67,9 @@ export async function checkOnboardingBranch(
       }
     }
     logger.debug('Need to create onboarding PR');
+    if (config.onboardingRebaseCheckbox) {
+      OnboardingState.prUpdateRequested = true;
+    }
     const commit = await createOnboardingBranch(mergedConfig);
     // istanbul ignore if
     if (commit) {
@@ -80,3 +88,18 @@ export async function checkOnboardingBranch(
   const branchList = [onboardingBranch!];
   return { ...config, repoIsOnboarded, onboardingBranch, branchList };
 }
+
+function handleOnboardingManualRebase(onboardingPr: Pr): void {
+  const pl = GlobalConfig.get('platform')!;
+  const { rebaseRequested } = onboardingPr.bodyStruct ?? {};
+  if (!['github', 'gitlab', 'gitea'].includes(pl)) {
+    logger.trace(`Platform '${pl}' does not support extended markdown`);
+    OnboardingState.prUpdateRequested = true;
+  } else if (is.nullOrUndefined(rebaseRequested)) {
+    logger.debug('No rebase checkbox was found in the onboarding PR');
+    OnboardingState.prUpdateRequested = true;
+  } else if (rebaseRequested) {
+    logger.debug('Manual onboarding PR update requested');
+    OnboardingState.prUpdateRequested = true;
+  }
+}