feat(packageRules): add merge confidence matcher

docs/usage/configuration-options.md

@@ -2135,6 +2135,38 @@ For example to apply a special label for Major updates:
 }
 ```
 
+### matchConfidence
+
+<!-- prettier-ignore -->
+!!! warning
+This configuration option is dependent on an API key, therefore it is effectively disabled if none is set.
+
+For example to group high merge confidence updates:
+
+```json
+{
+  "packageRules": [
+    {
+      "matchConfidence": ["high", "very high"],
+      "groupName": "high merge confidence"
+    }
+  ]
+}
+```
+
+This feature requires an API token. Set it via Host rules under the `merge-confidence` HostType:
+
+```json
+{
+  "hostRules": [
+    {
+      "hostType": "merge-confidence",
+      "token": "********"
+    }
+  ]
+}
+```
+
 ### customChangelogUrl
 
 Use this field to set the source URL for a package, including overriding an existing one.

docs/usage/self-hosted-experimental.md

@@ -76,6 +76,10 @@ When using `matchPackageNames` and `matchPackagePatterns` matchers:
 1. Renovate first tries to match against `depName`
 2. If `depName` doesn't match then Renovate tries to match against `packageName`
 
+## `RENOVATE_X_MERGE_CONFIDENCE_API_BASE_URL`
+
+If set, Renovate will query this api for Merge Confidence data.
+
 ## `RENOVATE_X_AUTODISCOVER_REPO_SORT`
 
 <!-- prettier-ignore -->

lib/config/options/index.ts

@@ -1224,6 +1224,21 @@ const options: RenovateOptions[] = [
     cli: false,
     env: false,
   },
+  {
+    name: 'matchConfidence',
+    description:
+      'Merge confidence levels to match against (`low`, `neutral`, `high`, `very high`). Valid only within `packageRules` object.',
+    type: 'array',
+    subType: 'string',
+    allowedValues: ['low', 'neutral', 'high', 'very high'],
+    allowString: true,
+    stage: 'package',
+    parent: 'packageRules',
+    mergeable: true,
+    cli: false,
+    env: false,
+    experimental: true,
+  },
   {
     name: 'matchUpdateTypes',
     description:

lib/config/types.ts

@@ -2,6 +2,7 @@ import type { LogLevel } from 'bunyan';
 import type { PlatformId } from '../constants';
 import type { HostRule } from '../types';
 import type { GitNoVerifyOption } from '../util/git/types';
+import type { MergeConfidence } from '../util/merge-confidence';
 
 export type RenovateConfigStage =
   | 'global'
@@ -328,6 +329,7 @@ export interface PackageRule
   matchSourceUrlPrefixes?: string[];
   matchSourceUrls?: string[];
   matchUpdateTypes?: UpdateType[];
+  matchConfidence?: MergeConfidence[];
   registryUrls?: string[] | null;
 }
 
@@ -458,6 +460,7 @@ export interface PackageRuleInputConfig extends Record<string, unknown> {
   currentVersion?: string;
   lockedVersion?: string;
   updateType?: UpdateType;
+  mergeConfidenceLevel?: MergeConfidence;
   isBump?: boolean;
   sourceUrl?: string | null;
   language?: string;

lib/config/validation.ts

@@ -333,6 +333,7 @@ export async function validateConfig(
               'matchSourceUrlPrefixes',
               'matchSourceUrls',
               'matchUpdateTypes',
+              'matchConfidence',
             ];
             if (key === 'packageRules') {
               for (const [subIndex, packageRule] of val.entries()) {

lib/modules/manager/types.ts

@@ -8,6 +8,7 @@ import type {
 import type { ProgrammingLanguage } from '../../constants';
 import type { ModuleApi, RangeStrategy, SkipReason } from '../../types';
 import type { FileChange } from '../../util/git/types';
+import type { MergeConfidence } from '../../util/merge-confidence';
 
 export type Result<T> = T | Promise<T>;
 
@@ -94,6 +95,7 @@ export interface LookupUpdate {
   pendingVersions?: string[];
   newVersion?: string;
   updateType?: UpdateType;
+  mergeConfidenceLevel?: MergeConfidence;
   userStrings?: Record<string, string>;
   checksumUrl?: string;
   downloadUrl?: string;