@backstage/cli 0.36.0-next.1 → 0.36.0

package/CHANGELOG.md

@@ -1,5 +1,115 @@
 # @backstage/cli
 
+## 0.36.0
+
+### Minor Changes
+
+- d0f4cd2: Added new `auth` command group for authenticating the CLI with Backstage instances using OAuth 2.0 with a pre-registered client metadata document. Commands include `login`, `logout`, `list`, `show`, `print-token`, and `select` for managing multiple authenticated instances.
+- d806b0c: The CLI now automatically discovers CLI modules from the project root's `dependencies` and `devDependencies`. Any installed package with the `cli-module` Backstage role will be loaded automatically without needing to be hardcoded in the CLI itself.
+
+  If no CLI modules are found in the project dependencies, the CLI falls back to the built-in set of modules and prints a deprecation warning. This fallback will be removed in a future release. To prepare for this, add `@backstage/cli-defaults` as a `devDependency` in your root `package.json`:
+
+  ```json
+  {
+    "devDependencies": {
+      "@backstage/cli-defaults": "backstage:^"
+    }
+  }
+  ```
+
+  If you are not using the Backstage Yarn plugin, run the following instead:
+
+  ```sh
+  yarn workspace root add --dev @backstage/cli-defaults
+  ```
+
+  For fine-grained control you can instead install individual CLI modules:
+
+  ```json
+  {
+    "devDependencies": {
+      "@backstage/cli-module-auth": "backstage:^",
+      "@backstage/cli-module-build": "backstage:^",
+      "@backstage/cli-module-config": "backstage:^",
+      "@backstage/cli-module-github": "backstage:^",
+      "@backstage/cli-module-info": "backstage:^",
+      "@backstage/cli-module-lint": "backstage:^",
+      "@backstage/cli-module-maintenance": "backstage:^",
+      "@backstage/cli-module-migrate": "backstage:^",
+      "@backstage/cli-module-new": "backstage:^",
+      "@backstage/cli-module-test-jest": "backstage:^",
+      "@backstage/cli-module-translations": "backstage:^"
+    }
+  }
+  ```
+
+- 08d9770: **BREAKING**: The CLI templates for frontend plugins have been renamed:
+
+  - `new-frontend-plugin` → `frontend-plugin`
+  - `new-frontend-plugin-module` → `frontend-plugin-module`
+  - `frontend-plugin` (legacy) → `legacy-frontend-plugin`
+
+  To smooth out this breaking change, the CLI now auto-detects which frontend system your app uses based on the dependencies in `packages/app/package.json`. When using the default templates (no explicit `templates` configuration):
+
+  - Apps using `@backstage/frontend-defaults` will see the new frontend system templates (`frontend-plugin`, `frontend-plugin-module`)
+  - Apps using `@backstage/app-defaults` will see the legacy template (displayed as `frontend-plugin`)
+
+  This means existing projects that haven't migrated to the new frontend system will continue to create legacy plugins by default, while new projects will get the new frontend system templates. If you have explicit template configuration in your `package.json`, it will be used as-is without any auto-detection.
+
+- b36a60d: **BREAKING**: The `migrate package-exports` command has been removed. Use `repo fix` instead.
+
+### Patch Changes
+
+- edf2b77: Added a new `cli-module` template for creating CLI module packages.
+- 246877a: Updated dependency `bfj` to `^9.0.2`.
+- 0d2d0f2: Internal refactor of CLI modularization, moving individual commands to be implemented with cleye.
+- a4e5902: Internal refactor of the CLI command registration
+- bba2e49: Internal refactor to use new concurrency utilities from `@backstage/cli-node`.
+- 2fcba39: Internal refactor to move shared utilities into their consuming modules, reducing cross-module dependencies.
+- c85ac86: Internal refactor to split `loadCliConfig` into separate implementations for the build and config CLI modules, removing a cross-module dependency.
+- 94a885a: Added support for the new `cli-module` package role in the build system, ESLint configuration, Jest configuration, and maintenance commands.
+- fd50cb3: Added `translations export` and `translations import` commands for managing translation files.
+
+  The `translations export` command discovers all `TranslationRef` definitions across frontend plugin dependencies and exports their default messages as JSON files. The `translations import` command generates `TranslationResource` wiring code from translated JSON files, ready to be plugged into the app.
+
+  Both commands support a `--pattern` option for controlling the message file layout, for example `--pattern '{lang}/{id}.json'` for language-based directory grouping.
+
+- 0be3eab: Migrated CLI plugin modules to use `createCliModule` from `@backstage/cli-node`.
+- 61cb976: Migrated internal versioning utilities to use `@backstage/cli-node` instead of a local implementation.
+- 6738cf0: build(deps): bump `minimatch` from 9.0.5 to 10.2.1
+- ff4a45a: Migrated remaining CLI command handlers from `commander` to `cleye` for argument parsing. Several camelCase CLI flags have been deprecated in favor of their kebab-case equivalents (e.g. `--successCache` → `--success-cache`). The old camelCase forms still work but will now log a deprecation warning. Please update any scripts or CI configurations to use the kebab-case versions.
+- 70fc178: Migrated from deprecated `findPaths` to `targetPaths` and `findOwnPaths` from `@backstage/cli-common`.
+- 825c81d: Internal refactor of CLI command modules.
+- ea90ab0: The built-in `yarn new` templates have been moved to `@backstage/cli-module-new`. Existing references to `@backstage/cli/templates/*` in your root `package.json` will continue to work through a backwards compatibility rewrite in the `new` command.
+- ebeb0d4: Updated the new frontend plugin template to use `@backstage/frontend-dev-utils` in its `dev/` entry point instead of wiring `createApp` manually. Generated plugins now get the same dev app helper setup as the built-in examples.
+- 971cc94: The `new` command now prompts for the plugin package name when creating plugin modules, in order to properly populate the `package.json` file.
+- de62a9d: Upgraded `commander` dependency from `^12.0.0` to `^14.0.3` across all CLI packages.
+- 092b41f: Updated dependency `webpack` to `~5.105.0`.
+- 4a75544: Updated dependency `react-refresh` to `^0.18.0`.
+- a9d23c4: Properly support `package.json` `workspaces` field
+- Updated dependencies
+  - @backstage/cli-node@0.3.0
+  - @backstage/cli-common@0.2.0
+  - @backstage/cli-defaults@0.1.0
+  - @backstage/cli-module-build@0.1.0
+  - @backstage/eslint-plugin@0.2.2
+  - @backstage/cli-module-test-jest@0.1.0
+
+## 0.36.0-next.2
+
+### Minor Changes
+
+- d0f4cd2: Added new `auth` command group for authenticating the CLI with Backstage instances using OAuth 2.0 with a pre-registered client metadata document. Commands include `login`, `logout`, `list`, `show`, `print-token`, and `select` for managing multiple authenticated instances.
+
+### Patch Changes
+
+- a4e5902: Internal refactor of the CLI command registration
+- ff4a45a: Migrated remaining CLI command handlers from `commander` to `cleye` for argument parsing. Several camelCase CLI flags have been deprecated in favor of their kebab-case equivalents (e.g. `--successCache` → `--success-cache`). The old camelCase forms still work but will now log a deprecation warning. Please update any scripts or CI configurations to use the kebab-case versions.
+- 4a75544: Updated dependency `react-refresh` to `^0.18.0`.
+- Updated dependencies
+  - @backstage/cli-common@0.2.0-next.2
+  - @backstage/integration@2.0.0-next.2
+
 ## 0.36.0-next.1
 
 ### Minor Changes

package/config/eslint-factory.js

@@ -269,6 +269,7 @@ function createConfigForRole(dir, role, extraConfig = {}) {
       });
 
     case 'cli':
+    case 'cli-module':
     case 'node-library':
     case 'backend':
     case 'backend-plugin':

package/config/getJestEnvironment.js

@@ -14,36 +14,14 @@
  * limitations under the License.
  */
 
-function getJestMajorVersion() {
-  const jestVersion = require('jest/package.json').version;
-  const majorVersion = parseInt(jestVersion.split('.')[0], 10);
-  return majorVersion;
-}
-
-function getJestEnvironment() {
-  const majorVersion = getJestMajorVersion();
-
-  if (majorVersion >= 30) {
-    try {
-      require.resolve('@jest/environment-jsdom-abstract');
-      require.resolve('jsdom');
-    } catch {
-      throw new Error(
-        'Jest 30+ requires @jest/environment-jsdom-abstract and jsdom. ' +
-          'Please install them as dev dependencies.',
-      );
-    }
-    return require.resolve('./jest-environment-jsdom');
-  }
-  try {
-    require.resolve('jest-environment-jsdom');
-  } catch {
+try {
+  module.exports = require('@backstage/cli-module-test-jest/config/getJestEnvironment');
+} catch (e) {
+  if (e.code === 'MODULE_NOT_FOUND') {
     throw new Error(
-      'Jest 29 requires jest-environment-jsdom. ' +
-        'Please install it as a dev dependency.',
+      '@backstage/cli-module-test-jest is required to use the jest environment configuration. ' +
+        'Please install it as a dependency.',
     );
   }
-  return require.resolve('jest-environment-jsdom');
+  throw e;
 }
-
-module.exports = { getJestMajorVersion, getJestEnvironment };

package/config/jest-environment-jsdom/index.js

@@ -14,48 +14,14 @@
  * limitations under the License.
  */
 
-const JSDOMEnvironment = require('@jest/environment-jsdom-abstract').default;
-const jsdom = require('jsdom');
-
-/**
- * A custom JSDOM environment that extends the abstract base and applies
- * fixes for Web API globals that are missing or incorrectly implemented
- * in JSDOM.
- *
- * Based on https://github.com/mswjs/jest-fixed-jsdom
- */
-class FixedJSDOMEnvironment extends JSDOMEnvironment {
-  constructor(config, context) {
-    super(config, context, jsdom);
-
-    // Fix Web API globals that JSDOM doesn't properly expose
-    this.global.TextDecoder = TextDecoder;
-    this.global.TextEncoder = TextEncoder;
-    this.global.TextDecoderStream = TextDecoderStream;
-    this.global.TextEncoderStream = TextEncoderStream;
-    this.global.ReadableStream = ReadableStream;
-
-    this.global.Blob = Blob;
-    this.global.Headers = Headers;
-    this.global.FormData = FormData;
-    this.global.Request = Request;
-    this.global.Response = Response;
-    this.global.fetch = fetch;
-    this.global.AbortController = AbortController;
-    this.global.AbortSignal = AbortSignal;
-    this.global.structuredClone = structuredClone;
-    this.global.URL = URL;
-    this.global.URLSearchParams = URLSearchParams;
-
-    this.global.BroadcastChannel = BroadcastChannel;
-    this.global.TransformStream = TransformStream;
-    this.global.WritableStream = WritableStream;
-
-    // Needed to ensure `e instanceof Error` works as expected with errors thrown from
-    // any of the native APIs above. Without this, the JSDOM `Error` is what the test
-    // code will use for comparison with `e`, which fails the instanceof check.
-    this.global.Error = Error;
+try {
+  module.exports = require('@backstage/cli-module-test-jest/config/jest-environment-jsdom');
+} catch (e) {
+  if (e.code === 'MODULE_NOT_FOUND') {
+    throw new Error(
+      '@backstage/cli-module-test-jest is required to use the jest JSDOM environment. ' +
+        'Please install it as a dependency.',
+    );
   }
+  throw e;
 }
-
-module.exports = FixedJSDOMEnvironment;

package/config/jest.js

@@ -14,408 +14,14 @@
  * limitations under the License.
  */
 
-const fs = require('fs-extra');
-const path = require('node:path');
-const crypto = require('node:crypto');
-const glob = require('node:util').promisify(require('glob'));
-const { version } = require('../package.json');
-const paths = require('@backstage/cli-common').findPaths(process.cwd());
-const {
-  getJestEnvironment,
-  getJestMajorVersion,
-} = require('./getJestEnvironment');
-
-const SRC_EXTS = ['ts', 'js', 'tsx', 'jsx', 'mts', 'cts', 'mjs', 'cjs'];
-
-const FRONTEND_ROLES = [
-  'frontend',
-  'web-library',
-  'common-library',
-  'frontend-plugin',
-  'frontend-plugin-module',
-];
-
-const NODE_ROLES = [
-  'backend',
-  'cli',
-  'node-library',
-  'backend-plugin',
-  'backend-plugin-module',
-];
-
-const envOptions = {
-  oldTests: Boolean(process.env.BACKSTAGE_OLD_TESTS),
-};
-
 try {
-  require.resolve('react-dom/client', {
-    paths: [paths.targetRoot],
-  });
-  process.env.HAS_REACT_DOM_CLIENT = true;
-} catch {
-  /* ignored */
-}
-
-/**
- * A list of config keys that are valid for project-level config.
- * Jest will complain if we forward any other root configuration to the projects.
- *
- * @type {Array<keyof import('@jest/types').Config.ProjectConfig>}
- */
-const projectConfigKeys = [
-  'automock',
-  'cache',
-  'cacheDirectory',
-  'clearMocks',
-  'collectCoverageFrom',
-  'coverageDirectory',
-  'coveragePathIgnorePatterns',
-  'cwd',
-  'dependencyExtractor',
-  'detectLeaks',
-  'detectOpenHandles',
-  'displayName',
-  'errorOnDeprecated',
-  'extensionsToTreatAsEsm',
-  'fakeTimers',
-  'filter',
-  'forceCoverageMatch',
-  'globalSetup',
-  'globalTeardown',
-  'globals',
-  'haste',
-  'id',
-  'injectGlobals',
-  'moduleDirectories',
-  'moduleFileExtensions',
-  'moduleNameMapper',
-  'modulePathIgnorePatterns',
-  'modulePaths',
-  'openHandlesTimeout',
-  'preset',
-  'prettierPath',
-  'resetMocks',
-  'resetModules',
-  'resolver',
-  'restoreMocks',
-  'rootDir',
-  'roots',
-  'runner',
-  'runtime',
-  'sandboxInjectedGlobals',
-  'setupFiles',
-  'setupFilesAfterEnv',
-  'skipFilter',
-  'skipNodeResolution',
-  'slowTestThreshold',
-  'snapshotResolver',
-  'snapshotSerializers',
-  'snapshotFormat',
-  'testEnvironment',
-  'testEnvironmentOptions',
-  'testMatch',
-  'testLocationInResults',
-  'testPathIgnorePatterns',
-  'testRegex',
-  'testRunner',
-  'transform',
-  'transformIgnorePatterns',
-  'watchPathIgnorePatterns',
-  'unmockedModulePathPatterns',
-  'workerIdleMemoryLimit',
-];
-
-const transformIgnorePattern = [
-  '@material-ui',
-  'ajv',
-  'core-js',
-  'jest-.*',
-  'jsdom',
-  'knex',
-  'react',
-  'react-dom',
-  'highlight\\.js',
-  'prismjs',
-  'json-schema',
-  'react-use/lib',
-  'typescript',
-].join('|');
-
-// Provides additional config that's based on the role of the target package
-function getRoleConfig(role, pkgJson) {
-  // Only Node.js package roles support native ESM modules, frontend and common
-  // packages are always transpiled to CommonJS.
-  const moduleOpts = NODE_ROLES.includes(role)
-    ? {
-        module: {
-          ignoreDynamic: true,
-          exportInteropAnnotation: true,
-        },
-      }
-    : undefined;
-
-  const transform = {
-    '\\.(mjs|cjs|js)$': [
-      require.resolve('./jestSwcTransform'),
-      {
-        ...moduleOpts,
-        jsc: {
-          parser: {
-            syntax: 'ecmascript',
-          },
-        },
-      },
-    ],
-    '\\.jsx$': [
-      require.resolve('./jestSwcTransform'),
-      {
-        jsc: {
-          parser: {
-            syntax: 'ecmascript',
-            jsx: true,
-          },
-          transform: {
-            react: {
-              runtime: 'automatic',
-            },
-          },
-        },
-      },
-    ],
-    '\\.(mts|cts|ts)$': [
-      require.resolve('./jestSwcTransform'),
-      {
-        ...moduleOpts,
-        jsc: {
-          parser: {
-            syntax: 'typescript',
-          },
-        },
-      },
-    ],
-    '\\.tsx$': [
-      require.resolve('./jestSwcTransform'),
-      {
-        jsc: {
-          parser: {
-            syntax: 'typescript',
-            tsx: true,
-          },
-          transform: {
-            react: {
-              runtime: 'automatic',
-            },
-          },
-        },
-      },
-    ],
-    '\\.(bmp|gif|jpg|jpeg|png|ico|webp|frag|xml|svg|eot|woff|woff2|ttf)$':
-      require.resolve('./jestFileTransform.js'),
-    '\\.(yaml)$': require.resolve('./jestYamlTransform'),
-  };
-  if (FRONTEND_ROLES.includes(role)) {
-    return {
-      testEnvironment: getJestEnvironment(),
-      // The caching module loader is only used to speed up frontend tests,
-      // as it breaks real dynamic imports of ESM modules.
-      runtime: envOptions.oldTests
-        ? undefined
-        : require.resolve('./jestCachingModuleLoader'),
-      transform,
-    };
-  }
-  return {
-    testEnvironment: require.resolve('jest-environment-node'),
-    moduleFileExtensions: [...SRC_EXTS, 'json', 'node'],
-    // Jest doesn't let us dynamically detect type=module per transformed file,
-    // so we have to assume that if the entry point is ESM, all TS files are
-    // ESM.
-    //
-    // This means you can't switch a package to type=module until all of its
-    // monorepo dependencies are also type=module or does not contain any .ts
-    // files.
-    extensionsToTreatAsEsm:
-      pkgJson.type === 'module' ? ['.ts', '.mts'] : ['.mts'],
-    transform,
-  };
-}
-
-async function getProjectConfig(targetPath, extraConfig, extraOptions) {
-  const configJsPath = path.resolve(targetPath, 'jest.config.js');
-  const configTsPath = path.resolve(targetPath, 'jest.config.ts');
-  // If the package has it's own jest config, we use that instead.
-  if (await fs.pathExists(configJsPath)) {
-    return require(configJsPath);
-  } else if (await fs.pathExists(configTsPath)) {
-    return require(configTsPath);
-  }
-
-  // Jest config can be defined both in the root package.json and within each package. The root config
-  // gets forwarded to us through the `extraConfig` parameter, while the package config is read here.
-  // If they happen to be the same the keys will simply override each other.
-  // The merging of the configs is shallow, meaning e.g. all transforms are replaced if new ones are defined.
-  const pkgJson = await fs.readJson(path.resolve(targetPath, 'package.json'));
-
-  const options = {
-    ...extraConfig,
-    rootDir: path.resolve(targetPath, 'src'),
-    moduleNameMapper: {
-      '\\.(css|less|scss|sss|styl)$': require.resolve('jest-css-modules'),
-    },
-
-    // A bit more opinionated
-    testMatch: [`**/*.test.{${SRC_EXTS.join(',')}}`],
-
-    transformIgnorePatterns: [`/node_modules/(?:${transformIgnorePattern})/`],
-    ...getRoleConfig(pkgJson.backstage?.role, pkgJson),
-  };
-
-  options.setupFilesAfterEnv = options.setupFilesAfterEnv || [];
-
-  if (
-    extraOptions.rejectFrontendNetworkRequests &&
-    FRONTEND_ROLES.includes(pkgJson.backstage?.role)
-  ) {
-    // By adding this first we ensure that it's possible to for example override
-    // fetch with a mock in a custom setup file
-    options.setupFilesAfterEnv.unshift(
-      require.resolve('./jestRejectNetworkRequests.js'),
-    );
-  }
-
-  if (
-    options.testEnvironment === getJestEnvironment() &&
-    getJestMajorVersion() < 30 // Only needed when not running the custom env for Jest 30+
-  ) {
-    // FIXME https://github.com/jsdom/jsdom/issues/1724
-    options.setupFilesAfterEnv.unshift(require.resolve('cross-fetch/polyfill'));
-  }
-
-  // Use src/setupTests.* as the default location for configuring test env
-  for (const ext of SRC_EXTS) {
-    if (fs.existsSync(path.resolve(targetPath, `src/setupTests.${ext}`))) {
-      options.setupFilesAfterEnv.push(`<rootDir>/setupTests.${ext}`);
-      break;
-    }
-  }
-
-  const config = Object.assign(options, pkgJson.jest);
-
-  // The config id is a cache key that lets us share the jest cache across projects.
-  // If no explicit id was configured, generated one based on the configuration.
-  if (!config.id) {
-    const configHash = crypto
-      .createHash('sha256')
-      .update(version)
-      .update(Buffer.alloc(1))
-      .update(JSON.stringify(config.transform).replaceAll(paths.targetRoot, ''))
-      .digest('hex');
-    config.id = `backstage_cli_${configHash}`;
-  }
-
-  return config;
-}
-
-// This loads the root jest config, which in turn will either refer to a single
-// configuration for the current package, or a collection of configurations for
-// the target workspace packages
-async function getRootConfig() {
-  const rootPkgJson = await fs.readJson(
-    paths.resolveTargetRoot('package.json'),
-  );
-
-  const baseCoverageConfig = {
-    coverageDirectory: paths.resolveTarget('coverage'),
-    coverageProvider: envOptions.oldTests ? 'v8' : 'babel',
-    collectCoverageFrom: ['**/*.{js,jsx,ts,tsx,mjs,cjs}', '!**/*.d.ts'],
-  };
-
-  const { rejectFrontendNetworkRequests, ...rootOptions } =
-    rootPkgJson.jest ?? {};
-  const extraRootOptions = {
-    rejectFrontendNetworkRequests,
-  };
-
-  const ws = rootPkgJson.workspaces;
-  const workspacePatterns = Array.isArray(ws) ? ws : ws?.packages;
-
-  // Check if we're running within a specific monorepo package. In that case just get the single project config.
-  if (!workspacePatterns || paths.targetRoot !== paths.targetDir) {
-    return getProjectConfig(
-      paths.targetDir,
-      {
-        ...baseCoverageConfig,
-        ...rootOptions,
-      },
-      extraRootOptions,
+  module.exports = require('@backstage/cli-module-test-jest/config/jest');
+} catch (e) {
+  if (e.code === 'MODULE_NOT_FOUND') {
+    throw new Error(
+      '@backstage/cli-module-test-jest is required to use this jest configuration. ' +
+        'Please install it as a dependency.',
     );
   }
-
-  const globalRootConfig = { ...baseCoverageConfig };
-  const globalProjectConfig = {};
-
-  for (const [key, value] of Object.entries(rootOptions)) {
-    if (projectConfigKeys.includes(key)) {
-      globalProjectConfig[key] = value;
-    } else {
-      globalRootConfig[key] = value;
-    }
-  }
-
-  // If the target package is a workspace root, we find all packages in the
-  // workspace and load those in as separate jest projects instead.
-  const projectPaths = await Promise.all(
-    workspacePatterns.map(pattern =>
-      glob(path.join(paths.targetRoot, pattern)),
-    ),
-  ).then(_ => _.flat());
-
-  let projects = await Promise.all(
-    projectPaths.flat().map(async projectPath => {
-      const packagePath = path.resolve(projectPath, 'package.json');
-      if (!(await fs.pathExists(packagePath))) {
-        return undefined;
-      }
-
-      // We check for the presence of "backstage-cli test" in the package test
-      // script to determine whether a given package should be tested
-      const packageData = await fs.readJson(packagePath);
-      const testScript = packageData.scripts && packageData.scripts.test;
-      const isSupportedTestScript =
-        testScript?.includes('backstage-cli test') ||
-        testScript?.includes('backstage-cli package test');
-      if (testScript && isSupportedTestScript) {
-        return await getProjectConfig(
-          projectPath,
-          {
-            ...globalProjectConfig,
-            displayName: packageData.name,
-          },
-          extraRootOptions,
-        );
-      }
-
-      return undefined;
-    }),
-  ).then(cs => cs.filter(Boolean));
-
-  const cache = global.__backstageCli_jestSuccessCache;
-  if (cache) {
-    projects = await cache.filterConfigs(projects, globalRootConfig);
-  }
-  const watchProjectFilter = global.__backstageCli_watchProjectFilter;
-  if (watchProjectFilter) {
-    projects = await watchProjectFilter.filter(projects);
-  }
-
-  return {
-    rootDir: paths.targetRoot,
-    projects,
-    testResultsProcessor: cache
-      ? require.resolve('./jestCacheResultProcessor.cjs')
-      : undefined,
-    ...globalRootConfig,
-  };
+  throw e;
 }
-
-module.exports = getRootConfig();

package/config/jestCacheResultProcessor.cjs

@@ -14,10 +14,14 @@
  * limitations under the License.
  */
 
-module.exports = async results => {
-  const cache = global.__backstageCli_jestSuccessCache;
-  if (cache) {
-    await cache.reportResults(results);
+try {
+  module.exports = require('@backstage/cli-module-test-jest/config/jestCacheResultProcessor.cjs');
+} catch (e) {
+  if (e.code === 'MODULE_NOT_FOUND') {
+    throw new Error(
+      '@backstage/cli-module-test-jest is required to use the jest cache result processor. ' +
+        'Please install it as a dependency.',
+    );
   }
-  return results;
-};
+  throw e;
+}