chore: add utility to identify deprecated rules

This has been useful to catch a few improperly deprecated rules like:

* jsx-eslint/eslint-plugin-jsx-a11y#825
* eslint/eslint#15292

Author: gajus

compare/find-deprecated.js

@@ -0,0 +1,38 @@
+/* eslint-disable import/no-extraneous-dependencies */
+/* eslint-disable no-console */
+
+/**
+ * https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/issues/825
+ * https://github.com/eslint/eslint/issues/15292
+ */
+
+const got = require('got');
+const {
+  getLoadedRules,
+} = require('./utilities');
+
+(async () => {
+  const loadedRules = await getLoadedRules();
+
+  const ruleNames = Object.keys(loadedRules);
+
+  for (const ruleName of ruleNames) {
+    if (loadedRules[ruleName]?.meta?.deprecated) {
+      continue;
+    }
+
+    const ruleDocumentationUrl = loadedRules[ruleName]?.meta?.docs?.url;
+
+    if (!ruleDocumentationUrl) {
+      continue;
+    }
+
+    const response = await got(ruleDocumentationUrl, {
+      resolveBodyOnly: true,
+    });
+
+    if (response.toLowerCase().includes('deprecated')) {
+      console.warn('⚠️  ' + ruleName + ' suspected improperly deprecated rule (' + ruleDocumentationUrl + ')');
+    }
+  }
+})();

package.json

@@ -52,6 +52,7 @@
     "@babel/register": "^7.16.0",
     "ava": "^3.15.0",
     "eslint": "^8.2.0",
+    "got": "^11.8.2",
     "husky": "^7.0.4",
     "jsonlint": "^1.6.3",
     "semantic-release": "^18.0.0"
@@ -76,6 +77,7 @@
   },
   "scripts": {
     "compare": "(cd compare; node compare.js)",
+    "find-deprecated": "(cd compare; node find-deprecated.js)",
     "format": "jsonlint --sort-keys --in-place --indent '  ' ./configurations/eslintrc.json && echo '' >> ./configurations/eslintrc.json && jsonlint --sort-keys --in-place --indent '  ' ./configurations/lodash.json && echo '' >> ./configurations/lodash.json && jsonlint --sort-keys --in-place --indent '  ' ./configurations/flowtype.json && echo '' >> ./configurations/flowtype.json",
     "generate-typescript-compatibility-rules": "node bin/generate-typescript-compatibility-rules.js > configurations/typescript-compatibility.json",
     "lint": "eslint --report-unused-disable-directives .",