Merge branch 'main' into use-cp-nx-plugin

Author: John Doe

.github/labeler.yml

@@ -50,6 +50,10 @@
   - changed-files:
       - any-glob-to-any-file: 'packages/plugin-typescript/src/**'
 
+🧩 axe-plugin:
+  - changed-files:
+      - any-glob-to-any-file: 'packages/plugin-axe/src/**'
+
 🔬 testing:
   - changed-files:
       - any-glob-to-any-file:

CHANGELOG.md

@@ -1,3 +1,87 @@
+## 0.96.1 (2025-12-11)
+
+### 🩹 Fixes
+
+- **plugin-eslint:** replace static @nx/devkit import ([c4c9f2a2](https://github.com/code-pushup/cli/commit/c4c9f2a2))
+- **plugin-lighthouse:** generate categories for single URL ([827be4de](https://github.com/code-pushup/cli/commit/827be4de))
+
+### ❤️ Thank You
+
+- hanna-skryl
+- Matěj Chalk
+
+## 0.96.0 (2025-12-11)
+
+### 🚀 Features
+
+- **plugin-axe:** aggregate categories ([84bb067a](https://github.com/code-pushup/cli/commit/84bb067a))
+
+### ❤️ Thank You
+
+- Hanna Skryl @hanna-skryl
+
+## 0.95.2 (2025-12-10)
+
+### 🩹 Fixes
+
+- ensure CLI bin directory is included in published package with executable permissions ([#1183](https://github.com/code-pushup/cli/pull/1183))
+
+### ❤️ Thank You
+
+- Nicolas Beaussart @beaussan
+
+## 0.95.1 (2025-12-10)
+
+### 🩹 Fixes
+
+- **cli:** respect CP_VERBOSE if --verbose argument not given ([26a13c6c](https://github.com/code-pushup/cli/commit/26a13c6c))
+
+### ❤️ Thank You
+
+- Matěj Chalk
+
+## 0.95.0 (2025-12-10)
+
+### 🚀 Features
+
+- **plugin-eslint:** log initializer steps (rules discovery, group creation, nx helpers) ([64d40a16](https://github.com/code-pushup/cli/commit/64d40a16))
+- **plugin-eslint:** log runner steps (lint results stats, artifacts usage) ([9c9b3ac7](https://github.com/code-pushup/cli/commit/9c9b3ac7))
+- **utils:** provide helper for consistent plugin meta logs formatting ([29e80390](https://github.com/code-pushup/cli/commit/29e80390))
+
+### ❤️ Thank You
+
+- Matěj Chalk
+
+## 0.94.0 (2025-12-09)
+
+### 🚀 Features
+
+- **cli:** include logo and version in initial log ([52266a7f](https://github.com/code-pushup/cli/commit/52266a7f))
+- **cli:** log config import and validation steps ([f3cebd3b](https://github.com/code-pushup/cli/commit/f3cebd3b))
+- **cli:** simplify sticker hints ([db44dff0](https://github.com/code-pushup/cli/commit/db44dff0))
+- **cli:** improve collect and upload logs ([239c7c7e](https://github.com/code-pushup/cli/commit/239c7c7e))
+- **cli:** drop print-config to stdout, output arg is now required ([88096844](https://github.com/code-pushup/cli/commit/88096844))
+- **utils:** support custom return values in logger.task ([e0793eeb](https://github.com/code-pushup/cli/commit/e0793eeb))
+- **utils:** ensure consistent line breaks in stdout report ([7093fe4d](https://github.com/code-pushup/cli/commit/7093fe4d))
+
+### ❤️ Thank You
+
+- Matěj Chalk
+
+## 0.93.0 (2025-12-08)
+
+### 🚀 Features
+
+- **plugin-axe:** use category-based groups ([aa7b7f63](https://github.com/code-pushup/cli/commit/aa7b7f63))
+
+### 🩹 Fixes
+
+- **plugin-axe:** wrap HTML tags in audit metadata ([9ac95d60](https://github.com/code-pushup/cli/commit/9ac95d60))
+
+### ❤️ Thank You
+
+- hanna-skryl
+
 ## 0.92.1 (2025-12-03)
 
 ### 🩹 Fixes

code-pushup.config.ts

@@ -1,6 +1,6 @@
 import 'dotenv/config';
 import {
-  axeCoreConfig,
+  configureAxePlugin,
   configureCoveragePlugin,
   configureEslintPlugin,
   configureJsDocsPlugin,
@@ -23,5 +23,5 @@ export default mergeConfigs(
   configureTypescriptPlugin(),
   configureJsDocsPlugin(),
   await configureLighthousePlugin(TARGET_URL),
-  axeCoreConfig(TARGET_URL),
+  configureAxePlugin(TARGET_URL),
 );

code-pushup.preset.ts

@@ -5,7 +5,7 @@ import type {
   CoreConfig,
   PluginUrls,
 } from './packages/models/src/index.js';
-import axePlugin from './packages/plugin-axe/src/index.js';
+import axePlugin, { axeCategories } from './packages/plugin-axe/src/index.js';
 import coveragePlugin, {
   type CoveragePluginConfig,
   getNxCoveragePaths,
@@ -20,9 +20,9 @@ import {
   groups,
 } from './packages/plugin-jsdocs/src/lib/constants.js';
 import {
+  lighthouseCategories,
   lighthouseGroupRef,
   lighthousePlugin,
-  mergeLighthouseCategories,
 } from './packages/plugin-lighthouse/src/index.js';
 import typescriptPlugin, {
   getCategories,
@@ -224,12 +224,14 @@ export async function configureLighthousePlugin(
   ];
   return {
     plugins: [lhPlugin],
-    categories: mergeLighthouseCategories(lhPlugin, lhCategories),
+    categories: lighthouseCategories(lhPlugin, lhCategories),
   };
 }
 
-export function axeCoreConfig(urls: PluginUrls): CoreConfig {
+export function configureAxePlugin(urls: PluginUrls): CoreConfig {
+  const axe = axePlugin(urls);
   return {
-    plugins: [axePlugin(urls)],
+    plugins: [axe],
+    categories: axeCategories(axe),
   };
 }

e2e/cli-e2e/tests/__snapshots__/help.e2e.test.ts.snap

@@ -8,7 +8,7 @@ Commands:
                                                                        [default]
   code-pushup autorun       Shortcut for running collect followed by upload
 
-  code-pushup collect       Run Plugins and collect results
+  code-pushup collect       Run plugins and collect results
   code-pushup upload        Upload report results to the portal
   code-pushup history       Collect reports for commit history
   code-pushup compare       Compare 2 report files and create a diff file
@@ -18,9 +18,9 @@ Commands:
 
 
 Global Options:
-      --verbose         When true creates more verbose output. This is helpful w
-                        hen debugging. You may also set CP_VERBOSE env variable
-                        instead.       [boolean] [default: false]
+      --verbose         Toggles whether to print debug logs. The default value i
+                        s derived from the CP_VERBOSE environment variable (fals
+                        e if not set).                  [boolean]
       --config          Path to config file. By default it loads code-pushup.con
                         fig.(ts|mjs|js).                 [string]
       --tsconfig        Path to a TypeScript config, to be used when loading con

e2e/cli-e2e/tests/collect.e2e.test.ts

@@ -59,7 +59,7 @@ describe('CLI collect', () => {
 
     const md = await readTextFile(path.join(dummyOutputDir, 'report.md'));
 
-    expect(md).toContain('# Code PushUp Report');
+    expect(md).toContain('# Code PushUp report');
     expect(md).toContain(dummyPluginTitle);
     expect(md).toContain(dummyAuditTitle);
   });
@@ -112,7 +112,7 @@ describe('CLI collect', () => {
 
     expect(code).toBe(0);
 
-    expect(stdout).toContain('Code PushUp Report');
+    expect(stdout).toContain('Code PushUp report');
     expect(stdout).not.toContain('Generated reports');
     expect(stdout).toContain(dummyPluginTitle);
     expect(stdout).toContain(dummyAuditTitle);

e2e/cli-e2e/tests/print-config.e2e.test.ts

@@ -40,11 +40,12 @@ describe('CLI print-config', () => {
   it.each(extensions)(
     'should load .%s config file with correct arguments',
     async ext => {
-      const { code, stdout } = await executeProcess({
+      const { code } = await executeProcess({
         command: 'npx',
         args: [
           '@code-pushup/cli',
           'print-config',
+          '--output=config.json',
           `--config=${configFilePath(ext)}`,
           '--tsconfig=tsconfig.base.json',
           '--persist.outputDir=output-dir',
@@ -56,7 +57,11 @@ describe('CLI print-config', () => {
 
       expect(code).toBe(0);
 
-      expect(JSON.parse(stdout)).toEqual(
+      const output = await readFile(
+        path.join(testFileDummySetup, 'config.json'),
+        'utf8',
+      );
+      expect(JSON.parse(output)).toEqual(
         expect.objectContaining({
           config: expect.stringContaining(`code-pushup.config.${ext}`),
           tsconfig: 'tsconfig.base.json',
@@ -71,30 +76,4 @@ describe('CLI print-config', () => {
       );
     },
   );
-
-  it('should print config to output file', async () => {
-    const { code, stdout } = await executeProcess({
-      command: 'npx',
-      args: ['@code-pushup/cli', 'print-config', '--output=config.json'],
-      cwd: testFileDummySetup,
-    });
-
-    expect(code).toBe(0);
-
-    const output = await readFile(
-      path.join(testFileDummySetup, 'config.json'),
-      'utf8',
-    );
-    expect(JSON.parse(output)).toEqual(
-      expect.objectContaining({
-        plugins: [
-          expect.objectContaining({
-            slug: 'dummy-plugin',
-            title: 'Dummy Plugin',
-          }),
-        ],
-      }),
-    );
-    expect(stdout).not.toContain('dummy-plugin');
-  });
 });

e2e/nx-plugin-e2e/tests/executor-cli.e2e.test.ts

@@ -100,25 +100,6 @@ describe('executor command', () => {
     expect(cleanStdout).toContain('nx run my-lib:code-pushup');
   });
 
-  it('should execute print-config executor', async () => {
-    const cwd = path.join(testFileDir, 'execute-print-config-command');
-    await addTargetToWorkspace(tree, { cwd, project });
-
-    const { stdout, code } = await executeProcess({
-      command: 'npx',
-      args: ['nx', 'run', `${project}:code-pushup`, 'print-config'],
-      cwd,
-    });
-
-    expect(code).toBe(0);
-    const cleanStdout = removeColorCodes(stdout);
-    expect(cleanStdout).toContain('nx run my-lib:code-pushup print-config');
-
-    await expect(() =>
-      readJsonFile(path.join(cwd, '.code-pushup', project, 'report.json')),
-    ).rejects.toThrow('');
-  });
-
   it('should execute print-config executor with output', async () => {
     const cwd = path.join(testFileDir, 'execute-print-config-command');
     await addTargetToWorkspace(tree, { cwd, project });
@@ -144,32 +125,6 @@ describe('executor command', () => {
     ).resolves.not.toThrow();
   });
 
-  it('should execute print-config executor with api key', async () => {
-    const cwd = path.join(testFileDir, 'execute-print-config-command');
-    await addTargetToWorkspace(tree, { cwd, project });
-
-    const { stdout, code } = await executeProcess({
-      command: 'npx',
-      args: [
-        'nx',
-        'run',
-        `${project}:code-pushup`,
-        'print-config',
-        '--upload.apiKey=a123a',
-      ],
-      cwd,
-    });
-
-    expect(code).toBe(0);
-    const cleanStdout = removeColorCodes(stdout);
-    expect(cleanStdout).toContain('nx run my-lib:code-pushup print-config');
-    expect(cleanStdout).toContain('a123a');
-
-    await expect(() =>
-      readJsonFile(path.join(cwd, '.code-pushup', project, 'report.json')),
-    ).rejects.toThrow('');
-  });
-
   it('should execute collect executor and merge target and command-line options', async () => {
     const cwd = path.join(testFileDir, 'execute-collect-with-merged-options');
     await addTargetToWorkspace(

e2e/nx-plugin-e2e/tests/plugin-create-nodes.e2e.test.ts

@@ -179,8 +179,6 @@ describe('nx-plugin', () => {
     // Run CLI executor
     expect(cleanStdout).toContain('DryRun execution of:');
     expect(cleanStdout).toContain('npx @code-pushup/cli');
-    expect(cleanStdout).not.toContain('--verbose');
-    expect(cleanStdout).toContain('CP_VERBOSE="true"');
   });
 
   it('should consider plugin option bin in executor target', async () => {