code-pushup · BioPhoton · Aug 16, 2025 · Aug 16, 2025 · Aug 16, 2025 · Aug 16, 2025
diff --git a/.gitignore b/.gitignore
@@ -44,7 +44,7 @@ testem.log
 Thumbs.db
 
 # generated Code PushUp reports
-/.code-pushup
+.code-pushup
 
 # Nx workspace cache
 .nx
diff --git a/code-pushup.preset.ts b/code-pushup.preset.ts
@@ -10,6 +10,8 @@ import eslintPlugin, {
   eslintConfigFromAllNxProjects,
   eslintConfigFromNxProject,
 } from './packages/plugin-eslint/src/index.js';
+import type { ESLintTarget } from './packages/plugin-eslint/src/lib/config.js';
+import { nxProjectsToConfig } from './packages/plugin-eslint/src/lib/nx/projects-to-config.js';
 import jsPackagesPlugin from './packages/plugin-js-packages/src/index.js';
 import jsDocsPlugin from './packages/plugin-jsdocs/src/index.js';
 import type { JsDocsPluginTransformedConfig } from './packages/plugin-jsdocs/src/lib/config.js';
@@ -156,6 +158,17 @@ export const jsDocsCoreConfig = (
   ),
 });
 
+export async function eslintConfigFromPublishableNxProjects(): Promise<
+  ESLintTarget[]
+> {
+  const { createProjectGraphAsync } = await import('@nx/devkit');
+  const projectGraph = await createProjectGraphAsync({ exitOnError: false });
+  return nxProjectsToConfig(
+    projectGraph,
+    project => project.tags?.includes('publishable') ?? false,
+  );
+}
+
 export const eslintCoreConfigNx = async (
   projectName?: string,
 ): Promise<CoreConfig> => ({
@@ -164,6 +177,21 @@ export const eslintCoreConfigNx = async (
       await (projectName
         ? eslintConfigFromNxProject(projectName)
         : eslintConfigFromAllNxProjects()),
+      {
+        artifacts: {
+          generateArtifactsCommand: {
+            command: 'npx',
+            args: [
+              'nx',
+              'run-many',
+              '-t',
+              'lint-reporter',
+              '--projects=tag:publishable',
+            ],
+          },
+          artifactsPaths: 'packages/*/.code-pushup/eslint/eslint-report.json',
+        },
+      },
     ),
   ],
   categories: eslintCategories,

diff --git a/nx.json b/nx.json
@@ -46,16 +46,48 @@
     "lint": {
       "inputs": ["default", "{workspaceRoot}/eslint.config.?(c)js"],
       "executor": "@nx/linter:eslint",
-      "outputs": ["{options.outputFile}"],
       "cache": true,
       "options": {
+        "errorOnUnmatchedPattern": false,
         "maxWarnings": 0,
         "lintFilePatterns": [
           "{projectRoot}/**/*.ts",
           "{projectRoot}/package.json"
         ]
       }
     },
+    "lint-reporter": {
+      "inputs": ["default", "{workspaceRoot}/eslint.config.?(c)js"],
+      "outputs": ["{projectRoot}/.eslint/eslint-report*.json"],
+      "cache": true,
+      "executor": "@nx/linter:eslint",
+      "options": {
+        "errorOnUnmatchedPattern": false,
+        "maxWarnings": 0,
+        "format": "json",
+        "outputFile": "{projectRoot}/.eslint/eslint-report.json",
+        "lintFilePatterns": [
+          "{projectRoot}/**/*.ts",
+          "{projectRoot}/package.json"
+        ]
+      }
+    },
+    "lint-formatter": {
+      "inputs": ["default", "{workspaceRoot}/eslint.config.?(c)js"],
+      "outputs": ["{projectRoot}/.eslint/eslint-report*.json"],
+      "cache": true,
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "nx lint {projectName}",
+        "args": [
+          "--format",
+          "./packages/plugin-eslint/dist/src/lib/formatter/multiple-formats.js"
+        ],
+        "env": {
+          "ESLINT_FORMATTER_CONFIG": "{\"outputDir\":\"{projectRoot}/.eslint\"}"
+        }
+      }
+    },
     "nxv-pkg-install": {
       "parallelism": false
     },

diff --git a/packages/ci/project.json b/packages/ci/project.json
@@ -6,6 +6,7 @@
   "targets": {
     "build": {},
     "lint": {},
+    "lint-reporter": {},
     "unit-test": {},
     "int-test": {}
   },

diff --git a/packages/cli/project.json b/packages/cli/project.json
@@ -6,6 +6,7 @@
   "targets": {
     "build": {},
     "lint": {},
+    "lint-reporter": {},
     "unit-test": {},
     "int-test": {},
     "run-help": {

diff --git a/packages/core/project.json b/packages/core/project.json
@@ -6,6 +6,7 @@
   "targets": {
     "build": {},
     "lint": {},
+    "lint-reporter": {},
     "unit-test": {},
     "int-test": {}
   },

diff --git a/packages/core/src/lib/implementation/execute-plugin.ts b/packages/core/src/lib/implementation/execute-plugin.ts
@@ -66,8 +66,8 @@ export async function executePlugin(
     ? // IF not null, take the result from cache
       ((await readRunnerResults(pluginMeta.slug, outputDir)) ??
       // ELSE execute the plugin runner
-      (await executePluginRunner(pluginConfig)))
-    : await executePluginRunner(pluginConfig);
+      (await executePluginRunner(pluginConfig, persist)))
+    : await executePluginRunner(pluginConfig, persist);
 
   if (cacheWrite) {
     await writeRunnerResults(pluginMeta.slug, outputDir, {

diff --git a/packages/core/src/lib/implementation/execute-plugin.unit.test.ts b/packages/core/src/lib/implementation/execute-plugin.unit.test.ts
@@ -102,7 +102,7 @@ describe('executePlugin', () => {
 
     await expect(
       executePlugin(MINIMAL_PLUGIN_CONFIG_MOCK, {
-        persist: { outputDir: 'dummy-path-result-is-mocked' },
+        persist: { outputDir: MEMFS_VOLUME },
         cache: { read: true, write: false },
       }),
     ).resolves.toStrictEqual({
@@ -122,6 +122,7 @@ describe('executePlugin', () => {
 
     expect(executePluginRunnerSpy).toHaveBeenCalledWith(
       MINIMAL_PLUGIN_CONFIG_MOCK,
+      { outputDir: MEMFS_VOLUME },
     );
   });
 });
@@ -322,8 +323,8 @@ describe('executePlugins', () => {
           {
             ...MINIMAL_PLUGIN_CONFIG_MOCK,
             runner: {
-              command: 'node',
-              args: ['-v'],
+              command: 'echo',
+              args: ['16'],
               outputFile: 'output.json',
               outputTransform: (outputs: unknown): Promise<AuditOutputs> =>
                 Promise.resolve([
@@ -337,7 +338,7 @@ describe('executePlugins', () => {
             },
           },
         ],
-        persist: { outputDir: '.code-pushup' },
+        persist: { outputDir: MEMFS_VOLUME },
         cache: { read: false, write: false },
       },
       { progress: false },

diff --git a/packages/core/src/lib/implementation/runner.ts b/packages/core/src/lib/implementation/runner.ts
@@ -3,6 +3,7 @@ import { writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import {
   type AuditOutputs,
+  type PersistConfig,
   type PluginConfig,
   type RunnerConfig,
   type RunnerFunction,
@@ -14,6 +15,7 @@ import {
   executeProcess,
   fileExists,
   isVerbose,
+  objectToCliArgs,
   readJsonFile,
   removeDirectoryIfExists,
   ui,
@@ -32,12 +34,13 @@ export type ValidatedRunnerResult = Omit<RunnerResult, 'audits'> & {
 
 export async function executeRunnerConfig(
   cfg: RunnerConfig,
+  config: Required<Pick<PersistConfig, 'outputDir'>>,
 ): Promise<RunnerResult> {
   const { args, command, outputFile, outputTransform } = cfg;
 
   const { duration, date } = await executeProcess({
     command,
-    args,
+    args: [...(args ?? []), ...objectToCliArgs(config)],
     observer: {
       onStdout: stdout => {
         if (isVerbose()) {
@@ -66,12 +69,13 @@ export async function executeRunnerConfig(
 
 export async function executeRunnerFunction(
   runner: RunnerFunction,
+  config: PersistConfig,
 ): Promise<RunnerResult> {
   const date = new Date().toISOString();
   const start = performance.now();
 
   // execute plugin runner
-  const audits = await runner();
+  const audits = await runner(config);
 
   // create runner result
   return {
@@ -96,12 +100,13 @@ export class AuditOutputsMissingAuditError extends Error {
 
 export async function executePluginRunner(
   pluginConfig: Pick<PluginConfig, 'audits' | 'runner'>,
+  persist: Required<Pick<PersistConfig, 'outputDir'>>,
 ): Promise<Omit<RunnerResult, 'audits'> & { audits: AuditOutputs }> {
   const { audits: pluginConfigAudits, runner } = pluginConfig;
   const runnerResult: RunnerResult =
     typeof runner === 'object'
-      ? await executeRunnerConfig(runner)
-      : await executeRunnerFunction(runner);
+      ? await executeRunnerConfig(runner, persist)
+      : await executeRunnerFunction(runner, persist);
   const { audits: unvalidatedAuditOutputs, ...executionMeta } = runnerResult;
 
   const result = auditOutputsSchema.safeParse(unvalidatedAuditOutputs);

diff --git a/packages/create-cli/project.json b/packages/create-cli/project.json
@@ -6,6 +6,7 @@
   "targets": {
     "build": {},
     "lint": {},
+    "lint-reporter": {},
     "unit-test": {},
     "exec-node": {
       "dependsOn": ["build"],

diff --git a/packages/models/docs/models-reference.md b/packages/models/docs/models-reference.md
@@ -1418,7 +1418,7 @@ _Function._
 
 _Parameters:_
 
-- _none_
+1. [PersistConfig](#persistconfig)
 
 _Returns:_
 

diff --git a/packages/models/project.json b/packages/models/project.json
@@ -18,6 +18,7 @@
       ]
     },
     "lint": {},
+    "lint-reporter": {},
     "unit-test": {}
   },
   "tags": ["scope:shared", "type:util", "publishable"]

diff --git a/packages/models/src/index.ts b/packages/models/src/index.ts
@@ -57,6 +57,7 @@ export {
 export {
   fileNameSchema,
   filePathSchema,
+  globPathSchema,
   materialIconSchema,
   type MaterialIcon,
 } from './lib/implementation/schemas.js';
@@ -145,4 +146,5 @@ export { uploadConfigSchema, type UploadConfig } from './lib/upload-config.js';
 export {
   artifactGenerationCommandSchema,
   pluginArtifactOptionsSchema,
+  type PluginArtifactOptions,
 } from './lib/configuration.js';
diff --git a/packages/models/src/lib/configuration.ts b/packages/models/src/lib/configuration.ts
@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { filePathSchema, globPathSchema } from './implementation/schemas.js';
 
 /**
  * Generic schema for a tool command configuration, reusable across plugins.
@@ -13,7 +14,14 @@ export const artifactGenerationCommandSchema = z.union([
 
 export const pluginArtifactOptionsSchema = z.object({
   generateArtifactsCommand: artifactGenerationCommandSchema.optional(),
-  artifactsPaths: z.union([z.string(), z.array(z.string()).min(1)]),
+  artifactsPaths: z
+    .union([
+      filePathSchema,
+      z.array(filePathSchema).min(1),
+      globPathSchema,
+      z.array(globPathSchema).min(1),
+    ])
+    .describe('File paths or glob patterns for artifact files'),
 });
 
 export type PluginArtifactOptions = z.infer<typeof pluginArtifactOptionsSchema>;
diff --git a/packages/models/src/lib/implementation/schemas.ts b/packages/models/src/lib/implementation/schemas.ts
@@ -138,6 +138,24 @@ export const filePathSchema = z
   .trim()
   .min(1, { message: 'The path is invalid' });
 
+/**
+ * Regex for glob patterns - validates file paths and glob patterns
+ * Allows normal paths and paths with glob metacharacters: *, **, {}, [], !, ?
+ * Excludes invalid path characters: <>"|
+ */
+const globRegex = /^!?[^<>"|]+$/;
+
+/** Schema for a glob pattern (supports wildcards like *, **, {}, !, etc.) */
+export const globPathSchema = z
+  .string()
+  .trim()
+  .min(1, { message: 'The glob pattern is invalid' })
+  .regex(globRegex, {
+    message:
+      'The path must be a valid file path or glob pattern (supports *, **, {}, [], !, ?)',
+  })
+  .describe('File path or glob pattern (supports *, **, {}, !, etc.)');
+
 /** Schema for a fileNameSchema */
 export const fileNameSchema = z
   .string()

diff --git a/packages/models/src/lib/runner-config.ts b/packages/models/src/lib/runner-config.ts
@@ -2,6 +2,7 @@ import { z } from 'zod/v4';
 import { auditOutputsSchema } from './audit-output.js';
 import { convertAsyncZodFunctionToSchema } from './implementation/function.js';
 import { filePathSchema } from './implementation/schemas.js';
+import { persistConfigSchema } from './persist-config.js';
 
 export const outputTransformSchema = convertAsyncZodFunctionToSchema(
   z.function({
@@ -25,6 +26,7 @@ export type RunnerConfig = z.infer<typeof runnerConfigSchema>;
 
 export const runnerFunctionSchema = convertAsyncZodFunctionToSchema(
   z.function({
+    input: [persistConfigSchema],
     output: z.union([auditOutputsSchema, z.promise(auditOutputsSchema)]),
   }),
 );

@@ -41,6 +41,15 @@
         ]
       }
     },
+    "lint-reporter": {
+      "options": {
+        "lintFilePatterns": [
+          "packages/nx-plugin/**/*.ts",
+          "packages/nx-plugin/package.json",
+          "packages/nx-plugin/generators.json"
+        ]
+      }
+    },
     "unit-test": {},
     "int-test": {}
   },

@@ -6,6 +6,7 @@
   "targets": {
     "build": {},
     "lint": {},
+    "lint-reporter": {},
     "unit-test": {},
     "int-test": {}
   },
-Original file line number
+Diff line change
@@ Expand Up / @@ -1418,7 +1418,7 @@ _Function._ @@
     _Parameters:_
-    - _none_
+. [PersistConfig](#persistconfig)
     _Returns:_
@@ Expand Down @@