feat(presets): Package abandonment preset (#36210)

Author: zharinov

docs/usage/key-concepts/dashboard.md

@@ -66,6 +66,24 @@ Here is an example of how this can look:
 | npm        | `airbnb-prop-types` | ![Available](https://img.shields.io/badge/available-green?style=flat-square)      |
 | npm        | `left-pad`          | ![Unavailable](https://img.shields.io/badge/unavailable-orange?style=flat-square) |
 
+#### Abandonment detection
+
+Renovate includes the `abandonments:recommended` preset (automatically included in `config:best-practices`) to help identify potentially abandoned packages. This preset:
+
+- Sets a default [`abandonmentThreshold`](../configuration-options.md#abandonmentthreshold) of `1 year` for all packages
+- Includes community-sourced overrides for packages that appear abandoned but are still maintained
+- Prevents updates to truly abandoned packages while allowing updates to packages with irregular release schedules
+
+**Usage:**
+
+```json
+{
+  "extends": ["abandonments:recommended"]
+}
+```
+
+You can contribute additional overrides by updating the [`abandonments.json`](https://github.com/renovatebot/renovate/blob/main/lib/data/abandonments.json) file.
+
 ### Visibility into rejected/deferred updates
 
 Renovate's Dependency Dashboard shows an overview of all updates that are still "to do".

lib/config/presets/internal/abandonments.ts

@@ -0,0 +1,35 @@
+import data from '../../../data/abandonments.json';
+import type { PackageRule } from '../../types';
+import type { Preset } from '../types';
+
+function loadAbandonmentPresets(): Record<string, Preset> {
+  const packageRules: PackageRule[] = [
+    {
+      matchPackageNames: ['*'],
+      abandonmentThreshold: '1 year',
+    },
+  ];
+
+  for (const [datasource, datasourceAbandonments] of Object.entries(data)) {
+    if (datasource === '$schema') {
+      continue;
+    }
+
+    for (const [packageName, threshold] of Object.entries(
+      datasourceAbandonments,
+    )) {
+      const abandonmentThreshold = threshold === 'eternal' ? null : threshold;
+      packageRules.push({
+        matchDatasources: [datasource],
+        matchPackageNames: [packageName],
+        abandonmentThreshold,
+      });
+    }
+  }
+
+  return {
+    recommended: { packageRules },
+  };
+}
+
+export const presets: Record<string, Preset> = loadAbandonmentPresets();

lib/config/presets/internal/config.ts

@@ -12,6 +12,7 @@ export const presets: Record<string, Preset> = {
       'helpers:pinGitHubActionDigests',
       ':configMigration',
       ':pinDevDependencies',
+      'abandonments:recommended',
     ],
   },
   'js-app': {

lib/config/presets/internal/index.ts

@@ -1,4 +1,5 @@
 import type { Preset, PresetConfig } from '../types';
+import * as configAbandonments from './abandonments';
 import * as configPreset from './config';
 import * as customManagersPreset from './custom-managers';
 import * as defaultPreset from './default';
@@ -19,6 +20,7 @@ import * as workaroundsPreset from './workarounds';
 /* eslint sort-keys: ["error", "asc", {caseSensitive: false, natural: true}] */
 
 export const groups: Record<string, Record<string, Preset>> = {
+  abandonments: configAbandonments.presets,
   config: configPreset.presets,
   customManagers: customManagersPreset.presets,
   default: defaultPreset.presets,

lib/config/presets/parse.ts

@@ -53,6 +53,7 @@ export function parsePreset(input: string): ParsedPreset {
     return { presetSource, repo: str, presetName: '', params };
   }
   const presetsPackages = [
+    'abandonments',
     'compatibility',
     'config',
     'customManagers',

lib/data/abandonments.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "../../tools/schemas/abandonments-schema.json",
+  "npm": {
+    "@types/*": "eternal",
+    "lodash": "6 years"
+  }
+}

tools/schemas/abandonments-schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Exceptions for abandoned packages",
+  "description": "Community-sourced overrides for packages that appear abandoned but are still maintained",
+  "type": "object",
+  "properties": {
+    "$schema": { "type": "string" }
+  },
+  "additionalProperties": {
+    "type": "object",
+    "additionalProperties": {
+      "type": "string"
+    }
+  }
+}

tools/schemas/schema.ts

@@ -65,3 +65,9 @@ export const SourceUrlsSchema = z
     $schema: z.string(),
   })
   .catchall(z.record(z.string(), z.string().url()));
+
+export const AbandonmentsSchema = z
+  .object({
+    $schema: z.string(),
+  })
+  .catchall(z.record(z.string(), z.string()));